@dotdo/do 0.1.0

package/dist/types/functions.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Function Types - Fn<Out, In, Opts> Pattern
+ *
+ * From workers/types/fn.ts: Unified function types with three calling styles
+ * 1. fn(input, opts?) - Direct call
+ * 2. fn`${vals}` - Tagged template with interpolation
+ * 3. fn`{name}`(params) - Tagged template with named params
+ *
+ * Generic order (most to least important):
+ * - Out: Return type (like Promise<T>)
+ * - In: Input type (void = no input, any = flexible)
+ * - Opts: Options for behavior (model, timeout, etc.)
+ */
+/**
+ * Extract {param} names from a template string at compile time
+ *
+ * @example
+ * ```ts
+ * type Params = ExtractParams<'SELECT * FROM {table} WHERE id = {id}'>
+ * // => 'table' | 'id'
+ * ```
+ */
+export type ExtractParams<S extends string> = S extends `${string}{${infer Param}}${infer Rest}` ? Param | ExtractParams<Rest> : never;
+/**
+ * Check if a string contains any {param} placeholders
+ */
+export type HasNamedParams<S extends string> = S extends `${string}{${string}}${string}` ? true : false;
+/**
+ * Get the parameter record type for a template string
+ */
+export type ParamsRecord<S extends string, TValue = unknown> = [
+    ExtractParams<S>
+] extends [never] ? Record<string, never> : Record<ExtractParams<S>, TValue>;
+/**
+ * Conditional result type for tagged template calls
+ *
+ * If template has {params}, returns a function accepting those params
+ * Otherwise returns the result directly
+ */
+export type TaggedResult<TReturn, S extends string, TOpts = object> = [
+    ExtractParams<S>
+] extends [never] ? TReturn : (params: Record<ExtractParams<S>, unknown> & Partial<TOpts>) => TReturn;
+/**
+ * A callable supporting three invocation styles
+ *
+ * @typeParam Out - Return type (most important, like Promise<T>)
+ * @typeParam In - Input type (default: any for flexible AI-style input)
+ * @typeParam Opts - Options type (model, timeout, etc.)
+ *
+ * @example
+ * ```ts
+ * // AI function - flexible input, typed output and options
+ * const ai: Fn<string, any, { model?: string; temperature?: number }>
+ * ai("summarize this")
+ * ai`Summarize ${text}`
+ * ai`Summarize {content}`({ content: "...", model: "best" })
+ * ```
+ */
+export interface Fn<Out, In = unknown, Opts extends Record<string, unknown> = Record<string, unknown>> {
+    /** Style 1: Direct call with input and optional options */
+    (input: In, opts?: Opts): Out;
+    /** Style 2: Tagged template with ${...} interpolation */
+    (strings: TemplateStringsArray, ...values: unknown[]): Out;
+    /** Style 3: Tagged template with {name} placeholders */
+    <S extends string>(strings: TemplateStringsArray & {
+        raw: readonly S[];
+    }): TaggedResult<Out, S, Opts>;
+}
+/**
+ * Async version of Fn - returns Promise<Out>
+ */
+export interface AsyncFn<Out, In = unknown, Opts extends Record<string, unknown> = Record<string, unknown>> {
+    (input: In, opts?: Opts): Promise<Out>;
+    (strings: TemplateStringsArray, ...values: unknown[]): Promise<Out>;
+    <S extends string>(strings: TemplateStringsArray & {
+        raw: readonly S[];
+    }): TaggedResult<Promise<Out>, S, Opts>;
+}
+/**
+ * RPC promise for promise pipelining
+ * Enables calling methods on Out before awaiting
+ */
+export interface RpcPromise<T> extends Promise<T> {
+    /** Pipeline method call */
+    pipe<R>(fn: (value: T) => R | Promise<R>): RpcPromise<R>;
+}
+/**
+ * RPC version of Fn - returns RpcPromise<Out> for pipelining
+ *
+ * @example
+ * ```ts
+ * const sql: RpcFn<SqlResult, any, { timeout?: number }>
+ *
+ * // Pipelining - all in one round trip:
+ * const user = sql`SELECT * FROM users WHERE id = ${id}`.first()
+ * const posts = sql`SELECT * FROM posts WHERE userId = ${id}`.all()
+ * ```
+ */
+export interface RpcFn<Out, In = unknown, Opts extends Record<string, unknown> = Record<string, unknown>> {
+    (input: In, opts?: Opts): RpcPromise<Out>;
+    (strings: TemplateStringsArray, ...values: unknown[]): RpcPromise<Out>;
+    <S extends string>(strings: TemplateStringsArray & {
+        raw: readonly S[];
+    }): TaggedResult<RpcPromise<Out>, S, Opts>;
+}
+/**
+ * Stream function - returns AsyncIterable<Out>
+ */
+export interface StreamFn<Out, In = unknown, Opts extends Record<string, unknown> = Record<string, unknown>> {
+    (input: In, opts?: Opts): AsyncIterable<Out>;
+    (strings: TemplateStringsArray, ...values: unknown[]): AsyncIterable<Out>;
+    <S extends string>(strings: TemplateStringsArray & {
+        raw: readonly S[];
+    }): TaggedResult<AsyncIterable<Out>, S, Opts>;
+}
+/**
+ * Extract output type from any Fn variant
+ */
+export type FnOut<F> = F extends Fn<infer O, infer _I, infer _Opts> ? O : never;
+/**
+ * Extract input type from any Fn variant
+ */
+export type FnIn<F> = F extends Fn<infer _O, infer I, infer _Opts> ? I : never;
+/**
+ * Extract options type from any Fn variant
+ */
+export type FnOpts<F> = F extends Fn<infer _O, infer _I, infer Opts> ? Opts : never;
+/**
+ * Convert Fn to AsyncFn
+ */
+export type ToAsync<F> = F extends Fn<infer O, infer I, infer Opts> ? AsyncFn<O, I, Opts extends Record<string, unknown> ? Opts : Record<string, never>> : never;
+/**
+ * Convert Fn to RpcFn
+ */
+export type ToRpc<F> = F extends Fn<infer O, infer I, infer Opts> ? RpcFn<O, I, Opts extends Record<string, unknown> ? Opts : Record<string, never>> : never;
+/**
+ * Function tier levels (matched to execution tiers)
+ */
+export type FunctionTier = 'code' | 'generative' | 'agentic' | 'human';
+/**
+ * Code function - pure TypeScript/JavaScript
+ */
+export interface CodeFunction {
+    type: 'code';
+    code: string;
+    runtime?: 'javascript' | 'typescript';
+}
+/**
+ * Generative function - AI model call
+ */
+export interface GenerativeFunction {
+    type: 'generative';
+    model: string;
+    prompt: string;
+    schema?: Record<string, unknown>;
+    temperature?: number;
+    maxTokens?: number;
+}
+/**
+ * Agentic function - autonomous agent
+ */
+export interface AgenticFunction {
+    type: 'agentic';
+    agent: string;
+    goal: string;
+    tools?: string[];
+    maxIterations?: number;
+}
+/**
+ * Human function - human in the loop
+ */
+export interface HumanFunction {
+    type: 'human';
+    assignee?: string;
+    instructions: string;
+    timeout?: number;
+}
+/**
+ * Tiered function definition (union of all 4 tiers)
+ * Use this for the detailed function implementation
+ */
+export type TieredFunctionDef = CodeFunction | GenerativeFunction | AgenticFunction | HumanFunction;
+/**
+ * Serializable representation of a function call
+ */
+export interface SerializableFnCall<Args = unknown> {
+    /** Method name */
+    method: string;
+    /** Direct arguments */
+    args?: Args;
+    /** Template call data */
+    template?: {
+        strings: string[];
+        values: unknown[];
+    };
+    /** Named parameters */
+    params?: Record<string, unknown>;
+    /** Options/config */
+    config?: Record<string, unknown>;
+}
+/**
+ * Function registry entry
+ */
+export interface FunctionEntry {
+    id: string;
+    name: string;
+    tier: FunctionTier;
+    definition: TieredFunctionDef;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+    timeout?: number;
+    retries?: number;
+}
+//# sourceMappingURL=functions.d.ts.map

