@efffrida/frida-tools 0.0.1

package/dist/esm/internal/device.js

@@ -0,0 +1,55 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Predicate from "effect/Predicate";
+import * as Frida from "frida";
+import * as FridaDeviceAcquisitionError from "../FridaDeviceAcquisitionError.js";
+/** @internal */
+export const FridaDeviceTypeId = /*#__PURE__*/Symbol.for("@efffrida/frida-tools/FridaDevice");
+/** @internal */
+export const Tag = /*#__PURE__*/Context.GenericTag("@efffrida/frida-tools/FridaDevice");
+/** @internal */
+export const isFridaDevice = u => Predicate.hasProperty(u, FridaDeviceTypeId);
+/** @internal */
+export const acquireUsbDevice = options => Effect.map(Effect.tryPromise({
+  try: () => Frida.getUsbDevice(options),
+  catch: cause => new FridaDeviceAcquisitionError.FridaDeviceAcquisitionError({
+    cause,
+    attempts: 1,
+    acquisitionMethod: "usb"
+  })
+}), device => ({
+  device,
+  [FridaDeviceTypeId]: FridaDeviceTypeId
+}));
+/** @internal */
+export const acquireRemoteDevice = (address, options) => Effect.map(Effect.tryPromise({
+  try: () => Frida.getDeviceManager().addRemoteDevice(address, options),
+  catch: cause => new FridaDeviceAcquisitionError.FridaDeviceAcquisitionError({
+    cause,
+    attempts: 1,
+    acquisitionMethod: "remote"
+  })
+}), device => ({
+  device,
+  [FridaDeviceTypeId]: FridaDeviceTypeId
+}));
+/** @internal */
+export const acquireLocalDevice = () => Effect.map(Effect.tryPromise({
+  try: () => Frida.getLocalDevice(),
+  catch: cause => new FridaDeviceAcquisitionError.FridaDeviceAcquisitionError({
+    cause,
+    attempts: 1,
+    acquisitionMethod: "local"
+  })
+}), device => ({
+  device,
+  [FridaDeviceTypeId]: FridaDeviceTypeId
+}));
+/** @internal */
+export const layerRemoteDevice = (address, options) => Layer.effect(Tag, acquireRemoteDevice(address, options));
+/** @internal */
+export const layerUsbDevice = options => Layer.effect(Tag, acquireUsbDevice(options));
+/** @internal */
+export const layerLocalDevice = /*#__PURE__*/Layer.effect(Tag, /*#__PURE__*/acquireLocalDevice());
+//# sourceMappingURL=device.js.map

