@orkify/cli 1.0.0-beta.5

package/packages/cache/dist/CacheStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheStore.js","sourceRoot":"","sources":["../src/CacheStore.ts"],"names":[],"mappings":"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"}

package/packages/cache/dist/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const CACHE_DIR: string;
+export declare const CACHE_DEFAULT_MAX_ENTRIES = 10000;
+export declare const CACHE_DEFAULT_MAX_MEMORY_SIZE: number;
+export declare const CACHE_DEFAULT_MAX_VALUE_SIZE: number;
+export declare const CACHE_CLEANUP_INTERVAL = 60000;
+//# sourceMappingURL=constants.d.ts.map

package/packages/cache/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,SAAS,QAA6B,CAAC;AACpD,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAChD,eAAO,MAAM,6BAA6B,QAAmB,CAAC;AAC9D,eAAO,MAAM,4BAA4B,QAAc,CAAC;AACxD,eAAO,MAAM,sBAAsB,QAAS,CAAC"}

package/packages/cache/dist/constants.js

@@ -0,0 +1,9 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const ORKIFY_HOME = join(homedir(), '.orkify');
+export const CACHE_DIR = join(ORKIFY_HOME, 'cache');
+export const CACHE_DEFAULT_MAX_ENTRIES = 10_000;
+export const CACHE_DEFAULT_MAX_MEMORY_SIZE = 64 * 1024 * 1024; // 64 MB
+export const CACHE_DEFAULT_MAX_VALUE_SIZE = 1024 * 1024; // 1 MB
+export const CACHE_CLEANUP_INTERVAL = 60_000; // 60s
+//# sourceMappingURL=constants.js.map

package/packages/cache/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AACpD,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAChD,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,QAAQ;AACvE,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO;AAChE,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,CAAC,MAAM"}

package/packages/cache/dist/index.d.ts

@@ -0,0 +1,16 @@
+import type { CacheConfig } from './types.js';
+import { CacheClient } from './CacheClient.js';
+/**
+ * @deprecated Use `cache.configure()` instead. Will be removed in a future version.
+ */
+export declare function configure(config: CacheConfig): void;
+/**
+ * Shared cache singleton. Reads are always synchronous local Map lookups.
+ * In cluster mode, writes broadcast via IPC so all workers converge.
+ * In standalone/fork mode, behaves as a local in-memory cache.
+ *
+ * Call `cache.configure()` before any other method to set options.
+ */
+export declare const cache: CacheClient;
+export type { CacheConfig, CacheSetOptions, CacheStats } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/cache/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AA2D/C;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAKnD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,EAAE,WAoBlB,CAAC;AAEH,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/packages/cache/dist/index.js

@@ -0,0 +1,86 @@
+import { CacheClient } from './CacheClient.js';
+let instance;
+let pendingConfig;
+// In cluster mode, IPC cache messages (including snapshots) can arrive before
+// this module loads.  The metrics probe registers a global buffer on
+// `globalThis.__orkifyCacheBuffer` synchronously before any `await`, so those
+// early messages are captured even when this module loads late.
+//
+// Messages that arrive *after* this module loads but *before* the proxy is first
+// accessed are captured by the local early listener below.  Both sources are
+// merged and drained when the CacheClient is created.
+const g = globalThis;
+const probeBuffer = Array.isArray(g.__orkifyCacheBuffer)
+    ? g.__orkifyCacheBuffer
+    : [];
+const localBuffer = [];
+let earlyListener;
+if (process.env.ORKIFY_CLUSTER_MODE === 'true' && typeof process.send === 'function') {
+    earlyListener = (msg) => {
+        const m = msg;
+        if (m?.__orkify && m.type?.startsWith('cache:')) {
+            localBuffer.push(msg);
+        }
+    };
+    process.on('message', earlyListener);
+}
+function createInstance() {
+    // Stop the local early listener — CacheClient registers its own
+    if (earlyListener) {
+        process.removeListener('message', earlyListener);
+        earlyListener = undefined;
+    }
+    // Stop the probe's global buffer listener
+    if (typeof g.__orkifyCacheBufferCleanup === 'function') {
+        g.__orkifyCacheBufferCleanup();
+        delete g.__orkifyCacheBufferCleanup;
+        delete g.__orkifyCacheBuffer;
+    }
+    // Merge probe buffer + local buffer — probe messages arrived first
+    const merged = [...probeBuffer, ...localBuffer];
+    probeBuffer.length = 0;
+    localBuffer.length = 0;
+    // Default to fileBacked: true unless explicitly disabled
+    const config = pendingConfig?.fileBacked === false ? pendingConfig : { fileBacked: true, ...pendingConfig };
+    instance = new CacheClient(config, merged);
+    const client = instance;
+    g.__orkifyCacheStats = () => client.stats();
+}
+/**
+ * @deprecated Use `cache.configure()` instead. Will be removed in a future version.
+ */
+export function configure(config) {
+    if (instance) {
+        throw new Error('orkify/cache: configure() must be called before the first use of cache');
+    }
+    pendingConfig = config;
+}
+/**
+ * Shared cache singleton. Reads are always synchronous local Map lookups.
+ * In cluster mode, writes broadcast via IPC so all workers converge.
+ * In standalone/fork mode, behaves as a local in-memory cache.
+ *
+ * Call `cache.configure()` before any other method to set options.
+ */
+export const cache = new Proxy({}, {
+    get(_target, prop, receiver) {
+        // configure() must run before the instance is created
+        if (prop === 'configure') {
+            return (config) => {
+                if (instance) {
+                    throw new Error('orkify/cache: configure() must be called before the first use of cache');
+                }
+                pendingConfig = config;
+            };
+        }
+        if (!instance)
+            createInstance();
+        const inst = instance;
+        const value = Reflect.get(inst, prop, receiver);
+        if (typeof value === 'function') {
+            return value.bind(inst);
+        }
+        return value;
+    },
+});
+//# sourceMappingURL=index.js.map

