@rasputin-ai/core 0.1.4 → 0.2.0

package/dist/create-client/create-client-types.d.ts

@@ -1,19 +1,6 @@
 import type { RequestContext } from '../create-ingest-event/create-ingest-event-types';
 import type { TransportFetch } from '../transport/transport-types';
-/**
- * Options passed to `RasputinInit` / `createClient`.
- *
- * Typical setup — call once at startup, then let the SDK capture errors for you:
- *
- * ```ts
- * RasputinInit({
- *   projectApiKey: 'rp_…',      // from your Rasputin project settings
- *   environment: 'production',  // e.g. production | staging | preview
- *   release: process.env.GIT_SHA, // optional — auto-detected from CI env when omitted
- * });
- * ```
- */
-export type RasputinOptions = {
+type RasputinBaseOptions = {
     /** Project API key from the Rasputin dashboard. Required to send events. */
     projectApiKey: string;
     /**
@@ -22,11 +9,14 @@ export type RasputinOptions = {
      */
     environment: string;
     /**
-     * Deploy identifier, usually a git commit SHA.
-     * Links errors to a release so you can see what shipped when something broke.
+     * Git commit SHA for this deploy. Links errors to a release so you can see
+     * what shipped when something broke.
      *
-     * When omitted, Rasputin reads common CI env vars (`VERCEL_GIT_COMMIT_SHA`,
-     * `GIT_COMMIT`, etc.). Set explicitly if auto-detection does not match your setup.
+     * Prefer setting the env var (no code change needed on each deploy):
+     * `release: process.env.RASPUTIN_RELEASE`
+     *
+     * When omitted, Rasputin reads `RASPUTIN_RELEASE`, then platform vars
+     * (`VERCEL_GIT_COMMIT_SHA`, etc.), then `.git` HEAD. Must be 7–40 hex chars.
      */
     release?: string | null;
     /**
@@ -37,17 +27,33 @@ export type RasputinOptions = {
      */
     enabled?: boolean;
     apiUrl?: string;
-    /**
-     * Root of your app on disk. Stack traces are trimmed to paths relative to this
-     * (e.g. `src/routes/users.ts` instead of `/app/src/routes/users.ts`).
-     *
-     * In a monorepo, pass the **repository root**, not the package directory, so
-     * paths line up with GitHub.
-     *
-     * @default `process.cwd()`
-     */
-    repoRoot?: string;
 };
+/**
+ * Options passed to `RasputinInit` / `createClient`.
+ *
+ * Typical setup — call once at startup, then let the SDK capture errors for you:
+ *
+ * ```ts
+ * RasputinInit({
+ *   projectApiKey: 'rp_…',      // from your Rasputin project settings
+ *   environment: 'production',  // e.g. production | staging | preview
+ *   release: process.env.RASPUTIN_RELEASE,
+ *   moduleUrl: import.meta.url, // from the file where you call this
+ * });
+ * ```
+ *
+ * Pass `moduleUrl: import.meta.url` from the file where you call this.
+ * Rasputin uses it to find your project folder so error paths match your source.
+ * If that isn't right (for example in Docker), set `repoRoot` to the folder
+ * you open in your editor instead.
+ */
+export type RasputinOptions = RasputinBaseOptions & ({
+    repoRoot: string;
+    moduleUrl?: string;
+} | {
+    moduleUrl: string;
+    repoRoot?: string;
+});
 /**
  * Extra context for a captured error.
  * Framework plugins (Elysia, etc.) fill `request` automatically for route failures.
@@ -107,4 +113,5 @@ export type CreateClientHooks = {
     sdkVersion?: string;
     sdkName?: string;
 };
+export {};
 //# sourceMappingURL=create-client-types.d.ts.map

package/dist/create-client/create-client-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-client-types.d.ts","sourceRoot":"","sources":["../../src/create-client/create-client-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kDAAkD,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe,GAAG;IAC7B,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B;;;;;;;;OAQG;IACH,gBAAgB,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;IAErE;;;;;;;;;;;;OAYG;IACH,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;;;;OAKG;IACH,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B,CAAC;AAEF,2FAA2F;AAC3F,MAAM,MAAM,iBAAiB,GAAG;IAC/B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,8BAA8B,CAAC,EAAE,OAAO,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}
+{"version":3,"file":"create-client-types.d.ts","sourceRoot":"","sources":["../../src/create-client/create-client-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kDAAkD,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,KAAK,mBAAmB,GAAG;IAC1B,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAChD,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEvF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B;;;;;;;;OAQG;IACH,gBAAgB,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;IAErE;;;;;;;;;;;;OAYG;IACH,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;;;;OAKG;IACH,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B,CAAC;AAEF,2FAA2F;AAC3F,MAAM,MAAM,iBAAiB,GAAG;IAC/B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,8BAA8B,CAAC,EAAE,OAAO,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/dist/create-client/create-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-client.d.ts","sourceRoot":"","sources":["../../src/create-client/create-client.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAuBhG,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,YAGlC,CAAC;AAwBF;;;GAGG;AACH,eAAO,MAAM,YAAY,GACxB,SAAS,eAAe,EACxB,QAAO,iBAAsB,KAC3B,cA8GF,CAAC"}
+{"version":3,"file":"create-client.d.ts","sourceRoot":"","sources":["../../src/create-client/create-client.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAuBhG,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,YAGlC,CAAC;AAaF;;;GAGG;AACH,eAAO,MAAM,YAAY,GACxB,SAAS,eAAe,EACxB,QAAO,iBAAsB,KAC3B,cAuJF,CAAC"}

package/dist/detect-release/detect-release.d.ts

@@ -1,12 +1,15 @@
 type DetectReleaseOptions = {
-    /** Explicit release (e.g. from RasputinInit). Wins over env when non-empty. */
+    /** Explicit release (e.g. from RasputinInit). Wins over env when a valid SHA. */
     release?: string | null;
     /** Defaults to `process.env` — override in tests. */
     env?: Record<string, string | undefined>;
+    /** Directory to probe for `.git` — defaults to `process.cwd()`. Override in tests. */
+    cwd?: string;
 };
 /**
  * Resolve the deploy release / commit SHA.
- * Order: explicit option → platform env vars → generic git env vars → undefined (warns).
+ * Order: explicit option → `RASPUTIN_RELEASE` / platform env → `.git` HEAD → undefined (warns).
+ * Non-SHA values are skipped with a warning so ancestry checks never see `v1.2.3` or branch names.
  */
 export declare const detectRelease: (options?: DetectReleaseOptions) => string | undefined;
 export {};

