@rxova/journey-core 1.0.0-rc.3 → 1.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rxova/journey-core",
-  "version": "1.0.0-rc.3",
+  "version": "1.0.0",
   "description": "Journey core state machine.",
   "keywords": [
     "journey",
@@ -41,6 +41,9 @@
   },
   "license": "MIT",
   "author": "Jonatan Kruszewski",
+  "engines": {
+    "node": ">=20.11.0"
+  },
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -54,53 +57,21 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
-    "./analytics": {
-      "types": {
-        "import": "./dist/plugins/analytics/index.d.ts",
-        "require": "./dist/plugins/analytics/index.d.cts"
-      },
-      "import": "./dist/plugins/analytics/index.js",
-      "require": "./dist/plugins/analytics/index.cjs"
-    },
-    "./autosave": {
-      "types": {
-        "import": "./dist/plugins/autosave/index.d.ts",
-        "require": "./dist/plugins/autosave/index.d.cts"
-      },
-      "import": "./dist/plugins/autosave/index.js",
-      "require": "./dist/plugins/autosave/index.cjs"
-    },
-    "./diagnostics": {
-      "types": {
-        "import": "./dist/plugins/diagnostics/index.d.ts",
-        "require": "./dist/plugins/diagnostics/index.d.cts"
-      },
-      "import": "./dist/plugins/diagnostics/index.js",
-      "require": "./dist/plugins/diagnostics/index.cjs"
-    },
-    "./persistence": {
+    "./plugins": {
       "types": {
-        "import": "./dist/plugins/persistence/index.d.ts",
-        "require": "./dist/plugins/persistence/index.d.cts"
+        "import": "./dist/plugins/index.d.ts",
+        "require": "./dist/plugins/index.d.cts"
       },
-      "import": "./dist/plugins/persistence/index.js",
-      "require": "./dist/plugins/persistence/index.cjs"
+      "import": "./dist/plugins/index.js",
+      "require": "./dist/plugins/index.cjs"
     },
-    "./replay": {
+    "./connectors/immer": {
       "types": {
-        "import": "./dist/plugins/replay/index.d.ts",
-        "require": "./dist/plugins/replay/index.d.cts"
+        "import": "./dist/connectors/immer/immer.d.ts",
+        "require": "./dist/connectors/immer/immer.d.cts"
       },
-      "import": "./dist/plugins/replay/index.js",
-      "require": "./dist/plugins/replay/index.cjs"
-    },
-    "./execution-paths": {
-      "types": {
-        "import": "./dist/plugins/execution-paths/index.d.ts",
-        "require": "./dist/plugins/execution-paths/index.d.cts"
-      },
-      "import": "./dist/plugins/execution-paths/index.js",
-      "require": "./dist/plugins/execution-paths/index.cjs"
+      "import": "./dist/connectors/immer/immer.js",
+      "require": "./dist/connectors/immer/immer.cjs"
     }
   },
   "files": [
@@ -109,67 +80,78 @@
     "LICENSE"
   ],
   "sideEffects": false,
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.5",
+    "@rxova/journey-common": "0.0.0",
+    "immer": "^11.1.15",
+    "publint": "^0.3.24"
+  },
+  "peerDependencies": {
+    "immer": "^11.1.15"
+  },
+  "peerDependenciesMeta": {
+    "immer": {
+      "optional": true
+    }
+  },
   "size-limit": [
     {
-      "name": "core/createJourneyMachine",
+      "name": "core/createLinearJourney",
       "path": "dist/index.js",
-      "import": "{ createJourneyMachine }",
-      "limit": "7.9 kB"
+      "import": "{ createLinearJourney }",
+      "limit": "6.2 kB"
     },
     {
-      "name": "core/createJourneyBuilder",
+      "name": "core/createGraphJourney",
       "path": "dist/index.js",
-      "import": "{ createJourneyBuilder }",
-      "limit": "1 kB"
+      "import": "{ createGraphJourney }",
+      "limit": "6.5 kB"
     },
     {
-      "name": "core/createPersistencePlugin",
-      "path": "dist/plugins/persistence/index.js",
-      "import": "{ createPersistencePlugin }",
-      "limit": "3 kB"
+      "name": "core/immerConnector",
+      "path": "dist/connectors/immer/immer.js",
+      "import": "{ immerConnector }",
+      "limit": "100 B"
     },
     {
-      "name": "core/createAnalyticsPlugin",
-      "path": "dist/plugins/analytics/index.js",
-      "import": "{ createAnalyticsPlugin }",
-      "limit": "2 kB"
+      "name": "core/createExecutionPathsPlugin",
+      "path": "dist/plugins/index.js",
+      "import": "{ createExecutionPathsPlugin }",
+      "limit": "300 B"
     },
     {
-      "name": "core/createAutosavePlugin",
-      "path": "dist/plugins/autosave/index.js",
-      "import": "{ createAutosavePlugin }",
-      "limit": "3.5 kB"
+      "name": "core/createAnalyticsPlugin",
+      "path": "dist/plugins/index.js",
+      "import": "{ createAnalyticsPlugin }",
+      "limit": "500 B"
     },
     {
-      "name": "core/createDiagnosticsPlugin",
-      "path": "dist/plugins/diagnostics/index.js",
-      "import": "{ createDiagnosticsPlugin }",
-      "limit": "2.6 kB"
+      "name": "core/analyzeStructure",
+      "path": "dist/index.js",
+      "import": "{ analyzeStructure }",
+      "limit": "1.5 kB"
     },
     {
-      "name": "core/createExecutionPathsPlugin",
-      "path": "dist/plugins/execution-paths/index.js",
-      "import": "{ createExecutionPathsPlugin }",
-      "limit": "2 kB"
+      "name": "core/createPersistencePlugin",
+      "path": "dist/plugins/index.js",
+      "import": "{ createPersistencePlugin }",
+      "limit": "1.15 kB"
     },
     {
       "name": "core/createReplayPlugin",
-      "path": "dist/plugins/replay/index.js",
+      "path": "dist/plugins/index.js",
       "import": "{ createReplayPlugin }",
-      "limit": "2 kB"
+      "limit": "850 B"
     }
   ],
