@procedures/client 0.0.0-stage → 0.1.0

package/dist/collections/index.d.ts.map

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

package/dist/collections/index.js

@@ -0,0 +1,135 @@
+/**
+ * Collections Framework - A comprehensive Java Collections-inspired library for TypeScript.
+ *
+ * Provides:
+ * - Core collection interfaces (List, Set, Queue, Map, etc.)
+ * - Rich implementations (ArrayList, LinkedList, HashSet, HashMap, PriorityQueue, etc.)
+ * - Composable behaviors (bounded, readonly, safe, evented, synchronized, LRU, TTL)
+ * - Functional error handling (Option, Result)
+ * - Event-driven collections with typed events
+ * - Async/concurrent collections (AsyncQueue, Channels with CSP patterns)
+ * - Lazy functional operations (map, filter, reduce, etc.)
+ * - Stream-style collectors (groupBy, counting, summarizing, etc.)
+ * - Pluggable equality/hashing/comparison
+ *
+ * @example
+ * // Composable behaviors
+ * import { arrayList, compose, boundedList, eventedList } from '@common/collections'
+ *
+ * const list = compose(
+ *   eventedList(),
+ *   boundedList({ capacity: 100, policy: 'drop-oldest' })
+ * )(arrayList<number>())
+ *
+ * list.on('add', ({ value }) => console.log('Added:', value))
+ * list.add(42)
+ *
+ * @example
+ * // Functional operations with lazy evaluation
+ * import { pipe, map, filter, take, collect, toList } from '@common/collections'
+ *
+ * const result = pipe(
+ *   [1, 2, 3, 4, 5],
+ *   (it) => map(it, x => x * 2),
+ *   (it) => filter(it, x => x > 5),
+ *   (it) => take(it, 2),
+ *   (it) => collect(it, toList())
+ * )
+ *
+ * @example
+ * // Async channels with Go-style CSP
+ * import { channel, select, timeout, pipeline } from '@common/collections'
+ *
+ * const ch = channel<number>()
+ * await ch.send(42)
+ * const value = await select(
+ *   ch.case(v => v),
+ *   timeout(1000).case(() => null)
+ * )
+ */
+// ============================================================================
+// Core types and utilities
+// ============================================================================
+export * from "./core/traits.js";
+export * from "./core/effects.js";
+export * from "./core/policies.js";
+export * from "./core/middleware.js";
+export * from "./core/events.js";
+// ============================================================================
+// Interfaces
+// ============================================================================
+export * from "./interfaces/collection.js";
+export * from "./interfaces/list.js";
+export * from "./interfaces/map.js";
+export * from "./interfaces/set.js";
+// ============================================================================
+// Implementations
+// ============================================================================
+export * from "./impl/array-list.js";
+export * from "./impl/array-deque.js";
+export * from "./impl/hash-map.js";
+export * from "./impl/linked-hash-map.js";
+export * from "./impl/tree-map.js";
+export * from "./impl/tree-set.js";
+export * from "./impl/linked-list.js";
+export * from "./impl/hash-set.js";
+export * from "./impl/priority-queue.js";
+// ============================================================================
+// Behaviors
+// ============================================================================
+// Export bounded behaviors (excluding duplicate BoundedCollection interface)
+export { boundedList, boundedQueue, boundedDeque, boundedMap, bounded, } from "./behaviors/bounded.js";
+export * from "./behaviors/readonly.js";
+export * from "./behaviors/safe.js";
+export * from "./behaviors/evented.js";
+export * from "./behaviors/synchronized.js";
+export * from "./behaviors/lru.js";
+export * from "./behaviors/ttl.js";
+// ============================================================================
+// Async/Concurrent
+// ============================================================================
+export * from "./async/async-queue.js";
+export * from "./async/channels.js";
+// ============================================================================
+// Functional Operations
+// ============================================================================
+export * from "./fx/iter.js";
+export * from "./fx/collectors.js";
+// ============================================================================
+// Utilities
+// ============================================================================
+export * from "./utils/defaults.js";
+export * from "./utils/factories.js";
+export * from "./utils/helpers.js";
+// ============================================================================
+// Re-exports for convenience
+// ============================================================================
+// Most commonly used exports
+export { compose, bundle } from "./core/middleware.js";
+export { arrayList } from "./impl/array-list.js";
+export { arrayDeque } from "./impl/array-deque.js";
+export { hashMap } from "./impl/hash-map.js";
+export { linkedHashMap } from "./impl/linked-hash-map.js";
+export { treeMap } from "./impl/tree-map.js";
+export { treeSet } from "./impl/tree-set.js";
+export { linkedList } from "./impl/linked-list.js";
+export { hashSet } from "./impl/hash-set.js";
+export { priorityQueue } from "./impl/priority-queue.js";
+// Common behaviors
+export { readonly, readonlyList, readonlyMap } from "./behaviors/readonly.js";
+export { safeList, safeQueue, safeMap } from "./behaviors/safe.js";
+export { eventedList, eventedQueue, eventedMap } from "./behaviors/evented.js";
+export { synchronized } from "./behaviors/synchronized.js";
+export { lruMap, lruCache, LRUCache } from "./behaviors/lru.js";
+export { ttlMap, ttlCache, TTLCache, ttlCollection } from "./behaviors/ttl.js";
+// Async/Concurrent
+export { asyncQueue, AsyncQueue } from "./async/async-queue.js";
+export { channel, Channel, select, timeout, ticker, pipeline, fanOut, fanIn, merge, workerPool, } from "./async/channels.js";
+// Functional operations
+export { map, filter, flatMap, flatten, take, skip, takeWhile, skipWhile, concat, zip, enumerate, chunk, window, partition, reduce, scan, sort, reverse, distinct, distinctConsecutive, tap, some, every, none, find, count, min, max, sum, average, toArray, toSet, toMap as iterToMap, pipe, } from "./fx/iter.js";
+export { collect, toList as collectToList, toArray as collectToArray, toSet as collectToSet, toMap as collectToMap, groupingBy, groupingByWith, partitioningBy, counting, summingNumber, averagingNumber, minBy, maxBy, joining, mapping, filtering, flatMapping, reducing, reducingWith, teeing, first, last, summarizingNumber, } from "./fx/collectors.js";
+// Common factories
+export { emptyList, emptyMap, emptyQueue, singletonList, singletonMap, nCopies, listOf, mapOf, range, rangeTo, toList, toMap, groupBy, } from "./utils/factories.js";
+// Effects
+export { None, Some, Ok, Err, isSome, isNone, isOk, isErr, getOrElse, unwrap, } from "./core/effects.js";
+//# sourceMappingURL=index.js.map

