@guidelytech/sourcemaps 0.0.0-stage → 0.4.1

package/README.md

@@ -1,3 +1,85 @@
-# Temporary Holding Version
+# @guidelytech/sourcemaps
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Uploads your build's JavaScript source maps to Guidely so exceptions on the Errors page show your
+original files, functions and lines instead of minified code. Zero runtime dependencies; Node ≥ 18.
+
+```sh
+npx @guidelytech/sourcemaps upload --dir dist --release "$GIT_SHA" --delete-after
+```
+
+1. Create a secret API key with the **sourcemaps:write** scope in Guidely (Settings → API keys) and
+   store it as a CI secret `GUIDELY_SOURCEMAP_KEY`. Never ship it to the browser.
+2. Build with source maps enabled.
+3. Upload them with the same **release** the SDK reports, then deploy (without the `.map` files).
+4. Set the same value as the SDK's `release` option: `createGuidely({ …, release })`,
+   `NEXT_PUBLIC_GUIDELY_RELEASE`, `VITE_GUIDELY_RELEASE` / `PUBLIC_GUIDELY_RELEASE`, or
+   `<script data-release="…">` for the script tag. Exceptions are matched to maps by release + script URL path.
+
+## Commands
+
+```
+guidely-sourcemaps upload --dir <dir> [--url-prefix /] [--release <r>] [--api-url <url>] [--key <key>]
+                          [--include .js.map] [--delete-after] [--dry-run]
+guidely-sourcemaps verify [--key <key>] [--api-url <url>]
+```
+
+| Option | Env | Default | |
+|---|---|---|---|
+| `--dir` | — | (required) | Build output searched recursively for `*.js.map` files whose minified file (same name without `.map`) sits next to them. |
+| `--url-prefix` | — | `/` | URL path the directory is served under. The minified file's URL path is `url-prefix` + its path relative to `--dir`. |
+| `--release` | `GUIDELY_RELEASE` | — | App version / commit SHA (≤ 100 chars). |
+| `--api-url` | `GUIDELY_API_URL` | `https://api.guidely.app` | Your Guidely API. |
+| `--key` | `GUIDELY_SOURCEMAP_KEY` | — | Secret key with `sourcemaps:write`. Never printed. |
+| `--include` | — | `.js.map` | File-name suffix of the maps to upload. |
+| `--delete-after` | — | off | Delete each local `.map` once it uploaded successfully (otherwise deploying the build publishes your original source). |
+| `--dry-run` | — | off | List what would be uploaded; no key needed. |
+
+Maps must be JSON with `version: 3` (others are skipped with a warning) and ≤ 25 MB. Uploads are
+batched (≤ 50 files / 40 MB per request) and retried 3× on network errors, 5xx and 429. The command
+prints one line per map and a summary, and exits with code 1 if any map failed, the key was rejected
+(401/403: invalid or revoked key, or missing `sourcemaps:write` scope) or no maps were found.
+
+`verify` calls `GET /api/v1/sourcemaps/whoami` and prints the project and key prefix.
+
+## Frameworks
+
+| Build | Enable maps | Upload |
+|---|---|---|
+| Vite (React, Vue, SvelteKit client) | `build: { sourcemap: true }` (`"hidden"` keeps the `//# sourceMappingURL` comment out of the files) | `--dir dist --url-prefix /` (SvelteKit: `--dir .svelte-kit/output/client --url-prefix /`) |
+| Next.js | `productionBrowserSourceMaps: true` in `next.config.js` | `--dir .next/static --url-prefix /_next/static/` |
+| Served from a CDN path | — | `--url-prefix /assets/` (or the full URL, e.g. `https://cdn.example.com/app/`, matching the script URLs in stack traces) |
+
+## GitHub Actions
+
+```yaml
+- run: pnpm build
+  env:
+    VITE_GUIDELY_RELEASE: ${{ github.sha }}   # same release the SDK reports
+- run: npx @guidelytech/sourcemaps upload --dir dist --release ${{ github.sha }} --delete-after
+  env:
+    GUIDELY_SOURCEMAP_KEY: ${{ secrets.GUIDELY_SOURCEMAP_KEY }}
+    GUIDELY_API_URL: https://guidely.example.com
+- run: ./deploy.sh   # deploys dist without the .map files
+```
+
+Next.js:
+
+```yaml
+- run: pnpm next build
+  env:
+    NEXT_PUBLIC_GUIDELY_RELEASE: ${{ github.sha }}
+- run: npx @guidelytech/sourcemaps upload --dir .next/static --url-prefix /_next/static/ --release ${{ github.sha }} --delete-after
+  env:
+    GUIDELY_SOURCEMAP_KEY: ${{ secrets.GUIDELY_SOURCEMAP_KEY }}
+```
+
+## Programmatic use
+
+```ts
+import { uploadSourceMaps } from "@guidelytech/sourcemaps";
+
+const result = await uploadSourceMaps({ dir: "dist", urlPrefix: "/", release: process.env.GIT_SHA, key: process.env.GUIDELY_SOURCEMAP_KEY, deleteAfter: true });
+// { release, files, uploaded: [{ path, sizeBytes, sources, hasContent, replaced }], errors: [{ path, message }], skipped, deleted, dryRun }
+```
+
+Also exported: `findSourceMaps`, `urlPathFor`, `batchFiles`, `verifyKey`, `runCli`, `GuidelyAuthError`.