package/dist/detect-release/detect-release.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detect-release.d.ts","sourceRoot":"","sources":["../../src/detect-release/detect-release.ts"],"names":[],"mappings":"AAAA,KAAK,oBAAoB,GAAG;IAC3B,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACzC,CAAC;AAYF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,UAAS,oBAAyB,KAAG,MAAM,GAAG,SAiB3E,CAAC"}
+{"version":3,"file":"detect-release.d.ts","sourceRoot":"","sources":["../../src/detect-release/detect-release.ts"],"names":[],"mappings":"AAGA,KAAK,oBAAoB,GAAG;IAC3B,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAkDF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,UAAS,oBAAyB,KAAG,MAAM,GAAG,SAyB3E,CAAC"}

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export type { Frame } from './normalize-frames/normalize-frames';
 export { normalizeFrames } from './normalize-frames/normalize-frames';
 export { parseStack } from './parse-stack/parse-stack';
 export type { RawFrame } from './parse-stack/raw-frame';
+export { repoRootFrom } from './repo-root/repo-root-from';
 export { resolveSourceMaps } from './resolve-source-maps/resolve-source-maps';
 export type { ResolvedFrame, ResolveSourceMapsResult, } from './resolve-source-maps/resolved-frame';
 export { createSuppression } from './suppression/create-suppression';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,YAAY,EACX,cAAc,EACd,cAAc,EACd,eAAe,GACf,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,YAAY,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAC9E,YAAY,EACX,aAAa,EACb,uBAAuB,GACvB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,YAAY,EACX,wBAAwB,EACxB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,uBAAuB,GACvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,YAAY,EACX,sBAAsB,EACtB,SAAS,EACT,iBAAiB,GACjB,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,YAAY,EACX,cAAc,EACd,cAAc,EACd,eAAe,GACf,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,YAAY,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAC9E,YAAY,EACX,aAAa,EACb,uBAAuB,GACvB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,YAAY,EACX,wBAAwB,EACxB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,uBAAuB,GACvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,YAAY,EACX,sBAAsB,EACtB,SAAS,EACT,iBAAiB,GACjB,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -111,25 +111,62 @@ var finalizeResolution = (resolution, stackFrames) => {
 };
 
 // src/detect-release/detect-release.ts
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
 var ENV_KEYS = [
+  "RASPUTIN_RELEASE",
   "VERCEL_GIT_COMMIT_SHA",
   "RAILWAY_GIT_COMMIT_SHA",
   "RENDER_GIT_COMMIT",
-  "SOURCE_VERSION",
+  "COMMIT_REF",
+  "CF_PAGES_COMMIT_SHA",
+  "HEROKU_SLUG_COMMIT",
   "GIT_COMMIT",
   "COMMIT_SHA",
   "GIT_SHA"
 ];
+var SHA_RE = /^[0-9a-f]{7,40}$/i;
+var isSha = (value) => SHA_RE.test(value);
+var warnInvalid = (source, value) => {
+  console.warn(
+    `[rasputin] Ignoring invalid release from ${source}: "${value}". Expected a git commit SHA (7\u201340 hex characters).`
+  );
+};
+var readGitHead = (cwd) => {
+  try {
+    const gitDir = join(cwd, ".git");
+    const head = readFileSync(join(gitDir, "HEAD"), "utf8").trim();
+    if (isSha(head)) return head;
+    const ref = head.replace(/^ref:\s*/, "");
+    try {
+      const sha = readFileSync(join(gitDir, ref), "utf8").trim();
+      return isSha(sha) ? sha : void 0;
+    } catch {
+      const packed = readFileSync(join(gitDir, "packed-refs"), "utf8");
+      const match = packed.match(new RegExp(`^([0-9a-f]{40}) ${ref}$`, "m"));
+      return match?.[1];
+    }
+  } catch {
+    return void 0;
+  }
+};
 var detectRelease = (options = {}) => {
   const explicit = options.release?.trim();
-  if (explicit) return explicit;
+  if (explicit) {
+    if (isSha(explicit)) return explicit;
+    warnInvalid("release option", explicit);
+  }
   const env = options.env ?? process.env;
   for (const key of ENV_KEYS) {
     const value = env[key]?.trim();
-    if (value) return value;
+    if (!value) continue;
+    if (isSha(value)) return value;
+    warnInvalid(key, value);
   }
+  const fromGit = readGitHead(options.cwd ?? process.cwd());
+  if (fromGit) return fromGit;
   console.warn(
-    "[rasputin] No release detected. Set `release` in RasputinInit or a commit SHA env var (e.g. GIT_COMMIT, VERCEL_GIT_COMMIT_SHA). Without a release, deploy correlation and diagnosis confidence are degraded."
+    "[rasputin] No release detected. Set `RASPUTIN_RELEASE` to your git commit SHA, pass `release` in RasputinInit, or deploy on a platform that exposes a commit SHA env var (e.g. VERCEL_GIT_COMMIT_SHA). Without a release, deploy correlation and diagnosis confidence are degraded."
   );
   return void 0;
 };
