@orkify/cli 1.0.0-beta.5 → 1.0.0-beta.6

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

@@ -1 +0,0 @@
-{"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

@@ -1,40 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,123 +0,0 @@
-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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC/C,aAAa,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACxC;AAED,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,KAAK,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACjF,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7C,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,OAAO,IAAI,IAAI,CAAC;IAChB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACjD,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACrC,SAAS,IAAI,aAAa,CAAC;IAC3B,GAAG,CACD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,mBAAmB,CAAC,EAAE,MAAM,GAC3B,IAAI,CAAC;IACR,KAAK,IAAI,UAAU,CAAC;CACrB;AAGD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,IAAI,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,IAAI,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,IAAI,CAAC;IACf,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,IAAI,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,sBAAsB,CAAC;CAC9B;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,IAAI,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,4BAA4B,CAAC;CACpC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,IAAI,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED,MAAM,MAAM,kBAAkB,GAC1B,iBAAiB,GACjB,qBAAqB,GACrB,kBAAkB,GAClB,yBAAyB,GACzB,eAAe,GACf,8BAA8B,CAAC;AAGnC,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,IAAI,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,IAAI,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,IAAI,CAAC;IACf,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,EAAE,IAAI,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,sBAAsB,CAAC;CAC9B;AAED,MAAM,WAAW,uCAAuC;IACtD,QAAQ,EAAE,IAAI,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,4BAA4B,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,IAAI,CAAC;IACf,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC/C,aAAa,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvC,IAAI,EAAE,gBAAgB,CAAC;CACxB"}

package/packages/cache/dist/types.js

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

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

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

package/packages/cache/package.json

@@ -1,27 +0,0 @@
-{
-  "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

@@ -1,227 +0,0 @@
-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;
-    }
-  }
-}