effect 4.0.0-beta.70 → 4.0.0-beta.72

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

@@ -58,13 +58,13 @@ export type Reply<R extends Rpc.Any> = WithExit<R> | Chunk<R>;
  */
 export type Encoded = WithExitEncoded | ChunkEncoded;
 /**
- * Codec used for reply values that are already in encoded form.
+ * Schema for reply values that are already in encoded form.
  *
  * **Details**
  *
  * Per-RPC payload validation is performed by `Reply(rpc)`.
  *
- * @category models
+ * @category schemas
  * @since 4.0.0
  */
 export declare const Encoded: Schema.Codec<Encoded>;
@@ -72,9 +72,14 @@ declare const ReplyWithContext_base: new <A extends Record<string, any> = {}>(ar
     readonly _tag: "ReplyWithContext";
 } & import("../../Pipeable.ts").Pipeable;
 /**
- * A cluster reply paired with the RPC definition and service context required to
+ * Represents a cluster reply paired with the RPC definition and service context required to
  * serialize it for transport.
  *
+ * **When to use**
+ *
+ * Use to carry a runtime reply together with the RPC schema and services needed
+ * to encode it for storage or transport.
+ *
  * @category models
  * @since 4.0.0
  */
@@ -134,8 +139,8 @@ declare const Chunk_base: new <A extends Record<string, any> = {}>(args: import(
     readonly _tag: "Chunk";
 } & import("../../Pipeable.ts").Pipeable;
 /**
- * A streaming RPC reply chunk for a request, carrying a non-empty batch of success
- * values together with the reply id and sequence number.
+ * Represents a streaming RPC reply chunk for a request, carrying a non-empty
+ * batch of success values together with the reply id and sequence number.
  *
  * @category models
  * @since 4.0.0
@@ -193,9 +198,14 @@ declare const WithExit_base: new <A extends Record<string, any> = {}>(args: impo
     readonly _tag: "WithExit";
 } & import("../../Pipeable.ts").Pipeable;
 /**
- * A terminal RPC reply for a request, carrying the final `Exit` for the remote
+ * Represents a terminal RPC reply for a request, carrying the final `Exit` for the remote
  * call.
  *
+ * **When to use**
+ *
+ * Use to represent the final success, typed failure, defect, or interruption
+ * for a clustered RPC request.
+ *
  * @category models
  * @since 4.0.0
  */
@@ -248,7 +258,7 @@ export declare const Reply: <R extends Rpc.Any>(rpc: R) => Schema.Codec<WithExit
  * reply's RPC schema and context and refailing encoding errors as
  * `MalformedMessage`.
  *
- * @category serialization / deserialization
+ * @category serialization
  * @since 4.0.0
  */
 export declare const serialize: <R extends Rpc.Any>(self: ReplyWithContext<R>) => Effect.Effect<Encoded, MalformedMessage>;
@@ -257,7 +267,7 @@ export declare const serialize: <R extends Rpc.Any>(self: ReplyWithContext<R>) =
  * `None` when no reply has been received and refailing encoding errors as
  * `MalformedMessage`.
  *
- * @category serialization / deserialization
+ * @category serialization
  * @since 4.0.0
  */
 export declare const serializeLastReceived: <R extends Rpc.Any>(self: OutgoingRequest<R>) => Effect.Effect<Option.Option<Encoded>, MalformedMessage>;

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

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

package/dist/unstable/cluster/Reply.js

@@ -21,20 +21,25 @@ const TypeId = "~effect/cluster/Reply";
  */
 export const isReply = u => hasProperty(u, TypeId);
 /**
- * Codec used for reply values that are already in encoded form.
+ * Schema for reply values that are already in encoded form.
  *
  * **Details**
  *
  * Per-RPC payload validation is performed by `Reply(rpc)`.
  *
- * @category models
+ * @category schemas
  * @since 4.0.0
  */
 export const Encoded = Schema.Any;
 /**
- * A cluster reply paired with the RPC definition and service context required to
+ * Represents a cluster reply paired with the RPC definition and service context required to
  * serialize it for transport.
  *
+ * **When to use**
+ *
+ * Use to carry a runtime reply together with the RPC schema and services needed
+ * to encode it for storage or transport.
+ *
  * @category models
  * @since 4.0.0
  */
@@ -79,8 +84,8 @@ const neverRpc = /*#__PURE__*/Rpc.make("Never", {
 });
 const schemaCache = /*#__PURE__*/new WeakMap();
 /**
- * A streaming RPC reply chunk for a request, carrying a non-empty batch of success
- * values together with the reply id and sequence number.
+ * Represents a streaming RPC reply chunk for a request, carrying a non-empty
+ * batch of success values together with the reply id and sequence number.
  *
  * @category models
  * @since 4.0.0
@@ -179,9 +184,14 @@ export class Chunk extends /*#__PURE__*/Data.TaggedClass("Chunk") {
   }
 }
 /**
- * A terminal RPC reply for a request, carrying the final `Exit` for the remote
+ * Represents a terminal RPC reply for a request, carrying the final `Exit` for the remote
  * call.
  *
+ * **When to use**
+ *
+ * Use to represent the final success, typed failure, defect, or interruption
+ * for a clustered RPC request.
+ *
  * @category models
  * @since 4.0.0
  */
