@ai-stack/payloadcms 3.76.0-beta.1 → 3.76.0-beta.2

package/dist/ui/hooks/useAISettings.js

@@ -0,0 +1,73 @@
+'use client';
+import { useEffect, useState } from 'react';
+/**
+ * Cached AI settings per depth.
+ * We still cache to avoid duplicate requests during a single render/mount cycle,
+ * but we always revalidate on mount so changes made in AI Providers appear in Instructions.
+ */ const cachedDataByDepth = new Map();
+const fetchPromiseByDepth = new Map();
+/**
+ * Shared hook for fetching AI settings from `/api/globals/ai-providers`.
+ *
+ * Features:
+ * - Module-level cache to prevent redundant fetches across components
+ * - Deduplicates in-flight requests (if 3 components mount at once, only 1 fetch fires)
+ * - Optional `depth` parameter for controlling response depth
+ *
+ * @example
+ * ```ts
+ * const { data, isLoading } = useAISettings()
+ * const providers = data?.providers ?? []
+ * ```
+ */ export function useAISettings(options) {
+    const depth = options?.depth ?? 1;
+    const initialCached = cachedDataByDepth.get(depth) ?? null;
+    const [data, setData] = useState(initialCached);
+    const [isLoading, setIsLoading] = useState(!initialCached);
+    useEffect(()=>{
+        const cached = cachedDataByDepth.get(depth) ?? null;
+        if (cached) {
+            setData(cached);
+            setIsLoading(false);
+        } else {
+            setIsLoading(true);
+        }
+        // Deduplicate in-flight requests per depth and always revalidate on mount.
+        let fetchPromise = fetchPromiseByDepth.get(depth) ?? null;
+        if (!fetchPromise) {
+            fetchPromise = fetch(`/api/globals/ai-providers?depth=${depth}`, {
+                cache: 'no-store',
+                credentials: 'include'
+            }).then(async (res)=>{
+                if (res.ok) {
+                    const json = await res.json();
+                    cachedDataByDepth.set(depth, json);
+                    return json;
+                }
+                return null;
+            }).catch(()=>null).finally(()=>{
+                fetchPromiseByDepth.delete(depth);
+            });
+            fetchPromiseByDepth.set(depth, fetchPromise);
+        }
+        void fetchPromise.then((result)=>{
+            setData(result);
+            setIsLoading(false);
+        });
+    }, [
+        depth
+    ]);
+    return {
+        data,
+        isLoading
+    };
+}
+/**
+ * Invalidate the cached AI settings, forcing the next `useAISettings` call to re-fetch.
+ * Useful after saving settings.
+ */ export function invalidateAISettings() {
+    cachedDataByDepth.clear();
+    fetchPromiseByDepth.clear();
+}
+
+//# sourceMappingURL=useAISettings.js.map

