feat: Enhance Twurple error handling and configuration validation

- Added functions to create specific error messages for missing configuration and authentication provider.
- Implemented a utility function to ensure the presence of required configuration options for Twurple features.
- Updated connection initialization methods for API, Chat, and Pubsub to utilize the new configuration validation and error handling.

Author: tacxou

src/twurple.utils.ts

@@ -16,6 +16,45 @@ function createFeatureDisabledError(feature: TwurpleFeatureName, decoratorName:
   )
 }
 
+function createMissingConfigError(feature: TwurpleFeatureName): Error {
+  return new Error(
+    `Twurple feature "${feature}" is enabled but "options.config" is missing.`,
+  )
+}
+
+function createMissingAuthProviderError(feature: TwurpleFeatureName): Error {
+  return new Error(
+    `Twurple feature "${feature}" is enabled but "options.config.authProvider" is missing.`,
+  )
+}
+
+function getErrorMessage(error: unknown): string {
+  if (error instanceof Error) {
+    return error.message
+  }
+  return String(error)
+}
+
+function ensureTwurpleConfig(
+  feature: TwurpleFeatureName,
+  options: TwurpleModuleOptions,
+) {
+  const config = options?.config
+  if (!config) {
+    throw createMissingConfigError(feature)
+  }
+  if (!config.authProvider) {
+    throw createMissingAuthProviderError(feature)
+  }
+  return config
+}
+
+function createConnectionInitError(feature: TwurpleFeatureName, error: unknown): Error {
+  return new Error(
+    `Failed to initialize Twurple "${feature}" connection: ${getErrorMessage(error)}`,
+  )
+}
+
 function createDisabledFeatureProxy<T>(feature: TwurpleFeatureName, decoratorName: string): T {
   const throwFeatureDisabled = (): never => {
     throw createFeatureDisabledError(feature, decoratorName)
@@ -85,39 +124,41 @@ export async function createTwurpleApiConnection(options: TwurpleModuleOptions)
   if (!options?.features?.api) {
     return createDisabledFeatureProxy('api', 'InjectTwurpleApi')
   }
-  const { config } = options
-  Logger.verbose('Initialize TwurpleApi connection singletion...', 'TwurpleModule')
-  // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-  // @ts-ignore
-  const { ApiClient } = await import('@twurple/api')
-  return new ApiClient({ authProvider: config?.authProvider, ...config?.features?.api })
+  const config = ensureTwurpleConfig('api', options)
+  Logger.verbose('Initialize TwurpleApi connection singleton...', 'TwurpleModule')
+  try {
+    const { ApiClient } = await import('@twurple/api')
+    return new ApiClient({ authProvider: config.authProvider, ...config.features?.api })
+  } catch (error) {
+    throw createConnectionInitError('api', error)
+  }
 }
 
 export async function createTwurpleChatConnection(options: TwurpleModuleOptions) {
   if (!options?.features?.chat) {
     return createDisabledFeatureProxy('chat', 'InjectTwurpleChat')
   }
-  const { config } = options
-  Logger.verbose('Initialize TwurpleChat connection singletion...', 'TwurpleModule')
-  // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-  // @ts-ignore
-  const { ChatClient } = await import('@twurple/chat')
-  return new ChatClient({ authProvider: config?.authProvider, ...config?.features?.chat })
+  const config = ensureTwurpleConfig('chat', options)
+  Logger.verbose('Initialize TwurpleChat connection singleton...', 'TwurpleModule')
+  try {
+    const { ChatClient } = await import('@twurple/chat')
+    return new ChatClient({ authProvider: config.authProvider, ...config.features?.chat })
+  } catch (error) {
+    throw createConnectionInitError('chat', error)
+  }
 }
 
 
 export async function createTwurplePubsubConnection(options: TwurpleModuleOptions) {
   if (!options?.features?.pubsub) {
     return createDisabledFeatureProxy('pubsub', 'InjectTwurplePubsub')
   }
-  const { config } = options
-  Logger.verbose('Initialize TwurplePubsub connection singletion...', 'TwurpleModule')
-  // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-  // @ts-ignore
-  const { PubSubClient } = await import('@twurple/pubsub')
+  const config = ensureTwurpleConfig('pubsub', options)
+  Logger.verbose('Initialize TwurplePubsub connection singleton...', 'TwurpleModule')
   try {
-    return new PubSubClient({ authProvider: config?.authProvider, ...config?.features?.pubsub })
-  } catch (e) {
-    console.error('e', e)
+    const { PubSubClient } = await import('@twurple/pubsub')
+    return new PubSubClient({ authProvider: config.authProvider, ...config.features?.pubsub })
+  } catch (error) {
+    throw createConnectionInitError('pubsub', error)
   }
 }