@ai-stack/payloadcms 3.2.26 → 3.68.0-beta.2

package/dist/ui/VoicesFetcher/index.js

@@ -0,0 +1,118 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button, useForm, useFormFields } from '@payloadcms/ui';
+import React, { useCallback, useState } from 'react';
+import { PLUGIN_API_ENDPOINT_FETCH_VOICES } from '../../defaults.js';
+/**
+ * VoicesFetcher Component
+ * Fetches voices from ElevenLabs API (server-side) and populates the voices array field
+ * SECURE: API key is never exposed to the client
+ */ export const VoicesFetcher = ({ path })=>{
+    const [loading, setLoading] = useState(false);
+    const { dispatchFields } = useForm();
+    // Get the parent path (the block path)
+    const fieldPath = path || '';
+    const blockPath = fieldPath.split('.').slice(0, -1).join('.');
+    const voicesPath = `${blockPath}.voices`;
+    // Get the current voices array to know how many rows to remove
+    const voicesField = useFormFields(([fields])=>fields[voicesPath]);
+    const currentRowCount = voicesField && 'rows' in voicesField && Array.isArray(voicesField.rows) ? voicesField.rows.length : 0;
+    const fetchVoices = useCallback(async ()=>{
+        setLoading(true);
+        try {
+            // Call server endpoint - it will read the API key from the database
+            const response = await fetch(`/api${PLUGIN_API_ENDPOINT_FETCH_VOICES}`, {
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                method: 'POST'
+            });
+            if (!response.ok) {
+                const error = await response.json();
+                throw new Error(error.message || 'Failed to fetch voices');
+            }
+            const data = await response.json();
+            const voices = data.voices || [];
+            // Remove existing rows first (in reverse order to maintain indices)
+            for(let i = currentRowCount - 1; i >= 0; i--){
+                dispatchFields({
+                    type: 'REMOVE_ROW',
+                    path: voicesPath,
+                    rowIndex: i
+                });
+            }
+            // Add new rows for each voice using ADD_ROW action
+            for (const voice of voices){
+                dispatchFields({
+                    type: 'ADD_ROW',
+                    path: voicesPath,
+                    subFieldState: {
+                        id: {
+                            initialValue: voice.id,
+                            valid: true,
+                            value: voice.id
+                        },
+                        name: {
+                            initialValue: voice.name,
+                            valid: true,
+                            value: voice.name
+                        },
+                        category: {
+                            initialValue: voice.category || 'premade',
+                            valid: true,
+                            value: voice.category || 'premade'
+                        },
+                        enabled: {
+                            initialValue: voice.enabled !== false,
+                            valid: true,
+                            value: voice.enabled !== false
+                        },
+                        labels: {
+                            initialValue: voice.labels || {},
+                            valid: true,
+                            value: voice.labels || {}
+                        },
+                        preview_url: {
+                            initialValue: voice.preview_url || '',
+                            valid: true,
+                            value: voice.preview_url || ''
+                        }
+                    }
+                });
+            }
+            alert(`Successfully fetched ${voices.length} voices!`);
+        } catch (error) {
+            alert(`Error: ${error instanceof Error ? error.message : 'Failed to fetch voices'}`);
+        } finally{
+            setLoading(false);
+        }
+    }, [
+        currentRowCount,
+        dispatchFields,
+        voicesPath
+    ]);
+    return /*#__PURE__*/ _jsxs("div", {
+        style: {
+            marginBottom: '20px'
+        },
+        children: [
+            /*#__PURE__*/ _jsx(Button, {
+                buttonStyle: "secondary",
+                disabled: loading,
+                onClick: fetchVoices,
+                size: "medium",
+                children: loading ? 'Fetching Voices...' : 'Fetch Voices from ElevenLabs'
+            }),
+            /*#__PURE__*/ _jsx("p", {
+                style: {
+                    color: 'var(--theme-elevation-600)',
+                    fontSize: '13px',
+                    marginTop: '8px'
+                },
+                children: "This will fetch all available voices from your ElevenLabs account. Make sure you have saved your API key in the Setup tab first."
+            })
+        ]
+    });
+};
+
+//# sourceMappingURL=index.js.map

