dotdo 0.0.1 → 0.1.0

package/dist/objects/transport/chain.js

@@ -0,0 +1,441 @@
+/**
+ * Handler Chain for Transport Layer
+ *
+ * Provides a composable chain of transport handlers that process requests
+ * in priority order. The chain supports:
+ * - Handler registration with priorities
+ * - Middleware wrapping (e.g., auth before handlers)
+ * - Fallback handling for unmatched requests
+ * - Performance optimization through caching
+ */
+import { buildErrorResponse, createRequestTimer, logRequest } from './shared';
+// ============================================================================
+// HANDLER CHAIN
+// ============================================================================
+/**
+ * Handler Chain - Manages and routes requests to appropriate transport handlers
+ *
+ * The chain selects handlers based on their `canHandle` method and priority.
+ * Higher priority handlers are checked first. The first handler that can handle
+ * the request processes it.
+ *
+ * @example
+ * ```typescript
+ * const chain = new HandlerChain({ debug: true })
+ *
+ * // Add handlers (higher priority = checked first)
+ * chain.use(new AuthHandler(), 100)  // Auth middleware
+ * chain.use(new McpHandler(), 50)    // MCP JSON-RPC
+ * chain.use(new RpcHandler(), 40)    // Cap'n Web RPC
+ * chain.use(new RestHandler(), 30)   // REST API
+ *
+ * // Handle request
+ * const response = await chain.handle(request, context)
+ * ```
+ */
+export class HandlerChain {
+    handlers = [];
+    config;
+    selectionCache = new Map();
+    methodCache = new Map();
+    constructor(config = {}) {
+        this.config = {
+            cacheHandlerSelection: true,
+            ...config,
+        };
+    }
+    /**
+     * Add a handler to the chain
+     *
+     * @param handler - The transport handler
+     * @param priority - Higher priority handlers are checked first (default: 0)
+     * @returns This chain for chaining calls
+     *
+     * @example
+     * ```typescript
+     * chain
+     *   .use(authHandler, 100)
+     *   .use(restHandler, 50)
+     *   .use(rpcHandler, 40)
+     * ```
+     */
+    use(handler, priority = 0) {
+        this.handlers.push({
+            handler,
+            priority,
+            enabled: true,
+        });
+        // Sort by priority (descending)
+        this.handlers.sort((a, b) => b.priority - a.priority);
+        // Clear selection cache when handlers change
+        this.selectionCache.clear();
+        this.log('debug', `Handler '${handler.name}' added with priority ${priority}`);
+        return this;
+    }
+    /**
+     * Remove a handler from the chain
+     *
+     * @param handler - The handler to remove (or handler name)
+     * @returns Whether the handler was found and removed
+     */
+    remove(handler) {
+        const name = typeof handler === 'string' ? handler : handler.name;
+        const index = this.handlers.findIndex((e) => e.handler.name === name);
+        if (index >= 0) {
+            const removed = this.handlers.splice(index, 1)[0];
+            removed.handler.dispose?.();
+            this.selectionCache.clear();
+            this.log('debug', `Handler '${name}' removed`);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Enable or disable a handler
+     *
+     * @param handler - The handler to toggle (or handler name)
+     * @param enabled - Whether to enable or disable
+     */
+    setEnabled(handler, enabled) {
+        const name = typeof handler === 'string' ? handler : handler.name;
+        const entry = this.handlers.find((e) => e.handler.name === name);
+        if (entry) {
+            entry.enabled = enabled;
+            this.selectionCache.clear();
+            this.log('debug', `Handler '${name}' ${enabled ? 'enabled' : 'disabled'}`);
+        }
+    }
+    /**
+     * Get all registered handlers
+     */
+    getHandlers() {
+        return this.handlers.map((e) => ({
+            name: e.handler.name,
+            priority: e.priority,
+            enabled: e.enabled,
+        }));
+    }
+    /**
+     * Handle a request by routing to the appropriate handler
+     *
+     * @param request - The incoming HTTP request
+     * @param context - Handler context with environment, state, and methods
+     * @returns HTTP response from the matching handler
+     */
+    async handle(request, context) {
+        const timer = createRequestTimer();
+        try {
+            // Try to find a handler from cache first
+            const cacheKey = this.getCacheKey(request);
+            let selectedHandler = null;
+            if (this.config.cacheHandlerSelection && this.selectionCache.has(cacheKey)) {
+                selectedHandler = this.selectionCache.get(cacheKey) || null;
+                // Verify the cached handler can still handle this request
+                if (selectedHandler) {
+                    const result = selectedHandler.canHandle(request);
+                    if (!result.canHandle) {
+                        selectedHandler = null;
+                        this.selectionCache.delete(cacheKey);
+                    }
+                }
+            }
+            // Find handler if not cached
+            if (!selectedHandler) {
+                selectedHandler = this.selectHandler(request);
+                if (this.config.cacheHandlerSelection) {
+                    this.selectionCache.set(cacheKey, selectedHandler);
+                }
+            }
+            // No handler found
+            if (!selectedHandler) {
+                if (this.config.fallbackHandler) {
+                    return this.config.fallbackHandler(request, context);
+                }
+                const response = buildErrorResponse({ message: 'No handler available', code: 'NO_HANDLER' }, 404, { debug: this.config.debug });
+                this.logRequestComplete(request, response.status, timer.stop());
+                return response;
+            }
+            // Execute the handler
+            this.log('debug', `Routing to handler '${selectedHandler.name}'`);
+            const response = await selectedHandler.handle(request, context);
+            this.logRequestComplete(request, response.status, timer.stop(), selectedHandler.name);
+            return response;
+        }
+        catch (error) {
+            const durationMs = timer.stop();
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.log('error', `Handler chain error: ${errorMessage}`, { error });
+            const response = buildErrorResponse(error instanceof Error ? error : { message: errorMessage, code: 'HANDLER_ERROR' }, 500, { debug: this.config.debug });
+            this.logRequestComplete(request, response.status, durationMs, undefined, errorMessage);
+            return response;
+        }
+    }
+    /**
+     * Select the best handler for a request
+     */
+    selectHandler(request) {
+        let bestHandler = null;
+        let bestPriority = -Infinity;
+        for (const entry of this.handlers) {
+            if (!entry.enabled)
+                continue;
+            const result = entry.handler.canHandle(request);
+            if (result.canHandle) {
+                // Use result priority if provided, otherwise use entry priority
+                const effectivePriority = result.priority ?? entry.priority;
+                if (effectivePriority > bestPriority) {
+                    bestHandler = entry.handler;
+                    bestPriority = effectivePriority;
+                }
+            }
+        }
+        return bestHandler;
+    }
+    /**
+     * Generate cache key for handler selection
+     */
+    getCacheKey(request) {
+        const url = new URL(request.url);
+        // Use method + path prefix for caching
+        // This allows similar paths to share cached selections
+        const pathPrefix = url.pathname.split('/').slice(0, 3).join('/');
+        const contentType = request.headers.get('Content-Type')?.split(';')[0] || '';
+        return `${request.method}:${pathPrefix}:${contentType}`;
+    }
+    /**
+     * Log request completion
+     */
+    logRequestComplete(request, status, durationMs, handlerName, error) {
+        if (this.config.logger) {
+            logRequest(request, { status, durationMs, error }, this.config.logger);
+        }
+    }
+    /**
+     * Log a message
+     */
+    log(level, message, data) {
+        if (this.config.logger) {
+            this.config.logger[level](message, data);
+        }
+    }
+    /**
+     * Clear all caches
+     */
+    clearCaches() {
+        this.selectionCache.clear();
+        this.methodCache.clear();
+        this.log('debug', 'Caches cleared');
+    }
+    /**
+     * Dispose all handlers
+     */
+    dispose() {
+        for (const entry of this.handlers) {
+            entry.handler.dispose?.();
+        }
+        this.handlers = [];
+        this.clearCaches();
+    }
+}
+// ============================================================================
+// MIDDLEWARE CHAIN SUPPORT
+// ============================================================================
+/**
+ * Create a middleware wrapper that applies before a handler
+ *
+ * @param middleware - The middleware handler
+ * @param wrapped - The handler to wrap
+ * @returns A new handler that applies middleware before wrapped handler
+ *
+ * @example
+ * ```typescript
+ * const protectedRest = wrapWithMiddleware(authHandler, restHandler)
+ * chain.use(protectedRest, 50)
+ * ```
+ */
+export function wrapWithMiddleware(middleware, wrapped) {
+    return {
+        name: `${middleware.name}>${wrapped.name}`,
+        canHandle(request) {
+            // Middleware must be able to handle, and wrapped must be able to handle
+            const middlewareResult = middleware.canHandle(request);
+            if (!middlewareResult.canHandle) {
+                return middlewareResult;
+            }
+            const wrappedResult = wrapped.canHandle(request);
+            return {
+                canHandle: wrappedResult.canHandle,
+                priority: Math.max(middlewareResult.priority ?? 0, wrappedResult.priority ?? 0),
+            };
+        },
+        async handle(request, context) {
+            // First call middleware
+            const middlewareResponse = await middleware.handle(request, context);
+            // If middleware returned an error response, return it
+            if (middlewareResponse.status >= 400) {
+                return middlewareResponse;
+            }
+            // Middleware succeeded, call wrapped handler
+            return wrapped.handle(request, context);
+        },
+        dispose() {
+            middleware.dispose?.();
+            wrapped.dispose?.();
+        },
+    };
+}
+// ============================================================================
+// HANDLER CHAIN BUILDER
+// ============================================================================
+/**
+ * Builder pattern for creating handler chains
+ *
+ * @example
+ * ```typescript
+ * const chain = HandlerChainBuilder.create()
+ *   .withDebug(true)
+ *   .withLogger(console)
+ *   .withAuth(authHandler)
+ *   .use(restHandler, 50)
+ *   .use(rpcHandler, 40)
+ *   .build()
+ * ```
+ */
+export class HandlerChainBuilder {
+    config = {};
+    handlers = [];
+    authHandler;
+    static create() {
+        return new HandlerChainBuilder();
+    }
+    /**
+     * Enable debug mode
+     */
+    withDebug(enabled) {
+        this.config.debug = enabled;
+        return this;
+    }
+    /**
+     * Set logger
+     */
+    withLogger(logger) {
+        this.config.logger = logger;
+        return this;
+    }
+    /**
+     * Set fallback handler
+     */
+    withFallback(handler) {
+        this.config.fallbackHandler = handler;
+        return this;
+    }
+    /**
+     * Enable/disable handler selection caching
+     */
+    withCaching(enabled) {
+        this.config.cacheHandlerSelection = enabled;
+        return this;
+    }
+    /**
+     * Set default timeout
+     */
+    withTimeout(ms) {
+        this.config.defaultTimeout = ms;
+        return this;
+    }
+    /**
+     * Set auth handler (will wrap all other handlers)
+     */
+    withAuth(handler) {
+        this.authHandler = handler;
+        return this;
+    }
+    /**
+     * Add a handler
+     */
+    use(handler, priority = 0) {
+        this.handlers.push({ handler, priority });
+        return this;
+    }
+    /**
+     * Build the handler chain
+     */
+    build() {
+        const chain = new HandlerChain(this.config);
+        for (const { handler, priority } of this.handlers) {
+            // Wrap with auth if auth handler is set
+            const finalHandler = this.authHandler
+                ? wrapWithMiddleware(this.authHandler, handler)
+                : handler;
+            chain.use(finalHandler, priority);
+        }
+        // Add auth handler itself at highest priority for auth-specific routes
+        if (this.authHandler) {
+            chain.use(this.authHandler, 1000);
+        }
+        return chain;
+    }
+}
+// ============================================================================
+// CONTEXT FACTORY
+// ============================================================================
+/**
+ * Create a handler context from DO components
+ *
+ * @param options - Context creation options
+ * @returns Handler context
+ */
+export function createHandlerContext(options) {
+    return {
+        env: options.env,
+        ctx: options.ctx,
+        state: options.state,
+        instance: options.instance,
+        methods: options.methods ?? new Map(),
+    };
+}
+/**
+ * Discover methods from a DO instance for the handler context
+ *
+ * @param instance - The DO instance
+ * @param options - Discovery options
+ * @returns Map of method names to method info
+ */
+export function discoverMethods(instance, options = {}) {
+    const methods = new Map();
+    const { blockedMethods = new Set(), includePrivate = false } = options;
+    // Default blocked methods
+    const defaultBlocked = new Set([
+        'constructor',
+        'fetch',
+        'alarm',
+        'webSocketMessage',
+        'webSocketClose',
+        'webSocketError',
+    ]);
+    const visited = new Set();
+    let obj = instance;
+    while (obj && obj !== Object.prototype) {
+        for (const key of Object.getOwnPropertyNames(obj)) {
+            if (visited.has(key))
+                continue;
+            visited.add(key);
+            // Skip blocked
+            if (blockedMethods.has(key) || defaultBlocked.has(key))
+                continue;
+            // Skip private unless explicitly included
+            if (!includePrivate && key.startsWith('_'))
+                continue;
+            // Check if it's a function
+            const value = instance[key];
+            if (typeof value === 'function') {
+                methods.set(key, {
+                    name: key,
+                });
+            }
+        }
+        obj = Object.getPrototypeOf(obj);
+    }
+    return methods;
+}
+//# sourceMappingURL=chain.js.map

package/dist/objects/transport/chain.js.map

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

package/dist/objects/transport/handler.js

@@ -0,0 +1,58 @@
+/**
+ * Unified Transport Handler Interface
+ *
+ * Defines a common interface for all transport handlers (REST, MCP, RPC),
+ * enabling consistent request handling and handler composition.
+ */
+// ============================================================================
+// TYPE GUARDS
+// ============================================================================
+/**
+ * Check if a handler supports wrapping
+ */
+export function isWrappable(handler) {
+    return 'wrap' in handler && typeof handler.wrap === 'function';
+}
+/**
+ * Check if a handler is middleware
+ */
+export function isMiddleware(handler) {
+    return 'wrapped' in handler && 'setWrapped' in handler;
+}
+// ============================================================================
+// ABSTRACT BASE CLASS
+// ============================================================================
+/**
+ * Abstract base class for transport handlers with common functionality
+ */
+export class BaseHandler {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    /**
+     * Log a message if logger is configured
+     */
+    log(level, message, ...args) {
+        if (this.options.logger) {
+            this.options.logger[level](message, ...args);
+        }
+    }
+    /**
+     * Execute a method with optional timeout
+     */
+    async executeWithTimeout(fn, timeoutMs) {
+        const timeout = timeoutMs ?? this.options.timeout;
+        if (!timeout) {
+            return fn();
+        }
+        return Promise.race([
+            fn(),
+            new Promise((_, reject) => setTimeout(() => reject(new Error('Method execution timeout')), timeout)),
+        ]);
+    }
+    dispose() {
+        // Override in subclasses if cleanup is needed
+    }
+}
+//# sourceMappingURL=handler.js.map

package/dist/objects/transport/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../objects/transport/handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuQH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAyB;IACnD,OAAO,MAAM,IAAI,OAAO,IAAI,OAAQ,OAA4B,CAAC,IAAI,KAAK,UAAU,CAAA;AACtF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAyB;IACpD,OAAO,SAAS,IAAI,OAAO,IAAI,YAAY,IAAI,OAAO,CAAA;AACxD,CAAC;AAED,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,OAAgB,WAAW;IAGT;IAAtB,YAAsB,UAA0B,EAAE;QAA5B,YAAO,GAAP,OAAO,CAAqB;IAAG,CAAC;IAKtD;;OAEG;IACO,GAAG,CAAC,KAAmB,EAAE,OAAe,EAAE,GAAG,IAAe;QACpE,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;QAC9C,CAAC;IACH,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,kBAAkB,CAChC,EAAoB,EACpB,SAAkB;QAElB,MAAM,OAAO,GAAG,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAA;QAEjD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,EAAE,CAAA;QACb,CAAC;QAED,OAAO,OAAO,CAAC,IAAI,CAAC;YAClB,EAAE,EAAE;YACJ,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC3B,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,EAAE,OAAO,CAAC,CACzE;SACF,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,8CAA8C;IAChD,CAAC;CACF"}

package/dist/objects/transport/index.js

@@ -0,0 +1,53 @@
+/**
+ * Transport Layer Module
+ *
+ * Unified transport handlers for Durable Objects with:
+ * - REST API (rest-autowire)
+ * - MCP JSON-RPC (mcp-server)
+ * - Cap'n Web RPC (rpc-server)
+ * - Authentication/Authorization (auth-layer)
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   HandlerChain,
+ *   RestHandler,
+ *   McpHandler,
+ *   RpcHandler,
+ *   AuthHandler,
+ * } from './transport'
+ *
+ * // Create handler chain
+ * const chain = new HandlerChain({ debug: true })
+ *   .use(new AuthHandler({ jwtSecret: 'secret' }), 100)
+ *   .use(new McpHandler(), 50)
+ *   .use(new RpcHandler(), 40)
+ *   .use(new RestHandler(), 30)
+ *
+ * // In DO fetch handler
+ * async fetch(request: Request): Promise<Response> {
+ *   return chain.handle(request, createHandlerContext({
+ *     env: this.env,
+ *     ctx: this.ctx,
+ *     state: this.state,
+ *     instance: this,
+ *   }))
+ * }
+ * ```
+ */
+export { BaseHandler, isWrappable, isMiddleware } from './handler';
+// Shared utilities
+export { parseJsonBody, parseJsonBodyOrThrow, buildJsonResponse, buildStreamingResponse, buildErrorResponse, mapErrorToStatus, logRequest, createRequestTimer, validateSchema, getCachedSchema, clearSchemaCache, extractPathParams, parseQueryParams, parseAcceptHeader, getBestContentType, } from './shared';
+// Handler chain
+export { HandlerChain, HandlerChainBuilder, wrapWithMiddleware, createHandlerContext, discoverMethods, } from './chain';
+// REST handler
+export { RestHandler, createRestRouter, getRestRoutes } from './rest-autowire';
+// MCP handler
+export { McpHandler, createMcpHandler, getMcpTools, hasMcpConfig } from './mcp-server';
+// RPC handler
+export { RpcHandler, RPCServer, withRpcServer, applyRpcIntegration } from './rpc-server';
+// Auth handler
+export { AuthHandler, createAuthMiddleware, withAuth, validateToken, checkPermission, checkRole, createRateLimiter, validateRequestSignature, createInMemorySessionStorage, } from './auth-layer';
+// Sync engine
+export { SyncEngine } from './sync-engine';
+//# sourceMappingURL=index.js.map

package/dist/objects/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../objects/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAoBH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAElE,mBAAmB;AACnB,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,UAAU,CAAA;AAYjB,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,GAChB,MAAM,SAAS,CAAA;AAIhB,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAG9E,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAGtF,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAGxF,eAAe;AACf,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,QAAQ,EACR,aAAa,EACb,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,cAAc,CAAA;AAerB,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA"}