@jhb.software/payload-alt-text-plugin 0.3.0 → 0.4.0

package/dist/utilities/altTextHealth.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/altTextHealth.ts"],"sourcesContent":["import type { Payload, PayloadRequest } from 'payload'\n\nimport { unstable_cache } from 'next/cache.js'\n\nimport type { AltTextPluginConfig } from '../types/AltTextPluginConfig.js'\n\nimport { createCachedAltTextHealthScan } from './altTextHealthCache.js'\nimport { localesFromConfig } from './localesFromConfig.js'\nimport { summarizeCollection } from './summarizeCollection.js'\n\nexport const ALT_TEXT_HEALTH_PLUGIN_SLUG = 'alt-text'\nexport const ALT_TEXT_HEALTH_CACHE_TTL = 3600\nexport const ALT_TEXT_HEALTH_GLOBAL_TAG = 'alt-text-health'\n\nexport type AltTextHealthErrorCode =\n  | 'ALT_TEXT_COLLECTION_READ_FAILED'\n  | 'ALT_TEXT_PLUGIN_CONFIG_MISSING'\n\nexport type AltTextHealthError = {\n  code: AltTextHealthErrorCode\n  collection?: string\n  message: string\n  operation?: 'find'\n}\n\nexport type AltTextHealthScanCollection = {\n  collection: string\n  completeDocs: number\n  error?: AltTextHealthError\n  invalidDocIds: (number | string)[] | undefined\n  missingDocs: number\n  partialDocs: number\n  totalDocs: number\n}\n\nexport type AltTextHealthScan = {\n  checkedAt: string\n  collections: AltTextHealthScanCollection[]\n  errors: AltTextHealthError[]\n  isLocalized: boolean\n  localeCodes: string[]\n}\n\nexport type AltTextHealthWidgetData = {\n  collections: AltTextHealthScanCollection[]\n  errors: AltTextHealthError[]\n  isLocalized: boolean\n  localeCount: number\n  totalDocs: number\n}\n\ntype AltTextHealthComputationArgs = {\n  collections: string[]\n  isLocalized: boolean\n  localeCodes: string[]\n  payload: Payload\n}\n\nconst createUnknownScan = ({\n  error,\n  isLocalized,\n  localeCodes,\n}: {\n  error: AltTextHealthScan['errors'][number]\n  isLocalized: boolean\n  localeCodes: string[]\n}): AltTextHealthScan => ({\n  checkedAt: new Date().toISOString(),\n  collections: [],\n  errors: [error],\n  isLocalized,\n  localeCodes,\n})\n\nconst createCollectionReadError = (collection: string, message: string) => ({\n  code: 'ALT_TEXT_COLLECTION_READ_FAILED' as const,\n  collection,\n  message,\n  operation: 'find' as const,\n})\n\nconst PAGE_SIZE = 500\n\nasync function fetchAllDocs(\n  payload: Payload,\n  collection: string,\n  isLocalized: boolean,\n): Promise<{ alt: unknown; id: number | string }[]> {\n  const docs: { alt: unknown; id: number | string }[] = []\n  let page = 1\n  let hasMore = true\n\n  while (hasMore) {\n    const result = await payload.find({\n      collection,\n      depth: 0,\n      fallbackLocale: isLocalized ? false : undefined,\n      limit: PAGE_SIZE,\n      locale: isLocalized ? 'all' : undefined,\n      overrideAccess: true,\n      page,\n      select: {\n        alt: true,\n      },\n    })\n\n    for (const doc of result.docs) {\n      docs.push({\n        id: doc.id,\n        alt: 'alt' in doc ? doc.alt : undefined,\n      })\n    }\n\n    hasMore = result.hasNextPage\n    page++\n  }\n\n  return docs\n}\n\nasync function computeAltTextHealthScan({\n  collections,\n  isLocalized,\n  localeCodes,\n  payload,\n}: AltTextHealthComputationArgs): Promise<AltTextHealthScan> {\n  const collectionSummaries = await Promise.all(\n    collections.map(async (collection): Promise<AltTextHealthScanCollection> => {\n      try {\n        const docs = await fetchAllDocs(payload, collection, isLocalized)\n\n        return summarizeCollection({\n          collection,\n          docs,\n          isLocalized,\n          localeCodes,\n        })\n      } catch (error) {\n        const message = error instanceof Error ? error.message : 'Unknown error'\n        const collectionError = createCollectionReadError(collection, message)\n\n        payload.logger.error({\n          collection,\n          err: error,\n          msg: 'Alt text health check failed while reading a collection.',\n          operation: 'find',\n          plugin: ALT_TEXT_HEALTH_PLUGIN_SLUG,\n        })\n\n        return {\n          collection,\n          completeDocs: 0,\n          error: collectionError,\n          invalidDocIds: undefined,\n          missingDocs: 0,\n          partialDocs: 0,\n          totalDocs: 0,\n        }\n      }\n    }),\n  )\n\n  const errors = collectionSummaries\n    .filter((summary) => summary.error)\n    .map((summary) => summary.error!)\n\n  return {\n    checkedAt: new Date().toISOString(),\n    collections: collectionSummaries,\n    errors,\n    isLocalized,\n    localeCodes,\n  }\n}\n\nexport const getAltTextHealthCollectionTag = (collectionSlug: string): string =>\n  `${ALT_TEXT_HEALTH_GLOBAL_TAG}:${collectionSlug}`\n\nasync function getAltTextHealthScan(req: PayloadRequest): Promise<AltTextHealthScan> {\n  const { payload } = req\n  const pluginConfig = payload.config.custom?.altTextPluginConfig as AltTextPluginConfig | undefined\n  const localeCodes =\n    localesFromConfig(payload.config) ?? (pluginConfig?.locale ? [pluginConfig.locale] : [])\n  const isLocalized = Boolean(payload.config.localization)\n\n  if (!pluginConfig) {\n    return createUnknownScan({\n      error: {\n        code: 'ALT_TEXT_PLUGIN_CONFIG_MISSING',\n        message: 'Alt text plugin config not found',\n      },\n      isLocalized,\n      localeCodes,\n    })\n  }\n\n  const collections = pluginConfig.collections\n\n  const cacheKeyParts = [\n    ALT_TEXT_HEALTH_GLOBAL_TAG,\n    [...collections].sort().join(','),\n    localeCodes.join(','),\n  ]\n\n  const tags = [\n    ALT_TEXT_HEALTH_GLOBAL_TAG,\n    ...new Set(collections.map((collection) => getAltTextHealthCollectionTag(collection))),\n  ]\n\n  const getCachedHealthScan = createCachedAltTextHealthScan({\n    cacheFactory: unstable_cache,\n    cacheKeyParts,\n    compute: async () =>\n      computeAltTextHealthScan({\n        collections,\n        isLocalized,\n        localeCodes,\n        payload,\n      }),\n    revalidate: ALT_TEXT_HEALTH_CACHE_TTL,\n    tags,\n  })\n\n  return getCachedHealthScan()\n}\n\nexport async function getAltTextHealth(req: PayloadRequest): Promise<AltTextHealthScan> {\n  return getAltTextHealthScan(req)\n}\n\nexport async function getAltTextHealthWidgetData(\n  req: PayloadRequest,\n): Promise<AltTextHealthWidgetData> {\n  const scan = await getAltTextHealthScan(req)\n\n  return {\n    collections: scan.collections,\n    errors: scan.errors,\n    isLocalized: scan.isLocalized,\n    localeCount: scan.localeCodes.length,\n    totalDocs: scan.collections.reduce((total, c) => total + c.totalDocs, 0),\n  }\n}\n"],"names":["unstable_cache","createCachedAltTextHealthScan","localesFromConfig","summarizeCollection","ALT_TEXT_HEALTH_PLUGIN_SLUG","ALT_TEXT_HEALTH_CACHE_TTL","ALT_TEXT_HEALTH_GLOBAL_TAG","createUnknownScan","error","isLocalized","localeCodes","checkedAt","Date","toISOString","collections","errors","createCollectionReadError","collection","message","code","operation","PAGE_SIZE","fetchAllDocs","payload","docs","page","hasMore","result","find","depth","fallbackLocale","undefined","limit","locale","overrideAccess","select","alt","doc","push","id","hasNextPage","computeAltTextHealthScan","collectionSummaries","Promise","all","map","Error","collectionError","logger","err","msg","plugin","completeDocs","invalidDocIds","missingDocs","partialDocs","totalDocs","filter","summary","getAltTextHealthCollectionTag","collectionSlug","getAltTextHealthScan","req","pluginConfig","config","custom","altTextPluginConfig","Boolean","localization","cacheKeyParts","sort","join","tags","Set","getCachedHealthScan","cacheFactory","compute","revalidate","getAltTextHealth","getAltTextHealthWidgetData","scan","localeCount","length","reduce","total","c"],"mappings":"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"}

