@enfin/chat-shared 1.2.0

package/dist/apikey.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Generate a random API key for chat platform
+ * Format: chat_{tenantId}_{checksum}
+ */
+export declare function generateApiKey(tenantId: string): string;
+/**
+ * Generate a random tenant ID
+ */
+export declare function generateTenantId(): string;
+/**
+ * Validate API key format
+ * Returns true if format is correct: chat_{tenantId}_{random}
+ */
+export declare function validateApiKeyFormat(apiKey: string): boolean;
+/**
+ * Extract tenant ID from API key
+ * Format: chat_{tenantId}_{random}
+ */
+export declare function extractTenantId(apiKey: string): string | null;
+/**
+ * Generate a checksum for API key validation
+ */
+export declare function generateChecksum(apiKey: string): string;
+/**
+ * Validate API key with checksum
+ */
+export declare function validateApiKeyWithChecksum(apiKey: string, expectedChecksum: string): boolean;

package/dist/apikey.js

@@ -0,0 +1,73 @@
+"use strict";
+// API Key generation and validation utilities
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateApiKey = generateApiKey;
+exports.generateTenantId = generateTenantId;
+exports.validateApiKeyFormat = validateApiKeyFormat;
+exports.extractTenantId = extractTenantId;
+exports.generateChecksum = generateChecksum;
+exports.validateApiKeyWithChecksum = validateApiKeyWithChecksum;
+const BASE62_CHARS = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
+/**
+ * Generate a random API key for chat platform
+ * Format: chat_{tenantId}_{checksum}
+ */
+function generateApiKey(tenantId) {
+    const randomPart = generateRandomString(10);
+    return `chat_${tenantId}_${randomPart}`;
+}
+/**
+ * Generate a random tenant ID
+ */
+function generateTenantId() {
+    return generateRandomString(8);
+}
+/**
+ * Generate a random string of specified length using Base62
+ */
+function generateRandomString(length) {
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        result += BASE62_CHARS[Math.floor(Math.random() * BASE62_CHARS.length)];
+    }
+    return result;
+}
+/**
+ * Validate API key format
+ * Returns true if format is correct: chat_{tenantId}_{random}
+ */
+function validateApiKeyFormat(apiKey) {
+    const parts = apiKey.split('_');
+    return (parts.length === 3 &&
+        parts[0] === 'chat' &&
+        parts[1].length >= 6 &&
+        parts[2].length >= 6);
+}
+/**
+ * Extract tenant ID from API key
+ * Format: chat_{tenantId}_{random}
+ */
+function extractTenantId(apiKey) {
+    const parts = apiKey.split('_');
+    if (parts.length !== 3 || parts[0] !== 'chat')
+        return null;
+    return parts[1];
+}
+/**
+ * Generate a checksum for API key validation
+ */
+function generateChecksum(apiKey) {
+    let hash = 0;
+    for (let i = 0; i < apiKey.length; i++) {
+        const char = apiKey.charCodeAt(i);
+        hash = (hash << 5) - hash + char;
+        hash = hash & hash;
+    }
+    return Math.abs(hash).toString(36);
+}
+/**
+ * Validate API key with checksum
+ */
+function validateApiKeyWithChecksum(apiKey, expectedChecksum) {
+    return generateChecksum(apiKey) === expectedChecksum;
+}

package/dist/esm/apikey.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Generate a random API key for chat platform
+ * Format: chat_{tenantId}_{checksum}
+ */
+export declare function generateApiKey(tenantId: string): string;
+/**
+ * Generate a random tenant ID
+ */
+export declare function generateTenantId(): string;
+/**
+ * Validate API key format
+ * Returns true if format is correct: chat_{tenantId}_{random}
+ */
+export declare function validateApiKeyFormat(apiKey: string): boolean;
+/**
+ * Extract tenant ID from API key
+ * Format: chat_{tenantId}_{random}
+ */
+export declare function extractTenantId(apiKey: string): string | null;
+/**
+ * Generate a checksum for API key validation
+ */
+export declare function generateChecksum(apiKey: string): string;
+/**
+ * Validate API key with checksum
+ */
+export declare function validateApiKeyWithChecksum(apiKey: string, expectedChecksum: string): boolean;

package/dist/esm/apikey.js