package/dist/esm/internal/device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.js","names":["Context","Effect","Layer","Predicate","Frida","FridaDeviceAcquisitionError","FridaDeviceTypeId","Symbol","for","Tag","GenericTag","isFridaDevice","u","hasProperty","acquireUsbDevice","options","map","tryPromise","try","getUsbDevice","catch","cause","attempts","acquisitionMethod","device","acquireRemoteDevice","address","getDeviceManager","addRemoteDevice","acquireLocalDevice","getLocalDevice","layerRemoteDevice","effect","layerUsbDevice","layerLocalDevice"],"sources":["../../../src/internal/device.ts"],"sourcesContent":[null],"mappings":"AAEA,OAAO,KAAKA,OAAO,MAAM,gBAAgB;AACzC,OAAO,KAAKC,MAAM,MAAM,eAAe;AACvC,OAAO,KAAKC,KAAK,MAAM,cAAc;AACrC,OAAO,KAAKC,SAAS,MAAM,kBAAkB;AAC7C,OAAO,KAAKC,KAAK,MAAM,OAAO;AAC9B,OAAO,KAAKC,2BAA2B,MAAM,mCAAmC;AAEhF;AACA,OAAO,MAAMC,iBAAiB,gBAAkCC,MAAM,CAACC,GAAG,CACtE,mCAAmC,CACL;AAElC;AACA,OAAO,MAAMC,GAAG,gBAAGT,OAAO,CAACU,UAAU,CAA0B,mCAAmC,CAAC;AAEnG;AACA,OAAO,MAAMC,aAAa,GAAIC,CAAU,IAAmCT,SAAS,CAACU,WAAW,CAACD,CAAC,EAAEN,iBAAiB,CAAC;AAEtH;AACA,OAAO,MAAMQ,gBAAgB,GACzBC,OAA4C,IAE5Cd,MAAM,CAACe,GAAG,CACNf,MAAM,CAACgB,UAAU,CAAC;EACdC,GAAG,EAAEA,CAAA,KAAMd,KAAK,CAACe,YAAY,CAACJ,OAAO,CAAC;EACtCK,KAAK,EAAGC,KAAK,IACT,IAAIhB,2BAA2B,CAACA,2BAA2B,CAAC;IACxDgB,KAAK;IACLC,QAAQ,EAAE,CAAC;IACXC,iBAAiB,EAAE;GACtB;CACR,CAAC,EACDC,MAAM,KAAM;EAAEA,MAAM;EAAE,CAAClB,iBAAiB,GAAGA;AAAiB,CAAE,CAAU,CAC5E;AAEL;AACA,OAAO,MAAMmB,mBAAmB,GAAGA,CAC/BC,OAAe,EACfX,OAA+C,KAE/Cd,MAAM,CAACe,GAAG,CACNf,MAAM,CAACgB,UAAU,CAAC;EACdC,GAAG,EAAEA,CAAA,KAAMd,KAAK,CAACuB,gBAAgB,EAAE,CAACC,eAAe,CAACF,OAAO,EAAEX,OAAO,CAAC;EACrEK,KAAK,EAAGC,KAAK,IACT,IAAIhB,2BAA2B,CAACA,2BAA2B,CAAC;IACxDgB,KAAK;IACLC,QAAQ,EAAE,CAAC;IACXC,iBAAiB,EAAE;GACtB;CACR,CAAC,EACDC,MAAM,KAAM;EAAEA,MAAM;EAAE,CAAClB,iBAAiB,GAAGA;AAAiB,CAAE,CAAU,CAC5E;AAEL;AACA,OAAO,MAAMuB,kBAAkB,GAAGA,CAAA,KAK9B5B,MAAM,CAACe,GAAG,CACNf,MAAM,CAACgB,UAAU,CAAC;EACdC,GAAG,EAAEA,CAAA,KAAMd,KAAK,CAAC0B,cAAc,EAAE;EACjCV,KAAK,EAAGC,KAAK,IACT,IAAIhB,2BAA2B,CAACA,2BAA2B,CAAC;IACxDgB,KAAK;IACLC,QAAQ,EAAE,CAAC;IACXC,iBAAiB,EAAE;GACtB;CACR,CAAC,EACDC,MAAM,KAAM;EAAEA,MAAM;EAAE,CAAClB,iBAAiB,GAAGA;AAAiB,CAAE,CAAU,CAC5E;AAEL;AACA,OAAO,MAAMyB,iBAAiB,GAAGA,CAC7BL,OAAe,EACfX,OAA+C,KAE/Cb,KAAK,CAAC8B,MAAM,CAACvB,GAAG,EAAEgB,mBAAmB,CAACC,OAAO,EAAEX,OAAO,CAAC,CAAC;AAE5D;AACA,OAAO,MAAMkB,cAAc,GACvBlB,OAA4C,IAE5Cb,KAAK,CAAC8B,MAAM,CAACvB,GAAG,EAAEK,gBAAgB,CAACC,OAAO,CAAC,CAAC;AAEhD;AACA,OAAO,MAAMmB,gBAAgB,gBAIzBhC,KAAK,CAAC8B,MAAM,CAACvB,GAAG,eAAEoB,kBAAkB,EAAE,CAAC","ignoreList":[]}

package/dist/esm/internal/script.js