@@ -273,7 +283,7 @@ export const Reply = rpc => {
  * reply's RPC schema and context and refailing encoding errors as
  * `MalformedMessage`.
  *
- * @category serialization / deserialization
+ * @category serialization
  * @since 4.0.0
  */
 export const serialize = self => {
@@ -285,7 +295,7 @@ export const serialize = self => {
  * `None` when no reply has been received and refailing encoding errors as
  * `MalformedMessage`.
  *
- * @category serialization / deserialization
+ * @category serialization
  * @since 4.0.0
  */
 export const serializeLastReceived = self => {

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

@@ -1 +1 @@
-{"version":3,"file":"Reply.js","names":["Context","Data","Effect","Exit","Option","hasProperty","Schema","Issue","Parser","Transformation","Rpc","MalformedMessage","Snowflake","SnowflakeFromBigInt","TypeId","isReply","u","Encoded","Any","ReplyWithContext","TaggedClass","fromDefect","options","reply","WithExit","requestId","id","exit","die","encodeSync","Defect","defect","context","empty","rpc","neverRpc","interrupt","make","success","Never","error","payload","schemaCache","WeakMap","Chunk","emptyFrom","BigInt","sequence","values","undefined","declare","_tag","transform","decode","a","encode","schema","successSchema","schemaFrom","declareConstructor","input","ast","fail","InvalidType","some","mapBothEager","decodeEffect","NonEmptyArray","onFailure","issue","Composite","Pointer","onSuccess","expected","toCodecJson","link","Struct","Literal","Number","encoded","result","withRequestId","is","exitSchema","Reply","has","get","Union","set","serialize","self","refail","provideContext","encodeEffect","serializeLastReceived","lastReceivedReply","succeedNone","value","pipe","map"],"sources":["../../../src/unstable/cluster/Reply.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Reply.js","names":["Context","Data","Effect","Exit","Option","hasProperty","Schema","Issue","Parser","Transformation","Rpc","MalformedMessage","Snowflake","SnowflakeFromBigInt","TypeId","isReply","u","Encoded","Any","ReplyWithContext","TaggedClass","fromDefect","options","reply","WithExit","requestId","id","exit","die","encodeSync","Defect","defect","context","empty","rpc","neverRpc","interrupt","make","success","Never","error","payload","schemaCache","WeakMap","Chunk","emptyFrom","BigInt","sequence","values","undefined","declare","_tag","transform","decode","a","encode","schema","successSchema","schemaFrom","declareConstructor","input","ast","fail","InvalidType","some","mapBothEager","decodeEffect","NonEmptyArray","onFailure","issue","Composite","Pointer","onSuccess","expected","toCodecJson","link","Struct","Literal","Number","encoded","result","withRequestId","is","exitSchema","Reply","has","get","Union","set","serialize","self","refail","provideContext","encodeEffect","serializeLastReceived","lastReceivedReply","succeedNone","value","pipe","map"],"sources":["../../../src/unstable/cluster/Reply.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

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
  */
@@ -37,7 +51,7 @@ declare const Runner_base: Schema.Class<Runner, Schema.Struct<{
     readonly weight: Schema.Number;
 }>, {}>;
 /**
- * A cluster runner that can host entities.
+ * Represents a cluster runner that can host entities.
  *
  * **Details**
  *
@@ -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
  */
@@ -32,7 +46,7 @@ import * as Schema from "../../Schema.js";
 import { RunnerAddress } from "./RunnerAddress.js";
 const TypeId = "~effect/cluster/Runner";
 /**
- * A cluster runner that can host entities.
+ * Represents a cluster runner that can host entities.
  *
  * **Details**
  *
@@ -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
  */
@@ -28,7 +45,13 @@ declare const RunnerAddress_base: Schema.Class<RunnerAddress, Schema.Struct<{
     readonly port: Schema.Number;
 }>, {}>;
 /**
- * Network address of a cluster runner, identified by host and port.
+ * Represents the network address of a cluster runner, identified by host and
+ * port.
+ *
+ * **When to use**
+ *
+ * Use to represent the host and port that identify a runner in cluster routing,
+ * registration, and health checks.
  *
  * @category models
  * @since 4.0.0
@@ -74,6 +97,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;;;;;;;;;;;GAWG;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
  */
@@ -24,7 +41,13 @@ import * as PrimaryKey from "../../PrimaryKey.js";
 import * as Schema from "../../Schema.js";
 const TypeId = "~effect/cluster/RunnerAddress";
 /**
- * Network address of a cluster runner, identified by host and port.
+ * Represents the network address of a cluster runner, identified by host and
+ * port.
+ *
+ * **When to use**
+ *
+ * Use to represent the host and port that identify a runner in cluster routing,
+ * registration, and health checks.
  *
  * @category models
  * @since 4.0.0
@@ -83,6 +106,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;;;;;;;;;;;;AAYA,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":[]}