@interfere/react 10.0.0 → 10.0.1-canary.1

package/dist/plugins/replay.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"replay.mjs","names":[],"sources":["../../src/plugins/replay.ts"],"sourcesContent":["import { trace } from \"@opentelemetry/api\";\n\nimport { resolveTargets } from \"../internal/config.js\";\nimport { onPageHidden } from \"../internal/page-lifecycle.js\";\nimport { createLogger } from \"../util/log.js\";\nimport type { Plugin, PluginContext } from \"./lib/types.js\";\n\nconst log = createLogger(\"replay\");\n\nconst FLUSH_INTERVAL_MS = 10_000;\nconst UPLOAD_PATH_PREFIX = \"/v2/replay/upload/\";\nconst TRACER_NAME = \"@interfere/react/replay\";\nconst TRAILING_SLASH_RE = /\\/$/;\n\ninterface UploadResponse {\n  objectKey: string;\n}\n\ninterface ChunkPayload {\n  events: string[];\n  firstTs: number | null;\n  lastTs: number | null;\n}\n\ninterface DeliverInput {\n  authHeaders: Record<string, string>;\n  ctx: PluginContext;\n  payload: ChunkPayload;\n  uploadBaseUrl: string;\n}\n\n/**\n * POSTs the chunk's events array to the collector. The collector writes\n * to R2 server-side and returns the object key we stamp onto the\n * `replay.chunk` span event. Single round trip; if the request fails,\n * the chunk is dropped — replay is best-effort and the customer's next\n * session will still record cleanly.\n */\nasync function deliverChunk({\n  ctx,\n  uploadBaseUrl,\n  authHeaders,\n  payload,\n}: DeliverInput): Promise<void> {\n  const sessionId = ctx.getSessionId();\n  if (!sessionId) {\n    return;\n  }\n\n  const body = JSON.stringify(payload.events);\n  const sizeBytes = body.length;\n\n  const res = await fetch(`${uploadBaseUrl}${encodeURIComponent(sessionId)}`, {\n    method: \"POST\",\n    headers: { ...authHeaders, \"content-type\": \"application/json\" },\n    body,\n  });\n  if (!res.ok) {\n    log.warn(\"replay chunk upload rejected (%d)\", res.status);\n    return;\n  }\n\n  const { objectKey } = (await res.json()) as UploadResponse;\n\n  // Span-per-chunk is the cleanest OTel mapping: replay chunks are\n  // events-in-time, not \"things that happened during a span\", so the\n  // span itself carries the attrs. Mapper picks up by name later\n  // (PRD 3 replay UI work).\n  const span = trace.getTracer(TRACER_NAME).startSpan(\"replay.chunk\", {\n    attributes: {\n      \"replay.chunk.uri\": objectKey,\n      \"replay.chunk.size_bytes\": sizeBytes,\n      \"replay.chunk.event_count\": payload.events.length,\n      ...(payload.firstTs === null\n        ? {}\n        : { \"replay.chunk.first_event_ts\": payload.firstTs }),\n      ...(payload.lastTs === null\n        ? {}\n        : { \"replay.chunk.last_event_ts\": payload.lastTs }),\n    },\n  });\n  span.end();\n}\n\nexport const replayPlugin: Plugin = {\n  name: \"replay\",\n\n  setup(ctx) {\n    const targets = resolveTargets();\n    const uploadBaseUrl = `${targets.collectorBaseUrl.replace(TRAILING_SLASH_RE, \"\")}${UPLOAD_PATH_PREFIX}`;\n    const authHeaders = Object.fromEntries(targets.ingest.headers.entries());\n\n    let stopFn: (() => void) | null = null;\n    let events: string[] = [];\n    let flushTimer: ReturnType<typeof setInterval> | null = null;\n    let firstTs: number | null = null;\n    let lastTs: number | null = null;\n\n    const flush = () => {\n      if (events.length === 0) {\n        return;\n      }\n      const chunk = events;\n      events = [];\n      const payload: ChunkPayload = {\n        events: chunk,\n        firstTs,\n        lastTs,\n      };\n      firstTs = null;\n      lastTs = null;\n\n      // Fire-and-forget; replay capture must never block the rrweb event\n      // loop. Failed chunks are dropped — replay is best-effort and the\n      // next session will still record cleanly.\n      deliverChunk({ ctx, uploadBaseUrl, authHeaders, payload }).catch(\n        (error: unknown) => {\n          log.warn(\"replay chunk dropped: %o\", error);\n        }\n      );\n    };\n\n    let unsubscribeHidden: (() => void) | null = null;\n\n    const init = async () => {\n      try {\n        const rrweb = await import(\"rrweb\");\n        stopFn =\n          rrweb.record({\n            emit(event) {\n              const ts = Date.now();\n              if (firstTs === null) {\n                firstTs = ts;\n              }\n              lastTs = ts;\n              events.push(JSON.stringify(event));\n            },\n          }) ?? null;\n\n        flushTimer = setInterval(flush, FLUSH_INTERVAL_MS);\n        unsubscribeHidden = onPageHidden(flush);\n        log.debug(\"recording started\");\n      } catch {\n        log.error(\"rrweb failed to load, replay disabled\");\n      }\n    };\n\n    // `init()` swallows rrweb load failures internally — no outer `.catch`\n    // needed (it can never reject).\n    init();\n\n    return () => {\n      flush();\n      stopFn?.();\n      if (flushTimer) {\n        clearInterval(flushTimer);\n      }\n      unsubscribeHidden?.();\n    };\n  },\n};\n\nexport default replayPlugin;\n"],"mappings":";;;;;AAOA,MAAM,MAAM,aAAa,SAAS;AAElC,MAAM,oBAAoB;AAC1B,MAAM,qBAAqB;AAC3B,MAAM,cAAc;AACpB,MAAM,oBAAoB;;;;;;;;AA0B1B,eAAe,aAAa,EAC1B,KACA,eACA,aACA,WAC8B;CAC9B,MAAM,YAAY,IAAI,cAAc;CACpC,IAAI,CAAC,WACH;CAGF,MAAM,OAAO,KAAK,UAAU,QAAQ,OAAO;CAC3C,MAAM,YAAY,KAAK;CAEvB,MAAM,MAAM,MAAM,MAAM,GAAG,gBAAgB,mBAAmB,UAAU,IAAI;EAC1E,QAAQ;EACR,SAAS;GAAE,GAAG;GAAa,gBAAgB;GAAoB;EAC/D;EACD,CAAC;CACF,IAAI,CAAC,IAAI,IAAI;EACX,IAAI,KAAK,qCAAqC,IAAI,OAAO;EACzD;;CAGF,MAAM,EAAE,cAAe,MAAM,IAAI,MAAM;CAmBvC,MAbmB,UAAU,YAAY,CAAC,UAAU,gBAAgB,EAClE,YAAY;EACV,oBAAoB;EACpB,2BAA2B;EAC3B,4BAA4B,QAAQ,OAAO;EAC3C,GAAI,QAAQ,YAAY,OACpB,EAAE,GACF,EAAE,+BAA+B,QAAQ,SAAS;EACtD,GAAI,QAAQ,WAAW,OACnB,EAAE,GACF,EAAE,8BAA8B,QAAQ,QAAQ;EACrD,EACF,CACG,CAAC,KAAK;;AAGZ,MAAa,eAAuB;CAClC,MAAM;CAEN,MAAM,KAAK;EACT,MAAM,UAAU,gBAAgB;EAChC,MAAM,gBAAgB,GAAG,QAAQ,iBAAiB,QAAQ,mBAAmB,GAAG,GAAG;EACnF,MAAM,cAAc,OAAO,YAAY,QAAQ,OAAO,QAAQ,SAAS,CAAC;EAExE,IAAI,SAA8B;EAClC,IAAI,SAAmB,EAAE;EACzB,IAAI,aAAoD;EACxD,IAAI,UAAyB;EAC7B,IAAI,SAAwB;EAE5B,MAAM,cAAc;GAClB,IAAI,OAAO,WAAW,GACpB;GAEF,MAAM,QAAQ;GACd,SAAS,EAAE;GACX,MAAM,UAAwB;IAC5B,QAAQ;IACR;IACA;IACD;GACD,UAAU;GACV,SAAS;GAKT,aAAa;IAAE;IAAK;IAAe;IAAa;IAAS,CAAC,CAAC,OACxD,UAAmB;IAClB,IAAI,KAAK,4BAA4B,MAAM;KAE9C;;EAGH,IAAI,oBAAyC;EAE7C,MAAM,OAAO,YAAY;GACvB,IAAI;IAEF,UACE,MAFkB,OAAO,UAEnB,OAAO,EACX,KAAK,OAAO;KACV,MAAM,KAAK,KAAK,KAAK;KACrB,IAAI,YAAY,MACd,UAAU;KAEZ,SAAS;KACT,OAAO,KAAK,KAAK,UAAU,MAAM,CAAC;OAErC,CAAC,IAAI;IAER,aAAa,YAAY,OAAO,kBAAkB;IAClD,oBAAoB,aAAa,MAAM;IACvC,IAAI,MAAM,oBAAoB;WACxB;IACN,IAAI,MAAM,wCAAwC;;;EAMtD,MAAM;EAEN,aAAa;GACX,OAAO;GACP,UAAU;GACV,IAAI,YACF,cAAc,WAAW;GAE3B,qBAAqB;;;CAG1B"}
+{"version":3,"file":"replay.mjs","names":[],"sources":["../../src/plugins/replay.ts"],"sourcesContent":["import { trace } from \"@opentelemetry/api\";\n\nimport { appendPathBeforeQuery, resolveTargets } from \"../internal/config.js\";\nimport { onPageHidden } from \"../internal/page-lifecycle.js\";\nimport { createLogger } from \"../util/log.js\";\nimport type { Plugin, PluginContext } from \"./lib/types.js\";\n\nconst log = createLogger(\"replay\");\n\nconst FLUSH_INTERVAL_MS = 10_000;\nconst UPLOAD_PATH_PREFIX = \"/v2/replay/upload/\";\nconst TRACER_NAME = \"@interfere/react/replay\";\n\ninterface UploadResponse {\n  objectKey: string;\n}\n\ninterface ChunkPayload {\n  events: string[];\n  firstTs: number | null;\n  lastTs: number | null;\n}\n\ninterface DeliverInput {\n  authHeaders: Record<string, string>;\n  ctx: PluginContext;\n  payload: ChunkPayload;\n  uploadBaseUrl: string;\n}\n\n/**\n * POSTs the chunk's events array to the collector. The collector writes\n * to R2 server-side and returns the object key we stamp onto the\n * `replay.chunk` span event. Single round trip; if the request fails,\n * the chunk is dropped — replay is best-effort and the customer's next\n * session will still record cleanly.\n */\nasync function deliverChunk({\n  ctx,\n  uploadBaseUrl,\n  authHeaders,\n  payload,\n}: DeliverInput): Promise<void> {\n  const sessionId = ctx.getSessionId();\n  if (!sessionId) {\n    return;\n  }\n\n  const body = JSON.stringify(payload.events);\n  const sizeBytes = body.length;\n\n  const res = await fetch(\n    appendPathBeforeQuery(\n      uploadBaseUrl,\n      `${UPLOAD_PATH_PREFIX}${encodeURIComponent(sessionId)}`\n    ),\n    {\n      method: \"POST\",\n      headers: { ...authHeaders, \"content-type\": \"application/json\" },\n      body,\n    }\n  );\n  if (!res.ok) {\n    log.warn(\"replay chunk upload rejected (%d)\", res.status);\n    return;\n  }\n\n  const { objectKey } = (await res.json()) as UploadResponse;\n\n  // Span-per-chunk is the cleanest OTel mapping: replay chunks are\n  // events-in-time, not \"things that happened during a span\", so the\n  // span itself carries the attrs. Mapper picks up by name later\n  // (PRD 3 replay UI work).\n  const span = trace.getTracer(TRACER_NAME).startSpan(\"replay.chunk\", {\n    attributes: {\n      \"replay.chunk.uri\": objectKey,\n      \"replay.chunk.size_bytes\": sizeBytes,\n      \"replay.chunk.event_count\": payload.events.length,\n      ...(payload.firstTs === null\n        ? {}\n        : { \"replay.chunk.first_event_ts\": payload.firstTs }),\n      ...(payload.lastTs === null\n        ? {}\n        : { \"replay.chunk.last_event_ts\": payload.lastTs }),\n    },\n  });\n  span.end();\n}\n\nexport const replayPlugin: Plugin = {\n  name: \"replay\",\n\n  setup(ctx) {\n    const targets = resolveTargets();\n    const uploadBaseUrl = targets.collectorBaseUrl;\n    const authHeaders = Object.fromEntries(targets.ingest.headers.entries());\n\n    let stopFn: (() => void) | null = null;\n    let events: string[] = [];\n    let flushTimer: ReturnType<typeof setInterval> | null = null;\n    let firstTs: number | null = null;\n    let lastTs: number | null = null;\n\n    const flush = () => {\n      if (events.length === 0) {\n        return;\n      }\n      const chunk = events;\n      events = [];\n      const payload: ChunkPayload = {\n        events: chunk,\n        firstTs,\n        lastTs,\n      };\n      firstTs = null;\n      lastTs = null;\n\n      // Fire-and-forget; replay capture must never block the rrweb event\n      // loop. Failed chunks are dropped — replay is best-effort and the\n      // next session will still record cleanly.\n      deliverChunk({ ctx, uploadBaseUrl, authHeaders, payload }).catch(\n        (error: unknown) => {\n          log.warn(\"replay chunk dropped: %o\", error);\n        }\n      );\n    };\n\n    let unsubscribeHidden: (() => void) | null = null;\n\n    const init = async () => {\n      try {\n        const rrweb = await import(\"rrweb\");\n        stopFn =\n          rrweb.record({\n            emit(event) {\n              const ts = Date.now();\n              if (firstTs === null) {\n                firstTs = ts;\n              }\n              lastTs = ts;\n              events.push(JSON.stringify(event));\n            },\n          }) ?? null;\n\n        flushTimer = setInterval(flush, FLUSH_INTERVAL_MS);\n        unsubscribeHidden = onPageHidden(flush);\n        log.debug(\"recording started\");\n      } catch {\n        log.error(\"rrweb failed to load, replay disabled\");\n      }\n    };\n\n    // `init()` swallows rrweb load failures internally — no outer `.catch`\n    // needed (it can never reject).\n    init();\n\n    return () => {\n      flush();\n      stopFn?.();\n      if (flushTimer) {\n        clearInterval(flushTimer);\n      }\n      unsubscribeHidden?.();\n    };\n  },\n};\n\nexport default replayPlugin;\n"],"mappings":"kNAOA,MAAM,IAAM,aAAa,QAAQ,EA8BjC,eAAe,aAAa,CAC1B,IACA,cACA,YACA,SAC8B,CAC9B,IAAM,UAAY,IAAI,aAAa,EACnC,GAAI,CAAC,UACH,OAGF,IAAM,KAAO,KAAK,UAAU,QAAQ,MAAM,EACpC,UAAY,KAAK,OAEjB,IAAM,MAAM,MAChB,sBACE,cACA,qBAAwB,mBAAmB,SAAS,GACtD,EACA,CACE,OAAQ,OACR,QAAS,CAAE,GAAG,YAAa,eAAgB,kBAAmB,EAC9D,IACF,CACF,EACA,GAAI,CAAC,IAAI,GAAI,CACX,IAAI,KAAK,oCAAqC,IAAI,MAAM,EACxD,MACF,CAEA,GAAM,CAAE,WAAe,MAAM,IAAI,KAAK,EAmBtC,MAbmB,UAAU,yBAAW,EAAE,UAAU,eAAgB,CAClE,WAAY,CACV,mBAAoB,UACpB,0BAA2B,UAC3B,2BAA4B,QAAQ,OAAO,OAC3C,GAAI,QAAQ,UAAY,KACpB,CAAC,EACD,CAAE,8BAA+B,QAAQ,OAAQ,EACrD,GAAI,QAAQ,SAAW,KACnB,CAAC,EACD,CAAE,6BAA8B,QAAQ,MAAO,CACrD,CACF,CACG,EAAE,IAAI,CACX,CAEA,MAAa,aAAuB,CAClC,KAAM,SAEN,MAAM,IAAK,CACT,IAAM,QAAU,eAAe,EACzB,cAAgB,QAAQ,iBACxB,YAAc,OAAO,YAAY,QAAQ,OAAO,QAAQ,QAAQ,CAAC,EAEnE,OAA8B,KAC9B,OAAmB,CAAC,EACpB,WAAoD,KACpD,QAAyB,KACzB,OAAwB,KAEtB,UAAc,CAClB,GAAI,OAAO,SAAW,EACpB,OAEF,IAAM,MAAQ,OACd,OAAS,CAAC,EACV,IAAM,QAAwB,CAC5B,OAAQ,MACR,QACA,MACF,EACA,QAAU,KACV,OAAS,KAKT,aAAa,CAAE,IAAK,cAAe,YAAa,OAAQ,CAAC,EAAE,MACxD,OAAmB,CAClB,IAAI,KAAK,2BAA4B,KAAK,CAC5C,CACF,CACF,EAEI,kBAAyC,KA6B7C,OAFA,SAzByB,CACvB,GAAI,CAEF,QACE,MAFkB,OAAO,UAEnB,OAAO,CACX,KAAK,MAAO,CACV,IAAM,GAAK,KAAK,IAAI,EAChB,UAAY,OACd,QAAU,IAEZ,OAAS,GACT,OAAO,KAAK,KAAK,UAAU,KAAK,CAAC,CACnC,CACF,CAAC,GAAK,KAER,WAAa,YAAY,MAAO,GAAiB,EACjD,kBAAoB,aAAa,KAAK,EACtC,IAAI,MAAM,mBAAmB,CAC/B,MAAQ,CACN,IAAI,MAAM,uCAAuC,CACnD,CACF,GAIK,MAEQ,CACX,MAAM,EACN,SAAS,EACL,YACF,cAAc,UAAU,EAE1B,oBAAoB,CACtB,CACF,CACF"}

