ai-props 2.3.0 → 2.4.0

package/dist/event-bridge.d.ts

@@ -0,0 +1,257 @@
+/**
+ * EventBridge - Event system with Cloudflare Queues support
+ *
+ * Provides both sync event handling and Queue-based async event delivery.
+ * Supports dead letter queues, event validation, and retry strategies.
+ *
+ * @example
+ * ```typescript
+ * // Create an EventBridge with a queue
+ * const bridge = new EventBridge(env.MY_QUEUE)
+ *
+ * // Register event handlers
+ * bridge.on('user.created', async (data) => {
+ *   console.log('New user:', data.id)
+ * })
+ *
+ * // Emit events (sent to queue for reliable delivery)
+ * await bridge.emit('user.created', { id: '123', name: 'John' })
+ *
+ * // In worker's queue handler:
+ * export default {
+ *   async queue(batch, env) {
+ *     const handler = createQueueHandler(bridge)
+ *     await handler.queue(batch, env)
+ *   }
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+/**
+ * Queued event structure
+ */
+export interface QueuedEvent<T = unknown> {
+    /** Event type identifier */
+    type: string;
+    /** Event payload data */
+    data: T;
+    /** Event creation timestamp */
+    timestamp: number;
+    /** Unique event ID */
+    id: string;
+    /** Optional metadata */
+    metadata?: Record<string, unknown> | undefined;
+    /** Number of retry attempts */
+    attempts?: number | undefined;
+    /** Error message (for DLQ events) */
+    error?: string | undefined;
+}
+/**
+ * EventBridge configuration options
+ */
+export interface EventBridgeConfig {
+    /** Maximum retry attempts before sending to DLQ */
+    maxRetries?: number | undefined;
+    /** Dead letter queue for failed events */
+    deadLetterQueue?: Queue | undefined;
+    /** Event schema validation function */
+    validator?: ((event: QueuedEvent) => boolean | Promise<boolean>) | undefined;
+    /** Custom serializer for event data */
+    serializer?: (<T>(data: T) => unknown) | undefined;
+    /** Custom deserializer for event data */
+    deserializer?: (<T>(data: unknown) => T) | undefined;
+    /** Enable debug logging */
+    debug?: boolean | undefined;
+}
+/**
+ * Event handler function type
+ */
+export type EventHandler<T = unknown> = (data: T, event: QueuedEvent<T>) => void | Promise<void>;
+/**
+ * Queue message interface (Cloudflare Queues)
+ */
+export interface QueueMessage<T = unknown> {
+    readonly id: string;
+    readonly timestamp: Date;
+    readonly body: T;
+    ack(): void;
+    retry(options?: {
+        delaySeconds?: number | undefined;
+    }): void;
+}
+/**
+ * Message batch interface (Cloudflare Queues)
+ */
+export interface MessageBatch<T = unknown> {
+    readonly queue: string;
+    readonly messages: readonly QueueMessage<T>[];
+    ackAll(): void;
+    retryAll(options?: {
+        delaySeconds?: number | undefined;
+    }): void;
+}
+/**
+ * Queue interface (Cloudflare Queues)
+ */
+export interface Queue<T = unknown> {
+    send(message: T, options?: {
+        contentType?: string | undefined;
+        delaySeconds?: number | undefined;
+    }): Promise<void>;
+    sendBatch(messages: Iterable<{
+        body: T;
+        contentType?: string | undefined;
+        delaySeconds?: number | undefined;
+    }>): Promise<void>;
+}
+/**
+ * Emit options for customizing event delivery
+ */
+export interface EmitOptions {
+    /** Delay before the event is processed (in seconds) */
+    delaySeconds?: number | undefined;
+    /** Additional metadata to attach to the event */
+    metadata?: Record<string, unknown> | undefined;
+}
+/**
+ * EventBridge - Unified event system with Queue support
+ *
+ * Provides reliable event delivery via Cloudflare Queues with
+ * support for multiple handlers, dead letter queues, and retries.
+ */
+export declare class EventBridge {
+    private queue?;
+    private handlers;
+    private wildcardHandlers;
+    private config;
+    /**
+     * Create a new EventBridge
+     *
+     * @param queue - Cloudflare Queue for event delivery
+     * @param config - Optional configuration
+     */
+    constructor(queue?: Queue | undefined, config?: EventBridgeConfig);
+    /**
+     * Emit an event
+     *
+     * If a queue is configured, the event will be sent to the queue for
+     * reliable delivery. Otherwise, handlers are invoked synchronously.
+     *
+     * @param event - Event type identifier
+     * @param data - Event payload data
+     * @param options - Optional emit options
+     */
+    emit<T = unknown>(event: string, data: T, options?: EmitOptions): Promise<void>;
+    /**
+     * Emit multiple events in a batch
+     *
+     * @param events - Array of events to emit
+     */
+    emitBatch<T = unknown>(events: Array<{
+        type: string;
+        data: T;
+        options?: EmitOptions;
+    }>): Promise<void>;
+    /**
+     * Register an event handler
+     *
+     * @param event - Event type to handle (use '*' for all events)
+     * @param handler - Handler function
+     */
+    on<T = unknown>(event: string, handler: EventHandler<T>): void;
+    /**
+     * Remove an event handler
+     *
+     * @param event - Event type
+     * @param handler - Handler to remove
+     */
+    off<T = unknown>(event: string, handler: EventHandler<T>): void;
+    /**
+     * Register a one-time event handler
+     *
+     * @param event - Event type to handle
+     * @param handler - Handler function (called once then removed)
+     */
+    once<T = unknown>(event: string, handler: EventHandler<T>): void;
+    /**
+     * Handle a message from the queue
+     *
+     * This method should be called from your worker's queue handler.
+     *
+     * @param message - Queue message to process
+     */
+    handleMessage<T = unknown>(message: QueueMessage<QueuedEvent<T>>): Promise<void>;
+    /**
+     * Handle a batch of messages from the queue
+     *
+     * @param batch - Message batch to process
+     */
+    handleBatch<T = unknown>(batch: MessageBatch<QueuedEvent<T>>): Promise<void>;
+    /**
+     * Get all registered event types
+     */
+    getEventTypes(): string[];
+    /**
+     * Check if there are handlers for an event type
+     */
+    hasHandlers(event: string): boolean;
+    /**
+     * Clear all handlers
+     */
+    clearHandlers(): void;
+    /**
+     * Invoke handlers for an event
+     */
+    private invokeHandlers;
+}
+/**
+ * Create a queue handler for use in a Cloudflare Worker
+ *
+ * @param bridge - EventBridge instance to handle events
+ * @returns Queue handler object with queue method
+ *
+ * @example
+ * ```typescript
+ * const bridge = new EventBridge(env.MY_QUEUE)
+ * const handler = createQueueHandler(bridge)
+ *
+ * export default {
+ *   async queue(batch, env, ctx) {
+ *     await handler.queue(batch, env, ctx)
+ *   }
+ * }
+ * ```
+ */
+export declare function createQueueHandler(bridge: EventBridge): {
+    queue: <T>(batch: MessageBatch<QueuedEvent<T>>, env?: unknown, ctx?: unknown) => Promise<void>;
+};
+/**
+ * Create an EventBridge with standard configuration
+ *
+ * @param queue - Optional queue for async delivery
+ * @param dlq - Optional dead letter queue
+ * @returns Configured EventBridge instance
+ */
+export declare function createEventBridge(queue?: Queue, dlq?: Queue): EventBridge;
+/**
+ * Type helper for strongly-typed event maps
+ *
+ * @example
+ * ```typescript
+ * type MyEvents = {
+ *   'user.created': { id: string; name: string }
+ *   'user.deleted': { id: string }
+ * }
+ *
+ * const bridge = new EventBridge(queue) as TypedEventBridge<MyEvents>
+ * bridge.emit('user.created', { id: '1', name: 'John' }) // type-safe!
+ * ```
+ */
+export interface TypedEventBridge<TEvents extends Record<string, unknown>> {
+    emit<K extends keyof TEvents & string>(event: K, data: TEvents[K], options?: EmitOptions): Promise<void>;
+    on<K extends keyof TEvents & string>(event: K, handler: EventHandler<TEvents[K]>): void;
+    off<K extends keyof TEvents & string>(event: K, handler: EventHandler<TEvents[K]>): void;
+    once<K extends keyof TEvents & string>(event: K, handler: EventHandler<TEvents[K]>): void;
+}
+//# sourceMappingURL=event-bridge.d.ts.map

