@hotmeshio/hotmesh 0.3.32 → 0.4.0

package/build/services/meshflow/workflow/didRun.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.didRun = void 0;
-const common_1 = require("./common");
-const context_1 = require("./context");
-/**
- * Determines if a replayed execution result already exists for the given prefix.
- * @private
- * @param {string} prefix - Identifier prefix (e.g., 'proxy', 'child', 'start', 'wait', etc.)
- * @returns {Promise<[boolean, number, any]>} A tuple: [alreadyRan, executionIndex, restoredData]
- */
-async function didRun(prefix) {
-    const { COUNTER, replay, workflowDimension } = (0, context_1.getContext)();
-    const execIndex = COUNTER.counter = COUNTER.counter + 1;
-    const sessionId = `-${prefix}${workflowDimension}-${execIndex}-`;
-    if (sessionId in replay) {
-        const restored = common_1.SerializerService.fromString(replay[sessionId]);
-        return [true, execIndex, restored];
-    }
-    return [false, execIndex, null];
-}
-exports.didRun = didRun;

package/build/services/meshflow/workflow/emit.d.ts

@@ -1,11 +0,0 @@
-import { StringAnyType } from './common';
-/**
- * Emits events to the event bus provider. Topics are prefixed with the quorum namespace.
- *
- * @param {StringAnyType} events - A mapping of topic => message to publish.
- * @param {{ once: boolean }} [config={ once: true }] - If `once` is true, events are emitted only once.
- * @returns {Promise<boolean>} True after emission completes.
- */
-export declare function emit(events: StringAnyType, config?: {
-    once: boolean;
-}): Promise<boolean>;

package/build/services/meshflow/workflow/emit.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.emit = void 0;
-const common_1 = require("./common");
-const isSideEffectAllowed_1 = require("./isSideEffectAllowed");
-/**
- * Emits events to the event bus provider. Topics are prefixed with the quorum namespace.
- *
- * @param {StringAnyType} events - A mapping of topic => message to publish.
- * @param {{ once: boolean }} [config={ once: true }] - If `once` is true, events are emitted only once.
- * @returns {Promise<boolean>} True after emission completes.
- */
-async function emit(events, config = { once: true }) {
-    const store = common_1.asyncLocalStorage.getStore();
-    const workflowTopic = store.get('workflowTopic');
-    const connection = store.get('connection');
-    const namespace = store.get('namespace');
-    const hotMeshClient = await common_1.WorkerService.getHotMesh(workflowTopic, {
-        connection,
-        namespace,
-    });
-    if (!config.once || await (0, isSideEffectAllowed_1.isSideEffectAllowed)(hotMeshClient, 'emit')) {
-        for (const [topic, message] of Object.entries(events)) {
-            await hotMeshClient.quorum.pub({ topic, message });
-        }
-    }
-    return true;
-}
-exports.emit = emit;

package/build/services/meshflow/workflow/enrich.d.ts

@@ -1,9 +0,0 @@
-import { StringStringType } from './common';
-/**
- * Adds custom user data to the backend workflow record (writes to HASH).
- * Runs exactly once during workflow execution.
- *
- * @param {StringStringType} fields - Key-value fields to enrich the workflow record.
- * @returns {Promise<boolean>} True when enrichment is completed.
- */
-export declare function enrich(fields: StringStringType): Promise<boolean>;

package/build/services/meshflow/workflow/enrich.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.enrich = void 0;
-const searchMethods_1 = require("./searchMethods");
-/**
- * Adds custom user data to the backend workflow record (writes to HASH).
- * Runs exactly once during workflow execution.
- *
- * @param {StringStringType} fields - Key-value fields to enrich the workflow record.
- * @returns {Promise<boolean>} True when enrichment is completed.
- */
-async function enrich(fields) {
-    const searchSession = await (0, searchMethods_1.search)();
-    await searchSession.set(fields);
-    return true;
-}
-exports.enrich = enrich;

package/build/services/meshflow/workflow/execChild.d.ts

