@wireapp/api-client 27.66.0 → 27.67.1

package/lib/APIClient.d.ts

@@ -113,18 +113,25 @@ export declare class APIClient extends EventEmitter {
      */
     private computeBackendFeatures;
     /**
-     * Will set the APIClient to use a specific version of the API (by default uses version 0)
-     * It will fetch the API Config and use the highest possible version
-     * @param min mininum version to use
-     * @param max maximum version to use
-     * @param allowDev allow the api-client to use development version of the api (if present). The dev version also need to be listed on the supportedVersions given as parameters
-     *   If we have version 2 that is a dev version, this is going to be the output of those calls
-     *   - useVersion(0, 2, true) > version 2 is used
-     *   - useVersion(0, 2) > version 1 is used
-     *   - useVersion(0, 1, true) > version 1 is used
-     * @return The highest version that is both supported by client and backend
+     * Sets the API client to use the highest supported version within a given range,
+     * with a hard minimum of version 8 enforced.
+     *
+     * @param min - Minimum acceptable version (must be ≥ 8)
+     * @param max - Maximum acceptable version
+     * @param allowDev - If true, allows using development versions from the backend
+     * @returns Backend feature configuration for the selected version
+     * @throws Error if no compatible version is found
      */
     useVersion(min: number, max: number, allowDev?: boolean): Promise<BackendFeatures>;
+    /**
+     * Returns the highest version from the list that falls within the specified range.
+     *
+     * @param versions - List of available versions
+     * @param min - Minimum required version
+     * @param max - Maximum allowed version
+     * @returns The highest version in the allowed range, or undefined if none are compatible
+     */
+    private findHighestCompatibleVersion;
     init(clientType?: ClientType, cookie?: Cookie): Promise<Context>;
     login(loginData: LoginData): Promise<Context>;
     loginWithToken(accessTokenString: string, clientType?: ClientType): Promise<Context>;

package/lib/APIClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"APIClient.d.ts","sourceRoot":"","sources":["../src/APIClient.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAC,YAAY,EAAC,MAAM,QAAQ,CAAC;AAIpC,OAAO,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAC,QAAQ,EAAC,MAAM,UAAU,CAAC;AAClC,OAAO,EACL,eAAe,EAEf,OAAO,EACP,OAAO,EACP,MAAM,EACN,iBAAiB,EACjB,SAAS,EAET,YAAY,EACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAC,YAAY,EAAC,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAC,SAAS,EAAE,UAAU,EAAC,MAAM,WAAW,CAAC;AAChD,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAC;AAChC,OAAO,EAAC,aAAa,EAAC,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAC,eAAe,EAAC,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAC,UAAU,EAAC,MAAM,WAAW,CAAC;AACrC,OAAO,EAAC,QAAQ,EAAC,MAAM,UAAU,CAAC;AAClC,OAAO,EAAe,UAAU,EAAC,MAAM,SAAS,CAAC;AACjD,OAAO,EAAC,eAAe,EAAC,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAE1C,OAAO,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAChC,OAAO,EAAC,kBAAkB,EAAC,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAC,WAAW,EAAC,MAAM,YAAY,CAAC;AACvC,OAAO,EAAC,SAAS,EAAE,eAAe,EAAC,MAAM,QAAQ,CAAC;AAClD,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,OAAO,EACP,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAC,aAAa,EAAC,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAC,MAAM,EAAC,MAAM,YAAY,CAAC;AAClC,OAAO,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAIhC,aAAK,KAAK;IACR,oBAAoB,yCAAyC;IAC7D,cAAc,mCAAmC;IACjD,4CAA4C;IAC5C,SAAS,8BAA8B;CACxC;AAMD,MAAM,WAAW,SAAS;IACxB,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,IAAI,CAAC;IAE/E,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,cAAc,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAE3E,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,oBAAoB,EAAE,QAAQ,EAAE,CAAC,WAAW,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI,CAAC;CAC/F;AAED,KAAK,IAAI,GAAG;IACV,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,QAAQ,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,YAAY,CAAC;IACxB,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE,aAAa,CAAC;IAC1B,YAAY,EAAE,eAAe,CAAC;IAC9B,KAAK,EAAE,QAAQ,CAAC;IAChB,YAAY,EAAE,eAAe,CAAC;IAC9B,KAAK,EAAE,QAAQ,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,WAAW,CAAC;IACtB,eAAe,EAAE,kBAAkB,CAAC;IACpC,KAAK,EAAE;QACL,YAAY,EAAE,mBAAmB,CAAC;QAClC,OAAO,EAAE,UAAU,CAAC;QACpB,gBAAgB,EAAE,mBAAmB,CAAC;QACtC,UAAU,EAAE,iBAAiB,CAAC;QAC9B,SAAS,EAAE,YAAY,CAAC;QACxB,MAAM,EAAE,SAAS,CAAC;QAClB,OAAO,EAAE,UAAU,CAAC;QACpB,OAAO,EAAE,UAAU,CAAC;QACpB,IAAI,EAAE,OAAO,CAAC;QACd,MAAM,EAAE,aAAa,CAAC;QACtB,OAAO,EAAE,UAAU,CAAC;QACpB,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,OAAO,CAAC;KACf,CAAC;IACF,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,UAAU,CAAC;CACrB,CAAC;AAEF,sGAAsG;AACtG,MAAM,MAAM,eAAe,GAAG;IAC5B,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iEAAiE;IACjE,WAAW,EAAE,OAAO,CAAC;IACrB,gDAAgD;IAChD,WAAW,EAAE,OAAO,CAAC;IACrB,sEAAsE;IACtE,8BAA8B,EAAE,OAAO,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,qBAAa,SAAU,SAAQ,YAAY;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IAGjC,GAAG,EAAE,IAAI,CAAC;IACjB,OAAO,CAAC,QAAQ,CAAyB;IAGzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE;QAAC,IAAI,EAAE,UAAU,CAAC;QAAC,EAAE,EAAE,eAAe,CAAA;KAAC,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,eAAe,CAAC;IAExC,OAAc,OAAO;;;MAAW;IAEhC,gBAAuB,KAAK,eAAS;IAErC,OAAc,OAAO,SAAW;gBAEpB,MAAM,CAAC,EAAE,MAAM;IAmC3B,OAAO,CAAC,aAAa;IAgDrB;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAW9B;;;;;;;;;;;OAWG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAwB3E,IAAI,CAAC,UAAU,GAAE,UAA4B,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWjF,KAAK,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB7C,cAAc,CAAC,iBAAiB,EAAE,MAAM,EAAE,UAAU,GAAE,UAA4B,GAAG,OAAO,CAAC,OAAO,CAAC;IAerG,QAAQ,CAAC,WAAW,EAAE,YAAY,EAAE,UAAU,GAAE,UAAiC,GAAG,OAAO,CAAC,OAAO,CAAC;IAYpG,MAAM,CAAC,OAAO,GAAE;QAAC,iBAAiB,EAAE,OAAO,CAAA;KAA8B,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/F,OAAO,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,eAAe;YAIxC,aAAa;IAepB,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAIxC,IAAW,QAAQ,IAAI,MAAM,GAAG,SAAS,CAExC;IAED,IAAW,MAAM,IAAI,MAAM,GAAG,SAAS,CAEtC;IAED,IAAW,MAAM,IAAI,MAAM,GAAG,SAAS,CAEtC;IAED,8DAA8D;IAC9D,IAAW,eAAe,IAAI,MAAM,CAKnC;IAED,gEAAgE;IAChE,IAAW,iBAAiB,IAAI,MAAM,CAKrC;IAED;;OAEG;IACU,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAc7C"}
+{"version":3,"file":"APIClient.d.ts","sourceRoot":"","sources":["../src/APIClient.ts"],"names":[],"mappings":"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"}

package/lib/APIClient.js

@@ -29,6 +29,7 @@ const parseAccessToken_1 = require("./auth/parseAccessToken");
 const broadcast_1 = require("./broadcast/");
 const CellsAPI_1 = require("./cells/CellsAPI");
 const client_1 = require("./client/");
+const Config_1 = require("./Config");
 const connection_1 = require("./connection/");
 const conversation_1 = require("./conversation/");
 const env_1 = require("./env/");
@@ -96,7 +97,7 @@ class APIClient extends events_1.EventEmitter {
             http: httpClient,
             ws: webSocket,
         };
-        this.backendFeatures = this.computeBackendFeatures(0);
+        this.backendFeatures = this.computeBackendFeatures(Config_1.MINIMUM_API_VERSION);
         this.api = this.configureApis(this.backendFeatures);
     }
     configureApis(backendFeatures) {
@@ -159,38 +160,47 @@ class APIClient extends events_1.EventEmitter {
         };
     }
     /**
-     * Will set the APIClient to use a specific version of the API (by default uses version 0)
-     * It will fetch the API Config and use the highest possible version
-     * @param min mininum version to use
-     * @param max maximum version to use
-     * @param allowDev allow the api-client to use development version of the api (if present). The dev version also need to be listed on the supportedVersions given as parameters
-     *   If we have version 2 that is a dev version, this is going to be the output of those calls
-     *   - useVersion(0, 2, true) > version 2 is used
-     *   - useVersion(0, 2) > version 1 is used
-     *   - useVersion(0, 1, true) > version 1 is used
-     * @return The highest version that is both supported by client and backend
+     * Sets the API client to use the highest supported version within a given range,
+     * with a hard minimum of version 8 enforced.
+     *
+     * @param min - Minimum acceptable version (must be ≥ 8)
+     * @param max - Maximum acceptable version
+     * @param allowDev - If true, allows using development versions from the backend
+     * @returns Backend feature configuration for the selected version
+     * @throws Error if no compatible version is found
      */
