@crumbsdk/react-native 0.0.1-rc.4 → 0.0.1-rc.5

package/README.md

@@ -4,6 +4,16 @@ The official Nitro Module adapter for Crumb. It is intentionally thin: the
 published Swift and Kotlin SDKs continue to own reporter presentation,
 screenshot masking, diagnostics, durable storage, and upload.
 
+## Guided setup preview
+
+The rc.5 candidate includes guided setup and automatic source-map uploads through
+the React Native package. See the [React Native and Expo setup guide](../../docs/react-native-setup.md).
+These commands are not available in the published rc.4 package yet. The existing
+installation below remains available while the new candidate is validated.
+See the [rc.5 release notes](../../docs/releases/0.0.1-rc.5.md) for exact candidate
+installation and upgrade instructions. The uploader is included automatically;
+its separate package version is an implementation dependency, not another setup step.
+
 ## Requirements
 
 - React Native 0.79 or newer

package/android/build.gradle

@@ -73,6 +73,7 @@ android {
     }
     jniLibs {
       excludes += [
+        "**/libNitroModules.so",
         "**/libc++_shared.so",
         "**/libfbjni.so",
         "**/libjsi.so",

package/app.plugin.js

@@ -1,21 +1,51 @@
 const { configurePodfile } = require('./plugin/podfile.cjs');
 const { name, version } = require('./package.json');
+const {
+  configureXcodeProject,
+  configureGradle,
+} = require('./plugin/build-hooks.cjs');
+const { readConfig } = require('./tools/config.cjs');
 
 module.exports = function withCrumb(config) {
   // Resolve Expo from the consuming app, including non-hoisted workspaces.
-  const { withPodfile, createRunOncePlugin } = require(
+  const {
+    withPodfile,
+    withXcodeProject,
+    withAppBuildGradle,
+    createRunOncePlugin,
+  } = require(
     require.resolve('expo/config-plugins', {
       paths: [config._internal?.projectRoot ?? process.cwd()],
     })
   );
   return createRunOncePlugin(
-    (appConfig) =>
-      withPodfile(appConfig, (modConfig) => {
+    (appConfig) => {
+      appConfig = withPodfile(appConfig, (modConfig) => {
         modConfig.modResults.contents = configurePodfile(
           modConfig.modResults.contents
         );
         return modConfig;
-      }),
+      });
+      if (
+        !readConfig(config._internal?.projectRoot ?? process.cwd()).sourceMaps
+          .enabled
+      )
+        return appConfig;
+      appConfig = withXcodeProject(appConfig, (modConfig) => {
+        configureXcodeProject(modConfig.modResults);
+        return modConfig;
+      });
+      return withAppBuildGradle(appConfig, (modConfig) => {
+        if (modConfig.modResults.language !== 'groovy')
+          throw new Error(
+            'Crumb automatic setup needs a Groovy app build file. Use the manual build-hook instructions for Kotlin DSL.'
+          );
+        modConfig.modResults.contents = configureGradle(
+          modConfig.modResults.contents
+        );
+        return modConfig;
+      });
+    },
     name,
     version
   )(config);

package/lib/module/build-release.js

@@ -0,0 +1,19 @@
+"use strict";
+
+export function withBuildRelease(configuration) {
+  const bundleVersion = globalThis.__CRUMB_BUNDLE_VERSION__;
+  if (typeof bundleVersion !== 'string' || !/^[A-Za-z0-9][A-Za-z0-9._+-]{0,127}$/.test(bundleVersion)) {
+    return configuration;
+  }
+  if (configuration.release?.bundleVersion !== undefined && configuration.release.bundleVersion !== bundleVersion) {
+    throw new TypeError('Crumb release.bundleVersion conflicts with the generated build identity. Remove the manual value or disable automatic source-map setup.');
+  }
+  return {
+    ...configuration,
+    release: {
+      ...configuration.release,
+      bundleVersion
+    }
+  };
+}
+//# sourceMappingURL=build-release.js.map

package/lib/module/build-release.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["withBuildRelease","configuration","bundleVersion","globalThis","__CRUMB_BUNDLE_VERSION__","test","release","undefined","TypeError"],"sourceRoot":"../../src","sources":["build-release.ts"],"mappings":";;AAOA,OAAO,SAASA,gBAAgBA,CAC9BC,aAAiC,EACb;EACpB,MAAMC,aAAa,GAAGC,UAAU,CAACC,wBAAwB;EACzD,IACE,OAAOF,aAAa,KAAK,QAAQ,IACjC,CAAC,qCAAqC,CAACG,IAAI,CAACH,aAAa,CAAC,EAC1D;IACA,OAAOD,aAAa;EACtB;EACA,IACEA,aAAa,CAACK,OAAO,EAAEJ,aAAa,KAAKK,SAAS,IAClDN,aAAa,CAACK,OAAO,CAACJ,aAAa,KAAKA,aAAa,EACrD;IACA,MAAM,IAAIM,SAAS,CACjB,yIACF,CAAC;EACH;EACA,OAAO;IACL,GAAGP,aAAa;IAChBK,OAAO,EAAE;MAAE,GAAGL,aAAa,CAACK,OAAO;MAAEJ;IAAc;EACrD,CAAC;AACH","ignoreList":[]}

package/lib/module/index.js

@@ -1,11 +1,13 @@
 "use strict";
 
 import NativeCrumbReactNative from './NativeCrumbReactNative';
+import { withBuildRelease } from "./build-release.js";
 import { currentScreenJson, setScreen, trackReactNavigation, useExpoRouterScreen } from "./screen-context.js";
 export { setScreen, trackReactNavigation, useExpoRouterScreen };
 import { configureJavaScriptCrashCapture, recoverJavaScriptCrashes } from "./javascript-crash-capture.js";
 import { clearLogs, configureLogBuffer, disableConsoleCapture, enableConsoleCapture, markNativeStarted, writeLog } from "./log-buffer.js";
-export async function start(configuration) {
+export async function start(input) {
+  const configuration = withBuildRelease(input);
   validateConfiguration(configuration);
   const logOptions = configuration.diagnostics?.logs;
   configureLogBuffer(logOptions);

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeCrumbReactNative","currentScreenJson","setScreen","trackReactNavigation","useExpoRouterScreen","configureJavaScriptCrashCapture","recoverJavaScriptCrashes","clearLogs","configureLogBuffer","disableConsoleCapture","enableConsoleCapture","markNativeStarted","writeLog","start","configuration","validateConfiguration","logOptions","diagnostics","logs","JSON","stringify","captureConsole","javascriptCrashCapture","enabled","installReporter","show","log","level","message","metadata","trim","TypeError","projectKey","environment","assertPositiveInteger","capture","maximumScreenshotDimension","maximumScreenshotBytes","timeoutMs","lookbackMs","maximumEntries","maximumBytes","renderingEnabled","undefined","assertJavaScriptCrashCapture","reporter","theme","includes","assertReporterFields","visibleFields","assertEvidence","evidence","assertApplicationMetadata","application","name","assertCustomContext","customContext","assertWorkspacePolicy","workspacePolicy","value","maximumBreadcrumbs","maximumBreadcrumbBytes","Set","size","length","some","field","supported","item","hasControlCharacters","allowedKeys","values","Array","isArray","key","isValidContextKey","entries","Object","url","URL","protocol","username","password","search","hash","test","character","Number","isSafeInteger","Crumb","freeze"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["NativeCrumbReactNative","withBuildRelease","currentScreenJson","setScreen","trackReactNavigation","useExpoRouterScreen","configureJavaScriptCrashCapture","recoverJavaScriptCrashes","clearLogs","configureLogBuffer","disableConsoleCapture","enableConsoleCapture","markNativeStarted","writeLog","start","input","configuration","validateConfiguration","logOptions","diagnostics","logs","JSON","stringify","captureConsole","javascriptCrashCapture","enabled","installReporter","show","log","level","message","metadata","trim","TypeError","projectKey","environment","assertPositiveInteger","capture","maximumScreenshotDimension","maximumScreenshotBytes","timeoutMs","lookbackMs","maximumEntries","maximumBytes","renderingEnabled","undefined","assertJavaScriptCrashCapture","reporter","theme","includes","assertReporterFields","visibleFields","assertEvidence","evidence","assertApplicationMetadata","application","name","assertCustomContext","customContext","assertWorkspacePolicy","workspacePolicy","value","maximumBreadcrumbs","maximumBreadcrumbBytes","Set","size","length","some","field","supported","item","hasControlCharacters","allowedKeys","values","Array","isArray","key","isValidContextKey","entries","Object","url","URL","protocol","username","password","search","hash","test","character","Number","isSafeInteger","Crumb","freeze"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/src/build-release.d.ts

@@ -0,0 +1,6 @@
+import type { CrumbConfiguration } from './types.js';
+declare global {
+    var __CRUMB_BUNDLE_VERSION__: unknown;
+}
+export declare function withBuildRelease(configuration: CrumbConfiguration): CrumbConfiguration;
+//# sourceMappingURL=build-release.d.ts.map

package/lib/typescript/src/build-release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-release.d.ts","sourceRoot":"","sources":["../../../src/build-release.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAS,CAAC;AAElD,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,wBAAwB,EAAE,OAAO,CAAC;CACvC;AAED,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,kBAAkB,GAChC,kBAAkB,CAoBpB"}

package/lib/typescript/src/index.d.ts

@@ -4,7 +4,7 @@ export type { CrumbScreenOptions, CrumbNavigationRef } from './screen-context.js
 import { clearLogs, disableConsoleCapture, enableConsoleCapture } from './log-buffer.js';
 import type { CrumbConfiguration, CrumbLogLevel, CrumbLogMetadata } from './types.js';
 export type { CrumbApplicationMetadata, CrumbCaptureOptions, CrumbConfiguration, CrumbCustomContextOptions, CrumbDiagnosticsOptions, CrumbJavaScriptCrashCaptureOptions, CrumbEvidenceCategory, CrumbInvocation, CrumbLogLevel, CrumbLogMetadata, CrumbLogOptions, CrumbPrivacyOptions, CrumbReporterField, CrumbReporterOptions, CrumbRelease, CrumbTheme, CrumbUploadOptions, CrumbWorkspacePolicyOptions, } from './types.js';
-export declare function start(configuration: CrumbConfiguration): Promise<void>;
+export declare function start(input: CrumbConfiguration): Promise<void>;
 export declare function installReporter(): Promise<boolean>;
 export declare function show(): Promise<boolean>;
 export declare function log(level: CrumbLogLevel, message: string, metadata?: CrumbLogMetadata): void;

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,SAAS,EACT,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,qBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qBAAkB,CAAC;AAK/E,OAAO,EACL,SAAS,EAET,qBAAqB,EACrB,oBAAoB,EAGrB,MAAM,iBAAc,CAAC;AACtB,OAAO,KAAK,EACV,kBAAkB,EAElB,aAAa,EACb,gBAAgB,EACjB,MAAM,YAAS,CAAC;AAEjB,YAAY,EACV,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,uBAAuB,EACvB,kCAAkC,EAClC,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,2BAA2B,GAC5B,MAAM,YAAS,CAAC;AAEjB,wBAAsB,KAAK,CAAC,aAAa,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB5E;AAED,wBAAgB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAElD;AAED,wBAAgB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAEvC;AAED,wBAAgB,GAAG,CACjB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,IAAI,CAKN;AAED,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,CAAC;AAoOlE,QAAA,MAAM,KAAK;;;;;;;;;;;EAWT,CAAC;AAEH,eAAe,KAAK,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,SAAS,EACT,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,qBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qBAAkB,CAAC;AAK/E,OAAO,EACL,SAAS,EAET,qBAAqB,EACrB,oBAAoB,EAGrB,MAAM,iBAAc,CAAC;AACtB,OAAO,KAAK,EACV,kBAAkB,EAElB,aAAa,EACb,gBAAgB,EACjB,MAAM,YAAS,CAAC;AAEjB,YAAY,EACV,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,uBAAuB,EACvB,kCAAkC,EAClC,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,2BAA2B,GAC5B,MAAM,YAAS,CAAC;AAEjB,wBAAsB,KAAK,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBpE;AAED,wBAAgB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAElD;AAED,wBAAgB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAEvC;AAED,wBAAgB,GAAG,CACjB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,IAAI,CAKN;AAED,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,CAAC;AAoOlE,QAAA,MAAM,KAAK;;;;;;;;;;;EAWT,CAAC;AAEH,eAAe,KAAK,CAAC"}

package/metro.cjs

@@ -0,0 +1,35 @@
+const { readRelease } = require('./tools/release.cjs');
+
+/** Preserve existing Metro options and include non-secret release metadata before app startup. */
+function withCrumb(config) {
+  if (typeof config === 'function')
+    return (...args) => withCrumb(config(...args));
+  if (config && typeof config.then === 'function')
+    return config.then(withCrumb);
+  if (!config || typeof config !== 'object')
+    throw new Error('Pass your existing Metro configuration to withCrumb.');
+  const manifest = process.env.CRUMB_RELEASE_MANIFEST;
+  if (!manifest) return config;
+  const release = readRelease(manifest);
+  const getPolyfills = config.serializer?.getPolyfills;
+  return {
+    ...config,
+    serializer: {
+      ...config.serializer,
+      getPolyfills: (...args) => [
+        ...new Set([
+          ...(getPolyfills ? getPolyfills(...args) : []),
+          release.polyfill,
+        ]),
+      ],
+    },
+    watchFolders: [
+      ...new Set([
+        ...(config.watchFolders || []),
+        require('node:path').dirname(release.polyfill),
+      ]),
+    ],
+  };
+}
+
+module.exports = { withCrumb };

package/metro.d.cts

@@ -0,0 +1,2 @@
+/** Wrap an existing object, async, or function Metro configuration without replacing its options. */
+export function withCrumb<T extends object>(config: T): T;

package/native/ios/VERSION

@@ -1 +1 @@
-0.0.1-rc.4
+0.0.1-rc.5

package/native/ios/packages/ios/Sources/CrumbCore/Crumb.swift

@@ -24,7 +24,7 @@ public enum Crumb {
               settings.diagnostics.javascriptCrashCaptureEnabled else {
             return
         }
-        _ = CrumbJavaScriptCrashStore.shared.record(recordJSON, failureContext: CrumbJavaScriptFailureContext.capture(settings: settings), includeBreadcrumbs: settings.diagnostics.logs.enabled && settings.evidence.contains(.logs))
+        _ = CrumbJavaScriptCrashStore.shared.record(recordJSON, failureContext: CrumbJavaScriptFailureContext.capture(settings: settings), includeBreadcrumbs: settings.diagnostics.logs.enabled && settings.evidence.contains(.logs), release: settings.release)
     }
 
     /// Moves pending JavaScript failures into the regular durable report queue.

package/native/ios/packages/ios/Sources/CrumbCore/CrumbJavaScriptCrashStore.swift

@@ -22,7 +22,7 @@ package struct CrumbJavaScriptCrash: Equatable, Sendable {
     package let message: String
     package let stack: String?
     package let occurredAt: Date
-    package let release: CrumbJavaScriptCrashRelease
+    package var release: CrumbJavaScriptCrashRelease
     package var breadcrumbs: [CrumbJavaScriptBreadcrumb]
     package let context: [String: String]
     package let isFatal: Bool
@@ -80,7 +80,7 @@ package final class CrumbJavaScriptCrashStore: @unchecked Sendable {
     }
 
     @discardableResult
-    package func record(_ recordJSON: String, failureContext: CrumbJavaScriptFailureContext? = nil, includeBreadcrumbs: Bool = true) -> Bool {
+    package func record(_ recordJSON: String, failureContext: CrumbJavaScriptFailureContext? = nil, includeBreadcrumbs: Bool = true, release: CrumbRelease? = nil) -> Bool {
         lock.lock()
         defer { lock.unlock() }
 
@@ -94,6 +94,12 @@ package final class CrumbJavaScriptCrashStore: @unchecked Sendable {
 
         // The JS payload cannot supply native context. Only the trusted capture argument can.
         record.failureContext = failureContext?.validated()
+        // Freeze native defaults at failure time, before a later app update can change them.
+        record.release = CrumbJavaScriptCrashRelease(
+            appVersion: record.release.appVersion ?? release?.appVersion,
+            nativeBuild: record.release.nativeBuild ?? release?.nativeBuild,
+            bundleVersion: record.release.bundleVersion ?? release?.bundleVersion
+        )
         if !includeBreadcrumbs { record.breadcrumbs = [] }
 
         do {

package/native/ios/packages/ios/Sources/CrumbCore/CrumbSDKVersion.swift

@@ -1,5 +1,5 @@
 // Generated from the repository VERSION file. Do not edit by hand.
 
 public enum CrumbSDKVersion {
-    public static let current = "0.0.1-rc.4"
+    public static let current = "0.0.1-rc.5"
 }

package/native/ios/provenance.json

@@ -1,5 +1,5 @@
 {
-  "nativeVersion": "0.0.1-rc.4",
+  "nativeVersion": "0.0.1-rc.5",
   "PLCrashReporter": {
     "version": "1.12.0",
     "url": "https://github.com/microsoft/plcrashreporter/releases/download/1.12.0/PLCrashReporter-Static-1.12.0.xcframework.zip",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crumbsdk/react-native",
-  "version": "0.0.1-rc.4",
+  "version": "0.0.1-rc.5",
   "description": "React Native adapter for the native Crumb issue-reporting SDK",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -11,7 +11,11 @@
       "default": "./lib/module/index.js"
     },
     "./package.json": "./package.json",
-    "./app.plugin.js": "./app.plugin.js"
+    "./app.plugin.js": "./app.plugin.js",
+    "./metro": {
+      "types": "./metro.d.cts",
+      "default": "./metro.cjs"
+    }
   },
   "files": [
     "src",
@@ -31,7 +35,10 @@
     "native",
     "scripts/ios.rb",
     "app.plugin.js",
-    "plugin"
+    "plugin",
+    "metro.cjs",
+    "tools",
+    "metro.d.cts"
   ],
   "scripts": {
     "example": "yarn workspace @crumbsdk/react-native-example",
@@ -72,7 +79,7 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "crumbNativeVersion": "0.0.1-rc.4",
+  "crumbNativeVersion": "0.0.1-rc.5",
   "devDependencies": {
     "@babel/core": "7.29.7",
     "@eslint/compat": "2.1.0",
@@ -144,5 +151,12 @@
       "jest"
     ],
     "version": "0.63.0"
+  },
+  "dependencies": {
+    "@crumbsdk/source-maps": "0.0.1-rc.4",
+    "xcode": "3.0.1"
+  },
+  "bin": {
+    "crumb": "tools/cli.cjs"
   }
 }

package/plugin/build-hooks.cjs

@@ -0,0 +1,52 @@
+const marker = 'crumb-release-build';
+
+function shellQuote(value) {
+  return `'${value.replaceAll("'", "'\\''")}'`;
+}
+
+function configureXcodeProject(project) {
+  let found = false;
+  for (const phase of Object.values(
+    project.hash.project.objects.PBXShellScriptBuildPhase || {}
+  )) {
+    if (!phase || typeof phase.shellScript !== 'string') continue;
+    // Expo mods can supply literal control characters inside the quoted PBX value.
+    const original = phase.shellScript.startsWith('"')
+      ? JSON.parse(
+          phase.shellScript
+            .replaceAll('\n', '\\n')
+            .replaceAll('\r', '\\r')
+            .replaceAll('\t', '\\t')
+        )
+      : phase.shellScript;
+    if (original.includes(marker)) {
+      found = true;
+      continue;
+    }
+    if (!original.includes('react-native-xcode.sh')) continue;
+    const wrapper = `# ${marker}
+set -e
+if [ -f "$PODS_ROOT/../.xcode.env" ]; then . "$PODS_ROOT/../.xcode.env"; fi
+if [ -f "$PODS_ROOT/../.xcode.env.local" ]; then . "$PODS_ROOT/../.xcode.env.local"; fi
+NODE_BINARY="\${NODE_BINARY:-node}"
+CRUMB_PACKAGE_DIR="$("$NODE_BINARY" --print "require('path').dirname(require.resolve('@crumbsdk/react-native/package.json'))")"
+"$NODE_BINARY" "$CRUMB_PACKAGE_DIR/tools/ios.cjs" /bin/bash -c ${shellQuote(original)}
+`;
+    phase.shellScript = JSON.stringify(wrapper);
+    // The original native script and the wrapper own their incremental outputs.
+    phase.alwaysOutOfDate = 1;
+    found = true;
+  }
+  if (!found)
+    throw new Error(
+      'Crumb could not locate the React Native Xcode bundle phase. See the manual build-hook instructions.'
+    );
+  return project;
+}
+
+function configureGradle(contents) {
+  if (contents.includes(marker)) return contents;
+  return `${contents}\n// ${marker}\napply from: new File(["node", "--print", "require.resolve('@crumbsdk/react-native/package.json')"].execute(null, rootDir).text.trim()).parentFile.toPath().resolve("tools/crumb.gradle").toFile()\n`;
+}
+
+module.exports = { configureXcodeProject, configureGradle };

package/src/build-release.ts

@@ -0,0 +1,30 @@
+import type { CrumbConfiguration } from './types';
+
+declare global {
+  // Written by the release build polyfill before application modules execute.
+  var __CRUMB_BUNDLE_VERSION__: unknown;
+}
+
+export function withBuildRelease(
+  configuration: CrumbConfiguration
+): CrumbConfiguration {
+  const bundleVersion = globalThis.__CRUMB_BUNDLE_VERSION__;
+  if (
+    typeof bundleVersion !== 'string' ||
+    !/^[A-Za-z0-9][A-Za-z0-9._+-]{0,127}$/.test(bundleVersion)
+  ) {
+    return configuration;
+  }
+  if (
+    configuration.release?.bundleVersion !== undefined &&
+    configuration.release.bundleVersion !== bundleVersion
+  ) {
+    throw new TypeError(
+      'Crumb release.bundleVersion conflicts with the generated build identity. Remove the manual value or disable automatic source-map setup.'
+    );
+  }
+  return {
+    ...configuration,
+    release: { ...configuration.release, bundleVersion },
+  };
+}

package/src/index.ts

@@ -1,4 +1,5 @@
 import NativeCrumbReactNative from './NativeCrumbReactNative';
+import { withBuildRelease } from './build-release';
 import {
   currentScreenJson,
   setScreen,
@@ -47,7 +48,8 @@ export type {
   CrumbWorkspacePolicyOptions,
 } from './types';
 
-export async function start(configuration: CrumbConfiguration): Promise<void> {
+export async function start(input: CrumbConfiguration): Promise<void> {
+  const configuration = withBuildRelease(input);
   validateConfiguration(configuration);
   const logOptions = configuration.diagnostics?.logs;
   configureLogBuffer(logOptions);

package/tools/cli.cjs

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+const fs = require('node:fs');
+const path = require('node:path');
+const { parseArgs } = require('node:util');
+const { createInterface } = require('node:readline/promises');
+const { setupPlan, applyPlan, doctor } = require('./setup.cjs');
+const { prepareRelease } = require('./release.cjs');
+const { uploadRelease, retryUpload } = require('./upload.cjs');
+
+async function main() {
+  if (Number(process.versions.node.split('.')[0]) < 22)
+    throw new Error('Crumb build tooling requires Node.js 22 or newer.');
+  const { positionals, values } = parseArgs({
+    allowPositionals: true,
+    options: {
+      help: { type: 'boolean' },
+      apply: { type: 'boolean' },
+      'source-maps': { type: 'boolean' },
+      'upload-url': { type: 'string' },
+      root: { type: 'string' },
+      directory: { type: 'string' },
+      input: { type: 'string' },
+      receipt: { type: 'string' },
+      output: { type: 'string' },
+      targets: { type: 'string' },
+      'dry-run': { type: 'boolean' },
+    },
+  });
+  const root = path.resolve(values.root || process.cwd());
+  const [command] = positionals;
+  if (values.help || !command) {
+    console.log(
+      'crumb setup [--source-maps --upload-url HTTPS_ORIGIN] [--apply]\ncrumb doctor\ncrumb retry --receipt FILE\ncrumb export --output DIRECTORY --targets FILE [--dry-run]\n\nSetup previews changes; --apply accepts them without prompting. Upload credentials belong only in CRUMB_SOURCE_MAP_TOKEN.'
+    );
+    return;
+  }
+  if (command === 'setup') {
+    let sourceMaps = values['source-maps'];
+    let uploadUrl = values['upload-url'];
+    const prompt =
+      process.stdin.isTTY && !values.apply
+        ? createInterface({ input: process.stdin, output: process.stdout })
+        : undefined;
+    try {
+      if (prompt && sourceMaps === undefined)
+        sourceMaps = /^y(es)?$/i.test(
+          await prompt.question(
+            'Configure source maps for opt-in JavaScript crashes? [y/N] '
+          )
+        );
+      if (prompt && sourceMaps && !uploadUrl)
+        uploadUrl = await prompt.question(
+          'Upload origin from your Crumb integration page: '
+        );
+      const plan = setupPlan(root, { sourceMaps, uploadUrl });
+      console.log(`Crumb setup: ${plan.framework}`);
+      for (const change of plan.changes)
+        console.log(
+          `- ${change.before === undefined ? 'Create' : 'Update'} ${change.name}`
+        );
+      console.log(
+        'Setup adds Crumb configuration, preserves existing settings, and wraps supported build hooks. Review the resulting diff before committing.'
+      );
+      if (
+        values.apply ||
+        (prompt &&
+          /^y(es)?$/i.test(
+            await prompt.question(
+              `Apply ${plan.changes.length} reviewed file changes? [y/N] `
+            )
+          ))
+      ) {
+        applyPlan(plan);
+        console.log('Setup changes applied.');
+      } else
+        console.log(
+          'Preview only. Run again with --apply to apply these changes.'
+        );
+      for (const instruction of plan.instructions)
+        console.log(`- ${instruction}`);
+    } finally {
+      prompt?.close();
+    }
+  } else if (command === 'doctor') {
+    const result = doctor(root);
+    console.log(JSON.stringify(result, null, 2));
+    if (result.checks.some((check) => check.status === 'missing'))
+      process.exitCode = 1;
+  } else if (command === 'prepare' && values.directory) {
+    prepareRelease(path.resolve(values.directory));
+  } else if (command === 'upload-build' && values.input) {
+    uploadRelease(JSON.parse(fs.readFileSync(values.input, 'utf8')), {
+      dryRun: values['dry-run'],
+    });
+  } else if (command === 'export' && values.output && values.targets) {
+    require('./expo-export.cjs').exportRelease(
+      root,
+      values.output,
+      values.targets,
+      { dryRun: values['dry-run'] }
+    );
+  } else if (command === 'retry' && values.receipt) {
+    retryUpload(values.receipt);
+  } else
+    throw new Error('Unknown or incomplete Crumb command. Run crumb --help.');
+}
+
+main().catch((error) => {
+  const message =
+    error instanceof SyntaxError ||
+    String(error.code).startsWith('ERR_PARSE_ARGS')
+      ? 'Invalid command or JSON input. Run crumb --help; keep credentials only in the build environment.'
+      : error.message;
+  console.error(`Crumb: ${message}`);
+  process.exitCode = 1;
+});

package/tools/config.cjs

@@ -0,0 +1,72 @@
+const fs = require('node:fs');
+const path = require('node:path');
+
+function readConfig(root) {
+  const file = path.join(root, 'crumb.config.json');
+  if (!fs.existsSync(file))
+    return { version: 1, sourceMaps: { enabled: false } };
+  let config;
+  try {
+    config = JSON.parse(fs.readFileSync(file, 'utf8'));
+  } catch {
+    throw new Error(
+      'Could not read crumb.config.json. Check that it contains valid JSON without credentials.'
+    );
+  }
+  if (
+    !config ||
+    typeof config !== 'object' ||
+    Array.isArray(config) ||
+    config.version !== 1 ||
+    !config.sourceMaps ||
+    typeof config.sourceMaps !== 'object' ||
+    Array.isArray(config.sourceMaps) ||
+    Object.keys(config).some(
+      (key) => !['version', 'sourceMaps'].includes(key)
+    ) ||
+    Object.keys(config.sourceMaps).some(
+      (key) => !['enabled', 'uploadUrl', 'strict'].includes(key)
+    ) ||
+    typeof config.sourceMaps.enabled !== 'boolean' ||
+    (config.sourceMaps.strict !== undefined &&
+      typeof config.sourceMaps.strict !== 'boolean')
+  ) {
+    throw new Error(
+      'Invalid crumb.config.json. Use crumb setup; keep credentials only in the build environment.'
+    );
+  }
+  if (config.sourceMaps.enabled) validateOrigin(config.sourceMaps.uploadUrl);
+  return config;
+}
+
+function validateOrigin(value) {
+  let url;
+  try {
+    url = new URL(value);
+  } catch {
+    throw new Error(
+      'Supply the HTTPS upload origin shown in your Crumb integration instructions.'
+    );
+  }
+  if (
+    url.protocol !== 'https:' ||
+    url.username ||
+    url.password ||
+    url.search ||
+    url.hash ||
+    url.pathname !== '/'
+  ) {
+    throw new Error(
+      'The upload origin must use HTTPS without a path, credentials, query, or fragment.'
+    );
+  }
+  return url.origin;
+}
+
+function isStrict(config, env = process.env) {
+  return (
+    env.CRUMB_SOURCE_MAP_STRICT === '1' || config.sourceMaps.strict === true
+  );
+}
+
+module.exports = { readConfig, validateOrigin, isStrict };