@nice-code/action 0.10.0 → 0.11.0

package/build/react-query/index.cjs

@@ -0,0 +1,70 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _tanstack_react_query = require("@tanstack/react-query");
+let react = require("react");
+//#region src/react-query/hooks/useActionMutation.ts
+function useActionMutation(action, options) {
+	const mutationOptions = options ?? {};
+	const callSiteRef = (0, react.useRef)(void 0);
+	const result = (0, _tanstack_react_query.useMutation)({
+		mutationFn: (input) => {
+			const req = action.request(input);
+			req._callSite = callSiteRef.current;
+			callSiteRef.current = void 0;
+			return req.runToOutput();
+		},
+		...mutationOptions
+	});
+	return {
+		...result,
+		mutate: (...args) => {
+			callSiteRef.current = (/* @__PURE__ */ new Error()).stack;
+			return result.mutate(...args);
+		},
+		mutateAsync: (...args) => {
+			callSiteRef.current = (/* @__PURE__ */ new Error()).stack;
+			return result.mutateAsync(...args);
+		}
+	};
+}
+//#endregion
+//#region src/react-query/hooks/useActionQuery.ts
+function actionQueryKey(action, input) {
+	if (input === void 0) 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 ?? {};
+	const callSiteRef = (0, react.useRef)((/* @__PURE__ */ new Error()).stack);
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: input != null ? actionQueryKey(action, input) : actionQueryKey(action),
+		queryFn: () => {
+			const req = action.request(input);
+			req._callSite = callSiteRef.current;
+			return req.runToOutput();
+		},
+		enabled: hasInputSchema ? input != null && (enabled ?? true) : enabled ?? true,
+		...queryOptions
+	});
+}
+//#endregion
+exports.actionQueryKey = actionQueryKey;
+exports.useActionMutation = useActionMutation;
+exports.useActionQuery = useActionQuery;
+
+//# sourceMappingURL=index.cjs.map

package/build/react-query/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/react-query/hooks/useActionMutation.ts","../../src/react-query/hooks/useActionQuery.ts"],"sourcesContent":["import {\r\n  type UseMutationOptions,\r\n  type UseMutationResult,\r\n  useMutation,\r\n} from \"@tanstack/react-query\";\r\nimport { useRef } from \"react\";\r\nimport type { ActionCore } from \"../../ActionDefinition/Action/Core/ActionCore\";\r\nimport type {\r\n  IActionDomain,\r\n  TInferInputFromSchema,\r\n  TInferOutputFromSchema,\r\n} from \"../../ActionDefinition/Domain/ActionDomain.types\";\r\nimport type { ActionSchema, TInferActionError } from \"../../ActionDefinition/Schema/ActionSchema\";\r\n\r\n/** When an action has no input schema (Input = never), use void so mutate() needs no arguments. */\r\nexport type TActionMutationVars<SCH extends ActionSchema<any, any, any>> = [\r\n  TInferInputFromSchema<SCH>[\"Input\"],\r\n] extends [never]\r\n  ? void\r\n  : TInferInputFromSchema<SCH>[\"Input\"];\r\n\r\nexport type TUseNiceMutationOptions<\r\n  DOM extends IActionDomain,\r\n  ID extends keyof DOM[\"actionSchema\"] & string,\r\n  SCH extends DOM[\"actionSchema\"][ID] = DOM[\"actionSchema\"][ID],\r\n  TContext = unknown,\r\n> = Omit<\r\n  UseMutationOptions<\r\n    TInferOutputFromSchema<SCH>[\"Output\"],\r\n    TInferActionError<SCH>,\r\n    TActionMutationVars<SCH>,\r\n    TContext\r\n  >,\r\n  \"mutationFn\"\r\n>;\r\n\r\nexport function useActionMutation<\r\n  DOM extends IActionDomain,\r\n  ID extends keyof DOM[\"actionSchema\"] & string,\r\n  SCH extends DOM[\"actionSchema\"][ID],\r\n  TContext = unknown,\r\n>(\r\n  action: ActionCore<DOM, ID>,\r\n  options?: TUseNiceMutationOptions<DOM, ID, SCH, TContext>,\r\n): UseMutationResult<\r\n  TInferOutputFromSchema<SCH>[\"Output\"],\r\n  TInferActionError<SCH>,\r\n  TActionMutationVars<SCH>,\r\n  TContext\r\n> {\r\n  const mutationOptions = options ?? {};\r\n\r\n  // Side-channel for the call site: mutate() writes it synchronously, mutationFn reads it.\r\n  // React Query calls mutationFn synchronously within mutate(), so the ref is always fresh.\r\n  const callSiteRef = useRef<string | undefined>(undefined);\r\n\r\n  const result = useMutation({\r\n    mutationFn: (input: TActionMutationVars<SCH>) => {\r\n      const req = action.request(input as unknown as TInferInputFromSchema<SCH>[\"Input\"]);\r\n      req._callSite = callSiteRef.current;\r\n      callSiteRef.current = undefined;\r\n      return req.runToOutput();\r\n    },\r\n    ...mutationOptions,\r\n  });\r\n\r\n  // Wrap mutate/mutateAsync so the call site is captured at the user's invocation point.\r\n  // By the time mutationFn runs inside React Query's scheduler the user's frames are gone.\r\n  return {\r\n    ...result,\r\n    mutate: (...args: Parameters<typeof result.mutate>) => {\r\n      callSiteRef.current = new Error().stack;\r\n      return result.mutate(...args);\r\n    },\r\n    mutateAsync: (...args: Parameters<typeof result.mutateAsync>) => {\r\n      callSiteRef.current = new Error().stack;\r\n      return result.mutateAsync(...args);\r\n    },\r\n  };\r\n}\r\n","import {\n  type QueryKey,\n  type UseQueryOptions,\n  type UseQueryResult,\n  useQuery,\n} from \"@tanstack/react-query\";\nimport { useRef } from \"react\";\nimport type { ActionCore } from \"../../ActionDefinition/Action/Core/ActionCore\";\nimport type {\n  IActionDomain,\n  TInferInputFromSchema,\n  TInferOutputFromSchema,\n} from \"../../ActionDefinition/Domain/ActionDomain.types\";\nimport type { TInferActionError } from \"../../ActionDefinition/Schema/ActionSchema\";\n\nexport function actionQueryKey<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string,\n>(action: ActionCore<DOM, ID>): readonly [\"nice-action\", DOM[\"domain\"], DOM[\"allDomains\"], ID];\n\nexport function actionQueryKey<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string,\n>(\n  action: ActionCore<DOM, ID>,\n  input: TInferInputFromSchema<DOM[\"actionSchema\"][ID]>[\"Input\"],\n): readonly [\n  \"nice-action\",\n  DOM[\"domain\"],\n  DOM[\"allDomains\"],\n  ID,\n  TInferInputFromSchema<DOM[\"actionSchema\"][ID]>[\"Input\"],\n];\n\nexport function actionQueryKey(action: ActionCore<any, any>, input?: unknown): QueryKey {\n  if (input === undefined) {\n    return [\"nice-action\", action.domain, action.allDomains, action.id] as const;\n  }\n\n  return [\"nice-action\", action.domain, action.allDomains, action.id, input] as const;\n}\n\nexport type TUseActionQueryOptions<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string,\n  SCH extends DOM[\"actionSchema\"][ID] = DOM[\"actionSchema\"][ID],\n  TSelect = TInferOutputFromSchema<SCH>[\"Output\"],\n> = Omit<\n  UseQueryOptions<TInferOutputFromSchema<SCH>[\"Output\"], TInferActionError<SCH>, TSelect, QueryKey>,\n  \"queryKey\" | \"queryFn\"\n>;\n\nexport function useActionQuery<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string,\n  SCH extends DOM[\"actionSchema\"][ID],\n  TSelect = TInferOutputFromSchema<SCH>[\"Output\"],\n>(\n  action: ActionCore<DOM, ID>,\n  ...args: [TInferInputFromSchema<SCH>[\"Input\"]] extends [never]\n    ? [options?: TUseActionQueryOptions<DOM, ID, SCH, TSelect>]\n    : [\n        input: TInferInputFromSchema<SCH>[\"Input\"] | null | undefined,\n        options?: TUseActionQueryOptions<DOM, ID, SCH, TSelect>,\n      ]\n): UseQueryResult<TSelect, TInferActionError<SCH>> {\n  const hasInputSchema = action.schema.inputSchema != null;\n\n  let input: TInferInputFromSchema<SCH>[\"Input\"] | null | undefined;\n  let options: TUseActionQueryOptions<DOM, ID, SCH, TSelect> | undefined;\n\n  if (hasInputSchema) {\n    [input, options] = args as [\n      TInferInputFromSchema<SCH>[\"Input\"] | null | undefined,\n      TUseActionQueryOptions<DOM, ID, SCH, TSelect>?,\n    ];\n  } else {\n    [options] = args as [TUseActionQueryOptions<DOM, ID, SCH, TSelect>?];\n  }\n\n  const { enabled, ...queryOptions } = options ?? {};\n\n  // Capture the call site synchronously here — the user's component frame is on the\n  // stack now. By the time queryFn runs inside React Query's scheduler it's gone.\n  const callSiteRef = useRef(new Error().stack);\n\n  return useQuery({\n    queryKey: input != null ? actionQueryKey(action, input) : actionQueryKey(action),\n    queryFn: () => {\n      const req = (action.request as (input: any) => any)(input);\n      req._callSite = callSiteRef.current;\n      return req.runToOutput();\n    },\n    enabled: hasInputSchema ? input != null && (enabled ?? true) : (enabled ?? true),\n    ...queryOptions,\n  } as UseQueryOptions<TInferOutputFromSchema<SCH>[\"Output\"], TInferActionError<SCH>, TSelect>);\n}\n"],"mappings":";;;;AAoCA,SAAgB,kBAMd,QACA,SAMA;CACA,MAAM,kBAAkB,WAAW,CAAC;CAIpC,MAAM,eAAA,GAAA,MAAA,OAAA,CAAyC,KAAA,CAAS;CAExD,MAAM,UAAA,GAAA,sBAAA,YAAA,CAAqB;EACzB,aAAa,UAAoC;GAC/C,MAAM,MAAM,OAAO,QAAQ,KAAuD;GAClF,IAAI,YAAY,YAAY;GAC5B,YAAY,UAAU,KAAA;GACtB,OAAO,IAAI,YAAY;EACzB;EACA,GAAG;CACL,CAAC;CAID,OAAO;EACL,GAAG;EACH,SAAS,GAAG,SAA2C;GACrD,YAAY,2BAAU,IAAI,MAAM,EAAA,CAAE;GAClC,OAAO,OAAO,OAAO,GAAG,IAAI;EAC9B;EACA,cAAc,GAAG,SAAgD;GAC/D,YAAY,2BAAU,IAAI,MAAM,EAAA,CAAE;GAClC,OAAO,OAAO,YAAY,GAAG,IAAI;EACnC;CACF;AACF;;;AC7CA,SAAgB,eAAe,QAA8B,OAA2B;CACtF,IAAI,UAAU,KAAA,GACZ,OAAO;EAAC;EAAe,OAAO;EAAQ,OAAO;EAAY,OAAO;CAAE;CAGpE,OAAO;EAAC;EAAe,OAAO;EAAQ,OAAO;EAAY,OAAO;EAAI;CAAK;AAC3E;AAYA,SAAgB,eAMd,QACA,GAAG,MAM8C;CACjD,MAAM,iBAAiB,OAAO,OAAO,eAAe;CAEpD,IAAI;CACJ,IAAI;CAEJ,IAAI,gBACF,CAAC,OAAO,WAAW;MAKnB,CAAC,WAAW;CAGd,MAAM,EAAE,SAAS,GAAG,iBAAiB,WAAW,CAAC;CAIjD,MAAM,eAAA,GAAA,MAAA,OAAA,kBAAqB,IAAI,MAAM,EAAA,CAAE,KAAK;CAE5C,QAAA,GAAA,sBAAA,SAAA,CAAgB;EACd,UAAU,SAAS,OAAO,eAAe,QAAQ,KAAK,IAAI,eAAe,MAAM;EAC/E,eAAe;GACb,MAAM,MAAO,OAAO,QAAgC,KAAK;GACzD,IAAI,YAAY,YAAY;GAC5B,OAAO,IAAI,YAAY;EACzB;EACA,SAAS,iBAAiB,SAAS,SAAS,WAAW,QAAS,WAAW;EAC3E,GAAG;CACL,CAA4F;AAC9F"}

