@efffrida/rpc 0.0.14 → 0.0.15

package/dist/node/FridaRpcServer.js

@@ -0,0 +1,115 @@
+/**
+ * Implements a Frida RPC server protocol for effect using the frida script
+ * exports.
+ *
+ * @since 1.0.0
+ */
+import * as RpcMessage from "@effect/rpc/RpcMessage";
+import * as RpcSerialization from "@effect/rpc/RpcSerialization";
+import * as RpcServer from "@effect/rpc/RpcServer";
+import * as FridaScript from "@efffrida/frida-tools/FridaScript";
+import * as Console from "effect/Console";
+import * as Effect from "effect/Effect";
+import * as Function from "effect/Function";
+import * as Mailbox from "effect/Mailbox";
+import * as Option from "effect/Option";
+import * as Predicate from "effect/Predicate";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+import * as String from "effect/String";
+import * as Tuple from "effect/Tuple";
+import * as constants from "../shared/constants.js";
+import * as predicates from "../shared/predicates.js";
+/**
+ * @since 1.0.0
+ * @category Protocol
+ */
+export const makeProtocolFrida = () => Effect.gen(function* () {
+  const encoder = new TextEncoder();
+  const script = yield* FridaScript.FridaScript;
+  const serialization = yield* RpcSerialization.RpcSerialization;
+  let clientId = 0;
+  const clientIds = new Set();
+  const parser = serialization.unsafeMake();
+  const disconnects = yield* Mailbox.make();
+  let writeRequest;
+  // Listen for new clients
+  yield* script.stream.pipe(Stream.filterMap(({
+    message
+  }) => {
+    if (predicates.newClientPredicate(message)) {
+      const stripPrefix = String.replace(constants.nodeRpcClientConnectionRequestMessagePrefix, "");
+      return Option.some(stripPrefix(message));
+    } else {
+      return Option.none();
+    }
+  }), Stream.runForEach(exportName => {
+    const id = clientId++;
+    clientIds.add(id);
+    return script.callExport(exportName, Schema.Void)(clientId++);
+  }), Stream.tapError(Console.error), Stream.runDrain, Effect.forkScoped);
+  // Listen for messages from connected clients
+  yield* script.stream.pipe(Stream.filterMap(({
+    data: maybeData,
+    message
+  }) => {
+    if (predicates.isTaggedForAnyClient(message)) {
+      return Option.map(maybeData, data => Tuple.make(message.clientId, data));
+    } else {
+      return Option.none();
+    }
+  }), Stream.runForEach(([clientId, data]) => {
+    try {
+      const decoded = parser.decode(data);
+      if (decoded.length === 0) return Effect.void;
+      let i = 0;
+      return Effect.whileLoop({
+        while: () => i < decoded.length,
+        body() {
+          const message = decoded[i++];
+          return writeRequest(clientId, message);
+        },
+        step: Function.constVoid
+      });
+    } catch (cause) {
+      return Effect.sync(() => {
+        const encoded = parser.encode(RpcMessage.ResponseDefectEncoded(cause));
+        const transformed = typeof encoded === "string" ? encoder.encode(encoded) : encoded;
+        script.script.post({
+          clientId
+        }, Buffer.from(transformed));
+      });
+    }
+  }), Stream.tapError(Console.error), Stream.runDrain, Effect.forkScoped);
+  return yield* RpcServer.Protocol.make(_writeRequest => {
+    writeRequest = _writeRequest;
+    return Effect.succeed({
+      disconnects,
+      send: (clientId, response) => {
+        const writeRaw = data => {
+          const transformed = typeof data === "string" ? encoder.encode(data) : data;
+          script.script.post({
+            clientId
+          }, Buffer.from(transformed));
+          return Effect.void;
+        };
+        try {
+          const encoded = parser.encode(response);
+          if (Predicate.isNotUndefined(encoded)) return writeRaw(encoded);else return Effect.void;
+        } catch (cause) {
+          const encoded = parser.encode(RpcMessage.ResponseDefectEncoded(cause));
+          return writeRaw(encoded);
+        }
+      },
+      end(_clientId) {
+        return Effect.void;
+      },
+      clientIds: Effect.sync(() => clientIds),
+      initialMessage: Effect.succeedNone,
+      supportsAck: true,
+      supportsTransferables: false,
+      supportsSpanPropagation: true
+    });
+  });
+});
+//# sourceMappingURL=FridaRpcServer.js.map

