@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.
- package/CHANGELOG.md +6 -0
- package/README.md +4 -4
- package/dist/.tsbuildinfo +1 -1
- package/dist/browser.d.ts +1 -1
- package/dist/browser.d.ts.map +1 -1
- package/dist/browser.js.map +1 -1
- package/dist/procedures/invoke.d.ts +6 -1
- package/dist/procedures/invoke.d.ts.map +1 -1
- package/dist/procedures/invoke.js +2 -2
- package/dist/procedures/invoke.js.map +1 -1
- package/dist/server/host-policy.d.ts +3 -3
- package/dist/server/host-policy.d.ts.map +1 -1
- package/dist/server/procedure-server.d.ts +2 -2
- package/dist/server/procedure-server.d.ts.map +1 -1
- package/dist/server/procedure-server.js.map +1 -1
- package/package.json +1 -1
- package/src/browser.ts +1 -0
- package/src/procedures/invoke.ts +10 -4
- package/src/server/host-policy.ts +3 -3
- package/src/server/procedure-server.ts +2 -2
- package/dist/client/middleware/batching.d.ts +0 -102
- package/dist/client/middleware/batching.d.ts.map +0 -1
- package/dist/client/middleware/batching.js +0 -245
- package/dist/client/middleware/batching.js.map +0 -1
- package/dist/collections/async/async-queue.d.ts +0 -144
- package/dist/collections/async/async-queue.d.ts.map +0 -1
- package/dist/collections/async/async-queue.js +0 -347
- package/dist/collections/async/async-queue.js.map +0 -1
- package/dist/collections/async/channels.d.ts +0 -188
- package/dist/collections/async/channels.d.ts.map +0 -1
- package/dist/collections/async/channels.js +0 -312
- package/dist/collections/async/channels.js.map +0 -1
- package/dist/collections/behaviors/bounded.d.ts +0 -79
- package/dist/collections/behaviors/bounded.d.ts.map +0 -1
- package/dist/collections/behaviors/bounded.js +0 -384
- package/dist/collections/behaviors/bounded.js.map +0 -1
- package/dist/collections/behaviors/evented.d.ts +0 -154
- package/dist/collections/behaviors/evented.d.ts.map +0 -1
- package/dist/collections/behaviors/evented.js +0 -299
- package/dist/collections/behaviors/evented.js.map +0 -1
- package/dist/collections/behaviors/lru.d.ts +0 -84
- package/dist/collections/behaviors/lru.d.ts.map +0 -1
- package/dist/collections/behaviors/lru.js +0 -330
- package/dist/collections/behaviors/lru.js.map +0 -1
- package/dist/collections/behaviors/readonly.d.ts +0 -73
- package/dist/collections/behaviors/readonly.d.ts.map +0 -1
- package/dist/collections/behaviors/readonly.js +0 -158
- package/dist/collections/behaviors/readonly.js.map +0 -1
- package/dist/collections/behaviors/safe.d.ts +0 -163
- package/dist/collections/behaviors/safe.d.ts.map +0 -1
- package/dist/collections/behaviors/safe.js +0 -172
- package/dist/collections/behaviors/safe.js.map +0 -1
- package/dist/collections/behaviors/synchronized.d.ts +0 -88
- package/dist/collections/behaviors/synchronized.d.ts.map +0 -1
- package/dist/collections/behaviors/synchronized.js +0 -294
- package/dist/collections/behaviors/synchronized.js.map +0 -1
- package/dist/collections/behaviors/ttl.d.ts +0 -118
- package/dist/collections/behaviors/ttl.d.ts.map +0 -1
- package/dist/collections/behaviors/ttl.js +0 -338
- package/dist/collections/behaviors/ttl.js.map +0 -1
- package/dist/collections/core/effects.d.ts +0 -176
- package/dist/collections/core/effects.d.ts.map +0 -1
- package/dist/collections/core/effects.js +0 -180
- package/dist/collections/core/effects.js.map +0 -1
- package/dist/collections/core/events.d.ts +0 -192
- package/dist/collections/core/events.d.ts.map +0 -1
- package/dist/collections/core/events.js +0 -291
- package/dist/collections/core/events.js.map +0 -1
- package/dist/collections/core/middleware.d.ts +0 -231
- package/dist/collections/core/middleware.d.ts.map +0 -1
- package/dist/collections/core/middleware.js +0 -161
- package/dist/collections/core/middleware.js.map +0 -1
- package/dist/collections/core/policies.d.ts +0 -220
- package/dist/collections/core/policies.d.ts.map +0 -1
- package/dist/collections/core/policies.js +0 -48
- package/dist/collections/core/policies.js.map +0 -1
- package/dist/collections/core/traits.d.ts +0 -142
- package/dist/collections/core/traits.d.ts.map +0 -1
- package/dist/collections/core/traits.js +0 -8
- package/dist/collections/core/traits.js.map +0 -1
- package/dist/collections/examples.d.ts +0 -13
- package/dist/collections/examples.d.ts.map +0 -1
- package/dist/collections/examples.js +0 -302
- package/dist/collections/examples.js.map +0 -1
- package/dist/collections/fx/collectors.d.ts +0 -190
- package/dist/collections/fx/collectors.d.ts.map +0 -1
- package/dist/collections/fx/collectors.js +0 -369
- package/dist/collections/fx/collectors.js.map +0 -1
- package/dist/collections/fx/iter.d.ts +0 -166
- package/dist/collections/fx/iter.d.ts.map +0 -1
- package/dist/collections/fx/iter.js +0 -421
- package/dist/collections/fx/iter.js.map +0 -1
- package/dist/collections/impl/array-deque.d.ts +0 -107
- package/dist/collections/impl/array-deque.d.ts.map +0 -1
- package/dist/collections/impl/array-deque.js +0 -381
- package/dist/collections/impl/array-deque.js.map +0 -1
- package/dist/collections/impl/array-list.d.ts +0 -101
- package/dist/collections/impl/array-list.d.ts.map +0 -1
- package/dist/collections/impl/array-list.js +0 -387
- package/dist/collections/impl/array-list.js.map +0 -1
- package/dist/collections/impl/hash-map.d.ts +0 -141
- package/dist/collections/impl/hash-map.d.ts.map +0 -1
- package/dist/collections/impl/hash-map.js +0 -450
- package/dist/collections/impl/hash-map.js.map +0 -1
- package/dist/collections/impl/hash-set.d.ts +0 -125
- package/dist/collections/impl/hash-set.d.ts.map +0 -1
- package/dist/collections/impl/hash-set.js +0 -264
- package/dist/collections/impl/hash-set.js.map +0 -1
- package/dist/collections/impl/linked-hash-map.d.ts +0 -141
- package/dist/collections/impl/linked-hash-map.d.ts.map +0 -1
- package/dist/collections/impl/linked-hash-map.js +0 -472
- package/dist/collections/impl/linked-hash-map.js.map +0 -1
- package/dist/collections/impl/linked-list.d.ts +0 -109
- package/dist/collections/impl/linked-list.d.ts.map +0 -1
- package/dist/collections/impl/linked-list.js +0 -491
- package/dist/collections/impl/linked-list.js.map +0 -1
- package/dist/collections/impl/priority-queue.d.ts +0 -134
- package/dist/collections/impl/priority-queue.d.ts.map +0 -1
- package/dist/collections/impl/priority-queue.js +0 -336
- package/dist/collections/impl/priority-queue.js.map +0 -1
- package/dist/collections/impl/tree-map.d.ts +0 -146
- package/dist/collections/impl/tree-map.d.ts.map +0 -1
- package/dist/collections/impl/tree-map.js +0 -781
- package/dist/collections/impl/tree-map.js.map +0 -1
- package/dist/collections/impl/tree-set.d.ts +0 -112
- package/dist/collections/impl/tree-set.d.ts.map +0 -1
- package/dist/collections/impl/tree-set.js +0 -374
- package/dist/collections/impl/tree-set.js.map +0 -1
- package/dist/collections/index.d.ts +0 -105
- package/dist/collections/index.d.ts.map +0 -1
- package/dist/collections/index.js +0 -135
- package/dist/collections/index.js.map +0 -1
- package/dist/collections/interfaces/collection.d.ts +0 -119
- package/dist/collections/interfaces/collection.d.ts.map +0 -1
- package/dist/collections/interfaces/collection.js +0 -8
- package/dist/collections/interfaces/collection.js.map +0 -1
- package/dist/collections/interfaces/list.d.ts +0 -247
- package/dist/collections/interfaces/list.d.ts.map +0 -1
- package/dist/collections/interfaces/list.js +0 -8
- package/dist/collections/interfaces/list.js.map +0 -1
- package/dist/collections/interfaces/map.d.ts +0 -344
- package/dist/collections/interfaces/map.d.ts.map +0 -1
- package/dist/collections/interfaces/map.js +0 -8
- package/dist/collections/interfaces/map.js.map +0 -1
- package/dist/collections/interfaces/queue.d.ts +0 -304
- package/dist/collections/interfaces/queue.d.ts.map +0 -1
- package/dist/collections/interfaces/queue.js +0 -8
- package/dist/collections/interfaces/queue.js.map +0 -1
- package/dist/collections/interfaces/set.d.ts +0 -137
- package/dist/collections/interfaces/set.d.ts.map +0 -1
- package/dist/collections/interfaces/set.js +0 -8
- package/dist/collections/interfaces/set.js.map +0 -1
- package/dist/collections/storage/api.d.ts +0 -109
- package/dist/collections/storage/api.d.ts.map +0 -1
- package/dist/collections/storage/api.js +0 -182
- package/dist/collections/storage/api.js.map +0 -1
- package/dist/collections/storage/hybrid.d.ts +0 -164
- package/dist/collections/storage/hybrid.d.ts.map +0 -1
- package/dist/collections/storage/hybrid.js +0 -416
- package/dist/collections/storage/hybrid.js.map +0 -1
- package/dist/collections/storage/index.d.ts +0 -16
- package/dist/collections/storage/index.d.ts.map +0 -1
- package/dist/collections/storage/index.js +0 -13
- package/dist/collections/storage/index.js.map +0 -1
- package/dist/collections/storage/interface.d.ts +0 -141
- package/dist/collections/storage/interface.d.ts.map +0 -1
- package/dist/collections/storage/interface.js +0 -23
- package/dist/collections/storage/interface.js.map +0 -1
- package/dist/collections/storage/memory.d.ts +0 -68
- package/dist/collections/storage/memory.d.ts.map +0 -1
- package/dist/collections/storage/memory.js +0 -154
- package/dist/collections/storage/memory.js.map +0 -1
- package/dist/collections/utils/defaults.d.ts +0 -135
- package/dist/collections/utils/defaults.d.ts.map +0 -1
- package/dist/collections/utils/defaults.js +0 -322
- package/dist/collections/utils/defaults.js.map +0 -1
- package/dist/collections/utils/factories.d.ts +0 -144
- package/dist/collections/utils/factories.d.ts.map +0 -1
- package/dist/collections/utils/factories.js +0 -293
- package/dist/collections/utils/factories.js.map +0 -1
- package/dist/collections/utils/helpers.d.ts +0 -137
- package/dist/collections/utils/helpers.d.ts.map +0 -1
- package/dist/collections/utils/helpers.js +0 -221
- package/dist/collections/utils/helpers.js.map +0 -1
- package/dist/collections.d.ts +0 -12
- package/dist/collections.d.ts.map +0 -1
- package/dist/collections.js +0 -10
- package/dist/collections.js.map +0 -1
- package/dist/components/define.d.ts +0 -134
- package/dist/components/define.d.ts.map +0 -1
- package/dist/components/define.js +0 -486
- package/dist/components/define.js.map +0 -1
- package/dist/components/index.d.ts +0 -39
- package/dist/components/index.d.ts.map +0 -1
- package/dist/components/index.js +0 -38
- package/dist/components/index.js.map +0 -1
- package/dist/components/types.d.ts +0 -264
- package/dist/components/types.d.ts.map +0 -1
- package/dist/components/types.js +0 -46
- package/dist/components/types.js.map +0 -1
- package/dist/procedures/storage/adapter.d.ts +0 -148
- package/dist/procedures/storage/adapter.d.ts.map +0 -1
- package/dist/procedures/storage/adapter.js +0 -214
- package/dist/procedures/storage/adapter.js.map +0 -1
- package/dist/procedures/storage/api.d.ts +0 -125
- package/dist/procedures/storage/api.d.ts.map +0 -1
- package/dist/procedures/storage/api.js +0 -220
- package/dist/procedures/storage/api.js.map +0 -1
- package/dist/procedures/storage/factory.d.ts +0 -134
- package/dist/procedures/storage/factory.d.ts.map +0 -1
- package/dist/procedures/storage/factory.js +0 -166
- package/dist/procedures/storage/factory.js.map +0 -1
- package/dist/procedures/storage/hybrid.d.ts +0 -193
- package/dist/procedures/storage/hybrid.d.ts.map +0 -1
- package/dist/procedures/storage/hybrid.js +0 -519
- package/dist/procedures/storage/hybrid.js.map +0 -1
- package/dist/procedures/storage/index.d.ts +0 -17
- package/dist/procedures/storage/index.d.ts.map +0 -1
- package/dist/procedures/storage/index.js +0 -17
- package/dist/procedures/storage/index.js.map +0 -1
- package/dist/procedures/storage/procedures.d.ts +0 -39
- package/dist/procedures/storage/procedures.d.ts.map +0 -1
- package/dist/procedures/storage/procedures.js +0 -261
- package/dist/procedures/storage/procedures.js.map +0 -1
- package/dist/procedures/storage/serialization.d.ts +0 -123
- package/dist/procedures/storage/serialization.d.ts.map +0 -1
- package/dist/procedures/storage/serialization.js +0 -216
- package/dist/procedures/storage/serialization.js.map +0 -1
- package/dist/procedures/storage/synced-registry.d.ts +0 -246
- package/dist/procedures/storage/synced-registry.d.ts.map +0 -1
- package/dist/procedures/storage/synced-registry.js +0 -575
- package/dist/procedures/storage/synced-registry.js.map +0 -1
- package/dist/procedures/storage/types.d.ts +0 -130
- package/dist/procedures/storage/types.d.ts.map +0 -1
- package/dist/procedures/storage/types.js +0 -8
- package/dist/procedures/storage/types.js.map +0 -1
|
@@ -1,163 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Safe behavior - Provides Option/Result-based error handling.
|
|
3
|
-
*
|
|
4
|
-
* Wraps collection operations that throw errors to instead return
|
|
5
|
-
* Option<T> or Result<T, E>, enabling functional error handling.
|
|
6
|
-
*
|
|
7
|
-
* @example
|
|
8
|
-
* const list = compose(
|
|
9
|
-
* safeList()
|
|
10
|
-
* )(arrayList<number>())
|
|
11
|
-
*
|
|
12
|
-
* const value = list.safe.get(10) // Option<number> instead of throwing
|
|
13
|
-
* if (isSome(value)) {
|
|
14
|
-
* console.log(value.value)
|
|
15
|
-
* }
|
|
16
|
-
*/
|
|
17
|
-
import type { Middleware } from "../core/middleware.js";
|
|
18
|
-
import type { List } from "../interfaces/list.js";
|
|
19
|
-
import type { Queue, Deque } from "../interfaces/queue.js";
|
|
20
|
-
import type { MapLike } from "../interfaces/map.js";
|
|
21
|
-
import { type Option, type Result } from "../core/effects.js";
|
|
22
|
-
/**
|
|
23
|
-
* Safe operations for List.
|
|
24
|
-
*/
|
|
25
|
-
export interface SafeListOperations<T> {
|
|
26
|
-
/**
|
|
27
|
-
* Get element at index, returning Option.
|
|
28
|
-
*/
|
|
29
|
-
get(index: number): Option<T>;
|
|
30
|
-
/**
|
|
31
|
-
* Set element at index, returning Result with old value or error.
|
|
32
|
-
*/
|
|
33
|
-
set(index: number, element: T): Result<T, string>;
|
|
34
|
-
/**
|
|
35
|
-
* Remove element at index, returning Result with removed value or error.
|
|
36
|
-
*/
|
|
37
|
-
removeAt(index: number): Result<T, string>;
|
|
38
|
-
/**
|
|
39
|
-
* Get first element as Option.
|
|
40
|
-
*/
|
|
41
|
-
first(): Option<T>;
|
|
42
|
-
/**
|
|
43
|
-
* Get last element as Option.
|
|
44
|
-
*/
|
|
45
|
-
last(): Option<T>;
|
|
46
|
-
/**
|
|
47
|
-
* Pop element, returning Option.
|
|
48
|
-
*/
|
|
49
|
-
pop(): Option<T>;
|
|
50
|
-
/**
|
|
51
|
-
* Shift element, returning Option.
|
|
52
|
-
*/
|
|
53
|
-
shift(): Option<T>;
|
|
54
|
-
}
|
|
55
|
-
/**
|
|
56
|
-
* Safe operations for Queue.
|
|
57
|
-
*/
|
|
58
|
-
export interface SafeQueueOperations<T> {
|
|
59
|
-
/**
|
|
60
|
-
* Peek at head element as Option.
|
|
61
|
-
*/
|
|
62
|
-
peek(): Option<T>;
|
|
63
|
-
/**
|
|
64
|
-
* Poll element as Option.
|
|
65
|
-
*/
|
|
66
|
-
poll(): Option<T>;
|
|
67
|
-
/**
|
|
68
|
-
* Dequeue element as Option.
|
|
69
|
-
*/
|
|
70
|
-
dequeue(): Option<T>;
|
|
71
|
-
}
|
|
72
|
-
/**
|
|
73
|
-
* Safe operations for Deque.
|
|
74
|
-
*/
|
|
75
|
-
export interface SafeDequeOperations<T> extends SafeQueueOperations<T> {
|
|
76
|
-
/**
|
|
77
|
-
* Peek at first element as Option.
|
|
78
|
-
*/
|
|
79
|
-
peekFirst(): Option<T>;
|
|
80
|
-
/**
|
|
81
|
-
* Peek at last element as Option.
|
|
82
|
-
*/
|
|
83
|
-
peekLast(): Option<T>;
|
|
84
|
-
/**
|
|
85
|
-
* Poll first element as Option.
|
|
86
|
-
*/
|
|
87
|
-
pollFirst(): Option<T>;
|
|
88
|
-
/**
|
|
89
|
-
* Poll last element as Option.
|
|
90
|
-
*/
|
|
91
|
-
pollLast(): Option<T>;
|
|
92
|
-
/**
|
|
93
|
-
* Pop element as Option.
|
|
94
|
-
*/
|
|
95
|
-
pop(): Option<T>;
|
|
96
|
-
}
|
|
97
|
-
/**
|
|
98
|
-
* Safe operations for Map.
|
|
99
|
-
*/
|
|
100
|
-
export interface SafeMapOperations<K, V> {
|
|
101
|
-
/**
|
|
102
|
-
* Get value for key as Option.
|
|
103
|
-
*/
|
|
104
|
-
get(key: K): Option<V>;
|
|
105
|
-
/**
|
|
106
|
-
* Set value for key, returning Result with old value or success.
|
|
107
|
-
*/
|
|
108
|
-
set(key: K, value: V): Result<V | undefined, string>;
|
|
109
|
-
/**
|
|
110
|
-
* Delete key, returning Result with deleted value or error.
|
|
111
|
-
*/
|
|
112
|
-
delete(key: K): Result<V | undefined, string>;
|
|
113
|
-
}
|
|
114
|
-
/**
|
|
115
|
-
* Creates a safe List middleware.
|
|
116
|
-
*
|
|
117
|
-
* Exposes a `safe` property with Option/Result-based operations.
|
|
118
|
-
*/
|
|
119
|
-
export declare function safeList<T>(): Middleware<List<T> & {
|
|
120
|
-
safe: SafeListOperations<T>;
|
|
121
|
-
}>;
|
|
122
|
-
/**
|
|
123
|
-
* Creates a safe Queue middleware.
|
|
124
|
-
*/
|
|
125
|
-
export declare function safeQueue<T>(): Middleware<Queue<T> & {
|
|
126
|
-
safe: SafeQueueOperations<T>;
|
|
127
|
-
}>;
|
|
128
|
-
/**
|
|
129
|
-
* Creates a safe Deque middleware.
|
|
130
|
-
*/
|
|
131
|
-
export declare function safeDeque<T>(): Middleware<Deque<T> & {
|
|
132
|
-
safe: SafeDequeOperations<T>;
|
|
133
|
-
}>;
|
|
134
|
-
/**
|
|
135
|
-
* Creates a safe Map middleware.
|
|
136
|
-
*/
|
|
137
|
-
export declare function safeMap<K, V>(): Middleware<MapLike<K, V> & {
|
|
138
|
-
safe: SafeMapOperations<K, V>;
|
|
139
|
-
}>;
|
|
140
|
-
/**
|
|
141
|
-
* Helper to match on Result type.
|
|
142
|
-
* Note: The match method is already built into Ok and Err constructors
|
|
143
|
-
* in effects.ts, so no runtime augmentation is needed.
|
|
144
|
-
*/
|
|
145
|
-
declare module "../core/effects.js" {
|
|
146
|
-
interface Ok<T> {
|
|
147
|
-
match<U>(cases: {
|
|
148
|
-
Ok: (value: T) => U;
|
|
149
|
-
Err: (error: never) => U;
|
|
150
|
-
}): U;
|
|
151
|
-
}
|
|
152
|
-
interface Err<E> {
|
|
153
|
-
match<U>(cases: {
|
|
154
|
-
Ok: (value: never) => U;
|
|
155
|
-
Err: (error: E) => U;
|
|
156
|
-
}): U;
|
|
157
|
-
}
|
|
158
|
-
}
|
|
159
|
-
/**
|
|
160
|
-
* Generic safe middleware that works with any collection.
|
|
161
|
-
*/
|
|
162
|
-
export declare function safe<C extends object>(): Middleware<C>;
|
|
163
|
-
//# sourceMappingURL=safe.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"safe.d.ts","sourceRoot":"","sources":["../../../src/collections/behaviors/safe.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,172 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Safe behavior - Provides Option/Result-based error handling.
|
|
3
|
-
*
|
|
4
|
-
* Wraps collection operations that throw errors to instead return
|
|
5
|
-
* Option<T> or Result<T, E>, enabling functional error handling.
|
|
6
|
-
*
|
|
7
|
-
* @example
|
|
8
|
-
* const list = compose(
|
|
9
|
-
* safeList()
|
|
10
|
-
* )(arrayList<number>())
|
|
11
|
-
*
|
|
12
|
-
* const value = list.safe.get(10) // Option<number> instead of throwing
|
|
13
|
-
* if (isSome(value)) {
|
|
14
|
-
* console.log(value.value)
|
|
15
|
-
* }
|
|
16
|
-
*/
|
|
17
|
-
import {} from "../core/effects.js";
|
|
18
|
-
import { None, Some, tryCatch } from "../core/effects.js";
|
|
19
|
-
/**
|
|
20
|
-
* Creates a safe List middleware.
|
|
21
|
-
*
|
|
22
|
-
* Exposes a `safe` property with Option/Result-based operations.
|
|
23
|
-
*/
|
|
24
|
-
export function safeList() {
|
|
25
|
-
return (next) => {
|
|
26
|
-
const safe = {
|
|
27
|
-
get(index) {
|
|
28
|
-
return tryCatch(() => next.get(index), () => "Index out of bounds").match({
|
|
29
|
-
Ok: (value) => Some(value),
|
|
30
|
-
Err: () => None,
|
|
31
|
-
});
|
|
32
|
-
},
|
|
33
|
-
set(index, element) {
|
|
34
|
-
return tryCatch(() => next.set(index, element), (error) => String(error));
|
|
35
|
-
},
|
|
36
|
-
removeAt(index) {
|
|
37
|
-
return tryCatch(() => next.removeAt(index), (error) => String(error));
|
|
38
|
-
},
|
|
39
|
-
first() {
|
|
40
|
-
return next.isEmpty ? None : Some(next.first());
|
|
41
|
-
},
|
|
42
|
-
last() {
|
|
43
|
-
return next.isEmpty ? None : Some(next.last());
|
|
44
|
-
},
|
|
45
|
-
pop() {
|
|
46
|
-
if (next.isEmpty)
|
|
47
|
-
return None;
|
|
48
|
-
return tryCatch(() => next.pop(), () => "List is empty").match({
|
|
49
|
-
Ok: (value) => Some(value),
|
|
50
|
-
Err: () => None,
|
|
51
|
-
});
|
|
52
|
-
},
|
|
53
|
-
shift() {
|
|
54
|
-
if (next.isEmpty)
|
|
55
|
-
return None;
|
|
56
|
-
return tryCatch(() => next.shift(), () => "List is empty").match({
|
|
57
|
-
Ok: (value) => Some(value),
|
|
58
|
-
Err: () => None,
|
|
59
|
-
});
|
|
60
|
-
},
|
|
61
|
-
};
|
|
62
|
-
// Extend next with safe property
|
|
63
|
-
return Object.assign(next, { safe });
|
|
64
|
-
};
|
|
65
|
-
}
|
|
66
|
-
/**
|
|
67
|
-
* Creates a safe Queue middleware.
|
|
68
|
-
*/
|
|
69
|
-
export function safeQueue() {
|
|
70
|
-
return (next) => {
|
|
71
|
-
const safe = {
|
|
72
|
-
peek() {
|
|
73
|
-
if (next.isEmpty)
|
|
74
|
-
return None;
|
|
75
|
-
return tryCatch(() => next.peek(), () => "Queue is empty").match({
|
|
76
|
-
Ok: (value) => Some(value),
|
|
77
|
-
Err: () => None,
|
|
78
|
-
});
|
|
79
|
-
},
|
|
80
|
-
poll() {
|
|
81
|
-
if (next.isEmpty)
|
|
82
|
-
return None;
|
|
83
|
-
return tryCatch(() => next.poll(), () => "Queue is empty").match({
|
|
84
|
-
Ok: (value) => Some(value),
|
|
85
|
-
Err: () => None,
|
|
86
|
-
});
|
|
87
|
-
},
|
|
88
|
-
dequeue() {
|
|
89
|
-
if (next.isEmpty)
|
|
90
|
-
return None;
|
|
91
|
-
return tryCatch(() => next.dequeue(), () => "Queue is empty").match({
|
|
92
|
-
Ok: (value) => Some(value),
|
|
93
|
-
Err: () => None,
|
|
94
|
-
});
|
|
95
|
-
},
|
|
96
|
-
};
|
|
97
|
-
return Object.assign(next, { safe });
|
|
98
|
-
};
|
|
99
|
-
}
|
|
100
|
-
/**
|
|
101
|
-
* Creates a safe Deque middleware.
|
|
102
|
-
*/
|
|
103
|
-
export function safeDeque() {
|
|
104
|
-
return (next) => {
|
|
105
|
-
const safe = {
|
|
106
|
-
peek() {
|
|
107
|
-
return next.isEmpty ? None : Some(next.peekFirst());
|
|
108
|
-
},
|
|
109
|
-
poll() {
|
|
110
|
-
return next.pollFirst() !== undefined ? Some(next.pollFirst()) : None;
|
|
111
|
-
},
|
|
112
|
-
dequeue() {
|
|
113
|
-
if (next.isEmpty)
|
|
114
|
-
return None;
|
|
115
|
-
return tryCatch(() => next.dequeue(), () => "Deque is empty").match({
|
|
116
|
-
Ok: (value) => Some(value),
|
|
117
|
-
Err: () => None,
|
|
118
|
-
});
|
|
119
|
-
},
|
|
120
|
-
peekFirst() {
|
|
121
|
-
return next.isEmpty ? None : Some(next.peekFirst());
|
|
122
|
-
},
|
|
123
|
-
peekLast() {
|
|
124
|
-
return next.isEmpty ? None : Some(next.peekLast());
|
|
125
|
-
},
|
|
126
|
-
pollFirst() {
|
|
127
|
-
const result = next.pollFirst();
|
|
128
|
-
return result !== undefined ? Some(result) : None;
|
|
129
|
-
},
|
|
130
|
-
pollLast() {
|
|
131
|
-
const result = next.pollLast();
|
|
132
|
-
return result !== undefined ? Some(result) : None;
|
|
133
|
-
},
|
|
134
|
-
pop() {
|
|
135
|
-
if (next.isEmpty)
|
|
136
|
-
return None;
|
|
137
|
-
return tryCatch(() => next.pop(), () => "Deque is empty").match({
|
|
138
|
-
Ok: (value) => Some(value),
|
|
139
|
-
Err: () => None,
|
|
140
|
-
});
|
|
141
|
-
},
|
|
142
|
-
};
|
|
143
|
-
return Object.assign(next, { safe });
|
|
144
|
-
};
|
|
145
|
-
}
|
|
146
|
-
/**
|
|
147
|
-
* Creates a safe Map middleware.
|
|
148
|
-
*/
|
|
149
|
-
export function safeMap() {
|
|
150
|
-
return (next) => {
|
|
151
|
-
const safe = {
|
|
152
|
-
get(key) {
|
|
153
|
-
return next.has(key) ? Some(next.get(key)) : None;
|
|
154
|
-
},
|
|
155
|
-
set(key, value) {
|
|
156
|
-
return tryCatch(() => next.set(key, value), (error) => String(error));
|
|
157
|
-
},
|
|
158
|
-
delete(key) {
|
|
159
|
-
return tryCatch(() => next.delete(key), (error) => String(error));
|
|
160
|
-
},
|
|
161
|
-
};
|
|
162
|
-
return Object.assign(next, { safe });
|
|
163
|
-
};
|
|
164
|
-
}
|
|
165
|
-
/**
|
|
166
|
-
* Generic safe middleware that works with any collection.
|
|
167
|
-
*/
|
|
168
|
-
export function safe() {
|
|
169
|
-
// Return as-is for now; specialized versions handle specific types
|
|
170
|
-
return (next) => next;
|
|
171
|
-
}
|
|
172
|
-
//# sourceMappingURL=safe.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"safe.js","sourceRoot":"","sources":["../../../src/collections/behaviors/safe.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,88 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Synchronized behavior - Provides thread-safe access with mutex locking.
|
|
3
|
-
*
|
|
4
|
-
* Wraps collections to serialize all operations using a mutex, ensuring
|
|
5
|
-
* thread-safe access in concurrent environments. Mirrors Java's
|
|
6
|
-
* Collections.synchronizedList() and related methods.
|
|
7
|
-
*
|
|
8
|
-
* Note: JavaScript is single-threaded, but async operations can interleave.
|
|
9
|
-
* This middleware ensures atomic operations across async boundaries.
|
|
10
|
-
*
|
|
11
|
-
* @example
|
|
12
|
-
* const list = compose(
|
|
13
|
-
* synchronized()
|
|
14
|
-
* )(arrayList<number>())
|
|
15
|
-
*
|
|
16
|
-
* // All operations are now serialized
|
|
17
|
-
* await Promise.all([
|
|
18
|
-
* list.add(1),
|
|
19
|
-
* list.add(2),
|
|
20
|
-
* list.add(3)
|
|
21
|
-
* ])
|
|
22
|
-
*/
|
|
23
|
-
import type { Middleware } from "../core/middleware.js";
|
|
24
|
-
/**
|
|
25
|
-
* Creates a synchronized middleware that locks all method calls.
|
|
26
|
-
*
|
|
27
|
-
* Every method call on the collection is wrapped with a mutex,
|
|
28
|
-
* ensuring atomic execution even in concurrent async scenarios.
|
|
29
|
-
*
|
|
30
|
-
* @example
|
|
31
|
-
* const syncList = compose(
|
|
32
|
-
* synchronized()
|
|
33
|
-
* )(arrayList<number>())
|
|
34
|
-
*
|
|
35
|
-
* // These additions are guaranteed to execute in order
|
|
36
|
-
* await Promise.all([
|
|
37
|
-
* syncList.add(1),
|
|
38
|
-
* syncList.add(2),
|
|
39
|
-
* syncList.add(3)
|
|
40
|
-
* ])
|
|
41
|
-
*/
|
|
42
|
-
export declare function synchronized<C extends object>(): Middleware<C>;
|
|
43
|
-
/**
|
|
44
|
-
* Alias for Java compatibility: synchronizedList
|
|
45
|
-
*/
|
|
46
|
-
export declare const synchronizedList: typeof synchronized;
|
|
47
|
-
/**
|
|
48
|
-
* Alias for Java compatibility: synchronizedMap
|
|
49
|
-
*/
|
|
50
|
-
export declare const synchronizedMap: typeof synchronized;
|
|
51
|
-
/**
|
|
52
|
-
* Alias for Java compatibility: synchronizedCollection
|
|
53
|
-
*/
|
|
54
|
-
export declare const synchronizedCollection: typeof synchronized;
|
|
55
|
-
/**
|
|
56
|
-
* Alias for Java compatibility: synchronizedSet
|
|
57
|
-
*/
|
|
58
|
-
export declare const synchronizedSet: typeof synchronized;
|
|
59
|
-
/**
|
|
60
|
-
* Advanced synchronized middleware with reentrant locking.
|
|
61
|
-
*
|
|
62
|
-
* Allows the same "thread" (async context) to acquire the lock multiple times.
|
|
63
|
-
* Useful for methods that call other synchronized methods internally.
|
|
64
|
-
*
|
|
65
|
-
* Note: JavaScript doesn't have true thread IDs, so we use async context
|
|
66
|
-
* tracking if available, or fall back to non-reentrant behavior.
|
|
67
|
-
*/
|
|
68
|
-
export declare function reentrantSynchronized<C extends object>(): Middleware<C>;
|
|
69
|
-
/**
|
|
70
|
-
* Read-write lock implementation for collections.
|
|
71
|
-
*
|
|
72
|
-
* Allows multiple concurrent readers but exclusive writers.
|
|
73
|
-
* More efficient than full synchronization for read-heavy workloads.
|
|
74
|
-
*
|
|
75
|
-
* @example
|
|
76
|
-
* const list = compose(
|
|
77
|
-
* readWriteLock()
|
|
78
|
-
* )(arrayList<number>())
|
|
79
|
-
*
|
|
80
|
-
* // Multiple reads can happen concurrently
|
|
81
|
-
* await Promise.all([
|
|
82
|
-
* list.get(0),
|
|
83
|
-
* list.get(1),
|
|
84
|
-
* list.get(2)
|
|
85
|
-
* ])
|
|
86
|
-
*/
|
|
87
|
-
export declare function readWriteLock<C extends object>(): Middleware<C>;
|
|
88
|
-
//# sourceMappingURL=synchronized.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"synchronized.d.ts","sourceRoot":"","sources":["../../../src/collections/behaviors/synchronized.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAqDxD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,CA6B9D;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAG,OAAO,YAA2B,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,eAAe,EAAG,OAAO,YAA2B,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAG,OAAO,YAA2B,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,eAAe,EAAG,OAAO,YAA2B,CAAC;AAElE;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,CA+CvE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,CAsG/D"}
|