alepha 0.14.4 → 0.15.0

package/dist/thread/index.d.ts

@@ -3,7 +3,6 @@ import { KIND, Primitive, TSchema } from "alepha";
 import * as alepha_logger0 from "alepha/logger";
 
 //#region ../../src/thread/primitives/$thread.d.ts
-
 /**
  * Creates a worker thread primitive for offloading CPU-intensive tasks to separate threads.
  *
@@ -124,83 +123,83 @@ declare const $thread: {
 };
 interface ThreadPrimitiveOptions {
   /**
-   * Unique name for this thread worker.
-   *
-   * Used for:
-   * - Thread pool identification (threads with same name share the same pool)
-   * - Logging and debugging
-   * - Error messages and stack traces
-   *
-   * If not provided, defaults to the property key of the primitive.
-   *
-   * @example "image-processor"
-   * @example "crypto-worker"
-   * @example "data-analysis"
-   */
+       * Unique name for this thread worker.
+       *
+       * Used for:
+       * - Thread pool identification (threads with same name share the same pool)
+       * - Logging and debugging
+       * - Error messages and stack traces
+       *
+       * If not provided, defaults to the property key of the primitive.
+       *
+       * @example "image-processor"
+       * @example "crypto-worker"
+       * @example "data-analysis"
+       */
   name?: string;
   /**
-   * The function to execute in the worker thread.
-   *
-   * This function:
-   * - Runs in a separate Node.js worker thread
-   * - Should contain the CPU-intensive logic
-   * - Can be async and return any serializable data
-   * - Has access to standard Node.js APIs and modules
-   * - Cannot directly access the main thread's memory or variables
-   *
-   * **Important**: The handler function is serialized and sent to the worker thread,
-   * so it cannot reference variables from the parent scope (closures won't work).
-   * All required data must be passed via the `execute()` method.
-   *
-   * @example
-   * ```ts
-   * handler: async () => {
-   *   // CPU-intensive work here
-   *   const result = performComplexCalculation();
-   *   return { result, completed: Date.now() };
-   * }
-   * ```
-   */
+       * The function to execute in the worker thread.
+       *
+       * This function:
+       * - Runs in a separate Node.js worker thread
+       * - Should contain the CPU-intensive logic
+       * - Can be async and return any serializable data
+       * - Has access to standard Node.js APIs and modules
+       * - Cannot directly access the main thread's memory or variables
+       *
+       * **Important**: The handler function is serialized and sent to the worker thread,
+       * so it cannot reference variables from the parent scope (closures won't work).
+       * All required data must be passed via the `execute()` method.
+       *
+       * @example
+       * ```ts
+       * handler: async () => {
+       *   // CPU-intensive work here
+       *   const result = performComplexCalculation();
+       *   return { result, completed: Date.now() };
+       * }
+       * ```
+       */
   handler: () => any | Promise<any>;
   /**
-   * Maximum number of worker threads in the pool.
-   *
-   * Controls how many threads can run concurrently for this named thread worker.
-   * When all threads are busy, additional `execute()` calls will queue until a thread becomes available.
-   *
-   * **Default**: `cpus().length * 2` (number of CPU cores × 2)
-   *
-   * **Guidelines**:
-   * - For CPU-bound tasks: Set to number of CPU cores
-   * - For I/O-bound tasks in workers: Can be higher (2x CPU cores)
-   * - For memory-intensive tasks: Set lower to avoid memory pressure
-   * - For short-lived tasks: Can be higher for better throughput
-   *
-   * @default cpus().length * 2
-   * @example 4    // Limit to 4 concurrent threads
-   * @example 1    // Single worker thread (sequential processing)
-   * @example 16   // High concurrency for lightweight tasks
-   */
+       * Maximum number of worker threads in the pool.
+       *
+       * Controls how many threads can run concurrently for this named thread worker.
+       * When all threads are busy, additional `execute()` calls will queue until a thread becomes available.
+       *
+       * **Default**: `cpus().length * 2` (number of CPU cores × 2)
+       *
+       * **Guidelines**:
+       * - For CPU-bound tasks: Set to number of CPU cores
+       * - For I/O-bound tasks in workers: Can be higher (2x CPU cores)
+       * - For memory-intensive tasks: Set lower to avoid memory pressure
+       * - For short-lived tasks: Can be higher for better throughput
+       *
+       * @default cpus().length * 2
+       * @example 4    // Limit to 4 concurrent threads
+       * @example 1    // Single worker thread (sequential processing)
+       * @example 16   // High concurrency for lightweight tasks
+       */
   maxPoolSize?: number;
   /**
-   * Time in milliseconds before idle worker threads are terminated.
-   *
-   * When a worker thread has been idle (not executing any tasks) for this duration,
-   * it will be automatically terminated to free up system resources. New threads
-   * will be created as needed when new tasks are submitted.
-   *
-   * **Default**: 60000 (60 seconds)
-   *
-   * **Considerations**:
-   * - Shorter timeouts: Save memory but increase thread creation overhead
-   * - Longer timeouts: Keep threads ready but consume more memory
-   * - Very short timeouts may cause constant thread creation/destruction
-   *
-   * @default 60000
-   * @example 30000   // 30 seconds
-   * @example 120000  // 2 minutes
-   * @example 5000    // 5 seconds (for very memory-constrained environments)
-   */
+       * Time in milliseconds before idle worker threads are terminated.
+       *
+       * When a worker thread has been idle (not executing any tasks) for this duration,
+       * it will be automatically terminated to free up system resources. New threads
+       * will be created as needed when new tasks are submitted.
+       *
+       * **Default**: 60000 (60 seconds)
+       *
+       * **Considerations**:
+       * - Shorter timeouts: Save memory but increase thread creation overhead
+       * - Longer timeouts: Keep threads ready but consume more memory
+       * - Very short timeouts may cause constant thread creation/destruction
+       *
+       * @default 60000
+       * @example 30000   // 30 seconds
+       * @example 120000  // 2 minutes
+       * @example 5000    // 5 seconds (for very memory-constrained environments)
+       */
   idleTimeout?: number;
 }
 declare class ThreadPrimitive extends Primitive<ThreadPrimitiveOptions> {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/thread/primitives/$thread.ts","../../src/thread/providers/ThreadProvider.ts","../../src/thread/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAuHA;;;;;;AAMA;AAuFA;;;;;;;;;;;AAwDC;;;;;;;;;AChQD;;;;;;;;ACL8C;;;;;AAsB9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cF0Fa;YAAoB,yBAAyB;;;UAMzC,sBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAwCM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA+CV,eAAA,SAAwB,UAAU;;8BAEnB,YAAA;;;;;wCA6ByB,UAAU,QAAQ;YAe9C;eAKG;;cA6BtB,UAAA;;;;;;;;;YAgBY;;gCAqEoB,QAAQ;;;;eA8EzB;;;;cC3bR,cAAA;0BAAc,cAAA,CACH;;;;ED0GX,mBAEZ,KAAA,EC5GuB,OAAA,CAOE,aDqGzB,CAAA,OAAA,CAAA;EAFgC,OAAA,OAAA,CAAA,CAAA,EC5CA,OD4CA,CAAA,IAAA,CAAA;;;;;;;EAApB;;;;;;AAMb;AAuFA;AAA+C,cEvLlC,YFuLkC,EEvLtB,OAAA,CAAA,OFuLsB,CEnL7C,OAAA,CAJuB,MAAA,CFuLsB"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/thread/primitives/$thread.ts","../../src/thread/providers/ThreadProvider.ts","../../src/thread/index.ts"],"mappings":";;;;;;AAuHA;;;;;;AAMA;AAuFA;;;;;;;;;;;AAwDC;;;;;;;;;AChQD;;;;;;;;ACL8C;;;;;AAsB9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cF0Fa,OAAA;EAAA,CAAA,OAAA,EAAoB,sBAAA,GAAyB,eAAA;EAAA;;UAMzC,sBAAA;EAAA;AAuFjB;;;;;;;;;;;AAwDC;;EA/IgB,IAAA;EAAA;AAuFjB;;;;;;;;;;;AAwDC;;;;;;;;;AChQD;;EDiHiB,OAAA,cAwCM,OAAA;EAAA;AA+CvB;;;;;;;;;;;AAwDC;;;;;;;EAvGsB,WAAA;EAAA;AA+CvB;;;;;;;;;;;AAwDC;;;;;;;EAvGsB,WAAA;AAAA;AAAA,cA+CV,eAAA,SAAwB,SAAA,CAAU,sBAAA;EAAA,mBAAA,MAAA;EAAA,gBAAA,UAAA,EAEnB,GAAA,SAAA,UAAA;EAAA,IAAA,KAAA;EAAA,IAAA,YAAA;EAAA,IAAA,YAAA;EAAA,QAAA,OAAA;EAAA,OAAA,SAAA,CAAA,IAAA,QAAA,MAAA,GA6ByB,OAAA,GAAU,OAAA,CAAQ,CAAA;EAAA,OAAA,GAe9C,OAAA;EAAA,UAAA,GAKG,OAAA;AAAA;AAAA,cA6BtB,UAAA;EAAA,iBAAA,IAAA;EAAA,iBAAA,WAAA;EAAA,iBAAA,WAAA;EAAA,iBAAA,MAAA;EAAA,QAAA,SAAA;EAAA,QAAA,KAAA;EAAA,QAAA,SAAA;EAAA,YAAA,IAAA,UAAA,WAAA,UAAA,WAAA,UAAA,MAAA;EAAA,OAAA,GAgBY,OAAA;EAAA,QAAA,cAAA;EAAA,OAAA,SAAA,CAAA,IAAA,SAqEoB,OAAA,CAAQ,CAAA;EAAA,QAAA,YAAA;EAAA,QAAA,cAAA;EAAA,QAAA,oBAAA;EAAA,UAAA,GA8EzB,OAAA;AAAA;;;cC3bR,cAAA;EAAA,mBAAA,GAAA,EAAc,cAAA,CACH,MAAA;EAAA,mBAAA,GAAA;IAAA,aAAA;EAAA;EAAA,mBAAA,KAAA,EAAA,OAAA,CAOE,aAAA;EAAA,OAAA,QAAA,GAuDO,OAAA;AAAA;;;;;;;;;ACpEa;;;;;cAsBjC,YAAA,EAAY,OAAA,CAAA,OAAA,CAIvB,OAAA,CAJuB,MAAA"}