@@ -1,18 +0,0 @@
-import { WorkflowOptions } from './common';
-/**
- * Spawns a child workflow and awaits the result, or if `await` is false, returns immediately.
- * @template T
- * @param {WorkflowOptions} options - Workflow options.
- * @returns {Promise<T>} Result of the child workflow.
- */
-export declare function execChild<T>(options: WorkflowOptions): Promise<T>;
-/**
- * Alias for execChild.
- */
-export declare const executeChild: typeof execChild;
-/**
- * Spawns a child workflow and returns the child Job ID without awaiting its completion.
- * @param {WorkflowOptions} options - Workflow options.
- * @returns {Promise<string>} The child job ID.
- */
-export declare function startChild(options: WorkflowOptions): Promise<string>;

package/build/services/meshflow/workflow/execChild.js

@@ -1,102 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.startChild = exports.executeChild = exports.execChild = void 0;
-const common_1 = require("./common");
-const context_1 = require("./context");
-const didRun_1 = require("./didRun");
-/**
- * Constructs the payload necessary to spawn a child workflow.
- * @private
- */
-function getChildInterruptPayload(context, options, execIndex) {
-    const { workflowId, originJobId, workflowDimension, expire } = context;
-    let childJobId;
-    if (options.workflowId) {
-        childJobId = options.workflowId;
-    }
-    else if (options.entity) {
-        childJobId = `${options.entity}-${(0, common_1.guid)()}-${workflowDimension}-${execIndex}`;
-    }
-    else {
-        childJobId = `-${options.workflowName}-${(0, common_1.guid)()}-${workflowDimension}-${execIndex}`;
-    }
-    const parentWorkflowId = workflowId;
-    const taskQueueName = options.taskQueue ?? options.entity;
-    const workflowName = options.entity ?? options.workflowName;
-    const workflowTopic = `${taskQueueName}-${workflowName}`;
-    return {
-        arguments: [...(options.args || [])],
-        await: options?.await ?? true,
-        backoffCoefficient: options?.config?.backoffCoefficient ?? common_1.HMSH_MESHFLOW_EXP_BACKOFF,
-        index: execIndex,
-        maximumAttempts: options?.config?.maximumAttempts ?? common_1.HMSH_MESHFLOW_MAX_ATTEMPTS,
-        maximumInterval: (0, common_1.s)(options?.config?.maximumInterval ?? common_1.HMSH_MESHFLOW_MAX_INTERVAL),
-        originJobId: originJobId ?? workflowId,
-        expire: options.expire ?? expire,
-        persistent: options.persistent,
-        signalIn: options.signalIn,
-        parentWorkflowId,
-        workflowDimension: workflowDimension,
-        workflowId: childJobId,
-        workflowTopic,
-    };
-}
-/**
- * Spawns a child workflow and awaits the result, or if `await` is false, returns immediately.
- * @template T
- * @param {WorkflowOptions} options - Workflow options.
- * @returns {Promise<T>} Result of the child workflow.
- */
-async function execChild(options) {
-    const isStartChild = options.await === false;
-    const prefix = isStartChild ? 'start' : 'child';
-    const [didRunAlready, execIndex, result] = await (0, didRun_1.didRun)(prefix);
-    const context = (0, context_1.getContext)();
-    const { canRetry, interruptionRegistry } = context;
-    if (didRunAlready) {
-        if (result?.$error && (!result.$error.is_stream_error || !canRetry)) {
-            if (options?.config?.throwOnError !== false) {
-                const code = result.$error.code;
-                const message = result.$error.message;
-                const stack = result.$error.stack;
-                if (code === common_1.HMSH_CODE_MESHFLOW_FATAL) {
-                    throw new common_1.MeshFlowFatalError(message, stack);
-                }
-                else if (code === common_1.HMSH_CODE_MESHFLOW_MAXED) {
-                    throw new common_1.MeshFlowMaxedError(message, stack);
-                }
-                else if (code === common_1.HMSH_CODE_MESHFLOW_TIMEOUT) {
-                    throw new common_1.MeshFlowTimeoutError(message, stack);
-                }
-                else {
-                    throw new common_1.MeshFlowRetryError(message, stack);
-                }
-            }
-            return result.$error;
-        }
-        else if (!result?.$error) {
-            return result.data;
-        }
-    }
-    const interruptionMessage = getChildInterruptPayload(context, options, execIndex);
-    interruptionRegistry.push({
-        code: common_1.HMSH_CODE_MESHFLOW_CHILD,
-        ...interruptionMessage,
-    });
-    await (0, common_1.sleepImmediate)();
-    throw new common_1.MeshFlowChildError(interruptionMessage);
-}
-exports.execChild = execChild;
-/**
- * Alias for execChild.
- */
-exports.executeChild = execChild;
-/**
- * Spawns a child workflow and returns the child Job ID without awaiting its completion.
- * @param {WorkflowOptions} options - Workflow options.
- * @returns {Promise<string>} The child job ID.
- */
-async function startChild(options) {
-    return execChild({ ...options, await: false });
-}
-exports.startChild = startChild;

