@nice-code/action 0.4.5 → 0.4.6

package/build/devtools/browser/index.js

@@ -4502,6 +4502,7 @@ var ActionInputAndOutputChip = ({
 
 // src/devtools/browser/components/action_list/ActionEntryRow.tsx
 import { jsxDEV as jsxDEV19, Fragment as Fragment10 } from "react/jsx-dev-runtime";
+var MAX_GROUP_DOTS = 5;
 function getLatestChipColor(status) {
   if (status === "failed")
     return "failed" /* failed */;
@@ -4822,15 +4823,29 @@ function ActionEntryRow({
           paddingLeft: "4.6em",
           paddingBottom: "2px"
         },
-        children: groupEntries.map((e, i) => /* @__PURE__ */ jsxDEV19(GroupDot, {
-          entry: e,
-          index: i,
-          total: groupEntries.length,
-          refTime: groupEntries[0].startTime,
-          isActive: selectedGroupCuid === e.cuid,
-          onSelect: () => onSelectGroupEntry?.(e.cuid)
-        }, e.cuid, false, undefined, this))
-      }, undefined, false, undefined, this)
+        children: [
+          groupEntries.slice(0, MAX_GROUP_DOTS).map((e, i) => /* @__PURE__ */ jsxDEV19(GroupDot, {
+            entry: e,
+            index: i,
+            total: groupEntries.length,
+            refTime: groupEntries[0].startTime,
+            isActive: selectedGroupCuid === e.cuid,
+            onSelect: () => onSelectGroupEntry?.(e.cuid)
+          }, e.cuid, false, undefined, this)),
+          groupEntries.length > MAX_GROUP_DOTS && /* @__PURE__ */ jsxDEV19("span", {
+            style: {
+              fontSize: "0.7em",
+              opacity: 0.5,
+              flexShrink: 0,
+              lineHeight: 1
+            },
+            children: [
+              "+ ",
+              groupEntries.length - MAX_GROUP_DOTS
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
     ]
   }, undefined, true, undefined, this);
 }

package/build/index.js

@@ -1993,7 +1993,7 @@ class ActionExternalClientHandler extends ActionHandler {
       client: this.externalClient,
       transOrd: transport.transOrd,
       transType: transport.type,
-      transInfo: transport.definition?.getRouteInfo(input)
+      transInfo: transport.getRouteInfo(input)
     };
   }
   clearTransportCache() {
@@ -2053,6 +2053,9 @@ class TransportConnection {
     this.type = def.type;
     this.initialized = def.initialize();
   }
+  getRouteInfo(input) {
+    return this.definition?.getRouteInfo(input);
+  }
   _getCacheKey(input) {
     const parts = this.initialized.getTransportCacheKey?.(input);
     if (parts == null)
@@ -2339,10 +2342,21 @@ var createUnsetTransportResolvers = (type) => ({
   }
 });
 
+// src/ActionRuntime/Handler/ExternalClient/Transport/WebSocket/ws_util.ts
+function shortWs(url) {
+  try {
+    const u = new URL(url);
+    return `${u.host}${u.pathname}`;
+  } catch {
+    return url;
+  }
+}
+
 // src/ActionRuntime/Handler/ExternalClient/Transport/WebSocket/WebSocketConnection.ts
 class WebSocketConnection extends TransportConnection {
   resolvers;
   _abortSet = new Set;
+  _liveSocketUrl;
   constructor(def, resolvers) {
     super({ ...def, type: "ws" /* ws */ });
     this.resolvers = resolvers ?? createUnsetTransportResolvers("ws" /* ws */);
@@ -2403,9 +2417,22 @@ class WebSocketConnection extends TransportConnection {
       readyData: this._finalizeTransportMethods(transportStatusInfo.readyData)
     };
   }
+  getRouteInfo(input) {
+    const base = this.definition?.getRouteInfo(input);
+    if (base?.url != null || this._liveSocketUrl == null)
+      return base;
+    return {
+      type: "ws" /* ws */,
+      ...base,
+      url: this._liveSocketUrl,
+      summary: `ws ${shortWs(this._liveSocketUrl)}`
+    };
+  }
   _finalizeTransportMethods(wsData) {
     const ws = wsData.ws;
     const disconnectListeners = [];
+    if (ws.url != null && ws.url !== "")
+      this._liveSocketUrl = ws.url;
     const sendActionData = (inputs) => {
       const { action, runningAction, timeout } = inputs;
       if (action.type === "request" /* request */) {
@@ -2478,14 +2505,6 @@ class WebSocketConnection extends TransportConnection {
 function resolveMaybe2(value, input) {
   return typeof value === "function" ? value(input) : value;
 }
-function shortWs(url) {
-  try {
-    const u = new URL(url);
-    return `${u.host}${u.pathname}`;
-  } catch {
-    return url;
-  }
-}
 
 class WebSocketTransport extends Transport {
   options;
@@ -2497,29 +2516,35 @@ class WebSocketTransport extends Transport {
   _createSocket(input) {
     if (this.options.createWebSocket != null)
       return this.options.createWebSocket(input);
+    if (this.options.url == null) {
+      throw new Error("WebSocketTransport requires `url` or `createWebSocket` when not using `getTransport`.");
+    }
     return new WebSocket(resolveMaybe2(this.options.url, input));
   }
   _createConnection(ctx) {
+    const { url, getTransportCacheKey, getTransport } = this.options;
     return new WebSocketConnection({
       initialize: () => ({
-        getTransportCacheKey: this.options.getTransportCacheKey ?? ((input) => [resolveMaybe2(this.options.url, input)]),
-        getTransport: (input) => ({
+        getTransportCacheKey: getTransportCacheKey ?? (url != null ? (input) => [resolveMaybe2(url, input)] : undefined),
+        getTransport: getTransport ?? ((input) => ({
           status: "ready" /* ready */,
           readyData: {
             ws: this._createSocket(input),
             formatMessage: this.options.formatMessage,
             updateRunConfig: this.options.updateRunConfig
           }
-        })
+        }))
       })
     }, ctx.resolvers);
   }
   getRouteInfo(input) {
-    const url = resolveMaybe2(this.options.url, input);
+    if (this.options.getRouteInfo != null)
+      return this.options.getRouteInfo(input);
+    const url = this.options.url != null ? resolveMaybe2(this.options.url, input) : undefined;
     return {
       type: "ws" /* ws */,
       url,
-      summary: `ws ${shortWs(url)}`
+      summary: url != null ? `ws ${shortWs(url)}` : "ws"
     };
   }
 }

package/build/types/ActionRuntime/Handler/ExternalClient/Transport/Custom/CustomConnection.d.ts

@@ -1,5 +1,5 @@
-import { TransportConnection } from "../TransportConnection";
 import { ETransportType, type IActionTransportReadyData_Methods, type ITransportRouteActionParams } from "../Transport.types";
+import { TransportConnection } from "../TransportConnection";
 import type { IActionTransportDef_Custom, IActionTransportInitialized_Custom, IActionTransportReadyData_Custom, TActionTransportDef_Custom_NoType } from "./TransportCustom.types";
 export declare class CustomConnection extends TransportConnection<ETransportType.custom, ITransportRouteActionParams, IActionTransportReadyData_Custom, IActionTransportInitialized_Custom, IActionTransportDef_Custom> {
     constructor(def: TActionTransportDef_Custom_NoType);

package/build/types/ActionRuntime/Handler/ExternalClient/Transport/Custom/CustomTransport.d.ts

@@ -1,4 +1,4 @@
-import { Transport, type ITransportConnectionContext } from "../Transport";
+import { type ITransportConnectionContext, Transport } from "../Transport";
 import { ETransportType, type ITransportMethod_SendActionData_Input, type ITransportRouteActionParams, type ITransportRouteInfo, type TSendReturnDataMethod, type TUpdateActionRunConfig } from "../Transport.types";
 import { CustomConnection } from "./CustomConnection";
 import type { IActionTransportInitialized_Custom } from "./TransportCustom.types";

package/build/types/ActionRuntime/Handler/ExternalClient/Transport/Http/HttpConnection.d.ts

@@ -1,5 +1,5 @@
-import { TransportConnection } from "../TransportConnection";
 import { ETransportType, type IActionTransportReadyData_Methods, type ITransportDispatchAction, type ITransportRouteActionParams } from "../Transport.types";
+import { TransportConnection } from "../TransportConnection";
 import type { IActionTransportDef_Http, IActionTransportInitialized_Http, IActionTransportReadyData_Http, IActionTransportReadyParams_Http } from "./TransportHttp.types";
 export declare class HttpConnection extends TransportConnection<ETransportType.http, ITransportRouteActionParams, IActionTransportReadyData_Http, IActionTransportInitialized_Http, IActionTransportDef_Http> {
     constructor(def: Omit<IActionTransportDef_Http, "type">);

package/build/types/ActionRuntime/Handler/ExternalClient/Transport/Http/HttpTransport.d.ts

@@ -1,4 +1,4 @@
-import { Transport, type ITransportConnectionContext } from "../Transport";
+import { type ITransportConnectionContext, Transport } from "../Transport";
 import { ETransportType, type ITransportRouteActionParams, type ITransportRouteInfo, type TUpdateActionRunConfig } from "../Transport.types";
 import { HttpConnection } from "./HttpConnection";
 import type { IHttpRequestParams } from "./TransportHttp.types";

package/build/types/ActionRuntime/Handler/ExternalClient/Transport/TransportConnection.d.ts

@@ -1,5 +1,5 @@
 import type { Transport } from "./Transport";
-import { type ETransportType, type IActionTransportDef, type IActionTransportInitialized, type IActionTransportReadyData_Base, type IActionTransportReadyData_Methods, type ITransportRouteActionParams, type TTransportStatusInfo } from "./Transport.types";
+import { type ETransportType, type IActionTransportDef, type IActionTransportInitialized, type IActionTransportReadyData_Base, type IActionTransportReadyData_Methods, type ITransportRouteActionParams, type ITransportRouteInfo, type TTransportStatusInfo } from "./Transport.types";
 /**
  * Live, per-handler transport runtime built from a reusable {@link Transport} definition. Holds the
  * connection-scoped state (ordinal, initialized config, sockets / abort sets) that must not be shared
@@ -13,6 +13,12 @@ export declare abstract class TransportConnection<T extends ETransportType = ETr
     /** Backref to the public definition that created this connection (used for devtools route info). */
     definition?: Transport<T>;
     constructor(def: DEF);
+    /**
+     * Devtools route info for an action routed through this live connection. Defaults to the stateless
+     * {@link definition}'s info; connections override to enrich it from live state (e.g. the actual
+     * resolved socket URL) when the definition couldn't resolve it on its own.
+     */
+    getRouteInfo(input: RP): ITransportRouteInfo | undefined;
     protected abstract _finalizeTransportMethods(inputs: RD): IActionTransportReadyData_Methods;
     protected _getCacheKey(input: RP): string | null;
     getCacheKey(input: RP): string | null;

package/build/types/ActionRuntime/Handler/ExternalClient/Transport/WebSocket/WebSocketConnection.d.ts

@@ -1,12 +1,15 @@
+import { ETransportType, type IActionTransportReadyData_Methods, type IActionTransportResolvers, type ITransportRouteActionParams, type ITransportRouteInfo, type TTransportStatusInfo } from "../Transport.types";
 import { TransportConnection } from "../TransportConnection";
-import { ETransportType, type IActionTransportReadyData_Methods, type IActionTransportResolvers, type ITransportRouteActionParams, type TTransportStatusInfo } from "../Transport.types";
 import type { IActionTransportDef_Ws, IActionTransportInitialized_Ws, IActionTransportReadyData_Ws } from "./TransportWebSocket.types";
 export declare class WebSocketConnection extends TransportConnection<ETransportType.ws, ITransportRouteActionParams, IActionTransportReadyData_Ws, IActionTransportInitialized_Ws, IActionTransportDef_Ws> {
     private resolvers;
     private _abortSet;
+    /** URL of the most recently resolved live socket — surfaced to devtools when the definition can't. */
+    private _liveSocketUrl?;
     constructor(def: Omit<IActionTransportDef_Ws, "type">, resolvers?: IActionTransportResolvers);
     protected _getCacheKey(_input: ITransportRouteActionParams): string;
     protected _processTransportStatus(input: ITransportRouteActionParams): TTransportStatusInfo<IActionTransportReadyData_Methods>;
+    getRouteInfo(input: ITransportRouteActionParams): ITransportRouteInfo | undefined;
     _finalizeTransportMethods(wsData: IActionTransportReadyData_Ws): IActionTransportReadyData_Methods;
     private _parseActionMessage;
     private _abortAll;

package/build/types/ActionRuntime/Handler/ExternalClient/Transport/WebSocket/WebSocketTransport.d.ts

@@ -1,11 +1,11 @@
-import { Transport, type ITransportConnectionContext } from "../Transport";
+import { type ITransportConnectionContext, Transport } from "../Transport";
 import { ETransportType, type ITransportRouteActionParams, type ITransportRouteInfo, type TUpdateActionRunConfig } from "../Transport.types";
-import type { IActionTransportReadyData_Ws } from "./TransportWebSocket.types";
+import type { IActionTransportInitialized_Ws, IActionTransportReadyData_Ws } from "./TransportWebSocket.types";
 import { WebSocketConnection } from "./WebSocketConnection";
 type TMaybeResolved<T> = T | ((input: ITransportRouteActionParams) => T);
 export interface IWebSocketTransportOptions {
-    /** WebSocket endpoint URL, either static or derived per action. */
-    url: TMaybeResolved<string>;
+    /** WebSocket endpoint URL, either static or derived per action. Optional when `getTransport` is used. */
+    url?: TMaybeResolved<string>;
     /** Advanced escape hatch — provide your own socket (e.g. with sub-protocols). Overrides `url`. */
     createWebSocket?: (input: ITransportRouteActionParams) => WebSocket;
     /** Custom (de)serialization of action payloads on the wire. */
@@ -16,6 +16,15 @@ export interface IWebSocketTransportOptions {
      * across actions to the same endpoint instead of opening one per action.
      */
     getTransportCacheKey?: (input: ITransportRouteActionParams) => string[];
+    /**
+     * Advanced escape hatch — full control over readiness/initialization. Use this for contextual
+     * support detection (return `{ status: ETransportStatus.unsupported }` when the socket shouldn't be
+     * used) or async URL building (return `{ status: ETransportStatus.initializing, initializationPromise }`
+     * that resolves to a `ready` socket). When provided, `url` / `createWebSocket` are ignored.
+     */
+    getTransport?: IActionTransportInitialized_Ws["getTransport"];
+    /** Override the devtools route info for a specific action (useful alongside `getTransport`). */
+    getRouteInfo?: (input: ITransportRouteActionParams) => ITransportRouteInfo;
 }
 /**
  * Reusable WebSocket transport definition. Common case is just `new WebSocketTransport({ url })`. The

package/build/types/ActionRuntime/Handler/ExternalClient/Transport/WebSocket/ws_util.d.ts

@@ -0,0 +1,2 @@
+/** Compact a WebSocket URL to `host/pathname` for devtools display, falling back to the raw url. */
+export declare function shortWs(url: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nice-code/action",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "private": false,
   "type": "module",
   "exports": {
@@ -44,9 +44,9 @@
     "build-types": "tsc --project tsconfig.build.json"
   },
   "dependencies": {
-    "@nice-code/common-errors": "0.4.5",
-    "@nice-code/error": "0.4.5",
-    "@nice-code/util": "0.4.5",
+    "@nice-code/common-errors": "0.4.6",
+    "@nice-code/error": "0.4.6",
+    "@nice-code/util": "0.4.6",
     "@standard-schema/spec": "^1.1.0",
     "@tanstack/react-virtual": "^3.13.26",
     "http-status-codes": "^2.3.0",