@procedures/collections 0.46.0 → 0.47.2

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 (233) hide show
  1. package/CHANGELOG.md +42 -8
  2. package/README.md +30 -0
  3. package/dist/.tsbuildinfo +1 -1
  4. package/dist/index.d.ts +1 -58
  5. package/dist/index.d.ts.map +1 -1
  6. package/dist/index.js +3 -94
  7. package/dist/index.js.map +1 -1
  8. package/dist/storage/index.d.ts +2 -2
  9. package/dist/storage/index.d.ts.map +1 -1
  10. package/dist/storage/index.js +1 -1
  11. package/dist/storage/index.js.map +1 -1
  12. package/dist/storage/memory.d.ts +1 -1
  13. package/dist/storage/memory.d.ts.map +1 -1
  14. package/dist/storage/memory.js +1 -1
  15. package/dist/storage/memory.js.map +1 -1
  16. package/dist/testing/index.d.ts +1 -1
  17. package/dist/testing/index.d.ts.map +1 -1
  18. package/dist/testing/index.js +1 -1
  19. package/dist/testing/index.js.map +1 -1
  20. package/dist/testing/storage-contract.js +1 -1
  21. package/dist/testing/storage-contract.js.map +1 -1
  22. package/dist/undo/index.d.ts +1 -1
  23. package/dist/undo/index.js +1 -1
  24. package/dist/undo/undo-log.d.ts +1 -1
  25. package/dist/undo/undo-log.js +1 -1
  26. package/package.json +6 -6
  27. package/src/index.ts +338 -213
  28. package/src/storage/index.ts +2 -2
  29. package/src/storage/memory.ts +1 -1
  30. package/src/testing/index.ts +1 -1
  31. package/src/testing/storage-contract.ts +1 -1
  32. package/src/undo/index.ts +1 -1
  33. package/src/undo/undo-log.ts +1 -1
  34. package/dist/async/async-queue.d.ts +0 -170
  35. package/dist/async/async-queue.d.ts.map +0 -1
  36. package/dist/async/async-queue.js +0 -404
  37. package/dist/async/async-queue.js.map +0 -1
  38. package/dist/async/channels.d.ts +0 -211
  39. package/dist/async/channels.d.ts.map +0 -1
  40. package/dist/async/channels.js +0 -393
  41. package/dist/async/channels.js.map +0 -1
  42. package/dist/async/settled.d.ts +0 -23
  43. package/dist/async/settled.d.ts.map +0 -1
  44. package/dist/async/settled.js +0 -32
  45. package/dist/async/settled.js.map +0 -1
  46. package/dist/behaviors/bounded.d.ts +0 -79
  47. package/dist/behaviors/bounded.d.ts.map +0 -1
  48. package/dist/behaviors/bounded.js +0 -393
  49. package/dist/behaviors/bounded.js.map +0 -1
  50. package/dist/behaviors/composite.d.ts +0 -17
  51. package/dist/behaviors/composite.d.ts.map +0 -1
  52. package/dist/behaviors/composite.js +0 -93
  53. package/dist/behaviors/composite.js.map +0 -1
  54. package/dist/behaviors/evented.d.ts +0 -154
  55. package/dist/behaviors/evented.d.ts.map +0 -1
  56. package/dist/behaviors/evented.js +0 -299
  57. package/dist/behaviors/evented.js.map +0 -1
  58. package/dist/behaviors/lru.d.ts +0 -84
  59. package/dist/behaviors/lru.d.ts.map +0 -1
  60. package/dist/behaviors/lru.js +0 -376
  61. package/dist/behaviors/lru.js.map +0 -1
  62. package/dist/behaviors/readonly.d.ts +0 -73
  63. package/dist/behaviors/readonly.d.ts.map +0 -1
  64. package/dist/behaviors/readonly.js +0 -189
  65. package/dist/behaviors/readonly.js.map +0 -1
  66. package/dist/behaviors/safe.d.ts +0 -163
  67. package/dist/behaviors/safe.d.ts.map +0 -1
  68. package/dist/behaviors/safe.js +0 -176
  69. package/dist/behaviors/safe.js.map +0 -1
  70. package/dist/behaviors/synchronized.d.ts +0 -88
  71. package/dist/behaviors/synchronized.d.ts.map +0 -1
  72. package/dist/behaviors/synchronized.js +0 -285
  73. package/dist/behaviors/synchronized.js.map +0 -1
  74. package/dist/behaviors/ttl.d.ts +0 -118
  75. package/dist/behaviors/ttl.d.ts.map +0 -1
  76. package/dist/behaviors/ttl.js +0 -354
  77. package/dist/behaviors/ttl.js.map +0 -1
  78. package/dist/contracts/model.d.ts +0 -29
  79. package/dist/contracts/model.d.ts.map +0 -1
  80. package/dist/contracts/model.js +0 -26
  81. package/dist/contracts/model.js.map +0 -1
  82. package/dist/core/effects.d.ts +0 -176
  83. package/dist/core/effects.d.ts.map +0 -1
  84. package/dist/core/effects.js +0 -180
  85. package/dist/core/effects.js.map +0 -1
  86. package/dist/core/events.d.ts +0 -192
  87. package/dist/core/events.d.ts.map +0 -1
  88. package/dist/core/events.js +0 -291
  89. package/dist/core/events.js.map +0 -1
  90. package/dist/core/middleware.d.ts +0 -231
  91. package/dist/core/middleware.d.ts.map +0 -1
  92. package/dist/core/middleware.js +0 -161
  93. package/dist/core/middleware.js.map +0 -1
  94. package/dist/core/policies.d.ts +0 -220
  95. package/dist/core/policies.d.ts.map +0 -1
  96. package/dist/core/policies.js +0 -48
  97. package/dist/core/policies.js.map +0 -1
  98. package/dist/core/traits.d.ts +0 -142
  99. package/dist/core/traits.d.ts.map +0 -1
  100. package/dist/core/traits.js +0 -8
  101. package/dist/core/traits.js.map +0 -1
  102. package/dist/fx/collectors.d.ts +0 -193
  103. package/dist/fx/collectors.d.ts.map +0 -1
  104. package/dist/fx/collectors.js +0 -375
  105. package/dist/fx/collectors.js.map +0 -1
  106. package/dist/fx/iter.d.ts +0 -166
  107. package/dist/fx/iter.d.ts.map +0 -1
  108. package/dist/fx/iter.js +0 -421
  109. package/dist/fx/iter.js.map +0 -1
  110. package/dist/impl/array-deque.d.ts +0 -112
  111. package/dist/impl/array-deque.d.ts.map +0 -1
  112. package/dist/impl/array-deque.js +0 -380
  113. package/dist/impl/array-deque.js.map +0 -1
  114. package/dist/impl/array-list.d.ts +0 -101
  115. package/dist/impl/array-list.d.ts.map +0 -1
  116. package/dist/impl/array-list.js +0 -387
  117. package/dist/impl/array-list.js.map +0 -1
  118. package/dist/impl/hash-map.d.ts +0 -149
  119. package/dist/impl/hash-map.d.ts.map +0 -1
  120. package/dist/impl/hash-map.js +0 -473
  121. package/dist/impl/hash-map.js.map +0 -1
  122. package/dist/impl/hash-set.d.ts +0 -125
  123. package/dist/impl/hash-set.d.ts.map +0 -1
  124. package/dist/impl/hash-set.js +0 -264
  125. package/dist/impl/hash-set.js.map +0 -1
  126. package/dist/impl/linked-hash-map.d.ts +0 -141
  127. package/dist/impl/linked-hash-map.d.ts.map +0 -1
  128. package/dist/impl/linked-hash-map.js +0 -442
  129. package/dist/impl/linked-hash-map.js.map +0 -1
  130. package/dist/impl/linked-list.d.ts +0 -109
  131. package/dist/impl/linked-list.d.ts.map +0 -1
  132. package/dist/impl/linked-list.js +0 -494
  133. package/dist/impl/linked-list.js.map +0 -1
  134. package/dist/impl/priority-queue.d.ts +0 -139
  135. package/dist/impl/priority-queue.d.ts.map +0 -1
  136. package/dist/impl/priority-queue.js +0 -343
  137. package/dist/impl/priority-queue.js.map +0 -1
  138. package/dist/impl/tree-map.d.ts +0 -153
  139. package/dist/impl/tree-map.d.ts.map +0 -1
  140. package/dist/impl/tree-map.js +0 -788
  141. package/dist/impl/tree-map.js.map +0 -1
  142. package/dist/impl/tree-set.d.ts +0 -112
  143. package/dist/impl/tree-set.d.ts.map +0 -1
  144. package/dist/impl/tree-set.js +0 -374
  145. package/dist/impl/tree-set.js.map +0 -1
  146. package/dist/interfaces/collection.d.ts +0 -119
  147. package/dist/interfaces/collection.d.ts.map +0 -1
  148. package/dist/interfaces/collection.js +0 -8
  149. package/dist/interfaces/collection.js.map +0 -1
  150. package/dist/interfaces/list.d.ts +0 -247
  151. package/dist/interfaces/list.d.ts.map +0 -1
  152. package/dist/interfaces/list.js +0 -8
  153. package/dist/interfaces/list.js.map +0 -1
  154. package/dist/interfaces/map.d.ts +0 -344
  155. package/dist/interfaces/map.d.ts.map +0 -1
  156. package/dist/interfaces/map.js +0 -8
  157. package/dist/interfaces/map.js.map +0 -1
  158. package/dist/interfaces/queue.d.ts +0 -304
  159. package/dist/interfaces/queue.d.ts.map +0 -1
  160. package/dist/interfaces/queue.js +0 -8
  161. package/dist/interfaces/queue.js.map +0 -1
  162. package/dist/interfaces/set.d.ts +0 -137
  163. package/dist/interfaces/set.d.ts.map +0 -1
  164. package/dist/interfaces/set.js +0 -8
  165. package/dist/interfaces/set.js.map +0 -1
  166. package/dist/order/index.d.ts +0 -7
  167. package/dist/order/index.d.ts.map +0 -1
  168. package/dist/order/index.js +0 -7
  169. package/dist/order/index.js.map +0 -1
  170. package/dist/order/rank.d.ts +0 -100
  171. package/dist/order/rank.d.ts.map +0 -1
  172. package/dist/order/rank.js +0 -286
  173. package/dist/order/rank.js.map +0 -1
  174. package/dist/storage/listeners.d.ts +0 -39
  175. package/dist/storage/listeners.d.ts.map +0 -1
  176. package/dist/storage/listeners.js +0 -65
  177. package/dist/storage/listeners.js.map +0 -1
  178. package/dist/testing/check.d.ts +0 -25
  179. package/dist/testing/check.d.ts.map +0 -1
  180. package/dist/testing/check.js +0 -85
  181. package/dist/testing/check.js.map +0 -1
  182. package/dist/utils/defaults.d.ts +0 -135
  183. package/dist/utils/defaults.d.ts.map +0 -1
  184. package/dist/utils/defaults.js +0 -322
  185. package/dist/utils/defaults.js.map +0 -1
  186. package/dist/utils/factories.d.ts +0 -144
  187. package/dist/utils/factories.d.ts.map +0 -1
  188. package/dist/utils/factories.js +0 -293
  189. package/dist/utils/factories.js.map +0 -1
  190. package/dist/utils/helpers.d.ts +0 -137
  191. package/dist/utils/helpers.d.ts.map +0 -1
  192. package/dist/utils/helpers.js +0 -221
  193. package/dist/utils/helpers.js.map +0 -1
  194. package/src/async/async-queue.ts +0 -481
  195. package/src/async/channels.ts +0 -450
  196. package/src/async/settled.ts +0 -41
  197. package/src/behaviors/bounded.ts +0 -485
  198. package/src/behaviors/composite.ts +0 -99
  199. package/src/behaviors/evented.ts +0 -464
  200. package/src/behaviors/lru.ts +0 -447
  201. package/src/behaviors/readonly.ts +0 -236
  202. package/src/behaviors/safe.ts +0 -372
  203. package/src/behaviors/synchronized.ts +0 -316
  204. package/src/behaviors/ttl.ts +0 -462
  205. package/src/contracts/model.ts +0 -44
  206. package/src/core/effects.ts +0 -323
  207. package/src/core/events.ts +0 -356
  208. package/src/core/middleware.ts +0 -415
  209. package/src/core/policies.ts +0 -316
  210. package/src/core/traits.ts +0 -164
  211. package/src/fx/collectors.ts +0 -500
  212. package/src/fx/iter.ts +0 -536
  213. package/src/impl/array-deque.ts +0 -463
  214. package/src/impl/array-list.ts +0 -490
  215. package/src/impl/hash-map.ts +0 -623
  216. package/src/impl/hash-set.ts +0 -342
  217. package/src/impl/linked-hash-map.ts +0 -572
  218. package/src/impl/linked-list.ts +0 -606
  219. package/src/impl/priority-queue.ts +0 -448
  220. package/src/impl/tree-map.ts +0 -912
  221. package/src/impl/tree-set.ts +0 -469
  222. package/src/interfaces/collection.ts +0 -141
  223. package/src/interfaces/list.ts +0 -281
  224. package/src/interfaces/map.ts +0 -405
  225. package/src/interfaces/queue.ts +0 -353
  226. package/src/interfaces/set.ts +0 -158
  227. package/src/order/index.ts +0 -6
  228. package/src/order/rank.ts +0 -271
  229. package/src/storage/listeners.ts +0 -72
  230. package/src/testing/check.ts +0 -81
  231. package/src/utils/defaults.ts +0 -345
  232. package/src/utils/factories.ts +0 -357
  233. package/src/utils/helpers.ts +0 -248
