@futdevpro/fsm-dynamo 1.14.36 → 1.14.37

package/build/index.js

@@ -18,6 +18,7 @@ tslib_1.__exportStar(require("./_collections/utils/round-list.util"), exports);
 tslib_1.__exportStar(require("./_collections/utils/object.util"), exports);
 tslib_1.__exportStar(require("./_collections/utils/stack.util"), exports);
 tslib_1.__exportStar(require("./_collections/utils/string.util"), exports);
+tslib_1.__exportStar(require("./_collections/utils/string-case.util"), exports);
 tslib_1.__exportStar(require("./_collections/utils/time.util"), exports);
 tslib_1.__exportStar(require("./_collections/utils/type-cloning-facility.util"), exports);
 tslib_1.__exportStar(require("./_collections/utils/utilities.util"), exports);

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,cAAc;AACd,wBAAwB;AACxB,oFAA0D;AAC1D,wFAA8D;AAC9D,yFAA+D;AAC/D,iFAAuD;AACvD,+EAAqD;AAErD,oBAAoB;AACpB,0EAAgD;AAChD,0EAAgD;AAChD,yEAA+C;AAC/C,sFAA4D;AAC5D,wEAA8C;AAC9C,+EAAqD;AACrD,2EAAiD;AACjD,0EAAgD;AAChD,2EAAiD;AACjD,yEAA+C;AAC/C,0FAAgE;AAChE,8EAAoD;AACpD,yEAA+C;AAE/C,yBAAyB;AACzB,oFAA0D;AAC1D,8EAAoD;AACpD,gFAAsD;AACtD,sFAA4D;AAC5D,iFAAuD;AAEvD,2BAA2B;AAC3B,yFAA+D;AAC/D,gFAAsD;AACtD,yFAA+D;AAG/D,QAAQ;AACR,4EAAkD;AAClD,wEAA8C;AAC9C,yEAA+C;AAC/C,oEAA0C;AAC1C,kEAAwC;AACxC,iFAAuD;AAEvD,aAAa;AACb,4EAAkD;AAClD,6EAAmD;AACnD,gFAAsD;AAEtD,aAAa;AACb,yEAA+C;AAC/C,mEAAyC;AACzC,2EAAiD;AAGjD,SAAS;AACT,wBAAwB;AACxB,mGAAyE;AACzE,sGAA4E;AAC5E,uFAA6D;AAC7D,sFAA4D;AAC5D,6FAAmE;AACnE,+FAAqE;AACrE,gHAAsF;AAEtF,6BAA6B;AAC7B,0GAAgF;AAChF,mGAAyE;AACzE,iGAAuE;AAEvE,qBAAqB;AACrB,kFAAwD;AACxD,oFAA0D;AAE1D,oBAAoB;AACpB,oFAA0D;AAC1D,wFAA8D;AAC9D,+EAAqD;AACrD,uFAA6D;AAC7D,wFAA8D;AAC9D,sFAA4D;AAC5D,uFAA6D;AAC7D,iGAAuE;AACvE,iFAAuD;AAEvD,gCAAgC;AAChC,yGAA+E;AAC/E,qGAA2E;AAE3E,eAAe;AACf,yEAA+C;AAC/C,uEAA6C;AAC7C,yEAA+C;AAC/C,uEAA6C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,cAAc;AACd,wBAAwB;AACxB,oFAA0D;AAC1D,wFAA8D;AAC9D,yFAA+D;AAC/D,iFAAuD;AACvD,+EAAqD;AAErD,oBAAoB;AACpB,0EAAgD;AAChD,0EAAgD;AAChD,yEAA+C;AAC/C,sFAA4D;AAC5D,wEAA8C;AAC9C,+EAAqD;AACrD,2EAAiD;AACjD,0EAAgD;AAChD,2EAAiD;AACjD,gFAAsD;AACtD,yEAA+C;AAC/C,0FAAgE;AAChE,8EAAoD;AACpD,yEAA+C;AAE/C,yBAAyB;AACzB,oFAA0D;AAC1D,8EAAoD;AACpD,gFAAsD;AACtD,sFAA4D;AAC5D,iFAAuD;AAEvD,2BAA2B;AAC3B,yFAA+D;AAC/D,gFAAsD;AACtD,yFAA+D;AAG/D,QAAQ;AACR,4EAAkD;AAClD,wEAA8C;AAC9C,yEAA+C;AAC/C,oEAA0C;AAC1C,kEAAwC;AACxC,iFAAuD;AAEvD,aAAa;AACb,4EAAkD;AAClD,6EAAmD;AACnD,gFAAsD;AAEtD,aAAa;AACb,yEAA+C;AAC/C,mEAAyC;AACzC,2EAAiD;AAGjD,SAAS;AACT,wBAAwB;AACxB,mGAAyE;AACzE,sGAA4E;AAC5E,uFAA6D;AAC7D,sFAA4D;AAC5D,6FAAmE;AACnE,+FAAqE;AACrE,gHAAsF;AAEtF,6BAA6B;AAC7B,0GAAgF;AAChF,mGAAyE;AACzE,iGAAuE;AAEvE,qBAAqB;AACrB,kFAAwD;AACxD,oFAA0D;AAE1D,oBAAoB;AACpB,oFAA0D;AAC1D,wFAA8D;AAC9D,+EAAqD;AACrD,uFAA6D;AAC7D,wFAA8D;AAC9D,sFAA4D;AAC5D,uFAA6D;AAC7D,iGAAuE;AACvE,iFAAuD;AAEvD,gCAAgC;AAChC,yGAA+E;AAC/E,qGAA2E;AAE3E,eAAe;AACf,yEAA+C;AAC/C,uEAA6C;AAC7C,yEAA+C;AAC/C,uEAA6C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/fsm-dynamo",
-  "version": "01.14.36",
+  "version": "01.14.37",
   "description": "Full Stack Model Collection for Dynamic (NodeJS-Typescript) Framework called Dynamo, by Future Development Ltd.",
   "DyBu_settings": {
     "packageType": "full-stack-package",
@@ -211,7 +211,7 @@
     "uuid": "11.1.0"
   },
   "devDependencies": {
-    "@futdevpro/dynamo-eslint": "1.14.31",
+    "@futdevpro/dynamo-eslint": "1.14.32",
     "@types/jasmine": "~4.3.5",
     "@typescript-eslint/eslint-plugin": "^8.41.0",
     "@typescript-eslint/parser": "^8.41.0",

package/src/_collections/utils/string-case.util.spec.ts

@@ -0,0 +1,441 @@
+import { DyFM_StringCase, DyFM_StringCase_Type } from './string-case.util';
+
+describe('DyFM_StringCase', () => {
+  describe('| parseWords', () => {
+    it('| should parse camelCase to words', () => {
+      const result = DyFM_StringCase.parseWords('stockItemId');
+      expect(result).toEqual(['stock', 'item', 'id']);
+    });
+
+    it('| should parse PascalCase to words', () => {
+      const result = DyFM_StringCase.parseWords('StockItemId');
+      expect(result).toEqual(['stock', 'item', 'id']);
+    });
+
+    it('| should parse kebab-case to words', () => {
+      const result = DyFM_StringCase.parseWords('stock-item-id');
+      expect(result).toEqual(['stock', 'item', 'id']);
+    });
+
+    it('| should parse snake_case to words', () => {
+      const result = DyFM_StringCase.parseWords('stock_item_id');
+      expect(result).toEqual(['stock', 'item', 'id']);
+    });
+
+    it('| should parse space-separated to words', () => {
+      const result = DyFM_StringCase.parseWords('stock item id');
+      expect(result).toEqual(['stock', 'item', 'id']);
+    });
+
+    it('| should handle mixed separators', () => {
+      const result = DyFM_StringCase.parseWords('stock_item-id itemId');
+      expect(result).toEqual(['stock', 'item', 'id', 'item', 'id']);
+    });
+
+    it('| should handle acronyms', () => {
+      const result = DyFM_StringCase.parseWords('XMLParser');
+      expect(result).toEqual(['xml', 'parser']);
+    });
+
+    it('| should handle empty string', () => {
+      const result = DyFM_StringCase.parseWords('');
+      expect(result).toEqual([]);
+    });
+  });
+
+  describe('| toCamelCase', () => {
+    it('| should convert kebab-case to camelCase', () => {
+      const result = DyFM_StringCase.toCamelCase('stock-item-id');
+      expect(result).toBe('stockItemId');
+    });
+
+    it('| should convert snake_case to camelCase', () => {
+      const result = DyFM_StringCase.toCamelCase('stock_item_id');
+      expect(result).toBe('stockItemId');
+    });
+
+    it('| should convert PascalCase to camelCase', () => {
+      const result = DyFM_StringCase.toCamelCase('StockItemId');
+      expect(result).toBe('stockItemId');
+    });
+
+    it('| should keep camelCase as camelCase', () => {
+      const result = DyFM_StringCase.toCamelCase('stockItemId');
+      expect(result).toBe('stockItemId');
+    });
+
+    it('| should convert space-separated to camelCase', () => {
+      const result = DyFM_StringCase.toCamelCase('stock item id');
+      expect(result).toBe('stockItemId');
+    });
+
+    it('| should handle single word', () => {
+      const result = DyFM_StringCase.toCamelCase('stock');
+      expect(result).toBe('stock');
+    });
+
+    it('| should handle empty string', () => {
+      const result = DyFM_StringCase.toCamelCase('');
+      expect(result).toBe('');
+    });
+  });
+
+  describe('| toPascalCase', () => {
+    it('| should convert kebab-case to PascalCase', () => {
+      const result = DyFM_StringCase.toPascalCase('stock-item-id');
+      expect(result).toBe('StockItemId');
+    });
+
+    it('| should convert snake_case to PascalCase', () => {
+      const result = DyFM_StringCase.toPascalCase('stock_item_id');
+      expect(result).toBe('StockItemId');
+    });
+
+    it('| should convert camelCase to PascalCase', () => {
+      const result = DyFM_StringCase.toPascalCase('stockItemId');
+      expect(result).toBe('StockItemId');
+    });
+
+    it('| should keep PascalCase as PascalCase', () => {
+      const result = DyFM_StringCase.toPascalCase('StockItemId');
+      expect(result).toBe('StockItemId');
+    });
+
+    it('| should convert space-separated to PascalCase', () => {
+      const result = DyFM_StringCase.toPascalCase('stock item id');
+      expect(result).toBe('StockItemId');
+    });
+
+    it('| should handle single word', () => {
+      const result = DyFM_StringCase.toPascalCase('stock');
+      expect(result).toBe('Stock');
+    });
+
+    it('| should handle empty string', () => {
+      const result = DyFM_StringCase.toPascalCase('');
+      expect(result).toBe('');
+    });
+  });
+
+  describe('| toKebabCase', () => {
+    it('| should convert camelCase to kebab-case', () => {
+      const result = DyFM_StringCase.toKebabCase('stockItemId');
+      expect(result).toBe('stock-item-id');
+    });
+
+    it('| should convert PascalCase to kebab-case', () => {
+      const result = DyFM_StringCase.toKebabCase('StockItemId');
+      expect(result).toBe('stock-item-id');
+    });
+
+    it('| should convert snake_case to kebab-case', () => {
+      const result = DyFM_StringCase.toKebabCase('stock_item_id');
+      expect(result).toBe('stock-item-id');
+    });
+
+    it('| should keep kebab-case as kebab-case', () => {
+      const result = DyFM_StringCase.toKebabCase('stock-item-id');
+      expect(result).toBe('stock-item-id');
+    });
+
+    it('| should convert space-separated to kebab-case', () => {
+      const result = DyFM_StringCase.toKebabCase('stock item id');
+      expect(result).toBe('stock-item-id');
+    });
+
+    it('| should handle single word', () => {
+      const result = DyFM_StringCase.toKebabCase('stock');
+      expect(result).toBe('stock');
+    });
+
+    it('| should handle empty string', () => {
+      const result = DyFM_StringCase.toKebabCase('');
+      expect(result).toBe('');
+    });
+  });
+
+  describe('| toSnakeCase', () => {
+    it('| should convert camelCase to snake_case', () => {
+      const result = DyFM_StringCase.toSnakeCase('stockItemId');
+      expect(result).toBe('stock_item_id');
+    });
+
+    it('| should convert PascalCase to snake_case', () => {
+      const result = DyFM_StringCase.toSnakeCase('StockItemId');
+      expect(result).toBe('stock_item_id');
+    });
+
+    it('| should convert kebab-case to snake_case', () => {
+      const result = DyFM_StringCase.toSnakeCase('stock-item-id');
+      expect(result).toBe('stock_item_id');
+    });
+
+    it('| should keep snake_case as snake_case', () => {
+      const result = DyFM_StringCase.toSnakeCase('stock_item_id');
+      expect(result).toBe('stock_item_id');
+    });
+
+    it('| should convert space-separated to snake_case', () => {
+      const result = DyFM_StringCase.toSnakeCase('stock item id');
+      expect(result).toBe('stock_item_id');
+    });
+
+    it('| should handle single word', () => {
+      const result = DyFM_StringCase.toSnakeCase('stock');
+      expect(result).toBe('stock');
+    });
+
+    it('| should handle empty string', () => {
+      const result = DyFM_StringCase.toSnakeCase('');
+      expect(result).toBe('');
+    });
+  });
+
+  describe('| convertTo', () => {
+    it('| should convert to camelCase using enum', () => {
+      const result = DyFM_StringCase.convertTo('stock-item-id', DyFM_StringCase_Type.camelCase);
+      expect(result).toBe('stockItemId');
+    });
+
+    it('| should convert to PascalCase using enum', () => {
+      const result = DyFM_StringCase.convertTo('stock-item-id', DyFM_StringCase_Type.PascalCase);
+      expect(result).toBe('StockItemId');
+    });
+
+    it('| should convert to kebab-case using enum', () => {
+      const result = DyFM_StringCase.convertTo('stockItemId', DyFM_StringCase_Type.kebabCase);
+      expect(result).toBe('stock-item-id');
+    });
+
+    it('| should convert to snake_case using enum', () => {
+      const result = DyFM_StringCase.convertTo('stockItemId', DyFM_StringCase_Type.snake_case);
+      expect(result).toBe('stock_item_id');
+    });
+  });
+
+  describe('| convertToAny', () => {
+    it('| should convert to camelCase using string', () => {
+      const result = DyFM_StringCase.convertToAny('stock-item-id', 'camelCase');
+      expect(result).toBe('stockItemId');
+    });
+
+    it('| should convert to PascalCase using string', () => {
+      const result = DyFM_StringCase.convertToAny('stock-item-id', 'PascalCase');
+      expect(result).toBe('StockItemId');
+    });
+
+    it('| should convert to kebab-case using string', () => {
+      const result = DyFM_StringCase.convertToAny('stockItemId', 'kebab-case');
+      expect(result).toBe('stock-item-id');
+    });
+
+    it('| should convert to snake_case using string', () => {
+      const result = DyFM_StringCase.convertToAny('stockItemId', 'snake_case');
+      expect(result).toBe('stock_item_id');
+    });
+
+    it('| should handle case-insensitive string input', () => {
+      const result = DyFM_StringCase.convertToAny('stockItemId', 'KEBAB-CASE');
+      expect(result).toBe('stock-item-id');
+    });
+
+    it('| should return original string for unknown case type', () => {
+      const result = DyFM_StringCase.convertToAny('stockItemId', 'unknown');
+      expect(result).toBe('stockItemId');
+    });
+  });
+
+  describe('| includesIgnoreCase', () => {
+    it('| should find camelCase in path with kebab-case', () => {
+      const result = DyFM_StringCase.includesIgnoreCase('/:userId/item/delete/:itemId', 'stockItemId');
+      expect(result).toBe(true);
+    });
+
+    it('| should find kebab-case in path with camelCase', () => {
+      const result = DyFM_StringCase.includesIgnoreCase('/:userId/item/delete/:itemId', 'stock-item-id');
+      expect(result).toBe(true);
+    });
+
+    it('| should find snake_case in path', () => {
+      const result = DyFM_StringCase.includesIgnoreCase('/:userId/item/delete/:itemId', 'stock_item_id');
+      expect(result).toBe(true);
+    });
+
+    it('| should find exact match', () => {
+      const result = DyFM_StringCase.includesIgnoreCase('/:userId/item/delete/:itemId', 'itemId');
+      expect(result).toBe(true);
+    });
+
+    it('| should not find non-existent string', () => {
+      const result = DyFM_StringCase.includesIgnoreCase('/:userId/item/delete/:itemId', 'nonExistent');
+      expect(result).toBe(false);
+    });
+
+    it('| should handle empty strings', () => {
+      const result = DyFM_StringCase.includesIgnoreCase('', 'itemId');
+      expect(result).toBe(false);
+    });
+  });
+
+  describe('| anyNameToShortCode', () => {
+    it('| should convert space-separated name to short code', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('John Doe');
+      expect(result).toBe('JD');
+    });
+
+    it('| should convert camelCase name to short code', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('JohnDoe');
+      expect(result).toBe('JD');
+    });
+
+    it('| should convert underscore-separated name to short code', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('John_Doe');
+      expect(result).toBe('JD');
+    });
+
+    it('| should convert camelCase starting with lowercase to short code', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('johnDoe');
+      expect(result).toBe('JD');
+    });
+
+    it('| should convert lowercase underscore-separated name to short code', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('john_doe');
+      expect(result).toBe('JD');
+    });
+
+    it('| should convert hyphen-separated name to short code', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('john-doe');
+      expect(result).toBe('JD');
+    });
+
+    it('| should handle single word name', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('John');
+      expect(result).toBe('J');
+    });
+
+    it('| should handle single lowercase word', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('john');
+      expect(result).toBe('J');
+    });
+
+    it('| should handle three words', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('John Michael Doe');
+      expect(result).toBe('JMD');
+    });
+
+    it('| should handle mixed separators', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('John_Michael-Doe');
+      expect(result).toBe('JMD');
+    });
+
+    it('| should handle camelCase with multiple words', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('JohnMichaelDoe');
+      expect(result).toBe('JMD');
+    });
+
+    it('| should handle mixed camelCase and separators', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('JohnMichael_Doe');
+      expect(result).toBe('JMD');
+    });
+
+    it('| should handle name with multiple spaces', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('John   Doe');
+      expect(result).toBe('JD');
+    });
+
+    it('| should handle name with multiple underscores', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('John___Doe');
+      expect(result).toBe('JD');
+    });
+
+    it('| should handle name with multiple hyphens', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('John---Doe');
+      expect(result).toBe('JD');
+    });
+
+    it('| should handle name with mixed separators and spaces', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('John _- Doe');
+      expect(result).toBe('JD');
+    });
+
+    it('| should handle empty string', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('');
+      expect(result).toBe('');
+    });
+
+    it('| should handle string with only spaces', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('   ');
+      expect(result).toBe('');
+    });
+
+    it('| should handle string with only separators', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('___---');
+      expect(result).toBe('');
+    });
+
+    it('| should handle name with leading and trailing spaces', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('  John Doe  ');
+      expect(result).toBe('JD');
+    });
+
+    it('| should handle name with leading and trailing separators', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('_John_Doe_');
+      expect(result).toBe('JD');
+    });
+
+    it('| should handle all uppercase name', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('JOHN DOE');
+      expect(result).toBe('JD');
+    });
+
+    it('| should handle all uppercase camelCase', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('JOHNDOE');
+      expect(result).toBe('J');
+    });
+
+    it('| should handle name with numbers', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('John2 Doe3');
+      expect(result).toBe('JD');
+    });
+
+    it('| should handle name starting with number', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('2John Doe');
+      expect(result).toBe('JD');
+    });
+
+    it('| should handle complex camelCase with numbers', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('john2Doe3Smith');
+      expect(result).toBe('JDS');
+    });
+
+    it('| should handle single character', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('J');
+      expect(result).toBe('J');
+    });
+
+    it('| should handle name with special characters', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('John@Doe#Smith');
+      expect(result).toBe('JDS');
+    });
+
+    it('| should handle very long camelCase name', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('ThisIsAVeryLongCamelCaseName');
+      expect(result).toBe('TIAVLCCN');
+    });
+
+    it('| should handle name with consecutive uppercase letters', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('XMLParser');
+      expect(result).toBe('XP');
+    });
+
+    it('| should handle name with acronym at start', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('HTMLDocument');
+      expect(result).toBe('HD');
+    });
+
+    it('| should handle name with acronym in middle', () => {
+      const result = DyFM_StringCase.anyNameToShortCode('MyHTMLParser');
+      expect(result).toBe('MHP');
+    });
+  });
+});