package/dist/event-bridge.d.ts.map

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

package/dist/event-bridge.js

@@ -0,0 +1,317 @@
+/**
+ * EventBridge - Event system with Cloudflare Queues support
+ *
+ * Provides both sync event handling and Queue-based async event delivery.
+ * Supports dead letter queues, event validation, and retry strategies.
+ *
+ * @example
+ * ```typescript
+ * // Create an EventBridge with a queue
+ * const bridge = new EventBridge(env.MY_QUEUE)
+ *
+ * // Register event handlers
+ * bridge.on('user.created', async (data) => {
+ *   console.log('New user:', data.id)
+ * })
+ *
+ * // Emit events (sent to queue for reliable delivery)
+ * await bridge.emit('user.created', { id: '123', name: 'John' })
+ *
+ * // In worker's queue handler:
+ * export default {
+ *   async queue(batch, env) {
+ *     const handler = createQueueHandler(bridge)
+ *     await handler.queue(batch, env)
+ *   }
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+/**
+ * EventBridge - Unified event system with Queue support
+ *
+ * Provides reliable event delivery via Cloudflare Queues with
+ * support for multiple handlers, dead letter queues, and retries.
+ */
+export class EventBridge {
+    queue;
+    handlers = new Map();
+    wildcardHandlers = [];
+    config;
+    /**
+     * Create a new EventBridge
+     *
+     * @param queue - Cloudflare Queue for event delivery
+     * @param config - Optional configuration
+     */
+    constructor(queue, config = {}) {
+        this.queue = queue;
+        this.config = {
+            maxRetries: config.maxRetries ?? 3,
+            deadLetterQueue: config.deadLetterQueue,
+            validator: config.validator,
+            serializer: config.serializer ?? ((data) => data),
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            deserializer: config.deserializer ?? ((data) => data),
+            debug: config.debug ?? false,
+        };
+    }
+    /**
+     * Emit an event
+     *
+     * If a queue is configured, the event will be sent to the queue for
+     * reliable delivery. Otherwise, handlers are invoked synchronously.
+     *
+     * @param event - Event type identifier
+     * @param data - Event payload data
+     * @param options - Optional emit options
+     */
+    async emit(event, data, options) {
+        const queuedEvent = {
+            type: event,
+            data: this.config.serializer(data),
+            timestamp: Date.now(),
+            id: crypto.randomUUID(),
+            metadata: options?.metadata,
+            attempts: 0,
+        };
+        if (this.config.debug) {
+            console.log(`[EventBridge] Emitting event: ${event}`, queuedEvent.id);
+        }
+        // Validate event if validator is configured
+        if (this.config.validator) {
+            const isValid = await this.config.validator(queuedEvent);
+            if (!isValid) {
+                throw new Error(`Event validation failed for type: ${event}`);
+            }
+        }
+        if (this.queue) {
+            // Send to queue for reliable delivery
+            const sendOptions = {};
+            if (options?.delaySeconds !== undefined) {
+                sendOptions.delaySeconds = options.delaySeconds;
+            }
+            await this.queue.send(queuedEvent, sendOptions);
+        }
+        else {
+            // No queue - invoke handlers synchronously
+            await this.invokeHandlers(queuedEvent);
+        }
+    }
+    /**
+     * Emit multiple events in a batch
+     *
+     * @param events - Array of events to emit
+     */
+    async emitBatch(events) {
+        if (!this.queue) {
+            // No queue - invoke handlers for each event synchronously
+            for (const { type, data, options } of events) {
+                await this.emit(type, data, options);
+            }
+            return;
+        }
+        const messages = events.map(({ type, data, options }) => {
+            const msg = {
+                body: {
+                    type,
+                    data: this.config.serializer(data),
+                    timestamp: Date.now(),
+                    id: crypto.randomUUID(),
+                    metadata: options?.metadata,
+                    attempts: 0,
+                },
+            };
+            if (options?.delaySeconds !== undefined) {
+                msg.delaySeconds = options.delaySeconds;
+            }
+            return msg;
+        });
+        await this.queue.sendBatch(messages);
+    }
+    /**
+     * Register an event handler
+     *
+     * @param event - Event type to handle (use '*' for all events)
+     * @param handler - Handler function
+     */
+    on(event, handler) {
+        if (event === '*') {
+            this.wildcardHandlers.push(handler);
+            return;
+        }
+        const handlers = this.handlers.get(event) ?? [];
+        handlers.push(handler);
+        this.handlers.set(event, handlers);
+    }
+    /**
+     * Remove an event handler
+     *
+     * @param event - Event type
+     * @param handler - Handler to remove
+     */
+    off(event, handler) {
+        if (event === '*') {
+            const index = this.wildcardHandlers.indexOf(handler);
+            if (index !== -1) {
+                this.wildcardHandlers.splice(index, 1);
+            }
+            return;
+        }
+        const handlers = this.handlers.get(event);
+        if (handlers) {
+            const index = handlers.indexOf(handler);
+            if (index !== -1) {
+                handlers.splice(index, 1);
+            }
+        }
+    }
+    /**
+     * Register a one-time event handler
+     *
+     * @param event - Event type to handle
+     * @param handler - Handler function (called once then removed)
+     */
+    once(event, handler) {
+        const wrapper = async (data, queuedEvent) => {
+            this.off(event, wrapper);
+            await handler(data, queuedEvent);
+        };
+        this.on(event, wrapper);
+    }
+    /**
+     * Handle a message from the queue
+     *
+     * This method should be called from your worker's queue handler.
+     *
+     * @param message - Queue message to process
+     */
+    async handleMessage(message) {
+        const event = message.body;
+        const attempts = (event.attempts ?? 0) + 1;
+        const deserializedEvent = {
+            ...event,
+            data: this.config.deserializer(event.data),
+            attempts,
+        };
+        if (this.config.debug) {
+            console.log(`[EventBridge] Processing event: ${event.type}`, event.id, `attempt: ${attempts}`);
+        }
+        try {
+            await this.invokeHandlers(deserializedEvent);
+            message.ack();
+        }
+        catch (error) {
+            if (this.config.debug) {
+                console.error(`[EventBridge] Error processing event: ${event.type}`, error);
+            }
+            // Check if we should send to DLQ
+            if (attempts >= this.config.maxRetries) {
+                if (this.config.deadLetterQueue) {
+                    await this.config.deadLetterQueue.send({
+                        ...deserializedEvent,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                    message.ack(); // Ack after sending to DLQ
+                }
+                else {
+                    // No DLQ - let it fail (will be dropped after max retries)
+                    message.ack();
+                }
+            }
+            else {
+                // Retry with exponential backoff
+                const delaySeconds = Math.min(60, Math.pow(2, attempts));
+                message.retry({ delaySeconds });
+            }
+        }
+    }
+    /**
+     * Handle a batch of messages from the queue
+     *
+     * @param batch - Message batch to process
+     */
+    async handleBatch(batch) {
+        // Process messages in parallel
+        await Promise.all(batch.messages.map((message) => this.handleMessage(message)));
+    }
+    /**
+     * Get all registered event types
+     */
+    getEventTypes() {
+        return Array.from(this.handlers.keys());
+    }
+    /**
+     * Check if there are handlers for an event type
+     */
+    hasHandlers(event) {
+        const handlers = this.handlers.get(event);
+        return (handlers && handlers.length > 0) || this.wildcardHandlers.length > 0;
+    }
+    /**
+     * Clear all handlers
+     */
+    clearHandlers() {
+        this.handlers.clear();
+        this.wildcardHandlers = [];
+    }
+    /**
+     * Invoke handlers for an event
+     */
+    async invokeHandlers(event) {
+        const handlers = this.handlers.get(event.type) ?? [];
+        const allHandlers = [...handlers, ...this.wildcardHandlers];
+        if (allHandlers.length === 0) {
+            if (this.config.debug) {
+                console.log(`[EventBridge] No handlers for event: ${event.type}`);
+            }
+            return;
+        }
+        // Fan-out to all handlers
+        await Promise.all(allHandlers.map((handler) => handler(event.data, event)));
+    }
+}
+/**
+ * Create a queue handler for use in a Cloudflare Worker
+ *
+ * @param bridge - EventBridge instance to handle events
+ * @returns Queue handler object with queue method
+ *
+ * @example
+ * ```typescript
+ * const bridge = new EventBridge(env.MY_QUEUE)
+ * const handler = createQueueHandler(bridge)
+ *
+ * export default {
+ *   async queue(batch, env, ctx) {
+ *     await handler.queue(batch, env, ctx)
+ *   }
+ * }
+ * ```
+ */
+export function createQueueHandler(bridge) {
+    return {
+        async queue(batch, _env, _ctx) {
+            await bridge.handleBatch(batch);
+        },
+    };
+}
+/**
+ * Create an EventBridge with standard configuration
+ *
+ * @param queue - Optional queue for async delivery
+ * @param dlq - Optional dead letter queue
+ * @returns Configured EventBridge instance
+ */
+export function createEventBridge(queue, dlq) {
+    const config = {
+        maxRetries: 3,
+        debug: false,
+    };
+    if (dlq) {
+        config.deadLetterQueue = dlq;
+    }
+    return new EventBridge(queue, config);
+}
+//# sourceMappingURL=event-bridge.js.map

package/dist/event-bridge.js.map

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

package/dist/generate.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Props generation for ai-props
+ *
+ * Core functionality for generating component props using AI.
+ *
+ * @packageDocumentation
+ */
+import type { PropSchema, GeneratePropsOptions, GeneratePropsResult, AIPropsConfig } from './types.js';
+/**
+ * Configure global AI props settings
+ */
+export declare function configureAIProps(config: Partial<AIPropsConfig>): void;
+/**
+ * Get current configuration
+ */
+export declare function getConfig(): AIPropsConfig;
+/**
+ * Reset configuration to defaults
+ */
+export declare function resetConfig(): void;
+/**
+ * Generate props using AI
+ *
+ * @example
+ * ```ts
+ * const result = await generateProps({
+ *   schema: {
+ *     title: 'A compelling page title',
+ *     description: 'A brief description',
+ *     keywords: ['Relevant SEO keywords'],
+ *   },
+ *   context: { topic: 'AI-powered applications' },
+ * })
+ *
+ * console.log(result.props)
+ * // { title: '...', description: '...', keywords: [...] }
+ * ```
+ */
+export declare function generateProps<T = Record<string, unknown>>(options: GeneratePropsOptions): Promise<GeneratePropsResult<T>>;
+/**
+ * Generate props synchronously from cache or throw
+ *
+ * Useful for SSR scenarios where async isn't available.
+ * Throws if props aren't in cache.
+ */
+export declare function getPropsSync<T = Record<string, unknown>>(schema: PropSchema, context?: Record<string, unknown>): T;
+/**
+ * Pre-generate props for warming the cache
+ *
+ * @example
+ * ```ts
+ * await prefetchProps([
+ *   { schema: userProfileSchema, context: { userId: '123' } },
+ *   { schema: productSchema, context: { category: 'electronics' } },
+ * ])
+ * ```
+ */
+export declare function prefetchProps(requests: GeneratePropsOptions[]): Promise<void>;
+/**
+ * Generate multiple prop sets in parallel
+ */
+export declare function generatePropsMany<T = Record<string, unknown>>(requests: GeneratePropsOptions[]): Promise<GeneratePropsResult<T>[]>;
+/**
+ * Merge partial props with generated props
+ *
+ * Generates only the missing props, keeping provided ones.
+ */
+export declare function mergeWithGenerated<T extends Record<string, unknown>>(schema: PropSchema, partialProps: Partial<T>, options?: Omit<GeneratePropsOptions, 'schema' | 'context'>): Promise<T>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAA;AAkBnB;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAErE;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,aAAa,CAEzC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAiDD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAuEjC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtD,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,CAAC,CAUH;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,QAAQ,EAAE,oBAAoB,EAAE,GAC/B,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,CAEnC;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxE,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,EACxB,OAAO,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,SAAS,CAAC,GACzD,OAAO,CAAC,CAAC,CAAC,CA8BZ"}