@catbee/utils 0.0.8-rc.1 → 0.0.8-rc.2

package/build/esnext/utils/stream.utils.d.ts

@@ -1,88 +0,0 @@
-import { Readable, Transform } from 'stream';
-import { BufferEncoding } from './crypto.utils';
-/**
- * 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;
-//# sourceMappingURL=stream.utils.d.ts.map

package/build/esnext/utils/stream.utils.js

@@ -1,210 +0,0 @@
-/*
- * The MIT License
- *
- * Copyright (c) 2025 Catbee Technologies. https://catbee-utils.npm.hprasath.com/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';
-/**
- * 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 function bufferToStream(data) {
-    const readable = new Readable();
-    readable.push(data);
-    readable.push(null); // End of stream
-    return 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 async function streamToBuffer(stream) {
-    return new Promise((resolve, reject) => {
-        const chunks = [];
-        stream.on('data', chunk => chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)));
-        stream.on('end', () => resolve(Buffer.concat(chunks)));
-        stream.on('error', reject);
-    });
-}
-/**
- * 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 async function streamToString(stream, encoding = 'utf8') {
-    const buffer = await streamToBuffer(stream);
-    return buffer.toString(encoding);
-}
-/**
- * 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 function createThrottleStream(bytesPerSecond) {
-    let bytesSent = 0;
-    let startTime = Date.now();
-    return new Transform({
-        transform(chunk, _encoding, callback) {
-            const elapsedSeconds = (Date.now() - startTime) / 1000;
-            const targetBytes = bytesPerSecond * elapsedSeconds;
-            const chunkSize = chunk.length;
-            // If we've sent fewer bytes than our target, just send the chunk
-            if (bytesSent + chunkSize <= targetBytes) {
-                bytesSent += chunkSize;
-                callback(null, chunk);
-                return;
-            }
-            // Otherwise we need to throttle
-            const delay = ((bytesSent + chunkSize) / bytesPerSecond - elapsedSeconds) * 1000;
-            setTimeout(() => {
-                bytesSent += chunkSize;
-                callback(null, chunk);
-            }, delay);
-        }
-    });
-}
-/**
- * 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 function createBatchStream(size, options = {}) {
-    const objectMode = options.objectMode !== false;
-    let batch = [];
-    let buffers = [];
-    let bufferSize = 0;
-    return new Transform({
-        objectMode,
-        transform(chunk, _encoding, callback) {
-            if (objectMode) {
-                batch.push(chunk);
-                if (batch.length >= size) {
-                    this.push(batch);
-                    batch = [];
-                }
-            }
-            else {
-                const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
-                buffers.push(buffer);
-                bufferSize += buffer.length;
-                // Emit batches of exact size
-                let combined = Buffer.concat(buffers, bufferSize);
-                while (combined.length >= size) {
-                    this.push(combined.slice(0, size));
-                    combined = combined.slice(size);
-                }
-                buffers = combined.length > 0 ? [combined] : [];
-                bufferSize = combined.length;
-            }
-            callback();
-        },
-        flush(callback) {
-            if (objectMode && batch.length > 0) {
-                this.push(batch);
-            }
-            else if (!objectMode && buffers.length > 0 && bufferSize > 0) {
-                let combined = Buffer.concat(buffers, bufferSize);
-                while (combined.length >= size) {
-                    this.push(combined.slice(0, size));
-                    combined = combined.slice(size);
-                }
-                if (combined.length > 0) {
-                    this.push(combined);
-                }
-            }
-            callback();
-        }
-    });
-}
-/**
- * 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 function createLineStream(options = {}) {
-    const { encoding = 'utf8', includeNewlines = false } = options;
-    let buffer = '';
-    return new Transform({
-        objectMode: true,
-        transform(chunk, _encoding, callback) {
-            const str = buffer + (Buffer.isBuffer(chunk) ? chunk.toString(encoding) : chunk);
-            const lines = str.split(/\r?\n/);
-            buffer = lines.pop() || '';
-            for (const line of lines) {
-                this.push(includeNewlines ? line + '\n' : line);
-            }
-            callback();
-        },
-        flush(callback) {
-            if (buffer) {
-                this.push(buffer);
-            }
-            callback();
-        }
-    });
-}
-//# sourceMappingURL=stream.utils.js.map

package/build/esnext/utils/stream.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream.utils.js","sourceRoot":"","sources":["../../../src/utils/stream.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * The MIT License\n *\n * Copyright (c) 2025 Catbee Technologies. https://catbee-utils.npm.hprasath.com/license\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Readable, Transform, TransformCallback } from 'stream';\nimport { BufferEncoding } from './crypto.utils';\n\n/**\n * Convert a buffer or string to a readable stream.\n *\n * @param data - Buffer or string to convert\n * @returns Readable stream containing the data\n *\n * @example\n * ```typescript\n * const stream = bufferToStream(Buffer.from('Hello world'));\n * // or\n * const stream = bufferToStream('Hello world');\n * ```\n */\nexport function bufferToStream(data: Buffer | string): Readable {\n  const readable = new Readable();\n  readable.push(data);\n  readable.push(null); // End of stream\n  return readable;\n}\n\n/**\n * Convert a readable stream to a buffer.\n *\n * @param stream - Readable stream to convert\n * @returns Promise resolving to a buffer containing all stream data\n *\n * @example\n * ```typescript\n * const buffer = await streamToBuffer(fs.createReadStream('file.txt'));\n * console.log(buffer.toString()); // Contents of file.txt\n * ```\n */\nexport async function streamToBuffer(stream: Readable): Promise<Buffer> {\n  return new Promise<Buffer>((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    stream.on('data', chunk => chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)));\n    stream.on('end', () => resolve(Buffer.concat(chunks)));\n    stream.on('error', reject);\n  });\n}\n\n/**\n * Convert a readable stream to a string.\n *\n * @param stream - Readable stream to convert\n * @param encoding - Character encoding (default: 'utf8')\n * @returns Promise resolving to a string containing all stream data\n *\n * @example\n * ```typescript\n * const content = await streamToString(fs.createReadStream('file.txt'));\n * console.log(content); // Contents of file.txt as string\n * ```\n */\nexport async function streamToString(stream: Readable, encoding: BufferEncoding = 'utf8'): Promise<string> {\n  const buffer = await streamToBuffer(stream);\n  return buffer.toString(encoding);\n}\n\n/**\n * Create a transform stream that limits the rate of data flow.\n *\n * @param bytesPerSecond - Maximum bytes per second\n * @returns Transform stream that throttles data flow\n */\nexport function createThrottleStream(bytesPerSecond: number): Transform {\n  let bytesSent = 0;\n  let startTime = Date.now();\n\n  return new Transform({\n    transform(chunk: Buffer, _encoding: BufferEncoding, callback: TransformCallback) {\n      const elapsedSeconds = (Date.now() - startTime) / 1000;\n      const targetBytes = bytesPerSecond * elapsedSeconds;\n      const chunkSize = chunk.length;\n\n      // If we've sent fewer bytes than our target, just send the chunk\n      if (bytesSent + chunkSize <= targetBytes) {\n        bytesSent += chunkSize;\n        callback(null, chunk);\n        return;\n      }\n\n      // Otherwise we need to throttle\n      const delay = ((bytesSent + chunkSize) / bytesPerSecond - elapsedSeconds) * 1000;\n\n      setTimeout(() => {\n        bytesSent += chunkSize;\n        callback(null, chunk);\n      }, delay);\n    }\n  });\n}\n\n/**\n * Create a transform stream that batches data into chunks of specified size.\n *\n * @param size - Size of each batch (items for object mode, bytes for binary mode)\n * @param options - Stream options\n * @returns Transform stream that batches data\n *\n * @example\n * ```typescript\n * // Batch lines from a file into arrays of 100 lines each\n * createReadStream('large-file.txt')\n *   .pipe(createLineStream())\n *   .pipe(createBatchStream(100))\n *   .on('data', batch => console.log(`Processing batch of ${batch.length} lines`));\n * ```\n */\nexport function createBatchStream(size: number, options: { objectMode?: boolean } = {}): Transform {\n  const objectMode = options.objectMode !== false;\n  let batch: any[] = [];\n  let buffers: Buffer[] = [];\n  let bufferSize = 0;\n\n  return new Transform({\n    objectMode,\n    transform(chunk, _encoding, callback) {\n      if (objectMode) {\n        batch.push(chunk);\n        if (batch.length >= size) {\n          this.push(batch);\n          batch = [];\n        }\n      } else {\n        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);\n        buffers.push(buffer);\n        bufferSize += buffer.length;\n\n        // Emit batches of exact size\n        let combined = Buffer.concat(buffers, bufferSize);\n        while (combined.length >= size) {\n          this.push(combined.slice(0, size));\n          combined = combined.slice(size);\n        }\n        buffers = combined.length > 0 ? [combined] : [];\n        bufferSize = combined.length;\n      }\n\n      callback();\n    },\n\n    flush(callback) {\n      if (objectMode && batch.length > 0) {\n        this.push(batch);\n      } else if (!objectMode && buffers.length > 0 && bufferSize > 0) {\n        let combined = Buffer.concat(buffers, bufferSize);\n        while (combined.length >= size) {\n          this.push(combined.slice(0, size));\n          combined = combined.slice(size);\n        }\n        if (combined.length > 0) {\n          this.push(combined);\n        }\n      }\n      callback();\n    }\n  });\n}\n\n/**\n * Create a transform stream that splits text data by newlines.\n *\n * @param options - Options for the line stream\n * @returns Transform stream that emits lines\n *\n * @example\n * ```typescript\n * // Process a file line by line\n * createReadStream('file.txt')\n *   .pipe(createLineStream())\n *   .on('data', line => console.log(`Line: ${line}`));\n * ```\n */\nexport function createLineStream(\n  options: {\n    encoding?: BufferEncoding;\n    includeNewlines?: boolean;\n  } = {}\n): Transform {\n  const { encoding = 'utf8', includeNewlines = false } = options;\n  let buffer = '';\n\n  return new Transform({\n    objectMode: true,\n    transform(chunk, _encoding, callback) {\n      const str = buffer + (Buffer.isBuffer(chunk) ? chunk.toString(encoding) : chunk);\n      const lines = str.split(/\\r?\\n/);\n      buffer = lines.pop() || '';\n\n      for (const line of lines) {\n        this.push(includeNewlines ? line + '\\n' : line);\n      }\n\n      callback();\n    },\n\n    flush(callback) {\n      if (buffer) {\n        this.push(buffer);\n      }\n      callback();\n    }\n  });\n}\n"]}

package/build/esnext/utils/string.utils.d.ts

@@ -1,93 +0,0 @@
-/**
- * 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;
-//# sourceMappingURL=string.utils.d.ts.map

package/build/esnext/utils/string.utils.js

@@ -1,165 +0,0 @@
-/*
- * The MIT License
- *
- * Copyright (c) 2025 Catbee Technologies. https://catbee-utils.npm.hprasath.com/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 function capitalize(str) {
-    return str.length === 0 ? '' : str.charAt(0).toUpperCase() + str.slice(1);
-}
-/**
- * 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 function toKebabCase(str) {
-    return str
-        .replace(/([a-z])([A-Z])/g, '$1-$2') // camelCase -> camel-Case
-        .replace(/\s+/g, '-') // spaces to dash
-        .replace(/_+/g, '-') // underscores to dash
-        .toLowerCase();
-}
-/**
- * Converts a kebab-case or snake_case string to camelCase.
- *
- * @param {string} str - The input string.
- * @returns {string} The camelCased string.
- */
-export function toCamelCase(str) {
-    return str.replace(/[-_](.)/g, (_, c) => c.toUpperCase());
-}
-/**
- * Converts a string to a URL-friendly slug (lowercase, dashes, alphanumeric).
- *
- * @param {string} str - The input string.
- * @returns {string} The slugified string.
- */
-export function slugify(str) {
-    return str
-        .toLowerCase()
-        .replace(/[^\w\s-]/g, '') // remove non-word
-        .replace(/\s+/g, '-') // spaces to dash
-        .replace(/-+/g, '-') // multiple dashes to one
-        .replace(/^-+|-+$/g, ''); // trim leading/trailing dashes
-}
-/**
- * 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 function truncate(str, len) {
-    return str.length > len ? str.slice(0, len) + '...' : str;
-}
-/**
- * Converts a string to PascalCase (e.g., "foo-bar" → "FooBar").
- *
- * @param {string} str - The input string.
- * @returns {string} The PascalCased string.
- */
-export function toPascalCase(str) {
-    return capitalize(toCamelCase(str));
-}
-/**
- * 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 function toSnakeCase(str) {
-    return str
-        .trim()
-        .replace(/([a-z])([A-Z])/g, '$1_$2') // camelCase -> camel_Case
-        .replace(/\s+/g, '_') // spaces to underscore
-        .replace(/-+/g, '_') // dashes to underscore
-        .toLowerCase();
-}
-/**
- * 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 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;
-}
-/**
- * Removes all HTML tags from a string.
- *
- * @param {string} str - The HTML string to process.
- * @returns {string} The string with HTML tags removed.
- */
-export function stripHtml(str) {
-    return str.replace(/<[^>]*>/g, '');
-}
-/**
- * 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 function equalsIgnoreCase(a, b) {
-    return a.toLowerCase() === b.toLowerCase();
-}
-/**
- * Reverses a string.
- *
- * @param {string} str - The string to reverse.
- * @returns {string} The reversed string.
- */
-export function reverse(str) {
-    return str.split('').reverse().join('');
-}
-/**
- * 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 function countOccurrences(str, substring, caseSensitive = true) {
-    if (!caseSensitive) {
-        str = str.toLowerCase();
-        substring = substring.toLowerCase();
-    }
-    return str.split(substring).length - 1;
-}
-//# sourceMappingURL=string.utils.js.map

package/build/esnext/utils/string.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"string.utils.js","sourceRoot":"","sources":["../../../src/utils/string.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * The MIT License\n *\n * Copyright (c) 2025 Catbee Technologies. https://catbee-utils.npm.hprasath.com/license\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Capitalizes the first character of a string.\n *\n * @param {string} str - The input string.\n * @returns {string} The string with the first character in uppercase.\n */\nexport function capitalize(str: string): string {\n  return str.length === 0 ? '' : str.charAt(0).toUpperCase() + str.slice(1);\n}\n\n/**\n * Converts a string to kebab-case (e.g., \"FooBar test\" → \"foo-bar-test\").\n *\n * @param {string} str - The input string.\n * @returns {string} The kebab-cased string.\n */\nexport function toKebabCase(str: string): string {\n  return str\n    .replace(/([a-z])([A-Z])/g, '$1-$2') // camelCase -> camel-Case\n    .replace(/\\s+/g, '-') // spaces to dash\n    .replace(/_+/g, '-') // underscores to dash\n    .toLowerCase();\n}\n\n/**\n * Converts a kebab-case or snake_case string to camelCase.\n *\n * @param {string} str - The input string.\n * @returns {string} The camelCased string.\n */\nexport function toCamelCase(str: string): string {\n  return str.replace(/[-_](.)/g, (_, c: string) => c.toUpperCase());\n}\n\n/**\n * Converts a string to a URL-friendly slug (lowercase, dashes, alphanumeric).\n *\n * @param {string} str - The input string.\n * @returns {string} The slugified string.\n */\nexport function slugify(str: string): string {\n  return str\n    .toLowerCase()\n    .replace(/[^\\w\\s-]/g, '') // remove non-word\n    .replace(/\\s+/g, '-') // spaces to dash\n    .replace(/-+/g, '-') // multiple dashes to one\n    .replace(/^-+|-+$/g, ''); // trim leading/trailing dashes\n}\n\n/**\n * Truncates a string to a specific length, appending '...' if truncated.\n *\n * @param {string} str - The input string.\n * @param {number} len - The maximum length.\n * @returns {string} The truncated string.\n */\nexport function truncate(str: string, len: number): string {\n  return str.length > len ? str.slice(0, len) + '...' : str;\n}\n\n/**\n * Converts a string to PascalCase (e.g., \"foo-bar\" → \"FooBar\").\n *\n * @param {string} str - The input string.\n * @returns {string} The PascalCased string.\n */\nexport function toPascalCase(str: string): string {\n  return capitalize(toCamelCase(str));\n}\n\n/**\n * Converts a string to snake_case (e.g., \"FooBar test\" → \"foo_bar_test\").\n *\n * @param {string} str - The input string.\n * @returns {string} The snake_cased string.\n */\nexport function toSnakeCase(str: string): string {\n  return str\n    .trim()\n    .replace(/([a-z])([A-Z])/g, '$1_$2') // camelCase -> camel_Case\n    .replace(/\\s+/g, '_') // spaces to underscore\n    .replace(/-+/g, '_') // dashes to underscore\n    .toLowerCase();\n}\n\n/**\n * Masks a string by replacing characters with a mask character.\n * Useful for hiding sensitive information like credit cards or passwords.\n *\n * @param {string} str - The string to mask.\n * @param {number} [visibleStart=0] - Number of characters to show at start.\n * @param {number} [visibleEnd=0] - Number of characters to show at end.\n * @param {string} [maskChar=\"*\"] - Character to use for masking.\n * @returns {string} The masked string.\n */\nexport function mask(str: string, visibleStart: number = 0, visibleEnd: number = 0, maskChar: string = '*'): string {\n  if (!str || str.length === 0) return '';\n  if (visibleStart >= str.length) return str;\n\n  const start = str.slice(0, visibleStart);\n  const end = visibleEnd > 0 ? str.slice(-visibleEnd) : '';\n  const masked = maskChar.repeat(Math.max(0, str.length - visibleStart - visibleEnd));\n\n  return start + masked + end;\n}\n\n/**\n * Removes all HTML tags from a string.\n *\n * @param {string} str - The HTML string to process.\n * @returns {string} The string with HTML tags removed.\n */\nexport function stripHtml(str: string): string {\n  return str.replace(/<[^>]*>/g, '');\n}\n\n/**\n * Performs case-insensitive string comparison.\n *\n * @param {string} a - First string.\n * @param {string} b - Second string.\n * @returns {boolean} True if the strings are equal ignoring case.\n */\nexport function equalsIgnoreCase(a: string, b: string): boolean {\n  return a.toLowerCase() === b.toLowerCase();\n}\n\n/**\n * Reverses a string.\n *\n * @param {string} str - The string to reverse.\n * @returns {string} The reversed string.\n */\nexport function reverse(str: string): string {\n  return str.split('').reverse().join('');\n}\n\n/**\n * Counts occurrences of a substring within a string.\n *\n * @param {string} str - The source string.\n * @param {string} substring - The substring to count.\n * @param {boolean} [caseSensitive=true] - Whether to perform case-sensitive counting.\n * @returns {number} Number of occurrences.\n */\nexport function countOccurrences(str: string, substring: string, caseSensitive: boolean = true): number {\n  if (!caseSensitive) {\n    str = str.toLowerCase();\n    substring = substring.toLowerCase();\n  }\n\n  return str.split(substring).length - 1;\n}\n"]}