@koderlabs/tasks-sdk-rn 0.1.0

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@koderlabs/tasks-sdk-rn",
+  "version": "0.1.0",
+  "description": "React Native adapter for the InstantTasks SDK — errors + network + breadcrumbs + navigation + native crash recovery.",
+  "keywords": [
+    "instanttasks",
+    "sdk",
+    "react-native",
+    "mobile"
+  ],
+  "homepage": "https://github.com/jawaidgadiwala/instant-tasks/tree/main/packages/sdk-rn#readme",
+  "bugs": {
+    "url": "https://github.com/jawaidgadiwala/instant-tasks/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jawaidgadiwala/instant-tasks.git",
+    "directory": "packages/sdk-rn"
+  },
+  "license": "UNLICENSED",
+  "author": {
+    "name": "Jawaid Gadiwala",
+    "email": "jawaidgadiwala@gmail.com",
+    "url": "https://koderlabs.com"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./app.plugin": {
+      "types": "./plugin/dist/index.d.ts",
+      "default": "./plugin/dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "plugin/dist",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@koderlabs/tasks-sdk": "0.1.0",
+    "@koderlabs/tasks-sdk-types": "0.1.0"
+  },
+  "peerDependencies": {
+    "react-native": ">=0.72.0",
+    "expo": ">=50.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react-native": {
+      "optional": true
+    },
+    "expo": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@expo/config-plugins": "^9.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "app.plugin.js": "./plugin/dist/index.cjs",
+  "scripts": {
+    "build": "tsup && tsup --config plugin/tsup.config.ts",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/plugin/dist/index.cjs

@@ -0,0 +1,126 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// plugin/src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  CRASH_FILE: () => CRASH_FILE,
+  default: () => src_default,
+  patchAppDelegate: () => patchAppDelegate,
+  patchMainApplication: () => patchMainApplication
+});
+module.exports = __toCommonJS(src_exports);
+var import_config_plugins = require("@expo/config-plugins");
+var CRASH_FILE = "tasks-native-crash.json";
+var IOS_HEADER = `// koderlabs/tasks-sdk-rn \u2014 native crash hook installed by config plugin`;
+var IOS_HOOK = `
+// \u2500\u2500\u2500 koderlabs/tasks-sdk-rn native crash hook \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+static NSUncaughtExceptionHandler *__tasksPrevExceptionHandler = NULL;
+static void __tasksUncaughtExceptionHandler(NSException *exception) {
+  NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
+  NSString *docs = [paths firstObject];
+  if (docs) {
+    NSDictionary *payload = @{
+      @"platform": @"ios",
+      @"name": exception.name ?: @"NSException",
+      @"reason": exception.reason ?: @"",
+      @"callStackSymbols": exception.callStackSymbols ?: @[],
+      @"userInfo": exception.userInfo ?: @{},
+      @"timestamp": [[NSDate date] description] ?: @"",
+    };
+    NSError *err = nil;
+    NSData *json = [NSJSONSerialization dataWithJSONObject:payload options:0 error:&err];
+    if (!err && json) {
+      NSString *path = [docs stringByAppendingPathComponent:@"${CRASH_FILE}"];
+      [json writeToFile:path atomically:YES];
+    }
+  }
+  if (__tasksPrevExceptionHandler) __tasksPrevExceptionHandler(exception);
+}
+// \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+`.trim();
+var IOS_INSTALL = `  // koderlabs/tasks-sdk-rn \u2014 chain into any handler set by RN/Expo.
+  __tasksPrevExceptionHandler = NSGetUncaughtExceptionHandler();
+  NSSetUncaughtExceptionHandler(&__tasksUncaughtExceptionHandler);`;
+var ANDROID_HOOK = `
+    // \u2500\u2500\u2500 koderlabs/tasks-sdk-rn native crash hook \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+    final Thread.UncaughtExceptionHandler __tasksPrevHandler =
+        Thread.getDefaultUncaughtExceptionHandler();
+    Thread.setDefaultUncaughtExceptionHandler((thread, throwable) -> {
+      try {
+        java.io.File f = new java.io.File(getFilesDir(), "${CRASH_FILE}");
+        org.json.JSONObject payload = new org.json.JSONObject();
+        payload.put("platform", "android");
+        payload.put("name", throwable.getClass().getName());
+        payload.put("message", throwable.getMessage() != null ? throwable.getMessage() : "");
+        java.io.StringWriter sw = new java.io.StringWriter();
+        throwable.printStackTrace(new java.io.PrintWriter(sw));
+        payload.put("stackTrace", sw.toString());
+        payload.put("threadName", thread.getName());
+        payload.put("timestamp", new java.util.Date().toString());
+        java.io.FileWriter fw = new java.io.FileWriter(f, false);
+        fw.write(payload.toString());
+        fw.close();
+      } catch (Throwable ignored) { /* must not raise from inside the handler */ }
+      if (__tasksPrevHandler != null) __tasksPrevHandler.uncaughtException(thread, throwable);
+    });
+    // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`.trim();
+function patchAppDelegate(contents) {
+  if (contents.includes("koderlabs/tasks-sdk-rn native crash hook")) return contents;
+  let next = contents.includes("@implementation AppDelegate") ? contents.replace(/@implementation AppDelegate/, `${IOS_HEADER}
+${IOS_HOOK}
+
+@implementation AppDelegate`) : `${IOS_HEADER}
+${IOS_HOOK}
+
+${contents}`;
+  next = next.replace(
+    /(- \(BOOL\)application:.*didFinishLaunchingWithOptions:.*\{)/,
+    `$1
+${IOS_INSTALL}
+`
+  );
+  return next;
+}
+function patchMainApplication(contents) {
+  if (contents.includes("koderlabs/tasks-sdk-rn native crash hook")) return contents;
+  return contents.replace(
+    /(super\.onCreate\(\);?)/,
+    `$1
+${ANDROID_HOOK}`
+  );
+}
+var withTasksNativeCrash = (config) => {
+  config = (0, import_config_plugins.withAppDelegate)(config, (cfg) => {
+    cfg.modResults.contents = patchAppDelegate(cfg.modResults.contents);
+    return cfg;
+  });
+  config = (0, import_config_plugins.withMainApplication)(config, (cfg) => {
+    cfg.modResults.contents = patchMainApplication(cfg.modResults.contents);
+    return cfg;
+  });
+  return config;
+};
+var src_default = withTasksNativeCrash;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CRASH_FILE,
+  patchAppDelegate,
+  patchMainApplication
+});