package/build/react-query/{index.d.ts → index.d.cts}

@@ -1,4 +1,4 @@
-import { $n as TInferOutputFromSchema, Kn as IActionDomain, Pt as ActionCore, Qn as TInferInputFromSchema, nr as ActionSchema, rr as TInferActionError } from "../ActionPayload.types-BN-rXFBK.js";
+import { $n as TInferOutputFromSchema, Kn as IActionDomain, Pt as ActionCore, Qn as TInferInputFromSchema, nr as ActionSchema, rr as TInferActionError } from "../ActionPayload.types-BN-rXFBK.cjs";
 import { QueryKey, UseMutationOptions, UseMutationResult, UseQueryOptions, UseQueryResult } from "@tanstack/react-query";
 
 //#region src/react-query/hooks/useActionMutation.d.ts
@@ -14,4 +14,4 @@ type TUseActionQueryOptions<DOM extends IActionDomain, ID extends keyof DOM["act
 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>, ...args: [TInferInputFromSchema<SCH>["Input"]] extends [never] ? [options?: TUseActionQueryOptions<DOM, ID, SCH, TSelect>] : [input: TInferInputFromSchema<SCH>["Input"] | null | undefined, options?: TUseActionQueryOptions<DOM, ID, SCH, TSelect>]): UseQueryResult<TSelect, TInferActionError<SCH>>;
 //#endregion
 export { TActionMutationVars, TUseActionQueryOptions, TUseNiceMutationOptions, actionQueryKey, useActionMutation, useActionQuery };
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=index.d.cts.map

package/build/react-query/index.d.mts