-    async useVersion(min, max, allowDev) {
-        let backendVersions = { supported: [0], domain: '' };
-        try {
-            backendVersions = (await this.transport.http.sendRequest({ url: '/api-version' })).data;
+    async useVersion(min, max, allowDev = false) {
+        if (min < Config_1.MINIMUM_API_VERSION) {
+            throw new Error(`Minimum supported API version is ${Config_1.MINIMUM_API_VERSION}. Received: ${min}`);
         }
-        catch (error) { }
-        const devVersions = allowDev ? backendVersions.development ?? [] : [];
-        const highestCommonVersion = backendVersions.supported
-            .concat(devVersions)
-            .sort()
-            .reverse()
-            .find(version => version >= min && version <= max);
-        if (highestCommonVersion === undefined) {
-            const supportedStr = backendVersions.supported.join(', ');
-            throw new Error(`Backend does not support requested versions [${min}-${max}] (supported versions ${supportedStr})`);
+        const response = await this.transport.http.sendRequest({
+            url: '/api-version',
+        });
+        const { supported, development = [], domain, federation } = response.data;
+        const availableVersions = allowDev ? [...supported, ...development] : supported;
+        const compatibleVersion = this.findHighestCompatibleVersion(availableVersions, min, max);
+        if (compatibleVersion === undefined) {
+            throw new Error(`No compatible API version in range [${min}-${max}]. ` + `Backend supports: [${supported.join(', ')}]`);
         }
-        this.backendFeatures = this.computeBackendFeatures(highestCommonVersion, backendVersions);
-        this.transport.http.useVersion(this.backendFeatures.version);
+        this.backendFeatures = this.computeBackendFeatures(compatibleVersion, { federation, supported, development, domain });
+        this.transport.http.useVersion(compatibleVersion);
+        this.transport.ws.useVersion(compatibleVersion);
         this.api = this.configureApis(this.backendFeatures);
         return this.backendFeatures;
     }
+    /**
+     * Returns the highest version from the list that falls within the specified range.
+     *
+     * @param versions - List of available versions
+     * @param min - Minimum required version
+     * @param max - Maximum allowed version
+     * @returns The highest version in the allowed range, or undefined if none are compatible
+     */
+    findHighestCompatibleVersion(versions, min, max) {
+        const inRangeVersions = versions.filter(version => version >= min && version <= max);
+        const [highestVersion] = inRangeVersions.sort((a, b) => b - a);
+        return highestVersion;
+    }
     async init(clientType = client_1.ClientType.NONE, cookie) {
         CookieStore_1.CookieStore.setCookie(cookie);
         const initialAccessToken = await this.transport.http.refreshAccessToken();

package/lib/Config.d.ts

@@ -3,4 +3,5 @@ export interface Config {
     urls: BackendData;
     headers?: Record<string, string>;
 }
+export declare const MINIMUM_API_VERSION = 8;
 //# sourceMappingURL=Config.d.ts.map

package/lib/Config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../src/Config.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAC,WAAW,EAAC,MAAM,QAAQ,CAAC;AAEnC,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC"}
+{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../src/Config.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAC,WAAW,EAAC,MAAM,QAAQ,CAAC;AAEnC,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,eAAO,MAAM,mBAAmB,IAAI,CAAC"}

package/lib/Config.js

@@ -18,3 +18,5 @@
  *
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MINIMUM_API_VERSION = void 0;
+exports.MINIMUM_API_VERSION = 8;

package/lib/cells/CellsAPI.d.ts

@@ -118,6 +118,7 @@ export declare class CellsAPI {
         uuid: string;
         tags: string[];
     }): Promise<RestNode>;
+    private transformTagsToJson;
 }
 export {};
 //# sourceMappingURL=CellsAPI.d.ts.map

package/lib/cells/CellsAPI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CellsAPI.d.ts","sourceRoot":"","sources":["../../src/cells/CellsAPI.ts"],"names":[],"mappings":"AAmBA,OAAO,EAGL,uBAAuB,EACvB,yBAAyB,EACzB,QAAQ,EACR,kBAAkB,EAClB,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,yBAAyB,EACzB,2BAA2B,EAC5B,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAC,YAAY,EAAC,MAAM,6BAA6B,CAAC;AAGzD,OAAO,EAAC,gBAAgB,EAAC,MAAM,SAAS,CAAC;AACzC,OAAO,EAAC,UAAU,EAAC,MAAM,SAAS,CAAC;AAEnC,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,CAAC;AAO3C,UAAU,WAAW;IACnB,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,EAAE,EAAE;QACF,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,MAAM,CAAwB;gBAE1B,EACV,gBAAgB,EAChB,gBAAgB,GACjB,EAAE;QACD,gBAAgB,EAAE,gBAAgB,CAAC;QACnC,gBAAgB,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;KACxC;IAOD,UAAU,CAAC,EACT,WAAW,EACX,UAAU,EACV,cAAc,GACf,EAAE;QACD,WAAW,EAAE,WAAW,CAAC;QACzB,UAAU,CAAC,EAAE,UAAU,CAAC;QACxB,cAAc,CAAC,EAAE,YAAY,CAAC;KAC/B;IAgBK,eAAe,CAAC,EACpB,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,UAAiB,EACjB,gBAAgB,EAChB,eAAe,GAChB,EAAE;QACD,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,IAAI,CAAC;QACX,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;QAC9C,eAAe,CAAC,EAAE,eAAe,CAAC;KACnC,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA8B9B,gBAAgB,CAAC,EAAC,IAAI,EAAE,SAAS,EAAC,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAU3G,eAAe,CAAC,EAAC,IAAI,EAAE,SAAS,EAAC,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAUzG,UAAU,CAAC,EACf,IAAI,EACJ,WAAmB,GACpB,EAAE;QACD,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAahC,QAAQ,CAAC,EACb,WAAW,EACX,UAAU,GACX,EAAE;QACD,WAAW,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;QACrC,UAAU,EAAE,yBAAyB,CAAC,YAAY,CAAC,CAAC;KACrD,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAehC,WAAW,CAAC,EAAC,IAAI,EAAC,EAAE;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAUvE,UAAU,CAAC,EAAC,WAAW,EAAE,OAAO,EAAC,EAAE;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAkB9G,gBAAgB,CAAC,EAAC,IAAI,EAAC,EAAE;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAmBvE,gBAAgB,CAAC,EAAC,IAAI,EAAC,EAAE;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAmBvE,eAAe,CAAC,EAAC,IAAI,EAAC,EAAE;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC;IAU3E,OAAO,CAAC,EAAC,EAAE,EAAC,EAAE;QAAC,EAAE,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;IAU9C,WAAW,CAAC,EAChB,IAAI,EACJ,KAAqB,EACrB,MAAuB,EACvB,MAAM,EACN,aAAa,EACb,IAAI,EACJ,OAAe,GAChB,EAAE;QACD,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,aAAa,CAAC;QAC9B,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAyBzB,WAAW,CAAC,EAChB,MAAM,EACN,KAAqB,EACrB,MAAuB,EACvB,MAAM,EACN,aAAa,EACb,IAAI,EACJ,IAAI,EACJ,OAAe,GAChB,EAAE;QACD,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,aAAa,CAAC;QAC9B,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GAAG,OAAO,CAAC,kBAAkB,CAAC;YA2BjB,UAAU;IA6BlB,UAAU,CAAC,EACf,IAAI,EACJ,IAAI,EACJ,SAAS,GACV,EAAE;QACD,IAAI,EAAE,WAAW,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3C,IAAI,EAAE,WAAW,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC,CAAC;QACpD,SAAS,EAAE,WAAW,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC;KACvD,GAAG,OAAO,CAAC,kBAAkB,CAAC;IASzB,YAAY,CAAC,EACjB,IAAI,EACJ,IAAI,GACL,EAAE;QACD,IAAI,EAAE,WAAW,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3C,IAAI,EAAE,WAAW,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC,CAAC;KACrD,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAQzB,oBAAoB,CAAC,EAAC,IAAI,EAAC,EAAE;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAUlF,oBAAoB,CAAC,EAAC,IAAI,EAAE,KAAK,EAAC,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAe3F,iBAAiB,CAAC,EAAC,IAAI,EAAC,EAAE;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAUjE,UAAU,IAAI,OAAO,CAAC,2BAA2B,CAAC;IAUlD,WAAW,CAAC,EAAC,IAAI,EAAE,IAAI,EAAC,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;CAgBnF"}
+{"version":3,"file":"CellsAPI.d.ts","sourceRoot":"","sources":["../../src/cells/CellsAPI.ts"],"names":[],"mappings":"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"}

package/lib/cells/CellsAPI.js

@@ -199,7 +199,7 @@ class CellsAPI {
                 Status: {
                     Deleted: deleted ? 'Only' : 'Not',
                 },
-                Metadata: tags?.length ? [{ Namespace: USER_META_TAGS_NAMESPACE, Term: tags.join(',') }] : [],
+                Metadata: tags?.length ? [{ Namespace: USER_META_TAGS_NAMESPACE, Term: this.transformTagsToJson(tags) }] : [],
             },
             Flags: ['WithPreSignedURLs'],
             Limit: `${limit}`,
@@ -282,11 +282,14 @@ class CellsAPI {
             MetaUpdates: [
                 {
                     Operation: tags.length > 0 ? 'PUT' : 'DELETE',
-                    UserMeta: { Namespace: USER_META_TAGS_NAMESPACE, JsonValue: JSON.stringify(tags.join(',')) },
+                    UserMeta: { Namespace: USER_META_TAGS_NAMESPACE, JsonValue: this.transformTagsToJson(tags) },
                 },
             ],
         });
         return result.data;
     }
+    transformTagsToJson(tags) {
+        return JSON.stringify(tags.join(','));
+    }
 }
 exports.CellsAPI = CellsAPI;

