@debugkit/ingest 0.0.0-stage → 0.2.0

package/dist/chunk-6C67KV5S.js

@@ -0,0 +1,148 @@
+// src/index.ts
+import { Envelope, parseStack } from "@debugkit/schema";
+
+// src/fingerprint.ts
+import { createHash } from "crypto";
+function normaliseMessage(msg) {
+  return msg.replace(/https?:\/\/\S+/g, "<url>").replace(/\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/gi, "<uuid>").replace(/\b[0-9a-f]{16,}\b/gi, "<hex>").replace(/[\w.+-]+@[\w-]+\.[\w.]+/g, "<email>").replace(/\d+(\.\d+)?/g, "<n>").replace(/(["'`]).*?\1/g, "<str>").trim().slice(0, 300);
+}
+function normaliseFile(file) {
+  if (!file) return "";
+  let f = file.replace(/\/\/&.*$/, "").replace(/[?#].*$/, "").replace(/^[a-z]+:\/\/[^/]+/i, "");
+  if (/\.(?:js)?bundle$/.test(f)) return f.replace(/^.*\//, "");
+  for (const root of ["/src/", "/lib/", "/app/"]) {
+    const i = f.lastIndexOf(root);
+    if (i >= 0) {
+      f = f.slice(i + 1);
+      break;
+    }
+  }
+  return f.replace(/\.[0-9a-f]{6,}\./g, ".");
+}
+function topInAppFrame(frames) {
+  return frames?.find((f) => f.inApp !== false && f.file) ?? frames?.[0];
+}
+function culpritOf(e) {
+  const f = topInAppFrame(e.error.frames);
+  if (!f) return void 0;
+  const loc = normaliseFile(f.file) + (f.line ? `:${f.line}` : "");
+  return f.fn ? `${f.fn} (${loc})` : loc;
+}
+function fingerprint(e) {
+  const f = topInAppFrame(e.error.frames);
+  const r = e.request;
+  const where = r ? `${r.method.toUpperCase()} ${r.url} ${r.status ? `${Math.floor(r.status / 100)}xx` : "failed"}` : f ? `${f.fn ?? "?"}@${normaliseFile(f.file)}` : normaliseMessage(e.error.message);
+  return createHash("sha256").update([e.error.name, where, e.flow ?? ""].join("|")).digest("hex").slice(0, 24);
+}
+function titleOf(e) {
+  return `${e.error.name}: ${e.error.message}`.slice(0, 200);
+}
+
+// src/index.ts
+function parseIngestKeys(raw) {
+  const out = {};
+  for (const pair of (raw ?? "").split(",").map((s) => s.trim()).filter(Boolean)) {
+    const [key, app] = pair.split(":");
+    if (key && app) out[key] = app;
+  }
+  return out;
+}
+var dayOf = (iso) => iso.slice(0, 10);
+function sanitiseTs(ts, now) {
+  const t = Date.parse(ts);
+  const n = now.getTime();
+  if (Number.isNaN(t) || t > n + 5 * 6e4 || t < n - 7 * 864e5) return now.toISOString();
+  return new Date(t).toISOString();
+}
+function enrich(ctx) {
+  return {
+    ...ctx,
+    os: { ...ctx.os, name: ctx.os.name.toLowerCase() },
+    runtime: { ...ctx.runtime, name: ctx.runtime.name.toLowerCase() }
+  };
+}
+async function ingest(rawBody, ingestKey, opts) {
+  const now = opts.now?.() ?? /* @__PURE__ */ new Date();
+  if (!ingestKey || !opts.keys[ingestKey]) return { status: 401, body: { ok: false, error: "invalid ingest key" } };
+  if (Buffer.byteLength(rawBody) > (opts.maxBytes ?? 512 * 1024)) return { status: 413, body: { ok: false, error: "payload too large" } };
+  let json;
+  try {
+    json = JSON.parse(rawBody);
+  } catch {
+    return { status: 400, body: { ok: false, error: "invalid json" } };
+  }
+  const parsed = Envelope.safeParse(json);
+  if (!parsed.success) return { status: 400, body: { ok: false, error: "invalid envelope", issues: parsed.error.flatten() } };
+  const env = parsed.data;
+  const app = env.context.app.id;
+  if (opts.keys[ingestKey] !== app && opts.keys[ingestKey] !== "*") return { status: 403, body: { ok: false, error: `key not allowed for app ${app}` } };
+  const context = enrich(env.context);
+  const receivedAt = now.toISOString();
+  const stored = [];
+  const rollups = [];
+  const issues = /* @__PURE__ */ new Map();
+  for (const raw of env.events) {
+    const event = { ...raw, ts: sanitiseTs(raw.ts, now) };
+    if (event.type === "error" && !event.error.frames?.length && event.error.stack) event.error.frames = parseStack(event.error.stack);
+    const day = dayOf(event.ts);
+    if (event.type === "session") {
+      rollups.push({ app, day, dimension: "session", key: `${context.app.version || "unknown"}|${event.status}`, kind: "event", by: 1 });
+      continue;
+    }
+    const kind = event.type === "error" ? "error" : "event";
+    const inc = (dimension, key) => rollups.push({ app, day, dimension, key: key || "unknown", kind, by: 1 });
+    let fp;
+    if (event.type === "error") {
+      fp = fingerprint(event);
+      const cur = issues.get(fp);
+      const se = { app, day, fingerprint: fp, event, context, user: env.user, sessionId: env.session.id, receivedAt };
+      issues.set(fp, {
+        app,
+        fingerprint: fp,
+        title: titleOf(event),
+        culprit: culpritOf(event),
+        flow: event.flow,
+        by: (cur?.by ?? 0) + 1,
+        ts: cur && cur.ts > event.ts ? cur.ts : event.ts,
+        firstTs: cur && cur.firstTs < event.ts ? cur.firstTs : event.ts,
+        lastEvent: cur && cur.ts > event.ts ? cur.lastEvent : se
+      });
+      inc("issue", fp);
+      if (event.request) inc("endpoint", `${event.request.method.toUpperCase()} ${event.request.url}`);
+      rollups.push({ app, day: event.ts.slice(0, 13), dimension: "issueHour", key: fp, kind, by: 1 });
+    }
+    inc("total", "all");
+    inc("flow", event.flow ?? "untagged");
+    inc("os", `${context.os.name} ${context.os.version ?? ""}`.trim());
+    inc("appVersion", context.app.version);
+    inc("deviceModel", context.device.model);
+    if (event.type === "event" && event.outcome && event.flow) inc("flowOutcome", `${event.flow}|${event.outcome}`);
+    stored.push({ app, day, fingerprint: fp, event, context, user: env.user, sessionId: env.session.id, receivedAt });
+  }
+  await opts.store.registerApp(app);
+  await Promise.all([
+    stored.length ? opts.store.writeEvents(stored) : void 0,
+    opts.store.upsertIssues([...issues.values()]),
+    opts.store.incrementRollups(rollups)
+  ]);
+  return { status: 202, body: { ok: true, accepted: env.events.length } };
+}
+var CORS_HEADERS = {
+  "access-control-allow-origin": "*",
+  "access-control-allow-methods": "POST, OPTIONS",
+  "access-control-allow-headers": "content-type, x-debug-key",
+  "access-control-max-age": "86400"
+};
+
+export {
+  normaliseMessage,
+  normaliseFile,
+  topInAppFrame,
+  culpritOf,
+  fingerprint,
+  titleOf,
+  parseIngestKeys,
+  ingest,
+  CORS_HEADERS
+};
+//# sourceMappingURL=chunk-6C67KV5S.js.map

package/dist/chunk-6C67KV5S.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/fingerprint.ts"],"sourcesContent":["import { Envelope, parseStack, type Context, type Event, type RollupIncrement, type StoredEvent } from \"@debugkit/schema\";\nimport type { IssueUpsert, WriteStore } from \"@debugkit/adapters\";\nimport { culpritOf, fingerprint, titleOf } from \"./fingerprint\";\n\nexport * from \"./fingerprint\";\n\nexport interface IngestOptions {\n  store: WriteStore;\n  /**\n   * Map of public ingest key → app id it may write to. A key can't write to another app.\n   * The app id \"*\" lets a key write to any app (local development only).\n   * Parse from env with `parseIngestKeys(process.env.DEBUG_INGEST_KEYS)`.\n   */\n  keys: Record<string, string>;\n  /** Hard cap on accepted payload size in bytes. Default 512 KB. */\n  maxBytes?: number;\n  now?: () => Date;\n}\n\nexport interface IngestResult {\n  status: number;\n  body: { ok: boolean; accepted?: number; error?: string; issues?: unknown };\n}\n\n/** \"pk_abc:megaton-native,pk_def:other-app\" → { pk_abc: \"megaton-native\", ... } */\nexport function parseIngestKeys(raw: string | undefined): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const pair of (raw ?? \"\").split(\",\").map((s) => s.trim()).filter(Boolean)) {\n    const [key, app] = pair.split(\":\");\n    if (key && app) out[key] = app;\n  }\n  return out;\n}\n\nconst dayOf = (iso: string) => iso.slice(0, 10);\n\n/** Clamp client clocks: events claiming to be from the future or very old are pinned to receipt time. */\nfunction sanitiseTs(ts: string, now: Date): string {\n  const t = Date.parse(ts);\n  const n = now.getTime();\n  if (Number.isNaN(t) || t > n + 5 * 60_000 || t < n - 7 * 86_400_000) return now.toISOString();\n  return new Date(t).toISOString();\n}\n\nfunction enrich(ctx: Context): Context {\n  return {\n    ...ctx,\n    os: { ...ctx.os, name: ctx.os.name.toLowerCase() },\n    runtime: { ...ctx.runtime, name: ctx.runtime.name.toLowerCase() },\n  };\n}\n\n/** Platform-agnostic ingest. Wrap with ./firebase or ./lambda to deploy. */\nexport async function ingest(rawBody: string, ingestKey: string | undefined, opts: IngestOptions): Promise<IngestResult> {\n  const now = opts.now?.() ?? new Date();\n  if (!ingestKey || !opts.keys[ingestKey]) return { status: 401, body: { ok: false, error: \"invalid ingest key\" } };\n  if (Buffer.byteLength(rawBody) > (opts.maxBytes ?? 512 * 1024)) return { status: 413, body: { ok: false, error: \"payload too large\" } };\n\n  let json: unknown;\n  try {\n    json = JSON.parse(rawBody);\n  } catch {\n    return { status: 400, body: { ok: false, error: \"invalid json\" } };\n  }\n  const parsed = Envelope.safeParse(json);\n  if (!parsed.success) return { status: 400, body: { ok: false, error: \"invalid envelope\", issues: parsed.error.flatten() } };\n\n  const env = parsed.data;\n  const app = env.context.app.id;\n  if (opts.keys[ingestKey] !== app && opts.keys[ingestKey] !== \"*\") return { status: 403, body: { ok: false, error: `key not allowed for app ${app}` } };\n\n  const context = enrich(env.context);\n  const receivedAt = now.toISOString();\n  const stored: StoredEvent[] = [];\n  const rollups: RollupIncrement[] = [];\n  const issues = new Map<string, IssueUpsert>();\n\n  for (const raw of env.events) {\n    const event = { ...raw, ts: sanitiseTs(raw.ts, now) } as Event;\n    // Clients that don't parse stacks (curl, other SDKs) still get grouped by code location.\n    if (event.type === \"error\" && !event.error.frames?.length && event.error.stack) event.error.frames = parseStack(event.error.stack);\n    const day = dayOf(event.ts);\n    // Session health only feeds the crash-free rollup; storing each one would cost a write per session.\n    if (event.type === \"session\") {\n      rollups.push({ app, day, dimension: \"session\", key: `${context.app.version || \"unknown\"}|${event.status}`, kind: \"event\", by: 1 });\n      continue;\n    }\n    const kind = event.type === \"error\" ? \"error\" : \"event\";\n    const inc = (dimension: RollupIncrement[\"dimension\"], key: string | undefined) =>\n      rollups.push({ app, day, dimension, key: key || \"unknown\", kind, by: 1 });\n\n    let fp: string | undefined;\n    if (event.type === \"error\") {\n      fp = fingerprint(event);\n      const cur = issues.get(fp);\n      const se: StoredEvent = { app, day, fingerprint: fp, event, context, user: env.user, sessionId: env.session.id, receivedAt };\n      issues.set(fp, {\n        app,\n        fingerprint: fp,\n        title: titleOf(event),\n        culprit: culpritOf(event),\n        flow: event.flow,\n        by: (cur?.by ?? 0) + 1,\n        ts: cur && cur.ts > event.ts ? cur.ts : event.ts,\n        firstTs: cur && cur.firstTs < event.ts ? cur.firstTs : event.ts,\n        lastEvent: cur && cur.ts > event.ts ? cur.lastEvent : se,\n      });\n      inc(\"issue\", fp);\n      if (event.request) inc(\"endpoint\", `${event.request.method.toUpperCase()} ${event.request.url}`);\n      rollups.push({ app, day: event.ts.slice(0, 13), dimension: \"issueHour\", key: fp, kind, by: 1 });\n    }\n\n    inc(\"total\", \"all\");\n    inc(\"flow\", event.flow ?? \"untagged\");\n    inc(\"os\", `${context.os.name} ${context.os.version ?? \"\"}`.trim());\n    inc(\"appVersion\", context.app.version);\n    inc(\"deviceModel\", context.device.model);\n    if (event.type === \"event\" && event.outcome && event.flow) inc(\"flowOutcome\", `${event.flow}|${event.outcome}`);\n\n    stored.push({ app, day, fingerprint: fp, event, context, user: env.user, sessionId: env.session.id, receivedAt });\n  }\n\n  await opts.store.registerApp(app);\n  await Promise.all([\n    stored.length ? opts.store.writeEvents(stored) : undefined,\n    opts.store.upsertIssues([...issues.values()]),\n    opts.store.incrementRollups(rollups),\n  ]);\n\n  return { status: 202, body: { ok: true, accepted: env.events.length } };\n}\n\nexport const CORS_HEADERS = {\n  \"access-control-allow-origin\": \"*\",\n  \"access-control-allow-methods\": \"POST, OPTIONS\",\n  \"access-control-allow-headers\": \"content-type, x-debug-key\",\n  \"access-control-max-age\": \"86400\",\n};\n","import { createHash } from \"node:crypto\";\nimport type { ErrorEvent, StackFrame } from \"@debugkit/schema\";\n\n/** Strip volatile parts so \"User 123 not found\" and \"User 456 not found\" group together. */\nexport function normaliseMessage(msg: string): string {\n  return msg\n    .replace(/https?:\\/\\/\\S+/g, \"<url>\")\n    .replace(/\\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\\b/gi, \"<uuid>\")\n    .replace(/\\b[0-9a-f]{16,}\\b/gi, \"<hex>\")\n    .replace(/[\\w.+-]+@[\\w-]+\\.[\\w.]+/g, \"<email>\")\n    .replace(/\\d+(\\.\\d+)?/g, \"<n>\")\n    .replace(/([\"'`]).*?\\1/g, \"<str>\")\n    .trim()\n    .slice(0, 300);\n}\n\n/** Remove build hashes / absolute prefixes so the same code location matches across builds and devices. */\nexport function normaliseFile(file: string | undefined): string {\n  if (!file) return \"\";\n  // Metro dev bundles put options after \"//&\" instead of \"?\"; drop both.\n  let f = file.replace(/\\/\\/&.*$/, \"\").replace(/[?#].*$/, \"\").replace(/^[a-z]+:\\/\\/[^/]+/i, \"\");\n  // React Native bundles: the path is noise, the bundle name is enough.\n  if (/\\.(?:js)?bundle$/.test(f)) return f.replace(/^.*\\//, \"\");\n  // Keep the path from the deepest conventional source root, preferring src/.\n  for (const root of [\"/src/\", \"/lib/\", \"/app/\"]) {\n    const i = f.lastIndexOf(root);\n    if (i >= 0) {\n      f = f.slice(i + 1);\n      break;\n    }\n  }\n  return f.replace(/\\.[0-9a-f]{6,}\\./g, \".\");\n}\n\nexport function topInAppFrame(frames: StackFrame[] | undefined): StackFrame | undefined {\n  return frames?.find((f) => f.inApp !== false && f.file) ?? frames?.[0];\n}\n\nexport function culpritOf(e: ErrorEvent): string | undefined {\n  const f = topInAppFrame(e.error.frames);\n  if (!f) return undefined;\n  const loc = normaliseFile(f.file) + (f.line ? `:${f.line}` : \"\");\n  return f.fn ? `${f.fn} (${loc})` : loc;\n}\n\n/**\n * Fingerprint = error name + top in-app frame (function + file, not line, so small edits\n * don't split issues) + flow. Falls back to the normalised message when there's no stack.\n */\nexport function fingerprint(e: ErrorEvent): string {\n  const f = topInAppFrame(e.error.frames);\n  // Failed requests group by endpoint and status class: every 503 from /v1/feed is one issue,\n  // whichever screen made the call.\n  const r = e.request;\n  const where = r\n    ? `${r.method.toUpperCase()} ${r.url} ${r.status ? `${Math.floor(r.status / 100)}xx` : \"failed\"}`\n    : f\n      ? `${f.fn ?? \"?\"}@${normaliseFile(f.file)}`\n      : normaliseMessage(e.error.message);\n  return createHash(\"sha256\")\n    .update([e.error.name, where, e.flow ?? \"\"].join(\"|\"))\n    .digest(\"hex\")\n    .slice(0, 24);\n}\n\nexport function titleOf(e: ErrorEvent): string {\n  return `${e.error.name}: ${e.error.message}`.slice(0, 200);\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-YSIB36FS.cjs

@@ -0,0 +1,148 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/index.ts
+var _schema = require('@debugkit/schema');
+
+// src/fingerprint.ts
+var _crypto = require('crypto');
+function normaliseMessage(msg) {
+  return msg.replace(/https?:\/\/\S+/g, "<url>").replace(/\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/gi, "<uuid>").replace(/\b[0-9a-f]{16,}\b/gi, "<hex>").replace(/[\w.+-]+@[\w-]+\.[\w.]+/g, "<email>").replace(/\d+(\.\d+)?/g, "<n>").replace(/(["'`]).*?\1/g, "<str>").trim().slice(0, 300);
+}
+function normaliseFile(file) {
+  if (!file) return "";
+  let f = file.replace(/\/\/&.*$/, "").replace(/[?#].*$/, "").replace(/^[a-z]+:\/\/[^/]+/i, "");
+  if (/\.(?:js)?bundle$/.test(f)) return f.replace(/^.*\//, "");
+  for (const root of ["/src/", "/lib/", "/app/"]) {
+    const i = f.lastIndexOf(root);
+    if (i >= 0) {
+      f = f.slice(i + 1);
+      break;
+    }
+  }
+  return f.replace(/\.[0-9a-f]{6,}\./g, ".");
+}
+function topInAppFrame(frames) {
+  return _nullishCoalesce(_optionalChain([frames, 'optionalAccess', _ => _.find, 'call', _2 => _2((f) => f.inApp !== false && f.file)]), () => ( _optionalChain([frames, 'optionalAccess', _3 => _3[0]])));
+}
+function culpritOf(e) {
+  const f = topInAppFrame(e.error.frames);
+  if (!f) return void 0;
+  const loc = normaliseFile(f.file) + (f.line ? `:${f.line}` : "");
+  return f.fn ? `${f.fn} (${loc})` : loc;
+}
+function fingerprint(e) {
+  const f = topInAppFrame(e.error.frames);
+  const r = e.request;
+  const where = r ? `${r.method.toUpperCase()} ${r.url} ${r.status ? `${Math.floor(r.status / 100)}xx` : "failed"}` : f ? `${_nullishCoalesce(f.fn, () => ( "?"))}@${normaliseFile(f.file)}` : normaliseMessage(e.error.message);
+  return _crypto.createHash.call(void 0, "sha256").update([e.error.name, where, _nullishCoalesce(e.flow, () => ( ""))].join("|")).digest("hex").slice(0, 24);
+}
+function titleOf(e) {
+  return `${e.error.name}: ${e.error.message}`.slice(0, 200);
+}
+
+// src/index.ts
+function parseIngestKeys(raw) {
+  const out = {};
+  for (const pair of (_nullishCoalesce(raw, () => ( ""))).split(",").map((s) => s.trim()).filter(Boolean)) {
+    const [key, app] = pair.split(":");
+    if (key && app) out[key] = app;
+  }
+  return out;
+}
+var dayOf = (iso) => iso.slice(0, 10);
+function sanitiseTs(ts, now) {
+  const t = Date.parse(ts);
+  const n = now.getTime();
+  if (Number.isNaN(t) || t > n + 5 * 6e4 || t < n - 7 * 864e5) return now.toISOString();
+  return new Date(t).toISOString();
+}
+function enrich(ctx) {
+  return {
+    ...ctx,
+    os: { ...ctx.os, name: ctx.os.name.toLowerCase() },
+    runtime: { ...ctx.runtime, name: ctx.runtime.name.toLowerCase() }
+  };
+}
+async function ingest(rawBody, ingestKey, opts) {
+  const now = _nullishCoalesce(_optionalChain([opts, 'access', _4 => _4.now, 'optionalCall', _5 => _5()]), () => ( /* @__PURE__ */ new Date()));
+  if (!ingestKey || !opts.keys[ingestKey]) return { status: 401, body: { ok: false, error: "invalid ingest key" } };
+  if (Buffer.byteLength(rawBody) > (_nullishCoalesce(opts.maxBytes, () => ( 512 * 1024)))) return { status: 413, body: { ok: false, error: "payload too large" } };
+  let json;
+  try {
+    json = JSON.parse(rawBody);
+  } catch (e2) {
+    return { status: 400, body: { ok: false, error: "invalid json" } };
+  }
+  const parsed = _schema.Envelope.safeParse(json);
+  if (!parsed.success) return { status: 400, body: { ok: false, error: "invalid envelope", issues: parsed.error.flatten() } };
+  const env = parsed.data;
+  const app = env.context.app.id;
+  if (opts.keys[ingestKey] !== app && opts.keys[ingestKey] !== "*") return { status: 403, body: { ok: false, error: `key not allowed for app ${app}` } };
+  const context = enrich(env.context);
+  const receivedAt = now.toISOString();
+  const stored = [];
+  const rollups = [];
+  const issues = /* @__PURE__ */ new Map();
+  for (const raw of env.events) {
+    const event = { ...raw, ts: sanitiseTs(raw.ts, now) };
+    if (event.type === "error" && !_optionalChain([event, 'access', _6 => _6.error, 'access', _7 => _7.frames, 'optionalAccess', _8 => _8.length]) && event.error.stack) event.error.frames = _schema.parseStack.call(void 0, event.error.stack);
+    const day = dayOf(event.ts);
+    if (event.type === "session") {
+      rollups.push({ app, day, dimension: "session", key: `${context.app.version || "unknown"}|${event.status}`, kind: "event", by: 1 });
+      continue;
+    }
+    const kind = event.type === "error" ? "error" : "event";
+    const inc = (dimension, key) => rollups.push({ app, day, dimension, key: key || "unknown", kind, by: 1 });
+    let fp;
+    if (event.type === "error") {
+      fp = fingerprint(event);
+      const cur = issues.get(fp);
+      const se = { app, day, fingerprint: fp, event, context, user: env.user, sessionId: env.session.id, receivedAt };
+      issues.set(fp, {
+        app,
+        fingerprint: fp,
+        title: titleOf(event),
+        culprit: culpritOf(event),
+        flow: event.flow,
+        by: (_nullishCoalesce(_optionalChain([cur, 'optionalAccess', _9 => _9.by]), () => ( 0))) + 1,
+        ts: cur && cur.ts > event.ts ? cur.ts : event.ts,
+        firstTs: cur && cur.firstTs < event.ts ? cur.firstTs : event.ts,
+        lastEvent: cur && cur.ts > event.ts ? cur.lastEvent : se
+      });
+      inc("issue", fp);
+      if (event.request) inc("endpoint", `${event.request.method.toUpperCase()} ${event.request.url}`);
+      rollups.push({ app, day: event.ts.slice(0, 13), dimension: "issueHour", key: fp, kind, by: 1 });
+    }
+    inc("total", "all");
+    inc("flow", _nullishCoalesce(event.flow, () => ( "untagged")));
+    inc("os", `${context.os.name} ${_nullishCoalesce(context.os.version, () => ( ""))}`.trim());
+    inc("appVersion", context.app.version);
+    inc("deviceModel", context.device.model);
+    if (event.type === "event" && event.outcome && event.flow) inc("flowOutcome", `${event.flow}|${event.outcome}`);
+    stored.push({ app, day, fingerprint: fp, event, context, user: env.user, sessionId: env.session.id, receivedAt });
+  }
+  await opts.store.registerApp(app);
+  await Promise.all([
+    stored.length ? opts.store.writeEvents(stored) : void 0,
+    opts.store.upsertIssues([...issues.values()]),
+    opts.store.incrementRollups(rollups)
+  ]);
+  return { status: 202, body: { ok: true, accepted: env.events.length } };
+}
+var CORS_HEADERS = {
+  "access-control-allow-origin": "*",
+  "access-control-allow-methods": "POST, OPTIONS",
+  "access-control-allow-headers": "content-type, x-debug-key",
+  "access-control-max-age": "86400"
+};
+
+
+
+
+
+
+
+
+
+
+
+exports.normaliseMessage = normaliseMessage; exports.normaliseFile = normaliseFile; exports.topInAppFrame = topInAppFrame; exports.culpritOf = culpritOf; exports.fingerprint = fingerprint; exports.titleOf = titleOf; exports.parseIngestKeys = parseIngestKeys; exports.ingest = ingest; exports.CORS_HEADERS = CORS_HEADERS;
+//# sourceMappingURL=chunk-YSIB36FS.cjs.map

package/dist/chunk-YSIB36FS.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/sivemwanda/Work/Tanstack/deBug/packages/ingest/dist/chunk-YSIB36FS.cjs","../src/index.ts","../src/fingerprint.ts"],"names":[],"mappings":"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","file":"/Users/sivemwanda/Work/Tanstack/deBug/packages/ingest/dist/chunk-YSIB36FS.cjs","sourcesContent":[null,"import { Envelope, parseStack, type Context, type Event, type RollupIncrement, type StoredEvent } from \"@debugkit/schema\";\nimport type { IssueUpsert, WriteStore } from \"@debugkit/adapters\";\nimport { culpritOf, fingerprint, titleOf } from \"./fingerprint\";\n\nexport * from \"./fingerprint\";\n\nexport interface IngestOptions {\n  store: WriteStore;\n  /**\n   * Map of public ingest key → app id it may write to. A key can't write to another app.\n   * The app id \"*\" lets a key write to any app (local development only).\n   * Parse from env with `parseIngestKeys(process.env.DEBUG_INGEST_KEYS)`.\n   */\n  keys: Record<string, string>;\n  /** Hard cap on accepted payload size in bytes. Default 512 KB. */\n  maxBytes?: number;\n  now?: () => Date;\n}\n\nexport interface IngestResult {\n  status: number;\n  body: { ok: boolean; accepted?: number; error?: string; issues?: unknown };\n}\n\n/** \"pk_abc:megaton-native,pk_def:other-app\" → { pk_abc: \"megaton-native\", ... } */\nexport function parseIngestKeys(raw: string | undefined): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const pair of (raw ?? \"\").split(\",\").map((s) => s.trim()).filter(Boolean)) {\n    const [key, app] = pair.split(\":\");\n    if (key && app) out[key] = app;\n  }\n  return out;\n}\n\nconst dayOf = (iso: string) => iso.slice(0, 10);\n\n/** Clamp client clocks: events claiming to be from the future or very old are pinned to receipt time. */\nfunction sanitiseTs(ts: string, now: Date): string {\n  const t = Date.parse(ts);\n  const n = now.getTime();\n  if (Number.isNaN(t) || t > n + 5 * 60_000 || t < n - 7 * 86_400_000) return now.toISOString();\n  return new Date(t).toISOString();\n}\n\nfunction enrich(ctx: Context): Context {\n  return {\n    ...ctx,\n    os: { ...ctx.os, name: ctx.os.name.toLowerCase() },\n    runtime: { ...ctx.runtime, name: ctx.runtime.name.toLowerCase() },\n  };\n}\n\n/** Platform-agnostic ingest. Wrap with ./firebase or ./lambda to deploy. */\nexport async function ingest(rawBody: string, ingestKey: string | undefined, opts: IngestOptions): Promise<IngestResult> {\n  const now = opts.now?.() ?? new Date();\n  if (!ingestKey || !opts.keys[ingestKey]) return { status: 401, body: { ok: false, error: \"invalid ingest key\" } };\n  if (Buffer.byteLength(rawBody) > (opts.maxBytes ?? 512 * 1024)) return { status: 413, body: { ok: false, error: \"payload too large\" } };\n\n  let json: unknown;\n  try {\n    json = JSON.parse(rawBody);\n  } catch {\n    return { status: 400, body: { ok: false, error: \"invalid json\" } };\n  }\n  const parsed = Envelope.safeParse(json);\n  if (!parsed.success) return { status: 400, body: { ok: false, error: \"invalid envelope\", issues: parsed.error.flatten() } };\n\n  const env = parsed.data;\n  const app = env.context.app.id;\n  if (opts.keys[ingestKey] !== app && opts.keys[ingestKey] !== \"*\") return { status: 403, body: { ok: false, error: `key not allowed for app ${app}` } };\n\n  const context = enrich(env.context);\n  const receivedAt = now.toISOString();\n  const stored: StoredEvent[] = [];\n  const rollups: RollupIncrement[] = [];\n  const issues = new Map<string, IssueUpsert>();\n\n  for (const raw of env.events) {\n    const event = { ...raw, ts: sanitiseTs(raw.ts, now) } as Event;\n    // Clients that don't parse stacks (curl, other SDKs) still get grouped by code location.\n    if (event.type === \"error\" && !event.error.frames?.length && event.error.stack) event.error.frames = parseStack(event.error.stack);\n    const day = dayOf(event.ts);\n    // Session health only feeds the crash-free rollup; storing each one would cost a write per session.\n    if (event.type === \"session\") {\n      rollups.push({ app, day, dimension: \"session\", key: `${context.app.version || \"unknown\"}|${event.status}`, kind: \"event\", by: 1 });\n      continue;\n    }\n    const kind = event.type === \"error\" ? \"error\" : \"event\";\n    const inc = (dimension: RollupIncrement[\"dimension\"], key: string | undefined) =>\n      rollups.push({ app, day, dimension, key: key || \"unknown\", kind, by: 1 });\n\n    let fp: string | undefined;\n    if (event.type === \"error\") {\n      fp = fingerprint(event);\n      const cur = issues.get(fp);\n      const se: StoredEvent = { app, day, fingerprint: fp, event, context, user: env.user, sessionId: env.session.id, receivedAt };\n      issues.set(fp, {\n        app,\n        fingerprint: fp,\n        title: titleOf(event),\n        culprit: culpritOf(event),\n        flow: event.flow,\n        by: (cur?.by ?? 0) + 1,\n        ts: cur && cur.ts > event.ts ? cur.ts : event.ts,\n        firstTs: cur && cur.firstTs < event.ts ? cur.firstTs : event.ts,\n        lastEvent: cur && cur.ts > event.ts ? cur.lastEvent : se,\n      });\n      inc(\"issue\", fp);\n      if (event.request) inc(\"endpoint\", `${event.request.method.toUpperCase()} ${event.request.url}`);\n      rollups.push({ app, day: event.ts.slice(0, 13), dimension: \"issueHour\", key: fp, kind, by: 1 });\n    }\n\n    inc(\"total\", \"all\");\n    inc(\"flow\", event.flow ?? \"untagged\");\n    inc(\"os\", `${context.os.name} ${context.os.version ?? \"\"}`.trim());\n    inc(\"appVersion\", context.app.version);\n    inc(\"deviceModel\", context.device.model);\n    if (event.type === \"event\" && event.outcome && event.flow) inc(\"flowOutcome\", `${event.flow}|${event.outcome}`);\n\n    stored.push({ app, day, fingerprint: fp, event, context, user: env.user, sessionId: env.session.id, receivedAt });\n  }\n\n  await opts.store.registerApp(app);\n  await Promise.all([\n    stored.length ? opts.store.writeEvents(stored) : undefined,\n    opts.store.upsertIssues([...issues.values()]),\n    opts.store.incrementRollups(rollups),\n  ]);\n\n  return { status: 202, body: { ok: true, accepted: env.events.length } };\n}\n\nexport const CORS_HEADERS = {\n  \"access-control-allow-origin\": \"*\",\n  \"access-control-allow-methods\": \"POST, OPTIONS\",\n  \"access-control-allow-headers\": \"content-type, x-debug-key\",\n  \"access-control-max-age\": \"86400\",\n};\n","import { createHash } from \"node:crypto\";\nimport type { ErrorEvent, StackFrame } from \"@debugkit/schema\";\n\n/** Strip volatile parts so \"User 123 not found\" and \"User 456 not found\" group together. */\nexport function normaliseMessage(msg: string): string {\n  return msg\n    .replace(/https?:\\/\\/\\S+/g, \"<url>\")\n    .replace(/\\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\\b/gi, \"<uuid>\")\n    .replace(/\\b[0-9a-f]{16,}\\b/gi, \"<hex>\")\n    .replace(/[\\w.+-]+@[\\w-]+\\.[\\w.]+/g, \"<email>\")\n    .replace(/\\d+(\\.\\d+)?/g, \"<n>\")\n    .replace(/([\"'`]).*?\\1/g, \"<str>\")\n    .trim()\n    .slice(0, 300);\n}\n\n/** Remove build hashes / absolute prefixes so the same code location matches across builds and devices. */\nexport function normaliseFile(file: string | undefined): string {\n  if (!file) return \"\";\n  // Metro dev bundles put options after \"//&\" instead of \"?\"; drop both.\n  let f = file.replace(/\\/\\/&.*$/, \"\").replace(/[?#].*$/, \"\").replace(/^[a-z]+:\\/\\/[^/]+/i, \"\");\n  // React Native bundles: the path is noise, the bundle name is enough.\n  if (/\\.(?:js)?bundle$/.test(f)) return f.replace(/^.*\\//, \"\");\n  // Keep the path from the deepest conventional source root, preferring src/.\n  for (const root of [\"/src/\", \"/lib/\", \"/app/\"]) {\n    const i = f.lastIndexOf(root);\n    if (i >= 0) {\n      f = f.slice(i + 1);\n      break;\n    }\n  }\n  return f.replace(/\\.[0-9a-f]{6,}\\./g, \".\");\n}\n\nexport function topInAppFrame(frames: StackFrame[] | undefined): StackFrame | undefined {\n  return frames?.find((f) => f.inApp !== false && f.file) ?? frames?.[0];\n}\n\nexport function culpritOf(e: ErrorEvent): string | undefined {\n  const f = topInAppFrame(e.error.frames);\n  if (!f) return undefined;\n  const loc = normaliseFile(f.file) + (f.line ? `:${f.line}` : \"\");\n  return f.fn ? `${f.fn} (${loc})` : loc;\n}\n\n/**\n * Fingerprint = error name + top in-app frame (function + file, not line, so small edits\n * don't split issues) + flow. Falls back to the normalised message when there's no stack.\n */\nexport function fingerprint(e: ErrorEvent): string {\n  const f = topInAppFrame(e.error.frames);\n  // Failed requests group by endpoint and status class: every 503 from /v1/feed is one issue,\n  // whichever screen made the call.\n  const r = e.request;\n  const where = r\n    ? `${r.method.toUpperCase()} ${r.url} ${r.status ? `${Math.floor(r.status / 100)}xx` : \"failed\"}`\n    : f\n      ? `${f.fn ?? \"?\"}@${normaliseFile(f.file)}`\n      : normaliseMessage(e.error.message);\n  return createHash(\"sha256\")\n    .update([e.error.name, where, e.flow ?? \"\"].join(\"|\"))\n    .digest(\"hex\")\n    .slice(0, 24);\n}\n\nexport function titleOf(e: ErrorEvent): string {\n  return `${e.error.name}: ${e.error.message}`.slice(0, 200);\n}\n"]}

package/dist/firebase.cjs

@@ -0,0 +1,25 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+var _chunkYSIB36FScjs = require('./chunk-YSIB36FS.cjs');
+
+// src/firebase.ts
+function firebaseHandler(opts) {
+  return async (req, res) => {
+    res.set(_chunkYSIB36FScjs.CORS_HEADERS);
+    if (req.method === "OPTIONS") return res.status(204).send();
+    if (req.method !== "POST") return res.status(405).json({ ok: false, error: "method not allowed" });
+    const raw = _nullishCoalesce(_optionalChain([req, 'access', _ => _.rawBody, 'optionalAccess', _2 => _2.toString, 'call', _3 => _3("utf8")]), () => ( (typeof req.body === "string" ? req.body : JSON.stringify(_nullishCoalesce(req.body, () => ( {}))))));
+    try {
+      const out = await _chunkYSIB36FScjs.ingest.call(void 0, raw, req.header("x-debug-key"), opts);
+      res.status(out.status).json(out.body);
+    } catch (err) {
+      console.error("[deBug] ingest failed", err);
+      res.status(500).json({ ok: false, error: "internal" });
+    }
+  };
+}
+
+
+exports.firebaseHandler = firebaseHandler;
+//# sourceMappingURL=firebase.cjs.map

package/dist/firebase.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/sivemwanda/Work/Tanstack/deBug/packages/ingest/dist/firebase.cjs","../src/firebase.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,wDAA6B;AAC7B;AACA;ACYO,SAAS,eAAA,CAAgB,IAAA,EAAqB;AACnD,EAAA,OAAO,MAAA,CACL,GAAA,EACA,GAAA,EAAA,GACG;AACH,IAAA,GAAA,CAAI,GAAA,CAAI,8BAAY,CAAA;AACpB,IAAA,GAAA,CAAI,GAAA,CAAI,OAAA,IAAW,SAAA,EAAW,OAAO,GAAA,CAAI,MAAA,CAAO,GAAG,CAAA,CAAE,IAAA,CAAK,CAAA;AAC1D,IAAA,GAAA,CAAI,GAAA,CAAI,OAAA,IAAW,MAAA,EAAQ,OAAO,GAAA,CAAI,MAAA,CAAO,GAAG,CAAA,CAAE,IAAA,CAAK,EAAE,EAAA,EAAI,KAAA,EAAO,KAAA,EAAO,qBAAqB,CAAC,CAAA;AACjG,IAAA,MAAM,IAAA,mCAAM,GAAA,mBAAI,OAAA,6BAAS,QAAA,mBAAS,MAAM,GAAA,UAAA,CAAM,OAAO,GAAA,CAAI,KAAA,IAAS,SAAA,EAAW,GAAA,CAAI,KAAA,EAAO,IAAA,CAAK,SAAA,kBAAU,GAAA,CAAI,IAAA,UAAQ,CAAC,GAAC,CAAA,GAAA;AACrH,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,EAAM,MAAM,sCAAA,GAAO,EAAK,GAAA,CAAI,MAAA,CAAO,aAAa,CAAA,EAAG,IAAI,CAAA;AAC7D,MAAA,GAAA,CAAI,MAAA,CAAO,GAAA,CAAI,MAAM,CAAA,CAAE,IAAA,CAAK,GAAA,CAAI,IAAI,CAAA;AAAA,IACtC,EAAA,MAAA,CAAS,GAAA,EAAK;AACZ,MAAA,OAAA,CAAQ,KAAA,CAAM,uBAAA,EAAyB,GAAG,CAAA;AAC1C,MAAA,GAAA,CAAI,MAAA,CAAO,GAAG,CAAA,CAAE,IAAA,CAAK,EAAE,EAAA,EAAI,KAAA,EAAO,KAAA,EAAO,WAAW,CAAC,CAAA;AAAA,IACvD;AAAA,EACF,CAAA;AACF;ADbA;AACE;AACF,0CAAC","file":"/Users/sivemwanda/Work/Tanstack/deBug/packages/ingest/dist/firebase.cjs","sourcesContent":[null,"import { CORS_HEADERS, ingest, type IngestOptions } from \"./index\";\n\n/**\n * Express-style handler for Firebase Cloud Functions (v2):\n *\n *   import { onRequest } from \"firebase-functions/v2/https\";\n *   import { getFirestore } from \"firebase-admin/firestore\";\n *   import { initializeApp } from \"firebase-admin/app\";\n *   import { FirestoreStore } from \"@debugkit/adapters/firestore\";\n *   import { firebaseHandler } from \"@debugkit/ingest/firebase\";\n *   import { parseIngestKeys } from \"@debugkit/ingest\";\n *\n *   initializeApp();\n *   export const debugIngest = onRequest(\n *     firebaseHandler({ store: new FirestoreStore(getFirestore()), keys: parseIngestKeys(process.env.DEBUG_INGEST_KEYS) }),\n *   );\n */\nexport function firebaseHandler(opts: IngestOptions) {\n  return async (\n    req: { method: string; header(name: string): string | undefined; rawBody?: Buffer; body?: unknown },\n    res: { set(h: Record<string, string>): unknown; status(n: number): { json(b: unknown): void; send(b?: unknown): void } },\n  ) => {\n    res.set(CORS_HEADERS);\n    if (req.method === \"OPTIONS\") return res.status(204).send();\n    if (req.method !== \"POST\") return res.status(405).json({ ok: false, error: \"method not allowed\" });\n    const raw = req.rawBody?.toString(\"utf8\") ?? (typeof req.body === \"string\" ? req.body : JSON.stringify(req.body ?? {}));\n    try {\n      const out = await ingest(raw, req.header(\"x-debug-key\"), opts);\n      res.status(out.status).json(out.body);\n    } catch (err) {\n      console.error(\"[deBug] ingest failed\", err);\n      res.status(500).json({ ok: false, error: \"internal\" });\n    }\n  };\n}\n"]}

package/dist/firebase.d.cts

@@ -0,0 +1,33 @@
+import { IngestOptions } from './index.cjs';
+import '@debugkit/adapters';
+import '@debugkit/schema';
+
+/**
+ * Express-style handler for Firebase Cloud Functions (v2):
+ *
+ *   import { onRequest } from "firebase-functions/v2/https";
+ *   import { getFirestore } from "firebase-admin/firestore";
+ *   import { initializeApp } from "firebase-admin/app";
+ *   import { FirestoreStore } from "@debugkit/adapters/firestore";
+ *   import { firebaseHandler } from "@debugkit/ingest/firebase";
+ *   import { parseIngestKeys } from "@debugkit/ingest";
+ *
+ *   initializeApp();
+ *   export const debugIngest = onRequest(
+ *     firebaseHandler({ store: new FirestoreStore(getFirestore()), keys: parseIngestKeys(process.env.DEBUG_INGEST_KEYS) }),
+ *   );
+ */
+declare function firebaseHandler(opts: IngestOptions): (req: {
+    method: string;
+    header(name: string): string | undefined;
+    rawBody?: Buffer;
+    body?: unknown;
+}, res: {
+    set(h: Record<string, string>): unknown;
+    status(n: number): {
+        json(b: unknown): void;
+        send(b?: unknown): void;
+    };
+}) => Promise<void>;
+
+export { firebaseHandler };

package/dist/firebase.d.ts

@@ -0,0 +1,33 @@
+import { IngestOptions } from './index.js';
+import '@debugkit/adapters';
+import '@debugkit/schema';
+
+/**
+ * Express-style handler for Firebase Cloud Functions (v2):
+ *
+ *   import { onRequest } from "firebase-functions/v2/https";
+ *   import { getFirestore } from "firebase-admin/firestore";
+ *   import { initializeApp } from "firebase-admin/app";
+ *   import { FirestoreStore } from "@debugkit/adapters/firestore";
+ *   import { firebaseHandler } from "@debugkit/ingest/firebase";
+ *   import { parseIngestKeys } from "@debugkit/ingest";
+ *
+ *   initializeApp();
+ *   export const debugIngest = onRequest(
+ *     firebaseHandler({ store: new FirestoreStore(getFirestore()), keys: parseIngestKeys(process.env.DEBUG_INGEST_KEYS) }),
+ *   );
+ */
+declare function firebaseHandler(opts: IngestOptions): (req: {
+    method: string;
+    header(name: string): string | undefined;
+    rawBody?: Buffer;
+    body?: unknown;
+}, res: {
+    set(h: Record<string, string>): unknown;
+    status(n: number): {
+        json(b: unknown): void;
+        send(b?: unknown): void;
+    };
+}) => Promise<void>;
+
+export { firebaseHandler };

package/dist/firebase.js

@@ -0,0 +1,25 @@
+import {
+  CORS_HEADERS,
+  ingest
+} from "./chunk-6C67KV5S.js";
+
+// src/firebase.ts
+function firebaseHandler(opts) {
+  return async (req, res) => {
+    res.set(CORS_HEADERS);
+    if (req.method === "OPTIONS") return res.status(204).send();
+    if (req.method !== "POST") return res.status(405).json({ ok: false, error: "method not allowed" });
+    const raw = req.rawBody?.toString("utf8") ?? (typeof req.body === "string" ? req.body : JSON.stringify(req.body ?? {}));
+    try {
+      const out = await ingest(raw, req.header("x-debug-key"), opts);
+      res.status(out.status).json(out.body);
+    } catch (err) {
+      console.error("[deBug] ingest failed", err);
+      res.status(500).json({ ok: false, error: "internal" });
+    }
+  };
+}
+export {
+  firebaseHandler
+};
+//# sourceMappingURL=firebase.js.map

package/dist/firebase.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/firebase.ts"],"sourcesContent":["import { CORS_HEADERS, ingest, type IngestOptions } from \"./index\";\n\n/**\n * Express-style handler for Firebase Cloud Functions (v2):\n *\n *   import { onRequest } from \"firebase-functions/v2/https\";\n *   import { getFirestore } from \"firebase-admin/firestore\";\n *   import { initializeApp } from \"firebase-admin/app\";\n *   import { FirestoreStore } from \"@debugkit/adapters/firestore\";\n *   import { firebaseHandler } from \"@debugkit/ingest/firebase\";\n *   import { parseIngestKeys } from \"@debugkit/ingest\";\n *\n *   initializeApp();\n *   export const debugIngest = onRequest(\n *     firebaseHandler({ store: new FirestoreStore(getFirestore()), keys: parseIngestKeys(process.env.DEBUG_INGEST_KEYS) }),\n *   );\n */\nexport function firebaseHandler(opts: IngestOptions) {\n  return async (\n    req: { method: string; header(name: string): string | undefined; rawBody?: Buffer; body?: unknown },\n    res: { set(h: Record<string, string>): unknown; status(n: number): { json(b: unknown): void; send(b?: unknown): void } },\n  ) => {\n    res.set(CORS_HEADERS);\n    if (req.method === \"OPTIONS\") return res.status(204).send();\n    if (req.method !== \"POST\") return res.status(405).json({ ok: false, error: \"method not allowed\" });\n    const raw = req.rawBody?.toString(\"utf8\") ?? (typeof req.body === \"string\" ? req.body : JSON.stringify(req.body ?? {}));\n    try {\n      const out = await ingest(raw, req.header(\"x-debug-key\"), opts);\n      res.status(out.status).json(out.body);\n    } catch (err) {\n      console.error(\"[deBug] ingest failed\", err);\n      res.status(500).json({ ok: false, error: \"internal\" });\n    }\n  };\n}\n"],"mappings":";;;;;;AAiBO,SAAS,gBAAgB,MAAqB;AACnD,SAAO,OACL,KACA,QACG;AACH,QAAI,IAAI,YAAY;AACpB,QAAI,IAAI,WAAW,UAAW,QAAO,IAAI,OAAO,GAAG,EAAE,KAAK;AAC1D,QAAI,IAAI,WAAW,OAAQ,QAAO,IAAI,OAAO,GAAG,EAAE,KAAK,EAAE,IAAI,OAAO,OAAO,qBAAqB,CAAC;AACjG,UAAM,MAAM,IAAI,SAAS,SAAS,MAAM,MAAM,OAAO,IAAI,SAAS,WAAW,IAAI,OAAO,KAAK,UAAU,IAAI,QAAQ,CAAC,CAAC;AACrH,QAAI;AACF,YAAM,MAAM,MAAM,OAAO,KAAK,IAAI,OAAO,aAAa,GAAG,IAAI;AAC7D,UAAI,OAAO,IAAI,MAAM,EAAE,KAAK,IAAI,IAAI;AAAA,IACtC,SAAS,KAAK;AACZ,cAAQ,MAAM,yBAAyB,GAAG;AAC1C,UAAI,OAAO,GAAG,EAAE,KAAK,EAAE,IAAI,OAAO,OAAO,WAAW,CAAC;AAAA,IACvD;AAAA,EACF;AACF;","names":[]}

package/dist/index.cjs

@@ -0,0 +1,23 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+
+
+var _chunkYSIB36FScjs = require('./chunk-YSIB36FS.cjs');
+
+
+
+
+
+
+
+
+
+
+exports.CORS_HEADERS = _chunkYSIB36FScjs.CORS_HEADERS; exports.culpritOf = _chunkYSIB36FScjs.culpritOf; exports.fingerprint = _chunkYSIB36FScjs.fingerprint; exports.ingest = _chunkYSIB36FScjs.ingest; exports.normaliseFile = _chunkYSIB36FScjs.normaliseFile; exports.normaliseMessage = _chunkYSIB36FScjs.normaliseMessage; exports.parseIngestKeys = _chunkYSIB36FScjs.parseIngestKeys; exports.titleOf = _chunkYSIB36FScjs.titleOf; exports.topInAppFrame = _chunkYSIB36FScjs.topInAppFrame;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/sivemwanda/Work/Tanstack/deBug/packages/ingest/dist/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,keAAC","file":"/Users/sivemwanda/Work/Tanstack/deBug/packages/ingest/dist/index.cjs"}

package/dist/index.d.cts

@@ -0,0 +1,49 @@
+import { WriteStore } from '@debugkit/adapters';
+import { ErrorEvent, StackFrame } from '@debugkit/schema';
+
+/** Strip volatile parts so "User 123 not found" and "User 456 not found" group together. */
+declare function normaliseMessage(msg: string): string;
+/** Remove build hashes / absolute prefixes so the same code location matches across builds and devices. */
+declare function normaliseFile(file: string | undefined): string;
+declare function topInAppFrame(frames: StackFrame[] | undefined): StackFrame | undefined;
+declare function culpritOf(e: ErrorEvent): string | undefined;
+/**
+ * Fingerprint = error name + top in-app frame (function + file, not line, so small edits
+ * don't split issues) + flow. Falls back to the normalised message when there's no stack.
+ */
+declare function fingerprint(e: ErrorEvent): string;
+declare function titleOf(e: ErrorEvent): string;
+
+interface IngestOptions {
+    store: WriteStore;
+    /**
+     * Map of public ingest key → app id it may write to. A key can't write to another app.
+     * The app id "*" lets a key write to any app (local development only).
+     * Parse from env with `parseIngestKeys(process.env.DEBUG_INGEST_KEYS)`.
+     */
+    keys: Record<string, string>;
+    /** Hard cap on accepted payload size in bytes. Default 512 KB. */
+    maxBytes?: number;
+    now?: () => Date;
+}
+interface IngestResult {
+    status: number;
+    body: {
+        ok: boolean;
+        accepted?: number;
+        error?: string;
+        issues?: unknown;
+    };
+}
+/** "pk_abc:megaton-native,pk_def:other-app" → { pk_abc: "megaton-native", ... } */
+declare function parseIngestKeys(raw: string | undefined): Record<string, string>;
+/** Platform-agnostic ingest. Wrap with ./firebase or ./lambda to deploy. */
+declare function ingest(rawBody: string, ingestKey: string | undefined, opts: IngestOptions): Promise<IngestResult>;
+declare const CORS_HEADERS: {
+    "access-control-allow-origin": string;
+    "access-control-allow-methods": string;
+    "access-control-allow-headers": string;
+    "access-control-max-age": string;
+};
+
+export { CORS_HEADERS, type IngestOptions, type IngestResult, culpritOf, fingerprint, ingest, normaliseFile, normaliseMessage, parseIngestKeys, titleOf, topInAppFrame };

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+import { WriteStore } from '@debugkit/adapters';
+import { ErrorEvent, StackFrame } from '@debugkit/schema';
+
+/** Strip volatile parts so "User 123 not found" and "User 456 not found" group together. */
+declare function normaliseMessage(msg: string): string;
+/** Remove build hashes / absolute prefixes so the same code location matches across builds and devices. */
+declare function normaliseFile(file: string | undefined): string;
+declare function topInAppFrame(frames: StackFrame[] | undefined): StackFrame | undefined;
+declare function culpritOf(e: ErrorEvent): string | undefined;
+/**
+ * Fingerprint = error name + top in-app frame (function + file, not line, so small edits
+ * don't split issues) + flow. Falls back to the normalised message when there's no stack.
+ */
+declare function fingerprint(e: ErrorEvent): string;
+declare function titleOf(e: ErrorEvent): string;
+
+interface IngestOptions {
+    store: WriteStore;
+    /**
+     * Map of public ingest key → app id it may write to. A key can't write to another app.
+     * The app id "*" lets a key write to any app (local development only).
+     * Parse from env with `parseIngestKeys(process.env.DEBUG_INGEST_KEYS)`.
+     */
+    keys: Record<string, string>;
+    /** Hard cap on accepted payload size in bytes. Default 512 KB. */
+    maxBytes?: number;
+    now?: () => Date;
+}
+interface IngestResult {
+    status: number;
+    body: {
+        ok: boolean;
+        accepted?: number;
+        error?: string;
+        issues?: unknown;
+    };
+}
+/** "pk_abc:megaton-native,pk_def:other-app" → { pk_abc: "megaton-native", ... } */
+declare function parseIngestKeys(raw: string | undefined): Record<string, string>;
+/** Platform-agnostic ingest. Wrap with ./firebase or ./lambda to deploy. */
+declare function ingest(rawBody: string, ingestKey: string | undefined, opts: IngestOptions): Promise<IngestResult>;
+declare const CORS_HEADERS: {
+    "access-control-allow-origin": string;
+    "access-control-allow-methods": string;
+    "access-control-allow-headers": string;
+    "access-control-max-age": string;
+};
+
+export { CORS_HEADERS, type IngestOptions, type IngestResult, culpritOf, fingerprint, ingest, normaliseFile, normaliseMessage, parseIngestKeys, titleOf, topInAppFrame };

package/dist/index.js

@@ -0,0 +1,23 @@
+import {
+  CORS_HEADERS,
+  culpritOf,
+  fingerprint,
+  ingest,
+  normaliseFile,
+  normaliseMessage,
+  parseIngestKeys,
+  titleOf,
+  topInAppFrame
+} from "./chunk-6C67KV5S.js";
+export {
+  CORS_HEADERS,
+  culpritOf,
+  fingerprint,
+  ingest,
+  normaliseFile,
+  normaliseMessage,
+  parseIngestKeys,
+  titleOf,
+  topInAppFrame
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/lambda.cjs

@@ -0,0 +1,31 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+var _chunkYSIB36FScjs = require('./chunk-YSIB36FS.cjs');
+
+// src/lambda.ts
+function lambdaHandler(opts) {
+  return async (event) => {
+    const method = _nullishCoalesce(_nullishCoalesce(_optionalChain([event, 'access', _ => _.requestContext, 'optionalAccess', _2 => _2.http, 'optionalAccess', _3 => _3.method]), () => ( event.httpMethod)), () => ( "POST"));
+    if (method === "OPTIONS") return { statusCode: 204, headers: _chunkYSIB36FScjs.CORS_HEADERS, body: "" };
+    if (method !== "POST") return reply(405, { ok: false, error: "method not allowed" });
+    const headers = Object.fromEntries(Object.entries(_nullishCoalesce(event.headers, () => ( {}))).map(([k, v]) => [k.toLowerCase(), v]));
+    const raw = event.isBase64Encoded ? Buffer.from(_nullishCoalesce(event.body, () => ( "")), "base64").toString("utf8") : _nullishCoalesce(event.body, () => ( ""));
+    try {
+      const out = await _chunkYSIB36FScjs.ingest.call(void 0, raw, headers["x-debug-key"], opts);
+      return reply(out.status, out.body);
+    } catch (err) {
+      console.error("[deBug] ingest failed", err);
+      return reply(500, { ok: false, error: "internal" });
+    }
+  };
+}
+var reply = (statusCode, body) => ({
+  statusCode,
+  headers: { ..._chunkYSIB36FScjs.CORS_HEADERS, "content-type": "application/json" },
+  body: JSON.stringify(body)
+});
+
+
+exports.lambdaHandler = lambdaHandler;
+//# sourceMappingURL=lambda.cjs.map

package/dist/lambda.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/sivemwanda/Work/Tanstack/deBug/packages/ingest/dist/lambda.cjs","../src/lambda.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,wDAA6B;AAC7B;AACA;ACoBO,SAAS,aAAA,CAAc,IAAA,EAAqB;AACjD,EAAA,OAAO,MAAA,CAAO,KAAA,EAAA,GAAqB;AACjC,IAAA,MAAM,OAAA,oDAAS,KAAA,mBAAM,cAAA,6BAAgB,IAAA,6BAAM,QAAA,UAAU,KAAA,CAAM,YAAA,UAAc,QAAA;AACzE,IAAA,GAAA,CAAI,OAAA,IAAW,SAAA,EAAW,OAAO,EAAE,UAAA,EAAY,GAAA,EAAK,OAAA,EAAS,8BAAA,EAAc,IAAA,EAAM,GAAG,CAAA;AACpF,IAAA,GAAA,CAAI,OAAA,IAAW,MAAA,EAAQ,OAAO,KAAA,CAAM,GAAA,EAAK,EAAE,EAAA,EAAI,KAAA,EAAO,KAAA,EAAO,qBAAqB,CAAC,CAAA;AACnF,IAAA,MAAM,QAAA,EAAU,MAAA,CAAO,WAAA,CAAY,MAAA,CAAO,OAAA,kBAAQ,KAAA,CAAM,OAAA,UAAW,CAAC,GAAC,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,CAAA,EAAG,CAAC,CAAA,EAAA,GAAM,CAAC,CAAA,CAAE,WAAA,CAAY,CAAA,EAAG,CAAC,CAAC,CAAC,CAAA;AAC5G,IAAA,MAAM,IAAA,EAAM,KAAA,CAAM,gBAAA,EAAkB,MAAA,CAAO,IAAA,kBAAK,KAAA,CAAM,IAAA,UAAQ,IAAA,EAAI,QAAQ,CAAA,CAAE,QAAA,CAAS,MAAM,EAAA,mBAAK,KAAA,CAAM,IAAA,UAAQ,IAAA;AAC9G,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,EAAM,MAAM,sCAAA,GAAO,EAAK,OAAA,CAAQ,aAAa,CAAA,EAAG,IAAI,CAAA;AAC1D,MAAA,OAAO,KAAA,CAAM,GAAA,CAAI,MAAA,EAAQ,GAAA,CAAI,IAAI,CAAA;AAAA,IACnC,EAAA,MAAA,CAAS,GAAA,EAAK;AACZ,MAAA,OAAA,CAAQ,KAAA,CAAM,uBAAA,EAAyB,GAAG,CAAA;AAC1C,MAAA,OAAO,KAAA,CAAM,GAAA,EAAK,EAAE,EAAA,EAAI,KAAA,EAAO,KAAA,EAAO,WAAW,CAAC,CAAA;AAAA,IACpD;AAAA,EACF,CAAA;AACF;AAEA,IAAM,MAAA,EAAQ,CAAC,UAAA,EAAoB,IAAA,EAAA,GAAA,CAAmB;AAAA,EACpD,UAAA;AAAA,EACA,OAAA,EAAS,EAAE,GAAG,8BAAA,EAAc,cAAA,EAAgB,mBAAmB,CAAA;AAAA,EAC/D,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAC3B,CAAA,CAAA;ADnBA;AACE;AACF,sCAAC","file":"/Users/sivemwanda/Work/Tanstack/deBug/packages/ingest/dist/lambda.cjs","sourcesContent":[null,"import { CORS_HEADERS, ingest, type IngestOptions } from \"./index\";\n\ninterface HttpEvent {\n  body?: string | null;\n  isBase64Encoded?: boolean;\n  headers?: Record<string, string | undefined>;\n  requestContext?: { http?: { method?: string } };\n  httpMethod?: string;\n}\n\n/**\n * Handler for AWS Lambda behind a Function URL or API Gateway (v1 or v2):\n *\n *   import { DynamoDBClient } from \"@aws-sdk/client-dynamodb\";\n *   import { DynamoDBDocumentClient } from \"@aws-sdk/lib-dynamodb\";\n *   import { DynamoStore } from \"@debugkit/adapters/dynamodb\";\n *   import { lambdaHandler } from \"@debugkit/ingest/lambda\";\n *   import { parseIngestKeys } from \"@debugkit/ingest\";\n *\n *   const doc = DynamoDBDocumentClient.from(new DynamoDBClient({}), { marshallOptions: { removeUndefinedValues: true } });\n *   export const handler = lambdaHandler({\n *     store: new DynamoStore(doc, { table: process.env.DEBUG_TABLE! }),\n *     keys: parseIngestKeys(process.env.DEBUG_INGEST_KEYS),\n *   });\n */\nexport function lambdaHandler(opts: IngestOptions) {\n  return async (event: HttpEvent) => {\n    const method = event.requestContext?.http?.method ?? event.httpMethod ?? \"POST\";\n    if (method === \"OPTIONS\") return { statusCode: 204, headers: CORS_HEADERS, body: \"\" };\n    if (method !== \"POST\") return reply(405, { ok: false, error: \"method not allowed\" });\n    const headers = Object.fromEntries(Object.entries(event.headers ?? {}).map(([k, v]) => [k.toLowerCase(), v]));\n    const raw = event.isBase64Encoded ? Buffer.from(event.body ?? \"\", \"base64\").toString(\"utf8\") : (event.body ?? \"\");\n    try {\n      const out = await ingest(raw, headers[\"x-debug-key\"], opts);\n      return reply(out.status, out.body);\n    } catch (err) {\n      console.error(\"[deBug] ingest failed\", err);\n      return reply(500, { ok: false, error: \"internal\" });\n    }\n  };\n}\n\nconst reply = (statusCode: number, body: unknown) => ({\n  statusCode,\n  headers: { ...CORS_HEADERS, \"content-type\": \"application/json\" },\n  body: JSON.stringify(body),\n});\n"]}

package/dist/lambda.d.cts

@@ -0,0 +1,42 @@
+import { IngestOptions } from './index.cjs';
+import '@debugkit/adapters';
+import '@debugkit/schema';
+
+interface HttpEvent {
+    body?: string | null;
+    isBase64Encoded?: boolean;
+    headers?: Record<string, string | undefined>;
+    requestContext?: {
+        http?: {
+            method?: string;
+        };
+    };
+    httpMethod?: string;
+}
+/**
+ * Handler for AWS Lambda behind a Function URL or API Gateway (v1 or v2):
+ *
+ *   import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
+ *   import { DynamoDBDocumentClient } from "@aws-sdk/lib-dynamodb";
+ *   import { DynamoStore } from "@debugkit/adapters/dynamodb";
+ *   import { lambdaHandler } from "@debugkit/ingest/lambda";
+ *   import { parseIngestKeys } from "@debugkit/ingest";
+ *
+ *   const doc = DynamoDBDocumentClient.from(new DynamoDBClient({}), { marshallOptions: { removeUndefinedValues: true } });
+ *   export const handler = lambdaHandler({
+ *     store: new DynamoStore(doc, { table: process.env.DEBUG_TABLE! }),
+ *     keys: parseIngestKeys(process.env.DEBUG_INGEST_KEYS),
+ *   });
+ */
+declare function lambdaHandler(opts: IngestOptions): (event: HttpEvent) => Promise<{
+    statusCode: number;
+    headers: {
+        "access-control-allow-origin": string;
+        "access-control-allow-methods": string;
+        "access-control-allow-headers": string;
+        "access-control-max-age": string;
+    };
+    body: string;
+}>;
+
+export { lambdaHandler };

package/dist/lambda.d.ts

@@ -0,0 +1,42 @@
+import { IngestOptions } from './index.js';
+import '@debugkit/adapters';
+import '@debugkit/schema';
+
+interface HttpEvent {
+    body?: string | null;
+    isBase64Encoded?: boolean;
+    headers?: Record<string, string | undefined>;
+    requestContext?: {
+        http?: {
+            method?: string;
+        };
+    };
+    httpMethod?: string;
+}
+/**
+ * Handler for AWS Lambda behind a Function URL or API Gateway (v1 or v2):
+ *
+ *   import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
+ *   import { DynamoDBDocumentClient } from "@aws-sdk/lib-dynamodb";
+ *   import { DynamoStore } from "@debugkit/adapters/dynamodb";
+ *   import { lambdaHandler } from "@debugkit/ingest/lambda";
+ *   import { parseIngestKeys } from "@debugkit/ingest";
+ *
+ *   const doc = DynamoDBDocumentClient.from(new DynamoDBClient({}), { marshallOptions: { removeUndefinedValues: true } });
+ *   export const handler = lambdaHandler({
+ *     store: new DynamoStore(doc, { table: process.env.DEBUG_TABLE! }),
+ *     keys: parseIngestKeys(process.env.DEBUG_INGEST_KEYS),
+ *   });
+ */
+declare function lambdaHandler(opts: IngestOptions): (event: HttpEvent) => Promise<{
+    statusCode: number;
+    headers: {
+        "access-control-allow-origin": string;
+        "access-control-allow-methods": string;
+        "access-control-allow-headers": string;
+        "access-control-max-age": string;
+    };
+    body: string;
+}>;
+
+export { lambdaHandler };

package/dist/lambda.js

@@ -0,0 +1,31 @@
+import {
+  CORS_HEADERS,
+  ingest
+} from "./chunk-6C67KV5S.js";
+
+// src/lambda.ts
+function lambdaHandler(opts) {
+  return async (event) => {
+    const method = event.requestContext?.http?.method ?? event.httpMethod ?? "POST";
+    if (method === "OPTIONS") return { statusCode: 204, headers: CORS_HEADERS, body: "" };
+    if (method !== "POST") return reply(405, { ok: false, error: "method not allowed" });
+    const headers = Object.fromEntries(Object.entries(event.headers ?? {}).map(([k, v]) => [k.toLowerCase(), v]));
+    const raw = event.isBase64Encoded ? Buffer.from(event.body ?? "", "base64").toString("utf8") : event.body ?? "";
+    try {
+      const out = await ingest(raw, headers["x-debug-key"], opts);
+      return reply(out.status, out.body);
+    } catch (err) {
+      console.error("[deBug] ingest failed", err);
+      return reply(500, { ok: false, error: "internal" });
+    }
+  };
+}
+var reply = (statusCode, body) => ({
+  statusCode,
+  headers: { ...CORS_HEADERS, "content-type": "application/json" },
+  body: JSON.stringify(body)
+});
+export {
+  lambdaHandler
+};
+//# sourceMappingURL=lambda.js.map

package/dist/lambda.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lambda.ts"],"sourcesContent":["import { CORS_HEADERS, ingest, type IngestOptions } from \"./index\";\n\ninterface HttpEvent {\n  body?: string | null;\n  isBase64Encoded?: boolean;\n  headers?: Record<string, string | undefined>;\n  requestContext?: { http?: { method?: string } };\n  httpMethod?: string;\n}\n\n/**\n * Handler for AWS Lambda behind a Function URL or API Gateway (v1 or v2):\n *\n *   import { DynamoDBClient } from \"@aws-sdk/client-dynamodb\";\n *   import { DynamoDBDocumentClient } from \"@aws-sdk/lib-dynamodb\";\n *   import { DynamoStore } from \"@debugkit/adapters/dynamodb\";\n *   import { lambdaHandler } from \"@debugkit/ingest/lambda\";\n *   import { parseIngestKeys } from \"@debugkit/ingest\";\n *\n *   const doc = DynamoDBDocumentClient.from(new DynamoDBClient({}), { marshallOptions: { removeUndefinedValues: true } });\n *   export const handler = lambdaHandler({\n *     store: new DynamoStore(doc, { table: process.env.DEBUG_TABLE! }),\n *     keys: parseIngestKeys(process.env.DEBUG_INGEST_KEYS),\n *   });\n */\nexport function lambdaHandler(opts: IngestOptions) {\n  return async (event: HttpEvent) => {\n    const method = event.requestContext?.http?.method ?? event.httpMethod ?? \"POST\";\n    if (method === \"OPTIONS\") return { statusCode: 204, headers: CORS_HEADERS, body: \"\" };\n    if (method !== \"POST\") return reply(405, { ok: false, error: \"method not allowed\" });\n    const headers = Object.fromEntries(Object.entries(event.headers ?? {}).map(([k, v]) => [k.toLowerCase(), v]));\n    const raw = event.isBase64Encoded ? Buffer.from(event.body ?? \"\", \"base64\").toString(\"utf8\") : (event.body ?? \"\");\n    try {\n      const out = await ingest(raw, headers[\"x-debug-key\"], opts);\n      return reply(out.status, out.body);\n    } catch (err) {\n      console.error(\"[deBug] ingest failed\", err);\n      return reply(500, { ok: false, error: \"internal\" });\n    }\n  };\n}\n\nconst reply = (statusCode: number, body: unknown) => ({\n  statusCode,\n  headers: { ...CORS_HEADERS, \"content-type\": \"application/json\" },\n  body: JSON.stringify(body),\n});\n"],"mappings":";;;;;;AAyBO,SAAS,cAAc,MAAqB;AACjD,SAAO,OAAO,UAAqB;AACjC,UAAM,SAAS,MAAM,gBAAgB,MAAM,UAAU,MAAM,cAAc;AACzE,QAAI,WAAW,UAAW,QAAO,EAAE,YAAY,KAAK,SAAS,cAAc,MAAM,GAAG;AACpF,QAAI,WAAW,OAAQ,QAAO,MAAM,KAAK,EAAE,IAAI,OAAO,OAAO,qBAAqB,CAAC;AACnF,UAAM,UAAU,OAAO,YAAY,OAAO,QAAQ,MAAM,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;AAC5G,UAAM,MAAM,MAAM,kBAAkB,OAAO,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,SAAS,MAAM,IAAK,MAAM,QAAQ;AAC9G,QAAI;AACF,YAAM,MAAM,MAAM,OAAO,KAAK,QAAQ,aAAa,GAAG,IAAI;AAC1D,aAAO,MAAM,IAAI,QAAQ,IAAI,IAAI;AAAA,IACnC,SAAS,KAAK;AACZ,cAAQ,MAAM,yBAAyB,GAAG;AAC1C,aAAO,MAAM,KAAK,EAAE,IAAI,OAAO,OAAO,WAAW,CAAC;AAAA,IACpD;AAAA,EACF;AACF;AAEA,IAAM,QAAQ,CAAC,YAAoB,UAAmB;AAAA,EACpD;AAAA,EACA,SAAS,EAAE,GAAG,cAAc,gBAAgB,mBAAmB;AAAA,EAC/D,MAAM,KAAK,UAAU,IAAI;AAC3B;","names":[]}

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "@debugkit/ingest",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": {
+        "import": "./dist/index.d.ts",
+        "require": "./dist/index.d.cts"
+      },
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./firebase": {
+      "types": {
+        "import": "./dist/firebase.d.ts",
+        "require": "./dist/firebase.d.cts"
+      },
+      "import": "./dist/firebase.js",
+      "require": "./dist/firebase.cjs"
+    },
+    "./lambda": {
+      "types": {
+        "import": "./dist/lambda.d.ts",
+        "require": "./dist/lambda.d.cts"
+      },
+      "import": "./dist/lambda.js",
+      "require": "./dist/lambda.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@debugkit/adapters": "^0.2.0",
+    "@debugkit/schema": "^0.2.0"
+  },
+  "devDependencies": {
+    "@debugkit/sdk": "^0.2.0"
+  },
+  "description": "deBug ingest: validate, group and store events. Deploy as a Firebase Cloud Function or AWS Lambda.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Abantu-Digital/deBug.git",
+    "directory": "packages/ingest"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "typecheck": "tsc -p .",
+    "build": "tsup"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts"
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-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.