ai-workflows 1.0.0 → 2.0.0

package/dist/every.js

@@ -0,0 +1,268 @@
+/**
+ * Schedule registration using natural language
+ *
+ * Usage:
+ *   every.hour($ => { ... })
+ *   every.Thursday.at8am($ => { ... })
+ *   every.weekday.at9am($ => { ... })
+ *   every('hour during business hours', $ => { ... })
+ *   every('first Monday of the month at 9am', $ => { ... })
+ */
+/**
+ * Registry of schedule handlers
+ */
+const scheduleRegistry = [];
+/**
+ * Get all registered schedule handlers
+ */
+export function getScheduleHandlers() {
+    return [...scheduleRegistry];
+}
+/**
+ * Clear all registered schedule handlers
+ */
+export function clearScheduleHandlers() {
+    scheduleRegistry.length = 0;
+}
+/**
+ * Register a schedule handler directly
+ */
+export function registerScheduleHandler(interval, handler) {
+    scheduleRegistry.push({
+        interval,
+        handler,
+        source: handler.toString(),
+    });
+}
+/**
+ * Well-known cron patterns for common schedules
+ */
+const KNOWN_PATTERNS = {
+    // Time units
+    'second': '* * * * * *',
+    'minute': '* * * * *',
+    'hour': '0 * * * *',
+    'day': '0 0 * * *',
+    'week': '0 0 * * 0',
+    'month': '0 0 1 * *',
+    'year': '0 0 1 1 *',
+    // Days of week
+    'Monday': '0 0 * * 1',
+    'Tuesday': '0 0 * * 2',
+    'Wednesday': '0 0 * * 3',
+    'Thursday': '0 0 * * 4',
+    'Friday': '0 0 * * 5',
+    'Saturday': '0 0 * * 6',
+    'Sunday': '0 0 * * 0',
+    // Common patterns
+    'weekday': '0 0 * * 1-5',
+    'weekend': '0 0 * * 0,6',
+    'midnight': '0 0 * * *',
+    'noon': '0 12 * * *',
+};
+/**
+ * Time suffixes for day-based schedules
+ */
+const TIME_PATTERNS = {
+    'at6am': { hour: 6, minute: 0 },
+    'at7am': { hour: 7, minute: 0 },
+    'at8am': { hour: 8, minute: 0 },
+    'at9am': { hour: 9, minute: 0 },
+    'at10am': { hour: 10, minute: 0 },
+    'at11am': { hour: 11, minute: 0 },
+    'at12pm': { hour: 12, minute: 0 },
+    'atnoon': { hour: 12, minute: 0 },
+    'at1pm': { hour: 13, minute: 0 },
+    'at2pm': { hour: 14, minute: 0 },
+    'at3pm': { hour: 15, minute: 0 },
+    'at4pm': { hour: 16, minute: 0 },
+    'at5pm': { hour: 17, minute: 0 },
+    'at6pm': { hour: 18, minute: 0 },
+    'at7pm': { hour: 19, minute: 0 },
+    'at8pm': { hour: 20, minute: 0 },
+    'at9pm': { hour: 21, minute: 0 },
+    'atmidnight': { hour: 0, minute: 0 },
+};
+/**
+ * Parse a known pattern or return null
+ */
+function parseKnownPattern(pattern) {
+    return KNOWN_PATTERNS[pattern] ?? null;
+}
+/**
+ * Combine a day pattern with a time pattern
+ */
+function combineWithTime(baseCron, time) {
+    const parts = baseCron.split(' ');
+    parts[0] = String(time.minute);
+    parts[1] = String(time.hour);
+    return parts.join(' ');
+}
+/**
+ * AI-powered cron conversion (placeholder - will use ai-functions)
+ */
+let cronConverter = null;
+/**
+ * Set the AI cron converter function
+ */
+export function setCronConverter(converter) {
+    cronConverter = converter;
+}
+/**
+ * Convert natural language to cron expression
+ */
+export async function toCron(description) {
+    // First check known patterns
+    const known = parseKnownPattern(description);
+    if (known)
+        return known;
+    // If we have an AI converter, use it
+    if (cronConverter) {
+        return cronConverter(description);
+    }
+    // Otherwise, assume it's already a cron expression or throw
+    if (/^[\d\*\-\/\,\s]+$/.test(description)) {
+        return description;
+    }
+    throw new Error(`Unknown schedule pattern: "${description}". ` +
+        `Set up AI conversion with setCronConverter() for natural language schedules.`);
+}
+/**
+ * Create the `every` proxy
+ */
+function createEveryProxy() {
+    const handler = {
+        get(_target, prop) {
+            // Check if it's a known pattern
+            const pattern = KNOWN_PATTERNS[prop];
+            if (pattern) {
+                // Return an object that can either be called directly or have time accessors
+                const result = (handlerFn) => {
+                    registerScheduleHandler({ type: 'cron', expression: pattern, natural: prop }, handlerFn);
+                };
+                // Add time accessors
+                return new Proxy(result, {
+                    get(_t, timeKey) {
+                        const time = TIME_PATTERNS[timeKey];
+                        if (time) {
+                            const cron = combineWithTime(pattern, time);
+                            return (handlerFn) => {
+                                registerScheduleHandler({ type: 'cron', expression: cron, natural: `${prop}.${timeKey}` }, handlerFn);
+                            };
+                        }
+                        return undefined;
+                    },
+                    apply(_t, _thisArg, args) {
+                        registerScheduleHandler({ type: 'cron', expression: pattern, natural: prop }, args[0]);
+                    }
+                });
+            }
+            // Check for plural time units (e.g., seconds(5), minutes(30))
+            const pluralUnits = {
+                seconds: 'second',
+                minutes: 'minute',
+                hours: 'hour',
+                days: 'day',
+                weeks: 'week',
+            };
+            if (pluralUnits[prop]) {
+                return (value) => (handlerFn) => {
+                    registerScheduleHandler({ type: pluralUnits[prop], value, natural: `${value} ${prop}` }, handlerFn);
+                };
+            }
+            return undefined;
+        },
+        apply(_target, _thisArg, args) {
+            // Called as every('natural language description', handler)
+            const [description, handler] = args;
+            if (typeof description === 'string' && typeof handler === 'function') {
+                // Register with natural language - will be converted to cron at runtime
+                registerScheduleHandler({ type: 'natural', description }, handler);
+            }
+        }
+    };
+    return new Proxy(function () { }, handler);
+}
+/**
+ * The `every` function/object for registering scheduled handlers
+ *
+ * @example
+ * ```ts
+ * import { every } from 'ai-workflows'
+ *
+ * // Simple intervals
+ * every.hour($ => $.log('Hourly task'))
+ * every.day($ => $.log('Daily task'))
+ *
+ * // Day + time combinations
+ * every.Monday.at9am($ => $.log('Monday morning standup'))
+ * every.weekday.at8am($ => $.log('Workday start'))
+ * every.Friday.at5pm($ => $.log('End of week report'))
+ *
+ * // Plural intervals with values
+ * every.minutes(30)($ => $.log('Every 30 minutes'))
+ * every.hours(4)($ => $.log('Every 4 hours'))
+ *
+ * // Natural language (requires AI converter)
+ * every('hour during business hours', $ => { ... })
+ * every('first Monday of the month at 9am', $ => { ... })
+ * every('every 15 minutes between 9am and 5pm on weekdays', $ => { ... })
+ * ```
+ */
+export const every = createEveryProxy();
+/**
+ * Convert interval to milliseconds (for simulation/testing)
+ */
+export function intervalToMs(interval) {
+    switch (interval.type) {
+        case 'second':
+            return (interval.value ?? 1) * 1000;
+        case 'minute':
+            return (interval.value ?? 1) * 60 * 1000;
+        case 'hour':
+            return (interval.value ?? 1) * 60 * 60 * 1000;
+        case 'day':
+            return (interval.value ?? 1) * 24 * 60 * 60 * 1000;
+        case 'week':
+            return (interval.value ?? 1) * 7 * 24 * 60 * 60 * 1000;
+        case 'cron':
+        case 'natural':
+            // Cron/natural expressions need special handling
+            return 0;
+    }
+}
+/**
+ * Format interval for display
+ */
+export function formatInterval(interval) {
+    if ('natural' in interval && interval.natural) {
+        return interval.natural;
+    }
+    switch (interval.type) {
+        case 'second':
+            return interval.value && interval.value > 1
+                ? `every ${interval.value} seconds`
+                : 'every second';
+        case 'minute':
+            return interval.value && interval.value > 1
+                ? `every ${interval.value} minutes`
+                : 'every minute';
+        case 'hour':
+            return interval.value && interval.value > 1
+                ? `every ${interval.value} hours`
+                : 'every hour';
+        case 'day':
+            return interval.value && interval.value > 1
+                ? `every ${interval.value} days`
+                : 'every day';
+        case 'week':
+            return interval.value && interval.value > 1
+                ? `every ${interval.value} weeks`
+                : 'every week';
+        case 'cron':
+            return `cron: ${interval.expression}`;
+        case 'natural':
+            return interval.description;
+    }
+}
+//# sourceMappingURL=every.js.map

