diginext-utils 3.9.2 → 3.10.0

package/README.md

@@ -1,162 +1,162 @@
-# The library of utility plugins
-
-## Exports
-
--   "diginext-utils/dist": ES6 modules / NodeJS
--   "diginext-utils/esm": Node modules / JavaScript modules
-
-## Imports
-
-### ES5 module import:
-
-```javascript
-import utils from "diginext-utils";
-console.log(utils.xname.NameEN.generateName()); // output some random name in English
-
-// or
-
-import { NameEN } from "diginext-utils/dist/name";
-console.log(NameEN.generateName()); // output some random name in English
-
-// or just
-import { generateName } from "diginext-utils/dist/name/en";
-console.log(generateName()); // output some random name in English
-
-// or with require(...)
-const xurl = require("../dist/string/url");
-xurl.isLink("abc"); // FALSE
-xurl.isLink("https://www.google.com"); // TRUE
-```
-
-### Node module import:
-
-**IMPORTANT**: Set "type" as "module" your `package.json`
-
-```javascript
-// NodeJS moduies
-import utils from "diginext-utils";
-console.log(utils.xname.NameEN.generateName()); // output some random name in English
-```
-
-```html
-// browser
-<script type="module">
-	import { NameEN } from "diginext-utils/esm/name/index.js"; // ".js" file extension is required !
-	console.log(NameEN.generateName()); // output some random name in English
-</script>
-```
-
-## Features
-
--   xconsole
--   xarray
-    -   sumArray
-    -   averageArray
-    -   minArray
-    -   maxArray
-    -   sortElementByString
-    -   sortElementByNumber
-    -   firstElement
-    -   lastElement
-    -   randomIndex
-    -   randomElement
-    -   mergeAndMakeUniqueElement
-    -   allMatchInArray
-    -   removeItem
-    -   removeItemByKey
-    -   getRandom
-    -   getHalfRandom
-    -   shuffle
-    -   moveIndex
-    -   moveArray
--   xmath
-    -   rand
-    -   randRound
-    -   randHalt
-    -   randInt
-    -   randFloat
-    -   degToRad
-    -   radToDeg
-    -   angleBetweenPoints
-    -   diffDate
-    -   positiveNumber
--   xname
-    -   NameEN.generateName()
-    -   NameVI.generateName()
--   xobject
-    -   isNull
-    -   toBool
-    -   toInt
-    -   toFloat
-    -   toArray
-    -   objectToArray
--   xjson
-    -   isValid
--   xfile
-    -   createDir
-    -   fileMove
-    -   findFileByExt
--   xstring
-    -   getBetween
-    -   makeString
-    -   toUpperCase
-    -   toLowerCase
-    -   titleize
-    -   capitalize
-    -   capitalizeName
-    -   clearUnicodeCharacters
-    -   generateUUID
-    -   randAllCharacterByLength
-    -   randomStringByLength
-    -   formatNumber
-    -   generatePassword
-    -   trimNull
-    -   addQueryParam
-    -   getUrlParams
-    -   isLink
-    -   getFileNameWithoutExtension
-    -   getFileNameWithExtension
-    -   getFileExtension
-    -   isImage
--   xurl
-    -   addQueryParam
-    -   getUrlParams
-    -   isLink
-    -   getFileNameWithoutExtension
-    -   getFileNameWithExtension
-    -   getFileExtension
-    -   isImage
--   slug
-    -   makeSlug
--   color
-    -   random
-    -   pSBC
-    -   hexToRgb
-    -   hexDarken
-    -   hexLighten
-    -   RGBToHex
--   device
--   camera
-    -   requestCamera
-    -   requestDeviceOrientationControl
--   browser
-    -   isPotrait
-    -   isLandscape
-    -   ua
-    -   isFacebookWebview
-    -   isInAppWebview
--   Timer
-    -   wait
--   Validation
-    -   imageValidate
-    -   videoValidate
-
-## Dev
-
-```
-yarn dev
-```
-
-## Support
-
-Liên hệ [TOP GROUP Developers](mailto:dev@wearetopgroup.com) nếu cần hỗ trợ.
+# The library of utility plugins
+
+## Exports
+
+-   "diginext-utils/dist": ES6 modules / NodeJS
+-   "diginext-utils/esm": Node modules / JavaScript modules
+
+## Imports
+
+### ES5 module import:
+
+```javascript
+import utils from "diginext-utils";
+console.log(utils.xname.NameEN.generateName()); // output some random name in English
+
+// or
+
+import { NameEN } from "diginext-utils/dist/name";
+console.log(NameEN.generateName()); // output some random name in English
+
+// or just
+import { generateName } from "diginext-utils/dist/name/en";
+console.log(generateName()); // output some random name in English
+
+// or with require(...)
+const xurl = require("../dist/string/url");
+xurl.isLink("abc"); // FALSE
+xurl.isLink("https://www.google.com"); // TRUE
+```
+
+### Node module import:
+
+**IMPORTANT**: Set "type" as "module" your `package.json`
+
+```javascript
+// NodeJS moduies
+import utils from "diginext-utils";
+console.log(utils.xname.NameEN.generateName()); // output some random name in English
+```
+
+```html
+// browser
+<script type="module">
+	import { NameEN } from "diginext-utils/esm/name/index.js"; // ".js" file extension is required !
+	console.log(NameEN.generateName()); // output some random name in English
+</script>
+```
+
+## Features
+
+-   xconsole
+-   xarray
+    -   sumArray
+    -   averageArray
+    -   minArray
+    -   maxArray
+    -   sortElementByString
+    -   sortElementByNumber
+    -   firstElement
+    -   lastElement
+    -   randomIndex
+    -   randomElement
+    -   mergeAndMakeUniqueElement
+    -   allMatchInArray
+    -   removeItem
+    -   removeItemByKey
+    -   getRandom
+    -   getHalfRandom
+    -   shuffle
+    -   moveIndex
+    -   moveArray
+-   xmath
+    -   rand
+    -   randRound
+    -   randHalt
+    -   randInt
+    -   randFloat
+    -   degToRad
+    -   radToDeg
+    -   angleBetweenPoints
+    -   diffDate
+    -   positiveNumber
+-   xname
+    -   NameEN.generateName()
+    -   NameVI.generateName()
+-   xobject
+    -   isNull
+    -   toBool
+    -   toInt
+    -   toFloat
+    -   toArray
+    -   objectToArray
+-   xjson
+    -   isValid
+-   xfile
+    -   createDir
+    -   fileMove
+    -   findFileByExt
+-   xstring
+    -   getBetween
+    -   makeString
+    -   toUpperCase
+    -   toLowerCase
+    -   titleize
+    -   capitalize
+    -   capitalizeName
+    -   clearUnicodeCharacters
+    -   generateUUID
+    -   randAllCharacterByLength
+    -   randomStringByLength
+    -   formatNumber
+    -   generatePassword
+    -   trimNull
+    -   addQueryParam
+    -   getUrlParams
+    -   isLink
+    -   getFileNameWithoutExtension
+    -   getFileNameWithExtension
+    -   getFileExtension
+    -   isImage
+-   xurl
+    -   addQueryParam
+    -   getUrlParams
+    -   isLink
+    -   getFileNameWithoutExtension
+    -   getFileNameWithExtension
+    -   getFileExtension
+    -   isImage
+-   slug
+    -   makeSlug
+-   color
+    -   random
+    -   pSBC
+    -   hexToRgb
+    -   hexDarken
+    -   hexLighten
+    -   RGBToHex
+-   device
+-   camera
+    -   requestCamera
+    -   requestDeviceOrientationControl
+-   browser
+    -   isPotrait
+    -   isLandscape
+    -   ua
+    -   isFacebookWebview
+    -   isInAppWebview
+-   Timer
+    -   wait
+-   Validation
+    -   imageValidate
+    -   videoValidate
+
+## Dev
+
+```
+yarn dev
+```
+
+## Support
+
+Liên hệ [TOP GROUP Developers](mailto:dev@wearetopgroup.com) nếu cần hỗ trợ.

