@cosmicdrift/kumiko-bundled-features 0.189.0 → 0.191.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-bundled-features",
-  "version": "0.189.0",
+  "version": "0.191.0",
   "description": "Built-in features — tenant, user, auth, delivery. The stuff you'd rewrite anyway, already typed.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -67,6 +67,7 @@
     "./document-ingest-foundation": "./src/document-ingest-foundation/index.ts",
     "./file-provider-s3-env": "./src/file-provider-s3-env/index.ts",
     "./file-provider-inmemory": "./src/file-provider-inmemory/index.ts",
+    "./file-derivatives": "./src/file-derivatives/index.ts",
     "./files": "./src/files/index.ts",
     "./user-data-rights": "./src/user-data-rights/index.ts",
     "./user-data-rights/web": "./src/user-data-rights/web/index.ts",
@@ -123,12 +124,12 @@
     "./step-dispatcher": "./src/step-dispatcher/index.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-dispatcher-live": "0.189.0",
-    "@cosmicdrift/kumiko-framework": "0.189.0",
-    "@cosmicdrift/kumiko-headless": "0.189.0",
-    "@cosmicdrift/kumiko-renderer": "0.189.0",
-    "@cosmicdrift/kumiko-renderer-web": "0.189.0",
-    "@cosmicdrift/kumiko-types": "0.189.0",
+    "@cosmicdrift/kumiko-dispatcher-live": "0.191.0",
+    "@cosmicdrift/kumiko-framework": "0.191.0",
+    "@cosmicdrift/kumiko-headless": "0.191.0",
+    "@cosmicdrift/kumiko-renderer": "0.191.0",
+    "@cosmicdrift/kumiko-renderer-web": "0.191.0",
+    "@cosmicdrift/kumiko-types": "0.191.0",
     "@mollie/api-client": "^4.5.0",
     "imapflow": "^1.3.3",
     "mailparser": "^3.9.8",

package/src/file-derivatives/changes.json

@@ -0,0 +1 @@
+[]

package/src/file-derivatives/feature.ts

@@ -0,0 +1,33 @@
+// kumiko-feature-version: 1
+//
+// Same extension-point/provider-feature pattern as file-foundation — see
+// r.describe below for what this feature does. Unlike `fileProvider`,
+// renderer selection is MIME-type-deterministic, not per-tenant
+// configurable, so this feature has no `r.config` and no
+// `r.extensionSelector`.
+
+import { defineFeature, EXT_DERIVATIVE_RENDERER } from "@cosmicdrift/kumiko-framework/engine";
+
+const FEATURE_NAME = "file-derivatives";
+
+export const fileDerivativesFeature = defineFeature(FEATURE_NAME, (r) => {
+  r.describe(
+    "Declares the `derivativeRenderer` extension point. `ctx.derivatives.variant(fileRefId, spec, name)` derives a variant of a tracked FileRef the first time it's requested and reuses the stored result afterwards (derive-on-first-use, keyed by a hash of the spec). Mount at least one `derivatives-*` renderer feature alongside this one — without a registered renderer for the FileRef's MIME type, every `variant(...)` call throws.",
+  );
+  r.uiHints({
+    displayLabel: "File Derivatives",
+    category: "storage",
+    recommended: false,
+  });
+  // Needs a storage provider to read the original + write the variant —
+  // without file-foundation there's nothing to derive from or write to.
+  r.requires("file-foundation");
+
+  r.extendsRegistrar(EXT_DERIVATIVE_RENDERER, {
+    onRegister: () => {
+      // No side-effects at register-time — resolution (exact MIME match,
+      // then `<type>/*` wildcard) happens at request-time in
+      // resolveRenderer, mirrors file-foundation's fileProvider point.
+    },
+  });
+});

package/src/file-derivatives/index.ts

@@ -0,0 +1,2 @@
+export { fileDerivativesFeature } from "./feature";
+export { card, full, hero, thumb } from "./presets";

package/src/file-derivatives/presets.ts

@@ -0,0 +1,6 @@
+import type { VariantSpec } from "@cosmicdrift/kumiko-types/derivatives-types";
+
+export const thumb = { maxEdge: 160, fit: "cover", format: "webp" } as const satisfies VariantSpec;
+export const card = { maxEdge: 640, fit: "inside", format: "webp" } as const satisfies VariantSpec;
+export const hero = { maxEdge: 1600, fit: "inside", format: "webp" } as const satisfies VariantSpec;
+export const full = { maxEdge: 2560, fit: "inside", format: "webp" } as const satisfies VariantSpec;