@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,180 +0,0 @@
1
- /**
2
- * Functional effect types for error handling and optional values.
3
- *
4
- * Provides Option<T> and Result<T,E> types for explicit, type-safe
5
- * error handling without exceptions. Includes async variants.
6
- */
7
- /**
8
- * The singleton None value.
9
- */
10
- export const None = Object.freeze({ _tag: "None" });
11
- /**
12
- * Constructs a Some value containing the given value.
13
- */
14
- export const Some = (value) => Object.freeze({ _tag: "Some", value });
15
- /**
16
- * Type guard to check if an Option is None.
17
- */
18
- export const isNone = (opt) => opt._tag === "None";
19
- /**
20
- * Type guard to check if an Option is Some.
21
- */
22
- export const isSome = (opt) => opt._tag === "Some";
23
- /**
24
- * Extracts the value from a Some, or returns the default value if None.
25
- */
26
- export const getOrElse = (opt, defaultValue) => isSome(opt) ? opt.value : defaultValue;
27
- /**
28
- * Extracts the value from a Some, or throws an error if None.
29
- */
30
- export const unwrap = (opt) => {
31
- if (isSome(opt))
32
- return opt.value;
33
- throw new Error("Called unwrap on None");
34
- };
35
- /**
36
- * Maps a function over the value in a Some, or returns None.
37
- */
38
- export const mapOption = (opt, f) => (isSome(opt) ? Some(f(opt.value)) : None);
39
- /**
40
- * Chains Option-returning operations.
41
- */
42
- export const flatMapOption = (opt, f) => (isSome(opt) ? f(opt.value) : None);
43
- /**
44
- * Converts a nullable value to an Option.
45
- */
46
- export const fromNullable = (value) => value == null ? None : Some(value);
47
- /**
48
- * Converts an Option to a nullable value.
49
- */
50
- export const toNullable = (opt) => isSome(opt) ? opt.value : undefined;
51
- /**
52
- * Constructs an Ok result containing the given value.
53
- */
54
- export const Ok = (value) => Object.freeze({
55
- _tag: "Ok",
56
- value,
57
- match: (f) => f.Ok(value),
58
- });
59
- /**
60
- * Constructs an Err result containing the given error.
61
- */
62
- export const Err = (error) => Object.freeze({
63
- _tag: "Err",
64
- error,
65
- match: (f) => f.Err(error),
66
- });
67
- /**
68
- * Type guard to check if a Result is Ok.
69
- */
70
- export const isOk = (result) => result._tag === "Ok";
71
- /**
72
- * Type guard to check if a Result is Err.
73
- */
74
- export const isErr = (result) => result._tag === "Err";
75
- /**
76
- * Extracts the value from an Ok, or returns the default value if Err.
77
- */
78
- export const getOrElseResult = (result, defaultValue) => (isOk(result) ? result.value : defaultValue);
79
- /**
80
- * Extracts the value from an Ok, or throws the error if Err.
81
- */
82
- export const unwrapResult = (result) => {
83
- if (isOk(result))
84
- return result.value;
85
- throw result.error;
86
- };
87
- /**
88
- * Maps a function over the value in an Ok, or returns the Err unchanged.
89
- */
90
- export const mapResult = (result, f) => (isOk(result) ? Ok(f(result.value)) : result);
91
- /**
92
- * Maps a function over the error in an Err, or returns the Ok unchanged.
93
- */
94
- export const mapError = (result, f) => (isErr(result) ? Err(f(result.error)) : result);
95
- /**
96
- * Chains Result-returning operations.
97
- */
98
- export const flatMapResult = (result, f) => (isOk(result) ? f(result.value) : result);
99
- /**
100
- * Converts a throwing function into a Result-returning function.
101
- */
102
- export const tryCatch = (fn, onError) => {
103
- try {
104
- return Ok(fn());
105
- }
106
- catch (error) {
107
- return Err((onError ? onError(error) : error));
108
- }
109
- };
110
- /**
111
- * Converts an async throwing function into a Result-returning async function.
112
- */
113
- export const tryCatchAsync = async (fn, onError) => {
114
- try {
115
- return Ok(await fn());
116
- }
117
- catch (error) {
118
- return Err((onError ? onError(error) : error));
119
- }
120
- };
121
- /**
122
- * Maps a function over an async Option.
123
- */
124
- export const mapAsyncOption = async (opt, f) => {
125
- const resolved = await opt;
126
- if (isSome(resolved)) {
127
- return Some(await f(resolved.value));
128
- }
129
- return None;
130
- };
131
- /**
132
- * Maps a function over an async Result.
133
- */
134
- export const mapAsyncResult = async (result, f) => {
135
- const resolved = await result;
136
- if (isOk(resolved)) {
137
- return Ok(await f(resolved.value));
138
- }
139
- return resolved;
140
- };
141
- // ============================================================================
142
- // Conversion utilities
143
- // ============================================================================
144
- /**
145
- * Converts an Option to a Result.
146
- * None becomes Err with the provided error.
147
- */
148
- export const optionToResult = (opt, error) => isSome(opt) ? Ok(opt.value) : Err(error);
149
- /**
150
- * Converts a Result to an Option.
151
- * Err becomes None, discarding the error.
152
- */
153
- export const resultToOption = (result) => isOk(result) ? Some(result.value) : None;
154
- /**
155
- * Combines multiple Options into an Option of an array.
156
- * Returns None if any input is None.
157
- */
158
- export const sequence = (opts) => {
159
- const values = [];
160
- for (const opt of opts) {
161
- if (isNone(opt))
162
- return None;
163
- values.push(opt.value);
164
- }
165
- return Some(values);
166
- };
167
- /**
168
- * Combines multiple Results into a Result of an array.
169
- * Returns the first Err encountered, or Ok with all values.
170
- */
171
- export const sequenceResults = (results) => {
172
- const values = [];
173
- for (const result of results) {
174
- if (isErr(result))
175
- return result;
176
- values.push(result.value);
177
- }
178
- return Ok(values);
179
- };
180
- //# sourceMappingURL=effects.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"effects.js","sourceRoot":"","sources":["../../src/core/effects.ts"],"names":[],"mappings":"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"}
@@ -1,192 +0,0 @@
1
- /**
2
- * Typed event emitter system for collections.
3
- *
4
- * Provides a lightweight, type-safe event system for mutation events
5
- * and other observable behavior. Events are strongly typed using
6
- * TypeScript's mapped types.
7
- */
8
- /**
9
- * A listener function that receives an event payload.
10
- */
11
- export type Listener<P> = (payload: P) => void;
12
- /**
13
- * A function to unsubscribe from an event.
14
- */
15
- export type Unsubscribe = () => void;
16
- /**
17
- * Event map defining event names and their payload types.
18
- *
19
- * @example
20
- * interface MyEvents {
21
- * add: { value: number; index: number }
22
- * remove: { value: number }
23
- * clear: {}
24
- * }
25
- */
26
- export type EventMap = Record<string, any>;
27
- /**
28
- * Type-safe event emitter.
29
- *
30
- * Supports subscribing to events, emitting events, and managing listeners.
31
- * All event names and payloads are type-checked at compile time.
32
- *
33
- * @example
34
- * interface ListEvents<T> {
35
- * add: { value: T; index: number }
36
- * remove: { value: T; index: number }
37
- * clear: {}
38
- * }
39
- *
40
- * const emitter = new Emitter<ListEvents<number>>()
41
- *
42
- * const unsub = emitter.on('add', ({ value, index }) => {
43
- * console.log(`Added ${value} at ${index}`)
44
- * })
45
- *
46
- * emitter.emit('add', { value: 42, index: 0 })
47
- * unsub() // Unsubscribe
48
- */
49
- export declare class Emitter<E extends EventMap> {
50
- private listeners;
51
- /**
52
- * Subscribe to an event.
53
- *
54
- * @param event The event name
55
- * @param listener The callback to invoke when event is emitted
56
- * @returns A function to unsubscribe
57
- */
58
- on<K extends keyof E>(event: K, listener: Listener<E[K]>): Unsubscribe;
59
- /**
60
- * Subscribe to an event, but automatically unsubscribe after first emission.
61
- *
62
- * @param event The event name
63
- * @param listener The callback to invoke once
64
- * @returns A function to unsubscribe (in case you want to cancel before emission)
65
- */
66
- once<K extends keyof E>(event: K, listener: Listener<E[K]>): Unsubscribe;
67
- /**
68
- * Emit an event to all registered listeners.
69
- *
70
- * @param event The event name
71
- * @param payload The event payload
72
- */
73
- emit<K extends keyof E>(event: K, payload: E[K]): void;
74
- /**
75
- * Remove all listeners for a specific event, or all events if no event specified.
76
- *
77
- * @param event Optional event name to clear listeners for
78
- */
79
- off<K extends keyof E>(event?: K): void;
80
- /**
81
- * Get the number of listeners for a specific event.
82
- *
83
- * @param event The event name
84
- * @returns Number of registered listeners
85
- */
86
- listenerCount<K extends keyof E>(event: K): number;
87
- /**
88
- * Get all event names that have at least one listener.
89
- */
90
- eventNames(): (keyof E)[];
91
- /**
92
- * Check if there are any listeners for a specific event.
93
- */
94
- hasListeners<K extends keyof E>(event: K): boolean;
95
- /**
96
- * Remove all listeners and clean up resources.
97
- */
98
- dispose(): void;
99
- }
100
- /**
101
- * Create an event emitter for a specific event map.
102
- *
103
- * This is a convenience factory function.
104
- *
105
- * @example
106
- * const events = createEmitter<ListEvents<number>>()
107
- */
108
- export declare const createEmitter: <E extends EventMap>() => Emitter<E>;
109
- /**
110
- * Event batching utility for reducing event noise.
111
- * Collects events and emits them in batches.
112
- *
113
- * @example
114
- * const batcher = new EventBatcher(emitter, 'add', 100)
115
- * batcher.queue({ value: 1, index: 0 })
116
- * batcher.queue({ value: 2, index: 1 })
117
- * // After 100ms or flush(), emits single 'batch-add' event with both items
118
- */
119
- export declare class EventBatcher<E extends EventMap, K extends keyof E> {
120
- private emitter;
121
- private event;
122
- private delayMs;
123
- private batch;
124
- private timer;
125
- constructor(emitter: Emitter<E & {
126
- [P in `batch-${K & string}`]: E[K][];
127
- }>, event: K, delayMs: number);
128
- /**
129
- * Add an event to the current batch.
130
- */
131
- queue(payload: E[K]): void;
132
- /**
133
- * Immediately emit all batched events.
134
- */
135
- flush(): void;
136
- /**
137
- * Clean up resources.
138
- */
139
- dispose(): void;
140
- }
141
- /**
142
- * Async event emitter that returns promises.
143
- * Waits for all async listeners to complete.
144
- *
145
- * @example
146
- * const emitter = new AsyncEmitter<{ save: { data: string } }>()
147
- *
148
- * emitter.on('save', async ({ data }) => {
149
- * await database.save(data)
150
- * })
151
- *
152
- * await emitter.emit('save', { data: 'test' }) // Waits for save
153
- */
154
- export declare class AsyncEmitter<E extends EventMap> {
155
- private listeners;
156
- on<K extends keyof E>(event: K, listener: Listener<E[K]>): Unsubscribe;
157
- /**
158
- * Emit an event and wait for all async listeners to complete.
159
- *
160
- * @param event The event name
161
- * @param payload The event payload
162
- * @returns Promise that resolves when all listeners complete
163
- */
164
- emit<K extends keyof E>(event: K, payload: E[K]): Promise<void>;
165
- off<K extends keyof E>(event?: K): void;
166
- listenerCount<K extends keyof E>(event: K): number;
167
- eventNames(): (keyof E)[];
168
- dispose(): void;
169
- }
170
- /**
171
- * Utility to forward events from one emitter to another.
172
- * Useful for composing event sources.
173
- *
174
- * @example
175
- * const child = new Emitter<ChildEvents>()
176
- * const parent = new Emitter<ParentEvents>()
177
- *
178
- * forwardEvent(child, parent, 'childEvent', 'parentEvent')
179
- */
180
- export declare const forwardEvent: <E1 extends EventMap, E2 extends EventMap, K1 extends keyof E1, K2 extends keyof E2>(source: Emitter<E1>, target: Emitter<E2>, sourceEvent: K1, targetEvent: K2, transform?: (payload: E1[K1]) => E2[K2]) => Unsubscribe;
181
- /**
182
- * Create a filtered event subscription that only fires when predicate is true.
183
- *
184
- * @example
185
- * const emitter = new Emitter<{ change: { value: number } }>()
186
- *
187
- * onWhen(emitter, 'change', ({ value }) => value > 10, ({ value }) => {
188
- * console.log('Value exceeded 10:', value)
189
- * })
190
- */
191
- export declare const onWhen: <E extends EventMap, K extends keyof E>(emitter: Emitter<E>, event: K, predicate: (payload: E[K]) => boolean, listener: Listener<E[K]>) => Unsubscribe;
192
- //# sourceMappingURL=events.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/core/events.ts"],"names":[],"mappings":"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"}
@@ -1,291 +0,0 @@
1
- /**
2
- * Typed event emitter system for collections.
3
- *
4
- * Provides a lightweight, type-safe event system for mutation events
5
- * and other observable behavior. Events are strongly typed using
6
- * TypeScript's mapped types.
7
- */
8
- /**
9
- * Type-safe event emitter.
10
- *
11
- * Supports subscribing to events, emitting events, and managing listeners.
12
- * All event names and payloads are type-checked at compile time.
13
- *
14
- * @example
15
- * interface ListEvents<T> {
16
- * add: { value: T; index: number }
17
- * remove: { value: T; index: number }
18
- * clear: {}
19
- * }
20
- *
21
- * const emitter = new Emitter<ListEvents<number>>()
22
- *
23
- * const unsub = emitter.on('add', ({ value, index }) => {
24
- * console.log(`Added ${value} at ${index}`)
25
- * })
26
- *
27
- * emitter.emit('add', { value: 42, index: 0 })
28
- * unsub() // Unsubscribe
29
- */
30
- export class Emitter {
31
- listeners = new Map();
32
- /**
33
- * Subscribe to an event.
34
- *
35
- * @param event The event name
36
- * @param listener The callback to invoke when event is emitted
37
- * @returns A function to unsubscribe
38
- */
39
- on(event, listener) {
40
- let listeners = this.listeners.get(event);
41
- if (!listeners) {
42
- listeners = new Set();
43
- this.listeners.set(event, listeners);
44
- }
45
- listeners.add(listener);
46
- // Return unsubscribe function
47
- return () => {
48
- listeners.delete(listener);
49
- // Clean up empty sets
50
- if (listeners.size === 0) {
51
- this.listeners.delete(event);
52
- }
53
- };
54
- }
55
- /**
56
- * Subscribe to an event, but automatically unsubscribe after first emission.
57
- *
58
- * @param event The event name
59
- * @param listener The callback to invoke once
60
- * @returns A function to unsubscribe (in case you want to cancel before emission)
61
- */
62
- once(event, listener) {
63
- const wrappedListener = (payload) => {
64
- unsubscribe();
65
- listener(payload);
66
- };
67
- const unsubscribe = this.on(event, wrappedListener);
68
- return unsubscribe;
69
- }
70
- /**
71
- * Emit an event to all registered listeners.
72
- *
73
- * @param event The event name
74
- * @param payload The event payload
75
- */
76
- emit(event, payload) {
77
- const listeners = this.listeners.get(event);
78
- if (listeners) {
79
- // Create a snapshot to avoid issues if listeners modify the set
80
- const snapshot = Array.from(listeners);
81
- for (const listener of snapshot) {
82
- try {
83
- listener(payload);
84
- }
85
- catch (error) {
86
- // Log error but don't stop other listeners
87
- console.error(`Error in event listener for '${String(event)}':`, error);
88
- }
89
- }
90
- }
91
- }
92
- /**
93
- * Remove all listeners for a specific event, or all events if no event specified.
94
- *
95
- * @param event Optional event name to clear listeners for
96
- */
97
- off(event) {
98
- if (event !== undefined) {
99
- this.listeners.delete(event);
100
- }
101
- else {
102
- this.listeners.clear();
103
- }
104
- }
105
- /**
106
- * Get the number of listeners for a specific event.
107
- *
108
- * @param event The event name
109
- * @returns Number of registered listeners
110
- */
111
- listenerCount(event) {
112
- return this.listeners.get(event)?.size ?? 0;
113
- }
114
- /**
115
- * Get all event names that have at least one listener.
116
- */
117
- eventNames() {
118
- return Array.from(this.listeners.keys());
119
- }
120
- /**
121
- * Check if there are any listeners for a specific event.
122
- */
123
- hasListeners(event) {
124
- return this.listenerCount(event) > 0;
125
- }
126
- /**
127
- * Remove all listeners and clean up resources.
128
- */
129
- dispose() {
130
- this.listeners.clear();
131
- }
132
- }
133
- /**
134
- * Create an event emitter for a specific event map.
135
- *
136
- * This is a convenience factory function.
137
- *
138
- * @example
139
- * const events = createEmitter<ListEvents<number>>()
140
- */
141
- export const createEmitter = () => {
142
- return new Emitter();
143
- };
144
- /**
145
- * Event batching utility for reducing event noise.
146
- * Collects events and emits them in batches.
147
- *
148
- * @example
149
- * const batcher = new EventBatcher(emitter, 'add', 100)
150
- * batcher.queue({ value: 1, index: 0 })
151
- * batcher.queue({ value: 2, index: 1 })
152
- * // After 100ms or flush(), emits single 'batch-add' event with both items
153
- */
154
- export class EventBatcher {
155
- emitter;
156
- event;
157
- delayMs;
158
- batch = [];
159
- timer = null;
160
- constructor(emitter, event, delayMs) {
161
- this.emitter = emitter;
162
- this.event = event;
163
- this.delayMs = delayMs;
164
- }
165
- /**
166
- * Add an event to the current batch.
167
- */
168
- queue(payload) {
169
- this.batch.push(payload);
170
- if (this.timer === null) {
171
- this.timer = setTimeout(() => this.flush(), this.delayMs);
172
- }
173
- }
174
- /**
175
- * Immediately emit all batched events.
176
- */
177
- flush() {
178
- if (this.timer !== null) {
179
- clearTimeout(this.timer);
180
- this.timer = null;
181
- }
182
- if (this.batch.length > 0) {
183
- const batchEvent = `batch-${String(this.event)}`;
184
- this.emitter.emit(batchEvent, this.batch);
185
- this.batch = [];
186
- }
187
- }
188
- /**
189
- * Clean up resources.
190
- */
191
- dispose() {
192
- this.flush();
193
- }
194
- }
195
- /**
196
- * Async event emitter that returns promises.
197
- * Waits for all async listeners to complete.
198
- *
199
- * @example
200
- * const emitter = new AsyncEmitter<{ save: { data: string } }>()
201
- *
202
- * emitter.on('save', async ({ data }) => {
203
- * await database.save(data)
204
- * })
205
- *
206
- * await emitter.emit('save', { data: 'test' }) // Waits for save
207
- */
208
- export class AsyncEmitter {
209
- listeners = new Map();
210
- on(event, listener) {
211
- let listeners = this.listeners.get(event);
212
- if (!listeners) {
213
- listeners = new Set();
214
- this.listeners.set(event, listeners);
215
- }
216
- listeners.add(listener);
217
- return () => {
218
- listeners.delete(listener);
219
- if (listeners.size === 0) {
220
- this.listeners.delete(event);
221
- }
222
- };
223
- }
224
- /**
225
- * Emit an event and wait for all async listeners to complete.
226
- *
227
- * @param event The event name
228
- * @param payload The event payload
229
- * @returns Promise that resolves when all listeners complete
230
- */
231
- async emit(event, payload) {
232
- const listeners = this.listeners.get(event);
233
- if (listeners) {
234
- const promises = Array.from(listeners).map((listener) => Promise.resolve().then(() => listener(payload)));
235
- await Promise.all(promises);
236
- }
237
- }
238
- off(event) {
239
- if (event !== undefined) {
240
- this.listeners.delete(event);
241
- }
242
- else {
243
- this.listeners.clear();
244
- }
245
- }
246
- listenerCount(event) {
247
- return this.listeners.get(event)?.size ?? 0;
248
- }
249
- eventNames() {
250
- return Array.from(this.listeners.keys());
251
- }
252
- dispose() {
253
- this.listeners.clear();
254
- }
255
- }
256
- /**
257
- * Utility to forward events from one emitter to another.
258
- * Useful for composing event sources.
259
- *
260
- * @example
261
- * const child = new Emitter<ChildEvents>()
262
- * const parent = new Emitter<ParentEvents>()
263
- *
264
- * forwardEvent(child, parent, 'childEvent', 'parentEvent')
265
- */
266
- export const forwardEvent = (source, target, sourceEvent, targetEvent, transform) => {
267
- return source.on(sourceEvent, (payload) => {
268
- const transformedPayload = transform
269
- ? transform(payload)
270
- : payload;
271
- target.emit(targetEvent, transformedPayload);
272
- });
273
- };
274
- /**
275
- * Create a filtered event subscription that only fires when predicate is true.
276
- *
277
- * @example
278
- * const emitter = new Emitter<{ change: { value: number } }>()
279
- *
280
- * onWhen(emitter, 'change', ({ value }) => value > 10, ({ value }) => {
281
- * console.log('Value exceeded 10:', value)
282
- * })
283
- */
284
- export const onWhen = (emitter, event, predicate, listener) => {
285
- return emitter.on(event, (payload) => {
286
- if (predicate(payload)) {
287
- listener(payload);
288
- }
289
- });
290
- };
291
- //# sourceMappingURL=events.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/core/events.ts"],"names":[],"mappings":"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"}