@nice-code/action 0.2.11 → 0.2.13

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

@@ -0,0 +1,50 @@
+import type { TActionProgress } from "../../ActionDefinition/Action/Payload/ActionPayload.types";
+export type TDevtoolsActionStatus = "running" | "success" | "failed" | "aborted";
+export type TDevtoolsPosition = "bottom-right" | "bottom-left" | "top-right" | "top-left" | "dock-bottom" | "dock-top" | "dock-left" | "dock-right";
+export interface IDevtoolsRouteItem {
+    runtime: {
+        envId: string;
+        perId?: string;
+        insId?: string;
+    };
+    handlerType: "local" | "external";
+    handlerClient?: {
+        envId: string;
+        perId?: string;
+        insId?: string;
+    };
+    transport?: string;
+    time: number;
+}
+export interface IDevtoolsActionMeta {
+    timeCreated: number;
+    originClient: {
+        envId: string;
+        perId?: string;
+        insId?: string;
+    };
+    routing: IDevtoolsRouteItem[];
+}
+export interface IDevtoolsActionEntry {
+    cuid: string;
+    actionId: string;
+    domain: string;
+    allDomains: string[];
+    status: TDevtoolsActionStatus;
+    startTime: number;
+    endTime?: number;
+    input: unknown;
+    output?: unknown;
+    error?: unknown;
+    abortReason?: unknown;
+    progressUpdates: TActionProgress[];
+    meta: IDevtoolsActionMeta;
+    parentCuid?: string;
+    callSite?: string;
+    errorStack?: string;
+}
+export type TDevtoolsListener = (entries: readonly IDevtoolsActionEntry[]) => void;
+export interface IDevtoolsObservableDomain {
+    domain: string;
+    addActionListener(listener: (update: any) => void): () => void;
+}

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

@@ -0,0 +1,14 @@
+import type { IDevtoolsActionEntry, IDevtoolsObservableDomain, TDevtoolsListener } from "./ActionDevtools.types";
+export interface IActionDevtoolsCoreOptions {
+}
+export declare class ActionDevtoolsCore {
+    private _entries;
+    private _listeners;
+    constructor(_options?: IActionDevtoolsCoreOptions);
+    attachToDomain(domain: IDevtoolsObservableDomain): () => void;
+    getEntries(): readonly IDevtoolsActionEntry[];
+    subscribe(listener: TDevtoolsListener): () => void;
+    clear(): void;
+    private _updateEntry;
+    private _notify;
+}

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

@@ -0,0 +1,30 @@
+import type { IDevtoolsObservableDomain } from "../core/ActionDevtools.types";
+export type TServerDevtoolsLogFn = (message: string, data?: Record<string, unknown>) => void;
+export interface IActionServerDevtoolsOptions {
+    /**
+     * Custom logger function. Defaults to console.log / console.error.
+     */
+    logger?: TServerDevtoolsLogFn;
+    /**
+     * Output format.
+     * - "pretty": human-readable lines (default)
+     * - "json": newline-delimited JSON for log aggregators
+     */
+    format?: "pretty" | "json";
+    /**
+     * Whether to log action input/output payloads.
+     * Disable if payloads may contain sensitive data. Defaults to true.
+     */
+    logPayloads?: boolean;
+    /**
+     * Whether devtools are active. Defaults to process.env.NODE_ENV !== "production".
+     */
+    enabled?: boolean;
+}
+export declare class ActionServerDevtools {
+    private readonly _options;
+    private readonly _inFlight;
+    constructor(options?: IActionServerDevtoolsOptions);
+    attachToDomain(domain: IDevtoolsObservableDomain): () => void;
+    private _log;
+}

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

@@ -0,0 +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";

package/build/types/index.d.ts

@@ -24,7 +24,7 @@ export type { TActionTransportDef } from "./ActionRuntime/Handler/ExternalClient
 export * from "./ActionRuntime/Handler/ExternalClient/Transport/Transport.types";
 export * from "./ActionRuntime/Handler/ExternalClient/Transport/WebSocket/TransportWebSocket";
 export { ActionLocalHandler, createLocalHandler, } from "./ActionRuntime/Handler/Local/ActionLocalHandler";
-export { type IRuntimeCoordinate, RuntimeCoordinate, } from "./ActionRuntime/RuntimeCoordinate";
+export * from "./ActionRuntime/RuntimeCoordinate";
 export { EErrId_NiceAction, err_nice_action } from "./errors/err_nice_action";
 export { isActionPayload_Any_JsonObject } from "./utils/isActionPayload_Any_JsonObject";
 export * from "./utils/isActionPayload_Request_JsonObject";

package/package.json

@@ -1,16 +1,28 @@
 {
   "name": "@nice-code/action",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "private": false,
   "type": "module",
   "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"
+    },
+    "./devtools/browser": {
+      "source": "./src/devtools/browser/index.ts",
+      "types": "./build/types/devtools/browser/index.d.ts",
+      "import": "./build/devtools/browser/index.js"
+    },
+    "./devtools/server": {
+      "source": "./src/devtools/server/index.ts",
+      "types": "./build/types/devtools/server/index.d.ts",
+      "import": "./build/devtools/server/index.js"
     }
   },
   "files": [
@@ -32,15 +44,17 @@
     "build-types": "tsc --project tsconfig.build.json"
   },
   "dependencies": {
-    "@nice-code/error": "0.2.11",
-    "@nice-code/common-errors": "0.2.11",
+    "@nice-code/common-errors": "0.2.13",
+    "@nice-code/error": "0.2.13",
     "@standard-schema/spec": "^1.1.0",
+    "@tanstack/react-virtual": "^3.13.26",
     "http-status-codes": "^2.3.0",
     "nanoid": "^5.1.9",
     "std-env": "^4.1.0"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.100.3",
+    "@types/react": "^19.0.0",
     "msw": "^2.13.6"
   },
   "peerDependencies": {