@voyant-travel/utils 0.105.5 → 0.106.0

package/dist/index.d.ts

@@ -6,8 +6,12 @@ export * from "./kms.js";
 export * from "./kv.js";
 export * from "./languages.js";
 export * from "./localized-countries-regions.js";
+export * from "./memory-kv.js";
 export * from "./pdf-renderer.js";
+export * from "./redis-client.js";
+export * from "./redis-kv.js";
 export * from "./resilience.js";
 export * from "./template-renderer.js";
+export * from "./tiered-kv.js";
 export * from "./timezones.js";
 //# 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,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kCAAkC,CAAA;AAChD,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kCAAkC,CAAA;AAChD,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA"}

package/dist/index.js

@@ -6,8 +6,12 @@ export * from "./kms.js";
 export * from "./kv.js";
 export * from "./languages.js";
 export * from "./localized-countries-regions.js";
+export * from "./memory-kv.js";
 export * from "./pdf-renderer.js";
+export * from "./redis-client.js";
+export * from "./redis-kv.js";
 export * from "./resilience.js";
 export * from "./template-renderer.js";
+export * from "./tiered-kv.js";
 export * from "./timezones.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kCAAkC,CAAA;AAChD,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kCAAkC,CAAA;AAChD,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA"}

package/dist/memory-kv.d.ts

@@ -0,0 +1,26 @@
+import type { KVStore } from "./cache.js";
+export type KvValueType = "text" | "json";
+export interface KvGetOptions {
+    type?: KvValueType;
+}
+export interface KvPutOptions {
+    /** TTL in seconds. The entry is treated as absent once it elapses. */
+    expirationTtl?: number;
+}
+/** Minimal KV surface consumed across Voyant packages. */
+export interface KvNamespaceShim extends KVStore {
+    get(key: string): Promise<string | null>;
+    get<T = unknown>(key: string, type: "json"): Promise<T | null>;
+    get<T = unknown>(key: string, options: KvGetOptions): Promise<T | string | null>;
+}
+export interface MemoryKvOptions {
+    /**
+     * Cap on resident entries before least-recently-used eviction. Defaults to
+     * 10,000. Set `0` to disable eviction.
+     */
+    maxEntries?: number;
+    /** Injectable clock (ms) for deterministic TTL tests. Defaults to `Date.now`. */
+    now?: () => number;
+}
+export declare function createMemoryKvNamespace(options?: MemoryKvOptions): KvNamespaceShim;
+//# sourceMappingURL=memory-kv.d.ts.map

package/dist/memory-kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-kv.d.ts","sourceRoot":"","sources":["../src/memory-kv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAA;AAEzC,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,WAAW,CAAA;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,0DAA0D;AAC1D,MAAM,WAAW,eAAgB,SAAQ,OAAO;IAC9C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACxC,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAC9D,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,CAAA;CACjF;AAED,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iFAAiF;IACjF,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB;AAUD,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,eAAoB,GAAG,eAAe,CA0DtF"}

package/dist/memory-kv.js

@@ -0,0 +1,58 @@
+const DEFAULT_MAX_ENTRIES = 10_000;
+export function createMemoryKvNamespace(options = {}) {
+    const maxEntries = options.maxEntries ?? DEFAULT_MAX_ENTRIES;
+    const now = options.now ?? Date.now;
+    const map = new Map();
+    function readFresh(key) {
+        const entry = map.get(key);
+        if (!entry)
+            return null;
+        if (entry.expiresAt <= now()) {
+            map.delete(key);
+            return null;
+        }
+        map.delete(key);
+        map.set(key, entry);
+        return entry.value;
+    }
+    async function get(key, typeOrOptions) {
+        const type = typeof typeOrOptions === "string" ? typeOrOptions : (typeOrOptions?.type ?? "text");
+        const raw = readFresh(key);
+        if (raw === null)
+            return null;
+        return type === "json" ? JSON.parse(raw) : raw;
+    }
+    return {
+        get: get,
+        async put(key, value, putOptions) {
+            if (map.has(key))
+                map.delete(key);
+            const expiresAt = putOptions?.expirationTtl === undefined
+                ? Number.POSITIVE_INFINITY
+                : now() + putOptions.expirationTtl * 1000;
+            map.set(key, { value, expiresAt });
+            if (maxEntries > 0) {
+                while (map.size > maxEntries) {
+                    const oldest = map.keys().next().value;
+                    if (oldest === undefined)
+                        break;
+                    map.delete(oldest);
+                }
+            }
+        },
+        async delete(key) {
+            map.delete(key);
+        },
+        async list(options) {
+            const prefix = options?.prefix ?? "";
+            const keys = [];
+            for (const key of [...map.keys()]) {
+                if (readFresh(key) !== null && key.startsWith(prefix)) {
+                    keys.push({ name: key });
+                }
+            }
+            return { keys };
+        },
+    };
+}
+//# sourceMappingURL=memory-kv.js.map

package/dist/memory-kv.js.map

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

package/dist/redis-client.d.ts

