@hotmeshio/hotmesh 0.21.1 → 0.22.0

package/build/services/store/providers/postgres/kvtypes/hash/basic.js

@@ -4,8 +4,8 @@ exports._setStatusAndCollateGuid = exports._collateLeg2Entry = exports._hincrbyf
 const utils_1 = require("./utils");
 function createBasicOperations(context) {
     return {
-        async hsetnx(key, field, value, multi, entity) {
-            const { sql, params } = _hset(context, key, { [field]: value }, { nx: true, entity });
+        async hsetnx(key, field, value, multi, entity, originId, parentId) {
+            const { sql, params } = _hset(context, key, { [field]: value }, { nx: true, entity, originId, parentId });
             if (multi) {
                 multi.addCommand(sql, params, 'number');
                 return Promise.resolve(0);
@@ -281,25 +281,25 @@ function _hset(context, key, fields, options) {
         if (options?.nx) {
             // Use WHERE NOT EXISTS to enforce nx
             sql = `
-        INSERT INTO ${targetTable} (id, key, status, entity)
-        SELECT gen_random_uuid(), $1, $2, $3
+        INSERT INTO ${targetTable} (id, key, status, entity, origin_id, parent_id)
+        SELECT gen_random_uuid(), $1, $2, $3, $4, $5
         WHERE NOT EXISTS (
           SELECT 1 FROM ${targetTable}
           WHERE key = $1 AND is_live
         )
         RETURNING 1 as count
       `;
-            params.push(key, fields[':'], options?.entity ?? null);
+            params.push(key, fields[':'], options?.entity ?? null, options?.originId ?? null, options?.parentId ?? null);
         }
         else {
             // Update existing job or insert new one
             sql = `
-        INSERT INTO ${targetTable} (id, key, status, entity)
-        VALUES (gen_random_uuid(), $1, $2, $3)
+        INSERT INTO ${targetTable} (id, key, status, entity, origin_id, parent_id)
+        VALUES (gen_random_uuid(), $1, $2, $3, $4, $5)
         ON CONFLICT (key) WHERE is_live DO UPDATE SET status = EXCLUDED.status
         RETURNING 1 as count
       `;
-            params.push(key, fields[':'], options?.entity ?? null);
+            params.push(key, fields[':'], options?.entity ?? null, options?.originId ?? null, options?.parentId ?? null);
         }
     }
     else if (isJobsTableResult) {

package/build/services/store/providers/postgres/kvtypes/hash/index.d.ts

@@ -20,7 +20,7 @@ export declare const hashModule: (context: KVSQL) => {
         cursor: number;
         keys: string[];
     }>;
-    hsetnx(key: string, field: string, value: string, multi?: import("./types").ProviderTransaction, entity?: string): Promise<number>;
+    hsetnx(key: string, field: string, value: string, multi?: import("./types").ProviderTransaction, entity?: string, originId?: string, parentId?: string): Promise<number>;
     hget(key: string, field: string, multi?: import("./types").ProviderTransaction): Promise<string>;
     hdel(key: string, fields: string[], multi?: unknown): Promise<number>;
     hmget(key: string, fields: string[], multi?: import("./types").ProviderTransaction): Promise<string[]>;

package/build/services/store/providers/postgres/postgres.d.ts

@@ -11,7 +11,6 @@ import { Transitions } from '../../../../types/transition';
 import { JobInterruptOptions } from '../../../../types/job';
 import { WorkListTaskType } from '../../../../types/task';
 import { ThrottleOptions } from '../../../../types/quorum';
-import { SignalQueueEntry } from '../../../../types/signal';
 import { StoreService } from '../..';
 import { PostgresClientType } from '../../../../types';
 import { KVSQL } from './kvsql';
@@ -105,7 +104,7 @@ declare class PostgresStoreService extends StoreService<ProviderClient, Provider
      * `purposeful re-entry`.
      */
     collateSynthetic(jobId: string, guid: string, amount: number, transaction?: ProviderTransaction): Promise<number>;
-    setStateNX(jobId: string, appId: string, status?: number, entity?: string, transaction?: ProviderTransaction): Promise<boolean>;
+    setStateNX(jobId: string, appId: string, status?: number, entity?: string, transaction?: ProviderTransaction, originId?: string, parentId?: string): Promise<boolean>;
     getSchema(activityId: string, appVersion: AppVID): Promise<ActivityType>;
     getSchemas(appVersion: AppVID): Promise<Record<string, ActivityType>>;
     setSchemas(schemas: Record<string, ActivityType>, appVersion: AppVID): Promise<any>;
@@ -223,198 +222,55 @@ declare class PostgresStoreService extends StoreService<ProviderClient, Provider
         activity?: string;
         types?: string[];
     }): Promise<import('../../../../types/exporter').StreamHistoryEntry[]>;
-    private signalQueueTable;
-    private rowToSignalEntry;
-    enqueueSignal(params: {
-        namespace: string;
-        appId: string;
-        signalKey: string;
-        workflowId: string;
-        jobId?: string;
+    /**
+     * Parse a HotMesh-encoded value string.
+     * Values may be prefixed with `/s` (JSON), `/d` (number), `/t` or `/f` (boolean), `/n` (null).
+     */
+    private parseHmshValue;
+    private _escalationInsertSql;
+    private _escalationInsertParams;
+    createEscalation(params: import('../../../../types/hmsh_escalations').CreateEscalationParams): Promise<import('../../../../types/hmsh_escalations').EscalationEntry>;
+    /**
+     * Enqueues the escalation INSERT into an existing Leg1 transaction so the row
+     * is written atomically with the job state checkpoint. On conflict
+     * (ON CONFLICT DO NOTHING) the command is a no-op, making it safe for
+     * idempotent re-runs after a crash.
+     */
+    addEscalationToTransaction(params: import('../../../../types/hmsh_escalations').CreateEscalationParams, transaction: import('../../../../types/provider').ProviderTransaction): void;
+    getEscalation(id: string, namespace?: string): Promise<import('../../../../types/hmsh_escalations').EscalationEntry | null>;
+    getEscalationBySignalKey(signalKey: string, namespace?: string): Promise<import('../../../../types/hmsh_escalations').EscalationEntry | null>;
+    listEscalations(params?: import('../../../../types/hmsh_escalations').ListEscalationsParams): Promise<import('../../../../types/hmsh_escalations').EscalationEntry[]>;
+    claimEscalation(params: import('../../../../types/hmsh_escalations').ClaimEscalationParams): Promise<import('../../../../types/hmsh_escalations').ClaimEscalationResult>;
+    claimEscalationByMetadata(params: import('../../../../types/hmsh_escalations').ClaimByMetadataParams): Promise<import('../../../../types/hmsh_escalations').ClaimByMetadataResult>;
+    releaseEscalation(params: import('../../../../types/hmsh_escalations').ReleaseEscalationParams): Promise<import('../../../../types/hmsh_escalations').ReleaseEscalationResult>;
+    resolveEscalation(params: import('../../../../types/hmsh_escalations').ResolveEscalationParams): Promise<import('../../../../types/hmsh_escalations').ResolveEscalationResult & {
+        signalKey?: string;
         topic?: string;
-        role?: string;
-        type?: string;
-        subtype?: string;
-        priority?: number;
-        description?: string;
-        taskQueue?: string;
-        workflowType?: string;
-        assignedTo?: string;
-        metadata?: Record<string, unknown>;
-        envelope?: Record<string, unknown>;
-        expiresAt?: Date;
-    }): Promise<{
-        id: string;
-    } | null>;
-    claimSignal(params: {
-        namespace: string;
-        appId: string;
-        id: string;
-        assignee?: string;
-        durationMinutes?: number;
-    }): Promise<{
-        ok: true;
-        entry: SignalQueueEntry;
-    } | {
-        ok: false;
-        reason: 'not-found' | 'conflict';
-    }>;
-    claimSignalByMetadata(params: {
-        namespace: string;
-        appId: string;
-        key: string;
-        value: unknown;
-        assignee?: string;
-        durationMinutes?: number;
-    }): Promise<{
-        ok: true;
-        entry: SignalQueueEntry;
-    } | {
-        ok: false;
-        reason: 'not-found' | 'conflict';
     }>;
-    releaseSignal(params: {
-        namespace: string;
-        appId: string;
-        id: string;
-    }): Promise<{
-        ok: true;
-    } | {
-        ok: false;
-        reason: 'not-found' | 'wrong-status';
+    resolveEscalationByMetadata(params: import('../../../../types/hmsh_escalations').ResolveByMetadataParams): Promise<import('../../../../types/hmsh_escalations').ResolveEscalationResult & {
+        signalKey?: string;
+        topic?: string;
     }>;
-    resolveSignal(params: {
-        namespace: string;
-        appId: string;
+    /**
+     * Queues the escalation UPDATE into an existing transaction without executing it.
+     * Used by client.ts resolve() to commit the status change atomically with signal delivery.
+     */
+    queueResolveEscalation(params: {
         id: string;
+        namespace?: string;
         resolverPayload?: Record<string, unknown>;
-    }): Promise<{
-        ok: true;
-        signalKey: string;
-        topic: string;
-    } | {
-        ok: false;
-        reason: 'not-found' | 'already-resolved';
-    }>;
-    resolveSignalByMetadata(params: {
-        namespace: string;
-        appId: string;
-        key: string;
-        value: unknown;
-        resolverPayload?: Record<string, unknown>;
-    }): Promise<{
-        ok: true;
-        signalKey: string;
-        topic: string;
-    } | {
-        ok: false;
-        reason: 'not-found';
-    }>;
-    releaseExpiredSignals(params: {
-        namespace: string;
-        appId: string;
-    }): Promise<number>;
-    listSignals(params: {
-        namespace: string;
-        appId: string;
-        status?: string;
-        role?: string;
-        taskQueue?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<{
-        id: string;
-        namespace: string;
-        appId: string;
-        signalKey: string;
-        workflowId: string;
-        jobId: string;
-        topic: string;
-        status: "pending" | "claimed" | "resolved" | "expired" | "released";
-        role: string;
-        type: string;
-        subtype: string;
-        priority: number;
-        description: string;
-        taskQueue: string;
-        workflowType: string;
-        assignedTo: string;
-        claimedAt: Date;
-        claimExpiresAt: Date;
-        resolvedAt: Date;
-        resolverPayload: Record<string, unknown>;
-        envelope: Record<string, unknown>;
-        metadata: Record<string, unknown>;
-        expiresAt: Date;
-        createdAt: Date;
-        updatedAt: Date;
-    }[]>;
-    getSignal(params: {
-        namespace: string;
-        appId: string;
-        id: string;
-    }): Promise<{
-        id: string;
-        namespace: string;
-        appId: string;
-        signalKey: string;
-        workflowId: string;
-        jobId: string;
-        topic: string;
-        status: "pending" | "claimed" | "resolved" | "expired" | "released";
-        role: string;
-        type: string;
-        subtype: string;
-        priority: number;
-        description: string;
-        taskQueue: string;
-        workflowType: string;
-        assignedTo: string;
-        claimedAt: Date;
-        claimExpiresAt: Date;
-        resolvedAt: Date;
-        resolverPayload: Record<string, unknown>;
-        envelope: Record<string, unknown>;
-        metadata: Record<string, unknown>;
-        expiresAt: Date;
-        createdAt: Date;
-        updatedAt: Date;
-    }>;
-    getSignalBySignalKey(params: {
-        namespace: string;
-        appId: string;
-        signalKey: string;
-    }): Promise<{
-        id: string;
-        namespace: string;
-        appId: string;
-        signalKey: string;
-        workflowId: string;
-        jobId: string;
-        topic: string;
-        status: "pending" | "claimed" | "resolved" | "expired" | "released";
-        role: string;
-        type: string;
-        subtype: string;
-        priority: number;
-        description: string;
-        taskQueue: string;
-        workflowType: string;
-        assignedTo: string;
-        claimedAt: Date;
-        claimExpiresAt: Date;
-        resolvedAt: Date;
-        resolverPayload: Record<string, unknown>;
-        envelope: Record<string, unknown>;
-        metadata: Record<string, unknown>;
-        expiresAt: Date;
-        createdAt: Date;
-        updatedAt: Date;
-    }>;
+    }, transaction: {
+        addCommand: (sql: string, params: any[], returnType: string) => any;
+    }): void;
     /**
-     * Parse a HotMesh-encoded value string.
-     * Values may be prefixed with `/s` (JSON), `/d` (number), `/t` or `/f` (boolean), `/n` (null).
+     * Finds the highest-priority pending or claimed escalation matching the given metadata filter.
+     * Used by client.ts resolveByMetadata() to get routing info before building the atomic transaction.
      */
-    private parseHmshValue;
+    findEscalationByMetadata(key: string, value: string, roles: string[] | null, namespace?: string): Promise<import('../../../../types/hmsh_escalations').EscalationEntry | null>;
+    cancelEscalation(id: string, namespace?: string): Promise<import('../../../../types/hmsh_escalations').CancelEscalationResult>;
+    escalateEscalationToRole(params: import('../../../../types/hmsh_escalations').EscalateToRoleParams): Promise<import('../../../../types/hmsh_escalations').EscalationEntry | null>;
+    updateEscalation(params: import('../../../../types/hmsh_escalations').UpdateEscalationParams): Promise<import('../../../../types/hmsh_escalations').EscalationEntry | null>;
+    appendEscalationMilestones(params: import('../../../../types/hmsh_escalations').AppendMilestonesParams): Promise<import('../../../../types/hmsh_escalations').EscalationEntry | null>;
+    releaseExpiredEscalations(namespace?: string): Promise<number>;
 }
 export { PostgresStoreService };