@ductape/sdk 0.0.4-v50 → 0.0.4-v52

package/dist/workflows/types/workflows.types.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Workflow Service Types
+ *
+ * Type definitions for the Ductape Workflows code-first API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowStatus = exports.WorkflowRollbackStrategy = exports.WorkflowStepType = void 0;
+const types_1 = require("../../types");
+Object.defineProperty(exports, "WorkflowStepType", { enumerable: true, get: function () { return types_1.WorkflowStepType; } });
+Object.defineProperty(exports, "WorkflowRollbackStrategy", { enumerable: true, get: function () { return types_1.WorkflowRollbackStrategy; } });
+Object.defineProperty(exports, "WorkflowStatus", { enumerable: true, get: function () { return types_1.WorkflowStatus; } });
+//# sourceMappingURL=workflows.types.js.map

package/dist/workflows/types/workflows.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.types.js","sourceRoot":"","sources":["../../../src/workflows/types/workflows.types.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,uCAiBqB;AAypCnB,iGAjqCA,wBAAgB,OAiqCA;AAChB,yGAjqCA,gCAAwB,OAiqCA;AACxB,+FAjqCA,sBAAc,OAiqCA"}

package/dist/workflows/workflow-builder.d.ts

@@ -0,0 +1,70 @@
+/**
+ * WorkflowBuilder - Fluent API for building workflow schemas
+ *
+ * Provides a chainable interface for constructing workflow definitions
+ * that compile to IProductWorkflow JSON schema.
+ *
+ * @example
+ * ```ts
+ * import { WorkflowBuilder } from '@ductape/sdk';
+ *
+ * const workflow = new WorkflowBuilder('order-fulfillment')
+ *   .name('Order Fulfillment')
+ *   .description('Process orders end-to-end')
+ *   .input({ order_id: { type: 'string', required: true } })
+ *   .options({ timeout: 86400000, rollback_strategy: 'reverse_all' })
+ *   .step('validate-order')
+ *     .action('inventory-service', 'validate-order')
+ *     .input({ body: { order_id: '$Input{order_id}' } })
+ *     .done()
+ *   .step('reserve-inventory')
+ *     .database('inventory-db', 'reserve-items')
+ *     .dependsOn(['validate-order'])
+ *     .critical()
+ *     .rollback()
+ *       .database('inventory-db', 'release-items')
+ *       .input({ data: { id: '$Step{reserve-inventory}{id}' } })
+ *       .done()
+ *     .done()
+ *   .build();
+ * ```
+ */
+import { IProductWorkflow, IProductWorkflowStep, IWorkflowOptions } from '../types';
+import { IWorkflowBuilder, IStepBuilder } from './types';
+/**
+ * Main workflow builder class
+ */
+export declare class WorkflowBuilder implements IWorkflowBuilder {
+    private workflowConfig;
+    private stepsArray;
+    private signalsMap;
+    private queriesMap;
+    private envsArray;
+    /**
+     * Create a new WorkflowBuilder
+     * @param tag - Unique workflow tag
+     */
+    constructor(tag: string);
+    name(name: string): IWorkflowBuilder;
+    description(description: string): IWorkflowBuilder;
+    input(input: Record<string, unknown>): IWorkflowBuilder;
+    output(output: Record<string, unknown>): IWorkflowBuilder;
+    options(options: IWorkflowOptions): IWorkflowBuilder;
+    env(slug: string, active?: boolean): IWorkflowBuilder;
+    signal(name: string, input?: Record<string, string>): IWorkflowBuilder;
+    query(name: string, handler?: string): IWorkflowBuilder;
+    step(tag: string): IStepBuilder;
+    /**
+     * Add a step to the workflow (called by StepBuilder.done())
+     * @internal
+     */
+    addStep(step: IProductWorkflowStep): void;
+    build(): IProductWorkflow;
+    toSchema(): IProductWorkflow;
+}
+/**
+ * Factory function to create a new WorkflowBuilder
+ * @param tag - Unique workflow tag
+ */
+export declare function createWorkflow(tag: string): WorkflowBuilder;
+export default WorkflowBuilder;

package/dist/workflows/workflow-builder.js