package/packages/cache/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/packages/cache/dist/serialize.d.ts

@@ -0,0 +1,9 @@
+export type Encoding = 'json' | 'v8';
+export interface Serialized {
+    data: string;
+    encoding: Encoding;
+}
+export declare function serialize(value: unknown): Serialized;
+export declare function deserialize({ data, encoding }: Serialized): unknown;
+export declare function serializedByteLength(s: Serialized): number;
+//# sourceMappingURL=serialize.d.ts.map

package/packages/cache/dist/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;AAErC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAmBD,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAWpD;AAED,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,UAAU,GAAG,OAAO,CAGnE;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAI1D"}

package/packages/cache/dist/serialize.js

@@ -0,0 +1,40 @@
+import v8 from 'node:v8';
+function needsV8(value) {
+    if (value instanceof Map ||
+        value instanceof Set ||
+        value instanceof Date ||
+        value instanceof RegExp ||
+        value instanceof Error)
+        return true;
+    if (ArrayBuffer.isView(value) || value instanceof ArrayBuffer)
+        return true;
+    if (Array.isArray(value))
+        return value.some(needsV8);
+    if (value !== null && typeof value === 'object') {
+        return Object.values(value).some(needsV8);
+    }
+    return false;
+}
+export function serialize(value) {
+    if (typeof value === 'function') {
+        throw new Error('cache: functions are not serializable');
+    }
+    if (typeof value === 'symbol') {
+        throw new Error('cache: symbols are not serializable');
+    }
+    if (needsV8(value)) {
+        return { data: v8.serialize(value).toString('base64'), encoding: 'v8' };
+    }
+    return { data: JSON.stringify(value), encoding: 'json' };
+}
+export function deserialize({ data, encoding }) {
+    if (encoding === 'v8')
+        return v8.deserialize(Buffer.from(data, 'base64'));
+    return JSON.parse(data);
+}
+export function serializedByteLength(s) {
+    return s.encoding === 'v8'
+        ? Math.ceil((s.data.length * 3) / 4) // base64 → raw bytes
+        : Buffer.byteLength(s.data, 'utf-8');
+}
+//# sourceMappingURL=serialize.js.map

package/packages/cache/dist/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AASzB,SAAS,OAAO,CAAC,KAAc;IAC7B,IACE,KAAK,YAAY,GAAG;QACpB,KAAK,YAAY,GAAG;QACpB,KAAK,YAAY,IAAI;QACrB,KAAK,YAAY,MAAM;QACvB,KAAK,YAAY,KAAK;QAEtB,OAAO,IAAI,CAAC;IACd,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,WAAW;QAAE,OAAO,IAAI,CAAC;IAC3E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1E,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAc;IACxD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC1E,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,CAAa;IAChD,OAAO,CAAC,CAAC,QAAQ,KAAK,IAAI;QACxB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,qBAAqB;QAC1D,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/packages/cache/dist/types.d.ts