package/dist/types/functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../types/functions.ts"],"names":[],"mappings":"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"}

package/dist/types/functions.js

@@ -0,0 +1,15 @@
+/**
+ * Function Types - Fn<Out, In, Opts> Pattern
+ *
+ * From workers/types/fn.ts: Unified function types with three calling styles
+ * 1. fn(input, opts?) - Direct call
+ * 2. fn`${vals}` - Tagged template with interpolation
+ * 3. fn`{name}`(params) - Tagged template with named params
+ *
+ * Generic order (most to least important):
+ * - Out: Return type (like Promise<T>)
+ * - In: Input type (void = no input, any = flexible)
+ * - Opts: Options for behavior (model, timeout, etc.)
+ */
+export {};
+//# sourceMappingURL=functions.js.map

package/dist/types/functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../types/functions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/types/git.d.ts

@@ -0,0 +1,299 @@
+/**
+ * Git Integration Types - Content/Code Sync with Git
+ *
+ * Integration between DO storage and git repositories
+ * Supports bidirectional sync with configurable source of truth
+ */
+import type { DigitalObjectRef } from './identity';
+/**
+ * Source of truth strategy
+ */
+export type SourceOfTruth = 'git' | 'do' | 'last-write-wins';
+/**
+ * Git sync configuration
+ */
+export interface GitSyncConfig {
+    /** Whether git sync is enabled */
+    enabled: boolean;
+    /** Git repository URL */
+    repository: string;
+    /** Branch to sync */
+    branch: string;
+    /** Path within repository (for monorepos) */
+    basePath?: string;
+    /** Source of truth strategy */
+    sourceOfTruth: SourceOfTruth;
+    /** Authentication */
+    auth?: GitAuthConfig;
+    /** Sync behavior */
+    sync?: GitSyncBehavior;
+    /** What to sync */
+    include?: GitSyncInclude;
+    /** Conflict resolution */
+    conflictResolution?: GitConflictResolution;
+}
+/**
+ * Git authentication configuration
+ */
+export interface GitAuthConfig {
+    /** Auth method */
+    method: 'ssh' | 'https' | 'token';
+    /** SSH key ID (stored securely) */
+    sshKeyId?: string;
+    /** Token ID (stored securely) */
+    tokenId?: string;
+    /** Username for HTTPS */
+    username?: string;
+}
+/**
+ * Sync behavior configuration
+ */
+export interface GitSyncBehavior {
+    /** Auto-commit changes from DO */
+    autoCommit?: boolean;
+    /** Commit message template */
+    commitTemplate?: string;
+    /** Auto-push commits */
+    autoPush?: boolean;
+    /** Auto-pull on access */
+    autoPull?: boolean;
+    /** Sync interval in ms (0 = manual only) */
+    syncInterval?: number;
+    /** Sync on DO events */
+    syncOnEvents?: ('create' | 'update' | 'delete')[];
+}
+/**
+ * What to include in git sync
+ */
+export interface GitSyncInclude {
+    /** Include MDX content files */
+    content?: boolean;
+    /** Include code/function files */
+    code?: boolean;
+    /** Include configuration */
+    config?: boolean;
+    /** Specific paths to include */
+    paths?: string[];
+    /** Paths to exclude */
+    excludePaths?: string[];
+    /** File patterns to include */
+    patterns?: string[];
+    /** File patterns to exclude */
+    excludePatterns?: string[];
+}
+/**
+ * Git conflict resolution strategy
+ */
+export interface GitConflictResolution {
+    /** Default strategy */
+    strategy: 'manual' | 'git-wins' | 'do-wins' | 'merge' | 'last-write-wins';
+    /** Per-path overrides */
+    pathOverrides?: Record<string, GitConflictResolution['strategy']>;
+    /** Merge driver for specific extensions */
+    mergeDrivers?: Record<string, string>;
+}
+/**
+ * Repository state
+ */
+export interface GitRepoState {
+    /** Remote URL */
+    remote: string;
+    /** Current branch */
+    branch: string;
+    /** Current commit SHA */
+    headSha: string;
+    /** Whether there are local changes */
+    isDirty: boolean;
+    /** Ahead/behind remote */
+    ahead: number;
+    behind: number;
+    /** Last fetch timestamp */
+    lastFetch?: number;
+    /** Last push timestamp */
+    lastPush?: number;
+    /** Last pull timestamp */
+    lastPull?: number;
+}
+/**
+ * Git sync state
+ */
+export type GitSyncState = 'synced' | 'ahead' | 'behind' | 'diverged' | 'conflict' | 'error';
+/**
+ * Git sync status (detailed)
+ */
+export interface GitSyncStatusDetail {
+    /** DO reference */
+    doRef: DigitalObjectRef;
+    /** Repository state */
+    repo: GitRepoState;
+    /** Sync state */
+    state: GitSyncState;
+    /** Pending changes */
+    pending: PendingChange[];
+    /** Conflicts (if any) */
+    conflicts?: SyncConflict[];
+    /** Last sync timestamp */
+    lastSync?: number;
+    /** Last sync result */
+    lastSyncResult?: GitSyncResult;
+    /** Error message (if state is error) */
+    error?: string;
+}
+/**
+ * Pending change to sync
+ */
+export interface PendingChange {
+    /** File path */
+    path: string;
+    /** Change type */
+    type: 'create' | 'update' | 'delete' | 'rename';
+    /** Source of change */
+    source: 'git' | 'do';
+    /** Timestamp */
+    timestamp: number;
+    /** Old path (for renames) */
+    oldPath?: string;
+    /** Content hash */
+    hash?: string;
+}
+/**
+ * Sync conflict
+ */
+export interface SyncConflict {
+    /** File path */
+    path: string;
+    /** Git version */
+    gitVersion: {
+        sha: string;
+        timestamp: number;
+        content?: string;
+    };
+    /** DO version */
+    doVersion: {
+        version: number;
+        timestamp: number;
+        content?: string;
+    };
+    /** Suggested resolution */
+    suggestedResolution?: 'git' | 'do' | 'merge';
+    /** Merged content (if auto-merged) */
+    mergedContent?: string;
+}
+/**
+ * Git sync result
+ */
+export interface GitSyncResult {
+    /** Whether sync succeeded */
+    success: boolean;
+    /** Direction of sync */
+    direction: 'push' | 'pull' | 'bidirectional';
+    /** Files synced */
+    filesSynced: number;
+    /** Files created */
+    created: string[];
+    /** Files updated */
+    updated: string[];
+    /** Files deleted */
+    deleted: string[];
+    /** Conflicts encountered */
+    conflicts?: SyncConflict[];
+    /** New commit SHA (if pushed) */
+    commitSha?: string;
+    /** Duration in ms */
+    duration: number;
+    /** Error message (if failed) */
+    error?: string;
+}
+/**
+ * Git operations interface (subset of gitx)
+ */
+export interface GitOperations {
+    /** Initialize repository */
+    init(config: GitSyncConfig): Promise<void>;
+    /** Clone repository */
+    clone(config: GitSyncConfig): Promise<void>;
+    /** Get repository state */
+    status(): Promise<GitRepoState>;
+    /** Get sync status */
+    syncStatus(): Promise<GitSyncStatusDetail>;
+    /** Pull changes from remote */
+    pull(): Promise<GitSyncResult>;
+    /** Push changes to remote */
+    push(): Promise<GitSyncResult>;
+    /** Sync bidirectionally */
+    sync(): Promise<GitSyncResult>;
+    /** Commit local changes */
+    commit(message: string): Promise<string>;
+    /** Get file content from git */
+    getFile(path: string, ref?: string): Promise<string | null>;
+    /** Write file to git */
+    setFile(path: string, content: string): Promise<void>;
+    /** Delete file from git */
+    deleteFile(path: string): Promise<void>;
+    /** List files */
+    listFiles(path?: string): Promise<GitFileInfo[]>;
+    /** Get diff between DO and git */
+    diff(): Promise<PendingChange[]>;
+    /** Resolve conflict */
+    resolveConflict(path: string, resolution: 'git' | 'do' | 'merge', mergedContent?: string): Promise<void>;
+}
+/**
+ * File info from git
+ */
+export interface GitFileInfo {
+    path: string;
+    type: 'file' | 'directory';
+    size?: number;
+    sha?: string;
+    mode?: string;
+}
+/**
+ * Git hook types
+ */
+export type GitHookType = 'pre-commit' | 'post-commit' | 'pre-push' | 'post-push' | 'pre-pull' | 'post-pull' | 'pre-sync' | 'post-sync';
+/**
+ * Git hook configuration
+ */
+export interface GitHook {
+    /** Hook type */
+    type: GitHookType;
+    /** Whether hook is enabled */
+    enabled: boolean;
+    /** Function to run */
+    handler: string;
+    /** Timeout in ms */
+    timeout?: number;
+}
+/**
+ * Git hook context
+ */
+export interface GitHookContext {
+    /** Hook type */
+    type: GitHookType;
+    /** Files affected */
+    files: string[];
+    /** Commit message (for commit hooks) */
+    message?: string;
+    /** Commit SHA */
+    sha?: string;
+    /** Can abort operation */
+    abort: (reason: string) => void;
+}
+/**
+ * Path mapping between DO and git
+ */
+export interface PathMapping {
+    /** DO collection/path */
+    doPath: string;
+    /** Git path */
+    gitPath: string;
+    /** File extension in git */
+    extension?: string;
+    /** Transform on sync */
+    transform?: 'none' | 'frontmatter' | 'json';
+}
+/**
+ * Default path mappings
+ */
+export declare const DEFAULT_PATH_MAPPINGS: PathMapping[];
+//# sourceMappingURL=git.d.ts.map

package/dist/types/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../types/git.ts"],"names":[],"mappings":"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"}

package/dist/types/git.js

@@ -0,0 +1,17 @@
+/**
+ * Git Integration Types - Content/Code Sync with Git
+ *
+ * Integration between DO storage and git repositories
+ * Supports bidirectional sync with configurable source of truth
+ */
+/**
+ * Default path mappings
+ */
+export const DEFAULT_PATH_MAPPINGS = [
+    { doPath: 'pages', gitPath: 'content/pages', extension: '.mdx' },
+    { doPath: 'posts', gitPath: 'content/blog', extension: '.mdx' },
+    { doPath: 'docs', gitPath: 'content/docs', extension: '.mdx' },
+    { doPath: 'functions', gitPath: 'functions', extension: '.ts' },
+    { doPath: 'workflows', gitPath: 'workflows', extension: '.ts' },
+];
+//# sourceMappingURL=git.js.map

package/dist/types/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../types/git.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyWH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAkB;IAClD,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE;IAChE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE;IAC/D,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE;IAC9D,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE;IAC/D,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE;CAChE,CAAA"}