@cosmicdrift/kumiko-types 0.159.0 → 0.159.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.159.0",
+  "version": "0.159.1",
   "description": "Framework-Type-Definitions für Kumiko — FeatureDefinition, BootCheck-Types und die reinen Engine-Types, ohne Runtime-Code. Erlaubt Downstream-Konsumenten, gegen die Type-Contracts zu bauen, ohne das ganze Framework-Package zu importieren.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -77,6 +77,14 @@
     "./db-connection": {
       "types": "./src/db-connection.ts",
       "default": "./src/db-connection.ts"
+    },
+    "./entity-cache": {
+      "types": "./src/entity-cache.ts",
+      "default": "./src/entity-cache.ts"
+    },
+    "./file-handle-types": {
+      "types": "./src/file-handle-types.ts",
+      "default": "./src/file-handle-types.ts"
     }
   },
   "dependencies": {

package/src/entity-cache.ts

@@ -0,0 +1,35 @@
+import type { EntityId, TenantId } from "./identifiers";
+
+export type EntityCache = {
+  /** Get a single cached entity. Returns null on miss. */
+  get(
+    tenantId: TenantId,
+    entityName: string,
+    id: EntityId,
+  ): Promise<Record<string, unknown> | null>;
+
+  /** Get multiple cached entities. Returns a Map of id → data (misses are absent). */
+  mget(
+    tenantId: TenantId,
+    entityName: string,
+    ids: readonly EntityId[],
+  ): Promise<Map<EntityId, Record<string, unknown>>>;
+
+  /** Cache a single entity. */
+  set(
+    tenantId: TenantId,
+    entityName: string,
+    id: EntityId,
+    data: Record<string, unknown>,
+  ): Promise<void>;
+
+  /** Cache multiple entities at once. */
+  mset(
+    tenantId: TenantId,
+    entityName: string,
+    entries: ReadonlyArray<{ id: EntityId; data: Record<string, unknown> }>,
+  ): Promise<void>;
+
+  /** Invalidate a single cached entity. */
+  del(tenantId: TenantId, entityName: string, id: EntityId): Promise<void>;
+};

package/src/file-handle-types.ts

@@ -0,0 +1,19 @@
+export type FileHandle = {
+  readonly key: string;
+  read(): Promise<Uint8Array>;
+  write(data: Uint8Array, mimeType?: string): Promise<void>;
+  delete(): Promise<void>;
+  exists(): Promise<boolean>;
+  // Produce a handle for a derived key (e.g. a thumbnail). Does not touch
+  // storage; only computes the key. Writing to the derived handle is the
+  // caller's job.
+  derive(suffix: string): FileHandle;
+};
+
+// The `ctx.files` service — a factory that materialises a FileHandle for a
+// storage key. One per request/event, bound to a single tenant: the provider
+// is resolved per-tenant through file-foundation, so uploads, ctx.files and the
+// GDPR jobs all hit the same store by construction.
+export type FileContext = {
+  ref(key: string): FileHandle;
+};