package/dist/utilities/altTextHealthCache.d.ts

@@ -0,0 +1,11 @@
+export type AltTextHealthCacheFactory<T> = (compute: () => Promise<T>, cacheKeyParts: string[], options: {
+    revalidate: number;
+    tags: string[];
+}) => () => Promise<T>;
+export declare function createCachedAltTextHealthScan<T>({ cacheFactory, cacheKeyParts, compute, revalidate, tags, }: {
+    cacheFactory: AltTextHealthCacheFactory<T>;
+    cacheKeyParts: string[];
+    compute: () => Promise<T>;
+    revalidate: number;
+    tags: string[];
+}): () => Promise<T>;

package/dist/utilities/altTextHealthCache.js

@@ -0,0 +1,8 @@
+export function createCachedAltTextHealthScan({ cacheFactory, cacheKeyParts, compute, revalidate, tags }) {
+    return cacheFactory(compute, cacheKeyParts, {
+        revalidate,
+        tags
+    });
+}
+
+//# sourceMappingURL=altTextHealthCache.js.map

package/dist/utilities/altTextHealthCache.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/altTextHealthCache.ts"],"sourcesContent":["export type AltTextHealthCacheFactory<T> = (\n  compute: () => Promise<T>,\n  cacheKeyParts: string[],\n  options: {\n    revalidate: number\n    tags: string[]\n  },\n) => () => Promise<T>\n\nexport function createCachedAltTextHealthScan<T>({\n  cacheFactory,\n  cacheKeyParts,\n  compute,\n  revalidate,\n  tags,\n}: {\n  cacheFactory: AltTextHealthCacheFactory<T>\n  cacheKeyParts: string[]\n  compute: () => Promise<T>\n  revalidate: number\n  tags: string[]\n}): () => Promise<T> {\n  return cacheFactory(compute, cacheKeyParts, {\n    revalidate,\n    tags,\n  })\n}\n"],"names":["createCachedAltTextHealthScan","cacheFactory","cacheKeyParts","compute","revalidate","tags"],"mappings":"AASA,OAAO,SAASA,8BAAiC,EAC/CC,YAAY,EACZC,aAAa,EACbC,OAAO,EACPC,UAAU,EACVC,IAAI,EAOL;IACC,OAAOJ,aAAaE,SAASD,eAAe;QAC1CE;QACAC;IACF;AACF"}

