@effect/cluster 0.28.4 → 0.29.0

package/dist/dts/ShardingConfig.d.ts

@@ -1,69 +1,172 @@
 /**
  * @since 1.0.0
  */
-import type * as ConfigError from "effect/ConfigError";
-import type * as Context from "effect/Context";
-import type * as Duration from "effect/Duration";
-import type * as Layer from "effect/Layer";
+import * as Config from "effect/Config";
+import type { ConfigError } from "effect/ConfigError";
+import * as Context from "effect/Context";
+import type { DurationInput } from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import { RunnerAddress } from "./RunnerAddress.js";
+declare const ShardingConfig_base: Context.TagClass<ShardingConfig, "@effect/cluster/ShardingConfig", {
+    /**
+     * The address for the current runner.
+     *
+     * If `None`, the runner is not part of the cluster and will be in a client-only
+     * mode.
+     */
+    readonly runnerAddress: Option.Option<RunnerAddress>;
+    /**
+     * The version of the current runner.
+     */
+    readonly serverVersion: number;
+    /**
+     * The number of shards to allocate to a runner.
+     *
+     * **Note**: this value should be consistent across all runners.
+     */
+    readonly numberOfShards: number;
+    /**
+     * The address of the shard manager.
+     */
+    readonly shardManagerAddress: RunnerAddress;
+    /**
+     * If the shard manager is unavailable for this duration, all the shard
+     * assignments will be reset.
+     */
+    readonly shardManagerUnavailableTimeout: DurationInput;
+    /**
+     * The default capacity of the mailbox for entities.
+     */
+    readonly entityMailboxCapacity: number | "unbounded";
+    /**
+     * The maximum duration of inactivity (i.e. without receiving a message)
+     * after which an entity will be interrupted.
+     */
+    readonly entityMaxIdleTime: DurationInput;
+    /**
+     * The maximum duration of time to wait for an entity to terminate.
+     *
+     * By default this is set to 15 seconds to stay within kubernetes defaults.
+     */
+    readonly entityTerminationTimeout: DurationInput;
+    /**
+     * The interval at which to poll for unprocessed messages from storage.
+     */
+    readonly entityMessagePollInterval: DurationInput;
+    /**
+     * The interval at which to poll for client replies from storage.
+     */
+    readonly entityReplyPollInterval: DurationInput;
+    readonly refreshAssignmentsInterval: DurationInput;
+    /**
+     * The interval to retry a send if EntityNotManagedByRunner is returned.
+     */
+    readonly sendRetryInterval: DurationInput;
+    /**
+     * Simulate serialization and deserialization to remote runners for local
+     * entities.
+     */
+    readonly simulateRemoteSerialization: boolean;
+}>;
 /**
+ * Represents the configuration for the `Sharding` service on a given runner.
+ *
  * @since 1.0.0
- * @category symbols
+ * @category models
  */
-export declare const ShardingConfigTypeId: unique symbol;
+export declare class ShardingConfig extends ShardingConfig_base {
+}
 /**
  * @since 1.0.0
- * @category symbols
+ * @category defaults
  */
-export type ShardingConfigTypeId = typeof ShardingConfigTypeId;
+export declare const defaults: ShardingConfig["Type"];
 /**
- * Sharding configuration
- * @param numberOfShards number of shards (see documentation on how to choose this), should be same on all nodes
- * @param selfHost hostname or IP address of the current pod
- * @param shardingPort port used for pods to communicate together
- * @param shardManagerUri url of the Shard Manager API
- * @param serverVersion version of the current pod
- * @param entityMaxIdleTime time of inactivity (without receiving any message) after which an entity will be interrupted
- * @param entityTerminationTimeout time we give to an entity to handle the termination message before interrupting it
- * @param refreshAssignmentsRetryInterval retry interval in case of failure getting shard assignments from storage
- * @param unhealthyPodReportInterval interval to report unhealthy pods to the Shard Manager (this exists to prevent calling the Shard Manager for each failed message)
  * @since 1.0.0
- * @category models
+ * @category Layers
  */
