@superdurable/dex 1.17.0 → 1.20.0

package/README.md

@@ -637,6 +637,9 @@ reads (`describeFlow`, `waitForFlow`, and `timeTravel`) use
 `FlowNotActiveOrNotFoundError`. Start conflicts, worker failures, RPC lock contention,
 and long-poll timeouts use `FlowAlreadyStartedError`,
 `WorkerInvocationError`, `RpcLockConflictError`, and `LongPollTimeoutError`.
+An update-class request rejected during Flow close cleanup uses
+`FlowClosingError` with sub-status `FLOW_CLOSING`. Re-read the retained terminal
+Flow state before deciding whether another action is needed.
 
 RPCs also use this error when the target Flow cannot be found, including query-only
 reads. A query-only RPC without locks, transactional execution, durable effects, or

package/dist/src/errors.d.ts

@@ -18,6 +18,8 @@ export declare const ErrorSubStatus: Readonly<{
     readonly CHANNEL_MESSAGE_NOT_FOUND: "channelMessageNotFound";
     /** A caller-defined request budget expired. */
     readonly REQUEST_TIMEOUT: "requestTimeout";
+    /** Dex rejected an update-class request during Flow close cleanup. */
+    readonly FLOW_CLOSING: "flowClosing";
 }>;
 /** Represents a value from {@link ErrorSubStatus}. */
 export type ErrorSubStatus = (typeof ErrorSubStatus)[keyof typeof ErrorSubStatus];
@@ -59,6 +61,25 @@ export declare class DexServiceError extends Error {
 /** Indicates that `startFlow` conflicts with an existing Flow ID. */
 export declare class FlowAlreadyStartedError extends DexServiceError {
 }
+/**
+ * Reports a request rejected while Dex closes a Flow.
+ * Re-read the retained terminal Flow state before deciding what to do next.
+ * @example
+ * ```typescript
+ * const options = { requestTimeoutMs: timeoutMs };
+ * try {
+ *   await client.waitForStepCompletion(flowId, stepExecutionId, options);
+ * } catch (error) {
+ *   if (error instanceof FlowClosingError) {
+ *     await client.waitForFlow(flowId);
+ *   } else {
+ *     throw error;
+ *   }
+ * }
+ * ```
+ */
+export declare class FlowClosingError extends DexServiceError {
+}
 /** Indicates that an operation targeted a Flow ID that does not exist. */
 export declare class FlowNotFoundError extends DexServiceError {
 }

package/dist/src/errors.js

@@ -24,6 +24,8 @@ export const ErrorSubStatus = Object.freeze({
     CHANNEL_MESSAGE_NOT_FOUND: "channelMessageNotFound",
     /** A caller-defined request budget expired. */
     REQUEST_TIMEOUT: "requestTimeout",
+    /** Dex rejected an update-class request during Flow close cleanup. */
+    FLOW_CLOSING: "flowClosing",
 });
 /** Provides terminal Flow failure categories returned by Dex. */
 export const FlowErrorType = Object.freeze({
@@ -69,6 +71,25 @@ export class DexServiceError extends Error {
 /** Indicates that `startFlow` conflicts with an existing Flow ID. */
 export class FlowAlreadyStartedError extends DexServiceError {
 }
+/**
+ * Reports a request rejected while Dex closes a Flow.
+ * Re-read the retained terminal Flow state before deciding what to do next.
+ * @example
+ * ```typescript
+ * const options = { requestTimeoutMs: timeoutMs };
+ * try {
+ *   await client.waitForStepCompletion(flowId, stepExecutionId, options);
+ * } catch (error) {
+ *   if (error instanceof FlowClosingError) {
+ *     await client.waitForFlow(flowId);
+ *   } else {
+ *     throw error;
+ *   }
+ * }
+ * ```
+ */
+export class FlowClosingError extends DexServiceError {
+}
 /** Indicates that an operation targeted a Flow ID that does not exist. */
 export class FlowNotFoundError extends DexServiceError {
 }

package/dist/src/errors.js.map

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

package/dist/src/gen/dex.d.ts

@@ -195,6 +195,8 @@ export declare enum ErrorSubStatus {
     ERROR_SUB_STATUS_LONG_POLL_TIME_OUT = 5,
     ERROR_SUB_STATUS_CHANNEL_MESSAGE_NOT_FOUND = 6,
     ERROR_SUB_STATUS_REQUEST_TIMEOUT = 7,
+    /** ERROR_SUB_STATUS_FLOW_CLOSING - An update-class request arrived while Flow close cleanup is in progress. */
+    ERROR_SUB_STATUS_FLOW_CLOSING = 8,
     UNRECOGNIZED = -1
 }
 export declare enum CloseDecisionType {

package/dist/src/gen/dex.js

@@ -221,6 +221,8 @@ export var ErrorSubStatus;
     ErrorSubStatus[ErrorSubStatus["ERROR_SUB_STATUS_LONG_POLL_TIME_OUT"] = 5] = "ERROR_SUB_STATUS_LONG_POLL_TIME_OUT";
     ErrorSubStatus[ErrorSubStatus["ERROR_SUB_STATUS_CHANNEL_MESSAGE_NOT_FOUND"] = 6] = "ERROR_SUB_STATUS_CHANNEL_MESSAGE_NOT_FOUND";
     ErrorSubStatus[ErrorSubStatus["ERROR_SUB_STATUS_REQUEST_TIMEOUT"] = 7] = "ERROR_SUB_STATUS_REQUEST_TIMEOUT";
+    /** ERROR_SUB_STATUS_FLOW_CLOSING - An update-class request arrived while Flow close cleanup is in progress. */
+    ErrorSubStatus[ErrorSubStatus["ERROR_SUB_STATUS_FLOW_CLOSING"] = 8] = "ERROR_SUB_STATUS_FLOW_CLOSING";
     ErrorSubStatus[ErrorSubStatus["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
 })(ErrorSubStatus || (ErrorSubStatus = {}));
 export var CloseDecisionType;