@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,211 +0,0 @@
1
- /**
2
- * Go-style channels for CSP (Communicating Sequential Processes).
3
- *
4
- * Provides typed, bidirectional communication channels inspired by Go.
5
- * Perfect for coordinating async operations and implementing concurrent patterns.
6
- *
7
- * @example
8
- * const ch = channel<number>()
9
- *
10
- * // Sender
11
- * await ch.send(42)
12
- *
13
- * // Receiver
14
- * const value = await ch.receive()
15
- *
16
- * // Select from multiple channels
17
- * const result = await select(
18
- * ch1.case((v) => console.log('ch1:', v)),
19
- * ch2.case((v) => console.log('ch2:', v))
20
- * )
21
- */
22
- /**
23
- * Channel<T> - Bidirectional communication channel.
24
- *
25
- * Inspired by Go channels. Provides send/receive operations
26
- * that can block until the other side is ready.
27
- */
28
- export declare class Channel<T> {
29
- private queue;
30
- private _isClosed;
31
- constructor(bufferSize?: number);
32
- /**
33
- * Sends a value through the channel.
34
- * Blocks if channel buffer is full.
35
- *
36
- * @throws Error if channel is closed
37
- */
38
- send(value: T): Promise<void>;
39
- /**
40
- * Receives a value from the channel.
41
- * Blocks if no value is available.
42
- *
43
- * @throws Error if channel is closed and empty
44
- */
45
- receive(): Promise<T>;
46
- /**
47
- * This method waits for one value, as `receive` does, and gives it to `onValue`. When the
48
- * channel is closed and empty, it calls `onClosed`. These calls are synchronous: they occur in
49
- * the call that sends the value or closes the channel.
50
- *
51
- * The function that it returns withdraws the wait, so no later value goes to it.
52
- *
53
- * @returns A function that withdraws the wait. It returns true when the wait had no value yet.
54
- */
55
- waitReceive(onValue: (value: T) => void, onClosed: (error: Error) => void): () => boolean;
56
- /**
57
- * Attempts to send without blocking.
58
- * Returns false if channel is full.
59
- */
60
- trySend(value: T): boolean;
61
- /**
62
- * Attempts to receive without blocking.
63
- * Returns undefined if no value is available.
64
- */
65
- tryReceive(): T | undefined;
66
- /**
67
- * Closes the channel. No more values can be sent.
68
- * Receivers can still drain remaining values.
69
- */
70
- close(): void;
71
- get isClosed(): boolean;
72
- get size(): number;
73
- /**
74
- * Creates a select case for this channel.
75
- * Used with the select() function for multiplexing.
76
- */
77
- case<R>(handler: (value: T) => R): SelectCase<R>;
78
- /**
79
- * Async iteration over channel values.
80
- * Stops when channel is closed and empty.
81
- */
82
- [Symbol.asyncIterator](): AsyncIterator<T>;
83
- }
84
- /**
85
- * SelectCase represents a case in a select statement.
86
- */
87
- export interface SelectCase<R> {
88
- channel: Channel<any>;
89
- handler: (value: any) => R;
90
- tryReceive: () => any;
91
- receive: () => Promise<any>;
92
- /**
93
- * A wait for one value that `select` can withdraw: `Channel.waitReceive`. A case without it
94
- * uses the `waitReceive` method of its channel.
95
- */
96
- wait?: (onValue: (value: any) => void, onClosed: (error: Error) => void) => () => boolean;
97
- }
98
- /**
99
- * Selects from multiple channels (like Go's select statement).
100
- *
101
- * Waits for the first channel to have a value available,
102
- * then calls its handler and returns the result.
103
- *
104
- * The first case with a value at once wins. The cases that lose keep no receive: a value that
105
- * comes later stays in its channel for the next receiver. When the channel of a case is closed
106
- * and empty, the returned promise rejects.
107
- *
108
- * @example
109
- * const result = await select(
110
- * ch1.case((v) => `ch1: ${v}`),
111
- * ch2.case((v) => `ch2: ${v}`),
112
- * timeout(1000).case(() => 'timeout')
113
- * )
114
- */
115
- export declare function select<R>(...cases: SelectCase<R>[]): Promise<R>;
116
- /**
117
- * Creates a timeout channel that sends after the specified duration.
118
- *
119
- * @example
120
- * const result = await select(
121
- * dataChannel.case((v) => v),
122
- * timeout(5000).case(() => 'timeout!')
123
- * )
124
- */
125
- export declare function timeout(ms: number): Channel<void>;
126
- /**
127
- * Creates a ticker channel that sends at regular intervals.
128
- *
129
- * @example
130
- * const tick = ticker(1000) // Every second
131
- * for await (const t of tick) {
132
- * console.log('Tick:', t)
133
- * }
134
- */
135
- export declare function ticker(ms: number): Channel<number> & {
136
- stop: () => void;
137
- };
138
- /**
139
- * Pipeline: pipes values from input channel through transform to output channel.
140
- *
141
- * @example
142
- * const input = channel<number>()
143
- * const output = pipeline(input, (x) => x * 2)
144
- *
145
- * await input.send(5)
146
- * const result = await output.receive() // 10
147
- */
148
- export declare function pipeline<T, U>(input: Channel<T>, transform: (value: T) => U | Promise<U>, bufferSize?: number): Channel<U>;
149
- /**
150
- * Fan-out: distributes values from one input channel to multiple output channels.
151
- *
152
- * @example
153
- * const input = channel<number>()
154
- * const [out1, out2, out3] = fanOut(input, 3)
155
- *
156
- * // Each output gets a copy of every input value
157
- */
158
- export declare function fanOut<T>(input: Channel<T>, count: number, bufferSize?: number): Channel<T>[];
159
- /**
160
- * Fan-in: merges multiple input channels into one output channel.
161
- *
162
- * @example
163
- * const ch1 = channel<number>()
164
- * const ch2 = channel<number>()
165
- * const merged = fanIn(ch1, ch2)
166
- *
167
- * // merged receives values from both ch1 and ch2
168
- */
169
- export declare function fanIn<T>(...inputs: Channel<T>[]): Channel<T>;
170
- /**
171
- * Merge: like fanIn but closes output when first input closes.
172
- *
173
- * It takes one value at a time, from the inputs in turn, and keeps no receive on an input while
174
- * it waits for the reader of the output. So each value of each input reaches the output one
175
- * time, in the order of its input, or stays in its input.
176
- */
177
- export declare function merge<T>(...inputs: Channel<T>[]): Channel<T>;
178
- /**
179
- * Buffered channel with specified capacity.
180
- */
181
- export declare function buffered<T>(capacity: number): Channel<T>;
182
- /**
183
- * Unbuffered channel (rendezvous point).
184
- * Sends block until receiver is ready.
185
- */
186
- export declare function unbuffered<T>(): Channel<T>;
187
- /**
188
- * Factory function to create a channel.
189
- *
190
- * @example
191
- * const ch = channel<number>()
192
- * const bufferedCh = channel<string>(10)
193
- */
194
- export declare function channel<T>(bufferSize?: number): Channel<T>;
195
- /**
196
- * WorkerPool: distributes work across multiple workers.
197
- *
198
- * @example
199
- * const pool = workerPool(
200
- * jobChannel,
201
- * async (job) => await processJob(job),
202
- * { workers: 4 }
203
- * )
204
- *
205
- * // 4 workers concurrently process jobs from jobChannel
206
- */
207
- export declare function workerPool<T, R>(jobs: Channel<T>, worker: (job: T) => Promise<R>, options?: {
208
- workers: number;
209
- bufferSize?: number;
210
- }): Channel<R>;
211
- //# sourceMappingURL=channels.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../src/async/channels.ts"],"names":[],"mappings":"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"}
@@ -1,393 +0,0 @@
1
- /**
2
- * Go-style channels for CSP (Communicating Sequential Processes).
3
- *
4
- * Provides typed, bidirectional communication channels inspired by Go.
5
- * Perfect for coordinating async operations and implementing concurrent patterns.
6
- *
7
- * @example
8
- * const ch = channel<number>()
9
- *
10
- * // Sender
11
- * await ch.send(42)
12
- *
13
- * // Receiver
14
- * const value = await ch.receive()
15
- *
16
- * // Select from multiple channels
17
- * const result = await select(
18
- * ch1.case((v) => console.log('ch1:', v)),
19
- * ch2.case((v) => console.log('ch2:', v))
20
- * )
21
- */
22
- import { asyncQueue } from "./async-queue.js";
23
- /**
24
- * Channel<T> - Bidirectional communication channel.
25
- *
26
- * Inspired by Go channels. Provides send/receive operations
27
- * that can block until the other side is ready.
28
- */
29
- export class Channel {
30
- queue;
31
- _isClosed = false;
32
- constructor(bufferSize = 0) {
33
- // A buffer size of 0 is an unbuffered channel: send waits for a receiver (a rendezvous).
34
- // (Before, `bufferSize || 1` gave it a buffer of 1: BUGS-2026-07 L17.)
35
- this.queue = asyncQueue({ capacity: bufferSize });
36
- }
37
- /**
38
- * Sends a value through the channel.
39
- * Blocks if channel buffer is full.
40
- *
41
- * @throws Error if channel is closed
42
- */
43
- async send(value) {
44
- if (this._isClosed) {
45
- throw new Error("Cannot send on closed channel");
46
- }
47
- await this.queue.put(value);
48
- }
49
- /**
50
- * Receives a value from the channel.
51
- * Blocks if no value is available.
52
- *
53
- * @throws Error if channel is closed and empty
54
- */
55
- async receive() {
56
- return await this.queue.take();
57
- }
58
- /**
59
- * This method waits for one value, as `receive` does, and gives it to `onValue`. When the
60
- * channel is closed and empty, it calls `onClosed`. These calls are synchronous: they occur in
61
- * the call that sends the value or closes the channel.
62
- *
63
- * The function that it returns withdraws the wait, so no later value goes to it.
64
- *
65
- * @returns A function that withdraws the wait. It returns true when the wait had no value yet.
66
- */
67
- waitReceive(onValue, onClosed) {
68
- return this.queue.waitTake(onValue, onClosed);
69
- }
70
- /**
71
- * Attempts to send without blocking.
72
- * Returns false if channel is full.
73
- */
74
- trySend(value) {
75
- if (this._isClosed)
76
- return false;
77
- return this.queue.tryPut(value);
78
- }
79
- /**
80
- * Attempts to receive without blocking.
81
- * Returns undefined if no value is available.
82
- */
83
- tryReceive() {
84
- return this.queue.tryTake();
85
- }
86
- /**
87
- * Closes the channel. No more values can be sent.
88
- * Receivers can still drain remaining values.
89
- */
90
- close() {
91
- this._isClosed = true;
92
- this.queue.close();
93
- }
94
- get isClosed() {
95
- return this._isClosed;
96
- }
97
- get size() {
98
- return this.queue.size;
99
- }
100
- /**
101
- * Creates a select case for this channel.
102
- * Used with the select() function for multiplexing.
103
- */
104
- case(handler) {
105
- return {
106
- channel: this,
107
- handler,
108
- tryReceive: () => this.tryReceive(),
109
- receive: () => this.receive(),
110
- wait: (onValue, onClosed) => this.waitReceive(onValue, onClosed),
111
- };
112
- }
113
- /**
114
- * Async iteration over channel values.
115
- * Stops when channel is closed and empty.
116
- */
117
- async *[Symbol.asyncIterator]() {
118
- while (true) {
119
- try {
120
- yield await this.receive();
121
- }
122
- catch (e) {
123
- // Channel closed
124
- break;
125
- }
126
- }
127
- }
128
- }
129
- /**
130
- * This function gives the first value of the waits, with the index of its wait. It rejects with
131
- * the error of the first wait whose channel is closed and empty. It withdraws each other wait in
132
- * the same call, so a later value stays in its channel. (Before, the receives of the cases that
133
- * lost stayed in their channels and dropped the next value of each: audit O56.)
134
- */
135
- function firstOf(waits) {
136
- return new Promise((resolve, reject) => {
137
- const withdraws = [];
138
- let settled = false;
139
- const end = () => {
140
- settled = true;
141
- for (const withdraw of withdraws)
142
- withdraw();
143
- };
144
- // A wait can call back at once, in its own call, when its channel has a value or is closed
145
- try {
146
- for (let index = 0; index < waits.length && !settled; index++) {
147
- withdraws.push(waits[index]((value) => {
148
- if (settled)
149
- return;
150
- end();
151
- resolve({ index, value });
152
- }, (error) => {
153
- if (settled)
154
- return;
155
- end();
156
- reject(error);
157
- }));
158
- }
159
- }
160
- catch (error) {
161
- // A wait that throws: the waits before it are withdrawn
162
- if (!settled)
163
- end();
164
- reject(error);
165
- }
166
- });
167
- }
168
- /**
169
- * Selects from multiple channels (like Go's select statement).
170
- *
171
- * Waits for the first channel to have a value available,
172
- * then calls its handler and returns the result.
173
- *
174
- * The first case with a value at once wins. The cases that lose keep no receive: a value that
175
- * comes later stays in its channel for the next receiver. When the channel of a case is closed
176
- * and empty, the returned promise rejects.
177
- *
178
- * @example
179
- * const result = await select(
180
- * ch1.case((v) => `ch1: ${v}`),
181
- * ch2.case((v) => `ch2: ${v}`),
182
- * timeout(1000).case(() => 'timeout')
183
- * )
184
- */
185
- export async function select(...cases) {
186
- const { index, value } = await firstOf(cases.map((c) => c.wait ?? ((onValue, onClosed) => c.channel.waitReceive(onValue, onClosed))));
187
- // The handler runs after the race, not in the call of the sender
188
- return cases[index].handler(value);
189
- }
190
- /**
191
- * Creates a timeout channel that sends after the specified duration.
192
- *
193
- * @example
194
- * const result = await select(
195
- * dataChannel.case((v) => v),
196
- * timeout(5000).case(() => 'timeout!')
197
- * )
198
- */
199
- export function timeout(ms) {
200
- const ch = new Channel();
201
- setTimeout(() => {
202
- ch.send(undefined).catch(() => { }); // Ignore if closed
203
- ch.close();
204
- }, ms);
205
- return ch;
206
- }
207
- /**
208
- * Creates a ticker channel that sends at regular intervals.
209
- *
210
- * @example
211
- * const tick = ticker(1000) // Every second
212
- * for await (const t of tick) {
213
- * console.log('Tick:', t)
214
- * }
215
- */
216
- export function ticker(ms) {
217
- const ch = new Channel(1);
218
- let count = 0;
219
- const intervalId = setInterval(() => {
220
- ch.trySend(count++);
221
- }, ms);
222
- return Object.assign(ch, {
223
- stop: () => {
224
- clearInterval(intervalId);
225
- ch.close();
226
- },
227
- });
228
- }
229
- /**
230
- * Pipeline: pipes values from input channel through transform to output channel.
231
- *
232
- * @example
233
- * const input = channel<number>()
234
- * const output = pipeline(input, (x) => x * 2)
235
- *
236
- * await input.send(5)
237
- * const result = await output.receive() // 10
238
- */
239
- export function pipeline(input, transform, bufferSize = 0) {
240
- const output = new Channel(bufferSize);
241
- // The output closes also when the transform fails, so its reader does not wait forever. The
242
- // error goes to the console, as in workerPool. (Before, it was an unhandled rejection: audit pass 2.)
243
- (async () => {
244
- try {
245
- for await (const value of input) {
246
- const transformed = await transform(value);
247
- await output.send(transformed);
248
- }
249
- }
250
- finally {
251
- output.close();
252
- }
253
- })().catch((error) => console.error("pipeline error:", error));
254
- return output;
255
- }
256
- /**
257
- * Fan-out: distributes values from one input channel to multiple output channels.
258
- *
259
- * @example
260
- * const input = channel<number>()
261
- * const [out1, out2, out3] = fanOut(input, 3)
262
- *
263
- * // Each output gets a copy of every input value
264
- */
265
- export function fanOut(input, count, bufferSize = 0) {
266
- const outputs = Array.from({ length: count }, () => new Channel(bufferSize));
267
- (async () => {
268
- try {
269
- for await (const value of input) {
270
- await Promise.all(outputs.map((ch) => ch.send(value)));
271
- }
272
- }
273
- finally {
274
- outputs.forEach((ch) => ch.close());
275
- }
276
- })().catch((error) => console.error("fanOut error:", error));
277
- return outputs;
278
- }
279
- /**
280
- * Fan-in: merges multiple input channels into one output channel.
281
- *
282
- * @example
283
- * const ch1 = channel<number>()
284
- * const ch2 = channel<number>()
285
- * const merged = fanIn(ch1, ch2)
286
- *
287
- * // merged receives values from both ch1 and ch2
288
- */
289
- export function fanIn(...inputs) {
290
- const output = new Channel();
291
- const workers = inputs.map(async (input) => {
292
- for await (const value of input) {
293
- await output.send(value);
294
- }
295
- });
296
- // All the workers settle, then the output closes, also after a failed send
297
- Promise.allSettled(workers).then((results) => {
298
- output.close();
299
- for (const result of results)
300
- if (result.status === "rejected")
301
- console.error("fanIn error:", result.reason);
302
- });
303
- return output;
304
- }
305
- /**
306
- * Merge: like fanIn but closes output when first input closes.
307
- *
308
- * It takes one value at a time, from the inputs in turn, and keeps no receive on an input while
309
- * it waits for the reader of the output. So each value of each input reaches the output one
310
- * time, in the order of its input, or stays in its input.
311
- */
312
- export function merge(...inputs) {
313
- const output = new Channel();
314
- (async () => {
315
- // The input after the input of the last value comes first, so a busy input starves no other
316
- let start = 0;
317
- while (true) {
318
- const order = inputs.map((_, offset) => (start + offset) % inputs.length);
319
- let next;
320
- try {
321
- next = await firstOf(order.map((index) => (onValue, onClosed) => inputs[index].waitReceive(onValue, onClosed)));
322
- }
323
- catch {
324
- // An input is closed and empty
325
- break;
326
- }
327
- const index = order[next.index];
328
- start = (index + 1) % inputs.length;
329
- try {
330
- await output.send(next.value);
331
- }
332
- catch {
333
- // The reader closed the output
334
- break;
335
- }
336
- }
337
- output.close();
338
- })();
339
- return output;
340
- }
341
- /**
342
- * Buffered channel with specified capacity.
343
- */
344
- export function buffered(capacity) {
345
- return new Channel(capacity);
346
- }
347
- /**
348
- * Unbuffered channel (rendezvous point).
349
- * Sends block until receiver is ready.
350
- */
351
- export function unbuffered() {
352
- return new Channel(0);
353
- }
354
- /**
355
- * Factory function to create a channel.
356
- *
357
- * @example
358
- * const ch = channel<number>()
359
- * const bufferedCh = channel<string>(10)
360
- */
361
- export function channel(bufferSize = 0) {
362
- return new Channel(bufferSize);
363
- }
364
- /**
365
- * WorkerPool: distributes work across multiple workers.
366
- *
367
- * @example
368
- * const pool = workerPool(
369
- * jobChannel,
370
- * async (job) => await processJob(job),
371
- * { workers: 4 }
372
- * )
373
- *
374
- * // 4 workers concurrently process jobs from jobChannel
375
- */
376
- export function workerPool(jobs, worker, options = { workers: 1 }) {
377
- const results = new Channel(options.bufferSize || 0);
378
- const { workers: workerCount } = options;
379
- const workers = Array.from({ length: workerCount }, async () => {
380
- for await (const job of jobs) {
381
- try {
382
- const result = await worker(job);
383
- await results.send(result);
384
- }
385
- catch (error) {
386
- console.error("Worker error:", error);
387
- }
388
- }
389
- });
390
- Promise.all(workers).then(() => results.close());
391
- return results;
392
- }
393
- //# sourceMappingURL=channels.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"channels.js","sourceRoot":"","sources":["../../src/async/channels.ts"],"names":[],"mappings":"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"}
@@ -1,23 +0,0 @@
1
- /**
2
- * asSettled - The results of running promises, in the order that they settle.
3
- *
4
- * @example
5
- * const pages = urls.map((url) => fetch(url));
6
- * for await (const result of asSettled(pages)) {
7
- * if (result.status === "fulfilled") show(result.index, result.value);
8
- * else report(result.index, result.reason);
9
- * }
10
- */
11
- /** One result of `asSettled`: the index of its promise in the input, and how the promise settled. */
12
- export type Settled<T> = {
13
- readonly index: number;
14
- } & PromiseSettledResult<T>;
15
- /**
16
- * This function gives the result of each promise when it settles, in settle order, not in input
17
- * order. The promises run already: this function starts nothing. Each result has the index of its
18
- * promise in the input. A rejected promise gives `status: "rejected"` and its reason: the
19
- * generator does not throw it. When the consumer stops early, the other promises continue, and
20
- * their rejections are not reported as unhandled.
21
- */
22
- export declare function asSettled<T>(promises: Iterable<Promise<T>>): AsyncGenerator<Settled<T>, void, undefined>;
23
- //# sourceMappingURL=settled.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"settled.d.ts","sourceRoot":"","sources":["../../src/async/settled.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,qGAAqG;AACrG,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAE9E;;;;;;GAMG;AACH,wBAAuB,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAmB/G"}
@@ -1,32 +0,0 @@
1
- /**
2
- * asSettled - The results of running promises, in the order that they settle.
3
- *
4
- * @example
5
- * const pages = urls.map((url) => fetch(url));
6
- * for await (const result of asSettled(pages)) {
7
- * if (result.status === "fulfilled") show(result.index, result.value);
8
- * else report(result.index, result.reason);
9
- * }
10
- */
11
- /**
12
- * This function gives the result of each promise when it settles, in settle order, not in input
13
- * order. The promises run already: this function starts nothing. Each result has the index of its
14
- * promise in the input. A rejected promise gives `status: "rejected"` and its reason: the
15
- * generator does not throw it. When the consumer stops early, the other promises continue, and
16
- * their rejections are not reported as unhandled.
17
- */
18
- export async function* asSettled(promises) {
19
- const pending = new Map();
20
- let next = 0;
21
- for (const promise of promises) {
22
- const index = next;
23
- next += 1;
24
- pending.set(index, Promise.resolve(promise).then((value) => ({ index, status: "fulfilled", value }), (reason) => ({ index, status: "rejected", reason })));
25
- }
26
- while (pending.size > 0) {
27
- const settled = await Promise.race(pending.values());
28
- pending.delete(settled.index);
29
- yield settled;
30
- }
31
- }
32
- //# sourceMappingURL=settled.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"settled.js","sourceRoot":"","sources":["../../src/async/settled.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,SAAS,CAAI,QAA8B;IAChE,MAAM,OAAO,GAAG,IAAI,GAAG,EAA+B,CAAC;IACvD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC;QACnB,IAAI,IAAI,CAAC,CAAC;QACV,OAAO,CAAC,GAAG,CACT,KAAK,EACL,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAC3B,CAAC,KAAK,EAAc,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EAC9D,CAAC,MAAe,EAAc,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CACzE,CACF,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACrD,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,MAAM,OAAO,CAAC;IAChB,CAAC;AACH,CAAC"}