package/dist/string/guessMimeType.d.ts

@@ -0,0 +1 @@
+export default function guessMimeType(filepath: string): "image/png" | "image/jpeg" | "unknown" | "image/gif" | "image/webp" | "video/mp4" | "video/quicktime" | "video/webm" | "video/mpeg";

package/dist/string/guessMimeType.js

@@ -0,0 +1,13 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const guessMimeTypeByBuffer_1 = __importDefault(require("./guessMimeTypeByBuffer"));
+function guessMimeType(filepath) {
+    const buffer = fs_1.default.readFileSync(filepath);
+    return (0, guessMimeTypeByBuffer_1.default)(buffer);
+}
+exports.default = guessMimeType;
+//# sourceMappingURL=guessMimeType.js.map

package/dist/string/guessMimeType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guessMimeType.js","sourceRoot":"","sources":["../../src/string/guessMimeType.ts"],"names":[],"mappings":";;;;;AAAA,4CAAoB;AACpB,oFAA4D;AAE5D,SAAwB,aAAa,CAAC,QAAgB;IACrD,MAAM,MAAM,GAAG,YAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,IAAA,+BAAqB,EAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAHD,gCAGC"}

package/dist/string/guessMimeTypeByBuffer.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="node" />
+export default function guessMimeTypeByBuffer(buffer: Buffer): "image/png" | "image/jpeg" | "unknown" | "image/gif" | "image/webp" | "video/mp4" | "video/quicktime" | "video/webm" | "video/mpeg";

