@prb/effect-xstate 1.0.0-beta.0

package/README.md

@@ -0,0 +1,85 @@
+# @prb/xstate
+
+Effect-TS and xState v5 workflow utilities for React applications.
+
+## Overview
+
+This package provides reusable state machines and React hooks that combine Effect-TS's functional effect system with
+xState v5's state management capabilities.
+
+## Features
+
+- **Form Machine**: Generic form workflow with validation, processing, and error handling
+- **Facilitator Machine**: Check-then-create workflow for eligibility and resource creation
+- **React Hooks**: Type-safe hooks for managing machine state in React components
+- **Error Utilities**: Helpers for extracting and displaying structured error data
+
+## Installation
+
+```bash
+bun add @prb/xstate effect xstate @xstate/react
+```
+
+## Usage
+
+### Form Machine
+
+Create a form workflow that validates inputs before processing:
+
+```typescript
+import { createFormMachine } from "@prb/xstate";
+import { Effect } from "effect";
+
+const machine = createFormMachine({
+  id: "create-stream",
+  services: {
+    onCheck: (payload) => Effect.succeed(undefined),
+    onValidate: (payload) => Effect.succeed({ validated: true }),
+    onProcess: ({ payload, preprocess }) => Effect.succeed(undefined),
+  },
+});
+```
+
+### Facilitator Machine
+
+Create a check-then-create workflow:
+
+```typescript
+import { createFacilitatorMachine } from "@prb/xstate";
+import { Effect } from "effect";
+
+const machine = createFacilitatorMachine({
+  id: "claim-airdrop",
+  services: {
+    onCheck: (payload) => Effect.succeed({ status: "true", transitive: { proof: "0x..." } }),
+    onCreate: ({ create, transitive }) => Effect.succeed(undefined),
+  },
+});
+```
+
+### React Hook
+
+```typescript
+import { useFacilitatorWorkflow } from "@prb/xstate";
+
+function MyComponent() {
+  const workflow = useFacilitatorWorkflow(machine);
+
+  return (
+    <div>
+      <button onClick={() => workflow.check({ id: 123 })}>
+        Check Eligibility
+      </button>
+      {workflow.status.isEligible && (
+        <button onClick={() => workflow.create({ id: 123 })}>
+          Create Resource
+        </button>
+      )}
+    </div>
+  );
+}
+```
+
+## License
+
+MIT

package/dist/errors/extract.d.ts

@@ -0,0 +1,15 @@
+import type { TransactionError } from "./types.js";
+type TaggedErrorShape = {
+    _tag: string;
+    message: string;
+    address?: string;
+    calldata?: string;
+    functionName?: string;
+    sender?: string;
+    cause?: unknown;
+};
+declare function hasTaggedErrorShape(error: unknown): error is TaggedErrorShape;
+export declare function extractErrorData(error: unknown, fallbackMessage?: string): TransactionError;
+export { hasTaggedErrorShape };
+export type { TaggedErrorShape };
+//# sourceMappingURL=extract.d.ts.map

package/dist/errors/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/errors/extract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAKnD,KAAK,gBAAgB,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAKF,iBAAS,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAStE;AAOD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,eAAe,SAAqB,GACnC,gBAAgB,CAoBlB;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAC/B,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/errors/extract.js

