@corbado/observe 1.13.0 → 1.14.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @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

package/dist/analysis/index.mjs

@@ -12,6 +12,7 @@ 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/tracker-core.mjs

@@ -133,6 +133,7 @@ var CorbadoTrackerCore = class _CorbadoTrackerCore {
       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");
@@ -273,6 +274,8 @@ var CorbadoTrackerCore = class _CorbadoTrackerCore {
   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(
@@ -891,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.13.0" : "0.0.0-dev";
+var SDK_VERSION = true ? "1.14.0" : "0.0.0-dev";
 export {
   SDK_NAME,
   SDK_VERSION