@getmonitor/cli 0.1.0

package/dist/index.js

@@ -0,0 +1,265 @@
+import { randomUUID } from 'node:crypto';
+import { readdirSync, existsSync, readFileSync, writeFileSync, rmSync } from 'node:fs';
+import { join, dirname, relative } from 'node:path';
+import { execFileSync } from 'node:child_process';
+
+// packages/cli/src/discoverArtifacts.ts
+const SOURCE_MAPPING_URL = /^\s*\/\/#\s*sourceMappingURL=(\S+)\s*$/gm;
+// Node recognizes three JS module extensions with runtime meaning (`.js`, `.mjs` for explicit
+// ESM, `.cjs` for explicit CommonJS regardless of the nearest package.json's "type") — all three
+// show up as real build output. Nitro's node-server preset (used by `@getmonitor/nuxt`'s e2e
+// test), for one, emits `.output/server/**/*.mjs` unconditionally: verified against a real
+// `nuxt build`, where a `.js`-only match left every server chunk's `.map` file undiscovered and
+// unstripped even though `.output/` itself was already fully written by the time discovery ran.
+const JS_EXTENSIONS = ['.js', '.mjs', '.cjs'];
+/** Recursively finds every JS file (`.js`, `.mjs`, `.cjs`) under `directory` and resolves its
+ * source map path primarily via its `//# sourceMappingURL=` comment (resolved relative to the
+ * JS file's own directory), falling back to same-basename-plus-`.map` when there's no comment,
+ * the comment references a data: URI, or the referenced file doesn't exist. A JS file with no
+ * resolvable map either way is skipped. */
+function discoverArtifacts(directory) {
+    const artifacts = [];
+    walk(directory, artifacts);
+    return artifacts;
+}
+function walk(dir, artifacts) {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            walk(fullPath, artifacts);
+        }
+        else if (entry.isFile() && JS_EXTENSIONS.some((ext) => entry.name.endsWith(ext))) {
+            const mapPath = resolveMapPath(fullPath);
+            if (mapPath)
+                artifacts.push({ jsPath: fullPath, mapPath });
+        }
+    }
+}
+function resolveMapPath(jsPath) {
+    const commentMapPath = readSourceMappingUrlComment(jsPath);
+    if (commentMapPath && existsSync(commentMapPath))
+        return commentMapPath;
+    const fallbackMapPath = `${jsPath}.map`;
+    if (existsSync(fallbackMapPath))
+        return fallbackMapPath;
+    return undefined;
+}
+function readSourceMappingUrlComment(jsPath) {
+    let content;
+    try {
+        content = readFileSync(jsPath, 'utf8');
+    }
+    catch {
+        // Unreadable file (permission denied, broken symlink, deleted mid-walk, etc.) — treat it
+        // like "no comment found" rather than aborting the whole discoverArtifacts() walk.
+        return undefined;
+    }
+    const matches = [...content.matchAll(SOURCE_MAPPING_URL)];
+    if (matches.length === 0)
+        return undefined;
+    // The LAST sourceMappingURL comment in the file wins, matching how bundlers/browsers treat
+    // concatenated/reprocessed output — later comments supersede earlier ones.
+    const reference = matches.at(-1)[1];
+    if (reference.startsWith('data:'))
+        return undefined; // embedded map, nothing to discover on disk
+    return join(dirname(jsPath), reference);
+}
+
+// packages/cli/src/injectDebugId.ts
+/** Computes the debug-ID-injected JS content and the debug-ID-tagged source map JSON, in
+ * memory — callers decide whether/when to persist the result to disk (processSourceMaps
+ * only writes it after a successful upload, so a failed upload never leaves partially
+ * mutated files behind). The injected JS also has its `//# sourceMappingURL=` comment(s)
+ * removed, since the source map it names is only ever kept in GetMonitor's backend after
+ * a successful upload — never served publicly alongside it.
+ *
+ * `originalMapJson` must be valid JSON — this is a pure function with no fallback to
+ * degrade to (unlike discoverArtifacts, which can skip an unreadable file, this function's
+ * caller expects a definite result), so a malformed map is left to throw via JSON.parse
+ * rather than being swallowed here. */
+function injectDebugId(originalJs, originalMapJson, debugId) {
+    const withoutMapComment = originalJs
+        .split('\n')
+        .filter((line) => !line.trimStart().startsWith('//# sourceMappingURL='))
+        .join('\n');
+    const map = JSON.parse(originalMapJson);
+    map.debugId = debugId;
+    return {
+        js: `${withoutMapComment}\n${buildInjectedSnippet(debugId)}`,
+        map: JSON.stringify(map),
+    };
+}
+/** At load time, captures this statement's own `Error().stack`, extracts this file's
+ * identity from it using the same frame-shape @getmonitor/core's parseStackTrace parses for
+ * real errors (V8's `at ... (file:line:col)`, V8's bare `at file:line:col`, and Gecko's
+ * `fn@file:line:col`), and registers the debug ID under that identity. Like parseStackTrace,
+ * it scans every stack line and takes the first one that matches any of those shapes, rather
+ * than assuming a fixed line index — V8 prefixes an `"ErrorType: message"` header line that
+ * Gecko and Safari don't emit, so a fixed index would grab the wrong frame (or the wrong
+ * file's identity) on non-V8 engines; the header line simply fails to match any frame regex
+ * and is skipped automatically. A later real error whose frame.filename is parsed from the
+ * same JS-engine stack serialization will look up the same key. Wrapped in try/catch so any
+ * parsing edge case can never break the host app; wrapped in an IIFE so its locals don't leak
+ * into the file's module scope.
+ *
+ * `debugId` is interpolated unescaped into the generated snippet's string literal. That's
+ * safe today because every caller in this system sources `debugId` from
+ * `crypto.randomUUID()` (a later task), which can never contain a quote or backslash — but
+ * this function itself doesn't enforce that shape, so a caller passing an arbitrary string
+ * containing `'` or `\` would produce invalid/injected JS here. Flagged, not fixed, since
+ * validating/escaping isn't part of this function's specified contract. */
+function buildInjectedSnippet(debugId) {
+    return (";(function(){try{var s=(new Error()).stack||'';var ls=s.split('\\n');var m=null;" +
+        'for(var i=0;i<ls.length&&!m;i++){var l=ls[i];' +
+        "m=l.match(/\\((.*):(\\d+):(\\d+)\\)\\s*$/)||l.match(/at (.*):(\\d+):(\\d+)\\s*$/)||l.match(/@(.*):(\\d+):(\\d+)\\s*$/)}" +
+        "var f=m&&m[1];if(f){var g=(typeof globalThis!=='undefined'?globalThis:self);" +
+        `g.__getmonitorDebugIds=g.__getmonitorDebugIds||{};g.__getmonitorDebugIds[f]='${debugId}';` +
+        '}}catch(e){}})();');
+}
+
+// packages/cli/src/resolveRelease.ts
+/** Resolves the release identifier to tag uploaded source maps with. Precedence: explicit
+ * argument -> GETMONITOR_RELEASE env var -> current git commit SHA (if `directory` is inside
+ * a git working tree) -> `version` field of the nearest package.json walking up from
+ * `directory`. Matches the SDKs' own optional `release` field so events and source maps
+ * for the same deploy carry the same value. */
+function resolveRelease(directory, explicit) {
+    if (explicit)
+        return explicit;
+    if (process.env.GETMONITOR_RELEASE)
+        return process.env.GETMONITOR_RELEASE;
+    const gitSha = tryGitSha(directory);
+    if (gitSha)
+        return gitSha;
+    const packageVersion = tryPackageVersion(directory);
+    if (packageVersion)
+        return packageVersion;
+    throw new Error('Could not resolve a release. Pass --release, set GETMONITOR_RELEASE, run inside a git repository, or add a package.json with a "version" field.');
+}
+function tryGitSha(directory) {
+    try {
+        return execFileSync('git', ['rev-parse', 'HEAD'], {
+            cwd: directory,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+function tryPackageVersion(directory) {
+    let dir = directory;
+    for (let i = 0; i < 20; i++) {
+        const pkgPath = join(dir, 'package.json');
+        if (existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+                return typeof pkg.version === 'string' ? pkg.version : undefined;
+            }
+            catch {
+                return undefined;
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+    return undefined;
+}
+
+// packages/cli/src/uploadSourceMap.ts
+/** POSTs a single source map artifact to the (not-yet-implemented) backend contract
+ * documented in docs/superpowers/specs/2026-08-09-phase-2-source-maps-design.md. Throws on
+ * any non-2xx response or network failure — the caller (processSourceMaps) decides what
+ * "failed" means for its own result reporting and disk-write ordering. */
+async function uploadSourceMap(params) {
+    // Must bind to globalThis, mirroring @getmonitor/core's HttpTransport: browsers' native
+    // fetch() throws "Illegal invocation" if called with a `this` other than
+    // Window/WorkerGlobalScope. Here fetchImpl is invoked as a plain function call below
+    // (`fetchImpl(url, init)`, never `params.fetchImpl(...)` or `this.fetchImpl(...)`), so this
+    // bind is defensive/consistent rather than load-bearing for this particular call site — but
+    // keeping the same default expression as HttpTransport avoids a divergent default if this
+    // code is ever refactored into a method.
+    const fetchImpl = params.fetchImpl ?? fetch.bind(globalThis);
+    const form = new FormData();
+    form.set('release', params.release);
+    form.set('debugId', params.debugId);
+    form.set('filename', params.filename);
+    form.set('sourcemap', new Blob([params.mapContent], { type: 'application/json' }), `${params.filename}.map`);
+    const response = await fetchImpl(`${params.apiHost}/api/v1/sourcemaps`, {
+        method: 'POST',
+        headers: { Authorization: `Bearer ${params.authToken}` },
+        body: form,
+    });
+    if (!response.ok) {
+        throw new Error(`Source map upload failed for ${params.filename}: ${response.status} ${response.statusText}`);
+    }
+}
+
+// packages/cli/src/processSourceMaps.ts
+/** Finds every JS/map artifact pair under `options.directory`, and for each one: injects a
+ * debug ID, uploads the tagged source map, and — only on a successful upload — writes the
+ * debug-ID-injected JS back to disk and deletes the `.map` file. An artifact whose upload
+ * fails is left completely untouched on disk, so it can be retried by re-running this
+ * function against the same directory. */
+async function processSourceMaps(options) {
+    const authToken = options.authToken ?? process.env.GETMONITOR_AUTH_TOKEN;
+    if (!authToken) {
+        throw new Error('Missing auth token. Pass --auth-token or set GETMONITOR_AUTH_TOKEN.');
+    }
+    const release = resolveRelease(options.directory, options.release);
+    const artifacts = discoverArtifacts(options.directory);
+    const result = { uploaded: [], failed: [] };
+    for (const artifact of artifacts) {
+        const debugId = randomUUID();
+        let injected;
+        try {
+            const originalJs = readFileSync(artifact.jsPath, 'utf8');
+            const originalMap = readFileSync(artifact.mapPath, 'utf8');
+            // injectDebugId is a pure function that throws on malformed map JSON (by design — see
+            // its own doc comment). That's deliberately caught here, alongside upload failures: one
+            // corrupt/unreadable artifact on disk must not abort processing of every other artifact
+            // in the directory, the same failure-isolation principle discoverArtifacts applies to
+            // unreadable files during its walk. Nothing has been uploaded or written yet at this
+            // point, so a thrown injectDebugId or upload failure leaves the artifact's files
+            // completely untouched, and it's safe to report it as `failed` for a retry.
+            injected = injectDebugId(originalJs, originalMap, debugId);
+            await uploadSourceMap({
+                apiHost: options.apiHost,
+                authToken,
+                release,
+                debugId,
+                // Relative to options.directory, not the absolute on-disk path — the backend has no
+                // use for (and shouldn't see) the build machine's local filesystem layout.
+                filename: relative(options.directory, artifact.jsPath),
+                mapContent: injected.map,
+                fetchImpl: options.fetchImpl,
+            });
+        }
+        catch {
+            result.failed.push(artifact.jsPath);
+            continue;
+        }
+        try {
+            writeFileSync(artifact.jsPath, injected.js);
+            rmSync(artifact.mapPath);
+            result.uploaded.push(artifact.jsPath);
+        }
+        catch (cleanupError) {
+            // The upload above already succeeded, so this must never land in `failed` — a caller
+            // retrying failed artifacts would mint a fresh debugId and re-upload, orphaning this
+            // upload server-side under the old one with no way to reconcile the two. The local
+            // cleanup failure (disk full, permission error, file lock) is real and worth knowing
+            // about, so it's surfaced here rather than silently swallowed, but it doesn't change
+            // the artifact's outcome.
+            result.uploaded.push(artifact.jsPath);
+            console.error(`Uploaded ${artifact.jsPath} but failed to update local files:`, cleanupError);
+        }
+    }
+    return result;
+}
+
+export { processSourceMaps };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/discoverArtifacts.ts","../src/injectDebugId.ts","../src/resolveRelease.ts","../src/uploadSourceMap.ts","../src/processSourceMaps.ts"],"sourcesContent":["// packages/cli/src/discoverArtifacts.ts\nimport { existsSync, readdirSync, readFileSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\n\nexport interface Artifact {\n  jsPath: string\n  mapPath: string\n}\n\nconst SOURCE_MAPPING_URL = /^\\s*\\/\\/#\\s*sourceMappingURL=(\\S+)\\s*$/gm\n\n// Node recognizes three JS module extensions with runtime meaning (`.js`, `.mjs` for explicit\n// ESM, `.cjs` for explicit CommonJS regardless of the nearest package.json's \"type\") — all three\n// show up as real build output. Nitro's node-server preset (used by `@getmonitor/nuxt`'s e2e\n// test), for one, emits `.output/server/**/*.mjs` unconditionally: verified against a real\n// `nuxt build`, where a `.js`-only match left every server chunk's `.map` file undiscovered and\n// unstripped even though `.output/` itself was already fully written by the time discovery ran.\nconst JS_EXTENSIONS = ['.js', '.mjs', '.cjs']\n\n/** Recursively finds every JS file (`.js`, `.mjs`, `.cjs`) under `directory` and resolves its\n * source map path primarily via its `//# sourceMappingURL=` comment (resolved relative to the\n * JS file's own directory), falling back to same-basename-plus-`.map` when there's no comment,\n * the comment references a data: URI, or the referenced file doesn't exist. A JS file with no\n * resolvable map either way is skipped. */\nexport function discoverArtifacts(directory: string): Artifact[] {\n  const artifacts: Artifact[] = []\n  walk(directory, artifacts)\n  return artifacts\n}\n\nfunction walk(dir: string, artifacts: Artifact[]): void {\n  for (const entry of readdirSync(dir, { withFileTypes: true })) {\n    const fullPath = join(dir, entry.name)\n    if (entry.isDirectory()) {\n      walk(fullPath, artifacts)\n    } else if (entry.isFile() && JS_EXTENSIONS.some((ext) => entry.name.endsWith(ext))) {\n      const mapPath = resolveMapPath(fullPath)\n      if (mapPath) artifacts.push({ jsPath: fullPath, mapPath })\n    }\n  }\n}\n\nfunction resolveMapPath(jsPath: string): string | undefined {\n  const commentMapPath = readSourceMappingUrlComment(jsPath)\n  if (commentMapPath && existsSync(commentMapPath)) return commentMapPath\n\n  const fallbackMapPath = `${jsPath}.map`\n  if (existsSync(fallbackMapPath)) return fallbackMapPath\n\n  return undefined\n}\n\nfunction readSourceMappingUrlComment(jsPath: string): string | undefined {\n  let content: string\n  try {\n    content = readFileSync(jsPath, 'utf8')\n  } catch {\n    // Unreadable file (permission denied, broken symlink, deleted mid-walk, etc.) — treat it\n    // like \"no comment found\" rather than aborting the whole discoverArtifacts() walk.\n    return undefined\n  }\n\n  const matches = [...content.matchAll(SOURCE_MAPPING_URL)]\n  if (matches.length === 0) return undefined\n\n  // The LAST sourceMappingURL comment in the file wins, matching how bundlers/browsers treat\n  // concatenated/reprocessed output — later comments supersede earlier ones.\n  const reference = matches.at(-1)![1]\n  if (reference.startsWith('data:')) return undefined // embedded map, nothing to discover on disk\n\n  return join(dirname(jsPath), reference)\n}\n","// packages/cli/src/injectDebugId.ts\n\nexport interface InjectedArtifact {\n  js: string\n  map: string\n}\n\n/** Computes the debug-ID-injected JS content and the debug-ID-tagged source map JSON, in\n * memory — callers decide whether/when to persist the result to disk (processSourceMaps\n * only writes it after a successful upload, so a failed upload never leaves partially\n * mutated files behind). The injected JS also has its `//# sourceMappingURL=` comment(s)\n * removed, since the source map it names is only ever kept in GetMonitor's backend after\n * a successful upload — never served publicly alongside it.\n *\n * `originalMapJson` must be valid JSON — this is a pure function with no fallback to\n * degrade to (unlike discoverArtifacts, which can skip an unreadable file, this function's\n * caller expects a definite result), so a malformed map is left to throw via JSON.parse\n * rather than being swallowed here. */\nexport function injectDebugId(originalJs: string, originalMapJson: string, debugId: string): InjectedArtifact {\n  const withoutMapComment = originalJs\n    .split('\\n')\n    .filter((line) => !line.trimStart().startsWith('//# sourceMappingURL='))\n    .join('\\n')\n\n  const map = JSON.parse(originalMapJson)\n  map.debugId = debugId\n\n  return {\n    js: `${withoutMapComment}\\n${buildInjectedSnippet(debugId)}`,\n    map: JSON.stringify(map),\n  }\n}\n\n/** At load time, captures this statement's own `Error().stack`, extracts this file's\n * identity from it using the same frame-shape @getmonitor/core's parseStackTrace parses for\n * real errors (V8's `at ... (file:line:col)`, V8's bare `at file:line:col`, and Gecko's\n * `fn@file:line:col`), and registers the debug ID under that identity. Like parseStackTrace,\n * it scans every stack line and takes the first one that matches any of those shapes, rather\n * than assuming a fixed line index — V8 prefixes an `\"ErrorType: message\"` header line that\n * Gecko and Safari don't emit, so a fixed index would grab the wrong frame (or the wrong\n * file's identity) on non-V8 engines; the header line simply fails to match any frame regex\n * and is skipped automatically. A later real error whose frame.filename is parsed from the\n * same JS-engine stack serialization will look up the same key. Wrapped in try/catch so any\n * parsing edge case can never break the host app; wrapped in an IIFE so its locals don't leak\n * into the file's module scope.\n *\n * `debugId` is interpolated unescaped into the generated snippet's string literal. That's\n * safe today because every caller in this system sources `debugId` from\n * `crypto.randomUUID()` (a later task), which can never contain a quote or backslash — but\n * this function itself doesn't enforce that shape, so a caller passing an arbitrary string\n * containing `'` or `\\` would produce invalid/injected JS here. Flagged, not fixed, since\n * validating/escaping isn't part of this function's specified contract. */\nfunction buildInjectedSnippet(debugId: string): string {\n  return (\n    \";(function(){try{var s=(new Error()).stack||'';var ls=s.split('\\\\n');var m=null;\" +\n    'for(var i=0;i<ls.length&&!m;i++){var l=ls[i];' +\n    \"m=l.match(/\\\\((.*):(\\\\d+):(\\\\d+)\\\\)\\\\s*$/)||l.match(/at (.*):(\\\\d+):(\\\\d+)\\\\s*$/)||l.match(/@(.*):(\\\\d+):(\\\\d+)\\\\s*$/)}\" +\n    \"var f=m&&m[1];if(f){var g=(typeof globalThis!=='undefined'?globalThis:self);\" +\n    `g.__getmonitorDebugIds=g.__getmonitorDebugIds||{};g.__getmonitorDebugIds[f]='${debugId}';` +\n    '}}catch(e){}})();'\n  )\n}\n","// packages/cli/src/resolveRelease.ts\nimport { execFileSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\n\n/** Resolves the release identifier to tag uploaded source maps with. Precedence: explicit\n * argument -> GETMONITOR_RELEASE env var -> current git commit SHA (if `directory` is inside\n * a git working tree) -> `version` field of the nearest package.json walking up from\n * `directory`. Matches the SDKs' own optional `release` field so events and source maps\n * for the same deploy carry the same value. */\nexport function resolveRelease(directory: string, explicit?: string): string {\n  if (explicit) return explicit\n  if (process.env.GETMONITOR_RELEASE) return process.env.GETMONITOR_RELEASE\n\n  const gitSha = tryGitSha(directory)\n  if (gitSha) return gitSha\n\n  const packageVersion = tryPackageVersion(directory)\n  if (packageVersion) return packageVersion\n\n  throw new Error(\n    'Could not resolve a release. Pass --release, set GETMONITOR_RELEASE, run inside a git repository, or add a package.json with a \"version\" field.',\n  )\n}\n\nfunction tryGitSha(directory: string): string | undefined {\n  try {\n    return execFileSync('git', ['rev-parse', 'HEAD'], {\n      cwd: directory,\n      encoding: 'utf8',\n      stdio: ['ignore', 'pipe', 'ignore'],\n    }).trim()\n  } catch {\n    return undefined\n  }\n}\n\nfunction tryPackageVersion(directory: string): string | undefined {\n  let dir = directory\n  for (let i = 0; i < 20; i++) {\n    const pkgPath = join(dir, 'package.json')\n    if (existsSync(pkgPath)) {\n      try {\n        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'))\n        return typeof pkg.version === 'string' ? pkg.version : undefined\n      } catch {\n        return undefined\n      }\n    }\n    const parent = dirname(dir)\n    if (parent === dir) return undefined\n    dir = parent\n  }\n  return undefined\n}\n","// packages/cli/src/uploadSourceMap.ts\n\nexport interface UploadSourceMapParams {\n  apiHost: string\n  authToken: string\n  release: string\n  debugId: string\n  filename: string\n  mapContent: string\n  fetchImpl?: typeof fetch\n}\n\n/** POSTs a single source map artifact to the (not-yet-implemented) backend contract\n * documented in docs/superpowers/specs/2026-08-09-phase-2-source-maps-design.md. Throws on\n * any non-2xx response or network failure — the caller (processSourceMaps) decides what\n * \"failed\" means for its own result reporting and disk-write ordering. */\nexport async function uploadSourceMap(params: UploadSourceMapParams): Promise<void> {\n  // Must bind to globalThis, mirroring @getmonitor/core's HttpTransport: browsers' native\n  // fetch() throws \"Illegal invocation\" if called with a `this` other than\n  // Window/WorkerGlobalScope. Here fetchImpl is invoked as a plain function call below\n  // (`fetchImpl(url, init)`, never `params.fetchImpl(...)` or `this.fetchImpl(...)`), so this\n  // bind is defensive/consistent rather than load-bearing for this particular call site — but\n  // keeping the same default expression as HttpTransport avoids a divergent default if this\n  // code is ever refactored into a method.\n  const fetchImpl = params.fetchImpl ?? fetch.bind(globalThis)\n\n  const form = new FormData()\n  form.set('release', params.release)\n  form.set('debugId', params.debugId)\n  form.set('filename', params.filename)\n  form.set('sourcemap', new Blob([params.mapContent], { type: 'application/json' }), `${params.filename}.map`)\n\n  const response = await fetchImpl(`${params.apiHost}/api/v1/sourcemaps`, {\n    method: 'POST',\n    headers: { Authorization: `Bearer ${params.authToken}` },\n    body: form,\n  })\n\n  if (!response.ok) {\n    throw new Error(`Source map upload failed for ${params.filename}: ${response.status} ${response.statusText}`)\n  }\n}\n","// packages/cli/src/processSourceMaps.ts\nimport { randomUUID } from 'node:crypto'\nimport { readFileSync, rmSync, writeFileSync } from 'node:fs'\nimport { relative } from 'node:path'\nimport { discoverArtifacts } from './discoverArtifacts'\nimport { injectDebugId, InjectedArtifact } from './injectDebugId'\nimport { resolveRelease } from './resolveRelease'\nimport { uploadSourceMap } from './uploadSourceMap'\nimport { ProcessSourceMapsOptions, ProcessSourceMapsResult } from './types'\n\n/** Finds every JS/map artifact pair under `options.directory`, and for each one: injects a\n * debug ID, uploads the tagged source map, and — only on a successful upload — writes the\n * debug-ID-injected JS back to disk and deletes the `.map` file. An artifact whose upload\n * fails is left completely untouched on disk, so it can be retried by re-running this\n * function against the same directory. */\nexport async function processSourceMaps(options: ProcessSourceMapsOptions): Promise<ProcessSourceMapsResult> {\n  const authToken = options.authToken ?? process.env.GETMONITOR_AUTH_TOKEN\n  if (!authToken) {\n    throw new Error('Missing auth token. Pass --auth-token or set GETMONITOR_AUTH_TOKEN.')\n  }\n\n  const release = resolveRelease(options.directory, options.release)\n  const artifacts = discoverArtifacts(options.directory)\n  const result: ProcessSourceMapsResult = { uploaded: [], failed: [] }\n\n  for (const artifact of artifacts) {\n    const debugId = randomUUID()\n    let injected: InjectedArtifact\n\n    try {\n      const originalJs = readFileSync(artifact.jsPath, 'utf8')\n      const originalMap = readFileSync(artifact.mapPath, 'utf8')\n      // injectDebugId is a pure function that throws on malformed map JSON (by design — see\n      // its own doc comment). That's deliberately caught here, alongside upload failures: one\n      // corrupt/unreadable artifact on disk must not abort processing of every other artifact\n      // in the directory, the same failure-isolation principle discoverArtifacts applies to\n      // unreadable files during its walk. Nothing has been uploaded or written yet at this\n      // point, so a thrown injectDebugId or upload failure leaves the artifact's files\n      // completely untouched, and it's safe to report it as `failed` for a retry.\n      injected = injectDebugId(originalJs, originalMap, debugId)\n\n      await uploadSourceMap({\n        apiHost: options.apiHost,\n        authToken,\n        release,\n        debugId,\n        // Relative to options.directory, not the absolute on-disk path — the backend has no\n        // use for (and shouldn't see) the build machine's local filesystem layout.\n        filename: relative(options.directory, artifact.jsPath),\n        mapContent: injected.map,\n        fetchImpl: options.fetchImpl,\n      })\n    } catch {\n      result.failed.push(artifact.jsPath)\n      continue\n    }\n\n    try {\n      writeFileSync(artifact.jsPath, injected.js)\n      rmSync(artifact.mapPath)\n      result.uploaded.push(artifact.jsPath)\n    } catch (cleanupError) {\n      // The upload above already succeeded, so this must never land in `failed` — a caller\n      // retrying failed artifacts would mint a fresh debugId and re-upload, orphaning this\n      // upload server-side under the old one with no way to reconcile the two. The local\n      // cleanup failure (disk full, permission error, file lock) is real and worth knowing\n      // about, so it's surfaced here rather than silently swallowed, but it doesn't change\n      // the artifact's outcome.\n      result.uploaded.push(artifact.jsPath)\n      console.error(`Uploaded ${artifact.jsPath} but failed to update local files:`, cleanupError)\n    }\n  }\n\n  return result\n}\n"],"names":[],"mappings":"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"}

package/dist/injectDebugId.d.ts

@@ -0,0 +1,16 @@
+export interface InjectedArtifact {
+    js: string;
+    map: string;
+}
+/** Computes the debug-ID-injected JS content and the debug-ID-tagged source map JSON, in
+ * memory — callers decide whether/when to persist the result to disk (processSourceMaps
+ * only writes it after a successful upload, so a failed upload never leaves partially
+ * mutated files behind). The injected JS also has its `//# sourceMappingURL=` comment(s)
+ * removed, since the source map it names is only ever kept in GetMonitor's backend after
+ * a successful upload — never served publicly alongside it.
+ *
+ * `originalMapJson` must be valid JSON — this is a pure function with no fallback to
+ * degrade to (unlike discoverArtifacts, which can skip an unreadable file, this function's
+ * caller expects a definite result), so a malformed map is left to throw via JSON.parse
+ * rather than being swallowed here. */
+export declare function injectDebugId(originalJs: string, originalMapJson: string, debugId: string): InjectedArtifact;

package/dist/processSourceMaps.d.ts

@@ -0,0 +1,7 @@
+import { ProcessSourceMapsOptions, ProcessSourceMapsResult } from './types';
+/** Finds every JS/map artifact pair under `options.directory`, and for each one: injects a
+ * debug ID, uploads the tagged source map, and — only on a successful upload — writes the
+ * debug-ID-injected JS back to disk and deletes the `.map` file. An artifact whose upload
+ * fails is left completely untouched on disk, so it can be retried by re-running this
+ * function against the same directory. */
+export declare function processSourceMaps(options: ProcessSourceMapsOptions): Promise<ProcessSourceMapsResult>;

package/dist/resolveRelease.d.ts

@@ -0,0 +1,6 @@
+/** Resolves the release identifier to tag uploaded source maps with. Precedence: explicit
+ * argument -> GETMONITOR_RELEASE env var -> current git commit SHA (if `directory` is inside
+ * a git working tree) -> `version` field of the nearest package.json walking up from
+ * `directory`. Matches the SDKs' own optional `release` field so events and source maps
+ * for the same deploy carry the same value. */
+export declare function resolveRelease(directory: string, explicit?: string): string;

package/dist/types.d.ts

@@ -0,0 +1,11 @@
+export interface ProcessSourceMapsOptions {
+    directory: string;
+    release?: string;
+    authToken?: string;
+    apiHost: string;
+    fetchImpl?: typeof fetch;
+}
+export interface ProcessSourceMapsResult {
+    uploaded: string[];
+    failed: string[];
+}

package/dist/uploadSourceMap.d.ts

@@ -0,0 +1,14 @@
+export interface UploadSourceMapParams {
+    apiHost: string;
+    authToken: string;
+    release: string;
+    debugId: string;
+    filename: string;
+    mapContent: string;
+    fetchImpl?: typeof fetch;
+}
+/** POSTs a single source map artifact to the (not-yet-implemented) backend contract
+ * documented in docs/superpowers/specs/2026-08-09-phase-2-source-maps-design.md. Throws on
+ * any non-2xx response or network failure — the caller (processSourceMaps) decides what
+ * "failed" means for its own result reporting and disk-write ordering. */
+export declare function uploadSourceMap(params: UploadSourceMapParams): Promise<void>;

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@getmonitor/cli",
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "getmonitor": "dist/bin.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@rollup/plugin-typescript": "^11.1.6",
+    "@types/node": "^20.14.0",
+    "esbuild": "^0.24.0",
+    "rollup": "^4.24.0",
+    "tslib": "^2.6.0",
+    "typescript": "^5.8.2",
+    "vitest": "^2.1.0"
+  },
+  "scripts": {
+    "build": "rollup -c && chmod +x dist/bin.js",
+    "test": "vitest run --exclude 'e2e/**'",
+    "test:e2e": "vitest run e2e/processSourceMaps.spec.ts",
+    "lint": "tsc --noEmit && tsc --noEmit -p e2e"
+  }
+}