@futdevpro/nts-dynamo 1.15.57 → 1.15.60

package/build/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * A `DyNTS_Sqlite_Reader_Util` (BFR-AM-009) shared shape-jei. Egy fájlban a szorosan összetartozó
+ * SQLite-reader I/O-típusok (`*.interface.ts` az egy-export-per-file konvenció ismert kivétele a
+ * tightly-coupled shape-ekre).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=dynts-sqlite-reader.interface.js.map

package/build/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-sqlite-reader.interface.js","sourceRoot":"","sources":["../../../../../src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/build/_modules/data-readers/index.d.ts

@@ -0,0 +1,3 @@
+export * from './_models/interfaces/dynts-sqlite-reader.interface';
+export * from './_collections/dynts-sqlite-reader.util';
+//# sourceMappingURL=index.d.ts.map

package/build/_modules/data-readers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/data-readers/index.ts"],"names":[],"mappings":"AAOA,cAAc,oDAAoD,CAAC;AAGnE,cAAc,yCAAyC,CAAC"}

package/build/_modules/data-readers/index.js

@@ -0,0 +1,11 @@
+"use strict";
+// DATA-READERS MODULE — domain-agnosztikus, read-only külső-adatforrás olvasók (NEM Mongo). Jelenleg:
+// `DyNTS_Sqlite_Reader_Util` (BFR-AM-009) — read-only SQLite reader (`better-sqlite3`, opcionális
+// natív peer-dep). SELECT-only guard + fail-soft strukturált hibák.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// INTERFACES
+tslib_1.__exportStar(require("./_models/interfaces/dynts-sqlite-reader.interface"), exports);
+// COLLECTIONS (utils)
+tslib_1.__exportStar(require("./_collections/dynts-sqlite-reader.util"), exports);
+//# sourceMappingURL=index.js.map

package/build/_modules/data-readers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/data-readers/index.ts"],"names":[],"mappings":";AAEA,sGAAsG;AACtG,kGAAkG;AAClG,oEAAoE;;;AAEpE,aAAa;AACb,6FAAmE;AAEnE,sBAAsB;AACtB,kFAAwD"}

package/build/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.d.ts

@@ -0,0 +1,36 @@
+import { DyFM_DataModel_Params, DyFM_Metadata } from '@futdevpro/fsm-dynamo';
+/**
+ * `DyNTS_LVS_VectorPersist` (BFR-AM-001) — egy MongoDB-ben perzistált vektor-rekord, ami a
+ * `LVS_VectorPool_ControlService` **in-memory** pool-jának tartós háttértára. A FAM (fdp-agent-memory)
+ * workaround-ját generalizálja: a vektorok a SAJÁT Mongo-ban élnek, boot-kor a memória-pool-ba
+ * hidratálódnak — **NEM** MongoDB Atlas Vector Search.
+ *
+ * Egy dokumentum = **egy vektor egy adott pool-ban**. A `collectionKey` particionálja a pool-okat
+ * (egy fogyasztó több, logikailag elkülönített pool-t tarthat — pl. táranként). A `vectorId` a pool-on
+ * belüli kulcs (a `pool.addVector(vectorId, embedding)` ezzel illeszt).
+ *
+ * `extends DyFM_Metadata`: az identitás/metadata (`_id`, `__created`, `__lastModified`, `_deleted`) az
+ * ősből jön. A `metadata` `unknown` (Mongoose `Mixed`) — a fogyasztó tetszőleges kísérő-adatot tárolhat
+ * (a séma NEM validál); az `embedding` `number[]` a perzistált nyers vektor.
+ */
+export declare class DyNTS_LVS_VectorPersist extends DyFM_Metadata {
+    /** A pool-on belüli vektor-kulcs (a `pool.addVector(vectorId, ...)` ezzel illeszt). */
+    vectorId?: string;
+    /** Melyik (logikai) pool-hoz tartozik — a pool-particionálás kulcsa (hidratálás-szűrő). */
+    collectionKey?: string;
+    /** A perzistált NYERS vektor (a pool maga számolja a normalizált másolatot). */
+    embedding?: number[];
+    /** A vektor dimenziója (homogenitás-ellenőrzéshez + diagnosztikához tárolt). */
+    dimensions?: number;
+    /** Opcionális fogyasztó-specifikus kísérő-adat (Mongoose `Mixed`; a séma NEM validál). */
+    metadata?: unknown;
+    constructor(set?: Partial<DyNTS_LVS_VectorPersist>);
+}
+/**
+ * MongoDB data-params a `dynts_lvs_vector` collection-höz (BFR-AM-001). Az `embedding` `number[]` a
+ * perzistált nyers vektor; a `metadata` `type:'object'` (Mongoose `Mixed`) — a séma NEM validál. A
+ * `vectorId` + `collectionKey` index-elt (a hidratálás `collectionKey`-re, az upsert/remove a
+ * `vectorId`+`collectionKey` párra szűr).
+ */
+export declare const DyNTS_lvsVectorPersist_dataParams: DyFM_DataModel_Params<DyNTS_LVS_VectorPersist>;
+//# sourceMappingURL=lvs-vector-persist.data-model.d.ts.map

package/build/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lvs-vector-persist.data-model.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAe,MAAM,uBAAuB,CAAC;AAE1F;;;;;;;;;;;;;GAaG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;IAExD,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,2FAA2F;IAC3F,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,OAAO,CAAC;gBAEP,GAAG,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC;CAOnD;AAED;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,EAAE,qBAAqB,CAAC,uBAAuB,CAUzF,CAAC"}