@@ -0,0 +1,29 @@
+function hasTaggedErrorShape(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "_tag" in error &&
+        typeof error._tag === "string" &&
+        "message" in error &&
+        typeof error.message === "string");
+}
+export function extractErrorData(error, fallbackMessage = "Operation failed") {
+    if (hasTaggedErrorShape(error)) {
+        return {
+            details: {
+                address: error.address,
+                calldata: error.calldata,
+                cause: error.cause,
+                functionName: error.functionName,
+                sender: error.sender,
+                tag: error._tag,
+            },
+            message: error.message,
+        };
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return fallbackMessage;
+}
+export { hasTaggedErrorShape };
+//# sourceMappingURL=extract.js.map

package/dist/errors/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../src/errors/extract.ts"],"names":[],"mappings":"AAkBA,SAAS,mBAAmB,CAAC,KAAc;IACzC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,OAAQ,KAA0B,CAAC,IAAI,KAAK,QAAQ;QACpD,SAAS,IAAI,KAAK;QAClB,OAAQ,KAA0B,CAAC,OAAO,KAAK,QAAQ,CACxD,CAAC;AACJ,CAAC;AAOD,MAAM,UAAU,gBAAgB,CAC9B,KAAc,EACd,eAAe,GAAG,kBAAkB;IAEpC,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO;YACL,OAAO,EAAE;gBACP,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,GAAG,EAAE,KAAK,CAAC,IAAI;aAChB;YACD,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/errors/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./extract.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,3 @@
+export * from "./extract.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/errors/types.d.ts

@@ -0,0 +1,13 @@
+export type ErrorDetails = {
+    address?: string;
+    calldata?: string;
+    cause?: unknown;
+    functionName?: string;
+    sender?: string;
+    tag?: string;
+};
+export type TransactionError = string | {
+    details?: ErrorDetails;
+    message: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/errors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/errors/types.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,YAAY,GAAG;IAEzB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAGF,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN;IACE,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/dist/errors/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/errors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/errors/types.ts"],"names":[],"mappings":""}

package/dist/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./useFacilitatorWorkflow.js";
+export * from "./useFormWorkflow.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,3 @@
+export * from "./useFacilitatorWorkflow.js";
+export * from "./useFormWorkflow.js";
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC"}

package/dist/hooks/useFacilitatorWorkflow.d.ts

@@ -0,0 +1,38 @@
+import type { AnyActorLogic, InspectionEvent, Observer } from "xstate";
+import type { EligibilityStatus, FacilitatorMachineContext } from "../machines/index.js";
+type FacilitatorMachineSnapshot<TTransitive> = {
+    value: string;
+    context: FacilitatorMachineContext<TTransitive>;
+};
+type UseFacilitatorWorkflowReturn<TCheck, TCreate, TTransitive> = {
+    state: string;
+    context: FacilitatorMachineContext<TTransitive>;
+    error: string | null;
+    eligibility: EligibilityStatus;
+    transitive: TTransitive | null;
+    status: {
+        isIdle: boolean;
+        isChecking: boolean;
+        isChecked: boolean;
+        isCreating: boolean;
+        isCreated: boolean;
+        isFailed: boolean;
+        isEligible: boolean;
+        isNotEligible: boolean;
+        isExpired: boolean;
+        isLoading: boolean;
+    };
+    check: (payload: TCheck & {
+        soft?: boolean;
+    }) => void;
+    create: (payload: TCreate) => void;
+    reset: () => void;
+    send: (event: unknown) => void;
+    snapshot: FacilitatorMachineSnapshot<TTransitive>;
+};
+type UseFacilitatorWorkflowOptions = {
+    inspect?: Observer<InspectionEvent> | ((event: InspectionEvent) => void);
+};
+export declare function useFacilitatorWorkflow<TCheck = unknown, TCreate = unknown, TTransitive = unknown>(machine: AnyActorLogic, options?: UseFacilitatorWorkflowOptions): UseFacilitatorWorkflowReturn<TCheck, TCreate, TTransitive>;
+export {};
+//# sourceMappingURL=useFacilitatorWorkflow.d.ts.map

package/dist/hooks/useFacilitatorWorkflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFacilitatorWorkflow.d.ts","sourceRoot":"","sources":["../../src/hooks/useFacilitatorWorkflow.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAM5F,KAAK,0BAA0B,CAAC,WAAW,IAAI;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,yBAAyB,CAAC,WAAW,CAAC,CAAC;CACjD,CAAC;AAEF,KAAK,4BAA4B,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,IAAI;IAEhE,KAAK,EAAE,MAAM,CAAC;IAGd,OAAO,EAAE,yBAAyB,CAAC,WAAW,CAAC,CAAC;IAGhD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAGrB,WAAW,EAAE,iBAAiB,CAAC;IAG/B,UAAU,EAAE,WAAW,GAAG,IAAI,CAAC;IAG/B,MAAM,EAAE;QACN,MAAM,EAAE,OAAO,CAAC;QAChB,UAAU,EAAE,OAAO,CAAC;QACpB,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,EAAE,OAAO,CAAC;QACpB,SAAS,EAAE,OAAO,CAAC;QACnB,QAAQ,EAAE,OAAO,CAAC;QAClB,UAAU,EAAE,OAAO,CAAC;QACpB,aAAa,EAAE,OAAO,CAAC;QACvB,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IAGF,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAGtD,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAGnC,KAAK,EAAE,MAAM,IAAI,CAAC;IAGlB,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAG/B,QAAQ,EAAE,0BAA0B,CAAC,WAAW,CAAC,CAAC;CACnD,CAAC;AAEF,KAAK,6BAA6B,GAAG;IAEnC,OAAO,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC,CAAC;CAC1E,CAAC;AASF,wBAAgB,sBAAsB,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,WAAW,GAAG,OAAO,EAC/F,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,6BAA6B,GACtC,4BAA4B,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAsC5D"}

package/dist/hooks/useFacilitatorWorkflow.js

@@ -0,0 +1,36 @@
+"use client";
+import { useActor } from "@xstate/react";
+export function useFacilitatorWorkflow(machine, options) {
+    const [snapshot, send] = useActor(machine, { inspect: options?.inspect });
+    const check = (payload) => send({ payload, type: "CHECK" });
+    const create = (payload) => send({ payload, type: "CREATE" });
+    const reset = () => send({ type: "RESET" });
+    const typedSnapshot = snapshot;
+    const eligibility = typedSnapshot.context.status;
+    const status = {
+        isChecked: typedSnapshot.value === "checked",
+        isChecking: typedSnapshot.value === "checking",
+        isCreated: typedSnapshot.value === "created",
+        isCreating: typedSnapshot.value === "creating",
+        isEligible: eligibility === "true",
+        isExpired: eligibility === "expired",
+        isFailed: typedSnapshot.value === "failed",
+        isIdle: typedSnapshot.value === "idle",
+        isLoading: ["checking", "creating"].includes(typedSnapshot.value),
+        isNotEligible: eligibility === "false",
+    };
+    return {
+        check,
+        context: typedSnapshot.context,
+        create,
+        eligibility,
+        error: typedSnapshot.context.error,
+        reset,
+        send,
+        snapshot: typedSnapshot,
+        state: typedSnapshot.value,
+        status,
+        transitive: typedSnapshot.context.transitive,
+    };
+}
+//# sourceMappingURL=useFacilitatorWorkflow.js.map

package/dist/hooks/useFacilitatorWorkflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFacilitatorWorkflow.js","sourceRoot":"","sources":["../../src/hooks/useFacilitatorWorkflow.ts"],"names":[],"mappings":"AAMA,YAAY,CAAC;AAEb,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAuEzC,MAAM,UAAU,sBAAsB,CACpC,OAAsB,EACtB,OAAuC;IAEvC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAE1E,MAAM,KAAK,GAAG,CAAC,OAAoC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAEzF,MAAM,MAAM,GAAG,CAAC,OAAgB,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEvE,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAE5C,MAAM,aAAa,GAAG,QAAmD,CAAC;IAC1E,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC;IAEjD,MAAM,MAAM,GAAG;QACb,SAAS,EAAE,aAAa,CAAC,KAAK,KAAK,SAAS;QAC5C,UAAU,EAAE,aAAa,CAAC,KAAK,KAAK,UAAU;QAC9C,SAAS,EAAE,aAAa,CAAC,KAAK,KAAK,SAAS;QAC5C,UAAU,EAAE,aAAa,CAAC,KAAK,KAAK,UAAU;QAC9C,UAAU,EAAE,WAAW,KAAK,MAAM;QAClC,SAAS,EAAE,WAAW,KAAK,SAAS;QACpC,QAAQ,EAAE,aAAa,CAAC,KAAK,KAAK,QAAQ;QAC1C,MAAM,EAAE,aAAa,CAAC,KAAK,KAAK,MAAM;QACtC,SAAS,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC;QACjE,aAAa,EAAE,WAAW,KAAK,OAAO;KACvC,CAAC;IAEF,OAAO;QACL,KAAK;QACL,OAAO,EAAE,aAAa,CAAC,OAAO;QAC9B,MAAM;QACN,WAAW;QACX,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK;QAClC,KAAK;QACL,IAAI;QACJ,QAAQ,EAAE,aAAa;QACvB,KAAK,EAAE,aAAa,CAAC,KAAK;QAC1B,MAAM;QACN,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,UAAU;KAC7C,CAAC;AACJ,CAAC"}

package/dist/hooks/useFormWorkflow.d.ts

@@ -0,0 +1,33 @@
+import type { AnyActorLogic, InspectionEvent, Observer } from "xstate";
+import type { FormMachineContext } from "../machines/index.js";
+type FormMachineSnapshot<TPayload, TResult, TPreprocess> = {
+    value: string;
+    context: FormMachineContext<TPayload, TResult, TPreprocess>;
+};
+type UseFormWorkflowReturn<TCheck, TPayload, TResult, TPreprocess> = {
+    state: string;
+    context: FormMachineContext<TPayload, TResult, TPreprocess>;
+    error: string | null;
+    preprocess: TPreprocess;
+    result: TResult | null;
+    status: {
+        isIdle: boolean;
+        isChecking: boolean;
+        isValidating: boolean;
+        isProcessing: boolean;
+        isSuccess: boolean;
+        isFailure: boolean;
+        isLoading: boolean;
+    };
+    check: (payload: TCheck) => void;
+    save: (payload: TPayload) => void;
+    reset: () => void;
+    send: (event: unknown) => void;
+    snapshot: FormMachineSnapshot<TPayload, TResult, TPreprocess>;
+};
+type UseFormWorkflowOptions = {
+    inspect?: Observer<InspectionEvent> | ((event: InspectionEvent) => void);
+};
+export declare function useFormWorkflow<TCheck = unknown, TPayload = unknown, TResult = unknown, TPreprocess = unknown>(machine: AnyActorLogic, options?: UseFormWorkflowOptions): UseFormWorkflowReturn<TCheck, TPayload, TResult, TPreprocess>;
+export {};
+//# sourceMappingURL=useFormWorkflow.d.ts.map

package/dist/hooks/useFormWorkflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormWorkflow.d.ts","sourceRoot":"","sources":["../../src/hooks/useFormWorkflow.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAMlE,KAAK,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,IAAI;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;CAC7D,CAAC;AAEF,KAAK,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,IAAI;IAEnE,KAAK,EAAE,MAAM,CAAC;IAGd,OAAO,EAAE,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAG5D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAGrB,UAAU,EAAE,WAAW,CAAC;IAGxB,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAGvB,MAAM,EAAE;QACN,MAAM,EAAE,OAAO,CAAC;QAChB,UAAU,EAAE,OAAO,CAAC;QACpB,YAAY,EAAE,OAAO,CAAC;QACtB,YAAY,EAAE,OAAO,CAAC;QACtB,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IAGF,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAGjC,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;IAGlC,KAAK,EAAE,MAAM,IAAI,CAAC;IAGlB,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAG/B,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;CAC/D,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAE5B,OAAO,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC,CAAC;CAC1E,CAAC;AAsBF,wBAAgB,eAAe,CAC7B,MAAM,GAAG,OAAO,EAChB,QAAQ,GAAG,OAAO,EAClB,OAAO,GAAG,OAAO,EACjB,WAAW,GAAG,OAAO,EAErB,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,CAkC/D"}

package/dist/hooks/useFormWorkflow.js

@@ -0,0 +1,32 @@
+"use client";
+import { useActor } from "@xstate/react";
+export function useFormWorkflow(machine, options) {
+    const [snapshot, send] = useActor(machine, { inspect: options?.inspect });
+    const check = (payload) => send({ payload, type: "CHECK" });
+    const save = (payload) => send({ payload, type: "SAVE" });
+    const reset = () => send({ type: "RESET" });
+    const typedSnapshot = snapshot;
+    const status = {
+        isChecking: typedSnapshot.value === "check",
+        isFailure: typedSnapshot.value === "failure",
+        isIdle: typedSnapshot.value === "initial",
+        isLoading: ["check", "validate", "process"].includes(typedSnapshot.value),
+        isProcessing: typedSnapshot.value === "process",
+        isSuccess: typedSnapshot.value === "success",
+        isValidating: typedSnapshot.value === "validate",
+    };
+    return {
+        check,
+        context: typedSnapshot.context,
+        error: typedSnapshot.context.error,
+        preprocess: typedSnapshot.context.preprocess,
+        reset,
+        result: typedSnapshot.context.result,
+        save,
+        send,
+        snapshot: typedSnapshot,
+        state: typedSnapshot.value,
+        status,
+    };
+}
+//# sourceMappingURL=useFormWorkflow.js.map

package/dist/hooks/useFormWorkflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormWorkflow.js","sourceRoot":"","sources":["../../src/hooks/useFormWorkflow.ts"],"names":[],"mappings":"AAmCA,YAAY,CAAC;AAEb,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAiFzC,MAAM,UAAU,eAAe,CAM7B,OAAsB,EACtB,OAAgC;IAEhC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAE1E,MAAM,KAAK,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAEpE,MAAM,IAAI,GAAG,CAAC,OAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAEpE,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAE5C,MAAM,aAAa,GAAG,QAA+D,CAAC;IAEtF,MAAM,MAAM,GAAG;QACb,UAAU,EAAE,aAAa,CAAC,KAAK,KAAK,OAAO;QAC3C,SAAS,EAAE,aAAa,CAAC,KAAK,KAAK,SAAS;QAC5C,MAAM,EAAE,aAAa,CAAC,KAAK,KAAK,SAAS;QACzC,SAAS,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC;QACzE,YAAY,EAAE,aAAa,CAAC,KAAK,KAAK,SAAS;QAC/C,SAAS,EAAE,aAAa,CAAC,KAAK,KAAK,SAAS;QAC5C,YAAY,EAAE,aAAa,CAAC,KAAK,KAAK,UAAU;KACjD,CAAC;IAEF,OAAO;QACL,KAAK;QACL,OAAO,EAAE,aAAa,CAAC,OAAO;QAC9B,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK;QAClC,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,UAAU;QAC5C,KAAK;QACL,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM;QACpC,IAAI;QACJ,IAAI;QACJ,QAAQ,EAAE,aAAa;QACvB,KAAK,EAAE,aAAa,CAAC,KAAK;QAC1B,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./errors/index.js";
+export * from "./hooks/index.js";
+export * from "./machines/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./errors/index.js";
+export * from "./hooks/index.js";
+export * from "./machines/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/dist/machines/facilitator-machine.d.ts

@@ -0,0 +1,81 @@
+import { Effect } from "effect";
+type EligibilityStatus = "idle" | "true" | "false" | "expired";
+type FacilitatedResult<TTransitive> = {
+    status: EligibilityStatus;
+    transitive: TTransitive | null;
+};
+type FacilitatorMachineContext<TTransitive> = {
+    error: string | null;
+    status: EligibilityStatus;
+    transitive: TTransitive | null;
+};
+type FacilitatorMachineEvents<TCheck, TCreate> = {
+    type: "CHECK";
+    payload: TCheck & {
+        soft?: boolean;
+    };
+} | {
+    type: "CREATE";
+    payload: TCreate;
+} | {
+    type: "RESET";
+};
+type FacilitatorMachineServices<TCheck, TCreate, TTransitive> = {
+    onCheck: (payload: TCheck & {
+        soft?: boolean;
+    }) => Effect.Effect<FacilitatedResult<TTransitive>, Error>;
+    onCreate: (input: {
+        create: TCreate;
+        transitive: TTransitive | null;
+    }) => Effect.Effect<void, Error>;
+};
+type FacilitatorMachineConfig<TCheck, TCreate, TTransitive> = {
+    id: string;
+    services: FacilitatorMachineServices<TCheck, TCreate, TTransitive>;
+};
+declare function createFacilitatorMachine<TCheck, TCreate, TTransitive>({ id, services, }: FacilitatorMachineConfig<TCheck, TCreate, TTransitive>): import("xstate").StateMachine<FacilitatorMachineContext<TTransitive>, {
+    type: "RESET";
+} | {
+    type: "CHECK";
+    payload: TCheck & {
+        soft?: boolean;
+    };
+} | {
+    type: "CREATE";
+    payload: TCreate;
+}, {
+    [x: string]: import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<FacilitatedResult<TTransitive>, TCheck & {
+        soft?: boolean;
+    }, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<void, {
+        create: TCreate;
+        transitive: TTransitive | null;
+    }, import("xstate").EventObject>> | undefined;
+}, {
+    src: "doCheck";
+    logic: import("xstate").PromiseActorLogic<FacilitatedResult<TTransitive>, TCheck & {
+        soft?: boolean;
+    }, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "doCreate";
+    logic: import("xstate").PromiseActorLogic<void, {
+        create: TCreate;
+        transitive: TTransitive | null;
+    }, import("xstate").EventObject>;
+    id: string | undefined;
+}, {
+    type: "doCache";
+    params: import("xstate").NonReducibleUnknown;
+} | {
+    type: "doClean";
+    params: import("xstate").NonReducibleUnknown;
+} | {
+    type: "doError";
+    params: import("xstate").NonReducibleUnknown;
+}, never, never, {}, string, import("xstate").NonReducibleUnknown, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
+    id?: string | undefined | undefined;
+    states?: {} | undefined;
+}>;
+export { createFacilitatorMachine };
+export type { EligibilityStatus, FacilitatedResult, FacilitatorMachineConfig, FacilitatorMachineContext, FacilitatorMachineEvents, FacilitatorMachineServices, };
+//# sourceMappingURL=facilitator-machine.d.ts.map

package/dist/machines/facilitator-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facilitator-machine.d.ts","sourceRoot":"","sources":["../../src/machines/facilitator-machine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAMhC,KAAK,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAK/D,KAAK,iBAAiB,CAAC,WAAW,IAAI;IACpC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,EAAE,WAAW,GAAG,IAAI,CAAC;CAChC,CAAC;AAKF,KAAK,yBAAyB,CAAC,WAAW,IAAI;IAE5C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB,MAAM,EAAE,iBAAiB,CAAC;IAE1B,UAAU,EAAE,WAAW,GAAG,IAAI,CAAC;CAChC,CAAC;AAKF,KAAK,wBAAwB,CAAC,MAAM,EAAE,OAAO,IACzC;IACE,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,GAAG;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACtC,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB,GACD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAKtB,KAAK,0BAA0B,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,IAAI;IAC9D,OAAO,EAAE,CACP,OAAO,EAAE,MAAM,GAAG;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,KACjC,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC;IAC1D,QAAQ,EAAE,CAAC,KAAK,EAAE;QAChB,MAAM,EAAE,OAAO,CAAC;QAChB,UAAU,EAAE,WAAW,GAAG,IAAI,CAAC;KAChC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;CAClC,CAAC;AAKF,KAAK,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,IAAI;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,0BAA0B,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;CACpE,CAAC;AA8BF,iBAAS,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAC9D,EAAE,EACF,QAAQ,GACT,EAAE,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC;UAtD7C,OAAO;;UAPP,OAAO;;eACc,OAAO;;;UAG5B,QAAQ;;;;eA4FoD,OAAO;;gBAIlC,OAAO;oBAAc,WAAW,GAAG,IAAI;;;;;eAJZ,OAAO;;;;;;gBAIlC,OAAO;oBAAc,WAAW,GAAG,IAAI;;;;;;;;;;;;;;;GAqHnF;AAED,OAAO,EAAE,wBAAwB,EAAE,CAAC;AACpC,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,GAC3B,CAAC"}

package/dist/machines/facilitator-machine.js

@@ -0,0 +1,155 @@
+import { Effect } from "effect";
+import { assign, fromPromise, setup } from "xstate";
+function createFacilitatorMachine({ id, services, }) {
+    return setup({
+        actions: {
+            doCache: assign({
+                error: () => null,
+                status: ({ event }) => {
+                    if ("output" in event) {
+                        const result = event.output;
+                        return result.status;
+                    }
+                    return "idle";
+                },
+                transitive: ({ event }) => {
+                    if ("output" in event) {
+                        const result = event.output;
+                        return result.transitive;
+                    }
+                    return null;
+                },
+            }),
+            doClean: assign({
+                error: () => null,
+                status: () => "idle",
+                transitive: () => null,
+            }),
+            doError: assign({
+                error: ({ event }) => {
+                    if ("error" in event && event.error instanceof Error) {
+                        return event.error.message;
+                    }
+                    return "An unknown error occurred";
+                },
+            }),
+        },
+        actors: {
+            doCheck: fromPromise(async ({ input }) => Effect.runPromise(services.onCheck(input))),
+            doCreate: fromPromise(async ({ input }) => Effect.runPromise(services.onCreate(input))),
+        },
+        types: {
+            context: {},
+            events: {},
+        },
+    }).createMachine({
+        context: {
+            error: null,
+            status: "idle",
+            transitive: null,
+        },
+        id: `facilitator-${id}`,
+        initial: "idle",
+        states: {
+            checked: {
+                on: {
+                    CHECK: {
+                        target: "checking",
+                    },
+                    CREATE: {
+                        target: "creating",
+                    },
+                    RESET: {
+                        target: "idle",
+                    },
+                },
+            },
+            checking: {
+                entry: "doClean",
+                invoke: {
+                    id: "check",
+                    input: ({ event }) => {
+                        if (event.type === "CHECK") {
+                            return event.payload;
+                        }
+                        throw new Error("Invalid event type for check");
+                    },
+                    onDone: {
+                        actions: "doCache",
+                        target: "checked",
+                    },
+                    onError: {
+                        actions: "doError",
+                        target: "failed",
+                    },
+                    src: "doCheck",
+                },
+                on: {
+                    CHECK: {
+                        target: "checking",
+                    },
+                    RESET: {
+                        target: "idle",
+                    },
+                },
+            },
+            created: {
+                on: {
+                    RESET: {
+                        target: "idle",
+                    },
+                },
+            },
+            creating: {
+                invoke: {
+                    id: "create",
+                    input: ({ event, context }) => {
+                        if (event.type === "CREATE") {
+                            return {
+                                create: event.payload,
+                                transitive: context.transitive,
+                            };
+                        }
+                        throw new Error("Invalid event type for create");
+                    },
+                    onDone: {
+                        target: "created",
+                    },
+                    onError: {
+                        actions: "doError",
+                        target: "failed",
+                    },
+                    src: "doCreate",
+                },
+                on: {
+                    RESET: {
+                        target: "idle",
+                    },
+                },
+            },
+            failed: {
+                on: {
+                    CHECK: {
+                        target: "checking",
+                    },
+                    CREATE: {
+                        target: "creating",
+                    },
+                    RESET: {
+                        target: "idle",
+                    },
+                },
+            },
+            idle: {
+                entry: "doClean",
+                on: {
+                    CHECK: {
+                        target: "checking",
+                    },
+                },
+            },
+        },
+    });
+}
+export { createFacilitatorMachine };
+//# sourceMappingURL=facilitator-machine.js.map

package/dist/machines/facilitator-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facilitator-machine.js","sourceRoot":"","sources":["../../src/machines/facilitator-machine.ts"],"names":[],"mappings":"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"}

package/dist/machines/form-machine.d.ts

@@ -0,0 +1,79 @@
+import { Effect } from "effect";
+type FormMachineContext<TPayload, TResult, TPreprocess> = {
+    error: string | null;
+    payload: TPayload;
+    preprocess: TPreprocess;
+    result: TResult | null;
+};
+type FormMachineEvents<TCheck, TPayload> = {
+    type: "SAVE";
+    payload: TPayload;
+} | {
+    type: "CHECK";
+    payload: TCheck;
+} | {
+    type: "RESET";
+};
+type FormMachineServices<TCheck, TPayload, TResult, TPreprocess> = {
+    onCheck: (payload: TCheck) => Effect.Effect<void, Error>;
+    onValidate: (payload: TPayload) => Effect.Effect<TPreprocess, Error>;
+    onProcess: (input: {
+        payload: TPayload;
+        preprocess: TPreprocess;
+    }) => Effect.Effect<TResult, Error>;
+};
+type FormMachineConfig<TCheck, TPayload, TResult, TPreprocess> = {
+    id: string;
+    services: FormMachineServices<TCheck, TPayload, TResult, TPreprocess>;
+    isUserRejectedError?: (error: unknown) => boolean;
+};
+declare function createFormMachine<TCheck, TPayload, TResult, TPreprocess = undefined>({ id, services, isUserRejectedError, }: FormMachineConfig<TCheck, TPayload, TResult, TPreprocess>): import("xstate").StateMachine<FormMachineContext<TPayload, TResult, TPreprocess>, {
+    type: "RESET";
+} | {
+    type: "SAVE";
+    payload: TPayload;
+} | {
+    type: "CHECK";
+    payload: TCheck;
+}, {
+    [x: string]: import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<void, TCheck, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<TResult, {
+        payload: TPayload;
+        preprocess: TPreprocess;
+    }, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<TPreprocess, TPayload, import("xstate").EventObject>> | undefined;
+}, {
+    src: "doCheck";
+    logic: import("xstate").PromiseActorLogic<void, TCheck, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "doProcess";
+    logic: import("xstate").PromiseActorLogic<TResult, {
+        payload: TPayload;
+        preprocess: TPreprocess;
+    }, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "doValidate";
+    logic: import("xstate").PromiseActorLogic<TPreprocess, TPayload, import("xstate").EventObject>;
+    id: string | undefined;
+}, {
+    type: "doCache";
+    params: import("xstate").NonReducibleUnknown;
+} | {
+    type: "doError";
+    params: import("xstate").NonReducibleUnknown;
+} | {
+    type: "doPreprocess";
+    params: import("xstate").NonReducibleUnknown;
+} | {
+    type: "doReset";
+    params: import("xstate").NonReducibleUnknown;
+} | {
+    type: "doResult";
+    params: import("xstate").NonReducibleUnknown;
+}, never, never, {}, string, import("xstate").NonReducibleUnknown, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
+    id?: string | undefined | undefined;
+    states?: {} | undefined;
+}>;
+export { createFormMachine };
+export type { FormMachineConfig, FormMachineContext, FormMachineEvents, FormMachineServices };
+//# sourceMappingURL=form-machine.d.ts.map

