@bernierllc/chat-suite 1.4.0 → 2.0.1

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [2.0.1](https://github.com/bernierllc/tools/compare/@bernierllc/chat-suite@1.5.0...@bernierllc/chat-suite@2.0.1) (2026-05-20)
+
+**Note:** Version bump only for package @bernierllc/chat-suite
+
+
+
+
+
+# 1.5.0 (2026-05-20)
+
+
+### Features
+
+* **validators-a11y-focus-order:** es2022, errors.ts with error.cause ([cfa9604](https://github.com/bernierllc/tools/commit/cfa96049636732b7961b5dab3a2a1cdc8a2a9480))
+
+
+
+
+
 # 1.4.0 (2026-05-20)
 
 

package/__tests__/unit/errors.test.ts

@@ -0,0 +1,42 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+
+import { ChatSuiteError } from '../../src/errors';
+
+describe('ChatSuiteError (ES2022)', () => {
+  it('preserves cause chain via native Error.cause', () => {
+    const original = new Error('boom');
+    const wrapped = new ChatSuiteError('outer failure', {
+      code: 'PROVIDER_ERROR',
+      cause: original
+    });
+
+    expect(wrapped).toBeInstanceOf(ChatSuiteError);
+    expect(wrapped).toBeInstanceOf(Error);
+    expect(wrapped.message).toBe('outer failure');
+    expect(wrapped.code).toBe('PROVIDER_ERROR');
+    expect(wrapped.cause).toBe(original);
+  });
+
+  it('defaults code to CHAT_SUITE_ERROR when not provided', () => {
+    const err = new ChatSuiteError('something went wrong');
+    expect(err.code).toBe('CHAT_SUITE_ERROR');
+    expect(err.cause).toBeUndefined();
+    expect(err.context).toBeUndefined();
+    expect(err.name).toBe('ChatSuiteError');
+  });
+
+  it('preserves structured context', () => {
+    const err = new ChatSuiteError('routing failed', {
+      code: 'ROUTING_ERROR',
+      context: { providerType: 'slack', attempts: 3 }
+    });
+    expect(err.context).toEqual({ providerType: 'slack', attempts: 3 });
+    expect(err.code).toBe('ROUTING_ERROR');
+  });
+});

package/dist/ChatSuite.js

@@ -22,9 +22,15 @@ const neverhub_1 = require("./neverhub");
  * Main chat suite orchestration class
  */
 class ChatSuite {
+    configManager;
+    userManager;
+    healthMonitor;
+    providerManager;
+    messageOrchestrator;
+    neverhubAdapter;
+    neverhubConnected = false;
+    initialized = false;
     constructor(config) {
-        this.neverhubConnected = false;
-        this.initialized = false;
         this.configManager = new ConfigManager_1.ConfigManager(config);
         this.userManager = new UserManager_1.UserManager();
         this.healthMonitor = new HealthMonitor_1.HealthMonitor();
@@ -44,7 +50,7 @@ class ChatSuite {
             // 2. Initialize ChatKit provider (always required)
             const chatKitResult = await this.initializeChatKitProvider(config);
             if (!chatKitResult.success) {
-                throw new error_handling_1.ChatSuiteError(error_handling_1.ChatSuiteErrorType.INITIALIZATION_ERROR, `Failed to initialize ChatKit: ${chatKitResult.error}`);
+                throw new error_handling_1.ChatSuiteError(`Failed to initialize ChatKit: ${chatKitResult.error}`, { code: 'INITIALIZATION_ERROR' });
             }
             // 3. Initialize message bridge (if configured)
             if (config.messageBridge) {

package/dist/errors.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Typed error code union for chat-suite errors.
+ *
+ * Replaces the previous `ChatSuiteErrorType` enum (removed in 2.0.0).
+ * Consumers should use the string literal directly, e.g. `'MESSAGE_ERROR'`.
+ */
+export type ChatSuiteErrorCode = 'CHAT_SUITE_ERROR' | 'PROVIDER_ERROR' | 'ROUTING_ERROR' | 'CONFIGURATION_ERROR' | 'INITIALIZATION_ERROR' | 'MESSAGE_ERROR' | 'NEVERHUB_ERROR';
+/**
+ * Options bag accepted by `ChatSuiteError`.
+ *
+ * - `cause`: chained underlying error (ES2022 Error.cause).
+ * - `code`: a typed error code from {@link ChatSuiteErrorCode}.
+ * - `context`: arbitrary structured context.
+ */
+export interface ChatSuiteErrorOptions {
+    cause?: Error;
+    code?: ChatSuiteErrorCode;
+    context?: Record<string, unknown>;
+}
+/**
+ * Custom error class for chat suite errors.
+ *
+ * Uses native ES2022 `Error.cause` for error chaining — read the underlying
+ * error via `error.cause`. Structured context lives on `error.context`.
+ */
+export declare class ChatSuiteError extends Error {
+    readonly code: ChatSuiteErrorCode;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, options?: ChatSuiteErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAC1B,kBAAkB,GAClB,gBAAgB,GAChB,eAAe,GACf,qBAAqB,GACrB,sBAAsB,GACtB,eAAe,GACf,gBAAgB,CAAC;AAErB;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,kBAAkB,CAAC;IACzC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB;CAS7D"}

package/dist/errors.js

@@ -0,0 +1,30 @@
+"use strict";
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatSuiteError = void 0;
+/**
+ * Custom error class for chat suite errors.
+ *
+ * Uses native ES2022 `Error.cause` for error chaining — read the underlying
+ * error via `error.cause`. Structured context lives on `error.context`.
+ */
+class ChatSuiteError extends Error {
+    code;
+    context;
+    constructor(message, options) {
+        super(message, options?.cause ? { cause: options.cause } : undefined);
+        this.name = 'ChatSuiteError';
+        this.code = options?.code ?? 'CHAT_SUITE_ERROR';
+        if (options?.context !== undefined) {
+            this.context = options.context;
+        }
+        Error.captureStackTrace?.(this, this.constructor);
+    }
+}
+exports.ChatSuiteError = ChatSuiteError;

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { ChatSuite } from './ChatSuite';
+export { ChatSuiteError, type ChatSuiteErrorCode, type ChatSuiteErrorOptions } from './errors';
 export * from './types';
 export * from './services';
 export * from './providers';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,cAAc,SAAS,CAAC;AAGxB,cAAc,YAAY,CAAC;AAG3B,cAAc,aAAa,CAAC;AAG5B,cAAc,SAAS,CAAC;AAGxB,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EACL,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC3B,MAAM,UAAU,CAAC;AAGlB,cAAc,SAAS,CAAC;AAGxB,cAAc,YAAY,CAAC;AAG3B,cAAc,aAAa,CAAC;AAG5B,cAAc,SAAS,CAAC;AAGxB,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -21,10 +21,13 @@ 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.ChatSuite = void 0;
+exports.ChatSuiteError = exports.ChatSuite = void 0;
 // Main export
 var ChatSuite_1 = require("./ChatSuite");
 Object.defineProperty(exports, "ChatSuite", { enumerable: true, get: function () { return ChatSuite_1.ChatSuite; } });
+// Errors
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "ChatSuiteError", { enumerable: true, get: function () { return errors_1.ChatSuiteError; } });
 // Types
 __exportStar(require("./types"), exports);
 // Services

package/dist/providers/ChatKitProvider.js

@@ -15,12 +15,16 @@ const chatkit_adapter_1 = require("@bernierllc/chatkit-adapter");
  * ChatKit provider implementation
  */
 class ChatKitProvider {
+    config;
+    type = 'chatkit';
+    name = '@bernierllc/chatkit-adapter';
+    adapter;
+    initialized = false;
+    errorCount = 0;
+    lastError;
+    initTime;
     constructor(config = {}) {
         this.config = config;
-        this.type = 'chatkit';
-        this.name = '@bernierllc/chatkit-adapter';
-        this.initialized = false;
-        this.errorCount = 0;
     }
     /**
      * Initialize the ChatKit provider

package/dist/providers/ExternalProviders.js

@@ -15,9 +15,7 @@ exports.getAvailableProviders = getAvailableProviders;
  * These are optional peer dependencies and will be implemented when those packages are available
  */
 class ExternalProvider {
-    constructor() {
-        this.initialized = false;
-    }
+    initialized = false;
     async initialize() {
         throw new Error(`${this.name} provider is not implemented yet. ` +
             `Install ${this.name} package to enable this provider.`);
@@ -64,10 +62,10 @@ class ExternalProvider {
  * ```
  */
 class SlackProvider extends ExternalProvider {
+    type = 'slack';
+    name = '@bernierllc/chat-integration-slack';
     constructor(_config) {
         super();
-        this.type = 'slack';
-        this.name = '@bernierllc/chat-integration-slack';
     }
 }
 exports.SlackProvider = SlackProvider;
@@ -92,10 +90,10 @@ exports.SlackProvider = SlackProvider;
  * ```
  */
 class DiscordProvider extends ExternalProvider {
+    type = 'discord';
+    name = '@bernierllc/chat-integration-discord';
     constructor(_config) {
         super();
-        this.type = 'discord';
-        this.name = '@bernierllc/chat-integration-discord';
     }
 }
 exports.DiscordProvider = DiscordProvider;
@@ -121,10 +119,10 @@ exports.DiscordProvider = DiscordProvider;
  * ```
  */
 class TeamsProvider extends ExternalProvider {
+    type = 'teams';
+    name = '@bernierllc/chat-integration-teams';
     constructor(_config) {
         super();
-        this.type = 'teams';
-        this.name = '@bernierllc/chat-integration-teams';
     }
 }
 exports.TeamsProvider = TeamsProvider;

package/dist/services/ConfigManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigManager.d.ts","sourceRoot":"","sources":["../../src/services/ConfigManager.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAIhD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,eAAe,CAAmC;gBAE9C,aAAa,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAKpD;;OAEG;IACI,SAAS,IAAI,QAAQ,CAAC,eAAe,CAAC;IAI7C;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAM5D;;OAEG;IACI,GAAG,CAAC,CAAC,SAAS,MAAM,eAAe,EAAE,GAAG,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAIvE;;OAEG;IACI,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAIrD;;OAEG;IACI,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACI,cAAc,IAAI,IAAI;IAI7B;;OAEG;IACI,KAAK,IAAI,IAAI;IAKpB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;OAEG;IACI,MAAM,IAAI,MAAM;IAIvB;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAYpC"}
+{"version":3,"file":"ConfigManager.d.ts","sourceRoot":"","sources":["../../src/services/ConfigManager.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAIhD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,eAAe,CAAmC;gBAE9C,aAAa,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAKpD;;OAEG;IACI,SAAS,IAAI,QAAQ,CAAC,eAAe,CAAC;IAI7C;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAM5D;;OAEG;IACI,GAAG,CAAC,CAAC,SAAS,MAAM,eAAe,EAAE,GAAG,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAIvE;;OAEG;IACI,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAIrD;;OAEG;IACI,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACI,cAAc,IAAI,IAAI;IAI7B;;OAEG;IACI,KAAK,IAAI,IAAI;IAKpB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;OAEG;IACI,MAAM,IAAI,MAAM;IAIvB;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAcpC"}

package/dist/services/ConfigManager.js

@@ -14,8 +14,9 @@ const error_handling_1 = require("../utils/error-handling");
  * Manages chat suite configuration with validation and inheritance
  */
 class ConfigManager {
+    config;
+    configOverrides = new Map();
     constructor(initialConfig) {
-        this.configOverrides = new Map();
         this.config = (0, config_inheritance_1.mergeConfigs)(config_inheritance_1.DEFAULT_SUITE_CONFIG, initialConfig || {});
         this.validateConfiguration();
     }
@@ -70,7 +71,7 @@ class ConfigManager {
     validateConfiguration(config = this.config) {
         const validation = (0, config_inheritance_1.validateConfig)(config);
         if (!validation.valid) {
-            throw new error_handling_1.ChatSuiteError(error_handling_1.ChatSuiteErrorType.CONFIGURATION_ERROR, `Configuration validation failed: ${validation.errors.join(', ')}`);
+            throw new error_handling_1.ChatSuiteError(`Configuration validation failed: ${validation.errors.join(', ')}`, { code: 'CONFIGURATION_ERROR' });
         }
     }
     /**
@@ -88,7 +89,10 @@ class ConfigManager {
             this.updateConfig(parsed);
         }
         catch (error) {
-            throw new error_handling_1.ChatSuiteError(error_handling_1.ChatSuiteErrorType.CONFIGURATION_ERROR, 'Failed to parse configuration JSON', error instanceof Error ? error : undefined);
+            throw new error_handling_1.ChatSuiteError('Failed to parse configuration JSON', {
+                code: 'CONFIGURATION_ERROR',
+                cause: error instanceof Error ? error : undefined
+            });
         }
     }
 }

package/dist/services/HealthMonitor.js

@@ -12,9 +12,9 @@ exports.HealthMonitor = void 0;
  * Monitors health of all chat suite components
  */
 class HealthMonitor {
-    constructor() {
-        this.providers = new Map();
-    }
+    providers = new Map();
+    lastHealthCheck;
+    healthCheckInterval;
     /**
      * Register a provider for health monitoring
      */

package/dist/services/MessageOrchestrator.js

@@ -14,9 +14,8 @@ const error_handling_1 = require("../utils/error-handling");
  * Orchestrates messages across all providers
  */
 class MessageOrchestrator {
-    constructor() {
-        this.messages = new Map();
-    }
+    messageBridge;
+    messages = new Map();
     /**
      * Set message bridge for cross-platform sync
      */
@@ -101,7 +100,7 @@ class MessageOrchestrator {
     async bridgeMessage(sourceProvider, targetProvider, message) {
         try {
             if (!this.messageBridge) {
-                throw new error_handling_1.ChatSuiteError(error_handling_1.ChatSuiteErrorType.CONFIGURATION_ERROR, 'Message bridge not configured');
+                throw new error_handling_1.ChatSuiteError('Message bridge not configured', { code: 'CONFIGURATION_ERROR' });
             }
             if (!this.messageBridge.shouldBridge(sourceProvider.type, targetProvider.type)) {
                 return {

package/dist/services/ProviderManager.js

@@ -13,10 +13,8 @@ const error_handling_1 = require("../utils/error-handling");
  * Manages all chat providers
  */
 class ProviderManager {
-    constructor() {
-        this.providers = new Map();
-        this.initializedProviders = new Set();
-    }
+    providers = new Map();
+    initializedProviders = new Set();
     /**
      * Register a provider
      */
@@ -171,7 +169,7 @@ class ProviderManager {
      */
     unregisterProvider(providerType) {
         if (this.initializedProviders.has(providerType)) {
-            throw new error_handling_1.ChatSuiteError(error_handling_1.ChatSuiteErrorType.PROVIDER_ERROR, `Cannot unregister initialized provider ${providerType}. Shutdown first.`);
+            throw new error_handling_1.ChatSuiteError(`Cannot unregister initialized provider ${providerType}. Shutdown first.`, { code: 'PROVIDER_ERROR' });
         }
         const deleted = this.providers.delete(providerType);
         if (!deleted) {

package/dist/services/UserManager.js

@@ -13,6 +13,7 @@ const user_mapping_1 = require("../utils/user-mapping");
  * Manages users across all chat providers
  */
 class UserManager {
+    mapper;
     constructor() {
         this.mapper = new user_mapping_1.UserMapper();
     }

package/dist/utils/error-handling.d.ts

@@ -1,27 +1,14 @@
 import type { SuiteResult } from '../types';
+import { ChatSuiteError, type ChatSuiteErrorCode, type ChatSuiteErrorOptions } from '../errors';
+export { ChatSuiteError };
+export type { ChatSuiteErrorCode, ChatSuiteErrorOptions };
 /**
- * Chat suite error types
+ * Safely execute an async operation and return a SuiteResult.
+ *
+ * The optional `errorCode` parameter is used to prefix the returned error
+ * string (matching the previous `${type}: message` format).
  */
-export declare enum ChatSuiteErrorType {
-    PROVIDER_ERROR = "PROVIDER_ERROR",
-    ROUTING_ERROR = "ROUTING_ERROR",
-    CONFIGURATION_ERROR = "CONFIGURATION_ERROR",
-    INITIALIZATION_ERROR = "INITIALIZATION_ERROR",
-    MESSAGE_ERROR = "MESSAGE_ERROR",
-    NEVERHUB_ERROR = "NEVERHUB_ERROR"
-}
-/**
- * Custom error class for chat suite errors
- */
-export declare class ChatSuiteError extends Error {
-    type: ChatSuiteErrorType;
-    originalError?: Error | undefined;
-    constructor(type: ChatSuiteErrorType, message: string, originalError?: Error | undefined);
-}
-/**
- * Safely execute an async operation and return a SuiteResult
- */
-export declare function safeExecute<T>(operation: () => Promise<T>, errorType?: ChatSuiteErrorType): Promise<SuiteResult<T>>;
+export declare function safeExecute<T>(operation: () => Promise<T>, errorCode?: ChatSuiteErrorCode): Promise<SuiteResult<T>>;
 /**
  * Retry an operation with exponential backoff
  */

package/dist/utils/error-handling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handling.d.ts","sourceRoot":"","sources":["../../src/utils/error-handling.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,cAAc,mBAAmB;IACjC,aAAa,kBAAkB;IAC/B,mBAAmB,wBAAwB;IAC3C,oBAAoB,yBAAyB;IAC7C,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;CAClC;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IAE9B,IAAI,EAAE,kBAAkB;IAExB,aAAa,CAAC,EAAE,KAAK;gBAFrB,IAAI,EAAE,kBAAkB,EAC/B,OAAO,EAAE,MAAM,EACR,aAAa,CAAC,EAAE,KAAK,YAAA;CAM/B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,SAAS,GAAE,kBAAqD,GAC/D,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAWzB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,UAAU,GAAE,MAAU,EACtB,SAAS,GAAE,MAAa,GACvB,OAAO,CAAC,CAAC,CAAC,CAiBZ;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAYxD"}
+{"version":3,"file":"error-handling.d.ts","sourceRoot":"","sources":["../../src/utils/error-handling.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EACL,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC3B,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,CAAC;AAE1D;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,SAAS,GAAE,kBAAoC,GAC9C,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAWzB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,UAAU,GAAE,MAAU,EACtB,SAAS,GAAE,MAAa,GACvB,OAAO,CAAC,CAAC,CAAC,CAiBZ;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAWxD"}

package/dist/utils/error-handling.js

@@ -7,40 +7,20 @@ The client may use and modify this code *only within the scope of the project it
 Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
 */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ChatSuiteError = exports.ChatSuiteErrorType = void 0;
+exports.ChatSuiteError = void 0;
 exports.safeExecute = safeExecute;
 exports.retryOperation = retryOperation;
 exports.formatError = formatError;
 exports.isRetryableError = isRetryableError;
+const errors_1 = require("../errors");
+Object.defineProperty(exports, "ChatSuiteError", { enumerable: true, get: function () { return errors_1.ChatSuiteError; } });
 /**
- * Chat suite error types
+ * Safely execute an async operation and return a SuiteResult.
+ *
+ * The optional `errorCode` parameter is used to prefix the returned error
+ * string (matching the previous `${type}: message` format).
  */
-var ChatSuiteErrorType;
-(function (ChatSuiteErrorType) {
-    ChatSuiteErrorType["PROVIDER_ERROR"] = "PROVIDER_ERROR";
-    ChatSuiteErrorType["ROUTING_ERROR"] = "ROUTING_ERROR";
-    ChatSuiteErrorType["CONFIGURATION_ERROR"] = "CONFIGURATION_ERROR";
-    ChatSuiteErrorType["INITIALIZATION_ERROR"] = "INITIALIZATION_ERROR";
-    ChatSuiteErrorType["MESSAGE_ERROR"] = "MESSAGE_ERROR";
-    ChatSuiteErrorType["NEVERHUB_ERROR"] = "NEVERHUB_ERROR";
-})(ChatSuiteErrorType || (exports.ChatSuiteErrorType = ChatSuiteErrorType = {}));
-/**
- * Custom error class for chat suite errors
- */
-class ChatSuiteError extends Error {
-    constructor(type, message, originalError) {
-        super(message);
-        this.type = type;
-        this.originalError = originalError;
-        this.name = 'ChatSuiteError';
-        Object.setPrototypeOf(this, ChatSuiteError.prototype);
-    }
-}
-exports.ChatSuiteError = ChatSuiteError;
-/**
- * Safely execute an async operation and return a SuiteResult
- */
-async function safeExecute(operation, errorType = ChatSuiteErrorType.MESSAGE_ERROR) {
+async function safeExecute(operation, errorCode = 'MESSAGE_ERROR') {
     try {
         const data = await operation();
         return { success: true, data };
@@ -49,7 +29,7 @@ async function safeExecute(operation, errorType = ChatSuiteErrorType.MESSAGE_ERR
         const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
         return {
             success: false,
-            error: `${errorType}: ${errorMessage}`
+            error: `${errorCode}: ${errorMessage}`
         };
     }
 }
@@ -76,8 +56,8 @@ async function retryOperation(operation, maxRetries = 3, baseDelay = 1000) {
  * Create a standardized error message
  */
 function formatError(context, error) {
-    if (error instanceof ChatSuiteError) {
-        return `[${context}] ${error.type}: ${error.message}`;
+    if (error instanceof errors_1.ChatSuiteError) {
+        return `[${context}] ${error.code}: ${error.message}`;
     }
     if (error instanceof Error) {
         return `[${context}] ${error.message}`;
@@ -88,9 +68,8 @@ function formatError(context, error) {
  * Check if an error is retryable
  */
 function isRetryableError(error) {
-    if (error instanceof ChatSuiteError) {
-        return error.type === ChatSuiteErrorType.PROVIDER_ERROR ||
-            error.type === ChatSuiteErrorType.MESSAGE_ERROR;
+    if (error instanceof errors_1.ChatSuiteError) {
+        return error.code === 'PROVIDER_ERROR' || error.code === 'MESSAGE_ERROR';
     }
     if (error instanceof Error) {
         const message = error.message.toLowerCase();

package/dist/utils/message-bridge.js

@@ -12,10 +12,11 @@ exports.MessageBridge = void 0;
  * Message bridge for cross-platform synchronization
  */
 class MessageBridge {
+    config;
+    bridgedMessages = new Map();
+    channelMappings = new Map();
     constructor(config) {
         this.config = config;
-        this.bridgedMessages = new Map();
-        this.channelMappings = new Map();
         if (config.channelMappings) {
             this.channelMappings = config.channelMappings;
         }

package/dist/utils/user-mapping.js

@@ -13,10 +13,8 @@ exports.createUnifiedId = createUnifiedId;
  * User mapping storage
  */
 class UserMapper {
-    constructor() {
-        this.identities = new Map();
-        this.providerIndex = new Map(); // provider:userId -> unifiedId
-    }
+    identities = new Map();
+    providerIndex = new Map(); // provider:userId -> unifiedId
     /**
      * Create or update a user identity
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bernierllc/chat-suite",
-  "version": "1.4.0",
+  "version": "2.0.1",
   "description": "Comprehensive chat orchestration suite with AI-powered routing",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -21,7 +21,7 @@
     "zod": "^3.22.0",
     "@bernierllc/chat-ai-router": "1.6.0",
     "@bernierllc/chat-analytics": "1.6.0",
-    "@bernierllc/chatkit-adapter": "1.4.0",
+    "@bernierllc/chatkit-adapter": "1.5.0",
     "@bernierllc/neverhub-adapter": "0.4.0"
   },
   "peerDependenciesMeta": {

package/src/ChatSuite.ts

@@ -25,7 +25,7 @@ import { ProviderManager } from './services/ProviderManager';
 import { MessageOrchestrator } from './services/MessageOrchestrator';
 import { ChatKitProvider } from './providers/ChatKitProvider';
 import { MessageBridge } from './utils/message-bridge';
-import { ChatSuiteError, ChatSuiteErrorType } from './utils/error-handling';
+import { ChatSuiteError } from './utils/error-handling';
 import {
   registerWithNeverHub,
   unregisterFromNeverHub,
@@ -74,8 +74,8 @@ export class ChatSuite {
       const chatKitResult = await this.initializeChatKitProvider(config);
       if (!chatKitResult.success) {
         throw new ChatSuiteError(
-          ChatSuiteErrorType.INITIALIZATION_ERROR,
-          `Failed to initialize ChatKit: ${chatKitResult.error}`
+          `Failed to initialize ChatKit: ${chatKitResult.error}`,
+          { code: 'INITIALIZATION_ERROR' }
         );
       }
 

package/src/errors.ts

@@ -0,0 +1,56 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+
+/**
+ * Typed error code union for chat-suite errors.
+ *
+ * Replaces the previous `ChatSuiteErrorType` enum (removed in 2.0.0).
+ * Consumers should use the string literal directly, e.g. `'MESSAGE_ERROR'`.
+ */
+export type ChatSuiteErrorCode =
+  | 'CHAT_SUITE_ERROR'
+  | 'PROVIDER_ERROR'
+  | 'ROUTING_ERROR'
+  | 'CONFIGURATION_ERROR'
+  | 'INITIALIZATION_ERROR'
+  | 'MESSAGE_ERROR'
+  | 'NEVERHUB_ERROR';
+
+/**
+ * Options bag accepted by `ChatSuiteError`.
+ *
+ * - `cause`: chained underlying error (ES2022 Error.cause).
+ * - `code`: a typed error code from {@link ChatSuiteErrorCode}.
+ * - `context`: arbitrary structured context.
+ */
+export interface ChatSuiteErrorOptions {
+  cause?: Error;
+  code?: ChatSuiteErrorCode;
+  context?: Record<string, unknown>;
+}
+
+/**
+ * Custom error class for chat suite errors.
+ *
+ * Uses native ES2022 `Error.cause` for error chaining — read the underlying
+ * error via `error.cause`. Structured context lives on `error.context`.
+ */
+export class ChatSuiteError extends Error {
+  public readonly code: ChatSuiteErrorCode;
+  public readonly context?: Record<string, unknown>;
+
+  constructor(message: string, options?: ChatSuiteErrorOptions) {
+    super(message, options?.cause ? { cause: options.cause } : undefined);
+    this.name = 'ChatSuiteError';
+    this.code = options?.code ?? 'CHAT_SUITE_ERROR';
+    if (options?.context !== undefined) {
+      this.context = options.context;
+    }
+    Error.captureStackTrace?.(this, this.constructor);
+  }
+}

package/src/index.ts

@@ -9,6 +9,13 @@ Redistribution or use in other products or commercial offerings is not permitted
 // Main export
 export { ChatSuite } from './ChatSuite';
 
+// Errors
+export {
+  ChatSuiteError,
+  type ChatSuiteErrorCode,
+  type ChatSuiteErrorOptions
+} from './errors';
+
 // Types
 export * from './types';
 

package/src/services/ConfigManager.ts

@@ -8,7 +8,7 @@ Redistribution or use in other products or commercial offerings is not permitted
 
 import type { ChatSuiteConfig } from '../types';
 import { DEFAULT_SUITE_CONFIG, mergeConfigs, validateConfig } from '../utils/config-inheritance';
-import { ChatSuiteError, ChatSuiteErrorType } from '../utils/error-handling';
+import { ChatSuiteError } from '../utils/error-handling';
 
 /**
  * Manages chat suite configuration with validation and inheritance
@@ -81,8 +81,8 @@ export class ConfigManager {
     const validation = validateConfig(config);
     if (!validation.valid) {
       throw new ChatSuiteError(
-        ChatSuiteErrorType.CONFIGURATION_ERROR,
-        `Configuration validation failed: ${validation.errors.join(', ')}`
+        `Configuration validation failed: ${validation.errors.join(', ')}`,
+        { code: 'CONFIGURATION_ERROR' }
       );
     }
   }
@@ -103,9 +103,11 @@ export class ConfigManager {
       this.updateConfig(parsed);
     } catch (error) {
       throw new ChatSuiteError(
-        ChatSuiteErrorType.CONFIGURATION_ERROR,
         'Failed to parse configuration JSON',
-        error instanceof Error ? error : undefined
+        {
+          code: 'CONFIGURATION_ERROR',
+          cause: error instanceof Error ? error : undefined
+        }
       );
     }
   }

package/src/services/MessageOrchestrator.ts

@@ -17,7 +17,7 @@ import type {
 } from '../types';
 import { MessagePriority, MessageStatus } from '../types';
 import { MessageBridge } from '../utils/message-bridge';
-import { ChatSuiteError, ChatSuiteErrorType, retryOperation } from '../utils/error-handling';
+import { ChatSuiteError, retryOperation } from '../utils/error-handling';
 
 /**
  * Orchestrates messages across all providers
@@ -135,8 +135,8 @@ export class MessageOrchestrator {
     try {
       if (!this.messageBridge) {
         throw new ChatSuiteError(
-          ChatSuiteErrorType.CONFIGURATION_ERROR,
-          'Message bridge not configured'
+          'Message bridge not configured',
+          { code: 'CONFIGURATION_ERROR' }
         );
       }
 

package/src/services/ProviderManager.ts

@@ -7,7 +7,7 @@ Redistribution or use in other products or commercial offerings is not permitted
 */
 
 import type { Provider, ProviderType, SuiteResult } from '../types';
-import { ChatSuiteError, ChatSuiteErrorType } from '../utils/error-handling';
+import { ChatSuiteError } from '../utils/error-handling';
 
 /**
  * Provider registration information
@@ -204,8 +204,8 @@ export class ProviderManager {
   public unregisterProvider(providerType: ProviderType): SuiteResult<void> {
     if (this.initializedProviders.has(providerType)) {
       throw new ChatSuiteError(
-        ChatSuiteErrorType.PROVIDER_ERROR,
-        `Cannot unregister initialized provider ${providerType}. Shutdown first.`
+        `Cannot unregister initialized provider ${providerType}. Shutdown first.`,
+        { code: 'PROVIDER_ERROR' }
       );
     }
 

package/src/utils/error-handling.ts

@@ -7,40 +7,24 @@ Redistribution or use in other products or commercial offerings is not permitted
 */
 
 import type { SuiteResult } from '../types';
+import {
+  ChatSuiteError,
+  type ChatSuiteErrorCode,
+  type ChatSuiteErrorOptions
+} from '../errors';
 
-/**
- * Chat suite error types
- */
-export enum ChatSuiteErrorType {
-  PROVIDER_ERROR = 'PROVIDER_ERROR',
-  ROUTING_ERROR = 'ROUTING_ERROR',
-  CONFIGURATION_ERROR = 'CONFIGURATION_ERROR',
-  INITIALIZATION_ERROR = 'INITIALIZATION_ERROR',
-  MESSAGE_ERROR = 'MESSAGE_ERROR',
-  NEVERHUB_ERROR = 'NEVERHUB_ERROR'
-}
-
-/**
- * Custom error class for chat suite errors
- */
-export class ChatSuiteError extends Error {
-  constructor(
-    public type: ChatSuiteErrorType,
-    message: string,
-    public originalError?: Error
-  ) {
-    super(message);
-    this.name = 'ChatSuiteError';
-    Object.setPrototypeOf(this, ChatSuiteError.prototype);
-  }
-}
+export { ChatSuiteError };
+export type { ChatSuiteErrorCode, ChatSuiteErrorOptions };
 
 /**
- * Safely execute an async operation and return a SuiteResult
+ * Safely execute an async operation and return a SuiteResult.
+ *
+ * The optional `errorCode` parameter is used to prefix the returned error
+ * string (matching the previous `${type}: message` format).
  */
 export async function safeExecute<T>(
   operation: () => Promise<T>,
-  errorType: ChatSuiteErrorType = ChatSuiteErrorType.MESSAGE_ERROR
+  errorCode: ChatSuiteErrorCode = 'MESSAGE_ERROR'
 ): Promise<SuiteResult<T>> {
   try {
     const data = await operation();
@@ -49,7 +33,7 @@ export async function safeExecute<T>(
     const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
     return {
       success: false,
-      error: `${errorType}: ${errorMessage}`
+      error: `${errorCode}: ${errorMessage}`
     };
   }
 }
@@ -88,7 +72,7 @@ export function formatError(
   error: unknown
 ): string {
   if (error instanceof ChatSuiteError) {
-    return `[${context}] ${error.type}: ${error.message}`;
+    return `[${context}] ${error.code}: ${error.message}`;
   }
   if (error instanceof Error) {
     return `[${context}] ${error.message}`;
@@ -101,8 +85,7 @@ export function formatError(
  */
 export function isRetryableError(error: unknown): boolean {
   if (error instanceof ChatSuiteError) {
-    return error.type === ChatSuiteErrorType.PROVIDER_ERROR ||
-           error.type === ChatSuiteErrorType.MESSAGE_ERROR;
+    return error.code === 'PROVIDER_ERROR' || error.code === 'MESSAGE_ERROR';
   }
   if (error instanceof Error) {
     const message = error.message.toLowerCase();

package/tsconfig.json

@@ -1,9 +1,9 @@
 {
   "compilerOptions": {
-    "target": "ES2020",
+    "target": "ES2022",
     "module": "commonjs",
-    "lib": ["ES2020"],
-    "types": ["node"],
+    "lib": ["ES2022"],
+    "types": ["node", "jest"],
     "declaration": true,
     "declarationMap": true,
     "outDir": "./dist",