@@ -0,0 +1,338 @@
+"use strict";
+/**
+ * WorkflowBuilder - Fluent API for building workflow schemas
+ *
+ * Provides a chainable interface for constructing workflow definitions
+ * that compile to IProductWorkflow JSON schema.
+ *
+ * @example
+ * ```ts
+ * import { WorkflowBuilder } from '@ductape/sdk';
+ *
+ * const workflow = new WorkflowBuilder('order-fulfillment')
+ *   .name('Order Fulfillment')
+ *   .description('Process orders end-to-end')
+ *   .input({ order_id: { type: 'string', required: true } })
+ *   .options({ timeout: 86400000, rollback_strategy: 'reverse_all' })
+ *   .step('validate-order')
+ *     .action('inventory-service', 'validate-order')
+ *     .input({ body: { order_id: '$Input{order_id}' } })
+ *     .done()
+ *   .step('reserve-inventory')
+ *     .database('inventory-db', 'reserve-items')
+ *     .dependsOn(['validate-order'])
+ *     .critical()
+ *     .rollback()
+ *       .database('inventory-db', 'release-items')
+ *       .input({ data: { id: '$Step{reserve-inventory}{id}' } })
+ *       .done()
+ *     .done()
+ *   .build();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowBuilder = void 0;
+exports.createWorkflow = createWorkflow;
+const types_1 = require("../types");
+/**
+ * Rollback builder implementation
+ */
+class RollbackBuilder {
+    constructor(stepBuilder) {
+        this.rollbackConfig = {};
+        this.stepBuilder = stepBuilder;
+    }
+    action(app, event) {
+        this.rollbackConfig.type = types_1.WorkflowStepType.ACTION;
+        this.rollbackConfig.app = app;
+        this.rollbackConfig.event = event;
+        return this;
+    }
+    database(database, event) {
+        this.rollbackConfig.type = types_1.WorkflowStepType.DATABASE_ACTION;
+        this.rollbackConfig.database = database;
+        this.rollbackConfig.event = event;
+        return this;
+    }
+    graph(graph, action) {
+        this.rollbackConfig.type = types_1.WorkflowStepType.GRAPH;
+        this.rollbackConfig.graph = graph;
+        this.rollbackConfig.event = action;
+        return this;
+    }
+    notification(notification, event) {
+        this.rollbackConfig.type = types_1.WorkflowStepType.NOTIFICATION;
+        this.rollbackConfig.notification = notification;
+        this.rollbackConfig.event = event;
+        return this;
+    }
+    storage(storage, event) {
+        this.rollbackConfig.type = types_1.WorkflowStepType.STORAGE;
+        this.rollbackConfig.storage = storage;
+        this.rollbackConfig.event = event;
+        return this;
+    }
+    publish(broker, event) {
+        this.rollbackConfig.type = types_1.WorkflowStepType.PUBLISH;
+        this.rollbackConfig.broker = broker;
+        this.rollbackConfig.event = event;
+        return this;
+    }
+    input(input) {
+        this.rollbackConfig.input = input;
+        return this;
+    }
+    done() {
+        this.stepBuilder.setRollback(this.rollbackConfig);
+        return this.stepBuilder;
+    }
+}
+/**
+ * Step builder implementation
+ */
+class StepBuilder {
+    constructor(workflowBuilder, tag) {
+        this.workflowBuilder = workflowBuilder;
+        this.stepConfig = {
+            tag,
+            type: types_1.WorkflowStepType.ACTION,
+            event: '',
+            input: {},
+        };
+    }
+    action(app, event) {
+        this.stepConfig.type = types_1.WorkflowStepType.ACTION;
+        this.stepConfig.app = app;
+        this.stepConfig.event = event;
+        return this;
+    }
+    database(database, event) {
+        this.stepConfig.type = types_1.WorkflowStepType.DATABASE_ACTION;
+        this.stepConfig.database = database;
+        this.stepConfig.event = event;
+        return this;
+    }
+    graph(graph, action) {
+        this.stepConfig.type = types_1.WorkflowStepType.GRAPH;
+        this.stepConfig.graph = graph;
+        this.stepConfig.event = action;
+        return this;
+    }
+    notification(notification, event) {
+        this.stepConfig.type = types_1.WorkflowStepType.NOTIFICATION;
+        this.stepConfig.notification = notification;
+        this.stepConfig.event = event;
+        return this;
+    }
+    storage(storage, event) {
+        this.stepConfig.type = types_1.WorkflowStepType.STORAGE;
+        this.stepConfig.storage = storage;
+        this.stepConfig.event = event;
+        return this;
+    }
+    publish(broker, event) {
+        this.stepConfig.type = types_1.WorkflowStepType.PUBLISH;
+        this.stepConfig.broker = broker;
+        this.stepConfig.event = event;
+        return this;
+    }
+    feature(feature) {
+        this.stepConfig.type = types_1.WorkflowStepType.FEATURE;
+        this.stepConfig.event = feature;
+        return this;
+    }
+    quota(quota) {
+        this.stepConfig.type = types_1.WorkflowStepType.QUOTA;
+        this.stepConfig.quota = quota;
+        this.stepConfig.event = 'execute';
+        return this;
+    }
+    fallback(fallback) {
+        this.stepConfig.type = types_1.WorkflowStepType.FALLBACK;
+        this.stepConfig.fallback = fallback;
+        this.stepConfig.event = 'execute';
+        return this;
+    }
+    workflow(workflow) {
+        this.stepConfig.type = types_1.WorkflowStepType.CHILD_WORKFLOW;
+        this.stepConfig.workflow = workflow;
+        this.stepConfig.event = 'execute';
+        return this;
+    }
+    sleep(duration) {
+        this.stepConfig.type = types_1.WorkflowStepType.SLEEP;
+        this.stepConfig.event = 'sleep';
+        this.stepConfig.input = {
+            duration: typeof duration === 'string' ? this.parseDuration(duration) : duration,
+        };
+        return this;
+    }
+    waitForSignal(signal, timeout) {
+        this.stepConfig.type = types_1.WorkflowStepType.WAIT_FOR_SIGNAL;
+        this.stepConfig.event = signal;
+        if (timeout) {
+            this.stepConfig.options = Object.assign(Object.assign({}, this.stepConfig.options), { timeout: typeof timeout === 'string' ? this.parseDuration(timeout) : timeout });
+        }
+        return this;
+    }
+    checkpoint() {
+        this.stepConfig.type = types_1.WorkflowStepType.CHECKPOINT;
+        this.stepConfig.event = 'checkpoint';
+        return this;
+    }
+    input(input) {
+        this.stepConfig.input = input;
+        return this;
+    }
+    dependsOn(steps) {
+        this.stepConfig.depends_on = steps;
+        return this;
+    }
+    condition(condition) {
+        this.stepConfig.condition = condition;
+        return this;
+    }
+    options(options) {
+        this.stepConfig.options = Object.assign(Object.assign({}, this.stepConfig.options), options);
+        return this;
+    }
+    optional() {
+        this.stepConfig.options = Object.assign(Object.assign({}, this.stepConfig.options), { optional: true });
+        return this;
+    }
+    critical() {
+        this.stepConfig.options = Object.assign(Object.assign({}, this.stepConfig.options), { critical: true });
+        return this;
+    }
+    allowFail() {
+        this.stepConfig.options = Object.assign(Object.assign({}, this.stepConfig.options), { allow_fail: true });
+        return this;
+    }
+    name(name) {
+        this.stepConfig.name = name;
+        return this;
+    }
+    rollback() {
+        return new RollbackBuilder(this);
+    }
+    setRollback(rollback) {
+        this.stepConfig.rollback = rollback;
+    }
+    done() {
+        this.workflowBuilder.addStep(this.stepConfig);
+        return this.workflowBuilder;
+    }
+    /**
+     * Parse duration string to milliseconds
+     */
+    parseDuration(duration) {
+        const match = duration.match(/^(\d+)(ms|s|m|h|d)$/);
+        if (!match) {
+            throw new Error(`Invalid duration format: ${duration}`);
+        }
+        const value = parseInt(match[1], 10);
+        const unit = match[2];
+        switch (unit) {
+            case 'ms':
+                return value;
+            case 's':
+                return value * 1000;
+            case 'm':
+                return value * 60 * 1000;
+            case 'h':
+                return value * 60 * 60 * 1000;
+            case 'd':
+                return value * 24 * 60 * 60 * 1000;
+            default:
+                return value;
+        }
+    }
+}
+/**
+ * Main workflow builder class
+ */
+class WorkflowBuilder {
+    /**
+     * Create a new WorkflowBuilder
+     * @param tag - Unique workflow tag
+     */
+    constructor(tag) {
+        this.stepsArray = [];
+        this.signalsMap = {};
+        this.queriesMap = {};
+        this.envsArray = [];
+        this.workflowConfig = {
+            tag,
+            name: tag,
+        };
+    }
+    name(name) {
+        this.workflowConfig.name = name;
+        return this;
+    }
+    description(description) {
+        this.workflowConfig.description = description;
+        return this;
+    }
+    input(input) {
+        this.workflowConfig.input = input;
+        return this;
+    }
+    output(output) {
+        this.workflowConfig.output = output;
+        return this;
+    }
+    options(options) {
+        this.workflowConfig.options = Object.assign(Object.assign({}, this.workflowConfig.options), options);
+        return this;
+    }
+    env(slug, active = true) {
+        this.envsArray.push({ slug, active });
+        return this;
+    }
+    signal(name, input) {
+        this.signalsMap[name] = { name, input };
+        return this;
+    }
+    query(name, handler) {
+        this.queriesMap[name] = { name, handler };
+        return this;
+    }
+    step(tag) {
+        return new StepBuilder(this, tag);
+    }
+    /**
+     * Add a step to the workflow (called by StepBuilder.done())
+     * @internal
+     */
+    addStep(step) {
+        this.stepsArray.push(step);
+    }
+    build() {
+        return this.toSchema();
+    }
+    toSchema() {
+        return {
+            name: this.workflowConfig.name,
+            tag: this.workflowConfig.tag,
+            description: this.workflowConfig.description,
+            input: this.workflowConfig.input,
+            output: this.workflowConfig.output,
+            steps: this.stepsArray,
+            signals: Object.keys(this.signalsMap).length > 0 ? this.signalsMap : undefined,
+            queries: Object.keys(this.queriesMap).length > 0 ? this.queriesMap : undefined,
+            options: this.workflowConfig.options,
+            envs: this.envsArray.length > 0 ? this.envsArray : undefined,
+        };
+    }
+}
+exports.WorkflowBuilder = WorkflowBuilder;
+/**
+ * Factory function to create a new WorkflowBuilder
+ * @param tag - Unique workflow tag
+ */
+function createWorkflow(tag) {
+    return new WorkflowBuilder(tag);
+}
+exports.default = WorkflowBuilder;
+//# sourceMappingURL=workflow-builder.js.map