@@ -0,0 +1,123 @@
+export interface CacheConfig {
+    defaultTtl?: number;
+    fileBacked?: boolean;
+    maxEntries?: number;
+    maxMemorySize?: number;
+    maxValueSize?: number;
+}
+export interface CacheSetOptions {
+    tags?: string[];
+    ttl?: number;
+}
+export interface CacheStats {
+    diskSize?: number;
+    hitRate: number;
+    hits: number;
+    misses: number;
+    size: number;
+    totalBytes: number;
+}
+export interface CacheEntry {
+    byteSize: number;
+    expiresAt?: number;
+    lastAccessedAt: number;
+    tags?: string[];
+    value: unknown;
+}
+export interface SerializedCacheEntry {
+    expiresAt?: number;
+    tags?: string[];
+    value: unknown;
+}
+export interface CacheSnapshot {
+    entries: Array<[string, SerializedCacheEntry]>;
+    tagTimestamps: Array<[string, number]>;
+}
+export type EvictReason = 'expired' | 'lru';
+export interface ICacheStore {
+    applyDelete(key: string): void;
+    applySet(key: string, value: unknown, expiresAt?: number, tags?: string[]): void;
+    applySnapshot(snapshot: CacheSnapshot): void;
+    applyTagTimestamp(tag: string, timestamp: number): void;
+    clear(): void;
+    delete(key: string): boolean;
+    destroy(): void;
+    get<T>(key: string): T | undefined;
+    getAsync<T>(key: string): Promise<T | undefined>;
+    getTagExpiration(tags: string[]): number;
+    has(key: string): boolean;
+    invalidateTag(tag: string): string[];
+    serialize(): CacheSnapshot;
+    set(key: string, value: unknown, expiresAt?: number, tags?: string[], precomputedByteSize?: number): void;
+    stats(): CacheStats;
+}
+export interface CacheSetMessage {
+    __orkify: true;
+    key: string;
+    tags?: string[];
+    ttl?: number;
+    type: 'cache:set';
+    value: unknown;
+}
+export interface CacheDeleteMessage {
+    __orkify: true;
+    key: string;
+    type: 'cache:delete';
+}
+export interface CacheClearMessage {
+    __orkify: true;
+    type: 'cache:clear';
+}
+export interface CacheInvalidateTagMessage {
+    __orkify: true;
+    tag: string;
+    type: 'cache:invalidate-tag';
+}
+export interface CacheUpdateTagTimestampMessage {
+    __orkify: true;
+    tag: string;
+    tagTimestamp: number;
+    type: 'cache:update-tag-timestamp';
+}
+export interface CacheConfigureMessage {
+    __orkify: true;
+    config: CacheConfig;
+    type: 'cache:configure';
+}
+export type CacheWorkerMessage = CacheClearMessage | CacheConfigureMessage | CacheDeleteMessage | CacheInvalidateTagMessage | CacheSetMessage | CacheUpdateTagTimestampMessage;
+export interface CacheBroadcastSetMessage {
+    __orkify: true;
+    expiresAt?: number;
+    key: string;
+    tags?: string[];
+    type: 'cache:set';
+    value: unknown;
+}
+export interface CacheBroadcastDeleteMessage {
+    __orkify: true;
+    key: string;
+    type: 'cache:delete';
+}
+export interface CacheBroadcastClearMessage {
+    __orkify: true;
+    type: 'cache:clear';
+}
+export interface CacheBroadcastInvalidateTagMessage {
+    __orkify: true;
+    tag: string;
+    tagTimestamp: number;
+    type: 'cache:invalidate-tag';
+}
+export interface CacheBroadcastUpdateTagTimestampMessage {
+    __orkify: true;
+    tag: string;
+    tagTimestamp: number;
+    type: 'cache:update-tag-timestamp';
+}
+export interface CacheSnapshotMessage {
+    __orkify: true;
+    entries: Array<[string, SerializedCacheEntry]>;
+    tagTimestamps: Array<[string, number]>;
+    type: 'cache:snapshot';
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/cache/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/packages/cache/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/packages/cache/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/packages/cache/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@orkify/cache",
+  "version": "1.0.0-beta.1",
+  "private": true,
+  "description": "Framework-agnostic shared cache for orkify-managed processes",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./primary": {
+      "types": "./src/CachePrimary.ts",
+      "import": "./dist/CachePrimary.js",
+      "default": "./dist/CachePrimary.js"
+    },
+    "./types": {
+      "types": "./src/types.ts",
+      "import": "./dist/types.js",
+      "default": "./dist/types.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc"
+  }
+}

