@objectstack/service-cluster-redis 17.0.0-rc.6 → 17.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 +836 -0
- package/dist/index.cjs.map +1 -1
- package/package.json +3 -3
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,841 @@
|
|
|
1
1
|
# @objectstack/service-cluster-redis
|
|
2
2
|
|
|
3
|
+
## 17.0.0
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- 2e836de: chore(packaging): CHANGELOG.md ships in every npm tarball (#4261)
|
|
8
|
+
|
|
9
|
+
The AGENTS.md post-task checklist requires breaking changesets to carry their
|
|
10
|
+
FROM → TO migration because "this text ships to consumers as `CHANGELOG.md`
|
|
11
|
+
inside the npm package and is what an upgrading agent greps after the tombstone
|
|
12
|
+
error." That delivery path was severed for 68 of the 69 publishable packages:
|
|
13
|
+
npm packs `package.json` / `README*` / `LICENSE*` unconditionally but — unlike
|
|
14
|
+
older npm versions — not `CHANGELOG.md`, and the canonical
|
|
15
|
+
`"files": ["dist", "README.md"]` whitelist never named it. Measured on npm
|
|
16
|
+
10.9.7: `npm pack --dry-run` on `@objectstack/types` shipped 3 files while its
|
|
17
|
+
70KB `CHANGELOG.md` stayed behind. Only `@objectstack/spec` listed it
|
|
18
|
+
explicitly.
|
|
19
|
+
|
|
20
|
+
The tombstone-error scenario is precisely the one where the repo is out of
|
|
21
|
+
reach — the upgrading agent has `node_modules` and nothing else — so the
|
|
22
|
+
migration text has to ride in the tarball. Every publishable package now
|
|
23
|
+
declares `CHANGELOG.md` in `files`, and the canonical whitelist is
|
|
24
|
+
`["dist", "README.md", "CHANGELOG.md"]`.
|
|
25
|
+
|
|
26
|
+
The other half is the gate: `check:published-files` gains a fifth invariant,
|
|
27
|
+
COMPLETE — a whitelist that fails to cover `CHANGELOG.md` fails the
|
|
28
|
+
always-required lint job, so the next package cannot silently sever the path
|
|
29
|
+
again. `@objectstack/spec`'s per-package EXTRA_ENTRIES exemption dissolves
|
|
30
|
+
into the canonical set.
|
|
31
|
+
|
|
32
|
+
Consumer-visible change: one more file per install (the package's changelog,
|
|
33
|
+
e.g. 70.8KB for `@objectstack/types`), and `grep -r "removed key"
|
|
34
|
+
node_modules/@objectstack/*/CHANGELOG.md` now finds the migration it was
|
|
35
|
+
promised.
|
|
36
|
+
|
|
37
|
+
- cc2de0e: chore(packaging): 20 packages stop publishing their sources, tests and build tooling (#4248)
|
|
38
|
+
|
|
39
|
+
These 20 packages declared no `files` field, so npm fell back to packing the
|
|
40
|
+
whole package directory. `npm pack --dry-run` on `@objectstack/plugin-webhooks`
|
|
41
|
+
listed **21 files** — 15 under `src/`, three of them unit tests
|
|
42
|
+
(`auto-enqueuer.test.ts`, `bootstrap-declared-webhooks.test.ts`, …), plus the
|
|
43
|
+
build-time `scripts/i18n-extract.config.ts`. `dist/` lands on top of that at
|
|
44
|
+
publish time rather than instead of it, so consumers were installing the
|
|
45
|
+
TypeScript sources and the test suite alongside the artifact they asked for.
|
|
46
|
+
|
|
47
|
+
Each now declares `"files": ["dist", "README.md"]`, matching the 29 packages
|
|
48
|
+
that already did. Nothing a consumer imports moves: every `main` / `types` /
|
|
49
|
+
`exports` target in all 20 already resolved inside `dist/`, which the new
|
|
50
|
+
`check:published-files` guard verifies rather than assumes. The visible change
|
|
51
|
+
is a smaller install and a smaller dependency-scanning surface — `npm pack` on
|
|
52
|
+
`@objectstack/plugin-webhooks` now yields 2 files plus `dist/`.
|
|
53
|
+
|
|
54
|
+
The other half of the fix is the gate. Half the packages declaring `files` and
|
|
55
|
+
half not was the #3786 shape — a hand-copied convention with nothing enforcing
|
|
56
|
+
it, where whoever forgets the line gets no signal at all. `check:published-files`
|
|
57
|
+
(new, wired into the always-required `lint` job) holds every non-private
|
|
58
|
+
workspace package to four invariants: `files` is **declared**; it is
|
|
59
|
+
**sufficient** (covers every entry point, so tightening a whitelist cannot ship
|
|
60
|
+
a package that fails to resolve); it is **minimal** (admits no test, test-harness
|
|
61
|
+
config or build script); and anything beyond `dist` + `README.md` is
|
|
62
|
+
**registered** with a reason, reconciled in both directions so a stale exemption
|
|
63
|
+
is an error rather than dead text. `@objectstack/spec` is the one package with
|
|
64
|
+
registered extras — its `.zod.ts` sources, JSON Schemas, liveness ledgers and
|
|
65
|
+
`CHANGELOG.md` are product, not build input.
|
|
66
|
+
|
|
67
|
+
This also closes an assumption #4206 was resting on. Excluding `<pkg>/scripts/**`
|
|
68
|
+
from the docs-drift implementation test is sound only while no package publishes
|
|
69
|
+
`scripts/` as runtime code; that held, but it held because someone read all three
|
|
70
|
+
offenders by hand. It is now checked on every PR.
|
|
71
|
+
|
|
72
|
+
- Updated dependencies [50616d9]
|
|
73
|
+
- Updated dependencies [430dcc2]
|
|
74
|
+
- Updated dependencies [6a67d7a]
|
|
75
|
+
- Updated dependencies [333a374]
|
|
76
|
+
- Updated dependencies [9fe9c1d]
|
|
77
|
+
- Updated dependencies [3d5c090]
|
|
78
|
+
- Updated dependencies [e5bd768]
|
|
79
|
+
- Updated dependencies [08b5a3d]
|
|
80
|
+
- Updated dependencies [e027b3e]
|
|
81
|
+
- Updated dependencies [e6ac4bd]
|
|
82
|
+
- Updated dependencies [c2429b0]
|
|
83
|
+
- Updated dependencies [445a0c2]
|
|
84
|
+
- Updated dependencies [d99aeb3]
|
|
85
|
+
- Updated dependencies [f6609e6]
|
|
86
|
+
- Updated dependencies [4727eb8]
|
|
87
|
+
- Updated dependencies [a70358a]
|
|
88
|
+
- Updated dependencies [0ecc656]
|
|
89
|
+
- Updated dependencies [06772eb]
|
|
90
|
+
- Updated dependencies [d4e0809]
|
|
91
|
+
- Updated dependencies [80334c7]
|
|
92
|
+
- Updated dependencies [f63cd09]
|
|
93
|
+
- Updated dependencies [97e7e3c]
|
|
94
|
+
- Updated dependencies [ce5242c]
|
|
95
|
+
- Updated dependencies [a7163ea]
|
|
96
|
+
- Updated dependencies [e6e9379]
|
|
97
|
+
- Updated dependencies [5823d59]
|
|
98
|
+
- Updated dependencies [3140f9c]
|
|
99
|
+
- Updated dependencies [9500ba4]
|
|
100
|
+
- Updated dependencies [fa3d0cf]
|
|
101
|
+
- Updated dependencies [af5a224]
|
|
102
|
+
- Updated dependencies [71f76e1]
|
|
103
|
+
- Updated dependencies [37b1346]
|
|
104
|
+
- Updated dependencies [99736a0]
|
|
105
|
+
- Updated dependencies [fe67e34]
|
|
106
|
+
- Updated dependencies [fdb4f50]
|
|
107
|
+
- Updated dependencies [270650f]
|
|
108
|
+
- Updated dependencies [3aef718]
|
|
109
|
+
- Updated dependencies [1bd5652]
|
|
110
|
+
- Updated dependencies [14252d3]
|
|
111
|
+
- Updated dependencies [7fb436c]
|
|
112
|
+
- Updated dependencies [879ea13]
|
|
113
|
+
- Updated dependencies [8828b9e]
|
|
114
|
+
- Updated dependencies [1ea6bce]
|
|
115
|
+
- Updated dependencies [c1dcacd]
|
|
116
|
+
- Updated dependencies [ad303ed]
|
|
117
|
+
- Updated dependencies [32ccb23]
|
|
118
|
+
- Updated dependencies [f5a4ef0]
|
|
119
|
+
- Updated dependencies [2d3e255]
|
|
120
|
+
- Updated dependencies [a8940e4]
|
|
121
|
+
- Updated dependencies [7d7521f]
|
|
122
|
+
- Updated dependencies [5dc4d02]
|
|
123
|
+
- Updated dependencies [f724f69]
|
|
124
|
+
- Updated dependencies [98877c9]
|
|
125
|
+
- Updated dependencies [98877c9]
|
|
126
|
+
- Updated dependencies [53068c1]
|
|
127
|
+
- Updated dependencies [ee58392]
|
|
128
|
+
- Updated dependencies [f16e54e]
|
|
129
|
+
- Updated dependencies [06be54e]
|
|
130
|
+
- Updated dependencies [28ad90e]
|
|
131
|
+
- Updated dependencies [76d74ec]
|
|
132
|
+
- Updated dependencies [201b31f]
|
|
133
|
+
- Updated dependencies [e6b1b69]
|
|
134
|
+
- Updated dependencies [259459d]
|
|
135
|
+
- Updated dependencies [3f7f14e]
|
|
136
|
+
- Updated dependencies [e2616e0]
|
|
137
|
+
- Updated dependencies [6fdc5c6]
|
|
138
|
+
- Updated dependencies [8b9d71e]
|
|
139
|
+
- Updated dependencies [05154a1]
|
|
140
|
+
- Updated dependencies [33f5e23]
|
|
141
|
+
- Updated dependencies [259af21]
|
|
142
|
+
- Updated dependencies [f8644c7]
|
|
143
|
+
- Updated dependencies [306ca50]
|
|
144
|
+
- Updated dependencies [978fed2]
|
|
145
|
+
- Updated dependencies [cfc293f]
|
|
146
|
+
- Updated dependencies [587fc91]
|
|
147
|
+
- Updated dependencies [de70b42]
|
|
148
|
+
- Updated dependencies [9b6fe7c]
|
|
149
|
+
- Updated dependencies [fb3d99b]
|
|
150
|
+
- Updated dependencies [1986594]
|
|
151
|
+
- Updated dependencies [6968885]
|
|
152
|
+
- Updated dependencies [eaed61f]
|
|
153
|
+
- Updated dependencies [cdfbee2]
|
|
154
|
+
- Updated dependencies [ad4af62]
|
|
155
|
+
- Updated dependencies [debe2f6]
|
|
156
|
+
- Updated dependencies [d44dbfa]
|
|
157
|
+
- Updated dependencies [29c6c9d]
|
|
158
|
+
- Updated dependencies [d21c001]
|
|
159
|
+
- Updated dependencies [ad047d2]
|
|
160
|
+
- Updated dependencies [8c711fb]
|
|
161
|
+
- Updated dependencies [f1cc3a3]
|
|
162
|
+
- Updated dependencies [09e4547]
|
|
163
|
+
- Updated dependencies [97b0798]
|
|
164
|
+
- Updated dependencies [474fe39]
|
|
165
|
+
- Updated dependencies [0bc685a]
|
|
166
|
+
- Updated dependencies [b949059]
|
|
167
|
+
- Updated dependencies [2826d1e]
|
|
168
|
+
- Updated dependencies [be1c52c]
|
|
169
|
+
- Updated dependencies [c5ff96d]
|
|
170
|
+
- Updated dependencies [5a84d41]
|
|
171
|
+
- Updated dependencies [84e7be9]
|
|
172
|
+
- Updated dependencies [91f4c78]
|
|
173
|
+
- Updated dependencies [ddc2527]
|
|
174
|
+
- Updated dependencies [820eff9]
|
|
175
|
+
- Updated dependencies [a6c3f38]
|
|
176
|
+
- Updated dependencies [debc23a]
|
|
177
|
+
- Updated dependencies [0f8ad09]
|
|
178
|
+
- Updated dependencies [553a47f]
|
|
179
|
+
- Updated dependencies [43a7a8d]
|
|
180
|
+
- Updated dependencies [a98085f]
|
|
181
|
+
- Updated dependencies [20b1a9e]
|
|
182
|
+
- Updated dependencies [344a22a]
|
|
183
|
+
- Updated dependencies [4827e91]
|
|
184
|
+
- Updated dependencies [8d895ff]
|
|
185
|
+
- Updated dependencies [86f7a20]
|
|
186
|
+
- Updated dependencies [a3a884d]
|
|
187
|
+
- Updated dependencies [cfed092]
|
|
188
|
+
- Updated dependencies [203a449]
|
|
189
|
+
- Updated dependencies [8f9689f]
|
|
190
|
+
- Updated dependencies [73f69dc]
|
|
191
|
+
- Updated dependencies [04c56aa]
|
|
192
|
+
- Updated dependencies [f6472d7]
|
|
193
|
+
- Updated dependencies [57a3bb3]
|
|
194
|
+
- Updated dependencies [b3efeb7]
|
|
195
|
+
- Updated dependencies [ddd075a]
|
|
196
|
+
- Updated dependencies [88154be]
|
|
197
|
+
- Updated dependencies [e8dc61e]
|
|
198
|
+
- Updated dependencies [9c82146]
|
|
199
|
+
- Updated dependencies [5f9a987]
|
|
200
|
+
- Updated dependencies [744b8f5]
|
|
201
|
+
- Updated dependencies [ac37fc6]
|
|
202
|
+
- Updated dependencies [2f3e793]
|
|
203
|
+
- Updated dependencies [4820f55]
|
|
204
|
+
- Updated dependencies [462d9c4]
|
|
205
|
+
- Updated dependencies [78caf51]
|
|
206
|
+
- Updated dependencies [7d21581]
|
|
207
|
+
- Updated dependencies [37785ed]
|
|
208
|
+
- Updated dependencies [62a789b]
|
|
209
|
+
- Updated dependencies [2e284b2]
|
|
210
|
+
- Updated dependencies [d8e8d9c]
|
|
211
|
+
- Updated dependencies [789ad63]
|
|
212
|
+
- Updated dependencies [f2445c9]
|
|
213
|
+
- Updated dependencies [94e749b]
|
|
214
|
+
- Updated dependencies [ea1d916]
|
|
215
|
+
- Updated dependencies [2af1988]
|
|
216
|
+
- Updated dependencies [1b49eaf]
|
|
217
|
+
- Updated dependencies [ae31a19]
|
|
218
|
+
- Updated dependencies [2e836de]
|
|
219
|
+
- Updated dependencies [e0f300b]
|
|
220
|
+
- Updated dependencies [0161c7f]
|
|
221
|
+
- Updated dependencies [e900015]
|
|
222
|
+
- Updated dependencies [db02d47]
|
|
223
|
+
- Updated dependencies [b5bdf48]
|
|
224
|
+
- Updated dependencies [23338c3]
|
|
225
|
+
- Updated dependencies [12a19a8]
|
|
226
|
+
- Updated dependencies [5b843fb]
|
|
227
|
+
- Updated dependencies [62b6a2f]
|
|
228
|
+
- Updated dependencies [7e5af5c]
|
|
229
|
+
- Updated dependencies [5b4780b]
|
|
230
|
+
- Updated dependencies [a933452]
|
|
231
|
+
- Updated dependencies [9d1d9c7]
|
|
232
|
+
- Updated dependencies [8140915]
|
|
233
|
+
- Updated dependencies [a019e52]
|
|
234
|
+
- Updated dependencies [e8f8f6c]
|
|
235
|
+
- Updated dependencies [41dcda3]
|
|
236
|
+
- Updated dependencies [7b48cf9]
|
|
237
|
+
- Updated dependencies [b5404f4]
|
|
238
|
+
- Updated dependencies [64fc6d5]
|
|
239
|
+
- Updated dependencies [b4487aa]
|
|
240
|
+
- Updated dependencies [1007379]
|
|
241
|
+
- Updated dependencies [65ca83a]
|
|
242
|
+
- Updated dependencies [0bfdf46]
|
|
243
|
+
- Updated dependencies [947d4f9]
|
|
244
|
+
- Updated dependencies [f764691]
|
|
245
|
+
- Updated dependencies [e120a5a]
|
|
246
|
+
- Updated dependencies [e5bd2f6]
|
|
247
|
+
- Updated dependencies [e650d67]
|
|
248
|
+
- Updated dependencies [04476e7]
|
|
249
|
+
- Updated dependencies [67bf2e2]
|
|
250
|
+
- Updated dependencies [eaaf03c]
|
|
251
|
+
- Updated dependencies [d17df80]
|
|
252
|
+
- Updated dependencies [7d0e7b5]
|
|
253
|
+
- Updated dependencies [c6d1cb4]
|
|
254
|
+
- Updated dependencies [6513c17]
|
|
255
|
+
- Updated dependencies [36030ff]
|
|
256
|
+
- Updated dependencies [79228cd]
|
|
257
|
+
- Updated dependencies [6117f7b]
|
|
258
|
+
- Updated dependencies [e533b0b]
|
|
259
|
+
- Updated dependencies [cdf4d9a]
|
|
260
|
+
- Updated dependencies [aee1806]
|
|
261
|
+
- Updated dependencies [c13350b]
|
|
262
|
+
- Updated dependencies [c13350b]
|
|
263
|
+
- Updated dependencies [2c1988c]
|
|
264
|
+
- Updated dependencies [9ca2d85]
|
|
265
|
+
- Updated dependencies [c13350b]
|
|
266
|
+
- Updated dependencies [891d345]
|
|
267
|
+
- Updated dependencies [c8124e5]
|
|
268
|
+
- Updated dependencies [a52e2ef]
|
|
269
|
+
- Updated dependencies [5293114]
|
|
270
|
+
- Updated dependencies [376a061]
|
|
271
|
+
- Updated dependencies [c142ced]
|
|
272
|
+
- Updated dependencies [211abdb]
|
|
273
|
+
- Updated dependencies [b3363e9]
|
|
274
|
+
- Updated dependencies [eda599e]
|
|
275
|
+
- Updated dependencies [a1a4140]
|
|
276
|
+
- Updated dependencies [7c7e246]
|
|
277
|
+
- Updated dependencies [2ef1807]
|
|
278
|
+
- Updated dependencies [f35cdc5]
|
|
279
|
+
- Updated dependencies [d03fe25]
|
|
280
|
+
- Updated dependencies [217e2e6]
|
|
281
|
+
- Updated dependencies [2672f85]
|
|
282
|
+
- Updated dependencies [20bc357]
|
|
283
|
+
- Updated dependencies [11066f6]
|
|
284
|
+
- Updated dependencies [916af17]
|
|
285
|
+
- Updated dependencies [84c86fb]
|
|
286
|
+
- Updated dependencies [2a2a9fb]
|
|
287
|
+
- Updated dependencies [86a71d1]
|
|
288
|
+
- Updated dependencies [c001422]
|
|
289
|
+
- Updated dependencies [77022a9]
|
|
290
|
+
- Updated dependencies [d5c75e2]
|
|
291
|
+
- Updated dependencies [03d26f7]
|
|
292
|
+
- Updated dependencies [5966c2a]
|
|
293
|
+
- Updated dependencies [2382580]
|
|
294
|
+
- Updated dependencies [9ea2bc5]
|
|
295
|
+
- Updated dependencies [a2e157c]
|
|
296
|
+
- Updated dependencies [95c4227]
|
|
297
|
+
- Updated dependencies [2a61116]
|
|
298
|
+
- Updated dependencies [52760bf]
|
|
299
|
+
- Updated dependencies [5543020]
|
|
300
|
+
- Updated dependencies [880d343]
|
|
301
|
+
- Updated dependencies [6e82972]
|
|
302
|
+
- Updated dependencies [d4df105]
|
|
303
|
+
- Updated dependencies [4615a18]
|
|
304
|
+
- Updated dependencies [f505689]
|
|
305
|
+
- Updated dependencies [d9fa683]
|
|
306
|
+
- Updated dependencies [606d577]
|
|
307
|
+
- Updated dependencies [4384921]
|
|
308
|
+
- Updated dependencies [e2798fa]
|
|
309
|
+
- Updated dependencies [3c628ce]
|
|
310
|
+
- Updated dependencies [c2d9098]
|
|
311
|
+
- Updated dependencies [0fd8556]
|
|
312
|
+
- Updated dependencies [3c7bcc0]
|
|
313
|
+
- Updated dependencies [4b6cac7]
|
|
314
|
+
- Updated dependencies [7631964]
|
|
315
|
+
- Updated dependencies [ac471a0]
|
|
316
|
+
- Updated dependencies [60ae58e]
|
|
317
|
+
- Updated dependencies [7f62706]
|
|
318
|
+
- Updated dependencies [667fa44]
|
|
319
|
+
- Updated dependencies [37e38d1]
|
|
320
|
+
- Updated dependencies [e906126]
|
|
321
|
+
- Updated dependencies [ce92674]
|
|
322
|
+
- Updated dependencies [08363a0]
|
|
323
|
+
- Updated dependencies [444de5b]
|
|
324
|
+
- Updated dependencies [a227ed7]
|
|
325
|
+
- Updated dependencies [7cb922e]
|
|
326
|
+
- Updated dependencies [1d22114]
|
|
327
|
+
- Updated dependencies [1eb13a0]
|
|
328
|
+
- Updated dependencies [c52e608]
|
|
329
|
+
- Updated dependencies [9613396]
|
|
330
|
+
- Updated dependencies [3f7b4ff]
|
|
331
|
+
- Updated dependencies [74155c7]
|
|
332
|
+
- Updated dependencies [b5f9397]
|
|
333
|
+
- Updated dependencies [ed77493]
|
|
334
|
+
- Updated dependencies [6908830]
|
|
335
|
+
- Updated dependencies [8b06bba]
|
|
336
|
+
- Updated dependencies [58a03d2]
|
|
337
|
+
- Updated dependencies [2bacd1a]
|
|
338
|
+
- Updated dependencies [e47b342]
|
|
339
|
+
- Updated dependencies [4c54037]
|
|
340
|
+
- Updated dependencies [dc530b4]
|
|
341
|
+
- Updated dependencies [9f601e8]
|
|
342
|
+
- Updated dependencies [6a9dec6]
|
|
343
|
+
- Updated dependencies [0f7157b]
|
|
344
|
+
- Updated dependencies [4dc1c7d]
|
|
345
|
+
- Updated dependencies [d9bef45]
|
|
346
|
+
- Updated dependencies [4dfd002]
|
|
347
|
+
- Updated dependencies [f549a0d]
|
|
348
|
+
- Updated dependencies [51c5227]
|
|
349
|
+
- Updated dependencies [82da264]
|
|
350
|
+
- Updated dependencies [77be690]
|
|
351
|
+
- Updated dependencies [4ed7ed4]
|
|
352
|
+
- Updated dependencies [9b9b70f]
|
|
353
|
+
- Updated dependencies [f5a9bc2]
|
|
354
|
+
- Updated dependencies [e59786e]
|
|
355
|
+
- Updated dependencies [2fa4ca1]
|
|
356
|
+
- Updated dependencies [bcf1112]
|
|
357
|
+
- Updated dependencies [baeb4f0]
|
|
358
|
+
- Updated dependencies [29488cc]
|
|
359
|
+
- Updated dependencies [881a3cc]
|
|
360
|
+
- Updated dependencies [f5a2320]
|
|
361
|
+
- Updated dependencies [ad6317b]
|
|
362
|
+
- Updated dependencies [811c30c]
|
|
363
|
+
- Updated dependencies [a4a85c8]
|
|
364
|
+
- Updated dependencies [859cb83]
|
|
365
|
+
- Updated dependencies [07a4e26]
|
|
366
|
+
- Updated dependencies [9774b78]
|
|
367
|
+
- Updated dependencies [8a88885]
|
|
368
|
+
- Updated dependencies [deb538f]
|
|
369
|
+
- Updated dependencies [b49ccfd]
|
|
370
|
+
- Updated dependencies [5b89711]
|
|
371
|
+
- Updated dependencies [85d95e7]
|
|
372
|
+
- Updated dependencies [08cd163]
|
|
373
|
+
- Updated dependencies [0c8a22f]
|
|
374
|
+
- Updated dependencies [5f7669e]
|
|
375
|
+
- Updated dependencies [becbe53]
|
|
376
|
+
- Updated dependencies [b127c8b]
|
|
377
|
+
- Updated dependencies [763931e]
|
|
378
|
+
- Updated dependencies [ec975f1]
|
|
379
|
+
- Updated dependencies [168f60f]
|
|
380
|
+
- Updated dependencies [b07d829]
|
|
381
|
+
- Updated dependencies [de9af8a]
|
|
382
|
+
- Updated dependencies [eb4204b]
|
|
383
|
+
- Updated dependencies [a80302a]
|
|
384
|
+
- Updated dependencies [a648e96]
|
|
385
|
+
- Updated dependencies [a47ac06]
|
|
386
|
+
- Updated dependencies [e4c61a7]
|
|
387
|
+
- Updated dependencies [cc60165]
|
|
388
|
+
- Updated dependencies [474f131]
|
|
389
|
+
- Updated dependencies [081aa6f]
|
|
390
|
+
- Updated dependencies [91f4c78]
|
|
391
|
+
- Updated dependencies [050cd82]
|
|
392
|
+
- Updated dependencies [4d552af]
|
|
393
|
+
- Updated dependencies [44d677c]
|
|
394
|
+
- Updated dependencies [c32944d]
|
|
395
|
+
- Updated dependencies [1dd780f]
|
|
396
|
+
- Updated dependencies [e8d0c21]
|
|
397
|
+
- Updated dependencies [244ca86]
|
|
398
|
+
- Updated dependencies [546ab3c]
|
|
399
|
+
- Updated dependencies [c4df271]
|
|
400
|
+
- Updated dependencies [c8d6f6e]
|
|
401
|
+
- Updated dependencies [0b51bb6]
|
|
402
|
+
- Updated dependencies [d9971d3]
|
|
403
|
+
- Updated dependencies [7dc1067]
|
|
404
|
+
- Updated dependencies [4f13be2]
|
|
405
|
+
- Updated dependencies [a41ba5c]
|
|
406
|
+
- Updated dependencies [189854c]
|
|
407
|
+
- Updated dependencies [0e3a226]
|
|
408
|
+
- Updated dependencies [92a67f2]
|
|
409
|
+
- Updated dependencies [9136327]
|
|
410
|
+
- Updated dependencies [bf0ae99]
|
|
411
|
+
- Updated dependencies [abeb375]
|
|
412
|
+
- Updated dependencies [cb3b6cd]
|
|
413
|
+
- Updated dependencies [73b7234]
|
|
414
|
+
- Updated dependencies [d2b97c3]
|
|
415
|
+
- Updated dependencies [61cc079]
|
|
416
|
+
- Updated dependencies [0e96e46]
|
|
417
|
+
- Updated dependencies [c1d44f7]
|
|
418
|
+
- Updated dependencies [59b794f]
|
|
419
|
+
- Updated dependencies [ef4efa8]
|
|
420
|
+
- Updated dependencies [cbb6a5c]
|
|
421
|
+
- Updated dependencies [fc3a36a]
|
|
422
|
+
- Updated dependencies [ab9fb5c]
|
|
423
|
+
- Updated dependencies [69787f0]
|
|
424
|
+
- Updated dependencies [5d022a1]
|
|
425
|
+
- Updated dependencies [042b9ee]
|
|
426
|
+
- Updated dependencies [f985b3f]
|
|
427
|
+
- Updated dependencies [795b6e1]
|
|
428
|
+
- Updated dependencies [d52d4fe]
|
|
429
|
+
- Updated dependencies [742cebb]
|
|
430
|
+
- Updated dependencies [175d789]
|
|
431
|
+
- Updated dependencies [f549a0d]
|
|
432
|
+
- Updated dependencies [427344c]
|
|
433
|
+
- Updated dependencies [8af76ae]
|
|
434
|
+
- Updated dependencies [1d4756e]
|
|
435
|
+
- Updated dependencies [720c5ad]
|
|
436
|
+
- Updated dependencies [a8d1e24]
|
|
437
|
+
- Updated dependencies [b85cc54]
|
|
438
|
+
- Updated dependencies [a36db28]
|
|
439
|
+
- Updated dependencies [7a8476f]
|
|
440
|
+
- Updated dependencies [518ca7a]
|
|
441
|
+
- Updated dependencies [41642b0]
|
|
442
|
+
- Updated dependencies [4cca74c]
|
|
443
|
+
- Updated dependencies [88ef03e]
|
|
444
|
+
- Updated dependencies [9a4932a]
|
|
445
|
+
- Updated dependencies [3f8817a]
|
|
446
|
+
- Updated dependencies [a2443e3]
|
|
447
|
+
- Updated dependencies [e1554b1]
|
|
448
|
+
- Updated dependencies [9e2caf3]
|
|
449
|
+
- Updated dependencies [4856789]
|
|
450
|
+
- Updated dependencies [81ce41a]
|
|
451
|
+
- Updated dependencies [85e1e4e]
|
|
452
|
+
- Updated dependencies [c3f4916]
|
|
453
|
+
- Updated dependencies [55dbbba]
|
|
454
|
+
- Updated dependencies [33e0385]
|
|
455
|
+
- Updated dependencies [dac6a08]
|
|
456
|
+
- Updated dependencies [72c3c86]
|
|
457
|
+
- Updated dependencies [2d8dba3]
|
|
458
|
+
- Updated dependencies [7f1a635]
|
|
459
|
+
- Updated dependencies [2205363]
|
|
460
|
+
- Updated dependencies [09fe58d]
|
|
461
|
+
- Updated dependencies [f9fc874]
|
|
462
|
+
- Updated dependencies [d62f8eb]
|
|
463
|
+
- Updated dependencies [d0a5ceb]
|
|
464
|
+
- Updated dependencies [a7586cd]
|
|
465
|
+
- Updated dependencies [4c5e80e]
|
|
466
|
+
- Updated dependencies [4b5702a]
|
|
467
|
+
- Updated dependencies [011b386]
|
|
468
|
+
- Updated dependencies [e18a162]
|
|
469
|
+
- Updated dependencies [394b7a1]
|
|
470
|
+
- Updated dependencies [ce92674]
|
|
471
|
+
- Updated dependencies [cf2c9b7]
|
|
472
|
+
- Updated dependencies [d127ff0]
|
|
473
|
+
- Updated dependencies [36d90fc]
|
|
474
|
+
- Updated dependencies [7777e8f]
|
|
475
|
+
- Updated dependencies [9b86cf6]
|
|
476
|
+
- Updated dependencies [d063a96]
|
|
477
|
+
- Updated dependencies [8825a06]
|
|
478
|
+
- Updated dependencies [5087ac6]
|
|
479
|
+
- Updated dependencies [677b591]
|
|
480
|
+
- Updated dependencies [cf7c694]
|
|
481
|
+
- Updated dependencies [ddd0f06]
|
|
482
|
+
- Updated dependencies [d77d1b7]
|
|
483
|
+
- Updated dependencies [0f9faa2]
|
|
484
|
+
- Updated dependencies [2d1ddf0]
|
|
485
|
+
- Updated dependencies [354b00f]
|
|
486
|
+
- Updated dependencies [3de535b]
|
|
487
|
+
- Updated dependencies [fe2e15a]
|
|
488
|
+
- Updated dependencies [5b79a34]
|
|
489
|
+
- Updated dependencies [502564d]
|
|
490
|
+
- Updated dependencies [603cab8]
|
|
491
|
+
- Updated dependencies [c757854]
|
|
492
|
+
- Updated dependencies [471839d]
|
|
493
|
+
- Updated dependencies [507b92a]
|
|
494
|
+
- Updated dependencies [b508244]
|
|
495
|
+
- Updated dependencies [df95346]
|
|
496
|
+
- Updated dependencies [3dede58]
|
|
497
|
+
- Updated dependencies [c6b6bb4]
|
|
498
|
+
- Updated dependencies [594508e]
|
|
499
|
+
- Updated dependencies [7cf42fe]
|
|
500
|
+
- Updated dependencies [5966c2a]
|
|
501
|
+
- Updated dependencies [0045682]
|
|
502
|
+
- Updated dependencies [7309c81]
|
|
503
|
+
- Updated dependencies [2f59da0]
|
|
504
|
+
- Updated dependencies [d56012f]
|
|
505
|
+
- Updated dependencies [f78dd83]
|
|
506
|
+
- Updated dependencies [a2cd18a]
|
|
507
|
+
- Updated dependencies [9051802]
|
|
508
|
+
- Updated dependencies [20bc1ec]
|
|
509
|
+
- Updated dependencies [1c625ca]
|
|
510
|
+
- Updated dependencies [2f8328c]
|
|
511
|
+
- Updated dependencies [2a6c279]
|
|
512
|
+
- Updated dependencies [8c8f0df]
|
|
513
|
+
- Updated dependencies [8ad609c]
|
|
514
|
+
- Updated dependencies [bbee302]
|
|
515
|
+
- Updated dependencies [90c2b15]
|
|
516
|
+
- Updated dependencies [4638aaa]
|
|
517
|
+
- Updated dependencies [0222d3c]
|
|
518
|
+
- Updated dependencies [08863dd]
|
|
519
|
+
- Updated dependencies [f293d45]
|
|
520
|
+
- Updated dependencies [56664f5]
|
|
521
|
+
- Updated dependencies [71f205d]
|
|
522
|
+
- Updated dependencies [f067930]
|
|
523
|
+
- Updated dependencies [1e70d24]
|
|
524
|
+
- Updated dependencies [414395b]
|
|
525
|
+
- Updated dependencies [42eeb7d]
|
|
526
|
+
- Updated dependencies [31cbe90]
|
|
527
|
+
- Updated dependencies [6b7129a]
|
|
528
|
+
- Updated dependencies [97ace2a]
|
|
529
|
+
- Updated dependencies [26e1029]
|
|
530
|
+
- Updated dependencies [0a936ea]
|
|
531
|
+
- Updated dependencies [90bbf25]
|
|
532
|
+
- Updated dependencies [023c00b]
|
|
533
|
+
- Updated dependencies [eb91eba]
|
|
534
|
+
- Updated dependencies [42da73d]
|
|
535
|
+
- Updated dependencies [01e124d]
|
|
536
|
+
- Updated dependencies [ef7b5ef]
|
|
537
|
+
- Updated dependencies [9514767]
|
|
538
|
+
- Updated dependencies [8f20201]
|
|
539
|
+
- Updated dependencies [155507e]
|
|
540
|
+
- Updated dependencies [643b7c7]
|
|
541
|
+
- Updated dependencies [7bba90b]
|
|
542
|
+
- Updated dependencies [8813b90]
|
|
543
|
+
- Updated dependencies [108ba8d]
|
|
544
|
+
- Updated dependencies [2a5f04a]
|
|
545
|
+
- Updated dependencies [4f740b0]
|
|
546
|
+
- Updated dependencies [7ce02eb]
|
|
547
|
+
- Updated dependencies [b4ad984]
|
|
548
|
+
- Updated dependencies [a9f32df]
|
|
549
|
+
- Updated dependencies [aeb9b27]
|
|
550
|
+
- Updated dependencies [7d27da0]
|
|
551
|
+
- Updated dependencies [1a15893]
|
|
552
|
+
- Updated dependencies [b70e534]
|
|
553
|
+
- Updated dependencies [7e05d8e]
|
|
554
|
+
- Updated dependencies [8f1851e]
|
|
555
|
+
- Updated dependencies [61ea810]
|
|
556
|
+
- Updated dependencies [2233a85]
|
|
557
|
+
- Updated dependencies [67452d1]
|
|
558
|
+
- Updated dependencies [089767f]
|
|
559
|
+
- Updated dependencies [a13827e]
|
|
560
|
+
- Updated dependencies [66d99ec]
|
|
561
|
+
- Updated dependencies [cb43296]
|
|
562
|
+
- Updated dependencies [b61afc1]
|
|
563
|
+
- Updated dependencies [79021fc]
|
|
564
|
+
- Updated dependencies [7733604]
|
|
565
|
+
- Updated dependencies [40e420f]
|
|
566
|
+
- Updated dependencies [62dd69a]
|
|
567
|
+
- Updated dependencies [d13004a]
|
|
568
|
+
- Updated dependencies [be7360c]
|
|
569
|
+
- Updated dependencies [e15e679]
|
|
570
|
+
- Updated dependencies [2ab1257]
|
|
571
|
+
- Updated dependencies [0fc6219]
|
|
572
|
+
- Updated dependencies [061406d]
|
|
573
|
+
- Updated dependencies [e4c8b6c]
|
|
574
|
+
- Updated dependencies [acb10f6]
|
|
575
|
+
- Updated dependencies [605e190]
|
|
576
|
+
- Updated dependencies [c6c59f1]
|
|
577
|
+
- Updated dependencies [b0e78a8]
|
|
578
|
+
- Updated dependencies [f31cc8d]
|
|
579
|
+
- Updated dependencies [f343dc4]
|
|
580
|
+
- Updated dependencies [8269e32]
|
|
581
|
+
- Updated dependencies [74f7339]
|
|
582
|
+
- Updated dependencies [a6c35a2]
|
|
583
|
+
- Updated dependencies [c2f1002]
|
|
584
|
+
- Updated dependencies [4cc4fb7]
|
|
585
|
+
- Updated dependencies [cc2de0e]
|
|
586
|
+
- Updated dependencies [97b6658]
|
|
587
|
+
- Updated dependencies [2c26040]
|
|
588
|
+
- Updated dependencies [f758cec]
|
|
589
|
+
- Updated dependencies [5b47ab5]
|
|
590
|
+
- Updated dependencies [b09d8d9]
|
|
591
|
+
- Updated dependencies [b09d8d9]
|
|
592
|
+
- Updated dependencies [8675db6]
|
|
593
|
+
- Updated dependencies [b09d8d9]
|
|
594
|
+
- Updated dependencies [27358d5]
|
|
595
|
+
- Updated dependencies [1c3da1f]
|
|
596
|
+
- Updated dependencies [c1f344b]
|
|
597
|
+
- Updated dependencies [3eb1b2b]
|
|
598
|
+
- Updated dependencies [9c93465]
|
|
599
|
+
- Updated dependencies [a34fd2e]
|
|
600
|
+
- Updated dependencies [ebb209c]
|
|
601
|
+
- Updated dependencies [76bcb83]
|
|
602
|
+
- Updated dependencies [59b85c0]
|
|
603
|
+
- Updated dependencies [889ae47]
|
|
604
|
+
- Updated dependencies [4f4c3fb]
|
|
605
|
+
- Updated dependencies [78f0be8]
|
|
606
|
+
- Updated dependencies [6e357ed]
|
|
607
|
+
- Updated dependencies [d6938bf]
|
|
608
|
+
- Updated dependencies [35f7fb4]
|
|
609
|
+
- Updated dependencies [0410522]
|
|
610
|
+
- Updated dependencies [63b33e6]
|
|
611
|
+
- Updated dependencies [f163028]
|
|
612
|
+
- Updated dependencies [814db6d]
|
|
613
|
+
- Updated dependencies [a5302c7]
|
|
614
|
+
- Updated dependencies [31e0be9]
|
|
615
|
+
- Updated dependencies [4bfd455]
|
|
616
|
+
- Updated dependencies [ffd2ce2]
|
|
617
|
+
- Updated dependencies [2a44c1d]
|
|
618
|
+
- Updated dependencies [7084313]
|
|
619
|
+
- Updated dependencies [f07808c]
|
|
620
|
+
- Updated dependencies [7ffc3d3]
|
|
621
|
+
- Updated dependencies [88346ba]
|
|
622
|
+
- Updated dependencies [4631592]
|
|
623
|
+
- Updated dependencies [62f8017]
|
|
624
|
+
- Updated dependencies [32ff033]
|
|
625
|
+
- Updated dependencies [a831df1]
|
|
626
|
+
- Updated dependencies [f752ee3]
|
|
627
|
+
- Updated dependencies [a1b61e0]
|
|
628
|
+
- Updated dependencies [cd6b9f2]
|
|
629
|
+
- Updated dependencies [2cb6d3c]
|
|
630
|
+
- Updated dependencies [af2a095]
|
|
631
|
+
- Updated dependencies [5ac93d4]
|
|
632
|
+
- Updated dependencies [695cfbd]
|
|
633
|
+
- Updated dependencies [0e043d8]
|
|
634
|
+
- Updated dependencies [93f267f]
|
|
635
|
+
- Updated dependencies [7445149]
|
|
636
|
+
- Updated dependencies [ec796d5]
|
|
637
|
+
- Updated dependencies [071d0dc]
|
|
638
|
+
- Updated dependencies [0024abf]
|
|
639
|
+
- Updated dependencies [8dd98bf]
|
|
640
|
+
- Updated dependencies [e87fea1]
|
|
641
|
+
- Updated dependencies [c65e529]
|
|
642
|
+
- Updated dependencies [0848bea]
|
|
643
|
+
- Updated dependencies [d51bed2]
|
|
644
|
+
- Updated dependencies [dadd1ad]
|
|
645
|
+
- Updated dependencies [acbf364]
|
|
646
|
+
- Updated dependencies [3ca34c1]
|
|
647
|
+
- Updated dependencies [7adc841]
|
|
648
|
+
- Updated dependencies [239c3a3]
|
|
649
|
+
- Updated dependencies [b8b3c64]
|
|
650
|
+
- Updated dependencies [2f2e63c]
|
|
651
|
+
- Updated dependencies [4845f85]
|
|
652
|
+
- Updated dependencies [486d526]
|
|
653
|
+
- Updated dependencies [94a0bbc]
|
|
654
|
+
- Updated dependencies [d6bfb3d]
|
|
655
|
+
- Updated dependencies [8a9c079]
|
|
656
|
+
- Updated dependencies [7b005b4]
|
|
657
|
+
- Updated dependencies [cc3555e]
|
|
658
|
+
- Updated dependencies [a2266a6]
|
|
659
|
+
- Updated dependencies [d25a0ec]
|
|
660
|
+
- Updated dependencies [89d7b35]
|
|
661
|
+
- Updated dependencies [94f7b6a]
|
|
662
|
+
- Updated dependencies [5c94f83]
|
|
663
|
+
- Updated dependencies [ea936f3]
|
|
664
|
+
- Updated dependencies [0c0fbd9]
|
|
665
|
+
- Updated dependencies [667b83e]
|
|
666
|
+
- Updated dependencies [f3141d8]
|
|
667
|
+
- Updated dependencies [7687f7b]
|
|
668
|
+
- Updated dependencies [5a84d41]
|
|
669
|
+
- Updated dependencies [fd3013a]
|
|
670
|
+
- Updated dependencies [85ec26d]
|
|
671
|
+
- Updated dependencies [73e576f]
|
|
672
|
+
- Updated dependencies [f6476fc]
|
|
673
|
+
- Updated dependencies [69ac82c]
|
|
674
|
+
- Updated dependencies [4ac12ef]
|
|
675
|
+
- Updated dependencies [833ed84]
|
|
676
|
+
- Updated dependencies [a18abf3]
|
|
677
|
+
- Updated dependencies [c6a4eeb]
|
|
678
|
+
- Updated dependencies [1659072]
|
|
679
|
+
- Updated dependencies [f450ae7]
|
|
680
|
+
- Updated dependencies [abceb0d]
|
|
681
|
+
- Updated dependencies [627b188]
|
|
682
|
+
- Updated dependencies [8d4eae7]
|
|
683
|
+
- Updated dependencies [c5a5996]
|
|
684
|
+
- Updated dependencies [0c302a7]
|
|
685
|
+
- Updated dependencies [b88f5e8]
|
|
686
|
+
- Updated dependencies [65a3a84]
|
|
687
|
+
- Updated dependencies [6633337]
|
|
688
|
+
- Updated dependencies [21676eb]
|
|
689
|
+
- Updated dependencies [e9cb9ab]
|
|
690
|
+
- Updated dependencies [42cc219]
|
|
691
|
+
- Updated dependencies [d7e0b42]
|
|
692
|
+
- Updated dependencies [3510e4a]
|
|
693
|
+
- Updated dependencies [f00d8d4]
|
|
694
|
+
- Updated dependencies [5326b36]
|
|
695
|
+
- Updated dependencies [aa4b90d]
|
|
696
|
+
- Updated dependencies [ccd9397]
|
|
697
|
+
- Updated dependencies [503be86]
|
|
698
|
+
- Updated dependencies [54299ca]
|
|
699
|
+
- Updated dependencies [ae490ef]
|
|
700
|
+
- Updated dependencies [e124711]
|
|
701
|
+
- Updated dependencies [dc61def]
|
|
702
|
+
- Updated dependencies [bca935b]
|
|
703
|
+
- Updated dependencies [c54c822]
|
|
704
|
+
- Updated dependencies [8dcc0f5]
|
|
705
|
+
- Updated dependencies [75b9e51]
|
|
706
|
+
- Updated dependencies [f61c8cf]
|
|
707
|
+
- Updated dependencies [e3ef52b]
|
|
708
|
+
- Updated dependencies [0a2f233]
|
|
709
|
+
- Updated dependencies [8621cdd]
|
|
710
|
+
- Updated dependencies [251e888]
|
|
711
|
+
- Updated dependencies [07f1822]
|
|
712
|
+
- Updated dependencies [e336549]
|
|
713
|
+
- Updated dependencies [3bb9340]
|
|
714
|
+
- Updated dependencies [1e604c4]
|
|
715
|
+
- Updated dependencies [04fab5e]
|
|
716
|
+
- Updated dependencies [183b4c4]
|
|
717
|
+
- Updated dependencies [7f713b6]
|
|
718
|
+
- Updated dependencies [d40f43a]
|
|
719
|
+
- Updated dependencies [2fdb36e]
|
|
720
|
+
- Updated dependencies [6f23667]
|
|
721
|
+
- Updated dependencies [cde1975]
|
|
722
|
+
- Updated dependencies [0bc685a]
|
|
723
|
+
- Updated dependencies [20526f5]
|
|
724
|
+
- Updated dependencies [efedd28]
|
|
725
|
+
- Updated dependencies [5d21a48]
|
|
726
|
+
- Updated dependencies [5278e11]
|
|
727
|
+
- Updated dependencies [c5eef1d]
|
|
728
|
+
- Updated dependencies [e5e7ee0]
|
|
729
|
+
- Updated dependencies [23dba62]
|
|
730
|
+
- Updated dependencies [e0f300b]
|
|
731
|
+
- Updated dependencies [761a0ba]
|
|
732
|
+
- Updated dependencies [c960170]
|
|
733
|
+
- Updated dependencies [19365b7]
|
|
734
|
+
- Updated dependencies [ba98e26]
|
|
735
|
+
- Updated dependencies [b7ed26d]
|
|
736
|
+
- Updated dependencies [a2ebea2]
|
|
737
|
+
- Updated dependencies [800bdb0]
|
|
738
|
+
- Updated dependencies [9d4dfc4]
|
|
739
|
+
- Updated dependencies [1059965]
|
|
740
|
+
- Updated dependencies [def5919]
|
|
741
|
+
- Updated dependencies [60b672e]
|
|
742
|
+
- Updated dependencies [6b441a8]
|
|
743
|
+
- Updated dependencies [ce0cfe9]
|
|
744
|
+
- Updated dependencies [04f1182]
|
|
745
|
+
- Updated dependencies [be87153]
|
|
746
|
+
- Updated dependencies [dd0f681]
|
|
747
|
+
- Updated dependencies [60f0dd8]
|
|
748
|
+
- Updated dependencies [a87c5cd]
|
|
749
|
+
- Updated dependencies [a47f338]
|
|
750
|
+
- Updated dependencies [b3a3d83]
|
|
751
|
+
- Updated dependencies [7a55913]
|
|
752
|
+
- Updated dependencies [35accbf]
|
|
753
|
+
- Updated dependencies [6038de7]
|
|
754
|
+
- Updated dependencies [fc5f536]
|
|
755
|
+
- Updated dependencies [5647006]
|
|
756
|
+
- Updated dependencies [e654bfd]
|
|
757
|
+
- Updated dependencies [01a7337]
|
|
758
|
+
- Updated dependencies [b45c71e]
|
|
759
|
+
- Updated dependencies [f8cfbb4]
|
|
760
|
+
- Updated dependencies [6e6c872]
|
|
761
|
+
- Updated dependencies [2598216]
|
|
762
|
+
- Updated dependencies [11949fc]
|
|
763
|
+
- Updated dependencies [2c7e62d]
|
|
764
|
+
- Updated dependencies [eb95d97]
|
|
765
|
+
- Updated dependencies [b098b0e]
|
|
766
|
+
- Updated dependencies [4d00b13]
|
|
767
|
+
- Updated dependencies [1363084]
|
|
768
|
+
- Updated dependencies [fa5758e]
|
|
769
|
+
- Updated dependencies [38f7e4f]
|
|
770
|
+
- Updated dependencies [eb7613c]
|
|
771
|
+
- Updated dependencies [c57f3cf]
|
|
772
|
+
- Updated dependencies [ecc9110]
|
|
773
|
+
- Updated dependencies [e4c2dc8]
|
|
774
|
+
- Updated dependencies [97faca3]
|
|
775
|
+
- Updated dependencies [57bab76]
|
|
776
|
+
- Updated dependencies [c89d18c]
|
|
777
|
+
- Updated dependencies [1bd2795]
|
|
778
|
+
- Updated dependencies [f7bd4e2]
|
|
779
|
+
- Updated dependencies [361bd5b]
|
|
780
|
+
- Updated dependencies [aac90a5]
|
|
781
|
+
- Updated dependencies [3da3da5]
|
|
782
|
+
- Updated dependencies [1e6ab15]
|
|
783
|
+
- Updated dependencies [b90086a]
|
|
784
|
+
- Updated dependencies [8186a70]
|
|
785
|
+
- Updated dependencies [a329cca]
|
|
786
|
+
- Updated dependencies [c87ef70]
|
|
787
|
+
- Updated dependencies [3cb0618]
|
|
788
|
+
- Updated dependencies [32a0874]
|
|
789
|
+
- Updated dependencies [6eec18c]
|
|
790
|
+
- Updated dependencies [4d7bebf]
|
|
791
|
+
- Updated dependencies [821ac7a]
|
|
792
|
+
- Updated dependencies [8f81731]
|
|
793
|
+
- Updated dependencies [7055c22]
|
|
794
|
+
- Updated dependencies [785a748]
|
|
795
|
+
- Updated dependencies [3af0354]
|
|
796
|
+
- Updated dependencies [866ff16]
|
|
797
|
+
- Updated dependencies [5a85e67]
|
|
798
|
+
- Updated dependencies [8b50cb3]
|
|
799
|
+
- Updated dependencies [a0fdc56]
|
|
800
|
+
- Updated dependencies [b95577a]
|
|
801
|
+
- Updated dependencies [0dcbc11]
|
|
802
|
+
- Updated dependencies [d88f3e9]
|
|
803
|
+
- Updated dependencies [ad5fe25]
|
|
804
|
+
- Updated dependencies [c183a12]
|
|
805
|
+
- Updated dependencies [83c161f]
|
|
806
|
+
- Updated dependencies [d8c4957]
|
|
807
|
+
- Updated dependencies [b9f930b]
|
|
808
|
+
- Updated dependencies [f24cb83]
|
|
809
|
+
- Updated dependencies [5dbbb92]
|
|
810
|
+
- Updated dependencies [ea90179]
|
|
811
|
+
- Updated dependencies [1818998]
|
|
812
|
+
- Updated dependencies [ce92674]
|
|
813
|
+
- Updated dependencies [5ef0b5b]
|
|
814
|
+
- Updated dependencies [8c2db68]
|
|
815
|
+
- Updated dependencies [22b5e54]
|
|
816
|
+
- Updated dependencies [0166bd5]
|
|
817
|
+
- Updated dependencies [8064b07]
|
|
818
|
+
- Updated dependencies [09ee21c]
|
|
819
|
+
- Updated dependencies [4a56dbd]
|
|
820
|
+
- Updated dependencies [289d04a]
|
|
821
|
+
- Updated dependencies [f549a0d]
|
|
822
|
+
- Updated dependencies [48fbacb]
|
|
823
|
+
- Updated dependencies [06df4fa]
|
|
824
|
+
- Updated dependencies [3fc2e48]
|
|
825
|
+
- Updated dependencies [c9b809f]
|
|
826
|
+
- Updated dependencies [e8f435c]
|
|
827
|
+
- Updated dependencies [32386f8]
|
|
828
|
+
- Updated dependencies [9b702dc]
|
|
829
|
+
- Updated dependencies [ab16331]
|
|
830
|
+
- Updated dependencies [41610f6]
|
|
831
|
+
- Updated dependencies [69f1dfd]
|
|
832
|
+
- Updated dependencies [bbe05de]
|
|
833
|
+
- Updated dependencies [355e951]
|
|
834
|
+
- Updated dependencies [a1dd1e4]
|
|
835
|
+
- Updated dependencies [dadb43f]
|
|
836
|
+
- @objectstack/spec@17.0.0
|
|
837
|
+
- @objectstack/service-cluster@17.0.0
|
|
838
|
+
|
|
3
839
|
## 17.0.0-rc.6
|
|
4
840
|
|
|
5
841
|
### Patch Changes
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/zhuangjianguo/Documents/GitHub/objectstack/packages/services/service-cluster-redis/dist/index.cjs","../src/index.ts","../src/client.ts","../src/pubsub.ts","../src/lock.ts","../src/kv.ts","../src/counter.ts"],"names":[],"mappings":"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","file":"/Users/zhuangjianguo/Documents/GitHub/objectstack/packages/services/service-cluster-redis/dist/index.cjs","sourcesContent":[null,"// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * @objectstack/service-cluster-redis\n *\n * Redis driver for `@objectstack/service-cluster`. Import this package\n * once at process start to register the `'redis'` driver:\n *\n * ```ts\n * import '@objectstack/service-cluster-redis';\n * import { defineCluster } from '@objectstack/service-cluster';\n *\n * const cluster = defineCluster({\n * driver: 'redis',\n * url: 'redis://localhost:6379',\n * nodeId: 'web-1',\n * });\n * ```\n *\n * The driver also exports raw constructors so callers who already own\n * an ioredis client can compose primitives by hand.\n */\n\nimport type { Redis } from 'ioredis';\nimport {\n ComposedClusterService,\n registerClusterDriver,\n type DriverFactoryConfig,\n} from '@objectstack/service-cluster';\nimport { createRedisClient } from './client.js';\nimport { RedisPubSub } from './pubsub.js';\nimport { RedisLock } from './lock.js';\nimport { RedisKV } from './kv.js';\nimport { RedisCounter } from './counter.js';\n\n// Re-exports for advanced composition.\nexport { createRedisClient, duplicateForPubSub, type CreateRedisOptions } from './client.js';\nexport { RedisPubSub, type RedisPubSubOptions } from './pubsub.js';\nexport { RedisLock, type RedisLockOptions } from './lock.js';\nexport { RedisKV, VersionMismatchError, type RedisKVOptions } from './kv.js';\nexport { RedisCounter, type RedisCounterOptions } from './counter.js';\n\n/**\n * Driver-specific options accepted under `driverOptions` in\n * `ClusterCapabilityConfig`. All are optional — supply a `client` to\n * share a Redis pool with other services (e.g. `service-cache`).\n */\nexport interface RedisDriverOptions {\n /** Pre-built ioredis client. When provided, `url` is ignored. */\n client?: Redis;\n /** Key prefix applied to every Redis key (default: 'os:'). */\n keyPrefix?: string;\n /** Default lock TTL in ms. Overridden by `LockAcquireOptions.ttlMs`. */\n lockTtlMs?: number;\n /** Pub/sub subscriber error sink. */\n onError?: (err: unknown, channel: string) => void;\n}\n\n/**\n * Factory consumed by `defineCluster({ driver: 'redis' })`. Builds an\n * `IClusterService` backed by Redis. Owns the underlying ioredis client\n * iff it created it (i.e. when caller didn't pass `driverOptions.client`).\n */\nfunction redisDriverFactory(config: DriverFactoryConfig) {\n const driverOpts = (config.driverOptions ?? {}) as RedisDriverOptions;\n const ownsClient = !driverOpts.client;\n const client =\n driverOpts.client ??\n createRedisClient({ url: config.url });\n\n const keyPrefix = driverOpts.keyPrefix ?? 'os:';\n const ttlMs = config.lockTtlMs ?? driverOpts.lockTtlMs;\n\n const pubsub = new RedisPubSub({\n client,\n nodeId: config.nodeId,\n keyPrefix,\n onError: driverOpts.onError,\n });\n const lock = new RedisLock({\n client,\n keyPrefix,\n defaultTtlMs: ttlMs,\n nodeId: config.nodeId,\n });\n const kv = new RedisKV({ client, keyPrefix });\n const counter = new RedisCounter({ client, keyPrefix });\n\n const facade = new ComposedClusterService(\n config.nodeId,\n 'redis',\n pubsub,\n lock,\n kv,\n counter,\n );\n\n // Wrap close() so we also tear down the publisher client if we own it.\n const originalClose = facade.close.bind(facade);\n facade.close = async () => {\n await originalClose();\n if (ownsClient) {\n try { await client.quit(); } catch { /* swallow */ }\n }\n };\n\n return facade;\n}\n\n// Module-load registration — importing this package is enough.\nregisterClusterDriver('redis', redisDriverFactory);\n","// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { Redis, type RedisOptions } from 'ioredis';\n\n/**\n * Options accepted by {@link createRedisClient}.\n *\n * Either pass `url` (e.g. `redis://user:pass@host:6379/0`) or a full\n * ioredis `options` bag. The two are merged with `options` taking\n * precedence so callers can override individual fields parsed from the\n * URL.\n *\n * This factory is intended to be the single Redis-client construction\n * point across ObjectStack — `service-cluster-redis` uses it for the\n * driver, and `service-cache` will eventually share the same connection\n * pool via {@link CreateRedisOptions.existing}.\n */\nexport interface CreateRedisOptions {\n /** Connection URL. Ignored when `existing` is provided. */\n url?: string;\n /** Extra ioredis options merged on top of `url`. */\n options?: RedisOptions;\n /**\n * Bring-your-own client. When provided, this exact instance is\n * returned and `url`/`options` are ignored — useful for sharing one\n * pool across cluster + cache.\n */\n existing?: Redis;\n /**\n * If true, the returned client is created in lazyConnect mode so the\n * TCP connection happens on first command rather than at construction.\n * Default: true (matches ObjectStack's \"fail at usage, not boot\" stance).\n */\n lazyConnect?: boolean;\n}\n\n/**\n * Construct (or reuse) an ioredis client with ObjectStack defaults.\n *\n * Defaults applied when `existing` is absent:\n * - `lazyConnect: true` — don't crash boot if Redis is briefly down\n * - `maxRetriesPerRequest: 3` — bound the failure window before surfacing\n * - `enableAutoPipelining: true` — modest throughput boost for batch workloads\n *\n * @example\n * const client = createRedisClient({ url: 'redis://localhost:6379' });\n *\n * @example reuse one pool across services\n * const shared = createRedisClient({ url });\n * const clusterClient = createRedisClient({ existing: shared });\n * const cacheClient = createRedisClient({ existing: shared });\n */\nexport function createRedisClient(opts: CreateRedisOptions = {}): Redis {\n if (opts.existing) return opts.existing;\n\n const base: RedisOptions = {\n lazyConnect: opts.lazyConnect ?? true,\n maxRetriesPerRequest: 3,\n enableAutoPipelining: true,\n };\n\n if (opts.url) {\n return new Redis(opts.url, { ...base, ...opts.options });\n }\n return new Redis({ ...base, ...opts.options });\n}\n\n/**\n * Duplicate a Redis client so that pub/sub commands (which monopolize\n * the connection) don't block regular commands. Mirrors the standard\n * ioredis \"two clients\" pattern.\n */\nexport function duplicateForPubSub(client: Redis): Redis {\n return client.duplicate();\n}\n","// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Redis } from 'ioredis';\nimport type {\n IPubSub,\n PubSubHandler,\n PublishOptions,\n SubscribeOptions,\n Unsubscribe,\n} from '@objectstack/spec/contracts';\nimport { duplicateForPubSub } from './client.js';\n\n/**\n * Wire-format envelope sent over Redis. Adds `fromNode` and\n * `publishedAt` so subscribers see the same surface as the memory\n * driver. The user payload is nested under `p` to avoid colliding with\n * reserved keys.\n */\ninterface RedisPubSubEnvelope {\n n?: string;\n t: number;\n p: unknown;\n}\n\nexport interface RedisPubSubOptions {\n /** Already-connected client used for PUBLISH. */\n client: Redis;\n /** Optional node id surfaced as `fromNode` on every delivered message. */\n nodeId?: string;\n /** Key namespace prefix applied to every channel (default: 'os:'). */\n keyPrefix?: string;\n /** Error sink for subscriber handler exceptions. */\n onError?: (err: unknown, channel: string) => void;\n}\n\n/**\n * Redis pub/sub implementation of {@link IPubSub}.\n *\n * Uses two ioredis clients under the hood:\n * - `publisher` (caller-provided) — runs PUBLISH commands\n * - `subscriber` (auto-duplicated) — held in subscribe mode, can't run\n * regular commands per Redis protocol\n *\n * Delivery semantics match Redis pub/sub: at-most-once, fire-and-forget,\n * no persistence. For at-least-once + replay use the planned `streams`\n * adapter (separate driver).\n *\n * Channel names are prefixed with `keyPrefix` before being sent to\n * Redis, so the same Redis instance can host multiple isolated\n * ObjectStack deployments.\n */\nexport class RedisPubSub implements IPubSub {\n private readonly publisher: Redis;\n private readonly subscriber: Redis;\n private readonly nodeId?: string;\n private readonly keyPrefix: string;\n private readonly onError: (err: unknown, channel: string) => void;\n private readonly subs = new Map<string, Set<PubSubHandler<unknown>>>();\n private closed = false;\n\n constructor(opts: RedisPubSubOptions) {\n this.publisher = opts.client;\n this.subscriber = duplicateForPubSub(opts.client);\n this.nodeId = opts.nodeId;\n this.keyPrefix = opts.keyPrefix ?? 'os:';\n this.onError =\n opts.onError ??\n ((err, channel) => {\n // eslint-disable-next-line no-console\n console.error(`[RedisPubSub] handler error on \"${channel}\":`, err);\n });\n\n this.subscriber.on('message', (raw: string, data: string) => {\n this.dispatch(raw, data);\n });\n }\n\n /**\n * Durability contract (P1-5): this awaits the Redis `PUBLISH` command (so the\n * message left this node), but Redis pub/sub is **at-most-once** — there is no\n * delivery guarantee to subscribers and no replay for a node that was down or\n * slow at publish time. This is acceptable **only** for events that are pure\n * cache-invalidation hints, never the source of truth.\n *\n * In particular `metadata.changed` is such a hint: the durable record of every\n * metadata mutation is the transactional write to `sys_metadata`\n * (+ `sys_metadata_history`). A subscriber that misses the event keeps serving\n * its cached schema until its next reload and **loses no data** — it self-heals\n * on restart / reload against the DB. Do not route any state that must be\n * delivered exactly-once through this channel; use a durable outbox instead.\n */\n async publish<T = unknown>(\n channel: string,\n payload: T,\n _opts?: PublishOptions,\n ): Promise<void> {\n if (this.closed) throw new Error('RedisPubSub is closed');\n const envelope: RedisPubSubEnvelope = {\n n: this.nodeId,\n t: Date.now(),\n p: payload,\n };\n await this.publisher.publish(this.prefixed(channel), JSON.stringify(envelope));\n }\n\n subscribe<T = unknown>(\n channel: string,\n handler: PubSubHandler<T>,\n _opts?: SubscribeOptions,\n ): Unsubscribe {\n if (this.closed) throw new Error('RedisPubSub is closed');\n const prefixed = this.prefixed(channel);\n let bucket = this.subs.get(prefixed);\n if (!bucket) {\n bucket = new Set();\n this.subs.set(prefixed, bucket);\n // Fire-and-forget; if subscribe fails the next publish will\n // simply not deliver — caller can resubscribe.\n void this.subscriber.subscribe(prefixed).catch((err) => {\n this.onError(err, channel);\n });\n }\n const wrapped = handler as PubSubHandler<unknown>;\n bucket.add(wrapped);\n\n let disposed = false;\n return () => {\n if (disposed) return;\n disposed = true;\n const b = this.subs.get(prefixed);\n if (!b) return;\n b.delete(wrapped);\n if (b.size === 0) {\n this.subs.delete(prefixed);\n void this.subscriber.unsubscribe(prefixed).catch(() => { /* swallow */ });\n }\n };\n }\n\n async close(): Promise<void> {\n if (this.closed) return;\n this.closed = true;\n this.subs.clear();\n try { await this.subscriber.quit(); } catch { /* swallow */ }\n // We don't quit `publisher` — caller owns it.\n }\n\n private prefixed(channel: string): string {\n return `${this.keyPrefix}ps:${channel}`;\n }\n\n private dispatch(prefixedChannel: string, data: string): void {\n const bucket = this.subs.get(prefixedChannel);\n if (!bucket || bucket.size === 0) return;\n\n let envelope: RedisPubSubEnvelope;\n try {\n envelope = JSON.parse(data) as RedisPubSubEnvelope;\n } catch (err) {\n this.onError(err, prefixedChannel);\n return;\n }\n\n // Strip our keyPrefix so the handler sees the logical channel.\n const logical = prefixedChannel.startsWith(`${this.keyPrefix}ps:`)\n ? prefixedChannel.slice(`${this.keyPrefix}ps:`.length)\n : prefixedChannel;\n\n const snapshot = Array.from(bucket);\n for (const handler of snapshot) {\n try {\n const result = handler({\n channel: logical,\n payload: envelope.p,\n publishedAt: envelope.t,\n fromNode: envelope.n,\n });\n if (result && typeof (result as Promise<void>).then === 'function') {\n (result as Promise<void>).catch((err) =>\n this.onError(err, logical),\n );\n }\n } catch (err) {\n this.onError(err, logical);\n }\n }\n }\n}\n","// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Redis } from 'ioredis';\nimport type {\n ILock,\n LockAcquireOptions,\n LockHandle,\n} from '@objectstack/spec/contracts';\n\nconst DEFAULT_TTL_MS = 15_000;\nconst POLL_INTERVAL_MS = 50;\n\n/**\n * Lua script for safe release: only DEL when the value matches our\n * fencing token. Prevents a delayed release from kicking out the\n * legitimate next holder.\n */\nconst RELEASE_SCRIPT = `\nif redis.call(\"GET\", KEYS[1]) == ARGV[1] then\n return redis.call(\"DEL\", KEYS[1])\nelse\n return 0\nend\n`;\n\n/**\n * Lua script for renew: PEXPIRE only when we still hold the lock.\n * Returns 1 on success, 0 if the lock was lost.\n */\nconst RENEW_SCRIPT = `\nif redis.call(\"GET\", KEYS[1]) == ARGV[1] then\n return redis.call(\"PEXPIRE\", KEYS[1], ARGV[2])\nelse\n return 0\nend\n`;\n\nexport interface RedisLockOptions {\n client: Redis;\n /** Counter client for fencing-token allocation. Same Redis is fine. */\n counterClient?: Redis;\n keyPrefix?: string;\n defaultTtlMs?: number;\n /** Stable node id baked into lock values for debugging. */\n nodeId?: string;\n}\n\n/**\n * Redis-backed distributed lock with TTL fencing.\n *\n * Algorithm (single-instance Redis, NOT Redlock — adequate for\n * typical ObjectStack deployments with one Redis primary):\n *\n * acquire = SET key {nodeId}:{token} NX PX ttl\n * release = Lua: GET == expected ? DEL : 0\n * renew = Lua: GET == expected ? PEXPIRE : 0\n *\n * Fencing tokens come from a Redis counter (INCR on `{prefix}fence:{key}`)\n * so that two clients in a split-brain see strictly increasing tokens\n * downstream.\n *\n * For multi-master Redis (Sentinel failover, etc.) consider switching to\n * a Redlock variant — not implemented yet.\n */\nexport class RedisLock implements ILock {\n private readonly client: Redis;\n private readonly counterClient: Redis;\n private readonly keyPrefix: string;\n private readonly defaultTtlMs: number;\n private readonly nodeId: string;\n private closed = false;\n\n constructor(opts: RedisLockOptions) {\n this.client = opts.client;\n this.counterClient = opts.counterClient ?? opts.client;\n this.keyPrefix = opts.keyPrefix ?? 'os:';\n this.defaultTtlMs = opts.defaultTtlMs ?? DEFAULT_TTL_MS;\n this.nodeId = opts.nodeId ?? 'node';\n }\n\n async acquire(key: string, opts: LockAcquireOptions = {}): Promise<LockHandle | null> {\n if (this.closed) throw new Error('RedisLock is closed');\n const ttlMs = opts.ttlMs ?? this.defaultTtlMs;\n const waitMs = opts.waitMs ?? 0;\n const deadline = Date.now() + waitMs;\n const lockKey = this.lockKey(key);\n\n // Allocate a fresh fencing token up-front.\n const fencingToken = BigInt(\n await this.counterClient.incr(this.fenceKey(key)),\n );\n const value = `${this.nodeId}:${fencingToken}`;\n\n // First attempt — fast path.\n if (await this.trySet(lockKey, value, ttlMs)) {\n return this.makeHandle(key, lockKey, value, fencingToken, ttlMs);\n }\n if (waitMs <= 0) return null;\n\n // Polling loop: simple, correct, good enough for typical\n // contention. Future: pub/sub-driven wakeup on release.\n while (Date.now() < deadline) {\n await sleep(Math.min(POLL_INTERVAL_MS, Math.max(1, deadline - Date.now())));\n if (await this.trySet(lockKey, value, ttlMs)) {\n return this.makeHandle(key, lockKey, value, fencingToken, ttlMs);\n }\n }\n return null;\n }\n\n async withLock<T>(\n key: string,\n fn: (h: LockHandle) => Promise<T>,\n opts?: LockAcquireOptions,\n ): Promise<T | null> {\n const handle = await this.acquire(key, opts);\n if (!handle) return null;\n try {\n return await fn(handle);\n } finally {\n await handle.release();\n }\n }\n\n async close(): Promise<void> {\n this.closed = true;\n }\n\n private async trySet(lockKey: string, value: string, ttlMs: number): Promise<boolean> {\n // SET key value NX PX ttlMs — atomic acquire.\n const res = await this.client.set(lockKey, value, 'PX', ttlMs, 'NX');\n return res === 'OK';\n }\n\n private makeHandle(\n logicalKey: string,\n lockKey: string,\n value: string,\n fencingToken: bigint,\n ttlMs: number,\n ): LockHandle {\n const self = this;\n let released = false;\n let currentTtl = ttlMs;\n // Local expiry timer — mirrors memory driver so `isHeld()` flips\n // on TTL without a Redis roundtrip. Not authoritative (clocks may\n // drift), but matches contract test expectations.\n let timer: NodeJS.Timeout | undefined = setTimeout(() => {\n released = true;\n }, ttlMs);\n\n return {\n key: logicalKey,\n fencingToken,\n isHeld(): boolean {\n return !released;\n },\n async renew(extendMs?: number): Promise<void> {\n if (released) {\n throw new Error(`Lock \"${logicalKey}\" already released`);\n }\n const next = extendMs ?? currentTtl;\n const result = await self.client.eval(\n RENEW_SCRIPT,\n 1,\n lockKey,\n value,\n String(next),\n );\n if (result !== 1) {\n released = true;\n if (timer) { clearTimeout(timer); timer = undefined; }\n throw new Error(\n `Lock \"${logicalKey}\" no longer held (fence=${fencingToken})`,\n );\n }\n currentTtl = next;\n if (timer) clearTimeout(timer);\n timer = setTimeout(() => { released = true; }, next);\n },\n async release(): Promise<void> {\n if (released) return;\n released = true;\n if (timer) { clearTimeout(timer); timer = undefined; }\n try {\n await self.client.eval(RELEASE_SCRIPT, 1, lockKey, value);\n } catch {\n /* swallow — release is best-effort */\n }\n },\n };\n }\n\n private lockKey(key: string): string {\n return `${this.keyPrefix}lock:${key}`;\n }\n\n private fenceKey(key: string): string {\n return `${this.keyPrefix}fence:${key}`;\n }\n}\n\nfunction sleep(ms: number): Promise<void> {\n return new Promise((r) => setTimeout(r, ms));\n}\n","// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Redis } from 'ioredis';\nimport type { IKV, KVEntry, KVSetOptions } from '@objectstack/spec/contracts';\n\n/**\n * Stored payload shape: `{v: <value>, ver: <bigint as string>}`.\n * Versions are stored as strings because Redis values are bytes and\n * bigints can exceed JSON-safe-integer range.\n */\ninterface StoredKV {\n v: unknown;\n ver: string;\n}\n\nexport class VersionMismatchError extends Error {\n constructor(\n public readonly key: string,\n public readonly expected: bigint,\n public readonly actual: bigint,\n ) {\n super(\n `KV version mismatch on \"${key}\": expected v${expected}, found v${actual}`,\n );\n this.name = 'VersionMismatchError';\n }\n}\n\nexport interface RedisKVOptions {\n client: Redis;\n keyPrefix?: string;\n}\n\n/**\n * Redis-backed coordination KV with optimistic concurrency via WATCH/MULTI.\n *\n * Each `set()` performs:\n * 1. WATCH key\n * 2. GET key → read current version\n * 3. compare to ifVersion (if provided)\n * 4. MULTI / SET / [PEXPIRE] / EXEC\n *\n * If a competing writer modifies the key between WATCH and EXEC the\n * transaction aborts and we throw `VersionMismatchError`, matching\n * memory driver semantics.\n *\n * **Not** a cache — uses small JSON envelopes and per-key versioning.\n * Use service-cache for high-throughput caching.\n */\nexport class RedisKV implements IKV {\n private readonly client: Redis;\n private readonly keyPrefix: string;\n private closed = false;\n\n constructor(opts: RedisKVOptions) {\n this.client = opts.client;\n this.keyPrefix = opts.keyPrefix ?? 'os:';\n }\n\n async get<T = unknown>(key: string): Promise<KVEntry<T> | undefined> {\n const raw = await this.client.get(this.kvKey(key));\n if (raw === null) return undefined;\n const parsed = this.parse(raw);\n if (!parsed) return undefined;\n const pttl = await this.client.pttl(this.kvKey(key));\n const expiresAt = pttl > 0 ? Date.now() + pttl : undefined;\n return {\n key,\n value: parsed.v as T,\n version: BigInt(parsed.ver),\n expiresAt,\n };\n }\n\n async set<T = unknown>(\n key: string,\n value: T,\n opts: KVSetOptions = {},\n ): Promise<KVEntry<T>> {\n if (this.closed) throw new Error('RedisKV is closed');\n const physical = this.kvKey(key);\n const ttlMs = opts.ttl && opts.ttl > 0 ? opts.ttl * 1000 : undefined;\n\n // Optimistic-concurrency loop — Redis WATCH aborts the MULTI on\n // any intervening write.\n // eslint-disable-next-line no-constant-condition\n while (true) {\n await this.client.watch(physical);\n const raw = await this.client.get(physical);\n const existing = raw ? this.parse(raw) : undefined;\n const existingVersion = existing ? BigInt(existing.ver) : 0n;\n\n if (opts.ifVersion !== undefined && opts.ifVersion !== existingVersion) {\n await this.client.unwatch();\n throw new VersionMismatchError(key, opts.ifVersion, existingVersion);\n }\n\n const newVersion = existingVersion + 1n;\n const payload: StoredKV = { v: value, ver: newVersion.toString() };\n const encoded = JSON.stringify(payload);\n\n const multi = this.client.multi();\n if (ttlMs) {\n multi.set(physical, encoded, 'PX', ttlMs);\n } else {\n multi.set(physical, encoded);\n }\n const result = await multi.exec();\n // exec() returns null when WATCH detected a concurrent change.\n if (result === null) continue;\n\n return {\n key,\n value,\n version: newVersion,\n expiresAt: ttlMs ? Date.now() + ttlMs : undefined,\n };\n }\n }\n\n async delete(key: string, opts: { ifVersion?: bigint } = {}): Promise<boolean> {\n if (this.closed) throw new Error('RedisKV is closed');\n const physical = this.kvKey(key);\n\n if (opts.ifVersion === undefined) {\n const removed = await this.client.del(physical);\n return removed > 0;\n }\n\n // eslint-disable-next-line no-constant-condition\n while (true) {\n await this.client.watch(physical);\n const raw = await this.client.get(physical);\n if (!raw) {\n await this.client.unwatch();\n return false;\n }\n const parsed = this.parse(raw);\n if (!parsed) {\n await this.client.unwatch();\n return false;\n }\n const currentVersion = BigInt(parsed.ver);\n if (opts.ifVersion !== currentVersion) {\n await this.client.unwatch();\n throw new VersionMismatchError(key, opts.ifVersion, currentVersion);\n }\n const multi = this.client.multi();\n multi.del(physical);\n const result = await multi.exec();\n if (result === null) continue;\n return (result[0]?.[1] as number) > 0;\n }\n }\n\n async cas<T = unknown>(\n key: string,\n expectedVersion: bigint,\n next: T,\n opts: Omit<KVSetOptions, 'ifVersion'> = {},\n ): Promise<KVEntry<T> | undefined> {\n try {\n return await this.set(key, next, { ...opts, ifVersion: expectedVersion });\n } catch (err) {\n if (err instanceof VersionMismatchError) return undefined;\n throw err;\n }\n }\n\n async close(): Promise<void> {\n this.closed = true;\n }\n\n private kvKey(key: string): string {\n return `${this.keyPrefix}kv:${key}`;\n }\n\n private parse(raw: string): StoredKV | undefined {\n try {\n const obj = JSON.parse(raw) as StoredKV;\n if (typeof obj.ver !== 'string') return undefined;\n return obj;\n } catch {\n return undefined;\n }\n }\n}\n","// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Redis } from 'ioredis';\nimport type { ICounter, CounterIncrOptions } from '@objectstack/spec/contracts';\n\nexport interface RedisCounterOptions {\n client: Redis;\n keyPrefix?: string;\n}\n\n/**\n * Redis-backed monotonic counter using INCRBY. Each counter key lives at\n * `{prefix}ctr:{key}` so the same Redis instance can host multiple\n * tenants without collision.\n *\n * Values are stored as ASCII decimals (Redis convention). We surface\n * them as `bigint` to match the contract — INCRBY accepts up to a\n * signed 64-bit range, well beyond Number.MAX_SAFE_INTEGER.\n */\nexport class RedisCounter implements ICounter {\n private readonly client: Redis;\n private readonly keyPrefix: string;\n private closed = false;\n\n constructor(opts: RedisCounterOptions) {\n this.client = opts.client;\n this.keyPrefix = opts.keyPrefix ?? 'os:';\n }\n\n async incr(key: string, opts: CounterIncrOptions = {}): Promise<bigint> {\n if (this.closed) throw new Error('RedisCounter is closed');\n const by = opts.by ?? 1;\n const next = await this.client.incrby(this.ctrKey(key), by);\n return BigInt(next);\n }\n\n async peek(key: string): Promise<bigint> {\n const raw = await this.client.get(this.ctrKey(key));\n if (raw === null) return 0n;\n try {\n return BigInt(raw);\n } catch {\n return 0n;\n }\n }\n\n async reset(key: string, value: bigint = 0n): Promise<void> {\n if (this.closed) throw new Error('RedisCounter is closed');\n if (value === 0n) {\n await this.client.del(this.ctrKey(key));\n return;\n }\n await this.client.set(this.ctrKey(key), value.toString());\n }\n\n async close(): Promise<void> {\n this.closed = true;\n }\n\n private ctrKey(key: string): string {\n return `${this.keyPrefix}ctr:${key}`;\n }\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["/home/runner/work/objectstack/objectstack/packages/services/service-cluster-redis/dist/index.cjs","../src/index.ts","../src/client.ts","../src/pubsub.ts","../src/lock.ts","../src/kv.ts","../src/counter.ts"],"names":[],"mappings":"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","file":"/home/runner/work/objectstack/objectstack/packages/services/service-cluster-redis/dist/index.cjs","sourcesContent":[null,"// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * @objectstack/service-cluster-redis\n *\n * Redis driver for `@objectstack/service-cluster`. Import this package\n * once at process start to register the `'redis'` driver:\n *\n * ```ts\n * import '@objectstack/service-cluster-redis';\n * import { defineCluster } from '@objectstack/service-cluster';\n *\n * const cluster = defineCluster({\n * driver: 'redis',\n * url: 'redis://localhost:6379',\n * nodeId: 'web-1',\n * });\n * ```\n *\n * The driver also exports raw constructors so callers who already own\n * an ioredis client can compose primitives by hand.\n */\n\nimport type { Redis } from 'ioredis';\nimport {\n ComposedClusterService,\n registerClusterDriver,\n type DriverFactoryConfig,\n} from '@objectstack/service-cluster';\nimport { createRedisClient } from './client.js';\nimport { RedisPubSub } from './pubsub.js';\nimport { RedisLock } from './lock.js';\nimport { RedisKV } from './kv.js';\nimport { RedisCounter } from './counter.js';\n\n// Re-exports for advanced composition.\nexport { createRedisClient, duplicateForPubSub, type CreateRedisOptions } from './client.js';\nexport { RedisPubSub, type RedisPubSubOptions } from './pubsub.js';\nexport { RedisLock, type RedisLockOptions } from './lock.js';\nexport { RedisKV, VersionMismatchError, type RedisKVOptions } from './kv.js';\nexport { RedisCounter, type RedisCounterOptions } from './counter.js';\n\n/**\n * Driver-specific options accepted under `driverOptions` in\n * `ClusterCapabilityConfig`. All are optional — supply a `client` to\n * share a Redis pool with other services (e.g. `service-cache`).\n */\nexport interface RedisDriverOptions {\n /** Pre-built ioredis client. When provided, `url` is ignored. */\n client?: Redis;\n /** Key prefix applied to every Redis key (default: 'os:'). */\n keyPrefix?: string;\n /** Default lock TTL in ms. Overridden by `LockAcquireOptions.ttlMs`. */\n lockTtlMs?: number;\n /** Pub/sub subscriber error sink. */\n onError?: (err: unknown, channel: string) => void;\n}\n\n/**\n * Factory consumed by `defineCluster({ driver: 'redis' })`. Builds an\n * `IClusterService` backed by Redis. Owns the underlying ioredis client\n * iff it created it (i.e. when caller didn't pass `driverOptions.client`).\n */\nfunction redisDriverFactory(config: DriverFactoryConfig) {\n const driverOpts = (config.driverOptions ?? {}) as RedisDriverOptions;\n const ownsClient = !driverOpts.client;\n const client =\n driverOpts.client ??\n createRedisClient({ url: config.url });\n\n const keyPrefix = driverOpts.keyPrefix ?? 'os:';\n const ttlMs = config.lockTtlMs ?? driverOpts.lockTtlMs;\n\n const pubsub = new RedisPubSub({\n client,\n nodeId: config.nodeId,\n keyPrefix,\n onError: driverOpts.onError,\n });\n const lock = new RedisLock({\n client,\n keyPrefix,\n defaultTtlMs: ttlMs,\n nodeId: config.nodeId,\n });\n const kv = new RedisKV({ client, keyPrefix });\n const counter = new RedisCounter({ client, keyPrefix });\n\n const facade = new ComposedClusterService(\n config.nodeId,\n 'redis',\n pubsub,\n lock,\n kv,\n counter,\n );\n\n // Wrap close() so we also tear down the publisher client if we own it.\n const originalClose = facade.close.bind(facade);\n facade.close = async () => {\n await originalClose();\n if (ownsClient) {\n try { await client.quit(); } catch { /* swallow */ }\n }\n };\n\n return facade;\n}\n\n// Module-load registration — importing this package is enough.\nregisterClusterDriver('redis', redisDriverFactory);\n","// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { Redis, type RedisOptions } from 'ioredis';\n\n/**\n * Options accepted by {@link createRedisClient}.\n *\n * Either pass `url` (e.g. `redis://user:pass@host:6379/0`) or a full\n * ioredis `options` bag. The two are merged with `options` taking\n * precedence so callers can override individual fields parsed from the\n * URL.\n *\n * This factory is intended to be the single Redis-client construction\n * point across ObjectStack — `service-cluster-redis` uses it for the\n * driver, and `service-cache` will eventually share the same connection\n * pool via {@link CreateRedisOptions.existing}.\n */\nexport interface CreateRedisOptions {\n /** Connection URL. Ignored when `existing` is provided. */\n url?: string;\n /** Extra ioredis options merged on top of `url`. */\n options?: RedisOptions;\n /**\n * Bring-your-own client. When provided, this exact instance is\n * returned and `url`/`options` are ignored — useful for sharing one\n * pool across cluster + cache.\n */\n existing?: Redis;\n /**\n * If true, the returned client is created in lazyConnect mode so the\n * TCP connection happens on first command rather than at construction.\n * Default: true (matches ObjectStack's \"fail at usage, not boot\" stance).\n */\n lazyConnect?: boolean;\n}\n\n/**\n * Construct (or reuse) an ioredis client with ObjectStack defaults.\n *\n * Defaults applied when `existing` is absent:\n * - `lazyConnect: true` — don't crash boot if Redis is briefly down\n * - `maxRetriesPerRequest: 3` — bound the failure window before surfacing\n * - `enableAutoPipelining: true` — modest throughput boost for batch workloads\n *\n * @example\n * const client = createRedisClient({ url: 'redis://localhost:6379' });\n *\n * @example reuse one pool across services\n * const shared = createRedisClient({ url });\n * const clusterClient = createRedisClient({ existing: shared });\n * const cacheClient = createRedisClient({ existing: shared });\n */\nexport function createRedisClient(opts: CreateRedisOptions = {}): Redis {\n if (opts.existing) return opts.existing;\n\n const base: RedisOptions = {\n lazyConnect: opts.lazyConnect ?? true,\n maxRetriesPerRequest: 3,\n enableAutoPipelining: true,\n };\n\n if (opts.url) {\n return new Redis(opts.url, { ...base, ...opts.options });\n }\n return new Redis({ ...base, ...opts.options });\n}\n\n/**\n * Duplicate a Redis client so that pub/sub commands (which monopolize\n * the connection) don't block regular commands. Mirrors the standard\n * ioredis \"two clients\" pattern.\n */\nexport function duplicateForPubSub(client: Redis): Redis {\n return client.duplicate();\n}\n","// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Redis } from 'ioredis';\nimport type {\n IPubSub,\n PubSubHandler,\n PublishOptions,\n SubscribeOptions,\n Unsubscribe,\n} from '@objectstack/spec/contracts';\nimport { duplicateForPubSub } from './client.js';\n\n/**\n * Wire-format envelope sent over Redis. Adds `fromNode` and\n * `publishedAt` so subscribers see the same surface as the memory\n * driver. The user payload is nested under `p` to avoid colliding with\n * reserved keys.\n */\ninterface RedisPubSubEnvelope {\n n?: string;\n t: number;\n p: unknown;\n}\n\nexport interface RedisPubSubOptions {\n /** Already-connected client used for PUBLISH. */\n client: Redis;\n /** Optional node id surfaced as `fromNode` on every delivered message. */\n nodeId?: string;\n /** Key namespace prefix applied to every channel (default: 'os:'). */\n keyPrefix?: string;\n /** Error sink for subscriber handler exceptions. */\n onError?: (err: unknown, channel: string) => void;\n}\n\n/**\n * Redis pub/sub implementation of {@link IPubSub}.\n *\n * Uses two ioredis clients under the hood:\n * - `publisher` (caller-provided) — runs PUBLISH commands\n * - `subscriber` (auto-duplicated) — held in subscribe mode, can't run\n * regular commands per Redis protocol\n *\n * Delivery semantics match Redis pub/sub: at-most-once, fire-and-forget,\n * no persistence. For at-least-once + replay use the planned `streams`\n * adapter (separate driver).\n *\n * Channel names are prefixed with `keyPrefix` before being sent to\n * Redis, so the same Redis instance can host multiple isolated\n * ObjectStack deployments.\n */\nexport class RedisPubSub implements IPubSub {\n private readonly publisher: Redis;\n private readonly subscriber: Redis;\n private readonly nodeId?: string;\n private readonly keyPrefix: string;\n private readonly onError: (err: unknown, channel: string) => void;\n private readonly subs = new Map<string, Set<PubSubHandler<unknown>>>();\n private closed = false;\n\n constructor(opts: RedisPubSubOptions) {\n this.publisher = opts.client;\n this.subscriber = duplicateForPubSub(opts.client);\n this.nodeId = opts.nodeId;\n this.keyPrefix = opts.keyPrefix ?? 'os:';\n this.onError =\n opts.onError ??\n ((err, channel) => {\n // eslint-disable-next-line no-console\n console.error(`[RedisPubSub] handler error on \"${channel}\":`, err);\n });\n\n this.subscriber.on('message', (raw: string, data: string) => {\n this.dispatch(raw, data);\n });\n }\n\n /**\n * Durability contract (P1-5): this awaits the Redis `PUBLISH` command (so the\n * message left this node), but Redis pub/sub is **at-most-once** — there is no\n * delivery guarantee to subscribers and no replay for a node that was down or\n * slow at publish time. This is acceptable **only** for events that are pure\n * cache-invalidation hints, never the source of truth.\n *\n * In particular `metadata.changed` is such a hint: the durable record of every\n * metadata mutation is the transactional write to `sys_metadata`\n * (+ `sys_metadata_history`). A subscriber that misses the event keeps serving\n * its cached schema until its next reload and **loses no data** — it self-heals\n * on restart / reload against the DB. Do not route any state that must be\n * delivered exactly-once through this channel; use a durable outbox instead.\n */\n async publish<T = unknown>(\n channel: string,\n payload: T,\n _opts?: PublishOptions,\n ): Promise<void> {\n if (this.closed) throw new Error('RedisPubSub is closed');\n const envelope: RedisPubSubEnvelope = {\n n: this.nodeId,\n t: Date.now(),\n p: payload,\n };\n await this.publisher.publish(this.prefixed(channel), JSON.stringify(envelope));\n }\n\n subscribe<T = unknown>(\n channel: string,\n handler: PubSubHandler<T>,\n _opts?: SubscribeOptions,\n ): Unsubscribe {\n if (this.closed) throw new Error('RedisPubSub is closed');\n const prefixed = this.prefixed(channel);\n let bucket = this.subs.get(prefixed);\n if (!bucket) {\n bucket = new Set();\n this.subs.set(prefixed, bucket);\n // Fire-and-forget; if subscribe fails the next publish will\n // simply not deliver — caller can resubscribe.\n void this.subscriber.subscribe(prefixed).catch((err) => {\n this.onError(err, channel);\n });\n }\n const wrapped = handler as PubSubHandler<unknown>;\n bucket.add(wrapped);\n\n let disposed = false;\n return () => {\n if (disposed) return;\n disposed = true;\n const b = this.subs.get(prefixed);\n if (!b) return;\n b.delete(wrapped);\n if (b.size === 0) {\n this.subs.delete(prefixed);\n void this.subscriber.unsubscribe(prefixed).catch(() => { /* swallow */ });\n }\n };\n }\n\n async close(): Promise<void> {\n if (this.closed) return;\n this.closed = true;\n this.subs.clear();\n try { await this.subscriber.quit(); } catch { /* swallow */ }\n // We don't quit `publisher` — caller owns it.\n }\n\n private prefixed(channel: string): string {\n return `${this.keyPrefix}ps:${channel}`;\n }\n\n private dispatch(prefixedChannel: string, data: string): void {\n const bucket = this.subs.get(prefixedChannel);\n if (!bucket || bucket.size === 0) return;\n\n let envelope: RedisPubSubEnvelope;\n try {\n envelope = JSON.parse(data) as RedisPubSubEnvelope;\n } catch (err) {\n this.onError(err, prefixedChannel);\n return;\n }\n\n // Strip our keyPrefix so the handler sees the logical channel.\n const logical = prefixedChannel.startsWith(`${this.keyPrefix}ps:`)\n ? prefixedChannel.slice(`${this.keyPrefix}ps:`.length)\n : prefixedChannel;\n\n const snapshot = Array.from(bucket);\n for (const handler of snapshot) {\n try {\n const result = handler({\n channel: logical,\n payload: envelope.p,\n publishedAt: envelope.t,\n fromNode: envelope.n,\n });\n if (result && typeof (result as Promise<void>).then === 'function') {\n (result as Promise<void>).catch((err) =>\n this.onError(err, logical),\n );\n }\n } catch (err) {\n this.onError(err, logical);\n }\n }\n }\n}\n","// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Redis } from 'ioredis';\nimport type {\n ILock,\n LockAcquireOptions,\n LockHandle,\n} from '@objectstack/spec/contracts';\n\nconst DEFAULT_TTL_MS = 15_000;\nconst POLL_INTERVAL_MS = 50;\n\n/**\n * Lua script for safe release: only DEL when the value matches our\n * fencing token. Prevents a delayed release from kicking out the\n * legitimate next holder.\n */\nconst RELEASE_SCRIPT = `\nif redis.call(\"GET\", KEYS[1]) == ARGV[1] then\n return redis.call(\"DEL\", KEYS[1])\nelse\n return 0\nend\n`;\n\n/**\n * Lua script for renew: PEXPIRE only when we still hold the lock.\n * Returns 1 on success, 0 if the lock was lost.\n */\nconst RENEW_SCRIPT = `\nif redis.call(\"GET\", KEYS[1]) == ARGV[1] then\n return redis.call(\"PEXPIRE\", KEYS[1], ARGV[2])\nelse\n return 0\nend\n`;\n\nexport interface RedisLockOptions {\n client: Redis;\n /** Counter client for fencing-token allocation. Same Redis is fine. */\n counterClient?: Redis;\n keyPrefix?: string;\n defaultTtlMs?: number;\n /** Stable node id baked into lock values for debugging. */\n nodeId?: string;\n}\n\n/**\n * Redis-backed distributed lock with TTL fencing.\n *\n * Algorithm (single-instance Redis, NOT Redlock — adequate for\n * typical ObjectStack deployments with one Redis primary):\n *\n * acquire = SET key {nodeId}:{token} NX PX ttl\n * release = Lua: GET == expected ? DEL : 0\n * renew = Lua: GET == expected ? PEXPIRE : 0\n *\n * Fencing tokens come from a Redis counter (INCR on `{prefix}fence:{key}`)\n * so that two clients in a split-brain see strictly increasing tokens\n * downstream.\n *\n * For multi-master Redis (Sentinel failover, etc.) consider switching to\n * a Redlock variant — not implemented yet.\n */\nexport class RedisLock implements ILock {\n private readonly client: Redis;\n private readonly counterClient: Redis;\n private readonly keyPrefix: string;\n private readonly defaultTtlMs: number;\n private readonly nodeId: string;\n private closed = false;\n\n constructor(opts: RedisLockOptions) {\n this.client = opts.client;\n this.counterClient = opts.counterClient ?? opts.client;\n this.keyPrefix = opts.keyPrefix ?? 'os:';\n this.defaultTtlMs = opts.defaultTtlMs ?? DEFAULT_TTL_MS;\n this.nodeId = opts.nodeId ?? 'node';\n }\n\n async acquire(key: string, opts: LockAcquireOptions = {}): Promise<LockHandle | null> {\n if (this.closed) throw new Error('RedisLock is closed');\n const ttlMs = opts.ttlMs ?? this.defaultTtlMs;\n const waitMs = opts.waitMs ?? 0;\n const deadline = Date.now() + waitMs;\n const lockKey = this.lockKey(key);\n\n // Allocate a fresh fencing token up-front.\n const fencingToken = BigInt(\n await this.counterClient.incr(this.fenceKey(key)),\n );\n const value = `${this.nodeId}:${fencingToken}`;\n\n // First attempt — fast path.\n if (await this.trySet(lockKey, value, ttlMs)) {\n return this.makeHandle(key, lockKey, value, fencingToken, ttlMs);\n }\n if (waitMs <= 0) return null;\n\n // Polling loop: simple, correct, good enough for typical\n // contention. Future: pub/sub-driven wakeup on release.\n while (Date.now() < deadline) {\n await sleep(Math.min(POLL_INTERVAL_MS, Math.max(1, deadline - Date.now())));\n if (await this.trySet(lockKey, value, ttlMs)) {\n return this.makeHandle(key, lockKey, value, fencingToken, ttlMs);\n }\n }\n return null;\n }\n\n async withLock<T>(\n key: string,\n fn: (h: LockHandle) => Promise<T>,\n opts?: LockAcquireOptions,\n ): Promise<T | null> {\n const handle = await this.acquire(key, opts);\n if (!handle) return null;\n try {\n return await fn(handle);\n } finally {\n await handle.release();\n }\n }\n\n async close(): Promise<void> {\n this.closed = true;\n }\n\n private async trySet(lockKey: string, value: string, ttlMs: number): Promise<boolean> {\n // SET key value NX PX ttlMs — atomic acquire.\n const res = await this.client.set(lockKey, value, 'PX', ttlMs, 'NX');\n return res === 'OK';\n }\n\n private makeHandle(\n logicalKey: string,\n lockKey: string,\n value: string,\n fencingToken: bigint,\n ttlMs: number,\n ): LockHandle {\n const self = this;\n let released = false;\n let currentTtl = ttlMs;\n // Local expiry timer — mirrors memory driver so `isHeld()` flips\n // on TTL without a Redis roundtrip. Not authoritative (clocks may\n // drift), but matches contract test expectations.\n let timer: NodeJS.Timeout | undefined = setTimeout(() => {\n released = true;\n }, ttlMs);\n\n return {\n key: logicalKey,\n fencingToken,\n isHeld(): boolean {\n return !released;\n },\n async renew(extendMs?: number): Promise<void> {\n if (released) {\n throw new Error(`Lock \"${logicalKey}\" already released`);\n }\n const next = extendMs ?? currentTtl;\n const result = await self.client.eval(\n RENEW_SCRIPT,\n 1,\n lockKey,\n value,\n String(next),\n );\n if (result !== 1) {\n released = true;\n if (timer) { clearTimeout(timer); timer = undefined; }\n throw new Error(\n `Lock \"${logicalKey}\" no longer held (fence=${fencingToken})`,\n );\n }\n currentTtl = next;\n if (timer) clearTimeout(timer);\n timer = setTimeout(() => { released = true; }, next);\n },\n async release(): Promise<void> {\n if (released) return;\n released = true;\n if (timer) { clearTimeout(timer); timer = undefined; }\n try {\n await self.client.eval(RELEASE_SCRIPT, 1, lockKey, value);\n } catch {\n /* swallow — release is best-effort */\n }\n },\n };\n }\n\n private lockKey(key: string): string {\n return `${this.keyPrefix}lock:${key}`;\n }\n\n private fenceKey(key: string): string {\n return `${this.keyPrefix}fence:${key}`;\n }\n}\n\nfunction sleep(ms: number): Promise<void> {\n return new Promise((r) => setTimeout(r, ms));\n}\n","// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Redis } from 'ioredis';\nimport type { IKV, KVEntry, KVSetOptions } from '@objectstack/spec/contracts';\n\n/**\n * Stored payload shape: `{v: <value>, ver: <bigint as string>}`.\n * Versions are stored as strings because Redis values are bytes and\n * bigints can exceed JSON-safe-integer range.\n */\ninterface StoredKV {\n v: unknown;\n ver: string;\n}\n\nexport class VersionMismatchError extends Error {\n constructor(\n public readonly key: string,\n public readonly expected: bigint,\n public readonly actual: bigint,\n ) {\n super(\n `KV version mismatch on \"${key}\": expected v${expected}, found v${actual}`,\n );\n this.name = 'VersionMismatchError';\n }\n}\n\nexport interface RedisKVOptions {\n client: Redis;\n keyPrefix?: string;\n}\n\n/**\n * Redis-backed coordination KV with optimistic concurrency via WATCH/MULTI.\n *\n * Each `set()` performs:\n * 1. WATCH key\n * 2. GET key → read current version\n * 3. compare to ifVersion (if provided)\n * 4. MULTI / SET / [PEXPIRE] / EXEC\n *\n * If a competing writer modifies the key between WATCH and EXEC the\n * transaction aborts and we throw `VersionMismatchError`, matching\n * memory driver semantics.\n *\n * **Not** a cache — uses small JSON envelopes and per-key versioning.\n * Use service-cache for high-throughput caching.\n */\nexport class RedisKV implements IKV {\n private readonly client: Redis;\n private readonly keyPrefix: string;\n private closed = false;\n\n constructor(opts: RedisKVOptions) {\n this.client = opts.client;\n this.keyPrefix = opts.keyPrefix ?? 'os:';\n }\n\n async get<T = unknown>(key: string): Promise<KVEntry<T> | undefined> {\n const raw = await this.client.get(this.kvKey(key));\n if (raw === null) return undefined;\n const parsed = this.parse(raw);\n if (!parsed) return undefined;\n const pttl = await this.client.pttl(this.kvKey(key));\n const expiresAt = pttl > 0 ? Date.now() + pttl : undefined;\n return {\n key,\n value: parsed.v as T,\n version: BigInt(parsed.ver),\n expiresAt,\n };\n }\n\n async set<T = unknown>(\n key: string,\n value: T,\n opts: KVSetOptions = {},\n ): Promise<KVEntry<T>> {\n if (this.closed) throw new Error('RedisKV is closed');\n const physical = this.kvKey(key);\n const ttlMs = opts.ttl && opts.ttl > 0 ? opts.ttl * 1000 : undefined;\n\n // Optimistic-concurrency loop — Redis WATCH aborts the MULTI on\n // any intervening write.\n // eslint-disable-next-line no-constant-condition\n while (true) {\n await this.client.watch(physical);\n const raw = await this.client.get(physical);\n const existing = raw ? this.parse(raw) : undefined;\n const existingVersion = existing ? BigInt(existing.ver) : 0n;\n\n if (opts.ifVersion !== undefined && opts.ifVersion !== existingVersion) {\n await this.client.unwatch();\n throw new VersionMismatchError(key, opts.ifVersion, existingVersion);\n }\n\n const newVersion = existingVersion + 1n;\n const payload: StoredKV = { v: value, ver: newVersion.toString() };\n const encoded = JSON.stringify(payload);\n\n const multi = this.client.multi();\n if (ttlMs) {\n multi.set(physical, encoded, 'PX', ttlMs);\n } else {\n multi.set(physical, encoded);\n }\n const result = await multi.exec();\n // exec() returns null when WATCH detected a concurrent change.\n if (result === null) continue;\n\n return {\n key,\n value,\n version: newVersion,\n expiresAt: ttlMs ? Date.now() + ttlMs : undefined,\n };\n }\n }\n\n async delete(key: string, opts: { ifVersion?: bigint } = {}): Promise<boolean> {\n if (this.closed) throw new Error('RedisKV is closed');\n const physical = this.kvKey(key);\n\n if (opts.ifVersion === undefined) {\n const removed = await this.client.del(physical);\n return removed > 0;\n }\n\n // eslint-disable-next-line no-constant-condition\n while (true) {\n await this.client.watch(physical);\n const raw = await this.client.get(physical);\n if (!raw) {\n await this.client.unwatch();\n return false;\n }\n const parsed = this.parse(raw);\n if (!parsed) {\n await this.client.unwatch();\n return false;\n }\n const currentVersion = BigInt(parsed.ver);\n if (opts.ifVersion !== currentVersion) {\n await this.client.unwatch();\n throw new VersionMismatchError(key, opts.ifVersion, currentVersion);\n }\n const multi = this.client.multi();\n multi.del(physical);\n const result = await multi.exec();\n if (result === null) continue;\n return (result[0]?.[1] as number) > 0;\n }\n }\n\n async cas<T = unknown>(\n key: string,\n expectedVersion: bigint,\n next: T,\n opts: Omit<KVSetOptions, 'ifVersion'> = {},\n ): Promise<KVEntry<T> | undefined> {\n try {\n return await this.set(key, next, { ...opts, ifVersion: expectedVersion });\n } catch (err) {\n if (err instanceof VersionMismatchError) return undefined;\n throw err;\n }\n }\n\n async close(): Promise<void> {\n this.closed = true;\n }\n\n private kvKey(key: string): string {\n return `${this.keyPrefix}kv:${key}`;\n }\n\n private parse(raw: string): StoredKV | undefined {\n try {\n const obj = JSON.parse(raw) as StoredKV;\n if (typeof obj.ver !== 'string') return undefined;\n return obj;\n } catch {\n return undefined;\n }\n }\n}\n","// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Redis } from 'ioredis';\nimport type { ICounter, CounterIncrOptions } from '@objectstack/spec/contracts';\n\nexport interface RedisCounterOptions {\n client: Redis;\n keyPrefix?: string;\n}\n\n/**\n * Redis-backed monotonic counter using INCRBY. Each counter key lives at\n * `{prefix}ctr:{key}` so the same Redis instance can host multiple\n * tenants without collision.\n *\n * Values are stored as ASCII decimals (Redis convention). We surface\n * them as `bigint` to match the contract — INCRBY accepts up to a\n * signed 64-bit range, well beyond Number.MAX_SAFE_INTEGER.\n */\nexport class RedisCounter implements ICounter {\n private readonly client: Redis;\n private readonly keyPrefix: string;\n private closed = false;\n\n constructor(opts: RedisCounterOptions) {\n this.client = opts.client;\n this.keyPrefix = opts.keyPrefix ?? 'os:';\n }\n\n async incr(key: string, opts: CounterIncrOptions = {}): Promise<bigint> {\n if (this.closed) throw new Error('RedisCounter is closed');\n const by = opts.by ?? 1;\n const next = await this.client.incrby(this.ctrKey(key), by);\n return BigInt(next);\n }\n\n async peek(key: string): Promise<bigint> {\n const raw = await this.client.get(this.ctrKey(key));\n if (raw === null) return 0n;\n try {\n return BigInt(raw);\n } catch {\n return 0n;\n }\n }\n\n async reset(key: string, value: bigint = 0n): Promise<void> {\n if (this.closed) throw new Error('RedisCounter is closed');\n if (value === 0n) {\n await this.client.del(this.ctrKey(key));\n return;\n }\n await this.client.set(this.ctrKey(key), value.toString());\n }\n\n async close(): Promise<void> {\n this.closed = true;\n }\n\n private ctrKey(key: string): string {\n return `${this.keyPrefix}ctr:${key}`;\n }\n}\n"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@objectstack/service-cluster-redis",
|
|
3
|
-
"version": "17.0.0
|
|
3
|
+
"version": "17.0.0",
|
|
4
4
|
"license": "Apache-2.0",
|
|
5
5
|
"description": "Redis cluster driver for ObjectStack — implements IPubSub/ILock/IKV/ICounter against Redis using ioredis.",
|
|
6
6
|
"type": "module",
|
|
@@ -15,8 +15,8 @@
|
|
|
15
15
|
},
|
|
16
16
|
"dependencies": {
|
|
17
17
|
"ioredis": "^6.0.0",
|
|
18
|
-
"@objectstack/service-cluster": "17.0.0
|
|
19
|
-
"@objectstack/spec": "17.0.0
|
|
18
|
+
"@objectstack/service-cluster": "17.0.0",
|
|
19
|
+
"@objectstack/spec": "17.0.0"
|
|
20
20
|
},
|
|
21
21
|
"devDependencies": {
|
|
22
22
|
"@types/node": "^26.1.2",
|