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

package/dist/unstable/cluster/Envelope.js

@@ -1,4 +1,27 @@
 /**
+ * The `Envelope` module defines the transport messages exchanged by Effect
+ * cluster entities while processing RPC requests. Envelopes wrap decoded
+ * request payloads with routing metadata, trace context, and request ids, and
+ * also model delivery-control messages such as streamed-reply acknowledgements
+ * and request interrupts.
+ *
+ * **Common use cases**
+ *
+ * - Construct a runtime request envelope with {@link makeRequest}
+ * - Decode or encode envelopes crossing a network or durable queue with {@link PartialJson}
+ * - Batch encoded envelopes with {@link PartialArray}
+ * - Detect envelope values at runtime with {@link isEnvelope}
+ * - Build storage keys for keyed request payloads with {@link primaryKey}
+ *
+ * **Serialization and delivery notes**
+ *
+ * Request envelopes are decoded in two phases: the envelope metadata is parsed
+ * first, while the RPC payload remains `unknown` until the receiving side knows
+ * the target RPC schema. Snowflake identifiers are encoded as strings for JSON
+ * transport, and acknowledgement / interrupt envelopes carry the original
+ * request id so delivery protocols can correlate control messages with the
+ * in-flight request.
+ *
  * @since 4.0.0
  */
 import * as Predicate from "../../Predicate.js";