@@ -0,0 +1,65 @@
+// API Key generation and validation utilities
+const BASE62_CHARS = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
+/**
+ * Generate a random API key for chat platform
+ * Format: chat_{tenantId}_{checksum}
+ */
+export function generateApiKey(tenantId) {
+    const randomPart = generateRandomString(10);
+    return `chat_${tenantId}_${randomPart}`;
+}
+/**
+ * Generate a random tenant ID
+ */
+export function generateTenantId() {
+    return generateRandomString(8);
+}
+/**
+ * Generate a random string of specified length using Base62
+ */
+function generateRandomString(length) {
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        result += BASE62_CHARS[Math.floor(Math.random() * BASE62_CHARS.length)];
+    }
+    return result;
+}
+/**
+ * Validate API key format
+ * Returns true if format is correct: chat_{tenantId}_{random}
+ */
+export function validateApiKeyFormat(apiKey) {
+    const parts = apiKey.split('_');
+    return (parts.length === 3 &&
+        parts[0] === 'chat' &&
+        parts[1].length >= 6 &&
+        parts[2].length >= 6);
+}
+/**
+ * Extract tenant ID from API key
+ * Format: chat_{tenantId}_{random}
+ */
+export function extractTenantId(apiKey) {
+    const parts = apiKey.split('_');
+    if (parts.length !== 3 || parts[0] !== 'chat')
+        return null;
+    return parts[1];
+}
+/**
+ * Generate a checksum for API key validation
+ */
+export function generateChecksum(apiKey) {
+    let hash = 0;
+    for (let i = 0; i < apiKey.length; i++) {
+        const char = apiKey.charCodeAt(i);
+        hash = (hash << 5) - hash + char;
+        hash = hash & hash;
+    }
+    return Math.abs(hash).toString(36);
+}
+/**
+ * Validate API key with checksum
+ */
+export function validateApiKeyWithChecksum(apiKey, expectedChecksum) {
+    return generateChecksum(apiKey) === expectedChecksum;
+}

package/dist/esm/index.d.ts

