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.
- package/dist/cache/defaults.d.ts +9 -0
- package/dist/cache/defaults.d.ts.map +1 -0
- package/dist/cache/defaults.js +9 -0
- package/dist/cache/defaults.js.map +1 -0
- package/dist/cache/expiration-wheel.d.ts +15 -0
- package/dist/cache/expiration-wheel.d.ts.map +1 -0
- package/dist/cache/expiration-wheel.js +65 -0
- package/dist/cache/expiration-wheel.js.map +1 -0
- package/dist/cache/fs-layer.d.ts +14 -0
- package/dist/cache/fs-layer.d.ts.map +1 -0
- package/dist/cache/fs-layer.js +190 -0
- package/dist/cache/fs-layer.js.map +1 -0
- package/dist/cache/index.d.ts +9 -0
- package/dist/cache/index.d.ts.map +1 -1
- package/dist/cache/index.js +4 -0
- package/dist/cache/index.js.map +1 -1
- package/dist/cache/key.d.ts +11 -0
- package/dist/cache/key.d.ts.map +1 -0
- package/dist/cache/key.js +41 -0
- package/dist/cache/key.js.map +1 -0
- package/dist/cache/redis-layer.d.ts +30 -0
- package/dist/cache/redis-layer.d.ts.map +1 -0
- package/dist/cache/redis-layer.js +108 -0
- package/dist/cache/redis-layer.js.map +1 -0
- package/dist/cache/server-runtime.d.ts +74 -0
- package/dist/cache/server-runtime.d.ts.map +1 -0
- package/dist/cache/server-runtime.js +220 -0
- package/dist/cache/server-runtime.js.map +1 -0
- package/dist/cache/tiered.d.ts +86 -0
- package/dist/cache/tiered.d.ts.map +1 -0
- package/dist/cache/tiered.js +681 -0
- package/dist/cache/tiered.js.map +1 -0
- package/dist/cache/write-behind-queue.d.ts +34 -0
- package/dist/cache/write-behind-queue.d.ts.map +1 -0
- package/dist/cache/write-behind-queue.js +115 -0
- package/dist/cache/write-behind-queue.js.map +1 -0
- package/dist/http/app.d.ts.map +1 -1
- package/dist/http/app.js +1 -0
- package/dist/http/app.js.map +1 -1
- package/dist/http/cache.d.ts +22 -0
- package/dist/http/cache.d.ts.map +1 -0
- package/dist/http/cache.js +183 -0
- package/dist/http/cache.js.map +1 -0
- package/dist/http/index.d.ts +2 -0
- package/dist/http/index.d.ts.map +1 -1
- package/dist/http/index.js +1 -0
- package/dist/http/index.js.map +1 -1
- package/dist/index.d.ts +2 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/server/builder/operation-registrar.d.ts +3 -0
- package/dist/server/builder/operation-registrar.d.ts.map +1 -1
- package/dist/server/builder/operation-registrar.js +7 -2
- package/dist/server/builder/operation-registrar.js.map +1 -1
- package/dist/server/builder/programmatic-registration.d.ts +2 -0
- package/dist/server/builder/programmatic-registration.d.ts.map +1 -1
- package/dist/server/builder/programmatic-registration.js +13 -2
- package/dist/server/builder/programmatic-registration.js.map +1 -1
- package/dist/server/builder.d.ts.map +1 -1
- package/dist/server/builder.js +17 -3
- package/dist/server/builder.js.map +1 -1
- package/dist/server/discovery-utils.d.ts +2 -1
- package/dist/server/discovery-utils.d.ts.map +1 -1
- package/dist/server/discovery-utils.js +10 -2
- package/dist/server/discovery-utils.js.map +1 -1
- package/dist/server/fs-routes/types.d.ts +3 -0
- package/dist/server/fs-routes/types.d.ts.map +1 -1
- package/dist/server/handler-builders.d.ts +2 -0
- package/dist/server/handler-builders.d.ts.map +1 -1
- package/dist/server/handler-builders.js +7 -0
- package/dist/server/handler-builders.js.map +1 -1
- package/dist/server/interceptor-utils.d.ts +2 -0
- package/dist/server/interceptor-utils.d.ts.map +1 -1
- package/dist/server/interceptor-utils.js +25 -1
- package/dist/server/interceptor-utils.js.map +1 -1
- package/dist/server/router-module.d.ts +3 -0
- package/dist/server/router-module.d.ts.map +1 -1
- package/dist/server/router-module.js +1 -0
- package/dist/server/router-module.js.map +1 -1
- package/dist/server/types/config-types.d.ts +3 -0
- package/dist/server/types/config-types.d.ts.map +1 -1
- package/dist/server/types/handler-types.d.ts +7 -0
- package/dist/server/types/handler-types.d.ts.map +1 -1
- package/dist/server/types/lifecycle-types.d.ts +2 -0
- package/dist/server/types/lifecycle-types.d.ts.map +1 -1
- package/dist/server/types/protocol-namespace-types.d.ts +3 -0
- package/dist/server/types/protocol-namespace-types.d.ts.map +1 -1
- package/dist/ui/cache/defaults.d.ts +9 -0
- package/dist/ui/cache/defaults.d.ts.map +1 -0
- package/dist/ui/cache/expiration-wheel.d.ts +15 -0
- package/dist/ui/cache/expiration-wheel.d.ts.map +1 -0
- package/dist/ui/cache/fs-layer.d.ts +14 -0
- package/dist/ui/cache/fs-layer.d.ts.map +1 -0
- package/dist/ui/cache/key.d.ts +11 -0
- package/dist/ui/cache/key.d.ts.map +1 -0
- package/dist/ui/cache/server-runtime.d.ts +74 -0
- package/dist/ui/cache/server-runtime.d.ts.map +1 -0
- package/dist/ui/cache/tiered.d.ts +86 -0
- package/dist/ui/cache/tiered.d.ts.map +1 -0
- package/dist/ui/cache/write-behind-queue.d.ts +34 -0
- package/dist/ui/cache/write-behind-queue.d.ts.map +1 -0
- package/dist/ui/server/fs-routes/types.d.ts +3 -0
- package/dist/ui/server/fs-routes/types.d.ts.map +1 -1
- package/dist/ui/validation/index.d.ts +1 -1
- package/dist/ui/validation/index.d.ts.map +1 -1
- package/dist/ui/validation/schema.d.ts +7 -0
- package/dist/ui/validation/schema.d.ts.map +1 -1
- package/dist/validation/index.d.ts +1 -1
- package/dist/validation/index.d.ts.map +1 -1
- package/dist/validation/index.js +1 -1
- package/dist/validation/index.js.map +1 -1
- package/dist/validation/schema.d.ts +7 -0
- package/dist/validation/schema.d.ts.map +1 -1
- package/dist/validation/schema.js +36 -2
- package/dist/validation/schema.js.map +1 -1
- 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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"}
|