package/build/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_lvsVectorPersist_dataParams = exports.DyNTS_LVS_VectorPersist = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+/**
+ * `DyNTS_LVS_VectorPersist` (BFR-AM-001) — egy MongoDB-ben perzistált vektor-rekord, ami a
+ * `LVS_VectorPool_ControlService` **in-memory** pool-jának tartós háttértára. A FAM (fdp-agent-memory)
+ * workaround-ját generalizálja: a vektorok a SAJÁT Mongo-ban élnek, boot-kor a memória-pool-ba
+ * hidratálódnak — **NEM** MongoDB Atlas Vector Search.
+ *
+ * Egy dokumentum = **egy vektor egy adott pool-ban**. A `collectionKey` particionálja a pool-okat
+ * (egy fogyasztó több, logikailag elkülönített pool-t tarthat — pl. táranként). A `vectorId` a pool-on
+ * belüli kulcs (a `pool.addVector(vectorId, embedding)` ezzel illeszt).
+ *
+ * `extends DyFM_Metadata`: az identitás/metadata (`_id`, `__created`, `__lastModified`, `_deleted`) az
+ * ősből jön. A `metadata` `unknown` (Mongoose `Mixed`) — a fogyasztó tetszőleges kísérő-adatot tárolhat
+ * (a séma NEM validál); az `embedding` `number[]` a perzistált nyers vektor.
+ */
+class DyNTS_LVS_VectorPersist extends fsm_dynamo_1.DyFM_Metadata {
+    /** A pool-on belüli vektor-kulcs (a `pool.addVector(vectorId, ...)` ezzel illeszt). */
+    vectorId;
+    /** Melyik (logikai) pool-hoz tartozik — a pool-particionálás kulcsa (hidratálás-szűrő). */
+    collectionKey;
+    /** A perzistált NYERS vektor (a pool maga számolja a normalizált másolatot). */
+    embedding;
+    /** A vektor dimenziója (homogenitás-ellenőrzéshez + diagnosztikához tárolt). */
+    dimensions;
+    /** Opcionális fogyasztó-specifikus kísérő-adat (Mongoose `Mixed`; a séma NEM validál). */
+    metadata;
+    constructor(set) {
+        super(set);
+        if (set) {
+            fsm_dynamo_1.DyFM_Object.cleanAssign(this, set);
+        }
+    }
+}
+exports.DyNTS_LVS_VectorPersist = DyNTS_LVS_VectorPersist;
+/**
+ * MongoDB data-params a `dynts_lvs_vector` collection-höz (BFR-AM-001). Az `embedding` `number[]` a
+ * perzistált nyers vektor; a `metadata` `type:'object'` (Mongoose `Mixed`) — a séma NEM validál. A
+ * `vectorId` + `collectionKey` index-elt (a hidratálás `collectionKey`-re, az upsert/remove a
+ * `vectorId`+`collectionKey` párra szűr).
+ */
+exports.DyNTS_lvsVectorPersist_dataParams = new fsm_dynamo_1.DyFM_DataModel_Params({
+    dataName: 'dynts_lvs_vector',
+    properties: {
+        vectorId: { type: 'string', index: true, required: true },
+        collectionKey: { type: 'string', index: true, required: true },
+        embedding: { type: 'number[]' },
+        dimensions: { type: 'number' },
+        metadata: { type: 'object' },
+    },
+});
+//# sourceMappingURL=lvs-vector-persist.data-model.js.map

package/build/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lvs-vector-persist.data-model.js","sourceRoot":"","sources":["../../../../../src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts"],"names":[],"mappings":";;;AACA,sDAA0F;AAE1F;;;;;;;;;;;;;GAaG;AACH,MAAa,uBAAwB,SAAQ,0BAAa;IAExD,uFAAuF;IACvF,QAAQ,CAAU;IAElB,2FAA2F;IAC3F,aAAa,CAAU;IAEvB,gFAAgF;IAChF,SAAS,CAAY;IAErB,gFAAgF;IAChF,UAAU,CAAU;IAEpB,0FAA0F;IAC1F,QAAQ,CAAW;IAEnB,YAAY,GAAsC;QAChD,KAAK,CAAC,GAAG,CAAC,CAAC;QAEX,IAAI,GAAG,EAAE,CAAC;YACR,wBAAW,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;CACF;AAxBD,0DAwBC;AAED;;;;;GAKG;AACU,QAAA,iCAAiC,GAC5C,IAAI,kCAAqB,CAA0B;IACjD,QAAQ,EAAE,kBAAkB;IAC5B,UAAU,EAAE;QACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;QACzD,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC9D,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QAC/B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC7B;CACF,CAAC,CAAC"}

package/build/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.d.ts

