@pro-laico/payload-images 0.0.0

package/dist/variants/key.js

@@ -0,0 +1,29 @@
+/**
+ * Deterministic cache key for a generated variant. Folds in the source identity
+ * (`id` + `filename`) + focal point so a re-upload or focal edit yields a new key,
+ * and the transform params + the *resolved* output format so each distinct render
+ * is its own variant.
+ *
+ * Keying on `filename` (not `updatedAt`) deliberately matches what
+ * `purgeStaleVariantsAfterChange` triggers on — a file replacement or focal edit.
+ * So a metadata-only edit (e.g. `alt`) bumps `updatedAt` but leaves the key (and the
+ * stored variants) intact: keys go stale exactly when the purge hook also fires, so
+ * unreachable variants are removed in lockstep rather than orphaned.
+ */ import { createHash } from "node:crypto";
+export const variantCacheKey = (doc, p, resolvedFormat)=>{
+    const q = resolvedFormat === 'png' ? 0 : p.q;
+    const raw = [
+        String(doc.id),
+        doc.filename ?? '',
+        p.w ?? '',
+        p.h ?? '',
+        p.fit,
+        q,
+        resolvedFormat,
+        doc.focalX ?? 50,
+        doc.focalY ?? 50
+    ].join('|');
+    return createHash('sha256').update(raw).digest('hex').slice(0, 24);
+};
+
+//# sourceMappingURL=key.js.map

package/dist/variants/key.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/variants/key.ts"],"sourcesContent":["/**\n * Deterministic cache key for a generated variant. Folds in the source identity\n * (`id` + `filename`) + focal point so a re-upload or focal edit yields a new key,\n * and the transform params + the *resolved* output format so each distinct render\n * is its own variant.\n *\n * Keying on `filename` (not `updatedAt`) deliberately matches what\n * `purgeStaleVariantsAfterChange` triggers on — a file replacement or focal edit.\n * So a metadata-only edit (e.g. `alt`) bumps `updatedAt` but leaves the key (and the\n * stored variants) intact: keys go stale exactly when the purge hook also fires, so\n * unreachable variants are removed in lockstep rather than orphaned.\n */\nimport { createHash } from 'node:crypto'\n\nimport type { ParsedParams } from '../transform/params'\n\nexport interface CacheKeyDoc {\n  id: string | number\n  filename?: string | null\n  focalX?: number | null\n  focalY?: number | null\n}\n\nexport const variantCacheKey = (doc: CacheKeyDoc, p: ParsedParams, resolvedFormat: string): string => {\n  const q = resolvedFormat === 'png' ? 0 : p.q\n  const raw = [String(doc.id), doc.filename ?? '', p.w ?? '', p.h ?? '', p.fit, q, resolvedFormat, doc.focalX ?? 50, doc.focalY ?? 50].join('|')\n  return createHash('sha256').update(raw).digest('hex').slice(0, 24)\n}\n"],"names":["createHash","variantCacheKey","doc","p","resolvedFormat","q","raw","String","id","filename","w","h","fit","focalX","focalY","join","update","digest","slice"],"mappings":"AAAA;;;;;;;;;;;CAWC,GACD,SAASA,UAAU,QAAQ,cAAa;AAWxC,OAAO,MAAMC,kBAAkB,CAACC,KAAkBC,GAAiBC;IACjE,MAAMC,IAAID,mBAAmB,QAAQ,IAAID,EAAEE,CAAC;IAC5C,MAAMC,MAAM;QAACC,OAAOL,IAAIM,EAAE;QAAGN,IAAIO,QAAQ,IAAI;QAAIN,EAAEO,CAAC,IAAI;QAAIP,EAAEQ,CAAC,IAAI;QAAIR,EAAES,GAAG;QAAEP;QAAGD;QAAgBF,IAAIW,MAAM,IAAI;QAAIX,IAAIY,MAAM,IAAI;KAAG,CAACC,IAAI,CAAC;IAC1I,OAAOf,WAAW,UAAUgB,MAAM,CAACV,KAAKW,MAAM,CAAC,OAAOC,KAAK,CAAC,GAAG;AACjE,EAAC"}

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "@pro-laico/payload-images",
+  "version": "0.0.0",
+  "description": "Image optimization for Payload CMS: an Images upload collection that stores only the original, an on-demand Sharp transform endpoint (focal-aware crop, format negotiation, built-in LQIP placeholders), a durable variant cache with two-way purge, an admin focal-point picker, and a responsive <ResponsiveImage> component.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pro-laico/payload-plugins.git",
+    "directory": "packages/payload-images"
+  },
+  "keywords": [
+    "payload",
+    "payloadcms",
+    "plugin",
+    "image",
+    "images",
+    "sharp",
+    "optimization",
+    "webp",
+    "avif",
+    "responsive"
+  ],
+  "sideEffects": false,
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./components/image": {
+      "types": "./dist/components/image.d.ts",
+      "import": "./dist/components/image.js",
+      "default": "./dist/components/image.js"
+    },
+    "./utils/urls": {
+      "types": "./dist/utils/urls.d.ts",
+      "import": "./dist/utils/urls.js",
+      "default": "./dist/utils/urls.js"
+    },
+    "./admin/focalPreview": {
+      "types": "./dist/components/admin/focalPreview.d.ts",
+      "import": "./dist/components/admin/focalPreview.js",
+      "default": "./dist/components/admin/focalPreview.js"
+    },
+    "./admin/purgeVariants": {
+      "types": "./dist/components/admin/purgeVariants.d.ts",
+      "import": "./dist/components/admin/purgeVariants.js",
+      "default": "./dist/components/admin/purgeVariants.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@payloadcms/ui": "^3.0.0",
+    "next": ">=15.0.0",
+    "payload": "^3.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "sharp": ">=0.33.0"
+  },
+  "peerDependenciesMeta": {
+    "sharp": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@payloadcms/ui": "^3.85.1",
+    "@types/node": "^26.0.1",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "next": "^16.2.9",
+    "payload": "^3.85.1",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "sharp": "^0.35.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.9"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "pnpm clean && pnpm build:types && pnpm build:swc",
+    "clean": "rimraf dist tsconfig.tsbuildinfo",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "build:swc": "swc ./src -d ./dist --config-file ../../.swcrc --strip-leading-paths",
+    "build:types": "tsc -p tsconfig.build.json --emitDeclarationOnly --noCheck"
+  }
+}