@corbado/observe 1.10.0 → 1.11.0

package/dist/analysis/tracker-features.mjs

@@ -0,0 +1,80 @@
+// src/tracker-features.ts
+import { v7 as uuidv7 } from "uuid";
+import { AuthEventName } from "./types.mjs";
+import { SEQ_STORAGE_KEY } from "./session-keys.mjs";
+function resetSessionOn(tracker) {
+  const newSessionId = uuidv7();
+  if (tracker["config"].sessionContinuity) {
+    tracker["persistContinuitySession"](newSessionId, Date.now());
+    tracker["persistentStorage"].setItem(SEQ_STORAGE_KEY, 0);
+  } else {
+    tracker["persistPerTabSession"](newSessionId, Date.now());
+  }
+  tracker["sessionId"] = newSessionId;
+  tracker["seq"] = 0;
+  tracker["queue"].setSessionId(newSessionId);
+  tracker["bridge"]?.reset(newSessionId);
+  tracker.getLogger().debug(`Session reset: ${newSessionId}`);
+  return newSessionId;
+}
+function setUserOn(tracker, user) {
+  void tracker.track(AuthEventName.FlowEnriched, { match: { flowType: "*", at: "during" }, expFol: true }, { ...user });
+}
+function setFlowTagsOn(tracker, tags, options) {
+  const logger = tracker.getLogger();
+  try {
+    if (!tags || typeof tags !== "object") {
+      logger.warn("setFlowTags: ignoring non-object tags");
+      return;
+    }
+    const valid = {};
+    for (const [key, value] of Object.entries(tags)) {
+      if (key === "" || typeof value !== "string") {
+        logger.warn(`setFlowTags: ignoring invalid tag "${key}"`);
+        continue;
+      }
+      valid[key] = value;
+    }
+    if (Object.keys(valid).length === 0) {
+      return;
+    }
+    const data = { match: { flowType: options?.flowType ?? "*", at: "during" } };
+    if (options?.expandToChildren !== void 0) {
+      data.expCh = options.expandToChildren;
+    }
+    if (options?.expandToFollowing !== void 0) {
+      data.expFol = options.expandToFollowing;
+    }
+    void tracker.track(AuthEventName.FlowEnriched, data, void 0, valid);
+  } catch (error) {
+    logger.warn("Failed to set flow tags", error);
+  }
+}
+function clearExperimentOn(tracker, key) {
+  try {
+    if (Object.prototype.hasOwnProperty.call(tracker["experiments"], key)) {
+      delete tracker["experiments"][key];
+      tracker["persistExperiments"]();
+    }
+  } catch (error) {
+    tracker.getLogger().error("Failed to clear experiment", error);
+  }
+}
+function clearExperimentsOn(tracker) {
+  try {
+    if (Object.keys(tracker["experiments"]).length === 0) {
+      return;
+    }
+    tracker["experiments"] = {};
+    tracker["persistExperiments"]();
+  } catch (error) {
+    tracker.getLogger().error("Failed to clear experiments", error);
+  }
+}
+export {
+  clearExperimentOn,
+  clearExperimentsOn,
+  resetSessionOn,
+  setFlowTagsOn,
+  setUserOn
+};

package/dist/analysis/tracker-functions.mjs