@@ -0,0 +1,70 @@
+import { LVS_Search_Mode } from '../_enums/lvs-search-mode.enum';
+import { LVS_SearchResult } from '../_models/lvs-search-result.interface';
+import { DyNTS_LVS_VectorPersist } from '../_models/data-models/lvs-vector-persist.data-model';
+import { LVS_VectorPool_ControlService } from './lvs-vector-pool.control-service';
+/**
+ * `DyNTS_LVS_PersistentVectorPool_ControlService` (BFR-AM-001) — egy `LVS_VectorPool_ControlService` in-memory pool +
+ * MongoDB-perzisztencia **kompozíciója**. A FAM (fdp-agent-memory) `FAM_VectorSearch_ControlService`
+ * persist+hydrate workaround-ját generalizálja bedrock-szintre: a vektorok a SAJÁT Mongo-ban
+ * (`dynts_lvs_vector`) élnek, boot-kor a memória-pool-ba hidratálódnak — **NEM** MongoDB Atlas
+ * Vector Search.
+ *
+ * **Miért KOMPOZÍCIÓ (NEM a pool-class módosítása):** a `LVS_VectorPool_ControlService`-t egy másik,
+ * párhuzamos WIP (hybrid cosine+BM25) is érinti; a pool-class változtatása merge-konfliktust okozna.
+ * Ez a wrapper a pool-t VÁLTOZATLANUL hagyja (delegál: `addVector`/`removeVector`/`updateVector`/
+ * `search`), és a perzisztencia-mellékhatást a wrapper-metódusokban végzi. Egy wrapper-instance egy
+ * `collectionKey` (logikai pool); több pool = több wrapper.
+ *
+ * **FIGYELEM (memory: dynts_dataservice_eager_resolve):** a `DyNTS_DataService` base-ctor EAGER
+ * `getDBService`-t hív, ezért a wrapper NEM tart élő data-service-mezőt — minden DB-művelet előtt lazy
+ * `new DyNTS_LVS_VectorPersist_DataService(...)` (a `getPersistService` ezt adja).
+ */
+export declare class DyNTS_LVS_PersistentVectorPool_ControlService {
+    /** A wrapped in-memory pool (a Dynamo LVS engine; VÁLTOZATLAN — kompozíció, nem módosítás). */
+    private readonly pool;
+    /** A pool-particionálás kulcsa (a Mongo-rekordok `collectionKey`-e + a hidratálás-szűrő). */
+    private readonly collectionKey;
+    /** A perzisztencia-műveletek issuer-e (audit). */
+    private readonly issuer;
+    constructor(set: {
+        collectionKey: string;
+        issuer: string;
+        pool?: LVS_VectorPool_ControlService;
+    });
+    /** A wrapped in-memory pool (közvetlen olvasáshoz — pl. más search-mód, getAll). */
+    getPool(): LVS_VectorPool_ControlService;
+    /**
+     * Egy vektor felvétele a memória-pool-ba ÉS tartós upsert-je Mongo-ba (persist-on-write, FAM-minta).
+     * A pool `addVector`-ja upsert-szemantikájú (azonos kulcson felülír), a Mongo-oldal is `(collectionKey,
+     * vectorId)`-upsert. A Mongo-írás MELLÉKHATÁS a memória-művelet után (a memória a forrás, a Mongo a tár).
+     */
+    addVector(vectorId: string, vector: number[], metadata?: unknown): Promise<void>;
+    /**
+     * Egy MEGLÉVŐ vektor frissítése a memória-pool-ban + tartós upsert Mongo-ba. A pool `updateVector`-ja
+     * dob, ha a kulcs nem létezik (a pool-szerződés változatlan) — a Mongo-írás csak siker után fut.
+     */
+    updateVector(vectorId: string, vector: number[], metadata?: unknown): Promise<void>;
+    /** Egy vektor eltávolítása a memória-pool-ból ÉS a tartós tárból (`(collectionKey, vectorId)`). */
+    removeVector(vectorId: string): Promise<void>;
+    /** Keresés a memória-pool-on (a wrapped pool `search`-jét delegálja — VÁLTOZATLAN engine). */
+    search(query: number[], k: number, mode: LVS_Search_Mode): LVS_SearchResult[];
+    /**
+     * BOOT-HIDRATÁLÁS (FAM-minta, BFR-AM-001): a `collectionKey` ÖSSZES perzistált vektorát betölti a
+     * MEMÓRIA-pool-ba (`pool.addVector`), így a szerver-restart utáni in-memory index újraépül. A pool-t
+     * előbb üríti (idempotens hidratálás). A hiányos (üres `vectorId`/`embedding`) rekordokat átugorja.
+     * Visszaadja a betöltött vektorok számát. **NEM** Atlas — saját Mongo + in-memory pool.
+     */
+    hydrateFromMongo(): Promise<number>;
+    /**
+     * Perzistált rekordok közvetlen hidratálása a memória-pool-ba (Mongo-olvasás NÉLKÜL) — ha a hívó már
+     * kezében van a rekord-halmaz (pl. batch-boot). A pool-t előbb üríti (idempotens). Visszaadja a
+     * betöltött vektorok számát.
+     */
+    hydrate(records: DyNTS_LVS_VectorPersist[]): number;
+    /**
+     * Lazy persist-data-service (memory: dynts_dataservice_eager_resolve — a base-ctor eager
+     * `getDBService`-e miatt NEM tartható élő mezőként).
+     */
+    private getPersistService;
+}
+//# sourceMappingURL=lvs-persistent-vector-pool.control-service.d.ts.map

package/build/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lvs-persistent-vector-pool.control-service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sDAAsD,CAAC;AAE/F,OAAO,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAElF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,6CAA6C;IAExD,+FAA+F;IAC/F,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IAErD,6FAA6F;IAC7F,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAEvC,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,GAAG,EAAE;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,6BAA6B,CAAC;KACtC;IAOD,oFAAoF;IACpF,OAAO,IAAI,6BAA6B;IAIxC;;;;OAIG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtF;;;OAGG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzF,mGAAmG;IAC7F,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD,8FAA8F;IAC9F,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,gBAAgB,EAAE;IAI7E;;;;;OAKG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAuBzC;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,uBAAuB,EAAE,GAAG,MAAM;IAenD;;;OAGG;IACH,OAAO,CAAC,iBAAiB;CAG1B"}