package/build/services/meshflow/workflow/hook.d.ts

@@ -1,9 +0,0 @@
-import { HookOptions } from './common';
-/**
- * Spawns a hook from the main thread or a hook thread.
- * If entity/workflowName are not provided, defaults to the current workflow.
- *
- * @param {HookOptions} options - Hook configuration options.
- * @returns {Promise<string>} The resulting hook/stream ID.
- */
-export declare function hook(options: HookOptions): Promise<string>;

package/build/services/meshflow/workflow/hook.js

@@ -1,40 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.hook = void 0;
-const common_1 = require("./common");
-const context_1 = require("./context");
-const isSideEffectAllowed_1 = require("./isSideEffectAllowed");
-/**
- * Spawns a hook from the main thread or a hook thread.
- * If entity/workflowName are not provided, defaults to the current workflow.
- *
- * @param {HookOptions} options - Hook configuration options.
- * @returns {Promise<string>} The resulting hook/stream ID.
- */
-async function hook(options) {
-    const { workflowId, connection, namespace, workflowTopic } = (0, context_1.getContext)();
-    const hotMeshClient = await common_1.WorkerService.getHotMesh(workflowTopic, {
-        connection,
-        namespace,
-    });
-    if (await (0, isSideEffectAllowed_1.isSideEffectAllowed)(hotMeshClient, 'hook')) {
-        const targetWorkflowId = options.workflowId ?? workflowId;
-        let targetTopic;
-        if (options.entity || (options.taskQueue && options.workflowName)) {
-            targetTopic = `${options.taskQueue ?? options.entity}-${options.entity ?? options.workflowName}`;
-        }
-        else {
-            targetTopic = workflowTopic;
-        }
-        const payload = {
-            arguments: [...options.args],
-            id: targetWorkflowId,
-            workflowTopic: targetTopic,
-            backoffCoefficient: options.config?.backoffCoefficient || common_1.HMSH_MESHFLOW_EXP_BACKOFF,
-            maximumAttempts: options.config?.maximumAttempts || common_1.HMSH_MESHFLOW_MAX_ATTEMPTS,
-            maximumInterval: (0, common_1.s)(options?.config?.maximumInterval ?? common_1.HMSH_MESHFLOW_MAX_INTERVAL),
-        };
-        return await hotMeshClient.hook(`${namespace}.flow.signal`, payload, common_1.StreamStatus.PENDING, 202);
-    }
-}
-exports.hook = hook;

package/build/services/meshflow/workflow/index.d.ts

