@procedures/client 0.0.0-stage → 0.1.0

package/dist/collections/behaviors/bounded.js

@@ -0,0 +1,384 @@
+/**
+ * Bounded behavior - Enforces capacity limits on collections.
+ *
+ * Wraps collections to prevent them from exceeding a maximum size.
+ * Provides various overflow policies to handle full collections.
+ *
+ * @example
+ * const list = compose(
+ *   boundedList({ capacity: 100, policy: 'drop-oldest' })
+ * )(arrayList<number>())
+ *
+ * // Add 101 elements - first element will be dropped
+ * for (let i = 0; i < 101; i++) {
+ *   list.add(i)
+ * }
+ */
+/**
+ * Creates a bounded List middleware.
+ *
+ * Intercepts add operations to enforce capacity limits.
+ * Supports multiple overflow policies.
+ */
+export function boundedList(options) {
+    const { capacity, policy = "throw", onOverflow } = options;
+    return (next) => {
+        const handleOverflow = (element) => {
+            // Call overflow handler if provided
+            if (onOverflow) {
+                const context = {
+                    newElement: element,
+                    currentSize: next.size,
+                    capacity,
+                    timestamp: Date.now(),
+                };
+                onOverflow(context);
+            }
+            // Apply policy
+            switch (policy) {
+                case "throw":
+                    throw new Error(`List is full (capacity: ${capacity})`);
+                case "drop-oldest":
+                    // Remove first element
+                    if (!next.isEmpty) {
+                        next.shift();
+                    }
+                    break;
+                case "drop-newest":
+                    // Don't add the new element (do nothing)
+                    return;
+                case "reject":
+                    // Silently reject (return false for add operations)
+                    return;
+                case "grow":
+                    // Allow growth (do nothing, element will be added)
+                    return;
+                case "block":
+                    throw new Error("Block policy not supported for sync collections");
+                default:
+                    throw new Error(`Unknown overflow policy: ${policy}`);
+            }
+        };
+        return new Proxy(next, {
+            get(target, prop, receiver) {
+                // Capacity property
+                if (prop === "capacity") {
+                    return capacity;
+                }
+                // isFull property
+                if (prop === "isFull") {
+                    return target.size >= capacity;
+                }
+                // remainingCapacity property
+                if (prop === "remainingCapacity") {
+                    return Math.max(0, capacity - target.size);
+                }
+                const value = Reflect.get(target, prop, receiver);
+                // Intercept methods that add elements
+                if (typeof value === "function") {
+                    switch (prop) {
+                        case "add":
+                            return function (element) {
+                                if (target.size >= capacity && policy !== "grow") {
+                                    handleOverflow(element);
+                                    if (policy === "reject" || policy === "drop-newest") {
+                                        return false;
+                                    }
+                                }
+                                return value.call(target, element);
+                            };
+                        case "push":
+                            return function (element) {
+                                if (target.size >= capacity && policy !== "grow") {
+                                    handleOverflow(element);
+                                    if (policy === "reject" || policy === "drop-newest") {
+                                        return;
+                                    }
+                                }
+                                value.call(target, element);
+                            };
+                        case "unshift":
+                            return function (element) {
+                                if (target.size >= capacity && policy !== "grow") {
+                                    handleOverflow(element);
+                                    if (policy === "reject" || policy === "drop-newest") {
+                                        return;
+                                    }
+                                    // For unshift with drop-oldest, we should drop from the end
+                                    if (policy === "drop-oldest" && !target.isEmpty) {
+                                        target.pop();
+                                    }
+                                }
+                                value.call(target, element);
+                            };
+                        case "insert":
+                            return function (index, element) {
+                                if (target.size >= capacity && policy !== "grow") {
+                                    handleOverflow(element);
+                                    if (policy === "reject" || policy === "drop-newest") {
+                                        return;
+                                    }
+                                }
+                                value.call(target, index, element);
+                            };
+                        case "addAll":
+                        case "insertAll":
+                            return function (...args) {
+                                const elements = args[args.length - 1];
+                                const elementsArray = Array.from(elements);
+                                // Check if adding all elements would exceed capacity
+                                if (target.size + elementsArray.length > capacity && policy !== "grow") {
+                                    // Add elements one by one with overflow handling
+                                    let added = false;
+                                    for (const element of elementsArray) {
+                                        if (target.size >= capacity) {
+                                            handleOverflow(element);
+                                            if (policy === "reject" || policy === "drop-newest") {
+                                                break;
+                                            }
+                                        }
+                                        if (prop === "addAll") {
+                                            target.add(element);
+                                        }
+                                        else {
+                                            target.insert(args[0], element);
+                                        }
+                                        added = true;
+                                    }
+                                    return added;
+                                }
+                                return value.apply(target, args);
+                            };
+                    }
+                }
+                return value;
+            },
+        });
+    };
+}
+/**
+ * Creates a bounded Queue middleware.
+ */
+export function boundedQueue(options) {
+    const { capacity, policy = "throw", onOverflow } = options;
+    return (next) => {
+        const handleOverflow = (element) => {
+            if (onOverflow) {
+                const context = {
+                    newElement: element,
+                    currentSize: next.size,
+                    capacity,
+                    timestamp: Date.now(),
+                };
+                onOverflow(context);
+            }
+            switch (policy) {
+                case "throw":
+                    throw new Error(`Queue is full (capacity: ${capacity})`);
+                case "drop-oldest":
+                    if (!next.isEmpty) {
+                        next.poll();
+                    }
+                    break;
+                case "drop-newest":
+                case "reject":
+                    return;
+                case "grow":
+                    return;
+                case "block":
+                    throw new Error("Block policy not supported for sync collections");
+                default:
+                    throw new Error(`Unknown overflow policy: ${policy}`);
+            }
+        };
+        return new Proxy(next, {
+            get(target, prop, receiver) {
+                if (prop === "capacity")
+                    return capacity;
+                if (prop === "isFull")
+                    return target.size >= capacity;
+                if (prop === "remainingCapacity")
+                    return Math.max(0, capacity - target.size);
+                const value = Reflect.get(target, prop, receiver);
+                if (typeof value === "function") {
+                    switch (prop) {
+                        case "offer":
+                        case "enqueue":
+                        case "add":
+                            return function (element) {
+                                if (target.size >= capacity && policy !== "grow") {
+                                    handleOverflow(element);
+                                    if (policy === "reject" || policy === "drop-newest") {
+                                        return false;
+                                    }
+                                }
+                                return value.call(target, element);
+                            };
+                    }
+                }
+                return value;
+            },
+        });
+    };
+}
+/**
+ * Creates a bounded Deque middleware.
+ */
+export function boundedDeque(options) {
+    const { capacity, policy = "throw", onOverflow } = options;
+    return (next) => {
+        const handleOverflow = (element) => {
+            if (onOverflow) {
+                const context = {
+                    newElement: element,
+                    currentSize: next.size,
+                    capacity,
+                    timestamp: Date.now(),
+                };
+                onOverflow(context);
+            }
+            switch (policy) {
+                case "throw":
+                    throw new Error(`Deque is full (capacity: ${capacity})`);
+                case "drop-oldest":
+                    if (!next.isEmpty) {
+                        next.removeFirst();
+                    }
+                    break;
+                case "drop-newest":
+                case "reject":
+                    return;
+                case "grow":
+                    return;
+                case "block":
+                    throw new Error("Block policy not supported for sync collections");
+                default:
+                    throw new Error(`Unknown overflow policy: ${policy}`);
+            }
+        };
+        return new Proxy(next, {
+            get(target, prop, receiver) {
+                if (prop === "capacity")
+                    return capacity;
+                if (prop === "isFull")
+                    return target.size >= capacity;
+                if (prop === "remainingCapacity")
+                    return Math.max(0, capacity - target.size);
+                const value = Reflect.get(target, prop, receiver);
+                if (typeof value === "function") {
+                    switch (prop) {
+                        case "addFirst":
+                        case "addLast":
+                        case "offerFirst":
+                        case "offerLast":
+                        case "push":
+                        case "offer":
+                        case "add":
+                            return function (element) {
+                                if (target.size >= capacity && policy !== "grow") {
+                                    handleOverflow(element);
+                                    if (policy === "reject" || policy === "drop-newest") {
+                                        return prop.startsWith("offer") || prop === "add" ? false : undefined;
+                                    }
+                                }
+                                return value.call(target, element);
+                            };
+                    }
+                }
+                return value;
+            },
+        });
+    };
+}
+/**
+ * Creates a bounded Map middleware.
+ */
+export function boundedMap(options) {
+    const { capacity, policy = "throw", onOverflow } = options;
+    return (next) => {
+        let insertionOrder = []; // Track insertion order for drop-oldest
+        const handleOverflow = (key, value) => {
+            if (onOverflow) {
+                onOverflow({
+                    key,
+                    value,
+                    currentSize: next.size,
+                    capacity,
+                    timestamp: Date.now(),
+                });
+            }
+            switch (policy) {
+                case "throw":
+                    throw new Error(`Map is full (capacity: ${capacity})`);
+                case "drop-oldest":
+                    // Remove oldest key
+                    if (insertionOrder.length > 0) {
+                        const oldestKey = insertionOrder.shift();
+                        next.delete(oldestKey);
+                    }
+                    break;
+                case "drop-newest":
+                case "reject":
+                    return;
+                case "grow":
+                    return;
+                case "block":
+                    throw new Error("Block policy not supported for sync collections");
+                default:
+                    throw new Error(`Unknown overflow policy: ${policy}`);
+            }
+        };
+        return new Proxy(next, {
+            get(target, prop, receiver) {
+                if (prop === "capacity")
+                    return capacity;
+                if (prop === "isFull")
+                    return target.size >= capacity;
+                if (prop === "remainingCapacity")
+                    return Math.max(0, capacity - target.size);
+                const value = Reflect.get(target, prop, receiver);
+                if (typeof value === "function") {
+                    switch (prop) {
+                        case "set":
+                            return function (key, val) {
+                                const hadKey = target.has(key);
+                                if (!hadKey && target.size >= capacity && policy !== "grow") {
+                                    handleOverflow(key, val);
+                                    if (policy === "reject" || policy === "drop-newest") {
+                                        return undefined;
+                                    }
+                                }
+                                const result = value.call(target, key, val);
+                                // Track insertion order
+                                if (!hadKey) {
+                                    insertionOrder.push(key);
+                                }
+                                return result;
+                            };
+                        case "delete":
+                            return function (key) {
+                                const result = value.call(target, key);
+                                // Remove from insertion order tracking
+                                insertionOrder = insertionOrder.filter((k) => !target.keyEq(k, key));
+                                return result;
+                            };
+                        case "clear":
+                            return function () {
+                                value.call(target);
+                                insertionOrder = [];
+                            };
+                    }
+                }
+                return value;
+            },
+        });
+    };
+}
+/**
+ * Generic bounded collection middleware.
+ * Works with any collection type.
+ */
+export function bounded(options) {
+    return boundedList(options);
+}
+//# sourceMappingURL=bounded.js.map

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

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

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

