@simplito/privmx-webendpoint 2.2.9 → 2.3.0

package/extra/PublicConnection.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PublicConnection = void 0;
+const _1 = require(".");
+const service_1 = require("../service");
+/**
+ * @class PublicConnection
+ * @classdesc A client for interacting with the PrivMX Endpoint API as a guest. The scope is limited to sending an entries to inboxes.
+ * @example
+ * // Initialize the PrivMX client
+ * await PrivmxClient.setup('/path/to/privmx/assets');
+ *
+ * // Connect to the PrivMX bridge
+ * const solutionId = 'your-solution-id';
+ * const bridgeUrl = 'https://your-bridge-url.com';
+ * const inboxId = 'your-inbox-id'
+ * const client = await PrivmxClient.connectPublic(solutionId, bridgeUrl);
+ *
+ * // Send entry
+ * const encoder = new TextEncoder();
+ * const encodedData = encoder.encode(JSON.stringify({ message: 'Hello, PrivMX!' }));
+ *
+ * await client.sendEntry(inboxId, {
+ *  data: encodedData
+ * })
+ *
+ * // Disconnect when done
+ * await client.disconnect();
+ */
+class PublicConnection {
+    connection;
+    threadApi = null;
+    storeApi = null;
+    inboxApi = null;
+    /**
+     * @constructor
+     * @param {Connection} connection - The connection object.
+     */
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /**
+     * @description Gets the connection object.
+     * @returns {Connection}
+     * @throws {Error} If there is no active connection.
+     */
+    getConnection() {
+        if (!this.connection) {
+            throw new Error('No active connection');
+        }
+        return this.connection;
+    }
+    /**
+     * @description Gets the Thread API.
+     * @returns {Promise<ThreadApi>}
+     */
+    getThreadApi() {
+        if (!this.threadApi) {
+            this.threadApi = (() => {
+                const connection = this.getConnection();
+                return service_1.EndpointFactory.createThreadApi(connection);
+            })();
+        }
+        return this.threadApi;
+    }
+    /**
+     * @description Gets the Store API.
+     * @returns {Promise<StoreApi>}
+     */
+    getStoreApi() {
+        if (!this.storeApi) {
+            this.storeApi = (async () => {
+                const connection = this.getConnection();
+                return service_1.EndpointFactory.createStoreApi(connection);
+            })();
+        }
+        return this.storeApi;
+    }
+    /**
+     * @description Gets the Inbox API.
+     * @returns {Promise<InboxApi>}
+     */
+    getInboxApi() {
+        if (!this.inboxApi) {
+            this.inboxApi = (async () => {
+                const connection = this.getConnection();
+                return service_1.EndpointFactory.createInboxApi(connection, await this.getThreadApi(), await this.getStoreApi());
+            })();
+        }
+        return this.inboxApi;
+    }
+    /**
+     * @description Disconnects from the PrivMX bridge.
+     * @returns {Promise<void>}
+     */
+    async disconnect() {
+        try {
+            await this.connection.disconnect();
+            this.threadApi = null;
+            this.storeApi = null;
+            this.inboxApi = null;
+        }
+        catch (e) {
+            console.error('Error during disconnection:', e);
+        }
+    }
+    /**
+     * @description Sends an entry to the specified inbox.
+     * @param {string} inboxId - The ID of the inbox to send the entry to.
+     * @param {InboxEntryPayload} payload - The payload of the entry to send.
+     * @returns {Promise<void>}
+     */
+    async sendEntry(inboxId, payload) {
+        const inboxApi = await this.getInboxApi();
+        return await _1.Inboxes.sendEntry(inboxApi, inboxId, payload);
+    }
+}
+exports.PublicConnection = PublicConnection;

package/extra/events.d.ts

@@ -33,7 +33,7 @@ export interface EventPayload {
         threadId: string;
     };
     threadNewMessage: Types.Message;