package/dist/provider.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.mts","names":[],"sources":["../src/provider.tsx"],"mappings":";;;;;;UAmBU,sBAAA,SAA+B,iBAAA;EACvC,OAAA,GAAU,YAAA;EADF;;;;;;;;;;;;;;;;EAkBR,aAAA;EAU+B;;;;;;EAH/B,MAAA,EAAQ,MAAA;AAAA;AAAA,iBAGM,iBAAA,CAAA;EACd,MAAA;EACA,QAAA;EACA,OAAA;EACA;AAAA,GACC,sBAAA,GAAyB,SAAA;AAAA,iBAwBZ,YAAA,CAAA,GAAgB,qBAAA;AAAA,iBAQhB,UAAA,CAAA"}
+{"version":3,"file":"provider.d.mts","names":[],"sources":["../src/provider.tsx"],"mappings":";;;;;;UAmBU,sBAAA,SAA+B,iBAAA;EACvC,OAAA,GAAU,YAAA;EADF;;;;;;;;;;;;;;;AAyBM;EAPd,aAAA;EAU+B;;;;;;EAH/B,MAAA,EAAQ,MAAA;AAAA;AAAA,iBAGM,iBAAA,CAAA;EACd,MAAA;EACA,QAAA;EACA,OAAA;EACA;AAAA,GACC,sBAAA,GAAyB,SAAA;AAAA,iBAwBZ,YAAA,CAAA,GAAgB,qBAAqB;AAAA,iBAQrC,UAAA,CAAA"}

package/dist/provider.mjs

@@ -1,31 +1 @@
-"use client";
-import { InterfereContext, NULL_CONTEXT_VALUE } from "./internal/react-context.mjs";
-import { CaptureBoundary } from "./internal/capture-boundary.mjs";
-import { useContext, useEffect } from "react";
-import { jsx } from "react/jsx-runtime";
-//#region src/provider.tsx
-function InterfereProvider({ kernel, children, consent, errorBoundary = true }) {
-	useEffect(() => {
-		kernel?.syncConsent(consent);
-	}, [kernel, consent]);
-	return /* @__PURE__ */ jsx(InterfereContext, {
-		value: kernel ? {
-			consent: kernel.consent,
-			device: kernel.device,
-			identity: kernel.identity,
-			kernel,
-			session: kernel.session
-		} : NULL_CONTEXT_VALUE,
-		children: errorBoundary ? /* @__PURE__ */ jsx(CaptureBoundary, { children }) : children
-	});
-}
-function useInterfere() {
-	const ctx = useContext(InterfereContext);
-	if (!ctx) throw new Error("useInterfere must be used within <InterfereProvider>");
-	return ctx;
-}
-function useSession() {
-	return useInterfere().session.getId();
-}
-//#endregion
-export { InterfereContext, InterfereProvider, useInterfere, useSession };
+"use client";import{InterfereContext,NULL_CONTEXT_VALUE}from"./internal/react-context.mjs";import{CaptureBoundary}from"./internal/capture-boundary.mjs";import{useContext,useEffect}from"react";import{jsx}from"react/jsx-runtime";function InterfereProvider({kernel,children,consent,errorBoundary=!0}){return useEffect(()=>{kernel?.syncConsent(consent)},[kernel,consent]),jsx(InterfereContext,{value:kernel?{consent:kernel.consent,device:kernel.device,identity:kernel.identity,kernel,session:kernel.session}:NULL_CONTEXT_VALUE,children:errorBoundary?jsx(CaptureBoundary,{children}):children})}function useInterfere(){let ctx=useContext(InterfereContext);if(!ctx)throw Error(`useInterfere must be used within <InterfereProvider>`);return ctx}function useSession(){return useInterfere().session.getId()}export{InterfereContext,InterfereProvider,useInterfere,useSession};

package/dist/provider.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"provider.mjs","names":[],"sources":["../src/provider.tsx"],"sourcesContent":["\"use client\";\n\nimport type { ConsentState } from \"@interfere/types/sdk/plugins/manifest\";\n\nimport {\n  type PropsWithChildren,\n  type ReactNode,\n  useContext,\n  useEffect,\n} from \"react\";\n\nimport { CaptureBoundary } from \"./internal/capture-boundary.js\";\nimport type { Kernel } from \"./internal/kernel.js\";\nimport type { InterfereContextValue } from \"./internal/react-context.js\";\nimport {\n  InterfereContext,\n  NULL_CONTEXT_VALUE,\n} from \"./internal/react-context.js\";\n\ninterface InterfereProviderProps extends PropsWithChildren {\n  consent?: ConsentState | undefined;\n  /**\n   * Auto-install an internal capture boundary around `children` so\n   * render-phase React errors are reported even when the host app has no\n   * `ErrorBoundary` / `error.tsx` of its own.\n   *\n   * The internal boundary is transparent: it captures the error and then\n   * re-throws so upstream boundaries (the customer's own, Next.js's\n   * `error.tsx` / `global-error.tsx`, or React's default unmount) keep full\n   * control of what the user sees. Safe to leave enabled.\n   *\n   * Pass `false` only if you explicitly don't want automatic capture of\n   * render-phase errors — for example, if you've already wired\n   * {@link reactErrorHandler} into `createRoot()`.\n   *\n   * @default true\n   */\n  errorBoundary?: boolean;\n  /**\n   * The active kernel from `init()`. Pass `null` (or omit on the server)\n   * when the SDK isn't initialized — useful during SSR/SSG where `init()`\n   * runs client-side only. The provider mounts with null-safe accessors\n   * and switches to the real kernel once it's available.\n   */\n  kernel: Kernel | null;\n}\n\nexport function InterfereProvider({\n  kernel,\n  children,\n  consent,\n  errorBoundary = true,\n}: InterfereProviderProps): ReactNode {\n  useEffect(() => {\n    kernel?.syncConsent(consent);\n  }, [kernel, consent]);\n\n  const value: InterfereContextValue = kernel\n    ? {\n        consent: kernel.consent,\n        device: kernel.device,\n        identity: kernel.identity,\n        kernel,\n        session: kernel.session,\n      }\n    : NULL_CONTEXT_VALUE;\n\n  const body = errorBoundary ? (\n    <CaptureBoundary>{children}</CaptureBoundary>\n  ) : (\n    children\n  );\n\n  return <InterfereContext value={value}>{body}</InterfereContext>;\n}\n\nexport function useInterfere(): InterfereContextValue {\n  const ctx = useContext(InterfereContext);\n  if (!ctx) {\n    throw new Error(\"useInterfere must be used within <InterfereProvider>\");\n  }\n  return ctx;\n}\n\nexport function useSession(): string | null {\n  return useInterfere().session.getId();\n}\n\nexport type { InterfereContextValue } from \"./internal/react-context.js\";\n// biome-ignore lint/performance/noBarrelFile: Re-export the context handle alongside the provider so consumers (custom error boundaries, the `@interfere/next` wrapper) can import everything from one entry.\nexport { InterfereContext } from \"./internal/react-context.js\";\n"],"mappings":";;;;;;AA+CA,SAAgB,kBAAkB,EAChC,QACA,UACA,SACA,gBAAgB,QACoB;CACpC,gBAAgB;EACd,QAAQ,YAAY,QAAQ;IAC3B,CAAC,QAAQ,QAAQ,CAAC;CAkBrB,OAAO,oBAAC,kBAAD;EAAkB,OAhBY,SACjC;GACE,SAAS,OAAO;GAChB,QAAQ,OAAO;GACf,UAAU,OAAO;GACjB;GACA,SAAS,OAAO;GACjB,GACD;YAES,gBACX,oBAAC,iBAAD,EAAkB,UAA2B,CAAA,GAE7C;EAG8D,CAAA;;AAGlE,SAAgB,eAAsC;CACpD,MAAM,MAAM,WAAW,iBAAiB;CACxC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,uDAAuD;CAEzE,OAAO;;AAGT,SAAgB,aAA4B;CAC1C,OAAO,cAAc,CAAC,QAAQ,OAAO"}
+{"version":3,"file":"provider.mjs","names":[],"sources":["../src/provider.tsx"],"sourcesContent":["\"use client\";\n\nimport type { ConsentState } from \"@interfere/types/sdk/plugins/manifest\";\n\nimport {\n  type PropsWithChildren,\n  type ReactNode,\n  useContext,\n  useEffect,\n} from \"react\";\n\nimport { CaptureBoundary } from \"./internal/capture-boundary.js\";\nimport type { Kernel } from \"./internal/kernel.js\";\nimport type { InterfereContextValue } from \"./internal/react-context.js\";\nimport {\n  InterfereContext,\n  NULL_CONTEXT_VALUE,\n} from \"./internal/react-context.js\";\n\ninterface InterfereProviderProps extends PropsWithChildren {\n  consent?: ConsentState | undefined;\n  /**\n   * Auto-install an internal capture boundary around `children` so\n   * render-phase React errors are reported even when the host app has no\n   * `ErrorBoundary` / `error.tsx` of its own.\n   *\n   * The internal boundary is transparent: it captures the error and then\n   * re-throws so upstream boundaries (the customer's own, Next.js's\n   * `error.tsx` / `global-error.tsx`, or React's default unmount) keep full\n   * control of what the user sees. Safe to leave enabled.\n   *\n   * Pass `false` only if you explicitly don't want automatic capture of\n   * render-phase errors — for example, if you've already wired\n   * {@link reactErrorHandler} into `createRoot()`.\n   *\n   * @default true\n   */\n  errorBoundary?: boolean;\n  /**\n   * The active kernel from `init()`. Pass `null` (or omit on the server)\n   * when the SDK isn't initialized — useful during SSR/SSG where `init()`\n   * runs client-side only. The provider mounts with null-safe accessors\n   * and switches to the real kernel once it's available.\n   */\n  kernel: Kernel | null;\n}\n\nexport function InterfereProvider({\n  kernel,\n  children,\n  consent,\n  errorBoundary = true,\n}: InterfereProviderProps): ReactNode {\n  useEffect(() => {\n    kernel?.syncConsent(consent);\n  }, [kernel, consent]);\n\n  const value: InterfereContextValue = kernel\n    ? {\n        consent: kernel.consent,\n        device: kernel.device,\n        identity: kernel.identity,\n        kernel,\n        session: kernel.session,\n      }\n    : NULL_CONTEXT_VALUE;\n\n  const body = errorBoundary ? (\n    <CaptureBoundary>{children}</CaptureBoundary>\n  ) : (\n    children\n  );\n\n  return <InterfereContext value={value}>{body}</InterfereContext>;\n}\n\nexport function useInterfere(): InterfereContextValue {\n  const ctx = useContext(InterfereContext);\n  if (!ctx) {\n    throw new Error(\"useInterfere must be used within <InterfereProvider>\");\n  }\n  return ctx;\n}\n\nexport function useSession(): string | null {\n  return useInterfere().session.getId();\n}\n\nexport type { InterfereContextValue } from \"./internal/react-context.js\";\n// biome-ignore lint/performance/noBarrelFile: Re-export the context handle alongside the provider so consumers (custom error boundaries, the `@interfere/next` wrapper) can import everything from one entry.\nexport { InterfereContext } from \"./internal/react-context.js\";\n"],"mappings":"mOA+CA,SAAgB,kBAAkB,CAChC,OACA,SACA,QACA,cAAgB,IACoB,CAqBpC,OApBA,cAAgB,CACd,QAAQ,YAAY,OAAO,CAC7B,EAAG,CAAC,OAAQ,OAAO,CAAC,EAkBb,IAAC,iBAAD,CAAkB,MAhBY,OACjC,CACE,QAAS,OAAO,QAChB,OAAQ,OAAO,OACf,SAAU,OAAO,SACjB,OACA,QAAS,OAAO,OAClB,EACA,4BAES,cACX,IAAC,gBAAD,CAAkB,QAA0B,CAAA,EAE5C,QAG6D,CAAA,CACjE,CAEA,SAAgB,cAAsC,CACpD,IAAM,IAAM,WAAW,gBAAgB,EACvC,GAAI,CAAC,IACH,MAAU,MAAM,sDAAsD,EAExE,OAAO,GACT,CAEA,SAAgB,YAA4B,CAC1C,OAAO,aAAa,EAAE,QAAQ,MAAM,CACtC"}

