@hotmeshio/hotmesh 0.14.1 → 0.14.2

package/build/services/pipe/functions/symbol.d.ts

@@ -1,12 +1,124 @@
+/**
+ * Provides methods for returning common symbolic values and objects,
+ * such as `null`, `undefined`, `whitespace`, `object`, `array`, and `date`.
+ * These methods can be used in a variety of contexts where it is necessary
+ * to represent these values or objects programmatically.
+ *
+ * @remarks
+ * Invoked in mapping rules using `{@symbol.<method>}` syntax.
+ * Symbol methods take no parameters; they are called directly
+ * in the `@pipe` structure.
+ */
 declare class SymbolHandler {
+    /**
+     * Returns the value `null`, representing a deliberate non-value.
+     *
+     * @returns {null} The null value
+     * @example
+     * ```yaml
+     * set_null:
+     *   "@pipe":
+     *     - ["{@symbol.null}"]
+     * ```
+     */
     null(): null;
+    /**
+     * Returns the value `undefined`, representing a variable
+     * that has not been assigned a value.
+     *
+     * @returns {undefined} The undefined value
+     * @example
+     * ```yaml
+     * set_undefined:
+     *   "@pipe":
+     *     - ["{@symbol.undefined}"]
+     * ```
+     */
     undefined(): undefined;
+    /**
+     * Returns a single whitespace character as a string.
+     *
+     * @returns {string} A single space character
+     * @example
+     * ```yaml
+     * set_whitespace:
+     *   "@pipe":
+     *     - ["{@symbol.whitespace}"]
+     * ```
+     */
     whitespace(): string;
+    /**
+     * Returns an empty object (`{}`).
+     *
+     * @returns {object} An empty object
+     * @example
+     * ```yaml
+     * set_object:
+     *   "@pipe":
+     *     - ["{@symbol.object}"]
+     * ```
+     */
     object(): object;
+    /**
+     * Returns an empty array (`[]`).
+     *
+     * @returns {any[]} An empty array
+     * @example
+     * ```yaml
+     * set_array:
+     *   "@pipe":
+     *     - ["{@symbol.array}"]
+     * ```
+     */
     array(): any[];
+    /**
+     * Returns the positive infinity value (`Infinity`).
+     *
+     * @returns {number} Positive infinity
+     * @example
+     * ```yaml
+     * set_pos_infinity:
+     *   "@pipe":
+     *     - ["{@symbol.posInfinity}"]
+     * ```
+     */
     posInfinity(): number;
+    /**
+     * Returns the negative infinity value (`-Infinity`).
+     *
+     * @returns {number} Negative infinity
+     * @example
+     * ```yaml
+     * set_neg_infinity:
+     *   "@pipe":
+     *     - ["{@symbol.negInfinity}"]
+     * ```
+     */
     negInfinity(): number;
+    /**
+     * Returns the not-a-number value (`NaN`).
+     *
+     * @returns {number} NaN
+     * @example
+     * ```yaml
+     * set_nan:
+     *   "@pipe":
+     *     - ["{@symbol.NaN}"]
+     * ```
+     */
     NaN(): number;
+    /**
+     * Returns the current date and time as a Date object.
+     *
+     * @returns {Date} The current date and time
+     * @example
+     * ```yaml
+     * set_date:
+     *   "@pipe":
+     *     - ["{@symbol.date}"]
+     *     - ["{@json.stringify}"]
+     * ```
+     */
     date(): Date;
 }
 export { SymbolHandler };

package/build/services/pipe/functions/symbol.js

