@macpaw/ai-sdk 0.1.0

package/dist/nestjs/index.cjs

@@ -0,0 +1,149 @@
+'use strict';
+
+var chunkN26BDEG5_cjs = require('../chunk-N26BDEG5.cjs');
+var common = require('@nestjs/common');
+
+// src/nestjs/ai-gateway.constants.ts
+var AI_GATEWAY_CONFIG = /* @__PURE__ */ Symbol("AI_GATEWAY_CONFIG");
+var AI_GATEWAY_OPTIONS = /* @__PURE__ */ Symbol("AI_GATEWAY_OPTIONS");
+
+// src/nestjs/ai-gateway.module.ts
+var _AIGatewayModule_decorators, _init;
+_AIGatewayModule_decorators = [common.Module({})];
+var _AIGatewayModule = class _AIGatewayModule {
+  /**
+   * Register the module with a static configuration.
+   *
+   * @example
+   * ```ts
+   * @Module({
+   *   imports: [
+   *     AIGatewayModule.forRoot({
+   *       env: 'production',
+   *       getAuthToken: async () => myTokenService.getToken(),
+   *     }),
+   *   ],
+   * })
+   * export class AppModule {}
+   * ```
+   */
+  static forRoot(options) {
+    const { isGlobal, ...clientConfig } = options;
+    const configProvider = {
+      provide: AI_GATEWAY_CONFIG,
+      useFactory: () => clientConfig
+    };
+    return {
+      module: _AIGatewayModule,
+      global: isGlobal ?? true,
+      providers: [configProvider],
+      exports: [configProvider]
+    };
+  }
+  /**
+   * Register the module with async/dynamic configuration.
+   * Supports `useFactory`, `useClass`, and `useExisting` patterns.
+   *
+   * @example
+   * ```ts
+   * @Module({
+   *   imports: [
+   *     ConfigModule.forRoot(),
+   *     AIGatewayModule.forRootAsync({
+   *       imports: [ConfigModule],
+   *       useFactory: (configService: ConfigService) => ({
+   *         env: configService.get('AI_GATEWAY_ENV'),
+   *         getAuthToken: async () => configService.get('AI_GATEWAY_TOKEN'),
+   *       }),
+   *       inject: [ConfigService],
+   *     }),
+   *   ],
+   * })
+   * export class AppModule {}
+   * ```
+   */
+  static forRootAsync(options) {
+    const configProvider = {
+      provide: AI_GATEWAY_CONFIG,
+      useFactory: ({ isGlobal: _isGlobal, ...clientConfig }) => clientConfig,
+      inject: [AI_GATEWAY_OPTIONS]
+    };
+    const asyncProviders = this.createAsyncProviders(options);
+    return {
+      module: _AIGatewayModule,
+      global: options.isGlobal ?? true,
+      imports: options.imports ?? [],
+      providers: [...asyncProviders, configProvider],
+      exports: [configProvider]
+    };
+  }
+  static createAsyncProviders(options) {
+    if (options.useFactory) {
+      return [
+        {
+          provide: AI_GATEWAY_OPTIONS,
+          useFactory: options.useFactory,
+          inject: options.inject ?? []
+        }
+      ];
+    }
+    const factoryClass = options.useClass ?? options.useExisting;
+    if (!factoryClass) {
+      throw new Error("AIGatewayModule.forRootAsync() requires useFactory, useClass, or useExisting");
+    }
+    const providers = [
+      {
+        provide: AI_GATEWAY_OPTIONS,
+        useFactory: (factory) => factory.createAIGatewayOptions(),
+        inject: [factoryClass]
+      }
+    ];
+    if (options.useClass) {
+      providers.push({ provide: factoryClass, useClass: factoryClass });
+    }
+    return providers;
+  }
+};
+_init = chunkN26BDEG5_cjs.__decoratorStart(null);
+_AIGatewayModule = chunkN26BDEG5_cjs.__decorateElement(_init, 0, "AIGatewayModule", _AIGatewayModule_decorators, _AIGatewayModule);
+chunkN26BDEG5_cjs.__runInitializers(_init, 1, _AIGatewayModule);
+var AIGatewayModule = _AIGatewayModule;
+var _AIGatewayExceptionFilter_decorators, _init2;
+_AIGatewayExceptionFilter_decorators = [common.Catch(chunkN26BDEG5_cjs.AIGatewayError)];
+exports.AIGatewayExceptionFilter = class AIGatewayExceptionFilter {
+  catch(exception, host) {
+    const ctx = host.switchToHttp();
+    const response = ctx.getResponse();
+    const status = this.mapStatusCode(exception.statusCode);
+    const body = {
+      statusCode: status,
+      error: exception.code,
+      message: exception.message
+    };
+    if (exception.metadata?.requestId != null) body.requestId = exception.metadata.requestId;
+    if (exception.metadata?.paymentUrl != null) body.paymentUrl = exception.metadata.paymentUrl;
+    if (exception.metadata?.retryAfter != null) body.retryAfter = exception.metadata.retryAfter;
+    if (typeof response.status === "function" && typeof response.json === "function") {
+      if (exception.metadata?.retryAfter != null && typeof response.header === "function") {
+        response.header("Retry-After", String(exception.metadata.retryAfter));
+      }
+      response.status(status).json(body);
+    } else {
+      throw new common.HttpException(body, status);
+    }
+  }
+  mapStatusCode(sdkStatus) {
+    if (sdkStatus >= 400 && sdkStatus < 600) return sdkStatus;
+    return common.HttpStatus.BAD_GATEWAY;
+  }
+};
+_init2 = chunkN26BDEG5_cjs.__decoratorStart(null);
+exports.AIGatewayExceptionFilter = chunkN26BDEG5_cjs.__decorateElement(_init2, 0, "AIGatewayExceptionFilter", _AIGatewayExceptionFilter_decorators, exports.AIGatewayExceptionFilter);
+chunkN26BDEG5_cjs.__runInitializers(_init2, 1, exports.AIGatewayExceptionFilter);
+var InjectAIGateway = () => common.Inject(AI_GATEWAY_CONFIG);
+
+exports.AIGatewayModule = AIGatewayModule;
+exports.AI_GATEWAY_CONFIG = AI_GATEWAY_CONFIG;
+exports.InjectAIGateway = InjectAIGateway;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/nestjs/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/nestjs/ai-gateway.constants.ts","../../src/nestjs/ai-gateway.module.ts","../../src/nestjs/ai-gateway.filter.ts","../../src/nestjs/ai-gateway.decorators.ts"],"names":["Module","__decoratorStart","__decorateElement","__runInitializers","_init","Catch","AIGatewayError","AIGatewayExceptionFilter","HttpException","HttpStatus","Inject"],"mappings":"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","file":"index.cjs","sourcesContent":["/** Injection token for the GatewayProviderSettings object. */\nexport const AI_GATEWAY_CONFIG = Symbol('AI_GATEWAY_CONFIG');\n\n/** Injection token for the module config options. */\nexport const AI_GATEWAY_OPTIONS = Symbol('AI_GATEWAY_OPTIONS');\n","import type { DynamicModule, Provider, Type } from '@nestjs/common';\nimport { Module } from '@nestjs/common';\nimport type { GatewayProviderSettings } from '../gateway-config';\nimport { AI_GATEWAY_CONFIG, AI_GATEWAY_OPTIONS } from './ai-gateway.constants';\nimport type { AIGatewayModuleOptions, AIGatewayModuleAsyncOptions, AIGatewayOptionsFactory } from './ai-gateway.types';\n\n@Module({})\nexport class AIGatewayModule {\n  /**\n   * Register the module with a static configuration.\n   *\n   * @example\n   * ```ts\n   * @Module({\n   *   imports: [\n   *     AIGatewayModule.forRoot({\n   *       env: 'production',\n   *       getAuthToken: async () => myTokenService.getToken(),\n   *     }),\n   *   ],\n   * })\n   * export class AppModule {}\n   * ```\n   */\n  static forRoot(options: AIGatewayModuleOptions): DynamicModule {\n    const { isGlobal, ...clientConfig } = options;\n    const configProvider: Provider<GatewayProviderSettings> = {\n      provide: AI_GATEWAY_CONFIG,\n      useFactory: () => clientConfig,\n    };\n\n    return {\n      module: AIGatewayModule,\n      global: isGlobal ?? true,\n      providers: [configProvider],\n      exports: [configProvider],\n    };\n  }\n\n  /**\n   * Register the module with async/dynamic configuration.\n   * Supports `useFactory`, `useClass`, and `useExisting` patterns.\n   *\n   * @example\n   * ```ts\n   * @Module({\n   *   imports: [\n   *     ConfigModule.forRoot(),\n   *     AIGatewayModule.forRootAsync({\n   *       imports: [ConfigModule],\n   *       useFactory: (configService: ConfigService) => ({\n   *         env: configService.get('AI_GATEWAY_ENV'),\n   *         getAuthToken: async () => configService.get('AI_GATEWAY_TOKEN'),\n   *       }),\n   *       inject: [ConfigService],\n   *     }),\n   *   ],\n   * })\n   * export class AppModule {}\n   * ```\n   */\n  static forRootAsync(options: AIGatewayModuleAsyncOptions): DynamicModule {\n    const configProvider: Provider<GatewayProviderSettings> = {\n      provide: AI_GATEWAY_CONFIG,\n      useFactory: ({ isGlobal: _isGlobal, ...clientConfig }: AIGatewayModuleOptions) =>\n        clientConfig as GatewayProviderSettings,\n      inject: [AI_GATEWAY_OPTIONS],\n    };\n\n    const asyncProviders = this.createAsyncProviders(options);\n\n    return {\n      module: AIGatewayModule,\n      global: options.isGlobal ?? true,\n      imports: options.imports ?? [],\n      providers: [...asyncProviders, configProvider],\n      exports: [configProvider],\n    };\n  }\n\n  private static createAsyncProviders(options: AIGatewayModuleAsyncOptions): Provider[] {\n    if (options.useFactory) {\n      return [\n        {\n          provide: AI_GATEWAY_OPTIONS,\n          useFactory: options.useFactory,\n          inject: options.inject ?? [],\n        },\n      ];\n    }\n\n    const factoryClass = (options.useClass ?? options.useExisting) as Type<AIGatewayOptionsFactory> | undefined;\n    if (!factoryClass) {\n      throw new Error('AIGatewayModule.forRootAsync() requires useFactory, useClass, or useExisting');\n    }\n\n    const providers: Provider[] = [\n      {\n        provide: AI_GATEWAY_OPTIONS,\n        useFactory: (factory: AIGatewayOptionsFactory) => factory.createAIGatewayOptions(),\n        inject: [factoryClass],\n      },\n    ];\n\n    if (options.useClass) {\n      providers.push({ provide: factoryClass, useClass: factoryClass });\n    }\n\n    return providers;\n  }\n}\n","import type { ArgumentsHost, ExceptionFilter } from '@nestjs/common';\nimport { Catch, HttpException, HttpStatus } from '@nestjs/common';\nimport { AIGatewayError } from '../gateway-errors';\n\n/**\n * NestJS exception filter that catches `AIGatewayError` and returns a structured HTTP response.\n *\n * Attach globally, per controller, or per route:\n *\n * @example\n * ```ts\n * // Global\n * app.useGlobalFilters(new AIGatewayExceptionFilter());\n *\n * // Per controller\n * @UseFilters(AIGatewayExceptionFilter)\n * @Controller('chat')\n * export class ChatController {}\n * ```\n */\n@Catch(AIGatewayError)\nexport class AIGatewayExceptionFilter implements ExceptionFilter {\n  catch(exception: AIGatewayError, host: ArgumentsHost): void {\n    const ctx = host.switchToHttp();\n    const response = ctx.getResponse();\n\n    const status = this.mapStatusCode(exception.statusCode);\n    const body: Record<string, unknown> = {\n      statusCode: status,\n      error: exception.code,\n      message: exception.message,\n    };\n\n    if (exception.metadata?.requestId != null) body.requestId = exception.metadata.requestId;\n    if (exception.metadata?.paymentUrl != null) body.paymentUrl = exception.metadata.paymentUrl;\n    if (exception.metadata?.retryAfter != null) body.retryAfter = exception.metadata.retryAfter;\n\n    if (typeof response.status === 'function' && typeof response.json === 'function') {\n      if (exception.metadata?.retryAfter != null && typeof response.header === 'function') {\n        response.header('Retry-After', String(exception.metadata.retryAfter));\n      }\n      response.status(status).json(body);\n    } else {\n      throw new HttpException(body, status);\n    }\n  }\n\n  private mapStatusCode(sdkStatus: number): number {\n    if (sdkStatus >= 400 && sdkStatus < 600) return sdkStatus;\n    return HttpStatus.BAD_GATEWAY;\n  }\n}\n","import { Inject } from '@nestjs/common';\nimport { AI_GATEWAY_CONFIG } from './ai-gateway.constants';\n\n/**\n * Injects the configured `GatewayProviderSettings` into a constructor parameter or property.\n *\n * @example\n * ```ts\n * @Injectable()\n * export class ChatService {\n *   constructor(@InjectAIGateway() private readonly config: GatewayProviderSettings) {}\n * }\n * ```\n */\nexport const InjectAIGateway = (): ParameterDecorator & PropertyDecorator => Inject(AI_GATEWAY_CONFIG);\n"]}

