@procedures/client 0.2.0 → 0.2.1

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 (236) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/README.md +4 -4
  3. package/dist/.tsbuildinfo +1 -1
  4. package/dist/browser.d.ts +1 -1
  5. package/dist/browser.d.ts.map +1 -1
  6. package/dist/browser.js.map +1 -1
  7. package/dist/procedures/invoke.d.ts +6 -1
  8. package/dist/procedures/invoke.d.ts.map +1 -1
  9. package/dist/procedures/invoke.js +2 -2
  10. package/dist/procedures/invoke.js.map +1 -1
  11. package/dist/server/host-policy.d.ts +3 -3
  12. package/dist/server/host-policy.d.ts.map +1 -1
  13. package/dist/server/procedure-server.d.ts +2 -2
  14. package/dist/server/procedure-server.d.ts.map +1 -1
  15. package/dist/server/procedure-server.js.map +1 -1
  16. package/package.json +1 -1
  17. package/src/browser.ts +1 -0
  18. package/src/procedures/invoke.ts +10 -4
  19. package/src/server/host-policy.ts +3 -3
  20. package/src/server/procedure-server.ts +2 -2
  21. package/dist/client/middleware/batching.d.ts +0 -102
  22. package/dist/client/middleware/batching.d.ts.map +0 -1
  23. package/dist/client/middleware/batching.js +0 -245
  24. package/dist/client/middleware/batching.js.map +0 -1
  25. package/dist/collections/async/async-queue.d.ts +0 -144
  26. package/dist/collections/async/async-queue.d.ts.map +0 -1
  27. package/dist/collections/async/async-queue.js +0 -347
  28. package/dist/collections/async/async-queue.js.map +0 -1
  29. package/dist/collections/async/channels.d.ts +0 -188
  30. package/dist/collections/async/channels.d.ts.map +0 -1
  31. package/dist/collections/async/channels.js +0 -312
  32. package/dist/collections/async/channels.js.map +0 -1
  33. package/dist/collections/behaviors/bounded.d.ts +0 -79
  34. package/dist/collections/behaviors/bounded.d.ts.map +0 -1
  35. package/dist/collections/behaviors/bounded.js +0 -384
  36. package/dist/collections/behaviors/bounded.js.map +0 -1
  37. package/dist/collections/behaviors/evented.d.ts +0 -154
  38. package/dist/collections/behaviors/evented.d.ts.map +0 -1
  39. package/dist/collections/behaviors/evented.js +0 -299
  40. package/dist/collections/behaviors/evented.js.map +0 -1
  41. package/dist/collections/behaviors/lru.d.ts +0 -84
  42. package/dist/collections/behaviors/lru.d.ts.map +0 -1
  43. package/dist/collections/behaviors/lru.js +0 -330
  44. package/dist/collections/behaviors/lru.js.map +0 -1
  45. package/dist/collections/behaviors/readonly.d.ts +0 -73
  46. package/dist/collections/behaviors/readonly.d.ts.map +0 -1
  47. package/dist/collections/behaviors/readonly.js +0 -158
  48. package/dist/collections/behaviors/readonly.js.map +0 -1
  49. package/dist/collections/behaviors/safe.d.ts +0 -163
  50. package/dist/collections/behaviors/safe.d.ts.map +0 -1
  51. package/dist/collections/behaviors/safe.js +0 -172
  52. package/dist/collections/behaviors/safe.js.map +0 -1
  53. package/dist/collections/behaviors/synchronized.d.ts +0 -88
  54. package/dist/collections/behaviors/synchronized.d.ts.map +0 -1
  55. package/dist/collections/behaviors/synchronized.js +0 -294
  56. package/dist/collections/behaviors/synchronized.js.map +0 -1
  57. package/dist/collections/behaviors/ttl.d.ts +0 -118
  58. package/dist/collections/behaviors/ttl.d.ts.map +0 -1
  59. package/dist/collections/behaviors/ttl.js +0 -338
  60. package/dist/collections/behaviors/ttl.js.map +0 -1
  61. package/dist/collections/core/effects.d.ts +0 -176
  62. package/dist/collections/core/effects.d.ts.map +0 -1
  63. package/dist/collections/core/effects.js +0 -180
  64. package/dist/collections/core/effects.js.map +0 -1
  65. package/dist/collections/core/events.d.ts +0 -192
  66. package/dist/collections/core/events.d.ts.map +0 -1
  67. package/dist/collections/core/events.js +0 -291
  68. package/dist/collections/core/events.js.map +0 -1
  69. package/dist/collections/core/middleware.d.ts +0 -231
  70. package/dist/collections/core/middleware.d.ts.map +0 -1
  71. package/dist/collections/core/middleware.js +0 -161
  72. package/dist/collections/core/middleware.js.map +0 -1
  73. package/dist/collections/core/policies.d.ts +0 -220
  74. package/dist/collections/core/policies.d.ts.map +0 -1
  75. package/dist/collections/core/policies.js +0 -48
  76. package/dist/collections/core/policies.js.map +0 -1
  77. package/dist/collections/core/traits.d.ts +0 -142
  78. package/dist/collections/core/traits.d.ts.map +0 -1
  79. package/dist/collections/core/traits.js +0 -8
  80. package/dist/collections/core/traits.js.map +0 -1
  81. package/dist/collections/examples.d.ts +0 -13
  82. package/dist/collections/examples.d.ts.map +0 -1
  83. package/dist/collections/examples.js +0 -302
  84. package/dist/collections/examples.js.map +0 -1
  85. package/dist/collections/fx/collectors.d.ts +0 -190
  86. package/dist/collections/fx/collectors.d.ts.map +0 -1
  87. package/dist/collections/fx/collectors.js +0 -369
  88. package/dist/collections/fx/collectors.js.map +0 -1
  89. package/dist/collections/fx/iter.d.ts +0 -166
  90. package/dist/collections/fx/iter.d.ts.map +0 -1
  91. package/dist/collections/fx/iter.js +0 -421
  92. package/dist/collections/fx/iter.js.map +0 -1
  93. package/dist/collections/impl/array-deque.d.ts +0 -107
  94. package/dist/collections/impl/array-deque.d.ts.map +0 -1
  95. package/dist/collections/impl/array-deque.js +0 -381
  96. package/dist/collections/impl/array-deque.js.map +0 -1
  97. package/dist/collections/impl/array-list.d.ts +0 -101
  98. package/dist/collections/impl/array-list.d.ts.map +0 -1
  99. package/dist/collections/impl/array-list.js +0 -387
  100. package/dist/collections/impl/array-list.js.map +0 -1
  101. package/dist/collections/impl/hash-map.d.ts +0 -141
  102. package/dist/collections/impl/hash-map.d.ts.map +0 -1
  103. package/dist/collections/impl/hash-map.js +0 -450
  104. package/dist/collections/impl/hash-map.js.map +0 -1
  105. package/dist/collections/impl/hash-set.d.ts +0 -125
  106. package/dist/collections/impl/hash-set.d.ts.map +0 -1
  107. package/dist/collections/impl/hash-set.js +0 -264
  108. package/dist/collections/impl/hash-set.js.map +0 -1
  109. package/dist/collections/impl/linked-hash-map.d.ts +0 -141
  110. package/dist/collections/impl/linked-hash-map.d.ts.map +0 -1
  111. package/dist/collections/impl/linked-hash-map.js +0 -472
  112. package/dist/collections/impl/linked-hash-map.js.map +0 -1
  113. package/dist/collections/impl/linked-list.d.ts +0 -109
  114. package/dist/collections/impl/linked-list.d.ts.map +0 -1
  115. package/dist/collections/impl/linked-list.js +0 -491
  116. package/dist/collections/impl/linked-list.js.map +0 -1
  117. package/dist/collections/impl/priority-queue.d.ts +0 -134
  118. package/dist/collections/impl/priority-queue.d.ts.map +0 -1
  119. package/dist/collections/impl/priority-queue.js +0 -336
  120. package/dist/collections/impl/priority-queue.js.map +0 -1
  121. package/dist/collections/impl/tree-map.d.ts +0 -146
  122. package/dist/collections/impl/tree-map.d.ts.map +0 -1
  123. package/dist/collections/impl/tree-map.js +0 -781
  124. package/dist/collections/impl/tree-map.js.map +0 -1
  125. package/dist/collections/impl/tree-set.d.ts +0 -112
  126. package/dist/collections/impl/tree-set.d.ts.map +0 -1
  127. package/dist/collections/impl/tree-set.js +0 -374
  128. package/dist/collections/impl/tree-set.js.map +0 -1
  129. package/dist/collections/index.d.ts +0 -105
  130. package/dist/collections/index.d.ts.map +0 -1
  131. package/dist/collections/index.js +0 -135
  132. package/dist/collections/index.js.map +0 -1
  133. package/dist/collections/interfaces/collection.d.ts +0 -119
  134. package/dist/collections/interfaces/collection.d.ts.map +0 -1
  135. package/dist/collections/interfaces/collection.js +0 -8
  136. package/dist/collections/interfaces/collection.js.map +0 -1
  137. package/dist/collections/interfaces/list.d.ts +0 -247
  138. package/dist/collections/interfaces/list.d.ts.map +0 -1
  139. package/dist/collections/interfaces/list.js +0 -8
  140. package/dist/collections/interfaces/list.js.map +0 -1
  141. package/dist/collections/interfaces/map.d.ts +0 -344
  142. package/dist/collections/interfaces/map.d.ts.map +0 -1
  143. package/dist/collections/interfaces/map.js +0 -8
  144. package/dist/collections/interfaces/map.js.map +0 -1
  145. package/dist/collections/interfaces/queue.d.ts +0 -304
  146. package/dist/collections/interfaces/queue.d.ts.map +0 -1
  147. package/dist/collections/interfaces/queue.js +0 -8
  148. package/dist/collections/interfaces/queue.js.map +0 -1
  149. package/dist/collections/interfaces/set.d.ts +0 -137
  150. package/dist/collections/interfaces/set.d.ts.map +0 -1
  151. package/dist/collections/interfaces/set.js +0 -8
  152. package/dist/collections/interfaces/set.js.map +0 -1
  153. package/dist/collections/storage/api.d.ts +0 -109
  154. package/dist/collections/storage/api.d.ts.map +0 -1
  155. package/dist/collections/storage/api.js +0 -182
  156. package/dist/collections/storage/api.js.map +0 -1
  157. package/dist/collections/storage/hybrid.d.ts +0 -164
  158. package/dist/collections/storage/hybrid.d.ts.map +0 -1
  159. package/dist/collections/storage/hybrid.js +0 -416
  160. package/dist/collections/storage/hybrid.js.map +0 -1
  161. package/dist/collections/storage/index.d.ts +0 -16
  162. package/dist/collections/storage/index.d.ts.map +0 -1
  163. package/dist/collections/storage/index.js +0 -13
  164. package/dist/collections/storage/index.js.map +0 -1
  165. package/dist/collections/storage/interface.d.ts +0 -141
  166. package/dist/collections/storage/interface.d.ts.map +0 -1
  167. package/dist/collections/storage/interface.js +0 -23
  168. package/dist/collections/storage/interface.js.map +0 -1
  169. package/dist/collections/storage/memory.d.ts +0 -68
  170. package/dist/collections/storage/memory.d.ts.map +0 -1
  171. package/dist/collections/storage/memory.js +0 -154
  172. package/dist/collections/storage/memory.js.map +0 -1
  173. package/dist/collections/utils/defaults.d.ts +0 -135
  174. package/dist/collections/utils/defaults.d.ts.map +0 -1
  175. package/dist/collections/utils/defaults.js +0 -322
  176. package/dist/collections/utils/defaults.js.map +0 -1
  177. package/dist/collections/utils/factories.d.ts +0 -144
  178. package/dist/collections/utils/factories.d.ts.map +0 -1
  179. package/dist/collections/utils/factories.js +0 -293
  180. package/dist/collections/utils/factories.js.map +0 -1
  181. package/dist/collections/utils/helpers.d.ts +0 -137
  182. package/dist/collections/utils/helpers.d.ts.map +0 -1
  183. package/dist/collections/utils/helpers.js +0 -221
  184. package/dist/collections/utils/helpers.js.map +0 -1
  185. package/dist/collections.d.ts +0 -12
  186. package/dist/collections.d.ts.map +0 -1
  187. package/dist/collections.js +0 -10
  188. package/dist/collections.js.map +0 -1
  189. package/dist/components/define.d.ts +0 -134
  190. package/dist/components/define.d.ts.map +0 -1
  191. package/dist/components/define.js +0 -486
  192. package/dist/components/define.js.map +0 -1
  193. package/dist/components/index.d.ts +0 -39
  194. package/dist/components/index.d.ts.map +0 -1
  195. package/dist/components/index.js +0 -38
  196. package/dist/components/index.js.map +0 -1
  197. package/dist/components/types.d.ts +0 -264
  198. package/dist/components/types.d.ts.map +0 -1
  199. package/dist/components/types.js +0 -46
  200. package/dist/components/types.js.map +0 -1
  201. package/dist/procedures/storage/adapter.d.ts +0 -148
  202. package/dist/procedures/storage/adapter.d.ts.map +0 -1
  203. package/dist/procedures/storage/adapter.js +0 -214
  204. package/dist/procedures/storage/adapter.js.map +0 -1
  205. package/dist/procedures/storage/api.d.ts +0 -125
  206. package/dist/procedures/storage/api.d.ts.map +0 -1
  207. package/dist/procedures/storage/api.js +0 -220
  208. package/dist/procedures/storage/api.js.map +0 -1
  209. package/dist/procedures/storage/factory.d.ts +0 -134
  210. package/dist/procedures/storage/factory.d.ts.map +0 -1
  211. package/dist/procedures/storage/factory.js +0 -166
  212. package/dist/procedures/storage/factory.js.map +0 -1
  213. package/dist/procedures/storage/hybrid.d.ts +0 -193
  214. package/dist/procedures/storage/hybrid.d.ts.map +0 -1
  215. package/dist/procedures/storage/hybrid.js +0 -519
  216. package/dist/procedures/storage/hybrid.js.map +0 -1
  217. package/dist/procedures/storage/index.d.ts +0 -17
  218. package/dist/procedures/storage/index.d.ts.map +0 -1
  219. package/dist/procedures/storage/index.js +0 -17
  220. package/dist/procedures/storage/index.js.map +0 -1
  221. package/dist/procedures/storage/procedures.d.ts +0 -39
  222. package/dist/procedures/storage/procedures.d.ts.map +0 -1
  223. package/dist/procedures/storage/procedures.js +0 -261
  224. package/dist/procedures/storage/procedures.js.map +0 -1
  225. package/dist/procedures/storage/serialization.d.ts +0 -123
  226. package/dist/procedures/storage/serialization.d.ts.map +0 -1
  227. package/dist/procedures/storage/serialization.js +0 -216
  228. package/dist/procedures/storage/serialization.js.map +0 -1
  229. package/dist/procedures/storage/synced-registry.d.ts +0 -246
  230. package/dist/procedures/storage/synced-registry.d.ts.map +0 -1
  231. package/dist/procedures/storage/synced-registry.js +0 -575
  232. package/dist/procedures/storage/synced-registry.js.map +0 -1
  233. package/dist/procedures/storage/types.d.ts +0 -130
  234. package/dist/procedures/storage/types.d.ts.map +0 -1
  235. package/dist/procedures/storage/types.js +0 -8
  236. package/dist/procedures/storage/types.js.map +0 -1