package/dist/node/FridaRpcServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FridaRpcServer.js","names":["RpcMessage","RpcSerialization","RpcServer","FridaScript","Console","Effect","Function","Mailbox","Option","Predicate","Schema","Stream","String","Tuple","constants","predicates","makeProtocolFrida","gen","encoder","TextEncoder","script","serialization","clientId","clientIds","Set","parser","unsafeMake","disconnects","make","writeRequest","stream","pipe","filterMap","message","newClientPredicate","stripPrefix","replace","nodeRpcClientConnectionRequestMessagePrefix","some","none","runForEach","exportName","id","add","callExport","Void","tapError","error","runDrain","forkScoped","data","maybeData","isTaggedForAnyClient","map","decoded","decode","length","void","i","whileLoop","while","body","step","constVoid","cause","sync","encoded","encode","ResponseDefectEncoded","transformed","post","Buffer","from","Protocol","_writeRequest","succeed","send","response","writeRaw","isNotUndefined","end","_clientId","initialMessage","succeedNone","supportsAck","supportsTransferables","supportsSpanPropagation"],"sources":["../../src/node/FridaRpcServer.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/node/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @since 1.0.0
+ */
+/**
+ * Implements a Frida RPC client protocol for effect using the frida script
+ * exports.
+ *
+ * @since 1.0.0
+ */
+export * as FridaRpcClient from "./FridaRpcClient.ts";
+/**
+ * Implements a Frida RPC server protocol for effect using the frida script
+ * exports.
+ *
+ * @since 1.0.0
+ */
+export * as FridaRpcServer from "./FridaRpcServer.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;;;;GAKG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA"}

package/dist/{dts/index.d.ts → node/index.js}

@@ -1,17 +1,18 @@
+/**
+ * @since 1.0.0
+ */
 /**
  * Implements a Frida RPC client protocol for effect using the frida script
- * exports. The reason we don't use the send/recv script channels is because
- * those are shared channels by everybody.
+ * exports.
  *
  * @since 1.0.0
  */
 export * as FridaRpcClient from "./FridaRpcClient.js";
 /**
  * Implements a Frida RPC server protocol for effect using the frida script
- * exports. The reason we don't use the send/recv script channels is because
- * those are shared channels by everybody.
+ * exports.
  *
  * @since 1.0.0
  */
 export * as FridaRpcServer from "./FridaRpcServer.js";
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["FridaRpcClient","FridaRpcServer"],"sources":["../../src/node/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAIA;;;;;;AAMA,OAAO,KAAKA,cAAc,MAAM,qBAAqB;AAErD;;;;;;AAMA,OAAO,KAAKC,cAAc,MAAM,qBAAqB","ignoreList":[]}

package/dist/shared/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const defaultServerMainExportName = "rpc";
+export declare const generateServerExportNameForClient: (clientId: number) => string;
+export declare const generateClientCallbackExportNameForServer: () => string;
+export declare const nodeRpcClientConnectionRequestMessagePrefix = "client id request message";
+export declare const nodeRpcClientMakeConnectionRequestForServer: (exportName: string) => string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/shared/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,QAAQ,CAAC;AACjD,eAAO,MAAM,iCAAiC,GAAI,UAAU,MAAM,KAAG,MACN,CAAC;AAGhE,eAAO,MAAM,yCAAyC,QAAO,MACY,CAAC;AAE1E,eAAO,MAAM,2CAA2C,8BAA8B,CAAC;AACvF,eAAO,MAAM,2CAA2C,GAAI,YAAY,MAAM,WACZ,CAAC"}

package/dist/shared/constants.js

