@futdevpro/fsm-dynamo 1.15.2 → 1.15.3

package/build/_modules/ai/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/ai/index.ts"],"names":[],"mappings":"AACA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AACzD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/ai/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAC;AAGjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AACzD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,iCAAiC,CAAC;AAChD,cAAc,iDAAiD,CAAC"}

package/build/_modules/ai/index.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+// COLLECTIONS
+tslib_1.__exportStar(require("./_collections/ai-model-ref.util"), exports);
 // ENUMS
 tslib_1.__exportStar(require("./_enums/ai-provider.enum"), exports);
 tslib_1.__exportStar(require("./_enums/ai-model-type.enum"), exports);
@@ -15,4 +17,5 @@ tslib_1.__exportStar(require("./_models/ai-llm-response.interface"), exports);
 tslib_1.__exportStar(require("./_models/ai-message.interface"), exports);
 tslib_1.__exportStar(require("./_models/ai-provider-capabilities.interface"), exports);
 tslib_1.__exportStar(require("./_models/ai-settings.interface"), exports);
+tslib_1.__exportStar(require("./_models/ai-user-provider-config.control-model"), exports);
 //# sourceMappingURL=index.js.map

package/build/_modules/ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/ai/index.ts"],"names":[],"mappings":";;;AAAA,QAAQ;AACR,oEAA0C;AAC1C,sEAA4C;AAC5C,wEAA8C;AAE9C,SAAS;AACT,+EAAqD;AACrD,wEAA8C;AAC9C,mFAAyD;AACzD,oFAA0D;AAC1D,6EAAmD;AACnD,8EAAoD;AACpD,yEAA+C;AAC/C,uFAA6D;AAC7D,0EAAgD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/ai/index.ts"],"names":[],"mappings":";;;AAAA,cAAc;AACd,2EAAiD;AAEjD,QAAQ;AACR,oEAA0C;AAC1C,sEAA4C;AAC5C,wEAA8C;AAE9C,SAAS;AACT,+EAAqD;AACrD,wEAA8C;AAC9C,mFAAyD;AACzD,oFAA0D;AAC1D,6EAAmD;AACnD,8EAAoD;AACpD,yEAA+C;AAC/C,uFAA6D;AAC7D,0EAAgD;AAChD,0FAAgE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/fsm-dynamo",
-  "version": "01.15.2",
+  "version": "01.15.3",
   "description": "Full Stack Model Collection for Dynamic (NodeJS-Typescript) Framework called Dynamo, by Future Development Ltd.",
   "DyBu_settings": {
     "packageType": "full-stack-package",
@@ -103,6 +103,12 @@
       "types": "./build/_modules/ai/_modules/local/index.d.ts",
       "typings": "./build/_modules/ai/_modules/local/index.d.ts"
     },
