@dotdo/do 0.1.0

package/dist/api/types.d.ts

@@ -0,0 +1,370 @@
+/**
+ * API Types - Type definitions for the Hono-based API layer
+ *
+ * Includes:
+ * - Request/response types
+ * - Context types for middleware
+ * - Error types
+ * - Configuration types
+ */
+import type { Context, MiddlewareHandler } from 'hono';
+/**
+ * Cloudflare Worker environment bindings
+ */
+export interface Env {
+    /** Durable Object namespace for Digital Objects */
+    DO: DurableObjectNamespace;
+    /** R2 bucket for cold storage */
+    R2: R2Bucket;
+    /** KV namespace for caching */
+    KV: KVNamespace;
+    /** Cloudflare AI binding */
+    AI: Ai;
+    /** Environment (development, staging, production) */
+    ENVIRONMENT: string;
+    /** Optional: Auth secret for JWT validation */
+    AUTH_SECRET?: string;
+    /** Optional: Rate limit requests per minute */
+    RATE_LIMIT_RPM?: string;
+}
+/**
+ * Extended Hono context with DO-specific variables
+ */
+export interface DOContext {
+    /** Authenticated user info */
+    user?: AuthUser;
+    /** Request ID for tracing */
+    requestId: string;
+    /** Start time for latency tracking */
+    startTime: number;
+    /** Target DO hostname */
+    hostname: string;
+    /** Colo (datacenter) code */
+    colo?: string;
+}
+/**
+ * Authenticated user
+ */
+export interface AuthUser {
+    /** User ID */
+    id: string;
+    /** Email address */
+    email?: string;
+    /** Organization ID */
+    orgId?: string;
+    /** Roles */
+    roles: string[];
+    /** Permissions */
+    permissions: string[];
+    /** Token expiration time */
+    exp?: number;
+}
+/**
+ * Authentication result
+ */
+export interface AuthResult {
+    /** Whether authentication succeeded */
+    success: boolean;
+    /** Authenticated user (if success) */
+    user?: AuthUser;
+    /** Error message (if failed) */
+    error?: string;
+}
+/**
+ * Authentication options
+ */
+export interface AuthOptions {
+    /** JWT secret for validation */
+    secret?: string;
+    /** Whether to require auth (vs optional) */
+    required?: boolean;
+    /** Required roles */
+    roles?: string[];
+    /** Required permissions */
+    permissions?: string[];
+    /** Custom token extractor */
+    extractToken?: (c: Context) => string | null;
+}
+/**
+ * Standard API response wrapper
+ * Every response includes clickable links for API discovery
+ */
+export interface APIResponse<T = unknown> {
+    /** API identifier (usually the hostname) */
+    api: string;
+    /** Response data */
+    data: T;
+    /** Clickable links to related endpoints */
+    links: Record<string, string>;
+    /** Authenticated user (if any) */
+    user?: string;
+    /** Cloudflare colo code */
+    colo?: string;
+    /** Response timestamp */
+    timestamp: number;
+}
+/**
+ * API error response
+ */
+export interface APIErrorResponse {
+    /** API identifier */
+    api: string;
+    /** Error details */
+    error: {
+        /** Error code */
+        code: string;
+        /** Human-readable message */
+        message: string;
+        /** Additional error details */
+        details?: unknown;
+    };
+    /** Clickable links */
+    links: Record<string, string>;
+    /** Response timestamp */
+    timestamp: number;
+}
+/**
+ * Pagination info
+ */
+export interface PaginationInfo {
+    /** Total items */
+    total: number;
+    /** Current page */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Total pages */
+    totalPages: number;
+    /** Has more pages */
+    hasMore: boolean;
+    /** Next cursor (for cursor-based pagination) */
+    nextCursor?: string;
+}
+/**
+ * Paginated response
+ */
+export interface PaginatedResponse<T> extends APIResponse<T[]> {
+    /** Pagination info */
+    pagination: PaginationInfo;
+}
+/**
+ * Rate limit configuration
+ */
+export interface RateLimitConfig {
+    /** Window size in seconds */
+    windowSecs: number;
+    /** Max requests per window */
+    maxRequests: number;
+    /** Key generator (default: IP-based) */
+    keyGenerator?: (c: Context) => string;
+    /** Skip rate limiting for these paths */
+    skipPaths?: string[];
+    /** Custom rate limit by path */
+    pathLimits?: Record<string, number>;
+}
+/**
+ * Rate limit info (returned in headers)
+ */
+export interface RateLimitInfo {
+    /** Max requests allowed */
+    limit: number;
+    /** Remaining requests */
+    remaining: number;
+    /** Window reset time (Unix timestamp) */
+    reset: number;
+}
+/**
+ * CORS configuration
+ */
+export interface CORSConfig {
+    /** Allowed origins (default: '*') */
+    origin?: string | string[] | ((origin: string) => boolean);
+    /** Allowed methods */
+    methods?: string[];
+    /** Allowed headers */
+    allowedHeaders?: string[];
+    /** Exposed headers */
+    exposedHeaders?: string[];
+    /** Allow credentials */
+    credentials?: boolean;
+    /** Max age for preflight cache */
+    maxAge?: number;
+}
+/**
+ * Route definition
+ */
+export interface RouteDefinition {
+    /** HTTP method */
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS';
+    /** Path pattern */
+    path: string;
+    /** Handler function */
+    handler: (c: Context<{
+        Bindings: Env;
+        Variables: DOContext;
+    }>) => Promise<Response> | Response;
+    /** Middleware to apply */
+    middleware?: MiddlewareHandler[];
+    /** Route description (for docs) */
+    description?: string;
+    /** Whether auth is required */
+    auth?: boolean;
+}
+/**
+ * Route group
+ */
+export interface RouteGroup {
+    /** Base path */
+    basePath: string;
+    /** Routes in this group */
+    routes: RouteDefinition[];
+    /** Middleware to apply to all routes */
+    middleware?: MiddlewareHandler[];
+}
+/**
+ * DO operation request
+ */
+export interface DOOperationRequest {
+    /** Operation type */
+    operation: 'create' | 'read' | 'update' | 'delete' | 'list' | 'execute';
+    /** Collection name */
+    collection: string;
+    /** Item ID (for single-item operations) */
+    id?: string;
+    /** Data payload */
+    data?: unknown;
+    /** Query options */
+    options?: {
+        limit?: number;
+        offset?: number;
+        cursor?: string;
+        orderBy?: string;
+        orderDir?: 'asc' | 'desc';
+        filter?: Record<string, unknown>;
+    };
+}
+/**
+ * DO operation result
+ */
+export interface DOOperationResult<T = unknown> {
+    /** Whether operation succeeded */
+    success: boolean;
+    /** Result data */
+    data?: T;
+    /** Error (if failed) */
+    error?: {
+        code: string;
+        message: string;
+    };
+    /** Affected count (for mutations) */
+    affected?: number;
+    /** Pagination info (for list operations) */
+    pagination?: PaginationInfo;
+}
+/**
+ * AI generation request
+ */
+export interface AIGenerateRequest {
+    /** Prompt text */
+    prompt: string;
+    /** Model selector (characteristic-based) */
+    model?: 'best' | 'fast' | 'cost' | 'reasoning' | 'code' | 'vision' | 'long' | string;
+    /** System prompt */
+    system?: string;
+    /** Temperature (0-2) */
+    temperature?: number;
+    /** Max tokens */
+    maxTokens?: number;
+    /** JSON mode */
+    jsonMode?: boolean;
+    /** Stream response */
+    stream?: boolean;
+}
+/**
+ * AI chat request
+ */
+export interface AIChatRequest {
+    /** Chat messages */
+    messages: Array<{
+        role: 'system' | 'user' | 'assistant';
+        content: string;
+    }>;
+    /** Model selector */
+    model?: string;
+    /** Temperature */
+    temperature?: number;
+    /** Max tokens */
+    maxTokens?: number;
+    /** Tools available */
+    tools?: Array<{
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    }>;
+    /** Stream response */
+    stream?: boolean;
+}
+/**
+ * AI embedding request
+ */
+export interface AIEmbedRequest {
+    /** Text to embed */
+    text: string | string[];
+    /** Model (optional) */
+    model?: string;
+    /** Dimensions (for models that support it) */
+    dimensions?: number;
+}
+/**
+ * Health check response
+ */
+export interface HealthCheckResponse {
+    /** Service status */
+    status: 'ok' | 'degraded' | 'down';
+    /** Current timestamp */
+    timestamp: number;
+    /** Cloudflare colo */
+    colo?: string;
+    /** Service version */
+    version: string;
+    /** Component health */
+    components?: Record<string, {
+        status: 'ok' | 'degraded' | 'down';
+        latencyMs?: number;
+        message?: string;
+    }>;
+}
+/**
+ * Middleware configuration
+ */
+export interface MiddlewareConfig {
+    /** Whether middleware is enabled */
+    enabled: boolean;
+    /** Paths to skip */
+    skip?: string[];
+    /** Additional options */
+    options?: Record<string, unknown>;
+}
+/**
+ * Logging middleware options
+ */
+export interface LoggingOptions {
+    /** Log level */
+    level?: 'debug' | 'info' | 'warn' | 'error';
+    /** Include request body */
+    includeBody?: boolean;
+    /** Include response body */
+    includeResponse?: boolean;
+    /** Paths to skip */
+    skipPaths?: string[];
+}
+/**
+ * Timing middleware options
+ */
+export interface TimingOptions {
+    /** Header name for timing info */
+    headerName?: string;
+    /** Include in response body */
+    includeInBody?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/api/types.js

@@ -0,0 +1,11 @@
+/**
+ * API Types - Type definitions for the Hono-based API layer
+ *
+ * Includes:
+ * - Request/response types
+ * - Context types for middleware
+ * - Error types
+ * - Configuration types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/api/types.js.map

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

package/dist/db/cdc/events.d.ts

@@ -0,0 +1,201 @@
+/**
+ * CDC Event Generation
+ *
+ * Generates Change Data Capture events for all mutations within a Digital Object.
+ * Events capture INSERT, UPDATE, DELETE operations with before/after state.
+ *
+ * @module cdc/events
+ */
+import type { CDCEvent, CDCOperation, CDCCursor } from '../../types/storage';
+/**
+ * Configuration options for the CDC event emitter
+ */
+export interface CDCEmitterOptions {
+    /**
+     * Whether to include full document in before/after fields
+     * @default true
+     */
+    includeDocuments?: boolean;
+    /**
+     * Whether to compute and include changed fields for UPDATE operations
+     * @default true
+     */
+    includeChangedFields?: boolean;
+    /**
+     * Source identifier for this DO (usually the $id)
+     */
+    source?: string;
+    /**
+     * Collection name for events
+     */
+    collection?: string;
+    /**
+     * Starting sequence number
+     * @default 0
+     */
+    startSequence?: number;
+    /**
+     * Maximum events to buffer before forcing a flush
+     * @default 100
+     */
+    bufferSize?: number;
+    /**
+     * Maximum time in ms to buffer events before flushing
+     * @default 1000
+     */
+    bufferTimeout?: number;
+    /**
+     * Maximum events per batch
+     * @default 100
+     */
+    batchSize?: number;
+    /**
+     * Maximum time in ms to wait before sending batch
+     * @default 1000
+     */
+    batchTimeout?: number;
+}
+/**
+ * Callback invoked when events are ready to be processed
+ * Return value is ignored - can return void, Promise, or any other value
+ */
+export type CDCEventHandler = (events: CDCEvent[]) => unknown;
+/**
+ * CDCEventEmitter - Generates CDC events for mutations
+ *
+ * @example
+ * ```typescript
+ * const emitter = new CDCEventEmitter({
+ *   source: 'https://my.do',
+ *   includeDocuments: true,
+ * })
+ *
+ * // Emit an INSERT event
+ * const event = await emitter.emit('INSERT', 'users', 'user-123', {
+ *   after: { name: 'Alice', email: 'alice@example.com' },
+ * })
+ *
+ * // Emit an UPDATE event
+ * const updateEvent = await emitter.emit('UPDATE', 'users', 'user-123', {
+ *   before: { name: 'Alice', email: 'alice@example.com' },
+ *   after: { name: 'Alice Smith', email: 'alice@example.com' },
+ * })
+ *
+ * // Emit a DELETE event
+ * const deleteEvent = await emitter.emit('DELETE', 'users', 'user-123', {
+ *   before: { name: 'Alice Smith', email: 'alice@example.com' },
+ * })
+ * ```
+ */
+export declare class CDCEventEmitter {
+    private options;
+    private sequence;
+    private lastTimestamp;
+    private buffer;
+    private batchHandlers;
+    private batchTimer;
+    /**
+     * Creates a new CDC event emitter
+     *
+     * @param options - Configuration options
+     */
+    constructor(options?: CDCEmitterOptions);
+    /**
+     * Emits a CDC event for a mutation
+     *
+     * @param operation - The type of mutation (INSERT, UPDATE, DELETE)
+     * @param data - The before/after state data with optional correlation ID
+     * @returns The generated CDC event
+     *
+     * @example
+     * ```typescript
+     * const event = await emitter.emit('UPDATE', {
+     *   before: { id: 'prod-456', price: 99 },
+     *   after: { id: 'prod-456', price: 79 },
+     *   correlationId: 'req-789',
+     * })
+     * ```
+     */
+    emit<T extends {
+        id: string;
+    }>(operation: CDCOperation, data: {
+        before?: T;
+        after?: T;
+        correlationId?: string;
+    }): Promise<CDCEvent<T>>;
+    /**
+     * Registers a handler for batched events
+     *
+     * @param handler - Callback invoked with batches of events
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = emitter.onBatch(async (events) => {
+     *   await streamer.propagate(events)
+     * })
+     * ```
+     */
+    onBatch(handler: CDCEventHandler): () => void;
+    private flushBatch;
+    /**
+     * Forces immediate flush of buffered events
+     *
+     * @returns The flushed events
+     */
+    flush(): Promise<CDCEvent[]>;
+    /**
+     * Gets the current sequence number
+     *
+     * @returns The current sequence number
+     */
+    getSequence(): number;
+    /**
+     * Gets the current cursor position
+     *
+     * @returns The current cursor
+     */
+    getCursor(): CDCCursor;
+}
+/**
+ * Computes the list of fields that changed between two objects
+ *
+ * @param before - Object state before the change
+ * @param after - Object state after the change
+ * @returns Array of field names that changed
+ *
+ * @example
+ * ```typescript
+ * const changed = computeChangedFields(
+ *   { name: 'Alice', age: 30 },
+ *   { name: 'Alice', age: 31 }
+ * )
+ * // Returns: ['age']
+ * ```
+ */
+export declare function computeChangedFields(before: Record<string, unknown>, after: Record<string, unknown>, prefix?: string): string[];
+/**
+ * Generates a unique event ID
+ *
+ * @returns A unique event ID (UUID v4)
+ */
+export declare function generateEventId(): string;
+/**
+ * Creates a CDC event from raw data
+ *
+ * @param params - Event parameters
+ * @returns A fully populated CDC event
+ */
+export declare function createEvent<T>(params: {
+    operation: CDCOperation;
+    collection: string;
+    documentId: string;
+    sequence: number;
+    before?: T;
+    after?: T;
+    source?: string;
+    correlationId?: string;
+    includeChangedFields?: boolean;
+    changedFields?: string[];
+}): CDCEvent<T>;
+//# sourceMappingURL=events.d.ts.map

package/dist/db/cdc/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../db/cdc/events.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAwB,MAAM,qBAAqB,CAAA;AAElG;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAE1B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAE9B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,OAAO,CAAA;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,aAAa,CAAY;IACjC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,aAAa,CAAwB;IAC7C,OAAO,CAAC,UAAU,CAA6C;IAE/D;;;;OAIG;gBACS,OAAO,CAAC,EAAE,iBAAiB;IAYvC;;;;;;;;;;;;;;;OAeG;IACG,IAAI,CAAC,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EACjC,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GACtD,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAsCvB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,IAAI;YAU/B,UAAU;IAsBxB;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAMlC;;;;OAIG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;OAIG;IACH,SAAS,IAAI,SAAS;CAMvB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAE,MAAW,GAAG,MAAM,EAAE,CA4CnI;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE;IACrC,SAAS,EAAE,YAAY,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,CAAC,CAAA;IACV,KAAK,CAAC,EAAE,CAAC,CAAA;IACT,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CACzB,GAAG,QAAQ,CAAC,CAAC,CAAC,CA+Bd"}