@@ -0,0 +1,7 @@
+export const defaultServerMainExportName = "rpc";
+export const generateServerExportNameForClient = clientId => `@efffrida/rpc/FridaServerRpcListenerForClient/${clientId}`;
+let exportIdForClientCallback = 0;
+export const generateClientCallbackExportNameForServer = () => `@efffrida/rpc/FridaClientRpcCallback/${exportIdForClientCallback++}`;
+export const nodeRpcClientConnectionRequestMessagePrefix = "client id request message";
+export const nodeRpcClientMakeConnectionRequestForServer = exportName => `${nodeRpcClientConnectionRequestMessagePrefix}:${exportName}`;
+//# sourceMappingURL=constants.js.map

package/dist/shared/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","names":["defaultServerMainExportName","generateServerExportNameForClient","clientId","exportIdForClientCallback","generateClientCallbackExportNameForServer","nodeRpcClientConnectionRequestMessagePrefix","nodeRpcClientMakeConnectionRequestForServer","exportName"],"sources":["../../src/shared/constants.ts"],"sourcesContent":[null],"mappings":"AAAA,OAAO,MAAMA,2BAA2B,GAAG,KAAK;AAChD,OAAO,MAAMC,iCAAiC,GAAIC,QAAgB,IAC9D,iDAAiDA,QAAQ,EAAE;AAE/D,IAAIC,yBAAyB,GAAW,CAAC;AACzC,OAAO,MAAMC,yCAAyC,GAAGA,CAAA,KACrD,wCAAwCD,yBAAyB,EAAE,EAAE;AAEzE,OAAO,MAAME,2CAA2C,GAAG,2BAA2B;AACtF,OAAO,MAAMC,2CAA2C,GAAIC,UAAkB,IAC1E,GAAGF,2CAA2C,IAAIE,UAAU,EAAE","ignoreList":[]}

package/dist/shared/predicates.d.ts

@@ -0,0 +1,10 @@
+import * as Predicate from "effect/Predicate";
+export declare const isClientId: (clientId: number) => Predicate.Refinement<unknown, number>;
+export declare const isTaggedForClient: (clientId: number) => Predicate.Refinement<unknown, {
+    readonly clientId: number;
+}>;
+export declare const isTaggedForAnyClient: Predicate.Refinement<unknown, {
+    readonly clientId: number;
+}>;
+export declare const newClientPredicate: Predicate.Refinement<unknown, string>;
+//# sourceMappingURL=predicates.d.ts.map

package/dist/shared/predicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.d.ts","sourceRoot":"","sources":["../../src/shared/predicates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAC;AAK9C,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,0CAAmE,CAAC;AAE/G,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM;;EAC8C,CAAC;AAEjG,eAAO,MAAM,oBAAoB;;EAGhC,CAAC;AAEF,eAAO,MAAM,kBAAkB,uCAG9B,CAAC"}

package/dist/shared/predicates.js

@@ -0,0 +1,12 @@
+import * as Predicate from "effect/Predicate";
+import * as String from "effect/String";
+import * as constants from "./constants.js";
+export const isClientId = clientId => Predicate.compose(Predicate.isNumber, id => id === clientId);
+export const isTaggedForClient = clientId => Predicate.compose(Predicate.isUnknown, Predicate.struct({
+  clientId: isClientId(clientId)
+}));
+export const isTaggedForAnyClient = /*#__PURE__*/Predicate.compose(Predicate.isUnknown, /*#__PURE__*/Predicate.struct({
+  clientId: Predicate.isNumber
+}));
+export const newClientPredicate = /*#__PURE__*/Predicate.compose(Predicate.isString, /*#__PURE__*/String.startsWith(constants.nodeRpcClientConnectionRequestMessagePrefix));
+//# sourceMappingURL=predicates.js.map

