@nice-code/action 0.6.3 → 0.8.0

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

@@ -1,6 +1,7 @@
 import { type LucideIcon } from "lucide-react";
 import type { IDevtoolsActionEntry, TDevtoolsActionStatus } from "../../core/ActionDevtools.types";
 import { ESemanticThing } from "../../core/devtools_colors";
+export { formatRelativeAge, formatTimestamp, safeStringify } from "nice-devtools-shared";
 export declare const STATUS_COLOR: Record<TDevtoolsActionStatus, string>;
 export declare const STATUS_THING: Record<TDevtoolsActionStatus, ESemanticThing>;
 export declare const STATUS_SYMBOL: Record<TDevtoolsActionStatus, string>;
@@ -16,7 +17,4 @@ export declare function getInboundOrigin(entry: IDevtoolsActionEntry): {
     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;
-export declare function formatTimestamp(startTime: number): string;

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

@@ -1,7 +1,7 @@
 import type { TActionProgress } from "../../ActionDefinition/Action/Payload/ActionPayload.types";
 import type { IRuntimeCoordinate } from "../../ActionRuntime/RuntimeCoordinate";
+export type { TDevtoolsPosition } from "nice-devtools-shared";
 export type TDevtoolsActionStatus = "running" | "success" | "action-error" | "failed" | "aborted";
-export type TDevtoolsPosition = "dock-bottom" | "dock-top" | "dock-left" | "dock-right";
 export interface IDevtoolsRouteItem {
     runtime: IRuntimeCoordinate;
     handlerType: "local" | "external";

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

@@ -1,10 +1,13 @@
 import type { IDevtoolsActionEntry, IDevtoolsObservableDomain, TDevtoolsListener } from "./ActionDevtools.types";
 export interface IActionDevtoolsCoreOptions {
+    /** Max root entries to retain. Older entries (and their children) are evicted. */
+    maxEntries?: number;
 }
 export declare class ActionDevtoolsCore {
     private _entries;
     private _listeners;
-    constructor(_options?: IActionDevtoolsCoreOptions);
+    private readonly _maxEntries;
+    constructor(options?: IActionDevtoolsCoreOptions);
     attachToDomain(domain: IDevtoolsObservableDomain): () => void;
     getEntries(): readonly IDevtoolsActionEntry[];
     subscribe(listener: TDevtoolsListener): () => void;

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

@@ -1,39 +1,14 @@
 import type { IChipColorEntry } from "../browser/components/Chip";
-export declare const DEVTOOL_COLOR_SEMANTIC_ERROR = "#FF5C5C";
-export declare const DEVTOOL_COLOR_SEMANTIC_SUCCESS = "#A3E635";
-export declare const DEVTOOL_COLOR_SEMANTIC_SYSTEM = "#38BDF8";
-export declare const DEVTOOL_COLOR_SEMANTIC_WARNING = "#FB923C";
-export declare const DEVTOOL_COLOR_SEMANTIC_METADATA = "#A1A1AA";
+export { DEVTOOL_COLOR_SEMANTIC_ERROR, DEVTOOL_COLOR_SEMANTIC_METADATA, DEVTOOL_COLOR_SEMANTIC_SUCCESS, DEVTOOL_COLOR_SEMANTIC_SYSTEM, DEVTOOL_COLOR_SEMANTIC_WARNING, DEVTOOL_COLOR_TEXT_EMPHASIS, DEVTOOL_COLOR_TEXT_FAINT, DEVTOOL_COLOR_TEXT_MUTED, DEVTOOL_COLOR_TEXT_SECONDARY, DEVTOOL_DETAIL_BASE_BACKGROUND, DEVTOOL_DETAIL_HEADER_BACKGROUND, DEVTOOL_ERROR_BACKGROUND, DEVTOOL_JSON_KEY, DEVTOOL_JSON_KEYWORD, DEVTOOL_JSON_NUMBER, DEVTOOL_JSON_PUNCTUATION, DEVTOOL_JSON_STRING, DEVTOOL_LIST_BASE_BACKGROUND, DEVTOOL_LIST_SELECTED_BACKGROUND, DEVTOOL_PANEL_BORDER, DEVTOOL_PANEL_DIVIDER_BORDER, DEVTOOL_SECTION_BACKGROUND, DEVTOOL_SECTION_STRING_BACKGROUND, DEVTOOL_TOOLTIP_BACKGROUND, DEVTOOL_TOOLTIP_BORDER, DEVTOOL_TOOLTIP_TITLE_BACKGROUND, DEVTOOL_TOOLTIP_TITLE_BOTTOM_BORDER, MONO_FONT, SANS_FONT, } from "nice-devtools-shared";
 export declare const DEVTOOL_COLOR_HANDLER_LOCAL_TEXT = "#34bb89";
 export declare const DEVTOOL_COLOR_HANDLER_LOCAL_BORDER = "#144427";
 export declare const DEVTOOL_COLOR_HANDLER_EXTERNAL_TEXT = "#cfa12a";
 export declare const DEVTOOL_COLOR_HANDLER_EXTERNAL_BORDER = "#723917";
-export declare const DEVTOOL_COLOR_TEXT_EMPHASIS = "#f1f5f9";
-export declare const DEVTOOL_COLOR_TEXT_SECONDARY = "#cbd5e1";
-export declare const DEVTOOL_COLOR_TEXT_MUTED = "#64748b";
-export declare const DEVTOOL_COLOR_TEXT_FAINT = "#334155";
-export declare const DEVTOOL_LIST_BASE_BACKGROUND = "#0f172a";
 export declare const DEVTOOL_LIST_HEADER_SELECTED_BACKGROUND = "#1d2942";
 export declare const DEVTOOL_LIST_GROUP_DIVIDER = "#101109";
-export declare const DEVTOOL_DETAIL_BASE_BACKGROUND = "#0d1729";
-export declare const DEVTOOL_DETAIL_HEADER_BACKGROUND = "#131f35";
-export declare const DEVTOOL_SECTION_BACKGROUND = "#1e293b";
-export declare const DEVTOOL_SECTION_STRING_BACKGROUND = "#0d131f";
 export declare const DEVTOOL_STACK_TRACE_BACKGROUND = "#040a13";
-export declare const DEVTOOL_PANEL_BORDER = "#1e293b";
-export declare const DEVTOOL_PANEL_DIVIDER_BORDER = "#1d3352";
-export declare const DEVTOOL_ERROR_BACKGROUND = "#1e0a0a";
 export declare const DEVTOOL_ERROR_BADGE_BACKGROUND = "#2d0f0f";
-export declare const DEVTOOL_TOOLTIP_BACKGROUND = "#0c1526";
-export declare const DEVTOOL_TOOLTIP_TITLE_BACKGROUND = "#101b2e";
-export declare const DEVTOOL_TOOLTIP_TITLE_BOTTOM_BORDER = "#211f5f";
-export declare const DEVTOOL_TOOLTIP_BORDER = "#312e81";
 export declare const DEVTOOL_COLOR_CALL_STACK_DIVIDER = "#0a1120";
-export declare const DEVTOOL_JSON_KEY = "#a5b4fc";
-export declare const DEVTOOL_JSON_STRING = "#fbbf24";
-export declare const DEVTOOL_JSON_NUMBER = "#34d399";
-export declare const DEVTOOL_JSON_KEYWORD = "#a78bfa";
-export declare const DEVTOOL_JSON_PUNCTUATION = "#475569";
 export declare const DEVTOOL_STACK_FRAME_USER_NUMBER = "#64748b";
 export declare const DEVTOOL_STACK_FRAME_USER_FUNCTION = "#e2e8f0";
 export declare const DEVTOOL_STACK_FRAME_USER_FOLDER = "#596b83";

package/build/types/index.d.ts

@@ -26,10 +26,14 @@ export { createActionFrameCrypto, type IActionFrameCrypto, type IActionFrameCryp
 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 { createSecureWebSocketTransport, defineSecureWsChannel, type ISecureWebSocketTransportOptions, type ISecureWsChannel, } from "./ActionRuntime/Handler/ExternalClient/Transport/WebSocket/secureWsChannel";
 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 { ActionServerHandler, createServerHandler, type IActionServerConnectionBinding, type IActionServerHandlerOptions, type TActionChannelFormatMessage, type TActionConnectionEncoding, type TServerConnectionCaseFn, } from "./ActionRuntime/Handler/Server/ActionServerHandler";
+export { createActionFetchHandler, type IActionFetchHandlerOptions, } from "./ActionRuntime/Handler/Server/createActionFetchHandler";
+export { createHibernatableWsServerAdapter, createSecureActionServerHandler, type IHibernatableWsServerAdapter, type IHibernatableWsServerAdapterOptions, type ISecureActionServerHandlerOptions, } from "./ActionRuntime/Handler/Server/createSecureActionServer";
+export { type IConnectionAttachment, type IWsConnectionStateStoreOptions, WsConnectionStateStore, } from "./ActionRuntime/Handler/Server/WsConnectionStateStore";
 export * from "./ActionRuntime/RuntimeCoordinate";
 export { EErrId_NiceAction, err_nice_action } from "./errors/err_nice_action";
 export { decodeActionFrame, type IActionFrameDecoder } from "./utils/decodeActionFrame";

package/package.json

@@ -1,28 +1,26 @@
 {
   "name": "@nice-code/action",
-  "version": "0.6.3",
-  "private": false,
-  "type": "module",
+  "version": "0.8.0",
   "exports": {
     ".": {
       "source": "./src/index.ts",
-      "types": "./build/types/index.d.ts",
-      "import": "./build/index.js"
-    },
-    "./react-query": {
-      "source": "./src/react-query/index.ts",
-      "types": "./build/types/react-query/index.d.ts",
-      "import": "./build/react-query/index.js"
+      "import": "./build/index.js",
+      "types": "./build/types/index.d.ts"
     },
     "./devtools/browser": {
       "source": "./src/devtools/browser/index.ts",
-      "types": "./build/types/devtools/browser/index.d.ts",
-      "import": "./build/devtools/browser/index.js"
+      "import": "./build/devtools/browser/index.js",
+      "types": "./build/types/devtools/browser/index.d.ts"
     },
     "./devtools/server": {
       "source": "./src/devtools/server/index.ts",
-      "types": "./build/types/devtools/server/index.d.ts",
-      "import": "./build/devtools/server/index.js"
+      "import": "./build/devtools/server/index.js",
+      "types": "./build/types/devtools/server/index.d.ts"
+    },
+    "./react-query": {
+      "source": "./src/react-query/index.ts",
+      "import": "./build/react-query/index.js",
+      "types": "./build/types/react-query/index.d.ts"
     }
   },
   "files": [
@@ -30,40 +28,46 @@
     "package.json",
     "README.md"
   ],
+  "peerDependencies": {
+    "@tanstack/react-query": "^5.100.3",
+    "react": ">=19",
+    "react-dom": ">=19",
+    "valibot": "^1.3.1"
+  },
+  "private": false,
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
+    "build": "bun run clean-build && bun run build.ts && bun run build-types",
+    "build-types": "tsc --project tsconfig.build.json",
+    "build-watch": "bun run clean-build && bun run build.ts --watch && bun run build-types --watch",
+    "clean-build": "bunx rimraf build",
     "type-check": "bunx tsc --noEmit",
     "type-check-watch": "bunx tsc --noEmit --watch",
-    "clean-build": "bunx rimraf build",
     "vitest": "vitest --typecheck",
-    "vitest-agent": "vitest --typecheck --reporter=agent",
-    "build": "bun run clean-build && bun run build.ts && bun run build-types",
-    "build-watch": "bun run clean-build && bun run build.ts --watch && bun run build-types --watch",
-    "build-types": "tsc --project tsconfig.build.json"
+    "vitest-agent": "vitest --typecheck --reporter=agent"
   },
+  "type": "module",
   "dependencies": {
-    "@nice-code/common-errors": "0.6.3",
-    "@nice-code/error": "0.6.3",
-    "@nice-code/util": "0.6.3",
+    "@nice-code/common-errors": "0.8.0",
+    "@nice-code/error": "0.8.0",
+    "@nice-code/util": "0.8.0",
     "@standard-schema/spec": "^1.1.0",
     "@tanstack/react-virtual": "^3.13.26",
     "http-status-codes": "^2.3.0",
     "lucide-react": "1.17.0",
+    "msgpackr": "2.0.4",
     "nanoid": "^5.1.9",
+    "nice-devtools-shared": "0.8.0",
     "source-map-js": "^1.2.1",
-    "std-env": "^4.1.0",
-    "msgpackr": "2.0.4"
+    "std-env": "^4.1.0"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.100.3",
     "@types/react": "^19.0.0",
-    "msw": "^2.13.6"
-  },
-  "peerDependencies": {
-    "@tanstack/react-query": "^5.100.3",
-    "react": ">=19",
+    "@types/react-dom": "^19.0.0",
+    "msw": "^2.13.6",
     "valibot": "^1.3.1"
   }
 }

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

@@ -1,41 +0,0 @@
-import type { TDevtoolsPosition } from "../../core/ActionDevtools.types";
-export interface IDevtoolsLauncherItem {
-    id: string;
-    label: string;
-    icon: string;
-    badge?: string;
-    onOpen: () => void;
-}
-export type TDockSide = "top" | "bottom" | "left" | "right";
-export declare function getDockSide(pos: TDevtoolsPosition): TDockSide;
-export declare function PanelHeader({ position, onPositionChange, onClose, onClear, openOthers, }: {
-    position: TDevtoolsPosition;
-    onPositionChange: (p: TDevtoolsPosition) => void;
-    onClose: () => void;
-    onClear?: () => void;
-    openOthers?: IDevtoolsLauncherItem[];
-}): import("react/jsx-runtime").JSX.Element;
-export declare function ResizeHandle({ dockSide, dockedSize, onChange, }: {
-    dockSide: TDockSide;
-    dockedSize: number;
-    onChange: (size: number) => void;
-}): import("react/jsx-runtime").JSX.Element;
-/**
- * Draggable divider between the list and the detail pane. `horizontal` refers to
- * the split axis: a row layout (dock top/bottom) splits horizontally and drags
- * left/right; a column layout (dock left/right) splits vertically. The reported
- * ratio is the fraction of the container the *detail* pane should occupy.
- */
-export declare function SplitHandle({ horizontal, onRatioChange, }: {
-    horizontal: boolean;
-    onRatioChange: (ratio: number) => void;
-}): import("react/jsx-runtime").JSX.Element;
-/**
- * The combined, page-wide launcher shown while every devtool is collapsed — one
- * grouped pill with a segment per registered devtool, so the buttons never
- * overlap or hide behind each other. Rendered by the coordinator's "primary"
- * devtool only.
- */
-export declare function DevtoolsLauncher({ items }: {
-    items: IDevtoolsLauncherItem[];
-}): import("react/jsx-runtime").JSX.Element;

package/build/types/devtools/browser/devtools_dock.d.ts

@@ -1,54 +0,0 @@
-export type TDockSide = "top" | "bottom" | "left" | "right";
-/** A handle to one registered devtool, used to render launch controls. */
-export interface IDockDevtoolRef {
-    id: string;
-    label: string;
-    icon: string;
-    badge?: string;
-    onOpen: () => void;
-}
-/** The live, syncable part of a devtool's registration. */
-export interface IDockDevtoolSync {
-    side: TDockSide;
-    size: number;
-    open: boolean;
-    badge?: string;
-}
-export interface IDockDevtoolInput extends IDockDevtoolSync {
-    id: string;
-    label: string;
-    icon: string;
-    onOpen: () => void;
-}
-export interface IDockView {
-    /** Offset (px) from the docked edge — stacks open panels on the same side. */
-    dockOffset: number;
-    /**
-     * True when this panel shares its dock side with another open panel (stacked
-     * either nearer or further from the edge). Stacked panels square off all their
-     * corners so they sit flush as one continuous block — only a panel alone on
-     * its side keeps its rounded, page-facing corners.
-     */
-    stacked: boolean;
-    /** Is any devtool on the page currently open? */
-    anyOpen: boolean;
-    /** First-registered devtool — the one that renders the combined launcher. */
-    isPrimary: boolean;
-    /** Every registered devtool, for the combined launcher. */
-    devtools: IDockDevtoolRef[];
-    /** Closed devtools other than this one, for an open panel's header. */
-    otherClosed: IDockDevtoolRef[];
-}
-export interface IDevtoolsDockCoordinator {
-    version: number;
-    register(panel: IDockDevtoolInput): () => void;
-    update(id: string, next: IDockDevtoolSync): void;
-    getView(id: string): IDockView;
-    subscribe(listener: () => void): () => void;
-}
-/**
- * Returns the page-wide dock coordinator, installing it on `window` the first
- * time it is requested. On the server (no `window`) a throwaway instance is
- * returned so callers can use it unconditionally.
- */
-export declare function getDevtoolsDockCoordinator(): IDevtoolsDockCoordinator;