@@ -0,0 +1,17 @@
+import { $n as TInferOutputFromSchema, Kn as IActionDomain, Pt as ActionCore, Qn as TInferInputFromSchema, nr as ActionSchema, rr as TInferActionError } from "../ActionPayload.types-D28ELKXC.mjs";
+import { QueryKey, UseMutationOptions, UseMutationResult, UseQueryOptions, UseQueryResult } from "@tanstack/react-query";
+
+//#region src/react-query/hooks/useActionMutation.d.ts
+/** When an action has no input schema (Input = never), use void so mutate() needs no arguments. */
+type TActionMutationVars<SCH extends ActionSchema<any, any, any>> = [TInferInputFromSchema<SCH>["Input"]] extends [never] ? void : TInferInputFromSchema<SCH>["Input"];
+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">;
+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>;
+//#endregion
+//#region src/react-query/hooks/useActionQuery.d.ts
+declare function actionQueryKey<DOM extends IActionDomain, ID extends keyof DOM["actionSchema"] & string>(action: ActionCore<DOM, ID>): readonly ["nice-action", DOM["domain"], DOM["allDomains"], ID];
+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"], ID, TInferInputFromSchema<DOM["actionSchema"][ID]>["Input"]];
+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">;
+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>, ...args: [TInferInputFromSchema<SCH>["Input"]] extends [never] ? [options?: TUseActionQueryOptions<DOM, ID, SCH, TSelect>] : [input: TInferInputFromSchema<SCH>["Input"] | null | undefined, options?: TUseActionQueryOptions<DOM, ID, SCH, TSelect>]): UseQueryResult<TSelect, TInferActionError<SCH>>;
+//#endregion
+export { TActionMutationVars, TUseActionQueryOptions, TUseNiceMutationOptions, actionQueryKey, useActionMutation, useActionQuery };
+//# sourceMappingURL=index.d.mts.map

package/build/react-query/{index.js → index.mjs}

@@ -64,4 +64,4 @@ function useActionQuery(action, ...args) {
 //#endregion
 export { actionQueryKey, useActionMutation, useActionQuery };
 
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.mjs.map

package/build/react-query/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/react-query/hooks/useActionMutation.ts","../../src/react-query/hooks/useActionQuery.ts"],"sourcesContent":["import {\r\n  type UseMutationOptions,\r\n  type UseMutationResult,\r\n  useMutation,\r\n} from \"@tanstack/react-query\";\r\nimport { useRef } from \"react\";\r\nimport type { ActionCore } from \"../../ActionDefinition/Action/Core/ActionCore\";\r\nimport type {\r\n  IActionDomain,\r\n  TInferInputFromSchema,\r\n  TInferOutputFromSchema,\r\n} from \"../../ActionDefinition/Domain/ActionDomain.types\";\r\nimport type { ActionSchema, TInferActionError } from \"../../ActionDefinition/Schema/ActionSchema\";\r\n\r\n/** When an action has no input schema (Input = never), use void so mutate() needs no arguments. */\r\nexport type TActionMutationVars<SCH extends ActionSchema<any, any, any>> = [\r\n  TInferInputFromSchema<SCH>[\"Input\"],\r\n] extends [never]\r\n  ? void\r\n  : TInferInputFromSchema<SCH>[\"Input\"];\r\n\r\nexport type TUseNiceMutationOptions<\r\n  DOM extends IActionDomain,\r\n  ID extends keyof DOM[\"actionSchema\"] & string,\r\n  SCH extends DOM[\"actionSchema\"][ID] = DOM[\"actionSchema\"][ID],\r\n  TContext = unknown,\r\n> = Omit<\r\n  UseMutationOptions<\r\n    TInferOutputFromSchema<SCH>[\"Output\"],\r\n    TInferActionError<SCH>,\r\n    TActionMutationVars<SCH>,\r\n    TContext\r\n  >,\r\n  \"mutationFn\"\r\n>;\r\n\r\nexport function useActionMutation<\r\n  DOM extends IActionDomain,\r\n  ID extends keyof DOM[\"actionSchema\"] & string,\r\n  SCH extends DOM[\"actionSchema\"][ID],\r\n  TContext = unknown,\r\n>(\r\n  action: ActionCore<DOM, ID>,\r\n  options?: TUseNiceMutationOptions<DOM, ID, SCH, TContext>,\r\n): UseMutationResult<\r\n  TInferOutputFromSchema<SCH>[\"Output\"],\r\n  TInferActionError<SCH>,\r\n  TActionMutationVars<SCH>,\r\n  TContext\r\n> {\r\n  const mutationOptions = options ?? {};\r\n\r\n  // Side-channel for the call site: mutate() writes it synchronously, mutationFn reads it.\r\n  // React Query calls mutationFn synchronously within mutate(), so the ref is always fresh.\r\n  const callSiteRef = useRef<string | undefined>(undefined);\r\n\r\n  const result = useMutation({\r\n    mutationFn: (input: TActionMutationVars<SCH>) => {\r\n      const req = action.request(input as unknown as TInferInputFromSchema<SCH>[\"Input\"]);\r\n      req._callSite = callSiteRef.current;\r\n      callSiteRef.current = undefined;\r\n      return req.runToOutput();\r\n    },\r\n    ...mutationOptions,\r\n  });\r\n\r\n  // Wrap mutate/mutateAsync so the call site is captured at the user's invocation point.\r\n  // By the time mutationFn runs inside React Query's scheduler the user's frames are gone.\r\n  return {\r\n    ...result,\r\n    mutate: (...args: Parameters<typeof result.mutate>) => {\r\n      callSiteRef.current = new Error().stack;\r\n      return result.mutate(...args);\r\n    },\r\n    mutateAsync: (...args: Parameters<typeof result.mutateAsync>) => {\r\n      callSiteRef.current = new Error().stack;\r\n      return result.mutateAsync(...args);\r\n    },\r\n  };\r\n}\r\n","import {\n  type QueryKey,\n  type UseQueryOptions,\n  type UseQueryResult,\n  useQuery,\n} from \"@tanstack/react-query\";\nimport { useRef } from \"react\";\nimport type { ActionCore } from \"../../ActionDefinition/Action/Core/ActionCore\";\nimport type {\n  IActionDomain,\n  TInferInputFromSchema,\n  TInferOutputFromSchema,\n} from \"../../ActionDefinition/Domain/ActionDomain.types\";\nimport type { TInferActionError } from \"../../ActionDefinition/Schema/ActionSchema\";\n\nexport function actionQueryKey<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string,\n>(action: ActionCore<DOM, ID>): readonly [\"nice-action\", DOM[\"domain\"], DOM[\"allDomains\"], ID];\n\nexport function actionQueryKey<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string,\n>(\n  action: ActionCore<DOM, ID>,\n  input: TInferInputFromSchema<DOM[\"actionSchema\"][ID]>[\"Input\"],\n): readonly [\n  \"nice-action\",\n  DOM[\"domain\"],\n  DOM[\"allDomains\"],\n  ID,\n  TInferInputFromSchema<DOM[\"actionSchema\"][ID]>[\"Input\"],\n];\n\nexport function actionQueryKey(action: ActionCore<any, any>, input?: unknown): QueryKey {\n  if (input === undefined) {\n    return [\"nice-action\", action.domain, action.allDomains, action.id] as const;\n  }\n\n  return [\"nice-action\", action.domain, action.allDomains, action.id, input] as const;\n}\n\nexport type TUseActionQueryOptions<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string,\n  SCH extends DOM[\"actionSchema\"][ID] = DOM[\"actionSchema\"][ID],\n  TSelect = TInferOutputFromSchema<SCH>[\"Output\"],\n> = Omit<\n  UseQueryOptions<TInferOutputFromSchema<SCH>[\"Output\"], TInferActionError<SCH>, TSelect, QueryKey>,\n  \"queryKey\" | \"queryFn\"\n>;\n\nexport function useActionQuery<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string,\n  SCH extends DOM[\"actionSchema\"][ID],\n  TSelect = TInferOutputFromSchema<SCH>[\"Output\"],\n>(\n  action: ActionCore<DOM, ID>,\n  ...args: [TInferInputFromSchema<SCH>[\"Input\"]] extends [never]\n    ? [options?: TUseActionQueryOptions<DOM, ID, SCH, TSelect>]\n    : [\n        input: TInferInputFromSchema<SCH>[\"Input\"] | null | undefined,\n        options?: TUseActionQueryOptions<DOM, ID, SCH, TSelect>,\n      ]\n): UseQueryResult<TSelect, TInferActionError<SCH>> {\n  const hasInputSchema = action.schema.inputSchema != null;\n\n  let input: TInferInputFromSchema<SCH>[\"Input\"] | null | undefined;\n  let options: TUseActionQueryOptions<DOM, ID, SCH, TSelect> | undefined;\n\n  if (hasInputSchema) {\n    [input, options] = args as [\n      TInferInputFromSchema<SCH>[\"Input\"] | null | undefined,\n      TUseActionQueryOptions<DOM, ID, SCH, TSelect>?,\n    ];\n  } else {\n    [options] = args as [TUseActionQueryOptions<DOM, ID, SCH, TSelect>?];\n  }\n\n  const { enabled, ...queryOptions } = options ?? {};\n\n  // Capture the call site synchronously here — the user's component frame is on the\n  // stack now. By the time queryFn runs inside React Query's scheduler it's gone.\n  const callSiteRef = useRef(new Error().stack);\n\n  return useQuery({\n    queryKey: input != null ? actionQueryKey(action, input) : actionQueryKey(action),\n    queryFn: () => {\n      const req = (action.request as (input: any) => any)(input);\n      req._callSite = callSiteRef.current;\n      return req.runToOutput();\n    },\n    enabled: hasInputSchema ? input != null && (enabled ?? true) : (enabled ?? true),\n    ...queryOptions,\n  } as UseQueryOptions<TInferOutputFromSchema<SCH>[\"Output\"], TInferActionError<SCH>, TSelect>);\n}\n"],"mappings":";;;AAoCA,SAAgB,kBAMd,QACA,SAMA;CACA,MAAM,kBAAkB,WAAW,CAAC;CAIpC,MAAM,cAAc,OAA2B,KAAA,CAAS;CAExD,MAAM,SAAS,YAAY;EACzB,aAAa,UAAoC;GAC/C,MAAM,MAAM,OAAO,QAAQ,KAAuD;GAClF,IAAI,YAAY,YAAY;GAC5B,YAAY,UAAU,KAAA;GACtB,OAAO,IAAI,YAAY;EACzB;EACA,GAAG;CACL,CAAC;CAID,OAAO;EACL,GAAG;EACH,SAAS,GAAG,SAA2C;GACrD,YAAY,2BAAU,IAAI,MAAM,EAAA,CAAE;GAClC,OAAO,OAAO,OAAO,GAAG,IAAI;EAC9B;EACA,cAAc,GAAG,SAAgD;GAC/D,YAAY,2BAAU,IAAI,MAAM,EAAA,CAAE;GAClC,OAAO,OAAO,YAAY,GAAG,IAAI;EACnC;CACF;AACF;;;AC7CA,SAAgB,eAAe,QAA8B,OAA2B;CACtF,IAAI,UAAU,KAAA,GACZ,OAAO;EAAC;EAAe,OAAO;EAAQ,OAAO;EAAY,OAAO;CAAE;CAGpE,OAAO;EAAC;EAAe,OAAO;EAAQ,OAAO;EAAY,OAAO;EAAI;CAAK;AAC3E;AAYA,SAAgB,eAMd,QACA,GAAG,MAM8C;CACjD,MAAM,iBAAiB,OAAO,OAAO,eAAe;CAEpD,IAAI;CACJ,IAAI;CAEJ,IAAI,gBACF,CAAC,OAAO,WAAW;MAKnB,CAAC,WAAW;CAGd,MAAM,EAAE,SAAS,GAAG,iBAAiB,WAAW,CAAC;CAIjD,MAAM,cAAc,wBAAO,IAAI,MAAM,EAAA,CAAE,KAAK;CAE5C,OAAO,SAAS;EACd,UAAU,SAAS,OAAO,eAAe,QAAQ,KAAK,IAAI,eAAe,MAAM;EAC/E,eAAe;GACb,MAAM,MAAO,OAAO,QAAgC,KAAK;GACzD,IAAI,YAAY,YAAY;GAC5B,OAAO,IAAI,YAAY;EACzB;EACA,SAAS,iBAAiB,SAAS,SAAS,WAAW,QAAS,WAAW;EAC3E,GAAG;CACL,CAA4F;AAC9F"}

