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

package/dist/unstable/cluster/Envelope.js

@@ -61,7 +61,8 @@ export class PartialRequest extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Sc
   sampled: /*#__PURE__*/Schema.optional(Schema.Boolean)
 })) {}
 /**
- * Envelope acknowledging receipt of a streamed reply chunk for a request.
+ * Represents an envelope acknowledging receipt of a streamed reply chunk for a
+ * request.
  *
  * **Details**
  *
@@ -96,7 +97,7 @@ export class AckChunk extends /*#__PURE__*/Schema.Class("effect/cluster/Envelope
   }
 }
 /**
- * Envelope used to interrupt an in-flight entity request.
+ * Represents an envelope used to interrupt an in-flight entity request.
  *
  * @category models
  * @since 4.0.0
@@ -126,7 +127,7 @@ export class Interrupt extends /*#__PURE__*/Schema.Class("effect/cluster/Envelop
   }
 }
 /**
- * Schema union for partially decoded cluster envelopes.
+ * Schema for partially decoded cluster envelopes.
  *
  * **Details**
  *
@@ -144,7 +145,7 @@ export const Partial = /*#__PURE__*/Schema.Union([PartialRequest, AckChunk, Inte
  */
 export const PartialJson = /*#__PURE__*/Schema.toCodecJson(Partial);
 /**
- * Mutable array schema for JSON-encoded partial cluster envelopes.
+ * Schema for mutable arrays of JSON-encoded partial cluster envelopes.
  *
  * @category schemas
  * @since 4.0.0
@@ -186,29 +187,28 @@ export const makeRequest = options => ({
   } : {})
 });
 /**
- * Schema declaration that recognizes runtime `Envelope` values by their type
- * identifier.
+ * Schema for runtime cluster envelopes recognized by their type identifier.
  *
- * @category serialization / deserialization
+ * @category serialization
  * @since 4.0.0
  */
 export const Envelope = /*#__PURE__*/Schema.declare(isEnvelope, {
   identifier: "Envelope"
 });
 /**
- * Schema declaration that recognizes runtime request envelopes.
+ * Schema for runtime request envelopes.
  *
- * @category serialization / deserialization
+ * @category serialization
  * @since 4.0.0
  */
 export const Request = /*#__PURE__*/Schema.declare(u => isEnvelope(u) && u._tag === "Request", {
   identifier: "Request"
 });
 /**
- * Transformation that decodes plain request data with `makeRequest` and encodes
+ * Transforms plain request data with `makeRequest` and encodes
  * request envelopes back to their raw representation.
  *
- * @category serialization / deserialization
+ * @category serialization
  * @since 4.0.0
  */
 export const RequestTransform = /*#__PURE__*/Transformation.transform({

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

@@ -1 +1 @@
-{"version":3,"file":"Envelope.js","names":["Predicate","PrimaryKey","Schema","Transformation","Headers","EntityAddress","SnowflakeFromBigInt","TypeId","PartialRequest","Opaque","Struct","_tag","tag","requestId","address","String","payload","Any","headers","HeadersSchema","traceId","optional","spanId","sampled","Boolean","AckChunk","Class","id","replyId","withRequestId","Interrupt","Partial","Union","PartialJson","toCodecJson","PartialArray","mutable","Array","isEnvelope","u","hasProperty","makeRequest","options","undefined","Envelope","declare","identifier","Request","RequestTransform","transform","decode","encode","primaryKey","envelope","isPrimaryKey","primaryKeyByAddress","value","entityType","entityId"],"sources":["../../../src/unstable/cluster/Envelope.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Envelope.js","names":["Predicate","PrimaryKey","Schema","Transformation","Headers","EntityAddress","SnowflakeFromBigInt","TypeId","PartialRequest","Opaque","Struct","_tag","tag","requestId","address","String","payload","Any","headers","HeadersSchema","traceId","optional","spanId","sampled","Boolean","AckChunk","Class","id","replyId","withRequestId","Interrupt","Partial","Union","PartialJson","toCodecJson","PartialArray","mutable","Array","isEnvelope","u","hasProperty","makeRequest","options","undefined","Envelope","declare","identifier","Request","RequestTransform","transform","decode","encode","primaryKey","envelope","isPrimaryKey","primaryKeyByAddress","value","entityType","entityId"],"sources":["../../../src/unstable/cluster/Envelope.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

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

@@ -1,26 +1,38 @@
 /**
- * The `HttpRunner` module wires cluster runner RPCs to HTTP transports. It
- * provides client protocol layers for contacting runners over HTTP or
- * WebSocket, server-side HTTP effects for exposing runner RPC handlers, and
- * complete layers that install those routes into an `HttpRouter`.
+ * HTTP and WebSocket transport layers for cluster runner RPCs.
+ *
+ * Runner nodes communicate through the `Runners.Rpcs` protocol. This module
+ * connects that protocol to HTTP transports by providing client protocols for
+ * dialing runner addresses, HTTP effects for serving runner RPC handlers, and
+ * complete layers that install runner routes into an `HttpRouter`.
+ *
+ * **Mental model**
+ *
+ * Runner communication has two sides: a client protocol that knows how to turn a
+ * runner address into an RPC connection, and a server route that exposes the
+ * runner RPC handlers. The complete layers provide both sides with matching
+ * defaults, while the `Options` and `ClientOnly` variants let applications wire
+ * only the pieces they need.
  *
  * **Common tasks**
  *
- * - Serve runner RPC routes with {@link layerHttp} or {@link layerWebsocket}
- * - Configure client-only runner communication with {@link layerHttpClientOnly}
+ * - Serve runners over HTTP with {@link layerHttp} or {@link layerHttpOptions}
+ * - Serve runners over WebSocket with {@link layerWebsocket} or
+ *   {@link layerWebsocketOptions}
+ * - Configure clients without serving routes with {@link layerHttpClientOnly}
  *   or {@link layerWebsocketClientOnly}
- * - Use custom route paths with {@link layerHttpOptions},
- *   {@link layerWebsocketOptions}, {@link layerClientProtocolHttp}, or
+ * - Build custom client protocols with {@link layerClientProtocolHttp} or
  *   {@link layerClientProtocolWebsocket}
  *
- * **Transport gotchas**
+ * **Gotchas**
  *
- * - Client protocol paths are appended to each runner address when building the
- *   target URL
- * - `https: true` switches HTTP clients from `http` to `https`, and WebSocket
+ * - Server route paths and client protocol paths must match
+ * - `https: true` switches HTTP clients from `http` to `https` and WebSocket
  *   clients from `ws` to `wss`
- * - The default complete layers serve and connect at `/`; use the `Options`
- *   variants when your runner routes live under a different path
+ * - The complete layers serve and connect at `/`; use the `Options` variants
+ *   when runner routes live under another path
+ * - {@link toHttpEffect} and {@link toHttpEffectWebsocket} expose raw HTTP
+ *   effects for adapters that do not use `HttpRouter.serve`
  *
  * @since 4.0.0
  */
@@ -120,8 +132,7 @@ export declare const toHttpEffectWebsocket: Effect.Effect<Effect.Effect<HttpServ
  */
 export declare const layerClient: Layer.Layer<Sharding.Sharding | Runners.Runners, never, ShardingConfig.ShardingConfig | Runners.RpcClientProtocol | MessageStorage | RunnerStorage | RunnerHealth>;
 /**
- * A HTTP layer for the `Runners` services, that adds a route to the provided
- * `HttpRouter`.
+ * Layer that adds HTTP runner routes to the provided `HttpRouter`.
  *
  * @category layers
  * @since 4.0.0
@@ -130,8 +141,7 @@ export declare const layerHttpOptions: (options: {
     readonly path: HttpRouter.PathInput;
 }) => Layer.Layer<Sharding.Sharding | Runners.Runners, never, RunnerStorage | RunnerHealth | RpcSerialization.RpcSerialization | MessageStorage | ShardingConfig.ShardingConfig | Runners.RpcClientProtocol | HttpRouter.HttpRouter>;
 /**
- * WebSocket layer for the `Runners` services that adds a route to the provided
- * `HttpRouter`.
+ * Layer that adds WebSocket runner routes to the provided `HttpRouter`.
  *
  * @category layers
  * @since 4.0.0
@@ -140,7 +150,7 @@ export declare const layerWebsocketOptions: (options: {
     readonly path: HttpRouter.PathInput;
 }) => Layer.Layer<Sharding.Sharding | Runners.Runners, never, ShardingConfig.ShardingConfig | Runners.RpcClientProtocol | MessageStorage | RunnerStorage | RunnerHealth | RpcSerialization.RpcSerialization | HttpRouter.HttpRouter>;
 /**
- * Complete HTTP runner layer.
+ * Layer that serves runner routes at `/` and configures HTTP runner clients.
  *
  * **Details**
  *
@@ -152,7 +162,12 @@ export declare const layerWebsocketOptions: (options: {
  */
 export declare const layerHttp: Layer.Layer<Sharding.Sharding | Runners.Runners, never, RpcSerialization.RpcSerialization | ShardingConfig.ShardingConfig | HttpClient.HttpClient | HttpServer.HttpServer | MessageStorage | RunnerStorage | RunnerHealth>;
 /**
- * Client-only HTTP runner layer.
+ * Provides a client-only HTTP runner layer.
+ *
+ * **When to use**
+ *
+ * Use to provide runner clients over HTTP from a process that should not serve
+ * runner routes.
  *
  * **Details**
  *
@@ -164,7 +179,7 @@ export declare const layerHttp: Layer.Layer<Sharding.Sharding | Runners.Runners,
  */
 export declare const layerHttpClientOnly: Layer.Layer<Sharding.Sharding | Runners.Runners, never, RpcSerialization.RpcSerialization | ShardingConfig.ShardingConfig | HttpClient.HttpClient | MessageStorage | RunnerStorage>;
 /**
- * Complete WebSocket runner layer.
+ * Layer that serves runner routes at `/` and configures WebSocket runner clients.
  *
  * **Details**
  *
@@ -176,7 +191,12 @@ export declare const layerHttpClientOnly: Layer.Layer<Sharding.Sharding | Runner
  */
 export declare const layerWebsocket: Layer.Layer<Sharding.Sharding | Runners.Runners, never, RpcSerialization.RpcSerialization | ShardingConfig.ShardingConfig | Socket.WebSocketConstructor | HttpServer.HttpServer | MessageStorage | RunnerStorage | RunnerHealth>;
 /**
- * Client-only WebSocket runner layer.
+ * Provides a client-only WebSocket runner layer.
+ *
+ * **When to use**
+ *
+ * Use to provide runner clients over WebSocket from a process that should not
+ * serve runner routes.
  *
  * **Details**
  *

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

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

package/dist/unstable/cluster/HttpRunner.js

@@ -1,26 +1,38 @@
 /**
- * The `HttpRunner` module wires cluster runner RPCs to HTTP transports. It
- * provides client protocol layers for contacting runners over HTTP or
- * WebSocket, server-side HTTP effects for exposing runner RPC handlers, and
- * complete layers that install those routes into an `HttpRouter`.
+ * HTTP and WebSocket transport layers for cluster runner RPCs.
+ *
+ * Runner nodes communicate through the `Runners.Rpcs` protocol. This module
+ * connects that protocol to HTTP transports by providing client protocols for
+ * dialing runner addresses, HTTP effects for serving runner RPC handlers, and
+ * complete layers that install runner routes into an `HttpRouter`.
+ *
+ * **Mental model**
+ *
+ * Runner communication has two sides: a client protocol that knows how to turn a
+ * runner address into an RPC connection, and a server route that exposes the
+ * runner RPC handlers. The complete layers provide both sides with matching
+ * defaults, while the `Options` and `ClientOnly` variants let applications wire
+ * only the pieces they need.
  *
  * **Common tasks**
  *
- * - Serve runner RPC routes with {@link layerHttp} or {@link layerWebsocket}
- * - Configure client-only runner communication with {@link layerHttpClientOnly}
+ * - Serve runners over HTTP with {@link layerHttp} or {@link layerHttpOptions}
+ * - Serve runners over WebSocket with {@link layerWebsocket} or
+ *   {@link layerWebsocketOptions}
+ * - Configure clients without serving routes with {@link layerHttpClientOnly}
  *   or {@link layerWebsocketClientOnly}
- * - Use custom route paths with {@link layerHttpOptions},
- *   {@link layerWebsocketOptions}, {@link layerClientProtocolHttp}, or
+ * - Build custom client protocols with {@link layerClientProtocolHttp} or
  *   {@link layerClientProtocolWebsocket}
  *
- * **Transport gotchas**
+ * **Gotchas**
  *
- * - Client protocol paths are appended to each runner address when building the
- *   target URL
- * - `https: true` switches HTTP clients from `http` to `https`, and WebSocket
+ * - Server route paths and client protocol paths must match
+ * - `https: true` switches HTTP clients from `http` to `https` and WebSocket
  *   clients from `ws` to `wss`
- * - The default complete layers serve and connect at `/`; use the `Options`
- *   variants when your runner routes live under a different path
+ * - The complete layers serve and connect at `/`; use the `Options` variants
+ *   when runner routes live under another path
+ * - {@link toHttpEffect} and {@link toHttpEffectWebsocket} expose raw HTTP
+ *   effects for adapters that do not use `HttpRouter.serve`
  *
  * @since 4.0.0
  */
@@ -142,23 +154,21 @@ export const toHttpEffectWebsocket = /*#__PURE__*/Effect.gen(function* () {
  */
 export const layerClient = /*#__PURE__*/Sharding.layer.pipe(/*#__PURE__*/Layer.provideMerge(Runners.layerRpc));
 /**
- * A HTTP layer for the `Runners` services, that adds a route to the provided
- * `HttpRouter`.
+ * Layer that adds HTTP runner routes to the provided `HttpRouter`.
  *
  * @category layers
  * @since 4.0.0
  */
 export const layerHttpOptions = options => RunnerServer.layerWithClients.pipe(Layer.provide(RpcServer.layerProtocolHttp(options)));
 /**
- * WebSocket layer for the `Runners` services that adds a route to the provided
- * `HttpRouter`.
+ * Layer that adds WebSocket runner routes to the provided `HttpRouter`.
  *
  * @category layers
  * @since 4.0.0
  */
 export const layerWebsocketOptions = options => RunnerServer.layerWithClients.pipe(Layer.provide(RpcServer.layerProtocolWebsocket(options)));
 /**
- * Complete HTTP runner layer.
+ * Layer that serves runner routes at `/` and configures HTTP runner clients.
  *
  * **Details**
  *
@@ -172,7 +182,12 @@ export const layerHttp = /*#__PURE__*/HttpRouter.serve(layerHttpOptions({
   path: "/"
 })).pipe(/*#__PURE__*/Layer.provide(layerClientProtocolHttpDefault));
 /**
- * Client-only HTTP runner layer.
+ * Provides a client-only HTTP runner layer.
+ *
+ * **When to use**
+ *
+ * Use to provide runner clients over HTTP from a process that should not serve
+ * runner routes.
  *
  * **Details**
  *
@@ -184,7 +199,7 @@ export const layerHttp = /*#__PURE__*/HttpRouter.serve(layerHttpOptions({
  */
 export const layerHttpClientOnly = /*#__PURE__*/RunnerServer.layerClientOnly.pipe(/*#__PURE__*/Layer.provide(layerClientProtocolHttpDefault));
 /**
- * Complete WebSocket runner layer.
+ * Layer that serves runner routes at `/` and configures WebSocket runner clients.
  *
  * **Details**
  *
@@ -198,7 +213,12 @@ export const layerWebsocket = /*#__PURE__*/HttpRouter.serve(layerWebsocketOption
   path: "/"
 })).pipe(/*#__PURE__*/Layer.provide(layerClientProtocolWebsocketDefault));
 /**
- * Client-only WebSocket runner layer.
+ * Provides a client-only WebSocket runner layer.
+ *
+ * **When to use**
+ *
+ * Use to provide runner clients over WebSocket from a process that should not
+ * serve runner routes.
  *
  * **Details**
  *

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

@@ -1 +1 @@
-{"version":3,"file":"HttpRunner.js","names":["Effect","Layer","HttpClient","HttpClientRequest","HttpRouter","RpcClient","RpcSerialization","RpcServer","Socket","Runners","RpcClientProtocol","RunnerServer","Sharding","layerClientProtocolHttp","options","effect","gen","serialization","client","https","address","clientWithUrl","mapRequest","prependUrl","host","port","path","makeProtocolHttp","pipe","provideService","layerClientProtocolHttpDefault","layerClientProtocolWebsocket","constructor","WebSocketConstructor","fnUntraced","socket","makeWebSocket","makeProtocolSocket","layerClientProtocolWebsocketDefault","toHttpEffect","handlers","build","layerHandlers","Rpcs","spanPrefix","disableTracing","provideContext","toHttpEffectWebsocket","layerClient","layer","provideMerge","layerRpc","layerHttpOptions","layerWithClients","provide","layerProtocolHttp","layerWebsocketOptions","layerProtocolWebsocket","layerHttp","serve","layerHttpClientOnly","layerClientOnly","layerWebsocket","layerWebsocketClientOnly"],"sources":["../../../src/unstable/cluster/HttpRunner.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"HttpRunner.js","names":["Effect","Layer","HttpClient","HttpClientRequest","HttpRouter","RpcClient","RpcSerialization","RpcServer","Socket","Runners","RpcClientProtocol","RunnerServer","Sharding","layerClientProtocolHttp","options","effect","gen","serialization","client","https","address","clientWithUrl","mapRequest","prependUrl","host","port","path","makeProtocolHttp","pipe","provideService","layerClientProtocolHttpDefault","layerClientProtocolWebsocket","constructor","WebSocketConstructor","fnUntraced","socket","makeWebSocket","makeProtocolSocket","layerClientProtocolWebsocketDefault","toHttpEffect","handlers","build","layerHandlers","Rpcs","spanPrefix","disableTracing","provideContext","toHttpEffectWebsocket","layerClient","layer","provideMerge","layerRpc","layerHttpOptions","layerWithClients","provide","layerProtocolHttp","layerWebsocketOptions","layerProtocolWebsocket","layerHttp","serve","layerHttpClientOnly","layerClientOnly","layerWebsocket","layerWebsocketClientOnly"],"sources":["../../../src/unstable/cluster/HttpRunner.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

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

@@ -1,21 +1,40 @@
 /**
- * The `K8sHttpClient` module provides an HTTP client service for talking to the
- * Kubernetes API from code running inside a cluster.
- *
- * It configures requests for the in-cluster service endpoint, attaches the
- * mounted service-account token when present, and exposes helpers for common
- * cluster tasks such as discovering running pods by namespace or label selector
- * and creating scoped pods that are cleaned up automatically.
+ * HTTP client support for talking to the Kubernetes API from code running
+ * inside a cluster. The module builds a `K8sHttpClient` service on top of the
+ * shared HTTP client, points requests at the in-cluster API endpoint, and uses
+ * the mounted service-account token when one is available.
+ *
+ * **Mental model**
+ *
+ * - {@link layer} adapts an existing `HttpClient` so relative requests target
+ *   `https://kubernetes.default.svc/api`.
+ * - {@link K8sHttpClient} is the service tag consumed by the cluster helpers in
+ *   this module.
+ * - {@link makeGetPods} returns a cached effect that lists running pods and
+ *   indexes them by pod IP address.
+ * - {@link makeCreatePod} returns a scoped creator that creates a pod when it
+ *   is missing, waits for readiness, and deletes it when the scope closes.
+ * - {@link Pod} and {@link PodStatus} model only the status fields needed by
+ *   these helpers.
+ *
+ * **Common tasks**
+ *
+ * - Discover running pods in a namespace or behind a label selector.
+ * - Create short-lived pods for cluster workflows and let scope finalization
+ *   clean them up.
+ * - Reuse the configured `K8sHttpClient` for Kubernetes API calls that share
+ *   the same in-cluster endpoint, token, status filtering, and retry policy.
  *
  * **Gotchas**
  *
- * - The default layer targets `https://kubernetes.default.svc/api`, so it is
- *   intended for workloads with Kubernetes DNS and service-account mounts.
- * - Pod discovery is keyed by pod IP address and only includes pods whose phase
- *   is `Running`; callers should choose selectors that match the intended
- *   service topology.
- * - Network policies, RBAC, and service-account token availability can all
- *   prevent the client from reaching or authorizing with the Kubernetes API.
+ * - The default layer assumes Kubernetes DNS and the standard service-account
+ *   mount path used by in-cluster workloads.
+ * - Pod discovery filters to `status.phase=Running`; pods without the expected
+ *   status shape fail schema decoding.
+ * - Pod maps are keyed by pod IP address, so selectors should match the service
+ *   topology the caller actually wants to route to.
+ * - RBAC, network policies, and missing service-account tokens can still block
+ *   requests even when the layer is present.
  *
  * @since 4.0.0
  */

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

@@ -1 +1 @@
-{"version":3,"file":"K8sHttpClient.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/K8sHttpClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACxD,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,UAAU,MAAM,qBAAqB,CAAA;AAEjD,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAIvC,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,eAAe,MAAM,4BAA4B,CAAA;;AAI7D;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,kBAGA;CAAG;AAEtC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAC7B,aAAa,EACb,KAAK,EACL,UAAU,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAiB9C,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,EAAE,CACxB,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5C,GAAG,SAAS,KACV,MAAM,CAAC,MAAM,CAChB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,eAAe,CAAC,eAAe,GAAG,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,EAC5F,KAAK,EACL,aAAa,CA2Bb,CAAA;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,wHAgGxB,CAAA;;;;;;;;;;;AAEF;;;;;GAKG;AACH,qBAAa,SAAU,SAAQ,cAS7B;CAAG;;;;AAEL;;;;;;;;;GASG;AACH,qBAAa,GAAI,SAAQ,QAEvB;IACA,IAAI,OAAO,IAAI,OAAO,CAQrB;IAED,IAAI,qBAAqB,IAAI,OAAO,CAyBnC;CACF"}
+{"version":3,"file":"K8sHttpClient.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/K8sHttpClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,KAAK,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACxD,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,UAAU,MAAM,qBAAqB,CAAA;AAEjD,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAIvC,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,eAAe,MAAM,4BAA4B,CAAA;;AAI7D;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,kBAGA;CAAG;AAEtC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAC7B,aAAa,EACb,KAAK,EACL,UAAU,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAiB9C,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,EAAE,CACxB,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5C,GAAG,SAAS,KACV,MAAM,CAAC,MAAM,CAChB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,eAAe,CAAC,eAAe,GAAG,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,EAC5F,KAAK,EACL,aAAa,CA2Bb,CAAA;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,wHAgGxB,CAAA;;;;;;;;;;;AAEF;;;;;GAKG;AACH,qBAAa,SAAU,SAAQ,cAS7B;CAAG;;;;AAEL;;;;;;;;;GASG;AACH,qBAAa,GAAI,SAAQ,QAEvB;IACA,IAAI,OAAO,IAAI,OAAO,CAQrB;IAED,IAAI,qBAAqB,IAAI,OAAO,CAyBnC;CACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"K8sHttpClient.js","names":["Context","Effect","FileSystem","identity","Layer","Option","Result","Schedule","Schema","HttpClient","HttpClientError","HttpClientRequest","HttpClientResponse","K8sHttpClient","Service","layer","effect","gen","fs","token","readFileString","pipe","option","mapRequest","prependUrl","_tag","bearerToken","value","trim","filterStatusOk","retryTransient","schedule","spaced","makeGetPods","fnUntraced","options","client","getPods","get","namespace","setUrlParam","labelSelector","execute","flatMap","schemaBodyJson","PodList","map","list","pods","Map","i","items","length","pod","set","status","podIP","tapCause","cause","logWarning","cachedWithTTL","makeCreatePod","spec","apiVersion","kind","metadata","name","readPodRaw","readPod","Pod","asSome","retry","while","e","catchFilter","err","isHttpClientError","reason","response","succeed","fail","succeedNone","orDie","isPodFound","as","createPod","post","bodyJsonUnsafe","logInfo","deletePod","delete","res","json","void","asVoid","addFinalizer","repeat","until","found","opod","none","isNone","isReady","sleep","withSpan","PodStatus","Class","phase","String","conditions","Array","Struct","type","lastTransitionTime","NullOr","hostIP","condition","isReadyOrInitializing","initializedAt","readyAt"],"sources":["../../../src/unstable/cluster/K8sHttpClient.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"K8sHttpClient.js","names":["Context","Effect","FileSystem","identity","Layer","Option","Result","Schedule","Schema","HttpClient","HttpClientError","HttpClientRequest","HttpClientResponse","K8sHttpClient","Service","layer","effect","gen","fs","token","readFileString","pipe","option","mapRequest","prependUrl","_tag","bearerToken","value","trim","filterStatusOk","retryTransient","schedule","spaced","makeGetPods","fnUntraced","options","client","getPods","get","namespace","setUrlParam","labelSelector","execute","flatMap","schemaBodyJson","PodList","map","list","pods","Map","i","items","length","pod","set","status","podIP","tapCause","cause","logWarning","cachedWithTTL","makeCreatePod","spec","apiVersion","kind","metadata","name","readPodRaw","readPod","Pod","asSome","retry","while","e","catchFilter","err","isHttpClientError","reason","response","succeed","fail","succeedNone","orDie","isPodFound","as","createPod","post","bodyJsonUnsafe","logInfo","deletePod","delete","res","json","void","asVoid","addFinalizer","repeat","until","found","opod","none","isNone","isReady","sleep","withSpan","PodStatus","Class","phase","String","conditions","Array","Struct","type","lastTransitionTime","NullOr","hostIP","condition","isReadyOrInitializing","initializedAt","readyAt"],"sources":["../../../src/unstable/cluster/K8sHttpClient.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

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

@@ -1,18 +1,28 @@
 /**
- * The `MachineId` module provides the branded integer identifier used to
- * distinguish cluster runners when generating distributed ids and coordinating
- * runner state.
+ * Branded integer identifiers for cluster runners. A `MachineId` marks the
+ * machine component used by cluster services, especially snowflake id
+ * generation, while keeping the value distinct from an ordinary `number` in
+ * TypeScript APIs.
  *
- * **When to use**
+ * **Mental model**
+ *
+ * The runtime value is still a number. The brand documents that the number was
+ * assigned as a cluster machine id and lets schemas, storage adapters, and
+ * generators agree on the same type.
+ *
+ * **Common tasks**
  *
- * - Persisting or exchanging the machine id assigned to a cluster runner
- * - Passing a runner-specific identity to the cluster snowflake generator
- * - Decoding machine ids from storage while keeping them distinct from plain numbers
+ * - Decode persisted runner identities with the {@link MachineId} schema
+ * - Brand a trusted numeric id with {@link make}
+ * - Pass a runner-specific id to snowflake generation
  *
  * **Gotchas**
  *
- * - Machine ids must be unique for concurrently active runners that generate snowflakes
- * - Snowflake ids store the machine component in 10 bits, so only the value modulo 1024 is encoded
+ * - Concurrent runners that generate snowflakes need distinct machine ids.
+ * - Snowflake ids encode the machine component in 10 bits, so only the value
+ *   modulo 1024 is represented there.
+ * - {@link make} brands a number without validation; use the schema when input
+ *   needs decoding or validation.
  *
  * @since 4.0.0
  */
@@ -34,6 +44,22 @@ export type MachineId = typeof MachineId.Type;
 /**
  * Brands a number as a `MachineId`.
  *
+ * **When to use**
+ *
+ * Use to turn a trusted numeric machine id into the branded type when
+ * implementing runner storage adapters or configuring snowflake generation.
+ *
+ * **Details**
+ *
+ * The branded value is the original number at runtime.
+ *
+ * **Gotchas**
+ *
+ * `make` does not validate integer input or enforce the snowflake machine-id
+ * range. Snowflake ids encode the machine component modulo 1024.
+ *
+ * @see {@link MachineId} for the schema that validates branded integer machine identifiers
+ *
  * @category constructors
  * @since 4.0.0
  */

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

@@ -1 +1 @@
-{"version":3,"file":"MachineId.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/MachineId.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,SAAS,uDAKrB,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAA;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GAAI,IAAI,MAAM,KAAG,SAA4B,CAAA"}
+{"version":3,"file":"MachineId.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/MachineId.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,SAAS,uDAKrB,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,IAAI,GAAI,IAAI,MAAM,KAAG,SAA4B,CAAA"}

package/dist/unstable/cluster/MachineId.js

@@ -1,18 +1,28 @@
 /**
- * The `MachineId` module provides the branded integer identifier used to
- * distinguish cluster runners when generating distributed ids and coordinating
- * runner state.
+ * Branded integer identifiers for cluster runners. A `MachineId` marks the
+ * machine component used by cluster services, especially snowflake id
+ * generation, while keeping the value distinct from an ordinary `number` in
+ * TypeScript APIs.
  *
- * **When to use**
+ * **Mental model**
+ *
+ * The runtime value is still a number. The brand documents that the number was
+ * assigned as a cluster machine id and lets schemas, storage adapters, and
+ * generators agree on the same type.
+ *
+ * **Common tasks**
  *
- * - Persisting or exchanging the machine id assigned to a cluster runner
- * - Passing a runner-specific identity to the cluster snowflake generator
- * - Decoding machine ids from storage while keeping them distinct from plain numbers
+ * - Decode persisted runner identities with the {@link MachineId} schema
+ * - Brand a trusted numeric id with {@link make}
+ * - Pass a runner-specific id to snowflake generation
  *
  * **Gotchas**
  *
- * - Machine ids must be unique for concurrently active runners that generate snowflakes
- * - Snowflake ids store the machine component in 10 bits, so only the value modulo 1024 is encoded
+ * - Concurrent runners that generate snowflakes need distinct machine ids.
+ * - Snowflake ids encode the machine component in 10 bits, so only the value
+ *   modulo 1024 is represented there.
+ * - {@link make} brands a number without validation; use the schema when input
+ *   needs decoding or validation.
  *
  * @since 4.0.0
  */
@@ -29,6 +39,22 @@ export const MachineId = /*#__PURE__*/Schema.Int.pipe(/*#__PURE__*/Schema.brand(
 /**
  * Brands a number as a `MachineId`.
  *
+ * **When to use**
+ *
+ * Use to turn a trusted numeric machine id into the branded type when
+ * implementing runner storage adapters or configuring snowflake generation.
+ *
+ * **Details**
+ *
+ * The branded value is the original number at runtime.
+ *
+ * **Gotchas**
+ *
+ * `make` does not validate integer input or enforce the snowflake machine-id
+ * range. Snowflake ids encode the machine component modulo 1024.
+ *
+ * @see {@link MachineId} for the schema that validates branded integer machine identifiers
+ *
  * @category constructors
  * @since 4.0.0
  */

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

@@ -1 +1 @@
-{"version":3,"file":"MachineId.js","names":["Schema","MachineId","Int","pipe","brand","annotate","toFormatter","machineId","make","id"],"sources":["../../../src/unstable/cluster/MachineId.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;AAkBA,OAAO,KAAKA,MAAM,MAAM,iBAAiB;AAEzC;;;;;;AAMA,OAAO,MAAMC,SAAS,gBAAGD,MAAM,CAACE,GAAG,CAACC,IAAI,cACtCH,MAAM,CAACI,KAAK,CAAC,2BAA2B,CAAC,eACzCJ,MAAM,CAACK,QAAQ,CAAC;EACdC,WAAW,EAAEA,CAAA,KAAOC,SAAiB,IAAK,aAAaA,SAAS;CACjE,CAAC,CACH;AAUD;;;;;;AAMA,OAAO,MAAMC,IAAI,GAAIC,EAAU,IAAgBA,EAAe","ignoreList":[]}
+{"version":3,"file":"MachineId.js","names":["Schema","MachineId","Int","pipe","brand","annotate","toFormatter","machineId","make","id"],"sources":["../../../src/unstable/cluster/MachineId.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,OAAO,KAAKA,MAAM,MAAM,iBAAiB;AAEzC;;;;;;AAMA,OAAO,MAAMC,SAAS,gBAAGD,MAAM,CAACE,GAAG,CAACC,IAAI,cACtCH,MAAM,CAACI,KAAK,CAAC,2BAA2B,CAAC,eACzCJ,MAAM,CAACK,QAAQ,CAAC;EACdC,WAAW,EAAEA,CAAA,KAAOC,SAAiB,IAAK,aAAaA,SAAS;CACjE,CAAC,CACH;AAUD;;;;;;;;;;;;;;;;;;;;;;AAsBA,OAAO,MAAMC,IAAI,GAAIC,EAAU,IAAgBA,EAAe","ignoreList":[]}