@mvriu5/payload-ai 1.6.3 → 1.6.4

package/dist/plugin/collections.js

@@ -0,0 +1,169 @@
+import { tokenUsageCollectionSlug } from "../features/tokenUsage.js";
+export const createAIChangesCollection = ()=>({
+        slug: "payload-ai-auditlog",
+        access: {
+            create: ()=>false,
+            delete: ()=>false,
+            read: ({ req })=>Boolean(req.user),
+            update: ()=>false
+        },
+        admin: {
+            defaultColumns: [
+                "title",
+                "action",
+                "additions",
+                "removals",
+                "createdAt"
+            ],
+            group: "AI",
+            useAsTitle: "title"
+        },
+        labels: {
+            plural: "AI Changes",
+            singular: "AI Change"
+        },
+        fields: [
+            {
+                name: "title",
+                type: "text",
+                required: true
+            },
+            {
+                name: "action",
+                type: "select",
+                options: [
+                    "create",
+                    "update",
+                    "delete",
+                    "updateGlobal"
+                ],
+                required: true
+            },
+            {
+                name: "targetType",
+                type: "select",
+                options: [
+                    "collection",
+                    "global"
+                ],
+                required: true
+            },
+            {
+                name: "collection",
+                type: "text"
+            },
+            {
+                name: "slug",
+                type: "text"
+            },
+            {
+                name: "documentID",
+                type: "text"
+            },
+            {
+                name: "targetURL",
+                type: "text"
+            },
+            {
+                name: "additions",
+                type: "number",
+                defaultValue: 0
+            },
+            {
+                name: "removals",
+                type: "number",
+                defaultValue: 0
+            },
+            {
+                name: "before",
+                type: "json"
+            },
+            {
+                name: "after",
+                type: "json"
+            },
+            {
+                name: "proposal",
+                type: "json"
+            },
+            {
+                name: "prompt",
+                type: "textarea"
+            },
+            {
+                name: "inputTokens",
+                type: "number"
+            },
+            {
+                name: "outputTokens",
+                type: "number"
+            },
+            {
+                name: "totalTokens",
+                type: "number"
+            },
+            {
+                name: "aiResponse",
+                type: "textarea"
+            },
+            {
+                name: "userID",
+                type: "text"
+            },
+            {
+                name: "userLabel",
+                type: "text"
+            }
+        ],
+        timestamps: true
+    });
+export const createAITokenUsageCollection = ()=>({
+        slug: tokenUsageCollectionSlug,
+        access: {
+            create: ()=>false,
+            delete: ()=>false,
+            read: ()=>false,
+            update: ()=>false
+        },
+        admin: {
+            hidden: true
+        },
+        fields: [
+            {
+                name: "userID",
+                type: "text",
+                index: true,
+                required: true
+            },
+            {
+                name: "provider",
+                type: "text",
+                required: true
+            },
+            {
+                name: "model",
+                type: "text",
+                required: true
+            },
+            {
+                name: "inputTokens",
+                type: "number"
+            },
+            {
+                name: "outputTokens",
+                type: "number"
+            },
+            {
+                name: "totalTokens",
+                type: "number",
+                required: true
+            },
+            {
+                name: "recordedAt",
+                type: "date",
+                index: true,
+                required: true
+            }
+        ],
+        timestamps: true
+    });

package/dist/plugin/endpoints.d.ts

@@ -0,0 +1,23 @@
+import type { Config } from "payload";
+import type { getResolvedAIModelConfig, ResolvedAIProviderConfig } from "../features/providers/options.js";
+import type { ResolvedMaxTokenUsageOptions } from "../features/tokenUsage.js";
+import { type MediaUploadOptions } from "../handlers/mediaUploadHandler.js";
+import type { ResolvedCollectionPermissionMap } from "../features/collectionPermissions.js";
+import type { TranslationPageContext } from "../features/content/documentTranslation.js";
+import type { TextGenerationPageContext } from "../features/content/fieldGeneration.js";
+type RegisterAIEndpointsOptions = {
+    allowUserApiKeys: boolean;
+    collectionPermissions?: ResolvedCollectionPermissionMap;
+    config: Config;
+    generateFields: boolean;
+    maxOutputTokens?: number;
+    maxTokenUsage?: ResolvedMaxTokenUsageOptions;
+    mediaUploadOptions: MediaUploadOptions | null;
+    modelConfig: ReturnType<typeof getResolvedAIModelConfig>;
+    promptCaching: boolean;
+    providerConfigs: ResolvedAIProviderConfig[];
+    textGenerationPageContexts: Map<string, TextGenerationPageContext>;
+    translationPageContexts: Map<string, TranslationPageContext>;
+};
+export declare const registerAIEndpoints: ({ allowUserApiKeys, collectionPermissions, config, generateFields, maxOutputTokens, maxTokenUsage, mediaUploadOptions, modelConfig, promptCaching, providerConfigs, textGenerationPageContexts, translationPageContexts, }: RegisterAIEndpointsOptions) => void;
+export {};

