@lyrolab/nest-shared 1.8.0 → 1.9.0

package/CHANGELOG.md

@@ -1,9 +1,9 @@
-# [1.8.0](https://github.com/lyrolab/nest-shared/compare/v1.7.1...v1.8.0) (2026-02-15)
+# [1.9.0](https://github.com/lyrolab/nest-shared/compare/v1.8.0...v1.9.0) (2026-03-06)
 
 
 ### Features
 
-* add shared auth module with Keycloak JWT support ([2cc2eaf](https://github.com/lyrolab/nest-shared/commit/2cc2eaf6af7d9a2b74d9d1be5a546ea769ec0513))
+* implement SharedAiModule with configuration options ([8d400a7](https://github.com/lyrolab/nest-shared/commit/8d400a7a145cc395fe807c7c89fa329ed91c392d))
 
 ## [1.0.1](https://github.com/lyrolab/nest-shared/compare/v1.0.0...v1.0.1) (2025-04-10)
 

package/README.md

@@ -27,14 +27,16 @@ npm install @lyrolab/nest-shared
 
 ```typescript
 import { SharedDatabaseModule } from "@lyrolab/nest-shared/database"
-import { AiModule } from "@lyrolab/nest-shared/ai"
+import { SharedAiModule } from "@lyrolab/nest-shared/ai"
 import { SharedQueueModule } from "@lyrolab/nest-shared/queue"
 import { SharedCacheModule } from "@lyrolab/nest-shared/cache"
 
 @Module({
   imports: [
     SharedDatabaseModule.forRoot(),
-    AiModule,
+    SharedAiModule.forRoot({
+      apiKey: "your-openrouter-api-key",
+    }),
     SharedQueueModule,
     SharedCacheModule.forRoot(),
   ],

package/dist/ai/ai.constants.d.ts

@@ -0,0 +1 @@
+export declare const AI_MODULE_OPTIONS = "AI_MODULE_OPTIONS";

package/dist/ai/ai.constants.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AI_MODULE_OPTIONS = void 0;
+exports.AI_MODULE_OPTIONS = "AI_MODULE_OPTIONS";
+//# sourceMappingURL=ai.constants.js.map

package/dist/ai/ai.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.constants.js","sourceRoot":"","sources":["../../src/ai/ai.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,iBAAiB,GAAG,mBAAmB,CAAA"}

package/dist/ai/index.d.ts

@@ -1,2 +1,4 @@
 export * from "./shared-ai.module";
+export * from "./ai.constants";
+export * from "./interfaces/ai-module-options.interface";
 export * from "./services/ai.service";

package/dist/ai/index.js

@@ -15,5 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./shared-ai.module"), exports);
+__exportStar(require("./ai.constants"), exports);
+__exportStar(require("./interfaces/ai-module-options.interface"), exports);
 __exportStar(require("./services/ai.service"), exports);
 //# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAkC;AAClC,wDAAqC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAkC;AAClC,iDAA8B;AAC9B,2EAAwD;AACxD,wDAAqC"}

package/dist/ai/interfaces/ai-module-options.interface.d.ts

@@ -0,0 +1,15 @@
+import { ModuleMetadata, Type } from "@nestjs/common";
+export interface AiModuleOptions {
+    apiKey: string;
+    defaultModel?: string;
+    cacheTtlMs?: number;
+}
+export interface AiModuleAsyncOptions extends Pick<ModuleMetadata, "imports"> {
+    useFactory?: (...args: any[]) => Promise<AiModuleOptions> | AiModuleOptions;
+    inject?: any[];
+    useClass?: Type<AiOptionsFactory>;
+    useExisting?: Type<AiOptionsFactory>;
+}
+export interface AiOptionsFactory {
+    createAiOptions(): Promise<AiModuleOptions> | AiModuleOptions;
+}

package/dist/ai/interfaces/ai-module-options.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ai-module-options.interface.js.map

package/dist/ai/interfaces/ai-module-options.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-module-options.interface.js","sourceRoot":"","sources":["../../../src/ai/interfaces/ai-module-options.interface.ts"],"names":[],"mappings":""}

package/dist/ai/services/ai.service.d.ts

@@ -1,13 +1,15 @@
 import { LanguageModelV3 } from "@ai-sdk/provider";
 import { Cache } from "cache-manager";
+import { AiModuleOptions } from "../interfaces/ai-module-options.interface";
 export type BuildModelOptions = {
     model?: string;
 };
 export declare class AiService {
     private cache;
+    private options;
     private readonly openrouter;
     private readonly openrouterChat;
-    constructor(cache: Cache);
+    constructor(cache: Cache, options: AiModuleOptions);
     get model(): LanguageModelV3;
     buildModel({ model }?: BuildModelOptions): LanguageModelV3;
     wrapModel(model: LanguageModelV3): LanguageModelV3;

package/dist/ai/services/ai.service.js

@@ -17,15 +17,18 @@ const cache_manager_1 = require("@nestjs/cache-manager");
 const common_1 = require("@nestjs/common");
 const ai_sdk_provider_1 = require("@openrouter/ai-sdk-provider");
 const ai_1 = require("ai");
+const ai_constants_1 = require("../ai.constants");
 const DEFAULT_MODEL = "google/gemini-2.0-flash-001";
 let AiService = class AiService {
     cache;
+    options;
     openrouter;
     openrouterChat;
-    constructor(cache) {
+    constructor(cache, options) {
         this.cache = cache;
+        this.options = options;
         this.openrouter = (0, ai_sdk_provider_1.createOpenRouter)({
-            apiKey: process.env.OPENROUTER_API_KEY,
+            apiKey: this.options.apiKey,
         });
         this.openrouterChat = this.buildModel();
     }
@@ -33,7 +36,7 @@ let AiService = class AiService {
         return this.openrouterChat;
     }
     buildModel({ model } = {}) {
-        return this.wrapModel(this.openrouter.chat(model ?? DEFAULT_MODEL));
+        return this.wrapModel(this.openrouter.chat(model ?? this.options.defaultModel ?? DEFAULT_MODEL));
     }
     wrapModel(model) {
         return (0, ai_1.wrapLanguageModel)({
@@ -53,6 +56,10 @@ let AiService = class AiService {
             return cachedResult;
         }
         const result = await doGenerate();
+        if (this.options.cacheTtlMs !== undefined) {
+            await this.cache.set(cacheKey, result, this.options.cacheTtlMs);
+            return result;
+        }
         await this.cache.set(cacheKey, result);
         return result;
     }
@@ -61,6 +68,7 @@ exports.AiService = AiService;
 exports.AiService = AiService = __decorate([
     (0, common_1.Injectable)(),
     __param(0, (0, common_1.Inject)(cache_manager_1.CACHE_MANAGER)),
-    __metadata("design:paramtypes", [Object])
+    __param(1, (0, common_1.Inject)(ai_constants_1.AI_MODULE_OPTIONS)),
+    __metadata("design:paramtypes", [Object, Object])
 ], AiService);
 //# sourceMappingURL=ai.service.js.map

package/dist/ai/services/ai.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai.service.js","sourceRoot":"","sources":["../../../src/ai/services/ai.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AACA,yDAAqD;AACrD,2CAAmD;AACnD,iEAGoC;AACpC,2BAAsC;AAGtC,MAAM,aAAa,GAAG,6BAA6B,CAAA;AAO5C,IAAM,SAAS,GAAf,MAAM,SAAS;IAIuB;IAH1B,UAAU,CAAoB;IAC9B,cAAc,CAAiB;IAEhD,YAA2C,KAAY;QAAZ,UAAK,GAAL,KAAK,CAAO;QACrD,IAAI,CAAC,UAAU,GAAG,IAAA,kCAAgB,EAAC;YACjC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;SACvC,CAAC,CAAA;QACF,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,CAAA;IACzC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;IAED,UAAU,CAAC,EAAE,KAAK,KAAwB,EAAE;QAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC,CAAC,CAAA;IACrE,CAAC;IAED,SAAS,CAAC,KAAsB;QAC9B,OAAO,IAAA,sBAAiB,EAAC;YACvB,KAAK;YACL,UAAU,EAAE;gBACV;oBACE,oBAAoB,EAAE,IAAI;oBAC1B,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC;iBACtD;aACF;SACF,CAAC,CAAA;IACJ,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,EACzB,UAAU,EACV,MAAM,GAGJ;QACF,MAAM,QAAQ,GAAG,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QAE/C,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACnD,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,YAAkE,CAAA;QAC3E,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAA;QAEjC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QACtC,OAAO,MAAM,CAAA;IACf,CAAC;CACF,CAAA;AAjDY,8BAAS;oBAAT,SAAS;IADrB,IAAA,mBAAU,GAAE;IAKE,WAAA,IAAA,eAAM,EAAC,6BAAa,CAAC,CAAA;;GAJvB,SAAS,CAiDrB"}
+{"version":3,"file":"ai.service.js","sourceRoot":"","sources":["../../../src/ai/services/ai.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AACA,yDAAqD;AACrD,2CAAmD;AACnD,iEAGoC;AACpC,2BAAsC;AAEtC,kDAAmD;AAGnD,MAAM,aAAa,GAAG,6BAA6B,CAAA;AAO5C,IAAM,SAAS,GAAf,MAAM,SAAS;IAKa;IACI;IALpB,UAAU,CAAoB;IAC9B,cAAc,CAAiB;IAEhD,YACiC,KAAY,EACR,OAAwB;QAD5B,UAAK,GAAL,KAAK,CAAO;QACR,YAAO,GAAP,OAAO,CAAiB;QAE3D,IAAI,CAAC,UAAU,GAAG,IAAA,kCAAgB,EAAC;YACjC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;SAC5B,CAAC,CAAA;QACF,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,CAAA;IACzC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;IAED,UAAU,CAAC,EAAE,KAAK,KAAwB,EAAE;QAC1C,OAAO,IAAI,CAAC,SAAS,CACnB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,aAAa,CAAC,CAC1E,CAAA;IACH,CAAC;IAED,SAAS,CAAC,KAAsB;QAC9B,OAAO,IAAA,sBAAiB,EAAC;YACvB,KAAK;YACL,UAAU,EAAE;gBACV;oBACE,oBAAoB,EAAE,IAAI;oBAC1B,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC;iBACtD;aACF;SACF,CAAC,CAAA;IACJ,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,EACzB,UAAU,EACV,MAAM,GAGJ;QACF,MAAM,QAAQ,GAAG,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QAE/C,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACnD,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,YAAkE,CAAA;QAC3E,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAA;QAEjC,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAC1C,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;YAC/D,OAAO,MAAM,CAAA;QACf,CAAC;QAED,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QACtC,OAAO,MAAM,CAAA;IACf,CAAC;CACF,CAAA;AA3DY,8BAAS;oBAAT,SAAS;IADrB,IAAA,mBAAU,GAAE;IAMR,WAAA,IAAA,eAAM,EAAC,6BAAa,CAAC,CAAA;IACrB,WAAA,IAAA,eAAM,EAAC,gCAAiB,CAAC,CAAA;;GANjB,SAAS,CA2DrB"}

package/dist/ai/shared-ai.module.d.ts

@@ -1,2 +1,8 @@
+import { DynamicModule } from "@nestjs/common";
+import { AiModuleAsyncOptions, AiModuleOptions } from "./interfaces/ai-module-options.interface";
 export declare class SharedAiModule {
+    static forRoot(options: AiModuleOptions): DynamicModule;
+    static forRootAsync(options: AiModuleAsyncOptions): DynamicModule;
+    private static createAsyncProviders;
+    private static createAsyncOptionsProvider;
 }

package/dist/ai/shared-ai.module.js

@@ -5,17 +5,69 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
+var SharedAiModule_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SharedAiModule = void 0;
 const common_1 = require("@nestjs/common");
+const cache_1 = require("../cache");
+const ai_constants_1 = require("./ai.constants");
 const ai_service_1 = require("./services/ai.service");
-let SharedAiModule = class SharedAiModule {
+let SharedAiModule = SharedAiModule_1 = class SharedAiModule {
+    static forRoot(options) {
+        return {
+            module: SharedAiModule_1,
+            global: false,
+            imports: [cache_1.SharedCacheModule.forRoot()],
+            providers: [
+                {
+                    provide: ai_constants_1.AI_MODULE_OPTIONS,
+                    useValue: options,
+                },
+                ai_service_1.AiService,
+            ],
+            exports: [ai_service_1.AiService],
+        };
+    }
+    static forRootAsync(options) {
+        return {
+            module: SharedAiModule_1,
+            global: false,
+            imports: [cache_1.SharedCacheModule.forRoot(), ...(options.imports || [])],
+            providers: [...this.createAsyncProviders(options), ai_service_1.AiService],
+            exports: [ai_service_1.AiService],
+        };
+    }
+    static createAsyncProviders(options) {
+        if (options.useExisting || options.useFactory) {
+            return [this.createAsyncOptionsProvider(options)];
+        }
+        return [
+            this.createAsyncOptionsProvider(options),
+            {
+                provide: options.useClass,
+                useClass: options.useClass,
+            },
+        ];
+    }
+    static createAsyncOptionsProvider(options) {
+        if (options.useFactory) {
+            return {
+                provide: ai_constants_1.AI_MODULE_OPTIONS,
+                useFactory: options.useFactory,
+                inject: options.inject || [],
+            };
+        }
+        return {
+            provide: ai_constants_1.AI_MODULE_OPTIONS,
+            useFactory: async (optionsFactory) => {
+                return optionsFactory.createAiOptions();
+            },
+            inject: [options.useExisting || options.useClass],
+        };
+    }
 };
 exports.SharedAiModule = SharedAiModule;
-exports.SharedAiModule = SharedAiModule = __decorate([
-    (0, common_1.Module)({
-        providers: [ai_service_1.AiService],
-        exports: [ai_service_1.AiService],
-    })
+exports.SharedAiModule = SharedAiModule = SharedAiModule_1 = __decorate([
+    (0, common_1.Module)({})
 ], SharedAiModule);
 //# sourceMappingURL=shared-ai.module.js.map

package/dist/ai/shared-ai.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared-ai.module.js","sourceRoot":"","sources":["../../src/ai/shared-ai.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAuC;AACvC,sDAAiD;AAM1C,IAAM,cAAc,GAApB,MAAM,cAAc;CAAG,CAAA;AAAjB,wCAAc;yBAAd,cAAc;IAJ1B,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,sBAAS,CAAC;QACtB,OAAO,EAAE,CAAC,sBAAS,CAAC;KACrB,CAAC;GACW,cAAc,CAAG"}
+{"version":3,"file":"shared-ai.module.js","sourceRoot":"","sources":["../../src/ai/shared-ai.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAgE;AAChE,oCAA4C;AAC5C,iDAAkD;AAMlD,sDAAiD;AAG1C,IAAM,cAAc,sBAApB,MAAM,cAAc;IACzB,MAAM,CAAC,OAAO,CAAC,OAAwB;QACrC,OAAO;YACL,MAAM,EAAE,gBAAc;YACtB,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,CAAC,yBAAiB,CAAC,OAAO,EAAE,CAAC;YACtC,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,gCAAiB;oBAC1B,QAAQ,EAAE,OAAO;iBAClB;gBACD,sBAAS;aACV;YACD,OAAO,EAAE,CAAC,sBAAS,CAAC;SACrB,CAAA;IACH,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,OAA6B;QAC/C,OAAO;YACL,MAAM,EAAE,gBAAc;YACtB,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,CAAC,yBAAiB,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YAClE,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,sBAAS,CAAC;YAC7D,OAAO,EAAE,CAAC,sBAAS,CAAC;SACrB,CAAA;IACH,CAAC;IAEO,MAAM,CAAC,oBAAoB,CACjC,OAA6B;QAE7B,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAA;QACnD,CAAC;QAED,OAAO;YACL,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC;YACxC;gBACE,OAAO,EAAE,OAAO,CAAC,QAAS;gBAC1B,QAAQ,EAAE,OAAO,CAAC,QAAS;aAC5B;SACF,CAAA;IACH,CAAC;IAEO,MAAM,CAAC,0BAA0B,CACvC,OAA6B;QAE7B,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,OAAO;gBACL,OAAO,EAAE,gCAAiB;gBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;aAC7B,CAAA;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,gCAAiB;YAC1B,UAAU,EAAE,KAAK,EAAE,cAAgC,EAAE,EAAE;gBACrD,OAAO,cAAc,CAAC,eAAe,EAAE,CAAA;YACzC,CAAC;YACD,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,QAAS,CAAC;SACnD,CAAA;IACH,CAAC;CACF,CAAA;AA9DY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,cAAc,CA8D1B"}