@procedures/collections 0.47.1 → 0.48.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (238) hide show
  1. package/CHANGELOG.md +32 -8
  2. package/README.md +3 -1
  3. package/dist/.tsbuildinfo +1 -1
  4. package/dist/index.d.ts +1 -59
  5. package/dist/index.d.ts.map +1 -1
  6. package/dist/index.js +3 -95
  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 +5 -5
  27. package/src/index.ts +338 -214
  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/summary-tree.d.ts +0 -146
  139. package/dist/impl/summary-tree.d.ts.map +0 -1
  140. package/dist/impl/summary-tree.js +0 -524
  141. package/dist/impl/summary-tree.js.map +0 -1
  142. package/dist/impl/tree-map.d.ts +0 -153
  143. package/dist/impl/tree-map.d.ts.map +0 -1
  144. package/dist/impl/tree-map.js +0 -788
  145. package/dist/impl/tree-map.js.map +0 -1
  146. package/dist/impl/tree-set.d.ts +0 -112
  147. package/dist/impl/tree-set.d.ts.map +0 -1
  148. package/dist/impl/tree-set.js +0 -374
  149. package/dist/impl/tree-set.js.map +0 -1
  150. package/dist/interfaces/collection.d.ts +0 -119
  151. package/dist/interfaces/collection.d.ts.map +0 -1
  152. package/dist/interfaces/collection.js +0 -8
  153. package/dist/interfaces/collection.js.map +0 -1
  154. package/dist/interfaces/list.d.ts +0 -247
  155. package/dist/interfaces/list.d.ts.map +0 -1
  156. package/dist/interfaces/list.js +0 -8
  157. package/dist/interfaces/list.js.map +0 -1
  158. package/dist/interfaces/map.d.ts +0 -344
  159. package/dist/interfaces/map.d.ts.map +0 -1
  160. package/dist/interfaces/map.js +0 -8
  161. package/dist/interfaces/map.js.map +0 -1
  162. package/dist/interfaces/queue.d.ts +0 -304
  163. package/dist/interfaces/queue.d.ts.map +0 -1
  164. package/dist/interfaces/queue.js +0 -8
  165. package/dist/interfaces/queue.js.map +0 -1
  166. package/dist/interfaces/set.d.ts +0 -137
  167. package/dist/interfaces/set.d.ts.map +0 -1
  168. package/dist/interfaces/set.js +0 -8
  169. package/dist/interfaces/set.js.map +0 -1
  170. package/dist/order/index.d.ts +0 -7
  171. package/dist/order/index.d.ts.map +0 -1
  172. package/dist/order/index.js +0 -7
  173. package/dist/order/index.js.map +0 -1
  174. package/dist/order/rank.d.ts +0 -100
  175. package/dist/order/rank.d.ts.map +0 -1
  176. package/dist/order/rank.js +0 -286
  177. package/dist/order/rank.js.map +0 -1
  178. package/dist/storage/listeners.d.ts +0 -39
  179. package/dist/storage/listeners.d.ts.map +0 -1
  180. package/dist/storage/listeners.js +0 -65
  181. package/dist/storage/listeners.js.map +0 -1
  182. package/dist/testing/check.d.ts +0 -25
  183. package/dist/testing/check.d.ts.map +0 -1
  184. package/dist/testing/check.js +0 -85
  185. package/dist/testing/check.js.map +0 -1
  186. package/dist/utils/defaults.d.ts +0 -135
  187. package/dist/utils/defaults.d.ts.map +0 -1
  188. package/dist/utils/defaults.js +0 -322
  189. package/dist/utils/defaults.js.map +0 -1
  190. package/dist/utils/factories.d.ts +0 -144
  191. package/dist/utils/factories.d.ts.map +0 -1
  192. package/dist/utils/factories.js +0 -293
  193. package/dist/utils/factories.js.map +0 -1
  194. package/dist/utils/helpers.d.ts +0 -137
  195. package/dist/utils/helpers.d.ts.map +0 -1
  196. package/dist/utils/helpers.js +0 -221
  197. package/dist/utils/helpers.js.map +0 -1
  198. package/src/async/async-queue.ts +0 -481
  199. package/src/async/channels.ts +0 -450
  200. package/src/async/settled.ts +0 -41
  201. package/src/behaviors/bounded.ts +0 -485
  202. package/src/behaviors/composite.ts +0 -99
  203. package/src/behaviors/evented.ts +0 -464
  204. package/src/behaviors/lru.ts +0 -447
  205. package/src/behaviors/readonly.ts +0 -236
  206. package/src/behaviors/safe.ts +0 -372
  207. package/src/behaviors/synchronized.ts +0 -316
  208. package/src/behaviors/ttl.ts +0 -462
  209. package/src/contracts/model.ts +0 -44
  210. package/src/core/effects.ts +0 -323
  211. package/src/core/events.ts +0 -356
  212. package/src/core/middleware.ts +0 -415
  213. package/src/core/policies.ts +0 -316
  214. package/src/core/traits.ts +0 -164
  215. package/src/fx/collectors.ts +0 -500
  216. package/src/fx/iter.ts +0 -536
  217. package/src/impl/array-deque.ts +0 -463
  218. package/src/impl/array-list.ts +0 -490
  219. package/src/impl/hash-map.ts +0 -623
  220. package/src/impl/hash-set.ts +0 -342
  221. package/src/impl/linked-hash-map.ts +0 -572
  222. package/src/impl/linked-list.ts +0 -606
  223. package/src/impl/priority-queue.ts +0 -448
  224. package/src/impl/summary-tree.ts +0 -586
  225. package/src/impl/tree-map.ts +0 -912
  226. package/src/impl/tree-set.ts +0 -469
  227. package/src/interfaces/collection.ts +0 -141
  228. package/src/interfaces/list.ts +0 -281
  229. package/src/interfaces/map.ts +0 -405
  230. package/src/interfaces/queue.ts +0 -353
  231. package/src/interfaces/set.ts +0 -158
  232. package/src/order/index.ts +0 -6
  233. package/src/order/rank.ts +0 -271
  234. package/src/storage/listeners.ts +0 -72
  235. package/src/testing/check.ts +0 -81
  236. package/src/utils/defaults.ts +0 -345
  237. package/src/utils/factories.ts +0 -357
  238. 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"}