@jhb.software/payload-alt-text-plugin 0.7.0 → 0.9.0

package/dist/utilities/altTextHealth.js.map

@@ -1 +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 {\n  AltTextPluginConfig,\n  NormalizedAltTextCollectionConfig,\n} from '../types/AltTextPluginConfig.js'\n\nimport { createCachedAltTextHealthScan } from './altTextHealthCache.js'\nimport { localesFromConfig } from './localesFromConfig.js'\nimport { buildMimeTypeWhere } from './mimeTypes.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: NormalizedAltTextCollectionConfig[]\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  mimeTypes: readonly string[],\n): Promise<{ alt: unknown; id: number | string }[]> {\n  const where = buildMimeTypeWhere(mimeTypes)\n  if (!where) {\n    return []\n  }\n\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      where,\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 ({ slug, mimeTypes }): Promise<AltTextHealthScanCollection> => {\n      try {\n        const docs = await fetchAllDocs(payload, slug, isLocalized, mimeTypes)\n\n        return summarizeCollection({\n          collection: slug,\n          docs,\n          isLocalized,\n          localeCodes,\n        })\n      } catch (error) {\n        const message = error instanceof Error ? error.message : 'Unknown error'\n        const collectionError = createCollectionReadError(slug, message)\n\n        payload.logger.error({\n          collection: slug,\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: slug,\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]\n      .map(({ slug, mimeTypes }) => `${slug}:${[...mimeTypes].sort().join('|')}`)\n      .sort()\n      .join(','),\n    localeCodes.join(','),\n  ]\n\n  const tags = [\n    ALT_TEXT_HEALTH_GLOBAL_TAG,\n    ...new Set(collections.map(({ slug }) => getAltTextHealthCollectionTag(slug))),\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","buildMimeTypeWhere","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","mimeTypes","where","docs","page","hasMore","result","find","depth","fallbackLocale","undefined","limit","locale","overrideAccess","select","alt","doc","push","id","hasNextPage","computeAltTextHealthScan","collectionSummaries","Promise","all","map","slug","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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"}
+{"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 {\n  AltTextPluginConfig,\n  NormalizedAltTextCollectionConfig,\n} from '../types/AltTextPluginConfig.js'\n\nimport { createCachedAltTextHealthScan } from './altTextHealthCache.js'\nimport { localesFromConfig } from './localesFromConfig.js'\nimport { buildMimeTypeWhere } from './mimeTypes.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: NormalizedAltTextCollectionConfig[]\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  mimeTypes: readonly string[],\n): Promise<{ alt: unknown; id: number | string }[]> {\n  const where = buildMimeTypeWhere(mimeTypes)\n  if (!where) {\n    return []\n  }\n\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      where,\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 ({ slug, mimeTypes }): Promise<AltTextHealthScanCollection> => {\n      try {\n        const docs = await fetchAllDocs(payload, slug, isLocalized, mimeTypes)\n\n        return summarizeCollection({\n          collection: slug,\n          docs,\n          isLocalized,\n          localeCodes,\n        })\n      } catch (error) {\n        const message = error instanceof Error ? error.message : 'Unknown error'\n        const collectionError = createCollectionReadError(slug, message)\n\n        payload.logger.error({\n          collection: slug,\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: slug,\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]\n      .map(({ slug, mimeTypes }) => `${slug}:${[...mimeTypes].sort().join('|')}`)\n      .sort()\n      .join(','),\n    localeCodes.join(','),\n  ]\n\n  const tags = [\n    ALT_TEXT_HEALTH_GLOBAL_TAG,\n    ...new Set(collections.map(({ slug }) => getAltTextHealthCollectionTag(slug))),\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\n/**\n * Whether `req.user` is allowed to read the given collection at the collection\n * level. The collection's `read` access is evaluated with the request; `false`\n * denies, while `true` or a scoped `Where` constraint grants visibility of the\n * collection's health aggregate. A thrown access function (e.g. `Forbidden`)\n * counts as denied so a restricted collection never leaks.\n */\nasync function userCanReadCollection(req: PayloadRequest, slug: string): Promise<boolean> {\n  const readAccess = req.payload.collections?.[slug]?.config.access?.read\n\n  if (typeof readAccess !== 'function') {\n    return true\n  }\n\n  try {\n    return (await readAccess({ req })) !== false\n  } catch {\n    return false\n  }\n}\n\n/**\n * Filters a shared, elevated-access health scan down to the collections the\n * requesting user may read. The scan is computed once with `overrideAccess: true`\n * so it stays complete and cacheable; access is applied per request at\n * collection granularity, matching the aggregate's altitude.\n */\nexport async function filterScanByReadAccess(\n  req: PayloadRequest,\n  scan: AltTextHealthScan,\n): Promise<AltTextHealthScan> {\n  const visibility = await Promise.all(\n    scan.collections.map((collection) => userCanReadCollection(req, collection.collection)),\n  )\n\n  const collections = scan.collections.filter((_, index) => visibility[index])\n  const allowedSlugs = new Set(collections.map((collection) => collection.collection))\n  const errors = scan.errors.filter(\n    (error) => !error.collection || allowedSlugs.has(error.collection),\n  )\n\n  return { ...scan, collections, errors }\n}\n\n/**\n * Whether the requesting user may view the health report at all, per the\n * configured `healthCheck` access gate. The dashboard widget uses this to hide\n * itself, mirroring the gate enforced on the health endpoint.\n */\nexport async function canViewHealthReport(req: PayloadRequest): Promise<boolean> {\n  const pluginConfig = req.payload.config.custom?.altTextPluginConfig as\n    | AltTextPluginConfig\n    | undefined\n\n  if (!pluginConfig) {\n    return false\n  }\n\n  return pluginConfig.healthCheckAccess({ req })\n}\n\nexport function toWidgetData(scan: AltTextHealthScan): AltTextHealthWidgetData {\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\nexport async function getAltTextHealth(req: PayloadRequest): Promise<AltTextHealthScan> {\n  return filterScanByReadAccess(req, await getAltTextHealthScan(req))\n}\n\nexport async function getAltTextHealthWidgetData(\n  req: PayloadRequest,\n): Promise<AltTextHealthWidgetData> {\n  return toWidgetData(await filterScanByReadAccess(req, await getAltTextHealthScan(req)))\n}\n"],"names":["unstable_cache","createCachedAltTextHealthScan","localesFromConfig","buildMimeTypeWhere","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","mimeTypes","where","docs","page","hasMore","result","find","depth","fallbackLocale","undefined","limit","locale","overrideAccess","select","alt","doc","push","id","hasNextPage","computeAltTextHealthScan","collectionSummaries","Promise","all","map","slug","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","userCanReadCollection","readAccess","access","read","filterScanByReadAccess","scan","visibility","_","index","allowedSlugs","has","canViewHealthReport","healthCheckAccess","toWidgetData","localeCount","length","reduce","total","c","getAltTextHealth","getAltTextHealthWidgetData"],"mappings":"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"}

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@jhb.software/payload-alt-text-plugin",
-  "version": "0.7.0",
+  "version": "0.9.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",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jhb-software/payload-plugins"
+  },
   "keywords": [
     "payload",
     "plugin",
@@ -17,30 +20,31 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "dependencies": {
-    "openai": "^6.37.0",
-    "p-map": "^7.0.4",
+    "openai": "^6.46.0",
+    "p-map": "^7.0.5",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@payloadcms/translations": "^3.84.1",
-    "@payloadcms/ui": "^3.84.1",
+    "@payloadcms/translations": "^3.86.0",
+    "@payloadcms/ui": "^3.86.0",
     "next": "^15.0.0 || ^16.0.0",
-    "payload": "^3.84.1",
-    "react": "19.2.6",
-    "react-dom": "19.2.6"
+    "payload": "^3.86.0",
+    "react": "19.2.7",
+    "react-dom": "19.2.7"
   },
   "devDependencies": {
     "@payloadcms/eslint-config": "^3.28.0",
-    "@payloadcms/translations": "^3.84.1",
+    "@payloadcms/translations": "^3.86.0",
     "@swc/cli": "^0.8.1",
-    "@swc/core": "^1.15.33",
-    "@types/react": "19.2.14",
+    "@swc/core": "^1.15.43",
+    "@types/react": "19.2.17",
     "@types/react-dom": "19.2.3",
     "copyfiles": "2.4.1",
     "eslint": "^9.39.4",
-    "prettier": "^3.8.3",
+    "prettier": "^3.8.4",
     "rimraf": "6.1.3",
-    "typescript": "^6.0.3"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10"
   },
   "files": [
     "dist"
@@ -75,8 +79,7 @@
     "format": "prettier --write src \"*.{json,md,js,mjs,cjs}\"",
     "lint": "eslint src",
     "lint:fix": "eslint src --fix",
-    "test": "node --experimental-strip-types --test test/*.test.ts",
-    "test:health": "node --experimental-strip-types --test test/altTextHealth.test.ts",
+    "test": "vitest run",
     "typecheck": "tsc --noEmit"
   }
 }