package/dist/machines/form-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-machine.d.ts","sourceRoot":"","sources":["../../src/machines/form-machine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAMhC,KAAK,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,IAAI;IAExD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB,OAAO,EAAE,QAAQ,CAAC;IAElB,UAAU,EAAE,WAAW,CAAC;IAExB,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACxB,CAAC;AAKF,KAAK,iBAAiB,CAAC,MAAM,EAAE,QAAQ,IACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAgBtB,KAAK,mBAAmB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,IAAI;IACjE,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzD,UAAU,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACrE,SAAS,EAAE,CAAC,KAAK,EAAE;QACjB,OAAO,EAAE,QAAQ,CAAC;QAClB,UAAU,EAAE,WAAW,CAAC;KACzB,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;CACrC,CAAC;AAKF,KAAK,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,IAAI;IAC/D,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,mBAAmB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAMtE,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACnD,CAAC;AA6BF,iBAAS,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,EAC7E,EAAE,EACF,QAAQ,EACR,mBAAmB,GACpB,EAAE,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC;UAtEhD,OAAO;;UAFP,MAAM;;;UACN,OAAO;;;;iBAsH2B,QAAQ;oBAAc,WAAW;;;;;;;;;iBAAjC,QAAQ;oBAAc,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;GAgI9E;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAC7B,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/machines/form-machine.js