package/dist/react-error-handler.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"react-error-handler.d.mts","names":[],"sources":["../src/react-error-handler.ts"],"mappings":";;;;;AAKmD;;;;;UASzC,kBAAA;EACR,cAAA;AAAA;AAAA,KAGG,iBAAA,IAAqB,KAAA,WAAgB,IAAA,EAAM,kBAAA;AAAA,UAE/B,0BAAA;EAF+B;;;;AAEhD;EAME,aAAA,GAAgB,iBAAA;;;;;;EAMhB,kBAAA,GAAqB,iBAAA;EANrB;;;;;EAYA,eAAA,GAAkB,iBAAA;AAAA;AAAA,UAGH,wBAAA,SAAiC,0BAAA;EAAjC;;;;;;;;;EAUf,MAAA,GAAS,MAAA,UAAgB,MAAA;AAAA;AAAA,UAGjB,sBAAA;EACR,aAAA,EAAe,iBAAA;EACf,kBAAA,EAAoB,iBAAA;EACpB,eAAA,EAAiB,iBAAA;AAAA;;;;;;;;;;;;;;;AAqCnB;;;;;;;;;;;iBAAgB,iBAAA,CACd,OAAA,GAAS,wBAAA,GACR,sBAAA"}
+{"version":3,"file":"react-error-handler.d.mts","names":[],"sources":["../src/react-error-handler.ts"],"mappings":";;;;;AAKmD;;;;AAUnC;UADN,kBAAA;EACR,cAAc;AAAA;AAAA,KAGX,iBAAA,IAAqB,KAAA,WAAgB,IAAA,EAAM,kBAAkB;AAAA,UAEjD,0BAAA;EAF+B;;;AAAkB;AAElE;EAME,aAAA,GAAgB,iBAAA;;;;;;EAMhB,kBAAA,GAAqB,iBAAA;EANrB;;;;;EAYA,eAAA,GAAkB,iBAAA;AAAA;AAAA,UAGH,wBAAA,SAAiC,0BAAA;EAAjC;;;;;;;;;EAUf,MAAA,GAAS,MAAA,UAAgB,MAAA;AAAA;AAAA,UAGjB,sBAAA;EACR,aAAA,EAAe,iBAAA;EACf,kBAAA,EAAoB,iBAAA;EACpB,eAAA,EAAiB,iBAAA;AAAA;;;;;;;;;;;;;;AAAiB;AAqCpC;;;;;;;;AAEyB;;;iBAFT,iBAAA,CACd,OAAA,GAAS,wBAAA,GACR,sBAAsB"}

package/dist/react-error-handler.mjs

@@ -1,62 +1 @@
-"use client";
-import { captureReactError } from "./internal/capture.mjs";
-import { MECHANISM_TYPE } from "@interfere/types/sdk/errors";
-//#region src/react-error-handler.ts
-function resolveKernel(source) {
-	if (!source) return null;
-	return typeof source === "function" ? source() : source;
-}
-/**
-* Creates the three error callbacks React 19's `createRoot()` / `hydrateRoot()`
-* accept, wired into Interfere's capture pipeline.
-*
-* ```ts
-* import { createRoot } from "react-dom/client";
-* import { getKernelOrNull } from "@interfere/next";
-* import { reactErrorHandler } from "@interfere/react/react-error-handler";
-*
-* createRoot(
-*   document.getElementById("root")!,
-*   reactErrorHandler({ kernel: getKernelOrNull })
-* ).render(<App />);
-* ```
-*
-* Pass your own callbacks to observe errors without replacing the capture
-* behaviour — user callbacks run after Interfere has captured:
-*
-* ```ts
-* reactErrorHandler({
-*   kernel: getKernelOrNull,
-*   onUncaughtError: (err) => myLogger.fatal(err),
-* });
-* ```
-*/
-function reactErrorHandler(options = {}) {
-	const { kernel: kernelSource, ...callbacks } = options;
-	return {
-		onCaughtError(error, info) {
-			if (error instanceof Error) captureReactError(resolveKernel(kernelSource), error, info.componentStack, {
-				type: MECHANISM_TYPE.react.caughtError,
-				handled: true
-			});
-			callbacks.onCaughtError?.(error, info);
-		},
-		onUncaughtError(error, info) {
-			if (error instanceof Error) captureReactError(resolveKernel(kernelSource), error, info.componentStack, {
-				type: MECHANISM_TYPE.react.uncaughtError,
-				handled: false
-			});
-			callbacks.onUncaughtError?.(error, info);
-		},
-		onRecoverableError(error, info) {
-			if (error instanceof Error) captureReactError(resolveKernel(kernelSource), error, info.componentStack, {
-				type: MECHANISM_TYPE.react.recoverableError,
-				handled: true,
-				synthetic: true
-			});
-			callbacks.onRecoverableError?.(error, info);
-		}
-	};
-}
-//#endregion
-export { reactErrorHandler };
+"use client";import{captureReactError}from"./internal/capture.mjs";import{MECHANISM_TYPE}from"@interfere/types/sdk/errors";function resolveKernel(source){return source?typeof source==`function`?source():source:null}function reactErrorHandler(options={}){let{kernel:kernelSource,...callbacks}=options;return{onCaughtError(error,info){error instanceof Error&&captureReactError(resolveKernel(kernelSource),error,info.componentStack,{type:MECHANISM_TYPE.react.caughtError,handled:!0}),callbacks.onCaughtError?.(error,info)},onUncaughtError(error,info){error instanceof Error&&captureReactError(resolveKernel(kernelSource),error,info.componentStack,{type:MECHANISM_TYPE.react.uncaughtError,handled:!1}),callbacks.onUncaughtError?.(error,info)},onRecoverableError(error,info){error instanceof Error&&captureReactError(resolveKernel(kernelSource),error,info.componentStack,{type:MECHANISM_TYPE.react.recoverableError,handled:!0,synthetic:!0}),callbacks.onRecoverableError?.(error,info)}}}export{reactErrorHandler};

