@futdevpro/nts-dynamo 1.15.56 → 1.15.58

package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts

@@ -1,100 +1,100 @@
-import { DyFM_DataModel_Params, DyFM_Metadata } from '@futdevpro/fsm-dynamo';
-import { DyNTS_DAI_DocChunk } from './dai-doc-chunk.data-model';
-import { DyNTS_DAI_DocPage } from './dai-doc-page.data-model';
-
-
-
-export class DyNTS_DAI_Document<
-  T_Chunk extends DyNTS_DAI_DocChunk = DyNTS_DAI_DocChunk,
-  T_Page extends DyNTS_DAI_DocPage<T_Chunk> = DyNTS_DAI_DocPage<T_Chunk>,
-  T_ExternalDocumentId = string, // | Record<string, string | number>,
-  T_ExternalMetadata = any,
-> extends DyFM_Metadata {
-  /** 
-   * this is the document id in the outside source 
-   * eg.: the id in Clickup, Confluence, etc.
-   * */
-  externalDocumentId?: T_ExternalDocumentId; // | Record<string, string | number>;
-
-  name: string;
-
-  /** runtime only */
-  pages?: T_Page[] = [];
-
-  externalMetadata?: T_ExternalMetadata;
-
-  constructor(
-    set?: DyNTS_DAI_Document<T_Chunk, T_Page, T_ExternalDocumentId, T_ExternalMetadata>
-  ) {
-    super(set);
-
-    if (set) {
-      Object.assign(this, set);
-    }
-  }
-}
-
-export const DyNTS_DAI_document_dataParams: DyFM_DataModel_Params<DyNTS_DAI_Document> = 
-  new DyFM_DataModel_Params<DyNTS_DAI_Document>({
-    dataName: 'document',
-    properties: {
-      externalDocumentId: {
-        type: 'string',
-        unique: true,
-        index: true,
-        required: true,
-      },
-
-      name: {
-        type: 'string',
-        required: true,
-      },
-
-      pages: {
-        type: 'DyNTS_DAI_DocPage[]',
-        forbidden: true,
-      },
-
-      externalMetadata: {
-        type: 'T_ExternalMetadata',
-      },
-    },
-  });
-
-
-
-
-
-
-///**
-// * Generic document page interface
-// * Provider-agnostic document page structure
-// */
-//export interface DyNTS_DAI_DocPage<T_Chunk = any> {
-//  /** Unique identifier for the page */
-//  id?: string;
-//  /** Name of the page */
-//  name: string;
-//  /** Content of the page */
-//  content: string;
-//  /** Link to the page */
-//  link?: string;
-//  /** Path to the page */
-//  path?: string;
-//  /** Parent path elements */
-//  parentedPath?: string[];
-//  /** All flagged parents merged */
-//  allFlaggedParentsMerged?: string;
-//  /** All flagged parents as array */
-//  allFlaggedParents?: string[];
-//  /** Chunks contained in this page */
-//  chunks?: T_Chunk[];
-//  /** Metadata about the page */
-//  metadata?: {
-//    createdAt?: Date;
-//    updatedAt?: Date;
-//    size?: number;
-//    [key: string]: any;
-//  };
-//}
+import { DyFM_DataModel_Params, DyFM_Metadata } from '@futdevpro/fsm-dynamo';
+import { DyNTS_DAI_DocChunk } from './dai-doc-chunk.data-model';
+import { DyNTS_DAI_DocPage } from './dai-doc-page.data-model';
+
+
+
+export class DyNTS_DAI_Document<
+  T_Chunk extends DyNTS_DAI_DocChunk = DyNTS_DAI_DocChunk,
+  T_Page extends DyNTS_DAI_DocPage<T_Chunk> = DyNTS_DAI_DocPage<T_Chunk>,
+  T_ExternalDocumentId = string, // | Record<string, string | number>,
+  T_ExternalMetadata = any,
+> extends DyFM_Metadata {
+  /** 
+   * this is the document id in the outside source 
+   * eg.: the id in Clickup, Confluence, etc.
+   * */
+  externalDocumentId?: T_ExternalDocumentId; // | Record<string, string | number>;
+
+  name: string;
+
+  /** runtime only */
+  pages?: T_Page[] = [];
+
+  externalMetadata?: T_ExternalMetadata;
+
+  constructor(
+    set?: DyNTS_DAI_Document<T_Chunk, T_Page, T_ExternalDocumentId, T_ExternalMetadata>
+  ) {
+    super(set);
+
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}
+
+export const DyNTS_DAI_document_dataParams: DyFM_DataModel_Params<DyNTS_DAI_Document> = 
+  new DyFM_DataModel_Params<DyNTS_DAI_Document>({
+    dataName: 'document',
+    properties: {
+      externalDocumentId: {
+        type: 'string',
+        unique: true,
+        index: true,
+        required: true,
+      },
+
+      name: {
+        type: 'string',
+        required: true,
+      },
+
+      pages: {
+        type: 'DyNTS_DAI_DocPage[]',
+        forbidden: true,
+      },
+
+      externalMetadata: {
+        type: 'T_ExternalMetadata',
+      },
+    },
+  });
+
+
+
+
+
+
+///**
+// * Generic document page interface
+// * Provider-agnostic document page structure
+// */
+//export interface DyNTS_DAI_DocPage<T_Chunk = any> {
+//  /** Unique identifier for the page */
+//  id?: string;
+//  /** Name of the page */
+//  name: string;
+//  /** Content of the page */
+//  content: string;
+//  /** Link to the page */
+//  link?: string;
+//  /** Path to the page */
+//  path?: string;
+//  /** Parent path elements */
+//  parentedPath?: string[];
+//  /** All flagged parents merged */
+//  allFlaggedParentsMerged?: string;
+//  /** All flagged parents as array */
+//  allFlaggedParents?: string[];
+//  /** Chunks contained in this page */
+//  chunks?: T_Chunk[];
+//  /** Metadata about the page */
+//  metadata?: {
+//    createdAt?: Date;
+//    updatedAt?: Date;
+//    size?: number;
+//    [key: string]: any;
+//  };
+//}
 //

package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts

@@ -0,0 +1,68 @@
+/**
+ * `DyNTS_DAI_CodeChunkType` — egy kód-chunk szemantikus típusa (BFR-AM-005).
+ * A TS Compiler API node-fajtáihoz igazítva: import-csoport, top-level deklarációk
+ * (class/interface/enum/type/function/standalone const) + osztály-metódus + nagy-node
+ * sliding-sub-chunk + tiny-fallback.
+ */
+export type DyNTS_DAI_CodeChunkType =
+  | 'imports'
+  | 'class'
+  | 'method'
+  | 'interface'
+  | 'enum'
+  | 'type'
+  | 'function'
+  | 'variable'
+  | 'generic'
+  | 'fallback';
+
+/**
+ * `DyNTS_DAI_CodeChunk` (BFR-AM-005) — egy szemantikus kód-chunk, amit a
+ * `DyNTS_DAI_CodeChunking_Util.chunkTs(...)` állít elő a TypeScript Compiler API AST-jából.
+ *
+ * A markdown-oldali `DyNTS_DAI_DocChunk`-kal párhuzamos, de kód-specifikus mezőkkel:
+ * a `symbolPath` (pl. `class:Foo > method:bar`) a kód-symbol-láncot, a `chunkType` a
+ * node-fajtát, a `lineStart/lineEnd` + `charStart/charEnd` a forrás-pozíciót hordozza.
+ *
+ * Tisztán a chunker kimeneti alakja (NEM DB data-model) — a consumer dönti el, hogyan
+ * mappeli a `DyNTS_DAI_DocChunk` perzisztencia-modellre (pl. `symbolPath` → `path`).
+ */
+export interface DyNTS_DAI_CodeChunk {
+  /** A chunk nyers szövege (a node forrás-tartománya, JSDoc + dekorátorokkal együtt). */
+  content: string;
+
+  /** A chunk szemantikus típusa (node-fajta). */
+  chunkType: DyNTS_DAI_CodeChunkType;
+
+  /**
+   * A kód-symbol-lánc, ` > ` szeparátorral összefűzve (a `chunkHeadParents`-mintára).
+   * Pl. `class:FooService > method:doThing`, `interface:Bar`, `function:helper`.
+   * Import-csoportra / generic-re üres string.
+   */
+  symbolPath: string;
+
+  /** A symbol-lánc szegmensei tömbként (pl. `['class:FooService', 'method:doThing']`). */
+  symbolSegments: string[];
+
+  /** A deklaráció neve (a legbelső symbol neve), ha van — pl. `doThing`, `FooService`. */
+  symbolName?: string;
+
+  /** 1-alapú kezdő sor a forrásban (inkluzív). */
+  lineStart: number;
+  /** 1-alapú záró sor a forrásban (inkluzív). */
+  lineEnd: number;
+
+  /** Karakter-kezdőpozíció a forrásban (0-alapú, inkluzív). */
+  charStart: number;
+  /** Karakter-végpozíció a forrásban (0-alapú, exkluzív). */
+  charEnd: number;
+
+  /** A chunk sorszáma a teljes kimenetben (0-alapú). */
+  chunkIndex: number;
+
+  /**
+   * Ha a chunk egy túl nagy node sliding-window sub-chunkja, akkor a sub-chunk
+   * 0-alapú indexe a szülő node-on belül; egyébként `undefined`.
+   */
+  subChunkIndex?: number;
+}

package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts

@@ -1,18 +1,18 @@
-
-
-import { DyNTS_DAI_CompareResult_Type } from '../../_enums/dai-compare-result-type.enum';
-import { DyNTS_DAI_DocChunk } from '../data-models/dai-doc-chunk.data-model';
-
-
-export interface DyNTS_DAI_DocChunkCompareResult<
-  T_Chunk extends DyNTS_DAI_DocChunk = DyNTS_DAI_DocChunk
-> {
-  result: DyNTS_DAI_CompareResult_Type;
-  newChunk: T_Chunk;
-  oldChunk?: T_Chunk;
-
-  reports?: string[];
-}
-
-
-
+
+
+import { DyNTS_DAI_CompareResult_Type } from '../../_enums/dai-compare-result-type.enum';
+import { DyNTS_DAI_DocChunk } from '../data-models/dai-doc-chunk.data-model';
+
+
+export interface DyNTS_DAI_DocChunkCompareResult<
+  T_Chunk extends DyNTS_DAI_DocChunk = DyNTS_DAI_DocChunk
+> {
+  result: DyNTS_DAI_CompareResult_Type;
+  newChunk: T_Chunk;
+  oldChunk?: T_Chunk;
+
+  reports?: string[];
+}
+
+
+

package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts

@@ -1,19 +1,19 @@
-import { DyNTS_DAI_DocChunk } from '../data-models/dai-doc-chunk.data-model';
-import { DyNTS_DAI_DocChunkCompareResult } from './dai-doc-chunk-compare-result.interface';
-import { DyNTS_DAI_CompareResult_Type } from '../../_enums/dai-compare-result-type.enum';
-import { DyNTS_DAI_DocPage } from '../data-models/dai-doc-page.data-model';
-
-export interface DyNTS_DAI_DocPageCompareResult<
-  T_Chunk extends DyNTS_DAI_DocChunk = DyNTS_DAI_DocChunk,
-  T_Page extends DyNTS_DAI_DocPage<T_Chunk> = DyNTS_DAI_DocPage<T_Chunk>, 
-> {
-  result: DyNTS_DAI_CompareResult_Type;
-  newPage: T_Page;
-  oldPage?: T_Page;
-  
-  /* newChunks: T_Chunk[];
-  oldChunks: T_Chunk[]; */
-  chunkCompareResults: DyNTS_DAI_DocChunkCompareResult<T_Chunk>[];
-
-  reports?: string[];
-}
+import { DyNTS_DAI_DocChunk } from '../data-models/dai-doc-chunk.data-model';
+import { DyNTS_DAI_DocChunkCompareResult } from './dai-doc-chunk-compare-result.interface';
+import { DyNTS_DAI_CompareResult_Type } from '../../_enums/dai-compare-result-type.enum';
+import { DyNTS_DAI_DocPage } from '../data-models/dai-doc-page.data-model';
+
+export interface DyNTS_DAI_DocPageCompareResult<
+  T_Chunk extends DyNTS_DAI_DocChunk = DyNTS_DAI_DocChunk,
+  T_Page extends DyNTS_DAI_DocPage<T_Chunk> = DyNTS_DAI_DocPage<T_Chunk>, 
+> {
+  result: DyNTS_DAI_CompareResult_Type;
+  newPage: T_Page;
+  oldPage?: T_Page;
+  
+  /* newChunks: T_Chunk[];
+  oldChunks: T_Chunk[]; */
+  chunkCompareResults: DyNTS_DAI_DocChunkCompareResult<T_Chunk>[];
+
+  reports?: string[];
+}

package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts

@@ -1,25 +1,25 @@
-import { DyNTS_DAI_DocChunk } from '../data-models/dai-doc-chunk.data-model';
-import { DyNTS_DAI_DocChunkCompareResult } from './dai-doc-chunk-compare-result.interface';
-import { DyNTS_DAI_CompareResult_Type } from '../../_enums/dai-compare-result-type.enum';
-import { DyNTS_DAI_DocPage } from '../data-models/dai-doc-page.data-model';
-import { DyNTS_DAI_Document } from '../data-models/dai-document.data-model';
-import { DyNTS_DAI_DocPageCompareResult } from './dai-doc-page-compare-result.interface';
-
-export interface DyNTS_DAI_DocumentCompareResult<
-  T_Chunk extends DyNTS_DAI_DocChunk = DyNTS_DAI_DocChunk,
-  T_Page extends DyNTS_DAI_DocPage<T_Chunk> = DyNTS_DAI_DocPage<T_Chunk>, 
-  T_ExternalDocumentId = string,
-  T_ExternalMetadata = any,
-  T_Document extends DyNTS_DAI_Document<T_Chunk, T_Page, T_ExternalDocumentId, T_ExternalMetadata> = 
-    DyNTS_DAI_Document<T_Chunk, T_Page, T_ExternalDocumentId, T_ExternalMetadata>,
-> {
-  result: DyNTS_DAI_CompareResult_Type;
-  newDocument: T_Document;
-  oldDocument?: T_Document;
-
-  /* newPages: T_Page[];
-  oldPages?: T_Page[]; */
-  pageCompareResults: DyNTS_DAI_DocPageCompareResult<T_Chunk, T_Page>[];
-
-  reports: string[];
-}
+import { DyNTS_DAI_DocChunk } from '../data-models/dai-doc-chunk.data-model';
+import { DyNTS_DAI_DocChunkCompareResult } from './dai-doc-chunk-compare-result.interface';
+import { DyNTS_DAI_CompareResult_Type } from '../../_enums/dai-compare-result-type.enum';
+import { DyNTS_DAI_DocPage } from '../data-models/dai-doc-page.data-model';
+import { DyNTS_DAI_Document } from '../data-models/dai-document.data-model';
+import { DyNTS_DAI_DocPageCompareResult } from './dai-doc-page-compare-result.interface';
+
+export interface DyNTS_DAI_DocumentCompareResult<
+  T_Chunk extends DyNTS_DAI_DocChunk = DyNTS_DAI_DocChunk,
+  T_Page extends DyNTS_DAI_DocPage<T_Chunk> = DyNTS_DAI_DocPage<T_Chunk>, 
+  T_ExternalDocumentId = string,
+  T_ExternalMetadata = any,
+  T_Document extends DyNTS_DAI_Document<T_Chunk, T_Page, T_ExternalDocumentId, T_ExternalMetadata> = 
+    DyNTS_DAI_Document<T_Chunk, T_Page, T_ExternalDocumentId, T_ExternalMetadata>,
+> {
+  result: DyNTS_DAI_CompareResult_Type;
+  newDocument: T_Document;
+  oldDocument?: T_Document;
+
+  /* newPages: T_Page[];
+  oldPages?: T_Page[]; */
+  pageCompareResults: DyNTS_DAI_DocPageCompareResult<T_Chunk, T_Page>[];
+
+  reports: string[];
+}

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

@@ -1,28 +1,30 @@
-// Re-export from FSM
-export * from '@futdevpro/fsm-dynamo/ai/document-ai';
-
-// COLLECTIONS
-export * from './_collections/dai-chunking.util';
-export * from './_collections/dai-document.util';
-
-// ENUMS
-//export * from './_enums/dai-validation-error.enum';
-export * from './_enums/dai-compare-result-type.enum';
-
-// MODELS
-// models/DATA-MODELS
-export * from './_models/data-models/dai-doc-chunk.data-model';
-export * from './_models/data-models/dai-document.data-model';
-export * from './_models/data-models/dai-doc-page.data-model';
-
-// models/INTERFACES
-export * from './_models/interfaces/dai-doc-chunk-compare-result.interface';
-export * from './_models/interfaces/dai-doc-page-compare-result.interface';
-export * from './_models/interfaces/dai-document-compare-result.interface';
-
-//export * from './_models/dai-embedding-info.interface';
-//export * from './_models/dai-embedding-validation.interface';
-
-// SERVICES
-//export * from './_services/dai-vector-data.service-base';
-/* export * from './_services/dai-doc-chunk.service-base'; */
+// Re-export from FSM
+export * from '@futdevpro/fsm-dynamo/ai/document-ai';
+
+// COLLECTIONS
+export * from './_collections/dai-chunking.util';
+export * from './_collections/dai-code-chunking.util';
+export * from './_collections/dai-document.util';
+
+// ENUMS
+//export * from './_enums/dai-validation-error.enum';
+export * from './_enums/dai-compare-result-type.enum';
+
+// MODELS
+// models/DATA-MODELS
+export * from './_models/data-models/dai-doc-chunk.data-model';
+export * from './_models/data-models/dai-document.data-model';
+export * from './_models/data-models/dai-doc-page.data-model';
+
+// models/INTERFACES
+export * from './_models/interfaces/dai-code-chunk.interface';
+export * from './_models/interfaces/dai-doc-chunk-compare-result.interface';
+export * from './_models/interfaces/dai-doc-page-compare-result.interface';
+export * from './_models/interfaces/dai-document-compare-result.interface';
+
+//export * from './_models/dai-embedding-info.interface';
+//export * from './_models/dai-embedding-validation.interface';
+
+// SERVICES
+//export * from './_services/dai-vector-data.service-base';
+/* export * from './_services/dai-doc-chunk.service-base'; */