@upgoose/vite-plugin 0.1.0

package/README.md

@@ -0,0 +1,102 @@
+# @upgoose/vite-plugin
+
+Upload source maps to [Upgoose](https://upgoose.app) automatically on build, so
+error stack traces are symbolicated back to original file, line, column, and
+function names — no more `index-BaRQ9avt.js:1:48211`.
+
+Ships two ways to upload:
+
+- a **Vite plugin** that runs after `vite build`, and
+- a **CLI** (`upgoose-sourcemaps`) for CI or non-Vite builds.
+
+Zero runtime dependencies (uses Node 18+ `fetch`/`FormData`). Vite is an
+optional peer dependency — the CLI works without it.
+
+## Install
+
+```bash
+npm install -D @upgoose/vite-plugin
+```
+
+## Vite plugin
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { upgooseSourceMaps } from "@upgoose/vite-plugin";
+
+export default defineConfig({
+  // Emit .map files WITHOUT a //# sourceMappingURL comment, so browsers can't
+  // fetch your source but the plugin can still upload the maps.
+  build: { sourcemap: "hidden" },
+  plugins: [
+    upgooseSourceMaps({
+      projectId: process.env.UPGOOSE_PROJECT_ID,
+      apiKey: process.env.UPGOOSE_API_KEY,
+      // release defaults to the short git SHA (see "Matching the release" below)
+    }),
+  ],
+});
+```
+
+On `vite build` the plugin collects every `.map` file from the output
+directory, uploads them in a single request tagged with the release, and (by
+default) deletes them from the build output so they never ship to production.
+
+If `apiKey`/`projectId` aren't set, it logs a warning and skips — it never
+fails your build for missing credentials.
+
+### Options
+
+| Option | Default | Description |
+| --- | --- | --- |
+| `apiKey` | `UPGOOSE_API_KEY` | Project API key (`ug_…`). |
+| `projectId` | `UPGOOSE_PROJECT_ID` | Project ID or public numeric ID. |
+| `release` | `UPGOOSE_RELEASE` → git short SHA | Tag the maps are stored under. Must match `upgoose.init({ release })`. |
+| `apiUrl` | `UPGOOSE_API_URL` → `https://api.upgoose.app` | API base URL. |
+| `outDir` | Vite's `build.outDir` | Directory scanned for `.map` files. |
+| `clean` | `false` | DELETE existing maps for this release before uploading. |
+| `deleteAfterUpload` | `true` | Remove `.map` files from the build output after upload. |
+| `failOnError` | `false` | Throw (fail the build) on upload error instead of warning. |
+| `silent` | `false` | Suppress `[upgoose]` logs. |
+| `disable` | `false` | Skip the upload entirely (e.g. gate on an env flag). |
+
+## CLI
+
+For CI pipelines or bundlers other than Vite:
+
+```bash
+upgoose-sourcemaps \
+  --dir dist \
+  --release "$(git rev-parse --short HEAD)" \
+  --project-id "$UPGOOSE_PROJECT_ID" \
+  --api-key "$UPGOOSE_API_KEY"
+```
+
+Flags fall back to the same env vars as the plugin. Run `upgoose-sourcemaps
+--help` for the full list. Unlike the plugin, the CLI keeps `.map` files on disk
+by default — pass `--delete-after` (or `rm` them yourself before deploying).
+
+## Matching the release
+
+Symbolication looks maps up by `release`, so the value here **must equal** the
+`release` you pass to the browser SDK:
+
+```ts
+// app entry
+import upgoose from "@upgoose/browser";
+upgoose.init({
+  apiKey: "ug_…",
+  apiUrl: "https://api.upgoose.app",
+  release: import.meta.env.VITE_BUILD_SHA, // same SHA the plugin uploads under
+});
+```
+
+The simplest setup: let both default to the git SHA. The plugin uses
+`git rev-parse --short HEAD`; set your app's release from the same value (e.g.
+`VITE_BUILD_SHA=$(git rev-parse --short HEAD)` at build time). If the two
+don't match, the worker won't find the maps and traces stay minified.
+
+## License
+
+BSD-3-Clause

package/dist/chunk-FQ6FRVNL.js

