@catbee/utils 1.1.0 → 2.0.0-next.0

package/stream/stream.utils.d.ts

@@ -0,0 +1,111 @@
+/*
+ * The MIT License
+ * 
+ * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { Readable, Transform } from 'stream';
+import type { BufferEncoding } from '@catbee/utils/crypto';
+/**
+ * Convert a buffer or string to a readable stream.
+ *
+ * @param data - Buffer or string to convert
+ * @returns Readable stream containing the data
+ *
+ * @example
+ * ```typescript
+ * const stream = bufferToStream(Buffer.from('Hello world'));
+ * // or
+ * const stream = bufferToStream('Hello world');
+ * ```
+ */
+export declare function bufferToStream(data: Buffer | string): Readable;
+/**
+ * Convert a readable stream to a buffer.
+ *
+ * @param stream - Readable stream to convert
+ * @returns Promise resolving to a buffer containing all stream data
+ *
+ * @example
+ * ```typescript
+ * const buffer = await streamToBuffer(fs.createReadStream('file.txt'));
+ * console.log(buffer.toString()); // Contents of file.txt
+ * ```
+ */
+export declare function streamToBuffer(stream: Readable): Promise<Buffer>;
+/**
+ * Convert a readable stream to a string.
+ *
+ * @param stream - Readable stream to convert
+ * @param encoding - Character encoding (default: 'utf8')
+ * @returns Promise resolving to a string containing all stream data
+ *
+ * @example
+ * ```typescript
+ * const content = await streamToString(fs.createReadStream('file.txt'));
+ * console.log(content); // Contents of file.txt as string
+ * ```
+ */
+export declare function streamToString(stream: Readable, encoding?: BufferEncoding): Promise<string>;
+/**
+ * Create a transform stream that limits the rate of data flow.
+ *
+ * @param bytesPerSecond - Maximum bytes per second
+ * @returns Transform stream that throttles data flow
+ */
+export declare function createThrottleStream(bytesPerSecond: number): Transform;
+/**
+ * Create a transform stream that batches data into chunks of specified size.
+ *
+ * @param size - Size of each batch (items for object mode, bytes for binary mode)
+ * @param options - Stream options
+ * @returns Transform stream that batches data
+ *
+ * @example
+ * ```typescript
+ * // Batch lines from a file into arrays of 100 lines each
+ * createReadStream('large-file.txt')
+ *   .pipe(createLineStream())
+ *   .pipe(createBatchStream(100))
+ *   .on('data', batch => console.log(`Processing batch of ${batch.length} lines`));
+ * ```
+ */
+export declare function createBatchStream(size: number, options?: {
+    objectMode?: boolean;
+}): Transform;
+/**
+ * Create a transform stream that splits text data by newlines.
+ *
+ * @param options - Options for the line stream
+ * @returns Transform stream that emits lines
+ *
+ * @example
+ * ```typescript
+ * // Process a file line by line
+ * createReadStream('file.txt')
+ *   .pipe(createLineStream())
+ *   .on('data', line => console.log(`Line: ${line}`));
+ * ```
+ */
+export declare function createLineStream(options?: {
+    encoding?: BufferEncoding;
+    includeNewlines?: boolean;
+}): Transform;

package/string/index.cjs