@@ -0,0 +1,103 @@
+// src/tracker-functions.ts
+import { getDefaultTracker, isTracker } from "./default-tracker.mjs";
+import {
+  AuthEventName
+} from "./types.mjs";
+import { clearExperimentOn, clearExperimentsOn, resetSessionOn, setFlowTagsOn, setUserOn } from "./tracker-features.mjs";
+function resetSession(tracker) {
+  const target = isTracker(tracker) ? tracker : getDefaultTracker();
+  return target ? resetSessionOn(target) : void 0;
+}
+function setUser(first, second) {
+  const [tracker, user] = isTracker(first) ? [first, second] : [getDefaultTracker(), first];
+  if (tracker) setUserOn(tracker, user);
+}
+function setFlowTags(first, second, third) {
+  const explicit = isTracker(first);
+  const tracker = explicit ? first : getDefaultTracker();
+  if (!tracker) {
+    return;
+  }
+  setFlowTagsOn(
+    tracker,
+    explicit ? second : first,
+    explicit ? third : second
+  );
+}
+function setExperiment(first, second, third) {
+  if (isTracker(first)) {
+    first.setExperiments({ [second]: third });
+  } else {
+    getDefaultTracker()?.setExperiments({ [first]: second });
+  }
+}
+function clearExperiment(first, second) {
+  const [tracker, key] = isTracker(first) ? [first, second] : [getDefaultTracker(), first];
+  if (tracker) clearExperimentOn(tracker, key);
+}
+function clearExperiments(tracker) {
+  const target = isTracker(tracker) ? tracker : getDefaultTracker();
+  if (target) clearExperimentsOn(target);
+}
+function logInfo(first, second) {
+  if (isTracker(first)) first.telemetry("info", second);
+  else getDefaultTracker()?.telemetry("info", first);
+}
+function logError(first, second) {
+  if (isTracker(first)) first.telemetry("error", second);
+  else getDefaultTracker()?.telemetry("error", first);
+}
+function conversion(tracker, data, tags, experiments) {
+  const { userId, identifier, crossEnvironmentTransactionID, ...dataOut } = data;
+  const userReference = { userId, identifier, crossEnvironmentTransactionID };
+  const effectiveTags = { ...tracker["options"].defaultTags, ...tracker["applicationTag"](), ...tags };
+  void tracker.track(
+    AuthEventName.Conversion,
+    dataOut,
+    userReference,
+    effectiveTags,
+    void 0,
+    void 0,
+    experiments
+  );
+}
+function authDecisionStarted(tracker, data, tags, experiments) {
+  void tracker.track(AuthEventName.AuthDecisionStarted, data, void 0, tags, void 0, void 0, experiments);
+}
+function authDecisionFinished(tracker, data, tags, experiments) {
+  void tracker.track(AuthEventName.AuthDecisionFinished, data, void 0, tags, void 0, void 0, experiments);
+}
+function trackSubflowError(tracker, subflowType, data, options) {
+  const wrappedData = {
+    subflowType,
+    stepData: data
+  };
+  void tracker.track(
+    AuthEventName.SubflowError,
+    wrappedData,
+    options?.userReference,
+    void 0,
+    void 0,
+    options?.explicitTimestamp,
+    options?.experiments,
+    {
+      subflowStartEventId: options?.subflowStartEventId,
+      sessionId: options?.captureSessionId,
+      initiator: options?.initiator
+    }
+  );
+}
+export {
+  authDecisionFinished,
+  authDecisionStarted,
+  clearExperiment,
+  clearExperiments,
+  conversion,
+  logError,
+  logInfo,
+  resetSession,
+  setExperiment,
+  setFlowTags,
+  setUser,
+  trackSubflowError
+};

package/dist/analysis/transports/fetch.mjs

@@ -1,11 +1,26 @@
 // src/transports/fetch.ts
 import { parseReliabilityConfig } from "../config.mjs";
