@futdevpro/nts-dynamo 1.15.3 → 1.15.6

package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts

@@ -0,0 +1,157 @@
+import { OpenAI } from 'openai';
+
+import { DyFM_AI_Provider, DyFM_AI_Config } from '@futdevpro/fsm-dynamo/ai';
+import { DyFM_AI_UserProviderConfig } from '@futdevpro/fsm-dynamo/ai';
+import { DyFM_OAI_UserProviderConfig } from '@futdevpro/fsm-dynamo/ai/open-ai';
+import { DyFM_Log } from '@futdevpro/fsm-dynamo';
+
+import { DyNTS_AI_UserKey_ServiceBase } from '../../../_services/ai-user-key.service-base';
+import { DyNTS_AI_TestGeneration_Result } from '../../../_models/ai-test-generation-result.interface';
+
+/**
+ * OpenAI-specifikus user API key kezelo service
+ *
+ * A visszafejtett API kulcsbol OpenAI-specifikus konfigot allit ossze,
+ * es teszteli a kapcsolatot az OpenAI API-val.
+ */
+export class DyNTS_OAI_UserKey_ControlService extends DyNTS_AI_UserKey_ServiceBase {
+
+  static getInstance(): DyNTS_OAI_UserKey_ControlService {
+    return DyNTS_OAI_UserKey_ControlService.getSingletonInstance();
+  }
+
+  readonly aiProvider: DyFM_AI_Provider = DyFM_AI_Provider.OpenAI;
+
+  /**
+   * OpenAI config osszeallitasa a visszafejtett kulcsbol
+   */
+  resolveConfig(
+    userProviderConfig: DyFM_AI_UserProviderConfig,
+    decryptedApiKey: string
+  ): DyFM_AI_Config {
+    const oaiConfig: DyFM_OAI_UserProviderConfig =
+      userProviderConfig as DyFM_OAI_UserProviderConfig;
+
+    return {
+      apiKey: decryptedApiKey,
+      organization: oaiConfig.organization,
+      project: oaiConfig.project,
+    };
+  }
+
+  /**
+   * OpenAI kapcsolat tesztelese a models.list() hivassal
+   */
+  async testConnection(
+    userProviderConfig: DyFM_AI_UserProviderConfig,
+    decryptedApiKey: string
+  ): Promise<boolean> {
+    try {
+      const config: DyFM_AI_Config = this.resolveConfig(userProviderConfig, decryptedApiKey);
+      const openai: OpenAI = new OpenAI({
+        apiKey: config.apiKey,
+        organization: config.organization,
+        project: config.project,
+      });
+
+      await openai.models.list();
+
+      return true;
+    } catch (error) {
+      DyFM_Log.error(
+        'DyNTS_OAI_UserKey_ControlService',
+        'testConnection',
+        'OpenAI connection test failed',
+        { error: error }
+      );
+
+      return false;
+    }
+  }
+
+  /**
+   * Elerheto OpenAI modellek lekerdezese
+   * Szuri a chat/LLM modelleket (nem embedding, nem whisper stb.)
+   */
+  async listAvailableModels(
+    userProviderConfig: DyFM_AI_UserProviderConfig,
+    decryptedApiKey: string
+  ): Promise<string[]> {
+    const config: DyFM_AI_Config = this.resolveConfig(userProviderConfig, decryptedApiKey);
+    const openai: OpenAI = new OpenAI({
+      apiKey: config.apiKey,
+      organization: config.organization,
+      project: config.project,
+    });
+
+    const models = await openai.models.list();
+
+    return models.data
+      .map((m) => m.id)
+      .filter((id: string) => this.isLLMModel(id))
+      .sort();
+  }
+
+  /**
+   * Teszt generalas az OpenAI API-val
+   */
+  async testGeneration(set: {
+    userProviderConfig: DyFM_AI_UserProviderConfig;
+    decryptedApiKey: string;
+    model: string;
+  }): Promise<DyNTS_AI_TestGeneration_Result> {
+    const startTime: number = Date.now();
+
+    try {
+      const config: DyFM_AI_Config = this.resolveConfig(
+        set.userProviderConfig,
+        set.decryptedApiKey
+      );
+      const openai: OpenAI = new OpenAI({
+        apiKey: config.apiKey,
+        organization: config.organization,
+        project: config.project,
+      });
+
+      const response = await openai.chat.completions.create({
+        model: set.model,
+        messages: [{ role: 'user', content: 'Hello, this is a test. Reply with "OK".' }],
+        max_tokens: 10,
+      });
+
+      return {
+        success: true,
+        response: response.choices[0]?.message?.content,
+        model: set.model,
+        latencyMs: Date.now() - startTime,
+      };
+    } catch (error) {
+      DyFM_Log.error(
+        'DyNTS_OAI_UserKey_ControlService',
+        'testGeneration',
+        'OpenAI test generation failed',
+        { error: error }
+      );
+
+      return {
+        success: false,
+        model: set.model,
+        latencyMs: Date.now() - startTime,
+      };
+    }
+  }
+
+  /**
+   * LLM/Chat modell szures -- kiszuri az embedding, whisper, tts stb. modelleket
+   */
+  private isLLMModel(modelId: string): boolean {
+    const excludePatterns: string[] = [
+      'embedding', 'whisper', 'tts', 'dall-e',
+      'moderation', 'davinci', 'babbage', 'ada',
+    ];
+
+    return !excludePatterns.some(
+      (pattern: string) => modelId.includes(pattern)
+    );
+  }
+}

