@classytic/arc 1.0.8 → 2.1.2

package/dist/interface-CZe8IkMf.d.mts

@@ -0,0 +1,55 @@
+//#region src/cache/interface.d.ts
+/**
+ * Generic Cache Store Interface
+ *
+ * Shared contract for reusable cache backends (memory, Redis, etc.).
+ * Used by runtime systems such as dynamic permission matrices and QueryCache.
+ */
+interface CacheLogger {
+  warn(message: string, ...args: unknown[]): void;
+  error(message: string, ...args: unknown[]): void;
+}
+interface CacheSetOptions {
+  /** Time-to-live in milliseconds */
+  ttlMs?: number;
+}
+interface CacheStats {
+  /** Number of entries currently stored */
+  entries: number;
+  /** Estimated memory usage in bytes (-1 if unavailable) */
+  memoryBytes: number;
+  /** Cache hit count since creation */
+  hits: number;
+  /** Cache miss count since creation */
+  misses: number;
+  /** Number of entries evicted since creation */
+  evictions: number;
+}
+interface CacheStore<TValue = unknown> {
+  /** Store name for logs/diagnostics */
+  readonly name: string;
+  /**
+   * Get cached value by key.
+   * Returns undefined when missing or expired.
+   */
+  get(key: string): Promise<TValue | undefined>;
+  /**
+   * Set a cache value.
+   * Store implementation handles TTL and eviction policy.
+   */
+  set(key: string, value: TValue, options?: CacheSetOptions): Promise<void>;
+  /**
+   * Delete a single cache key.
+   */
+  delete(key: string): Promise<void>;
+  /**
+   * Clear all keys in this store namespace.
+   * Optional because distributed stores may not support cheap global clear.
+   */
+  clear?(): Promise<void>;
+  /** Cache statistics for observability. */
+  stats?(): CacheStats;
+}
+//#endregion
+export { CacheStore as i, CacheSetOptions as n, CacheStats as r, CacheLogger as t };
+//# sourceMappingURL=interface-CZe8IkMf.d.mts.map

package/dist/interface-CZe8IkMf.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface-CZe8IkMf.d.mts","names":[],"sources":["../src/cache/interface.ts"],"mappings":";;AAOA;;;;;UAAiB,WAAA;EACf,IAAA,CAAK,OAAA,aAAoB,IAAA;EACzB,KAAA,CAAM,OAAA,aAAoB,IAAA;AAAA;AAAA,UAGX,eAAA;EAHe;EAK9B,KAAA;AAAA;AAAA,UAGe,UAAA;;EAEf,OAAA;EALK;EAOL,WAAA;EAJyB;EAMzB,IAAA;EANyB;EAQzB,MAAA;EAJA;EAMA,SAAA;AAAA;AAAA,UAGe,UAAA;EAHN;EAAA,SAKA,IAAA;EAFM;;;;EAQf,GAAA,CAAI,GAAA,WAAc,OAAA,CAAQ,MAAA;EAMF;;;;EAAxB,GAAA,CAAI,GAAA,UAAa,KAAA,EAAO,MAAA,EAAQ,OAAA,GAAU,eAAA,GAAkB,OAAA;EAclD;;;EATV,MAAA,CAAO,GAAA,WAAc,OAAA;EAjBZ;;;;EAuBT,KAAA,KAAU,OAAA;EAXV;EAcA,KAAA,KAAU,UAAA;AAAA"}