@sogni-ai/sogni-client 4.0.0-alpha.2 → 4.0.0-alpha.21

package/dist/lib/DataEntity.js.map

@@ -1 +1 @@
-{"version":3,"file":"DataEntity.js","sourceRoot":"","sources":["../../src/lib/DataEntity.ts"],"names":[],"mappings":";;;;;AAAA,mCAAmC;AACnC,4EAAoD;AASpD,MAAe,UAAqD,SAAQ,2BAAoB;IAK9F,YAAY,IAAO;QACjB,KAAK,EAAE,CAAC;QAHA,gBAAW,GAAS,IAAI,IAAI,EAAE,CAAC;QAIvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,KAAiB;QACvB,YAAY;QACZ,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACtF,IAAI,CAAC,IAAI,mCAAQ,IAAI,CAAC,IAAI,GAAK,KAAK,CAAE,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,IAAA,kBAAS,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,kBAAe,UAAU,CAAC"}
+{"version":3,"file":"DataEntity.js","sourceRoot":"","sources":["../../src/lib/DataEntity.ts"],"names":[],"mappings":";;;;;AAAA,mCAAmC;AACnC,4EAAoD;AASpD,MAAe,UAAqD,SAAQ,2BAAoB;IAK9F,YAAY,IAAO;QACjB,KAAK,EAAE,CAAC;QAHA,gBAAW,GAAS,IAAI,IAAI,EAAE,CAAC;QAIvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,KAAiB;QACvB,YAAY;QACZ,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACtF,IAAI,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;QAC9B,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,mCAAQ,IAAI,CAAC,IAAI,GAAK,KAAK,CAAE,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,IAAA,kBAAS,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,kBAAe,UAAU,CAAC"}

package/dist/lib/validation.d.ts

@@ -6,4 +6,6 @@ interface NumberValidationOptions {
     defaultValue?: number;
 }
 export declare function validateNumber(value: any, { min, max, propertyName, defaultValue }?: NumberValidationOptions): number;
+export declare function validateSampler(value?: string): string | null;
+export declare function validateScheduler(value?: string): string | null;
 export {};

package/dist/lib/validation.js

@@ -2,6 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateCustomImageSize = validateCustomImageSize;
 exports.validateNumber = validateNumber;
+exports.validateSampler = validateSampler;
+exports.validateScheduler = validateScheduler;
+const SamplerParams_1 = require("../Projects/types/SamplerParams");
+const SchedulerParams_1 = require("../Projects/types/SchedulerParams");
 function validateCustomImageSize(value) {
     return validateNumber(value, { min: 256, max: 2048, propertyName: 'Width and height' });
 }
@@ -31,4 +35,28 @@ function validateNumber(value, { min, max, propertyName, defaultValue } = {}) {
     }
     return number;
 }
+function validateSampler(value) {
+    if (!value) {
+        return null;
+    }
+    if ((0, SamplerParams_1.isRawSampler)(value)) {
+        return value;
+    }
+    if ((0, SamplerParams_1.isSampler)(value)) {
+        return SamplerParams_1.SupportedSamplers[value];
+    }
+    throw new Error(`Invalid sampler: ${value}. Supported options: ${Object.keys(SamplerParams_1.SupportedSamplers).join(', ')}`);
+}
+function validateScheduler(value) {
+    if (!value) {
+        return null;
+    }
+    if ((0, SamplerParams_1.isRawSampler)(value)) {
+        return value;
+    }
+    if ((0, SchedulerParams_1.isScheduler)(value)) {
+        return SchedulerParams_1.SupportedSchedulers[value];
+    }
+    throw new Error(`Invalid scheduler: ${value}. Supported options: ${Object.keys(SchedulerParams_1.SupportedSchedulers).join(', ')}`);
+}
 //# sourceMappingURL=validation.js.map