@@ -0,0 +1,171 @@
+import { Effect } from "effect";
+import { assign, fromPromise, setup } from "xstate";
+function createFormMachine({ id, services, isUserRejectedError, }) {
+    return setup({
+        actions: {
+            doCache: assign({
+                payload: ({ event }) => {
+                    if (event.type === "SAVE") {
+                        return event.payload;
+                    }
+                    return {};
+                },
+            }),
+            doError: assign({
+                error: ({ event }) => {
+                    if ("error" in event && event.error instanceof Error) {
+                        return event.error.message;
+                    }
+                    return "An unknown error occurred";
+                },
+            }),
+            doPreprocess: assign({
+                preprocess: ({ event }) => {
+                    if ("output" in event) {
+                        return event.output;
+                    }
+                    return {};
+                },
+            }),
+            doReset: assign({
+                error: () => null,
+                payload: () => ({}),
+                preprocess: () => ({}),
+                result: () => null,
+            }),
+            doResult: assign({
+                result: ({ event }) => {
+                    if ("output" in event) {
+                        return event.output;
+                    }
+                    return null;
+                },
+            }),
+        },
+        actors: {
+            doCheck: fromPromise(async ({ input }) => Effect.runPromise(services.onCheck(input))),
+            doProcess: fromPromise(async ({ input }) => Effect.runPromise(services.onProcess(input))),
+            doValidate: fromPromise(async ({ input }) => Effect.runPromise(services.onValidate(input))),
+        },
+        types: {
+            context: {},
+            events: {},
+        },
+    }).createMachine({
+        context: {
+            error: null,
+            payload: {},
+            preprocess: {},
+            result: null,
+        },
+        id: `formMachine-${id}`,
+        initial: "initial",
+        states: {
+            check: {
+                invoke: {
+                    id: "check",
+                    input: ({ event }) => {
+                        if (event.type === "CHECK") {
+                            return event.payload;
+                        }
+                        throw new Error("Invalid event type for check");
+                    },
+                    onDone: {
+                        actions: "doReset",
+                        target: "initial",
+                    },
+                    onError: {
+                        actions: "doError",
+                        target: "initial",
+                    },
+                    src: "doCheck",
+                },
+                on: {
+                    CHECK: {
+                        actions: "doReset",
+                        target: "check",
+                    },
+                },
+            },
+            failure: {
+                on: {
+                    RESET: {
+                        target: "initial",
+                    },
+                    SAVE: {
+                        target: "validate",
+                    },
+                },
+            },
+            initial: {
+                exit: "doReset",
+                on: {
+                    CHECK: {
+                        target: "check",
+                    },
+                    SAVE: {
+                        target: "validate",
+                    },
+                },
+            },
+            process: {
+                invoke: {
+                    id: "process",
+                    input: ({ context }) => ({
+                        payload: context.payload,
+                        preprocess: context.preprocess,
+                    }),
+                    onDone: {
+                        actions: "doResult",
+                        target: "success",
+                    },
+                    onError: isUserRejectedError
+                        ? [
+                            {
+                                actions: "doReset",
+                                guard: ({ event }) => isUserRejectedError(event.error),
+                                target: "initial",
+                            },
+                            {
+                                actions: "doError",
+                                target: "failure",
+                            },
+                        ]
+                        : {
+                            actions: "doError",
+                            target: "failure",
+                        },
+                    src: "doProcess",
+                },
+            },
+            success: {
+                on: {
+                    RESET: {
+                        target: "initial",
+                    },
+                    SAVE: {
+                        target: "validate",
+                    },
+                },
+            },
+            validate: {
+                entry: "doCache",
+                invoke: {
+                    id: "validate",
+                    input: ({ context }) => context.payload,
+                    onDone: {
+                        actions: "doPreprocess",
+                        target: "process",
+                    },
+                    onError: {
+                        actions: "doError",
+                        target: "failure",
+                    },
+                    src: "doValidate",
+                },
+            },
+        },
+    });
+}
+export { createFormMachine };
+//# sourceMappingURL=form-machine.js.map