@@ -0,0 +1,164 @@
+export interface ApiKeyValidationResponse {
+    valid: boolean;
+    apiKey: string;
+    mode: 'managed' | 'external-db';
+    database?: string;
+    version: string;
+    tenantId: string;
+    error?: string;
+}
+export interface Message {
+    _id: string;
+    roomId: string;
+    senderId: string;
+    senderName: string;
+    senderAvatar?: string;
+    content: string;
+    fileUrl?: string;
+    fileType?: string;
+    fileName?: string;
+    createdAt: Date;
+    updatedAt: Date;
+    readBy: ReadReceipt[];
+}
+export interface ReadReceipt {
+    userId: string;
+    readAt: Date;
+}
+export interface Room {
+    _id: string;
+    name: string;
+    type: 'direct' | 'group';
+    members: string[];
+    createdBy: string;
+    createdAt: Date;
+    updatedAt: Date;
+    lastMessage?: string | Message;
+    lastActivity: Date;
+    avatar?: string;
+}
+export interface PresenceStatus {
+    userId: string;
+    status: 'online' | 'offline' | 'away';
+    lastSeen: Date;
+    typingIn?: string[];
+}
+export interface AudioCall {
+    _id: string;
+    roomId: string;
+    initiatorId: string;
+    participantId: string;
+    status: 'ringing' | 'active' | 'ended';
+    startedAt: Date;
+    endedAt?: Date;
+    duration?: number;
+}
+export interface SocketMessage {
+    type: string;
+    data: any;
+    timestamp: number;
+}
+export interface SendMessagePayload {
+    roomId: string;
+    content: string;
+    fileUrl?: string;
+    fileType?: string;
+    fileName?: string;
+}
+export interface TypingPayload {
+    roomId: string;
+    userId: string;
+    userName: string;
+    typing?: boolean;
+    content?: string;
+}
+export interface PresencePayload {
+    userId: string;
+    status: 'online' | 'offline' | 'away';
+}
+export interface CallSignalingPayload {
+    roomId: string;
+    initiatorId: string;
+    participantId: string;
+    offer?: RTCSessionDescription;
+    answer?: RTCSessionDescription;
+    candidate?: RTCIceCandidate;
+}
+export interface FileUploadPayload {
+    roomId: string;
+    fileName: string;
+    fileSize: number;
+    fileType: string;
+}
+export interface FileUploadResponse {
+    success: boolean;
+    fileUrl: string;
+    fileName: string;
+    error?: string;
+}
+export interface ChatConfig {
+    apiKey: string;
+    mongoUri?: string;
+    mode?: 'managed' | 'external-db';
+    version?: string;
+    validationUrl?: string;
+    jwtSecret?: string;
+    jwtIssuer?: string;
+    jwtAudience?: string;
+    iceServers?: RTCIceServer[];
+    turnServers?: TurnServerConfig[];
+    rateLimit?: {
+        messagesPerMinute?: number;
+        eventsPerMinute?: number;
+    };
+    hooks?: ChatHooks;
+    ringtoneUrl?: string;
+}
+export interface ChatHooks {
+    beforeMessageCreate?: (message: Message, user: AuthContext) => Message;
+    afterMessageCreate?: (message: Message) => void;
+    beforeRoomCreate?: (room: Room, user: AuthContext) => Room;
+    afterRoomCreate?: (room: Room) => void;
+}
+export declare const SDK_VERSION = "1.0.0";
+export declare const SDK_MIN_COMPATIBLE_VERSION = "1.0.0";
+export declare const SDK_MAX_COMPATIBLE_VERSION = "1.9.999";
+export interface TurnServerConfig {
+    urls: string;
+    username?: string;
+    credential?: string;
+}
+export interface AuthContext {
+    userId: string;
+    tenantId: string;
+    roles: string[];
+}
+export interface VersionCheckResult {
+    compatible: boolean;
+    severity: 'ok' | 'warning' | 'error';
+    message: string;
+}
+export interface PaginatedMessages {
+    messages: Message[];
+    hasMore: boolean;
+    nextCursor: string | null;
+}
+export interface GetMessagesPayload {
+    roomId: string;
+    limit?: number;
+    beforeCursor?: string;
+}
+export interface RateLimitExceededPayload {
+    code: 'RATE_LIMIT_EXCEEDED';
+    message: string;
+    retryAfterMs?: number;
+}
+export interface AdminTenantStats {
+    tenantId: string;
+    totalMessages: number;
+    totalRooms: number;
+    activeConnections: number;
+    lastActivity: Date;
+}
+export declare function deriveDatabaseFromApiKey(apiKey: string): string | null;
+export * from './apikey';

package/dist/esm/index.js

@@ -0,0 +1,19 @@
+// ============================================
+// @enfin/chat-shared - Core Types
+// ============================================
+// SDK Version
+export const SDK_VERSION = '1.0.0';
+export const SDK_MIN_COMPATIBLE_VERSION = '1.0.0';
+export const SDK_MAX_COMPATIBLE_VERSION = '1.9.999';
+// Derive tenant database name from API key
+export function deriveDatabaseFromApiKey(apiKey) {
+    const parts = apiKey.split('_');
+    if (parts.length !== 3 || parts[0] !== 'chat')
+        return null;
+    const tenantId = parts[1];
+    if (!tenantId)
+        return null;
+    return `chat_${tenantId}`;
+}
+// Re-export API key utilities
+export * from './apikey';

package/dist/index.d.ts

