ai-workflows 1.0.0 → 2.0.0

package/dist/send.js

@@ -0,0 +1,112 @@
+/**
+ * Event emission using send('Noun.event', data)
+ *
+ * Usage:
+ *   send('Customer.created', customer)
+ *   send('Order.completed', order)
+ */
+import { getEventHandlers } from './on.js';
+import { createWorkflowContext } from './context.js';
+/**
+ * Event bus for managing event delivery
+ */
+class EventBus {
+    pending = [];
+    processing = false;
+    /**
+     * Emit an event
+     */
+    async emit(event, data) {
+        this.pending.push({ event, data });
+        if (!this.processing) {
+            await this.process();
+        }
+    }
+    /**
+     * Process pending events
+     */
+    async process() {
+        this.processing = true;
+        while (this.pending.length > 0) {
+            const item = this.pending.shift();
+            await this.deliver(item.event, item.data);
+        }
+        this.processing = false;
+    }
+    /**
+     * Deliver an event to matching handlers
+     */
+    async deliver(event, data) {
+        const parsed = parseEvent(event);
+        if (!parsed) {
+            console.warn(`Invalid event format: ${event}. Expected Noun.event`);
+            return;
+        }
+        const handlers = getEventHandlers();
+        const matching = handlers.filter(h => h.noun === parsed.noun && h.event === parsed.event);
+        if (matching.length === 0) {
+            // No handlers registered - that's okay, event is just not handled
+            return;
+        }
+        // Create workflow context for handlers
+        const ctx = createWorkflowContext(this);
+        // Execute all matching handlers
+        await Promise.all(matching.map(async ({ handler }) => {
+            try {
+                await handler(data, ctx);
+            }
+            catch (error) {
+                console.error(`Error in handler for ${event}:`, error);
+            }
+        }));
+    }
+}
+/**
+ * Parse event string into noun and event
+ */
+export function parseEvent(event) {
+    const parts = event.split('.');
+    if (parts.length !== 2) {
+        return null;
+    }
+    const [noun, eventName] = parts;
+    if (!noun || !eventName) {
+        return null;
+    }
+    return { noun, event: eventName };
+}
+/**
+ * Global event bus instance
+ */
+const globalEventBus = new EventBus();
+/**
+ * Send an event
+ *
+ * @example
+ * ```ts
+ * import { send } from 'ai-workflows'
+ *
+ * // Emit a customer created event
+ * await send('Customer.created', {
+ *   id: '123',
+ *   name: 'John Doe',
+ *   email: 'john@example.com'
+ * })
+ *
+ * // Emit an order completed event
+ * await send('Order.completed', {
+ *   id: 'order-456',
+ *   total: 99.99
+ * })
+ * ```
+ */
+export async function send(event, data) {
+    await globalEventBus.emit(event, data);
+}
+/**
+ * Get the global event bus (for testing/internal use)
+ */
+export function getEventBus() {
+    return globalEventBus;
+}
+//# sourceMappingURL=send.js.map

