@allstak/react-native 0.3.4 → 0.4.1

package/dist/build/sourcemaps.js

@@ -83,15 +83,14 @@ async function uploadReactNativeSourcemap(opts) {
   const log = opts.silent ? () => void 0 : (m) => console.log(`[allstak/sourcemaps] ${m}`);
   const inject = injectReactNativeSourcemap(opts);
   log(`bundle: ${(0, import_node_path.basename)(opts.bundle)}  debugId: ${inject.debugId} ${inject.reused ? "(reused)" : "(new)"}`);
-  const env = loadAllStakEnv();
-  const token = opts.token ?? env.ALLSTAK_UPLOAD_TOKEN;
+  const token = opts.token ?? process.env.ALLSTAK_UPLOAD_TOKEN;
   if (opts.injectOnly || !token) {
     if (!opts.injectOnly && !token) {
       log("skipping upload \u2014 no token (set ALLSTAK_UPLOAD_TOKEN or pass `token`)");
     }
     return inject;
   }
-  const host = opts.host ?? env.ALLSTAK_HOST ?? DEFAULT_HOST;
+  const host = opts.host ?? process.env.ALLSTAK_HOST ?? DEFAULT_HOST;
   const stripSources = opts.stripSources ?? false;
   const steps = [];
   const mapResult = await uploadOne(
@@ -134,21 +133,6 @@ async function uploadReactNativeSourcemap(opts) {
   }
   return { ...inject, uploaded: allOk, steps };
 }
-function loadAllStakEnv() {
-  const out = { ...process.env };
-  for (const file of [".env.local", ".env"]) {
-    const full = (0, import_node_path.resolve)(process.cwd(), file);
-    if (!(0, import_node_fs.existsSync)(full)) continue;
-    for (const line of (0, import_node_fs.readFileSync)(full, "utf8").split(/\r?\n/)) {
-      const trimmed = line.trim();
-      if (!trimmed || trimmed.startsWith("#")) continue;
-      const match = /^([A-Z0-9_]+)\s*=\s*(.*)$/.exec(trimmed);
-      if (!match || out[match[1]] !== void 0) continue;
-      out[match[1]] = match[2].replace(/^['"]|['"]$/g, "");
-    }
-  }
-  return out;
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_HOST,

package/dist/build/sourcemaps.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/build/sourcemaps.ts"],"sourcesContent":["/**\n * Source-map upload pipeline for React Native (Metro / Hermes). Build-time only.\n *\n * Metro emits one bundle + one source map per build, so the React Native\n * flow is simpler than the React-web flow (no `dist/` walk needed). The\n * developer hands us the bundle + map paths produced by:\n *\n *   npx react-native bundle \\\n *     --platform ios --dev false --entry-file index.js \\\n *     --bundle-output ios.bundle \\\n *     --sourcemap-output ios.bundle.map\n *\n * If Hermes is enabled, the resulting `.hbc` bytecode replaces the JS\n * bundle on the device, and the user must compose the Metro map with the\n * Hermes map BEFORE uploading. We accept whatever map the user gives us\n * and inject a debug-id into both the map and the bundle.\n *\n * Usage from a build script (`scripts/upload-sourcemaps.js`):\n *\n *   const { uploadReactNativeSourcemap } = require('@allstak/react-native/sourcemaps');\n *\n *   await uploadReactNativeSourcemap({\n *     bundle: 'ios.bundle',\n *     sourcemap: 'ios.bundle.map',\n *     release: 'mobile@1.2.3',\n *     dist: 'ios-hermes',\n *     token: process.env.ALLSTAK_UPLOAD_TOKEN,\n *   });\n *\n * Or `injectOnly: true` to add the debug-id without uploading (useful in\n * CI dry-runs or when you don't have an upload token yet).\n */\n\nimport { existsSync, readFileSync, writeFileSync } from 'node:fs';\nimport { randomUUID, createHash } from 'node:crypto';\nimport { basename, resolve } from 'node:path';\n\nexport const DEFAULT_HOST = 'https://api.allstak.sa';\n\nconst DEBUG_ID_LINE_RE = /^\\/\\/# debugId=([0-9a-f-]{36})\\s*$/m;\n\nexport interface UploadReactNativeSourcemapOptions {\n  /** Path to the JS/Hermes-bytecode bundle (Metro's `--bundle-output`). */\n  bundle: string;\n  /** Path to the matching `.map` (Metro's `--sourcemap-output`). */\n  sourcemap: string;\n  /** Release identifier (e.g. `mobile@1.2.3` — match `release` in AllStak.init). */\n  release: string;\n  /**\n   * Distribution tag — recommended values: `ios-hermes`, `android-hermes`,\n   * `ios-jsc`, `android-jsc`. Match the `dist` the SDK auto-detects at\n   * runtime (see `src/install.ts`). Required for the symbolicator to\n   * pick the right map per platform.\n   */\n  dist?: string;\n  /** Project upload token (`aspk_…`). Defaults to `ALLSTAK_UPLOAD_TOKEN`. */\n  token?: string;\n  /** Override ingest host. Defaults to `ALLSTAK_HOST` or production. */\n  host?: string;\n  /** Drop `sourcesContent` from the map before upload (smaller payload). */\n  stripSources?: boolean;\n  /** Also upload the JS/HBC bundle alongside the map. Off by default. */\n  uploadBundle?: boolean;\n  /** Inject debug-id but skip the upload (CI dry-run). */\n  injectOnly?: boolean;\n  /** Pre-existing debug-id to use instead of generating one. Optional. */\n  debugId?: string;\n  /** Suppress per-step console output. Default false. */\n  silent?: boolean;\n}\n\nexport interface UploadReactNativeSourcemapResult {\n  /** The debug-id injected into the bundle + map. */\n  debugId: string;\n  /** True if the bundle already had a debug-id; we reused it. */\n  reused: boolean;\n  /** True when upload(s) succeeded — undefined when `injectOnly: true`. */\n  uploaded?: boolean;\n  /** Per-artifact responses, in the order we sent them. */\n  steps?: Array<{ type: 'sourcemap' | 'bundle'; status: number; sha8: string; body?: string }>;\n}\n\nfunction sha8(buf: Buffer): string {\n  return createHash('sha256').update(buf).digest('hex').slice(0, 8);\n}\n\n/**\n * Inject a debug-id into the bundle + map (idempotent — reuses an\n * existing id if present).\n */\nexport function injectReactNativeSourcemap(\n  opts: Pick<UploadReactNativeSourcemapOptions, 'bundle' | 'sourcemap' | 'debugId'>,\n): { debugId: string; reused: boolean } {\n  const bundleRaw = readFileSync(opts.bundle, 'utf8');\n  const mapRaw = readFileSync(opts.sourcemap, 'utf8');\n  const map = JSON.parse(mapRaw) as { debugId?: unknown; [k: string]: unknown };\n\n  let debugId = opts.debugId ?? '';\n  if (!debugId && typeof map.debugId === 'string') debugId = map.debugId;\n  const existing = DEBUG_ID_LINE_RE.exec(bundleRaw);\n  if (!debugId && existing && existing[1]) debugId = existing[1];\n  const reused = !!debugId;\n  if (!debugId) debugId = randomUUID();\n\n  // Re-stringify map with canonical debugId field.\n  map.debugId = debugId;\n  writeFileSync(opts.sourcemap, JSON.stringify(map));\n\n  // Append `//# debugId=…` to the bundle (idempotent — strip prior line first).\n  let bundleOut = bundleRaw.replace(DEBUG_ID_LINE_RE, '');\n  bundleOut = bundleOut.replace(/\\s+$/, '');\n  bundleOut += `\\n//# debugId=${debugId}\\n`;\n  writeFileSync(opts.bundle, bundleOut);\n\n  return { debugId, reused };\n}\n\nasync function uploadOne(\n  type: 'sourcemap' | 'bundle',\n  filePath: string,\n  debugId: string,\n  release: string,\n  host: string,\n  token: string,\n  dist: string | undefined,\n  stripSources: boolean,\n): Promise<{ status: number; body: string; ok: boolean }> {\n  let buf = readFileSync(filePath);\n  if (type === 'sourcemap' && stripSources) {\n    const json = JSON.parse(buf.toString('utf8')) as { sourcesContent?: unknown };\n    if (Array.isArray(json.sourcesContent)) delete json.sourcesContent;\n    buf = Buffer.from(JSON.stringify(json));\n  }\n\n  const form = new FormData();\n  form.append('debugId', debugId);\n  form.append('type', type);\n  form.append('release', release);\n  if (dist) form.append('dist', dist);\n  form.append(\n    'file',\n    new Blob([buf], {\n      type: type === 'sourcemap' ? 'application/json' : 'application/javascript',\n    }),\n    basename(filePath),\n  );\n\n  const res = await fetch(host.replace(/\\/$/, '') + '/api/v1/artifacts/upload', {\n    method: 'POST',\n    headers: { 'X-AllStak-Upload-Token': token },\n    body: form,\n  });\n  return { status: res.status, body: await res.text(), ok: res.ok };\n}\n\n/**\n * Inject debug-id into the bundle + map and (optionally) upload.\n *\n * Returns the debug-id (so the caller can stash it for symbolicator\n * lookups), whether it was reused, and per-step upload statuses.\n */\nexport async function uploadReactNativeSourcemap(\n  opts: UploadReactNativeSourcemapOptions,\n): Promise<UploadReactNativeSourcemapResult> {\n  const log = opts.silent ? () => undefined : (m: string) => console.log(`[allstak/sourcemaps] ${m}`);\n\n  const inject = injectReactNativeSourcemap(opts);\n  log(`bundle: ${basename(opts.bundle)}  debugId: ${inject.debugId} ${inject.reused ? '(reused)' : '(new)'}`);\n\n  const env = loadAllStakEnv();\n  const token = opts.token ?? env.ALLSTAK_UPLOAD_TOKEN;\n  if (opts.injectOnly || !token) {\n    if (!opts.injectOnly && !token) {\n      log('skipping upload — no token (set ALLSTAK_UPLOAD_TOKEN or pass `token`)');\n    }\n    return inject;\n  }\n\n  const host = opts.host ?? env.ALLSTAK_HOST ?? DEFAULT_HOST;\n  const stripSources = opts.stripSources ?? false;\n\n  const steps: UploadReactNativeSourcemapResult['steps'] = [];\n  const mapResult = await uploadOne(\n    'sourcemap', opts.sourcemap, inject.debugId, opts.release, host, token, opts.dist, stripSources,\n  );\n  steps.push({\n    type: 'sourcemap',\n    status: mapResult.status,\n    sha8: sha8(readFileSync(opts.sourcemap)),\n    body: mapResult.ok ? undefined : mapResult.body,\n  });\n  log(`  sourcemap → ${mapResult.status}${mapResult.ok ? '' : ' ' + mapResult.body.slice(0, 120)}`);\n\n  let allOk = mapResult.ok;\n  if (opts.uploadBundle) {\n    const bundleResult = await uploadOne(\n      'bundle', opts.bundle, inject.debugId, opts.release, host, token, opts.dist, false,\n    );\n    steps.push({\n      type: 'bundle',\n      status: bundleResult.status,\n      sha8: sha8(readFileSync(opts.bundle)),\n      body: bundleResult.ok ? undefined : bundleResult.body,\n    });\n    allOk = allOk && bundleResult.ok;\n    log(`  bundle    → ${bundleResult.status}${bundleResult.ok ? '' : ' ' + bundleResult.body.slice(0, 120)}`);\n  }\n\n  return { ...inject, uploaded: allOk, steps };\n}\n\nfunction loadAllStakEnv(): Record<string, string | undefined> {\n  const out: Record<string, string | undefined> = { ...process.env };\n  for (const file of ['.env.local', '.env']) {\n    const full = resolve(process.cwd(), file);\n    if (!existsSync(full)) continue;\n    for (const line of readFileSync(full, 'utf8').split(/\\r?\\n/)) {\n      const trimmed = line.trim();\n      if (!trimmed || trimmed.startsWith('#')) continue;\n      const match = /^([A-Z0-9_]+)\\s*=\\s*(.*)$/.exec(trimmed);\n      if (!match || out[match[1]!] !== undefined) continue;\n      out[match[1]!] = match[2]!.replace(/^['\"]|['\"]$/g, '');\n    }\n  }\n  return out;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/build/sourcemaps.ts"],"sourcesContent":["/**\n * Source-map upload pipeline for React Native (Metro / Hermes). Build-time only.\n *\n * Metro emits one bundle + one source map per build, so the React Native\n * flow is simpler than the React-web flow (no `dist/` walk needed). The\n * developer hands us the bundle + map paths produced by:\n *\n *   npx react-native bundle \\\n *     --platform ios --dev false --entry-file index.js \\\n *     --bundle-output ios.bundle \\\n *     --sourcemap-output ios.bundle.map\n *\n * If Hermes is enabled, the resulting `.hbc` bytecode replaces the JS\n * bundle on the device, and the user must compose the Metro map with the\n * Hermes map BEFORE uploading. We accept whatever map the user gives us\n * and inject a debug-id into both the map and the bundle.\n *\n * Usage from a build script (`scripts/upload-sourcemaps.js`):\n *\n *   const { uploadReactNativeSourcemap } = require('@allstak/react-native/sourcemaps');\n *\n *   await uploadReactNativeSourcemap({\n *     bundle: 'ios.bundle',\n *     sourcemap: 'ios.bundle.map',\n *     release: 'mobile@1.2.3',\n *     dist: 'ios-hermes',\n *     token: process.env.ALLSTAK_UPLOAD_TOKEN,\n *   });\n *\n * Or `injectOnly: true` to add the debug-id without uploading (useful in\n * CI dry-runs or when you don't have an upload token yet).\n */\n\nimport { readFileSync, writeFileSync } from 'node:fs';\nimport { randomUUID, createHash } from 'node:crypto';\nimport { basename } from 'node:path';\n\nexport const DEFAULT_HOST = 'https://api.allstak.sa';\n\nconst DEBUG_ID_LINE_RE = /^\\/\\/# debugId=([0-9a-f-]{36})\\s*$/m;\n\nexport interface UploadReactNativeSourcemapOptions {\n  /** Path to the JS/Hermes-bytecode bundle (Metro's `--bundle-output`). */\n  bundle: string;\n  /** Path to the matching `.map` (Metro's `--sourcemap-output`). */\n  sourcemap: string;\n  /** Release identifier (e.g. `mobile@1.2.3` — match `release` in AllStak.init). */\n  release: string;\n  /**\n   * Distribution tag — recommended values: `ios-hermes`, `android-hermes`,\n   * `ios-jsc`, `android-jsc`. Match the `dist` the SDK auto-detects at\n   * runtime (see `src/install.ts`). Required for the symbolicator to\n   * pick the right map per platform.\n   */\n  dist?: string;\n  /** Project upload token (`aspk_…`). Defaults to `ALLSTAK_UPLOAD_TOKEN`. */\n  token?: string;\n  /** Override ingest host. Defaults to `ALLSTAK_HOST` or production. */\n  host?: string;\n  /** Drop `sourcesContent` from the map before upload (smaller payload). */\n  stripSources?: boolean;\n  /** Also upload the JS/HBC bundle alongside the map. Off by default. */\n  uploadBundle?: boolean;\n  /** Inject debug-id but skip the upload (CI dry-run). */\n  injectOnly?: boolean;\n  /** Pre-existing debug-id to use instead of generating one. Optional. */\n  debugId?: string;\n  /** Suppress per-step console output. Default false. */\n  silent?: boolean;\n}\n\nexport interface UploadReactNativeSourcemapResult {\n  /** The debug-id injected into the bundle + map. */\n  debugId: string;\n  /** True if the bundle already had a debug-id; we reused it. */\n  reused: boolean;\n  /** True when upload(s) succeeded — undefined when `injectOnly: true`. */\n  uploaded?: boolean;\n  /** Per-artifact responses, in the order we sent them. */\n  steps?: Array<{ type: 'sourcemap' | 'bundle'; status: number; sha8: string; body?: string }>;\n}\n\nfunction sha8(buf: Buffer): string {\n  return createHash('sha256').update(buf).digest('hex').slice(0, 8);\n}\n\n/**\n * Inject a debug-id into the bundle + map (idempotent — reuses an\n * existing id if present).\n */\nexport function injectReactNativeSourcemap(\n  opts: Pick<UploadReactNativeSourcemapOptions, 'bundle' | 'sourcemap' | 'debugId'>,\n): { debugId: string; reused: boolean } {\n  const bundleRaw = readFileSync(opts.bundle, 'utf8');\n  const mapRaw = readFileSync(opts.sourcemap, 'utf8');\n  const map = JSON.parse(mapRaw) as { debugId?: unknown; [k: string]: unknown };\n\n  let debugId = opts.debugId ?? '';\n  if (!debugId && typeof map.debugId === 'string') debugId = map.debugId;\n  const existing = DEBUG_ID_LINE_RE.exec(bundleRaw);\n  if (!debugId && existing && existing[1]) debugId = existing[1];\n  const reused = !!debugId;\n  if (!debugId) debugId = randomUUID();\n\n  // Re-stringify map with canonical debugId field.\n  map.debugId = debugId;\n  writeFileSync(opts.sourcemap, JSON.stringify(map));\n\n  // Append `//# debugId=…` to the bundle (idempotent — strip prior line first).\n  let bundleOut = bundleRaw.replace(DEBUG_ID_LINE_RE, '');\n  bundleOut = bundleOut.replace(/\\s+$/, '');\n  bundleOut += `\\n//# debugId=${debugId}\\n`;\n  writeFileSync(opts.bundle, bundleOut);\n\n  return { debugId, reused };\n}\n\nasync function uploadOne(\n  type: 'sourcemap' | 'bundle',\n  filePath: string,\n  debugId: string,\n  release: string,\n  host: string,\n  token: string,\n  dist: string | undefined,\n  stripSources: boolean,\n): Promise<{ status: number; body: string; ok: boolean }> {\n  let buf = readFileSync(filePath);\n  if (type === 'sourcemap' && stripSources) {\n    const json = JSON.parse(buf.toString('utf8')) as { sourcesContent?: unknown };\n    if (Array.isArray(json.sourcesContent)) delete json.sourcesContent;\n    buf = Buffer.from(JSON.stringify(json));\n  }\n\n  const form = new FormData();\n  form.append('debugId', debugId);\n  form.append('type', type);\n  form.append('release', release);\n  if (dist) form.append('dist', dist);\n  form.append(\n    'file',\n    new Blob([buf], {\n      type: type === 'sourcemap' ? 'application/json' : 'application/javascript',\n    }),\n    basename(filePath),\n  );\n\n  const res = await fetch(host.replace(/\\/$/, '') + '/api/v1/artifacts/upload', {\n    method: 'POST',\n    headers: { 'X-AllStak-Upload-Token': token },\n    body: form,\n  });\n  return { status: res.status, body: await res.text(), ok: res.ok };\n}\n\n/**\n * Inject debug-id into the bundle + map and (optionally) upload.\n *\n * Returns the debug-id (so the caller can stash it for symbolicator\n * lookups), whether it was reused, and per-step upload statuses.\n */\nexport async function uploadReactNativeSourcemap(\n  opts: UploadReactNativeSourcemapOptions,\n): Promise<UploadReactNativeSourcemapResult> {\n  const log = opts.silent ? () => undefined : (m: string) => console.log(`[allstak/sourcemaps] ${m}`);\n\n  const inject = injectReactNativeSourcemap(opts);\n  log(`bundle: ${basename(opts.bundle)}  debugId: ${inject.debugId} ${inject.reused ? '(reused)' : '(new)'}`);\n\n  const token = opts.token ?? process.env.ALLSTAK_UPLOAD_TOKEN;\n  if (opts.injectOnly || !token) {\n    if (!opts.injectOnly && !token) {\n      log('skipping upload — no token (set ALLSTAK_UPLOAD_TOKEN or pass `token`)');\n    }\n    return inject;\n  }\n\n  const host = opts.host ?? process.env.ALLSTAK_HOST ?? DEFAULT_HOST;\n  const stripSources = opts.stripSources ?? false;\n\n  const steps: UploadReactNativeSourcemapResult['steps'] = [];\n  const mapResult = await uploadOne(\n    'sourcemap', opts.sourcemap, inject.debugId, opts.release, host, token, opts.dist, stripSources,\n  );\n  steps.push({\n    type: 'sourcemap',\n    status: mapResult.status,\n    sha8: sha8(readFileSync(opts.sourcemap)),\n    body: mapResult.ok ? undefined : mapResult.body,\n  });\n  log(`  sourcemap → ${mapResult.status}${mapResult.ok ? '' : ' ' + mapResult.body.slice(0, 120)}`);\n\n  let allOk = mapResult.ok;\n  if (opts.uploadBundle) {\n    const bundleResult = await uploadOne(\n      'bundle', opts.bundle, inject.debugId, opts.release, host, token, opts.dist, false,\n    );\n    steps.push({\n      type: 'bundle',\n      status: bundleResult.status,\n      sha8: sha8(readFileSync(opts.bundle)),\n      body: bundleResult.ok ? undefined : bundleResult.body,\n    });\n    allOk = allOk && bundleResult.ok;\n    log(`  bundle    → ${bundleResult.status}${bundleResult.ok ? '' : ' ' + bundleResult.body.slice(0, 120)}`);\n  }\n\n  return { ...inject, uploaded: allOk, steps };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAiCA,qBAA4C;AAC5C,yBAAuC;AACvC,uBAAyB;AAElB,IAAM,eAAe;AAE5B,IAAM,mBAAmB;AA2CzB,SAAS,KAAK,KAAqB;AACjC,aAAO,+BAAW,QAAQ,EAAE,OAAO,GAAG,EAAE,OAAO,KAAK,EAAE,MAAM,GAAG,CAAC;AAClE;AAMO,SAAS,2BACd,MACsC;AACtC,QAAM,gBAAY,6BAAa,KAAK,QAAQ,MAAM;AAClD,QAAM,aAAS,6BAAa,KAAK,WAAW,MAAM;AAClD,QAAM,MAAM,KAAK,MAAM,MAAM;AAE7B,MAAI,UAAU,KAAK,WAAW;AAC9B,MAAI,CAAC,WAAW,OAAO,IAAI,YAAY,SAAU,WAAU,IAAI;AAC/D,QAAM,WAAW,iBAAiB,KAAK,SAAS;AAChD,MAAI,CAAC,WAAW,YAAY,SAAS,CAAC,EAAG,WAAU,SAAS,CAAC;AAC7D,QAAM,SAAS,CAAC,CAAC;AACjB,MAAI,CAAC,QAAS,eAAU,+BAAW;AAGnC,MAAI,UAAU;AACd,oCAAc,KAAK,WAAW,KAAK,UAAU,GAAG,CAAC;AAGjD,MAAI,YAAY,UAAU,QAAQ,kBAAkB,EAAE;AACtD,cAAY,UAAU,QAAQ,QAAQ,EAAE;AACxC,eAAa;AAAA,cAAiB,OAAO;AAAA;AACrC,oCAAc,KAAK,QAAQ,SAAS;AAEpC,SAAO,EAAE,SAAS,OAAO;AAC3B;AAEA,eAAe,UACb,MACA,UACA,SACA,SACA,MACA,OACA,MACA,cACwD;AACxD,MAAI,UAAM,6BAAa,QAAQ;AAC/B,MAAI,SAAS,eAAe,cAAc;AACxC,UAAM,OAAO,KAAK,MAAM,IAAI,SAAS,MAAM,CAAC;AAC5C,QAAI,MAAM,QAAQ,KAAK,cAAc,EAAG,QAAO,KAAK;AACpD,UAAM,OAAO,KAAK,KAAK,UAAU,IAAI,CAAC;AAAA,EACxC;AAEA,QAAM,OAAO,IAAI,SAAS;AAC1B,OAAK,OAAO,WAAW,OAAO;AAC9B,OAAK,OAAO,QAAQ,IAAI;AACxB,OAAK,OAAO,WAAW,OAAO;AAC9B,MAAI,KAAM,MAAK,OAAO,QAAQ,IAAI;AAClC,OAAK;AAAA,IACH;AAAA,IACA,IAAI,KAAK,CAAC,GAAG,GAAG;AAAA,MACd,MAAM,SAAS,cAAc,qBAAqB;AAAA,IACpD,CAAC;AAAA,QACD,2BAAS,QAAQ;AAAA,EACnB;AAEA,QAAM,MAAM,MAAM,MAAM,KAAK,QAAQ,OAAO,EAAE,IAAI,4BAA4B;AAAA,IAC5E,QAAQ;AAAA,IACR,SAAS,EAAE,0BAA0B,MAAM;AAAA,IAC3C,MAAM;AAAA,EACR,CAAC;AACD,SAAO,EAAE,QAAQ,IAAI,QAAQ,MAAM,MAAM,IAAI,KAAK,GAAG,IAAI,IAAI,GAAG;AAClE;AAQA,eAAsB,2BACpB,MAC2C;AAC3C,QAAM,MAAM,KAAK,SAAS,MAAM,SAAY,CAAC,MAAc,QAAQ,IAAI,wBAAwB,CAAC,EAAE;AAElG,QAAM,SAAS,2BAA2B,IAAI;AAC9C,MAAI,eAAW,2BAAS,KAAK,MAAM,CAAC,cAAc,OAAO,OAAO,IAAI,OAAO,SAAS,aAAa,OAAO,EAAE;AAE1G,QAAM,QAAQ,KAAK,SAAS,QAAQ,IAAI;AACxC,MAAI,KAAK,cAAc,CAAC,OAAO;AAC7B,QAAI,CAAC,KAAK,cAAc,CAAC,OAAO;AAC9B,UAAI,4EAAuE;AAAA,IAC7E;AACA,WAAO;AAAA,EACT;AAEA,QAAM,OAAO,KAAK,QAAQ,QAAQ,IAAI,gBAAgB;AACtD,QAAM,eAAe,KAAK,gBAAgB;AAE1C,QAAM,QAAmD,CAAC;AAC1D,QAAM,YAAY,MAAM;AAAA,IACtB;AAAA,IAAa,KAAK;AAAA,IAAW,OAAO;AAAA,IAAS,KAAK;AAAA,IAAS;AAAA,IAAM;AAAA,IAAO,KAAK;AAAA,IAAM;AAAA,EACrF;AACA,QAAM,KAAK;AAAA,IACT,MAAM;AAAA,IACN,QAAQ,UAAU;AAAA,IAClB,MAAM,SAAK,6BAAa,KAAK,SAAS,CAAC;AAAA,IACvC,MAAM,UAAU,KAAK,SAAY,UAAU;AAAA,EAC7C,CAAC;AACD,MAAI,sBAAiB,UAAU,MAAM,GAAG,UAAU,KAAK,KAAK,MAAM,UAAU,KAAK,MAAM,GAAG,GAAG,CAAC,EAAE;AAEhG,MAAI,QAAQ,UAAU;AACtB,MAAI,KAAK,cAAc;AACrB,UAAM,eAAe,MAAM;AAAA,MACzB;AAAA,MAAU,KAAK;AAAA,MAAQ,OAAO;AAAA,MAAS,KAAK;AAAA,MAAS;AAAA,MAAM;AAAA,MAAO,KAAK;AAAA,MAAM;AAAA,IAC/E;AACA,UAAM,KAAK;AAAA,MACT,MAAM;AAAA,MACN,QAAQ,aAAa;AAAA,MACrB,MAAM,SAAK,6BAAa,KAAK,MAAM,CAAC;AAAA,MACpC,MAAM,aAAa,KAAK,SAAY,aAAa;AAAA,IACnD,CAAC;AACD,YAAQ,SAAS,aAAa;AAC9B,QAAI,sBAAiB,aAAa,MAAM,GAAG,aAAa,KAAK,KAAK,MAAM,aAAa,KAAK,MAAM,GAAG,GAAG,CAAC,EAAE;AAAA,EAC3G;AAEA,SAAO,EAAE,GAAG,QAAQ,UAAU,OAAO,MAAM;AAC7C;","names":[]}

package/dist/build/sourcemaps.mjs

@@ -1,7 +1,7 @@
 // src/build/sourcemaps.ts
-import { existsSync, readFileSync, writeFileSync } from "fs";
+import { readFileSync, writeFileSync } from "fs";
 import { randomUUID, createHash } from "crypto";
-import { basename, resolve } from "path";
+import { basename } from "path";
 var DEFAULT_HOST = "https://api.allstak.sa";
 var DEBUG_ID_LINE_RE = /^\/\/# debugId=([0-9a-f-]{36})\s*$/m;
 function sha8(buf) {
@@ -57,15 +57,14 @@ async function uploadReactNativeSourcemap(opts) {
   const log = opts.silent ? () => void 0 : (m) => console.log(`[allstak/sourcemaps] ${m}`);
   const inject = injectReactNativeSourcemap(opts);
   log(`bundle: ${basename(opts.bundle)}  debugId: ${inject.debugId} ${inject.reused ? "(reused)" : "(new)"}`);
-  const env = loadAllStakEnv();
-  const token = opts.token ?? env.ALLSTAK_UPLOAD_TOKEN;
+  const token = opts.token ?? process.env.ALLSTAK_UPLOAD_TOKEN;
   if (opts.injectOnly || !token) {
     if (!opts.injectOnly && !token) {
       log("skipping upload \u2014 no token (set ALLSTAK_UPLOAD_TOKEN or pass `token`)");
     }
     return inject;
   }
-  const host = opts.host ?? env.ALLSTAK_HOST ?? DEFAULT_HOST;
+  const host = opts.host ?? process.env.ALLSTAK_HOST ?? DEFAULT_HOST;
   const stripSources = opts.stripSources ?? false;
   const steps = [];
   const mapResult = await uploadOne(
@@ -108,21 +107,6 @@ async function uploadReactNativeSourcemap(opts) {
   }
   return { ...inject, uploaded: allOk, steps };
 }
-function loadAllStakEnv() {
-  const out = { ...process.env };
-  for (const file of [".env.local", ".env"]) {
-    const full = resolve(process.cwd(), file);
-    if (!existsSync(full)) continue;
-    for (const line of readFileSync(full, "utf8").split(/\r?\n/)) {
-      const trimmed = line.trim();
-      if (!trimmed || trimmed.startsWith("#")) continue;
-      const match = /^([A-Z0-9_]+)\s*=\s*(.*)$/.exec(trimmed);
-      if (!match || out[match[1]] !== void 0) continue;
-      out[match[1]] = match[2].replace(/^['"]|['"]$/g, "");
-    }
-  }
-  return out;
-}
 export {
   DEFAULT_HOST,
   injectReactNativeSourcemap,

package/dist/build/sourcemaps.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/build/sourcemaps.ts"],"sourcesContent":["/**\n * Source-map upload pipeline for React Native (Metro / Hermes). Build-time only.\n *\n * Metro emits one bundle + one source map per build, so the React Native\n * flow is simpler than the React-web flow (no `dist/` walk needed). The\n * developer hands us the bundle + map paths produced by:\n *\n *   npx react-native bundle \\\n *     --platform ios --dev false --entry-file index.js \\\n *     --bundle-output ios.bundle \\\n *     --sourcemap-output ios.bundle.map\n *\n * If Hermes is enabled, the resulting `.hbc` bytecode replaces the JS\n * bundle on the device, and the user must compose the Metro map with the\n * Hermes map BEFORE uploading. We accept whatever map the user gives us\n * and inject a debug-id into both the map and the bundle.\n *\n * Usage from a build script (`scripts/upload-sourcemaps.js`):\n *\n *   const { uploadReactNativeSourcemap } = require('@allstak/react-native/sourcemaps');\n *\n *   await uploadReactNativeSourcemap({\n *     bundle: 'ios.bundle',\n *     sourcemap: 'ios.bundle.map',\n *     release: 'mobile@1.2.3',\n *     dist: 'ios-hermes',\n *     token: process.env.ALLSTAK_UPLOAD_TOKEN,\n *   });\n *\n * Or `injectOnly: true` to add the debug-id without uploading (useful in\n * CI dry-runs or when you don't have an upload token yet).\n */\n\nimport { existsSync, readFileSync, writeFileSync } from 'node:fs';\nimport { randomUUID, createHash } from 'node:crypto';\nimport { basename, resolve } from 'node:path';\n\nexport const DEFAULT_HOST = 'https://api.allstak.sa';\n\nconst DEBUG_ID_LINE_RE = /^\\/\\/# debugId=([0-9a-f-]{36})\\s*$/m;\n\nexport interface UploadReactNativeSourcemapOptions {\n  /** Path to the JS/Hermes-bytecode bundle (Metro's `--bundle-output`). */\n  bundle: string;\n  /** Path to the matching `.map` (Metro's `--sourcemap-output`). */\n  sourcemap: string;\n  /** Release identifier (e.g. `mobile@1.2.3` — match `release` in AllStak.init). */\n  release: string;\n  /**\n   * Distribution tag — recommended values: `ios-hermes`, `android-hermes`,\n   * `ios-jsc`, `android-jsc`. Match the `dist` the SDK auto-detects at\n   * runtime (see `src/install.ts`). Required for the symbolicator to\n   * pick the right map per platform.\n   */\n  dist?: string;\n  /** Project upload token (`aspk_…`). Defaults to `ALLSTAK_UPLOAD_TOKEN`. */\n  token?: string;\n  /** Override ingest host. Defaults to `ALLSTAK_HOST` or production. */\n  host?: string;\n  /** Drop `sourcesContent` from the map before upload (smaller payload). */\n  stripSources?: boolean;\n  /** Also upload the JS/HBC bundle alongside the map. Off by default. */\n  uploadBundle?: boolean;\n  /** Inject debug-id but skip the upload (CI dry-run). */\n  injectOnly?: boolean;\n  /** Pre-existing debug-id to use instead of generating one. Optional. */\n  debugId?: string;\n  /** Suppress per-step console output. Default false. */\n  silent?: boolean;\n}\n\nexport interface UploadReactNativeSourcemapResult {\n  /** The debug-id injected into the bundle + map. */\n  debugId: string;\n  /** True if the bundle already had a debug-id; we reused it. */\n  reused: boolean;\n  /** True when upload(s) succeeded — undefined when `injectOnly: true`. */\n  uploaded?: boolean;\n  /** Per-artifact responses, in the order we sent them. */\n  steps?: Array<{ type: 'sourcemap' | 'bundle'; status: number; sha8: string; body?: string }>;\n}\n\nfunction sha8(buf: Buffer): string {\n  return createHash('sha256').update(buf).digest('hex').slice(0, 8);\n}\n\n/**\n * Inject a debug-id into the bundle + map (idempotent — reuses an\n * existing id if present).\n */\nexport function injectReactNativeSourcemap(\n  opts: Pick<UploadReactNativeSourcemapOptions, 'bundle' | 'sourcemap' | 'debugId'>,\n): { debugId: string; reused: boolean } {\n  const bundleRaw = readFileSync(opts.bundle, 'utf8');\n  const mapRaw = readFileSync(opts.sourcemap, 'utf8');\n  const map = JSON.parse(mapRaw) as { debugId?: unknown; [k: string]: unknown };\n\n  let debugId = opts.debugId ?? '';\n  if (!debugId && typeof map.debugId === 'string') debugId = map.debugId;\n  const existing = DEBUG_ID_LINE_RE.exec(bundleRaw);\n  if (!debugId && existing && existing[1]) debugId = existing[1];\n  const reused = !!debugId;\n  if (!debugId) debugId = randomUUID();\n\n  // Re-stringify map with canonical debugId field.\n  map.debugId = debugId;\n  writeFileSync(opts.sourcemap, JSON.stringify(map));\n\n  // Append `//# debugId=…` to the bundle (idempotent — strip prior line first).\n  let bundleOut = bundleRaw.replace(DEBUG_ID_LINE_RE, '');\n  bundleOut = bundleOut.replace(/\\s+$/, '');\n  bundleOut += `\\n//# debugId=${debugId}\\n`;\n  writeFileSync(opts.bundle, bundleOut);\n\n  return { debugId, reused };\n}\n\nasync function uploadOne(\n  type: 'sourcemap' | 'bundle',\n  filePath: string,\n  debugId: string,\n  release: string,\n  host: string,\n  token: string,\n  dist: string | undefined,\n  stripSources: boolean,\n): Promise<{ status: number; body: string; ok: boolean }> {\n  let buf = readFileSync(filePath);\n  if (type === 'sourcemap' && stripSources) {\n    const json = JSON.parse(buf.toString('utf8')) as { sourcesContent?: unknown };\n    if (Array.isArray(json.sourcesContent)) delete json.sourcesContent;\n    buf = Buffer.from(JSON.stringify(json));\n  }\n\n  const form = new FormData();\n  form.append('debugId', debugId);\n  form.append('type', type);\n  form.append('release', release);\n  if (dist) form.append('dist', dist);\n  form.append(\n    'file',\n    new Blob([buf], {\n      type: type === 'sourcemap' ? 'application/json' : 'application/javascript',\n    }),\n    basename(filePath),\n  );\n\n  const res = await fetch(host.replace(/\\/$/, '') + '/api/v1/artifacts/upload', {\n    method: 'POST',\n    headers: { 'X-AllStak-Upload-Token': token },\n    body: form,\n  });\n  return { status: res.status, body: await res.text(), ok: res.ok };\n}\n\n/**\n * Inject debug-id into the bundle + map and (optionally) upload.\n *\n * Returns the debug-id (so the caller can stash it for symbolicator\n * lookups), whether it was reused, and per-step upload statuses.\n */\nexport async function uploadReactNativeSourcemap(\n  opts: UploadReactNativeSourcemapOptions,\n): Promise<UploadReactNativeSourcemapResult> {\n  const log = opts.silent ? () => undefined : (m: string) => console.log(`[allstak/sourcemaps] ${m}`);\n\n  const inject = injectReactNativeSourcemap(opts);\n  log(`bundle: ${basename(opts.bundle)}  debugId: ${inject.debugId} ${inject.reused ? '(reused)' : '(new)'}`);\n\n  const env = loadAllStakEnv();\n  const token = opts.token ?? env.ALLSTAK_UPLOAD_TOKEN;\n  if (opts.injectOnly || !token) {\n    if (!opts.injectOnly && !token) {\n      log('skipping upload — no token (set ALLSTAK_UPLOAD_TOKEN or pass `token`)');\n    }\n    return inject;\n  }\n\n  const host = opts.host ?? env.ALLSTAK_HOST ?? DEFAULT_HOST;\n  const stripSources = opts.stripSources ?? false;\n\n  const steps: UploadReactNativeSourcemapResult['steps'] = [];\n  const mapResult = await uploadOne(\n    'sourcemap', opts.sourcemap, inject.debugId, opts.release, host, token, opts.dist, stripSources,\n  );\n  steps.push({\n    type: 'sourcemap',\n    status: mapResult.status,\n    sha8: sha8(readFileSync(opts.sourcemap)),\n    body: mapResult.ok ? undefined : mapResult.body,\n  });\n  log(`  sourcemap → ${mapResult.status}${mapResult.ok ? '' : ' ' + mapResult.body.slice(0, 120)}`);\n\n  let allOk = mapResult.ok;\n  if (opts.uploadBundle) {\n    const bundleResult = await uploadOne(\n      'bundle', opts.bundle, inject.debugId, opts.release, host, token, opts.dist, false,\n    );\n    steps.push({\n      type: 'bundle',\n      status: bundleResult.status,\n      sha8: sha8(readFileSync(opts.bundle)),\n      body: bundleResult.ok ? undefined : bundleResult.body,\n    });\n    allOk = allOk && bundleResult.ok;\n    log(`  bundle    → ${bundleResult.status}${bundleResult.ok ? '' : ' ' + bundleResult.body.slice(0, 120)}`);\n  }\n\n  return { ...inject, uploaded: allOk, steps };\n}\n\nfunction loadAllStakEnv(): Record<string, string | undefined> {\n  const out: Record<string, string | undefined> = { ...process.env };\n  for (const file of ['.env.local', '.env']) {\n    const full = resolve(process.cwd(), file);\n    if (!existsSync(full)) continue;\n    for (const line of readFileSync(full, 'utf8').split(/\\r?\\n/)) {\n      const trimmed = line.trim();\n      if (!trimmed || trimmed.startsWith('#')) continue;\n      const match = /^([A-Z0-9_]+)\\s*=\\s*(.*)$/.exec(trimmed);\n      if (!match || out[match[1]!] !== undefined) continue;\n      out[match[1]!] = match[2]!.replace(/^['\"]|['\"]$/g, '');\n    }\n  }\n  return out;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/build/sourcemaps.ts"],"sourcesContent":["/**\n * Source-map upload pipeline for React Native (Metro / Hermes). Build-time only.\n *\n * Metro emits one bundle + one source map per build, so the React Native\n * flow is simpler than the React-web flow (no `dist/` walk needed). The\n * developer hands us the bundle + map paths produced by:\n *\n *   npx react-native bundle \\\n *     --platform ios --dev false --entry-file index.js \\\n *     --bundle-output ios.bundle \\\n *     --sourcemap-output ios.bundle.map\n *\n * If Hermes is enabled, the resulting `.hbc` bytecode replaces the JS\n * bundle on the device, and the user must compose the Metro map with the\n * Hermes map BEFORE uploading. We accept whatever map the user gives us\n * and inject a debug-id into both the map and the bundle.\n *\n * Usage from a build script (`scripts/upload-sourcemaps.js`):\n *\n *   const { uploadReactNativeSourcemap } = require('@allstak/react-native/sourcemaps');\n *\n *   await uploadReactNativeSourcemap({\n *     bundle: 'ios.bundle',\n *     sourcemap: 'ios.bundle.map',\n *     release: 'mobile@1.2.3',\n *     dist: 'ios-hermes',\n *     token: process.env.ALLSTAK_UPLOAD_TOKEN,\n *   });\n *\n * Or `injectOnly: true` to add the debug-id without uploading (useful in\n * CI dry-runs or when you don't have an upload token yet).\n */\n\nimport { readFileSync, writeFileSync } from 'node:fs';\nimport { randomUUID, createHash } from 'node:crypto';\nimport { basename } from 'node:path';\n\nexport const DEFAULT_HOST = 'https://api.allstak.sa';\n\nconst DEBUG_ID_LINE_RE = /^\\/\\/# debugId=([0-9a-f-]{36})\\s*$/m;\n\nexport interface UploadReactNativeSourcemapOptions {\n  /** Path to the JS/Hermes-bytecode bundle (Metro's `--bundle-output`). */\n  bundle: string;\n  /** Path to the matching `.map` (Metro's `--sourcemap-output`). */\n  sourcemap: string;\n  /** Release identifier (e.g. `mobile@1.2.3` — match `release` in AllStak.init). */\n  release: string;\n  /**\n   * Distribution tag — recommended values: `ios-hermes`, `android-hermes`,\n   * `ios-jsc`, `android-jsc`. Match the `dist` the SDK auto-detects at\n   * runtime (see `src/install.ts`). Required for the symbolicator to\n   * pick the right map per platform.\n   */\n  dist?: string;\n  /** Project upload token (`aspk_…`). Defaults to `ALLSTAK_UPLOAD_TOKEN`. */\n  token?: string;\n  /** Override ingest host. Defaults to `ALLSTAK_HOST` or production. */\n  host?: string;\n  /** Drop `sourcesContent` from the map before upload (smaller payload). */\n  stripSources?: boolean;\n  /** Also upload the JS/HBC bundle alongside the map. Off by default. */\n  uploadBundle?: boolean;\n  /** Inject debug-id but skip the upload (CI dry-run). */\n  injectOnly?: boolean;\n  /** Pre-existing debug-id to use instead of generating one. Optional. */\n  debugId?: string;\n  /** Suppress per-step console output. Default false. */\n  silent?: boolean;\n}\n\nexport interface UploadReactNativeSourcemapResult {\n  /** The debug-id injected into the bundle + map. */\n  debugId: string;\n  /** True if the bundle already had a debug-id; we reused it. */\n  reused: boolean;\n  /** True when upload(s) succeeded — undefined when `injectOnly: true`. */\n  uploaded?: boolean;\n  /** Per-artifact responses, in the order we sent them. */\n  steps?: Array<{ type: 'sourcemap' | 'bundle'; status: number; sha8: string; body?: string }>;\n}\n\nfunction sha8(buf: Buffer): string {\n  return createHash('sha256').update(buf).digest('hex').slice(0, 8);\n}\n\n/**\n * Inject a debug-id into the bundle + map (idempotent — reuses an\n * existing id if present).\n */\nexport function injectReactNativeSourcemap(\n  opts: Pick<UploadReactNativeSourcemapOptions, 'bundle' | 'sourcemap' | 'debugId'>,\n): { debugId: string; reused: boolean } {\n  const bundleRaw = readFileSync(opts.bundle, 'utf8');\n  const mapRaw = readFileSync(opts.sourcemap, 'utf8');\n  const map = JSON.parse(mapRaw) as { debugId?: unknown; [k: string]: unknown };\n\n  let debugId = opts.debugId ?? '';\n  if (!debugId && typeof map.debugId === 'string') debugId = map.debugId;\n  const existing = DEBUG_ID_LINE_RE.exec(bundleRaw);\n  if (!debugId && existing && existing[1]) debugId = existing[1];\n  const reused = !!debugId;\n  if (!debugId) debugId = randomUUID();\n\n  // Re-stringify map with canonical debugId field.\n  map.debugId = debugId;\n  writeFileSync(opts.sourcemap, JSON.stringify(map));\n\n  // Append `//# debugId=…` to the bundle (idempotent — strip prior line first).\n  let bundleOut = bundleRaw.replace(DEBUG_ID_LINE_RE, '');\n  bundleOut = bundleOut.replace(/\\s+$/, '');\n  bundleOut += `\\n//# debugId=${debugId}\\n`;\n  writeFileSync(opts.bundle, bundleOut);\n\n  return { debugId, reused };\n}\n\nasync function uploadOne(\n  type: 'sourcemap' | 'bundle',\n  filePath: string,\n  debugId: string,\n  release: string,\n  host: string,\n  token: string,\n  dist: string | undefined,\n  stripSources: boolean,\n): Promise<{ status: number; body: string; ok: boolean }> {\n  let buf = readFileSync(filePath);\n  if (type === 'sourcemap' && stripSources) {\n    const json = JSON.parse(buf.toString('utf8')) as { sourcesContent?: unknown };\n    if (Array.isArray(json.sourcesContent)) delete json.sourcesContent;\n    buf = Buffer.from(JSON.stringify(json));\n  }\n\n  const form = new FormData();\n  form.append('debugId', debugId);\n  form.append('type', type);\n  form.append('release', release);\n  if (dist) form.append('dist', dist);\n  form.append(\n    'file',\n    new Blob([buf], {\n      type: type === 'sourcemap' ? 'application/json' : 'application/javascript',\n    }),\n    basename(filePath),\n  );\n\n  const res = await fetch(host.replace(/\\/$/, '') + '/api/v1/artifacts/upload', {\n    method: 'POST',\n    headers: { 'X-AllStak-Upload-Token': token },\n    body: form,\n  });\n  return { status: res.status, body: await res.text(), ok: res.ok };\n}\n\n/**\n * Inject debug-id into the bundle + map and (optionally) upload.\n *\n * Returns the debug-id (so the caller can stash it for symbolicator\n * lookups), whether it was reused, and per-step upload statuses.\n */\nexport async function uploadReactNativeSourcemap(\n  opts: UploadReactNativeSourcemapOptions,\n): Promise<UploadReactNativeSourcemapResult> {\n  const log = opts.silent ? () => undefined : (m: string) => console.log(`[allstak/sourcemaps] ${m}`);\n\n  const inject = injectReactNativeSourcemap(opts);\n  log(`bundle: ${basename(opts.bundle)}  debugId: ${inject.debugId} ${inject.reused ? '(reused)' : '(new)'}`);\n\n  const token = opts.token ?? process.env.ALLSTAK_UPLOAD_TOKEN;\n  if (opts.injectOnly || !token) {\n    if (!opts.injectOnly && !token) {\n      log('skipping upload — no token (set ALLSTAK_UPLOAD_TOKEN or pass `token`)');\n    }\n    return inject;\n  }\n\n  const host = opts.host ?? process.env.ALLSTAK_HOST ?? DEFAULT_HOST;\n  const stripSources = opts.stripSources ?? false;\n\n  const steps: UploadReactNativeSourcemapResult['steps'] = [];\n  const mapResult = await uploadOne(\n    'sourcemap', opts.sourcemap, inject.debugId, opts.release, host, token, opts.dist, stripSources,\n  );\n  steps.push({\n    type: 'sourcemap',\n    status: mapResult.status,\n    sha8: sha8(readFileSync(opts.sourcemap)),\n    body: mapResult.ok ? undefined : mapResult.body,\n  });\n  log(`  sourcemap → ${mapResult.status}${mapResult.ok ? '' : ' ' + mapResult.body.slice(0, 120)}`);\n\n  let allOk = mapResult.ok;\n  if (opts.uploadBundle) {\n    const bundleResult = await uploadOne(\n      'bundle', opts.bundle, inject.debugId, opts.release, host, token, opts.dist, false,\n    );\n    steps.push({\n      type: 'bundle',\n      status: bundleResult.status,\n      sha8: sha8(readFileSync(opts.bundle)),\n      body: bundleResult.ok ? undefined : bundleResult.body,\n    });\n    allOk = allOk && bundleResult.ok;\n    log(`  bundle    → ${bundleResult.status}${bundleResult.ok ? '' : ' ' + bundleResult.body.slice(0, 120)}`);\n  }\n\n  return { ...inject, uploaded: allOk, steps };\n}\n"],"mappings":"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","names":[]}

package/dist/expo-plugin.js

@@ -32,9 +32,13 @@ function withAllStak(config, options = {}) {
     release: options.release ?? existing.release,
     environment: options.environment ?? existing.environment,
     dist: options.dist ?? existing.dist,
-    pluginVersion: "0.3.4"
+    pluginVersion: "0.3.1"
   };
   return next;
 }
 var expo_plugin_default = withAllStak;
+if (typeof module !== "undefined" && module.exports) {
+  module.exports = withAllStak;
+  module.exports.default = withAllStak;
+}
 //# sourceMappingURL=expo-plugin.js.map

package/dist/expo-plugin.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/expo-plugin.ts"],"sourcesContent":["/**\n * Expo config plugin.\n *\n * Apply via `app.json`:\n *\n *   {\n *     \"expo\": {\n *       \"plugins\": [\n *         [\"@allstak/react-native\", { \"release\": \"mobile@1.2.3\", \"environment\": \"production\" }]\n *       ]\n *     }\n *   }\n *\n * The plugin runs at `expo prebuild` / EAS build time and:\n *\n *   1. Adds the AllStak iOS pod (declared in `react-native.config.js`).\n *      Expo's autolinking already picks this up — we just record metadata\n *      so `expo doctor` can verify the install is wired.\n *   2. Stamps the chosen `release` into `expo-constants` extras so the JS\n *      layer can read it at runtime via `Constants.expoConfig.extra._allstak`\n *      without the host app needing to plumb it through env vars.\n *   3. Records that `@allstak/react-native` was loaded as an Expo plugin\n *      for diagnostics.\n *\n * Pure config mutation — no native code is patched here. The native iOS\n * + Android modules under ./native are linked by Expo's existing\n * autolinking flow (which honors the `react-native.config.js` manifest).\n */\n\nexport interface AllStakExpoOptions {\n  /** Release identifier (e.g. `mobile@1.2.3`). Stamped into `Constants.expoConfig.extra._allstak.release`. */\n  release?: string;\n  /** Environment label — `production`, `staging`, etc. */\n  environment?: string;\n  /** Optional dist tag (e.g. `ios-hermes`). Auto-detected at runtime if unset. */\n  dist?: string;\n}\n\ninterface ExpoConfig {\n  name?: string;\n  extra?: Record<string, unknown>;\n  plugins?: any[];\n  [key: string]: any;\n}\n\ninterface ExpoConfigContext {\n  modResults?: any;\n  modRawConfig?: ExpoConfig;\n  [key: string]: any;\n}\n\n/**\n * The plugin function itself. Expo's plugin runner calls it as\n * `(config, options) => modifiedConfig`. We avoid importing\n * `@expo/config-plugins` so the package has zero hard dependencies on the\n * Expo toolchain — the type checking happens at usage site instead.\n */\nfunction withAllStak(config: ExpoConfig & ExpoConfigContext, options: AllStakExpoOptions = {}): ExpoConfig {\n  const next: ExpoConfig = { ...config };\n  next.extra = { ...(config.extra ?? {}) };\n\n  // Embed runtime-readable metadata under a namespaced key so we never\n  // collide with the host app's other extras.\n  const existing = (next.extra as any)._allstak ?? {};\n  (next.extra as any)._allstak = {\n    ...existing,\n    release: options.release ?? existing.release,\n    environment: options.environment ?? existing.environment,\n    dist: options.dist ?? existing.dist,\n    pluginVersion: '0.3.4',\n  };\n\n  return next;\n}\n\nexport default withAllStak;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAyDA,SAAS,YAAY,QAAwC,UAA8B,CAAC,GAAe;AACzG,QAAM,OAAmB,EAAE,GAAG,OAAO;AACrC,OAAK,QAAQ,EAAE,GAAI,OAAO,SAAS,CAAC,EAAG;AAIvC,QAAM,WAAY,KAAK,MAAc,YAAY,CAAC;AAClD,EAAC,KAAK,MAAc,WAAW;AAAA,IAC7B,GAAG;AAAA,IACH,SAAS,QAAQ,WAAW,SAAS;AAAA,IACrC,aAAa,QAAQ,eAAe,SAAS;AAAA,IAC7C,MAAM,QAAQ,QAAQ,SAAS;AAAA,IAC/B,eAAe;AAAA,EACjB;AAEA,SAAO;AACT;AAEA,IAAO,sBAAQ;","names":[]}
+{"version":3,"sources":["../src/expo-plugin.ts"],"sourcesContent":["/**\n * Expo config plugin.\n *\n * Apply via `app.json`:\n *\n *   {\n *     \"expo\": {\n *       \"plugins\": [\n *         [\"@allstak/react-native\", { \"release\": \"mobile@1.2.3\", \"environment\": \"production\" }]\n *       ]\n *     }\n *   }\n *\n * The plugin runs at `expo prebuild` / EAS build time and:\n *\n *   1. Adds the AllStak iOS pod (declared in `react-native.config.js`).\n *      Expo's autolinking already picks this up — we just record metadata\n *      so `expo doctor` can verify the install is wired.\n *   2. Stamps the chosen `release` into `expo-constants` extras so the JS\n *      layer can read it at runtime via `Constants.expoConfig.extra._allstak`\n *      without the host app needing to plumb it through env vars.\n *   3. Records that `@allstak/react-native` was loaded as an Expo plugin\n *      for diagnostics.\n *\n * Pure config mutation — no native code is patched here. The native iOS\n * + Android modules under ./native are linked by Expo's existing\n * autolinking flow (which honors the `react-native.config.js` manifest).\n */\n\nexport interface AllStakExpoOptions {\n  /** Release identifier (e.g. `mobile@1.2.3`). Stamped into `Constants.expoConfig.extra._allstak.release`. */\n  release?: string;\n  /** Environment label — `production`, `staging`, etc. */\n  environment?: string;\n  /** Optional dist tag (e.g. `ios-hermes`). Auto-detected at runtime if unset. */\n  dist?: string;\n}\n\ninterface ExpoConfig {\n  name?: string;\n  extra?: Record<string, unknown>;\n  plugins?: any[];\n  [key: string]: any;\n}\n\ninterface ExpoConfigContext {\n  modResults?: any;\n  modRawConfig?: ExpoConfig;\n  [key: string]: any;\n}\n\n/**\n * The plugin function itself. Expo's plugin runner calls it as\n * `(config, options) => modifiedConfig`. We avoid importing\n * `@expo/config-plugins` so the package has zero hard dependencies on the\n * Expo toolchain — the type checking happens at usage site instead.\n */\nfunction withAllStak(config: ExpoConfig & ExpoConfigContext, options: AllStakExpoOptions = {}): ExpoConfig {\n  const next: ExpoConfig = { ...config };\n  next.extra = { ...(config.extra ?? {}) };\n\n  // Embed runtime-readable metadata under a namespaced key so we never\n  // collide with the host app's other extras.\n  const existing = (next.extra as any)._allstak ?? {};\n  (next.extra as any)._allstak = {\n    ...existing,\n    release: options.release ?? existing.release,\n    environment: options.environment ?? existing.environment,\n    dist: options.dist ?? existing.dist,\n    pluginVersion: '0.3.1',\n  };\n\n  return next;\n}\n\nexport default withAllStak;\n\n// Expose as a CommonJS function so `app.plugin.js`'s `require('./dist/expo-plugin.js')`\n// returns the plugin directly. The `declare const module` keeps the TS\n// type-checker happy without dragging in @types/node.\ndeclare const module: { exports: any };\nif (typeof module !== 'undefined' && module.exports) {\n  module.exports = withAllStak;\n  module.exports.default = withAllStak;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAyDA,SAAS,YAAY,QAAwC,UAA8B,CAAC,GAAe;AACzG,QAAM,OAAmB,EAAE,GAAG,OAAO;AACrC,OAAK,QAAQ,EAAE,GAAI,OAAO,SAAS,CAAC,EAAG;AAIvC,QAAM,WAAY,KAAK,MAAc,YAAY,CAAC;AAClD,EAAC,KAAK,MAAc,WAAW;AAAA,IAC7B,GAAG;AAAA,IACH,SAAS,QAAQ,WAAW,SAAS;AAAA,IACrC,aAAa,QAAQ,eAAe,SAAS;AAAA,IAC7C,MAAM,QAAQ,QAAQ,SAAS;AAAA,IAC/B,eAAe;AAAA,EACjB;AAEA,SAAO;AACT;AAEA,IAAO,sBAAQ;AAMf,IAAI,OAAO,WAAW,eAAe,OAAO,SAAS;AACnD,SAAO,UAAU;AACjB,SAAO,QAAQ,UAAU;AAC3B;","names":[]}

package/dist/expo-plugin.mjs

@@ -10,11 +10,15 @@ function withAllStak(config, options = {}) {
     release: options.release ?? existing.release,
     environment: options.environment ?? existing.environment,
     dist: options.dist ?? existing.dist,
-    pluginVersion: "0.3.4"
+    pluginVersion: "0.3.1"
   };
   return next;
 }
 var expo_plugin_default = withAllStak;
+if (typeof module !== "undefined" && module.exports) {
+  module.exports = withAllStak;
+  module.exports.default = withAllStak;
+}
 export {
   expo_plugin_default as default
 };

package/dist/expo-plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/expo-plugin.ts"],"sourcesContent":["/**\n * Expo config plugin.\n *\n * Apply via `app.json`:\n *\n *   {\n *     \"expo\": {\n *       \"plugins\": [\n *         [\"@allstak/react-native\", { \"release\": \"mobile@1.2.3\", \"environment\": \"production\" }]\n *       ]\n *     }\n *   }\n *\n * The plugin runs at `expo prebuild` / EAS build time and:\n *\n *   1. Adds the AllStak iOS pod (declared in `react-native.config.js`).\n *      Expo's autolinking already picks this up — we just record metadata\n *      so `expo doctor` can verify the install is wired.\n *   2. Stamps the chosen `release` into `expo-constants` extras so the JS\n *      layer can read it at runtime via `Constants.expoConfig.extra._allstak`\n *      without the host app needing to plumb it through env vars.\n *   3. Records that `@allstak/react-native` was loaded as an Expo plugin\n *      for diagnostics.\n *\n * Pure config mutation — no native code is patched here. The native iOS\n * + Android modules under ./native are linked by Expo's existing\n * autolinking flow (which honors the `react-native.config.js` manifest).\n */\n\nexport interface AllStakExpoOptions {\n  /** Release identifier (e.g. `mobile@1.2.3`). Stamped into `Constants.expoConfig.extra._allstak.release`. */\n  release?: string;\n  /** Environment label — `production`, `staging`, etc. */\n  environment?: string;\n  /** Optional dist tag (e.g. `ios-hermes`). Auto-detected at runtime if unset. */\n  dist?: string;\n}\n\ninterface ExpoConfig {\n  name?: string;\n  extra?: Record<string, unknown>;\n  plugins?: any[];\n  [key: string]: any;\n}\n\ninterface ExpoConfigContext {\n  modResults?: any;\n  modRawConfig?: ExpoConfig;\n  [key: string]: any;\n}\n\n/**\n * The plugin function itself. Expo's plugin runner calls it as\n * `(config, options) => modifiedConfig`. We avoid importing\n * `@expo/config-plugins` so the package has zero hard dependencies on the\n * Expo toolchain — the type checking happens at usage site instead.\n */\nfunction withAllStak(config: ExpoConfig & ExpoConfigContext, options: AllStakExpoOptions = {}): ExpoConfig {\n  const next: ExpoConfig = { ...config };\n  next.extra = { ...(config.extra ?? {}) };\n\n  // Embed runtime-readable metadata under a namespaced key so we never\n  // collide with the host app's other extras.\n  const existing = (next.extra as any)._allstak ?? {};\n  (next.extra as any)._allstak = {\n    ...existing,\n    release: options.release ?? existing.release,\n    environment: options.environment ?? existing.environment,\n    dist: options.dist ?? existing.dist,\n    pluginVersion: '0.3.4',\n  };\n\n  return next;\n}\n\nexport default withAllStak;\n"],"mappings":";;;AAyDA,SAAS,YAAY,QAAwC,UAA8B,CAAC,GAAe;AACzG,QAAM,OAAmB,EAAE,GAAG,OAAO;AACrC,OAAK,QAAQ,EAAE,GAAI,OAAO,SAAS,CAAC,EAAG;AAIvC,QAAM,WAAY,KAAK,MAAc,YAAY,CAAC;AAClD,EAAC,KAAK,MAAc,WAAW;AAAA,IAC7B,GAAG;AAAA,IACH,SAAS,QAAQ,WAAW,SAAS;AAAA,IACrC,aAAa,QAAQ,eAAe,SAAS;AAAA,IAC7C,MAAM,QAAQ,QAAQ,SAAS;AAAA,IAC/B,eAAe;AAAA,EACjB;AAEA,SAAO;AACT;AAEA,IAAO,sBAAQ;","names":[]}
+{"version":3,"sources":["../src/expo-plugin.ts"],"sourcesContent":["/**\n * Expo config plugin.\n *\n * Apply via `app.json`:\n *\n *   {\n *     \"expo\": {\n *       \"plugins\": [\n *         [\"@allstak/react-native\", { \"release\": \"mobile@1.2.3\", \"environment\": \"production\" }]\n *       ]\n *     }\n *   }\n *\n * The plugin runs at `expo prebuild` / EAS build time and:\n *\n *   1. Adds the AllStak iOS pod (declared in `react-native.config.js`).\n *      Expo's autolinking already picks this up — we just record metadata\n *      so `expo doctor` can verify the install is wired.\n *   2. Stamps the chosen `release` into `expo-constants` extras so the JS\n *      layer can read it at runtime via `Constants.expoConfig.extra._allstak`\n *      without the host app needing to plumb it through env vars.\n *   3. Records that `@allstak/react-native` was loaded as an Expo plugin\n *      for diagnostics.\n *\n * Pure config mutation — no native code is patched here. The native iOS\n * + Android modules under ./native are linked by Expo's existing\n * autolinking flow (which honors the `react-native.config.js` manifest).\n */\n\nexport interface AllStakExpoOptions {\n  /** Release identifier (e.g. `mobile@1.2.3`). Stamped into `Constants.expoConfig.extra._allstak.release`. */\n  release?: string;\n  /** Environment label — `production`, `staging`, etc. */\n  environment?: string;\n  /** Optional dist tag (e.g. `ios-hermes`). Auto-detected at runtime if unset. */\n  dist?: string;\n}\n\ninterface ExpoConfig {\n  name?: string;\n  extra?: Record<string, unknown>;\n  plugins?: any[];\n  [key: string]: any;\n}\n\ninterface ExpoConfigContext {\n  modResults?: any;\n  modRawConfig?: ExpoConfig;\n  [key: string]: any;\n}\n\n/**\n * The plugin function itself. Expo's plugin runner calls it as\n * `(config, options) => modifiedConfig`. We avoid importing\n * `@expo/config-plugins` so the package has zero hard dependencies on the\n * Expo toolchain — the type checking happens at usage site instead.\n */\nfunction withAllStak(config: ExpoConfig & ExpoConfigContext, options: AllStakExpoOptions = {}): ExpoConfig {\n  const next: ExpoConfig = { ...config };\n  next.extra = { ...(config.extra ?? {}) };\n\n  // Embed runtime-readable metadata under a namespaced key so we never\n  // collide with the host app's other extras.\n  const existing = (next.extra as any)._allstak ?? {};\n  (next.extra as any)._allstak = {\n    ...existing,\n    release: options.release ?? existing.release,\n    environment: options.environment ?? existing.environment,\n    dist: options.dist ?? existing.dist,\n    pluginVersion: '0.3.1',\n  };\n\n  return next;\n}\n\nexport default withAllStak;\n\n// Expose as a CommonJS function so `app.plugin.js`'s `require('./dist/expo-plugin.js')`\n// returns the plugin directly. The `declare const module` keeps the TS\n// type-checker happy without dragging in @types/node.\ndeclare const module: { exports: any };\nif (typeof module !== 'undefined' && module.exports) {\n  module.exports = withAllStak;\n  module.exports.default = withAllStak;\n}\n"],"mappings":";;;AAyDA,SAAS,YAAY,QAAwC,UAA8B,CAAC,GAAe;AACzG,QAAM,OAAmB,EAAE,GAAG,OAAO;AACrC,OAAK,QAAQ,EAAE,GAAI,OAAO,SAAS,CAAC,EAAG;AAIvC,QAAM,WAAY,KAAK,MAAc,YAAY,CAAC;AAClD,EAAC,KAAK,MAAc,WAAW;AAAA,IAC7B,GAAG;AAAA,IACH,SAAS,QAAQ,WAAW,SAAS;AAAA,IACrC,aAAa,QAAQ,eAAe,SAAS;AAAA,IAC7C,MAAM,QAAQ,QAAQ,SAAS;AAAA,IAC/B,eAAe;AAAA,EACjB;AAEA,SAAO;AACT;AAEA,IAAO,sBAAQ;AAMf,IAAI,OAAO,WAAW,eAAe,OAAO,SAAS;AACnD,SAAO,UAAU;AACjB,SAAO,QAAQ,UAAU;AAC3B;","names":[]}

package/dist/index.d.mts

@@ -33,6 +33,18 @@ declare class HttpTransport {
     private lastFlushDurationMs;
     constructor(baseUrl: string, apiKey: string, enabled?: boolean);
     send(path: string, payload: unknown): Promise<void>;
+    /**
+     * One-shot POST that resolves with the parsed JSON response body. Used
+     * by `captureException` to retrieve the server-assigned event id so
+     * follow-up attachment uploads can be linked.
+     *
+     * Fail-open: returns `null` on any error (network, non-2xx, parse).
+     * Respects {@link timeoutMs} via `AbortController`. Bounded retries.
+     */
+    sendAndRead<T = any>(path: string, payload: unknown, options?: {
+        timeoutMs?: number;
+        retries?: number;
+    }): Promise<T | null>;
     private enqueueOrDispatch;
     private dispatch;
     private doFetch;
@@ -438,9 +450,117 @@ interface ConsoleCaptureOptions {
 /** @internal — for tests. Resets the wrap-once flag. */
 declare function __resetConsoleInstrumentationFlagForTest(): void;
 
+/**
+ * Runtime detection for React Native screenshot capture.
+ *
+ * Determines whether native screenshot APIs (specifically
+ * `react-native-view-shot`) are usable in the current host:
+ *   - 'expo-go'        — Expo Go sandbox; native modules cannot be added
+ *                        at runtime → screenshots silently skipped.
+ *   - 'expo-dev-client'— Expo dev/prod build that bundles native deps.
+ *   - 'rn-cli'         — bare react-native (CLI) build.
+ *   - 'unknown'        — anything we couldn't classify; treat as allowed
+ *                        but log a __DEV__ warning.
+ */
+type RuntimeMode = 'expo-go' | 'expo-dev-client' | 'rn-cli' | 'unknown';
+/**
+ * Best-effort detection of the host runtime. Cached after first call.
+ */
+declare function detectRuntimeMode(): RuntimeMode;
+/** @internal — reset for tests */
+declare function __resetRuntimeModeForTest(): void;
+/** Whether a runtime allows attempting a native screenshot via view-shot. */
+declare function runtimeAllowsScreenshot(mode?: RuntimeMode): boolean;
+
+/**
+ * Flat screenshot API for `@allstak/react-native`.
+ *
+ * Mirrors the props the wizard emits (`captureScreenshotOnError`,
+ * `screenshotRedaction`, etc.) and orchestrates native capture via the
+ * optional `react-native-view-shot` peer dep.
+ *
+ * Fail-open contract: the event MUST always send even when capture is
+ * unavailable, throws, times out, or the upload fails. The capture
+ * subsystem is allowed to log in __DEV__ but must never reject into the
+ * host app's promise chain.
+ */
+
+type ScreenshotRedactionMode = 'strict' | 'balanced' | 'custom';
+type ScreenshotMaskStyle = 'solid' | 'blur';
+type ScreenshotFormat = 'png' | 'jpg' | 'webp';
+type ScreenshotNativeMode = 'auto' | 'view-shot' | 'disabled';
+type ScreenshotFailPolicy = 'disable-screenshot' | 'send-event-only';
+interface ScreenshotConfig {
+    captureScreenshotOnError: boolean;
+    screenshotRedaction: ScreenshotRedactionMode;
+    screenshotMaskStyle: ScreenshotMaskStyle;
+    screenshotMaxBytes: number;
+    screenshotQuality: number;
+    screenshotFormat: ScreenshotFormat;
+    screenshotSampleRate: number;
+    screenshotOnUnhandledOnly: boolean;
+    screenshotUploadTimeoutMs: number;
+    screenshotCaptureTimeoutMs: number;
+    screenshotNativeMode: ScreenshotNativeMode;
+    screenshotFailPolicy: ScreenshotFailPolicy;
+    beforeScreenshotCapture?: (ctx: ScreenshotContext) => boolean | Promise<boolean>;
+    beforeScreenshotUpload?: ((payload: ScreenshotUpload, meta: ScreenshotMetadata) => ScreenshotUpload | null | Promise<ScreenshotUpload | null>);
+    isScreenshotAllowed?: (ctx: ScreenshotContext) => boolean | Promise<boolean>;
+}
+interface ScreenshotContext {
+    error?: Error;
+    unhandled?: boolean;
+    runtimeMode: RuntimeMode;
+}
+interface ScreenshotUpload {
+    /** Base64-encoded image bytes (no data: prefix). */
+    dataBase64: string;
+    contentType: string;
+    width: number;
+    height: number;
+    sizeBytes: number;
+}
+interface ScreenshotMetadata {
+    captureMethod: string;
+    redactionMode: ScreenshotRedactionMode;
+    maskStyle: ScreenshotMaskStyle;
+    format: ScreenshotFormat;
+    width: number;
+    height: number;
+    sizeBytes: number;
+    maskedElements?: number;
+    privacyComponentsDetected?: number;
+    runtimeMode: RuntimeMode;
+}
+declare const DEFAULT_SCREENSHOT_CONFIG: ScreenshotConfig;
+/**
+ * Merge partial config from `init()` / provider props with sensible
+ * defaults. Any `undefined` field falls back to the default. Numeric
+ * fields are clamped to safe ranges.
+ */
+declare function resolveScreenshotConfig(partial: Partial<ScreenshotConfig> | undefined): ScreenshotConfig;
+declare function isViewShotAvailable(): boolean;
+/**
+ * Attempt a native screenshot via react-native-view-shot. Returns
+ * `null` if anything goes wrong (timeout, missing dep, no root ref).
+ * Never throws. Toggles `__setCapturing(true)` for the duration of the
+ * capture so masking primitives swap to their placeholder render.
+ */
+declare function captureViaViewShot(config: ScreenshotConfig): Promise<ScreenshotUpload | null>;
+/**
+ * Top-level orchestrator. Returns an upload + metadata if a screenshot
+ * is captured, or `null` if anything (sampling, gates, capture, etc.)
+ * skipped it. Never throws.
+ */
+declare function maybeCaptureScreenshot(config: ScreenshotConfig, ctx: ScreenshotContext): Promise<{
+    upload: ScreenshotUpload;
+    metadata: ScreenshotMetadata;
+} | null>;
+declare function pickScreenshotConfig(source: Record<string, unknown>): Partial<ScreenshotConfig>;
+
 declare const INGEST_HOST = "https://api.allstak.sa";
 declare const SDK_NAME = "allstak-react-native";
-declare const SDK_VERSION = "0.3.4";
+declare const SDK_VERSION = "0.4.1";
 
 interface AllStakConfig {
     /** Project API key (`ask_live_…`). Required. */
@@ -518,6 +638,22 @@ interface AllStakConfig {
      * hurt app navigation, JS thread responsiveness, or telemetry delivery.
      */
     screenshot?: ScreenshotCaptureOptions;
+    /** Enable on-error screenshot capture. Default: false. */
+    captureScreenshotOnError?: boolean;
+    screenshotRedaction?: ScreenshotRedactionMode;
+    screenshotMaskStyle?: ScreenshotMaskStyle;
+    screenshotMaxBytes?: number;
+    screenshotQuality?: number;
+    screenshotFormat?: ScreenshotFormat;
+    screenshotSampleRate?: number;
+    screenshotOnUnhandledOnly?: boolean;
+    screenshotUploadTimeoutMs?: number;
+    screenshotCaptureTimeoutMs?: number;
+    screenshotNativeMode?: ScreenshotNativeMode;
+    screenshotFailPolicy?: ScreenshotFailPolicy;
+    beforeScreenshotCapture?: ScreenshotConfig['beforeScreenshotCapture'];
+    beforeScreenshotUpload?: ScreenshotConfig['beforeScreenshotUpload'];
+    isScreenshotAllowed?: ScreenshotConfig['isScreenshotAllowed'];
     /** SDK identity overrides (set automatically by installReactNative). */
     sdkName?: string;
     sdkVersion?: string;
@@ -617,6 +753,14 @@ declare class AllStakClient {
     /** Snapshot of recent failed HTTP requests for error-linking. */
     getRecentFailedHttp(): readonly HttpRequestIngestItem[];
     captureException(error: Error, context?: Record<string, unknown>): void;
+    /**
+     * Flat screenshot API path. Capture first (so masking primitives can
+     * swap), send the event with a `screenshot.status` metadata tag, read
+     * back the server-assigned errorId, then upload the attachment.
+     *
+     * Fail-open at every step.
+     */
+    private runFlatScreenshotPipeline;
     /** Start a new span. Auto-parented to any currently-active span. */
     startSpan(operation: string, options?: {
         description?: string;
@@ -842,8 +986,23 @@ interface AllStakProviderProps extends ReactNativeInstallOptions {
         resetError: () => void;
     }) => React.ReactNode);
     onError?: (error: Error, componentStack?: string) => void;
+    captureScreenshotOnError?: boolean;
+    screenshotRedaction?: ScreenshotRedactionMode;
+    screenshotMaskStyle?: ScreenshotMaskStyle;
+    screenshotMaxBytes?: number;
+    screenshotQuality?: number;
+    screenshotFormat?: ScreenshotFormat;
+    screenshotSampleRate?: number;
+    screenshotOnUnhandledOnly?: boolean;
+    screenshotUploadTimeoutMs?: number;
+    screenshotCaptureTimeoutMs?: number;
+    screenshotNativeMode?: ScreenshotNativeMode;
+    screenshotFailPolicy?: ScreenshotFailPolicy;
+    beforeScreenshotCapture?: AllStakConfig['beforeScreenshotCapture'];
+    beforeScreenshotUpload?: AllStakConfig['beforeScreenshotUpload'];
+    isScreenshotAllowed?: AllStakConfig['isScreenshotAllowed'];
 }
-declare function AllStakProvider({ children, apiKey, environment, release, host, user, tags, debug, enableHttpTracking, httpTracking, captureConsole, sampleRate, beforeSend, replay, tracesSampleRate, service, dist, destroyOnUnmount, fallback, onError, autoErrorHandler, autoPromiseRejections, autoDeviceTags, autoAppStateBreadcrumbs, autoNetworkCapture, autoFetchBreadcrumbs, autoConsoleBreadcrumbs, autoNavigationBreadcrumbs, }: AllStakProviderProps): React.ReactElement;
+declare function AllStakProvider({ children, apiKey, environment, release, host, user, tags, debug, enableHttpTracking, httpTracking, captureConsole, sampleRate, beforeSend, replay, tracesSampleRate, service, dist, destroyOnUnmount, fallback, onError, autoErrorHandler, autoPromiseRejections, autoDeviceTags, autoAppStateBreadcrumbs, autoNetworkCapture, autoFetchBreadcrumbs, autoConsoleBreadcrumbs, autoNavigationBreadcrumbs, captureScreenshotOnError, screenshotRedaction, screenshotMaskStyle, screenshotMaxBytes, screenshotQuality, screenshotFormat, screenshotSampleRate, screenshotOnUnhandledOnly, screenshotUploadTimeoutMs, screenshotCaptureTimeoutMs, screenshotNativeMode, screenshotFailPolicy, beforeScreenshotCapture, beforeScreenshotUpload, isScreenshotAllowed, }: AllStakProviderProps): React.ReactElement;
 declare function useAllStak(): {
     captureException: (error: Error, ctx?: Record<string, unknown>) => void;
     captureMessage: (msg: string, level?: "fatal" | "error" | "warning" | "info") => void;
@@ -857,6 +1016,81 @@ declare function useAllStak(): {
 /** @internal — for tests. Resets the module-level remount-guard. */
 declare function __resetProviderInstanceForTest(): void;
 
+/**
+ * Privacy / masking primitives for AllStak React Native screenshots.
+ *
+ * Three concerns:
+ *   1. A registry of refs / views the capture path should mask when it
+ *      takes a snapshot.
+ *   2. An "isCapturing" flag that masking components subscribe to so they
+ *      can swap their children for a redacted placeholder during a capture.
+ *   3. Light wrappers (`AllStakMaskedView`, `AllStakPrivacyView`,
+ *      `AllStakTextInput`, `AllStakSensitiveText`) that opt-in to the
+ *      isCapturing swap.
+ *
+ * All wrappers are no-ops when react-native is not installed (e.g. JS
+ * test environment) — they just render their children.
+ */
+
+type PrivacyLevel = 'mask' | 'hide' | 'show';
+/** @internal — for tests. */
+declare function __resetPrivacyStateForTest(): void;
+/** Whether a capture is currently in progress. */
+declare function isCapturingScreenshot(): boolean;
+/** Register a sensitive ref. Returns an unregister function. */
+declare function registerSensitiveRef(ref: unknown): () => void;
+/**
+ * Hook returning the privacy state — host apps can build their own
+ * masking UI on top of this.
+ */
+declare function useAllStakPrivacy(): {
+    isCapturing: boolean;
+    registerSensitiveRef: typeof registerSensitiveRef;
+};
+interface AllStakMaskedViewProps {
+    children?: React.ReactNode;
+    maskLabel?: string;
+    maskColor?: string;
+    hideScreenshot?: boolean;
+    privacy?: PrivacyLevel;
+    style?: any;
+    [key: string]: unknown;
+}
+/**
+ * Masks its children during a screenshot capture. While the SDK is
+ * capturing, this component renders a solid placeholder instead of its
+ * children; the rest of the time it's a transparent passthrough.
+ */
+declare function AllStakMaskedView({ children, maskLabel, maskColor, hideScreenshot, privacy, style, ...rest }: AllStakMaskedViewProps): React.ReactElement;
+/**
+ * Stricter variant — defaults to hiding the contents from screenshots
+ * entirely. Use for credit-card fields, IBANs, passwords, etc.
+ */
+declare function AllStakPrivacyView(props: AllStakMaskedViewProps): React.ReactElement;
+interface AllStakTextInputProps {
+    privacy?: PrivacyLevel;
+    style?: any;
+    maskColor?: string;
+    [key: string]: unknown;
+}
+/**
+ * `TextInput` wrapper that swaps to a solid masked box during capture.
+ * Always treated as sensitive unless `privacy="show"`.
+ */
+declare function AllStakTextInput({ privacy, style, maskColor, ...rest }: AllStakTextInputProps): React.ReactElement;
+interface AllStakSensitiveTextProps {
+    children?: React.ReactNode;
+    privacy?: PrivacyLevel;
+    style?: any;
+    maskLabel?: string;
+    [key: string]: unknown;
+}
+/**
+ * Wraps a Text element so it renders the mask label during capture
+ * instead of its actual children. Default privacy is `'mask'`.
+ */
+declare function AllStakSensitiveText({ children, privacy, style, maskLabel, ...rest }: AllStakSensitiveTextProps): React.ReactElement;
+
 /**
  * React Native navigation breadcrumbs — two opt-in helpers:
  *
@@ -1029,4 +1263,4 @@ declare function __devTriggerNativeCrash(): Promise<void>;
  */
 declare function drainPendingNativeCrashes(release?: string): Promise<void>;
 
-export { ALWAYS_REDACT_HEADERS, ALWAYS_REDACT_QUERY, AllStak, AllStakClient, type AllStakConfig, AllStakProvider, type AllStakProviderProps, type ArchitectureInfo, type Breadcrumb, type ConsoleCaptureOptions, DEFAULT_REDACT_BODY_FIELDS, type HttpRequestEvent, HttpRequestModule, type HttpTrackingOptions, INGEST_HOST, REDACTED, type ReactNativeInstallOptions, ReplaySurrogate, type ReplaySurrogateOptions, SDK_NAME, SDK_VERSION, Scope, type ScreenshotArtifact, type ScreenshotCaptureOptions, type TransportStats, __devTriggerNativeCrash, __resetAutoNavigationFlagForTest, __resetConsoleInstrumentationFlagForTest, __resetProviderInstanceForTest, __setNativeModuleForTest, applyArchitectureTags, captureBodyResult, detectArchitecture, drainPendingNativeCrashes, installReactNative, instrumentNavigationFromLinking, instrumentReactNavigation, redactUrl, sanitizeHeaders, tryAutoInstrumentNavigation, useAllStak };
+export { ALWAYS_REDACT_HEADERS, ALWAYS_REDACT_QUERY, AllStak, AllStakClient, type AllStakConfig, AllStakMaskedView, type AllStakMaskedViewProps, AllStakPrivacyView, AllStakProvider, type AllStakProviderProps, AllStakSensitiveText, type AllStakSensitiveTextProps, AllStakTextInput, type AllStakTextInputProps, type ArchitectureInfo, type Breadcrumb, type ConsoleCaptureOptions, DEFAULT_REDACT_BODY_FIELDS, DEFAULT_SCREENSHOT_CONFIG, type HttpRequestEvent, HttpRequestModule, type HttpTrackingOptions, INGEST_HOST, type PrivacyLevel, REDACTED, type ReactNativeInstallOptions, ReplaySurrogate, type ReplaySurrogateOptions, type RuntimeMode, SDK_NAME, SDK_VERSION, Scope, type ScreenshotArtifact, type ScreenshotCaptureOptions, type ScreenshotConfig, type ScreenshotContext, type ScreenshotFailPolicy, type ScreenshotFormat, type ScreenshotMaskStyle, type ScreenshotMetadata, type ScreenshotNativeMode, type ScreenshotRedactionMode, type ScreenshotUpload, type TransportStats, __devTriggerNativeCrash, __resetAutoNavigationFlagForTest, __resetConsoleInstrumentationFlagForTest, __resetPrivacyStateForTest, __resetProviderInstanceForTest, __resetRuntimeModeForTest, __setNativeModuleForTest, applyArchitectureTags, captureBodyResult, captureViaViewShot, detectArchitecture, detectRuntimeMode, drainPendingNativeCrashes, installReactNative, instrumentNavigationFromLinking, instrumentReactNavigation, isCapturingScreenshot, isViewShotAvailable, maybeCaptureScreenshot, pickScreenshotConfig, redactUrl, registerSensitiveRef, resolveScreenshotConfig, runtimeAllowsScreenshot, sanitizeHeaders, tryAutoInstrumentNavigation, useAllStak, useAllStakPrivacy };