package/dist/workflows/workflow-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-builder.js","sourceRoot":"","sources":["../../src/workflows/workflow-builder.ts"],"names":[],"mappings":"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"}

package/dist/workflows/workflow-executor.d.ts

@@ -0,0 +1,205 @@
+/**
+ * WorkflowExecutor - Executes workflow steps and manages rollbacks
+ *
+ * Handles the actual execution of workflow steps, including:
+ * - Processing each step type (action, database, notification, etc.)
+ * - Managing rollback on failure
+ * - Tracking workflow state and completed steps
+ * - Handling signals and checkpoints
+ */
+import { IProductWorkflow } from '../types';
+import { IWorkflowServiceConfig, IWorkflowExecutionResult, IExecuteWorkflowOptions } from './types';
+/**
+ * WorkflowExecutor handles the execution of workflow steps
+ */
+export declare class WorkflowExecutor {
+    private config;
+    private processorService;
+    private productBuilder;
+    private processorApiService;
+    private workflowApiService;
+    private graphService;
+    private databaseService;
+    private quotaService;
+    private fallbackService;
+    private state;
+    private workflow;
+    private productId;
+    /** Pending signals waiting to be resolved */
+    private pendingSignals;
+    /** Signal polling interval (ms) */
+    private signalPollInterval;
+    /** Signal polling timer */
+    private signalPollTimer;
+    /** Session log fields for logging */
+    private sessionLogFields;
+    /** LogService instance for logging operations */
+    private logService;
+    /** Base log fields inherited by all step logs */
+    private baseLogs;
+    constructor(config: IWorkflowServiceConfig, workflow: IProductWorkflow, options: IExecuteWorkflowOptions, sessionLogFields?: {
+        identifier?: string;
+        session_id?: string;
+        session_tag?: string;
+    });
+    /**
+     * Get auth payload for API calls
+     */
+    private getAuthPayload;
+    /**
+     * Persist workflow execution result to backend
+     */
+    private persistExecutionResult;
+    /**
+     * Persist individual step execution to backend
+     */
+    private persistStepResult;
+    /**
+     * Initialize logging service and base log fields
+     */
+    private initializeLogging;
+    /**
+     * Log a step execution event
+     */
+    private logStepEvent;
+    /**
+     * Execute the workflow
+     */
+    execute<T = unknown>(): Promise<IWorkflowExecutionResult<T>>;
+    /**
+     * Execute a single step
+     */
+    private executeStep;
+    /**
+     * Execute an action step
+     */
+    private executeActionStep;
+    /**
+     * Execute a database action step
+     */
+    private executeDatabaseStep;
+    /**
+     * Execute a notification step
+     */
+    private executeNotificationStep;
+    /**
+     * Execute a storage step
+     */
+    private executeStorageStep;
+    /**
+     * Execute a publish step
+     */
+    private executePublishStep;
+    /**
+     * Execute a graph step
+     * Supports: execute (custom action), createNode, updateNode, deleteNode,
+     * createRelationship, deleteRelationship, query
+     */
+    private executeGraphStep;
+    /**
+     * Execute a quota step
+     */
+    private executeQuotaStep;
+    /**
+     * Execute a fallback step
+     */
+    private executeFallbackStep;
+    /**
+     * Execute a child workflow step
+     */
+    private executeChildWorkflowStep;
+    /**
+     * Execute a sleep step
+     */
+    private executeSleepStep;
+    /**
+     * Execute a wait for signal step
+     * Polls the backend API for signal delivery until received or timeout
+     */
+    private executeWaitForSignalStep;
+    /**
+     * Start polling the backend for signal delivery
+     */
+    private startSignalPolling;
+    /**
+     * Stop the signal polling timer
+     */
+    private stopSignalPolling;
+    /**
+     * Deliver a signal to this workflow (called by external signal handler)
+     */
+    deliverSignal(signalName: string, payload: unknown): boolean;
+    /**
+     * Execute a checkpoint step
+     */
+    private executeCheckpointStep;
+    /**
+     * Execute rollback for completed steps
+     */
+    private executeRollback;
+    /**
+     * Execute a rollback handler
+     */
+    private executeRollbackHandler;
+    /**
+     * Resolve input by replacing data references
+     */
+    private resolveInput;
+    /**
+     * Resolve a single value, handling data references
+     */
+    private resolveValue;
+    /**
+     * Resolve string value with data reference syntax
+     * Supports: $Input{field}, $Step{tag}{field}, $State{key}, $StepOutput{field}
+     */
+    private resolveStringValue;
+    /**
+     * Get nested value from object using dot notation
+     */
+    private getNestedValue;
+    /**
+     * Get ordered steps respecting dependencies
+     */
+    private getOrderedSteps;
+    /**
+     * Find a step by tag
+     */
+    private findStep;
+    /**
+     * Evaluate a condition string
+     */
+    private evaluateCondition;
+    /**
+     * Determine workflow output
+     */
+    private determineWorkflowOutput;
+    /**
+     * Sleep for specified duration
+     */
+    private sleep;
+    /**
+     * Resume a workflow from a previous state
+     *
+     * @param options - Resume options including completed steps, state, and starting point
+     */
+    resume<T = unknown>(options: IResumeOptions): Promise<IWorkflowExecutionResult<T>>;
+}
+/**
+ * Options for resuming a workflow
+ */
+export interface IResumeOptions {
+    /** Previously completed steps */
+    completed_steps?: string[];
+    /** Previous workflow state */
+    state?: Record<string, unknown>;
+    /** Resume from specific checkpoint */
+    from_checkpoint?: string;
+    /** Resume from specific step */
+    from_step?: string;
+    /** Steps to skip */
+    skip_steps?: string[];
+    /** Override step outputs */
+    step_outputs?: Record<string, unknown>;
+}
+export default WorkflowExecutor;