@carter-rmn/cpix-js 1.0.0-alpha.1

package/dist/cpix.js

@@ -0,0 +1,411 @@
+var y = Object.defineProperty;
+var v = (o, e, t) => e in o ? y(o, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : o[e] = t;
+var a = (o, e, t) => (v(o, typeof e != "symbol" ? e + "" : e, t), t);
+const E = "@carter-analytics/cpix", x = "0.0.0", S = "module", b = [
+  "dist"
+], P = "dist/cpix.umd.cjs", A = "dist/cpix.js", _ = "dist/cpix.d.ts", U = {
+  ".": {
+    import: "./dist/cpix.js",
+    require: "./dist/cpix.umd.cjs"
+  }
+}, T = {
+  dev: "vite",
+  build: "tsc && vite build",
+  preview: "vite preview"
+}, D = {
+  picocolors: "^1.0.0",
+  "rollup-plugin-visualizer": "^5.12.0",
+  typescript: "^5.2.2",
+  vite: "^5.2.0",
+  "vite-plugin-progress": "^0.0.7"
+}, C = {
+  "vite-plugin-dts": "^3.8.1"
+}, p = {
+  name: E,
+  private: !0,
+  version: x,
+  type: S,
+  files: b,
+  main: P,
+  module: A,
+  types: _,
+  exports: U,
+  scripts: T,
+  devDependencies: D,
+  dependencies: C
+}, c = {
+  DEBUG: !1,
+  TRACKER_FUNC_NAME: "cpix",
+  API_URL: "https://etg20oxcge.execute-api.ca-central-1.amazonaws.com/dev-lambda",
+  QUEUE_MAX_RETRIES: 3,
+  QUEUE_INITIAL_DELAY: 1e4,
+  version: p.version,
+  package: p.name
+}, l = {
+  SESSION: "cpix_session",
+  META_PARAMETERS: "cpix_meta_parameters",
+  ACCESS_TOKEN: "cpix_access_token",
+  UTM: "cpix_utm"
+}, I = [
+  "utm_source",
+  "utm_medium",
+  "utm_term",
+  "utm_content",
+  "utm_campaign",
+  "utm_source_platform",
+  "utm_creative_format",
+  "utm_marketing_tactic"
+], n = /* @__PURE__ */ function() {
+  const o = () => c.DEBUG;
+  return {
+    info: function(...e) {
+      console.log(...e);
+    },
+    debug: function(...e) {
+      o() && console.log(...e);
+    },
+    error: function(...e) {
+      console.error(...e);
+    }
+  };
+}();
+class k extends EventTarget {
+  constructor(t = {
+    maxRetries: 3,
+    initialDelay: 1e4,
+    consumerHandler: (i) => (n.debug("Consuming event:", i), Promise.resolve())
+  }) {
+    super();
+    a(this, "dataQueue");
+    a(this, "retryQueue");
+    a(this, "maxRetries");
+    a(this, "initialDelay");
+    a(this, "publishEvent");
+    a(this, "retryEvent");
+    a(this, "handler");
+    this.dataQueue = [], this.retryQueue = [], this.maxRetries = t.maxRetries, this.initialDelay = t.initialDelay, this.handler = t.consumerHandler, this.publishEvent = new Event("eventPublished"), this.retryEvent = new Event("retryMessage"), this.consume(), this.retry();
+  }
+  publish(t) {
+    n.debug("publishing event");
+    const i = {
+      data: t,
+      id: `${Date.now() + Math.random()}`,
+      retryCount: 0,
+      retryDelay: this.initialDelay
+    };
+    this.dataQueue.push(i), this.dispatchEvent(this.publishEvent);
+  }
+  consume() {
+    n.debug("Started Consumer Queue"), this.addEventListener("eventPublished", async () => {
+      for (; this.dataQueue.length > 0; ) {
+        const t = this.dataQueue.shift(), { data: i = {} } = t;
+        try {
+          await this.handler(i), this.acknowledge(t == null ? void 0 : t.id);
+        } catch (s) {
+          n.error("Failed to publish event:", s), this.scheduleRetry(t);
+        }
+      }
+    });
+  }
+  scheduleRetry(t) {
+    if (t.retryCount >= this.maxRetries) {
+      n.error("Max retries reached for message:", t);
+      return;
+    }
+    setTimeout(() => {
+      this.retryQueue.push({
+        ...t,
+        retryCount: t.retryCount + 1,
+        retryDelay: t.retryDelay * 2
+      }), this.dispatchEvent(this.retryEvent);
+    }, t.retryDelay);
+  }
+  acknowledge(t) {
+    this.dataQueue = this.dataQueue.filter((i) => i.id !== t);
+  }
+  retry() {
+    n.debug("Started Retry Queue"), this.addEventListener("retryMessage", async () => {
+      for (; this.retryQueue.length > 0; ) {
+        const t = this.retryQueue.shift(), { data: i = {} } = t;
+        try {
+          await this.handler(i), this.acknowledge(t == null ? void 0 : t.id);
+        } catch (s) {
+          n.error("Failed to publish event:", s), this.scheduleRetry(t);
+        }
+      }
+    });
+  }
+}
+class m {
+  static getBrowserInfo() {
+    var s, u, h, f, g;
+    const e = navigator.userAgent || "";
+    let t, i;
+    return /chrome/i.test(e) ? (t = "Chrome", i = (s = e.match(/chrome\/(\d+)/i)) == null ? void 0 : s[1]) : /firefox/i.test(e) ? (t = "Firefox", i = (u = e.match(/firefox\/(\d+)/i)) == null ? void 0 : u[1]) : /safari/i.test(e) ? (t = "Safari", i = (h = e.match(/version\/(\d+)/i)) == null ? void 0 : h[1]) : /edge/i.test(e) ? (t = "Edge", i = (f = e.match(/edge\/(\d+)/i)) == null ? void 0 : f[1]) : /trident/i.test(e) ? (t = "Internet Explorer", i = (g = e.match(/rv:(\d+)/i)) == null ? void 0 : g[1]) : (t = "Unknown", i = "Unknown"), `${t} ${i}`;
+  }
+  static getDeviceCategory() {
+    const e = navigator.userAgent;
+    return /mobile/i.test(e) ? "Mobile" : /tablet/i.test(e) ? "Tablet" : "Desktop";
+  }
+  static getDevicePlatform() {
+    const e = navigator.userAgent;
+    return /android/i.test(e) ? "Android" : /iphone|ipad|ipod/i.test(e) ? "iOS" : /windows phone/i.test(e) ? "Windows Phone" : /mac|Macintosh/i.test(e) ? "Mac" : /windows|Microsoft/i.test(e) ? "Windows" : /linux/i.test(e) ? "Linux" : "Unknown";
+  }
+  static getDeviceManufacturer() {
+    const e = navigator.userAgent;
+    let t;
+    return /iphone|ipad|ipod|mac|Macintosh/i.test(e) ? t = "Apple" : /samsung/i.test(e) ? t = "Samsung" : /google/i.test(e) ? t = "Google" : /huawei/i.test(e) ? t = "Huawei" : /xiaomi/i.test(e) ? t = "Xiaomi" : /oneplus/i.test(e) ? t = "OnePlus" : /dell/i.test(e) ? t = "Dell" : /lenovo/i.test(e) ? t = "Lenovo" : /acer/i.test(e) ? t = "Acer" : /asus/i.test(e) ? t = "Asus" : /toshiba/i.test(e) ? t = "Toshiba" : t = "Unknown", t;
+  }
+  static async getDeviceNetworkParameters() {
+    try {
+      const e = await fetch(`${c.API_URL}/api/geolocation`), { data: t } = await e.json();
+      return {
+        city: t.city || "Unknown",
+        region: t.region || "Unknown",
+        country: t.country || "Unknown",
+        timezone: t.timezone || "Unknown",
+        loc: t.loc || "Unknown",
+        ip_address: t.ip_address || "Unknown"
+      };
+    } catch (e) {
+      return n.error("Error retrieving device network parameters:", e), {
+        city: "Unknown",
+        region: "Unknown",
+        country: "Unknown",
+        timezone: "Unknown",
+        loc: "Unknown",
+        ip_address: "Unknown"
+      };
+    }
+  }
+  static async aquireAccessToken(e) {
+    try {
+      return (await (await fetch(`${c.API_URL}/api/authenticate`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          accountId: e,
+          metadata: {
+            sdk: c.package,
+            version: c.version,
+            hostname: window.location.hostname
+          }
+        })
+      })).json()).accessToken;
+    } catch (t) {
+      throw n.error("Error acquiring access token:", t), new Error("[CPIX] Authentication error");
+    }
+  }
+}
+class d {
+  static isPresent(e) {
+    return typeof e < "u" && e !== null && e !== "";
+  }
+  static now() {
+    return 1 * (/* @__PURE__ */ new Date()).getTime();
+  }
+  static guid() {
+    return p.version + "-xxxxxxxx-".replace(/[x]/g, function(e) {
+      const t = Math.random() * 36 | 0;
+      return (e == "x" ? t : t & 3 | 8).toString(36);
+    }) + (1 * (/* @__PURE__ */ new Date()).getTime()).toString(36);
+  }
+  // reduces all optional data down to a string
+  static optionalData(e) {
+    return d.isPresent(e) === !1 ? "" : typeof e == "object" ? d.optionalData(JSON.stringify(e)) : typeof e == "function" ? d.optionalData(e()) : String(e);
+  }
+  static sleep(e) {
+    return new Promise((t) => setTimeout(t, e));
+  }
+}
+class w {
+  static getParameterByName(e, t) {
+    t || (t = window.location.href), e = e.replace(/[[\]]/g, "\\$&");
+    const s = new RegExp("[?&]" + e + "(=([^&#]*)|&|#|$)", "i").exec(t);
+    return s ? s[2] ? decodeURIComponent(s[2].replace(/\+/g, " ")) : "" : null;
+  }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static externalHost(e) {
+    var t;
+    return e.hostname != location.hostname && ((t = e == null ? void 0 : e.protocol) == null ? void 0 : t.indexOf("http")) === 0;
+  }
+}
+class r {
+  static prefix() {
+    return `__${c.TRACKER_FUNC_NAME}__`;
+  }
+  static get(e) {
+    const t = `${r.prefix()}${e}`, i = document.cookie.split("; ").find((s) => s.startsWith(`${t}=`));
+    return i ? i.split("=")[1] : void 0;
+  }
+  static set(e, t, i) {
+    const s = `${r.prefix()}${e}`, u = /* @__PURE__ */ new Date();
+    u.setTime(u.getTime() + i * 60 * 1e3), document.cookie = `${s}=${t}; expires=${u.toUTCString()}; path=/`;
+  }
+  static delete(e) {
+    const t = `${r.prefix()}${e}`;
+    document.cookie = `${t}=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/`;
+  }
+  static clear() {
+    document.cookie.split("; ").filter((e) => e.startsWith(r.prefix())).forEach((e) => {
+      const t = e.split("=")[0];
+      document.cookie = `${t}=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/`;
+    });
+  }
+  static exists(e) {
+    return !!r.get(e);
+  }
+  static setUtms() {
+    const e = I;
+    let t = !1;
+    for (let i = 0; i < e.length; i++) {
+      const s = e[i];
+      if (d.isPresent(w.getParameterByName(s, window.location.href))) {
+        t = !0;
+        break;
+      }
+    }
+    if (t) {
+      let i = "";
+      const s = {};
+      for (let u = 0; u < e.length; u++) {
+        const h = e[u];
+        i = w.getParameterByName(h, window.location.href), d.isPresent(i) && (s[h] = i), s[h] = i;
+      }
+      r.set(l.UTM, JSON.stringify(s), 30);
+    }
+  }
+  static getUtms() {
+    const e = r.get(l.UTM);
+    return d.isPresent(e) ? JSON.parse(e) : {};
+  }
+  static createSession() {
+    r.exists(l.SESSION) || r.set(l.SESSION, d.guid(), 30 * 24 * 60), r.setUtms();
+  }
+}
+class N {
+  constructor() {
+    a(this, "instances", []);
+    a(this, "initialized", !1);
+    a(this, "accessToken", "");
+    a(this, "metaParameters", {});
+    a(this, "queue");
+    if (!window)
+      throw new Error(
+        "[CPIX] CarterAnalytics SDK can only be used in a browser environment"
+      );
+    this.queue = new k({
+      maxRetries: c.QUEUE_MAX_RETRIES,
+      initialDelay: c.QUEUE_INITIAL_DELAY,
+      consumerHandler: this.publishEventToServer
+    });
+  }
+  /**
+   * Initializes the CarterAnalytics SDK with the provided configuration options.
+   * @param options - The configuration options for initializing the SDK.
+   */
+  async initialize(e) {
+    if (!e || e.length === 0)
+      throw new Error(
+        "[CPIX] At least one instance configuration is required for initialization"
+      );
+    if (r.exists(l.SESSION) || r.createSession(), r.exists(l.META_PARAMETERS) || await this.generateMetaParameters().then((t) => {
+      r.set("metaParameters", JSON.stringify(t), 60 * 24);
+    }), this.metaParameters = JSON.parse(r.get("metaParameters")), this.initialized)
+      throw new Error(
+        "[CPIX] CarterAnalytics SDK has already been initialized"
+      );
+    if (!this.metaParameters)
+      throw new Error("[CPIX] Meta parameters have not been generated");
+    this.instances = e, r.exists(l.ACCESS_TOKEN) || (this.accessToken = await m.aquireAccessToken(
+      this.instances[0].client_id
+    ), r.set(l.ACCESS_TOKEN, this.accessToken, 60 * 4)), this.initialized = !0, n.info("CPIX Initialized"), n.debug(
+      "Carter Analytics SDK initialized with options:",
+      this.instances
+    ), c.DEBUG = this.instances[0].options.debug === !0, c.API_URL = this.instances[0].options.tracker_server_url, this.metaParameters.client_id = this.instances[0].client_id, r.set("metaParameters", JSON.stringify(this.metaParameters), 60 * 24), this.publish({
+      event: "init",
+      ...this.metaParameters
+    }), this.publish({
+      event: "page_view",
+      event_properties: {
+        title: document.title,
+        page: window.location.pathname,
+        url: window.location.href
+      },
+      ...this.metaParameters
+    });
+  }
+  /**
+   * Publishes an event to the analytics queue.
+   * @param event - The event to be published.
+   */
+  publish(e) {
+    if (!this.initialized)
+      throw new Error(
+        "[CPIX] CarterAnalytics SDK has not been initialized. Please initialize before publishing events."
+      );
+    const t = {
+      ...e,
+      ...this.metaParameters
+    };
+    n.debug("Publishing event:", t), this.queue.publish(t);
+  }
+  /**
+   * Generates meta parameters that is attached to every event before publishing.
+   */
+  async generateMetaParameters() {
+    if (!window)
+      throw new Error(
+        "[CPIX] Meta parameters can only be generated in a browser environment"
+      );
+    const e = await m.getDeviceNetworkParameters();
+    return {
+      session: r.get(l.SESSION),
+      location: {
+        city: e.city,
+        region: e.region,
+        loc: e.loc,
+        timezone: e.timezone,
+        country: e.country
+      },
+      device: {
+        category: m.getDeviceCategory(),
+        brand: m.getDeviceManufacturer(),
+        ip_address: e.ip_address,
+        platform: m.getDevicePlatform()
+      },
+      referrer: document.referrer,
+      utm_params: r.getUtms()
+    };
+  }
+  /**
+   * Publishes an event to the analytics server.
+   * @param message - The event to be published.
+   */
+  async publishEventToServer(e) {
+    try {
+      e.timestamp = Date.now();
+      const t = await fetch(`${c.API_URL}/api/event`, {
+        method: "POST",
+        body: JSON.stringify({ event_data: e }),
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${r.get(l.ACCESS_TOKEN)}`
+        }
+      });
+      if (!t.ok)
+        throw new Error("[CPIX] Failed to publish event");
+      const i = await t.json();
+      n.debug("Event published:", i);
+    } catch (t) {
+      throw n.error("Failed to publish event:", t), new Error("[CPIX] Failed to publish event");
+    }
+  }
+}
+const R = new N();
+typeof window < "u" && (window.cpix = R);
+export {
+  R as CarterAnalytics
+};

package/dist/cpix.umd.cjs

@@ -0,0 +1 @@
+(function(o,c){typeof exports=="object"&&typeof module<"u"?c(exports):typeof define=="function"&&define.amd?define(["exports"],c):(o=typeof globalThis<"u"?globalThis:o||self,c(o.tracker={}))})(this,function(o){"use strict";var A=Object.defineProperty;var T=(o,c,p)=>c in o?A(o,c,{enumerable:!0,configurable:!0,writable:!0,value:p}):o[c]=p;var a=(o,c,p)=>(T(o,typeof c!="symbol"?c+"":c,p),p);const w={name:"@carter-analytics/cpix",private:!0,version:"0.0.0",type:"module",files:["dist"],main:"dist/cpix.umd.cjs",module:"dist/cpix.js",types:"dist/cpix.d.ts",exports:{".":{import:"./dist/cpix.js",require:"./dist/cpix.umd.cjs"}},scripts:{dev:"vite",build:"tsc && vite build",preview:"vite preview"},devDependencies:{picocolors:"^1.0.0","rollup-plugin-visualizer":"^5.12.0",typescript:"^5.2.2",vite:"^5.2.0","vite-plugin-progress":"^0.0.7"},dependencies:{"vite-plugin-dts":"^3.8.1"}},u={DEBUG:!1,TRACKER_FUNC_NAME:"cpix",API_URL:"https://etg20oxcge.execute-api.ca-central-1.amazonaws.com/dev-lambda",QUEUE_MAX_RETRIES:3,QUEUE_INITIAL_DELAY:1e4,version:w.version,package:w.name},l={SESSION:"cpix_session",META_PARAMETERS:"cpix_meta_parameters",ACCESS_TOKEN:"cpix_access_token",UTM:"cpix_utm"},S=["utm_source","utm_medium","utm_term","utm_content","utm_campaign","utm_source_platform","utm_creative_format","utm_marketing_tactic"],s=function(){const g=()=>u.DEBUG;return{info:function(...e){console.log(...e)},debug:function(...e){g()&&console.log(...e)},error:function(...e){console.error(...e)}}}();class b extends EventTarget{constructor(t={maxRetries:3,initialDelay:1e4,consumerHandler:i=>(s.debug("Consuming event:",i),Promise.resolve())}){super();a(this,"dataQueue");a(this,"retryQueue");a(this,"maxRetries");a(this,"initialDelay");a(this,"publishEvent");a(this,"retryEvent");a(this,"handler");this.dataQueue=[],this.retryQueue=[],this.maxRetries=t.maxRetries,this.initialDelay=t.initialDelay,this.handler=t.consumerHandler,this.publishEvent=new Event("eventPublished"),this.retryEvent=new Event("retryMessage"),this.consume(),this.retry()}publish(t){s.debug("publishing event");const i={data:t,id:`${Date.now()+Math.random()}`,retryCount:0,retryDelay:this.initialDelay};this.dataQueue.push(i),this.dispatchEvent(this.publishEvent)}consume(){s.debug("Started Consumer Queue"),this.addEventListener("eventPublished",async()=>{for(;this.dataQueue.length>0;){const t=this.dataQueue.shift(),{data:i={}}=t;try{await this.handler(i),this.acknowledge(t==null?void 0:t.id)}catch(r){s.error("Failed to publish event:",r),this.scheduleRetry(t)}}})}scheduleRetry(t){if(t.retryCount>=this.maxRetries){s.error("Max retries reached for message:",t);return}setTimeout(()=>{this.retryQueue.push({...t,retryCount:t.retryCount+1,retryDelay:t.retryDelay*2}),this.dispatchEvent(this.retryEvent)},t.retryDelay)}acknowledge(t){this.dataQueue=this.dataQueue.filter(i=>i.id!==t)}retry(){s.debug("Started Retry Queue"),this.addEventListener("retryMessage",async()=>{for(;this.retryQueue.length>0;){const t=this.retryQueue.shift(),{data:i={}}=t;try{await this.handler(i),this.acknowledge(t==null?void 0:t.id)}catch(r){s.error("Failed to publish event:",r),this.scheduleRetry(t)}}})}}class f{static getBrowserInfo(){var r,d,m,E,x;const e=navigator.userAgent||"";let t,i;return/chrome/i.test(e)?(t="Chrome",i=(r=e.match(/chrome\/(\d+)/i))==null?void 0:r[1]):/firefox/i.test(e)?(t="Firefox",i=(d=e.match(/firefox\/(\d+)/i))==null?void 0:d[1]):/safari/i.test(e)?(t="Safari",i=(m=e.match(/version\/(\d+)/i))==null?void 0:m[1]):/edge/i.test(e)?(t="Edge",i=(E=e.match(/edge\/(\d+)/i))==null?void 0:E[1]):/trident/i.test(e)?(t="Internet Explorer",i=(x=e.match(/rv:(\d+)/i))==null?void 0:x[1]):(t="Unknown",i="Unknown"),`${t} ${i}`}static getDeviceCategory(){const e=navigator.userAgent;return/mobile/i.test(e)?"Mobile":/tablet/i.test(e)?"Tablet":"Desktop"}static getDevicePlatform(){const e=navigator.userAgent;return/android/i.test(e)?"Android":/iphone|ipad|ipod/i.test(e)?"iOS":/windows phone/i.test(e)?"Windows Phone":/mac|Macintosh/i.test(e)?"Mac":/windows|Microsoft/i.test(e)?"Windows":/linux/i.test(e)?"Linux":"Unknown"}static getDeviceManufacturer(){const e=navigator.userAgent;let t;return/iphone|ipad|ipod|mac|Macintosh/i.test(e)?t="Apple":/samsung/i.test(e)?t="Samsung":/google/i.test(e)?t="Google":/huawei/i.test(e)?t="Huawei":/xiaomi/i.test(e)?t="Xiaomi":/oneplus/i.test(e)?t="OnePlus":/dell/i.test(e)?t="Dell":/lenovo/i.test(e)?t="Lenovo":/acer/i.test(e)?t="Acer":/asus/i.test(e)?t="Asus":/toshiba/i.test(e)?t="Toshiba":t="Unknown",t}static async getDeviceNetworkParameters(){try{const e=await fetch(`${u.API_URL}/api/geolocation`),{data:t}=await e.json();return{city:t.city||"Unknown",region:t.region||"Unknown",country:t.country||"Unknown",timezone:t.timezone||"Unknown",loc:t.loc||"Unknown",ip_address:t.ip_address||"Unknown"}}catch(e){return s.error("Error retrieving device network parameters:",e),{city:"Unknown",region:"Unknown",country:"Unknown",timezone:"Unknown",loc:"Unknown",ip_address:"Unknown"}}}static async aquireAccessToken(e){try{return(await(await fetch(`${u.API_URL}/api/authenticate`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({accountId:e,metadata:{sdk:u.package,version:u.version,hostname:window.location.hostname}})})).json()).accessToken}catch(t){throw s.error("Error acquiring access token:",t),new Error("[CPIX] Authentication error")}}}class h{static isPresent(e){return typeof e<"u"&&e!==null&&e!==""}static now(){return 1*new Date().getTime()}static guid(){return w.version+"-xxxxxxxx-".replace(/[x]/g,function(e){const t=Math.random()*36|0;return(e=="x"?t:t&3|8).toString(36)})+(1*new Date().getTime()).toString(36)}static optionalData(e){return h.isPresent(e)===!1?"":typeof e=="object"?h.optionalData(JSON.stringify(e)):typeof e=="function"?h.optionalData(e()):String(e)}static sleep(e){return new Promise(t=>setTimeout(t,e))}}class y{static getParameterByName(e,t){t||(t=window.location.href),e=e.replace(/[[\]]/g,"\\$&");const r=new RegExp("[?&]"+e+"(=([^&#]*)|&|#|$)","i").exec(t);return r?r[2]?decodeURIComponent(r[2].replace(/\+/g," ")):"":null}static externalHost(e){var t;return e.hostname!=location.hostname&&((t=e==null?void 0:e.protocol)==null?void 0:t.indexOf("http"))===0}}class n{static prefix(){return`__${u.TRACKER_FUNC_NAME}__`}static get(e){const t=`${n.prefix()}${e}`,i=document.cookie.split("; ").find(r=>r.startsWith(`${t}=`));return i?i.split("=")[1]:void 0}static set(e,t,i){const r=`${n.prefix()}${e}`,d=new Date;d.setTime(d.getTime()+i*60*1e3),document.cookie=`${r}=${t}; expires=${d.toUTCString()}; path=/`}static delete(e){const t=`${n.prefix()}${e}`;document.cookie=`${t}=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/`}static clear(){document.cookie.split("; ").filter(e=>e.startsWith(n.prefix())).forEach(e=>{const t=e.split("=")[0];document.cookie=`${t}=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/`})}static exists(e){return!!n.get(e)}static setUtms(){const e=S;let t=!1;for(let i=0;i<e.length;i++){const r=e[i];if(h.isPresent(y.getParameterByName(r,window.location.href))){t=!0;break}}if(t){let i="";const r={};for(let d=0;d<e.length;d++){const m=e[d];i=y.getParameterByName(m,window.location.href),h.isPresent(i)&&(r[m]=i),r[m]=i}n.set(l.UTM,JSON.stringify(r),30)}}static getUtms(){const e=n.get(l.UTM);return h.isPresent(e)?JSON.parse(e):{}}static createSession(){n.exists(l.SESSION)||n.set(l.SESSION,h.guid(),30*24*60),n.setUtms()}}class P{constructor(){a(this,"instances",[]);a(this,"initialized",!1);a(this,"accessToken","");a(this,"metaParameters",{});a(this,"queue");if(!window)throw new Error("[CPIX] CarterAnalytics SDK can only be used in a browser environment");this.queue=new b({maxRetries:u.QUEUE_MAX_RETRIES,initialDelay:u.QUEUE_INITIAL_DELAY,consumerHandler:this.publishEventToServer})}async initialize(e){if(!e||e.length===0)throw new Error("[CPIX] At least one instance configuration is required for initialization");if(n.exists(l.SESSION)||n.createSession(),n.exists(l.META_PARAMETERS)||await this.generateMetaParameters().then(t=>{n.set("metaParameters",JSON.stringify(t),60*24)}),this.metaParameters=JSON.parse(n.get("metaParameters")),this.initialized)throw new Error("[CPIX] CarterAnalytics SDK has already been initialized");if(!this.metaParameters)throw new Error("[CPIX] Meta parameters have not been generated");this.instances=e,n.exists(l.ACCESS_TOKEN)||(this.accessToken=await f.aquireAccessToken(this.instances[0].client_id),n.set(l.ACCESS_TOKEN,this.accessToken,60*4)),this.initialized=!0,s.info("CPIX Initialized"),s.debug("Carter Analytics SDK initialized with options:",this.instances),u.DEBUG=this.instances[0].options.debug===!0,u.API_URL=this.instances[0].options.tracker_server_url,this.metaParameters.client_id=this.instances[0].client_id,n.set("metaParameters",JSON.stringify(this.metaParameters),60*24),this.publish({event:"init",...this.metaParameters}),this.publish({event:"page_view",event_properties:{title:document.title,page:window.location.pathname,url:window.location.href},...this.metaParameters})}publish(e){if(!this.initialized)throw new Error("[CPIX] CarterAnalytics SDK has not been initialized. Please initialize before publishing events.");const t={...e,...this.metaParameters};s.debug("Publishing event:",t),this.queue.publish(t)}async generateMetaParameters(){if(!window)throw new Error("[CPIX] Meta parameters can only be generated in a browser environment");const e=await f.getDeviceNetworkParameters();return{session:n.get(l.SESSION),location:{city:e.city,region:e.region,loc:e.loc,timezone:e.timezone,country:e.country},device:{category:f.getDeviceCategory(),brand:f.getDeviceManufacturer(),ip_address:e.ip_address,platform:f.getDevicePlatform()},referrer:document.referrer,utm_params:n.getUtms()}}async publishEventToServer(e){try{e.timestamp=Date.now();const t=await fetch(`${u.API_URL}/api/event`,{method:"POST",body:JSON.stringify({event_data:e}),headers:{"Content-Type":"application/json",Authorization:`Bearer ${n.get(l.ACCESS_TOKEN)}`}});if(!t.ok)throw new Error("[CPIX] Failed to publish event");const i=await t.json();s.debug("Event published:",i)}catch(t){throw s.error("Failed to publish event:",t),new Error("[CPIX] Failed to publish event")}}}const v=new P;typeof window<"u"&&(window.cpix=v),o.CarterAnalytics=v,Object.defineProperty(o,Symbol.toStringTag,{value:"Module"})});

package/dist/logo.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

package/dist/main.d.ts

@@ -0,0 +1 @@
+export { default as CarterAnalytics } from './modules/carter-analytics';

package/dist/modules/carter-analytics.d.ts

@@ -0,0 +1,34 @@
+import { Event, Init } from '../types/common.types';
+
+/**
+ * The `CarterAnalytics` class is responsible for initializing and publishing events to the analytics server.
+ */
+declare class CarterAnalytics {
+    private instances;
+    private initialized;
+    private accessToken;
+    private metaParameters;
+    private queue;
+    constructor();
+    /**
+     * Initializes the CarterAnalytics SDK with the provided configuration options.
+     * @param options - The configuration options for initializing the SDK.
+     */
+    initialize(options: Init[]): Promise<void>;
+    /**
+     * Publishes an event to the analytics queue.
+     * @param event - The event to be published.
+     */
+    publish(event: Event): void;
+    /**
+     * Generates meta parameters that is attached to every event before publishing.
+     */
+    private generateMetaParameters;
+    /**
+     * Publishes an event to the analytics server.
+     * @param message - The event to be published.
+     */
+    private publishEventToServer;
+}
+declare const analytics: CarterAnalytics;
+export default analytics;

package/dist/types/checkout.types.d.ts

@@ -0,0 +1,152 @@
+import * as commonType from './common.types';
+/**
+ * Represents the properties required to start a checkout.
+ */
+export interface CheckoutStartProperties {
+    /**
+     * The token associated with the checkout.
+     */
+    token: string;
+    /**
+     * The total amount of the checkout.
+     */
+    amount: number;
+    /**
+     * The tax amount of the checkout.
+     */
+    tax: number;
+    /**
+     * The currency of the checkout.
+     */
+    currency: string;
+    /**
+     * The items in the checkout.
+     */
+    items: Array<commonType.CartProperties>;
+    /**
+     * The billing addresses associated with the checkout.
+     */
+    billing_address: Array<commonType.AddressProperties>;
+    /**
+     * The shipping addresses associated with the checkout.
+     */
+    shipping_address: Array<commonType.AddressProperties>;
+    /**
+     * The discounts applied to the checkout.
+     */
+    discount: Array<commonType.DiscountProperties>;
+    /**
+     * The delivery method of the checkout.
+     */
+    delivery_method: string;
+    /**
+     * The payment method of the checkout.
+     */
+    payment_method: string;
+}
+/**
+ * Represents the properties of a completed checkout.
+ */
+export interface CheckoutCompletedProperties {
+    /**
+     * The token associated with the checkout.
+     */
+    token: string;
+    /**
+     * The order ID of the completed checkout.
+     */
+    order_id: string;
+    /**
+     * The total amount of the completed checkout.
+     */
+    amount: number;
+    /**
+     * The tax amount of the completed checkout.
+     */
+    tax: number;
+    /**
+     * The currency of the completed checkout.
+     */
+    currency: string;
+    /**
+     * The items in the completed checkout.
+     */
+    items: Array<commonType.CartProperties>;
+    /**
+     * The billing addresses associated with the completed checkout.
+     */
+    billing_address: Array<commonType.AddressProperties>;
+    /**
+     * The shipping addresses associated with the completed checkout.
+     */
+    shipping_address: Array<commonType.AddressProperties>;
+    /**
+     * The discounts applied to the completed checkout.
+     */
+    discount: Array<commonType.DiscountProperties>;
+    /**
+     * The delivery method of the completed checkout.
+     */
+    delivery_method: string;
+    /**
+     * The payment method of the completed checkout.
+     */
+    payment_method: string;
+    /**
+     * The transaction ID of the completed checkout.
+     */
+    transaction_id: string;
+}
+/**
+ * Represents the properties of a cancelled checkout.
+ */
+export interface CheckoutCancelledProperties {
+    /**
+     * The token associated with the checkout.
+     */
+    token: string;
+    /**
+     * The total amount of the cancelled checkout.
+     */
+    amount: number;
+    /**
+     * The tax amount of the cancelled checkout.
+     */
+    tax: number;
+    /**
+     * The currency of the cancelled checkout.
+     */
+    currency: string;
+    /**
+     * The items in the cancelled checkout.
+     */
+    items: Array<commonType.CartProperties>;
+    /**
+     * The billing addresses associated with the cancelled checkout.
+     */
+    billing_address: Array<commonType.AddressProperties>;
+    /**
+     * The shipping addresses associated with the cancelled checkout.
+     */
+    shipping_address: Array<commonType.AddressProperties>;
+    /**
+     * The discounts applied to the cancelled checkout.
+     */
+    discount: Array<commonType.DiscountProperties>;
+    /**
+     * The delivery method of the cancelled checkout.
+     */
+    delivery_method: string;
+    /**
+     * The payment method of the cancelled checkout.
+     */
+    payment_method: string;
+    /**
+     * The transaction ID of the cancelled checkout.
+     */
+    transaction_id: string;
+    /**
+     * The reason for the cancellation of the checkout.
+     */
+    reason: string;
+}