@@ -0,0 +1,155 @@
+import * as Context from "effect/Context";
+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 Predicate from "effect/Predicate";
+import * as Queue from "effect/Queue";
+import * as Sink from "effect/Sink";
+import * as Stream from "effect/Stream";
+import * as Take from "effect/Take";
+import * as Frida from "frida";
+import * as FridaDevice from "../FridaDevice.js";
+import * as FridaSession from "../FridaSession.js";
+import * as FridaSessionError from "../FridaSessionError.js";
+/** @internal */
+export const FridaScriptTypeId = /*#__PURE__*/Symbol.for("@efffrida/frida-tools/FridaScript");
+/** @internal */
+export const Tag = /*#__PURE__*/Context.GenericTag("@efffrida/frida-tools/FridaScript");
+/** @internal */
+export const isFridaScript = u => Predicate.hasProperty(u, FridaScriptTypeId);
+/** @internal */
+export const load = /*#__PURE__*/Function.dual(arguments_ => Predicate.isString(arguments_[0]) || Buffer.isBuffer(arguments_[0]), /*#__PURE__*/Effect.fnUntraced(function* (source, options) {
+  const {
+    device
+  } = yield* FridaDevice.FridaDevice;
+  const {
+    session
+  } = yield* FridaSession.FridaSession;
+  const script = Predicate.isString(source) ? yield* Effect.tryPromise({
+    try: () => session.createScript(source, {
+      runtime: Frida.ScriptRuntime.V8,
+      ...options
+    }),
+    catch: cause => new FridaSessionError.FridaSessionError({
+      cause,
+      when: "compile"
+    })
+  }) : yield* Effect.tryPromise({
+    try: () => session.createScriptFromBytes(source, {
+      runtime: Frida.ScriptRuntime.V8,
+      ...options
+    }),
+    catch: cause => new FridaSessionError.FridaSessionError({
+      cause,
+      when: "compile"
+    })
+  });
+  const messageQueue = yield* Queue.unbounded();
+  let scriptDefectCause = undefined;
+  const messageHandler = (message, data) => {
+    switch (message.type) {
+      case Frida.MessageType.Error:
+        {
+          const error = new Error();
+          error.name = "FridaScriptDefect";
+          error.stack = message.stack ?? "";
+          error.message = message.description.replace(/Error: /, "") ?? "";
+          scriptDefectCause = error;
+          const sessionError = new FridaSessionError.FridaSessionError({
+            when: "message",
+            cause: error.cause
+          });
+          const asTake = Take.fail(sessionError);
+          Queue.unsafeOffer(messageQueue, asTake);
+          break;
+        }
+      case Frida.MessageType.Send:
+        {
+          const asTake = Take.of({
+            message: message.payload,
+            data: Option.fromNullable(data)
+          });
+          Queue.unsafeOffer(messageQueue, asTake);
+          break;
+        }
+      default:
+        Function.absurd(message);
+    }
+  };
+  const disconnectMessageHandler = Effect.sync(() => script.message.disconnect(messageHandler));
+  yield* Effect.addFinalizer(() => Effect.flatMap(messageQueue.shutdown, () => disconnectMessageHandler));
+  script.message.connect(messageHandler);
+  const stream = Stream.fromQueue(messageQueue).pipe(Stream.flattenTake);
+  const sink = Sink.forEach(({
+    data,
+    message
+  }) => {
+    if (Predicate.isNotUndefined(scriptDefectCause)) {
+      return Effect.fail(new FridaSessionError.FridaSessionError({
+        when: "rpcCall",
+        cause: scriptDefectCause
+      }));
+    } else {
+      return Effect.sync(() => script.post(message, Option.getOrNull(data)));
+    }
+  });
+  const destroyed = yield* Deferred.make();
+  const destroyedHandler = () => Deferred.unsafeDone(destroyed, Effect.void);
+  script.destroyed.connect(destroyedHandler);
+  const callExport = exportName => Effect.fn(`call frida export ${exportName}`)(function* (...args) {
+    yield* Effect.annotateCurrentSpan("args", args);
+    const isDestroyed = yield* Deferred.isDone(destroyed);
+    if (isDestroyed) {
+      return yield* new FridaSessionError.FridaSessionError({
+        when: "rpcCall",
+        cause: "Script is destroyed"
+      });
+    }
+    if (Predicate.isNotUndefined(scriptDefectCause)) {
+      return yield* new FridaSessionError.FridaSessionError({
+        when: "rpcCall",
+        cause: scriptDefectCause
+      });
+    }
+    const result = yield* Effect.tryPromise({
+      try: () => script.exports[exportName](...args),
+      catch: cause => new FridaSessionError.FridaSessionError({
+        when: "rpcCall",
+        cause
+      })
+    });
+    yield* Effect.annotateCurrentSpan("result", result);
+    return result;
+  });
+  yield* Effect.tryPromise({
+    try: () => script.load(),
+    catch: cause => new FridaSessionError.FridaSessionError({
+      cause,
+      when: "load"
+    })
+  });
+  if (options?.resume === true) {
+    yield* Effect.tryPromise({
+      try: () => device.resume(session.pid),
+      catch: cause => new FridaSessionError.FridaSessionError({
+        cause,
+        when: "resume"
+      })
+    });
+  }
+  return {
+    script,
+    stream,
+    sink,
+    destroyed,
+    callExport,
+    [FridaScriptTypeId]: FridaScriptTypeId
+  };
+}, /*#__PURE__*/Effect.acquireRelease(({
+  script
+}) => Effect.promise(() => script.unload()))));
+/** @internal */
+export const layer = /*#__PURE__*/Function.dual(arguments_ => Predicate.isString(arguments_[0]), (source, options) => Layer.scoped(Tag, load(source, options)));
+//# sourceMappingURL=script.js.map

