@channel.io/app-sdk-server 0.1.0

package/dist/token/manager.js

@@ -0,0 +1,246 @@
+import { InMemoryTokenCache } from "./cache.js";
+/**
+ * Default refresh buffer: 5 minutes before expiry
+ */
+const DEFAULT_REFRESH_BUFFER_MS = 5 * 60 * 1000;
+/**
+ * Default Channel.io API base URL
+ */
+const DEFAULT_API_BASE_URL = "https://api.channel.io";
+/**
+ * Token manager for Channel.io App SDK
+ *
+ * Handles token issuance, caching, and automatic refresh for:
+ * - Manager tokens (for desk/agent operations)
+ * - User tokens (for user-facing operations)
+ * - Channel tokens (for channel-level operations)
+ *
+ * @example
+ * ```typescript
+ * import { TokenManager } from '@channel.io/app-sdk-server';
+ *
+ * const tokenManager = new TokenManager({
+ *   appId: process.env.APP_ID,
+ *   appSecret: process.env.APP_SECRET,
+ * });
+ *
+ * // Get a manager token (with automatic caching and refresh)
+ * const token = await tokenManager.getManagerToken({
+ *   channelId: 'channel-123',
+ *   managerId: 'manager-456',
+ * });
+ *
+ * // Use the token for API calls
+ * await fetch('https://api.channel.io/...', {
+ *   headers: {
+ *     'Authorization': `Bearer ${token.accessToken}`,
+ *   },
+ * });
+ * ```
+ */
+export class TokenManager {
+    config;
+    cache;
+    debug;
+    constructor(config) {
+        this.config = {
+            ...config,
+            apiBaseUrl: config.apiBaseUrl ?? DEFAULT_API_BASE_URL,
+            refreshBufferMs: config.refreshBufferMs ?? DEFAULT_REFRESH_BUFFER_MS,
+        };
+        this.cache = config.cacheStorage ?? new InMemoryTokenCache();
+        this.debug = config.debug ?? false;
+    }
+    /**
+     * Get a manager token with automatic caching and refresh
+     */
+    async getManagerToken(request) {
+        const cacheKey = this.buildCacheKey("manager", request.channelId, request.managerId);
+        return this.getOrRefreshToken(cacheKey, () => this.issueManagerToken(request));
+    }
+    /**
+     * Get a user token with automatic caching and refresh
+     */
+    async getUserToken(request) {
+        const cacheKey = this.buildCacheKey("user", request.channelId, request.userId);
+        return this.getOrRefreshToken(cacheKey, () => this.issueUserToken(request));
+    }
+    /**
+     * Get a channel token with automatic caching and refresh
+     */
+    async getChannelToken(request) {
+        const cacheKey = this.buildCacheKey("channel", request.channelId);
+        return this.getOrRefreshToken(cacheKey, () => this.issueChannelToken(request));
+    }
+    /**
+     * Manually refresh a token (bypass cache)
+     */
+    async refreshToken(refreshToken) {
+        const response = await this.apiRequest("/app/v1/token/refresh", {
+            method: "POST",
+            body: JSON.stringify({ refreshToken }),
+        });
+        return this.normalizeTokenResponse(response);
+    }
+    /**
+     * Invalidate a cached token
+     */
+    async invalidateToken(type, channelId, entityId) {
+        const cacheKey = this.buildCacheKey(type, channelId, entityId);
+        await this.cache.delete(cacheKey);
+    }
+    /**
+     * Clear all cached tokens
+     */
+    async clearCache() {
+        await this.cache.clear();
+    }
+    /**
+     * Get or refresh a token with automatic caching
+     */
+    async getOrRefreshToken(cacheKey, issueToken) {
+        // Try to get from cache
+        const cached = await this.cache.get(cacheKey);
+        if (cached) {
+            // Check if token needs refresh (within buffer period)
+            const now = Date.now();
+            const expiresAt = cached.token.expiresAt;
+            const needsRefresh = now >= expiresAt - this.config.refreshBufferMs;
+            if (!needsRefresh) {
+                this.log(`Cache hit for ${cacheKey}`);
+                return cached.token;
+            }
+            // Try to refresh using refresh token
+            this.log(`Token expiring soon, refreshing for ${cacheKey}`);
+            try {
+                const refreshed = await this.refreshToken(cached.token.refreshToken);
+                await this.cacheToken(cacheKey, refreshed);
+                return refreshed;
+            }
+            catch (error) {
+                this.log(`Refresh failed, re-issuing token for ${cacheKey}`, error);
+                // Fall through to issue new token
+            }
+        }
+        // Issue new token
+        this.log(`Issuing new token for ${cacheKey}`);
+        const token = await issueToken();
+        await this.cacheToken(cacheKey, token);
+        return token;
+    }
+    /**
+     * Issue a manager token
+     */
+    async issueManagerToken(request) {
+        const response = await this.apiRequest(`/app/v1/channels/${request.channelId}/managers/${request.managerId}/token`, { method: "POST" });
+        return this.normalizeTokenResponse(response);
+    }
+    /**
+     * Issue a user token
+     */
+    async issueUserToken(request) {
+        const response = await this.apiRequest(`/app/v1/channels/${request.channelId}/users/${request.userId}/token`, { method: "POST" });
+        return this.normalizeTokenResponse(response);
+    }
+    /**
+     * Issue a channel token
+     */
+    async issueChannelToken(request) {
+        const response = await this.apiRequest(`/app/v1/channels/${request.channelId}/token`, { method: "POST" });
+        return this.normalizeTokenResponse(response);
+    }
+    /**
+     * Cache a token
+     */
+    async cacheToken(key, token) {
+        const cached = {
+            token,
+            cachedAt: Date.now(),
+            key,
+        };
+        // TTL is until token expires
+        const ttlMs = token.expiresAt - Date.now();
+        await this.cache.set(key, cached, ttlMs > 0 ? ttlMs : undefined);
+    }
+    /**
+     * Build a cache key
+     */
+    buildCacheKey(type, channelId, entityId) {
+        const parts = [this.config.appId, type, channelId];
+        if (entityId)
+            parts.push(entityId);
+        return parts.join(":");
+    }
+    /**
+     * Make an API request to Channel.io
+     */
+    async apiRequest(path, options = {}) {
+        const url = `${this.config.apiBaseUrl}${path}`;
+        const headers = {
+            "Content-Type": "application/json",
+            "X-App-Id": this.config.appId,
+            "X-App-Secret": this.config.appSecret,
+            ...options.headers,
+        };
+        const response = await fetch(url, {
+            ...options,
+            headers,
+        });
+        if (!response.ok) {
+            const errorBody = await response.text();
+            throw new TokenManagerError(`API request failed: ${String(response.status)} ${response.statusText}`, response.status, errorBody);
+        }
+        return response.json();
+    }
+    /**
+     * Normalize token response (handle different API response formats)
+     */
+    normalizeTokenResponse(response) {
+        const expiresIn = response.expiresIn ?? response.expires_in ?? 3600;
+        const refreshTokenExpiresIn = response.refreshTokenExpiresIn ?? response.refresh_token_expires_in ?? 604800;
+        return {
+            accessToken: response.accessToken ?? response.access_token ?? "",
+            refreshToken: response.refreshToken ?? response.refresh_token ?? "",
+            expiresIn,
+            expiresAt: response.expiresAt ?? Date.now() + expiresIn * 1000,
+            refreshTokenExpiresAt: response.refreshTokenExpiresAt ?? Date.now() + refreshTokenExpiresIn * 1000,
+            tokenType: response.tokenType ?? response.token_type ?? "Bearer",
+            scopes: response.scopes ?? (response.scope ? response.scope.split(" ") : []),
+        };
+    }
+    /**
+     * Debug logging
+     */
+    log(message, error) {
+        if (this.debug) {
+            if (error) {
+                console.debug(`[TokenManager] ${message}`, error);
+            }
+            else {
+                console.debug(`[TokenManager] ${message}`);
+            }
+        }
+    }
+    /**
+     * Cleanup resources (call when shutting down)
+     */
+    destroy() {
+        if (this.cache instanceof InMemoryTokenCache) {
+            this.cache.destroy();
+        }
+    }
+}
+/**
+ * Token manager error
+ */
+export class TokenManagerError extends Error {
+    statusCode;
+    responseBody;
+    constructor(message, statusCode, responseBody) {
+        super(message);
+        this.statusCode = statusCode;
+        this.responseBody = responseBody;
+        this.name = "TokenManagerError";
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/token/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/token/manager.ts"],"names":[],"mappings":"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"}

package/dist/token/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Token types and interfaces for Channel.io App SDK
+ */
+/**
+ * Token response from Channel.io token issuance
+ */
+export interface TokenResponse {
+    /** Access token for API calls */
+    accessToken: string;
+    /** Refresh token for token renewal */
+    refreshToken: string;
+    /** Token expiration time in seconds */
+    expiresIn: number;
+    /** Token expiration timestamp (Unix milliseconds) */
+    expiresAt: number;
+    /** Refresh token expiration timestamp (Unix milliseconds) */
+    refreshTokenExpiresAt: number;
+    /** Token type (usually "Bearer") */
+    tokenType: string;
+    /** Granted scopes */
+    scopes: string[];
+}
+/**
+ * Cached token entry with metadata
+ */
+export interface CachedToken {
+    /** The token response */
+    token: TokenResponse;
+    /** When this cache entry was created */
+    cachedAt: number;
+    /** Cache key identifier */
+    key: string;
+}
+/**
+ * Token cache storage interface
+ * Implement this to use custom storage (Redis, database, etc.)
+ */
+export interface TokenCacheStorage {
+    /** Get a cached token by key */
+    get(key: string): Promise<CachedToken | null>;
+    /** Set a cached token */
+    set(key: string, token: CachedToken, ttlMs?: number): Promise<void>;
+    /** Delete a cached token */
+    delete(key: string): Promise<void>;
+    /** Clear all cached tokens */
+    clear(): Promise<void>;
+}
+/**
+ * Token manager configuration
+ */
+export interface TokenManagerConfig {
+    /** App ID */
+    appId: string;
+    /** App secret */
+    appSecret: string;
+    /** Channel.io API base URL (default: https://api.channel.io) */
+    apiBaseUrl?: string;
+    /** Custom cache storage (default: in-memory) */
+    cacheStorage?: TokenCacheStorage;
+    /** Buffer time before expiry to trigger refresh (default: 5 minutes) */
+    refreshBufferMs?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * Token request for issuing manager token
+ */
+export interface ManagerTokenRequest {
+    channelId: string;
+    managerId: string;
+}
+/**
+ * Token request for issuing user token
+ */
+export interface UserTokenRequest {
+    channelId: string;
+    userId: string;
+}
+/**
+ * Token request for issuing channel token
+ */
+export interface ChannelTokenRequest {
+    channelId: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/token/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/token/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,KAAK,EAAE,aAAa,CAAC;IACrB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC9C,yBAAyB;IACzB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,4BAA4B;IAC5B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,8BAA8B;IAC9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/token/types.js

@@ -0,0 +1,5 @@
+/**
+ * Token types and interfaces for Channel.io App SDK
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/token/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/token/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@channel.io/app-sdk-server",
+  "version": "0.1.0",
+  "description": "NestJS server SDK for Channel.io apps",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./nestjs": {
+      "types": "./dist/nestjs/index.d.ts",
+      "import": "./dist/nestjs/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "zod": "^3.24.1",
+    "zod-to-json-schema": "^3.24.1",
+    "@channel.io/app-sdk-core": "0.1.0"
+  },
+  "peerDependencies": {
+    "@nestjs/common": ">=10.0.0",
+    "@nestjs/core": ">=10.0.0",
+    "reflect-metadata": ">=0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@nestjs/common": {
+      "optional": false
+    },
+    "@nestjs/core": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@nestjs/common": "^10.4.15",
+    "@nestjs/core": "^10.4.15",
+    "@nestjs/platform-express": "^10.4.15",
+    "@nestjs/testing": "^10.4.15",
+    "@types/express": "^5.0.6",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/channel-io/app-sdk.git",
+    "directory": "packages/server"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  }
+}