package/dist/string/guessMimeTypeByBuffer.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+function guessMimeTypeByBuffer(buffer) {
+    const signature = buffer.toString("hex", 0, 4);
+    switch (signature) {
+        case "89504e47":
+            return "image/png";
+        case "47494638":
+            return "image/gif";
+        case "52494646": {
+            const webpSignature = buffer.toString("hex", 8, 12);
+            if (webpSignature === "57454250") {
+                return "image/webp";
+            }
+            break;
+        }
+        // MP4, MOV, and other video formats can have multiple signatures
+        case "00000018":
+        case "0000001c":
+        case "00000020":
+            return "video/mp4";
+        case "66747970":
+            return "video/quicktime"; // MOV
+        case "1a45dfa3": // This is the start of an EBML document (used in WebM, MKV)
+            return "video/webm";
+        case "000001ba":
+        case "000001b3":
+            return "video/mpeg";
+        // Add more cases as needed
+        default:
+            // Check for JPEG signatures
+            if (signature.startsWith("ffd8ff")) {
+                return "image/jpeg";
+            }
+            return "unknown";
+    }
+    return "unknown";
+}
+exports.default = guessMimeTypeByBuffer;
+//# sourceMappingURL=guessMimeTypeByBuffer.js.map

package/dist/string/guessMimeTypeByBuffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guessMimeTypeByBuffer.js","sourceRoot":"","sources":["../../src/string/guessMimeTypeByBuffer.ts"],"names":[],"mappings":";;AAAA,SAAwB,qBAAqB,CAAC,MAAc;IAC3D,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAE/C,QAAQ,SAAS,EAAE;QAClB,KAAK,UAAU;YACd,OAAO,WAAW,CAAC;QACpB,KAAK,UAAU;YACd,OAAO,WAAW,CAAC;QACpB,KAAK,UAAU,CAAC,CAAC;YAChB,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACpD,IAAI,aAAa,KAAK,UAAU,EAAE;gBACjC,OAAO,YAAY,CAAC;aACpB;YACD,MAAM;SACN;QACD,iEAAiE;QACjE,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU;YACd,OAAO,WAAW,CAAC;QACpB,KAAK,UAAU;YACd,OAAO,iBAAiB,CAAC,CAAC,MAAM;QACjC,KAAK,UAAU,EAAE,4DAA4D;YAC5E,OAAO,YAAY,CAAC;QACrB,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU;YACd,OAAO,YAAY,CAAC;QACrB,2BAA2B;QAC3B;YACC,4BAA4B;YAC5B,IAAI,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE;gBACnC,OAAO,YAAY,CAAC;aACpB;YACD,OAAO,SAAS,CAAC;KAClB;IAED,OAAO,SAAS,CAAC;AAClB,CAAC;AArCD,wCAqCC"}

