ai-workflows 2.1.1 → 2.3.0

package/src/index.js

@@ -1,71 +0,0 @@
-/**
- * ai-workflows - Event-driven workflows with $ context
- *
- * @example
- * ```ts
- * import { Workflow } from 'ai-workflows'
- *
- * // Create a workflow with $ context
- * const workflow = Workflow($ => {
- *   // Register event handlers
- *   $.on.Customer.created(async (customer, $) => {
- *     $.log('New customer:', customer.name)
- *     await $.send('Email.welcome', { to: customer.email })
- *   })
- *
- *   $.on.Order.completed(async (order, $) => {
- *     $.log('Order completed:', order.id)
- *   })
- *
- *   // Register scheduled tasks
- *   $.every.hour(async ($) => {
- *     $.log('Hourly check')
- *   })
- *
- *   $.every.Monday.at9am(async ($) => {
- *     $.log('Weekly standup reminder')
- *   })
- *
- *   $.every.minutes(30)(async ($) => {
- *     $.log('Every 30 minutes')
- *   })
- *
- *   // Natural language scheduling
- *   $.every('first Monday of the month', async ($) => {
- *     $.log('Monthly report')
- *   })
- * })
- *
- * // Start the workflow
- * await workflow.start()
- *
- * // Emit events
- * await workflow.send('Customer.created', { name: 'John', email: 'john@example.com' })
- * ```
- *
- * @example
- * // Alternative: Use standalone on/every for global registration
- * ```ts
- * import { on, every, send } from 'ai-workflows'
- *
- * on.Customer.created(async (customer, $) => {
- *   await $.send('Email.welcome', { to: customer.email })
- * })
- *
- * every.hour(async ($) => {
- *   $.log('Hourly task')
- * })
- *
- * await send('Customer.created', { name: 'John' })
- * ```
- */
-// Main Workflow API
-export { Workflow, createTestContext, parseEvent } from './workflow.js';
-// Standalone event handling (for global registration)
-export { on, registerEventHandler, getEventHandlers, clearEventHandlers } from './on.js';
-// Standalone scheduling (for global registration)
-export { every, registerScheduleHandler, getScheduleHandlers, clearScheduleHandlers, setCronConverter, toCron, intervalToMs, formatInterval, } from './every.js';
-// Event emission
-export { send, getEventBus } from './send.js';
-// Context
-export { createWorkflowContext, createIsolatedContext } from './context.js';

package/src/on.js

@@ -1,79 +0,0 @@
-/**
- * Event handler registration using on.Noun.event syntax
- *
- * Usage:
- *   on.Customer.created(customer => { ... })
- *   on.Order.completed(order => { ... })
- *   on.Payment.failed(payment => { ... })
- */
-/**
- * Registry of event handlers
- */
-const eventRegistry = [];
-/**
- * Get all registered event handlers
- */
-export function getEventHandlers() {
-    return [...eventRegistry];
-}
-/**
- * Clear all registered event handlers
- */
-export function clearEventHandlers() {
-    eventRegistry.length = 0;
-}
-/**
- * Register an event handler directly
- */
-export function registerEventHandler(noun, event, handler) {
-    eventRegistry.push({
-        noun,
-        event,
-        handler,
-        source: handler.toString(),
-    });
-}
-/**
- * Create the `on` proxy
- *
- * This creates a proxy that allows:
- *   on.Customer.created(handler)
- *   on.Order.shipped(handler)
- *
- * The first property access captures the noun (Customer, Order)
- * The second property access captures the event (created, shipped)
- * The function call registers the handler
- */
-function createOnProxy() {
-    return new Proxy({}, {
-        get(_target, noun) {
-            // Return a proxy for the event level
-            return new Proxy({}, {
-                get(_eventTarget, event) {
-                    // Return a function that registers the handler
-                    return (handler) => {
-                        registerEventHandler(noun, event, handler);
-                    };
-                }
-            });
-        }
-    });
-}
-/**
- * The `on` object for registering event handlers
- *
- * @example
- * ```ts
- * import { on } from 'ai-workflows'
- *
- * on.Customer.created(async (customer, $) => {
- *   $.log('Customer created:', customer.name)
- *   await $.send('Email.welcome', { to: customer.email })
- * })
- *
- * on.Order.completed(async (order, $) => {
- *   $.log('Order completed:', order.id)
- * })
- * ```
- */
-export const on = createOnProxy();

package/src/send.js

@@ -1,111 +0,0 @@
-/**
- * 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;
-}

package/src/types.js

@@ -1,4 +0,0 @@
-/**
- * Types for ai-workflows
- */
-export {};