package/dist/esm/internal/script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.js","names":["Context","Deferred","Effect","Function","Layer","Option","Predicate","Queue","Sink","Stream","Take","Frida","FridaDevice","FridaSession","FridaSessionError","FridaScriptTypeId","Symbol","for","Tag","GenericTag","isFridaScript","u","hasProperty","load","dual","arguments_","isString","Buffer","isBuffer","fnUntraced","source","options","device","session","script","tryPromise","try","createScript","runtime","ScriptRuntime","V8","catch","cause","when","createScriptFromBytes","messageQueue","unbounded","scriptDefectCause","undefined","messageHandler","message","data","type","MessageType","Error","error","name","stack","description","replace","sessionError","asTake","fail","unsafeOffer","Send","of","payload","fromNullable","absurd","disconnectMessageHandler","sync","disconnect","addFinalizer","flatMap","shutdown","connect","stream","fromQueue","pipe","flattenTake","sink","forEach","isNotUndefined","post","getOrNull","destroyed","make","destroyedHandler","unsafeDone","void","callExport","exportName","fn","args","annotateCurrentSpan","isDestroyed","isDone","result","exports","resume","pid","acquireRelease","promise","unload","layer","scoped"],"sources":["../../../src/internal/script.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/esm/internal/session.js

@@ -0,0 +1,44 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Predicate from "effect/Predicate";
+import * as FridaDevice from "../FridaDevice.js";
+import * as FridaSessionError from "../FridaSessionError.js";
+/** @internal */
+export const FridaSessionTypeId = /*#__PURE__*/Symbol.for("@efffrida/frida-tools/FridaSession");
+/** @internal */
+export const Tag = /*#__PURE__*/Context.GenericTag("@efffrida/frida-tools/FridaSession");
+/** @internal */
+export const isFridaSession = u => Predicate.hasProperty(u, FridaSessionTypeId);
+/** @internal */
+export const spawn = (program, options) => Effect.flatMap(FridaDevice.FridaDevice, ({
+  device
+}) => Effect.acquireRelease(Effect.tryPromise({
+  try: () => device.spawn(program, options),
+  catch: cause => new FridaSessionError.FridaSessionError({
+    cause,
+    when: "spawn"
+  })
+}), pid => Effect.promise(() => device.kill(pid))));
+/** @internal */
+export const attach = (target, options) => Effect.flatMap(FridaDevice.FridaDevice, ({
+  device
+}) => Effect.acquireRelease(Effect.map(Effect.tryPromise({
+  try: () => device.attach(target, options),
+  catch: cause => new FridaSessionError.FridaSessionError({
+    cause,
+    when: "attach"
+  })
+}), session => ({
+  session,
+  [FridaSessionTypeId]: FridaSessionTypeId
+})), ({
+  session
+}) => Effect.promise(() => session.detach())));
+/** @internal */
+export const layer = (target, options) => Layer.scoped(Tag, Effect.gen(function* () {
+  const pid = yield* spawn(target, options);
+  const session = yield* attach(pid, options);
+  return session;
+}));
+//# sourceMappingURL=session.js.map