package/dist/send.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,229 @@
+/**
+ * Types for ai-workflows
+ */
+/**
+ * Handler function with source code for remote execution
+ */
+export interface HandlerFunction<T = unknown> {
+    /** The actual function */
+    fn: (...args: any[]) => void | Promise<void>;
+    /** Source code string for remote execution */
+    source: string;
+    /** Handler name (for debugging) */
+    name?: string;
+}
+/**
+ * Event handler function type
+ * Can return void (for send) or a result (for do/try)
+ */
+export type EventHandler<T = unknown, R = unknown> = (data: T, $: WorkflowContext) => R | void | Promise<R | void>;
+/**
+ * Schedule handler function type
+ */
+export type ScheduleHandler = ($: WorkflowContext) => void | Promise<void>;
+/**
+ * Workflow context ($) passed to handlers
+ */
+export interface WorkflowContext {
+    /**
+     * Send an event (fire and forget, durable)
+     * Confirms receipt but doesn't wait for result
+     */
+    send: <T = unknown>(event: string, data: T) => Promise<void>;
+    /**
+     * Do an action (durable, waits for result)
+     * Retries on failure, stores result durably
+     */
+    do: <TData = unknown, TResult = unknown>(event: string, data: TData) => Promise<TResult>;
+    /**
+     * Try an action (non-durable, waits for result)
+     * Simple execution without durability guarantees
+     */
+    try: <TData = unknown, TResult = unknown>(event: string, data: TData) => Promise<TResult>;
+    /** Register event handler ($.on.Noun.event) */
+    on: OnProxy;
+    /** Register schedule handler ($.every.hour, $.every.Monday.at9am) */
+    every: EveryProxy;
+    /**
+     * Workflow state - read/write context data
+     * $.state.userId = '123'
+     * const id = $.state.userId
+     */
+    state: Record<string, unknown>;
+    /**
+     * Get the full workflow state (context + history)
+     * Returns a copy to prevent mutation
+     */
+    getState: () => WorkflowState;
+    /**
+     * Set a value in the context
+     * Alternative to $.state.key = value
+     */
+    set: <T = unknown>(key: string, value: T) => void;
+    /**
+     * Get a value from the context
+     * Alternative to $.state.key
+     */
+    get: <T = unknown>(key: string) => T | undefined;
+    /** Log message */
+    log: (message: string, data?: unknown) => void;
+    /** Access to database (if connected) */
+    db?: DatabaseContext;
+}
+/**
+ * Database context for workflows
+ */
+export interface DatabaseContext {
+    /** Record an event (immutable) */
+    recordEvent: (event: string, data: unknown) => Promise<void>;
+    /** Create an action (pending work) */
+    createAction: (action: ActionData) => Promise<void>;
+    /** Complete an action */
+    completeAction: (id: string, result: unknown) => Promise<void>;
+    /** Store an artifact */
+    storeArtifact: (artifact: ArtifactData) => Promise<void>;
+    /** Get an artifact */
+    getArtifact: (key: string) => Promise<unknown | null>;
+}
+/**
+ * Action data for pending/active work
+ */
+export interface ActionData {
+    /** Actor performing the action (user, agent, system) */
+    actor: string;
+    /** Object being acted upon */
+    object: string;
+    /** Action being performed */
+    action: string;
+    /** Current status */
+    status?: 'pending' | 'active' | 'completed' | 'failed';
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Artifact data for cached compiled/parsed content
+ */
+export interface ArtifactData {
+    /** Unique key for the artifact */
+    key: string;
+    /** Type of artifact (ast, types, esm, worker, html, markdown) */
+    type: 'ast' | 'types' | 'esm' | 'worker' | 'html' | 'markdown' | 'bundle' | string;
+    /** Source hash (for cache invalidation) */
+    sourceHash: string;
+    /** The artifact content */
+    content: unknown;
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Event proxy type for $.on.Noun.event pattern
+ */
+export type OnProxy = {
+    [noun: string]: {
+        [event: string]: (handler: EventHandler) => void;
+    };
+};
+/**
+ * Every proxy type for $.every patterns
+ */
+export type EveryProxy = {
+    (description: string, handler: ScheduleHandler): void;
+} & {
+    [key: string]: ((handler: ScheduleHandler) => void) | ((value: number) => (handler: ScheduleHandler) => void) | {
+        [timeKey: string]: (handler: ScheduleHandler) => void;
+    };
+};
+/**
+ * Workflow state
+ */
+export interface WorkflowState {
+    /** Current state name (for state machines) */
+    current?: string;
+    /** Context data */
+    context: Record<string, unknown>;
+    /** Execution history */
+    history: WorkflowHistoryEntry[];
+}
+/**
+ * History entry for workflow execution
+ */
+export interface WorkflowHistoryEntry {
+    timestamp: number;
+    type: 'event' | 'schedule' | 'transition' | 'action';
+    name: string;
+    data?: unknown;
+}
+/**
+ * Event registration with source
+ */
+export interface EventRegistration {
+    noun: string;
+    event: string;
+    handler: EventHandler;
+    source: string;
+}
+/**
+ * Schedule registration with source
+ */
+export interface ScheduleRegistration {
+    interval: ScheduleInterval;
+    handler: ScheduleHandler;
+    source: string;
+}
+/**
+ * Schedule intervals
+ */
+export type ScheduleInterval = {
+    type: 'second';
+    value?: number;
+    natural?: string;
+} | {
+    type: 'minute';
+    value?: number;
+    natural?: string;
+} | {
+    type: 'hour';
+    value?: number;
+    natural?: string;
+} | {
+    type: 'day';
+    value?: number;
+    natural?: string;
+} | {
+    type: 'week';
+    value?: number;
+    natural?: string;
+} | {
+    type: 'cron';
+    expression: string;
+    natural?: string;
+} | {
+    type: 'natural';
+    description: string;
+};
+/**
+ * Workflow definition
+ */
+export interface WorkflowDefinition {
+    name: string;
+    events: EventRegistration[];
+    schedules: ScheduleRegistration[];
+    initialContext?: Record<string, unknown>;
+}
+/**
+ * Parsed event name (Noun.event format)
+ */
+export interface ParsedEvent {
+    noun: string;
+    event: string;
+}
+/**
+ * Workflow options
+ */
+export interface WorkflowOptions {
+    /** Initial context data */
+    context?: Record<string, unknown>;
+    /** Database connection for persistence */
+    db?: DatabaseContext;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for ai-workflows
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/workflow.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Unified Workflow API
+ *
+ * Usage:
+ *   Workflow($ => {
+ *     $.on.Customer.created(async (customer, $) => {
+ *       $.log('Customer created', customer)
+ *       await $.send('Email.welcome', { to: customer.email })
+ *     })
+ *
+ *     $.every.Monday.at9am(async ($) => {
+ *       $.log('Weekly standup reminder')
+ *     })
+ *   })
+ */
+import type { WorkflowContext, WorkflowState, WorkflowDefinition, WorkflowOptions, ParsedEvent } from './types.js';
+/**
+ * Parse event string into noun and event
+ */
+export declare function parseEvent(event: string): ParsedEvent | null;
+/**
+ * Workflow instance returned by Workflow()
+ */
+export interface WorkflowInstance {
+    /** Workflow definition with captured handlers */
+    definition: WorkflowDefinition;
+    /** Current state */
+    state: WorkflowState;
+    /** The $ context */
+    $: WorkflowContext;
+    /** Send an event */
+    send: <T = unknown>(event: string, data: T) => Promise<void>;
+    /** Start the workflow (begin processing schedules) */
+    start: () => Promise<void>;
+    /** Stop the workflow */
+    stop: () => Promise<void>;
+}
+/**
+ * Create a workflow with the $ context
+ *
+ * @example
+ * ```ts
+ * const workflow = Workflow($ => {
+ *   $.on.Customer.created(async (customer, $) => {
+ *     $.log('New customer:', customer.name)
+ *     await $.send('Email.welcome', { to: customer.email })
+ *   })
+ *
+ *   $.every.hour(async ($) => {
+ *     $.log('Hourly check')
+ *   })
+ *
+ *   $.every.Monday.at9am(async ($) => {
+ *     $.log('Weekly standup')
+ *   })
+ *
+ *   $.every('first Monday of the month', async ($) => {
+ *     $.log('Monthly report')
+ *   })
+ * })
+ *
+ * await workflow.start()
+ * await workflow.send('Customer.created', { name: 'John', email: 'john@example.com' })
+ * ```
+ */
+export declare function Workflow(setup: ($: WorkflowContext) => void, options?: WorkflowOptions): WorkflowInstance;
+/**
+ * Create an isolated $ context for testing
+ */
+export declare function createTestContext(): WorkflowContext & {
+    emittedEvents: Array<{
+        event: string;
+        data: unknown;
+    }>;
+};
+export { on, registerEventHandler, getEventHandlers, clearEventHandlers } from './on.js';
+export { every, registerScheduleHandler, getScheduleHandlers, clearScheduleHandlers, toCron, intervalToMs, formatInterval, setCronConverter } from './every.js';
+export { send } from './send.js';
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EAOb,kBAAkB,EAClB,eAAe,EAGf,WAAW,EAEZ,MAAM,YAAY,CAAA;AA4DnB;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAU5D;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,UAAU,EAAE,kBAAkB,CAAA;IAC9B,oBAAoB;IACpB,KAAK,EAAE,aAAa,CAAA;IACpB,oBAAoB;IACpB,CAAC,EAAE,eAAe,CAAA;IAClB,oBAAoB;IACpB,IAAI,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,sDAAsD;IACtD,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,wBAAwB;IACxB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,CAAC,CAAC,EAAE,eAAe,KAAK,IAAI,EACnC,OAAO,GAAE,eAAoB,GAC5B,gBAAgB,CAuVlB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,eAAe,GAAG;IAAE,aAAa,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAAE,CA4DhH;AAGD,OAAO,EAAE,EAAE,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AACxF,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAC/J,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA"}