@mvriu5/payload-ai 1.6.0 → 1.6.2

package/README.md

@@ -25,18 +25,18 @@ npm add @mvriu5/payload-ai @openrouter/ai-sdk-provider
 ## Usage
 
 ```ts
-import { buildConfig } from "payload";
-import { payloadAiPlugin } from "@mvriu5/payload-ai";
+import { buildConfig } from "payload"
+import { payloadAiPlugin } from "@mvriu5/payload-ai"
 
 export default buildConfig({
-  plugins: [
-    payloadAiPlugin({
-      collections: {
-        posts: true,
-      },
-    }),
-  ],
-});
+    plugins: [
+        payloadAiPlugin({
+            collections: {
+                posts: true,
+            },
+        }),
+    ],
+})
 ```
 
 Without centrally configured providers, the plugin adds two fields to the configured Payload admin user collection:
@@ -51,64 +51,72 @@ When `providers` is configured, provider selection and API keys are managed cent
 ## Options
 
 ```ts
-import type { PayloadAIPluginOptions } from "@mvriu5/payload-ai";
+import type { PayloadAIPluginOptions } from "@mvriu5/payload-ai"
 
 const options: PayloadAIPluginOptions = {
-  aiInput: true,
-  allowUserApiKeys: false,
-  collections: {
-    media: {
-      read: true,
-      update: true,
+    aiInput: true,
+    allowUserApiKeys: false,
+    authCollections: {
+        aiInput: false,
+        generateFields: false,
     },
-    posts: {
-      read: true,
-      create: true,
-      update: true,
-      delete: false,
+    collections: {
+        media: {
+            read: true,
+            update: true,
+        },
+        posts: {
+            read: true,
+            create: true,
+            update: true,
+            delete: false,
+        },
+        users: true,
     },
-    users: true,
-  },
-  generateFields: true,
-  media: {
-    enabled: true,
-    collectionSlug: "media",
-    acceptedMimeTypes: ["image/*"],
-    maxFileSize: 10 * 1024 * 1024,
-  },
-  providers: [
-    {
-      id: "company-openai",
-      label: "Company OpenAI",
-      provider: "openai",
-      apiKey: process.env.COMPANY_OPENAI_API_KEY,
-      models: [
-        { label: "GPT-4.1 Mini", value: "gpt-4.1-mini" },
-        { label: "GPT-4.1", value: "gpt-4.1" },
-      ],
-      defaultModel: "gpt-4.1-mini",
+    generateFields: true,
+    media: {
+        enabled: true,
+        collectionSlug: "media",
+        acceptedMimeTypes: ["image/*"],
+        maxFileSize: 10 * 1024 * 1024,
+    },
+    providers: [
+        {
+            id: "company-openai",
+            label: "Company OpenAI",
+            provider: "openai",
+            apiKey: process.env.COMPANY_OPENAI_API_KEY,
+            models: [
+                { label: "GPT-4.1 Mini", value: "gpt-4.1-mini" },
+                { label: "GPT-4.1", value: "gpt-4.1" },
+            ],
+            defaultModel: "gpt-4.1-mini",
+        },
+        {
+            id: "ollama",
+            label: "Local Ollama",
+            provider: "openai",
+            baseURL: "http://localhost:11434/v1",
+            apiKey: "ollama",
+            models: [
+                { label: "Llama 3.3", value: "llama3.3" },
+                { label: "Qwen 3", value: "qwen3" },
+            ],
+        },
+    ],
+    maxOutputTokens: 1200,
+    promptCaching: true,
+    translate: true,
+    uploadCollections: {
+        aiInput: true,
+        generateFields: false,
     },
-    {
-      id: "ollama",
-      label: "Local Ollama",
-      provider: "openai",
-      baseURL: "http://localhost:11434/v1",
-      apiKey: "ollama",
-      models: [
-        { label: "Llama 3.3", value: "llama3.3" },
-        { label: "Qwen 3", value: "qwen3" },
-      ],
+    maxTokenUsage: {
+        type: "user",
+        perDay: 50_000,
+        perWeek: 250_000,
     },
-  ],
-  maxOutputTokens: 1200,
-  promptCaching: true,
-  translate: true,
-  maxTokenUsage: {
-    type: "user",
-    perDay: 50_000,
-    perWeek: 250_000,
-  },
-};
+}
 ```
 
 `models` configures model choices for the user-selected provider mode. Use `providers` instead when provider selection, credentials, and endpoints should be managed centrally.
