effect 4.0.0-beta.66 → 4.0.0-beta.68

package/dist/unstable/cluster/ShardingConfig.js

@@ -1,4 +1,19 @@
 /**
+ * The `ShardingConfig` module defines the configuration used by a cluster
+ * runner to participate in Effect Cluster sharding. It describes how a runner is
+ * addressed by other runners, which shard groups it can host, how many shards
+ * are assigned per group, and the timing settings used for locks, assignment
+ * refreshes, health checks, entity lifecycle, and message polling.
+ *
+ * Use this module when wiring a sharded application locally with
+ * {@link layer}, loading deployment settings from environment variables with
+ * {@link layerFromEnv}, or overriding selected defaults for tests and
+ * single-node development. In production, keep cluster-wide values such as
+ * `shardsPerGroup` and shard groups consistent across runners, choose stable
+ * externally reachable runner addresses, and tune lock expiration and refresh
+ * intervals to match the storage backend and shutdown behavior of the
+ * deployment platform.
+ *
  * @since 4.0.0
  */
 import * as Config from "../../Config.js";
@@ -13,8 +28,8 @@ import { RunnerAddress } from "./RunnerAddress.js";
 /**
  * Represents the configuration for the `Sharding` service on a given runner.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export class ShardingConfig extends /*#__PURE__*/Context.Service()("effect/cluster/ShardingConfig") {}
 const defaultRunnerAddress = /*#__PURE__*/RunnerAddress.make({
@@ -22,15 +37,20 @@ const defaultRunnerAddress = /*#__PURE__*/RunnerAddress.make({
   port: 34431
 });
 /**
- * @since 4.0.0
+ * Default values for `ShardingConfig`, including the default local runner address,
+ * shard group, shard count, mailbox settings, polling intervals, and remote
+ * serialization simulation.
+ *
  * @category defaults
+ * @since 4.0.0
  */
 export const defaults = {
   runnerAddress: /*#__PURE__*/Option.some(defaultRunnerAddress),
   runnerListenAddress: /*#__PURE__*/Option.none(),
   runnerShardWeight: 1,
   shardsPerGroup: 300,
-  shardGroups: ["default"],
+  availableShardGroups: ["default"],
+  assignedShardGroups: ["default"],
   preemptiveShutdown: true,
   shardLockRefreshInterval: /*#__PURE__*/Duration.seconds(10),
   shardLockExpiration: /*#__PURE__*/Duration.seconds(35),
@@ -47,21 +67,29 @@ export const defaults = {
   simulateRemoteSerialization: true
 };
 /**
+ * Creates a `ShardingConfig` layer by merging the provided partial options over
+ * `defaults`.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 export const layer = options => Layer.succeed(ShardingConfig)({
   ...defaults,
   ...options
 });
 /**
- * @since 4.0.0
+ * Layer that provides the default `ShardingConfig` values.
+ *
  * @category defaults
+ * @since 4.0.0
  */
 export const layerDefaults = /*#__PURE__*/layer();
 /**
- * @since 4.0.0
+ * Config descriptor for loading `ShardingConfig` values, applying the same
+ * defaults used by the in-memory `defaults` object.
+ *
  * @category Config
+ * @since 4.0.0
  */
 export const config = /*#__PURE__*/Config.all({
   runnerAddress: /*#__PURE__*/Config.all({
@@ -82,7 +110,10 @@ export const config = /*#__PURE__*/Config.all({
   runnerShardWeight: /*#__PURE__*/Config.int("runnerShardWeight").pipe(/*#__PURE__*/Config.withDefault(defaults.runnerShardWeight)
   // Config.withDescription("A number that determines how many shards this runner will be assigned relative to other runners.")
   ),
-  shardGroups: /*#__PURE__*/Config.schema(Schema.Array(Schema.String), "shardGroups").pipe(/*#__PURE__*/Config.withDefault(["default"])
+  availableShardGroups: /*#__PURE__*/Config.schema(Schema.Array(Schema.String), "availableShardGroups").pipe(/*#__PURE__*/Config.withDefault(["default"])
+  // Config.withDescription("The shard groups available across all runners.")
+  ),
+  assignedShardGroups: /*#__PURE__*/Config.schema(Schema.Array(Schema.String), "shardGroups").pipe(/*#__PURE__*/Config.withDefault(["default"])
   // Config.withDescription("The shard groups that are assigned to this runner.")
   ),
   shardsPerGroup: /*#__PURE__*/Config.int("shardsPerGroup").pipe(/*#__PURE__*/Config.withDefault(defaults.shardsPerGroup)
@@ -135,16 +166,42 @@ export const config = /*#__PURE__*/Config.all({
   )
 });
 /**
- * @since 4.0.0
+ * Effect that loads `ShardingConfig` from environment variables using the
+ * constant-case config provider.
+ *
  * @category Config
+ * @since 4.0.0
  */
 export const configFromEnv = /*#__PURE__*/config.pipe(/*#__PURE__*/Effect.provideService(ConfigProvider.ConfigProvider, /*#__PURE__*/ConfigProvider.fromEnv().pipe(ConfigProvider.constantCase)));
 /**
+ * Layer that loads `ShardingConfig` from environment variables and, when options
+ * are provided, overlays those options on top of the loaded values.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 export const layerFromEnv = options => Layer.effect(ShardingConfig)(options ? Effect.map(configFromEnv, config => ({
   ...config,
   ...options
 })) : configFromEnv);
+/**
+ * Normalizes the provided `ShardingConfig` to calculate the `available` and
+ * `assigned` shard groups.
+ *
+ * @category Shard groups
+ * @since 4.0.0
+ */
+export const shardGroupConfig = config => {
+  const available = new Set(config.availableShardGroups.slice().sort());
+  const assigned = new Set();
+  available.forEach(group => {
+    if (config.assignedShardGroups.includes(group)) {
+      assigned.add(group);
+    }
+  });
+  return {
+    available,
+    assigned
+  };
+};
 //# sourceMappingURL=ShardingConfig.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ShardingConfig.js","names":["Config","ConfigProvider","Context","Duration","Effect","Layer","Option","Schema","RunnerAddress","ShardingConfig","Service","defaultRunnerAddress","make","host","port","defaults","runnerAddress","some","runnerListenAddress","none","runnerShardWeight","shardsPerGroup","shardGroups","preemptiveShutdown","shardLockRefreshInterval","seconds","shardLockExpiration","shardLockDisableAdvisory","entityMailboxCapacity","entityMaxIdleTime","minutes","entityRegistrationTimeout","entityTerminationTimeout","entityMessagePollInterval","entityReplyPollInterval","millis","sendRetryInterval","refreshAssignmentsInterval","runnerHealthCheckInterval","simulateRemoteSerialization","layer","options","succeed","layerDefaults","config","all","string","pipe","withDefault","int","map","option","schema","Array","String","duration","boolean","configFromEnv","provideService","fromEnv","constantCase","layerFromEnv","effect"],"sources":["../../../src/unstable/cluster/ShardingConfig.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"ShardingConfig.js","names":["Config","ConfigProvider","Context","Duration","Effect","Layer","Option","Schema","RunnerAddress","ShardingConfig","Service","defaultRunnerAddress","make","host","port","defaults","runnerAddress","some","runnerListenAddress","none","runnerShardWeight","shardsPerGroup","availableShardGroups","assignedShardGroups","preemptiveShutdown","shardLockRefreshInterval","seconds","shardLockExpiration","shardLockDisableAdvisory","entityMailboxCapacity","entityMaxIdleTime","minutes","entityRegistrationTimeout","entityTerminationTimeout","entityMessagePollInterval","entityReplyPollInterval","millis","sendRetryInterval","refreshAssignmentsInterval","runnerHealthCheckInterval","simulateRemoteSerialization","layer","options","succeed","layerDefaults","config","all","string","pipe","withDefault","int","map","option","schema","Array","String","duration","boolean","configFromEnv","provideService","fromEnv","constantCase","layerFromEnv","effect","shardGroupConfig","available","Set","slice","sort","assigned","forEach","group","includes","add"],"sources":["../../../src/unstable/cluster/ShardingConfig.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/cluster/ShardingRegistrationEvent.d.ts

@@ -1,4 +1,18 @@
 /**
+ * The `ShardingRegistrationEvent` module defines the events emitted by
+ * `Sharding` when the local runner registers entity handlers or singleton
+ * workloads. These events are useful for observing the set of capabilities a
+ * runner has made available, coordinating startup hooks, and writing tests or
+ * integrations that need to react when registrations are complete.
+ *
+ * Registration events describe local registration, not shard ownership or
+ * execution. A runner may register an entity or singleton before it owns the
+ * shard that will run it, and the events are in-memory notifications from the
+ * `Sharding` service rather than persisted cluster state. For persisted
+ * messages, treat registration as the point where the handler is available to
+ * the runner; it does not imply that existing storage work has already been
+ * read or processed.
+ *
  * @since 4.0.0
  */
 import * as Data from "../../Data.ts";
@@ -7,15 +21,15 @@ import type { SingletonAddress } from "./SingletonAddress.ts";
 /**
  * Represents events that can occur when a runner registers entities or singletons.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export type ShardingRegistrationEvent = EntityRegistered | SingletonRegistered;
 /**
  * Represents an event that occurs when a new entity is registered with a runner.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface EntityRegistered {
     readonly _tag: "EntityRegistered";
@@ -25,16 +39,19 @@ export interface EntityRegistered {
  * Represents an event that occurs when a new singleton is registered with a
  * runner.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface SingletonRegistered {
     readonly _tag: "SingletonRegistered";
     readonly address: SingletonAddress;
 }
 /**
- * @since 4.0.0
+ * Generated helpers for pattern matching and constructing sharding registration
+ * events.
+ *
  * @category pattern matching
+ * @since 4.0.0
  */
 export declare const match: {
     <Cases extends {
@@ -47,13 +64,17 @@ export declare const match: {
     }>(value: ShardingRegistrationEvent, cases: Cases): import("../../Unify.ts").Unify<ReturnType<Cases["EntityRegistered" | "SingletonRegistered"]>>;
 }, 
 /**
- * @since 4.0.0
+ * Creates an event for an entity registered by the local runner.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 EntityRegistered: Data.TaggedEnum.ConstructorFrom<EntityRegistered, "_tag">, 
 /**
- * @since 4.0.0
+ * Creates an event for a singleton registered by the local runner.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 SingletonRegistered: Data.TaggedEnum.ConstructorFrom<SingletonRegistered, "_tag">;
 //# sourceMappingURL=ShardingRegistrationEvent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ShardingRegistrationEvent.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/ShardingRegistrationEvent.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,IAAI,MAAM,eAAe,CAAA;AACrC,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,EAAE,GAAG,CAAC,CAAA;CAClC;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,8DAC2B,CAAA"}
+{"version":3,"file":"ShardingRegistrationEvent.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/ShardingRegistrationEvent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,IAAI,MAAM,eAAe,CAAA;AACrC,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,EAAE,GAAG,CAAC,CAAA;CAClC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;CACnC;AAED;;;;;;GAMG;AACH,eAAO,MAQG,KAAK;;;;;;;;;;AACb;;;;;GAKG;AACH,gBAAgB;AAChB;;;;;GAKG;AACH,mBAAmB,8DAC2B,CAAA"}

package/dist/unstable/cluster/ShardingRegistrationEvent.js

@@ -1,25 +1,49 @@
 /**
+ * The `ShardingRegistrationEvent` module defines the events emitted by
+ * `Sharding` when the local runner registers entity handlers or singleton
+ * workloads. These events are useful for observing the set of capabilities a
+ * runner has made available, coordinating startup hooks, and writing tests or
+ * integrations that need to react when registrations are complete.
+ *
+ * Registration events describe local registration, not shard ownership or
+ * execution. A runner may register an entity or singleton before it owns the
+ * shard that will run it, and the events are in-memory notifications from the
+ * `Sharding` service rather than persisted cluster state. For persisted
+ * messages, treat registration as the point where the handler is available to
+ * the runner; it does not imply that existing storage work has already been
+ * read or processed.
+ *
  * @since 4.0.0
  */
 import * as Data from "../../Data.js";
 /**
- * @since 4.0.0
+ * Generated helpers for pattern matching and constructing sharding registration
+ * events.
+ *
  * @category pattern matching
+ * @since 4.0.0
  */
 export const {
   /**
-   * @since 4.0.0
+   * Pattern matches on a sharding registration event and dispatches to the
+   * matching variant handler.
+   *
    * @category pattern matching
+   * @since 4.0.0
    */
   $match: match,
   /**
-   * @since 4.0.0
+   * Creates an event for an entity registered by the local runner.
+   *
    * @category constructors
+   * @since 4.0.0
    */
   EntityRegistered,
   /**
-   * @since 4.0.0
+   * Creates an event for a singleton registered by the local runner.
+   *
    * @category constructors
+   * @since 4.0.0
    */
   SingletonRegistered
 } = /*#__PURE__*/Data.taggedEnum();

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

@@ -1 +1 @@
-{"version":3,"file":"ShardingRegistrationEvent.js","names":["Data","$match","match","EntityRegistered","SingletonRegistered","taggedEnum"],"sources":["../../../src/unstable/cluster/ShardingRegistrationEvent.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAGA,OAAO,KAAKA,IAAI,MAAM,eAAe;AAqCrC;;;;AAIA,OAAO,MAAM;EACX;;;;EAIAC,MAAM,EAAEC,KAAK;EACb;;;;EAIAC,gBAAgB;EAChB;;;;EAIAC;AAAmB,CACpB,gBAAGJ,IAAI,CAACK,UAAU,EAA6B","ignoreList":[]}
+{"version":3,"file":"ShardingRegistrationEvent.js","names":["Data","$match","match","EntityRegistered","SingletonRegistered","taggedEnum"],"sources":["../../../src/unstable/cluster/ShardingRegistrationEvent.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;AAiBA,OAAO,KAAKA,IAAI,MAAM,eAAe;AAqCrC;;;;;;;AAOA,OAAO,MAAM;EACX;;;;;;;EAOAC,MAAM,EAAEC,KAAK;EACb;;;;;;EAMAC,gBAAgB;EAChB;;;;;;EAMAC;AAAmB,CACpB,gBAAGJ,IAAI,CAACK,UAAU,EAA6B","ignoreList":[]}

package/dist/unstable/cluster/SingleRunner.d.ts

@@ -1,4 +1,26 @@
 /**
+ * The `SingleRunner` module provides a ready-to-use layer for running the
+ * cluster sharding services in a single process. It wires together sharding,
+ * message storage, runner registration, runner health, and sharding
+ * configuration so durable entities and workflows can run without a fleet of
+ * external runners.
+ *
+ * **Common tasks**
+ *
+ * - Start a local or embedded cluster runner backed by SQL message storage
+ * - Run durable entities and workflows in development, tests, or small
+ *   single-node deployments
+ * - Choose SQL runner storage for persistence or in-memory runner storage for
+ *   short-lived scenarios
+ * - Override sharding configuration while still using the standard
+ *   environment-based defaults
+ *
+ * **Gotchas**
+ *
+ * - The layer still requires a `SqlClient` because message storage is SQL-backed
+ * - Runner health and runner coordination are no-op implementations, so this is
+ *   for single-node use rather than multi-runner cluster coordination
+ *
  * @since 4.0.0
  */
 import * as Layer from "effect/Layer";
@@ -12,8 +34,8 @@ import * as ShardingConfig from "./ShardingConfig.ts";
  * A sql backed single-node cluster, that can be used for running durable
  * entities and workflows.
  *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 export declare const layer: (options?: {
     readonly shardingConfig?: Partial<ShardingConfig.ShardingConfig["Service"]> | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"SingleRunner.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/SingleRunner.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,KAAK,SAAS,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAE1D,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAIrD;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,UAAU;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,GAAG,SAAS,CAAA;IACvF,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAA;CACtD,KAAG,KAAK,CAAC,KAAK,CACX,QAAQ,CAAC,QAAQ,GACjB,OAAO,CAAC,OAAO,GACf,cAAc,CAAC,cAAc,EAC/B,WAAW,EACX,SAAS,CAAC,SAAS,CAUlB,CAAA"}
+{"version":3,"file":"SingleRunner.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/SingleRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,KAAK,SAAS,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAE1D,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAIrD;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,UAAU;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,GAAG,SAAS,CAAA;IACvF,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAA;CACtD,KAAG,KAAK,CAAC,KAAK,CACX,QAAQ,CAAC,QAAQ,GACjB,OAAO,CAAC,OAAO,GACf,cAAc,CAAC,cAAc,EAC/B,WAAW,EACX,SAAS,CAAC,SAAS,CAUlB,CAAA"}

package/dist/unstable/cluster/SingleRunner.js

@@ -1,4 +1,26 @@
 /**
+ * The `SingleRunner` module provides a ready-to-use layer for running the
+ * cluster sharding services in a single process. It wires together sharding,
+ * message storage, runner registration, runner health, and sharding
+ * configuration so durable entities and workflows can run without a fleet of
+ * external runners.
+ *
+ * **Common tasks**
+ *
+ * - Start a local or embedded cluster runner backed by SQL message storage
+ * - Run durable entities and workflows in development, tests, or small
+ *   single-node deployments
+ * - Choose SQL runner storage for persistence or in-memory runner storage for
+ *   short-lived scenarios
+ * - Override sharding configuration while still using the standard
+ *   environment-based defaults
+ *
+ * **Gotchas**
+ *
+ * - The layer still requires a `SqlClient` because message storage is SQL-backed
+ * - Runner health and runner coordination are no-op implementations, so this is
+ *   for single-node use rather than multi-runner cluster coordination
+ *
  * @since 4.0.0
  */
 import * as Layer from "effect/Layer";
@@ -13,8 +35,8 @@ import * as SqlRunnerStorage from "./SqlRunnerStorage.js";
  * A sql backed single-node cluster, that can be used for running durable
  * entities and workflows.
  *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 export const layer = options => Sharding.layer.pipe(Layer.provideMerge(Runners.layerNoop), Layer.provideMerge(SqlMessageStorage.layer), Layer.provide([options?.runnerStorage === "memory" ? RunnerStorage.layerMemory : Layer.orDie(SqlRunnerStorage.layer), RunnerHealth.layerNoop]), Layer.provide(ShardingConfig.layerFromEnv(options?.shardingConfig)));
 //# sourceMappingURL=SingleRunner.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"SingleRunner.js","names":["Layer","RunnerHealth","Runners","RunnerStorage","Sharding","ShardingConfig","SqlMessageStorage","SqlRunnerStorage","layer","options","pipe","provideMerge","layerNoop","provide","runnerStorage","layerMemory","orDie","layerFromEnv","shardingConfig"],"sources":["../../../src/unstable/cluster/SingleRunner.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAGA,OAAO,KAAKA,KAAK,MAAM,cAAc;AAIrC,OAAO,KAAKC,YAAY,MAAM,mBAAmB;AACjD,OAAO,KAAKC,OAAO,MAAM,cAAc;AACvC,OAAO,KAAKC,aAAa,MAAM,oBAAoB;AACnD,OAAO,KAAKC,QAAQ,MAAM,eAAe;AACzC,OAAO,KAAKC,cAAc,MAAM,qBAAqB;AACrD,OAAO,KAAKC,iBAAiB,MAAM,wBAAwB;AAC3D,OAAO,KAAKC,gBAAgB,MAAM,uBAAuB;AAEzD;;;;;;;AAOA,OAAO,MAAMC,KAAK,GAAIC,OAGrB,IAOCL,QAAQ,CAACI,KAAK,CAACE,IAAI,CACjBV,KAAK,CAACW,YAAY,CAACT,OAAO,CAACU,SAAS,CAAC,EACrCZ,KAAK,CAACW,YAAY,CAACL,iBAAiB,CAACE,KAAK,CAAC,EAC3CR,KAAK,CAACa,OAAO,CAAC,CACZJ,OAAO,EAAEK,aAAa,KAAK,QAAQ,GAAGX,aAAa,CAACY,WAAW,GAAGf,KAAK,CAACgB,KAAK,CAACT,gBAAgB,CAACC,KAAK,CAAC,EACrGP,YAAY,CAACW,SAAS,CACvB,CAAC,EACFZ,KAAK,CAACa,OAAO,CAACR,cAAc,CAACY,YAAY,CAACR,OAAO,EAAES,cAAc,CAAC,CAAC,CACpE","ignoreList":[]}
+{"version":3,"file":"SingleRunner.js","names":["Layer","RunnerHealth","Runners","RunnerStorage","Sharding","ShardingConfig","SqlMessageStorage","SqlRunnerStorage","layer","options","pipe","provideMerge","layerNoop","provide","runnerStorage","layerMemory","orDie","layerFromEnv","shardingConfig"],"sources":["../../../src/unstable/cluster/SingleRunner.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,OAAO,KAAKA,KAAK,MAAM,cAAc;AAIrC,OAAO,KAAKC,YAAY,MAAM,mBAAmB;AACjD,OAAO,KAAKC,OAAO,MAAM,cAAc;AACvC,OAAO,KAAKC,aAAa,MAAM,oBAAoB;AACnD,OAAO,KAAKC,QAAQ,MAAM,eAAe;AACzC,OAAO,KAAKC,cAAc,MAAM,qBAAqB;AACrD,OAAO,KAAKC,iBAAiB,MAAM,wBAAwB;AAC3D,OAAO,KAAKC,gBAAgB,MAAM,uBAAuB;AAEzD;;;;;;;AAOA,OAAO,MAAMC,KAAK,GAAIC,OAGrB,IAOCL,QAAQ,CAACI,KAAK,CAACE,IAAI,CACjBV,KAAK,CAACW,YAAY,CAACT,OAAO,CAACU,SAAS,CAAC,EACrCZ,KAAK,CAACW,YAAY,CAACL,iBAAiB,CAACE,KAAK,CAAC,EAC3CR,KAAK,CAACa,OAAO,CAAC,CACZJ,OAAO,EAAEK,aAAa,KAAK,QAAQ,GAAGX,aAAa,CAACY,WAAW,GAAGf,KAAK,CAACgB,KAAK,CAACT,gBAAgB,CAACC,KAAK,CAAC,EACrGP,YAAY,CAACW,SAAS,CACvB,CAAC,EACFZ,KAAK,CAACa,OAAO,CAACR,cAAc,CAACY,YAAY,CAACR,OAAO,EAAES,cAAc,CAAC,CAAC,CACpE","ignoreList":[]}

package/dist/unstable/cluster/Singleton.d.ts

@@ -1,4 +1,15 @@
 /**
+ * The `Singleton` module provides a small helper for registering effects that
+ * should run once across an Effect cluster. A singleton is coordinated through
+ * `Sharding`, which assigns ownership to one node at a time and can move that
+ * ownership when nodes leave or fail.
+ *
+ * Use singletons for cluster-wide background work such as schedulers, polling
+ * loops, maintenance jobs, or consumers that must not have one instance per
+ * process. Because ownership can change during failover, the registered effect
+ * should be interruptible, scoped, and able to resume work without assuming that
+ * the previous owner completed every in-flight action exactly once.
+ *
  * @since 4.0.0
  */
 import * as Effect from "../../Effect.ts";
@@ -6,8 +17,11 @@ import * as Layer from "../../Layer.ts";
 import type { Scope } from "../../Scope.ts";
 import { Sharding } from "./Sharding.ts";
 /**
- * @since 4.0.0
+ * Creates a layer that registers a singleton effect with `Sharding` under the
+ * specified name and optional shard group.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export declare const make: <E, R>(name: string, run: Effect.Effect<void, E, R>, options?: {
     readonly shardGroup?: string | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"Singleton.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/Singleton.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC;;;GAGG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,CAAC,EACvB,MAAM,MAAM,EACZ,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,UAAU;IACR,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACzC,KACA,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAIpD,CAAA"}
+{"version":3,"file":"Singleton.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/Singleton.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,CAAC,EACvB,MAAM,MAAM,EACZ,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,UAAU;IACR,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACzC,KACA,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAIpD,CAAA"}

package/dist/unstable/cluster/Singleton.js

@@ -1,12 +1,26 @@
 /**
+ * The `Singleton` module provides a small helper for registering effects that
+ * should run once across an Effect cluster. A singleton is coordinated through
+ * `Sharding`, which assigns ownership to one node at a time and can move that
+ * ownership when nodes leave or fail.
+ *
+ * Use singletons for cluster-wide background work such as schedulers, polling
+ * loops, maintenance jobs, or consumers that must not have one instance per
+ * process. Because ownership can change during failover, the registered effect
+ * should be interruptible, scoped, and able to resume work without assuming that
+ * the previous owner completed every in-flight action exactly once.
+ *
  * @since 4.0.0
  */
 import * as Effect from "../../Effect.js";
 import * as Layer from "../../Layer.js";
 import { Sharding } from "./Sharding.js";
 /**
- * @since 4.0.0
+ * Creates a layer that registers a singleton effect with `Sharding` under the
+ * specified name and optional shard group.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export const make = (name, run, options) => Layer.effectDiscard(Effect.gen(function* () {
   const sharding = yield* Sharding;

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

@@ -1 +1 @@
-{"version":3,"file":"Singleton.js","names":["Effect","Layer","Sharding","make","name","run","options","effectDiscard","gen","sharding","registerSingleton"],"sources":["../../../src/unstable/cluster/Singleton.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAGA,OAAO,KAAKA,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,KAAK,MAAM,gBAAgB;AAEvC,SAASC,QAAQ,QAAQ,eAAe;AAExC;;;;AAIA,OAAO,MAAMC,IAAI,GAAGA,CAClBC,IAAY,EACZC,GAA8B,EAC9BC,OAEC,KAEDL,KAAK,CAACM,aAAa,CAACP,MAAM,CAACQ,GAAG,CAAC,aAAS;EACtC,MAAMC,QAAQ,GAAG,OAAOP,QAAQ;EAChC,OAAOO,QAAQ,CAACC,iBAAiB,CAACN,IAAI,EAAEC,GAAG,EAAEC,OAAO,CAAC;AACvD,CAAC,CAAC,CAAC","ignoreList":[]}
+{"version":3,"file":"Singleton.js","names":["Effect","Layer","Sharding","make","name","run","options","effectDiscard","gen","sharding","registerSingleton"],"sources":["../../../src/unstable/cluster/Singleton.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;AAcA,OAAO,KAAKA,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,KAAK,MAAM,gBAAgB;AAEvC,SAASC,QAAQ,QAAQ,eAAe;AAExC;;;;;;;AAOA,OAAO,MAAMC,IAAI,GAAGA,CAClBC,IAAY,EACZC,GAA8B,EAC9BC,OAEC,KAEDL,KAAK,CAACM,aAAa,CAACP,MAAM,CAACQ,GAAG,CAAC,aAAS;EACtC,MAAMC,QAAQ,GAAG,OAAOP,QAAQ;EAChC,OAAOO,QAAQ,CAACC,iBAAiB,CAACN,IAAI,EAAEC,GAAG,EAAEC,OAAO,CAAC;AACvD,CAAC,CAAC,CAAC","ignoreList":[]}

package/dist/unstable/cluster/SingletonAddress.d.ts

@@ -1,4 +1,18 @@
 /**
+ * The `SingletonAddress` module defines the address used by cluster sharding to
+ * identify a registered singleton. A singleton address combines the singleton
+ * name with the `ShardId` that owns it, giving the runtime a stable key for
+ * registration events, equality checks, hashing, and runner-local fiber
+ * tracking.
+ *
+ * Use this module when observing singleton registrations or working with
+ * sharding internals that need to tell which shard currently owns a singleton.
+ * The shard id is derived from the singleton name and shard group at
+ * registration time, so changing either value changes ownership and routing.
+ * Ownership can also move as shard locks are acquired or released, so an address
+ * identifies the target shard rather than guaranteeing that a particular runner
+ * is currently executing the singleton.
+ *
  * @since 4.0.0
  */
 import * as Equal from "../../Equal.ts";
@@ -13,19 +27,25 @@ declare const SingletonAddress_base: Schema.Class<SingletonAddress, Schema.Struc
 /**
  * Represents the unique address of an singleton within the cluster.
  *
- * @since 4.0.0
  * @category Address
+ * @since 4.0.0
  */
 export declare class SingletonAddress extends SingletonAddress_base {
     /**
+     * Marks this value as a cluster singleton address for runtime guards.
+     *
      * @since 4.0.0
      */
     readonly [TypeId] = "~effect/cluster/SingletonAddress";
     /**
+     * Computes a structural hash from the singleton name and shard id.
+     *
      * @since 4.0.0
      */
     [Hash.symbol](): number;
     /**
+     * Compares singleton addresses by name and shard id.
+     *
      * @since 4.0.0
      */
     [Equal.symbol](that: SingletonAddress): boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"SingletonAddress.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/SingletonAddress.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,eAAe,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,QAAA,MAAM,MAAM,qCAAqC,CAAA;;;;;AAEjD;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,qBAGpC;IACA;;OAEG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,sCAAU;IAC3B;;OAEG;IACH,CAAC,IAAI,CAAC,MAAM,CAAC;IAGb;;OAEG;IACH,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;CAGhD"}
+{"version":3,"file":"SingletonAddress.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/SingletonAddress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,eAAe,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,QAAA,MAAM,MAAM,qCAAqC,CAAA;;;;;AAEjD;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,qBAGpC;IACA;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,sCAAU;IAC3B;;;;OAIG;IACH,CAAC,IAAI,CAAC,MAAM,CAAC;IAGb;;;;OAIG;IACH,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;CAGhD"}

package/dist/unstable/cluster/SingletonAddress.js

@@ -1,4 +1,18 @@
 /**
+ * The `SingletonAddress` module defines the address used by cluster sharding to
+ * identify a registered singleton. A singleton address combines the singleton
+ * name with the `ShardId` that owns it, giving the runtime a stable key for
+ * registration events, equality checks, hashing, and runner-local fiber
+ * tracking.
+ *
+ * Use this module when observing singleton registrations or working with
+ * sharding internals that need to tell which shard currently owns a singleton.
+ * The shard id is derived from the singleton name and shard group at
+ * registration time, so changing either value changes ownership and routing.
+ * Ownership can also move as shard locks are acquired or released, so an address
+ * identifies the target shard rather than guaranteeing that a particular runner
+ * is currently executing the singleton.
+ *
  * @since 4.0.0
  */
 import * as Equal from "../../Equal.js";
@@ -9,24 +23,30 @@ const TypeId = "~effect/cluster/SingletonAddress";
 /**
  * Represents the unique address of an singleton within the cluster.
  *
- * @since 4.0.0
  * @category Address
+ * @since 4.0.0
  */
 export class SingletonAddress extends /*#__PURE__*/Schema.Class(TypeId)({
   shardId: ShardId,
   name: Schema.String
 }) {
   /**
+   * Marks this value as a cluster singleton address for runtime guards.
+   *
    * @since 4.0.0
    */
   [TypeId] = TypeId;
   /**
+   * Computes a structural hash from the singleton name and shard id.
+   *
    * @since 4.0.0
    */
   [Hash.symbol]() {
     return Hash.string(`${this.name}:${this.shardId.toString()}`);
   }
   /**
+   * Compares singleton addresses by name and shard id.
+   *
    * @since 4.0.0
    */
   [Equal.symbol](that) {

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

@@ -1 +1 @@
-{"version":3,"file":"SingletonAddress.js","names":["Equal","Hash","Schema","ShardId","TypeId","SingletonAddress","Class","shardId","name","String","symbol","string","toString","that","equals"],"sources":["../../../src/unstable/cluster/SingletonAddress.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAGA,OAAO,KAAKA,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,IAAI,MAAM,eAAe;AACrC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,SAASC,OAAO,QAAQ,cAAc;AAEtC,MAAMC,MAAM,GAAG,kCAAkC;AAEjD;;;;;;AAMA,OAAM,MAAOC,gBAAiB,sBAAQH,MAAM,CAACI,KAAK,CAAmBF,MAAM,CAAC,CAAC;EAC3EG,OAAO,EAAEJ,OAAO;EAChBK,IAAI,EAAEN,MAAM,CAACO;CACd,CAAC;EACA;;;EAGS,CAACL,MAAM,IAAIA,MAAM;EAC1B;;;EAGA,CAACH,IAAI,CAACS,MAAM,IAAC;IACX,OAAOT,IAAI,CAACU,MAAM,CAAC,GAAG,IAAI,CAACH,IAAI,IAAI,IAAI,CAACD,OAAO,CAACK,QAAQ,EAAE,EAAE,CAAC;EAC/D;EACA;;;EAGA,CAACZ,KAAK,CAACU,MAAM,EAAEG,IAAsB;IACnC,OAAO,IAAI,CAACL,IAAI,KAAKK,IAAI,CAACL,IAAI,IAAIR,KAAK,CAACc,MAAM,CAAC,IAAI,CAACP,OAAO,EAAEM,IAAI,CAACN,OAAO,CAAC;EAC5E","ignoreList":[]}
+{"version":3,"file":"SingletonAddress.js","names":["Equal","Hash","Schema","ShardId","TypeId","SingletonAddress","Class","shardId","name","String","symbol","string","toString","that","equals"],"sources":["../../../src/unstable/cluster/SingletonAddress.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;AAiBA,OAAO,KAAKA,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,IAAI,MAAM,eAAe;AACrC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,SAASC,OAAO,QAAQ,cAAc;AAEtC,MAAMC,MAAM,GAAG,kCAAkC;AAEjD;;;;;;AAMA,OAAM,MAAOC,gBAAiB,sBAAQH,MAAM,CAACI,KAAK,CAAmBF,MAAM,CAAC,CAAC;EAC3EG,OAAO,EAAEJ,OAAO;EAChBK,IAAI,EAAEN,MAAM,CAACO;CACd,CAAC;EACA;;;;;EAKS,CAACL,MAAM,IAAIA,MAAM;EAC1B;;;;;EAKA,CAACH,IAAI,CAACS,MAAM,IAAC;IACX,OAAOT,IAAI,CAACU,MAAM,CAAC,GAAG,IAAI,CAACH,IAAI,IAAI,IAAI,CAACD,OAAO,CAACK,QAAQ,EAAE,EAAE,CAAC;EAC/D;EACA;;;;;EAKA,CAACZ,KAAK,CAACU,MAAM,EAAEG,IAAsB;IACnC,OAAO,IAAI,CAACL,IAAI,KAAKK,IAAI,CAACL,IAAI,IAAIR,KAAK,CAACc,MAAM,CAAC,IAAI,CAACP,OAAO,EAAEM,IAAI,CAACN,OAAO,CAAC;EAC5E","ignoreList":[]}