ai-props 2.3.0 → 2.4.0

package/dist/generate.js

@@ -0,0 +1,227 @@
+/**
+ * Props generation for ai-props
+ *
+ * Core functionality for generating component props using AI.
+ *
+ * @packageDocumentation
+ */
+import { generateObject, schema as createSchema } from 'ai-functions';
+import { createCacheKey, getDefaultCache } from './cache.js';
+/**
+ * Default configuration
+ * Note: Use full model ID to avoid alias resolution issues in bundled environments
+ */
+const DEFAULT_CONFIG = {
+    model: 'anthropic/claude-sonnet-4.5',
+    cache: true,
+    cacheTTL: 5 * 60 * 1000, // 5 minutes
+};
+/**
+ * Global configuration
+ */
+let globalConfig = { ...DEFAULT_CONFIG };
+/**
+ * Configure global AI props settings
+ */
+export function configureAIProps(config) {
+    globalConfig = { ...globalConfig, ...config };
+}
+/**
+ * Get current configuration
+ */
+export function getConfig() {
+    return { ...globalConfig };
+}
+/**
+ * Reset configuration to defaults
+ */
+export function resetConfig() {
+    globalConfig = { ...DEFAULT_CONFIG };
+}
+/**
+ * Resolve a prop schema to a SimpleSchema
+ *
+ * If the schema is a string, it's treated as a named type
+ * that generates a single property or description.
+ */
+function resolveSchema(schema) {
+    if (typeof schema === 'string') {
+        // Named type or description string
+        return { value: schema };
+    }
+    return schema;
+}
+/**
+ * Build a prompt from context and schema
+ */
+function buildPrompt(schema, context, additionalPrompt) {
+    const parts = [];
+    // Add context information
+    if (context && Object.keys(context).length > 0) {
+        parts.push('Given the following context:');
+        parts.push(JSON.stringify(context, null, 2));
+        parts.push('');
+    }
+    // Add schema information
+    if (typeof schema === 'string') {
+        parts.push(`Generate a value for: ${schema}`);
+    }
+    else {
+        parts.push('Generate props matching the schema.');
+    }
+    // Add additional prompt
+    if (additionalPrompt) {
+        parts.push('');
+        parts.push(additionalPrompt);
+    }
+    return parts.join('\n');
+}
+/**
+ * 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 async function generateProps(options) {
+    const { schema, context, prompt, model, system } = options;
+    const config = getConfig();
+    const startTime = Date.now();
+    // Check cache
+    if (config.cache) {
+        const cache = getDefaultCache();
+        const cacheKey = createCacheKey(schema, context);
+        const cached = cache.get(cacheKey);
+        if (cached) {
+            return {
+                props: cached.props,
+                cached: true,
+                metadata: {
+                    model: config.model || 'cached',
+                },
+            };
+        }
+    }
+    // Resolve schema
+    const resolvedSchema = resolveSchema(schema);
+    // Build prompt
+    const fullPrompt = buildPrompt(schema, context, prompt);
+    // Use custom generator if provided
+    if (config.generate) {
+        const props = await config.generate(resolvedSchema, context || {});
+        return {
+            props,
+            cached: false,
+            metadata: {
+                model: 'custom',
+                duration: Date.now() - startTime,
+            },
+        };
+    }
+    // Generate using AI
+    const effectiveModel = model ?? config.model ?? DEFAULT_CONFIG.model;
+    const result = await generateObject({
+        model: effectiveModel,
+        schema: resolvedSchema,
+        prompt: fullPrompt,
+        ...(system !== undefined
+            ? { system }
+            : config.system !== undefined
+                ? { system: config.system }
+                : {}),
+    });
+    const props = result.object;
+    // Cache result
+    if (config.cache) {
+        const cache = getDefaultCache();
+        const cacheKey = createCacheKey(schema, context);
+        cache.set(cacheKey, props);
+    }
+    return {
+        props,
+        cached: false,
+        metadata: {
+            model: effectiveModel,
+            duration: Date.now() - startTime,
+        },
+    };
+}
+/**
+ * Generate props synchronously from cache or throw
+ *
+ * Useful for SSR scenarios where async isn't available.
+ * Throws if props aren't in cache.
+ */
+export function getPropsSync(schema, context) {
+    const cache = getDefaultCache();
+    const cacheKey = createCacheKey(schema, context);
+    const cached = cache.get(cacheKey);
+    if (!cached) {
+        throw new Error('Props not in cache. Use generateProps() first or ensure caching is enabled.');
+    }
+    return cached.props;
+}
+/**
+ * Pre-generate props for warming the cache
+ *
+ * @example
+ * ```ts
+ * await prefetchProps([
+ *   { schema: userProfileSchema, context: { userId: '123' } },
+ *   { schema: productSchema, context: { category: 'electronics' } },
+ * ])
+ * ```
+ */
+export async function prefetchProps(requests) {
+    await Promise.all(requests.map(generateProps));
+}
+/**
+ * Generate multiple prop sets in parallel
+ */
+export async function generatePropsMany(requests) {
+    return Promise.all(requests.map((req) => generateProps(req)));
+}
+/**
+ * Merge partial props with generated props
+ *
+ * Generates only the missing props, keeping provided ones.
+ */
+export async function mergeWithGenerated(schema, partialProps, options) {
+    // Get list of missing keys
+    const schemaObj = typeof schema === 'string' ? { value: schema } : schema;
+    const schemaKeys = Object.keys(schemaObj);
+    const providedKeys = Object.keys(partialProps);
+    const missingKeys = schemaKeys.filter((k) => !providedKeys.includes(k));
+    // If all props are provided, return as-is
+    if (missingKeys.length === 0) {
+        return partialProps;
+    }
+    // Build partial schema for missing props only
+    const partialSchema = {};
+    for (const key of missingKeys) {
+        partialSchema[key] = schemaObj[key];
+    }
+    // Generate missing props
+    const result = await generateProps({
+        schema: partialSchema,
+        context: partialProps,
+        ...options,
+    });
+    // Merge
+    return {
+        ...result.props,
+        ...partialProps,
+    };
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

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

package/dist/hoc.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Higher-Order Component (HOC) for React components
+ *
+ * Provides withAIProps HOC for wrapping React components
+ * with AI-powered prop generation.
+ *
+ * @packageDocumentation
+ */
+import type { PropSchema, AIComponentOptions, AIPropsConfig } from './types.js';
+/**
+ * Options for withAIProps HOC
+ */
+export interface WithAIPropsOptions<P> extends Omit<AIComponentOptions<P>, 'schema'> {
+    /** Schema for props to generate */
+    schema: PropSchema;
+    /** Loading component to show while generating */
+    loading?: () => unknown;
+    /** Error component to show on generation failure */
+    error?: (error: Error) => unknown;
+    /** Fallback props to use if generation fails */
+    fallback?: Partial<P>;
+}
+/**
+ * Create props wrapper that can be used with any component system
+ *
+ * This is framework-agnostic and returns the enhanced props.
+ *
+ * @example
+ * ```ts
+ * const enhancer = createPropsEnhancer({
+ *   schema: {
+ *     title: 'Page title',
+ *     description: 'Page description',
+ *   },
+ *   defaults: {
+ *     title: 'Default Title',
+ *   },
+ * })
+ *
+ * // Use with any component
+ * const props = await enhancer({ description: 'My page' })
+ * // { title: 'Default Title', description: 'My page' }
+ *
+ * const generatedProps = await enhancer({})
+ * // { title: 'AI-generated title', description: 'AI-generated description' }
+ * ```
+ */
+export declare function createPropsEnhancer<P extends Record<string, unknown>>(options: WithAIPropsOptions<P>): (partialProps: Partial<P>) => Promise<P>;
+/**
+ * Create an async props provider
+ *
+ * Returns a function that generates props on each call.
+ * Useful for SSR and static generation.
+ *
+ * @example
+ * ```ts
+ * const getPageProps = createAsyncPropsProvider({
+ *   schema: {
+ *     title: 'SEO-optimized page title',
+ *     meta: { description: 'Meta description' },
+ *   },
+ * })
+ *
+ * // In getStaticProps or getServerSideProps
+ * export async function getStaticProps() {
+ *   const props = await getPageProps({ slug: 'about' })
+ *   return { props }
+ * }
+ * ```
+ */
+export declare function createAsyncPropsProvider<P extends Record<string, unknown>>(options: WithAIPropsOptions<P>): {
+    /**
+     * Get props with AI generation
+     */
+    getProps: (partialProps: Partial<P>) => Promise<P>;
+    /**
+     * Get props for multiple items
+     */
+    getManyProps: (contexts: Partial<P>[]) => Promise<P[]>;
+    /**
+     * Get props with caching hint
+     */
+    getCachedProps: (context: Partial<P>, revalidate?: number) => Promise<{
+        props: P;
+        revalidate?: number;
+    }>;
+};
+/**
+ * Create a props transformer
+ *
+ * Transforms existing props by filling in missing values.
+ *
+ * @example
+ * ```ts
+ * const transformUserProps = createPropsTransformer({
+ *   schema: {
+ *     displayName: 'Display name for the user',
+ *     initials: 'User initials (2 letters)',
+ *   },
+ * })
+ *
+ * const user = await transformUserProps({
+ *   username: 'johndoe',
+ *   email: 'john@example.com',
+ * })
+ * // { username: 'johndoe', email: '...', displayName: 'John Doe', initials: 'JD' }
+ * ```
+ */
+export declare function createPropsTransformer<I extends Record<string, unknown>, O extends Record<string, unknown>>(options: {
+    schema: PropSchema;
+    transform?: (input: I, generated: Record<string, unknown>) => O;
+    config?: AIPropsConfig;
+}): (input: I) => Promise<I & O>;
+/**
+ * Create a conditional props generator
+ *
+ * Only generates props when a condition is met.
+ *
+ * @example
+ * ```ts
+ * const maybeGenerateProps = createConditionalGenerator({
+ *   schema: { summary: 'Article summary' },
+ *   condition: (props) => !props.summary && props.content?.length > 100,
+ * })
+ * ```
+ */
+export declare function createConditionalGenerator<P extends Record<string, unknown>>(options: {
+    schema: PropSchema;
+    condition: (props: Partial<P>) => boolean;
+    config?: AIPropsConfig;
+}): (props: Partial<P>) => Promise<P>;
+/**
+ * Batch props generator for list rendering
+ *
+ * Efficiently generates props for multiple items.
+ *
+ * @example
+ * ```ts
+ * const batchGenerator = createBatchGenerator({
+ *   schema: { title: 'Item title', description: 'Item description' },
+ * })
+ *
+ * const items = await batchGenerator.generate([
+ *   { id: 1, category: 'tech' },
+ *   { id: 2, category: 'science' },
+ *   { id: 3, category: 'art' },
+ * ])
+ * ```
+ */
+export declare function createBatchGenerator<P extends Record<string, unknown>>(options: {
+    schema: PropSchema;
+    concurrency?: number;
+    config?: AIPropsConfig;
+}): {
+    /**
+     * Generate props for multiple items
+     */
+    generate: (items: Partial<P>[]) => Promise<P[]>;
+    /**
+     * Generate props one at a time (for rate limiting)
+     */
+    generateSequential: (items: Partial<P>[]) => Promise<P[]>;
+};
+//# sourceMappingURL=hoc.d.ts.map

package/dist/hoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hoc.d.ts","sourceRoot":"","sources":["../src/hoc.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG/E;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,CAAE,SAAQ,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC;IAClF,mCAAmC;IACnC,MAAM,EAAE,UAAU,CAAA;IAClB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,OAAO,CAAA;IACvB,oDAAoD;IACpD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAA;IACjC,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,IAIhB,cAAc,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAAC,CA4BpD;AAmBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAK5B;;OAEG;;IAGH;;OAEG;6BAC4B,OAAO,CAAC,CAAC,CAAC,EAAE,KAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAI1D;;OAEG;8BAEQ,OAAO,CAAC,CAAC,CAAC,eACN,MAAM,KAClB,OAAO,CAAC;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;EAKhD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CACpC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE;IACT,MAAM,EAAE,UAAU,CAAA;IAClB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IAC/D,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB,IAGe,OAAO,CAAC,KAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAgBxC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE;IACrF,MAAM,EAAE,UAAU,CAAA;IAClB,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAA;IACzC,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB,IAGe,OAAO,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAAC,CAU7C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE;IAC/E,MAAM,EAAE,UAAU,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB;IAIG;;OAEG;sBACqB,OAAO,CAAC,CAAC,CAAC,EAAE,KAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAoBnD;;OAEG;gCAC+B,OAAO,CAAC,CAAC,CAAC,EAAE,KAAG,OAAO,CAAC,CAAC,EAAE,CAAC;EAchE"}

package/dist/hoc.js

@@ -0,0 +1,236 @@
+/**
+ * Higher-Order Component (HOC) for React components
+ *
+ * Provides withAIProps HOC for wrapping React components
+ * with AI-powered prop generation.
+ *
+ * @packageDocumentation
+ */
+import { generateProps, mergeWithGenerated } from './generate.js';
+/**
+ * Create props wrapper that can be used with any component system
+ *
+ * This is framework-agnostic and returns the enhanced props.
+ *
+ * @example
+ * ```ts
+ * const enhancer = createPropsEnhancer({
+ *   schema: {
+ *     title: 'Page title',
+ *     description: 'Page description',
+ *   },
+ *   defaults: {
+ *     title: 'Default Title',
+ *   },
+ * })
+ *
+ * // Use with any component
+ * const props = await enhancer({ description: 'My page' })
+ * // { title: 'Default Title', description: 'My page' }
+ *
+ * const generatedProps = await enhancer({})
+ * // { title: 'AI-generated title', description: 'AI-generated description' }
+ * ```
+ */
+export function createPropsEnhancer(options) {
+    const { schema, defaults = {}, required = [], exclude = [], config = {}, fallback } = options;
+    return async (partialProps) => {
+        try {
+            // Merge with defaults
+            const propsWithDefaults = { ...defaults, ...partialProps };
+            // Check required props
+            const missingRequired = required.filter((key) => propsWithDefaults[key] === undefined);
+            if (missingRequired.length > 0) {
+                throw new Error(`Missing required props: ${missingRequired.join(', ')}`);
+            }
+            // Filter out excluded props from schema
+            const filteredSchema = filterSchemaKeys(schema, exclude);
+            // Generate missing props
+            return await mergeWithGenerated(filteredSchema, propsWithDefaults, {
+                ...(config.model !== undefined && { model: config.model }),
+                ...(config.system !== undefined && { system: config.system }),
+            });
+        }
+        catch (error) {
+            if (fallback) {
+                return { ...defaults, ...fallback, ...partialProps };
+            }
+            throw error;
+        }
+    };
+}
+/**
+ * Filter schema to exclude certain keys
+ */
+function filterSchemaKeys(schema, exclude) {
+    if (typeof schema === 'string' || exclude.length === 0) {
+        return schema;
+    }
+    const filtered = {};
+    for (const [key, value] of Object.entries(schema)) {
+        if (!exclude.includes(key)) {
+            filtered[key] = value;
+        }
+    }
+    return filtered;
+}
+/**
+ * Create an async props provider
+ *
+ * Returns a function that generates props on each call.
+ * Useful for SSR and static generation.
+ *
+ * @example
+ * ```ts
+ * const getPageProps = createAsyncPropsProvider({
+ *   schema: {
+ *     title: 'SEO-optimized page title',
+ *     meta: { description: 'Meta description' },
+ *   },
+ * })
+ *
+ * // In getStaticProps or getServerSideProps
+ * export async function getStaticProps() {
+ *   const props = await getPageProps({ slug: 'about' })
+ *   return { props }
+ * }
+ * ```
+ */
+export function createAsyncPropsProvider(options) {
+    const enhancer = createPropsEnhancer(options);
+    return {
+        /**
+         * Get props with AI generation
+         */
+        getProps: enhancer,
+        /**
+         * Get props for multiple items
+         */
+        getManyProps: async (contexts) => {
+            return Promise.all(contexts.map(enhancer));
+        },
+        /**
+         * Get props with caching hint
+         */
+        getCachedProps: async (context, revalidate) => {
+            const props = await enhancer(context);
+            return { props, ...(revalidate !== undefined && { revalidate }) };
+        },
+    };
+}
+/**
+ * Create a props transformer
+ *
+ * Transforms existing props by filling in missing values.
+ *
+ * @example
+ * ```ts
+ * const transformUserProps = createPropsTransformer({
+ *   schema: {
+ *     displayName: 'Display name for the user',
+ *     initials: 'User initials (2 letters)',
+ *   },
+ * })
+ *
+ * const user = await transformUserProps({
+ *   username: 'johndoe',
+ *   email: 'john@example.com',
+ * })
+ * // { username: 'johndoe', email: '...', displayName: 'John Doe', initials: 'JD' }
+ * ```
+ */
+export function createPropsTransformer(options) {
+    const { schema, transform, config = {} } = options;
+    return async (input) => {
+        const result = await generateProps({
+            schema,
+            context: input,
+            ...(config.model !== undefined && { model: config.model }),
+            ...(config.system !== undefined && { system: config.system }),
+        });
+        const generated = result.props;
+        if (transform) {
+            return { ...input, ...transform(input, generated) };
+        }
+        return { ...input, ...generated };
+    };
+}
+/**
+ * Create a conditional props generator
+ *
+ * Only generates props when a condition is met.
+ *
+ * @example
+ * ```ts
+ * const maybeGenerateProps = createConditionalGenerator({
+ *   schema: { summary: 'Article summary' },
+ *   condition: (props) => !props.summary && props.content?.length > 100,
+ * })
+ * ```
+ */
+export function createConditionalGenerator(options) {
+    const { schema, condition, config = {} } = options;
+    return async (props) => {
+        if (!condition(props)) {
+            return props;
+        }
+        return mergeWithGenerated(schema, props, {
+            ...(config.model !== undefined && { model: config.model }),
+            ...(config.system !== undefined && { system: config.system }),
+        });
+    };
+}
+/**
+ * Batch props generator for list rendering
+ *
+ * Efficiently generates props for multiple items.
+ *
+ * @example
+ * ```ts
+ * const batchGenerator = createBatchGenerator({
+ *   schema: { title: 'Item title', description: 'Item description' },
+ * })
+ *
+ * const items = await batchGenerator.generate([
+ *   { id: 1, category: 'tech' },
+ *   { id: 2, category: 'science' },
+ *   { id: 3, category: 'art' },
+ * ])
+ * ```
+ */
+export function createBatchGenerator(options) {
+    const { schema, concurrency = 3, config = {} } = options;
+    return {
+        /**
+         * Generate props for multiple items
+         */
+        generate: async (items) => {
+            const results = [];
+            // Process in batches based on concurrency
+            for (let i = 0; i < items.length; i += concurrency) {
+                const batch = items.slice(i, i + concurrency);
+                const batchResults = await Promise.all(batch.map((item) => mergeWithGenerated(schema, item, {
+                    ...(config.model !== undefined && { model: config.model }),
+                    ...(config.system !== undefined && { system: config.system }),
+                })));
+                results.push(...batchResults);
+            }
+            return results;
+        },
+        /**
+         * Generate props one at a time (for rate limiting)
+         */
+        generateSequential: async (items) => {
+            const results = [];
+            for (const item of items) {
+                const result = await mergeWithGenerated(schema, item, {
+                    ...(config.model !== undefined && { model: config.model }),
+                    ...(config.system !== undefined && { system: config.system }),
+                });
+                results.push(result);
+            }
+            return results;
+        },
+    };
+}
+//# sourceMappingURL=hoc.js.map

package/dist/hoc.js.map

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