@periodic/vanadium 1.0.0
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/CHANGELOG.md +37 -0
- package/LICENSE +21 -0
- package/README.md +846 -0
- package/dist/cjs/adapters/memory/index.js +134 -0
- package/dist/cjs/adapters/memory/index.js.map +1 -0
- package/dist/cjs/adapters/mongodb/index.js +189 -0
- package/dist/cjs/adapters/mongodb/index.js.map +1 -0
- package/dist/cjs/adapters/mongoose/index.js +199 -0
- package/dist/cjs/adapters/mongoose/index.js.map +1 -0
- package/dist/cjs/adapters/postgres/index.js +202 -0
- package/dist/cjs/adapters/postgres/index.js.map +1 -0
- package/dist/cjs/adapters/prisma/index.js +176 -0
- package/dist/cjs/adapters/prisma/index.js.map +1 -0
- package/dist/cjs/adapters/redis/index.js +178 -0
- package/dist/cjs/adapters/redis/index.js.map +1 -0
- package/dist/cjs/cleanup/engine.js +100 -0
- package/dist/cjs/cleanup/engine.js.map +1 -0
- package/dist/cjs/core/concurrencyGuard.js +50 -0
- package/dist/cjs/core/concurrencyGuard.js.map +1 -0
- package/dist/cjs/core/metrics.js +39 -0
- package/dist/cjs/core/metrics.js.map +1 -0
- package/dist/cjs/core/stateMachine.js +46 -0
- package/dist/cjs/core/stateMachine.js.map +1 -0
- package/dist/cjs/errors/index.js +127 -0
- package/dist/cjs/errors/index.js.map +1 -0
- package/dist/cjs/http/express.js +84 -0
- package/dist/cjs/http/express.js.map +1 -0
- package/dist/cjs/http/fastify.js +70 -0
- package/dist/cjs/http/fastify.js.map +1 -0
- package/dist/cjs/idempotency/engine.js +266 -0
- package/dist/cjs/idempotency/engine.js.map +1 -0
- package/dist/cjs/index.js +19 -0
- package/dist/cjs/index.js.map +1 -0
- package/dist/cjs/lock/engine.js +187 -0
- package/dist/cjs/lock/engine.js.map +1 -0
- package/dist/cjs/observability/metrics.js +92 -0
- package/dist/cjs/observability/metrics.js.map +1 -0
- package/dist/cjs/resilience/circuitBreaker.js +129 -0
- package/dist/cjs/resilience/circuitBreaker.js.map +1 -0
- package/dist/cjs/types/index.js +13 -0
- package/dist/cjs/types/index.js.map +1 -0
- package/dist/cjs/utils/crypto.js +64 -0
- package/dist/cjs/utils/crypto.js.map +1 -0
- package/dist/cjs/utils/keys.js +40 -0
- package/dist/cjs/utils/keys.js.map +1 -0
- package/dist/cjs/utils/sleep.js +25 -0
- package/dist/cjs/utils/sleep.js.map +1 -0
- package/dist/esm/adapters/memory/index.js +129 -0
- package/dist/esm/adapters/memory/index.js.map +1 -0
- package/dist/esm/adapters/mongodb/index.js +184 -0
- package/dist/esm/adapters/mongodb/index.js.map +1 -0
- package/dist/esm/adapters/mongoose/index.js +193 -0
- package/dist/esm/adapters/mongoose/index.js.map +1 -0
- package/dist/esm/adapters/postgres/index.js +197 -0
- package/dist/esm/adapters/postgres/index.js.map +1 -0
- package/dist/esm/adapters/prisma/index.js +171 -0
- package/dist/esm/adapters/prisma/index.js.map +1 -0
- package/dist/esm/adapters/redis/index.js +173 -0
- package/dist/esm/adapters/redis/index.js.map +1 -0
- package/dist/esm/cleanup/engine.js +95 -0
- package/dist/esm/cleanup/engine.js.map +1 -0
- package/dist/esm/core/concurrencyGuard.js +46 -0
- package/dist/esm/core/concurrencyGuard.js.map +1 -0
- package/dist/esm/core/metrics.js +35 -0
- package/dist/esm/core/metrics.js.map +1 -0
- package/dist/esm/core/stateMachine.js +40 -0
- package/dist/esm/core/stateMachine.js.map +1 -0
- package/dist/esm/errors/index.js +114 -0
- package/dist/esm/errors/index.js.map +1 -0
- package/dist/esm/http/express.js +81 -0
- package/dist/esm/http/express.js.map +1 -0
- package/dist/esm/http/fastify.js +67 -0
- package/dist/esm/http/fastify.js.map +1 -0
- package/dist/esm/idempotency/engine.js +261 -0
- package/dist/esm/idempotency/engine.js.map +1 -0
- package/dist/esm/index.js +9 -0
- package/dist/esm/index.js.map +1 -0
- package/dist/esm/lock/engine.js +182 -0
- package/dist/esm/lock/engine.js.map +1 -0
- package/dist/esm/observability/metrics.js +89 -0
- package/dist/esm/observability/metrics.js.map +1 -0
- package/dist/esm/resilience/circuitBreaker.js +124 -0
- package/dist/esm/resilience/circuitBreaker.js.map +1 -0
- package/dist/esm/types/index.js +10 -0
- package/dist/esm/types/index.js.map +1 -0
- package/dist/esm/utils/crypto.js +58 -0
- package/dist/esm/utils/crypto.js.map +1 -0
- package/dist/esm/utils/keys.js +35 -0
- package/dist/esm/utils/keys.js.map +1 -0
- package/dist/esm/utils/sleep.js +20 -0
- package/dist/esm/utils/sleep.js.map +1 -0
- package/dist/types/adapters/memory/index.d.ts +49 -0
- package/dist/types/adapters/memory/index.d.ts.map +1 -0
- package/dist/types/adapters/mongodb/index.d.ts +97 -0
- package/dist/types/adapters/mongodb/index.d.ts.map +1 -0
- package/dist/types/adapters/mongoose/index.d.ts +107 -0
- package/dist/types/adapters/mongoose/index.d.ts.map +1 -0
- package/dist/types/adapters/postgres/index.d.ts +85 -0
- package/dist/types/adapters/postgres/index.d.ts.map +1 -0
- package/dist/types/adapters/prisma/index.d.ts +73 -0
- package/dist/types/adapters/prisma/index.d.ts.map +1 -0
- package/dist/types/adapters/redis/index.d.ts +77 -0
- package/dist/types/adapters/redis/index.d.ts.map +1 -0
- package/dist/types/cleanup/engine.d.ts +41 -0
- package/dist/types/cleanup/engine.d.ts.map +1 -0
- package/dist/types/core/concurrencyGuard.d.ts +28 -0
- package/dist/types/core/concurrencyGuard.d.ts.map +1 -0
- package/dist/types/core/metrics.d.ts +13 -0
- package/dist/types/core/metrics.d.ts.map +1 -0
- package/dist/types/core/stateMachine.d.ts +20 -0
- package/dist/types/core/stateMachine.d.ts.map +1 -0
- package/dist/types/errors/index.d.ts +32 -0
- package/dist/types/errors/index.d.ts.map +1 -0
- package/dist/types/http/express.d.ts +50 -0
- package/dist/types/http/express.d.ts.map +1 -0
- package/dist/types/http/fastify.d.ts +48 -0
- package/dist/types/http/fastify.d.ts.map +1 -0
- package/dist/types/idempotency/engine.d.ts +24 -0
- package/dist/types/idempotency/engine.d.ts.map +1 -0
- package/dist/types/index.d.ts +8 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/lock/engine.d.ts +28 -0
- package/dist/types/lock/engine.d.ts.map +1 -0
- package/dist/types/observability/metrics.d.ts +45 -0
- package/dist/types/observability/metrics.d.ts.map +1 -0
- package/dist/types/resilience/circuitBreaker.d.ts +48 -0
- package/dist/types/resilience/circuitBreaker.d.ts.map +1 -0
- package/dist/types/types/index.d.ts +170 -0
- package/dist/types/types/index.d.ts.map +1 -0
- package/dist/types/utils/crypto.d.ts +20 -0
- package/dist/types/utils/crypto.d.ts.map +1 -0
- package/dist/types/utils/keys.d.ts +15 -0
- package/dist/types/utils/keys.d.ts.map +1 -0
- package/dist/types/utils/sleep.d.ts +13 -0
- package/dist/types/utils/sleep.d.ts.map +1 -0
- package/package.json +140 -0
|
@@ -0,0 +1,202 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* PostgreSQL Storage Adapter for @periodic/vanadium
|
|
4
|
+
*
|
|
5
|
+
* Peer dependency: "pg" >= 8.0.0
|
|
6
|
+
* Import: import { createPostgresAdapter } from '@periodic/vanadium/adapters/postgres'
|
|
7
|
+
*
|
|
8
|
+
* The caller MUST provide an already-created Pool or Client instance.
|
|
9
|
+
* This adapter never creates or closes connections.
|
|
10
|
+
*
|
|
11
|
+
* Required schema:
|
|
12
|
+
* ```sql
|
|
13
|
+
* CREATE TABLE public.vanadium_records (
|
|
14
|
+
* key TEXT PRIMARY KEY,
|
|
15
|
+
* status TEXT NOT NULL CHECK (status IN ('IN_PROGRESS','COMPLETED','FAILED')),
|
|
16
|
+
* result JSONB,
|
|
17
|
+
* payload_hash TEXT,
|
|
18
|
+
* owner_token TEXT,
|
|
19
|
+
* attempts INTEGER NOT NULL DEFAULT 0,
|
|
20
|
+
* created_at BIGINT NOT NULL,
|
|
21
|
+
* updated_at BIGINT NOT NULL,
|
|
22
|
+
* expires_at BIGINT
|
|
23
|
+
* );
|
|
24
|
+
* CREATE INDEX idx_vanadium_expires_at ON public.vanadium_records (expires_at);
|
|
25
|
+
* CREATE INDEX idx_vanadium_status_expires ON public.vanadium_records (status, expires_at);
|
|
26
|
+
* ```
|
|
27
|
+
*/
|
|
28
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
29
|
+
exports.PostgresAdapter = void 0;
|
|
30
|
+
exports.createPostgresAdapter = createPostgresAdapter;
|
|
31
|
+
const index_js_1 = require("../../errors/index.js");
|
|
32
|
+
// ─── Postgres Adapter ─────────────────────────────────────────────────────────
|
|
33
|
+
class PostgresAdapter {
|
|
34
|
+
constructor(options) {
|
|
35
|
+
this.name = 'postgres';
|
|
36
|
+
if (!options.client) {
|
|
37
|
+
throw (0, index_js_1.createConfigurationError)('', 'postgres', 'Postgres adapter requires a pg Pool or Client.');
|
|
38
|
+
}
|
|
39
|
+
this.client = options.client;
|
|
40
|
+
const schema = options.schemaName ?? 'public';
|
|
41
|
+
const table = options.tableName ?? 'vanadium_records';
|
|
42
|
+
this.table = `${schema}.${table}`;
|
|
43
|
+
this.useAdvisoryLocks = options.useAdvisoryLocks ?? false;
|
|
44
|
+
this.clock = options.clock ?? Date.now;
|
|
45
|
+
}
|
|
46
|
+
// ── Storage Interface ─────────────────────────────────────────────────────
|
|
47
|
+
async get(key) {
|
|
48
|
+
const sql = `SELECT * FROM ${this.table} WHERE key = $1 LIMIT 1`;
|
|
49
|
+
try {
|
|
50
|
+
const res = await this.client.query(sql, [key]);
|
|
51
|
+
if (!res.rows.length)
|
|
52
|
+
return null;
|
|
53
|
+
return this._rowToRecord(res.rows[0]);
|
|
54
|
+
}
|
|
55
|
+
catch (err) {
|
|
56
|
+
throw (0, index_js_1.createStorageError)(key, this.name, err, this.clock);
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
async set(key, value, ttlMs) {
|
|
60
|
+
const now = this.clock();
|
|
61
|
+
const expiresAt = ttlMs !== undefined ? now + ttlMs : (value.expiresAt ?? null);
|
|
62
|
+
const resultJson = value.result !== undefined ? JSON.stringify(value.result) : null;
|
|
63
|
+
const sql = `
|
|
64
|
+
INSERT INTO ${this.table}
|
|
65
|
+
(key, status, result, payload_hash, owner_token, attempts, created_at, updated_at, expires_at)
|
|
66
|
+
VALUES
|
|
67
|
+
($1, $2, $3::jsonb, $4, $5, $6, $7, $8, $9)
|
|
68
|
+
ON CONFLICT (key) DO UPDATE
|
|
69
|
+
SET status = EXCLUDED.status,
|
|
70
|
+
result = EXCLUDED.result,
|
|
71
|
+
payload_hash = EXCLUDED.payload_hash,
|
|
72
|
+
owner_token = EXCLUDED.owner_token,
|
|
73
|
+
attempts = EXCLUDED.attempts,
|
|
74
|
+
updated_at = EXCLUDED.updated_at,
|
|
75
|
+
expires_at = EXCLUDED.expires_at
|
|
76
|
+
`;
|
|
77
|
+
try {
|
|
78
|
+
await this.client.query(sql, [
|
|
79
|
+
key,
|
|
80
|
+
value.status,
|
|
81
|
+
resultJson,
|
|
82
|
+
value.payloadHash ?? null,
|
|
83
|
+
value.ownerToken ?? null,
|
|
84
|
+
value.attempts,
|
|
85
|
+
value.createdAt,
|
|
86
|
+
value.updatedAt,
|
|
87
|
+
expiresAt,
|
|
88
|
+
]);
|
|
89
|
+
}
|
|
90
|
+
catch (err) {
|
|
91
|
+
throw (0, index_js_1.createStorageError)(key, this.name, err, this.clock);
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
async delete(key) {
|
|
95
|
+
const sql = `DELETE FROM ${this.table} WHERE key = $1`;
|
|
96
|
+
try {
|
|
97
|
+
await this.client.query(sql, [key]);
|
|
98
|
+
}
|
|
99
|
+
catch (err) {
|
|
100
|
+
throw (0, index_js_1.createStorageError)(key, this.name, err, this.clock);
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
async compareAndSet(key, expectedOwnerToken, newValue, ttlMs) {
|
|
104
|
+
const now = this.clock();
|
|
105
|
+
const expiresAt = ttlMs !== undefined ? now + ttlMs : (newValue.expiresAt ?? null);
|
|
106
|
+
const resultJson = newValue.result !== undefined ? JSON.stringify(newValue.result) : null;
|
|
107
|
+
const sql = `
|
|
108
|
+
UPDATE ${this.table}
|
|
109
|
+
SET status = $1,
|
|
110
|
+
result = $2::jsonb,
|
|
111
|
+
payload_hash = $3,
|
|
112
|
+
owner_token = $4,
|
|
113
|
+
attempts = $5,
|
|
114
|
+
updated_at = $6,
|
|
115
|
+
expires_at = $7
|
|
116
|
+
WHERE key = $8
|
|
117
|
+
AND owner_token = $9
|
|
118
|
+
`;
|
|
119
|
+
try {
|
|
120
|
+
const res = await this.client.query(sql, [
|
|
121
|
+
newValue.status,
|
|
122
|
+
resultJson,
|
|
123
|
+
newValue.payloadHash ?? null,
|
|
124
|
+
newValue.ownerToken ?? null,
|
|
125
|
+
newValue.attempts,
|
|
126
|
+
newValue.updatedAt,
|
|
127
|
+
expiresAt,
|
|
128
|
+
key,
|
|
129
|
+
expectedOwnerToken,
|
|
130
|
+
]);
|
|
131
|
+
return (res.rowCount ?? 0) > 0;
|
|
132
|
+
}
|
|
133
|
+
catch (err) {
|
|
134
|
+
throw (0, index_js_1.createStorageError)(key, this.name, err, this.clock);
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
// ── Advisory Locks ────────────────────────────────────────────────────────
|
|
138
|
+
async tryAdvisoryLock(key) {
|
|
139
|
+
if (!this.useAdvisoryLocks)
|
|
140
|
+
return false;
|
|
141
|
+
const sql = `SELECT pg_try_advisory_lock(hashtext($1)) AS acquired`;
|
|
142
|
+
try {
|
|
143
|
+
const res = await this.client.query(sql, [key]);
|
|
144
|
+
return res.rows[0].acquired === true;
|
|
145
|
+
}
|
|
146
|
+
catch (err) {
|
|
147
|
+
throw (0, index_js_1.createStorageError)(key, this.name, err, this.clock);
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
async releaseAdvisoryLock(key) {
|
|
151
|
+
if (!this.useAdvisoryLocks)
|
|
152
|
+
return;
|
|
153
|
+
const sql = `SELECT pg_advisory_unlock(hashtext($1))`;
|
|
154
|
+
try {
|
|
155
|
+
await this.client.query(sql, [key]);
|
|
156
|
+
}
|
|
157
|
+
catch (err) {
|
|
158
|
+
throw (0, index_js_1.createStorageError)(key, this.name, err, this.clock);
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
// ── Capabilities ──────────────────────────────────────────────────────────
|
|
162
|
+
capabilities() {
|
|
163
|
+
return {
|
|
164
|
+
transactions: true,
|
|
165
|
+
cas: true,
|
|
166
|
+
ttl: false, // TTL enforced at application layer
|
|
167
|
+
advisoryLocks: this.useAdvisoryLocks,
|
|
168
|
+
};
|
|
169
|
+
}
|
|
170
|
+
// ── Private ───────────────────────────────────────────────────────────────
|
|
171
|
+
_rowToRecord(row) {
|
|
172
|
+
return {
|
|
173
|
+
key: row.key,
|
|
174
|
+
status: row.status,
|
|
175
|
+
result: row.result,
|
|
176
|
+
payloadHash: row.payload_hash ?? undefined,
|
|
177
|
+
ownerToken: row.owner_token ?? undefined,
|
|
178
|
+
attempts: row.attempts,
|
|
179
|
+
createdAt: Number(row.created_at),
|
|
180
|
+
updatedAt: Number(row.updated_at),
|
|
181
|
+
expiresAt: row.expires_at !== null ? Number(row.expires_at) : undefined,
|
|
182
|
+
};
|
|
183
|
+
}
|
|
184
|
+
}
|
|
185
|
+
exports.PostgresAdapter = PostgresAdapter;
|
|
186
|
+
// ─── Factory ──────────────────────────────────────────────────────────────────
|
|
187
|
+
/**
|
|
188
|
+
* Create a PostgreSQL storage adapter.
|
|
189
|
+
*
|
|
190
|
+
* @example
|
|
191
|
+
* ```ts
|
|
192
|
+
* import { Pool } from 'pg';
|
|
193
|
+
* import { createPostgresAdapter } from '@periodic/vanadium/adapters/postgres';
|
|
194
|
+
*
|
|
195
|
+
* const pool = new Pool({ connectionString: process.env.DATABASE_URL });
|
|
196
|
+
* const adapter = createPostgresAdapter({ client: pool });
|
|
197
|
+
* ```
|
|
198
|
+
*/
|
|
199
|
+
function createPostgresAdapter(options) {
|
|
200
|
+
return new PostgresAdapter(options);
|
|
201
|
+
}
|
|
202
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/postgres/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Prisma Storage Adapter for @periodic/vanadium
|
|
4
|
+
*
|
|
5
|
+
* Peer dependency: "@prisma/client" >= 5.0.0
|
|
6
|
+
* Import: import { createPrismaAdapter } from '@periodic/vanadium/adapters/prisma'
|
|
7
|
+
*
|
|
8
|
+
* Required Prisma schema model:
|
|
9
|
+
* ```prisma
|
|
10
|
+
* model VanadiumRecord {
|
|
11
|
+
* key String @id
|
|
12
|
+
* status String
|
|
13
|
+
* result Json?
|
|
14
|
+
* payloadHash String?
|
|
15
|
+
* ownerToken String?
|
|
16
|
+
* attempts Int @default(0)
|
|
17
|
+
* createdAt BigInt
|
|
18
|
+
* updatedAt BigInt
|
|
19
|
+
* expiresAt BigInt?
|
|
20
|
+
*
|
|
21
|
+
* @@map("vanadium_records")
|
|
22
|
+
* }
|
|
23
|
+
* ```
|
|
24
|
+
*/
|
|
25
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
26
|
+
exports.PrismaAdapter = void 0;
|
|
27
|
+
exports.createPrismaAdapter = createPrismaAdapter;
|
|
28
|
+
const index_js_1 = require("../../errors/index.js");
|
|
29
|
+
// ─── Prisma Adapter ───────────────────────────────────────────────────────────
|
|
30
|
+
class PrismaAdapter {
|
|
31
|
+
constructor(options) {
|
|
32
|
+
this.name = 'prisma';
|
|
33
|
+
if (!options.prisma) {
|
|
34
|
+
throw (0, index_js_1.createConfigurationError)('', 'prisma', 'Prisma adapter requires a PrismaClient instance.');
|
|
35
|
+
}
|
|
36
|
+
this.prisma = options.prisma;
|
|
37
|
+
this.modelName = options.modelName ?? 'vanadiumRecord';
|
|
38
|
+
this.useTransactions = options.useInteractiveTransactions ?? true;
|
|
39
|
+
this.clock = options.clock ?? Date.now;
|
|
40
|
+
}
|
|
41
|
+
get model() {
|
|
42
|
+
const m = this.prisma[this.modelName];
|
|
43
|
+
if (!m) {
|
|
44
|
+
throw (0, index_js_1.createConfigurationError)('', 'prisma', `Prisma model "${this.modelName}" not found on PrismaClient. Ensure your schema has the model defined.`);
|
|
45
|
+
}
|
|
46
|
+
return m;
|
|
47
|
+
}
|
|
48
|
+
// ── Storage Interface ─────────────────────────────────────────────────────
|
|
49
|
+
async get(key) {
|
|
50
|
+
try {
|
|
51
|
+
const record = (await this.model.findUnique({ where: { key } }));
|
|
52
|
+
if (!record)
|
|
53
|
+
return null;
|
|
54
|
+
return this._rowToRecord(record);
|
|
55
|
+
}
|
|
56
|
+
catch (err) {
|
|
57
|
+
throw (0, index_js_1.createStorageError)(key, this.name, err, this.clock);
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
async set(key, value, ttlMs) {
|
|
61
|
+
const now = this.clock();
|
|
62
|
+
const expiresAt = ttlMs !== undefined
|
|
63
|
+
? BigInt(now + ttlMs)
|
|
64
|
+
: value.expiresAt !== undefined
|
|
65
|
+
? BigInt(value.expiresAt)
|
|
66
|
+
: null;
|
|
67
|
+
const data = {
|
|
68
|
+
key,
|
|
69
|
+
status: value.status,
|
|
70
|
+
result: value.result !== undefined ? value.result : null,
|
|
71
|
+
payloadHash: value.payloadHash ?? null,
|
|
72
|
+
ownerToken: value.ownerToken ?? null,
|
|
73
|
+
attempts: value.attempts,
|
|
74
|
+
createdAt: BigInt(value.createdAt),
|
|
75
|
+
updatedAt: BigInt(value.updatedAt),
|
|
76
|
+
expiresAt,
|
|
77
|
+
};
|
|
78
|
+
try {
|
|
79
|
+
await this.model.upsert({
|
|
80
|
+
where: { key },
|
|
81
|
+
create: data,
|
|
82
|
+
update: {
|
|
83
|
+
status: data.status,
|
|
84
|
+
result: data.result,
|
|
85
|
+
payloadHash: data.payloadHash,
|
|
86
|
+
ownerToken: data.ownerToken,
|
|
87
|
+
attempts: data.attempts,
|
|
88
|
+
updatedAt: data.updatedAt,
|
|
89
|
+
expiresAt: data.expiresAt,
|
|
90
|
+
},
|
|
91
|
+
});
|
|
92
|
+
}
|
|
93
|
+
catch (err) {
|
|
94
|
+
throw (0, index_js_1.createStorageError)(key, this.name, err, this.clock);
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
async delete(key) {
|
|
98
|
+
try {
|
|
99
|
+
await this.model.delete({ where: { key } });
|
|
100
|
+
}
|
|
101
|
+
catch (err) {
|
|
102
|
+
// If record not found, that's acceptable
|
|
103
|
+
const code = err.code;
|
|
104
|
+
if (code === 'P2025')
|
|
105
|
+
return; // Prisma "record not found"
|
|
106
|
+
throw (0, index_js_1.createStorageError)(key, this.name, err, this.clock);
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
async compareAndSet(key, expectedOwnerToken, newValue, ttlMs) {
|
|
110
|
+
const now = this.clock();
|
|
111
|
+
const expiresAt = ttlMs !== undefined
|
|
112
|
+
? BigInt(now + ttlMs)
|
|
113
|
+
: newValue.expiresAt !== undefined
|
|
114
|
+
? BigInt(newValue.expiresAt)
|
|
115
|
+
: null;
|
|
116
|
+
try {
|
|
117
|
+
const result = await this.model.updateMany({
|
|
118
|
+
where: { key, ownerToken: expectedOwnerToken },
|
|
119
|
+
data: {
|
|
120
|
+
status: newValue.status,
|
|
121
|
+
result: newValue.result !== undefined ? newValue.result : null,
|
|
122
|
+
payloadHash: newValue.payloadHash ?? null,
|
|
123
|
+
ownerToken: newValue.ownerToken ?? null,
|
|
124
|
+
attempts: newValue.attempts,
|
|
125
|
+
updatedAt: BigInt(newValue.updatedAt),
|
|
126
|
+
expiresAt,
|
|
127
|
+
},
|
|
128
|
+
});
|
|
129
|
+
return result.count > 0;
|
|
130
|
+
}
|
|
131
|
+
catch (err) {
|
|
132
|
+
throw (0, index_js_1.createStorageError)(key, this.name, err, this.clock);
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
// ── Capabilities ──────────────────────────────────────────────────────────
|
|
136
|
+
capabilities() {
|
|
137
|
+
return {
|
|
138
|
+
transactions: this.useTransactions,
|
|
139
|
+
cas: true,
|
|
140
|
+
ttl: false,
|
|
141
|
+
advisoryLocks: false,
|
|
142
|
+
};
|
|
143
|
+
}
|
|
144
|
+
// ── Private ───────────────────────────────────────────────────────────────
|
|
145
|
+
_rowToRecord(row) {
|
|
146
|
+
return {
|
|
147
|
+
key: row.key,
|
|
148
|
+
status: row.status,
|
|
149
|
+
result: row.result,
|
|
150
|
+
payloadHash: row.payloadHash ?? undefined,
|
|
151
|
+
ownerToken: row.ownerToken ?? undefined,
|
|
152
|
+
attempts: row.attempts,
|
|
153
|
+
createdAt: Number(row.createdAt),
|
|
154
|
+
updatedAt: Number(row.updatedAt),
|
|
155
|
+
expiresAt: row.expiresAt !== null ? Number(row.expiresAt) : undefined,
|
|
156
|
+
};
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
exports.PrismaAdapter = PrismaAdapter;
|
|
160
|
+
// ─── Factory ──────────────────────────────────────────────────────────────────
|
|
161
|
+
/**
|
|
162
|
+
* Create a Prisma storage adapter.
|
|
163
|
+
*
|
|
164
|
+
* @example
|
|
165
|
+
* ```ts
|
|
166
|
+
* import { PrismaClient } from '@prisma/client';
|
|
167
|
+
* import { createPrismaAdapter } from '@periodic/vanadium/adapters/prisma';
|
|
168
|
+
*
|
|
169
|
+
* const prisma = new PrismaClient();
|
|
170
|
+
* const adapter = createPrismaAdapter({ prisma });
|
|
171
|
+
* ```
|
|
172
|
+
*/
|
|
173
|
+
function createPrismaAdapter(options) {
|
|
174
|
+
return new PrismaAdapter(options);
|
|
175
|
+
}
|
|
176
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/prisma/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Redis Storage Adapter for @periodic/vanadium
|
|
4
|
+
*
|
|
5
|
+
* Peer dependency: "redis" >= 4.0.0
|
|
6
|
+
* Import: import { createRedisAdapter } from '@periodic/vanadium/adapters/redis'
|
|
7
|
+
*
|
|
8
|
+
* The caller is responsible for creating and connecting the Redis client.
|
|
9
|
+
* This adapter NEVER creates its own connection.
|
|
10
|
+
*/
|
|
11
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
12
|
+
exports.RedisAdapter = void 0;
|
|
13
|
+
exports.createRedisAdapter = createRedisAdapter;
|
|
14
|
+
const index_js_1 = require("../../errors/index.js");
|
|
15
|
+
const crypto_js_1 = require("../../utils/crypto.js");
|
|
16
|
+
const keys_js_1 = require("../../utils/keys.js");
|
|
17
|
+
// ─── Lua Scripts ─────────────────────────────────────────────────────────────
|
|
18
|
+
/** Atomic CAS: compare ownerToken, replace if match */
|
|
19
|
+
const LUA_CAS = `
|
|
20
|
+
local current = redis.call('GET', KEYS[1])
|
|
21
|
+
if current == false then return 0 end
|
|
22
|
+
local record = cjson.decode(current)
|
|
23
|
+
if record['ownerToken'] ~= ARGV[1] then return 0 end
|
|
24
|
+
local ttl = tonumber(ARGV[3])
|
|
25
|
+
if ttl > 0 then
|
|
26
|
+
redis.call('SET', KEYS[1], ARGV[2], 'PX', ttl)
|
|
27
|
+
else
|
|
28
|
+
redis.call('SET', KEYS[1], ARGV[2])
|
|
29
|
+
end
|
|
30
|
+
return 1
|
|
31
|
+
`;
|
|
32
|
+
/** Safe delete: only delete if ownerToken matches */
|
|
33
|
+
const LUA_SAFE_DELETE = `
|
|
34
|
+
local current = redis.call('GET', KEYS[1])
|
|
35
|
+
if current == false then return 0 end
|
|
36
|
+
local record = cjson.decode(current)
|
|
37
|
+
if record['ownerToken'] ~= ARGV[1] then return 0 end
|
|
38
|
+
return redis.call('DEL', KEYS[1])
|
|
39
|
+
`;
|
|
40
|
+
// ─── Redis Adapter ────────────────────────────────────────────────────────────
|
|
41
|
+
class RedisAdapter {
|
|
42
|
+
constructor(options) {
|
|
43
|
+
this.name = 'redis';
|
|
44
|
+
if (!options.client) {
|
|
45
|
+
throw (0, index_js_1.createConfigurationError)('', 'redis', 'Redis adapter requires a connected client.');
|
|
46
|
+
}
|
|
47
|
+
this.client = options.client;
|
|
48
|
+
this.keyPrefix = options.keyPrefix ?? 'vanadium:';
|
|
49
|
+
this.namespace = options.namespace ?? '';
|
|
50
|
+
this.useLua = options.useLua ?? true;
|
|
51
|
+
this.clock = options.clock ?? Date.now;
|
|
52
|
+
}
|
|
53
|
+
// ── Storage Interface ─────────────────────────────────────────────────────
|
|
54
|
+
async get(key) {
|
|
55
|
+
const redisKey = this._buildKey(key);
|
|
56
|
+
try {
|
|
57
|
+
const raw = await this.client.get(redisKey);
|
|
58
|
+
if (raw === null)
|
|
59
|
+
return null;
|
|
60
|
+
return (0, crypto_js_1.safeJsonParse)(raw, `redis:${key}`);
|
|
61
|
+
}
|
|
62
|
+
catch (err) {
|
|
63
|
+
throw (0, index_js_1.createStorageError)(key, this.name, err, this.clock);
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
async set(key, value, ttlMs) {
|
|
67
|
+
const redisKey = this._buildKey(key);
|
|
68
|
+
let serialized;
|
|
69
|
+
try {
|
|
70
|
+
serialized = (0, crypto_js_1.safeJsonStringify)(value);
|
|
71
|
+
}
|
|
72
|
+
catch (err) {
|
|
73
|
+
throw (0, index_js_1.createStorageError)(key, this.name, err, this.clock);
|
|
74
|
+
}
|
|
75
|
+
try {
|
|
76
|
+
if (ttlMs !== undefined && ttlMs > 0) {
|
|
77
|
+
await this.client.set(redisKey, serialized, { PX: ttlMs });
|
|
78
|
+
}
|
|
79
|
+
else {
|
|
80
|
+
await this.client.set(redisKey, serialized);
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
catch (err) {
|
|
84
|
+
throw (0, index_js_1.createStorageError)(key, this.name, err, this.clock);
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
async delete(key) {
|
|
88
|
+
const redisKey = this._buildKey(key);
|
|
89
|
+
try {
|
|
90
|
+
await this.client.del(redisKey);
|
|
91
|
+
}
|
|
92
|
+
catch (err) {
|
|
93
|
+
throw (0, index_js_1.createStorageError)(key, this.name, err, this.clock);
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
async compareAndSet(key, expectedOwnerToken, newValue, ttlMs) {
|
|
97
|
+
const redisKey = this._buildKey(key);
|
|
98
|
+
let serialized;
|
|
99
|
+
try {
|
|
100
|
+
serialized = (0, crypto_js_1.safeJsonStringify)(newValue);
|
|
101
|
+
}
|
|
102
|
+
catch (err) {
|
|
103
|
+
throw (0, index_js_1.createStorageError)(key, this.name, err, this.clock);
|
|
104
|
+
}
|
|
105
|
+
try {
|
|
106
|
+
if (this.useLua) {
|
|
107
|
+
const result = await this.client.eval(LUA_CAS, {
|
|
108
|
+
keys: [redisKey],
|
|
109
|
+
arguments: [expectedOwnerToken, serialized, String(ttlMs ?? 0)],
|
|
110
|
+
});
|
|
111
|
+
return result === 1;
|
|
112
|
+
}
|
|
113
|
+
// Fallback: non-atomic (less safe — only for adapters without Lua)
|
|
114
|
+
const current = await this.client.get(redisKey);
|
|
115
|
+
if (!current)
|
|
116
|
+
return false;
|
|
117
|
+
const existing = (0, crypto_js_1.safeJsonParse)(current, `cas:${key}`);
|
|
118
|
+
if (existing.ownerToken !== expectedOwnerToken)
|
|
119
|
+
return false;
|
|
120
|
+
await this.set(key, newValue, ttlMs);
|
|
121
|
+
return true;
|
|
122
|
+
}
|
|
123
|
+
catch (err) {
|
|
124
|
+
if (err.type !== undefined)
|
|
125
|
+
throw err;
|
|
126
|
+
throw (0, index_js_1.createStorageError)(key, this.name, err, this.clock);
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
/**
|
|
130
|
+
* Safe owner-only delete using Lua. Use in lock release.
|
|
131
|
+
*/
|
|
132
|
+
async safeDelete(key, ownerToken) {
|
|
133
|
+
const redisKey = this._buildKey(key);
|
|
134
|
+
try {
|
|
135
|
+
const result = await this.client.eval(LUA_SAFE_DELETE, {
|
|
136
|
+
keys: [redisKey],
|
|
137
|
+
arguments: [ownerToken],
|
|
138
|
+
});
|
|
139
|
+
return result === 1;
|
|
140
|
+
}
|
|
141
|
+
catch (err) {
|
|
142
|
+
throw (0, index_js_1.createStorageError)(key, this.name, err, this.clock);
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
// ── Capabilities ──────────────────────────────────────────────────────────
|
|
146
|
+
capabilities() {
|
|
147
|
+
return {
|
|
148
|
+
transactions: false,
|
|
149
|
+
cas: true,
|
|
150
|
+
ttl: true,
|
|
151
|
+
advisoryLocks: false,
|
|
152
|
+
};
|
|
153
|
+
}
|
|
154
|
+
// ── Private ───────────────────────────────────────────────────────────────
|
|
155
|
+
_buildKey(key) {
|
|
156
|
+
return (0, keys_js_1.buildNamespacedKey)(key, this.keyPrefix, this.namespace);
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
exports.RedisAdapter = RedisAdapter;
|
|
160
|
+
// ─── Factory ──────────────────────────────────────────────────────────────────
|
|
161
|
+
/**
|
|
162
|
+
* Create a Redis storage adapter.
|
|
163
|
+
*
|
|
164
|
+
* @example
|
|
165
|
+
* ```ts
|
|
166
|
+
* import { createClient } from 'redis';
|
|
167
|
+
* import { createRedisAdapter } from '@periodic/vanadium/adapters/redis';
|
|
168
|
+
*
|
|
169
|
+
* const client = createClient({ url: process.env.REDIS_URL });
|
|
170
|
+
* await client.connect();
|
|
171
|
+
*
|
|
172
|
+
* const adapter = createRedisAdapter({ client, namespace: 'payments' });
|
|
173
|
+
* ```
|
|
174
|
+
*/
|
|
175
|
+
function createRedisAdapter(options) {
|
|
176
|
+
return new RedisAdapter(options);
|
|
177
|
+
}
|
|
178
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/redis/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAmNH,gDAEC;AAlND,oDAAqF;AACrF,qDAAyE;AACzE,iDAAyD;AA8BzD,gFAAgF;AAEhF,uDAAuD;AACvD,MAAM,OAAO,GAAG;;;;;;;;;;;;CAYf,CAAC;AAEF,qDAAqD;AACrD,MAAM,eAAe,GAAG;;;;;;CAMvB,CAAC;AAEF,iFAAiF;AAEjF,MAAa,YAAY;IASvB,YAAY,OAA4B;QARxB,SAAI,GAAG,OAAO,CAAC;QAS7B,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,IAAA,mCAAwB,EAAC,EAAE,EAAE,OAAO,EAAE,4CAA4C,CAAC,CAAC;QAC5F,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,WAAW,CAAC;QAClD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC;IACzC,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,GAAG,CAAc,GAAW;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC;YAC9B,OAAO,IAAA,yBAAa,EAAkB,GAAG,EAAE,SAAS,GAAG,EAAE,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAA,6BAAkB,EAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAc,GAAW,EAAE,KAAsB,EAAE,KAAc;QACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,UAAkB,CAAC;QACvB,IAAI,CAAC;YACH,UAAU,GAAG,IAAA,6BAAiB,EAAC,KAAK,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAA,6BAAkB,EAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC;YACH,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACrC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAA,6BAAkB,EAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAA,6BAAkB,EAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,GAAW,EACX,kBAA0B,EAC1B,QAAyB,EACzB,KAAc;QAEd,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,UAAkB,CAAC;QACvB,IAAI,CAAC;YACH,UAAU,GAAG,IAAA,6BAAiB,EAAC,QAAQ,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAA,6BAAkB,EAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;oBAC7C,IAAI,EAAE,CAAC,QAAQ,CAAC;oBAChB,SAAS,EAAE,CAAC,kBAAkB,EAAE,UAAU,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;iBAChE,CAAC,CAAC;gBACH,OAAO,MAAM,KAAK,CAAC,CAAC;YACtB,CAAC;YAED,mEAAmE;YACnE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAChD,IAAI,CAAC,OAAO;gBAAE,OAAO,KAAK,CAAC;YAC3B,MAAM,QAAQ,GAAG,IAAA,yBAAa,EAAkB,OAAO,EAAE,OAAO,GAAG,EAAE,CAAC,CAAC;YACvE,IAAI,QAAQ,CAAC,UAAU,KAAK,kBAAkB;gBAAE,OAAO,KAAK,CAAC;YAC7D,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAAyB,CAAC,IAAI,KAAK,SAAS;gBAAE,MAAM,GAAG,CAAC;YAC7D,MAAM,IAAA,6BAAkB,EAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,GAAW,EAAE,UAAkB;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE;gBACrD,IAAI,EAAE,CAAC,QAAQ,CAAC;gBAChB,SAAS,EAAE,CAAC,UAAU,CAAC;aACxB,CAAC,CAAC;YACH,OAAO,MAAM,KAAK,CAAC,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAA,6BAAkB,EAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,6EAA6E;IAE7E,YAAY;QACV,OAAO;YACL,YAAY,EAAE,KAAK;YACnB,GAAG,EAAE,IAAI;YACT,GAAG,EAAE,IAAI;YACT,aAAa,EAAE,KAAK;SACrB,CAAC;IACJ,CAAC;IAED,6EAA6E;IAErE,SAAS,CAAC,GAAW;QAC3B,OAAO,IAAA,4BAAkB,EAAC,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACjE,CAAC;CACF;AAlID,oCAkIC;AAED,iFAAiF;AAEjF;;;;;;;;;;;;;GAaG;AACH,SAAgB,kBAAkB,CAAC,OAA4B;IAC7D,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC"}
|