package/dist/plugin/endpoints.js

@@ -0,0 +1,84 @@
+import { createApplyActionHandler } from "../handlers/applyActionHandler.js";
+import { createAuditLogHandler } from "../handlers/auditLogHandler.js";
+import { createChatHandler } from "../handlers/chatHandler.js";
+import { createGenerateFieldHandler } from "../handlers/generateFieldHandler.js";
+import { createMediaUploadHandler } from "../handlers/mediaUploadHandler.js";
+import { createMentionSuggestionHandler } from "../handlers/mentionSuggestionHandler.js";
+import { createProposalDiffHandler } from "../handlers/proposalDiffHandler.js";
+import { createTranslateDocumentHandler } from "../handlers/translateDocumentHandler.js";
+export const registerAIEndpoints = ({ allowUserApiKeys, collectionPermissions, config, generateFields, maxOutputTokens, maxTokenUsage, mediaUploadOptions, modelConfig, promptCaching, providerConfigs, textGenerationPageContexts, translationPageContexts })=>{
+    if (!config.endpoints) config.endpoints = [];
+    config.endpoints.push({
+        handler: createChatHandler({
+            allowUserApiKeys,
+            collections: collectionPermissions,
+            maxOutputTokens,
+            maxTokenUsage,
+            models: modelConfig,
+            promptCaching,
+            providers: providerConfigs
+        }),
+        method: "post",
+        path: "/ai-chat"
+    }, {
+        handler: createApplyActionHandler({
+            changeLogCollection: "payload-ai-auditlog",
+            collections: collectionPermissions
+        }),
+        method: "post",
+        path: "/ai-apply-action"
+    }, {
+        handler: createAuditLogHandler({
+            changeLogCollection: "payload-ai-auditlog"
+        }),
+        method: "get",
+        path: "/ai-audit-log"
+    }, {
+        handler: createProposalDiffHandler({
+            collections: collectionPermissions
+        }),
+        method: "post",
+        path: "/ai-proposal-diff"
+    }, {
+        handler: createMentionSuggestionHandler({
+            collections: collectionPermissions
+        }),
+        method: "post",
+        path: "/ai-mention-suggestion"
+    });
+    if (generateFields) {
+        config.endpoints.push({
+            handler: createGenerateFieldHandler({
+                allowUserApiKeys,
+                maxOutputTokens,
+                maxTokenUsage,
+                models: modelConfig,
+                pageContexts: textGenerationPageContexts,
+                providers: providerConfigs
+            }),
+            method: "post",
+            path: "/ai-generate-field"
+        });
+    }
+    if (translationPageContexts.size > 0) {
+        config.endpoints.push({
+            handler: createTranslateDocumentHandler({
+                allowUserApiKeys,
+                maxOutputTokens,
+                maxTokenUsage,
+                models: modelConfig,
+                pageContexts: translationPageContexts,
+                providers: providerConfigs
+            }),
+            method: "post",
+            path: "/ai-translate-document"
+        });
+    }
+    if (mediaUploadOptions) {
+        config.endpoints.push({
+            handler: createMediaUploadHandler(mediaUploadOptions),
+            method: "post",
+            path: "/ai-upload-media"
+        });
+    }
+};

package/dist/plugin/options.d.ts

