@procedures/client 0.0.0-stage → 0.1.0

package/dist/collections/behaviors/synchronized.js

@@ -0,0 +1,294 @@
+/**
+ * Synchronized behavior - Provides thread-safe access with mutex locking.
+ *
+ * Wraps collections to serialize all operations using a mutex, ensuring
+ * thread-safe access in concurrent environments. Mirrors Java's
+ * Collections.synchronizedList() and related methods.
+ *
+ * Note: JavaScript is single-threaded, but async operations can interleave.
+ * This middleware ensures atomic operations across async boundaries.
+ *
+ * @example
+ * const list = compose(
+ *   synchronized()
+ * )(arrayList<number>())
+ *
+ * // All operations are now serialized
+ * await Promise.all([
+ *   list.add(1),
+ *   list.add(2),
+ *   list.add(3)
+ * ])
+ */
+/**
+ * Simple mutex implementation for JavaScript async operations.
+ *
+ * Ensures that only one operation executes at a time, even if
+ * multiple async operations are initiated concurrently.
+ */
+class Mutex {
+    queue = Promise.resolve();
+    /**
+     * Acquires the lock and executes the function.
+     * Other operations wait until this completes.
+     */
+    async lock(fn) {
+        const run = this.queue.then(() => fn());
+        this.queue = run.then(() => undefined, () => undefined);
+        return run;
+    }
+    /**
+     * Synchronous version that executes immediately.
+     * Still queues to prevent interleaving with async operations.
+     */
+    lockSync(fn) {
+        let result;
+        let error;
+        let hasError = false;
+        // Execute synchronously but update queue
+        try {
+            result = fn();
+        }
+        catch (e) {
+            error = e;
+            hasError = true;
+        }
+        // Update the queue to reflect this operation completed
+        const completed = Promise.resolve();
+        this.queue = this.queue.then(() => completed);
+        if (hasError) {
+            throw error;
+        }
+        return result;
+    }
+}
+/**
+ * Creates a synchronized middleware that locks all method calls.
+ *
+ * Every method call on the collection is wrapped with a mutex,
+ * ensuring atomic execution even in concurrent async scenarios.
+ *
+ * @example
+ * const syncList = compose(
+ *   synchronized()
+ * )(arrayList<number>())
+ *
+ * // These additions are guaranteed to execute in order
+ * await Promise.all([
+ *   syncList.add(1),
+ *   syncList.add(2),
+ *   syncList.add(3)
+ * ])
+ */
+export function synchronized() {
+    return (next) => {
+        const mutex = new Mutex();
+        return new Proxy(next, {
+            get(target, prop, receiver) {
+                const value = Reflect.get(target, prop, receiver);
+                // Don't wrap non-functions
+                if (typeof value !== "function") {
+                    return value;
+                }
+                // Check if the method is async by checking if it returns a Promise
+                return function (...args) {
+                    // Try to execute synchronously first
+                    const result = value.apply(target, args);
+                    // If result is a Promise, wrap with async lock
+                    if (result instanceof Promise) {
+                        return mutex.lock(() => result);
+                    }
+                    // Otherwise, use sync lock
+                    return mutex.lockSync(() => result);
+                };
+            },
+        });
+    };
+}
+/**
+ * Alias for Java compatibility: synchronizedList
+ */
+export const synchronizedList = synchronized;
+/**
+ * Alias for Java compatibility: synchronizedMap
+ */
+export const synchronizedMap = synchronized;
+/**
+ * Alias for Java compatibility: synchronizedCollection
+ */
+export const synchronizedCollection = synchronized;
+/**
+ * Alias for Java compatibility: synchronizedSet
+ */
+export const synchronizedSet = synchronized;
+/**
+ * Advanced synchronized middleware with reentrant locking.
+ *
+ * Allows the same "thread" (async context) to acquire the lock multiple times.
+ * Useful for methods that call other synchronized methods internally.
+ *
+ * Note: JavaScript doesn't have true thread IDs, so we use async context
+ * tracking if available, or fall back to non-reentrant behavior.
+ */
+export function reentrantSynchronized() {
+    return (next) => {
+        const mutex = new Mutex();
+        let lockHolder = null;
+        let lockCount = 0;
+        return new Proxy(next, {
+            get(target, prop, receiver) {
+                const value = Reflect.get(target, prop, receiver);
+                if (typeof value !== "function") {
+                    return value;
+                }
+                return async function (...args) {
+                    // Generate a unique ID for this call context
+                    const callerId = Symbol("caller");
+                    // If we already hold the lock, execute directly (reentrant)
+                    if (lockHolder === callerId) {
+                        lockCount++;
+                        try {
+                            const result = value.apply(target, args);
+                            return result instanceof Promise ? await result : result;
+                        }
+                        finally {
+                            lockCount--;
+                        }
+                    }
+                    // Otherwise, acquire the lock
+                    return mutex.lock(async () => {
+                        lockHolder = callerId;
+                        lockCount = 1;
+                        try {
+                            const result = value.apply(target, args);
+                            return result instanceof Promise ? await result : result;
+                        }
+                        finally {
+                            lockCount--;
+                            if (lockCount === 0) {
+                                lockHolder = null;
+                            }
+                        }
+                    });
+                };
+            },
+        });
+    };
+}
+/**
+ * Read-write lock implementation for collections.
+ *
+ * Allows multiple concurrent readers but exclusive writers.
+ * More efficient than full synchronization for read-heavy workloads.
+ *
+ * @example
+ * const list = compose(
+ *   readWriteLock()
+ * )(arrayList<number>())
+ *
+ * // Multiple reads can happen concurrently
+ * await Promise.all([
+ *   list.get(0),
+ *   list.get(1),
+ *   list.get(2)
+ * ])
+ */
+export function readWriteLock() {
+    return (next) => {
+        let readers = 0;
+        let writer = false;
+        let waitingReaders = [];
+        let waitingWriters = [];
+        const acquireRead = async () => {
+            if (writer || waitingWriters.length > 0) {
+                await new Promise((resolve) => waitingReaders.push(resolve));
+            }
+            readers++;
+        };
+        const releaseRead = () => {
+            readers--;
+            if (readers === 0 && waitingWriters.length > 0) {
+                writer = true;
+                const next = waitingWriters.shift();
+                next();
+            }
+        };
+        const acquireWrite = async () => {
+            if (writer || readers > 0) {
+                await new Promise((resolve) => waitingWriters.push(resolve));
+            }
+            writer = true;
+        };
+        const releaseWrite = () => {
+            writer = false;
+            if (waitingWriters.length > 0) {
+                writer = true;
+                const next = waitingWriters.shift();
+                next();
+            }
+            else if (waitingReaders.length > 0) {
+                const allReaders = waitingReaders.splice(0);
+                readers = allReaders.length;
+                allReaders.forEach((resolve) => resolve());
+            }
+        };
+        // Methods that only read (don't mutate)
+        const READ_METHODS = new Set([
+            "get",
+            "has",
+            "contains",
+            "containsAll",
+            "containsValue",
+            "indexOf",
+            "lastIndexOf",
+            "peek",
+            "peekFirst",
+            "peekLast",
+            "first",
+            "last",
+            "isEmpty",
+            "size",
+            "toArray",
+            "keys",
+            "values",
+            "entries",
+            "forEach",
+            "getOrDefault",
+            "getOrUndefined",
+        ]);
+        return new Proxy(next, {
+            get(target, prop, receiver) {
+                const value = Reflect.get(target, prop, receiver);
+                if (typeof value !== "function") {
+                    return value;
+                }
+                const isReadMethod = typeof prop === "string" && READ_METHODS.has(prop);
+                return async function (...args) {
+                    if (isReadMethod) {
+                        // Acquire read lock
+                        await acquireRead();
+                        try {
+                            const result = value.apply(target, args);
+                            return result instanceof Promise ? await result : result;
+                        }
+                        finally {
+                            releaseRead();
+                        }
+                    }
+                    else {
+                        // Acquire write lock
+                        await acquireWrite();
+                        try {
+                            const result = value.apply(target, args);
+                            return result instanceof Promise ? await result : result;
+                        }
+                        finally {
+                            releaseWrite();
+                        }
+                    }
+                };
+            },
+        });
+    };
+}
+//# sourceMappingURL=synchronized.js.map

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

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

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

