@aws/durable-execution-sdk-js 1.0.0 → 1.0.2

package/dist-types/types/step.d.ts

@@ -34,10 +34,55 @@ export interface RetryDecision {
     delay?: Duration;
 }
 /**
+ * Execution semantics for step operations.
+ *
+ * @remarks
+ * These semantics control how step execution is checkpointed and replayed. **Important**: The guarantees apply *per
+ * retry attempt*, not per overall workflow execution.
+ *
+ * With retries enabled (the default), a step could execute multiple times across different retry attempts even when
+ * using `AtMostOncePerRetry`. To achieve step-level at-most-once execution, combine `AtMostOncePerRetry` with a retry
+ * strategy that disables retries (`shouldRetry: false`).
+ *
+ * @example
+ * ```typescript
+ * // At-least-once per retry (default) - safe for idempotent operations
+ * await context.step("send-notification", async () => sendEmail(), {
+ *   semantics: StepSemantics.AtLeastOncePerRetry,
+ * });
+ *
+ * // At-most-once per retry - for non-idempotent operations
+ * await context.step("charge-payment", async () => processPayment(), {
+ *   semantics: StepSemantics.AtMostOncePerRetry,
+ *   retryStrategy: () => ({ shouldRetry: false }),
+ * });
+ * ```
+ *
  * @public
  */
 export declare enum StepSemantics {
+    /**
+     * At-most-once execution per retry attempt.
+     *
+     * @remarks
+     * A checkpoint is created before step execution. If a failure occurs after the checkpoint
+     * but before step completion, the previous step retry attempt is skipped on replay.
+     *
+     * **Note**: This is "at-most-once *per retry*". With multiple retry attempts, the step
+     * could still execute multiple times across different retries. To guarantee the step
+     * executes at most once, disable retries by returning
+     * `{ shouldRetry: false }` from your retry strategy.
+     */
     AtMostOncePerRetry = "AT_MOST_ONCE_PER_RETRY",
+    /**
+     * At-least-once execution per retry attempt (default).
+     *
+     * @remarks
+     * The step will execute at least once on each retry attempt. If the step succeeds
+     * but the checkpoint fails (e.g., due to a sandbox crash), the step will re-execute
+     * on replay. This is the safer default for operations that are idempotent or can
+     * tolerate duplicate execution.
+     */
     AtLeastOncePerRetry = "AT_LEAST_ONCE_PER_RETRY"
 }
 /**

package/dist-types/types/step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../src/types/step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,kBAAkB,2BAA2B;IAC7C,mBAAmB,4BAA4B;CAChD;AAED;;;;;GAKG;AACH,oBAAY,cAAc;IACxB,6CAA6C;IAC7C,IAAI,SAAS;IACb,gEAAgE;IAChE,IAAI,SAAS;IACb,0EAA0E;IAC1E,IAAI,SAAS;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,mDAAmD;IACnD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,KAAK,aAAa,CAAC;IACtE,iFAAiF;IACjF,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,MAAM,SAAS,aAAa,GAAG,aAAa,IAAI,CACtE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,KACzB,OAAO,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../src/types/step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,oBAAY,aAAa;IACvB;;;;;;;;;;;OAWG;IACH,kBAAkB,2BAA2B;IAE7C;;;;;;;;OAQG;IACH,mBAAmB,4BAA4B;CAChD;AAED;;;;;GAKG;AACH,oBAAY,cAAc;IACxB,6CAA6C;IAC7C,IAAI,SAAS;IACb,gEAAgE;IAChE,IAAI,SAAS;IACb,0EAA0E;IAC1E,IAAI,SAAS;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,mDAAmD;IACnD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,KAAK,aAAa,CAAC;IACtE,iFAAiF;IACjF,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,MAAM,SAAS,aAAa,GAAG,aAAa,IAAI,CACtE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,KACzB,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/dist-types/utils/checkpoint/checkpoint-ancestor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=checkpoint-ancestor.test.d.ts.map

package/dist-types/utils/checkpoint/checkpoint-ancestor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-ancestor.test.d.ts","sourceRoot":"","sources":["../../../src/utils/checkpoint/checkpoint-ancestor.test.ts"],"names":[],"mappings":""}

package/dist-types/utils/checkpoint/checkpoint-central-termination.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=checkpoint-central-termination.test.d.ts.map

package/dist-types/utils/checkpoint/checkpoint-central-termination.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-central-termination.test.d.ts","sourceRoot":"","sources":["../../../src/utils/checkpoint/checkpoint-central-termination.test.ts"],"names":[],"mappings":""}

package/dist-types/utils/checkpoint/checkpoint-helper.d.ts

@@ -1,4 +1,6 @@
 import { OperationUpdate } from "@aws-sdk/client-lambda";
+import { OperationLifecycleState } from "../../types/operation-lifecycle-state";
+import { OperationMetadata, OperationInfo } from "../../types/operation-lifecycle";
 export interface Checkpoint {
     checkpoint(stepId: string, data: Partial<OperationUpdate>): Promise<void>;
     forceCheckpoint?(): Promise<void>;
@@ -6,5 +8,40 @@ export interface Checkpoint {
     setTerminating?(): void;
     hasPendingAncestorCompletion?(stepId: string): boolean;
     waitForQueueCompletion(): Promise<void>;
+    markAncestorFinished(stepId: string): void;
+    /**
+     * Update operation lifecycle state
+     * @param stepId - The operation ID
+     * @param state - The new lifecycle state
+     * @param options - Optional metadata (required on first call) and endTimestamp
+     */
+    markOperationState(stepId: string, state: OperationLifecycleState, options?: {
+        metadata?: OperationMetadata;
+        endTimestamp?: Date;
+    }): void;
+    /**
+     * Wait for retry timer to expire, then poll for status change
+     * @param stepId - The operation ID
+     */
+    waitForRetryTimer(stepId: string): Promise<void>;
+    /**
+     * Wait for status change (external event like callback, invoke, wait)
+     * @param stepId - The operation ID
+     */
+    waitForStatusChange(stepId: string): Promise<void>;
+    /**
+     * Mark operation as awaited (IDLE_NOT_AWAITED → IDLE_AWAITED transition)
+     * @param stepId - The operation ID
+     */
+    markOperationAwaited(stepId: string): void;
+    /**
+     * Get current lifecycle state of an operation
+     * @param stepId - The operation ID
+     */
+    getOperationState(stepId: string): OperationLifecycleState | undefined;
+    /**
+     * Get all operations (for debugging/testing)
+     */
+    getAllOperations(): Map<string, OperationInfo>;
 }
 //# sourceMappingURL=checkpoint-helper.d.ts.map