@@ -1,70 +0,0 @@
-import { getContext } from './context';
-import { didRun } from './didRun';
-import { isSideEffectAllowed } from './isSideEffectAllowed';
-import { trace } from './trace';
-import { enrich } from './enrich';
-import { emit } from './emit';
-import { execChild, startChild } from './execChild';
-import { proxyActivities } from './proxyActivities';
-import { search } from './searchMethods';
-import { random } from './random';
-import { signal } from './signal';
-import { hook } from './hook';
-import { interrupt } from './interrupt';
-import { all } from './all';
-import { sleepFor } from './sleepFor';
-import { waitFor } from './waitFor';
-import { HotMesh } from './common';
-/**
- * The WorkflowService class provides a set of static methods to be used within a workflow function.
- * These methods ensure deterministic replay, persistence of state, and error handling across
- * re-entrant workflow executions.
- *
- * By refactoring the original single-file implementation into submodules,
- * we maintain clear separation of concerns and improved maintainability,
- * while preserving type information and full functionality.
- *
- * @example
- * ```typescript
- * import { MeshFlow } from '@hotmeshio/hotmesh';
- *
- * export async function waitForExample(): Promise<[boolean, number]> {
- *   const [s1, s2] = await Promise.all([
- *     MeshFlow.workflow.waitFor<boolean>('my-sig-nal-1'),
- *     MeshFlow.workflow.waitFor<number>('my-sig-nal-2')
- *   ]);
- *   return [s1, s2];
- * }
- * ```
- */
-export declare class WorkflowService {
-    /**
-     * @private
-     * The constructor is private to prevent instantiation;
-     * all methods are static.
-     */
-    private constructor();
-    static getContext: typeof getContext;
-    static didRun: typeof didRun;
-    static isSideEffectAllowed: typeof isSideEffectAllowed;
-    static trace: typeof trace;
-    static enrich: typeof enrich;
-    static emit: typeof emit;
-    static execChild: typeof execChild;
-    static executeChild: typeof execChild;
-    static startChild: typeof startChild;
-    static proxyActivities: typeof proxyActivities;
-    static search: typeof search;
-    static random: typeof random;
-    static signal: typeof signal;
-    static hook: typeof hook;
-    static interrupt: typeof interrupt;
-    static all: typeof all;
-    static sleepFor: typeof sleepFor;
-    static waitFor: typeof waitFor;
-    /**
-     * Return a handle to the HotMesh client hosting the workflow execution.
-     * @returns {Promise<HotMesh>} The HotMesh client instance.
-     */
-    static getHotMesh(): Promise<HotMesh>;
-}

package/build/services/meshflow/workflow/index.js

@@ -1,83 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkflowService = void 0;
-const context_1 = require("./context");
-const didRun_1 = require("./didRun");
-const isSideEffectAllowed_1 = require("./isSideEffectAllowed");
-const trace_1 = require("./trace");
-const enrich_1 = require("./enrich");
-const emit_1 = require("./emit");
-const execChild_1 = require("./execChild");
-const proxyActivities_1 = require("./proxyActivities");
-const searchMethods_1 = require("./searchMethods");
-const random_1 = require("./random");
-const signal_1 = require("./signal");
-const hook_1 = require("./hook");
-const interrupt_1 = require("./interrupt");
-const all_1 = require("./all");
-const sleepFor_1 = require("./sleepFor");
-const waitFor_1 = require("./waitFor");
-const common_1 = require("./common");
-/**
- * The WorkflowService class provides a set of static methods to be used within a workflow function.
- * These methods ensure deterministic replay, persistence of state, and error handling across
- * re-entrant workflow executions.
- *
- * By refactoring the original single-file implementation into submodules,
- * we maintain clear separation of concerns and improved maintainability,
- * while preserving type information and full functionality.
- *
- * @example
- * ```typescript
- * import { MeshFlow } from '@hotmeshio/hotmesh';
- *
- * export async function waitForExample(): Promise<[boolean, number]> {
- *   const [s1, s2] = await Promise.all([
- *     MeshFlow.workflow.waitFor<boolean>('my-sig-nal-1'),
- *     MeshFlow.workflow.waitFor<number>('my-sig-nal-2')
- *   ]);
- *   return [s1, s2];
- * }
- * ```
- */
-class WorkflowService {
-    /**
-     * @private
-     * The constructor is private to prevent instantiation;
-     * all methods are static.
-     */
-    constructor() { }
-    /**
-     * Return a handle to the HotMesh client hosting the workflow execution.
-     * @returns {Promise<HotMesh>} The HotMesh client instance.
-     */
-    static async getHotMesh() {
-        const store = common_1.asyncLocalStorage.getStore();
-        const workflowTopic = store.get('workflowTopic');
-        const connection = store.get('connection');
-        const namespace = store.get('namespace');
-        return await common_1.WorkerService.getHotMesh(workflowTopic, {
-            connection,
-            namespace,
-        });
-    }
-}
-WorkflowService.getContext = context_1.getContext;
-WorkflowService.didRun = didRun_1.didRun;
-WorkflowService.isSideEffectAllowed = isSideEffectAllowed_1.isSideEffectAllowed;
-WorkflowService.trace = trace_1.trace;
-WorkflowService.enrich = enrich_1.enrich;
-WorkflowService.emit = emit_1.emit;
-WorkflowService.execChild = execChild_1.execChild;
-WorkflowService.executeChild = execChild_1.executeChild;
-WorkflowService.startChild = execChild_1.startChild;
-WorkflowService.proxyActivities = proxyActivities_1.proxyActivities;
-WorkflowService.search = searchMethods_1.search;
-WorkflowService.random = random_1.random;
-WorkflowService.signal = signal_1.signal;
-WorkflowService.hook = hook_1.hook;
-WorkflowService.interrupt = interrupt_1.interrupt;
-WorkflowService.all = all_1.all;
-WorkflowService.sleepFor = sleepFor_1.sleepFor;
-WorkflowService.waitFor = waitFor_1.waitFor;
-exports.WorkflowService = WorkflowService;