@@ -0,0 +1,154 @@
+/**
+ * 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 type { Middleware } from "../core/middleware.js";
+import type { List } from "../interfaces/list.js";
+import type { Queue, Deque } from "../interfaces/queue.js";
+import type { MapLike } from "../interfaces/map.js";
+import type { Collection } from "../interfaces/collection.js";
+import { type Unsubscribe } from "../core/events.js";
+/**
+ * Events emitted by List collections.
+ */
+export interface ListEvents<T> {
+    /** Element was added */
+    add: {
+        value: T;
+        index?: number;
+    };
+    /** Element was removed */
+    remove: {
+        value: T;
+        index?: number;
+    };
+    /** Element was replaced */
+    set: {
+        oldValue: T;
+        newValue: T;
+        index: number;
+    };
+    /** Collection was cleared */
+    clear: {};
+    /** Collection was sorted */
+    sort: {};
+    /** Collection was reversed */
+    reverse: {};
+}
+/**
+ * Events emitted by Queue collections.
+ */
+export interface QueueEvents<T> {
+    /** Element was added to queue */
+    enqueue: {
+        value: T;
+    };
+    /** Element was removed from queue */
+    dequeue: {
+        value: T;
+    };
+    /** Collection was cleared */
+    clear: {};
+}
+/**
+ * Events emitted by Deque collections.
+ */
+export interface DequeEvents<T> {
+    /** Element was added to front */
+    addFirst: {
+        value: T;
+    };
+    /** Element was added to back */
+    addLast: {
+        value: T;
+    };
+    /** Element was removed from front */
+    removeFirst: {
+        value: T;
+    };
+    /** Element was removed from back */
+    removeLast: {
+        value: T;
+    };
+    /** Collection was cleared */
+    clear: {};
+}
+/**
+ * Events emitted by Map collections.
+ */
+export interface MapEvents<K, V> {
+    /** Key-value pair was set */
+    set: {
+        key: K;
+        value: V;
+        oldValue?: V;
+    };
+    /** Key was deleted */
+    delete: {
+        key: K;
+        value: V;
+    };
+    /** Collection was cleared */
+    clear: {};
+}
+/**
+ * Generic collection events.
+ */
+export interface CollectionEvents<T> {
+    /** Element was added */
+    add: {
+        value: T;
+    };
+    /** Element was removed */
+    remove: {
+        value: T;
+    };
+    /** Collection was cleared */
+    clear: {};
+}
+/**
+ * Creates an evented List middleware.
+ *
+ * Emits events for add, remove, set, clear, sort, and reverse operations.
+ */
+export declare function eventedList<T>(): Middleware<List<T>, List<T> & {
+    on<E extends keyof ListEvents<T>>(event: E, listener: (payload: ListEvents<T>[E]) => void): Unsubscribe;
+}>;
+/**
+ * Creates an evented Queue middleware.
+ */
+export declare function eventedQueue<T>(): Middleware<Queue<T>, Queue<T> & {
+    on<E extends keyof QueueEvents<T>>(event: E, listener: (payload: QueueEvents<T>[E]) => void): Unsubscribe;
+}>;
+/**
+ * Creates an evented Deque middleware.
+ */
+export declare function eventedDeque<T>(): Middleware<Deque<T>, Deque<T> & {
+    on<E extends keyof DequeEvents<T>>(event: E, listener: (payload: DequeEvents<T>[E]) => void): Unsubscribe;
+}>;
+/**
+ * Creates an evented Map middleware.
+ */
+export declare function eventedMap<K, V>(): Middleware<MapLike<K, V>, MapLike<K, V> & {
+    on<E extends keyof MapEvents<K, V>>(event: E, listener: (payload: MapEvents<K, V>[E]) => void): Unsubscribe;
+}>;
+/**
+ * Generic evented collection middleware.
+ */
+export declare function evented<T>(): Middleware<Collection<T>, Collection<T> & {
+    on<E extends keyof CollectionEvents<T>>(event: E, listener: (payload: CollectionEvents<T>[E]) => void): Unsubscribe;
+}>;
+//# sourceMappingURL=evented.d.ts.map

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

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