@hotmeshio/hotmesh 0.3.32 → 0.4.0

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

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.search = void 0;
-const common_1 = require("./common");
-/**
- * Returns a search session handle for interacting with the workflow's HASH storage.
- * @returns {Promise<Search>} A search session for workflow data.
- */
-async function search() {
-    const store = common_1.asyncLocalStorage.getStore();
-    const workflowId = store.get('workflowId');
-    const workflowDimension = store.get('workflowDimension') ?? '';
-    const workflowTopic = store.get('workflowTopic');
-    const connection = store.get('connection');
-    const namespace = store.get('namespace');
-    const COUNTER = store.get('counter');
-    const execIndex = COUNTER.counter = COUNTER.counter + 1;
-    const hotMeshClient = await common_1.WorkerService.getHotMesh(workflowTopic, {
-        connection,
-        namespace,
-    });
-    const searchSessionId = `-search${workflowDimension}-${execIndex}`;
-    return new common_1.Search(workflowId, hotMeshClient, searchSessionId);
-}
-exports.search = search;

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

@@ -1,7 +0,0 @@
-/**
- * Sends a signal payload to any paused workflow thread awaiting this signal.
- * @param {string} signalId - Unique signal identifier.
- * @param {Record<any, any>} data - The payload to send with the signal.
- * @returns {Promise<string>} The resulting hook/stream ID.
- */
-export declare function signal(signalId: string, data: Record<any, any>): Promise<string>;

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

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.signal = void 0;
-const common_1 = require("./common");
-const isSideEffectAllowed_1 = require("./isSideEffectAllowed");
-/**
- * Sends a signal payload to any paused workflow thread awaiting this signal.
- * @param {string} signalId - Unique signal identifier.
- * @param {Record<any, any>} data - The payload to send with the signal.
- * @returns {Promise<string>} The resulting hook/stream ID.
- */
-async function signal(signalId, data) {
-    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 (await (0, isSideEffectAllowed_1.isSideEffectAllowed)(hotMeshClient, 'signal')) {
-        return await hotMeshClient.hook(`${namespace}.wfs.signal`, {
-            id: signalId,
-            data,
-        });
-    }
-}
-exports.signal = signal;

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

@@ -1,8 +0,0 @@
-/**
- * Sleeps the workflow for a specified duration, deterministically.
- * On replay, it will not actually sleep again, but resume after sleep.
- *
- * @param {string} duration - A human-readable duration string (e.g., '1m', '2 hours').
- * @returns {Promise<number>} The resolved duration in seconds.
- */
-export declare function sleepFor(duration: string): Promise<number>;

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

@@ -1,35 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.sleepFor = void 0;
-const common_1 = require("./common");
-const didRun_1 = require("./didRun");
-/**
- * Sleeps the workflow for a specified duration, deterministically.
- * On replay, it will not actually sleep again, but resume after sleep.
- *
- * @param {string} duration - A human-readable duration string (e.g., '1m', '2 hours').
- * @returns {Promise<number>} The resolved duration in seconds.
- */
-async function sleepFor(duration) {
-    const [didRunAlready, execIndex, result] = await (0, didRun_1.didRun)('sleep');
-    if (didRunAlready) {
-        return result.duration;
-    }
-    const store = common_1.asyncLocalStorage.getStore();
-    const interruptionRegistry = store.get('interruptionRegistry');
-    const workflowId = store.get('workflowId');
-    const workflowDimension = store.get('workflowDimension') ?? '';
-    const interruptionMessage = {
-        workflowId,
-        duration: (0, common_1.s)(duration),
-        index: execIndex,
-        workflowDimension,
-    };
-    interruptionRegistry.push({
-        code: common_1.HMSH_CODE_MESHFLOW_SLEEP,
-        ...interruptionMessage,
-    });
-    await (0, common_1.sleepImmediate)();
-    throw new common_1.MeshFlowSleepError(interruptionMessage);
-}
-exports.sleepFor = sleepFor;

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