package/dist/ui/hooks/useAISettings.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/ui/hooks/useAISettings.ts"],"sourcesContent":["'use client'\n\nimport type { AISettingsData } from '../../ai/providers/types.js'\n\nimport { useEffect, useState } from 'react'\n\n/**\n * Cached AI settings per depth.\n * We still cache to avoid duplicate requests during a single render/mount cycle,\n * but we always revalidate on mount so changes made in AI Providers appear in Instructions.\n */\nconst cachedDataByDepth = new Map<number, AISettingsData | null>()\nconst fetchPromiseByDepth = new Map<number, Promise<AISettingsData | null>>()\n\n/**\n * Shared hook for fetching AI settings from `/api/globals/ai-providers`.\n *\n * Features:\n * - Module-level cache to prevent redundant fetches across components\n * - Deduplicates in-flight requests (if 3 components mount at once, only 1 fetch fires)\n * - Optional `depth` parameter for controlling response depth\n *\n * @example\n * ```ts\n * const { data, isLoading } = useAISettings()\n * const providers = data?.providers ?? []\n * ```\n */\nexport function useAISettings(options?: { depth?: number }) {\n  const depth = options?.depth ?? 1\n  const initialCached = cachedDataByDepth.get(depth) ?? null\n  const [data, setData] = useState<AISettingsData | null>(initialCached)\n  const [isLoading, setIsLoading] = useState(!initialCached)\n\n  useEffect(() => {\n    const cached = cachedDataByDepth.get(depth) ?? null\n    if (cached) {\n      setData(cached)\n      setIsLoading(false)\n    } else {\n      setIsLoading(true)\n    }\n\n    // Deduplicate in-flight requests per depth and always revalidate on mount.\n    let fetchPromise = fetchPromiseByDepth.get(depth) ?? null\n    if (!fetchPromise) {\n      fetchPromise = fetch(`/api/globals/ai-providers?depth=${depth}`, {\n        cache: 'no-store',\n        credentials: 'include',\n      })\n        .then(async (res) => {\n          if (res.ok) {\n            const json = await res.json()\n            cachedDataByDepth.set(depth, json as AISettingsData)\n            return json as AISettingsData\n          }\n          return null\n        })\n        .catch(() => null)\n        .finally(() => {\n          fetchPromiseByDepth.delete(depth)\n        })\n\n      fetchPromiseByDepth.set(depth, fetchPromise)\n    }\n\n    void fetchPromise.then((result) => {\n      setData(result)\n      setIsLoading(false)\n    })\n  }, [depth])\n\n  return { data, isLoading }\n}\n\n/**\n * Invalidate the cached AI settings, forcing the next `useAISettings` call to re-fetch.\n * Useful after saving settings.\n */\nexport function invalidateAISettings(): void {\n  cachedDataByDepth.clear()\n  fetchPromiseByDepth.clear()\n}\n"],"names":["useEffect","useState","cachedDataByDepth","Map","fetchPromiseByDepth","useAISettings","options","depth","initialCached","get","data","setData","isLoading","setIsLoading","cached","fetchPromise","fetch","cache","credentials","then","res","ok","json","set","catch","finally","delete","result","invalidateAISettings","clear"],"mappings":"AAAA;AAIA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,QAAO;AAE3C;;;;CAIC,GACD,MAAMC,oBAAoB,IAAIC;AAC9B,MAAMC,sBAAsB,IAAID;AAEhC;;;;;;;;;;;;;CAaC,GACD,OAAO,SAASE,cAAcC,OAA4B;IACxD,MAAMC,QAAQD,SAASC,SAAS;IAChC,MAAMC,gBAAgBN,kBAAkBO,GAAG,CAACF,UAAU;IACtD,MAAM,CAACG,MAAMC,QAAQ,GAAGV,SAAgCO;IACxD,MAAM,CAACI,WAAWC,aAAa,GAAGZ,SAAS,CAACO;IAE5CR,UAAU;QACR,MAAMc,SAASZ,kBAAkBO,GAAG,CAACF,UAAU;QAC/C,IAAIO,QAAQ;YACVH,QAAQG;YACRD,aAAa;QACf,OAAO;YACLA,aAAa;QACf;QAEA,2EAA2E;QAC3E,IAAIE,eAAeX,oBAAoBK,GAAG,CAACF,UAAU;QACrD,IAAI,CAACQ,cAAc;YACjBA,eAAeC,MAAM,CAAC,gCAAgC,EAAET,MAAM,CAAC,EAAE;gBAC/DU,OAAO;gBACPC,aAAa;YACf,GACGC,IAAI,CAAC,OAAOC;gBACX,IAAIA,IAAIC,EAAE,EAAE;oBACV,MAAMC,OAAO,MAAMF,IAAIE,IAAI;oBAC3BpB,kBAAkBqB,GAAG,CAAChB,OAAOe;oBAC7B,OAAOA;gBACT;gBACA,OAAO;YACT,GACCE,KAAK,CAAC,IAAM,MACZC,OAAO,CAAC;gBACPrB,oBAAoBsB,MAAM,CAACnB;YAC7B;YAEFH,oBAAoBmB,GAAG,CAAChB,OAAOQ;QACjC;QAEA,KAAKA,aAAaI,IAAI,CAAC,CAACQ;YACtBhB,QAAQgB;YACRd,aAAa;QACf;IACF,GAAG;QAACN;KAAM;IAEV,OAAO;QAAEG;QAAME;IAAU;AAC3B;AAEA;;;CAGC,GACD,OAAO,SAASgB;IACd1B,kBAAkB2B,KAAK;IACvBzB,oBAAoByB,KAAK;AAC3B"}

package/dist/ui/providerOptions/updateProviderOptionsValue.d.ts

@@ -0,0 +1,6 @@
+export declare function updateProviderOptionsValue({ currentValue, keyPath, provider, targetValue, }: {
+    currentValue: unknown;
+    keyPath: string[];
+    provider?: string;
+    targetValue: unknown;
+}): Record<string, unknown> | null;

package/dist/ui/providerOptions/updateProviderOptionsValue.js

@@ -0,0 +1,50 @@
+function isRecord(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+function cloneRecord(value) {
+    if (!isRecord(value)) {
+        return {};
+    }
+    return JSON.parse(JSON.stringify(value));
+}
+function pruneEmptyObjects(node) {
+    for (const [key, value] of Object.entries(node)){
+        if (!isRecord(value)) {
+            continue;
+        }
+        pruneEmptyObjects(value);
+        if (Object.keys(value).length === 0) {
+            delete node[key];
+        }
+    }
+}
+export function updateProviderOptionsValue({ currentValue, keyPath, provider, targetValue }) {
+    if (!provider || keyPath.length === 0) {
+        return isRecord(currentValue) ? cloneRecord(currentValue) : null;
+    }
+    const nextProviderOptions = cloneRecord(currentValue);
+    const currentProviderOptions = isRecord(nextProviderOptions[provider]) ? cloneRecord(nextProviderOptions[provider]) : {};
+    let targetNode = currentProviderOptions;
+    for(let i = 0; i < keyPath.length - 1; i++){
+        const segment = keyPath[i];
+        if (!isRecord(targetNode[segment])) {
+            targetNode[segment] = {};
+        }
+        targetNode = targetNode[segment];
+    }
+    const finalKey = keyPath[keyPath.length - 1];
+    if (targetValue === undefined) {
+        delete targetNode[finalKey];
+    } else {
+        targetNode[finalKey] = targetValue;
+    }
+    pruneEmptyObjects(currentProviderOptions);
+    if (Object.keys(currentProviderOptions).length === 0) {
+        delete nextProviderOptions[provider];
+    } else {
+        nextProviderOptions[provider] = currentProviderOptions;
+    }
+    return Object.keys(nextProviderOptions).length > 0 ? nextProviderOptions : null;
+}
+
+//# sourceMappingURL=updateProviderOptionsValue.js.map

package/dist/ui/providerOptions/updateProviderOptionsValue.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/ui/providerOptions/updateProviderOptionsValue.ts"],"sourcesContent":["function isRecord(value: unknown): value is Record<string, unknown> {\n  return !!value && typeof value === 'object' && !Array.isArray(value)\n}\n\nfunction cloneRecord(value: unknown): Record<string, unknown> {\n  if (!isRecord(value)) {\n    return {}\n  }\n\n  return JSON.parse(JSON.stringify(value)) as Record<string, unknown>\n}\n\nfunction pruneEmptyObjects(node: Record<string, unknown>): void {\n  for (const [key, value] of Object.entries(node)) {\n    if (!isRecord(value)) {\n      continue\n    }\n\n    pruneEmptyObjects(value)\n    if (Object.keys(value).length === 0) {\n      delete node[key]\n    }\n  }\n}\n\nexport function updateProviderOptionsValue({\n  currentValue,\n  keyPath,\n  provider,\n  targetValue,\n}: {\n  currentValue: unknown\n  keyPath: string[]\n  provider?: string\n  targetValue: unknown\n}): Record<string, unknown> | null {\n  if (!provider || keyPath.length === 0) {\n    return isRecord(currentValue) ? cloneRecord(currentValue) : null\n  }\n\n  const nextProviderOptions = cloneRecord(currentValue)\n  const currentProviderOptions = isRecord(nextProviderOptions[provider])\n    ? cloneRecord(nextProviderOptions[provider])\n    : {}\n\n  let targetNode = currentProviderOptions\n  for (let i = 0; i < keyPath.length - 1; i++) {\n    const segment = keyPath[i]\n    if (!isRecord(targetNode[segment])) {\n      targetNode[segment] = {}\n    }\n    targetNode = targetNode[segment] as Record<string, unknown>\n  }\n\n  const finalKey = keyPath[keyPath.length - 1]\n  if (targetValue === undefined) {\n    delete targetNode[finalKey]\n  } else {\n    targetNode[finalKey] = targetValue\n  }\n\n  pruneEmptyObjects(currentProviderOptions)\n\n  if (Object.keys(currentProviderOptions).length === 0) {\n    delete nextProviderOptions[provider]\n  } else {\n    nextProviderOptions[provider] = currentProviderOptions\n  }\n\n  return Object.keys(nextProviderOptions).length > 0 ? nextProviderOptions : null\n}\n"],"names":["isRecord","value","Array","isArray","cloneRecord","JSON","parse","stringify","pruneEmptyObjects","node","key","Object","entries","keys","length","updateProviderOptionsValue","currentValue","keyPath","provider","targetValue","nextProviderOptions","currentProviderOptions","targetNode","i","segment","finalKey","undefined"],"mappings":"AAAA,SAASA,SAASC,KAAc;IAC9B,OAAO,CAAC,CAACA,SAAS,OAAOA,UAAU,YAAY,CAACC,MAAMC,OAAO,CAACF;AAChE;AAEA,SAASG,YAAYH,KAAc;IACjC,IAAI,CAACD,SAASC,QAAQ;QACpB,OAAO,CAAC;IACV;IAEA,OAAOI,KAAKC,KAAK,CAACD,KAAKE,SAAS,CAACN;AACnC;AAEA,SAASO,kBAAkBC,IAA6B;IACtD,KAAK,MAAM,CAACC,KAAKT,MAAM,IAAIU,OAAOC,OAAO,CAACH,MAAO;QAC/C,IAAI,CAACT,SAASC,QAAQ;YACpB;QACF;QAEAO,kBAAkBP;QAClB,IAAIU,OAAOE,IAAI,CAACZ,OAAOa,MAAM,KAAK,GAAG;YACnC,OAAOL,IAAI,CAACC,IAAI;QAClB;IACF;AACF;AAEA,OAAO,SAASK,2BAA2B,EACzCC,YAAY,EACZC,OAAO,EACPC,QAAQ,EACRC,WAAW,EAMZ;IACC,IAAI,CAACD,YAAYD,QAAQH,MAAM,KAAK,GAAG;QACrC,OAAOd,SAASgB,gBAAgBZ,YAAYY,gBAAgB;IAC9D;IAEA,MAAMI,sBAAsBhB,YAAYY;IACxC,MAAMK,yBAAyBrB,SAASoB,mBAAmB,CAACF,SAAS,IACjEd,YAAYgB,mBAAmB,CAACF,SAAS,IACzC,CAAC;IAEL,IAAII,aAAaD;IACjB,IAAK,IAAIE,IAAI,GAAGA,IAAIN,QAAQH,MAAM,GAAG,GAAGS,IAAK;QAC3C,MAAMC,UAAUP,OAAO,CAACM,EAAE;QAC1B,IAAI,CAACvB,SAASsB,UAAU,CAACE,QAAQ,GAAG;YAClCF,UAAU,CAACE,QAAQ,GAAG,CAAC;QACzB;QACAF,aAAaA,UAAU,CAACE,QAAQ;IAClC;IAEA,MAAMC,WAAWR,OAAO,CAACA,QAAQH,MAAM,GAAG,EAAE;IAC5C,IAAIK,gBAAgBO,WAAW;QAC7B,OAAOJ,UAAU,CAACG,SAAS;IAC7B,OAAO;QACLH,UAAU,CAACG,SAAS,GAAGN;IACzB;IAEAX,kBAAkBa;IAElB,IAAIV,OAAOE,IAAI,CAACQ,wBAAwBP,MAAM,KAAK,GAAG;QACpD,OAAOM,mBAAmB,CAACF,SAAS;IACtC,OAAO;QACLE,mBAAmB,CAACF,SAAS,GAAGG;IAClC;IAEA,OAAOV,OAAOE,IAAI,CAACO,qBAAqBN,MAAM,GAAG,IAAIM,sBAAsB;AAC7E"}

package/dist/ui/shared/handleSelectChange.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Shared onChange handler for Payload SelectInput components.
+ * Handles both object options `{ value: string }` and raw string values.
+ */
+export declare function handleSelectChange(setValue: (value: unknown) => void, option: unknown): void;

package/dist/ui/shared/handleSelectChange.js

@@ -0,0 +1,12 @@
+/**
+ * Shared onChange handler for Payload SelectInput components.
+ * Handles both object options `{ value: string }` and raw string values.
+ */ export function handleSelectChange(setValue, option) {
+    if (option && typeof option === 'object' && 'value' in option) {
+        setValue(option.value);
+    } else {
+        setValue(option);
+    }
+}
+
+//# sourceMappingURL=handleSelectChange.js.map

package/dist/ui/shared/handleSelectChange.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/ui/shared/handleSelectChange.ts"],"sourcesContent":["/**\n * Shared onChange handler for Payload SelectInput components.\n * Handles both object options `{ value: string }` and raw string values.\n */\nexport function handleSelectChange(\n  setValue: (value: unknown) => void,\n  option: unknown,\n): void {\n  if (option && typeof option === 'object' && 'value' in option) {\n    setValue((option as { value: string }).value)\n  } else {\n    setValue(option)\n  }\n}\n"],"names":["handleSelectChange","setValue","option","value"],"mappings":"AAAA;;;CAGC,GACD,OAAO,SAASA,mBACdC,QAAkC,EAClCC,MAAe;IAEf,IAAIA,UAAU,OAAOA,WAAW,YAAY,WAAWA,QAAQ;QAC7DD,SAAS,AAACC,OAA6BC,KAAK;IAC9C,OAAO;QACLF,SAASC;IACX;AACF"}

package/dist/ui/shared/types.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared UI types used across multiple components.
+ */
+export interface Voice {
+    category?: string;
+    enabled?: boolean;
+    id: string;
+    labels?: Record<string, unknown>;
+    name: string;
+    preview_url?: string;
+}

package/dist/ui/shared/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared UI types used across multiple components.
+ */ export { };
+
+//# sourceMappingURL=types.js.map

package/dist/ui/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/ui/shared/types.ts"],"sourcesContent":["/**\n * Shared UI types used across multiple components.\n */\nexport interface 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"],"names":[],"mappings":"AAAA;;CAEC,GACD,WAOC"}

package/dist/utilities/ai/resolveEffectiveInstructionSettings.d.ts

@@ -0,0 +1,15 @@
+export type InstructionUseCase = 'image' | 'text' | 'tts' | 'video';
+export declare function getInstructionSettingsName(modelId: unknown): string | undefined;
+export declare function getInstructionUseCase(modelId: unknown): InstructionUseCase | undefined;
+export declare function resolveEffectiveInstructionSettings({ defaults, instructions, }: {
+    defaults?: Record<string, any>;
+    instructions: Record<string, any>;
+}): {
+    effectiveSettings: Record<string, unknown>;
+    settingsName?: string;
+    useCase?: InstructionUseCase;
+};
+export declare function applyInstructionDefaultsForDisplay({ defaults, instructions, }: {
+    defaults?: Record<string, any>;
+    instructions: Record<string, any>;
+}): Record<string, any>;

package/dist/utilities/ai/resolveEffectiveInstructionSettings.js

@@ -0,0 +1,136 @@
+const hasMeaningfulValue = (value)=>{
+    if (value === null || value === undefined) {
+        return false;
+    }
+    if (typeof value === 'string') {
+        return value.trim() !== '';
+    }
+    return true;
+};
+function isRecord(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+function deepMergeRecords(base, override) {
+    const merged = {
+        ...base
+    };
+    for (const [key, value] of Object.entries(override)){
+        const current = merged[key];
+        if (isRecord(current) && isRecord(value)) {
+            merged[key] = deepMergeRecords(current, value);
+            continue;
+        }
+        merged[key] = value;
+    }
+    return merged;
+}
+export function getInstructionSettingsName(modelId) {
+    if (modelId === 'text') {
+        return 'text-settings';
+    }
+    if (modelId === 'richtext') {
+        return 'richtext-settings';
+    }
+    if (modelId === 'array') {
+        return 'array-settings';
+    }
+    if (modelId === 'image') {
+        return 'image-settings';
+    }
+    if (modelId === 'tts') {
+        return 'tts-settings';
+    }
+    if (modelId === 'video') {
+        return 'video-settings';
+    }
+    return undefined;
+}
+export function getInstructionUseCase(modelId) {
+    if (modelId === 'text' || modelId === 'richtext' || modelId === 'array') {
+        return 'text';
+    }
+    if (modelId === 'image') {
+        return 'image';
+    }
+    if (modelId === 'tts') {
+        return 'tts';
+    }
+    if (modelId === 'video') {
+        return 'video';
+    }
+    return undefined;
+}
+export function resolveEffectiveInstructionSettings({ defaults, instructions }) {
+    const modelId = instructions['model-id'];
+    const settingsName = getInstructionSettingsName(modelId);
+    const useCase = getInstructionUseCase(modelId);
+    if (!settingsName || !useCase) {
+        return {
+            effectiveSettings: {},
+            settingsName,
+            useCase
+        };
+    }
+    const defaultsForUseCase = defaults?.[useCase] || {};
+    const instructionSettings = instructions[settingsName] || {};
+    const effectiveSettings = {
+        ...defaultsForUseCase
+    };
+    for (const [key, value] of Object.entries(instructionSettings)){
+        if (key === 'providerOptions') {
+            const selectedProvider = typeof instructionSettings.provider === 'string' ? instructionSettings.provider : typeof defaultsForUseCase.provider === 'string' ? defaultsForUseCase.provider : undefined;
+            if (selectedProvider && isRecord(value) && isRecord(value[selectedProvider])) {
+                const existingOpts = isRecord(effectiveSettings.providerOptions) ? effectiveSettings.providerOptions : {};
+                const existingProviderOpts = isRecord(existingOpts[selectedProvider]) ? existingOpts[selectedProvider] : {};
+                const incomingProviderOpts = value[selectedProvider];
+                effectiveSettings.providerOptions = {
+                    ...existingOpts,
+                    [selectedProvider]: {
+                        ...deepMergeRecords(existingProviderOpts, incomingProviderOpts)
+                    }
+                };
+            }
+            continue;
+        }
+        if (hasMeaningfulValue(value)) {
+            effectiveSettings[key] = value;
+        }
+    }
+    return {
+        effectiveSettings,
+        settingsName,
+        useCase
+    };
+}
+export function applyInstructionDefaultsForDisplay({ defaults, instructions }) {
+    const { settingsName, useCase } = resolveEffectiveInstructionSettings({
+        defaults,
+        instructions
+    });
+    if (!settingsName || !useCase) {
+        return instructions;
+    }
+    const defaultsForUseCase = defaults?.[useCase] || {};
+    const group = instructions[settingsName] || {};
+    const updatedGroup = {
+        ...group
+    };
+    if (!hasMeaningfulValue(updatedGroup.provider) && hasMeaningfulValue(defaultsForUseCase.provider)) {
+        updatedGroup.provider = defaultsForUseCase.provider;
+    }
+    if (!hasMeaningfulValue(updatedGroup.model) && hasMeaningfulValue(defaultsForUseCase.model)) {
+        updatedGroup.model = defaultsForUseCase.model;
+    }
+    if (useCase === 'tts' && !hasMeaningfulValue(updatedGroup.voice) && hasMeaningfulValue(defaultsForUseCase.voice)) {
+        updatedGroup.voice = defaultsForUseCase.voice;
+    }
+    if (JSON.stringify(group) === JSON.stringify(updatedGroup)) {
+        return instructions;
+    }
+    return {
+        ...instructions,
+        [settingsName]: updatedGroup
+    };
+}
+
+//# sourceMappingURL=resolveEffectiveInstructionSettings.js.map

package/dist/utilities/ai/resolveEffectiveInstructionSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utilities/ai/resolveEffectiveInstructionSettings.ts"],"sourcesContent":["export type InstructionUseCase = 'image' | 'text' | 'tts' | 'video'\n\nconst hasMeaningfulValue = (value: unknown): boolean => {\n  if (value === null || value === undefined) {\n    return false\n  }\n\n  if (typeof value === 'string') {\n    return value.trim() !== ''\n  }\n\n  return true\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return !!value && typeof value === 'object' && !Array.isArray(value)\n}\n\nfunction deepMergeRecords(\n  base: Record<string, unknown>,\n  override: Record<string, unknown>,\n): Record<string, unknown> {\n  const merged: Record<string, unknown> = { ...base }\n\n  for (const [key, value] of Object.entries(override)) {\n    const current = merged[key]\n    if (isRecord(current) && isRecord(value)) {\n      merged[key] = deepMergeRecords(current, value)\n      continue\n    }\n    merged[key] = value\n  }\n\n  return merged\n}\n\nexport function getInstructionSettingsName(modelId: unknown): string | undefined {\n  if (modelId === 'text') {\n    return 'text-settings'\n  }\n  if (modelId === 'richtext') {\n    return 'richtext-settings'\n  }\n  if (modelId === 'array') {\n    return 'array-settings'\n  }\n  if (modelId === 'image') {\n    return 'image-settings'\n  }\n  if (modelId === 'tts') {\n    return 'tts-settings'\n  }\n  if (modelId === 'video') {\n    return 'video-settings'\n  }\n\n  return undefined\n}\n\nexport function getInstructionUseCase(modelId: unknown): InstructionUseCase | undefined {\n  if (modelId === 'text' || modelId === 'richtext' || modelId === 'array') {\n    return 'text'\n  }\n  if (modelId === 'image') {\n    return 'image'\n  }\n  if (modelId === 'tts') {\n    return 'tts'\n  }\n  if (modelId === 'video') {\n    return 'video'\n  }\n\n  return undefined\n}\nexport function resolveEffectiveInstructionSettings({\n  defaults,\n  instructions,\n}: {\n  defaults?: Record<string, any>\n  instructions: Record<string, any>\n}): {\n  effectiveSettings: Record<string, unknown>\n  settingsName?: string\n  useCase?: InstructionUseCase\n} {\n  const modelId = instructions['model-id']\n  const settingsName = getInstructionSettingsName(modelId)\n  const useCase = getInstructionUseCase(modelId)\n\n  if (!settingsName || !useCase) {\n    return { effectiveSettings: {}, settingsName, useCase }\n  }\n\n  const defaultsForUseCase = (defaults?.[useCase] || {}) as Record<string, unknown>\n  const instructionSettings = (instructions[settingsName] || {}) as Record<string, unknown>\n  const effectiveSettings: Record<string, unknown> = {\n    ...defaultsForUseCase,\n  }\n\n  for (const [key, value] of Object.entries(instructionSettings)) {\n    if (key === 'providerOptions') {\n      const selectedProvider =\n        typeof instructionSettings.provider === 'string'\n          ? instructionSettings.provider\n          : typeof defaultsForUseCase.provider === 'string'\n            ? defaultsForUseCase.provider\n            : undefined\n\n      if (selectedProvider && isRecord(value) && isRecord(value[selectedProvider])) {\n        const existingOpts = isRecord(effectiveSettings.providerOptions)\n          ? effectiveSettings.providerOptions\n          : {}\n        const existingProviderOpts = isRecord(existingOpts[selectedProvider])\n          ? existingOpts[selectedProvider]\n          : {}\n        const incomingProviderOpts = value[selectedProvider] as Record<string, unknown>\n\n        effectiveSettings.providerOptions = {\n          ...existingOpts,\n          [selectedProvider]: {\n            ...deepMergeRecords(existingProviderOpts, incomingProviderOpts),\n          },\n        }\n      }\n      continue\n    }\n\n    if (hasMeaningfulValue(value)) {\n      effectiveSettings[key] = value\n    }\n  }\n\n  return {\n    effectiveSettings,\n    settingsName,\n    useCase,\n  }\n}\n\nexport function applyInstructionDefaultsForDisplay({\n  defaults,\n  instructions,\n}: {\n  defaults?: Record<string, any>\n  instructions: Record<string, any>\n}): Record<string, any> {\n  const { settingsName, useCase } = resolveEffectiveInstructionSettings({ defaults, instructions })\n\n  if (!settingsName || !useCase) {\n    return instructions\n  }\n\n  const defaultsForUseCase = (defaults?.[useCase] || {}) as Record<string, unknown>\n  const group = ((instructions[settingsName] || {}) as Record<string, unknown>)\n  const updatedGroup: Record<string, unknown> = {\n    ...group,\n  }\n\n  if (!hasMeaningfulValue(updatedGroup.provider) && hasMeaningfulValue(defaultsForUseCase.provider)) {\n    updatedGroup.provider = defaultsForUseCase.provider\n  }\n\n  if (!hasMeaningfulValue(updatedGroup.model) && hasMeaningfulValue(defaultsForUseCase.model)) {\n    updatedGroup.model = defaultsForUseCase.model\n  }\n\n  if (useCase === 'tts' && !hasMeaningfulValue(updatedGroup.voice) && hasMeaningfulValue(defaultsForUseCase.voice)) {\n    updatedGroup.voice = defaultsForUseCase.voice\n  }\n\n  if (JSON.stringify(group) === JSON.stringify(updatedGroup)) {\n    return instructions\n  }\n\n  return {\n    ...instructions,\n    [settingsName]: updatedGroup,\n  }\n}\n"],"names":["hasMeaningfulValue","value","undefined","trim","isRecord","Array","isArray","deepMergeRecords","base","override","merged","key","Object","entries","current","getInstructionSettingsName","modelId","getInstructionUseCase","resolveEffectiveInstructionSettings","defaults","instructions","settingsName","useCase","effectiveSettings","defaultsForUseCase","instructionSettings","selectedProvider","provider","existingOpts","providerOptions","existingProviderOpts","incomingProviderOpts","applyInstructionDefaultsForDisplay","group","updatedGroup","model","voice","JSON","stringify"],"mappings":"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"}

package/dist/{endpoints → utilities}/buildPromptUtils.js

@@ -1,7 +1,8 @@
-import { defaultPrompts } from '../ai/prompts.js';
+import { defaultPrompts } from '../ai/utilities/prompts.js';
 import { asyncHandlebars } from '../libraries/handlebars/asyncHandlebars.js';
 import { handlebarsHelpersMap } from '../libraries/handlebars/helpersMap.js';
 import { replacePlaceholders } from '../libraries/handlebars/replacePlaceholders.js';
+import { lexicalToPromptTemplate } from '../utilities/lexical/lexicalToPromptTemplate.js';
 const buildRichTextSystem = (baseSystem, layout)=>{
     return `${baseSystem}
 
@@ -65,7 +66,7 @@ export const assignPrompt = async (action, { type, actionParams, collection, con
         systemPrompt
     }) : '';
     return {
-        layout: updatedLayout,
+        layout: type === 'richText' ? updatedLayout : undefined,
         // TODO: revisit this toLexicalHTML
         prompt: await replacePlaceholders(`{{${toLexicalHTML} ${field}}}`, extendedContext),
         system: type === 'richText' ? buildRichTextSystem(system, updatedLayout) : system
@@ -73,19 +74,27 @@ export const assignPrompt = async (action, { type, actionParams, collection, con
 };
 export const extendContextWithPromptFields = (data, ctx, pluginConfig)=>{
     const { promptFields = [] } = pluginConfig;
-    const fieldsMap = new Map(promptFields.filter((f)=>!f.collections || f.collections.includes(ctx.collection)).map((f)=>[
+    const fieldsMap = new Map((promptFields || []).filter((f)=>!f.collections || f.collections.includes(ctx.collection)).map((f)=>[
             f.name,
             f
         ]));
     return new Proxy(data, {
         get: (target, prop)=>{
             const field = fieldsMap.get(prop);
-            if (field?.getter) {
+            if (field && 'getter' in field && typeof field.getter === 'function') {
                 const value = field.getter(data, ctx);
                 return Promise.resolve(value).then((v)=>new asyncHandlebars.SafeString(v));
             }
             // {{prop}} escapes content by default. Here we make sure it won't be escaped.
             const value = typeof target === 'object' ? target[prop] : undefined;
+            // If the value is a Lexical JSON object (e.g. a PromptField / richText field),
+            // convert it to a template string AND resolve any internal mention variables
+            // (like {{name}}) against the raw document data to avoid unresolved placeholders.
+            if (value && typeof value === 'object' && value.root && Array.isArray(value.root.children)) {
+                const template = lexicalToPromptTemplate(value);
+                // Resolve inner variables using the raw target (not the Proxy) to avoid recursion
+                return replacePlaceholders(template, target).then((resolved)=>new asyncHandlebars.SafeString(resolved));
+            }
             return typeof value === 'string' ? new asyncHandlebars.SafeString(value) : value;
         },
         // It's used by the handlebars library to determine if the property is enumerable
@@ -104,7 +113,7 @@ export const extendContextWithPromptFields = (data, ctx, pluginConfig)=>{
         },
         ownKeys: (target)=>{
             return [
-                ...fieldsMap.keys(),
+                ...Array.from(fieldsMap.keys()),
                 ...Object.keys(target || {})
             ];
         }

package/dist/utilities/buildPromptUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/buildPromptUtils.ts"],"sourcesContent":["import type { CollectionSlug } from 'payload'\n\nimport type { ActionMenuItems, PluginConfig, PromptFieldGetterContext } from '../types.js'\n\nimport { defaultPrompts } from '../ai/utilities/prompts.js'\nimport { asyncHandlebars } from '../libraries/handlebars/asyncHandlebars.js'\nimport { handlebarsHelpersMap } from '../libraries/handlebars/helpersMap.js'\nimport { replacePlaceholders } from '../libraries/handlebars/replacePlaceholders.js'\nimport { lexicalToPromptTemplate } from '../utilities/lexical/lexicalToPromptTemplate.js'\n\nconst buildRichTextSystem = (baseSystem: string, layout: string) => {\n  return `${baseSystem}\n\nRULES:\n- Generate original and unique content based on the given topic.\n- Strictly adhere to the specified layout and formatting instructions.\n- Utilize the provided rich text editor tools for appropriate formatting.\n- Ensure the output follows the structure of the sample output object.\n- Produce valid JSON with no undefined or null values.\n---\nLAYOUT INSTRUCTIONS:\n${layout}\n\n---\nADDITIONAL GUIDELINES:\n- Ensure coherence and logical flow between all sections.\n- Maintain a consistent tone and style throughout the content.\n- Use clear and concise language appropriate for the target audience.\n`\n}\n\nexport const assignPrompt = async (\n  action: ActionMenuItems,\n  {\n    type,\n    actionParams,\n    collection,\n    context,\n    field,\n    layout,\n    locale,\n    pluginConfig,\n    systemPrompt = '',\n    template,\n  }: {\n    actionParams: Record<any, any>\n    collection: CollectionSlug\n    context: object\n    field: string\n    layout: string\n    locale: string\n    pluginConfig: PluginConfig\n    systemPrompt: string\n    template: string\n    type: string\n  },\n) => {\n  const extendedContext = extendContextWithPromptFields(context, { type, collection }, pluginConfig)\n  const prompt = await replacePlaceholders(template, extendedContext)\n  const toLexicalHTML = type === 'richText' ? handlebarsHelpersMap.toHTML.name : ''\n\n  const assignedPrompts = {\n    layout: type === 'richText' ? layout : undefined,\n    prompt,\n    //TODO: Define only once on a collection level\n    system: type === 'richText' ? buildRichTextSystem(systemPrompt, layout) : undefined,\n  }\n\n  if (action === 'Compose') {\n    if (locale && locale !== 'en') {\n      /**\n       * NOTE: Avoid using the \"system prompt\" for setting the output language,\n       * as it causes quotation marks to appear in the output (Currently only tested with openai models).\n       * Appending the language instruction directly to the prompt resolves this issue. - revalidate\n       **/\n      assignedPrompts.prompt += `\n    ---  \n    OUTPUT LANGUAGE: ${locale}\n    `\n    }\n\n    return assignedPrompts\n  }\n\n  const prompts = [...(pluginConfig.prompts || []), ...defaultPrompts]\n  const foundPrompt = prompts.find((p) => p.name === action)\n  const getLayout = foundPrompt?.layout\n  const getSystemPrompt = foundPrompt?.system\n\n  let updatedLayout = layout\n  if (getLayout) {\n    updatedLayout = getLayout()\n  }\n\n  const system = getSystemPrompt\n    ? getSystemPrompt({\n        ...(actionParams || {}),\n        prompt,\n        systemPrompt,\n      })\n    : ''\n\n  return {\n    layout: type === 'richText' ? updatedLayout : undefined,\n    // TODO: revisit this toLexicalHTML\n    prompt: await replacePlaceholders(`{{${toLexicalHTML} ${field}}}`, extendedContext),\n    system: type === 'richText' ? buildRichTextSystem(system, updatedLayout) : system,\n  }\n}\n\nexport const extendContextWithPromptFields = (\n  data: object,\n  ctx: PromptFieldGetterContext,\n  pluginConfig: PluginConfig,\n) => {\n  const { promptFields = [] } = pluginConfig\n  const fieldsMap = new Map(\n    (promptFields || [])\n      .filter((f: any) => !f.collections || f.collections.includes(ctx.collection))\n      .map((f: any) => [f.name, f]),\n  )\n  return new Proxy(data, {\n    get: (target, prop: string) => {\n      const field = fieldsMap.get(prop)\n      if (field && 'getter' in field && typeof field.getter === 'function') {\n        const value = field.getter(data, ctx)\n        return Promise.resolve(value).then((v) => new asyncHandlebars.SafeString(v))\n      }\n      // {{prop}} escapes content by default. Here we make sure it won't be escaped.\n      const value = typeof target === 'object' ? (target as any)[prop] : undefined\n\n      // If the value is a Lexical JSON object (e.g. a PromptField / richText field),\n      // convert it to a template string AND resolve any internal mention variables\n      // (like {{name}}) against the raw document data to avoid unresolved placeholders.\n      if (value && typeof value === 'object' && value.root && Array.isArray(value.root.children)) {\n        const template = lexicalToPromptTemplate(value)\n        // Resolve inner variables using the raw target (not the Proxy) to avoid recursion\n        return replacePlaceholders(template, target).then(\n          (resolved) => new asyncHandlebars.SafeString(resolved),\n        )\n      }\n\n      return typeof value === 'string' ? new asyncHandlebars.SafeString(value) : value\n    },\n    // It's used by the handlebars library to determine if the property is enumerable\n    getOwnPropertyDescriptor: (target, prop) => {\n      const field = fieldsMap.get(prop as string)\n      if (field) {\n        return {\n          configurable: true,\n          enumerable: true,\n        }\n      }\n      return Object.getOwnPropertyDescriptor(target, prop)\n    },\n    has: (target, prop) => {\n      return fieldsMap.has(prop as string) || (target && prop in target)\n    },\n    ownKeys: (target) => {\n      return [...Array.from(fieldsMap.keys()), ...Object.keys(target || {})]\n    },\n  })\n}\n"],"names":["defaultPrompts","asyncHandlebars","handlebarsHelpersMap","replacePlaceholders","lexicalToPromptTemplate","buildRichTextSystem","baseSystem","layout","assignPrompt","action","type","actionParams","collection","context","field","locale","pluginConfig","systemPrompt","template","extendedContext","extendContextWithPromptFields","prompt","toLexicalHTML","toHTML","name","assignedPrompts","undefined","system","prompts","foundPrompt","find","p","getLayout","getSystemPrompt","updatedLayout","data","ctx","promptFields","fieldsMap","Map","filter","f","collections","includes","map","Proxy","get","target","prop","getter","value","Promise","resolve","then","v","SafeString","root","Array","isArray","children","resolved","getOwnPropertyDescriptor","configurable","enumerable","Object","has","ownKeys","from","keys"],"mappings":"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"}

package/dist/utilities/buildSmartPrompt.js

@@ -1,8 +1,8 @@
 'use strict';
-import { getFieldBySchemaPath } from './getFieldBySchemaPath.js';
+import { getFieldBySchemaPath } from './fields/getFieldBySchemaPath.js';
 /**
  * Extract field information from a schema path
- */ const getFieldInfo = (schemaPath, payload)=>{
+ */ const extractFieldInfo = (schemaPath, payload)=>{
     const parts = schemaPath.split('.');
     const collectionSlug = parts[0];
     const fieldPath = parts.slice(1);
@@ -97,7 +97,7 @@ import { getFieldBySchemaPath } from './getFieldBySchemaPath.js';
  * @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 fieldInfo = extractFieldInfo(schemaPath, payload);
     const { name, type, field, label, parentContext } = fieldInfo;
     // Start with the field's own description if available
     const description = getFieldDescription(field);

package/dist/utilities/buildSmartPrompt.js.map

@@ -1 +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) {\n    return null\n  }\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(`Field description for user: ${description}\\n`)\n  }\n\n  parts.push(getTypeGuidance(type, label || name))\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 || documentData?.name\n\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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"}
+{"version":3,"sources":["../../src/utilities/buildSmartPrompt.ts"],"sourcesContent":["'use strict'\n\nimport type { Field, Payload } from 'payload'\n\nimport { getFieldBySchemaPath } from './fields/getFieldBySchemaPath.js'\nimport { stringToLexicalJSON } from './lexical/stringToLexicalJSON.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 extractFieldInfo = (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) {\n    return null\n  }\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 = extractFieldInfo(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(`Field description for user: ${description}\\n`)\n  }\n\n  parts.push(getTypeGuidance(type, label || name))\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 || documentData?.name\n\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","extractFieldInfo","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/fields/fieldToJsonSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utilities/fields/fieldToJsonSchema.ts"],"sourcesContent":["/**\n * fieldToJsonSchema\n * Convert a Payload Field (server or client) into a minimal JSON Schema object,\n * wrapped as { type: 'object', properties: { [name]: valueSchema }, required: [...] }\n *\n * Supported types:\n * - text, textarea, select, number, date, code, email, json\n * Arrays are emitted only when field.hasMany is true and the field type supports hasMany\n * (text, textarea, select; for others only if your config truly sets hasMany).\n */\nimport type { Field } from 'payload'\n\nexport type JsonSchema = Record<string, any>;\n\n// Narrowed minimal typing to avoid anywhere possible without pulling the full payload types at runtime.\n// In a Payload project, you can import type { Field, ClientField } from 'payload' and use those instead.\ntype BaseField = {\n  admin?: {\n    description?: unknown;\n    language?: unknown;\n  };\n  hasMany?: boolean;\n  // json\n  jsonSchema?: unknown;\n  max?: number;\n  maxRows?: number;\n  // number\n  min?: number;\n  // text/textarea\n  minRows?: number;\n  name?: string;\n  // select\n  options?: Array<\n    | {\n        label?: unknown;\n        value: number | string;\n      }\n    | number\n    | string\n  >;\n  required?: boolean;\n  schema?: unknown;\n  type?: string;\n  typescriptSchema?: unknown;\n};\n\nfunction isString(s: unknown): s is string {\n  return typeof s === 'string';\n}\n\nfunction isPlainObject(o: unknown): o is Record<string, unknown> {\n  return !!o && typeof o === 'object' && !Array.isArray(o);\n}\n\nfunction getDescription(field: BaseField): string | undefined {\n  const d = field?.admin?.description;\n  return typeof d === 'string' ? d : undefined;\n}\n\nfunction stringWithDescription(field: BaseField) {\n  const out: Record<string, any> = { type: 'string' };\n  const description = getDescription(field);\n  if (description) {out.description = description;}\n  return out;\n}\n\nfunction numberWithBounds(field: BaseField) {\n  const out: Record<string, any> = { type: 'number' };\n  if (typeof field.min === 'number') {out.minimum = field.min;}\n  if (typeof field.max === 'number') {out.maximum = field.max;}\n  const description = getDescription(field);\n  if (description) {out.description = description;}\n  return out;\n}\n\nfunction dateSchema(field: BaseField) {\n  const out: Record<string, any> = { type: 'string', format: 'date-time' };\n  const description = getDescription(field);\n  if (description) {out.description = description;}\n  return out;\n}\n\nfunction codeSchema(field: BaseField) {\n  const out: Record<string, any> = { type: 'string' };\n  let description = getDescription(field);\n  const lang = field?.admin?.language;\n  if (typeof lang === 'string' && lang.trim()) {\n    description = description ? `${description} (language: ${lang})` : `language: ${lang}`;\n  }\n  if (description) {out.description = description;}\n  return out;\n}\n\nfunction emailSchema(field: BaseField) {\n  const out: Record<string, any> = { type: 'string', format: 'email' };\n  const description = getDescription(field);\n  if (description) {out.description = description;}\n  return out;\n}\n\nfunction jsonValueSchema(field: BaseField) {\n  // Prefer a provided JSON Schema object\n  if (isPlainObject(field.jsonSchema)) {return field.jsonSchema as object;}\n  if (isPlainObject(field.schema)) {return field.schema as object;}\n\n  // typescriptSchema cannot be executed here; default to object\n  return { type: 'object' };\n}\n\nfunction normalizeSelectOptions(field: BaseField): { values: Array<number | string>; valueType: 'number' | 'string' } {\n  const raw = field.options || [];\n  const values: Array<number | string> = [];\n\n  for (const opt of raw) {\n    if (typeof opt === 'string' || typeof opt === 'number') {\n      values.push(opt);\n    } else if (isPlainObject(opt) && ('value' in opt)) {\n      const v = (opt as any).value;\n      if (typeof v === 'string' || typeof v === 'number') {\n        values.push(v);\n      }\n    }\n  }\n\n  // Infer primitive type\n  const allNumbers = values.length > 0 && values.every((v) => typeof v === 'number');\n  const valueType: 'number' | 'string' = allNumbers ? 'number' : 'string';\n  return { values, valueType };\n}\n\nfunction supportsHasMany(fieldType: string | undefined): boolean {\n  // Out of the box: text, textarea, select support hasMany\n  // Others can be arrays only if your config truly sets hasMany; we return boolean based on type here.\n  return fieldType === 'text' || fieldType === 'textarea' || fieldType === 'select';\n}\n\nexport function fieldToJsonSchema(\n  fieldInput: BaseField & Field,\n  opts?: { nameOverride?: string; wrapObject?: boolean },\n): JsonSchema {\n  const field = fieldInput || {};\n  const name = isString(opts?.nameOverride) && opts?.nameOverride.length ? opts.nameOverride : (field.name || 'value');\n  const type = field.type;\n\n  let valueSchema: null | Record<string, any> = null;\n\n  switch (type) {\n    case 'array':\n    case 'group': {\n      if ('fields' in field && Array.isArray(field.fields)) {\n        const properties: Record<string, any> = {}\n        const required: string[] = []\n        \n        const processFields = (fields: any[]) => {\n          for (const subField of fields) {\n            if (subField.type === 'row' || subField.type === 'collapsible') {\n               if (subField.fields) {processFields(subField.fields)}\n               continue\n            }\n            if (!subField.name || subField.name === 'id') {continue}\n\n            const subSchema = fieldToJsonSchema(subField, { wrapObject: false })\n            if (subSchema && Object.keys(subSchema).length > 0) {\n              properties[subField.name] = subSchema\n              // OpenAI Strict Mode: All fields must be required\n              required.push(subField.name)\n              \n              // If field is optional in Payload, allow null in schema\n              if (!subField.required) {\n                // Arrays usually default to empty array [], so we don't make them nullable\n                // Groups and other types can be null\n                 if (subSchema.type !== 'array') {\n                   if (Array.isArray(subSchema.type)) {\n                     if (!subSchema.type.includes('null')) {\n                       subSchema.type.push('null')\n                     }\n                   } else if (typeof subSchema.type === 'string' && subSchema.type !== 'null') {\n                     subSchema.type = [subSchema.type, 'null']\n                   }\n                   \n                   // If enum is present, we must allow null in enum or use anyOf? \n                   // OpenAI strict mode: \"enum values must be consistent with type\". \n                   // If type is [string, null], null is a valid value for the type, but if enum is [\"a\"], null is not in enum.\n                   // valid: { type: [\"string\", \"null\"], enum: [\"a\", null] } \n                   if (Array.isArray(subSchema.enum) && !subSchema.enum.includes(null)) {\n                     subSchema.enum.push(null)\n                   }\n                 }\n              }\n            }\n          }\n        }\n        \n        processFields(field.fields)\n\n        const objSchema = {\n          type: 'object',\n          additionalProperties: false,\n          properties,\n          required: required.length ? required : undefined\n        }\n\n        if (type === 'array') {\n          valueSchema = {\n            type: 'array',\n            items: objSchema\n          }\n          if (typeof field.maxRows === 'number') {\n            valueSchema.maxItems = field.maxRows\n          }\n           if (typeof field.minRows === 'number') {\n            valueSchema.minItems = field.minRows\n          }\n        } else {\n          valueSchema = objSchema\n        }\n        \n        const description = getDescription(field);\n        if (description) {valueSchema.description = description;}\n      }\n      break;\n    }\n\n    case 'checkbox': {\n      valueSchema = { type: 'boolean' };\n      const description = getDescription(field);\n      if (description) {valueSchema.description = description;}\n      break;\n    }\n\n    case 'code': {\n      const base = codeSchema(field);\n      if (field.hasMany) {\n        valueSchema = { type: 'array', items: base };\n      } else {\n        valueSchema = base;\n      }\n      break;\n    }\n\n    case 'date': {\n      const base = dateSchema(field);\n      if (field.hasMany) {\n        valueSchema = { type: 'array', items: base };\n      } else {\n        valueSchema = base;\n      }\n      break;\n    }\n\n    case 'email': {\n      const base = emailSchema(field);\n      if (field.hasMany) {\n        valueSchema = { type: 'array', items: base };\n      } else {\n        valueSchema = base;\n      }\n      break;\n    }\n\n    case 'json': {\n      const base = jsonValueSchema(field);\n      if (field.hasMany) {\n        valueSchema = { type: 'array', items: base };\n      } else {\n        valueSchema = base as Record<string, any>;\n      }\n      break;\n    }\n\n    case 'number': {\n      const base = numberWithBounds(field);\n      if (field.hasMany) {\n        valueSchema = { type: 'array', items: base };\n      } else {\n        valueSchema = base;\n      }\n      break;\n    }\n    case 'select': {\n      const { values, valueType } = normalizeSelectOptions(field);\n      const baseSingle: Record<string, any> = { type: valueType, enum: values };\n      const description = getDescription(field);\n      if (description) {baseSingle.description = description;}\n\n      if (field.hasMany && supportsHasMany(type)) {\n        valueSchema = {\n          type: 'array',\n          items: { type: valueType, enum: values },\n          ...(description ? { description } : {}),\n        };\n      } else {\n        valueSchema = baseSingle;\n      }\n      break;\n    }\n\n    case 'text':\n    case 'textarea': {\n      const base = stringWithDescription(field);\n      if (field.hasMany && supportsHasMany(type)) {\n        const arr: Record<string, any> = {\n          type: 'array',\n          items: { type: 'string' },\n        };\n        if (typeof field.minRows === 'number') {arr.minItems = field.minRows;}\n        if (typeof field.maxRows === 'number') {arr.maxItems = field.maxRows;}\n        if (base.description) {arr.description = base.description;}\n        valueSchema = arr;\n      } else {\n        valueSchema = base;\n      }\n      break;\n    }\n    \n    // Explicitly handle organizational types to avoid default breakage if passed directly\n    // though usually they are handled by parent recursion in group/array case above.\n    // If passed as root, we can't really return a meaningful single-value schema without a wrapper?\n    // But let's leave default for them or handle if necessary. \n    // For now, if someone passes a 'row' as root, it will fall to default (null).\n\n    default: {\n      valueSchema = null;\n      break;\n    }\n  }\n\n  const wrap = opts?.wrapObject !== false;\n\n  if (!wrap) {\n    return (valueSchema || {}) as JsonSchema;\n  }\n\n  if (!valueSchema) {\n    return {} as JsonSchema;\n  }\n\n  const schema: JsonSchema = {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      [name]: valueSchema,\n    },\n    required: [name]\n  };\n\n  return schema;\n}\n"],"names":["isString","s","isPlainObject","o","Array","isArray","getDescription","field","d","admin","description","undefined","stringWithDescription","out","type","numberWithBounds","min","minimum","max","maximum","dateSchema","format","codeSchema","lang","language","trim","emailSchema","jsonValueSchema","jsonSchema","schema","normalizeSelectOptions","raw","options","values","opt","push","v","value","allNumbers","length","every","valueType","supportsHasMany","fieldType","fieldToJsonSchema","fieldInput","opts","name","nameOverride","valueSchema","fields","properties","required","processFields","subField","subSchema","wrapObject","Object","keys","includes","enum","objSchema","additionalProperties","items","maxRows","maxItems","minRows","minItems","base","hasMany","baseSingle","arr","wrap"],"mappings":"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"}

package/dist/utilities/fields/getFieldBySchemaPath.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utilities/fields/getFieldBySchemaPath.ts"],"sourcesContent":["import type { ClientCollectionConfig, CollectionConfig, Field } from 'payload'\n\ntype AnyCollectionConfig = ClientCollectionConfig | CollectionConfig\n\n/**\n * Resolve a Payload field definition by a full schemaPath like:\n *   \"{collectionSlug}.fieldA.subFieldB.blockSlug.innerField\"\n *\n * Notes:\n * - Tabs are a UI construct and are not part of schemaPath (fields inside tabs are at the same level).\n * - Blocks include the block slug as part of the path (we must consume it between the block field and its inner fields).\n * - Rows are skipped by this plugin&#39;s schema path mapping; support added defensively.\n */\nexport const getFieldBySchemaPath = (\n  collectionConfig: AnyCollectionConfig,\n  schemaPath: string,\n): Field | null => {\n  if (!collectionConfig || !schemaPath) {\n    return null\n  }\n\n  const parts = schemaPath.split('.')\n  if (!parts.length) {\n    return null\n  }\n\n  // Strip the collection slug prefix if present\n  const [collectionSlug, ...rest] = parts\n  const pathParts =\n    collectionSlug === collectionConfig.slug ? rest.filter(Boolean) : parts.filter(Boolean)\n\n  if (!pathParts.length) {\n    return null\n  }\n\n  const findInFields = (fields: Field[], segments: string[]): Field | null => {\n    if (!segments.length) {\n      return null\n    }\n\n    const [current, ...remaining] = segments\n\n    // First, try to match a field by name\n    for (const field of fields) {\n      // Tabs do not contribute to path segments; search inside all tabs with the same segments\n      if ((field as any).tabs) {\n        const tabs = (field as any).tabs as Array<{ fields?: Field[] }>\n        for (const tab of tabs) {\n          const foundInTab =\n            tab.fields && tab.fields.length ? findInFields(tab.fields, segments) : null\n          if (foundInTab) {\n            return foundInTab\n          }\n        }\n      }\n\n      // Handle unnamed groups and collapsibles (they don't contribute to path)\n      // Groups without names are just wrappers, their children are at the same path level\n      if ((field as any).type === 'group' && !(field as any).name && (field as any).fields) {\n        const foundInUnnamedGroup = findInFields((field as any).fields, segments)\n        if (foundInUnnamedGroup) {\n          return foundInUnnamedGroup\n        }\n      }\n\n      // Handle unnamed collapsibles similarly\n      if ((field as any).type === 'collapsible' && (field as any).fields) {\n        const foundInCollapsible = findInFields((field as any).fields, segments)\n        if (foundInCollapsible) {\n          return foundInCollapsible\n        }\n      }\n\n      if ((field as any).name === current) {\n        // If this is the last segment, we found the target field\n        if (remaining.length === 0) {\n          return field\n        }\n\n        // Recurse into composite field types\n        if ((field as any).fields && Array.isArray((field as any).fields)) {\n          const found = findInFields((field as any).fields, remaining)\n          if (found) {\n            return found\n          }\n        }\n\n        if ((field as any).blocks && Array.isArray((field as any).blocks)) {\n          // Next segment should be a block slug, then continue into block fields\n          if (!remaining.length) {\n            return field\n          } // path stops at block container (unlikely for our mapping)\n          const [blockSlug, ...afterBlock] = remaining\n          const blocks = (field as any).blocks as Array<{ fields: Field[]; slug: string }>\n          const block = blocks.find((b) => b.slug === blockSlug)\n          if (block) {\n            const found = findInFields(block.fields, afterBlock)\n            if (found) {\n              return found\n            }\n          }\n        }\n      }\n    }\n\n    // Not found at this level\n    return null\n  }\n\n  const rootFields = (collectionConfig as any).fields as Field[] | undefined\n  if (!rootFields || !Array.isArray(rootFields)) {\n    return null\n  }\n\n  return findInFields(rootFields, pathParts)\n}\n"],"names":["getFieldBySchemaPath","collectionConfig","schemaPath","parts","split","length","collectionSlug","rest","pathParts","slug","filter","Boolean","findInFields","fields","segments","current","remaining","field","tabs","tab","foundInTab","type","name","foundInUnnamedGroup","foundInCollapsible","Array","isArray","found","blocks","blockSlug","afterBlock","block","find","b","rootFields"],"mappings":"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"}

package/dist/utilities/fields/getFieldInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utilities/fields/getFieldInfo.ts"],"sourcesContent":["import type { BasePayload } from 'payload'\n\nimport { getFieldBySchemaPath } from './getFieldBySchemaPath.js'\n\nexport const getFieldInfo = (collections: BasePayload['collections'], schemaPath: string) => {\n  let fieldInfo = null\n  //TODO: Only run below for enabled collections\n  for (const collectionsKey in collections) {\n    const collection = collections[collectionsKey]\n    fieldInfo = getFieldBySchemaPath(collection.config, schemaPath)\n    if (fieldInfo) {\n      return fieldInfo\n    }\n  }\n}\n"],"names":["getFieldBySchemaPath","getFieldInfo","collections","schemaPath","fieldInfo","collectionsKey","collection","config"],"mappings":"AAEA,SAASA,oBAAoB,QAAQ,4BAA2B;AAEhE,OAAO,MAAMC,eAAe,CAACC,aAAyCC;IACpE,IAAIC,YAAY;IAChB,8CAA8C;IAC9C,IAAK,MAAMC,kBAAkBH,YAAa;QACxC,MAAMI,aAAaJ,WAAW,CAACG,eAAe;QAC9CD,YAAYJ,qBAAqBM,WAAWC,MAAM,EAAEJ;QACpD,IAAIC,WAAW;YACb,OAAOA;QACT;IACF;AACF,EAAC"}