raffel 1.1.70 → 1.1.72

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (117) hide show
  1. package/dist/cache/defaults.d.ts +9 -0
  2. package/dist/cache/defaults.d.ts.map +1 -0
  3. package/dist/cache/defaults.js +9 -0
  4. package/dist/cache/defaults.js.map +1 -0
  5. package/dist/cache/expiration-wheel.d.ts +15 -0
  6. package/dist/cache/expiration-wheel.d.ts.map +1 -0
  7. package/dist/cache/expiration-wheel.js +65 -0
  8. package/dist/cache/expiration-wheel.js.map +1 -0
  9. package/dist/cache/fs-layer.d.ts +14 -0
  10. package/dist/cache/fs-layer.d.ts.map +1 -0
  11. package/dist/cache/fs-layer.js +190 -0
  12. package/dist/cache/fs-layer.js.map +1 -0
  13. package/dist/cache/index.d.ts +9 -0
  14. package/dist/cache/index.d.ts.map +1 -1
  15. package/dist/cache/index.js +4 -0
  16. package/dist/cache/index.js.map +1 -1
  17. package/dist/cache/key.d.ts +11 -0
  18. package/dist/cache/key.d.ts.map +1 -0
  19. package/dist/cache/key.js +41 -0
  20. package/dist/cache/key.js.map +1 -0
  21. package/dist/cache/redis-layer.d.ts +30 -0
  22. package/dist/cache/redis-layer.d.ts.map +1 -0
  23. package/dist/cache/redis-layer.js +108 -0
  24. package/dist/cache/redis-layer.js.map +1 -0
  25. package/dist/cache/server-runtime.d.ts +74 -0
  26. package/dist/cache/server-runtime.d.ts.map +1 -0
  27. package/dist/cache/server-runtime.js +220 -0
  28. package/dist/cache/server-runtime.js.map +1 -0
  29. package/dist/cache/tiered.d.ts +86 -0
  30. package/dist/cache/tiered.d.ts.map +1 -0
  31. package/dist/cache/tiered.js +681 -0
  32. package/dist/cache/tiered.js.map +1 -0
  33. package/dist/cache/write-behind-queue.d.ts +34 -0
  34. package/dist/cache/write-behind-queue.d.ts.map +1 -0
  35. package/dist/cache/write-behind-queue.js +115 -0
  36. package/dist/cache/write-behind-queue.js.map +1 -0
  37. package/dist/http/app.d.ts.map +1 -1
  38. package/dist/http/app.js +1 -0
  39. package/dist/http/app.js.map +1 -1
  40. package/dist/http/cache.d.ts +22 -0
  41. package/dist/http/cache.d.ts.map +1 -0
  42. package/dist/http/cache.js +183 -0
  43. package/dist/http/cache.js.map +1 -0
  44. package/dist/http/index.d.ts +2 -0
  45. package/dist/http/index.d.ts.map +1 -1
  46. package/dist/http/index.js +1 -0
  47. package/dist/http/index.js.map +1 -1
  48. package/dist/index.d.ts +2 -2
  49. package/dist/index.d.ts.map +1 -1
  50. package/dist/index.js +1 -1
  51. package/dist/index.js.map +1 -1
  52. package/dist/server/builder/operation-registrar.d.ts +3 -0
  53. package/dist/server/builder/operation-registrar.d.ts.map +1 -1
  54. package/dist/server/builder/operation-registrar.js +7 -2
  55. package/dist/server/builder/operation-registrar.js.map +1 -1
  56. package/dist/server/builder/programmatic-registration.d.ts +2 -0
  57. package/dist/server/builder/programmatic-registration.d.ts.map +1 -1
  58. package/dist/server/builder/programmatic-registration.js +13 -2
  59. package/dist/server/builder/programmatic-registration.js.map +1 -1
  60. package/dist/server/builder.d.ts.map +1 -1
  61. package/dist/server/builder.js +17 -3
  62. package/dist/server/builder.js.map +1 -1
  63. package/dist/server/discovery-utils.d.ts +2 -1
  64. package/dist/server/discovery-utils.d.ts.map +1 -1
  65. package/dist/server/discovery-utils.js +10 -2
  66. package/dist/server/discovery-utils.js.map +1 -1
  67. package/dist/server/fs-routes/types.d.ts +3 -0
  68. package/dist/server/fs-routes/types.d.ts.map +1 -1
  69. package/dist/server/handler-builders.d.ts +2 -0
  70. package/dist/server/handler-builders.d.ts.map +1 -1
  71. package/dist/server/handler-builders.js +7 -0
  72. package/dist/server/handler-builders.js.map +1 -1
  73. package/dist/server/interceptor-utils.d.ts +2 -0
  74. package/dist/server/interceptor-utils.d.ts.map +1 -1
  75. package/dist/server/interceptor-utils.js +25 -1
  76. package/dist/server/interceptor-utils.js.map +1 -1
  77. package/dist/server/router-module.d.ts +3 -0
  78. package/dist/server/router-module.d.ts.map +1 -1
  79. package/dist/server/router-module.js +1 -0
  80. package/dist/server/router-module.js.map +1 -1
  81. package/dist/server/types/config-types.d.ts +3 -0
  82. package/dist/server/types/config-types.d.ts.map +1 -1
  83. package/dist/server/types/handler-types.d.ts +7 -0
  84. package/dist/server/types/handler-types.d.ts.map +1 -1
  85. package/dist/server/types/lifecycle-types.d.ts +2 -0
  86. package/dist/server/types/lifecycle-types.d.ts.map +1 -1
  87. package/dist/server/types/protocol-namespace-types.d.ts +3 -0
  88. package/dist/server/types/protocol-namespace-types.d.ts.map +1 -1
  89. package/dist/ui/cache/defaults.d.ts +9 -0
  90. package/dist/ui/cache/defaults.d.ts.map +1 -0
  91. package/dist/ui/cache/expiration-wheel.d.ts +15 -0
  92. package/dist/ui/cache/expiration-wheel.d.ts.map +1 -0
  93. package/dist/ui/cache/fs-layer.d.ts +14 -0
  94. package/dist/ui/cache/fs-layer.d.ts.map +1 -0
  95. package/dist/ui/cache/key.d.ts +11 -0
  96. package/dist/ui/cache/key.d.ts.map +1 -0
  97. package/dist/ui/cache/server-runtime.d.ts +74 -0
  98. package/dist/ui/cache/server-runtime.d.ts.map +1 -0
  99. package/dist/ui/cache/tiered.d.ts +86 -0
  100. package/dist/ui/cache/tiered.d.ts.map +1 -0
  101. package/dist/ui/cache/write-behind-queue.d.ts +34 -0
  102. package/dist/ui/cache/write-behind-queue.d.ts.map +1 -0
  103. package/dist/ui/server/fs-routes/types.d.ts +3 -0
  104. package/dist/ui/server/fs-routes/types.d.ts.map +1 -1
  105. package/dist/ui/validation/index.d.ts +1 -1
  106. package/dist/ui/validation/index.d.ts.map +1 -1
  107. package/dist/ui/validation/schema.d.ts +7 -0
  108. package/dist/ui/validation/schema.d.ts.map +1 -1
  109. package/dist/validation/index.d.ts +1 -1
  110. package/dist/validation/index.d.ts.map +1 -1
  111. package/dist/validation/index.js +1 -1
  112. package/dist/validation/index.js.map +1 -1
  113. package/dist/validation/schema.d.ts +7 -0
  114. package/dist/validation/schema.d.ts.map +1 -1
  115. package/dist/validation/schema.js +36 -2
  116. package/dist/validation/schema.js.map +1 -1
  117. package/package.json +5 -1
