@observerkit/metro 0.2.0

package/dist/cli.js

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+import {
+  isJsonObject,
+  uploadSourceMaps
+} from "./chunk-DFCKYXBG.js";
+
+// src/cli.ts
+import { parseArgs } from "util";
+import { basename, dirname, resolve } from "path";
+
+// src/repair.ts
+import { readFile, writeFile } from "fs/promises";
+var DEBUG_ID_COMMENT_PATTERN = /\/\/# debugId=([0-9a-f-]{36})/;
+function defaultPackagerMapPath(mapPath) {
+  return mapPath.endsWith(".map") ? `${mapPath.slice(0, -".map".length)}.packager.map` : `${mapPath}.packager.map`;
+}
+function defaultBundlePath(mapPath) {
+  return mapPath.endsWith(".map") ? mapPath.slice(0, -".map".length) : mapPath;
+}
+async function readDebugIdFromMap(path) {
+  let content;
+  try {
+    content = await readFile(path, "utf-8");
+  } catch {
+    return null;
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(content);
+  } catch {
+    return null;
+  }
+  if (!isJsonObject(parsed)) return null;
+  return typeof parsed["debugId"] === "string" ? parsed["debugId"] : null;
+}
+async function readDebugIdFromBundle(path) {
+  let content;
+  try {
+    content = await readFile(path, "utf-8");
+  } catch {
+    return null;
+  }
+  const match = DEBUG_ID_COMMENT_PATTERN.exec(content);
+  return match?.[1] ?? null;
+}
+async function repairDebugId(mapPath, packagerMapPath, bundlePath) {
+  const content = await readFile(mapPath, "utf-8");
+  let parsed;
+  try {
+    parsed = JSON.parse(content);
+  } catch {
+    throw new Error(`[ObserverKit] ${mapPath} is not valid JSON`);
+  }
+  if (!isJsonObject(parsed)) {
+    throw new Error(`[ObserverKit] ${mapPath} is not a source map object`);
+  }
+  if (typeof parsed["debugId"] === "string") return;
+  const packagerCandidate = packagerMapPath ?? defaultPackagerMapPath(mapPath);
+  let debugId = await readDebugIdFromMap(packagerCandidate);
+  const bundleCandidate = bundlePath ?? defaultBundlePath(mapPath);
+  if (!debugId) {
+    debugId = await readDebugIdFromBundle(bundleCandidate);
+  }
+  if (!debugId) {
+    throw new Error(
+      `[ObserverKit] ${mapPath} has no debugId and none was found in ${packagerCandidate} or ${bundleCandidate}. Is withObserverkit applied in metro.config.js? For Hermes iOS builds, pass --bundle pointing at the pre-Hermes JS bundle (e.g. $CONFIGURATION_BUILD_DIR/main.jsbundle).`
+    );
+  }
+  await writeFile(mapPath, JSON.stringify({ ...parsed, debugId }));
+}
+
+// src/cli.ts
+var PLUGIN_VERSION = "0.2.0";
+var USAGE = `Usage:
+  observerkit-upload --map <path> [--packager-map <path>] [--bundle <path>]
+  observerkit-upload --dir <path>
+
+Options:
+  --map <path>           Final source map to upload (repairs debugId first)
+  --packager-map <path>  Pre-compose Metro map to copy the debugId from
+  --bundle <path>        Pre-Hermes JS bundle to read a trailing
+                         "//# debugId=<uuid>" comment from, used when no
+                         packager map is available (Hermes iOS builds)
+  --dir <path>           Upload every debug-id source map in a directory
+                         (e.g. an expo export output)
+  --project-key <key>    Defaults to $OBSERVERKIT_PROJECT_KEY
+  --endpoint <url>       Defaults to $OBSERVERKIT_ENDPOINT or
+                         https://ingest.observerkit.com`;
+async function main() {
+  const { values } = parseArgs({
+    options: {
+      map: { type: "string" },
+      "packager-map": { type: "string" },
+      bundle: { type: "string" },
+      dir: { type: "string" },
+      "project-key": { type: "string" },
+      endpoint: { type: "string" }
+    }
+  });
+  const projectKey = values["project-key"] ?? process.env["OBSERVERKIT_PROJECT_KEY"];
+  if (!projectKey) {
+    console.error(
+      "[ObserverKit] Missing project key: pass --project-key or set OBSERVERKIT_PROJECT_KEY"
+    );
+    process.exit(1);
+  }
+  const endpoint = values.endpoint ?? process.env["OBSERVERKIT_ENDPOINT"] ?? "https://ingest.observerkit.com";
+  if (!values.map && !values.dir) {
+    console.error(USAGE);
+    process.exit(1);
+  }
+  if (values.dir && (values["packager-map"] || values.bundle)) {
+    console.error(
+      "[ObserverKit] --packager-map and --bundle are ignored when --dir is set"
+    );
+  }
+  if (values.map) {
+    if (!values.map.endsWith(".map")) {
+      console.error(`[ObserverKit] --map must point at a .map file, got "${values.map}"`);
+      process.exit(1);
+    }
+    const mapPath = resolve(values.map);
+    const packagerMap = values["packager-map"];
+    const bundle = values.bundle;
+    await repairDebugId(
+      mapPath,
+      packagerMap ? resolve(packagerMap) : void 0,
+      bundle ? resolve(bundle) : void 0
+    );
+    await uploadSourceMaps({
+      projectKey,
+      directory: dirname(mapPath),
+      endpoint,
+      deleteAfterUpload: false,
+      pluginVersion: PLUGIN_VERSION,
+      pluginName: "metro",
+      files: [basename(mapPath)]
+    });
+    return;
+  }
+  if (values.dir) {
+    await uploadSourceMaps({
+      projectKey,
+      directory: resolve(values.dir),
+      endpoint,
+      deleteAfterUpload: false,
+      pluginVersion: PLUGIN_VERSION,
+      pluginName: "metro"
+    });
+  }
+}
+main().catch((err) => {
+  console.error(err instanceof Error ? err.message : err);
+  process.exit(1);
+});

