mezon-sdk 2.7.1 → 2.7.2

package/README.md

@@ -1,143 +1,143 @@
-Satori JavaScript Client
-========================
-
-> JavaScript client for Satori server written in TypeScript. For browser and React Native projects.
-
-This client implements the full API for interacting with Satori server. It's written in TypeScript with minimal dependencies to be compatible with all modern browsers and React Native.
-
-Full documentation is online - https://heroiclabs.com/docs/javascript-client-guide
-
-## Getting Started
-
-You'll need access to an instance of the Satori server before you can connect with the client.
-
-1. Import the client into your project. It's [available on NPM](https://www.npmjs/package/mezon-sdk).
-
-  ```shell
-  npm install mezon-sdk
-  ```
-
-You'll now see the code in the "node_modules" folder and package listed in your "package.json".
-
-2. Use the connection credentials to build a client object.
-
-  ```js
-  import {Client} from "mezon-sdk";
-  const client = new Client("apiKey");
-  ```
-
-## Usage
-
-The client object has many method to execute various features in the server.
-
-### Authenticate
-
-To authenticate with the Satori server you must provide an identifier for the user.
-
-```js
-const userId = "<UniqueUserId>";
-
-client.authenticate(userId)
-  .then(session => {
-    _session = session;
-    console.info("Authenticated:", session);
-  }).catch(error => {
-    console.error("Error:", error);
-  });
-```
-
-### Sessions
-
-When authenticated the server responds with an auth token (JWT) which contains useful properties and gets deserialized into a `Session` object.
-
-```js
-console.info(session.token); // raw JWT token
-console.info(session.refreshToken); // refresh token
-console.info("Session has expired?", session.isexpired(Date.now() / 1000));
-const expiresAt = session.expires_at;
-console.warn("Session will expire at:", new Date(expiresAt * 1000).toISOString());
-```
-
-It is recommended to store the auth token from the session and check at startup if it has expired. If the token has expired you must reauthenticate. The expiry time of the token can be changed as a setting in the server.
-
-```js
-// Assume we've stored the auth token in browser Web Storage.
-const authtoken = window.localStorage.getItem("satori_authtoken");
-const refreshtoken = window.localStorage.getItem("satori_refreshtoken");
-
-let session = satorijs.Session.restore(authtoken, refreshtoken);
-
-// Check whether a session is close to expiry.
-
-const unixTimeInFuture = Date.now() + 8.64e+7; // one day from now
-
-if (session.isexpired(unixTimeInFuture / 1000)) {
-    try
-    {
-        session = await client.sessionRefresh(session);
-    }
-    catch (e)
-    {
-        console.info("Session can no longer be refreshed. Must reauthenticate!");
-    }
-}
-```
-
-### Requests
-
-The client includes lots of builtin APIs for various featyures of the Satori server. These can be accessed with the methods which return Promise objects.
-
-Most requests are sent with a session object which authorizes the client.
-
-```js
-const flags = await client.getFlags(session);
-console.info("Flags:", flags);
-```
-
-## Contribute
-
-The development roadmap is managed as GitHub issues and pull requests are welcome. If you're interested in enhancing the code please open an issue to discuss the changes or drop in and discuss it in the [community forum](https://forum.heroiclabs.com).
-
-### Source Builds
-
-Ensure you are using Node v18>.
-
-The codebase is multi-package monorepo written in TypeScript and can be built with [esbuild](https://github.com/evanw/esbuild). All dependencies are managed with Yarn.
-
-To build from source, install dependencies and build the `satori-js` package:
-
-```shell
-npm install --workspace=mezon-sdk && npm run build --workspace=mezon-sdk
-```
-
-### Run Tests
-
-To run tests you will need access to an instance of the Satori server.
-
-Tests are run against each workspace bundle; if you have made source code changes, you should `npm run build --workspace=<workspace>` prior to running tests.
-
-```shell
-npm run test --workspace=mezon-sdk-test
-```
-
-### Release Process
-
-To release onto NPM if you have access to the "@heroiclabs" organization you can use NPM.
-
-```shell
-npm run build --workspace=<workspace> && npm publish --access=public --workspace=<workspace>
-```
-
-### Generate Docs
-
-API docs are generated with typedoc and deployed to GitHub pages.
-
-To run typedoc:
-
-```
-npm install && npm run docs
-```
-
-### License
-
-This project is licensed under the [Apache-2 License](https://github.com/heroiclabs/nakama-js/blob/master/LICENSE).
+Mezon JavaScript Client
+========================
+
+> JavaScript client for Mezon server written in TypeScript. For browser and React Native projects.
+
+This client implements the full API for interacting with Mezon server. It's written in TypeScript with minimal dependencies to be compatible with all modern browsers and React Native.
+
+Full documentation is online - https://mezon.ai/docs/javascript-client-guide
+
+## Getting Started
+
+You'll need access to an instance of the Mezon server before you can connect with the client.
+
+1. Import the client into your project. It's [available on NPM](https://www.npmjs/package/mezon-sdk).
+
+  ```shell
+  npm install mezon-sdk
+  ```
+
+You'll now see the code in the "node_modules" folder and package listed in your "package.json".
+
+2. Use the connection credentials to build a client object.
+
+  ```js
+  import {Client} from "mezon-sdk";
+  const client = new Client("apiKey");
+  ```
+
+## Usage
+
+The client object has many method to execute various features in the server.
+
+### Authenticate
+
+To authenticate with the Mezon server you must provide an identifier for the user.
+
+```js
+const appId = "<AppId>";
+
+client.authenticate(appId)
+  .then(session => {
+    _session = session;
+    console.info("Authenticated:", session);
+  }).catch(error => {
+    console.error("Error:", error);
+  });
+```
+
+### Sessions
+
+When authenticated the server responds with an auth token (JWT) which contains useful properties and gets deserialized into a `Session` object.
+
+```js
+console.info(session.token); // raw JWT token
+console.info(session.refreshToken); // refresh token
+console.info("Session has expired?", session.isexpired(Date.now() / 1000));
+const expiresAt = session.expires_at;
+console.warn("Session will expire at:", new Date(expiresAt * 1000).toISOString());
+```
+
+It is recommended to store the auth token from the session and check at startup if it has expired. If the token has expired you must reauthenticate. The expiry time of the token can be changed as a setting in the server.
+
+```js
+// Assume we've stored the auth token in browser Web Storage.
+const authtoken = window.localStorage.getItem("satori_authtoken");
+const refreshtoken = window.localStorage.getItem("satori_refreshtoken");
+
+let session = satorijs.Session.restore(authtoken, refreshtoken);
+
+// Check whether a session is close to expiry.
+
+const unixTimeInFuture = Date.now() + 8.64e+7; // one day from now
+
+if (session.isexpired(unixTimeInFuture / 1000)) {
+    try
+    {
+        session = await client.sessionRefresh(session);
+    }
+    catch (e)
+    {
+        console.info("Session can no longer be refreshed. Must reauthenticate!");
+    }
+}
+```
+
+### Requests
+
+The client includes lots of builtin APIs for various featyures of the Mezon server. These can be accessed with the methods which return Promise objects.
+
+Most requests are sent with a session object which authorizes the client.
+
+```js
+const flags = await client.getFlags(session);
+console.info("Flags:", flags);
+```
+
+## Contribute
+
+The development roadmap is managed as GitHub issues and pull requests are welcome. If you're interested in enhancing the code please open an issue to discuss the changes or drop in and discuss it in the [community forum](https://forum.mezon.ai).
+
+### Source Builds
+
+Ensure you are using Node v18>.
+
+The codebase is multi-package monorepo written in TypeScript and can be built with [esbuild](https://github.com/evanw/esbuild). All dependencies are managed with Yarn.
+
+To build from source, install dependencies and build the `mezon-sdk` package:
+
+```shell
+npm install --workspace=mezon-sdk && npm run build --workspace=mezon-sdk
+```
+
+### Run Tests
+
+To run tests you will need access to an instance of the Mezon server.
+
+Tests are run against each workspace bundle; if you have made source code changes, you should `npm run build --workspace=<workspace>` prior to running tests.
+
+```shell
+npm run test --workspace=mezon-sdk-test
+```
+
+### Release Process
+
+To release onto NPM if you have access to the "@mezon" organization you can use NPM.
+
+```shell
+npm run build --workspace=<workspace> && npm publish --access=public --workspace=<workspace>
+```
+
+### Generate Docs
+
+API docs are generated with typedoc and deployed to GitHub pages.
+
+To run typedoc:
+
+```
+npm install && npm run docs
+```
+
+### License
+
+This project is licensed under the [Apache-2 License](https://github.com/mezon/mezon/blob/master/LICENSE).

package/api.ts

@@ -0,0 +1,333 @@
+// tslint:disable
+/* Code generated by openapi-gen/main.go. DO NOT EDIT. */
+
+import { buildFetchOptions } from './utils';
+import { encode } from 'js-base64';
+
+
+/** A user's session used to authenticate messages. */
+export interface ApiSession {
+  //True if the corresponding account was just created, false otherwise.
+  created?: boolean;
+  //Refresh token that can be used for session token renewal.
+  refresh_token?: string;
+  //Authentication credentials.
+  token?: string;
+}
+
+/** Log out a session, invalidate a refresh token, or log out all sessions/refresh tokens for a user. */
+export interface ApiAuthenticateLogoutRequest {
+  //Refresh token to invalidate.
+  refresh_token?: string;
+  //Session token to log out.
+  token?: string;
+}
+
+/** Authenticate against the server with a refresh token. */
+export interface ApiAuthenticateRefreshRequest {
+  //Refresh token.
+  refresh_token?: string;
+}
+
+/** Authenticate against the server with a device ID. */
+export interface ApiAuthenticateRequest {
+  //The App account details.
+  account?: ApiAccountApp;
+}
+
+
+/** Send a app token to the server. Used with authenticate/link/unlink. */
+export interface ApiAccountApp {
+  //
+  appid?: string;
+  //
+  appname?: string;
+  //The account token when create apps to access their profile API.
+  token?: string;
+  //Extra information that will be bundled in the session token.
+  vars?: Record<string, string>;
+}
+
+
+/** The request to update the status of a message. */
+export interface ApiUpdateMessageRequest {
+  //The time the message was consumed by the identity.
+  consume_time?: string;
+  //The identifier of the messages.
+  id?: string;
+  //The time the message was read at the client.
+  read_time?: string;
+}
+
+
+export class MezonApi {
+
+  constructor(readonly apiKey: string, readonly basePath: string, readonly timeoutMs: number) {}
+
+  /** A healthcheck which load balancers can use to check the service. */
+  mezonHealthcheck(bearerToken: string,
+      options: any = {}): Promise<any> {
+    
+    const urlPath = "/healthcheck";
+    const queryParams = new Map<string, any>();
+
+    let bodyJson : string = "";
+
+    const fullUrl = this.buildFullUrl(this.basePath, urlPath, queryParams);
+    const fetchOptions = buildFetchOptions("GET", options, bodyJson);
+    if (bearerToken) {
+      fetchOptions.headers["Authorization"] = "Bearer " + bearerToken;
+    }
+
+    return Promise.race([
+      fetch(fullUrl, fetchOptions).then((response) => {
+        if (response.status == 204) {
+          return response;
+        } else if (response.status >= 200 && response.status < 300) {
+          return response.json();
+        } else {
+          throw response;
+        }
+      }),
+      new Promise((_, reject) =>
+        setTimeout(reject, this.timeoutMs, "Request timed out.")
+      ),
+    ]);
+  }
+
+  /** A readycheck which load balancers can use to check the service. */
+  mezonReadycheck(bearerToken: string,
+      options: any = {}): Promise<any> {
+    
+    const urlPath = "/readycheck";
+    const queryParams = new Map<string, any>();
+
+    let bodyJson : string = "";
+
+    const fullUrl = this.buildFullUrl(this.basePath, urlPath, queryParams);
+    const fetchOptions = buildFetchOptions("GET", options, bodyJson);
+    if (bearerToken) {
+      fetchOptions.headers["Authorization"] = "Bearer " + bearerToken;
+    }
+
+    return Promise.race([
+      fetch(fullUrl, fetchOptions).then((response) => {
+        if (response.status == 204) {
+          return response;
+        } else if (response.status >= 200 && response.status < 300) {
+          return response.json();
+        } else {
+          throw response;
+        }
+      }),
+      new Promise((_, reject) =>
+        setTimeout(reject, this.timeoutMs, "Request timed out.")
+      ),
+    ]);
+  }
+
+  /** Authenticate a app with a token against the server. */
+  mezonAuthenticate(basicAuthUsername: string,
+    basicAuthPassword: string,
+      body:ApiAuthenticateRequest,
+      options: any = {}): Promise<ApiSession> {
+    
+    if (body === null || body === undefined) {
+      throw new Error("'body' is a required parameter but is null or undefined.");
+    }
+    const urlPath = "/v2/apps/authenticate/token";
+    const queryParams = new Map<string, any>();
+
+    let bodyJson : string = "";
+    bodyJson = JSON.stringify(body || {});
+
+    const fullUrl = this.buildFullUrl(this.basePath, urlPath, queryParams);
+    const fetchOptions = buildFetchOptions("POST", options, bodyJson);
+		if (basicAuthUsername) {
+			fetchOptions.headers["Authorization"] = "Basic " + encode(basicAuthUsername + ":" + basicAuthPassword);
+		}
+
+    return Promise.race([
+      fetch(fullUrl, fetchOptions).then((response) => {
+        if (response.status == 204) {
+          return response;
+        } else if (response.status >= 200 && response.status < 300) {
+          return response.json();
+        } else {
+          throw response;
+        }
+      }),
+      new Promise((_, reject) =>
+        setTimeout(reject, this.timeoutMs, "Request timed out.")
+      ),
+    ]);
+  }
+
+  /** Log out a session, invalidate a refresh token, or log out all sessions/refresh tokens for a user. */
+  mezonAuthenticateLogout(bearerToken: string,
+      body:ApiAuthenticateLogoutRequest,
+      options: any = {}): Promise<any> {
+    
+    if (body === null || body === undefined) {
+      throw new Error("'body' is a required parameter but is null or undefined.");
+    }
+    const urlPath = "/v2/apps/authenticate/logout";
+    const queryParams = new Map<string, any>();
+
+    let bodyJson : string = "";
+    bodyJson = JSON.stringify(body || {});
+
+    const fullUrl = this.buildFullUrl(this.basePath, urlPath, queryParams);
+    const fetchOptions = buildFetchOptions("POST", options, bodyJson);
+    if (bearerToken) {
+      fetchOptions.headers["Authorization"] = "Bearer " + bearerToken;
+    }
+
+    return Promise.race([
+      fetch(fullUrl, fetchOptions).then((response) => {
+        if (response.status == 204) {
+          return response;
+        } else if (response.status >= 200 && response.status < 300) {
+          return response.json();
+        } else {
+          throw response;
+        }
+      }),
+      new Promise((_, reject) =>
+        setTimeout(reject, this.timeoutMs, "Request timed out.")
+      ),
+    ]);
+  }
+
+  /** Refresh a user's session using a refresh token retrieved from a previous authentication request. */
+  mezonAuthenticateRefresh(basicAuthUsername: string,
+    basicAuthPassword: string,
+      body:ApiAuthenticateRefreshRequest,
+      options: any = {}): Promise<ApiSession> {
+    
+    if (body === null || body === undefined) {
+      throw new Error("'body' is a required parameter but is null or undefined.");
+    }
+    const urlPath = "/v2/apps/authenticate/refresh";
+    const queryParams = new Map<string, any>();
+
+    let bodyJson : string = "";
+    bodyJson = JSON.stringify(body || {});
+
+    const fullUrl = this.buildFullUrl(this.basePath, urlPath, queryParams);
+    const fetchOptions = buildFetchOptions("POST", options, bodyJson);
+		if (basicAuthUsername) {
+			fetchOptions.headers["Authorization"] = "Basic " + encode(basicAuthUsername + ":" + basicAuthPassword);
+		}
+
+    return Promise.race([
+      fetch(fullUrl, fetchOptions).then((response) => {
+        if (response.status == 204) {
+          return response;
+        } else if (response.status >= 200 && response.status < 300) {
+          return response.json();
+        } else {
+          throw response;
+        }
+      }),
+      new Promise((_, reject) =>
+        setTimeout(reject, this.timeoutMs, "Request timed out.")
+      ),
+    ]);
+  }
+
+  /** Deletes a message for an identity. */
+  mezonDeleteMessage(bearerToken: string,
+      id:string,
+      options: any = {}): Promise<any> {
+    
+    if (id === null || id === undefined) {
+      throw new Error("'id' is a required parameter but is null or undefined.");
+    }
+    const urlPath = "/v2/apps/message/{id}"
+        .replace("{id}", encodeURIComponent(String(id)));
+    const queryParams = new Map<string, any>();
+
+    let bodyJson : string = "";
+
+    const fullUrl = this.buildFullUrl(this.basePath, urlPath, queryParams);
+    const fetchOptions = buildFetchOptions("DELETE", options, bodyJson);
+    if (bearerToken) {
+        fetchOptions.headers["Authorization"] = "Bearer " + bearerToken;
+    }
+
+    return Promise.race([
+      fetch(fullUrl, fetchOptions).then((response) => {
+        if (response.status == 204) {
+          return response;
+        } else if (response.status >= 200 && response.status < 300) {
+          return response.json();
+        } else {
+          throw response;
+        }
+      }),
+      new Promise((_, reject) =>
+        setTimeout(reject, this.timeoutMs, "Request timed out.")
+      ),
+    ]);
+  }
+
+  /** Updates a message for an identity. */
+  mezonUpdateMessage(bearerToken: string,
+      id:string,
+      body:ApiUpdateMessageRequest,
+      options: any = {}): Promise<any> {
+    
+    if (id === null || id === undefined) {
+      throw new Error("'id' is a required parameter but is null or undefined.");
+    }
+    if (body === null || body === undefined) {
+      throw new Error("'body' is a required parameter but is null or undefined.");
+    }
+    const urlPath = "/v2/apps/message/{id}"
+        .replace("{id}", encodeURIComponent(String(id)));
+    const queryParams = new Map<string, any>();
+
+    let bodyJson : string = "";
+    bodyJson = JSON.stringify(body || {});
+
+    const fullUrl = this.buildFullUrl(this.basePath, urlPath, queryParams);
+    const fetchOptions = buildFetchOptions("PUT", options, bodyJson);
+    if (bearerToken) {
+        fetchOptions.headers["Authorization"] = "Bearer " + bearerToken;
+    }
+
+    return Promise.race([
+      fetch(fullUrl, fetchOptions).then((response) => {
+        if (response.status == 204) {
+          return response;
+        } else if (response.status >= 200 && response.status < 300) {
+          return response.json();
+        } else {
+          throw response;
+        }
+      }),
+      new Promise((_, reject) =>
+        setTimeout(reject, this.timeoutMs, "Request timed out.")
+      ),
+    ]);
+  }
+
+  buildFullUrl(basePath: string, fragment: string, queryParams: Map<string, any>) {
+    let fullPath = basePath + fragment + "?";
+
+    for (let [k, v] of queryParams) {
+        if (v instanceof Array) {
+            fullPath += v.reduce((prev: any, curr: any) => {
+            return prev + encodeURIComponent(k) + "=" + encodeURIComponent(curr) + "&";
+            }, "");
+        } else {
+            if (v != null) {
+                fullPath += encodeURIComponent(k) + "=" + encodeURIComponent(v) + "&";
+            }
+        }
+    }
+
+    return fullPath;
+  }
+};