package/build/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_LVS_PersistentVectorPool_ControlService = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const lvs_vector_persist_data_service_1 = require("./lvs-vector-persist.data-service");
+const lvs_vector_pool_control_service_1 = require("./lvs-vector-pool.control-service");
+/**
+ * `DyNTS_LVS_PersistentVectorPool_ControlService` (BFR-AM-001) — egy `LVS_VectorPool_ControlService` in-memory pool +
+ * MongoDB-perzisztencia **kompozíciója**. A FAM (fdp-agent-memory) `FAM_VectorSearch_ControlService`
+ * persist+hydrate workaround-ját generalizálja bedrock-szintre: a vektorok a SAJÁT Mongo-ban
+ * (`dynts_lvs_vector`) élnek, boot-kor a memória-pool-ba hidratálódnak — **NEM** MongoDB Atlas
+ * Vector Search.
+ *
+ * **Miért KOMPOZÍCIÓ (NEM a pool-class módosítása):** a `LVS_VectorPool_ControlService`-t egy másik,
+ * párhuzamos WIP (hybrid cosine+BM25) is érinti; a pool-class változtatása merge-konfliktust okozna.
+ * Ez a wrapper a pool-t VÁLTOZATLANUL hagyja (delegál: `addVector`/`removeVector`/`updateVector`/
+ * `search`), és a perzisztencia-mellékhatást a wrapper-metódusokban végzi. Egy wrapper-instance egy
+ * `collectionKey` (logikai pool); több pool = több wrapper.
+ *
+ * **FIGYELEM (memory: dynts_dataservice_eager_resolve):** a `DyNTS_DataService` base-ctor EAGER
+ * `getDBService`-t hív, ezért a wrapper NEM tart élő data-service-mezőt — minden DB-művelet előtt lazy
+ * `new DyNTS_LVS_VectorPersist_DataService(...)` (a `getPersistService` ezt adja).
+ */
+class DyNTS_LVS_PersistentVectorPool_ControlService {
+    /** A wrapped in-memory pool (a Dynamo LVS engine; VÁLTOZATLAN — kompozíció, nem módosítás). */
+    pool;
+    /** A pool-particionálás kulcsa (a Mongo-rekordok `collectionKey`-e + a hidratálás-szűrő). */
+    collectionKey;
+    /** A perzisztencia-műveletek issuer-e (audit). */
+    issuer;
+    constructor(set) {
+        this.collectionKey = set.collectionKey;
+        this.issuer = set.issuer;
+        // Saját pool, ha a hívó nem ad be egyet (a wrapper nem módosítja a pool-osztályt — kompozíció).
+        this.pool = set.pool ?? new lvs_vector_pool_control_service_1.LVS_VectorPool_ControlService();
+    }
+    /** A wrapped in-memory pool (közvetlen olvasáshoz — pl. más search-mód, getAll). */
+    getPool() {
+        return this.pool;
+    }
+    /**
+     * Egy vektor felvétele a memória-pool-ba ÉS tartós upsert-je Mongo-ba (persist-on-write, FAM-minta).
+     * A pool `addVector`-ja upsert-szemantikájú (azonos kulcson felülír), a Mongo-oldal is `(collectionKey,
+     * vectorId)`-upsert. A Mongo-írás MELLÉKHATÁS a memória-művelet után (a memória a forrás, a Mongo a tár).
+     */
+    async addVector(vectorId, vector, metadata) {
+        this.pool.addVector(vectorId, vector);
+        await this.getPersistService().upsertVector({
+            collectionKey: this.collectionKey,
+            vectorId: vectorId,
+            embedding: vector,
+            metadata: metadata,
+        });
+    }
+    /**
+     * Egy MEGLÉVŐ vektor frissítése a memória-pool-ban + tartós upsert Mongo-ba. A pool `updateVector`-ja
+     * dob, ha a kulcs nem létezik (a pool-szerződés változatlan) — a Mongo-írás csak siker után fut.
+     */
+    async updateVector(vectorId, vector, metadata) {
+        this.pool.updateVector(vectorId, vector);
+        await this.getPersistService().upsertVector({
+            collectionKey: this.collectionKey,
+            vectorId: vectorId,
+            embedding: vector,
+            metadata: metadata,
+        });
+    }
+    /** Egy vektor eltávolítása a memória-pool-ból ÉS a tartós tárból (`(collectionKey, vectorId)`). */
+    async removeVector(vectorId) {
+        this.pool.removeVector(vectorId);
+        await this.getPersistService().removeVector(this.collectionKey, vectorId);
+    }
+    /** Keresés a memória-pool-on (a wrapped pool `search`-jét delegálja — VÁLTOZATLAN engine). */
+    search(query, k, mode) {
+        return this.pool.search(query, k, mode);
+    }
+    /**
+     * BOOT-HIDRATÁLÁS (FAM-minta, BFR-AM-001): a `collectionKey` ÖSSZES perzistált vektorát betölti a
+     * MEMÓRIA-pool-ba (`pool.addVector`), így a szerver-restart utáni in-memory index újraépül. A pool-t
+     * előbb üríti (idempotens hidratálás). A hiányos (üres `vectorId`/`embedding`) rekordokat átugorja.
+     * Visszaadja a betöltött vektorok számát. **NEM** Atlas — saját Mongo + in-memory pool.
+     */
+    async hydrateFromMongo() {
+        const records = await this.getPersistService().findByCollectionKey(this.collectionKey);
+        this.pool.clearPool();
+        let loaded = 0;
+        for (const record of records) {
+            if (!record.vectorId || !record.embedding?.length) {
+                continue;
+            }
+            this.pool.addVector(record.vectorId, record.embedding);
+            loaded++;
+        }
+        fsm_dynamo_1.DyFM_Log.log(`[DyNTS LVS hydrate] '${this.collectionKey}' pool: ${loaded} vektor betöltve az in-memory pool-ba.`);
+        return loaded;
+    }
+    /**
+     * Perzistált rekordok közvetlen hidratálása a memória-pool-ba (Mongo-olvasás NÉLKÜL) — ha a hívó már
+     * kezében van a rekord-halmaz (pl. batch-boot). A pool-t előbb üríti (idempotens). Visszaadja a
+     * betöltött vektorok számát.
+     */
+    hydrate(records) {
+        this.pool.clearPool();
+        let loaded = 0;
+        for (const record of records) {
+            if (!record.vectorId || !record.embedding?.length) {
+                continue;
+            }
+            this.pool.addVector(record.vectorId, record.embedding);
+            loaded++;
+        }
+        return loaded;
+    }
+    /**
+     * Lazy persist-data-service (memory: dynts_dataservice_eager_resolve — a base-ctor eager
+     * `getDBService`-e miatt NEM tartható élő mezőként).
+     */
+    getPersistService() {
+        return new lvs_vector_persist_data_service_1.DyNTS_LVS_VectorPersist_DataService({ issuer: this.issuer });
+    }
+}
+exports.DyNTS_LVS_PersistentVectorPool_ControlService = DyNTS_LVS_PersistentVectorPool_ControlService;
+//# sourceMappingURL=lvs-persistent-vector-pool.control-service.js.map