package/build/services/meshflow/workflow/interrupt.d.ts

@@ -1,9 +0,0 @@
-import { JobInterruptOptions } from './common';
-/**
- * Interrupts a running job by sending an interruption request.
- *
- * @param {string} jobId - The ID of the job to interrupt.
- * @param {JobInterruptOptions} options - Additional interruption options.
- * @returns {Promise<string|void>} Result of the interruption, if any.
- */
-export declare function interrupt(jobId: string, options?: JobInterruptOptions): Promise<string | void>;

package/build/services/meshflow/workflow/interrupt.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.interrupt = void 0;
-const common_1 = require("./common");
-const context_1 = require("./context");
-const isSideEffectAllowed_1 = require("./isSideEffectAllowed");
-/**
- * Interrupts a running job by sending an interruption request.
- *
- * @param {string} jobId - The ID of the job to interrupt.
- * @param {JobInterruptOptions} options - Additional interruption options.
- * @returns {Promise<string|void>} Result of the interruption, if any.
- */
-async function interrupt(jobId, options = {}) {
-    const { workflowTopic, connection, namespace } = (0, context_1.getContext)();
-    const hotMeshClient = await common_1.WorkerService.getHotMesh(workflowTopic, {
-        connection,
-        namespace,
-    });
-    if (await (0, isSideEffectAllowed_1.isSideEffectAllowed)(hotMeshClient, 'interrupt')) {
-        return await hotMeshClient.interrupt(`${hotMeshClient.appId}.execute`, jobId, options);
-    }
-}
-exports.interrupt = interrupt;

package/build/services/meshflow/workflow/isSideEffectAllowed.d.ts

@@ -1,10 +0,0 @@
-import { HotMesh } from './common';
-/**
- * Checks if a side-effect is allowed to run. This ensures certain actions
- * are executed exactly once.
- * @private
- * @param {HotMesh} hotMeshClient - The HotMesh client.
- * @param {string} prefix - A unique prefix representing the action (e.g., 'trace', 'emit', etc.)
- * @returns {Promise<boolean>} True if the side effect can run, false otherwise.
- */
-export declare function isSideEffectAllowed(hotMeshClient: HotMesh, prefix: string): Promise<boolean>;

package/build/services/meshflow/workflow/isSideEffectAllowed.js