package/dist/collections/index.js.map

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

package/dist/collections/interfaces/collection.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Base collection interfaces that mirror Java Collections Framework.
+ *
+ * These form the root of the collection hierarchy and define the
+ * fundamental operations common to all collections.
+ */
+import type { Eq } from "../core/traits.js";
+/**
+ * ReadonlyCollection<T> - The root interface for readonly collections.
+ *
+ * Mirrors java.util.Collection but without mutation operations.
+ * All collections should extend this or a more specific readonly interface.
+ */
+export interface ReadonlyCollection<T> extends Iterable<T> {
+    /**
+     * Returns the number of elements in this collection.
+     */
+    readonly size: number;
+    /**
+     * Returns true if this collection contains no elements.
+     */
+    readonly isEmpty: boolean;
+    /**
+     * Returns true if this collection contains the specified element.
+     * Uses the collection's equality function to compare elements.
+     *
+     * @param element The element to check for
+     */
+    contains(element: T): boolean;
+    /**
+     * Returns true if this collection contains all elements in the specified collection.
+     *
+     * @param other The collection whose elements to check for
+     */
+    containsAll(other: Iterable<T>): boolean;
+    /**
+     * Returns an array containing all elements in this collection.
+     * The returned array is safe to modify (it's a copy).
+     */
+    toArray(): T[];
+    /**
+     * Performs the given action for each element.
+     *
+     * @param action The action to perform for each element
+     */
+    forEach(action: (element: T, index: number) => void): void;
+    /**
+     * Returns the equality function used by this collection.
+     */
+    readonly eq: Eq<T>;
+}
+/**
+ * Collection<T> - The root interface for mutable collections.
+ *
+ * Mirrors java.util.Collection with mutation operations.
+ * All mutable collections should extend this or a more specific interface.
+ */
+export interface Collection<T> extends ReadonlyCollection<T> {
+    /**
+     * Adds an element to this collection.
+     *
+     * Returns true if the collection was modified as a result of this call.
+     * Some collections (like Set) may return false if the element already exists.
+     *
+     * @param element The element to add
+     * @returns true if the collection changed
+     * @throws Error if collection is full (bounded) and policy is 'throw'
+     */
+    add(element: T): boolean;
+    /**
+     * Adds all elements from the specified collection to this collection.
+     *
+     * @param other The collection whose elements to add
+     * @returns true if the collection changed
+     */
+    addAll(other: Iterable<T>): boolean;
+    /**
+     * Removes a single instance of the specified element from this collection.
+     *
+     * Returns true if an element was removed as a result of this call.
+     *
+     * @param element The element to remove
+     * @returns true if an element was removed
+     */
+    remove(element: T): boolean;
+    /**
+     * Removes all elements from this collection that are also in the specified collection.
+     *
+     * @param other The collection whose elements to remove
+     * @returns true if the collection changed
+     */
+    removeAll(other: Iterable<T>): boolean;
+    /**
+     * Retains only the elements in this collection that are in the specified collection.
+     * In other words, removes all elements not in the specified collection.
+     *
+     * @param other The collection of elements to retain
+     * @returns true if the collection changed
+     */
+    retainAll(other: Iterable<T>): boolean;
+    /**
+     * Removes all elements from this collection.
+     * The collection will be empty after this call returns.
+     */
+    clear(): void;
+}
+/**
+ * Utility type to check if a collection is readonly.
+ */
+export type IsReadonly<C> = C extends ReadonlyCollection<any> ? C extends Collection<any> ? false : true : false;
+/**
+ * Extract element type from a collection.
+ */
+export type ElementOf<C> = C extends ReadonlyCollection<infer T> ? T : never;
+/**
+ * Make a collection readonly by removing mutation methods.
+ */
+export type Readonly<C extends Collection<any>> = C extends Collection<infer T> ? ReadonlyCollection<T> : never;
+//# sourceMappingURL=collection.d.ts.map