package/dist/utilities/altTextHealthWidgetDisplay.d.ts

@@ -0,0 +1,6 @@
+export type AltTextHealthWidgetDisplayState = 'healthy' | 'unavailable' | 'unhealthy';
+export declare function getAltTextHealthWidgetDisplayState(collection: Pick<{
+    error?: unknown;
+    missingDocs: number;
+    partialDocs: number;
+}, 'error' | 'missingDocs' | 'partialDocs'>): AltTextHealthWidgetDisplayState;

package/dist/utilities/altTextHealthWidgetDisplay.js

@@ -0,0 +1,11 @@
+export function getAltTextHealthWidgetDisplayState(collection) {
+    if (collection.error) {
+        return 'unavailable';
+    }
+    if (collection.missingDocs + collection.partialDocs > 0) {
+        return 'unhealthy';
+    }
+    return 'healthy';
+}
+
+//# sourceMappingURL=altTextHealthWidgetDisplay.js.map

package/dist/utilities/altTextHealthWidgetDisplay.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/altTextHealthWidgetDisplay.ts"],"sourcesContent":["export type AltTextHealthWidgetDisplayState = 'healthy' | 'unavailable' | 'unhealthy'\n\nexport function getAltTextHealthWidgetDisplayState(\n  collection: Pick<\n    { error?: unknown; missingDocs: number; partialDocs: number },\n    'error' | 'missingDocs' | 'partialDocs'\n  >,\n): AltTextHealthWidgetDisplayState {\n  if (collection.error) {\n    return 'unavailable'\n  }\n\n  if (collection.missingDocs + collection.partialDocs > 0) {\n    return 'unhealthy'\n  }\n\n  return 'healthy'\n}\n"],"names":["getAltTextHealthWidgetDisplayState","collection","error","missingDocs","partialDocs"],"mappings":"AAEA,OAAO,SAASA,mCACdC,UAGC;IAED,IAAIA,WAAWC,KAAK,EAAE;QACpB,OAAO;IACT;IAEA,IAAID,WAAWE,WAAW,GAAGF,WAAWG,WAAW,GAAG,GAAG;QACvD,OAAO;IACT;IAEA,OAAO;AACT"}

