@futdevpro/nts-dynamo 1.15.92 → 1.15.94

package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts

@@ -1,209 +1,209 @@
-
-import { DyNTS_DAI_Document_Util } from './dai-document.util';
-import { DyNTS_DAI_DocPage } from '../_models/data-models/dai-doc-page.data-model';
-import { DyFM_Log } from '@futdevpro/fsm-dynamo';
-
-describe('| DyNTS_DAI_Document_Util', () => {
-  describe('| getClickupPageLink', () => {
-    it('| should generate ClickUp page link', () => {
-      const result = DyNTS_DAI_Document_Util.getClickupPageLink(
-        'Test Page',
-        'workspace-123',
-        'doc-456',
-        'page-789'
-      );
-
-      expect(result).toContain('Test Page');
-      expect(result).toContain('https://app.clickup.com/workspace-123/v/dc/doc-456/page-789');
-      expect(result).toMatch(/\[Test Page\]\(https:\/\/app\.clickup\.com\/workspace-123\/v\/dc\/doc-456\/page-789\)/);
-    });
-  });
-
-  describe('| validateDocumentPage', () => {
-    it('| should return true for valid page', () => {
-      const page = new DyNTS_DAI_DocPage({
-        name: 'Test Page',
-        content: 'Test content',
-        documentId: 'doc-123',
-        _id: 'page-123',
-        parentedPath: [],
-        allFlaggedParents: [],
-        allFlaggedParentsMerged: '',
-        filePath: '',
-      });
-
-      const result = DyNTS_DAI_Document_Util.validateDocumentPage(page);
-
-      expect(result).toBe(true);
-    });
-
-    it('| should return false when name is missing', () => {
-      const logSpy = spyOn(DyFM_Log, 'error');
-      const page = new DyNTS_DAI_DocPage({
-        name: '',
-        content: 'Test content',
-        documentId: 'doc-123',
-        _id: 'page-123',
-        parentedPath: [],
-        allFlaggedParents: [],
-        allFlaggedParentsMerged: '',
-        filePath: '',
-      });
-
-      const result = DyNTS_DAI_Document_Util.validateDocumentPage(page);
-
-      expect(result).toBe(false);
-      expect(logSpy).toHaveBeenCalled();
-    });
-
-    it('| should return false when content is missing', () => {
-      const logSpy = spyOn(DyFM_Log, 'error');
-      const page = new DyNTS_DAI_DocPage({
-        name: 'Test Page',
-        content: '',
-        documentId: 'doc-123',
-        _id: 'page-123',
-        parentedPath: [],
-        allFlaggedParents: [],
-        allFlaggedParentsMerged: '',
-        filePath: '',
-      });
-
-      const result = DyNTS_DAI_Document_Util.validateDocumentPage(page);
-
-      expect(result).toBe(false);
-      expect(logSpy).toHaveBeenCalled();
-    });
-  });
-
-  describe('| normalizeContent', () => {
-    it('| should normalize line endings from CRLF to LF', () => {
-      const content = 'Line 1\r\nLine 2\r\nLine 3';
-      const result = DyNTS_DAI_Document_Util.normalizeContent(content);
-
-      expect(result).toBe('Line 1\nLine 2\nLine 3');
-    });
-
-    it('| should normalize line endings from CR to LF', () => {
-      const content = 'Line 1\rLine 2\rLine 3';
-      const result = DyNTS_DAI_Document_Util.normalizeContent(content);
-
-      expect(result).toBe('Line 1\nLine 2\nLine 3');
-    });
-
-    it('| should trim leading and trailing whitespace', () => {
-      const content = '  Line 1\nLine 2  ';
-      const result = DyNTS_DAI_Document_Util.normalizeContent(content);
-
-      expect(result).toBe('Line 1\nLine 2');
-    });
-
-    it('| should handle mixed line endings', () => {
-      const content = 'Line 1\r\nLine 2\rLine 3\nLine 4';
-      const result = DyNTS_DAI_Document_Util.normalizeContent(content);
-
-      expect(result).toBe('Line 1\nLine 2\nLine 3\nLine 4');
-    });
-  });
-
-  describe('| extractMetadata', () => {
-    it('| should extract title from first header', () => {
-      const content = '# Title\n\nContent here';
-      const result = DyNTS_DAI_Document_Util.extractMetadata(content);
-
-      expect(result.title).toBe('Title');
-    });
-
-    it('| should extract word count', () => {
-      const content = 'This is a test content with multiple words';
-      const result = DyNTS_DAI_Document_Util.extractMetadata(content);
-
-      // Content.split(/\s+/) returns 8 words: "This", "is", "a", "test", "content", "with", "multiple", "words"
-      expect(result.wordCount).toBe(8);
-    });
-
-    it('| should extract character count', () => {
-      const content = 'Test content';
-      const result = DyNTS_DAI_Document_Util.extractMetadata(content);
-
-      expect(result.characterCount).toBe(content.length);
-    });
-
-    it('| should extract header count', () => {
-      const content = '# Header 1\n## Header 2\n### Header 3';
-      const result = DyNTS_DAI_Document_Util.extractMetadata(content);
-
-      expect(result.headerCount).toBe(3);
-    });
-
-    it('| should return 0 header count when no headers', () => {
-      const content = 'Just plain text without headers';
-      const result = DyNTS_DAI_Document_Util.extractMetadata(content);
-
-      expect(result.headerCount).toBe(0);
-    });
-
-    it('| should extract all metadata fields', () => {
-      const content = '# Document Title\n\nThis is the content of the document.';
-      const result = DyNTS_DAI_Document_Util.extractMetadata(content);
-
-      expect(result.title).toBe('Document Title');
-      expect(result.wordCount).toBeGreaterThan(0);
-      expect(result.characterCount).toBeGreaterThan(0);
-      expect(result.headerCount).toBe(1);
-    });
-  });
-
-  describe('| isEmpty', () => {
-    it('| should return true for empty string', () => {
-      expect(DyNTS_DAI_Document_Util.isEmpty('')).toBe(true);
-    });
-
-    it('| should return true for whitespace only', () => {
-      expect(DyNTS_DAI_Document_Util.isEmpty('   \n\t  ')).toBe(true);
-    });
-
-    it('| should return false for content with text', () => {
-      expect(DyNTS_DAI_Document_Util.isEmpty('Some content')).toBe(false);
-    });
-
-    it('| should return true for null or undefined', () => {
-      expect(DyNTS_DAI_Document_Util.isEmpty(null as any)).toBe(true);
-      expect(DyNTS_DAI_Document_Util.isEmpty(undefined as any)).toBe(true);
-    });
-  });
-
-  describe('| getPreview', () => {
-    it('| should return full content when shorter than maxLength', () => {
-      const content = 'Short content';
-      const result = DyNTS_DAI_Document_Util.getPreview(content, 200);
-
-      expect(result).toBe('Short content');
-    });
-
-    it('| should truncate content when longer than maxLength', () => {
-      const content = 'A'.repeat(300);
-      const result = DyNTS_DAI_Document_Util.getPreview(content, 200);
-
-      expect(result.length).toBe(203); // 200 + '...'
-      expect(result.endsWith('...')).toBe(true);
-    });
-
-    it('| should use default maxLength of 200', () => {
-      const content = 'A'.repeat(250);
-      const result = DyNTS_DAI_Document_Util.getPreview(content);
-
-      expect(result.length).toBe(203); // 200 + '...'
-      expect(result.endsWith('...')).toBe(true);
-    });
-
-    it('| should handle exact maxLength', () => {
-      const content = 'A'.repeat(200);
-      const result = DyNTS_DAI_Document_Util.getPreview(content, 200);
-
-      expect(result).toBe(content);
-      expect(result.endsWith('...')).toBe(false);
-    });
-  });
-});
-
+
+import { DyNTS_DAI_Document_Util } from './dai-document.util';
+import { DyNTS_DAI_DocPage } from '../_models/data-models/dai-doc-page.data-model';
+import { DyFM_Log } from '@futdevpro/fsm-dynamo';
+
+describe('| DyNTS_DAI_Document_Util', () => {
+  describe('| getClickupPageLink', () => {
+    it('| should generate ClickUp page link', () => {
+      const result = DyNTS_DAI_Document_Util.getClickupPageLink(
+        'Test Page',
+        'workspace-123',
+        'doc-456',
+        'page-789'
+      );
+
+      expect(result).toContain('Test Page');
+      expect(result).toContain('https://app.clickup.com/workspace-123/v/dc/doc-456/page-789');
+      expect(result).toMatch(/\[Test Page\]\(https:\/\/app\.clickup\.com\/workspace-123\/v\/dc\/doc-456\/page-789\)/);
+    });
+  });
+
+  describe('| validateDocumentPage', () => {
+    it('| should return true for valid page', () => {
+      const page = new DyNTS_DAI_DocPage({
+        name: 'Test Page',
+        content: 'Test content',
+        documentId: 'doc-123',
+        _id: 'page-123',
+        parentedPath: [],
+        allFlaggedParents: [],
+        allFlaggedParentsMerged: '',
+        filePath: '',
+      });
+
+      const result = DyNTS_DAI_Document_Util.validateDocumentPage(page);
+
+      expect(result).toBe(true);
+    });
+
+    it('| should return false when name is missing', () => {
+      const logSpy = spyOn(DyFM_Log, 'error');
+      const page = new DyNTS_DAI_DocPage({
+        name: '',
+        content: 'Test content',
+        documentId: 'doc-123',
+        _id: 'page-123',
+        parentedPath: [],
+        allFlaggedParents: [],
+        allFlaggedParentsMerged: '',
+        filePath: '',
+      });
+
+      const result = DyNTS_DAI_Document_Util.validateDocumentPage(page);
+
+      expect(result).toBe(false);
+      expect(logSpy).toHaveBeenCalled();
+    });
+
+    it('| should return false when content is missing', () => {
+      const logSpy = spyOn(DyFM_Log, 'error');
+      const page = new DyNTS_DAI_DocPage({
+        name: 'Test Page',
+        content: '',
+        documentId: 'doc-123',
+        _id: 'page-123',
+        parentedPath: [],
+        allFlaggedParents: [],
+        allFlaggedParentsMerged: '',
+        filePath: '',
+      });
+
+      const result = DyNTS_DAI_Document_Util.validateDocumentPage(page);
+
+      expect(result).toBe(false);
+      expect(logSpy).toHaveBeenCalled();
+    });
+  });
+
+  describe('| normalizeContent', () => {
+    it('| should normalize line endings from CRLF to LF', () => {
+      const content = 'Line 1\r\nLine 2\r\nLine 3';
+      const result = DyNTS_DAI_Document_Util.normalizeContent(content);
+
+      expect(result).toBe('Line 1\nLine 2\nLine 3');
+    });
+
+    it('| should normalize line endings from CR to LF', () => {
+      const content = 'Line 1\rLine 2\rLine 3';
+      const result = DyNTS_DAI_Document_Util.normalizeContent(content);
+
+      expect(result).toBe('Line 1\nLine 2\nLine 3');
+    });
+
+    it('| should trim leading and trailing whitespace', () => {
+      const content = '  Line 1\nLine 2  ';
+      const result = DyNTS_DAI_Document_Util.normalizeContent(content);
+
+      expect(result).toBe('Line 1\nLine 2');
+    });
+
+    it('| should handle mixed line endings', () => {
+      const content = 'Line 1\r\nLine 2\rLine 3\nLine 4';
+      const result = DyNTS_DAI_Document_Util.normalizeContent(content);
+
+      expect(result).toBe('Line 1\nLine 2\nLine 3\nLine 4');
+    });
+  });
+
+  describe('| extractMetadata', () => {
+    it('| should extract title from first header', () => {
+      const content = '# Title\n\nContent here';
+      const result = DyNTS_DAI_Document_Util.extractMetadata(content);
+
+      expect(result.title).toBe('Title');
+    });
+
+    it('| should extract word count', () => {
+      const content = 'This is a test content with multiple words';
+      const result = DyNTS_DAI_Document_Util.extractMetadata(content);
+
+      // Content.split(/\s+/) returns 8 words: "This", "is", "a", "test", "content", "with", "multiple", "words"
+      expect(result.wordCount).toBe(8);
+    });
+
+    it('| should extract character count', () => {
+      const content = 'Test content';
+      const result = DyNTS_DAI_Document_Util.extractMetadata(content);
+
+      expect(result.characterCount).toBe(content.length);
+    });
+
+    it('| should extract header count', () => {
+      const content = '# Header 1\n## Header 2\n### Header 3';
+      const result = DyNTS_DAI_Document_Util.extractMetadata(content);
+
+      expect(result.headerCount).toBe(3);
+    });
+
+    it('| should return 0 header count when no headers', () => {
+      const content = 'Just plain text without headers';
+      const result = DyNTS_DAI_Document_Util.extractMetadata(content);
+
+      expect(result.headerCount).toBe(0);
+    });
+
+    it('| should extract all metadata fields', () => {
+      const content = '# Document Title\n\nThis is the content of the document.';
+      const result = DyNTS_DAI_Document_Util.extractMetadata(content);
+
+      expect(result.title).toBe('Document Title');
+      expect(result.wordCount).toBeGreaterThan(0);
+      expect(result.characterCount).toBeGreaterThan(0);
+      expect(result.headerCount).toBe(1);
+    });
+  });
+
+  describe('| isEmpty', () => {
+    it('| should return true for empty string', () => {
+      expect(DyNTS_DAI_Document_Util.isEmpty('')).toBe(true);
+    });
+
+    it('| should return true for whitespace only', () => {
+      expect(DyNTS_DAI_Document_Util.isEmpty('   \n\t  ')).toBe(true);
+    });
+
+    it('| should return false for content with text', () => {
+      expect(DyNTS_DAI_Document_Util.isEmpty('Some content')).toBe(false);
+    });
+
+    it('| should return true for null or undefined', () => {
+      expect(DyNTS_DAI_Document_Util.isEmpty(null as any)).toBe(true);
+      expect(DyNTS_DAI_Document_Util.isEmpty(undefined as any)).toBe(true);
+    });
+  });
+
+  describe('| getPreview', () => {
+    it('| should return full content when shorter than maxLength', () => {
+      const content = 'Short content';
+      const result = DyNTS_DAI_Document_Util.getPreview(content, 200);
+
+      expect(result).toBe('Short content');
+    });
+
+    it('| should truncate content when longer than maxLength', () => {
+      const content = 'A'.repeat(300);
+      const result = DyNTS_DAI_Document_Util.getPreview(content, 200);
+
+      expect(result.length).toBe(203); // 200 + '...'
+      expect(result.endsWith('...')).toBe(true);
+    });
+
+    it('| should use default maxLength of 200', () => {
+      const content = 'A'.repeat(250);
+      const result = DyNTS_DAI_Document_Util.getPreview(content);
+
+      expect(result.length).toBe(203); // 200 + '...'
+      expect(result.endsWith('...')).toBe(true);
+    });
+
+    it('| should handle exact maxLength', () => {
+      const content = 'A'.repeat(200);
+      const result = DyNTS_DAI_Document_Util.getPreview(content, 200);
+
+      expect(result).toBe(content);
+      expect(result.endsWith('...')).toBe(false);
+    });
+  });
+});
+

