@jhb.software/payload-alt-text-plugin 0.3.1 → 0.4.1

package/README.md

@@ -10,6 +10,7 @@ A [Payload CMS](https://payloadcms.com/) plugin that adds AI-powered alt text ge
 - Automatic keyword extraction for improved admin search
 - Bulk generation for processing multiple images at once
 - Full localization support
+- Dashboard health widget with cached coverage insights across all configured upload collections
 
 
 When the plugin is enabled for an upload collection, it will:
@@ -22,6 +23,10 @@ When the plugin is enabled for an upload collection, it will:
    - It will be used for improving the search of images in the admin panel
 2. Add a bulk generate button to the collection list view
    - This button will allow you to generate alt text for multiple images at once
+3. Register an `Alt text health` dashboard widget
+   - The widget is available in Payload's dashboard editor
+   - It is added to the default dashboard layout for first-time and reset layouts
+   - Results are cached and revalidated when documents in the configured upload collections change
 
 ## Installation
 
@@ -68,6 +73,13 @@ Note: When localization is disabled in your Payload config (default), you need t
 | `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`) |
+
+## Dashboard Widget
+
+The plugin registers an `Alt text health` dashboard widget that shows alt text coverage across all configured upload collections, with cached queries that revalidate on document changes. Collections with missing alt text show a clickable badge linking to the affected images.
+
+Set `healthCheck: false` in the plugin config to disable the REST endpoint, cache revalidation hooks, and dashboard widget. If your project replaces the default dashboard via `admin.components.views.dashboard`, you need to integrate the widget into your custom dashboard yourself.
 
 ### Resolvers
 