@@ -1,294 +0,0 @@
1
- /**
2
- * Synchronized behavior - Provides thread-safe access with mutex locking.
3
- *
4
- * Wraps collections to serialize all operations using a mutex, ensuring
5
- * thread-safe access in concurrent environments. Mirrors Java's
6
- * Collections.synchronizedList() and related methods.
7
- *
8
- * Note: JavaScript is single-threaded, but async operations can interleave.
9
- * This middleware ensures atomic operations across async boundaries.
10
- *
11
- * @example
12
- * const list = compose(
13
- * synchronized()
14
- * )(arrayList<number>())
15
- *
16
- * // All operations are now serialized
17
- * await Promise.all([
18
- * list.add(1),
19
- * list.add(2),
20
- * list.add(3)
21
- * ])
22
- */
23
- /**
24
- * Simple mutex implementation for JavaScript async operations.
25
- *
26
- * Ensures that only one operation executes at a time, even if
27
- * multiple async operations are initiated concurrently.
28
- */
29
- class Mutex {
30
- queue = Promise.resolve();
31
- /**
32
- * Acquires the lock and executes the function.
33
- * Other operations wait until this completes.
34
- */
35
- async lock(fn) {
36
- const run = this.queue.then(() => fn());
37
- this.queue = run.then(() => undefined, () => undefined);
38
- return run;
39
- }
40
- /**
41
- * Synchronous version that executes immediately.
42
- * Still queues to prevent interleaving with async operations.
43
- */
44
- lockSync(fn) {
45
- let result;
46
- let error;
47
- let hasError = false;
48
- // Execute synchronously but update queue
49
- try {
50
- result = fn();
51
- }
52
- catch (e) {
53
- error = e;
54
- hasError = true;
55
- }
56
- // Update the queue to reflect this operation completed
57
- const completed = Promise.resolve();
58
- this.queue = this.queue.then(() => completed);
59
- if (hasError) {
60
- throw error;
61
- }
62
- return result;
63
- }
64
- }
65
- /**
66
- * Creates a synchronized middleware that locks all method calls.
67
- *
68
- * Every method call on the collection is wrapped with a mutex,
69
- * ensuring atomic execution even in concurrent async scenarios.
70
- *
71
- * @example
72
- * const syncList = compose(
73
- * synchronized()
74
- * )(arrayList<number>())
75
- *
76
- * // These additions are guaranteed to execute in order
77
- * await Promise.all([
78
- * syncList.add(1),
79
- * syncList.add(2),
80
- * syncList.add(3)
81
- * ])
82
- */
83
- export function synchronized() {
84
- return (next) => {
85
- const mutex = new Mutex();
86
- return new Proxy(next, {
87
- get(target, prop, receiver) {
88
- const value = Reflect.get(target, prop, receiver);
89
- // Don't wrap non-functions
90
- if (typeof value !== "function") {
91
- return value;
92
- }
93
- // Check if the method is async by checking if it returns a Promise
94
- return function (...args) {
95
- // Try to execute synchronously first
96
- const result = value.apply(target, args);
97
- // If result is a Promise, wrap with async lock
98
- if (result instanceof Promise) {
99
- return mutex.lock(() => result);
100
- }
101
- // Otherwise, use sync lock
102
- return mutex.lockSync(() => result);
103
- };
104
- },
105
- });
106
- };
107
- }
108
- /**
109
- * Alias for Java compatibility: synchronizedList
110
- */
111
- export const synchronizedList = synchronized;
112
- /**
113
- * Alias for Java compatibility: synchronizedMap
114
- */
115
- export const synchronizedMap = synchronized;
116
- /**
117
- * Alias for Java compatibility: synchronizedCollection
118
- */
119
- export const synchronizedCollection = synchronized;
120
- /**
121
- * Alias for Java compatibility: synchronizedSet
122
- */
123
- export const synchronizedSet = synchronized;
124
- /**
125
- * Advanced synchronized middleware with reentrant locking.
126
- *
127
- * Allows the same "thread" (async context) to acquire the lock multiple times.
128
- * Useful for methods that call other synchronized methods internally.
129
- *
130
- * Note: JavaScript doesn't have true thread IDs, so we use async context
131
- * tracking if available, or fall back to non-reentrant behavior.
132
- */
133
- export function reentrantSynchronized() {
134
- return (next) => {
135
- const mutex = new Mutex();
136
- let lockHolder = null;
137
- let lockCount = 0;
138
- return new Proxy(next, {
139
- get(target, prop, receiver) {
140
- const value = Reflect.get(target, prop, receiver);
141
- if (typeof value !== "function") {
142
- return value;
143
- }
144
- return async function (...args) {
145
- // Generate a unique ID for this call context
146
- const callerId = Symbol("caller");
147
- // If we already hold the lock, execute directly (reentrant)
148
- if (lockHolder === callerId) {
149
- lockCount++;
150
- try {
151
- const result = value.apply(target, args);
152
- return result instanceof Promise ? await result : result;
153
- }
154
- finally {
155
- lockCount--;
156
- }
157
- }
158
- // Otherwise, acquire the lock
159
- return mutex.lock(async () => {
160
- lockHolder = callerId;
161
- lockCount = 1;
162
- try {
163
- const result = value.apply(target, args);
164
- return result instanceof Promise ? await result : result;
165
- }
166
- finally {
167
- lockCount--;
168
- if (lockCount === 0) {
169
- lockHolder = null;
170
- }
171
- }
172
- });
173
- };
174
- },
175
- });
176
- };
177
- }
178
- /**
179
- * Read-write lock implementation for collections.
180
- *
181
- * Allows multiple concurrent readers but exclusive writers.
182
- * More efficient than full synchronization for read-heavy workloads.
183
- *
184
- * @example
185
- * const list = compose(
186
- * readWriteLock()
187
- * )(arrayList<number>())
188
- *
189
- * // Multiple reads can happen concurrently
190
- * await Promise.all([
191
- * list.get(0),
192
- * list.get(1),
193
- * list.get(2)
194
- * ])
195
- */
196
- export function readWriteLock() {
197
- return (next) => {
198
- let readers = 0;
199
- let writer = false;
200
- let waitingReaders = [];
201
- let waitingWriters = [];
202
- const acquireRead = async () => {
203
- if (writer || waitingWriters.length > 0) {
204
- await new Promise((resolve) => waitingReaders.push(resolve));
205
- }
206
- readers++;
207
- };
208
- const releaseRead = () => {
209
- readers--;
210
- if (readers === 0 && waitingWriters.length > 0) {
211
- writer = true;
212
- const next = waitingWriters.shift();
213
- next();
214
- }
215
- };
216
- const acquireWrite = async () => {
217
- if (writer || readers > 0) {
218
- await new Promise((resolve) => waitingWriters.push(resolve));
219
- }
220
- writer = true;
221
- };
222
- const releaseWrite = () => {
223
- writer = false;
224
- if (waitingWriters.length > 0) {
225
- writer = true;
226
- const next = waitingWriters.shift();
227
- next();
228
- }
229
- else if (waitingReaders.length > 0) {
230
- const allReaders = waitingReaders.splice(0);
231
- readers = allReaders.length;
232
- allReaders.forEach((resolve) => resolve());
233
- }
234
- };
235
- // Methods that only read (don't mutate)
236
- const READ_METHODS = new Set([
237
- "get",
238
- "has",
239
- "contains",
240
- "containsAll",
241
- "containsValue",
242
- "indexOf",
243
- "lastIndexOf",
244
- "peek",
245
- "peekFirst",
246
- "peekLast",
247
- "first",
248
- "last",
249
- "isEmpty",
250
- "size",
251
- "toArray",
252
- "keys",
253
- "values",
254
- "entries",
255
- "forEach",
256
- "getOrDefault",
257
- "getOrUndefined",
258
- ]);
259
- return new Proxy(next, {
260
- get(target, prop, receiver) {
261
- const value = Reflect.get(target, prop, receiver);
262
- if (typeof value !== "function") {
263
- return value;
264
- }
265
- const isReadMethod = typeof prop === "string" && READ_METHODS.has(prop);
266
- return async function (...args) {
267
- if (isReadMethod) {
268
- // Acquire read lock
269
- await acquireRead();
270
- try {
271
- const result = value.apply(target, args);
272
- return result instanceof Promise ? await result : result;
273
- }
274
- finally {
275
- releaseRead();
276
- }
277
- }
278
- else {
279
- // Acquire write lock
280
- await acquireWrite();
281
- try {
282
- const result = value.apply(target, args);
283
- return result instanceof Promise ? await result : result;
284
- }
285
- finally {
286
- releaseWrite();
287
- }
288
- }
289
- };
290
- },
291
- });
292
- };
293
- }
294
- //# sourceMappingURL=synchronized.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"synchronized.js","sourceRoot":"","sources":["../../../src/collections/behaviors/synchronized.ts"],"names":[],"mappings":"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"}
@@ -1,118 +0,0 @@
1
- /**
2
- * TTL (Time-To-Live) expiration behavior.
3
- *
4
- * Automatically expires elements after a specified time period.
5
- * Perfect for temporary caches and time-limited data.
6
- *
7
- * @example
8
- * const cache = compose(
9
- * ttlMap({ ttl: 60000 }) // 60 seconds
10
- * )(hashMap<string, Data>())
11
- *
12
- * cache.set('key', data)
13
- * // After 60 seconds, 'key' is automatically removed
14
- */
15
- import type { Middleware } from "../core/middleware.js";
16
- import type { MapLike } from "../interfaces/map.js";
17
- import type { Collection } from "../interfaces/collection.js";
18
- /**
19
- * Options for TTL behavior.
20
- */
21
- export interface TTLOptions {
22
- /**
23
- * Time-to-live in milliseconds.
24
- * Elements expire after this duration.
25
- */
26
- ttl: number;
27
- /**
28
- * Interval for checking expired elements (in milliseconds).
29
- * @default 1000 (check every second)
30
- */
31
- checkInterval?: number;
32
- /**
33
- * Optional callback invoked when an element expires.
34
- */
35
- onExpire?: (info: {
36
- key: any;
37
- value: any;
38
- createdAt: number;
39
- expiredAt: number;
40
- }) => void;
41
- }
42
- /**
43
- * Creates a TTL Map middleware.
44
- *
45
- * Automatically removes entries after TTL expires.
46
- * Uses a background interval to check for expired entries.
47
- */
48
- export declare function ttlMap<K, V>(options: TTLOptions): Middleware<MapLike<K, V> & {
49
- readonly dispose: () => void;
50
- }>;
51
- /**
52
- * Creates a TTL Collection middleware.
53
- *
54
- * Note: This is less precise than TTL map because collections don't have keys.
55
- * Elements are tracked by reference, which may not work for primitive types.
56
- */
57
- export declare function ttlCollection<T>(options: Omit<TTLOptions, "onExpire"> & {
58
- onExpire?: (info: {
59
- element: T;
60
- createdAt: number;
61
- expiredAt: number;
62
- }) => void;
63
- }): Middleware<Collection<T> & {
64
- readonly dispose: () => void;
65
- }>;
66
- /**
67
- * Standalone TTL cache with Map-like API.
68
- *
69
- * @example
70
- * const cache = new TTLCache<string, number>(60000) // 60 second TTL
71
- * cache.set('key', 42)
72
- * setTimeout(() => {
73
- * cache.get('key') // undefined (expired)
74
- * }, 61000)
75
- */
76
- export declare class TTLCache<K, V> {
77
- private readonly ttl;
78
- private readonly checkInterval;
79
- private readonly onExpire?;
80
- private map;
81
- private intervalId;
82
- constructor(ttl: number, checkInterval?: number, onExpire?: ((key: K, value: V) => void) | undefined);
83
- get size(): number;
84
- get(key: K): V | undefined;
85
- set(key: K, value: V, customTTL?: number): void;
86
- has(key: K): boolean;
87
- delete(key: K): boolean;
88
- clear(): void;
89
- /**
90
- * Manually trigger cleanup of expired entries.
91
- */
92
- cleanup(): void;
93
- /**
94
- * Get remaining TTL for a key in milliseconds.
95
- * Returns undefined if key doesn't exist or is expired.
96
- */
97
- getTTL(key: K): number | undefined;
98
- /**
99
- * Update TTL for an existing key.
100
- */
101
- touch(key: K, customTTL?: number): boolean;
102
- private startExpirationCheck;
103
- /**
104
- * Stop the background expiration checker and clean up.
105
- */
106
- dispose(): void;
107
- keys(): IterableIterator<K>;
108
- values(): IterableIterator<V>;
109
- entries(): IterableIterator<[K, V]>;
110
- }
111
- /**
112
- * Factory function to create a TTL cache.
113
- */
114
- export declare function ttlCache<K, V>(ttl: number, options?: {
115
- checkInterval?: number;
116
- onExpire?: (key: K, value: V) => void;
117
- }): TTLCache<K, V>;
118
- //# sourceMappingURL=ttl.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"ttl.d.ts","sourceRoot":"","sources":["../../../src/collections/behaviors/ttl.ts"],"names":[],"mappings":"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"}