package/dist/utilities/getCollectionLabel.d.ts

@@ -0,0 +1,2 @@
+import type { SanitizedCollectionConfig } from 'payload';
+export declare function getCollectionLabel(slug: string, collections: SanitizedCollectionConfig[], locale: null | string | undefined): string;

package/dist/utilities/getCollectionLabel.js

@@ -0,0 +1,17 @@
+export function getCollectionLabel(slug, collections, locale) {
+    const collectionConfig = collections.find((c)=>c.slug === slug);
+    if (!collectionConfig?.labels?.plural) {
+        return slug;
+    }
+    const label = collectionConfig.labels.plural;
+    if (typeof label === 'string') {
+        return label;
+    }
+    if (typeof label === 'function') {
+        return slug;
+    }
+    const record = label;
+    return record[locale] ?? record[Object.keys(record)[0]] ?? slug;
+}
+
+//# sourceMappingURL=getCollectionLabel.js.map

package/dist/utilities/getCollectionLabel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/getCollectionLabel.ts"],"sourcesContent":["import type { SanitizedCollectionConfig } from 'payload'\n\nexport function getCollectionLabel(\n  slug: string,\n  collections: SanitizedCollectionConfig[],\n  locale: null | string | undefined,\n): string {\n  const collectionConfig = collections.find((c) => c.slug === slug)\n\n  if (!collectionConfig?.labels?.plural) {\n    return slug\n  }\n\n  const label = collectionConfig.labels.plural\n\n  if (typeof label === 'string') {\n    return label\n  }\n\n  if (typeof label === 'function') {\n    return slug\n  }\n\n  const record = label as Record<string, string>\n\n  return record[locale as string] ?? record[Object.keys(record)[0]] ?? slug\n}\n"],"names":["getCollectionLabel","slug","collections","locale","collectionConfig","find","c","labels","plural","label","record","Object","keys"],"mappings":"AAEA,OAAO,SAASA,mBACdC,IAAY,EACZC,WAAwC,EACxCC,MAAiC;IAEjC,MAAMC,mBAAmBF,YAAYG,IAAI,CAAC,CAACC,IAAMA,EAAEL,IAAI,KAAKA;IAE5D,IAAI,CAACG,kBAAkBG,QAAQC,QAAQ;QACrC,OAAOP;IACT;IAEA,MAAMQ,QAAQL,iBAAiBG,MAAM,CAACC,MAAM;IAE5C,IAAI,OAAOC,UAAU,UAAU;QAC7B,OAAOA;IACT;IAEA,IAAI,OAAOA,UAAU,YAAY;QAC/B,OAAOR;IACT;IAEA,MAAMS,SAASD;IAEf,OAAOC,MAAM,CAACP,OAAiB,IAAIO,MAAM,CAACC,OAAOC,IAAI,CAACF,OAAO,CAAC,EAAE,CAAC,IAAIT;AACvE"}

