effect 4.0.0-beta.70 → 4.0.0-beta.71

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

@@ -1,27 +1,41 @@
 /**
- * The `Runner` module defines the membership record used by the unstable
- * cluster runtime to describe a process that can host entity shards.
+ * Cluster runner metadata for processes that can host entity shards.
  *
- * A runner combines the network address used by other runners to reach it, the
- * shard groups it participates in, and a relative weight used when the sharding
- * service assigns shards across the healthy runners in each group.
+ * A {@link Runner} combines the stable {@link RunnerAddress} used to contact a
+ * process, the shard groups that process participates in, and the relative
+ * weight used when the sharding service distributes shards across healthy
+ * runners.
+ *
+ * **Mental model**
+ *
+ * `Runner` is cluster membership data, not a running process handle. The value
+ * is persisted, exchanged, encoded, and compared by cluster services so they can
+ * decide where entity shards may live. The address identifies the runner, groups
+ * limit the shard pools it can join, and weight changes how much ownership it
+ * receives relative to the other healthy runners in the same group.
  *
  * **Common tasks**
  *
- * - Construct the runner registered by the local `Sharding` layer
- * - Persist or exchange runner metadata through `RunnerStorage`
- * - Encode and decode runner values at cluster transport or storage boundaries
+ * - Construct runner metadata with {@link make}.
+ * - Encode and decode runner values at cluster transport or storage boundaries.
+ * - Persist or exchange runner records through cluster runner storage.
  * - Tune shard distribution by adjusting the runner's group membership and
- *   relative weight
+ *   relative weight.
  *
  * **Gotchas**
  *
  * - Runner addresses must be stable and unique while a runner is registered,
  *   because they identify the owner used for routing and shard locks.
- * - Weights are relative within each shard group; changing weights or groups can
- *   rebalance shard ownership as the cluster refreshes its runner view.
- * - Runner equality and hashing are based on address and weight, so compare
- *   `groups` explicitly when group membership is the important distinction.
+ * - Weights are relative inside each shard group; changing a weight or group can
+ *   rebalance shard ownership when the cluster refreshes its runner view.
+ * - Equality and hashing use address and weight. Compare `groups` explicitly
+ *   when group membership is the important distinction.
+ *
+ * **See also**
+ *
+ * - {@link Runner}
+ * - {@link RunnerAddress}
+ * - {@link make}
  *
  * @since 4.0.0
  */