package/build/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lvs-persistent-vector-pool.control-service.js","sourceRoot":"","sources":["../../../../src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts"],"names":[],"mappings":";;;AACA,sDAAiD;AAKjD,uFAAwF;AACxF,uFAAkF;AAElF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,6CAA6C;IAExD,+FAA+F;IAC9E,IAAI,CAAgC;IAErD,6FAA6F;IAC5E,aAAa,CAAS;IAEvC,kDAAkD;IACjC,MAAM,CAAS;IAEhC,YAAY,GAIX;QACC,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QACzB,gGAAgG;QAChG,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,IAAI,+DAA6B,EAAE,CAAC;IAC9D,CAAC;IAED,oFAAoF;IACpF,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,QAAgB,EAAE,MAAgB,EAAE,QAAkB;QACpE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACtC,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC,YAAY,CAAC;YAC1C,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,QAAQ,EAAE,QAAQ;YAClB,SAAS,EAAE,MAAM;YACjB,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,QAAgB,EAAE,MAAgB,EAAE,QAAkB;QACvE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC,YAAY,CAAC;YAC1C,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,QAAQ,EAAE,QAAQ;YAClB,SAAS,EAAE,MAAM;YACjB,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAC;IACL,CAAC;IAED,mGAAmG;IACnG,KAAK,CAAC,YAAY,CAAC,QAAgB;QACjC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IAC5E,CAAC;IAED,8FAA8F;IAC9F,MAAM,CAAC,KAAe,EAAE,CAAS,EAAE,IAAqB;QACtD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,gBAAgB;QACpB,MAAM,OAAO,GACX,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAEzE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAEtB,IAAI,MAAM,GAAW,CAAC,CAAC;QAEvB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;gBAClD,SAAS;YACX,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;YACvD,MAAM,EAAE,CAAC;QACX,CAAC;QAED,qBAAQ,CAAC,GAAG,CACV,wBAAwB,IAAI,CAAC,aAAa,WAAW,MAAM,wCAAwC,CACpG,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAkC;QACxC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACtB,IAAI,MAAM,GAAW,CAAC,CAAC;QAEvB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;gBAClD,SAAS;YACX,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;YACvD,MAAM,EAAE,CAAC;QACX,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACK,iBAAiB;QACvB,OAAO,IAAI,qEAAmC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1E,CAAC;CACF;AA3HD,sGA2HC"}

package/build/_modules/local-vector-search/_services/lvs-vector-persist.data-service.d.ts

@@ -0,0 +1,43 @@
+import { DyNTS_DataService } from '../../../_services/base/data.service';
+import { DyNTS_LVS_VectorPersist } from '../_models/data-models/lvs-vector-persist.data-model';
+/**
+ * `DyNTS_LVS_VectorPersist_DataService` (BFR-AM-001) — a `dynts_lvs_vector` collection CRUD-rétege; a
+ * `LVS_VectorPool_ControlService` in-memory pool-jának tartós Mongo-háttértára. `extends
+ * DyNTS_DataService`; a nts-konvenció szerinti `{ data?, issuer }` constructor.
+ *
+ * **FIGYELEM (memory: dynts_dataservice_eager_resolve):** a `DyNTS_DataService` base-ctor EAGER
+ * `getDBService`-t hív → a hívó NEM tarthat élő data-service-példányt mezőként; minden művelet előtt
+ * lazy `new DyNTS_LVS_VectorPersist_DataService(...)` kell (a `DyNTS_LVS_PersistentVectorPool_ControlService` így jár el).
+ *
+ * **Atomikus írás (memory: mongoose_mixed_atomic_write):** az upsert a `(collectionKey, vectorId)`
+ * logikai-kulcson MEGLÉVŐ rekordot `updateOne({...},{$set:{embedding,dimensions,metadata}})`-tel
+ * frissíti (a Mixed `metadata` `findOne→mutate→save` SILENT-DROP-ja ellen); ÚJ rekordot `saveData`-val ír.
+ */
+export declare class DyNTS_LVS_VectorPersist_DataService extends DyNTS_DataService<DyNTS_LVS_VectorPersist> {
+    constructor(set: {
+        data?: DyNTS_LVS_VectorPersist;
+        issuer: string;
+    });
+    /**
+     * Egy (logikai) pool ÖSSZES perzistált, nem-soft-delete-elt vektor-rekordja — a boot-hidratáláshoz
+     * (a `DyNTS_LVS_PersistentVectorPool_ControlService.hydrateFromMongo` ezt tölti az in-memory pool-ba).
+     */
+    findByCollectionKey(collectionKey: string): Promise<DyNTS_LVS_VectorPersist[]>;
+    /**
+     * Egy vektor ATOMIKUS upsert-je a `(collectionKey, vectorId)` logikai-kulcson. MEGLÉVŐ rekordnál
+     * `$set` (a Mixed `metadata` silent-drop ellen — memory: mongoose_mixed_atomic_write); ÚJ rekordnál
+     * `saveData`. A dimenzió az `embedding.length`-ből rögzül.
+     */
+    upsertVector(set: {
+        collectionKey: string;
+        vectorId: string;
+        embedding: number[];
+        metadata?: unknown;
+    }): Promise<void>;
+    /**
+     * Egy vektor-rekord végleges törlése a `(collectionKey, vectorId)` logikai-kulcson (a pool
+     * `removeVector`-ja után — a tartós tár is törli). `addArchive` nincs → `absolute` true-val töröl.
+     */
+    removeVector(collectionKey: string, vectorId: string): Promise<void>;
+}
+//# sourceMappingURL=lvs-vector-persist.data-service.d.ts.map