@@ -0,0 +1,4 @@
+import type { MediaUploadOptions } from "../handlers/mediaUploadHandler.js";
+import type { PayloadAIPluginOptions } from "./types.js";
+export declare const resolveMediaUploadOptions: (media?: PayloadAIPluginOptions["media"]) => MediaUploadOptions | null;
+export declare const resolveMaxOutputTokens: (maxOutputTokens?: number) => number | undefined;

package/dist/plugin/options.js

@@ -0,0 +1,13 @@
+export const resolveMediaUploadOptions = (media)=>{
+    if (!media || media.enabled === false) return null;
+    return {
+        ...media.acceptedMimeTypes ? {
+            acceptedMimeTypes: media.acceptedMimeTypes
+        } : {},
+        collectionSlug: media.collectionSlug || "media",
+        ...typeof media.maxFileSize === "number" && Number.isFinite(media.maxFileSize) && media.maxFileSize > 0 ? {
+            maxFileSize: Math.floor(media.maxFileSize)
+        } : {}
+    };
+};
+export const resolveMaxOutputTokens = (maxOutputTokens)=>typeof maxOutputTokens === "number" && Number.isFinite(maxOutputTokens) && maxOutputTokens > 0 ? Math.floor(maxOutputTokens) : undefined;

package/dist/plugin/types.d.ts

@@ -0,0 +1,28 @@
+import type { AIModelConfig, AIProviderConfig } from "../features/providers/options.js";
+import type { MaxTokenUsageOptions } from "../features/tokenUsage.js";
+import type { CollectionPermissionMap } from "../features/collectionPermissions.js";
+export type CollectionTypeAIOptions = {
+    aiInput?: boolean;
+    generateFields?: boolean;
+};
+export type PayloadAIPluginOptions = {
+    aiInput?: boolean;
+    allowUserApiKeys?: boolean;
+    authCollections?: CollectionTypeAIOptions;
+    collections?: CollectionPermissionMap;
+    disabled?: boolean;
+    generateFields?: boolean;
+    maxOutputTokens?: number;
+    maxTokenUsage?: MaxTokenUsageOptions;
+    media?: {
+        acceptedMimeTypes?: string[];
+        collectionSlug?: string;
+        enabled?: boolean;
+        maxFileSize?: number;
+    };
+    models?: AIModelConfig;
+    promptCaching?: boolean;
+    providers?: AIProviderConfig[];
+    translate?: boolean;
+    uploadCollections?: CollectionTypeAIOptions;
+};

package/dist/plugin/types.js

@@ -0,0 +1 @@
+export { };

package/dist/{payload/shared.d.ts → utils/data.d.ts}

@@ -1,15 +1,5 @@
 import type { PayloadHandler } from "payload";
-export type LocalizedDataInput = Record<string, Record<string, unknown>>;
-export type AIActionProposalLike = {
-    action: "create" | "delete" | "update" | "updateGlobal";
-    collection?: string;
-    data?: Record<string, unknown>;
-    id?: string;
-    label: string;
-    locale?: string;
-    localizedData?: LocalizedDataInput;
-    slug?: string;
-};
+import type { ActionProposal, LocalizedDataInput } from "../features/proposals/types.js";
 export declare const getSerializableLabel: (label: unknown, fallback?: string) => string;
 export declare const isInternalCollection: (slug: string) => boolean;
 export declare const isRecord: (value: unknown) => value is Record<string, unknown>;
@@ -20,7 +10,7 @@ export declare const hasLocalizedData: <Value>(value: Value) => value is Value &
 };
 export declare const getDefaultLocale: (req: Parameters<PayloadHandler>[0]) => string | null;
 export declare const getJSONLineKey: (line: string) => string | null;
-export declare const isActionProposal: (proposal: unknown) => proposal is AIActionProposalLike;
+export declare const isActionProposal: (proposal: unknown) => proposal is ActionProposal;
 export declare const getOptionalNumber: (value: unknown) => number | undefined;
 export declare const getNumber: (value: unknown) => number;
 export declare const getString: (value: unknown) => string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mvriu5/payload-ai",
-    "version": "1.6.3",
+    "version": "1.6.4",
     "description": "AI assistant plugin for Payload CMS with provider selection, CMS mentions, and signed action proposals.",
     "keywords": [
         "payload",