package/dist/nestjs/index.d.cts

@@ -0,0 +1,117 @@
+import { ModuleMetadata, Type, InjectionToken, OptionalFactoryDependency, DynamicModule, ExceptionFilter, ArgumentsHost } from '@nestjs/common';
+import { G as GatewayProviderSettings, A as AIGatewayError } from '../gateway-errors-DdgDIyQw.cjs';
+
+/**
+ * Synchronous module configuration.
+ * Used with `AIGatewayModule.forRoot(options)`.
+ */
+interface AIGatewayModuleOptions extends GatewayProviderSettings {
+    /** Whether the module is global (available without importing in every module). Default: true. */
+    isGlobal?: boolean;
+}
+/**
+ * Factory interface for creating options dynamically.
+ * Used with `AIGatewayModule.forRootAsync({ useClass: MyFactory })`.
+ */
+interface AIGatewayOptionsFactory {
+    createAIGatewayOptions(): Promise<AIGatewayModuleOptions> | AIGatewayModuleOptions;
+}
+/**
+ * Async module configuration.
+ * Used with `AIGatewayModule.forRootAsync(options)`.
+ */
+interface AIGatewayModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    /** Existing provider class that implements AIGatewayOptionsFactory. */
+    useExisting?: Type<AIGatewayOptionsFactory>;
+    /** Class to instantiate as the options factory. */
+    useClass?: Type<AIGatewayOptionsFactory>;
+    /** Factory function that returns the module options. */
+    useFactory?: (...args: unknown[]) => Promise<AIGatewayModuleOptions> | AIGatewayModuleOptions;
+    /** Dependencies to inject into useFactory. */
+    inject?: (InjectionToken | OptionalFactoryDependency)[];
+    /** Whether the module is global (available without importing in every module). Default: true. */
+    isGlobal?: boolean;
+}
+
+declare class AIGatewayModule {
+    /**
+     * Register the module with a static configuration.
+     *
+     * @example
+     * ```ts
+     * @Module({
+     *   imports: [
+     *     AIGatewayModule.forRoot({
+     *       env: 'production',
+     *       getAuthToken: async () => myTokenService.getToken(),
+     *     }),
+     *   ],
+     * })
+     * export class AppModule {}
+     * ```
+     */
+    static forRoot(options: AIGatewayModuleOptions): DynamicModule;
+    /**
+     * Register the module with async/dynamic configuration.
+     * Supports `useFactory`, `useClass`, and `useExisting` patterns.
+     *
+     * @example
+     * ```ts
+     * @Module({
+     *   imports: [
+     *     ConfigModule.forRoot(),
+     *     AIGatewayModule.forRootAsync({
+     *       imports: [ConfigModule],
+     *       useFactory: (configService: ConfigService) => ({
+     *         env: configService.get('AI_GATEWAY_ENV'),
+     *         getAuthToken: async () => configService.get('AI_GATEWAY_TOKEN'),
+     *       }),
+     *       inject: [ConfigService],
+     *     }),
+     *   ],
+     * })
+     * export class AppModule {}
+     * ```
+     */
+    static forRootAsync(options: AIGatewayModuleAsyncOptions): DynamicModule;
+    private static createAsyncProviders;
+}
+
+/**
+ * NestJS exception filter that catches `AIGatewayError` and returns a structured HTTP response.
+ *
+ * Attach globally, per controller, or per route:
+ *
+ * @example
+ * ```ts
+ * // Global
+ * app.useGlobalFilters(new AIGatewayExceptionFilter());
+ *
+ * // Per controller
+ * @UseFilters(AIGatewayExceptionFilter)
+ * @Controller('chat')
+ * export class ChatController {}
+ * ```
+ */
+declare class AIGatewayExceptionFilter implements ExceptionFilter {
+    catch(exception: AIGatewayError, host: ArgumentsHost): void;
+    private mapStatusCode;
+}
+
+/**
+ * Injects the configured `GatewayProviderSettings` into a constructor parameter or property.
+ *
+ * @example
+ * ```ts
+ * @Injectable()
+ * export class ChatService {
+ *   constructor(@InjectAIGateway() private readonly config: GatewayProviderSettings) {}
+ * }
+ * ```
+ */
+declare const InjectAIGateway: () => ParameterDecorator & PropertyDecorator;
+
+/** Injection token for the GatewayProviderSettings object. */
+declare const AI_GATEWAY_CONFIG: unique symbol;
+
+export { AIGatewayExceptionFilter, AIGatewayModule, type AIGatewayModuleAsyncOptions, type AIGatewayModuleOptions, type AIGatewayOptionsFactory, AI_GATEWAY_CONFIG, InjectAIGateway };

