@typeonce/effect-machine 0.3.0 → 0.5.0

package/dist/{ClusterMachine.d.ts → unstable/cluster/ClusterMachine.d.ts}

@@ -1,13 +1,18 @@
-import * as Context from "effect/Context";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import * as Option from "effect/Option";
+/**
+ * Runs Effect machines as persisted Cluster entities.
+ *
+ * @since 0.4.0
+ */
+import type * as Effect from "effect/Effect";
+import type * as Layer from "effect/Layer";
+import type * as Option from "effect/Option";
 import * as Schema from "effect/Schema";
-import { ClusterError, Entity, EntityAddress, MessageStorage, type Sharding, Snowflake } from "effect/unstable/cluster";
-import { Rpc } from "effect/unstable/rpc";
-import * as Machine from "./Machine.js";
-type EntityAddress = EntityAddress.EntityAddress;
-type PersistenceError = ClusterError.PersistenceError;
+import type { Entity, MessageStorage, Sharding, Snowflake } from "effect/unstable/cluster";
+import type { Rpc } from "effect/unstable/rpc";
+import * as internal from "../../internal/machine/cluster.js";
+import { Accepted, Rejected, Storage } from "../../internal/machine/cluster.js";
+import type { EnsureExecutable } from "../../internal/machine/readiness.js";
+import type * as Machine from "../../Machine.js";
 type Snowflake = Snowflake.Snowflake;
 /**
  * Persisted machine checkpoint owned by the Cluster bridge.
@@ -19,7 +24,7 @@ type Snowflake = Snowflake.Snowflake;
  * checkpoint.
  *
  * @category models
- * @since 4.0.0
+ * @since 0.4.0
  */
 export interface Checkpoint {
     /** Stable identity of the machine definition that produced the snapshot. */
@@ -41,7 +46,7 @@ export interface Checkpoint {
  * redelivery even after later requests have advanced the checkpoint.
  *
  * @category models
- * @since 4.0.0
+ * @since 0.4.0
  */
 export interface LoadResult {
     /** Latest checkpoint for the entity, when one has been committed. */
@@ -53,14 +58,14 @@ export interface LoadResult {
  * Result of atomically committing a Cluster machine request.
  *
  * @category models
- * @since 4.0.0
+ * @since 0.4.0
  */
 export type CommitResult = CommitResult.Committed | CommitResult.Duplicate;
 /**
  * Constructors and types for Cluster machine commit results.
  *
  * @category models
- * @since 4.0.0
+ * @since 0.4.0
  */
 export declare const CommitResult: {
     Committed: () => CommitResult.Committed;
@@ -69,14 +74,15 @@ export declare const CommitResult: {
 /**
  * Types for Cluster machine commit results.
  *
- * @since 4.0.0
+ * @category models
+ * @since 0.4.0
  */
 export declare namespace CommitResult {
     /**
      * Indicates that the request id and checkpoint were committed atomically.
      *
      * @category models
-     * @since 4.0.0
+     * @since 0.4.0
      */
     interface Committed {
         readonly _tag: "Committed";
@@ -85,16 +91,12 @@ export declare namespace CommitResult {
      * Indicates that the request id was already committed.
      *
      * @category models
-     * @since 4.0.0
+     * @since 0.4.0
      */
     interface Duplicate {
         readonly _tag: "Duplicate";
     }
 }
-declare const Storage_base: Context.ServiceClass<Storage, "effect/cluster/ClusterMachine/Storage", {
-    readonly load: (address: EntityAddress, requestId: Snowflake) => Effect.Effect<LoadResult, PersistenceError>;
-    readonly commit: (address: EntityAddress, checkpoint: Checkpoint) => Effect.Effect<CommitResult, PersistenceError>;
-}>;
 /**
  * Checkpoint persistence service used by Cluster machines.
  *
@@ -113,55 +115,47 @@ declare const Storage_base: Context.ServiceClass<Storage, "effect/cluster/Cluste
  * provide checkpoint-and-emission atomicity.
  *
  * @category services
- * @since 4.0.0
+ * @since 0.4.0
  */
-export declare class Storage extends Storage_base {
-}
-declare const Accepted_base: Schema.Class<Accepted, Schema.TaggedStruct<"Accepted", {}>, {}>;
+export { Storage };
 /**
  * Successful result returned after a Cluster machine request is committed or
  * recognized as a redelivery.
  *
  * @category models
- * @since 4.0.0
+ * @since 0.4.0
  */
-export declare class Accepted extends Accepted_base {
-}
+export { Accepted };
 /**
  * Schema for reasons a Cluster machine request can be rejected without
  * advancing its checkpoint.
  *
  * @category models
- * @since 4.0.0
+ * @since 0.4.0
  */
 export declare const RejectionReason: Schema.Literals<readonly ["MachineIdMismatch", "VersionMismatch", "InvalidCheckpoint", "UnsupportedProcessLocal", "TransitionFailure", "PersistenceFailure", "EmissionFailure"]>;
 /**
  * Type of {@link RejectionReason}.
  *
  * @category models
- * @since 4.0.0
+ * @since 0.4.0
  */
 export type RejectionReason = typeof RejectionReason.Type;
-declare const Rejected_base: Schema.Class<Rejected, Schema.TaggedStruct<"Rejected", {
-    readonly reason: Schema.Literals<readonly ["MachineIdMismatch", "VersionMismatch", "InvalidCheckpoint", "UnsupportedProcessLocal", "TransitionFailure", "PersistenceFailure", "EmissionFailure"]>;
-    readonly message: Schema.String;
-}>, {}>;
 /**
  * Rejected Cluster machine request. Transaction-participating durable storage
  * leaves the previous checkpoint in place and suppresses emitted events.
  *
  * @category models
- * @since 4.0.0
+ * @since 0.4.0
  */
-export declare class Rejected extends Rejected_base {
-}
+export { Rejected };
 /**
  * Schema for Cluster machine request outcomes.
  *
  * @category schemas
- * @since 4.0.0
+ * @since 0.4.0
  */
-export declare const SendResult: Schema.Union<readonly [typeof Accepted, typeof Rejected]>;
+export declare const SendResult: Schema.Union<readonly [typeof internal.Accepted, typeof internal.Rejected]>;
 type SendRpc<Events extends ReadonlyArray<Machine.Machine.TaggedSchema>> = Rpc.Rpc<"send", Schema.Union<Events>, typeof SendResult>;
 type MachineEvents<M extends Machine.Machine.Any> = Machine.Machine.InputEvents<M>;
 type MachineEmits<M extends Machine.Machine.Any> = Machine.Machine.Emits<M>;
@@ -175,7 +169,7 @@ type MachineEmits<M extends Machine.Machine.Any> = Machine.Machine.Emits<M>;
  * the checkpoint at most once.
  *
  * @category models
- * @since 4.0.0
+ * @since 0.4.0
  */
 export interface ClusterMachine<in out Type extends string, in out M extends Machine.Machine.Any, out Services = MachineServices<M>> {
     /** Machine definition executed by each entity instance. */
@@ -193,7 +187,7 @@ export interface ClusterMachine<in out Type extends string, in out M extends Mac
      * is persisted after commit and recovered through request-id deduplication if
      * delivery is interrupted. Machines that never emit may omit `enqueue`.
      *
-     * @since 4.0.0
+     * @since 0.4.0
      */
     readonly toLayer: <R = never>(options?: {
         readonly enqueue?: (event: Machine.Machine.EmitOf<MachineEmits<M>>) => Effect.Effect<void, unknown, R>;
@@ -216,14 +210,14 @@ type ExcludeCompatibleRuntime<Requirements, Events, Emits> = Requirements extend
  * `MessageStorage` transaction marker.
  *
  * @category constructors
- * @since 4.0.0
+ * @since 0.4.0
  */
 export declare const makeMemory: Effect.Effect<Storage["Service"]>;
 /**
  * Layer providing the in-memory Cluster machine checkpoint store.
  *
  * @category layers
- * @since 4.0.0
+ * @since 0.4.0
  */
 export declare const layerMemory: Layer.Layer<Storage>;
 /**
@@ -250,11 +244,28 @@ export declare const layerMemory: Layer.Layer<Storage>;
  * Arbitrary action effects may run again after a crash before checkpoint
  * commit, so the bridge does not provide exactly-once external effects.
  *
+ * **Example**
+ *
+ * ```ts
+ * import { Schema } from "effect"
+ * import { Machine } from "@typeonce/effect-machine"
+ * import { ClusterMachine } from "@typeonce/effect-machine/cluster"
+ *
+ * class Idle extends Schema.TaggedClass<Idle>("Idle")("Idle", {}) {}
+ * const States = Machine.defineStates({ Idle })
+ * const machine = Machine.make({
+ *   states: States.states,
+ *   events: [],
+ *   initial: () => States.initial.Idle.from()
+ * }).handle({ Idle: {} })
+ *
+ * const adapter = ClusterMachine.make("IdleMachine", machine, { version: "1" })
+ * ```
+ *
  * @category constructors
- * @since 4.0.0
+ * @since 0.4.0
  */
-export declare const make: <const Type extends string, States extends Machine.Machine.StateSchemas, Events extends ReadonlyArray<Machine.Machine.TaggedSchema>, Input extends Schema.Top, UnhandledStates extends Machine.Machine.StateIdentifier<States>, E, R, InitialE, InitialR, FinalStates extends Machine.Machine.StateIdentifier<States>, Output, Emits extends ReadonlyArray<Machine.Machine.TaggedSchema>, OutputStates extends Machine.Machine.StateIdentifier<States>, InputEvents extends ReadonlyArray<Machine.Machine.TaggedSchema> = Events>(type: Type, machine: Machine.Machine<States, Events, Input, UnhandledStates, E, R, InitialE, InitialR, FinalStates, Output, Emits, OutputStates, InputEvents> & Machine.Machine.EnsureOutputImplementations<States, OutputStates>, options: {
+export declare const make: <const Type extends string, States extends Machine.Machine.StateSchemas, Events extends ReadonlyArray<Machine.Machine.TaggedSchema>, Input extends Schema.Top, UnhandledStates extends Machine.Machine.StateIdentifier<States>, E, R, InitialE, InitialR, FinalStates extends Machine.Machine.StateIdentifier<States>, Output, Emits extends ReadonlyArray<Machine.Machine.TaggedSchema>, OutputStates extends Machine.Machine.StateIdentifier<States>, InputEvents extends ReadonlyArray<Machine.Machine.TaggedSchema> = Events>(type: Type, machine: Machine.Machine<States, Events, Input, UnhandledStates, E, R, InitialE, InitialR, FinalStates, Output, Emits, OutputStates, InputEvents> & EnsureExecutable<States, UnhandledStates, OutputStates>, options: {
     readonly version: string;
 }, ...input: [...Machine.Machine.InputArgs<Input>]) => ClusterMachine<Type, Machine.Machine<States, Events, Input, UnhandledStates, E, R, InitialE, InitialR, FinalStates, Output, Emits, OutputStates, InputEvents>, ExcludeCompatibleRuntime<Machine.ExecutionServices<R | InitialR>, Machine.Machine.EventOf<Events>, Machine.Machine.EmitOf<Emits>> | Machine.Machine.SnapshotDecodingServices<States> | Machine.Machine.SnapshotEncodingServices<States>>;
-export {};
 //# sourceMappingURL=ClusterMachine.d.ts.map

package/dist/unstable/cluster/ClusterMachine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterMachine.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/ClusterMachine.ts"],"names":[],"mappings":"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"}

package/dist/unstable/cluster/ClusterMachine.js

@@ -0,0 +1,144 @@
+import * as Schema from "effect/Schema";
+import * as internal from "../../internal/machine/cluster.js";
+import { Accepted, Rejected, Storage } from "../../internal/machine/cluster.js";
+/**
+ * Constructors and types for Cluster machine commit results.
+ *
+ * @category models
+ * @since 0.4.0
+ */
+export const CommitResult = {
+    Committed: () => ({ _tag: "Committed" }),
+    Duplicate: () => ({ _tag: "Duplicate" })
+};
+/**
+ * Checkpoint persistence service used by Cluster machines.
+ *
+ * **When to use**
+ *
+ * Use to connect `ClusterMachine` to a durable checkpoint store that can
+ * atomically deduplicate request ids and replace the current checkpoint.
+ *
+ * **Gotchas**
+ *
+ * For checkpoint and emitted-message persistence to commit atomically, this
+ * service must join the transaction opened through the configured
+ * `MessageStorage`. The reply is persisted after that transaction; storing the
+ * request id with the checkpoint makes a redelivery recover that reply without
+ * applying the transition again. A separate transaction or database cannot
+ * provide checkpoint-and-emission atomicity.
+ *
+ * @category services
+ * @since 0.4.0
+ */
+export { Storage };
+/**
+ * Successful result returned after a Cluster machine request is committed or
+ * recognized as a redelivery.
+ *
+ * @category models
+ * @since 0.4.0
+ */
+export { Accepted };
+/**
+ * Schema for reasons a Cluster machine request can be rejected without
+ * advancing its checkpoint.
+ *
+ * @category models
+ * @since 0.4.0
+ */
+export const RejectionReason = Schema.Literals([
+    "MachineIdMismatch",
+    "VersionMismatch",
+    "InvalidCheckpoint",
+    "UnsupportedProcessLocal",
+    "TransitionFailure",
+    "PersistenceFailure",
+    "EmissionFailure"
+]);
+/**
+ * Rejected Cluster machine request. Transaction-participating durable storage
+ * leaves the previous checkpoint in place and suppresses emitted events.
+ *
+ * @category models
+ * @since 0.4.0
+ */
+export { Rejected };
+/**
+ * Schema for Cluster machine request outcomes.
+ *
+ * @category schemas
+ * @since 0.4.0
+ */
+export const SendResult = Schema.Union([Accepted, Rejected]);
+/**
+ * Creates an in-memory Cluster machine checkpoint store.
+ *
+ * **When to use**
+ *
+ * Use when you test or run a local process that does not require checkpoints
+ * to survive a restart.
+ *
+ * **Gotchas**
+ *
+ * This store is not durable and does not provide rollback with the in-memory
+ * `MessageStorage` transaction marker.
+ *
+ * @category constructors
+ * @since 0.4.0
+ */
+export const makeMemory = internal.makeMemory;
+/**
+ * Layer providing the in-memory Cluster machine checkpoint store.
+ *
+ * @category layers
+ * @since 0.4.0
+ */
+export const layerMemory = internal.layerMemory;
+/**
+ * Creates a persisted Cluster entity adapter for a machine.
+ *
+ * **When to use**
+ *
+ * Use when each Cluster entity id should own one durable machine snapshot and
+ * accept schema-validated machine events through a persisted `send` RPC.
+ *
+ * **Details**
+ *
+ * A missing checkpoint runs initial planning before the first event. Existing
+ * checkpoints are identity-checked, version-checked, decoded, and resumed
+ * without rerunning initial entry behavior. Final checkpoints accept later
+ * requests as no-ops. The stable bridge identity is `machine.id` when present,
+ * otherwise the Cluster entity type.
+ *
+ * **Gotchas**
+ *
+ * Invoked processes, spawned children, action-time `runtime.raise`, timers,
+ * subscriptions, and other process-local state are not durable and are
+ * rejected. Planning-time raised events remain part of the current macrostep.
+ * Arbitrary action effects may run again after a crash before checkpoint
+ * commit, so the bridge does not provide exactly-once external effects.
+ *
+ * **Example**
+ *
+ * ```ts
+ * import { Schema } from "effect"
+ * import { Machine } from "@typeonce/effect-machine"
+ * import { ClusterMachine } from "@typeonce/effect-machine/cluster"
+ *
+ * class Idle extends Schema.TaggedClass<Idle>("Idle")("Idle", {}) {}
+ * const States = Machine.defineStates({ Idle })
+ * const machine = Machine.make({
+ *   states: States.states,
+ *   events: [],
+ *   initial: () => States.initial.Idle.from()
+ * }).handle({ Idle: {} })
+ *
+ * const adapter = ClusterMachine.make("IdleMachine", machine, { version: "1" })
+ * ```
+ *
+ * @category constructors
+ * @since 0.4.0
+ */
+export const make = internal.make;
+//# sourceMappingURL=ClusterMachine.js.map

package/dist/unstable/cluster/ClusterMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterMachine.js","sourceRoot":"","sources":["../../../src/unstable/cluster/ClusterMachine.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC,OAAO,KAAK,QAAQ,MAAM,mCAAmC,CAAA;AAC7D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAA;AA4D/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,SAAS,EAAE,GAA2B,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAChE,SAAS,EAAE,GAA2B,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;CACjE,CAAA;AA8BD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,OAAO,EAAE,CAAA;AAElB;;;;;;GAMG;AACH,OAAO,EAAE,QAAQ,EAAE,CAAA;AAEnB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC7C,mBAAmB;IACnB,iBAAiB;IACjB,mBAAmB;IACnB,yBAAyB;IACzB,mBAAmB;IACnB,oBAAoB;IACpB,iBAAiB;CAClB,CAAC,CAAA;AAUF;;;;;;GAMG;AACH,OAAO,EAAE,QAAQ,EAAE,CAAA;AAEnB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAA;AA0E5D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,UAAU,GAAsC,QAAQ,CAAC,UAAU,CAAA;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAyB,QAAQ,CAAC,WAAW,CAAA;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,CAAC,MAAM,IAAI,GA8Db,QAAQ,CAAC,IAAI,CAAA"}

package/dist/{cluster.js → unstable/cluster/index.d.ts}

@@ -1,2 +1,2 @@
 export * as ClusterMachine from "./ClusterMachine.js";
-//# sourceMappingURL=cluster.js.map
+//# sourceMappingURL=index.d.ts.map

package/dist/unstable/cluster/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA"}

package/dist/{cluster.d.ts → unstable/cluster/index.js}

@@ -1,2 +1,2 @@
 export * as ClusterMachine from "./ClusterMachine.js";
-//# sourceMappingURL=cluster.d.ts.map
+//# sourceMappingURL=index.js.map

package/dist/unstable/cluster/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/unstable/cluster/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA"}