@futdevpro/nts-dynamo 1.15.157 → 1.15.160

package/src/_modules/bot/_services/bot-routines.control-service.ts

@@ -1,78 +0,0 @@
-import { timer, of, Subscription } from 'rxjs';
-import { switchMap, filter, tap } from 'rxjs/operators';
-
-import { DyFM_Async, DyFM_Error } from '@futdevpro/fsm-dynamo';
-import { DyNTS_SingletonService } from '../../../_services/base/singleton.service';
-import { DyNTS_Bot_Main_ControlService } from './bot-main.control-service';
-import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
-import { DyNTS_Bot_MessagingProvider_ServiceBase } from './bot-messaging-provider.service-base';
-
-export abstract class DyNTS_Bot_Routines_ControlService extends DyNTS_SingletonService {
-  
-  protected mainBot_CS: DyNTS_Bot_Main_ControlService;
-  protected abstract getMainBotControlService(): DyNTS_Bot_Main_ControlService;
-
-  /* get provider(): any {
-    return this.mainBot_CS?.provider;
-  } */
-
-  get defaultProvider(): DyNTS_Bot_MessagingProvider_ServiceBase<any, any, any> {
-    return this.mainBot_CS.defaultProvider;
-  }
-
-  private _routinesStarted: boolean;
-  get routinesStarted(): boolean {
-    return this._routinesStarted;
-  }
-
-  /* protected constructor() {
-    super();
-  } */
-
-  async setup(issuer: string): Promise<void> {
-    try {
-      this.mainBot_CS = this.getMainBotControlService();
-
-      if (!this.mainBot_CS) {
-        throw new DyFM_Error({
-          ...this.getDefaultErrorSettings('setup', new Error('Main Bot Control Service not found'), issuer),
-          errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-Bot-RCS-S01`,
-        })
-      }
-    } catch (error) {
-      throw new DyFM_Error({
-        ...this.getDefaultErrorSettings('setup', error, issuer),
-        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-Bot-RCS-S000`,
-      })
-    }
-  }
-
-  async start(issuer: string): Promise<void> {
-    try {
-      if (!this.defaultProvider) {
-        throw new DyFM_Error({
-          ...this.getDefaultErrorSettings(
-            'start', 
-            new Error(
-              'Bot routines not yet started, ' +
-              'should only be called after DyNTS_Bot_Main_ControlService.start'
-            ), 
-            'system-init'
-          ),
-          errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-Bot-RCS-ST00`,
-        })
-      }
-
-      await this.startRoutines(issuer);
-
-      this._routinesStarted = true;
-    } catch (error) {
-      throw new DyFM_Error({
-        ...this.getDefaultErrorSettings('start', error, issuer),
-        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-Bot-RCS-ST0`,
-      })
-    }
-  }
-
-  abstract startRoutines(issuer: string): Promise<void>;
-}

package/src/_modules/bot/index.ts

@@ -1,37 +0,0 @@
-//
-// Bot module (platform-agnostic)
-//
-// This module provides platform-agnostic bot functionality
-// It creates universal solutions for the most common use cases
-//
-
-// MODELS
-/* export * from './_models/bot-message.interface'; */
-export * from './_models/bot-message-wrapper.interface';
-/* export * from './_models/bot-channel.interface'; */
-export * from './_models/bot-channel-wrapper.interface';
-/* export * from './_models/bot-user.interface'; */
-export * from './_models/bot-user-wrapper.interface';
-export * from './_services/bot-messaging-provider.service-base';
-export * from './_models/bot-command.interface';
-export * from './_models/bot-global-settings.interface';
-export * from './_models/bot-last-message-date.interface';
-export * from './_models/bot-last-mention-date.interface';
-
-// COLLECTIONS
-/* export * from './_collections/bot-operations.util'; */
-export * from './_collections/bot-global-settings.const';
-export * from './_collections/bot-default-commands.const';
-
-// SERVICES
-export * from './_services/bot-main.control-service';
-export * from './_services/bot-io.control-service';
-export * from './_services/bot-commands.control-service';
-export * from './_services/bot-routines.control-service';
-/* export * from './_services/bot-messaging-provider-factory.service'; */
-
-// PROVIDERS
-export * from './_modules/discord-bot';
-export * from './_modules/slack-bot';
-export * from './_modules/teams-bot';
-/* export * from './_modules/dynamo-bot'; */

package/src/_modules/custom-data/custom-data.controller.spec.ts

@@ -1,49 +0,0 @@
-
-import { DyNTS_CustomData_Controller } from './custom-data.controller';
-import { DyFM_HttpCallType } from '@futdevpro/fsm-dynamo';
-
-describe('| DyNTS_CustomData_Controller', () => {
-  let controller: DyNTS_CustomData_Controller;
-
-  beforeEach(() => {
-    controller = DyNTS_CustomData_Controller.getInstance();
-  });
-
-  it('| should be a singleton instance', () => {
-    const instance1 = DyNTS_CustomData_Controller.getInstance();
-    const instance2 = DyNTS_CustomData_Controller.getInstance();
-
-    expect(instance1).toBe(instance2);
-    expect(instance1).toBeInstanceOf(DyNTS_CustomData_Controller);
-  });
-
-  it('| should setup endpoints', () => {
-    controller.setupEndpoints();
-
-    expect(controller.endpoints).toBeDefined();
-    expect(controller.endpoints.length).toBeGreaterThan(0);
-  });
-
-  it('| should have getCustomData endpoint', () => {
-    controller.setupEndpoints();
-
-    const getCustomDataEndpoint = controller.endpoints.find(ep => ep.name === 'getCustomData');
-
-    expect(getCustomDataEndpoint).toBeDefined();
-    expect(getCustomDataEndpoint?.type).toBe(DyFM_HttpCallType.get);
-    expect((getCustomDataEndpoint as any)?.tasks).toBeDefined();
-    expect((getCustomDataEndpoint as any)?.tasks.length).toBeGreaterThan(0);
-  });
-
-  it('| should have modifyCustomData endpoint', () => {
-    controller.setupEndpoints();
-
-    const modifyCustomDataEndpoint = controller.endpoints.find(ep => ep.name === 'modifyCustomData');
-
-    expect(modifyCustomDataEndpoint).toBeDefined();
-    expect(modifyCustomDataEndpoint?.type).toBe(DyFM_HttpCallType.post);
-    expect((modifyCustomDataEndpoint as any)?.tasks).toBeDefined();
-    expect((modifyCustomDataEndpoint as any)?.tasks.length).toBeGreaterThan(0);
-  });
-});
-

package/src/_modules/custom-data/custom-data.controller.ts

@@ -1,67 +0,0 @@
-
-import { Request, Response } from 'express';
-
-import { DyFM_HttpCallType } from '@futdevpro/fsm-dynamo';
-import { DyFM_customDataModule_settings } from '@futdevpro/fsm-dynamo/custom-data';
-
-import {
-  DyNTS_Endpoint_Params
-} from '../../_models/control-models/endpoint-params.control-model';
-import { DyNTS_Controller } from '../../_services/route/controller.service';
-import { DyNTS_CustomData_DataService } from './custom-data.data-service';
-
-export class DyNTS_CustomData_Controller extends DyNTS_Controller {
-
-  static getInstance(): DyNTS_CustomData_Controller {
-    return DyNTS_CustomData_Controller.getSingletonInstance();
-  }
-
-  setupEndpoints(): void {
-    this.endpoints = [
-      // CUSTOM DATA
-      new DyNTS_Endpoint_Params({
-        name: 'getCustomData',
-        type: DyFM_HttpCallType.get,
-        endpoint: DyFM_customDataModule_settings.endPoints.getCustomData,
-        tasks: [
-          async (req: Request, res: Response): Promise<void> => {
-            const customDataService = new DyNTS_CustomData_DataService({ 
-              _id: req.params.customId,
-            });
-
-            await customDataService.getDataById();
-
-            res.send({
-              url: req.url,
-              result: 'get custom call was successful!',
-              response: customDataService.data,
-              request: `.../custom/get/${req.params.customId}`,
-            });
-          },
-        ],
-      }),
-
-      new DyNTS_Endpoint_Params({
-        name: 'modifyCustomData',
-        type: DyFM_HttpCallType.post,
-        endpoint: DyFM_customDataModule_settings.endPoints.modifyCustomData,
-        tasks: [
-          async (req: Request, res: Response, issuer: string): Promise<void> => {
-            const customDataService = new DyNTS_CustomData_DataService(req.body, issuer);
-
-            res.send({
-              url: req.url,
-              result: 'post custom call was successful!',
-              response: await customDataService.saveData(req.body),
-              warning: 
-                'keep in mind that this is a playground DB, ' +
-                'and it will be cleared out from time to time',
-              request: req.body,
-            });
-          },
-        ],
-      }),
-    ];
-  }
-}
-

package/src/_modules/custom-data/custom-data.data-service.spec.ts

@@ -1,54 +0,0 @@
-
-import { DyNTS_CustomData_DataService } from './custom-data.data-service';
-import { DyFM_CustomData } from '@futdevpro/fsm-dynamo/custom-data';
-import { DyNTS_global_settings } from '../../_collections/global-settings.const';
-import { DyFM_EnvironmentFlag } from '@futdevpro/fsm-dynamo';
-import { DyNTS_GlobalService } from '../../_services/core/global.service';
-
-describe('| DyNTS_CustomData_DataService', () => {
-  let mockDBService: jasmine.SpyObj<{ find: () => Promise<unknown[]>; findOne: () => Promise<unknown> }>;
-
-  beforeAll(() => {
-    if (!DyNTS_global_settings.systemShortCodeName) {
-      (DyNTS_global_settings as { systemShortCodeName?: string }).systemShortCodeName = 'TEST';
-    }
-    if (!DyNTS_global_settings.env_settings) {
-      (DyNTS_global_settings as { env_settings?: unknown }).env_settings = {
-        environment: DyFM_EnvironmentFlag.local,
-      };
-    }
-  });
-
-  beforeEach(() => {
-    mockDBService = jasmine.createSpyObj('DyNTS_DBService', ['find', 'findOne', 'getDataById', 'getAll', 'createData', 'modifyData']);
-    mockDBService.find.and.returnValue(Promise.resolve([]));
-    mockDBService.findOne.and.returnValue(Promise.resolve(null));
-    spyOn(DyNTS_GlobalService, 'getDBService').and.returnValue(mockDBService as never);
-  });
-
-  it('| should create service with custom data', () => {
-    const customData = new DyFM_CustomData({
-      _id: 'test-data-id',
-    } as any);
-
-    const service = new DyNTS_CustomData_DataService(customData, 'issuer-123');
-
-    expect(service).toBeInstanceOf(DyNTS_CustomData_DataService);
-    expect(service.data).toBeDefined();
-    expect(service.data._id).toBe('test-data-id');
-  });
-
-  it('| should create service without custom data', () => {
-    const service = new DyNTS_CustomData_DataService();
-
-    expect(service).toBeInstanceOf(DyNTS_CustomData_DataService);
-    expect(service.data).toBeDefined();
-  });
-
-  it('| should create service with issuer', () => {
-    const service = new DyNTS_CustomData_DataService(undefined, 'issuer-123');
-
-    expect(service).toBeInstanceOf(DyNTS_CustomData_DataService);
-  });
-});
-

package/src/_modules/custom-data/custom-data.data-service.ts

@@ -1,22 +0,0 @@
-
-
-
-import {
-  DyFM_CustomData,
-  DyFM_customData_dataParams
-} from '@futdevpro/fsm-dynamo/custom-data';
-import { DyNTS_DataService } from '../../_services/base/data.service';
-
-export class DyNTS_CustomData_DataService extends DyNTS_DataService<DyFM_CustomData> {
-
-  constructor(
-    customData?: DyFM_CustomData,
-    issuer?: string
-  ) {
-    super(
-      new DyFM_CustomData(customData),
-      DyFM_customData_dataParams,
-      issuer
-    );
-  }
-}

package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts

@@ -1,28 +0,0 @@
-
-import { DyNTS_getCustomDataRoutingModule } from './get-custom-data-routing-module.util';
-import { DyNTS_RouteSecurity } from '../../_enums/route-security.enum';
-import { DyNTS_RoutingModule } from '../../_services/route/routing-module.service';
-
-describe('| DyNTS_getCustomDataRoutingModule', () => {
-  it('| should create routing module with default settings', () => {
-    const module = DyNTS_getCustomDataRoutingModule();
-
-    expect(module).toBeInstanceOf(DyNTS_RoutingModule);
-    expect(module).toBeTruthy();
-  });
-
-  it('| should create routing module with security override', () => {
-    const module = DyNTS_getCustomDataRoutingModule(DyNTS_RouteSecurity.secure);
-
-    expect(module).toBeInstanceOf(DyNTS_RoutingModule);
-    expect(module).toBeTruthy();
-  });
-
-  it('| should create routing module with both security', () => {
-    const module = DyNTS_getCustomDataRoutingModule(DyNTS_RouteSecurity.both);
-
-    expect(module).toBeInstanceOf(DyNTS_RoutingModule);
-    expect(module).toBeTruthy();
-  });
-});
-

package/src/_modules/custom-data/get-custom-data-routing-module.util.ts

@@ -1,24 +0,0 @@
-
-import { DyFM_customDataModule_settings } from '@futdevpro/fsm-dynamo/custom-data';
-
-import { DyNTS_RouteSecurity } from '../../_enums/route-security.enum';
-import { 
-  DyNTS_RoutingModule_Settings 
-} from '../../_models/interfaces/routing-module-settings.interface';
-import { DyNTS_RoutingModule } from '../../_services/route/routing-module.service';
-import { DyNTS_CustomData_Controller } from './custom-data.controller';
-
-export function DyNTS_getCustomDataRoutingModule(
-  securityOverride?: DyNTS_RouteSecurity
-): DyNTS_RoutingModule {
-  const set: DyNTS_RoutingModule_Settings = {
-    route: DyFM_customDataModule_settings.mainRoute,
-    controllers: [ DyNTS_CustomData_Controller.getInstance() ],
-  };
-  
-  if (securityOverride) {
-    set.securityOverride = securityOverride;
-  }
-
-  return new DyNTS_RoutingModule(set);
-}

package/src/_modules/custom-data/index.ts

@@ -1,9 +0,0 @@
-
-
-// This module is implementing contains sample and experimental custom-data solutions.
-
-// CUSTOM-DATA MODULE
-export * from './custom-data.data-service';
-export * from './get-custom-data-routing-module.util';
-export * from './custom-data.controller';
-export * from '@futdevpro/fsm-dynamo/custom-data';

package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts

@@ -1,176 +0,0 @@
-import * as fs from 'fs';
-import * as os from 'os';
-import * as path from 'path';
-
-import Database from 'better-sqlite3';
-
-import { DyFM_Error } from '@futdevpro/fsm-dynamo';
-
-import { DyNTS_Sqlite_Reader_Util } from './dynts-sqlite-reader.util';
-import { DyNTS_SqliteColumnInfo } from '../_models/interfaces/dynts-sqlite-reader.interface';
-
-interface NameInterface {
-  name: string;
-}
-
-
-/**
- * `DyNTS_Sqlite_Reader_Util` spec (BFR-AM-009). Egy temp `.db` fájlt hozunk létre (a reader path-szal
- * + `fileMustExist:true` nyit, ezért valódi fájl kell — a `:memory:` path-ön nem ad fájlt), feltöltjük,
- * majd igazoljuk:
- *   - `listTables` (a belső `sqlite_%` táblák kiszűrve, ABC-sorrend),
- *   - `getSchema` (oszlop-info: name/type/notNull/primaryKey),
- *   - `readTable` (összes sor) + nem-létező tábla → strukturált hiba,
- *   - `query` SELECT/WITH fut + paraméteres SELECT,
- *   - `query` NEM-SELECT (INSERT/UPDATE/DELETE/DROP/multi-statement) → READONLY-hiba (elutasít),
- *   - hiányzó path / nem-létező fájl → strukturált hiba.
- */
-describe('| DyNTS_Sqlite_Reader_Util (read-only SQLite reader, BFR-AM-009)', () => {
-
-  /** A temp DB-fájl útvonala (minden teszt-futáshoz egyedi). */
-  let dbPath: string;
-
-  beforeAll(() => {
-    dbPath = path.join(os.tmpdir(), `dynts-sqlite-spec-${process.pid}-${Date.now()}.db`);
-    const db: Database.Database = new Database(dbPath);
-
-    db.exec(`
-            CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT NOT NULL, age INTEGER);
-            CREATE TABLE posts (id INTEGER PRIMARY KEY, title TEXT);
-        `);
-    db.prepare('INSERT INTO users (id, name, age) VALUES (?, ?, ?)').run(1, 'Ada', 36);
-    db.prepare('INSERT INTO users (id, name, age) VALUES (?, ?, ?)').run(2, 'Grace', 40);
-    db.prepare('INSERT INTO posts (id, title) VALUES (?, ?)').run(1, 'Hello');
-    db.close();
-  });
-
-  afterAll(() => {
-    if (dbPath && fs.existsSync(dbPath)) {
-      fs.unlinkSync(dbPath);
-    }
-  });
-
-  /** Egy hívás, ami egy adott errorCode-dal kell hogy dobjon (strukturált, NEM néma). */
-  const expectErrorCode = (fn: () => unknown, expectedCode: string): void => {
-    let thrown: unknown;
-
-    try {
-      fn();
-    } catch (error) {
-      thrown = error;
-    }
-    expect(thrown).withContext(`dobnia kellett (${expectedCode})`).toBeDefined();
-    const code: string | undefined =
-            thrown instanceof DyFM_Error ? DyFM_Error.getErrorCode(thrown) : undefined;
-
-    expect(code).withContext('a hibakód').toBe(expectedCode);
-  };
-
-  describe('| listTables', () => {
-    it('| a user-táblák ABC-sorrendben (a belső sqlite_% táblák kiszűrve)', () => {
-      expect(DyNTS_Sqlite_Reader_Util.listTables(dbPath)).toEqual([ 'posts', 'users' ]);
-    });
-  });
-
-  describe('| getSchema', () => {
-    it('| a users tábla oszlop-info-ja (name/type/notNull/primaryKey)', () => {
-      const schema: DyNTS_SqliteColumnInfo[] = DyNTS_Sqlite_Reader_Util.getSchema(dbPath, 'users');
-
-      expect(schema.map((column) => column.name)).toEqual([ 'id', 'name', 'age' ]);
-      const idColumn: DyNTS_SqliteColumnInfo = schema.find((column) => column.name === 'id');
-
-      expect(idColumn.primaryKey).toBe(true);
-      const nameColumn: DyNTS_SqliteColumnInfo = schema.find((column) => column.name === 'name');
-
-      expect(nameColumn.notNull).toBe(true);
-      expect(nameColumn.type).toBe('TEXT');
-    });
-
-    it('| nem-létező tábla → DyNTS-SQLITE-READ-002 (NEM néma)', () => {
-      expectErrorCode(() => DyNTS_Sqlite_Reader_Util.getSchema(dbPath, 'no_such_table'), 'DyNTS-SQLITE-READ-002');
-    });
-  });
-
-  describe('| readTable', () => {
-    it('| a users tábla minden sora', () => {
-      const rows: { id: number; name: string }[] =
-                DyNTS_Sqlite_Reader_Util.readTable(dbPath, 'users') as { id: number; name: string }[];
-
-      expect(rows.length).toBe(2);
-      expect(rows.map((row) => row.name).sort()).toEqual([ 'Ada', 'Grace' ]);
-    });
-
-    it('| nem-létező tábla → DyNTS-SQLITE-READ-002 (NEM néma-[])', () => {
-      expectErrorCode(() => DyNTS_Sqlite_Reader_Util.readTable(dbPath, 'ghost'), 'DyNTS-SQLITE-READ-002');
-    });
-  });
-
-  describe('| query (SELECT-only)', () => {
-    it('| egy SELECT lekérdezés sorai', () => {
-      const rows: NameInterface[] =
-                DyNTS_Sqlite_Reader_Util.query(dbPath, 'SELECT name FROM users ORDER BY age DESC') as NameInterface[];
-
-      expect(rows.map((row) => row.name)).toEqual([ 'Grace', 'Ada' ]);
-    });
-
-    it('| paraméteres SELECT (prepared-statement param)', () => {
-      const rows: NameInterface[] =
-                DyNTS_Sqlite_Reader_Util.query(dbPath, 'SELECT * FROM users WHERE age > ?', [ 37 ]) as NameInterface[];
-
-      expect(rows.map((row) => row.name)).toEqual([ 'Grace' ]);
-    });
-
-    it('| WITH (CTE) is engedett (read-only)', () => {
-      const rows: { n: number }[] = DyNTS_Sqlite_Reader_Util.query(dbPath,
-        'WITH adults AS (SELECT * FROM users WHERE age >= 36) SELECT COUNT(*) AS n FROM adults') as { n: number }[];
-
-      expect(rows[0].n).toBe(2);
-    });
-
-    it('| INSERT → DyNTS-SQLITE-READONLY-001 (elutasít a forrás-rétegben)', () => {
-      expectErrorCode(
-        () => DyNTS_Sqlite_Reader_Util.query(dbPath, 'INSERT INTO users (id, name) VALUES (9, \'x\')'),
-        'DyNTS-SQLITE-READONLY-001');
-    });
-
-    it('| UPDATE → DyNTS-SQLITE-READONLY-001', () => {
-      expectErrorCode(
-        () => DyNTS_Sqlite_Reader_Util.query(dbPath, 'UPDATE users SET name=\'x\' WHERE id=1'),
-        'DyNTS-SQLITE-READONLY-001');
-    });
-
-    it('| DELETE → DyNTS-SQLITE-READONLY-001', () => {
-      expectErrorCode(
-        () => DyNTS_Sqlite_Reader_Util.query(dbPath, 'DELETE FROM users'),
-        'DyNTS-SQLITE-READONLY-001');
-    });
-
-    it('| DROP → DyNTS-SQLITE-READONLY-001', () => {
-      expectErrorCode(
-        () => DyNTS_Sqlite_Reader_Util.query(dbPath, 'DROP TABLE users'),
-        'DyNTS-SQLITE-READONLY-001');
-    });
-
-    it('| multi-statement (SELECT; DELETE) → DyNTS-SQLITE-READONLY-001 (nem rejthető írás SELECT mögé)', () => {
-      expectErrorCode(
-        () => DyNTS_Sqlite_Reader_Util.query(dbPath, 'SELECT 1; DELETE FROM users'),
-        'DyNTS-SQLITE-READONLY-001');
-    });
-
-    it('| üres SQL → DyNTS-SQLITE-READONLY-001', () => {
-      expectErrorCode(() => DyNTS_Sqlite_Reader_Util.query(dbPath, '   '), 'DyNTS-SQLITE-READONLY-001');
-    });
-  });
-
-  describe('| path-validáció (fail-soft, NEM crash)', () => {
-    it('| üres path → DyNTS-SQLITE-READ-001', () => {
-      expectErrorCode(() => DyNTS_Sqlite_Reader_Util.listTables(''), 'DyNTS-SQLITE-READ-001');
-    });
-
-    it('| nem-létező fájl → DyNTS-SQLITE-READ-001', () => {
-      expectErrorCode(
-        () => DyNTS_Sqlite_Reader_Util.listTables(path.join(os.tmpdir(), 'no-such-db-file-xyz.db')),
-        'DyNTS-SQLITE-READ-001');
-    });
-  });
-});