package/dist/every.js.map

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

package/dist/index.d.ts

@@ -1,7 +1,68 @@
 /**
- * A placeholder function that adds two numbers
- * @param a First number
- * @param b Second number
- * @returns The sum of a and b
+ * 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' })
+ * ```
  */
-export declare function add(a: number, b: number): number;
+export { Workflow, createTestContext, parseEvent, type WorkflowInstance } from './workflow.js';
+export { on, registerEventHandler, getEventHandlers, clearEventHandlers } from './on.js';
+export { every, registerScheduleHandler, getScheduleHandlers, clearScheduleHandlers, setCronConverter, toCron, intervalToMs, formatInterval, } from './every.js';
+export { send, getEventBus } from './send.js';
+export { createWorkflowContext, createIsolatedContext } from './context.js';
+export type { EventHandler, ScheduleHandler, WorkflowContext, WorkflowState, WorkflowHistoryEntry, EventRegistration, ScheduleRegistration, ScheduleInterval, WorkflowDefinition, WorkflowOptions, ParsedEvent, OnProxy, EveryProxy, HandlerFunction, DatabaseContext, ActionData, ArtifactData, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AAGH,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAG9F,OAAO,EAAE,EAAE,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAGxF,OAAO,EACL,KAAK,EACL,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,MAAM,EACN,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAG7C,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAG3E,YAAY,EACV,YAAY,EACZ,eAAe,EACf,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,OAAO,EACP,UAAU,EACV,eAAe,EACf,eAAe,EACf,UAAU,EACV,YAAY,GACb,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -1,9 +1,72 @@
 /**
- * A placeholder function that adds two numbers
- * @param a First number
- * @param b Second number
- * @returns The sum of a and b
+ * 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' })
+ * ```
  */
-export function add(a, b) {
-    return a + b;
-}
+// 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';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AAEH,oBAAoB;AACpB,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAyB,MAAM,eAAe,CAAA;AAE9F,sDAAsD;AACtD,OAAO,EAAE,EAAE,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAExF,kDAAkD;AAClD,OAAO,EACL,KAAK,EACL,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,MAAM,EACN,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAA;AAEnB,iBAAiB;AACjB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAE7C,UAAU;AACV,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA"}

package/dist/on.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Event handler registration using on.Noun.event syntax
+ *
+ * Usage:
+ *   on.Customer.created(customer => { ... })
+ *   on.Order.completed(order => { ... })
+ *   on.Payment.failed(payment => { ... })
+ */
+import type { EventHandler, EventRegistration } from './types.js';
+/**
+ * Get all registered event handlers
+ */
+export declare function getEventHandlers(): EventRegistration[];
+/**
+ * Clear all registered event handlers
+ */
+export declare function clearEventHandlers(): void;
+/**
+ * Register an event handler directly
+ */
+export declare function registerEventHandler(noun: string, event: string, handler: EventHandler): void;
+/**
+ * Event proxy type for on.Noun.event pattern
+ */
+type EventProxy = {
+    [noun: string]: {
+        [event: string]: (handler: EventHandler) => void;
+    };
+};
+/**
+ * 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 declare const on: EventProxy;
+export {};
+//# sourceMappingURL=on.d.ts.map

package/dist/on.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"on.d.ts","sourceRoot":"","sources":["../src/on.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAOjE;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,EAAE,CAEtD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,GACpB,IAAI,CAON;AAED;;GAEG;AACH,KAAK,UAAU,GAAG;IAChB,CAAC,IAAI,EAAE,MAAM,GAAG;QACd,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAA;KACjD,CAAA;CACF,CAAA;AA6BD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,EAAE,YAAkB,CAAA"}

package/dist/on.js

@@ -0,0 +1,80 @@
+/**
+ * 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();
+//# sourceMappingURL=on.js.map

package/dist/on.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"on.js","sourceRoot":"","sources":["../src/on.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;GAEG;AACH,MAAM,aAAa,GAAwB,EAAE,CAAA;AAE7C;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,GAAG,aAAa,CAAC,CAAA;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAA;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,KAAa,EACb,OAAqB;IAErB,aAAa,CAAC,IAAI,CAAC;QACjB,IAAI;QACJ,KAAK;QACL,OAAO;QACP,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE;KAC3B,CAAC,CAAA;AACJ,CAAC;AAWD;;;;;;;;;;GAUG;AACH,SAAS,aAAa;IACpB,OAAO,IAAI,KAAK,CAAC,EAAgB,EAAE;QACjC,GAAG,CAAC,OAAO,EAAE,IAAY;YACvB,qCAAqC;YACrC,OAAO,IAAI,KAAK,CAAC,EAAE,EAAE;gBACnB,GAAG,CAAC,YAAY,EAAE,KAAa;oBAC7B,+CAA+C;oBAC/C,OAAO,CAAC,OAAqB,EAAE,EAAE;wBAC/B,oBAAoB,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;oBAC5C,CAAC,CAAA;gBACH,CAAC;aACF,CAAC,CAAA;QACJ,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,EAAE,GAAG,aAAa,EAAE,CAAA"}

package/dist/send.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Event emission using send('Noun.event', data)
+ *
+ * Usage:
+ *   send('Customer.created', customer)
+ *   send('Order.completed', order)
+ */
+import type { ParsedEvent } from './types.js';
+/**
+ * Event bus for managing event delivery
+ */
+declare class EventBus {
+    private pending;
+    private processing;
+    /**
+     * Emit an event
+     */
+    emit(event: string, data: unknown): Promise<void>;
+    /**
+     * Process pending events
+     */
+    private process;
+    /**
+     * Deliver an event to matching handlers
+     */
+    private deliver;
+}
+/**
+ * Parse event string into noun and event
+ */
+export declare function parseEvent(event: string): ParsedEvent | null;
+/**
+ * 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 declare function send<T = unknown>(event: string, data: T): Promise<void>;
+/**
+ * Get the global event bus (for testing/internal use)
+ */
+export declare function getEventBus(): EventBus;
+export {};
+//# sourceMappingURL=send.d.ts.map

package/dist/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../src/send.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAI7C;;GAEG;AACH,cAAM,QAAQ;IACZ,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,UAAU,CAAQ;IAE1B;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvD;;OAEG;YACW,OAAO;IAWrB;;OAEG;YACW,OAAO;CA+BtB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAU5D;AAOD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7E;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC"}