package/dist/utilities/summarizeCollection.d.ts

@@ -0,0 +1,17 @@
+export declare const MAX_INVALID_DOC_IDS = 100;
+export declare function summarizeCollection({ collection, docs, isLocalized, localeCodes, }: {
+    collection: string;
+    docs: {
+        alt: unknown;
+        id: number | string;
+    }[];
+    isLocalized: boolean;
+    localeCodes: string[];
+}): {
+    collection: string;
+    completeDocs: number;
+    invalidDocIds: (string | number)[] | undefined;
+    missingDocs: number;
+    partialDocs: number;
+    totalDocs: number;
+};

package/dist/utilities/summarizeCollection.js

@@ -0,0 +1,62 @@
+export const MAX_INVALID_DOC_IDS = 100;
+const isRecord = (value)=>typeof value === 'object' && value !== null && !Array.isArray(value);
+const hasAltValue = (value)=>typeof value === 'string' && value.trim().length > 0;
+const countFilledLocales = (altValue, localeCodes)=>{
+    if (!isRecord(altValue)) {
+        return 0;
+    }
+    return localeCodes.filter((localeCode)=>hasAltValue(altValue[localeCode])).length;
+};
+export function summarizeCollection({ collection, docs, isLocalized, localeCodes }) {
+    let completeDocs = 0;
+    let missingDocs = 0;
+    let partialDocs = 0;
+    let invalidDocIds = [];
+    let invalidOverflow = false;
+    for (const doc of docs){
+        if (!isLocalized) {
+            if (hasAltValue(doc.alt)) {
+                completeDocs++;
+            } else {
+                missingDocs++;
+                if (!invalidOverflow) {
+                    if (invalidDocIds.length < MAX_INVALID_DOC_IDS) {
+                        invalidDocIds.push(doc.id);
+                    } else {
+                        invalidDocIds = undefined;
+                        invalidOverflow = true;
+                    }
+                }
+            }
+            continue;
+        }
+        const filledLocales = countFilledLocales(doc.alt, localeCodes);
+        if (filledLocales === localeCodes.length) {
+            completeDocs++;
+        } else {
+            if (filledLocales === 0) {
+                missingDocs++;
+            } else {
+                partialDocs++;
+            }
+            if (!invalidOverflow) {
+                if (invalidDocIds.length < MAX_INVALID_DOC_IDS) {
+                    invalidDocIds.push(doc.id);
+                } else {
+                    invalidDocIds = undefined;
+                    invalidOverflow = true;
+                }
+            }
+        }
+    }
+    return {
+        collection,
+        completeDocs,
+        invalidDocIds,
+        missingDocs,
+        partialDocs,
+        totalDocs: docs.length
+    };
+}
+
+//# sourceMappingURL=summarizeCollection.js.map