package/package.json

@@ -1,26 +1,53 @@
 {
   "name": "@nice-code/action",
-  "version": "0.10.0",
+  "version": "0.11.0",
+  "main": "./build/index.cjs",
+  "module": "./build/index.mjs",
+  "types": "./build/index.d.cts",
   "exports": {
     ".": {
       "source": "./src/index.ts",
-      "import": "./build/index.js",
-      "types": "./build/index.d.ts"
+      "import": {
+        "types": "./build/index.d.mts",
+        "default": "./build/index.mjs"
+      },
+      "require": {
+        "types": "./build/index.d.cts",
+        "default": "./build/index.cjs"
+      }
     },
     "./devtools/browser": {
       "source": "./src/devtools/browser/index.ts",
-      "import": "./build/devtools/browser/index.js",
-      "types": "./build/devtools/browser/index.d.ts"
+      "import": {
+        "types": "./build/devtools/browser/index.d.mts",
+        "default": "./build/devtools/browser/index.mjs"
+      },
+      "require": {
+        "types": "./build/devtools/browser/index.d.cts",
+        "default": "./build/devtools/browser/index.cjs"
+      }
     },
     "./devtools/server": {
       "source": "./src/devtools/server/index.ts",
-      "import": "./build/devtools/server/index.js",
-      "types": "./build/devtools/server/index.d.ts"
+      "import": {
+        "types": "./build/devtools/server/index.d.mts",
+        "default": "./build/devtools/server/index.mjs"
+      },
+      "require": {
+        "types": "./build/devtools/server/index.d.cts",
+        "default": "./build/devtools/server/index.cjs"
+      }
     },
     "./react-query": {
       "source": "./src/react-query/index.ts",
-      "import": "./build/react-query/index.js",
-      "types": "./build/react-query/index.d.ts"
+      "import": {
+        "types": "./build/react-query/index.d.mts",
+        "default": "./build/react-query/index.mjs"
+      },
+      "require": {
+        "types": "./build/react-query/index.d.cts",
+        "default": "./build/react-query/index.cjs"
+      }
     }
   },
   "files": [
@@ -39,10 +66,7 @@
     "access": "public"
   },
   "scripts": {
-    "build-bun": "bun run clean-build && bun run build.ts && bun run build-types",
     "build": "bun run clean-build && tsdown",
-    "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",
@@ -51,9 +75,9 @@
   },
   "type": "module",
   "dependencies": {
-    "@nice-code/common-errors": "0.10.0",
-    "@nice-code/error": "0.10.0",
-    "@nice-code/util": "0.10.0",
+    "@nice-code/common-errors": "0.11.0",
+    "@nice-code/error": "0.11.0",
+    "@nice-code/util": "0.11.0",
     "@standard-schema/spec": "^1.1.0",
     "@tanstack/react-virtual": "^3.13.26",
     "http-status-codes": "^2.3.0",

package/build/ActionDevtoolsCore-BLeY_N-3.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ActionDevtoolsCore-BLeY_N-3.js","names":[],"sources":["../src/devtools/core/ActionDevtoolsCore.ts"],"sourcesContent":["import {\r\n  ERunningActionFinishedType,\r\n  ERunningActionUpdateType,\r\n} from \"../../ActionDefinition/Action/RunningAction.types\";\r\nimport type {\r\n  IDevtoolsActionEntry,\r\n  IDevtoolsActionMeta,\r\n  IDevtoolsObservableDomain,\r\n  IDevtoolsRouteItem,\r\n  TDevtoolsListener,\r\n} from \"./ActionDevtools.types\";\r\n\r\nexport interface IActionDevtoolsCoreOptions {\r\n  /** Max root entries to retain. Older entries (and their children) are evicted. */\r\n  maxEntries?: number;\r\n}\r\n\r\nfunction serializeErrorForDisplay(error: unknown): unknown {\r\n  if (\r\n    error != null &&\r\n    typeof error === \"object\" &&\r\n    (error as any).name === \"NiceError\" &&\r\n    typeof (error as any).toJsonObject === \"function\"\r\n  ) {\r\n    return (error as any).toJsonObject();\r\n  }\r\n  return error;\r\n}\r\n\r\nfunction extractRouting(context: any): IDevtoolsRouteItem[] {\r\n  return (context?.routing ?? []).map((item: any): IDevtoolsRouteItem => {\r\n    const handler = item.handler;\r\n    const isExternal = handler?.type === \"external\";\r\n    return {\r\n      runtime: {\r\n        envId: item.runtime?.envId ?? \"unknown\",\r\n        perId: item.runtime?.perId,\r\n        insId: item.runtime?.insId,\r\n      },\r\n      handlerType: isExternal ? \"external\" : \"local\",\r\n      handlerClient:\r\n        isExternal && handler.client != null\r\n          ? {\r\n              envId: handler.client.envId ?? \"unknown\",\r\n              perId: handler.client.perId,\r\n              insId: handler.client.insId,\r\n            }\r\n          : undefined,\r\n      transport: isExternal ? handler.transType : undefined,\r\n      transportSummary: isExternal ? handler.transInfo?.summary : undefined,\r\n      transportUrl: isExternal ? handler.transInfo?.url : undefined,\r\n      time: item.time,\r\n    };\r\n  });\r\n}\r\n\r\nfunction extractMeta(context: any): IDevtoolsActionMeta {\r\n  return {\r\n    timeCreated: context?.timeCreated ?? Date.now(),\r\n    originClient: {\r\n      envId: context?.originClient?.envId ?? \"unknown\",\r\n      perId: context?.originClient?.perId,\r\n      insId: context?.originClient?.insId,\r\n    },\r\n    routing: extractRouting(context),\r\n  };\r\n}\r\n\r\nexport class ActionDevtoolsCore {\r\n  private _entries: IDevtoolsActionEntry[] = [];\r\n  private _listeners: Set<TDevtoolsListener> = new Set();\r\n  private readonly _maxEntries: number;\r\n\r\n  constructor(options: IActionDevtoolsCoreOptions = {}) {\r\n    this._maxEntries = options.maxEntries ?? 500;\r\n  }\r\n\r\n  attachToDomain(domain: IDevtoolsObservableDomain): () => void {\r\n    return domain.addActionListener((update) => {\r\n      const { runningAction, type, time } = update;\r\n\r\n      if (type === ERunningActionUpdateType.started) {\r\n        const entry: IDevtoolsActionEntry = {\r\n          cuid: runningAction.cuid,\r\n          actionId: runningAction.id,\r\n          domain: runningAction.domain,\r\n          allDomains: [...runningAction.allDomains],\r\n          status: \"running\",\r\n          startTime: time,\r\n          input: runningAction.state?.request?.input,\r\n          inputHash: runningAction.state?.request?.inputHash,\r\n          progressUpdates: [],\r\n          meta: extractMeta(runningAction.context),\r\n          parentCuid: runningAction.parentCuid,\r\n          callSite: runningAction.callSite,\r\n        };\r\n        this._entries = [entry, ...this._entries];\r\n        // Bound retention: entries are newest-first, so the oldest fall off the tail.\r\n        // Grouping already renders any child whose parent is gone as its own root, so\r\n        // dropping an old parent never breaks the surviving children's display.\r\n        if (this._entries.length > this._maxEntries) {\r\n          this._entries.length = this._maxEntries;\r\n        }\r\n        this._notify();\r\n      } else if (type === ERunningActionUpdateType.progress) {\r\n        this._updateEntry(runningAction.cuid, (e) => ({\r\n          ...e,\r\n          progressUpdates: [...e.progressUpdates, update.progress],\r\n        }));\r\n      } else if (type === ERunningActionUpdateType.finished) {\r\n        this._updateEntry(runningAction.cuid, (e) => {\r\n          // On success the result payload's context may carry the full routing from the handling\r\n          // runtime (including backend hops) — richer than the local context, which only has this\r\n          // side's outgoing hops. Prefer it *only when it's actually richer*: the optimized binary\r\n          // WS session strips routing from the wire and reconstructs an empty array, so an empty\r\n          // response routing must never clobber the real local hops (otherwise the entry renders as\r\n          // \"call\"/\"local\" instead of \"→ ws → backend\").\r\n          const responseRouting = extractRouting((update as any).response?.context);\r\n          const localRouting = extractRouting(runningAction.context);\r\n          const routing =\r\n            responseRouting.length >= localRouting.length ? responseRouting : localRouting;\r\n          const base: IDevtoolsActionEntry = {\r\n            ...e,\r\n            endTime: time,\r\n            meta: { ...e.meta, routing },\r\n          };\r\n          const finishType: string = update.finishType;\r\n\r\n          if (finishType === ERunningActionFinishedType.success) {\r\n            const result = update.response?.result;\r\n            const outputHash: string | undefined = update.response?.outputHash;\r\n            if (result != null && !result.ok) {\r\n              const rawError = result.error;\r\n              const errorStack = rawError instanceof Error ? rawError.stack : undefined;\r\n              return {\r\n                ...base,\r\n                status: \"action-error\",\r\n                outputHash,\r\n                error: serializeErrorForDisplay(rawError),\r\n                errorStack,\r\n              };\r\n            }\r\n            return { ...base, status: \"success\", output: result?.output, outputHash };\r\n          }\r\n          if (finishType === ERunningActionFinishedType.failed) {\r\n            const rawError = (update as any).error;\r\n            const errorStack = rawError instanceof Error ? rawError.stack : undefined;\r\n            return {\r\n              ...base,\r\n              status: \"failed\",\r\n              error: serializeErrorForDisplay(rawError),\r\n              errorStack,\r\n            };\r\n          }\r\n          const abortReason = update.reason;\r\n          const errorStack = abortReason instanceof Error ? abortReason.stack : undefined;\r\n          return {\r\n            ...base,\r\n            status: \"aborted\",\r\n            abortReason: serializeErrorForDisplay(abortReason),\r\n            errorStack,\r\n          };\r\n        });\r\n      }\r\n    });\r\n  }\r\n\r\n  getEntries(): readonly IDevtoolsActionEntry[] {\r\n    return this._entries;\r\n  }\r\n\r\n  subscribe(listener: TDevtoolsListener): () => void {\r\n    this._listeners.add(listener);\r\n    listener(this._entries);\r\n    return () => {\r\n      this._listeners.delete(listener);\r\n    };\r\n  }\r\n\r\n  clear(): void {\r\n    this._entries = [];\r\n    this._notify();\r\n  }\r\n\r\n  private _updateEntry(\r\n    cuid: string,\r\n    updater: (entry: IDevtoolsActionEntry) => IDevtoolsActionEntry,\r\n  ): void {\r\n    this._entries = this._entries.map((e) => (e.cuid === cuid ? updater(e) : e));\r\n    this._notify();\r\n  }\r\n\r\n  private _notify(): void {\r\n    const snapshot = this._entries;\r\n    for (const listener of this._listeners) listener(snapshot);\r\n  }\r\n}\r\n"],"mappings":"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"}

