@ferricstore/ferricstore 0.11.10 → 0.12.0

package/dist/index.d.cts

@@ -1,5 +1,8 @@
 import { ConnectionOptions } from 'node:tls';
+import { C as CommandArgument, a as Command } from './internal-lEEDZpPH.cjs';
 import { Buffer as Buffer$1 } from 'node:buffer';
+import { F as FencingToken, S as StateMeta, a as FlowRecord, C as ClaimedItem, M as MaxActiveMs, R as RateLimitResult, K as KeyInfo, b as FetchOrComputeResult, c as ChildSpec, d as FencedItem, e as CreateItem, O as Outcome } from './outcomes-DmBwnq0Y.cjs';
+export { f as CompleteOutcome, g as FailOutcome, h as FetchOrComputeComputeResult, i as FetchOrComputeFencedResult, j as FetchOrComputeHitResult, k as FlowMaxActiveFailure, N as NamedValueMutation, l as RetryOutcome, m as StateMetaValue, T as TransitionOutcome, n as complete, o as fail, p as isOutcome, r as retry, t as transition } from './outcomes-DmBwnq0Y.cjs';
 
 declare class FerricStoreError extends Error {
     readonly code: string;
@@ -100,9 +103,6 @@ declare class JsonCodec<T = unknown> implements Codec<T> {
     decode(value: Buffer | null | undefined): T | null;
 }
 
-type CommandArgument = string | Buffer | number | bigint | boolean | readonly CommandArgument[] | Record<string, unknown> | null | undefined;
-type Command = readonly CommandArgument[];
-
 interface ExecutePipelineOptions {
     /** @internal Earlier command indexes that must settle before each individual fallback command starts. */
     fallbackDependencies?: readonly (readonly number[])[];
@@ -603,122 +603,6 @@ interface WorkerConfig {
     worker?: string;
 }
 
-type MaxActiveMs = number | "infinity";
-/** An exact Flow fencing token; bigint is used beyond JavaScript's safe integer range. */
-type FencingToken = number | bigint;
-interface ChildSpec {
-    id: string;
-    type: string;
-    payload?: unknown;
-    partitionKey?: string;
-    values?: Record<string, unknown>;
-    valueRefs?: Record<string, string>;
-}
-type StateMetaValue = string | number | boolean | Buffer;
-type StateMeta = Record<string, StateMetaValue>;
-interface CreateItem {
-    id: string;
-    payload?: unknown;
-    partitionKey?: string;
-    attributes?: Record<string, CommandArgument>;
-    values?: Record<string, unknown>;
-    valueRefs?: Record<string, string>;
-    stateMeta?: StateMeta;
-}
-/** @internal */
-declare const CLAIMED_ITEM_WIRE: unique symbol;
-/** @internal */
-interface ClaimedItemWire {
-    id: Buffer;
-    partitionKey?: Buffer | null;
-    leaseToken: Buffer;
-    fencingToken: FencingToken;
-}
-interface ClaimedItem<TPayload = unknown> {
-    id: string;
-    leaseToken: Buffer;
-    fencingToken: FencingToken;
-    partitionKey?: string;
-    /** Present when supplied by a full response or known compact-claim context. */
-    type?: string;
-    state: string;
-    runState?: string;
-    payload?: TPayload | null;
-    attributes?: Record<string, unknown>;
-    /** @internal */
-    [CLAIMED_ITEM_WIRE]?: ClaimedItemWire;
-}
-interface FencedItem {
-    id: string;
-    fencingToken: FencingToken;
-    leaseToken?: Buffer;
-    partitionKey?: string;
-}
-interface RateLimitResult {
-    status: string;
-    count: number;
-    remaining: number;
-    resetMs: number;
-    allowed: boolean;
-}
-interface KeyInfo {
-    type: string;
-    valueSize: number;
-    ttlMs: number;
-    hotCacheStatus: string;
-    lastWriteShard: number;
-    raw: Record<string, unknown>;
-}
-interface FetchOrComputeHitResult<T = unknown> {
-    readonly computeMode: "hit";
-    readonly hit: true;
-    readonly shouldCompute: false;
-    readonly status: "hit";
-    readonly value: T | null;
-}
-interface FetchOrComputeComputeResult {
-    /** Opaque application hint echoed for the process elected to compute. */
-    readonly computeHint: Buffer;
-    readonly computeMode: "fenced";
-    /** Fencing token required when publishing the computed result or error. */
-    readonly computeToken: Buffer;
-    readonly hit: false;
-    readonly shouldCompute: true;
-    readonly status: "compute";
-}
-type FetchOrComputeFencedResult = FetchOrComputeComputeResult;
-type FetchOrComputeResult<T = unknown> = FetchOrComputeHitResult<T> | FetchOrComputeComputeResult;
-interface FlowMaxActiveFailure {
-    readonly maxActiveMs: number;
-    readonly reason: "max_active_ms";
-}
-interface FlowRecord<TPayload = unknown> {
-    id: string;
-    type: string;
-    state: string;
-    partitionKey: string;
-    runState?: string;
-    payload?: TPayload | null;
-    leaseToken: Buffer;
-    fencingToken: FencingToken;
-    version: number;
-    parentFlowId?: string;
-    rootFlowId?: string;
-    correlationId?: string;
-    maxActiveMs?: number;
-    error?: unknown;
-    failureReason?: string;
-    valueRefs?: Record<string, unknown>;
-    values?: Record<string, unknown>;
-    valueSizes?: Record<string, unknown>;
-    valueOmitted?: Record<string, unknown>;
-    valueMissing?: Record<string, unknown>;
-    attributes?: Record<string, unknown>;
-    stateMeta?: Record<string, unknown>;
-    indexedStateMeta?: string;
-    raw?: unknown;
-}
-
 type FlowAdminRecord = Record<string, unknown>;
 /** Bounded interval recovery; missed occurrences are coalesced into one fire. */
 type ScheduleCatchupPolicy = "fire_once";
@@ -2430,47 +2314,6 @@ declare const FlowProjection: Readonly<{
 }>;
 declare function projectFlowQuery(query: string, shape: FlowProjectionShape, ...fields: readonly FlowProjectionField[]): string;
 
-type Outcome = TransitionOutcome | CompleteOutcome | RetryOutcome | FailOutcome;
-interface NamedValueMutation {
-    values?: Record<string, unknown>;
-    valueRefs?: Record<string, string>;
-    dropValues?: string[];
-    overrideValues?: string[];
-    attributesMerge?: Record<string, CommandArgument>;
-    attributesDelete?: string[];
-    stateMeta?: StateMeta;
-}
-interface TransitionOutcome extends NamedValueMutation {
-    readonly kind: "transition";
-    readonly toState: string;
-    readonly payload?: unknown;
-    readonly priority?: number;
-    readonly runAtMs?: number;
-}
-interface CompleteOutcome extends NamedValueMutation {
-    readonly kind: "complete";
-    readonly payload?: unknown;
-    readonly result?: unknown;
-    readonly ttlMs?: number;
-}
-interface RetryOutcome extends NamedValueMutation {
-    readonly kind: "retry";
-    readonly error?: unknown;
-    readonly payload?: unknown;
-    readonly runAtMs?: number;
-}
-interface FailOutcome extends NamedValueMutation {
-    readonly kind: "fail";
-    readonly error?: unknown;
-    readonly payload?: unknown;
-    readonly ttlMs?: number;
-}
-declare function transition(toState: string, options?: Omit<TransitionOutcome, "kind" | "toState">): TransitionOutcome;
-declare function complete(options?: Omit<CompleteOutcome, "kind">): CompleteOutcome;
-declare function retry(options?: Omit<RetryOutcome, "kind">): RetryOutcome;
-declare function fail(options?: Omit<FailOutcome, "kind">): FailOutcome;
-declare function isOutcome(value: unknown): value is Outcome;
-
 /** Raised when a worker loses the ability to renew a claimed job's lease. */
 declare class LeaseRenewalError extends Error {
     constructor(cause: unknown);
@@ -2756,7 +2599,7 @@ declare class WorkflowWorker {
 }
 
 /** TypeScript SDK package version. */
-declare const FERRICSTORE_SDK_VERSION = "0.11.10";
+declare const FERRICSTORE_SDK_VERSION = "0.12.0";
 /** Oldest FerricStore server supported by this breaking beta contract. */
 declare const FERRICSTORE_MINIMUM_SERVER_VERSION = "0.11.4";
 /** Native framing and opcode ABI version; unchanged by FerricStore 0.11. */
@@ -2765,4 +2608,4 @@ declare const FERRICSTORE_NATIVE_PROTOCOL_VERSION = 1;
 /** @deprecated Use RequestDisposition; retained for source compatibility. */
 type ConnectionRequestDisposition = RequestDisposition;
 
-export { type AdminListOptions, type ApprovalListOptions, type ApprovalRequestOptions, type AttributeQueryOptions, type AutoBatchOptions, type BackoffKind, type BackpressurePolicy, BitmapStore, BloomFilterStore, type BudgetCommitOptions, type BudgetReserveOptions, COMMAND_OPCODES, type CancelOptions, type ChildSpec, type CircuitOpenOptions, type ClaimDueOptions, ClaimHydrationError, type ClaimHydrationItem, type ClaimedItem, type Codec, type CollectionScanOptions, type Command, type CommandArgument, type CommandExecutor, type CompleteJobsAndClaimJobsResult, type CompleteManyOptions, type CompleteOptions, type CompleteOutcome, ConnectionClosedError, type ConnectionRequestDisposition, type CountMinMergeOptions, CountMinSketchStore, type CreateItem, type CreateManyOptions, type CreateOptions, CuckooFilterStore, type EffectCompensateOptions, type EffectConfirmOptions, type EffectFailOptions, type EffectReserveOptions, type EffectStatusOptions, type EndpointPolicy, type ExceptionPolicy, type ExecutePipelineOptions, type ExpiryCondition, type ExtendLeaseOptions, FERRICSTORE_MINIMUM_SERVER_VERSION, FERRICSTORE_NATIVE_PROTOCOL_VERSION, FERRICSTORE_SDK_VERSION, type FailOptions, type FailOutcome, type FencedItem, type FencingToken, FerricStoreClient, type FerricStoreClientFromUrlOptions, type FerricStoreClientOptions, FerricStoreError, type FetchOrComputeComputeResult, type FetchOrComputeFencedResult, type FetchOrComputeHitResult, type FetchOrComputeResult, type FlowAdminRecord, FlowAlreadyExistsError, type FlowBatchCompletedItem, FlowBatchError, type FlowEventProjectionField, type FlowExplainCapabilities, type FlowExplainResult, type FlowMaxActiveFailure, FlowNotFoundError, type FlowPolicyBackoffKind, type FlowPolicyBackoffSnapshot, type FlowPolicyOptions, type FlowPolicyRetentionSnapshot, type FlowPolicyRetrySnapshot, type FlowPolicySnapshot, type FlowPolicyStateSnapshot, FlowProjection, type FlowProjectionField, type FlowProjectionShape, type FlowQueryCountResult, FlowQueryError, type FlowQueryErrorPosition, type FlowQueryIndex, type FlowQueryIndexBuild, type FlowQueryIndexCoverage, type FlowQueryIndexField, type FlowQueryIndexFormat, type FlowQueryIndexProgress, type FlowQueryIndexRegistry, type FlowQueryIndexRetirement, type FlowQueryIndexServiceState, type FlowQueryIndexServices, type FlowQueryIndexStatistics, type FlowQueryIndexStatus, type FlowQueryIndexValidation, type FlowQueryInteger, type FlowQueryPage, type FlowQueryParameter, type FlowQueryParameters, type FlowQueryQuality, type FlowQueryRecord, type FlowQueryRecordsResult, type FlowQueryResult, type FlowQueryUsage, type FlowRecord, type FlowRunProjectionField, type FlowStateMode, type FlowStatePolicy, type FlowStatePolicyLike, type FlowStatsOptions, FlowWrongStateError, type GeoAddOptions, type GeoMember, GeoStore, type GetExOptions, type GovernanceLedgerOptions, HTTPAdapter, type HTTPAdapterOptions, type HTTPCommandDisposition, HTTPTransportError, type HashScanResult, HashStore, type HistoryOptions, HyperLogLogStore, type IntegerReply, InvalidCommandError, type InvocationCreateOptions, JsonCodec, type KeyInfo, KeyValueStore, type LeaseMutationOptions, LeaseRenewalError, type LimitAmountOptions, type LimitLeaseOptions, type LimitListOptions, type LimitReleaseOptions, ListStore, LockHeldError, LockNotOwnedError, MAX_FLOW_POLICY_GENERATION, type ManagementPairs, type MaxActiveMs, type MutateOptions, type NamedValueMutation, NativeAdapter, type NativeAdapterOptions, type NativeClientOptions, type NativeProtocolEvent, type Outcome, OverloadedError, type ProtocolCommand, Queue, type QueueBatchHandler, QueueClient, QueueCompletionError, 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 RequestDisposition, RequestTimeoutError, RerouteError, type RetryOptions, type RetryOutcome, type RetryPolicy, type RoutingEndpoint, type RoutingRoute, RoutingTopology, type RunStepsItem, type RunStepsManyOptions, type ScanOptions, type ScheduleCatchupPolicy, type ScheduleFireDueOptions, type ScheduleFireDueResult, type ScheduleFireOptions, type ScheduleFireResult, type ScheduleKind, type ScheduleListOptions, type ScheduleOptions, type ScheduleOverlapPolicy, type ScheduleRecord, type ScheduleState, type SearchOptions, type SearchStateMeta, type SetOptions, type SetScanResult, SetStore, type SortedSetScanResult, SortedSetStore, StaleLeaseError, StalePolicyGenerationError, type StartAndClaimOptions, type StateMeta, type StateMetaValue, type StateOptions, type StateRegistration, type StepContinueOptions, type StoreCommandClient, StreamStore, type TDigestCreateOptions, type TDigestMergeOptions, TDigestStore, type TopKReserveOptions, TopKStore, type TopologyNativeAdapterOptions, TopologyNativeAdapterPool, type TransitionOptions, type TransitionOutcome, type ValueConfig, type WorkerConfig, type WorkerProfile, type WorkerRefillStrategy, Workflow, WorkflowClient, WorkflowContext, WorkflowFlowCommands, type WorkflowHandler, type WorkflowOptions, WorkflowWorker, type WorkflowWorkerResult, type XReadStream, type ZAddMember, type ZAddOptions, classifyServerError, complete, fail, httpCommandDisposition, isOutcome, isReconnectableClosedConnectionError, mapException, projectFlowQuery, retry, transition };
+export { type AdminListOptions, type ApprovalListOptions, type ApprovalRequestOptions, type AttributeQueryOptions, type AutoBatchOptions, type BackoffKind, type BackpressurePolicy, BitmapStore, BloomFilterStore, type BudgetCommitOptions, type BudgetReserveOptions, COMMAND_OPCODES, type CancelOptions, ChildSpec, type CircuitOpenOptions, type ClaimDueOptions, ClaimHydrationError, type ClaimHydrationItem, ClaimedItem, type Codec, type CollectionScanOptions, Command, CommandArgument, type CommandExecutor, type CompleteJobsAndClaimJobsResult, type CompleteManyOptions, type CompleteOptions, ConnectionClosedError, type ConnectionRequestDisposition, type CountMinMergeOptions, CountMinSketchStore, CreateItem, type CreateManyOptions, type CreateOptions, CuckooFilterStore, type EffectCompensateOptions, type EffectConfirmOptions, type EffectFailOptions, type EffectReserveOptions, type EffectStatusOptions, type EndpointPolicy, type ExceptionPolicy, type ExecutePipelineOptions, type ExpiryCondition, type ExtendLeaseOptions, FERRICSTORE_MINIMUM_SERVER_VERSION, FERRICSTORE_NATIVE_PROTOCOL_VERSION, FERRICSTORE_SDK_VERSION, type FailOptions, FencedItem, FencingToken, FerricStoreClient, type FerricStoreClientFromUrlOptions, type FerricStoreClientOptions, FerricStoreError, FetchOrComputeResult, type FlowAdminRecord, FlowAlreadyExistsError, type FlowBatchCompletedItem, FlowBatchError, type FlowEventProjectionField, type FlowExplainCapabilities, type FlowExplainResult, FlowNotFoundError, type FlowPolicyBackoffKind, type FlowPolicyBackoffSnapshot, type FlowPolicyOptions, type FlowPolicyRetentionSnapshot, type FlowPolicyRetrySnapshot, type FlowPolicySnapshot, type FlowPolicyStateSnapshot, FlowProjection, type FlowProjectionField, type FlowProjectionShape, type FlowQueryCountResult, FlowQueryError, type FlowQueryErrorPosition, type FlowQueryIndex, type FlowQueryIndexBuild, type FlowQueryIndexCoverage, type FlowQueryIndexField, type FlowQueryIndexFormat, type FlowQueryIndexProgress, type FlowQueryIndexRegistry, type FlowQueryIndexRetirement, type FlowQueryIndexServiceState, type FlowQueryIndexServices, type FlowQueryIndexStatistics, type FlowQueryIndexStatus, type FlowQueryIndexValidation, type FlowQueryInteger, type FlowQueryPage, type FlowQueryParameter, type FlowQueryParameters, type FlowQueryQuality, type FlowQueryRecord, type FlowQueryRecordsResult, type FlowQueryResult, type FlowQueryUsage, FlowRecord, type FlowRunProjectionField, type FlowStateMode, type FlowStatePolicy, type FlowStatePolicyLike, type FlowStatsOptions, FlowWrongStateError, type GeoAddOptions, type GeoMember, GeoStore, type GetExOptions, type GovernanceLedgerOptions, HTTPAdapter, type HTTPAdapterOptions, type HTTPCommandDisposition, HTTPTransportError, type HashScanResult, HashStore, type HistoryOptions, HyperLogLogStore, type IntegerReply, InvalidCommandError, type InvocationCreateOptions, JsonCodec, KeyInfo, KeyValueStore, type LeaseMutationOptions, LeaseRenewalError, type LimitAmountOptions, type LimitLeaseOptions, type LimitListOptions, type LimitReleaseOptions, ListStore, LockHeldError, LockNotOwnedError, MAX_FLOW_POLICY_GENERATION, type ManagementPairs, MaxActiveMs, type MutateOptions, NativeAdapter, type NativeAdapterOptions, type NativeClientOptions, type NativeProtocolEvent, Outcome, OverloadedError, type ProtocolCommand, Queue, type QueueBatchHandler, QueueClient, QueueCompletionError, type QueueHandler, type QueueJob, type QueueOptions, QueueWorker, type QueueWorkerResult, type RangeLimit, RateLimitResult, RawCodec, type ReadOptions, type ReclaimOptions, type ReconnectOptions, ReconnectingExecutor, type RequestContext, type RequestContextOptions, type RequestDisposition, RequestTimeoutError, RerouteError, type RetryOptions, type RetryPolicy, type RoutingEndpoint, type RoutingRoute, RoutingTopology, type RunStepsItem, type RunStepsManyOptions, type ScanOptions, type ScheduleCatchupPolicy, type ScheduleFireDueOptions, type ScheduleFireDueResult, type ScheduleFireOptions, type ScheduleFireResult, type ScheduleKind, type ScheduleListOptions, type ScheduleOptions, type ScheduleOverlapPolicy, type ScheduleRecord, type ScheduleState, type SearchOptions, type SearchStateMeta, type SetOptions, type SetScanResult, SetStore, type SortedSetScanResult, SortedSetStore, StaleLeaseError, StalePolicyGenerationError, type StartAndClaimOptions, StateMeta, type StateOptions, type StateRegistration, type StepContinueOptions, type StoreCommandClient, StreamStore, type TDigestCreateOptions, type TDigestMergeOptions, TDigestStore, type TopKReserveOptions, TopKStore, type TopologyNativeAdapterOptions, TopologyNativeAdapterPool, type TransitionOptions, type ValueConfig, type WorkerConfig, type WorkerProfile, type WorkerRefillStrategy, Workflow, WorkflowClient, WorkflowContext, WorkflowFlowCommands, type WorkflowHandler, type WorkflowOptions, WorkflowWorker, type WorkflowWorkerResult, type XReadStream, type ZAddMember, type ZAddOptions, classifyServerError, httpCommandDisposition, isReconnectableClosedConnectionError, mapException, projectFlowQuery };

package/dist/index.d.ts

@@ -1,5 +1,8 @@
 import { ConnectionOptions } from 'node:tls';
+import { C as CommandArgument, a as Command } from './internal-lEEDZpPH.js';
 import { Buffer as Buffer$1 } from 'node:buffer';
+import { F as FencingToken, S as StateMeta, a as FlowRecord, C as ClaimedItem, M as MaxActiveMs, R as RateLimitResult, K as KeyInfo, b as FetchOrComputeResult, c as ChildSpec, d as FencedItem, e as CreateItem, O as Outcome } from './outcomes-BbFDp3AH.js';
+export { f as CompleteOutcome, g as FailOutcome, h as FetchOrComputeComputeResult, i as FetchOrComputeFencedResult, j as FetchOrComputeHitResult, k as FlowMaxActiveFailure, N as NamedValueMutation, l as RetryOutcome, m as StateMetaValue, T as TransitionOutcome, n as complete, o as fail, p as isOutcome, r as retry, t as transition } from './outcomes-BbFDp3AH.js';
 
 declare class FerricStoreError extends Error {
     readonly code: string;
@@ -100,9 +103,6 @@ declare class JsonCodec<T = unknown> implements Codec<T> {
     decode(value: Buffer | null | undefined): T | null;
 }
 
-type CommandArgument = string | Buffer | number | bigint | boolean | readonly CommandArgument[] | Record<string, unknown> | null | undefined;
-type Command = readonly CommandArgument[];
-
 interface ExecutePipelineOptions {
     /** @internal Earlier command indexes that must settle before each individual fallback command starts. */
     fallbackDependencies?: readonly (readonly number[])[];
@@ -603,122 +603,6 @@ interface WorkerConfig {
     worker?: string;
 }
 
-type MaxActiveMs = number | "infinity";
-/** An exact Flow fencing token; bigint is used beyond JavaScript's safe integer range. */
-type FencingToken = number | bigint;
-interface ChildSpec {
-    id: string;
-    type: string;
-    payload?: unknown;
-    partitionKey?: string;
-    values?: Record<string, unknown>;
-    valueRefs?: Record<string, string>;
-}
-type StateMetaValue = string | number | boolean | Buffer;
-type StateMeta = Record<string, StateMetaValue>;
-interface CreateItem {
-    id: string;
-    payload?: unknown;
-    partitionKey?: string;
-    attributes?: Record<string, CommandArgument>;
-    values?: Record<string, unknown>;
-    valueRefs?: Record<string, string>;
-    stateMeta?: StateMeta;
-}
-/** @internal */
-declare const CLAIMED_ITEM_WIRE: unique symbol;
-/** @internal */
-interface ClaimedItemWire {
-    id: Buffer;
-    partitionKey?: Buffer | null;
-    leaseToken: Buffer;
-    fencingToken: FencingToken;
-}
-interface ClaimedItem<TPayload = unknown> {
-    id: string;
-    leaseToken: Buffer;
-    fencingToken: FencingToken;
-    partitionKey?: string;
-    /** Present when supplied by a full response or known compact-claim context. */
-    type?: string;
-    state: string;
-    runState?: string;
-    payload?: TPayload | null;
-    attributes?: Record<string, unknown>;
-    /** @internal */
-    [CLAIMED_ITEM_WIRE]?: ClaimedItemWire;
-}
-interface FencedItem {
-    id: string;
-    fencingToken: FencingToken;
-    leaseToken?: Buffer;
-    partitionKey?: string;
-}
-interface RateLimitResult {
-    status: string;
-    count: number;
-    remaining: number;
-    resetMs: number;
-    allowed: boolean;
-}
-interface KeyInfo {
-    type: string;
-    valueSize: number;
-    ttlMs: number;
-    hotCacheStatus: string;
-    lastWriteShard: number;
-    raw: Record<string, unknown>;
-}
-interface FetchOrComputeHitResult<T = unknown> {
-    readonly computeMode: "hit";
-    readonly hit: true;
-    readonly shouldCompute: false;
-    readonly status: "hit";
-    readonly value: T | null;
-}
-interface FetchOrComputeComputeResult {
-    /** Opaque application hint echoed for the process elected to compute. */
-    readonly computeHint: Buffer;
-    readonly computeMode: "fenced";
-    /** Fencing token required when publishing the computed result or error. */
-    readonly computeToken: Buffer;
-    readonly hit: false;
-    readonly shouldCompute: true;
-    readonly status: "compute";
-}
-type FetchOrComputeFencedResult = FetchOrComputeComputeResult;
-type FetchOrComputeResult<T = unknown> = FetchOrComputeHitResult<T> | FetchOrComputeComputeResult;
-interface FlowMaxActiveFailure {
-    readonly maxActiveMs: number;
-    readonly reason: "max_active_ms";
-}
-interface FlowRecord<TPayload = unknown> {
-    id: string;
-    type: string;
-    state: string;
-    partitionKey: string;
-    runState?: string;
-    payload?: TPayload | null;
-    leaseToken: Buffer;
-    fencingToken: FencingToken;
-    version: number;
-    parentFlowId?: string;
-    rootFlowId?: string;
-    correlationId?: string;
-    maxActiveMs?: number;
-    error?: unknown;
-    failureReason?: string;
-    valueRefs?: Record<string, unknown>;
-    values?: Record<string, unknown>;
-    valueSizes?: Record<string, unknown>;
-    valueOmitted?: Record<string, unknown>;
-    valueMissing?: Record<string, unknown>;
-    attributes?: Record<string, unknown>;
-    stateMeta?: Record<string, unknown>;
-    indexedStateMeta?: string;
-    raw?: unknown;
-}
-
 type FlowAdminRecord = Record<string, unknown>;
 /** Bounded interval recovery; missed occurrences are coalesced into one fire. */
 type ScheduleCatchupPolicy = "fire_once";
@@ -2430,47 +2314,6 @@ declare const FlowProjection: Readonly<{
 }>;
 declare function projectFlowQuery(query: string, shape: FlowProjectionShape, ...fields: readonly FlowProjectionField[]): string;
 
-type Outcome = TransitionOutcome | CompleteOutcome | RetryOutcome | FailOutcome;
-interface NamedValueMutation {
-    values?: Record<string, unknown>;
-    valueRefs?: Record<string, string>;
-    dropValues?: string[];
-    overrideValues?: string[];
-    attributesMerge?: Record<string, CommandArgument>;
-    attributesDelete?: string[];
-    stateMeta?: StateMeta;
-}
-interface TransitionOutcome extends NamedValueMutation {
-    readonly kind: "transition";
-    readonly toState: string;
-    readonly payload?: unknown;
-    readonly priority?: number;
-    readonly runAtMs?: number;
-}
-interface CompleteOutcome extends NamedValueMutation {
-    readonly kind: "complete";
-    readonly payload?: unknown;
-    readonly result?: unknown;
-    readonly ttlMs?: number;
-}
-interface RetryOutcome extends NamedValueMutation {
-    readonly kind: "retry";
-    readonly error?: unknown;
-    readonly payload?: unknown;
-    readonly runAtMs?: number;
-}
-interface FailOutcome extends NamedValueMutation {
-    readonly kind: "fail";
-    readonly error?: unknown;
-    readonly payload?: unknown;
-    readonly ttlMs?: number;
-}
-declare function transition(toState: string, options?: Omit<TransitionOutcome, "kind" | "toState">): TransitionOutcome;
-declare function complete(options?: Omit<CompleteOutcome, "kind">): CompleteOutcome;
-declare function retry(options?: Omit<RetryOutcome, "kind">): RetryOutcome;
-declare function fail(options?: Omit<FailOutcome, "kind">): FailOutcome;
-declare function isOutcome(value: unknown): value is Outcome;
-
 /** Raised when a worker loses the ability to renew a claimed job's lease. */
 declare class LeaseRenewalError extends Error {
     constructor(cause: unknown);
@@ -2756,7 +2599,7 @@ declare class WorkflowWorker {
 }
 
 /** TypeScript SDK package version. */
-declare const FERRICSTORE_SDK_VERSION = "0.11.10";
+declare const FERRICSTORE_SDK_VERSION = "0.12.0";
 /** Oldest FerricStore server supported by this breaking beta contract. */
 declare const FERRICSTORE_MINIMUM_SERVER_VERSION = "0.11.4";
 /** Native framing and opcode ABI version; unchanged by FerricStore 0.11. */
@@ -2765,4 +2608,4 @@ declare const FERRICSTORE_NATIVE_PROTOCOL_VERSION = 1;
 /** @deprecated Use RequestDisposition; retained for source compatibility. */
 type ConnectionRequestDisposition = RequestDisposition;
 
-export { type AdminListOptions, type ApprovalListOptions, type ApprovalRequestOptions, type AttributeQueryOptions, type AutoBatchOptions, type BackoffKind, type BackpressurePolicy, BitmapStore, BloomFilterStore, type BudgetCommitOptions, type BudgetReserveOptions, COMMAND_OPCODES, type CancelOptions, type ChildSpec, type CircuitOpenOptions, type ClaimDueOptions, ClaimHydrationError, type ClaimHydrationItem, type ClaimedItem, type Codec, type CollectionScanOptions, type Command, type CommandArgument, type CommandExecutor, type CompleteJobsAndClaimJobsResult, type CompleteManyOptions, type CompleteOptions, type CompleteOutcome, ConnectionClosedError, type ConnectionRequestDisposition, type CountMinMergeOptions, CountMinSketchStore, type CreateItem, type CreateManyOptions, type CreateOptions, CuckooFilterStore, type EffectCompensateOptions, type EffectConfirmOptions, type EffectFailOptions, type EffectReserveOptions, type EffectStatusOptions, type EndpointPolicy, type ExceptionPolicy, type ExecutePipelineOptions, type ExpiryCondition, type ExtendLeaseOptions, FERRICSTORE_MINIMUM_SERVER_VERSION, FERRICSTORE_NATIVE_PROTOCOL_VERSION, FERRICSTORE_SDK_VERSION, type FailOptions, type FailOutcome, type FencedItem, type FencingToken, FerricStoreClient, type FerricStoreClientFromUrlOptions, type FerricStoreClientOptions, FerricStoreError, type FetchOrComputeComputeResult, type FetchOrComputeFencedResult, type FetchOrComputeHitResult, type FetchOrComputeResult, type FlowAdminRecord, FlowAlreadyExistsError, type FlowBatchCompletedItem, FlowBatchError, type FlowEventProjectionField, type FlowExplainCapabilities, type FlowExplainResult, type FlowMaxActiveFailure, FlowNotFoundError, type FlowPolicyBackoffKind, type FlowPolicyBackoffSnapshot, type FlowPolicyOptions, type FlowPolicyRetentionSnapshot, type FlowPolicyRetrySnapshot, type FlowPolicySnapshot, type FlowPolicyStateSnapshot, FlowProjection, type FlowProjectionField, type FlowProjectionShape, type FlowQueryCountResult, FlowQueryError, type FlowQueryErrorPosition, type FlowQueryIndex, type FlowQueryIndexBuild, type FlowQueryIndexCoverage, type FlowQueryIndexField, type FlowQueryIndexFormat, type FlowQueryIndexProgress, type FlowQueryIndexRegistry, type FlowQueryIndexRetirement, type FlowQueryIndexServiceState, type FlowQueryIndexServices, type FlowQueryIndexStatistics, type FlowQueryIndexStatus, type FlowQueryIndexValidation, type FlowQueryInteger, type FlowQueryPage, type FlowQueryParameter, type FlowQueryParameters, type FlowQueryQuality, type FlowQueryRecord, type FlowQueryRecordsResult, type FlowQueryResult, type FlowQueryUsage, type FlowRecord, type FlowRunProjectionField, type FlowStateMode, type FlowStatePolicy, type FlowStatePolicyLike, type FlowStatsOptions, FlowWrongStateError, type GeoAddOptions, type GeoMember, GeoStore, type GetExOptions, type GovernanceLedgerOptions, HTTPAdapter, type HTTPAdapterOptions, type HTTPCommandDisposition, HTTPTransportError, type HashScanResult, HashStore, type HistoryOptions, HyperLogLogStore, type IntegerReply, InvalidCommandError, type InvocationCreateOptions, JsonCodec, type KeyInfo, KeyValueStore, type LeaseMutationOptions, LeaseRenewalError, type LimitAmountOptions, type LimitLeaseOptions, type LimitListOptions, type LimitReleaseOptions, ListStore, LockHeldError, LockNotOwnedError, MAX_FLOW_POLICY_GENERATION, type ManagementPairs, type MaxActiveMs, type MutateOptions, type NamedValueMutation, NativeAdapter, type NativeAdapterOptions, type NativeClientOptions, type NativeProtocolEvent, type Outcome, OverloadedError, type ProtocolCommand, Queue, type QueueBatchHandler, QueueClient, QueueCompletionError, 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 RequestDisposition, RequestTimeoutError, RerouteError, type RetryOptions, type RetryOutcome, type RetryPolicy, type RoutingEndpoint, type RoutingRoute, RoutingTopology, type RunStepsItem, type RunStepsManyOptions, type ScanOptions, type ScheduleCatchupPolicy, type ScheduleFireDueOptions, type ScheduleFireDueResult, type ScheduleFireOptions, type ScheduleFireResult, type ScheduleKind, type ScheduleListOptions, type ScheduleOptions, type ScheduleOverlapPolicy, type ScheduleRecord, type ScheduleState, type SearchOptions, type SearchStateMeta, type SetOptions, type SetScanResult, SetStore, type SortedSetScanResult, SortedSetStore, StaleLeaseError, StalePolicyGenerationError, type StartAndClaimOptions, type StateMeta, type StateMetaValue, type StateOptions, type StateRegistration, type StepContinueOptions, type StoreCommandClient, StreamStore, type TDigestCreateOptions, type TDigestMergeOptions, TDigestStore, type TopKReserveOptions, TopKStore, type TopologyNativeAdapterOptions, TopologyNativeAdapterPool, type TransitionOptions, type TransitionOutcome, type ValueConfig, type WorkerConfig, type WorkerProfile, type WorkerRefillStrategy, Workflow, WorkflowClient, WorkflowContext, WorkflowFlowCommands, type WorkflowHandler, type WorkflowOptions, WorkflowWorker, type WorkflowWorkerResult, type XReadStream, type ZAddMember, type ZAddOptions, classifyServerError, complete, fail, httpCommandDisposition, isOutcome, isReconnectableClosedConnectionError, mapException, projectFlowQuery, retry, transition };
+export { type AdminListOptions, type ApprovalListOptions, type ApprovalRequestOptions, type AttributeQueryOptions, type AutoBatchOptions, type BackoffKind, type BackpressurePolicy, BitmapStore, BloomFilterStore, type BudgetCommitOptions, type BudgetReserveOptions, COMMAND_OPCODES, type CancelOptions, ChildSpec, type CircuitOpenOptions, type ClaimDueOptions, ClaimHydrationError, type ClaimHydrationItem, ClaimedItem, type Codec, type CollectionScanOptions, Command, CommandArgument, type CommandExecutor, type CompleteJobsAndClaimJobsResult, type CompleteManyOptions, type CompleteOptions, ConnectionClosedError, type ConnectionRequestDisposition, type CountMinMergeOptions, CountMinSketchStore, CreateItem, type CreateManyOptions, type CreateOptions, CuckooFilterStore, type EffectCompensateOptions, type EffectConfirmOptions, type EffectFailOptions, type EffectReserveOptions, type EffectStatusOptions, type EndpointPolicy, type ExceptionPolicy, type ExecutePipelineOptions, type ExpiryCondition, type ExtendLeaseOptions, FERRICSTORE_MINIMUM_SERVER_VERSION, FERRICSTORE_NATIVE_PROTOCOL_VERSION, FERRICSTORE_SDK_VERSION, type FailOptions, FencedItem, FencingToken, FerricStoreClient, type FerricStoreClientFromUrlOptions, type FerricStoreClientOptions, FerricStoreError, FetchOrComputeResult, type FlowAdminRecord, FlowAlreadyExistsError, type FlowBatchCompletedItem, FlowBatchError, type FlowEventProjectionField, type FlowExplainCapabilities, type FlowExplainResult, FlowNotFoundError, type FlowPolicyBackoffKind, type FlowPolicyBackoffSnapshot, type FlowPolicyOptions, type FlowPolicyRetentionSnapshot, type FlowPolicyRetrySnapshot, type FlowPolicySnapshot, type FlowPolicyStateSnapshot, FlowProjection, type FlowProjectionField, type FlowProjectionShape, type FlowQueryCountResult, FlowQueryError, type FlowQueryErrorPosition, type FlowQueryIndex, type FlowQueryIndexBuild, type FlowQueryIndexCoverage, type FlowQueryIndexField, type FlowQueryIndexFormat, type FlowQueryIndexProgress, type FlowQueryIndexRegistry, type FlowQueryIndexRetirement, type FlowQueryIndexServiceState, type FlowQueryIndexServices, type FlowQueryIndexStatistics, type FlowQueryIndexStatus, type FlowQueryIndexValidation, type FlowQueryInteger, type FlowQueryPage, type FlowQueryParameter, type FlowQueryParameters, type FlowQueryQuality, type FlowQueryRecord, type FlowQueryRecordsResult, type FlowQueryResult, type FlowQueryUsage, FlowRecord, type FlowRunProjectionField, type FlowStateMode, type FlowStatePolicy, type FlowStatePolicyLike, type FlowStatsOptions, FlowWrongStateError, type GeoAddOptions, type GeoMember, GeoStore, type GetExOptions, type GovernanceLedgerOptions, HTTPAdapter, type HTTPAdapterOptions, type HTTPCommandDisposition, HTTPTransportError, type HashScanResult, HashStore, type HistoryOptions, HyperLogLogStore, type IntegerReply, InvalidCommandError, type InvocationCreateOptions, JsonCodec, KeyInfo, KeyValueStore, type LeaseMutationOptions, LeaseRenewalError, type LimitAmountOptions, type LimitLeaseOptions, type LimitListOptions, type LimitReleaseOptions, ListStore, LockHeldError, LockNotOwnedError, MAX_FLOW_POLICY_GENERATION, type ManagementPairs, MaxActiveMs, type MutateOptions, NativeAdapter, type NativeAdapterOptions, type NativeClientOptions, type NativeProtocolEvent, Outcome, OverloadedError, type ProtocolCommand, Queue, type QueueBatchHandler, QueueClient, QueueCompletionError, type QueueHandler, type QueueJob, type QueueOptions, QueueWorker, type QueueWorkerResult, type RangeLimit, RateLimitResult, RawCodec, type ReadOptions, type ReclaimOptions, type ReconnectOptions, ReconnectingExecutor, type RequestContext, type RequestContextOptions, type RequestDisposition, RequestTimeoutError, RerouteError, type RetryOptions, type RetryPolicy, type RoutingEndpoint, type RoutingRoute, RoutingTopology, type RunStepsItem, type RunStepsManyOptions, type ScanOptions, type ScheduleCatchupPolicy, type ScheduleFireDueOptions, type ScheduleFireDueResult, type ScheduleFireOptions, type ScheduleFireResult, type ScheduleKind, type ScheduleListOptions, type ScheduleOptions, type ScheduleOverlapPolicy, type ScheduleRecord, type ScheduleState, type SearchOptions, type SearchStateMeta, type SetOptions, type SetScanResult, SetStore, type SortedSetScanResult, SortedSetStore, StaleLeaseError, StalePolicyGenerationError, type StartAndClaimOptions, StateMeta, type StateOptions, type StateRegistration, type StepContinueOptions, type StoreCommandClient, StreamStore, type TDigestCreateOptions, type TDigestMergeOptions, TDigestStore, type TopKReserveOptions, TopKStore, type TopologyNativeAdapterOptions, TopologyNativeAdapterPool, type TransitionOptions, type ValueConfig, type WorkerConfig, type WorkerProfile, type WorkerRefillStrategy, Workflow, WorkflowClient, WorkflowContext, WorkflowFlowCommands, type WorkflowHandler, type WorkflowOptions, WorkflowWorker, type WorkflowWorkerResult, type XReadStream, type ZAddMember, type ZAddOptions, classifyServerError, httpCommandDisposition, isReconnectableClosedConnectionError, mapException, projectFlowQuery };

package/dist/index.js

@@ -8604,6 +8604,9 @@ var sessionOnlyCommands = /* @__PURE__ */ new Set([
   "CLIENT",
   "DISCARD",
   "EXEC",
+  "FETCH_OR_COMPUTE",
+  "FETCH_OR_COMPUTE_ERROR",
+  "FETCH_OR_COMPUTE_RESULT",
   "HELLO",
   "MONITOR",
   "MULTI",
@@ -8653,6 +8656,7 @@ var encoding = "ferricstore-json-v1";
 var bytesMarker = "$ferricstore_bytes";
 var mapMarker = "$ferricstore_map";
 var maxDepth = 64;
+var integerJSON = /^-?(?:0|[1-9][0-9]*)$/u;
 var bytesMarkerBaseBytes = Buffer34.byteLength(bytesMarker) + 7;
 var mapMarkerBaseBytes = Buffer34.byteLength(mapMarker) + 7;
 function encodeHTTPCommands(commands, maxBytes = Number.MAX_SAFE_INTEGER) {
@@ -8665,13 +8669,20 @@ function encodeHTTPCommands(commands, maxBytes = Number.MAX_SAFE_INTEGER) {
 function decodeHTTPEnvelope(source) {
   let parsed;
   try {
-    parsed = JSON.parse(source.toString("utf8"));
+    parsed = JSON.parse(source.toString("utf8"), preserveIntegerPrecision);
   } catch (error) {
     throw new TypeError("invalid HTTP command response JSON", { cause: error });
   }
   if (!isRecord(parsed)) throw new TypeError("HTTP command response must be an object");
   return decodePlainRecord(parsed, 0);
 }
+function preserveIntegerPrecision(_key, value, context) {
+  if (typeof value !== "number" || Number.isSafeInteger(value) || !Number.isInteger(value)) {
+    return value;
+  }
+  const literal = context?.source;
+  return literal != null && integerJSON.test(literal) ? BigInt(literal) : value;
+}
 function encodeValue(value, depth, budget) {
   if (depth > maxDepth) throw new TypeError("HTTP command value exceeds maximum depth");
   if (value == null) {
@@ -21267,7 +21278,7 @@ var WorkflowWorker = class {
 };
 
 // src/version.ts
-var FERRICSTORE_SDK_VERSION = "0.11.10";
+var FERRICSTORE_SDK_VERSION = "0.12.0";
 var FERRICSTORE_MINIMUM_SERVER_VERSION = "0.11.4";
 var FERRICSTORE_NATIVE_PROTOCOL_VERSION = 1;
 export {