@procedures/client 0.0.0-stage → 0.1.0

package/dist/collections/behaviors/evented.js

@@ -0,0 +1,299 @@
+/**
+ * Evented behavior - Emits typed events on collection mutations.
+ *
+ * Wraps collections to emit events whenever elements are added, removed,
+ * or the collection is cleared. Enables reactive programming patterns.
+ *
+ * @example
+ * const list = compose(
+ *   eventedList()
+ * )(arrayList<number>())
+ *
+ * list.on('add', ({ value, index }) => {
+ *   console.log(`Added ${value} at index ${index}`)
+ * })
+ *
+ * list.add(42) // Triggers 'add' event
+ */
+import { Emitter } from "../core/events.js";
+// ============================================================================
+// Evented middleware implementations
+// ============================================================================
+/**
+ * Creates an evented List middleware.
+ *
+ * Emits events for add, remove, set, clear, sort, and reverse operations.
+ */
+export function eventedList() {
+    return (next) => {
+        const emitter = new Emitter();
+        return new Proxy(next, {
+            get(target, prop, receiver) {
+                // Expose event subscription
+                if (prop === "on") {
+                    return emitter.on.bind(emitter);
+                }
+                const value = Reflect.get(target, prop, receiver);
+                if (typeof value === "function") {
+                    switch (prop) {
+                        case "add":
+                        case "push":
+                            return function (element) {
+                                const result = value.call(target, element);
+                                emitter.emit("add", { value: element });
+                                return result;
+                            };
+                        case "unshift":
+                            return function (element) {
+                                value.call(target, element);
+                                emitter.emit("add", { value: element, index: 0 });
+                            };
+                        case "insert":
+                            return function (index, element) {
+                                value.call(target, index, element);
+                                emitter.emit("add", { value: element, index });
+                            };
+                        case "set":
+                            return function (index, element) {
+                                const oldValue = value.call(target, index, element);
+                                emitter.emit("set", { oldValue, newValue: element, index });
+                                return oldValue;
+                            };
+                        case "remove":
+                            return function (element) {
+                                const result = value.call(target, element);
+                                if (result) {
+                                    emitter.emit("remove", { value: element });
+                                }
+                                return result;
+                            };
+                        case "removeAt":
+                            return function (index) {
+                                const removed = value.call(target, index);
+                                emitter.emit("remove", { value: removed, index });
+                                return removed;
+                            };
+                        case "pop":
+                            return function () {
+                                const removed = value.call(target);
+                                emitter.emit("remove", { value: removed });
+                                return removed;
+                            };
+                        case "shift":
+                            return function () {
+                                const removed = value.call(target);
+                                emitter.emit("remove", { value: removed, index: 0 });
+                                return removed;
+                            };
+                        case "clear":
+                            return function () {
+                                value.call(target);
+                                emitter.emit("clear", {});
+                            };
+                        case "sort":
+                            return function (...args) {
+                                value.apply(target, args);
+                                emitter.emit("sort", {});
+                            };
+                        case "reverse":
+                            return function () {
+                                value.call(target);
+                                emitter.emit("reverse", {});
+                            };
+                    }
+                }
+                return value;
+            },
+        });
+    };
+}
+/**
+ * Creates an evented Queue middleware.
+ */
+export function eventedQueue() {
+    return (next) => {
+        const emitter = new Emitter();
+        return new Proxy(next, {
+            get(target, prop, receiver) {
+                if (prop === "on") {
+                    return emitter.on.bind(emitter);
+                }
+                const value = Reflect.get(target, prop, receiver);
+                if (typeof value === "function") {
+                    switch (prop) {
+                        case "offer":
+                        case "enqueue":
+                        case "add":
+                            return function (element) {
+                                const result = value.call(target, element);
+                                if (result !== false) {
+                                    emitter.emit("enqueue", { value: element });
+                                }
+                                return result;
+                            };
+                        case "poll":
+                        case "dequeue":
+                            return function () {
+                                const removed = value.call(target);
+                                emitter.emit("dequeue", { value: removed });
+                                return removed;
+                            };
+                        case "clear":
+                            return function () {
+                                value.call(target);
+                                emitter.emit("clear", {});
+                            };
+                    }
+                }
+                return value;
+            },
+        });
+    };
+}
+/**
+ * Creates an evented Deque middleware.
+ */
+export function eventedDeque() {
+    return (next) => {
+        const emitter = new Emitter();
+        return new Proxy(next, {
+            get(target, prop, receiver) {
+                if (prop === "on") {
+                    return emitter.on.bind(emitter);
+                }
+                const value = Reflect.get(target, prop, receiver);
+                if (typeof value === "function") {
+                    switch (prop) {
+                        case "addFirst":
+                        case "offerFirst":
+                        case "push":
+                            return function (element) {
+                                const result = value.call(target, element);
+                                emitter.emit("addFirst", { value: element });
+                                return result;
+                            };
+                        case "addLast":
+                        case "offerLast":
+                        case "offer":
+                        case "add":
+                            return function (element) {
+                                const result = value.call(target, element);
+                                emitter.emit("addLast", { value: element });
+                                return result;
+                            };
+                        case "removeFirst":
+                        case "pollFirst":
+                        case "poll":
+                        case "dequeue":
+                            return function () {
+                                const removed = value.call(target);
+                                if (removed !== undefined) {
+                                    emitter.emit("removeFirst", { value: removed });
+                                }
+                                return removed;
+                            };
+                        case "removeLast":
+                        case "pollLast":
+                        case "pop":
+                            return function () {
+                                const removed = value.call(target);
+                                if (removed !== undefined) {
+                                    emitter.emit("removeLast", { value: removed });
+                                }
+                                return removed;
+                            };
+                        case "clear":
+                            return function () {
+                                value.call(target);
+                                emitter.emit("clear", {});
+                            };
+                    }
+                }
+                return value;
+            },
+        });
+    };
+}
+/**
+ * Creates an evented Map middleware.
+ */
+export function eventedMap() {
+    return (next) => {
+        const emitter = new Emitter();
+        return new Proxy(next, {
+            get(target, prop, receiver) {
+                if (prop === "on") {
+                    return emitter.on.bind(emitter);
+                }
+                const value = Reflect.get(target, prop, receiver);
+                if (typeof value === "function") {
+                    switch (prop) {
+                        case "set":
+                            return function (key, val) {
+                                const oldValue = value.call(target, key, val);
+                                emitter.emit("set", { key, value: val, oldValue });
+                                return oldValue;
+                            };
+                        case "delete":
+                            return function (key) {
+                                const deletedValue = value.call(target, key);
+                                if (deletedValue !== undefined) {
+                                    emitter.emit("delete", { key, value: deletedValue });
+                                }
+                                return deletedValue;
+                            };
+                        case "clear":
+                            return function () {
+                                value.call(target);
+                                emitter.emit("clear", {});
+                            };
+                    }
+                }
+                return value;
+            },
+        });
+    };
+}
+/**
+ * Generic evented collection middleware.
+ */
+export function evented() {
+    return (next) => {
+        const emitter = new Emitter();
+        return new Proxy(next, {
+            get(target, prop, receiver) {
+                if (prop === "on") {
+                    return emitter.on.bind(emitter);
+                }
+                const value = Reflect.get(target, prop, receiver);
+                if (typeof value === "function") {
+                    switch (prop) {
+                        case "add":
+                            return function (element) {
+                                const result = value.call(target, element);
+                                if (result) {
+                                    emitter.emit("add", { value: element });
+                                }
+                                return result;
+                            };
+                        case "remove":
+                            return function (element) {
+                                const result = value.call(target, element);
+                                if (result) {
+                                    emitter.emit("remove", { value: element });
+                                }
+                                return result;
+                            };
+                        case "clear":
+                            return function () {
+                                value.call(target);
+                                emitter.emit("clear", {});
+                            };
+                    }
+                }
+                return value;
+            },
+        });
+    };
+}
+//# sourceMappingURL=evented.js.map