package/build/ActionDevtoolsCore-yfJ9tkvl.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ActionDevtoolsCore-yfJ9tkvl.js","names":[],"sources":["../src/devtools/core/ActionDevtoolsCore.ts"],"sourcesContent":["import {\r\n  ERunningActionFinishedType,\r\n  ERunningActionUpdateType,\r\n} from \"../../ActionDefinition/Action/RunningAction.types\";\r\nimport type {\r\n  IDevtoolsActionEntry,\r\n  IDevtoolsActionMeta,\r\n  IDevtoolsObservableDomain,\r\n  IDevtoolsRouteItem,\r\n  TDevtoolsListener,\r\n} from \"./ActionDevtools.types\";\r\n\r\nexport interface IActionDevtoolsCoreOptions {\r\n  /** Max root entries to retain. Older entries (and their children) are evicted. */\r\n  maxEntries?: number;\r\n}\r\n\r\nfunction serializeErrorForDisplay(error: unknown): unknown {\r\n  if (\r\n    error != null &&\r\n    typeof error === \"object\" &&\r\n    (error as any).name === \"NiceError\" &&\r\n    typeof (error as any).toJsonObject === \"function\"\r\n  ) {\r\n    return (error as any).toJsonObject();\r\n  }\r\n  return error;\r\n}\r\n\r\nfunction extractRouting(context: any): IDevtoolsRouteItem[] {\r\n  return (context?.routing ?? []).map((item: any): IDevtoolsRouteItem => {\r\n    const handler = item.handler;\r\n    const isExternal = handler?.type === \"external\";\r\n    return {\r\n      runtime: {\r\n        envId: item.runtime?.envId ?? \"unknown\",\r\n        perId: item.runtime?.perId,\r\n        insId: item.runtime?.insId,\r\n      },\r\n      handlerType: isExternal ? \"external\" : \"local\",\r\n      handlerClient:\r\n        isExternal && handler.client != null\r\n          ? {\r\n              envId: handler.client.envId ?? \"unknown\",\r\n              perId: handler.client.perId,\r\n              insId: handler.client.insId,\r\n            }\r\n          : undefined,\r\n      transport: isExternal ? handler.transType : undefined,\r\n      transportSummary: isExternal ? handler.transInfo?.summary : undefined,\r\n      transportUrl: isExternal ? handler.transInfo?.url : undefined,\r\n      time: item.time,\r\n    };\r\n  });\r\n}\r\n\r\nfunction extractMeta(context: any): IDevtoolsActionMeta {\r\n  return {\r\n    timeCreated: context?.timeCreated ?? Date.now(),\r\n    originClient: {\r\n      envId: context?.originClient?.envId ?? \"unknown\",\r\n      perId: context?.originClient?.perId,\r\n      insId: context?.originClient?.insId,\r\n    },\r\n    routing: extractRouting(context),\r\n  };\r\n}\r\n\r\nexport class ActionDevtoolsCore {\r\n  private _entries: IDevtoolsActionEntry[] = [];\r\n  private _listeners: Set<TDevtoolsListener> = new Set();\r\n  private readonly _maxEntries: number;\r\n\r\n  constructor(options: IActionDevtoolsCoreOptions = {}) {\r\n    this._maxEntries = options.maxEntries ?? 500;\r\n  }\r\n\r\n  attachToDomain(domain: IDevtoolsObservableDomain): () => void {\r\n    return domain.addActionListener((update) => {\r\n      const { runningAction, type, time } = update;\r\n\r\n      if (type === ERunningActionUpdateType.started) {\r\n        const entry: IDevtoolsActionEntry = {\r\n          cuid: runningAction.cuid,\r\n          actionId: runningAction.id,\r\n          domain: runningAction.domain,\r\n          allDomains: [...runningAction.allDomains],\r\n          status: \"running\",\r\n          startTime: time,\r\n          input: runningAction.state?.request?.input,\r\n          inputHash: runningAction.state?.request?.inputHash,\r\n          progressUpdates: [],\r\n          meta: extractMeta(runningAction.context),\r\n          parentCuid: runningAction.parentCuid,\r\n          callSite: runningAction.callSite,\r\n        };\r\n        this._entries = [entry, ...this._entries];\r\n        // Bound retention: entries are newest-first, so the oldest fall off the tail.\r\n        // Grouping already renders any child whose parent is gone as its own root, so\r\n        // dropping an old parent never breaks the surviving children's display.\r\n        if (this._entries.length > this._maxEntries) {\r\n          this._entries.length = this._maxEntries;\r\n        }\r\n        this._notify();\r\n      } else if (type === ERunningActionUpdateType.progress) {\r\n        this._updateEntry(runningAction.cuid, (e) => ({\r\n          ...e,\r\n          progressUpdates: [...e.progressUpdates, update.progress],\r\n        }));\r\n      } else if (type === ERunningActionUpdateType.finished) {\r\n        this._updateEntry(runningAction.cuid, (e) => {\r\n          // On success the result payload's context may carry the full routing from the handling\r\n          // runtime (including backend hops) — richer than the local context, which only has this\r\n          // side's outgoing hops. Prefer it *only when it's actually richer*: the optimized binary\r\n          // WS session strips routing from the wire and reconstructs an empty array, so an empty\r\n          // response routing must never clobber the real local hops (otherwise the entry renders as\r\n          // \"call\"/\"local\" instead of \"→ ws → backend\").\r\n          const responseRouting = extractRouting((update as any).response?.context);\r\n          const localRouting = extractRouting(runningAction.context);\r\n          const routing =\r\n            responseRouting.length >= localRouting.length ? responseRouting : localRouting;\r\n          const base: IDevtoolsActionEntry = {\r\n            ...e,\r\n            endTime: time,\r\n            meta: { ...e.meta, routing },\r\n          };\r\n          const finishType: string = update.finishType;\r\n\r\n          if (finishType === ERunningActionFinishedType.success) {\r\n            const result = update.response?.result;\r\n            const outputHash: string | undefined = update.response?.outputHash;\r\n            if (result != null && !result.ok) {\r\n              const rawError = result.error;\r\n              const errorStack = rawError instanceof Error ? rawError.stack : undefined;\r\n              return {\r\n                ...base,\r\n                status: \"action-error\",\r\n                outputHash,\r\n                error: serializeErrorForDisplay(rawError),\r\n                errorStack,\r\n              };\r\n            }\r\n            return { ...base, status: \"success\", output: result?.output, outputHash };\r\n          }\r\n          if (finishType === ERunningActionFinishedType.failed) {\r\n            const rawError = (update as any).error;\r\n            const errorStack = rawError instanceof Error ? rawError.stack : undefined;\r\n            return {\r\n              ...base,\r\n              status: \"failed\",\r\n              error: serializeErrorForDisplay(rawError),\r\n              errorStack,\r\n            };\r\n          }\r\n          const abortReason = update.reason;\r\n          const errorStack = abortReason instanceof Error ? abortReason.stack : undefined;\r\n          return {\r\n            ...base,\r\n            status: \"aborted\",\r\n            abortReason: serializeErrorForDisplay(abortReason),\r\n            errorStack,\r\n          };\r\n        });\r\n      }\r\n    });\r\n  }\r\n\r\n  getEntries(): readonly IDevtoolsActionEntry[] {\r\n    return this._entries;\r\n  }\r\n\r\n  subscribe(listener: TDevtoolsListener): () => void {\r\n    this._listeners.add(listener);\r\n    listener(this._entries);\r\n    return () => {\r\n      this._listeners.delete(listener);\r\n    };\r\n  }\r\n\r\n  clear(): void {\r\n    this._entries = [];\r\n    this._notify();\r\n  }\r\n\r\n  private _updateEntry(\r\n    cuid: string,\r\n    updater: (entry: IDevtoolsActionEntry) => IDevtoolsActionEntry,\r\n  ): void {\r\n    this._entries = this._entries.map((e) => (e.cuid === cuid ? updater(e) : e));\r\n    this._notify();\r\n  }\r\n\r\n  private _notify(): void {\r\n    const snapshot = this._entries;\r\n    for (const listener of this._listeners) listener(snapshot);\r\n  }\r\n}\r\n"],"mappings":"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"}