package/plugin/dist/index.d.cts

@@ -0,0 +1,55 @@
+import { ConfigPlugin } from '@expo/config-plugins';
+
+/**
+ * Expo Config Plugin: native crash capture for @koderlabs/tasks-sdk-rn.
+ *
+ * Installs platform-specific uncaught-exception handlers at native boot:
+ *
+ *   iOS   — wraps `NSSetUncaughtExceptionHandler` in AppDelegate.mm so any
+ *           ObjC NSException that escapes the runloop is serialised to JSON
+ *           and written to the app's Documents directory.
+ *
+ *   Android — registers a `Thread.UncaughtExceptionHandler` in MainApplication
+ *             that catches every uncaught Java/Kotlin throwable, serialises
+ *             the stack trace, and writes JSON to filesDir.
+ *
+ * Both handlers wrap (don't replace) any handler installed by React Native or
+ * Expo so the existing redbox / crash-reporter behaviour is preserved.
+ *
+ * On the next cold start, `@koderlabs/tasks-sdk-rn` reads the file (if any),
+ * ships it as an event with `mechanism: 'native_crash'`, then deletes it.
+ *
+ * **Limitations** (acceptable for v1):
+ *   - C-level signals (SIGSEGV, SIGBUS, SIGABRT) are NOT caught. Capturing
+ *     those needs PLCrashReporter (iOS) and Breakpad/Crashpad (Android).
+ *     Add `@koderlabs/tasks-sdk-rn-native` as a follow-up package if needed.
+ *   - Android ANRs (main-thread blocked >5s) are not detected — requires a
+ *     watchdog thread; deferred.
+ *   - The handler runs on the thread that crashed; only synchronous file
+ *     write is safe, so the JSON payload is intentionally small.
+ *
+ * Usage in `app.json`:
+ *     "plugins": [
+ *       "@koderlabs/tasks-sdk-rn"
+ *     ]
+ *
+ * The plugin auto-resolves at prebuild via Expo's discovery.
+ */
+
+/** Filename written by both platforms; SDK reads this on next launch. */
+declare const CRASH_FILE = "tasks-native-crash.json";
+/**
+ * Inject the iOS uncaught-exception hook into the project's AppDelegate.mm
+ * (Expo's Obj-C(++) bridge entry point). Idempotent — if the marker is
+ * already present we leave the file alone.
+ */
+declare function patchAppDelegate(contents: string): string;
+/**
+ * Inject the Android uncaught-exception hook into MainApplication.
+ * Expo SDK ≥ 50 uses Kotlin (`MainApplication.kt`); we target the
+ * compatible Java syntax which Kotlin's interop accepts.
+ */
+declare function patchMainApplication(contents: string): string;
+declare const withTasksNativeCrash: ConfigPlugin;
+
+export { CRASH_FILE, withTasksNativeCrash as default, patchAppDelegate, patchMainApplication };