package/dist/utilities/summarizeCollection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/summarizeCollection.ts"],"sourcesContent":["export const MAX_INVALID_DOC_IDS = 100\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\nconst hasAltValue = (value: unknown): boolean =>\n  typeof value === 'string' && value.trim().length > 0\n\nconst countFilledLocales = (altValue: unknown, localeCodes: string[]): number => {\n  if (!isRecord(altValue)) {\n    return 0\n  }\n\n  return localeCodes.filter((localeCode) => hasAltValue(altValue[localeCode])).length\n}\n\nexport function summarizeCollection({\n  collection,\n  docs,\n  isLocalized,\n  localeCodes,\n}: {\n  collection: string\n  docs: { alt: unknown; id: number | string }[]\n  isLocalized: boolean\n  localeCodes: string[]\n}) {\n  let completeDocs = 0\n  let missingDocs = 0\n  let partialDocs = 0\n  let invalidDocIds: (number | string)[] | undefined = []\n  let invalidOverflow = false\n\n  for (const doc of docs) {\n    if (!isLocalized) {\n      if (hasAltValue(doc.alt)) {\n        completeDocs++\n      } else {\n        missingDocs++\n        if (!invalidOverflow) {\n          if (invalidDocIds!.length < MAX_INVALID_DOC_IDS) {\n            invalidDocIds!.push(doc.id)\n          } else {\n            invalidDocIds = undefined\n            invalidOverflow = true\n          }\n        }\n      }\n\n      continue\n    }\n\n    const filledLocales = countFilledLocales(doc.alt, localeCodes)\n\n    if (filledLocales === localeCodes.length) {\n      completeDocs++\n    } else {\n      if (filledLocales === 0) {\n        missingDocs++\n      } else {\n        partialDocs++\n      }\n\n      if (!invalidOverflow) {\n        if (invalidDocIds!.length < MAX_INVALID_DOC_IDS) {\n          invalidDocIds!.push(doc.id)\n        } else {\n          invalidDocIds = undefined\n          invalidOverflow = true\n        }\n      }\n    }\n  }\n\n  return {\n    collection,\n    completeDocs,\n    invalidDocIds,\n    missingDocs,\n    partialDocs,\n    totalDocs: docs.length,\n  }\n}\n"],"names":["MAX_INVALID_DOC_IDS","isRecord","value","Array","isArray","hasAltValue","trim","length","countFilledLocales","altValue","localeCodes","filter","localeCode","summarizeCollection","collection","docs","isLocalized","completeDocs","missingDocs","partialDocs","invalidDocIds","invalidOverflow","doc","alt","push","id","undefined","filledLocales","totalDocs"],"mappings":"AAAA,OAAO,MAAMA,sBAAsB,IAAG;AAEtC,MAAMC,WAAW,CAACC,QAChB,OAAOA,UAAU,YAAYA,UAAU,QAAQ,CAACC,MAAMC,OAAO,CAACF;AAEhE,MAAMG,cAAc,CAACH,QACnB,OAAOA,UAAU,YAAYA,MAAMI,IAAI,GAAGC,MAAM,GAAG;AAErD,MAAMC,qBAAqB,CAACC,UAAmBC;IAC7C,IAAI,CAACT,SAASQ,WAAW;QACvB,OAAO;IACT;IAEA,OAAOC,YAAYC,MAAM,CAAC,CAACC,aAAeP,YAAYI,QAAQ,CAACG,WAAW,GAAGL,MAAM;AACrF;AAEA,OAAO,SAASM,oBAAoB,EAClCC,UAAU,EACVC,IAAI,EACJC,WAAW,EACXN,WAAW,EAMZ;IACC,IAAIO,eAAe;IACnB,IAAIC,cAAc;IAClB,IAAIC,cAAc;IAClB,IAAIC,gBAAiD,EAAE;IACvD,IAAIC,kBAAkB;IAEtB,KAAK,MAAMC,OAAOP,KAAM;QACtB,IAAI,CAACC,aAAa;YAChB,IAAIX,YAAYiB,IAAIC,GAAG,GAAG;gBACxBN;YACF,OAAO;gBACLC;gBACA,IAAI,CAACG,iBAAiB;oBACpB,IAAID,cAAeb,MAAM,GAAGP,qBAAqB;wBAC/CoB,cAAeI,IAAI,CAACF,IAAIG,EAAE;oBAC5B,OAAO;wBACLL,gBAAgBM;wBAChBL,kBAAkB;oBACpB;gBACF;YACF;YAEA;QACF;QAEA,MAAMM,gBAAgBnB,mBAAmBc,IAAIC,GAAG,EAAEb;QAElD,IAAIiB,kBAAkBjB,YAAYH,MAAM,EAAE;YACxCU;QACF,OAAO;YACL,IAAIU,kBAAkB,GAAG;gBACvBT;YACF,OAAO;gBACLC;YACF;YAEA,IAAI,CAACE,iBAAiB;gBACpB,IAAID,cAAeb,MAAM,GAAGP,qBAAqB;oBAC/CoB,cAAeI,IAAI,CAACF,IAAIG,EAAE;gBAC5B,OAAO;oBACLL,gBAAgBM;oBAChBL,kBAAkB;gBACpB;YACF;QACF;IACF;IAEA,OAAO;QACLP;QACAG;QACAG;QACAF;QACAC;QACAS,WAAWb,KAAKR,MAAM;IACxB;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jhb.software/payload-alt-text-plugin",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "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",
@@ -14,68 +14,89 @@
   "author": "JHB Software",
   "license": "MIT",
   "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "scripts": {