-    threadMessageUpdated: Types.Message;
+    threadUpdatedMessage: Types.Message;
     threadMessageDeleted: {
         threadId: string;
         messageId: string;
@@ -76,7 +76,7 @@ type EventHandler<E extends keyof EventPayload> = {
     event: E;
     callback: (event: GenericEvent<E>) => void;
 };
-export type OnMessageEventHandler = EventHandler<'threadMessageDeleted'> | EventHandler<'threadNewMessage'> | EventHandler<'threadMessageUpdated'>;
+export type OnMessageEventHandler = EventHandler<'threadMessageDeleted'> | EventHandler<'threadNewMessage'> | EventHandler<'threadUpdatedMessage'>;
 export type OnThreadEventHandler = EventHandler<'threadCreated'> | EventHandler<'threadDeleted'> | EventHandler<'threadUpdated'> | EventHandler<'threadStatsChanged'>;
 export type OnFileEventHandler = EventHandler<'storeFileDeleted'> | EventHandler<'storeFileCreated'> | EventHandler<'storeFileUpdated'>;
 export type OnStoreEventHandler = EventHandler<'storeCreated'> | EventHandler<'storeStatsChanged'> | EventHandler<'storeUpdated'> | EventHandler<'storeDeleted'>;

package/extra/inbox.d.ts

@@ -1,4 +1,4 @@
-import { Endpoint } from '..';
+import { InboxApi } from '..';
 /**
  * Represents payload that is sent to an Inbox.
  */
@@ -28,11 +28,11 @@ export interface InboxEntryPayload {
 /**
  * Sends an entry to the specified inbox.
  *
- * @param {Awaited<ReturnType<typeof Endpoint.createInboxApi>>} inboxApi - The API instance used to interact with the inbox.
+ * @param {InboxApi} inboxApi - The API instance used to interact with the inbox.
  * @param {string} inboxId - The ID of the target inbox where the entry will be sent.
  * @param {InboxEntryPayload} payload - The data payload for the inbox entry, including files, metadata, and other information.
  *
  * @returns {Promise<void>} A promise that resolves when the entry has been successfully sent.
  *
  */
-export declare function sendEntry(inboxApi: Awaited<ReturnType<typeof Endpoint.createInboxApi>>, inboxId: string, payload: InboxEntryPayload): Promise<void>;
+export declare function sendEntry(inboxApi: InboxApi, inboxId: string, payload: InboxEntryPayload): Promise<void>;

package/extra/inbox.js

@@ -5,7 +5,7 @@ const files_1 = require("./files");
 /**
  * Sends an entry to the specified inbox.
  *
- * @param {Awaited<ReturnType<typeof Endpoint.createInboxApi>>} inboxApi - The API instance used to interact with the inbox.
+ * @param {InboxApi} inboxApi - The API instance used to interact with the inbox.
  * @param {string} inboxId - The ID of the target inbox where the entry will be sent.
  * @param {InboxEntryPayload} payload - The data payload for the inbox entry, including files, metadata, and other information.
  *

package/extra/index.d.ts

@@ -1,8 +1,10 @@
-import * as Files from "./files";
-import * as Events from "./events";
-import { EventManager, ThreadEventsManager, StoreEventsManager, InboxEventsManager, BaseEventManager } from "./events";
-import * as Utils from "./utils";
-import * as Generics from "./generics";
-import * as Inboxes from "./inbox";
-import { FileUploader, StreamReader, downloadFile } from "./files";
-export { Files, Inboxes, Events, Utils, Generics, FileUploader, downloadFile, EventManager, ThreadEventsManager, StoreEventsManager, InboxEventsManager, BaseEventManager, StreamReader };
+import * as Files from './files';
+import * as Events from './events';
+import { EventManager, ThreadEventsManager, StoreEventsManager, InboxEventsManager, BaseEventManager, ConnectionEventsManager, Channel, EventPayload, GenericEvent } from './events';
+import * as Utils from './utils';
+import * as Generics from './generics';
+import * as Inboxes from './inbox';
+import { FileUploader, StreamReader, downloadFile } from './files';
+import { PrivmxClient } from './PrivmxClient';
+import { PublicConnection } from './PublicConnection';
+export { Files, Inboxes, Events, Utils, Generics, FileUploader, downloadFile, EventManager, ThreadEventsManager, StoreEventsManager, InboxEventsManager, BaseEventManager, StreamReader, PrivmxClient, PublicConnection, Channel, ConnectionEventsManager, EventPayload, GenericEvent, };

package/extra/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.StreamReader = exports.BaseEventManager = exports.InboxEventsManager = exports.StoreEventsManager = exports.ThreadEventsManager = exports.EventManager = exports.downloadFile = exports.FileUploader = exports.Generics = exports.Utils = exports.Events = exports.Inboxes = exports.Files = void 0;
+exports.ConnectionEventsManager = exports.PublicConnection = exports.PrivmxClient = exports.StreamReader = exports.BaseEventManager = exports.InboxEventsManager = exports.StoreEventsManager = exports.ThreadEventsManager = exports.EventManager = exports.downloadFile = exports.FileUploader = exports.Generics = exports.Utils = exports.Events = exports.Inboxes = exports.Files = void 0;
 const Files = require("./files");
 exports.Files = Files;
 const Events = require("./events");
@@ -11,6 +11,7 @@ Object.defineProperty(exports, "ThreadEventsManager", { enumerable: true, get: f
 Object.defineProperty(exports, "StoreEventsManager", { enumerable: true, get: function () { return events_1.StoreEventsManager; } });
 Object.defineProperty(exports, "InboxEventsManager", { enumerable: true, get: function () { return events_1.InboxEventsManager; } });
 Object.defineProperty(exports, "BaseEventManager", { enumerable: true, get: function () { return events_1.BaseEventManager; } });
+Object.defineProperty(exports, "ConnectionEventsManager", { enumerable: true, get: function () { return events_1.ConnectionEventsManager; } });
 const Utils = require("./utils");
 exports.Utils = Utils;
 const Generics = require("./generics");
@@ -21,3 +22,7 @@ const files_1 = require("./files");
 Object.defineProperty(exports, "FileUploader", { enumerable: true, get: function () { return files_1.FileUploader; } });
 Object.defineProperty(exports, "StreamReader", { enumerable: true, get: function () { return files_1.StreamReader; } });
 Object.defineProperty(exports, "downloadFile", { enumerable: true, get: function () { return files_1.downloadFile; } });
+const PrivmxClient_1 = require("./PrivmxClient");
+Object.defineProperty(exports, "PrivmxClient", { enumerable: true, get: function () { return PrivmxClient_1.PrivmxClient; } });
+const PublicConnection_1 = require("./PublicConnection");
+Object.defineProperty(exports, "PublicConnection", { enumerable: true, get: function () { return PublicConnection_1.PublicConnection; } });

package/index.d.ts

@@ -9,6 +9,6 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 import { EndpointFactory } from "./service/EndpointFactory";
-import { EventQueue, StoreApi, ThreadApi, InboxApi, Connection, CryptoApi, BaseApi } from "./service";
+import { EventQueue, StoreApi, ThreadApi, InboxApi, Connection, CryptoApi, BaseApi, ExtKey } from "./service";
 import * as Types from "./Types";
-export { EndpointFactory as Endpoint, Types, EventQueue, StoreApi, ThreadApi, InboxApi, CryptoApi, Connection, BaseApi, };
+export { EndpointFactory as Endpoint, Types, EventQueue, StoreApi, ThreadApi, InboxApi, CryptoApi, Connection, BaseApi, ExtKey };

package/index.js

@@ -10,7 +10,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseApi = exports.Connection = exports.CryptoApi = exports.InboxApi = exports.ThreadApi = exports.StoreApi = exports.EventQueue = exports.Types = exports.Endpoint = void 0;
+exports.ExtKey = exports.BaseApi = exports.Connection = exports.CryptoApi = exports.InboxApi = exports.ThreadApi = exports.StoreApi = exports.EventQueue = exports.Types = exports.Endpoint = void 0;
 const EndpointFactory_1 = require("./service/EndpointFactory");
 Object.defineProperty(exports, "Endpoint", { enumerable: true, get: function () { return EndpointFactory_1.EndpointFactory; } });
 const service_1 = require("./service");
@@ -21,5 +21,6 @@ Object.defineProperty(exports, "InboxApi", { enumerable: true, get: function ()
 Object.defineProperty(exports, "Connection", { enumerable: true, get: function () { return service_1.Connection; } });
 Object.defineProperty(exports, "CryptoApi", { enumerable: true, get: function () { return service_1.CryptoApi; } });
 Object.defineProperty(exports, "BaseApi", { enumerable: true, get: function () { return service_1.BaseApi; } });
+Object.defineProperty(exports, "ExtKey", { enumerable: true, get: function () { return service_1.ExtKey; } });
 const Types = require("./Types");
 exports.Types = Types;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplito/privmx-webendpoint",
-  "version": "2.2.9",
+  "version": "2.3.0",
   "description": "PrivMX Web Endpoint library",
   "author": "Simplito",
   "license": "PrivMX Free License",
@@ -32,6 +32,10 @@
   "type": "commonjs",
   "main": "index.js",
   "types": "index.d.ts",
+  "exports": {
+    ".": "./index.js",
+    "./extra": "./extra/index.js"
+  },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
     "compile": "tsc",

package/service/Connection.d.ts

@@ -10,15 +10,22 @@ limitations under the License.
 */
 import { BaseApi } from "./BaseApi";
 import { ConnectionNative } from "../api/ConnectionNative";
-import { PagingQuery, PagingList, Context } from "../Types";
+import { PagingQuery, PagingList, Context, UserInfo } from "../Types";
 import { BaseNative } from "../api/BaseNative";
+import { UserVerifierInterface } from "./UserVerifierInterface";
 export declare class Connection extends BaseApi {
     private native;
+    /**
+     * //doc-gen:ignore
+     */
     apisRefs: {
         [apiId: string]: {
             _apiServicePtr: number;
         };
     };
+    /**
+     * //doc-gen:ignore
+     */
     nativeApisDeps: {
         [apiId: string]: BaseNative;
     };
@@ -36,10 +43,29 @@ export declare class Connection extends BaseApi {
      * @returns {PagingList<Context>} struct containing a list of Contexts
      */
     listContexts(pagingQuery: PagingQuery): Promise<PagingList<Context>>;
+    /**
+     * Gets a list of users of given context.
+     *
+     * @param contextId ID of the Context
+     *
+     * @returns a list of the UserInfo objects
+     */
+    getContextUsers(contextId: string): Promise<UserInfo[]>;
     /**
      * Disconnects from the Platform backend.
      *
      */
     disconnect(): Promise<void>;
+    /**
+     * Sets user's custom verification callback.
+     *
+     * The feature allows the developer to set up a callback for user verification.
+     * A developer can implement an interface and pass the implementation to the function.
+     * Each time data is read from the container, a callback will be triggered, allowing the developer to validate the sender in an external service,
+     * e.g. Developer's Application Server or PKI Server.
+     * @param verifier an implementation of the UserVerifierInterface
+     *
+     */
+    setUserVerifier(verifier: UserVerifierInterface): Promise<void>;
     private freeApis;
 }

package/service/Connection.js

@@ -14,7 +14,13 @@ exports.Connection = void 0;
 const BaseApi_1 = require("./BaseApi");
 class Connection extends BaseApi_1.BaseApi {
     native;
+    /**
+     * //doc-gen:ignore
+     */
     apisRefs = {};
+    /**
+     * //doc-gen:ignore
+     */
     nativeApisDeps = {};
     constructor(native, ptr) {
         super(ptr);
@@ -37,6 +43,16 @@ class Connection extends BaseApi_1.BaseApi {
     async listContexts(pagingQuery) {
         return this.native.listContexts(this.servicePtr, [pagingQuery]);
     }
+    /**
+     * Gets a list of users of given context.
+     *
+     * @param contextId ID of the Context
+     *
+     * @returns a list of the UserInfo objects
+     */
+    async getContextUsers(contextId) {
+        return this.native.getContextUsers(this.servicePtr, [contextId]);
+    }
     /**
      * Disconnects from the Platform backend.
      *
@@ -46,6 +62,19 @@ class Connection extends BaseApi_1.BaseApi {
         await this.freeApis();
         await this.native.deleteConnection(this.servicePtr);
     }
+    /**
+     * Sets user's custom verification callback.
+     *
+     * The feature allows the developer to set up a callback for user verification.
+     * A developer can implement an interface and pass the implementation to the function.
+     * Each time data is read from the container, a callback will be triggered, allowing the developer to validate the sender in an external service,
+     * e.g. Developer's Application Server or PKI Server.
+     * @param verifier an implementation of the UserVerifierInterface
+     *
+     */
+    setUserVerifier(verifier) {
+        return this.native.setUserVerifier(this.servicePtr, [this.servicePtr, verifier]);
+    }
     async freeApis() {
         for (const apiId in this.apisRefs) {
             if (this.nativeApisDeps[apiId]) {

package/service/CryptoApi.d.ts

@@ -10,6 +10,7 @@ limitations under the License.
 */
 import { BaseApi } from "./BaseApi";
 import { CryptoApiNative } from "../api/CryptoApiNative";
+import { BIP39 } from "../Types";
 export declare class CryptoApi extends BaseApi {
     private native;
     constructor(native: CryptoApiNative, ptr: number);
@@ -51,7 +52,7 @@ export declare class CryptoApi extends BaseApi {
      *
      * @param {string} password the password used to generate the new key
      * @param {string} salt random string (additional input for the hashing function)
-
+  
      * @returns {string} generated ECC key in WIF format
      */
     derivePrivateKey2(password: string, salt: string): Promise<string>;
@@ -89,4 +90,50 @@ export declare class CryptoApi extends BaseApi {
      * @returns {string} private key in WIF format
      */
     convertPEMKeytoWIFKey(pemKey: string): Promise<string>;
+    /**
+     * Generates ECC key and BIP-39 mnemonic from a password using BIP-39.
+     *
+     * @param {number} strength size of BIP-39 entropy, must be a multiple of 32
+     * @param {string} password the password used to generate the Key
+     * @returns {BIP39} object containing ECC Key and associated with it BIP-39 mnemonic and entropy
+     */
+    generateBip39(strength: number, password?: string): Promise<BIP39>;
+    /**
+     * Generates ECC key using BIP-39 mnemonic.
+     *
+     * @param {string} mnemonic the BIP-39 entropy used to generate the Key
+     * @param {string} password the password used to generate the Key
+     * @return BIP39_t object containing ECC Key and associated with it BIP-39 mnemonic and entropy
+     */
+    fromMnemonic(mnemonic: string, password?: string): Promise<BIP39>;
+    /**
+     * Generates ECC key using BIP-39 entropy.
+     *
+     * @param {Uint8Array} entropy the BIP-39 entropy used to generate the Key
+     * @param {string} password the password used to generate the Key
+     * @return {BIP39} object containing ECC Key and associated with it BIP-39 mnemonic and entropy
+     */
+    fromEntropy(entropy: Uint8Array, password?: string): Promise<BIP39>;
+    /**
+     * Converts BIP-39 entropy to mnemonic.
+     *
+     * @param {Uint8Array} entropy BIP-39 entropy
+     * @return {string} BIP-39 mnemonic
+     */
+    entropyToMnemonic(entropy: Uint8Array): Promise<string>;
+    /**
+     * Converts BIP-39 mnemonic to entropy.
+     *
+     * @param {string} mnemonic BIP-39 mnemonic
+     * @return {Uint8Array} BIP-39 entropy
+     */
+    mnemonicToEntropy(mnemonic: string): Promise<Uint8Array>;
+    /**
+     * Generates a seed used to generate a key using BIP-39 mnemonic with PBKDF2.
+     *
+     * @param {string} mnemonic BIP-39 mnemonic
+     * @param {string} password the password used to generate the seed
+     * @return {Uint8Array} generated seed
+     */
+    mnemonicToSeed(mnemonic: string, password?: string): Promise<Uint8Array>;
 }

package/service/CryptoApi.js

@@ -64,7 +64,7 @@ class CryptoApi extends BaseApi_1.BaseApi {
      *
      * @param {string} password the password used to generate the new key
      * @param {string} salt random string (additional input for the hashing function)
-
+  
      * @returns {string} generated ECC key in WIF format
      */
     async derivePrivateKey2(password, salt) {
@@ -120,5 +120,63 @@ class CryptoApi extends BaseApi_1.BaseApi {
     async convertPEMKeytoWIFKey(pemKey) {
         return this.native.convertPEMKeytoWIFKey(this.servicePtr, [pemKey]);
     }
+    /**
+     * Generates ECC key and BIP-39 mnemonic from a password using BIP-39.
+     *
+     * @param {number} strength size of BIP-39 entropy, must be a multiple of 32
+     * @param {string} password the password used to generate the Key
+     * @returns {BIP39} object containing ECC Key and associated with it BIP-39 mnemonic and entropy
+     */
+    async generateBip39(strength, password = "") {
+        return this.native.generateBip39(this.servicePtr, [strength, password]);
+    }
+    /**
+     * Generates ECC key using BIP-39 mnemonic.
+     *
+     * @param {string} mnemonic the BIP-39 entropy used to generate the Key
+     * @param {string} password the password used to generate the Key
+     * @return BIP39_t object containing ECC Key and associated with it BIP-39 mnemonic and entropy
+     */
+    async fromMnemonic(mnemonic, password = "") {
+        return this.native.fromMnemonic(this.servicePtr, [mnemonic, password]);
+    }
+    /**
+     * Generates ECC key using BIP-39 entropy.
+     *
+     * @param {Uint8Array} entropy the BIP-39 entropy used to generate the Key
+     * @param {string} password the password used to generate the Key
+     * @return {BIP39} object containing ECC Key and associated with it BIP-39 mnemonic and entropy
+     */
+    async fromEntropy(entropy, password = "") {
+        return this.native.fromEntropy(this.servicePtr, [entropy, password]);
+    }
+    /**
+     * Converts BIP-39 entropy to mnemonic.
+     *
+     * @param {Uint8Array} entropy BIP-39 entropy
+     * @return {string} BIP-39 mnemonic
+     */
+    async entropyToMnemonic(entropy) {
+        return this.native.entropyToMnemonic(this.servicePtr, [entropy]);
+    }
+    /**
+     * Converts BIP-39 mnemonic to entropy.
+     *
+     * @param {string} mnemonic BIP-39 mnemonic
+     * @return {Uint8Array} BIP-39 entropy
+     */
+    async mnemonicToEntropy(mnemonic) {
+        return this.native.mnemonicToEntropy(this.servicePtr, [mnemonic]);
+    }
+    /**
+     * Generates a seed used to generate a key using BIP-39 mnemonic with PBKDF2.
+     *
+     * @param {string} mnemonic BIP-39 mnemonic
+     * @param {string} password the password used to generate the seed
+     * @return {Uint8Array} generated seed
+     */
+    async mnemonicToSeed(mnemonic, password = "") {
+        return this.native.mnemonicToSeed(this.servicePtr, [mnemonic, password]);
+    }
 }
 exports.CryptoApi = CryptoApi;

package/service/EndpointFactory.d.ts

@@ -10,6 +10,7 @@ limitations under the License.
 */
 import { Connection } from "./Connection";
 import { CryptoApi } from "./CryptoApi";
+import { EventApi } from "./EventApi";
 import { EventQueue } from "./EventQueue";
 import { InboxApi } from "./InboxApi";
 import { StoreApi } from "./StoreApi";
@@ -86,4 +87,12 @@ export declare class EndpointFactory {
      * @returns {CryptoApi} instance of CryptoApi
      */
     static createCryptoApi(): Promise<CryptoApi>;
+    /**
+     * Creates an instance of 'EventApi'.
+     *
+     * @param connection instance of 'Connection'
+     *
+     * @returns {EventApi} instance of EventApi
+     */
+    static createEventApi(connection: Connection): Promise<EventApi>;
 }

package/service/EndpointFactory.js

@@ -12,14 +12,18 @@ limitations under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EndpointFactory = void 0;
 const Api_1 = require("../api/Api");
+const ApiStatic_1 = require("../api/ApiStatic");
 const ConnectionNative_1 = require("../api/ConnectionNative");
 const CryptoApiNative_1 = require("../api/CryptoApiNative");
+const EventApiNative_1 = require("../api/EventApiNative");
 const EventQueueNative_1 = require("../api/EventQueueNative");
 const InboxApiNative_1 = require("../api/InboxApiNative");
 const StoreApiNative_1 = require("../api/StoreApiNative");
 const ThreadApiNative_1 = require("../api/ThreadApiNative");
+const FinalizationHelper_1 = require("../FinalizationHelper");
 const Connection_1 = require("./Connection");
 const CryptoApi_1 = require("./CryptoApi");
+const EventApi_1 = require("./EventApi");
 const EventQueue_1 = require("./EventQueue");
 const InboxApi_1 = require("./InboxApi");
 const StoreApi_1 = require("./StoreApi");
@@ -61,6 +65,8 @@ class EndpointFactory {
      */
     static init(lib) {
         this.api = new Api_1.Api(lib);
+        ApiStatic_1.ApiStatic.init(this.api);
+        FinalizationHelper_1.FinalizationHelper.init(lib);
     }
     /**
      * Gets the EventQueue instance.
@@ -169,5 +175,23 @@ class EndpointFactory {
         await nativeApi.create(ptr, []);
         return new CryptoApi_1.CryptoApi(nativeApi, ptr);
     }
+    /**
+     * Creates an instance of 'EventApi'.
+     *
+     * @param connection instance of 'Connection'
+     *
+     * @returns {EventApi} instance of EventApi
+     */
+    static async createEventApi(connection) {
+        if ("events" in connection.apisRefs) {
+            throw new Error("EventApi already registered for given connection.");
+        }
+        const nativeApi = new EventApiNative_1.EventApiNative(this.api);
+        const ptr = await nativeApi.newApi(connection.servicePtr);
+        connection.apisRefs["events"] = { _apiServicePtr: ptr };
+        connection.nativeApisDeps["events"] = nativeApi;
+        await nativeApi.create(ptr, []);
+        return new EventApi_1.EventApi(nativeApi, ptr);
+    }
 }
 exports.EndpointFactory = EndpointFactory;

package/service/EventApi.d.ts

@@ -0,0 +1,40 @@
+/*!
+PrivMX Web Endpoint.
+Copyright © 2024 Simplito sp. z o.o.
+
+This file is part of the PrivMX Platform (https://privmx.dev).
+This software is Licensed under the PrivMX Free License.
+
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+import { BaseApi } from "./BaseApi";
+import { EventApiNative } from "../api/EventApiNative";
+import { UserWithPubKey } from "../Types";
+export declare class EventApi extends BaseApi {
+    private native;
+    constructor(native: EventApiNative, ptr: number);
+    /**
+     * Emits the custom event on the given Context and channel.
+     *
+     * @param {string} contextId ID of the Context
+     * @param {string} channelName name of the Channel
+     * @param {Uint8Array} eventData event's data
+     * @param {UserWithPubKey[]} users list of UserWithPubKey objects which defines the recipients of the event
+     */
+    emitEvent(contextId: string, channelName: string, eventData: Uint8Array, users: UserWithPubKey[]): Promise<void>;
+    /**
+     * Subscribe for the custom events on the given channel.
+     *
+     * @param {string} contextId ID of the Context
+     * @param {string} channelName name of the Channel
+     */
+    subscribeForCustomEvents(contextId: string, channelName: string): Promise<void>;
+    /**
+     * Unsubscribe from the custom events on the given channel.
+     *
+     * @param {string} contextId ID of the Context
+     * @param {string} channelName name of the Channel
+     */
+    unsubscribeFromCustomEvents(contextId: string, channelName: string): Promise<void>;
+}