effect 4.0.0-beta.65 → 4.0.0-beta.67

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

@@ -1,20 +1,41 @@
 /**
+ * The `MachineId` module provides the branded integer identifier used to
+ * distinguish cluster runners when generating distributed ids and coordinating
+ * runner state.
+ *
+ * **When to use**
+ *
+ * - 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
+ *
+ * **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
+ *
  * @since 4.0.0
  */
 import * as Schema from "../../Schema.ts";
 /**
- * @since 4.0.0
+ * Schema for branded integer machine identifiers used by the cluster.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export declare const MachineId: Schema.brand<Schema.Int, "~effect/cluster/MachineId">;
 /**
- * @since 4.0.0
+ * Branded integer type representing a cluster machine ID.
+ *
  * @category models
+ * @since 4.0.0
  */
 export type MachineId = typeof MachineId.Type;
 /**
- * @since 4.0.0
+ * Brands a number as a `MachineId`.
+ *
  * @category Constructors
+ * @since 4.0.0
  */
 export declare const make: (id: number) => MachineId;
 //# sourceMappingURL=MachineId.d.ts.map

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;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC;;;GAGG;AACH,eAAO,MAAM,SAAS,uDAKrB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAA;AAE7C;;;GAGG;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;;;;;;;;;;;;;;;;;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"}

package/dist/unstable/cluster/MachineId.js

@@ -1,17 +1,36 @@
 /**
+ * The `MachineId` module provides the branded integer identifier used to
+ * distinguish cluster runners when generating distributed ids and coordinating
+ * runner state.
+ *
+ * **When to use**
+ *
+ * - 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
+ *
+ * **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
+ *
  * @since 4.0.0
  */
 import * as Schema from "../../Schema.js";
 /**
- * @since 4.0.0
+ * Schema for branded integer machine identifiers used by the cluster.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export const MachineId = /*#__PURE__*/Schema.Int.pipe(/*#__PURE__*/Schema.brand("~effect/cluster/MachineId"), /*#__PURE__*/Schema.annotate({
   toFormatter: () => machineId => `MachineId(${machineId})`
 }));
 /**
- * @since 4.0.0
+ * Brands a number as a `MachineId`.
+ *
  * @category Constructors
+ * @since 4.0.0
  */
 export const make = id => id;
 //# sourceMappingURL=MachineId.js.map

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;;;AAGA,OAAO,KAAKA,MAAM,MAAM,iBAAiB;AAEzC;;;;AAIA,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;AAQD;;;;AAIA,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;;;;;;;;;;;;;;;;;;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":[]}

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

@@ -1,4 +1,28 @@
 /**
+ * The cluster `Message` module defines the in-memory shapes used while moving
+ * requests and control envelopes between callers, durable storage, transports,
+ * and entity runners.
+ *
+ * **Common use cases**
+ *
+ * - Representing outgoing entity requests before they are stored or sent
+ * - Reconstructing incoming requests that runners read from storage or transport
+ * - Converting outgoing messages into local, in-process deliveries
+ * - Serializing request payloads with the associated RPC schema and context
+ * - Passing control envelopes such as acknowledgements and interrupts through
+ *   without payload decoding
+ *
+ * **Gotchas**
+ *
+ * - Requests can exist in decoded local form or encoded persisted form; choose
+ *   `IncomingLocal` / `OutgoingRequest` for local delivery and `IncomingRequest`
+ *   / `Envelope.PartialRequest` for storage or transport boundaries.
+ * - Request payloads must be encoded and decoded with the matching RPC payload
+ *   schema and service context, otherwise failures are surfaced as
+ *   `MalformedMessage`.
+ * - Delivery state such as the last sent or received reply is carried alongside
+ *   messages so retries and persisted replies can preserve cluster semantics.
+ *
  * @since 4.0.0
  */
 import * as Context from "../../Context.ts";
