@levo-so/core 0.1.29 → 0.1.32

package/dist/plugins/LevoAudience.d.ts

@@ -4,8 +4,10 @@ import { LevoPlugin } from "./LevoPlugin";
 export declare class LevoAudience extends LevoPlugin {
     #private;
     instance: AnalyticsInstance | null;
+    idle_listener: any;
     request<ResponseBody = unknown, RequestBody = unknown>(url: string, data: RequestBody): Promise<Awaited<ResponseBody>>;
     initiate(properties: ILevoAudience.Properties): Promise<any>;
+    identify(): Promise<void>;
     getReferrer(): {
         type?: undefined;
         referrer?: undefined;
@@ -17,7 +19,12 @@ export declare class LevoAudience extends LevoPlugin {
         data: Record<string, string>;
         raw: string;
     };
-    startActivityListener(): any;
+    startActivityListener(): null;
+    getActivityStatus(): {
+        status: "idle" | "active";
+        seconds: number;
+    } | null;
+    bounce(properties: ILevoAudience.Properties): Promise<void>;
     track(event: string, properties: ILevoAudience.Properties): Promise<any>;
     getCurrentTabId(): string;
     getTabCount(): number;

package/dist/plugins/LevoAudience.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LevoAudience.d.ts","sourceRoot":"","sources":["../../src/plugins/LevoAudience.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKvD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,qBAAa,YAAa,SAAQ,UAAU;;IAC1C,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAQ;IAmB1C,OAAO,CAAC,YAAY,GAAG,OAAO,EAAE,WAAW,GAAG,OAAO,EACnD,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW;IA8Bb,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,UAAU;IAkInD,WAAW;;;;;;;;;;;IAmEX,qBAAqB;IAqBf,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,UAAU;IAkC/D,eAAe;IAaf,WAAW;CAYZ"}
+{"version":3,"file":"LevoAudience.d.ts","sourceRoot":"","sources":["../../src/plugins/LevoAudience.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAMvD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,qBAAa,YAAa,SAAQ,UAAU;;IAC1C,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAQ;IAC1C,aAAa,EAAE,GAAG,CAAQ;IAoB1B,OAAO,CAAC,YAAY,GAAG,OAAO,EAAE,WAAW,GAAG,OAAO,EACnD,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW;IA8Bb,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,UAAU;IAsI7C,QAAQ;IAad,WAAW;;;;;;;;;;;IAmEX,qBAAqB;IAqBrB,iBAAiB,IAAI;QACnB,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,IAAI;IAcF,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,UAAU;IAc3C,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,UAAU;IAkC/D,eAAe;IAaf,WAAW;CAYZ"}

package/dist/plugins/LevoAudience.js

@@ -206,9 +206,39 @@ var getUserProperties = async () => {
   };
 };
 
+// src/utils/lock.ts
+var LocalStorageLock = class {
+  key;
+  constructor(lockKey) {
+    this.key = `lock_${lockKey}`;
+  }
+  acquireLock(expiryMs = 5e3) {
+    const now = Date.now();
+    const lockValue = localStorage.getItem(this.key);
+    if (lockValue) {
+      const timestamp = Number(lockValue);
+      if (now - timestamp < expiryMs) {
+        return false;
+      }
+    }
+    localStorage.setItem(this.key, now.toString());
+    return true;
+  }
+  releaseLock() {
+    localStorage.removeItem(this.key);
+  }
+  isLocked(expiryMs = 5e3) {
+    const lockValue = localStorage.getItem(this.key);
+    if (!lockValue) return false;
+    const timestamp = Number(lockValue);
+    return Date.now() - timestamp < expiryMs;
+  }
+};
+
 // src/plugins/LevoAudience.ts
 var LevoAudience = class extends LevoPlugin {
   instance = null;
+  idle_listener = null;
   #IDLE_THROTTLE = 1 * 1e3;
   // every 1 second we check for idleness
   #IDLE_TIMEOUT = 60 * 1e3;
@@ -317,35 +347,48 @@ var LevoAudience = class extends LevoPlugin {
           tab_id: this.getCurrentTabId(),
           tab_count: this.getTabCount()
         };
-        this.request(
-          `${this?.client?.insightsUrl}/v1/insights/event/welcome`,
-          welcomeInput
-        ).then((data) => {
-          this.#is_identified = true;
-          this.#session = data.content.data.session;
-          this.#device = data.content.data.device;
-          navigator.sendBeacon(
-            `${this?.client?.insightsUrl}/v1/insights/event/bulk?workspace=${this?.client?.workspace}`,
-            JSON.stringify(this.#batch)
-          );
-        }).catch((e) => getLevoError(e));
+        const identifyLock = new LocalStorageLock("lv_aud_identify");
+        if (identifyLock.acquireLock()) {
+          this.request(
+            `${this?.client?.insightsUrl}/v1/insights/event/welcome`,
+            welcomeInput
+          ).then((data) => {
+            this.#is_identified = true;
+            this.#session = data.content.data.session;
+            this.#device = data.content.data.device;
+            navigator.sendBeacon(
+              `${this?.client?.insightsUrl}/v1/insights/event/bulk?workspace=${this?.client?.workspace}`,
+              JSON.stringify(this.#batch)
+            );
+            identifyLock.releaseLock();
+          }).catch((e) => {
+            identifyLock.releaseLock();
+            return getLevoError(e);
+          });
+        }
       }
     };
     this.instance = Analytics({
       app: this.client.workspace || "",
       plugins: [plugin]
     });
-    const referrer = this.getReferrer();
-    await this.instance.identify("", {
-      ...await getUserProperties(),
-      referrer
-    });
+    await this.identify();
     this.startActivityListener();
     return this.instance.page({
       resource: "page",
       identifier: properties.id
     });
   }
+  async identify() {
+    if (!this.instance) {
+      return;
+    }
+    const referrer = this.getReferrer();
+    await this.instance.identify("", {
+      ...await getUserProperties(),
+      referrer
+    });
+  }
   getReferrer() {
     if (typeof document === "undefined") {
       return {};
@@ -368,8 +411,8 @@ var LevoAudience = class extends LevoPlugin {
     return { type, referrer, data, raw: document.referrer };
   }
   startActivityListener() {
-    if (typeof document !== "undefined") {
-      return onUserActivity({
+    if (typeof document !== "undefined" && !this.idle_listener) {
+      this.idle_listener = onUserActivity({
         timeout: this.#IDLE_TIMEOUT,
         throttle: this.#IDLE_THROTTLE,
         onIdle: (activeForSeconds) => {
@@ -386,6 +429,27 @@ var LevoAudience = class extends LevoPlugin {
     }
     return null;
   }
+  getActivityStatus() {
+    const status = this?.idle_listener?.getStatus();
+    if (!status) {
+      return null;
+    }
+    return {
+      status: status.isIdle ? "idle" : "active",
+      seconds: status.isIdle ? status.idle : status.active
+    };
+  }
+  async bounce(properties) {
+    const activity_status = this.getActivityStatus();
+    if (activity_status) {
+      if (activity_status?.status === "idle") {
+        properties.seconds_idle = activity_status.seconds;
+      } else {
+        properties.seconds_active = activity_status.seconds;
+      }
+    }
+    this.track("page.bounce", properties);
+  }
   async track(event, properties) {
     if (!this.client.workspace) {
       return;

package/dist/types/audience.d.ts

@@ -55,5 +55,11 @@ export declare namespace ILevoAudience {
         resource: string;
         identifier: string | undefined;
     };
+    type ActivityStatus = {
+        isIdle: boolean;
+        isDisabled: boolean;
+        active: number;
+        idle: number;
+    };
 }
 //# sourceMappingURL=audience.d.ts.map

package/dist/types/audience.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audience.d.ts","sourceRoot":"","sources":["../../src/types/audience.ts"],"names":[],"mappings":"AACA,yBAAiB,aAAa,CAAC;IAC7B,UAAiB,MAAM;QACrB,YAAY,EAAE,OAAO,CAAC;QACtB,SAAS,EAAE,OAAO,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SAC9B,CAAC;KACH;IAED,KAAY,cAAc,GAAG,MAAM,GAAG;QACpC,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,UAAiB,eAAe;QAC9B,EAAE,EAAE,MAAM,CAAC;KACZ;IAED,UAAiB,kBAAkB;QACjC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB;IAED,UAAiB,gBAAgB;QAC/B,OAAO,EAAE,MAAM,CAAC;KACjB;IAED,KAAY,UAAU,GAAG,OAAO,CAC9B,cAAc,GAAG,eAAe,GAAG,kBAAkB,GAAG,gBAAgB,CACzE,GACC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,GAAG,WAAW,GAAG,QAAQ,CAAC,CAAC,GACjE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEtB,KAAY,eAAe,GAAG;QAC5B,UAAU,EAAE,UAAU,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;QACpC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,CAAC;IAEF,KAAY,SAAS,GAAG;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,KAAY,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC;IAE9C,KAAY,eAAe,GAAG;QAC5B,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF,KAAY,YAAY,GAAG,SAAS,GAAG;QACrC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,UAAU,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;KAChC,CAAC;CACH"}
+{"version":3,"file":"audience.d.ts","sourceRoot":"","sources":["../../src/types/audience.ts"],"names":[],"mappings":"AACA,yBAAiB,aAAa,CAAC;IAC7B,UAAiB,MAAM;QACrB,YAAY,EAAE,OAAO,CAAC;QACtB,SAAS,EAAE,OAAO,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SAC9B,CAAC;KACH;IAED,KAAY,cAAc,GAAG,MAAM,GAAG;QACpC,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,UAAiB,eAAe;QAC9B,EAAE,EAAE,MAAM,CAAC;KACZ;IAED,UAAiB,kBAAkB;QACjC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB;IAED,UAAiB,gBAAgB;QAC/B,OAAO,EAAE,MAAM,CAAC;KACjB;IAED,KAAY,UAAU,GAAG,OAAO,CAC9B,cAAc,GAAG,eAAe,GAAG,kBAAkB,GAAG,gBAAgB,CACzE,GACC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,GAAG,WAAW,GAAG,QAAQ,CAAC,CAAC,GACjE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEtB,KAAY,eAAe,GAAG;QAC5B,UAAU,EAAE,UAAU,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;QACpC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,CAAC;IAEF,KAAY,SAAS,GAAG;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,KAAY,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC;IAE9C,KAAY,eAAe,GAAG;QAC5B,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF,KAAY,YAAY,GAAG,SAAS,GAAG;QACrC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,UAAU,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;KAChC,CAAC;IAEF,KAAY,cAAc,GAAG;QAC3B,MAAM,EAAE,OAAO,CAAC;QAChB,UAAU,EAAE,OAAO,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH"}

package/dist/utils/lock.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @example
+ *
+ * const lock = new LocalStorageLock("myResource");
+ * if (lock.acquireLock()) {
+ *   console.log("Lock acquired");
+ *   // Do some work...
+ *   lock.releaseLock();
+ * } else {
+ *   console.log("Lock is already held by another instance");
+ * }
+ *
+ */
+export declare class LocalStorageLock {
+    private key;
+    constructor(lockKey: string);
+    acquireLock(expiryMs?: number): boolean;
+    releaseLock(): void;
+    isLocked(expiryMs?: number): boolean;
+}
+//# sourceMappingURL=lock.d.ts.map

package/dist/utils/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/utils/lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,GAAG,CAAS;gBAER,OAAO,EAAE,MAAM;IAI3B,WAAW,CAAC,QAAQ,GAAE,MAAa,GAAG,OAAO;IAe7C,WAAW,IAAI,IAAI;IAInB,QAAQ,CAAC,QAAQ,GAAE,MAAa,GAAG,OAAO;CAO3C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@levo-so/core",
-  "version": "0.1.29",
+  "version": "0.1.32",
   "author": "Levo Engineering <devs@theinternetfolks.com>",
   "description": "Levo common utilities",
   "type": "module",