@ethora/sdk-backend 25.1.1

package/dist/utils/jwt.d.ts

@@ -0,0 +1,34 @@
+/**
+ * JWT token utilities for Ethora SDK
+ */
+import jwt from "jsonwebtoken";
+import type { ServerTokenPayload, ClientTokenPayload } from "../types";
+/**
+ * Creates a JWT token from the given payload using the chat application's secret
+ *
+ * @param payload - The payload to be encoded in the JWT
+ * @returns The encoded JWT token
+ */
+export declare function createJwtToken(payload: ServerTokenPayload | ClientTokenPayload): string;
+/**
+ * Creates a server-to-server JWT token
+ *
+ * @returns The encoded JWT token for server authentication
+ */
+export declare function createServerToken(): string;
+/**
+ * Creates a client-side JWT token for a specific user ID
+ *
+ * @param userId - The unique identifier of the user
+ * @returns The encoded JWT token for client-side authentication
+ */
+export declare function createClientToken(userId: string): string;
+/**
+ * Verifies a JWT token
+ *
+ * @param token - The JWT token to verify
+ * @returns The decoded token payload
+ * @throws Error if token is invalid
+ */
+export declare function verifyJwtToken(token: string): jwt.JwtPayload;
+//# sourceMappingURL=jwt.d.ts.map

package/dist/utils/jwt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.d.ts","sourceRoot":"","sources":["../../src/utils/jwt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,GAAG,MAAM,cAAc,CAAC;AAC/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAMvE;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,MAAM,CAWvF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAY1C;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAexD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC,UAAU,CAY5D"}

package/dist/utils/jwt.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * JWT token utilities for Ethora SDK
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createJwtToken = createJwtToken;
+exports.createServerToken = createServerToken;
+exports.createClientToken = createClientToken;
+exports.verifyJwtToken = verifyJwtToken;
+const jsonwebtoken_1 = __importDefault(require("jsonwebtoken"));
+const secrets_1 = require("../config/secrets");
+const logger_1 = require("./logger");
+const logger = (0, logger_1.getLogger)("jwt-utils");
+/**
+ * Creates a JWT token from the given payload using the chat application's secret
+ *
+ * @param payload - The payload to be encoded in the JWT
+ * @returns The encoded JWT token
+ */
+function createJwtToken(payload) {
+    logger.debug("Creating a new JWT token");
+    const secrets = (0, secrets_1.getSecrets)();
+    return jsonwebtoken_1.default.sign(payload, secrets.chatAppSecret, {
+        algorithm: "HS256",
+    });
+}
+/**
+ * Creates a server-to-server JWT token
+ *
+ * @returns The encoded JWT token for server authentication
+ */
+function createServerToken() {
+    logger.debug("Creating server-to-server JWT token");
+    const secrets = (0, secrets_1.getSecrets)();
+    const payload = {
+        data: {
+            appId: secrets.chatAppId,
+            type: "server",
+        },
+    };
+    return createJwtToken(payload);
+}
+/**
+ * Creates a client-side JWT token for a specific user ID
+ *
+ * @param userId - The unique identifier of the user
+ * @returns The encoded JWT token for client-side authentication
+ */
+function createClientToken(userId) {
+    logger.debug(`Creating a client-side JWT token for user ID: ${userId}`);
+    const secrets = (0, secrets_1.getSecrets)();
+    const payload = {
+        data: {
+            type: "client",
+            userId: String(userId),
+            appId: secrets.chatAppId,
+        },
+    };
+    const token = createJwtToken(payload);
+    logger.info(`Client JWT token created for user ID: ${userId}`);
+    return token;
+}
+/**
+ * Verifies a JWT token
+ *
+ * @param token - The JWT token to verify
+ * @returns The decoded token payload
+ * @throws Error if token is invalid
+ */
+function verifyJwtToken(token) {
+    logger.debug("Verifying JWT token");
+    const secrets = (0, secrets_1.getSecrets)();
+    try {
+        return jsonwebtoken_1.default.verify(token, secrets.chatAppSecret, {
+            algorithms: ["HS256"],
+        });
+    }
+    catch (error) {
+        logger.error("JWT token verification failed", error);
+        throw new Error("Invalid JWT token");
+    }
+}
+//# sourceMappingURL=jwt.js.map