-import { beaconSender, sendFetch } from "../readers/network.mjs";
+import { beaconSender, declareBrowserRequestData, sendFetch } from "../readers/network.mjs";
 var MAX_KEEPALIVE_BODY_BYTES = 6e4;
 var FETCH_TIMEOUT_MS = 6e4;
 var FetchTransport = class {
   constructor(options) {
     this.options = options;
+    declareBrowserRequestData({
+      key: "browser-api:device.user-agent",
+      title: "Browser and operating system",
+      accessNote: "User-Agent header the browser sends with every request to the Observe ingestion API (the SDK does not read it); Corbado stores it and derives browser and operating system name and version",
+      group: "Device information",
+      origin: "observe-external",
+      fields: [
+        {
+          path: "request.header.user-agent",
+          label: "Browser and operating system identifier",
+          exposure: "raw",
+          transform: { note: "full User-Agent string, sent by the browser" }
+        }
+      ]
+    });
   }
   /**
    * Error situations:

package/dist/analysis/utils/appconfirmation-operation-full.mjs

@@ -14,6 +14,10 @@ var AppConfirmationOperationFull = class extends OperationFull {
     void this.subflowStart({ explicitSpecType: config.explicitSpecType });
   }
 };
+function appConfirmationOperationFull(tracker, config) {
+  return new AppConfirmationOperationFull(tracker, config);
+}
 export {
-  AppConfirmationOperationFull
+  AppConfirmationOperationFull,
+  appConfirmationOperationFull
 };

package/dist/analysis/utils/captcha-operation-full.mjs

@@ -12,6 +12,10 @@ var CaptchaOperationFull = class extends OperationFull {
     void this.subflowStart({ explicitSpecType: config.explicitSpecType });
   }
 };
+function captchaOperationFull(tracker, config) {
+  return new CaptchaOperationFull(tracker, config);
+}
 export {
-  CaptchaOperationFull
+  CaptchaOperationFull,
+  captchaOperationFull
 };

package/dist/analysis/utils/email-link-operation-full.mjs

@@ -156,7 +156,15 @@ var EmailLinkContinuationOperation = class extends OperationFull {
     };
   }
 };
+function emailLinkOperationFull(tracker, config) {
+  return new EmailLinkOperationFull(tracker, config);
+}
+function continueEmailLinkOperation(tracker, config) {
+  return new EmailLinkContinuationOperation(tracker, config);
+}
 export {
   EmailLinkContinuationOperation,
-  EmailLinkOperationFull
+  EmailLinkOperationFull,
+  continueEmailLinkOperation,
+  emailLinkOperationFull
 };

package/dist/analysis/utils/email-otp-operation-full.mjs

@@ -33,6 +33,10 @@ var EmailOtpOperationFull = class extends OperationFull {
     this.lowEventTracker?.destroy();
   }
 };
+function emailOtpOperationFull(tracker, config) {
+  return new EmailOtpOperationFull(tracker, config);
+}
 export {
-  EmailOtpOperationFull
+  EmailOtpOperationFull,
+  emailOtpOperationFull
 };

package/dist/analysis/utils/form-operation-full.mjs

@@ -75,6 +75,10 @@ function warn(tracker, message) {
   } catch {
   }
 }
+function formOperationFull(tracker, config) {
+  return new FormOperationFull(tracker, config);
+}
 export {
-  FormOperationFull
+  FormOperationFull,
+  formOperationFull
 };

package/dist/analysis/utils/key-operation-full.mjs

@@ -32,7 +32,15 @@ var KeyRegistrationOperationFull = class extends OperationFull {
     void this.subflowStart({ actor: "system", explicitSpecType: specType(tracker, config) });
   }
 };
+function keySigningOperationFull(tracker, config) {
+  return new KeySigningOperationFull(tracker, config);
+}
+function keyRegistrationOperationFull(tracker, config) {
+  return new KeyRegistrationOperationFull(tracker, config);
+}
 export {
   KeyRegistrationOperationFull,
-  KeySigningOperationFull
+  KeySigningOperationFull,
+  keyRegistrationOperationFull,
+  keySigningOperationFull
 };

package/dist/analysis/utils/operation-full-provide-identifier-with-cui.mjs

@@ -41,6 +41,13 @@ var OperationFullProvideIdentifierWithCUI = class extends OperationFull {
     this.lowEventTracker?.destroy();
   }
 };
+function provideIdentifierOperationFull(tracker, config) {
+  return new OperationFullProvideIdentifierWithCUI(
+    tracker,
+    config
+  );
+}
 export {
-  OperationFullProvideIdentifierWithCUI
+  OperationFullProvideIdentifierWithCUI,
+  provideIdentifierOperationFull
 };

package/dist/analysis/utils/operation-full.mjs

@@ -3,7 +3,6 @@ import { reserveCaptureSeq } from "../low-events/capture-sequence.mjs";
 import { inferCeremonyInitiator } from "../low-events/ceremony-initiator.mjs";
 import { v7 as uuidv7 } from "uuid";
 import { normalizeError } from "./normalize-error.mjs";
-import { serializeRawError } from "./serialize-raw-error.mjs";
 var CEREMONY_LOW_EVENT_TAIL_MS = 1500;
 var OperationFull = class {
   constructor(tracker, operationName) {
@@ -30,7 +29,6 @@ var OperationFull = class {
         this.captureSessionId
       ),
       flushKeepalive: () => this.tracker.lowEventFlushKeepalive(),
-      passwordManagerDomScan: () => this.tracker.isPasswordManagerDomScanEnabled(),
       registerInputs: (fields, flush) => this.tracker.getWindowObserver().registerInputs(
         fields,
         () => ({
@@ -163,7 +161,10 @@ var OperationFull = class {
     let payload = data;
     try {
       const rawError = this.tracker.getSdkConfig().rawErrors ? options?.rawError : void 0;
-      if (rawError !== void 0) payload = { ...data, rawError: serializeRawError(rawError, options?.rawErrorLimits) };
+      if (rawError !== void 0) {
+        const serialize = this.tracker["rawErrors"];
+        if (serialize) payload = { ...data, rawError: serialize(rawError, options?.rawErrorLimits) };
+      }
     } catch {
     }
     void this.tracker.trackSubflowStepError(this.operationName, stepName, payload, this.captureOptions(options));

package/dist/analysis/utils/passkey-deletion-operation-full.mjs

@@ -12,6 +12,10 @@ var PasskeyDeletionOperationFull = class extends OperationFull {
     void this.subflowStart({});
   }
 };
+function passkeyDeletionOperationFull(tracker, config) {
+  return new PasskeyDeletionOperationFull(tracker, config);
+}
 export {
-  PasskeyDeletionOperationFull
+  PasskeyDeletionOperationFull,
+  passkeyDeletionOperationFull
 };

package/dist/analysis/utils/passkey-enrollment-operation-full.mjs

@@ -30,6 +30,10 @@ var PasskeyEnrollmentOperationFull = class extends OperationFull {
     this.lowEventTracker.destroy();
   }
 };
+function passkeyEnrollmentFullOperation(tracker, config) {
+  return new PasskeyEnrollmentOperationFull(tracker, config);
+}
 export {
-  PasskeyEnrollmentOperationFull
+  PasskeyEnrollmentOperationFull,
+  passkeyEnrollmentFullOperation
 };

package/dist/analysis/utils/passkey-login-operation-full.mjs

@@ -34,6 +34,10 @@ var PasskeyLoginOperationFull = class extends OperationFull {
     this.lowEventTracker.destroy();
   }
 };
+function passkeyLoginFullOperation(tracker, config) {
+  return new PasskeyLoginOperationFull(tracker, config);
+}
 export {
-  PasskeyLoginOperationFull
+  PasskeyLoginOperationFull,
+  passkeyLoginFullOperation
 };

package/dist/analysis/utils/password-enrollment-operation-full.mjs

@@ -22,6 +22,10 @@ var PasswordEnrollmentOperationFull = class extends OperationFull {
     this.lowEventTracker?.destroy();
   }
 };
+function passwordEnrollmentFullOperation(tracker, config) {
+  return new PasswordEnrollmentOperationFull(tracker, config);
+}
 export {
-  PasswordEnrollmentOperationFull
+  PasswordEnrollmentOperationFull,
+  passwordEnrollmentFullOperation
 };

package/dist/analysis/utils/password-login-operation-full.mjs

@@ -60,6 +60,10 @@ var PasswordLoginOperationFull = class extends OperationFull {
     this.identifierLowEventTracker?.destroy();
   }
 };
+function passwordLoginFullOperation(tracker, config) {
+  return new PasswordLoginOperationFull(tracker, config);
+}
 export {
-  PasswordLoginOperationFull
+  PasswordLoginOperationFull,
+  passwordLoginFullOperation
 };

package/dist/analysis/utils/provide-data-operation-full.mjs

@@ -23,6 +23,10 @@ var ProvideDataOperationFull = class extends OperationFull {
     this.lowEventTracker?.destroy();
   }
 };
+function provideDataOperationFull(tracker, config) {
+  return new ProvideDataOperationFull(tracker, config);
+}
 export {
-  ProvideDataOperationFull
+  ProvideDataOperationFull,
+  provideDataOperationFull
 };

package/dist/analysis/utils/sms-otp-operation-full.mjs

@@ -33,6 +33,10 @@ var SmsOtpOperationFull = class extends OperationFull {
     this.lowEventTracker?.destroy();
   }
 };
+function smsOtpOperationFull(tracker, config) {
+  return new SmsOtpOperationFull(tracker, config);
+}
 export {
-  SmsOtpOperationFull
+  SmsOtpOperationFull,
+  smsOtpOperationFull
 };

package/dist/analysis/utils/social-operation-login.mjs

@@ -12,6 +12,10 @@ var SocialLoginOperationFull = class extends OperationFull {
     void this.subflowStart({ explicitSpecType: config.explicitSpecType, entry: config.entry });
   }
 };
+function socialLoginOperationFull(tracker, config) {
+  return new SocialLoginOperationFull(tracker, config);
+}
 export {
-  SocialLoginOperationFull
+  SocialLoginOperationFull,
+  socialLoginOperationFull
 };

package/dist/analysis/utils/sso-operation-login.mjs

@@ -32,6 +32,10 @@ function validateConfig(config, tracker) {
   }
   return result;
 }
+function ssoLoginOperationFull(tracker, config) {
+  return new SsoLoginOperationFull(tracker, config);
+}
 export {
-  SsoLoginOperationFull
+  SsoLoginOperationFull,
+  ssoLoginOperationFull
 };

package/dist/analysis/utils/totp-operation-full.mjs

@@ -29,6 +29,10 @@ var TotpOperationFull = class extends OperationFull {
     this.lowEventTracker?.destroy();
   }
 };
+function totpOperationFull(tracker, config) {
+  return new TotpOperationFull(tracker, config);
+}
 export {
-  TotpOperationFull
+  TotpOperationFull,
+  totpOperationFull
 };

package/dist/analysis/utils/trusted-device-operation-full.mjs

@@ -94,7 +94,15 @@ function validateConfig(config, tracker) {
   }
   return result;
 }
+function trustedDeviceCheckOperationFull(tracker, config) {
+  return new TrustedDeviceCheckOperationFull(tracker, config);
+}
+function trustedDeviceEnrollmentOperationFull(tracker, config) {
+  return new TrustedDeviceEnrollmentOperationFull(tracker, config);
+}
 export {
   TrustedDeviceCheckOperationFull,
-  TrustedDeviceEnrollmentOperationFull
+  TrustedDeviceEnrollmentOperationFull,
+  trustedDeviceCheckOperationFull,
+  trustedDeviceEnrollmentOperationFull
 };

package/dist/analysis/version.mjs

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