package/dist/nestjs/index.d.ts

@@ -0,0 +1,117 @@
+import { ModuleMetadata, Type, InjectionToken, OptionalFactoryDependency, DynamicModule, ExceptionFilter, ArgumentsHost } from '@nestjs/common';
+import { G as GatewayProviderSettings, A as AIGatewayError } from '../gateway-errors-DdgDIyQw.js';
+
+/**
+ * Synchronous module configuration.
+ * Used with `AIGatewayModule.forRoot(options)`.
+ */
+interface AIGatewayModuleOptions extends GatewayProviderSettings {
+    /** Whether the module is global (available without importing in every module). Default: true. */
+    isGlobal?: boolean;
+}
+/**
+ * Factory interface for creating options dynamically.
+ * Used with `AIGatewayModule.forRootAsync({ useClass: MyFactory })`.
+ */
+interface AIGatewayOptionsFactory {
+    createAIGatewayOptions(): Promise<AIGatewayModuleOptions> | AIGatewayModuleOptions;
+}
+/**
+ * Async module configuration.
+ * Used with `AIGatewayModule.forRootAsync(options)`.
+ */
+interface AIGatewayModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    /** Existing provider class that implements AIGatewayOptionsFactory. */
+    useExisting?: Type<AIGatewayOptionsFactory>;
+    /** Class to instantiate as the options factory. */
+    useClass?: Type<AIGatewayOptionsFactory>;
+    /** Factory function that returns the module options. */
+    useFactory?: (...args: unknown[]) => Promise<AIGatewayModuleOptions> | AIGatewayModuleOptions;
+    /** Dependencies to inject into useFactory. */
+    inject?: (InjectionToken | OptionalFactoryDependency)[];
+    /** Whether the module is global (available without importing in every module). Default: true. */
+    isGlobal?: boolean;
+}
+
+declare class AIGatewayModule {
+    /**
+     * Register the module with a static configuration.
+     *
+     * @example
+     * ```ts
+     * @Module({
+     *   imports: [
+     *     AIGatewayModule.forRoot({
+     *       env: 'production',
+     *       getAuthToken: async () => myTokenService.getToken(),
+     *     }),
+     *   ],
+     * })
+     * export class AppModule {}
+     * ```
+     */
+    static forRoot(options: AIGatewayModuleOptions): DynamicModule;
+    /**
+     * Register the module with async/dynamic configuration.
+     * Supports `useFactory`, `useClass`, and `useExisting` patterns.
+     *
+     * @example
+     * ```ts
+     * @Module({
+     *   imports: [
+     *     ConfigModule.forRoot(),
+     *     AIGatewayModule.forRootAsync({
+     *       imports: [ConfigModule],
+     *       useFactory: (configService: ConfigService) => ({
+     *         env: configService.get('AI_GATEWAY_ENV'),
+     *         getAuthToken: async () => configService.get('AI_GATEWAY_TOKEN'),
+     *       }),
+     *       inject: [ConfigService],
+     *     }),
+     *   ],
+     * })
+     * export class AppModule {}
+     * ```
+     */
+    static forRootAsync(options: AIGatewayModuleAsyncOptions): DynamicModule;
+    private static createAsyncProviders;
+}
+
+/**
+ * NestJS exception filter that catches `AIGatewayError` and returns a structured HTTP response.
+ *
+ * Attach globally, per controller, or per route:
+ *
+ * @example
+ * ```ts
+ * // Global
+ * app.useGlobalFilters(new AIGatewayExceptionFilter());
+ *
+ * // Per controller
+ * @UseFilters(AIGatewayExceptionFilter)
+ * @Controller('chat')
+ * export class ChatController {}
+ * ```
+ */
+declare class AIGatewayExceptionFilter implements ExceptionFilter {
+    catch(exception: AIGatewayError, host: ArgumentsHost): void;
+    private mapStatusCode;
+}
+
+/**
+ * Injects the configured `GatewayProviderSettings` into a constructor parameter or property.
+ *
+ * @example
+ * ```ts
+ * @Injectable()
+ * export class ChatService {
+ *   constructor(@InjectAIGateway() private readonly config: GatewayProviderSettings) {}
+ * }
+ * ```
+ */
+declare const InjectAIGateway: () => ParameterDecorator & PropertyDecorator;
+
+/** Injection token for the GatewayProviderSettings object. */
+declare const AI_GATEWAY_CONFIG: unique symbol;
+
+export { AIGatewayExceptionFilter, AIGatewayModule, type AIGatewayModuleAsyncOptions, type AIGatewayModuleOptions, type AIGatewayOptionsFactory, AI_GATEWAY_CONFIG, InjectAIGateway };

