@jhb.software/payload-alt-text-plugin 0.5.0 → 0.6.1

package/README.md

@@ -54,6 +54,8 @@ export default buildConfig({
 
 Note: When localization is disabled in your Payload config (default), you need to specify the locale to generate the alt texts in via the `locale` plugin option.
 
+To restrict which MIME types the plugin tracks, validates, and generates for — or to override the default validator on a per-collection basis — pass an object instead of a bare slug. See [Per-collection options](#per-collection-options).
+
 ### Admin list search
 
 By default, the plugin sets `admin.listSearchableFields` on the configured upload collections to `['filename', 'keywords', 'alt']` so the admin list-view search matches against these fields. To opt out, set `admin.listSearchableFields` on the collection yourself — any explicit value is preserved as-is:
@@ -75,16 +77,59 @@ This is also the recommended escape hatch if you hit Payload's Postgres SQL-buil
 
 ### Plugin Options
 
-| Option                       | Type               | Required | Description                                                                                                      |
-| ---------------------------- | ------------------ | -------- | ---------------------------------------------------------------------------------------------------------------- |
-| `collections`                | `CollectionSlug[]` | Yes      | Collections to enable alt text generation for                                                                    |
-| `resolver`                   | `AltTextResolver`  | Yes      | Alt text resolver to use (e.g., `openAIResolver`)                                                                |
-| `getImageThumbnail`          | `Function`         | Yes      | Function to get the thumbnail URL from an image document                                                         |
-| `enabled`                    | `boolean`          | No       | Whether to enable the plugin                                                                                     |
-| `locale`                     | `string`           | No       | Locale for alt text generation (required when localization is disabled)                                          |
-| `maxBulkGenerateConcurrency` | `number`           | No       | Maximum concurrent API requests for bulk operations (default: 16)                                                |
-| `fieldsOverride`             | `Function`         | No       | Override the default fields inserted by the plugin                                                               |
-| `healthCheck`                | `boolean`          | No       | Enable alt text health tracking: REST endpoint, cache revalidation hooks, and dashboard widget (default: `true`) |
+| Option                       | Type                                  | Required | Description                                                                                                      |
+| ---------------------------- | ------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------- |
+| `collections`                | `(CollectionSlug \| CollectionObj)[]` | Yes      | Collections to enable alt text generation for (see [Per-collection options](#per-collection-options))            |
+| `resolver`                   | `AltTextResolver`                     | Yes      | Alt text resolver to use (e.g., `openAIResolver`)                                                                |
+| `getImageThumbnail`          | `Function`                            | Yes      | Function to get the thumbnail URL from an image document                                                         |
+| `enabled`                    | `boolean`                             | No       | Whether to enable the plugin                                                                                     |
+| `locale`                     | `string`                              | No       | Locale for alt text generation (required when localization is disabled)                                          |
+| `maxBulkGenerateConcurrency` | `number`                              | No       | Maximum concurrent API requests for bulk operations (default: 16)                                                |
+| `fieldsOverride`             | `Function`                            | No       | Override the default fields inserted by the plugin                                                               |
+| `healthCheck`                | `boolean`                             | No       | Enable alt text health tracking: REST endpoint, cache revalidation hooks, and dashboard widget (default: `true`) |
+
+### Per-collection options
+
+Each entry in `collections` may be either a bare collection slug (shorthand, defaults to `['image/*']` for `mimeTypes`) or an object with the following fields:
+
+| Option      | Type                      | Required | Description                                                                                                                                                                                       |
+| ----------- | ------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `slug`      | `CollectionSlug`          | Yes      | The collection slug                                                                                                                                                                               |
+| `mimeTypes` | `string[]`                | No       | MIME types the plugin tracks, validates, and generates for. Supports wildcards like `image/*`. Defaults to `['image/*']`.                                                                         |
+| `validate`  | `TextareaFieldValidation` | No       | Custom validator that fully replaces the default required-alt check. Import `validateAltText` from the plugin to compose around the default behavior (see [Custom validator](#custom-validator)). |
+
+```ts
+payloadAltTextPlugin({
+  collections: [
+    'images', // shorthand — defaults to mimeTypes: ['image/*']
+    { slug: 'media', mimeTypes: ['image/*', 'application/pdf'] },
+  ],
+  // ...
+})
+```
+
+#### Custom validator
+
+The default validator requires alt text on every tracked document. Some workflows — folder moves, partial API updates, or localized setups with `fallback: false` where some locales are intentionally empty — need to skip that check when the request body does not touch `alt`. Pass a `validate` function to override the default, and compose around the exported `validateAltText` to keep the standard behavior for full updates:
+
+```ts
+import { payloadAltTextPlugin, validateAltText } from '@jhb.software/payload-alt-text-plugin'
+
+payloadAltTextPlugin({
+  collections: [
+    {
+      slug: 'media',
+      validate: (value, args) => {
+        // Skip the required-alt check when the request body does not touch `alt`
+        // (e.g. folder moves, partial API updates).
+        if (!args.req.data || !('alt' in args.req.data)) return true
+        return validateAltText(value, args)
+      },
+    },
+  ],
+  // ...
+})
+```
 
 ## Dashboard Widget
 

package/dist/components/AltTextHealthWidget.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { Pill } from '@payloadcms/ui/elements/Pill';
+import { formatAdminURL } from 'payload/shared';
 import { getAltTextHealthWidgetData } from '../utilities/altTextHealth.js';
 import { getAltTextHealthWidgetDisplayState } from '../utilities/altTextHealthWidgetDisplay.js';
 import { getCollectionLabel } from '../utilities/getCollectionLabel.js';
@@ -9,6 +10,7 @@ import { ImageIcon } from './icons/ImageIcon.js';
 export async function AltTextHealthWidget({ req }) {
     const t = req.t;
     const { collections, errors, isLocalized, localeCount, totalDocs } = await getAltTextHealthWidgetData(req);
+    const adminRoute = req.payload.config.routes.admin;
     return /*#__PURE__*/ _jsxs("div", {
         className: "card",
         style: {
@@ -102,7 +104,10 @@ export async function AltTextHealthWidget({ req }) {
                                 },
                                 children: [
                                     /*#__PURE__*/ _jsx("a", {
-                                        href: `${req.payload.config.routes.admin}/collections/${collection.collection}`,
+                                        href: formatAdminURL({
+                                            adminRoute,
+                                            path: `/collections/${collection.collection}`
+                                        }),
                                         style: {
                                             color: 'var(--theme-text)',
                                             fontSize: '14px',
@@ -151,7 +156,10 @@ export async function AltTextHealthWidget({ req }) {
                             displayState === 'unhealthy' && collection.invalidDocIds && collection.invalidDocIds.length > 0 ? /*#__PURE__*/ _jsx(Pill, {
                                 pillStyle: "error",
                                 size: "small",
-                                to: `${req.payload.config.routes.admin}/collections/${collection.collection}?where[id][in]=${collection.invalidDocIds.join(',')}`,
+                                to: `${formatAdminURL({
+                                    adminRoute,
+                                    path: `/collections/${collection.collection}`
+                                })}?where[id][in]=${collection.invalidDocIds.join(',')}`,
                                 children: /*#__PURE__*/ _jsxs("div", {
                                     style: {
                                         alignItems: 'center',

package/dist/components/AltTextHealthWidget.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/AltTextHealthWidget.tsx"],"sourcesContent":["import type { TFunction } from '@payloadcms/translations'\nimport type { WidgetServerProps } from 'payload'\n\nimport { Pill } from '@payloadcms/ui/elements/Pill'\n\nimport type { PluginAltTextTranslationKeys } from '../translations/index.js'\n\nimport { getAltTextHealthWidgetData } from '../utilities/altTextHealth.js'\nimport { getAltTextHealthWidgetDisplayState } from '../utilities/altTextHealthWidgetDisplay.js'\nimport { getCollectionLabel } from '../utilities/getCollectionLabel.js'\nimport { ArrowRightIcon } from './icons/ArrowRightIcon.js'\nimport { CheckIcon } from './icons/CheckIcon.js'\nimport { ImageIcon } from './icons/ImageIcon.js'\n\nexport async function AltTextHealthWidget({ req }: WidgetServerProps) {\n  const t = req.t as TFunction<PluginAltTextTranslationKeys>\n  const { collections, errors, isLocalized, localeCount, totalDocs } =\n    await getAltTextHealthWidgetData(req)\n\n  return (\n    <div\n      className=\"card\"\n      style={{\n        display: 'flex',\n        flexDirection: 'column',\n        gap: '16px',\n        height: '100%',\n      }}\n    >\n      <div style={{ display: 'flex', flexDirection: 'column', gap: '4px' }}>\n        <div style={{ alignItems: 'center', display: 'flex', gap: '0.5rem' }}>\n          <div style={{ color: 'var(--theme-elevation-500)' }}>\n            <ImageIcon />\n          </div>\n          <h3 style={{ margin: 0 }}>\n            {t('@jhb.software/payload-alt-text-plugin:altTextHealthWidget')}\n          </h3>\n        </div>\n        <p style={{ color: 'var(--theme-text)', fontSize: '14px', margin: 0, opacity: 0.75 }}>\n          {t('@jhb.software/payload-alt-text-plugin:altTextHealthDescription')}\n        </p>\n      </div>\n\n      {totalDocs === 0 && errors.length === 0 && (\n        <p style={{ color: 'var(--theme-text)', margin: 0, opacity: 0.75 }}>\n          {t('@jhb.software/payload-alt-text-plugin:noImagesFound')}\n        </p>\n      )}\n\n      {errors.length > 0 && (\n        <p style={{ color: '#92400e', fontSize: '13px', margin: 0 }}>\n          {t('@jhb.software/payload-alt-text-plugin:healthCheckPartialWarning')}\n        </p>\n      )}\n\n      <div style={{ display: 'flex', flexDirection: 'column', gap: '10px' }}>\n        {collections.map((collection) => {\n          const displayState = getAltTextHealthWidgetDisplayState(collection)\n\n          return (\n            <div\n              key={collection.collection}\n              style={{\n                alignItems: 'center',\n                background: 'var(--theme-elevation-50)',\n                border: '1px solid var(--theme-border-color)',\n                borderRadius: 'var(--style-radius-m)',\n                display: 'flex',\n                gap: '12px',\n                justifyContent: 'space-between',\n                padding: '12px 16px',\n              }}\n            >\n              <div style={{ display: 'flex', flexDirection: 'column', gap: '2px', minWidth: 0 }}>\n                <a\n                  href={`${req.payload.config.routes.admin}/collections/${collection.collection}`}\n                  style={{\n                    color: 'var(--theme-text)',\n                    fontSize: '14px',\n                    fontWeight: 500,\n                    textDecoration: 'none',\n                  }}\n                >\n                  {getCollectionLabel(\n                    collection.collection,\n                    req.payload.config.collections,\n                    req.locale,\n                  )}\n                </a>\n\n                {displayState === 'unavailable' ? (\n                  <span style={{ color: '#92400e', fontSize: '13px' }}>\n                    {t('@jhb.software/payload-alt-text-plugin:collectionCheckFailed')}\n                  </span>\n                ) : (\n                  <span style={{ fontSize: '13px', opacity: 0.7 }}>\n                    <span style={{ whiteSpace: 'nowrap' }}>\n                      {t('@jhb.software/payload-alt-text-plugin:totalImageCount', {\n                        count: collection.totalDocs,\n                      })}\n                    </span>\n                    {isLocalized && (\n                      <>\n                        {' · '}\n                        <span style={{ whiteSpace: 'nowrap' }}>\n                          {t('@jhb.software/payload-alt-text-plugin:localeCount', {\n                            count: localeCount,\n                          })}\n                        </span>\n                      </>\n                    )}\n                  </span>\n                )}\n              </div>\n\n              {displayState === 'unhealthy' &&\n              collection.invalidDocIds &&\n              collection.invalidDocIds.length > 0 ? (\n                <Pill\n                  pillStyle=\"error\"\n                  size=\"small\"\n                  to={`${req.payload.config.routes.admin}/collections/${collection.collection}?where[id][in]=${collection.invalidDocIds.join(',')}`}\n                >\n                  <div style={{ alignItems: 'center', display: 'flex', gap: '0.25rem' }}>\n                    {t('@jhb.software/payload-alt-text-plugin:statusUnhealthy', {\n                      count: collection.missingDocs + collection.partialDocs,\n                    })}\n                    <ArrowRightIcon height=\"12\" width=\"12\" />\n                  </div>\n                </Pill>\n              ) : displayState === 'healthy' ? (\n                <Pill pillStyle=\"success\" size=\"small\">\n                  <div style={{ alignItems: 'center', display: 'flex', gap: '0.25rem' }}>\n                    {t('@jhb.software/payload-alt-text-plugin:statusHealthy')}\n                    <CheckIcon height=\"12\" width=\"12\" />\n                  </div>\n                </Pill>\n              ) : displayState === 'unhealthy' ? (\n                <Pill pillStyle=\"error\" size=\"small\">\n                  {t('@jhb.software/payload-alt-text-plugin:statusUnhealthy', {\n                    count: collection.missingDocs + collection.partialDocs,\n                  })}\n                </Pill>\n              ) : (\n                <Pill pillStyle=\"warning\" size=\"small\">\n                  {t('@jhb.software/payload-alt-text-plugin:collectionCheckFailed')}\n                </Pill>\n              )}\n            </div>\n          )\n        })}\n      </div>\n    </div>\n  )\n}\n"],"names":["Pill","getAltTextHealthWidgetData","getAltTextHealthWidgetDisplayState","getCollectionLabel","ArrowRightIcon","CheckIcon","ImageIcon","AltTextHealthWidget","req","t","collections","errors","isLocalized","localeCount","totalDocs","div","className","style","display","flexDirection","gap","height","alignItems","color","h3","margin","p","fontSize","opacity","length","map","collection","displayState","background","border","borderRadius","justifyContent","padding","minWidth","a","href","payload","config","routes","admin","fontWeight","textDecoration","locale","span","whiteSpace","count","invalidDocIds","pillStyle","size","to","join","missingDocs","partialDocs","width"],"mappings":"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"}
+{"version":3,"sources":["../../src/components/AltTextHealthWidget.tsx"],"sourcesContent":["import type { TFunction } from '@payloadcms/translations'\nimport type { WidgetServerProps } from 'payload'\n\nimport { Pill } from '@payloadcms/ui/elements/Pill'\nimport { formatAdminURL } from 'payload/shared'\n\nimport type { PluginAltTextTranslationKeys } from '../translations/index.js'\n\nimport { getAltTextHealthWidgetData } from '../utilities/altTextHealth.js'\nimport { getAltTextHealthWidgetDisplayState } from '../utilities/altTextHealthWidgetDisplay.js'\nimport { getCollectionLabel } from '../utilities/getCollectionLabel.js'\nimport { ArrowRightIcon } from './icons/ArrowRightIcon.js'\nimport { CheckIcon } from './icons/CheckIcon.js'\nimport { ImageIcon } from './icons/ImageIcon.js'\n\nexport async function AltTextHealthWidget({ req }: WidgetServerProps) {\n  const t = req.t as TFunction<PluginAltTextTranslationKeys>\n  const { collections, errors, isLocalized, localeCount, totalDocs } =\n    await getAltTextHealthWidgetData(req)\n  const adminRoute = req.payload.config.routes.admin\n\n  return (\n    <div\n      className=\"card\"\n      style={{\n        display: 'flex',\n        flexDirection: 'column',\n        gap: '16px',\n        height: '100%',\n      }}\n    >\n      <div style={{ display: 'flex', flexDirection: 'column', gap: '4px' }}>\n        <div style={{ alignItems: 'center', display: 'flex', gap: '0.5rem' }}>\n          <div style={{ color: 'var(--theme-elevation-500)' }}>\n            <ImageIcon />\n          </div>\n          <h3 style={{ margin: 0 }}>\n            {t('@jhb.software/payload-alt-text-plugin:altTextHealthWidget')}\n          </h3>\n        </div>\n        <p style={{ color: 'var(--theme-text)', fontSize: '14px', margin: 0, opacity: 0.75 }}>\n          {t('@jhb.software/payload-alt-text-plugin:altTextHealthDescription')}\n        </p>\n      </div>\n\n      {totalDocs === 0 && errors.length === 0 && (\n        <p style={{ color: 'var(--theme-text)', margin: 0, opacity: 0.75 }}>\n          {t('@jhb.software/payload-alt-text-plugin:noImagesFound')}\n        </p>\n      )}\n\n      {errors.length > 0 && (\n        <p style={{ color: '#92400e', fontSize: '13px', margin: 0 }}>\n          {t('@jhb.software/payload-alt-text-plugin:healthCheckPartialWarning')}\n        </p>\n      )}\n\n      <div style={{ display: 'flex', flexDirection: 'column', gap: '10px' }}>\n        {collections.map((collection) => {\n          const displayState = getAltTextHealthWidgetDisplayState(collection)\n\n          return (\n            <div\n              key={collection.collection}\n              style={{\n                alignItems: 'center',\n                background: 'var(--theme-elevation-50)',\n                border: '1px solid var(--theme-border-color)',\n                borderRadius: 'var(--style-radius-m)',\n                display: 'flex',\n                gap: '12px',\n                justifyContent: 'space-between',\n                padding: '12px 16px',\n              }}\n            >\n              <div style={{ display: 'flex', flexDirection: 'column', gap: '2px', minWidth: 0 }}>\n                <a\n                  href={formatAdminURL({\n                    adminRoute,\n                    path: `/collections/${collection.collection}`,\n                  })}\n                  style={{\n                    color: 'var(--theme-text)',\n                    fontSize: '14px',\n                    fontWeight: 500,\n                    textDecoration: 'none',\n                  }}\n                >\n                  {getCollectionLabel(\n                    collection.collection,\n                    req.payload.config.collections,\n                    req.locale,\n                  )}\n                </a>\n\n                {displayState === 'unavailable' ? (\n                  <span style={{ color: '#92400e', fontSize: '13px' }}>\n                    {t('@jhb.software/payload-alt-text-plugin:collectionCheckFailed')}\n                  </span>\n                ) : (\n                  <span style={{ fontSize: '13px', opacity: 0.7 }}>\n                    <span style={{ whiteSpace: 'nowrap' }}>\n                      {t('@jhb.software/payload-alt-text-plugin:totalImageCount', {\n                        count: collection.totalDocs,\n                      })}\n                    </span>\n                    {isLocalized && (\n                      <>\n                        {' · '}\n                        <span style={{ whiteSpace: 'nowrap' }}>\n                          {t('@jhb.software/payload-alt-text-plugin:localeCount', {\n                            count: localeCount,\n                          })}\n                        </span>\n                      </>\n                    )}\n                  </span>\n                )}\n              </div>\n\n              {displayState === 'unhealthy' &&\n              collection.invalidDocIds &&\n              collection.invalidDocIds.length > 0 ? (\n                <Pill\n                  pillStyle=\"error\"\n                  size=\"small\"\n                  to={`${formatAdminURL({\n                    adminRoute,\n                    path: `/collections/${collection.collection}`,\n                  })}?where[id][in]=${collection.invalidDocIds.join(',')}`}\n                >\n                  <div style={{ alignItems: 'center', display: 'flex', gap: '0.25rem' }}>\n                    {t('@jhb.software/payload-alt-text-plugin:statusUnhealthy', {\n                      count: collection.missingDocs + collection.partialDocs,\n                    })}\n                    <ArrowRightIcon height=\"12\" width=\"12\" />\n                  </div>\n                </Pill>\n              ) : displayState === 'healthy' ? (\n                <Pill pillStyle=\"success\" size=\"small\">\n                  <div style={{ alignItems: 'center', display: 'flex', gap: '0.25rem' }}>\n                    {t('@jhb.software/payload-alt-text-plugin:statusHealthy')}\n                    <CheckIcon height=\"12\" width=\"12\" />\n                  </div>\n                </Pill>\n              ) : displayState === 'unhealthy' ? (\n                <Pill pillStyle=\"error\" size=\"small\">\n                  {t('@jhb.software/payload-alt-text-plugin:statusUnhealthy', {\n                    count: collection.missingDocs + collection.partialDocs,\n                  })}\n                </Pill>\n              ) : (\n                <Pill pillStyle=\"warning\" size=\"small\">\n                  {t('@jhb.software/payload-alt-text-plugin:collectionCheckFailed')}\n                </Pill>\n              )}\n            </div>\n          )\n        })}\n      </div>\n    </div>\n  )\n}\n"],"names":["Pill","formatAdminURL","getAltTextHealthWidgetData","getAltTextHealthWidgetDisplayState","getCollectionLabel","ArrowRightIcon","CheckIcon","ImageIcon","AltTextHealthWidget","req","t","collections","errors","isLocalized","localeCount","totalDocs","adminRoute","payload","config","routes","admin","div","className","style","display","flexDirection","gap","height","alignItems","color","h3","margin","p","fontSize","opacity","length","map","collection","displayState","background","border","borderRadius","justifyContent","padding","minWidth","a","href","path","fontWeight","textDecoration","locale","span","whiteSpace","count","invalidDocIds","pillStyle","size","to","join","missingDocs","partialDocs","width"],"mappings":"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"}

package/dist/components/BulkGenerateAltTextsButton.js

@@ -1,6 +1,6 @@
 'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
-import { Button, toast, useSelection, useTranslation } from '@payloadcms/ui';
+import { Button, toast, useConfig, useSelection, useTranslation } from '@payloadcms/ui';
 import { useRouter } from 'next/navigation.js';
 import { useTransition } from 'react';
 import { Lightning } from './icons/Lightning.js';
@@ -9,6 +9,7 @@ export function BulkGenerateAltTextsButton({ collectionSlug }) {
     const { t } = useTranslation();
     const [isPending, startTransition] = useTransition();
     const { selected, setSelection } = useSelection();
+    const { config: { routes: { api: apiRoute }, serverURL } } = useConfig();
     const selectedIds = Array.from(selected.entries()).filter(([, isSelected])=>isSelected).map(([id])=>id);
     const router = useRouter();
     const handleGenerateAltTexts = ()=>{
@@ -17,7 +18,7 @@ export function BulkGenerateAltTextsButton({ collectionSlug }) {
                 throw new Error('Collection slug is required');
             }
             try {
-                const response = await fetch('/api/alt-text-plugin/generate/bulk', {
+                const response = await fetch(`${serverURL ?? ''}${apiRoute}/alt-text-plugin/generate/bulk`, {
                     body: JSON.stringify({
                         collection: collectionSlug,
                         ids: selectedIds

package/dist/components/BulkGenerateAltTextsButton.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/BulkGenerateAltTextsButton.tsx"],"sourcesContent":["'use client'\n\nimport { Button, toast, useSelection, useTranslation } from '@payloadcms/ui'\nimport { useRouter } from 'next/navigation.js'\nimport { useTransition } from 'react'\n\nimport type {\n  PluginAltTextTranslationKeys,\n  PluginAltTextTranslations,\n} from '../translations/index.js'\n\nimport { Lightning } from './icons/Lightning.js'\nimport { Spinner } from './icons/Spinner.js'\n\nexport function BulkGenerateAltTextsButton({ collectionSlug }: { collectionSlug: string }) {\n  const { t } = useTranslation<PluginAltTextTranslations, PluginAltTextTranslationKeys>()\n  const [isPending, startTransition] = useTransition()\n  const { selected, setSelection } = useSelection()\n\n  const selectedIds = Array.from(selected.entries())\n    .filter(([, isSelected]) => isSelected)\n    .map(([id]) => id) as string[]\n\n  const router = useRouter()\n\n  const handleGenerateAltTexts = () => {\n    startTransition(async () => {\n      if (!collectionSlug) {\n        throw new Error('Collection slug is required')\n      }\n\n      try {\n        const response = await fetch('/api/alt-text-plugin/generate/bulk', {\n          body: JSON.stringify({\n            collection: collectionSlug,\n            ids: selectedIds,\n          }),\n          method: 'POST',\n        })\n\n        if (!response.ok) {\n          toast.error(t('@jhb.software/payload-alt-text-plugin:failedToGenerate'))\n          return\n        }\n\n        const data = (await response.json()) as {\n          erroredDocs: string[]\n          totalDocs: number\n          updatedDocs: number\n        }\n\n        if (data.erroredDocs.length > 0) {\n          toast.error(\n            t('@jhb.software/payload-alt-text-plugin:failedToGenerateForXImages', {\n              count: data.erroredDocs.length,\n            }),\n          )\n        }\n\n        // in case not all images were updated, show a warning instead of a success message:\n        if (data.updatedDocs === data.totalDocs) {\n          toast.success(\n            t('@jhb.software/payload-alt-text-plugin:xOfYImagesUpdated', {\n              total: data.totalDocs,\n              updated: data.updatedDocs,\n            }),\n          )\n        } else {\n          toast.warning(\n            t('@jhb.software/payload-alt-text-plugin:xOfYImagesUpdated', {\n              total: data.totalDocs,\n              updated: data.updatedDocs,\n            }),\n          )\n        }\n\n        // deselect all previously selected images\n        for (const id of selectedIds) {\n          setSelection(id)\n        }\n\n        router.refresh()\n      } catch (error) {\n        console.error('Error generating alt text:', error)\n        toast.error(t('@jhb.software/payload-alt-text-plugin:errorGeneratingAltText'))\n      }\n    })\n  }\n\n  return (\n    selectedIds.length > 0 && (\n      <div className=\"m-0\" style={{ display: 'flex', justifyContent: 'right' }}>\n        <Button\n          className=\"m-0\"\n          disabled={isPending || selectedIds.length === 0}\n          icon={isPending ? <Spinner /> : <Lightning />}\n          onClick={handleGenerateAltTexts}\n        >\n          {t('@jhb.software/payload-alt-text-plugin:generateAltTextFor', {\n            count: selectedIds.length,\n          })}\n        </Button>\n      </div>\n    )\n  )\n}\n"],"names":["Button","toast","useSelection","useTranslation","useRouter","useTransition","Lightning","Spinner","BulkGenerateAltTextsButton","collectionSlug","t","isPending","startTransition","selected","setSelection","selectedIds","Array","from","entries","filter","isSelected","map","id","router","handleGenerateAltTexts","Error","response","fetch","body","JSON","stringify","collection","ids","method","ok","error","data","json","erroredDocs","length","count","updatedDocs","totalDocs","success","total","updated","warning","refresh","console","div","className","style","display","justifyContent","disabled","icon","onClick"],"mappings":"AAAA;;AAEA,SAASA,MAAM,EAAEC,KAAK,EAAEC,YAAY,EAAEC,cAAc,QAAQ,iBAAgB;AAC5E,SAASC,SAAS,QAAQ,qBAAoB;AAC9C,SAASC,aAAa,QAAQ,QAAO;AAOrC,SAASC,SAAS,QAAQ,uBAAsB;AAChD,SAASC,OAAO,QAAQ,qBAAoB;AAE5C,OAAO,SAASC,2BAA2B,EAAEC,cAAc,EAA8B;IACvF,MAAM,EAAEC,CAAC,EAAE,GAAGP;IACd,MAAM,CAACQ,WAAWC,gBAAgB,GAAGP;IACrC,MAAM,EAAEQ,QAAQ,EAAEC,YAAY,EAAE,GAAGZ;IAEnC,MAAMa,cAAcC,MAAMC,IAAI,CAACJ,SAASK,OAAO,IAC5CC,MAAM,CAAC,CAAC,GAAGC,WAAW,GAAKA,YAC3BC,GAAG,CAAC,CAAC,CAACC,GAAG,GAAKA;IAEjB,MAAMC,SAASnB;IAEf,MAAMoB,yBAAyB;QAC7BZ,gBAAgB;YACd,IAAI,CAACH,gBAAgB;gBACnB,MAAM,IAAIgB,MAAM;YAClB;YAEA,IAAI;gBACF,MAAMC,WAAW,MAAMC,MAAM,sCAAsC;oBACjEC,MAAMC,KAAKC,SAAS,CAAC;wBACnBC,YAAYtB;wBACZuB,KAAKjB;oBACP;oBACAkB,QAAQ;gBACV;gBAEA,IAAI,CAACP,SAASQ,EAAE,EAAE;oBAChBjC,MAAMkC,KAAK,CAACzB,EAAE;oBACd;gBACF;gBAEA,MAAM0B,OAAQ,MAAMV,SAASW,IAAI;gBAMjC,IAAID,KAAKE,WAAW,CAACC,MAAM,GAAG,GAAG;oBAC/BtC,MAAMkC,KAAK,CACTzB,EAAE,oEAAoE;wBACpE8B,OAAOJ,KAAKE,WAAW,CAACC,MAAM;oBAChC;gBAEJ;gBAEA,oFAAoF;gBACpF,IAAIH,KAAKK,WAAW,KAAKL,KAAKM,SAAS,EAAE;oBACvCzC,MAAM0C,OAAO,CACXjC,EAAE,2DAA2D;wBAC3DkC,OAAOR,KAAKM,SAAS;wBACrBG,SAAST,KAAKK,WAAW;oBAC3B;gBAEJ,OAAO;oBACLxC,MAAM6C,OAAO,CACXpC,EAAE,2DAA2D;wBAC3DkC,OAAOR,KAAKM,SAAS;wBACrBG,SAAST,KAAKK,WAAW;oBAC3B;gBAEJ;gBAEA,0CAA0C;gBAC1C,KAAK,MAAMnB,MAAMP,YAAa;oBAC5BD,aAAaQ;gBACf;gBAEAC,OAAOwB,OAAO;YAChB,EAAE,OAAOZ,OAAO;gBACda,QAAQb,KAAK,CAAC,8BAA8BA;gBAC5ClC,MAAMkC,KAAK,CAACzB,EAAE;YAChB;QACF;IACF;IAEA,OACEK,YAAYwB,MAAM,GAAG,mBACnB,KAACU;QAAIC,WAAU;QAAMC,OAAO;YAAEC,SAAS;YAAQC,gBAAgB;QAAQ;kBACrE,cAAA,KAACrD;YACCkD,WAAU;YACVI,UAAU3C,aAAaI,YAAYwB,MAAM,KAAK;YAC9CgB,MAAM5C,0BAAY,KAACJ,6BAAa,KAACD;YACjCkD,SAAShC;sBAERd,EAAE,4DAA4D;gBAC7D8B,OAAOzB,YAAYwB,MAAM;YAC3B;;;AAKV"}
+{"version":3,"sources":["../../src/components/BulkGenerateAltTextsButton.tsx"],"sourcesContent":["'use client'\n\nimport { Button, toast, useConfig, useSelection, useTranslation } from '@payloadcms/ui'\nimport { useRouter } from 'next/navigation.js'\nimport { useTransition } from 'react'\n\nimport type {\n  PluginAltTextTranslationKeys,\n  PluginAltTextTranslations,\n} from '../translations/index.js'\n\nimport { Lightning } from './icons/Lightning.js'\nimport { Spinner } from './icons/Spinner.js'\n\nexport function BulkGenerateAltTextsButton({ collectionSlug }: { collectionSlug: string }) {\n  const { t } = useTranslation<PluginAltTextTranslations, PluginAltTextTranslationKeys>()\n  const [isPending, startTransition] = useTransition()\n  const { selected, setSelection } = useSelection()\n  const {\n    config: {\n      routes: { api: apiRoute },\n      serverURL,\n    },\n  } = useConfig()\n\n  const selectedIds = Array.from(selected.entries())\n    .filter(([, isSelected]) => isSelected)\n    .map(([id]) => id) as string[]\n\n  const router = useRouter()\n\n  const handleGenerateAltTexts = () => {\n    startTransition(async () => {\n      if (!collectionSlug) {\n        throw new Error('Collection slug is required')\n      }\n\n      try {\n        const response = await fetch(\n          `${serverURL ?? ''}${apiRoute}/alt-text-plugin/generate/bulk`,\n          {\n            body: JSON.stringify({\n              collection: collectionSlug,\n              ids: selectedIds,\n            }),\n            method: 'POST',\n          },\n        )\n\n        if (!response.ok) {\n          toast.error(t('@jhb.software/payload-alt-text-plugin:failedToGenerate'))\n          return\n        }\n\n        const data = (await response.json()) as {\n          erroredDocs: string[]\n          totalDocs: number\n          updatedDocs: number\n        }\n\n        if (data.erroredDocs.length > 0) {\n          toast.error(\n            t('@jhb.software/payload-alt-text-plugin:failedToGenerateForXImages', {\n              count: data.erroredDocs.length,\n            }),\n          )\n        }\n\n        // in case not all images were updated, show a warning instead of a success message:\n        if (data.updatedDocs === data.totalDocs) {\n          toast.success(\n            t('@jhb.software/payload-alt-text-plugin:xOfYImagesUpdated', {\n              total: data.totalDocs,\n              updated: data.updatedDocs,\n            }),\n          )\n        } else {\n          toast.warning(\n            t('@jhb.software/payload-alt-text-plugin:xOfYImagesUpdated', {\n              total: data.totalDocs,\n              updated: data.updatedDocs,\n            }),\n          )\n        }\n\n        // deselect all previously selected images\n        for (const id of selectedIds) {\n          setSelection(id)\n        }\n\n        router.refresh()\n      } catch (error) {\n        console.error('Error generating alt text:', error)\n        toast.error(t('@jhb.software/payload-alt-text-plugin:errorGeneratingAltText'))\n      }\n    })\n  }\n\n  return (\n    selectedIds.length > 0 && (\n      <div className=\"m-0\" style={{ display: 'flex', justifyContent: 'right' }}>\n        <Button\n          className=\"m-0\"\n          disabled={isPending || selectedIds.length === 0}\n          icon={isPending ? <Spinner /> : <Lightning />}\n          onClick={handleGenerateAltTexts}\n        >\n          {t('@jhb.software/payload-alt-text-plugin:generateAltTextFor', {\n            count: selectedIds.length,\n          })}\n        </Button>\n      </div>\n    )\n  )\n}\n"],"names":["Button","toast","useConfig","useSelection","useTranslation","useRouter","useTransition","Lightning","Spinner","BulkGenerateAltTextsButton","collectionSlug","t","isPending","startTransition","selected","setSelection","config","routes","api","apiRoute","serverURL","selectedIds","Array","from","entries","filter","isSelected","map","id","router","handleGenerateAltTexts","Error","response","fetch","body","JSON","stringify","collection","ids","method","ok","error","data","json","erroredDocs","length","count","updatedDocs","totalDocs","success","total","updated","warning","refresh","console","div","className","style","display","justifyContent","disabled","icon","onClick"],"mappings":"AAAA;;AAEA,SAASA,MAAM,EAAEC,KAAK,EAAEC,SAAS,EAAEC,YAAY,EAAEC,cAAc,QAAQ,iBAAgB;AACvF,SAASC,SAAS,QAAQ,qBAAoB;AAC9C,SAASC,aAAa,QAAQ,QAAO;AAOrC,SAASC,SAAS,QAAQ,uBAAsB;AAChD,SAASC,OAAO,QAAQ,qBAAoB;AAE5C,OAAO,SAASC,2BAA2B,EAAEC,cAAc,EAA8B;IACvF,MAAM,EAAEC,CAAC,EAAE,GAAGP;IACd,MAAM,CAACQ,WAAWC,gBAAgB,GAAGP;IACrC,MAAM,EAAEQ,QAAQ,EAAEC,YAAY,EAAE,GAAGZ;IACnC,MAAM,EACJa,QAAQ,EACNC,QAAQ,EAAEC,KAAKC,QAAQ,EAAE,EACzBC,SAAS,EACV,EACF,GAAGlB;IAEJ,MAAMmB,cAAcC,MAAMC,IAAI,CAACT,SAASU,OAAO,IAC5CC,MAAM,CAAC,CAAC,GAAGC,WAAW,GAAKA,YAC3BC,GAAG,CAAC,CAAC,CAACC,GAAG,GAAKA;IAEjB,MAAMC,SAASxB;IAEf,MAAMyB,yBAAyB;QAC7BjB,gBAAgB;YACd,IAAI,CAACH,gBAAgB;gBACnB,MAAM,IAAIqB,MAAM;YAClB;YAEA,IAAI;gBACF,MAAMC,WAAW,MAAMC,MACrB,GAAGb,aAAa,KAAKD,SAAS,8BAA8B,CAAC,EAC7D;oBACEe,MAAMC,KAAKC,SAAS,CAAC;wBACnBC,YAAY3B;wBACZ4B,KAAKjB;oBACP;oBACAkB,QAAQ;gBACV;gBAGF,IAAI,CAACP,SAASQ,EAAE,EAAE;oBAChBvC,MAAMwC,KAAK,CAAC9B,EAAE;oBACd;gBACF;gBAEA,MAAM+B,OAAQ,MAAMV,SAASW,IAAI;gBAMjC,IAAID,KAAKE,WAAW,CAACC,MAAM,GAAG,GAAG;oBAC/B5C,MAAMwC,KAAK,CACT9B,EAAE,oEAAoE;wBACpEmC,OAAOJ,KAAKE,WAAW,CAACC,MAAM;oBAChC;gBAEJ;gBAEA,oFAAoF;gBACpF,IAAIH,KAAKK,WAAW,KAAKL,KAAKM,SAAS,EAAE;oBACvC/C,MAAMgD,OAAO,CACXtC,EAAE,2DAA2D;wBAC3DuC,OAAOR,KAAKM,SAAS;wBACrBG,SAAST,KAAKK,WAAW;oBAC3B;gBAEJ,OAAO;oBACL9C,MAAMmD,OAAO,CACXzC,EAAE,2DAA2D;wBAC3DuC,OAAOR,KAAKM,SAAS;wBACrBG,SAAST,KAAKK,WAAW;oBAC3B;gBAEJ;gBAEA,0CAA0C;gBAC1C,KAAK,MAAMnB,MAAMP,YAAa;oBAC5BN,aAAaa;gBACf;gBAEAC,OAAOwB,OAAO;YAChB,EAAE,OAAOZ,OAAO;gBACda,QAAQb,KAAK,CAAC,8BAA8BA;gBAC5CxC,MAAMwC,KAAK,CAAC9B,EAAE;YAChB;QACF;IACF;IAEA,OACEU,YAAYwB,MAAM,GAAG,mBACnB,KAACU;QAAIC,WAAU;QAAMC,OAAO;YAAEC,SAAS;YAAQC,gBAAgB;QAAQ;kBACrE,cAAA,KAAC3D;YACCwD,WAAU;YACVI,UAAUhD,aAAaS,YAAYwB,MAAM,KAAK;YAC9CgB,MAAMjD,0BAAY,KAACJ,6BAAa,KAACD;YACjCuD,SAAShC;sBAERnB,EAAE,4DAA4D;gBAC7DmC,OAAOzB,YAAYwB,MAAM;YAC3B;;;AAKV"}

package/dist/components/GenerateAltTextButton.js

@@ -1,6 +1,6 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Button, toast, useDocumentInfo, useField, useLocale, useTranslation } from '@payloadcms/ui';
+import { Button, toast, useConfig, useDocumentInfo, useField, useLocale, useTranslation } from '@payloadcms/ui';
 import { useTransition } from 'react';
 import { Lightning } from './icons/Lightning.js';
 import { Spinner } from './icons/Spinner.js';
@@ -9,6 +9,7 @@ export function GenerateAltTextButton({ supportedMimeTypes }) {
     const { id, collectionSlug } = useDocumentInfo();
     const locale = useLocale();
     const [isPending, startTransition] = useTransition();
+    const { config: { routes: { api: apiRoute }, serverURL } } = useConfig();
     const { setValue: setKeywords } = useField({
         path: 'keywords'
     });
@@ -26,7 +27,7 @@ export function GenerateAltTextButton({ supportedMimeTypes }) {
         }
         startTransition(async ()=>{
             try {
-                const response = await fetch('/api/alt-text-plugin/generate', {
+                const response = await fetch(`${serverURL ?? ''}${apiRoute}/alt-text-plugin/generate`, {
                     body: JSON.stringify({
                         id: id,
                         collection: collectionSlug,

package/dist/components/GenerateAltTextButton.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/GenerateAltTextButton.tsx"],"sourcesContent":["'use client'\n\nimport { Button, toast, useDocumentInfo, useField, useLocale, useTranslation } from '@payloadcms/ui'\nimport { useTransition } from 'react'\n\nimport type {\n  PluginAltTextTranslationKeys,\n  PluginAltTextTranslations,\n} from '../translations/index.js'\n\nimport { Lightning } from './icons/Lightning.js'\nimport { Spinner } from './icons/Spinner.js'\n\nexport function GenerateAltTextButton({ supportedMimeTypes }: { supportedMimeTypes?: string[] }) {\n  const { t } = useTranslation<PluginAltTextTranslations, PluginAltTextTranslationKeys>()\n  const { id, collectionSlug } = useDocumentInfo()\n  const locale = useLocale()\n  const [isPending, startTransition] = useTransition()\n\n  const { setValue: setKeywords } = useField<string>({ path: 'keywords' })\n  const { setValue: setAltText } = useField<string>({ path: 'alt' })\n  const { value: mimeType } = useField<string>({ path: 'mimeType' })\n\n  const isUnsupportedMimeType =\n    !!mimeType && !!supportedMimeTypes && !supportedMimeTypes.includes(mimeType)\n\n  const handleGenerateAltText = () => {\n    if (!collectionSlug || !id) {\n      toast.error(t('@jhb.software/payload-alt-text-plugin:cannotGenerateMissingFields'))\n      throw new Error('Missing required fields')\n    }\n\n    startTransition(async () => {\n      try {\n        const response = await fetch('/api/alt-text-plugin/generate', {\n          body: JSON.stringify({\n            id: id as string,\n            collection: collectionSlug,\n            locale: locale?.code ?? null, // sent null when localization is disabled\n          }),\n          method: 'POST',\n        })\n\n        if (!response.ok) {\n          let errorMessage = t('@jhb.software/payload-alt-text-plugin:failedToGenerate')\n          try {\n            const errorData = (await response.json()) as { error: string }\n            errorMessage = errorData.error\n          } catch (error) {\n            console.error('Error generating alt text:', error)\n          }\n\n          toast.error(errorMessage)\n          return\n        }\n\n        const data = (await response.json()) as {\n          altText: string\n          keywords: string[]\n        }\n\n        if (data.altText && data.keywords) {\n          setAltText(data.altText)\n          setKeywords(data.keywords)\n          toast.success(t('@jhb.software/payload-alt-text-plugin:altTextGeneratedSuccess'))\n        } else {\n          toast.error(t('@jhb.software/payload-alt-text-plugin:noAltTextGenerated'))\n        }\n      } catch (error) {\n        console.error('Error generating alt text:', error)\n        toast.error(t('@jhb.software/payload-alt-text-plugin:errorGeneratingAltText'))\n      }\n    })\n  }\n\n  return (\n    <div style={{ display: 'flex', gap: '20px', marginTop: '10px' }}>\n      <div style={{ color: 'var(--theme-elevation-400)', flex: '1' }}>\n        <p>{t('@jhb.software/payload-alt-text-plugin:altTextDescription')}</p>\n        <ol style={{ margin: '10px 0', paddingLeft: '20px' }}>\n          <li>{t('@jhb.software/payload-alt-text-plugin:altTextRequirement1')}</li>\n          <li>{t('@jhb.software/payload-alt-text-plugin:altTextRequirement2')}</li>\n          <li>{t('@jhb.software/payload-alt-text-plugin:altTextRequirement3')}</li>\n        </ol>\n      </div>\n      <div style={{ alignItems: 'center', display: 'flex' }}>\n        <Button\n          disabled={isPending || !id || isUnsupportedMimeType}\n          icon={isPending ? <Spinner /> : <Lightning />}\n          onClick={handleGenerateAltText}\n          tooltip={\n            isUnsupportedMimeType\n              ? t('@jhb.software/payload-alt-text-plugin:unsupportedMimeType', { mimeType })\n              : !id\n                ? t('@jhb.software/payload-alt-text-plugin:pleaseSaveDocumentFirst')\n                : undefined\n          }\n        >\n          {t('@jhb.software/payload-alt-text-plugin:generateAltText')}\n        </Button>\n      </div>\n    </div>\n  )\n}\n"],"names":["Button","toast","useDocumentInfo","useField","useLocale","useTranslation","useTransition","Lightning","Spinner","GenerateAltTextButton","supportedMimeTypes","t","id","collectionSlug","locale","isPending","startTransition","setValue","setKeywords","path","setAltText","value","mimeType","isUnsupportedMimeType","includes","handleGenerateAltText","error","Error","response","fetch","body","JSON","stringify","collection","code","method","ok","errorMessage","errorData","json","console","data","altText","keywords","success","div","style","display","gap","marginTop","color","flex","p","ol","margin","paddingLeft","li","alignItems","disabled","icon","onClick","tooltip","undefined"],"mappings":"AAAA;;AAEA,SAASA,MAAM,EAAEC,KAAK,EAAEC,eAAe,EAAEC,QAAQ,EAAEC,SAAS,EAAEC,cAAc,QAAQ,iBAAgB;AACpG,SAASC,aAAa,QAAQ,QAAO;AAOrC,SAASC,SAAS,QAAQ,uBAAsB;AAChD,SAASC,OAAO,QAAQ,qBAAoB;AAE5C,OAAO,SAASC,sBAAsB,EAAEC,kBAAkB,EAAqC;IAC7F,MAAM,EAAEC,CAAC,EAAE,GAAGN;IACd,MAAM,EAAEO,EAAE,EAAEC,cAAc,EAAE,GAAGX;IAC/B,MAAMY,SAASV;IACf,MAAM,CAACW,WAAWC,gBAAgB,GAAGV;IAErC,MAAM,EAAEW,UAAUC,WAAW,EAAE,GAAGf,SAAiB;QAAEgB,MAAM;IAAW;IACtE,MAAM,EAAEF,UAAUG,UAAU,EAAE,GAAGjB,SAAiB;QAAEgB,MAAM;IAAM;IAChE,MAAM,EAAEE,OAAOC,QAAQ,EAAE,GAAGnB,SAAiB;QAAEgB,MAAM;IAAW;IAEhE,MAAMI,wBACJ,CAAC,CAACD,YAAY,CAAC,CAACZ,sBAAsB,CAACA,mBAAmBc,QAAQ,CAACF;IAErE,MAAMG,wBAAwB;QAC5B,IAAI,CAACZ,kBAAkB,CAACD,IAAI;YAC1BX,MAAMyB,KAAK,CAACf,EAAE;YACd,MAAM,IAAIgB,MAAM;QAClB;QAEAX,gBAAgB;YACd,IAAI;gBACF,MAAMY,WAAW,MAAMC,MAAM,iCAAiC;oBAC5DC,MAAMC,KAAKC,SAAS,CAAC;wBACnBpB,IAAIA;wBACJqB,YAAYpB;wBACZC,QAAQA,QAAQoB,QAAQ;oBAC1B;oBACAC,QAAQ;gBACV;gBAEA,IAAI,CAACP,SAASQ,EAAE,EAAE;oBAChB,IAAIC,eAAe1B,EAAE;oBACrB,IAAI;wBACF,MAAM2B,YAAa,MAAMV,SAASW,IAAI;wBACtCF,eAAeC,UAAUZ,KAAK;oBAChC,EAAE,OAAOA,OAAO;wBACdc,QAAQd,KAAK,CAAC,8BAA8BA;oBAC9C;oBAEAzB,MAAMyB,KAAK,CAACW;oBACZ;gBACF;gBAEA,MAAMI,OAAQ,MAAMb,SAASW,IAAI;gBAKjC,IAAIE,KAAKC,OAAO,IAAID,KAAKE,QAAQ,EAAE;oBACjCvB,WAAWqB,KAAKC,OAAO;oBACvBxB,YAAYuB,KAAKE,QAAQ;oBACzB1C,MAAM2C,OAAO,CAACjC,EAAE;gBAClB,OAAO;oBACLV,MAAMyB,KAAK,CAACf,EAAE;gBAChB;YACF,EAAE,OAAOe,OAAO;gBACdc,QAAQd,KAAK,CAAC,8BAA8BA;gBAC5CzB,MAAMyB,KAAK,CAACf,EAAE;YAChB;QACF;IACF;IAEA,qBACE,MAACkC;QAAIC,OAAO;YAAEC,SAAS;YAAQC,KAAK;YAAQC,WAAW;QAAO;;0BAC5D,MAACJ;gBAAIC,OAAO;oBAAEI,OAAO;oBAA8BC,MAAM;gBAAI;;kCAC3D,KAACC;kCAAGzC,EAAE;;kCACN,MAAC0C;wBAAGP,OAAO;4BAAEQ,QAAQ;4BAAUC,aAAa;wBAAO;;0CACjD,KAACC;0CAAI7C,EAAE;;0CACP,KAAC6C;0CAAI7C,EAAE;;0CACP,KAAC6C;0CAAI7C,EAAE;;;;;;0BAGX,KAACkC;gBAAIC,OAAO;oBAAEW,YAAY;oBAAUV,SAAS;gBAAO;0BAClD,cAAA,KAAC/C;oBACC0D,UAAU3C,aAAa,CAACH,MAAMW;oBAC9BoC,MAAM5C,0BAAY,KAACP,6BAAa,KAACD;oBACjCqD,SAASnC;oBACToC,SACEtC,wBACIZ,EAAE,6DAA6D;wBAAEW;oBAAS,KAC1E,CAACV,KACCD,EAAE,mEACFmD;8BAGPnD,EAAE;;;;;AAKb"}
+{"version":3,"sources":["../../src/components/GenerateAltTextButton.tsx"],"sourcesContent":["'use client'\n\nimport {\n  Button,\n  toast,\n  useConfig,\n  useDocumentInfo,\n  useField,\n  useLocale,\n  useTranslation,\n} from '@payloadcms/ui'\nimport { useTransition } from 'react'\n\nimport type {\n  PluginAltTextTranslationKeys,\n  PluginAltTextTranslations,\n} from '../translations/index.js'\n\nimport { Lightning } from './icons/Lightning.js'\nimport { Spinner } from './icons/Spinner.js'\n\nexport function GenerateAltTextButton({ supportedMimeTypes }: { supportedMimeTypes?: string[] }) {\n  const { t } = useTranslation<PluginAltTextTranslations, PluginAltTextTranslationKeys>()\n  const { id, collectionSlug } = useDocumentInfo()\n  const locale = useLocale()\n  const [isPending, startTransition] = useTransition()\n  const {\n    config: {\n      routes: { api: apiRoute },\n      serverURL,\n    },\n  } = useConfig()\n\n  const { setValue: setKeywords } = useField<string>({ path: 'keywords' })\n  const { setValue: setAltText } = useField<string>({ path: 'alt' })\n  const { value: mimeType } = useField<string>({ path: 'mimeType' })\n\n  const isUnsupportedMimeType =\n    !!mimeType && !!supportedMimeTypes && !supportedMimeTypes.includes(mimeType)\n\n  const handleGenerateAltText = () => {\n    if (!collectionSlug || !id) {\n      toast.error(t('@jhb.software/payload-alt-text-plugin:cannotGenerateMissingFields'))\n      throw new Error('Missing required fields')\n    }\n\n    startTransition(async () => {\n      try {\n        const response = await fetch(`${serverURL ?? ''}${apiRoute}/alt-text-plugin/generate`, {\n          body: JSON.stringify({\n            id: id as string,\n            collection: collectionSlug,\n            locale: locale?.code ?? null, // sent null when localization is disabled\n          }),\n          method: 'POST',\n        })\n\n        if (!response.ok) {\n          let errorMessage = t('@jhb.software/payload-alt-text-plugin:failedToGenerate')\n          try {\n            const errorData = (await response.json()) as { error: string }\n            errorMessage = errorData.error\n          } catch (error) {\n            console.error('Error generating alt text:', error)\n          }\n\n          toast.error(errorMessage)\n          return\n        }\n\n        const data = (await response.json()) as {\n          altText: string\n          keywords: string[]\n        }\n\n        if (data.altText && data.keywords) {\n          setAltText(data.altText)\n          setKeywords(data.keywords)\n          toast.success(t('@jhb.software/payload-alt-text-plugin:altTextGeneratedSuccess'))\n        } else {\n          toast.error(t('@jhb.software/payload-alt-text-plugin:noAltTextGenerated'))\n        }\n      } catch (error) {\n        console.error('Error generating alt text:', error)\n        toast.error(t('@jhb.software/payload-alt-text-plugin:errorGeneratingAltText'))\n      }\n    })\n  }\n\n  return (\n    <div style={{ display: 'flex', gap: '20px', marginTop: '10px' }}>\n      <div style={{ color: 'var(--theme-elevation-400)', flex: '1' }}>\n        <p>{t('@jhb.software/payload-alt-text-plugin:altTextDescription')}</p>\n        <ol style={{ margin: '10px 0', paddingLeft: '20px' }}>\n          <li>{t('@jhb.software/payload-alt-text-plugin:altTextRequirement1')}</li>\n          <li>{t('@jhb.software/payload-alt-text-plugin:altTextRequirement2')}</li>\n          <li>{t('@jhb.software/payload-alt-text-plugin:altTextRequirement3')}</li>\n        </ol>\n      </div>\n      <div style={{ alignItems: 'center', display: 'flex' }}>\n        <Button\n          disabled={isPending || !id || isUnsupportedMimeType}\n          icon={isPending ? <Spinner /> : <Lightning />}\n          onClick={handleGenerateAltText}\n          tooltip={\n            isUnsupportedMimeType\n              ? t('@jhb.software/payload-alt-text-plugin:unsupportedMimeType', { mimeType })\n              : !id\n                ? t('@jhb.software/payload-alt-text-plugin:pleaseSaveDocumentFirst')\n                : undefined\n          }\n        >\n          {t('@jhb.software/payload-alt-text-plugin:generateAltText')}\n        </Button>\n      </div>\n    </div>\n  )\n}\n"],"names":["Button","toast","useConfig","useDocumentInfo","useField","useLocale","useTranslation","useTransition","Lightning","Spinner","GenerateAltTextButton","supportedMimeTypes","t","id","collectionSlug","locale","isPending","startTransition","config","routes","api","apiRoute","serverURL","setValue","setKeywords","path","setAltText","value","mimeType","isUnsupportedMimeType","includes","handleGenerateAltText","error","Error","response","fetch","body","JSON","stringify","collection","code","method","ok","errorMessage","errorData","json","console","data","altText","keywords","success","div","style","display","gap","marginTop","color","flex","p","ol","margin","paddingLeft","li","alignItems","disabled","icon","onClick","tooltip","undefined"],"mappings":"AAAA;;AAEA,SACEA,MAAM,EACNC,KAAK,EACLC,SAAS,EACTC,eAAe,EACfC,QAAQ,EACRC,SAAS,EACTC,cAAc,QACT,iBAAgB;AACvB,SAASC,aAAa,QAAQ,QAAO;AAOrC,SAASC,SAAS,QAAQ,uBAAsB;AAChD,SAASC,OAAO,QAAQ,qBAAoB;AAE5C,OAAO,SAASC,sBAAsB,EAAEC,kBAAkB,EAAqC;IAC7F,MAAM,EAAEC,CAAC,EAAE,GAAGN;IACd,MAAM,EAAEO,EAAE,EAAEC,cAAc,EAAE,GAAGX;IAC/B,MAAMY,SAASV;IACf,MAAM,CAACW,WAAWC,gBAAgB,GAAGV;IACrC,MAAM,EACJW,QAAQ,EACNC,QAAQ,EAAEC,KAAKC,QAAQ,EAAE,EACzBC,SAAS,EACV,EACF,GAAGpB;IAEJ,MAAM,EAAEqB,UAAUC,WAAW,EAAE,GAAGpB,SAAiB;QAAEqB,MAAM;IAAW;IACtE,MAAM,EAAEF,UAAUG,UAAU,EAAE,GAAGtB,SAAiB;QAAEqB,MAAM;IAAM;IAChE,MAAM,EAAEE,OAAOC,QAAQ,EAAE,GAAGxB,SAAiB;QAAEqB,MAAM;IAAW;IAEhE,MAAMI,wBACJ,CAAC,CAACD,YAAY,CAAC,CAACjB,sBAAsB,CAACA,mBAAmBmB,QAAQ,CAACF;IAErE,MAAMG,wBAAwB;QAC5B,IAAI,CAACjB,kBAAkB,CAACD,IAAI;YAC1BZ,MAAM+B,KAAK,CAACpB,EAAE;YACd,MAAM,IAAIqB,MAAM;QAClB;QAEAhB,gBAAgB;YACd,IAAI;gBACF,MAAMiB,WAAW,MAAMC,MAAM,GAAGb,aAAa,KAAKD,SAAS,yBAAyB,CAAC,EAAE;oBACrFe,MAAMC,KAAKC,SAAS,CAAC;wBACnBzB,IAAIA;wBACJ0B,YAAYzB;wBACZC,QAAQA,QAAQyB,QAAQ;oBAC1B;oBACAC,QAAQ;gBACV;gBAEA,IAAI,CAACP,SAASQ,EAAE,EAAE;oBAChB,IAAIC,eAAe/B,EAAE;oBACrB,IAAI;wBACF,MAAMgC,YAAa,MAAMV,SAASW,IAAI;wBACtCF,eAAeC,UAAUZ,KAAK;oBAChC,EAAE,OAAOA,OAAO;wBACdc,QAAQd,KAAK,CAAC,8BAA8BA;oBAC9C;oBAEA/B,MAAM+B,KAAK,CAACW;oBACZ;gBACF;gBAEA,MAAMI,OAAQ,MAAMb,SAASW,IAAI;gBAKjC,IAAIE,KAAKC,OAAO,IAAID,KAAKE,QAAQ,EAAE;oBACjCvB,WAAWqB,KAAKC,OAAO;oBACvBxB,YAAYuB,KAAKE,QAAQ;oBACzBhD,MAAMiD,OAAO,CAACtC,EAAE;gBAClB,OAAO;oBACLX,MAAM+B,KAAK,CAACpB,EAAE;gBAChB;YACF,EAAE,OAAOoB,OAAO;gBACdc,QAAQd,KAAK,CAAC,8BAA8BA;gBAC5C/B,MAAM+B,KAAK,CAACpB,EAAE;YAChB;QACF;IACF;IAEA,qBACE,MAACuC;QAAIC,OAAO;YAAEC,SAAS;YAAQC,KAAK;YAAQC,WAAW;QAAO;;0BAC5D,MAACJ;gBAAIC,OAAO;oBAAEI,OAAO;oBAA8BC,MAAM;gBAAI;;kCAC3D,KAACC;kCAAG9C,EAAE;;kCACN,MAAC+C;wBAAGP,OAAO;4BAAEQ,QAAQ;4BAAUC,aAAa;wBAAO;;0CACjD,KAACC;0CAAIlD,EAAE;;0CACP,KAACkD;0CAAIlD,EAAE;;0CACP,KAACkD;0CAAIlD,EAAE;;;;;;0BAGX,KAACuC;gBAAIC,OAAO;oBAAEW,YAAY;oBAAUV,SAAS;gBAAO;0BAClD,cAAA,KAACrD;oBACCgE,UAAUhD,aAAa,CAACH,MAAMgB;oBAC9BoC,MAAMjD,0BAAY,KAACP,6BAAa,KAACD;oBACjC0D,SAASnC;oBACToC,SACEtC,wBACIjB,EAAE,6DAA6D;wBAAEgB;oBAAS,KAC1E,CAACf,KACCD,EAAE,mEACFwD;8BAGPxD,EAAE;;;;;AAKb"}

package/dist/endpoints/bulkGenerateAltTexts.js

@@ -1,7 +1,8 @@
 import pMap from 'p-map';
-import { z, ZodError } from 'zod';
+import { ZodError } from 'zod';
 import { localesFromConfig } from '../utilities/localesFromConfig.js';
 import { matchesMimeType } from '../utilities/mimeTypes.js';
+import { bulkGenerateAltTextsRequestSchema, formatZodError } from './schemas.js';
 /**
  * Generates and updates alt text for multiple images in all locales.
  */ export const bulkGenerateAltTextsEndpoint = (access)=>async (req)=>{
@@ -16,14 +17,7 @@ import { matchesMimeType } from '../utilities/mimeTypes.js';
                 });
             }
             const data = 'json' in req && typeof req.json === 'function' ? await req.json() : null;
-            const schema = z.object({
-                collection: z.string(),
-                ids: z.array(z.union([
-                    z.string(),
-                    z.number()
-                ]))
-            });
-            const { collection, ids } = schema.parse(data);
+            const { collection, ids } = bulkGenerateAltTextsRequestSchema.parse(data);
             let updatedDocs = 0;
             const erroredDocs = [];
             // Get plugin config from payload config
@@ -84,13 +78,7 @@ import { matchesMimeType } from '../utilities/mimeTypes.js';
             });
         } catch (error) {
             if (error instanceof ZodError) {
-                return Response.json({
-                    details: error.issues.map((e)=>({
-                            message: e.message,
-                            path: e.path.join('.')
-                        })),
-                    error: 'Validation failed'
-                }, {
+                return Response.json(formatZodError(error), {
                     status: 400
                 });
             }

package/dist/endpoints/bulkGenerateAltTexts.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/endpoints/bulkGenerateAltTexts.ts"],"sourcesContent":["import type { BasePayload, CollectionSlug, PayloadHandler, PayloadRequest } from 'payload'\n\nimport pMap from 'p-map'\nimport { z, ZodError } from 'zod'\n\nimport type { AltTextPluginConfig } from '../types/AltTextPluginConfig.js'\n\nimport { localesFromConfig } from '../utilities/localesFromConfig.js'\nimport { matchesMimeType } from '../utilities/mimeTypes.js'\n\n/**\n * Generates and updates alt text for multiple images in all locales.\n */\nexport const bulkGenerateAltTextsEndpoint =\n  (access: AltTextPluginConfig['access']): PayloadHandler =>\n  async (req: PayloadRequest) => {\n    try {\n      if (!(await access({ req }))) {\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 schema = z.object({\n        collection: z.string(),\n        ids: z.array(z.union([z.string(), z.number()])),\n      })\n\n      const { collection, ids } = schema.parse(data)\n\n      let updatedDocs = 0\n      const erroredDocs: (number | string)[] = []\n\n      // Get plugin config from payload config\n      const pluginConfig = req.payload.config.custom?.altTextPluginConfig as\n        | AltTextPluginConfig\n        | undefined\n\n      if (!pluginConfig) {\n        return Response.json({ error: 'Plugin config not found' }, { status: 500 })\n      }\n\n      if (!pluginConfig.resolver) {\n        return Response.json({ error: 'No alt text resolver configured' }, { status: 500 })\n      }\n\n      const concurrency = pluginConfig.maxBulkGenerateConcurrency\n\n      // determine target locales based on config\n      const locales = localesFromConfig(req.payload.config)\n      const targetLocales = locales ?? [pluginConfig.locale!]\n      if (!targetLocales) {\n        return Response.json(\n          {\n            error:\n              'Could not determine target locales for alt text generation. Please check your plugin configuration.',\n          },\n          { status: 500 },\n        )\n      }\n\n      await pMap(\n        ids,\n        async (id) => {\n          try {\n            await generateAndUpdateAltText({\n              id,\n              collection,\n              locales: targetLocales,\n              payload: req.payload,\n              pluginConfig,\n              req,\n            })\n            updatedDocs++\n            console.log(\n              `${updatedDocs}/${ids.length} updated (${Math.round((updatedDocs / ids.length) * 100)}%)`,\n            )\n          } catch (error) {\n            console.error(`Error generating alt text for ${id}:`, error)\n            erroredDocs.push(id)\n          }\n        },\n        { concurrency },\n      )\n\n      if (erroredDocs.length > 0) {\n        console.error(`Failed for: ${erroredDocs.join(', ')}`)\n      }\n\n      return Response.json({\n        erroredDocs,\n        totalDocs: ids.length,\n        updatedDocs,\n      })\n    } catch (error) {\n      if (error instanceof ZodError) {\n        return Response.json(\n          {\n            details: error.issues.map((e) => ({\n              message: e.message,\n              path: e.path.join('.'),\n            })),\n            error: 'Validation failed',\n          },\n          { status: 400 },\n        )\n      }\n      console.error('Error in bulk generation:', 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\nasync function generateAndUpdateAltText({\n  id,\n  collection,\n  locales,\n  payload,\n  pluginConfig,\n  req,\n}: {\n  collection: CollectionSlug\n  id: number | string\n  locales: string[]\n  payload: BasePayload\n  pluginConfig: AltTextPluginConfig\n  req: PayloadRequest\n}) {\n  const imageDoc = await payload.findByID({\n    id,\n    collection,\n    depth: 0,\n  })\n\n  if (!imageDoc) {\n    throw new Error('Image not found')\n  }\n\n  const mimeType =\n    'mimeType' in imageDoc && typeof imageDoc.mimeType === 'string' ? imageDoc.mimeType : undefined\n\n  const collectionConfig = pluginConfig.collections.find((entry) => entry.slug === collection)\n\n  if (mimeType && collectionConfig && !matchesMimeType(mimeType, collectionConfig.mimeTypes)) {\n    throw new Error(\n      `Alt text is not tracked for files of type \"${mimeType}\" in the \"${collection}\" collection. Tracked types: ${collectionConfig.mimeTypes.join(', ')}.`,\n    )\n  }\n\n  if (\n    mimeType &&\n    pluginConfig.resolver.supportedMimeTypes &&\n    !pluginConfig.resolver.supportedMimeTypes.includes(mimeType)\n  ) {\n    throw new Error(\n      `Alt text generation is not supported for files of type \"${mimeType}\". Supported types: ${pluginConfig.resolver.supportedMimeTypes.join(', ')}.`,\n    )\n  }\n\n  const imageThumbnailUrl = pluginConfig.getImageThumbnail(imageDoc)\n\n  const result = await pluginConfig.resolver.resolveBulk({\n    filename:\n      'filename' in imageDoc && typeof imageDoc.filename === 'string'\n        ? imageDoc.filename\n        : undefined,\n    imageThumbnailUrl,\n    locales,\n    req,\n  })\n\n  if (!result.success) {\n    throw new Error(result.error || 'Failed to generate alt text')\n  }\n\n  for (const locale of locales) {\n    const localeResult = result.results[locale]\n    if (localeResult) {\n      await payload.update({\n        id,\n        collection,\n        data: {\n          alt: localeResult.altText,\n          keywords: localeResult.keywords,\n        },\n        locale,\n      })\n    }\n  }\n}\n"],"names":["pMap","z","ZodError","localesFromConfig","matchesMimeType","bulkGenerateAltTextsEndpoint","access","req","Response","json","error","status","data","schema","object","collection","string","ids","array","union","number","parse","updatedDocs","erroredDocs","pluginConfig","payload","config","custom","altTextPluginConfig","resolver","concurrency","maxBulkGenerateConcurrency","locales","targetLocales","locale","id","generateAndUpdateAltText","console","log","length","Math","round","push","join","totalDocs","details","issues","map","e","message","path","Error","imageDoc","findByID","depth","mimeType","undefined","collectionConfig","collections","find","entry","slug","mimeTypes","supportedMimeTypes","includes","imageThumbnailUrl","getImageThumbnail","result","resolveBulk","filename","success","localeResult","results","update","alt","altText","keywords"],"mappings":"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"}
+{"version":3,"sources":["../../src/endpoints/bulkGenerateAltTexts.ts"],"sourcesContent":["import type { BasePayload, CollectionSlug, PayloadHandler, PayloadRequest } from 'payload'\n\nimport pMap from 'p-map'\nimport { ZodError } from 'zod'\n\nimport type { AltTextPluginConfig } from '../types/AltTextPluginConfig.js'\n\nimport { localesFromConfig } from '../utilities/localesFromConfig.js'\nimport { matchesMimeType } from '../utilities/mimeTypes.js'\nimport { bulkGenerateAltTextsRequestSchema, formatZodError } from './schemas.js'\n\n/**\n * Generates and updates alt text for multiple images in all locales.\n */\nexport const bulkGenerateAltTextsEndpoint =\n  (access: AltTextPluginConfig['access']): PayloadHandler =>\n  async (req: PayloadRequest) => {\n    try {\n      if (!(await access({ req }))) {\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 { collection, ids } = bulkGenerateAltTextsRequestSchema.parse(data)\n\n      let updatedDocs = 0\n      const erroredDocs: (number | string)[] = []\n\n      // Get plugin config from payload config\n      const pluginConfig = req.payload.config.custom?.altTextPluginConfig as\n        | AltTextPluginConfig\n        | undefined\n\n      if (!pluginConfig) {\n        return Response.json({ error: 'Plugin config not found' }, { status: 500 })\n      }\n\n      if (!pluginConfig.resolver) {\n        return Response.json({ error: 'No alt text resolver configured' }, { status: 500 })\n      }\n\n      const concurrency = pluginConfig.maxBulkGenerateConcurrency\n\n      // determine target locales based on config\n      const locales = localesFromConfig(req.payload.config)\n      const targetLocales = locales ?? [pluginConfig.locale!]\n      if (!targetLocales) {\n        return Response.json(\n          {\n            error:\n              'Could not determine target locales for alt text generation. Please check your plugin configuration.',\n          },\n          { status: 500 },\n        )\n      }\n\n      await pMap(\n        ids,\n        async (id) => {\n          try {\n            await generateAndUpdateAltText({\n              id,\n              collection,\n              locales: targetLocales,\n              payload: req.payload,\n              pluginConfig,\n              req,\n            })\n            updatedDocs++\n            console.log(\n              `${updatedDocs}/${ids.length} updated (${Math.round((updatedDocs / ids.length) * 100)}%)`,\n            )\n          } catch (error) {\n            console.error(`Error generating alt text for ${id}:`, error)\n            erroredDocs.push(id)\n          }\n        },\n        { concurrency },\n      )\n\n      if (erroredDocs.length > 0) {\n        console.error(`Failed for: ${erroredDocs.join(', ')}`)\n      }\n\n      return Response.json({\n        erroredDocs,\n        totalDocs: ids.length,\n        updatedDocs,\n      })\n    } catch (error) {\n      if (error instanceof ZodError) {\n        return Response.json(formatZodError(error), { status: 400 })\n      }\n      console.error('Error in bulk generation:', 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\nasync function generateAndUpdateAltText({\n  id,\n  collection,\n  locales,\n  payload,\n  pluginConfig,\n  req,\n}: {\n  collection: CollectionSlug\n  id: number | string\n  locales: string[]\n  payload: BasePayload\n  pluginConfig: AltTextPluginConfig\n  req: PayloadRequest\n}) {\n  const imageDoc = await payload.findByID({\n    id,\n    collection,\n    depth: 0,\n  })\n\n  if (!imageDoc) {\n    throw new Error('Image not found')\n  }\n\n  const mimeType =\n    'mimeType' in imageDoc && typeof imageDoc.mimeType === 'string' ? imageDoc.mimeType : undefined\n\n  const collectionConfig = pluginConfig.collections.find((entry) => entry.slug === collection)\n\n  if (mimeType && collectionConfig && !matchesMimeType(mimeType, collectionConfig.mimeTypes)) {\n    throw new Error(\n      `Alt text is not tracked for files of type \"${mimeType}\" in the \"${collection}\" collection. Tracked types: ${collectionConfig.mimeTypes.join(', ')}.`,\n    )\n  }\n\n  if (\n    mimeType &&\n    pluginConfig.resolver.supportedMimeTypes &&\n    !pluginConfig.resolver.supportedMimeTypes.includes(mimeType)\n  ) {\n    throw new Error(\n      `Alt text generation is not supported for files of type \"${mimeType}\". Supported types: ${pluginConfig.resolver.supportedMimeTypes.join(', ')}.`,\n    )\n  }\n\n  const imageThumbnailUrl = pluginConfig.getImageThumbnail(imageDoc)\n\n  const result = await pluginConfig.resolver.resolveBulk({\n    filename:\n      'filename' in imageDoc && typeof imageDoc.filename === 'string'\n        ? imageDoc.filename\n        : undefined,\n    imageThumbnailUrl,\n    locales,\n    req,\n  })\n\n  if (!result.success) {\n    throw new Error(result.error || 'Failed to generate alt text')\n  }\n\n  for (const locale of locales) {\n    const localeResult = result.results[locale]\n    if (localeResult) {\n      await payload.update({\n        id,\n        collection,\n        data: {\n          alt: localeResult.altText,\n          keywords: localeResult.keywords,\n        },\n        locale,\n      })\n    }\n  }\n}\n"],"names":["pMap","ZodError","localesFromConfig","matchesMimeType","bulkGenerateAltTextsRequestSchema","formatZodError","bulkGenerateAltTextsEndpoint","access","req","Response","json","error","status","data","collection","ids","parse","updatedDocs","erroredDocs","pluginConfig","payload","config","custom","altTextPluginConfig","resolver","concurrency","maxBulkGenerateConcurrency","locales","targetLocales","locale","id","generateAndUpdateAltText","console","log","length","Math","round","push","join","totalDocs","Error","message","imageDoc","findByID","depth","mimeType","undefined","collectionConfig","collections","find","entry","slug","mimeTypes","supportedMimeTypes","includes","imageThumbnailUrl","getImageThumbnail","result","resolveBulk","filename","success","localeResult","results","update","alt","altText","keywords"],"mappings":"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"}

package/dist/endpoints/generateAltText.js

@@ -1,5 +1,6 @@
-import { z, ZodError } from 'zod';
+import { ZodError } from 'zod';
 import { matchesMimeType } from '../utilities/mimeTypes.js';
+import { formatZodError, generateAltTextRequestSchema } from './schemas.js';
 /**
  * Generates alt text for a single image using the configured resolver.
  *
@@ -20,16 +21,7 @@ import { matchesMimeType } from '../utilities/mimeTypes.js';
                 });
             }
             const data = 'json' in req && typeof req.json === 'function' ? await req.json() : null;
-            const requestSchema = z.object({
-                id: z.union([
-                    z.string(),
-                    z.number()
-                ]),
-                collection: z.string(),
-                locale: z.string().nullable(),
-                update: z.boolean().optional().default(false)
-            });
-            const { id, collection, locale, update } = requestSchema.parse(data);
+            const { id, collection, locale, update } = generateAltTextRequestSchema.parse(data);
             const imageDoc = await req.payload.findByID({
                 id,
                 collection,
@@ -121,13 +113,7 @@ import { matchesMimeType } from '../utilities/mimeTypes.js';
             });
         } catch (error) {
             if (error instanceof ZodError) {
-                return Response.json({
-                    details: error.issues.map((e)=>({
-                            message: e.message,
-                            path: e.path.join('.')
-                        })),
-                    error: 'Validation failed'
-                }, {
+                return Response.json(formatZodError(error), {
                     status: 400
                 });
             }

package/dist/endpoints/generateAltText.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/endpoints/generateAltText.ts"],"sourcesContent":["import type { PayloadHandler, PayloadRequest } from 'payload'\n\nimport { z, ZodError } from 'zod'\n\nimport type { AltTextPluginConfig } from '../types/AltTextPluginConfig.js'\n\nimport { matchesMimeType } from '../utilities/mimeTypes.js'\n\n/**\n * Generates alt text for a single image using the configured resolver.\n *\n * By default, returns the result without updating the document (preview mode).\n * Pass `update: true` in the request body to also persist the generated alt text\n * and keywords to the document — useful for programmatic/agent workflows.\n *\n * The response always includes the `id` and `collection` for easy correlation.\n */\nexport const generateAltTextEndpoint =\n  (access: AltTextPluginConfig['access']): PayloadHandler =>\n  async (req: PayloadRequest) => {\n    try {\n      if (!(await access({ req }))) {\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        id: z.union([z.string(), z.number()]),\n        collection: z.string(),\n        locale: z.string().nullable(),\n        update: z.boolean().optional().default(false),\n      })\n\n      const { id, collection, locale, update } = requestSchema.parse(data)\n\n      const imageDoc = await req.payload.findByID({\n        id,\n        collection,\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) {\n        return Response.json({ error: 'Plugin config not found' }, { status: 500 })\n      }\n\n      if (!pluginConfig.getImageThumbnail) {\n        return Response.json(\n          { error: 'getImageThumbnail function not configured' },\n          { status: 500 },\n        )\n      }\n\n      if (!pluginConfig.resolver) {\n        return Response.json({ error: 'No alt text resolver configured' }, { status: 500 })\n      }\n\n      const mimeType =\n        'mimeType' in imageDoc && typeof imageDoc.mimeType === 'string'\n          ? imageDoc.mimeType\n          : undefined\n\n      const collectionConfig = pluginConfig.collections.find((entry) => entry.slug === collection)\n\n      if (mimeType && collectionConfig && !matchesMimeType(mimeType, collectionConfig.mimeTypes)) {\n        return Response.json(\n          {\n            error: `Alt text is not tracked for files of type \"${mimeType}\" in the \"${collection}\" collection. Tracked types: ${collectionConfig.mimeTypes.join(', ')}.`,\n          },\n          { status: 400 },\n        )\n      }\n\n      if (\n        mimeType &&\n        pluginConfig.resolver.supportedMimeTypes &&\n        !pluginConfig.resolver.supportedMimeTypes.includes(mimeType)\n      ) {\n        return Response.json(\n          {\n            error: `Alt text generation is not supported for files of type \"${mimeType}\". Supported types: ${pluginConfig.resolver.supportedMimeTypes.join(', ')}.`,\n          },\n          { status: 400 },\n        )\n      }\n\n      // determine target locale\n      const targetLocale = locale ?? pluginConfig.locale\n      if (!targetLocale) {\n        return Response.json(\n          {\n            error:\n              'Could not determine target locale for alt text generation. Please check your plugin configuration.',\n          },\n          { status: 500 },\n        )\n      }\n\n      const imageThumbnailUrl = pluginConfig.getImageThumbnail(imageDoc)\n\n      const result = await pluginConfig.resolver.resolve({\n        filename:\n          'filename' in imageDoc && typeof imageDoc.filename === 'string'\n            ? imageDoc.filename\n            : undefined,\n        imageThumbnailUrl,\n        locale: targetLocale,\n        req,\n      })\n\n      if (!result.success) {\n        return Response.json(\n          { error: result.error || 'Failed to generate alt text' },\n          { status: 500 },\n        )\n      }\n\n      if (update) {\n        await req.payload.update({\n          id,\n          collection,\n          data: {\n            alt: result.result.altText,\n            keywords: result.result.keywords,\n          },\n          locale: targetLocale,\n        })\n      }\n\n      return Response.json({ id, collection, ...result.result })\n    } catch (error) {\n      if (error instanceof ZodError) {\n        return Response.json(\n          {\n            details: error.issues.map((e) => ({\n              message: e.message,\n              path: e.path.join('.'),\n            })),\n            error: 'Validation failed',\n          },\n          { status: 400 },\n        )\n      }\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":["z","ZodError","matchesMimeType","generateAltTextEndpoint","access","req","Response","json","error","status","data","requestSchema","object","id","union","string","number","collection","locale","nullable","update","boolean","optional","default","parse","imageDoc","payload","findByID","depth","pluginConfig","config","custom","altTextPluginConfig","getImageThumbnail","resolver","mimeType","undefined","collectionConfig","collections","find","entry","slug","mimeTypes","join","supportedMimeTypes","includes","targetLocale","imageThumbnailUrl","result","resolve","filename","success","alt","altText","keywords","details","issues","map","e","message","path","console","Error"],"mappings":"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"}
+{"version":3,"sources":["../../src/endpoints/generateAltText.ts"],"sourcesContent":["import type { PayloadHandler, PayloadRequest } from 'payload'\n\nimport { ZodError } from 'zod'\n\nimport type { AltTextPluginConfig } from '../types/AltTextPluginConfig.js'\n\nimport { matchesMimeType } from '../utilities/mimeTypes.js'\nimport { formatZodError, generateAltTextRequestSchema } from './schemas.js'\n\n/**\n * Generates alt text for a single image using the configured resolver.\n *\n * By default, returns the result without updating the document (preview mode).\n * Pass `update: true` in the request body to also persist the generated alt text\n * and keywords to the document — useful for programmatic/agent workflows.\n *\n * The response always includes the `id` and `collection` for easy correlation.\n */\nexport const generateAltTextEndpoint =\n  (access: AltTextPluginConfig['access']): PayloadHandler =>\n  async (req: PayloadRequest) => {\n    try {\n      if (!(await access({ req }))) {\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 { id, collection, locale, update } = generateAltTextRequestSchema.parse(data)\n\n      const imageDoc = await req.payload.findByID({\n        id,\n        collection,\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) {\n        return Response.json({ error: 'Plugin config not found' }, { status: 500 })\n      }\n\n      if (!pluginConfig.getImageThumbnail) {\n        return Response.json(\n          { error: 'getImageThumbnail function not configured' },\n          { status: 500 },\n        )\n      }\n\n      if (!pluginConfig.resolver) {\n        return Response.json({ error: 'No alt text resolver configured' }, { status: 500 })\n      }\n\n      const mimeType =\n        'mimeType' in imageDoc && typeof imageDoc.mimeType === 'string'\n          ? imageDoc.mimeType\n          : undefined\n\n      const collectionConfig = pluginConfig.collections.find((entry) => entry.slug === collection)\n\n      if (mimeType && collectionConfig && !matchesMimeType(mimeType, collectionConfig.mimeTypes)) {\n        return Response.json(\n          {\n            error: `Alt text is not tracked for files of type \"${mimeType}\" in the \"${collection}\" collection. Tracked types: ${collectionConfig.mimeTypes.join(', ')}.`,\n          },\n          { status: 400 },\n        )\n      }\n\n      if (\n        mimeType &&\n        pluginConfig.resolver.supportedMimeTypes &&\n        !pluginConfig.resolver.supportedMimeTypes.includes(mimeType)\n      ) {\n        return Response.json(\n          {\n            error: `Alt text generation is not supported for files of type \"${mimeType}\". Supported types: ${pluginConfig.resolver.supportedMimeTypes.join(', ')}.`,\n          },\n          { status: 400 },\n        )\n      }\n\n      // determine target locale\n      const targetLocale = locale ?? pluginConfig.locale\n      if (!targetLocale) {\n        return Response.json(\n          {\n            error:\n              'Could not determine target locale for alt text generation. Please check your plugin configuration.',\n          },\n          { status: 500 },\n        )\n      }\n\n      const imageThumbnailUrl = pluginConfig.getImageThumbnail(imageDoc)\n\n      const result = await pluginConfig.resolver.resolve({\n        filename:\n          'filename' in imageDoc && typeof imageDoc.filename === 'string'\n            ? imageDoc.filename\n            : undefined,\n        imageThumbnailUrl,\n        locale: targetLocale,\n        req,\n      })\n\n      if (!result.success) {\n        return Response.json(\n          { error: result.error || 'Failed to generate alt text' },\n          { status: 500 },\n        )\n      }\n\n      if (update) {\n        await req.payload.update({\n          id,\n          collection,\n          data: {\n            alt: result.result.altText,\n            keywords: result.result.keywords,\n          },\n          locale: targetLocale,\n        })\n      }\n\n      return Response.json({ id, collection, ...result.result })\n    } catch (error) {\n      if (error instanceof ZodError) {\n        return Response.json(formatZodError(error), { status: 400 })\n      }\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":["ZodError","matchesMimeType","formatZodError","generateAltTextRequestSchema","generateAltTextEndpoint","access","req","Response","json","error","status","data","id","collection","locale","update","parse","imageDoc","payload","findByID","depth","pluginConfig","config","custom","altTextPluginConfig","getImageThumbnail","resolver","mimeType","undefined","collectionConfig","collections","find","entry","slug","mimeTypes","join","supportedMimeTypes","includes","targetLocale","imageThumbnailUrl","result","resolve","filename","success","alt","altText","keywords","console","Error","message"],"mappings":"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"}

package/dist/endpoints/schemas.d.ts

@@ -0,0 +1,19 @@
+import type { ZodError } from 'zod';
+import { z } from 'zod';
+export declare const generateAltTextRequestSchema: z.ZodObject<{
+    id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    collection: z.ZodString;
+    locale: z.ZodNullable<z.ZodString>;
+    update: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+export declare const bulkGenerateAltTextsRequestSchema: z.ZodObject<{
+    collection: z.ZodString;
+    ids: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>;
+export declare const formatZodError: (error: ZodError) => {
+    details: {
+        message: string;
+        path: string;
+    }[];
+    error: string;
+};

package/dist/endpoints/schemas.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export const generateAltTextRequestSchema = z.object({
+    id: z.union([
+        z.string(),
+        z.number()
+    ]),
+    collection: z.string(),
+    locale: z.string().nullable(),
+    update: z.boolean().optional().default(false)
+});
+export const bulkGenerateAltTextsRequestSchema = z.object({
+    collection: z.string(),
+    ids: z.array(z.union([
+        z.string(),
+        z.number()
+    ]))
+});
+export const formatZodError = (error)=>({
+        details: error.issues.map((e)=>({
+                message: e.message,
+                path: e.path.join('.')
+            })),
+        error: 'Validation failed'
+    });
+
+//# sourceMappingURL=schemas.js.map

package/dist/endpoints/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/endpoints/schemas.ts"],"sourcesContent":["import type { ZodError } from 'zod'\n\nimport { z } from 'zod'\n\nexport const generateAltTextRequestSchema = z.object({\n  id: z.union([z.string(), z.number()]),\n  collection: z.string(),\n  locale: z.string().nullable(),\n  update: z.boolean().optional().default(false),\n})\n\nexport const bulkGenerateAltTextsRequestSchema = z.object({\n  collection: z.string(),\n  ids: z.array(z.union([z.string(), z.number()])),\n})\n\nexport const formatZodError = (error: ZodError) => ({\n  details: error.issues.map((e) => ({\n    message: e.message,\n    path: e.path.join('.'),\n  })),\n  error: 'Validation failed',\n})\n"],"names":["z","generateAltTextRequestSchema","object","id","union","string","number","collection","locale","nullable","update","boolean","optional","default","bulkGenerateAltTextsRequestSchema","ids","array","formatZodError","error","details","issues","map","e","message","path","join"],"mappings":"AAEA,SAASA,CAAC,QAAQ,MAAK;AAEvB,OAAO,MAAMC,+BAA+BD,EAAEE,MAAM,CAAC;IACnDC,IAAIH,EAAEI,KAAK,CAAC;QAACJ,EAAEK,MAAM;QAAIL,EAAEM,MAAM;KAAG;IACpCC,YAAYP,EAAEK,MAAM;IACpBG,QAAQR,EAAEK,MAAM,GAAGI,QAAQ;IAC3BC,QAAQV,EAAEW,OAAO,GAAGC,QAAQ,GAAGC,OAAO,CAAC;AACzC,GAAE;AAEF,OAAO,MAAMC,oCAAoCd,EAAEE,MAAM,CAAC;IACxDK,YAAYP,EAAEK,MAAM;IACpBU,KAAKf,EAAEgB,KAAK,CAAChB,EAAEI,KAAK,CAAC;QAACJ,EAAEK,MAAM;QAAIL,EAAEM,MAAM;KAAG;AAC/C,GAAE;AAEF,OAAO,MAAMW,iBAAiB,CAACC,QAAqB,CAAA;QAClDC,SAASD,MAAME,MAAM,CAACC,GAAG,CAAC,CAACC,IAAO,CAAA;gBAChCC,SAASD,EAAEC,OAAO;gBAClBC,MAAMF,EAAEE,IAAI,CAACC,IAAI,CAAC;YACpB,CAAA;QACAP,OAAO;IACT,CAAA,EAAE"}

package/dist/hooks/revalidateAltTextHealth.js

@@ -3,11 +3,11 @@ import { ALT_TEXT_HEALTH_PLUGIN_SLUG, getAltTextHealthCollectionTag } from '../u
 function safeRevalidateTag(req, tag) {
     try {
         // Support both Next 15 and Next 16. Next 15 types `revalidateTag(tag)` as 1-arg; Next 16
-        // added a required second `profile` arg (a 1-arg call still works at runtime, with a
-        // deprecation warning). Cast so the build succeeds regardless of which Next types are
-        // resolved, while keeping runtime behaviour correct on both versions.
+        // added a required second `profile` arg and logs a deprecation warning for 1-arg calls.
+        // Passing 'max' satisfies Next 16 and is ignored at runtime by Next 15. The cast lets the
+        // build succeed regardless of which Next types are resolved from the consuming project.
         ;
-        revalidateTag(tag);
+        revalidateTag(tag, 'max');
     } catch (error) {
         const message = error instanceof Error ? error.message : String(error);
         if (message.includes('static generation store missing')) {

package/dist/hooks/revalidateAltTextHealth.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/revalidateAltTextHealth.ts"],"sourcesContent":["import type { CollectionAfterChangeHook, CollectionAfterDeleteHook, PayloadRequest } from 'payload'\n\nimport { revalidateTag } from 'next/cache.js'\n\nimport {\n  ALT_TEXT_HEALTH_PLUGIN_SLUG,\n  getAltTextHealthCollectionTag,\n} from '../utilities/altTextHealth.js'\n\nfunction safeRevalidateTag(req: PayloadRequest, tag: string): void {\n  try {\n    // Support both Next 15 and Next 16. Next 15 types `revalidateTag(tag)` as 1-arg; Next 16\n    // added a required second `profile` arg (a 1-arg call still works at runtime, with a\n    // deprecation warning). Cast so the build succeeds regardless of which Next types are\n    // resolved, while keeping runtime behaviour correct on both versions.\n    ;(revalidateTag as (tag: string) => void)(tag)\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error)\n\n    if (message.includes('static generation store missing')) {\n      req.payload.logger.warn({\n        msg: 'Skipping alt text health cache revalidation outside a Next.js request context.',\n        plugin: ALT_TEXT_HEALTH_PLUGIN_SLUG,\n        tag,\n      })\n      return\n    }\n\n    throw error\n  }\n}\n\nexport const createRevalidateAltTextHealthAfterChangeHook =\n  (collectionSlug: string): CollectionAfterChangeHook =>\n  ({ doc, req }) => {\n    if (!req.context?.disableRevalidate) {\n      safeRevalidateTag(req, getAltTextHealthCollectionTag(collectionSlug))\n    }\n\n    return doc\n  }\n\nexport const createRevalidateAltTextHealthAfterDeleteHook =\n  (collectionSlug: string): CollectionAfterDeleteHook =>\n  ({ doc, req }) => {\n    if (!req.context?.disableRevalidate) {\n      safeRevalidateTag(req, getAltTextHealthCollectionTag(collectionSlug))\n    }\n\n    return doc\n  }\n"],"names":["revalidateTag","ALT_TEXT_HEALTH_PLUGIN_SLUG","getAltTextHealthCollectionTag","safeRevalidateTag","req","tag","error","message","Error","String","includes","payload","logger","warn","msg","plugin","createRevalidateAltTextHealthAfterChangeHook","collectionSlug","doc","context","disableRevalidate","createRevalidateAltTextHealthAfterDeleteHook"],"mappings":"AAEA,SAASA,aAAa,QAAQ,gBAAe;AAE7C,SACEC,2BAA2B,EAC3BC,6BAA6B,QACxB,gCAA+B;AAEtC,SAASC,kBAAkBC,GAAmB,EAAEC,GAAW;IACzD,IAAI;QACF,yFAAyF;QACzF,qFAAqF;QACrF,sFAAsF;QACtF,sEAAsE;;QACpEL,cAAwCK;IAC5C,EAAE,OAAOC,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGE,OAAOH;QAEhE,IAAIC,QAAQG,QAAQ,CAAC,oCAAoC;YACvDN,IAAIO,OAAO,CAACC,MAAM,CAACC,IAAI,CAAC;gBACtBC,KAAK;gBACLC,QAAQd;gBACRI;YACF;YACA;QACF;QAEA,MAAMC;IACR;AACF;AAEA,OAAO,MAAMU,+CACX,CAACC,iBACD,CAAC,EAAEC,GAAG,EAAEd,GAAG,EAAE;QACX,IAAI,CAACA,IAAIe,OAAO,EAAEC,mBAAmB;YACnCjB,kBAAkBC,KAAKF,8BAA8Be;QACvD;QAEA,OAAOC;IACT,EAAC;AAEH,OAAO,MAAMG,+CACX,CAACJ,iBACD,CAAC,EAAEC,GAAG,EAAEd,GAAG,EAAE;QACX,IAAI,CAACA,IAAIe,OAAO,EAAEC,mBAAmB;YACnCjB,kBAAkBC,KAAKF,8BAA8Be;QACvD;QAEA,OAAOC;IACT,EAAC"}
+{"version":3,"sources":["../../src/hooks/revalidateAltTextHealth.ts"],"sourcesContent":["import type { CollectionAfterChangeHook, CollectionAfterDeleteHook, PayloadRequest } from 'payload'\n\nimport { revalidateTag } from 'next/cache.js'\n\nimport {\n  ALT_TEXT_HEALTH_PLUGIN_SLUG,\n  getAltTextHealthCollectionTag,\n} from '../utilities/altTextHealth.js'\n\nfunction safeRevalidateTag(req: PayloadRequest, tag: string): void {\n  try {\n    // Support both Next 15 and Next 16. Next 15 types `revalidateTag(tag)` as 1-arg; Next 16\n    // added a required second `profile` arg and logs a deprecation warning for 1-arg calls.\n    // Passing 'max' satisfies Next 16 and is ignored at runtime by Next 15. The cast lets the\n    // build succeed regardless of which Next types are resolved from the consuming project.\n    ;(revalidateTag as (tag: string, profile?: string) => void)(tag, 'max')\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error)\n\n    if (message.includes('static generation store missing')) {\n      req.payload.logger.warn({\n        msg: 'Skipping alt text health cache revalidation outside a Next.js request context.',\n        plugin: ALT_TEXT_HEALTH_PLUGIN_SLUG,\n        tag,\n      })\n      return\n    }\n\n    throw error\n  }\n}\n\nexport const createRevalidateAltTextHealthAfterChangeHook =\n  (collectionSlug: string): CollectionAfterChangeHook =>\n  ({ doc, req }) => {\n    if (!req.context?.disableRevalidate) {\n      safeRevalidateTag(req, getAltTextHealthCollectionTag(collectionSlug))\n    }\n\n    return doc\n  }\n\nexport const createRevalidateAltTextHealthAfterDeleteHook =\n  (collectionSlug: string): CollectionAfterDeleteHook =>\n  ({ doc, req }) => {\n    if (!req.context?.disableRevalidate) {\n      safeRevalidateTag(req, getAltTextHealthCollectionTag(collectionSlug))\n    }\n\n    return doc\n  }\n"],"names":["revalidateTag","ALT_TEXT_HEALTH_PLUGIN_SLUG","getAltTextHealthCollectionTag","safeRevalidateTag","req","tag","error","message","Error","String","includes","payload","logger","warn","msg","plugin","createRevalidateAltTextHealthAfterChangeHook","collectionSlug","doc","context","disableRevalidate","createRevalidateAltTextHealthAfterDeleteHook"],"mappings":"AAEA,SAASA,aAAa,QAAQ,gBAAe;AAE7C,SACEC,2BAA2B,EAC3BC,6BAA6B,QACxB,gCAA+B;AAEtC,SAASC,kBAAkBC,GAAmB,EAAEC,GAAW;IACzD,IAAI;QACF,yFAAyF;QACzF,wFAAwF;QACxF,0FAA0F;QAC1F,wFAAwF;;QACtFL,cAA0DK,KAAK;IACnE,EAAE,OAAOC,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGE,OAAOH;QAEhE,IAAIC,QAAQG,QAAQ,CAAC,oCAAoC;YACvDN,IAAIO,OAAO,CAACC,MAAM,CAACC,IAAI,CAAC;gBACtBC,KAAK;gBACLC,QAAQd;gBACRI;YACF;YACA;QACF;QAEA,MAAMC;IACR;AACF;AAEA,OAAO,MAAMU,+CACX,CAACC,iBACD,CAAC,EAAEC,GAAG,EAAEd,GAAG,EAAE;QACX,IAAI,CAACA,IAAIe,OAAO,EAAEC,mBAAmB;YACnCjB,kBAAkBC,KAAKF,8BAA8Be;QACvD;QAEA,OAAOC;IACT,EAAC;AAEH,OAAO,MAAMG,+CACX,CAACJ,iBACD,CAAC,EAAEC,GAAG,EAAEd,GAAG,EAAE;QACX,IAAI,CAACA,IAAIe,OAAO,EAAEC,mBAAmB;YACnCjB,kBAAkBC,KAAKF,8BAA8Be;QACvD;QAEA,OAAOC;IACT,EAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jhb.software/payload-alt-text-plugin",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "A Payload CMS plugin that adds AI-powered alt text generation for images.",
   "bugs": "https://github.com/jhb-software/payload-plugins/issues",
   "repository": "https://github.com/jhb-software/payload-plugins",
@@ -17,30 +17,30 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "dependencies": {
-    "openai": "^6.34.0",
+    "openai": "^6.37.0",
     "p-map": "^7.0.4",
-    "zod": "^4.3.6"
+    "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@payloadcms/translations": "^3.83.0",
-    "@payloadcms/ui": "^3.83.0",
-    "next": "15.4.11",
-    "payload": "^3.83.0",
-    "react": "19.2.5",
-    "react-dom": "19.2.5"
+    "@payloadcms/translations": "^3.84.1",
+    "@payloadcms/ui": "^3.84.1",
+    "next": "^15.0.0 || ^16.0.0",
+    "payload": "^3.84.1",
+    "react": "19.2.6",
+    "react-dom": "19.2.6"
   },
   "devDependencies": {
     "@payloadcms/eslint-config": "^3.28.0",
-    "@payloadcms/translations": "^3.83.0",
+    "@payloadcms/translations": "^3.84.1",
     "@swc/cli": "^0.8.1",
-    "@swc/core": "^1.15.26",
+    "@swc/core": "^1.15.33",
     "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
     "copyfiles": "2.4.1",
-    "eslint": "^9.0.0",
+    "eslint": "^9.39.4",
     "prettier": "^3.8.3",
     "rimraf": "6.1.3",
-    "typescript": "5.9.3"
+    "typescript": "^6.0.3"
   },
   "files": [
     "dist"
@@ -63,7 +63,7 @@
     }
   },
   "engines": {
-    "node": "^18.20.2 || >=20.9.0"
+    "node": ">=22.12.0"
   },
   "scripts": {
     "build": "pnpm copyfiles && pnpm build:types && pnpm build:swc",