dotdo 0.0.1 → 0.0.2

package/dist/lib/DOAuth.js

@@ -0,0 +1,261 @@
+/**
+ * DOAuth - Authentication capability for Durable Objects
+ *
+ * Provides Hono-based auth routes that can be mounted on any DO:
+ * - /api/auth/* - Authentication routes (sign-in, sign-out, callbacks)
+ * - Federation to parent DO by default
+ * - OAuth provider and proxy plugins
+ *
+ * @example
+ * ```typescript
+ * class MyDO extends DO {
+ *   private auth: DOAuth
+ *
+ *   constructor(ctx: DurableObjectState, env: Env) {
+ *     super(ctx, env)
+ *     this.auth = new DOAuth(this, { federate: true })
+ *   }
+ *
+ *   async fetch(request: Request): Promise<Response> {
+ *     // Try auth routes first
+ *     const authResponse = await this.auth.handle(request)
+ *     if (authResponse) return authResponse
+ *
+ *     // Handle other routes
+ *     return super.fetch(request)
+ *   }
+ * }
+ * ```
+ */
+import { Hono } from 'hono';
+import { auth as authFederation } from '../api/middleware/auth-federation';
+import { authMiddleware, requireAuth, requireRole } from '../api/middleware/auth';
+// ============================================================================
+// DOAuth Class
+// ============================================================================
+/**
+ * DOAuth provides authentication capabilities for Durable Objects.
+ *
+ * Features:
+ * - Hono-based routing for /api/auth/* endpoints
+ * - Federation to parent DO (id.org.ai by default)
+ * - OAuth provider plugin (make your DO an OAuth provider)
+ * - OAuth proxy for cross-domain authentication
+ * - Organization management
+ * - Session management with KV caching
+ */
+export class DOAuth {
+    /** The Hono app handling auth routes */
+    app;
+    /** Reference to the parent DO */
+    do;
+    /** Configuration */
+    config;
+    /** Current auth context (set during request handling) */
+    currentAuth = null;
+    constructor(doInstance, config = {}) {
+        this.do = doInstance;
+        // Merge with defaults
+        this.config = {
+            federate: config.federate ?? true,
+            federateTo: config.federateTo ?? 'https://id.org.ai',
+            providers: config.providers ?? {},
+            oauthProvider: config.oauthProvider ?? { enabled: false },
+            oauthProxy: config.oauthProxy ?? { enabled: true },
+            organization: config.organization ?? { enabled: true, allowUserToCreateOrganization: true },
+            jwtSecret: config.jwtSecret ?? '',
+            jwksUrl: config.jwksUrl ?? '',
+            cookieName: config.cookieName ?? 'session',
+            publicPaths: config.publicPaths ?? ['/health', '/public'],
+            validateSession: config.validateSession ?? null,
+            sessionCache: config.sessionCache ?? undefined,
+        };
+        // Create the Hono app
+        this.app = this.createApp();
+    }
+    /**
+     * Create the Hono app with auth routes
+     */
+    createApp() {
+        const app = new Hono();
+        // Mount the auth federation middleware
+        app.use('/api/auth/*', authFederation({
+            federate: this.config.federate,
+            federateTo: this.config.federateTo,
+            providers: this.config.providers,
+            oauthProvider: this.config.oauthProvider,
+            oauthProxy: this.config.oauthProxy,
+            organization: this.config.organization,
+        }));
+        // Add session endpoint
+        app.get('/api/auth/session', async (c) => {
+            const session = c.get('session');
+            const user = c.get('user');
+            if (!session || !user) {
+                return c.json({ authenticated: false }, 200);
+            }
+            return c.json({
+                authenticated: true,
+                user: {
+                    id: user.id,
+                    email: user.email,
+                    role: user.role || 'user',
+                },
+                session: {
+                    activeOrganizationId: session.activeOrganizationId,
+                },
+            });
+        });
+        // Add me endpoint (requires auth)
+        app.get('/api/auth/me', (c) => {
+            const user = c.get('user');
+            if (!user) {
+                return c.json({ error: 'Unauthorized' }, 401);
+            }
+            return c.json({
+                id: user.id,
+                email: user.email,
+                role: user.role || 'user',
+            });
+        });
+        return app;
+    }
+    /**
+     * Handle an incoming request.
+     * Returns a Response if the request was handled by auth routes,
+     * or null if the request should be passed to other handlers.
+     */
+    async handle(request) {
+        const url = new URL(request.url);
+        // Only handle /api/auth/* routes
+        if (!url.pathname.startsWith('/api/auth')) {
+            return null;
+        }
+        // Process through Hono app
+        const response = await this.app.fetch(request);
+        // Check if we got a 404 (route not found in auth app)
+        if (response.status === 404) {
+            return null;
+        }
+        return response;
+    }
+    /**
+     * Create a middleware that authenticates requests.
+     * Can be used with Hono or as a standalone middleware.
+     */
+    createMiddleware() {
+        const config = this.config;
+        const self = this;
+        return authMiddleware({
+            jwtSecret: config.jwtSecret,
+            jwksUrl: config.jwksUrl,
+            publicPaths: config.publicPaths,
+            cookieName: config.cookieName,
+            validateSession: config.validateSession,
+            sessionCache: config.sessionCache,
+        });
+    }
+    /**
+     * Create a middleware that requires authentication.
+     * Returns 401 if not authenticated.
+     */
+    requireAuth() {
+        return requireAuth();
+    }
+    /**
+     * Create a middleware that requires a specific role.
+     * Returns 403 if role doesn't match.
+     */
+    requireRole(role) {
+        return requireRole(role);
+    }
+    /**
+     * Get the current auth context from a Hono context.
+     */
+    getAuth(c) {
+        return c.get('auth');
+    }
+    /**
+     * Get the current user from a Hono context.
+     */
+    getUser(c) {
+        return c.get('user');
+    }
+    /**
+     * Get the current session from a Hono context.
+     */
+    getSession(c) {
+        return c.get('session');
+    }
+    /**
+     * Check if the current request is authenticated.
+     */
+    isAuthenticated(c) {
+        return !!this.getAuth(c);
+    }
+    /**
+     * Check if the current user has a specific role.
+     */
+    hasRole(c, role) {
+        const auth = this.getAuth(c);
+        if (!auth)
+            return false;
+        if (auth.role === 'admin')
+            return true; // Admin has all roles
+        return auth.role === role;
+    }
+    /**
+     * Check if the current user has a specific permission.
+     */
+    hasPermission(c, permission) {
+        const auth = this.getAuth(c);
+        if (!auth)
+            return false;
+        if (auth.role === 'admin')
+            return true; // Admin has all permissions
+        return auth.permissions?.includes(permission) ?? false;
+    }
+    /**
+     * Get the Hono app for direct mounting.
+     * Useful when you want to compose with other Hono apps.
+     */
+    getApp() {
+        return this.app;
+    }
+    /**
+     * Update configuration at runtime.
+     */
+    updateConfig(config) {
+        Object.assign(this.config, config);
+        // Recreate the app with new config
+        this.app = this.createApp();
+    }
+    /**
+     * Get current configuration.
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create a DOAuth instance for a Durable Object.
+ *
+ * @example
+ * ```typescript
+ * const auth = createDOAuth(this, {
+ *   federate: true,
+ *   federateTo: 'https://id.org.ai',
+ * })
+ * ```
+ */
+export function createDOAuth(doInstance, config) {
+    return new DOAuth(doInstance, config);
+}
+// ============================================================================
+// Exports
+// ============================================================================
+export default DOAuth;
+//# sourceMappingURL=DOAuth.js.map

package/dist/lib/DOAuth.js.map

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

package/dist/lib/DODispatcher.js

@@ -0,0 +1,72 @@
+/**
+ * DODispatcher - Route requests to the appropriate Durable Object
+ *
+ * Provides type-based routing from requests to DO instances.
+ */
+/**
+ * DODispatcher - Routes requests to appropriate DOs based on type
+ */
+export class DODispatcher {
+    registry;
+    env;
+    constructor(registry, env) {
+        this.registry = registry;
+        this.env = env;
+    }
+    /**
+     * Resolve a request to DO class and ID
+     */
+    async resolve(request) {
+        const url = new URL(request.url);
+        const namespace = `${url.protocol}//${url.host}`;
+        // Check for X-DO-Type header first
+        const headerType = request.headers.get('X-DO-Type');
+        if (headerType) {
+            if (!this.registry.has(headerType)) {
+                throw new Error(`Unknown type: ${headerType}`);
+            }
+            // Extract ID from path (first segment after /)
+            const pathParts = url.pathname.slice(1).split('/');
+            const doId = pathParts[0] || '';
+            return {
+                namespace,
+                doClass: headerType,
+                doId,
+            };
+        }
+        // Parse path: /{Type}/{id}
+        const pathParts = url.pathname.slice(1).split('/');
+        if (pathParts.length < 2) {
+            throw new Error('Invalid path format: expected /{Type}/{id}');
+        }
+        const [doClass, doId] = pathParts;
+        // Validate the type is registered
+        if (!this.registry.has(doClass)) {
+            throw new Error(`Unknown type: ${doClass}`);
+        }
+        return {
+            namespace,
+            doClass,
+            doId,
+        };
+    }
+    /**
+     * Get a DO stub for the request
+     */
+    async getStub(request) {
+        const { doClass, doId, namespace } = await this.resolve(request);
+        // Get the DO binding
+        const metadata = this.registry.getMetadata(doClass);
+        const binding = this.env[metadata.binding];
+        if (!binding) {
+            throw new Error(`DO namespace binding not configured: ${metadata.binding}`);
+        }
+        // Create the DO ID from the lookup key
+        const lookupKey = `${namespace}/${doClass}/${doId}`;
+        const id = binding.idFromName(lookupKey);
+        return binding.get(id);
+    }
+}
+// Re-export TypeRegistry for convenience
+export { TypeRegistry } from './TypeRegistry';
+//# sourceMappingURL=DODispatcher.js.map

package/dist/lib/DODispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DODispatcher.js","sourceRoot":"","sources":["../../lib/DODispatcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqBH;;GAEG;AACH,MAAM,OAAO,YAAY;IAEb;IACA;IAFV,YACU,QAAsB,EACtB,GAAQ;QADR,aAAQ,GAAR,QAAQ,CAAc;QACtB,QAAG,GAAH,GAAG,CAAK;IACf,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,OAAgB;QAC5B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAChC,MAAM,SAAS,GAAG,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,IAAI,EAAE,CAAA;QAEhD,mCAAmC;QACnC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QACnD,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CAAC,iBAAiB,UAAU,EAAE,CAAC,CAAA;YAChD,CAAC;YAED,+CAA+C;YAC/C,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAClD,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;YAE/B,OAAO;gBACL,SAAS;gBACT,OAAO,EAAE,UAAU;gBACnB,IAAI;aACL,CAAA;QACH,CAAC;QAED,2BAA2B;QAC3B,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAClD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;QAC/D,CAAC;QAED,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,SAAS,CAAA;QAEjC,kCAAkC;QAClC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,iBAAiB,OAAO,EAAE,CAAC,CAAA;QAC7C,CAAC;QAED,OAAO;YACL,SAAS;YACT,OAAO;YACP,IAAI;SACL,CAAA;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,OAAgB;QAC5B,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAEhE,qBAAqB;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAuC,CAAA;QAEhF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,wCAAwC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;QAC7E,CAAC;QAED,uCAAuC;QACvC,MAAM,SAAS,GAAG,GAAG,SAAS,IAAI,OAAO,IAAI,IAAI,EAAE,CAAA;QACnD,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;QAExC,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,CAAW,CAAA;IAClC,CAAC;CACF;AAED,yCAAyC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/lib/Modifier.js

@@ -0,0 +1,189 @@
+/**
+ * Modifier API - Transform inputs/outputs of workflow steps
+ *
+ * Provides a chainable API for creating modifiers that can:
+ * - Transform input before step execution
+ * - Transform output after step execution
+ * - Apply conditional transformations
+ * - Compose multiple modifiers together
+ *
+ * Usage:
+ * ```typescript
+ * const addTimestamp = modifier()
+ *   .output((result) => ({ ...result, timestamp: Date.now() }))
+ *
+ * const validateInput = modifier()
+ *   .input((input) => {
+ *     if (!input.orderId) throw new Error('Missing orderId')
+ *     return input
+ *   })
+ *
+ * // Apply to step
+ * workflow.step('process', handler, { modifiers: [validateInput, addTimestamp] })
+ * ```
+ */
+/**
+ * Creates a modifier instance
+ */
+function createModifierInstance(state) {
+    const modifier = {
+        get name() {
+            return state.name;
+        },
+        get description() {
+            return state.description;
+        },
+        input(fn) {
+            return createModifierInstance({
+                ...state,
+                inputTransformers: [...state.inputTransformers, fn],
+            });
+        },
+        output(fn) {
+            return createModifierInstance({
+                ...state,
+                outputTransformers: [...state.outputTransformers, fn],
+            });
+        },
+        when(condition) {
+            return createModifierInstance({
+                ...state,
+                condition,
+            });
+        },
+        compose(...modifiers) {
+            // Collect all transformers from composed modifiers
+            const composedInputTransformers = [...state.inputTransformers];
+            const composedOutputTransformers = [...state.outputTransformers];
+            for (const mod of modifiers) {
+                // Access internal state through applyInput/applyOutput
+                // We'll extract transformers by wrapping the entire modifier
+                composedInputTransformers.push(async (input, ctx) => mod.applyInput(input, ctx));
+                composedOutputTransformers.push(async (result, input, ctx) => mod.applyOutput(result, input, ctx));
+            }
+            return createModifierInstance({
+                ...state,
+                inputTransformers: composedInputTransformers,
+                outputTransformers: composedOutputTransformers,
+            });
+        },
+        async applyInput(input, context) {
+            // Check condition if present
+            if (state.condition && !state.condition(input, context)) {
+                return input;
+            }
+            let result = input;
+            for (const transformer of state.inputTransformers) {
+                result = await transformer(result, context);
+            }
+            return result;
+        },
+        async applyOutput(result, input, context) {
+            // Check condition if present
+            if (state.condition && !state.condition(input, context)) {
+                return result;
+            }
+            let output = result;
+            for (const transformer of state.outputTransformers) {
+                output = await transformer(output, input, context);
+            }
+            return output;
+        },
+    };
+    return modifier;
+}
+// ============================================================================
+// FACTORY FUNCTIONS
+// ============================================================================
+let modifierCounter = 0;
+/**
+ * Create a new modifier
+ *
+ * @example
+ * ```typescript
+ * const addTimestamp = modifier()
+ *   .output((result) => ({ ...result, timestamp: Date.now() }))
+ *
+ * const validateInput = modifier({ name: 'input-validator' })
+ *   .input((input) => {
+ *     if (!input.orderId) throw new Error('Missing orderId')
+ *     return input
+ *   })
+ * ```
+ */
+export function modifier(config) {
+    const name = config?.name || `modifier-${++modifierCounter}`;
+    return createModifierInstance({
+        name,
+        description: config?.description,
+        inputTransformers: [],
+        outputTransformers: [],
+    });
+}
+/**
+ * Create an input-only modifier (convenience helper)
+ *
+ * @example
+ * ```typescript
+ * const validateOrder = inputModifier((input) => {
+ *   if (!input.items) throw new Error('Missing items')
+ *   return input
+ * })
+ * ```
+ */
+export function inputModifier(fn) {
+    return modifier().input(fn);
+}
+/**
+ * Create an output-only modifier (convenience helper)
+ *
+ * @example
+ * ```typescript
+ * const addMetadata = outputModifier((result) => ({
+ *   ...result,
+ *   processedAt: new Date().toISOString()
+ * }))
+ * ```
+ */
+export function outputModifier(fn) {
+    return modifier().output(fn);
+}
+/**
+ * Create a conditional modifier that only applies when condition is met
+ *
+ * @example
+ * ```typescript
+ * const mod = conditionalModifier(
+ *   (input) => input.shouldModify === true,
+ *   modifier().input((i) => ({ ...i, modified: true }))
+ * )
+ * ```
+ */
+export function conditionalModifier(condition, mod) {
+    return mod.when(condition);
+}
+// ============================================================================
+// UTILITY FUNCTIONS
+// ============================================================================
+/**
+ * Apply multiple modifiers to input in sequence
+ */
+export async function applyInputModifiers(modifiers, input, context) {
+    let result = input;
+    for (const mod of modifiers) {
+        result = await mod.applyInput(result, context);
+    }
+    return result;
+}
+/**
+ * Apply multiple modifiers to output in sequence
+ */
+export async function applyOutputModifiers(modifiers, result, input, context) {
+    let output = result;
+    for (const mod of modifiers) {
+        output = await mod.applyOutput(output, input, context);
+    }
+    return output;
+}
+export default modifier;
+//# sourceMappingURL=Modifier.js.map

package/dist/lib/Modifier.js.map

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