package/dist/nestjs/index.js

@@ -0,0 +1,145 @@
+import { __decoratorStart, __decorateElement, __runInitializers, AIGatewayError } from '../chunk-KGOVQRMH.js';
+import { Module, Catch, HttpException, HttpStatus, Inject } from '@nestjs/common';
+
+// src/nestjs/ai-gateway.constants.ts
+var AI_GATEWAY_CONFIG = /* @__PURE__ */ Symbol("AI_GATEWAY_CONFIG");
+var AI_GATEWAY_OPTIONS = /* @__PURE__ */ Symbol("AI_GATEWAY_OPTIONS");
+
+// src/nestjs/ai-gateway.module.ts
+var _AIGatewayModule_decorators, _init;
+_AIGatewayModule_decorators = [Module({})];
+var _AIGatewayModule = class _AIGatewayModule {
+  /**
+   * Register the module with a static configuration.
+   *
+   * @example
+   * ```ts
+   * @Module({
+   *   imports: [
+   *     AIGatewayModule.forRoot({
+   *       env: 'production',
+   *       getAuthToken: async () => myTokenService.getToken(),
+   *     }),
+   *   ],
+   * })
+   * export class AppModule {}
+   * ```
+   */
+  static forRoot(options) {
+    const { isGlobal, ...clientConfig } = options;
+    const configProvider = {
+      provide: AI_GATEWAY_CONFIG,
+      useFactory: () => clientConfig
+    };
+    return {
+      module: _AIGatewayModule,
+      global: isGlobal ?? true,
+      providers: [configProvider],
+      exports: [configProvider]
+    };
+  }
+  /**
+   * Register the module with async/dynamic configuration.
+   * Supports `useFactory`, `useClass`, and `useExisting` patterns.
+   *
+   * @example
+   * ```ts
+   * @Module({
+   *   imports: [
+   *     ConfigModule.forRoot(),
+   *     AIGatewayModule.forRootAsync({
+   *       imports: [ConfigModule],
+   *       useFactory: (configService: ConfigService) => ({
+   *         env: configService.get('AI_GATEWAY_ENV'),
+   *         getAuthToken: async () => configService.get('AI_GATEWAY_TOKEN'),
+   *       }),
+   *       inject: [ConfigService],
+   *     }),
+   *   ],
+   * })
+   * export class AppModule {}
+   * ```
+   */
+  static forRootAsync(options) {
+    const configProvider = {
+      provide: AI_GATEWAY_CONFIG,
+      useFactory: ({ isGlobal: _isGlobal, ...clientConfig }) => clientConfig,
+      inject: [AI_GATEWAY_OPTIONS]
+    };
+    const asyncProviders = this.createAsyncProviders(options);
+    return {
+      module: _AIGatewayModule,
+      global: options.isGlobal ?? true,
+      imports: options.imports ?? [],
+      providers: [...asyncProviders, configProvider],
+      exports: [configProvider]
+    };
+  }
+  static createAsyncProviders(options) {
+    if (options.useFactory) {
+      return [
+        {
+          provide: AI_GATEWAY_OPTIONS,
+          useFactory: options.useFactory,
+          inject: options.inject ?? []
+        }
+      ];
+    }
+    const factoryClass = options.useClass ?? options.useExisting;
+    if (!factoryClass) {
+      throw new Error("AIGatewayModule.forRootAsync() requires useFactory, useClass, or useExisting");
+    }
+    const providers = [
+      {
+        provide: AI_GATEWAY_OPTIONS,
+        useFactory: (factory) => factory.createAIGatewayOptions(),
+        inject: [factoryClass]
+      }
+    ];
+    if (options.useClass) {
+      providers.push({ provide: factoryClass, useClass: factoryClass });
+    }
+    return providers;
+  }
+};
+_init = __decoratorStart(null);
+_AIGatewayModule = __decorateElement(_init, 0, "AIGatewayModule", _AIGatewayModule_decorators, _AIGatewayModule);
+__runInitializers(_init, 1, _AIGatewayModule);
+var AIGatewayModule = _AIGatewayModule;
+var _AIGatewayExceptionFilter_decorators, _init2;
+_AIGatewayExceptionFilter_decorators = [Catch(AIGatewayError)];
+var AIGatewayExceptionFilter = class {
+  catch(exception, host) {
+    const ctx = host.switchToHttp();
+    const response = ctx.getResponse();
+    const status = this.mapStatusCode(exception.statusCode);
+    const body = {
+      statusCode: status,
+      error: exception.code,
+      message: exception.message
+    };
+    if (exception.metadata?.requestId != null) body.requestId = exception.metadata.requestId;
+    if (exception.metadata?.paymentUrl != null) body.paymentUrl = exception.metadata.paymentUrl;
+    if (exception.metadata?.retryAfter != null) body.retryAfter = exception.metadata.retryAfter;
+    if (typeof response.status === "function" && typeof response.json === "function") {
+      if (exception.metadata?.retryAfter != null && typeof response.header === "function") {
+        response.header("Retry-After", String(exception.metadata.retryAfter));
+      }
+      response.status(status).json(body);
+    } else {
+      throw new HttpException(body, status);
+    }
+  }
+  mapStatusCode(sdkStatus) {
+    if (sdkStatus >= 400 && sdkStatus < 600) return sdkStatus;
+    return HttpStatus.BAD_GATEWAY;
+  }
+};
+_init2 = __decoratorStart(null);
+AIGatewayExceptionFilter = __decorateElement(_init2, 0, "AIGatewayExceptionFilter", _AIGatewayExceptionFilter_decorators, AIGatewayExceptionFilter);
+__runInitializers(_init2, 1, AIGatewayExceptionFilter);
+var InjectAIGateway = () => Inject(AI_GATEWAY_CONFIG);
+
+export { AIGatewayExceptionFilter, AIGatewayModule, AI_GATEWAY_CONFIG, InjectAIGateway };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/nestjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/nestjs/ai-gateway.constants.ts","../../src/nestjs/ai-gateway.module.ts","../../src/nestjs/ai-gateway.filter.ts","../../src/nestjs/ai-gateway.decorators.ts"],"names":["_init"],"mappings":"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","file":"index.js","sourcesContent":["/** Injection token for the GatewayProviderSettings object. */\nexport const AI_GATEWAY_CONFIG = Symbol('AI_GATEWAY_CONFIG');\n\n/** Injection token for the module config options. */\nexport const AI_GATEWAY_OPTIONS = Symbol('AI_GATEWAY_OPTIONS');\n","import type { DynamicModule, Provider, Type } from '@nestjs/common';\nimport { Module } from '@nestjs/common';\nimport type { GatewayProviderSettings } from '../gateway-config';\nimport { AI_GATEWAY_CONFIG, AI_GATEWAY_OPTIONS } from './ai-gateway.constants';\nimport type { AIGatewayModuleOptions, AIGatewayModuleAsyncOptions, AIGatewayOptionsFactory } from './ai-gateway.types';\n\n@Module({})\nexport class AIGatewayModule {\n  /**\n   * Register the module with a static configuration.\n   *\n   * @example\n   * ```ts\n   * @Module({\n   *   imports: [\n   *     AIGatewayModule.forRoot({\n   *       env: 'production',\n   *       getAuthToken: async () => myTokenService.getToken(),\n   *     }),\n   *   ],\n   * })\n   * export class AppModule {}\n   * ```\n   */\n  static forRoot(options: AIGatewayModuleOptions): DynamicModule {\n    const { isGlobal, ...clientConfig } = options;\n    const configProvider: Provider<GatewayProviderSettings> = {\n      provide: AI_GATEWAY_CONFIG,\n      useFactory: () => clientConfig,\n    };\n\n    return {\n      module: AIGatewayModule,\n      global: isGlobal ?? true,\n      providers: [configProvider],\n      exports: [configProvider],\n    };\n  }\n\n  /**\n   * Register the module with async/dynamic configuration.\n   * Supports `useFactory`, `useClass`, and `useExisting` patterns.\n   *\n   * @example\n   * ```ts\n   * @Module({\n   *   imports: [\n   *     ConfigModule.forRoot(),\n   *     AIGatewayModule.forRootAsync({\n   *       imports: [ConfigModule],\n   *       useFactory: (configService: ConfigService) => ({\n   *         env: configService.get('AI_GATEWAY_ENV'),\n   *         getAuthToken: async () => configService.get('AI_GATEWAY_TOKEN'),\n   *       }),\n   *       inject: [ConfigService],\n   *     }),\n   *   ],\n   * })\n   * export class AppModule {}\n   * ```\n   */\n  static forRootAsync(options: AIGatewayModuleAsyncOptions): DynamicModule {\n    const configProvider: Provider<GatewayProviderSettings> = {\n      provide: AI_GATEWAY_CONFIG,\n      useFactory: ({ isGlobal: _isGlobal, ...clientConfig }: AIGatewayModuleOptions) =>\n        clientConfig as GatewayProviderSettings,\n      inject: [AI_GATEWAY_OPTIONS],\n    };\n\n    const asyncProviders = this.createAsyncProviders(options);\n\n    return {\n      module: AIGatewayModule,\n      global: options.isGlobal ?? true,\n      imports: options.imports ?? [],\n      providers: [...asyncProviders, configProvider],\n      exports: [configProvider],\n    };\n  }\n\n  private static createAsyncProviders(options: AIGatewayModuleAsyncOptions): Provider[] {\n    if (options.useFactory) {\n      return [\n        {\n          provide: AI_GATEWAY_OPTIONS,\n          useFactory: options.useFactory,\n          inject: options.inject ?? [],\n        },\n      ];\n    }\n\n    const factoryClass = (options.useClass ?? options.useExisting) as Type<AIGatewayOptionsFactory> | undefined;\n    if (!factoryClass) {\n      throw new Error('AIGatewayModule.forRootAsync() requires useFactory, useClass, or useExisting');\n    }\n\n    const providers: Provider[] = [\n      {\n        provide: AI_GATEWAY_OPTIONS,\n        useFactory: (factory: AIGatewayOptionsFactory) => factory.createAIGatewayOptions(),\n        inject: [factoryClass],\n      },\n    ];\n\n    if (options.useClass) {\n      providers.push({ provide: factoryClass, useClass: factoryClass });\n    }\n\n    return providers;\n  }\n}\n","import type { ArgumentsHost, ExceptionFilter } from '@nestjs/common';\nimport { Catch, HttpException, HttpStatus } from '@nestjs/common';\nimport { AIGatewayError } from '../gateway-errors';\n\n/**\n * NestJS exception filter that catches `AIGatewayError` and returns a structured HTTP response.\n *\n * Attach globally, per controller, or per route:\n *\n * @example\n * ```ts\n * // Global\n * app.useGlobalFilters(new AIGatewayExceptionFilter());\n *\n * // Per controller\n * @UseFilters(AIGatewayExceptionFilter)\n * @Controller('chat')\n * export class ChatController {}\n * ```\n */\n@Catch(AIGatewayError)\nexport class AIGatewayExceptionFilter implements ExceptionFilter {\n  catch(exception: AIGatewayError, host: ArgumentsHost): void {\n    const ctx = host.switchToHttp();\n    const response = ctx.getResponse();\n\n    const status = this.mapStatusCode(exception.statusCode);\n    const body: Record<string, unknown> = {\n      statusCode: status,\n      error: exception.code,\n      message: exception.message,\n    };\n\n    if (exception.metadata?.requestId != null) body.requestId = exception.metadata.requestId;\n    if (exception.metadata?.paymentUrl != null) body.paymentUrl = exception.metadata.paymentUrl;\n    if (exception.metadata?.retryAfter != null) body.retryAfter = exception.metadata.retryAfter;\n\n    if (typeof response.status === 'function' && typeof response.json === 'function') {\n      if (exception.metadata?.retryAfter != null && typeof response.header === 'function') {\n        response.header('Retry-After', String(exception.metadata.retryAfter));\n      }\n      response.status(status).json(body);\n    } else {\n      throw new HttpException(body, status);\n    }\n  }\n\n  private mapStatusCode(sdkStatus: number): number {\n    if (sdkStatus >= 400 && sdkStatus < 600) return sdkStatus;\n    return HttpStatus.BAD_GATEWAY;\n  }\n}\n","import { Inject } from '@nestjs/common';\nimport { AI_GATEWAY_CONFIG } from './ai-gateway.constants';\n\n/**\n * Injects the configured `GatewayProviderSettings` into a constructor parameter or property.\n *\n * @example\n * ```ts\n * @Injectable()\n * export class ChatService {\n *   constructor(@InjectAIGateway() private readonly config: GatewayProviderSettings) {}\n * }\n * ```\n */\nexport const InjectAIGateway = (): ParameterDecorator & PropertyDecorator => Inject(AI_GATEWAY_CONFIG);\n"]}