package/dist/react-error-handler.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"react-error-handler.mjs","names":[],"sources":["../src/react-error-handler.ts"],"sourcesContent":["\"use client\";\n\nimport { MECHANISM_TYPE } from \"@interfere/types/sdk/errors\";\n\nimport { captureReactError } from \"./internal/capture.js\";\nimport type { Kernel } from \"./internal/kernel.js\";\n\n/**\n * Matches the shape React 19 passes to `onCaughtError`, `onUncaughtError`,\n * and `onRecoverableError` on `createRoot()` / `hydrateRoot()`.\n *\n * We intentionally keep this permissive — React has iterated on the exact\n * fields of `ErrorInfo` across 19.x minors and we only need `componentStack`.\n */\ninterface ReactRootErrorInfo {\n  componentStack?: string | null | undefined;\n}\n\ntype RootErrorCallback = (error: unknown, info: ReactRootErrorInfo) => void;\n\nexport interface ReactErrorHandlerCallbacks {\n  /**\n   * Called when a React error boundary caught and handled an error. Interfere\n   * reports it with `mechanism.handled: true`. Your callback runs after the\n   * capture.\n   */\n  onCaughtError?: RootErrorCallback;\n  /**\n   * Called when concurrent React auto-recovered from an error by retrying\n   * the render. Reported with `mechanism.synthetic: true` so the agent can\n   * deprioritize — these often aren't user-facing bugs.\n   */\n  onRecoverableError?: RootErrorCallback;\n  /**\n   * Called when a render-phase error propagated past every boundary and\n   * React unmounted (or fell back to its default UI). Reported with\n   * `mechanism.handled: false` — this is the \"real\" uncaught case.\n   */\n  onUncaughtError?: RootErrorCallback;\n}\n\nexport interface ReactErrorHandlerOptions extends ReactErrorHandlerCallbacks {\n  /**\n   * The kernel to capture errors against. Pass either the kernel directly\n   * or a getter — framework wrappers expose `getKernelOrNull()` for the\n   * latter pattern, which lets you wire the handler before `init()`\n   * resolves. Pass `getKernelOrNull` (not `getKernel`) — the throwing\n   * variant breaks this contract since the handler runs in error-recovery\n   * paths where rethrowing isn't useful. Capture is silently skipped when\n   * no kernel is available.\n   */\n  kernel?: Kernel | (() => Kernel | null) | null;\n}\n\ninterface ReactRootErrorHandlers {\n  onCaughtError: RootErrorCallback;\n  onRecoverableError: RootErrorCallback;\n  onUncaughtError: RootErrorCallback;\n}\n\nfunction resolveKernel(\n  source: ReactErrorHandlerOptions[\"kernel\"]\n): Kernel | null {\n  if (!source) {\n    return null;\n  }\n  return typeof source === \"function\" ? source() : source;\n}\n\n/**\n * Creates the three error callbacks React 19's `createRoot()` / `hydrateRoot()`\n * accept, wired into Interfere's capture pipeline.\n *\n * ```ts\n * import { createRoot } from \"react-dom/client\";\n * import { getKernelOrNull } from \"@interfere/next\";\n * import { reactErrorHandler } from \"@interfere/react/react-error-handler\";\n *\n * createRoot(\n *   document.getElementById(\"root\")!,\n *   reactErrorHandler({ kernel: getKernelOrNull })\n * ).render(<App />);\n * ```\n *\n * Pass your own callbacks to observe errors without replacing the capture\n * behaviour — user callbacks run after Interfere has captured:\n *\n * ```ts\n * reactErrorHandler({\n *   kernel: getKernelOrNull,\n *   onUncaughtError: (err) => myLogger.fatal(err),\n * });\n * ```\n */\nexport function reactErrorHandler(\n  options: ReactErrorHandlerOptions = {}\n): ReactRootErrorHandlers {\n  const { kernel: kernelSource, ...callbacks } = options;\n  return {\n    onCaughtError(error, info) {\n      if (error instanceof Error) {\n        captureReactError(\n          resolveKernel(kernelSource),\n          error,\n          info.componentStack,\n          {\n            type: MECHANISM_TYPE.react.caughtError,\n            handled: true,\n          }\n        );\n      }\n      callbacks.onCaughtError?.(error, info);\n    },\n    onUncaughtError(error, info) {\n      if (error instanceof Error) {\n        captureReactError(\n          resolveKernel(kernelSource),\n          error,\n          info.componentStack,\n          {\n            type: MECHANISM_TYPE.react.uncaughtError,\n            handled: false,\n          }\n        );\n      }\n      callbacks.onUncaughtError?.(error, info);\n    },\n    onRecoverableError(error, info) {\n      if (error instanceof Error) {\n        captureReactError(\n          resolveKernel(kernelSource),\n          error,\n          info.componentStack,\n          {\n            type: MECHANISM_TYPE.react.recoverableError,\n            handled: true,\n            synthetic: true,\n          }\n        );\n      }\n      callbacks.onRecoverableError?.(error, info);\n    },\n  };\n}\n"],"mappings":";;;;AA4DA,SAAS,cACP,QACe;CACf,IAAI,CAAC,QACH,OAAO;CAET,OAAO,OAAO,WAAW,aAAa,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BnD,SAAgB,kBACd,UAAoC,EAAE,EACd;CACxB,MAAM,EAAE,QAAQ,cAAc,GAAG,cAAc;CAC/C,OAAO;EACL,cAAc,OAAO,MAAM;GACzB,IAAI,iBAAiB,OACnB,kBACE,cAAc,aAAa,EAC3B,OACA,KAAK,gBACL;IACE,MAAM,eAAe,MAAM;IAC3B,SAAS;IACV,CACF;GAEH,UAAU,gBAAgB,OAAO,KAAK;;EAExC,gBAAgB,OAAO,MAAM;GAC3B,IAAI,iBAAiB,OACnB,kBACE,cAAc,aAAa,EAC3B,OACA,KAAK,gBACL;IACE,MAAM,eAAe,MAAM;IAC3B,SAAS;IACV,CACF;GAEH,UAAU,kBAAkB,OAAO,KAAK;;EAE1C,mBAAmB,OAAO,MAAM;GAC9B,IAAI,iBAAiB,OACnB,kBACE,cAAc,aAAa,EAC3B,OACA,KAAK,gBACL;IACE,MAAM,eAAe,MAAM;IAC3B,SAAS;IACT,WAAW;IACZ,CACF;GAEH,UAAU,qBAAqB,OAAO,KAAK;;EAE9C"}
+{"version":3,"file":"react-error-handler.mjs","names":[],"sources":["../src/react-error-handler.ts"],"sourcesContent":["\"use client\";\n\nimport { MECHANISM_TYPE } from \"@interfere/types/sdk/errors\";\n\nimport { captureReactError } from \"./internal/capture.js\";\nimport type { Kernel } from \"./internal/kernel.js\";\n\n/**\n * Matches the shape React 19 passes to `onCaughtError`, `onUncaughtError`,\n * and `onRecoverableError` on `createRoot()` / `hydrateRoot()`.\n *\n * We intentionally keep this permissive — React has iterated on the exact\n * fields of `ErrorInfo` across 19.x minors and we only need `componentStack`.\n */\ninterface ReactRootErrorInfo {\n  componentStack?: string | null | undefined;\n}\n\ntype RootErrorCallback = (error: unknown, info: ReactRootErrorInfo) => void;\n\nexport interface ReactErrorHandlerCallbacks {\n  /**\n   * Called when a React error boundary caught and handled an error. Interfere\n   * reports it with `mechanism.handled: true`. Your callback runs after the\n   * capture.\n   */\n  onCaughtError?: RootErrorCallback;\n  /**\n   * Called when concurrent React auto-recovered from an error by retrying\n   * the render. Reported with `mechanism.synthetic: true` so the agent can\n   * deprioritize — these often aren't user-facing bugs.\n   */\n  onRecoverableError?: RootErrorCallback;\n  /**\n   * Called when a render-phase error propagated past every boundary and\n   * React unmounted (or fell back to its default UI). Reported with\n   * `mechanism.handled: false` — this is the \"real\" uncaught case.\n   */\n  onUncaughtError?: RootErrorCallback;\n}\n\nexport interface ReactErrorHandlerOptions extends ReactErrorHandlerCallbacks {\n  /**\n   * The kernel to capture errors against. Pass either the kernel directly\n   * or a getter — framework wrappers expose `getKernelOrNull()` for the\n   * latter pattern, which lets you wire the handler before `init()`\n   * resolves. Pass `getKernelOrNull` (not `getKernel`) — the throwing\n   * variant breaks this contract since the handler runs in error-recovery\n   * paths where rethrowing isn't useful. Capture is silently skipped when\n   * no kernel is available.\n   */\n  kernel?: Kernel | (() => Kernel | null) | null;\n}\n\ninterface ReactRootErrorHandlers {\n  onCaughtError: RootErrorCallback;\n  onRecoverableError: RootErrorCallback;\n  onUncaughtError: RootErrorCallback;\n}\n\nfunction resolveKernel(\n  source: ReactErrorHandlerOptions[\"kernel\"]\n): Kernel | null {\n  if (!source) {\n    return null;\n  }\n  return typeof source === \"function\" ? source() : source;\n}\n\n/**\n * Creates the three error callbacks React 19's `createRoot()` / `hydrateRoot()`\n * accept, wired into Interfere's capture pipeline.\n *\n * ```ts\n * import { createRoot } from \"react-dom/client\";\n * import { getKernelOrNull } from \"@interfere/next\";\n * import { reactErrorHandler } from \"@interfere/react/react-error-handler\";\n *\n * createRoot(\n *   document.getElementById(\"root\")!,\n *   reactErrorHandler({ kernel: getKernelOrNull })\n * ).render(<App />);\n * ```\n *\n * Pass your own callbacks to observe errors without replacing the capture\n * behaviour — user callbacks run after Interfere has captured:\n *\n * ```ts\n * reactErrorHandler({\n *   kernel: getKernelOrNull,\n *   onUncaughtError: (err) => myLogger.fatal(err),\n * });\n * ```\n */\nexport function reactErrorHandler(\n  options: ReactErrorHandlerOptions = {}\n): ReactRootErrorHandlers {\n  const { kernel: kernelSource, ...callbacks } = options;\n  return {\n    onCaughtError(error, info) {\n      if (error instanceof Error) {\n        captureReactError(\n          resolveKernel(kernelSource),\n          error,\n          info.componentStack,\n          {\n            type: MECHANISM_TYPE.react.caughtError,\n            handled: true,\n          }\n        );\n      }\n      callbacks.onCaughtError?.(error, info);\n    },\n    onUncaughtError(error, info) {\n      if (error instanceof Error) {\n        captureReactError(\n          resolveKernel(kernelSource),\n          error,\n          info.componentStack,\n          {\n            type: MECHANISM_TYPE.react.uncaughtError,\n            handled: false,\n          }\n        );\n      }\n      callbacks.onUncaughtError?.(error, info);\n    },\n    onRecoverableError(error, info) {\n      if (error instanceof Error) {\n        captureReactError(\n          resolveKernel(kernelSource),\n          error,\n          info.componentStack,\n          {\n            type: MECHANISM_TYPE.react.recoverableError,\n            handled: true,\n            synthetic: true,\n          }\n        );\n      }\n      callbacks.onRecoverableError?.(error, info);\n    },\n  };\n}\n"],"mappings":"2HA4DA,SAAS,cACP,OACe,CAIf,OAHK,OAGE,OAAO,QAAW,WAAa,OAAO,EAAI,OAFxC,IAGX,CA2BA,SAAgB,kBACd,QAAoC,CAAC,EACb,CACxB,GAAM,CAAE,OAAQ,aAAc,GAAG,WAAc,QAC/C,MAAO,CACL,cAAc,MAAO,KAAM,CACrB,iBAAiB,OACnB,kBACE,cAAc,YAAY,EAC1B,MACA,KAAK,eACL,CACE,KAAM,eAAe,MAAM,YAC3B,QAAS,EACX,CACF,EAEF,UAAU,gBAAgB,MAAO,IAAI,CACvC,EACA,gBAAgB,MAAO,KAAM,CACvB,iBAAiB,OACnB,kBACE,cAAc,YAAY,EAC1B,MACA,KAAK,eACL,CACE,KAAM,eAAe,MAAM,cAC3B,QAAS,EACX,CACF,EAEF,UAAU,kBAAkB,MAAO,IAAI,CACzC,EACA,mBAAmB,MAAO,KAAM,CAC1B,iBAAiB,OACnB,kBACE,cAAc,YAAY,EAC1B,MACA,KAAK,eACL,CACE,KAAM,eAAe,MAAM,iBAC3B,QAAS,GACT,UAAW,EACb,CACF,EAEF,UAAU,qBAAqB,MAAO,IAAI,CAC5C,CACF,CACF"}

package/dist/tracking/api.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.mts","names":[],"sources":["../../src/tracking/api.ts"],"mappings":";;;;;;;UAaiB,qBAAA;EACf,MAAA,GAAS,aAAA;EACT,OAAA,UAAiB,UAAA,CAAW,KAAA;EAC5B,GAAA,GAAM,WAAA;EACN,MAAA,EAAQ,YAAA;AAAA;AAAA,cAGG,cAAA;EAAA,iBACM,MAAA;EAAA,iBACA,OAAA;EAAA,iBACA,MAAA;EAAA,iBACA,GAAA;EAAA,QAET,GAAA;EAAA,QACA,eAAA;EAAA,QACA,mBAAA;EAAA,QACA,eAAA;EAAA,QACA,aAAA;EAAA,QACA,UAAA;cAEI,IAAA,EAAM,qBAAA;EAOlB,KAAA,CAAA;EAaA,SAAA,CAAA,GAAa,SAAA;EAQb,QAAA,CAAA;EAIA,WAAA,CAAA;EAIA,SAAA,CAAA;EAjDyB;;;;;EA0DzB,OAAA,CAAA,GAAW,MAAA;EAiBX,WAAA,CAAA,GAAe,cAAA;EAIT,QAAA,CAAS,MAAA,EAAQ,cAAA,GAAiB,OAAA;EAiDxC,aAAA,CAAA;EAKA,OAAA,CAAA;EAAA,QAQQ,cAAA;EAAA,QAOA,YAAA;EAAA,QAcA,WAAA;EAAA,QA0BM,QAAA;AAAA"}
+{"version":3,"file":"api.d.mts","names":[],"sources":["../../src/tracking/api.ts"],"mappings":";;;;;;;UAgBiB,qBAAA;EACf,MAAA,GAAS,aAAA;EACT,OAAA,UAAiB,UAAA,CAAW,KAAA;EAC5B,GAAA,GAAM,WAAA;EACN,MAAA,EAAQ,YAAA;AAAA;AAAA,cAGG,cAAA;EAAA,iBACM,MAAA;EAAA,iBACA,OAAA;EAAA,iBACA,MAAA;EAAA,iBACA,GAAA;EAAA,QAET,GAAA;EAAA,QACA,eAAA;EAAA,QACA,mBAAA;EAAA,QACA,eAAA;EAAA,QACA,aAAA;EAAA,QACA,UAAA;cAEI,IAAA,EAAM,qBAAA;EAOlB,KAAA,CAAA;EAaA,SAAA,CAAA,GAAa,SAAA;EAQb,QAAA,CAAA;EAIA,WAAA,CAAA;EAIA,SAAA,CAAA;EAjDyB;;;;;EA0DzB,OAAA,CAAA,GAAW,MAAA;EAiBX,WAAA,CAAA,GAAe,cAAA;EAIT,QAAA,CAAS,MAAA,EAAQ,cAAA,GAAiB,OAAA;EAkDxC,aAAA,CAAA;EAKA,OAAA,CAAA;EAAA,QAQQ,cAAA;EAAA,QAOA,YAAA;EAAA,QAcA,WAAA;EAAA,QA0BM,QAAA;AAAA"}

package/dist/tracking/api.mjs