+    "build": "pnpm copyfiles && pnpm build:types && pnpm build:swc",
+    "build:swc": "swc ./src -d ./dist --config-file .swcrc --strip-leading-paths",
+    "build:types": "tsc --outDir dist --rootDir ./src",
+    "copyfiles": "copyfiles -u 1 \"src/**/*.{html,css,scss,ttf,woff,woff2,eot,svg,jpg,png,json}\" dist/",
+    "clean": "rimraf --glob {dist,*.tsbuildinfo}",
+    "dev": "tsc -w",
+    "format": "prettier --write src",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "test:health": "node --experimental-strip-types --test test/altTextHealth.test.ts",
+    "prepublishOnly": "pnpm clean && pnpm build"
+  },
   "dependencies": {
-    "openai": "^6.9.1",
+    "openai": "^6.33.0",
     "p-map": "^7.0.4",
-    "zod": "^4.1.13"
+    "zod": "^4.3.6"
   },
   "peerDependencies": {
-    "@payloadcms/ui": "^3.65.0",
-    "next": "15.5.6",
-    "payload": "^3.65.0",
-    "react": "19.2.0",
-    "react-dom": "19.2.0"
+    "@payloadcms/ui": "^3.81.0",
+    "next": "15.4.11",
+    "payload": "^3.81.0",
+    "react": "19.2.4",
+    "react-dom": "19.2.4"
   },
   "devDependencies": {
     "@payloadcms/eslint-config": "^3.28.0",
-    "@swc/cli": "^0.7.9",
-    "@swc/core": "^1.15.3",
-    "@types/react": "19.2.7",
+    "@swc/cli": "^0.8.1",
+    "@swc/core": "^1.15.24",
+    "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
     "copyfiles": "2.4.1",
-    "eslint": "^9.39.1",
-    "prettier": "^3.7.3",
-    "rimraf": "6.1.2",
+    "eslint": "^9.0.0",
+    "prettier": "^3.8.1",
+    "rimraf": "6.1.3",
     "typescript": "5.9.3"
   },
   "files": [
     "dist"
   ],
   "publishConfig": {
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
     "registry": "https://registry.npmjs.org/",
-    "access": "public"
+    "access": "public",
+    "exports": {
+      ".": {
+        "import": "./dist/index.js",
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "./client": {
+        "import": "./dist/exports/client.js",
+        "types": "./dist/exports/client.d.ts",
+        "default": "./dist/exports/client.js"
+      },
+      "./server": {
+        "import": "./dist/exports/server.js",
+        "types": "./dist/exports/server.d.ts",
+        "default": "./dist/exports/server.js"
+      }
+    }
   },
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
+      "import": "./src/index.ts",
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
     },
     "./client": {
-      "import": "./dist/exports/client.js",
-      "types": "./dist/exports/client.d.ts",
-      "default": "./dist/exports/client.js"
+      "import": "./src/exports/client.ts",
+      "types": "./src/exports/client.ts",
+      "default": "./src/exports/client.ts"
     },
     "./server": {
-      "import": "./dist/exports/server.js",
-      "types": "./dist/exports/server.d.ts",
-      "default": "./dist/exports/server.js"
+      "import": "./src/exports/server.ts",
+      "types": "./src/exports/server.ts",
+      "default": "./src/exports/server.ts"
     }
   },
   "engines": {
     "node": "^18.20.2 || >=20.9.0"
-  },
-  "scripts": {
-    "build": "pnpm copyfiles && pnpm build:types && pnpm build:swc",
-    "build:swc": "swc ./src -d ./dist --config-file .swcrc --strip-leading-paths",
-    "build:types": "tsc --outDir dist --rootDir ./src",
-    "copyfiles": "copyfiles -u 1 \"src/**/*.{html,css,scss,ttf,woff,woff2,eot,svg,jpg,png,json}\" dist/",
-    "clean": "rimraf --glob {dist,*.tsbuildinfo}",
-    "dev": "tsc -w",
-    "format": "prettier --write src",
-    "lint": "eslint src",
-    "lint:fix": "eslint src --fix"
   }
