\n\n## Description\n\nOpenAI module for [Nest](https://github.com/nestjs/nest) based on the official [openai](https://www.npmjs.com/package/openai) package.\n\n## Installation\n\n```bash\n$ npm i --save @bytebitlabs/nest-openai openai\n```\n\n## Usage\n\nImport `OpenAiModule`:\n\n```typescript\n@Module({\n imports: [OpenAiModule.register({\n apiKey: 'Abc...',\n })],\n providers: [...],\n})\nexport class AiModule {}\n```\n\nInject `OpenAiService`:\n\n```typescript\n@Injectable()\nexport class AiService {\n constructor(private readonly openAiService: OpenAiService) {}\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\nOpenAiModule.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\nOpenAiModule.registerAsync({\n imports: [ConfigModule],\n useFactory: async (configService: ConfigService) => ({\n apiKey: configService.get('OPENAI_API_KEY'),\n }),\n inject: [ConfigService],\n}),\n```\n\n**2. Use class**\n\n```typescript\nOpenAiModule.registerAsync({\n useClass: OpenAiConfigService\n});\n```\n\nAbove construction will instantiate `OpenAiConfigService` inside `OpenAiModule` and will leverage it to create options object.\n\n```typescript\nclass OpenAiConfigService implements OpenaiOptionsFactory {\n createOpenAiOptions(): OpenAiModuleOptions {\n return {\n apiKey: 'Abc...'\n };\n }\n}\n```\n\n**3. Use existing**\n\n```typescript\nOpenAiModule.registerAsync({\n imports: [ConfigModule],\n useExisting: ConfigService,\n}),\n```\n\nIt works the same as `useClass` with one critical difference - `OpenAiModule` will lookup imported modules to reuse already created `ConfigService`, instead of instantiating it on its own.\n\n## API Spec\n\nThe `OpenAiService` wraps the `Client` from the official [openai](https://www.npmjs.com/package/openai) methods. The `OpenAiModule.register()` takes `options` object as an argument, [read more](https://platform.openai.com/docs/overview).\n","readmeFilename":"README.md"}
![\"ByteBitLabs](\"https://gravatar.com/avatar/61c80d73dfe4c4231e77940cf80fd410?size=256\")
![\"NPM](\"https://img.shields.io/npm/v/@bytebitlabs/nest-openai\")
![\"Package](\"https://img.shields.io/npm/l/@bytebitlabs/nest-openai\")
![\"NPM](\"https://img.shields.io/npm/dm/@bytebitlabs/nest-openai\")