@nice-code/action 0.6.0 → 0.6.2

package/build/types/devtools/browser/components/OriginChip.d.ts

@@ -0,0 +1,15 @@
+import { ESize } from "../ui_util/size";
+/**
+ * Marks an action that was received from another runtime (a backend push, or an action relayed from
+ * another client) rather than dispatched locally. The chip shows the origin's `envId`; the tooltip
+ * carries the full coordinate. Render it only when {@link getInboundOrigin} returns a value.
+ */
+export declare function OriginChip({ origin, size, subtle, }: {
+    origin: {
+        envId: string;
+        perId?: string;
+        insId?: string;
+    };
+    size?: ESize;
+    subtle?: boolean;
+}): import("react/jsx-runtime").JSX.Element;

package/build/types/devtools/browser/components/SectionLabel.d.ts

@@ -1,4 +1,4 @@
-export declare function SectionLabel({ label, color }: {
+export declare function SectionLabel({ label, color, }: {
     label: string;
     color?: string;
 }): import("react/jsx-runtime").JSX.Element;

package/build/types/devtools/browser/components/utils.d.ts

@@ -5,6 +5,17 @@ export declare const STATUS_COLOR: Record<TDevtoolsActionStatus, string>;
 export declare const STATUS_THING: Record<TDevtoolsActionStatus, ESemanticThing>;
 export declare const STATUS_SYMBOL: Record<TDevtoolsActionStatus, string>;
 export declare const STATUS_ICON: Record<TDevtoolsActionStatus, LucideIcon>;
+/**
+ * The runtime an action *originated* on, when that differs from the runtime that handled it — i.e. an
+ * inbound action received over a transport (a backend push, or an action relayed from another client),
+ * rather than one dispatched locally. Returns `null` for locally-originated actions (where the origin
+ * matches the handling runtime) and for actions with no known origin.
+ */
+export declare function getInboundOrigin(entry: IDevtoolsActionEntry): {
+    envId: string;
+    perId?: string;
+    insId?: string;
+} | null;
 export declare function safeStringify(value: unknown, indent?: number): string;
 export declare function formatRelativeAge(ms: number): string;
 export declare function formatDuration(entry: IDevtoolsActionEntry): string | null;

package/build/types/devtools/core/devtools_colors.d.ts

@@ -54,6 +54,7 @@ export declare enum ESemanticThing {
     domain = "domain",
     handler_local = "handler_local",
     handler_external = "handler_external",
+    origin = "origin",// runtime an action was received from (inbound / pushed actions)
     age = "age",// non-latest relative-age chip
     io_input = "io_input",
     io_output = "io_output",

package/build/types/devtools/server/index.d.ts

@@ -1,3 +1,3 @@
-export { ActionServerDevtools, type IActionServerDevtoolsOptions, type TServerDevtoolsLogFn, } from "./NiceActionServerDevtools";
-export { ActionDevtoolsCore, type IActionDevtoolsCoreOptions } from "../core/ActionDevtoolsCore";
 export type { IDevtoolsActionEntry, IDevtoolsObservableDomain, TDevtoolsActionStatus, TDevtoolsListener, } from "../core/ActionDevtools.types";
+export { ActionDevtoolsCore, type IActionDevtoolsCoreOptions } from "../core/ActionDevtoolsCore";
+export { ActionServerDevtools, type IActionServerDevtoolsOptions, type TServerDevtoolsLogFn, } from "./NiceActionServerDevtools";

package/build/types/index.d.ts

@@ -22,10 +22,17 @@ export * from "./ActionRuntime/Handler/ExternalClient/Transport/err_nice_transpo
 export { HttpTransport, type IHttpTransportOptions, } from "./ActionRuntime/Handler/ExternalClient/Transport/Http/HttpTransport";
 export { type ITransportConnectionContext, Transport, } from "./ActionRuntime/Handler/ExternalClient/Transport/Transport";
 export * from "./ActionRuntime/Handler/ExternalClient/Transport/Transport.types";
+export { createActionFrameCrypto, type IActionFrameCrypto, type IActionFrameCryptoConfig, } from "./ActionRuntime/Handler/ExternalClient/Transport/WebSocket/actionFrameCrypto";
+export { createClientHandshake, createInMemoryTofuVerifyKeyResolver, createServerHandshake, createStorageTofuVerifyKeyResolver, decodeHandshakeMessage, EHandshakeMessageType, ESecurityLevel, encodeHandshakeMessage, type IClientHandshakeConfig, type IClientVerifyKeyResolveInput, type IClientVerifyKeyResolver, type IHandshakeEncryptionKeyMaterial, type IHandshakeResult, type IServerHandshakeConfig, runtimeLinkId, type THandshakeMessage, } from "./ActionRuntime/Handler/ExternalClient/Transport/WebSocket/actionWsHandshake";
+export { createBinaryWsAdapter } from "./ActionRuntime/Handler/ExternalClient/Transport/WebSocket/createBinaryWsAdapter";
+export { createBinaryWsSessionFactory, type IBinaryWsSessionOptions, } from "./ActionRuntime/Handler/ExternalClient/Transport/WebSocket/createBinaryWsSessionFactory";
+export type { IActionTransportDef_Ws, IActionTransportInitialized_Ws, IActionTransportReadyData_Ws, } from "./ActionRuntime/Handler/ExternalClient/Transport/WebSocket/TransportWebSocket.types";
 export { type IWebSocketTransportAdvancedOptions, type IWebSocketTransportSocketOptions, type TWebSocketTransportOptions, WebSocketTransport, } from "./ActionRuntime/Handler/ExternalClient/Transport/WebSocket/WebSocketTransport";
 export { ActionLocalHandler, createLocalHandler, } from "./ActionRuntime/Handler/Local/ActionLocalHandler";
+export { ActionServerHandler, createServerHandler, type IActionServerConnectionBinding, type IActionServerHandlerOptions, type TActionChannelFormatMessage, type TActionConnectionEncoding, } from "./ActionRuntime/Handler/Server/ActionServerHandler";
 export * from "./ActionRuntime/RuntimeCoordinate";
 export { EErrId_NiceAction, err_nice_action } from "./errors/err_nice_action";
+export { decodeActionFrame, type IActionFrameDecoder } from "./utils/decodeActionFrame";
 export { isActionPayload_Any_JsonObject } from "./utils/isActionPayload_Any_JsonObject";
 export * from "./utils/isActionPayload_Request_JsonObject";
 export * from "./utils/isActionPayload_Result_JsonObject";

package/build/types/utils/decodeActionFrame.d.ts

@@ -0,0 +1,17 @@
+import type { TActionPayload_Any_JsonObject } from "../ActionDefinition/Action/Payload/ActionPayload.types";
+/**
+ * Minimal codec shape needed to turn an incoming channel frame back into action wire JSON. Matches
+ * the `formatMessage` object the WebSocket transport (and `createBinaryWsAdapter`) provide.
+ */
+export interface IActionFrameDecoder {
+    incoming?: (frame: string | ArrayBuffer | Uint8Array | Blob) => TActionPayload_Any_JsonObject<any, any> | undefined;
+}
+/**
+ * Decode a single inbound channel frame (text or binary) into validated action wire JSON, or
+ * `undefined` if it isn't a recognisable action payload.
+ *
+ * Shared by the WebSocket transport's message listener and the server-side `ActionServerHandler` so
+ * both decode identically: a binary `decoder.incoming` (e.g. msgpackr) takes precedence, and plain
+ * text frames fall back to JSON — keeping binary and JSON clients interoperable on one channel.
+ */
+export declare function decodeActionFrame(frame: string | ArrayBuffer | Uint8Array, decoder?: IActionFrameDecoder): TActionPayload_Any_JsonObject<any, any> | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nice-code/action",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "private": false,
   "type": "module",
   "exports": {
@@ -44,16 +44,17 @@
     "build-types": "tsc --project tsconfig.build.json"
   },
   "dependencies": {
-    "@nice-code/common-errors": "0.6.0",
-    "@nice-code/error": "0.6.0",
-    "@nice-code/util": "0.6.0",
+    "@nice-code/common-errors": "0.6.2",
+    "@nice-code/error": "0.6.2",
+    "@nice-code/util": "0.6.2",
     "@standard-schema/spec": "^1.1.0",
     "@tanstack/react-virtual": "^3.13.26",
     "http-status-codes": "^2.3.0",
     "lucide-react": "1.17.0",
     "nanoid": "^5.1.9",
     "source-map-js": "^1.2.1",
-    "std-env": "^4.1.0"
+    "std-env": "^4.1.0",
+    "msgpackr": "2.0.4"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.100.3",