@@ -0,0 +1,18 @@
+export interface RedisClient {
+    get<T = unknown>(key: string): Promise<T | null>;
+    set(key: string, value: string, options?: {
+        ex?: number;
+    }): Promise<unknown>;
+    del(key: string): Promise<unknown>;
+    scan?(cursor: number, options?: {
+        match?: string;
+        count?: number;
+    }): Promise<[number | string, string[]]>;
+    incr(key: string): Promise<number>;
+    expire(key: string, seconds: number): Promise<unknown>;
+}
+export interface LazyRedisClient {
+    get(): Promise<RedisClient>;
+}
+export declare function createLazyRedisClient(redisUrl: string): LazyRedisClient;
+//# sourceMappingURL=redis-client.d.ts.map

package/dist/redis-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-client.d.ts","sourceRoot":"","sources":["../src/redis-client.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAChD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5E,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAClC,IAAI,CAAC,CACH,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IACvC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAClC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACvD;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;CAC5B;AAsBD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAYvE"}

package/dist/redis-client.js

@@ -0,0 +1,30 @@
+function parseRedisRestUrl(rawUrl) {
+    const parsed = new URL(rawUrl);
+    if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
+        throw new Error("REDIS_URL must be an HTTP(S) Redis REST URL.");
+    }
+    const token = parsed.password || parsed.searchParams.get("token") || "";
+    if (!token) {
+        throw new Error("REDIS_URL must include a Redis REST token as the URL password or token query.");
+    }
+    parsed.username = "";
+    parsed.password = "";
+    parsed.searchParams.delete("token");
+    return {
+        url: parsed.toString().replace(/\/$/, ""),
+        token: decodeURIComponent(token),
+    };
+}
+export function createLazyRedisClient(redisUrl) {
+    let clientPromise;
+    return {
+        get() {
+            clientPromise ??= import("@upstash/redis").then((mod) => {
+                const { url, token } = parseRedisRestUrl(redisUrl);
+                return new mod.Redis({ url, token });
+            });
+            return clientPromise;
+        },
+    };
+}
+//# sourceMappingURL=redis-client.js.map

package/dist/redis-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-client.js","sourceRoot":"","sources":["../src/redis-client.ts"],"names":[],"mappings":"AAwBA,SAAS,iBAAiB,CAAC,MAAc;IACvC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAA;IAC9B,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IACjE,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;IACvE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAA;IAClG,CAAC;IAED,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAA;IACpB,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAA;IACpB,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACnC,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QACzC,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC;KACjC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,IAAI,aAA+C,CAAA;IAEnD,OAAO;QACL,GAAG;YACD,aAAa,KAAK,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,GAAgB,EAAE,EAAE;gBACnE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAA;gBAClD,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAA;YACtC,CAAC,CAAC,CAAA;YACF,OAAO,aAAa,CAAA;QACtB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/redis-kv.d.ts

@@ -0,0 +1,7 @@
+import type { KVStore } from "./cache.js";
+import { type LazyRedisClient } from "./redis-client.js";
+export interface RedisKvStoreOptions {
+    client?: LazyRedisClient;
+}
+export declare function createRedisKvStore(redisUrl: string, options?: RedisKvStoreOptions): KVStore;
+//# sourceMappingURL=redis-kv.d.ts.map

package/dist/redis-kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-kv.d.ts","sourceRoot":"","sources":["../src/redis-kv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAE/E,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,eAAe,CAAA;CACzB;AAUD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAyC/F"}

package/dist/redis-kv.js

@@ -0,0 +1,47 @@
+import { createLazyRedisClient } from "./redis-client.js";
+function getType(options) {
+    return typeof options === "string" ? options : (options?.type ?? "text");
+}
+function scanPattern(prefix) {
+    return `${prefix.replaceAll("[", "\\[").replaceAll("*", "\\*")}*`;
+}
+export function createRedisKvStore(redisUrl, options = {}) {
+    const lazyClient = options.client ?? createLazyRedisClient(redisUrl);
+    return {
+        async get(key, options) {
+            const client = await lazyClient.get();
+            const value = await client.get(key);
+            if (value === null || value === undefined)
+                return null;
+            return (getType(options) === "json" && typeof value === "string" ? JSON.parse(value) : value);
+        },
+        async put(key, value, options) {
+            const client = await lazyClient.get();
+            if (options?.expirationTtl !== undefined) {
+                await client.set(key, value, { ex: Math.max(1, Math.ceil(options.expirationTtl)) });
+                return;
+            }
+            await client.set(key, value);
+        },
+        async delete(key) {
+            const client = await lazyClient.get();
+            await client.del(key);
+        },
+        async list(options) {
+            const client = await lazyClient.get();
+            if (!client.scan)
+                return { keys: [] };
+            const keys = [];
+            let cursor = 0;
+            const match = scanPattern(options?.prefix ?? "");
+            do {
+                const [nextCursor, batch] = await client.scan(Number(cursor), { match, count: 100 });
+                for (const name of batch)
+                    keys.push({ name });
+                cursor = nextCursor;
+            } while (String(cursor) !== "0");
+            return { keys };
+        },
+    };
+}
+//# sourceMappingURL=redis-kv.js.map