package/dist/esm/internal/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","names":["Context","Effect","Layer","Predicate","FridaDevice","FridaSessionError","FridaSessionTypeId","Symbol","for","Tag","GenericTag","isFridaSession","u","hasProperty","spawn","program","options","flatMap","device","acquireRelease","tryPromise","try","catch","cause","when","pid","promise","kill","attach","target","map","session","detach","layer","scoped","gen"],"sources":["../../../src/internal/session.ts"],"sourcesContent":[null],"mappings":"AAIA,OAAO,KAAKA,OAAO,MAAM,gBAAgB;AACzC,OAAO,KAAKC,MAAM,MAAM,eAAe;AACvC,OAAO,KAAKC,KAAK,MAAM,cAAc;AACrC,OAAO,KAAKC,SAAS,MAAM,kBAAkB;AAC7C,OAAO,KAAKC,WAAW,MAAM,mBAAmB;AAChD,OAAO,KAAKC,iBAAiB,MAAM,yBAAyB;AAE5D;AACA,OAAO,MAAMC,kBAAkB,gBAAoCC,MAAM,CAACC,GAAG,CACzE,oCAAoC,CACJ;AAEpC;AACA,OAAO,MAAMC,GAAG,gBAAGT,OAAO,CAACU,UAAU,CAA4B,oCAAoC,CAAC;AAEtG;AACA,OAAO,MAAMC,cAAc,GAAIC,CAAU,IACrCT,SAAS,CAACU,WAAW,CAACD,CAAC,EAAEN,kBAAkB,CAAC;AAEhD;AACA,OAAO,MAAMQ,KAAK,GAAGA,CACjBC,OAA+B,EAC/BC,OAAwC,KAExCf,MAAM,CAACgB,OAAO,CAACb,WAAW,CAACA,WAAW,EAAE,CAAC;EAAEc;AAAM,CAAE,KAC/CjB,MAAM,CAACkB,cAAc,CACjBlB,MAAM,CAACmB,UAAU,CAAC;EACdC,GAAG,EAAEA,CAAA,KAAMH,MAAM,CAACJ,KAAK,CAACC,OAAO,EAAEC,OAAO,CAAC;EACzCM,KAAK,EAAGC,KAAK,IAAK,IAAIlB,iBAAiB,CAACA,iBAAiB,CAAC;IAAEkB,KAAK;IAAEC,IAAI,EAAE;EAAO,CAAE;CACrF,CAAC,EACDC,GAAG,IAAKxB,MAAM,CAACyB,OAAO,CAAC,MAAMR,MAAM,CAACS,IAAI,CAACF,GAAG,CAAC,CAAC,CAClD,CACJ;AAEL;AACA,OAAO,MAAMG,MAAM,GAAGA,CAClBC,MAA2B,EAC3Bb,OAA0C,KAM1Cf,MAAM,CAACgB,OAAO,CAACb,WAAW,CAACA,WAAW,EAAE,CAAC;EAAEc;AAAM,CAAE,KAC/CjB,MAAM,CAACkB,cAAc,CACjBlB,MAAM,CAAC6B,GAAG,CACN7B,MAAM,CAACmB,UAAU,CAAC;EACdC,GAAG,EAAEA,CAAA,KAAMH,MAAM,CAACU,MAAM,CAACC,MAAM,EAAEb,OAAO,CAAC;EACzCM,KAAK,EAAGC,KAAK,IAAK,IAAIlB,iBAAiB,CAACA,iBAAiB,CAAC;IAAEkB,KAAK;IAAEC,IAAI,EAAE;EAAQ,CAAE;CACtF,CAAC,EACDO,OAAO,KAAM;EAAEA,OAAO;EAAE,CAACzB,kBAAkB,GAAGA;AAAkB,CAAE,CAAU,CAChF,EACD,CAAC;EAAEyB;AAAO,CAA6B,KAAK9B,MAAM,CAACyB,OAAO,CAAC,MAAMK,OAAO,CAACC,MAAM,EAAE,CAAC,CACrF,CACJ;AAEL;AACA,OAAO,MAAMC,KAAK,GAAGA,CACjBJ,MAAc,EACdb,OAAiE,KAEjEd,KAAK,CAACgC,MAAM,CACRzB,GAAG,EACHR,MAAM,CAACkC,GAAG,CAAC,aAAS;EAChB,MAAMV,GAAG,GAAG,OAAOX,KAAK,CAACe,MAAM,EAAEb,OAAO,CAAC;EACzC,MAAMe,OAAO,GAAG,OAAOH,MAAM,CAACH,GAAG,EAAET,OAAO,CAAC;EAC3C,OAAOe,OAAO;AAClB,CAAC,CAAC,CACL","ignoreList":[]}

