\n\n## Description\n\nAnthropic module for [Nest](https://github.com/nestjs/nest) based on the official [@anthropic-ai/sdk](https://www.npmjs.com/package/@anthropic-ai/sdk) package.\n\n## Installation\n\n```bash\n$ npm i --save @bytebitlabs/nest-anthropic @anthropic-ai/sdk\n```\n\n## Usage\n\nImport `AnthropicModule`:\n\n```typescript\n@Module({\n imports: [AnthropicModule.register({\n apiKey: 'Abc...',\n })],\n providers: [...],\n})\nexport class AiModule {}\n```\n\nInject `AnthropicService`:\n\n```typescript\n@Injectable()\nexport class AiService {\n constructor(private readonly anthropicService: AnthropicService) {}\n}\n```\n\n## Async options\n\nQuite often you might want to asynchronously pass your module options instead of passing them beforehand. In such case, use `registerAsync()` method, that provides a couple of various ways to deal with async data.\n\n**1. Use factory**\n\n```typescript\nAnthropicModule.registerAsync({\n useFactory: () => ({\n apiKey: 'Abc...'\n })\n});\n```\n\nObviously, our factory behaves like every other one (might be `async` and is able to inject dependencies through `inject`).\n\n```typescript\nAnthropicModule.registerAsync({\n imports: [ConfigModule],\n useFactory: async (configService: ConfigService) => ({\n apiKey: configService.get('ANTHROPIC_API_KEY'),\n }),\n inject: [ConfigService],\n}),\n```\n\n**2. Use class**\n\n```typescript\nAnthropicModule.registerAsync({\n useClass: AnthropicConfigService\n});\n```\n\nAbove construction will instantiate `AnthropicConfigService` inside `AnthropicModule` and will leverage it to create options object.\n\n```typescript\nclass AnthropicConfigService implements AnthropicOptionsFactory {\n createAnthropicOptions(): AnthropicModuleOptions {\n return {\n apiKey: 'Abc...'\n };\n }\n}\n```\n\n**3. Use existing**\n\n```typescript\nAnthropicModule.registerAsync({\n imports: [ConfigModule],\n useExisting: ConfigService,\n}),\n```\n\nIt works the same as `useClass` with one critical difference - `AnthropicModule` will lookup imported modules to reuse already created `ConfigService`, instead of instantiating it on its own.\n\n## API Spec\n\nThe `AnthropicService` wraps the `Client` from the official [@anthropic-ai/sdk](https://www.npmjs.com/package/@anthropic-ai/sdk) methods. The `AnthropicModule.register()` takes `options` object as an argument, [read more](https://docs.anthropic.com/en/api/getting-started).\n","readmeFilename":"README.md"}
![\"ByteBitLabs](\"https://gravatar.com/avatar/61c80d73dfe4c4231e77940cf80fd410?size=256\")
![\"NPM](\"https://img.shields.io/npm/v/@bytebitlabs/nest-anthropic\")
![\"Package](\"https://img.shields.io/npm/l/@bytebitlabs/nest-anthropic\")
![\"NPM](\"https://img.shields.io/npm/dm/@bytebitlabs/nest-anthropic\")