package/dist/ui/VoicesFetcher/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/ui/VoicesFetcher/index.tsx"],"sourcesContent":["'use client'\n\nimport type { FieldClientComponent } from 'payload'\n\nimport { Button, useForm, useFormFields } from '@payloadcms/ui'\nimport React, { useCallback, useState } from 'react'\n\nimport { PLUGIN_API_ENDPOINT_FETCH_VOICES } from '../../defaults.js'\n\ninterface Voice {\n  category?: string\n  enabled?: boolean\n  id: string\n  labels?: Record<string, unknown>\n  name: string\n  preview_url?: string\n}\n\n/**\n * VoicesFetcher Component\n * Fetches voices from ElevenLabs API (server-side) and populates the voices array field\n * SECURE: API key is never exposed to the client\n */\nexport const VoicesFetcher: FieldClientComponent = ({ path }) => {\n  const [loading, setLoading] = useState(false)\n  const { dispatchFields } = useForm()\n\n  // Get the parent path (the block path)\n  const fieldPath = (path as string) || ''\n  const blockPath = fieldPath.split('.').slice(0, -1).join('.')\n  const voicesPath = `${blockPath}.voices`\n\n  // Get the current voices array to know how many rows to remove\n  const voicesField = useFormFields(([fields]) => fields[voicesPath])\n  const currentRowCount =\n    voicesField && 'rows' in voicesField && Array.isArray(voicesField.rows)\n      ? voicesField.rows.length\n      : 0\n\n  const fetchVoices = useCallback(async () => {\n    setLoading(true)\n\n    try {\n      // Call server endpoint - it will read the API key from the database\n      const response = await fetch(`/api${PLUGIN_API_ENDPOINT_FETCH_VOICES}`, {\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        method: 'POST',\n      })\n\n      if (!response.ok) {\n        const error = await response.json()\n        throw new Error(error.message || 'Failed to fetch voices')\n      }\n\n      const data = await response.json()\n      const voices: Voice[] = data.voices || []\n\n      // Remove existing rows first (in reverse order to maintain indices)\n      for (let i = currentRowCount - 1; i >= 0; i--) {\n        dispatchFields({\n          type: 'REMOVE_ROW',\n          path: voicesPath,\n          rowIndex: i,\n        })\n      }\n\n      // Add new rows for each voice using ADD_ROW action\n      for (const voice of voices) {\n        dispatchFields({\n          type: 'ADD_ROW',\n          path: voicesPath,\n          subFieldState: {\n            id: { initialValue: voice.id, valid: true, value: voice.id },\n            name: { initialValue: voice.name, valid: true, value: voice.name },\n            category: { initialValue: voice.category || 'premade', valid: true, value: voice.category || 'premade' },\n            enabled: { initialValue: voice.enabled !== false, valid: true, value: voice.enabled !== false },\n            labels: { initialValue: voice.labels || {}, valid: true, value: voice.labels || {} },\n            preview_url: { initialValue: voice.preview_url || '', valid: true, value: voice.preview_url || '' },\n          },\n        })\n      }\n\n      alert(`Successfully fetched ${voices.length} voices!`)\n    } catch (error) {\n      alert(`Error: ${error instanceof Error ? error.message : 'Failed to fetch voices'}`)\n    } finally {\n      setLoading(false)\n    }\n  }, [currentRowCount, dispatchFields, voicesPath])\n\n  return (\n    <div style={{ marginBottom: '20px' }}>\n      <Button buttonStyle=\"secondary\" disabled={loading} onClick={fetchVoices} size=\"medium\">\n        {loading ? 'Fetching Voices...' : 'Fetch Voices from ElevenLabs'}\n      </Button>\n      <p style={{ color: 'var(--theme-elevation-600)', fontSize: '13px', marginTop: '8px' }}>\n        This will fetch all available voices from your ElevenLabs account. Make sure you have saved\n        your API key in the Setup tab first.\n      </p>\n    </div>\n  )\n}\n\n\n\n"],"names":["Button","useForm","useFormFields","React","useCallback","useState","PLUGIN_API_ENDPOINT_FETCH_VOICES","VoicesFetcher","path","loading","setLoading","dispatchFields","fieldPath","blockPath","split","slice","join","voicesPath","voicesField","fields","currentRowCount","Array","isArray","rows","length","fetchVoices","response","fetch","headers","method","ok","error","json","Error","message","data","voices","i","type","rowIndex","voice","subFieldState","id","initialValue","valid","value","name","category","enabled","labels","preview_url","alert","div","style","marginBottom","buttonStyle","disabled","onClick","size","p","color","fontSize","marginTop"],"mappings":"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"}

package/dist/ui/VoicesFetcher/index.jsx

@@ -0,0 +1,79 @@
+'use client';
+import { Button, useForm, useFormFields } from '@payloadcms/ui';
+import React, { useCallback, useState } from 'react';
+import { PLUGIN_API_ENDPOINT_FETCH_VOICES } from '../../defaults.js';
+/**
+ * VoicesFetcher Component
+ * Fetches voices from ElevenLabs API (server-side) and populates the voices array field
+ * SECURE: API key is never exposed to the client
+ */
+export const VoicesFetcher = ({ path }) => {
+    const [loading, setLoading] = useState(false);
+    const { dispatchFields } = useForm();
+    // Get the parent path (the block path)
+    const fieldPath = path || '';
+    const blockPath = fieldPath.split('.').slice(0, -1).join('.');
+    const voicesPath = `${blockPath}.voices`;
+    // Get the current voices array to know how many rows to remove
+    const voicesField = useFormFields(([fields]) => fields[voicesPath]);
+    const currentRowCount = voicesField && 'rows' in voicesField && Array.isArray(voicesField.rows)
+        ? voicesField.rows.length
+        : 0;
+    const fetchVoices = useCallback(async () => {
+        setLoading(true);
+        try {
+            // Call server endpoint - it will read the API key from the database
+            const response = await fetch(`/api${PLUGIN_API_ENDPOINT_FETCH_VOICES}`, {
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                method: 'POST',
+            });
+            if (!response.ok) {
+                const error = await response.json();
+                throw new Error(error.message || 'Failed to fetch voices');
+            }
+            const data = await response.json();
+            const voices = data.voices || [];
+            // Remove existing rows first (in reverse order to maintain indices)
+            for (let i = currentRowCount - 1; i >= 0; i--) {
+                dispatchFields({
+                    type: 'REMOVE_ROW',
+                    path: voicesPath,
+                    rowIndex: i,
+                });
+            }
+            // Add new rows for each voice using ADD_ROW action
+            for (const voice of voices) {
+                dispatchFields({
+                    type: 'ADD_ROW',
+                    path: voicesPath,
+                    subFieldState: {
+                        id: { initialValue: voice.id, valid: true, value: voice.id },
+                        name: { initialValue: voice.name, valid: true, value: voice.name },
+                        category: { initialValue: voice.category || 'premade', valid: true, value: voice.category || 'premade' },
+                        enabled: { initialValue: voice.enabled !== false, valid: true, value: voice.enabled !== false },
+                        labels: { initialValue: voice.labels || {}, valid: true, value: voice.labels || {} },
+                        preview_url: { initialValue: voice.preview_url || '', valid: true, value: voice.preview_url || '' },
+                    },
+                });
+            }
+            alert(`Successfully fetched ${voices.length} voices!`);
+        }
+        catch (error) {
+            alert(`Error: ${error instanceof Error ? error.message : 'Failed to fetch voices'}`);
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [currentRowCount, dispatchFields, voicesPath]);
+    return (<div style={{ marginBottom: '20px' }}>
+      <Button buttonStyle="secondary" disabled={loading} onClick={fetchVoices} size="medium">
+        {loading ? 'Fetching Voices...' : 'Fetch Voices from ElevenLabs'}
+      </Button>
+      <p style={{ color: 'var(--theme-elevation-600)', fontSize: '13px', marginTop: '8px' }}>
+        This will fetch all available voices from your ElevenLabs account. Make sure you have saved
+        your API key in the Setup tab first.
+      </p>
+    </div>);
+};

package/dist/utilities/buildSmartPrompt.d.ts

@@ -0,0 +1,22 @@
+import type { Payload } from 'payload';
+export interface SmartPromptContext {
+    /** The document data for template interpolation */
+    documentData?: Record<string, unknown>;
+    /** The Payload instance to access collection config */
+    payload: Payload;
+    /** The schema path like 'array-test-cases.teamMembers.contact.email' */
+    schemaPath: string;
+}
+/**
+ * Build a smart contextual prompt based on field metadata.
+ * This is used as a fallback when the user hasn't set a custom prompt.
+ *
+ * @param context - The context containing schema path and document data
+ * @returns A contextual prompt string that can be used for AI generation
+ */
+export declare const buildSmartPrompt: (context: SmartPromptContext) => string;
+/**
+ * Check if a prompt template is empty and should be replaced with a smart prompt.
+ * Only triggers when the prompt is completely empty or whitespace-only.
+ */
+export declare const isGenericPrompt: (template: null | string | undefined) => boolean;

package/dist/utilities/buildSmartPrompt.js

@@ -0,0 +1,143 @@
+'use strict';
+import { getFieldBySchemaPath } from './getFieldBySchemaPath.js';
+/**
+ * Extract field information from a schema path
+ */ const getFieldInfo = (schemaPath, payload)=>{
+    const parts = schemaPath.split('.');
+    const collectionSlug = parts[0];
+    const fieldPath = parts.slice(1);
+    const fieldName = fieldPath[fieldPath.length - 1] || '';
+    // Get parent context (e.g., 'teamMembers' for 'teamMembers.name')
+    let parentContext = null;
+    if (fieldPath.length > 1) {
+        parentContext = fieldPath[fieldPath.length - 2];
+    }
+    // Try to get the actual field configuration from the collection
+    let field = null;
+    const collection = payload.config.collections.find((c)=>c.slug === collectionSlug);
+    if (collection) {
+        field = getFieldBySchemaPath(collection, schemaPath);
+    }
+    return {
+        name: fieldName,
+        type: field?.type || 'text',
+        field,
+        label: field?.label || fieldName,
+        parentContext
+    };
+};
+/**
+ * Humanize a camelCase or snake_case field name
+ * e.g., 'teamMembers' -> 'team members', 'first_name' -> 'first name'
+ */ const humanize = (str)=>{
+    return str.replace(/([a-z])([A-Z])/g, '$1 $2') // camelCase to spaces
+    .replace(/[_-]/g, ' ') // underscores/dashes to spaces
+    .toLowerCase().trim();
+};
+/**
+ * Get a description snippet from field admin config
+ */ const getFieldDescription = (field)=>{
+    if (!field) {
+        return null;
+    }
+    const admin = field.admin;
+    if (admin?.description && typeof admin.description === 'string') {
+        return admin.description;
+    }
+    return null;
+};
+/**
+ * Build type-specific prompt guidance
+ */ const getTypeGuidance = (type, fieldName)=>{
+    const nameHint = humanize(fieldName);
+    switch(type){
+        case 'code':
+            return `Generate code for ${nameHint}`;
+        case 'date':
+            return `Generate an appropriate date for ${nameHint}`;
+        case 'email':
+            return `Generate a valid professional email address`;
+        case 'json':
+            return `Generate valid JSON data for ${nameHint}`;
+        case 'number':
+            return `Generate an appropriate numeric value for ${nameHint}`;
+        case 'select':
+            return `Select an appropriate option for ${nameHint}`;
+        case 'text':
+            return `Generate appropriate text for ${nameHint}`;
+        case 'textarea':
+            return `Write detailed content for ${nameHint}`;
+        case 'upload':
+            // Explicit image generation instruction for multimodal models
+            return `Generate an image of ${nameHint}`;
+        default:
+            return `Generate content for ${nameHint}`;
+    }
+};
+/**
+ * Build context from parent field name using generic humanization.
+ * Works universally for any collection structure.
+ */ const getParentContextPhrase = (parentContext)=>{
+    if (!parentContext) {
+        return '';
+    }
+    const humanized = humanize(parentContext);
+    // Use singular form if the name ends with 's' (common for arrays)
+    // e.g., "teamMembers" → "team member", "products" → "product"
+    if (humanized.endsWith('s') && humanized.length > 2) {
+        return `for a ${humanized.slice(0, -1)} entry`;
+    }
+    return `for ${humanized}`;
+};
+/**
+ * Build a smart contextual prompt based on field metadata.
+ * This is used as a fallback when the user hasn't set a custom prompt.
+ * 
+ * @param context - The context containing schema path and document data
+ * @returns A contextual prompt string that can be used for AI generation
+ */ export const buildSmartPrompt = (context)=>{
+    const { documentData, payload, schemaPath } = context;
+    const fieldInfo = getFieldInfo(schemaPath, payload);
+    const { name, type, field, label, parentContext } = fieldInfo;
+    // Start with the field's own description if available
+    const description = getFieldDescription(field);
+    // Build the prompt components
+    const parts = [];
+    // Use description as primary guidance if available
+    if (description) {
+        parts.push(description);
+    } else {
+        // Fall back to type-based guidance, prefer label over name for better context
+        parts.push(getTypeGuidance(type, label || name));
+    }
+    // Add parent context if nested
+    const parentPhrase = getParentContextPhrase(parentContext);
+    if (parentPhrase) {
+        parts.push(parentPhrase);
+    }
+    // Add document title context if available
+    const title = documentData?.title;
+    if (title && typeof title === 'string') {
+        parts.push(`in the context of "${title}"`);
+    }
+    // Build the final prompt
+    let prompt = parts.join(' ');
+    // Ensure first letter is capitalized
+    prompt = prompt.charAt(0).toUpperCase() + prompt.slice(1);
+    // Add instruction suffix for clarity
+    if (!prompt.endsWith('.')) {
+        prompt += '.';
+    }
+    return prompt;
+};
+/**
+ * Check if a prompt template is empty and should be replaced with a smart prompt.
+ * Only triggers when the prompt is completely empty or whitespace-only.
+ */ export const isGenericPrompt = (template)=>{
+    if (!template) {
+        return true;
+    }
+    return template.trim() === '';
+};
+
+//# sourceMappingURL=buildSmartPrompt.js.map

package/dist/utilities/buildSmartPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/buildSmartPrompt.ts"],"sourcesContent":["'use strict'\n\nimport type { Field, Payload } from 'payload'\n\nimport { getFieldBySchemaPath } from './getFieldBySchemaPath.js'\n\nexport interface SmartPromptContext {\n  /** The document data for template interpolation */\n  documentData?: Record<string, unknown>\n  /** The Payload instance to access collection config */\n  payload: Payload\n  /** The schema path like 'array-test-cases.teamMembers.contact.email' */\n  schemaPath: string\n}\n\ninterface FieldInfo {\n  /** The field configuration */\n  field: Field | null\n  /** Human-readable field label */\n  label: string\n  /** Field name from the path */\n  name: string\n  /** Parent field name if nested (e.g., 'teamMembers' for 'teamMembers.name') */\n  parentContext: null | string\n  /** The field type */\n  type: string\n}\n\n/**\n * Extract field information from a schema path\n */\nconst getFieldInfo = (schemaPath: string, payload: Payload): FieldInfo => {\n  const parts = schemaPath.split('.')\n  const collectionSlug = parts[0]\n  const fieldPath = parts.slice(1)\n  const fieldName = fieldPath[fieldPath.length - 1] || ''\n  \n  // Get parent context (e.g., 'teamMembers' for 'teamMembers.name')\n  let parentContext: null | string = null\n  if (fieldPath.length > 1) {\n    parentContext = fieldPath[fieldPath.length - 2]\n  }\n  \n  // Try to get the actual field configuration from the collection\n  let field: Field | null = null\n  const collection = payload.config.collections.find(c => c.slug === collectionSlug)\n  if (collection) {\n    field = getFieldBySchemaPath(collection, schemaPath)\n  }\n  \n  return {\n    name: fieldName,\n    type: field?.type || 'text',\n    field,\n    label: (field as { label?: string })?.label || fieldName,\n    parentContext,\n  }\n}\n\n/**\n * Humanize a camelCase or snake_case field name\n * e.g., 'teamMembers' -> 'team members', 'first_name' -> 'first name'\n */\nconst humanize = (str: string): string => {\n  return str\n    .replace(/([a-z])([A-Z])/g, '$1 $2') // camelCase to spaces\n    .replace(/[_-]/g, ' ') // underscores/dashes to spaces\n    .toLowerCase()\n    .trim()\n}\n\n/**\n * Get a description snippet from field admin config\n */\nconst getFieldDescription = (field: Field | null): null | string => {\n  if (!field) {return null}\n  const admin = (field as { admin?: { description?: string } }).admin\n  if (admin?.description && typeof admin.description === 'string') {\n    return admin.description\n  }\n  return null\n}\n\n/**\n * Build type-specific prompt guidance\n */\nconst getTypeGuidance = (type: string, fieldName: string): string => {\n  const nameHint = humanize(fieldName)\n  \n  switch (type) {\n    case 'code':\n      return `Generate code for ${nameHint}`\n    case 'date':\n      return `Generate an appropriate date for ${nameHint}`\n    case 'email':\n      return `Generate a valid professional email address`\n    case 'json':\n      return `Generate valid JSON data for ${nameHint}`\n    case 'number':\n      return `Generate an appropriate numeric value for ${nameHint}`\n    case 'select':\n      return `Select an appropriate option for ${nameHint}`\n    case 'text':\n      return `Generate appropriate text for ${nameHint}`\n    case 'textarea':\n      return `Write detailed content for ${nameHint}`\n    case 'upload':\n      // Explicit image generation instruction for multimodal models\n      return `Generate an image of ${nameHint}`\n    default:\n      return `Generate content for ${nameHint}`\n  }\n}\n\n/**\n * Build context from parent field name using generic humanization.\n * Works universally for any collection structure.\n */\nconst getParentContextPhrase = (parentContext: null | string): string => {\n  if (!parentContext) {\n    return ''\n  }\n  \n  const humanized = humanize(parentContext)\n  \n  // Use singular form if the name ends with 's' (common for arrays)\n  // e.g., \"teamMembers\" → \"team member\", \"products\" → \"product\"\n  if (humanized.endsWith('s') && humanized.length > 2) {\n    return `for a ${humanized.slice(0, -1)} entry`\n  }\n  \n  return `for ${humanized}`\n}\n\n/**\n * Build a smart contextual prompt based on field metadata.\n * This is used as a fallback when the user hasn't set a custom prompt.\n * \n * @param context - The context containing schema path and document data\n * @returns A contextual prompt string that can be used for AI generation\n */\nexport const buildSmartPrompt = (context: SmartPromptContext): string => {\n  const { documentData, payload, schemaPath } = context\n  \n  const fieldInfo = getFieldInfo(schemaPath, payload)\n  const { name, type, field, label, parentContext } = fieldInfo\n  \n  // Start with the field's own description if available\n  const description = getFieldDescription(field)\n  \n  // Build the prompt components\n  const parts: string[] = []\n  \n  // Use description as primary guidance if available\n  if (description) {\n    parts.push(description)\n  } else {\n    // Fall back to type-based guidance, prefer label over name for better context\n    parts.push(getTypeGuidance(type, label || name))\n  }\n  \n  // Add parent context if nested\n  const parentPhrase = getParentContextPhrase(parentContext)\n  if (parentPhrase) {\n    parts.push(parentPhrase)\n  }\n  \n  // Add document title context if available\n  const title = documentData?.title\n  if (title && typeof title === 'string') {\n    parts.push(`in the context of \"${title}\"`)\n  }\n  \n  // Build the final prompt\n  let prompt = parts.join(' ')\n  \n  // Ensure first letter is capitalized\n  prompt = prompt.charAt(0).toUpperCase() + prompt.slice(1)\n  \n  // Add instruction suffix for clarity\n  if (!prompt.endsWith('.')) {\n    prompt += '.'\n  }\n  \n  return prompt\n}\n\n/**\n * Check if a prompt template is empty and should be replaced with a smart prompt.\n * Only triggers when the prompt is completely empty or whitespace-only.\n */\nexport const isGenericPrompt = (template: null | string | undefined): boolean => {\n  if (!template) {\n    return true\n  }\n  return template.trim() === ''\n}\n"],"names":["getFieldBySchemaPath","getFieldInfo","schemaPath","payload","parts","split","collectionSlug","fieldPath","slice","fieldName","length","parentContext","field","collection","config","collections","find","c","slug","name","type","label","humanize","str","replace","toLowerCase","trim","getFieldDescription","admin","description","getTypeGuidance","nameHint","getParentContextPhrase","humanized","endsWith","buildSmartPrompt","context","documentData","fieldInfo","push","parentPhrase","title","prompt","join","charAt","toUpperCase","isGenericPrompt","template"],"mappings":"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"}

package/dist/utilities/encryption.d.ts

@@ -0,0 +1,2 @@
+export declare function encrypt(text: string, secret: string): string;
+export declare function decrypt(text: string, secret: string): string;

package/dist/utilities/encryption.js

@@ -0,0 +1,47 @@
+import crypto from 'crypto';
+const algorithm = 'aes-256-cbc';
+const ivLength = 16;
+export function encrypt(text, secret) {
+    if (!text) {
+        return text;
+    }
+    if (!secret) {
+        throw new Error('No secret provided for encryption');
+    }
+    // Ensure secret is 32 bytes
+    const key = crypto.createHash('sha256').update(secret).digest();
+    const iv = crypto.randomBytes(ivLength);
+    const cipher = crypto.createCipheriv(algorithm, key, iv);
+    let encrypted = cipher.update(text);
+    encrypted = Buffer.concat([
+        encrypted,
+        cipher.final()
+    ]);
+    return iv.toString('hex') + ':' + encrypted.toString('hex');
+}
+export function decrypt(text, secret) {
+    if (!text) {
+        return text;
+    }
+    if (!secret) {
+        throw new Error('No secret provided for decryption');
+    }
+    try {
+        const textParts = text.split(':');
+        const iv = Buffer.from(textParts.shift(), 'hex');
+        const encryptedText = Buffer.from(textParts.join(':'), 'hex');
+        const key = crypto.createHash('sha256').update(secret).digest();
+        const decipher = crypto.createDecipheriv(algorithm, key, iv);
+        let decrypted = decipher.update(encryptedText);
+        decrypted = Buffer.concat([
+            decrypted,
+            decipher.final()
+        ]);
+        return decrypted.toString();
+    } catch (e) {
+        // If decryption fails, return original text (might be already plain or invalid)
+        return text;
+    }
+}
+
+//# sourceMappingURL=encryption.js.map

package/dist/utilities/encryption.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/encryption.ts"],"sourcesContent":["import crypto from 'crypto'\n\nconst algorithm = 'aes-256-cbc'\nconst ivLength = 16\n\nexport function encrypt(text: string, secret: string): string {\n  if (!text) {return text}\n  if (!secret) {throw new Error('No secret provided for encryption')}\n\n  // Ensure secret is 32 bytes\n  const key = crypto.createHash('sha256').update(secret).digest()\n  const iv = crypto.randomBytes(ivLength)\n  const cipher = crypto.createCipheriv(algorithm, key, iv)\n  let encrypted = cipher.update(text)\n  encrypted = Buffer.concat([encrypted, cipher.final()])\n  return iv.toString('hex') + ':' + encrypted.toString('hex')\n}\n\nexport function decrypt(text: string, secret: string): string {\n  if (!text) {return text}\n  if (!secret) {throw new Error('No secret provided for decryption')}\n\n  try {\n    const textParts = text.split(':')\n    const iv = Buffer.from(textParts.shift()!, 'hex')\n    const encryptedText = Buffer.from(textParts.join(':'), 'hex')\n    const key = crypto.createHash('sha256').update(secret).digest()\n    const decipher = crypto.createDecipheriv(algorithm, key, iv)\n    let decrypted = decipher.update(encryptedText)\n    decrypted = Buffer.concat([decrypted, decipher.final()])\n    return decrypted.toString()\n  } catch (e) {\n    // If decryption fails, return original text (might be already plain or invalid)\n    return text\n  }\n}\n"],"names":["crypto","algorithm","ivLength","encrypt","text","secret","Error","key","createHash","update","digest","iv","randomBytes","cipher","createCipheriv","encrypted","Buffer","concat","final","toString","decrypt","textParts","split","from","shift","encryptedText","join","decipher","createDecipheriv","decrypted","e"],"mappings":"AAAA,OAAOA,YAAY,SAAQ;AAE3B,MAAMC,YAAY;AAClB,MAAMC,WAAW;AAEjB,OAAO,SAASC,QAAQC,IAAY,EAAEC,MAAc;IAClD,IAAI,CAACD,MAAM;QAAC,OAAOA;IAAI;IACvB,IAAI,CAACC,QAAQ;QAAC,MAAM,IAAIC,MAAM;IAAoC;IAElE,4BAA4B;IAC5B,MAAMC,MAAMP,OAAOQ,UAAU,CAAC,UAAUC,MAAM,CAACJ,QAAQK,MAAM;IAC7D,MAAMC,KAAKX,OAAOY,WAAW,CAACV;IAC9B,MAAMW,SAASb,OAAOc,cAAc,CAACb,WAAWM,KAAKI;IACrD,IAAII,YAAYF,OAAOJ,MAAM,CAACL;IAC9BW,YAAYC,OAAOC,MAAM,CAAC;QAACF;QAAWF,OAAOK,KAAK;KAAG;IACrD,OAAOP,GAAGQ,QAAQ,CAAC,SAAS,MAAMJ,UAAUI,QAAQ,CAAC;AACvD;AAEA,OAAO,SAASC,QAAQhB,IAAY,EAAEC,MAAc;IAClD,IAAI,CAACD,MAAM;QAAC,OAAOA;IAAI;IACvB,IAAI,CAACC,QAAQ;QAAC,MAAM,IAAIC,MAAM;IAAoC;IAElE,IAAI;QACF,MAAMe,YAAYjB,KAAKkB,KAAK,CAAC;QAC7B,MAAMX,KAAKK,OAAOO,IAAI,CAACF,UAAUG,KAAK,IAAK;QAC3C,MAAMC,gBAAgBT,OAAOO,IAAI,CAACF,UAAUK,IAAI,CAAC,MAAM;QACvD,MAAMnB,MAAMP,OAAOQ,UAAU,CAAC,UAAUC,MAAM,CAACJ,QAAQK,MAAM;QAC7D,MAAMiB,WAAW3B,OAAO4B,gBAAgB,CAAC3B,WAAWM,KAAKI;QACzD,IAAIkB,YAAYF,SAASlB,MAAM,CAACgB;QAChCI,YAAYb,OAAOC,MAAM,CAAC;YAACY;YAAWF,SAAST,KAAK;SAAG;QACvD,OAAOW,UAAUV,QAAQ;IAC3B,EAAE,OAAOW,GAAG;QACV,gFAAgF;QAChF,OAAO1B;IACT;AACF"}

package/dist/utilities/extractImageData.d.ts

@@ -5,5 +5,14 @@ type ImageData = {
         url: string;
     };
 }[];
+/**
+ * Extracts hardcoded image URLs from text using regex.
+ *
+ * NOTE: This only handles direct URLs in the text.
+ * For @field references, use resolveImageReferences utility instead.
+ *
+ * @param input - Text containing image URLs
+ * @returns Array of extracted image data
+ */
 export declare function extractImageData(input: string): ImageData;
 export {};

package/dist/utilities/extractImageData.js

@@ -1,7 +1,17 @@
-export function extractImageData(input) {
+/**
+ * Extracts hardcoded image URLs from text using regex.
+ * 
+ * NOTE: This only handles direct URLs in the text.
+ * For @field references, use resolveImageReferences utility instead.
+ * 
+ * @param input - Text containing image URLs
+ * @returns Array of extracted image data
+ */ export function extractImageData(input) {
     const regex = /(?:https?:)?\/[\w%\-.,/]+\.(png|jpe?g|webp)/gi;
     const matches = input.match(regex);
-    if (!matches) return [];
+    if (!matches) {
+        return [];
+    }
     return matches.map((url)=>{
         const decodedUrl = decodeURIComponent(url);
         const parts = decodedUrl.split('/');

package/dist/utilities/extractImageData.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/extractImageData.ts"],"sourcesContent":["type ImageData = {\n  image: { name: string; type: string; url: string }\n}[]\n\nexport function extractImageData(input: string): ImageData {\n  const regex = /(?:https?:)?\\/[\\w%\\-.,/]+\\.(png|jpe?g|webp)/gi\n  const matches = input.match(regex)\n\n  if (!matches) return []\n\n  return matches.map((url) => {\n    const decodedUrl = decodeURIComponent(url)\n    const parts = decodedUrl.split('/')\n    const filename = parts[parts.length - 1]\n    const name = filename.replace(/\\.(png|jpe?g|webp)$/i, '')\n    const typeMatch = filename.match(/\\.(png|jpe?g|webp)$/i)\n    const type = typeMatch ? typeMatch[1].toLowerCase() : 'unknown'\n\n    return {\n      image: {\n        name,\n        type,\n        url,\n      },\n    }\n  })\n}\n"],"names":["extractImageData","input","regex","matches","match","map","url","decodedUrl","decodeURIComponent","parts","split","filename","length","name","replace","typeMatch","type","toLowerCase","image"],"mappings":"AAIA,OAAO,SAASA,iBAAiBC,KAAa;IAC5C,MAAMC,QAAQ;IACd,MAAMC,UAAUF,MAAMG,KAAK,CAACF;IAE5B,IAAI,CAACC,SAAS,OAAO,EAAE;IAEvB,OAAOA,QAAQE,GAAG,CAAC,CAACC;QAClB,MAAMC,aAAaC,mBAAmBF;QACtC,MAAMG,QAAQF,WAAWG,KAAK,CAAC;QAC/B,MAAMC,WAAWF,KAAK,CAACA,MAAMG,MAAM,GAAG,EAAE;QACxC,MAAMC,OAAOF,SAASG,OAAO,CAAC,wBAAwB;QACtD,MAAMC,YAAYJ,SAASP,KAAK,CAAC;QACjC,MAAMY,OAAOD,YAAYA,SAAS,CAAC,EAAE,CAACE,WAAW,KAAK;QAEtD,OAAO;YACLC,OAAO;gBACLL;gBACAG;gBACAV;YACF;QACF;IACF;AACF"}
+{"version":3,"sources":["../../src/utilities/extractImageData.ts"],"sourcesContent":["type ImageData = {\n  image: { name: string; type: string; url: string }\n}[]\n\n/**\n * Extracts hardcoded image URLs from text using regex.\n * \n * NOTE: This only handles direct URLs in the text.\n * For @field references, use resolveImageReferences utility instead.\n * \n * @param input - Text containing image URLs\n * @returns Array of extracted image data\n */\nexport function extractImageData(input: string): ImageData {\n  const regex = /(?:https?:)?\\/[\\w%\\-.,/]+\\.(png|jpe?g|webp)/gi\n  const matches = input.match(regex)\n\n  if (!matches) {return []}\n\n  return matches.map((url) => {\n    const decodedUrl = decodeURIComponent(url)\n    const parts = decodedUrl.split('/')\n    const filename = parts[parts.length - 1]\n    const name = filename.replace(/\\.(png|jpe?g|webp)$/i, '')\n    const typeMatch = filename.match(/\\.(png|jpe?g|webp)$/i)\n    const type = typeMatch ? typeMatch[1].toLowerCase() : 'unknown'\n\n    return {\n      image: {\n        name,\n        type,\n        url,\n      },\n    }\n  })\n}\n"],"names":["extractImageData","input","regex","matches","match","map","url","decodedUrl","decodeURIComponent","parts","split","filename","length","name","replace","typeMatch","type","toLowerCase","image"],"mappings":"AAIA;;;;;;;;CAQC,GACD,OAAO,SAASA,iBAAiBC,KAAa;IAC5C,MAAMC,QAAQ;IACd,MAAMC,UAAUF,MAAMG,KAAK,CAACF;IAE5B,IAAI,CAACC,SAAS;QAAC,OAAO,EAAE;IAAA;IAExB,OAAOA,QAAQE,GAAG,CAAC,CAACC;QAClB,MAAMC,aAAaC,mBAAmBF;QACtC,MAAMG,QAAQF,WAAWG,KAAK,CAAC;QAC/B,MAAMC,WAAWF,KAAK,CAACA,MAAMG,MAAM,GAAG,EAAE;QACxC,MAAMC,OAAOF,SAASG,OAAO,CAAC,wBAAwB;QACtD,MAAMC,YAAYJ,SAASP,KAAK,CAAC;QACjC,MAAMY,OAAOD,YAAYA,SAAS,CAAC,EAAE,CAACE,WAAW,KAAK;QAEtD,OAAO;YACLC,OAAO;gBACLL;gBACAG;gBACAV;YACF;QACF;IACF;AACF"}

package/dist/utilities/fetchImages.d.ts

@@ -0,0 +1,14 @@
+import type { ImagePart } from 'ai';
+import type { PayloadRequest } from 'payload';
+export interface FetchableImage {
+    image: {
+        mimeType?: string;
+        thumbnailURL?: string;
+        url: string;
+    };
+}
+/**
+ * Fetches images from a list of objects containing URLs (and optional thumbnails/mimetypes)
+ * and converts them to AI SDK compatible ImageParts.
+ */
+export declare function fetchImages(req: PayloadRequest, images: FetchableImage[]): Promise<ImagePart[]>;

package/dist/utilities/fetchImages.js

@@ -0,0 +1,38 @@
+import * as process from 'node:process';
+/**
+ * Fetches images from a list of objects containing URLs (and optional thumbnails/mimetypes)
+ * and converts them to AI SDK compatible ImageParts.
+ */ export async function fetchImages(req, images) {
+    const imageParts = [];
+    for (const img of images){
+        const serverURL = req.payload.config?.serverURL || process.env.SERVER_URL || process.env.NEXT_PUBLIC_SERVER_URL;
+        let url = img.image.thumbnailURL || img.image.url;
+        if (!url.startsWith('http')) {
+            url = `${String(serverURL)}${String(url)}`;
+        }
+        try {
+            const response = await fetch(url, {
+                headers: {
+                    Authorization: `Bearer ${req.headers.get('Authorization')?.split('Bearer ')[1] || ''}`
+                },
+                method: 'GET'
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to fetch image: ${response.statusText}`);
+            }
+            const blob = await response.blob();
+            const arrayBuffer = await blob.arrayBuffer();
+            imageParts.push({
+                type: 'image',
+                image: arrayBuffer,
+                mediaType: img.image.mimeType || blob.type || 'image/png'
+            });
+        } catch (e) {
+            req.payload.logger.error(e, `Error fetching reference image ${url}`);
+            throw new Error("We couldn't fetch the images. Please ensure the images are accessible and hosted publicly.");
+        }
+    }
+    return imageParts;
+}
+
+//# sourceMappingURL=fetchImages.js.map

package/dist/utilities/fetchImages.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/fetchImages.ts"],"sourcesContent":["import type { ImagePart } from 'ai'\nimport type { PayloadRequest } from 'payload'\n\nimport * as process from 'node:process'\n\nexport interface FetchableImage {\n  image: {\n    mimeType?: string\n    thumbnailURL?: string\n    url: string\n  }\n}\n\n/**\n * Fetches images from a list of objects containing URLs (and optional thumbnails/mimetypes)\n * and converts them to AI SDK compatible ImageParts.\n */\nexport async function fetchImages(\n  req: PayloadRequest,\n  images: FetchableImage[],\n): Promise<ImagePart[]> {\n  const imageParts: ImagePart[] = []\n\n  for (const img of images) {\n    const serverURL =\n      req.payload.config?.serverURL ||\n      process.env.SERVER_URL ||\n      process.env.NEXT_PUBLIC_SERVER_URL\n\n    let url = img.image.thumbnailURL || img.image.url\n    if (!url.startsWith('http')) {\n      url = `${String(serverURL)}${String(url)}`\n    }\n\n    try {\n      const response = await fetch(url, {\n        headers: {\n          Authorization: `Bearer ${req.headers.get('Authorization')?.split('Bearer ')[1] || ''}`,\n        },\n        method: 'GET',\n      })\n\n      if (!response.ok) {\n        throw new Error(`Failed to fetch image: ${response.statusText}`)\n      }\n\n      const blob = await response.blob()\n      const arrayBuffer = await blob.arrayBuffer()\n\n      imageParts.push({\n        type: 'image',\n        image: arrayBuffer,\n        mediaType: img.image.mimeType || blob.type || 'image/png',\n      })\n    } catch (e) {\n      req.payload.logger.error(e, `Error fetching reference image ${url}`)\n      throw new Error(\n        \"We couldn't fetch the images. Please ensure the images are accessible and hosted publicly.\",\n      )\n    }\n  }\n\n  return imageParts\n}\n"],"names":["process","fetchImages","req","images","imageParts","img","serverURL","payload","config","env","SERVER_URL","NEXT_PUBLIC_SERVER_URL","url","image","thumbnailURL","startsWith","String","response","fetch","headers","Authorization","get","split","method","ok","Error","statusText","blob","arrayBuffer","push","type","mediaType","mimeType","e","logger","error"],"mappings":"AAGA,YAAYA,aAAa,eAAc;AAUvC;;;CAGC,GACD,OAAO,eAAeC,YACpBC,GAAmB,EACnBC,MAAwB;IAExB,MAAMC,aAA0B,EAAE;IAElC,KAAK,MAAMC,OAAOF,OAAQ;QACxB,MAAMG,YACJJ,IAAIK,OAAO,CAACC,MAAM,EAAEF,aACpBN,QAAQS,GAAG,CAACC,UAAU,IACtBV,QAAQS,GAAG,CAACE,sBAAsB;QAEpC,IAAIC,MAAMP,IAAIQ,KAAK,CAACC,YAAY,IAAIT,IAAIQ,KAAK,CAACD,GAAG;QACjD,IAAI,CAACA,IAAIG,UAAU,CAAC,SAAS;YAC3BH,MAAM,CAAC,EAAEI,OAAOV,WAAW,EAAEU,OAAOJ,KAAK,CAAC;QAC5C;QAEA,IAAI;YACF,MAAMK,WAAW,MAAMC,MAAMN,KAAK;gBAChCO,SAAS;oBACPC,eAAe,CAAC,OAAO,EAAElB,IAAIiB,OAAO,CAACE,GAAG,CAAC,kBAAkBC,MAAM,UAAU,CAAC,EAAE,IAAI,GAAG,CAAC;gBACxF;gBACAC,QAAQ;YACV;YAEA,IAAI,CAACN,SAASO,EAAE,EAAE;gBAChB,MAAM,IAAIC,MAAM,CAAC,uBAAuB,EAAER,SAASS,UAAU,CAAC,CAAC;YACjE;YAEA,MAAMC,OAAO,MAAMV,SAASU,IAAI;YAChC,MAAMC,cAAc,MAAMD,KAAKC,WAAW;YAE1CxB,WAAWyB,IAAI,CAAC;gBACdC,MAAM;gBACNjB,OAAOe;gBACPG,WAAW1B,IAAIQ,KAAK,CAACmB,QAAQ,IAAIL,KAAKG,IAAI,IAAI;YAChD;QACF,EAAE,OAAOG,GAAG;YACV/B,IAAIK,OAAO,CAAC2B,MAAM,CAACC,KAAK,CAACF,GAAG,CAAC,+BAA+B,EAAErB,IAAI,CAAC;YACnE,MAAM,IAAIa,MACR;QAEJ;IACF;IAEA,OAAOrB;AACT"}

package/dist/utilities/fieldToJsonSchema.d.ts

@@ -8,6 +8,7 @@
  * Arrays are emitted only when field.hasMany is true and the field type supports hasMany
  * (text, textarea, select; for others only if your config truly sets hasMany).
  */
+import type { Field } from 'payload';
 export type JsonSchema = Record<string, any>;
 type BaseField = {
     admin?: {
@@ -30,7 +31,7 @@ type BaseField = {
     type?: string;
     typescriptSchema?: unknown;
 };
-export declare function fieldToJsonSchema(fieldInput: BaseField, opts?: {
+export declare function fieldToJsonSchema(fieldInput: BaseField & Field, opts?: {
     nameOverride?: string;
     wrapObject?: boolean;
 }): JsonSchema;