package/dist/expo.cjs

@@ -0,0 +1,92 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }require('./chunk-AUOVSTQX.cjs');
+
+// src/expo.ts
+var _configplugins = require('@expo/config-plugins');
+
+// src/native-scripts.ts
+var UPLOAD_MARKER = "observerkit-upload";
+function escapeForDoubleQuoted(value) {
+  return value.replace(/[\\"]/g, "\\$&");
+}
+function escapeForPbxprojShell(value) {
+  return escapeForDoubleQuoted(escapeForDoubleQuoted(value));
+}
+function cliFlags(props) {
+  const key = props.projectKey ? ` --project-key \\"${escapeForPbxprojShell(props.projectKey)}\\"` : "";
+  const endpoint = props.endpoint ? ` --endpoint \\"${escapeForPbxprojShell(props.endpoint)}\\"` : "";
+  return `${key}${endpoint}`;
+}
+function patchIosShellScript(script, props) {
+  if (script.includes(UPLOAD_MARKER)) return script;
+  const hasQuotes = script.startsWith('"') && script.endsWith('"');
+  const inner = hasQuotes ? script.slice(1, -1) : script;
+  const exportLine = 'export SOURCEMAP_FILE=\\"$DERIVED_FILE_DIR/main.jsbundle.map\\"\\n';
+  const uploadBlock = `\\nif [ -f \\"$SOURCEMAP_FILE\\" ]; then\\n  npx observerkit-upload --map \\"$SOURCEMAP_FILE\\" --bundle \\"$CONFIGURATION_BUILD_DIR/main.jsbundle\\"${cliFlags(props)} || echo \\"[ObserverKit] source map upload failed\\"\\nfi\\n`;
+  const patched = `${exportLine}${inner}${uploadBlock}`;
+  return hasQuotes ? `"${patched}"` : patched;
+}
+function buildGradleSnippet(props) {
+  const envLine = props.projectKey ? `
+                environment "OBSERVERKIT_PROJECT_KEY", "${escapeForDoubleQuoted(props.projectKey)}"` : "";
+  const endpointLine = props.endpoint ? `
+                environment "OBSERVERKIT_ENDPOINT", "${escapeForDoubleQuoted(props.endpoint)}"` : "";
+  return `
+// ${UPLOAD_MARKER} (added by @observerkit/metro/expo; do not edit)
+tasks.configureEach { task ->
+    def matcher = task.name =~ /^createBundle(\\w*)ReleaseJsAndAssets$/
+    if (matcher.matches()) {
+        task.doLast {
+            def flavor = matcher.group(1)
+            def variant = flavor.isEmpty()
+                ? "release"
+                : flavor.substring(0, 1).toLowerCase() + flavor.substring(1) + "Release"
+            def mapFile = file("$buildDir/generated/sourcemaps/react/" + variant + "/index.android.bundle.map")
+            def packagerMapFile = file("$buildDir/intermediates/sourcemaps/react/" + variant + "/index.android.bundle.packager.map")
+            if (mapFile.exists()) {
+                def result = exec {
+                    workingDir rootProject.projectDir.parentFile${envLine}${endpointLine}
+                    commandLine "npx", "observerkit-upload", "--map", mapFile.absolutePath, "--packager-map", packagerMapFile.absolutePath
+                    ignoreExitValue true
+                }
+                if (result.exitValue != 0) {
+                    logger.warn("[ObserverKit] source map upload failed")
+                }
+            } else {
+                logger.warn("[ObserverKit] No source map found at " + mapFile + ", skipping upload")
+            }
+        }
+    }
+}
+`;
+}
+
+// src/expo.ts
+var BUNDLE_PHASE_NAME = "Bundle React Native code and images";
+var withObserverkitIos = (config, props) => _configplugins.withXcodeProject.call(void 0, config, (c) => {
+  const project = c.modResults;
+  const phases = _nullishCoalesce(project.hash.project.objects.PBXShellScriptBuildPhase, () => ( {}));
+  for (const key of Object.keys(phases)) {
+    const phase = phases[key];
+    if (!phase || typeof phase !== "object") continue;
+    if (typeof phase.shellScript !== "string") continue;
+    if (!String(_nullishCoalesce(phase.name, () => ( ""))).includes(BUNDLE_PHASE_NAME)) continue;
+    phase.shellScript = patchIosShellScript(phase.shellScript, props);
+  }
+  return c;
+});
+var withObserverkitAndroid = (config, props) => _configplugins.withAppBuildGradle.call(void 0, config, (c) => {
+  if (!c.modResults.contents.includes(UPLOAD_MARKER)) {
+    c.modResults.contents = c.modResults.contents + buildGradleSnippet(props);
+  }
+  return c;
+});
+var withObserverkitExpo = (config, props) => {
+  const resolved = _nullishCoalesce(props, () => ( {}));
+  return withObserverkitAndroid(withObserverkitIos(config, resolved), resolved);
+};
+var expo_default = withObserverkitExpo;
+
+
+exports.default = expo_default;
+
+module.exports = exports.default;

package/dist/expo.d.cts

@@ -0,0 +1,24 @@
+import { ConfigPlugin } from '@expo/config-plugins';
+
+interface ObserverkitExpoProps {
+    /**
+     * ObserverKit project key baked into the generated build scripts. When
+     * omitted, the scripts rely on OBSERVERKIT_PROJECT_KEY being set in the
+     * build environment (e.g. EAS secrets).
+     */
+    projectKey?: string;
+    endpoint?: string;
+}
+
+/**
+ * Expo config plugin: add to app.json / app.config.js as
+ *   "plugins": [["@observerkit/metro/expo", { "projectKey": "..." }]]
+ * so prebuild wires source map upload into both native builds. Also apply
+ * withObserverkit from "@observerkit/metro" in metro.config.js so debug IDs
+ * are injected into the bundle.
+ */
+declare const withObserverkitExpo: ConfigPlugin<ObserverkitExpoProps | undefined>;
+
+// @ts-ignore
+export = withObserverkitExpo;
+export type { ObserverkitExpoProps };

package/dist/expo.d.ts

@@ -0,0 +1,22 @@
+import { ConfigPlugin } from '@expo/config-plugins';
+
+interface ObserverkitExpoProps {
+    /**
+     * ObserverKit project key baked into the generated build scripts. When
+     * omitted, the scripts rely on OBSERVERKIT_PROJECT_KEY being set in the
+     * build environment (e.g. EAS secrets).
+     */
+    projectKey?: string;
+    endpoint?: string;
+}
+
+/**
+ * Expo config plugin: add to app.json / app.config.js as
+ *   "plugins": [["@observerkit/metro/expo", { "projectKey": "..." }]]
+ * so prebuild wires source map upload into both native builds. Also apply
+ * withObserverkit from "@observerkit/metro" in metro.config.js so debug IDs
+ * are injected into the bundle.
+ */
+declare const withObserverkitExpo: ConfigPlugin<ObserverkitExpoProps | undefined>;
+
+export { type ObserverkitExpoProps, withObserverkitExpo as default };

package/dist/expo.js

@@ -0,0 +1,88 @@
+// src/expo.ts
+import { withAppBuildGradle, withXcodeProject } from "@expo/config-plugins";
+
+// src/native-scripts.ts
+var UPLOAD_MARKER = "observerkit-upload";
+function escapeForDoubleQuoted(value) {
+  return value.replace(/[\\"]/g, "\\$&");
+}
+function escapeForPbxprojShell(value) {
+  return escapeForDoubleQuoted(escapeForDoubleQuoted(value));
+}
+function cliFlags(props) {
+  const key = props.projectKey ? ` --project-key \\"${escapeForPbxprojShell(props.projectKey)}\\"` : "";
+  const endpoint = props.endpoint ? ` --endpoint \\"${escapeForPbxprojShell(props.endpoint)}\\"` : "";
+  return `${key}${endpoint}`;
+}
+function patchIosShellScript(script, props) {
+  if (script.includes(UPLOAD_MARKER)) return script;
+  const hasQuotes = script.startsWith('"') && script.endsWith('"');
+  const inner = hasQuotes ? script.slice(1, -1) : script;
+  const exportLine = 'export SOURCEMAP_FILE=\\"$DERIVED_FILE_DIR/main.jsbundle.map\\"\\n';
+  const uploadBlock = `\\nif [ -f \\"$SOURCEMAP_FILE\\" ]; then\\n  npx observerkit-upload --map \\"$SOURCEMAP_FILE\\" --bundle \\"$CONFIGURATION_BUILD_DIR/main.jsbundle\\"${cliFlags(props)} || echo \\"[ObserverKit] source map upload failed\\"\\nfi\\n`;
+  const patched = `${exportLine}${inner}${uploadBlock}`;
+  return hasQuotes ? `"${patched}"` : patched;
+}
+function buildGradleSnippet(props) {
+  const envLine = props.projectKey ? `
+                environment "OBSERVERKIT_PROJECT_KEY", "${escapeForDoubleQuoted(props.projectKey)}"` : "";
+  const endpointLine = props.endpoint ? `
+                environment "OBSERVERKIT_ENDPOINT", "${escapeForDoubleQuoted(props.endpoint)}"` : "";
+  return `
+// ${UPLOAD_MARKER} (added by @observerkit/metro/expo; do not edit)
+tasks.configureEach { task ->
+    def matcher = task.name =~ /^createBundle(\\w*)ReleaseJsAndAssets$/
+    if (matcher.matches()) {
+        task.doLast {
+            def flavor = matcher.group(1)
+            def variant = flavor.isEmpty()
+                ? "release"
+                : flavor.substring(0, 1).toLowerCase() + flavor.substring(1) + "Release"
+            def mapFile = file("$buildDir/generated/sourcemaps/react/" + variant + "/index.android.bundle.map")
+            def packagerMapFile = file("$buildDir/intermediates/sourcemaps/react/" + variant + "/index.android.bundle.packager.map")
+            if (mapFile.exists()) {
+                def result = exec {
+                    workingDir rootProject.projectDir.parentFile${envLine}${endpointLine}
+                    commandLine "npx", "observerkit-upload", "--map", mapFile.absolutePath, "--packager-map", packagerMapFile.absolutePath
+                    ignoreExitValue true
+                }
+                if (result.exitValue != 0) {
+                    logger.warn("[ObserverKit] source map upload failed")
+                }
+            } else {
+                logger.warn("[ObserverKit] No source map found at " + mapFile + ", skipping upload")
+            }
+        }
+    }
+}
+`;
+}
+
+// src/expo.ts
+var BUNDLE_PHASE_NAME = "Bundle React Native code and images";
+var withObserverkitIos = (config, props) => withXcodeProject(config, (c) => {
+  const project = c.modResults;
+  const phases = project.hash.project.objects.PBXShellScriptBuildPhase ?? {};
+  for (const key of Object.keys(phases)) {
+    const phase = phases[key];
+    if (!phase || typeof phase !== "object") continue;
+    if (typeof phase.shellScript !== "string") continue;
+    if (!String(phase.name ?? "").includes(BUNDLE_PHASE_NAME)) continue;
+    phase.shellScript = patchIosShellScript(phase.shellScript, props);
+  }
+  return c;
+});
+var withObserverkitAndroid = (config, props) => withAppBuildGradle(config, (c) => {
+  if (!c.modResults.contents.includes(UPLOAD_MARKER)) {
+    c.modResults.contents = c.modResults.contents + buildGradleSnippet(props);
+  }
+  return c;
+});
+var withObserverkitExpo = (config, props) => {
+  const resolved = props ?? {};
+  return withObserverkitAndroid(withObserverkitIos(config, resolved), resolved);
+};
+var expo_default = withObserverkitExpo;
+export {
+  expo_default as default
+};

package/dist/index.cjs

@@ -0,0 +1,135 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+
+var _chunk6RJOM2COcjs = require('./chunk-6RJOM2CO.cjs');
+
+
+var _chunkAUOVSTQXcjs = require('./chunk-AUOVSTQX.cjs');
+
+// src/serializer.ts
+var _module = require('module');
+var DEBUG_ID_PLACEHOLDER = "00000000-0000-0000-0000-000000000000";
+var DEBUG_ID_MODULE_PATH = "__observerkit-debug-id__";
+function createDebugIdModule(code) {
+  return {
+    path: DEBUG_ID_MODULE_PATH,
+    dependencies: /* @__PURE__ */ new Map(),
+    getSource: () => Buffer.from(code),
+    inverseDependencies: /* @__PURE__ */ new Set(),
+    output: [
+      {
+        type: "js/script/virtual",
+        data: { code, lineCount: 1, map: [] }
+      }
+    ]
+  };
+}
+function injectDebugIdModule(preModules, debugIdModule) {
+  if (preModules.some((m) => m.path === DEBUG_ID_MODULE_PATH)) return preModules;
+  const preludeIndex = preModules.findIndex((m) => m.path === "__prelude__");
+  if (preludeIndex === -1) return [debugIdModule, ...preModules];
+  return [
+    ...preModules.slice(0, preludeIndex + 1),
+    debugIdModule,
+    ...preModules.slice(preludeIndex + 1)
+  ];
+}
+function addDebugIdToMap(map, debugId) {
+  let parsed;
+  try {
+    parsed = JSON.parse(map);
+  } catch (e) {
+    return map;
+  }
+  if (!_chunk6RJOM2COcjs.isJsonObject.call(void 0, parsed)) return map;
+  return JSON.stringify({ ...parsed, debugId });
+}
+function unwrapModuleExport(mod, exportName) {
+  if (exportName) {
+    const named = _chunk6RJOM2COcjs.isJsonObject.call(void 0, mod) ? mod[exportName] : void 0;
+    if (typeof named === "function") return named;
+  }
+  const defaultExport = _chunk6RJOM2COcjs.isJsonObject.call(void 0, mod) ? mod["default"] : void 0;
+  if (typeof defaultExport === "function") return defaultExport;
+  if (typeof mod === "function") return mod;
+  throw new Error(
+    `[ObserverKit] Could not resolve${exportName ? ` a "${exportName}" or` : ""} a default export from a Metro internal module.`
+  );
+}
+function loadDefaultSerializer() {
+  const require2 = _module.createRequire.call(void 0, _chunkAUOVSTQXcjs.importMetaUrl);
+  const load = (id, exportName) => {
+    const mod = require2(id);
+    return unwrapModuleExport(mod, exportName);
+  };
+  let baseJSBundle;
+  let bundleToString;
+  let sourceMapString;
+  try {
+    baseJSBundle = load("metro/src/DeltaBundler/Serializers/baseJSBundle");
+    bundleToString = load("metro/src/lib/bundleToString");
+    sourceMapString = load(
+      "metro/src/DeltaBundler/Serializers/sourceMapString",
+      "sourceMapString"
+    );
+  } catch (err) {
+    throw new Error(
+      "[ObserverKit] Could not load Metro's serializer internals. Add metro as a devDependency of your app (pnpm add -D metro) or set a customSerializer in metro.config.js before withObserverkit.",
+      { cause: err }
+    );
+  }
+  return (entryPoint, preModules, graph, options) => {
+    const bundle = baseJSBundle.apply(void 0, [entryPoint, preModules, graph, options]);
+    const { code } = bundleToString.apply(void 0, [bundle]);
+    if (options.dev) return code;
+    const sortedModules = [...graph.dependencies.values()].sort(
+      (a, b) => options.createModuleId(a.path) - options.createModuleId(b.path)
+    );
+    const map = sourceMapString.apply(void 0, [
+      [...preModules, ...sortedModules],
+      {
+        excludeSource: false,
+        processModuleFilter: options.processModuleFilter,
+        shouldAddToIgnoreList: options.shouldAddToIgnoreList
+      }
+    ]);
+    return { code, map };
+  };
+}
+function createObserverkitSerializer(wrapped) {
+  return async (entryPoint, preModules, graph, options) => {
+    const serializer = _nullishCoalesce(wrapped, () => ( loadDefaultSerializer()));
+    if (options.dev) {
+      return serializer(entryPoint, preModules, graph, options);
+    }
+    const { snippet } = _chunk6RJOM2COcjs.buildStackKeyedDebugIdSnippet.call(void 0, DEBUG_ID_PLACEHOLDER);
+    const withDebugId = injectDebugIdModule(preModules, createDebugIdModule(snippet));
+    const result = await serializer(entryPoint, withDebugId, graph, options);
+    const code = typeof result === "string" ? result : result.code;
+    const map = typeof result === "string" ? null : result.map;
+    const debugId = _chunk6RJOM2COcjs.generateDebugId.call(void 0, code);
+    const finalCode = `${code.split(DEBUG_ID_PLACEHOLDER).join(debugId)}
+//# debugId=${debugId}`;
+    if (map === null) return finalCode;
+    return { code: finalCode, map: addDebugIdToMap(map, debugId) };
+  };
+}
+
+// src/index.ts
+function withObserverkit(config) {
+  return {
+    ...config,
+    serializer: {
+      ...config.serializer,
+      customSerializer: createObserverkitSerializer(
+        _optionalChain([config, 'access', _ => _.serializer, 'optionalAccess', _2 => _2.customSerializer])
+      )
+    }
+  };
+}
+
+
+
+
+exports.DEBUG_ID_PLACEHOLDER = DEBUG_ID_PLACEHOLDER; exports.createObserverkitSerializer = createObserverkitSerializer; exports.default = withObserverkit;

package/dist/index.d.cts

@@ -0,0 +1,65 @@
+interface MetroModuleOutputData {
+    code: string;
+    lineCount: number;
+    map: ReadonlyArray<unknown>;
+}
+interface MetroModuleOutput {
+    type: string;
+    data: MetroModuleOutputData;
+}
+interface MetroModule {
+    path: string;
+    dependencies: ReadonlyMap<string, unknown>;
+    getSource: () => Buffer;
+    inverseDependencies: Iterable<string>;
+    output: ReadonlyArray<MetroModuleOutput>;
+}
+interface MetroGraph {
+    dependencies: ReadonlyMap<string, MetroModule>;
+    [key: string]: unknown;
+}
+interface MetroSerializerOptions {
+    dev: boolean;
+    createModuleId: (filePath: string) => number;
+    processModuleFilter?: (module: MetroModule) => boolean;
+    shouldAddToIgnoreList?: (module: MetroModule) => boolean;
+    sourceMapUrl?: string | null;
+    [key: string]: unknown;
+}
+type MetroSerializerResult = string | {
+    code: string;
+    map: string;
+};
+type MetroSerializer = (entryPoint: string, preModules: ReadonlyArray<MetroModule>, graph: MetroGraph, options: MetroSerializerOptions) => MetroSerializerResult | Promise<MetroSerializerResult>;
+interface MetroConfigLike {
+    serializer?: {
+        customSerializer?: MetroSerializer;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+
+/**
+ * Fixed-length placeholder baked into the injected snippet before
+ * serialization. The real debug id (uuid v5 of the serialized bundle) is the
+ * same length, so the post-serialization string replacement never shifts
+ * source map positions.
+ */
+declare const DEBUG_ID_PLACEHOLDER = "00000000-0000-0000-0000-000000000000";
+declare function createObserverkitSerializer(wrapped?: MetroSerializer): MetroSerializer;
+
+/**
+ * Wire ObserverKit debug-id injection into a Metro config:
+ *
+ *   const { getDefaultConfig } = require("@react-native/metro-config")
+ *   const withObserverkit = require("@observerkit/metro")
+ *   module.exports = withObserverkit(getDefaultConfig(__dirname))
+ *
+ * Source map upload happens separately via the observerkit-upload CLI in the
+ * native build (Xcode build phase / Gradle task / Expo config plugin).
+ */
+declare function withObserverkit(config: MetroConfigLike): MetroConfigLike;
+
+// @ts-ignore
+export = withObserverkit;
+export { DEBUG_ID_PLACEHOLDER, type MetroConfigLike, type MetroGraph, type MetroModule, type MetroSerializer, type MetroSerializerOptions, type MetroSerializerResult, createObserverkitSerializer };

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+interface MetroModuleOutputData {
+    code: string;
+    lineCount: number;
+    map: ReadonlyArray<unknown>;
+}
+interface MetroModuleOutput {
+    type: string;
+    data: MetroModuleOutputData;
+}
+interface MetroModule {
+    path: string;
+    dependencies: ReadonlyMap<string, unknown>;
+    getSource: () => Buffer;
+    inverseDependencies: Iterable<string>;
+    output: ReadonlyArray<MetroModuleOutput>;
+}
+interface MetroGraph {
+    dependencies: ReadonlyMap<string, MetroModule>;
+    [key: string]: unknown;
+}
+interface MetroSerializerOptions {
+    dev: boolean;
+    createModuleId: (filePath: string) => number;
+    processModuleFilter?: (module: MetroModule) => boolean;
+    shouldAddToIgnoreList?: (module: MetroModule) => boolean;
+    sourceMapUrl?: string | null;
+    [key: string]: unknown;
+}
+type MetroSerializerResult = string | {
+    code: string;
+    map: string;
+};
+type MetroSerializer = (entryPoint: string, preModules: ReadonlyArray<MetroModule>, graph: MetroGraph, options: MetroSerializerOptions) => MetroSerializerResult | Promise<MetroSerializerResult>;
+interface MetroConfigLike {
+    serializer?: {
+        customSerializer?: MetroSerializer;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+
+/**
+ * Fixed-length placeholder baked into the injected snippet before
+ * serialization. The real debug id (uuid v5 of the serialized bundle) is the
+ * same length, so the post-serialization string replacement never shifts
+ * source map positions.
+ */
+declare const DEBUG_ID_PLACEHOLDER = "00000000-0000-0000-0000-000000000000";
+declare function createObserverkitSerializer(wrapped?: MetroSerializer): MetroSerializer;
+
+/**
+ * Wire ObserverKit debug-id injection into a Metro config:
+ *
+ *   const { getDefaultConfig } = require("@react-native/metro-config")
+ *   const withObserverkit = require("@observerkit/metro")
+ *   module.exports = withObserverkit(getDefaultConfig(__dirname))
+ *
+ * Source map upload happens separately via the observerkit-upload CLI in the
+ * native build (Xcode build phase / Gradle task / Expo config plugin).
+ */
+declare function withObserverkit(config: MetroConfigLike): MetroConfigLike;
+
+export { DEBUG_ID_PLACEHOLDER, type MetroConfigLike, type MetroGraph, type MetroModule, type MetroSerializer, type MetroSerializerOptions, type MetroSerializerResult, createObserverkitSerializer, withObserverkit as default };