@@ -0,0 +1,118 @@
+/**
+ * TTL (Time-To-Live) expiration behavior.
+ *
+ * Automatically expires elements after a specified time period.
+ * Perfect for temporary caches and time-limited data.
+ *
+ * @example
+ * const cache = compose(
+ *   ttlMap({ ttl: 60000 }) // 60 seconds
+ * )(hashMap<string, Data>())
+ *
+ * cache.set('key', data)
+ * // After 60 seconds, 'key' is automatically removed
+ */
+import type { Middleware } from "../core/middleware.js";
+import type { MapLike } from "../interfaces/map.js";
+import type { Collection } from "../interfaces/collection.js";
+/**
+ * Options for TTL behavior.
+ */
+export interface TTLOptions {
+    /**
+     * Time-to-live in milliseconds.
+     * Elements expire after this duration.
+     */
+    ttl: number;
+    /**
+     * Interval for checking expired elements (in milliseconds).
+     * @default 1000 (check every second)
+     */
+    checkInterval?: number;
+    /**
+     * Optional callback invoked when an element expires.
+     */
+    onExpire?: (info: {
+        key: any;
+        value: any;
+        createdAt: number;
+        expiredAt: number;
+    }) => void;
+}
+/**
+ * Creates a TTL Map middleware.
+ *
+ * Automatically removes entries after TTL expires.
+ * Uses a background interval to check for expired entries.
+ */
+export declare function ttlMap<K, V>(options: TTLOptions): Middleware<MapLike<K, V> & {
+    readonly dispose: () => void;
+}>;
+/**
+ * Creates a TTL Collection middleware.
+ *
+ * Note: This is less precise than TTL map because collections don't have keys.
+ * Elements are tracked by reference, which may not work for primitive types.
+ */
+export declare function ttlCollection<T>(options: Omit<TTLOptions, "onExpire"> & {
+    onExpire?: (info: {
+        element: T;
+        createdAt: number;
+        expiredAt: number;
+    }) => void;
+}): Middleware<Collection<T> & {
+    readonly dispose: () => void;
+}>;
+/**
+ * Standalone TTL cache with Map-like API.
+ *
+ * @example
+ * const cache = new TTLCache<string, number>(60000) // 60 second TTL
+ * cache.set('key', 42)
+ * setTimeout(() => {
+ *   cache.get('key') // undefined (expired)
+ * }, 61000)
+ */
+export declare class TTLCache<K, V> {
+    private readonly ttl;
+    private readonly checkInterval;
+    private readonly onExpire?;
+    private map;
+    private intervalId;
+    constructor(ttl: number, checkInterval?: number, onExpire?: ((key: K, value: V) => void) | undefined);
+    get size(): number;
+    get(key: K): V | undefined;
+    set(key: K, value: V, customTTL?: number): void;
+    has(key: K): boolean;
+    delete(key: K): boolean;
+    clear(): void;
+    /**
+     * Manually trigger cleanup of expired entries.
+     */
+    cleanup(): void;
+    /**
+     * Get remaining TTL for a key in milliseconds.
+     * Returns undefined if key doesn't exist or is expired.
+     */
+    getTTL(key: K): number | undefined;
+    /**
+     * Update TTL for an existing key.
+     */
+    touch(key: K, customTTL?: number): boolean;
+    private startExpirationCheck;
+    /**
+     * Stop the background expiration checker and clean up.
+     */
+    dispose(): void;
+    keys(): IterableIterator<K>;
+    values(): IterableIterator<V>;
+    entries(): IterableIterator<[K, V]>;
+}
+/**
+ * Factory function to create a TTL cache.
+ */
+export declare function ttlCache<K, V>(ttl: number, options?: {
+    checkInterval?: number;
+    onExpire?: (key: K, value: V) => void;
+}): TTLCache<K, V>;
+//# sourceMappingURL=ttl.d.ts.map

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

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