package/dist/collections/behaviors/evented.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evented.js","sourceRoot":"","sources":["../../../src/collections/behaviors/evented.ts"],"names":[],"mappings":"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"}

package/dist/collections/behaviors/lru.d.ts

@@ -0,0 +1,84 @@
+/**
+ * LRU (Least Recently Used) eviction behavior.
+ *
+ * Tracks access times and automatically evicts the least recently used
+ * elements when capacity is reached. Perfect for caching.
+ *
+ * @example
+ * const cache = compose(
+ *   lruMap({ capacity: 100 })
+ * )(hashMap<string, Data>())
+ *
+ * cache.set('key1', data1) // Accessed
+ * cache.get('key1')        // Accessed again (moves to front)
+ * // When full, least recently accessed keys are evicted
+ */
+import type { Middleware } from "../core/middleware.js";
+import type { MapLike } from "../interfaces/map.js";
+/**
+ * Options for LRU behavior.
+ */
+export interface LRUOptions {
+    /**
+     * Maximum capacity. When exceeded, least recently used items are evicted.
+     */
+    capacity: number;
+    /**
+     * Optional callback invoked when an item is evicted.
+     */
+    onEvict?: (info: {
+        key: any;
+        value: any;
+        timestamp: number;
+    }) => void;
+}
+/**
+ * Creates an LRU Map middleware.
+ *
+ * Maintains a doubly-linked list to track access order.
+ * Most recently accessed items are at the head.
+ * When capacity is exceeded, items at the tail are evicted.
+ */
+export declare function lruMap<K, V>(options: LRUOptions): Middleware<MapLike<K, V> & {
+    readonly isFull: boolean;
+}>;
+/**
+ * Creates an LRU cache with a simpler API.
+ * This is a standalone LRU cache implementation.
+ *
+ * @example
+ * const cache = lruCache<string, Data>(100)
+ * cache.set('key', value)
+ * cache.get('key') // Moves to front
+ */
+export declare class LRUCache<K, V> {
+    private readonly capacity;
+    private readonly onEvict?;
+    private map;
+    private head;
+    private tail;
+    constructor(capacity: number, onEvict?: ((key: K, value: V) => void) | undefined);
+    get size(): number;
+    get isFull(): boolean;
+    get(key: K): V | undefined;
+    set(key: K, value: V): void;
+    has(key: K): boolean;
+    delete(key: K): boolean;
+    clear(): void;
+    private moveToHead;
+    private removeNode;
+    private evictLRU;
+    /**
+     * Returns keys in LRU order (most recent first).
+     */
+    keys(): IterableIterator<K>;
+    /**
+     * Returns entries in LRU order (most recent first).
+     */
+    entries(): IterableIterator<[K, V]>;
+}
+/**
+ * Factory function to create an LRU cache.
+ */
+export declare function lruCache<K, V>(capacity: number, onEvict?: (key: K, value: V) => void): LRUCache<K, V>;
+//# sourceMappingURL=lru.d.ts.map

package/dist/collections/behaviors/lru.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru.d.ts","sourceRoot":"","sources":["../../../src/collections/behaviors/lru.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,GAAG,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACvE;AAaD;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EACzB,OAAO,EAAE,UAAU,GAClB,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CA8K1D;AAED;;;;;;;;GAQG;AACH,qBAAa,QAAQ,CAAC,CAAC,EAAE,CAAC;IAMtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAN3B,OAAO,CAAC,GAAG,CAAwD;IACnE,OAAO,CAAC,IAAI,CAA8B;IAC1C,OAAO,CAAC,IAAI,CAA8B;gBAGvB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,GAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,aAAA;IAGvD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAQ1B,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAmC3B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIpB,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IASvB,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,UAAU;IAwBlB,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,QAAQ;IAYhB;;OAEG;IACF,IAAI,IAAI,gBAAgB,CAAC,CAAC,CAAC;IAQ5B;;OAEG;IACF,OAAO,IAAI,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAOrC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,GACnC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAEhB"}