@@ -101,6 +115,25 @@ export declare class Runner extends Runner_base {
  * Constructs a `Runner` from its network address, shard groups, and relative
  * shard-assignment weight.
  *
+ * **When to use**
+ *
+ * Use to build runner metadata from an existing `RunnerAddress`, shard groups,
+ * and relative weight when registering or exchanging a cluster runner.
+ *
+ * **Details**
+ *
+ * The `groups` array lists the shard groups the runner can host. During shard
+ * assignment, the runner's address is added to each group's hash ring with
+ * `weight` as its relative weight.
+ *
+ * **Gotchas**
+ *
+ * This helper constructs the value without runtime schema validation, so only
+ * pass trusted `RunnerAddress`, `groups`, and `weight` values.
+ *
+ * @see {@link Runner} for the value created by this helper
+ * @see {@link RunnerAddress} for the network address accepted in `props.address`
+ *
  * @category constructors
  * @since 4.0.0
  */

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

@@ -1 +1 @@
-{"version":3,"file":"Runner.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/Runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,eAAe,CAAA;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,QAAA,MAAM,MAAM,2BAA2B,CAAA;;;;;;AAEvC;;;;;;;;;;GAUG;AACH,qBAAa,MAAO,SAAQ,WAI1B;IACA;;;;OAIG;IACH,MAAM,CAAC,MAAM,yDAA2B;IAExC;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,4BAAS;IAE1B;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,iFAAmD;IAE7E;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,iFAAmD;IAE7E;;;;OAIG;IACM,QAAQ,IAAI,MAAM;IAI3B;;;;OAIG;IACH,CAAC,iBAAiB,CAAC,IAAI,MAAM;IAI7B;;;;OAIG;IACH,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC;;;;OAIG;IACH,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,MAAM;CAGxB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,GAAI,OAAO;IAC1B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB,KAAG,MAAoD,CAAA"}
+{"version":3,"file":"Runner.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/Runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,eAAe,CAAA;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,QAAA,MAAM,MAAM,2BAA2B,CAAA;;;;;;AAEvC;;;;;;;;;;GAUG;AACH,qBAAa,MAAO,SAAQ,WAI1B;IACA;;;;OAIG;IACH,MAAM,CAAC,MAAM,yDAA2B;IAExC;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,4BAAS;IAE1B;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,iFAAmD;IAE7E;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,iFAAmD;IAE7E;;;;OAIG;IACM,QAAQ,IAAI,MAAM;IAI3B;;;;OAIG;IACH,CAAC,iBAAiB,CAAC,IAAI,MAAM;IAI7B;;;;OAIG;IACH,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC;;;;OAIG;IACH,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,MAAM;CAGxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,IAAI,GAAI,OAAO;IAC1B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB,KAAG,MAAoD,CAAA"}

package/dist/unstable/cluster/Runner.js

@@ -1,27 +1,41 @@
 /**
- * The `Runner` module defines the membership record used by the unstable
- * cluster runtime to describe a process that can host entity shards.
+ * Cluster runner metadata for processes that can host entity shards.
  *
- * A runner combines the network address used by other runners to reach it, the
- * shard groups it participates in, and a relative weight used when the sharding
- * service assigns shards across the healthy runners in each group.
+ * A {@link Runner} combines the stable {@link RunnerAddress} used to contact a
+ * process, the shard groups that process participates in, and the relative
+ * weight used when the sharding service distributes shards across healthy
+ * runners.
+ *
+ * **Mental model**
+ *
+ * `Runner` is cluster membership data, not a running process handle. The value
+ * is persisted, exchanged, encoded, and compared by cluster services so they can
+ * decide where entity shards may live. The address identifies the runner, groups
+ * limit the shard pools it can join, and weight changes how much ownership it
+ * receives relative to the other healthy runners in the same group.
  *
  * **Common tasks**
  *
- * - Construct the runner registered by the local `Sharding` layer
- * - Persist or exchange runner metadata through `RunnerStorage`
- * - Encode and decode runner values at cluster transport or storage boundaries
+ * - Construct runner metadata with {@link make}.
+ * - Encode and decode runner values at cluster transport or storage boundaries.
+ * - Persist or exchange runner records through cluster runner storage.
  * - Tune shard distribution by adjusting the runner's group membership and
- *   relative weight
+ *   relative weight.
  *
  * **Gotchas**
  *
  * - Runner addresses must be stable and unique while a runner is registered,
  *   because they identify the owner used for routing and shard locks.
- * - Weights are relative within each shard group; changing weights or groups can
- *   rebalance shard ownership as the cluster refreshes its runner view.
- * - Runner equality and hashing are based on address and weight, so compare
- *   `groups` explicitly when group membership is the important distinction.
+ * - Weights are relative inside each shard group; changing a weight or group can
+ *   rebalance shard ownership when the cluster refreshes its runner view.
+ * - Equality and hashing use address and weight. Compare `groups` explicitly
+ *   when group membership is the important distinction.
+ *
+ * **See also**
+ *
+ * - {@link Runner}
+ * - {@link RunnerAddress}
+ * - {@link make}
  *
  * @since 4.0.0
  */
@@ -108,6 +122,25 @@ export class Runner extends /*#__PURE__*/Schema.Class(TypeId)({
  * Constructs a `Runner` from its network address, shard groups, and relative
  * shard-assignment weight.
  *
+ * **When to use**
+ *
+ * Use to build runner metadata from an existing `RunnerAddress`, shard groups,
+ * and relative weight when registering or exchanging a cluster runner.
+ *
+ * **Details**
+ *
+ * The `groups` array lists the shard groups the runner can host. During shard
+ * assignment, the runner's address is added to each group's hash ring with
+ * `weight` as its relative weight.
+ *
+ * **Gotchas**
+ *
+ * This helper constructs the value without runtime schema validation, so only
+ * pass trusted `RunnerAddress`, `groups`, and `weight` values.
+ *
+ * @see {@link Runner} for the value created by this helper
+ * @see {@link RunnerAddress} for the network address accepted in `props.address`
+ *
  * @category constructors
  * @since 4.0.0
  */

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

@@ -1 +1 @@
-{"version":3,"file":"Runner.js","names":["Equal","Hash","NodeInspectSymbol","Schema","RunnerAddress","TypeId","Runner","Class","address","groups","Array","String","weight","Number","format","toFormatter","decodeSync","fromJsonString","encodeSync","toString","symbol","that","string","make","props","disableChecks"],"sources":["../../../src/unstable/cluster/Runner.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,OAAO,KAAKA,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,IAAI,MAAM,eAAe;AACrC,SAASC,iBAAiB,QAAQ,sBAAsB;AACxD,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,SAASC,aAAa,QAAQ,oBAAoB;AAElD,MAAMC,MAAM,GAAG,wBAAwB;AAEvC;;;;;;;;;;;AAWA,OAAM,MAAOC,MAAO,sBAAQH,MAAM,CAACI,KAAK,CAASF,MAAM,CAAC,CAAC;EACvDG,OAAO,EAAEJ,aAAa;EACtBK,MAAM,eAAEN,MAAM,CAACO,KAAK,CAACP,MAAM,CAACQ,MAAM,CAAC;EACnCC,MAAM,EAAET,MAAM,CAACU;CAChB,CAAC;EACA;;;;;EAKA,OAAOC,MAAM,gBAAGX,MAAM,CAACY,WAAW,CAAC,IAAI,CAAC;EAExC;;;;;EAKS,CAACV,MAAM,IAAIA,MAAM;EAE1B;;;;;EAKA,OAAgBW,UAAU,gBAAGb,MAAM,CAACa,UAAU,cAACb,MAAM,CAACc,cAAc,CAACX,MAAM,CAAC,CAAC;EAE7E;;;;;EAKA,OAAgBY,UAAU,gBAAGf,MAAM,CAACe,UAAU,cAACf,MAAM,CAACc,cAAc,CAACX,MAAM,CAAC,CAAC;EAE7E;;;;;EAKSa,QAAQA,CAAA;IACf,OAAOb,MAAM,CAACQ,MAAM,CAAC,IAAI,CAAC;EAC5B;EAEA;;;;;EAKA,CAACZ,iBAAiB,IAAC;IACjB,OAAO,IAAI,CAACiB,QAAQ,EAAE;EACxB;EAEA;;;;;EAKA,CAACnB,KAAK,CAACoB,MAAM,EAAEC,IAAY;IACzB,OAAO,IAAI,CAACb,OAAO,CAACR,KAAK,CAACoB,MAAM,CAAC,CAACC,IAAI,CAACb,OAAO,CAAC,IAAI,IAAI,CAACI,MAAM,KAAKS,IAAI,CAACT,MAAM;EAChF;EAEA;;;;;EAKA,CAACX,IAAI,CAACmB,MAAM,IAAC;IACX,OAAOnB,IAAI,CAACqB,MAAM,CAAC,GAAG,IAAI,CAACd,OAAO,CAACW,QAAQ,EAAE,IAAI,IAAI,CAACP,MAAM,EAAE,CAAC;EACjE;;AAGF;;;;;;;AAOA,OAAO,MAAMW,IAAI,GAAIC,KAIpB,IAAa,IAAIlB,MAAM,CAACkB,KAAK,EAAE;EAAEC,aAAa,EAAE;AAAI,CAAE,CAAC","ignoreList":[]}
+{"version":3,"file":"Runner.js","names":["Equal","Hash","NodeInspectSymbol","Schema","RunnerAddress","TypeId","Runner","Class","address","groups","Array","String","weight","Number","format","toFormatter","decodeSync","fromJsonString","encodeSync","toString","symbol","that","string","make","props","disableChecks"],"sources":["../../../src/unstable/cluster/Runner.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,OAAO,KAAKA,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,IAAI,MAAM,eAAe;AACrC,SAASC,iBAAiB,QAAQ,sBAAsB;AACxD,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,SAASC,aAAa,QAAQ,oBAAoB;AAElD,MAAMC,MAAM,GAAG,wBAAwB;AAEvC;;;;;;;;;;;AAWA,OAAM,MAAOC,MAAO,sBAAQH,MAAM,CAACI,KAAK,CAASF,MAAM,CAAC,CAAC;EACvDG,OAAO,EAAEJ,aAAa;EACtBK,MAAM,eAAEN,MAAM,CAACO,KAAK,CAACP,MAAM,CAACQ,MAAM,CAAC;EACnCC,MAAM,EAAET,MAAM,CAACU;CAChB,CAAC;EACA;;;;;EAKA,OAAOC,MAAM,gBAAGX,MAAM,CAACY,WAAW,CAAC,IAAI,CAAC;EAExC;;;;;EAKS,CAACV,MAAM,IAAIA,MAAM;EAE1B;;;;;EAKA,OAAgBW,UAAU,gBAAGb,MAAM,CAACa,UAAU,cAACb,MAAM,CAACc,cAAc,CAACX,MAAM,CAAC,CAAC;EAE7E;;;;;EAKA,OAAgBY,UAAU,gBAAGf,MAAM,CAACe,UAAU,cAACf,MAAM,CAACc,cAAc,CAACX,MAAM,CAAC,CAAC;EAE7E;;;;;EAKSa,QAAQA,CAAA;IACf,OAAOb,MAAM,CAACQ,MAAM,CAAC,IAAI,CAAC;EAC5B;EAEA;;;;;EAKA,CAACZ,iBAAiB,IAAC;IACjB,OAAO,IAAI,CAACiB,QAAQ,EAAE;EACxB;EAEA;;;;;EAKA,CAACnB,KAAK,CAACoB,MAAM,EAAEC,IAAY;IACzB,OAAO,IAAI,CAACb,OAAO,CAACR,KAAK,CAACoB,MAAM,CAAC,CAACC,IAAI,CAACb,OAAO,CAAC,IAAI,IAAI,CAACI,MAAM,KAAKS,IAAI,CAACT,MAAM;EAChF;EAEA;;;;;EAKA,CAACX,IAAI,CAACmB,MAAM,IAAC;IACX,OAAOnB,IAAI,CAACqB,MAAM,CAAC,GAAG,IAAI,CAACd,OAAO,CAACW,QAAQ,EAAE,IAAI,IAAI,CAACP,MAAM,EAAE,CAAC;EACjE;;AAGF;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,OAAO,MAAMW,IAAI,GAAIC,KAIpB,IAAa,IAAIlB,MAAM,CAACkB,KAAK,EAAE;EAAEC,aAAa,EAAE;AAAI,CAAE,CAAC","ignoreList":[]}

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

@@ -1,19 +1,36 @@
 /**
- * The `RunnerAddress` module defines the network identity used to locate a
- * cluster runner. A runner address is a host and port pair that can be encoded,
- * compared, hashed, inspected, and used as a stable primary key.
+ * The `RunnerAddress` module defines the stable network identity used to locate
+ * a cluster runner. A runner address is a host and port pair that can be
+ * encoded with its schema, compared structurally, hashed, inspected, and used as
+ * a primary key in runner registries and shard ownership data.
  *
- * **Common use cases**
+ * **Mental model**
  *
- * - Representing the target runner for cluster routing and placement decisions
- * - Persisting or exchanging runner endpoints through schemas
- * - Using runner endpoints as keys in maps, registries, or shard ownership data
+ * `RunnerAddress` is identity data, not connection configuration. Equality,
+ * hashing, and the primary key all use the host and port exactly as supplied,
+ * so callers should normalize host names before constructing the value when the
+ * surrounding routing layer requires a canonical form.
+ *
+ * **Common tasks**
+ *
+ * - Build runner endpoints with {@link make}.
+ * - Persist or exchange runner endpoints through the {@link RunnerAddress}
+ *   schema.
+ * - Use addresses as stable keys in runner maps, registries, and shard ownership
+ *   records.
  *
  * **Gotchas**
  *
- * - Identity is structural: two addresses are equal when both host and port match
+ * - Identity is structural: two addresses are equal only when both host and port
+ *   match.
  * - The primary key is formatted as `host:port`, so host strings should already
- *   be normalized for the routing layer using them
+ *   be normalized for the routing layer using them.
+ * - The constructor does not check whether the endpoint is reachable.
+ *
+ * **See also**
+ *
+ * - {@link RunnerAddress}
+ * - {@link make}
  *
  * @since 4.0.0
  */
@@ -74,6 +91,25 @@ export declare class RunnerAddress extends RunnerAddress_base {
 /**
  * Constructs a `RunnerAddress` from a host and port.
  *
+ * **When to use**
+ *
+ * Use to create the stable network identity for a cluster runner when
+ * configuring sharding, registering runner metadata, or targeting a runner by
+ * host and port.
+ *
+ * **Details**
+ *
+ * The returned `RunnerAddress` stores the supplied `host` and `port`. Equality,
+ * hashing, and the primary key use both fields, with the primary key formatted
+ * as `host:port`.
+ *
+ * **Gotchas**
+ *
+ * `make` does not normalize the host. Pass the host string exactly as the
+ * cluster routing and storage layers should identify it.
+ *
+ * @see {@link RunnerAddress} for the constructed address type and its equality, hashing, primary-key, and formatting behavior
+ *
  * @category constructors
  * @since 4.0.0
  */

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

@@ -1 +1 @@
-{"version":3,"file":"RunnerAddress.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/RunnerAddress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,eAAe,CAAA;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,UAAU,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,QAAA,MAAM,MAAM,kCAAkC,CAAA;;;;;AAE9C;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,kBAGjC;IACA;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,mCAAU;IAE3B;;;;OAIG;IACH,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO;IAI5C;;;;OAIG;IACH,CAAC,IAAI,CAAC,MAAM,CAAC;IAIb;;;;OAIG;IACH,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,MAAM;IAI7B;;;;OAIG;IACM,QAAQ,IAAI,MAAM;IAI3B;;;;OAIG;IACH,CAAC,iBAAiB,CAAC,IAAI,MAAM;CAG9B;AAED;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,aACU,CAAA"}
+{"version":3,"file":"RunnerAddress.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/RunnerAddress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,eAAe,CAAA;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,UAAU,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,QAAA,MAAM,MAAM,kCAAkC,CAAA;;;;;AAE9C;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,kBAGjC;IACA;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,mCAAU;IAE3B;;;;OAIG;IACH,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO;IAI5C;;;;OAIG;IACH,CAAC,IAAI,CAAC,MAAM,CAAC;IAIb;;;;OAIG;IACH,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,MAAM;IAI7B;;;;OAIG;IACM,QAAQ,IAAI,MAAM;IAI3B;;;;OAIG;IACH,CAAC,iBAAiB,CAAC,IAAI,MAAM;CAG9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,aACU,CAAA"}

package/dist/unstable/cluster/RunnerAddress.js

@@ -1,19 +1,36 @@
 /**
- * The `RunnerAddress` module defines the network identity used to locate a
- * cluster runner. A runner address is a host and port pair that can be encoded,
- * compared, hashed, inspected, and used as a stable primary key.
+ * The `RunnerAddress` module defines the stable network identity used to locate
+ * a cluster runner. A runner address is a host and port pair that can be
+ * encoded with its schema, compared structurally, hashed, inspected, and used as
+ * a primary key in runner registries and shard ownership data.
  *
- * **Common use cases**
+ * **Mental model**
  *
- * - Representing the target runner for cluster routing and placement decisions
- * - Persisting or exchanging runner endpoints through schemas
- * - Using runner endpoints as keys in maps, registries, or shard ownership data
+ * `RunnerAddress` is identity data, not connection configuration. Equality,
+ * hashing, and the primary key all use the host and port exactly as supplied,
+ * so callers should normalize host names before constructing the value when the
+ * surrounding routing layer requires a canonical form.
+ *
+ * **Common tasks**
+ *
+ * - Build runner endpoints with {@link make}.
+ * - Persist or exchange runner endpoints through the {@link RunnerAddress}
+ *   schema.
+ * - Use addresses as stable keys in runner maps, registries, and shard ownership
+ *   records.
  *
  * **Gotchas**
  *
- * - Identity is structural: two addresses are equal when both host and port match
+ * - Identity is structural: two addresses are equal only when both host and port
+ *   match.
  * - The primary key is formatted as `host:port`, so host strings should already
- *   be normalized for the routing layer using them
+ *   be normalized for the routing layer using them.
+ * - The constructor does not check whether the endpoint is reachable.
+ *
+ * **See also**
+ *
+ * - {@link RunnerAddress}
+ * - {@link make}
  *
  * @since 4.0.0
  */
@@ -83,6 +100,25 @@ export class RunnerAddress extends /*#__PURE__*/Schema.Class(TypeId)({
 /**
  * Constructs a `RunnerAddress` from a host and port.
  *
+ * **When to use**
+ *
+ * Use to create the stable network identity for a cluster runner when
+ * configuring sharding, registering runner metadata, or targeting a runner by
+ * host and port.
+ *
+ * **Details**
+ *
+ * The returned `RunnerAddress` stores the supplied `host` and `port`. Equality,
+ * hashing, and the primary key use both fields, with the primary key formatted
+ * as `host:port`.
+ *
+ * **Gotchas**
+ *
+ * `make` does not normalize the host. Pass the host string exactly as the
+ * cluster routing and storage layers should identify it.
+ *
+ * @see {@link RunnerAddress} for the constructed address type and its equality, hashing, primary-key, and formatting behavior
+ *
  * @category constructors
  * @since 4.0.0
  */

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

@@ -1 +1 @@
-{"version":3,"file":"RunnerAddress.js","names":["Equal","Hash","NodeInspectSymbol","PrimaryKey","Schema","TypeId","RunnerAddress","Class","host","String","port","Number","symbol","that","string","toString","make","disableChecks"],"sources":["../../../src/unstable/cluster/RunnerAddress.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;AAmBA,OAAO,KAAKA,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,IAAI,MAAM,eAAe;AACrC,SAASC,iBAAiB,QAAQ,sBAAsB;AACxD,OAAO,KAAKC,UAAU,MAAM,qBAAqB;AACjD,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AAEzC,MAAMC,MAAM,GAAG,+BAA+B;AAE9C;;;;;;AAMA,OAAM,MAAOC,aAAc,sBAAQF,MAAM,CAACG,KAAK,CAAgBF,MAAM,CAAC,CAAC;EACrEG,IAAI,EAAEJ,MAAM,CAACK,MAAM;EACnBC,IAAI,EAAEN,MAAM,CAACO;CACd,CAAC;EACA;;;;;EAKS,CAACN,MAAM,IAAIA,MAAM;EAE1B;;;;;EAKA,CAACL,KAAK,CAACY,MAAM,EAAEC,IAAmB;IAChC,OAAO,IAAI,CAACL,IAAI,KAAKK,IAAI,CAACL,IAAI,IAAI,IAAI,CAACE,IAAI,KAAKG,IAAI,CAACH,IAAI;EAC3D;EAEA;;;;;EAKA,CAACT,IAAI,CAACW,MAAM,IAAC;IACX,OAAOX,IAAI,CAACa,MAAM,CAAC,GAAG,IAAI,CAACN,IAAI,IAAI,IAAI,CAACE,IAAI,EAAE,CAAC;EACjD;EAEA;;;;;EAKA,CAACP,UAAU,CAACS,MAAM,IAAC;IACjB,OAAO,GAAG,IAAI,CAACJ,IAAI,IAAI,IAAI,CAACE,IAAI,EAAE;EACpC;EAEA;;;;;EAKSK,QAAQA,CAAA;IACf,OAAO,iBAAiB,IAAI,CAACP,IAAI,IAAI,IAAI,CAACE,IAAI,GAAG;EACnD;EAEA;;;;;EAKA,CAACR,iBAAiB,IAAC;IACjB,OAAO,IAAI,CAACa,QAAQ,EAAE;EACxB;;AAGF;;;;;;AAMA,OAAO,MAAMC,IAAI,GAAGA,CAACR,IAAY,EAAEE,IAAY,KAC7C,IAAIJ,aAAa,CAAC;EAAEE,IAAI;EAAEE;AAAI,CAAE,EAAE;EAAEO,aAAa,EAAE;AAAI,CAAE,CAAC","ignoreList":[]}
+{"version":3,"file":"RunnerAddress.js","names":["Equal","Hash","NodeInspectSymbol","PrimaryKey","Schema","TypeId","RunnerAddress","Class","host","String","port","Number","symbol","that","string","toString","make","disableChecks"],"sources":["../../../src/unstable/cluster/RunnerAddress.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,OAAO,KAAKA,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,IAAI,MAAM,eAAe;AACrC,SAASC,iBAAiB,QAAQ,sBAAsB;AACxD,OAAO,KAAKC,UAAU,MAAM,qBAAqB;AACjD,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AAEzC,MAAMC,MAAM,GAAG,+BAA+B;AAE9C;;;;;;AAMA,OAAM,MAAOC,aAAc,sBAAQF,MAAM,CAACG,KAAK,CAAgBF,MAAM,CAAC,CAAC;EACrEG,IAAI,EAAEJ,MAAM,CAACK,MAAM;EACnBC,IAAI,EAAEN,MAAM,CAACO;CACd,CAAC;EACA;;;;;EAKS,CAACN,MAAM,IAAIA,MAAM;EAE1B;;;;;EAKA,CAACL,KAAK,CAACY,MAAM,EAAEC,IAAmB;IAChC,OAAO,IAAI,CAACL,IAAI,KAAKK,IAAI,CAACL,IAAI,IAAI,IAAI,CAACE,IAAI,KAAKG,IAAI,CAACH,IAAI;EAC3D;EAEA;;;;;EAKA,CAACT,IAAI,CAACW,MAAM,IAAC;IACX,OAAOX,IAAI,CAACa,MAAM,CAAC,GAAG,IAAI,CAACN,IAAI,IAAI,IAAI,CAACE,IAAI,EAAE,CAAC;EACjD;EAEA;;;;;EAKA,CAACP,UAAU,CAACS,MAAM,IAAC;IACjB,OAAO,GAAG,IAAI,CAACJ,IAAI,IAAI,IAAI,CAACE,IAAI,EAAE;EACpC;EAEA;;;;;EAKSK,QAAQA,CAAA;IACf,OAAO,iBAAiB,IAAI,CAACP,IAAI,IAAI,IAAI,CAACE,IAAI,GAAG;EACnD;EAEA;;;;;EAKA,CAACR,iBAAiB,IAAC;IACjB,OAAO,IAAI,CAACa,QAAQ,EAAE;EACxB;;AAGF;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,OAAO,MAAMC,IAAI,GAAGA,CAACR,IAAY,EAAEE,IAAY,KAC7C,IAAIJ,aAAa,CAAC;EAAEE,IAAI;EAAEE;AAAI,CAAE,EAAE;EAAEO,aAAa,EAAE;AAAI,CAAE,CAAC","ignoreList":[]}

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

@@ -1,23 +1,40 @@
 /**
- * The `RunnerHealth` module defines the health-check service used by cluster
- * sharding to decide whether a runner may still own its assigned shards. A
- * runner that is reported as alive is allowed to keep processing messages,
- * while a runner that is reported as unavailable can have its shards moved to
- * another runner.
+ * The `RunnerHealth` module defines the health-check service used by the
+ * unstable cluster runtime when deciding whether a runner can keep ownership of
+ * its assigned shards. The service answers whether a runner address is alive
+ * enough for sharding to keep routing work to it.
+ *
+ * **Mental model**
+ *
+ * Runner health feeds placement decisions, not process supervision. A healthy
+ * result lets the current runner continue serving its entities, while an
+ * unhealthy result allows sharding to move those shards to another runner. Keep
+ * checks conservative: a runner reported as unavailable may still be finishing
+ * in-flight messages.
  *
  * **Common tasks**
  *
- * - Provide a custom {@link RunnerHealth} service for a cluster deployment
- * - Use {@link layerPing} to check runners through the cluster runner protocol
- * - Use {@link layerK8s} when Kubernetes pod readiness should drive health
- * - Use {@link layerNoop} in tests or environments where runners are always considered healthy
+ * - Provide a custom {@link RunnerHealth} service for deployment-specific
+ *   failure detection.
+ * - Use {@link layerPing} to check runners through the cluster runner protocol.
+ * - Use {@link layerK8s} when Kubernetes pod readiness should drive runner
+ *   health.
+ * - Use {@link layerNoop} in tests or single-runner environments where every
+ *   runner should be treated as healthy.
  *
  * **Gotchas**
  *
- * - Health checks affect shard reassignment, so false negatives can move shards
- *   away from runners that may still be processing messages
+ * - False negatives can trigger shard reassignment away from runners that are
+ *   still processing messages.
  * - The Kubernetes implementation treats API failures as healthy to avoid
- *   reassignment caused by a temporary control-plane outage
+ *   reassignment caused by a temporary control-plane outage.
+ * - {@link layerNoop} disables failure detection for this decision point, so it
+ *   should only be used when that tradeoff is intentional.
+ *
+ * **See also**
+ *
+ * - {@link RunnerHealth}
+ * - {@link layerPing}, {@link layerK8s}, and {@link layerNoop}
  *
  * @since 4.0.0
  */
@@ -50,7 +67,7 @@ export declare class RunnerHealth extends RunnerHealth_base {
  *
  * **When to use**
  *
- * This is useful for testing.
+ * Use when this is useful for testing.
  *
  * @category layers
  * @since 4.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"RunnerHealth.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/RunnerHealth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAEvC,OAAO,KAAK,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,GAAG,MAAM,oBAAoB,CAAA;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;;sBAiBjB,CAAC,OAAO,EAAE,aAAa,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;;AAfxE;;;;;;;;;;;GAWG;AACH,qBAAa,YAAa,SAAQ,iBAKA;CAAG;AAErC;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,yCAEpB,CAAA;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,CAClC,YAAY,CAAC,SAAS,CAAC,EACvB,KAAK,EACL,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC,KAAK,CAc7B,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,KAAK,CACjC,YAAY,EACZ,KAAK,EACL,OAAO,CAAC,OAAO,CACuB,CAAA;AAExC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO;yBACG,MAAM,GAAG,SAAS;6BACd,MAAM,GAAG,SAAS;;sBAtEvB,CAAC,OAAO,EAAE,aAAa,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;4BAiFtE,CAAA;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,QAAQ,GACnB,UAAU;IACR,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5C,GAAG,SAAS,KACZ,KAAK,CAAC,KAAK,CACZ,YAAY,EACZ,KAAK,EACL,GAAG,CAAC,aAAa,CAC8B,CAAA"}
+{"version":3,"file":"RunnerHealth.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/RunnerHealth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAEvC,OAAO,KAAK,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,GAAG,MAAM,oBAAoB,CAAA;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;;sBAiBjB,CAAC,OAAO,EAAE,aAAa,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;;AAfxE;;;;;;;;;;;GAWG;AACH,qBAAa,YAAa,SAAQ,iBAKA;CAAG;AAErC;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,yCAEpB,CAAA;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,CAClC,YAAY,CAAC,SAAS,CAAC,EACvB,KAAK,EACL,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC,KAAK,CAc7B,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,KAAK,CACjC,YAAY,EACZ,KAAK,EACL,OAAO,CAAC,OAAO,CACuB,CAAA;AAExC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO;yBACG,MAAM,GAAG,SAAS;6BACd,MAAM,GAAG,SAAS;;sBAtEvB,CAAC,OAAO,EAAE,aAAa,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;4BAiFtE,CAAA;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,QAAQ,GACnB,UAAU;IACR,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5C,GAAG,SAAS,KACZ,KAAK,CAAC,KAAK,CACZ,YAAY,EACZ,KAAK,EACL,GAAG,CAAC,aAAa,CAC8B,CAAA"}

package/dist/unstable/cluster/RunnerHealth.js

@@ -1,23 +1,40 @@
 /**
- * The `RunnerHealth` module defines the health-check service used by cluster
- * sharding to decide whether a runner may still own its assigned shards. A
- * runner that is reported as alive is allowed to keep processing messages,
- * while a runner that is reported as unavailable can have its shards moved to
- * another runner.
+ * The `RunnerHealth` module defines the health-check service used by the
+ * unstable cluster runtime when deciding whether a runner can keep ownership of
+ * its assigned shards. The service answers whether a runner address is alive
+ * enough for sharding to keep routing work to it.
+ *
+ * **Mental model**
+ *
+ * Runner health feeds placement decisions, not process supervision. A healthy
+ * result lets the current runner continue serving its entities, while an
+ * unhealthy result allows sharding to move those shards to another runner. Keep
+ * checks conservative: a runner reported as unavailable may still be finishing
+ * in-flight messages.
  *
  * **Common tasks**
  *
- * - Provide a custom {@link RunnerHealth} service for a cluster deployment
- * - Use {@link layerPing} to check runners through the cluster runner protocol
- * - Use {@link layerK8s} when Kubernetes pod readiness should drive health
- * - Use {@link layerNoop} in tests or environments where runners are always considered healthy
+ * - Provide a custom {@link RunnerHealth} service for deployment-specific
+ *   failure detection.
+ * - Use {@link layerPing} to check runners through the cluster runner protocol.
+ * - Use {@link layerK8s} when Kubernetes pod readiness should drive runner
+ *   health.
+ * - Use {@link layerNoop} in tests or single-runner environments where every
+ *   runner should be treated as healthy.
  *
  * **Gotchas**
  *
- * - Health checks affect shard reassignment, so false negatives can move shards
- *   away from runners that may still be processing messages
+ * - False negatives can trigger shard reassignment away from runners that are
+ *   still processing messages.
  * - The Kubernetes implementation treats API failures as healthy to avoid
- *   reassignment caused by a temporary control-plane outage
+ *   reassignment caused by a temporary control-plane outage.
+ * - {@link layerNoop} disables failure detection for this decision point, so it
+ *   should only be used when that tradeoff is intentional.
+ *
+ * **See also**
+ *
+ * - {@link RunnerHealth}
+ * - {@link layerPing}, {@link layerK8s}, and {@link layerNoop}
  *
  * @since 4.0.0
  */
@@ -45,7 +62,7 @@ export class RunnerHealth extends /*#__PURE__*/Context.Service()("effect/cluster
  *
  * **When to use**
  *
- * This is useful for testing.
+ * Use when this is useful for testing.
  *
  * @category layers
  * @since 4.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"RunnerHealth.js","names":["Context","Effect","Layer","Schedule","K8s","Runners","RunnerHealth","Service","layerNoop","succeed","isAlive","makePing","gen","runners","schedule","spaced","address","ping","pipe","timeout","retry","times","isSuccess","of","layerPing","effect","makeK8s","fnUntraced","options","allPods","makeGetPods","map","pods","get","host","isReadyOrInitializing","catchCause","layerK8s"],"sources":["../../../src/unstable/cluster/RunnerHealth.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;AAuBA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,QAAQ,MAAM,mBAAmB;AAE7C,OAAO,KAAKC,GAAG,MAAM,oBAAoB;AAEzC,OAAO,KAAKC,OAAO,MAAM,cAAc;AAEvC;;;;;;;;;;;;AAYA,OAAM,MAAOC,YAAa,sBAAQN,OAAO,CAACO,OAAO,EAK9C,CAAC,6BAA6B,CAAC;AAElC;;;;;;;;;;AAUA,OAAO,MAAMC,SAAS,gBAAGN,KAAK,CAACO,OAAO,CAACH,YAAY,EAAE;EACnDI,OAAO,EAAEA,CAAA,KAAMT,MAAM,CAACQ,OAAO,CAAC,IAAI;CACnC,CAAC;AAEF;;;;;;;;AAQA,OAAO,MAAME,QAAQ,gBAIjBV,MAAM,CAACW,GAAG,CAAC,aAAS;EACtB,MAAMC,OAAO,GAAG,OAAOR,OAAO,CAACA,OAAO;EACtC,MAAMS,QAAQ,GAAGX,QAAQ,CAACY,MAAM,CAAC,GAAG,CAAC;EAErC,SAASL,OAAOA,CAACM,OAAsB;IACrC,OAAOH,OAAO,CAACI,IAAI,CAACD,OAAO,CAAC,CAACE,IAAI,CAC/BjB,MAAM,CAACkB,OAAO,CAAC,MAAM,CAAC,EACtBlB,MAAM,CAACmB,KAAK,CAAC;MAAEC,KAAK,EAAE,CAAC;MAAEP;IAAQ,CAAE,CAAC,EACpCb,MAAM,CAACqB,SAAS,CACjB;EACH;EAEA,OAAOhB,YAAY,CAACiB,EAAE,CAAC;IAAEb;EAAO,CAAE,CAAC;AACrC,CAAC,CAAC;AAEF;;;;;;AAMA,OAAO,MAAMc,SAAS,gBAIlBtB,KAAK,CAACuB,MAAM,CAACnB,YAAY,EAAEK,QAAQ,CAAC;AAExC;;;;;;;;;;;AAWA,OAAO,MAAMe,OAAO,gBAAGzB,MAAM,CAAC0B,UAAU,CAAC,WAAUC,OAGlD;EACC,MAAMC,OAAO,GAAG,OAAOzB,GAAG,CAAC0B,WAAW,CAACF,OAAO,CAAC;EAE/C,OAAOtB,YAAY,CAACiB,EAAE,CAAC;IACrBb,OAAO,EAAGM,OAAO,IACfa,OAAO,CAACX,IAAI,CACVjB,MAAM,CAAC8B,GAAG,CAAEC,IAAI,IAAKA,IAAI,CAACC,GAAG,CAACjB,OAAO,CAACkB,IAAI,CAAC,EAAEC,qBAAqB,IAAI,KAAK,CAAC,EAC5ElC,MAAM,CAACmC,UAAU,CAAC,MAAMnC,MAAM,CAACQ,OAAO,CAAC,IAAI,CAAC,CAAC;GAElD,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;AAgBA,OAAO,MAAM4B,QAAQ,GACnBT,OAGa,IAKV1B,KAAK,CAACuB,MAAM,CAACnB,YAAY,EAAEoB,OAAO,CAACE,OAAO,CAAC,CAAC","ignoreList":[]}
+{"version":3,"file":"RunnerHealth.js","names":["Context","Effect","Layer","Schedule","K8s","Runners","RunnerHealth","Service","layerNoop","succeed","isAlive","makePing","gen","runners","schedule","spaced","address","ping","pipe","timeout","retry","times","isSuccess","of","layerPing","effect","makeK8s","fnUntraced","options","allPods","makeGetPods","map","pods","get","host","isReadyOrInitializing","catchCause","layerK8s"],"sources":["../../../src/unstable/cluster/RunnerHealth.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,QAAQ,MAAM,mBAAmB;AAE7C,OAAO,KAAKC,GAAG,MAAM,oBAAoB;AAEzC,OAAO,KAAKC,OAAO,MAAM,cAAc;AAEvC;;;;;;;;;;;;AAYA,OAAM,MAAOC,YAAa,sBAAQN,OAAO,CAACO,OAAO,EAK9C,CAAC,6BAA6B,CAAC;AAElC;;;;;;;;;;AAUA,OAAO,MAAMC,SAAS,gBAAGN,KAAK,CAACO,OAAO,CAACH,YAAY,EAAE;EACnDI,OAAO,EAAEA,CAAA,KAAMT,MAAM,CAACQ,OAAO,CAAC,IAAI;CACnC,CAAC;AAEF;;;;;;;;AAQA,OAAO,MAAME,QAAQ,gBAIjBV,MAAM,CAACW,GAAG,CAAC,aAAS;EACtB,MAAMC,OAAO,GAAG,OAAOR,OAAO,CAACA,OAAO;EACtC,MAAMS,QAAQ,GAAGX,QAAQ,CAACY,MAAM,CAAC,GAAG,CAAC;EAErC,SAASL,OAAOA,CAACM,OAAsB;IACrC,OAAOH,OAAO,CAACI,IAAI,CAACD,OAAO,CAAC,CAACE,IAAI,CAC/BjB,MAAM,CAACkB,OAAO,CAAC,MAAM,CAAC,EACtBlB,MAAM,CAACmB,KAAK,CAAC;MAAEC,KAAK,EAAE,CAAC;MAAEP;IAAQ,CAAE,CAAC,EACpCb,MAAM,CAACqB,SAAS,CACjB;EACH;EAEA,OAAOhB,YAAY,CAACiB,EAAE,CAAC;IAAEb;EAAO,CAAE,CAAC;AACrC,CAAC,CAAC;AAEF;;;;;;AAMA,OAAO,MAAMc,SAAS,gBAIlBtB,KAAK,CAACuB,MAAM,CAACnB,YAAY,EAAEK,QAAQ,CAAC;AAExC;;;;;;;;;;;AAWA,OAAO,MAAMe,OAAO,gBAAGzB,MAAM,CAAC0B,UAAU,CAAC,WAAUC,OAGlD;EACC,MAAMC,OAAO,GAAG,OAAOzB,GAAG,CAAC0B,WAAW,CAACF,OAAO,CAAC;EAE/C,OAAOtB,YAAY,CAACiB,EAAE,CAAC;IACrBb,OAAO,EAAGM,OAAO,IACfa,OAAO,CAACX,IAAI,CACVjB,MAAM,CAAC8B,GAAG,CAAEC,IAAI,IAAKA,IAAI,CAACC,GAAG,CAACjB,OAAO,CAACkB,IAAI,CAAC,EAAEC,qBAAqB,IAAI,KAAK,CAAC,EAC5ElC,MAAM,CAACmC,UAAU,CAAC,MAAMnC,MAAM,CAACQ,OAAO,CAAC,IAAI,CAAC,CAAC;GAElD,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;AAgBA,OAAO,MAAM4B,QAAQ,GACnBT,OAGa,IAKV1B,KAAK,CAACuB,MAAM,CAACnB,YAAY,EAAEoB,OAAO,CAACE,OAAO,CAAC,CAAC","ignoreList":[]}

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

@@ -19,6 +19,20 @@ export declare const layerHandlers: Layer.Layer<import("../rpc/Rpc.ts").Handler<
  * runners, forwards them to the `Sharding` layer, and responds to `Ping`
  * requests.
  *
+ * **When to use**
+ *
+ * Use when a runner process should accept runner-to-runner protocol messages
+ * over a provided server `RpcServer.Protocol`.
+ *
+ * **Gotchas**
+ *
+ * This layer does not choose or provide the wire transport; provide a
+ * transport-specific `RpcServer.Protocol` separately.
+ *
+ * @see {@link layerHandlers} for the lower-level handler layer used when the RPC server is supplied elsewhere
+ * @see {@link layerWithClients} for a runner server layer that also provides the `Sharding` and `Runners` clients
+ * @see {@link layerClientOnly} for embedding a cluster client without serving runner RPCs
+ *
  * @category layers
  * @since 4.0.0
  */
@@ -35,7 +49,7 @@ export declare const layerWithClients: Layer.Layer<Sharding.Sharding | Runners.R
  *
  * **When to use**
  *
- * Use this layer to embed a cluster client inside another Effect application
+ * Use when you use this layer to embed a cluster client inside another Effect application
  * without registering with the ShardManager or receiving shard assignments.
  *
  * @category layers

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

@@ -1 +1 @@
-{"version":3,"file":"RunnerServer.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/RunnerServer.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAGvC,OAAO,KAAK,SAAS,MAAM,qBAAqB,CAAA;AAGhD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,KAAK,aAAa,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAIpD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,kSAmGvB,CAAA;AAIH;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAC7B,KAAK,EACL,KAAK,EACL,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,GAAG,cAAc,CAAC,cAAc,CAInC,CAAA;AAErC;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,KAAK,CACxC,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,EACnC,KAAK,EACH,SAAS,CAAC,QAAQ,GAClB,cAAc,GACd,OAAO,CAAC,iBAAiB,GACzB,cAAc,CAAC,cAAc,GAC7B,aAAa,CAAC,aAAa,GAC3B,YAAY,CAAC,YAAY,CAI5B,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,KAAK,CACvC,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,EACnC,KAAK,EACH,cAAc,GACd,OAAO,CAAC,iBAAiB,GACzB,cAAc,CAAC,cAAc,GAC7B,aAAa,CAAC,aAAa,CAQ9B,CAAA"}
+{"version":3,"file":"RunnerServer.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/RunnerServer.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAGvC,OAAO,KAAK,SAAS,MAAM,qBAAqB,CAAA;AAGhD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,KAAK,aAAa,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAIpD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,kSAmGvB,CAAA;AAIH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAC7B,KAAK,EACL,KAAK,EACL,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,GAAG,cAAc,CAAC,cAAc,CAInC,CAAA;AAErC;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,KAAK,CACxC,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,EACnC,KAAK,EACH,SAAS,CAAC,QAAQ,GAClB,cAAc,GACd,OAAO,CAAC,iBAAiB,GACzB,cAAc,CAAC,cAAc,GAC7B,aAAa,CAAC,aAAa,GAC3B,YAAY,CAAC,YAAY,CAI5B,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,KAAK,CACvC,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,EACnC,KAAK,EACH,cAAc,GACd,OAAO,CAAC,iBAAiB,GACzB,cAAc,CAAC,cAAc,GAC7B,aAAa,CAAC,aAAa,CAQ9B,CAAA"}

package/dist/unstable/cluster/RunnerServer.js

@@ -132,6 +132,20 @@ const constWaitUntilRead = {
  * runners, forwards them to the `Sharding` layer, and responds to `Ping`
  * requests.
  *
+ * **When to use**
+ *
+ * Use when a runner process should accept runner-to-runner protocol messages
+ * over a provided server `RpcServer.Protocol`.
+ *
+ * **Gotchas**
+ *
+ * This layer does not choose or provide the wire transport; provide a
+ * transport-specific `RpcServer.Protocol` separately.
+ *
+ * @see {@link layerHandlers} for the lower-level handler layer used when the RPC server is supplied elsewhere
+ * @see {@link layerWithClients} for a runner server layer that also provides the `Sharding` and `Runners` clients
+ * @see {@link layerClientOnly} for embedding a cluster client without serving runner RPCs
+ *
  * @category layers
  * @since 4.0.0
  */
@@ -151,7 +165,7 @@ export const layerWithClients = /*#__PURE__*/layer.pipe(/*#__PURE__*/Layer.provi
  *
  * **When to use**
  *
- * Use this layer to embed a cluster client inside another Effect application
+ * Use when you use this layer to embed a cluster client inside another Effect application
  * without registering with the ShardManager or receiving shard assignments.
  *
  * @category layers

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

@@ -1 +1 @@
-{"version":3,"file":"RunnerServer.js","names":["Effect","Fiber","constant","Layer","Option","Queue","RpcServer","Message","MessageStorage","Reply","RunnerHealth","Runners","Sharding","ShardingConfig","constVoid","void","layerHandlers","Rpcs","toLayer","gen","sharding","storage","Ping","Notify","envelope","notify","_tag","IncomingRequest","respond","lastSentReply","none","IncomingEnvelope","persisted","request","replyEncoded","resume","reply","some","message","orDie","serialize","callback","resume_","parent","getCurrent","onExit","exit","runFork","runForkWith","context","fiber","registerReplyHandler","addObserver","catchTag","constWaitUntilRead","interrupt","andThen","send","isSome","value","Stream","flatMap","make","queue","offerUnsafe","as","pipe","onError","cause","failCause","forkScoped","Envelope","waitUntilRead","layer","spanPrefix","disableTracing","provide","layerWithClients","provideMerge","layerRpc","layerClientOnly","layerNoop","updateService","config","runnerAddress"],"sources":["../../../src/unstable/cluster/RunnerServer.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"RunnerServer.js","names":["Effect","Fiber","constant","Layer","Option","Queue","RpcServer","Message","MessageStorage","Reply","RunnerHealth","Runners","Sharding","ShardingConfig","constVoid","void","layerHandlers","Rpcs","toLayer","gen","sharding","storage","Ping","Notify","envelope","notify","_tag","IncomingRequest","respond","lastSentReply","none","IncomingEnvelope","persisted","request","replyEncoded","resume","reply","some","message","orDie","serialize","callback","resume_","parent","getCurrent","onExit","exit","runFork","runForkWith","context","fiber","registerReplyHandler","addObserver","catchTag","constWaitUntilRead","interrupt","andThen","send","isSome","value","Stream","flatMap","make","queue","offerUnsafe","as","pipe","onError","cause","failCause","forkScoped","Envelope","waitUntilRead","layer","spanPrefix","disableTracing","provide","layerWithClients","provideMerge","layerRpc","layerClientOnly","layerNoop","updateService","config","runnerAddress"],"sources":["../../../src/unstable/cluster/RunnerServer.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

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

@@ -115,6 +115,30 @@ export declare class Runners extends Runners_base {
  * message persistence, duplicate request handling, optional local serialization
  * simulation, and polling for persisted replies.
  *
+ * **When to use**
+ *
+ * Use to build a custom `Runners` service when you already have remote `ping`,
+ * `send`, `notify`, and `onRunnerUnavailable` callbacks and want the standard
+ * local persistence and reply recovery behavior added around them.
+ *
+ * **Details**
+ *
+ * `make` uses the supplied remote callbacks for runner communication and
+ * derives `sendLocal` and `notifyLocal`. Local sends can optionally simulate
+ * remote serialization, persisted notifications are saved through
+ * `MessageStorage`, duplicate requests are resumed from stored replies when
+ * possible, and pending replies are polled according to
+ * `ShardingConfig.entityReplyPollInterval`.
+ *
+ * **Gotchas**
+ *
+ * `notify` and `notifyLocal` only support RPCs annotated as persisted; calling
+ * either path with a non-persisted message dies instead of returning a typed
+ * error.
+ *
+ * @see {@link makeRpc} for the RPC-backed implementation built on top of this constructor
+ * @see {@link makeNoop} for a no-op implementation when remote runner communication is not needed
+ *
  * @category constructors
  * @since 4.0.0
  */