@nice-code/action 0.18.0 → 0.19.0

package/README.md

@@ -499,6 +499,35 @@ const server = serveChannel(runtime, appChannel, {
 On the connector side, list several transports in `connectChannel`'s `transports` (preference order) to
 get automatic fallback across carriers (e.g. secure WS, then plain HTTP).
 
+### Gating a transport until a precondition holds — `available`
+
+A transport can declare an `available` predicate to opt **out** of selection until a runtime precondition
+is met. While it returns `false`, the manager treats that transport as `unsupported` and falls through to
+the next one in preference order — **without** opening its carrier or even computing its cache key. The
+predicate is re-evaluated per action dispatch, so the transport switches on the moment the precondition
+holds, with no reconnect.
+
+```ts
+// Prefer the secure socket, but only once a session id exists; fall back to HTTP meanwhile.
+const wsTransport = secureTransport({
+  channel, runtime, storageAdapter, securityLevel,
+  available: () => sessionId != null,
+  carrier: wsCarrier(`${url}/ws`, {
+    // Only ever called once `available` passes, so no need for a placeholder cache key.
+    getTransportCacheKey: () => [sessionId],
+  }),
+});
+
+connectChannel(runtime, serverCoord, {
+  transports: [wsTransport, httpTransport], // ws preferred; HTTP serves while ws is gated off
+});
+```
+
+Flipping `available` back to `false` only **skips selection** — it does not tear down a live carrier
+(socket closure stays owned by the carrier's own disconnect handling), and a still-cached connection is
+reused with no reconnect once it becomes available again. Omit `available` for an always-available
+transport (the default).
+
 ---
 
 ## React Query integration

package/build/{ActionDevtoolsCore-C5XrQI1K.d.mts → ActionDevtoolsCore-CCZXQBAo.d.cts}

@@ -1,4 +1,4 @@
-import { _ as TActionProgress, jr as IRuntimeCoordinate } from "./ActionPayload.types-BchJrBIX.mjs";
+import { Ir as IRuntimeCoordinate, _ as TActionProgress } from "./ActionPayload.types-CdHOGGZK.cjs";
 //#region ../nice-devtools-shared/src/components/PanelChrome.d.ts
 /** Where a devtools panel is docked. */
 type TDevtoolsPosition = "dock-bottom" | "dock-top" | "dock-left" | "dock-right";
@@ -76,4 +76,4 @@ declare class ActionDevtoolsCore {
 }
 //#endregion
 export { TDevtoolsActionStatus as a, IDevtoolsObservableDomain as i, IActionDevtoolsCoreOptions as n, TDevtoolsListener as o, IDevtoolsActionEntry as r, TDevtoolsPosition as s, ActionDevtoolsCore as t };
-//# sourceMappingURL=ActionDevtoolsCore-C5XrQI1K.d.mts.map
+//# sourceMappingURL=ActionDevtoolsCore-CCZXQBAo.d.cts.map

package/build/{ActionDevtoolsCore-Dd1qJAwK.d.cts → ActionDevtoolsCore-bjYQ8O2_.d.mts}

@@ -1,4 +1,4 @@
-import { _ as TActionProgress, jr as IRuntimeCoordinate } from "./ActionPayload.types-snDlSIF-.cjs";
+import { Ir as IRuntimeCoordinate, _ as TActionProgress } from "./ActionPayload.types-Bmkzw2df.mjs";
 //#region ../nice-devtools-shared/src/components/PanelChrome.d.ts
 /** Where a devtools panel is docked. */
 type TDevtoolsPosition = "dock-bottom" | "dock-top" | "dock-left" | "dock-right";
@@ -76,4 +76,4 @@ declare class ActionDevtoolsCore {
 }
 //#endregion
 export { TDevtoolsActionStatus as a, IDevtoolsObservableDomain as i, IActionDevtoolsCoreOptions as n, TDevtoolsListener as o, IDevtoolsActionEntry as r, TDevtoolsPosition as s, ActionDevtoolsCore as t };
-//# sourceMappingURL=ActionDevtoolsCore-Dd1qJAwK.d.cts.map
+//# sourceMappingURL=ActionDevtoolsCore-bjYQ8O2_.d.mts.map

package/build/{ActionPayload.types-BchJrBIX.d.mts → ActionPayload.types-Bmkzw2df.d.mts}

@@ -1027,6 +1027,13 @@ declare abstract class TransportConnection<T extends ETransportShape = ETranspor
   protected _finalizeReady(readyData: RD): IActionTransportReadyData_Methods | Promise<IActionTransportReadyData_Methods>;
   protected _getCacheKey(input: RP): string | null;
   getCacheKey(input: RP): string | null;
+  /**
+   * Whether this transport can serve the given action right now. Consulted by the manager before
+   * cache-key resolution and `getTransport`; a `false` result skips this transport (treated as
+   * `unsupported`) and the manager falls through to the next in preference order. Defaults to `true`
+   * when the transport declares no gate.
+   */
+  isAvailable(input: RP): boolean;
   getTransport(input: RP): TTransportStatusInfo<IActionTransportReadyData_Methods>;
   protected _processTransportStatus(input: RP): TTransportStatusInfo<IActionTransportReadyData_Methods>;
   /** Await carrier readiness, then finalize (possibly running a handshake) into the live methods. */
@@ -1174,6 +1181,15 @@ interface IActionTransportResolvers {
 type TGetTransportFn<IN extends ITransportRouteActionParams, READY extends IActionTransportReadyData_Base> = (input: IN) => TTransportStatusInfo_GetTransport_Output<READY>;
 interface IActionTransportInitialized<IN extends ITransportRouteActionParams, READY extends IActionTransportReadyData_Base> {
   getTransportCacheKey?: (input: IN) => string[];
+  /**
+   * Optional availability gate, consulted by {@link ConnectionTransportManager} *before* cache-key
+   * resolution and `getTransport`. When it returns `false`, this transport is treated as `unsupported`
+   * for that action and the manager falls through to the next transport in preference order — without
+   * opening the carrier or computing its cache key. Re-evaluated per action dispatch, so a transport can
+   * become available later (e.g. once a session/connection precondition is met) with no reconnect. Omit =
+   * always available.
+   */
+  isAvailable?: (input: IN) => boolean;
   getTransport: TGetTransportFn<IN, READY>;
 }
 interface IActionTransportDef<TYPE extends ETransportShape, INIT extends IActionTransportInitialized<any, any>> {
@@ -2735,6 +2751,12 @@ interface IExchangeTransportOptions {
   updateRunConfig?: TUpdateActionRunConfig;
   /** Keys identifying a reusable session, so one carrier is shared across actions to the same peer. */
   getTransportCacheKey?: (input: ITransportRouteActionParams) => string[];
+  /**
+   * Optional availability gate. When it returns `false`, the manager skips this transport for that action
+   * (reporting `unsupported`) and falls through to the next — without opening the carrier or computing its
+   * cache key. Re-evaluated per dispatch, so the transport can become available later with no reconnect.
+   */
+  available?: (input: ITransportRouteActionParams) => boolean;
   /** Short label for the devtools chip (defaults to "exchange"). */
   label?: string;
   getRouteInfo?: (input: ITransportRouteActionParams) => ITransportRouteInfo;
@@ -2841,6 +2863,12 @@ interface ILinkTransportOptions {
   updateRunConfig?: TUpdateActionRunConfig;
   /** Keys identifying a reusable channel, so one carrier is shared across actions to the same peer. */
   getTransportCacheKey?: (input: ITransportRouteActionParams) => string[];
+  /**
+   * Optional availability gate. When it returns `false`, the manager skips this transport for that action
+   * (reporting `unsupported`) and falls through to the next — without opening the carrier or computing its
+   * cache key. Re-evaluated per dispatch, so the transport can become available later with no reconnect.
+   */
+  available?: (input: ITransportRouteActionParams) => boolean;
   /** Short label for the devtools chip (defaults to "link"). */
   label?: string;
   getRouteInfo?: (input: ITransportRouteActionParams) => ITransportRouteInfo;
@@ -2875,6 +2903,13 @@ interface IPlainTransportOptions {
   formatMessage?: TLinkFormatMessage;
   /** Per-channel codec factory for stateful duplex codecs (e.g. the binary session). */
   createFormatMessage?: () => TLinkFormatMessage;
+  /**
+   * Optional availability gate. When it returns `false`, this transport reports as `unsupported` for that
+   * action and the manager falls through to the next transport in preference order — without opening the
+   * carrier or computing its cache key. Re-evaluated per dispatch, so a transport can become available
+   * later (e.g. once a session/connection precondition holds) with no reconnect. Omit = always available.
+   */
+  available?: (input: ITransportRouteActionParams) => boolean;
   updateRunConfig?: TUpdateActionRunConfig;
   /** Override the devtools chip label (defaults to the carrier's `carrierLabel`). */
   label?: string;
@@ -2894,6 +2929,55 @@ declare function plainTransport(options: IPlainTransportOptions & {
   carrier: IDuplexCarrierSource;
 }): LinkTransport;
 //#endregion
+//#region src/ActionRuntime/Transport/SecureSession/exchangeProtocol.d.ts
+/**
+ * The application-level envelope for secure action traffic over an {@link IExchangeCarrier} (HTTP). An
+ * exchange carrier only moves one request frame → one reply frame with no unsolicited push, so the
+ * handshake and the per-action token + crypto all ride in this envelope (a JSON string body) rather than
+ * on a persistent channel. The three security levels share it:
+ *
+ * - `none` — no handshake, no token: an `act` envelope carries the plaintext wire both ways.
+ * - `authenticated` — a one-time handshake yields a session `token`; each later `act` carries it +
+ *   the plaintext wire.
+ * - `encrypted` — same, but the wire is AES-GCM ciphertext, base64 in the `c` field.
+ *
+ * The handshake runs as two `hs` exchanges (hello→welcome, prove→accept) correlated by a client-chosen
+ * `hsid`, since stateless requests can't rely on channel ordering. The `accept` reply carries the token.
+ */
+type TWireJson = TActionPayload_Any_JsonObject<any, any>;
+/** Connector → acceptor request envelope. */
+type TExchangeRequest = {
+  k: "hs";
+  hsid: string;
+  m: string;
+} | {
+  k: "act";
+  t?: string;
+  w: TWireJson;
+} | {
+  k: "act";
+  t?: string;
+  c: string;
+};
+/** Acceptor → connector reply envelope. */
+type TExchangeReply = {
+  k: "hs";
+  m: string;
+  t?: string;
+} | {
+  k: "act";
+  w: TWireJson;
+} | {
+  k: "act";
+  c: string;
+} | {
+  k: "err";
+  message: string;
+};
+declare function encodeExchange(envelope: TExchangeRequest | TExchangeReply): string;
+declare function decodeExchangeRequest(raw: string): TExchangeRequest | undefined;
+declare function decodeExchangeReply(raw: string): TExchangeReply | undefined;
+//#endregion
 //#region src/ActionRuntime/Transport/secureTransport.d.ts
 interface ISecureTransportOptions {
   /** The shared channel identity (per-connection codec + dictionary version) — same one both ends use. */
@@ -2904,6 +2988,13 @@ interface ISecureTransportOptions {
   storageAdapter: StorageAdapter;
   /** The level this client requests; the peer must allow it. */
   securityLevel: ESecurityLevel;
+  /**
+   * Optional availability gate. When it returns `false`, this transport reports as `unsupported` for that
+   * action and the manager falls through to the next transport in preference order — without opening the
+   * carrier or computing its cache key. Re-evaluated per dispatch, so a transport can become available
+   * later (e.g. once a session/connection precondition holds) with no reconnect. Omit = always available.
+   */
+  available?: (input: ITransportRouteActionParams) => boolean;
   /**
    * How to reach the peer. A duplex carrier (`wsCarrier(url)`, `rtcCarrier(dc)`,
    * `inMemoryCarrier().carrier`) runs the push-capable session; an exchange carrier (`httpCarrier(...)`)
@@ -3151,5 +3242,5 @@ interface IActionPayload_Result_JsonObject<DOM extends IActionDomain = IActionDo
 type TActionPayload_Any_Instance<DOM extends IActionDomain = IActionDomain, ID extends keyof DOM["actionSchema"] & string = keyof DOM["actionSchema"] & string> = ActionPayload_Request<DOM, ID> | ActionPayload_Result<DOM, ID> | ActionPayload_Progress<DOM, ID>;
 type TActionPayload_Any_JsonObject<DOM extends IActionDomain = IActionDomain, ID extends keyof DOM["actionSchema"] & string = keyof DOM["actionSchema"] & string> = IActionPayload_Request_JsonObject<DOM, ID> | IActionPayload_Progress_JsonObject<DOM, ID> | IActionPayload_Result_JsonObject<DOM, ID>;
 //#endregion
-export { EErrId_NiceTransport_WebSocket as $, IClientVerifyKeyResolver as $n, TTransportedValue as $r, IAcceptorConnectionBinding as $t, ILinkTransportOptions as A, ITransportStatusInfo_Ready as An, ActionPayload_Result as Ar, IDuplexCarrier as At, IActionFrameCryptoConfig as B, TSendActionDataMethod as Bn, TActionDomainChildDef as Br, IActionChannel as Bt, decodeActionFrame as C, ITransportMethod_SendActionData_Input as Cn, IRunningActionUpdate_Abort as Cr, IServeChannelOptions as Ct, secureTransport as D, ITransportStatusInfo_Base as Dn, TRunningActionUpdate as Dr, IExchangeAcceptorCarrier as Dt, ISecureTransportOptions as E, ITransportRouteInfo as En, IRunningActionUpdate_Success as Er, IDuplexAcceptorCarrier as Et, err_nice_transport as F, TOnResolveAnyIncomingActionData_Json as Fn, TRuntimeCoordinateEnvId as Fr, TFrame$1 as Ft, TCarrierFetch as G, TTransportStatusInfo_GetTransport_Output as Gn, TPossibleDomainId as Gr, acceptChannelConnections as Gt, createBinaryWireAdapter as H, TTransportCache as Hn, TDomainActionId as Hr, TChannelAcceptorCases as Ht, ExchangeTransport as I, TOnResolveIncomingRequest as In, TRuntimeCoordinateStringId as Ir, IDuplexConnectionRouter as It, httpAcceptorCarrier as J, Transport as Jn, EActionResponseMode as Jr, ISecureChannel as Jt, httpCarrier as K, TUpdateActionRunConfig as Kn, TPossibleDomainIdList as Kr, connectChannel as Kt, IExchangeTransportOptions as L, TOnResolveIncomingRequestJson as Ln, IActionDomain as Lr, IHibernatableWsServerAdapterOptions as Lt, IActionTransportReadyData_Link as M, IUpdateActionRunConfig_Output as Mn, IRuntimeCoordinateSpecifics as Mr, IExchangeCarrier as Mt, TLinkFormatMessage as N, TGetTransportFn as Nn, IRuntimeFullCoordinates as Nr, IExchangeCarrierSource as Nt, IPlainTransportOptions as O, ITransportStatusInfo_Failed as On, TRunningActionUpdateFinished as Or, TAcceptorCarrier as Ot, EErrId_NiceTransport as P, TOnResolveAnyIncomingActionData as Pn, RuntimeCoordinate as Pr, TCarrier as Pt, wsAcceptorCarrier as Q, IClientVerifyKeyResolveInput as Qn, TActionSerializationDefinition as Qr, AcceptorHandler as Qt, IActionTransportReadyData_Exchange as R, TOnResolveIncomingResponse as Rn, IActionDomainChildOptions as Rr, createHibernatableWsServerAdapter as Rt, IActionFrameDecoder as S, ITransportDispatchAction as Sn, ERunningActionUpdateType as Sr, IChannelServer as St, err_nice_action as T, ITransportRouteClientParams as Tn, IRunningActionUpdate_Started as Tr, IAcceptorHibernation as Tt, IHttpCarrierOptions as U, TTransportInitializationFinishedInfo as Un, TInferInputFromSchema as Ur, TChannelPushHandlers as Ut, createActionFrameCrypto as V, TSendReturnDataMethod as Vn, TActionDomainSchema as Vr, IConnectChannelOptions as Vt, IHttpCarrierRequest as W, TTransportStatusInfo as Wn, TInferOutputFromSchema as Wr, acceptChannel as Wt, wsCarrier as X, ESecurityLevel as Xn, actionSchema as Xr, IBinaryWireSessionOptions as Xt, IWsCarrierOptions as Y, EHandshakeMessageType as Yn, TInferActionError as Yr, defineSecureChannel as Yt, IWsAcceptorCarrierOptions as Z, IClientHandshakeConfig as Zn, TActionSchemaOptions as Zr, createBinaryWireSessionFactory as Zt, TActionProgress as _, IActionTransportReady as _n, ActionPayload_Request as _r, IActionFetchHandlerOptions as _t, IActionPayload_Data_Base as a, IActionWireFormat as an, createInMemoryTofuVerifyKeyResolver as ar, IInMemoryCarrier as at, isActionPayload_Request_JsonObject as b, IActionTransportResolvers as bn, ERunningActionFinishedType as br, IExchangeAcceptorConfig as bt, IActionPayload_Request_JsonObject as c, ActionDomain as cn, decodeHandshakeMessage as cr, IInMemoryServerEndpoint as ct, IActionProgress_Custom as d, ConnectorHandler as dn, PeerLinkHandler as dr, ConnectionStateStore as dt, IAcceptorHandlerOptions as en, IHandshakeEncryptionKeyMaterial as er, err_nice_transport_ws as et, IActionProgress_None as f, createConnectorHandler as fn, ActionLocalHandler as fr, IConnectionAttachment as ft, TActionPayload_Any_JsonObject as g, IActionTransportInitialized as gn, ActionPayload_Progress as gr, createSecureAcceptorHandler as gt, TActionPayload_Any_Instance as h, IActionTransportDef as hn, RunningAction as hr, ISecureAcceptorHandlerOptions as ht, IActionPayload_Base_JsonObject as i, createAcceptorHandler as in, createClientHandshake as ir, rtcDataChannelByteChannel as it, LinkTransport as j, ITransportStatusInfo_Unsupported as jn, IRuntimeCoordinate as jr, IDuplexCarrierSource as jt, plainTransport as k, ITransportStatusInfo_Initializing as kn, TRunningActionUpdateListener as kr, isExchangeAcceptorCarrier as kt, IActionPayload_Result as l, ActionRootDomain as ln, encodeHandshakeMessage as lr, createInMemoryChannelPair as lt, IActionRouteItemHandler as m, ETransportStatus as mn, MaybePromise as mr, createConnectionStateStore as mt, EActionProgressType as n, TActionChannelFormatMessage as nn, IServerHandshakeConfig as nr, rtcCarrier as nt, IActionPayload_Progress as o, createActionRootDomain as on, createServerHandshake as or, inMemoryCarrier as ot, IActionProgress_Percentage as p, ETransportShape as pn, createLocalHandler as pr, IConnectionStateStoreOptions as pt, IHttpAcceptorCarrierOptions as q, ITransportConnectionContext as qn, ActionSchema as qr, defineChannel as qt, IActionPayload_Base as r, TActionConnectionEncoding as rn, THandshakeMessage as rr, IRtcDataChannelLike as rt, IActionPayload_Progress_JsonObject as s, ActionCore as sn, createStorageTofuVerifyKeyResolver as sr, IInMemoryChannelPair as st, EActionPayloadType as t, TAcceptorConnectionCaseFn as tn, IHandshakeResult as tr, IRtcCarrierOptions as tt, IActionPayload_Result_JsonObject as u, ActionRuntime as un, runtimeLinkId as ur, err_nice_external_client as ut, TActionResultOutcome as v, IActionTransportReadyData_Base as vn, IActionCore as vr, createActionFetchHandler as vt, EErrId_NiceAction as w, ITransportRouteActionParams as wn, IRunningActionUpdate_Progress as wr, serveChannel as wt, isActionPayload_Any_JsonObject as x, ISecureClientConfig as xn, ERunningActionState as xr, IExchangeAcceptorSecurity as xt, isActionPayload_Result_JsonObject as y, IActionTransportReadyData_Methods as yn, IActionCore_JsonObject as yr, ExchangeAcceptor as yt, IActionFrameCrypto as z, TOnResolveIncomingResponseJson as zn, IActionRootDomain as zr, IAcceptChannelOptions as zt };
-//# sourceMappingURL=ActionPayload.types-BchJrBIX.d.mts.map
+export { httpAcceptorCarrier as $, Transport as $n, EActionResponseMode as $r, ISecureChannel as $t, decodeExchangeReply as A, ITransportRouteClientParams as An, IRunningActionUpdate_Started as Ar, IAcceptorHibernation as At, err_nice_transport as B, TOnResolveAnyIncomingActionData_Json as Bn, TRuntimeCoordinateEnvId as Br, TFrame$1 as Bt, decodeActionFrame as C, IActionTransportReadyData_Base as Cn, IActionCore as Cr, createActionFetchHandler as Ct, secureTransport as D, ITransportDispatchAction as Dn, ERunningActionUpdateType as Dr, IChannelServer as Dt, ISecureTransportOptions as E, ISecureClientConfig as En, ERunningActionState as Er, IExchangeAcceptorSecurity as Et, ILinkTransportOptions as F, ITransportStatusInfo_Ready as Fn, ActionPayload_Result as Fr, IDuplexCarrier as Ft, IActionFrameCryptoConfig as G, TSendActionDataMethod as Gn, TActionDomainChildDef as Gr, IActionChannel as Gt, IExchangeTransportOptions as H, TOnResolveIncomingRequestJson as Hn, IActionDomain as Hr, IHibernatableWsServerAdapterOptions as Ht, LinkTransport as I, ITransportStatusInfo_Unsupported as In, IRuntimeCoordinate as Ir, IDuplexCarrierSource as It, IHttpCarrierOptions as J, TTransportInitializationFinishedInfo as Jn, TInferInputFromSchema as Jr, TChannelPushHandlers as Jt, createActionFrameCrypto as K, TSendReturnDataMethod as Kn, TActionDomainSchema as Kr, IConnectChannelOptions as Kt, IActionTransportReadyData_Link as L, IUpdateActionRunConfig_Output as Ln, IRuntimeCoordinateSpecifics as Lr, IExchangeCarrier as Lt, encodeExchange as M, ITransportStatusInfo_Base as Mn, TRunningActionUpdate as Mr, IExchangeAcceptorCarrier as Mt, IPlainTransportOptions as N, ITransportStatusInfo_Failed as Nn, TRunningActionUpdateFinished as Nr, TAcceptorCarrier as Nt, TExchangeReply as O, ITransportMethod_SendActionData_Input as On, IRunningActionUpdate_Abort as Or, IServeChannelOptions as Ot, plainTransport as P, ITransportStatusInfo_Initializing as Pn, TRunningActionUpdateListener as Pr, isExchangeAcceptorCarrier as Pt, IHttpAcceptorCarrierOptions as Q, ITransportConnectionContext as Qn, ActionSchema as Qr, defineChannel as Qt, TLinkFormatMessage as R, TGetTransportFn as Rn, IRuntimeFullCoordinates as Rr, IExchangeCarrierSource as Rt, IActionFrameDecoder as S, IActionTransportReady as Sn, ActionPayload_Request as Sr, IActionFetchHandlerOptions as St, err_nice_action as T, IActionTransportResolvers as Tn, ERunningActionFinishedType as Tr, IExchangeAcceptorConfig as Tt, IActionTransportReadyData_Exchange as U, TOnResolveIncomingResponse as Un, IActionDomainChildOptions as Ur, createHibernatableWsServerAdapter as Ut, ExchangeTransport as V, TOnResolveIncomingRequest as Vn, TRuntimeCoordinateStringId as Vr, IDuplexConnectionRouter as Vt, IActionFrameCrypto as W, TOnResolveIncomingResponseJson as Wn, IActionRootDomain as Wr, IAcceptChannelOptions as Wt, TCarrierFetch as X, TTransportStatusInfo_GetTransport_Output as Xn, TPossibleDomainId as Xr, acceptChannelConnections as Xt, IHttpCarrierRequest as Y, TTransportStatusInfo as Yn, TInferOutputFromSchema as Yr, acceptChannel as Yt, httpCarrier as Z, TUpdateActionRunConfig as Zn, TPossibleDomainIdList as Zr, connectChannel as Zt, TActionProgress as _, createConnectorHandler as _n, ActionLocalHandler as _r, IConnectionAttachment as _t, IActionPayload_Data_Base as a, IAcceptorHandlerOptions as an, IHandshakeEncryptionKeyMaterial as ar, err_nice_transport_ws as at, isActionPayload_Request_JsonObject as b, IActionTransportDef as bn, RunningAction as br, ISecureAcceptorHandlerOptions as bt, IActionPayload_Request_JsonObject as c, TActionConnectionEncoding as cn, THandshakeMessage as cr, IRtcDataChannelLike as ct, IActionProgress_Custom as d, createActionRootDomain as dn, createServerHandshake as dr, inMemoryCarrier as dt, TInferActionError as ei, defineSecureChannel as en, EHandshakeMessageType as er, IWsCarrierOptions as et, IActionProgress_None as f, ActionCore as fn, createStorageTofuVerifyKeyResolver as fr, IInMemoryChannelPair as ft, TActionPayload_Any_JsonObject as g, ConnectorHandler as gn, PeerLinkHandler as gr, ConnectionStateStore as gt, TActionPayload_Any_Instance as h, ActionRuntime as hn, runtimeLinkId as hr, err_nice_external_client as ht, IActionPayload_Base_JsonObject as i, TTransportedValue as ii, IAcceptorConnectionBinding as in, IClientVerifyKeyResolver as ir, EErrId_NiceTransport_WebSocket as it, decodeExchangeRequest as j, ITransportRouteInfo as jn, IRunningActionUpdate_Success as jr, IDuplexAcceptorCarrier as jt, TExchangeRequest as k, ITransportRouteActionParams as kn, IRunningActionUpdate_Progress as kr, serveChannel as kt, IActionPayload_Result as l, createAcceptorHandler as ln, createClientHandshake as lr, rtcDataChannelByteChannel as lt, IActionRouteItemHandler as m, ActionRootDomain as mn, encodeHandshakeMessage as mr, createInMemoryChannelPair as mt, EActionProgressType as n, TActionSchemaOptions as ni, createBinaryWireSessionFactory as nn, IClientHandshakeConfig as nr, IWsAcceptorCarrierOptions as nt, IActionPayload_Progress as o, TAcceptorConnectionCaseFn as on, IHandshakeResult as or, IRtcCarrierOptions as ot, IActionProgress_Percentage as p, ActionDomain as pn, decodeHandshakeMessage as pr, IInMemoryServerEndpoint as pt, createBinaryWireAdapter as q, TTransportCache as qn, TDomainActionId as qr, TChannelAcceptorCases as qt, IActionPayload_Base as r, TActionSerializationDefinition as ri, AcceptorHandler as rn, IClientVerifyKeyResolveInput as rr, wsAcceptorCarrier as rt, IActionPayload_Progress_JsonObject as s, TActionChannelFormatMessage as sn, IServerHandshakeConfig as sr, rtcCarrier as st, EActionPayloadType as t, actionSchema as ti, IBinaryWireSessionOptions as tn, ESecurityLevel as tr, wsCarrier as tt, IActionPayload_Result_JsonObject as u, IActionWireFormat as un, createInMemoryTofuVerifyKeyResolver as ur, IInMemoryCarrier as ut, TActionResultOutcome as v, ETransportShape as vn, createLocalHandler as vr, IConnectionStateStoreOptions as vt, EErrId_NiceAction as w, IActionTransportReadyData_Methods as wn, IActionCore_JsonObject as wr, ExchangeAcceptor as wt, isActionPayload_Any_JsonObject as x, IActionTransportInitialized as xn, ActionPayload_Progress as xr, createSecureAcceptorHandler as xt, isActionPayload_Result_JsonObject as y, ETransportStatus as yn, MaybePromise as yr, createConnectionStateStore as yt, EErrId_NiceTransport as z, TOnResolveAnyIncomingActionData as zn, RuntimeCoordinate as zr, TCarrier as zt };
+//# sourceMappingURL=ActionPayload.types-Bmkzw2df.d.mts.map

package/build/{ActionPayload.types-snDlSIF-.d.cts → ActionPayload.types-CdHOGGZK.d.cts}

@@ -1027,6 +1027,13 @@ declare abstract class TransportConnection<T extends ETransportShape = ETranspor
   protected _finalizeReady(readyData: RD): IActionTransportReadyData_Methods | Promise<IActionTransportReadyData_Methods>;
   protected _getCacheKey(input: RP): string | null;
   getCacheKey(input: RP): string | null;
+  /**
+   * Whether this transport can serve the given action right now. Consulted by the manager before
+   * cache-key resolution and `getTransport`; a `false` result skips this transport (treated as
+   * `unsupported`) and the manager falls through to the next in preference order. Defaults to `true`
+   * when the transport declares no gate.
+   */
+  isAvailable(input: RP): boolean;
   getTransport(input: RP): TTransportStatusInfo<IActionTransportReadyData_Methods>;
   protected _processTransportStatus(input: RP): TTransportStatusInfo<IActionTransportReadyData_Methods>;
   /** Await carrier readiness, then finalize (possibly running a handshake) into the live methods. */
@@ -1174,6 +1181,15 @@ interface IActionTransportResolvers {
 type TGetTransportFn<IN extends ITransportRouteActionParams, READY extends IActionTransportReadyData_Base> = (input: IN) => TTransportStatusInfo_GetTransport_Output<READY>;
 interface IActionTransportInitialized<IN extends ITransportRouteActionParams, READY extends IActionTransportReadyData_Base> {
   getTransportCacheKey?: (input: IN) => string[];
+  /**
+   * Optional availability gate, consulted by {@link ConnectionTransportManager} *before* cache-key
+   * resolution and `getTransport`. When it returns `false`, this transport is treated as `unsupported`
+   * for that action and the manager falls through to the next transport in preference order — without
+   * opening the carrier or computing its cache key. Re-evaluated per action dispatch, so a transport can
+   * become available later (e.g. once a session/connection precondition is met) with no reconnect. Omit =
+   * always available.
+   */
+  isAvailable?: (input: IN) => boolean;
   getTransport: TGetTransportFn<IN, READY>;
 }
 interface IActionTransportDef<TYPE extends ETransportShape, INIT extends IActionTransportInitialized<any, any>> {
@@ -2735,6 +2751,12 @@ interface IExchangeTransportOptions {
   updateRunConfig?: TUpdateActionRunConfig;
   /** Keys identifying a reusable session, so one carrier is shared across actions to the same peer. */
   getTransportCacheKey?: (input: ITransportRouteActionParams) => string[];
+  /**
+   * Optional availability gate. When it returns `false`, the manager skips this transport for that action
+   * (reporting `unsupported`) and falls through to the next — without opening the carrier or computing its
+   * cache key. Re-evaluated per dispatch, so the transport can become available later with no reconnect.
+   */
+  available?: (input: ITransportRouteActionParams) => boolean;
   /** Short label for the devtools chip (defaults to "exchange"). */
   label?: string;
   getRouteInfo?: (input: ITransportRouteActionParams) => ITransportRouteInfo;
@@ -2841,6 +2863,12 @@ interface ILinkTransportOptions {
   updateRunConfig?: TUpdateActionRunConfig;
   /** Keys identifying a reusable channel, so one carrier is shared across actions to the same peer. */
   getTransportCacheKey?: (input: ITransportRouteActionParams) => string[];
+  /**
+   * Optional availability gate. When it returns `false`, the manager skips this transport for that action
+   * (reporting `unsupported`) and falls through to the next — without opening the carrier or computing its
+   * cache key. Re-evaluated per dispatch, so the transport can become available later with no reconnect.
+   */
+  available?: (input: ITransportRouteActionParams) => boolean;
   /** Short label for the devtools chip (defaults to "link"). */
   label?: string;
   getRouteInfo?: (input: ITransportRouteActionParams) => ITransportRouteInfo;
@@ -2875,6 +2903,13 @@ interface IPlainTransportOptions {
   formatMessage?: TLinkFormatMessage;
   /** Per-channel codec factory for stateful duplex codecs (e.g. the binary session). */
   createFormatMessage?: () => TLinkFormatMessage;
+  /**
+   * Optional availability gate. When it returns `false`, this transport reports as `unsupported` for that
+   * action and the manager falls through to the next transport in preference order — without opening the
+   * carrier or computing its cache key. Re-evaluated per dispatch, so a transport can become available
+   * later (e.g. once a session/connection precondition holds) with no reconnect. Omit = always available.
+   */
+  available?: (input: ITransportRouteActionParams) => boolean;
   updateRunConfig?: TUpdateActionRunConfig;
   /** Override the devtools chip label (defaults to the carrier's `carrierLabel`). */
   label?: string;
@@ -2894,6 +2929,55 @@ declare function plainTransport(options: IPlainTransportOptions & {
   carrier: IDuplexCarrierSource;
 }): LinkTransport;
 //#endregion
+//#region src/ActionRuntime/Transport/SecureSession/exchangeProtocol.d.ts
+/**
+ * The application-level envelope for secure action traffic over an {@link IExchangeCarrier} (HTTP). An
+ * exchange carrier only moves one request frame → one reply frame with no unsolicited push, so the
+ * handshake and the per-action token + crypto all ride in this envelope (a JSON string body) rather than
+ * on a persistent channel. The three security levels share it:
+ *
+ * - `none` — no handshake, no token: an `act` envelope carries the plaintext wire both ways.
+ * - `authenticated` — a one-time handshake yields a session `token`; each later `act` carries it +
+ *   the plaintext wire.
+ * - `encrypted` — same, but the wire is AES-GCM ciphertext, base64 in the `c` field.
+ *
+ * The handshake runs as two `hs` exchanges (hello→welcome, prove→accept) correlated by a client-chosen
+ * `hsid`, since stateless requests can't rely on channel ordering. The `accept` reply carries the token.
+ */
+type TWireJson = TActionPayload_Any_JsonObject<any, any>;
+/** Connector → acceptor request envelope. */
+type TExchangeRequest = {
+  k: "hs";
+  hsid: string;
+  m: string;
+} | {
+  k: "act";
+  t?: string;
+  w: TWireJson;
+} | {
+  k: "act";
+  t?: string;
+  c: string;
+};
+/** Acceptor → connector reply envelope. */
+type TExchangeReply = {
+  k: "hs";
+  m: string;
+  t?: string;
+} | {
+  k: "act";
+  w: TWireJson;
+} | {
+  k: "act";
+  c: string;
+} | {
+  k: "err";
+  message: string;
+};
+declare function encodeExchange(envelope: TExchangeRequest | TExchangeReply): string;
+declare function decodeExchangeRequest(raw: string): TExchangeRequest | undefined;
+declare function decodeExchangeReply(raw: string): TExchangeReply | undefined;
+//#endregion
 //#region src/ActionRuntime/Transport/secureTransport.d.ts
 interface ISecureTransportOptions {
   /** The shared channel identity (per-connection codec + dictionary version) — same one both ends use. */
@@ -2904,6 +2988,13 @@ interface ISecureTransportOptions {
   storageAdapter: StorageAdapter;
   /** The level this client requests; the peer must allow it. */
   securityLevel: ESecurityLevel;
+  /**
+   * Optional availability gate. When it returns `false`, this transport reports as `unsupported` for that
+   * action and the manager falls through to the next transport in preference order — without opening the
+   * carrier or computing its cache key. Re-evaluated per dispatch, so a transport can become available
+   * later (e.g. once a session/connection precondition holds) with no reconnect. Omit = always available.
+   */
+  available?: (input: ITransportRouteActionParams) => boolean;
   /**
    * How to reach the peer. A duplex carrier (`wsCarrier(url)`, `rtcCarrier(dc)`,
    * `inMemoryCarrier().carrier`) runs the push-capable session; an exchange carrier (`httpCarrier(...)`)
@@ -3151,5 +3242,5 @@ interface IActionPayload_Result_JsonObject<DOM extends IActionDomain = IActionDo
 type TActionPayload_Any_Instance<DOM extends IActionDomain = IActionDomain, ID extends keyof DOM["actionSchema"] & string = keyof DOM["actionSchema"] & string> = ActionPayload_Request<DOM, ID> | ActionPayload_Result<DOM, ID> | ActionPayload_Progress<DOM, ID>;
 type TActionPayload_Any_JsonObject<DOM extends IActionDomain = IActionDomain, ID extends keyof DOM["actionSchema"] & string = keyof DOM["actionSchema"] & string> = IActionPayload_Request_JsonObject<DOM, ID> | IActionPayload_Progress_JsonObject<DOM, ID> | IActionPayload_Result_JsonObject<DOM, ID>;
 //#endregion
-export { EErrId_NiceTransport_WebSocket as $, IClientVerifyKeyResolver as $n, TTransportedValue as $r, IAcceptorConnectionBinding as $t, ILinkTransportOptions as A, ITransportStatusInfo_Ready as An, ActionPayload_Result as Ar, IDuplexCarrier as At, IActionFrameCryptoConfig as B, TSendActionDataMethod as Bn, TActionDomainChildDef as Br, IActionChannel as Bt, decodeActionFrame as C, ITransportMethod_SendActionData_Input as Cn, IRunningActionUpdate_Abort as Cr, IServeChannelOptions as Ct, secureTransport as D, ITransportStatusInfo_Base as Dn, TRunningActionUpdate as Dr, IExchangeAcceptorCarrier as Dt, ISecureTransportOptions as E, ITransportRouteInfo as En, IRunningActionUpdate_Success as Er, IDuplexAcceptorCarrier as Et, err_nice_transport as F, TOnResolveAnyIncomingActionData_Json as Fn, TRuntimeCoordinateEnvId as Fr, TFrame$1 as Ft, TCarrierFetch as G, TTransportStatusInfo_GetTransport_Output as Gn, TPossibleDomainId as Gr, acceptChannelConnections as Gt, createBinaryWireAdapter as H, TTransportCache as Hn, TDomainActionId as Hr, TChannelAcceptorCases as Ht, ExchangeTransport as I, TOnResolveIncomingRequest as In, TRuntimeCoordinateStringId as Ir, IDuplexConnectionRouter as It, httpAcceptorCarrier as J, Transport as Jn, EActionResponseMode as Jr, ISecureChannel as Jt, httpCarrier as K, TUpdateActionRunConfig as Kn, TPossibleDomainIdList as Kr, connectChannel as Kt, IExchangeTransportOptions as L, TOnResolveIncomingRequestJson as Ln, IActionDomain as Lr, IHibernatableWsServerAdapterOptions as Lt, IActionTransportReadyData_Link as M, IUpdateActionRunConfig_Output as Mn, IRuntimeCoordinateSpecifics as Mr, IExchangeCarrier as Mt, TLinkFormatMessage as N, TGetTransportFn as Nn, IRuntimeFullCoordinates as Nr, IExchangeCarrierSource as Nt, IPlainTransportOptions as O, ITransportStatusInfo_Failed as On, TRunningActionUpdateFinished as Or, TAcceptorCarrier as Ot, EErrId_NiceTransport as P, TOnResolveAnyIncomingActionData as Pn, RuntimeCoordinate as Pr, TCarrier as Pt, wsAcceptorCarrier as Q, IClientVerifyKeyResolveInput as Qn, TActionSerializationDefinition as Qr, AcceptorHandler as Qt, IActionTransportReadyData_Exchange as R, TOnResolveIncomingResponse as Rn, IActionDomainChildOptions as Rr, createHibernatableWsServerAdapter as Rt, IActionFrameDecoder as S, ITransportDispatchAction as Sn, ERunningActionUpdateType as Sr, IChannelServer as St, err_nice_action as T, ITransportRouteClientParams as Tn, IRunningActionUpdate_Started as Tr, IAcceptorHibernation as Tt, IHttpCarrierOptions as U, TTransportInitializationFinishedInfo as Un, TInferInputFromSchema as Ur, TChannelPushHandlers as Ut, createActionFrameCrypto as V, TSendReturnDataMethod as Vn, TActionDomainSchema as Vr, IConnectChannelOptions as Vt, IHttpCarrierRequest as W, TTransportStatusInfo as Wn, TInferOutputFromSchema as Wr, acceptChannel as Wt, wsCarrier as X, ESecurityLevel as Xn, actionSchema as Xr, IBinaryWireSessionOptions as Xt, IWsCarrierOptions as Y, EHandshakeMessageType as Yn, TInferActionError as Yr, defineSecureChannel as Yt, IWsAcceptorCarrierOptions as Z, IClientHandshakeConfig as Zn, TActionSchemaOptions as Zr, createBinaryWireSessionFactory as Zt, TActionProgress as _, IActionTransportReady as _n, ActionPayload_Request as _r, IActionFetchHandlerOptions as _t, IActionPayload_Data_Base as a, IActionWireFormat as an, createInMemoryTofuVerifyKeyResolver as ar, IInMemoryCarrier as at, isActionPayload_Request_JsonObject as b, IActionTransportResolvers as bn, ERunningActionFinishedType as br, IExchangeAcceptorConfig as bt, IActionPayload_Request_JsonObject as c, ActionDomain as cn, decodeHandshakeMessage as cr, IInMemoryServerEndpoint as ct, IActionProgress_Custom as d, ConnectorHandler as dn, PeerLinkHandler as dr, ConnectionStateStore as dt, IAcceptorHandlerOptions as en, IHandshakeEncryptionKeyMaterial as er, err_nice_transport_ws as et, IActionProgress_None as f, createConnectorHandler as fn, ActionLocalHandler as fr, IConnectionAttachment as ft, TActionPayload_Any_JsonObject as g, IActionTransportInitialized as gn, ActionPayload_Progress as gr, createSecureAcceptorHandler as gt, TActionPayload_Any_Instance as h, IActionTransportDef as hn, RunningAction as hr, ISecureAcceptorHandlerOptions as ht, IActionPayload_Base_JsonObject as i, createAcceptorHandler as in, createClientHandshake as ir, rtcDataChannelByteChannel as it, LinkTransport as j, ITransportStatusInfo_Unsupported as jn, IRuntimeCoordinate as jr, IDuplexCarrierSource as jt, plainTransport as k, ITransportStatusInfo_Initializing as kn, TRunningActionUpdateListener as kr, isExchangeAcceptorCarrier as kt, IActionPayload_Result as l, ActionRootDomain as ln, encodeHandshakeMessage as lr, createInMemoryChannelPair as lt, IActionRouteItemHandler as m, ETransportStatus as mn, MaybePromise as mr, createConnectionStateStore as mt, EActionProgressType as n, TActionChannelFormatMessage as nn, IServerHandshakeConfig as nr, rtcCarrier as nt, IActionPayload_Progress as o, createActionRootDomain as on, createServerHandshake as or, inMemoryCarrier as ot, IActionProgress_Percentage as p, ETransportShape as pn, createLocalHandler as pr, IConnectionStateStoreOptions as pt, IHttpAcceptorCarrierOptions as q, ITransportConnectionContext as qn, ActionSchema as qr, defineChannel as qt, IActionPayload_Base as r, TActionConnectionEncoding as rn, THandshakeMessage as rr, IRtcDataChannelLike as rt, IActionPayload_Progress_JsonObject as s, ActionCore as sn, createStorageTofuVerifyKeyResolver as sr, IInMemoryChannelPair as st, EActionPayloadType as t, TAcceptorConnectionCaseFn as tn, IHandshakeResult as tr, IRtcCarrierOptions as tt, IActionPayload_Result_JsonObject as u, ActionRuntime as un, runtimeLinkId as ur, err_nice_external_client as ut, TActionResultOutcome as v, IActionTransportReadyData_Base as vn, IActionCore as vr, createActionFetchHandler as vt, EErrId_NiceAction as w, ITransportRouteActionParams as wn, IRunningActionUpdate_Progress as wr, serveChannel as wt, isActionPayload_Any_JsonObject as x, ISecureClientConfig as xn, ERunningActionState as xr, IExchangeAcceptorSecurity as xt, isActionPayload_Result_JsonObject as y, IActionTransportReadyData_Methods as yn, IActionCore_JsonObject as yr, ExchangeAcceptor as yt, IActionFrameCrypto as z, TOnResolveIncomingResponseJson as zn, IActionRootDomain as zr, IAcceptChannelOptions as zt };
-//# sourceMappingURL=ActionPayload.types-snDlSIF-.d.cts.map
+export { httpAcceptorCarrier as $, Transport as $n, EActionResponseMode as $r, ISecureChannel as $t, decodeExchangeReply as A, ITransportRouteClientParams as An, IRunningActionUpdate_Started as Ar, IAcceptorHibernation as At, err_nice_transport as B, TOnResolveAnyIncomingActionData_Json as Bn, TRuntimeCoordinateEnvId as Br, TFrame$1 as Bt, decodeActionFrame as C, IActionTransportReadyData_Base as Cn, IActionCore as Cr, createActionFetchHandler as Ct, secureTransport as D, ITransportDispatchAction as Dn, ERunningActionUpdateType as Dr, IChannelServer as Dt, ISecureTransportOptions as E, ISecureClientConfig as En, ERunningActionState as Er, IExchangeAcceptorSecurity as Et, ILinkTransportOptions as F, ITransportStatusInfo_Ready as Fn, ActionPayload_Result as Fr, IDuplexCarrier as Ft, IActionFrameCryptoConfig as G, TSendActionDataMethod as Gn, TActionDomainChildDef as Gr, IActionChannel as Gt, IExchangeTransportOptions as H, TOnResolveIncomingRequestJson as Hn, IActionDomain as Hr, IHibernatableWsServerAdapterOptions as Ht, LinkTransport as I, ITransportStatusInfo_Unsupported as In, IRuntimeCoordinate as Ir, IDuplexCarrierSource as It, IHttpCarrierOptions as J, TTransportInitializationFinishedInfo as Jn, TInferInputFromSchema as Jr, TChannelPushHandlers as Jt, createActionFrameCrypto as K, TSendReturnDataMethod as Kn, TActionDomainSchema as Kr, IConnectChannelOptions as Kt, IActionTransportReadyData_Link as L, IUpdateActionRunConfig_Output as Ln, IRuntimeCoordinateSpecifics as Lr, IExchangeCarrier as Lt, encodeExchange as M, ITransportStatusInfo_Base as Mn, TRunningActionUpdate as Mr, IExchangeAcceptorCarrier as Mt, IPlainTransportOptions as N, ITransportStatusInfo_Failed as Nn, TRunningActionUpdateFinished as Nr, TAcceptorCarrier as Nt, TExchangeReply as O, ITransportMethod_SendActionData_Input as On, IRunningActionUpdate_Abort as Or, IServeChannelOptions as Ot, plainTransport as P, ITransportStatusInfo_Initializing as Pn, TRunningActionUpdateListener as Pr, isExchangeAcceptorCarrier as Pt, IHttpAcceptorCarrierOptions as Q, ITransportConnectionContext as Qn, ActionSchema as Qr, defineChannel as Qt, TLinkFormatMessage as R, TGetTransportFn as Rn, IRuntimeFullCoordinates as Rr, IExchangeCarrierSource as Rt, IActionFrameDecoder as S, IActionTransportReady as Sn, ActionPayload_Request as Sr, IActionFetchHandlerOptions as St, err_nice_action as T, IActionTransportResolvers as Tn, ERunningActionFinishedType as Tr, IExchangeAcceptorConfig as Tt, IActionTransportReadyData_Exchange as U, TOnResolveIncomingResponse as Un, IActionDomainChildOptions as Ur, createHibernatableWsServerAdapter as Ut, ExchangeTransport as V, TOnResolveIncomingRequest as Vn, TRuntimeCoordinateStringId as Vr, IDuplexConnectionRouter as Vt, IActionFrameCrypto as W, TOnResolveIncomingResponseJson as Wn, IActionRootDomain as Wr, IAcceptChannelOptions as Wt, TCarrierFetch as X, TTransportStatusInfo_GetTransport_Output as Xn, TPossibleDomainId as Xr, acceptChannelConnections as Xt, IHttpCarrierRequest as Y, TTransportStatusInfo as Yn, TInferOutputFromSchema as Yr, acceptChannel as Yt, httpCarrier as Z, TUpdateActionRunConfig as Zn, TPossibleDomainIdList as Zr, connectChannel as Zt, TActionProgress as _, createConnectorHandler as _n, ActionLocalHandler as _r, IConnectionAttachment as _t, IActionPayload_Data_Base as a, IAcceptorHandlerOptions as an, IHandshakeEncryptionKeyMaterial as ar, err_nice_transport_ws as at, isActionPayload_Request_JsonObject as b, IActionTransportDef as bn, RunningAction as br, ISecureAcceptorHandlerOptions as bt, IActionPayload_Request_JsonObject as c, TActionConnectionEncoding as cn, THandshakeMessage as cr, IRtcDataChannelLike as ct, IActionProgress_Custom as d, createActionRootDomain as dn, createServerHandshake as dr, inMemoryCarrier as dt, TInferActionError as ei, defineSecureChannel as en, EHandshakeMessageType as er, IWsCarrierOptions as et, IActionProgress_None as f, ActionCore as fn, createStorageTofuVerifyKeyResolver as fr, IInMemoryChannelPair as ft, TActionPayload_Any_JsonObject as g, ConnectorHandler as gn, PeerLinkHandler as gr, ConnectionStateStore as gt, TActionPayload_Any_Instance as h, ActionRuntime as hn, runtimeLinkId as hr, err_nice_external_client as ht, IActionPayload_Base_JsonObject as i, TTransportedValue as ii, IAcceptorConnectionBinding as in, IClientVerifyKeyResolver as ir, EErrId_NiceTransport_WebSocket as it, decodeExchangeRequest as j, ITransportRouteInfo as jn, IRunningActionUpdate_Success as jr, IDuplexAcceptorCarrier as jt, TExchangeRequest as k, ITransportRouteActionParams as kn, IRunningActionUpdate_Progress as kr, serveChannel as kt, IActionPayload_Result as l, createAcceptorHandler as ln, createClientHandshake as lr, rtcDataChannelByteChannel as lt, IActionRouteItemHandler as m, ActionRootDomain as mn, encodeHandshakeMessage as mr, createInMemoryChannelPair as mt, EActionProgressType as n, TActionSchemaOptions as ni, createBinaryWireSessionFactory as nn, IClientHandshakeConfig as nr, IWsAcceptorCarrierOptions as nt, IActionPayload_Progress as o, TAcceptorConnectionCaseFn as on, IHandshakeResult as or, IRtcCarrierOptions as ot, IActionProgress_Percentage as p, ActionDomain as pn, decodeHandshakeMessage as pr, IInMemoryServerEndpoint as pt, createBinaryWireAdapter as q, TTransportCache as qn, TDomainActionId as qr, TChannelAcceptorCases as qt, IActionPayload_Base as r, TActionSerializationDefinition as ri, AcceptorHandler as rn, IClientVerifyKeyResolveInput as rr, wsAcceptorCarrier as rt, IActionPayload_Progress_JsonObject as s, TActionChannelFormatMessage as sn, IServerHandshakeConfig as sr, rtcCarrier as st, EActionPayloadType as t, actionSchema as ti, IBinaryWireSessionOptions as tn, ESecurityLevel as tr, wsCarrier as tt, IActionPayload_Result_JsonObject as u, IActionWireFormat as un, createInMemoryTofuVerifyKeyResolver as ur, IInMemoryCarrier as ut, TActionResultOutcome as v, ETransportShape as vn, createLocalHandler as vr, IConnectionStateStoreOptions as vt, EErrId_NiceAction as w, IActionTransportReadyData_Methods as wn, IActionCore_JsonObject as wr, ExchangeAcceptor as wt, isActionPayload_Any_JsonObject as x, IActionTransportInitialized as xn, ActionPayload_Progress as xr, createSecureAcceptorHandler as xt, isActionPayload_Result_JsonObject as y, ETransportStatus as yn, MaybePromise as yr, createConnectionStateStore as yt, EErrId_NiceTransport as z, TOnResolveAnyIncomingActionData as zn, RuntimeCoordinate as zr, TCarrier as zt };
+//# sourceMappingURL=ActionPayload.types-CdHOGGZK.d.cts.map

package/build/devtools/browser/index.d.cts

@@ -1,4 +1,4 @@
-import { a as TDevtoolsActionStatus, i as IDevtoolsObservableDomain, n as IActionDevtoolsCoreOptions, o as TDevtoolsListener, r as IDevtoolsActionEntry, s as TDevtoolsPosition, t as ActionDevtoolsCore } from "../../ActionDevtoolsCore-Dd1qJAwK.cjs";
+import { a as TDevtoolsActionStatus, i as IDevtoolsObservableDomain, n as IActionDevtoolsCoreOptions, o as TDevtoolsListener, r as IDevtoolsActionEntry, s as TDevtoolsPosition, t as ActionDevtoolsCore } from "../../ActionDevtoolsCore-CCZXQBAo.cjs";
 
 //#region src/devtools/browser/NiceActionDevtools.d.ts
 interface INiceActionDevtoolsProps {

package/build/devtools/browser/index.d.mts

@@ -1,4 +1,4 @@
-import { a as TDevtoolsActionStatus, i as IDevtoolsObservableDomain, n as IActionDevtoolsCoreOptions, o as TDevtoolsListener, r as IDevtoolsActionEntry, s as TDevtoolsPosition, t as ActionDevtoolsCore } from "../../ActionDevtoolsCore-C5XrQI1K.mjs";
+import { a as TDevtoolsActionStatus, i as IDevtoolsObservableDomain, n as IActionDevtoolsCoreOptions, o as TDevtoolsListener, r as IDevtoolsActionEntry, s as TDevtoolsPosition, t as ActionDevtoolsCore } from "../../ActionDevtoolsCore-bjYQ8O2_.mjs";
 
 //#region src/devtools/browser/NiceActionDevtools.d.ts
 interface INiceActionDevtoolsProps {

package/build/devtools/server/index.d.cts

@@ -1,4 +1,4 @@
-import { a as TDevtoolsActionStatus, i as IDevtoolsObservableDomain, n as IActionDevtoolsCoreOptions, o as TDevtoolsListener, r as IDevtoolsActionEntry, t as ActionDevtoolsCore } from "../../ActionDevtoolsCore-Dd1qJAwK.cjs";
+import { a as TDevtoolsActionStatus, i as IDevtoolsObservableDomain, n as IActionDevtoolsCoreOptions, o as TDevtoolsListener, r as IDevtoolsActionEntry, t as ActionDevtoolsCore } from "../../ActionDevtoolsCore-CCZXQBAo.cjs";
 
 //#region src/devtools/server/NiceActionServerDevtools.d.ts
 type TServerDevtoolsLogFn = (message: string, data?: Record<string, unknown>) => void;

package/build/devtools/server/index.d.mts

@@ -1,4 +1,4 @@
-import { a as TDevtoolsActionStatus, i as IDevtoolsObservableDomain, n as IActionDevtoolsCoreOptions, o as TDevtoolsListener, r as IDevtoolsActionEntry, t as ActionDevtoolsCore } from "../../ActionDevtoolsCore-C5XrQI1K.mjs";
+import { a as TDevtoolsActionStatus, i as IDevtoolsObservableDomain, n as IActionDevtoolsCoreOptions, o as TDevtoolsListener, r as IDevtoolsActionEntry, t as ActionDevtoolsCore } from "../../ActionDevtoolsCore-bjYQ8O2_.mjs";
 
 //#region src/devtools/server/NiceActionServerDevtools.d.ts
 type TServerDevtoolsLogFn = (message: string, data?: Record<string, unknown>) => void;

package/build/index.cjs

@@ -879,6 +879,10 @@ var ConnectionTransportManager = class {
 		const candidates = [];
 		const unavailableTransports = [];
 		for (const transport of this._transports) {
+			if (!transport.isAvailable(routeActionParams)) {
+				unavailableTransports.push(transport);
+				continue;
+			}
 			const cacheKey = transport.getCacheKey(routeActionParams);
 			if (cacheKey != null) {
 				const cached = this._cache.get(cacheKey);
@@ -4440,6 +4444,15 @@ var TransportConnection = class {
 		if (inner == null) return null;
 		return `${this.transOrd}:${inner}`;
 	}
+	/**
+	* Whether this transport can serve the given action right now. Consulted by the manager before
+	* cache-key resolution and `getTransport`; a `false` result skips this transport (treated as
+	* `unsupported`) and the manager falls through to the next in preference order. Defaults to `true`
+	* when the transport declares no gate.
+	*/
+	isAvailable(input) {
+		return this.initialized.isAvailable?.(input) ?? true;
+	}
 	getTransport(input) {
 		return this._processTransportStatus(input);
 	}
@@ -4536,6 +4549,7 @@ var ExchangeTransport = class ExchangeTransport extends Transport {
 		const options = this.options;
 		return new ExchangeConnection({ initialize: () => ({
 			getTransportCacheKey: options.getTransportCacheKey,
+			isAvailable: options.available,
 			getTransport: (input) => ({
 				status: "ready",
 				readyData: {
@@ -4784,6 +4798,7 @@ var LinkTransport = class LinkTransport extends Transport {
 		const options = this.options;
 		return new LinkConnection({ initialize: () => ({
 			getTransportCacheKey: options.getTransportCacheKey,
+			isAvailable: options.available,
 			getTransport: (input) => ({
 				status: "ready",
 				readyData: {
@@ -4820,6 +4835,7 @@ function plainTransport(options) {
 	if (isExchangeCarrierSource(carrier)) return ExchangeTransport.create({
 		openCarrier: carrier.open,
 		getTransportCacheKey: carrier.getCacheKey,
+		available: options.available,
 		getRouteInfo: carrier.getRouteInfo,
 		label: options.label ?? carrier.carrierLabel,
 		updateRunConfig: options.updateRunConfig
@@ -4829,6 +4845,7 @@ function plainTransport(options) {
 		formatMessage: options.formatMessage,
 		createFormatMessage: options.createFormatMessage,
 		getTransportCacheKey: carrier.getCacheKey,
+		available: options.available,
 		getRouteInfo: carrier.getRouteInfo,
 		label: options.label ?? carrier.carrierLabel,
 		updateRunConfig: options.updateRunConfig
@@ -4848,6 +4865,7 @@ function secureTransport(options) {
 	if (isExchangeCarrierSource(carrier)) return ExchangeTransport.create({
 		openCarrier: carrier.open,
 		getTransportCacheKey: carrier.getCacheKey,
+		available: options.available,
 		getRouteInfo: carrier.getRouteInfo,
 		label: carrier.carrierLabel,
 		security
@@ -4856,6 +4874,7 @@ function secureTransport(options) {
 		openChannel: carrier.open,
 		createFormatMessage: options.channel.createCodec,
 		getTransportCacheKey: carrier.getCacheKey,
+		available: options.available,
 		getRouteInfo: carrier.getRouteInfo,
 		label: carrier.carrierLabel,
 		security
@@ -4912,9 +4931,12 @@ exports.createSecureAcceptorHandler = createSecureAcceptorHandler;
 exports.createServerHandshake = createServerHandshake;
 exports.createStorageTofuVerifyKeyResolver = createStorageTofuVerifyKeyResolver;
 exports.decodeActionFrame = decodeActionFrame;
+exports.decodeExchangeReply = decodeExchangeReply;
+exports.decodeExchangeRequest = decodeExchangeRequest;
 exports.decodeHandshakeMessage = decodeHandshakeMessage;
 exports.defineChannel = defineChannel;
 exports.defineSecureChannel = defineSecureChannel;
+exports.encodeExchange = encodeExchange;
 exports.encodeHandshakeMessage = encodeHandshakeMessage;
 exports.err_nice_action = err_nice_action;
 exports.err_nice_external_client = err_nice_external_client;