-export interface ShardingConfig {
-    readonly numberOfShards: number;
-    readonly selfHost: string;
-    readonly shardingPort: number;
-    readonly shardManagerUri: string;
-    readonly serverVersion: string;
-    readonly entityMaxIdleTime: Duration.Duration;
-    readonly entityTerminationTimeout: Duration.Duration;
-    readonly refreshAssignmentsRetryInterval: Duration.Duration;
-    readonly unhealthyPodReportInterval: Duration.Duration;
-}
+export declare const layer: (options?: Partial<ShardingConfig["Type"]>) => Layer.Layer<ShardingConfig>;
 /**
  * @since 1.0.0
- * @category context
+ * @category defaults
  */
-export declare const ShardingConfig: Context.Tag<ShardingConfig, ShardingConfig>;
+export declare const layerDefaults: Layer.Layer<ShardingConfig>;
 /**
- * Provides the default values for the ShardingConfig.
- *
  * @since 1.0.0
- * @category layers
+ * @category Config
  */
-export declare const defaults: Layer.Layer<ShardingConfig>;
+export declare const config: Config.Config<ShardingConfig["Type"]>;
 /**
- * Provides the ShardingConfig, values that are omitted will be read from the defaults
- *
  * @since 1.0.0
- * @category layers
+ * @category Config
  */
-export declare const withDefaults: (customs: Partial<ShardingConfig>) => Layer.Layer<ShardingConfig>;
+export declare const configFromEnv: Effect.Effect<{
+    /**
+     * The address for the current runner.
+     *
+     * If `None`, the runner is not part of the cluster and will be in a client-only
+     * mode.
+     */
+    readonly runnerAddress: Option.Option<RunnerAddress>;
+    /**
+     * The version of the current runner.
+     */
+    readonly serverVersion: number;
+    /**
+     * The number of shards to allocate to a runner.
+     *
+     * **Note**: this value should be consistent across all runners.
+     */
+    readonly numberOfShards: number;
+    /**
+     * The address of the shard manager.
+     */
+    readonly shardManagerAddress: RunnerAddress;
+    /**
+     * If the shard manager is unavailable for this duration, all the shard
+     * assignments will be reset.
+     */
+    readonly shardManagerUnavailableTimeout: DurationInput;
+    /**
+     * The default capacity of the mailbox for entities.
+     */
+    readonly entityMailboxCapacity: number | "unbounded";
+    /**
+     * The maximum duration of inactivity (i.e. without receiving a message)
+     * after which an entity will be interrupted.
+     */
+    readonly entityMaxIdleTime: DurationInput;
+    /**
+     * The maximum duration of time to wait for an entity to terminate.
+     *
+     * By default this is set to 15 seconds to stay within kubernetes defaults.
+     */
+    readonly entityTerminationTimeout: DurationInput;
+    /**
+     * The interval at which to poll for unprocessed messages from storage.
+     */
+    readonly entityMessagePollInterval: DurationInput;
+    /**
+     * The interval at which to poll for client replies from storage.
+     */
+    readonly entityReplyPollInterval: DurationInput;
+    readonly refreshAssignmentsInterval: DurationInput;
+    /**
+     * The interval to retry a send if EntityNotManagedByRunner is returned.
+     */
+    readonly sendRetryInterval: DurationInput;
+    /**
+     * Simulate serialization and deserialization to remote runners for local
+     * entities.
+     */
+    readonly simulateRemoteSerialization: boolean;
+}, ConfigError, never>;
 /**
- * Reads the ShardingConfig from the effect/ConfigProvider
- *
  * @since 1.0.0
- * @category layers
+ * @category Layers
  */
-export declare const fromConfig: Layer.Layer<ShardingConfig, ConfigError.ConfigError>;
+export declare const layerFromEnv: (options?: Partial<ShardingConfig["Type"]> | undefined) => Layer.Layer<ShardingConfig, ConfigError>;
+export {};
 //# sourceMappingURL=ShardingConfig.d.ts.map