@@ -1,152 +1 @@
-import { createLogger } from "../util/log.mjs";
-import { DeviceManager } from "./device.mjs";
-import { GeoDetector } from "./geo.mjs";
-import { SessionManager } from "./session.mjs";
-//#region src/tracking/api.ts
-const log = createLogger("tracking");
-const SYNC_COOLDOWN_MS = 5e3;
-var SessionTracker = class {
-	target;
-	fetcher;
-	device;
-	geo;
-	mgr = null;
-	currentIdentity = null;
-	identifiedSessionId = null;
-	syncedSessionId = null;
-	syncAttemptMs = 0;
-	generation = 0;
-	constructor(opts) {
-		this.target = opts.target;
-		this.fetcher = opts.fetcher ?? globalThis.fetch.bind(globalThis);
-		this.device = opts.device ?? new DeviceManager();
-		this.geo = opts.geo ?? new GeoDetector();
-	}
-	start() {
-		this.device.init();
-		this.geo.detect();
-		this.mgr = new SessionManager((id) => {
-			this.onRotate(id).catch(() => {});
-		});
-	}
-	sessionId() {
-		const id = this.mgr?.getSessionId() ?? null;
-		if (id) this.ensureSynced(id);
-		return id;
-	}
-	windowId() {
-		return this.mgr?.getWindowId() ?? null;
-	}
-	getDeviceId() {
-		return this.device.getDeviceId();
-	}
-	getFpHash() {
-		return this.device.getFpHash();
-	}
-	/**
-	* Identity headers (session / window / device). Layered onto the
-	* session/identify POSTs alongside the target's static headers
-	* (content-type + auth + force-enable).
-	*/
-	headers() {
-		const h = {};
-		const sid = this.mgr?.getSessionId() ?? null;
-		if (sid) h["x-interfere-session"] = sid;
-		const wid = this.mgr?.getWindowId() ?? null;
-		if (wid) h["x-interfere-window"] = wid;
-		const did = this.device.getDeviceId();
-		if (did) h["x-interfere-device"] = did;
-		return h;
-	}
-	getIdentity() {
-		return this.currentIdentity;
-	}
-	async identify(params) {
-		if (!this.mgr) return;
-		const sessionId = this.mgr.getSessionId();
-		if (this.identifiedSessionId === sessionId) {
-			log.debug("skipped, already identified for session %s", sessionId);
-			return;
-		}
-		this.currentIdentity = params;
-		this.identifiedSessionId = sessionId;
-		const gen = this.generation;
-		const [fpHash, country] = await Promise.all([this.device.whenFingerprintReady(), this.geo.detect()]);
-		const deviceId = this.device.getDeviceId();
-		if (gen !== this.generation) {
-			this.identifiedSessionId = null;
-			return;
-		}
-		log.info("POST session %s → user %s", sessionId, params.identifier);
-		this.fetcher(`${this.target.url}/identify`, {
-			method: "POST",
-			headers: this.requestHeaders(),
-			body: JSON.stringify({
-				sessionId,
-				deviceId,
-				fpHash,
-				...params,
-				...country && { country }
-			}),
-			keepalive: true,
-			signal: AbortSignal.timeout(1e4)
-		}).catch(() => {
-			this.identifiedSessionId = null;
-			log.warn("identify failed for session %s", sessionId);
-		});
-	}
-	clearIdentity() {
-		this.currentIdentity = null;
-		this.identifiedSessionId = null;
-	}
-	dispose() {
-		this.generation += 1;
-		this.clearIdentity();
-		this.syncedSessionId = null;
-		this.syncAttemptMs = 0;
-		this.mgr = null;
-	}
-	requestHeaders() {
-		return {
-			...Object.fromEntries(this.target.headers.entries()),
-			...this.headers()
-		};
-	}
-	ensureSynced(sessionId) {
-		if (this.syncedSessionId === sessionId) return;
-		if (Date.now() - this.syncAttemptMs < SYNC_COOLDOWN_MS) return;
-		this.syncSession(sessionId, this.device.getDeviceId(), this.device.getFpHash());
-	}
-	syncSession(sessionId, deviceId, fpHash) {
-		this.syncAttemptMs = Date.now();
-		this.syncedSessionId = sessionId;
-		this.fetcher(this.target.url, {
-			method: "POST",
-			headers: this.requestHeaders(),
-			body: JSON.stringify({
-				sessionId,
-				deviceId,
-				fpHash
-			}),
-			keepalive: true,
-			signal: AbortSignal.timeout(1e4)
-		}).then((res) => {
-			if (!res.ok) this.syncedSessionId = null;
-		}).catch(() => {
-			this.syncedSessionId = null;
-			log.warn("session sync failed, will retry");
-		});
-	}
-	async onRotate(sessionId) {
-		this.syncedSessionId = null;
-		this.syncAttemptMs = Date.now();
-		const gen = this.generation;
-		const fpHash = await this.device.whenFingerprintReady();
-		const deviceId = this.device.getDeviceId();
-		if (gen !== this.generation) return;
-		log.debug("POST session %s (device=%s fp=%s)", sessionId, deviceId ?? "pending", fpHash ?? "none");
-		this.syncSession(sessionId, deviceId, fpHash);
-	}
-};
-//#endregion
-export { SessionTracker };
+import{createLogger}from"../util/log.mjs";import{appendPathBeforeQuery}from"../internal/config.mjs";import{DeviceManager}from"./device.mjs";import{GeoDetector}from"./geo.mjs";import{SessionManager}from"./session.mjs";const log=createLogger(`tracking`);var SessionTracker=class{target;fetcher;device;geo;mgr=null;currentIdentity=null;identifiedSessionId=null;syncedSessionId=null;syncAttemptMs=0;generation=0;constructor(opts){this.target=opts.target,this.fetcher=opts.fetcher??globalThis.fetch.bind(globalThis),this.device=opts.device??new DeviceManager,this.geo=opts.geo??new GeoDetector}start(){this.device.init(),this.geo.detect(),this.mgr=new SessionManager(id=>{this.onRotate(id).catch(()=>{})})}sessionId(){let id=this.mgr?.getSessionId()??null;return id&&this.ensureSynced(id),id}windowId(){return this.mgr?.getWindowId()??null}getDeviceId(){return this.device.getDeviceId()}getFpHash(){return this.device.getFpHash()}headers(){let h={},sid=this.mgr?.getSessionId()??null;sid&&(h[`x-interfere-session`]=sid);let wid=this.mgr?.getWindowId()??null;wid&&(h[`x-interfere-window`]=wid);let did=this.device.getDeviceId();return did&&(h[`x-interfere-device`]=did),h}getIdentity(){return this.currentIdentity}async identify(params){if(!this.mgr)return;let sessionId=this.mgr.getSessionId();if(this.identifiedSessionId===sessionId){log.debug(`skipped, already identified for session %s`,sessionId);return}this.currentIdentity=params,this.identifiedSessionId=sessionId;let gen=this.generation,[fpHash,country]=await Promise.all([this.device.whenFingerprintReady(),this.geo.detect()]),deviceId=this.device.getDeviceId();if(gen!==this.generation){this.identifiedSessionId=null;return}log.info(`POST session %s → user %s`,sessionId,params.identifier),this.fetcher(appendPathBeforeQuery(this.target.url,`/identify`),{method:`POST`,headers:this.requestHeaders(),body:JSON.stringify({sessionId,deviceId,fpHash,...params,...country&&{country}}),keepalive:!0,signal:AbortSignal.timeout(1e4)}).catch(()=>{this.identifiedSessionId=null,log.warn(`identify failed for session %s`,sessionId)})}clearIdentity(){this.currentIdentity=null,this.identifiedSessionId=null}dispose(){this.generation+=1,this.clearIdentity(),this.syncedSessionId=null,this.syncAttemptMs=0,this.mgr=null}requestHeaders(){return{...Object.fromEntries(this.target.headers.entries()),...this.headers()}}ensureSynced(sessionId){this.syncedSessionId!==sessionId&&(Date.now()-this.syncAttemptMs<5e3||this.syncSession(sessionId,this.device.getDeviceId(),this.device.getFpHash()))}syncSession(sessionId,deviceId,fpHash){this.syncAttemptMs=Date.now(),this.syncedSessionId=sessionId,this.fetcher(this.target.url,{method:`POST`,headers:this.requestHeaders(),body:JSON.stringify({sessionId,deviceId,fpHash}),keepalive:!0,signal:AbortSignal.timeout(1e4)}).then(res=>{res.ok||(this.syncedSessionId=null)}).catch(()=>{this.syncedSessionId=null,log.warn(`session sync failed, will retry`)})}async onRotate(sessionId){this.syncedSessionId=null,this.syncAttemptMs=Date.now();let gen=this.generation,fpHash=await this.device.whenFingerprintReady(),deviceId=this.device.getDeviceId();gen===this.generation&&(log.debug(`POST session %s (device=%s fp=%s)`,sessionId,deviceId??`pending`,fpHash??`none`),this.syncSession(sessionId,deviceId,fpHash))}};export{SessionTracker};