package/build/RunningAction.types-C176rqHG.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"RunningAction.types-C176rqHG.js","names":[],"sources":["../src/ActionDefinition/Action/RunningAction.types.ts"],"sourcesContent":["import type { IActionDomain } from \"../Domain/ActionDomain.types\";\nimport type { TInferActionError } from \"../Schema/ActionSchema\";\nimport type { ActionContext } from \"./Context/ActionContext\";\nimport type { TActionProgress } from \"./Payload/ActionPayload.types\";\nimport type { ActionPayload_Progress } from \"./Payload/ActionPayload_Progress\";\nimport type { ActionPayload_Request } from \"./Payload/ActionPayload_Request\";\nimport type { ActionPayload_Result } from \"./Payload/ActionPayload_Result\";\nimport type { RunningAction } from \"./RunningAction\";\n\nexport enum ERunningActionState {\n  running = \"running\",\n  completed = \"completed\",\n}\n\nexport interface IRunningActionState<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string,\n> {\n  request: ActionPayload_Request<DOM, ID>;\n  progress: ActionPayload_Progress<DOM, ID>[];\n  result?: ActionPayload_Result<DOM, ID>;\n}\n\nexport interface IRunningActionState_ConstructorParams<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string,\n> {\n  context: ActionContext<DOM, ID>;\n  request: ActionPayload_Request<DOM, ID>;\n  progress?: ActionPayload_Progress<DOM, ID>[];\n  result?: ActionPayload_Result<DOM, ID>;\n  parentCuid?: string;\n  callSite?: string;\n}\n\n// export interface IActionRunningState_Running<\n//   DOM extends IActionDomain,\n//   ID extends keyof DOM[\"actions\"] & string = keyof DOM[\"actions\"] & string,\n// > {\n//   state: ERunningActionState.running;\n//   request: ActionPayload_Request<DOM, ID>;\n//   lastProgress: ActionPayload_Progress;\n// }\n\n// export interface IActionRunningState_Completed<\n//   DOM extends IActionDomain,\n//   ID extends keyof DOM[\"actions\"] & string = keyof DOM[\"actions\"] & string,\n// > {\n//   state: ERunningActionState.completed;\n//   request: ActionPayload_Request<DOM, ID>;\n//   response: ActionPayload_Result<DOM, ID>;\n// }\n\n// export type TRunningActionState<\n//   DOM extends IActionDomain,\n//   ID extends keyof DOM[\"actions\"] & string = keyof DOM[\"actions\"] & string,\n// > = IActionRunningState_Running<DOM, ID> | IActionRunningState_Completed<DOM, ID>;\n\nexport enum ERunningActionUpdateType {\n  started = \"started\",\n  progress = \"progress\",\n  finished = \"finished\",\n}\n\nexport interface IRunningActionEvent_Base<\n  T extends ERunningActionUpdateType,\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> {\n  type: T;\n  runningAction: RunningAction<DOM, ID>;\n  time: number;\n}\n\nexport interface IRunningActionUpdate_Started<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> extends IRunningActionEvent_Base<ERunningActionUpdateType.started, DOM, ID> {}\n\nexport interface IRunningActionUpdate_Progress<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> extends IRunningActionEvent_Base<ERunningActionUpdateType.progress, DOM, ID> {\n  progress: TActionProgress;\n}\n\nexport enum ERunningActionFinishedType {\n  aborted = \"aborted\",\n  failed = \"failed\",\n  success = \"success\",\n}\n\nexport interface IRunningActionUpdate_Finished<\n  FT extends ERunningActionFinishedType,\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> extends IRunningActionEvent_Base<ERunningActionUpdateType.finished, DOM, ID> {\n  finishType: FT;\n  reason?: unknown;\n}\n\nexport interface IRunningActionUpdate_Abort<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> extends IRunningActionUpdate_Finished<ERunningActionFinishedType.aborted, DOM, ID> {\n  reason?: unknown;\n}\n\nexport interface IRunningActionUpdate_Failed<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> extends IRunningActionUpdate_Finished<ERunningActionFinishedType.failed, DOM, ID> {\n  error: TInferActionError<DOM[\"actionSchema\"][ID]>;\n}\n\nexport interface IRunningActionUpdate_Success<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> extends IRunningActionUpdate_Finished<ERunningActionFinishedType.success, DOM, ID> {\n  response: ActionPayload_Result<DOM, ID>;\n}\n\nexport type TRunningActionUpdateFinished<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> =\n  | IRunningActionUpdate_Abort<DOM, ID>\n  | IRunningActionUpdate_Failed<DOM, ID>\n  | IRunningActionUpdate_Success<DOM, ID>;\n\nexport type TRunningActionUpdate<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> =\n  | IRunningActionUpdate_Started<DOM, ID>\n  | IRunningActionUpdate_Progress<DOM, ID>\n  | TRunningActionUpdateFinished<DOM, ID>;\n\nexport type TRunningActionUpdateListener<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> = (update: TRunningActionUpdate<DOM, ID>) => void;\n\n/**\n * Distributes a union ID into a proper discriminated union of RunningAction update events,\n * so that narrowing on `update.runningAction.id` also narrows `update.runningAction`'s input/output types.\n */\nexport type TDistributeRunningActionUpdate<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> = ID extends keyof DOM[\"actionSchema\"] & string ? TRunningActionUpdate<DOM, ID> : never;\n\nexport type TDistributeRunningActionUpdateListener<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> = (update: TDistributeRunningActionUpdate<DOM, ID>) => void;\n\nexport interface IRunningActionUserMethods<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string,\n> {\n  waitForResultPayload(): Promise<ActionPayload_Result<DOM, ID>>;\n  addUpdateListeners(listeners: TRunningActionUpdateListener<DOM, ID>[]): () => void;\n  iterateUpdates(): AsyncIterable<TRunningActionUpdate<DOM, ID>>;\n  abort(reason?: unknown): void;\n}\n"],"mappings":";AASA,IAAY,sBAAL,yBAAA,qBAAA;CACL,oBAAA,aAAA;CACA,oBAAA,eAAA;;AACF,EAAA,CAAA,CAAA;AA8CA,IAAY,2BAAL,yBAAA,0BAAA;CACL,yBAAA,aAAA;CACA,yBAAA,cAAA;CACA,yBAAA,cAAA;;AACF,EAAA,CAAA,CAAA;AAwBA,IAAY,6BAAL,yBAAA,4BAAA;CACL,2BAAA,aAAA;CACA,2BAAA,YAAA;CACA,2BAAA,aAAA;;AACF,EAAA,CAAA,CAAA"}