@@ -0,0 +1,164 @@
+export interface ApiKeyValidationResponse {
+    valid: boolean;
+    apiKey: string;
+    mode: 'managed' | 'external-db';
+    database?: string;
+    version: string;
+    tenantId: string;
+    error?: string;
+}
+export interface Message {
+    _id: string;
+    roomId: string;
+    senderId: string;
+    senderName: string;
+    senderAvatar?: string;
+    content: string;
+    fileUrl?: string;
+    fileType?: string;
+    fileName?: string;
+    createdAt: Date;
+    updatedAt: Date;
+    readBy: ReadReceipt[];
+}
+export interface ReadReceipt {
+    userId: string;
+    readAt: Date;
+}
+export interface Room {
+    _id: string;
+    name: string;
+    type: 'direct' | 'group';
+    members: string[];
+    createdBy: string;
+    createdAt: Date;
+    updatedAt: Date;
+    lastMessage?: string | Message;
+    lastActivity: Date;
+    avatar?: string;
+}
+export interface PresenceStatus {
+    userId: string;
+    status: 'online' | 'offline' | 'away';
+    lastSeen: Date;
+    typingIn?: string[];
+}
+export interface AudioCall {
+    _id: string;
+    roomId: string;
+    initiatorId: string;
+    participantId: string;
+    status: 'ringing' | 'active' | 'ended';
+    startedAt: Date;
+    endedAt?: Date;
+    duration?: number;
+}
+export interface SocketMessage {
+    type: string;
+    data: any;
+    timestamp: number;
+}
+export interface SendMessagePayload {
+    roomId: string;
+    content: string;
+    fileUrl?: string;
+    fileType?: string;
+    fileName?: string;
+}
+export interface TypingPayload {
+    roomId: string;
+    userId: string;
+    userName: string;
+    typing?: boolean;
+    content?: string;
+}
+export interface PresencePayload {
+    userId: string;
+    status: 'online' | 'offline' | 'away';
+}
+export interface CallSignalingPayload {
+    roomId: string;
+    initiatorId: string;
+    participantId: string;
+    offer?: RTCSessionDescription;
+    answer?: RTCSessionDescription;
+    candidate?: RTCIceCandidate;
+}
+export interface FileUploadPayload {
+    roomId: string;
+    fileName: string;
+    fileSize: number;
+    fileType: string;
+}
+export interface FileUploadResponse {
+    success: boolean;
+    fileUrl: string;
+    fileName: string;
+    error?: string;
+}
+export interface ChatConfig {
+    apiKey: string;
+    mongoUri?: string;
+    mode?: 'managed' | 'external-db';
+    version?: string;
+    validationUrl?: string;
+    jwtSecret?: string;
+    jwtIssuer?: string;
+    jwtAudience?: string;
+    iceServers?: RTCIceServer[];
+    turnServers?: TurnServerConfig[];
+    rateLimit?: {
+        messagesPerMinute?: number;
+        eventsPerMinute?: number;
+    };
+    hooks?: ChatHooks;
+    ringtoneUrl?: string;
+}
+export interface ChatHooks {
+    beforeMessageCreate?: (message: Message, user: AuthContext) => Message;
+    afterMessageCreate?: (message: Message) => void;
+    beforeRoomCreate?: (room: Room, user: AuthContext) => Room;
+    afterRoomCreate?: (room: Room) => void;
+}
+export declare const SDK_VERSION = "1.0.0";
+export declare const SDK_MIN_COMPATIBLE_VERSION = "1.0.0";
+export declare const SDK_MAX_COMPATIBLE_VERSION = "1.9.999";
+export interface TurnServerConfig {
+    urls: string;
+    username?: string;
+    credential?: string;
+}
+export interface AuthContext {
+    userId: string;
+    tenantId: string;
+    roles: string[];
+}
+export interface VersionCheckResult {
+    compatible: boolean;
+    severity: 'ok' | 'warning' | 'error';
+    message: string;
+}
+export interface PaginatedMessages {
+    messages: Message[];
+    hasMore: boolean;
+    nextCursor: string | null;
+}
+export interface GetMessagesPayload {
+    roomId: string;
+    limit?: number;
+    beforeCursor?: string;
+}
+export interface RateLimitExceededPayload {
+    code: 'RATE_LIMIT_EXCEEDED';
+    message: string;
+    retryAfterMs?: number;
+}
+export interface AdminTenantStats {
+    tenantId: string;
+    totalMessages: number;
+    totalRooms: number;
+    activeConnections: number;
+    lastActivity: Date;
+}
+export declare function deriveDatabaseFromApiKey(apiKey: string): string | null;
+export * from './apikey';

package/dist/index.js

