@nice-code/action 0.2.10 → 0.2.12

package/build/react-query/index.js

@@ -1,3 +1,43 @@
-// src/react-query/index.ts
-export * from "./hooks/useActionMutation";
-export * from "./hooks/useActionQuery";
+// src/react-query/hooks/useActionMutation.ts
+import {
+  useMutation
+} from "@tanstack/react-query";
+function useActionMutation(action, options) {
+  const mutationOptions = options ?? {};
+  return useMutation({
+    mutationFn: (input) => action.request(input).runToOutput(),
+    ...mutationOptions
+  });
+}
+// src/react-query/hooks/useActionQuery.ts
+import {
+  useQuery
+} from "@tanstack/react-query";
+function actionQueryKey(action, input) {
+  if (input === undefined) {
+    return ["nice-action", action.domain, action.allDomains, action.id];
+  }
+  return ["nice-action", action.domain, action.allDomains, action.id, input];
+}
+function useActionQuery(action, ...args) {
+  const hasInputSchema = action.schema.inputSchema != null;
+  let input;
+  let options;
+  if (hasInputSchema) {
+    [input, options] = args;
+  } else {
+    [options] = args;
+  }
+  const { enabled, ...queryOptions } = options ?? {};
+  return useQuery({
+    queryKey: input != null ? actionQueryKey(action, input) : actionQueryKey(action),
+    queryFn: () => action.request(input).runToOutput(),
+    enabled: hasInputSchema ? input != null && (enabled ?? true) : enabled ?? true,
+    ...queryOptions
+  });
+}
+export {
+  useActionQuery,
+  useActionMutation,
+  actionQueryKey
+};

package/build/types/ActionRuntime/ActionRuntime.d.ts

@@ -5,7 +5,7 @@ import type { IActionDomain } from "../ActionDefinition/Domain/ActionDomain.type
 import type { IRuntimeMeta, TActionRuntimeHandler } from "./ActionRuntime.types";
 import { type IHandleActionOptions, type TActionHandler } from "./Handler/ActionHandler.types";
 import type { ActionExternalClientHandler } from "./Handler/ExternalClient/ActionExternalClientHandler";
-import { RuntimeCoordinate } from "./RuntimeCoordinate";
+import { type IRuntimeCoordinateSpecifics, RuntimeCoordinate } from "./RuntimeCoordinate";
 export declare class ActionRuntime {
     private _coordinate;
     readonly timeCreated: number;
@@ -17,7 +17,9 @@ export declare class ActionRuntime {
     static getDefault(): ActionRuntime;
     constructor(coordinate: RuntimeCoordinate);
     get coordinate(): RuntimeCoordinate;
-    updateRuntimeCoordinate(newCoordinate: RuntimeCoordinate): void;
+    specifyRuntimeCoordinate(specifics: IRuntimeCoordinateSpecifics & {
+        envId?: string;
+    }): void;
     registerRunningAction(ra: RunningAction<any, any>): void;
     resolveIncomingActionPayload(json: TActionPayload_Any_JsonObject<any, any>): void;
     /**

package/build/types/ActionRuntime/RuntimeCoordinate.d.ts

@@ -1,8 +1,4 @@
-export interface IRuntimeCoordinate {
-    /**
-     * A static runtime environment identifier (e.g. "web_app_v1", "backend_analytics")
-     */
-    envId: string;
+export interface IRuntimeCoordinateSpecifics {
     /**
      * A unique and persistent client ID (should stay the same between runtime instance reloads)
      */
@@ -13,6 +9,12 @@ export interface IRuntimeCoordinate {
      */
     insId?: string;
 }
+export interface IRuntimeCoordinate extends IRuntimeCoordinateSpecifics {
+    /**
+     * A static runtime environment identifier (e.g. "web_app_v1", "backend_analytics")
+     */
+    envId: string;
+}
 export type TRuntimeCoordinateEnvId = `envId[${string}]`;
 export type TRuntimeCoordinateStringId = `${TRuntimeCoordinateEnvId}perId[${string | "_"}]:insId[${string | "_"}]`;
 export interface IRuntimeFullCoordinates extends Required<IRuntimeCoordinate> {
@@ -25,8 +27,8 @@ export declare class RuntimeCoordinate implements IRuntimeCoordinate {
     static env(envId: string): RuntimeCoordinate;
     withPersistentId(perId: string): RuntimeCoordinate;
     constructor({ envId, perId, insId }: IRuntimeCoordinate);
-    specify(newInputs: Omit<IRuntimeCoordinate, "envId">): RuntimeCoordinate;
-    specifyIfUnset(newInputs: Omit<IRuntimeCoordinate, "envId">): RuntimeCoordinate;
+    specify(specifics: IRuntimeCoordinateSpecifics): RuntimeCoordinate;
+    specifyIfUnset(specifics: IRuntimeCoordinateSpecifics): RuntimeCoordinate;
     toJsonObject(): IRuntimeCoordinate;
     isExactlySame(other: IRuntimeCoordinate): boolean;
     isSameFor(other: IRuntimeCoordinate): {

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

@@ -0,0 +1,8 @@
+import type { TDevtoolsPosition } from "../core/ActionDevtools.types";
+import type { ActionDevtoolsCore } from "../core/ActionDevtoolsCore";
+export interface INiceActionDevtoolsProps {
+    core: ActionDevtoolsCore;
+    position?: TDevtoolsPosition;
+    initialOpen?: boolean;
+}
+export declare function NiceActionDevtools(props: INiceActionDevtoolsProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,3 @@
+export type { IDevtoolsActionEntry, IDevtoolsObservableDomain, TDevtoolsActionStatus, TDevtoolsListener, } from "../core/ActionDevtools.types";
+export { ActionDevtoolsCore, type IActionDevtoolsCoreOptions } from "../core/ActionDevtoolsCore";
+export { type INiceActionDevtoolsProps, NiceActionDevtools } from "./NiceActionDevtools";

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

@@ -0,0 +1,47 @@
+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;
+}
+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,16 @@
+import type { IDevtoolsActionEntry, IDevtoolsObservableDomain, TDevtoolsListener } from "./ActionDevtools.types";
+export interface IActionDevtoolsCoreOptions {
+    maxEntries?: number;
+}
+export declare class ActionDevtoolsCore {
+    private _entries;
+    private _listeners;
+    private readonly _maxEntries;
+    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.10",
+  "version": "0.2.12",
   "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.10",
-    "@nice-code/common-errors": "0.2.10",
+    "@nice-code/common-errors": "0.2.12",
+    "@nice-code/error": "0.2.12",
     "@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": {