@c9up/echo 0.1.4 → 0.1.6

package/dist/index.d.ts

@@ -1,7 +1,10 @@
 /**
  * @c9up/echo — Cache layer for the Ream framework.
  *
- * Provides get/set/delete/flush/tags with pluggable drivers (Memory, Redis).
+ * bentocache / @adonisjs/cache parity: object-argument API, grace
+ * (stale-while-revalidate), soft/hard timeouts, tags, multi-tier (L1+L2) and
+ * multi-store (`{ default, stores }` + `use(name)`) — over pluggable drivers
+ * (Memory, Redis, Tiered).
  *
  * @implements MISS-10
  */
@@ -10,4 +13,21 @@ export { CacheManager } from "./CacheManager.js";
 export { MemoryDriver } from "./drivers/MemoryDriver.js";
 export type { RedisClient } from "./drivers/RedisDriver.js";
 export { RedisDriver } from "./drivers/RedisDriver.js";
+export type { BusMessage, CacheBus, TieredDriverOptions, } from "./drivers/TieredDriver.js";
+export { TieredDriver } from "./drivers/TieredDriver.js";
+export type { Duration } from "./duration.js";
+export { parseDuration, resolveTtlSeconds } from "./duration.js";
+export type { EchoProviderConfig } from "./EchoProvider.js";
+export { FactoryError, TimeoutError } from "./errors.js";
+export { CacheStoreManager, type DriverFactory, drivers, type MultiStoreConfig, type StoreConfig, } from "./StoreManager.js";
+export type { CacheEmitter, CacheEntry, CacheEventMap, DefaultValue, DeleteByTagOptions, DeleteManyOptions, DeleteOptions, ExpireOptions, Factory, GetOptions, GetOrSetForeverOptions, GetOrSetOptions, HasOptions, SetOptions, TaggableDriver, } from "./types.js";
+import type { EchoProviderConfig } from "./EchoProvider.js";
+import type { MultiStoreConfig } from "./StoreManager.js";
+/**
+ * Author-time config helper for `config/cache.ts` — AdonisJS cache `defineConfig`
+ * parity. Identity at runtime; the generic preserves literal types for inference.
+ * Accepts both the single-store {@link EchoProviderConfig} and the multi-store
+ * {@link MultiStoreConfig} (`{ default, stores }`) shapes.
+ */
+export declare function defineConfig<T extends EchoProviderConfig | MultiStoreConfig>(config: T): T;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,YAAY,EACX,UAAU,EACV,QAAQ,EACR,mBAAmB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACjE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EACN,iBAAiB,EACjB,KAAK,aAAa,EAClB,OAAO,EACP,KAAK,gBAAgB,EACrB,KAAK,WAAW,GAChB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACX,YAAY,EACZ,UAAU,EACV,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,OAAO,EACP,UAAU,EACV,sBAAsB,EACtB,eAAe,EACf,UAAU,EACV,UAAU,EACV,cAAc,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,kBAAkB,GAAG,gBAAgB,EAC3E,MAAM,EAAE,CAAC,GACP,CAAC,CAEH"}

package/dist/index.js

@@ -1,11 +1,27 @@
 /**
  * @c9up/echo — Cache layer for the Ream framework.
  *
- * Provides get/set/delete/flush/tags with pluggable drivers (Memory, Redis).
+ * bentocache / @adonisjs/cache parity: object-argument API, grace
+ * (stale-while-revalidate), soft/hard timeouts, tags, multi-tier (L1+L2) and
+ * multi-store (`{ default, stores }` + `use(name)`) — over pluggable drivers
+ * (Memory, Redis, Tiered).
  *
  * @implements MISS-10
  */
 export { CacheManager } from "./CacheManager.js";
 export { MemoryDriver } from "./drivers/MemoryDriver.js";
 export { RedisDriver } from "./drivers/RedisDriver.js";
