@jhb.software/payload-alt-text-plugin 0.1.0

package/dist/endpoints/generateAltText.js

@@ -0,0 +1,128 @@
+import OpenAI from 'openai';
+import { z } from 'zod';
+import { getGenerationCost } from '../utilities/getGenerationCost.js';
+import { zodResponseFormat } from '../utilities/zodResponseFormat.js';
+/**
+ * Generates alt text for a single image using OpenAI Vision API.
+ * Returns result without updating the document.
+ */ export const generateAltTextEndpoint = async (req)=>{
+    try {
+        if (!req.user) {
+            return Response.json({
+                error: 'Unauthorized'
+            }, {
+                status: 401
+            });
+        }
+        const data = 'json' in req && typeof req.json === 'function' ? await req.json() : null;
+        const requestSchema = z.object({
+            collection: z.string(),
+            id: z.string(),
+            locale: z.string()
+        });
+        const { collection, id, locale } = requestSchema.parse(data);
+        const imageDoc = await req.payload.findByID({
+            collection,
+            id,
+            depth: 0
+        });
+        if (!imageDoc) {
+            return Response.json({
+                error: 'Image not found'
+            }, {
+                status: 404
+            });
+        }
+        const pluginConfig = req.payload.config.custom?.altTextPluginConfig;
+        if (!pluginConfig?.getImageThumbnail) {
+            return Response.json({
+                error: 'getImageThumbnail function not configured'
+            }, {
+                status: 500
+            });
+        }
+        const imageThumbnailUrl = pluginConfig.getImageThumbnail(imageDoc);
+        if (!imageThumbnailUrl) {
+            return Response.json({
+                error: 'Image thumbnail URL not defined'
+            }, {
+                status: 500
+            });
+        }
+        if (!imageThumbnailUrl.startsWith('https://') && !imageThumbnailUrl.includes('http://')) {
+            return Response.json({
+                error: 'Image thumbnail URL is not a valid URL. It must start with https:// or http://'
+            }, {
+                status: 500
+            });
+        }
+        const openai = new OpenAI({
+            apiKey: pluginConfig.openAIApiKey
+        });
+        const modelResponseSchema = z.object({
+            altText: z.string().describe('A concise, descriptive alt text for the image'),
+            keywords: z.array(z.string()).describe('Keywords that describe the content of the image')
+        });
+        const response = await openai.chat.completions.parse({
+            model: pluginConfig.model,
+            messages: [
+                {
+                    role: 'system',
+                    content: `
+            You are an expert at analyzing images and creating descriptive image alt text. 
+            
+            Please analyze the given image and provide the following:
+            - A concise, descriptive alt text (1-2 sentences) as "altText". Focus on the subject, action, and setting. Avoid phrases like 'Image of', 'A picture of', or 'Photo showing'. Be specific and include relevant details like location or context if visible. Make no assumptions.
+            - A list of keywords that describe the content (e.g., ["Camel", "Palm trees", "Desert"]) as "keywords"
+
+            If a context is provided, use it to enhance the alt text.
+
+            Format your response as a JSON object. You must respond in the ${locale} language.
+          `
+                },
+                {
+                    role: 'user',
+                    content: [
+                        {
+                            type: 'image_url',
+                            image_url: {
+                                url: imageThumbnailUrl
+                            }
+                        },
+                        ...'filename' in imageDoc && imageDoc.filename ? [
+                            {
+                                type: 'text',
+                                text: imageDoc.filename
+                            }
+                        ] : []
+                    ]
+                }
+            ],
+            // limit the response tokens and costs per request
+            max_completion_tokens: 150,
+            response_format: zodResponseFormat(modelResponseSchema, 'data')
+        });
+        console.log({
+            imageId: id,
+            ...getGenerationCost(response, pluginConfig.model)
+        });
+        const result = response.choices[0]?.message?.parsed;
+        if (!result) {
+            return Response.json({
+                error: 'No result from OpenAI'
+            }, {
+                status: 500
+            });
+        }
+        return Response.json(result);
+    } catch (error) {
+        console.error('Error generating alt text:', error);
+        return Response.json({
+            error: `Error generating alt text: ${error instanceof Error ? error.message : 'Unknown error'}`
+        }, {
+            status: 500
+        });
+    }
+};
+
+//# sourceMappingURL=generateAltText.js.map