package/dist/dts/ShardingConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShardingConfig.d.ts","sourceRoot":"","sources":["../../src/ShardingConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,KAAK,WAAW,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAG1C;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,OAAO,MAAsC,CAAA;AAEhF;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAA;AAE9D;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,QAAQ,CAAA;IAC7C,QAAQ,CAAC,wBAAwB,EAAE,QAAQ,CAAC,QAAQ,CAAA;IACpD,QAAQ,CAAC,+BAA+B,EAAE,QAAQ,CAAC,QAAQ,CAAA;IAC3D,QAAQ,CAAC,0BAA0B,EAAE,QAAQ,CAAC,QAAQ,CAAA;CACvD;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,cAAc,CAA8B,CAAA;AAErG;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,cAAc,CAAqB,CAAA;AAEtE;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,cAAc,CAAyB,CAAA;AAEpH;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,WAAW,CAAC,WAAW,CAAuB,CAAA"}
+{"version":3,"file":"ShardingConfig.d.ts","sourceRoot":"","sources":["../../src/ShardingConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;;IAShD;;;;;OAKG;4BACqB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC;IACpD;;OAEG;4BACqB,MAAM;IAC9B;;;;OAIG;6BACsB,MAAM;IAC/B;;OAEG;kCAC2B,aAAa;IAC3C;;;OAGG;6CACsC,aAAa;IACtD;;OAEG;oCAC6B,MAAM,GAAG,WAAW;IACpD;;;OAGG;gCACyB,aAAa;IACzC;;;;OAIG;uCACgC,aAAa;IAChD;;OAEG;wCACiC,aAAa;IACjD;;OAEG;sCAC+B,aAAa;yCACV,aAAa;IAClD;;OAEG;gCACyB,aAAa;IAEzC;;;OAGG;0CACmC,OAAO;;AAlE/C;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,mBA6DhC;CAAG;AAIP;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,cAAc,CAAC,MAAM,CAc3C,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,KAAK,aAAc,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,KAAG,KAAK,CAAC,KAAK,CAAC,cAAc,CAChC,CAAA;AAE5D;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,cAAc,CAAW,CAAA;AAEjE;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAqEvD,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa;IAhLxB;;;;;OAKG;4BACqB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC;IACpD;;OAEG;4BACqB,MAAM;IAC9B;;;;OAIG;6BACsB,MAAM;IAC/B;;OAEG;kCAC2B,aAAa;IAC3C;;;OAGG;6CACsC,aAAa;IACtD;;OAEG;oCAC6B,MAAM,GAAG,WAAW;IACpD;;;OAGG;gCACyB,aAAa;IACzC;;;;OAIG;uCACgC,aAAa;IAChD;;OAEG;wCACiC,aAAa;IACjD;;OAEG;sCAC+B,aAAa;yCACV,aAAa;IAClD;;OAEG;gCACyB,aAAa;IAEzC;;;OAGG;0CACmC,OAAO;sBA2H9C,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,aAAc,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,KAAG,KAAK,CAAC,KAAK,CAC9F,cAAc,EACd,WAAW,CAKV,CAAA"}

package/dist/dts/ShardingRegistrationEvent.d.ts

@@ -1,44 +1,59 @@
 /**
  * @since 1.0.0
  */
-import type * as Message from "./Message.js";
-import type * as RecipientType from "./RecipientType.js";
-interface EntityRegistered<Msg extends Message.Message.Any> {
-    _tag: "EntityRegistered";
-    entityType: RecipientType.EntityType<Msg>;
-}
+import * as Data from "effect/Data";
+import type { Entity } from "./Entity.js";
+import type { SingletonAddress } from "./SingletonAddress.js";
 /**
- * Constructs and event that occurs when a new EntityType gets registered.
+ * Represents events that can occur when a runner registers entities or singletons.
  *
  * @since 1.0.0
- * @category constructors
+ * @category models
+ */
+export type ShardingRegistrationEvent = EntityRegistered | SingletonRegistered;
+/**
+ * Represents an event that occurs when a new entity is registered with a runner.
+ *
+ * @since 1.0.0
+ * @category models
  */
-export declare function EntityRegistered<Msg extends Message.Message.Any>(entityType: RecipientType.EntityType<Msg>): ShardingRegistrationEvent;
-interface SingletonRegistered {
-    _tag: "SingletonRegistered";
-    name: string;
+export interface EntityRegistered {
+    readonly _tag: "EntityRegistered";
+    readonly entity: Entity<any>;
 }
 /**
- * Constructs a new event that occurs when a new Singleton is registered.
+ * Represents an event that occurs when a new singleton is registered with a
+ * runner.
  *
  * @since 1.0.0
- * @category constructors
+ * @category models
  */
-export declare function SingletonRegistered(name: string): ShardingRegistrationEvent;
-interface TopicRegistered<Msg extends Message.Message.Any> {
-    _tag: "TopicRegistered";
-    topicType: RecipientType.TopicType<Msg>;
+export interface SingletonRegistered {
+    readonly _tag: "SingletonRegistered";
+    readonly address: SingletonAddress;
 }
 /**
- * Constructs a new event that occurs when a topic is Registered.
+ * @since 1.0.0
+ * @category pattern matching
+ */
+export declare const match: {
+    <Cases extends {
+        readonly EntityRegistered: (args: EntityRegistered) => any;
+        readonly SingletonRegistered: (args: SingletonRegistered) => any;
+    }>(cases: Cases): (value: ShardingRegistrationEvent) => import("effect/Unify").Unify<ReturnType<Cases["EntityRegistered" | "SingletonRegistered"]>>;
+    <Cases extends {
+        readonly EntityRegistered: (args: EntityRegistered) => any;
+        readonly SingletonRegistered: (args: SingletonRegistered) => any;
+    }>(value: ShardingRegistrationEvent, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["EntityRegistered" | "SingletonRegistered"]>>;
+}, 
+/**
  * @since 1.0.0
  * @category constructors
  */
-export declare function TopicRegistered<Msg extends Message.Message.Any>(topicType: RecipientType.TopicType<Msg>): ShardingRegistrationEvent;
+EntityRegistered: Data.Case.Constructor<EntityRegistered, "_tag">, 
 /**
  * @since 1.0.0
- * @category models
+ * @category constructors
  */
-export type ShardingRegistrationEvent = EntityRegistered<any> | SingletonRegistered | TopicRegistered<any>;
-export {};
+SingletonRegistered: Data.Case.Constructor<SingletonRegistered, "_tag">;
 //# sourceMappingURL=ShardingRegistrationEvent.d.ts.map

package/dist/dts/ShardingRegistrationEvent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShardingRegistrationEvent.d.ts","sourceRoot":"","sources":["../../src/ShardingRegistrationEvent.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,KAAK,OAAO,MAAM,cAAc,CAAA;AAC5C,OAAO,KAAK,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAExD,UAAU,gBAAgB,CAAC,GAAG,SAAS,OAAO,CAAC,OAAO,CAAC,GAAG;IACxD,IAAI,EAAE,kBAAkB,CAAA;IACxB,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;CAC1C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,SAAS,OAAO,CAAC,OAAO,CAAC,GAAG,EAC9D,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,GACxC,yBAAyB,CAE3B;AAED,UAAU,mBAAmB;IAC3B,IAAI,EAAE,qBAAqB,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,CAE3E;AAED,UAAU,eAAe,CAAC,GAAG,SAAS,OAAO,CAAC,OAAO,CAAC,GAAG;IACvD,IAAI,EAAE,iBAAiB,CAAA;IACvB,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;CACxC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,SAAS,OAAO,CAAC,OAAO,CAAC,GAAG,EAC7D,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,GACtC,yBAAyB,CAE3B;AAED;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GACjC,gBAAgB,CAAC,GAAG,CAAC,GACrB,mBAAmB,GACnB,eAAe,CAAC,GAAG,CAAC,CAAA"}
+{"version":3,"file":"ShardingRegistrationEvent.d.ts","sourceRoot":"","sources":["../../src/ShardingRegistrationEvent.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,IAAI,MAAM,aAAa,CAAA;AACnC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE7D;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GACjC,gBAAgB,GAChB,mBAAmB,CAAA;AAEvB;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;CAC7B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;CACnC;AAED;;;GAGG;AACH,eAAO,MAKG,KAAK;;;;;;;;;;AACb;;;GAGG;AACH,gBAAgB;AAChB;;;GAGG;AACH,mBAAmB,oDAC2B,CAAA"}

package/dist/dts/Singleton.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @since 1.0.0
+ */
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import type { Scope } from "effect/Scope";
+import { Sharding } from "./Sharding.js";
+/**
+ * @since 1.0.0
+ * @category constructors
+ */
+export declare const make: <E, R>(name: string, run: Effect.Effect<void, E, R>) => Layer.Layer<never, never, Sharding | Exclude<R, Scope>>;
+//# sourceMappingURL=Singleton.d.ts.map

package/dist/dts/Singleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Singleton.d.ts","sourceRoot":"","sources":["../../src/Singleton.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC;;;GAGG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,CAAC,QACjB,MAAM,OACP,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,KAC7B,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAIpD,CAAA"}

package/dist/dts/SingletonAddress.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @since 1.0.0
+ */
+import * as Equal from "effect/Equal";
+import * as Hash from "effect/Hash";
+import * as Schema from "effect/Schema";
+/**
+ * @since 1.0.0
+ * @category Address
+ */
+export declare const TypeId: unique symbol;
+/**
+ * @since 1.0.0
+ * @category Address
+ */
+export type TypeId = typeof TypeId;
+declare const SingletonAddress_base: Schema.Class<SingletonAddress, {
+    shardId: Schema.brand<typeof Schema.Int, "ShardId">;
+    name: typeof Schema.NonEmptyTrimmedString;
+}, Schema.Struct.Encoded<{
+    shardId: Schema.brand<typeof Schema.Int, "ShardId">;
+    name: typeof Schema.NonEmptyTrimmedString;
+}>, never, {
+    readonly shardId: number & import("effect/Brand").Brand<"ShardId">;
+} & {
+    readonly name: string;
+}, {}, {}>;
+/**
+ * Represents the unique address of an singleton within the cluster.
+ *
+ * @since 1.0.0
+ * @category Address
+ */
+export declare class SingletonAddress extends SingletonAddress_base {
+    /**
+     * @since 1.0.0
+     */
+    readonly [TypeId]: symbol;
+    /**
+     * @since 1.0.0
+     */
+    [Hash.symbol](): number;
+    /**
+     * @since 1.0.0
+     */
+    [Equal.symbol](that: SingletonAddress): boolean;
+}
+export {};
+//# sourceMappingURL=SingletonAddress.d.ts.map

package/dist/dts/SingletonAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SingletonAddress.d.ts","sourceRoot":"","sources":["../../src/SingletonAddress.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,OAAO,MAAuD,CAAA;AAEnF;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAA;;;;;;;;;;;;AAElC;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,qBAGpC;IACA;;OAEG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAU;IAC3B;;OAEG;IACH,CAAC,IAAI,CAAC,MAAM,CAAC;IAGb;;OAEG;IACH,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;CAGhD"}

package/dist/dts/Snowflake.d.ts

@@ -0,0 +1,121 @@
+/**
+ * @since 1.0.0
+ */
+import type * as Brand from "effect/Brand";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+import type { MachineId } from "./MachineId.js";
+/**
+ * @since 1.0.0
+ * @category Symbols
+ */
+export declare const TypeId: unique symbol;
+/**
+ * @since 1.0.0
+ * @category Symbols
+ */
+export type TypeId = typeof TypeId;
+/**
+ * @since 1.0.0
+ * @category Models
+ */
+export type Snowflake = Brand.Branded<bigint, TypeId>;
+/**
+ * @since 1.0.0
+ * @category Models
+ */
+export declare const Snowflake: (input: string | bigint) => Snowflake;
+/**
+ * @since 1.0.0
+ * @category Models
+ */
+export declare namespace Snowflake {
+    /**
+     * @since 1.0.0
+     * @category Models
+     */
+    interface Parts {
+        readonly timestamp: number;
+        readonly machineId: MachineId;
+        readonly sequence: number;
+    }
+    /**
+     * @since 1.0.0
+     * @category Models
+     */
+    interface Generator {
+        readonly unsafeNext: () => Snowflake;
+        readonly setMachineId: (machineId: MachineId) => Effect.Effect<void>;
+    }
+}
+/**
+ * @since 1.0.0
+ * @category Schemas
+ */
+export declare const SnowflakeFromBigInt: Schema.Schema<Snowflake, bigint>;
+/**
+ * @since 1.0.0
+ * @category Schemas
+ */
+export declare const SnowflakeFromString: Schema.Schema<Snowflake, string>;
+/**
+ * @since 1.0.0
+ * @category Epoch
+ */
+export declare const constEpochMillis: number;
+/**
+ * @since 1.0.0
+ * @category constructors
+ */
+export declare const make: (options: {
+    readonly machineId: MachineId;
+    readonly sequence: number;
+    readonly timestamp: number;
+}) => Snowflake;
+/**
+ * @since 1.0.0
+ * @category Parts
+ */
+export declare const timestamp: (snowflake: Snowflake) => number;
+/**
+ * @since 1.0.0
+ * @category Parts
+ */
+export declare const dateTime: (snowflake: Snowflake) => DateTime.Utc;
+/**
+ * @since 1.0.0
+ * @category Parts
+ */
+export declare const machineId: (snowflake: Snowflake) => MachineId;
+/**
+ * @since 1.0.0
+ * @category Parts
+ */
+export declare const sequence: (snowflake: Snowflake) => number;
+/**
+ * @since 1.0.0
+ * @category Parts
+ */
+export declare const toParts: (snowflake: Snowflake) => Snowflake.Parts;
+/**
+ * @since 1.0.0
+ * @category Generator
+ */
+export declare const makeGenerator: Effect.Effect<Snowflake.Generator>;
+declare const Generator_base: Context.TagClass<Generator, "@effect/cluster/Snowflake/Generator", Snowflake.Generator>;
+/**
+ * @since 1.0.0
+ * @category Generator
+ */
+export declare class Generator extends Generator_base {
+}
+/**
+ * @since 1.0.0
+ * @category Generator
+ */
+export declare const layerGenerator: Layer.Layer<Generator>;
+export {};
+//# sourceMappingURL=Snowflake.d.ts.map

package/dist/dts/Snowflake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Snowflake.d.ts","sourceRoot":"","sources":["../../src/Snowflake.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,OAAO,MAAgD,CAAA;AAE5E;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAA;AAElC;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAErD;;;GAGG;AACH,eAAO,MAAM,SAAS,UAAW,MAAM,GAAG,MAAM,KAAG,SAC0B,CAAA;AAE7E;;;GAGG;AACH,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC;;;OAGG;IACH,UAAiB,KAAK;QACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;QAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAC1B;IAED;;;OAGG;IACH,UAAiB,SAAS;QACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,SAAS,CAAA;QACpC,QAAQ,CAAC,YAAY,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;KACrE;CACF;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAEhE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAEhE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAA6B,CAAA;AAQ5D;;;GAGG;AACH,eAAO,MAAM,IAAI,YAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B,KAAG,SAG+C,CAAA;AAEnD;;;GAGG;AACH,eAAO,MAAM,SAAS,cAAe,SAAS,KAAG,MAA6D,CAAA;AAE9G;;;GAGG;AACH,eAAO,MAAM,QAAQ,cAAe,SAAS,KAAG,QAAQ,CAAC,GAAgD,CAAA;AAEzG;;;GAGG;AACH,eAAO,MAAM,SAAS,cAAe,SAAS,KAAG,SACoB,CAAA;AAErE;;;GAGG;AACH,eAAO,MAAM,QAAQ,cAAe,SAAS,KAAG,MAA6C,CAAA;AAE7F;;;GAGG;AACH,eAAO,MAAM,OAAO,cAAe,SAAS,KAAG,SAAS,CAAC,KAIvD,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAoC3D,CAAA;;AAEF;;;GAGG;AACH,qBAAa,SAAU,SAAQ,cAG5B;CAAG;AAEN;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS,CAA0C,CAAA"}

package/dist/dts/SocketRunner.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @since 1.0.0
+ */
+import { SocketServer } from "@effect/platform/SocketServer";
+import type * as RpcSerialization from "@effect/rpc/RpcSerialization";
+import * as Layer from "effect/Layer";
+import type { MessageStorage } from "./MessageStorage.js";
+import * as Runners from "./Runners.js";
+import * as Sharding from "./Sharding.js";
+import type { ShardingConfig } from "./ShardingConfig.js";
+import * as ShardStorage from "./ShardStorage.js";
+/**
+ * @since 1.0.0
+ * @category Layers
+ */
+export declare const layer: Layer.Layer<Sharding.Sharding | Runners.Runners, never, Runners.RpcClientProtocol | ShardingConfig | RpcSerialization.RpcSerialization | SocketServer | MessageStorage | ShardStorage.ShardStorage>;
+/**
+ * @since 1.0.0
+ * @category Layers
+ */
+export declare const layerClientOnly: Layer.Layer<Sharding.Sharding | Runners.Runners, never, Runners.RpcClientProtocol | ShardingConfig | MessageStorage>;
+//# sourceMappingURL=SocketRunner.d.ts.map

package/dist/dts/SocketRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocketRunner.d.ts","sourceRoot":"","sources":["../../src/SocketRunner.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAC5D,OAAO,KAAK,KAAK,gBAAgB,MAAM,8BAA8B,CAAA;AAGrE,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEzD,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AAcjD;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAC7B,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,EACnC,KAAK,EACH,OAAO,CAAC,iBAAiB,GACzB,cAAc,GACd,gBAAgB,CAAC,gBAAgB,GACjC,YAAY,GACZ,cAAc,GACd,YAAY,CAAC,YAAY,CAI5B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,KAAK,CACvC,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,EACnC,KAAK,EACL,OAAO,CAAC,iBAAiB,GAAG,cAAc,GAAG,cAAc,CAK5D,CAAA"}

package/dist/dts/SocketShardManager.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @since 1.0.0
+ */
+import { SocketServer } from "@effect/platform/SocketServer";
+import type { RpcSerialization } from "@effect/rpc/RpcSerialization";
+import * as Layer from "effect/Layer";
+import type { RunnerHealth } from "./RunnerHealth.js";
+import * as Runners from "./Runners.js";
+import type { ShardingConfig } from "./ShardingConfig.js";
+import * as ShardManager from "./ShardManager.js";
+import type { ShardStorage } from "./ShardStorage.js";
+/**
+ * @since 1.0.0
+ * @category Layers
+ */
+export declare const layer: Layer.Layer<ShardManager.ShardManager, never, ShardStorage | SocketServer | Runners.RpcClientProtocol | RpcSerialization | RunnerHealth | ShardManager.Config | ShardingConfig>;
+//# sourceMappingURL=SocketShardManager.d.ts.map

package/dist/dts/SocketShardManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocketShardManager.d.ts","sourceRoot":"","sources":["../../src/SocketShardManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAGpE,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAcrD;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAC7B,YAAY,CAAC,YAAY,EACzB,KAAK,EACH,YAAY,GACZ,YAAY,GACZ,OAAO,CAAC,iBAAiB,GACzB,gBAAgB,GAChB,YAAY,GACZ,YAAY,CAAC,MAAM,GACnB,cAAc,CAOjB,CAAA"}

package/dist/dts/SqlMessageStorage.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @since 1.0.0
+ */
+import * as SqlClient from "@effect/sql/SqlClient";
+import type { SqlError } from "@effect/sql/SqlError";
+import type { DurationInput } from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { PersistenceError } from "./ClusterError.js";
+import * as MessageStorage from "./MessageStorage.js";
+import type * as Reply from "./Reply.js";
+import type { ShardingConfig } from "./ShardingConfig.js";
+import * as Snowflake from "./Snowflake.js";
+/**
+ * @since 1.0.0
+ * @category Constructors
+ */
+export declare const make: (options?: {
+    readonly prefix?: string | undefined;
+} | undefined) => Effect.Effect<{
+    readonly saveRequest: <R extends import("@effect/rpc/Rpc").Any>(envelope: import("./Message.js").OutgoingRequest<R>) => Effect.Effect<MessageStorage.SaveResult<R>, PersistenceError | import("./ClusterError.js").MalformedMessage>;
+    readonly saveEnvelope: (envelope: import("./Message.js").OutgoingEnvelope) => Effect.Effect<void, PersistenceError | import("./ClusterError.js").MalformedMessage>;
+    readonly saveReply: <R extends import("@effect/rpc/Rpc").Any>(reply: Reply.ReplyWithContext<R>) => Effect.Effect<void, PersistenceError | import("./ClusterError.js").MalformedMessage>;
+    readonly repliesFor: <R extends import("@effect/rpc/Rpc").Any>(requests: Iterable<import("./Message.js").OutgoingRequest<R>>) => Effect.Effect<Array<Reply.Reply<R>>, PersistenceError | import("./ClusterError.js").MalformedMessage>;
+    readonly registerReplyHandler: <R extends import("@effect/rpc/Rpc").Any>(message: import("./Message.js").OutgoingRequest<R>) => Effect.Effect<void>;
+    readonly unprocessedMessages: (shardIds: Iterable<import("./ShardId.js").ShardId>) => Effect.Effect<Array<import("./Message.js").Incoming<any>>, PersistenceError>;
+    readonly unprocessedMessagesById: <R extends import("@effect/rpc/Rpc").Any>(messageIds: Iterable<Snowflake.Snowflake>) => Effect.Effect<Array<import("./Message.js").Incoming<R>>, PersistenceError>;
+    readonly resetAddress: (address: import("./EntityAddress.js").EntityAddress) => Effect.Effect<void, PersistenceError>;
+}, SqlError, Snowflake.Generator | SqlClient.SqlClient>;
+/**
+ * @since 1.0.0
+ * @category Layers
+ */
+export declare const layer: Layer.Layer<MessageStorage.MessageStorage, SqlError, SqlClient.SqlClient | ShardingConfig>;
+/**
+ * @since 1.0.0
+ * @category Layers
+ */
+export declare const layerWith: (options: {
+    readonly prefix?: string | undefined;
+    readonly replyPollInterval?: DurationInput | undefined;
+}) => Layer.Layer<MessageStorage.MessageStorage, SqlError, SqlClient.SqlClient | ShardingConfig>;
+//# sourceMappingURL=SqlMessageStorage.d.ts.map

package/dist/dts/SqlMessageStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqlMessageStorage.d.ts","sourceRoot":"","sources":["../../src/SqlMessageStorage.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,SAAS,MAAM,uBAAuB,CAAA;AAElD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAEpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAGrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEpD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAE3C;;;GAGG;AACH,eAAO,MAAM,IAAI;sBACG,MAAM,GAAG,SAAS;;4HAaX,OAAQ,MAAM;kFAQ/B,OAAA,MAAI;yEAImB,MAAO,gBAC3B,QAAU,OACb,MAAF;qIASM,OAAQ,MAAM,OAClB,MAAA,KAAI;oIAQH,OAAQ,MAAM;0FAWf,OAAG,MAAM;qGAMT,UAAC,SAAS,MAAQ,OAClB,MAAA;oFAI8D,OAAS,MAAK;uDAypBpF,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAC7B,cAAc,CAAC,cAAc,EAC7B,QAAQ,EACR,SAAS,CAAC,SAAS,GAAG,cAAc,CAGrC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,YAAa;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;CACvD,KAAG,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,EAAE,QAAQ,EAAE,SAAS,CAAC,SAAS,GAAG,cAAc,CAG1F,CAAA"}