package/dist/cli.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { runCli } from "./index.js";
+runCli(process.argv.slice(2)).then(
+  (code) => {
+    process.exitCode = code;
+  },
+  (err) => {
+    console.error(`error: ${err instanceof Error ? err.message : String(err)}`);
+    process.exitCode = 1;
+  }
+);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["import { runCli } from \"./index.js\";\n\nrunCli(process.argv.slice(2)).then(\n  (code) => {\n    process.exitCode = code;\n  },\n  (err: unknown) => {\n    console.error(`error: ${err instanceof Error ? err.message : String(err)}`);\n    process.exitCode = 1;\n  },\n);\n"],"mappings":";;;AAAA,SAAS,cAAc;AAEvB,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC,EAAE;AAAA,EAC5B,CAAC,SAAS;AACR,YAAQ,WAAW;AAAA,EACrB;AAAA,EACA,CAAC,QAAiB;AAChB,YAAQ,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC,EAAE;AAC1E,YAAQ,WAAW;AAAA,EACrB;AACF;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,120 @@
+/** Default Guidely API base URL (same as the browser SDK). Its own module so `run.ts` can import it without an import cycle. */
+declare const DEFAULT_API_URL = "https://api.guidely.app";
+
+/** Where the CLI writes and what it reads (injectable for tests). */
+interface CliIO {
+    env?: Record<string, string | undefined>;
+    out?: (line: string) => void;
+    err?: (line: string) => void;
+    fetch?: typeof fetch;
+    retryDelayMs?: number;
+}
+/** Runs the CLI; resolves with the process exit code. Never prints the API key. */
+declare function runCli(argv: string[], io?: CliIO): Promise<number>;
+
+/** Per-request limits and the per-file cap enforced by the upload API. */
+declare const MAX_FILES_PER_REQUEST = 50;
+declare const MAX_BYTES_PER_REQUEST: number;
+declare const MAX_FILE_BYTES: number;
+interface Logger {
+    info(message: string): void;
+    warn(message: string): void;
+}
+/** A source map found on disk next to its minified file. */
+interface SourceMapFile {
+    /** Absolute path of the `.map` file. */
+    mapPath: string;
+    /** Absolute path of the minified file the map belongs to. */
+    filePath: string;
+    /** URL path the minified file is served at (`urlPrefix` + posix relative path). */
+    urlPath: string;
+    sizeBytes: number;
+}
+interface SkippedFile {
+    path: string;
+    reason: string;
+}
+/** One map stored by the server. */
+interface UploadedMap {
+    path: string;
+    sizeBytes: number;
+    sources: number;
+    hasContent: boolean;
+    replaced: boolean;
+}
+interface UploadOptions {
+    /** Build output directory searched recursively (e.g. `dist`, `.next/static`). */
+    dir: string;
+    /** URL path the directory is served under (default `/`; `/_next/static/` for Next.js). */
+    urlPrefix?: string;
+    /** App version / commit SHA; must equal the SDK's `release` option. */
+    release?: string;
+    /** Guidely API base URL (default `https://api.guidely.app`). */
+    apiUrl?: string;
+    /** Secret project API key with the `sourcemaps:write` scope. */
+    key?: string;
+    /** File-name suffix of the maps to upload (default `.js.map`). */
+    include?: string;
+    /** Delete local `.map` files that were uploaded successfully. */
+    deleteAfter?: boolean;
+    /** Only list what would be uploaded. */
+    dryRun?: boolean;
+    logger?: Logger;
+    fetch?: typeof fetch;
+    /** Retries for network errors, 5xx and 429 (default 3). */
+    retries?: number;
+    /** Base backoff delay (default 1000ms, doubled per attempt). */
+    retryDelayMs?: number;
+    maxFilesPerRequest?: number;
+    maxBytesPerRequest?: number;
+    maxFileBytes?: number;
+}
+interface UploadResult {
+    release: string | null;
+    /** Maps found (and, unless skipped, uploaded or listed in a dry run). */
+    files: SourceMapFile[];
+    uploaded: UploadedMap[];
+    errors: Array<{
+        path: string;
+        message: string;
+    }>;
+    skipped: SkippedFile[];
+    /** Local `.map` files deleted with `deleteAfter`. */
+    deleted: string[];
+    dryRun: boolean;
+}
+/** Invalid or revoked key, or a key without the `sourcemaps:write` scope. */
+declare class GuidelyAuthError extends Error {
+    constructor(status: number);
+}
+/** URL path of a built file: `prefix` (default `/`) + its posix path relative to the build directory. */
+declare function urlPathFor(urlPrefix: string | undefined, relPath: string): string;
+/** Recursively finds `*<include>` maps whose minified sibling (same name without `.map`) exists. */
+declare function findSourceMaps(dir: string, options?: {
+    urlPrefix?: string;
+    include?: string;
+    logger?: Logger;
+}): {
+    files: SourceMapFile[];
+    skipped: SkippedFile[];
+};
+/** Groups files into requests of at most `maxFiles` files and `maxBytes` bytes (a larger single file gets its own request). */
+declare function batchFiles<T extends {
+    sizeBytes: number;
+}>(files: T[], maxFiles?: number, maxBytes?: number): T[][];
+/** Returns why a map file cannot be uploaded, or null when it is a valid v3 source map. */
+declare function invalidMapReason(content: string): string | null;
+/** Finds the maps under `dir` and uploads them in batches. Throws {@link GuidelyAuthError} for a rejected key. */
+declare function uploadSourceMaps(options: UploadOptions): Promise<UploadResult>;
+/** What `GET /api/v1/sourcemaps/whoami` reports about a key (fields are read leniently). */
+interface WhoAmI {
+    projectName: string | null;
+    projectId: string | null;
+    keyName: string | null;
+    keyPrefix: string | null;
+    scopes: string[];
+}
+/** Checks a key against the API (`guidely-sourcemaps verify`). */
+declare function verifyKey(options: Pick<UploadOptions, "apiUrl" | "key" | "fetch" | "retries" | "retryDelayMs">): Promise<WhoAmI>;
+
+export { type CliIO, DEFAULT_API_URL, GuidelyAuthError, type Logger, MAX_BYTES_PER_REQUEST, MAX_FILES_PER_REQUEST, MAX_FILE_BYTES, type SkippedFile, type SourceMapFile, type UploadOptions, type UploadResult, type UploadedMap, type WhoAmI, batchFiles, findSourceMaps, invalidMapReason, runCli, uploadSourceMaps, urlPathFor, verifyKey };

package/dist/index.js