package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts

@@ -1,85 +1,85 @@
-import { DyFM_Log } from '@futdevpro/fsm-dynamo';
-import { DyNTS_DAI_DocPage } from '../_models/data-models/dai-doc-page.data-model';
-
-/**
- * Generic document utility functions
- * Provider-agnostic document operations
- */
-export class DyNTS_DAI_Document_Util {
-
-  static getClickupPageLink(pageName: string, workspaceId: string, documentId: string, pageId: string): string {
-         // https://app.clickup.com/9012753333/v/dc/8ck7cxn-692/8ck7cxn-1052
-    const link: string = `https://app.clickup.com/${workspaceId}/v/dc/${documentId}/${pageId}`;
-    return `[${pageName}](${link})`;
-  }
-  
-  /**
-   * Validate document page structure
-   */
-  static validateDocumentPage(page: DyNTS_DAI_DocPage): boolean {
-    if (!page.name) {
-      DyFM_Log.error('Document page validation failed: missing name');
-      return false;
-    }
-
-    if (!page.content) {
-      DyFM_Log.error('Document page validation failed: missing content');
-      return false;
-    }
-
-    return true;
-  }
-
-  /**
-   * Normalize document page content
-   */
-  static normalizeContent(content: string): string {
-    return content
-      .replace(/\r\n/g, '\n')  // Normalize line endings
-      .replace(/\r/g, '\n')    // Handle old Mac line endings
-      .trim();                 // Remove leading/trailing whitespace
-  }
-
-  /**
-   * Extract metadata from document content
-   */
-  static extractMetadata(content: string): Record<string, any> {
-    const metadata: Record<string, any> = {};
-    
-    // Extract title from first header
-    const titleMatch: RegExpMatchArray | null = content.match(/^#\s+(.+)$/m);
-    if (titleMatch) {
-      metadata.title = titleMatch[1].trim();
-    }
-
-    // Extract word count
-    metadata.wordCount = content.split(/\s+/).length;
-
-    // Extract character count
-    metadata.characterCount = content.length;
-
-    // Extract header count
-    const headerMatches = content.match(/^#{1,6}\s+.+$/gm);
-    metadata.headerCount = headerMatches ? headerMatches.length : 0;
-
-    return metadata;
-  }
-
-  /**
-   * Check if content is empty or whitespace only
-   */
-  static isEmpty(content: string): boolean {
-    return !content || content.trim().length === 0;
-  }
-
-  /**
-   * Get content preview (first N characters)
-   */
-  static getPreview(content: string, maxLength: number = 200): string {
-    if (content.length <= maxLength) {
-      return content;
-    }
-    
-    return content.substring(0, maxLength) + '...';
-  }
-}
+import { DyFM_Log } from '@futdevpro/fsm-dynamo';
+import { DyNTS_DAI_DocPage } from '../_models/data-models/dai-doc-page.data-model';
+
+/**
+ * Generic document utility functions
+ * Provider-agnostic document operations
+ */
+export class DyNTS_DAI_Document_Util {
+
+  static getClickupPageLink(pageName: string, workspaceId: string, documentId: string, pageId: string): string {
+         // https://app.clickup.com/9012753333/v/dc/8ck7cxn-692/8ck7cxn-1052
+    const link: string = `https://app.clickup.com/${workspaceId}/v/dc/${documentId}/${pageId}`;
+    return `[${pageName}](${link})`;
+  }
+  
+  /**
+   * Validate document page structure
+   */
+  static validateDocumentPage(page: DyNTS_DAI_DocPage): boolean {
+    if (!page.name) {
+      DyFM_Log.error('Document page validation failed: missing name');
+      return false;
+    }
+
+    if (!page.content) {
+      DyFM_Log.error('Document page validation failed: missing content');
+      return false;
+    }
+
+    return true;
+  }
+
+  /**
+   * Normalize document page content
+   */
+  static normalizeContent(content: string): string {
+    return content
+      .replace(/\r\n/g, '\n')  // Normalize line endings
+      .replace(/\r/g, '\n')    // Handle old Mac line endings
+      .trim();                 // Remove leading/trailing whitespace
+  }
+
+  /**
+   * Extract metadata from document content
+   */
+  static extractMetadata(content: string): Record<string, any> {
+    const metadata: Record<string, any> = {};
+    
+    // Extract title from first header
+    const titleMatch: RegExpMatchArray | null = content.match(/^#\s+(.+)$/m);
+    if (titleMatch) {
+      metadata.title = titleMatch[1].trim();
+    }
+
+    // Extract word count
+    metadata.wordCount = content.split(/\s+/).length;
+
+    // Extract character count
+    metadata.characterCount = content.length;
+
+    // Extract header count
+    const headerMatches = content.match(/^#{1,6}\s+.+$/gm);
+    metadata.headerCount = headerMatches ? headerMatches.length : 0;
+
+    return metadata;
+  }
+
+  /**
+   * Check if content is empty or whitespace only
+   */
+  static isEmpty(content: string): boolean {
+    return !content || content.trim().length === 0;
+  }
+
+  /**
+   * Get content preview (first N characters)
+   */
+  static getPreview(content: string, maxLength: number = 200): string {
+    if (content.length <= maxLength) {
+      return content;
+    }
+    
+    return content.substring(0, maxLength) + '...';
+  }
+}

package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts

@@ -1,8 +1,8 @@
-
-
-export enum DyNTS_DAI_CompareResult_Type {
-  equal = 'equal',
-  modified = 'modified',
-  new = 'new',
-  deleted = 'deleted',
+
+
+export enum DyNTS_DAI_CompareResult_Type {
+  equal = 'equal',
+  modified = 'modified',
+  new = 'new',
+  deleted = 'deleted',
 }