-  "devDependencies": {
-    "@arethetypeswrong/cli": "^0.18.5",
-    "publint": "^0.3.18"
-  },
   "scripts": {
-    "build": "pnpm run clean && node --import tsx ./scripts/build.ts && tsc -p tsconfig.build.json && node --import tsx ../../scripts/copy-types.ts dist",
-    "clean": "node --import tsx ../../scripts/clean-paths.ts dist tsconfig.build.tsbuildinfo",
-    "coverage": "pnpm --workspace-root vitest run --coverage --coverage.include=packages/core/src/** --coverage.reporter=text-summary",
+    "build": "pnpm run clean && node --import tsx ./scripts/build.ts && tsc -p tsconfig.build.json && node --import tsx ../common/tooling/copy-types.ts dist",
+    "clean": "node --import tsx ../common/tooling/clean-paths.ts dist tsconfig.build.tsbuildinfo",
+    "coverage": "JOURNEY_COVERAGE_INCLUDE=packages/core/src/** JOURNEY_COVERAGE_DIR=coverage/core pnpm --workspace-root vitest run packages/core/src --coverage --coverage.reporter=text-summary",
+    "test": "pnpm --workspace-root vitest run packages/core/src --coverage.enabled=false",
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "check:exports": "publint --strict",
-    "attw": "attw --pack .",
+    "attw": "attw --pack . --profile node16",
     "size": "size-limit"
   }
 }

package/dist/journey-builder/index.d.cts

@@ -1,5 +0,0 @@
-import type { JourneyJsonObject } from "../types";
-import type { JourneyBuilder } from "./types";
-export type { JourneyBuilder, JourneyBuilderCustomEventKey, JourneyBuilderDefinition, JourneyBuilderDefinitionMetadata, JourneyBuilderGuard, JourneyBuilderLifecycle, JourneyBuilderOnEntry, JourneyBuilderTerminalCandidate, JourneyBuilderTerminalEntry, JourneyBuilderUpdateContext, JourneyStepBuilder, JourneyToBuilder } from "./types";
-/** Creates a typed builder for authoring journey definitions with `createStep`, `to`, and `build` helpers. */
-export declare function createJourneyBuilder<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>>(): JourneyBuilder<TContext, TStepId, TEventMap, TStepMeta, THandlers>;

package/dist/journey-builder/index.d.ts

@@ -1,5 +0,0 @@
-import type { JourneyJsonObject } from "../types";
-import type { JourneyBuilder } from "./types";
-export type { JourneyBuilder, JourneyBuilderCustomEventKey, JourneyBuilderDefinition, JourneyBuilderDefinitionMetadata, JourneyBuilderGuard, JourneyBuilderLifecycle, JourneyBuilderOnEntry, JourneyBuilderTerminalCandidate, JourneyBuilderTerminalEntry, JourneyBuilderUpdateContext, JourneyStepBuilder, JourneyToBuilder } from "./types";
-/** Creates a typed builder for authoring journey definitions with `createStep`, `to`, and `build` helpers. */
-export declare function createJourneyBuilder<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>>(): JourneyBuilder<TContext, TStepId, TEventMap, TStepMeta, THandlers>;

package/dist/journey-builder/types.d.cts