package/dist/tracking/api.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"api.mjs","names":[],"sources":["../../src/tracking/api.ts"],"sourcesContent":["import type { SessionId } from \"@interfere/types/data/session\";\nimport type { IdentifyParams } from \"@interfere/types/sdk/identify\";\n\nimport type { IngestTarget } from \"../internal/config.js\";\nimport { createLogger } from \"../util/log.js\";\nimport { DeviceManager } from \"./device.js\";\nimport { GeoDetector } from \"./geo.js\";\nimport { SessionManager } from \"./session.js\";\n\nconst log = createLogger(\"tracking\");\n\nconst SYNC_COOLDOWN_MS = 5000;\n\nexport interface SessionTrackerOptions {\n  device?: DeviceManager;\n  fetcher?: typeof globalThis.fetch;\n  geo?: GeoDetector;\n  target: IngestTarget;\n}\n\nexport class SessionTracker {\n  private readonly target: IngestTarget;\n  private readonly fetcher: typeof globalThis.fetch;\n  private readonly device: DeviceManager;\n  private readonly geo: GeoDetector;\n\n  private mgr: SessionManager | null = null;\n  private currentIdentity: IdentifyParams | null = null;\n  private identifiedSessionId: string | null = null;\n  private syncedSessionId: string | null = null;\n  private syncAttemptMs = 0;\n  private generation = 0;\n\n  constructor(opts: SessionTrackerOptions) {\n    this.target = opts.target;\n    this.fetcher = opts.fetcher ?? globalThis.fetch.bind(globalThis);\n    this.device = opts.device ?? new DeviceManager();\n    this.geo = opts.geo ?? new GeoDetector();\n  }\n\n  start(): void {\n    this.device.init();\n    // Best-effort warm-up; `GeoDetector.detect()` swallows its own errors and\n    // resolves to `null`, so we don't need to attach a `.catch`. If `identify`\n    // runs before the geo result lands, the country field is just omitted.\n    this.geo.detect();\n    this.mgr = new SessionManager((id) => {\n      this.onRotate(id).catch(() => {\n        /* best-effort */\n      });\n    });\n  }\n\n  sessionId(): SessionId | null {\n    const id = this.mgr?.getSessionId() ?? null;\n    if (id) {\n      this.ensureSynced(id);\n    }\n    return id;\n  }\n\n  windowId(): string | null {\n    return this.mgr?.getWindowId() ?? null;\n  }\n\n  getDeviceId(): string | null {\n    return this.device.getDeviceId();\n  }\n\n  getFpHash(): string | null {\n    return this.device.getFpHash();\n  }\n\n  /**\n   * Identity headers (session / window / device). Layered onto the\n   * session/identify POSTs alongside the target's static headers\n   * (content-type + auth + force-enable).\n   */\n  headers(): Record<string, string> {\n    const h: Record<string, string> = {};\n    const sid = this.mgr?.getSessionId() ?? null;\n    if (sid) {\n      h[\"x-interfere-session\"] = sid;\n    }\n    const wid = this.mgr?.getWindowId() ?? null;\n    if (wid) {\n      h[\"x-interfere-window\"] = wid;\n    }\n    const did = this.device.getDeviceId();\n    if (did) {\n      h[\"x-interfere-device\"] = did;\n    }\n    return h;\n  }\n\n  getIdentity(): IdentifyParams | null {\n    return this.currentIdentity;\n  }\n\n  async identify(params: IdentifyParams): Promise<void> {\n    if (!this.mgr) {\n      return;\n    }\n    const sessionId = this.mgr.getSessionId();\n    if (this.identifiedSessionId === sessionId) {\n      log.debug(\"skipped, already identified for session %s\", sessionId);\n      return;\n    }\n\n    this.currentIdentity = params;\n    this.identifiedSessionId = sessionId;\n\n    const gen = this.generation;\n    const [fpHash, country] = await Promise.all([\n      this.device.whenFingerprintReady(),\n      this.geo.detect(),\n    ]);\n    const deviceId = this.device.getDeviceId();\n    if (gen !== this.generation) {\n      this.identifiedSessionId = null;\n      return;\n    }\n    // Append the path to the existing target. `new URL(\"/identify\", base)`\n    // is wrong on both axes: in proxy mode `target.url` is relative\n    // (`/api/interfere/v1/session`) so the URL constructor throws\n    // synchronously — `currentIdentity` is set but no fetch fires; in\n    // pub-token mode the path-absolute \"/identify\" replaces the target's\n    // path, hitting `/identify` at the origin instead of the collector's\n    // `/v1/session/identify` route. Plain string concatenation gets both.\n    log.info(\"POST session %s → user %s\", sessionId, params.identifier);\n    this.fetcher(`${this.target.url}/identify`, {\n      method: \"POST\",\n      headers: this.requestHeaders(),\n      body: JSON.stringify({\n        sessionId,\n        deviceId,\n        fpHash,\n        ...params,\n        ...(country && { country }),\n      }),\n      keepalive: true,\n      signal: AbortSignal.timeout(10_000),\n    }).catch(() => {\n      this.identifiedSessionId = null;\n      log.warn(\"identify failed for session %s\", sessionId);\n    });\n  }\n\n  clearIdentity(): void {\n    this.currentIdentity = null;\n    this.identifiedSessionId = null;\n  }\n\n  dispose(): void {\n    this.generation += 1;\n    this.clearIdentity();\n    this.syncedSessionId = null;\n    this.syncAttemptMs = 0;\n    this.mgr = null;\n  }\n\n  private requestHeaders(): Record<string, string> {\n    return {\n      ...Object.fromEntries(this.target.headers.entries()),\n      ...this.headers(),\n    };\n  }\n\n  private ensureSynced(sessionId: string): void {\n    if (this.syncedSessionId === sessionId) {\n      return;\n    }\n    if (Date.now() - this.syncAttemptMs < SYNC_COOLDOWN_MS) {\n      return;\n    }\n    this.syncSession(\n      sessionId,\n      this.device.getDeviceId(),\n      this.device.getFpHash()\n    );\n  }\n\n  private syncSession(\n    sessionId: string,\n    deviceId: string | null,\n    fpHash: string | null\n  ): void {\n    this.syncAttemptMs = Date.now();\n    this.syncedSessionId = sessionId;\n\n    this.fetcher(this.target.url, {\n      method: \"POST\",\n      headers: this.requestHeaders(),\n      body: JSON.stringify({ sessionId, deviceId, fpHash }),\n      keepalive: true,\n      signal: AbortSignal.timeout(10_000),\n    })\n      .then((res) => {\n        if (!res.ok) {\n          this.syncedSessionId = null;\n        }\n      })\n      .catch(() => {\n        this.syncedSessionId = null;\n        log.warn(\"session sync failed, will retry\");\n      });\n  }\n\n  private async onRotate(sessionId: string): Promise<void> {\n    this.syncedSessionId = null;\n    this.syncAttemptMs = Date.now();\n    const gen = this.generation;\n    const fpHash = await this.device.whenFingerprintReady();\n    const deviceId = this.device.getDeviceId();\n    if (gen !== this.generation) {\n      return;\n    }\n    log.debug(\n      \"POST session %s (device=%s fp=%s)\",\n      sessionId,\n      deviceId ?? \"pending\",\n      fpHash ?? \"none\"\n    );\n    this.syncSession(sessionId, deviceId, fpHash);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"api.mjs","names":[],"sources":["../../src/tracking/api.ts"],"sourcesContent":["import type { SessionId } from \"@interfere/types/data/session\";\nimport type { IdentifyParams } from \"@interfere/types/sdk/identify\";\n\nimport {\n  appendPathBeforeQuery,\n  type IngestTarget,\n} from \"../internal/config.js\";\nimport { createLogger } from \"../util/log.js\";\nimport { DeviceManager } from \"./device.js\";\nimport { GeoDetector } from \"./geo.js\";\nimport { SessionManager } from \"./session.js\";\n\nconst log = createLogger(\"tracking\");\n\nconst SYNC_COOLDOWN_MS = 5000;\n\nexport interface SessionTrackerOptions {\n  device?: DeviceManager;\n  fetcher?: typeof globalThis.fetch;\n  geo?: GeoDetector;\n  target: IngestTarget;\n}\n\nexport class SessionTracker {\n  private readonly target: IngestTarget;\n  private readonly fetcher: typeof globalThis.fetch;\n  private readonly device: DeviceManager;\n  private readonly geo: GeoDetector;\n\n  private mgr: SessionManager | null = null;\n  private currentIdentity: IdentifyParams | null = null;\n  private identifiedSessionId: string | null = null;\n  private syncedSessionId: string | null = null;\n  private syncAttemptMs = 0;\n  private generation = 0;\n\n  constructor(opts: SessionTrackerOptions) {\n    this.target = opts.target;\n    this.fetcher = opts.fetcher ?? globalThis.fetch.bind(globalThis);\n    this.device = opts.device ?? new DeviceManager();\n    this.geo = opts.geo ?? new GeoDetector();\n  }\n\n  start(): void {\n    this.device.init();\n    // Best-effort warm-up; `GeoDetector.detect()` swallows its own errors and\n    // resolves to `null`, so we don't need to attach a `.catch`. If `identify`\n    // runs before the geo result lands, the country field is just omitted.\n    this.geo.detect();\n    this.mgr = new SessionManager((id) => {\n      this.onRotate(id).catch(() => {\n        /* best-effort */\n      });\n    });\n  }\n\n  sessionId(): SessionId | null {\n    const id = this.mgr?.getSessionId() ?? null;\n    if (id) {\n      this.ensureSynced(id);\n    }\n    return id;\n  }\n\n  windowId(): string | null {\n    return this.mgr?.getWindowId() ?? null;\n  }\n\n  getDeviceId(): string | null {\n    return this.device.getDeviceId();\n  }\n\n  getFpHash(): string | null {\n    return this.device.getFpHash();\n  }\n\n  /**\n   * Identity headers (session / window / device). Layered onto the\n   * session/identify POSTs alongside the target's static headers\n   * (content-type + auth + force-enable).\n   */\n  headers(): Record<string, string> {\n    const h: Record<string, string> = {};\n    const sid = this.mgr?.getSessionId() ?? null;\n    if (sid) {\n      h[\"x-interfere-session\"] = sid;\n    }\n    const wid = this.mgr?.getWindowId() ?? null;\n    if (wid) {\n      h[\"x-interfere-window\"] = wid;\n    }\n    const did = this.device.getDeviceId();\n    if (did) {\n      h[\"x-interfere-device\"] = did;\n    }\n    return h;\n  }\n\n  getIdentity(): IdentifyParams | null {\n    return this.currentIdentity;\n  }\n\n  async identify(params: IdentifyParams): Promise<void> {\n    if (!this.mgr) {\n      return;\n    }\n    const sessionId = this.mgr.getSessionId();\n    if (this.identifiedSessionId === sessionId) {\n      log.debug(\"skipped, already identified for session %s\", sessionId);\n      return;\n    }\n\n    this.currentIdentity = params;\n    this.identifiedSessionId = sessionId;\n\n    const gen = this.generation;\n    const [fpHash, country] = await Promise.all([\n      this.device.whenFingerprintReady(),\n      this.geo.detect(),\n    ]);\n    const deviceId = this.device.getDeviceId();\n    if (gen !== this.generation) {\n      this.identifiedSessionId = null;\n      return;\n    }\n    // Append the path to the existing target. `new URL(\"/identify\", base)`\n    // is wrong on both axes: in proxy mode `target.url` is relative\n    // (`/api/interfere/v1/session`) so the URL constructor throws\n    // synchronously — `currentIdentity` is set but no fetch fires; in\n    // direct mode the path-absolute \"/identify\" replaces the target's\n    // path, hitting `/identify` at the origin instead of the collector's\n    // `/v1/session/identify` route. The helper preserves relative URLs and\n    // keeps `pk` query auth at the end.\n    log.info(\"POST session %s → user %s\", sessionId, params.identifier);\n    this.fetcher(appendPathBeforeQuery(this.target.url, \"/identify\"), {\n      method: \"POST\",\n      headers: this.requestHeaders(),\n      body: JSON.stringify({\n        sessionId,\n        deviceId,\n        fpHash,\n        ...params,\n        ...(country && { country }),\n      }),\n      keepalive: true,\n      signal: AbortSignal.timeout(10_000),\n    }).catch(() => {\n      this.identifiedSessionId = null;\n      log.warn(\"identify failed for session %s\", sessionId);\n    });\n  }\n\n  clearIdentity(): void {\n    this.currentIdentity = null;\n    this.identifiedSessionId = null;\n  }\n\n  dispose(): void {\n    this.generation += 1;\n    this.clearIdentity();\n    this.syncedSessionId = null;\n    this.syncAttemptMs = 0;\n    this.mgr = null;\n  }\n\n  private requestHeaders(): Record<string, string> {\n    return {\n      ...Object.fromEntries(this.target.headers.entries()),\n      ...this.headers(),\n    };\n  }\n\n  private ensureSynced(sessionId: string): void {\n    if (this.syncedSessionId === sessionId) {\n      return;\n    }\n    if (Date.now() - this.syncAttemptMs < SYNC_COOLDOWN_MS) {\n      return;\n    }\n    this.syncSession(\n      sessionId,\n      this.device.getDeviceId(),\n      this.device.getFpHash()\n    );\n  }\n\n  private syncSession(\n    sessionId: string,\n    deviceId: string | null,\n    fpHash: string | null\n  ): void {\n    this.syncAttemptMs = Date.now();\n    this.syncedSessionId = sessionId;\n\n    this.fetcher(this.target.url, {\n      method: \"POST\",\n      headers: this.requestHeaders(),\n      body: JSON.stringify({ sessionId, deviceId, fpHash }),\n      keepalive: true,\n      signal: AbortSignal.timeout(10_000),\n    })\n      .then((res) => {\n        if (!res.ok) {\n          this.syncedSessionId = null;\n        }\n      })\n      .catch(() => {\n        this.syncedSessionId = null;\n        log.warn(\"session sync failed, will retry\");\n      });\n  }\n\n  private async onRotate(sessionId: string): Promise<void> {\n    this.syncedSessionId = null;\n    this.syncAttemptMs = Date.now();\n    const gen = this.generation;\n    const fpHash = await this.device.whenFingerprintReady();\n    const deviceId = this.device.getDeviceId();\n    if (gen !== this.generation) {\n      return;\n    }\n    log.debug(\n      \"POST session %s (device=%s fp=%s)\",\n      sessionId,\n      deviceId ?? \"pending\",\n      fpHash ?? \"none\"\n    );\n    this.syncSession(sessionId, deviceId, fpHash);\n  }\n}\n"],"mappings":"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"}

package/dist/tracking/device.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"device.d.mts","names":[],"sources":["../../src/tracking/device.ts"],"mappings":";;AAgBA;;;;;AAWA;;KAXY,mBAAA,SAA4B,OAAA;;;AAkFxC;;;;;iBAvEgB,QAAA,CAAA,GAAY,OAAA;AAAA,cAuEf,aAAA;EAAA,QACH,QAAA;EAAA,QACA,MAAA;EAAA,QACA,SAAA;EAAA,iBACS,mBAAA;cAEL,mBAAA,GAAsB,mBAAA;EAKlC,IAAA,CAAA;EAAA,QAkCQ,gBAAA;EAkBR,WAAA,CAAA;EAIA,SAAA,CAAA;EAIA,oBAAA,CAAA,GAAwB,OAAA;AAAA"}
+{"version":3,"file":"device.d.mts","names":[],"sources":["../../src/tracking/device.ts"],"mappings":";;AAgBA;;;;AAA+C;AAW/C;;KAXY,mBAAA,SAA4B,OAAO;;AAWZ;AAuEnC;;;;;iBAvEgB,QAAA,CAAA,GAAY,OAAO;AAAA,cAuEtB,aAAA;EAAA,QACH,QAAA;EAAA,QACA,MAAA;EAAA,QACA,SAAA;EAAA,iBACS,mBAAA;cAEL,mBAAA,GAAsB,mBAAA;EAKlC,IAAA,CAAA;EAAA,QAkCQ,gBAAA;EAkBR,WAAA,CAAA;EAIA,SAAA,CAAA;EAIA,oBAAA,CAAA,GAAwB,OAAO;AAAA"}

package/dist/tracking/device.mjs