@@ -0,0 +1,103 @@
+// src/upload.ts
+import { execFileSync } from "child_process";
+import { readdir, readFile, unlink } from "fs/promises";
+import { basename, join } from "path";
+var DEFAULT_API_URL = "https://api.upgoose.app";
+function gitShortSha() {
+  try {
+    const sha = execFileSync("git", ["rev-parse", "--short", "HEAD"], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+    return sha || null;
+  } catch {
+    return null;
+  }
+}
+function resolveConfig(input) {
+  const apiKey = input.apiKey ?? process.env.UPGOOSE_API_KEY;
+  const projectId = input.projectId != null ? String(input.projectId) : process.env.UPGOOSE_PROJECT_ID;
+  const apiUrl = (input.apiUrl ?? process.env.UPGOOSE_API_URL ?? DEFAULT_API_URL).replace(/\/+$/, "");
+  const release = input.release ?? process.env.UPGOOSE_RELEASE ?? gitShortSha() ?? void 0;
+  const missing = [];
+  if (!apiKey) missing.push("apiKey (UPGOOSE_API_KEY)");
+  if (!projectId) missing.push("projectId (UPGOOSE_PROJECT_ID)");
+  if (!release) missing.push("release (UPGOOSE_RELEASE, or run inside a git checkout)");
+  if (missing.length > 0) return { missing };
+  return { config: { apiKey, apiUrl, projectId, release }, missing: [] };
+}
+async function findMapFiles(dir) {
+  const out = [];
+  async function walk(d) {
+    let entries;
+    try {
+      entries = await readdir(d, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      const full = join(d, entry.name);
+      if (entry.isDirectory()) await walk(full);
+      else if (entry.isFile() && entry.name.endsWith(".map")) out.push(full);
+    }
+  }
+  await walk(dir);
+  return out;
+}
+async function uploadSourceMaps(config, files, options = {}) {
+  const log = options.log ?? (() => {
+  });
+  if (files.length === 0) {
+    return { uploaded: [], release: config.release, deletedFromDisk: 0 };
+  }
+  const base = `${config.apiUrl}/api/${encodeURIComponent(config.projectId)}/source-maps`;
+  if (options.clean) {
+    const res2 = await fetch(`${base}/${encodeURIComponent(config.release)}`, {
+      method: "DELETE",
+      headers: { "X-API-Key": config.apiKey }
+    });
+    if (res2.ok) {
+      const body2 = await res2.json().catch(() => ({}));
+      log(`cleaned ${body2.deleted ?? 0} existing map(s) for release ${config.release}`);
+    } else {
+      log(`clean skipped \u2014 server returned ${res2.status}`);
+    }
+  }
+  const form = new FormData();
+  form.append("release", config.release);
+  for (const file of files) {
+    const buf = await readFile(file);
+    form.append("file", new Blob([buf]), basename(file));
+  }
+  const res = await fetch(base, {
+    method: "POST",
+    headers: { "X-API-Key": config.apiKey },
+    body: form
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(
+      `source-map upload failed: ${res.status} ${res.statusText}${text ? ` \u2014 ${text}` : ""}`
+    );
+  }
+  const body = await res.json().catch(() => ({}));
+  let deletedFromDisk = 0;
+  if (options.deleteAfterUpload) {
+    for (const file of files) {
+      try {
+        await unlink(file);
+        deletedFromDisk++;
+      } catch {
+      }
+    }
+  }
+  return { uploaded: body.uploaded ?? [], release: config.release, deletedFromDisk };
+}
+
+export {
+  DEFAULT_API_URL,
+  gitShortSha,
+  resolveConfig,
+  findMapFiles,
+  uploadSourceMaps
+};

package/dist/cli.cjs

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+"use strict";
+
+// src/cli.ts
+var import_node_util = require("util");
+var import_node_path2 = require("path");
+
+// src/upload.ts
+var import_node_child_process = require("child_process");
+var import_promises = require("fs/promises");
+var import_node_path = require("path");
+var DEFAULT_API_URL = "https://api.upgoose.app";
+function gitShortSha() {
+  try {
+    const sha = (0, import_node_child_process.execFileSync)("git", ["rev-parse", "--short", "HEAD"], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+    return sha || null;
+  } catch {
+    return null;
+  }
+}
+function resolveConfig(input) {
+  const apiKey = input.apiKey ?? process.env.UPGOOSE_API_KEY;
+  const projectId = input.projectId != null ? String(input.projectId) : process.env.UPGOOSE_PROJECT_ID;
+  const apiUrl = (input.apiUrl ?? process.env.UPGOOSE_API_URL ?? DEFAULT_API_URL).replace(/\/+$/, "");
+  const release = input.release ?? process.env.UPGOOSE_RELEASE ?? gitShortSha() ?? void 0;
+  const missing = [];
+  if (!apiKey) missing.push("apiKey (UPGOOSE_API_KEY)");
+  if (!projectId) missing.push("projectId (UPGOOSE_PROJECT_ID)");
+  if (!release) missing.push("release (UPGOOSE_RELEASE, or run inside a git checkout)");
+  if (missing.length > 0) return { missing };
+  return { config: { apiKey, apiUrl, projectId, release }, missing: [] };
+}
+async function findMapFiles(dir) {
+  const out = [];
+  async function walk(d) {
+    let entries;
+    try {
+      entries = await (0, import_promises.readdir)(d, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      const full = (0, import_node_path.join)(d, entry.name);
+      if (entry.isDirectory()) await walk(full);
+      else if (entry.isFile() && entry.name.endsWith(".map")) out.push(full);
+    }
+  }
+  await walk(dir);
+  return out;
+}
+async function uploadSourceMaps(config, files, options = {}) {
+  const log = options.log ?? (() => {
+  });
+  if (files.length === 0) {
+    return { uploaded: [], release: config.release, deletedFromDisk: 0 };
+  }
+  const base = `${config.apiUrl}/api/${encodeURIComponent(config.projectId)}/source-maps`;
+  if (options.clean) {
+    const res2 = await fetch(`${base}/${encodeURIComponent(config.release)}`, {
+      method: "DELETE",
+      headers: { "X-API-Key": config.apiKey }
+    });
+    if (res2.ok) {
+      const body2 = await res2.json().catch(() => ({}));
+      log(`cleaned ${body2.deleted ?? 0} existing map(s) for release ${config.release}`);
+    } else {
+      log(`clean skipped \u2014 server returned ${res2.status}`);
+    }
+  }
+  const form = new FormData();
+  form.append("release", config.release);
+  for (const file of files) {
+    const buf = await (0, import_promises.readFile)(file);
+    form.append("file", new Blob([buf]), (0, import_node_path.basename)(file));
+  }
+  const res = await fetch(base, {
+    method: "POST",
+    headers: { "X-API-Key": config.apiKey },
+    body: form
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(
+      `source-map upload failed: ${res.status} ${res.statusText}${text ? ` \u2014 ${text}` : ""}`
+    );
+  }
+  const body = await res.json().catch(() => ({}));
+  let deletedFromDisk = 0;
+  if (options.deleteAfterUpload) {
+    for (const file of files) {
+      try {
+        await (0, import_promises.unlink)(file);
+        deletedFromDisk++;
+      } catch {
+      }
+    }
+  }
+  return { uploaded: body.uploaded ?? [], release: config.release, deletedFromDisk };
+}
+
+// src/cli.ts
+var HELP = `upgoose-sourcemaps \u2014 upload source maps to Upgoose
+
+Usage:
+  upgoose-sourcemaps [options]
+
+Options:
+  --dir <path>        Directory to scan for .map files (default: dist)
+  --release <tag>     Release tag; must match upgoose.init({ release })
+                      (default: UPGOOSE_RELEASE or the short git SHA)
+  --project-id <id>   Project ID or public numeric ID (or UPGOOSE_PROJECT_ID)
+  --api-key <key>     Project API key, ug_\u2026 (or UPGOOSE_API_KEY)
+  --api-url <url>     API base URL (or UPGOOSE_API_URL; default api.upgoose.app)
+  --clean             Delete existing maps for this release before uploading
+  --delete-after      Delete .map files from disk after a successful upload
+  --silent            Suppress log output
+  -h, --help          Show this help
+`;
+async function main() {
+  const { values } = (0, import_node_util.parseArgs)({
+    options: {
+      dir: { type: "string" },
+      release: { type: "string" },
+      "project-id": { type: "string" },
+      "api-key": { type: "string" },
+      "api-url": { type: "string" },
+      clean: { type: "boolean" },
+      "delete-after": { type: "boolean" },
+      silent: { type: "boolean" },
+      help: { type: "boolean", short: "h" }
+    }
+  });
+  if (values.help) {
+    process.stdout.write(HELP);
+    return;
+  }
+  const { config, missing } = resolveConfig({
+    apiKey: values["api-key"],
+    apiUrl: values["api-url"],
+    projectId: values["project-id"],
+    release: values.release
+  });
+  if (!config) {
+    console.error(`[upgoose] missing required config: ${missing.join(", ")}`);
+    process.exitCode = 1;
+    return;
+  }
+  const dir = (0, import_node_path2.resolve)(process.cwd(), values.dir ?? "dist");
+  const files = await findMapFiles(dir);
+  if (files.length === 0) {
+    console.error(`[upgoose] no .map files found in ${dir}`);
+    process.exitCode = 1;
+    return;
+  }
+  const log = (msg) => {
+    if (!values.silent) console.log(`[upgoose] ${msg}`);
+  };
+  log(`uploading ${files.length} source map(s) for release "${config.release}"\u2026`);
+  try {
+    const result = await uploadSourceMaps(config, files, {
+      clean: values.clean,
+      // CLI keeps maps by default (it's often run as a discrete step); pass
+      // --delete-after to remove them, or rm them yourself before deploy.
+      deleteAfterUpload: values["delete-after"] ?? false,
+      log
+    });
+    log(
+      `done \u2014 uploaded ${result.uploaded.length} map(s)` + (result.deletedFromDisk ? `, removed ${result.deletedFromDisk} from disk` : "")
+    );
+  } catch (err) {
+    console.error(`[upgoose] ${err instanceof Error ? err.message : String(err)}`);
+    process.exitCode = 1;
+  }
+}
+main().catch((err) => {
+  console.error(`[upgoose] ${err instanceof Error ? err.message : String(err)}`);
+  process.exitCode = 1;
+});

package/dist/cli.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+import {
+  findMapFiles,
+  resolveConfig,
+  uploadSourceMaps
+} from "./chunk-FQ6FRVNL.js";
+
+// src/cli.ts
+import { parseArgs } from "util";
+import { resolve } from "path";
+var HELP = `upgoose-sourcemaps \u2014 upload source maps to Upgoose
+
+Usage:
+  upgoose-sourcemaps [options]
+
+Options:
+  --dir <path>        Directory to scan for .map files (default: dist)
+  --release <tag>     Release tag; must match upgoose.init({ release })
+                      (default: UPGOOSE_RELEASE or the short git SHA)
+  --project-id <id>   Project ID or public numeric ID (or UPGOOSE_PROJECT_ID)
+  --api-key <key>     Project API key, ug_\u2026 (or UPGOOSE_API_KEY)
+  --api-url <url>     API base URL (or UPGOOSE_API_URL; default api.upgoose.app)
+  --clean             Delete existing maps for this release before uploading
+  --delete-after      Delete .map files from disk after a successful upload
+  --silent            Suppress log output
+  -h, --help          Show this help
+`;
+async function main() {
+  const { values } = parseArgs({
+    options: {
+      dir: { type: "string" },
+      release: { type: "string" },
+      "project-id": { type: "string" },
+      "api-key": { type: "string" },
+      "api-url": { type: "string" },
+      clean: { type: "boolean" },
+      "delete-after": { type: "boolean" },
+      silent: { type: "boolean" },
+      help: { type: "boolean", short: "h" }
+    }
+  });
+  if (values.help) {
+    process.stdout.write(HELP);
+    return;
+  }
+  const { config, missing } = resolveConfig({
+    apiKey: values["api-key"],
+    apiUrl: values["api-url"],
+    projectId: values["project-id"],
+    release: values.release
+  });
+  if (!config) {
+    console.error(`[upgoose] missing required config: ${missing.join(", ")}`);
+    process.exitCode = 1;
+    return;
+  }
+  const dir = resolve(process.cwd(), values.dir ?? "dist");
+  const files = await findMapFiles(dir);
+  if (files.length === 0) {
+    console.error(`[upgoose] no .map files found in ${dir}`);
+    process.exitCode = 1;
+    return;
+  }
+  const log = (msg) => {
+    if (!values.silent) console.log(`[upgoose] ${msg}`);
+  };
+  log(`uploading ${files.length} source map(s) for release "${config.release}"\u2026`);
+  try {
+    const result = await uploadSourceMaps(config, files, {
+      clean: values.clean,
+      // CLI keeps maps by default (it's often run as a discrete step); pass
+      // --delete-after to remove them, or rm them yourself before deploy.
+      deleteAfterUpload: values["delete-after"] ?? false,
+      log
+    });
+    log(
+      `done \u2014 uploaded ${result.uploaded.length} map(s)` + (result.deletedFromDisk ? `, removed ${result.deletedFromDisk} from disk` : "")
+    );
+  } catch (err) {
+    console.error(`[upgoose] ${err instanceof Error ? err.message : String(err)}`);
+    process.exitCode = 1;
+  }
+}
+main().catch((err) => {
+  console.error(`[upgoose] ${err instanceof Error ? err.message : String(err)}`);
+  process.exitCode = 1;
+});

package/dist/index.cjs

@@ -0,0 +1,193 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  DEFAULT_API_URL: () => DEFAULT_API_URL,
+  default: () => src_default,
+  findMapFiles: () => findMapFiles,
+  gitShortSha: () => gitShortSha,
+  resolveConfig: () => resolveConfig,
+  upgooseSourceMaps: () => upgooseSourceMaps,
+  uploadSourceMaps: () => uploadSourceMaps
+});
+module.exports = __toCommonJS(src_exports);
+var import_node_path2 = require("path");
+
+// src/upload.ts
+var import_node_child_process = require("child_process");
+var import_promises = require("fs/promises");
+var import_node_path = require("path");
+var DEFAULT_API_URL = "https://api.upgoose.app";
+function gitShortSha() {
+  try {
+    const sha = (0, import_node_child_process.execFileSync)("git", ["rev-parse", "--short", "HEAD"], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+    return sha || null;
+  } catch {
+    return null;
+  }
+}
+function resolveConfig(input) {
+  const apiKey = input.apiKey ?? process.env.UPGOOSE_API_KEY;
+  const projectId = input.projectId != null ? String(input.projectId) : process.env.UPGOOSE_PROJECT_ID;
+  const apiUrl = (input.apiUrl ?? process.env.UPGOOSE_API_URL ?? DEFAULT_API_URL).replace(/\/+$/, "");
+  const release = input.release ?? process.env.UPGOOSE_RELEASE ?? gitShortSha() ?? void 0;
+  const missing = [];
+  if (!apiKey) missing.push("apiKey (UPGOOSE_API_KEY)");
+  if (!projectId) missing.push("projectId (UPGOOSE_PROJECT_ID)");
+  if (!release) missing.push("release (UPGOOSE_RELEASE, or run inside a git checkout)");
+  if (missing.length > 0) return { missing };
+  return { config: { apiKey, apiUrl, projectId, release }, missing: [] };
+}
+async function findMapFiles(dir) {
+  const out = [];
+  async function walk(d) {
+    let entries;
+    try {
+      entries = await (0, import_promises.readdir)(d, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      const full = (0, import_node_path.join)(d, entry.name);
+      if (entry.isDirectory()) await walk(full);
+      else if (entry.isFile() && entry.name.endsWith(".map")) out.push(full);
+    }
+  }
+  await walk(dir);
+  return out;
+}
+async function uploadSourceMaps(config, files, options = {}) {
+  const log = options.log ?? (() => {
+  });
+  if (files.length === 0) {
+    return { uploaded: [], release: config.release, deletedFromDisk: 0 };
+  }
+  const base = `${config.apiUrl}/api/${encodeURIComponent(config.projectId)}/source-maps`;
+  if (options.clean) {
+    const res2 = await fetch(`${base}/${encodeURIComponent(config.release)}`, {
+      method: "DELETE",
+      headers: { "X-API-Key": config.apiKey }
+    });
+    if (res2.ok) {
+      const body2 = await res2.json().catch(() => ({}));
+      log(`cleaned ${body2.deleted ?? 0} existing map(s) for release ${config.release}`);
+    } else {
+      log(`clean skipped \u2014 server returned ${res2.status}`);
+    }
+  }
+  const form = new FormData();
+  form.append("release", config.release);
+  for (const file of files) {
+    const buf = await (0, import_promises.readFile)(file);
+    form.append("file", new Blob([buf]), (0, import_node_path.basename)(file));
+  }
+  const res = await fetch(base, {
+    method: "POST",
+    headers: { "X-API-Key": config.apiKey },
+    body: form
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(
+      `source-map upload failed: ${res.status} ${res.statusText}${text ? ` \u2014 ${text}` : ""}`
+    );
+  }
+  const body = await res.json().catch(() => ({}));
+  let deletedFromDisk = 0;
+  if (options.deleteAfterUpload) {
+    for (const file of files) {
+      try {
+        await (0, import_promises.unlink)(file);
+        deletedFromDisk++;
+      } catch {
+      }
+    }
+  }
+  return { uploaded: body.uploaded ?? [], release: config.release, deletedFromDisk };
+}
+
+// src/index.ts
+function upgooseSourceMaps(options = {}) {
+  let absOutDir = "";
+  let sourcemapEnabled;
+  const log = (msg) => {
+    if (!options.silent) console.log(`[upgoose] ${msg}`);
+  };
+  const warn = (msg) => {
+    if (!options.silent) console.warn(`[upgoose] ${msg}`);
+  };
+  return {
+    name: "upgoose-source-maps",
+    apply: "build",
+    enforce: "post",
+    configResolved(config) {
+      absOutDir = (0, import_node_path2.resolve)(config.root, options.outDir ?? config.build.outDir);
+      sourcemapEnabled = config.build.sourcemap;
+    },
+    async closeBundle() {
+      if (options.disable) return;
+      const { config, missing } = resolveConfig(options);
+      if (!config) {
+        warn(`source-map upload skipped \u2014 missing ${missing.join(", ")}.`);
+        return;
+      }
+      if (!sourcemapEnabled) {
+        warn(
+          `build.sourcemap is disabled \u2014 nothing to upload. Set build.sourcemap: "hidden" so .map files are emitted without exposing your source.`
+        );
+        return;
+      }
+      const files = await findMapFiles(absOutDir);
+      if (files.length === 0) {
+        warn(`no .map files found in ${absOutDir}.`);
+        return;
+      }
+      log(`uploading ${files.length} source map(s) for release "${config.release}"\u2026`);
+      try {
+        const result = await uploadSourceMaps(config, files, {
+          clean: options.clean,
+          deleteAfterUpload: options.deleteAfterUpload ?? true,
+          log
+        });
+        log(
+          `uploaded ${result.uploaded.length} map(s)` + (result.deletedFromDisk ? `, removed ${result.deletedFromDisk} from the build output` : "")
+        );
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (options.failOnError) throw err;
+        warn(message);
+      }
+    }
+  };
+}
+var src_default = upgooseSourceMaps;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_API_URL,
+  findMapFiles,
+  gitShortSha,
+  resolveConfig,
+  upgooseSourceMaps,
+  uploadSourceMaps
+});

package/dist/index.d.cts

@@ -0,0 +1,74 @@
+import { Plugin } from 'vite';
+
+declare const DEFAULT_API_URL = "https://api.upgoose.app";
+interface ResolveInput {
+    apiKey?: string;
+    apiUrl?: string;
+    projectId?: string | number;
+    release?: string;
+}
+interface ResolvedConfig {
+    apiKey: string;
+    apiUrl: string;
+    projectId: string;
+    release: string;
+}
+/** Best-effort `git rev-parse --short HEAD`; null outside a git checkout. */
+declare function gitShortSha(): string | null;
+/**
+ * Merge explicit options with env vars and a git-SHA fallback. Returns either
+ * a fully-resolved config or the list of human-readable missing fields, so the
+ * caller can warn-and-skip (plugin) or hard-fail (CLI) as it sees fit.
+ */
+declare function resolveConfig(input: ResolveInput): {
+    config?: ResolvedConfig;
+    missing: string[];
+};
+/** Recursively collect absolute paths of every `.map` file under `dir`. */
+declare function findMapFiles(dir: string): Promise<string[]>;
+interface UploadOptions {
+    /** DELETE existing maps for this release before uploading (re-deploy/amend). */
+    clean?: boolean;
+    /** Remove each `.map` from disk after a successful upload so it never ships. */
+    deleteAfterUpload?: boolean;
+    log?: (msg: string) => void;
+}
+interface UploadResult {
+    uploaded: string[];
+    release: string;
+    deletedFromDisk: number;
+}
+/** Upload every map in `files` in a single multipart request. */
+declare function uploadSourceMaps(config: ResolvedConfig, files: string[], options?: UploadOptions): Promise<UploadResult>;
+
+interface UpgooseSourceMapsOptions {
+    /** Project API key (`ug_…`). Falls back to `UPGOOSE_API_KEY`. */
+    apiKey?: string;
+    /** Project ID or public numeric ID. Falls back to `UPGOOSE_PROJECT_ID`. */
+    projectId?: string | number;
+    /**
+     * Release tag the maps are stored under. MUST match `upgoose.init({ release })`.
+     * Falls back to `UPGOOSE_RELEASE`, then the short git SHA.
+     */
+    release?: string;
+    /** API base URL. Falls back to `UPGOOSE_API_URL`, then https://api.upgoose.app. */
+    apiUrl?: string;
+    /** Directory to scan for `.map` files. Defaults to Vite's resolved `build.outDir`. */
+    outDir?: string;
+    /** DELETE existing maps for this release before uploading. Default: false. */
+    clean?: boolean;
+    /**
+     * Delete each `.map` from disk after a successful upload so it never ships
+     * to production. Default: true — set false to keep maps in the output dir.
+     */
+    deleteAfterUpload?: boolean;
+    /** Throw (failing the build) if the upload errors. Default: false (warn only). */
+    failOnError?: boolean;
+    /** Suppress all `[upgoose]` log output. Default: false. */
+    silent?: boolean;
+    /** Skip the upload entirely — handy for gating on an env flag. Default: false. */
+    disable?: boolean;
+}
+declare function upgooseSourceMaps(options?: UpgooseSourceMapsOptions): Plugin;
+
+export { DEFAULT_API_URL, type ResolveInput, type ResolvedConfig, type UpgooseSourceMapsOptions, type UploadOptions, type UploadResult, upgooseSourceMaps as default, findMapFiles, gitShortSha, resolveConfig, upgooseSourceMaps, uploadSourceMaps };

package/dist/index.d.ts

@@ -0,0 +1,74 @@
+import { Plugin } from 'vite';
+
+declare const DEFAULT_API_URL = "https://api.upgoose.app";
+interface ResolveInput {
+    apiKey?: string;
+    apiUrl?: string;
+    projectId?: string | number;
+    release?: string;
+}
+interface ResolvedConfig {
+    apiKey: string;
+    apiUrl: string;
+    projectId: string;
+    release: string;
+}
+/** Best-effort `git rev-parse --short HEAD`; null outside a git checkout. */
+declare function gitShortSha(): string | null;
+/**
+ * Merge explicit options with env vars and a git-SHA fallback. Returns either
+ * a fully-resolved config or the list of human-readable missing fields, so the
+ * caller can warn-and-skip (plugin) or hard-fail (CLI) as it sees fit.
+ */
+declare function resolveConfig(input: ResolveInput): {
+    config?: ResolvedConfig;
+    missing: string[];
+};
+/** Recursively collect absolute paths of every `.map` file under `dir`. */
+declare function findMapFiles(dir: string): Promise<string[]>;
+interface UploadOptions {
+    /** DELETE existing maps for this release before uploading (re-deploy/amend). */
+    clean?: boolean;
+    /** Remove each `.map` from disk after a successful upload so it never ships. */
+    deleteAfterUpload?: boolean;
+    log?: (msg: string) => void;
+}
+interface UploadResult {
+    uploaded: string[];
+    release: string;
+    deletedFromDisk: number;
+}
+/** Upload every map in `files` in a single multipart request. */
+declare function uploadSourceMaps(config: ResolvedConfig, files: string[], options?: UploadOptions): Promise<UploadResult>;
+
+interface UpgooseSourceMapsOptions {
+    /** Project API key (`ug_…`). Falls back to `UPGOOSE_API_KEY`. */
+    apiKey?: string;
+    /** Project ID or public numeric ID. Falls back to `UPGOOSE_PROJECT_ID`. */
+    projectId?: string | number;
+    /**
+     * Release tag the maps are stored under. MUST match `upgoose.init({ release })`.
+     * Falls back to `UPGOOSE_RELEASE`, then the short git SHA.
+     */
+    release?: string;
+    /** API base URL. Falls back to `UPGOOSE_API_URL`, then https://api.upgoose.app. */
+    apiUrl?: string;
+    /** Directory to scan for `.map` files. Defaults to Vite's resolved `build.outDir`. */
+    outDir?: string;
+    /** DELETE existing maps for this release before uploading. Default: false. */
+    clean?: boolean;
+    /**
+     * Delete each `.map` from disk after a successful upload so it never ships
+     * to production. Default: true — set false to keep maps in the output dir.
+     */
+    deleteAfterUpload?: boolean;
+    /** Throw (failing the build) if the upload errors. Default: false (warn only). */
+    failOnError?: boolean;
+    /** Suppress all `[upgoose]` log output. Default: false. */
+    silent?: boolean;
+    /** Skip the upload entirely — handy for gating on an env flag. Default: false. */
+    disable?: boolean;
+}
+declare function upgooseSourceMaps(options?: UpgooseSourceMapsOptions): Plugin;
+
+export { DEFAULT_API_URL, type ResolveInput, type ResolvedConfig, type UpgooseSourceMapsOptions, type UploadOptions, type UploadResult, upgooseSourceMaps as default, findMapFiles, gitShortSha, resolveConfig, upgooseSourceMaps, uploadSourceMaps };

package/dist/index.js

@@ -0,0 +1,73 @@
+import {
+  DEFAULT_API_URL,
+  findMapFiles,
+  gitShortSha,
+  resolveConfig,
+  uploadSourceMaps
+} from "./chunk-FQ6FRVNL.js";
+
+// src/index.ts
+import { resolve } from "path";
+function upgooseSourceMaps(options = {}) {
+  let absOutDir = "";
+  let sourcemapEnabled;
+  const log = (msg) => {
+    if (!options.silent) console.log(`[upgoose] ${msg}`);
+  };
+  const warn = (msg) => {
+    if (!options.silent) console.warn(`[upgoose] ${msg}`);
+  };
+  return {
+    name: "upgoose-source-maps",
+    apply: "build",
+    enforce: "post",
+    configResolved(config) {
+      absOutDir = resolve(config.root, options.outDir ?? config.build.outDir);
+      sourcemapEnabled = config.build.sourcemap;
+    },
+    async closeBundle() {
+      if (options.disable) return;
+      const { config, missing } = resolveConfig(options);
+      if (!config) {
+        warn(`source-map upload skipped \u2014 missing ${missing.join(", ")}.`);
+        return;
+      }
+      if (!sourcemapEnabled) {
+        warn(
+          `build.sourcemap is disabled \u2014 nothing to upload. Set build.sourcemap: "hidden" so .map files are emitted without exposing your source.`
+        );
+        return;
+      }
+      const files = await findMapFiles(absOutDir);
+      if (files.length === 0) {
+        warn(`no .map files found in ${absOutDir}.`);
+        return;
+      }
+      log(`uploading ${files.length} source map(s) for release "${config.release}"\u2026`);
+      try {
+        const result = await uploadSourceMaps(config, files, {
+          clean: options.clean,
+          deleteAfterUpload: options.deleteAfterUpload ?? true,
+          log
+        });
+        log(
+          `uploaded ${result.uploaded.length} map(s)` + (result.deletedFromDisk ? `, removed ${result.deletedFromDisk} from the build output` : "")
+        );
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (options.failOnError) throw err;
+        warn(message);
+      }
+    }
+  };
+}
+var src_default = upgooseSourceMaps;
+export {
+  DEFAULT_API_URL,
+  src_default as default,
+  findMapFiles,
+  gitShortSha,
+  resolveConfig,
+  upgooseSourceMaps,
+  uploadSourceMaps
+};

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@upgoose/vite-plugin",
+  "version": "0.1.0",
+  "description": "Upload source maps to Upgoose on build so error stack traces are symbolicated (Vite plugin + CLI)",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "bin": {
+    "upgoose-sourcemaps": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "vite": ">=4"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.2",
+    "vite": "^6.0.6",
+    "vitest": "^4.1.4"
+  },
+  "keywords": [
+    "error-tracking",
+    "source-maps",
+    "sourcemap",
+    "symbolication",
+    "vite-plugin",
+    "upgoose"
+  ],
+  "license": "BSD-3-Clause",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/randell/upgoose.git",
+    "directory": "packages/vite-plugin"
+  },
+  "homepage": "https://upgoose.app/docs#source-maps",
+  "bugs": "https://github.com/randell/upgoose/issues",
+  "sideEffects": false
+}