package/lib/client/RegisteredClient.d.ts

@@ -1,4 +1,4 @@
-import { ClientType, Location, MLSPublicKeyRecord, PublicClient } from './';
+import { ClientCapability, ClientType, Location, MLSPublicKeyRecord, PublicClient } from './';
 export interface AddedClient extends PublicClient {
     /** The IP address from which the client was registered */
     address?: string;
@@ -13,6 +13,7 @@ export interface AddedClient extends PublicClient {
 }
 export interface RegisteredClient extends AddedClient {
     /** The cookie label */
+    capabilities: ClientCapability[];
     cookie: string;
 }
 //# sourceMappingURL=RegisteredClient.d.ts.map

package/lib/client/RegisteredClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RegisteredClient.d.ts","sourceRoot":"","sources":["../../src/client/RegisteredClient.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAC,UAAU,EAAE,QAAQ,EAAE,kBAAkB,EAAE,YAAY,EAAC,MAAM,IAAI,CAAC;AAE1E,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;IAClD,eAAe,EAAE,kBAAkB,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"RegisteredClient.d.ts","sourceRoot":"","sources":["../../src/client/RegisteredClient.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAC,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAE,kBAAkB,EAAE,YAAY,EAAC,MAAM,IAAI,CAAC;AAE5F,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;IAClD,eAAe,EAAE,kBAAkB,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,uBAAuB;IACvB,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/lib/notification/ConsumableNotification.d.ts

@@ -0,0 +1,202 @@
+import { z } from 'zod';
+import { BackendEvent } from '../event';
+/**
+ * Enum of all possible consumable notification types received via WebSocket.
+ * Now fully aligned with backend naming conventions.
+ */
+export declare enum ConsumableEvent {
+    EVENT = "event",
+    MISSED = "notifications_missed",
+    MESSAGE_COUNT = "message_count"
+}
+/**
+ * Notification type received when the client has missed messages due to being offline too long.
+ * Requires a full re-sync before consuming more notifications.
+ * TODO: when BackendEvent is typed in zod use:
+ * export type ConsumableNotificationMissed = z.infer<typeof ConsumableNotificationMissedSchema>;
+ */
+export interface ConsumableNotificationMissed {
+    type: ConsumableEvent.MISSED;
+}
+/**
+ * Notification type for actual backend events, contains one or more event payloads.
+ * Includes a delivery tag for acknowledgment.
+ * TODO: when BackendEvent is typed in zod use:
+ * export type ConsumableNotificationEvent = z.infer<typeof ConsumableNotificationEventSchema>;
+ */
+export interface ConsumableNotificationEvent {
+    type: ConsumableEvent.EVENT;
+    data: {
+        delivery_tag: number;
+        event: {
+            id: string;
+            payload: BackendEvent[];
+        };
+    };
+}
+/**
+ * Notification sent after connecting to indicate current number of messages queued.
+ * TODO: when BackendEvent is typed in zod use:
+ * export type ConsumableNotificationMessageCount = z.infer<typeof ConsumableNotificationMessageCountSchema>;
+ */
+export interface ConsumableNotificationMessageCount {
+    type: ConsumableEvent.MESSAGE_COUNT;
+    data: {
+        count: number;
+    };
+}
+/**
+ * Union of all valid notification types supported by the WebSocket backend.
+ * TODO: when BackendEvent is typed in zod use:
+ * export const ConsumableNotificationSchema = z.discriminatedUnion('type', [
+    ConsumableNotificationMissedSchema,
+    ConsumableNotificationEventSchema,
+    ConsumableNotificationMessageCountSchema,
+  ]);
+ */
+export type ConsumableNotification = ConsumableNotificationMissed | ConsumableNotificationEvent | ConsumableNotificationMessageCount;
+export declare const ConsumableNotificationMissedSchema: z.ZodObject<{
+    type: z.ZodLiteral<ConsumableEvent.MISSED>;
+}, "strip", z.ZodTypeAny, {
+    type: ConsumableEvent.MISSED;
+}, {
+    type: ConsumableEvent.MISSED;
+}>;
+export declare const ConsumableNotificationEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<ConsumableEvent.EVENT>;
+    data: z.ZodObject<{
+        delivery_tag: z.ZodNumber;
+        event: z.ZodObject<{
+            id: z.ZodString;
+            payload: z.ZodArray<z.ZodUnknown, "many">;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            payload: unknown[];
+        }, {
+            id: string;
+            payload: unknown[];
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        event: {
+            id: string;
+            payload: unknown[];
+        };
+        delivery_tag: number;
+    }, {
+        event: {
+            id: string;
+            payload: unknown[];
+        };
+        delivery_tag: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: ConsumableEvent.EVENT;
+    data: {
+        event: {
+            id: string;
+            payload: unknown[];
+        };
+        delivery_tag: number;
+    };
+}, {
+    type: ConsumableEvent.EVENT;
+    data: {
+        event: {
+            id: string;
+            payload: unknown[];
+        };
+        delivery_tag: number;
+    };
+}>;
+export declare const ConsumableNotificationMessageCountSchema: z.ZodObject<{
+    type: z.ZodLiteral<ConsumableEvent.MESSAGE_COUNT>;
+    data: z.ZodObject<{
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        count: number;
+    }, {
+        count: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: ConsumableEvent.MESSAGE_COUNT;
+    data: {
+        count: number;
+    };
+}, {
+    type: ConsumableEvent.MESSAGE_COUNT;
+    data: {
+        count: number;
+    };
+}>;
+export declare const ConsumableNotificationSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<ConsumableEvent.MISSED>;
+}, "strip", z.ZodTypeAny, {
+    type: ConsumableEvent.MISSED;
+}, {
+    type: ConsumableEvent.MISSED;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<ConsumableEvent.EVENT>;
+    data: z.ZodObject<{
+        delivery_tag: z.ZodNumber;
+        event: z.ZodObject<{
+            id: z.ZodString;
+            payload: z.ZodArray<z.ZodUnknown, "many">;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            payload: unknown[];
+        }, {
+            id: string;
+            payload: unknown[];
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        event: {
+            id: string;
+            payload: unknown[];
+        };
+        delivery_tag: number;
+    }, {
+        event: {
+            id: string;
+            payload: unknown[];
+        };
+        delivery_tag: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: ConsumableEvent.EVENT;
+    data: {
+        event: {
+            id: string;
+            payload: unknown[];
+        };
+        delivery_tag: number;
+    };
+}, {
+    type: ConsumableEvent.EVENT;
+    data: {
+        event: {
+            id: string;
+            payload: unknown[];
+        };
+        delivery_tag: number;
+    };
+}>, z.ZodObject<{
+    type: z.ZodLiteral<ConsumableEvent.MESSAGE_COUNT>;
+    data: z.ZodObject<{
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        count: number;
+    }, {
+        count: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: ConsumableEvent.MESSAGE_COUNT;
+    data: {
+        count: number;
+    };
+}, {
+    type: ConsumableEvent.MESSAGE_COUNT;
+    data: {
+        count: number;
+    };
+}>]>;
+//# sourceMappingURL=ConsumableNotification.d.ts.map

package/lib/notification/ConsumableNotification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsumableNotification.d.ts","sourceRoot":"","sources":["../../src/notification/ConsumableNotification.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,OAAO,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAEtC;;;GAGG;AACH,oBAAY,eAAe;IACzB,KAAK,UAAU;IACf,MAAM,yBAAyB;IAC/B,aAAa,kBAAkB;CAChC;AAED;;;;;GAKG;AACH,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC;IAC5B,IAAI,EAAE;QACJ,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE;YACL,EAAE,EAAE,MAAM,CAAC;YACX,OAAO,EAAE,YAAY,EAAE,CAAC;SACzB,CAAC;KACH,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,kCAAkC;IACjD,IAAI,EAAE,eAAe,CAAC,aAAa,CAAC;IACpC,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAC9B,4BAA4B,GAC5B,2BAA2B,GAC3B,kCAAkC,CAAC;AAOvC,eAAO,MAAM,kCAAkC;;;;;;EAE7C,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM5C,CAAC;AAEH,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;EAKnD,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIvC,CAAC"}

package/lib/notification/ConsumableNotification.js

@@ -0,0 +1,57 @@
+"use strict";
+/*
+ * Wire
+ * Copyright (C) 2025 Wire Swiss GmbH
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see http://www.gnu.org/licenses/.
+ *
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsumableNotificationSchema = exports.ConsumableNotificationMessageCountSchema = exports.ConsumableNotificationEventSchema = exports.ConsumableNotificationMissedSchema = exports.ConsumableEvent = void 0;
+const zod_1 = require("zod");
+/**
+ * Enum of all possible consumable notification types received via WebSocket.
+ * Now fully aligned with backend naming conventions.
+ */
+var ConsumableEvent;
+(function (ConsumableEvent) {
+    ConsumableEvent["EVENT"] = "event";
+    ConsumableEvent["MISSED"] = "notifications_missed";
+    ConsumableEvent["MESSAGE_COUNT"] = "message_count";
+})(ConsumableEvent || (exports.ConsumableEvent = ConsumableEvent = {}));
+const BackendEventSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    payload: zod_1.z.array(zod_1.z.unknown()), // TODO: Replace `z.any()` with BackendEvent schema when available
+});
+exports.ConsumableNotificationMissedSchema = zod_1.z.object({
+    type: zod_1.z.literal(ConsumableEvent.MISSED),
+});
+exports.ConsumableNotificationEventSchema = zod_1.z.object({
+    type: zod_1.z.literal(ConsumableEvent.EVENT),
+    data: zod_1.z.object({
+        delivery_tag: zod_1.z.number(),
+        event: BackendEventSchema,
+    }),
+});
+exports.ConsumableNotificationMessageCountSchema = zod_1.z.object({
+    type: zod_1.z.literal(ConsumableEvent.MESSAGE_COUNT),
+    data: zod_1.z.object({
+        count: zod_1.z.number(),
+    }),
+});
+exports.ConsumableNotificationSchema = zod_1.z.discriminatedUnion('type', [
+    exports.ConsumableNotificationMissedSchema,
+    exports.ConsumableNotificationEventSchema,
+    exports.ConsumableNotificationMessageCountSchema,
+]);

package/lib/notification/NotificationAPI/NotificationAPI.d.ts

@@ -24,14 +24,14 @@ export declare class NotificationAPI {
      * @param since Only return notifications more recent than this.
      * @see https://staging-nginz-https.zinfra.io/swagger-ui/#!/push/fetchNotifications
      */
-    getNotifications(clientId?: string, size?: number, since?: string, abortController?: AbortController): Promise<NotificationList>;
+    getNotifications(clientId?: string, size?: number, since?: string): Promise<NotificationList>;
     /**
      * Fetch all notifications.
      * @param clientId Only return notifications targeted at the given client
      * @param lastNotificationId Only return notifications more recent than this
      * @see https://staging-nginz-https.zinfra.io/swagger-ui/#!/push/fetchNotifications
      */
-    getAllNotifications(clientId?: string, lastNotificationId?: string, abortController?: AbortController): Promise<NotificationsReponse>;
+    getAllNotifications(clientId?: string, lastNotificationId?: string): Promise<NotificationsReponse>;
     /**
      * Fetch a notification by ID.
      * @see https://staging-nginz-https.zinfra.io/swagger-ui/#!/push/getNotification

package/lib/notification/NotificationAPI/NotificationAPI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NotificationAPI.d.ts","sourceRoot":"","sources":["../../../src/notification/NotificationAPI/NotificationAPI.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAC,YAAY,EAAE,gBAAgB,EAAC,MAAM,IAAI,CAAC;AAClD,OAAO,EAAkC,UAAU,EAAa,MAAM,YAAY,CAAC;AAEnF,eAAO,MAAM,yBAAyB,QAAQ,CAAC;AAE/C,KAAK,oBAAoB,GAAG;IAC1B,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,gBAAuB,GAAG;;;MAGxB;IAEF;;;OAGG;IACU,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAa1E;;;;;;OAMG;IACU,gBAAgB,CAC3B,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,GAAE,MAAkC,EACxC,KAAK,CAAC,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,eAAe,GAChC,OAAO,CAAC,gBAAgB,CAAC;IAe5B;;;;;OAKG;IACU,mBAAmB,CAC9B,QAAQ,CAAC,EAAE,MAAM,EACjB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,eAAe,CAAC,EAAE,eAAe,GAChC,OAAO,CAAC,oBAAoB,CAAC;IA0EhC;;;OAGG;IACU,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAY/F"}
+{"version":3,"file":"NotificationAPI.d.ts","sourceRoot":"","sources":["../../../src/notification/NotificationAPI/NotificationAPI.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAC,YAAY,EAAE,gBAAgB,EAAC,MAAM,IAAI,CAAC;AAClD,OAAO,EAAkC,UAAU,EAAa,MAAM,YAAY,CAAC;AAEnF,eAAO,MAAM,yBAAyB,QAAQ,CAAC;AAE/C,KAAK,oBAAoB,GAAG;IAC1B,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,gBAAuB,GAAG;;;MAGxB;IAEF;;;OAGG;IACU,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAa1E;;;;;;OAMG;IACU,gBAAgB,CAC3B,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,GAAE,MAAkC,EACxC,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC;IAe5B;;;;;OAKG;IACU,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAqE/G;;;OAGG;IACU,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAY/F"}

package/lib/notification/NotificationAPI/NotificationAPI.js

@@ -56,7 +56,7 @@ class NotificationAPI {
      * @param since Only return notifications more recent than this.
      * @see https://staging-nginz-https.zinfra.io/swagger-ui/#!/push/fetchNotifications
      */
-    async getNotifications(clientId, size = exports.NOTIFICATION_SIZE_MAXIMUM, since, abortController) {
+    async getNotifications(clientId, size = exports.NOTIFICATION_SIZE_MAXIMUM, since) {
         const config = {
             method: 'get',
             params: {
@@ -66,7 +66,7 @@ class NotificationAPI {
             },
             url: NotificationAPI.URL.NOTIFICATION,
         };
-        const response = await this.client.sendJSON(config, false, abortController);
+        const response = await this.client.sendJSON(config, false);
         return response.data;
     }
     /**
@@ -75,7 +75,7 @@ class NotificationAPI {
      * @param lastNotificationId Only return notifications more recent than this
      * @see https://staging-nginz-https.zinfra.io/swagger-ui/#!/push/fetchNotifications
      */
-    async getAllNotifications(clientId, lastNotificationId, abortController) {
+    async getAllNotifications(clientId, lastNotificationId) {
         const getNotificationChunks = async (notificationList, currentClientId, currentNotificationId) => {
             const defaultPayload = {
                 notifications: [],
@@ -85,7 +85,7 @@ class NotificationAPI {
             let payload = { ...defaultPayload };
             let hasMissedNotifications = false;
             try {
-                payload = await this.getNotifications(currentClientId, exports.NOTIFICATION_SIZE_MAXIMUM, currentNotificationId, abortController);
+                payload = await this.getNotifications(currentClientId, exports.NOTIFICATION_SIZE_MAXIMUM, currentNotificationId);
             }
             catch (error) {
                 const isAxiosError = axios_1.default.isAxiosError(error);

package/lib/tcp/AcknowledgeEvent.types.d.ts

@@ -0,0 +1,14 @@
+export interface AcknowledgeEvent {
+    type: AcknowledgeType;
+    data?: AcknowledgeData;
+}
+export interface AcknowledgeData {
+    delivery_tag: number;
+    multiple: boolean;
+}
+export declare enum AcknowledgeType {
+    ACK = "ack",
+    ACK_MESSAGE_COUNT = "ack_message_count",
+    ACK_FULL_SYNC = "ack_full_sync"
+}
+//# sourceMappingURL=AcknowledgeEvent.types.d.ts.map

package/lib/tcp/AcknowledgeEvent.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcknowledgeEvent.types.d.ts","sourceRoot":"","sources":["../../src/tcp/AcknowledgeEvent.types.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,oBAAY,eAAe;IACzB,GAAG,QAAQ;IACX,iBAAiB,sBAAsB;IACvC,aAAa,kBAAkB;CAChC"}

package/lib/tcp/AcknowledgeEvent.types.js

@@ -0,0 +1,27 @@
+"use strict";
+/*
+ * Wire
+ * Copyright (C) 2025 Wire Swiss GmbH
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see http://www.gnu.org/licenses/.
+ *
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AcknowledgeType = void 0;
+var AcknowledgeType;
+(function (AcknowledgeType) {
+    AcknowledgeType["ACK"] = "ack";
+    AcknowledgeType["ACK_MESSAGE_COUNT"] = "ack_message_count";
+    AcknowledgeType["ACK_FULL_SYNC"] = "ack_full_sync";
+})(AcknowledgeType || (exports.AcknowledgeType = AcknowledgeType = {}));

package/lib/tcp/ReconnectingWebsocket.d.ts

@@ -11,25 +11,16 @@ export declare enum WEBSOCKET_STATE {
     CLOSING = 2,
     CLOSED = 3
 }
-export declare enum PingMessage {
-    PING = "ping",
-    PONG = "pong"
-}
 export declare class ReconnectingWebsocket {
     private readonly onReconnect;
     private static readonly RECONNECTING_OPTIONS;
     private readonly logger;
     private socket?;
-    private pingerId?;
-    private readonly PING_INTERVAL;
-    private hasUnansweredPing;
     private onOpen?;
     private onMessage?;
     private onError?;
     private onClose?;
-    constructor(onReconnect: () => Promise<string>, options?: {
-        pingInterval?: number;
-    });
+    constructor(onReconnect: () => Promise<string>);
     private readonly internalOnError;
     private readonly internalOnMessage;
     private readonly internalOnOpen;
@@ -37,9 +28,6 @@ export declare class ReconnectingWebsocket {
     private readonly internalOnClose;
     connect(): void;
     send(message: any): void;
-    private startPinging;
-    private stopPinging;
-    private readonly sendPing;
     getState(): WEBSOCKET_STATE;
     disconnect(reason?: string): void;
     private getReconnectingWebsocket;

package/lib/tcp/ReconnectingWebsocket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReconnectingWebsocket.d.ts","sourceRoot":"","sources":["../../src/tcp/ReconnectingWebsocket.ts"],"names":[],"mappings":"AAoBA,OAAY,EAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAU,MAAM,wBAAwB,CAAC;AAQnF,oBAAY,cAAc;IACxB,cAAc,OAAO;IACrB,UAAU,OAAO;IACjB,cAAc,OAAO;IACrB,gBAAgB,OAAO;CACxB;AAED,oBAAY,eAAe;IACzB,UAAU,IAAI;IACd,IAAI,IAAI;IACR,OAAO,IAAI;IACX,MAAM,IAAI;CACX;AAED,oBAAY,WAAW;IACrB,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED,qBAAa,qBAAqB;IAuB9B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAtB9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAQ1C;IAEF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,MAAM,CAAC,CAAM;IACrB,OAAO,CAAC,QAAQ,CAAC,CAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqC;IACnE,OAAO,CAAC,iBAAiB,CAAU;IAEnC,OAAO,CAAC,MAAM,CAAC,CAAyB;IACxC,OAAO,CAAC,SAAS,CAAC,CAAyB;IAC3C,OAAO,CAAC,OAAO,CAAC,CAA8B;IAC9C,OAAO,CAAC,OAAO,CAAC,CAA8B;gBAG3B,WAAW,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EACnD,OAAO,GAAE;QACP,YAAY,CAAC,EAAE,MAAM,CAAC;KAClB;IA2BR,OAAO,CAAC,QAAQ,CAAC,eAAe,CAK9B;IAEF,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAUhC;IAEF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAQ7B;IAEF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAMlC;IAEF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAM9B;IAEK,OAAO,IAAI,IAAI;IASf,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAM/B,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAWvB;IAEK,QAAQ,IAAI,eAAe;IAI3B,UAAU,CAAC,MAAM,SAAqB,GAAG,IAAI;IAOpD,OAAO,CAAC,wBAAwB;IAIzB,SAAS,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAI/C,YAAY,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIrD,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAItD,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;CAG9D"}
+{"version":3,"file":"ReconnectingWebsocket.d.ts","sourceRoot":"","sources":["../../src/tcp/ReconnectingWebsocket.ts"],"names":[],"mappings":"AAoBA,OAAY,EAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAU,MAAM,wBAAwB,CAAC;AAQnF,oBAAY,cAAc;IACxB,cAAc,OAAO;IACrB,UAAU,OAAO;IACjB,cAAc,OAAO;IACrB,gBAAgB,OAAO;CACxB;AAED,oBAAY,eAAe;IACzB,UAAU,IAAI;IACd,IAAI,IAAI;IACR,OAAO,IAAI;IACX,MAAM,IAAI;CACX;AAED,qBAAa,qBAAqB;IAmBpB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAlBxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAQ1C;IAEF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,MAAM,CAAC,CAAM;IAErB,OAAO,CAAC,MAAM,CAAC,CAAyB;IACxC,OAAO,CAAC,SAAS,CAAC,CAAyB;IAC3C,OAAO,CAAC,OAAO,CAAC,CAA8B;IAC9C,OAAO,CAAC,OAAO,CAAC,CAA8B;gBAEjB,WAAW,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC;IAmB/D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAK9B;IAEF,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAQhC;IAEF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAQ7B;IAEF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAGlC;IAEF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAK9B;IAEK,OAAO,IAAI,IAAI;IAQf,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAIxB,QAAQ,IAAI,eAAe;IAI3B,UAAU,CAAC,MAAM,SAAqB,GAAG,IAAI;IAOpD,OAAO,CAAC,wBAAwB;IAIzB,SAAS,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAI/C,YAAY,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIrD,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAItD,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;CAG9D"}

package/lib/tcp/ReconnectingWebsocket.js

@@ -44,7 +44,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReconnectingWebsocket = exports.PingMessage = exports.WEBSOCKET_STATE = exports.CloseEventCode = void 0;
+exports.ReconnectingWebsocket = exports.WEBSOCKET_STATE = exports.CloseEventCode = void 0;
 const reconnecting_websocket_1 = __importDefault(require("reconnecting-websocket"));
 const commons_1 = require("@wireapp/commons");
 const buffer = __importStar(require("../shims/node/buffer"));
@@ -64,11 +64,6 @@ var WEBSOCKET_STATE;
     WEBSOCKET_STATE[WEBSOCKET_STATE["CLOSING"] = 2] = "CLOSING";
     WEBSOCKET_STATE[WEBSOCKET_STATE["CLOSED"] = 3] = "CLOSED";
 })(WEBSOCKET_STATE || (exports.WEBSOCKET_STATE = WEBSOCKET_STATE = {}));
-var PingMessage;
-(function (PingMessage) {
-    PingMessage["PING"] = "ping";
-    PingMessage["PONG"] = "pong";
-})(PingMessage || (exports.PingMessage = PingMessage = {}));
 class ReconnectingWebsocket {
     onReconnect;
     static RECONNECTING_OPTIONS = {
@@ -82,20 +77,13 @@ class ReconnectingWebsocket {
     };
     logger;
     socket;
-    pingerId;
-    PING_INTERVAL = commons_1.TimeUtil.TimeInMillis.SECOND * 20;
-    hasUnansweredPing;
     onOpen;
     onMessage;
     onError;
     onClose;
-    constructor(onReconnect, options = {}) {
+    constructor(onReconnect) {
         this.onReconnect = onReconnect;
         this.logger = commons_1.LogFactory.getLogger('@wireapp/api-client/tcp/ReconnectingWebsocket');
-        if (options.pingInterval) {
-            this.PING_INTERVAL = options.pingInterval;
-        }
-        this.hasUnansweredPing = false;
         /**
          * According to https://developer.mozilla.org/en-US/docs/Web/API/Navigator/onLine, navigator.onLine attribute and 'online' and 'offline' events are not reliable enough (especially when it's truthy).
          * We won't receive the 'offline' event when the system goes to sleep (e.g. closing the lid of a laptop).
@@ -121,11 +109,7 @@ class ReconnectingWebsocket {
     internalOnMessage = (event) => {
         this.logger.debug('Incoming message');
         const data = buffer.bufferToString(event.data);
-        if (data === PingMessage.PONG) {
-            this.logger.debug('Received pong from WebSocket');
-            this.hasUnansweredPing = false;
-        }
-        else if (this.onMessage) {
+        if (this.onMessage) {
             this.onMessage(data);
         }
     };
@@ -140,14 +124,10 @@ class ReconnectingWebsocket {
     };
     internalOnReconnect = async () => {
         this.logger.debug('Connecting to WebSocket');
-        // The ping is needed to keep the connection alive as long as possible.
-        // Otherwise the connection would be closed after 1 min of inactivity and re-established.
-        this.startPinging();
         return this.onReconnect();
     };
     internalOnClose = (event) => {
-        this.logger.debug('WebSocket closed');
-        this.stopPinging();
+        this.logger.debug(`WebSocket closed with code: ${event?.code}${event?.reason ? `Reason: ${event?.reason}` : ''}`);
         if (this.onClose) {
             this.onClose(event);
         }
@@ -160,32 +140,8 @@ class ReconnectingWebsocket {
         this.socket.onclose = this.internalOnClose;
     }
     send(message) {
-        if (this.socket) {
-            this.socket.send(message);
-        }
-    }
-    startPinging() {
-        this.stopPinging();
-        this.hasUnansweredPing = false;
-        this.pingerId = setInterval(this.sendPing, this.PING_INTERVAL);
+        this.socket?.send(message);
     }
-    stopPinging() {
-        if (this.pingerId) {
-            clearInterval(this.pingerId);
-        }
-    }
-    sendPing = () => {
-        if (this.socket) {
-            if (this.hasUnansweredPing) {
-                this.logger.warn('Ping interval check failed');
-                this.stopPinging();
-                this.socket.reconnect();
-                return;
-            }
-            this.hasUnansweredPing = true;
-            this.send(PingMessage.PING);
-        }
-    };
     getState() {
         return this.socket ? this.socket.readyState : WEBSOCKET_STATE.CLOSED;
     }

package/lib/tcp/WebSocketClient.d.ts

@@ -3,7 +3,7 @@ import { EventEmitter } from 'events';
 import { WEBSOCKET_STATE } from './ReconnectingWebsocket';
 import { InvalidTokenError, MissingCookieError } from '../auth/';
 import { HttpClient } from '../http/';
-import { Notification } from '../notification/';
+import { ConsumableNotification, ConsumableNotificationEvent } from '../notification/ConsumableNotification';
 declare enum TOPIC {
     ON_ERROR = "WebSocketClient.TOPIC.ON_ERROR",
     ON_INVALID_TOKEN = "WebSocketClient.TOPIC.ON_INVALID_TOKEN",
@@ -13,10 +13,10 @@ declare enum TOPIC {
 export interface WebSocketClient {
     on(event: TOPIC.ON_ERROR, listener: (error: Error | ErrorEvent) => void): this;
     on(event: TOPIC.ON_INVALID_TOKEN, listener: (error: InvalidTokenError | MissingCookieError) => void): this;
-    on(event: TOPIC.ON_MESSAGE, listener: (notification: Notification) => void): this;
+    on(event: TOPIC.ON_MESSAGE, listener: (notification: ConsumableNotification) => void): this;
     on(event: TOPIC.ON_STATE_CHANGE, listener: (state: WEBSOCKET_STATE) => void): this;
 }
-export type OnConnect = (abortHandler: AbortController) => Promise<void>;
+export type OnConnect = (abortHandler: AbortController) => void;
 export declare class WebSocketClient extends EventEmitter {
     private clientId?;
     private isRefreshingAccessToken;
@@ -28,8 +28,10 @@ export declare class WebSocketClient extends EventEmitter {
     private isSocketLocked;
     private bufferedMessages;
     private abortHandler?;
+    private versionPrefix;
     static readonly TOPIC: typeof TOPIC;
     constructor(baseUrl: string, client: HttpClient);
+    useVersion(version: number): void;
     private onStateChange;
     private readonly onMessage;
     private readonly onError;
@@ -66,6 +68,9 @@ export declare class WebSocketClient extends EventEmitter {
     readonly lock: () => void;
     isLocked(): boolean;
     private buildWebSocketUrl;
+    acknowledgeMissedNotification(): void;
+    acknowledgeMessageCountNotification(): void;
+    acknowledgeNotification(notification: ConsumableNotificationEvent): void;
 }
 export {};
 //# sourceMappingURL=WebSocketClient.d.ts.map

package/lib/tcp/WebSocketClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebSocketClient.d.ts","sourceRoot":"","sources":["../../src/tcp/WebSocketClient.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAC,UAAU,EAAC,MAAM,wBAAwB,CAAC;AAElD,OAAO,EAAC,YAAY,EAAC,MAAM,QAAQ,CAAC;AAIpC,OAAO,EAAwB,eAAe,EAAC,MAAM,yBAAyB,CAAC;AAE/E,OAAO,EAAC,iBAAiB,EAA8B,kBAAkB,EAAC,MAAM,UAAU,CAAC;AAC3F,OAAO,EAAC,UAAU,EAAe,MAAM,UAAU,CAAC;AAClD,OAAO,EAAC,YAAY,EAAC,MAAM,kBAAkB,CAAC;AAE9C,aAAK,KAAK;IACR,QAAQ,mCAAmC;IAC3C,gBAAgB,2CAA2C;IAC3D,UAAU,qCAAqC;IAC/C,eAAe,0CAA0C;CAC1D;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/E,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,gBAAgB,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3G,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI,CAAC;IAClF,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,eAAe,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI,CAAC;CACpF;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,YAAY,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzE,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,uBAAuB,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,cAAc,CAAkB;IACjC,MAAM,EAAE,UAAU,CAAC;IAC1B,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,gBAAgB,CAAW;IACnC,OAAO,CAAC,YAAY,CAAC,CAAkB;IAEvC,gBAAuB,KAAK,eAAS;gBAEzB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU;IAc/C,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAOxB;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAItB;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAM1B;IAEF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAErB;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAItB;IAEF;;;;;;;;;;;OAWG;IACI,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,eAAe;YAmB3D,kBAAkB;IA8BzB,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAMxC;;;;OAIG;IACH,SAAgB,MAAM,aAOpB;IAEF;;;;;OAKG;IACH,SAAgB,IAAI,aAGlB;IAEK,QAAQ,IAAI,OAAO;IAI1B,OAAO,CAAC,iBAAiB;CAc1B"}
+{"version":3,"file":"WebSocketClient.d.ts","sourceRoot":"","sources":["../../src/tcp/WebSocketClient.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAC,UAAU,EAAC,MAAM,wBAAwB,CAAC;AAElD,OAAO,EAAC,YAAY,EAAC,MAAM,QAAQ,CAAC;AAKpC,OAAO,EAAwB,eAAe,EAAC,MAAM,yBAAyB,CAAC;AAE/E,OAAO,EAAC,iBAAiB,EAA8B,kBAAkB,EAAC,MAAM,UAAU,CAAC;AAE3F,OAAO,EAAC,UAAU,EAAe,MAAM,UAAU,CAAC;AAClD,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAE5B,MAAM,wCAAwC,CAAC;AAEhD,aAAK,KAAK;IACR,QAAQ,mCAAmC;IAC3C,gBAAgB,2CAA2C;IAC3D,UAAU,qCAAqC;IAC/C,eAAe,0CAA0C;CAC1D;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/E,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,gBAAgB,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3G,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,YAAY,EAAE,sBAAsB,KAAK,IAAI,GAAG,IAAI,CAAC;IAC5F,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,eAAe,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI,CAAC;CACpF;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,YAAY,EAAE,eAAe,KAAK,IAAI,CAAC;AAEhE,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,uBAAuB,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,cAAc,CAAkB;IACjC,MAAM,EAAE,UAAU,CAAC;IAC1B,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,gBAAgB,CAAW;IACnC,OAAO,CAAC,YAAY,CAAC,CAAkB;IACvC,OAAO,CAAC,aAAa,CAAM;IAE3B,gBAAuB,KAAK,eAAS;gBAEzB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU;IAcxC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAOxC,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAOxB;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAItB;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAM1B;IAEF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAErB;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAItB;IAEF;;;;;;;;;;;OAWG;IACI,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,eAAe;YAmB3D,kBAAkB;IA8BzB,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAMxC;;;;OAIG;IACH,SAAgB,MAAM,aAOpB;IAEF;;;;;OAKG;IACH,SAAgB,IAAI,aAGlB;IAEK,QAAQ,IAAI,OAAO;IAI1B,OAAO,CAAC,iBAAiB;IAoBlB,6BAA6B;IAQ7B,mCAAmC;IAQnC,uBAAuB,CAAC,YAAY,EAAE,2BAA2B;CAgBzE"}

package/lib/tcp/WebSocketClient.js

@@ -21,9 +21,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebSocketClient = void 0;
 const events_1 = require("events");
 const commons_1 = require("@wireapp/commons");
+const AcknowledgeEvent_types_1 = require("./AcknowledgeEvent.types");
 const ReconnectingWebsocket_1 = require("./ReconnectingWebsocket");
 const auth_1 = require("../auth/");
+const Config_1 = require("../Config");
 const http_1 = require("../http/");
+const ConsumableNotification_1 = require("../notification/ConsumableNotification");
 var TOPIC;
 (function (TOPIC) {
     TOPIC["ON_ERROR"] = "WebSocketClient.TOPIC.ON_ERROR";
@@ -42,6 +45,7 @@ class WebSocketClient extends events_1.EventEmitter {
     isSocketLocked;
     bufferedMessages;
     abortHandler;
+    versionPrefix = '';
     static TOPIC = TOPIC;
     constructor(baseUrl, client) {
         super();
@@ -54,6 +58,12 @@ class WebSocketClient extends events_1.EventEmitter {
         this.websocketState = this.socket.getState();
         this.logger = commons_1.LogFactory.getLogger('@wireapp/api-client/tcp/WebSocketClient');
     }
+    useVersion(version) {
+        if (version < Config_1.MINIMUM_API_VERSION) {
+            throw new Error('Minium supported api version is 8 in order to connect to /events web socket endpoint');
+        }
+        this.versionPrefix = version > 0 ? `/v${version}` : '';
+    }
     onStateChange(newState) {
         if (newState !== this.websocketState) {
             this.websocketState = newState;
@@ -65,7 +75,7 @@ class WebSocketClient extends events_1.EventEmitter {
             this.bufferedMessages.push(data);
         }
         else {
-            const notification = JSON.parse(data);
+            const notification = ConsumableNotification_1.ConsumableNotificationSchema.parse(JSON.parse(data));
             this.emit(WebSocketClient.TOPIC.ON_MESSAGE, notification);
         }
     };
@@ -181,7 +191,10 @@ class WebSocketClient extends events_1.EventEmitter {
         if (!token) {
             this.logger.warn('Reconnecting WebSocket with unset token');
         }
-        let url = `${this.baseUrl}/await?access_token=${token}`;
+        if (!this.versionPrefix) {
+            throw new Error('Backend api version is not set to connect to web socket');
+        }
+        let url = `${this.baseUrl}${this.versionPrefix}/events?access_token=${token}`;
         if (this.clientId) {
             // Note: If no client ID is given, then the WebSocket connection will receive all notifications for all clients
             // of the connected user
@@ -189,5 +202,31 @@ class WebSocketClient extends events_1.EventEmitter {
         }
         return url;
     }
+    acknowledgeMissedNotification() {
+        const jsonEvent = JSON.stringify({
+            type: AcknowledgeEvent_types_1.AcknowledgeType.ACK_FULL_SYNC,
+        });
+        this.socket.send(jsonEvent);
+    }
+    acknowledgeMessageCountNotification() {
+        const jsonEvent = JSON.stringify({
+            type: AcknowledgeEvent_types_1.AcknowledgeType.ACK_MESSAGE_COUNT,
+        });
+        this.socket.send(jsonEvent);
+    }
+    acknowledgeNotification(notification) {
+        if (this.socket?.getState() !== WebSocket.OPEN) {
+            return;
+        }
+        const jsonEvent = JSON.stringify({
+            type: AcknowledgeEvent_types_1.AcknowledgeType.ACK,
+            data: {
+                delivery_tag: notification.data.delivery_tag,
+                // Note: this can be used when implementing batch proccessing
+                multiple: false,
+            },
+        });
+        this.socket.send(jsonEvent);
+    }
 }
 exports.WebSocketClient = WebSocketClient;

package/package.json

@@ -70,6 +70,6 @@
     "watch": "webpack serve --config webpack.browser.js",
     "prepare": "yarn dist"
   },
-  "version": "27.66.0",
-  "gitHead": "f8ef71b6324ed285409374a561e822127f488163"
+  "version": "27.67.1",
+  "gitHead": "e417cc7cd746d3d58ee03829bfe35b0122c361b7"
 }