package/dist/endpoints/generateAltText.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/endpoints/generateAltText.ts"],"sourcesContent":["import OpenAI from 'openai'\nimport { ChatCompletionContentPartText } from 'openai/resources/chat/completions.mjs'\nimport type { PayloadHandler, PayloadRequest } from 'payload'\nimport { z } from 'zod'\nimport { getGenerationCost } from '../utilities/getGenerationCost.js'\nimport type { AltTextPluginConfig } from '../types/AltTextPluginConfig.js'\nimport { zodResponseFormat } from '../utilities/zodResponseFormat.js'\n\n/**\n * Generates alt text for a single image using OpenAI Vision API.\n * Returns result without updating the document.\n */\nexport const generateAltTextEndpoint: PayloadHandler = async (req: PayloadRequest) => {\n  try {\n    if (!req.user) {\n      return Response.json({ error: 'Unauthorized' }, { status: 401 })\n    }\n\n    const data = 'json' in req && typeof req.json === 'function' ? await req.json() : null\n\n    const requestSchema = z.object({\n      collection: z.string(),\n      id: z.string(),\n      locale: z.string(),\n    })\n\n    const { collection, id, locale } = requestSchema.parse(data)\n\n    const imageDoc = await req.payload.findByID({\n      collection,\n      id,\n      depth: 0,\n    })\n\n    if (!imageDoc) {\n      return Response.json({ error: 'Image not found' }, { status: 404 })\n    }\n\n    const pluginConfig = req.payload.config.custom?.altTextPluginConfig as\n      | AltTextPluginConfig\n      | undefined\n\n    if (!pluginConfig?.getImageThumbnail) {\n      return Response.json({ error: 'getImageThumbnail function not configured' }, { status: 500 })\n    }\n    const imageThumbnailUrl = pluginConfig.getImageThumbnail(imageDoc)\n\n    if (!imageThumbnailUrl) {\n      return Response.json({ error: 'Image thumbnail URL not defined' }, { status: 500 })\n    }\n\n    if (!imageThumbnailUrl.startsWith('https://') && !imageThumbnailUrl.includes('http://')) {\n      return Response.json(\n        { error: 'Image thumbnail URL is not a valid URL. It must start with https:// or http://' },\n        { status: 500 },\n      )\n    }\n\n    const openai = new OpenAI({\n      apiKey: pluginConfig.openAIApiKey,\n    })\n\n    const modelResponseSchema = z.object({\n      altText: z.string().describe('A concise, descriptive alt text for the image'),\n      keywords: z.array(z.string()).describe('Keywords that describe the content of the image'),\n    })\n\n    const response = await openai.chat.completions.parse({\n      model: pluginConfig.model,\n      messages: [\n        {\n          role: 'system',\n          content: `\n            You are an expert at analyzing images and creating descriptive image alt text. \n            \n            Please analyze the given image and provide the following:\n            - A concise, descriptive alt text (1-2 sentences) as \"altText\". Focus on the subject, action, and setting. Avoid phrases like 'Image of', 'A picture of', or 'Photo showing'. Be specific and include relevant details like location or context if visible. Make no assumptions.\n            - A list of keywords that describe the content (e.g., [\"Camel\", \"Palm trees\", \"Desert\"]) as \"keywords\"\n\n            If a context is provided, use it to enhance the alt text.\n\n            Format your response as a JSON object. You must respond in the ${locale} language.\n          `,\n        },\n        {\n          role: 'user',\n          content: [\n            {\n              type: 'image_url',\n              image_url: { url: imageThumbnailUrl },\n            },\n            ...('filename' in imageDoc && imageDoc.filename\n              ? [\n                  {\n                    type: 'text',\n                    text: imageDoc.filename,\n                  } satisfies ChatCompletionContentPartText,\n                ]\n              : []),\n          ],\n        },\n      ],\n      // limit the response tokens and costs per request\n      max_completion_tokens: 150,\n      response_format: zodResponseFormat(modelResponseSchema, 'data'),\n    })\n\n    console.log({ imageId: id, ...getGenerationCost(response, pluginConfig.model) })\n\n    const result = response.choices[0]?.message?.parsed\n\n    if (!result) {\n      return Response.json({ error: 'No result from OpenAI' }, { status: 500 })\n    }\n\n    return Response.json(result)\n  } catch (error) {\n    console.error('Error generating alt text:', error)\n    return Response.json(\n      {\n        error: `Error generating alt text: ${error instanceof Error ? error.message : 'Unknown error'}`,\n      },\n      { status: 500 },\n    )\n  }\n}\n"],"names":["OpenAI","z","getGenerationCost","zodResponseFormat","generateAltTextEndpoint","req","user","Response","json","error","status","data","requestSchema","object","collection","string","id","locale","parse","imageDoc","payload","findByID","depth","pluginConfig","config","custom","altTextPluginConfig","getImageThumbnail","imageThumbnailUrl","startsWith","includes","openai","apiKey","openAIApiKey","modelResponseSchema","altText","describe","keywords","array","response","chat","completions","model","messages","role","content","type","image_url","url","filename","text","max_completion_tokens","response_format","console","log","imageId","result","choices","message","parsed","Error"],"mappings":"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"}

package/dist/exports/client.d.ts

@@ -0,0 +1,3 @@
+export { AltTextField } from '../components/AltTextField.js';
+export { GenerateAltTextButton } from '../components/GenerateAltTextButton.js';
+export { BulkGenerateAltTextsButton } from '../components/BulkGenerateAltTextsButton.js';

package/dist/exports/client.js

@@ -0,0 +1,5 @@
+export { AltTextField } from '../components/AltTextField.js';
+export { GenerateAltTextButton } from '../components/GenerateAltTextButton.js';
+export { BulkGenerateAltTextsButton } from '../components/BulkGenerateAltTextsButton.js';
+
+//# sourceMappingURL=client.js.map

package/dist/exports/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/exports/client.ts"],"sourcesContent":["export { AltTextField } from '../components/AltTextField.js'\nexport { GenerateAltTextButton } from '../components/GenerateAltTextButton.js'\nexport { BulkGenerateAltTextsButton } from '../components/BulkGenerateAltTextsButton.js'\n"],"names":["AltTextField","GenerateAltTextButton","BulkGenerateAltTextsButton"],"mappings":"AAAA,SAASA,YAAY,QAAQ,gCAA+B;AAC5D,SAASC,qBAAqB,QAAQ,yCAAwC;AAC9E,SAASC,0BAA0B,QAAQ,8CAA6C"}

package/dist/fields/altTextField.d.ts

@@ -0,0 +1,4 @@
+import type { TextareaField } from 'payload';
+export declare function altTextField({ localized, }: {
+    localized?: TextareaField['localized'];
+}): TextareaField;

package/dist/fields/altTextField.js

@@ -0,0 +1,27 @@
+export function altTextField({ localized }) {
+    return {
+        name: 'alt',
+        label: 'Alternate text',
+        type: 'textarea',
+        required: true,
+        localized: localized,
+        validate: (value, ctx)=>{
+            // if the document has an id, the alt text is required
+            if (ctx.id) {
+                if (!value || value.trim().length === 0) {
+                    return 'The alternate text is required.';
+                }
+            }
+            // The alt text is not required when the document is created because the alt text generation
+            // can only be used once the document is created and the image uploaded
+            return true;
+        },
+        admin: {
+            components: {
+                Field: '@jhb.software/payload-alt-text-plugin/client#AltTextField'
+            }
+        }
+    };
+}
+
+//# sourceMappingURL=altTextField.js.map

package/dist/fields/altTextField.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/fields/altTextField.ts"],"sourcesContent":["import type { TextareaField } from 'payload'\n\nexport function altTextField({\n  localized,\n}: {\n  localized?: TextareaField['localized']\n}): TextareaField {\n  return {\n    name: 'alt',\n    label: 'Alternate text',\n    type: 'textarea',\n    required: true,\n    localized: localized,\n    validate: (value, ctx) => {\n      // if the document has an id, the alt text is required\n      if (ctx.id) {\n        if (!value || value.trim().length === 0) {\n          return 'The alternate text is required.'\n        }\n      }\n\n      // The alt text is not required when the document is created because the alt text generation\n      // can only be used once the document is created and the image uploaded\n      return true\n    },\n    admin: {\n      components: {\n        Field: '@jhb.software/payload-alt-text-plugin/client#AltTextField',\n      },\n    },\n  }\n}\n"],"names":["altTextField","localized","name","label","type","required","validate","value","ctx","id","trim","length","admin","components","Field"],"mappings":"AAEA,OAAO,SAASA,aAAa,EAC3BC,SAAS,EAGV;IACC,OAAO;QACLC,MAAM;QACNC,OAAO;QACPC,MAAM;QACNC,UAAU;QACVJ,WAAWA;QACXK,UAAU,CAACC,OAAOC;YAChB,sDAAsD;YACtD,IAAIA,IAAIC,EAAE,EAAE;gBACV,IAAI,CAACF,SAASA,MAAMG,IAAI,GAAGC,MAAM,KAAK,GAAG;oBACvC,OAAO;gBACT;YACF;YAEA,4FAA4F;YAC5F,uEAAuE;YACvE,OAAO;QACT;QACAC,OAAO;YACLC,YAAY;gBACVC,OAAO;YACT;QACF;IACF;AACF"}

package/dist/fields/keywordsField.d.ts

@@ -0,0 +1,4 @@
+import type { TextField } from 'payload';
+export declare function keywordsField({ localized }: {
+    localized?: TextField['localized'];
+}): TextField;

package/dist/fields/keywordsField.js

@@ -0,0 +1,17 @@
+export function keywordsField({ localized }) {
+    return {
+        name: 'keywords',
+        label: 'Keywords',
+        type: 'text',
+        hasMany: true,
+        required: false,
+        localized: localized,
+        hidden: true,
+        admin: {
+            description: 'Keywords which describe the image. Used when searching for the image.',
+            readOnly: true
+        }
+    };
+}
+
+//# sourceMappingURL=keywordsField.js.map

package/dist/fields/keywordsField.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/fields/keywordsField.ts"],"sourcesContent":["import type { TextField } from 'payload'\n\nexport function keywordsField({ localized }: { localized?: TextField['localized'] }): TextField {\n  return {\n    name: 'keywords',\n    label: 'Keywords',\n    type: 'text',\n    hasMany: true,\n    required: false,\n    localized: localized,\n    hidden: true, // this field is only meant to be used for improving the search\n    admin: {\n      description: 'Keywords which describe the image. Used when searching for the image.',\n      readOnly: true,\n    },\n  }\n}\n"],"names":["keywordsField","localized","name","label","type","hasMany","required","hidden","admin","description","readOnly"],"mappings":"AAEA,OAAO,SAASA,cAAc,EAAEC,SAAS,EAA0C;IACjF,OAAO;QACLC,MAAM;QACNC,OAAO;QACPC,MAAM;QACNC,SAAS;QACTC,UAAU;QACVL,WAAWA;QACXM,QAAQ;QACRC,OAAO;YACLC,aAAa;YACbC,UAAU;QACZ;IACF;AACF"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { payloadAltTextPlugin } from './plugin.js';
+export type { IncomingAltTextPluginConfig as AltTextPluginConfig } from './types/AltTextPluginConfig.js';

package/dist/index.js

@@ -0,0 +1,3 @@
+export { payloadAltTextPlugin } from './plugin.js';
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export { payloadAltTextPlugin } from './plugin.js'\nexport type { IncomingAltTextPluginConfig as AltTextPluginConfig } from './types/AltTextPluginConfig.js'\n"],"names":["payloadAltTextPlugin"],"mappings":"AAAA,SAASA,oBAAoB,QAAQ,cAAa"}

package/dist/plugin.d.ts

@@ -0,0 +1,3 @@
+import type { Config } from 'payload';
+import type { IncomingAltTextPluginConfig } from './types/AltTextPluginConfig.js';
+export declare const payloadAltTextPlugin: (incomingPluginConfig: IncomingAltTextPluginConfig) => (incomingConfig: Config) => Config;

package/dist/plugin.js

@@ -0,0 +1,90 @@
+import { altTextField } from './fields/altTextField.js';
+import { keywordsField } from './fields/keywordsField.js';
+import { generateAltTextEndpoint } from './endpoints/generateAltText.js';
+import { bulkGenerateAltTextsEndpoint } from './endpoints/bulkGenerateAltTexts.js';
+export const payloadAltTextPlugin = (incomingPluginConfig)=>(incomingConfig)=>{
+        const config = {
+            ...incomingConfig
+        };
+        // If the plugin is disabled, return the config without modifying it
+        if (incomingPluginConfig.enabled === false) {
+            return config;
+        }
+        const locales = config.localization ? config.localization.locales.map((localeConfig)=>typeof localeConfig === 'string' ? localeConfig : localeConfig.code) : [];
+        if (locales.length === 0) {
+            throw new Error('The alt text plugin currently only supports localized setups. If you need to use this plugin in a non-localized setup, please open an issue at https://github.com/jhb-software/payload-plugins.');
+        }
+        const pluginConfig = {
+            enabled: incomingPluginConfig.enabled ?? true,
+            openAIApiKey: incomingPluginConfig.openAIApiKey,
+            collections: incomingPluginConfig.collections,
+            maxBulkGenerateConcurrency: incomingPluginConfig.maxBulkGenerateConcurrency ?? 16,
+            model: incomingPluginConfig.model ?? 'gpt-4.1-nano',
+            locales: locales,
+            getImageThumbnail: incomingPluginConfig.getImageThumbnail,
+            fieldsOverride: incomingPluginConfig.fieldsOverride
+        };
+        const defaultFields = [
+            altTextField({
+                localized: Boolean(config.localization)
+            }),
+            keywordsField({
+                localized: Boolean(config.localization)
+            })
+        ];
+        const fields = incomingPluginConfig.fieldsOverride && typeof incomingPluginConfig.fieldsOverride === 'function' ? incomingPluginConfig.fieldsOverride({
+            defaultFields
+        }) : defaultFields;
+        // Ensure collections array exists
+        config.collections = config.collections || [];
+        // Map over collections and inject AI alt text fields into specified ones
+        config.collections = config.collections.map((collectionConfig)=>{
+            if (pluginConfig.collections.includes(collectionConfig.slug)) {
+                if (!collectionConfig.upload) {
+                    console.warn(`AI Alt Text Plugin: Collection "${collectionConfig.slug}" is not an upload collection. Skipping field injection.`);
+                    return collectionConfig;
+                }
+                return {
+                    ...collectionConfig,
+                    admin: {
+                        ...collectionConfig.admin,
+                        components: {
+                            ...collectionConfig.admin?.components ?? {},
+                            beforeListTable: [
+                                ...collectionConfig.admin?.components?.beforeListTable ?? [],
+                                '@jhb.software/payload-alt-text-plugin/client#BulkGenerateAltTextsButton'
+                            ]
+                        }
+                    },
+                    fields: [
+                        ...collectionConfig.fields ?? [],
+                        ...fields
+                    ]
+                };
+            }
+            return collectionConfig;
+        });
+        return {
+            ...config,
+            custom: {
+                ...config.custom,
+                // Make plugin config available in hooks/actions
+                altTextPluginConfig: pluginConfig
+            },
+            endpoints: [
+                ...config.endpoints ?? [],
+                {
+                    path: '/alt-text-plugin/generate-alt-text',
+                    method: 'post',
+                    handler: generateAltTextEndpoint
+                },
+                {
+                    path: '/alt-text-plugin/bulk-generate-alt-texts',
+                    method: 'post',
+                    handler: bulkGenerateAltTextsEndpoint
+                }
+            ]
+        };
+    };
+
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["import type { Config } from 'payload'\n\nimport type {\n  AltTextPluginConfig,\n  IncomingAltTextPluginConfig,\n} from './types/AltTextPluginConfig.js'\nimport { altTextField } from './fields/altTextField.js'\nimport { keywordsField } from './fields/keywordsField.js'\nimport { generateAltTextEndpoint } from './endpoints/generateAltText.js'\nimport { bulkGenerateAltTextsEndpoint } from './endpoints/bulkGenerateAltTexts.js'\n\nexport const payloadAltTextPlugin =\n  (incomingPluginConfig: IncomingAltTextPluginConfig) =>\n  (incomingConfig: Config): Config => {\n    const config = { ...incomingConfig }\n\n    // If the plugin is disabled, return the config without modifying it\n    if (incomingPluginConfig.enabled === false) {\n      return config\n    }\n\n    const locales = config.localization\n      ? config.localization.locales.map((localeConfig) =>\n          typeof localeConfig === 'string' ? localeConfig : localeConfig.code,\n        )\n      : []\n\n    if (locales.length === 0) {\n      throw new Error(\n        'The alt text plugin currently only supports localized setups. If you need to use this plugin in a non-localized setup, please open an issue at https://github.com/jhb-software/payload-plugins.',\n      )\n    }\n\n    const pluginConfig: AltTextPluginConfig = {\n      enabled: incomingPluginConfig.enabled ?? true,\n      openAIApiKey: incomingPluginConfig.openAIApiKey,\n      collections: incomingPluginConfig.collections,\n      maxBulkGenerateConcurrency: incomingPluginConfig.maxBulkGenerateConcurrency ?? 16,\n      model: incomingPluginConfig.model ?? 'gpt-4.1-nano',\n      locales: locales,\n      getImageThumbnail: incomingPluginConfig.getImageThumbnail,\n      fieldsOverride: incomingPluginConfig.fieldsOverride,\n    }\n\n    const defaultFields = [\n      altTextField({\n        localized: Boolean(config.localization),\n      }),\n      keywordsField({\n        localized: Boolean(config.localization),\n      }),\n    ]\n\n    const fields =\n      incomingPluginConfig.fieldsOverride &&\n      typeof incomingPluginConfig.fieldsOverride === 'function'\n        ? incomingPluginConfig.fieldsOverride({ defaultFields })\n        : defaultFields\n\n    // Ensure collections array exists\n    config.collections = config.collections || []\n\n    // Map over collections and inject AI alt text fields into specified ones\n    config.collections = config.collections.map((collectionConfig) => {\n      if (pluginConfig.collections.includes(collectionConfig.slug)) {\n        if (!collectionConfig.upload) {\n          console.warn(\n            `AI Alt Text Plugin: Collection \"${collectionConfig.slug}\" is not an upload collection. Skipping field injection.`,\n          )\n          return collectionConfig\n        }\n\n        return {\n          ...collectionConfig,\n          admin: {\n            ...collectionConfig.admin,\n            components: {\n              ...(collectionConfig.admin?.components ?? {}),\n              beforeListTable: [\n                ...(collectionConfig.admin?.components?.beforeListTable ?? []),\n                '@jhb.software/payload-alt-text-plugin/client#BulkGenerateAltTextsButton',\n              ],\n            },\n          },\n          fields: [...(collectionConfig.fields ?? []), ...fields],\n        }\n      }\n\n      return collectionConfig\n    })\n\n    return {\n      ...config,\n      custom: {\n        ...config.custom,\n        // Make plugin config available in hooks/actions\n        altTextPluginConfig: pluginConfig,\n      },\n      endpoints: [\n        ...(config.endpoints ?? []),\n        {\n          path: '/alt-text-plugin/generate-alt-text',\n          method: 'post',\n          handler: generateAltTextEndpoint,\n        },\n        {\n          path: '/alt-text-plugin/bulk-generate-alt-texts',\n          method: 'post',\n          handler: bulkGenerateAltTextsEndpoint,\n        },\n      ],\n    }\n  }\n"],"names":["altTextField","keywordsField","generateAltTextEndpoint","bulkGenerateAltTextsEndpoint","payloadAltTextPlugin","incomingPluginConfig","incomingConfig","config","enabled","locales","localization","map","localeConfig","code","length","Error","pluginConfig","openAIApiKey","collections","maxBulkGenerateConcurrency","model","getImageThumbnail","fieldsOverride","defaultFields","localized","Boolean","fields","collectionConfig","includes","slug","upload","console","warn","admin","components","beforeListTable","custom","altTextPluginConfig","endpoints","path","method","handler"],"mappings":"AAMA,SAASA,YAAY,QAAQ,2BAA0B;AACvD,SAASC,aAAa,QAAQ,4BAA2B;AACzD,SAASC,uBAAuB,QAAQ,iCAAgC;AACxE,SAASC,4BAA4B,QAAQ,sCAAqC;AAElF,OAAO,MAAMC,uBACX,CAACC,uBACD,CAACC;QACC,MAAMC,SAAS;YAAE,GAAGD,cAAc;QAAC;QAEnC,oEAAoE;QACpE,IAAID,qBAAqBG,OAAO,KAAK,OAAO;YAC1C,OAAOD;QACT;QAEA,MAAME,UAAUF,OAAOG,YAAY,GAC/BH,OAAOG,YAAY,CAACD,OAAO,CAACE,GAAG,CAAC,CAACC,eAC/B,OAAOA,iBAAiB,WAAWA,eAAeA,aAAaC,IAAI,IAErE,EAAE;QAEN,IAAIJ,QAAQK,MAAM,KAAK,GAAG;YACxB,MAAM,IAAIC,MACR;QAEJ;QAEA,MAAMC,eAAoC;YACxCR,SAASH,qBAAqBG,OAAO,IAAI;YACzCS,cAAcZ,qBAAqBY,YAAY;YAC/CC,aAAab,qBAAqBa,WAAW;YAC7CC,4BAA4Bd,qBAAqBc,0BAA0B,IAAI;YAC/EC,OAAOf,qBAAqBe,KAAK,IAAI;YACrCX,SAASA;YACTY,mBAAmBhB,qBAAqBgB,iBAAiB;YACzDC,gBAAgBjB,qBAAqBiB,cAAc;QACrD;QAEA,MAAMC,gBAAgB;YACpBvB,aAAa;gBACXwB,WAAWC,QAAQlB,OAAOG,YAAY;YACxC;YACAT,cAAc;gBACZuB,WAAWC,QAAQlB,OAAOG,YAAY;YACxC;SACD;QAED,MAAMgB,SACJrB,qBAAqBiB,cAAc,IACnC,OAAOjB,qBAAqBiB,cAAc,KAAK,aAC3CjB,qBAAqBiB,cAAc,CAAC;YAAEC;QAAc,KACpDA;QAEN,kCAAkC;QAClChB,OAAOW,WAAW,GAAGX,OAAOW,WAAW,IAAI,EAAE;QAE7C,yEAAyE;QACzEX,OAAOW,WAAW,GAAGX,OAAOW,WAAW,CAACP,GAAG,CAAC,CAACgB;YAC3C,IAAIX,aAAaE,WAAW,CAACU,QAAQ,CAACD,iBAAiBE,IAAI,GAAG;gBAC5D,IAAI,CAACF,iBAAiBG,MAAM,EAAE;oBAC5BC,QAAQC,IAAI,CACV,CAAC,gCAAgC,EAAEL,iBAAiBE,IAAI,CAAC,wDAAwD,CAAC;oBAEpH,OAAOF;gBACT;gBAEA,OAAO;oBACL,GAAGA,gBAAgB;oBACnBM,OAAO;wBACL,GAAGN,iBAAiBM,KAAK;wBACzBC,YAAY;4BACV,GAAIP,iBAAiBM,KAAK,EAAEC,cAAc,CAAC,CAAC;4BAC5CC,iBAAiB;mCACXR,iBAAiBM,KAAK,EAAEC,YAAYC,mBAAmB,EAAE;gCAC7D;6BACD;wBACH;oBACF;oBACAT,QAAQ;2BAAKC,iBAAiBD,MAAM,IAAI,EAAE;2BAAMA;qBAAO;gBACzD;YACF;YAEA,OAAOC;QACT;QAEA,OAAO;YACL,GAAGpB,MAAM;YACT6B,QAAQ;gBACN,GAAG7B,OAAO6B,MAAM;gBAChB,gDAAgD;gBAChDC,qBAAqBrB;YACvB;YACAsB,WAAW;mBACL/B,OAAO+B,SAAS,IAAI,EAAE;gBAC1B;oBACEC,MAAM;oBACNC,QAAQ;oBACRC,SAASvC;gBACX;gBACA;oBACEqC,MAAM;oBACNC,QAAQ;oBACRC,SAAStC;gBACX;aACD;QACH;IACF,EAAC"}

package/dist/types/AltTextPluginConfig.d.ts

@@ -0,0 +1,48 @@
+import { Field } from 'payload';
+/** Configuration options for the alt text plugin. */
+export type IncomingAltTextPluginConfig = {
+    /** Whether the plugin is enabled. */
+    enabled?: boolean;
+    /** OpenAI API key for authentication. */
+    openAIApiKey: string;
+    /** Collection slugs to enable the plugin for. */
+    collections: string[];
+    /** Maximum number of concurrent API requests for bulk operations. */
+    maxBulkGenerateConcurrency?: number;
+    /**
+     * Function to get the thumbnail URL of an image document.
+     * This URL will be sent to the LLM for analysis.
+     *
+     * @remarks
+     * - The URL must be publicly accessible so the LLM can fetch it
+     * - Use a thumbnail/preview version of the image when possible (e.g. from the sizes field)
+     */
+    getImageThumbnail: (doc: Record<string, unknown>) => string;
+    /** The OpenAI LLM model to use for alt text generation. */
+    model?: 'gpt-4.1-nano' | 'gpt-4.1-mini';
+    /** Override the default fields inserted by the plugin via a function that receives the default fields and returns the new fields */
+    fieldsOverride?: (args: {
+        defaultFields: Field[];
+    }) => Field[];
+};
+/** Configuration of the alt text plugin after defaults have been applied. */
+export type AltTextPluginConfig = {
+    /** Whether the plugin is enabled. */
+    enabled: boolean;
+    /** OpenAI API key for authentication. */
+    openAIApiKey: string;
+    /** Collection slugs to enable the plugin for. */
+    collections: string[];
+    /** Maximum number of concurrent API requests for bulk generate operations. */
+    maxBulkGenerateConcurrency: number;
+    /** Function to get the thumbnail URL of an image document. */
+    getImageThumbnail: (doc: Record<string, unknown>) => string;
+    /** The OpenAI LLM model to use for alt text generation. */
+    model: 'gpt-4.1-nano' | 'gpt-4.1-mini';
+    /** Override the default fields inserted by the plugin via a function that receives the default fields and returns the new fields */
+    fieldsOverride?: (args: {
+        defaultFields: Field[];
+    }) => Field[];
+    /** The locales to generate alt texts for. */
+    locales: string[];
+};

package/dist/types/AltTextPluginConfig.js

@@ -0,0 +1,3 @@
+/** Configuration of the alt text plugin after defaults have been applied. */ export { };
+
+//# sourceMappingURL=AltTextPluginConfig.js.map

package/dist/types/AltTextPluginConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/AltTextPluginConfig.ts"],"sourcesContent":["import { Field } from 'payload'\n\n/** Configuration options for the alt text plugin. */\nexport type IncomingAltTextPluginConfig = {\n  /** Whether the plugin is enabled. */\n  enabled?: boolean\n\n  /** OpenAI API key for authentication. */\n  openAIApiKey: string\n\n  /** Collection slugs to enable the plugin for. */\n  collections: string[]\n\n  /** Maximum number of concurrent API requests for bulk operations. */\n  maxBulkGenerateConcurrency?: number\n\n  /**\n   * Function to get the thumbnail URL of an image document.\n   * This URL will be sent to the LLM for analysis.\n   *\n   * @remarks\n   * - The URL must be publicly accessible so the LLM can fetch it\n   * - Use a thumbnail/preview version of the image when possible (e.g. from the sizes field)\n   */\n  getImageThumbnail: (doc: Record<string, unknown>) => string\n\n  /** The OpenAI LLM model to use for alt text generation. */\n  model?: 'gpt-4.1-nano' | 'gpt-4.1-mini'\n\n  /** Override the default fields inserted by the plugin via a function that receives the default fields and returns the new fields */\n  fieldsOverride?: (args: { defaultFields: Field[] }) => Field[]\n}\n\n/** Configuration of the alt text plugin after defaults have been applied. */\nexport type AltTextPluginConfig = {\n  /** Whether the plugin is enabled. */\n  enabled: boolean\n\n  /** OpenAI API key for authentication. */\n  openAIApiKey: string\n\n  /** Collection slugs to enable the plugin for. */\n  collections: string[]\n\n  /** Maximum number of concurrent API requests for bulk generate operations. */\n  maxBulkGenerateConcurrency: number\n\n  /** Function to get the thumbnail URL of an image document. */\n  getImageThumbnail: (doc: Record<string, unknown>) => string\n\n  /** The OpenAI LLM model to use for alt text generation. */\n  model: 'gpt-4.1-nano' | 'gpt-4.1-mini'\n\n  /** Override the default fields inserted by the plugin via a function that receives the default fields and returns the new fields */\n  fieldsOverride?: (args: { defaultFields: Field[] }) => Field[]\n\n  /** The locales to generate alt texts for. */\n  locales: string[]\n}\n"],"names":[],"mappings":"AAiCA,2EAA2E,GAC3E,WAwBC"}

package/dist/utilities/getGenerationCost.d.ts

@@ -0,0 +1,12 @@
+import type OpenAI from 'openai';
+import type { AltTextPluginConfig } from '../types/AltTextPluginConfig.js';
+type GenerationCost = {
+    model: 'gpt-4.1-nano' | 'gpt-4.1-mini';
+    inputCost: number;
+    outputCost: number;
+    totalCost: number;
+    totalTokens: number;
+};
+/** Calculates the cost of a generation. */
+export declare function getGenerationCost(response: OpenAI.Chat.Completions.ChatCompletion, model: AltTextPluginConfig['model']): GenerationCost;
+export {};

package/dist/utilities/getGenerationCost.js

@@ -0,0 +1,30 @@
+/** Calculates the cost of a generation. */ export function getGenerationCost(response, model) {
+    const modelCosts = {
+        // see https://platform.openai.com/docs/models/gpt-4.1-nano
+        'gpt-4.1-nano': {
+            input: 0.1,
+            output: 0.4
+        },
+        // see https://platform.openai.com/docs/models/gpt-4.1-mini
+        'gpt-4.1-mini': {
+            input: 0.4,
+            output: 1.6
+        }
+    };
+    // Calculate cost based on token usage
+    const inputTokens = response.usage?.prompt_tokens || 0;
+    const outputTokens = response.usage?.completion_tokens || 0;
+    const totalTokens = response.usage?.total_tokens || 0;
+    const inputCost = inputTokens / 1_000_000 * modelCosts[model].input;
+    const outputCost = outputTokens / 1_000_000 * modelCosts[model].output;
+    const totalCost = inputCost + outputCost;
+    return {
+        model,
+        inputCost,
+        outputCost,
+        totalCost,
+        totalTokens
+    };
+}
+
+//# sourceMappingURL=getGenerationCost.js.map

package/dist/utilities/getGenerationCost.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/getGenerationCost.ts"],"sourcesContent":["import type OpenAI from 'openai'\nimport type { AltTextPluginConfig } from '../types/AltTextPluginConfig.js'\n\ntype GenerationCost = {\n  model: 'gpt-4.1-nano' | 'gpt-4.1-mini'\n  inputCost: number\n  outputCost: number\n  totalCost: number\n  totalTokens: number\n}\n\n/** Calculates the cost of a generation. */\nexport function getGenerationCost(\n  response: OpenAI.Chat.Completions.ChatCompletion,\n  model: AltTextPluginConfig['model'],\n): GenerationCost {\n  const modelCosts: Record<AltTextPluginConfig['model'], { input: number; output: number }> = {\n    // see https://platform.openai.com/docs/models/gpt-4.1-nano\n    'gpt-4.1-nano': {\n      input: 0.1,\n      output: 0.4,\n    },\n    // see https://platform.openai.com/docs/models/gpt-4.1-mini\n    'gpt-4.1-mini': {\n      input: 0.4,\n      output: 1.6,\n    },\n  }\n\n  // Calculate cost based on token usage\n  const inputTokens = response.usage?.prompt_tokens || 0\n  const outputTokens = response.usage?.completion_tokens || 0\n  const totalTokens = response.usage?.total_tokens || 0\n\n  const inputCost = (inputTokens / 1_000_000) * modelCosts[model].input\n  const outputCost = (outputTokens / 1_000_000) * modelCosts[model].output\n  const totalCost = inputCost + outputCost\n\n  return {\n    model,\n    inputCost,\n    outputCost,\n    totalCost,\n    totalTokens,\n  }\n}\n"],"names":["getGenerationCost","response","model","modelCosts","input","output","inputTokens","usage","prompt_tokens","outputTokens","completion_tokens","totalTokens","total_tokens","inputCost","outputCost","totalCost"],"mappings":"AAWA,yCAAyC,GACzC,OAAO,SAASA,kBACdC,QAAgD,EAChDC,KAAmC;IAEnC,MAAMC,aAAsF;QAC1F,2DAA2D;QAC3D,gBAAgB;YACdC,OAAO;YACPC,QAAQ;QACV;QACA,2DAA2D;QAC3D,gBAAgB;YACdD,OAAO;YACPC,QAAQ;QACV;IACF;IAEA,sCAAsC;IACtC,MAAMC,cAAcL,SAASM,KAAK,EAAEC,iBAAiB;IACrD,MAAMC,eAAeR,SAASM,KAAK,EAAEG,qBAAqB;IAC1D,MAAMC,cAAcV,SAASM,KAAK,EAAEK,gBAAgB;IAEpD,MAAMC,YAAY,AAACP,cAAc,YAAaH,UAAU,CAACD,MAAM,CAACE,KAAK;IACrE,MAAMU,aAAa,AAACL,eAAe,YAAaN,UAAU,CAACD,MAAM,CAACG,MAAM;IACxE,MAAMU,YAAYF,YAAYC;IAE9B,OAAO;QACLZ;QACAW;QACAC;QACAC;QACAJ;IACF;AACF"}

package/dist/utilities/zodResponseFormat.d.ts

@@ -0,0 +1,11 @@
+import { AutoParseableResponseFormat } from 'openai/lib/parser.mjs';
+import { ResponseFormatJSONSchema } from 'openai/resources/shared.mjs';
+import { z } from 'zod';
+/**
+ * Creates a chat completion `JSONSchema` response format object from
+ * the given Zod schema.
+ *
+ * This is a temporary drop in replacement for the zodResponseFormat from openai/helpers/zod.ts
+ * because of issue https://github.com/openai/openai-node/issues/1576
+ */
+export declare function zodResponseFormat<ZodInput extends z.ZodType>(zodObject: ZodInput, name: string, props?: Omit<ResponseFormatJSONSchema.JSONSchema, 'schema' | 'strict' | 'name'>): AutoParseableResponseFormat<z.infer<ZodInput>>;

package/dist/utilities/zodResponseFormat.js

@@ -0,0 +1,23 @@
+import { makeParseableResponseFormat } from 'openai/lib/parser.mjs';
+import { z } from 'zod';
+/**
+ * Creates a chat completion `JSONSchema` response format object from
+ * the given Zod schema.
+ *
+ * This is a temporary drop in replacement for the zodResponseFormat from openai/helpers/zod.ts
+ * because of issue https://github.com/openai/openai-node/issues/1576
+ */ export function zodResponseFormat(zodObject, name, props) {
+    return makeParseableResponseFormat({
+        type: 'json_schema',
+        json_schema: {
+            ...props,
+            name,
+            strict: true,
+            schema: z.toJSONSchema(zodObject, {
+                target: 'draft-7'
+            })
+        }
+    }, (content)=>zodObject.parse(JSON.parse(content)));
+}
+
+//# sourceMappingURL=zodResponseFormat.js.map

package/dist/utilities/zodResponseFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/zodResponseFormat.ts"],"sourcesContent":["import { AutoParseableResponseFormat, makeParseableResponseFormat } from 'openai/lib/parser.mjs'\nimport { ResponseFormatJSONSchema } from 'openai/resources/shared.mjs'\nimport { z } from 'zod'\n\n/**\n * Creates a chat completion `JSONSchema` response format object from\n * the given Zod schema.\n *\n * This is a temporary drop in replacement for the zodResponseFormat from openai/helpers/zod.ts\n * because of issue https://github.com/openai/openai-node/issues/1576\n */\nexport function zodResponseFormat<ZodInput extends z.ZodType>(\n  zodObject: ZodInput,\n  name: string,\n  props?: Omit<ResponseFormatJSONSchema.JSONSchema, 'schema' | 'strict' | 'name'>,\n): AutoParseableResponseFormat<z.infer<ZodInput>> {\n  return makeParseableResponseFormat(\n    {\n      type: 'json_schema',\n      json_schema: {\n        ...props,\n        name,\n        strict: true,\n        schema: z.toJSONSchema(zodObject, { target: 'draft-7' }),\n      },\n    },\n    (content) => zodObject.parse(JSON.parse(content)),\n  )\n}\n"],"names":["makeParseableResponseFormat","z","zodResponseFormat","zodObject","name","props","type","json_schema","strict","schema","toJSONSchema","target","content","parse","JSON"],"mappings":"AAAA,SAAsCA,2BAA2B,QAAQ,wBAAuB;AAEhG,SAASC,CAAC,QAAQ,MAAK;AAEvB;;;;;;CAMC,GACD,OAAO,SAASC,kBACdC,SAAmB,EACnBC,IAAY,EACZC,KAA+E;IAE/E,OAAOL,4BACL;QACEM,MAAM;QACNC,aAAa;YACX,GAAGF,KAAK;YACRD;YACAI,QAAQ;YACRC,QAAQR,EAAES,YAAY,CAACP,WAAW;gBAAEQ,QAAQ;YAAU;QACxD;IACF,GACA,CAACC,UAAYT,UAAUU,KAAK,CAACC,KAAKD,KAAK,CAACD;AAE5C"}

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@jhb.software/payload-alt-text-plugin",
+  "version": "0.1.0",
+  "description": "Payload CMS plugin that adds essential fields for hierarchical page structure to collections.",
+  "bugs": "https://github.com/jhb-software/payload-plugins/issues",
+  "repository": "https://github.com/jhb-software/payload-plugins",
+  "keywords": [
+    "payload",
+    "plugin",
+    "alt-text",
+    "accessibility",
+    "ai"
+  ],
+  "author": "JHB Software",
+  "license": "MIT",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "scripts": {
+    "build": "pnpm copyfiles && pnpm build:types && pnpm build:swc",
+    "build:swc": "swc ./src -d ./dist --config-file .swcrc --strip-leading-paths",
+    "build:types": "tsc --outDir dist --rootDir ./src",
+    "copyfiles": "copyfiles -u 1 \"src/**/*.{html,css,scss,ttf,woff,woff2,eot,svg,jpg,png,json}\" dist/",
+    "clean": "rimraf --glob {dist,*.tsbuildinfo}",
+    "dev": "tsc -w",
+    "format": "prettier --write src",
+    "lint": "eslint ./src",
+    "lint:fix": "eslint ./src --fix",
+    "prepublishOnly": "pnpm clean && pnpm build"
+  },
+  "dependencies": {
+    "openai": "^6.6.0",
+    "p-map": "^7.0.3",
+    "zod": "^4.1.12"
+  },
+  "peerDependencies": {
+    "@payloadcms/ui": "^3.60.0",
+    "next": "15.5.6",
+    "payload": "^3.60.0",
+    "react": "19.2.0",
+    "react-dom": "19.2.0"
+  },
+  "devDependencies": {
+    "@swc/cli": "^0.7.8",
+    "@swc/core": "^1.13.3",
+    "@types/react": "19.2.2",
+    "@types/react-dom": "19.2.2",
+    "copyfiles": "2.4.1",
+    "prettier": "^3.6.2",
+    "rimraf": "6.0.1",
+    "typescript": "5.9.3"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "registry": "https://registry.npmjs.org/",
+    "access": "public",
+    "exports": {
+      ".": {
+        "import": "./dist/index.js",
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "./client": {
+        "import": "./dist/exports/client.js",
+        "types": "./dist/exports/client.d.ts",
+        "default": "./dist/exports/client.js"
+      },
+      "./server": {
+        "import": "./dist/exports/server.js",
+        "types": "./dist/exports/server.d.ts",
+        "default": "./dist/exports/server.js"
+      }
+    }
+  },
+  "exports": {
+    ".": {
+      "import": "./src/index.ts",
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    },
+    "./client": {
+      "import": "./src/exports/client.ts",
+      "types": "./src/exports/client.ts",
+      "default": "./src/exports/client.ts"
+    },
+    "./server": {
+      "import": "./src/exports/server.ts",
+      "types": "./src/exports/server.ts",
+      "default": "./src/exports/server.ts"
+    }
+  },
+  "engines": {
+    "node": "^18.20.2 || >=20.9.0"
+  }
+}