+    "./ai/fdp-ai": {
+      "default": "./build/_modules/ai/_modules/fdp-ai/index.js",
+      "module": "./build/_modules/ai/_modules/fdp-ai/index.js",
+      "types": "./build/_modules/ai/_modules/fdp-ai/index.d.ts",
+      "typings": "./build/_modules/ai/_modules/fdp-ai/index.d.ts"
+    },
     
     "./ci-tools": {
       "default": "./build/_modules/ci-tools/index.js",
@@ -211,7 +217,7 @@
     "uuid": "11.1.0"
   },
   "devDependencies": {
-    "@futdevpro/dynamo-eslint": "1.15.1",
+    "@futdevpro/dynamo-eslint": "1.15.2",
     "@types/jasmine": "~4.3.5",
     "@typescript-eslint/eslint-plugin": "^8.41.0",
     "@typescript-eslint/parser": "^8.41.0",

package/src/_models/control-models/data-property-params.control-model.spec.ts

@@ -46,7 +46,7 @@ describe('| DyFM_DataProperty_Params', () => {
 
     expect(consoleErrorSpy).toHaveBeenCalledWith(
       'DYNAMO ERROR: ',
-      `\n type is missing from DynamoBEDataPropertyParams at "testKey" in ` +
+      `\n type is missing from DynamoNTSDataPropertyParams at "testKey" in ` +
         `"testDataName" model.` +
       `\n stackLocation: WHAT`
     );
@@ -59,7 +59,7 @@ describe('| DyFM_DataProperty_Params', () => {
 
     expect(consoleErrorSpy).toHaveBeenCalledWith(
       'DYNAMO ERROR: ',
-      `\nMISSING DynamoBEDataPropertyParams constructor input at "testKey" in ` +
+      `\nMISSING DynamoNTSDataPropertyParams constructor input at "testKey" in ` +
         `"testDataName" model.` +
       `\n stackLocation: WHAT`
     );

package/src/_models/control-models/data-property-params.control-model.ts

@@ -107,7 +107,7 @@ export class DyFM_DataProperty_Params<T_Property, T_Data> extends DyFM_DataPrope
       if (!set.type && !set.forbidden) {
         DyFM_Log.error(
           'DYNAMO ERROR: ',
-          `\n type is missing from DynamoBEDataPropertyParams at "${set.key}" in ` +
+          `\n type is missing from DynamoNTSDataPropertyParams at "${set.key}" in ` +
             `"${parentDataParams?.dataName}" model.` +
           `\n stackLocation: ${DyFM_getConstructionStackLocation(2)}`
         );
@@ -162,7 +162,7 @@ export class DyFM_DataProperty_Params<T_Property, T_Data> extends DyFM_DataPrope
     } else {
       DyFM_Log.error(
         'DYNAMO ERROR: ',
-        `\nMISSING DynamoBEDataPropertyParams constructor input at "${this.key}"!` +
+        `\nMISSING DynamoNTSDataPropertyParams constructor input at "${this.key}"!` +
         `\n stackLocation: ${DyFM_getConstructionStackLocation(2)}`
       );
     }

package/src/_modules/ai/_collections/ai-model-ref.util.ts

@@ -0,0 +1,88 @@
+import { DyFM_AI_Provider } from '../_enums/ai-provider.enum';
+
+/**
+ * AI modell hivatkozas formatum: {provider}:{model}
+ *
+ * Peldak: "open-ai:gpt-4o", "anthropic:claude-3-5-sonnet-latest", "fdp-ai:fdp-base-1"
+ * A provider resz a DyFM_AI_Provider enum erteke, a model resz a provider sajat modell azonositoja.
+ */
+export class DyFM_AI_ModelRef_Util {
+  /** az elvlaszto karakter a provider es modell kozott */
+  private static readonly separator: string = ':';
+
+  /** az osszes ervenyes provider ertek gyorstarhely */
+  private static readonly validProviders: Set<string> = new Set(
+    Object.values(DyFM_AI_Provider)
+  );
+
+  /**
+   * Osszeallitas provider + model -bol
+   * @param provider - AI provider enum ertek
+   * @param model - provider-specifikus modell azonosito
+   */
+  static create(provider: DyFM_AI_Provider, model: string): string {
+    return `${provider}${DyFM_AI_ModelRef_Util.separator}${model}`;
+  }
+
+  /**
+   * Szetbontas provider + model -re
+   * @param modelRef - formatum: {provider}:{model}
+   */
+  static parse(modelRef: string): { provider: DyFM_AI_Provider; model: string } {
+    const separatorIndex: number = modelRef.indexOf(DyFM_AI_ModelRef_Util.separator);
+
+    if (separatorIndex < 0) {
+      throw new Error(`Ervenytelen modelRef formatum: "${modelRef}" -- hianyzik a "${DyFM_AI_ModelRef_Util.separator}" elvlaszto`);
+    }
+
+    const provider: string = modelRef.substring(0, separatorIndex);
+    const model: string = modelRef.substring(separatorIndex + 1);
+
+    if (!DyFM_AI_ModelRef_Util.validProviders.has(provider)) {
+      throw new Error(`Ismeretlen AI provider: "${provider}" a modelRef-ben: "${modelRef}"`);
+    }
+
+    if (!model) {
+      throw new Error(`Ures modell azonosito a modelRef-ben: "${modelRef}"`);
+    }
+
+    return { provider: provider as DyFM_AI_Provider, model: model };
+  }
+
+  /**
+   * Provider kinyerese a modelRef-bol
+   * @param modelRef - formatum: {provider}:{model}
+   */
+  static getProvider(modelRef: string): DyFM_AI_Provider {
+    return DyFM_AI_ModelRef_Util.parse(modelRef).provider;
+  }
+
+  /**
+   * Model kinyerese a modelRef-bol
+   * @param modelRef - formatum: {provider}:{model}
+   */
+  static getModel(modelRef: string): string {
+    return DyFM_AI_ModelRef_Util.parse(modelRef).model;
+  }
+
+  /**
+   * Validalas -- ellenorzi, hogy a modelRef megfelel-e a {provider}:{model} formatumnak
+   * @param modelRef - a vizsgalando string
+   */
+  static isValid(modelRef: string): boolean {
+    if (!modelRef) {
+      return false;
+    }
+
+    const separatorIndex: number = modelRef.indexOf(DyFM_AI_ModelRef_Util.separator);
+
+    if (separatorIndex < 0) {
+      return false;
+    }
+
+    const provider: string = modelRef.substring(0, separatorIndex);
+    const model: string = modelRef.substring(separatorIndex + 1);
+
+    return DyFM_AI_ModelRef_Util.validProviders.has(provider) && !!model;
+  }
+}

package/src/_modules/ai/_enums/ai-provider.enum.ts

@@ -3,5 +3,5 @@ export enum DyFM_AI_Provider {
   Anthropic = 'anthropic',
   Google = 'google',
   LocalAI = 'local-ai',
-  // Future providers can be added here
+  FdpAI = 'fdp-ai',
 }

package/src/_modules/ai/_models/ai-user-provider-config.control-model.ts

@@ -0,0 +1,29 @@
+import { DyFM_AI_Provider } from '../_enums/ai-provider.enum';
+
+/**
+ * User szintu AI provider konfiguracio base class
+ *
+ * Tartalmazz a provider API kulcs titkositott valtozatat, annak suffix-et a megjeleníteshez,
+ * es az alap beallitasokat. Provider-specifikus leszarmazottak bovitik sajat mezoikkel.
+ */
+export class DyFM_AI_UserProviderConfig {
+  provider?: DyFM_AI_Provider;
+  /** titkositott API kulcs (csak szerver oldalon tarolva, kliensre sosem kerul) */
+  encryptedApiKey?: string;
+  /** az API kulcs utolso ~4 karaktere megjeleníteshez (pl. "...xR7q") */
+  keySuffix?: string;
+  isActive?: boolean;
+  label?: string;
+  lastTestedAt?: Date;
+  lastUsedAt?: Date;
+  /** a user altal kivalasztott modellek (providerrol lekerdezett listabol) */
+  selectedModels?: string[];
+
+  constructor(
+    set?: DyFM_AI_UserProviderConfig
+  ) {
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}

package/src/_modules/ai/_modules/anthropic/_models/aai-user-provider-config.control-model.ts

@@ -0,0 +1,20 @@
+import { DyFM_AI_UserProviderConfig } from '../../../_models/ai-user-provider-config.control-model';
+import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
+
+/**
+ * Anthropic-specifikus user provider konfiguracio
+ */
+export class DyFM_AAI_UserProviderConfig extends DyFM_AI_UserProviderConfig {
+  override provider?: DyFM_AI_Provider = DyFM_AI_Provider.Anthropic;
+  baseURL?: string;
+
+  constructor(
+    set?: DyFM_AAI_UserProviderConfig
+  ) {
+    super(set);
+
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}

package/src/_modules/ai/_modules/anthropic/index.ts

@@ -5,6 +5,7 @@ export * from './_enums/aai-model.enum';
 export * from './_models/aai-client-options.interface';
 export * from './_models/aai-call-settings.control-model';
 export * from './_models/aai-settings.control-model';
+export * from './_models/aai-user-provider-config.control-model';
 
 
 

package/src/_modules/ai/_modules/fdp-ai/_enums/fdpai-model.enum.ts

@@ -0,0 +1,6 @@
+/**
+ * FDP-AI rendszeren elerheto modellek
+ */
+export enum DyFM_FdpAI_Model {
+  fdpBase1 = 'fdp-base-1',
+}

package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-call-settings.control-model.ts

@@ -0,0 +1,19 @@
+import { DyFM_AI_CallSettings } from '../../../_models/ai-call-settings.interface';
+import { DyFM_FdpAI_Model } from '../_enums/fdpai-model.enum';
+
+/**
+ * FDP-AI implementacioja a generikus AI Call Settings-nek
+ */
+export class DyFM_FdpAI_CallSettings extends DyFM_AI_CallSettings {
+  override useModel?: DyFM_FdpAI_Model | string = DyFM_FdpAI_Model.fdpBase1;
+
+  constructor(
+    set?: DyFM_FdpAI_CallSettings
+  ) {
+    super(set);
+
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}

package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-client-options.interface.ts

@@ -0,0 +1,11 @@
+/**
+ * FDP-AI provider kliens konfiguracio
+ */
+export interface DyFM_FdpAI_ClientOptions {
+  /** FDP-AI API kulcs */
+  apiKey?: string;
+  /** FDP-AI szerver base URL */
+  baseURL?: string;
+  /** Timeout milliszekundumban */
+  timeout?: number;
+}

package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-settings.control-model.ts

@@ -0,0 +1,24 @@
+import { DyFM_AI_Settings } from '../../../_models/ai-settings.interface';
+import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
+import { DyFM_FdpAI_ClientOptions } from './fdpai-client-options.interface';
+import { DyFM_FdpAI_CallSettings } from './fdpai-call-settings.control-model';
+
+/**
+ * FDP-AI implementacioja a generikus AI Settings-nek
+ */
+export class DyFM_FdpAI_Settings extends DyFM_AI_Settings {
+
+  override provider?: DyFM_AI_Provider = DyFM_AI_Provider.FdpAI;
+  override defaultSettings?: DyFM_FdpAI_CallSettings = new DyFM_FdpAI_CallSettings();
+  override config?: DyFM_FdpAI_ClientOptions = {};
+
+  constructor(
+    set?: DyFM_FdpAI_Settings
+  ) {
+    super(set);
+
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}

package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-user-provider-config.control-model.ts

@@ -0,0 +1,20 @@
+import { DyFM_AI_UserProviderConfig } from '../../../_models/ai-user-provider-config.control-model';
+import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
+
+/**
+ * FDP-AI-specifikus user provider konfiguracio
+ */
+export class DyFM_FdpAI_UserProviderConfig extends DyFM_AI_UserProviderConfig {
+  override provider?: DyFM_AI_Provider = DyFM_AI_Provider.FdpAI;
+  baseURL?: string;
+
+  constructor(
+    set?: DyFM_FdpAI_UserProviderConfig
+  ) {
+    super(set);
+
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}

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

@@ -0,0 +1,8 @@
+// ENUMS
+export * from './_enums/fdpai-model.enum';
+
+// MODELS
+export * from './_models/fdpai-client-options.interface';
+export * from './_models/fdpai-call-settings.control-model';
+export * from './_models/fdpai-settings.control-model';
+export * from './_models/fdpai-user-provider-config.control-model';

package/src/_modules/ai/_modules/google-ai/_models/gai-user-provider-config.control-model.ts

@@ -0,0 +1,20 @@
+import { DyFM_AI_UserProviderConfig } from '../../../_models/ai-user-provider-config.control-model';
+import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
+
+/**
+ * Google AI-specifikus user provider konfiguracio
+ */
+export class DyFM_GAI_UserProviderConfig extends DyFM_AI_UserProviderConfig {
+  override provider?: DyFM_AI_Provider = DyFM_AI_Provider.Google;
+  project?: string;
+
+  constructor(
+    set?: DyFM_GAI_UserProviderConfig
+  ) {
+    super(set);
+
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}

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

@@ -5,6 +5,7 @@ export * from './_enums/gai-model.enum';
 export * from './_models/gai-client-options.interface';
 export * from './_models/gai-call-settings.control-model';
 export * from './_models/gai-settings.control-model';
+export * from './_models/gai-user-provider-config.control-model';
 
 
 

package/src/_modules/ai/_modules/open-ai/_models/oai-user-provider-config.control-model.ts

@@ -0,0 +1,21 @@
+import { DyFM_AI_UserProviderConfig } from '../../../_models/ai-user-provider-config.control-model';
+import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
+
+/**
+ * OpenAI-specifikus user provider konfiguracio
+ */
+export class DyFM_OAI_UserProviderConfig extends DyFM_AI_UserProviderConfig {
+  override provider?: DyFM_AI_Provider = DyFM_AI_Provider.OpenAI;
+  organization?: string;
+  project?: string;
+
+  constructor(
+    set?: DyFM_OAI_UserProviderConfig
+  ) {
+    super(set);
+
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}

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

@@ -21,6 +21,7 @@ export * from './_models/oai-call-settings.control-model';
 export * from './_models/oai-client-options.interface';
 export * from './_models/oai-embedding-info.interface';
 export * from './_models/oai-settings.control-model';
+export * from './_models/oai-user-provider-config.control-model';
 
 
 

package/src/_modules/ai/index.ts

@@ -1,3 +1,6 @@
+// COLLECTIONS
+export * from './_collections/ai-model-ref.util';
+
 // ENUMS
 export * from './_enums/ai-provider.enum';
 export * from './_enums/ai-model-type.enum';
@@ -13,3 +16,4 @@ export * from './_models/ai-llm-response.interface';
 export * from './_models/ai-message.interface';
 export * from './_models/ai-provider-capabilities.interface';
 export * from './_models/ai-settings.interface';
+export * from './_models/ai-user-provider-config.control-model';