package/build/_modules/local-vector-search/_services/lvs-vector-persist.data-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lvs-vector-persist.data-service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EACL,uBAAuB,EAExB,MAAM,sDAAsD,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACH,qBAAa,mCAAoC,SAAQ,iBAAiB,CAAC,uBAAuB,CAAC;gBAG/F,GAAG,EAAE;QACH,IAAI,CAAC,EAAE,uBAAuB,CAAC;QAC/B,MAAM,EAAE,MAAM,CAAC;KAChB;IAWH;;;OAGG;IACG,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAOpF;;;;OAIG;IACG,YAAY,CAAC,GAAG,EAAE;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCjB;;;OAGG;IACG,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAU3E"}

package/build/_modules/local-vector-search/_services/lvs-vector-persist.data-service.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_LVS_VectorPersist_DataService = void 0;
+const data_service_1 = require("../../../_services/base/data.service");
+const lvs_vector_persist_data_model_1 = require("../_models/data-models/lvs-vector-persist.data-model");
+/**
+ * `DyNTS_LVS_VectorPersist_DataService` (BFR-AM-001) — a `dynts_lvs_vector` collection CRUD-rétege; a
+ * `LVS_VectorPool_ControlService` in-memory pool-jának tartós Mongo-háttértára. `extends
+ * DyNTS_DataService`; a nts-konvenció szerinti `{ data?, issuer }` constructor.
+ *
+ * **FIGYELEM (memory: dynts_dataservice_eager_resolve):** a `DyNTS_DataService` base-ctor EAGER
+ * `getDBService`-t hív → a hívó NEM tarthat élő data-service-példányt mezőként; minden művelet előtt
+ * lazy `new DyNTS_LVS_VectorPersist_DataService(...)` kell (a `DyNTS_LVS_PersistentVectorPool_ControlService` így jár el).
+ *
+ * **Atomikus írás (memory: mongoose_mixed_atomic_write):** az upsert a `(collectionKey, vectorId)`
+ * logikai-kulcson MEGLÉVŐ rekordot `updateOne({...},{$set:{embedding,dimensions,metadata}})`-tel
+ * frissíti (a Mixed `metadata` `findOne→mutate→save` SILENT-DROP-ja ellen); ÚJ rekordot `saveData`-val ír.
+ */
+class DyNTS_LVS_VectorPersist_DataService extends data_service_1.DyNTS_DataService {
+    constructor(set) {
+        super(set.data instanceof lvs_vector_persist_data_model_1.DyNTS_LVS_VectorPersist
+            ? set.data
+            : new lvs_vector_persist_data_model_1.DyNTS_LVS_VectorPersist(set.data), lvs_vector_persist_data_model_1.DyNTS_lvsVectorPersist_dataParams, set.issuer);
+    }
+    /**
+     * Egy (logikai) pool ÖSSZES perzistált, nem-soft-delete-elt vektor-rekordja — a boot-hidratáláshoz
+     * (a `DyNTS_LVS_PersistentVectorPool_ControlService.hydrateFromMongo` ezt tölti az in-memory pool-ba).
+     */
+    async findByCollectionKey(collectionKey) {
+        return this.findDataList({ collectionKey: collectionKey }, true);
+    }
+    /**
+     * Egy vektor ATOMIKUS upsert-je a `(collectionKey, vectorId)` logikai-kulcson. MEGLÉVŐ rekordnál
+     * `$set` (a Mixed `metadata` silent-drop ellen — memory: mongoose_mixed_atomic_write); ÚJ rekordnál
+     * `saveData`. A dimenzió az `embedding.length`-ből rögzül.
+     */
+    async upsertVector(set) {
+        const existing = await this.findData({ collectionKey: set.collectionKey, vectorId: set.vectorId }, true);
+        if (existing?._id) {
+            await this.updateData({
+                filterBy: { _id: existing._id },
+                update: {
+                    $set: {
+                        embedding: set.embedding,
+                        dimensions: set.embedding.length,
+                        metadata: set.metadata,
+                    },
+                },
+            });
+            return;
+        }
+        await this.saveData(new lvs_vector_persist_data_model_1.DyNTS_LVS_VectorPersist({
+            collectionKey: set.collectionKey,
+            vectorId: set.vectorId,
+            embedding: set.embedding,
+            dimensions: set.embedding.length,
+            metadata: set.metadata,
+        }), true);
+    }
+    /**
+     * Egy vektor-rekord végleges törlése a `(collectionKey, vectorId)` logikai-kulcson (a pool
+     * `removeVector`-ja után — a tartós tár is törli). `addArchive` nincs → `absolute` true-val töröl.
+     */
+    async removeVector(collectionKey, vectorId) {
+        const existing = await this.findData({ collectionKey: collectionKey, vectorId: vectorId }, true);
+        if (existing?._id) {
+            await this.deleteData(existing._id, true);
+        }
+    }
+}
+exports.DyNTS_LVS_VectorPersist_DataService = DyNTS_LVS_VectorPersist_DataService;
+//# sourceMappingURL=lvs-vector-persist.data-service.js.map