@@ -116,6 +128,80 @@ export const customResolver = (): AltTextResolver => ({
 })
 ```
 
+## REST API Endpoints
+
+The plugin registers the following REST API endpoints under `/api/alt-text-plugin/`. All endpoints require authentication by default (configurable via the `access` option).
+
+### `POST /api/alt-text-plugin/generate`
+
+Generates alt text for a single image. By default, returns the result without saving it (preview mode). Pass `update: true` to also persist the generated alt text and keywords to the document.
+
+**Request body:**
+
+| Field        | Type               | Required | Description                                                              |
+| ------------ | ------------------ | -------- | ------------------------------------------------------------------------ |
+| `id`         | `string \| number` | Yes      | The document ID                                                          |
+| `collection` | `string`           | Yes      | The collection slug                                                      |
+| `locale`     | `string \| null`   | Yes      | Target locale (use `null` for non-localized setups)                      |
+| `update`     | `boolean`          | No       | When `true`, persists the result to the document (default: `false`)      |
+
+**Response:**
+
+```json
+{
+  "id": "abc123",
+  "collection": "media",
+  "altText": "A canal scene in a European city with historic buildings.",
+  "keywords": ["canal", "buildings", "European city"]
+}
+```
+
+### `POST /api/alt-text-plugin/generate/bulk`
+
+Generates and persists alt text for multiple images across all configured locales.
+
+**Request body:**
+
+| Field        | Type                 | Required | Description                                                         |
+| ------------ | -------------------- | -------- | ------------------------------------------------------------------- |
+| `collection` | `string`             | Yes      | The collection slug                                                 |
+| `ids`        | `(string \| number)[]` | Yes    | Array of document IDs to process                                    |
+
+**Response:**
+
+```json
+{
+  "updatedDocs": 5,
+  "totalDocs": 6,
+  "erroredDocs": ["abc789"]
+}
+```
+
+### `GET /api/alt-text-plugin/health`
+
+Returns alt text coverage statistics across all configured collections. Only available when `healthCheck` is enabled.
+
+**Response:**
+
+```json
+{
+  "checkedAt": "2025-01-01T00:00:00.000Z",
+  "collections": [
+    {
+      "collection": "media",
+      "totalDocs": 12,
+      "completeDocs": 10,
+      "partialDocs": 1,
+      "missingDocs": 1,
+      "invalidDocIds": ["abc123"]
+    }
+  ],
+  "isLocalized": true,
+  "localeCodes": ["en", "de"],
+  "errors": []
+}
+```
+
 ## Roadmap
 
 > **Warning**: This plugin is actively evolving and may undergo significant changes. While it is functional, please thoroughly test before using in production environments.

package/dist/components/AltTextHealthWidget.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetServerProps } from 'payload';
+export declare function AltTextHealthWidget({ req }: WidgetServerProps): Promise<import("react").JSX.Element>;

package/dist/components/AltTextHealthWidget.js

@@ -0,0 +1,199 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { getAltTextHealthWidgetData } from '../utilities/altTextHealth.js';
+import { getAltTextHealthWidgetDisplayState } from '../utilities/altTextHealthWidgetDisplay.js';
+import { getCollectionLabel } from '../utilities/getCollectionLabel.js';
+const badgeStyles = {
+    healthy: {
+        background: '#dcfce7',
+        color: '#15803d'
+    },
+    unhealthy: {
+        background: '#fee2e2',
+        color: '#991b1b'
+    }
+};
+export async function AltTextHealthWidget({ req }) {
+    // Plugin translation keys are not in Payload's built-in key union
+    const t = req.t;
+    const { collections, errors, isLocalized, localeCount, totalDocs } = await getAltTextHealthWidgetData(req);
+    return /*#__PURE__*/ _jsxs("div", {
+        className: "card",
+        style: {
+            display: 'flex',
+            flexDirection: 'column',
+            gap: '16px',
+            height: '100%'
+        },
+        children: [
+            /*#__PURE__*/ _jsxs("div", {
+                style: {
+                    display: 'flex',
+                    flexDirection: 'column',
+                    gap: '4px'
+                },
+                children: [
+                    /*#__PURE__*/ _jsx("h3", {
+                        style: {
+                            fontSize: '18px',
+                            fontWeight: 600,
+                            margin: 0
+                        },
+                        children: t('@jhb.software/payload-alt-text-plugin:altTextHealthWidget')
+                    }),
+                    /*#__PURE__*/ _jsx("p", {
+                        style: {
+                            color: 'var(--theme-text)',
+                            fontSize: '14px',
+                            margin: 0,
+                            opacity: 0.75
+                        },
+                        children: t('@jhb.software/payload-alt-text-plugin:altTextHealthDescription')
+                    })
+                ]
+            }),
+            totalDocs === 0 && errors.length === 0 && /*#__PURE__*/ _jsx("p", {
+                style: {
+                    color: 'var(--theme-text)',
+                    margin: 0,
+                    opacity: 0.75
+                },
+                children: t('@jhb.software/payload-alt-text-plugin:noImagesFound')
+            }),
+            errors.length > 0 && /*#__PURE__*/ _jsx("p", {
+                style: {
+                    color: '#92400e',
+                    fontSize: '13px',
+                    margin: 0
+                },
+                children: t('@jhb.software/payload-alt-text-plugin:healthCheckPartialWarning')
+            }),
+            /*#__PURE__*/ _jsx("div", {
+                style: {
+                    display: 'flex',
+                    flexDirection: 'column',
+                    gap: '10px'
+                },
+                children: collections.map((collection)=>{
+                    const displayState = getAltTextHealthWidgetDisplayState(collection);
+                    return /*#__PURE__*/ _jsxs("div", {
+                        style: {
+                            alignItems: 'center',
+                            background: 'var(--theme-elevation-50)',
+                            border: '1px solid var(--theme-border-color)',
+                            borderRadius: '10px',
+                            display: 'flex',
+                            gap: '12px',
+                            justifyContent: 'space-between',
+                            padding: '12px 16px'
+                        },
+                        children: [
+                            /*#__PURE__*/ _jsxs("div", {
+                                style: {
+                                    display: 'flex',
+                                    flexDirection: 'column',
+                                    gap: '2px',
+                                    minWidth: 0
+                                },
+                                children: [
+                                    /*#__PURE__*/ _jsx("a", {
+                                        href: `${req.payload.config.routes.admin}/collections/${collection.collection}`,
+                                        style: {
+                                            color: 'var(--theme-text)',
+                                            fontSize: '14px',
+                                            fontWeight: 500,
+                                            textDecoration: 'none'
+                                        },
+                                        children: getCollectionLabel(collection.collection, req.payload.config.collections, req.locale)
+                                    }),
+                                    displayState === 'unavailable' ? /*#__PURE__*/ _jsx("span", {
+                                        style: {
+                                            color: '#92400e',
+                                            fontSize: '13px'
+                                        },
+                                        children: t('@jhb.software/payload-alt-text-plugin:collectionCheckFailed')
+                                    }) : /*#__PURE__*/ _jsxs("span", {
+                                        style: {
+                                            fontSize: '13px',
+                                            opacity: 0.7
+                                        },
+                                        children: [
+                                            t('@jhb.software/payload-alt-text-plugin:totalImageCount').replace('{count}', String(collection.totalDocs)),
+                                            isLocalized && /*#__PURE__*/ _jsxs(_Fragment, {
+                                                children: [
+                                                    ' · ',
+                                                    t('@jhb.software/payload-alt-text-plugin:localeCount').replace('{count}', String(localeCount))
+                                                ]
+                                            })
+                                        ]
+                                    })
+                                ]
+                            }),
+                            displayState === 'unhealthy' && collection.invalidDocIds && collection.invalidDocIds.length > 0 ? /*#__PURE__*/ _jsxs("a", {
+                                href: `${req.payload.config.routes.admin}/collections/${collection.collection}?where[id][in]=${collection.invalidDocIds.join(',')}`,
+                                style: {
+                                    background: badgeStyles.unhealthy.background,
+                                    borderRadius: '999px',
+                                    color: badgeStyles.unhealthy.color,
+                                    flexShrink: 0,
+                                    fontSize: '12px',
+                                    fontWeight: 600,
+                                    padding: '4px 10px',
+                                    textDecoration: 'none',
+                                    whiteSpace: 'nowrap'
+                                },
+                                children: [
+                                    collection.missingDocs + collection.partialDocs,
+                                    ' ',
+                                    t('@jhb.software/payload-alt-text-plugin:statusUnhealthy'),
+                                    " →"
+                                ]
+                            }) : displayState === 'healthy' ? /*#__PURE__*/ _jsxs("span", {
+                                style: {
+                                    background: badgeStyles.healthy.background,
+                                    borderRadius: '999px',
+                                    color: badgeStyles.healthy.color,
+                                    flexShrink: 0,
+                                    fontSize: '12px',
+                                    fontWeight: 600,
+                                    padding: '4px 10px',
+                                    whiteSpace: 'nowrap'
+                                },
+                                children: [
+                                    t('@jhb.software/payload-alt-text-plugin:statusHealthy'),
+                                    " ✓"
+                                ]
+                            }) : displayState === 'unhealthy' ? /*#__PURE__*/ _jsxs("span", {
+                                style: {
+                                    background: badgeStyles.unhealthy.background,
+                                    borderRadius: '999px',
+                                    color: badgeStyles.unhealthy.color,
+                                    flexShrink: 0,
+                                    fontSize: '12px',
+                                    fontWeight: 600,
+                                    padding: '4px 10px',
+                                    whiteSpace: 'nowrap'
+                                },
+                                children: [
+                                    collection.missingDocs + collection.partialDocs,
+                                    ' ',
+                                    t('@jhb.software/payload-alt-text-plugin:statusUnhealthy')
+                                ]
+                            }) : /*#__PURE__*/ _jsx("span", {
+                                style: {
+                                    color: '#92400e',
+                                    flexShrink: 0,
+                                    fontSize: '12px',
+                                    fontWeight: 600,
+                                    whiteSpace: 'nowrap'
+                                },
+                                children: t('@jhb.software/payload-alt-text-plugin:collectionCheckFailed')
+                            })
+                        ]
+                    }, collection.collection);
+                })
+            })
+        ]
+    });
+}
+
+//# sourceMappingURL=AltTextHealthWidget.js.map

package/dist/components/AltTextHealthWidget.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/AltTextHealthWidget.tsx"],"sourcesContent":["import type { WidgetServerProps } from 'payload'\n\nimport { getAltTextHealthWidgetData } from '../utilities/altTextHealth.js'\nimport { getAltTextHealthWidgetDisplayState } from '../utilities/altTextHealthWidgetDisplay.js'\nimport { getCollectionLabel } from '../utilities/getCollectionLabel.js'\n\nconst badgeStyles = {\n  healthy: { background: '#dcfce7', color: '#15803d' },\n  unhealthy: { background: '#fee2e2', color: '#991b1b' },\n}\n\nexport async function AltTextHealthWidget({ req }: WidgetServerProps) {\n  // Plugin translation keys are not in Payload's built-in key union\n  const t = req.t as (key: string) => string\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        <h3 style={{ fontSize: '18px', fontWeight: 600, margin: 0 }}>\n          {t('@jhb.software/payload-alt-text-plugin:altTextHealthWidget')}\n        </h3>\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: '10px',\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                    {t('@jhb.software/payload-alt-text-plugin:totalImageCount').replace(\n                      '{count}',\n                      String(collection.totalDocs),\n                    )}\n                    {isLocalized && (\n                      <>\n                        {' · '}\n                        {t('@jhb.software/payload-alt-text-plugin:localeCount').replace(\n                          '{count}',\n                          String(localeCount),\n                        )}\n                      </>\n                    )}\n                  </span>\n                )}\n              </div>\n\n              {displayState === 'unhealthy' &&\n              collection.invalidDocIds &&\n              collection.invalidDocIds.length > 0 ? (\n                <a\n                  href={`${req.payload.config.routes.admin}/collections/${collection.collection}?where[id][in]=${collection.invalidDocIds.join(',')}`}\n                  style={{\n                    background: badgeStyles.unhealthy.background,\n                    borderRadius: '999px',\n                    color: badgeStyles.unhealthy.color,\n                    flexShrink: 0,\n                    fontSize: '12px',\n                    fontWeight: 600,\n                    padding: '4px 10px',\n                    textDecoration: 'none',\n                    whiteSpace: 'nowrap',\n                  }}\n                >\n                  {collection.missingDocs + collection.partialDocs}{' '}\n                  {t('@jhb.software/payload-alt-text-plugin:statusUnhealthy')} →\n                </a>\n              ) : displayState === 'healthy' ? (\n                <span\n                  style={{\n                    background: badgeStyles.healthy.background,\n                    borderRadius: '999px',\n                    color: badgeStyles.healthy.color,\n                    flexShrink: 0,\n                    fontSize: '12px',\n                    fontWeight: 600,\n                    padding: '4px 10px',\n                    whiteSpace: 'nowrap',\n                  }}\n                >\n                  {t('@jhb.software/payload-alt-text-plugin:statusHealthy')} ✓\n                </span>\n              ) : displayState === 'unhealthy' ? (\n                <span\n                  style={{\n                    background: badgeStyles.unhealthy.background,\n                    borderRadius: '999px',\n                    color: badgeStyles.unhealthy.color,\n                    flexShrink: 0,\n                    fontSize: '12px',\n                    fontWeight: 600,\n                    padding: '4px 10px',\n                    whiteSpace: 'nowrap',\n                  }}\n                >\n                  {collection.missingDocs + collection.partialDocs}{' '}\n                  {t('@jhb.software/payload-alt-text-plugin:statusUnhealthy')}\n                </span>\n              ) : (\n                <span\n                  style={{\n                    color: '#92400e',\n                    flexShrink: 0,\n                    fontSize: '12px',\n                    fontWeight: 600,\n                    whiteSpace: 'nowrap',\n                  }}\n                >\n                  {t('@jhb.software/payload-alt-text-plugin:collectionCheckFailed')}\n                </span>\n              )}\n            </div>\n          )\n        })}\n      </div>\n    </div>\n  )\n}\n"],"names":["getAltTextHealthWidgetData","getAltTextHealthWidgetDisplayState","getCollectionLabel","badgeStyles","healthy","background","color","unhealthy","AltTextHealthWidget","req","t","collections","errors","isLocalized","localeCount","totalDocs","div","className","style","display","flexDirection","gap","height","h3","fontSize","fontWeight","margin","p","opacity","length","map","collection","displayState","alignItems","border","borderRadius","justifyContent","padding","minWidth","a","href","payload","config","routes","admin","textDecoration","locale","span","replace","String","invalidDocIds","join","flexShrink","whiteSpace","missingDocs","partialDocs"],"mappings":"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"}

package/dist/components/BulkGenerateAltTextsButton.js

@@ -17,7 +17,7 @@ export function BulkGenerateAltTextsButton({ collectionSlug }) {
                 throw new Error('Collection slug is required');
             }
             try {
-                const response = await fetch('/api/alt-text-plugin/bulk-generate-alt-texts', {
+                const response = await fetch('/api/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'\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/bulk-generate-alt-texts', {\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').replace(\n              '{X}',\n              data.erroredDocs.length.toString(),\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              .replace('{X}', data.updatedDocs.toString())\n              .replace('{Y}', data.totalDocs.toString()),\n          )\n        } else {\n          toast.warning(\n            t('@jhb.software/payload-alt-text-plugin:xOfYImagesUpdated')\n              .replace('{X}', data.updatedDocs.toString())\n              .replace('{Y}', data.totalDocs.toString()),\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')} {selectedIds.length}{' '}\n          {selectedIds.length === 1\n            ? t('@jhb.software/payload-alt-text-plugin:image')\n            : t('@jhb.software/payload-alt-text-plugin:images')}\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","replace","toString","updatedDocs","totalDocs","success","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;AAMrC,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,gDAAgD;oBAC3EC,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,oEAAoE8B,OAAO,CAC3E,OACAJ,KAAKE,WAAW,CAACC,MAAM,CAACE,QAAQ;gBAGtC;gBAEA,oFAAoF;gBACpF,IAAIL,KAAKM,WAAW,KAAKN,KAAKO,SAAS,EAAE;oBACvC1C,MAAM2C,OAAO,CACXlC,EAAE,2DACC8B,OAAO,CAAC,OAAOJ,KAAKM,WAAW,CAACD,QAAQ,IACxCD,OAAO,CAAC,OAAOJ,KAAKO,SAAS,CAACF,QAAQ;gBAE7C,OAAO;oBACLxC,MAAM4C,OAAO,CACXnC,EAAE,2DACC8B,OAAO,CAAC,OAAOJ,KAAKM,WAAW,CAACD,QAAQ,IACxCD,OAAO,CAAC,OAAOJ,KAAKO,SAAS,CAACF,QAAQ;gBAE7C;gBAEA,0CAA0C;gBAC1C,KAAK,MAAMnB,MAAMP,YAAa;oBAC5BD,aAAaQ;gBACf;gBAEAC,OAAOuB,OAAO;YAChB,EAAE,OAAOX,OAAO;gBACdY,QAAQZ,KAAK,CAAC,8BAA8BA;gBAC5ClC,MAAMkC,KAAK,CAACzB,EAAE;YAChB;QACF;IACF;IAEA,OACEK,YAAYwB,MAAM,GAAG,mBACnB,KAACS;QAAIC,WAAU;QAAMC,OAAO;YAAEC,SAAS;YAAQC,gBAAgB;QAAQ;kBACrE,cAAA,MAACpD;YACCiD,WAAU;YACVI,UAAU1C,aAAaI,YAAYwB,MAAM,KAAK;YAC9Ce,MAAM3C,0BAAY,KAACJ,6BAAa,KAACD;YACjCiD,SAAS/B;;gBAERd,EAAE;gBAA4D;gBAAEK,YAAYwB,MAAM;gBAAE;gBACpFxB,YAAYwB,MAAM,KAAK,IACpB7B,EAAE,iDACFA,EAAE;;;;AAKhB"}
+{"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').replace(\n              '{X}',\n              data.erroredDocs.length.toString(),\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              .replace('{X}', data.updatedDocs.toString())\n              .replace('{Y}', data.totalDocs.toString()),\n          )\n        } else {\n          toast.warning(\n            t('@jhb.software/payload-alt-text-plugin:xOfYImagesUpdated')\n              .replace('{X}', data.updatedDocs.toString())\n              .replace('{Y}', data.totalDocs.toString()),\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')} {selectedIds.length}{' '}\n          {selectedIds.length === 1\n            ? t('@jhb.software/payload-alt-text-plugin:image')\n            : t('@jhb.software/payload-alt-text-plugin:images')}\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","replace","toString","updatedDocs","totalDocs","success","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,oEAAoE8B,OAAO,CAC3E,OACAJ,KAAKE,WAAW,CAACC,MAAM,CAACE,QAAQ;gBAGtC;gBAEA,oFAAoF;gBACpF,IAAIL,KAAKM,WAAW,KAAKN,KAAKO,SAAS,EAAE;oBACvC1C,MAAM2C,OAAO,CACXlC,EAAE,2DACC8B,OAAO,CAAC,OAAOJ,KAAKM,WAAW,CAACD,QAAQ,IACxCD,OAAO,CAAC,OAAOJ,KAAKO,SAAS,CAACF,QAAQ;gBAE7C,OAAO;oBACLxC,MAAM4C,OAAO,CACXnC,EAAE,2DACC8B,OAAO,CAAC,OAAOJ,KAAKM,WAAW,CAACD,QAAQ,IACxCD,OAAO,CAAC,OAAOJ,KAAKO,SAAS,CAACF,QAAQ;gBAE7C;gBAEA,0CAA0C;gBAC1C,KAAK,MAAMnB,MAAMP,YAAa;oBAC5BD,aAAaQ;gBACf;gBAEAC,OAAOuB,OAAO;YAChB,EAAE,OAAOX,OAAO;gBACdY,QAAQZ,KAAK,CAAC,8BAA8BA;gBAC5ClC,MAAMkC,KAAK,CAACzB,EAAE;YAChB;QACF;IACF;IAEA,OACEK,YAAYwB,MAAM,GAAG,mBACnB,KAACS;QAAIC,WAAU;QAAMC,OAAO;YAAEC,SAAS;YAAQC,gBAAgB;QAAQ;kBACrE,cAAA,MAACpD;YACCiD,WAAU;YACVI,UAAU1C,aAAaI,YAAYwB,MAAM,KAAK;YAC9Ce,MAAM3C,0BAAY,KAACJ,6BAAa,KAACD;YACjCiD,SAAS/B;;gBAERd,EAAE;gBAA4D;gBAAEK,YAAYwB,MAAM;gBAAE;gBACpFxB,YAAYwB,MAAM,KAAK,IACpB7B,EAAE,iDACFA,EAAE;;;;AAKhB"}

package/dist/components/GenerateAltTextButton.js

@@ -22,7 +22,7 @@ export function GenerateAltTextButton() {
         }
         startTransition(async ()=>{
             try {
-                const response = await fetch('/api/alt-text-plugin/generate-alt-text', {
+                const response = await fetch('/api/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'\nimport { Lightning } from './icons/Lightning.js'\nimport { Spinner } from './icons/Spinner.js'\n\nexport function GenerateAltTextButton() {\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\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-alt-text', {\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}\n          icon={isPending ? <Spinner /> : <Lightning />}\n          onClick={handleGenerateAltText}\n          tooltip={\n            !id ? t('@jhb.software/payload-alt-text-plugin:pleaseSaveDocumentFirst') : 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","t","id","collectionSlug","locale","isPending","startTransition","setValue","setKeywords","path","setAltText","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;AAMrC,SAASC,SAAS,QAAQ,uBAAsB;AAChD,SAASC,OAAO,QAAQ,qBAAoB;AAE5C,OAAO,SAASC;IACd,MAAM,EAAEC,CAAC,EAAE,GAAGL;IACd,MAAM,EAAEM,EAAE,EAAEC,cAAc,EAAE,GAAGV;IAC/B,MAAMW,SAAST;IACf,MAAM,CAACU,WAAWC,gBAAgB,GAAGT;IAErC,MAAM,EAAEU,UAAUC,WAAW,EAAE,GAAGd,SAAiB;QAAEe,MAAM;IAAW;IACtE,MAAM,EAAEF,UAAUG,UAAU,EAAE,GAAGhB,SAAiB;QAAEe,MAAM;IAAM;IAEhE,MAAME,wBAAwB;QAC5B,IAAI,CAACR,kBAAkB,CAACD,IAAI;YAC1BV,MAAMoB,KAAK,CAACX,EAAE;YACd,MAAM,IAAIY,MAAM;QAClB;QAEAP,gBAAgB;YACd,IAAI;gBACF,MAAMQ,WAAW,MAAMC,MAAM,0CAA0C;oBACrEC,MAAMC,KAAKC,SAAS,CAAC;wBACnBhB,IAAIA;wBACJiB,YAAYhB;wBACZC,QAAQA,QAAQgB,QAAQ;oBAC1B;oBACAC,QAAQ;gBACV;gBAEA,IAAI,CAACP,SAASQ,EAAE,EAAE;oBAChB,IAAIC,eAAetB,EAAE;oBACrB,IAAI;wBACF,MAAMuB,YAAa,MAAMV,SAASW,IAAI;wBACtCF,eAAeC,UAAUZ,KAAK;oBAChC,EAAE,OAAOA,OAAO;wBACdc,QAAQd,KAAK,CAAC,8BAA8BA;oBAC9C;oBAEApB,MAAMoB,KAAK,CAACW;oBACZ;gBACF;gBAEA,MAAMI,OAAQ,MAAMb,SAASW,IAAI;gBAKjC,IAAIE,KAAKC,OAAO,IAAID,KAAKE,QAAQ,EAAE;oBACjCnB,WAAWiB,KAAKC,OAAO;oBACvBpB,YAAYmB,KAAKE,QAAQ;oBACzBrC,MAAMsC,OAAO,CAAC7B,EAAE;gBAClB,OAAO;oBACLT,MAAMoB,KAAK,CAACX,EAAE;gBAChB;YACF,EAAE,OAAOW,OAAO;gBACdc,QAAQd,KAAK,CAAC,8BAA8BA;gBAC5CpB,MAAMoB,KAAK,CAACX,EAAE;YAChB;QACF;IACF;IAEA,qBACE,MAAC8B;QAAIC,OAAO;YAAEC,SAAS;YAAQC,KAAK;YAAQC,WAAW;QAAO;;0BAC5D,MAACJ;gBAAIC,OAAO;oBAAEI,OAAO;oBAA8BC,MAAM;gBAAI;;kCAC3D,KAACC;kCAAGrC,EAAE;;kCACN,MAACsC;wBAAGP,OAAO;4BAAEQ,QAAQ;4BAAUC,aAAa;wBAAO;;0CACjD,KAACC;0CAAIzC,EAAE;;0CACP,KAACyC;0CAAIzC,EAAE;;0CACP,KAACyC;0CAAIzC,EAAE;;;;;;0BAGX,KAAC8B;gBAAIC,OAAO;oBAAEW,YAAY;oBAAUV,SAAS;gBAAO;0BAClD,cAAA,KAAC1C;oBACCqD,UAAUvC,aAAa,CAACH;oBACxB2C,MAAMxC,0BAAY,KAACN,6BAAa,KAACD;oBACjCgD,SAASnC;oBACToC,SACE,CAAC7C,KAAKD,EAAE,mEAAmE+C;8BAG5E/C,EAAE;;;;;AAKb"}
+{"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() {\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\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}\n          icon={isPending ? <Spinner /> : <Lightning />}\n          onClick={handleGenerateAltText}\n          tooltip={\n            !id ? t('@jhb.software/payload-alt-text-plugin:pleaseSaveDocumentFirst') : 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","t","id","collectionSlug","locale","isPending","startTransition","setValue","setKeywords","path","setAltText","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;IACd,MAAM,EAAEC,CAAC,EAAE,GAAGL;IACd,MAAM,EAAEM,EAAE,EAAEC,cAAc,EAAE,GAAGV;IAC/B,MAAMW,SAAST;IACf,MAAM,CAACU,WAAWC,gBAAgB,GAAGT;IAErC,MAAM,EAAEU,UAAUC,WAAW,EAAE,GAAGd,SAAiB;QAAEe,MAAM;IAAW;IACtE,MAAM,EAAEF,UAAUG,UAAU,EAAE,GAAGhB,SAAiB;QAAEe,MAAM;IAAM;IAEhE,MAAME,wBAAwB;QAC5B,IAAI,CAACR,kBAAkB,CAACD,IAAI;YAC1BV,MAAMoB,KAAK,CAACX,EAAE;YACd,MAAM,IAAIY,MAAM;QAClB;QAEAP,gBAAgB;YACd,IAAI;gBACF,MAAMQ,WAAW,MAAMC,MAAM,iCAAiC;oBAC5DC,MAAMC,KAAKC,SAAS,CAAC;wBACnBhB,IAAIA;wBACJiB,YAAYhB;wBACZC,QAAQA,QAAQgB,QAAQ;oBAC1B;oBACAC,QAAQ;gBACV;gBAEA,IAAI,CAACP,SAASQ,EAAE,EAAE;oBAChB,IAAIC,eAAetB,EAAE;oBACrB,IAAI;wBACF,MAAMuB,YAAa,MAAMV,SAASW,IAAI;wBACtCF,eAAeC,UAAUZ,KAAK;oBAChC,EAAE,OAAOA,OAAO;wBACdc,QAAQd,KAAK,CAAC,8BAA8BA;oBAC9C;oBAEApB,MAAMoB,KAAK,CAACW;oBACZ;gBACF;gBAEA,MAAMI,OAAQ,MAAMb,SAASW,IAAI;gBAKjC,IAAIE,KAAKC,OAAO,IAAID,KAAKE,QAAQ,EAAE;oBACjCnB,WAAWiB,KAAKC,OAAO;oBACvBpB,YAAYmB,KAAKE,QAAQ;oBACzBrC,MAAMsC,OAAO,CAAC7B,EAAE;gBAClB,OAAO;oBACLT,MAAMoB,KAAK,CAACX,EAAE;gBAChB;YACF,EAAE,OAAOW,OAAO;gBACdc,QAAQd,KAAK,CAAC,8BAA8BA;gBAC5CpB,MAAMoB,KAAK,CAACX,EAAE;YAChB;QACF;IACF;IAEA,qBACE,MAAC8B;QAAIC,OAAO;YAAEC,SAAS;YAAQC,KAAK;YAAQC,WAAW;QAAO;;0BAC5D,MAACJ;gBAAIC,OAAO;oBAAEI,OAAO;oBAA8BC,MAAM;gBAAI;;kCAC3D,KAACC;kCAAGrC,EAAE;;kCACN,MAACsC;wBAAGP,OAAO;4BAAEQ,QAAQ;4BAAUC,aAAa;wBAAO;;0CACjD,KAACC;0CAAIzC,EAAE;;0CACP,KAACyC;0CAAIzC,EAAE;;0CACP,KAACyC;0CAAIzC,EAAE;;;;;;0BAGX,KAAC8B;gBAAIC,OAAO;oBAAEW,YAAY;oBAAUV,SAAS;gBAAO;0BAClD,cAAA,KAAC1C;oBACCqD,UAAUvC,aAAa,CAACH;oBACxB2C,MAAMxC,0BAAY,KAACN,6BAAa,KAACD;oBACjCgD,SAASnC;oBACToC,SACE,CAAC7C,KAAKD,EAAE,mEAAmE+C;8BAG5E/C,EAAE;;;;;AAKb"}

package/dist/endpoints/altTextHealth.d.ts

@@ -0,0 +1,3 @@
+import type { PayloadHandler } from 'payload';
+import type { AltTextPluginConfig } from '../types/AltTextPluginConfig.js';
+export declare const altTextHealthEndpoint: (access: AltTextPluginConfig["access"]) => PayloadHandler;

package/dist/endpoints/altTextHealth.js

@@ -0,0 +1,30 @@
+import { ALT_TEXT_HEALTH_PLUGIN_SLUG, getAltTextHealth } from '../utilities/altTextHealth.js';
+export const altTextHealthEndpoint = (access)=>async (req)=>{
+        if (!await access({
+            req
+        })) {
+            return Response.json({
+                error: 'Unauthorized'
+            }, {
+                status: 401
+            });
+        }
+        try {
+            const health = await getAltTextHealth(req);
+            return Response.json(health);
+        } catch (error) {
+            req.payload.logger.error({
+                err: error,
+                msg: 'Failed to build alt text health response.',
+                path: '/alt-text-plugin/health',
+                plugin: ALT_TEXT_HEALTH_PLUGIN_SLUG
+            });
+            return Response.json({
+                error: 'Failed to compute alt text health'
+            }, {
+                status: 500
+            });
+        }
+    };
+
+//# sourceMappingURL=altTextHealth.js.map

package/dist/endpoints/altTextHealth.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/endpoints/altTextHealth.ts"],"sourcesContent":["import type { PayloadHandler, PayloadRequest } from 'payload'\n\nimport type { AltTextPluginConfig } from '../types/AltTextPluginConfig.js'\n\nimport { ALT_TEXT_HEALTH_PLUGIN_SLUG, getAltTextHealth } from '../utilities/altTextHealth.js'\n\nexport const altTextHealthEndpoint =\n  (access: AltTextPluginConfig['access']): PayloadHandler =>\n  async (req: PayloadRequest) => {\n    if (!(await access({ req }))) {\n      return Response.json({ error: 'Unauthorized' }, { status: 401 })\n    }\n\n    try {\n      const health = await getAltTextHealth(req)\n\n      return Response.json(health)\n    } catch (error) {\n      req.payload.logger.error({\n        err: error,\n        msg: 'Failed to build alt text health response.',\n        path: '/alt-text-plugin/health',\n        plugin: ALT_TEXT_HEALTH_PLUGIN_SLUG,\n      })\n\n      return Response.json({ error: 'Failed to compute alt text health' }, { status: 500 })\n    }\n  }\n"],"names":["ALT_TEXT_HEALTH_PLUGIN_SLUG","getAltTextHealth","altTextHealthEndpoint","access","req","Response","json","error","status","health","payload","logger","err","msg","path","plugin"],"mappings":"AAIA,SAASA,2BAA2B,EAAEC,gBAAgB,QAAQ,gCAA+B;AAE7F,OAAO,MAAMC,wBACX,CAACC,SACD,OAAOC;QACL,IAAI,CAAE,MAAMD,OAAO;YAAEC;QAAI,IAAK;YAC5B,OAAOC,SAASC,IAAI,CAAC;gBAAEC,OAAO;YAAe,GAAG;gBAAEC,QAAQ;YAAI;QAChE;QAEA,IAAI;YACF,MAAMC,SAAS,MAAMR,iBAAiBG;YAEtC,OAAOC,SAASC,IAAI,CAACG;QACvB,EAAE,OAAOF,OAAO;YACdH,IAAIM,OAAO,CAACC,MAAM,CAACJ,KAAK,CAAC;gBACvBK,KAAKL;gBACLM,KAAK;gBACLC,MAAM;gBACNC,QAAQf;YACV;YAEA,OAAOK,SAASC,IAAI,CAAC;gBAAEC,OAAO;YAAoC,GAAG;gBAAEC,QAAQ;YAAI;QACrF;IACF,EAAC"}

package/dist/endpoints/bulkGenerateAltTexts.d.ts

@@ -1,5 +1,6 @@
 import type { PayloadHandler } from 'payload';
+import type { AltTextPluginConfig } from '../types/AltTextPluginConfig.js';
 /**
  * Generates and updates alt text for multiple images in all locales.
  */
-export declare const bulkGenerateAltTextsEndpoint: PayloadHandler;
+export declare const bulkGenerateAltTextsEndpoint: (access: AltTextPluginConfig["access"]) => PayloadHandler;