package/src/_modules/ai/_modules/open-ai/index.ts

@@ -65,6 +65,7 @@ export * from './_services/oai-embedding.service'; */
 export * from './_services/oai-embedding.control-service';
 export * from './_services/oai-llm-chat.service-base';
 export * from './_services/oai-llm.service-base';
+export * from './_services/oai-user-key.control-service';
 // services/DATA-SERVICES
 export * from './_services/data-services/oai-doc-chunk-data.service';
 export * from './_services/data-services/oai-doc-page.data-service';

package/src/_modules/ai/_services/ai-user-key.service-base.ts

@@ -0,0 +1,59 @@
+import { DyFM_AI_Provider, DyFM_AI_Config } from '@futdevpro/fsm-dynamo/ai';
+import { DyFM_AI_UserProviderConfig } from '@futdevpro/fsm-dynamo/ai';
+
+import { DyNTS_SingletonService } from '../../../_services/base/singleton.service';
+import { DyNTS_AI_TestGeneration_Result } from '../_models/ai-test-generation-result.interface';
+
+/**
+ * Absztrakt bazis osztaly a user AI provider kulcs kezeleshez
+ *
+ * A titkositas/visszafejtes NEM itt tortenik -- azt az fdp-auth-service Auth_ControlService-e vegzi.
+ * Ezek a service-ek a mar visszafejtett config-ot es API kulcsot kapjak,
+ * es abbol allitjak ossze a provider-specifikus konfigot.
+ */
+export abstract class DyNTS_AI_UserKey_ServiceBase extends DyNTS_SingletonService {
+  /** melyik provider-hez tartozik ez a service */
+  abstract readonly aiProvider: DyFM_AI_Provider;
+
+  /**
+   * Visszafejtett user config + kulcs -> provider-specifikus AI config osszeallitas
+   * @param userProviderConfig - a user provider konfiguracioja
+   * @param decryptedApiKey - a mar visszafejtett API kulcs
+   */
+  abstract resolveConfig(
+    userProviderConfig: DyFM_AI_UserProviderConfig,
+    decryptedApiKey: string
+  ): DyFM_AI_Config;
+
+  /**
+   * Kapcsolat tesztelese a provider-rel a visszafejtett kulccsal
+   * @param userProviderConfig - a user provider konfiguracioja
+   * @param decryptedApiKey - a mar visszafejtett API kulcs
+   */
+  abstract testConnection(
+    userProviderConfig: DyFM_AI_UserProviderConfig,
+    decryptedApiKey: string
+  ): Promise<boolean>;
+
+  /**
+   * Elerheto modellek lekerdezese a provider API-rol
+   * @param userProviderConfig - a user provider konfiguracioja
+   * @param decryptedApiKey - a mar visszafejtett API kulcs
+   */
+  abstract listAvailableModels(
+    userProviderConfig: DyFM_AI_UserProviderConfig,
+    decryptedApiKey: string
+  ): Promise<string[]>;
+
+  /**
+   * Teszt generalas a provider-rel
+   * @param set.userProviderConfig - a user provider konfiguracioja
+   * @param set.decryptedApiKey - a mar visszafejtett API kulcs
+   * @param set.model - a hasznalando modell
+   */
+  abstract testGeneration(set: {
+    userProviderConfig: DyFM_AI_UserProviderConfig;
+    decryptedApiKey: string;
+    model: string;
+  }): Promise<DyNTS_AI_TestGeneration_Result>;
+}

