db4ai 0.3.0 → 0.3.2

package/dist/cli/workflow/index.js

@@ -1,308 +1,7 @@
-/**
- * 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}`);
-        },
-    };
-}
+import {
+  createWorkflowRunner
+} from "../../chunk-3DWAMVV5.js";
+export {
+  createWorkflowRunner
+};
 //# sourceMappingURL=index.js.map

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

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

package/dist/handlers.d.ts

@@ -14,7 +14,7 @@
  * }
  * ```
  */
-export interface SerializedFunction {
+interface SerializedFunction {
     /** The name of the function (e.g., '$created', 'validateUser') */
     name: string;
     /** The stringified function body */
@@ -43,7 +43,7 @@ export interface SerializedFunction {
  * // { name: '$created', body: 'async (entity, $) => {...}', params: ['entity', '$'], async: true }
  * ```
  */
-export declare function serializeFunction(name: string, fn: Function): SerializedFunction;
+declare function serializeFunction(name: string, fn: Function): SerializedFunction;
 /**
  * Entity-level lifecycle handler types.
  *
@@ -64,7 +64,7 @@ export declare function serializeFunction(name: string, fn: Function): Serialize
  * })
  * ```
  */
-export type EntityHandlerType = '$created' | '$updated' | '$deleted';
+type EntityHandlerType = '$created' | '$updated' | '$deleted';
 /**
  * Schema-level lifecycle handler types.
  *
@@ -82,7 +82,7 @@ export type EntityHandlerType = '$created' | '$updated' | '$deleted';
  * })
  * ```
  */
-export type SchemaHandlerType = '$seeded' | '$ready' | '$error';
+type SchemaHandlerType = '$seeded' | '$ready' | '$error';
 /**
  * All lifecycle handler types (entity + schema level).
  *
@@ -90,7 +90,7 @@ export type SchemaHandlerType = '$seeded' | '$ready' | '$error';
  * - Entity handlers: `$created`, `$updated`, `$deleted`
  * - Schema handlers: `$seeded`, `$ready`, `$error`
  */
-export type LifecycleHandlerType = EntityHandlerType | SchemaHandlerType;
+type LifecycleHandlerType = EntityHandlerType | SchemaHandlerType;
 /**
  * State machine handler types.
  *
@@ -113,14 +113,14 @@ export type LifecycleHandlerType = EntityHandlerType | SchemaHandlerType;
  * })
  * ```
  */
-export type StateHandlerType = '$entry' | '$exit';
+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 {
+interface HandlerExecutionResult {
     /** Whether execution completed without error */
     success: boolean;
     /** Return value from the handler (if any) */
@@ -136,7 +136,7 @@ export interface HandlerExecutionResult {
  * Console output from handlers is captured and returned
  * for debugging and monitoring purposes.
  */
-export interface HandlerLogEntry {
+interface HandlerLogEntry {
     /** Log level (log, warn, error, info, debug) */
     level: 'log' | 'warn' | 'error' | 'info' | 'debug';
     /** The log message content */
@@ -144,4 +144,5 @@ export interface HandlerLogEntry {
     /** Timestamp when the log was created */
     timestamp: number;
 }
-//# sourceMappingURL=handlers.d.ts.map
+
+export { type EntityHandlerType, type HandlerExecutionResult, type HandlerLogEntry, type LifecycleHandlerType, type SchemaHandlerType, type SerializedFunction, type StateHandlerType, serializeFunction };

package/dist/handlers.js

@@ -1,39 +1,7 @@
-// ============================================================================
-// 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 };
-}
+import {
+  serializeFunction
+} from "./chunk-JLL6FH5L.js";
+export {
+  serializeFunction
+};
 //# sourceMappingURL=handlers.js.map

package/dist/handlers.js.map

@@ -1 +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"}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}