db4ai 0.1.0

package/dist/cli/workflow/index.js

@@ -0,0 +1,308 @@
+/**
+ * Module 16: Workflow Runner
+ *
+ * Executes event-triggered and manual workflows with integration
+ * to the Events API and support for concurrency control.
+ */
+import { randomUUID } from 'node:crypto';
+// =============================================================================
+// Workflow Runner Implementation
+// =============================================================================
+export function createWorkflowRunner(db, eventsAPI) {
+    const workflows = new Map();
+    const executions = new Map();
+    const abortControllers = new Map();
+    const eventUnsubscribers = [];
+    const runQueues = new Map();
+    const runningCounts = new Map();
+    let isWatching = false;
+    // Store internal handlers for event triggering
+    const internalHandlers = new Map();
+    const matchesPatternInternal = (pattern, type, action) => {
+        const [patternType, patternAction] = pattern.split('.');
+        const typeMatches = patternType === '*' || patternType === type;
+        const actionMatches = patternAction === '*' || patternAction === action;
+        return typeMatches && actionMatches;
+    };
+    // Store reference to original emit function
+    const originalEmit = eventsAPI.emit;
+    // Create a function that triggers internal handlers and calls the current emit
+    const triggerInternalHandlers = async (event) => {
+        for (const [pattern, handlers] of internalHandlers.entries()) {
+            if (matchesPatternInternal(pattern, event.type, event.action)) {
+                for (const handler of handlers) {
+                    await handler(event);
+                }
+            }
+        }
+    };
+    // Intercept emit calls by wrapping the vi.fn()
+    // We use Object.defineProperty to intercept calls while preserving vi.fn() methods
+    const originalEmitFn = eventsAPI.emit;
+    const emitProxy = new Proxy(originalEmitFn, {
+        apply: async (target, thisArg, args) => {
+            const eventOrString = args[0];
+            // If called with a DBEvent object, trigger internal handlers first
+            if (typeof eventOrString !== 'string' && eventOrString?.type && eventOrString?.action) {
+                await triggerInternalHandlers(eventOrString);
+            }
+            // Call the original function (which might have been replaced by mockImplementation)
+            return Reflect.apply(target, thisArg, args);
+        },
+        get: (target, prop, receiver) => {
+            // Pass through all properties (including mockImplementation, mock, etc.)
+            return Reflect.get(target, prop, receiver);
+        }
+    });
+    eventsAPI.emit = emitProxy;
+    const createLogger = (runId, workflowName) => ({
+        info: (message, data) => {
+            console.info(`[${workflowName}:${runId}] ${message}`, data ?? '');
+        },
+        warn: (message, data) => {
+            console.warn(`[${workflowName}:${runId}] ${message}`, data ?? '');
+        },
+        error: (message, data) => {
+            console.error(`[${workflowName}:${runId}] ${message}`, data ?? '');
+        },
+        debug: (message, data) => {
+            console.debug(`[${workflowName}:${runId}] ${message}`, data ?? '');
+        },
+    });
+    const executeWorkflow = async (config, entity, runId, attempt, input) => {
+        const abortController = new AbortController();
+        abortControllers.set(runId, abortController);
+        const execution = executions.get(runId);
+        execution.status = 'running';
+        execution.attempt = attempt;
+        try {
+            const context = {
+                entity: entity,
+                db: {
+                    generate: db.generate,
+                    relationships: db.relationships,
+                    get: db.get,
+                    list: db.list,
+                    update: db.update,
+                },
+                emit: (event, data) => {
+                    // Call eventsAPI.emit with the string event name first, then data
+                    // This allows tests to capture the emitted event in string format
+                    ;
+                    eventsAPI.emit(event, data);
+                },
+                log: createLogger(runId, config.name),
+                workflow: {
+                    name: config.name,
+                    runId,
+                    attempt,
+                },
+                signal: abortController.signal,
+                input,
+            };
+            // Apply timeout
+            const timeout = config.timeout ?? 30000;
+            let timeoutId;
+            const timeoutPromise = new Promise((_, reject) => {
+                timeoutId = setTimeout(() => {
+                    abortController.abort();
+                    reject(new Error('Workflow timeout'));
+                }, timeout);
+            });
+            try {
+                await Promise.race([config.handler(context), timeoutPromise]);
+            }
+            finally {
+                clearTimeout(timeoutId);
+            }
+            execution.status = 'completed';
+            execution.completedAt = Date.now();
+        }
+        catch (err) {
+            const maxRetries = config.maxRetries ?? 0;
+            if (attempt < maxRetries && !abortController.signal.aborted) {
+                const retryDelay = config.retryDelay ?? 1000;
+                await new Promise((r) => setTimeout(r, retryDelay));
+                return executeWorkflow(config, entity, runId, attempt + 1, input);
+            }
+            execution.status = abortController.signal.aborted ? 'cancelled' : 'failed';
+            execution.error = err instanceof Error ? err.message : String(err);
+            execution.completedAt = Date.now();
+        }
+        finally {
+            abortControllers.delete(runId);
+            const count = runningCounts.get(config.name) ?? 0;
+            runningCounts.set(config.name, Math.max(0, count - 1));
+            // Process next in queue
+            const queue = runQueues.get(config.name) ?? [];
+            if (queue.length > 0) {
+                const next = queue.shift();
+                runQueues.set(config.name, queue);
+                next();
+            }
+        }
+    };
+    const scheduleExecution = async (config, entity, runId, input) => {
+        const concurrency = config.concurrency ?? 1;
+        const currentRunning = runningCounts.get(config.name) ?? 0;
+        if (currentRunning >= concurrency) {
+            // Queue the execution
+            return new Promise((resolve) => {
+                const queue = runQueues.get(config.name) ?? [];
+                queue.push(async () => {
+                    await scheduleExecution(config, entity, runId, input);
+                    resolve();
+                });
+                runQueues.set(config.name, queue);
+            });
+        }
+        runningCounts.set(config.name, currentRunning + 1);
+        await executeWorkflow(config, entity, runId, 1, input);
+    };
+    const matchesPattern = (pattern, type, action) => {
+        const [patternType, patternAction] = pattern.split('.');
+        const typeMatches = patternType === '*' || patternType === type;
+        const actionMatches = patternAction === '*' || patternAction === action;
+        return typeMatches && actionMatches;
+    };
+    return {
+        register(config) {
+            if (workflows.has(config.name)) {
+                throw new Error(`Workflow '${config.name}' already exists`);
+            }
+            workflows.set(config.name, config);
+        },
+        registerAll(configs) {
+            for (const config of configs) {
+                this.register(config);
+            }
+        },
+        unregister(name) {
+            workflows.delete(name);
+        },
+        async watch() {
+            if (isWatching)
+                return;
+            isWatching = true;
+            for (const [, config] of workflows) {
+                if (typeof config.trigger === 'string' && config.trigger !== 'manual') {
+                    const handler = async (event) => {
+                        const entity = event.data;
+                        // Apply filter if present
+                        if (config.filter) {
+                            const shouldProcess = await config.filter(entity);
+                            if (!shouldProcess)
+                                return;
+                        }
+                        const runId = randomUUID();
+                        executions.set(runId, {
+                            runId,
+                            workflowName: config.name,
+                            status: 'pending',
+                            startedAt: Date.now(),
+                            entityId: event.entityId,
+                            entityType: event.type,
+                            attempt: 0,
+                        });
+                        await scheduleExecution(config, {
+                            ...entity,
+                            $id: entity.$id ?? event.entityId,
+                            $rowid: entity.$rowid ?? event.entityRowid
+                        }, runId);
+                    };
+                    // Store handler in internal map for direct triggering
+                    // (We don't use eventsAPI.on to avoid double-triggering when test doesn't override mock)
+                    const existingHandlers = internalHandlers.get(config.trigger) ?? [];
+                    internalHandlers.set(config.trigger, [...existingHandlers, handler]);
+                }
+            }
+        },
+        async stop() {
+            isWatching = false;
+            for (const unsubscribe of eventUnsubscribers) {
+                unsubscribe();
+            }
+            eventUnsubscribers.length = 0;
+            internalHandlers.clear();
+        },
+        async run(name, options) {
+            const config = workflows.get(name);
+            if (!config) {
+                throw new Error(`Workflow '${name}' not found`);
+            }
+            const runId = randomUUID();
+            let entity = {};
+            // Parse target if provided
+            if (options?.target) {
+                const [type, id] = options.target.split(':');
+                const fetched = await db.get(type, id);
+                entity = fetched;
+            }
+            executions.set(runId, {
+                runId,
+                workflowName: name,
+                status: 'pending',
+                startedAt: Date.now(),
+                entityId: entity.$id,
+                entityType: options?.target?.split(':')[0],
+                attempt: 0,
+            });
+            const executePromise = scheduleExecution(config, { ...entity, $id: entity.$id ?? 'manual', $rowid: entity.$rowid ?? 0 }, runId, options?.input);
+            if (options?.wait) {
+                await executePromise;
+            }
+            return runId;
+        },
+        active() {
+            return Array.from(executions.values());
+        },
+        get(name) {
+            return workflows.get(name);
+        },
+        list() {
+            return Array.from(workflows.values());
+        },
+        stats() {
+            const all = Array.from(executions.values());
+            return {
+                total: all.length,
+                running: all.filter((e) => e.status === 'running').length,
+                completed: all.filter((e) => e.status === 'completed').length,
+                failed: all.filter((e) => e.status === 'failed').length,
+                cancelled: all.filter((e) => e.status === 'cancelled').length,
+            };
+        },
+        async cancel(runId) {
+            const controller = abortControllers.get(runId);
+            if (controller) {
+                controller.abort();
+            }
+            const execution = executions.get(runId);
+            if (execution) {
+                execution.status = 'cancelled';
+                execution.completedAt = Date.now();
+            }
+        },
+        async cancelAll(name) {
+            for (const [runId, execution] of executions) {
+                if (execution.workflowName === name && execution.status === 'running') {
+                    await this.cancel(runId);
+                }
+            }
+            // Clear queue
+            runQueues.delete(name);
+        },
+        async waitFor(runId, timeout = 30000) {
+            const start = Date.now();
+            while (Date.now() - start < timeout) {
+                const execution = executions.get(runId);
+                if (execution && (execution.status === 'completed' || execution.status === 'failed' || execution.status === 'cancelled')) {
+                    return execution;
+                }
+                await new Promise((r) => setTimeout(r, 50));
+            }
+            throw new Error(`Timeout waiting for workflow ${runId}`);
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/workflow/index.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Error codes for schema validation errors.
+ */
+export type SchemaValidationErrorCode = 'MISSING_CONTEXT' | 'MISSING_NAMESPACE' | 'INVALID_FIELD_TYPE';
+/**
+ * Error thrown when schema validation fails.
+ *
+ * @example
+ * try {
+ *   DB({ User: { name: 'User name' } }) // Missing $id or $context
+ * } catch (error) {
+ *   if (error instanceof SchemaValidationError) {
+ *     console.log(error.code) // 'MISSING_CONTEXT'
+ *   }
+ * }
+ */
+export declare class SchemaValidationError extends Error {
+    code: SchemaValidationErrorCode;
+    constructor(code: SchemaValidationErrorCode, message: string);
+}
+/**
+ * Error codes for API errors.
+ */
+export type APIErrorCode = 'REGISTRATION_FAILED' | 'GENERATION_FAILED' | 'REFERENCE_RESOLUTION_FAILED';
+/**
+ * Error thrown when API operations fail.
+ *
+ * @example
+ * try {
+ *   await db.User('john-doe')
+ * } catch (error) {
+ *   if (error instanceof APIError) {
+ *     console.log(error.code) // 'GENERATION_FAILED'
+ *     console.log(error.statusCode) // 404
+ *   }
+ * }
+ */
+export declare class APIError extends Error {
+    code: APIErrorCode;
+    statusCode?: number;
+    constructor(code: APIErrorCode, message: string, statusCode?: number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../errors.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,oBAAoB,CAAA;AAEtG;;;;;;;;;;;GAWG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,IAAI,EAAE,yBAAyB,CAAA;gBAEnB,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,MAAM;CAK7D;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,qBAAqB,GAAG,mBAAmB,GAAG,6BAA6B,CAAA;AAEtG;;;;;;;;;;;;GAYG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,IAAI,EAAE,YAAY,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;gBAEP,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAMrE"}

package/dist/errors.js

@@ -0,0 +1,47 @@
+// ============================================================================
+// Custom Error Classes
+// ============================================================================
+/**
+ * Error thrown when schema validation fails.
+ *
+ * @example
+ * try {
+ *   DB({ User: { name: 'User name' } }) // Missing $id or $context
+ * } catch (error) {
+ *   if (error instanceof SchemaValidationError) {
+ *     console.log(error.code) // 'MISSING_CONTEXT'
+ *   }
+ * }
+ */
+export class SchemaValidationError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'SchemaValidationError';
+        this.code = code;
+    }
+}
+/**
+ * Error thrown when API operations fail.
+ *
+ * @example
+ * try {
+ *   await db.User('john-doe')
+ * } catch (error) {
+ *   if (error instanceof APIError) {
+ *     console.log(error.code) // 'GENERATION_FAILED'
+ *     console.log(error.statusCode) // 404
+ *   }
+ * }
+ */
+export class APIError extends Error {
+    code;
+    statusCode;
+    constructor(code, message, statusCode) {
+        super(message);
+        this.name = 'APIError';
+        this.code = code;
+        this.statusCode = statusCode;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../errors.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAO/E;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,IAAI,CAA2B;IAE/B,YAAY,IAA+B,EAAE,OAAe;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAOD;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,IAAI,CAAc;IAClB,UAAU,CAAS;IAEnB,YAAY,IAAkB,EAAE,OAAe,EAAE,UAAmB;QAClE,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,UAAU,CAAA;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;CACF"}

package/dist/handlers.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Serialized representation of a function for transport to server.
+ *
+ * Functions defined in schema definitions (like lifecycle handlers) are
+ * serialized into this format for execution on the server side.
+ *
+ * @example
+ * ```typescript
+ * const serialized: SerializedFunction = {
+ *   name: '$created',
+ *   body: '(entity, $) => $.OtherType(entity.name)',
+ *   params: ['entity', '$'],
+ *   async: true
+ * }
+ * ```
+ */
+export interface SerializedFunction {
+    /** The name of the function (e.g., '$created', 'validateUser') */
+    name: string;
+    /** The stringified function body */
+    body: string;
+    /** Array of parameter names extracted from the function signature */
+    params: string[];
+    /** Whether the function is async */
+    async: boolean;
+}
+/**
+ * Serialize a function for server-side execution.
+ *
+ * Converts a JavaScript function into a serializable format that can be
+ * sent to the server and executed in a sandboxed environment.
+ *
+ * @param name - The name to assign to the serialized function
+ * @param fn - The function to serialize
+ * @returns A SerializedFunction object
+ *
+ * @example
+ * ```typescript
+ * const handler = async (entity: any, $: any) => {
+ *   await $.OtherType(entity.name)
+ * }
+ * const serialized = serializeFunction('$created', handler)
+ * // { name: '$created', body: 'async (entity, $) => {...}', params: ['entity', '$'], async: true }
+ * ```
+ */
+export declare function serializeFunction(name: string, fn: Function): SerializedFunction;
+/**
+ * Entity-level lifecycle handler types.
+ *
+ * These handlers are triggered on individual entity operations:
+ * - `$created` - Called after a new entity is created
+ * - `$updated` - Called after an entity is updated
+ * - `$deleted` - Called after an entity is deleted
+ *
+ * @example
+ * ```typescript
+ * DB({
+ *   User: {
+ *     name: 'User name',
+ *     $created: async (entity, $) => {
+ *       await $.WelcomeEmail({ to: entity.email })
+ *     }
+ *   }
+ * })
+ * ```
+ */
+export type EntityHandlerType = '$created' | '$updated' | '$deleted';
+/**
+ * Schema-level lifecycle handler types.
+ *
+ * These handlers are triggered on schema-wide events:
+ * - `$seeded` - Called after seed data is loaded for a type
+ * - `$ready` - Called when the schema is fully initialized
+ * - `$error` - Called when a schema-level error occurs
+ *
+ * @example
+ * ```typescript
+ * DB({
+ *   $seeded: async ($) => {
+ *     console.log('Seed data loaded')
+ *   }
+ * })
+ * ```
+ */
+export type SchemaHandlerType = '$seeded' | '$ready' | '$error';
+/**
+ * All lifecycle handler types (entity + schema level).
+ *
+ * This union type includes all handler types that can be defined:
+ * - Entity handlers: `$created`, `$updated`, `$deleted`
+ * - Schema handlers: `$seeded`, `$ready`, `$error`
+ */
+export type LifecycleHandlerType = EntityHandlerType | SchemaHandlerType;
+/**
+ * State machine handler types.
+ *
+ * These handlers are triggered during state transitions:
+ * - `$entry` - Called when entering a state
+ * - `$exit` - Called when exiting a state
+ *
+ * @example
+ * ```typescript
+ * DB({
+ *   Order: {
+ *     $state: {
+ *       $initial: 'pending',
+ *       pending: {
+ *         $entry: (entity) => console.log('Order is now pending'),
+ *         confirm: 'confirmed'
+ *       }
+ *     }
+ *   }
+ * })
+ * ```
+ */
+export type StateHandlerType = '$entry' | '$exit';
+/**
+ * Handler execution result from the sandboxed environment.
+ *
+ * Contains the outcome of executing a serialized handler function
+ * in an isolated V8 sandbox.
+ */
+export interface HandlerExecutionResult {
+    /** Whether execution completed without error */
+    success: boolean;
+    /** Return value from the handler (if any) */
+    result?: unknown;
+    /** Error message if execution failed */
+    error?: string;
+    /** Execution time in milliseconds */
+    duration: number;
+}
+/**
+ * Log entry captured during handler execution.
+ *
+ * Console output from handlers is captured and returned
+ * for debugging and monitoring purposes.
+ */
+export interface HandlerLogEntry {
+    /** Log level (log, warn, error, info, debug) */
+    level: 'log' | 'warn' | 'error' | 'info' | 'debug';
+    /** The log message content */
+    message: string;
+    /** Timestamp when the log was created */
+    timestamp: number;
+}
+//# sourceMappingURL=handlers.d.ts.map

package/dist/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../handlers.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAA;IACZ,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,oCAAoC;IACpC,KAAK,EAAE,OAAO,CAAA;CACf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAG,kBAAkB,CAYhF;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAA;AAEpE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE/D;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG,iBAAiB,CAAA;AAExE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEjD;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAA;IAChB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAA;IAClD,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAA;CAClB"}

package/dist/handlers.js

@@ -0,0 +1,39 @@
+// ============================================================================
+// Handler Types
+//
+// Shared types for handler-related functionality used by both SDK and API.
+// This module defines types for function serialization and lifecycle handlers.
+// ============================================================================
+/**
+ * Serialize a function for server-side execution.
+ *
+ * Converts a JavaScript function into a serializable format that can be
+ * sent to the server and executed in a sandboxed environment.
+ *
+ * @param name - The name to assign to the serialized function
+ * @param fn - The function to serialize
+ * @returns A SerializedFunction object
+ *
+ * @example
+ * ```typescript
+ * const handler = async (entity: any, $: any) => {
+ *   await $.OtherType(entity.name)
+ * }
+ * const serialized = serializeFunction('$created', handler)
+ * // { name: '$created', body: 'async (entity, $) => {...}', params: ['entity', '$'], async: true }
+ * ```
+ */
+export function serializeFunction(name, fn) {
+    const fnStr = fn.toString();
+    const isAsync = fnStr.trimStart().startsWith('async');
+    let params = [];
+    const paramMatch = fnStr.match(/^(?:async\s*)?(?:function\s*\w*)?\s*\(([^)]*)\)/);
+    if (paramMatch && paramMatch[1]) {
+        params = paramMatch[1]
+            .split(',')
+            .map((p) => p.trim().split(':')[0].split('=')[0].trim())
+            .filter(Boolean);
+    }
+    return { name, body: fnStr, params, async: isAsync };
+}
+//# sourceMappingURL=handlers.js.map

package/dist/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../handlers.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,gBAAgB;AAChB,EAAE;AACF,2EAA2E;AAC3E,+EAA+E;AAC/E,+EAA+E;AA6B/E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,EAAY;IAC1D,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAA;IAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;IACrD,IAAI,MAAM,GAAa,EAAE,CAAA;IACzB,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAA;IACjF,IAAI,UAAU,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QAChC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;aACnB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aAC/D,MAAM,CAAC,OAAO,CAAC,CAAA;IACpB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;AACtD,CAAC"}