@@ -9,13 +32,20 @@ import * as Headers from "../http/Headers.js";
 import { EntityAddress } from "./EntityAddress.js";
 import { SnowflakeFromBigInt } from "./Snowflake.js";
 /**
+ * Type identifier used to mark runtime cluster envelope values.
+ *
+ * @category type IDs
  * @since 4.0.0
- * @category Type IDs
  */
 export const TypeId = "~effect/cluster/Envelope";
 /**
- * @since 4.0.0
+ * Schema for a request envelope before its RPC payload has been decoded.
+ *
+ * The envelope metadata is decoded, while the payload remains `unknown` until it
+ * is decoded with the target RPC payload schema.
+ *
  * @category models
+ * @since 4.0.0
  */
 export class PartialRequest extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Schema.Struct({
   _tag: /*#__PURE__*/Schema.tag("Request"),
@@ -29,8 +59,12 @@ export class PartialRequest extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Sc
   sampled: /*#__PURE__*/Schema.optional(Schema.Boolean)
 })) {}
 /**
- * @since 4.0.0
+ * Envelope acknowledging receipt of a streamed reply chunk for a request.
+ *
+ * The `replyId` identifies the chunk reply that has been received.
+ *
  * @category models
+ * @since 4.0.0
  */
 export class AckChunk extends /*#__PURE__*/Schema.Class("effect/cluster/Envelope/AckChunk")({
   _tag: /*#__PURE__*/Schema.tag("AckChunk"),
@@ -40,10 +74,14 @@ export class AckChunk extends /*#__PURE__*/Schema.Class("effect/cluster/Envelope
   replyId: SnowflakeFromBigInt
 }) {
   /**
+   * Marks this value as a cluster envelope for runtime guards.
+   *
    * @since 4.0.0
    */
   [TypeId] = TypeId;
   /**
+   * Returns a copy of this acknowledgement associated with the supplied request id.
+   *
    * @since 4.0.0
    */
   withRequestId(requestId) {
@@ -54,8 +92,10 @@ export class AckChunk extends /*#__PURE__*/Schema.Class("effect/cluster/Envelope
   }
 }
 /**
- * @since 4.0.0
+ * Envelope used to interrupt an in-flight entity request.
+ *
  * @category models
+ * @since 4.0.0
  */
 export class Interrupt extends /*#__PURE__*/Schema.Class("effect/cluster/Envelope/Interrupt")({
   _tag: /*#__PURE__*/Schema.tag("Interrupt"),
@@ -64,10 +104,14 @@ export class Interrupt extends /*#__PURE__*/Schema.Class("effect/cluster/Envelop
   requestId: SnowflakeFromBigInt
 }) {
   /**
+   * Marks this value as a cluster envelope for runtime guards.
+   *
    * @since 4.0.0
    */
   [TypeId] = TypeId;
   /**
+   * Returns a copy of this interrupt associated with the supplied request id.
+   *
    * @since 4.0.0
    */
   withRequestId(requestId) {
@@ -78,28 +122,44 @@ export class Interrupt extends /*#__PURE__*/Schema.Class("effect/cluster/Envelop
   }
 }
 /**
- * @since 4.0.0
+ * Schema union for partially decoded cluster envelopes.
+ *
+ * It accepts `PartialRequest`, `AckChunk`, and `Interrupt` envelope values.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const Partial = /*#__PURE__*/Schema.Union([PartialRequest, AckChunk, Interrupt]);
 /**
- * @since 4.0.0
+ * JSON codec for partial cluster envelopes.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const PartialJson = /*#__PURE__*/Schema.toCodecJson(Partial);
 /**
- * @since 4.0.0
+ * Mutable array schema for JSON-encoded partial cluster envelopes.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const PartialArray = /*#__PURE__*/Schema.mutable(/*#__PURE__*/Schema.Array(PartialJson));
 /**
- * @since 4.0.0
+ * Returns `true` when the supplied value is a runtime cluster envelope.
+ *
+ * The check is based on the envelope type identifier.
+ *
  * @category refinements
+ * @since 4.0.0
  */
 export const isEnvelope = u => Predicate.hasProperty(u, TypeId);
 /**
- * @since 4.0.0
+ * Constructs a runtime request envelope and attaches the envelope type identifier.
+ *
+ * Tracing fields are included only when a `traceId` is provided.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export const makeRequest = options => ({
   [TypeId]: TypeId,
@@ -116,30 +176,41 @@ export const makeRequest = options => ({
   } : {})
 });
 /**
- * @since 4.0.0
+ * Schema declaration that recognizes runtime `Envelope` values by their type
+ * identifier.
+ *
  * @category serialization / deserialization
+ * @since 4.0.0
  */
 export const Envelope = /*#__PURE__*/Schema.declare(isEnvelope, {
   identifier: "Envelope"
 });
 /**
- * @since 4.0.0
+ * Schema declaration that recognizes runtime request envelopes.
+ *
  * @category serialization / deserialization
+ * @since 4.0.0
  */
 export const Request = /*#__PURE__*/Schema.declare(u => isEnvelope(u) && u._tag === "Request", {
   identifier: "Request"
 });
 /**
- * @since 4.0.0
+ * Transformation that decodes plain request data with `makeRequest` and encodes
+ * request envelopes back to their raw representation.
+ *
  * @category serialization / deserialization
+ * @since 4.0.0
  */
 export const RequestTransform = /*#__PURE__*/Transformation.transform({
   decode: u => makeRequest(u),
   encode: u => u
 });
 /**
- * @since 4.0.0
+ * Returns the storage primary key for a request envelope whose payload has a
+ * primary key, or `null` when the envelope is not a keyed request.
+ *
  * @category primary key
+ * @since 4.0.0
  */
 export const primaryKey = envelope => {
   if (envelope._tag !== "Request" || !PrimaryKey.isPrimaryKey(envelope.payload)) {
@@ -152,8 +223,11 @@ export const primaryKey = envelope => {
   });
 };
 /**
- * @since 4.0.0
+ * Builds a storage primary-key string from an entity address, RPC tag, and
+ * payload primary-key ID.
+ *
  * @category primary key
+ * @since 4.0.0
  */
 export const primaryKeyByAddress = options =>
 // hash the entity address to save space?

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,4 +1,27 @@
 /**
+ * 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`.
+ *
+ * **Common tasks**
+ *
+ * - Serve runner RPC routes with {@link layerHttp} or {@link layerWebsocket}
+ * - Configure client-only runner communication with {@link layerHttpClientOnly}
+ *   or {@link layerWebsocketClientOnly}
+ * - Use custom route paths with {@link layerHttpOptions},
+ *   {@link layerWebsocketOptions}, {@link layerClientProtocolHttp}, or
+ *   {@link layerClientProtocolWebsocket}
+ *
+ * **Transport 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
+ *   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
+ *
  * @since 4.0.0
  */
 import * as Effect from "../../Effect.ts";
@@ -19,81 +42,133 @@ import type { RunnerStorage } from "./RunnerStorage.ts";
 import * as Sharding from "./Sharding.ts";
 import type * as ShardingConfig from "./ShardingConfig.ts";
 /**
+ * Provides a runner RPC client protocol that connects to runner addresses over
+ * HTTP.
+ *
+ * The configured path is appended to each runner address, and `https` switches
+ * the generated URL from `http` to `https`.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 export declare const layerClientProtocolHttp: (options: {
     readonly path: string;
     readonly https?: boolean | undefined;
 }) => Layer.Layer<RpcClientProtocol, never, RpcSerialization.RpcSerialization | HttpClient.HttpClient>;
 /**
+ * Default HTTP runner client protocol layer using path `/`.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 export declare const layerClientProtocolHttpDefault: Layer.Layer<Runners.RpcClientProtocol, never, RpcSerialization.RpcSerialization | HttpClient.HttpClient>;
 /**
+ * Provides a runner RPC client protocol that connects to runner addresses over
+ * WebSocket.
+ *
+ * The configured path is appended to each runner address, and `https` switches
+ * the generated URL from `ws` to `wss`.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 export declare const layerClientProtocolWebsocket: (options: {
     readonly path: string;
     readonly https?: boolean | undefined;
 }) => Layer.Layer<RpcClientProtocol, never, RpcSerialization.RpcSerialization | Socket.WebSocketConstructor>;
 /**
+ * Default WebSocket runner client protocol layer using path `/`.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 export declare const layerClientProtocolWebsocketDefault: Layer.Layer<Runners.RpcClientProtocol, never, RpcSerialization.RpcSerialization | Socket.WebSocketConstructor>;
 /**
- * @since 4.0.0
+ * Builds an HTTP effect that serves runner RPCs over the HTTP protocol.
+ *
+ * The returned effect is produced from `RunnerServer.layerHandlers` and the
+ * cluster runner RPC group.
+ *
  * @category Http App
+ * @since 4.0.0
  */
 export declare const toHttpEffect: Effect.Effect<Effect.Effect<HttpServerResponse, never, Scope | HttpServerRequest>, never, Scope | RpcSerialization.RpcSerialization | Sharding.Sharding | MessageStorage>;
 /**
- * @since 4.0.0
+ * Builds an HTTP effect that serves runner RPCs over WebSocket.
+ *
+ * The returned effect is produced from `RunnerServer.layerHandlers` and the
+ * cluster runner RPC group.
+ *
  * @category Http App
+ * @since 4.0.0
  */
 export declare const toHttpEffectWebsocket: Effect.Effect<Effect.Effect<HttpServerResponse, never, Scope | HttpServerRequest>, never, Scope | RpcSerialization.RpcSerialization | Sharding.Sharding | MessageStorage>;
 /**
+ * Layer that provides `Sharding` and `Runners` using the configured runner RPC
+ * client protocol and storage services.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 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`.
  *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 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`.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 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.
+ *
+ * It serves runner routes at `/` and configures runner clients to communicate
+ * over HTTP.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 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.
+ *
+ * It configures runner clients to communicate over HTTP without serving runner
+ * HTTP routes.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 export declare const layerHttpClientOnly: Layer.Layer<Sharding.Sharding | Runners.Runners, never, RpcSerialization.RpcSerialization | ShardingConfig.ShardingConfig | HttpClient.HttpClient | MessageStorage | RunnerStorage>;
 /**
+ * Complete WebSocket runner layer.
+ *
+ * It serves runner routes at `/` and configures runner clients to communicate
+ * over WebSocket.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 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.
+ *
+ * It configures runner clients to communicate over WebSocket without serving
+ * runner WebSocket routes.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 export declare const layerWebsocketClientOnly: Layer.Layer<Sharding.Sharding | Runners.Runners, never, ShardingConfig.ShardingConfig | MessageStorage | RunnerStorage | RpcSerialization.RpcSerialization | Socket.WebSocketConstructor>;
 //# sourceMappingURL=HttpRunner.d.ts.map

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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAA;AAEnD,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,KAAK,UAAU,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAEvE,OAAO,KAAK,gBAAgB,MAAM,4BAA4B,CAAA;AAE9D,OAAO,KAAK,MAAM,MAAM,qBAAqB,CAAA;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAE1D;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GAAI,SAAS;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACrC,KAAG,KAAK,CAAC,KAAK,CACb,iBAAiB,EACjB,KAAK,EACL,gBAAgB,CAAC,gBAAgB,GAAG,UAAU,CAAC,UAAU,CAiBxD,CAAA;AAEH;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,EAAE,KAAK,CAAC,KAAK,CACtD,OAAO,CAAC,iBAAiB,EACzB,KAAK,EACL,gBAAgB,CAAC,gBAAgB,GAAG,UAAU,CAAC,UAAU,CACjB,CAAA;AAE1C;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B,GAAI,SAAS;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACrC,KAAG,KAAK,CAAC,KAAK,CACb,iBAAiB,EACjB,KAAK,EACL,gBAAgB,CAAC,gBAAgB,GAAG,MAAM,CAAC,oBAAoB,CAmB9D,CAAA;AAEH;;;;;GAKG;AACH,eAAO,MAAM,mCAAmC,EAAE,KAAK,CAAC,KAAK,CAC3D,OAAO,CAAC,iBAAiB,EACzB,KAAK,EACL,gBAAgB,CAAC,gBAAgB,GAAG,MAAM,CAAC,oBAAoB,CAClB,CAAA;AAE/C;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,CACtC,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,KAAK,EAAE,KAAK,GAAG,iBAAiB,CAAC,EACnE,KAAK,EACL,KAAK,GAAG,gBAAgB,CAAC,gBAAgB,GAAG,QAAQ,CAAC,QAAQ,GAAG,cAAc,CAO9E,CAAA;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,CAC/C,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,KAAK,EAAE,KAAK,GAAG,iBAAiB,CAAC,EACnE,KAAK,EACL,KAAK,GAAG,gBAAgB,CAAC,gBAAgB,GAAG,QAAQ,CAAC,QAAQ,GAAG,cAAc,CAO9E,CAAA;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,KAAK,CACnC,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,EACnC,KAAK,EACL,cAAc,CAAC,cAAc,GAAG,OAAO,CAAC,iBAAiB,GAAG,cAAc,GAAG,aAAa,GAAG,YAAY,CAG1G,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS;IACxC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAA;CACpC,KAAG,KAAK,CAAC,KAAK,CACb,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,EACnC,KAAK,EACH,aAAa,GACb,YAAY,GACZ,gBAAgB,CAAC,gBAAgB,GACjC,cAAc,GACd,cAAc,CAAC,cAAc,GAC7B,OAAO,CAAC,iBAAiB,GACzB,UAAU,CAAC,UAAU,CAItB,CAAA;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS;IAC7C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAA;CACpC,KAAG,KAAK,CAAC,KAAK,CACb,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,EACnC,KAAK,EACH,cAAc,CAAC,cAAc,GAC7B,OAAO,CAAC,iBAAiB,GACzB,cAAc,GACd,aAAa,GACb,YAAY,GACZ,gBAAgB,CAAC,gBAAgB,GACjC,UAAU,CAAC,UAAU,CAItB,CAAA;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,KAAK,CACjC,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,EACnC,KAAK,EACH,gBAAgB,CAAC,gBAAgB,GACjC,cAAc,CAAC,cAAc,GAC7B,UAAU,CAAC,UAAU,GACrB,UAAU,CAAC,UAAU,GACrB,cAAc,GACd,aAAa,GACb,YAAY,CAGf,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,KAAK,CAC3C,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,EACnC,KAAK,EACH,gBAAgB,CAAC,gBAAgB,GACjC,cAAc,CAAC,cAAc,GAC7B,UAAU,CAAC,UAAU,GACrB,cAAc,GACd,aAAa,CAGhB,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,KAAK,CACtC,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,EACnC,KAAK,EACH,gBAAgB,CAAC,gBAAgB,GACjC,cAAc,CAAC,cAAc,GAC7B,MAAM,CAAC,oBAAoB,GAC3B,UAAU,CAAC,UAAU,GACrB,cAAc,GACd,aAAa,GACb,YAAY,CAGf,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,KAAK,CAChD,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,EACnC,KAAK,EACH,cAAc,CAAC,cAAc,GAC7B,cAAc,GACd,aAAa,GACb,gBAAgB,CAAC,gBAAgB,GACjC,MAAM,CAAC,oBAAoB,CAG9B,CAAA"}

package/dist/unstable/cluster/HttpRunner.js

@@ -1,4 +1,27 @@
 /**
+ * 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`.
+ *
+ * **Common tasks**
+ *
+ * - Serve runner RPC routes with {@link layerHttp} or {@link layerWebsocket}
+ * - Configure client-only runner communication with {@link layerHttpClientOnly}
+ *   or {@link layerWebsocketClientOnly}
+ * - Use custom route paths with {@link layerHttpOptions},
+ *   {@link layerWebsocketOptions}, {@link layerClientProtocolHttp}, or
+ *   {@link layerClientProtocolWebsocket}
+ *
+ * **Transport 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
+ *   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
+ *
  * @since 4.0.0
  */
 import * as Effect from "../../Effect.js";
@@ -15,8 +38,14 @@ import { RpcClientProtocol } from "./Runners.js";
 import * as RunnerServer from "./RunnerServer.js";
 import * as Sharding from "./Sharding.js";
 /**
+ * Provides a runner RPC client protocol that connects to runner addresses over
+ * HTTP.
+ *
+ * The configured path is appended to each runner address, and `https` switches
+ * the generated URL from `http` to `https`.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 export const layerClientProtocolHttp = options => Layer.effect(RpcClientProtocol)(Effect.gen(function* () {
   const serialization = yield* RpcSerialization.RpcSerialization;
@@ -28,15 +57,23 @@ export const layerClientProtocolHttp = options => Layer.effect(RpcClientProtocol
   };
 }));
 /**
+ * Default HTTP runner client protocol layer using path `/`.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 export const layerClientProtocolHttpDefault = /*#__PURE__*/layerClientProtocolHttp({
   path: "/"
 });
 /**
+ * Provides a runner RPC client protocol that connects to runner addresses over
+ * WebSocket.
+ *
+ * The configured path is appended to each runner address, and `https` switches
+ * the generated URL from `ws` to `wss`.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 export const layerClientProtocolWebsocket = options => Layer.effect(RpcClientProtocol)(Effect.gen(function* () {
   const serialization = yield* RpcSerialization.RpcSerialization;
@@ -48,15 +85,22 @@ export const layerClientProtocolWebsocket = options => Layer.effect(RpcClientPro
   });
 }));
 /**
+ * Default WebSocket runner client protocol layer using path `/`.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 export const layerClientProtocolWebsocketDefault = /*#__PURE__*/layerClientProtocolWebsocket({
   path: "/"
 });
 /**
- * @since 4.0.0
+ * Builds an HTTP effect that serves runner RPCs over the HTTP protocol.
+ *
+ * The returned effect is produced from `RunnerServer.layerHandlers` and the
+ * cluster runner RPC group.
+ *
  * @category Http App
+ * @since 4.0.0
  */
 export const toHttpEffect = /*#__PURE__*/Effect.gen(function* () {
   const handlers = yield* Layer.build(RunnerServer.layerHandlers);
@@ -66,8 +110,13 @@ export const toHttpEffect = /*#__PURE__*/Effect.gen(function* () {
   }).pipe(Effect.provideContext(handlers));
 });
 /**
- * @since 4.0.0
+ * Builds an HTTP effect that serves runner RPCs over WebSocket.
+ *
+ * The returned effect is produced from `RunnerServer.layerHandlers` and the
+ * cluster runner RPC group.
+ *
  * @category Http App
+ * @since 4.0.0
  */
 export const toHttpEffectWebsocket = /*#__PURE__*/Effect.gen(function* () {
   const handlers = yield* Layer.build(RunnerServer.layerHandlers);
@@ -77,45 +126,71 @@ export const toHttpEffectWebsocket = /*#__PURE__*/Effect.gen(function* () {
   }).pipe(Effect.provideContext(handlers));
 });
 /**
+ * Layer that provides `Sharding` and `Runners` using the configured runner RPC
+ * client protocol and storage services.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 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`.
  *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 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`.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 export const layerWebsocketOptions = options => RunnerServer.layerWithClients.pipe(Layer.provide(RpcServer.layerProtocolWebsocket(options)));
 /**
+ * Complete HTTP runner layer.
+ *
+ * It serves runner routes at `/` and configures runner clients to communicate
+ * over HTTP.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 export const layerHttp = /*#__PURE__*/HttpRouter.serve(layerHttpOptions({
   path: "/"
 })).pipe(/*#__PURE__*/Layer.provide(layerClientProtocolHttpDefault));
 /**
+ * Client-only HTTP runner layer.
+ *
+ * It configures runner clients to communicate over HTTP without serving runner
+ * HTTP routes.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 export const layerHttpClientOnly = /*#__PURE__*/RunnerServer.layerClientOnly.pipe(/*#__PURE__*/Layer.provide(layerClientProtocolHttpDefault));
 /**
+ * Complete WebSocket runner layer.
+ *
+ * It serves runner routes at `/` and configures runner clients to communicate
+ * over WebSocket.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 export const layerWebsocket = /*#__PURE__*/HttpRouter.serve(layerWebsocketOptions({
   path: "/"
 })).pipe(/*#__PURE__*/Layer.provide(layerClientProtocolWebsocketDefault));
 /**
+ * Client-only WebSocket runner layer.
+ *
+ * It configures runner clients to communicate over WebSocket without serving
+ * runner WebSocket routes.
+ *
+ * @category layers
  * @since 4.0.0
- * @category Layers
  */
 export const layerWebsocketClientOnly = /*#__PURE__*/RunnerServer.layerClientOnly.pipe(/*#__PURE__*/Layer.provide(layerClientProtocolWebsocketDefault));
 //# sourceMappingURL=HttpRunner.js.map

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":[]}