ai-props 2.1.3 → 2.3.0

package/dist/validate.js

@@ -1,253 +0,0 @@
-/**
- * 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

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

package/src/ai.js

@@ -1,198 +0,0 @@
-/**
- * AI() wrapper for components with intelligent prop generation
- *
- * The AI() function wraps a component definition and automatically
- * generates missing props using AI when the component is rendered.
- *
- * @packageDocumentation
- */
-import { mergeWithGenerated } from './generate.js';
-/**
- * Create an AI-powered component wrapper
- *
- * The returned function accepts partial props and generates
- * any missing props using AI based on the schema.
- *
- * @example
- * ```ts
- * const UserCard = AI({
- *   schema: {
- *     name: 'Full name of the user',
- *     bio: 'A short biography',
- *     avatar: 'URL to avatar image',
- *   },
- *   defaults: {
- *     avatar: 'https://example.com/default-avatar.png',
- *   },
- * })
- *
- * // Generate all props
- * const props = await UserCard({})
- *
- * // Generate only missing props
- * const props2 = await UserCard({ name: 'John Doe' })
- * ```
- */
-export function AI(options) {
-    const { schema, defaults = {}, required = [], exclude = [], config = {} } = options;
-    // Build filtered schema (exclude specified props)
-    const filteredSchema = filterSchema(schema, exclude);
-    /**
-     * The AI component function
-     */
-    const aiComponent = async (partialProps) => {
-        // Merge with defaults
-        const propsWithDefaults = { ...defaults, ...partialProps };
-        // Check if all required props are provided
-        const missingRequired = required.filter(key => propsWithDefaults[key] === undefined);
-        if (missingRequired.length > 0) {
-            throw new Error(`Missing required props: ${missingRequired.join(', ')}`);
-        }
-        // Generate missing props
-        const fullProps = await mergeWithGenerated(filteredSchema, propsWithDefaults, {
-            model: config.model,
-            system: config.system,
-        });
-        return fullProps;
-    };
-    // Attach metadata
-    aiComponent.schema = schema;
-    aiComponent.config = config;
-    // Attach helper method
-    aiComponent.generateProps = async (context) => {
-        return aiComponent(context || {});
-    };
-    return aiComponent;
-}
-/**
- * Filter schema to exclude certain keys
- */
-function filterSchema(schema, exclude) {
-    if (typeof schema === 'string') {
-        return schema;
-    }
-    const filtered = {};
-    for (const [key, value] of Object.entries(schema)) {
-        if (!exclude.includes(key)) {
-            filtered[key] = value;
-        }
-    }
-    return filtered;
-}
-/**
- * Create a typed AI component with inference
- *
- * @example
- * ```ts
- * const ProductCard = createAIComponent<{
- *   title: string
- *   price: number
- *   description: string
- * }>({
- *   schema: {
- *     title: 'Product title',
- *     price: 'Price in USD (number)',
- *     description: 'Product description',
- *   },
- * })
- * ```
- */
-export function createAIComponent(options) {
-    return AI(options);
-}
-/**
- * Define props schema with type inference
- *
- * @example
- * ```ts
- * const userSchema = definePropsSchema({
- *   name: 'User name',
- *   email: 'Email address',
- *   age: 'Age (number)',
- * })
- * ```
- */
-export function definePropsSchema(schema) {
-    return schema;
-}
-/**
- * Create a component factory for generating multiple instances
- *
- * @example
- * ```ts
- * const factory = createComponentFactory({
- *   schema: { name: 'Product name', price: 'Price (number)' },
- * })
- *
- * const products = await factory.generateMany([
- *   { category: 'electronics' },
- *   { category: 'clothing' },
- *   { category: 'food' },
- * ])
- * ```
- */
-export function createComponentFactory(options) {
-    const component = AI(options);
-    return {
-        component,
-        schema: options.schema,
-        /**
-         * Generate a single instance
-         */
-        generate: (context) => component(context || {}),
-        /**
-         * Generate multiple instances
-         */
-        generateMany: async (contexts) => {
-            return Promise.all(contexts.map(ctx => component(ctx)));
-        },
-        /**
-         * Generate with specific overrides
-         */
-        generateWith: async (context, overrides) => {
-            const generated = await component(context);
-            return { ...generated, ...overrides };
-        },
-    };
-}
-/**
- * Compose multiple AI components
- *
- * Creates a component that combines props from multiple schemas.
- *
- * @example
- * ```ts
- * const FullProfile = composeAIComponents({
- *   user: userSchema,
- *   settings: settingsSchema,
- *   preferences: preferencesSchema,
- * })
- *
- * const profile = await FullProfile({
- *   user: { name: 'John' },
- *   settings: {},
- *   preferences: { theme: 'dark' },
- * })
- * ```
- */
-export function composeAIComponents(components) {
-    const aiComponent = async (partialProps) => {
-        const results = {};
-        // Generate each component's props
-        await Promise.all(Object.entries(components).map(async ([key, options]) => {
-            const component = AI(options);
-            const partial = partialProps[key] || {};
-            results[key] = await component(partial);
-        }));
-        return results;
-    };
-    // Compose schemas
-    const composedSchema = {};
-    for (const [key, options] of Object.entries(components)) {
-        composedSchema[key] = options.schema;
-    }
-    aiComponent.schema = composedSchema;
-    aiComponent.config = {};
-    aiComponent.generateProps = (context) => aiComponent(context || {});
-    return aiComponent;
-}

