saasco-sdk 0.2.3 → 0.2.5

package/dist/index.js

@@ -2,7 +2,7 @@
 import { isValid, parse } from "psl";
 
 // package.json
-var version = "0.2.3";
+var version = "0.2.5";
 
 // src/lib/timezones.ts
 var timezones = {
@@ -451,6 +451,9 @@ var AnalyticsLogger = class {
   constructor(config) {
     this.config = config;
   }
+  setLevel(level) {
+    this.config.level = level;
+  }
   debug(...args) {
     if (this.config.level < 3 /* DEBUG */) {
       return;
@@ -531,9 +534,34 @@ function getIntegrationLoggerLevel(integrationName, debug) {
 }
 
 // src/lib/utils/uuid.ts
-import { v4 } from "@lukeed/uuid";
+var HEX = [];
+for (let i = 0; i < 256; i++) {
+  HEX[i] = (i + 256).toString(16).slice(1);
+}
 function uuid() {
-  return v4();
+  const bytes = randomBytes(16);
+  bytes[6] = bytes[6] & 15 | 64;
+  bytes[8] = bytes[8] & 63 | 128;
+  let out = "";
+  for (let i = 0; i < 16; i++) {
+    out += HEX[bytes[i]];
+    if (i === 3 || i === 5 || i === 7 || i === 9) {
+      out += "-";
+    }
+  }
+  return out;
+}
+function randomBytes(length) {
+  const bytes = new Uint8Array(length);
+  const webCrypto = globalThis.crypto;
+  if (typeof webCrypto?.getRandomValues === "function") {
+    webCrypto.getRandomValues(bytes);
+    return bytes;
+  }
+  for (let i = 0; i < length; i++) {
+    bytes[i] = Math.random() * 256 | 0;
+  }
+  return bytes;
 }
 
 // src/lib/getBrowserContext.ts
@@ -1839,6 +1867,41 @@ function normalizeSaascoUrl(url) {
   return parsed.toString();
 }
 
+// src/lib/widgetLoader.ts
+function isEnabledPayload(data2) {
+  return typeof data2 === "object" && data2 !== null && "enabled" in data2 && data2.enabled === true;
+}
+function getUrlOrigin(url) {
+  try {
+    return new URL(
+      url,
+      typeof window === "undefined" ? void 0 : window.location.href
+    ).origin;
+  } catch {
+  }
+}
+function isLoaderPresent(fileName, injectedFlag) {
+  return Boolean(
+    injectedFlag || document.querySelector(`script[src*="${fileName}"]`)
+  );
+}
+function appendLoaderScript({
+  attributes,
+  onLoad,
+  src
+}) {
+  const script = document.createElement("script");
+  script.async = true;
+  script.src = src;
+  for (const [name, value] of Object.entries(attributes)) {
+    script.setAttribute(name, value);
+  }
+  if (onLoad) {
+    script.addEventListener("load", onLoad);
+  }
+  (document.body ?? document.head ?? document.documentElement).append(script);
+}
+
 // src/lib/social-proof/storage.ts
 var WIDGET_PAYLOAD_PATH = "/api/social-proof/widget";
 var SOCIAL_PROOF_LOADER_FILE = "saasco-social-proof-loader.js";
@@ -1918,17 +1981,16 @@ async function injectSocialProofLoader({
     return;
   }
   window.__saascoSocialProofInjected = true;
-  const script = document.createElement("script");
-  script.async = true;
-  script.src = normalizeSaascoUrl(scriptUrl);
-  script.setAttribute("data-projectId", projectId);
+  const attributes = {
+    "data-projectId": projectId
+  };
   if (baseUrlOverride !== void 0) {
-    script.setAttribute(
-      "data-base-url",
-      normalizeSaascoBaseUrl(baseUrlOverride)
-    );
+    attributes["data-base-url"] = normalizeSaascoBaseUrl(baseUrlOverride);
   }
-  (document.body ?? document.head ?? document.documentElement).append(script);
+  appendLoaderScript({
+    attributes,
+    src: normalizeSaascoUrl(scriptUrl)
+  });
 }
 async function shouldInjectSocialProof({
   baseUrl,
@@ -1957,23 +2019,12 @@ async function shouldInjectSocialProof({
   writeSession(cacheKey, JSON.stringify({ data: data2, fetchedAt: Date.now() }));
   return isEnabledPayload(data2);
 }
-function isEnabledPayload(data2) {
-  return typeof data2 === "object" && data2 !== null && data2.enabled === true;
-}
 function isSocialProofLoaderPresent() {
-  return Boolean(
-    window.__saascoSocialProofInjected || document.querySelector(`script[src*="${SOCIAL_PROOF_LOADER_FILE}"]`)
+  return isLoaderPresent(
+    SOCIAL_PROOF_LOADER_FILE,
+    window.__saascoSocialProofInjected
   );
 }
-function getUrlOrigin(url) {
-  try {
-    return new URL(
-      url,
-      typeof window === "undefined" ? void 0 : window.location.href
-    ).origin;
-  } catch {
-  }
-}
 function isSocialProofQaMode() {
   if (typeof window === "undefined") {
     return false;
@@ -1988,19 +2039,81 @@ function isSocialProofQaMode() {
   }
 }
 
+// src/lib/support/widgetEnabledCheck.ts
+var SUPPORT_WIDGET_PATH = "/api/support/widget";
+var SUPPORT_LOADER_FILE = "saasco-support-loader.js";
+async function injectSupportLoader({
+  baseUrl: baseUrlOverride,
+  onLoad,
+  placeholder,
+  projectId,
+  scriptUrl
+}) {
+  if (typeof window === "undefined" || typeof document === "undefined") {
+    return "skipped";
+  }
+  if (isSupportLoaderPresent()) {
+    return "present";
+  }
+  const baseUrl = normalizeSaascoBaseUrl(
+    baseUrlOverride ?? getUrlOrigin(scriptUrl) ?? SAASCO_ORIGIN
+  );
+  const enabled = await shouldInjectSupport({
+    baseUrl,
+    projectId
+  });
+  if (!enabled) {
+    return "skipped";
+  }
+  if (isSupportLoaderPresent()) {
+    return "present";
+  }
+  window.__saascoSupportInjected = true;
+  const attributes = {
+    "data-projectId": projectId
+  };
+  if (baseUrlOverride !== void 0) {
+    attributes["data-base-url"] = normalizeSaascoBaseUrl(baseUrlOverride);
+  }
+  if (placeholder !== void 0) {
+    attributes["data-placeholder"] = placeholder;
+  }
+  appendLoaderScript({
+    attributes,
+    onLoad,
+    src: normalizeSaascoUrl(scriptUrl)
+  });
+  return "injected";
+}
+async function shouldInjectSupport({
+  baseUrl,
+  projectId
+}) {
+  try {
+    const response = await fetch(
+      `${baseUrl}${SUPPORT_WIDGET_PATH}?projectId=${encodeURIComponent(projectId)}`
+    );
+    if (!response.ok) {
+      return false;
+    }
+    return isEnabledPayload(await response.json());
+  } catch {
+    return false;
+  }
+}
+function isSupportLoaderPresent() {
+  return isLoaderPresent(SUPPORT_LOADER_FILE, window.__saascoSupportInjected);
+}
+
 // src/lib/analytics.ts
-function getSupportChatGlobal() {
-  return window.SaascoSupportChat;
+function getSupportGlobal() {
+  return window.SaascoSupport;
 }
 var isBrowser5 = typeof window !== "undefined";
 var isServer5 = !isBrowser5;
 var PREF = "saasco-sdk";
 var SESSION_DURATION = 1e3 * 60 * 30;
 var USER_DURATION = 1e3 * 60 * 60 * 24 * 365;
-var SUPPORT_CHAT_ATTR_MAP = {
-  baseUrl: "data-base-url",
-  placeholder: "data-placeholder"
-};
 var data = {};
 function getRootDomain(url) {
   if (isServer5) {
@@ -2168,7 +2281,7 @@ function getUserId() {
 function setUserId(userId) {
   storeData(`user-id`, userId ?? void 0, USER_DURATION);
 }
-function buildSupportChatTraits(properties, envelope) {
+function buildSupportTraits(properties, envelope) {
   const traits = {};
   const add = (key, value) => {
     if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
@@ -2289,7 +2402,7 @@ var Saasco = class {
    * @param config Configuration options.
    * @param config.projectId The unique identifier for the project.
    * @param config.proxy The URL of the proxy server to use, if any.
-   * @param config.autoPageTracking Whether to automatically track page views. Default is false.
+   * @param config.autoPageTracking Whether to automatically track page views. Default is true.
    * @param config.enabled Whether analytics is enabled. Default is true. Set to false for development and staging envioronments. Will still allow debug mode to be true, just no events will be sent
    * @param config.debug Whether to log debug information. Default is false.
    * @param config.trackUrlParams Whether to track URL parameters. Default is true.
@@ -2338,10 +2451,10 @@ var Saasco = class {
   integrationManager;
   logger;
   // Last identity handed to `identify()`, mirrored into the lazily-loaded
-  // support-chat widget so chat conversations attach to a CRM contact. Held
+  // support widget so chat conversations attach to a CRM contact. Held
   // here so an `identify()` that fires before the widget bundle finishes
   // loading is replayed once it does.
-  lastSupportChatIdentity = null;
+  lastSupportIdentity = null;
   init() {
     if (this.isInitialized) {
       this.logger.info(
@@ -2365,52 +2478,20 @@ var Saasco = class {
       );
     }
     this.initAutoPageTracking();
-    if (this.config.supportChat && this.config.supportChat.enabled !== false) {
-      this.injectSupportChat();
-    }
-    if (this.config.socialProof?.enabled !== false) {
-      void this.injectSocialProof();
-    }
+    void this.injectSupport();
+    void this.injectSocialProof();
     this.isInitialized = true;
   }
   disableDebug() {
     this.logger.info("Debug mode deactivated.");
     this.config.debug = false;
+    this.logger.setLevel(getLoggerLevel(this.config));
   }
   enableDebug() {
     this.config.debug = true;
+    this.logger.setLevel(getLoggerLevel(this.config));
     this.logger.info("Debug mode activated.");
   }
-  /**
-   * Enables and injects the support chat widget when it was constructed with
-   * `supportChat: { enabled: false }`. Safe to call multiple times.
-   */
-  enableSupportChat() {
-    if (!this.config.supportChat) {
-      this.logger.warn(
-        "Support chat is not configured; enableSupportChat() was ignored."
-      );
-      return;
-    }
-    this.config.supportChat.enabled = true;
-    this.injectSupportChat();
-    this.pushSupportChatIdentity();
-  }
-  /**
-   * Enables and injects the social-proof widget (e.g. after constructing with
-   * `socialProof: { enabled: false }`, or when no `socialProof` block was
-   * passed). Injection still runs the server check, so the loader only
-   * downloads when the project has the app enabled in the dashboard.
-   * Safe to call multiple times — the loader injection is guarded against
-   * double-injection.
-   */
-  enableSocialProof() {
-    this.config.socialProof = {
-      ...this.config.socialProof,
-      enabled: true
-    };
-    void this.injectSocialProof();
-  }
   /**
    * Initialize third-party integrations
    */
@@ -2527,7 +2608,7 @@ var Saasco = class {
   }
   /**
    * The page method lets you record page views on your website
-   * This records the page title and path and names the event useing the reserved property "Page Viewed"
+   * This records the page title and path and names the event using the reserved name "Page View"
    *
    * Before implementing this make sure you have disabled the autoPageTracking in the config or you will get duplicate page views
    */
@@ -2573,13 +2654,13 @@ var Saasco = class {
       reset: userIdChangedToNull
     });
     setUserId(distinctId);
-    this.updateSupportChatIdentity({
+    this.updateSupportIdentity({
       distinctId: hasId && distinctId !== null ? distinctId : void 0,
       email: typeof properties?.["email"] === "string" ? properties["email"] : void 0,
       // Forward the full scalar payload (browser/track context + identify traits
       // + session envelope) so the widget can bind them via live context without
       // the host mirroring traits into `setStateSnapshot`.
-      traits: buildSupportChatTraits(properties, { anonymousId, sessionId })
+      traits: buildSupportTraits(properties, { anonymousId, sessionId })
     });
     this.integrationManager.setContext({
       distinctId,
@@ -2751,51 +2832,25 @@ Request Data: ${JSON.stringify(requestData, null, 2)}`
     return this.integrationManager.getStats();
   }
   /**
-   * Lazily injects the support-chat **loader** from the same `/sdk/` origin as
-   * the analytics bundle, forwarding the shared `projectId` and the widget
-   * config as `data-*` attributes. The loader (no React) injects the
-   * cross-origin embed iframe. Deferred (`async`) and guarded against
-   * double-injection so re-running `init()` is a no-op.
+   * Lazily injects the support **loader** (server-gated). See
+   * {@link injectSupportLoader}. Replays identity once the script loads.
    */
-  injectSupportChat() {
-    if (!isBrowser5 || typeof document === "undefined") {
-      return;
-    }
-    const chat = this.config.supportChat;
-    if (!chat) {
-      return;
-    }
-    if (window.__saascoSupportChatInjected || document.querySelector('script[src*="saasco-support-chat-loader.js"]')) {
-      return;
-    }
-    const scriptUrl = resolveLoaderScriptUrl(
-      "saasco-support-chat-loader.js",
-      chat.scriptUrl
-    );
-    if (!scriptUrl) {
-      this.logger.warn(
-        "Support chat is enabled but the loader URL could not be resolved. Pass `supportChat.scriptUrl` pointing at your hosted saasco-support-chat-loader.js (or load the analytics SDK from the CDN)."
-      );
+  async injectSupport() {
+    if (!isBrowser5) {
       return;
     }
-    window.__saascoSupportChatInjected = true;
-    const script = document.createElement("script");
-    script.async = true;
-    script.src = normalizeSaascoUrl(scriptUrl);
-    script.setAttribute("data-projectId", this.config.projectId);
-    for (const [key, attr] of Object.entries(SUPPORT_CHAT_ATTR_MAP)) {
-      const value = chat[key];
-      if (value !== void 0) {
-        script.setAttribute(
-          attr,
-          attr === "data-base-url" ? normalizeSaascoBaseUrl(value) : value
-        );
-      }
-    }
-    script.addEventListener("load", () => {
-      this.pushSupportChatIdentity();
+    const { support } = this.config;
+    const scriptUrl = resolveLoaderScriptUrl("saasco-support-loader.js", support?.scriptUrl) ?? `${SAASCO_ORIGIN}/sdk/saasco-support-loader.js`;
+    const result = await injectSupportLoader({
+      baseUrl: support?.baseUrl,
+      onLoad: () => this.pushSupportIdentity(),
+      placeholder: support?.placeholder,
+      projectId: this.config.projectId,
+      scriptUrl
     });
-    (document.body ?? document.head ?? document.documentElement).append(script);
+    if (result === "present") {
+      this.pushSupportIdentity();
+    }
   }
   /**
    * Lazily injects the social-proof loader (server-gated). See
@@ -2817,42 +2872,38 @@ Request Data: ${JSON.stringify(requestData, null, 2)}`
     });
   }
   /**
-   * Records the latest CRM identity and forwards it to the support-chat widget.
-   * No-op when support chat isn't enabled.
+   * Records the latest CRM identity and forwards it to the support widget.
    */
-  updateSupportChatIdentity(identity) {
-    if (!isBrowser5 || !this.config.supportChat) {
+  updateSupportIdentity(identity) {
+    if (!isBrowser5) {
       return;
     }
     const hasTraits = identity.traits && Object.keys(identity.traits).length > 0;
-    this.lastSupportChatIdentity = identity.distinctId || identity.email || hasTraits ? identity : null;
-    if (this.config.supportChat.enabled === false) {
-      return;
-    }
-    this.pushSupportChatIdentity();
+    this.lastSupportIdentity = identity.distinctId || identity.email || hasTraits ? identity : null;
+    this.pushSupportIdentity();
   }
   /**
-   * Pushes the current identity onto `window.SaascoSupportChat.identify`. The
+   * Pushes the current identity onto `window.SaascoSupport.identify`. The
    * widget bundle publishes that global asynchronously, so this short-polls for
-   * it (same approach as tool registration); the load handler also calls this,
-   * so a fresh page load with a stored distinctId still identifies the chat.
+   * it (same approach as tool registration). `injectSupport` calls this on
+   * script load (or immediately when the loader is already present).
    */
-  pushSupportChatIdentity() {
-    if (!isBrowser5 || !this.config.supportChat || this.config.supportChat.enabled === false) {
+  pushSupportIdentity() {
+    if (!isBrowser5) {
       return;
     }
-    const identity = this.lastSupportChatIdentity ?? {
+    const identity = this.lastSupportIdentity ?? {
       distinctId: getUserId() ?? void 0,
       // Anonymous (pre-identify) page load: still forward browser/track context
       // and the session envelope so live context has them from the first turn.
-      traits: buildSupportChatTraits(void 0, {
+      traits: buildSupportTraits(void 0, {
         anonymousId: getAnonymousId() ?? void 0,
         sessionId: getSessionId() ?? void 0
       })
     };
     let attempts = 0;
     const tryPush = () => {
-      const api = getSupportChatGlobal();
+      const api = getSupportGlobal();
       if (!api) {
         attempts += 1;
         if (attempts > 40) {
@@ -2865,7 +2916,7 @@ Request Data: ${JSON.stringify(requestData, null, 2)}`
         api.identify(identity);
       } catch (error) {
         this.logger.warn(
-          "Failed to forward identity to the support chat widget:",
+          "Failed to forward identity to the support widget:",
           error
         );
       }
@@ -2964,9 +3015,9 @@ function getLoggerLevel(config) {
   return effectiveDebugVerbose ? 3 /* DEBUG */ : effectiveDebug ? 2 /* INFO */ : 0 /* ERROR */;
 }
 
-// src/lib/tracking/types.ts
+// ../shared/src/lib/types/browserContext.ts
 import { z } from "zod";
-var browserContextSchema = z.object({
+var BrowserContextSchema = z.object({
   $href: z.string(),
   $locale: z.string(),
   $location: z.string(),
@@ -2992,9 +3043,9 @@ var browserContextSchema = z.object({
   $utmTerm: z.string().nullable()
 });
 export {
+  BrowserContextSchema,
   IntegrationManager,
   Saasco,
-  browserContextSchema,
   createFacebookPixelIntegration,
   createPinterestTagIntegration,
   createTikTokPixelIntegration,