package/dist/shared/predicates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.js","names":["Predicate","String","constants","isClientId","clientId","compose","isNumber","id","isTaggedForClient","isUnknown","struct","isTaggedForAnyClient","newClientPredicate","isString","startsWith","nodeRpcClientConnectionRequestMessagePrefix"],"sources":["../../src/shared/predicates.ts"],"sourcesContent":[null],"mappings":"AAAA,OAAO,KAAKA,SAAS,MAAM,kBAAkB;AAC7C,OAAO,KAAKC,MAAM,MAAM,eAAe;AAEvC,OAAO,KAAKC,SAAS,MAAM,gBAAgB;AAE3C,OAAO,MAAMC,UAAU,GAAIC,QAAgB,IAAKJ,SAAS,CAACK,OAAO,CAACL,SAAS,CAACM,QAAQ,EAAGC,EAAE,IAAKA,EAAE,KAAKH,QAAQ,CAAC;AAE9G,OAAO,MAAMI,iBAAiB,GAAIJ,QAAgB,IAC9CJ,SAAS,CAACK,OAAO,CAACL,SAAS,CAACS,SAAS,EAAET,SAAS,CAACU,MAAM,CAAC;EAAEN,QAAQ,EAAED,UAAU,CAACC,QAAQ;AAAC,CAAE,CAAC,CAAC;AAEhG,OAAO,MAAMO,oBAAoB,gBAAGX,SAAS,CAACK,OAAO,CACjDL,SAAS,CAACS,SAAS,eACnBT,SAAS,CAACU,MAAM,CAAC;EAAEN,QAAQ,EAAEJ,SAAS,CAACM;AAAQ,CAAE,CAAC,CACrD;AAED,OAAO,MAAMM,kBAAkB,gBAAGZ,SAAS,CAACK,OAAO,CAC/CL,SAAS,CAACa,QAAQ,eAClBZ,MAAM,CAACa,UAAU,CAACZ,SAAS,CAACa,2CAA2C,CAAC,CAC3E","ignoreList":[]}

package/package.json

@@ -1,61 +1,75 @@
 {
   "name": "@efffrida/rpc",
-  "version": "0.0.14",
+  "version": "0.0.15",
   "description": "effect rpc-frida",
-  "license": "GPL-3.0-only",
+  "keywords": [
+    "frida.re",
+    "reverse engineering",
+    "effect-ts"
+  ],
+  "homepage": "https://github.com/leonitousconforti/efffrida",
   "repository": {
     "type": "git",
     "url": "https://github.com/leonitousconforti/efffrida.git",
     "directory": "packages/rpc"
   },
-  "sideEffects": [],
+  "license": "GPL-3.0-only",
   "author": "Leo Conforti <leo@leoconforti.us> (https://leoconforti.us)",
-  "homepage": "https://github.com/leonitousconforti/efffrida",
+  "sideEffects": [],
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    "./node": "./dist/node/index.ts",
+    "./frida": "./dist/frida/index.ts",
+    "./*": "./dist/*.ts",
+    "./internal/*": null,
+    "./shared/*": null,
+    "./*/index": null
+  },
+  "files": [
+    "src/**/*.ts",
+    "dist/**/*.js",
+    "dist/**/*.js.map",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map"
+  ],
   "dependencies": {
-    "@efffrida/frida-tools": "^0.0.14"
+    "@efffrida/frida-tools": "^0.0.15"
+  },
+  "devDependencies": {
+    "@effect/cluster": "0.52.1",
+    "@effect/experimental": "0.57.0",
+    "@effect/platform": "0.93.0",
+    "@effect/platform-node": "0.100.0",
+    "@effect/rpc": "0.72.1",
+    "@effect/sql": "0.48.0",
+    "@effect/vitest": "0.27.0",
+    "@effect/workflow": "0.12.1",
+    "@types/frida-gum": "19.0.1",
+    "@types/node": "24.10.0",
+    "core-js": "3.46.0",
+    "effect": "3.19.0",
+    "vitest": "4.0.7",
+    "@efffrida/platform": "0.0.13"
   },
   "peerDependencies": {
-    "@effect/platform": "0.81.1",
-    "@effect/rpc": "0.57.1",
-    "effect": "3.14.22"
+    "@effect/platform": "0.93.0",
+    "@effect/rpc": "0.72.1",
+    "effect": "3.19.0"
   },