@@ -1,104 +1 @@
-import { createLogger } from "../util/log.mjs";
-//#region src/tracking/device.ts
-const log = createLogger("device");
-const LS_KEY = "interfere:device_id";
-const COOKIE_NAME = "interfere_did";
-const COOKIE_MAX_AGE_DAYS = 400;
-const FP_IDLE_TIMEOUT_MS = 5e3;
-/**
-* Resolves on the next browser idle frame, capped at 5s. Falls back to
-* `setTimeout(0)` (next macrotask) on hosts without
-* `requestIdleCallback`. Exported only for the unit test that pins the
-* "default provider gates fingerprint work via RIC" contract — not part
-* of the package's public surface.
-*/
-function whenIdle() {
-	return new Promise((resolve) => {
-		if (typeof globalThis.requestIdleCallback === "function") {
-			globalThis.requestIdleCallback(() => resolve(), { timeout: FP_IDLE_TIMEOUT_MS });
-			return;
-		}
-		setTimeout(resolve, 0);
-	});
-}
-const defaultFingerprintProvider = async () => {
-	await whenIdle();
-	try {
-		const result = await (await (await import("@fingerprintjs/fingerprintjs")).load()).get();
-		if (!result.visitorId) {
-			log.error("Fingerprinting returned an empty visitor id; visitor identity will be cookie-only");
-			return null;
-		}
-		return result.visitorId;
-	} catch (err) {
-		log.error("fingerprint init failed; visitor identity will be cookie-only", err);
-		return null;
-	}
-};
-function tryLocalStorage() {
-	try {
-		const s = globalThis.localStorage;
-		const key = "__interfere_device_probe__";
-		s.setItem(key, "1");
-		s.removeItem(key);
-		return s;
-	} catch {
-		return null;
-	}
-}
-function getCookie(name) {
-	if (typeof document === "undefined") return null;
-	const match = document.cookie.split("; ").find((c) => c.startsWith(`${name}=`));
-	return match ? decodeURIComponent(match.split("=")[1] ?? "") : null;
-}
-function setCookie(name, value) {
-	if (typeof document === "undefined") return;
-	const maxAge = COOKIE_MAX_AGE_DAYS * 24 * 60 * 60;
-	document.cookie = `${name}=${encodeURIComponent(value)};path=/;max-age=${maxAge};SameSite=Lax`;
-}
-function generateId() {
-	return crypto.randomUUID();
-}
-var DeviceManager = class {
-	deviceId = null;
-	fpHash = null;
-	fpPending = null;
-	fingerprintProvider;
-	constructor(fingerprintProvider) {
-		this.fingerprintProvider = fingerprintProvider ?? defaultFingerprintProvider;
-	}
-	init() {
-		if (this.deviceId) return;
-		const ls = tryLocalStorage();
-		const fromLs = ls?.getItem(LS_KEY) ?? null;
-		const fromCookie = getCookie(COOKIE_NAME);
-		this.deviceId = fromLs ?? fromCookie ?? generateId();
-		if (!fromLs && ls) ls.setItem(LS_KEY, this.deviceId);
-		if (!fromCookie) setCookie(COOKIE_NAME, this.deviceId);
-		if (fromLs && !fromCookie) setCookie(COOKIE_NAME, this.deviceId);
-		if (fromCookie && !fromLs && ls) ls.setItem(LS_KEY, this.deviceId);
-		log.debug("device %s (ls=%s cookie=%s)", this.deviceId, !!fromLs, !!fromCookie);
-		this.startFingerprint();
-	}
-	startFingerprint() {
-		if (this.fpHash || this.fpPending) return;
-		this.fpPending = (async () => {
-			const hash = await this.fingerprintProvider();
-			this.fpHash = hash;
-			if (hash) log.debug("fpHash %s", hash);
-			return hash;
-		})();
-	}
-	getDeviceId() {
-		return this.deviceId;
-	}
-	getFpHash() {
-		return this.fpHash;
-	}
-	whenFingerprintReady() {
-		if (this.fpHash) return Promise.resolve(this.fpHash);
-		return this.fpPending ?? Promise.resolve(null);
-	}
-};
-//#endregion
-export { DeviceManager, whenIdle };
+import{createLogger}from"../util/log.mjs";const log=createLogger(`device`),LS_KEY=`interfere:device_id`,COOKIE_NAME=`interfere_did`;function whenIdle(){return new Promise(resolve=>{if(typeof globalThis.requestIdleCallback==`function`){globalThis.requestIdleCallback(()=>resolve(),{timeout:5e3});return}setTimeout(resolve,0)})}const defaultFingerprintProvider=async()=>{await whenIdle();try{let result=await(await(await import(`@fingerprintjs/fingerprintjs`)).load()).get();return result.visitorId?result.visitorId:(log.error(`Fingerprinting returned an empty visitor id; visitor identity will be cookie-only`),null)}catch(err){return log.error(`fingerprint init failed; visitor identity will be cookie-only`,err),null}};function tryLocalStorage(){try{let s=globalThis.localStorage,key=`__interfere_device_probe__`;return s.setItem(key,`1`),s.removeItem(key),s}catch{return null}}function getCookie(name){if(typeof document>`u`)return null;let match=document.cookie.split(`; `).find(c=>c.startsWith(`${name}=`));return match?decodeURIComponent(match.split(`=`)[1]??``):null}function setCookie(name,value){typeof document>`u`||(document.cookie=`${name}=${encodeURIComponent(value)};path=/;max-age=${400*24*60*60};SameSite=Lax`)}function generateId(){return crypto.randomUUID()}var DeviceManager=class{deviceId=null;fpHash=null;fpPending=null;fingerprintProvider;constructor(fingerprintProvider){this.fingerprintProvider=fingerprintProvider??defaultFingerprintProvider}init(){if(this.deviceId)return;let ls=tryLocalStorage(),fromLs=ls?.getItem(LS_KEY)??null,fromCookie=getCookie(COOKIE_NAME);this.deviceId=fromLs??fromCookie??generateId(),!fromLs&&ls&&ls.setItem(LS_KEY,this.deviceId),fromCookie||setCookie(COOKIE_NAME,this.deviceId),fromLs&&!fromCookie&&setCookie(COOKIE_NAME,this.deviceId),fromCookie&&!fromLs&&ls&&ls.setItem(LS_KEY,this.deviceId),log.debug(`device %s (ls=%s cookie=%s)`,this.deviceId,!!fromLs,!!fromCookie),this.startFingerprint()}startFingerprint(){this.fpHash||this.fpPending||(this.fpPending=(async()=>{let hash=await this.fingerprintProvider();return this.fpHash=hash,hash&&log.debug(`fpHash %s`,hash),hash})())}getDeviceId(){return this.deviceId}getFpHash(){return this.fpHash}whenFingerprintReady(){return this.fpHash?Promise.resolve(this.fpHash):this.fpPending??Promise.resolve(null)}};export{DeviceManager,whenIdle};