@@ -0,0 +1,312 @@
+// src/index.ts
+import { readdirSync, readFileSync, statSync, unlinkSync, existsSync } from "fs";
+import { basename, join, relative, sep } from "path";
+
+// src/constants.ts
+var DEFAULT_API_URL = "https://api.guidely.app";
+
+// src/run.ts
+var HELP = `Usage:
+  guidely-sourcemaps upload --dir <dir> [options]   Upload source maps from a build directory
+  guidely-sourcemaps verify [--key <key>]           Check the API key
+
+Options:
+  --dir <dir>          Build output directory, searched recursively (e.g. dist, .next/static)
+  --url-prefix <path>  URL path the directory is served under (default "/"; "/_next/static/" for Next.js)
+  --release <release>  App version or commit SHA; set the same value as the SDK's \`release\` (env GUIDELY_RELEASE)
+  --api-url <url>      Guidely API URL (env GUIDELY_API_URL, default ${DEFAULT_API_URL})
+  --key <key>          Secret API key with the sourcemaps:write scope (env GUIDELY_SOURCEMAP_KEY)
+  --include <suffix>   File-name suffix of the maps to upload (default .js.map)
+  --delete-after       Delete local .map files once uploaded (so they are not deployed publicly)
+  --dry-run            List what would be uploaded without uploading
+  -h, --help           Show this help`;
+var BOOLEAN = /* @__PURE__ */ new Set(["delete-after", "dry-run", "help"]);
+function parseArgs(argv) {
+  const flags = {};
+  let command;
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "-h") flags.help = true;
+    else if (arg.startsWith("--")) {
+      const [name, inline] = arg.slice(2).split(/=(.*)/s, 2);
+      if (BOOLEAN.has(name)) flags[name] = inline === void 0 ? true : inline !== "false";
+      else if (inline !== void 0) flags[name] = inline;
+      else {
+        const next = argv[i + 1];
+        if (next === void 0 || next.startsWith("--")) throw new Error(`--${name} needs a value`);
+        flags[name] = next;
+        i++;
+      }
+    } else if (!command) command = arg;
+    else throw new Error(`unexpected argument: ${arg}`);
+  }
+  return { command, flags };
+}
+var kb = (n) => `${Math.max(1, Math.round(n / 1024))} KB`;
+async function runCli(argv, io = {}) {
+  const env = io.env ?? process.env;
+  const out = io.out ?? ((l) => console.log(l));
+  const err = io.err ?? ((l) => console.error(l));
+  const logger = { info: out, warn: (m) => err(`warning: ${m}`) };
+  let parsed;
+  try {
+    parsed = parseArgs(argv);
+  } catch (e) {
+    err(`error: ${e.message}
+
+${HELP}`);
+    return 1;
+  }
+  const { command, flags } = parsed;
+  if (flags.help || !command) {
+    (command || flags.help ? out : err)(HELP);
+    return flags.help ? 0 : 1;
+  }
+  const str = (name) => typeof flags[name] === "string" ? flags[name] : void 0;
+  const apiUrl = str("api-url") || env.GUIDELY_API_URL || DEFAULT_API_URL;
+  const key = str("key") || env.GUIDELY_SOURCEMAP_KEY;
+  try {
+    if (command === "verify") {
+      const who = await verifyKey({ apiUrl, key, fetch: io.fetch, retryDelayMs: io.retryDelayMs });
+      out(`Key OK for project ${who.projectName ?? who.projectId ?? "(unknown)"}${who.keyPrefix ? ` (key gly_sk_${who.keyPrefix}\u2026)` : ""}${who.scopes.length ? `, scopes: ${who.scopes.join(", ")}` : ""}`);
+      return 0;
+    }
+    if (command !== "upload") {
+      err(`error: unknown command "${command}"
+
+${HELP}`);
+      return 1;
+    }
+    const dryRun = flags["dry-run"] === true;
+    const release = str("release") || env.GUIDELY_RELEASE || void 0;
+    const result = await uploadSourceMaps({ dir: str("dir") ?? "", urlPrefix: str("url-prefix"), release, apiUrl, key, include: str("include"), deleteAfter: flags["delete-after"] === true, dryRun, fetch: io.fetch, retryDelayMs: io.retryDelayMs, logger });
+    const total = result.files.length;
+    if (!total) {
+      err(`error: no source maps to upload in ${str("dir")} (looked for *${str("include") || ".js.map"} files next to their minified file)`);
+      return 1;
+    }
+    if (dryRun) {
+      out(`Dry run: ${total} source map${total === 1 ? "" : "s"} would be uploaded${release ? ` for release ${release}` : ""} to ${apiUrl}.`);
+      return 0;
+    }
+    for (const u of result.uploaded) out(`uploaded ${u.path} (${kb(u.sizeBytes)}, ${u.sources} source${u.sources === 1 ? "" : "s"}${u.hasContent ? "" : ", no sourcesContent"}${u.replaced ? ", replaced" : ""})`);
+    for (const e of result.errors) err(`failed   ${e.path}: ${e.message}`);
+    out(`
+${result.uploaded.length} uploaded, ${result.errors.length} failed, ${result.skipped.length} skipped${result.release ? ` (release ${result.release})` : ""}.`);
+    if (result.deleted.length) out(`Deleted ${result.deleted.length} local .map file${result.deleted.length === 1 ? "" : "s"}.`);
+    else if (result.uploaded.length) logger.warn("the .map files are still in your build output: deploying them publishes your original source. Pass --delete-after (or exclude *.map from the deploy).");
+    return result.errors.length ? 1 : 0;
+  } catch (e) {
+    err(`error: ${e instanceof GuidelyAuthError ? e.message : e.message}`);
+    return 1;
+  }
+}
+
+// src/index.ts
+var MAX_FILES_PER_REQUEST = 50;
+var MAX_BYTES_PER_REQUEST = 40 * 1024 * 1024;
+var MAX_FILE_BYTES = 25 * 1024 * 1024;
+var GuidelyAuthError = class extends Error {
+  constructor(status) {
+    super(`Guidely rejected the API key (${status}): it is invalid or revoked, or it is missing the sourcemaps:write scope. Create a key under Settings \u2192 API keys.`);
+    this.name = "GuidelyAuthError";
+  }
+};
+var silent = { info: () => {
+}, warn: () => {
+} };
+function urlPathFor(urlPrefix, relPath) {
+  let prefix = (urlPrefix || "/").replace(/\\/g, "/");
+  if (!prefix.includes("://") && !prefix.startsWith("/")) prefix = `/${prefix}`;
+  if (!prefix.endsWith("/")) prefix += "/";
+  const rel = relPath.replace(/\\/g, "/").replace(/^(\.\/)+/, "").replace(/^\/+/, "");
+  return prefix + rel;
+}
+function findSourceMaps(dir, options = {}) {
+  const include = options.include || ".js.map";
+  const log = options.logger ?? silent;
+  const files = [];
+  const skipped = [];
+  const walk = (current) => {
+    for (const entry of readdirSync(current, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+      const full = join(current, entry.name);
+      if (entry.isDirectory()) {
+        if (entry.name !== "node_modules") walk(full);
+        continue;
+      }
+      if (!entry.isFile() || !entry.name.endsWith(include) || !entry.name.endsWith(".map")) continue;
+      const filePath = full.slice(0, -".map".length);
+      if (!existsSync(filePath)) {
+        skipped.push({ path: full, reason: `no minified file next to it (${basename(filePath)})` });
+        log.warn(`skipping ${relative(dir, full)}: no ${basename(filePath)} next to it`);
+        continue;
+      }
+      files.push({ mapPath: full, filePath, urlPath: urlPathFor(options.urlPrefix, relative(dir, filePath).split(sep).join("/")), sizeBytes: statSync(full).size });
+    }
+  };
+  walk(dir);
+  return { files, skipped };
+}
+function batchFiles(files, maxFiles = MAX_FILES_PER_REQUEST, maxBytes = MAX_BYTES_PER_REQUEST) {
+  const batches = [];
+  let current = [];
+  let bytes = 0;
+  for (const f of files) {
+    if (current.length && (current.length >= maxFiles || bytes + f.sizeBytes > maxBytes)) {
+      batches.push(current);
+      current = [];
+      bytes = 0;
+    }
+    current.push(f);
+    bytes += f.sizeBytes;
+  }
+  if (current.length) batches.push(current);
+  return batches;
+}
+function invalidMapReason(content) {
+  try {
+    const map = JSON.parse(content);
+    return map && typeof map === "object" && map.version === 3 ? null : "not a version 3 source map";
+  } catch {
+    return "not valid JSON";
+  }
+}
+var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+var kb2 = (n) => `${Math.max(1, Math.round(n / 1024))} KB`;
+function endpoint(apiUrl, path) {
+  return `${(apiUrl || DEFAULT_API_URL).replace(/\/+$/, "")}/api/v1/sourcemaps${path}`;
+}
+async function errorMessage(res) {
+  const text = await res.text().catch(() => "");
+  try {
+    const body = JSON.parse(text);
+    const msg = typeof body.error === "string" ? body.error : body.error?.message ?? body.message;
+    if (msg) return `${msg} (HTTP ${res.status})`;
+  } catch {
+  }
+  return `HTTP ${res.status}${text ? `: ${text.slice(0, 200)}` : ""}`;
+}
+async function request(doFetch, url, init, retries, delayMs) {
+  for (let attempt = 0; ; attempt++) {
+    let res = null;
+    let failure = null;
+    try {
+      res = await doFetch(url, init());
+    } catch (err) {
+      failure = err;
+    }
+    if (res && (res.status === 401 || res.status === 403)) throw new GuidelyAuthError(res.status);
+    const retryable = !res || res.status >= 500 || res.status === 429;
+    if (!retryable || attempt >= retries) {
+      if (res) return res;
+      throw new Error(`network error: ${failure instanceof Error ? failure.message : String(failure)}`);
+    }
+    await sleep(delayMs * 2 ** attempt);
+  }
+}
+async function uploadSourceMaps(options) {
+  const log = options.logger ?? silent;
+  if (!options.dir || !existsSync(options.dir) || !statSync(options.dir).isDirectory()) throw new Error(`directory not found: ${options.dir || "(missing --dir)"}`);
+  if (!options.dryRun && !options.key) throw new Error("missing API key: pass --key or set GUIDELY_SOURCEMAP_KEY");
+  const release = options.release?.trim() || null;
+  if (release && release.length > 100) throw new Error("release must be at most 100 characters");
+  const maxFileBytes = options.maxFileBytes ?? MAX_FILE_BYTES;
+  const found = findSourceMaps(options.dir, { urlPrefix: options.urlPrefix, include: options.include, logger: log });
+  const result = { release, files: [], uploaded: [], errors: [], skipped: found.skipped, deleted: [], dryRun: !!options.dryRun };
+  for (const f of found.files) {
+    if (f.sizeBytes > maxFileBytes) {
+      result.skipped.push({ path: f.mapPath, reason: `larger than ${kb2(maxFileBytes)}` });
+      log.warn(`skipping ${f.urlPath}.map: ${kb2(f.sizeBytes)} is over the ${kb2(maxFileBytes)} limit`);
+    } else result.files.push(f);
+  }
+  const doFetch = options.fetch ?? globalThis.fetch;
+  const valid = [];
+  const succeeded = /* @__PURE__ */ new Set();
+  for (const batch of batchFiles(result.files, options.maxFilesPerRequest, options.maxBytesPerRequest ?? MAX_BYTES_PER_REQUEST)) {
+    const items = [];
+    for (const f of batch) {
+      const content = readFileSync(f.mapPath, "utf8");
+      const reason = invalidMapReason(content);
+      if (reason) {
+        result.skipped.push({ path: f.mapPath, reason });
+        log.warn(`skipping ${f.urlPath}.map: ${reason}`);
+      } else items.push({ ...f, content });
+    }
+    valid.push(...items.map(({ content: _content, ...f }) => f));
+    if (options.dryRun) {
+      for (const f of items) log.info(`would upload ${f.urlPath} (${kb2(f.sizeBytes)})`);
+      continue;
+    }
+    if (!items.length) continue;
+    const res = await request(
+      doFetch,
+      endpoint(options.apiUrl, "/upload"),
+      () => {
+        const form = new FormData();
+        if (release) form.set("release", release);
+        form.set("manifest", JSON.stringify(items.map((f, i) => ({ field: `f${i}`, path: f.urlPath }))));
+        items.forEach((f, i) => form.set(`f${i}`, new Blob([f.content], { type: "application/json" }), basename(f.mapPath)));
+        return { method: "POST", headers: { Authorization: `Bearer ${options.key}` }, body: form };
+      },
+      options.retries ?? 3,
+      options.retryDelayMs ?? 1e3
+    ).catch((err) => {
+      if (err instanceof GuidelyAuthError) throw err;
+      return err instanceof Error ? err : new Error(String(err));
+    });
+    if (res instanceof Error || !res.ok) {
+      const message = res instanceof Error ? res.message : await errorMessage(res);
+      for (const f of items) result.errors.push({ path: f.urlPath, message });
+      continue;
+    }
+    const body = await res.json().catch(() => ({}));
+    if (body.release) result.release = body.release;
+    for (const u of body.uploaded ?? []) {
+      result.uploaded.push(u);
+      succeeded.add(u.path);
+    }
+    result.errors.push(...body.errors ?? []);
+  }
+  result.files = valid;
+  if (options.deleteAfter && !options.dryRun) {
+    for (const f of result.files) {
+      if (!succeeded.has(f.urlPath)) continue;
+      try {
+        unlinkSync(f.mapPath);
+        result.deleted.push(f.mapPath);
+      } catch (err) {
+        log.warn(`could not delete ${f.mapPath}: ${err instanceof Error ? err.message : String(err)}`);
+      }
+    }
+  }
+  return result;
+}
+async function verifyKey(options) {
+  if (!options.key) throw new Error("missing API key: pass --key or set GUIDELY_SOURCEMAP_KEY");
+  const res = await request(options.fetch ?? globalThis.fetch, endpoint(options.apiUrl, "/whoami"), () => ({ headers: { Authorization: `Bearer ${options.key}`, Accept: "application/json" } }), options.retries ?? 3, options.retryDelayMs ?? 1e3);
+  if (!res.ok) throw new Error(await errorMessage(res));
+  const b = await res.json().catch(() => ({}));
+  const str = (v) => typeof v === "string" && v ? v : null;
+  return {
+    projectName: str(b.project?.name) ?? str(b.projectName),
+    projectId: str(b.project?.id) ?? str(b.projectId),
+    keyName: str(b.key?.name) ?? str(b.keyName),
+    keyPrefix: str(b.key?.prefix) ?? str(b.keyPrefix) ?? str(b.prefix),
+    scopes: Array.isArray(b.key?.scopes) ? b.key.scopes : Array.isArray(b.scopes) ? b.scopes : []
+  };
+}
+export {
+  DEFAULT_API_URL,
+  GuidelyAuthError,
+  MAX_BYTES_PER_REQUEST,
+  MAX_FILES_PER_REQUEST,
+  MAX_FILE_BYTES,
+  batchFiles,
+  findSourceMaps,
+  invalidMapReason,
+  runCli,
+  uploadSourceMaps,
+  urlPathFor,
+  verifyKey
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/constants.ts","../src/run.ts"],"sourcesContent":["/**\n * @guidelytech/sourcemaps — uploads JavaScript source maps to Guidely so exception stack traces are\n * shown against your original source. Zero runtime dependencies (Node ≥18: fetch, FormData, Blob).\n */\nimport { readdirSync, readFileSync, statSync, unlinkSync, existsSync } from \"node:fs\";\nimport { basename, join, relative, sep } from \"node:path\";\n\nimport { DEFAULT_API_URL } from \"./constants\";\n\nexport { DEFAULT_API_URL };\n/** Per-request limits and the per-file cap enforced by the upload API. */\nexport const MAX_FILES_PER_REQUEST = 50;\nexport const MAX_BYTES_PER_REQUEST = 40 * 1024 * 1024;\nexport const MAX_FILE_BYTES = 25 * 1024 * 1024;\n\nexport interface Logger {\n  info(message: string): void;\n  warn(message: string): void;\n}\n\n/** A source map found on disk next to its minified file. */\nexport interface SourceMapFile {\n  /** Absolute path of the `.map` file. */\n  mapPath: string;\n  /** Absolute path of the minified file the map belongs to. */\n  filePath: string;\n  /** URL path the minified file is served at (`urlPrefix` + posix relative path). */\n  urlPath: string;\n  sizeBytes: number;\n}\n\nexport interface SkippedFile {\n  path: string;\n  reason: string;\n}\n\n/** One map stored by the server. */\nexport interface UploadedMap {\n  path: string;\n  sizeBytes: number;\n  sources: number;\n  hasContent: boolean;\n  replaced: boolean;\n}\n\nexport interface UploadOptions {\n  /** Build output directory searched recursively (e.g. `dist`, `.next/static`). */\n  dir: string;\n  /** URL path the directory is served under (default `/`; `/_next/static/` for Next.js). */\n  urlPrefix?: string;\n  /** App version / commit SHA; must equal the SDK's `release` option. */\n  release?: string;\n  /** Guidely API base URL (default `https://api.guidely.app`). */\n  apiUrl?: string;\n  /** Secret project API key with the `sourcemaps:write` scope. */\n  key?: string;\n  /** File-name suffix of the maps to upload (default `.js.map`). */\n  include?: string;\n  /** Delete local `.map` files that were uploaded successfully. */\n  deleteAfter?: boolean;\n  /** Only list what would be uploaded. */\n  dryRun?: boolean;\n  logger?: Logger;\n  fetch?: typeof fetch;\n  /** Retries for network errors, 5xx and 429 (default 3). */\n  retries?: number;\n  /** Base backoff delay (default 1000ms, doubled per attempt). */\n  retryDelayMs?: number;\n  maxFilesPerRequest?: number;\n  maxBytesPerRequest?: number;\n  maxFileBytes?: number;\n}\n\nexport interface UploadResult {\n  release: string | null;\n  /** Maps found (and, unless skipped, uploaded or listed in a dry run). */\n  files: SourceMapFile[];\n  uploaded: UploadedMap[];\n  errors: Array<{ path: string; message: string }>;\n  skipped: SkippedFile[];\n  /** Local `.map` files deleted with `deleteAfter`. */\n  deleted: string[];\n  dryRun: boolean;\n}\n\n/** Invalid or revoked key, or a key without the `sourcemaps:write` scope. */\nexport class GuidelyAuthError extends Error {\n  constructor(status: number) {\n    super(`Guidely rejected the API key (${status}): it is invalid or revoked, or it is missing the sourcemaps:write scope. Create a key under Settings → API keys.`);\n    this.name = \"GuidelyAuthError\";\n  }\n}\n\nconst silent: Logger = { info: () => {}, warn: () => {} };\n\n/** URL path of a built file: `prefix` (default `/`) + its posix path relative to the build directory. */\nexport function urlPathFor(urlPrefix: string | undefined, relPath: string): string {\n  let prefix = (urlPrefix || \"/\").replace(/\\\\/g, \"/\");\n  if (!prefix.includes(\"://\") && !prefix.startsWith(\"/\")) prefix = `/${prefix}`;\n  if (!prefix.endsWith(\"/\")) prefix += \"/\";\n  const rel = relPath.replace(/\\\\/g, \"/\").replace(/^(\\.\\/)+/, \"\").replace(/^\\/+/, \"\");\n  return prefix + rel;\n}\n\n/** Recursively finds `*<include>` maps whose minified sibling (same name without `.map`) exists. */\nexport function findSourceMaps(dir: string, options: { urlPrefix?: string; include?: string; logger?: Logger } = {}): { files: SourceMapFile[]; skipped: SkippedFile[] } {\n  const include = options.include || \".js.map\";\n  const log = options.logger ?? silent;\n  const files: SourceMapFile[] = [];\n  const skipped: SkippedFile[] = [];\n  const walk = (current: string) => {\n    for (const entry of readdirSync(current, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {\n      const full = join(current, entry.name);\n      if (entry.isDirectory()) {\n        if (entry.name !== \"node_modules\") walk(full);\n        continue;\n      }\n      if (!entry.isFile() || !entry.name.endsWith(include) || !entry.name.endsWith(\".map\")) continue;\n      const filePath = full.slice(0, -\".map\".length);\n      if (!existsSync(filePath)) {\n        skipped.push({ path: full, reason: `no minified file next to it (${basename(filePath)})` });\n        log.warn(`skipping ${relative(dir, full)}: no ${basename(filePath)} next to it`);\n        continue;\n      }\n      files.push({ mapPath: full, filePath, urlPath: urlPathFor(options.urlPrefix, relative(dir, filePath).split(sep).join(\"/\")), sizeBytes: statSync(full).size });\n    }\n  };\n  walk(dir);\n  return { files, skipped };\n}\n\n/** Groups files into requests of at most `maxFiles` files and `maxBytes` bytes (a larger single file gets its own request). */\nexport function batchFiles<T extends { sizeBytes: number }>(files: T[], maxFiles = MAX_FILES_PER_REQUEST, maxBytes = MAX_BYTES_PER_REQUEST): T[][] {\n  const batches: T[][] = [];\n  let current: T[] = [];\n  let bytes = 0;\n  for (const f of files) {\n    if (current.length && (current.length >= maxFiles || bytes + f.sizeBytes > maxBytes)) {\n      batches.push(current);\n      current = [];\n      bytes = 0;\n    }\n    current.push(f);\n    bytes += f.sizeBytes;\n  }\n  if (current.length) batches.push(current);\n  return batches;\n}\n\n/** Returns why a map file cannot be uploaded, or null when it is a valid v3 source map. */\nexport function invalidMapReason(content: string): string | null {\n  try {\n    const map = JSON.parse(content) as { version?: unknown };\n    return map && typeof map === \"object\" && map.version === 3 ? null : \"not a version 3 source map\";\n  } catch {\n    return \"not valid JSON\";\n  }\n}\n\nconst sleep = (ms: number) => new Promise<void>((r) => setTimeout(r, ms));\nconst kb = (n: number) => `${Math.max(1, Math.round(n / 1024))} KB`;\n\nfunction endpoint(apiUrl: string | undefined, path: string): string {\n  return `${(apiUrl || DEFAULT_API_URL).replace(/\\/+$/, \"\")}/api/v1/sourcemaps${path}`;\n}\n\nasync function errorMessage(res: Response): Promise<string> {\n  const text = await res.text().catch(() => \"\");\n  try {\n    const body = JSON.parse(text) as { error?: { message?: string } | string; message?: string };\n    const msg = typeof body.error === \"string\" ? body.error : body.error?.message ?? body.message;\n    if (msg) return `${msg} (HTTP ${res.status})`;\n  } catch {\n    /* not JSON */\n  }\n  return `HTTP ${res.status}${text ? `: ${text.slice(0, 200)}` : \"\"}`;\n}\n\n/** fetch with retries on network errors, 5xx and 429; 401/403 throw {@link GuidelyAuthError}. */\nasync function request(doFetch: typeof fetch, url: string, init: () => RequestInit, retries: number, delayMs: number): Promise<Response> {\n  for (let attempt = 0; ; attempt++) {\n    let res: Response | null = null;\n    let failure: unknown = null;\n    try {\n      res = await doFetch(url, init());\n    } catch (err) {\n      failure = err;\n    }\n    if (res && (res.status === 401 || res.status === 403)) throw new GuidelyAuthError(res.status);\n    const retryable = !res || res.status >= 500 || res.status === 429;\n    if (!retryable || attempt >= retries) {\n      if (res) return res;\n      throw new Error(`network error: ${failure instanceof Error ? failure.message : String(failure)}`);\n    }\n    await sleep(delayMs * 2 ** attempt);\n  }\n}\n\n/** Finds the maps under `dir` and uploads them in batches. Throws {@link GuidelyAuthError} for a rejected key. */\nexport async function uploadSourceMaps(options: UploadOptions): Promise<UploadResult> {\n  const log = options.logger ?? silent;\n  if (!options.dir || !existsSync(options.dir) || !statSync(options.dir).isDirectory()) throw new Error(`directory not found: ${options.dir || \"(missing --dir)\"}`);\n  if (!options.dryRun && !options.key) throw new Error(\"missing API key: pass --key or set GUIDELY_SOURCEMAP_KEY\");\n  const release = options.release?.trim() || null;\n  if (release && release.length > 100) throw new Error(\"release must be at most 100 characters\");\n  const maxFileBytes = options.maxFileBytes ?? MAX_FILE_BYTES;\n  const found = findSourceMaps(options.dir, { urlPrefix: options.urlPrefix, include: options.include, logger: log });\n  const result: UploadResult = { release, files: [], uploaded: [], errors: [], skipped: found.skipped, deleted: [], dryRun: !!options.dryRun };\n  for (const f of found.files) {\n    if (f.sizeBytes > maxFileBytes) {\n      result.skipped.push({ path: f.mapPath, reason: `larger than ${kb(maxFileBytes)}` });\n      log.warn(`skipping ${f.urlPath}.map: ${kb(f.sizeBytes)} is over the ${kb(maxFileBytes)} limit`);\n    } else result.files.push(f);\n  }\n  const doFetch = options.fetch ?? globalThis.fetch;\n  const valid: SourceMapFile[] = [];\n  const succeeded = new Set<string>();\n  for (const batch of batchFiles(result.files, options.maxFilesPerRequest, options.maxBytesPerRequest ?? MAX_BYTES_PER_REQUEST)) {\n    // Maps are read one batch at a time so memory stays bounded by the request size.\n    const items: Array<SourceMapFile & { content: string }> = [];\n    for (const f of batch) {\n      const content = readFileSync(f.mapPath, \"utf8\");\n      const reason = invalidMapReason(content);\n      if (reason) {\n        result.skipped.push({ path: f.mapPath, reason });\n        log.warn(`skipping ${f.urlPath}.map: ${reason}`);\n      } else items.push({ ...f, content });\n    }\n    valid.push(...items.map(({ content: _content, ...f }) => f));\n    if (options.dryRun) {\n      for (const f of items) log.info(`would upload ${f.urlPath} (${kb(f.sizeBytes)})`);\n      continue;\n    }\n    if (!items.length) continue;\n    const res = await request(\n      doFetch,\n      endpoint(options.apiUrl, \"/upload\"),\n      () => {\n        const form = new FormData();\n        if (release) form.set(\"release\", release);\n        form.set(\"manifest\", JSON.stringify(items.map((f, i) => ({ field: `f${i}`, path: f.urlPath }))));\n        items.forEach((f, i) => form.set(`f${i}`, new Blob([f.content], { type: \"application/json\" }), basename(f.mapPath)));\n        return { method: \"POST\", headers: { Authorization: `Bearer ${options.key}` }, body: form };\n      },\n      options.retries ?? 3,\n      options.retryDelayMs ?? 1000,\n    ).catch((err: unknown) => {\n      if (err instanceof GuidelyAuthError) throw err;\n      return err instanceof Error ? err : new Error(String(err));\n    });\n    if (res instanceof Error || !res.ok) {\n      const message = res instanceof Error ? res.message : await errorMessage(res);\n      for (const f of items) result.errors.push({ path: f.urlPath, message });\n      continue;\n    }\n    const body = (await res.json().catch(() => ({}))) as { release?: string; uploaded?: UploadedMap[]; errors?: Array<{ path: string; message: string }> };\n    if (body.release) result.release = body.release;\n    for (const u of body.uploaded ?? []) {\n      result.uploaded.push(u);\n      succeeded.add(u.path);\n    }\n    result.errors.push(...(body.errors ?? []));\n  }\n  result.files = valid;\n  if (options.deleteAfter && !options.dryRun) {\n    for (const f of result.files) {\n      if (!succeeded.has(f.urlPath)) continue;\n      try {\n        unlinkSync(f.mapPath);\n        result.deleted.push(f.mapPath);\n      } catch (err) {\n        log.warn(`could not delete ${f.mapPath}: ${err instanceof Error ? err.message : String(err)}`);\n      }\n    }\n  }\n  return result;\n}\n\n/** What `GET /api/v1/sourcemaps/whoami` reports about a key (fields are read leniently). */\nexport interface WhoAmI {\n  projectName: string | null;\n  projectId: string | null;\n  keyName: string | null;\n  keyPrefix: string | null;\n  scopes: string[];\n}\n\n/** Checks a key against the API (`guidely-sourcemaps verify`). */\nexport async function verifyKey(options: Pick<UploadOptions, \"apiUrl\" | \"key\" | \"fetch\" | \"retries\" | \"retryDelayMs\">): Promise<WhoAmI> {\n  if (!options.key) throw new Error(\"missing API key: pass --key or set GUIDELY_SOURCEMAP_KEY\");\n  const res = await request(options.fetch ?? globalThis.fetch, endpoint(options.apiUrl, \"/whoami\"), () => ({ headers: { Authorization: `Bearer ${options.key}`, Accept: \"application/json\" } }), options.retries ?? 3, options.retryDelayMs ?? 1000);\n  if (!res.ok) throw new Error(await errorMessage(res));\n  const b = (await res.json().catch(() => ({}))) as Record<string, any>;\n  const str = (v: unknown) => (typeof v === \"string\" && v ? v : null);\n  return {\n    projectName: str(b.project?.name) ?? str(b.projectName),\n    projectId: str(b.project?.id) ?? str(b.projectId),\n    keyName: str(b.key?.name) ?? str(b.keyName),\n    keyPrefix: str(b.key?.prefix) ?? str(b.keyPrefix) ?? str(b.prefix),\n    scopes: Array.isArray(b.key?.scopes) ? b.key.scopes : Array.isArray(b.scopes) ? b.scopes : [],\n  };\n}\n\nexport { runCli } from \"./run\";\nexport type { CliIO } from \"./run\";\n","/** Default Guidely API base URL (same as the browser SDK). Its own module so `run.ts` can import it without an import cycle. */\nexport const DEFAULT_API_URL = \"https://api.guidely.app\";\n","import { DEFAULT_API_URL } from \"./constants\";\nimport { GuidelyAuthError, uploadSourceMaps, verifyKey, type Logger } from \"./index\";\n\n/** Where the CLI writes and what it reads (injectable for tests). */\nexport interface CliIO {\n  env?: Record<string, string | undefined>;\n  out?: (line: string) => void;\n  err?: (line: string) => void;\n  fetch?: typeof fetch;\n  retryDelayMs?: number;\n}\n\nconst HELP = `Usage:\n  guidely-sourcemaps upload --dir <dir> [options]   Upload source maps from a build directory\n  guidely-sourcemaps verify [--key <key>]           Check the API key\n\nOptions:\n  --dir <dir>          Build output directory, searched recursively (e.g. dist, .next/static)\n  --url-prefix <path>  URL path the directory is served under (default \"/\"; \"/_next/static/\" for Next.js)\n  --release <release>  App version or commit SHA; set the same value as the SDK's \\`release\\` (env GUIDELY_RELEASE)\n  --api-url <url>      Guidely API URL (env GUIDELY_API_URL, default ${DEFAULT_API_URL})\n  --key <key>          Secret API key with the sourcemaps:write scope (env GUIDELY_SOURCEMAP_KEY)\n  --include <suffix>   File-name suffix of the maps to upload (default .js.map)\n  --delete-after       Delete local .map files once uploaded (so they are not deployed publicly)\n  --dry-run            List what would be uploaded without uploading\n  -h, --help           Show this help`;\n\nconst BOOLEAN = new Set([\"delete-after\", \"dry-run\", \"help\"]);\n\n/** Parses `--name value`, `--name=value` and boolean flags. */\nexport function parseArgs(argv: string[]): { command: string | undefined; flags: Record<string, string | boolean> } {\n  const flags: Record<string, string | boolean> = {};\n  let command: string | undefined;\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i] as string;\n    if (arg === \"-h\") flags.help = true;\n    else if (arg.startsWith(\"--\")) {\n      const [name, inline] = arg.slice(2).split(/=(.*)/s, 2) as [string, string | undefined];\n      if (BOOLEAN.has(name)) flags[name] = inline === undefined ? true : inline !== \"false\";\n      else if (inline !== undefined) flags[name] = inline;\n      else {\n        const next = argv[i + 1];\n        if (next === undefined || next.startsWith(\"--\")) throw new Error(`--${name} needs a value`);\n        flags[name] = next;\n        i++;\n      }\n    } else if (!command) command = arg;\n    else throw new Error(`unexpected argument: ${arg}`);\n  }\n  return { command, flags };\n}\n\nconst kb = (n: number) => `${Math.max(1, Math.round(n / 1024))} KB`;\n\n/** Runs the CLI; resolves with the process exit code. Never prints the API key. */\nexport async function runCli(argv: string[], io: CliIO = {}): Promise<number> {\n  const env = io.env ?? process.env;\n  const out = io.out ?? ((l: string) => console.log(l));\n  const err = io.err ?? ((l: string) => console.error(l));\n  const logger: Logger = { info: out, warn: (m) => err(`warning: ${m}`) };\n  let parsed: ReturnType<typeof parseArgs>;\n  try {\n    parsed = parseArgs(argv);\n  } catch (e) {\n    err(`error: ${(e as Error).message}\\n\\n${HELP}`);\n    return 1;\n  }\n  const { command, flags } = parsed;\n  if (flags.help || !command) {\n    (command || flags.help ? out : err)(HELP);\n    return flags.help ? 0 : 1;\n  }\n  const str = (name: string) => (typeof flags[name] === \"string\" ? (flags[name] as string) : undefined);\n  const apiUrl = str(\"api-url\") || env.GUIDELY_API_URL || DEFAULT_API_URL;\n  const key = str(\"key\") || env.GUIDELY_SOURCEMAP_KEY;\n  try {\n    if (command === \"verify\") {\n      const who = await verifyKey({ apiUrl, key, fetch: io.fetch, retryDelayMs: io.retryDelayMs });\n      out(`Key OK for project ${who.projectName ?? who.projectId ?? \"(unknown)\"}${who.keyPrefix ? ` (key gly_sk_${who.keyPrefix}…)` : \"\"}${who.scopes.length ? `, scopes: ${who.scopes.join(\", \")}` : \"\"}`);\n      return 0;\n    }\n    if (command !== \"upload\") {\n      err(`error: unknown command \"${command}\"\\n\\n${HELP}`);\n      return 1;\n    }\n    const dryRun = flags[\"dry-run\"] === true;\n    const release = str(\"release\") || env.GUIDELY_RELEASE || undefined;\n    const result = await uploadSourceMaps({ dir: str(\"dir\") ?? \"\", urlPrefix: str(\"url-prefix\"), release, apiUrl, key, include: str(\"include\"), deleteAfter: flags[\"delete-after\"] === true, dryRun, fetch: io.fetch, retryDelayMs: io.retryDelayMs, logger });\n    const total = result.files.length;\n    if (!total) {\n      err(`error: no source maps to upload in ${str(\"dir\")} (looked for *${str(\"include\") || \".js.map\"} files next to their minified file)`);\n      return 1;\n    }\n    if (dryRun) {\n      out(`Dry run: ${total} source map${total === 1 ? \"\" : \"s\"} would be uploaded${release ? ` for release ${release}` : \"\"} to ${apiUrl}.`);\n      return 0;\n    }\n    for (const u of result.uploaded) out(`uploaded ${u.path} (${kb(u.sizeBytes)}, ${u.sources} source${u.sources === 1 ? \"\" : \"s\"}${u.hasContent ? \"\" : \", no sourcesContent\"}${u.replaced ? \", replaced\" : \"\"})`);\n    for (const e of result.errors) err(`failed   ${e.path}: ${e.message}`);\n    out(`\\n${result.uploaded.length} uploaded, ${result.errors.length} failed, ${result.skipped.length} skipped${result.release ? ` (release ${result.release})` : \"\"}.`);\n    if (result.deleted.length) out(`Deleted ${result.deleted.length} local .map file${result.deleted.length === 1 ? \"\" : \"s\"}.`);\n    else if (result.uploaded.length) logger.warn(\"the .map files are still in your build output: deploying them publishes your original source. Pass --delete-after (or exclude *.map from the deploy).\");\n    return result.errors.length ? 1 : 0;\n  } catch (e) {\n    err(`error: ${e instanceof GuidelyAuthError ? e.message : (e as Error).message}`);\n    return 1;\n  }\n}\n"],"mappings":"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","names":["kb"]}

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "@guidelytech/sourcemaps",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.4.1",
+  "description": "Upload JavaScript source maps to Guidely so error stack traces show your original code",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "guidely-sourcemaps": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.5",
+    "@types/node": "^22.20.5",
+    "eslint": "^9.39.5",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.46.0",
+    "vitest": "^3.2.7"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/parmarg/Guidely.git",
+    "directory": "packages/sourcemaps"
+  },
+  "homepage": "https://github.com/parmarg/Guidely/tree/main/packages/sourcemaps#readme",
+  "bugs": {
+    "url": "https://github.com/parmarg/Guidely/issues"
+  },
+  "keywords": [
+    "guidely",
+    "sourcemaps",
+    "source-maps",
+    "error-tracking",
+    "cli"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src",
+    "clean": "rm -rf dist"
+  }
 }