@@ -0,0 +1,37 @@
+"use strict";
+// ============================================
+// @enfin/chat-shared - Core Types
+// ============================================
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SDK_MAX_COMPATIBLE_VERSION = exports.SDK_MIN_COMPATIBLE_VERSION = exports.SDK_VERSION = void 0;
+exports.deriveDatabaseFromApiKey = deriveDatabaseFromApiKey;
+// SDK Version
+exports.SDK_VERSION = '1.0.0';
+exports.SDK_MIN_COMPATIBLE_VERSION = '1.0.0';
+exports.SDK_MAX_COMPATIBLE_VERSION = '1.9.999';
+// Derive tenant database name from API key
+function deriveDatabaseFromApiKey(apiKey) {
+    const parts = apiKey.split('_');
+    if (parts.length !== 3 || parts[0] !== 'chat')
+        return null;
+    const tenantId = parts[1];
+    if (!tenantId)
+        return null;
+    return `chat_${tenantId}`;
+}
+// Re-export API key utilities
+__exportStar(require("./apikey"), exports);

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@enfin/chat-shared",
+  "version": "1.2.0",
+  "description": "Shared types and utilities for chat platform SDKs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "module": "dist/esm/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.json --module esnext --outDir dist/esm",
+    "prepublishOnly": "npm run build",
+    "dev": "tsc --watch",
+    "test": "jest"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/node": "^20.0.0"
+  },
+  "files": [
+    "dist",
+    "src"
+  ]
+}

package/src/apikey.ts

@@ -0,0 +1,74 @@
+// API Key generation and validation utilities
+
+const BASE62_CHARS = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
+
+/**
+ * Generate a random API key for chat platform
+ * Format: chat_{tenantId}_{checksum}
+ */
+export function generateApiKey(tenantId: string): string {
+  const randomPart = generateRandomString(10);
+  return `chat_${tenantId}_${randomPart}`;
+}
+
+/**
+ * Generate a random tenant ID
+ */
+export function generateTenantId(): string {
+  return generateRandomString(8);
+}
+
+/**
+ * Generate a random string of specified length using Base62
+ */
+function generateRandomString(length: number): string {
+  let result = '';
+  for (let i = 0; i < length; i++) {
+    result += BASE62_CHARS[Math.floor(Math.random() * BASE62_CHARS.length)];
+  }
+  return result;
+}
+
+/**
+ * Validate API key format
+ * Returns true if format is correct: chat_{tenantId}_{random}
+ */
+export function validateApiKeyFormat(apiKey: string): boolean {
+  const parts = apiKey.split('_');
+  return (
+    parts.length === 3 &&
+    parts[0] === 'chat' &&
+    parts[1].length >= 6 &&
+    parts[2].length >= 6
+  );
+}
+
+/**
+ * Extract tenant ID from API key
+ * Format: chat_{tenantId}_{random}
+ */
+export function extractTenantId(apiKey: string): string | null {
+  const parts = apiKey.split('_');
+  if (parts.length !== 3 || parts[0] !== 'chat') return null;
+  return parts[1];
+}
+
+/**
+ * Generate a checksum for API key validation
+ */
+export function generateChecksum(apiKey: string): string {
+  let hash = 0;
+  for (let i = 0; i < apiKey.length; i++) {
+    const char = apiKey.charCodeAt(i);
+    hash = (hash << 5) - hash + char;
+    hash = hash & hash;
+  }
+  return Math.abs(hash).toString(36);
+}
+
+/**
+ * Validate API key with checksum
+ */
+export function validateApiKeyWithChecksum(apiKey: string, expectedChecksum: string): boolean {
+  return generateChecksum(apiKey) === expectedChecksum;
+}

package/src/index.ts