+export { TieredDriver } from "./drivers/TieredDriver.js";
+export { parseDuration, resolveTtlSeconds } from "./duration.js";
+export { FactoryError, TimeoutError } from "./errors.js";
+export { CacheStoreManager, drivers, } from "./StoreManager.js";
+/**
+ * Author-time config helper for `config/cache.ts` — AdonisJS cache `defineConfig`
+ * parity. Identity at runtime; the generic preserves literal types for inference.
+ * Accepts both the single-store {@link EchoProviderConfig} and the multi-store
+ * {@link MultiStoreConfig} (`{ default, stores }`) shapes.
+ */
+export function defineConfig(config) {
+    return config;
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAMvD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EACN,iBAAiB,EAEjB,OAAO,GAGP,MAAM,mBAAmB,CAAC;AAsB3B;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC3B,MAAS;IAET,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/testing/main.d.ts

@@ -0,0 +1,41 @@
+/**
+ * `@c9up/echo/testing` — helpers for testing code that depends on the cache.
+ *
+ *   import { createTestCache } from "@c9up/echo/testing"
+ *
+ *   const { cache, events, dispose } = createTestCache()
+ *   await cache.set({ key: "k", value: 1 })
+ *   expect(events).toContainEqual({ event: "cache:written", payload: { key: "k", value: 1, store: "test" } })
+ *   dispose()
+ */
+import { CacheManager } from "../CacheManager.js";
+import { MemoryDriver } from "../drivers/MemoryDriver.js";
+import type { Duration } from "../duration.js";
+/** A single recorded cache event. */
+export interface RecordedEvent {
+    event: string;
+    payload: unknown;
+}
+export interface CreateTestCacheOptions {
+    prefix?: string;
+    /** Default TTL in seconds. */
+    ttl?: number;
+    grace?: Duration;
+    name?: string;
+}
+export interface TestCache {
+    /** A ready-to-use in-memory cache. */
+    cache: CacheManager;
+    /** The underlying driver (for direct assertions / setup). */
+    driver: MemoryDriver;
+    /** Every event emitted by the cache, in order. */
+    events: RecordedEvent[];
+    /** Stop the driver's sweep timer. Call in `afterEach`. */
+    dispose(): void;
+}
+/**
+ * Build an isolated in-memory {@link CacheManager} with a recording emitter, for
+ * unit tests. Each call is fully isolated (fresh driver + event log).
+ */
+export declare function createTestCache(options?: CreateTestCacheOptions): TestCache;
+//# sourceMappingURL=main.d.ts.map

package/dist/testing/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/testing/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACzB,sCAAsC;IACtC,KAAK,EAAE,YAAY,CAAC;IACpB,6DAA6D;IAC7D,MAAM,EAAE,YAAY,CAAC;IACrB,kDAAkD;IAClD,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,0DAA0D;IAC1D,OAAO,IAAI,IAAI,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAuB3E"}

package/dist/testing/main.js

@@ -0,0 +1,41 @@
+/**
+ * `@c9up/echo/testing` — helpers for testing code that depends on the cache.
+ *
+ *   import { createTestCache } from "@c9up/echo/testing"
+ *
+ *   const { cache, events, dispose } = createTestCache()
+ *   await cache.set({ key: "k", value: 1 })
+ *   expect(events).toContainEqual({ event: "cache:written", payload: { key: "k", value: 1, store: "test" } })
+ *   dispose()
+ */
+import { CacheManager } from "../CacheManager.js";
+import { MemoryDriver } from "../drivers/MemoryDriver.js";
+/**
+ * Build an isolated in-memory {@link CacheManager} with a recording emitter, for
+ * unit tests. Each call is fully isolated (fresh driver + event log).
+ */
+export function createTestCache(options) {
+    const driver = new MemoryDriver();
+    const events = [];
+    const emitter = {
+        emit(event, payload) {
+            events.push({ event, payload });
+        },
+    };
+    const cache = new CacheManager(driver, {
+        prefix: options?.prefix,
+        ttl: options?.ttl,
+        grace: options?.grace,
+        name: options?.name ?? "test",
+        emitter,
+    });
+    return {
+        cache,
+        driver,
+        events,
+        dispose() {
+            driver.destroy();
+        },
+    };
+}
+//# sourceMappingURL=main.js.map

package/dist/testing/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/testing/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AA6B1D;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgC;IAC/D,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IAClC,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,OAAO,GAAiB;QAC7B,IAAI,CAAC,KAAK,EAAE,OAAO;YAClB,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACjC,CAAC;KACD,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE;QACtC,MAAM,EAAE,OAAO,EAAE,MAAM;QACvB,GAAG,EAAE,OAAO,EAAE,GAAG;QACjB,KAAK,EAAE,OAAO,EAAE,KAAK;QACrB,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,MAAM;QAC7B,OAAO;KACP,CAAC,CAAC;IACH,OAAO;QACN,KAAK;QACL,MAAM;QACN,MAAM;QACN,OAAO;YACN,MAAM,CAAC,OAAO,EAAE,CAAC;QAClB,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Shared cache contracts — driver interface, stored-entry shape, method option
+ * objects (bentocache/@adonisjs/cache parity) and the event emitter contract.
+ */
+import type { Duration } from "./duration.js";
+import type { FactoryError } from "./errors.js";
+/**
+ * A driver-level entry. `stale` is `true` when the value is past its logical
+ * TTL but still retained under the grace period (stale-while-revalidate).
+ */
+export interface CacheEntry<T = unknown> {
+    value: T;
+    stale: boolean;
+    /**
+     * Logical expiry as an epoch-ms timestamp; `0` means "never expires".
+     * `undefined` means the driver does not track expiry. Lets a composing
+     * driver (e.g. {@link TieredDriver}) preserve the remaining TTL when it
+     * promotes an entry between tiers instead of resetting it to immortal.
+     */
+    expiresAt?: number;
+}
+/** Options for the grace-aware {@link CacheDriver.setEntry}. */
+export interface DriverSetOptions {
+    /** Logical TTL in seconds; `0`/omitted means never expires. */
+    ttlSeconds?: number;
+    /** Extra retention beyond the logical TTL, in seconds (grace period). */
+    graceSeconds?: number;
+    /** Tags for grouped invalidation (only honoured by taggable drivers). */
+    tags?: string[];
+    /**
+     * Absolute logical expiry as an epoch-ms timestamp. When set it OVERRIDES
+     * `ttlSeconds` for the logical-freshness boundary (a past value makes the
+     * entry immediately stale), while `graceSeconds` still governs physical
+     * retention from now. Used by {@link CacheManager.expire} to mark a key stale
+     * at once without deleting it.
+     */
+    expiresAt?: number;
+}
+/**
+ * Cache driver contract.
+ *
+ * The five core methods (`get`/`set`/`delete`/`flush`/`has`) are the minimal
+ * surface — any KV store satisfies them. `getEntry`/`setEntry` are the optional
+ * grace-aware extensions; {@link CacheManager} falls back to `get`/`set` when a
+ * driver doesn't implement them, so grace simply degrades to "no stale window"
+ * on minimal drivers (agnostic-friendly).
+ */
+export interface CacheDriver {
+    get<T = unknown>(key: string): Promise<T | null>;
+    set(key: string, value: unknown, ttlSeconds?: number): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    flush(): Promise<void>;
+    has(key: string): Promise<boolean>;
+    /** Grace-aware read: returns the entry even if stale, or `null` if physically gone. */
+    getEntry?<T = unknown>(key: string): Promise<CacheEntry<T> | null>;
+    /** Grace-aware write. */
+    setEntry?(key: string, value: unknown, options: DriverSetOptions): Promise<void>;
+}
+/** A driver that supports tag-based grouped invalidation. */
+export interface TaggableDriver extends CacheDriver {
+    setWithTags(key: string, value: unknown, tags: string[], ttlSeconds?: number): Promise<void>;
+    /** Invalidate every entry carrying any of the given tags (bento `deleteByTag`). */
+    deleteByTag(tags: string[]): Promise<void>;
+    /** @deprecated alias of {@link deleteByTag} (echo pre-0.2 name). */
+    flushTags(tags: string[]): Promise<void>;
+}
+/** A `getOrSet` factory. */
+export type Factory<T> = () => T | Promise<T>;
+/** A lazily-resolved default value for `get`. */
+export type DefaultValue<T> = T | (() => T);
+export interface GetOptions<T = unknown> {
+    key: string;
+    defaultValue?: DefaultValue<T>;
+    grace?: Duration;
+}
+export interface SetOptions {
+    key: string;
+    value: unknown;
+    ttl?: Duration;
+    grace?: Duration;
+    tags?: string[];
+}
+export interface GetOrSetOptions<T> {
+    key: string;
+    factory: Factory<T>;
+    ttl?: Duration;
+    grace?: Duration;
+    /** Soft timeout: on a stale hit, return the stale value if the factory is slower, then refresh in the background. */
+    timeout?: Duration;
+    /** Hard timeout: reject with {@link TimeoutError} if the factory exceeds it (even without a stale fallback). */
+    hardTimeout?: Duration;
+    /** Max time to wait on another caller's in-flight factory before falling back to stale (single-flight lock). */
+    lockTimeout?: Duration;
+    tags?: string[];
+    /** Observe factory failures (foreground and background). */
+    onFactoryError?: (error: FactoryError) => void;
+}
+export type GetOrSetForeverOptions<T> = Omit<GetOrSetOptions<T>, "ttl">;
+export interface DeleteOptions {
+    key: string;
+}
+export interface DeleteManyOptions {
+    keys: string[];
+}
+export interface DeleteByTagOptions {
+    tags: string[];
+}
+export interface HasOptions {
+    key: string;
+}
+export interface ExpireOptions {
+    key: string;
+}
+/** Payloads for each emitted cache event (bento event-name parity). */
+export interface CacheEventMap {
+    "cache:hit": {
+        key: string;
+        value: unknown;
+        store: string;
+        graced: boolean;
+    };
+    "cache:miss": {
+        key: string;
+        store: string;
+    };
+    "cache:written": {
+        key: string;
+        value: unknown;
+        store: string;
+    };
+    "cache:deleted": {
+        key: string;
+        store: string;
+    };
+    "cache:cleared": {
+        store: string;
+    };
+}
+/**
+ * Duck-typed event emitter — any object exposing `emit(event, payload)` works
+ * (ream's emitter, Node's EventEmitter, mitt, …). echo never imports one.
+ */
+export interface CacheEmitter {
+    emit(event: string, payload: unknown): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/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/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Shared cache contracts — driver interface, stored-entry shape, method option
+ * objects (bentocache/@adonisjs/cache parity) and the event emitter contract.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c9up/echo",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Cache — pluggable cache contract with memory + Redis drivers for the Ream framework",
   "license": "MIT",
   "type": "module",
@@ -18,12 +18,17 @@
     "./services/main": {
       "types": "./dist/services/main.d.ts",
       "import": "./dist/services/main.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/main.d.ts",
+      "import": "./dist/testing/main.js"
     }
   },
   "peerDependencies": {
     "@c9up/ream": "^0.1.0"
   },
   "devDependencies": {
+    "@biomejs/biome": "^2.4.10",
     "@types/node": "^22.19.15",
     "typescript": "^6.0.2",
     "vitest": "^4.1.2"