@corbado/observe 1.12.1 → 1.14.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @corbado/observe
 
+## 1.14.0
+
+### Minor Changes
+
+- 8f563e2: New tracker plugin `eventTime(stamp)` for `initCore`: every tracked event is dated by the integration's clock, `stamp(explicitTimestamp)`, instead of `explicitTimestamp ?? Date.now()`, also for SDK methods that take no timestamp (`flowStarted`, `flowFinished`, decisions, an operation's `subflow_started`). For integrations that replay host signals late (e.g. from a host-side event buffer). A clock that throws or returns a non-finite number falls back to the SDK's own dating; telemetry and low events keep their capture time. `init()` / `CorbadoTracker` are unchanged.
+
+## 1.13.0
+
+### Minor Changes
+
+- e0c70aa: New tracker plugin `fixedSourcePath(policy)` for `initCore`: the batch source path (`meta.trackingSourcePath`) comes from the integration's policy (e.g. `pageSourcePath(PAGES)` of `@corbado/autocapture`) instead of the server-driven `sourcePathQuery` config, so it can be declared in the integration's collection manifest. A failing policy sends the fully masked path. `init()` / `CorbadoTracker` are unchanged.
+
 ## 1.12.1
 
 ### Patch Changes

package/dist/analysis/index.mjs

@@ -11,6 +11,8 @@ export * from "./plugins/cookie-storage.mjs";
 export * from "./plugins/cross-origin-session.mjs";
 export * from "./plugins/raw-errors.mjs";
 export * from "./plugins/probes.mjs";
+export * from "./plugins/fixed-source-path.mjs";
+export * from "./plugins/event-time.mjs";
 export * from "./probe-lane.mjs";
 export * from "./transport.mjs";
 export * from "./queue.mjs";

package/dist/analysis/plugins/event-time.mjs

@@ -0,0 +1,18 @@
+// src/plugins/event-time.ts
+function eventTime(stamp) {
+  if (typeof stamp !== "function") return {};
+  return {
+    // Guarded here, not in the tracker: the core only pays for the hook call.
+    eventTime: (explicitTimestamp) => {
+      try {
+        const stamped = stamp(explicitTimestamp);
+        return typeof stamped === "number" && Number.isFinite(stamped) ? stamped : void 0;
+      } catch {
+        return void 0;
+      }
+    }
+  };
+}
+export {
+  eventTime
+};

package/dist/analysis/plugins/fixed-source-path.mjs

@@ -0,0 +1,47 @@
+// src/plugins/fixed-source-path.ts
+import { readLocationPath } from "../readers/page.mjs";
+var MAX_SOURCE_PATH = 2048;
+function maskedSourcePath(path) {
+  const segments = String(path ?? "").split("/").filter((segment) => segment !== "");
+  return segments.length === 0 ? "/" : "/" + segments.map(() => "*").join("/");
+}
+function fixedSourcePath(policy) {
+  if (typeof policy !== "function") return {};
+  return {
+    sourcePath: () => {
+      const { path, search } = readLocationPath({
+        key: "page:location.fixed-source-path",
+        title: "Page path and declared parameters",
+        accessNote: "location.pathname and location.search, reduced by the integration's declared page templates and parameters (trackingSourcePath); everything else is masked",
+        group: "Page",
+        origin: "observe-external",
+        fields: [
+          {
+            path: "url.path",
+            label: "Page path (declared parts only)",
+            category: "technical",
+            exposure: "partial",
+            transform: { note: "declared page templates and path parameters; other segments become '*'" }
+          },
+          {
+            path: "url.query",
+            label: "Page address parameters (declared ones only)",
+            category: "technical",
+            exposure: "redacted",
+            transform: { note: "declared parameters as their declared reduction; other values become '*'" }
+          }
+        ]
+      });
+      try {
+        const out = policy(path, search);
+        return typeof out === "string" ? out.slice(0, MAX_SOURCE_PATH) : maskedSourcePath(path);
+      } catch {
+        return maskedSourcePath(path);
+      }
+    }
+  };
+}
+export {
+  fixedSourcePath,
+  maskedSourcePath
+};

package/dist/analysis/readers/page.mjs

@@ -21,6 +21,9 @@ function readSourcePath(_meta, mode, allow) {
   const search = applySourcePathQuery(window.location.search, mode, allow);
   return `${window.location.pathname}${search}`;
 }
+function readLocationPath(_meta) {
+  return { path: window.location.pathname, search: window.location.search };
+}
 function readCookieScope(_meta) {
   return { hostname: window.location.hostname, https: window.location.protocol === "https:" };
 }
@@ -29,6 +32,7 @@ export {
   readCookieScope,
   readDocumentComplete,
   readDocumentHidden,
+  readLocationPath,
   readPageUrl,
   readSourcePath
 };

package/dist/analysis/tracker-core.mjs

@@ -132,6 +132,8 @@ var CorbadoTrackerCore = class _CorbadoTrackerCore {
     this.eachPlugin(installed, (plugin) => {
       if (plugin.session) this.bridge = plugin.session(this) || this.bridge;
       if (plugin.rawErrors) this.rawErrors = plugin.rawErrors;
+      if (typeof plugin.sourcePath === "function") this.fixedSourcePath = plugin.sourcePath;
+      if (plugin.eventTime) this.eventClock = plugin.eventTime;
     });
     if (options.fixedDataConfig?.crossOriginSession && !this.bridge) {
       this.logger.warn("fixedDataConfig.crossOriginSession is ignored without the crossOriginSession() plugin");
@@ -270,6 +272,10 @@ var CorbadoTrackerCore = class _CorbadoTrackerCore {
   bridge;
   /** Raw-error serializer of a plugin; undefined = operation step errors drop `rawError`. */
   rawErrors;
+  /** Fixed source path of a plugin; undefined = the server-driven `sourcePathQuery` policy. */
+  fixedSourcePath;
+  /** Event clock of a plugin (never throws); undefined or an undefined result = `explicitTimestamp ?? Date.now()`. */
+  eventClock;
   /** @internal Shared passive page observation and per-operation context registration. */
   getWindowObserver() {
     return this.windowObserver ??= new SharedWindowObserver(
@@ -719,6 +725,14 @@ var CorbadoTrackerCore = class _CorbadoTrackerCore {
     if (typeof window === "undefined") {
       return void 0;
     }
+    if (this.fixedSourcePath) {
+      try {
+        const path = this.fixedSourcePath();
+        return typeof path === "string" ? path : void 0;
+      } catch {
+        return void 0;
+      }
+    }
     return readSourcePath(
       {
         key: "page:location.source-path",
@@ -880,7 +894,7 @@ var CorbadoTrackerCore = class _CorbadoTrackerCore {
       if (name === AuthEventName.FlowFinished || name === AuthEventName.FlowAutoFinished || name === AuthEventName.FlowReset) {
         this.windowObserver?.flushInputs();
       }
-      const timestamp = explicitTimestamp ?? Date.now();
+      const timestamp = this.eventClock?.(explicitTimestamp) ?? explicitTimestamp ?? Date.now();
       const capturedId = capture?.id ?? uuidv7();
       const capturedSessionId = capture?.sessionId ?? this.sessionId;
       const nextSeq = this.nextSeq();

package/dist/analysis/version.mjs

@@ -1,6 +1,6 @@
 // src/version.ts
 var SDK_NAME = "@corbado/observe";
-var SDK_VERSION = true ? "1.12.1" : "0.0.0-dev";
+var SDK_VERSION = true ? "1.14.0" : "0.0.0-dev";
 export {
   SDK_NAME,
   SDK_VERSION