@@ -1,31 +1,143 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SymbolHandler = void 0;
+/**
+ * Provides methods for returning common symbolic values and objects,
+ * such as `null`, `undefined`, `whitespace`, `object`, `array`, and `date`.
+ * These methods can be used in a variety of contexts where it is necessary
+ * to represent these values or objects programmatically.
+ *
+ * @remarks
+ * Invoked in mapping rules using `{@symbol.<method>}` syntax.
+ * Symbol methods take no parameters; they are called directly
+ * in the `@pipe` structure.
+ */
 class SymbolHandler {
+    /**
+     * Returns the value `null`, representing a deliberate non-value.
+     *
+     * @returns {null} The null value
+     * @example
+     * ```yaml
+     * set_null:
+     *   "@pipe":
+     *     - ["{@symbol.null}"]
+     * ```
+     */
     null() {
         return null;
     }
+    /**
+     * Returns the value `undefined`, representing a variable
+     * that has not been assigned a value.
+     *
+     * @returns {undefined} The undefined value
+     * @example
+     * ```yaml
+     * set_undefined:
+     *   "@pipe":
+     *     - ["{@symbol.undefined}"]
+     * ```
+     */
     undefined() {
         return undefined;
     }
+    /**
+     * Returns a single whitespace character as a string.
+     *
+     * @returns {string} A single space character
+     * @example
+     * ```yaml
+     * set_whitespace:
+     *   "@pipe":
+     *     - ["{@symbol.whitespace}"]
+     * ```
+     */
     whitespace() {
         return ' ';
     }
+    /**
+     * Returns an empty object (`{}`).
+     *
+     * @returns {object} An empty object
+     * @example
+     * ```yaml
+     * set_object:
+     *   "@pipe":
+     *     - ["{@symbol.object}"]
+     * ```
+     */
     object() {
         return {};
     }
+    /**
+     * Returns an empty array (`[]`).
+     *
+     * @returns {any[]} An empty array
+     * @example
+     * ```yaml
+     * set_array:
+     *   "@pipe":
+     *     - ["{@symbol.array}"]
+     * ```
+     */
     array() {
         return [];
     }
+    /**
+     * Returns the positive infinity value (`Infinity`).
+     *
+     * @returns {number} Positive infinity
+     * @example
+     * ```yaml
+     * set_pos_infinity:
+     *   "@pipe":
+     *     - ["{@symbol.posInfinity}"]
+     * ```
+     */
     posInfinity() {
         return Infinity;
     }
+    /**
+     * Returns the negative infinity value (`-Infinity`).
+     *
+     * @returns {number} Negative infinity
+     * @example
+     * ```yaml
+     * set_neg_infinity:
+     *   "@pipe":
+     *     - ["{@symbol.negInfinity}"]
+     * ```
+     */
     negInfinity() {
         return -Infinity;
     }
+    /**
+     * Returns the not-a-number value (`NaN`).
+     *
+     * @returns {number} NaN
+     * @example
+     * ```yaml
+     * set_nan:
+     *   "@pipe":
+     *     - ["{@symbol.NaN}"]
+     * ```
+     */
     NaN() {
         return NaN;
     }
+    /**
+     * Returns the current date and time as a Date object.
+     *
+     * @returns {Date} The current date and time
+     * @example
+     * ```yaml
+     * set_date:
+     *   "@pipe":
+     *     - ["{@symbol.date}"]
+     *     - ["{@json.stringify}"]
+     * ```
+     */
     date() {
         return new Date();
     }

package/build/services/pipe/functions/unary.d.ts

@@ -1,7 +1,72 @@
+/**
+ * Provides unary operation functions for use in HotMesh mapping rules.
+ * The functions facilitate unary operations such as logical negation,
+ * making a number positive or negative, and bitwise negation during
+ * the mapping process. Each transformation is a function that expects
+ * one input parameter from the prior row in the `@pipe` structure.
+ *
+ * @remarks
+ * Invoked in mapping rules using `{@unary.<method>}` syntax.
+ */
 declare class UnaryHandler {
+    /**
+     * Returns the logical negation of a boolean value.
+     *
+     * @param {boolean} value - The boolean value to negate
+     * @returns {boolean} The negated boolean value
+     * @example
+     * ```yaml
+     * not_value:
+     *   "@pipe":
+     *     - ["{a.output.data.value}"]
+     *     - ["{@unary.not}"]
+     * ```
+     */
     not(value: boolean): boolean;
+    /**
+     * Returns the positive representation of a number using
+     * the unary plus operator.
+     *
+     * @param {number} value - The number to convert
+     * @returns {number} The positive representation of the value
+     * @example
+     * ```yaml
+     * positive_value:
+     *   "@pipe":
+     *     - ["{a.output.data.value}"]
+     *     - ["{@unary.positive}"]
+     * ```
+     */
     positive(value: number): number;
+    /**
+     * Returns the negative representation of a number using
+     * the unary negation operator.
+     *
+     * @param {number} value - The number to negate
+     * @returns {number} The negated number
+     * @example
+     * ```yaml
+     * negative_value:
+     *   "@pipe":
+     *     - ["{a.output.data.value}"]
+     *     - ["{@unary.negative}"]
+     * ```
+     */
     negative(value: number): number;
+    /**
+     * Returns the bitwise negation of a number using the
+     * bitwise NOT operator (`~`).
+     *
+     * @param {number} value - The number to bitwise negate
+     * @returns {number} The bitwise negation of the value
+     * @example
+     * ```yaml
+     * bitwise_not_value:
+     *   "@pipe":
+     *     - ["{a.output.data.value}"]
+     *     - ["{@unary.bitwise_not}"]
+     * ```
+     */
     bitwise_not(value: number): number;
 }
 export { UnaryHandler };

package/build/services/pipe/functions/unary.js

@@ -1,16 +1,81 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UnaryHandler = void 0;
+/**
+ * Provides unary operation functions for use in HotMesh mapping rules.
+ * The functions facilitate unary operations such as logical negation,
+ * making a number positive or negative, and bitwise negation during
+ * the mapping process. Each transformation is a function that expects
+ * one input parameter from the prior row in the `@pipe` structure.
+ *
+ * @remarks
+ * Invoked in mapping rules using `{@unary.<method>}` syntax.
+ */
 class UnaryHandler {
+    /**
+     * Returns the logical negation of a boolean value.
+     *
+     * @param {boolean} value - The boolean value to negate
+     * @returns {boolean} The negated boolean value
+     * @example
+     * ```yaml
+     * not_value:
+     *   "@pipe":
+     *     - ["{a.output.data.value}"]
+     *     - ["{@unary.not}"]
+     * ```
+     */
     not(value) {
         return !value;
     }
+    /**
+     * Returns the positive representation of a number using
+     * the unary plus operator.
+     *
+     * @param {number} value - The number to convert
+     * @returns {number} The positive representation of the value
+     * @example
+     * ```yaml
+     * positive_value:
+     *   "@pipe":
+     *     - ["{a.output.data.value}"]
+     *     - ["{@unary.positive}"]
+     * ```
+     */
     positive(value) {
         return +value;
     }
+    /**
+     * Returns the negative representation of a number using
+     * the unary negation operator.
+     *
+     * @param {number} value - The number to negate
+     * @returns {number} The negated number
+     * @example
+     * ```yaml
+     * negative_value:
+     *   "@pipe":
+     *     - ["{a.output.data.value}"]
+     *     - ["{@unary.negative}"]
+     * ```
+     */
     negative(value) {
         return -value;
     }
+    /**
+     * Returns the bitwise negation of a number using the
+     * bitwise NOT operator (`~`).
+     *
+     * @param {number} value - The number to bitwise negate
+     * @returns {number} The bitwise negation of the value
+     * @example
+     * ```yaml
+     * bitwise_not_value:
+     *   "@pipe":
+     *     - ["{a.output.data.value}"]
+     *     - ["{@unary.bitwise_not}"]
+     * ```
+     */
     bitwise_not(value) {
         return ~value;
     }

package/build/services/virtual/index.js

@@ -173,6 +173,11 @@ class Virtual {
                 {
                     topic: params.topic,
                     connection,
+                    retry: params.retry ?? {
+                        maximumAttempts: 3,
+                        backoffCoefficient: 2,
+                        maximumInterval: 30,
+                    },
                     callback: async function (input) {
                         const response = await params.callback.apply(this, input.data.args);
                         return {
@@ -296,6 +301,7 @@ class Virtual {
                 connection: utils_1.polyfill.providerConfig(params),
                 callback: params.callback,
                 namespace: params.namespace,
+                retry: params.retry,
             });
             readonly = false;
         }

package/build/services/virtual/schemas/factory.js

@@ -180,7 +180,7 @@ const getWorkflowYAML = (appId = key_1.HMNS, version = exports.VERSION) => {
             conditions:
               match:
                 - expected: true
-                  actual: 
+                  actual:
                     '@pipe':
                       - ['{cycle_hook_cron.output.data.iterationCount}', '{trigger_cron.output.data.maxCycles}']
                       - ['{@conditional.less_than}']

package/build/types/virtual.d.ts

@@ -1,5 +1,6 @@
 import { ProviderConfig, ProvidersConfig } from './provider';
 import { LogLevel } from './logger';
+import { RetryPolicy } from './stream';
 interface VirtualExecOptions {
     /**
      * Cache id when caching, flushing and retrieving function results.
@@ -39,6 +40,16 @@ interface VirtualConnectParams {
      * The linked worker function that will be called; optional if read only
      */
     callback?: (...args: any[]) => any;
+    /**
+     * Retry policy for the worker. Controls retry behavior with
+     * exponential backoff when the callback throws.
+     *
+     * @example
+     * ```typescript
+     * { maximumAttempts: 3, backoffCoefficient: 2, maximumInterval: 30 }
+     * ```
+     */
+    retry?: RetryPolicy;
 }
 interface VirtualExecParams {
     /**
@@ -156,6 +167,16 @@ interface VirtualCronParams {
      * Options for the cron job
      */
     options: VirtualCronOptions;
+    /**
+     * Retry policy for the cron worker. Controls retry behavior with
+     * exponential backoff when the callback throws.
+     *
+     * @example
+     * ```typescript
+     * { maximumAttempts: 3, backoffCoefficient: 2, maximumInterval: 30 }
+     * ```
+     */
+    retry?: RetryPolicy;
 }
 interface VirtualInstanceOptions {
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hotmeshio/hotmesh",
-  "version": "0.14.1",
+  "version": "0.14.2",
   "description": "Durable Workflow",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",