package/dist/utils/jwt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.js","sourceRoot":"","sources":["../../src/utils/jwt.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;AAeH,wCAWC;AAOD,8CAYC;AAQD,8CAeC;AASD,wCAYC;AAvFD,gEAA+B;AAE/B,+CAA+C;AAC/C,qCAAqC;AAErC,MAAM,MAAM,GAAG,IAAA,kBAAS,EAAC,WAAW,CAAC,CAAC;AAEtC;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,OAAgD;IAC7E,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAA,oBAAU,GAAE,CAAC;IAE7B,OAAO,sBAAG,CAAC,IAAI,CACb,OAAO,EACP,OAAO,CAAC,aAAa,EACrB;QACE,SAAS,EAAE,OAAO;KACnB,CACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB;IAC/B,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,IAAA,oBAAU,GAAE,CAAC;IAE7B,MAAM,OAAO,GAAuB;QAClC,IAAI,EAAE;YACJ,KAAK,EAAE,OAAO,CAAC,SAAS;YACxB,IAAI,EAAE,QAAQ;SACf;KACF,CAAC;IAEF,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,MAAc;IAC9C,MAAM,CAAC,KAAK,CAAC,iDAAiD,MAAM,EAAE,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,IAAA,oBAAU,GAAE,CAAC;IAE7B,MAAM,OAAO,GAAuB;QAClC,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;YACtB,KAAK,EAAE,OAAO,CAAC,SAAS;SACzB;KACF,CAAC;IAEF,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,CAAC,IAAI,CAAC,yCAAyC,MAAM,EAAE,CAAC,CAAC;IAC/D,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc,CAAC,KAAa;IAC1C,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,IAAA,oBAAU,GAAE,CAAC;IAE7B,IAAI,CAAC;QACH,OAAO,sBAAG,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE;YAC9C,UAAU,EAAE,CAAC,OAAO,CAAC;SACtB,CAAmB,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;AACH,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Logger utility for the Ethora SDK
+ */
+export declare enum LogLevel {
+    DEBUG = "debug",
+    INFO = "info",
+    WARN = "warn",
+    ERROR = "error"
+}
+/**
+ * Logger interface
+ */
+export interface Logger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, error?: Error | unknown, ...args: unknown[]): void;
+}
+/**
+ * Gets a logger instance for the given context
+ *
+ * @param context - The context/name for the logger (typically the module name)
+ * @returns Logger instance
+ */
+export declare function getLogger(context: string): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAC3E;AA8CD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKjD"}

package/dist/utils/logger.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * Logger utility for the Ethora SDK
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogLevel = void 0;
+exports.getLogger = getLogger;
+var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "debug";
+    LogLevel["INFO"] = "info";
+    LogLevel["WARN"] = "warn";
+    LogLevel["ERROR"] = "error";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+/**
+ * Simple console logger implementation
+ */
+class ConsoleLogger {
+    constructor(context) {
+        this.context = context;
+    }
+    formatMessage(level, message) {
+        const timestamp = new Date().toISOString();
+        return `[${timestamp}] [${level.toUpperCase()}] [${this.context}] ${message}`;
+    }
+    debug(message, ...args) {
+        if (process.env.NODE_ENV !== "production") {
+            console.debug(this.formatMessage(LogLevel.DEBUG, message), ...args);
+        }
+    }
+    info(message, ...args) {
+        console.info(this.formatMessage(LogLevel.INFO, message), ...args);
+    }
+    warn(message, ...args) {
+        console.warn(this.formatMessage(LogLevel.WARN, message), ...args);
+    }
+    error(message, error, ...args) {
+        const errorInfo = error instanceof Error ? error.stack : error;
+        console.error(this.formatMessage(LogLevel.ERROR, message), errorInfo || "", ...args);
+    }
+}
+/**
+ * Logger cache to reuse logger instances
+ */
+const loggerCache = new Map();
+/**
+ * Gets a logger instance for the given context
+ *
+ * @param context - The context/name for the logger (typically the module name)
+ * @returns Logger instance
+ */
+function getLogger(context) {
+    if (!loggerCache.has(context)) {
+        loggerCache.set(context, new ConsoleLogger(context));
+    }
+    return loggerCache.get(context);
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAqEH,8BAKC;AAxED,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,yBAAa,CAAA;IACb,yBAAa,CAAA;IACb,2BAAe,CAAA;AACjB,CAAC,EALW,QAAQ,wBAAR,QAAQ,QAKnB;AAYD;;GAEG;AACH,MAAM,aAAa;IAGjB,YAAY,OAAe;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEO,aAAa,CAAC,KAAe,EAAE,OAAe;QACpD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,OAAO,IAAI,SAAS,MAAM,KAAK,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;IAChF,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC1C,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,KAAuB,EAAE,GAAG,IAAe;QAChE,MAAM,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QAC/D,OAAO,CAAC,KAAK,CACX,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,EAC3C,SAAS,IAAI,EAAE,EACf,GAAG,IAAI,CACR,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE9C;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,OAAe;IACvC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,WAAW,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC;AACnC,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@ethora/sdk-backend",
+  "version": "25.01.01",
+  "description": "TypeScript SDK for integrating with Ethora chat service backend API",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ethora",
+    "chat",
+    "sdk",
+    "typescript",
+    "backend"
+  ],
+  "author": "Ethora",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.6.0",
+    "jsonwebtoken": "^9.0.2"
+  },
+  "devDependencies": {
+    "@types/jsonwebtoken": "^9.0.6",
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.3"
+  },
+  "peerDependencies": {
+    "axios": "^1.6.0"
+  }
+}