@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.
Files changed (136) hide show
  1. package/CHANGELOG.md +37 -0
  2. package/LICENSE +21 -0
  3. package/README.md +846 -0
  4. package/dist/cjs/adapters/memory/index.js +134 -0
  5. package/dist/cjs/adapters/memory/index.js.map +1 -0
  6. package/dist/cjs/adapters/mongodb/index.js +189 -0
  7. package/dist/cjs/adapters/mongodb/index.js.map +1 -0
  8. package/dist/cjs/adapters/mongoose/index.js +199 -0
  9. package/dist/cjs/adapters/mongoose/index.js.map +1 -0
  10. package/dist/cjs/adapters/postgres/index.js +202 -0
  11. package/dist/cjs/adapters/postgres/index.js.map +1 -0
  12. package/dist/cjs/adapters/prisma/index.js +176 -0
  13. package/dist/cjs/adapters/prisma/index.js.map +1 -0
  14. package/dist/cjs/adapters/redis/index.js +178 -0
  15. package/dist/cjs/adapters/redis/index.js.map +1 -0
  16. package/dist/cjs/cleanup/engine.js +100 -0
  17. package/dist/cjs/cleanup/engine.js.map +1 -0
  18. package/dist/cjs/core/concurrencyGuard.js +50 -0
  19. package/dist/cjs/core/concurrencyGuard.js.map +1 -0
  20. package/dist/cjs/core/metrics.js +39 -0
  21. package/dist/cjs/core/metrics.js.map +1 -0
  22. package/dist/cjs/core/stateMachine.js +46 -0
  23. package/dist/cjs/core/stateMachine.js.map +1 -0
  24. package/dist/cjs/errors/index.js +127 -0
  25. package/dist/cjs/errors/index.js.map +1 -0
  26. package/dist/cjs/http/express.js +84 -0
  27. package/dist/cjs/http/express.js.map +1 -0
  28. package/dist/cjs/http/fastify.js +70 -0
  29. package/dist/cjs/http/fastify.js.map +1 -0
  30. package/dist/cjs/idempotency/engine.js +266 -0
  31. package/dist/cjs/idempotency/engine.js.map +1 -0
  32. package/dist/cjs/index.js +19 -0
  33. package/dist/cjs/index.js.map +1 -0
  34. package/dist/cjs/lock/engine.js +187 -0
  35. package/dist/cjs/lock/engine.js.map +1 -0
  36. package/dist/cjs/observability/metrics.js +92 -0
  37. package/dist/cjs/observability/metrics.js.map +1 -0
  38. package/dist/cjs/resilience/circuitBreaker.js +129 -0
  39. package/dist/cjs/resilience/circuitBreaker.js.map +1 -0
  40. package/dist/cjs/types/index.js +13 -0
  41. package/dist/cjs/types/index.js.map +1 -0
  42. package/dist/cjs/utils/crypto.js +64 -0
  43. package/dist/cjs/utils/crypto.js.map +1 -0
  44. package/dist/cjs/utils/keys.js +40 -0
  45. package/dist/cjs/utils/keys.js.map +1 -0
  46. package/dist/cjs/utils/sleep.js +25 -0
  47. package/dist/cjs/utils/sleep.js.map +1 -0
  48. package/dist/esm/adapters/memory/index.js +129 -0
  49. package/dist/esm/adapters/memory/index.js.map +1 -0
  50. package/dist/esm/adapters/mongodb/index.js +184 -0
  51. package/dist/esm/adapters/mongodb/index.js.map +1 -0
  52. package/dist/esm/adapters/mongoose/index.js +193 -0
  53. package/dist/esm/adapters/mongoose/index.js.map +1 -0
  54. package/dist/esm/adapters/postgres/index.js +197 -0
  55. package/dist/esm/adapters/postgres/index.js.map +1 -0
  56. package/dist/esm/adapters/prisma/index.js +171 -0
  57. package/dist/esm/adapters/prisma/index.js.map +1 -0
  58. package/dist/esm/adapters/redis/index.js +173 -0
  59. package/dist/esm/adapters/redis/index.js.map +1 -0
  60. package/dist/esm/cleanup/engine.js +95 -0
  61. package/dist/esm/cleanup/engine.js.map +1 -0
  62. package/dist/esm/core/concurrencyGuard.js +46 -0
  63. package/dist/esm/core/concurrencyGuard.js.map +1 -0
  64. package/dist/esm/core/metrics.js +35 -0
  65. package/dist/esm/core/metrics.js.map +1 -0
  66. package/dist/esm/core/stateMachine.js +40 -0
  67. package/dist/esm/core/stateMachine.js.map +1 -0
  68. package/dist/esm/errors/index.js +114 -0
  69. package/dist/esm/errors/index.js.map +1 -0
  70. package/dist/esm/http/express.js +81 -0
  71. package/dist/esm/http/express.js.map +1 -0
  72. package/dist/esm/http/fastify.js +67 -0
  73. package/dist/esm/http/fastify.js.map +1 -0
  74. package/dist/esm/idempotency/engine.js +261 -0
  75. package/dist/esm/idempotency/engine.js.map +1 -0
  76. package/dist/esm/index.js +9 -0
  77. package/dist/esm/index.js.map +1 -0
  78. package/dist/esm/lock/engine.js +182 -0
  79. package/dist/esm/lock/engine.js.map +1 -0
  80. package/dist/esm/observability/metrics.js +89 -0
  81. package/dist/esm/observability/metrics.js.map +1 -0
  82. package/dist/esm/resilience/circuitBreaker.js +124 -0
  83. package/dist/esm/resilience/circuitBreaker.js.map +1 -0
  84. package/dist/esm/types/index.js +10 -0
  85. package/dist/esm/types/index.js.map +1 -0
  86. package/dist/esm/utils/crypto.js +58 -0
  87. package/dist/esm/utils/crypto.js.map +1 -0
  88. package/dist/esm/utils/keys.js +35 -0
  89. package/dist/esm/utils/keys.js.map +1 -0
  90. package/dist/esm/utils/sleep.js +20 -0
  91. package/dist/esm/utils/sleep.js.map +1 -0
  92. package/dist/types/adapters/memory/index.d.ts +49 -0
  93. package/dist/types/adapters/memory/index.d.ts.map +1 -0
  94. package/dist/types/adapters/mongodb/index.d.ts +97 -0
  95. package/dist/types/adapters/mongodb/index.d.ts.map +1 -0
  96. package/dist/types/adapters/mongoose/index.d.ts +107 -0
  97. package/dist/types/adapters/mongoose/index.d.ts.map +1 -0
  98. package/dist/types/adapters/postgres/index.d.ts +85 -0
  99. package/dist/types/adapters/postgres/index.d.ts.map +1 -0
  100. package/dist/types/adapters/prisma/index.d.ts +73 -0
  101. package/dist/types/adapters/prisma/index.d.ts.map +1 -0
  102. package/dist/types/adapters/redis/index.d.ts +77 -0
  103. package/dist/types/adapters/redis/index.d.ts.map +1 -0
  104. package/dist/types/cleanup/engine.d.ts +41 -0
  105. package/dist/types/cleanup/engine.d.ts.map +1 -0
  106. package/dist/types/core/concurrencyGuard.d.ts +28 -0
  107. package/dist/types/core/concurrencyGuard.d.ts.map +1 -0
  108. package/dist/types/core/metrics.d.ts +13 -0
  109. package/dist/types/core/metrics.d.ts.map +1 -0
  110. package/dist/types/core/stateMachine.d.ts +20 -0
  111. package/dist/types/core/stateMachine.d.ts.map +1 -0
  112. package/dist/types/errors/index.d.ts +32 -0
  113. package/dist/types/errors/index.d.ts.map +1 -0
  114. package/dist/types/http/express.d.ts +50 -0
  115. package/dist/types/http/express.d.ts.map +1 -0
  116. package/dist/types/http/fastify.d.ts +48 -0
  117. package/dist/types/http/fastify.d.ts.map +1 -0
  118. package/dist/types/idempotency/engine.d.ts +24 -0
  119. package/dist/types/idempotency/engine.d.ts.map +1 -0
  120. package/dist/types/index.d.ts +8 -0
  121. package/dist/types/index.d.ts.map +1 -0
  122. package/dist/types/lock/engine.d.ts +28 -0
  123. package/dist/types/lock/engine.d.ts.map +1 -0
  124. package/dist/types/observability/metrics.d.ts +45 -0
  125. package/dist/types/observability/metrics.d.ts.map +1 -0
  126. package/dist/types/resilience/circuitBreaker.d.ts +48 -0
  127. package/dist/types/resilience/circuitBreaker.d.ts.map +1 -0
  128. package/dist/types/types/index.d.ts +170 -0
  129. package/dist/types/types/index.d.ts.map +1 -0
  130. package/dist/types/utils/crypto.d.ts +20 -0
  131. package/dist/types/utils/crypto.d.ts.map +1 -0
  132. package/dist/types/utils/keys.d.ts +15 -0
  133. package/dist/types/utils/keys.d.ts.map +1 -0
  134. package/dist/types/utils/sleep.d.ts +13 -0
  135. package/dist/types/utils/sleep.d.ts.map +1 -0
  136. 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":"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"}