@@ -0,0 +1,109 @@
+/*
+ * The MIT License
+ * 
+ * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/string/string.utils.ts
+function capitalize(str) {
+  if (typeof str !== "string") throw new TypeError("Expected a string");
+  return str.length === 0 ? "" : str.charAt(0).toUpperCase() + str.slice(1);
+}
+__name(capitalize, "capitalize");
+function toKebabCase(str) {
+  if (typeof str !== "string") throw new TypeError("Expected a string");
+  return str.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/\s+/g, "-").replace(/_+/g, "-").toLowerCase();
+}
+__name(toKebabCase, "toKebabCase");
+function toCamelCase(str) {
+  if (typeof str !== "string") throw new TypeError("Expected a string");
+  return str.replace(/[-_](.)/g, (_, c) => c.toUpperCase());
+}
+__name(toCamelCase, "toCamelCase");
+function slugify(str) {
+  return str.toLowerCase().replace(/[^\w\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-+|-+$/g, "");
+}
+__name(slugify, "slugify");
+function truncate(str, len) {
+  return str.length > len ? str.slice(0, len) + "..." : str;
+}
+__name(truncate, "truncate");
+function toPascalCase(str) {
+  return capitalize(toCamelCase(str));
+}
+__name(toPascalCase, "toPascalCase");
+function toSnakeCase(str) {
+  return str.trim().replace(/([a-z])([A-Z])/g, "$1_$2").replace(/\s+/g, "_").replace(/-+/g, "_").toLowerCase();
+}
+__name(toSnakeCase, "toSnakeCase");
+function mask(str, visibleStart = 0, visibleEnd = 0, maskChar = "*") {
+  if (!str || str.length === 0) return "";
+  if (visibleStart >= str.length) return str;
+  const start = str.slice(0, visibleStart);
+  const end = visibleEnd > 0 ? str.slice(-visibleEnd) : "";
+  const masked = maskChar.repeat(Math.max(0, str.length - visibleStart - visibleEnd));
+  return start + masked + end;
+}
+__name(mask, "mask");
+function stripHtml(str) {
+  return str.replace(/<[^>]*>/g, "");
+}
+__name(stripHtml, "stripHtml");
+function equalsIgnoreCase(a, b) {
+  return a.toLowerCase() === b.toLowerCase();
+}
+__name(equalsIgnoreCase, "equalsIgnoreCase");
+function reverse(str) {
+  return str.split("").reverse().join("");
+}
+__name(reverse, "reverse");
+function countOccurrences(str, substring, caseSensitive = true) {
+  if (!caseSensitive) {
+    str = str.toLowerCase();
+    substring = substring.toLowerCase();
+  }
+  return str.split(substring).length - 1;
+}
+__name(countOccurrences, "countOccurrences");
+function toTitleCase(str) {
+  if (typeof str !== "string") throw new TypeError("Expected a string");
+  return str.split(/(\s+)/).map((part) => part.trim().length === 0 ? part : part.charAt(0).toUpperCase() + part.slice(1).toLowerCase()).join("");
+}
+__name(toTitleCase, "toTitleCase");
+
+exports.capitalize = capitalize;
+exports.countOccurrences = countOccurrences;
+exports.equalsIgnoreCase = equalsIgnoreCase;
+exports.mask = mask;
+exports.reverse = reverse;
+exports.slugify = slugify;
+exports.stripHtml = stripHtml;
+exports.toCamelCase = toCamelCase;
+exports.toKebabCase = toKebabCase;
+exports.toPascalCase = toPascalCase;
+exports.toSnakeCase = toSnakeCase;
+exports.toTitleCase = toTitleCase;
+exports.truncate = truncate;

package/string/index.d.ts

@@ -0,0 +1,25 @@
+/*
+ * The MIT License
+ * 
+ * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+export * from './string.utils';

package/string/index.mjs

@@ -0,0 +1,95 @@
+/*
+ * The MIT License
+ * 
+ * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/string/string.utils.ts
+function capitalize(str) {
+  if (typeof str !== "string") throw new TypeError("Expected a string");
+  return str.length === 0 ? "" : str.charAt(0).toUpperCase() + str.slice(1);
+}
+__name(capitalize, "capitalize");
+function toKebabCase(str) {
+  if (typeof str !== "string") throw new TypeError("Expected a string");
+  return str.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/\s+/g, "-").replace(/_+/g, "-").toLowerCase();
+}
+__name(toKebabCase, "toKebabCase");
+function toCamelCase(str) {
+  if (typeof str !== "string") throw new TypeError("Expected a string");
+  return str.replace(/[-_](.)/g, (_, c) => c.toUpperCase());
+}
+__name(toCamelCase, "toCamelCase");
+function slugify(str) {
+  return str.toLowerCase().replace(/[^\w\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-+|-+$/g, "");
+}
+__name(slugify, "slugify");
+function truncate(str, len) {
+  return str.length > len ? str.slice(0, len) + "..." : str;
+}
+__name(truncate, "truncate");
+function toPascalCase(str) {
+  return capitalize(toCamelCase(str));
+}
+__name(toPascalCase, "toPascalCase");
+function toSnakeCase(str) {
+  return str.trim().replace(/([a-z])([A-Z])/g, "$1_$2").replace(/\s+/g, "_").replace(/-+/g, "_").toLowerCase();
+}
+__name(toSnakeCase, "toSnakeCase");
+function mask(str, visibleStart = 0, visibleEnd = 0, maskChar = "*") {
+  if (!str || str.length === 0) return "";
+  if (visibleStart >= str.length) return str;
+  const start = str.slice(0, visibleStart);
+  const end = visibleEnd > 0 ? str.slice(-visibleEnd) : "";
+  const masked = maskChar.repeat(Math.max(0, str.length - visibleStart - visibleEnd));
+  return start + masked + end;
+}
+__name(mask, "mask");
+function stripHtml(str) {
+  return str.replace(/<[^>]*>/g, "");
+}
+__name(stripHtml, "stripHtml");
+function equalsIgnoreCase(a, b) {
+  return a.toLowerCase() === b.toLowerCase();
+}
+__name(equalsIgnoreCase, "equalsIgnoreCase");
+function reverse(str) {
+  return str.split("").reverse().join("");
+}
+__name(reverse, "reverse");
+function countOccurrences(str, substring, caseSensitive = true) {
+  if (!caseSensitive) {
+    str = str.toLowerCase();
+    substring = substring.toLowerCase();
+  }
+  return str.split(substring).length - 1;
+}
+__name(countOccurrences, "countOccurrences");
+function toTitleCase(str) {
+  if (typeof str !== "string") throw new TypeError("Expected a string");
+  return str.split(/(\s+)/).map((part) => part.trim().length === 0 ? part : part.charAt(0).toUpperCase() + part.slice(1).toLowerCase()).join("");
+}
+__name(toTitleCase, "toTitleCase");
+
+export { capitalize, countOccurrences, equalsIgnoreCase, mask, reverse, slugify, stripHtml, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, toTitleCase, truncate };

package/string/string.utils.d.ts

@@ -0,0 +1,124 @@
+/*
+ * The MIT License
+ * 
+ * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+/**
+ * Capitalizes the first character of a string.
+ *
+ * @param {string} str - The input string.
+ * @returns {string} The string with the first character in uppercase.
+ */
+export declare function capitalize(str: string): string;
+/**
+ * Converts a string to kebab-case (e.g., "FooBar test" → "foo-bar-test").
+ *
+ * @param {string} str - The input string.
+ * @returns {string} The kebab-cased string.
+ */
+export declare function toKebabCase(str: string): string;
+/**
+ * Converts a kebab-case or snake_case string to camelCase.
+ *
+ * @param {string} str - The input string.
+ * @returns {string} The camelCased string.
+ */
+export declare function toCamelCase(str: string): string;
+/**
+ * Converts a string to a URL-friendly slug (lowercase, dashes, alphanumeric).
+ *
+ * @param {string} str - The input string.
+ * @returns {string} The slugified string.
+ */
+export declare function slugify(str: string): string;
+/**
+ * Truncates a string to a specific length, appending '...' if truncated.
+ *
+ * @param {string} str - The input string.
+ * @param {number} len - The maximum length.
+ * @returns {string} The truncated string.
+ */
+export declare function truncate(str: string, len: number): string;
+/**
+ * Converts a string to PascalCase (e.g., "foo-bar" → "FooBar").
+ *
+ * @param {string} str - The input string.
+ * @returns {string} The PascalCased string.
+ */
+export declare function toPascalCase(str: string): string;
+/**
+ * Converts a string to snake_case (e.g., "FooBar test" → "foo_bar_test").
+ *
+ * @param {string} str - The input string.
+ * @returns {string} The snake_cased string.
+ */
+export declare function toSnakeCase(str: string): string;
+/**
+ * Masks a string by replacing characters with a mask character.
+ * Useful for hiding sensitive information like credit cards or passwords.
+ *
+ * @param {string} str - The string to mask.
+ * @param {number} [visibleStart=0] - Number of characters to show at start.
+ * @param {number} [visibleEnd=0] - Number of characters to show at end.
+ * @param {string} [maskChar="*"] - Character to use for masking.
+ * @returns {string} The masked string.
+ */
+export declare function mask(str: string, visibleStart?: number, visibleEnd?: number, maskChar?: string): string;
+/**
+ * Removes all HTML tags from a string.
+ *
+ * @param {string} str - The HTML string to process.
+ * @returns {string} The string with HTML tags removed.
+ */
+export declare function stripHtml(str: string): string;
+/**
+ * Performs case-insensitive string comparison.
+ *
+ * @param {string} a - First string.
+ * @param {string} b - Second string.
+ * @returns {boolean} True if the strings are equal ignoring case.
+ */
+export declare function equalsIgnoreCase(a: string, b: string): boolean;
+/**
+ * Reverses a string.
+ *
+ * @param {string} str - The string to reverse.
+ * @returns {string} The reversed string.
+ */
+export declare function reverse(str: string): string;
+/**
+ * Counts occurrences of a substring within a string.
+ *
+ * @param {string} str - The source string.
+ * @param {string} substring - The substring to count.
+ * @param {boolean} [caseSensitive=true] - Whether to perform case-sensitive counting.
+ * @returns {number} Number of occurrences.
+ */
+export declare function countOccurrences(str: string, substring: string, caseSensitive?: boolean): number;
+/**
+ * Convert a string to Title Case (each word capitalized).
+ * Preserves existing spacing and punctuation between words.
+ *
+ * @param str - Input string
+ * @returns Title-cased string
+ */
+export declare function toTitleCase(str: string): string;

