dff-util 1.2.9 → 1.3.1

package/README.md

@@ -575,6 +575,50 @@ const main = async () => {
 
 main();
 
+---------------------------------------------------
+
+// Base64
+const text = "Hello World!";
+const encodedBase64 = encodeBase64(text); // "SGVsbG8gV29ybGQh"
+const decodedBase64 = decodeBase64(encodedBase64); // "Hello World!"
+
+console.log(encodedBase64, decodedBase64);
+
+// URL Encode/Decode
+const url = "https://example.com/query?name=John Doe&city=New York";
+
+// First encode
+const encodedURL1 = encodeURL(url);
+console.log(encodedURL1);
+// Output: "https%3A%2F%2Fexample.com%2Fquery%3Fname%3DJohn%20Doe%26city%3DNew%20York"
+
+// Encode again (idempotent)
+const encodedURL2 = encodeURL(encodedURL1);
+console.log(encodedURL2 === encodedURL1); // true ✅
+
+// Decode
+const decodedURL1 = decodeURL(encodedURL1);
+console.log(decodedURL1); // "https://example.com/query?name=John Doe&city=New York"
+
+// Decode again (idempotent)
+const decodedURL2 = decodeURL(decodedURL1);
+console.log(decodedURL2 === decodedURL1); // true ✅
+
+const original = "Hello World! @#$% 😊";
+
+// Encode
+const safe = safeEncode(original);
+console.log(safe); 
+// Output: "U0dWc2JHOGdWMjl5YkdRPQ%3D%3D"
+
+// Decode
+const decoded = safeDecode(safe);
+console.log(decoded); 
+// Output: "Hello World! @#$% 😊"
+
+// Multiple encode/decode calls (idempotent)
+console.log(safeEncode(safeDecode(safe)) === safe); // true
+
 
 
 ```

package/dist/main/case-mapper.d.ts

@@ -4,5 +4,5 @@ export declare function toPascalCase(str: string): string;
 export declare function toUpperCase(str: string): string;
 export declare function toLowerCase(str: string): string;
 export declare function toViewMapper(obj: any): any;
-export declare function toEntityMapper(obj: any): any;
+export declare function toEntityMapper<T = any>(obj: T): any;
 export declare function toSchemaMapper(obj: any): any;

package/dist/main/case-mapper.js

@@ -8,6 +8,7 @@ exports.toLowerCase = toLowerCase;
 exports.toViewMapper = toViewMapper;
 exports.toEntityMapper = toEntityMapper;
 exports.toSchemaMapper = toSchemaMapper;
+const const_value_1 = require("./const-value");
 function toCamelCase(str) {
     return str
         .replace(/[_\s-]+(.)?/g, (_, chr) => (chr ? chr.toUpperCase() : ''))
@@ -45,11 +46,23 @@ function toLowerCase(str) {
 function isPlainObject(obj) {
     return Object.prototype.toString.call(obj) === '[object Object]';
 }
+const LANGUAGE_CODE_SET = new Set(const_value_1.AllLanguageCodes);
+function isLanguageMap(value) {
+    if (!isPlainObject(value))
+        return false;
+    const keys = Object.keys(value);
+    if (keys.length === 0)
+        return false;
+    return keys.every((k) => LANGUAGE_CODE_SET.has(k));
+}
 function toViewMapper(obj) {
     if (Array.isArray(obj)) {
         return obj.map(toViewMapper);
     }
-    else if (isPlainObject(obj)) {
+    if (isLanguageMap(obj)) {
+        return obj;
+    }
+    if (isPlainObject(obj)) {
         return Object.fromEntries(Object.entries(obj).map(([key, value]) => [
             toCamelCase(key === '_id' ? 'id' : key),
             toViewMapper(value),
@@ -59,21 +72,27 @@ function toViewMapper(obj) {
 }
 function toEntityMapper(obj) {
     if (Array.isArray(obj)) {
-        return obj.map(toEntityMapper);
+        return obj.map((v) => toEntityMapper(v));
     }
-    else if (isPlainObject(obj)) {
-        return Object.fromEntries(Object.entries(obj).map(([key, value]) => [
-            toSnakeCase(key),
-            toEntityMapper(value),
-        ]));
+    if (isLanguageMap(obj)) {
+        return obj; // preserve language codes exactly
     }
-    return obj; // Date, Buffer, Map, etc. returned as-is
+    if (isPlainObject(obj)) {
+        return Object.fromEntries(Object.entries(obj).map(([key, value]) => {
+            const mappedKey = toSnakeCase(key);
+            return [mappedKey, toEntityMapper(value)];
+        }));
+    }
+    return obj; // primitives, Date, Buffer, etc.
 }
 function toSchemaMapper(obj) {
     if (Array.isArray(obj)) {
         return obj.map(toEntityMapper);
     }
-    else if (isPlainObject(obj)) {
+    if (isLanguageMap(obj)) {
+        return obj; // do not transform language code keys
+    }
+    if (isPlainObject(obj)) {
         return Object.fromEntries(Object.entries(obj).map(([key, value]) => [
             toSnakeCase(key === 'id' ? '_id' : key),
             toEntityMapper(value),

package/dist/main/const-value.d.ts

@@ -43,3 +43,4 @@ export declare const ConstValue: {
     DARK: string;
     MonthNames: string[];
 };
+export declare const AllLanguageCodes: string[];

package/dist/main/const-value.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConstValue = void 0;
+exports.AllLanguageCodes = exports.ConstValue = void 0;
 exports.ConstValue = {
     // Logical operators
     AND: '&&',
@@ -63,3 +63,213 @@ exports.ConstValue = {
         "Dec",
     ],
 };
+exports.AllLanguageCodes = [
+    "ps-AF",
+    "sq-AL",
+    "ar-DZ",
+    "ca-AD",
+    "pt-AO",
+    "en-AG",
+    "es-AR",
+    "hy-AM",
+    "en-AU",
+    "de-AT",
+    "az-AZ",
+    "en-BS",
+    "ar-BH",
+    "bn-BD",
+    "en-BB",
+    "be-BY",
+    "nl-BE",
+    "en-BZ",
+    "fr-BJ",
+    "dz-BT",
+    "es-BO",
+    "bs-BA",
+    "en-BW",
+    "pt-BR",
+    "ms-BN",
+    "bg-BG",
+    "fr-BF",
+    "rn-BI",
+    "pt-CV",
+    "km-KH",
+    "fr-CM",
+    "en-CA",
+    "fr-CF",
+    "fr-TD",
+    "es-CL",
+    "zh-CN",
+    "es-CO",
+    "ar-KM",
+    "fr-CG",
+    "fr-CD",
+    "es-CR",
+    "fr-CI",
+    "hr-HR",
+    "es-CU",
+    "el-CY",
+    "cs-CZ",
+    "da-DK",
+    "fr-DJ",
+    "en-DM",
+    "es-DO",
+    "es-EC",
+    "ar-EG",
+    "es-SV",
+    "es-GQ",
+    "ti-ER",
+    "et-EE",
+    "si-SZ",
+    "am-ET",
+    "en-FJ",
+    "fi-FI",
+    "fr-FR",
+    "fr-GA",
+    "en-GM",
+    "ka-GE",
+    "de-DE",
+    "en-GH",
+    "el-GR",
+    "en-GD",
+    "es-GT",
+    "fr-GN",
+    "pt-GW",
+    "en-GY",
+    "fr-HT",
+    "es-HN",
+    "hu-HU",
+    "is-IS",
+    "hi-IN",
+    "kn-IN",
+    "ta-IN",
+    "te-IN",
+    "bn-IN",
+    "mr-IN",
+    "gu-IN",
+    "ml-IN",
+    "pa-IN",
+    "or-IN",
+    "as-IN",
+    "id-ID",
+    "fa-IR",
+    "ar-IQ",
+    "ga-IE",
+    "he-IL",
+    "it-IT",
+    "en-JM",
+    "ja-JP",
+    "ar-JO",
+    "kk-KZ",
+    "sw-KE",
+    "en-KI",
+    "ko-KP",
+    "ko-KR",
+    "ar-KW",
+    "ky-KG",
+    "lo-LA",
+    "lv-LV",
+    "ar-LB",
+    "st-LS",
+    "en-LR",
+    "ar-LY",
+    "de-LI",
+    "lt-LT",
+    "fr-LU",
+    "mg-MG",
+    "ny-MW",
+    "ms-MY",
+    "dv-MV",
+    "fr-ML",
+    "mt-MT",
+    "en-MH",
+    "ar-MR",
+    "en-MU",
+    "es-MX",
+    "en-FM",
+    "ro-MD",
+    "fr-MC",
+    "mn-MN",
+    "sr-ME",
+    "ar-MA",
+    "pt-MZ",
+    "my-MM",
+    "en-NA",
+    "en-NR",
+    "ne-NP",
+    "nl-NL",
+    "en-NZ",
+    "es-NI",
+    "fr-NE",
+    "en-NG",
+    "yo-NG",
+    "ha-NG",
+    "ig-NG",
+    "en-NU",
+    "nb-NO",
+    "ar-OM",
+    "ur-PK",
+    "en-PW",
+    "ar-PS",
+    "es-PA",
+    "en-PG",
+    "es-PY",
+    "es-PE",
+    "tl-PH",
+    "pl-PL",
+    "pt-PT",
+    "ar-QA",
+    "ro-RO",
+    "ru-RU",
+    "rw-RW",
+    "en-KN",
+    "en-LC",
+    "en-VC",
+    "sm-WS",
+    "it-SM",
+    "pt-ST",
+    "ar-SA",
+    "fr-SN",
+    "sr-RS",
+    "en-SC",
+    "en-SL",
+    "en-SG",
+    "sk-SK",
+    "sl-SI",
+    "en-SB",
+    "so-SO",
+    "af-ZA",
+    "en-SS",
+    "es-ES",
+    "si-LK",
+    "ar-SD",
+    "nl-SR",
+    "sv-SE",
+    "de-CH",
+    "ar-SY",
+    "tg-TJ",
+    "sw-TZ",
+    "th-TH",
+    "pt-TL",
+    "fr-TG",
+    "to-TO",
+    "en-TT",
+    "ar-TN",
+    "tr-TR",
+    "tk-TM",
+    "en-TV",
+    "en-UG",
+    "uk-UA",
+    "ar-AE",
+    "en-GB",
+    "en-US",
+    "es-UY",
+    "uz-UZ",
+    "bi-VU",
+    "it-VA",
+    "es-VE",
+    "vi-VN",
+    "ar-YE",
+    "en-ZM",
+    "en-ZW",
+];

package/dist/main/util.d.ts

@@ -14,3 +14,9 @@ export declare const TimeAgo: (date: Date) => string;
 export declare const LangText: (data: string, source: string, target: string) => Promise<any>;
 export declare const LangCountryCode: (lang: string) => LangCountryType;
 export declare const CurrencyConvert: (from: string, to: string) => Promise<number>;
+export declare function EncodeBase64(input: string): string;
+export declare function DecodeBase64(encoded: string): string;
+export declare function EncodeURL(input: string): string;
+export declare function DecodeURL(input: string): string;
+export declare function SafeEncode(input: string): string;
+export declare function SafeDecode(encoded: string): string;

package/dist/main/util.js

@@ -10,6 +10,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CurrencyConvert = exports.LangCountryCode = exports.LangText = exports.TimeAgo = exports.DateAndTime = exports.DateTime12HrFormat = exports.DateTime24HrFormat = exports.TruncateText = exports.AppUUID4 = exports.AppAddDays = exports.AppDaysBack = exports.AppCode = exports.AppCodeByType = exports.AppUniqueCode = exports.AppRandomString = void 0;
+exports.EncodeBase64 = EncodeBase64;
+exports.DecodeBase64 = DecodeBase64;
+exports.EncodeURL = EncodeURL;
+exports.DecodeURL = DecodeURL;
+exports.SafeEncode = SafeEncode;
+exports.SafeDecode = SafeDecode;
 const randomstring_1 = require("randomstring");
 const reg_exr_1 = require("./reg-exr");
 const countries_1 = require("./countries");
@@ -216,3 +222,32 @@ const CurrencyConvert = (from, to) => __awaiter(void 0, void 0, void 0, function
     }
 });
 exports.CurrencyConvert = CurrencyConvert;
+function EncodeBase64(input) {
+    return Buffer.from(input, 'utf-8').toString('base64');
+}
+function DecodeBase64(encoded) {
+    return Buffer.from(encoded, 'base64').toString('utf-8');
+}
+function EncodeURL(input) {
+    try {
+        const decoded = decodeURIComponent(input);
+        return encodeURIComponent(decoded);
+    }
+    catch (_a) {
+        return encodeURIComponent(input);
+    }
+}
+function DecodeURL(input) {
+    try {
+        return decodeURIComponent(input);
+    }
+    catch (_a) {
+        return input;
+    }
+}
+function SafeEncode(input) {
+    return EncodeURL(EncodeBase64(input));
+}
+function SafeDecode(encoded) {
+    return DecodeBase64(DecodeURL(encoded));
+}

package/dist/tests/mapper.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/mapper.js

@@ -0,0 +1,18 @@
+"use strict";
+// bun run src/tests/mapper.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+const case_mapper_1 = require("../main/case-mapper");
+const dto = {
+    id: "abc123",
+    nameLang: {
+        "en-US": "Hello",
+        "te-IN": "హలో",
+        "ta-IN": "வணக்கம்",
+    },
+    createdAt: new Date(),
+    createdBy: "user123",
+};
+const entity = (0, case_mapper_1.toViewMapper)(dto);
+const schema = (0, case_mapper_1.toSchemaMapper)(entity);
+const newEntity = (0, case_mapper_1.toViewMapper)(dto);
+console.log(entity, schema, newEntity);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dff-util",
-  "version": "1.2.9",
+  "version": "1.3.1",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
@@ -28,4 +28,4 @@
     "jwt-encode": "^1.0.1",
     "randomstring": "1.3.0"
   }
-}
+}