@@ -1,14 +0,0 @@
-import { StringScalarType } from './common';
-/**
- * Executes a distributed trace, outputting the provided attributes
- * to the telemetry sink (e.g. OpenTelemetry).
- *
- * This trace will only run once per workflow execution by default.
- *
- * @param {StringScalarType} attributes - Key-value attributes to attach to the trace.
- * @param {{ once: boolean }} [config={ once: true }] - If `once` is true, trace only runs once.
- * @returns {Promise<boolean>} True if tracing succeeded, otherwise false.
- */
-export declare function trace(attributes: StringScalarType, config?: {
-    once: boolean;
-}): Promise<boolean>;

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

@@ -1,33 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.trace = void 0;
-const common_1 = require("./common");
-const context_1 = require("./context");
-const isSideEffectAllowed_1 = require("./isSideEffectAllowed");
-/**
- * Executes a distributed trace, outputting the provided attributes
- * to the telemetry sink (e.g. OpenTelemetry).
- *
- * This trace will only run once per workflow execution by default.
- *
- * @param {StringScalarType} attributes - Key-value attributes to attach to the trace.
- * @param {{ once: boolean }} [config={ once: true }] - If `once` is true, trace only runs once.
- * @returns {Promise<boolean>} True if tracing succeeded, otherwise false.
- */
-async function trace(attributes, 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,
-    });
-    const { raw, COUNTER } = (0, context_1.getContext)();
-    const { trc: traceId, spn: spanId, aid: activityId } = raw.metadata;
-    if (!config.once || await (0, isSideEffectAllowed_1.isSideEffectAllowed)(hotMeshClient, 'trace')) {
-        return await common_1.TelemetryService.traceActivity(namespace, attributes, activityId, traceId, spanId, COUNTER.counter);
-    }
-    return true;
-}
-exports.trace = trace;

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

@@ -1,8 +0,0 @@
-/**
- * Pauses the workflow until a signal with the given `signalId` is received.
- *
- * @template T
- * @param {string} signalId - A unique signal identifier shared by the sender and receiver.
- * @returns {Promise<T>} The data payload associated with the received signal.
- */
-export declare function waitFor<T>(signalId: string): Promise<T>;

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

@@ -1,35 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.waitFor = void 0;
-const common_1 = require("./common");
-const didRun_1 = require("./didRun");
-/**
- * Pauses the workflow until a signal with the given `signalId` is received.
- *
- * @template T
- * @param {string} signalId - A unique signal identifier shared by the sender and receiver.
- * @returns {Promise<T>} The data payload associated with the received signal.
- */
-async function waitFor(signalId) {
-    const [didRunAlready, execIndex, result] = await (0, didRun_1.didRun)('wait');
-    if (didRunAlready) {
-        return result.data.data;
-    }
-    const store = common_1.asyncLocalStorage.getStore();
-    const interruptionRegistry = store.get('interruptionRegistry');
-    const workflowId = store.get('workflowId');
-    const workflowDimension = store.get('workflowDimension') ?? '';
-    const interruptionMessage = {
-        workflowId,
-        signalId,
-        index: execIndex,
-        workflowDimension,
-    };
-    interruptionRegistry.push({
-        code: common_1.HMSH_CODE_MESHFLOW_WAIT,
-        ...interruptionMessage,
-    });
-    await (0, common_1.sleepImmediate)();
-    throw new common_1.MeshFlowWaitForError(interruptionMessage);
-}
-exports.waitFor = waitFor;

package/build/services/meshos/index.d.ts