-}
+}

package/dist/utils/usePluginTranslation.d.ts

@@ -1,5 +0,0 @@
-import type { PluginAltTextTranslationKeys } from 'src/translations/index.js';
-/** Hook which returns a translation function for the plugin translations. */
-export declare const usePluginTranslation: () => {
-    t: (key: PluginAltTextTranslationKeys) => string;
-};

package/dist/utils/usePluginTranslation.js

@@ -1,16 +0,0 @@
-import { useTranslation } from '@payloadcms/ui';
-/** Hook which returns a translation function for the plugin translations. */ export const usePluginTranslation = ()=>{
-    const { i18n } = useTranslation();
-    const pluginTranslations = i18n.translations['@jhb.software/payload-alt-text-plugin'];
-    return {
-        t: (key)=>{
-            const translation = pluginTranslations[key];
-            if (!translation) {
-                console.error('Plugin translation not found', key);
-            }
-            return translation ?? key;
-        }
-    };
-};
-
-//# sourceMappingURL=usePluginTranslation.js.map

package/dist/utils/usePluginTranslation.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utils/usePluginTranslation.ts"],"sourcesContent":["import type {\n  PluginAltTextTranslationKeys,\n  PluginAltTextTranslations,\n} from 'src/translations/index.js'\n\nimport { useTranslation } from '@payloadcms/ui'\n\n/** Hook which returns a translation function for the plugin translations. */\nexport const usePluginTranslation = () => {\n  const { i18n } = useTranslation<PluginAltTextTranslations, PluginAltTextTranslationKeys>()\n  const pluginTranslations = i18n.translations[\n    '@jhb.software/payload-alt-text-plugin'\n  ] as PluginAltTextTranslations\n\n  return {\n    t: (key: PluginAltTextTranslationKeys) => {\n      const translation = pluginTranslations[key] as string\n\n      if (!translation) {\n        console.error('Plugin translation not found', key)\n      }\n      return translation ?? key\n    },\n  }\n}\n"],"names":["useTranslation","usePluginTranslation","i18n","pluginTranslations","translations","t","key","translation","console","error"],"mappings":"AAKA,SAASA,cAAc,QAAQ,iBAAgB;AAE/C,2EAA2E,GAC3E,OAAO,MAAMC,uBAAuB;IAClC,MAAM,EAAEC,IAAI,EAAE,GAAGF;IACjB,MAAMG,qBAAqBD,KAAKE,YAAY,CAC1C,wCACD;IAED,OAAO;QACLC,GAAG,CAACC;YACF,MAAMC,cAAcJ,kBAAkB,CAACG,IAAI;YAE3C,IAAI,CAACC,aAAa;gBAChBC,QAAQC,KAAK,CAAC,gCAAgCH;YAChD;YACA,OAAOC,eAAeD;QACxB;IACF;AACF,EAAC"}