package/dist/esm/package.json

@@ -0,0 +1,4 @@
+{
+  "type": "module",
+  "sideEffects": []
+}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@efffrida/frida-tools",
+  "version": "0.0.1",
+  "description": "Frida with effect-ts",
+  "license": "GPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/leoconforti/efffrida.git",
+    "directory": "packages/frida-tools"
+  },
+  "sideEffects": [],
+  "author": "Leo Conforti <leo@leoconforti.us> (https://leoconforti.us)",
+  "homepage": "https://github.com/leoconforti/efffrida",
+  "dependencies": {
+    "frida": "16.7.10"
+  },
+  "peerDependencies": {
+    "@effect/platform": "0.80.7",
+    "effect": "3.14.7"
+  },
+  "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"
+    },
+    "./FridaDevice": {
+      "types": "./dist/dts/FridaDevice.d.ts",
+      "import": "./dist/esm/FridaDevice.js",
+      "default": "./dist/cjs/FridaDevice.js"
+    },
+    "./FridaDeviceAcquisitionError": {
+      "types": "./dist/dts/FridaDeviceAcquisitionError.d.ts",
+      "import": "./dist/esm/FridaDeviceAcquisitionError.js",
+      "default": "./dist/cjs/FridaDeviceAcquisitionError.js"
+    },
+    "./FridaScript": {
+      "types": "./dist/dts/FridaScript.d.ts",
+      "import": "./dist/esm/FridaScript.js",
+      "default": "./dist/cjs/FridaScript.js"
+    },
+    "./FridaSession": {
+      "types": "./dist/dts/FridaSession.d.ts",
+      "import": "./dist/esm/FridaSession.js",
+      "default": "./dist/cjs/FridaSession.js"
+    },
+    "./FridaSessionError": {
+      "types": "./dist/dts/FridaSessionError.d.ts",
+      "import": "./dist/esm/FridaSessionError.js",
+      "default": "./dist/cjs/FridaSessionError.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "FridaDevice": [
+        "./dist/dts/FridaDevice.d.ts"
+      ],
+      "FridaDeviceAcquisitionError": [
+        "./dist/dts/FridaDeviceAcquisitionError.d.ts"
+      ],
+      "FridaScript": [
+        "./dist/dts/FridaScript.d.ts"
+      ],
+      "FridaSession": [
+        "./dist/dts/FridaSession.d.ts"
+      ],
+      "FridaSessionError": [
+        "./dist/dts/FridaSessionError.d.ts"
+      ]
+    }
+  }
+}

package/src/FridaDevice.ts