package/src/_modules/ai/index.ts

@@ -3,9 +3,11 @@ export * from '@futdevpro/fsm-dynamo/ai';
 
 // AI Input Interfaces (moved from FSM)
 export * from './_models/ai-input-interfaces';
+export * from './_models/ai-test-generation-result.interface';
 
 // Abstract Services
 export * from './_services/ai-provider.service-base';
 export * from './_services/ai-llm.service-base';
 export * from './_services/ai-llm-chat.service-base';
 export * from './_services/ai-embedding.service-base';
+export * from './_services/ai-user-key.service-base';

package/src/_modules/socket/_services/socket-client.service.ts

@@ -105,8 +105,9 @@ export abstract class DyNTS_SocketClient_ServiceBase extends DyNTS_SingletonServ
     try {
       this._params = this.getParams();
       this.incomingEvents = this.getIncomingEvents() ?? [];
+      const socketAddress = this.params.port ? `${this.params.address}:${this.params.port}` : this.params.address;
       this.socket = SocketIOClient.io(
-        `${this.params.address}:${this.params.port}`,
+        socketAddress,
         {
           reconnection: this.params.reconnect,
           reconnectionDelay: this.params.reconnectDelay,

package/src/_modules/socket/app-extended.server.ts

@@ -460,7 +460,7 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
               `\n    keyPath: FileSystem.PathLike,` +
               `\n    certPath: FileSystem.PathLike,` +
               `\n  }` +
-              `\nin DynamoBEServer - setupRoutingModules() to enable secure routes.`;
+              `\nin DynamoNTSServer - setupRoutingModules() to enable secure routes.`;
               
             errorMsg += '\n\nThe socket services setted to use secure server:';
             this.socketServices.forEach((service: DyNTS_SocketServerService<any>): void => {

package/src/_services/base/data.service.ts

@@ -2426,7 +2426,7 @@ export class DyNTS_DataService<T extends DyFM_Metadata> {
     
 
   /**
-   * setting up dependency dataHook by DynamoBEDataModelParams
+   * setting up dependency dataHook by DynamoNTSDataModelParams
    */
   private lookForDependencyDataSettings(): void {
     const dependencyParams: DyFM_DataProperty_Params<any, T>[] = 

package/src/_services/base/db.service.ts

@@ -1277,7 +1277,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
 
   /**
    * builds mongoose schema building settings object by dynamoDataModelParamsList
-   * @param properties DynamoBEDataPropertyParams
+   * @param properties DynamoNTSDataPropertyParams
    * @returns mongoose schema object
    */
   private buildMongooseSchemaSettingsObjByModelParams(properties: DyFM_DataProperties<T>): any {

package/src/_services/core/auth.service.ts

@@ -12,7 +12,7 @@ import { DyNTS_global_settings } from '../../_collections/global-settings.const'
  * You should use singleton instance getting function by implementing a
  * static getInstance() function
  * @example
- * export class AuthService extends DynamoBEAuthService {
+ * export class AuthService extends DyNTS_AuthService {
  *
  *   static getInstance(): AuthService {
  *     return AuthService.getSingletonInstance();
@@ -150,7 +150,7 @@ export abstract class DyNTS_AuthService extends DyNTS_SingletonService {
   abstract authenticate_tokenPerm_accUsageData: (req: Request, res: Response) => Promise<void>;
 
   /**
-   * The DynamoBE System is using this to get issuer, that will be set on DBServices
+   * The DynamoNTS System is using this to get issuer, that will be set on DBServices
    * Don't throw error in this function, since it will be used in every request
    * @param req 
    * 

package/src/_services/core/email.service.ts

@@ -664,7 +664,7 @@ export class DyNTS_EmailService /* extends DyNTS_SingletonService */ {
       while (propertyOpenTagIndex >= 0) {
         if (propertyCloseTagIndex === -1) {
           DyFM_Log.error(
-            `\nDynamoBEEmailService ERROR, missing closing tag from email template! ` +
+            `\nDyNTS_EmailService ERROR, missing closing tag from email template! ` +
             `(${propertyOpenTagIndex} -)`, 
             propertyKeys
           );

package/src/_services/core/global.service.ts

@@ -30,7 +30,7 @@ import { DyNTS_SingletonService } from '../base/singleton.service';
 import { DyNTS_getArchivedDBName } from '../../_collections/archive.util';
 
 /**
- * This is the main Global/Core Service Collection used by DynamoBE, 
+ * This is the main Global/Core Service Collection used by DynamoNTS, 
  * you also can use this to access main services as 
  * dbServices, emailServices, or authService
  */
@@ -373,7 +373,7 @@ export class DyNTS_GlobalService extends DyNTS_SingletonService {
       throw new Error(
         `\n  Unique Email Service Collection missing!` + 
         `\n    Please create a Unique Email Service Collection extending ` +
-          `DynamoBEEmailServiceCollection, ` + 
+          `DyNTS_EmailServiceCollection, ` + 
         '\n    (If you set the globalErrorHandler, ' +
           'please check if it is using the same node_modules as the app)' +
         `\n      and Setup with DyNTS_GlobalServiceC.setServices(...)\n` +

package/src/_services/route/controller.service.ts

@@ -104,7 +104,7 @@ export abstract class DyNTS_Controller extends DyNTS_SingletonService {
       this.setupEndpoints();
     } catch (error) {
       throw new DyFM_Error({
-        message: 'DynamoBEController setup failed. Please check the setupEndpoints() method.',
+        message: 'DynamoNTSController setup failed. Please check the setupEndpoints() method.',
         errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-COS-000',
         issuerService: this?.constructor?.name,
         error: error,

package/src/_services/server/app.server.ts

@@ -1256,8 +1256,17 @@ export abstract class DyNTS_App extends DyNTS_SingletonService {
   private async mountSecureRoutes (): Promise<void> {
     try {
       if (this.fnLogs && this.deepLog) DyFM_Log.log('\nfn:. mountSecureRoutes');
+
+      if (!this.secureExpress) {
+        throw new Error(
+          'secureExpress was not initialized. ' +
+          'Secure routes require getCertificationSettings and httpsPort, and cert files must exist.' +
+          '\n\nYou need to set security to secure or both in any route and set httpsPort in getPortSettings.' +
+          '\n\nYou need to set cert files in getCertificationSettings.'
+        );
+      }
       
-      this.openExpress.use(
+      this.secureExpress.use(
         (error, req, res, next): Promise<void> => this.expressErrorHandling(error, req, res, next)
       );
 
@@ -1310,6 +1319,13 @@ export abstract class DyNTS_App extends DyNTS_SingletonService {
   private async mountOpenRoutes(): Promise<void> {
     try {
       if (this.fnLogs && this.deepLog) DyFM_Log.log('\nfn:. mountOpenRoutes');
+
+      if (!this.openExpress) {
+        throw new Error(
+          'openExpress was not initialized. Open routes require getOpenExpress and httpPort.' +
+          '\n\nYou need to set security to open or both in any route and set httpPort in getPortSettings.'
+        );
+      }
   
       this.openExpress.use(
         (error, req, res, next): Promise<void> => this.expressErrorHandling(error, req, res, next)