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