package/type/index.cjs

@@ -0,0 +1,129 @@
+/*
+ * The MIT License
+ * 
+ * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/type/type.utils.ts
+function isPrimitiveType(value, type) {
+  if (type === "array") {
+    return Array.isArray(value);
+  }
+  if (type === "null") {
+    return value === null;
+  }
+  if (type === "undefined") {
+    return value === void 0;
+  }
+  if (type === "object") {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+  }
+  return typeof value === type;
+}
+__name(isPrimitiveType, "isPrimitiveType");
+function getTypeOf(value) {
+  if (value === null) return "null";
+  if (value === void 0) return "undefined";
+  if (Array.isArray(value)) return "array";
+  return typeof value;
+}
+__name(getTypeOf, "getTypeOf");
+function isArrayOf(value, itemTypeGuard) {
+  if (!Array.isArray(value)) return false;
+  return value.every((item) => itemTypeGuard(item));
+}
+__name(isArrayOf, "isArrayOf");
+function toStr(value, defaultValue = "") {
+  if (value === null || value === void 0) return defaultValue;
+  try {
+    if (typeof value === "object") {
+      return JSON.stringify(value);
+    }
+    return String(value);
+  } catch {
+    return defaultValue;
+  }
+}
+__name(toStr, "toStr");
+function toNum(value, defaultValue = 0) {
+  if (value === null || value === void 0) return defaultValue;
+  if (typeof value === "number") return value;
+  try {
+    const num = Number(value);
+    return isNaN(num) ? defaultValue : num;
+  } catch {
+    return defaultValue;
+  }
+}
+__name(toNum, "toNum");
+function toBool(value, defaultValue = false) {
+  if (value === null || value === void 0) return defaultValue;
+  if (typeof value === "boolean") return value;
+  if (typeof value === "string") {
+    const lowercased = value.toLowerCase();
+    if (lowercased === "true" || lowercased === "yes" || lowercased === "y" || lowercased === "1") {
+      return true;
+    }
+    if (lowercased === "false" || lowercased === "no" || lowercased === "n" || lowercased === "0") {
+      return false;
+    }
+  }
+  if (typeof value === "number") {
+    return value !== 0;
+  }
+  return defaultValue;
+}
+__name(toBool, "toBool");
+function ensureType(value, expectedType, defaultValue) {
+  if (getTypeOf(value) === expectedType) {
+    return value;
+  }
+  return defaultValue;
+}
+__name(ensureType, "ensureType");
+function isDefined(value) {
+  return value !== null && value !== void 0;
+}
+__name(isDefined, "isDefined");
+function isEmpty(value) {
+  if (value == null) return true;
+  if (typeof value === "string") return value.trim().length === 0;
+  if (Array.isArray(value)) return value.length === 0;
+  if (value instanceof Map || value instanceof Set) return value.size === 0;
+  if (typeof value === "object") return Object.keys(value).length === 0;
+  return false;
+}
+__name(isEmpty, "isEmpty");
+
+exports.ensureType = ensureType;
+exports.getTypeOf = getTypeOf;
+exports.isArrayOf = isArrayOf;
+exports.isDefined = isDefined;
+exports.isEmpty = isEmpty;
+exports.isPrimitiveType = isPrimitiveType;
+exports.toBool = toBool;
+exports.toNum = toNum;
+exports.toStr = toStr;

package/type/index.d.ts

@@ -0,0 +1,25 @@
+/*
+ * The MIT License
+ * 
+ * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+export * from './type.utils';