ai-props 2.3.0 → 2.4.0

package/dist/validate.js

@@ -0,0 +1,251 @@
+/**
+ * Validation utilities for ai-props
+ *
+ * Provides prop validation against schemas.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Validate props against a schema
+ *
+ * @example
+ * ```ts
+ * const result = validateProps(
+ *   { name: 'John', age: '25' },  // props
+ *   { name: 'Name', age: 'Age (number)' }  // schema
+ * )
+ *
+ * if (!result.valid) {
+ *   console.log(result.errors)
+ *   // [{ path: 'age', message: 'Expected number, got string' }]
+ * }
+ * ```
+ */
+export function validateProps(props, schema) {
+    const errors = [];
+    if (typeof schema === 'string') {
+        // Simple string schema - just check if value exists
+        if (!props['value']) {
+            errors.push({
+                path: 'value',
+                message: 'Value is required',
+                expected: 'string',
+                received: props['value'],
+            });
+        }
+        return { valid: errors.length === 0, errors };
+    }
+    // Object schema - validate each key
+    for (const [key, schemaDef] of Object.entries(schema)) {
+        const value = props[key];
+        const keyErrors = validateValue(key, value, schemaDef);
+        errors.push(...keyErrors);
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Validate a single value against a schema definition
+ */
+function validateValue(path, value, schema) {
+    const errors = [];
+    // String schema with type hint
+    if (typeof schema === 'string') {
+        const expectedType = extractTypeFromSchema(schema);
+        if (value === undefined || value === null) {
+            // Optional unless marked required
+            return errors;
+        }
+        if (expectedType && !checkType(value, expectedType)) {
+            errors.push({
+                path,
+                message: `Expected ${expectedType}, got ${typeof value}`,
+                expected: expectedType,
+                received: value,
+            });
+        }
+        return errors;
+    }
+    // Array schema
+    if (Array.isArray(schema)) {
+        if (!Array.isArray(value)) {
+            if (value !== undefined && value !== null) {
+                errors.push({
+                    path,
+                    message: `Expected array, got ${typeof value}`,
+                    expected: 'array',
+                    received: value,
+                });
+            }
+            return errors;
+        }
+        // Validate array items if schema has item definition
+        if (schema.length > 0) {
+            const itemSchema = schema[0];
+            for (let i = 0; i < value.length; i++) {
+                const itemErrors = validateValue(`${path}[${i}]`, value[i], itemSchema);
+                errors.push(...itemErrors);
+            }
+        }
+        return errors;
+    }
+    // Object schema
+    if (typeof schema === 'object' && schema !== null) {
+        if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+            if (value !== undefined && value !== null) {
+                errors.push({
+                    path,
+                    message: `Expected object, got ${Array.isArray(value) ? 'array' : typeof value}`,
+                    expected: 'object',
+                    received: value,
+                });
+            }
+            return errors;
+        }
+        // Recursively validate nested object
+        for (const [key, nestedSchema] of Object.entries(schema)) {
+            const nestedValue = value[key];
+            const nestedErrors = validateValue(`${path}.${key}`, nestedValue, nestedSchema);
+            errors.push(...nestedErrors);
+        }
+    }
+    return errors;
+}
+/**
+ * Extract type hint from schema string
+ * e.g., "Age (number)" -> "number"
+ */
+function extractTypeFromSchema(schema) {
+    const match = schema.match(/\((\w+)\)\s*$/);
+    if (match) {
+        return match[1].toLowerCase();
+    }
+    // Check for enum syntax
+    if (schema.includes(' | ')) {
+        return 'enum';
+    }
+    return null;
+}
+/**
+ * Check if a value matches an expected type
+ */
+function checkType(value, expectedType) {
+    switch (expectedType) {
+        case 'string':
+            return typeof value === 'string';
+        case 'number':
+        case 'integer':
+            return typeof value === 'number';
+        case 'boolean':
+            return typeof value === 'boolean';
+        case 'array':
+            return Array.isArray(value);
+        case 'object':
+            return typeof value === 'object' && value !== null && !Array.isArray(value);
+        case 'date':
+            return typeof value === 'string' || value instanceof Date;
+        case 'enum':
+            return typeof value === 'string';
+        default:
+            return true;
+    }
+}
+/**
+ * Check if all required props are present
+ */
+export function hasRequiredProps(props, required) {
+    return required.every((key) => props[key] !== undefined);
+}
+/**
+ * Get list of missing required props
+ */
+export function getMissingProps(props, required) {
+    return required.filter((key) => props[key] === undefined);
+}
+/**
+ * Check if props are complete according to schema
+ */
+export function isComplete(props, schema) {
+    if (typeof schema === 'string') {
+        return props['value'] !== undefined;
+    }
+    return Object.keys(schema).every((key) => props[key] !== undefined);
+}
+/**
+ * Get list of missing props according to schema
+ */
+export function getMissingFromSchema(props, schema) {
+    if (typeof schema === 'string') {
+        return props['value'] === undefined ? ['value'] : [];
+    }
+    return Object.keys(schema).filter((key) => props[key] === undefined);
+}
+/**
+ * Sanitize props by removing extra keys not in schema
+ */
+export function sanitizeProps(props, schema) {
+    if (typeof schema === 'string') {
+        return { value: props['value'] };
+    }
+    const schemaKeys = new Set(Object.keys(schema));
+    const sanitized = {};
+    for (const [key, value] of Object.entries(props)) {
+        if (schemaKeys.has(key)) {
+            sanitized[key] = value;
+        }
+    }
+    return sanitized;
+}
+/**
+ * Merge props with defaults, respecting schema types
+ */
+export function mergeWithDefaults(props, defaults, schema) {
+    const result = { ...defaults, ...props };
+    // Ensure types match schema
+    if (typeof schema !== 'string') {
+        for (const [key, schemaDef] of Object.entries(schema)) {
+            if (result[key] === undefined)
+                continue;
+            const expectedType = typeof schemaDef === 'string' ? extractTypeFromSchema(schemaDef) : null;
+            if (expectedType) {
+                result[key] = coerceType(result[key], expectedType);
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Attempt to coerce a value to an expected type
+ */
+function coerceType(value, expectedType) {
+    if (value === undefined || value === null)
+        return value;
+    switch (expectedType) {
+        case 'string':
+            return String(value);
+        case 'number':
+            return typeof value === 'number' ? value : Number(value);
+        case 'integer':
+            return typeof value === 'number' ? Math.floor(value) : parseInt(String(value), 10);
+        case 'boolean':
+            return Boolean(value);
+        default:
+            return value;
+    }
+}
+/**
+ * Create a props validator function
+ */
+export function createValidator(schema) {
+    return (props) => validateProps(props, schema);
+}
+/**
+ * Assert props are valid, throwing on error
+ */
+export function assertValidProps(props, schema) {
+    const result = validateProps(props, schema);
+    if (!result.valid) {
+        const messages = result.errors.map((e) => `${e.path}: ${e.message}`).join(', ');
+        throw new Error(`Invalid props: ${messages}`);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

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

package/dist/worker.d.ts

@@ -0,0 +1,270 @@
+/**
+ * Worker Export - WorkerEntrypoint for RPC access to AI Props
+ *
+ * Exposes AI props generation methods via Cloudflare RPC.
+ * Provides schema-based prop generation, caching, validation,
+ * and cascade execution patterns.
+ *
+ * ## Features
+ *
+ * - **RPC Service**: WorkerEntrypoint for service binding access
+ * - **Cascade Execution**: Code -> Generative -> Agentic -> Human escalation
+ * - **Durable Cascades**: Cloudflare Workflows integration for durability
+ * - **AI Gateway**: Configuration helpers for Cloudflare AI Gateway
+ *
+ * @example
+ * ```typescript
+ * // wrangler.jsonc
+ * {
+ *   "services": [
+ *     { "binding": "AI_PROPS", "service": "ai-props" }
+ *   ]
+ * }
+ *
+ * // worker.ts - consuming service
+ * export default {
+ *   async fetch(request: Request, env: Env) {
+ *     const service = env.AI_PROPS.connect()
+ *     const result = await service.generate({
+ *       schema: { title: 'Page title', description: 'Page description' },
+ *       context: { topic: 'AI' }
+ *     })
+ *     return Response.json(result.props)
+ *   }
+ * }
+ * ```
+ *
+ * ## Cascade Pattern
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   DurableCascadeExecutor,
+ *   createDurableCascadeStep,
+ *   createAIGatewayConfig
+ * } from 'ai-props/worker'
+ *
+ * // Create a durable cascade for content generation
+ * const contentCascade = createDurableCascadeStep({
+ *   name: 'generate-content',
+ *   code: async (input) => {
+ *     if (input.template) return { content: input.template }
+ *     throw new Error('No template available')
+ *   },
+ *   generative: async (input, ctx) => {
+ *     const result = await ctx.ai.run('@cf/meta/llama-3-8b-instruct', {
+ *       messages: [{ role: 'user', content: `Generate content about: ${input.topic}` }]
+ *     })
+ *     return { content: result.response }
+ *   }
+ * })
+ *
+ * // In a Cloudflare Workflow
+ * const result = await contentCascade.run(step, { topic: 'AI' })
+ * console.log(result.tier) // 'code' or 'generative'
+ * ```
+ *
+ * @packageDocumentation
+ */
+import { WorkerEntrypoint, RpcTarget } from 'cloudflare:workers';
+import type { PropSchema, GeneratePropsOptions, GeneratePropsResult, AIPropsConfig, PropsCacheEntry, ValidationResult } from './types.js';
+/**
+ * Environment bindings for the worker
+ */
+export interface Env {
+    AI?: unknown;
+}
+/**
+ * PropsServiceCore - RpcTarget wrapper for AI props functionality
+ *
+ * Exposes all required methods as RPC-callable methods.
+ * This is the core service class that can be instantiated directly.
+ */
+export declare class PropsServiceCore extends RpcTarget {
+    private cache;
+    constructor();
+    /**
+     * Generate props using AI
+     *
+     * @example
+     * ```ts
+     * const result = await service.generate({
+     *   schema: {
+     *     title: 'A compelling page title',
+     *     description: 'A brief description',
+     *   },
+     *   context: { topic: 'AI-powered applications' },
+     * })
+     * ```
+     */
+    generate<T = Record<string, unknown>>(options: GeneratePropsOptions): Promise<GeneratePropsResult<T>>;
+    /**
+     * Generate props synchronously from cache
+     *
+     * @throws {Error} If props are not in cache
+     */
+    getSync<T = Record<string, unknown>>(schema: PropSchema, context?: Record<string, unknown>): T;
+    /**
+     * Pre-generate props for warming the cache
+     */
+    prefetch(requests: GeneratePropsOptions[]): Promise<void>;
+    /**
+     * Generate multiple prop sets in parallel
+     */
+    generateMany<T = Record<string, unknown>>(requests: GeneratePropsOptions[]): Promise<GeneratePropsResult<T>[]>;
+    /**
+     * Merge partial props with generated props
+     *
+     * Generates only the missing props, keeping provided ones.
+     */
+    mergeWithGenerated<T extends Record<string, unknown>>(schema: PropSchema, partialProps: Partial<T>, options?: Omit<GeneratePropsOptions, 'schema' | 'context'>): Promise<T>;
+    /**
+     * Configure global AI props settings
+     */
+    configure(config: Partial<AIPropsConfig>): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): AIPropsConfig;
+    /**
+     * Reset configuration to defaults
+     */
+    resetConfig(): void;
+    /**
+     * Get cached props by key
+     */
+    getCached<T>(key: string): PropsCacheEntry<T> | undefined;
+    /**
+     * Set props in cache
+     */
+    setCached<T>(key: string, props: T): void;
+    /**
+     * Delete cached entry by key
+     */
+    deleteCached(key: string): boolean;
+    /**
+     * Clear all cached props
+     */
+    clearCache(): void;
+    /**
+     * Get cache size
+     */
+    getCacheSize(): number;
+    /**
+     * Create a cache key from schema and context
+     */
+    createCacheKey(schema: PropSchema, context?: Record<string, unknown>): string;
+    /**
+     * Configure cache TTL
+     */
+    configureCache(ttl: number): void;
+    /**
+     * Validate props against a schema
+     */
+    validate(props: Record<string, unknown>, schema: PropSchema): ValidationResult;
+    /**
+     * Check if all required props are present
+     */
+    hasRequired(props: Record<string, unknown>, required: string[]): boolean;
+    /**
+     * Get list of missing props according to schema
+     */
+    getMissing(props: Record<string, unknown>, schema: PropSchema): string[];
+    /**
+     * Check if props are complete according to schema
+     */
+    isComplete(props: Record<string, unknown>, schema: PropSchema): boolean;
+    /**
+     * Sanitize props by removing unknown keys
+     */
+    sanitize<T extends Record<string, unknown>>(props: T, schema: PropSchema): Partial<T>;
+    /**
+     * Merge props with default values
+     */
+    mergeDefaults<T extends Record<string, unknown>>(props: Partial<T>, defaults: Partial<T>, schema: PropSchema): Partial<T>;
+}
+/**
+ * PropsService - WorkerEntrypoint for RPC access
+ *
+ * Provides `connect()` method that returns an RpcTarget service
+ * with all AI props methods. Also handles HTTP endpoints for
+ * direct JSON-RPC access.
+ *
+ * @example
+ * ```typescript
+ * // In consuming worker
+ * const service = env.AI_PROPS.connect()
+ * const result = await service.generate({
+ *   schema: { title: 'Page title' }
+ * })
+ * ```
+ */
+export declare class PropsService extends WorkerEntrypoint<Env> {
+    private serviceCore;
+    /**
+     * Get or create the service core instance
+     */
+    private getServiceCore;
+    /**
+     * Get a connected service instance for RPC calls
+     *
+     * Note: Named 'getService' instead of 'connect' because 'connect'
+     * is a reserved method name in Cloudflare Workers RPC (used for sockets).
+     *
+     * @returns PropsServiceCore instance for RPC calls
+     */
+    getService(): PropsServiceCore;
+    /**
+     * Alias for getService() - provides the connect() interface
+     * Note: This may conflict with the Fetcher's connect() for sockets
+     * when accessed via service bindings. Use getService() instead.
+     *
+     * @deprecated Use getService() instead
+     * @returns PropsServiceCore instance for RPC calls
+     */
+    connect(): PropsServiceCore;
+    /**
+     * HTTP request handler for JSON-RPC and service info endpoints
+     *
+     * Routes:
+     * - GET / - Returns service info
+     * - POST /rpc - JSON-RPC endpoint for calling service methods
+     */
+    fetch(request: Request): Promise<Response>;
+}
+/**
+ * Default export for Cloudflare Workers
+ */
+export default PropsService;
+/**
+ * Export aliases
+ */
+export { PropsService as PropsWorker };
+export { CascadeExecutor, createCascadeStep, type CascadeConfig, type CascadeResult, type CascadeContext, type TierContext, type TierHandler, type TierResult, type CapabilityTier, type FiveWHEvent, type TierRetryConfig, type SkipCondition, type CascadeMetrics, type CascadeStep, TIER_ORDER, DEFAULT_TIER_TIMEOUTS, CascadeTimeoutError, TierSkippedError, AllTiersFailedError, createCascadeContext, recordStep, } from './cascade.js';
+export { DurableCascadeExecutor, createDurableCascadeStep, createAIGatewayConfig, type DurableCascadeConfig, type DurableCascadeTierContext, type DurableStepConfig, type DurableRetryConfig, type WorkflowStep, type AiBinding, type HumanReviewRequest, type AIGatewayConfig, type CodeTierHandler, type AiTierHandler, type HumanTierHandler, } from './durable-cascade.js';
+/**
+ * Event System exports for Queue-based event handling
+ *
+ * @example
+ * ```typescript
+ * import { EventBridge, createQueueHandler } from 'ai-props/worker'
+ *
+ * const bridge = new EventBridge(env.MY_QUEUE)
+ * bridge.on('user.created', async (data) => {
+ *   console.log('User created:', data.id)
+ * })
+ *
+ * export default {
+ *   async fetch(request, env) {
+ *     await bridge.emit('user.created', { id: '123' })
+ *     return new Response('OK')
+ *   },
+ *   async queue(batch, env) {
+ *     const handler = createQueueHandler(bridge)
+ *     await handler.queue(batch, env)
+ *   }
+ * }
+ * ```
+ */
+export { EventBridge, createQueueHandler, createEventBridge, type QueuedEvent, type EventBridgeConfig, type EventHandler, type EmitOptions, type Queue, type QueueMessage, type MessageBatch, type TypedEventBridge, } from './event-bridge.js';
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

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