@@ -168,8 +205,8 @@ var isInApp = (file, underRoot) => {
   if (/(^|\/)node_modules\//.test(file)) return false;
   return true;
 };
-var normalizeFrames = (frames, options = {}) => {
-  const appRoot = options.appRoot ?? process.cwd();
+var normalizeFrames = (frames, options) => {
+  const appRoot = options.appRoot;
   return frames.map((frame) => {
     const generated = normalizeFile(frame.generated.file, appRoot);
     const original = frame.original ? normalizeFile(frame.original.file, appRoot) : void 0;
@@ -250,10 +287,93 @@ var parseStack = (stack) => {
   return frames;
 };
 
+// src/repo-root/repo-root-from.ts
+import { existsSync } from "node:fs";
+import { dirname, join as join2, resolve as resolve2 } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+var isGitRoot = (dir) => existsSync(join2(dir, ".git"));
+var hasPackageJson = (dir) => existsSync(join2(dir, "package.json"));
+var repoRootFrom = (moduleUrl) => {
+  let current = resolve2(dirname(fileURLToPath2(moduleUrl)));
+  let packageRoot;
+  while (true) {
+    if (isGitRoot(current)) return current;
+    if (hasPackageJson(current)) packageRoot = current;
+    const parent = dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+  return packageRoot ?? resolve2(dirname(fileURLToPath2(moduleUrl)));
+};
+
+// src/repo-root/resolve-repo-root.ts
+var resolveRepoRoot = (options) => {
+  const repoRoot = options.repoRoot?.trim();
+  if (repoRoot) return repoRoot;
+  const moduleUrl = options.moduleUrl?.trim();
+  if (moduleUrl) return repoRootFrom(moduleUrl);
+  return void 0;
+};
+
+// src/repo-root/warn-repo-root-setup.ts
+var BUILD_OUTPUT_SEGMENTS = /* @__PURE__ */ new Set(["dist", "build", "out", ".next", "coverage"]);
+var warnedMissing = false;
+var warnedSuspicious = false;
+var BANNER = "======== [rasputin] WARNING";
+var looksLikeBuildOutputRoot = (root) => {
+  const posix = root.replaceAll("\\", "/").replace(/\/+$/, "");
+  return posix.split("/").some((segment) => BUILD_OUTPUT_SEGMENTS.has(segment));
+};
+var warnIfMissingRepoRoot = () => {
+  if (warnedMissing) return;
+  warnedMissing = true;
+  console.warn(
+    `
+
+${BANNER}: we don't know where your project is ========
+Rasputin needs to know which folder your app lives in so errors show
+the right file paths in the dashboard.
+
+Add this to RasputinInit (from the same file you call it in):
+
+  moduleUrl: import.meta.url
+
+Or set repoRoot to the folder you open in your editor.
+
+Nothing will be sent until this is set.
+======================================================================
+`
+  );
+};
+var warnIfSuspiciousRepoRoot = (root) => {
+  if (warnedSuspicious || !looksLikeBuildOutputRoot(root)) return;
+  warnedSuspicious = true;
+  console.warn(
+    `
+
+${BANNER}: this looks like a build folder, not your project ========
+Rasputin thinks your project is here:
+  ${root}
+
+That's usually compiled output (dist, build, .next, \u2026), not the folder
+you write code in. Error locations in the dashboard will be wrong.
+
+Point Rasputin at the folder you open in your editor.
+
+Easiest fix \u2014 from the file where you call RasputinInit:
+
+  moduleUrl: import.meta.url
+
+Or set repoRoot yourself.
+======================================================================
+`
+  );
+};
+
 // src/resolve-source-maps/resolve-source-maps.ts
 import { readFile } from "node:fs/promises";
-import { dirname, isAbsolute as isAbsolute2, join } from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
+import { dirname as dirname2, isAbsolute as isAbsolute2, join as join3 } from "node:path";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
 import { LEAST_UPPER_BOUND, originalPositionFor, TraceMap } from "@jridgewell/trace-mapping";
 var SOURCE_EXT2 = /\.(ts|tsx|mts|cts)$/i;
 var SOURCEMAP_COMMENT = /(?:\/\/[#@][ \t]*sourceMappingURL=([^\s'"]+)|\/\*[#@][ \t]*sourceMappingURL=([^\s*'"]+)[ \t]*\*\/)\s*$/;
@@ -261,7 +381,7 @@ var mapCache = /* @__PURE__ */ new Map();
 var toPath = (file) => {
   if (file.startsWith("file://")) {
     try {
-      return fileURLToPath2(file);
+      return fileURLToPath3(file);
     } catch {
       return file;
     }
@@ -302,7 +422,7 @@ var readMapPayload = async (generatedPath) => {
   if (comment?.startsWith("data:")) return decodeDataUrl(comment);
   if (comment) {
     try {
-      return await readFile(join(dirname(generatedPath), comment), "utf8");
+      return await readFile(join3(dirname2(generatedPath), comment), "utf8");
     } catch {
     }
   }
@@ -349,7 +469,7 @@ var resolveFrame = async (raw) => {
   return {
     ...base,
     original: {
-      file: isAbsolute2(pos.source) ? pos.source : join(dirname(generatedPath), pos.source),
+      file: isAbsolute2(pos.source) ? pos.source : join3(dirname2(generatedPath), pos.source),
       line: pos.line,
       column: pos.column ?? void 0,
       name: pos.name ?? void 0
@@ -369,7 +489,7 @@ var resolveSourceMaps = async (frames) => {
 
 // src/sdk-meta.ts
 var SDK_NAME = "@rasputin-ai/core";
-var SDK_VERSION = "0.1.4";
+var SDK_VERSION = "0.2.0";
 
 // src/suppression/identity-needs-message-template.ts
 var identityNeedsMessageTemplate = (type, code) => {
@@ -431,14 +551,22 @@ var RULES = [
     pattern: /\b(?=[a-z0-9]*[a-z])(?=[a-z0-9]*\d)[a-z0-9]{8,}\b/giu
   }
 ];
-var parameterizeMessage = (rawMessage) => {
-  if (rawMessage.length > MAX_INPUT_LENGTH) return rawMessage;
-  const normalized = rawMessage.normalize("NFKC").replace(/\r\n?/g, "\n").trim();
+var normalizeForIdentity = (normalized) => {
+  try {
+    return JSON.stringify(JSON.parse(normalized));
+  } catch {
+  }
   const lines = normalized.split("\n").filter((line) => line.trim());
   let result = lines.slice(0, 2).join("\n");
   if (result !== normalized) {
     result += "...";
   }
+  return result;
+};
+var parameterizeMessage = (rawMessage) => {
+  if (rawMessage.length > MAX_INPUT_LENGTH) return rawMessage;
+  const normalized = rawMessage.normalize("NFKC").replace(/\r\n?/g, "\n").trim();
+  let result = normalizeForIdentity(normalized);
   result = result.replace(/\b([A-Za-z_][\w.-]*)=(["'])(?:\\.|(?!\2).)*\2/gu, "$1=<string>");
   result = result.replace(/\b([A-Za-z_][\w.-]*)=(?:true|false)\b/giu, "$1=<bool>");
   for (const rule of RULES) {
@@ -454,21 +582,43 @@ var parameterizeMessage = (rawMessage) => {
 };
 
 // src/suppression/compute-burst-key.ts
+var FRAME_COUNT = 4;
 var preferredFile = (frame) => (frame.original ?? frame.generated).file;
-var frameBurstParts = (frames) => {
-  return frames.filter((frame) => frame.in_app).slice(0, 3).map((frame) => {
+var normalizeFunction = (raw) => {
+  if (!raw) return "";
+  const name = raw.trim();
+  if (name === "<anonymous>" || name === "anonymous") return "";
+  return name.replace(/^(async|new|get|set|bound)\s+/, "").replace(/^Object\./, "").replace(/\s+\[as .+\]$/, "");
+};
+var collapseConsecutive = (frames) => {
+  const out = [];
+  let previousKey = null;
+  for (const frame of frames) {
     const file = preferredFile(frame);
-    const fn = frame.function ?? frame.original?.name ?? "";
-    if (!frame.original && frame.generated.line !== void 0) {
-      return `${file}:${fn}:${frame.generated.line}:${frame.generated.column ?? 0}`;
+    const fn = normalizeFunction(frame.function ?? frame.original?.name);
+    const key = `${file}#${fn}`;
+    if (key !== previousKey) {
+      out.push(frame);
+      previousKey = key;
     }
+  }
+  return out;
+};
+var frameBurstParts = (frames) => {
+  const collapsed = collapseConsecutive(frames);
+  const inApp = collapsed.filter((frame) => frame.in_app);
+  const selected = (inApp.length > 0 ? inApp : collapsed).slice(0, FRAME_COUNT);
+  return selected.map((frame) => {
+    const file = preferredFile(frame);
+    const fn = normalizeFunction(frame.function ?? frame.original?.name);
     return `${file}:${fn}`;
   });
 };
 var computeBurstKey = (errorType, message, code, frames) => {
   const parts = frameBurstParts(frames);
-  let key = `${errorType}\0${parts.join("\0")}`;
-  if (identityNeedsMessageTemplate(errorType, code)) {
+  const codePart = code ?? "";
+  let key = `${errorType}\0${codePart}\0${parts.join("\0")}`;
+  if (parts.length === 0 || identityNeedsMessageTemplate(errorType, code)) {
     key += `\0${parameterizeMessage(message)}`;
   }
   return key;
@@ -579,7 +729,7 @@ var createSuppression = (options = {}) => {
     bucket.suppressed += 1;
     return { action: "suppress" };
   };
-  const takeSummaries = async (now = Date.now(), prepareSummary) => {
+  const drainSummaries = (now = Date.now()) => {
     const drafts = pending.splice(0, pending.length);
     for (const bucket of burstBuckets.values()) {
       if (bucket.suppressed > 0) {
@@ -587,22 +737,32 @@ var createSuppression = (options = {}) => {
         bucket.suppressed = 0;
       }
     }
+    return drafts.map((draft) => ({
+      summary: toSummary(draft, draft.identity),
+      rawFrames: draft.captureRawFrames
+    }));
+  };
+  const takeSummaries = async (now = Date.now(), prepareSummary) => {
+    const drafts = drainSummaries(now);
+    if (!prepareSummary) return drafts.map((draft) => draft.summary);
     const out = [];
     for (const draft of drafts) {
-      let identity = draft.identity;
-      if (prepareSummary && draft.captureRawFrames.length > 0) {
-        try {
-          const resolved = await prepareSummary(draft.captureRawFrames);
-          identity = { ...identity, ...resolved };
-        } catch {
-        }
+      if (draft.rawFrames.length === 0) {
+        out.push(draft.summary);
+        continue;
+      }
+      try {
+        const resolved = await prepareSummary(draft.rawFrames);
+        out.push({ ...draft.summary, ...resolved });
+      } catch {
+        out.push(draft.summary);
       }
-      out.push(toSummary(draft, identity));
     }
     return out;
   };
   return {
     decide,
+    drainSummaries,
     takeSummaries,
     /** Test helper — number of active burst buckets. */
     size: () => burstBuckets.size
@@ -611,7 +771,21 @@ var createSuppression = (options = {}) => {
 
 // src/transport/send-batch.ts
 import { gzipSync } from "node:zlib";
-var sleep = (ms) => new Promise((resolve2) => setTimeout(resolve2, ms));
+var sleep = (ms, signal) => new Promise((resolve3) => {
+  if (signal?.aborted) {
+    resolve3();
+    return;
+  }
+  const timer = setTimeout(resolve3, ms);
+  signal?.addEventListener(
+    "abort",
+    () => {
+      clearTimeout(timer);
+      resolve3();
+    },
+    { once: true }
+  );
+});
 var backoffMs = (attempt) => {
   const base = Math.min(3e4, 500 * 2 ** attempt);
   return Math.floor(base * (0.5 + Math.random()));
@@ -634,6 +808,7 @@ var sendBatch = async (options) => {
   }
   if (options.sdkVersion) payload.sdk_version = options.sdkVersion;
   if (options.sdkName) payload.sdk_name = options.sdkName;
+  if (options.idempotencyKey) payload.idempotency_key = options.idempotencyKey;
   const json = JSON.stringify(payload);
   const headers = {
     Authorization: `Bearer ${options.projectApiKey}`,
@@ -661,16 +836,16 @@ var sendBatch = async (options) => {
       if (response.status === 429) {
         if (attempt === options.maxRetries) return "failed";
         const wait = retryAfterMs(response) ?? backoffMs(attempt);
-        await sleep(wait);
+        await sleep(wait, options.signal);
         continue;
       }
       if (response.status >= 400 && response.status < 500) return "dropped";
       if (attempt === options.maxRetries) return "failed";
-      await sleep(backoffMs(attempt));
+      await sleep(backoffMs(attempt), options.signal);
     } catch {
       if (options.signal?.aborted) return "failed";
       if (attempt === options.maxRetries) return "failed";
-      await sleep(backoffMs(attempt));
+      await sleep(backoffMs(attempt), options.signal);
     }
   }
   return "failed";
@@ -725,6 +900,20 @@ var DEFAULTS2 = {
   maxRetries: 5,
   installSignalHandlers: true
 };
+var removeProcessListener = process.off.bind(process);
+var holdProcessExitUntil = (done) => {
+  const nativeExit = process.exit.bind(process);
+  let heldCode;
+  const restore = () => {
+    process.exit = nativeExit;
+    if (heldCode !== void 0) nativeExit(heldCode);
+  };
+  const holdExit = ((code) => {
+    heldCode = code ?? 0;
+  });
+  process.exit = holdExit;
+  void done.finally(restore);
+};
 var createTransport = (options) => {
   const enabled = options.enabled ?? DEFAULTS2.enabled;
   const batchSize = options.batchSize ?? DEFAULTS2.batchSize;
@@ -736,6 +925,8 @@ var createTransport = (options) => {
   let timer;
   let flushing;
   let closed = false;
+  let shuttingDown = false;
+  let retryBatch = null;
   const schedule = () => {
     if (timer || !enabled || closed) return;
     timer = setInterval(() => {
@@ -748,9 +939,19 @@ var createTransport = (options) => {
     clearInterval(timer);
     timer = void 0;
   };
+  const prepareSummary = async (item) => {
+    if (!options.prepareSummary || item.rawFrames.length === 0) return item.summary;
+    try {
+      const resolved = await options.prepareSummary(item.rawFrames);
+      return { ...item.summary, ...resolved };
+    } catch {
+      return item.summary;
+    }
+  };
   const flush = async (timeoutMs = 1e4) => {
     if (!enabled || closed) {
       queue.clear();
+      retryBatch = null;
       return;
     }
     if (flushing) return flushing;
@@ -758,15 +959,17 @@ var createTransport = (options) => {
       const controller = new AbortController();
       const timeout = timeoutMs > 0 ? setTimeout(() => controller.abort(), timeoutMs) : void 0;
       try {
-        while (queue.size() > 0) {
+        while (queue.size() > 0 || retryBatch) {
           if (controller.signal.aborted) break;
-          const batch = queue.drain(batchSize);
+          const batch = retryBatch?.items ?? queue.drain(batchSize);
+          const idempotencyKey = retryBatch?.idempotencyKey ?? crypto.randomUUID();
+          retryBatch = null;
           if (batch.length === 0) break;
           const events = [];
           const summaries = [];
           for (const item of batch) {
             if (item.kind === "summary") {
-              summaries.push(item.summary);
+              summaries.push(await prepareSummary(item));
               continue;
             }
             if (options.prepareEvent && item.rawFrames.length > 0) {
@@ -789,6 +992,7 @@ var createTransport = (options) => {
             projectApiKey: options.projectApiKey,
             events,
             summaries,
+            idempotencyKey,
             sdkVersion: options.sdkVersion,
             sdkName: options.sdkName,
             gzipThresholdBytes,
@@ -797,13 +1001,13 @@ var createTransport = (options) => {
             signal: controller.signal
           });
           if (result === "failed") {
-            for (const item of batch) queue.enqueue(item);
+            retryBatch = { items: batch, idempotencyKey };
             break;
           }
         }
       } finally {
         if (timeout) clearTimeout(timeout);
-        if (queue.size() === 0) stopTimer();
+        if (queue.size() === 0 && !retryBatch) stopTimer();
         flushing = void 0;
       }
     })();
@@ -815,38 +1019,46 @@ var createTransport = (options) => {
     schedule();
     if (queue.size() >= batchSize) void flush();
   };
-  const enqueueSummary = (summary) => {
+  const enqueueSummary = (summary, rawFrames = []) => {
     if (!enabled || closed) return;
-    queue.enqueue({ kind: "summary", summary, priority: "summary" });
+    queue.enqueue({ kind: "summary", summary, priority: "summary", rawFrames });
     schedule();
     if (queue.size() >= batchSize) void flush();
   };
+  const onBeforeExit = () => {
+    if (closed || shuttingDown) return;
+    if (queue.size() === 0 && !retryBatch && !flushing) return;
+    void flush(2e3).catch(() => {
+    });
+  };
   const onSignal = () => {
-    try {
-      void flush(2e3);
-    } catch {
-    }
+    if (shuttingDown) return;
+    shuttingDown = true;
+    stopTimer();
+    holdProcessExitUntil(flush(2e3).catch(() => {
+    }));
   };
   if (enabled && (options.installSignalHandlers ?? DEFAULTS2.installSignalHandlers)) {
-    process.on("beforeExit", onSignal);
+    process.on("beforeExit", onBeforeExit);
     process.on("SIGTERM", onSignal);
     process.on("SIGINT", onSignal);
   }
   const close = async () => {
-    closed = true;
     stopTimer();
-    process.off("beforeExit", onSignal);
-    process.off("SIGTERM", onSignal);
-    process.off("SIGINT", onSignal);
+    removeProcessListener("beforeExit", onBeforeExit);
+    removeProcessListener("SIGTERM", onSignal);
+    removeProcessListener("SIGINT", onSignal);
     await flush(2e3);
+    closed = true;
     queue.clear();
+    retryBatch = null;
   };
   return {
     enqueue,
     enqueueSummary,
     flush,
     close,
-    size: () => queue.size()
+    size: () => queue.size() + (retryBatch?.items.length ?? 0)
   };
 };
 
@@ -888,12 +1100,6 @@ var warnPartialResolution = () => {
     "[rasputin] Source map paths could not be normalized to the repo root; fingerprinting may be degraded"
   );
 };
-var prepareResolvedEvent = (event, normalized, resolution) => {
-  const stackFrames = framesToStackFrames(normalized);
-  const finalResolution = finalizeResolution(resolution, stackFrames);
-  if (finalResolution === "partial") warnPartialResolution();
-  return withResolvedFrames(event, normalized, finalResolution);
-};
 var toResolvedFrames = (raw) => raw.map((frame) => ({
   generated: { file: frame.file, line: frame.line, column: frame.column },
   ...frame.function ? { function: frame.function } : {}
@@ -909,7 +1115,35 @@ var createClient = (options, hooks = {}) => {
     const release = detectRelease({ release: options.release });
     const environment = options.environment;
     const { ingestUrl, deployUrl } = resolveEndpointUrls(options.apiUrl);
-    const repoRoot = options.repoRoot;
+    const repoRoot = resolveRepoRoot(options);
+    if (!repoRoot) {
+      warnIfMissingRepoRoot();
+      return noopClient();
+    }
+    warnIfSuspiciousRepoRoot(repoRoot);
+    const MAX_STACK_RESOLVE_CACHE = 32;
+    const stackResolveCache = /* @__PURE__ */ new Map();
+    const stackCacheKey = (rawFrames) => rawFrames.map((frame) => `${frame.file}\0${frame.line}\0${frame.column}\0${frame.function ?? ""}`).join("\n");
+    const resolveStack = async (rawFrames) => {
+      const key = stackCacheKey(rawFrames);
+      const cached = stackResolveCache.get(key);
+      if (cached) return cached;
+      const pending = (async () => {
+        const { frames, resolution, unresolvedGenerated } = await resolveSourceMaps(rawFrames);
+        warnUnresolvedMaps(unresolvedGenerated);
+        const normalized = normalizeFrames(frames, { appRoot: repoRoot });
+        const stack_frames = framesToStackFrames(normalized);
+        const finalResolution = finalizeResolution(resolution, stack_frames);
+        if (finalResolution === "partial") warnPartialResolution();
+        return { frames: normalized, stack_frames, resolution: finalResolution };
+      })();
+      stackResolveCache.set(key, pending);
+      if (stackResolveCache.size > MAX_STACK_RESOLVE_CACHE) {
+        const oldest = stackResolveCache.keys().next().value;
+        if (oldest !== void 0) stackResolveCache.delete(oldest);
+      }
+      return pending;
+    };
     const transport = createTransport({
       ingestUrl,
       projectApiKey,
@@ -919,10 +1153,12 @@ var createClient = (options, hooks = {}) => {
       sdkVersion: hooks.sdkVersion ?? SDK_VERSION,
       sdkName: hooks.sdkName ?? SDK_NAME,
       prepareEvent: async ({ event, rawFrames }) => {
-        const { frames, resolution, unresolvedGenerated } = await resolveSourceMaps(rawFrames);
-        warnUnresolvedMaps(unresolvedGenerated);
-        const normalized = normalizeFrames(frames, { appRoot: repoRoot });
-        return prepareResolvedEvent(event, normalized, resolution);
+        const prepared = await resolveStack(rawFrames);
+        return withResolvedFrames(event, prepared.frames, prepared.resolution);
+      },
+      prepareSummary: async (rawFrames) => {
+        const prepared = await resolveStack(rawFrames);
+        return { stack_frames: prepared.stack_frames, resolution: prepared.resolution };
       }
     });
     const suppression = createSuppression();
@@ -966,30 +1202,21 @@ var createClient = (options, hooks = {}) => {
       } catch {
       }
     };
+    const enqueuePendingSummaries = () => {
+      for (const { summary, rawFrames } of suppression.drainSummaries()) {
+        transport.enqueueSummary(summary, rawFrames);
+      }
+    };
     const flush = async (timeoutMs) => {
       try {
-        const summaries = await suppression.takeSummaries(Date.now(), async (raw) => {
-          const { frames, resolution, unresolvedGenerated } = await resolveSourceMaps(raw);
-          warnUnresolvedMaps(unresolvedGenerated);
-          const normalized = normalizeFrames(frames, { appRoot: repoRoot });
-          const stack_frames = framesToStackFrames(normalized);
-          const finalResolution = finalizeResolution(resolution, stack_frames);
-          if (finalResolution === "partial") warnPartialResolution();
-          return {
-            stack_frames,
-            resolution: finalResolution
-          };
-        });
-        for (const summary of summaries) {
-          transport.enqueueSummary(summary);
-        }
+        enqueuePendingSummaries();
         await transport.flush(timeoutMs);
       } catch {
       }
     };
     const close = async () => {
       try {
-        await flush(2e3);
+        enqueuePendingSummaries();
         await transport.close();
       } catch {
       }
@@ -1009,5 +1236,6 @@ export {
   isClientEnabled,
   normalizeFrames,
   parseStack,
+  repoRootFrom,
   resolveSourceMaps
 };

package/dist/normalize-frames/normalize-frames.d.ts

@@ -1,7 +1,7 @@
 import type { ResolvedFrame } from '../resolve-source-maps/resolved-frame';
 type NormalizeFramesOptions = {
-    /** Runtime project root — stripped to produce repo-relative paths. Default: process.cwd() */
-    appRoot?: string;
+    /** Git/monorepo root — stripped to produce repo-relative paths. */
+    appRoot: string;
 };
 export type Frame = {
     generated: {
@@ -19,6 +19,6 @@ export type Frame = {
     in_app: boolean;
 };
 /** Normalize resolved frames: repo-relative paths + in_app (runs after source-map resolution). */
-export declare const normalizeFrames: (frames: ResolvedFrame[], options?: NormalizeFramesOptions) => Frame[];
+export declare const normalizeFrames: (frames: ResolvedFrame[], options: NormalizeFramesOptions) => Frame[];
 export {};
 //# sourceMappingURL=normalize-frames.d.ts.map

package/dist/normalize-frames/normalize-frames.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-frames.d.ts","sourceRoot":"","sources":["../../src/normalize-frames/normalize-frames.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAE3E,KAAK,sBAAsB,GAAG;IAC7B,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IACnB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CAChB,CAAC;AAgDF,kGAAkG;AAClG,eAAO,MAAM,eAAe,GAC3B,QAAQ,aAAa,EAAE,EACvB,UAAS,sBAA2B,KAClC,KAAK,EA2BP,CAAC"}
+{"version":3,"file":"normalize-frames.d.ts","sourceRoot":"","sources":["../../src/normalize-frames/normalize-frames.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAE3E,KAAK,sBAAsB,GAAG;IAC7B,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IACnB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CAChB,CAAC;AAgDF,kGAAkG;AAClG,eAAO,MAAM,eAAe,GAC3B,QAAQ,aAAa,EAAE,EACvB,SAAS,sBAAsB,KAC7B,KAAK,EA2BP,CAAC"}

package/dist/repo-root/repo-root-from.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Resolve the repository (or package) root from a caller module URL.
+ *
+ * Walks up from the module file looking for a `.git` directory first (monorepo root).
+ * Falls back to the topmost `package.json` found while walking up.
+ */
+export declare const repoRootFrom: (moduleUrl: string) => string;
+//# sourceMappingURL=repo-root-from.d.ts.map

package/dist/repo-root/repo-root-from.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-root-from.d.ts","sourceRoot":"","sources":["../../src/repo-root/repo-root-from.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,KAAG,MAchD,CAAC"}

package/dist/repo-root/resolve-repo-root.d.ts

@@ -0,0 +1,6 @@
+/** Prefer an explicit root; otherwise walk up from the caller module URL. */
+export declare const resolveRepoRoot: (options: {
+    repoRoot?: string;
+    moduleUrl?: string;
+}) => string | undefined;
+//# sourceMappingURL=resolve-repo-root.d.ts.map

package/dist/repo-root/resolve-repo-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-repo-root.d.ts","sourceRoot":"","sources":["../../src/repo-root/resolve-repo-root.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,eAAO,MAAM,eAAe,GAAI,SAAS;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,KAAG,MAAM,GAAG,SAMZ,CAAC"}

package/dist/repo-root/warn-repo-root-setup.d.ts

@@ -0,0 +1,5 @@
+/** Reset per-process warning state (for testing only). */
+export declare const resetRepoRootSetupWarnings: () => void;
+export declare const warnIfMissingRepoRoot: () => void;
+export declare const warnIfSuspiciousRepoRoot: (root: string) => void;
+//# sourceMappingURL=warn-repo-root-setup.d.ts.map

package/dist/repo-root/warn-repo-root-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warn-repo-root-setup.d.ts","sourceRoot":"","sources":["../../src/repo-root/warn-repo-root-setup.ts"],"names":[],"mappings":"AASA,0DAA0D;AAC1D,eAAO,MAAM,0BAA0B,YAGtC,CAAC;AAOF,eAAO,MAAM,qBAAqB,YAajC,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,MAAM,MAAM,SAcpD,CAAC"}

package/dist/sdk-meta.d.ts

@@ -1,4 +1,4 @@
 /** Generated by packages/sdk/scripts/generate-sdk-meta.ts — do not edit. */
 export declare const SDK_NAME = "@rasputin-ai/core";
-export declare const SDK_VERSION = "0.1.4";
+export declare const SDK_VERSION = "0.2.0";
 //# sourceMappingURL=sdk-meta.d.ts.map

package/dist/suppression/compute-burst-key.d.ts

@@ -1,7 +1,3 @@
 import type { Frame } from '../normalize-frames/normalize-frames';
-/**
- * In-process burst bucket id — aligned with server fingerprint boundaries.
- * For generic `Error`, includes the same parameterized message template the API uses.
- */
 export declare const computeBurstKey: (errorType: string, message: string, code: string | null | undefined, frames: Frame[]) => string;
 //# sourceMappingURL=compute-burst-key.d.ts.map

package/dist/suppression/compute-burst-key.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compute-burst-key.d.ts","sourceRoot":"","sources":["../../src/suppression/compute-burst-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sCAAsC,CAAC;AAoBlE;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC3B,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,QAAQ,KAAK,EAAE,KACb,MAOF,CAAC"}
+{"version":3,"file":"compute-burst-key.d.ts","sourceRoot":"","sources":["../../src/suppression/compute-burst-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sCAAsC,CAAC;AA4DlE,eAAO,MAAM,eAAe,GAC3B,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,QAAQ,KAAK,EAAE,KACb,MAUF,CAAC"}

package/dist/suppression/create-suppression.d.ts

@@ -1,10 +1,17 @@
+import type { RawFrame } from '../parse-stack/raw-frame';
 import type { CreateSuppressionOptions, IngestSummary, PrepareSummaryFrames, SuppressionDecideInput, SuppressionDecideResult } from './suppression-types';
 /**
- * Local burst suppression (network protection). Burst keys mirror server fingerprint
- * boundaries for generic `Error` via parameterized message templates.
+ * Local burst suppression (network protection).
+ * ⚠️ FINGERPRINT IDENTITY LOCKSTEP — computeBurstKey must stay on the same
+ * recipe as server createFingerprintIdentity. Drain does not remap; transport
+ * resolves source maps at send so summary stack_frames match the exemplar.
  */
 export declare const createSuppression: (options?: CreateSuppressionOptions) => {
     decide: (input: SuppressionDecideInput) => SuppressionDecideResult;
+    drainSummaries: (now?: number) => {
+        summary: IngestSummary;
+        rawFrames: RawFrame[];
+    }[];
     takeSummaries: (now?: number, prepareSummary?: PrepareSummaryFrames) => Promise<IngestSummary[]>;
     /** Test helper — number of active burst buckets. */
     size: () => number;

package/dist/suppression/create-suppression.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-suppression.d.ts","sourceRoot":"","sources":["../../src/suppression/create-suppression.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,wBAAwB,EACxB,aAAa,EACb,oBAAoB,EAEpB,sBAAsB,EACtB,uBAAuB,EACvB,MAAM,qBAAqB,CAAC;AAyC7B;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAS,wBAA6B;oBAmDhD,sBAAsB,KAAG,uBAAuB;mDAiErD,oBAAoB,KACnC,OAAO,CAAC,aAAa,EAAE,CAAC;IA4B1B,oDAAoD;;CAGrD,CAAC"}
+{"version":3,"file":"create-suppression.d.ts","sourceRoot":"","sources":["../../src/suppression/create-suppression.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,KAAK,EACX,wBAAwB,EACxB,aAAa,EACb,oBAAoB,EAEpB,sBAAsB,EACtB,uBAAuB,EACvB,MAAM,qBAAqB,CAAC;AAyC7B;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAS,wBAA6B;oBAmDhD,sBAAsB,KAAG,uBAAuB;sCAgEpE;QAAE,OAAO,EAAE,aAAa,CAAC;QAAC,SAAS,EAAE,QAAQ,EAAE,CAAA;KAAE,EAAE;mDAsBpC,oBAAoB,KACnC,OAAO,CAAC,aAAa,EAAE,CAAC;IA0B1B,oDAAoD;;CAGrD,CAAC"}

package/dist/suppression/identity-needs-message-template.d.ts

@@ -1,6 +1,8 @@
 /**
- * Keep in sync with `packages/~core/lib/identity-needs-message-template.ts`.
+ * ⚠️ FINGERPRINT IDENTITY LOCKSTEP — byte-identical to
+ * `packages/~core/lib/identity-needs-message-template.ts`.
  * SDK copy — no ~core dependency at publish time.
+ * Changing one side splits burst buckets from server groups.
  */
 export declare const identityNeedsMessageTemplate: (type: string, code: string | null | undefined) => boolean;
 //# sourceMappingURL=identity-needs-message-template.d.ts.map

package/dist/suppression/identity-needs-message-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identity-needs-message-template.d.ts","sourceRoot":"","sources":["../../src/suppression/identity-needs-message-template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GACxC,MAAM,MAAM,EACZ,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,KAC7B,OAGF,CAAC"}
+{"version":3,"file":"identity-needs-message-template.d.ts","sourceRoot":"","sources":["../../src/suppression/identity-needs-message-template.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GACxC,MAAM,MAAM,EACZ,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,KAC7B,OAGF,CAAC"}

package/dist/suppression/parameterize-message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parameterize-message.d.ts","sourceRoot":"","sources":["../../src/suppression/parameterize-message.ts"],"names":[],"mappings":"AAoEA,eAAO,MAAM,mBAAmB,GAAI,YAAY,MAAM,KAAG,MA8BxD,CAAC"}
+{"version":3,"file":"parameterize-message.d.ts","sourceRoot":"","sources":["../../src/suppression/parameterize-message.ts"],"names":[],"mappings":"AAsFA,eAAO,MAAM,mBAAmB,GAAI,YAAY,MAAM,KAAG,MAyBxD,CAAC"}

package/dist/transport/create-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-transport.d.ts","sourceRoot":"","sources":["../../src/transport/create-transport.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAY3E,eAAO,MAAM,eAAe,GAAI,SAAS,sBAAsB,KAAG,SA+IjE,CAAC"}
+{"version":3,"file":"create-transport.d.ts","sourceRoot":"","sources":["../../src/transport/create-transport.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAe,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAoCxF,eAAO,MAAM,eAAe,GAAI,SAAS,sBAAsB,KAAG,SAsKjE,CAAC"}

package/dist/transport/send-batch.d.ts

@@ -6,6 +6,7 @@ type SendBatchOptions = {
     projectApiKey: string;
     events: IngestEvent[];
     summaries?: IngestSummary[];
+    idempotencyKey?: string;
     sdkVersion?: string;
     sdkName?: string;
     gzipThresholdBytes: number;

package/dist/transport/send-batch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"send-batch.d.ts","sourceRoot":"","sources":["../../src/transport/send-batch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,KAAK,gBAAgB,GAAG;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAkBF,iGAAiG;AACjG,eAAO,MAAM,SAAS,GACrB,SAAS,gBAAgB,KACvB,OAAO,CAAC,IAAI,GAAG,SAAS,GAAG,QAAQ,CAoErC,CAAC"}
+{"version":3,"file":"send-batch.d.ts","sourceRoot":"","sources":["../../src/transport/send-batch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,KAAK,gBAAgB,GAAG;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAkCF,iGAAiG;AACjG,eAAO,MAAM,SAAS,GACrB,SAAS,gBAAgB,KACvB,OAAO,CAAC,IAAI,GAAG,SAAS,GAAG,QAAQ,CAsErC,CAAC"}

package/dist/transport/transport-types.d.ts

@@ -1,6 +1,6 @@
 import type { IngestEvent } from '../create-ingest-event/create-ingest-event-types';
 import type { RawFrame } from '../parse-stack/raw-frame';
-import type { IngestSummary } from '../suppression/suppression-types';
+import type { IngestSummary, PrepareSummaryFrames } from '../suppression/suppression-types';
 /**
  * Drop order when the queue is full: repeat exemplars first, then summaries,
  * protect first-sighting last. Summaries carry tens of thousands of counts in
@@ -17,6 +17,8 @@ export type QueuedEvent = {
     kind: 'summary';
     summary: IngestSummary;
     priority: 'summary';
+    /** Same capture-time frames as the exemplar — remapped at send. */
+    rawFrames: RawFrame[];
 };
 export type TransportFetch = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
 export type PrepareQueuedEvent = (item: {
@@ -39,12 +41,14 @@ export type CreateTransportOptions = {
     installSignalHandlers?: boolean;
     /** Rewrite events before send (e.g. source-map resolve + re-normalize). */
     prepareEvent?: PrepareQueuedEvent;
+    /** Rewrite summary stacks with the same resolver as events. */
+    prepareSummary?: PrepareSummaryFrames;
     sdkVersion?: string;
     sdkName?: string;
 };
 export type Transport = {
     enqueue: (event: IngestEvent, priority?: 'first' | 'repeat', rawFrames?: RawFrame[]) => void;
-    enqueueSummary: (summary: IngestSummary) => void;
+    enqueueSummary: (summary: IngestSummary, rawFrames?: RawFrame[]) => void;
     flush: (timeoutMs?: number) => Promise<void>;
     close: () => Promise<void>;
     /** Test helper */

package/dist/transport/transport-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport-types.d.ts","sourceRoot":"","sources":["../../src/transport/transport-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AACpF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/D,MAAM,MAAM,WAAW,GACpB;IACA,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC7B,6DAA6D;IAC7D,SAAS,EAAE,QAAQ,EAAE,CAAC;CACrB,GACD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG,CAC5B,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,CAAC,EAAE,WAAW,KACd,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE;IACvC,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACtB,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAE3B,MAAM,MAAM,sBAAsB,GAAG;IACpC,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,uEAAuE;IACvE,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACvB,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,EAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;IAC7F,cAAc,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IACjD,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,kBAAkB;IAClB,IAAI,EAAE,MAAM,MAAM,CAAC;CACnB,CAAC"}
+{"version":3,"file":"transport-types.d.ts","sourceRoot":"","sources":["../../src/transport/transport-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AACpF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAE5F;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/D,MAAM,MAAM,WAAW,GACpB;IACA,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC7B,6DAA6D;IAC7D,SAAS,EAAE,QAAQ,EAAE,CAAC;CACrB,GACD;IACA,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,SAAS,CAAC;IACpB,mEAAmE;IACnE,SAAS,EAAE,QAAQ,EAAE,CAAC;CACrB,CAAC;AAEL,MAAM,MAAM,cAAc,GAAG,CAC5B,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,CAAC,EAAE,WAAW,KACd,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE;IACvC,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACtB,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAE3B,MAAM,MAAM,sBAAsB,GAAG;IACpC,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,uEAAuE;IACvE,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,+DAA+D;IAC/D,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACvB,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,EAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;IAC7F,cAAc,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;IACzE,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,kBAAkB;IAClB,IAAI,EAAE,MAAM,MAAM,CAAC;CACnB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rasputin-ai/core",
-	"version": "0.1.4",
+	"version": "0.2.0",
 	"description": "Core error capture, stack parsing, and ingest transport for Rasputin AI.",
 	"type": "module",
 	"exports": {