package/dist/collections/interfaces/collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../../src/collections/interfaces/collection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;IACxD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;IAE9B;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IAEzC;;;OAGG;IACH,OAAO,IAAI,CAAC,EAAE,CAAC;IAEf;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,CAAE,SAAQ,kBAAkB,CAAC,CAAC,CAAC;IAC1D;;;;;;;;;OASG;IACH,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;IAEzB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IAEpC;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;IAE5B;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IAEvC;;;;;;OAMG;IACH,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IAEvC;;;OAGG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,kBAAkB,CAAC,GAAG,CAAC,GACzD,CAAC,SAAS,UAAU,CAAC,GAAG,CAAC,GACvB,KAAK,GACL,IAAI,GACN,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,CAAC,GAC3E,kBAAkB,CAAC,CAAC,CAAC,GACrB,KAAK,CAAC"}

package/dist/collections/interfaces/collection.js

@@ -0,0 +1,8 @@
+/**
+ * Base collection interfaces that mirror Java Collections Framework.
+ *
+ * These form the root of the collection hierarchy and define the
+ * fundamental operations common to all collections.
+ */
+export {};
+//# sourceMappingURL=collection.js.map

package/dist/collections/interfaces/collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.js","sourceRoot":"","sources":["../../../src/collections/interfaces/collection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/collections/interfaces/list.d.ts