package/dist/redis-kv.js.map

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

package/dist/tiered-kv.d.ts

@@ -0,0 +1,10 @@
+import type { KVStore } from "./cache.js";
+export interface TieredKvOptions {
+    /**
+     * TTL for L2 hits promoted into L1 when the original remaining TTL is not
+     * visible through KVStore. Defaults to 60s to bound remote invalidation lag.
+     */
+    l2PromotionTtlSeconds?: number;
+}
+export declare function createTieredKvStore(l1: KVStore, l2: KVStore | null | undefined, options?: TieredKvOptions): KVStore;
+//# sourceMappingURL=tiered-kv.d.ts.map

package/dist/tiered-kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiered-kv.d.ts","sourceRoot":"","sources":["../src/tiered-kv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B;AAMD,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,OAAO,EACX,EAAE,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,EAC9B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CA+BT"}

package/dist/tiered-kv.js

@@ -0,0 +1,35 @@
+function getType(options) {
+    return typeof options === "string" ? options : (options?.type ?? "text");
+}
+export function createTieredKvStore(l1, l2, options = {}) {
+    const promotionTtl = options.l2PromotionTtlSeconds ?? 60;
+    if (!l2)
+        return l1;
+    return {
+        async get(key, getOptions) {
+            const l1Hit = await l1.get(key, getOptions);
+            if (l1Hit !== null && l1Hit !== undefined)
+                return l1Hit;
+            const raw = await l2.get(key);
+            if (raw === null || raw === undefined)
+                return null;
+            await l1.put(key, raw, { expirationTtl: promotionTtl }).catch(() => { });
+            return (getType(getOptions) === "json" ? JSON.parse(raw) : raw);
+        },
+        async put(key, value, putOptions) {
+            await Promise.all([
+                l2.put(key, value, putOptions),
+                l1.put(key, value, putOptions).catch(() => { }),
+            ]);
+        },
+        async delete(key) {
+            await Promise.all([l2.delete(key), l1.delete(key).catch(() => { })]);
+        },
+        async list(options) {
+            if (l2.list)
+                return l2.list(options);
+            return l1.list ? l1.list(options) : { keys: [] };
+        },
+    };
+}
+//# sourceMappingURL=tiered-kv.js.map

package/dist/tiered-kv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiered-kv.js","sourceRoot":"","sources":["../src/tiered-kv.ts"],"names":[],"mappings":"AAUA,SAAS,OAAO,CAAC,OAA6C;IAC5D,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,IAAI,MAAM,CAAC,CAAA;AAC1E,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,EAAW,EACX,EAA8B,EAC9B,UAA2B,EAAE;IAE7B,MAAM,YAAY,GAAG,OAAO,CAAC,qBAAqB,IAAI,EAAE,CAAA;IACxD,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAA;IAElB,OAAO;QACL,KAAK,CAAC,GAAG,CACP,GAAW,EACX,UAAgD;YAEhD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,GAAG,CAAI,GAAG,EAAE,UAAwC,CAAC,CAAA;YAC5E,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAA;YAEvD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,GAAG,CAAS,GAAG,CAAC,CAAA;YACrC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAA;YAClD,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YACvE,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAM,CAAA;QACtE,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,UAAuC;YAC3E,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChB,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC;gBAC9B,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;aAC/C,CAAC,CAAA;QACJ,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,GAAW;YACtB,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QACrE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,OAA6B;YACtC,IAAI,EAAE,CAAC,IAAI;gBAAE,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACpC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;QAClD,CAAC;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/utils",
-  "version": "0.105.5",
+  "version": "0.106.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -75,6 +75,26 @@
       "import": "./dist/cache.js",
       "default": "./dist/cache.js"
     },
+    "./memory-kv": {
+      "types": "./dist/memory-kv.d.ts",
+      "import": "./dist/memory-kv.js",
+      "default": "./dist/memory-kv.js"
+    },
+    "./redis-client": {
+      "types": "./dist/redis-client.d.ts",
+      "import": "./dist/redis-client.js",
+      "default": "./dist/redis-client.js"
+    },
+    "./redis-kv": {
+      "types": "./dist/redis-kv.d.ts",
+      "import": "./dist/redis-kv.js",
+      "default": "./dist/redis-kv.js"
+    },
+    "./tiered-kv": {
+      "types": "./dist/tiered-kv.d.ts",
+      "import": "./dist/tiered-kv.js",
+      "default": "./dist/tiered-kv.js"
+    },
     "./resilience": {
       "types": "./dist/resilience.d.ts",
       "import": "./dist/resilience.js",
@@ -102,7 +122,10 @@
     "pdf-lib": "^1.17.1",
     "zod": "^4.4.3",
     "@voyant-travel/templating": "^0.104.1",
-    "@voyant-travel/types": "^0.106.1"
+    "@voyant-travel/types": "^0.107.1"
+  },
+  "optionalDependencies": {
+    "@upstash/redis": "^1.35.6"
   },
   "devDependencies": {
     "@types/node": "^25.5.2",