@@ -1,33 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isSideEffectAllowed = void 0;
-const common_1 = require("./common");
-/**
- * Checks if a side-effect is allowed to run. This ensures certain actions
- * are executed exactly once.
- * @private
- * @param {HotMesh} hotMeshClient - The HotMesh client.
- * @param {string} prefix - A unique prefix representing the action (e.g., 'trace', 'emit', etc.)
- * @returns {Promise<boolean>} True if the side effect can run, false otherwise.
- */
-async function isSideEffectAllowed(hotMeshClient, prefix) {
-    const store = common_1.asyncLocalStorage.getStore();
-    const workflowId = store.get('workflowId');
-    const workflowDimension = store.get('workflowDimension') ?? '';
-    const COUNTER = store.get('counter');
-    const execIndex = COUNTER.counter = COUNTER.counter + 1;
-    const sessionId = `-${prefix}${workflowDimension}-${execIndex}-`;
-    const replay = store.get('replay');
-    if (sessionId in replay) {
-        return false;
-    }
-    const keyParams = {
-        appId: hotMeshClient.appId,
-        jobId: workflowId,
-    };
-    const workflowGuid = common_1.KeyService.mintKey(hotMeshClient.namespace, common_1.KeyType.JOB_STATE, keyParams);
-    const searchClient = hotMeshClient.engine.search;
-    const guidValue = await searchClient.incrementFieldByFloat(workflowGuid, sessionId, 1);
-    return guidValue === 1;
-}
-exports.isSideEffectAllowed = isSideEffectAllowed;

package/build/services/meshflow/workflow/proxyActivities.d.ts

@@ -1,20 +0,0 @@
-import { ActivityConfig, ProxyType, MeshFlowProxyErrorType } from './common';
-import { getContext } from './context';
-/**
- * Constructs payload for spawning a proxyActivity job.
- * @private
- */
-declare function getProxyInterruptPayload(context: ReturnType<typeof getContext>, activityName: string, execIndex: number, args: any[], options?: ActivityConfig): MeshFlowProxyErrorType;
-/**
- * Wraps a single activity in a proxy, orchestrating its execution and replay.
- * @private
- */
-declare function wrapActivity<T>(activityName: string, options?: ActivityConfig): T;
-/**
- * Provides a proxy for defined activities, ensuring deterministic replay and retry.
- * @template ACT
- * @param {ActivityConfig} [options] - Optional activity config (includes retryPolicy).
- * @returns {ProxyType<ACT>} A proxy to call activities as if local, but durably managed by the workflow.
- */
-export declare function proxyActivities<ACT>(options?: ActivityConfig): ProxyType<ACT>;
-export { wrapActivity, getProxyInterruptPayload };

package/build/services/meshflow/workflow/proxyActivities.js