@@ -1,293 +0,0 @@
-import { MeshData } from '../meshdata/index';
-import * as Types from '../../types';
-import { ProviderConfig, ProvidersConfig } from '../../types/provider';
-/**
- * MeshOS is an abstract base class for schema-driven entity management within the Mesh network.
- * It provides a foundation for defining custom entities.
- * By subclassing MeshOS, you can create entities with specific schemas and behaviors, enabling
- * structured data storage, retrieval, and transactional workflows.
- *
- * ### Subclassing MeshOS
- *
- * Standard CRUD methods are included and use your provided schema to
- * fields to return in the response: create, retrieve, update, delete.
- *
- * Search methods are included and use your provided schema to
- * fields to return in the response: count, find, aggregate.
- *
- * Implement other methods as needed for the entity's
- * functionality; For example, subclass/override methods like `create`
- * to also spawn a transactional workflow
- *
- * @example
- * ```typescript
- * import { MeshOS } from '@hotmeshio/hotmesh';
- * import { Types } from '@hotmeshio/hotmesh';
- * import { schema } from './schema'; // Import your schema
- * import * as workflows from './workflows';
- *
- * class Widget extends MeshOS {
- *
- *   //Subclass the `connect` method to connect workers and
- *   // hooks (optional) when the container starts
- *   async connect() {
- *     await this.meshData.connect({
- *       entity: this.getEntity(),
- *       //the `target widget workflow` runs as a transaction
- *       target: function() {
- *         return { hello: 'world' };
- *       },
- *       options: {
- *         namespace: this.getNamespace(),
- *         taskQueue: this.getTaskQueue(),
- *       },
- *     });
- *   }
- *
- *   // subclass the `create` method to start a transactional
- *   // workflow; use the options/search field to set default
- *   // record data `{ ...input}` and invoke the `target widget workflow`
- *   async create(input: Types.StringAnyType): Promise<Types.StringStringType> {
- *     return await this.meshData.exec<Types.StringStringType>({
- *       entity: this.getEntity(),
- *       args: [{ ...input }],
- *       options: {
- *         id: input.id,
- *         ttl: '6 months',
- *         taskQueue: this.getTaskQueue(),
- *         namespace: this.getNamespace(),
- *         search: { data: { ...input }},
- *        },
- *     });
- *   }
- * }
- * ```
- *
- * ### Defining the Schema
- *
- * The schema defines the data model for your entity and is used for indexing and searching within the mesh network.
- * Each field in the schema specifies the data type, whether it's required, and other indexing options.
- *
- * Here's an example of a schema (`schema.ts`):
- *
- * ```typescript
- * import { Types } from '@hotmeshio/hotmesh';
- *
- * export const schema: Types.WorkflowSearchSchema = {
- *   /**
- *    * Unique identifier for the widget, including the entity prefix.
- *    *\/
- *   id: {
- *     type: 'TAG',
- *     primitive: 'string',
- *     required: true,
- *     examples: ['H56789'],
- *   },
- *   /**
- *    * entity type
- *    *\/
- *   $entity: {
- *     type: 'TAG',
- *     primitive: 'string',
- *     required: true,
- *     examples: ['widget'],
- *   },
- *   /**
- *    * Field indicating whether the widget is active ('y') or pruned ('n').
- *    *\/
- *   active: {
- *     type: 'TAG',
- *     primitive: 'string',
- *     required: true,
- *     examples: ['y', 'n'],
- *   },
- *   // ... other fields as needed
- * };
- * ```
- *
- * In your entity class (`Widget`), you use this schema in the
- * `getSearchOptions` method to define how your entity's data
- * is indexed and searched.
- */
-declare abstract class MeshOS {
-    meshData: MeshData;
-    connected: boolean;
-    entity: string;
-    namespace: string;
-    schema: Types.WorkflowSearchSchema;
-    taskQueue: string;
-    static databases: Record<string, Types.DB>;
-    static namespaces: Types.Namespaces;
-    static entities: Record<string, Types.Entity>;
-    static schemas: Record<string, Types.WorkflowSearchSchema>;
-    static profiles: Types.Profiles;
-    static classes: Record<string, typeof MeshOS>;
-    static logger: Types.ILogger;
-    /**
-     * Instances of MeshOS are typically initialized as a set, using a manifest.json
-     * file that describes statically the fully set names, passwords, entities, etc.
-     * The static init method is invoked to start this process (typically at server
-     * startup).
-     */
-    constructor(providerConfig: ProviderConfig | ProvidersConfig, namespace: string, entity: string, taskQueue: string, schema: Types.WorkflowSearchSchema);
-    /**
-     * Return entity (e.g, book, library, user)
-     */
-    getEntity(): string;
-    /**
-     * Get Search options (initializes the search index, specific to the backend provider)
-     */
-    getSearchOptions(): Types.WorkflowSearchOptions;
-    /**
-     * Speficy a more-specific task queue than the default queue (v1, v1priority, v2, acmecorp, etc)
-     */
-    getTaskQueue(): string;
-    /**
-     * Initialize MeshData instance (this backs/supports the class
-     * --the true provider of functionality)
-     */
-    private initializeMeshData;
-    /**
-     * Default target function
-     */
-    protected defaultTargetFn(): Promise<string>;
-    /**
-     * Get namespace
-     */
-    getNamespace(): string;
-    /**
-     * Get schema
-     */
-    getSchema(): Types.WorkflowSearchSchema;
-    /**
-     * Connect to the database
-     */
-    connect(): Promise<void>;
-    /**
-     * Create the search index
-     */
-    index(): Promise<void>;
-    /**
-     * Shutdown all connections
-     */
-    static shutdown(): Promise<void>;
-    /**
-     * Get index name
-     */
-    getIndexName(): string;
-    /**
-     * Create the data record
-     * NOTE: subclasses should override this method (or create
-     * an alternate method) for invoking a workflow when
-     * creating the record.
-     */
-    create(body: Record<string, any>): Promise<Types.StringStringType>;
-    /**
-     * Retrieve the record data
-     */
-    retrieve(id: string, sparse?: boolean): Promise<Types.StringStringType>;
-    /**
-     * Update the record data
-     */
-    update(id: string, body: Record<string, any>): Promise<Types.StringStringType>;
-    /**
-     * Delete the record/workflow
-     */
-    delete(id: string): Promise<boolean>;
-    /**
-     * Find matching records
-     */
-    find(query?: {
-        field: string;
-        is: '=' | '[]' | '>=' | '<=';
-        value: string;
-    }[], start?: number, size?: number): Promise<{
-        count: number;
-        query: string;
-        data: Types.StringStringType[];
-    }>;
-    /**
-     * Count matching entities
-     */
-    count(query: {
-        field: string;
-        is: '=' | '[]' | '>=' | '<=';
-        value: string;
-    }[]): Promise<number>;
-    /**
-     * Aggregate matching entities
-     */
-    aggregate(filter?: {
-        field: string;
-        is: '=' | '[]' | '>=' | '<=';
-        value: string;
-    }[], apply?: {
-        expression: string;
-        as: string;
-    }[], rows?: string[], columns?: string[], reduce?: {
-        operation: string;
-        as: string;
-        property?: string;
-    }[], sort?: {
-        field: string;
-        order: 'ASC' | 'DESC';
-    }[], start?: number, size?: number): Promise<{
-        count: number;
-        query: string;
-        data: Types.StringStringType[];
-    }>;
-    /**
-     * Build aggregate command
-     */
-    private buildAggregateCommand;
-    /**
-     * Build filter command
-     */
-    private buildFilterCommand;
-    /**
-     * Instance initializer
-     */
-    init(search?: boolean): Promise<void>;
-    /**
-     * Register a database
-     */
-    static registerDatabase(id: string, config: Types.DB): void;
-    /**
-     * Register a namespace
-     */
-    static registerNamespace(id: string, config: Types.Namespace): void;
-    /**
-     * Register an entity
-     */
-    static registerEntity(id: string, config: Types.Entity): void;
-    /**
-     * Register a schema
-     */
-    static registerSchema(id: string, schema: Types.WorkflowSearchSchema): void;
-    /**
-     * Register a profile
-     */
-    static registerProfile(id: string, config: Types.Profile): void;
-    /**
-     * Register a class
-     */
-    static registerClass(id: string, entityClass: typeof MeshOS): void;
-    /**
-     * Initialize profiles
-     */
-    static init(p?: Types.Profiles): Promise<void>;
-    /**
-     * Find entity instance
-     */
-    static findEntity(database: string, namespace: string, entity: string): Types.EntityInstanceTypes | undefined;
-    /**
-     * Find schemas
-     */
-    static findSchemas(database: string, ns: string): Record<string, Types.WorkflowSearchSchema>;
-    /**
-     * Serialize profiles to JSON
-     */
-    static toJSON(p?: Types.Profiles): any;
-    workflow: {};
-}
-export { MeshOS };