package/packages/cache/src/CacheClient.ts

@@ -0,0 +1,227 @@
+import type {
+  CacheBroadcastClearMessage,
+  CacheBroadcastDeleteMessage,
+  CacheBroadcastInvalidateTagMessage,
+  CacheBroadcastSetMessage,
+  CacheBroadcastUpdateTagTimestampMessage,
+  CacheConfig,
+  CacheSetOptions,
+  CacheSnapshotMessage,
+  CacheStats,
+  ICacheStore,
+} from './types.js';
+import { CACHE_DEFAULT_MAX_VALUE_SIZE } from './constants.js';
+import { CacheFileStore } from './CacheFileStore.js';
+import { CacheStore } from './CacheStore.js';
+import { serialize, serializedByteLength } from './serialize.js';
+
+type CacheInboundMessage =
+  | CacheBroadcastClearMessage
+  | CacheBroadcastDeleteMessage
+  | CacheBroadcastInvalidateTagMessage
+  | CacheBroadcastSetMessage
+  | CacheBroadcastUpdateTagTimestampMessage
+  | CacheSnapshotMessage;
+
+export class CacheClient {
+  private clusterMode: boolean;
+  private defaultTtl: number | undefined;
+  private maxValueSize: number;
+  private messageHandler: ((msg: unknown) => void) | undefined;
+  private store: ICacheStore;
+
+  constructor(config?: CacheConfig, bufferedMessages?: unknown[]) {
+    this.defaultTtl = config?.defaultTtl;
+    this.maxValueSize = config?.maxValueSize ?? CACHE_DEFAULT_MAX_VALUE_SIZE;
+    this.clusterMode =
+      process.env.ORKIFY_CLUSTER_MODE === 'true' && typeof process.send === 'function';
+
+    // File-backed: CacheFileStore for disk cold layer.
+    // In cluster mode workers are readOnly (reads from disk, writes go through IPC to primary).
+    // In standalone/fork mode the store has full read/write access.
+    const fileBacked = config?.fileBacked === true;
+    this.store = fileBacked
+      ? new CacheFileStore(
+          process.env.ORKIFY_PROCESS_NAME ?? 'default',
+          config,
+          this.clusterMode ? { readOnly: true } : undefined
+        )
+      : new CacheStore(config);
+
+    // In fork/standalone mode, flush file-backed cache on process exit so all
+    // entries (not just evicted ones) survive restarts. Uses synchronous I/O
+    // since the 'exit' event doesn't support async operations.
+    if (!this.clusterMode && fileBacked) {
+      const fileStore = this.store as CacheFileStore;
+
+      // IPC flush for graceful shutdown (works cross-platform including Windows
+      // where SIGTERM doesn't trigger exit handlers)
+      process.on('message', (msg: unknown) => {
+        const m = msg as { __orkify?: boolean; type?: string };
+        if (m?.__orkify && m.type === 'cache:flush') {
+          fileStore.flushSync();
+          try {
+            process.send?.({ __orkify: true, type: 'cache:flushed' });
+          } catch {
+            // parent may have disconnected
+          }
+          process.exit(0);
+        }
+      });
+
+      // Fallback: also flush on exit event (works on Unix via SIGTERM → exit)
+      process.on('exit', () => fileStore.flushSync());
+    }
+
+    if (this.clusterMode) {
+      this.messageHandler = (msg: unknown) => this.handleMessage(msg);
+      process.on('message', this.messageHandler);
+
+      // Drain any IPC messages that arrived before this client was created
+      if (bufferedMessages) {
+        for (const msg of bufferedMessages) {
+          this.handleMessage(msg);
+        }
+      }
+
+      // Notify the cluster primary about file-backed config so it can upgrade its store
+      if (process.send && fileBacked) {
+        this.trySend({
+          __orkify: true,
+          type: 'cache:configure',
+          config: { ...config, fileBacked: true },
+        });
+      }
+    }
+  }
+
+  /** Configure cache options. Must be called before any other method. Intercepted by the proxy in `cache/index.ts`. */
+  configure(_config: CacheConfig): void {
+    throw new Error('orkify/cache: configure() must be called via the cache singleton proxy');
+  }
+
+  get<T>(key: string): T | undefined {
+    return this.store.get<T>(key);
+  }
+
+  async getAsync<T>(key: string): Promise<T | undefined> {
+    return this.store.getAsync<T>(key);
+  }
+
+  set(key: string, value: unknown, opts?: CacheSetOptions): void {
+    if (opts?.ttl !== undefined && opts.ttl <= 0) {
+      throw new Error(`cache.set(): ttl must be positive, got ${opts.ttl}`);
+    }
+
+    // Validate serializability and size
+    const serialized = serialize(value);
+    const byteLength = serializedByteLength(serialized);
+    if (byteLength > this.maxValueSize) {
+      throw new Error(
+        `cache.set(): value for key "${key}" is ${byteLength} bytes, exceeds max ${this.maxValueSize} bytes`
+      );
+    }
+
+    const ttl = opts?.ttl ?? this.defaultTtl;
+    const expiresAt = ttl ? Date.now() + ttl * 1000 : undefined;
+    const tags = opts?.tags;
+    this.store.set(key, value, expiresAt, tags, byteLength);
+
+    if (this.clusterMode) {
+      this.trySend({ __orkify: true, type: 'cache:set', key, value, ttl, tags });
+    }
+  }
+
+  delete(key: string): void {
+    this.store.delete(key);
+
+    if (this.clusterMode) {
+      this.trySend({ __orkify: true, type: 'cache:delete', key });
+    }
+  }
+
+  clear(): void {
+    this.store.clear();
+
+    if (this.clusterMode) {
+      this.trySend({ __orkify: true, type: 'cache:clear' });
+    }
+  }
+
+  has(key: string): boolean {
+    return this.store.has(key);
+  }
+
+  stats(): CacheStats {
+    return this.store.stats();
+  }
+
+  getTagExpiration(tags: string[]): number {
+    return this.store.getTagExpiration(tags);
+  }
+
+  invalidateTag(tag: string): void {
+    this.store.invalidateTag(tag);
+
+    if (this.clusterMode) {
+      this.trySend({ __orkify: true, type: 'cache:invalidate-tag', tag });
+    }
+  }
+
+  updateTagTimestamp(tag: string, timestamp?: number): void {
+    const ts = timestamp ?? Date.now();
+    this.store.applyTagTimestamp(tag, ts);
+
+    if (this.clusterMode) {
+      this.trySend({ __orkify: true, type: 'cache:update-tag-timestamp', tag, tagTimestamp: ts });
+    }
+  }
+
+  destroy(): void {
+    if (this.messageHandler) {
+      process.removeListener('message', this.messageHandler);
+      this.messageHandler = undefined;
+    }
+    this.store.destroy();
+  }
+
+  /** Send an IPC message to the cluster primary, silently ignoring failures (e.g. closed channel). */
+  private trySend(msg: Record<string, unknown>): void {
+    try {
+      process.send?.(msg);
+    } catch {
+      // IPC channel closed — primary died or worker is shutting down
+    }
+  }
+
+  private handleMessage(msg: unknown): void {
+    const m = msg as { __orkify?: boolean; type?: string };
+    if (!m?.__orkify || !m.type?.startsWith('cache:')) return;
+
+    const message = msg as CacheInboundMessage;
+    switch (message.type) {
+      case 'cache:set':
+        this.store.applySet(message.key, message.value, message.expiresAt, message.tags);
+        break;
+      case 'cache:delete':
+        this.store.applyDelete(message.key);
+        break;
+      case 'cache:clear':
+        this.store.clear();
+        break;
+      case 'cache:invalidate-tag':
+        this.store.invalidateTag(message.tag);
+        this.store.applyTagTimestamp(message.tag, message.tagTimestamp);
+        break;
+      case 'cache:update-tag-timestamp':
+        this.store.applyTagTimestamp(message.tag, message.tagTimestamp);
+        break;
+      case 'cache:snapshot':
+        this.store.applySnapshot({
+          entries: message.entries,
+          tagTimestamps: message.tagTimestamps,
+        });
+        break;
+    }
+  }
+}