@@ -1,126 +0,0 @@
-import type { JourneyDefaultEventType, JourneyDefinition, JourneyFullEventType, JourneyJsonObject } from "../types";
-import type { JourneyStepLifecycleCallback, JourneyTransitionArgsForEvent, JourneyTransitionUpdateContextArgsForEvent } from "../types";
-export type JourneyBuilderStepEventKey<TEventMap extends Record<string, unknown>> = Exclude<JourneyFullEventType<TEventMap>, "completeJourney" | "terminateJourney">;
-export type JourneyBuilderTerminalEventKey<TEventMap extends Record<string, unknown>> = Extract<JourneyFullEventType<TEventMap>, "completeJourney" | "terminateJourney">;
-export type JourneyBuilderCustomEventKey<TEventMap extends Record<string, unknown>> = Exclude<keyof TEventMap & string, JourneyDefaultEventType>;
-export type JourneyBuilderGuard<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>> = (args: JourneyTransitionArgsForEvent<TContext, TStepId, TEventMap, THandlers, TEventType>) => boolean | Promise<boolean>;
-export type JourneyBuilderUpdateContext<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>> = (args: JourneyTransitionUpdateContextArgsForEvent<TContext, TStepId, TEventMap, TEventType>) => TContext;
-export type JourneyBuilderLifecycle<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>> = JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
-export type JourneyBuilderCandidate<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>> = {
-    readonly _to: TStepId;
-    readonly _when: JourneyBuilderGuard<TContext, TStepId, TEventMap, THandlers, TEventType> | undefined;
-    readonly _updateContext: JourneyBuilderUpdateContext<TContext, TStepId, TEventMap, TEventType> | undefined;
-    readonly _onEnter: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers> | undefined;
-    readonly _onLeave: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers> | undefined;
-    readonly _label: string | undefined;
-    readonly _timeoutMs: number | undefined;
-};
-export type JourneyToBuilderUsage = {
-    readonly when: boolean;
-    readonly updateContext: boolean;
-    readonly onEnter: boolean;
-    readonly onLeave: boolean;
-    readonly label: boolean;
-    readonly timeoutMs: boolean;
-};
-export type JourneyToBuilderUnused = {
-    readonly when: false;
-    readonly updateContext: false;
-    readonly onEnter: false;
-    readonly onLeave: false;
-    readonly label: false;
-    readonly timeoutMs: false;
-};
-type JourneyDuplicateModifierCall<TName extends string> = (...args: [
-    `Duplicate transition modifier ${TName}() is invalid. If several are present, the last one wins at runtime.`
-]) => never;
-export type JourneyToBuilder<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>, TUsed extends JourneyToBuilderUsage = JourneyToBuilderUnused> = {
-    readonly _candidate: JourneyBuilderCandidate<TContext, TStepId, TEventMap, THandlers, TEventType>;
-    when: TUsed["when"] extends true ? JourneyDuplicateModifierCall<"when"> : (guard: JourneyBuilderGuard<TContext, TStepId, TEventMap, THandlers, TEventType>) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "when"> & {
-        readonly when: true;
-    }>;
-    updateContext: TUsed["updateContext"] extends true ? JourneyDuplicateModifierCall<"updateContext"> : (fn: JourneyBuilderUpdateContext<TContext, TStepId, TEventMap, TEventType>) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "updateContext"> & {
-        readonly updateContext: true;
-    }>;
-    onEnter: TUsed["onEnter"] extends true ? JourneyDuplicateModifierCall<"onEnter"> : (fn: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "onEnter"> & {
-        readonly onEnter: true;
-    }>;
-    onLeave: TUsed["onLeave"] extends true ? JourneyDuplicateModifierCall<"onLeave"> : (fn: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "onLeave"> & {
-        readonly onLeave: true;
-    }>;
-    label: TUsed["label"] extends true ? JourneyDuplicateModifierCall<"label"> : (label: string) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "label"> & {
-        readonly label: true;
-    }>;
-    timeoutMs: TUsed["timeoutMs"] extends true ? JourneyDuplicateModifierCall<"timeoutMs"> : (ms: number) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "timeoutMs"> & {
-        readonly timeoutMs: true;
-    }>;
-};
-type JourneyBuiltTransitionCandidate<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>> = {
-    readonly _candidate: JourneyBuilderCandidate<TContext, TStepId, TEventMap, THandlers, TEventType>;
-};
-export type JourneyBuilderOnEntry<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyBuilderStepEventKey<TEventMap>> = readonly JourneyBuiltTransitionCandidate<TContext, TStepId, TEventMap, THandlers>[] | ((helpers: {
-    to: (stepId: TStepId) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType>;
-}) => readonly JourneyBuiltTransitionCandidate<TContext, TStepId, TEventMap, THandlers, TEventType>[]);
-export type JourneyBuilderTerminalCandidate<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyBuilderTerminalEventKey<TEventMap>> = {
-    when?: JourneyBuilderGuard<TContext, TStepId, TEventMap, THandlers, TEventType>;
-    updateContext?: JourneyBuilderUpdateContext<TContext, TStepId, TEventMap, TEventType>;
-    onEnter?: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>;
-    onLeave?: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>;
-    label?: string;
-    timeoutMs?: number;
-};
-export type JourneyBuilderTerminalEntry<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyBuilderTerminalEventKey<TEventMap>> = true | readonly [] | readonly JourneyBuilderTerminalCandidate<TContext, TStepId, TEventMap, THandlers, TEventType>[];
-type JourneyBuilderEventEntry<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap>> = TEventType extends JourneyBuilderTerminalEventKey<TEventMap> ? JourneyBuilderTerminalEntry<TContext, TStepId, TEventMap, THandlers, TEventType> : JourneyBuilderOnEntry<TContext, TStepId, TEventMap, THandlers, Extract<TEventType, JourneyBuilderStepEventKey<TEventMap>>>;
-type JourneyStepBuilderOnConfig<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>> = Partial<{
-    [TEventType in JourneyFullEventType<TEventMap>]: JourneyBuilderEventEntry<TContext, TStepId, TEventMap, THandlers, TEventType>;
-}>;
-type JourneyStepBuilderHandledCustomEventKey<TEventMap extends Record<string, unknown>, TOn> = Extract<keyof NonNullable<TOn>, JourneyBuilderCustomEventKey<TEventMap>>;
-type JourneyStepBuilderConfig<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>, TOn extends JourneyStepBuilderOnConfig<TContext, TStepId, TEventMap, THandlers> | undefined = JourneyStepBuilderOnConfig<TContext, TStepId, TEventMap, THandlers> | undefined> = {
-    meta?: TStepMeta;
-    onEnter?: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
-    onLeave?: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
-    on?: TOn;
-};
-export type JourneyStepBuilder<TContext extends JourneyJsonObject, TStepId extends string, TStepKey extends TStepId, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>, THandledCustomEventType extends JourneyBuilderCustomEventKey<TEventMap> = never> = {
-    readonly id: TStepKey;
-    readonly _meta: TStepMeta | undefined;
-    readonly _onEnter: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers> | undefined;
-    readonly _onLeave: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers> | undefined;
-    readonly _on: Record<string, JourneyBuilderEventEntry<TContext, TStepId, TEventMap, THandlers, JourneyFullEventType<TEventMap>>> | undefined;
-    readonly _handledCustomEventType?: THandledCustomEventType;
-};
-type JourneyStepBuilderHandledCustomEventMap<TStepId extends string, TEventMap extends Record<string, unknown>, TSteps extends readonly {
-    readonly id: TStepId;
-    readonly _handledCustomEventType?: JourneyBuilderCustomEventKey<TEventMap>;
-}[]> = {
-    [TCurrentStepId in TStepId]: Extract<Extract<TSteps[number], {
-        readonly id: TCurrentStepId;
-    }> extends {
-        readonly _handledCustomEventType?: infer THandledCustomEventType;
-    } ? THandledCustomEventType : never, JourneyBuilderCustomEventKey<TEventMap>>;
-};
-type JourneyBuilderGlobalHandledCustomEventKey<TEventMap extends Record<string, unknown>, TGlobal> = Extract<keyof NonNullable<TGlobal>, JourneyBuilderCustomEventKey<TEventMap>>;
-declare const journeyBuilderDefinitionBrand: unique symbol;
-export type JourneyBuilderDefinitionMetadata<TStepId extends string, TEventMap extends Record<string, unknown>, TStepHandledCustomEventMap extends Record<TStepId, JourneyBuilderCustomEventKey<TEventMap>> = Record<TStepId, never>, TGlobalHandledCustomEventType extends JourneyBuilderCustomEventKey<TEventMap> = never> = {
-    readonly [journeyBuilderDefinitionBrand]?: {
-        readonly stepHandledCustomEvents: TStepHandledCustomEventMap;
-        readonly globalHandledCustomEvents: TGlobalHandledCustomEventType;
-    };
-};
-export type JourneyBuilderDefinition<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>, TStepHandledCustomEventMap extends Record<TStepId, JourneyBuilderCustomEventKey<TEventMap>> = Record<TStepId, never>, TGlobalHandledCustomEventType extends JourneyBuilderCustomEventKey<TEventMap> = never> = JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers> & JourneyBuilderDefinitionMetadata<TStepId, TEventMap, TStepHandledCustomEventMap, TGlobalHandledCustomEventType>;
-type JourneyBuilderGlobalConfig<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>> = Partial<{
-    [TEventType in JourneyFullEventType<TEventMap>]: TEventType extends JourneyBuilderTerminalEventKey<TEventMap> ? JourneyBuilderTerminalEntry<TContext, TStepId, TEventMap, THandlers, TEventType> : readonly JourneyBuiltTransitionCandidate<TContext, TStepId, TEventMap, THandlers>[];
-}>;
-type JourneyBuilderBuildInput<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>, TSteps extends readonly JourneyStepBuilder<TContext, TStepId, TStepId, TEventMap, TStepMeta, THandlers, JourneyBuilderCustomEventKey<TEventMap>>[], TGlobal extends JourneyBuilderGlobalConfig<TContext, TStepId, TEventMap, THandlers> | undefined = JourneyBuilderGlobalConfig<TContext, TStepId, TEventMap, THandlers> | undefined> = {
-    initial: TStepId;
-    context: TContext;
-    handlers?: THandlers;
-    steps: TSteps;
-    global?: TGlobal;
-};
-export type JourneyBuilder<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>> = {
-    createStep: <TStepKey extends TStepId, TOn extends JourneyStepBuilderOnConfig<TContext, TStepId, TEventMap, THandlers> | undefined = JourneyStepBuilderOnConfig<TContext, TStepId, TEventMap, THandlers> | undefined>(id: TStepKey, config?: JourneyStepBuilderConfig<TContext, TStepId, TEventMap, TStepMeta, THandlers, TOn>) => JourneyStepBuilder<TContext, TStepId, TStepKey, TEventMap, TStepMeta, THandlers, JourneyStepBuilderHandledCustomEventKey<TEventMap, TOn>>;
-    to: (stepId: TStepId) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers>;
-    build: <TSteps extends readonly JourneyStepBuilder<TContext, TStepId, TStepId, TEventMap, TStepMeta, THandlers, JourneyBuilderCustomEventKey<TEventMap>>[], TGlobal extends JourneyBuilderGlobalConfig<TContext, TStepId, TEventMap, THandlers> | undefined = JourneyBuilderGlobalConfig<TContext, TStepId, TEventMap, THandlers> | undefined>(input: JourneyBuilderBuildInput<TContext, TStepId, TEventMap, TStepMeta, THandlers, TSteps, TGlobal>) => JourneyBuilderDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers, JourneyStepBuilderHandledCustomEventMap<TStepId, TEventMap, TSteps>, JourneyBuilderGlobalHandledCustomEventKey<TEventMap, TGlobal>>;
-};
-export type { JourneyStepBuilderConfig as _JourneyStepBuilderConfig, JourneyBuilderBuildInput as _JourneyBuilderBuildInput, JourneyBuilderEventEntry as _JourneyBuilderEventEntry };

package/dist/journey-builder/types.d.ts

@@ -1,126 +0,0 @@
-import type { JourneyDefaultEventType, JourneyDefinition, JourneyFullEventType, JourneyJsonObject } from "../types";
-import type { JourneyStepLifecycleCallback, JourneyTransitionArgsForEvent, JourneyTransitionUpdateContextArgsForEvent } from "../types";
-export type JourneyBuilderStepEventKey<TEventMap extends Record<string, unknown>> = Exclude<JourneyFullEventType<TEventMap>, "completeJourney" | "terminateJourney">;
-export type JourneyBuilderTerminalEventKey<TEventMap extends Record<string, unknown>> = Extract<JourneyFullEventType<TEventMap>, "completeJourney" | "terminateJourney">;
-export type JourneyBuilderCustomEventKey<TEventMap extends Record<string, unknown>> = Exclude<keyof TEventMap & string, JourneyDefaultEventType>;
-export type JourneyBuilderGuard<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>> = (args: JourneyTransitionArgsForEvent<TContext, TStepId, TEventMap, THandlers, TEventType>) => boolean | Promise<boolean>;
-export type JourneyBuilderUpdateContext<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>> = (args: JourneyTransitionUpdateContextArgsForEvent<TContext, TStepId, TEventMap, TEventType>) => TContext;
-export type JourneyBuilderLifecycle<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>> = JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
-export type JourneyBuilderCandidate<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>> = {
-    readonly _to: TStepId;
-    readonly _when: JourneyBuilderGuard<TContext, TStepId, TEventMap, THandlers, TEventType> | undefined;
-    readonly _updateContext: JourneyBuilderUpdateContext<TContext, TStepId, TEventMap, TEventType> | undefined;
-    readonly _onEnter: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers> | undefined;
-    readonly _onLeave: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers> | undefined;
-    readonly _label: string | undefined;
-    readonly _timeoutMs: number | undefined;
-};
-export type JourneyToBuilderUsage = {
-    readonly when: boolean;
-    readonly updateContext: boolean;
-    readonly onEnter: boolean;
-    readonly onLeave: boolean;
-    readonly label: boolean;
-    readonly timeoutMs: boolean;
-};
-export type JourneyToBuilderUnused = {
-    readonly when: false;
-    readonly updateContext: false;
-    readonly onEnter: false;
-    readonly onLeave: false;
-    readonly label: false;
-    readonly timeoutMs: false;
-};
-type JourneyDuplicateModifierCall<TName extends string> = (...args: [
-    `Duplicate transition modifier ${TName}() is invalid. If several are present, the last one wins at runtime.`
-]) => never;
-export type JourneyToBuilder<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>, TUsed extends JourneyToBuilderUsage = JourneyToBuilderUnused> = {
-    readonly _candidate: JourneyBuilderCandidate<TContext, TStepId, TEventMap, THandlers, TEventType>;
-    when: TUsed["when"] extends true ? JourneyDuplicateModifierCall<"when"> : (guard: JourneyBuilderGuard<TContext, TStepId, TEventMap, THandlers, TEventType>) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "when"> & {
-        readonly when: true;
-    }>;
-    updateContext: TUsed["updateContext"] extends true ? JourneyDuplicateModifierCall<"updateContext"> : (fn: JourneyBuilderUpdateContext<TContext, TStepId, TEventMap, TEventType>) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "updateContext"> & {
-        readonly updateContext: true;
-    }>;
-    onEnter: TUsed["onEnter"] extends true ? JourneyDuplicateModifierCall<"onEnter"> : (fn: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "onEnter"> & {
-        readonly onEnter: true;
-    }>;
-    onLeave: TUsed["onLeave"] extends true ? JourneyDuplicateModifierCall<"onLeave"> : (fn: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "onLeave"> & {
-        readonly onLeave: true;
-    }>;
-    label: TUsed["label"] extends true ? JourneyDuplicateModifierCall<"label"> : (label: string) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "label"> & {
-        readonly label: true;
-    }>;
-    timeoutMs: TUsed["timeoutMs"] extends true ? JourneyDuplicateModifierCall<"timeoutMs"> : (ms: number) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "timeoutMs"> & {
-        readonly timeoutMs: true;
-    }>;
-};
-type JourneyBuiltTransitionCandidate<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>> = {
-    readonly _candidate: JourneyBuilderCandidate<TContext, TStepId, TEventMap, THandlers, TEventType>;
-};
-export type JourneyBuilderOnEntry<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyBuilderStepEventKey<TEventMap>> = readonly JourneyBuiltTransitionCandidate<TContext, TStepId, TEventMap, THandlers>[] | ((helpers: {
-    to: (stepId: TStepId) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType>;
-}) => readonly JourneyBuiltTransitionCandidate<TContext, TStepId, TEventMap, THandlers, TEventType>[]);
-export type JourneyBuilderTerminalCandidate<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyBuilderTerminalEventKey<TEventMap>> = {
-    when?: JourneyBuilderGuard<TContext, TStepId, TEventMap, THandlers, TEventType>;
-    updateContext?: JourneyBuilderUpdateContext<TContext, TStepId, TEventMap, TEventType>;
-    onEnter?: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>;
-    onLeave?: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>;
-    label?: string;
-    timeoutMs?: number;
-};
-export type JourneyBuilderTerminalEntry<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyBuilderTerminalEventKey<TEventMap>> = true | readonly [] | readonly JourneyBuilderTerminalCandidate<TContext, TStepId, TEventMap, THandlers, TEventType>[];
-type JourneyBuilderEventEntry<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap>> = TEventType extends JourneyBuilderTerminalEventKey<TEventMap> ? JourneyBuilderTerminalEntry<TContext, TStepId, TEventMap, THandlers, TEventType> : JourneyBuilderOnEntry<TContext, TStepId, TEventMap, THandlers, Extract<TEventType, JourneyBuilderStepEventKey<TEventMap>>>;
-type JourneyStepBuilderOnConfig<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>> = Partial<{
-    [TEventType in JourneyFullEventType<TEventMap>]: JourneyBuilderEventEntry<TContext, TStepId, TEventMap, THandlers, TEventType>;
-}>;
-type JourneyStepBuilderHandledCustomEventKey<TEventMap extends Record<string, unknown>, TOn> = Extract<keyof NonNullable<TOn>, JourneyBuilderCustomEventKey<TEventMap>>;
-type JourneyStepBuilderConfig<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>, TOn extends JourneyStepBuilderOnConfig<TContext, TStepId, TEventMap, THandlers> | undefined = JourneyStepBuilderOnConfig<TContext, TStepId, TEventMap, THandlers> | undefined> = {
-    meta?: TStepMeta;
-    onEnter?: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
-    onLeave?: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
-    on?: TOn;
-};
-export type JourneyStepBuilder<TContext extends JourneyJsonObject, TStepId extends string, TStepKey extends TStepId, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>, THandledCustomEventType extends JourneyBuilderCustomEventKey<TEventMap> = never> = {
-    readonly id: TStepKey;
-    readonly _meta: TStepMeta | undefined;
-    readonly _onEnter: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers> | undefined;
-    readonly _onLeave: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers> | undefined;
-    readonly _on: Record<string, JourneyBuilderEventEntry<TContext, TStepId, TEventMap, THandlers, JourneyFullEventType<TEventMap>>> | undefined;
-    readonly _handledCustomEventType?: THandledCustomEventType;
-};
-type JourneyStepBuilderHandledCustomEventMap<TStepId extends string, TEventMap extends Record<string, unknown>, TSteps extends readonly {
-    readonly id: TStepId;
-    readonly _handledCustomEventType?: JourneyBuilderCustomEventKey<TEventMap>;
-}[]> = {
-    [TCurrentStepId in TStepId]: Extract<Extract<TSteps[number], {
-        readonly id: TCurrentStepId;
-    }> extends {
-        readonly _handledCustomEventType?: infer THandledCustomEventType;
-    } ? THandledCustomEventType : never, JourneyBuilderCustomEventKey<TEventMap>>;
-};
-type JourneyBuilderGlobalHandledCustomEventKey<TEventMap extends Record<string, unknown>, TGlobal> = Extract<keyof NonNullable<TGlobal>, JourneyBuilderCustomEventKey<TEventMap>>;
-declare const journeyBuilderDefinitionBrand: unique symbol;
-export type JourneyBuilderDefinitionMetadata<TStepId extends string, TEventMap extends Record<string, unknown>, TStepHandledCustomEventMap extends Record<TStepId, JourneyBuilderCustomEventKey<TEventMap>> = Record<TStepId, never>, TGlobalHandledCustomEventType extends JourneyBuilderCustomEventKey<TEventMap> = never> = {
-    readonly [journeyBuilderDefinitionBrand]?: {
-        readonly stepHandledCustomEvents: TStepHandledCustomEventMap;
-        readonly globalHandledCustomEvents: TGlobalHandledCustomEventType;
-    };
-};
-export type JourneyBuilderDefinition<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>, TStepHandledCustomEventMap extends Record<TStepId, JourneyBuilderCustomEventKey<TEventMap>> = Record<TStepId, never>, TGlobalHandledCustomEventType extends JourneyBuilderCustomEventKey<TEventMap> = never> = JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers> & JourneyBuilderDefinitionMetadata<TStepId, TEventMap, TStepHandledCustomEventMap, TGlobalHandledCustomEventType>;
-type JourneyBuilderGlobalConfig<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>> = Partial<{
-    [TEventType in JourneyFullEventType<TEventMap>]: TEventType extends JourneyBuilderTerminalEventKey<TEventMap> ? JourneyBuilderTerminalEntry<TContext, TStepId, TEventMap, THandlers, TEventType> : readonly JourneyBuiltTransitionCandidate<TContext, TStepId, TEventMap, THandlers>[];
-}>;
-type JourneyBuilderBuildInput<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>, TSteps extends readonly JourneyStepBuilder<TContext, TStepId, TStepId, TEventMap, TStepMeta, THandlers, JourneyBuilderCustomEventKey<TEventMap>>[], TGlobal extends JourneyBuilderGlobalConfig<TContext, TStepId, TEventMap, THandlers> | undefined = JourneyBuilderGlobalConfig<TContext, TStepId, TEventMap, THandlers> | undefined> = {
-    initial: TStepId;
-    context: TContext;
-    handlers?: THandlers;
-    steps: TSteps;
-    global?: TGlobal;
-};
-export type JourneyBuilder<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>> = {
-    createStep: <TStepKey extends TStepId, TOn extends JourneyStepBuilderOnConfig<TContext, TStepId, TEventMap, THandlers> | undefined = JourneyStepBuilderOnConfig<TContext, TStepId, TEventMap, THandlers> | undefined>(id: TStepKey, config?: JourneyStepBuilderConfig<TContext, TStepId, TEventMap, TStepMeta, THandlers, TOn>) => JourneyStepBuilder<TContext, TStepId, TStepKey, TEventMap, TStepMeta, THandlers, JourneyStepBuilderHandledCustomEventKey<TEventMap, TOn>>;
-    to: (stepId: TStepId) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers>;
-    build: <TSteps extends readonly JourneyStepBuilder<TContext, TStepId, TStepId, TEventMap, TStepMeta, THandlers, JourneyBuilderCustomEventKey<TEventMap>>[], TGlobal extends JourneyBuilderGlobalConfig<TContext, TStepId, TEventMap, THandlers> | undefined = JourneyBuilderGlobalConfig<TContext, TStepId, TEventMap, THandlers> | undefined>(input: JourneyBuilderBuildInput<TContext, TStepId, TEventMap, TStepMeta, THandlers, TSteps, TGlobal>) => JourneyBuilderDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers, JourneyStepBuilderHandledCustomEventMap<TStepId, TEventMap, TSteps>, JourneyBuilderGlobalHandledCustomEventKey<TEventMap, TGlobal>>;
-};
-export type { JourneyStepBuilderConfig as _JourneyStepBuilderConfig, JourneyBuilderBuildInput as _JourneyBuilderBuildInput, JourneyBuilderEventEntry as _JourneyBuilderEventEntry };

package/dist/journey-machine/async-state.d.cts

@@ -1,12 +0,0 @@
-import type { JourneyAsyncPhase, JourneyAsyncState, JourneyJsonObject } from "../types";
-import type { JourneyMachineRuntime } from "./runtime";
-export type JourneyMachineAsyncStateController<TStepId extends string> = {
-    syncState: (asyncState: JourneyAsyncState<TStepId>) => void;
-    updateStepAsync: (stepId: TStepId, updater: (current: JourneyAsyncState<TStepId>["byStep"][TStepId]) => JourneyAsyncState<TStepId>["byStep"][TStepId], runVersion?: number) => void;
-    setStepLoading: (stepId: TStepId, phase: JourneyAsyncPhase, eventType: string, transitionId?: string, runVersion?: number) => void;
-    setStepIdle: (stepId: TStepId, runVersion?: number) => void;
-    setStepError: (stepId: TStepId, eventType: string, error: unknown, transitionId?: string, runVersion?: number) => void;
-};
-export declare const createJourneyMachineAsyncStateController: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>>({ runtime }: {
-    runtime: JourneyMachineRuntime<TContext, TStepId, TEventMap>;
-}) => JourneyMachineAsyncStateController<TStepId>;

package/dist/journey-machine/async-state.d.ts

@@ -1,12 +0,0 @@
-import type { JourneyAsyncPhase, JourneyAsyncState, JourneyJsonObject } from "../types";
-import type { JourneyMachineRuntime } from "./runtime";
-export type JourneyMachineAsyncStateController<TStepId extends string> = {
-    syncState: (asyncState: JourneyAsyncState<TStepId>) => void;
-    updateStepAsync: (stepId: TStepId, updater: (current: JourneyAsyncState<TStepId>["byStep"][TStepId]) => JourneyAsyncState<TStepId>["byStep"][TStepId], runVersion?: number) => void;
-    setStepLoading: (stepId: TStepId, phase: JourneyAsyncPhase, eventType: string, transitionId?: string, runVersion?: number) => void;
-    setStepIdle: (stepId: TStepId, runVersion?: number) => void;
-    setStepError: (stepId: TStepId, eventType: string, error: unknown, transitionId?: string, runVersion?: number) => void;
-};
-export declare const createJourneyMachineAsyncStateController: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>>({ runtime }: {
-    runtime: JourneyMachineRuntime<TContext, TStepId, TEventMap>;
-}) => JourneyMachineAsyncStateController<TStepId>;

package/dist/journey-machine/computed.d.cts

@@ -1,2 +0,0 @@
-import type { JourneyComputed, JourneyDefinition, JourneyJsonObject, JourneyResolvedDefinition, JourneySnapshot } from "../types";
-export declare const createJourneyMachineComputedGetter: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>>(journey: JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>, resolvedJourney: JourneyResolvedDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>, getSnapshot: () => JourneySnapshot<TContext, TStepId>) => (() => JourneyComputed<TStepId>);

package/dist/journey-machine/computed.d.ts

@@ -1,2 +0,0 @@
-import type { JourneyComputed, JourneyDefinition, JourneyJsonObject, JourneyResolvedDefinition, JourneySnapshot } from "../types";
-export declare const createJourneyMachineComputedGetter: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>>(journey: JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>, resolvedJourney: JourneyResolvedDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>, getSnapshot: () => JourneySnapshot<TContext, TStepId>) => (() => JourneyComputed<TStepId>);

package/dist/journey-machine/controls.d.cts

@@ -1,17 +0,0 @@
-import type { JourneyJsonObject, JourneySnapshot } from "../types";
-import type { JourneyMachineAsyncStateController } from "./async-state";
-import type { JourneyMachineRuntime } from "./runtime";
-export type JourneyMachineControls<TContext extends JourneyJsonObject, TStepId extends string> = {
-    startJourney: () => Promise<JourneySnapshot<TContext, TStepId>>;
-    resetJourney: () => Promise<JourneySnapshot<TContext, TStepId>>;
-    updateContext: (updater: (context: TContext) => TContext) => Promise<JourneySnapshot<TContext, TStepId>>;
-    clearStepError: (stepId?: TStepId) => Promise<JourneySnapshot<TContext, TStepId>>;
-    dispose: () => void;
-};
-export declare const createJourneyMachineControls: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>>({ runtime, asyncState, initial, initialContext, steps }: {
-    runtime: JourneyMachineRuntime<TContext, TStepId, TEventMap>;
-    asyncState: JourneyMachineAsyncStateController<TStepId>;
-    initial: TStepId;
-    initialContext: TContext;
-    steps: Record<TStepId, unknown>;
-}) => JourneyMachineControls<TContext, TStepId>;

package/dist/journey-machine/controls.d.ts

@@ -1,17 +0,0 @@
-import type { JourneyJsonObject, JourneySnapshot } from "../types";
-import type { JourneyMachineAsyncStateController } from "./async-state";
-import type { JourneyMachineRuntime } from "./runtime";
-export type JourneyMachineControls<TContext extends JourneyJsonObject, TStepId extends string> = {
-    startJourney: () => Promise<JourneySnapshot<TContext, TStepId>>;
-    resetJourney: () => Promise<JourneySnapshot<TContext, TStepId>>;
-    updateContext: (updater: (context: TContext) => TContext) => Promise<JourneySnapshot<TContext, TStepId>>;
-    clearStepError: (stepId?: TStepId) => Promise<JourneySnapshot<TContext, TStepId>>;
-    dispose: () => void;
-};
-export declare const createJourneyMachineControls: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>>({ runtime, asyncState, initial, initialContext, steps }: {
-    runtime: JourneyMachineRuntime<TContext, TStepId, TEventMap>;
-    asyncState: JourneyMachineAsyncStateController<TStepId>;
-    initial: TStepId;
-    initialContext: TContext;
-    steps: Record<TStepId, unknown>;
-}) => JourneyMachineControls<TContext, TStepId>;

package/dist/journey-machine/helpers.d.cts

@@ -1,52 +0,0 @@
-import type { JourneyAsyncState, JourneyEvent, JourneyGoToEvent, JourneyJsonObject, JourneyPayloadFor, JourneyResolvedTransition, JourneySendEvent, JourneySendResult, JourneySnapshot, JourneyStatus, JourneyStepAsyncState, JourneyTerminal, JourneyTransition, JourneyTransitionArgs } from "../types";
-export declare const assertStepExists: <TStepId extends string>(steps: Record<TStepId, unknown>, stepId: TStepId, message: string) => void;
-export declare const isPlainObject: (value: unknown) => value is Record<string, unknown>;
-export declare function assertSerializableContext<TContext extends JourneyJsonObject>(context: TContext, label?: string): TContext;
-export declare const cloneContext: <TContext extends JourneyJsonObject>(context: TContext) => TContext;
-export declare const cloneMetaValue: <T>(value: T) => T;
-export declare const normalizeStepCount: (steps?: number) => number;
-export declare const now: () => number;
-export declare const buildVisitedFromTimeline: <TStepId extends string>(timeline: readonly TStepId[], stepIds?: readonly TStepId[]) => Record<TStepId, boolean>;
-export declare const appendVisited: <TStepId extends string>(visited: Record<TStepId, boolean>, current: TStepId) => Record<TStepId, boolean>;
-export declare const isPromiseLike: <T>(value: T | PromiseLike<T>) => value is PromiseLike<T>;
-export declare const validateFiniteTimeout: (timeoutMs: unknown, label: string) => void;
-export declare class JourneyTimeoutError extends Error {
-    name: string;
-    constructor(message: string);
-}
-export declare class JourneyDisposedError extends Error {
-    name: string;
-    readonly operation: string;
-    constructor(operation: string);
-}
-export declare const isDevelopmentEnvironment: () => boolean;
-export declare const warnInDevelopment: (message: string, detail?: unknown) => void;
-export declare const errorInDevelopment: (message: string, detail?: unknown) => void;
-export declare const withTimeout: <T>(promise: PromiseLike<T>, timeoutMs: number | undefined, buildError: () => Error) => Promise<T>;
-export declare const withAbortSignal: <T>(promise: PromiseLike<T>, signal: AbortSignal) => Promise<T>;
-export declare const buildIdleStepAsyncState: () => JourneyStepAsyncState;
-export declare const buildInitialAsyncState: <TStepId extends string>(steps: Record<TStepId, unknown>) => JourneyAsyncState<TStepId>;
-export declare const isGoToStepByIdEvent: <TStepId extends string, TEventMap extends Record<string, unknown>>(event: JourneySendEvent<TStepId, TEventMap>) => event is JourneyGoToEvent<TStepId, JourneyPayloadFor<TEventMap, "goToStepById">>;
-export declare const isTerminalTarget: <TStepId extends string>(target: TStepId | JourneyTerminal) => target is JourneyTerminal;
-export declare const resolveTransitionTarget: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>>(transition: JourneyTransition<TContext, TStepId, TEventMap, THandlers>) => TStepId | JourneyTerminal;
-export declare const validateJourneyTransitions: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>>(transitions: readonly JourneyResolvedTransition<TContext, TStepId, TEventMap, THandlers>[], steps: Record<TStepId, unknown>) => void;
-export declare const buildSendResult: <TContext extends JourneyJsonObject, TStepId extends string>(snapshot: JourneySnapshot<TContext, TStepId>, transitioned: boolean, options?: {
-    transitionId?: string;
-    label?: string;
-    error?: unknown;
-}) => JourneySendResult<TContext, TStepId>;
-export declare const buildSnapshot: <TContext extends JourneyJsonObject, TStepId extends string>(timeline: readonly TStepId[], index: number, context: TContext, status: JourneyStatus, asyncState: JourneyAsyncState<TStepId>, visited?: Record<TStepId, boolean>) => JourneySnapshot<TContext, TStepId>;
-export declare const stabilizeSnapshot: <TContext extends JourneyJsonObject, TStepId extends string>(snapshot: JourneySnapshot<TContext, TStepId>) => JourneySnapshot<TContext, TStepId>;
-export declare const selectTransition: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TTransition extends {
-    from: TStepId | "*";
-    event: string;
-    when?: (args: JourneyTransitionArgs<TContext, TStepId, TEventMap, THandlers>) => boolean | Promise<boolean>;
-    timeoutMs?: number;
-    id?: string;
-    label?: string;
-}>(transitions: readonly TTransition[], snapshot: JourneySnapshot<TContext, TStepId>, event: JourneyEvent<TStepId, TEventMap>, signal: AbortSignal, handlers: THandlers, hooks?: {
-    onAsyncGuardStart?: (transition: TTransition) => void;
-    onAsyncGuardSuccess?: (transition: TTransition) => void;
-    onAsyncGuardError?: (transition: TTransition, error: unknown) => void;
-}, defaultTimeoutMs?: number) => Promise<TTransition | null>;
-export declare const transitionSnapshot: <TContext extends JourneyJsonObject, TStepId extends string>(snapshot: JourneySnapshot<TContext, TStepId>, nextCurrent: TStepId, nextContext: TContext) => JourneySnapshot<TContext, TStepId>;