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

package/dist/fields/PromptEditorField/feature.client.js

@@ -0,0 +1,173 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useLexicalComposerContext } from '@lexical/react/LexicalComposerContext';
+import { createClientFeature } from '@payloadcms/richtext-lexical/client';
+import { useDocumentInfo, useFormFields, useTranslation } from '@payloadcms/ui';
+import { BeautifulMentionNode, BeautifulMentionsPlugin } from 'lexical-beautiful-mentions';
+import React, { useCallback } from 'react';
+const MENTION_SUGGESTIONS_TTL_MS = 60_000;
+const mentionSuggestionsCache = new Map();
+const mentionSuggestionsInFlight = new Map();
+const getMentionCacheKey = (collectionSlug, trigger)=>`${collectionSlug}:${trigger}`;
+const fetchMentionSuggestions = async (collectionSlug, trigger)=>{
+    const cacheKey = getMentionCacheKey(collectionSlug, trigger);
+    const now = Date.now();
+    const cached = mentionSuggestionsCache.get(cacheKey);
+    if (cached && cached.expiresAt > now) {
+        return cached.items;
+    }
+    const existingRequest = mentionSuggestionsInFlight.get(cacheKey);
+    if (existingRequest) {
+        return existingRequest;
+    }
+    const request = (async ()=>{
+        const params = new URLSearchParams({
+            collection: collectionSlug,
+            q: '',
+            trigger
+        });
+        try {
+            const response = await fetch(`/api/prompt-mentions?${params.toString()}`);
+            if (!response.ok) {
+                return [];
+            }
+            const data = await response.json();
+            const items = (data.items || []).map((item)=>({
+                    ...item,
+                    value: item.id || item.value
+                }));
+            mentionSuggestionsCache.set(cacheKey, {
+                expiresAt: now + MENTION_SUGGESTIONS_TTL_MS,
+                items
+            });
+            return items;
+        } catch (e) {
+            console.error(`Failed to fetch suggestions for ${trigger}`, e);
+            return [];
+        } finally{
+            mentionSuggestionsInFlight.delete(cacheKey);
+        }
+    })();
+    mentionSuggestionsInFlight.set(cacheKey, request);
+    return request;
+};
+const PromptMentionsMenu = ({ children, className, loading, ref, style, ...props })=>{
+    const { t } = useTranslation();
+    return /*#__PURE__*/ _jsx("ul", {
+        className: className,
+        ref: ref,
+        style: {
+            backgroundColor: 'var(--theme-elevation-0)',
+            border: '1px solid var(--theme-elevation-200)',
+            borderRadius: '4px',
+            boxShadow: '0 4px 12px 0 rgba(0,0,0,0.1)',
+            listStyle: 'none',
+            margin: 0,
+            maxHeight: '300px',
+            minWidth: '250px',
+            overflowY: 'auto',
+            padding: '4px 0',
+            position: 'absolute',
+            width: 'max-content',
+            zIndex: 100,
+            ...style
+        },
+        ...props,
+        children: loading ? /*#__PURE__*/ _jsx("li", {
+            style: {
+                color: 'var(--theme-elevation-500)',
+                fontSize: '14px',
+                padding: '8px 12px'
+            },
+            children: t('ai-plugin:general:loading')
+        }) : children
+    });
+};
+PromptMentionsMenu.displayName = 'PromptMentionsMenu';
+const PromptMentionsMenuItem = ({ children, className, isFocused, itemValue: _itemValue, label, ref, selected, style, ...props })=>{
+    return /*#__PURE__*/ _jsx("li", {
+        className: className,
+        ref: ref,
+        style: {
+            alignItems: 'center',
+            backgroundColor: selected || isFocused ? 'var(--theme-elevation-100)' : 'transparent',
+            color: 'var(--theme-elevation-800)',
+            cursor: 'pointer',
+            display: 'flex',
+            fontSize: '14px',
+            lineHeight: '1.5',
+            padding: '8px 12px',
+            whiteSpace: 'nowrap',
+            ...style
+        },
+        ...props,
+        children: label || children
+    });
+};
+PromptMentionsMenuItem.displayName = 'PromptMentionsMenuItem';
+const PromptMentionsPlugin = ()=>{
+    useLexicalComposerContext();
+    const suggestionsRef = React.useRef({});
+    // Get schema-path from the form to determine the target collection (Instructions context)
+    const schemaPathField = useFormFields(([fields])=>fields['schema-path']);
+    const schemaPath = schemaPathField?.value;
+    // Get current document info (Regular Collection context)
+    const { collectionSlug: currentCollectionSlug } = useDocumentInfo();
+    // Determine effective collection slug
+    // 1. If schemaPath exists (Instructions), derive slug from it (e.g. "products.name" -> "products")
+    // 2. Fallback to current collection slug (e.g. editing a Product directly)
+    const collectionSlug = schemaPath ? schemaPath.split('.')[0] : currentCollectionSlug;
+    // Pre-fetch suggestions when collectionSlug changes
+    React.useEffect(()=>{
+        const fetchSuggestions = async ()=>{
+            if (!collectionSlug) {
+                return;
+            }
+            const triggers = [
+                '@',
+                '#'
+            ];
+            const newSuggestions = {};
+            await Promise.all(triggers.map(async (trigger)=>{
+                newSuggestions[trigger] = await fetchMentionSuggestions(collectionSlug, trigger);
+            }));
+            suggestionsRef.current = newSuggestions;
+        };
+        fetchSuggestions().catch(console.error);
+    }, [
+        collectionSlug
+    ]);
+    const queryMentions = useCallback(async (trigger, queryString)=>{
+        const items = suggestionsRef.current[trigger] || [];
+        if (!queryString) {
+            return items;
+        }
+        const lowerQuery = queryString.toLowerCase();
+        return items.filter((item)=>{
+            const display = item.display || item.value || '';
+            return display.toLowerCase().includes(lowerQuery);
+        });
+    }, []);
+    return /*#__PURE__*/ _jsx(BeautifulMentionsPlugin, {
+        menuComponent: PromptMentionsMenu,
+        menuItemComponent: PromptMentionsMenuItem,
+        onSearch: queryMentions,
+        triggers: [
+            '@',
+            '#'
+        ]
+    });
+};
+export const PromptMentionsClient = createClientFeature({
+    nodes: [
+        BeautifulMentionNode
+    ],
+    plugins: [
+        {
+            Component: PromptMentionsPlugin,
+            position: 'normal'
+        }
+    ]
+});
+
+//# sourceMappingURL=feature.client.js.map