package/dist/machines/form-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-machine.js","sourceRoot":"","sources":["../../src/machines/form-machine.ts"],"names":[],"mappings":"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"}

package/dist/machines/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./facilitator-machine.js";
+export * from "./form-machine.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/machines/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/machines/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC"}

package/dist/machines/index.js

@@ -0,0 +1,3 @@
+export * from "./facilitator-machine.js";
+export * from "./form-machine.js";
+//# sourceMappingURL=index.js.map

package/dist/machines/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/machines/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@prb/effect-xstate",
+  "description": "Effect-TS and xState v5 workflow utilities",
+  "version": "1.0.0-beta.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "author": {
+    "name": "Paul Razvan Berg",
+    "url": "https://github.com/PaulRBerg"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@biomejs/biome": "catalog:dev",
+    "@effect/vitest": "catalog:dev",
+    "@sablier/devkit": "catalog:dev",
+    "@types/node": "catalog:dev",
+    "@types/react": "catalog:dev",
+    "@typescript/native-preview": "catalog:dev",
+    "@vitest/ui": "catalog:dev",
+    "@xstate/react": "^6.0.0",
+    "effect": "catalog:effect",
+    "react": "catalog:",
+    "tsc-alias": "catalog:dev",
+    "typescript": "catalog:dev",
+    "vitest": "catalog:dev",
+    "xstate": "^5.25.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./internal/*": null,
+    "./*": {
+      "types": "./dist/*/index.d.ts",
+      "import": "./dist/*/index.js"
+    }
+  },
+  "files": [
+    "dist/**",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@xstate/react": "catalog:peers",
+    "effect": "catalog:peers",
+    "react": "catalog:peers",
+    "xstate": "catalog:peers"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "@xstate/react": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}