@c15t/backend 1.8.0 → 2.0.0-rc.1

package/.turbo/turbo-build.log

@@ -1,83 +1,49 @@
+$ genversion --esm --semi src/version.ts
+$ bun prebuild && rslib build
+$ genversion --esm --semi src/version.ts
 
-> @c15t/backend@1.8.0 build /home/runner/work/c15t/c15t/packages/backend
-> pnpm prebuild && rslib build
-
-
-> @c15t/backend@1.8.0 prebuild /home/runner/work/c15t/c15t/packages/backend
-> genversion --esm --semi src/version.ts
-
-  Rslib v0.17.0
+  Rslib v0.18.3
 
 info    build started...
-start   generating declaration files... (cjs)
+ready   built in 0.39 s (esm)
+ready   built in 0.39 s (cjs)
 start   generating declaration files... (esm)
-ready   built in 0.97 s (esm)
-ready   built in 0.97 s (cjs)
-ready   declaration files generated in 11.6 s (cjs)
-ready   declaration files generated in 11.6 s (esm)
-
-File (cjs)                                                 Size        
-dist/pkgs/types/index.cjs                                  0.60 kB  
-dist/v2/db/adapters/index.cjs                              0.60 kB  
-dist/v2/define-config.cjs                                  1.3 kB   
-dist/v2/types/index.cjs                                    1.3 kB   
-dist/v2/db/adapters/mongo.cjs                              1.3 kB   
-dist/v2/db/adapters/prisma.cjs                             1.3 kB   
-dist/v2/db/adapters/kysely.cjs                             1.3 kB   
-dist/v2/db/adapters/typeorm.cjs                            1.3 kB   
-dist/v2/db/adapters/drizzle.cjs                            1.3 kB   
-dist/v2/db/migrator/index.cjs                              2.1 kB   
-dist/pkgs/data-model/fields/index.cjs                      6.5 kB   
-dist/v2/db/schema/index.cjs                                16.8 kB  
-dist/pkgs/results/index.cjs                                18.5 kB  
-dist/v2/contracts/index.cjs                                32.6 kB  
-dist/contracts.cjs                                         34.6 kB  
-dist/pkgs/db-adapters/adapters/memory-adapter/index.cjs    44.6 kB  
-dist/pkgs/db-adapters/adapters/prisma-adapter/index.cjs    47.8 kB  
-dist/pkgs/db-adapters/adapters/drizzle-adapter/index.cjs   50.1 kB  
-dist/pkgs/migrations/index.cjs                             51.6 kB  
-dist/pkgs/db-adapters/adapters/kysely-adapter/index.cjs    55.7 kB  
-dist/v2/router.cjs                                         58.5 kB  
-dist/pkgs/data-model/schema/index.cjs                      63.4 kB  
-dist/schema/index.cjs                                      63.9 kB  
-dist/pkgs/data-model/index.cjs                             65.5 kB  
-dist/router.cjs                                            79.9 kB  
-dist/pkgs/db-adapters/index.cjs                            90.2 kB  
-dist/v2/core.cjs                                           92.3 kB  
-dist/core.cjs                                              164.5 kB 
-
-                                                  Total:   1049.3 kB
-
-
-File (esm)                                                Size       
-dist/v2/db/adapters/index.js                              0.00 kB 
-dist/pkgs/types/index.js                                  0.00 kB 
-dist/v2/define-config.js                                  0.06 kB 
-dist/v2/db/adapters/mongo.js                              0.08 kB 
-dist/v2/types/index.js                                    0.08 kB 
-dist/v2/db/adapters/prisma.js                             0.08 kB 
-dist/v2/db/adapters/kysely.js                             0.08 kB 
-dist/v2/db/adapters/drizzle.js                            0.09 kB 
-dist/v2/db/adapters/typeorm.js                            0.09 kB 
-dist/v2/db/migrator/index.js                              0.96 kB 
-dist/pkgs/data-model/fields/index.js                      3.4 kB  
-dist/v2/db/schema/index.js                                9.3 kB  
-dist/pkgs/results/index.js                                14.9 kB 
-dist/contracts.js                                         19.5 kB 
-dist/v2/contracts/index.js                                21.9 kB 
-dist/pkgs/db-adapters/adapters/memory-adapter/index.js    34.5 kB 
-dist/pkgs/migrations/index.js                             40.4 kB 
-dist/pkgs/db-adapters/adapters/prisma-adapter/index.js    42.5 kB 
-dist/pkgs/db-adapters/adapters/drizzle-adapter/index.js   44.2 kB 
-dist/pkgs/db-adapters/adapters/kysely-adapter/index.js    45.0 kB 
-dist/v2/router.js                                         46.9 kB 
-dist/pkgs/data-model/schema/index.js                      55.8 kB 
-dist/schema/index.js                                      56.1 kB 
-dist/pkgs/data-model/index.js                             56.8 kB 
-dist/router.js                                            64.2 kB 
-dist/v2/core.js                                           79.9 kB 
-dist/pkgs/db-adapters/index.js                            83.4 kB 
-dist/core.js                                              152.6 kB
-
-                                                 Total:   872.9 kB
+start   generating declaration files... (cjs)
+ready   declaration files generated in 6.60 s (cjs)
+ready   declaration files generated in 6.67 s (esm)
+
+File (esm)                    Size       
+dist/db/adapters.js           0.00 kB 
+dist/define-config.js         0.06 kB 
+dist/db/adapters/mongo.js     0.08 kB 
+dist/db/adapters/prisma.js    0.08 kB 
+dist/db/adapters/kysely.js    0.08 kB 
+dist/db/adapters/drizzle.js   0.09 kB 
+dist/db/adapters/typeorm.js   0.09 kB 
+dist/types.js                 0.11 kB 
+dist/db/migrator.js           0.96 kB 
+dist/db/schema.js             11.1 kB 
+dist/cache.js                 17.4 kB 
+dist/router.js                54.5 kB 
+dist/core.js                  98.6 kB 
+
+                     Total:   183.2 kB
+
+
+File (cjs)                     Size       
+dist/db/adapters.cjs           0.59 kB 
+dist/define-config.cjs         1.2 kB  
+dist/db/adapters/mongo.cjs     1.3 kB  
+dist/db/adapters/kysely.cjs    1.3 kB  
+dist/db/adapters/prisma.cjs    1.3 kB  
+dist/types.cjs                 1.3 kB  
+dist/db/adapters/drizzle.cjs   1.3 kB  
+dist/db/adapters/typeorm.cjs   1.3 kB  
+dist/db/migrator.cjs           2.1 kB  
+dist/db/schema.cjs             19.1 kB 
+dist/cache.cjs                 20.0 kB 
+dist/router.cjs                58.7 kB 
+dist/core.cjs                  119.1 kB
+
+                      Total:   228.7 kB
 

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @c15t/backend
 