package/dist/lib/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/lib/validation.ts"],"names":[],"mappings":";;AAAA,0DAEC;AASD,wCA4BC;AAvCD,SAAgB,uBAAuB,CAAC,KAAU;IAChD,OAAO,cAAc,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAC1F,CAAC;AASD,SAAgB,cAAc,CAC5B,KAAU,EACV,EAAE,GAAG,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,KAA8B,EAAE;IAEtE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,eAAe,GAAG,YAAY,KAAK,SAAS,CAAC;IACnD,IAAI,YAAY,EAAE,CAAC;QACjB,YAAY,GAAG,OAAO,CAAC;IACzB,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAClB,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,0BAA0B,KAAK,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;QACtC,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,0BAA0B,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;QACtC,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,0BAA0B,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/lib/validation.ts"],"names":[],"mappings":";;AAGA,0DAEC;AASD,wCA4BC;AAED,0CAaC;AAED,8CAaC;AAxED,mEAA6F;AAC7F,uEAAqF;AAErF,SAAgB,uBAAuB,CAAC,KAAU;IAChD,OAAO,cAAc,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAC1F,CAAC;AASD,SAAgB,cAAc,CAC5B,KAAU,EACV,EAAE,GAAG,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,KAA8B,EAAE;IAEtE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,eAAe,GAAG,YAAY,KAAK,SAAS,CAAC;IACnD,IAAI,YAAY,EAAE,CAAC;QACjB,YAAY,GAAG,OAAO,CAAC;IACzB,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAClB,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,0BAA0B,KAAK,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;QACtC,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,0BAA0B,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;QACtC,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,0BAA0B,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,eAAe,CAAC,KAAc;IAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,IAAA,4BAAY,EAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,IAAA,yBAAS,EAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,iCAAiB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,IAAI,KAAK,CACb,oBAAoB,KAAK,wBAAwB,MAAM,CAAC,IAAI,CAAC,iCAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7F,CAAC;AACJ,CAAC;AAED,SAAgB,iBAAiB,CAAC,KAAc;IAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,IAAA,4BAAY,EAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,IAAA,6BAAW,EAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,qCAAmB,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IACD,MAAM,IAAI,KAAK,CACb,sBAAsB,KAAK,wBAAwB,MAAM,CAAC,IAAI,CAAC,qCAAmB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjG,CAAC;AACJ,CAAC"}

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "4.0.0-alpha.2",
+  "version": "4.0.0-alpha.21",
   "description": "Sogni Supernet Client",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -37,6 +37,9 @@
   "homepage": "https://github.com/Sogni-AI/sogni-client#readme",
   "dependencies": {
     "@lukeed/uuid": "^2.0.1",
+    "@types/js-cookie": "^3.0.6",
+    "@types/lodash": "^4.17.13",
+    "@types/ws": "^8.5.13",
     "ethers": "^6.13.4",
     "isomorphic-ws": "^5.0.0",
     "js-cookie": "^3.0.5",
@@ -47,9 +50,6 @@
   "devDependencies": {
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
-    "@types/js-cookie": "^3.0.6",
-    "@types/lodash": "^4.17.13",
-    "@types/ws": "^8.5.13",
     "prettier": "^3.3.3",
     "rimraf": "^6.0.1",
     "semantic-release": "^24.2.1",

package/src/Account/index.ts

@@ -43,7 +43,12 @@ class AccountApi extends ApiGroup {
 
   constructor(config: ApiConfig) {
     super(config);
+    this.currentAccount._update({
+      networkStatus: this.client.socket.isConnected ? 'connected' : 'disconnected',
+      network: this.client.socket.supernetType
+    });
     this.client.socket.on('balanceUpdate', this.handleBalanceUpdate.bind(this));
+    this.client.socket.on('changeNetwork', this.handleChangeNetwork.bind(this));
     this.client.on('connected', this.handleServerConnected.bind(this));
     this.client.on('disconnected', this.handleServerDisconnected.bind(this));
     this.client.auth.on('updated', this.handleAuthUpdated.bind(this));
@@ -53,6 +58,10 @@ class AccountApi extends ApiGroup {
     this.currentAccount._update({ balance: data });
   }
 
+  private handleChangeNetwork({ network }: { network: SupernetType }) {
+    this.currentAccount._update({ network, networkStatus: 'connected' });
+  }
+
   private handleServerConnected({ network }: { network: SupernetType }) {
     this.currentAccount._update({
       networkStatus: 'connected',
@@ -70,6 +79,8 @@ class AccountApi extends ApiGroup {
   private handleAuthUpdated(isAuthenticated: boolean) {
     if (!isAuthenticated) {
       this.currentAccount._clear();
+    } else {
+      this.me();
     }
   }
 
@@ -110,14 +121,10 @@ class AccountApi extends ApiGroup {
    * Create a new account with the given username, email, and password.
    * @internal
    */
-  async create({
-    username,
-    email,
-    password,
-    subscribe,
-    turnstileToken,
-    referralCode
-  }: AccountCreateParams): Promise<AccountCreateData> {
+  async create(
+    { username, email, password, subscribe, turnstileToken, referralCode }: AccountCreateParams,
+    rememberMe = false
+  ): Promise<AccountCreateData> {
     const wallet = this.getWallet(username, password);
     const nonce = await this.getNonce(wallet.address);
     const payload = {
@@ -132,7 +139,8 @@ class AccountApi extends ApiGroup {
     const res = await this.client.rest.post<ApiResponse<AccountCreateData>>('/v1/account/create', {
       ...payload,
       referralCode,
-      signature
+      signature,
+      rememberMe
     });
     const auth = this.client.auth;
     if (auth instanceof TokenAuthManager) {
@@ -140,7 +148,6 @@ class AccountApi extends ApiGroup {
     } else {
       await auth.authenticate();
     }
-    await this.me();
     return res.data;
   }
 
@@ -155,8 +162,10 @@ class AccountApi extends ApiGroup {
    *
    * @param username
    * @param password
+   * @param rememberMe - Whether to establish a long-lived session. Default is false. Only
+   * applicable for cookie-based authentication.
    */
-  async login(username: string, password: string): Promise<LoginData> {
+  async login(username: string, password: string, rememberMe = false): Promise<LoginData> {
     const wallet = this.getWallet(username, password);
     const nonce = await this.getNonce(wallet.address);
     const signature = await this.eip712.signTypedData(wallet, 'authentication', {
@@ -165,7 +174,8 @@ class AccountApi extends ApiGroup {
     });
     const res = await this.client.rest.post<ApiResponse<LoginData>>('/v1/account/login', {
       walletAddress: wallet.address,
-      signature
+      signature,
+      rememberMe
     });
     const auth = this.client.auth;
     if (auth instanceof TokenAuthManager) {
@@ -173,7 +183,6 @@ class AccountApi extends ApiGroup {
     } else {
       await auth.authenticate();
     }
-    await this.me();
     return res.data;
   }
 

package/src/ApiClient/WebSocketClient/BrowserWebSocketClient/ChannelCoordinator.ts

@@ -0,0 +1,426 @@
+import getUUID from '../../../lib/getUUID';
+import { Logger } from '../../../lib/DefaultLogger';
+
+const PRIMARY_HEARTBEAT_INTERVAL = 2000;
+const PRIMARY_TIMEOUT = 4000;
+const ACK_TIMEOUT = 5000;
+
+enum MessageType {
+  ELECTION = 'election',
+  ELECTION_RESPONSE = 'election_response',
+  PRIMARY_ANNOUNCE = 'primary_announce',
+  PRIMARY_HEARTBEAT = 'primary_heartbeat',
+  BROADCAST = 'broadcast',
+  REQUEST = 'request',
+  REQUEST_ACK = 'request_ack'
+}
+
+interface Election {
+  type: MessageType.ELECTION;
+  payload: { priority: number };
+}
+
+interface ElectionResponse {
+  type: MessageType.ELECTION_RESPONSE;
+  payload: { id: string; priority: number };
+}
+
+interface PrimaryAnnounce {
+  type: MessageType.PRIMARY_ANNOUNCE;
+  payload: { id: string; priority: number };
+}
+
+interface PrimaryHeartbeat {
+  type: MessageType.PRIMARY_HEARTBEAT;
+  payload: { id: string; priority: number };
+}
+
+interface BroadcastMessage {
+  type: MessageType.BROADCAST;
+  payload: any;
+}
+
+interface RequestMessage {
+  type: MessageType.REQUEST;
+  payload: any;
+}
+
+interface RequestAckMessage {
+  type: MessageType.REQUEST_ACK;
+  payload: { id: string; error?: any };
+}
+
+type Message =
+  | Election
+  | ElectionResponse
+  | PrimaryAnnounce
+  | PrimaryHeartbeat
+  | BroadcastMessage
+  | RequestMessage
+  | RequestAckMessage;
+
+interface Envelope {
+  id: string;
+  senderId: string;
+  recipientId?: string;
+  timestamp: number;
+  message: Message;
+}
+
+const CHANNEL_NAME = 'sogni-websocket-channel';
+
+let isActiveTab = false;
+if (typeof window !== 'undefined' && window.location.protocol === 'https:') {
+  isActiveTab = window.document.visibilityState === 'visible';
+  window.addEventListener(
+    'visibilitychange',
+    () => (isActiveTab = window.document.visibilityState === 'visible')
+  );
+}
+
+interface Callbacks<M, N> {
+  onRoleChange: (isPrimary: boolean) => void;
+  onMessage: (message: M) => Promise<void>;
+  onNotification: (notification: N) => void;
+}
+
+interface Options<M, N> {
+  callbacks: Callbacks<M, N>;
+  logger: Logger;
+}
+
+/**
+ * A class responsible for coordinating communication across browser tabs or windows via BroadcastChannel API.
+ * It handles the role election of the primary (leader) tab, message broadcasting, heartbeats for primary tab monitoring,
+ * and message acknowledgment for reliable communication.
+ *
+ * The `ChannelCoordinator` ensures that one tab per session is assigned as the primary, while allowing others to act as secondaries,
+ * utilizing various message types for communication and coordination.
+ *
+ * Message is sent by secondary tabs to the primary tab via the `sendMessage` method. By sending message
+ * tab can tell primary to connect, disconnect, send message to socket etc.
+ *
+ * Notification is type of message broadcasted by primary to secondary tabs. This is mostly used to
+ * broadcast socket events from primary to secondary tabs.
+ *
+ * @template M - The type of messages being broadcast to other tabs/windows.
+ * @template N - The type of notifications being handled within the coordinator.
+ */
+class ChannelCoordinator<M, N> {
+  private readonly id: string = getUUID();
+  private priority = Date.now();
+  private readonly channel = new BroadcastChannel(CHANNEL_NAME);
+
+  private _isPrimary = false;
+  private callbacks: Callbacks<M, N>;
+  private logger: Logger;
+
+  private ackCallbacks: Record<string, (error?: any) => void> = {};
+
+  // User to handle election of primary tab
+  private electionInProgress: boolean = false;
+  private electionResponses: Map<string, number> = new Map();
+
+  // Heartbeat to detect primary tab death
+  private lastPrimaryHeartbeat: number = Date.now();
+  private heartbeatTimer: NodeJS.Timeout | null = null;
+  private primaryCheckTimer: NodeJS.Timeout | null = null;
+  private readyCallback: () => void | null = () => {};
+  private readonly readyPromise: Promise<void>;
+
+  constructor({ callbacks, logger }: Options<M, N>) {
+    this.readyPromise = new Promise((resolve) => {
+      let called = false;
+      this.readyCallback = () => {
+        if (!called) {
+          called = true;
+          resolve();
+        }
+      };
+    });
+    this.callbacks = callbacks;
+    this.logger = logger;
+    this.channel.addEventListener('message', (event) => this.handleMessage(event.data));
+    this.startElections();
+    this.startPrimaryMonitor();
+    // Listen for tab closing to gracefully release primary role
+    if (typeof window !== 'undefined') {
+      window.addEventListener('beforeunload', () => {
+        this.priority = 0;
+        this.startElections();
+      });
+    }
+  }
+
+  get isPrimary() {
+    return this._isPrimary;
+  }
+
+  private get currentPriority() {
+    return isActiveTab ? this.priority * 10 : this.priority;
+  }
+
+  isReady() {
+    return this.readyPromise;
+  }
+
+  private startElections() {
+    this.logger.debug(
+      `Start primary elections, my priority is ${this.currentPriority}, tab visibility is ${isActiveTab}`
+    );
+    this.electionInProgress = true;
+    this.electionResponses.clear();
+    this.electionResponses.set(this.id, this.currentPriority);
+    this.broadcast({
+      type: MessageType.ELECTION,
+      payload: { priority: this.currentPriority }
+    });
+    setTimeout(() => {
+      this.finishElections();
+    }, 500);
+  }
+
+  private finishElections() {
+    if (!this.electionInProgress) {
+      return;
+    }
+    // Find highest priority
+    let highestPriority = -Infinity;
+    let winnerId: string | null = null;
+
+    for (const [id, priority] of this.electionResponses) {
+      if (priority > highestPriority || (priority === highestPriority && id > (winnerId || ''))) {
+        highestPriority = priority;
+        winnerId = id;
+      }
+    }
+
+    if (winnerId === this.id) {
+      this.becomePrimary();
+      this.logger.debug(`Won elections! ${winnerId}`);
+    } else {
+      this.logger.debug(`Lost elections! Winner is ${winnerId}`);
+    }
+
+    this.electionInProgress = false;
+    this.electionResponses.clear();
+  }
+
+  private becomePrimary() {
+    this._isPrimary = true;
+    this.lastPrimaryHeartbeat = Date.now();
+    this.broadcast({
+      type: MessageType.PRIMARY_ANNOUNCE,
+      payload: { id: this.id, priority: this.currentPriority }
+    });
+    this.startHeartbeat();
+    this.callbacks.onRoleChange(true);
+    this.readyCallback();
+  }
+
+  private startHeartbeat(): void {
+    if (this.heartbeatTimer) {
+      clearInterval(this.heartbeatTimer);
+    }
+
+    this.heartbeatTimer = setInterval(() => {
+      if (this._isPrimary) {
+        this.broadcast({
+          type: MessageType.PRIMARY_HEARTBEAT,
+          payload: { id: this.id, priority: this.currentPriority }
+        });
+      } else {
+        this.stopHeartbeat();
+      }
+    }, PRIMARY_HEARTBEAT_INTERVAL);
+  }
+
+  private stopHeartbeat(): void {
+    if (this.heartbeatTimer) {
+      clearInterval(this.heartbeatTimer);
+      this.heartbeatTimer = null;
+    }
+  }
+
+  private startPrimaryMonitor(): void {
+    if (this.primaryCheckTimer) {
+      clearInterval(this.primaryCheckTimer);
+    }
+    this.primaryCheckTimer = setInterval(() => {
+      if (!this._isPrimary) {
+        const timeSinceLastHeartbeat = Date.now() - this.lastPrimaryHeartbeat;
+        if (timeSinceLastHeartbeat > PRIMARY_TIMEOUT) {
+          this.startElections();
+        }
+      } else {
+        this.lastPrimaryHeartbeat = Date.now();
+      }
+    }, PRIMARY_HEARTBEAT_INTERVAL);
+  }
+
+  private handleMessage(envelope: Envelope) {
+    const { senderId, recipientId, message } = envelope;
+    const isForOtherClient = recipientId && recipientId !== this.id;
+    if (senderId === this.id || isForOtherClient) {
+      return;
+    }
+    switch (message.type) {
+      case MessageType.ELECTION:
+        return this.handleElection(message);
+      case MessageType.ELECTION_RESPONSE:
+        return this.handleElectionResponse(message);
+      case MessageType.PRIMARY_ANNOUNCE:
+        return this.handlePrimaryAnnounce(message);
+      case MessageType.PRIMARY_HEARTBEAT:
+        return this.handlePrimaryHeartbeat();
+      case MessageType.BROADCAST:
+        return this.handleBroadcast(message);
+      case MessageType.REQUEST:
+        return this.handleRequest(message, envelope);
+      case MessageType.REQUEST_ACK:
+        return this.handleRequestAck(message);
+    }
+  }
+
+  private handleElection(message: Election) {
+    this.broadcast({
+      type: MessageType.ELECTION_RESPONSE,
+      payload: { id: this.id, priority: this.currentPriority }
+    });
+    if (this.currentPriority > message.payload.priority && !this.electionInProgress) {
+      this.startElections();
+    }
+  }
+
+  private handleElectionResponse(message: ElectionResponse) {
+    if (this.electionInProgress) {
+      this.electionResponses.set(message.payload.id, message.payload.priority);
+    }
+  }
+
+  private handlePrimaryAnnounce(message: PrimaryAnnounce) {
+    this.logger.debug(`Primary announced: ${message.payload.id}`);
+    const wasPrimary = this._isPrimary;
+    this._isPrimary = false;
+    this.lastPrimaryHeartbeat = Date.now();
+    this.electionInProgress = false;
+    this.electionResponses.clear();
+
+    if (this.heartbeatTimer) {
+      clearInterval(this.heartbeatTimer);
+      this.heartbeatTimer = null;
+    }
+    if (wasPrimary) {
+      this.callbacks.onRoleChange(false);
+    }
+    this.readyCallback();
+  }
+
+  private handlePrimaryHeartbeat() {
+    this.lastPrimaryHeartbeat = Date.now();
+  }
+
+  private handleBroadcast(message: BroadcastMessage) {
+    this.logger.debug(`Received broadcast from primary`, message.payload);
+    this.callbacks.onNotification(message.payload);
+  }
+
+  private handleRequest(message: RequestMessage, envelope: Envelope) {
+    if (!this.isPrimary) {
+      return;
+    }
+    this.logger.debug(`Received request from secondary`, message.payload);
+    this.callbacks
+      .onMessage(message.payload)
+      .then(() => {
+        this.send(
+          {
+            type: MessageType.REQUEST_ACK,
+            payload: { id: envelope.id }
+          },
+          envelope.senderId
+        );
+      })
+      .catch((error) => {
+        this.send(
+          {
+            type: MessageType.REQUEST_ACK,
+            payload: { id: envelope.id, error }
+          },
+          envelope.senderId
+        );
+      });
+  }
+
+  private handleRequestAck(message: RequestAckMessage) {
+    const ackCallback = this.ackCallbacks[message.payload.id];
+    if (ackCallback) {
+      ackCallback(message.payload.error);
+      delete this.ackCallbacks[message.payload.id];
+    }
+  }
+
+  private async send(
+    message: RequestMessage | RequestAckMessage,
+    recipientId?: string
+  ): Promise<void> {
+    const envelope: Envelope = {
+      id: getUUID(),
+      senderId: this.id,
+      recipientId,
+      timestamp: Date.now(),
+      message: message
+    };
+    if (message.type !== MessageType.REQUEST) {
+      this.channel.postMessage(envelope);
+      return;
+    }
+    return new Promise<void>((resolve, reject) => {
+      const ackTimeout = setTimeout(() => {
+        if (this.ackCallbacks[envelope.id]) {
+          this.ackCallbacks[envelope.id](new Error('Message delivery timeout'));
+          delete this.ackCallbacks[envelope.id];
+        }
+      }, ACK_TIMEOUT);
+      this.ackCallbacks[envelope.id] = (error?: any) => {
+        clearTimeout(ackTimeout);
+        delete this.ackCallbacks[envelope.id];
+        if (error) {
+          reject(error);
+        } else {
+          resolve();
+        }
+      };
+      this.channel.postMessage(envelope);
+    });
+  }
+
+  private broadcast(message: Message) {
+    const envelope: Envelope = {
+      id: getUUID(),
+      senderId: this.id,
+      timestamp: Date.now(),
+      message: message
+    };
+    this.channel.postMessage(envelope);
+    return envelope.id;
+  }
+
+  public async sendMessage(message: M): Promise<any> {
+    this.logger.debug(`Sending message to primary`, message);
+    return this.send({
+      type: MessageType.REQUEST,
+      payload: message
+    });
+  }
+
+  public notify(message: N) {
+    this.logger.debug(`Sending notification to secondary tabs`, message);
+    this.broadcast({
+      type: MessageType.BROADCAST,
+      payload: message
+    });
+  }
+}
+
+export default ChannelCoordinator;