package/plugin/dist/index.d.ts

@@ -0,0 +1,55 @@
+import { ConfigPlugin } from '@expo/config-plugins';
+
+/**
+ * Expo Config Plugin: native crash capture for @koderlabs/tasks-sdk-rn.
+ *
+ * Installs platform-specific uncaught-exception handlers at native boot:
+ *
+ *   iOS   — wraps `NSSetUncaughtExceptionHandler` in AppDelegate.mm so any
+ *           ObjC NSException that escapes the runloop is serialised to JSON
+ *           and written to the app's Documents directory.
+ *
+ *   Android — registers a `Thread.UncaughtExceptionHandler` in MainApplication
+ *             that catches every uncaught Java/Kotlin throwable, serialises
+ *             the stack trace, and writes JSON to filesDir.
+ *
+ * Both handlers wrap (don't replace) any handler installed by React Native or
+ * Expo so the existing redbox / crash-reporter behaviour is preserved.
+ *
+ * On the next cold start, `@koderlabs/tasks-sdk-rn` reads the file (if any),
+ * ships it as an event with `mechanism: 'native_crash'`, then deletes it.
+ *
+ * **Limitations** (acceptable for v1):
+ *   - C-level signals (SIGSEGV, SIGBUS, SIGABRT) are NOT caught. Capturing
+ *     those needs PLCrashReporter (iOS) and Breakpad/Crashpad (Android).
+ *     Add `@koderlabs/tasks-sdk-rn-native` as a follow-up package if needed.
+ *   - Android ANRs (main-thread blocked >5s) are not detected — requires a
+ *     watchdog thread; deferred.
+ *   - The handler runs on the thread that crashed; only synchronous file
+ *     write is safe, so the JSON payload is intentionally small.
+ *
+ * Usage in `app.json`:
+ *     "plugins": [
+ *       "@koderlabs/tasks-sdk-rn"
+ *     ]
+ *
+ * The plugin auto-resolves at prebuild via Expo's discovery.
+ */
+
+/** Filename written by both platforms; SDK reads this on next launch. */
+declare const CRASH_FILE = "tasks-native-crash.json";
+/**
+ * Inject the iOS uncaught-exception hook into the project's AppDelegate.mm
+ * (Expo's Obj-C(++) bridge entry point). Idempotent — if the marker is
+ * already present we leave the file alone.
+ */
+declare function patchAppDelegate(contents: string): string;
+/**
+ * Inject the Android uncaught-exception hook into MainApplication.
+ * Expo SDK ≥ 50 uses Kotlin (`MainApplication.kt`); we target the
+ * compatible Java syntax which Kotlin's interop accepts.
+ */
+declare function patchMainApplication(contents: string): string;
+declare const withTasksNativeCrash: ConfigPlugin;
+
+export { CRASH_FILE, withTasksNativeCrash as default, patchAppDelegate, patchMainApplication };

package/plugin/dist/index.js