package/build/_modules/local-vector-search/_services/lvs-vector-persist.data-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lvs-vector-persist.data-service.js","sourceRoot":"","sources":["../../../../src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts"],"names":[],"mappings":";;;AAGA,uEAAyE;AACzE,wGAG8D;AAE9D;;;;;;;;;;;;GAYG;AACH,MAAa,mCAAoC,SAAQ,gCAA0C;IAEjG,YACE,GAGC;QAED,KAAK,CACH,GAAG,CAAC,IAAI,YAAY,uDAAuB;YACzC,CAAC,CAAC,GAAG,CAAC,IAAI;YACV,CAAC,CAAC,IAAI,uDAAuB,CAAC,GAAG,CAAC,IAAI,CAAC,EACzC,iEAAiC,EACjC,GAAG,CAAC,MAAM,CACX,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,mBAAmB,CAAC,aAAqB;QAC7C,OAAO,IAAI,CAAC,YAAY,CACtB,EAAE,aAAa,EAAE,aAAa,EAAE,EAChC,IAAI,CACL,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,GAKlB;QACC,MAAM,QAAQ,GAA4B,MAAM,IAAI,CAAC,QAAQ,CAC3D,EAAE,aAAa,EAAE,GAAG,CAAC,aAAa,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,EAC5D,IAAI,CACL,CAAC;QAEF,IAAI,QAAQ,EAAE,GAAG,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,UAAU,CAAC;gBACpB,QAAQ,EAAE,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE;gBAC/B,MAAM,EAAE;oBACN,IAAI,EAAE;wBACJ,SAAS,EAAE,GAAG,CAAC,SAAS;wBACxB,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,MAAM;wBAChC,QAAQ,EAAE,GAAG,CAAC,QAAQ;qBACvB;iBACF;aACF,CAAC,CAAC;YAEH,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,QAAQ,CACjB,IAAI,uDAAuB,CAAC;YAC1B,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,MAAM;YAChC,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACvB,CAAC,EACF,IAAI,CACL,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,aAAqB,EAAE,QAAgB;QACxD,MAAM,QAAQ,GAA4B,MAAM,IAAI,CAAC,QAAQ,CAC3D,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,EACpD,IAAI,CACL,CAAC;QAEF,IAAI,QAAQ,EAAE,GAAG,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;CACF;AArFD,kFAqFC"}

package/build/_modules/local-vector-search/index.d.ts

@@ -1,6 +1,9 @@
 export * from './_enums/lvs-search-mode.enum';
 export * from './_models/lvs-search-result.interface';
+export * from './_models/data-models/lvs-vector-persist.data-model';
 export * from './_services/lvs-doc-chunk-data.service';
 export * from './_services/lvs-local-vector-search.data-service';
 export * from './_services/lvs-vector-pool.control-service';
+export * from './_services/lvs-vector-persist.data-service';
+export * from './_services/lvs-persistent-vector-pool.control-service';
 //# sourceMappingURL=index.d.ts.map

package/build/_modules/local-vector-search/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/local-vector-search/index.ts"],"names":[],"mappings":"AAGA,cAAc,+BAA+B,CAAC;AAG9C,cAAc,uCAAuC,CAAC;AAGtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,kDAAkD,CAAC;AACjE,cAAc,6CAA6C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/local-vector-search/index.ts"],"names":[],"mappings":"AAGA,cAAc,+BAA+B,CAAC;AAG9C,cAAc,uCAAuC,CAAC;AAGtD,cAAc,qDAAqD,CAAC;AAGpE,cAAc,wCAAwC,CAAC;AACvD,cAAc,kDAAkD,CAAC;AACjE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,wDAAwD,CAAC"}

package/build/_modules/local-vector-search/index.js

@@ -5,8 +5,12 @@ const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./_enums/lvs-search-mode.enum"), exports);
 // INTERFACES
 tslib_1.__exportStar(require("./_models/lvs-search-result.interface"), exports);
+// DATA MODELS
+tslib_1.__exportStar(require("./_models/data-models/lvs-vector-persist.data-model"), exports);
 // SERVICES
 tslib_1.__exportStar(require("./_services/lvs-doc-chunk-data.service"), exports);
 tslib_1.__exportStar(require("./_services/lvs-local-vector-search.data-service"), exports);
 tslib_1.__exportStar(require("./_services/lvs-vector-pool.control-service"), exports);
+tslib_1.__exportStar(require("./_services/lvs-vector-persist.data-service"), exports);
+tslib_1.__exportStar(require("./_services/lvs-persistent-vector-pool.control-service"), exports);
 //# sourceMappingURL=index.js.map

package/build/_modules/local-vector-search/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/local-vector-search/index.ts"],"names":[],"mappings":";;;AAEA,QAAQ;AACR,wEAA8C;AAE9C,aAAa;AACb,gFAAsD;AAEtD,WAAW;AACX,iFAAuD;AACvD,2FAAiE;AACjE,sFAA4D"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/local-vector-search/index.ts"],"names":[],"mappings":";;;AAEA,QAAQ;AACR,wEAA8C;AAE9C,aAAa;AACb,gFAAsD;AAEtD,cAAc;AACd,8FAAoE;AAEpE,WAAW;AACX,iFAAuD;AACvD,2FAAiE;AACjE,sFAA4D;AAC5D,sFAA4D;AAC5D,iGAAuE"}

package/build/_modules/mcp/_models/interfaces/dynts-mcp.interface.d.ts

