signal-bridge 1.0.14 → 1.0.16

package/README.md

@@ -46,7 +46,7 @@ const bridge = createBridge("my-app-id", {
   allowedHostOrigins: ["https://host.com"],
   cryptoKey: "SECRET_KEY", // optional
   debug: true
-});
+})
 ```
 
 > Hanya akan dibuat **1x (singleton)**. Jika dipanggil ulang, akan reuse instance lama.
@@ -96,6 +96,10 @@ Jika ingin akses dari mana saja:
 import { signalBridge } from "signal-bridge";
 
 signalBridge().emit("ping", {});
+
+
+Auto Encrypted Data:
+signalBridge().emitEncrypted("event-name", {id:123});
 ```
 
 ⚠️ Pastikan sudah `createBridge().init()` sebelumnya.

package/dist/index.d.mts

@@ -21,27 +21,165 @@ interface BridgeOptions {
 declare function createBridge(appId: string, options: BridgeOptions): {
     init(): void;
     listen(handler: Listener): void;
-    emit(type: string, payload: any, txn?: string): string;
+    /**
+     * Kirim pesan ke host tanpa enkripsi otomatis.
+     *
+     * Gunakan ini jika host dan remote sudah punya `cryptoKey` yang sama (static key),
+     * atau jika payload memang tidak perlu dienkripsi.
+     * Untuk enkripsi otomatis per-pesan, gunakan `emitEncrypted`.
+     *
+     * @param event   Nama event, contoh: `"ping"`, `"user:logout"`
+     * @param payload Data yang ingin dikirim
+     * @param txn     (opsional) Transaction ID custom. Auto-generate UUID jika tidak diisi.
+     * @returns `txn` yang digunakan — berguna untuk tracking response dari host.
+     *
+     * @example
+     * const txn = signalBridge.emit("ping", { ts: Date.now() });
+     */
+    emit(event: string, payload: any, txn?: string): string;
+    /**
+     * Kirim pesan ke host dengan enkripsi otomatis.
+     *
+     * Setiap pemanggilan menghasilkan key acak baru (CSPRNG),
+     * payload di-encrypt dengan key tersebut
+     *
+     * @param event    Nama event, contoh: `"user:login"`, `"cart:update"`
+     * @param payload Data apapun (object, string, dll) yang ingin dikirim
+     * @returns `{ txn, key }` — keduanya bernilai sama (ephemeral key).
+     *   Simpan jika perlu referensi untuk matching response dari host.
+     *
+     * @example
+     * const { txn } = bridge.emitEncrypted("order:submit", { id: 123 });
+     *
+     */
+    emitEncrypted(event: string, payload: any): {
+        txn: string;
+        key: string;
+    };
+    track: {
+        open_file: (payload?: any) => {
+            txn: string;
+            key: string;
+        };
+        open_document: (payload?: any) => {
+            txn: string;
+            key: string;
+        };
+        view_document: (payload?: any) => {
+            txn: string;
+            key: string;
+        };
+    };
     destroy(): void;
 };
 declare function resetBridge(): void;
 declare function signalBridge(): {
     init(): void;
     listen(handler: Listener): void;
-    emit(type: string, payload: any, txn?: string): string;
-    destroy(): void;
-};
-declare function setupBridge(appId: string, options: BridgeOptions): {
-    init(): void;
-    listen(handler: Listener): void;
-    emit(type: string, payload: any, txn?: string): string;
+    /**
+     * Kirim pesan ke host tanpa enkripsi otomatis.
+     *
+     * Gunakan ini jika host dan remote sudah punya `cryptoKey` yang sama (static key),
+     * atau jika payload memang tidak perlu dienkripsi.
+     * Untuk enkripsi otomatis per-pesan, gunakan `emitEncrypted`.
+     *
+     * @param event   Nama event, contoh: `"ping"`, `"user:logout"`
+     * @param payload Data yang ingin dikirim
+     * @param txn     (opsional) Transaction ID custom. Auto-generate UUID jika tidak diisi.
+     * @returns `txn` yang digunakan — berguna untuk tracking response dari host.
+     *
+     * @example
+     * const txn = signalBridge.emit("ping", { ts: Date.now() });
+     */
+    emit(event: string, payload: any, txn?: string): string;
+    /**
+     * Kirim pesan ke host dengan enkripsi otomatis.
+     *
+     * Setiap pemanggilan menghasilkan key acak baru (CSPRNG),
+     * payload di-encrypt dengan key tersebut
+     *
+     * @param event    Nama event, contoh: `"user:login"`, `"cart:update"`
+     * @param payload Data apapun (object, string, dll) yang ingin dikirim
+     * @returns `{ txn, key }` — keduanya bernilai sama (ephemeral key).
+     *   Simpan jika perlu referensi untuk matching response dari host.
+     *
+     * @example
+     * const { txn } = bridge.emitEncrypted("order:submit", { id: 123 });
+     *
+     */
+    emitEncrypted(event: string, payload: any): {
+        txn: string;
+        key: string;
+    };
+    track: {
+        open_file: (payload?: any) => {
+            txn: string;
+            key: string;
+        };
+        open_document: (payload?: any) => {
+            txn: string;
+            key: string;
+        };
+        view_document: (payload?: any) => {
+            txn: string;
+            key: string;
+        };
+    };
     destroy(): void;
 };
 declare function initBridge(appId: string, options: BridgeOptions): {
     init(): void;
     listen(handler: Listener): void;
-    emit(type: string, payload: any, txn?: string): string;
+    /**
+     * Kirim pesan ke host tanpa enkripsi otomatis.
+     *
+     * Gunakan ini jika host dan remote sudah punya `cryptoKey` yang sama (static key),
+     * atau jika payload memang tidak perlu dienkripsi.
+     * Untuk enkripsi otomatis per-pesan, gunakan `emitEncrypted`.
+     *
+     * @param event   Nama event, contoh: `"ping"`, `"user:logout"`
+     * @param payload Data yang ingin dikirim
+     * @param txn     (opsional) Transaction ID custom. Auto-generate UUID jika tidak diisi.
+     * @returns `txn` yang digunakan — berguna untuk tracking response dari host.
+     *
+     * @example
+     * const txn = signalBridge.emit("ping", { ts: Date.now() });
+     */
+    emit(event: string, payload: any, txn?: string): string;
+    /**
+     * Kirim pesan ke host dengan enkripsi otomatis.
+     *
+     * Setiap pemanggilan menghasilkan key acak baru (CSPRNG),
+     * payload di-encrypt dengan key tersebut
+     *
+     * @param event    Nama event, contoh: `"user:login"`, `"cart:update"`
+     * @param payload Data apapun (object, string, dll) yang ingin dikirim
+     * @returns `{ txn, key }` — keduanya bernilai sama (ephemeral key).
+     *   Simpan jika perlu referensi untuk matching response dari host.
+     *
+     * @example
+     * const { txn } = bridge.emitEncrypted("order:submit", { id: 123 });
+     *
+     */
+    emitEncrypted(event: string, payload: any): {
+        txn: string;
+        key: string;
+    };
+    track: {
+        open_file: (payload?: any) => {
+            txn: string;
+            key: string;
+        };
+        open_document: (payload?: any) => {
+            txn: string;
+            key: string;
+        };
+        view_document: (payload?: any) => {
+            txn: string;
+            key: string;
+        };
+    };
     destroy(): void;
 };
 
-export { base64UrlDecode, base64UrlEncode, createBridge, decrypt, encrypt, generateKey, initBridge, resetBridge, setupBridge, signalBridge };
+export { base64UrlDecode, base64UrlEncode, createBridge, decrypt, encrypt, generateKey, initBridge, resetBridge, signalBridge };

package/dist/index.d.ts

@@ -21,27 +21,165 @@ interface BridgeOptions {
 declare function createBridge(appId: string, options: BridgeOptions): {
     init(): void;
     listen(handler: Listener): void;
-    emit(type: string, payload: any, txn?: string): string;
+    /**
+     * Kirim pesan ke host tanpa enkripsi otomatis.
+     *
+     * Gunakan ini jika host dan remote sudah punya `cryptoKey` yang sama (static key),
+     * atau jika payload memang tidak perlu dienkripsi.
+     * Untuk enkripsi otomatis per-pesan, gunakan `emitEncrypted`.
+     *
+     * @param event   Nama event, contoh: `"ping"`, `"user:logout"`
+     * @param payload Data yang ingin dikirim
+     * @param txn     (opsional) Transaction ID custom. Auto-generate UUID jika tidak diisi.
+     * @returns `txn` yang digunakan — berguna untuk tracking response dari host.
+     *
+     * @example
+     * const txn = signalBridge.emit("ping", { ts: Date.now() });
+     */
+    emit(event: string, payload: any, txn?: string): string;
+    /**
+     * Kirim pesan ke host dengan enkripsi otomatis.
+     *
+     * Setiap pemanggilan menghasilkan key acak baru (CSPRNG),
+     * payload di-encrypt dengan key tersebut
+     *
+     * @param event    Nama event, contoh: `"user:login"`, `"cart:update"`
+     * @param payload Data apapun (object, string, dll) yang ingin dikirim
+     * @returns `{ txn, key }` — keduanya bernilai sama (ephemeral key).
+     *   Simpan jika perlu referensi untuk matching response dari host.
+     *
+     * @example
+     * const { txn } = bridge.emitEncrypted("order:submit", { id: 123 });
+     *
+     */
+    emitEncrypted(event: string, payload: any): {
+        txn: string;
+        key: string;
+    };
+    track: {
+        open_file: (payload?: any) => {
+            txn: string;
+            key: string;
+        };
+        open_document: (payload?: any) => {
+            txn: string;
+            key: string;
+        };
+        view_document: (payload?: any) => {
+            txn: string;
+            key: string;
+        };
+    };
     destroy(): void;
 };
 declare function resetBridge(): void;
 declare function signalBridge(): {
     init(): void;
     listen(handler: Listener): void;
-    emit(type: string, payload: any, txn?: string): string;
-    destroy(): void;
-};
-declare function setupBridge(appId: string, options: BridgeOptions): {
-    init(): void;
-    listen(handler: Listener): void;
-    emit(type: string, payload: any, txn?: string): string;
+    /**
+     * Kirim pesan ke host tanpa enkripsi otomatis.
+     *
+     * Gunakan ini jika host dan remote sudah punya `cryptoKey` yang sama (static key),
+     * atau jika payload memang tidak perlu dienkripsi.
+     * Untuk enkripsi otomatis per-pesan, gunakan `emitEncrypted`.
+     *
+     * @param event   Nama event, contoh: `"ping"`, `"user:logout"`
+     * @param payload Data yang ingin dikirim
+     * @param txn     (opsional) Transaction ID custom. Auto-generate UUID jika tidak diisi.
+     * @returns `txn` yang digunakan — berguna untuk tracking response dari host.
+     *
+     * @example
+     * const txn = signalBridge.emit("ping", { ts: Date.now() });
+     */
+    emit(event: string, payload: any, txn?: string): string;
+    /**
+     * Kirim pesan ke host dengan enkripsi otomatis.
+     *
+     * Setiap pemanggilan menghasilkan key acak baru (CSPRNG),
+     * payload di-encrypt dengan key tersebut
+     *
+     * @param event    Nama event, contoh: `"user:login"`, `"cart:update"`
+     * @param payload Data apapun (object, string, dll) yang ingin dikirim
+     * @returns `{ txn, key }` — keduanya bernilai sama (ephemeral key).
+     *   Simpan jika perlu referensi untuk matching response dari host.
+     *
+     * @example
+     * const { txn } = bridge.emitEncrypted("order:submit", { id: 123 });
+     *
+     */
+    emitEncrypted(event: string, payload: any): {
+        txn: string;
+        key: string;
+    };
+    track: {
+        open_file: (payload?: any) => {
+            txn: string;
+            key: string;
+        };
+        open_document: (payload?: any) => {
+            txn: string;
+            key: string;
+        };
+        view_document: (payload?: any) => {
+            txn: string;
+            key: string;
+        };
+    };
     destroy(): void;
 };
 declare function initBridge(appId: string, options: BridgeOptions): {
     init(): void;
     listen(handler: Listener): void;
-    emit(type: string, payload: any, txn?: string): string;
+    /**
+     * Kirim pesan ke host tanpa enkripsi otomatis.
+     *
+     * Gunakan ini jika host dan remote sudah punya `cryptoKey` yang sama (static key),
+     * atau jika payload memang tidak perlu dienkripsi.
+     * Untuk enkripsi otomatis per-pesan, gunakan `emitEncrypted`.
+     *
+     * @param event   Nama event, contoh: `"ping"`, `"user:logout"`
+     * @param payload Data yang ingin dikirim
+     * @param txn     (opsional) Transaction ID custom. Auto-generate UUID jika tidak diisi.
+     * @returns `txn` yang digunakan — berguna untuk tracking response dari host.
+     *
+     * @example
+     * const txn = signalBridge.emit("ping", { ts: Date.now() });
+     */
+    emit(event: string, payload: any, txn?: string): string;
+    /**
+     * Kirim pesan ke host dengan enkripsi otomatis.
+     *
+     * Setiap pemanggilan menghasilkan key acak baru (CSPRNG),
+     * payload di-encrypt dengan key tersebut
+     *
+     * @param event    Nama event, contoh: `"user:login"`, `"cart:update"`
+     * @param payload Data apapun (object, string, dll) yang ingin dikirim
+     * @returns `{ txn, key }` — keduanya bernilai sama (ephemeral key).
+     *   Simpan jika perlu referensi untuk matching response dari host.
+     *
+     * @example
+     * const { txn } = bridge.emitEncrypted("order:submit", { id: 123 });
+     *
+     */
+    emitEncrypted(event: string, payload: any): {
+        txn: string;
+        key: string;
+    };
+    track: {
+        open_file: (payload?: any) => {
+            txn: string;
+            key: string;
+        };
+        open_document: (payload?: any) => {
+            txn: string;
+            key: string;
+        };
+        view_document: (payload?: any) => {
+            txn: string;
+            key: string;
+        };
+    };
     destroy(): void;
 };
 
-export { base64UrlDecode, base64UrlEncode, createBridge, decrypt, encrypt, generateKey, initBridge, resetBridge, setupBridge, signalBridge };
+export { base64UrlDecode, base64UrlEncode, createBridge, decrypt, encrypt, generateKey, initBridge, resetBridge, signalBridge };

package/dist/index.global.js

@@ -6635,7 +6635,6 @@ var _signalBridgeLib = (() => {
     generateKey: () => generateKey,
     initBridge: () => initBridge,
     resetBridge: () => resetBridge,
-    setupBridge: () => setupBridge,
     signalBridge: () => signalBridge
   });
 
@@ -6742,9 +6741,6 @@ var _signalBridgeLib = (() => {
       if (cryptoKey) {
         finalPayload = encrypt(payload, cryptoKey);
       }
-      if (!txn) {
-        finalPayload = encrypt(payload, resolvedTxn);
-      }
       const message = {
         app_id: appId,
         type,
@@ -6760,6 +6756,24 @@ var _signalBridgeLib = (() => {
       }
       return resolvedTxn;
     }
+    function emitToHostEncrypted(type, payload) {
+      const key = generateKey();
+      const finalPayload = encrypt(payload, key);
+      const message = {
+        app_id: appId,
+        type,
+        payload: finalPayload,
+        txn: key,
+        __origin: window.location.origin,
+        __source: "remote"
+      };
+      if (window.parent && window.parent !== window) {
+        allowedHostOrigins.forEach((origin) => {
+          window.parent.postMessage(message, origin);
+        });
+      }
+      return { txn: key, key };
+    }
     function emitReadyOnce() {
       if (isInitialized) return;
       isInitialized = true;
@@ -6777,9 +6791,53 @@ var _signalBridgeLib = (() => {
       listen(handler) {
         listeners.push(handler);
       },
-      emit(type, payload, txn) {
-        return emitToHost(type, payload, txn);
+      /**
+       * Kirim pesan ke host tanpa enkripsi otomatis.
+       *
+       * Gunakan ini jika host dan remote sudah punya `cryptoKey` yang sama (static key),
+       * atau jika payload memang tidak perlu dienkripsi.
+       * Untuk enkripsi otomatis per-pesan, gunakan `emitEncrypted`.
+       *
+       * @param event   Nama event, contoh: `"ping"`, `"user:logout"`
+       * @param payload Data yang ingin dikirim
+       * @param txn     (opsional) Transaction ID custom. Auto-generate UUID jika tidak diisi.
+       * @returns `txn` yang digunakan — berguna untuk tracking response dari host.
+       *
+       * @example
+       * const txn = signalBridge.emit("ping", { ts: Date.now() });
+       */
+      emit(event, payload, txn) {
+        return emitToHost(event, payload, txn);
+      },
+      /**
+       * Kirim pesan ke host dengan enkripsi otomatis.
+       *
+       * Setiap pemanggilan menghasilkan key acak baru (CSPRNG),
+       * payload di-encrypt dengan key tersebut
+       *
+       * @param event    Nama event, contoh: `"user:login"`, `"cart:update"`
+       * @param payload Data apapun (object, string, dll) yang ingin dikirim
+       * @returns `{ txn, key }` — keduanya bernilai sama (ephemeral key).
+       *   Simpan jika perlu referensi untuk matching response dari host.
+       *
+       * @example
+       * const { txn } = bridge.emitEncrypted("order:submit", { id: 123 });
+       *
+       */
+      emitEncrypted(event, payload) {
+        return emitToHostEncrypted(event, payload);
       },
+      track: (() => {
+        const EVENTS = [
+          "open_file",
+          "open_document",
+          "view_document"
+        ];
+        return EVENTS.reduce((acc, event) => {
+          acc[event] = (payload) => emitToHostEncrypted(`activity:${event}`, payload != null ? payload : {});
+          return acc;
+        }, {});
+      })(),
       destroy() {
         window.removeEventListener("message", messageHandler);
       }