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