package/build/RunningAction.types-DjCX1xp5.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"RunningAction.types-DjCX1xp5.js","names":[],"sources":["../src/ActionDefinition/Action/RunningAction.types.ts"],"sourcesContent":["import type { IActionDomain } from \"../Domain/ActionDomain.types\";\nimport type { TInferActionError } from \"../Schema/ActionSchema\";\nimport type { ActionContext } from \"./Context/ActionContext\";\nimport type { TActionProgress } from \"./Payload/ActionPayload.types\";\nimport type { ActionPayload_Progress } from \"./Payload/ActionPayload_Progress\";\nimport type { ActionPayload_Request } from \"./Payload/ActionPayload_Request\";\nimport type { ActionPayload_Result } from \"./Payload/ActionPayload_Result\";\nimport type { RunningAction } from \"./RunningAction\";\n\nexport enum ERunningActionState {\n  running = \"running\",\n  completed = \"completed\",\n}\n\nexport interface IRunningActionState<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string,\n> {\n  request: ActionPayload_Request<DOM, ID>;\n  progress: ActionPayload_Progress<DOM, ID>[];\n  result?: ActionPayload_Result<DOM, ID>;\n}\n\nexport interface IRunningActionState_ConstructorParams<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string,\n> {\n  context: ActionContext<DOM, ID>;\n  request: ActionPayload_Request<DOM, ID>;\n  progress?: ActionPayload_Progress<DOM, ID>[];\n  result?: ActionPayload_Result<DOM, ID>;\n  parentCuid?: string;\n  callSite?: string;\n}\n\n// export interface IActionRunningState_Running<\n//   DOM extends IActionDomain,\n//   ID extends keyof DOM[\"actions\"] & string = keyof DOM[\"actions\"] & string,\n// > {\n//   state: ERunningActionState.running;\n//   request: ActionPayload_Request<DOM, ID>;\n//   lastProgress: ActionPayload_Progress;\n// }\n\n// export interface IActionRunningState_Completed<\n//   DOM extends IActionDomain,\n//   ID extends keyof DOM[\"actions\"] & string = keyof DOM[\"actions\"] & string,\n// > {\n//   state: ERunningActionState.completed;\n//   request: ActionPayload_Request<DOM, ID>;\n//   response: ActionPayload_Result<DOM, ID>;\n// }\n\n// export type TRunningActionState<\n//   DOM extends IActionDomain,\n//   ID extends keyof DOM[\"actions\"] & string = keyof DOM[\"actions\"] & string,\n// > = IActionRunningState_Running<DOM, ID> | IActionRunningState_Completed<DOM, ID>;\n\nexport enum ERunningActionUpdateType {\n  started = \"started\",\n  progress = \"progress\",\n  finished = \"finished\",\n}\n\nexport interface IRunningActionEvent_Base<\n  T extends ERunningActionUpdateType,\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> {\n  type: T;\n  runningAction: RunningAction<DOM, ID>;\n  time: number;\n}\n\nexport interface IRunningActionUpdate_Started<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> extends IRunningActionEvent_Base<ERunningActionUpdateType.started, DOM, ID> {}\n\nexport interface IRunningActionUpdate_Progress<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> extends IRunningActionEvent_Base<ERunningActionUpdateType.progress, DOM, ID> {\n  progress: TActionProgress;\n}\n\nexport enum ERunningActionFinishedType {\n  aborted = \"aborted\",\n  failed = \"failed\",\n  success = \"success\",\n}\n\nexport interface IRunningActionUpdate_Finished<\n  FT extends ERunningActionFinishedType,\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> extends IRunningActionEvent_Base<ERunningActionUpdateType.finished, DOM, ID> {\n  finishType: FT;\n  reason?: unknown;\n}\n\nexport interface IRunningActionUpdate_Abort<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> extends IRunningActionUpdate_Finished<ERunningActionFinishedType.aborted, DOM, ID> {\n  reason?: unknown;\n}\n\nexport interface IRunningActionUpdate_Failed<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> extends IRunningActionUpdate_Finished<ERunningActionFinishedType.failed, DOM, ID> {\n  error: TInferActionError<DOM[\"actionSchema\"][ID]>;\n}\n\nexport interface IRunningActionUpdate_Success<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> extends IRunningActionUpdate_Finished<ERunningActionFinishedType.success, DOM, ID> {\n  response: ActionPayload_Result<DOM, ID>;\n}\n\nexport type TRunningActionUpdateFinished<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> =\n  | IRunningActionUpdate_Abort<DOM, ID>\n  | IRunningActionUpdate_Failed<DOM, ID>\n  | IRunningActionUpdate_Success<DOM, ID>;\n\nexport type TRunningActionUpdate<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> =\n  | IRunningActionUpdate_Started<DOM, ID>\n  | IRunningActionUpdate_Progress<DOM, ID>\n  | TRunningActionUpdateFinished<DOM, ID>;\n\nexport type TRunningActionUpdateListener<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> = (update: TRunningActionUpdate<DOM, ID>) => void;\n\n/**\n * Distributes a union ID into a proper discriminated union of RunningAction update events,\n * so that narrowing on `update.runningAction.id` also narrows `update.runningAction`'s input/output types.\n */\nexport type TDistributeRunningActionUpdate<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> = ID extends keyof DOM[\"actionSchema\"] & string ? TRunningActionUpdate<DOM, ID> : never;\n\nexport type TDistributeRunningActionUpdateListener<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string = keyof DOM[\"actionSchema\"] & string,\n> = (update: TDistributeRunningActionUpdate<DOM, ID>) => void;\n\nexport interface IRunningActionUserMethods<\n  DOM extends IActionDomain,\n  ID extends keyof DOM[\"actionSchema\"] & string,\n> {\n  waitForResultPayload(): Promise<ActionPayload_Result<DOM, ID>>;\n  addUpdateListeners(listeners: TRunningActionUpdateListener<DOM, ID>[]): () => void;\n  iterateUpdates(): AsyncIterable<TRunningActionUpdate<DOM, ID>>;\n  abort(reason?: unknown): void;\n}\n"],"mappings":";AASA,IAAY,sBAAL,yBAAA,qBAAA;CACL,oBAAA,aAAA;CACA,oBAAA,eAAA;;AACF,EAAA,CAAA,CAAA;AA8CA,IAAY,2BAAL,yBAAA,0BAAA;CACL,yBAAA,aAAA;CACA,yBAAA,cAAA;CACA,yBAAA,cAAA;;AACF,EAAA,CAAA,CAAA;AAwBA,IAAY,6BAAL,yBAAA,4BAAA;CACL,2BAAA,aAAA;CACA,2BAAA,YAAA;CACA,2BAAA,aAAA;;AACF,EAAA,CAAA,CAAA"}