package/src/cache.js

@@ -1,182 +0,0 @@
-/**
- * Props caching for ai-props
- *
- * Provides in-memory caching for generated props to avoid
- * redundant AI calls with the same context.
- *
- * @packageDocumentation
- */
-/**
- * Default cache TTL (5 minutes)
- */
-export const DEFAULT_CACHE_TTL = 5 * 60 * 1000;
-/**
- * Create a cache key from schema and context
- */
-export function createCacheKey(schema, context) {
-    const schemaStr = typeof schema === 'string' ? schema : JSON.stringify(schema);
-    const contextStr = context ? JSON.stringify(sortObject(context)) : '';
-    return `${hashString(schemaStr)}:${hashString(contextStr)}`;
-}
-/**
- * Simple string hash function
- */
-function hashString(str) {
-    let hash = 0;
-    for (let i = 0; i < str.length; i++) {
-        const char = str.charCodeAt(i);
-        hash = ((hash << 5) - hash) + char;
-        hash = hash & hash; // Convert to 32-bit integer
-    }
-    return hash.toString(36);
-}
-/**
- * Sort object keys for consistent hashing
- */
-function sortObject(obj) {
-    const sorted = {};
-    for (const key of Object.keys(obj).sort()) {
-        const value = obj[key];
-        sorted[key] = value && typeof value === 'object' && !Array.isArray(value)
-            ? sortObject(value)
-            : value;
-    }
-    return sorted;
-}
-/**
- * In-memory props cache implementation
- */
-export class MemoryPropsCache {
-    cache = new Map();
-    ttl;
-    constructor(ttl = DEFAULT_CACHE_TTL) {
-        this.ttl = ttl;
-    }
-    get(key) {
-        const entry = this.cache.get(key);
-        if (!entry)
-            return undefined;
-        // Check if expired
-        if (Date.now() - entry.timestamp > this.ttl) {
-            this.cache.delete(key);
-            return undefined;
-        }
-        return entry;
-    }
-    set(key, props) {
-        this.cache.set(key, {
-            props,
-            timestamp: Date.now(),
-            key
-        });
-    }
-    delete(key) {
-        return this.cache.delete(key);
-    }
-    clear() {
-        this.cache.clear();
-    }
-    get size() {
-        return this.cache.size;
-    }
-    /**
-     * Remove expired entries
-     */
-    cleanup() {
-        const now = Date.now();
-        let removed = 0;
-        for (const [key, entry] of this.cache) {
-            if (now - entry.timestamp > this.ttl) {
-                this.cache.delete(key);
-                removed++;
-            }
-        }
-        return removed;
-    }
-    /**
-     * Get all entries (for debugging)
-     */
-    entries() {
-        return this.cache.entries();
-    }
-}
-/**
- * Global default cache instance
- */
-let defaultCache = null;
-/**
- * Get or create the default cache
- */
-export function getDefaultCache() {
-    if (!defaultCache) {
-        defaultCache = new MemoryPropsCache();
-    }
-    return defaultCache;
-}
-/**
- * Configure the default cache
- */
-export function configureCache(ttl) {
-    defaultCache = new MemoryPropsCache(ttl);
-}
-/**
- * Clear the default cache
- */
-export function clearCache() {
-    if (defaultCache) {
-        defaultCache.clear();
-    }
-}
-/**
- * LRU (Least Recently Used) cache implementation
- * For scenarios where memory usage needs to be bounded
- */
-export class LRUPropsCache {
-    cache = new Map();
-    maxSize;
-    ttl;
-    constructor(maxSize = 100, ttl = DEFAULT_CACHE_TTL) {
-        this.maxSize = maxSize;
-        this.ttl = ttl;
-    }
-    get(key) {
-        const entry = this.cache.get(key);
-        if (!entry)
-            return undefined;
-        // Check if expired
-        if (Date.now() - entry.timestamp > this.ttl) {
-            this.cache.delete(key);
-            return undefined;
-        }
-        // Move to end (most recently used)
-        this.cache.delete(key);
-        this.cache.set(key, entry);
-        return entry;
-    }
-    set(key, props) {
-        // Remove oldest entries if at capacity
-        while (this.cache.size >= this.maxSize) {
-            const oldest = this.cache.keys().next().value;
-            if (oldest) {
-                this.cache.delete(oldest);
-            }
-            else {
-                break;
-            }
-        }
-        this.cache.set(key, {
-            props,
-            timestamp: Date.now(),
-            key
-        });
-    }
-    delete(key) {
-        return this.cache.delete(key);
-    }
-    clear() {
-        this.cache.clear();
-    }
-    get size() {
-        return this.cache.size;
-    }
-}