@@ -1,97 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getProxyInterruptPayload = exports.wrapActivity = exports.proxyActivities = void 0;
-const common_1 = require("./common");
-const context_1 = require("./context");
-const didRun_1 = require("./didRun");
-/**
- * Constructs payload for spawning a proxyActivity job.
- * @private
- */
-function getProxyInterruptPayload(context, activityName, execIndex, args, options) {
-    const { workflowDimension, workflowId, originJobId, workflowTopic, expire } = context;
-    const activityTopic = `${workflowTopic}-activity`;
-    const activityJobId = `-${workflowId}-$${activityName}${workflowDimension}-${execIndex}`;
-    let maximumInterval;
-    if (options?.retryPolicy?.maximumInterval) {
-        maximumInterval = (0, common_1.s)(options.retryPolicy.maximumInterval);
-    }
-    return {
-        arguments: args,
-        workflowDimension,
-        index: execIndex,
-        originJobId: originJobId || workflowId,
-        parentWorkflowId: workflowId,
-        workflowId: activityJobId,
-        workflowTopic: activityTopic,
-        activityName,
-        expire: options?.expire ?? expire,
-        backoffCoefficient: options?.retryPolicy?.backoffCoefficient ?? undefined,
-        maximumAttempts: options?.retryPolicy?.maximumAttempts ?? undefined,
-        maximumInterval: maximumInterval ?? undefined,
-    };
-}
-exports.getProxyInterruptPayload = getProxyInterruptPayload;
-/**
- * Wraps a single activity in a proxy, orchestrating its execution and replay.
- * @private
- */
-function wrapActivity(activityName, options) {
-    return async function (...args) {
-        const [didRunAlready, execIndex, result] = await (0, didRun_1.didRun)('proxy');
-        if (didRunAlready) {
-            if (result?.$error) {
-                if (options?.retryPolicy?.throwOnError !== false) {
-                    const code = result.$error.code;
-                    const message = result.$error.message;
-                    const stack = result.$error.stack;
-                    if (code === common_1.HMSH_CODE_MESHFLOW_FATAL) {
-                        throw new common_1.MeshFlowFatalError(message, stack);
-                    }
-                    else if (code === common_1.HMSH_CODE_MESHFLOW_MAXED) {
-                        throw new common_1.MeshFlowMaxedError(message, stack);
-                    }
-                    else if (code === common_1.HMSH_CODE_MESHFLOW_TIMEOUT) {
-                        throw new common_1.MeshFlowTimeoutError(message, stack);
-                    }
-                    else {
-                        // Non-fatal error
-                    }
-                }
-                return result.$error;
-            }
-            return result.data;
-        }
-        const context = (0, context_1.getContext)();
-        const { interruptionRegistry } = context;
-        const interruptionMessage = getProxyInterruptPayload(context, activityName, execIndex, args, options);
-        interruptionRegistry.push({
-            code: common_1.HMSH_CODE_MESHFLOW_PROXY,
-            ...interruptionMessage,
-        });
-        await (0, common_1.sleepImmediate)();
-        throw new common_1.MeshFlowProxyError(interruptionMessage);
-    };
-}
-exports.wrapActivity = wrapActivity;
-/**
- * Provides a proxy for defined activities, ensuring deterministic replay and retry.
- * @template ACT
- * @param {ActivityConfig} [options] - Optional activity config (includes retryPolicy).
- * @returns {ProxyType<ACT>} A proxy to call activities as if local, but durably managed by the workflow.
- */
-function proxyActivities(options) {
-    if (options?.activities) {
-        common_1.WorkerService.registerActivities(options.activities);
-    }
-    const proxy = {};
-    const keys = Object.keys(common_1.WorkerService.activityRegistry);
-    if (keys.length) {
-        keys.forEach((key) => {
-            const activityFunction = common_1.WorkerService.activityRegistry[key];
-            proxy[key] = wrapActivity(key, options);
-        });
-    }
-    return proxy;
-}
-exports.proxyActivities = proxyActivities;

package/build/services/meshflow/workflow/random.d.ts

@@ -1,6 +0,0 @@
-/**
- * Returns a deterministic random number between 0 and 1. The number is derived from the
- * current execution index, ensuring deterministic replay.
- * @returns {number} A deterministic pseudo-random number between 0 and 1.
- */
-export declare function random(): number;

package/build/services/meshflow/workflow/random.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.random = void 0;
-const common_1 = require("./common");
-/**
- * Returns a deterministic random number between 0 and 1. The number is derived from the
- * current execution index, ensuring deterministic replay.
- * @returns {number} A deterministic pseudo-random number between 0 and 1.
- */
-function random() {
-    const store = common_1.asyncLocalStorage.getStore();
-    const COUNTER = store.get('counter');
-    const seed = COUNTER.counter = COUNTER.counter + 1;
-    return (0, common_1.deterministicRandom)(seed);
-}
-exports.random = random;

package/build/services/meshflow/workflow/searchMethods.d.ts

@@ -1,6 +0,0 @@
-import { Search } from './common';
-/**
- * Returns a search session handle for interacting with the workflow's HASH storage.
- * @returns {Promise<Search>} A search session for workflow data.
- */
-export declare function search(): Promise<Search>;