@@ -119,7 +127,7 @@ Controls whether the collapsible AI Assistant input is added to collection and g
 
 ```ts
 payloadAiPlugin({
-  aiInput: false,
+    aiInput: false,
 })
 ```
 
@@ -131,19 +139,38 @@ Controls whether supported fields receive a Generate control. It defaults to `tr
 
 ```ts
 payloadAiPlugin({
-  generateFields: false,
+    generateFields: false,
 })
 ```
 
 Generate controls are added to `text`, `textarea`, `richText`, and `json` fields in collection and global edit views. When disabled, the plugin also omits the `/ai-generate-field` endpoint. The embedded AI Assistant and dashboard remain available.
 
+### `authCollections` and `uploadCollections`
+
+Auth and upload collections do not receive the embedded AI Assistant or Generate controls by default. Enable either feature explicitly for the respective collection type:
+
+```ts
+payloadAiPlugin({
+    authCollections: {
+        aiInput: true,
+        generateFields: true,
+    },
+    uploadCollections: {
+        aiInput: true,
+        generateFields: true,
+    },
+})
+```
+
+The global `aiInput` and `generateFields` options still take precedence when set to `false`.
+
 ### `translate`
 
 Controls document translation for localized collections and globals. It defaults to `true`.
 
 ```ts
 payloadAiPlugin({
-  translate: false,
+    translate: false,
 })
 ```
 
@@ -165,9 +192,9 @@ Use `true` to enable all AI actions for a collection:
 
 ```ts
 payloadAiPlugin({
-  collections: {
-    posts: true,
-  },
+    collections: {
+        posts: true,
+    },
 })
 ```
 
@@ -175,14 +202,14 @@ Use granular permissions to control each action:
 
 ```ts
 payloadAiPlugin({
-  collections: {
-    posts: {
-      read: true,
-      create: true,
-      update: true,
-      delete: false,
+    collections: {
+        posts: {
+            read: true,
+            create: true,
+            update: true,
+            delete: false,
+        },
     },
-  },
 })
 ```
 
@@ -190,14 +217,14 @@ You can mix both forms in the same object:
 
 ```ts
 payloadAiPlugin({
-  collections: {
-    posts: true,
-    pages: true,
-    users: {
-      read: true,
-      update: true,
+    collections: {
+        posts: true,
+        pages: true,
+        users: {
+            read: true,
+            update: true,
+        },
     },
-  },
 })
 ```
 
@@ -209,19 +236,19 @@ Enables media uploads from the AI assistant. Uploaded files are created through
 
 ```ts
 payloadAiPlugin({
-  collections: {
+    collections: {
+        media: {
+            read: true,
+            update: true,
+        },
+        posts: true,
+    },
     media: {
-      read: true,
-      update: true,
+        enabled: true,
+        collectionSlug: "media",
+        acceptedMimeTypes: ["image/*"],
+        maxFileSize: 10 * 1024 * 1024,
     },
-    posts: true,
-  },
-  media: {
-    enabled: true,
-    collectionSlug: "media",
-    acceptedMimeTypes: ["image/*"],
-    maxFileSize: 10 * 1024 * 1024,
-  },
 })
 ```
 
@@ -276,7 +303,7 @@ Controls the maximum number of output tokens the chat endpoint may generate per
 
 ```ts
 payloadAiPlugin({
-  maxOutputTokens: 1200,
+    maxOutputTokens: 1200,
 })
 ```
 
@@ -286,11 +313,11 @@ Limits total AI tokens across rolling 24-hour and 7-day windows.
 
 ```ts
 payloadAiPlugin({
-  maxTokenUsage: {
-    type: "user",
-    perDay: 50_000,
-    perWeek: 250_000,
-  },
+    maxTokenUsage: {
+        type: "user",
+        perDay: 50_000,
+        perWeek: 250_000,
+    },
 })
 ```
 
@@ -304,7 +331,7 @@ Enables provider prompt-caching hints and defaults to `true`. The chat endpoint
 
 ```ts
 payloadAiPlugin({
-  promptCaching: false,
+    promptCaching: false,
 })
 ```
 
@@ -316,7 +343,7 @@ Controls whether the plugin adds an `aiApiKey` field to the admin user collectio
 
 ```ts
 payloadAiPlugin({
-  allowUserApiKeys: false,
+    allowUserApiKeys: false,
 })
 ```
 
@@ -356,12 +383,12 @@ The apply endpoint returns only minimal status/doc references and does not retur
 ## Exports
 
 ```ts
-import { payloadAiPlugin } from "@mvriu5/payload-ai";
-import type { PayloadAiPluginOptions } from "@mvriu5/payload-ai";
+import { payloadAiPlugin } from "@mvriu5/payload-ai"
+import type { PayloadAiPluginOptions } from "@mvriu5/payload-ai"
 ```
 
 Client components are exported through:
 
 ```ts
-import { AIInput, AIApiKeyField } from "@mvriu5/payload-ai/client";
+import { AIInput, AIApiKeyField } from "@mvriu5/payload-ai/client"
 ```

package/dist/components/ai-input/AIInput.d.ts

@@ -1,5 +1,5 @@
 type AIInputProps = {
     isDashboard?: boolean;
 };
-declare const AIInput: ({ isDashboard }: AIInputProps) => import("react").JSX.Element;
+declare const AIInput: ({ isDashboard }: AIInputProps) => import("react").JSX.Element | null;
 export default AIInput;

package/dist/components/ai-input/AIInput.js

@@ -1,6 +1,6 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { Button, ChevronIcon, useConfig, useDocumentForm, useDocumentInfo, useLocale } from "@payloadcms/ui";
+import { Button, ChevronIcon, useAuth, useConfig, useDocumentForm, useDocumentInfo, useLocale } from "@payloadcms/ui";
 import { formatAdminURL } from "payload/shared";
 import { useEffect, useRef, useState } from "react";
 import { mergeData } from "../../payload/shared.js";
@@ -540,6 +540,8 @@ const DocumentAIInput = ()=>{
     });
 };
 const AIInput = ({ isDashboard = false })=>{
+    const { user } = useAuth();
+    if (!user) return null;
     if (isDashboard) return /*#__PURE__*/ _jsx(AIInputCore, {
         isDashboard: true
     });

package/dist/components/generate-field/GenerateField.js

@@ -1,6 +1,6 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useConfig, useDocumentForm, useDocumentInfo, useField, useLocale } from "@payloadcms/ui";
+import { useAuth, useConfig, useDocumentForm, useDocumentInfo, useField, useLocale } from "@payloadcms/ui";
 import { formatAdminURL } from "payload/shared";
 import { useState } from "react";
 import { createGeneratedRichTextValue } from "./richText.js";
@@ -27,6 +27,7 @@ const requestGeneratedValue = ({ apiRoute, body, cacheKey })=>{
     return request;
 };
 const GenerateField = ({ field, generationFieldKey, generationFieldType, path, readOnly })=>{
+    const { user } = useAuth();
     const configContext = useConfig();
     const documentForm = useDocumentForm();
     const documentInfo = useDocumentInfo();
@@ -87,7 +88,7 @@ const GenerateField = ({ field, generationFieldKey, generationFieldType, path, r
             setIsGenerating(false);
         }
     };
-    if (!scope) return null;
+    if (!user || !scope) return null;
     return /*#__PURE__*/ _jsxs("div", {
         className: styles.generateField,
         children: [

package/dist/handlers/translateDocumentHandler.js

@@ -1,3 +1,4 @@
+import { isDeepStrictEqual } from "node:util";
 import { generateText } from "ai";
 import { isAIProvider } from "../ai/providerOptions.js";
 import { getModel, getProviderConfig } from "../ai/providerRuntime.js";
@@ -70,17 +71,25 @@ export const createTranslateDocumentHandler = (options)=>async (req)=>{
                 locale: defaultLocale,
                 req
             });
+            const sourceValues = getTranslationValues(pageContext.fields, sourceDocument);
+            if (sourceValues.length === 0) return Response.json({
+                available: false
+            });
             const targetDocument = await loadDocument({
                 context: pageContext,
                 id: body.id,
                 locale,
                 req
             });
-            const sourceValues = getTranslationValues(pageContext.fields, sourceDocument);
-            const targetValues = getTranslationValues(pageContext.fields, targetDocument);
-            const populatedTargetPaths = new Set(targetValues.map((entry)=>entry.path));
-            const missingSourceValues = sourceValues.filter((entry)=>!populatedTargetPaths.has(entry.path));
-            const available = missingSourceValues.length > 0;
+            const targetValuesByPath = new Map(getTranslationValues(pageContext.fields, targetDocument).map((entry)=>[
+                    entry.path,
+                    entry.value
+                ]));
+            const translationSourceValues = sourceValues.filter((entry)=>{
+                const targetValue = targetValuesByPath.get(entry.path);
+                return targetValue === undefined || isDeepStrictEqual(targetValue, entry.value);
+            });
+            const available = translationSourceValues.length > 0;
             if (body.action === "status" || !available) return Response.json({
                 available
             });
@@ -139,7 +148,7 @@ export const createTranslateDocumentHandler = (options)=>async (req)=>{
                 prompt: JSON.stringify({
                     sourceLocale: defaultLocale,
                     targetLocale: locale,
-                    values: missingSourceValues.map((entry, index)=>({
+                    values: translationSourceValues.map((entry, index)=>({
                             id: String(index),
                             value: entry.value
                         }))
@@ -151,7 +160,7 @@ export const createTranslateDocumentHandler = (options)=>async (req)=>{
                     "Return no Markdown or explanation."
                 ].join(" ")
             });
-            const translatedValues = parseTranslations(result.text, missingSourceValues.length);
+            const translatedValues = parseTranslations(result.text, translationSourceValues.length);
             if (translatedValues.some((value)=>value === undefined)) throw new Error("Translation response is incomplete.");
             if (result.usage && options.maxTokenUsage) {
                 await recordTokenUsage({
@@ -164,7 +173,7 @@ export const createTranslateDocumentHandler = (options)=>async (req)=>{
             }
             return Response.json({
                 available: true,
-                values: missingSourceValues.map((entry, index)=>({
+                values: translationSourceValues.map((entry, index)=>({
                         fieldType: entry.fieldType,
                         path: entry.path,
                         value: translatedValues[index]

package/dist/index.d.ts

@@ -4,9 +4,14 @@ import { type MaxTokenUsageOptions } from "./ai/tokenUsage.js";
 import { type CollectionPermissionMap } from "./payload/collectionPermissions.js";
 export type { AIModelConfig, AIProviderConfig, AIProviderModelOption } from "./ai/providerOptions.js";
 export type { MaxTokenUsageOptions } from "./ai/tokenUsage.js";
+export type CollectionTypeAIOptions = {
+    aiInput?: boolean;
+    generateFields?: boolean;
+};
 export type PayloadAIPluginOptions = {
     aiInput?: boolean;
     allowUserApiKeys?: boolean;
+    authCollections?: CollectionTypeAIOptions;
     collections?: CollectionPermissionMap;
     disabled?: boolean;
     generateFields?: boolean;
@@ -22,5 +27,6 @@ export type PayloadAIPluginOptions = {
     promptCaching?: boolean;
     providers?: AIProviderConfig[];
     translate?: boolean;
+    uploadCollections?: CollectionTypeAIOptions;
 };
 export declare const payloadAiPlugin: (pluginOptions: PayloadAIPluginOptions) => (config: Config) => Config;

package/dist/index.js

@@ -192,6 +192,7 @@ const createAITokenUsageCollection = ()=>({
         ],
         timestamps: true
     });
+const hasAuthenticatedUser = (_data, _siblingData, { user })=>Boolean(user);
 const addAccountFields = ({ allowUserApiKeys, config })=>{
     const adminUserSlug = config.admin?.user;
     if (!adminUserSlug || !config.collections) return;
@@ -200,6 +201,9 @@ const addAccountFields = ({ allowUserApiKeys, config })=>{
     userCollection.fields.push({
         name: "aiProvider",
         type: "select",
+        admin: {
+            condition: hasAuthenticatedUser
+        },
         defaultValue: "openai",
         label: "AI Provider",
         options: aiProviders
@@ -209,6 +213,7 @@ const addAccountFields = ({ allowUserApiKeys, config })=>{
             name: "aiApiKey",
             type: "text",
             admin: {
+                condition: hasAuthenticatedUser,
                 components: {
                     Field: "@mvriu5/payload-ai/client#AIApiKeyField"
                 },
@@ -222,6 +227,7 @@ const aiField = {
     name: "payloadAi",
     type: "ui",
     admin: {
+        condition: hasAuthenticatedUser,
         components: {
             Field: "@mvriu5/payload-ai/client#AIInput"
         }
@@ -236,13 +242,15 @@ const getEntityLabel = (label, fallback)=>{
     }
     return fallback;
 };
-const addAIFieldsToDocumentsAndGlobals = ({ addGenerateFields, addAIInput, addTranslation, config })=>{
+const addAIFieldsToDocumentsAndGlobals = ({ addGenerateFields, addAIInput, addTranslation, authCollections, config, uploadCollections })=>{
     const pageContexts = new Map();
     const translationPageContexts = new Map();
     for (const collection of config.collections || []){
         if (isInternalCollection(collection.slug)) continue;
         if (collection.slug === "payload-ai-auditlog") continue;
-        if (addGenerateFields) {
+        const allowAIInput = addAIInput && (!collection.auth || authCollections?.aiInput === true) && (!collection.upload || uploadCollections?.aiInput === true);
+        const allowGenerateFields = addGenerateFields && (!collection.auth || authCollections?.generateFields === true) && (!collection.upload || uploadCollections?.generateFields === true);
+        if (allowGenerateFields) {
             const pageContext = addTextGenerationFields({
                 fields: collection.fields || [],
                 label: getEntityLabel(collection.labels?.singular, collection.slug),
@@ -251,7 +259,7 @@ const addAIFieldsToDocumentsAndGlobals = ({ addGenerateFields, addAIInput, addTr
             });
             pageContexts.set(`collection:${collection.slug}`, pageContext);
         }
-        if (addAIInput) collection.fields = [
+        if (allowAIInput) collection.fields = [
             aiField,
             ...collection.fields || []
         ];
@@ -339,7 +347,9 @@ export const payloadAiPlugin = (pluginOptions)=>(config)=>{
             addGenerateFields: generateFields,
             addAIInput: pluginOptions.aiInput !== false,
             addTranslation: pluginOptions.translate !== false,
-            config
+            authCollections: pluginOptions.authCollections,
+            config,
+            uploadCollections: pluginOptions.uploadCollections
         });
         const mentionCollectionSlugs = config.collections.flatMap((collection)=>{
             if (isInternalCollection(collection.slug)) return [];

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mvriu5/payload-ai",
-    "version": "1.6.0",
+    "version": "1.6.2",
     "description": "AI assistant plugin for Payload CMS with provider selection, CMS mentions, and signed action proposals.",
     "keywords": [
         "payload",
@@ -66,10 +66,10 @@
         "knip": "knip"
     },
     "devDependencies": {
-        "@ai-sdk/anthropic": "^3.0.81",
+        "@ai-sdk/anthropic": "^4.0.21",
         "@ai-sdk/google": "^3.0.80",
         "@ai-sdk/mistral": "^4.0.13",
-        "@ai-sdk/openai": "^3.0.67",
+        "@ai-sdk/openai": "^4.0.20",
         "@floating-ui/react": "0.27.20",
         "@openrouter/ai-sdk-provider": "^3.0.0",
         "@payloadcms/db-postgres": "3.86.0",
@@ -85,7 +85,7 @@
         "cross-env": "^10.1.0",
         "eslint": "^10.5.0",
         "graphql": "^16.8.1",
-        "jsdom": "^29.1.1",
+        "jsdom": "^30.0.0",
         "knip": "^6.18.0",
         "next": "16.2.11",
         "payload": "3.86.0",
@@ -98,10 +98,10 @@
         "vitest": "4.1.10"
     },
     "peerDependencies": {
-        "@ai-sdk/anthropic": "^3.0.81",
+        "@ai-sdk/anthropic": "^4.0.21",
         "@ai-sdk/google": "^3.0.80",
         "@ai-sdk/mistral": "^4.0.13",
-        "@ai-sdk/openai": "^3.0.67",
+        "@ai-sdk/openai": "^4.0.20",
         "@openrouter/ai-sdk-provider": "^3.0.0",
         "@payloadcms/ui": "^3.84.1",
         "payload": "^3.84.1"