@nice-code/action 0.2.2 → 0.2.4

package/build/react-query/index.js

@@ -3108,23 +3108,23 @@ function useActionMutation(action, options) {
   });
 }
 // src/react-query/hooks/useActionQuery.ts
-function niceActionQueryKey(action, input) {
+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 useNiceQuery(action, input, options) {
+function useActionQuery(action, input, options) {
   const { enabled, ...queryOptions2 } = options ?? {};
   return useQuery({
-    queryKey: input != null ? niceActionQueryKey(action, input) : niceActionQueryKey(action),
+    queryKey: input != null ? actionQueryKey(action, input) : actionQueryKey(action),
     queryFn: () => action.request(input).runToOutput(),
     enabled: input != null && (enabled ?? true),
     ...queryOptions2
   });
 }
 export {
-  useNiceQuery,
+  useActionQuery,
   useActionMutation,
-  niceActionQueryKey
+  actionQueryKey
 };

package/build/types/ActionDefinition/Action/Context/ActionContext.d.ts

@@ -1,4 +1,4 @@
-import { ActionClientSpecifier } from "../../../ActionRuntime/Client/ActionClientSpecifier";
+import { RuntimeCoordinate } from "../../../ActionRuntime/RuntimeCoordinate";
 import type { ActionDomain } from "../../Domain/ActionDomain";
 import type { IActionDomain, TInferInputFromSchema, TInferOutputFromSchema } from "../../Domain/ActionDomain.types";
 import { ActionBase } from "../ActionBase";
@@ -10,9 +10,9 @@ export declare class ActionContext<DOM extends IActionDomain, ID extends keyof D
     readonly _routing: IActionRouteItem[];
     readonly timeCreated: number;
     readonly cuid: string;
-    originClient: ActionClientSpecifier;
+    originClient: RuntimeCoordinate;
     constructor(_domain: ActionDomain<DOM>, id: ID, hydrationData: IActionContext_Data);
-    _setOriginClient(client: ActionClientSpecifier): void;
+    _setOriginClient(client: RuntimeCoordinate): void;
     toJsonString(): string;
     toContextDataJsonObject(): IActionContext_Data_JsonObject;
     toJsonObject(): IActionContext_JsonObject<DOM, ID>;

package/build/types/ActionDefinition/Action/Context/ActionContext.types.d.ts

@@ -1,9 +1,9 @@
-import type { ActionClientSpecifier, IActionClientSpecifier } from "../../../ActionRuntime/Client/ActionClientSpecifier";
+import type { IRuntimeCoordinate, RuntimeCoordinate } from "../../../ActionRuntime/RuntimeCoordinate";
 import type { IActionDomain } from "../../Domain/ActionDomain.types";
 import type { EActionForm, IActionBase, IActionBase_JsonObject } from "../ActionBase.types";
 import type { IActionRouteItemHandler } from "../Payload/ActionPayload.types";
 export interface IActionRouteItem {
-    runtime: ActionClientSpecifier;
+    runtime: RuntimeCoordinate;
     handler: IActionRouteItemHandler;
     time: number;
 }
@@ -11,7 +11,7 @@ export interface IActionContext_Data {
     cuid: string;
     timeCreated: number;
     routing: IActionRouteItem[];
-    originClient: ActionClientSpecifier;
+    originClient: RuntimeCoordinate;
 }
 export interface IActionContext<DOM extends IActionDomain, ID extends keyof DOM["actionSchema"] & string = keyof DOM["actionSchema"] & string> extends IActionBase<EActionForm.context, DOM, ID>, IActionContext_Data {
 }
@@ -21,7 +21,7 @@ export interface IActionContext<DOM extends IActionDomain, ID extends keyof DOM[
  *
  */
 export interface IActionRouteItem_JsonObject {
-    runtime: IActionClientSpecifier;
+    runtime: IRuntimeCoordinate;
     handler: IActionRouteItemHandler;
     time: number;
 }
@@ -29,7 +29,7 @@ export interface IActionContext_Data_JsonObject {
     cuid: string;
     timeCreated: number;
     routing: IActionRouteItem_JsonObject[];
-    originClient: IActionClientSpecifier;
+    originClient: IRuntimeCoordinate;
 }
 export interface IActionContext_JsonObject<DOM extends IActionDomain = IActionDomain, ID extends keyof DOM["actionSchema"] & string = keyof DOM["actionSchema"] & string> extends IActionBase_JsonObject<EActionForm.context, DOM, ID>, IActionContext_Data_JsonObject {
 }

package/build/types/ActionDefinition/Action/Core/ActionCore.d.ts

@@ -11,7 +11,7 @@ export declare class ActionCore<DOM extends IActionDomain, ID extends keyof DOM[
     constructor(_domain: ActionDomain<DOM>, id: ID);
     is<ACT extends IActionBase<any, any, any>>(action: ACT | unknown | null | undefined): action is TNarrowActionType<DOM, ACT, ID>;
     toJsonObject(): IActionBase_JsonObject<EActionForm.core, DOM, ID>;
-    request(input: TInferInputFromSchema<DOM["actionSchema"][ID]>["Input"]): ActionPayload_Request<DOM, ID>;
+    request(...args: [TInferInputFromSchema<DOM["actionSchema"][ID]>["Input"]] extends [never] ? [input?: never] : [input: TInferInputFromSchema<DOM["actionSchema"][ID]>["Input"]]): ActionPayload_Request<DOM, ID>;
     deserializeInput(serialized: TInferInputFromSchema<DOM["actionSchema"][ID]>["SerdeInput"]): TInferInputFromSchema<DOM["actionSchema"][ID]>["Input"];
     serializeInput(raw: TInferInputFromSchema<DOM["actionSchema"][ID]>["Input"]): TInferInputFromSchema<DOM["actionSchema"][ID]>["SerdeInput"];
     validateInput(input: unknown): TInferInputFromSchema<DOM["actionSchema"][ID]>["Input"];

package/build/types/ActionDefinition/Domain/ActionDomain.d.ts

@@ -1,4 +1,5 @@
 import type { IExecuteActionOptions } from "../../ActionRuntime/Handler/ActionHandler.types";
+import { ActionLocalHandler } from "../../ActionRuntime/Handler/Local/ActionLocalHandler";
 import type { TAction_Any_JsonObject, TDistributeActionPayload_Request, TDistributeActionPayload_Result, TDistributedDomainActions, TNarrowActionJsonTypeToActionInstanceType } from "../Action/Action.combined.types";
 import { type IActionBase } from "../Action/ActionBase.types";
 import { ActionContext } from "../Action/Context/ActionContext";
@@ -7,7 +8,7 @@ import { ActionCore } from "../Action/Core/ActionCore";
 import { type IActionPayload_Request_JsonObject, type IActionPayload_Result_JsonObject } from "../Action/Payload/ActionPayload.types";
 import { ActionPayload_Request } from "../Action/Payload/ActionPayload_Request";
 import type { RunningAction } from "../Action/RunningAction";
-import type { IActionDomain, IActionDomainChildOptions, TActionDomainChildDef } from "./ActionDomain.types";
+import type { IActionDomain, IActionDomainChildOptions, TActionDomainChildDef, TWrappableDomainActionHandler } from "./ActionDomain.types";
 import { ActionDomainBase } from "./ActionDomainBase";
 import { type ActionRootDomain } from "./ActionRootDomain";
 type TActionMap<ACT_DOM extends IActionDomain> = {
@@ -26,6 +27,7 @@ export declare class ActionDomain<ACT_DOM extends IActionDomain = IActionDomain>
     get action(): TActionMap<ACT_DOM>;
     actionsMap(): TActionMap<ACT_DOM>;
     actionForId<ID extends keyof ACT_DOM["actionSchema"] & string>(id: ID): ActionCore<ACT_DOM, ID>;
+    wrapAsLocalHandler(wrappedActionExecutor: TWrappableDomainActionHandler<ACT_DOM>): ActionLocalHandler;
     hydrateContext<ID extends keyof ACT_DOM["actionSchema"] & string>(id: ID, contextData: IActionContext_Data_JsonObject): ActionContext<ACT_DOM, ID>;
     isDomainAction<ACT extends IActionBase<any, ACT_DOM, any>>(action: ACT | unknown | null | undefined): action is TDistributedDomainActions<ACT_DOM, ACT>;
     hydrateRequestPayload<ID extends keyof ACT_DOM["actionSchema"] & string, P extends IActionPayload_Request_JsonObject<ACT_DOM, ID>>(serialized: P): TDistributeActionPayload_Request<ACT_DOM, ID>;

package/build/types/ActionDefinition/Domain/ActionDomain.types.d.ts

@@ -38,3 +38,6 @@ export type TInferOutputFromSchema<SCH extends ActionSchema<any, any, any>> = SC
     Output: OUT[0];
     SerdeOutput: OUT[1];
 } : never;
+export type TWrappableDomainActionHandler<DOM extends IActionDomain> = {
+    [K in TDomainActionId<DOM>]: (...args: [TInferInputFromSchema<DOM["actionSchema"][K]>["Input"]] extends [never] ? [] : [input: TInferInputFromSchema<DOM["actionSchema"][K]>["Input"]]) => [TInferOutputFromSchema<DOM["actionSchema"][K]>["Output"]] extends [never] ? Promise<void> | void : Promise<TInferOutputFromSchema<DOM["actionSchema"][K]>["Output"]>;
+};

package/build/types/ActionDefinition/Domain/ActionRootDomain.d.ts

@@ -1,6 +1,6 @@
 import type { ActionRuntime } from "../../ActionRuntime/ActionRuntime";
-import type { IActionClientSpecifier } from "../../ActionRuntime/Client/ActionClientSpecifier";
 import type { IExecuteActionOptions } from "../../ActionRuntime/Handler/ActionHandler.types";
+import type { IRuntimeCoordinate } from "../../ActionRuntime/RuntimeCoordinate";
 import type { ActionPayload_Request } from "../Action/Payload/ActionPayload_Request";
 import type { RunningAction } from "../Action/RunningAction";
 import { ActionDomain } from "./ActionDomain";
@@ -18,6 +18,6 @@ export declare class ActionRootDomain<ROOT_DOM extends IActionRootDomain = IActi
         [K in Exclude<keyof SUB_DOM, keyof IActionDomainChildOptions>]: never;
     }): ActionDomain<TActionDomainChildDef<ROOT_DOM, SUB_DOM>>;
     addActionRuntime(runtime: ActionRuntime): this;
-    getRuntime(clientSpecifier: IActionClientSpecifier): ActionRuntime | undefined;
+    getRuntime(clientSpecifier: IRuntimeCoordinate): ActionRuntime | undefined;
     _runAction<DOM extends IActionDomain, ID extends keyof DOM["actionSchema"] & string = keyof DOM["actionSchema"] & string, ACT extends ActionPayload_Request<DOM, ID> = ActionPayload_Request<DOM, ID>>(actionPayload: ACT, options?: IExecuteActionOptions<DOM, ID>): Promise<RunningAction<DOM, ID>>;
 }

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

@@ -3,18 +3,20 @@ import { type TActionPayload_Any_JsonObject } from "../ActionDefinition/Action/P
 import { RunningAction } from "../ActionDefinition/Action/RunningAction";
 import type { IActionDomain } from "../ActionDefinition/Domain/ActionDomain.types";
 import type { IRuntimeMeta, TActionRuntimeHandler } from "./ActionRuntime.types";
-import { ActionClientSpecifier } from "./Client/ActionClientSpecifier";
 import { type IHandleActionOptions, type TActionHandler } from "./Handler/ActionHandler.types";
 import type { ActionExternalClientHandler } from "./Handler/ExternalClient/ActionExternalClientHandler";
+import { RuntimeCoordinate } from "./RuntimeCoordinate";
 export declare class ActionRuntime {
-    readonly clientSpecifier: ActionClientSpecifier;
+    private _coordinate;
     readonly timeCreated: number;
     readonly runtimeInfo: IRuntimeMeta;
     private readonly actionRouter;
     private readonly _pendingRunningActions;
     private readonly _registeredExternalHandlers;
     static getDefault(): ActionRuntime;
-    constructor(client: ActionClientSpecifier);
+    constructor(coordinate: RuntimeCoordinate);
+    get coordinate(): RuntimeCoordinate;
+    updateRuntimeCoordinate(newCoordinate: RuntimeCoordinate): void;
     registerRunningAction(ra: RunningAction<any, any>): void;
     resolveIncomingActionPayload(json: TActionPayload_Any_JsonObject<any, any>): void;
     /**
@@ -38,6 +40,6 @@ export declare class ActionRuntime {
      * Used to locate the return-path channel for dispatching results back to the action origin.
      * Returns `undefined` if no handler matches (score > 0 required, i.e. at least id must match).
      */
-    getReturnHandlerForOrigin(originClient: ActionClientSpecifier): ActionExternalClientHandler | undefined;
+    getReturnHandlerForOrigin(originClient: RuntimeCoordinate): ActionExternalClientHandler | undefined;
     private _trySetupReturnDispatch;
 }

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

@@ -1,15 +1,15 @@
 import type { RuntimeName } from "std-env";
 import type { ActionRuntime } from "./ActionRuntime";
-import type { ActionClientSpecifier } from "./Client/ActionClientSpecifier";
 import type { TActionHandler } from "./Handler/ActionHandler.types";
 import type { ActionExternalClientHandler } from "./Handler/ExternalClient/ActionExternalClientHandler";
 import type { ActionLocalHandler } from "./Handler/Local/ActionLocalHandler";
+import type { RuntimeCoordinate } from "./RuntimeCoordinate";
 export interface IRuntimeMeta {
     assumed: boolean;
     runtimeName: RuntimeName;
 }
 export interface IRuntimeEnvironmentMeta {
-    client: ActionClientSpecifier;
+    client: RuntimeCoordinate;
     runtimeInfo: IRuntimeMeta;
 }
 export interface IActionRuntimeManagerContext {

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

@@ -1,8 +1,8 @@
 import type { TActionPayload_Any_Instance } from "../ActionDefinition/Action/Payload/ActionPayload.types";
 import type { ActionRuntime } from "./ActionRuntime";
 import type { IActionHandlerAndRuntime, IActionRuntimeManagerContext } from "./ActionRuntime.types";
-import { type IActionClientSpecifier } from "./Client/ActionClientSpecifier";
 import type { IHandleActionOptions } from "./Handler/ActionHandler.types";
+import { type IRuntimeCoordinate } from "./RuntimeCoordinate";
 export declare class ActionRuntimeManager {
     private _runtimes;
     private _preferredRuntimeClientId;
@@ -13,7 +13,7 @@ export declare class ActionRuntimeManager {
     getRuntimeAndHandlerForActionOrThrow(action: TActionPayload_Any_Instance<any, any>, options?: IHandleActionOptions): IActionHandlerAndRuntime;
     setPreferredRuntime(runtime: ActionRuntime): void;
     getPreferredRuntime(): ActionRuntime | undefined;
-    getBestRuntimeForSpecifier(clientSpecifier: IActionClientSpecifier): ActionRuntime | undefined;
-    getBestRuntime(clientSpecifier?: IActionClientSpecifier): ActionRuntime | undefined;
-    getBestRuntimeOrThrow(specifier?: IActionClientSpecifier): ActionRuntime;
+    getBestRuntimeForSpecifier(clientSpecifier: IRuntimeCoordinate): ActionRuntime | undefined;
+    getBestRuntime(clientSpecifier?: IRuntimeCoordinate): ActionRuntime | undefined;
+    getBestRuntimeOrThrow(specifier?: IRuntimeCoordinate): ActionRuntime;
 }

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

@@ -4,8 +4,8 @@ import type { RunningAction } from "../../ActionDefinition/Action/RunningAction"
 import type { TRunningActionUpdateListener } from "../../ActionDefinition/Action/RunningAction.types";
 import type { IActionDomain } from "../../ActionDefinition/Domain/ActionDomain.types";
 import type { ActionRuntime } from "../ActionRuntime";
-import type { ActionClientSpecifier, IActionClientSpecifier } from "../Client/ActionClientSpecifier";
 import type { ActionRouter } from "../Routing/ActionRouter";
+import type { IRuntimeCoordinate, RuntimeCoordinate } from "../RuntimeCoordinate";
 export declare enum EActionHandlerType {
     external = "external",
     local = "local"
@@ -14,14 +14,14 @@ export interface IActionHandler_Json<T extends EActionHandlerType> {
     type: T;
 }
 export interface IActionHandler_ExternalClient_Json extends IActionHandler_Json<EActionHandlerType.external> {
-    client: IActionClientSpecifier;
+    client: IRuntimeCoordinate;
 }
 export interface IActionHandler_Local_Json extends IActionHandler_Json<EActionHandlerType.local> {
 }
 export type TActionHandler_Json = IActionHandler_Local_Json | IActionHandler_ExternalClient_Json;
 export interface IHandleActionOptions {
     timeout?: number;
-    targetExternalClient?: ActionClientSpecifier;
+    targetExternalClient?: RuntimeCoordinate;
     targetLocalRuntime?: ActionRuntime;
 }
 export interface IExecuteActionOptions<DOM extends IActionDomain = IActionDomain, ID extends keyof DOM["actionSchema"] & string = keyof DOM["actionSchema"] & string> extends IHandleActionOptions {
@@ -53,7 +53,7 @@ export interface IActionHandler_Local extends IActionHandler_Base<EActionHandler
 export interface IHandleActionOptions_External extends IHandleActionOptions {
 }
 export interface IActionHandler_ExternalClient extends IActionHandler_Base<EActionHandlerType.external> {
-    externalClient: ActionClientSpecifier;
+    externalClient: RuntimeCoordinate;
     handleActionRequest: <DOM extends IActionDomain, ID extends keyof DOM["actionSchema"] & string>(action: ActionPayload_Request<DOM, ID>, config?: IHandleActionOptions_External) => Promise<RunningAction<DOM, ID>>;
     _setIncomingActionDataListener(listener: (json: TActionPayload_Any_JsonObject<any>) => void): void;
 }

package/build/types/ActionRuntime/Handler/ExternalClient/ActionExternalClientHandler.d.ts

@@ -5,14 +5,14 @@ import { RunningAction } from "../../../ActionDefinition/Action/RunningAction";
 import type { ActionDomain } from "../../../ActionDefinition/Domain/ActionDomain";
 import type { IActionDomain } from "../../../ActionDefinition/Domain/ActionDomain.types";
 import { ActionRuntime } from "../../ActionRuntime";
-import { ActionClientSpecifier } from "../../Client/ActionClientSpecifier";
 import { ActionRouter } from "../../Routing/ActionRouter";
+import { RuntimeCoordinate } from "../../RuntimeCoordinate";
 import { ActionHandler } from "../ActionHandler";
 import { EActionHandlerType, type IActionHandler_ExternalClient, type IActionHandler_ExternalClient_Json, type IHandleActionOptions } from "../ActionHandler.types";
 import type { IActionExternalClientRequestHandlerConfig } from "./ActionExternalClientHandler.types";
 import type { Transport } from "./Transport/Transport";
 export declare class ActionExternalClientHandler extends ActionHandler<EActionHandlerType.external> implements IActionHandler_ExternalClient {
-    readonly externalClient: ActionClientSpecifier;
+    readonly externalClient: RuntimeCoordinate;
     readonly handlerType = EActionHandlerType.external;
     readonly cuid: string;
     private _defaultTimeout;

package/build/types/ActionRuntime/Handler/ExternalClient/ActionExternalClientHandler.types.d.ts

@@ -1,7 +1,7 @@
-import type { ActionClientSpecifier } from "../../Client/ActionClientSpecifier";
+import type { RuntimeCoordinate } from "../../RuntimeCoordinate";
 import type { TActionTransportDef } from "./Transport/Transport.combined.types";
 export interface IActionExternalClientRequestHandlerConfig {
     defaultTimeout?: number;
-    externalClientSpecifier: ActionClientSpecifier;
+    externalClientSpecifier: RuntimeCoordinate;
     transports: TActionTransportDef[];
 }

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

@@ -3,7 +3,7 @@ import type { IActionPayload_Request_JsonObject, IActionPayload_Result_JsonObjec
 import type { ActionPayload_Request } from "../../../../ActionDefinition/Action/Payload/ActionPayload_Request";
 import type { ActionPayload_Result } from "../../../../ActionDefinition/Action/Payload/ActionPayload_Result";
 import type { RunningAction } from "../../../../ActionDefinition/Action/RunningAction";
-import type { ActionClientSpecifier } from "../../../Client/ActionClientSpecifier";
+import type { RuntimeCoordinate } from "../../../RuntimeCoordinate";
 import type { Transport } from "./Transport";
 export declare enum ETransportType {
     ws = "ws",
@@ -56,8 +56,8 @@ export type TTransportStatusInfo_GetTransport_Output<READY extends IActionTransp
  *
  */
 export interface ITransportRouteClientParams {
-    localClient: ActionClientSpecifier;
-    externalClient: ActionClientSpecifier;
+    localClient: RuntimeCoordinate;
+    externalClient: RuntimeCoordinate;
 }
 export interface ITransportRouteActionParams extends ITransportRouteClientParams {
     action: TActionPayload_Any_Instance<any, any>;

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

@@ -0,0 +1,55 @@
+export interface IRuntimeCoordinate {
+    /**
+     * A static runtime environment identifier (e.g. "web_app_v1", "backend_analytics")
+     */
+    envId: string;
+    /**
+     * A unique and persistent client ID (should stay the same between runtime instance reloads)
+     */
+    perId?: string;
+    /**
+     * A unique instance (or "memory-only") ID (unique for each instance of an action runtime, which should generally
+     * not persist between reloads, depending on the architecture)
+     */
+    insId?: string;
+}
+export type TRuntimeCoordinateStringId = `envId[${string}]perId[${string | "_"}]:insId[${string | "_"}]`;
+export interface IRuntimeFullCoordinates extends Required<IRuntimeCoordinate> {
+}
+export declare class RuntimeCoordinate implements IRuntimeCoordinate {
+    readonly envId: string;
+    readonly perId?: string;
+    readonly insId?: string;
+    static get unknown(): RuntimeCoordinate;
+    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;
+    toJsonObject(): IRuntimeCoordinate;
+    isExactlySame(other: IRuntimeCoordinate): boolean;
+    isSameFor(other: IRuntimeCoordinate): {
+        id: boolean;
+        perId: boolean;
+        insId: boolean;
+    };
+    similarityLevel(other: IRuntimeCoordinate): number;
+    get stringId(): TRuntimeCoordinateStringId;
+    /**
+     * Takes the "Runtime Coordinate" and generates a list of full coordinate IDs representing the runtime
+     * with decreasing levels of specificity.
+     *
+     * The first full coordinate ID is the most specific (including instance ID), while the last ID is
+     * the least specific (only environment ID).
+     *
+     * Example output for a RuntimeCoordinate with envId "web_app", perId "user123", and insId "instance456":
+     * [
+     *   "envId[web_app]perId[user123]:insId[instance456]",
+     *   "envId[web_app]perId[user123]:insId[_]",
+     *   "envId[web_app]perId[_]:insId[_]"
+     * ]
+     *
+     * @returns a list of "full" runtime coordinate IDs with decreasing accuracy for targeting a runtime.
+     */
+    toStringIds(): TRuntimeCoordinateStringId[];
+}

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

@@ -0,0 +1,2 @@
+import type { IRuntimeCoordinate, TRuntimeCoordinateStringId } from "../RuntimeCoordinate";
+export declare function runtimeCoordinateToStringIds(coordinate: IRuntimeCoordinate): TRuntimeCoordinateStringId[];

package/build/types/errors/err_nice_action.d.ts

@@ -1,5 +1,5 @@
 import type { IActionRuntimeManagerContext } from "../ActionRuntime/ActionRuntime.types";
-import type { ActionClientSpecifier, TClientSpecifierStringId } from "../ActionRuntime/Client/ActionClientSpecifier";
+import type { RuntimeCoordinate, TRuntimeCoordinateStringId } from "../ActionRuntime/RuntimeCoordinate";
 export declare enum EErrId_NiceAction {
     not_implemented = "not_implemented",
     action_id_not_in_domain = "action_id_not_in_domain",
@@ -53,7 +53,7 @@ export declare const err_nice_action: import("@nice-code/error").NiceErrorDomain
         no_action_execution_handler: import("@nice-code/error").INiceErrorIdMetadata<{
             domain: string;
             actionId: string;
-            specifiedClient?: ActionClientSpecifier;
+            specifiedClient?: RuntimeCoordinate;
         }, import("@nice-code/error").JSONSerializableValue>;
         wire_action_not_payload: import("@nice-code/error").INiceErrorIdMetadata<{
             domain: string;
@@ -63,11 +63,11 @@ export declare const err_nice_action: import("@nice-code/error").NiceErrorDomain
         wire_not_action_data: import("@nice-code/error").INiceErrorIdMetadata<any, import("@nice-code/error").JSONSerializableValue>;
         client_runtime_already_registered: import("@nice-code/error").INiceErrorIdMetadata<{
             context?: IActionRuntimeManagerContext;
-            client: ActionClientSpecifier;
+            client: RuntimeCoordinate;
         }, import("@nice-code/error").JSONSerializableValue>;
         client_runtime_not_registered: import("@nice-code/error").INiceErrorIdMetadata<{
             context?: IActionRuntimeManagerContext;
-            clientStringId: TClientSpecifierStringId;
+            clientStringId: TRuntimeCoordinateStringId;
         }, import("@nice-code/error").JSONSerializableValue>;
         no_client_runtimes_registered: import("@nice-code/error").INiceErrorIdMetadata<{
             context?: IActionRuntimeManagerContext;

package/build/types/index.d.ts

@@ -14,7 +14,6 @@ export { createActionRootDomain } from "./ActionDefinition/Domain/helpers/create
 export { ActionSchema, actionSchema, type TInferActionError, } from "./ActionDefinition/Schema/ActionSchema";
 export type { TActionSchemaOptions, TActionSerializationDefinition, TTransportedValue, } from "./ActionDefinition/Schema/ActionSchema.types";
 export { ActionRuntime } from "./ActionRuntime/ActionRuntime";
-export { ActionClientSpecifier, type IActionClientSpecifier, } from "./ActionRuntime/Client/ActionClientSpecifier";
 export { ActionExternalClientHandler, createExternalClientHandler, } from "./ActionRuntime/Handler/ExternalClient/ActionExternalClientHandler";
 export * from "./ActionRuntime/Handler/ExternalClient/err_nice_external_client";
 export * from "./ActionRuntime/Handler/ExternalClient/Transport/err_nice_transport";
@@ -25,6 +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 { 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/build/types/nice_action.static.d.ts

@@ -1,3 +1,3 @@
 export declare const DEFAULT_TRANSPORT_TIMEOUT = 10000;
-export declare const UNSET_CLIENT_ID = "_unset_";
-export declare const UNSET_PERSISTENT_ID = "_0_0_";
+export declare const UNSET_RUNTIME_ENV_ID = "_unset_";
+export declare const UNSET_RUNTIME_PER_ID = "_0_0_";

package/build/types/react-query/hooks/useActionMutation.d.ts

@@ -1,6 +1,10 @@
 import { type UseMutationOptions, type UseMutationResult } from "@tanstack/react-query";
 import type { ActionCore } from "../../ActionDefinition/Action/Core/ActionCore";
 import type { IActionDomain, TInferInputFromSchema, TInferOutputFromSchema } from "../../ActionDefinition/Domain/ActionDomain.types";
-import type { TInferActionError } from "../../ActionDefinition/Schema/ActionSchema";
-export type TUseNiceMutationOptions<DOM extends IActionDomain, ID extends keyof DOM["actionSchema"] & string, SCH extends DOM["actionSchema"][ID] = DOM["actionSchema"][ID], TContext = unknown> = Omit<UseMutationOptions<TInferOutputFromSchema<SCH>["Output"], TInferActionError<SCH>, TInferInputFromSchema<SCH>["Input"], TContext>, "mutationFn">;
-export declare function useActionMutation<DOM extends IActionDomain, ID extends keyof DOM["actionSchema"] & string, SCH extends DOM["actionSchema"][ID], TContext = unknown>(action: ActionCore<DOM, ID>, options?: TUseNiceMutationOptions<DOM, ID, SCH, TContext>): UseMutationResult<TInferOutputFromSchema<SCH>["Output"], TInferActionError<SCH>, TInferInputFromSchema<SCH>["Input"], TContext>;
+import type { ActionSchema, TInferActionError } from "../../ActionDefinition/Schema/ActionSchema";
+/** When an action has no input schema (Input = never), use void so mutate() needs no arguments. */
+export type TActionMutationVars<SCH extends ActionSchema<any, any, any>> = [
+    TInferInputFromSchema<SCH>["Input"]
+] extends [never] ? void : TInferInputFromSchema<SCH>["Input"];
+export type TUseNiceMutationOptions<DOM extends IActionDomain, ID extends keyof DOM["actionSchema"] & string, SCH extends DOM["actionSchema"][ID] = DOM["actionSchema"][ID], TContext = unknown> = Omit<UseMutationOptions<TInferOutputFromSchema<SCH>["Output"], TInferActionError<SCH>, TActionMutationVars<SCH>, TContext>, "mutationFn">;
+export declare function useActionMutation<DOM extends IActionDomain, ID extends keyof DOM["actionSchema"] & string, SCH extends DOM["actionSchema"][ID], TContext = unknown>(action: ActionCore<DOM, ID>, options?: TUseNiceMutationOptions<DOM, ID, SCH, TContext>): UseMutationResult<TInferOutputFromSchema<SCH>["Output"], TInferActionError<SCH>, TActionMutationVars<SCH>, TContext>;

package/build/types/react-query/hooks/useActionQuery.d.ts

@@ -2,8 +2,8 @@ import { type QueryKey, type UseQueryOptions, type UseQueryResult } from "@tanst
 import type { ActionCore } from "../../ActionDefinition/Action/Core/ActionCore";
 import type { IActionDomain, TInferInputFromSchema, TInferOutputFromSchema } from "../../ActionDefinition/Domain/ActionDomain.types";
 import type { TInferActionError } from "../../ActionDefinition/Schema/ActionSchema";
-export declare function niceActionQueryKey<DOM extends IActionDomain, ID extends keyof DOM["actionSchema"] & string>(action: ActionCore<DOM, ID>): readonly ["nice-action", DOM["domain"], DOM["allDomains"], ID];
-export declare function niceActionQueryKey<DOM extends IActionDomain, ID extends keyof DOM["actionSchema"] & string>(action: ActionCore<DOM, ID>, input: TInferInputFromSchema<DOM["actionSchema"][ID]>["Input"]): readonly [
+export declare function actionQueryKey<DOM extends IActionDomain, ID extends keyof DOM["actionSchema"] & string>(action: ActionCore<DOM, ID>): readonly ["nice-action", DOM["domain"], DOM["allDomains"], ID];
+export declare function actionQueryKey<DOM extends IActionDomain, ID extends keyof DOM["actionSchema"] & string>(action: ActionCore<DOM, ID>, input: TInferInputFromSchema<DOM["actionSchema"][ID]>["Input"]): readonly [
     "nice-action",
     DOM["domain"],
     DOM["allDomains"],
@@ -11,5 +11,5 @@ export declare function niceActionQueryKey<DOM extends IActionDomain, ID extends
     TInferInputFromSchema<DOM["actionSchema"][ID]>["Input"],
     string | undefined
 ];
-export type TUseNiceQueryOptions<DOM extends IActionDomain, ID extends keyof DOM["actionSchema"] & string, SCH extends DOM["actionSchema"][ID] = DOM["actionSchema"][ID], TSelect = TInferOutputFromSchema<SCH>["Output"]> = Omit<UseQueryOptions<TInferOutputFromSchema<SCH>["Output"], TInferActionError<SCH>, TSelect, QueryKey>, "queryKey" | "queryFn">;
-export declare function useNiceQuery<DOM extends IActionDomain, ID extends keyof DOM["actionSchema"] & string, SCH extends DOM["actionSchema"][ID], TSelect = TInferOutputFromSchema<SCH>["Output"]>(action: ActionCore<DOM, ID>, input: TInferInputFromSchema<SCH>["Input"] | null | undefined, options?: TUseNiceQueryOptions<DOM, ID, SCH, TSelect>): UseQueryResult<TSelect, TInferActionError<SCH>>;
+export type TUseActionQueryOptions<DOM extends IActionDomain, ID extends keyof DOM["actionSchema"] & string, SCH extends DOM["actionSchema"][ID] = DOM["actionSchema"][ID], TSelect = TInferOutputFromSchema<SCH>["Output"]> = Omit<UseQueryOptions<TInferOutputFromSchema<SCH>["Output"], TInferActionError<SCH>, TSelect, QueryKey>, "queryKey" | "queryFn">;
+export declare function useActionQuery<DOM extends IActionDomain, ID extends keyof DOM["actionSchema"] & string, SCH extends DOM["actionSchema"][ID], TSelect = TInferOutputFromSchema<SCH>["Output"]>(action: ActionCore<DOM, ID>, input: TInferInputFromSchema<SCH>["Input"] | null | undefined, options?: TUseActionQueryOptions<DOM, ID, SCH, TSelect>): UseQueryResult<TSelect, TInferActionError<SCH>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nice-code/action",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "private": false,
   "type": "module",
   "exports": {

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

@@ -1,47 +0,0 @@
-export interface IActionClientSpecifier {
-    /**
-     * A static client identifier (e.g. "web_app_v1", "backend_analytics")
-     */
-    id: string;
-    /**
-     * A unique and persistant ID (between client instance reloads)
-     */
-    perId?: string;
-    /**
-     * A unique instance ID (unique for each instance of a client, does not persist between reloads)
-     */
-    insId?: string;
-}
-export type TClientSpecifierStringId = `id[${string}]perId[${string | "_"}]:insId[${string | "_"}]`;
-export interface IActionClientFullSpecifier extends Required<IActionClientSpecifier> {
-}
-export declare class ActionClientSpecifier implements IActionClientSpecifier {
-    readonly id: string;
-    readonly perId?: string;
-    readonly insId?: string;
-    static get unknown(): ActionClientSpecifier;
-    static root(id: string): ActionClientSpecifier;
-    withPersistentId(perId: string): ActionClientSpecifier;
-    constructor({ id, perId, insId }: IActionClientSpecifier);
-    specify(newInputs: Omit<IActionClientSpecifier, "id">): ActionClientSpecifier;
-    specifyIfUnset(newInputs: Omit<IActionClientSpecifier, "id">): ActionClientSpecifier;
-    toJsonObject(): IActionClientSpecifier;
-    isExactlySame(other: IActionClientSpecifier): boolean;
-    isSameFor(other: IActionClientSpecifier): {
-        id: boolean;
-        perId: boolean;
-        insId: boolean;
-    };
-    similarityLevel(other: IActionClientSpecifier): number;
-    get stringId(): TClientSpecifierStringId;
-    /**
-     * Generates a list of string IDs representing the client with decreasing levels of specificity.
-     * The first ID is the most specific (including instance ID), while the last ID is the least specific (only client ID).
-     *
-     * Example output for a client with id "web_app", perId "user123", and insId "instance456":
-     * ["id[web_app]perId[user123]:insId[instance456]", "id[web_app]perId[user123]:insId[_]", "id[web_app]perId[_]:insId[_]"]
-     *
-     * @returns a list of "string IDs" with decreasing target accuracy for the client
-     */
-    toStringIds(): TClientSpecifierStringId[];
-}

package/build/types/ActionRuntime/Client/utils/clientSpecifierToStringIds.d.ts

@@ -1,2 +0,0 @@
-import type { IActionClientSpecifier, TClientSpecifierStringId } from "../ActionClientSpecifier";
-export declare function clientSpecifierToStringIds(specifier: IActionClientSpecifier): TClientSpecifierStringId[];