@ferricstore/ferricstore 0.1.5 → 0.1.6

package/dist/index.d.cts

@@ -871,6 +871,32 @@ interface ClaimDueOptions {
 interface ReclaimOptions extends Omit<ClaimDueOptions, "state" | "states" | "blockMs" | "reclaimExpired" | "reclaimRatio" | "includeState"> {
     state?: "running";
 }
+type FlowStateMode = "fifo" | "parallel";
+interface FlowStatePolicy {
+    mode?: FlowStateMode;
+    retry?: RetryPolicy;
+}
+type FlowStatePolicyLike = FlowStatePolicy | RetryPolicy;
+interface FlowPolicyOptions {
+    state?: string;
+    mode?: FlowStateMode;
+    retry?: RetryPolicy;
+    states?: Record<string, FlowStatePolicyLike>;
+    retentionTtlMs?: number;
+    indexedStateMeta?: string;
+}
+interface RequestContext {
+    subject?: string;
+    tenant?: string;
+    scopes?: string | readonly string[];
+}
+interface RequestContextOptions {
+    requestContext?: RequestContext;
+}
+interface InvocationCreateOptions extends RequestContextOptions {
+    context?: Record<string, unknown>;
+    idempotencyKey?: string;
+}
 interface MutateOptions {
     partitionKey?: string;
     payload?: unknown;
@@ -1063,6 +1089,14 @@ declare class FerricStoreClient {
     namespaceUsage(prefix: string): Promise<Record<string, unknown>>;
     flowQuery(attrs?: ManagementPairs): Promise<unknown[]>;
     flowHistory(id: string, attrs?: ManagementPairs): Promise<unknown[]>;
+    invocationDefinitionPut(definition: Record<string, unknown> | string, options?: RequestContextOptions): Promise<unknown>;
+    invocationDefinitionGet(name: string, options?: RequestContextOptions): Promise<unknown>;
+    invocationDefinitionList(options?: RequestContextOptions): Promise<unknown[]>;
+    invocationCreate(name: string, attrs: Record<string, unknown>, options?: InvocationCreateOptions): Promise<unknown>;
+    invocationGet(id: string, options?: RequestContextOptions): Promise<unknown>;
+    invocationPartitionList(name: string, options?: RequestContextOptions & {
+        scope?: string;
+    }): Promise<unknown[]>;
     create(id: string, options: CreateOptions): Promise<FlowRecord | Buffer | unknown>;
     enqueue(id: string, options: Omit<CreateOptions, "state"> & {
         state?: string;
@@ -1217,12 +1251,7 @@ declare class FerricStoreClient {
         values?: Record<string, unknown>;
         valueRefs?: Record<string, string>;
     }): Promise<unknown>;
-    installPolicy(type: string, options?: {
-        state?: string;
-        retry?: RetryPolicy;
-        retentionTtlMs?: number;
-        indexedStateMeta?: string;
-    }): Promise<unknown>;
+    installPolicy(type: string, options?: FlowPolicyOptions): Promise<unknown>;
     policyGet(type: string, options?: {
         state?: string;
     }): Promise<Record<string, unknown>>;
@@ -1392,6 +1421,7 @@ declare class QueueWorker {
 
 type WorkflowHandler = (ctx: WorkflowContext) => Promise<Outcome | void | unknown> | Outcome | void | unknown;
 interface StateOptions {
+    mode?: FlowStateMode;
     leaseMs?: number;
     claimPayload?: boolean;
     claimRecord?: boolean;
@@ -1420,6 +1450,7 @@ interface StateRegistration {
     exceptionPolicy: ExceptionPolicy;
     handler: WorkflowHandler;
     leaseMs: number;
+    mode?: FlowStateMode;
     name: string;
     returnRecord: boolean;
     retryPolicy?: RetryPolicy;
@@ -1484,6 +1515,7 @@ declare class Workflow {
     worker(options?: WorkerConfig & {
         states?: string[];
     }): WorkflowWorker;
+    installPolicy(options?: Omit<FlowPolicyOptions, "mode" | "state" | "states">): Promise<unknown>;
     stateNames(): string[];
     stateRegistration(name: string): StateRegistration | undefined;
 }
@@ -1560,4 +1592,4 @@ declare class WorkflowWorker {
     private applyHandlerError;
 }
 
-export { type AutoBatchOptions, type BackoffKind, type BackpressurePolicy, BitmapStore, BloomFilterStore, COMMAND_OPCODES, type CancelOptions, type ChildSpec, type ClaimDueOptions, type ClaimedItem, type Codec, type Command, type CommandArgument, type CommandExecutor, type CompleteOptions, type CompleteOutcome, type CountMinMergeOptions, CountMinSketchStore, type CreateItem, type CreateManyOptions, type CreateOptions, CuckooFilterStore, type EndpointPolicy, type ExceptionPolicy, type ExecutePipelineOptions, type FailOptions, type FailOutcome, type FencedItem, FerricStoreClient, type FerricStoreClientFromUrlOptions, type FerricStoreClientOptions, FerricStoreError, type FetchOrComputeResult, FlowAlreadyExistsError, FlowNotFoundError, type FlowRecord, FlowWrongStateError, type GeoAddOptions, type GeoMember, GeoStore, type GetExOptions, HashStore, HyperLogLogStore, InvalidCommandError, JsonCodec, type JsonSetOptions, JsonStore, type KeyInfo, KeyValueStore, ListStore, LockHeldError, LockNotOwnedError, type ManagementPairs, type MutateOptions, type NamedValueMutation, NativeAdapter, type NativeAdapterOptions, type Outcome, OverloadedError, type ProtocolCommand, Queue, type QueueBatchHandler, QueueClient, type QueueHandler, type QueueJob, type QueueOptions, QueueWorker, type QueueWorkerResult, type RangeLimit, type RateLimitResult, RawCodec, type ReadOptions, type ReclaimOptions, type ReconnectOptions, ReconnectingExecutor, type RetryOptions, type RetryOutcome, type RetryPolicy, type RoutingEndpoint, type RoutingRoute, RoutingTopology, type ScanOptions, type SearchOptions, type SearchStateMeta, type SetOptions, SetStore, SortedSetStore, StaleLeaseError, type StateMeta, type StateMetaValue, type StateOptions, type StateRegistration, type StoreCommandClient, StreamStore, type TDigestCreateOptions, type TDigestMergeOptions, TDigestStore, type TopKReserveOptions, TopKStore, TopologyNativeAdapterPool, type TransitionOptions, type TransitionOutcome, type ValueConfig, type WorkerConfig, type WorkerProfile, Workflow, WorkflowClient, WorkflowContext, WorkflowFlowCommands, type WorkflowHandler, type WorkflowOptions, WorkflowWorker, type WorkflowWorkerResult, type XReadStream, type ZAddMember, type ZAddOptions, classifyServerError, complete, fail, isReconnectableClosedConnectionError, mapException, retry, transition };
+export { type AutoBatchOptions, type BackoffKind, type BackpressurePolicy, BitmapStore, BloomFilterStore, COMMAND_OPCODES, type CancelOptions, type ChildSpec, type ClaimDueOptions, type ClaimedItem, type Codec, type Command, type CommandArgument, type CommandExecutor, type CompleteOptions, type CompleteOutcome, type CountMinMergeOptions, CountMinSketchStore, type CreateItem, type CreateManyOptions, type CreateOptions, CuckooFilterStore, type EndpointPolicy, type ExceptionPolicy, type ExecutePipelineOptions, type FailOptions, type FailOutcome, type FencedItem, FerricStoreClient, type FerricStoreClientFromUrlOptions, type FerricStoreClientOptions, FerricStoreError, type FetchOrComputeResult, FlowAlreadyExistsError, FlowNotFoundError, type FlowPolicyOptions, type FlowRecord, type FlowStateMode, type FlowStatePolicy, type FlowStatePolicyLike, FlowWrongStateError, type GeoAddOptions, type GeoMember, GeoStore, type GetExOptions, HashStore, HyperLogLogStore, InvalidCommandError, type InvocationCreateOptions, JsonCodec, type JsonSetOptions, JsonStore, type KeyInfo, KeyValueStore, ListStore, LockHeldError, LockNotOwnedError, type ManagementPairs, type MutateOptions, type NamedValueMutation, NativeAdapter, type NativeAdapterOptions, type Outcome, OverloadedError, type ProtocolCommand, Queue, type QueueBatchHandler, QueueClient, type QueueHandler, type QueueJob, type QueueOptions, QueueWorker, type QueueWorkerResult, type RangeLimit, type RateLimitResult, RawCodec, type ReadOptions, type ReclaimOptions, type ReconnectOptions, ReconnectingExecutor, type RequestContext, type RequestContextOptions, type RetryOptions, type RetryOutcome, type RetryPolicy, type RoutingEndpoint, type RoutingRoute, RoutingTopology, type ScanOptions, type SearchOptions, type SearchStateMeta, type SetOptions, SetStore, SortedSetStore, StaleLeaseError, type StateMeta, type StateMetaValue, type StateOptions, type StateRegistration, type StoreCommandClient, StreamStore, type TDigestCreateOptions, type TDigestMergeOptions, TDigestStore, type TopKReserveOptions, TopKStore, TopologyNativeAdapterPool, type TransitionOptions, type TransitionOutcome, type ValueConfig, type WorkerConfig, type WorkerProfile, Workflow, WorkflowClient, WorkflowContext, WorkflowFlowCommands, type WorkflowHandler, type WorkflowOptions, WorkflowWorker, type WorkflowWorkerResult, type XReadStream, type ZAddMember, type ZAddOptions, classifyServerError, complete, fail, isReconnectableClosedConnectionError, mapException, retry, transition };

package/dist/index.d.ts

@@ -871,6 +871,32 @@ interface ClaimDueOptions {
 interface ReclaimOptions extends Omit<ClaimDueOptions, "state" | "states" | "blockMs" | "reclaimExpired" | "reclaimRatio" | "includeState"> {
     state?: "running";
 }
+type FlowStateMode = "fifo" | "parallel";
+interface FlowStatePolicy {
+    mode?: FlowStateMode;
+    retry?: RetryPolicy;
+}
+type FlowStatePolicyLike = FlowStatePolicy | RetryPolicy;
+interface FlowPolicyOptions {
+    state?: string;
+    mode?: FlowStateMode;
+    retry?: RetryPolicy;
+    states?: Record<string, FlowStatePolicyLike>;
+    retentionTtlMs?: number;
+    indexedStateMeta?: string;
+}
+interface RequestContext {
+    subject?: string;
+    tenant?: string;
+    scopes?: string | readonly string[];
+}
+interface RequestContextOptions {
+    requestContext?: RequestContext;
+}
+interface InvocationCreateOptions extends RequestContextOptions {
+    context?: Record<string, unknown>;
+    idempotencyKey?: string;
+}
 interface MutateOptions {
     partitionKey?: string;
     payload?: unknown;
@@ -1063,6 +1089,14 @@ declare class FerricStoreClient {
     namespaceUsage(prefix: string): Promise<Record<string, unknown>>;
     flowQuery(attrs?: ManagementPairs): Promise<unknown[]>;
     flowHistory(id: string, attrs?: ManagementPairs): Promise<unknown[]>;
+    invocationDefinitionPut(definition: Record<string, unknown> | string, options?: RequestContextOptions): Promise<unknown>;
+    invocationDefinitionGet(name: string, options?: RequestContextOptions): Promise<unknown>;
+    invocationDefinitionList(options?: RequestContextOptions): Promise<unknown[]>;
+    invocationCreate(name: string, attrs: Record<string, unknown>, options?: InvocationCreateOptions): Promise<unknown>;
+    invocationGet(id: string, options?: RequestContextOptions): Promise<unknown>;
+    invocationPartitionList(name: string, options?: RequestContextOptions & {
+        scope?: string;
+    }): Promise<unknown[]>;
     create(id: string, options: CreateOptions): Promise<FlowRecord | Buffer | unknown>;
     enqueue(id: string, options: Omit<CreateOptions, "state"> & {
         state?: string;
@@ -1217,12 +1251,7 @@ declare class FerricStoreClient {
         values?: Record<string, unknown>;
         valueRefs?: Record<string, string>;
     }): Promise<unknown>;
-    installPolicy(type: string, options?: {
-        state?: string;
-        retry?: RetryPolicy;
-        retentionTtlMs?: number;
-        indexedStateMeta?: string;
-    }): Promise<unknown>;
+    installPolicy(type: string, options?: FlowPolicyOptions): Promise<unknown>;
     policyGet(type: string, options?: {
         state?: string;
     }): Promise<Record<string, unknown>>;
@@ -1392,6 +1421,7 @@ declare class QueueWorker {
 
 type WorkflowHandler = (ctx: WorkflowContext) => Promise<Outcome | void | unknown> | Outcome | void | unknown;
 interface StateOptions {
+    mode?: FlowStateMode;
     leaseMs?: number;
     claimPayload?: boolean;
     claimRecord?: boolean;
@@ -1420,6 +1450,7 @@ interface StateRegistration {
     exceptionPolicy: ExceptionPolicy;
     handler: WorkflowHandler;
     leaseMs: number;
+    mode?: FlowStateMode;
     name: string;
     returnRecord: boolean;
     retryPolicy?: RetryPolicy;
@@ -1484,6 +1515,7 @@ declare class Workflow {
     worker(options?: WorkerConfig & {
         states?: string[];
     }): WorkflowWorker;
+    installPolicy(options?: Omit<FlowPolicyOptions, "mode" | "state" | "states">): Promise<unknown>;
     stateNames(): string[];
     stateRegistration(name: string): StateRegistration | undefined;
 }
@@ -1560,4 +1592,4 @@ declare class WorkflowWorker {
     private applyHandlerError;
 }
 
-export { type AutoBatchOptions, type BackoffKind, type BackpressurePolicy, BitmapStore, BloomFilterStore, COMMAND_OPCODES, type CancelOptions, type ChildSpec, type ClaimDueOptions, type ClaimedItem, type Codec, type Command, type CommandArgument, type CommandExecutor, type CompleteOptions, type CompleteOutcome, type CountMinMergeOptions, CountMinSketchStore, type CreateItem, type CreateManyOptions, type CreateOptions, CuckooFilterStore, type EndpointPolicy, type ExceptionPolicy, type ExecutePipelineOptions, type FailOptions, type FailOutcome, type FencedItem, FerricStoreClient, type FerricStoreClientFromUrlOptions, type FerricStoreClientOptions, FerricStoreError, type FetchOrComputeResult, FlowAlreadyExistsError, FlowNotFoundError, type FlowRecord, FlowWrongStateError, type GeoAddOptions, type GeoMember, GeoStore, type GetExOptions, HashStore, HyperLogLogStore, InvalidCommandError, JsonCodec, type JsonSetOptions, JsonStore, type KeyInfo, KeyValueStore, ListStore, LockHeldError, LockNotOwnedError, type ManagementPairs, type MutateOptions, type NamedValueMutation, NativeAdapter, type NativeAdapterOptions, type Outcome, OverloadedError, type ProtocolCommand, Queue, type QueueBatchHandler, QueueClient, type QueueHandler, type QueueJob, type QueueOptions, QueueWorker, type QueueWorkerResult, type RangeLimit, type RateLimitResult, RawCodec, type ReadOptions, type ReclaimOptions, type ReconnectOptions, ReconnectingExecutor, type RetryOptions, type RetryOutcome, type RetryPolicy, type RoutingEndpoint, type RoutingRoute, RoutingTopology, type ScanOptions, type SearchOptions, type SearchStateMeta, type SetOptions, SetStore, SortedSetStore, StaleLeaseError, type StateMeta, type StateMetaValue, type StateOptions, type StateRegistration, type StoreCommandClient, StreamStore, type TDigestCreateOptions, type TDigestMergeOptions, TDigestStore, type TopKReserveOptions, TopKStore, TopologyNativeAdapterPool, type TransitionOptions, type TransitionOutcome, type ValueConfig, type WorkerConfig, type WorkerProfile, Workflow, WorkflowClient, WorkflowContext, WorkflowFlowCommands, type WorkflowHandler, type WorkflowOptions, WorkflowWorker, type WorkflowWorkerResult, type XReadStream, type ZAddMember, type ZAddOptions, classifyServerError, complete, fail, isReconnectableClosedConnectionError, mapException, retry, transition };
+export { type AutoBatchOptions, type BackoffKind, type BackpressurePolicy, BitmapStore, BloomFilterStore, COMMAND_OPCODES, type CancelOptions, type ChildSpec, type ClaimDueOptions, type ClaimedItem, type Codec, type Command, type CommandArgument, type CommandExecutor, type CompleteOptions, type CompleteOutcome, type CountMinMergeOptions, CountMinSketchStore, type CreateItem, type CreateManyOptions, type CreateOptions, CuckooFilterStore, type EndpointPolicy, type ExceptionPolicy, type ExecutePipelineOptions, type FailOptions, type FailOutcome, type FencedItem, FerricStoreClient, type FerricStoreClientFromUrlOptions, type FerricStoreClientOptions, FerricStoreError, type FetchOrComputeResult, FlowAlreadyExistsError, FlowNotFoundError, type FlowPolicyOptions, type FlowRecord, type FlowStateMode, type FlowStatePolicy, type FlowStatePolicyLike, FlowWrongStateError, type GeoAddOptions, type GeoMember, GeoStore, type GetExOptions, HashStore, HyperLogLogStore, InvalidCommandError, type InvocationCreateOptions, JsonCodec, type JsonSetOptions, JsonStore, type KeyInfo, KeyValueStore, ListStore, LockHeldError, LockNotOwnedError, type ManagementPairs, type MutateOptions, type NamedValueMutation, NativeAdapter, type NativeAdapterOptions, type Outcome, OverloadedError, type ProtocolCommand, Queue, type QueueBatchHandler, QueueClient, type QueueHandler, type QueueJob, type QueueOptions, QueueWorker, type QueueWorkerResult, type RangeLimit, type RateLimitResult, RawCodec, type ReadOptions, type ReclaimOptions, type ReconnectOptions, ReconnectingExecutor, type RequestContext, type RequestContextOptions, type RetryOptions, type RetryOutcome, type RetryPolicy, type RoutingEndpoint, type RoutingRoute, RoutingTopology, type ScanOptions, type SearchOptions, type SearchStateMeta, type SetOptions, SetStore, SortedSetStore, StaleLeaseError, type StateMeta, type StateMetaValue, type StateOptions, type StateRegistration, type StoreCommandClient, StreamStore, type TDigestCreateOptions, type TDigestMergeOptions, TDigestStore, type TopKReserveOptions, TopKStore, TopologyNativeAdapterPool, type TransitionOptions, type TransitionOutcome, type ValueConfig, type WorkerConfig, type WorkerProfile, Workflow, WorkflowClient, WorkflowContext, WorkflowFlowCommands, type WorkflowHandler, type WorkflowOptions, WorkflowWorker, type WorkflowWorkerResult, type XReadStream, type ZAddMember, type ZAddOptions, classifyServerError, complete, fail, isReconnectableClosedConnectionError, mapException, retry, transition };

package/dist/index.js

@@ -492,14 +492,64 @@ function commandExec(args) {
   if (args.length === 0) {
     throw new FerricStoreError("command requires at least one argument");
   }
+  const commandArgs = args.slice(1);
+  const payload = {
+    args: commandArgs,
+    command: asText(args[0]).toUpperCase()
+  };
+  if (commandArgs.length >= 2 && commandTokenIs(commandArgs[commandArgs.length - 2], "REQUEST_CONTEXT")) {
+    const requestContext = normalizeRequestContext(commandArgs[commandArgs.length - 1]);
+    payload.args = commandArgs.slice(0, -2);
+    if (requestContext != null) {
+      payload.request_context = requestContext;
+    }
+  }
   return {
     opcode: OPCODES.commandExec,
-    payload: {
-      args: args.slice(1),
-      command: asText(args[0]).toUpperCase()
-    }
+    payload
   };
 }
+function normalizeRequestContext(context) {
+  if (!isPlainObject(context)) {
+    return void 0;
+  }
+  const out = {};
+  const subject = optionalText(context.subject);
+  const tenant = optionalText(context.tenant);
+  const scopes = normalizeRequestContextScopes(context.scopes);
+  if (subject != null) {
+    out.subject = subject;
+  }
+  if (tenant != null) {
+    out.tenant = tenant;
+  }
+  if (scopes.length > 0) {
+    out.scopes = scopes;
+  }
+  return Object.keys(out).length > 0 ? out : void 0;
+}
+function normalizeRequestContextScopes(scopes) {
+  const values = typeof scopes === "string" || Buffer2.isBuffer(scopes) || scopes instanceof Uint8Array ? asText(scopes).split(/\s+/u) : Array.isArray(scopes) ? scopes.map((scope) => optionalText(scope)).filter((scope) => scope != null) : [];
+  return [...new Set(values.filter((scope) => scope.length > 0))];
+}
+function optionalText(value) {
+  if (value == null || value === "") {
+    return void 0;
+  }
+  if (typeof value === "string" || typeof value === "number" || typeof value === "bigint" || typeof value === "boolean" || Buffer2.isBuffer(value) || value instanceof Uint8Array) {
+    return asText(value);
+  }
+  return void 0;
+}
+function commandTokenIs(value, expected) {
+  if (typeof value === "string") {
+    return value.toUpperCase() === expected;
+  }
+  if (Buffer2.isBuffer(value) || value instanceof Uint8Array) {
+    return asText(value).toUpperCase() === expected;
+  }
+  return false;
+}
 function pipelineCommand(commands) {
   const compact = compactPipelinePayload(commands);
   if (compact != null) {
@@ -4360,6 +4410,59 @@ var FerricStoreClient = class _FerricStoreClient {
     );
     return Array.isArray(response) ? [...response] : [];
   }
+  async invocationDefinitionPut(definition, options = {}) {
+    return normalizeAdminResponse(
+      await this.command(
+        ...commandWithRequestContext(
+          "INVOCATION.DEFINITION.PUT",
+          [jsonArg(definition)],
+          options.requestContext
+        )
+      )
+    );
+  }
+  async invocationDefinitionGet(name, options = {}) {
+    return normalizeAdminResponse(
+      await this.command(
+        ...commandWithRequestContext("INVOCATION.DEFINITION.GET", [name], options.requestContext)
+      )
+    );
+  }
+  async invocationDefinitionList(options = {}) {
+    const response = normalizeAdminResponse(
+      await this.command(
+        ...commandWithRequestContext("INVOCATION.DEFINITION.LIST", [], options.requestContext)
+      )
+    );
+    return Array.isArray(response) ? [...response] : [];
+  }
+  async invocationCreate(name, attrs, options = {}) {
+    const envelope = { attrs };
+    if (options.context != null) {
+      envelope.context = options.context;
+    }
+    if (options.idempotencyKey != null) {
+      envelope.idempotency_key = options.idempotencyKey;
+    }
+    return normalizeAdminResponse(
+      await this.command(
+        ...commandWithRequestContext("INVOCATION.CREATE", [name, jsonArg(envelope)], options.requestContext)
+      )
+    );
+  }
+  async invocationGet(id, options = {}) {
+    return normalizeAdminResponse(
+      await this.command(...commandWithRequestContext("INVOCATION.GET", [id], options.requestContext))
+    );
+  }
+  async invocationPartitionList(name, options = {}) {
+    const args = [name];
+    append(args, "SCOPE", options.scope);
+    const response = normalizeAdminResponse(
+      await this.command(...commandWithRequestContext("INVOCATION.PARTITION.LIST", args, options.requestContext))
+    );
+    return Array.isArray(response) ? [...response] : [];
+  }
   async create(id, options) {
     const currentNowMs = options.nowMs ?? nowMs();
     const args = [
@@ -4392,7 +4495,6 @@ var FerricStoreClient = class _FerricStoreClient {
   async enqueue(id, options) {
     return await this.create(id, {
       ...options,
-      priority: options.priority ?? 0,
       state: options.state ?? "queued"
     });
   }
@@ -4404,7 +4506,6 @@ var FerricStoreClient = class _FerricStoreClient {
       return await this.createMany(options.partitionKey, items, {
         ...options,
         independent: options.independent ?? true,
-        priority: options.priority ?? 0,
         state: options.state ?? "queued"
       });
     }
@@ -4419,7 +4520,6 @@ var FerricStoreClient = class _FerricStoreClient {
       const response = await this.createMany(bucket, groupItems, {
         ...options,
         independent: options.independent ?? true,
-        priority: options.priority ?? 0,
         state: options.state ?? "queued"
       });
       const expanded = expandManyResponse(response, indexedItems.length);
@@ -4572,8 +4672,7 @@ var FerricStoreClient = class _FerricStoreClient {
       ...options,
       includeState: options.includeState ?? false,
       jobOnly: true,
-      limit: options.limit ?? 100,
-      priority: options.priority ?? 0
+      limit: options.limit ?? 100
     });
   }
   async reclaim(type, options) {
@@ -4924,9 +5023,14 @@ var FerricStoreClient = class _FerricStoreClient {
     const args = ["FLOW.POLICY.SET", type];
     append(args, "INDEXED_STATE_META", options.indexedStateMeta);
     append(args, "STATE", options.state);
+    appendPolicyMode(args, options.state, options.mode);
     if (options.retry != null) {
       appendRetryPolicy(args, options.retry);
     }
+    for (const [state, policy] of Object.entries(options.states ?? {})) {
+      args.push("STATE", state);
+      appendFlowStatePolicy(args, policy);
+    }
     append(args, "RETENTION_TTL_MS", options.retentionTtlMs);
     return await this.command(...args);
   }
@@ -5306,6 +5410,16 @@ function appendSearchStateMeta(args, state, stateMeta) {
 function normalizeAdminResponse(value) {
   return normalizeRefMeta(value);
 }
+function jsonArg(value) {
+  return typeof value === "string" ? value : JSON.stringify(value);
+}
+function commandWithRequestContext(command, args, requestContext) {
+  const commandArgs = [command, ...args];
+  if (requestContext != null) {
+    commandArgs.push("REQUEST_CONTEXT", requestContext);
+  }
+  return commandArgs;
+}
 function infoText(value) {
   if (typeof value === "string" || Buffer.isBuffer(value)) {
     return text(value);
@@ -5337,6 +5451,19 @@ function managementPairArgs(pairs2) {
   }
   return args;
 }
+function appendFlowStatePolicy(args, policy) {
+  if (isFlowStatePolicy(policy)) {
+    appendPolicyMode(args, "state", policy.mode);
+    if (policy.retry != null) {
+      appendRetryPolicy(args, policy.retry);
+    }
+    return;
+  }
+  appendRetryPolicy(args, policy);
+}
+function isFlowStatePolicy(policy) {
+  return typeof policy === "object" && policy != null && ("mode" in policy || "retry" in policy);
+}
 function ruleArgs(rules) {
   return typeof rules === "string" ? [rules] : [...rules];
 }
@@ -5429,6 +5556,24 @@ function appendRetryPolicy(args, policy) {
   append(args, "JITTER_PCT", policy.jitterPct);
   append(args, "EXHAUSTED_TO", policy.exhaustedTo);
 }
+function appendPolicyMode(args, state, mode) {
+  if (mode == null) {
+    return;
+  }
+  if (state == null) {
+    throw new Error("policy mode requires state");
+  }
+  switch (mode) {
+    case "fifo":
+      args.push("MODE", "FIFO");
+      return;
+    case "parallel":
+      args.push("MODE", "PARALLEL");
+      return;
+    default:
+      throw new Error("policy mode must be 'fifo' or 'parallel'");
+  }
+}
 function appendPayloadRead(args, payload, maxBytes) {
   if (payload === false) {
     args.push("NOPAYLOAD");
@@ -5893,6 +6038,7 @@ var Workflow = class {
       exceptionPolicy: normalizeExceptionPolicy(options.exceptionPolicy),
       handler,
       leaseMs: options.leaseMs ?? 3e4,
+      ...options.mode == null ? {} : { mode: normalizeStateMode(options.mode) },
       name,
       returnRecord: options.returnRecord ?? false,
       valueMaxBytes: options.valueMaxBytes ?? this.valueConfig.valueMaxBytes,
@@ -5927,6 +6073,21 @@ var Workflow = class {
   worker(options = {}) {
     return new WorkflowWorker(this, options);
   }
+  async installPolicy(options = {}) {
+    const states = {};
+    for (const registration of this.states.values()) {
+      if (registration.mode != null || registration.retryPolicy != null) {
+        states[registration.name] = {
+          ...registration.mode == null ? {} : { mode: registration.mode },
+          ...registration.retryPolicy == null ? {} : { retry: registration.retryPolicy }
+        };
+      }
+    }
+    return await this.client.installPolicy(this.type, {
+      ...options,
+      states
+    });
+  }
   stateNames() {
     return [...this.states.keys()];
   }
@@ -6187,13 +6348,15 @@ var WorkflowWorker = class {
   }
   async applyJob(job, registration) {
     const ctx = new WorkflowContext(this.workflow, job, registration.name);
+    let outcome;
     try {
       const value = await registration.handler(ctx);
-      const outcome = isOutcome(value) ? value : complete({ result: value });
-      await applyOutcome(this.workflow.client, ctx, outcome, registration.returnRecord);
+      outcome = isOutcome(value) ? value : complete({ result: value });
     } catch (error) {
       await this.applyHandlerError(ctx, registration, error);
+      return;
     }
+    await applyOutcome(this.workflow.client, ctx, outcome, registration.returnRecord);
   }
   async applyHandlerError(ctx, registration, error) {
     const policy = this.options.exceptionPolicy ?? registration.exceptionPolicy;
@@ -6224,6 +6387,7 @@ async function applyOutcome(client, ctx, outcome, returnRecord) {
   }
 }
 async function applyTransition(client, ctx, outcome, returnRecord) {
+  validateTransitionPolicy(ctx, outcome);
   await client.transition(ctx.id, {
     dropValues: outcome.dropValues,
     fencingToken: ctx.fencingToken,
@@ -6241,6 +6405,12 @@ async function applyTransition(client, ctx, outcome, returnRecord) {
     values: outcome.values
   });
 }
+function validateTransitionPolicy(ctx, outcome) {
+  const target = ctx.workflow.stateRegistration(outcome.toState);
+  if (target?.mode === "fifo" && outcome.priority != null) {
+    throw new Error("priority is not supported for fifo state");
+  }
+}
 async function applyComplete(client, ctx, outcome, returnRecord) {
   await client.complete(ctx.id, {
     dropValues: outcome.dropValues,
@@ -6299,6 +6469,12 @@ function errorToPayload(error) {
   }
   return error;
 }
+function normalizeStateMode(mode) {
+  if (mode === "fifo" || mode === "parallel") {
+    return mode;
+  }
+  throw new Error("state mode must be 'fifo' or 'parallel'");
+}
 function valueRefToString(value) {
   if (typeof value === "string") {
     return value;