package/dist-types/utils/checkpoint/checkpoint-helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkpoint-helper.d.ts","sourceRoot":"","sources":["../../../src/utils/checkpoint/checkpoint-helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,eAAe,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,cAAc,CAAC,IAAI,IAAI,CAAC;IACxB,4BAA4B,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACvD,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}
+{"version":3,"file":"checkpoint-helper.d.ts","sourceRoot":"","sources":["../../../src/utils/checkpoint/checkpoint-helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EACL,iBAAiB,EACjB,aAAa,EACd,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,UAAU;IAEzB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,eAAe,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,cAAc,CAAC,IAAI,IAAI,CAAC;IACxB,4BAA4B,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACvD,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAI3C;;;;;OAKG;IACH,kBAAkB,CAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,uBAAuB,EAC9B,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,iBAAiB,CAAC;QAC7B,YAAY,CAAC,EAAE,IAAI,CAAC;KACrB,GACA,IAAI,CAAC;IAER;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD;;;OAGG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;OAGG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3C;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAAC;IAEvE;;OAEG;IACH,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAChD"}

package/dist-types/utils/checkpoint/checkpoint-manager.d.ts

@@ -4,50 +4,81 @@ import { TerminationManager } from "../../termination-manager/termination-manage
 import { EventEmitter } from "events";
 import { DurableLogger } from "../../types/durable-logger";
 import { Checkpoint } from "./checkpoint-helper";
+import { OperationLifecycleState, OperationInfo, OperationMetadata } from "../../types";
 export declare const STEP_DATA_UPDATED_EVENT = "stepDataUpdated";
-interface ActiveOperationsTracker {
-    increment(): void;
-    decrement(): void;
-}
 export declare class CheckpointManager implements Checkpoint {
     private durableExecutionArn;
     private stepData;
     private storage;
     private terminationManager;
-    private activeOperationsTracker;
     private stepDataEmitter;
     private logger;
-    private pendingCompletions;
+    private finishedAncestors;
     private queue;
     private isProcessing;
     private currentTaskToken;
     private forceCheckpointPromises;
     private queueCompletionResolver;
-    private queueCompletionTimeout;
     private readonly MAX_PAYLOAD_SIZE;
+    private readonly MAX_ITEMS_IN_BATCH;
     private isTerminating;
     private static textEncoder;
-    constructor(durableExecutionArn: string, stepData: Record<string, Operation>, storage: DurableExecutionClient, terminationManager: TerminationManager, activeOperationsTracker: ActiveOperationsTracker | undefined, initialTaskToken: string, stepDataEmitter: EventEmitter, logger: DurableLogger, pendingCompletions: Set<string>);
+    private operations;
+    private terminationTimer;
+    private terminationReason;
+    private readonly TERMINATION_COOLDOWN_MS;
+    constructor(durableExecutionArn: string, stepData: Record<string, Operation>, storage: DurableExecutionClient, terminationManager: TerminationManager, initialTaskToken: string, stepDataEmitter: EventEmitter, logger: DurableLogger, finishedAncestors: Set<string>);
     setTerminating(): void;
     /**
-     * Checks if a step ID or any of its ancestors has a pending completion
+     * Mark an ancestor as finished (for run-in-child-context operations)
+     */
+    markAncestorFinished(stepId: string): void;
+    /**
+     * Extract parent ID from hierarchical stepId (e.g., "1-2-3" -\> "1-2")
+     */
+    private getParentId;
+    /**
+     * Checks if any ancestor of the given stepId is finished
+     * Only applies to operations that are descendants of run-in-child-context operations
      */
-    hasPendingAncestorCompletion(stepId: string): boolean;
+    private hasFinishedAncestor;
     forceCheckpoint(): Promise<void>;
     waitForQueueCompletion(): Promise<void>;
     clearQueue(): void;
     force(): Promise<void>;
     checkpoint(stepId: string, data: Partial<OperationUpdate>): Promise<void>;
-    private hasFinishedAncestor;
     private classifyCheckpointError;
     private processQueue;
     private notifyQueueCompletion;
     private processBatch;
     private updateStepDataFromCheckpointResponse;
+    private resolveWaitingOperation;
     getQueueStatus(): {
         queueLength: number;
         isProcessing: boolean;
     };
+    markOperationState(stepId: string, state: OperationLifecycleState, options?: {
+        metadata?: OperationMetadata;
+        endTimestamp?: Date;
+    }): void;
+    waitForRetryTimer(stepId: string): Promise<void>;
+    waitForStatusChange(stepId: string): Promise<void>;
+    markOperationAwaited(stepId: string): void;
+    getOperationState(stepId: string): OperationLifecycleState | undefined;
+    getAllOperations(): Map<string, OperationInfo>;
+    private cleanupOperation;
+    private cleanupAllOperations;
+    /**
+     * Determines if the function should terminate.
+     * @returns TerminationReason if the function should terminate, or undefined if the function should not terminate
+     */
+    private shouldTerminate;
+    private checkAndTerminate;
+    private abortTermination;
+    private scheduleTermination;
+    private executeTermination;
+    private determineTerminationReason;
+    private startTimerWithPolling;
+    private forceRefreshAndCheckStatus;
 }
-export {};
 //# sourceMappingURL=checkpoint-manager.d.ts.map

package/dist-types/utils/checkpoint/checkpoint-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkpoint-manager.d.ts","sourceRoot":"","sources":["../../../src/utils/checkpoint/checkpoint-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EACf,SAAS,EAGV,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AAGnF,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAKtC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AASzD,UAAU,uBAAuB;IAC/B,SAAS,IAAI,IAAI,CAAC;IAClB,SAAS,IAAI,IAAI,CAAC;CACnB;AAED,qBAAa,iBAAkB,YAAW,UAAU;IAehD,OAAO,CAAC,mBAAmB;IAC3B,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,kBAAkB;IAC1B,OAAO,CAAC,uBAAuB;IAE/B,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,kBAAkB;IAtB5B,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,uBAAuB,CAGvB;IACR,OAAO,CAAC,uBAAuB,CAA6B;IAC5D,OAAO,CAAC,sBAAsB,CAA+B;IAC7D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAc;IAC/C,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAC,WAAW,CAAqB;gBAGrC,mBAAmB,EAAE,MAAM,EAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACnC,OAAO,EAAE,sBAAsB,EAC/B,kBAAkB,EAAE,kBAAkB,EACtC,uBAAuB,EAAE,uBAAuB,GAAG,SAAS,EACpE,gBAAgB,EAAE,MAAM,EAChB,eAAe,EAAE,YAAY,EAC7B,MAAM,EAAE,aAAa,EACrB,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC;IAKzC,cAAc,IAAI,IAAI;IAKtB;;OAEG;IACH,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAe/C,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBhC,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBtC,UAAU,IAAI,IAAI;IASnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,UAAU,CACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC;IAmDhB,OAAO,CAAC,mBAAmB;IAwB3B,OAAO,CAAC,uBAAuB;YAuDjB,YAAY;IA2G1B,OAAO,CAAC,qBAAqB;YAWf,YAAY;IA4C1B,OAAO,CAAC,oCAAoC;IAqB5C,cAAc,IAAI;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,OAAO,CAAC;KACvB;CAMF"}
+{"version":3,"file":"checkpoint-manager.d.ts","sourceRoot":"","sources":["../../../src/utils/checkpoint/checkpoint-manager.ts"],"names":[],"mappings":"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"}

package/dist-types/utils/constants/constants.d.ts

@@ -1,7 +1,6 @@
 /**
  * Shared constants to avoid circular dependencies
  */
-export declare const OPERATIONS_COMPLETE_EVENT = "allOperationsComplete";
 /**
  * Controls whether stack traces are stored in error objects
  * TODO: Accept this as configuration parameter in the future

package/dist-types/utils/constants/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/utils/constants/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,yBAAyB,0BAA0B,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAQ,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/utils/constants/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAQ,CAAC"}

package/dist-types/utils/durable-execution-invocation-input/durable-execution-invocation-input.d.ts

@@ -11,10 +11,12 @@ export declare class DurableExecutionInvocationInputWithClient implements Durabl
     readonly durableExecutionClient: DurableExecutionClient;
     readonly InitialExecutionState: {
         Operations: Operation[];
-        NextMarker: string;
+        NextMarker?: string | undefined;
     };
     readonly DurableExecutionArn: string;
     readonly CheckpointToken: string;
     constructor(params: DurableExecutionInvocationInput, durableExecutionClient: DurableExecutionClient);
+    static isInstance(event: unknown): event is DurableExecutionInvocationInputWithClient;
+    get [Symbol.toStringTag](): string;
 }
 //# sourceMappingURL=durable-execution-invocation-input.d.ts.map

package/dist-types/utils/durable-execution-invocation-input/durable-execution-invocation-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"durable-execution-invocation-input.d.ts","sourceRoot":"","sources":["../../../src/utils/durable-execution-invocation-input/durable-execution-invocation-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;GAKG;AACH,qBAAa,yCACX,YAAW,+BAA+B;aAUxB,sBAAsB,EAAE,sBAAsB;IARhE,SAAgB,qBAAqB,EAAE;QACrC,UAAU,EAAE,SAAS,EAAE,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,SAAgB,mBAAmB,EAAE,MAAM,CAAC;IAC5C,SAAgB,eAAe,EAAE,MAAM,CAAC;gBAEtC,MAAM,EAAE,+BAA+B,EACvB,sBAAsB,EAAE,sBAAsB;CAMjE"}
+{"version":3,"file":"durable-execution-invocation-input.d.ts","sourceRoot":"","sources":["../../../src/utils/durable-execution-invocation-input/durable-execution-invocation-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;GAKG;AACH,qBAAa,yCACX,YAAW,+BAA+B;aAUxB,sBAAsB,EAAE,sBAAsB;IARhE,SAAgB,qBAAqB,EAAE;QACrC,UAAU,EAAE,SAAS,EAAE,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACjC,CAAC;IACF,SAAgB,mBAAmB,EAAE,MAAM,CAAC;IAC5C,SAAgB,eAAe,EAAE,MAAM,CAAC;gBAEtC,MAAM,EAAE,+BAA+B,EACvB,sBAAsB,EAAE,sBAAsB;IAOhE,MAAM,CAAC,UAAU,CACf,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,yCAAyC;IAerD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;CACF"}

package/dist-types/utils/durable-execution-invocation-input/durable-execution-invocation-input.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=durable-execution-invocation-input.test.d.ts.map

package/dist-types/utils/durable-execution-invocation-input/durable-execution-invocation-input.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-execution-invocation-input.test.d.ts","sourceRoot":"","sources":["../../../src/utils/durable-execution-invocation-input/durable-execution-invocation-input.test.ts"],"names":[],"mappings":""}

package/dist-types/utils/termination-helper/termination-helper.d.ts

@@ -1,14 +1,5 @@
 import { ExecutionContext } from "../../types";
 import { UnrecoverableError } from "../../errors/unrecoverable-error/unrecoverable-error";
-import { TerminationReason } from "../../termination-manager/types";
-/**
- * Terminates execution and returns a never-resolving promise to prevent code progression
- * @param context - The execution context containing the termination manager
- * @param reason - The termination reason
- * @param message - The termination message
- * @returns A never-resolving promise
- */
-export declare function terminate<T>(context: ExecutionContext, reason: TerminationReason, message: string): Promise<T>;
 /**
  * Terminates execution for unrecoverable errors and returns a never-resolving promise
  * @param context - The execution context containing the termination manager

package/dist-types/utils/termination-helper/termination-helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"termination-helper.d.ts","sourceRoot":"","sources":["../../../src/utils/termination-helper/termination-helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAmFpE;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,CAAC,CAkHZ;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,CAAC,EAC9C,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,kBAAkB,EACzB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,CAAC,CAAC,CAMZ"}
+{"version":3,"file":"termination-helper.d.ts","sourceRoot":"","sources":["../../../src/utils/termination-helper/termination-helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAC;AAE1F;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,CAAC,EAC9C,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,kBAAkB,EACzB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/dist-types/with-durable-execution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"with-durable-execution.d.ts","sourceRoot":"","sources":["../src/with-durable-execution.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,aAAa,EAMd,MAAM,SAAS,CAAC;AAKjB,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AAoOnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AACH,eAAO,MAAM,oBAAoB,GAE/B,MAAM,GAAG,GAAG,EAEZ,OAAO,GAAG,GAAG,EACb,OAAO,SAAS,aAAa,GAAG,aAAa,EAE7C,SAAS,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAC1D,SAAS,sBAAsB,KAC9B,oBAuBF,CAAC"}
+{"version":3,"file":"with-durable-execution.d.ts","sourceRoot":"","sources":["../src/with-durable-execution.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,aAAa,EAMd,MAAM,SAAS,CAAC;AAKjB,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AA4PnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AACH,eAAO,MAAM,oBAAoB,GAE/B,MAAM,GAAG,GAAG,EAEZ,OAAO,GAAG,GAAG,EACb,OAAO,SAAS,aAAa,GAAG,aAAa,EAE7C,SAAS,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAC1D,SAAS,sBAAsB,KAC9B,oBAiBF,CAAC"}

package/package.json

@@ -2,8 +2,12 @@
   "name": "@aws/durable-execution-sdk-js",
   "description": "AWS Durable Execution Language SDK for TypeScript",
   "license": "Apache-2.0",
-  "version": "1.0.0",
-  "repository": "ssh:github.com/aws/aws-durable-execution-sdk-js/tree/main/packages/aws-durable-execution-sdk-js",
+  "version": "1.0.2",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/aws/aws-durable-execution-sdk-js.git",
+    "directory": "packages/aws-durable-execution-sdk-js"
+  },
   "homepage": "https://github.com/aws/aws-durable-execution-sdk-js/tree/main/packages/aws-durable-execution-sdk-js",
   "engines": {
     "node": ">=22"
@@ -47,10 +51,10 @@
   "devDependencies": {
     "@eslint/eslintrc": "^3.3.1",
     "@eslint/js": "^9.29.0",
+    "@microsoft/api-extractor": "^7.55.1",
     "@types/aws-lambda": "^8.10.147",
     "@typescript-eslint/eslint-plugin": "^8.25.0",
     "@typescript-eslint/parser": "^8.25.0",
-    "aws-lambda": "^1.0.7",
     "eslint": "^9.21.0",
     "eslint-plugin-filename-convention": "file:scripts/eslint-plugin-filename-convention",
     "eslint-plugin-tsdoc": "^0.4.0",
@@ -62,7 +66,7 @@
     "typescript": "^5.7.3"
   },
   "dependencies": {
-    "@aws-sdk/client-lambda": "*"
+    "@aws-sdk/client-lambda": "^3.943.0"
   },
   "private": false
 }

package/dist-types/utils/checkpoint/checkpoint-ancestor-checking.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=checkpoint-ancestor-checking.test.d.ts.map

package/dist-types/utils/checkpoint/checkpoint-ancestor-checking.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"checkpoint-ancestor-checking.test.d.ts","sourceRoot":"","sources":["../../../src/utils/checkpoint/checkpoint-ancestor-checking.test.ts"],"names":[],"mappings":""}

package/dist-types/utils/termination-helper/active-operations-tracker.d.ts

@@ -1,31 +0,0 @@
-/**
- * Tracks active async operations to prevent premature termination
- */
-export declare class ActiveOperationsTracker {
-    private activeCount;
-    /**
-     * Increment the counter when starting an async operation
-     */
-    increment(): void;
-    /**
-     * Decrement the counter when an async operation completes
-     */
-    decrement(): void;
-    /**
-     * Check if there are any active operations
-     */
-    hasActive(): boolean;
-    /**
-     * Get the current count of active operations
-     */
-    getCount(): number;
-    /**
-     * Reset the counter (useful for testing)
-     */
-    reset(): void;
-}
-/**
- * Wraps an async function to track its execution
- */
-export declare function trackOperation<T>(tracker: ActiveOperationsTracker, operation: () => Promise<T>): Promise<T>;
-//# sourceMappingURL=active-operations-tracker.d.ts.map

package/dist-types/utils/termination-helper/active-operations-tracker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"active-operations-tracker.d.ts","sourceRoot":"","sources":["../../../src/utils/termination-helper/active-operations-tracker.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,WAAW,CAAK;IAExB;;OAEG;IACH,SAAS,IAAI,IAAI;IAIjB;;OAEG;IACH,SAAS,IAAI,IAAI;IAIjB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,OAAO,EAAE,uBAAuB,EAChC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/dist-types/utils/termination-helper/active-operations-tracker.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=active-operations-tracker.test.d.ts.map

package/dist-types/utils/termination-helper/active-operations-tracker.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"active-operations-tracker.test.d.ts","sourceRoot":"","sources":["../../../src/utils/termination-helper/active-operations-tracker.test.ts"],"names":[],"mappings":""}

package/dist-types/utils/wait-before-continue/wait-before-continue.d.ts

@@ -1,35 +0,0 @@
-import { ExecutionContext } from "../../types";
-import { Checkpoint } from "../checkpoint/checkpoint-helper";
-import { EventEmitter } from "events";
-export interface WaitBeforeContinueOptions {
-    /** Check if operations are still running */
-    checkHasRunningOperations: boolean;
-    /** Check if step status has changed */
-    checkStepStatus: boolean;
-    /** Check if timer has expired */
-    checkTimer: boolean;
-    /** Scheduled end timestamp for timer check */
-    scheduledEndTimestamp?: Date | null;
-    /** Step ID to get current status */
-    stepId: string;
-    /** Execution context to get step data */
-    context: ExecutionContext;
-    /** Function to check if operations are running */
-    hasRunningOperations: () => boolean;
-    /** EventEmitter for operations completion events */
-    operationsEmitter: EventEmitter;
-    /** Checkpoint manager to force refresh when timer expires */
-    checkpoint?: Checkpoint;
-    /** Function to set callback that will be invoked when promise is awaited */
-    onAwaitedChange?: (callback: () => void) => void;
-}
-export interface WaitBeforeContinueResult {
-    reason: "timer" | "operations" | "status" | "timeout";
-    timerExpired?: boolean;
-}
-/**
- * High-level helper that waits for conditions before continuing execution.
- * Uses event-driven approach for both operations completion and status changes.
- */
-export declare function waitBeforeContinue(options: WaitBeforeContinueOptions): Promise<WaitBeforeContinueResult>;
-//# sourceMappingURL=wait-before-continue.d.ts.map

package/dist-types/utils/wait-before-continue/wait-before-continue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wait-before-continue.d.ts","sourceRoot":"","sources":["../../../src/utils/wait-before-continue/wait-before-continue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,MAAM,WAAW,yBAAyB;IACxC,4CAA4C;IAC5C,yBAAyB,EAAE,OAAO,CAAC;IACnC,uCAAuC;IACvC,eAAe,EAAE,OAAO,CAAC;IACzB,iCAAiC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,8CAA8C;IAC9C,qBAAqB,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACpC,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,kDAAkD;IAClD,oBAAoB,EAAE,MAAM,OAAO,CAAC;IACpC,oDAAoD;IACpD,iBAAiB,EAAE,YAAY,CAAC;IAChC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,OAAO,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CA+HnC"}

package/dist-types/utils/wait-before-continue/wait-before-continue.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=wait-before-continue.test.d.ts.map

package/dist-types/utils/wait-before-continue/wait-before-continue.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wait-before-continue.test.d.ts","sourceRoot":"","sources":["../../../src/utils/wait-before-continue/wait-before-continue.test.ts"],"names":[],"mappings":""}