package/dist/fields/PromptEditorField/feature.client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/fields/PromptEditorField/feature.client.tsx"],"sourcesContent":["'use client'\n\nimport type {\n  BeautifulMentionsItem} from 'lexical-beautiful-mentions';\n\nimport { useLexicalComposerContext } from '@lexical/react/LexicalComposerContext'\nimport { createClientFeature } from '@payloadcms/richtext-lexical/client'\nimport { useDocumentInfo, useFormFields, useTranslation } from '@payloadcms/ui'\nimport {\n  BeautifulMentionNode,\n  BeautifulMentionsPlugin,\n} from 'lexical-beautiful-mentions'\nimport React, { useCallback } from 'react'\n\ntype MentionSuggestion = {\n  display?: string\n  id?: string\n  value?: string\n} & BeautifulMentionsItem\n\nconst MENTION_SUGGESTIONS_TTL_MS = 60_000\nconst mentionSuggestionsCache = new Map<string, { expiresAt: number; items: MentionSuggestion[] }>()\nconst mentionSuggestionsInFlight = new Map<string, Promise<MentionSuggestion[]>>()\n\nconst getMentionCacheKey = (collectionSlug: string, trigger: string): string =>\n  `${collectionSlug}:${trigger}`\n\nconst fetchMentionSuggestions = async (\n  collectionSlug: string,\n  trigger: string,\n): Promise<MentionSuggestion[]> => {\n  const cacheKey = getMentionCacheKey(collectionSlug, trigger)\n  const now = Date.now()\n  const cached = mentionSuggestionsCache.get(cacheKey)\n\n  if (cached && cached.expiresAt > now) {\n    return cached.items\n  }\n\n  const existingRequest = mentionSuggestionsInFlight.get(cacheKey)\n  if (existingRequest) {\n    return existingRequest\n  }\n\n  const request = (async () => {\n    const params = new URLSearchParams({\n      collection: collectionSlug,\n      q: '',\n      trigger,\n    })\n\n    try {\n      const response = await fetch(`/api/prompt-mentions?${params.toString()}`)\n      if (!response.ok) {\n        return []\n      }\n\n      const data = await response.json()\n      const items = (data.items || []).map((item: any) => ({\n        ...item,\n        value: item.id || item.value,\n      })) as MentionSuggestion[]\n\n      mentionSuggestionsCache.set(cacheKey, {\n        expiresAt: now + MENTION_SUGGESTIONS_TTL_MS,\n        items,\n      })\n\n      return items\n    } catch (e) {\n      console.error(`Failed to fetch suggestions for ${trigger}`, e)\n      return []\n    } finally {\n      mentionSuggestionsInFlight.delete(cacheKey)\n    }\n  })()\n\n  mentionSuggestionsInFlight.set(cacheKey, request)\n  return request\n}\n\nconst PromptMentionsMenu = ({\n  children,\n  className,\n  loading,\n  ref,\n  style,\n  ...props\n}: {\n  children?: React.ReactNode\n  className?: string\n  loading?: boolean\n  role?: string\n  style?: React.CSSProperties\n} & { ref?: React.RefObject<HTMLUListElement | null> }) => {\n  const { t } = useTranslation()\n  return (\n    <ul\n      className={className}\n      ref={ref}\n      style={{\n        backgroundColor: 'var(--theme-elevation-0)',\n        border: '1px solid var(--theme-elevation-200)',\n        borderRadius: '4px',\n        boxShadow: '0 4px 12px 0 rgba(0,0,0,0.1)',\n        listStyle: 'none',\n        margin: 0,\n        maxHeight: '300px',\n        minWidth: '250px',\n        overflowY: 'auto',\n        padding: '4px 0',\n        position: 'absolute',\n        width: 'max-content',\n        zIndex: 100,\n        ...style,\n      }}\n      {...props}\n    >\n      {loading ? (\n        <li\n          style={{\n            color: 'var(--theme-elevation-500)',\n            fontSize: '14px',\n            padding: '8px 12px',\n          }}\n        >\n          {t('ai-plugin:general:loading' as any)}\n        </li>\n      ) : (\n        children\n      )}\n    </ul>\n  )\n}\nPromptMentionsMenu.displayName = 'PromptMentionsMenu'\n\nconst PromptMentionsMenuItem = ({\n  children,\n  className,\n  isFocused,\n  itemValue: _itemValue,\n  label,\n  ref,\n  selected,\n  style,\n  ...props\n}: {\n  children?: React.ReactNode\n  className?: string\n  isFocused?: boolean\n  itemValue?: string\n  label?: string\n  onClick?: () => void\n  onMouseEnter?: () => void\n  role?: string\n  selected?: boolean\n  style?: React.CSSProperties\n} & { ref?: React.RefObject<HTMLLIElement | null> }) => {\n  return (\n    <li\n      className={className}\n      ref={ref}\n      style={{\n        alignItems: 'center',\n        backgroundColor: selected || isFocused ? 'var(--theme-elevation-100)' : 'transparent',\n        color: 'var(--theme-elevation-800)',\n        cursor: 'pointer',\n        display: 'flex',\n        fontSize: '14px',\n        lineHeight: '1.5',\n        padding: '8px 12px',\n        whiteSpace: 'nowrap',\n        ...style,\n      }}\n      {...props}\n    >\n      {label || children}\n    </li>\n  )\n}\nPromptMentionsMenuItem.displayName = 'PromptMentionsMenuItem'\n\nconst PromptMentionsPlugin: React.FC = () => {\n  useLexicalComposerContext()\n  const suggestionsRef = React.useRef<Record<string, MentionSuggestion[]>>({})\n\n  // Get schema-path from the form to determine the target collection (Instructions context)\n  const schemaPathField = useFormFields(([fields]: any) => fields['schema-path'])\n  const schemaPath = schemaPathField?.value as string\n\n  // Get current document info (Regular Collection context)\n  const { collectionSlug: currentCollectionSlug } = useDocumentInfo()\n\n  // Determine effective collection slug\n  // 1. If schemaPath exists (Instructions), derive slug from it (e.g. \"products.name\" -> \"products\")\n  // 2. Fallback to current collection slug (e.g. editing a Product directly)\n  const collectionSlug = schemaPath ? schemaPath.split('.')[0] : currentCollectionSlug\n\n  // Pre-fetch suggestions when collectionSlug changes\n  React.useEffect(() => {\n    const fetchSuggestions = async () => {\n      if (!collectionSlug) {\n        return\n      }\n\n      const triggers = ['@', '#']\n      const newSuggestions: Record<string, any[]> = {}\n\n      await Promise.all(\n        triggers.map(async (trigger) => {\n          newSuggestions[trigger] = await fetchMentionSuggestions(collectionSlug, trigger)\n        }),\n      )\n\n      suggestionsRef.current = newSuggestions\n    }\n\n    fetchSuggestions().catch(console.error)\n  }, [collectionSlug])\n\n  const queryMentions = useCallback(async (trigger: string, queryString?: null | string) => {\n    const items = suggestionsRef.current[trigger] || []\n\n    if (!queryString) {\n      return items as BeautifulMentionsItem[]\n    }\n\n    const lowerQuery = queryString.toLowerCase()\n    return items.filter((item) => {\n      const display = item.display || item.value || ''\n      return display.toLowerCase().includes(lowerQuery)\n    }) as BeautifulMentionsItem[]\n  }, [])\n\n  return (\n    <BeautifulMentionsPlugin\n      menuComponent={PromptMentionsMenu}\n      menuItemComponent={PromptMentionsMenuItem}\n      onSearch={queryMentions}\n      triggers={['@', '#']}\n    />\n  )\n}\n\nexport const PromptMentionsClient = createClientFeature({\n  nodes: [BeautifulMentionNode],\n  plugins: [\n    {\n      Component: PromptMentionsPlugin,\n      position: 'normal',\n    },\n  ],\n})\n"],"names":["useLexicalComposerContext","createClientFeature","useDocumentInfo","useFormFields","useTranslation","BeautifulMentionNode","BeautifulMentionsPlugin","React","useCallback","MENTION_SUGGESTIONS_TTL_MS","mentionSuggestionsCache","Map","mentionSuggestionsInFlight","getMentionCacheKey","collectionSlug","trigger","fetchMentionSuggestions","cacheKey","now","Date","cached","get","expiresAt","items","existingRequest","request","params","URLSearchParams","collection","q","response","fetch","toString","ok","data","json","map","item","value","id","set","e","console","error","delete","PromptMentionsMenu","children","className","loading","ref","style","props","t","ul","backgroundColor","border","borderRadius","boxShadow","listStyle","margin","maxHeight","minWidth","overflowY","padding","position","width","zIndex","li","color","fontSize","displayName","PromptMentionsMenuItem","isFocused","itemValue","_itemValue","label","selected","alignItems","cursor","display","lineHeight","whiteSpace","PromptMentionsPlugin","suggestionsRef","useRef","schemaPathField","fields","schemaPath","currentCollectionSlug","split","useEffect","fetchSuggestions","triggers","newSuggestions","Promise","all","current","catch","queryMentions","queryString","lowerQuery","toLowerCase","filter","includes","menuComponent","menuItemComponent","onSearch","PromptMentionsClient","nodes","plugins","Component"],"mappings":"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"}

package/dist/fields/PromptEditorField/feature.client.jsx

@@ -0,0 +1,148 @@
+'use client';
+import { useLexicalComposerContext } from '@lexical/react/LexicalComposerContext';
+import { createClientFeature } from '@payloadcms/richtext-lexical/client';
+import { useDocumentInfo, useFormFields, useTranslation } from '@payloadcms/ui';
+import { BeautifulMentionNode, BeautifulMentionsPlugin, } from 'lexical-beautiful-mentions';
+import React, { useCallback } from 'react';
+const MENTION_SUGGESTIONS_TTL_MS = 60_000;
+const mentionSuggestionsCache = new Map();
+const mentionSuggestionsInFlight = new Map();
+const getMentionCacheKey = (collectionSlug, trigger) => `${collectionSlug}:${trigger}`;
+const fetchMentionSuggestions = async (collectionSlug, trigger) => {
+    const cacheKey = getMentionCacheKey(collectionSlug, trigger);
+    const now = Date.now();
+    const cached = mentionSuggestionsCache.get(cacheKey);
+    if (cached && cached.expiresAt > now) {
+        return cached.items;
+    }
+    const existingRequest = mentionSuggestionsInFlight.get(cacheKey);
+    if (existingRequest) {
+        return existingRequest;
+    }
+    const request = (async () => {
+        const params = new URLSearchParams({
+            collection: collectionSlug,
+            q: '',
+            trigger,
+        });
+        try {
+            const response = await fetch(`/api/prompt-mentions?${params.toString()}`);
+            if (!response.ok) {
+                return [];
+            }
+            const data = await response.json();
+            const items = (data.items || []).map((item) => ({
+                ...item,
+                value: item.id || item.value,
+            }));
+            mentionSuggestionsCache.set(cacheKey, {
+                expiresAt: now + MENTION_SUGGESTIONS_TTL_MS,
+                items,
+            });
+            return items;
+        }
+        catch (e) {
+            console.error(`Failed to fetch suggestions for ${trigger}`, e);
+            return [];
+        }
+        finally {
+            mentionSuggestionsInFlight.delete(cacheKey);
+        }
+    })();
+    mentionSuggestionsInFlight.set(cacheKey, request);
+    return request;
+};
+const PromptMentionsMenu = ({ children, className, loading, ref, style, ...props }) => {
+    const { t } = useTranslation();
+    return (<ul className={className} ref={ref} style={{
+            backgroundColor: 'var(--theme-elevation-0)',
+            border: '1px solid var(--theme-elevation-200)',
+            borderRadius: '4px',
+            boxShadow: '0 4px 12px 0 rgba(0,0,0,0.1)',
+            listStyle: 'none',
+            margin: 0,
+            maxHeight: '300px',
+            minWidth: '250px',
+            overflowY: 'auto',
+            padding: '4px 0',
+            position: 'absolute',
+            width: 'max-content',
+            zIndex: 100,
+            ...style,
+        }} {...props}>
+      {loading ? (<li style={{
+                color: 'var(--theme-elevation-500)',
+                fontSize: '14px',
+                padding: '8px 12px',
+            }}>
+          {t('ai-plugin:general:loading')}
+        </li>) : (children)}
+    </ul>);
+};
+PromptMentionsMenu.displayName = 'PromptMentionsMenu';
+const PromptMentionsMenuItem = ({ children, className, isFocused, itemValue: _itemValue, label, ref, selected, style, ...props }) => {
+    return (<li className={className} ref={ref} style={{
+            alignItems: 'center',
+            backgroundColor: selected || isFocused ? 'var(--theme-elevation-100)' : 'transparent',
+            color: 'var(--theme-elevation-800)',
+            cursor: 'pointer',
+            display: 'flex',
+            fontSize: '14px',
+            lineHeight: '1.5',
+            padding: '8px 12px',
+            whiteSpace: 'nowrap',
+            ...style,
+        }} {...props}>
+      {label || children}
+    </li>);
+};
+PromptMentionsMenuItem.displayName = 'PromptMentionsMenuItem';
+const PromptMentionsPlugin = () => {
+    useLexicalComposerContext();
+    const suggestionsRef = React.useRef({});
+    // Get schema-path from the form to determine the target collection (Instructions context)
+    const schemaPathField = useFormFields(([fields]) => fields['schema-path']);
+    const schemaPath = schemaPathField?.value;
+    // Get current document info (Regular Collection context)
+    const { collectionSlug: currentCollectionSlug } = useDocumentInfo();
+    // Determine effective collection slug
+    // 1. If schemaPath exists (Instructions), derive slug from it (e.g. "products.name" -> "products")
+    // 2. Fallback to current collection slug (e.g. editing a Product directly)
+    const collectionSlug = schemaPath ? schemaPath.split('.')[0] : currentCollectionSlug;
+    // Pre-fetch suggestions when collectionSlug changes
+    React.useEffect(() => {
+        const fetchSuggestions = async () => {
+            if (!collectionSlug) {
+                return;
+            }
+            const triggers = ['@', '#'];
+            const newSuggestions = {};
+            await Promise.all(triggers.map(async (trigger) => {
+                newSuggestions[trigger] = await fetchMentionSuggestions(collectionSlug, trigger);
+            }));
+            suggestionsRef.current = newSuggestions;
+        };
+        fetchSuggestions().catch(console.error);
+    }, [collectionSlug]);
+    const queryMentions = useCallback(async (trigger, queryString) => {
+        const items = suggestionsRef.current[trigger] || [];
+        if (!queryString) {
+            return items;
+        }
+        const lowerQuery = queryString.toLowerCase();
+        return items.filter((item) => {
+            const display = item.display || item.value || '';
+            return display.toLowerCase().includes(lowerQuery);
+        });
+    }, []);
+    return (<BeautifulMentionsPlugin menuComponent={PromptMentionsMenu} menuItemComponent={PromptMentionsMenuItem} onSearch={queryMentions} triggers={['@', '#']}/>);
+};
+export const PromptMentionsClient = createClientFeature({
+    nodes: [BeautifulMentionNode],
+    plugins: [
+        {
+            Component: PromptMentionsPlugin,
+            position: 'normal',
+        },
+    ],
+});

package/dist/fields/PromptEditorField/feature.server.d.ts

@@ -0,0 +1 @@
+export declare const PromptMentionsFeature: import("@payloadcms/richtext-lexical").FeatureProviderProviderServer<undefined, undefined, undefined>;

package/dist/fields/PromptEditorField/feature.server.js

@@ -0,0 +1,30 @@
+import { createServerFeature } from '@payloadcms/richtext-lexical';
+// Mock the node for server-side usage to avoid import issues with the library
+const BeautifulMentionNode = {
+    clone: (node)=>({
+            ...node
+        }),
+    getType: ()=>'beautifulMention',
+    importJSON: (serializedNode)=>{
+        // Return a basic object that satisfies the lexical node interface purely for server validation
+        return {
+            ...serializedNode,
+            exportJSON: ()=>serializedNode,
+            getType: ()=>'beautifulMention'
+        };
+    }
+};
+export const PromptMentionsFeature = createServerFeature({
+    feature: {
+        ClientFeature: '@ai-stack/payloadcms/fields/PromptEditorField/feature.client.js#PromptMentionsClient',
+        nodes: [
+            {
+                converters: {},
+                node: BeautifulMentionNode
+            }
+        ]
+    },
+    key: 'promptMentions'
+});
+
+//# sourceMappingURL=feature.server.js.map

package/dist/fields/PromptEditorField/feature.server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/fields/PromptEditorField/feature.server.ts"],"sourcesContent":["import { createServerFeature } from '@payloadcms/richtext-lexical'\n\n// Mock the node for server-side usage to avoid import issues with the library\nconst BeautifulMentionNode = {\n  clone: (node: any) => ({ ...node }),\n  getType: () => 'beautifulMention',\n  importJSON: (serializedNode: any) => {\n    // Return a basic object that satisfies the lexical node interface purely for server validation\n    return {\n      ...serializedNode,\n      exportJSON: () => serializedNode,\n      getType: () => 'beautifulMention',\n    }\n  },\n}\n\nexport const PromptMentionsFeature = createServerFeature({\n  feature: {\n    ClientFeature: '@ai-stack/payloadcms/fields/PromptEditorField/feature.client.js#PromptMentionsClient',\n    nodes: [\n      {\n        converters: {},\n        node: BeautifulMentionNode,\n      },\n    ],\n  },\n  key: 'promptMentions',\n})\n"],"names":["createServerFeature","BeautifulMentionNode","clone","node","getType","importJSON","serializedNode","exportJSON","PromptMentionsFeature","feature","ClientFeature","nodes","converters","key"],"mappings":"AAAA,SAASA,mBAAmB,QAAQ,+BAA8B;AAElE,8EAA8E;AAC9E,MAAMC,uBAAuB;IAC3BC,OAAO,CAACC,OAAe,CAAA;YAAE,GAAGA,IAAI;QAAC,CAAA;IACjCC,SAAS,IAAM;IACfC,YAAY,CAACC;QACX,+FAA+F;QAC/F,OAAO;YACL,GAAGA,cAAc;YACjBC,YAAY,IAAMD;YAClBF,SAAS,IAAM;QACjB;IACF;AACF;AAEA,OAAO,MAAMI,wBAAwBR,oBAAoB;IACvDS,SAAS;QACPC,eAAe;QACfC,OAAO;YACL;gBACEC,YAAY,CAAC;gBACbT,MAAMF;YACR;SACD;IACH;IACAY,KAAK;AACP,GAAE"}

package/dist/fields/PromptField.d.ts

@@ -0,0 +1,4 @@
+import type { Field, RichTextField } from 'payload';
+type PromptFieldOverrides = Partial<RichTextField>;
+export declare const PromptField: (overrides?: PromptFieldOverrides) => Field;
+export {};

package/dist/fields/PromptField.js

@@ -0,0 +1,18 @@
+import { lexicalEditor } from '@payloadcms/richtext-lexical';
+import { PromptMentionsFeature } from './PromptEditorField/feature.server.js';
+export const PromptField = (overrides = {})=>{
+    return {
+        name: 'prompt',
+        type: 'richText',
+        label: 'Prompt',
+        ...overrides,
+        editor: overrides.editor ?? lexicalEditor({
+            features: ({ rootFeatures })=>[
+                    // ...rootFeatures,
+                    PromptMentionsFeature()
+                ]
+        })
+    };
+};
+
+//# sourceMappingURL=PromptField.js.map

package/dist/fields/PromptField.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/fields/PromptField.ts"],"sourcesContent":["import type { Field, RichTextField } from 'payload'\n\nimport { lexicalEditor } from '@payloadcms/richtext-lexical'\n\nimport { PromptMentionsFeature } from './PromptEditorField/feature.server.js'\n\ntype PromptFieldOverrides = Partial<RichTextField>\n\nexport const PromptField = (overrides: PromptFieldOverrides = {}): Field => {\n  return {\n    name: 'prompt',\n    type: 'richText',\n    label: 'Prompt',\n    ...overrides,\n    editor:\n      overrides.editor ??\n      lexicalEditor({\n        features: ({ rootFeatures }) => [\n          // ...rootFeatures,\n          PromptMentionsFeature(),\n        ],\n      }),\n  }\n}\n"],"names":["lexicalEditor","PromptMentionsFeature","PromptField","overrides","name","type","label","editor","features","rootFeatures"],"mappings":"AAEA,SAASA,aAAa,QAAQ,+BAA8B;AAE5D,SAASC,qBAAqB,QAAQ,wCAAuC;AAI7E,OAAO,MAAMC,cAAc,CAACC,YAAkC,CAAC,CAAC;IAC9D,OAAO;QACLC,MAAM;QACNC,MAAM;QACNC,OAAO;QACP,GAAGH,SAAS;QACZI,QACEJ,UAAUI,MAAM,IAChBP,cAAc;YACZQ,UAAU,CAAC,EAAEC,YAAY,EAAE,GAAK;oBAC9B,mBAAmB;oBACnBR;iBACD;QACH;IACJ;AACF,EAAC"}

package/dist/fields/SelectField/SelectField.js

@@ -33,7 +33,6 @@ export const SelectField = (props)=>{
         label: field.label,
         name: path,
         onChange: (value)=>{
-            console.log("value --- ", value);
             if (Array.isArray(value)) {
                 setValue(value[0]?.value ?? '');
             } else if (value && typeof value === 'object' && 'value' in value) {

package/dist/fields/SelectField/SelectField.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/fields/SelectField/SelectField.tsx"],"sourcesContent":["'use client'\n\nimport type { OptionObject, SelectFieldClientProps } from 'payload'\n\nimport { SelectInput, useField } from '@payloadcms/ui'\nimport React, { useEffect, useState } from 'react'\n\n// Use to filter model options in settings based on field types\nexport const SelectField = (\n  props: {\n    filterByField: string\n    options: { fields: string[]; label: string; value: string }[]\n    path: string\n  } & SelectFieldClientProps,\n) => {\n  const { field, filterByField, options, path } = props\n  const { value: relatedField } = useField<string>({\n    path: filterByField,\n  })\n\n  const [filterOptions, setFilterOptions] = useState<OptionObject[]>([])\n\n  useEffect(() => {\n    if (!Array.isArray(options)) {\n      return\n    }\n\n    const opts = options.filter((option) => {\n      if (!relatedField || !option.fields) {\n        return true\n      }\n\n      if (Array.isArray(option.fields)) {\n        return option.fields.includes(relatedField)\n      }\n    })\n    setFilterOptions(opts)\n  }, [relatedField, options])\n\n  const { setValue, value: selectValue } = useField<string>({ path })\n\n  return (\n    <SelectInput\n      label={field.label}\n      name={path}\n      onChange={(value) => {\n        console.log(\"value --- \", value)\n        if (Array.isArray(value)) {\n          setValue(value[0]?.value ?? '')\n        } else if (value && typeof value === 'object' && 'value' in value) {\n          setValue((value as OptionObject).value)\n        } else {\n          setValue('')\n        }\n      }}\n      options={filterOptions}\n      path={path}\n      value={selectValue}\n    />\n  )\n}\n"],"names":["SelectInput","useField","React","useEffect","useState","SelectField","props","field","filterByField","options","path","value","relatedField","filterOptions","setFilterOptions","Array","isArray","opts","filter","option","fields","includes","setValue","selectValue","label","name","onChange","console","log"],"mappings":"AAAA;;AAIA,SAASA,WAAW,EAAEC,QAAQ,QAAQ,iBAAgB;AACtD,OAAOC,SAASC,SAAS,EAAEC,QAAQ,QAAQ,QAAO;AAElD,+DAA+D;AAC/D,OAAO,MAAMC,cAAc,CACzBC;IAMA,MAAM,EAAEC,KAAK,EAAEC,aAAa,EAAEC,OAAO,EAAEC,IAAI,EAAE,GAAGJ;IAChD,MAAM,EAAEK,OAAOC,YAAY,EAAE,GAAGX,SAAiB;QAC/CS,MAAMF;IACR;IAEA,MAAM,CAACK,eAAeC,iBAAiB,GAAGV,SAAyB,EAAE;IAErED,UAAU;QACR,IAAI,CAACY,MAAMC,OAAO,CAACP,UAAU;YAC3B;QACF;QAEA,MAAMQ,OAAOR,QAAQS,MAAM,CAAC,CAACC;YAC3B,IAAI,CAACP,gBAAgB,CAACO,OAAOC,MAAM,EAAE;gBACnC,OAAO;YACT;YAEA,IAAIL,MAAMC,OAAO,CAACG,OAAOC,MAAM,GAAG;gBAChC,OAAOD,OAAOC,MAAM,CAACC,QAAQ,CAACT;YAChC;QACF;QACAE,iBAAiBG;IACnB,GAAG;QAACL;QAAcH;KAAQ;IAE1B,MAAM,EAAEa,QAAQ,EAAEX,OAAOY,WAAW,EAAE,GAAGtB,SAAiB;QAAES;IAAK;IAEjE,qBACE,KAACV;QACCwB,OAAOjB,MAAMiB,KAAK;QAClBC,MAAMf;QACNgB,UAAU,CAACf;YACTgB,QAAQC,GAAG,CAAC,cAAcjB;YAC1B,IAAII,MAAMC,OAAO,CAACL,QAAQ;gBACxBW,SAASX,KAAK,CAAC,EAAE,EAAEA,SAAS;YAC9B,OAAO,IAAIA,SAAS,OAAOA,UAAU,YAAY,WAAWA,OAAO;gBACjEW,SAAS,AAACX,MAAuBA,KAAK;YACxC,OAAO;gBACLW,SAAS;YACX;QACF;QACAb,SAASI;QACTH,MAAMA;QACNC,OAAOY;;AAGb,EAAC"}
+{"version":3,"sources":["../../../src/fields/SelectField/SelectField.tsx"],"sourcesContent":["'use client'\n\nimport type { OptionObject, SelectFieldClientProps } from 'payload'\n\nimport { SelectInput, useField } from '@payloadcms/ui'\nimport React, { useEffect, useState } from 'react'\n\n// Use to filter model options in settings based on field types\nexport const SelectField = (\n  props: {\n    filterByField: string\n    options: { fields: string[]; label: string; value: string }[]\n    path: string\n  } & SelectFieldClientProps,\n) => {\n  const { field, filterByField, options, path } = props\n  const { value: relatedField } = useField<string>({\n    path: filterByField,\n  })\n\n  const [filterOptions, setFilterOptions] = useState<OptionObject[]>([])\n\n  useEffect(() => {\n    if (!Array.isArray(options)) {\n      return\n    }\n\n    const opts = options.filter((option) => {\n      if (!relatedField || !option.fields) {\n        return true\n      }\n\n      if (Array.isArray(option.fields)) {\n        return option.fields.includes(relatedField)\n      }\n    })\n    setFilterOptions(opts)\n  }, [relatedField, options])\n\n  const { setValue, value: selectValue } = useField<string>({ path })\n\n  return (\n    <SelectInput\n      label={field.label}\n      name={path}\n      onChange={(value) => {\n        if (Array.isArray(value)) {\n          setValue(value[0]?.value ?? '')\n        } else if (value && typeof value === 'object' && 'value' in value) {\n          setValue((value as OptionObject).value)\n        } else {\n          setValue('')\n        }\n      }}\n      options={filterOptions}\n      path={path}\n      value={selectValue}\n    />\n  )\n}\n"],"names":["SelectInput","useField","React","useEffect","useState","SelectField","props","field","filterByField","options","path","value","relatedField","filterOptions","setFilterOptions","Array","isArray","opts","filter","option","fields","includes","setValue","selectValue","label","name","onChange"],"mappings":"AAAA;;AAIA,SAASA,WAAW,EAAEC,QAAQ,QAAQ,iBAAgB;AACtD,OAAOC,SAASC,SAAS,EAAEC,QAAQ,QAAQ,QAAO;AAElD,+DAA+D;AAC/D,OAAO,MAAMC,cAAc,CACzBC;IAMA,MAAM,EAAEC,KAAK,EAAEC,aAAa,EAAEC,OAAO,EAAEC,IAAI,EAAE,GAAGJ;IAChD,MAAM,EAAEK,OAAOC,YAAY,EAAE,GAAGX,SAAiB;QAC/CS,MAAMF;IACR;IAEA,MAAM,CAACK,eAAeC,iBAAiB,GAAGV,SAAyB,EAAE;IAErED,UAAU;QACR,IAAI,CAACY,MAAMC,OAAO,CAACP,UAAU;YAC3B;QACF;QAEA,MAAMQ,OAAOR,QAAQS,MAAM,CAAC,CAACC;YAC3B,IAAI,CAACP,gBAAgB,CAACO,OAAOC,MAAM,EAAE;gBACnC,OAAO;YACT;YAEA,IAAIL,MAAMC,OAAO,CAACG,OAAOC,MAAM,GAAG;gBAChC,OAAOD,OAAOC,MAAM,CAACC,QAAQ,CAACT;YAChC;QACF;QACAE,iBAAiBG;IACnB,GAAG;QAACL;QAAcH;KAAQ;IAE1B,MAAM,EAAEa,QAAQ,EAAEX,OAAOY,WAAW,EAAE,GAAGtB,SAAiB;QAAES;IAAK;IAEjE,qBACE,KAACV;QACCwB,OAAOjB,MAAMiB,KAAK;QAClBC,MAAMf;QACNgB,UAAU,CAACf;YACT,IAAII,MAAMC,OAAO,CAACL,QAAQ;gBACxBW,SAASX,KAAK,CAAC,EAAE,EAAEA,SAAS;YAC9B,OAAO,IAAIA,SAAS,OAAOA,UAAU,YAAY,WAAWA,OAAO;gBACjEW,SAAS,AAACX,MAAuBA,KAAK;YACxC,OAAO;gBACLW,SAAS;YACX;QACF;QACAb,SAASI;QACTH,MAAMA;QACNC,OAAOY;;AAGb,EAAC"}

package/dist/fields/SelectField/SelectField.jsx

@@ -24,7 +24,6 @@ export const SelectField = (props) => {
     }, [relatedField, options]);
     const { setValue, value: selectValue } = useField({ path });
     return (<SelectInput label={field.label} name={path} onChange={(value) => {
-            console.log("value --- ", value);
             if (Array.isArray(value)) {
                 setValue(value[0]?.value ?? '');
             }

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-export type { GenerateArgs } from './ai/index.js';
-export { defaultPrompts } from './ai/prompts.js';
+export { defaultPrompts } from './ai/utilities/prompts.js';
+export { promptMentionsEndpoint } from './endpoints/promptMentions.js';
 export { PayloadAiPluginLexicalEditorFeature } from './fields/LexicalEditor/feature.server.js';
+export { PromptField } from './fields/PromptField.js';
 export type {} from './payload-ai.d.ts';
 export { payloadAiPlugin } from './plugin.js';
-export { fieldToJsonSchema } from './utilities/fieldToJsonSchema.js';
+export { fieldToJsonSchema } from './utilities/fields/fieldToJsonSchema.js';

package/dist/index.js

@@ -1,6 +1,8 @@
-export { defaultPrompts } from './ai/prompts.js';
+export { defaultPrompts } from './ai/utilities/prompts.js';
+export { promptMentionsEndpoint } from './endpoints/promptMentions.js';
 export { PayloadAiPluginLexicalEditorFeature } from './fields/LexicalEditor/feature.server.js';
+export { PromptField } from './fields/PromptField.js';
 export { payloadAiPlugin } from './plugin.js';
-export { fieldToJsonSchema } from './utilities/fieldToJsonSchema.js';
+export { fieldToJsonSchema } from './utilities/fields/fieldToJsonSchema.js';
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type { GenerateArgs } from './ai/index.js'\n\nexport { defaultPrompts } from './ai/prompts.js'\n\nexport { PayloadAiPluginLexicalEditorFeature } from './fields/LexicalEditor/feature.server.js'\n// Re-export to ensure payload.ai module augmentation is included\nexport type {} from './payload-ai.d.ts'\n\nexport { payloadAiPlugin } from './plugin.js'\nexport { fieldToJsonSchema } from './utilities/fieldToJsonSchema.js'\n"],"names":["defaultPrompts","PayloadAiPluginLexicalEditorFeature","payloadAiPlugin","fieldToJsonSchema"],"mappings":"AAEA,SAASA,cAAc,QAAQ,kBAAiB;AAEhD,SAASC,mCAAmC,QAAQ,2CAA0C;AAI9F,SAASC,eAAe,QAAQ,cAAa;AAC7C,SAASC,iBAAiB,QAAQ,mCAAkC"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export { defaultPrompts } from './ai/utilities/prompts.js'\nexport { promptMentionsEndpoint } from './endpoints/promptMentions.js'\nexport { PayloadAiPluginLexicalEditorFeature } from './fields/LexicalEditor/feature.server.js'\nexport { PromptField } from './fields/PromptField.js'\n// Re-export to ensure payload.ai module augmentation is included\nexport type {} from './payload-ai.d.ts'\nexport { payloadAiPlugin } from './plugin.js'\nexport { fieldToJsonSchema } from './utilities/fields/fieldToJsonSchema.js'\n"],"names":["defaultPrompts","promptMentionsEndpoint","PayloadAiPluginLexicalEditorFeature","PromptField","payloadAiPlugin","fieldToJsonSchema"],"mappings":"AAAA,SAASA,cAAc,QAAQ,4BAA2B;AAC1D,SAASC,sBAAsB,QAAQ,gCAA+B;AACtE,SAASC,mCAAmC,QAAQ,2CAA0C;AAC9F,SAASC,WAAW,QAAQ,0BAAyB;AAGrD,SAASC,eAAe,QAAQ,cAAa;AAC7C,SAASC,iBAAiB,QAAQ,0CAAyC"}

package/dist/libraries/handlebars/helpers.js

@@ -1,5 +1,5 @@
-import { getFieldInfo } from '../../utilities/getFieldInfo.js';
-import { lexicalToHTML } from '../../utilities/lexicalToHTML.js';
+import { getFieldInfo } from '../../utilities/fields/getFieldInfo.js';
+import { lexicalToHTML } from '../../utilities/lexical/lexicalToHTML.js';
 import { asyncHandlebars } from './asyncHandlebars.js';
 import { handlebarsHelpersMap } from './helpersMap.js';
 export const registerEditorHelper = (payload, schemaPath)=>{

package/dist/libraries/handlebars/helpers.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/libraries/handlebars/helpers.ts"],"sourcesContent":["import type { SerializedEditorState } from 'lexical'\n\nimport { getFieldInfo } from '../../utilities/getFieldInfo.js'\nimport { lexicalToHTML } from '../../utilities/lexicalToHTML.js'\nimport { asyncHandlebars } from './asyncHandlebars.js'\nimport { handlebarsHelpersMap } from './helpersMap.js'\n\nexport const registerEditorHelper = (payload: any, schemaPath: string) => {\n  //TODO: add autocomplete ability using handlebars template on PromptEditorField and include custom helpers in dropdown\n\n  let fieldInfo = getFieldInfo(payload.collections, schemaPath)\n  const schemaPathChunks = schemaPath.split('.')\n\n  asyncHandlebars.registerHelper(\n    handlebarsHelpersMap.toHTML.name,\n    async function (content: SerializedEditorState, options: any) {\n      const collectionSlug = schemaPathChunks[0]\n      const { ids } = options\n      for (const id of ids) {\n        //TODO: Find a better way to get schemaPath of defined field in prompt editor\n        const path = `${collectionSlug}.${id}`\n        fieldInfo = getFieldInfo(payload.collections, path)\n      }\n\n      let html = ''\n      if (\n        fieldInfo &&\n        'editor' in fieldInfo &&\n        fieldInfo.editor &&\n        typeof fieldInfo.editor === 'object' &&\n        'editorConfig' in fieldInfo.editor &&\n        fieldInfo.editor.editorConfig\n      ) {\n        if (\n          fieldInfo.editor.editorConfig &&\n          typeof fieldInfo.editor.editorConfig === 'object' &&\n          'features' in fieldInfo.editor.editorConfig &&\n          'lexical' in fieldInfo.editor.editorConfig &&\n          'resolvedFeatureMap' in fieldInfo.editor.editorConfig\n        ) {\n          html = await lexicalToHTML(\n            content,\n            fieldInfo.editor.editorConfig as any, // as SanitizedServerEditorConfig\n          )\n        }\n      }\n      return new asyncHandlebars.SafeString(html)\n    },\n  )\n}\n"],"names":["getFieldInfo","lexicalToHTML","asyncHandlebars","handlebarsHelpersMap","registerEditorHelper","payload","schemaPath","fieldInfo","collections","schemaPathChunks","split","registerHelper","toHTML","name","content","options","collectionSlug","ids","id","path","html","editor","editorConfig","SafeString"],"mappings":"AAEA,SAASA,YAAY,QAAQ,kCAAiC;AAC9D,SAASC,aAAa,QAAQ,mCAAkC;AAChE,SAASC,eAAe,QAAQ,uBAAsB;AACtD,SAASC,oBAAoB,QAAQ,kBAAiB;AAEtD,OAAO,MAAMC,uBAAuB,CAACC,SAAcC;IACjD,sHAAsH;IAEtH,IAAIC,YAAYP,aAAaK,QAAQG,WAAW,EAAEF;IAClD,MAAMG,mBAAmBH,WAAWI,KAAK,CAAC;IAE1CR,gBAAgBS,cAAc,CAC5BR,qBAAqBS,MAAM,CAACC,IAAI,EAChC,eAAgBC,OAA8B,EAAEC,OAAY;QAC1D,MAAMC,iBAAiBP,gBAAgB,CAAC,EAAE;QAC1C,MAAM,EAAEQ,GAAG,EAAE,GAAGF;QAChB,KAAK,MAAMG,MAAMD,IAAK;YACpB,6EAA6E;YAC7E,MAAME,OAAO,CAAC,EAAEH,eAAe,CAAC,EAAEE,GAAG,CAAC;YACtCX,YAAYP,aAAaK,QAAQG,WAAW,EAAEW;QAChD;QAEA,IAAIC,OAAO;QACX,IACEb,aACA,YAAYA,aACZA,UAAUc,MAAM,IAChB,OAAOd,UAAUc,MAAM,KAAK,YAC5B,kBAAkBd,UAAUc,MAAM,IAClCd,UAAUc,MAAM,CAACC,YAAY,EAC7B;YACA,IACEf,UAAUc,MAAM,CAACC,YAAY,IAC7B,OAAOf,UAAUc,MAAM,CAACC,YAAY,KAAK,YACzC,cAAcf,UAAUc,MAAM,CAACC,YAAY,IAC3C,aAAaf,UAAUc,MAAM,CAACC,YAAY,IAC1C,wBAAwBf,UAAUc,MAAM,CAACC,YAAY,EACrD;gBACAF,OAAO,MAAMnB,cACXa,SACAP,UAAUc,MAAM,CAACC,YAAY;YAEjC;QACF;QACA,OAAO,IAAIpB,gBAAgBqB,UAAU,CAACH;IACxC;AAEJ,EAAC"}
+{"version":3,"sources":["../../../src/libraries/handlebars/helpers.ts"],"sourcesContent":["import type { SerializedEditorState } from 'lexical'\n\nimport { getFieldInfo } from '../../utilities/fields/getFieldInfo.js'\nimport { lexicalToHTML } from '../../utilities/lexical/lexicalToHTML.js'\nimport { asyncHandlebars } from './asyncHandlebars.js'\nimport { handlebarsHelpersMap } from './helpersMap.js'\n\nexport const registerEditorHelper = (payload: any, schemaPath: string) => {\n  //TODO: add autocomplete ability using handlebars template on PromptEditorField and include custom helpers in dropdown\n\n  let fieldInfo = getFieldInfo(payload.collections, schemaPath)\n  const schemaPathChunks = schemaPath.split('.')\n\n  asyncHandlebars.registerHelper(\n    handlebarsHelpersMap.toHTML.name,\n    async function (content: SerializedEditorState, options: any) {\n      const collectionSlug = schemaPathChunks[0]\n      const { ids } = options\n      for (const id of ids) {\n        //TODO: Find a better way to get schemaPath of defined field in prompt editor\n        const path = `${collectionSlug}.${id}`\n        fieldInfo = getFieldInfo(payload.collections, path)\n      }\n\n      let html = ''\n      if (\n        fieldInfo &&\n        'editor' in fieldInfo &&\n        fieldInfo.editor &&\n        typeof fieldInfo.editor === 'object' &&\n        'editorConfig' in fieldInfo.editor &&\n        fieldInfo.editor.editorConfig\n      ) {\n        if (\n          fieldInfo.editor.editorConfig &&\n          typeof fieldInfo.editor.editorConfig === 'object' &&\n          'features' in fieldInfo.editor.editorConfig &&\n          'lexical' in fieldInfo.editor.editorConfig &&\n          'resolvedFeatureMap' in fieldInfo.editor.editorConfig\n        ) {\n          html = await lexicalToHTML(\n            content,\n            fieldInfo.editor.editorConfig as any, // as SanitizedServerEditorConfig\n          )\n        }\n      }\n      return new asyncHandlebars.SafeString(html)\n    },\n  )\n}\n"],"names":["getFieldInfo","lexicalToHTML","asyncHandlebars","handlebarsHelpersMap","registerEditorHelper","payload","schemaPath","fieldInfo","collections","schemaPathChunks","split","registerHelper","toHTML","name","content","options","collectionSlug","ids","id","path","html","editor","editorConfig","SafeString"],"mappings":"AAEA,SAASA,YAAY,QAAQ,yCAAwC;AACrE,SAASC,aAAa,QAAQ,2CAA0C;AACxE,SAASC,eAAe,QAAQ,uBAAsB;AACtD,SAASC,oBAAoB,QAAQ,kBAAiB;AAEtD,OAAO,MAAMC,uBAAuB,CAACC,SAAcC;IACjD,sHAAsH;IAEtH,IAAIC,YAAYP,aAAaK,QAAQG,WAAW,EAAEF;IAClD,MAAMG,mBAAmBH,WAAWI,KAAK,CAAC;IAE1CR,gBAAgBS,cAAc,CAC5BR,qBAAqBS,MAAM,CAACC,IAAI,EAChC,eAAgBC,OAA8B,EAAEC,OAAY;QAC1D,MAAMC,iBAAiBP,gBAAgB,CAAC,EAAE;QAC1C,MAAM,EAAEQ,GAAG,EAAE,GAAGF;QAChB,KAAK,MAAMG,MAAMD,IAAK;YACpB,6EAA6E;YAC7E,MAAME,OAAO,CAAC,EAAEH,eAAe,CAAC,EAAEE,GAAG,CAAC;YACtCX,YAAYP,aAAaK,QAAQG,WAAW,EAAEW;QAChD;QAEA,IAAIC,OAAO;QACX,IACEb,aACA,YAAYA,aACZA,UAAUc,MAAM,IAChB,OAAOd,UAAUc,MAAM,KAAK,YAC5B,kBAAkBd,UAAUc,MAAM,IAClCd,UAAUc,MAAM,CAACC,YAAY,EAC7B;YACA,IACEf,UAAUc,MAAM,CAACC,YAAY,IAC7B,OAAOf,UAAUc,MAAM,CAACC,YAAY,KAAK,YACzC,cAAcf,UAAUc,MAAM,CAACC,YAAY,IAC3C,aAAaf,UAAUc,MAAM,CAACC,YAAY,IAC1C,wBAAwBf,UAAUc,MAAM,CAACC,YAAY,EACrD;gBACAF,OAAO,MAAMnB,cACXa,SACAP,UAAUc,MAAM,CAACC,YAAY;YAEjC;QACF;QACA,OAAO,IAAIpB,gBAAgBqB,UAAU,CAACH;IACxC;AAEJ,EAAC"}

package/dist/libraries/handlebars/replacePlaceholders.js

@@ -1,6 +1,10 @@
 import { asyncHandlebars } from './asyncHandlebars.js';
 export const replacePlaceholders = (prompt, values)=>{
-    return asyncHandlebars.compile(prompt, {
+    // Sanitize {{ #fieldName }} or {{#fieldName}} to {{ fieldName }}
+    // so Handlebars doesn't confuse it for a block helper and throw parse errors.
+    // We ignore standard Handlebars block helpers: if, unless, each, with
+    const sanitizedPrompt = typeof prompt === 'string' ? prompt.replace(/\{\{\s*#\s*(?!if\b|unless\b|each\b|with\b)([\w.]+)\s*\}\}/g, '{{ $1 }}') : prompt;
+    return asyncHandlebars.compile(sanitizedPrompt, {
         trackIds: true
     })(values);
 };

package/dist/libraries/handlebars/replacePlaceholders.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/libraries/handlebars/replacePlaceholders.ts"],"sourcesContent":["import { asyncHandlebars } from './asyncHandlebars.js'\n\nexport const replacePlaceholders = (prompt: string, values: object) => {\n  return asyncHandlebars.compile(prompt, { trackIds: true })(values) as Promise<string>\n}\n"],"names":["asyncHandlebars","replacePlaceholders","prompt","values","compile","trackIds"],"mappings":"AAAA,SAASA,eAAe,QAAQ,uBAAsB;AAEtD,OAAO,MAAMC,sBAAsB,CAACC,QAAgBC;IAClD,OAAOH,gBAAgBI,OAAO,CAACF,QAAQ;QAAEG,UAAU;IAAK,GAAGF;AAC7D,EAAC"}
+{"version":3,"sources":["../../../src/libraries/handlebars/replacePlaceholders.ts"],"sourcesContent":["import { asyncHandlebars } from './asyncHandlebars.js'\n\nexport const replacePlaceholders = (prompt: string, values: object) => {\n  // Sanitize {{ #fieldName }} or {{#fieldName}} to {{ fieldName }}\n  // so Handlebars doesn't confuse it for a block helper and throw parse errors.\n  // We ignore standard Handlebars block helpers: if, unless, each, with\n  const sanitizedPrompt = typeof prompt === 'string'\n    ? prompt.replace(/\\{\\{\\s*#\\s*(?!if\\b|unless\\b|each\\b|with\\b)([\\w.]+)\\s*\\}\\}/g, '{{ $1 }}')\n    : prompt\n\n  return asyncHandlebars.compile(sanitizedPrompt, { trackIds: true })(values) as Promise<string>\n}\n"],"names":["asyncHandlebars","replacePlaceholders","prompt","values","sanitizedPrompt","replace","compile","trackIds"],"mappings":"AAAA,SAASA,eAAe,QAAQ,uBAAsB;AAEtD,OAAO,MAAMC,sBAAsB,CAACC,QAAgBC;IAClD,iEAAiE;IACjE,8EAA8E;IAC9E,sEAAsE;IACtE,MAAMC,kBAAkB,OAAOF,WAAW,WACtCA,OAAOG,OAAO,CAAC,8DAA8D,cAC7EH;IAEJ,OAAOF,gBAAgBM,OAAO,CAACF,iBAAiB;QAAEG,UAAU;IAAK,GAAGJ;AACtE,EAAC"}

package/dist/payload-ai.d.ts

@@ -1,14 +1,9 @@
 // Global type definitions for @ai-stack/payloadcms
 // This file augments the Payload types using inline type definitions
 
-import type { GenerateObjectResult, ImagePart, JSONValue, ModelMessage } from 'ai'
+import type { GenerateObjectResult, GenerateTextResult, ImagePart, JSONValue, ModelMessage, StreamTextResult, ToolSet } from 'ai'
 import type { z } from 'zod'
 
-/**
- * Provider options compatible with AI SDK
- */
-type ProviderOptions = Record<string, Record<string, JSONValue>>
-
 /**
  * Base arguments for all generation methods
  */
@@ -19,7 +14,6 @@ interface PayloadGenerationBaseArgs {
   model?: string
   prompt: string
   provider?: string
-  providerOptions?: ProviderOptions
   system?: string
   temperature?: number
 }
@@ -37,9 +31,7 @@ interface PayloadGenerateObjectArgs extends PayloadGenerationBaseArgs {
 /**
  * Arguments for generateText - simple text generation
  */
-interface PayloadGenerateTextArgs extends PayloadGenerationBaseArgs {
-  // No additional fields needed for basic text generation
-}
+type PayloadGenerateTextArgs = PayloadGenerationBaseArgs
 
 /**
  * Arguments for generateMedia - image/video generation
@@ -57,7 +49,6 @@ interface PayloadGenerateMediaArgs {
   n?: number
   prompt: string
   provider?: string
-  providerOptions?: ProviderOptions
   seed?: number
   size?: { height: number; width: number }
   speed?: number
@@ -86,11 +77,6 @@ interface MediaResult {
 declare module 'payload' {
   interface BasePayload {
     ai: {
-      /**
-       * @deprecated Use generateObject or generateText instead
-       * Legacy generate method for backward compatibility
-       */
-      generate: (args: unknown) => Promise<unknown>
 
       /**
        * Generate media (images or videos)
@@ -111,7 +97,7 @@ declare module 'payload' {
        * @param args - Generation arguments including provider, model, and prompt
        * @returns Promise resolving to the generated text
        */
-      generateText: (args: PayloadGenerateTextArgs) => Promise<string>
+      generateText: (args: PayloadGenerateTextArgs) => Promise<GenerateTextResult<ToolSet, unknown>>
 
       /**
        * Get a specific model instance
@@ -137,14 +123,14 @@ declare module 'payload' {
        * @param args - Generation arguments including provider, model, prompt, and schema
        * @returns Response stream
        */
-      streamObject: <T = unknown>(args: PayloadGenerateObjectArgs) => Promise<Response>
+      streamObject: (args: PayloadGenerateObjectArgs) => Promise<Response>
 
       /**
        * Stream text output
        * @param args - Generation arguments including provider, model, and prompt
        * @returns Response stream
        */
-      streamText: (args: PayloadGenerateTextArgs) => Promise<Response>
+      streamText: (args: PayloadGenerateTextArgs) => Promise<StreamTextResult<ToolSet, unknown>>
     }
   }
 }