@@ -0,0 +1,109 @@
+/**
+ * MCP-réteg shared vokabulár (BFR-AM-003) — a domain-agnosztikus MCP-szerver-base + adaptor közös
+ * típusai. Egy fájlban a szorosan összetartozó tool-/transport-típusok (`*.interface.ts` az
+ * egy-export-per-file konvenció ismert kivétele a tightly-coupled shape-ekre).
+ *
+ * Boundary: a `DyNTS_McpToolDefinition` + a `DyNTS_Mcp_Adapter` egyetlen `registerTool` choke-pontot
+ * ad — a hivatalos `@modelcontextprotocol/sdk` KIZÁRÓLAG az adaptor mögött él, így egy jövőbeli
+ * transport-/SDK-csere NEM-breaking (csak az adaptor cserélődik, a `DyNTS_Mcp_Server_ServiceBase` + a
+ * consumer-tool-ok változatlanok). A consumer a SAJÁT tool-jait regisztrálja (a bedrock NEM definiál
+ * domain-tool-okat — csak a server-base + a transport + a registry).
+ */
+/**
+ * Egy JSON-schema fragment (a tool input-schema-jának típusa). Szabad-formájú JSON-objektum (a
+ * draft-07 / MCP tool-schema dialektusa); a `properties`/`required`/`type` mezők gyakoriak, de a
+ * shape nem kényszerített (az MCP-kliens a `tools/list`-ben kapja vissza, ahogy van).
+ */
+export interface DyNTS_Mcp_JsonSchema {
+    /** A JSON-schema gyökér-típusa (a tool input-ja jellemzően `object`). */
+    type: string;
+    /** A property-leírások (kulcs → al-schema). */
+    properties?: {
+        [key: string]: DyNTS_Mcp_JsonSchema;
+    };
+    /** Kötelező property-nevek. */
+    required?: string[];
+    /** Array-elem schema (`type: 'array'` esetén). */
+    items?: DyNTS_Mcp_JsonSchema;
+    /** Enum-értékek (string/number/boolean literál-halmaz). */
+    enum?: (string | number | boolean)[];
+    /** Emberi leírás (a tool-választáshoz; az LLM ezt olvassa). */
+    description?: string;
+    /** Default érték (a kliens-hint). */
+    default?: unknown;
+    /** Engedi-e a nem-leírt property-ket (`object` schema-n). */
+    additionalProperties?: boolean;
+    /** Beágyazott `oneOf`/`anyOf` alternatívák. */
+    oneOf?: DyNTS_Mcp_JsonSchema[];
+}
+/**
+ * Egy MCP tool-handler kimenete (a transport-agnosztikus core ezt adja; az adaptor MCP-tool-result-tá
+ * fordítja). A `data` a strukturált JSON-payload; az `isError` jelzi a strukturált hibát — a néma
+ * hiba TILOS (a hiba MINDIG `isError:true` payload VAGY dobott exception, amit az adaptor egységesen
+ * `isError`-re fordít).
+ */
+export interface DyNTS_Mcp_ToolOutcome {
+    /** A strukturált eredmény-payload (a tool output-shape JSON-ja). */
+    data: unknown;
+    /** `true`, ha a kimenet strukturált hiba — az adaptor `isError`-re fordítja. */
+    isError?: boolean;
+}
+/**
+ * Egy tool-handler aláírása. Az `args` a nyers tool-argumentumok (JSON); a handler a saját
+ * input-shape-jére validál + a `DyNTS_Mcp_ToolOutcome`-ot adja. A hibát NEM nyeli el (strukturált
+ * hiba-payload `isError:true`-val VAGY dobott exception, amit az adaptor egységes MCP-error-ré fordít).
+ */
+export type DyNTS_Mcp_ToolHandler = (args: unknown) => Promise<DyNTS_Mcp_ToolOutcome>;
+/**
+ * Egy MCP tool-definíció (a `registerTool` egységes shape-je). A consumer ezt a shape-et használja az
+ * advertised halmazba (`name`+`description`+`inputSchema`+`handler`). A `tools/list` a regisztrált
+ * tool-ok `name`/`description`/`inputSchema`-ját hirdeti.
+ */
+export interface DyNTS_Mcp_ToolDefinition {
+    /** A tool neve (a `tools/list`-ben + a `tools/call` dispatch-kulcsa — UNIK kell legyen). */
+    name: string;
+    /** Agent-barát leírás (mikor melyik tool; az LLM ezt olvassa a tool-választáshoz). */
+    description: string;
+    /** A tool input JSON-schema-ja (a `tools/list` ezt hirdeti). */
+    inputSchema: DyNTS_Mcp_JsonSchema;
+    /** A handler (a transport-agnosztikus core-logika). */
+    handler: DyNTS_Mcp_ToolHandler;
+}
+/**
+ * Az MCP-szerver identitása (a SDK `serverInfo`-ja). A `name`/`version` a kliensnek hirdetett.
+ */
+export interface DyNTS_Mcp_ServerInfo {
+    /** A szerver neve (a kliensnek hirdetett `serverInfo.name`). */
+    name: string;
+    /** A szerver verziója (a kliensnek hirdetett `serverInfo.version`). */
+    version: string;
+}
+/**
+ * A támogatott transport-fajták. MVP: `stdio` (a JSON-RPC a stdin/stdout-on). A `start({transport})`
+ * ezzel választ — egy jövőbeli transport (pl. `http`/`sse`) NON-breaking módon bővíthető (csak az
+ * adaptor `start`-ja kap új ágat; a server-base + a tool-ok változatlanok).
+ */
+export type DyNTS_Mcp_TransportKind = 'stdio';
+/**
+ * A `start()` opciói. A `transport` választja a csatornát (default `stdio`).
+ */
+export interface DyNTS_Mcp_StartOptions {
+    /** A transport-csatorna (default `stdio`). */
+    transport?: DyNTS_Mcp_TransportKind;
+}
+/**
+ * Egy MCP `tools/call` strukturált eredménye (a transport-payload shape-je). Az adaptor ezt termeli;
+ * a `content` egy text-JSON blokk, az `isError` a strukturált-hiba jelzés. Ez a SDK
+ * `CallToolResult`-tal wire-kompatibilis al-shape (a SDK-t az adaptor izolálja, ezért itt a saját,
+ * SDK-független shape él).
+ */
+export interface DyNTS_Mcp_CallResult {
+    /** A tartalom-blokkok (MVP: egyetlen `text`-JSON blokk). */
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    /** `true`, ha a hívás strukturált hibával végződött (no-silent-failure). */
+    isError?: boolean;
+}
+//# sourceMappingURL=dynts-mcp.interface.d.ts.map

package/build/_modules/mcp/_models/interfaces/dynts-mcp.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-mcp.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,UAAU,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAAA;KAAE,CAAC;IACrD,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,kDAAkD;IAClD,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,2DAA2D;IAC3D,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC;IACrC,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6DAA6D;IAC7D,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,+CAA+C;IAC/C,KAAK,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IAClC,oEAAoE;IACpE,IAAI,EAAE,OAAO,CAAC;IACd,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAEtF;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACrC,4FAA4F;IAC5F,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,WAAW,EAAE,oBAAoB,CAAC;IAClC,uDAAuD;IACvD,OAAO,EAAE,qBAAqB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,uBAAuB,CAAC;CACvC;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACjC,4DAA4D;IAC5D,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,4EAA4E;IAC5E,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB"}