package/esm/string/guessMimeType.d.ts

@@ -0,0 +1 @@
+export default function guessMimeType(filepath: string): "image/png" | "image/jpeg" | "unknown" | "image/gif" | "image/webp" | "video/mp4" | "video/quicktime" | "video/webm" | "video/mpeg";

package/esm/string/guessMimeType.js

@@ -0,0 +1,7 @@
+import fs from "fs";
+import guessMimeTypeByBuffer from "./guessMimeTypeByBuffer";
+export default function guessMimeType(filepath) {
+    const buffer = fs.readFileSync(filepath);
+    return guessMimeTypeByBuffer(buffer);
+}
+//# sourceMappingURL=guessMimeType.js.map

package/esm/string/guessMimeType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guessMimeType.js","sourceRoot":"","sources":["../../src/string/guessMimeType.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,qBAAqB,MAAM,yBAAyB,CAAC;AAE5D,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,QAAgB;IACrD,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC"}

package/esm/string/guessMimeTypeByBuffer.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="node" />
+export default function guessMimeTypeByBuffer(buffer: Buffer): "image/png" | "image/jpeg" | "unknown" | "image/gif" | "image/webp" | "video/mp4" | "video/quicktime" | "video/webm" | "video/mpeg";

package/esm/string/guessMimeTypeByBuffer.js

@@ -0,0 +1,37 @@
+export default function guessMimeTypeByBuffer(buffer) {
+    const signature = buffer.toString("hex", 0, 4);
+    switch (signature) {
+        case "89504e47":
+            return "image/png";
+        case "47494638":
+            return "image/gif";
+        case "52494646": {
+            const webpSignature = buffer.toString("hex", 8, 12);
+            if (webpSignature === "57454250") {
+                return "image/webp";
+            }
+            break;
+        }
+        // MP4, MOV, and other video formats can have multiple signatures
+        case "00000018":
+        case "0000001c":
+        case "00000020":
+            return "video/mp4";
+        case "66747970":
+            return "video/quicktime"; // MOV
+        case "1a45dfa3": // This is the start of an EBML document (used in WebM, MKV)
+            return "video/webm";
+        case "000001ba":
+        case "000001b3":
+            return "video/mpeg";
+        // Add more cases as needed
+        default:
+            // Check for JPEG signatures
+            if (signature.startsWith("ffd8ff")) {
+                return "image/jpeg";
+            }
+            return "unknown";
+    }
+    return "unknown";
+}
+//# sourceMappingURL=guessMimeTypeByBuffer.js.map

package/esm/string/guessMimeTypeByBuffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guessMimeTypeByBuffer.js","sourceRoot":"","sources":["../../src/string/guessMimeTypeByBuffer.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,MAAc;IAC3D,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAE/C,QAAQ,SAAS,EAAE;QAClB,KAAK,UAAU;YACd,OAAO,WAAW,CAAC;QACpB,KAAK,UAAU;YACd,OAAO,WAAW,CAAC;QACpB,KAAK,UAAU,CAAC,CAAC;YAChB,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACpD,IAAI,aAAa,KAAK,UAAU,EAAE;gBACjC,OAAO,YAAY,CAAC;aACpB;YACD,MAAM;SACN;QACD,iEAAiE;QACjE,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU;YACd,OAAO,WAAW,CAAC;QACpB,KAAK,UAAU;YACd,OAAO,iBAAiB,CAAC,CAAC,MAAM;QACjC,KAAK,UAAU,EAAE,4DAA4D;YAC5E,OAAO,YAAY,CAAC;QACrB,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU;YACd,OAAO,YAAY,CAAC;QACrB,2BAA2B;QAC3B;YACC,4BAA4B;YAC5B,IAAI,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE;gBACnC,OAAO,YAAY,CAAC;aACpB;YACD,OAAO,SAAS,CAAC;KAClB;IAED,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "diginext-utils",
-	"version": "3.9.2",
+	"version": "3.10.0",
 	"sideEffects": false,
 	"readme": "README.md",
 	"homepage": "https://wearetopgroup.com",