@@ -0,0 +1,99 @@
+// plugin/src/index.ts
+import { withAppDelegate, withMainApplication } from "@expo/config-plugins";
+var CRASH_FILE = "tasks-native-crash.json";
+var IOS_HEADER = `// koderlabs/tasks-sdk-rn \u2014 native crash hook installed by config plugin`;
+var IOS_HOOK = `
+// \u2500\u2500\u2500 koderlabs/tasks-sdk-rn native crash hook \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+static NSUncaughtExceptionHandler *__tasksPrevExceptionHandler = NULL;
+static void __tasksUncaughtExceptionHandler(NSException *exception) {
+  NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
+  NSString *docs = [paths firstObject];
+  if (docs) {
+    NSDictionary *payload = @{
+      @"platform": @"ios",
+      @"name": exception.name ?: @"NSException",
+      @"reason": exception.reason ?: @"",
+      @"callStackSymbols": exception.callStackSymbols ?: @[],
+      @"userInfo": exception.userInfo ?: @{},
+      @"timestamp": [[NSDate date] description] ?: @"",
+    };
+    NSError *err = nil;
+    NSData *json = [NSJSONSerialization dataWithJSONObject:payload options:0 error:&err];
+    if (!err && json) {
+      NSString *path = [docs stringByAppendingPathComponent:@"${CRASH_FILE}"];
+      [json writeToFile:path atomically:YES];
+    }
+  }
+  if (__tasksPrevExceptionHandler) __tasksPrevExceptionHandler(exception);
+}
+// \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+`.trim();
+var IOS_INSTALL = `  // koderlabs/tasks-sdk-rn \u2014 chain into any handler set by RN/Expo.
+  __tasksPrevExceptionHandler = NSGetUncaughtExceptionHandler();
+  NSSetUncaughtExceptionHandler(&__tasksUncaughtExceptionHandler);`;
+var ANDROID_HOOK = `
+    // \u2500\u2500\u2500 koderlabs/tasks-sdk-rn native crash hook \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+    final Thread.UncaughtExceptionHandler __tasksPrevHandler =
+        Thread.getDefaultUncaughtExceptionHandler();
+    Thread.setDefaultUncaughtExceptionHandler((thread, throwable) -> {
+      try {
+        java.io.File f = new java.io.File(getFilesDir(), "${CRASH_FILE}");
+        org.json.JSONObject payload = new org.json.JSONObject();
+        payload.put("platform", "android");
+        payload.put("name", throwable.getClass().getName());
+        payload.put("message", throwable.getMessage() != null ? throwable.getMessage() : "");
+        java.io.StringWriter sw = new java.io.StringWriter();
+        throwable.printStackTrace(new java.io.PrintWriter(sw));
+        payload.put("stackTrace", sw.toString());
+        payload.put("threadName", thread.getName());
+        payload.put("timestamp", new java.util.Date().toString());
+        java.io.FileWriter fw = new java.io.FileWriter(f, false);
+        fw.write(payload.toString());
+        fw.close();
+      } catch (Throwable ignored) { /* must not raise from inside the handler */ }
+      if (__tasksPrevHandler != null) __tasksPrevHandler.uncaughtException(thread, throwable);
+    });
+    // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`.trim();
+function patchAppDelegate(contents) {
+  if (contents.includes("koderlabs/tasks-sdk-rn native crash hook")) return contents;
+  let next = contents.includes("@implementation AppDelegate") ? contents.replace(/@implementation AppDelegate/, `${IOS_HEADER}
+${IOS_HOOK}
+
+@implementation AppDelegate`) : `${IOS_HEADER}
+${IOS_HOOK}
+
+${contents}`;
+  next = next.replace(
+    /(- \(BOOL\)application:.*didFinishLaunchingWithOptions:.*\{)/,
+    `$1
+${IOS_INSTALL}
+`
+  );
+  return next;
+}
+function patchMainApplication(contents) {
+  if (contents.includes("koderlabs/tasks-sdk-rn native crash hook")) return contents;
+  return contents.replace(
+    /(super\.onCreate\(\);?)/,
+    `$1
+${ANDROID_HOOK}`
+  );
+}
+var withTasksNativeCrash = (config) => {
+  config = withAppDelegate(config, (cfg) => {
+    cfg.modResults.contents = patchAppDelegate(cfg.modResults.contents);
+    return cfg;
+  });
+  config = withMainApplication(config, (cfg) => {
+    cfg.modResults.contents = patchMainApplication(cfg.modResults.contents);
+    return cfg;
+  });
+  return config;
+};
+var src_default = withTasksNativeCrash;
+export {
+  CRASH_FILE,
+  src_default as default,
+  patchAppDelegate,
+  patchMainApplication
+};