@hotmeshio/hotmesh 0.10.1 → 0.11.0

package/build/services/durable/exporter.d.ts

@@ -1,8 +1,46 @@
 import { ILogger } from '../logger';
 import { StoreService } from '../store';
-import { ExportOptions, DurableJobExport, TimelineType, TransitionType, ExportFields } from '../../types/exporter';
+import { ExportOptions, DurableJobExport, TimelineType, TransitionType, ExportFields, ExecutionExportOptions, WorkflowExecution, WorkflowExecutionStatus } from '../../types/exporter';
 import { ProviderClient, ProviderTransaction } from '../../types/provider';
 import { StringStringType, Symbols } from '../../types/serializer';
+/**
+ * Parse a HotMesh compact timestamp (YYYYMMDDHHmmss.mmm) into ISO 8601.
+ * Also accepts ISO 8601 strings directly.
+ */
+declare function parseTimestamp(raw: string | undefined | null): string | null;
+/**
+ * Compute duration in milliseconds between two HotMesh timestamps.
+ */
+declare function computeDuration(ac: string | undefined, au: string | undefined): number | null;
+/**
+ * Extract the operation type (proxy, child, start, wait, sleep, hook)
+ * from a timeline key like `-proxy,0,0-1-`.
+ */
+declare function extractOperation(key: string): string;
+/**
+ * Extract the activity name from a timeline entry value's job_id.
+ *
+ * Job ID format: `-{workflowId}-$${activityName}{dimension}-{execIndex}`
+ * Examples:
+ *   `-wfId-$analyzeContent-5`  → `'analyzeContent'`
+ *   `-wfId-$processOrder,0,0-3` → `'processOrder'`
+ */
+declare function extractActivityName(value: Record<string, any> | null): string;
+/**
+ * Check if an activity name is a system (interceptor) operation.
+ */
+declare function isSystemActivity(name: string): boolean;
+/**
+ * Map HotMesh job state to a human-readable execution status.
+ *
+ * HotMesh semaphore: `0` = idle, `> 0` = pending activities,
+ * `< 0` = failed / interrupted.
+ *
+ * A workflow can be "done" (`state.data.done === true`) while the
+ * semaphore is still > 0 (cleanup activities pending). We check
+ * both the `done` flag and the semaphore to determine status.
+ */
+declare function mapStatus(rawStatus: number | undefined, isDone?: boolean, hasError?: boolean): WorkflowExecutionStatus;
 declare class ExporterService {
     appId: string;
     logger: ILogger;
@@ -11,10 +49,44 @@ declare class ExporterService {
     private static symbols;
     constructor(appId: string, store: StoreService<ProviderClient, ProviderTransaction>, logger: ILogger);
     /**
-     * Convert the job hash from its compiles format into a DurableJobExport object with
+     * Convert the job hash from its compiled format into a DurableJobExport object with
      * facets that describe the workflow in terms relevant to narrative storytelling.
      */
     export(jobId: string, options?: ExportOptions): Promise<DurableJobExport>;
+    /**
+     * Export a workflow execution as a Temporal-compatible event history.
+     *
+     * **Sparse mode** (default): transforms the main workflow's timeline
+     * into a flat event list. No additional I/O beyond the initial export.
+     *
+     * **Verbose mode**: recursively fetches child workflow jobs and attaches
+     * their executions as nested `children`.
+     */
+    exportExecution(jobId: string, workflowTopic: string, options?: ExecutionExportOptions): Promise<WorkflowExecution>;
+    /**
+     * Reconstruct a WorkflowExecution from raw database rows when the job
+     * handle has expired or been pruned. Only available if the store provider
+     * implements getJobByKeyDirect.
+     */
+    private exportExecutionDirect;
+    /**
+     * Enrich execution events with activity and child workflow inputs.
+     * Queries the store for activity arguments and child workflow arguments.
+     */
+    private enrichExecutionInputs;
+    /**
+     * Resolve a symbol field from stable JSON path using the symbol registry.
+     */
+    private resolveSymbolField;
+    /**
+     * Pure transformation: convert a raw DurableJobExport into a
+     * Temporal-compatible WorkflowExecution event history.
+     */
+    transformToExecution(raw: DurableJobExport, workflowId: string, workflowTopic: string, options: ExecutionExportOptions): WorkflowExecution;
+    /**
+     * Recursively fetch child workflow executions for verbose mode.
+     */
+    private fetchChildren;
     /**
      * Inflates the job data into a DurableJobExport object
      * @param jobHash - the job data
@@ -48,4 +120,4 @@ declare class ExporterService {
      */
     sortParts(parts: TimelineType[]): TimelineType[];
 }
-export { ExporterService };
+export { ExporterService, parseTimestamp, computeDuration, extractOperation, extractActivityName, isSystemActivity, mapStatus, };