@nu-art/ts-common 0.204.103 → 0.204.105

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nu-art/ts-common",
-  "version": "0.204.103",
+  "version": "0.204.105",
   "description": "js and ts infra",
   "keywords": [
     "TacB0sS",

package/utils/string-tools.d.ts

@@ -1,6 +1,15 @@
 export declare function padNumber(num: number | string, length: number): string;
 export declare function stringToHashCode(stringToHash: string): number;
 export declare function escape_RegExp(string: string): string;
+export declare function maxSubstring(string: string, maxBytes: number, direction?: 'start' | 'end'): string;
+/**
+ * Calculate the size of a string in the specified unit.
+ * @param str - The input string whose size is to be calculated.
+ * @param unit - The unit of size ('KB', 'MB', or 'GB').
+ * @returns The size of the string in the specified unit.
+ * @throws Error if the unit is invalid.
+ */
+export declare function getStringSize(str: string, unit?: 'KB' | 'MB' | 'GB'): number;
 export declare function stringFormat(input: string, params?: string[]): string;
 export declare function replaceStringAt(origin: string, index: number, replacement: string): string;
 export declare function capitalizeAllFirstLetters(value: string): string;

package/utils/string-tools.js

@@ -17,7 +17,7 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.convertUpperCamelCase = exports.normalizeString = exports.levenshteinDistance = exports.createLevenshteinDistanceMatrix = exports.capitalizeFirstLetter = exports.capitalizeAllFirstLetters = exports.replaceStringAt = exports.stringFormat = exports.escape_RegExp = exports.stringToHashCode = exports.padNumber = void 0;
+exports.convertUpperCamelCase = exports.normalizeString = exports.levenshteinDistance = exports.createLevenshteinDistanceMatrix = exports.capitalizeFirstLetter = exports.capitalizeAllFirstLetters = exports.replaceStringAt = exports.stringFormat = exports.getStringSize = exports.maxSubstring = exports.escape_RegExp = exports.stringToHashCode = exports.padNumber = void 0;
 function padNumber(num, length) {
     const _num = num.toString();
     return _num.length < length ? padNumber('0' + _num, length) : _num;
@@ -38,6 +38,46 @@ function escape_RegExp(string) {
     return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string
 }
 exports.escape_RegExp = escape_RegExp;
+function maxSubstring(string, maxBytes, direction = 'start') {
+    const encoder = new TextEncoder();
+    const decoder = new TextDecoder();
+    const bytes = encoder.encode(string);
+    if (bytes.length <= maxBytes) {
+        return string;
+    }
+    let slicedBytes;
+    if (direction === 'start') {
+        slicedBytes = bytes.slice(0, maxBytes);
+    }
+    else {
+        slicedBytes = bytes.slice(-maxBytes);
+    }
+    return decoder.decode(slicedBytes);
+}
+exports.maxSubstring = maxSubstring;
+/**
+ * Calculate the size of a string in the specified unit.
+ * @param str - The input string whose size is to be calculated.
+ * @param unit - The unit of size ('KB', 'MB', or 'GB').
+ * @returns The size of the string in the specified unit.
+ * @throws Error if the unit is invalid.
+ */
+function getStringSize(str, unit = 'KB') {
+    const encoder = new TextEncoder();
+    const bytes = encoder.encode(str);
+    const byteLength = bytes.length;
+    switch (unit) {
+        case 'KB':
+            return byteLength / 1024;
+        case 'MB':
+            return byteLength / (1024 * 1024);
+        case 'GB':
+            return byteLength / (1024 * 1024 * 1024);
+        default:
+            throw new Error('Invalid unit. Please specify "KB", "MB", or "GB".');
+    }
+}
+exports.getStringSize = getStringSize;
 function stringFormat(input, params = []) {
     return (params === null || params === void 0 ? void 0 : params.reduce((toRet, param, index) => {
         return toRet.replace(new RegExp(`\\{${index}\\}`, 'g'), param);