gitx.do 0.1.0 → 0.1.1

package/dist/types/interfaces.d.ts

@@ -0,0 +1,673 @@
+/**
+ * @fileoverview Consolidated Interface Types
+ *
+ * This module provides common interface types used across the gitx.do codebase,
+ * including storage interfaces, R2 bucket types, and workflow context interfaces.
+ * These interfaces serve as the foundation for DO integration modules.
+ *
+ * @module types/interfaces
+ *
+ * @example
+ * ```typescript
+ * import type { SqlStorage, R2BucketLike, WorkflowContext } from 'gitx.do/types'
+ *
+ * // Use in a Durable Object context
+ * class MyDO {
+ *   private storage: SqlStorage
+ *   private r2: R2BucketLike
+ *
+ *   constructor(state: DurableObjectState) {
+ *     this.storage = state.storage
+ *   }
+ * }
+ * ```
+ */
+/**
+ * SQL execution result interface.
+ *
+ * @description
+ * Represents the result of executing a SQL query. The result can be
+ * converted to an array of row objects using the toArray() method.
+ *
+ * @example
+ * ```typescript
+ * const result = storage.sql.exec('SELECT * FROM objects WHERE sha = ?', sha)
+ * const rows = result.toArray()
+ * ```
+ */
+export interface SqlResult {
+    /**
+     * Convert the result to an array of row objects.
+     * @returns Array of row objects matching the query
+     */
+    toArray(): unknown[];
+}
+/**
+ * SQL execution interface.
+ *
+ * @description
+ * Provides access to SQLite query execution within a Durable Object.
+ * Supports parameterized queries using ? placeholders.
+ *
+ * @example
+ * ```typescript
+ * const result = storage.sql.exec(
+ *   'INSERT INTO objects (sha, type, data) VALUES (?, ?, ?)',
+ *   sha, 'blob', data
+ * )
+ * ```
+ */
+export interface SqlExec {
+    /**
+     * Execute a SQL query with optional parameters.
+     *
+     * @param query - SQL query string (can use ? placeholders)
+     * @param params - Parameter values for placeholders
+     * @returns Result object with toArray() method for reading rows
+     */
+    exec(query: string, ...params: unknown[]): SqlResult;
+}
+/**
+ * SQL storage interface for Durable Object storage.
+ *
+ * @description
+ * Abstraction over Cloudflare's Durable Object storage that provides
+ * SQLite access. This interface is used by modules that need database
+ * persistence within a DO.
+ *
+ * @example
+ * ```typescript
+ * class GitModule {
+ *   constructor(private storage: SqlStorage) {}
+ *
+ *   async getCommit(sha: string) {
+ *     const result = this.storage.sql.exec(
+ *       'SELECT * FROM objects WHERE sha = ? AND type = ?',
+ *       sha, 'commit'
+ *     )
+ *     return result.toArray()[0]
+ *   }
+ * }
+ * ```
+ */
+export interface SqlStorage {
+    /**
+     * SQL execution interface.
+     */
+    sql: SqlExec;
+}
+/**
+ * R2 object interface.
+ *
+ * @description
+ * Represents a single object stored in R2 (Cloudflare's object storage).
+ * Provides methods to access the object's content as binary data or text.
+ *
+ * @example
+ * ```typescript
+ * const obj = await r2.get('git/objects/ab/cdef...')
+ * if (obj) {
+ *   const data = await obj.arrayBuffer()
+ *   console.log(`Object size: ${obj.size} bytes`)
+ * }
+ * ```
+ */
+export interface R2ObjectLike {
+    /** Object key (path in the bucket) */
+    key: string;
+    /** Object size in bytes */
+    size: number;
+    /**
+     * Get the object content as an ArrayBuffer.
+     * @returns Promise resolving to the binary content
+     */
+    arrayBuffer(): Promise<ArrayBuffer>;
+    /**
+     * Get the object content as a UTF-8 string.
+     * @returns Promise resolving to the text content
+     */
+    text(): Promise<string>;
+}
+/**
+ * R2 objects list result interface.
+ *
+ * @description
+ * Represents the result of listing objects in an R2 bucket.
+ * Supports pagination through the truncated flag and cursor.
+ *
+ * @example
+ * ```typescript
+ * let cursor: string | undefined
+ * do {
+ *   const result = await r2.list({ prefix: 'git/objects/', cursor })
+ *   for (const obj of result.objects) {
+ *     console.log(obj.key)
+ *   }
+ *   cursor = result.truncated ? result.cursor : undefined
+ * } while (cursor)
+ * ```
+ */
+export interface R2ObjectsLike {
+    /** Array of object references */
+    objects: R2ObjectLike[];
+    /** Whether there are more objects to fetch */
+    truncated: boolean;
+    /** Cursor for fetching the next page of results */
+    cursor?: string;
+    /** Delimited prefixes (for directory-like listing) */
+    delimitedPrefixes?: string[];
+}
+/**
+ * R2 put options interface.
+ *
+ * @description
+ * Options for putting objects into R2 storage.
+ */
+export interface R2PutOptions {
+    /** Content-Type header for the object */
+    httpMetadata?: {
+        contentType?: string;
+        contentLanguage?: string;
+        contentDisposition?: string;
+        contentEncoding?: string;
+        cacheControl?: string;
+        cacheExpiry?: Date;
+    };
+    /** Custom metadata for the object */
+    customMetadata?: Record<string, string>;
+    /** MD5 hash for integrity verification */
+    md5?: ArrayBuffer | string;
+    /** SHA-1 hash for integrity verification */
+    sha1?: ArrayBuffer | string;
+    /** SHA-256 hash for integrity verification */
+    sha256?: ArrayBuffer | string;
+    /** SHA-384 hash for integrity verification */
+    sha384?: ArrayBuffer | string;
+    /** SHA-512 hash for integrity verification */
+    sha512?: ArrayBuffer | string;
+    /** Storage class for the object */
+    storageClass?: 'Standard' | 'InfrequentAccess';
+}
+/**
+ * R2 bucket interface for object storage operations.
+ *
+ * @description
+ * Represents an R2 bucket with methods for CRUD operations on objects.
+ * Used as the global git object store across DOs.
+ *
+ * @example
+ * ```typescript
+ * // Store a git object
+ * const sha = 'abc123...'
+ * const key = `git/objects/${sha.slice(0, 2)}/${sha.slice(2)}`
+ * await r2.put(key, objectData)
+ *
+ * // Retrieve a git object
+ * const obj = await r2.get(key)
+ * if (obj) {
+ *   const data = await obj.arrayBuffer()
+ * }
+ * ```
+ */
+export interface R2BucketLike {
+    /**
+     * Get an object from the bucket.
+     * @param key - Object key
+     * @returns Promise resolving to the object, or null if not found
+     */
+    get(key: string): Promise<R2ObjectLike | null>;
+    /**
+     * Put an object into the bucket.
+     * @param key - Object key
+     * @param value - Object content (binary data or string)
+     * @param options - Optional put options
+     * @returns Promise resolving to the stored object reference
+     */
+    put(key: string, value: ArrayBuffer | Uint8Array | string | ReadableStream | Blob, options?: R2PutOptions): Promise<R2ObjectLike>;
+    /**
+     * Delete one or more objects from the bucket.
+     * @param key - Object key or array of keys to delete
+     */
+    delete(key: string | string[]): Promise<void>;
+    /**
+     * List objects in the bucket.
+     * @param options - List options (prefix, limit, cursor, delimiter)
+     * @returns Promise resolving to the list result
+     */
+    list(options?: {
+        prefix?: string;
+        limit?: number;
+        cursor?: string;
+        delimiter?: string;
+        include?: string[];
+    }): Promise<R2ObjectsLike>;
+    /**
+     * Check if an object exists in the bucket.
+     * @param key - Object key
+     * @returns Promise resolving to object metadata, or null if not found
+     */
+    head?(key: string): Promise<R2ObjectLike | null>;
+}
+/**
+ * KV namespace interface for key-value storage.
+ *
+ * @description
+ * Represents a Cloudflare KV namespace for simple key-value operations.
+ * Used for caching and lightweight data storage.
+ *
+ * @example
+ * ```typescript
+ * // Store a value
+ * await kv.put('user:123', JSON.stringify({ name: 'Alice' }))
+ *
+ * // Retrieve a value
+ * const data = await kv.get('user:123')
+ * if (data) {
+ *   const user = JSON.parse(data)
+ * }
+ * ```
+ */
+export interface KVNamespaceLike {
+    /**
+     * Get a value from KV.
+     * @param key - Key to look up
+     * @param options - Optional read options
+     * @returns Promise resolving to the value, or null if not found
+     */
+    get(key: string, options?: {
+        type?: 'text' | 'json' | 'arrayBuffer' | 'stream';
+    }): Promise<string | null>;
+    /**
+     * Put a value into KV.
+     * @param key - Key to store under
+     * @param value - Value to store
+     * @param options - Optional write options (expiration, metadata)
+     */
+    put(key: string, value: string | ArrayBuffer | ReadableStream, options?: {
+        expiration?: number;
+        expirationTtl?: number;
+        metadata?: unknown;
+    }): Promise<void>;
+    /**
+     * Delete a value from KV.
+     * @param key - Key to delete
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * List keys in KV.
+     * @param options - List options (prefix, limit, cursor)
+     * @returns Promise resolving to the list result
+     */
+    list(options?: {
+        prefix?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        keys: Array<{
+            name: string;
+            expiration?: number;
+            metadata?: unknown;
+        }>;
+        list_complete: boolean;
+        cursor?: string;
+    }>;
+}
+/**
+ * Durable Object ID interface.
+ *
+ * @description
+ * Represents a unique identifier for a Durable Object instance.
+ */
+export interface DurableObjectId {
+    /** String representation of the ID */
+    toString(): string;
+    /** Check if two IDs are equal */
+    equals(other: DurableObjectId): boolean;
+}
+/**
+ * Durable Object stub interface.
+ *
+ * @description
+ * A stub for communicating with a Durable Object instance.
+ * Used to send HTTP requests to a DO.
+ *
+ * @example
+ * ```typescript
+ * const id = env.DO_NAMESPACE.idFromName('my-repo')
+ * const stub = env.DO_NAMESPACE.get(id)
+ * const response = await stub.fetch(request)
+ * ```
+ */
+export interface DurableObjectStub {
+    /**
+     * Send an HTTP request to the Durable Object.
+     * @param request - Request object or URL string
+     * @param init - Optional request init
+     * @returns Promise resolving to the response
+     */
+    fetch(request: Request | string, init?: RequestInit): Promise<Response>;
+    /** The ID of this Durable Object */
+    id: DurableObjectId;
+    /** Name of the Durable Object (if created with idFromName) */
+    name?: string;
+}
+/**
+ * Durable Object namespace interface.
+ *
+ * @description
+ * Provides methods for creating IDs and getting stubs to Durable Objects.
+ *
+ * @example
+ * ```typescript
+ * // Get a DO by name
+ * const id = env.DO_NAMESPACE.idFromName('repo/my-repo')
+ * const stub = env.DO_NAMESPACE.get(id)
+ *
+ * // Create a new unique DO
+ * const newId = env.DO_NAMESPACE.newUniqueId()
+ * const newStub = env.DO_NAMESPACE.get(newId)
+ * ```
+ */
+export interface DurableObjectNamespace {
+    /**
+     * Create an ID from a name (deterministic).
+     * @param name - String name to derive ID from
+     * @returns The Durable Object ID
+     */
+    idFromName(name: string): DurableObjectId;
+    /**
+     * Parse an ID from its string representation.
+     * @param id - String representation of the ID
+     * @returns The Durable Object ID
+     */
+    idFromString(id: string): DurableObjectId;
+    /**
+     * Create a new unique ID.
+     * @param options - Optional creation options (locationHint)
+     * @returns A new unique Durable Object ID
+     */
+    newUniqueId(options?: {
+        locationHint?: string;
+    }): DurableObjectId;
+    /**
+     * Get a stub for communicating with a Durable Object.
+     * @param id - The Durable Object ID
+     * @returns A stub for making requests to the DO
+     */
+    get(id: DurableObjectId): DurableObjectStub;
+    /**
+     * Get jurisdiction-restricted ID from name.
+     * @param name - String name to derive ID from
+     * @param options - Jurisdiction options
+     * @returns The Durable Object ID
+     */
+    jurisdiction?(name: string, options: {
+        jurisdiction: string;
+    }): DurableObjectId;
+}
+/**
+ * Durable Object state interface.
+ *
+ * @description
+ * The state object passed to a Durable Object constructor.
+ * Provides access to storage, ID, and lifecycle methods.
+ *
+ * @example
+ * ```typescript
+ * class MyDO implements DurableObject {
+ *   constructor(private state: DurableObjectState, private env: Env) {
+ *     // Access storage
+ *     const data = this.state.storage.sql.exec('SELECT * FROM table')
+ *   }
+ * }
+ * ```
+ */
+export interface DurableObjectState {
+    /** The unique ID of this Durable Object */
+    id: DurableObjectId;
+    /** Storage interface with SQL and key-value access */
+    storage: SqlStorage & {
+        get(key: string): Promise<unknown>;
+        put(key: string, value: unknown): Promise<void>;
+        delete(key: string): Promise<boolean>;
+        list(options?: {
+            prefix?: string;
+        }): Promise<Map<string, unknown>>;
+        setAlarm(scheduledTime: number | Date): Promise<void>;
+        getAlarm(): Promise<number | null>;
+        deleteAlarm(): Promise<void>;
+    };
+    /**
+     * Block concurrent requests until callback completes.
+     * Used for initialization that must complete before handling requests.
+     * @param callback - Async function to execute
+     */
+    blockConcurrencyWhile<T>(callback: () => Promise<T>): Promise<T>;
+    /**
+     * Extend the lifetime of the DO to complete async work.
+     * @param promise - Promise to wait for
+     */
+    waitUntil(promise: Promise<unknown>): void;
+    /**
+     * Accept websocket connections.
+     * @param ws - WebSocket to accept
+     * @param tags - Optional tags for the connection
+     */
+    acceptWebSocket?(ws: WebSocket, tags?: string[]): void;
+    /**
+     * Get all accepted websockets.
+     * @param tag - Optional tag filter
+     * @returns Array of accepted WebSockets
+     */
+    getWebSockets?(tag?: string): WebSocket[];
+}
+/**
+ * Event handler registration interface.
+ *
+ * @description
+ * Provides a proxy interface for registering event handlers using
+ * the pattern $.on.Noun.verb(handler).
+ *
+ * @example
+ * ```typescript
+ * // Register event handlers
+ * $.on.User.created((user) => console.log('User created:', user))
+ * $.on.Order.completed((order) => processOrder(order))
+ * ```
+ */
+export type EventHandlerProxy = {
+    [noun: string]: {
+        [verb: string]: (handler: (data: unknown) => void | Promise<void>) => void;
+    };
+};
+/**
+ * Schedule builder interface.
+ *
+ * @description
+ * Provides a proxy interface for scheduling recurring tasks using
+ * natural language patterns like $.every.monday.at('9am').
+ *
+ * @example
+ * ```typescript
+ * // Schedule recurring tasks
+ * $.every.monday.at('9am')(() => sendWeeklyReport())
+ * $.every.hour.at('30')(() => cleanupTempFiles())
+ * ```
+ */
+export type ScheduleProxy = {
+    [schedule: string]: {
+        at: (time: string) => (handler: () => void | Promise<void>) => void;
+    };
+};
+/**
+ * Workflow context interface (the $ API).
+ *
+ * @description
+ * The main workflow context interface providing the $ API pattern
+ * used throughout dotdo. Includes messaging (send/try/do), event
+ * handling (on), and scheduling (every).
+ *
+ * @example
+ * ```typescript
+ * class MyDO extends DO {
+ *   async handleRequest() {
+ *     // Fire-and-forget
+ *     this.$.send('user.created', { id: '123' })
+ *
+ *     // Quick attempt
+ *     const result = await this.$.try('validate', data)
+ *
+ *     // Durable execution
+ *     await this.$.do('process', data)
+ *   }
+ * }
+ * ```
+ */
+export interface WorkflowContext {
+    /**
+     * Fire-and-forget event dispatch.
+     * Queues an event for async processing without waiting.
+     * @param event - Event name
+     * @param data - Optional event data
+     */
+    send(event: string, data?: unknown): void;
+    /**
+     * Quick attempt (blocking, non-durable).
+     * Executes an action directly without persistence.
+     * @param action - Action name
+     * @param data - Optional action data
+     * @returns Promise resolving to the action result
+     */
+    try<T>(action: string, data?: unknown): Promise<T>;
+    /**
+     * Durable execution with retries.
+     * Stores the action for durability and executes with retry logic.
+     * @param action - Action name
+     * @param data - Optional action data
+     * @returns Promise resolving to the action result
+     */
+    do<T>(action: string, data?: unknown): Promise<T>;
+    /**
+     * Event handler registration proxy.
+     * Use as $.on.Noun.verb(handler).
+     */
+    on: EventHandlerProxy;
+    /**
+     * Schedule builder proxy.
+     * Use as $.every.schedule.at('time')(handler).
+     */
+    every: ScheduleProxy;
+    /**
+     * Allow additional dynamic properties for domain proxies.
+     * Supports patterns like $.User('id').method().
+     */
+    [key: string]: unknown;
+}
+/**
+ * Base module interface.
+ *
+ * @description
+ * Common interface for all DO modules (GitModule, FsModule, BashModule).
+ * Provides lifecycle methods and a module name identifier.
+ *
+ * @example
+ * ```typescript
+ * class MyModule implements Module {
+ *   readonly name = 'my-module'
+ *
+ *   async initialize() {
+ *     // Setup module
+ *   }
+ *
+ *   async dispose() {
+ *     // Cleanup resources
+ *   }
+ * }
+ * ```
+ */
+export interface Module {
+    /** Module name identifier */
+    readonly name: string;
+    /**
+     * Initialize the module.
+     * Called when the DO is first activated.
+     */
+    initialize?(): Promise<void>;
+    /**
+     * Dispose the module.
+     * Called when the DO is about to be deactivated.
+     */
+    dispose?(): Promise<void>;
+}
+/**
+ * Storage-backed module interface.
+ *
+ * @description
+ * Interface for modules that persist state using SQL storage.
+ * Extends the base Module interface with storage capabilities.
+ */
+export interface StorageBackedModule extends Module {
+    /**
+     * Attach storage to the module.
+     * @param storage - SQL storage interface
+     */
+    attachStorage?(storage: SqlStorage): void;
+}
+/**
+ * Capability mixin result type.
+ *
+ * @description
+ * Generic type for the result of applying a capability mixin.
+ * Combines the base class with the capability interface.
+ *
+ * @template Base - The base class type
+ * @template Cap - The capability interface
+ *
+ * @example
+ * ```typescript
+ * type GitCapableDO = WithCapability<typeof DO, GitCapability>
+ * ```
+ */
+export type WithCapability<Base, Cap> = Base & Cap;
+/**
+ * Base error class for gitx operations.
+ *
+ * @description
+ * Extends the standard Error with additional context fields
+ * for better error handling and debugging.
+ */
+export interface GitxError extends Error {
+    /** Error code for programmatic handling */
+    code: string;
+    /** HTTP status code if applicable */
+    status?: number;
+    /** Additional context data */
+    context?: Record<string, unknown>;
+}
+/**
+ * Storage error for database operations.
+ */
+export interface StorageError extends GitxError {
+    code: 'STORAGE_ERROR';
+    /** The SQL query that failed */
+    query?: string;
+}
+/**
+ * R2 error for object storage operations.
+ */
+export interface R2Error extends GitxError {
+    code: 'R2_ERROR';
+    /** The object key involved */
+    key?: string;
+}
+/**
+ * Git error for git operations.
+ */
+export interface GitError extends GitxError {
+    code: 'GIT_ERROR';
+    /** The git operation that failed */
+    operation?: string;
+    /** The repository involved */
+    repo?: string;
+}
+//# sourceMappingURL=interfaces.d.ts.map

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

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

package/dist/types/interfaces.js

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Consolidated Interface Types
+ *
+ * This module provides common interface types used across the gitx.do codebase,
+ * including storage interfaces, R2 bucket types, and workflow context interfaces.
+ * These interfaces serve as the foundation for DO integration modules.
+ *
+ * @module types/interfaces
+ *
+ * @example
+ * ```typescript
+ * import type { SqlStorage, R2BucketLike, WorkflowContext } from 'gitx.do/types'
+ *
+ * // Use in a Durable Object context
+ * class MyDO {
+ *   private storage: SqlStorage
+ *   private r2: R2BucketLike
+ *
+ *   constructor(state: DurableObjectState) {
+ *     this.storage = state.storage
+ *   }
+ * }
+ * ```
+ */
+export {};
+//# sourceMappingURL=interfaces.js.map