package/dist/tracking/device.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"device.mjs","names":[],"sources":["../../src/tracking/device.ts"],"sourcesContent":["import { createLogger } from \"../util/log.js\";\n\nconst log = createLogger(\"device\");\n\nconst LS_KEY = \"interfere:device_id\";\nconst COOKIE_NAME = \"interfere_did\";\nconst COOKIE_MAX_AGE_DAYS = 400;\n\n/**\n * Producer of an opaque, stable per-browser fingerprint hash. The default\n * dynamic-imports the FingerprintJS OSS library and self-defers via\n * `requestIdleCallback` so the ~1.5s of synchronous font / canvas / WebGL\n * probing the library performs on a cold load doesn't land on the\n * hydration tick. Tests inject a fixed-value provider that resolves\n * immediately — they pay nothing for the production deferral.\n */\nexport type FingerprintProvider = () => Promise<string | null>;\n\nconst FP_IDLE_TIMEOUT_MS = 5000;\n\n/**\n * Resolves on the next browser idle frame, capped at 5s. Falls back to\n * `setTimeout(0)` (next macrotask) on hosts without\n * `requestIdleCallback`. Exported only for the unit test that pins the\n * \"default provider gates fingerprint work via RIC\" contract — not part\n * of the package's public surface.\n */\nexport function whenIdle(): Promise<void> {\n  return new Promise((resolve) => {\n    if (typeof globalThis.requestIdleCallback === \"function\") {\n      globalThis.requestIdleCallback(() => resolve(), {\n        timeout: FP_IDLE_TIMEOUT_MS,\n      });\n      return;\n    }\n    setTimeout(resolve, 0);\n  });\n}\n\nconst defaultFingerprintProvider: FingerprintProvider = async () => {\n  await whenIdle();\n  try {\n    const FingerprintJS = await import(\"@fingerprintjs/fingerprintjs\");\n    const fp = await FingerprintJS.load();\n    const result = await fp.get();\n    if (!result.visitorId) {\n      log.error(\n        \"Fingerprinting returned an empty visitor id; visitor identity will be cookie-only\"\n      );\n\n      return null;\n    }\n    return result.visitorId;\n  } catch (err) {\n    log.error(\n      \"fingerprint init failed; visitor identity will be cookie-only\",\n      err\n    );\n\n    return null;\n  }\n};\n\nfunction tryLocalStorage(): Storage | null {\n  try {\n    const s = globalThis.localStorage;\n    const key = \"__interfere_device_probe__\";\n    s.setItem(key, \"1\");\n    s.removeItem(key);\n    return s;\n  } catch {\n    return null;\n  }\n}\n\nfunction getCookie(name: string): string | null {\n  if (typeof document === \"undefined\") {\n    return null;\n  }\n  const match = document.cookie\n    .split(\"; \")\n    .find((c) => c.startsWith(`${name}=`));\n  return match ? decodeURIComponent(match.split(\"=\")[1] ?? \"\") : null;\n}\n\nfunction setCookie(name: string, value: string): void {\n  if (typeof document === \"undefined\") {\n    return;\n  }\n  const maxAge = COOKIE_MAX_AGE_DAYS * 24 * 60 * 60;\n  // biome-ignore lint/suspicious/noDocumentCookie: Cookie Store API is async and not universally supported; synchronous access is required here\n  document.cookie = `${name}=${encodeURIComponent(value)};path=/;max-age=${maxAge};SameSite=Lax`;\n}\n\nfunction generateId(): string {\n  return crypto.randomUUID();\n}\n\nexport class DeviceManager {\n  private deviceId: string | null = null;\n  private fpHash: string | null = null;\n  private fpPending: Promise<string | null> | null = null;\n  private readonly fingerprintProvider: FingerprintProvider;\n\n  constructor(fingerprintProvider?: FingerprintProvider) {\n    this.fingerprintProvider =\n      fingerprintProvider ?? defaultFingerprintProvider;\n  }\n\n  init(): void {\n    if (this.deviceId) {\n      return;\n    }\n\n    const ls = tryLocalStorage();\n    const fromLs = ls?.getItem(LS_KEY) ?? null;\n    const fromCookie = getCookie(COOKIE_NAME);\n\n    this.deviceId = fromLs ?? fromCookie ?? generateId();\n\n    if (!fromLs && ls) {\n      ls.setItem(LS_KEY, this.deviceId);\n    }\n    if (!fromCookie) {\n      setCookie(COOKIE_NAME, this.deviceId);\n    }\n    if (fromLs && !fromCookie) {\n      setCookie(COOKIE_NAME, this.deviceId);\n    }\n    if (fromCookie && !fromLs && ls) {\n      ls.setItem(LS_KEY, this.deviceId);\n    }\n\n    log.debug(\n      \"device %s (ls=%s cookie=%s)\",\n      this.deviceId,\n      !!fromLs,\n      !!fromCookie\n    );\n\n    this.startFingerprint();\n  }\n\n  private startFingerprint(): void {\n    if (this.fpHash || this.fpPending) {\n      return;\n    }\n\n    this.fpPending = (async () => {\n      const hash = await this.fingerprintProvider();\n      this.fpHash = hash;\n      if (hash) {\n        log.debug(\"fpHash %s\", hash);\n      }\n      // No log on null — the provider is responsible for surfacing its own\n      // failure mode (the default provider logs at error level; custom\n      // providers can choose). Logging here too would double-count.\n      return hash;\n    })();\n  }\n\n  getDeviceId(): string | null {\n    return this.deviceId;\n  }\n\n  getFpHash(): string | null {\n    return this.fpHash;\n  }\n\n  whenFingerprintReady(): Promise<string | null> {\n    if (this.fpHash) {\n      return Promise.resolve(this.fpHash);\n    }\n    return this.fpPending ?? Promise.resolve(null);\n  }\n}\n"],"mappings":";;AAEA,MAAM,MAAM,aAAa,SAAS;AAElC,MAAM,SAAS;AACf,MAAM,cAAc;AACpB,MAAM,sBAAsB;AAY5B,MAAM,qBAAqB;;;;;;;;AAS3B,SAAgB,WAA0B;CACxC,OAAO,IAAI,SAAS,YAAY;EAC9B,IAAI,OAAO,WAAW,wBAAwB,YAAY;GACxD,WAAW,0BAA0B,SAAS,EAAE,EAC9C,SAAS,oBACV,CAAC;GACF;;EAEF,WAAW,SAAS,EAAE;GACtB;;AAGJ,MAAM,6BAAkD,YAAY;CAClE,MAAM,UAAU;CAChB,IAAI;EAGF,MAAM,SAAS,OAAM,OADJ,MADW,OAAO,iCACJ,MAAM,EACb,KAAK;EAC7B,IAAI,CAAC,OAAO,WAAW;GACrB,IAAI,MACF,oFACD;GAED,OAAO;;EAET,OAAO,OAAO;UACP,KAAK;EACZ,IAAI,MACF,iEACA,IACD;EAED,OAAO;;;AAIX,SAAS,kBAAkC;CACzC,IAAI;EACF,MAAM,IAAI,WAAW;EACrB,MAAM,MAAM;EACZ,EAAE,QAAQ,KAAK,IAAI;EACnB,EAAE,WAAW,IAAI;EACjB,OAAO;SACD;EACN,OAAO;;;AAIX,SAAS,UAAU,MAA6B;CAC9C,IAAI,OAAO,aAAa,aACtB,OAAO;CAET,MAAM,QAAQ,SAAS,OACpB,MAAM,KAAK,CACX,MAAM,MAAM,EAAE,WAAW,GAAG,KAAK,GAAG,CAAC;CACxC,OAAO,QAAQ,mBAAmB,MAAM,MAAM,IAAI,CAAC,MAAM,GAAG,GAAG;;AAGjE,SAAS,UAAU,MAAc,OAAqB;CACpD,IAAI,OAAO,aAAa,aACtB;CAEF,MAAM,SAAS,sBAAsB,KAAK,KAAK;CAE/C,SAAS,SAAS,GAAG,KAAK,GAAG,mBAAmB,MAAM,CAAC,kBAAkB,OAAO;;AAGlF,SAAS,aAAqB;CAC5B,OAAO,OAAO,YAAY;;AAG5B,IAAa,gBAAb,MAA2B;CACzB,WAAkC;CAClC,SAAgC;CAChC,YAAmD;CACnD;CAEA,YAAY,qBAA2C;EACrD,KAAK,sBACH,uBAAuB;;CAG3B,OAAa;EACX,IAAI,KAAK,UACP;EAGF,MAAM,KAAK,iBAAiB;EAC5B,MAAM,SAAS,IAAI,QAAQ,OAAO,IAAI;EACtC,MAAM,aAAa,UAAU,YAAY;EAEzC,KAAK,WAAW,UAAU,cAAc,YAAY;EAEpD,IAAI,CAAC,UAAU,IACb,GAAG,QAAQ,QAAQ,KAAK,SAAS;EAEnC,IAAI,CAAC,YACH,UAAU,aAAa,KAAK,SAAS;EAEvC,IAAI,UAAU,CAAC,YACb,UAAU,aAAa,KAAK,SAAS;EAEvC,IAAI,cAAc,CAAC,UAAU,IAC3B,GAAG,QAAQ,QAAQ,KAAK,SAAS;EAGnC,IAAI,MACF,+BACA,KAAK,UACL,CAAC,CAAC,QACF,CAAC,CAAC,WACH;EAED,KAAK,kBAAkB;;CAGzB,mBAAiC;EAC/B,IAAI,KAAK,UAAU,KAAK,WACtB;EAGF,KAAK,aAAa,YAAY;GAC5B,MAAM,OAAO,MAAM,KAAK,qBAAqB;GAC7C,KAAK,SAAS;GACd,IAAI,MACF,IAAI,MAAM,aAAa,KAAK;GAK9B,OAAO;MACL;;CAGN,cAA6B;EAC3B,OAAO,KAAK;;CAGd,YAA2B;EACzB,OAAO,KAAK;;CAGd,uBAA+C;EAC7C,IAAI,KAAK,QACP,OAAO,QAAQ,QAAQ,KAAK,OAAO;EAErC,OAAO,KAAK,aAAa,QAAQ,QAAQ,KAAK"}
+{"version":3,"file":"device.mjs","names":[],"sources":["../../src/tracking/device.ts"],"sourcesContent":["import { createLogger } from \"../util/log.js\";\n\nconst log = createLogger(\"device\");\n\nconst LS_KEY = \"interfere:device_id\";\nconst COOKIE_NAME = \"interfere_did\";\nconst COOKIE_MAX_AGE_DAYS = 400;\n\n/**\n * Producer of an opaque, stable per-browser fingerprint hash. The default\n * dynamic-imports the FingerprintJS OSS library and self-defers via\n * `requestIdleCallback` so the ~1.5s of synchronous font / canvas / WebGL\n * probing the library performs on a cold load doesn't land on the\n * hydration tick. Tests inject a fixed-value provider that resolves\n * immediately — they pay nothing for the production deferral.\n */\nexport type FingerprintProvider = () => Promise<string | null>;\n\nconst FP_IDLE_TIMEOUT_MS = 5000;\n\n/**\n * Resolves on the next browser idle frame, capped at 5s. Falls back to\n * `setTimeout(0)` (next macrotask) on hosts without\n * `requestIdleCallback`. Exported only for the unit test that pins the\n * \"default provider gates fingerprint work via RIC\" contract — not part\n * of the package's public surface.\n */\nexport function whenIdle(): Promise<void> {\n  return new Promise((resolve) => {\n    if (typeof globalThis.requestIdleCallback === \"function\") {\n      globalThis.requestIdleCallback(() => resolve(), {\n        timeout: FP_IDLE_TIMEOUT_MS,\n      });\n      return;\n    }\n    setTimeout(resolve, 0);\n  });\n}\n\nconst defaultFingerprintProvider: FingerprintProvider = async () => {\n  await whenIdle();\n  try {\n    const FingerprintJS = await import(\"@fingerprintjs/fingerprintjs\");\n    const fp = await FingerprintJS.load();\n    const result = await fp.get();\n    if (!result.visitorId) {\n      log.error(\n        \"Fingerprinting returned an empty visitor id; visitor identity will be cookie-only\"\n      );\n\n      return null;\n    }\n    return result.visitorId;\n  } catch (err) {\n    log.error(\n      \"fingerprint init failed; visitor identity will be cookie-only\",\n      err\n    );\n\n    return null;\n  }\n};\n\nfunction tryLocalStorage(): Storage | null {\n  try {\n    const s = globalThis.localStorage;\n    const key = \"__interfere_device_probe__\";\n    s.setItem(key, \"1\");\n    s.removeItem(key);\n    return s;\n  } catch {\n    return null;\n  }\n}\n\nfunction getCookie(name: string): string | null {\n  if (typeof document === \"undefined\") {\n    return null;\n  }\n  const match = document.cookie\n    .split(\"; \")\n    .find((c) => c.startsWith(`${name}=`));\n  return match ? decodeURIComponent(match.split(\"=\")[1] ?? \"\") : null;\n}\n\nfunction setCookie(name: string, value: string): void {\n  if (typeof document === \"undefined\") {\n    return;\n  }\n  const maxAge = COOKIE_MAX_AGE_DAYS * 24 * 60 * 60;\n  // biome-ignore lint/suspicious/noDocumentCookie: Cookie Store API is async and not universally supported; synchronous access is required here\n  document.cookie = `${name}=${encodeURIComponent(value)};path=/;max-age=${maxAge};SameSite=Lax`;\n}\n\nfunction generateId(): string {\n  return crypto.randomUUID();\n}\n\nexport class DeviceManager {\n  private deviceId: string | null = null;\n  private fpHash: string | null = null;\n  private fpPending: Promise<string | null> | null = null;\n  private readonly fingerprintProvider: FingerprintProvider;\n\n  constructor(fingerprintProvider?: FingerprintProvider) {\n    this.fingerprintProvider =\n      fingerprintProvider ?? defaultFingerprintProvider;\n  }\n\n  init(): void {\n    if (this.deviceId) {\n      return;\n    }\n\n    const ls = tryLocalStorage();\n    const fromLs = ls?.getItem(LS_KEY) ?? null;\n    const fromCookie = getCookie(COOKIE_NAME);\n\n    this.deviceId = fromLs ?? fromCookie ?? generateId();\n\n    if (!fromLs && ls) {\n      ls.setItem(LS_KEY, this.deviceId);\n    }\n    if (!fromCookie) {\n      setCookie(COOKIE_NAME, this.deviceId);\n    }\n    if (fromLs && !fromCookie) {\n      setCookie(COOKIE_NAME, this.deviceId);\n    }\n    if (fromCookie && !fromLs && ls) {\n      ls.setItem(LS_KEY, this.deviceId);\n    }\n\n    log.debug(\n      \"device %s (ls=%s cookie=%s)\",\n      this.deviceId,\n      !!fromLs,\n      !!fromCookie\n    );\n\n    this.startFingerprint();\n  }\n\n  private startFingerprint(): void {\n    if (this.fpHash || this.fpPending) {\n      return;\n    }\n\n    this.fpPending = (async () => {\n      const hash = await this.fingerprintProvider();\n      this.fpHash = hash;\n      if (hash) {\n        log.debug(\"fpHash %s\", hash);\n      }\n      // No log on null — the provider is responsible for surfacing its own\n      // failure mode (the default provider logs at error level; custom\n      // providers can choose). Logging here too would double-count.\n      return hash;\n    })();\n  }\n\n  getDeviceId(): string | null {\n    return this.deviceId;\n  }\n\n  getFpHash(): string | null {\n    return this.fpHash;\n  }\n\n  whenFingerprintReady(): Promise<string | null> {\n    if (this.fpHash) {\n      return Promise.resolve(this.fpHash);\n    }\n    return this.fpPending ?? Promise.resolve(null);\n  }\n}\n"],"mappings":"0CAEA,MAAM,IAAM,aAAa,QAAQ,EAE3B,OAAS,sBACT,YAAc,gBAsBpB,SAAgB,UAA0B,CACxC,OAAO,IAAI,QAAS,SAAY,CAC9B,GAAI,OAAO,WAAW,qBAAwB,WAAY,CACxD,WAAW,wBAA0B,QAAQ,EAAG,CAC9C,QAAS,GACX,CAAC,EACD,MACF,CACA,WAAW,QAAS,CAAC,CACvB,CAAC,CACH,CAEA,MAAM,2BAAkD,SAAY,CAClE,MAAM,SAAS,EACf,GAAI,CAGF,IAAM,OAAS,MAAM,MADJ,MADW,OAAO,iCACJ,KAAK,GACZ,IAAI,EAQ5B,OAPK,OAAO,UAOL,OAAO,WANZ,IAAI,MACF,mFACF,EAEO,KAGX,OAAS,IAAK,CAMZ,OALA,IAAI,MACF,gEACA,GACF,EAEO,IACT,CACF,EAEA,SAAS,iBAAkC,CACzC,GAAI,CACF,IAAM,EAAI,WAAW,aACf,IAAM,6BAGZ,OAFA,EAAE,QAAQ,IAAK,GAAG,EAClB,EAAE,WAAW,GAAG,EACT,CACT,MAAQ,CACN,OAAO,IACT,CACF,CAEA,SAAS,UAAU,KAA6B,CAC9C,GAAI,OAAO,SAAa,IACtB,OAAO,KAET,IAAM,MAAQ,SAAS,OACpB,MAAM,IAAI,EACV,KAAM,GAAM,EAAE,WAAW,GAAG,KAAK,EAAE,CAAC,EACvC,OAAO,MAAQ,mBAAmB,MAAM,MAAM,GAAG,EAAE,IAAM,EAAE,EAAI,IACjE,CAEA,SAAS,UAAU,KAAc,MAAqB,CAChD,OAAO,SAAa,MAKxB,SAAS,OAAS,GAAG,KAAK,GAAG,mBAAmB,KAAK,EAAE,kBAFxC,IAAsB,GAAK,GAAK,GAEiC,eAClF,CAEA,SAAS,YAAqB,CAC5B,OAAO,OAAO,WAAW,CAC3B,CAEA,IAAa,cAAb,KAA2B,CACzB,SAAkC,KAClC,OAAgC,KAChC,UAAmD,KACnD,oBAEA,YAAY,oBAA2C,CACrD,KAAK,oBACH,qBAAuB,0BAC3B,CAEA,MAAa,CACX,GAAI,KAAK,SACP,OAGF,IAAM,GAAK,gBAAgB,EACrB,OAAS,IAAI,QAAQ,MAAM,GAAK,KAChC,WAAa,UAAU,WAAW,EAExC,KAAK,SAAW,QAAU,YAAc,WAAW,EAE/C,CAAC,QAAU,IACb,GAAG,QAAQ,OAAQ,KAAK,QAAQ,EAE7B,YACH,UAAU,YAAa,KAAK,QAAQ,EAElC,QAAU,CAAC,YACb,UAAU,YAAa,KAAK,QAAQ,EAElC,YAAc,CAAC,QAAU,IAC3B,GAAG,QAAQ,OAAQ,KAAK,QAAQ,EAGlC,IAAI,MACF,8BACA,KAAK,SACL,CAAC,CAAC,OACF,CAAC,CAAC,UACJ,EAEA,KAAK,iBAAiB,CACxB,CAEA,kBAAiC,CAC3B,KAAK,QAAU,KAAK,YAIxB,KAAK,WAAa,SAAY,CAC5B,IAAM,KAAO,MAAM,KAAK,oBAAoB,EAQ5C,MAPA,MAAK,OAAS,KACV,MACF,IAAI,MAAM,YAAa,IAAI,EAKtB,IACT,GAAG,EACL,CAEA,aAA6B,CAC3B,OAAO,KAAK,QACd,CAEA,WAA2B,CACzB,OAAO,KAAK,MACd,CAEA,sBAA+C,CAI7C,OAHI,KAAK,OACA,QAAQ,QAAQ,KAAK,MAAM,EAE7B,KAAK,WAAa,QAAQ,QAAQ,IAAI,CAC/C,CACF"}

package/dist/tracking/geo.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"geo.d.mts","names":[],"sources":["../../src/tracking/geo.ts"],"mappings":";cAea,WAAA;EAAA,QACH,MAAA;EAAA,QACA,OAAA;EAAA,QACA,MAAA;EAAA,iBACS,OAAA;cAEL,OAAA,UAAiB,UAAA,CAAW,KAAA;EAIxC,MAAA,CAAA,GAAU,OAAA;EAuBV,UAAA,CAAA;EAAA,QAIc,gBAAA;AAAA"}
+{"version":3,"file":"geo.d.mts","names":[],"sources":["../../src/tracking/geo.ts"],"mappings":";cAea,WAAA;EAAA,QACH,MAAA;EAAA,QACA,OAAA;EAAA,QACA,MAAA;EAAA,iBACS,OAAA;cAEL,OAAA,UAAiB,UAAA,CAAW,KAAA;EAIxC,MAAA,CAAA,GAAU,OAAO;EAuBjB,UAAA,CAAA;EAAA,QAIc,gBAAA;AAAA"}