-  "main": "./dist/cjs/index.js",
-  "module": "./dist/esm/index.js",
-  "types": "./dist/dts/index.d.ts",
-  "exports": {
-    "./package.json": "./package.json",
-    ".": {
-      "types": "./dist/dts/index.d.ts",
-      "import": "./dist/esm/index.js",
-      "default": "./dist/cjs/index.js"
-    },
-    "./FridaRpcClient": {
-      "types": "./dist/dts/FridaRpcClient.d.ts",
-      "import": "./dist/esm/FridaRpcClient.js",
-      "default": "./dist/cjs/FridaRpcClient.js"
-    },
-    "./FridaRpcServer": {
-      "types": "./dist/dts/FridaRpcServer.d.ts",
-      "import": "./dist/esm/FridaRpcServer.js",
-      "default": "./dist/cjs/FridaRpcServer.js"
-    },
-    "./index": {
-      "types": "./dist/dts/index.d.ts",
-      "import": "./dist/esm/index.js",
-      "default": "./dist/cjs/index.js"
-    }
+  "publishConfig": {
+    "access": "public"
   },
-  "typesVersions": {
-    "*": {
-      "FridaRpcClient": [
-        "./dist/dts/FridaRpcClient.d.ts"
-      ],
-      "FridaRpcServer": [
-        "./dist/dts/FridaRpcServer.d.ts"
-      ],
-      "index": [
-        "./dist/dts/index.d.ts"
-      ]
-    }
+  "tags": [
+    "frida.re",
+    "reverse engineering",
+    "effect-ts"
+  ],
+  "scripts": {
+    "build": "tsc -b tsconfig.build.json && babel dist --plugins annotate-pure-calls --out-dir dist --source-maps",
+    "check": "tsc -b tsconfig.json",
+    "codegen": "build-utils prepare-v4",
+    "coverage": "vitest --coverage",
+    "test": "vitest"
   }
 }

package/src/frida/FridaRpcClient.ts

@@ -0,0 +1,180 @@
+/**
+ * Implements a Frida RPC client protocol for effect using the frida script
+ * exports.
+ *
+ * @since 1.0.0
+ */
+
+import type * as RpcMessage from "@effect/rpc/RpcMessage";
+import type * as Duration from "effect/Duration";
+import type * as Scope from "effect/Scope";
+
+import * as RpcClient from "@effect/rpc/RpcClient";
+import * as RpcSerialization from "@effect/rpc/RpcSerialization";
+import * as FridaStream from "@efffrida/platform/Stream";
+import * as Cause from "effect/Cause";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Function from "effect/Function";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as ParseResult from "effect/ParseResult";
+import * as Predicate from "effect/Predicate";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+
+import * as constants from "../shared/constants.ts";
+import * as sharedPredicates from "../shared/predicates.ts";
+
+/**
+ * @since 1.0.0
+ * @category Protocol
+ */
+export const makeProtocolFrida = (
+    options?:
+        | {
+              readonly generateExportName?: (() => string) | undefined;
+              readonly receivingStreamShareOptions?:
+                  | {
+                        readonly capacity: "unbounded";
+                        readonly replay?: number | undefined;
+                        readonly idleTimeToLive?: Duration.DurationInput | undefined;
+                    }
+                  | {
+                        readonly capacity: number;
+                        readonly strategy?: "sliding" | "dropping" | "suspend" | undefined;
+                        readonly replay?: number | undefined;
+                        readonly idleTimeToLive?: Duration.DurationInput | undefined;
+                    }
+                  | undefined;
+          }
+        | undefined
+): Effect.Effect<RpcClient.Protocol["Type"], never, RpcSerialization.RpcSerialization | Scope.Scope> =>
+    RpcClient.Protocol.make(
+        Effect.fnUntraced(function* (writeResponse) {
+            const serialization = yield* RpcSerialization.RpcSerialization;
+
+            const encoder = new TextEncoder();
+            const parser = serialization.unsafeMake();
+
+            /**
+             * Once the server has acknowledged our initiation request and sent
+             * use a client id to identify ourselves, this deferred will
+             * complete.
+             */
+            const clientIdDeferred = yield* Deferred.make<number, ParseResult.ParseError>();
+
+            /**
+             * Setup the receiving handler for the client id. We receive the
+             * client id over a script export instead of over the receiving
+             * stream since there could be multiple clients in this frida script
+             * and multiple could request client ids at the same time. This
+             * could be mitigated with a nonce of some kind in the request
+             * message, but receiving over a script export is full-proof so long
+             * as the exports are unique.
+             */
+            const exportName = options?.generateExportName?.() ?? constants.generateClientCallbackExportNameForServer();
+            yield* Effect.addFinalizer(() => Effect.sync(() => delete rpc.exports[exportName]));
+            rpc.exports[exportName] = (maybeIncomingClientId: unknown): void => {
+                const parsedClientId = Schema.decodeUnknown(Schema.Number)(maybeIncomingClientId);
+                Deferred.unsafeDone(clientIdDeferred, parsedClientId);
+            };
+
+            /**
+             * Request a client id from the node side and wait for the response,
+             * handling any transient errors that might occur by retrying with
+             * the retry policy.
+             */
+            const connectionRequest = constants.nodeRpcClientMakeConnectionRequestForServer(exportName);
+            const connectionRequestTimeout: Duration.DurationInput = "1 second";
+            const clientId = yield* Effect.sync(() => send(connectionRequest)).pipe(
+                Effect.flatMap(() => Deferred.await(clientIdDeferred)),
+                Effect.timeout(connectionRequestTimeout),
+                Effect.catchIf(ParseResult.isParseError, () => Effect.dieMessage("Failed to parse client ID")),
+                Effect.catchIf(Cause.isTimeoutException, () => Effect.dieMessage("Timed out too many times"))
+            );
+
+            /**
+             * Attach to the receiving stream, where all future messages will
+             * come in at, and filter for only our messages.
+             */
+            const receivingPredicate = sharedPredicates.isTaggedForClient(clientId);
+            const receiveStream = yield* FridaStream.receiveStream(
+                options?.receivingStreamShareOptions ?? {
+                    replay: 100,
+                    capacity: "unbounded",
+                }
+            );
+
+            /**
+             * For every response message received, decode it and send it the
+             * response back to the implementation.
+             */
+            yield* receiveStream.pipe(
+                Stream.filterMap((unfiltered) => {
+                    if (receivingPredicate(unfiltered.message)) return Option.fromNullable(unfiltered.data);
+                    else return Option.none<Uint8Array<ArrayBufferLike>>();
+                }),
+                Stream.runForEach((filtered) => {
+                    try {
+                        const responses = parser.decode(filtered) as Array<RpcMessage.FromServerEncoded>;
+                        if (responses.length === 0) return Effect.void;
+                        let i = 0;
+                        return Effect.whileLoop({
+                            while: () => i < responses.length,
+                            body: () => writeResponse(responses[i++]),
+                            step: Function.constVoid,
+                        });
+                    } catch (defect) {
+                        return writeResponse({ _tag: "Defect", defect });
+                    }
+                }),
+                Effect.interruptible,
+                Effect.forkScoped
+            );
+
+            /**
+             * Sending messages is as simple as encoding them, then sending them
+             * to the node side tagged with our client id so it knows where to
+             * send them back to.
+             */
+            const sendHelper = Effect.fnUntraced(function* (message: RpcMessage.FromClientEncoded) {
+                const encoded = parser.encode(message);
+                if (Predicate.isUndefined(encoded)) return;
+                const transformed = typeof encoded === "string" ? encoder.encode(encoded) : encoded;
+                send({ clientId }, (transformed as Uint8Array<ArrayBuffer>).buffer);
+            });
+
+            return {
+                send: sendHelper,
+                supportsAck: true,
+                supportsTransferables: false,
+            };
+        })
+    );
+
+/**
+ * @since 1.0.0
+ * @category Layers
+ */
+export const layerProtocolFrida = (
+    options?:
+        | {
+              readonly generateExportName?: (() => string) | undefined;
+              readonly receivingStreamShareOptions?:
+                  | {
+                        readonly capacity: "unbounded";
+                        readonly replay?: number | undefined;
+                        readonly idleTimeToLive?: Duration.DurationInput | undefined;
+                    }
+                  | {
+                        readonly capacity: number;
+                        readonly strategy?: "sliding" | "dropping" | "suspend" | undefined;
+                        readonly replay?: number | undefined;
+                        readonly idleTimeToLive?: Duration.DurationInput | undefined;
+                    }
+                  | undefined;
+          }
+        | undefined
+): Layer.Layer<RpcClient.Protocol, never, RpcSerialization.RpcSerialization> =>
+    Layer.scoped(RpcClient.Protocol, makeProtocolFrida(options));