@@ -0,0 +1,103 @@
+/**
+ * Frida devices
+ *
+ * @since 1.0.0
+ */
+
+import type * as Context from "effect/Context";
+import type * as Effect from "effect/Effect";
+import type * as Layer from "effect/Layer";
+import type * as Frida from "frida";
+import type * as FridaDeviceAcquisitionError from "./FridaDeviceAcquisitionError.js";
+
+import * as internal from "./internal/device.js";
+
+/**
+ * @since 1.0.0
+ * @category Type ids
+ */
+export const FridaDeviceTypeId: unique symbol = internal.FridaDeviceTypeId;
+
+/**
+ * @since 1.0.0
+ * @category Type ids
+ */
+export type FridaDeviceTypeId = typeof FridaDeviceTypeId;
+
+/**
+ * @since 1.0.0
+ * @category Models
+ */
+export interface FridaDevice {
+    readonly device: Frida.Device;
+    readonly [FridaDeviceTypeId]: typeof FridaDeviceTypeId;
+}
+
+/**
+ * @since 1.0.0
+ * @category Tags
+ */
+export const FridaDevice: Context.Tag<FridaDevice, FridaDevice> = internal.Tag;
+
+/**
+ * @since 1.0.0
+ * @category Predicates
+ */
+export const isFridaDevice: (u: unknown) => u is FridaDevice = internal.isFridaDevice;
+
+/**
+ * @since 1.0.0
+ * @category Device acquisition
+ */
+export const acquireUsbDevice: (
+    options?: Frida.GetDeviceOptions | undefined
+) => Effect.Effect<FridaDevice, FridaDeviceAcquisitionError.FridaDeviceAcquisitionError, never> =
+    internal.acquireUsbDevice;
+
+/**
+ * @since 1.0.0
+ * @category Device acquisition
+ */
+export const acquireRemoteDevice: (
+    address: string,
+    options?: Frida.RemoteDeviceOptions | undefined
+) => Effect.Effect<FridaDevice, FridaDeviceAcquisitionError.FridaDeviceAcquisitionError, never> =
+    internal.acquireRemoteDevice;
+
+/**
+ * @since 1.0.0
+ * @category Device acquisition
+ */
+export const acquireLocalDevice: () => Effect.Effect<
+    FridaDevice,
+    FridaDeviceAcquisitionError.FridaDeviceAcquisitionError,
+    never
+> = internal.acquireLocalDevice;
+
+/**
+ * @since 1.0.0
+ * @category Layers
+ */
+export const layerRemoteDevice: (
+    address: string,
+    options?: Frida.RemoteDeviceOptions | undefined
+) => Layer.Layer<FridaDevice, FridaDeviceAcquisitionError.FridaDeviceAcquisitionError, never> =
+    internal.layerRemoteDevice;
+
+/**
+ * @since 1.0.0
+ * @category Layers
+ */
+export const layerUsbDevice: (
+    options?: Frida.GetDeviceOptions | undefined
+) => Layer.Layer<FridaDevice, FridaDeviceAcquisitionError.FridaDeviceAcquisitionError, never> = internal.layerUsbDevice;
+
+/**
+ * @since 1.0.0
+ * @category Layers
+ */
+export const layerLocalDevice: Layer.Layer<
+    FridaDevice,
+    FridaDeviceAcquisitionError.FridaDeviceAcquisitionError,
+    never
+> = internal.layerLocalDevice;

package/src/FridaDeviceAcquisitionError.ts

@@ -0,0 +1,42 @@
+/**
+ * Frida device acquisition errors
+ *
+ * @since 1.0.0
+ */
+
+import * as PlatformError from "@effect/platform/Error";
+import * as Predicate from "effect/Predicate";
+
+/**
+ * @since 1.0.0
+ * @category Errors
+ */
+export const FridaDeviceAcquisitionErrorTypeId: unique symbol = Symbol.for(
+    "@efffrida/FridaError/FridaDeviceAcquisitionError"
+) as FridaDeviceAcquisitionErrorTypeId;
+
+/**
+ * @since 1.0.0
+ * @category Errors
+ */
+export type FridaDeviceAcquisitionErrorTypeId = typeof FridaDeviceAcquisitionErrorTypeId;
+
+/**
+ * @since 1.0.0
+ * @category Errors
+ */
+export const isFridaDeviceAcquisitionError = (u: unknown): u is FridaDeviceAcquisitionError =>
+    Predicate.hasProperty(u, FridaDeviceAcquisitionErrorTypeId);
+
+/**
+ * @since 1.0.0
+ * @category Errors
+ */
+export class FridaDeviceAcquisitionError extends PlatformError.TypeIdError(
+    FridaDeviceAcquisitionErrorTypeId,
+    "FridaDeviceAcquisitionError"
+)<{
+    cause: unknown;
+    attempts: number;
+    acquisitionMethod: "usb" | "remote" | "local";
+}> {}