@@ -0,0 +1,216 @@
+// ============================================
+// @enfin/chat-shared - Core Types
+// ============================================
+
+// API Key Validation Types
+export interface ApiKeyValidationResponse {
+  valid: boolean;
+  apiKey: string;
+  mode: 'managed' | 'external-db';
+  database?: string;
+  version: string;
+  tenantId: string;
+  error?: string;
+}
+
+// Message Types
+export interface Message {
+  _id: string;
+  roomId: string;
+  senderId: string;
+  senderName: string;
+  senderAvatar?: string;
+  content: string;
+  fileUrl?: string;
+  fileType?: string;
+  fileName?: string;
+  createdAt: Date;
+  updatedAt: Date;
+  readBy: ReadReceipt[];
+}
+
+export interface ReadReceipt {
+  userId: string;
+  readAt: Date;
+}
+
+// Room Types
+export interface Room {
+  _id: string;
+  name: string;
+  type: 'direct' | 'group';
+  members: string[];
+  createdBy: string;
+  createdAt: Date;
+  updatedAt: Date;
+  lastMessage?: string | Message;
+  lastActivity: Date;
+  avatar?: string;
+}
+
+// User Presence Types
+export interface PresenceStatus {
+  userId: string;
+  status: 'online' | 'offline' | 'away';
+  lastSeen: Date;
+  typingIn?: string[];
+}
+
+// Audio Call Types
+export interface AudioCall {
+  _id: string;
+  roomId: string;
+  initiatorId: string;
+  participantId: string;
+  status: 'ringing' | 'active' | 'ended';
+  startedAt: Date;
+  endedAt?: Date;
+  duration?: number;
+}
+
+// Socket Events
+export interface SocketMessage {
+  type: string;
+  data: any;
+  timestamp: number;
+}
+
+export interface SendMessagePayload {
+  roomId: string;
+  content: string;
+  fileUrl?: string;
+  fileType?: string;
+  fileName?: string;
+}
+
+export interface TypingPayload {
+  roomId: string;
+  userId: string;
+  userName: string;
+  typing?: boolean;
+  content?: string;
+}
+
+export interface PresencePayload {
+  userId: string;
+  status: 'online' | 'offline' | 'away';
+}
+
+export interface CallSignalingPayload {
+  roomId: string;
+  initiatorId: string;
+  participantId: string;
+  offer?: RTCSessionDescription;
+  answer?: RTCSessionDescription;
+  candidate?: RTCIceCandidate;
+}
+
+// File Upload Types
+export interface FileUploadPayload {
+  roomId: string;
+  fileName: string;
+  fileSize: number;
+  fileType: string;
+}
+
+export interface FileUploadResponse {
+  success: boolean;
+  fileUrl: string;
+  fileName: string;
+  error?: string;
+}
+
+// Configuration Types
+export interface ChatConfig {
+  apiKey: string;
+  mongoUri?: string;
+  mode?: 'managed' | 'external-db';
+  version?: string;
+  validationUrl?: string;
+  jwtSecret?: string;
+  jwtIssuer?: string;
+  jwtAudience?: string;
+  iceServers?: RTCIceServer[];
+  turnServers?: TurnServerConfig[];
+  rateLimit?: {
+    messagesPerMinute?: number;
+    eventsPerMinute?: number;
+  };
+  hooks?: ChatHooks;
+  ringtoneUrl?: string;
+}
+
+// Chat Hooks for customization
+export interface ChatHooks {
+  beforeMessageCreate?: (message: Message, user: AuthContext) => Message;
+  afterMessageCreate?: (message: Message) => void;
+  beforeRoomCreate?: (room: Room, user: AuthContext) => Room;
+  afterRoomCreate?: (room: Room) => void;
+}
+
+// SDK Version
+export const SDK_VERSION = '1.0.0';
+export const SDK_MIN_COMPATIBLE_VERSION = '1.0.0';
+export const SDK_MAX_COMPATIBLE_VERSION = '1.9.999';
+
+// TURN Server Config
+export interface TurnServerConfig {
+  urls: string;
+  username?: string;
+  credential?: string;
+}
+
+// Auth Context
+export interface AuthContext {
+  userId: string;
+  tenantId: string;
+  roles: string[];
+}
+
+// Version Check Result
+export interface VersionCheckResult {
+  compatible: boolean;
+  severity: 'ok' | 'warning' | 'error';
+  message: string;
+}
+
+// Paginated Messages
+export interface PaginatedMessages {
+  messages: Message[];
+  hasMore: boolean;
+  nextCursor: string | null;
+}
+
+export interface GetMessagesPayload {
+  roomId: string;
+  limit?: number;
+  beforeCursor?: string;
+}
+
+// Rate Limit Event
+export interface RateLimitExceededPayload {
+  code: 'RATE_LIMIT_EXCEEDED';
+  message: string;
+  retryAfterMs?: number;
+}
+
+// Admin Tenant Stats
+export interface AdminTenantStats {
+  tenantId: string;
+  totalMessages: number;
+  totalRooms: number;
+  activeConnections: number;
+  lastActivity: Date;
+}
+
+// Derive tenant database name from API key
+export function deriveDatabaseFromApiKey(apiKey: string): string | null {
+  const parts = apiKey.split('_');
+  if (parts.length !== 3 || parts[0] !== 'chat') return null;
+  const tenantId = parts[1];
+  if (!tenantId) return null;
+  return `chat_${tenantId}`;
+}
+
+// Re-export API key utilities
+export * from './apikey';