@procedures/collections 0.47.1 → 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 (238) hide show
  1. package/CHANGELOG.md +18 -8
  2. package/README.md +2 -0
  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 +4 -4
  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,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"}