@procedures/client 0.2.0 → 0.2.1

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 (236) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/README.md +4 -4
  3. package/dist/.tsbuildinfo +1 -1
  4. package/dist/browser.d.ts +1 -1
  5. package/dist/browser.d.ts.map +1 -1
  6. package/dist/browser.js.map +1 -1
  7. package/dist/procedures/invoke.d.ts +6 -1
  8. package/dist/procedures/invoke.d.ts.map +1 -1
  9. package/dist/procedures/invoke.js +2 -2
  10. package/dist/procedures/invoke.js.map +1 -1
  11. package/dist/server/host-policy.d.ts +3 -3
  12. package/dist/server/host-policy.d.ts.map +1 -1
  13. package/dist/server/procedure-server.d.ts +2 -2
  14. package/dist/server/procedure-server.d.ts.map +1 -1
  15. package/dist/server/procedure-server.js.map +1 -1
  16. package/package.json +1 -1
  17. package/src/browser.ts +1 -0
  18. package/src/procedures/invoke.ts +10 -4
  19. package/src/server/host-policy.ts +3 -3
  20. package/src/server/procedure-server.ts +2 -2
  21. package/dist/client/middleware/batching.d.ts +0 -102
  22. package/dist/client/middleware/batching.d.ts.map +0 -1
  23. package/dist/client/middleware/batching.js +0 -245
  24. package/dist/client/middleware/batching.js.map +0 -1
  25. package/dist/collections/async/async-queue.d.ts +0 -144
  26. package/dist/collections/async/async-queue.d.ts.map +0 -1
  27. package/dist/collections/async/async-queue.js +0 -347
  28. package/dist/collections/async/async-queue.js.map +0 -1
  29. package/dist/collections/async/channels.d.ts +0 -188
  30. package/dist/collections/async/channels.d.ts.map +0 -1
  31. package/dist/collections/async/channels.js +0 -312
  32. package/dist/collections/async/channels.js.map +0 -1
  33. package/dist/collections/behaviors/bounded.d.ts +0 -79
  34. package/dist/collections/behaviors/bounded.d.ts.map +0 -1
  35. package/dist/collections/behaviors/bounded.js +0 -384
  36. package/dist/collections/behaviors/bounded.js.map +0 -1
  37. package/dist/collections/behaviors/evented.d.ts +0 -154
  38. package/dist/collections/behaviors/evented.d.ts.map +0 -1
  39. package/dist/collections/behaviors/evented.js +0 -299
  40. package/dist/collections/behaviors/evented.js.map +0 -1
  41. package/dist/collections/behaviors/lru.d.ts +0 -84
  42. package/dist/collections/behaviors/lru.d.ts.map +0 -1
  43. package/dist/collections/behaviors/lru.js +0 -330
  44. package/dist/collections/behaviors/lru.js.map +0 -1
  45. package/dist/collections/behaviors/readonly.d.ts +0 -73
  46. package/dist/collections/behaviors/readonly.d.ts.map +0 -1
  47. package/dist/collections/behaviors/readonly.js +0 -158
  48. package/dist/collections/behaviors/readonly.js.map +0 -1
  49. package/dist/collections/behaviors/safe.d.ts +0 -163
  50. package/dist/collections/behaviors/safe.d.ts.map +0 -1
  51. package/dist/collections/behaviors/safe.js +0 -172
  52. package/dist/collections/behaviors/safe.js.map +0 -1
  53. package/dist/collections/behaviors/synchronized.d.ts +0 -88
  54. package/dist/collections/behaviors/synchronized.d.ts.map +0 -1
  55. package/dist/collections/behaviors/synchronized.js +0 -294
  56. package/dist/collections/behaviors/synchronized.js.map +0 -1
  57. package/dist/collections/behaviors/ttl.d.ts +0 -118
  58. package/dist/collections/behaviors/ttl.d.ts.map +0 -1
  59. package/dist/collections/behaviors/ttl.js +0 -338
  60. package/dist/collections/behaviors/ttl.js.map +0 -1
  61. package/dist/collections/core/effects.d.ts +0 -176
  62. package/dist/collections/core/effects.d.ts.map +0 -1
  63. package/dist/collections/core/effects.js +0 -180
  64. package/dist/collections/core/effects.js.map +0 -1
  65. package/dist/collections/core/events.d.ts +0 -192
  66. package/dist/collections/core/events.d.ts.map +0 -1
  67. package/dist/collections/core/events.js +0 -291
  68. package/dist/collections/core/events.js.map +0 -1
  69. package/dist/collections/core/middleware.d.ts +0 -231
  70. package/dist/collections/core/middleware.d.ts.map +0 -1
  71. package/dist/collections/core/middleware.js +0 -161
  72. package/dist/collections/core/middleware.js.map +0 -1
  73. package/dist/collections/core/policies.d.ts +0 -220
  74. package/dist/collections/core/policies.d.ts.map +0 -1
  75. package/dist/collections/core/policies.js +0 -48
  76. package/dist/collections/core/policies.js.map +0 -1
  77. package/dist/collections/core/traits.d.ts +0 -142
  78. package/dist/collections/core/traits.d.ts.map +0 -1
  79. package/dist/collections/core/traits.js +0 -8
  80. package/dist/collections/core/traits.js.map +0 -1
  81. package/dist/collections/examples.d.ts +0 -13
  82. package/dist/collections/examples.d.ts.map +0 -1
  83. package/dist/collections/examples.js +0 -302
  84. package/dist/collections/examples.js.map +0 -1
  85. package/dist/collections/fx/collectors.d.ts +0 -190
  86. package/dist/collections/fx/collectors.d.ts.map +0 -1
  87. package/dist/collections/fx/collectors.js +0 -369
  88. package/dist/collections/fx/collectors.js.map +0 -1
  89. package/dist/collections/fx/iter.d.ts +0 -166
  90. package/dist/collections/fx/iter.d.ts.map +0 -1
  91. package/dist/collections/fx/iter.js +0 -421
  92. package/dist/collections/fx/iter.js.map +0 -1
  93. package/dist/collections/impl/array-deque.d.ts +0 -107
  94. package/dist/collections/impl/array-deque.d.ts.map +0 -1
  95. package/dist/collections/impl/array-deque.js +0 -381
  96. package/dist/collections/impl/array-deque.js.map +0 -1
  97. package/dist/collections/impl/array-list.d.ts +0 -101
  98. package/dist/collections/impl/array-list.d.ts.map +0 -1
  99. package/dist/collections/impl/array-list.js +0 -387
  100. package/dist/collections/impl/array-list.js.map +0 -1
  101. package/dist/collections/impl/hash-map.d.ts +0 -141
  102. package/dist/collections/impl/hash-map.d.ts.map +0 -1
  103. package/dist/collections/impl/hash-map.js +0 -450
  104. package/dist/collections/impl/hash-map.js.map +0 -1
  105. package/dist/collections/impl/hash-set.d.ts +0 -125
  106. package/dist/collections/impl/hash-set.d.ts.map +0 -1
  107. package/dist/collections/impl/hash-set.js +0 -264
  108. package/dist/collections/impl/hash-set.js.map +0 -1
  109. package/dist/collections/impl/linked-hash-map.d.ts +0 -141
  110. package/dist/collections/impl/linked-hash-map.d.ts.map +0 -1
  111. package/dist/collections/impl/linked-hash-map.js +0 -472
  112. package/dist/collections/impl/linked-hash-map.js.map +0 -1
  113. package/dist/collections/impl/linked-list.d.ts +0 -109
  114. package/dist/collections/impl/linked-list.d.ts.map +0 -1
  115. package/dist/collections/impl/linked-list.js +0 -491
  116. package/dist/collections/impl/linked-list.js.map +0 -1
  117. package/dist/collections/impl/priority-queue.d.ts +0 -134
  118. package/dist/collections/impl/priority-queue.d.ts.map +0 -1
  119. package/dist/collections/impl/priority-queue.js +0 -336
  120. package/dist/collections/impl/priority-queue.js.map +0 -1
  121. package/dist/collections/impl/tree-map.d.ts +0 -146
  122. package/dist/collections/impl/tree-map.d.ts.map +0 -1
  123. package/dist/collections/impl/tree-map.js +0 -781
  124. package/dist/collections/impl/tree-map.js.map +0 -1
  125. package/dist/collections/impl/tree-set.d.ts +0 -112
  126. package/dist/collections/impl/tree-set.d.ts.map +0 -1
  127. package/dist/collections/impl/tree-set.js +0 -374
  128. package/dist/collections/impl/tree-set.js.map +0 -1
  129. package/dist/collections/index.d.ts +0 -105
  130. package/dist/collections/index.d.ts.map +0 -1
  131. package/dist/collections/index.js +0 -135
  132. package/dist/collections/index.js.map +0 -1
  133. package/dist/collections/interfaces/collection.d.ts +0 -119
  134. package/dist/collections/interfaces/collection.d.ts.map +0 -1
  135. package/dist/collections/interfaces/collection.js +0 -8
  136. package/dist/collections/interfaces/collection.js.map +0 -1
  137. package/dist/collections/interfaces/list.d.ts +0 -247
  138. package/dist/collections/interfaces/list.d.ts.map +0 -1
  139. package/dist/collections/interfaces/list.js +0 -8
  140. package/dist/collections/interfaces/list.js.map +0 -1
  141. package/dist/collections/interfaces/map.d.ts +0 -344
  142. package/dist/collections/interfaces/map.d.ts.map +0 -1
  143. package/dist/collections/interfaces/map.js +0 -8
  144. package/dist/collections/interfaces/map.js.map +0 -1
  145. package/dist/collections/interfaces/queue.d.ts +0 -304
  146. package/dist/collections/interfaces/queue.d.ts.map +0 -1
  147. package/dist/collections/interfaces/queue.js +0 -8
  148. package/dist/collections/interfaces/queue.js.map +0 -1
  149. package/dist/collections/interfaces/set.d.ts +0 -137
  150. package/dist/collections/interfaces/set.d.ts.map +0 -1
  151. package/dist/collections/interfaces/set.js +0 -8
  152. package/dist/collections/interfaces/set.js.map +0 -1
  153. package/dist/collections/storage/api.d.ts +0 -109
  154. package/dist/collections/storage/api.d.ts.map +0 -1
  155. package/dist/collections/storage/api.js +0 -182
  156. package/dist/collections/storage/api.js.map +0 -1
  157. package/dist/collections/storage/hybrid.d.ts +0 -164
  158. package/dist/collections/storage/hybrid.d.ts.map +0 -1
  159. package/dist/collections/storage/hybrid.js +0 -416
  160. package/dist/collections/storage/hybrid.js.map +0 -1
  161. package/dist/collections/storage/index.d.ts +0 -16
  162. package/dist/collections/storage/index.d.ts.map +0 -1
  163. package/dist/collections/storage/index.js +0 -13
  164. package/dist/collections/storage/index.js.map +0 -1
  165. package/dist/collections/storage/interface.d.ts +0 -141
  166. package/dist/collections/storage/interface.d.ts.map +0 -1
  167. package/dist/collections/storage/interface.js +0 -23
  168. package/dist/collections/storage/interface.js.map +0 -1
  169. package/dist/collections/storage/memory.d.ts +0 -68
  170. package/dist/collections/storage/memory.d.ts.map +0 -1
  171. package/dist/collections/storage/memory.js +0 -154
  172. package/dist/collections/storage/memory.js.map +0 -1
  173. package/dist/collections/utils/defaults.d.ts +0 -135
  174. package/dist/collections/utils/defaults.d.ts.map +0 -1
  175. package/dist/collections/utils/defaults.js +0 -322
  176. package/dist/collections/utils/defaults.js.map +0 -1
  177. package/dist/collections/utils/factories.d.ts +0 -144
  178. package/dist/collections/utils/factories.d.ts.map +0 -1
  179. package/dist/collections/utils/factories.js +0 -293
  180. package/dist/collections/utils/factories.js.map +0 -1
  181. package/dist/collections/utils/helpers.d.ts +0 -137
  182. package/dist/collections/utils/helpers.d.ts.map +0 -1
  183. package/dist/collections/utils/helpers.js +0 -221
  184. package/dist/collections/utils/helpers.js.map +0 -1
  185. package/dist/collections.d.ts +0 -12
  186. package/dist/collections.d.ts.map +0 -1
  187. package/dist/collections.js +0 -10
  188. package/dist/collections.js.map +0 -1
  189. package/dist/components/define.d.ts +0 -134
  190. package/dist/components/define.d.ts.map +0 -1
  191. package/dist/components/define.js +0 -486
  192. package/dist/components/define.js.map +0 -1
  193. package/dist/components/index.d.ts +0 -39
  194. package/dist/components/index.d.ts.map +0 -1
  195. package/dist/components/index.js +0 -38
  196. package/dist/components/index.js.map +0 -1
  197. package/dist/components/types.d.ts +0 -264
  198. package/dist/components/types.d.ts.map +0 -1
  199. package/dist/components/types.js +0 -46
  200. package/dist/components/types.js.map +0 -1
  201. package/dist/procedures/storage/adapter.d.ts +0 -148
  202. package/dist/procedures/storage/adapter.d.ts.map +0 -1
  203. package/dist/procedures/storage/adapter.js +0 -214
  204. package/dist/procedures/storage/adapter.js.map +0 -1
  205. package/dist/procedures/storage/api.d.ts +0 -125
  206. package/dist/procedures/storage/api.d.ts.map +0 -1
  207. package/dist/procedures/storage/api.js +0 -220
  208. package/dist/procedures/storage/api.js.map +0 -1
  209. package/dist/procedures/storage/factory.d.ts +0 -134
  210. package/dist/procedures/storage/factory.d.ts.map +0 -1
  211. package/dist/procedures/storage/factory.js +0 -166
  212. package/dist/procedures/storage/factory.js.map +0 -1
  213. package/dist/procedures/storage/hybrid.d.ts +0 -193
  214. package/dist/procedures/storage/hybrid.d.ts.map +0 -1
  215. package/dist/procedures/storage/hybrid.js +0 -519
  216. package/dist/procedures/storage/hybrid.js.map +0 -1
  217. package/dist/procedures/storage/index.d.ts +0 -17
  218. package/dist/procedures/storage/index.d.ts.map +0 -1
  219. package/dist/procedures/storage/index.js +0 -17
  220. package/dist/procedures/storage/index.js.map +0 -1
  221. package/dist/procedures/storage/procedures.d.ts +0 -39
  222. package/dist/procedures/storage/procedures.d.ts.map +0 -1
  223. package/dist/procedures/storage/procedures.js +0 -261
  224. package/dist/procedures/storage/procedures.js.map +0 -1
  225. package/dist/procedures/storage/serialization.d.ts +0 -123
  226. package/dist/procedures/storage/serialization.d.ts.map +0 -1
  227. package/dist/procedures/storage/serialization.js +0 -216
  228. package/dist/procedures/storage/serialization.js.map +0 -1
  229. package/dist/procedures/storage/synced-registry.d.ts +0 -246
  230. package/dist/procedures/storage/synced-registry.d.ts.map +0 -1
  231. package/dist/procedures/storage/synced-registry.js +0 -575
  232. package/dist/procedures/storage/synced-registry.js.map +0 -1
  233. package/dist/procedures/storage/types.d.ts +0 -130
  234. package/dist/procedures/storage/types.d.ts.map +0 -1
  235. package/dist/procedures/storage/types.js +0 -8
  236. package/dist/procedures/storage/types.js.map +0 -1
@@ -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/collections/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/collections/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/collections/core/events.ts"],"names":[],"mappings":"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"}