package/src/FridaScript.ts

@@ -0,0 +1,117 @@
+/**
+ * Frida scripts
+ *
+ * @since 1.0.0
+ */
+
+import type * as Context from "effect/Context";
+import type * as Deferred from "effect/Deferred";
+import type * as Effect from "effect/Effect";
+import type * as Layer from "effect/Layer";
+import type * as Option from "effect/Option";
+import type * as Scope from "effect/Scope";
+import type * as Sink from "effect/Sink";
+import type * as Stream from "effect/Stream";
+import type * as Frida from "frida";
+import type * as FridaDevice from "./FridaDevice.js";
+import type * as FridaSession from "./FridaSession.js";
+import type * as FridaSessionError from "./FridaSessionError.js";
+
+import * as internal from "./internal/script.js";
+
+/**
+ * @since 1.0.0
+ * @category Type ids
+ */
+export const FridaScriptTypeId: unique symbol = internal.FridaScriptTypeId;
+
+/**
+ * @since 1.0.0
+ * @category Type ids
+ */
+export type FridaScriptTypeId = typeof FridaScriptTypeId;
+
+/**
+ * @since 1.0.0
+ * @category Models
+ */
+export interface FridaScript {
+    readonly script: Frida.Script;
+    readonly destroyed: Deferred.Deferred<void, never>;
+    readonly [FridaScriptTypeId]: typeof FridaScriptTypeId;
+    readonly stream: Stream.Stream<
+        { message: any; data: Option.Option<Buffer> },
+        FridaSessionError.FridaSessionError,
+        never
+    >;
+    readonly sink: Sink.Sink<
+        void,
+        { message: any; data: Option.Option<Buffer> },
+        never,
+        FridaSessionError.FridaSessionError,
+        never
+    >;
+    readonly callExport: (
+        exportName: string
+    ) => (...args: Array<any>) => Effect.Effect<unknown, FridaSessionError.FridaSessionError, never>;
+}
+
+/**
+ * @since 1.0.0
+ * @category Tags
+ */
+export const FridaScript: Context.Tag<FridaScript, FridaScript> = internal.Tag;
+
+/**
+ * @since 1.0.0
+ * @category Predicates
+ */
+export const isFridaScript: (u: unknown) => u is FridaScript = internal.isFridaScript;
+
+/**
+ * @since 1.0.0
+ * @category Frida
+ */
+export const load: {
+    (
+        source: string | Buffer,
+        options?: (Frida.ScriptOptions & { readonly resume?: boolean | undefined }) | undefined
+    ): Effect.Effect<
+        FridaScript,
+        FridaSessionError.FridaSessionError,
+        FridaSession.FridaSession | FridaDevice.FridaDevice | Scope.Scope
+    >;
+    (
+        options?: (Frida.ScriptOptions & { readonly resume?: boolean | undefined }) | undefined
+    ): (
+        source: string | Buffer
+    ) => Effect.Effect<
+        FridaScript,
+        FridaSessionError.FridaSessionError,
+        FridaSession.FridaSession | FridaDevice.FridaDevice | Scope.Scope
+    >;
+} = internal.load;
+
+/**
+ * @since 1.0.0
+ * @category Layers
+ */
+export const layer: {
+    (
+        source: string | Buffer,
+        options?: (Frida.ScriptOptions & { readonly resume?: boolean | undefined }) | undefined
+    ): Layer.Layer<
+        FridaScript,
+        FridaSessionError.FridaSessionError,
+        FridaDevice.FridaDevice | FridaSession.FridaSession
+    >;
+    (
+        options?: (Frida.ScriptOptions & { readonly resume?: boolean | undefined }) | undefined
+    ): (
+        source: string | Buffer
+    ) => Layer.Layer<
+        FridaScript,
+        FridaSessionError.FridaSessionError,
+        FridaDevice.FridaDevice | FridaSession.FridaSession
+    >;
+} = internal.layer;