@@ -0,0 +1,74 @@
1
+ import type { Context, Interceptor } from '../types/index.js';
2
+ import { type CacheIdentityScope } from './key.js';
3
+ import { type CacheCircuitBreakerOptions, type CacheWriteOptions, type TieredCache, type TieredCacheOptions } from './tiered.js';
4
+ import type { WriteBehindQueueOptions } from './write-behind-queue.js';
5
+ export interface RouteCacheConfig extends CacheWriteOptions {
6
+ enabled?: boolean;
7
+ scope?: CacheIdentityScope;
8
+ version?: string;
9
+ }
10
+ export interface CacheRule extends RouteCacheConfig {
11
+ match: string;
12
+ }
13
+ interface CacheLayerConfigBase {
14
+ id?: string;
15
+ enabled?: boolean;
16
+ ttlMs?: number;
17
+ writeBehind?: WriteBehindQueueOptions;
18
+ /** Maximum time spent on one layer read before failing open. */
19
+ timeoutMs?: number;
20
+ /** Maximum time spent on one layer mutation before failing open. */
21
+ operationTimeoutMs?: number;
22
+ /** Read circuit breaker; set false to disable it. */
23
+ circuitBreaker?: CacheCircuitBreakerOptions | false;
24
+ }
25
+ export interface MemoryLayerConfig extends CacheLayerConfigBase {
26
+ driver: 'memory';
27
+ maxMemoryBytes?: number;
28
+ maxEntries?: number;
29
+ eviction?: 'lru' | 'fifo';
30
+ }
31
+ export interface FileSystemLayerConfig extends CacheLayerConfigBase {
32
+ driver: 'fs';
33
+ directory?: string;
34
+ maxSizeBytes?: number;
35
+ maxFiles?: number;
36
+ }
37
+ export interface ProviderLayerConfig extends CacheLayerConfigBase {
38
+ driver: 'provider';
39
+ provider: string;
40
+ }
41
+ export type ServerCacheLayerConfig = MemoryLayerConfig | FileSystemLayerConfig | ProviderLayerConfig;
42
+ export interface ServerCacheConfig {
43
+ enabled: boolean;
44
+ namespace?: string;
45
+ layers: ServerCacheLayerConfig[];
46
+ rules?: CacheRule[];
47
+ writeBehind?: WriteBehindQueueOptions;
48
+ onLayerError?: TieredCacheOptions['onLayerError'];
49
+ }
50
+ export interface ServerCacheController {
51
+ invalidate(key: string): Promise<void>;
52
+ clear(): Promise<void>;
53
+ keyForProcedure(procedure: string, input: unknown, ctx: Context, options?: Pick<RouteCacheConfig, 'scope' | 'version'>): string | undefined;
54
+ invalidateProcedure(procedure: string, input: unknown, ctx: Context, options?: Pick<RouteCacheConfig, 'scope' | 'version'>): Promise<boolean>;
55
+ stats(): ReturnType<TieredCache['stats']>;
56
+ }
57
+ export declare class ServerCacheRuntime {
58
+ private readonly config;
59
+ private current;
60
+ private binders;
61
+ private readonly pending;
62
+ readonly controller: ServerCacheController;
63
+ constructor(config: ServerCacheConfig);
64
+ get cache(): TieredCache;
65
+ interceptorFor(procedure: string, explicit?: RouteCacheConfig | false): Interceptor | undefined;
66
+ bind(services: Readonly<Record<string, unknown>>): void;
67
+ executeOnce(key: string, next: () => Promise<unknown>, config: RouteCacheConfig): Promise<unknown>;
68
+ revalidate(key: string, next: () => Promise<unknown>, config: RouteCacheConfig): void;
69
+ start(): void;
70
+ stop(): Promise<void>;
71
+ }
72
+ export declare function createServerCacheRuntime(config: ServerCacheConfig | false | undefined): ServerCacheRuntime | undefined;
73
+ export {};
74
+ //# sourceMappingURL=server-runtime.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server-runtime.d.ts","sourceRoot":"","sources":["../../src/cache/server-runtime.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,220 @@
1
+ import { matchProcedurePattern } from '../utils/pattern-match.js';
2
+ import { createFileSystemCacheLayer } from './fs-layer.js';
3
+ import { procedureCacheKey, procedureCacheKeyFor } from './key.js';
4
+ import { createMemoryCacheLayer, createTieredCache, } from './tiered.js';
5
+ function providerLayer(config, id) {
6
+ let delegate;
7
+ const requireDelegate = () => {
8
+ if (!delegate)
9
+ throw new Error(`Cache provider "${config.provider}" is not available`);
10
+ return delegate;
11
+ };
12
+ return {
13
+ bind(services) {
14
+ const candidate = services[config.provider];
15
+ if (candidate &&
16
+ typeof candidate === 'object' &&
17
+ 'get' in candidate &&
18
+ 'set' in candidate &&
19
+ 'delete' in candidate &&
20
+ 'clearNamespace' in candidate) {
21
+ delegate = candidate;
22
+ }
23
+ },
24
+ layer: {
25
+ id,
26
+ ttlMs: config.ttlMs ?? 60 * 60_000,
27
+ writeBehind: config.writeBehind,
28
+ readTimeoutMs: config.timeoutMs ?? 100,
29
+ operationTimeoutMs: config.operationTimeoutMs,
30
+ circuitBreaker: config.circuitBreaker === false
31
+ ? { failureThreshold: Number.MAX_SAFE_INTEGER }
32
+ : config.circuitBreaker,
33
+ get: (key) => requireDelegate().get(key),
34
+ set: (key, record, ttlMs, staleMs) => requireDelegate().set(key, record, ttlMs, staleMs),
35
+ delete: (key) => requireDelegate().delete(key),
36
+ clearNamespace: (namespace) => requireDelegate().clearNamespace(namespace),
37
+ stats: () => delegate?.stats?.() ?? { totalItems: 0 },
38
+ shutdown: () => delegate?.shutdown?.(),
39
+ },
40
+ };
41
+ }
42
+ function isSuccessful(value) {
43
+ return !(value &&
44
+ typeof value === 'object' &&
45
+ 'type' in value &&
46
+ value.type === 'error');
47
+ }
48
+ function cloneResponse(value) {
49
+ return value instanceof Response ? value.clone() : value;
50
+ }
51
+ function createProcedureInterceptor(runtime, config) {
52
+ return async (envelope, ctx, next) => {
53
+ runtime.bind(ctx.services);
54
+ const key = procedureCacheKey(envelope, ctx, config);
55
+ if (!key)
56
+ return next();
57
+ const hit = await runtime.cache.get(key);
58
+ if (hit && !hit.stale)
59
+ return hit.value;
60
+ if (hit?.stale) {
61
+ runtime.revalidate(key, next, config);
62
+ return hit.value;
63
+ }
64
+ return runtime.executeOnce(key, next, config);
65
+ };
66
+ }
67
+ export class ServerCacheRuntime {
68
+ config;
69
+ current;
70
+ binders = [];
71
+ pending = new Map();
72
+ controller;
73
+ constructor(config) {
74
+ this.config = config;
75
+ this.controller = {
76
+ invalidate: (key) => this.cache.delete(key),
77
+ clear: () => this.cache.clearNamespace(),
78
+ keyForProcedure: (procedure, input, ctx, options) => procedureCacheKeyFor(procedure, input, ctx, options),
79
+ invalidateProcedure: async (procedure, input, ctx, options) => {
80
+ const key = procedureCacheKeyFor(procedure, input, ctx, options);
81
+ if (!key)
82
+ return false;
83
+ await this.cache.delete(key);
84
+ return true;
85
+ },
86
+ stats: () => this.cache.stats(),
87
+ };
88
+ this.start();
89
+ }
90
+ get cache() {
91
+ if (!this.current)
92
+ this.start();
93
+ return this.current;
94
+ }
95
+ interceptorFor(procedure, explicit) {
96
+ const resolved = { enabled: false };
97
+ for (const rule of this.config.rules ?? []) {
98
+ if (matchProcedurePattern(rule.match, procedure))
99
+ Object.assign(resolved, rule);
100
+ }
101
+ if (explicit === false)
102
+ resolved.enabled = false;
103
+ else if (explicit)
104
+ Object.assign(resolved, explicit);
105
+ return resolved.enabled ? createProcedureInterceptor(this, resolved) : undefined;
106
+ }
107
+ bind(services) {
108
+ for (const binder of this.binders)
109
+ binder.bind(services);
110
+ }
111
+ executeOnce(key, next, config) {
112
+ const existing = this.pending.get(key);
113
+ if (existing)
114
+ return existing.then(cloneResponse);
115
+ const execution = next()
116
+ .then(async (value) => {
117
+ if (isSuccessful(value))
118
+ await this.cache.set(key, value, config);
119
+ return value;
120
+ })
121
+ .finally(() => this.pending.delete(key));
122
+ this.pending.set(key, execution);
123
+ return execution.then(cloneResponse);
124
+ }
125
+ revalidate(key, next, config) {
126
+ if (this.pending.has(key))
127
+ return;
128
+ void this.executeOnce(key, next, config).catch(() => undefined);
129
+ }
130
+ start() {
131
+ if (this.current)
132
+ return;
133
+ this.binders = [];
134
+ const layers = [];
135
+ const ids = new Set();
136
+ for (const [index, layer] of this.config.layers.entries()) {
137
+ if (layer.enabled === false)
138
+ continue;
139
+ const id = layer.id?.trim() || `l${index + 1}`;
140
+ if (ids.has(id))
141
+ throw new Error(`Cache layer id "${id}" is duplicated`);
142
+ ids.add(id);
143
+ if (layer.ttlMs !== undefined && layer.ttlMs <= 0) {
144
+ throw new Error(`Cache layer "${id}" ttlMs must be greater than zero`);
145
+ }
146
+ if (layer.timeoutMs !== undefined && layer.timeoutMs <= 0) {
147
+ throw new Error(`Cache layer "${id}" timeoutMs must be greater than zero`);
148
+ }
149
+ if (layer.operationTimeoutMs !== undefined && layer.operationTimeoutMs <= 0) {
150
+ throw new Error(`Cache layer "${id}" operationTimeoutMs must be greater than zero`);
151
+ }
152
+ if (layer.circuitBreaker &&
153
+ (layer.circuitBreaker.failureThreshold ?? 3) <= 0) {
154
+ throw new Error(`Cache layer "${id}" circuit failureThreshold must be greater than zero`);
155
+ }
156
+ if (layer.circuitBreaker && (layer.circuitBreaker.cooldownMs ?? 10_000) <= 0) {
157
+ throw new Error(`Cache layer "${id}" circuit cooldownMs must be greater than zero`);
158
+ }
159
+ if (layer.driver === 'memory') {
160
+ layers.push({
161
+ ...createMemoryCacheLayer({
162
+ id,
163
+ ttlMs: layer.ttlMs ?? 60_000,
164
+ maxEntries: layer.maxEntries,
165
+ maxMemoryBytes: layer.maxMemoryBytes,
166
+ eviction: layer.eviction,
167
+ }),
168
+ writeBehind: layer.writeBehind,
169
+ readTimeoutMs: layer.timeoutMs,
170
+ operationTimeoutMs: layer.operationTimeoutMs,
171
+ circuitBreaker: layer.circuitBreaker === false
172
+ ? { failureThreshold: Number.MAX_SAFE_INTEGER }
173
+ : layer.circuitBreaker,
174
+ });
175
+ }
176
+ else if (layer.driver === 'fs') {
177
+ layers.push({
178
+ ...createFileSystemCacheLayer({
179
+ id,
180
+ ttlMs: layer.ttlMs ?? 10 * 60_000,
181
+ directory: layer.directory ?? '.raffel/cache',
182
+ maxFiles: layer.maxFiles,
183
+ maxSizeBytes: layer.maxSizeBytes,
184
+ readTimeoutMs: layer.timeoutMs,
185
+ operationTimeoutMs: layer.operationTimeoutMs,
186
+ circuitBreaker: layer.circuitBreaker === false
187
+ ? { failureThreshold: Number.MAX_SAFE_INTEGER }
188
+ : layer.circuitBreaker,
189
+ }),
190
+ writeBehind: layer.writeBehind,
191
+ });
192
+ }
193
+ else {
194
+ const bound = providerLayer(layer, id);
195
+ this.binders.push(bound);
196
+ layers.push(bound.layer);
197
+ }
198
+ }
199
+ if (layers.length === 0)
200
+ throw new Error('At least one cache layer must be enabled');
201
+ this.current = createTieredCache({
202
+ namespace: this.config.namespace ?? 'raffel',
203
+ layers,
204
+ writeBehind: this.config.writeBehind,
205
+ onLayerError: this.config.onLayerError,
206
+ });
207
+ }
208
+ async stop() {
209
+ const cache = this.current;
210
+ this.current = undefined;
211
+ if (cache)
212
+ await cache.shutdown();
213
+ }
214
+ }
215
+ export function createServerCacheRuntime(config) {
216
+ if (!config || !config.enabled)
217
+ return undefined;
218
+ return new ServerCacheRuntime(config);
219
+ }
220
+ //# sourceMappingURL=server-runtime.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server-runtime.js","sourceRoot":"","sources":["../../src/cache/server-runtime.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,86 @@
1
+ import { type WriteBehindQueueOptions, type WriteBehindQueueStats } from './write-behind-queue.js';
2
+ export type MaybePromise<T> = T | Promise<T>;
3
+ export interface CacheRecord<T = unknown> {
4
+ value: T;
5
+ sizeBytes?: number;
6
+ createdAt: number;
7
+ expiresAt: number;
8
+ staleUntil?: number;
9
+ version: number;
10
+ }
11
+ export declare function isCacheRecord(value: unknown): value is CacheRecord;
12
+ export interface CacheLayer {
13
+ readonly id: string;
14
+ /** Marks a layer whose operations are guaranteed not to return promises. */
15
+ readonly synchronous?: boolean;
16
+ readonly ttlMs?: number;
17
+ readonly writeBehind?: WriteBehindQueueOptions;
18
+ readonly readTimeoutMs?: number;
19
+ readonly operationTimeoutMs?: number;
20
+ readonly circuitBreaker?: CacheCircuitBreakerOptions;
21
+ get(key: string): MaybePromise<CacheRecord | undefined>;
22
+ set(key: string, record: CacheRecord, ttlMs: number, staleMs?: number): MaybePromise<void>;
23
+ delete(key: string): MaybePromise<void>;
24
+ clearNamespace(namespace: string): MaybePromise<void>;
25
+ stats?(): CacheLayerStats;
26
+ shutdown?(): MaybePromise<void>;
27
+ }
28
+ export interface CacheLayerStats {
29
+ totalItems: number;
30
+ memoryUsageBytes?: number;
31
+ storageUsageBytes?: number;
32
+ hits?: number;
33
+ misses?: number;
34
+ readFailures?: number;
35
+ circuitOpen?: boolean;
36
+ writeQueue?: WriteBehindQueueStats;
37
+ trackedKeys?: number;
38
+ fencedKeys?: number;
39
+ }
40
+ export interface CacheCircuitBreakerOptions {
41
+ failureThreshold?: number;
42
+ cooldownMs?: number;
43
+ }
44
+ export interface CacheLookup<T = unknown> {
45
+ value: T;
46
+ layer: string;
47
+ stale: boolean;
48
+ }
49
+ export interface MemoryCacheLayerOptions {
50
+ id: string;
51
+ ttlMs: number;
52
+ maxEntries?: number;
53
+ maxMemoryBytes?: number;
54
+ expirationResolutionMs?: number;
55
+ eviction?: 'lru' | 'fifo';
56
+ }
57
+ export interface TieredCacheOptions {
58
+ namespace: string;
59
+ layers: CacheLayer[];
60
+ writeBehind?: WriteBehindQueueOptions;
61
+ /** Default async layer read deadline. Defaults to 250 ms. */
62
+ readTimeoutMs?: number;
63
+ /** Default async layer mutation deadline. Defaults to 1 second. */
64
+ operationTimeoutMs?: number;
65
+ onLayerError?: (layer: string, operation: 'get' | 'set' | 'delete' | 'clear' | 'shutdown', error: unknown) => void;
66
+ }
67
+ export interface TieredCache {
68
+ get<T = unknown>(key: string): Promise<CacheLookup<T> | undefined>;
69
+ set(key: string, value: unknown, options?: CacheWriteOptions): Promise<void>;
70
+ delete(key: string): Promise<void>;
71
+ clearNamespace(): Promise<void>;
72
+ stats(): ReadonlyArray<CacheLayerStats & {
73
+ id: string;
74
+ }>;
75
+ shutdown(): Promise<void>;
76
+ }
77
+ export interface CacheWriteOptions {
78
+ ttlMs?: number | Readonly<Record<string, number>>;
79
+ staleMs?: number | Readonly<Record<string, number>>;
80
+ }
81
+ export declare function createMemoryCacheLayer(options: MemoryCacheLayerOptions): CacheLayer;
82
+ export declare function createTieredCache(options: TieredCacheOptions): TieredCache;
83
+ export { createFileSystemCacheLayer } from './fs-layer.js';
84
+ export type { FileSystemCacheLayerOptions } from './fs-layer.js';
85
+ export { DEFAULT_CACHE_CIRCUIT_COOLDOWN_MS, DEFAULT_CACHE_CIRCUIT_FAILURE_THRESHOLD, DEFAULT_CACHE_OPERATION_TIMEOUT_MS, DEFAULT_CACHE_READ_TIMEOUT_MS, DEFAULT_L1_MAX_ENTRIES, DEFAULT_L1_MAX_MEMORY_BYTES, DEFAULT_L2_MAX_FILES, DEFAULT_L2_MAX_SIZE_BYTES, } from './defaults.js';
86
+ //# sourceMappingURL=tiered.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tiered.d.ts","sourceRoot":"","sources":["../../src/cache/tiered.ts"],"names":[],"mappings":"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"}