@@ -12,26 +36,46 @@ import * as Envelope from "./Envelope.ts";
 import type * as Reply from "./Reply.ts";
 import type { Snowflake } from "./Snowflake.ts";
 /**
- * @since 4.0.0
+ * Message read by a runner from storage or transport.
+ *
+ * An incoming message is either a persisted request with an encoded payload or an
+ * incoming control envelope.
+ *
  * @category incoming
+ * @since 4.0.0
  */
 export type Incoming<R extends Rpc.Any> = IncomingRequest<R> | IncomingEnvelope;
 /**
- * @since 4.0.0
+ * Locally decoded incoming message for in-process delivery.
+ *
+ * It is either a request with a decoded payload or an incoming control envelope.
+ *
  * @category incoming
+ * @since 4.0.0
  */
 export type IncomingLocal<R extends Rpc.Any> = IncomingRequestLocal<R> | IncomingEnvelope;
 /**
- * @since 4.0.0
+ * Converts an outgoing message into a locally deliverable incoming message.
+ *
+ * Request messages keep their decoded payload and response callback, while
+ * control envelopes are wrapped as incoming envelopes.
+ *
  * @category incoming
+ * @since 4.0.0
  */
 export declare const incomingLocalFromOutgoing: <R extends Rpc.Any>(self: Outgoing<R>) => IncomingLocal<R>;
 declare const IncomingRequest_base: new <A extends Record<string, any> = {}>(args: import("../../Types.ts").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => Readonly<A> & {
     readonly _tag: "IncomingRequest";
 } & import("../../Pipeable.ts").Pipeable;
 /**
- * @since 4.0.0
+ * Incoming persisted request whose payload has not yet been decoded with the RPC
+ * schema.
+ *
+ * It carries the last reply that was sent and a callback for persisting encoded
+ * replies.
+ *
  * @category incoming
+ * @since 4.0.0
  */
 export declare class IncomingRequest<R extends Rpc.Any> extends IncomingRequest_base<{
     readonly envelope: Envelope.PartialRequest;
@@ -43,8 +87,13 @@ declare const IncomingRequestLocal_base: new <A extends Record<string, any> = {}
     readonly _tag: "IncomingRequestLocal";
 } & import("../../Pipeable.ts").Pipeable;
 /**
- * @since 4.0.0
+ * Incoming request for local delivery with a decoded payload.
+ *
+ * It includes dynamic annotations, the last sent reply, and a callback for
+ * replying with decoded replies.
+ *
  * @category outgoing
+ * @since 4.0.0
  */
 export declare class IncomingRequestLocal<R extends Rpc.Any> extends IncomingRequestLocal_base<{
     readonly envelope: Envelope.Request<R>;
@@ -57,8 +106,10 @@ declare const IncomingEnvelope_base: new <A extends Record<string, any> = {}>(ar
     readonly _tag: "IncomingEnvelope";
 } & import("../../Pipeable.ts").Pipeable;
 /**
- * @since 4.0.0
+ * Incoming control envelope carrying an `AckChunk` or `Interrupt`.
+ *
  * @category incoming
+ * @since 4.0.0
  */
 export declare class IncomingEnvelope extends IncomingEnvelope_base<{
     readonly _tag: "IncomingEnvelope";
@@ -66,16 +117,25 @@ export declare class IncomingEnvelope extends IncomingEnvelope_base<{
 }> {
 }
 /**
- * @since 4.0.0
+ * Message produced for storage or transport.
+ *
+ * An outgoing message is either an entity request or a control envelope.
+ *
  * @category outgoing
+ * @since 4.0.0
  */
 export type Outgoing<R extends Rpc.Any> = OutgoingRequest<R> | OutgoingEnvelope;
 declare const OutgoingRequest_base: new <A extends Record<string, any> = {}>(args: import("../../Types.ts").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => Readonly<A> & {
     readonly _tag: "OutgoingRequest";
 } & import("../../Pipeable.ts").Pipeable;
 /**
- * @since 4.0.0
+ * Outgoing entity request with decoded payload and RPC metadata.
+ *
+ * It carries the service context used for serialization, the last received reply,
+ * the reply callback, dynamic annotations, and an optional encoded request cache.
+ *
  * @category outgoing
+ * @since 4.0.0
  */
 export declare class OutgoingRequest<R extends Rpc.Any> extends OutgoingRequest_base<{
     readonly envelope: Envelope.Request<R>;
@@ -86,6 +146,8 @@ export declare class OutgoingRequest<R extends Rpc.Any> extends OutgoingRequest_
     readonly annotations: Context.Context<never>;
 }> {
     /**
+     * Cached encoded envelope payload reused when sending the request.
+     *
      * @since 4.0.0
      */
     encodedCache?: Envelope.PartialRequest;
@@ -94,14 +156,21 @@ declare const OutgoingEnvelope_base: new <A extends Record<string, any> = {}>(ar
     readonly _tag: "OutgoingEnvelope";
 } & import("../../Pipeable.ts").Pipeable;
 /**
- * @since 4.0.0
+ * Outgoing control envelope paired with RPC metadata.
+ *
+ * Use `OutgoingEnvelope.interrupt` to construct an interrupt envelope for an
+ * in-flight request.
+ *
  * @category outgoing
+ * @since 4.0.0
  */
 export declare class OutgoingEnvelope extends OutgoingEnvelope_base<{
     readonly envelope: Envelope.AckChunk | Envelope.Interrupt;
     readonly rpc: Rpc.AnyWithProps;
 }> {
     /**
+     * Creates an outgoing interrupt envelope for the supplied request.
+     *
      * @since 4.0.0
      */
     static interrupt(options: {
@@ -111,23 +180,43 @@ export declare class OutgoingEnvelope extends OutgoingEnvelope_base<{
     }): OutgoingEnvelope;
 }
 /**
- * @since 4.0.0
+ * Serializes an outgoing message into a partial envelope.
+ *
+ * Control envelopes pass through unchanged. Requests are encoded with their RPC
+ * payload schema, reusing the cached encoded request when available.
+ *
  * @category serialization / deserialization
+ * @since 4.0.0
  */
 export declare const serialize: <Rpc extends Rpc.Any>(message: Outgoing<Rpc>) => Effect.Effect<Envelope.Partial, MalformedMessage>;
 /**
- * @since 4.0.0
+ * Serializes an outgoing message into its JSON envelope representation.
+ *
+ * Schema encoding failures are converted to `MalformedMessage`.
+ *
  * @category serialization / deserialization
+ * @since 4.0.0
  */
 export declare const serializeEnvelope: <Rpc extends Rpc.Any>(message: Outgoing<Rpc>) => Effect.Effect<Envelope.Encoded, MalformedMessage, never>;
 /**
- * @since 4.0.0
+ * Encodes the payload of an `OutgoingRequest` with the request's RPC payload
+ * schema and service context.
+ *
+ * The result is a `PartialRequest` suitable for storage or transport.
+ *
  * @category serialization / deserialization
+ * @since 4.0.0
  */
 export declare const serializeRequest: <Rpc extends Rpc.Any>(self: OutgoingRequest<Rpc>) => Effect.Effect<Envelope.PartialRequest, MalformedMessage>;
 /**
- * @since 4.0.0
+ * Decodes a partial envelope back into a locally deliverable incoming message.
+ *
+ * Control envelopes pass through directly. Request envelopes require the original
+ * `OutgoingRequest` so the payload can be decoded with the correct RPC schema and
+ * context.
+ *
  * @category serialization / deserialization
+ * @since 4.0.0
  */
 export declare const deserializeLocal: <Rpc extends Rpc.Any>(self: Outgoing<Rpc>, encoded: Envelope.Partial) => Effect.Effect<IncomingLocal<Rpc>, MalformedMessage>;
 export {};

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

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

package/dist/unstable/cluster/Message.js

@@ -1,4 +1,28 @@
 /**
+ * The cluster `Message` module defines the in-memory shapes used while moving
+ * requests and control envelopes between callers, durable storage, transports,
+ * and entity runners.
+ *
+ * **Common use cases**
+ *
+ * - Representing outgoing entity requests before they are stored or sent
+ * - Reconstructing incoming requests that runners read from storage or transport
+ * - Converting outgoing messages into local, in-process deliveries
+ * - Serializing request payloads with the associated RPC schema and context
+ * - Passing control envelopes such as acknowledgements and interrupts through
+ *   without payload decoding
+ *
+ * **Gotchas**
+ *
+ * - Requests can exist in decoded local form or encoded persisted form; choose
+ *   `IncomingLocal` / `OutgoingRequest` for local delivery and `IncomingRequest`
+ *   / `Envelope.PartialRequest` for storage or transport boundaries.
+ * - Request payloads must be encoded and decoded with the matching RPC payload
+ *   schema and service context, otherwise failures are surfaced as
+ *   `MalformedMessage`.
+ * - Delivery state such as the last sent or received reply is carried alongside
+ *   messages so retries and persisted replies can preserve cluster semantics.
+ *
  * @since 4.0.0
  */
 import * as Context from "../../Context.js";
@@ -11,8 +35,13 @@ import { MalformedMessage } from "./ClusterError.js";
 import * as ClusterSchema from "./ClusterSchema.js";
 import * as Envelope from "./Envelope.js";
 /**
- * @since 4.0.0
+ * Converts an outgoing message into a locally deliverable incoming message.
+ *
+ * Request messages keep their decoded payload and response callback, while
+ * control envelopes are wrapped as incoming envelopes.
+ *
  * @category incoming
+ * @since 4.0.0
  */
 export const incomingLocalFromOutgoing = self => {
   if (self._tag === "OutgoingEnvelope") {
@@ -28,36 +57,63 @@ export const incomingLocalFromOutgoing = self => {
   });
 };
 /**
- * @since 4.0.0
+ * Incoming persisted request whose payload has not yet been decoded with the RPC
+ * schema.
+ *
+ * It carries the last reply that was sent and a callback for persisting encoded
+ * replies.
+ *
  * @category incoming
+ * @since 4.0.0
  */
 export class IncomingRequest extends /*#__PURE__*/Data.TaggedClass("IncomingRequest") {}
 /**
- * @since 4.0.0
+ * Incoming request for local delivery with a decoded payload.
+ *
+ * It includes dynamic annotations, the last sent reply, and a callback for
+ * replying with decoded replies.
+ *
  * @category outgoing
+ * @since 4.0.0
  */
 export class IncomingRequestLocal extends /*#__PURE__*/Data.TaggedClass("IncomingRequestLocal") {}
 /**
- * @since 4.0.0
+ * Incoming control envelope carrying an `AckChunk` or `Interrupt`.
+ *
  * @category incoming
+ * @since 4.0.0
  */
 export class IncomingEnvelope extends /*#__PURE__*/Data.TaggedClass("IncomingEnvelope") {}
 /**
- * @since 4.0.0
+ * Outgoing entity request with decoded payload and RPC metadata.
+ *
+ * It carries the service context used for serialization, the last received reply,
+ * the reply callback, dynamic annotations, and an optional encoded request cache.
+ *
  * @category outgoing
+ * @since 4.0.0
  */
 export class OutgoingRequest extends /*#__PURE__*/Data.TaggedClass("OutgoingRequest") {
   /**
+   * Cached encoded envelope payload reused when sending the request.
+   *
    * @since 4.0.0
    */
   encodedCache;
 }
 /**
- * @since 4.0.0
+ * Outgoing control envelope paired with RPC metadata.
+ *
+ * Use `OutgoingEnvelope.interrupt` to construct an interrupt envelope for an
+ * in-flight request.
+ *
  * @category outgoing
+ * @since 4.0.0
  */
 export class OutgoingEnvelope extends /*#__PURE__*/Data.TaggedClass("OutgoingEnvelope") {
   /**
+   * Creates an outgoing interrupt envelope for the supplied request.
+   *
    * @since 4.0.0
    */
   static interrupt(options) {
@@ -73,8 +129,13 @@ const neverRpc = /*#__PURE__*/Rpc.make("Never", {
   payload: {}
 });
 /**
- * @since 4.0.0
+ * Serializes an outgoing message into a partial envelope.
+ *
+ * Control envelopes pass through unchanged. Requests are encoded with their RPC
+ * payload schema, reusing the cached encoded request when available.
+ *
  * @category serialization / deserialization
+ * @since 4.0.0
  */
 export const serialize = message => {
   if (message._tag !== "OutgoingRequest") {
@@ -83,13 +144,22 @@ export const serialize = message => {
   return Effect.suspend(() => message.encodedCache ? Effect.succeed(message.encodedCache) : serializeRequest(message));
 };
 /**
- * @since 4.0.0
+ * Serializes an outgoing message into its JSON envelope representation.
+ *
+ * Schema encoding failures are converted to `MalformedMessage`.
+ *
  * @category serialization / deserialization
+ * @since 4.0.0
  */
 export const serializeEnvelope = message => Effect.flatMap(serialize(message), envelope => MalformedMessage.refail(Schema.encodeEffect(Envelope.PartialJson)(envelope)));
 /**
- * @since 4.0.0
+ * Encodes the payload of an `OutgoingRequest` with the request's RPC payload
+ * schema and service context.
+ *
+ * The result is a `PartialRequest` suitable for storage or transport.
+ *
  * @category serialization / deserialization
+ * @since 4.0.0
  */
 export const serializeRequest = self => {
   const rpc = self.rpc;
@@ -99,8 +169,14 @@ export const serializeRequest = self => {
   })));
 };
 /**
- * @since 4.0.0
+ * Decodes a partial envelope back into a locally deliverable incoming message.
+ *
+ * Control envelopes pass through directly. Request envelopes require the original
+ * `OutgoingRequest` so the payload can be decoded with the correct RPC schema and
+ * context.
+ *
  * @category serialization / deserialization
+ * @since 4.0.0
  */
 export const deserializeLocal = (self, encoded) => {
   if (encoded._tag !== "Request") {

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

@@ -1 +1 @@
-{"version":3,"file":"Message.js","names":["Context","Data","Effect","Option","Schema","Rpc","MalformedMessage","ClusterSchema","Envelope","incomingLocalFromOutgoing","self","_tag","IncomingEnvelope","envelope","IncomingRequestLocal","annotations","get","rpc","Dynamic","respond","lastSentReply","none","IncomingRequest","TaggedClass","OutgoingRequest","encodedCache","OutgoingEnvelope","interrupt","options","Interrupt","neverRpc","make","success","Never","error","payload","serialize","message","succeed","suspend","serializeRequest","serializeEnvelope","flatMap","refail","encodeEffect","PartialJson","toCodecJson","payloadSchema","pipe","provideContext","context","map","deserializeLocal","encoded","fail","cause","Error","decodeEffect","makeRequest"],"sources":["../../../src/unstable/cluster/Message.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAGA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,IAAI,MAAM,eAAe;AACrC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,GAAG,MAAM,eAAe;AAEpC,SAASC,gBAAgB,QAAQ,mBAAmB;AACpD,OAAO,KAAKC,aAAa,MAAM,oBAAoB;AAEnD,OAAO,KAAKC,QAAQ,MAAM,eAAe;AAgBzC;;;;AAIA,OAAO,MAAMC,yBAAyB,GAAuBC,IAAiB,IAAsB;EAClG,IAAIA,IAAI,CAACC,IAAI,KAAK,kBAAkB,EAAE;IACpC,OAAO,IAAIC,gBAAgB,CAAC;MAAEC,QAAQ,EAAEH,IAAI,CAACG;IAAQ,CAAE,CAAC;EAC1D;EACA,OAAO,IAAIC,oBAAoB,CAAC;IAC9BC,WAAW,EAAEf,OAAO,CAACgB,GAAG,CAACN,IAAI,CAACO,GAAG,CAACF,WAAW,EAAER,aAAa,CAACW,OAAO,CAAC,CACnER,IAAI,CAACO,GAAG,CAACF,WAAW,EACpBL,IAAI,CAACG,QAAe,CACrB;IACDA,QAAQ,EAAEH,IAAI,CAACG,QAAQ;IACvBM,OAAO,EAAET,IAAI,CAACS,OAAO;IACrBC,aAAa,EAAEjB,MAAM,CAACkB,IAAI;GAC3B,CAAC;AACJ,CAAC;AAED;;;;AAIA,OAAM,MAAOC,eAAmC,sBAAQrB,IAAI,CAACsB,WAAW,CAAC,iBAAiB,CAIxF;AAEF;;;;AAIA,OAAM,MAAOT,oBAAwC,sBAAQb,IAAI,CAACsB,WAAW,CAAC,sBAAsB,CAKlG;AAEF;;;;AAIA,OAAM,MAAOX,gBAAiB,sBAAQX,IAAI,CAACsB,WAAW,CAAC,kBAAkB,CAGvE;AAQF;;;;AAIA,OAAM,MAAOC,eAAmC,sBAAQvB,IAAI,CAACsB,WAAW,CAAC,iBAAiB,CAOxF;EACA;;;EAGOE,YAAY;;AAGrB;;;;AAIA,OAAM,MAAOC,gBAAiB,sBAAQzB,IAAI,CAACsB,WAAW,CAAC,kBAAkB,CAGvE;EACA;;;EAGA,OAAOI,SAASA,CAACC,OAIhB;IACC,OAAO,IAAIF,gBAAgB,CAAC;MAC1Bb,QAAQ,EAAE,IAAIL,QAAQ,CAACqB,SAAS,CAACD,OAAO,CAAC;MACzCX,GAAG,EAAEa;KACN,CAAC;EACJ;;AAGF,MAAMA,QAAQ,gBAAGzB,GAAG,CAAC0B,IAAI,CAAC,OAAO,EAAE;EACjCC,OAAO,EAAE5B,MAAM,CAAC6B,KAAY;EAC5BC,KAAK,EAAE9B,MAAM,CAAC6B,KAAK;EACnBE,OAAO,EAAE;CACV,CAAC;AAEF;;;;AAIA,OAAO,MAAMC,SAAS,GACpBC,OAAsB,IAC+B;EACrD,IAAIA,OAAO,CAAC1B,IAAI,KAAK,iBAAiB,EAAE;IACtC,OAAOT,MAAM,CAACoC,OAAO,CAACD,OAAO,CAACxB,QAAQ,CAAC;EACzC;EACA,OAAOX,MAAM,CAACqC,OAAO,CAAC,MACpBF,OAAO,CAACZ,YAAY,GAChBvB,MAAM,CAACoC,OAAO,CAACD,OAAO,CAACZ,YAAY,CAAC,GACpCe,gBAAgB,CAACH,OAAO,CAAC,CAC9B;AACH,CAAC;AAED;;;;AAIA,OAAO,MAAMI,iBAAiB,GAC5BJ,OAAsB,IAEtBnC,MAAM,CAACwC,OAAO,CACZN,SAAS,CAACC,OAAO,CAAC,EACjBxB,QAAQ,IAAKP,gBAAgB,CAACqC,MAAM,CAACvC,MAAM,CAACwC,YAAY,CAACpC,QAAQ,CAACqC,WAAW,CAAC,CAAChC,QAAQ,CAAC,CAAC,CAC3F;AAEH;;;;AAIA,OAAO,MAAM2B,gBAAgB,GAC3B9B,IAA0B,IACkC;EAC5D,MAAMO,GAAG,GAAGP,IAAI,CAACO,GAA8B;EAC/C,OAAOb,MAAM,CAACwC,YAAY,CAACxC,MAAM,CAAC0C,WAAW,CAAC7B,GAAG,CAAC8B,aAAa,CAAC,CAAC,CAACrC,IAAI,CAACG,QAAQ,CAACsB,OAAO,CAAC,CAACa,IAAI,CAC3F9C,MAAM,CAAC+C,cAAc,CAACvC,IAAI,CAACwC,OAAO,CAAC,EACnC5C,gBAAgB,CAACqC,MAAM,EACvBzC,MAAM,CAACiD,GAAG,CAAEhB,OAAO,KAAM;IACvB,GAAGzB,IAAI,CAACG,QAAQ;IAChBsB;GACD,CAAC,CAAC,CAC+D;AACtE,CAAC;AAED;;;;AAIA,OAAO,MAAMiB,gBAAgB,GAAGA,CAC9B1C,IAAmB,EACnB2C,OAAyB,KAIvB;EACF,IAAIA,OAAO,CAAC1C,IAAI,KAAK,SAAS,EAAE;IAC9B,OAAOT,MAAM,CAACoC,OAAO,CAAC,IAAI1B,gBAAgB,CAAC;MAAEC,QAAQ,EAAEwC;IAAO,CAAE,CAAC,CAAC;EACpE,CAAC,MAAM,IAAI3C,IAAI,CAACC,IAAI,KAAK,iBAAiB,EAAE;IAC1C,OAAOT,MAAM,CAACoD,IAAI,CAChB,IAAIhD,gBAAgB,CAAC;MAAEiD,KAAK,EAAE,IAAIC,KAAK,CAAC,gEAAgE;IAAC,CAAE,CAAC,CAC7G;EACH;EACA,MAAMvC,GAAG,GAAGP,IAAI,CAACO,GAA8B;EAC/C,OAAOb,MAAM,CAACqD,YAAY,CAACrD,MAAM,CAAC0C,WAAW,CAAC7B,GAAG,CAAC8B,aAAa,CAAC,CAAC,CAACM,OAAO,CAAClB,OAAO,CAAC,CAACa,IAAI,CACrF9C,MAAM,CAAC+C,cAAc,CAACvC,IAAI,CAACwC,OAAO,CAAC,EACnC5C,gBAAgB,CAACqC,MAAM,EACvBzC,MAAM,CAACiD,GAAG,CAAEhB,OAAO,IAAI;IACrB,MAAMtB,QAAQ,GAAGL,QAAQ,CAACkD,WAAW,CAAC;MACpC,GAAGL,OAAO;MACVlB;KACM,CAA0B;IAClC,OAAO,IAAIrB,oBAAoB,CAAC;MAC9BD,QAAQ;MACRO,aAAa,EAAEjB,MAAM,CAACkB,IAAI,EAAE;MAC5BF,OAAO,EAAET,IAAI,CAACS,OAAO;MACrBJ,WAAW,EAAEf,OAAO,CAACgB,GAAG,CAACC,GAAG,CAACF,WAAW,EAAER,aAAa,CAACW,OAAO,CAAC,CAC9DD,GAAG,CAACF,WAAW,EACfF,QAAe;KAElB,CAAC;EACJ,CAAC,CAAC,CAC2D;AACjE,CAAC","ignoreList":[]}
+{"version":3,"file":"Message.js","names":["Context","Data","Effect","Option","Schema","Rpc","MalformedMessage","ClusterSchema","Envelope","incomingLocalFromOutgoing","self","_tag","IncomingEnvelope","envelope","IncomingRequestLocal","annotations","get","rpc","Dynamic","respond","lastSentReply","none","IncomingRequest","TaggedClass","OutgoingRequest","encodedCache","OutgoingEnvelope","interrupt","options","Interrupt","neverRpc","make","success","Never","error","payload","serialize","message","succeed","suspend","serializeRequest","serializeEnvelope","flatMap","refail","encodeEffect","PartialJson","toCodecJson","payloadSchema","pipe","provideContext","context","map","deserializeLocal","encoded","fail","cause","Error","decodeEffect","makeRequest"],"sources":["../../../src/unstable/cluster/Message.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}