dotdo 0.0.1 → 0.0.2

package/dist/lib/rpc/bindings.js

@@ -0,0 +1,548 @@
+/**
+ * RPC Binding Architecture for Capability Modules
+ *
+ * Provides type-safe RPC bindings for Cloudflare Workers service bindings,
+ * allowing heavy tools (jq, npm resolution, AI) to run as separate Workers
+ * instead of bloating the core bundle.
+ *
+ * Key Features:
+ * - Type-safe RPC calls with request/response types
+ * - Auto-detection of binding availability with fallback support
+ * - Error handling with automatic retries
+ * - Streaming response support
+ * - Cloudflare Worker service bindings pattern
+ *
+ * @module lib/rpc/bindings
+ */
+// ============================================================================
+// Default Retry Policy
+// ============================================================================
+export const DEFAULT_RETRY_POLICY = {
+    maxAttempts: 3,
+    baseDelayMs: 100,
+    maxDelayMs: 5000,
+    backoffMultiplier: 2,
+    jitterFactor: 0.1,
+    retryableErrors: [
+        'TIMEOUT',
+        'NETWORK_ERROR',
+        'SERVICE_UNAVAILABLE',
+        'RATE_LIMITED',
+        -32603, // Internal error (JSON-RPC)
+        503,
+        429,
+    ],
+};
+// ============================================================================
+// Error Classes
+// ============================================================================
+/**
+ * RPC-specific error class
+ */
+export class RPCBindingError extends Error {
+    code;
+    data;
+    retryable;
+    requestId;
+    constructor(message, code, options) {
+        super(message);
+        this.name = 'RPCBindingError';
+        this.code = code;
+        this.data = options?.data;
+        this.retryable = options?.retryable ?? false;
+        this.requestId = options?.requestId;
+    }
+    static fromRPCError(error, requestId) {
+        return new RPCBindingError(error.message, error.code, {
+            data: error.data,
+            retryable: error.retryable,
+            requestId,
+        });
+    }
+    toRPCError() {
+        return {
+            code: this.code,
+            message: this.message,
+            data: this.data,
+            retryable: this.retryable,
+        };
+    }
+}
+/**
+ * Timeout error for RPC calls
+ */
+export class RPCTimeoutError extends RPCBindingError {
+    constructor(method, timeoutMs, requestId) {
+        super(`RPC call to '${method}' timed out after ${timeoutMs}ms`, 'TIMEOUT', {
+            retryable: true,
+            requestId,
+            data: { method, timeoutMs },
+        });
+        this.name = 'RPCTimeoutError';
+    }
+}
+/**
+ * Network error for RPC calls
+ */
+export class RPCNetworkError extends RPCBindingError {
+    constructor(message, requestId) {
+        super(message, 'NETWORK_ERROR', { retryable: true, requestId });
+        this.name = 'RPCNetworkError';
+    }
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Generate a unique request ID
+ */
+export function generateRequestId() {
+    return `rpc_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+}
+/**
+ * Calculate backoff delay with jitter
+ */
+export function calculateBackoffDelay(attempt, policy) {
+    const baseDelay = Math.min(policy.baseDelayMs * Math.pow(policy.backoffMultiplier, attempt), policy.maxDelayMs);
+    const jitter = baseDelay * policy.jitterFactor * (Math.random() * 2 - 1);
+    return Math.max(0, baseDelay + jitter);
+}
+/**
+ * Check if an error is retryable
+ */
+export function isRetryableError(error, policy) {
+    if ('retryable' in error && error.retryable === true) {
+        return true;
+    }
+    const code = 'code' in error ? error.code : undefined;
+    if (code && policy.retryableErrors?.includes(code)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Sleep for a specified duration
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// ============================================================================
+// RPCBinding Class
+// ============================================================================
+/**
+ * Type-safe RPC binding for Cloudflare service bindings
+ *
+ * @typeParam TMethods - Map of method names to their definitions
+ *
+ * @example
+ * ```typescript
+ * // Define capability module
+ * interface AIMethods {
+ *   'ai.generate': MethodDefinition<{ prompt: string }, { text: string }>
+ *   'ai.embed': MethodDefinition<{ text: string }, { embedding: number[] }>
+ * }
+ *
+ * // Create binding
+ * const aiBinding = new RPCBinding<AIMethods>(env.AI_SERVICE, {
+ *   name: 'ai-service',
+ *   timeout: 30000,
+ * })
+ *
+ * // Call methods
+ * const result = await aiBinding.call('ai.generate', { prompt: 'Hello' })
+ * ```
+ */
+export class RPCBinding {
+    binding;
+    config;
+    fallback;
+    constructor(binding, config, fallback) {
+        this.binding = binding ?? null;
+        this.config = {
+            name: config.name,
+            timeout: config.timeout ?? 30000,
+            retry: config.retry ?? DEFAULT_RETRY_POLICY,
+            baseUrl: config.baseUrl ?? '/rpc',
+            debug: config.debug ?? false,
+        };
+        this.fallback = fallback;
+    }
+    /**
+     * Check if the binding is available
+     */
+    isAvailable() {
+        return this.binding !== null;
+    }
+    /**
+     * Check if fallback is available
+     */
+    hasFallback() {
+        return this.fallback !== undefined;
+    }
+    /**
+     * Call an RPC method with type safety
+     *
+     * @typeParam M - Method name from TMethods
+     * @param method - Method name to call
+     * @param params - Method parameters
+     * @param options - Call options
+     * @returns Method result
+     */
+    async call(method, params, options) {
+        const requestId = generateRequestId();
+        const timeout = options?.timeout ?? this.config.timeout;
+        // If binding not available, try fallback
+        if (!this.binding) {
+            if (this.fallback) {
+                if (this.config.debug) {
+                    console.log(`[${this.config.name}] Using fallback for ${method}`);
+                }
+                return this.fallback(method, params);
+            }
+            throw new RPCBindingError(`Service binding '${this.config.name}' not available and no fallback configured`, 'BINDING_UNAVAILABLE', { requestId });
+        }
+        const request = {
+            id: requestId,
+            method,
+            params,
+            timeout,
+            meta: options?.meta,
+        };
+        return this.executeWithRetry(request);
+    }
+    /**
+     * Call an RPC method that returns a stream
+     *
+     * @param method - Method name to call
+     * @param params - Method parameters
+     * @returns AsyncGenerator of stream chunks
+     */
+    async *stream(method, params, options) {
+        const requestId = generateRequestId();
+        const timeout = options?.timeout ?? this.config.timeout;
+        if (!this.binding) {
+            throw new RPCBindingError(`Service binding '${this.config.name}' not available for streaming`, 'BINDING_UNAVAILABLE', { requestId });
+        }
+        const request = {
+            id: requestId,
+            method,
+            params,
+            timeout,
+            meta: { ...options?.meta, streaming: true },
+        };
+        const response = await this.executeRaw(request);
+        if (!response.body) {
+            throw new RPCBindingError('Streaming response has no body', 'INVALID_RESPONSE', { requestId });
+        }
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    break;
+                }
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split('\n');
+                buffer = lines.pop() ?? '';
+                for (const line of lines) {
+                    if (!line.trim())
+                        continue;
+                    // Handle SSE format
+                    if (line.startsWith('data: ')) {
+                        const data = line.slice(6);
+                        if (data === '[DONE]') {
+                            return;
+                        }
+                        try {
+                            const chunk = JSON.parse(data);
+                            yield chunk.data;
+                            if (chunk.done) {
+                                return;
+                            }
+                        }
+                        catch {
+                            // Skip malformed chunks
+                        }
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    /**
+     * Execute request with retry logic
+     */
+    async executeWithRetry(request) {
+        const policy = this.config.retry;
+        let lastError;
+        for (let attempt = 0; attempt < policy.maxAttempts; attempt++) {
+            try {
+                return await this.execute(request);
+            }
+            catch (error) {
+                const rpcError = error instanceof RPCBindingError
+                    ? error
+                    : new RPCBindingError(String(error), 'UNKNOWN_ERROR', {
+                        requestId: request.id,
+                    });
+                lastError = rpcError;
+                if (!isRetryableError(rpcError, policy)) {
+                    throw rpcError;
+                }
+                if (attempt < policy.maxAttempts - 1) {
+                    const delay = calculateBackoffDelay(attempt, policy);
+                    if (this.config.debug) {
+                        console.log(`[${this.config.name}] Retry ${attempt + 1}/${policy.maxAttempts} ` +
+                            `for ${request.method} after ${delay}ms`);
+                    }
+                    await sleep(delay);
+                }
+            }
+        }
+        throw lastError;
+    }
+    /**
+     * Execute a single RPC request
+     */
+    async execute(request) {
+        const response = await this.executeRaw(request);
+        if (!response.ok) {
+            const errorBody = await response.text();
+            throw new RPCBindingError(`RPC call failed with status ${response.status}: ${errorBody}`, response.status, { requestId: request.id, retryable: response.status >= 500 });
+        }
+        const rpcResponse = await response.json();
+        if (rpcResponse.error) {
+            throw RPCBindingError.fromRPCError(rpcResponse.error, request.id);
+        }
+        return rpcResponse.result;
+    }
+    /**
+     * Execute raw HTTP request to the binding
+     */
+    async executeRaw(request) {
+        if (!this.binding) {
+            throw new RPCBindingError('Service binding not available', 'BINDING_UNAVAILABLE', { requestId: request.id });
+        }
+        const controller = new AbortController();
+        const timeoutId = request.timeout
+            ? setTimeout(() => controller.abort(), request.timeout)
+            : undefined;
+        try {
+            if (this.config.debug) {
+                console.log(`[${this.config.name}] Calling ${request.method}`, request.params);
+            }
+            const response = await this.binding.fetch(this.config.baseUrl, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Request-ID': request.id,
+                },
+                body: JSON.stringify(request),
+                signal: controller.signal,
+            });
+            return response;
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new RPCTimeoutError(request.method, request.timeout ?? 0, request.id);
+            }
+            throw new RPCNetworkError(String(error), request.id);
+        }
+        finally {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+        }
+    }
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+/**
+ * Create an AI capability binding
+ */
+export function createAIBinding(binding, config) {
+    return new RPCBinding(binding, {
+        name: 'ai',
+        timeout: 60000, // AI calls can be slow
+        ...config,
+    });
+}
+/**
+ * Create a KV capability binding
+ */
+export function createKVBinding(binding, config) {
+    return new RPCBinding(binding, {
+        name: 'kv',
+        timeout: 5000,
+        ...config,
+    });
+}
+/**
+ * Create an R2 capability binding
+ */
+export function createR2Binding(binding, config) {
+    return new RPCBinding(binding, {
+        name: 'r2',
+        timeout: 30000,
+        ...config,
+    });
+}
+/**
+ * Create a D1 capability binding
+ */
+export function createD1Binding(binding, config) {
+    return new RPCBinding(binding, {
+        name: 'd1',
+        timeout: 30000,
+        ...config,
+    });
+}
+/**
+ * Create a Queue capability binding
+ */
+export function createQueueBinding(binding, config) {
+    return new RPCBinding(binding, {
+        name: 'queue',
+        timeout: 10000,
+        ...config,
+    });
+}
+/**
+ * Create a Vectorize capability binding
+ */
+export function createVectorizeBinding(binding, config) {
+    return new RPCBinding(binding, {
+        name: 'vectorize',
+        timeout: 30000,
+        ...config,
+    });
+}
+/**
+ * Create a Tool capability binding (jq, npm, etc.)
+ */
+export function createToolBinding(binding, config) {
+    return new RPCBinding(binding, {
+        name: 'tools',
+        timeout: 60000, // Tools can be slow
+        ...config,
+    });
+}
+/**
+ * Create a unified binding with all capabilities
+ */
+export function createUnifiedBinding(binding, config) {
+    return new RPCBinding(binding, {
+        name: 'unified',
+        timeout: 30000,
+        ...config,
+    });
+}
+// ============================================================================
+// Binding Registry
+// ============================================================================
+/**
+ * Registry for managing multiple capability bindings
+ */
+export class BindingRegistry {
+    bindings = new Map();
+    fallbacks = new Map();
+    /**
+     * Register a binding
+     */
+    register(name, binding) {
+        this.bindings.set(name, binding);
+    }
+    /**
+     * Register a fallback for a capability
+     */
+    registerFallback(name, fallback) {
+        this.fallbacks.set(name, fallback);
+    }
+    /**
+     * Get a binding by name
+     */
+    get(name) {
+        return this.bindings.get(name);
+    }
+    /**
+     * Check if a binding is available
+     */
+    has(name) {
+        const binding = this.bindings.get(name);
+        return binding?.isAvailable() ?? false;
+    }
+    /**
+     * List all registered binding names
+     */
+    list() {
+        return Array.from(this.bindings.keys());
+    }
+    /**
+     * List available bindings (with actual service binding)
+     */
+    listAvailable() {
+        return Array.from(this.bindings.entries())
+            .filter(([_, binding]) => binding.isAvailable())
+            .map(([name]) => name);
+    }
+    /**
+     * Call a method on any capability, auto-detecting binding
+     */
+    async call(method, params, options) {
+        // Extract capability prefix from method name
+        const [prefix] = method.split('.');
+        const binding = this.bindings.get(prefix);
+        if (binding?.isAvailable()) {
+            return binding.call(method, params, options);
+        }
+        // Try fallback
+        const fallback = this.fallbacks.get(prefix);
+        if (fallback) {
+            return fallback(method, params);
+        }
+        throw new RPCBindingError(`No binding or fallback available for capability '${prefix}'`, 'CAPABILITY_UNAVAILABLE');
+    }
+}
+/**
+ * Create a capability proxy that auto-detects binding availability
+ * and falls back to inline implementation when binding is unavailable.
+ *
+ * This implements the $ proxy pattern from the issue description.
+ *
+ * @example
+ * ```typescript
+ * const ai = createCapabilityProxy<AICapabilityMethods>({
+ *   binding: env.AI_SERVICE,
+ *   fallback: {
+ *     'ai.generate': async (params) => {
+ *       // Inline implementation using Workers AI
+ *       return await localAI.run(params)
+ *     }
+ *   }
+ * })
+ *
+ * // Auto-detects: uses binding if available, fallback otherwise
+ * const result = await ai.call('ai.generate', { prompt: 'Hello' })
+ * ```
+ */
+export function createCapabilityProxy(options) {
+    const fallbackFn = options.fallback
+        ? async (method, params) => {
+            const handler = options.fallback?.[method];
+            if (handler) {
+                return handler(params);
+            }
+            throw new RPCBindingError(`No fallback implementation for method '${method}'`, 'NO_FALLBACK');
+        }
+        : undefined;
+    return new RPCBinding(options.binding ?? null, {
+        name: 'capability-proxy',
+        ...options.config,
+    }, fallbackFn);
+}
+//# sourceMappingURL=bindings.js.map

package/dist/lib/rpc/bindings.js.map

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

package/dist/lib/rpc/index.js

@@ -0,0 +1,64 @@
+/**
+ * RPC Binding Architecture for Capability Modules
+ *
+ * This module provides type-safe RPC bindings for Cloudflare Workers service bindings,
+ * enabling capability modules (AI, KV, R2, D1, etc.) to run as separate Workers.
+ *
+ * @module lib/rpc
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   RPCBinding,
+ *   createAIBinding,
+ *   createCapabilityProxy,
+ *   BindingRegistry,
+ * } from 'lib/rpc'
+ *
+ * // Create typed binding for AI service
+ * const ai = createAIBinding(env.AI_SERVICE)
+ *
+ * // Call methods with type safety
+ * const result = await ai.call('ai.generate', {
+ *   prompt: 'Hello',
+ *   temperature: 0.7,
+ * })
+ *
+ * // Or use proxy pattern with auto-fallback
+ * const proxy = createCapabilityProxy({
+ *   binding: env.AI_SERVICE,
+ *   fallback: {
+ *     'ai.generate': async (params) => inlineImplementation(params)
+ *   }
+ * })
+ * ```
+ */
+// ============================================================================
+// Core Classes
+// ============================================================================
+export { 
+// Main binding class
+RPCBinding, 
+// Error classes
+RPCBindingError, RPCTimeoutError, RPCNetworkError, 
+// Registry for managing multiple bindings
+BindingRegistry, } from './bindings';
+// ============================================================================
+// Factory Functions
+// ============================================================================
+export { 
+// Capability-specific factories
+createAIBinding, createKVBinding, createR2Binding, createD1Binding, createQueueBinding, createVectorizeBinding, createToolBinding, createUnifiedBinding, 
+// Proxy pattern for auto-detection
+createCapabilityProxy, } from './bindings';
+// ============================================================================
+// Utility Functions
+// ============================================================================
+export { 
+// ID generation
+generateRequestId, 
+// Retry utilities
+calculateBackoffDelay, isRetryableError, 
+// Default configuration
+DEFAULT_RETRY_POLICY, } from './bindings';
+//# sourceMappingURL=index.js.map

package/dist/lib/rpc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/rpc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAoDH,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,OAAO;AACL,qBAAqB;AACrB,UAAU;AAEV,gBAAgB;AAChB,eAAe,EACf,eAAe,EACf,eAAe;AAEf,0CAA0C;AAC1C,eAAe,GAChB,MAAM,YAAY,CAAA;AAEnB,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,OAAO;AACL,gCAAgC;AAChC,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB;AAEpB,mCAAmC;AACnC,qBAAqB,GACtB,MAAM,YAAY,CAAA;AAEnB,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,OAAO;AACL,gBAAgB;AAChB,iBAAiB;AAEjB,kBAAkB;AAClB,qBAAqB,EACrB,gBAAgB;AAEhB,wBAAwB;AACxB,oBAAoB,GACrB,MAAM,YAAY,CAAA"}