+## 2.0.0-rc.1
+
+### Patch Changes
+
+- 0bc4f86: fixed workspace resolving
+- Updated dependencies [0bc4f86]
+  - @c15t/translations@2.0.0-rc.1
+  - @c15t/logger@2.0.0-rc.1
+  - @c15t/schema@2.0.0-rc.1
+
+## 2.0.0-rc.0
+
+### Major Changes
+
+- 126a78b: https://v2.c15t.com/changelog/2026-02-12-v2.0.0-rc.0
+
+### Patch Changes
+
+- Updated dependencies [126a78b]
+  - @c15t/logger@2.0.0-rc.0
+  - @c15t/schema@2.0.0-rc.0
+  - @c15t/translations@2.0.0-rc.0
+
 ## 1.8.0
 
 ### Minor Changes

package/dist/cache/adapters/cloudflare-kv.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Cloudflare KV Cache Adapter
+ *
+ * Cache adapter for Cloudflare Workers KV storage.
+ *
+ * @packageDocumentation
+ */
+import type { CacheAdapter } from '../types';
+/**
+ * Cloudflare KV Namespace interface.
+ * Matches the KVNamespace type from @cloudflare/workers-types.
+ *
+ * @public
+ */
+export interface KVNamespace {
+    get(key: string, options?: {
+        type?: 'text' | 'json';
+    }): Promise<unknown>;
+    put(key: string, value: string, options?: {
+        expirationTtl?: number;
+    }): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+/**
+ * Creates a Cloudflare KV cache adapter.
+ *
+ * @param kv - Cloudflare KV namespace binding
+ * @returns A CacheAdapter backed by Cloudflare KV
+ *
+ * @example
+ * ```typescript
+ * // In your Cloudflare Worker
+ * export default {
+ *   async fetch(request, env) {
+ *     const kvAdapter = createCloudflareKVAdapter(env.GVL_CACHE);
+ *
+ *     await kvAdapter.set('key', { data: 'value' }, 3600000);
+ *     const value = await kvAdapter.get('key');
+ *   }
+ * };
+ * ```
+ *
+ * @public
+ */
+export declare function createCloudflareKVAdapter(kv: KVNamespace): CacheAdapter;
+//# sourceMappingURL=cloudflare-kv.d.ts.map

package/dist/cache/adapters/cloudflare-kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-kv.d.ts","sourceRoot":"","sources":["../../../src/cache/adapters/cloudflare-kv.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC3B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,GAAG,CACF,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAClC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,WAAW,GAAG,YAAY,CAsBvE"}

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

@@ -0,0 +1,11 @@
+/**
+ * Cache Adapters
+ *
+ * Pluggable cache adapter implementations for different storage backends.
+ *
+ * @packageDocumentation
+ */
+export { createCloudflareKVAdapter, type KVNamespace, } from './cloudflare-kv';
+export { clearMemoryCache, createMemoryCacheAdapter, getMemoryCacheSize, } from './memory';
+export { createUpstashRedisAdapter, createUpstashRedisAdapterFromClient, type UpstashRedisAdapterOptions, } from './upstash-redis';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cache/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACN,yBAAyB,EACzB,KAAK,WAAW,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,yBAAyB,EACzB,mCAAmC,EACnC,KAAK,0BAA0B,GAC/B,MAAM,iBAAiB,CAAC"}

package/dist/cache/adapters/memory.d.ts

@@ -0,0 +1,47 @@
+/**
+ * In-Memory Cache Adapter
+ *
+ * A simple Map-based cache adapter with TTL support.
+ * Used as the default first layer in the cache resolution chain.
+ *
+ * @packageDocumentation
+ */
+import type { CacheAdapter } from '../types';
+/**
+ * Creates an in-memory cache adapter.
+ *
+ * Features:
+ * - Uses a shared Map for fast access
+ * - Supports TTL with lazy expiration
+ * - Always used as the first cache layer by default
+ *
+ * @returns A CacheAdapter implementation backed by in-memory Map
+ *
+ * @example
+ * ```typescript
+ * const memoryAdapter = createMemoryCacheAdapter();
+ *
+ * await memoryAdapter.set('key', { data: 'value' }, 60000); // 1 minute TTL
+ * const value = await memoryAdapter.get('key');
+ * ```
+ *
+ * @public
+ */
+export declare function createMemoryCacheAdapter(): CacheAdapter;
+/**
+ * Clears the entire in-memory cache.
+ * Primarily used for testing.
+ *
+ * @public
+ */
+export declare function clearMemoryCache(): void;
+/**
+ * Gets the current size of the in-memory cache.
+ * Primarily used for debugging and monitoring.
+ *
+ * @returns The number of entries in the cache (may include expired entries)
+ *
+ * @public
+ */
+export declare function getMemoryCacheSize(): number;
+//# sourceMappingURL=memory.d.ts.map

package/dist/cache/adapters/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/cache/adapters/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAc7C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,IAAI,YAAY,CA6CvD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/cache/adapters/upstash-redis.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Upstash Redis Cache Adapter
+ *
+ * Cache adapter for Upstash Redis, suitable for serverless environments.
+ *
+ * Requires @upstash/redis to be installed as a peer dependency.
+ *
+ * @packageDocumentation
+ */
+import { Redis } from '@upstash/redis';
+import type { CacheAdapter } from '../types';
+/**
+ * Options for creating an Upstash Redis adapter.
+ *
+ * @public
+ */
+export interface UpstashRedisAdapterOptions {
+    /**
+     * Upstash Redis REST URL.
+     */
+    url: string;
+    /**
+     * Upstash Redis REST token.
+     */
+    token: string;
+}
+/**
+ * Creates an Upstash Redis cache adapter.
+ *
+ * **Note:** Requires `@upstash/redis` to be installed as a peer dependency.
+ *
+ * @param options - Upstash Redis connection options
+ * @returns A CacheAdapter backed by Upstash Redis
+ *
+ * @example
+ * ```typescript
+ * import { createUpstashRedisAdapter } from '@c15t/backend/cache';
+ *
+ * const redisAdapter = createUpstashRedisAdapter({
+ *   url: process.env.UPSTASH_REDIS_REST_URL,
+ *   token: process.env.UPSTASH_REDIS_REST_TOKEN,
+ * });
+ *
+ * await redisAdapter.set('key', { data: 'value' }, 3600000); // 1 hour TTL
+ * const value = await redisAdapter.get('key');
+ * ```
+ *
+ * @public
+ */
+export declare function createUpstashRedisAdapter(options: UpstashRedisAdapterOptions): CacheAdapter;
+/**
+ * Creates an Upstash Redis cache adapter from an existing client.
+ *
+ * Use this if you already have an @upstash/redis client instance.
+ *
+ * @param client - An existing Upstash Redis client
+ * @returns A CacheAdapter backed by the provided client
+ *
+ * @example
+ * ```typescript
+ * import { Redis } from '@upstash/redis';
+ * import { createUpstashRedisAdapterFromClient } from '@c15t/backend/cache';
+ *
+ * const redis = new Redis({
+ *   url: process.env.UPSTASH_REDIS_REST_URL,
+ *   token: process.env.UPSTASH_REDIS_REST_TOKEN,
+ * });
+ *
+ * const adapter = createUpstashRedisAdapterFromClient(redis);
+ * ```
+ *
+ * @public
+ */
+export declare function createUpstashRedisAdapterFromClient(client: Redis): CacheAdapter;
+//# sourceMappingURL=upstash-redis.d.ts.map

package/dist/cache/adapters/upstash-redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstash-redis.d.ts","sourceRoot":"","sources":["../../../src/cache/adapters/upstash-redis.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IAC1C;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,yBAAyB,CACxC,OAAO,EAAE,0BAA0B,GACjC,YAAY,CAOd;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,mCAAmC,CAClD,MAAM,EAAE,KAAK,GACX,YAAY,CAsBd"}

package/dist/cache/gvl-resolver.d.ts

@@ -0,0 +1,86 @@
+/**
+ * GVL Resolution Service
+ *
+ * Resolves Global Vendor List with multi-layer caching:
+ * 1. Bundled translations (checked first)
+ * 2. In-memory cache
+ * 3. External cache (Redis/KV)
+ * 4. Fetch from gvl.consent.io
+ *
+ * @packageDocumentation
+ */
+import type { GlobalVendorList } from '@c15t/schema/types';
+import type { CacheAdapter } from './types';
+/**
+ * Options for creating a GVL resolver.
+ *
+ * @public
+ */
+export interface GVLResolverOptions {
+    /**
+     * The application name for cache key prefixing.
+     */
+    appName: string;
+    /**
+     * Bundled GVL translations by language code.
+     * These are checked first before any cache.
+     */
+    bundled?: Record<string, GlobalVendorList>;
+    /**
+     * External cache adapter (Redis, KV, etc.).
+     * If not provided, only in-memory cache is used.
+     */
+    cacheAdapter?: CacheAdapter;
+    /**
+     * Vendor IDs to filter when fetching from the GVL endpoint.
+     * Reduces payload size.
+     */
+    vendorIds?: number[];
+    /**
+     * Override the default GVL endpoint.
+     * @default 'https://gvl.consent.io'
+     */
+    endpoint?: string;
+}
+/**
+ * GVL resolver interface.
+ *
+ * @public
+ */
+export interface GVLResolver {
+    /**
+     * Get a localized GVL for the specified language.
+     *
+     * @param language - Language code (e.g., "en", "de")
+     * @returns The GVL for the language, or null if unavailable
+     */
+    get(language: string): Promise<GlobalVendorList | null>;
+}
+/**
+ * Creates a GVL resolver with multi-layer caching.
+ *
+ * Resolution order:
+ * 1. **Bundled** - Check bundled translations (0ms)
+ * 2. **In-Memory** - Check worker/process memory cache (0ms)
+ * 3. **External Cache** - Check Redis/KV if configured (20-40ms)
+ * 4. **Fetch** - Fetch from gvl.consent.io with Accept-Language (100-300ms)
+ *
+ * @param options - Resolver configuration
+ * @returns A GVL resolver instance
+ *
+ * @example
+ * ```typescript
+ * const resolver = createGVLResolver({
+ *   appName: 'my-app',
+ *   bundled: { en: enGVL },
+ *   cacheAdapter: redisAdapter,
+ *   vendorIds: [1, 2, 10],
+ * });
+ *
+ * const gvl = await resolver.get('de');
+ * ```
+ *
+ * @public
+ */
+export declare function createGVLResolver(options: GVLResolverOptions): GVLResolver;
+//# sourceMappingURL=gvl-resolver.d.ts.map

package/dist/cache/gvl-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gvl-resolver.d.ts","sourceRoot":"","sources":["../../src/cache/gvl-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAK3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAQ5C;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAE3C;;;OAGG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC3B;;;;;OAKG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CACxD;AAiID;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CA2D1E"}

package/dist/cache/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Cache Module
+ *
+ * Multi-layer caching system with pluggable adapters for GVL and other data.
+ *
+ * @packageDocumentation
+ */
+export { clearMemoryCache, createCloudflareKVAdapter, createMemoryCacheAdapter, createUpstashRedisAdapter, createUpstashRedisAdapterFromClient, getMemoryCacheSize, type KVNamespace, type UpstashRedisAdapterOptions, } from './adapters';
+export { createGVLResolver, type GVLResolver, type GVLResolverOptions, } from './gvl-resolver';
+export { createCacheKey, createGVLCacheKey } from './keys';
+export type { CacheAdapter } from './types';
+export { GVL_TTL_MS, MEMORY_TTL_MS } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACN,gBAAgB,EAEhB,yBAAyB,EAEzB,wBAAwB,EAExB,yBAAyB,EACzB,mCAAmC,EACnC,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,0BAA0B,GAC/B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACN,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAE3D,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/dist/cache/keys.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Cache Key Utilities
+ *
+ * Functions for generating consistent cache keys with app name prefixing.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Create a GVL cache key.
+ *
+ * Format: `{appName}:gvl:{language}:{sortedVendorIds}`
+ *
+ * @param appName - The application name for key prefixing
+ * @param language - The language code (e.g., "en", "de")
+ * @param vendorIds - Optional array of vendor IDs to include in the key
+ * @returns A unique cache key for the GVL configuration
+ *
+ * @example
+ * ```typescript
+ * // All vendors
+ * createGVLCacheKey('my-app', 'en');
+ * // => 'my-app:gvl:en:all'
+ *
+ * // Specific vendors
+ * createGVLCacheKey('my-app', 'de', [1, 10, 2]);
+ * // => 'my-app:gvl:de:1,2,10'
+ * ```
+ *
+ * @public
+ */
+export declare function createGVLCacheKey(appName: string, language: string, vendorIds?: number[]): string;
+/**
+ * Create a generic cache key with namespace and parts.
+ *
+ * Format: `{appName}:{namespace}:{part1}:{part2}:...`
+ *
+ * @param appName - The application name for key prefixing
+ * @param namespace - The cache namespace (e.g., "gvl", "translations")
+ * @param parts - Additional key parts
+ * @returns A namespaced cache key
+ *
+ * @example
+ * ```typescript
+ * createCacheKey('my-app', 'translations', 'en', 'banner');
+ * // => 'my-app:translations:en:banner'
+ * ```
+ *
+ * @public
+ */
+export declare function createCacheKey(appName: string, namespace: string, ...parts: (string | number)[]): string;
+//# sourceMappingURL=keys.d.ts.map

package/dist/cache/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/cache/keys.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAAE,GAClB,MAAM,CAKR;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,GAAG,KAAK,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAC3B,MAAM,CAGR"}

package/dist/cache/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Cache Adapter Types
+ *
+ * Generic cache adapter interface for pluggable caching implementations.
+ * Supports in-memory, Redis, Cloudflare KV, and custom adapters.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Generic cache adapter interface.
+ *
+ * Implementations should handle serialization/deserialization internally.
+ * All methods are async to support both sync (memory) and async (Redis/KV) backends.
+ *
+ * @public
+ */
+export interface CacheAdapter {
+    /**
+     * Get a value from the cache.
+     *
+     * @param key - Cache key
+     * @returns The cached value, or null if not found or expired
+     */
+    get<T>(key: string): Promise<T | null>;
+    /**
+     * Set a value in the cache.
+     *
+     * @param key - Cache key
+     * @param value - Value to cache
+     * @param ttlMs - Time to live in milliseconds (optional)
+     */
+    set<T>(key: string, value: T, ttlMs?: number): Promise<void>;
+    /**
+     * Delete a value from the cache.
+     *
+     * @param key - Cache key
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Check if a key exists in the cache.
+     *
+     * @param key - Cache key
+     * @returns True if the key exists and is not expired
+     */
+    has(key: string): Promise<boolean>;
+}
+/**
+ * Default TTL for GVL cache entries (3 days).
+ * Matches the typical GVL update frequency.
+ *
+ * @public
+ */
+export declare const GVL_TTL_MS: number;
+/**
+ * Default TTL for in-memory cache entries (5 minutes).
+ * Shorter TTL to handle worker restarts and keep memory usage low.
+ *
+ * @public
+ */
+export declare const MEMORY_TTL_MS: number;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC5B;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvC;;;;;;OAMG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7D;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,QAA0B,CAAC;AAElD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAAgB,CAAC"}