@nice-code/action 0.5.5 → 0.6.1

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.5.5",
+  "version": "0.6.1",
   "private": false,
   "type": "module",
   "exports": {
@@ -44,16 +44,17 @@
     "build-types": "tsc --project tsconfig.build.json"
   },
   "dependencies": {
-    "@nice-code/common-errors": "0.5.5",
-    "@nice-code/error": "0.5.5",
-    "@nice-code/util": "0.5.5",
+    "@nice-code/common-errors": "0.6.1",
+    "@nice-code/error": "0.6.1",
+    "@nice-code/util": "0.6.1",
     "@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",