@@ -1,163 +0,0 @@
1
- /**
2
- * Safe behavior - Provides Option/Result-based error handling.
3
- *
4
- * Wraps collection operations that throw errors to instead return
5
- * Option<T> or Result<T, E>, enabling functional error handling.
6
- *
7
- * @example
8
- * const list = compose(
9
- * safeList()
10
- * )(arrayList<number>())
11
- *
12
- * const value = list.safe.get(10) // Option<number> instead of throwing
13
- * if (isSome(value)) {
14
- * console.log(value.value)
15
- * }
16
- */
17
- import type { Middleware } from "../core/middleware.js";
18
- import type { List } from "../interfaces/list.js";
19
- import type { Queue, Deque } from "../interfaces/queue.js";
20
- import type { MapLike } from "../interfaces/map.js";
21
- import { type Option, type Result } from "../core/effects.js";
22
- /**
23
- * Safe operations for List.
24
- */
25
- export interface SafeListOperations<T> {
26
- /**
27
- * Get element at index, returning Option.
28
- */
29
- get(index: number): Option<T>;
30
- /**
31
- * Set element at index, returning Result with old value or error.
32
- */
33
- set(index: number, element: T): Result<T, string>;
34
- /**
35
- * Remove element at index, returning Result with removed value or error.
36
- */
37
- removeAt(index: number): Result<T, string>;
38
- /**
39
- * Get first element as Option.
40
- */
41
- first(): Option<T>;
42
- /**
43
- * Get last element as Option.
44
- */
45
- last(): Option<T>;
46
- /**
47
- * Pop element, returning Option.
48
- */
49
- pop(): Option<T>;
50
- /**
51
- * Shift element, returning Option.
52
- */
53
- shift(): Option<T>;
54
- }
55
- /**
56
- * Safe operations for Queue.
57
- */
58
- export interface SafeQueueOperations<T> {
59
- /**
60
- * Peek at head element as Option.
61
- */
62
- peek(): Option<T>;
63
- /**
64
- * Poll element as Option.
65
- */
66
- poll(): Option<T>;
67
- /**
68
- * Dequeue element as Option.
69
- */
70
- dequeue(): Option<T>;
71
- }
72
- /**
73
- * Safe operations for Deque.
74
- */
75
- export interface SafeDequeOperations<T> extends SafeQueueOperations<T> {
76
- /**
77
- * Peek at first element as Option.
78
- */
79
- peekFirst(): Option<T>;
80
- /**
81
- * Peek at last element as Option.
82
- */
83
- peekLast(): Option<T>;
84
- /**
85
- * Poll first element as Option.
86
- */
87
- pollFirst(): Option<T>;
88
- /**
89
- * Poll last element as Option.
90
- */
91
- pollLast(): Option<T>;
92
- /**
93
- * Pop element as Option.
94
- */
95
- pop(): Option<T>;
96
- }
97
- /**
98
- * Safe operations for Map.
99
- */
100
- export interface SafeMapOperations<K, V> {
101
- /**
102
- * Get value for key as Option.
103
- */
104
- get(key: K): Option<V>;
105
- /**
106
- * Set value for key, returning Result with old value or success.
107
- */
108
- set(key: K, value: V): Result<V | undefined, string>;
109
- /**
110
- * Delete key, returning Result with deleted value or error.
111
- */
112
- delete(key: K): Result<V | undefined, string>;
113
- }
114
- /**
115
- * Creates a safe List middleware.
116
- *
117
- * Exposes a `safe` property with Option/Result-based operations.
118
- */
119
- export declare function safeList<T>(): Middleware<List<T>, List<T> & {
120
- safe: SafeListOperations<T>;
121
- }>;
122
- /**
123
- * Creates a safe Queue middleware.
124
- */
125
- export declare function safeQueue<T>(): Middleware<Queue<T>, Queue<T> & {
126
- safe: SafeQueueOperations<T>;
127
- }>;
128
- /**
129
- * Creates a safe Deque middleware.
130
- */
131
- export declare function safeDeque<T>(): Middleware<Deque<T>, Deque<T> & {
132
- safe: SafeDequeOperations<T>;
133
- }>;
134
- /**
135
- * Creates a safe Map middleware.
136
- */
137
- export declare function safeMap<K, V>(): Middleware<MapLike<K, V>, MapLike<K, V> & {
138
- safe: SafeMapOperations<K, V>;
139
- }>;
140
- /**
141
- * Helper to match on Result type.
142
- * Note: The match method is already built into Ok and Err constructors
143
- * in effects.ts, so no runtime augmentation is needed.
144
- */
145
- declare module "../core/effects.js" {
146
- interface Ok<T> {
147
- match<U>(cases: {
148
- Ok: (value: T) => U;
149
- Err: (error: never) => U;
150
- }): U;
151
- }
152
- interface Err<E> {
153
- match<U>(cases: {
154
- Ok: (value: never) => U;
155
- Err: (error: E) => U;
156
- }): U;
157
- }
158
- }
159
- /**
160
- * Generic safe middleware that works with any collection.
161
- */
162
- export declare function safe<C extends object>(): Middleware<C>;
163
- //# sourceMappingURL=safe.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"safe.d.ts","sourceRoot":"","sources":["../../src/behaviors/safe.ts"],"names":[],"mappings":"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"}
@@ -1,176 +0,0 @@
1
- /**
2
- * Safe behavior - Provides Option/Result-based error handling.
3
- *
4
- * Wraps collection operations that throw errors to instead return
5
- * Option<T> or Result<T, E>, enabling functional error handling.
6
- *
7
- * @example
8
- * const list = compose(
9
- * safeList()
10
- * )(arrayList<number>())
11
- *
12
- * const value = list.safe.get(10) // Option<number> instead of throwing
13
- * if (isSome(value)) {
14
- * console.log(value.value)
15
- * }
16
- */
17
- import {} from "../core/effects.js";
18
- import { None, Some, tryCatch } from "../core/effects.js";
19
- /**
20
- * Creates a safe List middleware.
21
- *
22
- * Exposes a `safe` property with Option/Result-based operations.
23
- */
24
- export function safeList() {
25
- return (next) => {
26
- const safe = {
27
- get(index) {
28
- return tryCatch(() => next.get(index), () => "Index out of bounds").match({
29
- Ok: (value) => Some(value),
30
- Err: () => None,
31
- });
32
- },
33
- set(index, element) {
34
- return tryCatch(() => next.set(index, element), (error) => String(error));
35
- },
36
- removeAt(index) {
37
- return tryCatch(() => next.removeAt(index), (error) => String(error));
38
- },
39
- first() {
40
- return next.isEmpty ? None : Some(next.first());
41
- },
42
- last() {
43
- return next.isEmpty ? None : Some(next.last());
44
- },
45
- pop() {
46
- if (next.isEmpty)
47
- return None;
48
- return tryCatch(() => next.pop(), () => "List is empty").match({
49
- Ok: (value) => Some(value),
50
- Err: () => None,
51
- });
52
- },
53
- shift() {
54
- if (next.isEmpty)
55
- return None;
56
- return tryCatch(() => next.shift(), () => "List is empty").match({
57
- Ok: (value) => Some(value),
58
- Err: () => None,
59
- });
60
- },
61
- };
62
- // Extend next with safe property
63
- return Object.assign(next, { safe });
64
- };
65
- }
66
- /**
67
- * Creates a safe Queue middleware.
68
- */
69
- export function safeQueue() {
70
- return (next) => {
71
- const safe = {
72
- peek() {
73
- if (next.isEmpty)
74
- return None;
75
- return tryCatch(() => next.peek(), () => "Queue is empty").match({
76
- Ok: (value) => Some(value),
77
- Err: () => None,
78
- });
79
- },
80
- poll() {
81
- if (next.isEmpty)
82
- return None;
83
- return tryCatch(() => next.poll(), () => "Queue is empty").match({
84
- Ok: (value) => Some(value),
85
- Err: () => None,
86
- });
87
- },
88
- dequeue() {
89
- if (next.isEmpty)
90
- return None;
91
- return tryCatch(() => next.dequeue(), () => "Queue is empty").match({
92
- Ok: (value) => Some(value),
93
- Err: () => None,
94
- });
95
- },
96
- };
97
- return Object.assign(next, { safe });
98
- };
99
- }
100
- /**
101
- * Creates a safe Deque middleware.
102
- */
103
- export function safeDeque() {
104
- return (next) => {
105
- const safe = {
106
- peek() {
107
- return next.isEmpty ? None : Some(next.peekFirst());
108
- },
109
- poll() {
110
- // One poll: before, the test and the result each called pollFirst(), so poll() removed
111
- // two elements and returned the second (BUGS-2026-07 L12)
112
- if (next.isEmpty)
113
- return None;
114
- return Some(next.pollFirst());
115
- },
116
- dequeue() {
117
- if (next.isEmpty)
118
- return None;
119
- return tryCatch(() => next.dequeue(), () => "Deque is empty").match({
120
- Ok: (value) => Some(value),
121
- Err: () => None,
122
- });
123
- },
124
- peekFirst() {
125
- return next.isEmpty ? None : Some(next.peekFirst());
126
- },
127
- peekLast() {
128
- return next.isEmpty ? None : Some(next.peekLast());
129
- },
130
- pollFirst() {
131
- const result = next.pollFirst();
132
- return result !== undefined ? Some(result) : None;
133
- },
134
- pollLast() {
135
- const result = next.pollLast();
136
- return result !== undefined ? Some(result) : None;
137
- },
138
- pop() {
139
- if (next.isEmpty)
140
- return None;
141
- return tryCatch(() => next.pop(), () => "Deque is empty").match({
142
- Ok: (value) => Some(value),
143
- Err: () => None,
144
- });
145
- },
146
- };
147
- return Object.assign(next, { safe });
148
- };
149
- }
150
- /**
151
- * Creates a safe Map middleware.
152
- */
153
- export function safeMap() {
154
- return (next) => {
155
- const safe = {
156
- get(key) {
157
- return next.has(key) ? Some(next.get(key)) : None;
158
- },
159
- set(key, value) {
160
- return tryCatch(() => next.set(key, value), (error) => String(error));
161
- },
162
- delete(key) {
163
- return tryCatch(() => next.delete(key), (error) => String(error));
164
- },
165
- };
166
- return Object.assign(next, { safe });
167
- };
168
- }
169
- /**
170
- * Generic safe middleware that works with any collection.
171
- */
172
- export function safe() {
173
- // Return as-is for now; specialized versions handle specific types
174
- return (next) => next;
175
- }
176
- //# sourceMappingURL=safe.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"safe.js","sourceRoot":"","sources":["../../src/behaviors/safe.ts"],"names":[],"mappings":"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"}
@@ -1,88 +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
- import type { Middleware } from "../core/middleware.js";
24
- /**
25
- * Creates a synchronized middleware that locks all method calls.
26
- *
27
- * Every method call on the collection is wrapped with a mutex,
28
- * ensuring atomic execution even in concurrent async scenarios.
29
- *
30
- * @example
31
- * const syncList = compose(
32
- * synchronized()
33
- * )(arrayList<number>())
34
- *
35
- * // These additions are guaranteed to execute in order
36
- * await Promise.all([
37
- * syncList.add(1),
38
- * syncList.add(2),
39
- * syncList.add(3)
40
- * ])
41
- */
42
- export declare function synchronized<C extends object>(): Middleware<C>;
43
- /**
44
- * Alias for Java compatibility: synchronizedList
45
- */
46
- export declare const synchronizedList: typeof synchronized;
47
- /**
48
- * Alias for Java compatibility: synchronizedMap
49
- */
50
- export declare const synchronizedMap: typeof synchronized;
51
- /**
52
- * Alias for Java compatibility: synchronizedCollection
53
- */
54
- export declare const synchronizedCollection: typeof synchronized;
55
- /**
56
- * Alias for Java compatibility: synchronizedSet
57
- */
58
- export declare const synchronizedSet: typeof synchronized;
59
- /**
60
- * Advanced synchronized middleware with reentrant locking.
61
- *
62
- * Allows the same "thread" (async context) to acquire the lock multiple times.
63
- * Useful for methods that call other synchronized methods internally.
64
- *
65
- * Note: JavaScript doesn't have true thread IDs, so we use async context
66
- * tracking if available, or fall back to non-reentrant behavior.
67
- */
68
- export declare function reentrantSynchronized<C extends object>(): Middleware<C>;
69
- /**
70
- * Read-write lock implementation for collections.
71
- *
72
- * Allows multiple concurrent readers but exclusive writers.
73
- * More efficient than full synchronization for read-heavy workloads.
74
- *
75
- * @example
76
- * const list = compose(
77
- * readWriteLock()
78
- * )(arrayList<number>())
79
- *
80
- * // Multiple reads can happen concurrently
81
- * await Promise.all([
82
- * list.get(0),
83
- * list.get(1),
84
- * list.get(2)
85
- * ])
86
- */
87
- export declare function readWriteLock<C extends object>(): Middleware<C>;
88
- //# sourceMappingURL=synchronized.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"synchronized.d.ts","sourceRoot":"","sources":["../../src/behaviors/synchronized.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAoCxD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,CAgC9D;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAG,OAAO,YAA2B,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,eAAe,EAAG,OAAO,YAA2B,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAG,OAAO,YAA2B,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,eAAe,EAAG,OAAO,YAA2B,CAAC;AAElE;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,CA+CvE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,CA4G/D"}