@@ -0,0 +1,247 @@
+/**
+ * List interfaces that mirror Java's List interface.
+ *
+ * Lists are ordered collections that allow duplicate elements
+ * and provide positional (indexed) access to elements.
+ */
+import type { Collection, ReadonlyCollection } from "./collection.js";
+import type { Compare } from "../core/traits.js";
+/**
+ * ReadonlyList<T> - Readonly ordered collection with indexed access.
+ *
+ * Mirrors java.util.List but without mutation operations.
+ * Elements maintain their insertion order and can be accessed by index.
+ */
+export interface ReadonlyList<T> extends ReadonlyCollection<T> {
+    /**
+     * Returns the element at the specified position.
+     *
+     * @param index The index of the element to return (0-based)
+     * @returns The element at the specified position
+     * @throws RangeError if index is out of bounds
+     */
+    get(index: number): T;
+    /**
+     * Returns the index of the first occurrence of the specified element,
+     * or -1 if not found.
+     *
+     * @param element The element to search for
+     * @param fromIndex Optional starting index for the search
+     */
+    indexOf(element: T, fromIndex?: number): number;
+    /**
+     * Returns the index of the last occurrence of the specified element,
+     * or -1 if not found.
+     *
+     * @param element The element to search for
+     * @param fromIndex Optional starting index for backwards search
+     */
+    lastIndexOf(element: T, fromIndex?: number): number;
+    /**
+     * Returns a view of the portion of this list between fromIndex (inclusive)
+     * and toIndex (exclusive).
+     *
+     * Changes to the sublist are reflected in the original list.
+     *
+     * @param fromIndex Start index (inclusive)
+     * @param toIndex End index (exclusive)
+     */
+    subList(fromIndex: number, toIndex: number): ReadonlyList<T>;
+    /**
+     * Returns the first element in the list.
+     *
+     * @throws Error if list is empty
+     */
+    first(): T;
+    /**
+     * Returns the last element in the list.
+     *
+     * @throws Error if list is empty
+     */
+    last(): T;
+}
+/**
+ * List<T> - Mutable ordered collection with indexed access.
+ *
+ * Mirrors java.util.List with full mutation capabilities.
+ * Provides methods to insert, replace, and remove elements by index.
+ */
+export interface List<T> extends ReadonlyList<T>, Collection<T> {
+    /**
+     * Replaces the element at the specified position.
+     *
+     * @param index The index of the element to replace
+     * @param element The new element
+     * @returns The element previously at the specified position
+     * @throws RangeError if index is out of bounds
+     */
+    set(index: number, element: T): T;
+    /**
+     * Inserts an element at the specified position.
+     * Shifts elements at and after the position to the right.
+     *
+     * @param index The index at which to insert
+     * @param element The element to insert
+     * @throws RangeError if index is out of bounds (0 to size inclusive)
+     */
+    insert(index: number, element: T): void;
+    /**
+     * Inserts all elements from the specified collection at the specified position.
+     *
+     * @param index The index at which to insert
+     * @param other The collection whose elements to insert
+     * @returns true if the list changed
+     */
+    insertAll(index: number, other: Iterable<T>): boolean;
+    /**
+     * Removes the element at the specified position.
+     * Shifts elements after the position to the left.
+     *
+     * @param index The index of the element to remove
+     * @returns The element that was removed
+     * @throws RangeError if index is out of bounds
+     */
+    removeAt(index: number): T;
+    /**
+     * Removes elements in the specified index range.
+     *
+     * @param fromIndex Start index (inclusive)
+     * @param toIndex End index (exclusive)
+     */
+    removeRange(fromIndex: number, toIndex: number): void;
+    /**
+     * Sorts this list according to the specified comparator.
+     *
+     * @param compare The comparison function
+     */
+    sort(compare?: Compare<T>): void;
+    /**
+     * Reverses the order of elements in this list.
+     */
+    reverse(): void;
+    /**
+     * Returns a mutable sublist view.
+     *
+     * @param fromIndex Start index (inclusive)
+     * @param toIndex End index (exclusive)
+     */
+    subList(fromIndex: number, toIndex: number): List<T>;
+    /**
+     * Appends an element to the end of this list.
+     * Equivalent to add() but doesn't return boolean.
+     *
+     * @param element The element to append
+     */
+    push(element: T): void;
+    /**
+     * Removes and returns the last element in this list.
+     *
+     * @returns The last element
+     * @throws Error if list is empty
+     */
+    pop(): T;
+    /**
+     * Removes and returns the first element in this list.
+     *
+     * @returns The first element
+     * @throws Error if list is empty
+     */
+    shift(): T;
+    /**
+     * Prepends an element to the beginning of this list.
+     *
+     * @param element The element to prepend
+     */
+    unshift(element: T): void;
+}
+/**
+ * RandomAccess - Marker interface for lists with O(1) indexed access.
+ *
+ * Indicates that the list provides fast (constant-time) random access.
+ * Examples: ArrayList (yes), LinkedList (no).
+ */
+export interface RandomAccess {
+    /**
+     * Marker property to indicate random access capability.
+     * Always true for collections implementing this interface.
+     */
+    readonly supportsRandomAccess: true;
+}
+/**
+ * Stack<T> - LIFO (Last-In-First-Out) collection.
+ *
+ * A stack of elements with push/pop operations.
+ * Can be implemented as a specialized list or standalone.
+ */
+export interface Stack<T> extends Iterable<T> {
+    /** Number of elements */
+    readonly size: number;
+    /** True if empty */
+    readonly isEmpty: boolean;
+    /**
+     * Pushes an element onto the stack.
+     */
+    push(element: T): void;
+    /**
+     * Removes and returns the top element.
+     *
+     * @throws Error if stack is empty
+     */
+    pop(): T;
+    /**
+     * Returns the top element without removing it.
+     *
+     * @throws Error if stack is empty
+     */
+    peek(): T;
+    /**
+     * Removes all elements.
+     */
+    clear(): void;
+    /**
+     * Searches for an element and returns its distance from the top.
+     * Returns -1 if not found.
+     */
+    search(element: T): number;
+}
+/**
+ * Vector<T> - Synchronized growable array.
+ *
+ * Like ArrayList but with synchronized access.
+ * Legacy interface from Java; in our framework, use compose(synchronized())(arrayList()) instead.
+ */
+export interface Vector<T> extends List<T> {
+    /**
+     * Current capacity of the underlying array.
+     */
+    readonly capacity: number;
+    /**
+     * Trims capacity to current size to minimize memory usage.
+     */
+    trimToSize(): void;
+    /**
+     * Increases capacity to ensure it can hold at least the specified number of elements.
+     */
+    ensureCapacity(minCapacity: number): void;
+}
+/**
+ * CircularList<T> - List with circular/ring buffer behavior.
+ *
+ * When capacity is reached, oldest elements are overwritten.
+ * Useful for fixed-size buffers like logs or history.
+ */
+export interface CircularList<T> extends List<T> {
+    /**
+     * Maximum capacity of the circular list.
+     */
+    readonly capacity: number;
+    /**
+     * Returns true if the list has reached capacity.
+     */
+    readonly isFull: boolean;
+    /**
+     * Number of elements that have been overwritten.
+     */
+    readonly overwriteCount: number;
+}
+//# sourceMappingURL=list.d.ts.map

package/dist/collections/interfaces/list.d.ts.map

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

package/dist/collections/interfaces/list.js

@@ -0,0 +1,8 @@
+/**
+ * List interfaces that mirror Java's List interface.
+ *
+ * Lists are ordered collections that allow duplicate elements
+ * and provide positional (indexed) access to elements.
+ */
+export {};
+//# sourceMappingURL=list.js.map

package/dist/collections/interfaces/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/collections/interfaces/list.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}