@ductape/sdk 0.1.26 → 0.1.27

package/dist/features/feature-builder.js.map

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

package/dist/features/feature-executor.d.ts

@@ -0,0 +1,289 @@
+/**
+ * FeatureExecutor - Executes feature steps and manages rollbacks
+ *
+ * Handles the actual execution of feature steps, including:
+ * - Processing each step type (action, database, notification, etc.)
+ * - Managing rollback on failure
+ * - Tracking feature state and completed steps
+ * - Handling signals and checkpoints
+ */
+import ProductBuilder from '../products/services/products.service';
+import { IProductFeature } from '../types';
+import { IFeatureServiceConfig, IFeatureExecutionResult, IExecuteFeatureOptions } from './types';
+/**
+ * FeatureExecutor handles the execution of feature steps
+ */
+export declare class FeatureExecutor {
+    private config;
+    private _processorService;
+    private productBuilder;
+    private processorApiService;
+    private featureApiService;
+    private _graphService;
+    private _databaseService;
+    private _brokersService;
+    private _storageService;
+    private _vectorService;
+    private _quotaService;
+    private _fallbackService;
+    private state;
+    private feature;
+    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;
+    private _privateKey;
+    /** When true, product was already loaded by caller (e.g. FeatureService); skip duplicate init in execute(). */
+    private readonly preInitializedProduct;
+    /** Set when a graph step runs; we disconnect once at end of execute() instead of per-step. */
+    private graphConnectionUsed;
+    /** Pre-fetched bootstrap data per step tag (feature batch prefetch). */
+    private stepBootstrapCache;
+    constructor(config: IFeatureServiceConfig & {
+        access_key: string;
+    }, feature: IProductFeature, options: IExecuteFeatureOptions, private_key: string, sessionLogFields?: {
+        session_user_id?: string;
+        session_id?: string;
+        session_tag?: string;
+    }, preInitializedBuilder?: ProductBuilder);
+    /**
+     * Get auth payload for API calls
+     */
+    private getAuthPayload;
+    /** Product private key for processor result encryption; must always match backend decryption key. No fallback to workspace key. */
+    private getProcessorResultEncryptionKey;
+    /** Lazy-initialized processor (shares productBuilder to avoid duplicate product init per step). */
+    private getProcessorService;
+    /** Lazy-initialized graph service. */
+    private getGraphService;
+    /** Lazy-initialized database service. */
+    private getDatabaseService;
+    /** Lazy-initialized brokers service. Used for produce steps so ctx.messaging.produce uses the same path as ductape.messaging.produce (pool, tracking, cache). */
+    private getBrokersService;
+    /** Lazy-initialized storage service. Used for storage steps (upload/download/delete) instead of processor. */
+    private getStorageService;
+    /** Lazy-initialized vector service. Used for vector steps (query/upsert/delete/execute action). */
+    private getVectorService;
+    /** Lazy-initialized quota service. */
+    private getQuotaService;
+    /** Lazy-initialized fallback service. */
+    private getFallbackService;
+    /**
+     * Persist feature execution result to backend
+     */
+    private persistExecutionResult;
+    /**
+     * Step processor results must always use component: 'feature_step'.
+     * step_type is the step kind: action, notification, storage, produce, database_action, graph, vector, quota, fallback, child_workflow, sleep, wait_for_signal, checkpoint, feature.
+     */
+    private getStepTypeForResult;
+    /**
+     * Persist individual step execution to backend (input/output per step in processor result).
+     * Processor results for steps always have component: 'feature_step' and step_type set to the step kind.
+     */
+    private persistStepResult;
+    /**
+     * Initialize logging service and base log fields
+     */
+    private initializeLogging;
+    /**
+     * Log a step execution event
+     */
+    private logStepEvent;
+    /**
+     * Execute the feature
+     */
+    execute<T = unknown>(): Promise<IFeatureExecutionResult<T>>;
+    /**
+     * Execute a single step
+     */
+    private executeStep;
+    /**
+     * Execute an action step
+     */
+    private executeActionStep;
+    /**
+     * Execute a database step: use query/insert/update/delete/upsert for DB operations, execute() for named actions.
+     */
+    private executeDatabaseStep;
+    /**
+     * Execute a notification step
+     */
+    private executeNotificationStep;
+    /**
+     * Execute a storage step using StorageService (upload, download, or delete by input shape).
+     */
+    private executeStorageStep;
+    /**
+     * Execute a produce step (message broker produce to topic).
+     * Uses BrokersService so ctx.messaging.produce has the same behavior as ductape.messaging.produce (pool, tracking, cache).
+     */
+    private executeProduceStep;
+    /**
+     * Execute a graph step
+     * Supports: execute (custom action), createNode, updateNode, deleteNode,
+     * createRelationship, deleteRelationship, query
+     */
+    private executeGraphStep;
+    /**
+     * Execute a vector step (query, upsert, deleteVectors, or custom action via execute).
+     */
+    private executeVectorStep;
+    /**
+     * Execute a quota step
+     */
+    private executeQuotaStep;
+    /**
+     * Execute a fallback step
+     */
+    private executeFallbackStep;
+    /**
+     * Execute a child feature 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 feature (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 and all $ operators (per docs/operators).
+     * Top-level keys are resolved in parallel for better performance.
+     */
+    private resolveInput;
+    /**
+     * Resolve a single value: refs ($Input{}, $Step{}, etc.) and operators ($Add, $Concat, etc.)
+     */
+    private resolveValue;
+    /** Strip surrounding quotes from a string literal (e.g. '"foo"' -> 'foo') */
+    private unquote;
+    /**
+     * Resolve string value: data references and all $ operators from docs/operators
+     * Supports: $Input{}, $Step{}, $Sequence{}, $State{}, $StepOutput{}, $Now,
+     * $Add, $Subtract, $Concat, $Substring, $Trim, $Split, $Pick, $Join,
+     * $Uppercase, $Lowercase, $Dateformat, $Replace, $Filter, $Find, $Size, $Length
+     */
+    private resolveStringValue;
+    /**
+     * Get nested value from object using dot notation
+     */
+    private getNestedValue;
+    /**
+     * Get ordered steps respecting dependencies
+     */
+    private getOrderedSteps;
+    /**
+     * Pre-fetch all action/notification/storage bootstrap data for the given steps in one backend call.
+     * Results are cached in stepBootstrapCache by step tag so step executors can skip their own bootstrap calls.
+     */
+    private prefetchStepBootstrap;
+    /**
+     * Find a step by tag
+     */
+    private findStep;
+    /**
+     * Evaluate a condition string.
+     * Supports: (cond1) || (cond2), (cond1) && (cond2), and in each part: ==, ===, !=, !==, >, <, >=, <=.
+     * Left/right can be $Step{}, $Input{}, etc. (resolved before comparison).
+     */
+    private evaluateCondition;
+    /** Comparison operators in parse order (multi-char before single-char). */
+    private static readonly CONDITION_OP_REGEX;
+    /**
+     * Coerce a trimmed condition literal (after resolve) to a comparable value: boolean, number, or string.
+     */
+    private conditionLiteral;
+    private evaluateConditionPart;
+    private compareLooseEqual;
+    /**
+     * Compare for ordering (>, <, >=, <=). Uses numeric comparison when both sides are numeric, else string.
+     */
+    private compareOrdered;
+    /**
+     * Returns true if the value tree contains any $ operator reference ($Input{}, $Step{}, $Sequence{}, etc.).
+     * Used to distinguish output templates (to resolve) from type-only schemas (to ignore for persistence).
+     */
+    private hasOperatorRefsInOutput;
+    /**
+     * Returns true if the object looks like a feature output type schema (e.g. { orderId: { type: 'string' }, ... })
+     * rather than a template with $ operators or literal values.
+     */
+    private isOutputTypeSchema;
+    /**
+     * Determine feature output for persistence and return value.
+     * - If feature.output has $ operator refs: resolve template to actual values (matches definition).
+     * - If feature.output is a type-only schema: use execution result (last step or step_outputs) so stored result matches runtime output, not the schema.
+     * - If no feature.output: use last step result or {}.
+     */
+    private determineWorkflowOutput;
+    /**
+     * Build output with same keys as feature definition, values from step_outputs (last step first, then others).
+     * Ensures persisted result shape matches the feature definition output shape.
+     */
+    private buildOutputFromStepsToMatchDefinition;
+    /**
+     * Sleep for specified duration
+     */
+    private sleep;
+    /**
+     * Resume a feature from a previous state
+     *
+     * @param options - Resume options including completed steps, state, and starting point
+     */
+    resume<T = unknown>(options: IResumeOptions): Promise<IFeatureExecutionResult<T>>;
+}
+/**
+ * Options for resuming a feature
+ */
+export interface IResumeOptions {
+    /** Previously completed steps */
+    completed_steps?: string[];
+    /** Previous feature 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 FeatureExecutor;