@sudobility/types 1.9.53 → 1.9.55

package/dist/utils/formatting/string.js

@@ -1,6 +1,8 @@
 "use strict";
 /**
- * String formatting and manipulation utilities
+ * String formatting and manipulation utilities.
+ *
+ * @since 1.0.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.truncate = truncate;
@@ -20,7 +22,18 @@ exports.randomString = randomString;
 exports.pluralize = pluralize;
 exports.formatNumber = formatNumber;
 /**
- * Truncate a string to a maximum length with ellipsis
+ * Truncate a string to a maximum length with a suffix (default `...`).
+ *
+ * @param str - Input string
+ * @param maxLength - Maximum allowed length including suffix
+ * @param suffix - Truncation suffix (default: `'...'`)
+ * @returns Truncated string or original if within limit
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * truncate('Hello, World!', 8); // "Hello..."
+ * ```
  */
 function truncate(str, maxLength, suffix = '...') {
     if (!str || str.length <= maxLength) {
@@ -29,7 +42,16 @@ function truncate(str, maxLength, suffix = '...') {
     return str.slice(0, maxLength - suffix.length) + suffix;
 }
 /**
- * Capitalize the first letter of a string
+ * Capitalize the first letter of a string.
+ *
+ * @param str - Input string
+ * @returns String with first character uppercased
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * capitalize('hello'); // "Hello"
+ * ```
  */
 function capitalize(str) {
     if (!str)
@@ -37,7 +59,16 @@ function capitalize(str) {
     return str.charAt(0).toUpperCase() + str.slice(1);
 }
 /**
- * Convert a string to title case
+ * Convert a string to title case (capitalize each word).
+ *
+ * @param str - Input string
+ * @returns Title-cased string
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * toTitleCase('hello world'); // "Hello World"
+ * ```
  */
 function toTitleCase(str) {
     if (!str)
@@ -49,7 +80,16 @@ function toTitleCase(str) {
         .join(' ');
 }
 /**
- * Convert a string to kebab case
+ * Convert a string to kebab-case.
+ *
+ * @param str - Input string (camelCase, PascalCase, spaces, or underscores)
+ * @returns Kebab-cased string
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * toKebabCase('helloWorld'); // "hello-world"
+ * ```
  */
 function toKebabCase(str) {
     if (!str)
@@ -60,7 +100,16 @@ function toKebabCase(str) {
         .toLowerCase();
 }
 /**
- * Convert a string to camel case
+ * Convert a string to camelCase.
+ *
+ * @param str - Input string (kebab-case, snake_case, or spaces)
+ * @returns camelCased string
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * toCamelCase('hello-world'); // "helloWorld"
+ * ```
  */
 function toCamelCase(str) {
     if (!str)
@@ -70,7 +119,16 @@ function toCamelCase(str) {
         .replace(/^./, (char) => char.toLowerCase());
 }
 /**
- * Convert a string to snake case
+ * Convert a string to snake_case.
+ *
+ * @param str - Input string (camelCase, kebab-case, or spaces)
+ * @returns snake_cased string
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * toSnakeCase('helloWorld'); // "hello_world"
+ * ```
  */
 function toSnakeCase(str) {
     if (!str)
@@ -81,7 +139,11 @@ function toSnakeCase(str) {
         .toLowerCase();
 }
 /**
- * Remove extra whitespace from a string
+ * Collapse consecutive whitespace to a single space and trim.
+ *
+ * @param str - Input string
+ * @returns Normalized string
+ * @since 1.0.0
  */
 function normalizeWhitespace(str) {
     if (!str)
@@ -89,19 +151,36 @@ function normalizeWhitespace(str) {
     return str.replace(/\s+/g, ' ').trim();
 }
 /**
- * Check if a string is empty or only whitespace
+ * Check if a string is empty, undefined, null, or only whitespace.
+ *
+ * @param str - Input string (may be nullish)
+ * @returns True if blank
+ * @since 1.0.0
  */
 function isBlank(str) {
     return !str || str.trim().length === 0;
 }
 /**
- * Check if a string is not empty and not only whitespace
+ * Type guard: check if a string is not empty and not only whitespace.
+ *
+ * @param str - Input string (may be nullish)
+ * @returns True (and narrows to `string`) if not blank
+ * @since 1.0.0
  */
 function isNotBlank(str) {
     return !isBlank(str);
 }
 /**
- * Escape HTML special characters
+ * Escape HTML special characters (`&`, `<`, `>`, `"`, `'`).
+ *
+ * @param str - Input string
+ * @returns HTML-escaped string
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * escapeHtml('<b>Hi</b>'); // "&lt;b&gt;Hi&lt;/b&gt;"
+ * ```
  */
 function escapeHtml(str) {
     if (!str)
@@ -116,7 +195,16 @@ function escapeHtml(str) {
     return str.replace(/[&<>"']/g, (char) => htmlEscapes[char]);
 }
 /**
- * Remove HTML tags from a string
+ * Remove all HTML tags from a string.
+ *
+ * @param str - Input string with HTML
+ * @returns Plain text with tags removed
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * stripHtml('<p>Hello <b>world</b></p>'); // "Hello world"
+ * ```
  */
 function stripHtml(str) {
     if (!str)
@@ -124,7 +212,12 @@ function stripHtml(str) {
     return str.replace(/<[^>]*>/g, '');
 }
 /**
- * Extract initials from a name
+ * Extract initials from a name (e.g., "John Doe" -> "JD").
+ *
+ * @param name - Full name
+ * @param maxInitials - Maximum number of initials (default: 2)
+ * @returns Uppercase initials
+ * @since 1.0.0
  */
 function getInitials(name, maxInitials = 2) {
     if (!name)
@@ -137,7 +230,18 @@ function getInitials(name, maxInitials = 2) {
     return initials;
 }
 /**
- * Format bytes to human-readable size
+ * Format bytes to a human-readable size string (e.g., "1.5 MB").
+ *
+ * @param bytes - Size in bytes
+ * @param decimals - Decimal places (default: 2)
+ * @returns Formatted string like "1.5 MB"
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * formatBytes(1536); // "1.5 KB"
+ * formatBytes(0);    // "0 Bytes"
+ * ```
  */
 function formatBytes(bytes, decimals = 2) {
     if (bytes === 0)
@@ -149,7 +253,13 @@ function formatBytes(bytes, decimals = 2) {
     return parseFloat((bytes / Math.pow(k, i)).toFixed(dm)) + ' ' + sizes[i];
 }
 /**
- * Generate a random string
+ * Generate a random string of a given length.
+ *
+ * @param length - Desired string length
+ * @param charset - Character set: `'alpha'`, `'numeric'`,
+ *   `'alphanumeric'` (default), `'hex'`, or a custom string
+ * @returns Random string
+ * @since 1.0.0
  */
 function randomString(length, charset = 'alphanumeric') {
     let chars;
@@ -176,7 +286,21 @@ function randomString(length, charset = 'alphanumeric') {
     return result;
 }
 /**
- * Pluralize a word based on count
+ * Pluralize a word based on count.
+ * Appends `'s'` by default when count is not 1.
+ *
+ * @param count - Item count
+ * @param singular - Singular form
+ * @param plural - Optional explicit plural form
+ * @returns Singular or plural form based on count
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * pluralize(1, 'item');  // "item"
+ * pluralize(3, 'item');  // "items"
+ * pluralize(2, 'child', 'children'); // "children"
+ * ```
  */
 function pluralize(count, singular, plural) {
     if (count === 1) {
@@ -185,7 +309,16 @@ function pluralize(count, singular, plural) {
     return plural || `${singular}s`;
 }
 /**
- * Format a number with commas as thousands separators
+ * Format a number with commas as thousands separators.
+ *
+ * @param num - Number to format
+ * @returns Formatted string (e.g., "1,234,567")
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * formatNumber(1234567); // "1,234,567"
+ * ```
  */
 function formatNumber(num) {
     return num.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',');

package/dist/utils/formatting/string.js.map

@@ -1 +1 @@
-{"version":3,"file":"string.js","sourceRoot":"","sources":["../../../src/utils/formatting/string.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../../src/utils/formatting/string.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAkBH,4BASC;AAcD,gCAGC;AAcD,kCAOC;AAcD,kCAMC;AAcD,kCAKC;AAcD,kCAMC;AASD,kDAGC;AASD,0BAEC;AASD,gCAEC;AAcD,gCAUC;AAcD,8BAGC;AAUD,kCAUC;AAgBD,kCAUC;AAWD,oCA0BC;AAmBD,8BASC;AAcD,oCAEC;AAlUD;;;;;;;;;;;;;GAaG;AACH,SAAgB,QAAQ,CACtB,GAAW,EACX,SAAiB,EACjB,MAAM,GAAG,KAAK;IAEd,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QACpC,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;AAC1D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,OAAO,GAAG;SACP,WAAW,EAAE;SACb,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;SAC/B,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,OAAO,GAAG;SACP,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,OAAO,GAAG;SACP,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACtE,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,OAAO,GAAG;SACP,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,mBAAmB,CAAC,GAAW;IAC7C,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACzC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,OAAO,CAAC,GAAsB;IAC5C,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,UAAU,CAAC,GAAsB;IAC/C,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,MAAM,WAAW,GAA2B;QAC1C,GAAG,EAAE,OAAO;QACZ,GAAG,EAAE,MAAM;QACX,GAAG,EAAE,MAAM;QACX,GAAG,EAAE,QAAQ;QACb,GAAG,EAAE,OAAO;KACb,CAAC;IACF,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,SAAS,CAAC,GAAW;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,WAAW,CAAC,IAAY,EAAE,WAAW,GAAG,CAAC;IACvD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,KAAK;SACnB,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC;SACrB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;IAEZ,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,WAAW,CAAC,KAAa,EAAE,QAAQ,GAAG,CAAC;IACrD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAElC,MAAM,CAAC,GAAG,IAAI,CAAC;IACf,MAAM,EAAE,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACvC,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAEtD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpD,OAAO,UAAU,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,YAAY,CAAC,MAAc,EAAE,OAAO,GAAG,cAAc;IACnE,IAAI,KAAa,CAAC;IAElB,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,KAAK,GAAG,sDAAsD,CAAC;YAC/D,MAAM;QACR,KAAK,SAAS;YACZ,KAAK,GAAG,YAAY,CAAC;YACrB,MAAM;QACR,KAAK,cAAc;YACjB,KAAK,GAAG,gEAAgE,CAAC;YACzE,MAAM;QACR,KAAK,KAAK;YACR,KAAK,GAAG,kBAAkB,CAAC;YAC3B,MAAM;QACR;YACE,KAAK,GAAG,OAAO,CAAC;IACpB,CAAC;IAED,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,SAAS,CACvB,KAAa,EACb,QAAgB,EAChB,MAAyB;IAEzB,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,IAAI,GAAG,QAAQ,GAAG,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;AAC9D,CAAC"}

package/dist/utils/validation/type-validation.cjs

@@ -8,7 +8,21 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseJson = exports.createAssertion = exports.isUrl = exports.isEmail = exports.isValidDate = exports.isErrorResponse = exports.isSuccessResponse = exports.isApiResponse = exports.optional = exports.validateArray = exports.hasRequiredProperties = exports.isNullish = exports.isArray = exports.isObject = exports.isBoolean = exports.isNumber = exports.isString = exports.createValidator = void 0;
 /**
- * Creates a validation function that safely checks if a value matches expected type
+ * Creates a validation function that safely checks if a value matches
+ * the expected type. Returns a {@link ValidationResult}.
+ *
+ * @template T - The validated type
+ * @param validationFn - Type guard function
+ * @param typeName - Name used in error messages
+ * @returns A function returning `ValidationResult<T>`
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const validateString = createValidator(isString, 'string');
+ * validateString('hi');  // { isValid: true, data: 'hi' }
+ * validateString(42);    // { isValid: false, error: 'Invalid string' }
+ * ```
  */
 const createValidator = (validationFn, typeName) => {
     return (data) => {
@@ -29,22 +43,49 @@ const createValidator = (validationFn, typeName) => {
 };
 exports.createValidator = createValidator;
 /**
- * Basic type validators
+ * Runtime type guard: checks if value is a `string`.
+ * @since 1.0.0
  */
 const isString = (value) => typeof value === 'string';
 exports.isString = isString;
+/**
+ * Runtime type guard: checks if value is a finite `number` (excludes NaN).
+ * @since 1.0.0
+ */
 const isNumber = (value) => typeof value === 'number' && !isNaN(value);
 exports.isNumber = isNumber;
+/**
+ * Runtime type guard: checks if value is a `boolean`.
+ * @since 1.0.0
+ */
 const isBoolean = (value) => typeof value === 'boolean';
 exports.isBoolean = isBoolean;
+/**
+ * Runtime type guard: checks if value is a non-null, non-array object.
+ * @since 1.0.0
+ */
 const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
 exports.isObject = isObject;
+/**
+ * Runtime type guard: checks if value is an array.
+ * @since 1.0.0
+ */
 const isArray = (value) => Array.isArray(value);
 exports.isArray = isArray;
+/**
+ * Runtime type guard: checks if value is `null` or `undefined`.
+ * @since 1.0.0
+ */
 const isNullish = (value) => value === null || value === undefined;
 exports.isNullish = isNullish;
 /**
- * Validates that an object has required properties
+ * Validates that an object has all required properties present.
+ *
+ * @template T - Expected object shape
+ * @param obj - Value to check
+ * @param requiredProps - Array of required property keys
+ * @returns True if obj has all required properties
+ * @since 1.0.0
  */
 const hasRequiredProperties = (obj, requiredProps) => {
     if (!(0, exports.isObject)(obj))
@@ -53,7 +94,13 @@ const hasRequiredProperties = (obj, requiredProps) => {
 };
 exports.hasRequiredProperties = hasRequiredProperties;
 /**
- * Validates array of objects with a validator function
+ * Validates that a value is an array where every item passes a validator.
+ *
+ * @template T - Expected item type
+ * @param data - Value to check
+ * @param itemValidator - Type guard for individual items
+ * @returns True if data is an array of T
+ * @since 1.0.0
  */
 const validateArray = (data, itemValidator) => {
     if (!(0, exports.isArray)(data))
@@ -62,14 +109,20 @@ const validateArray = (data, itemValidator) => {
 };
 exports.validateArray = validateArray;
 /**
- * Creates optional property validator
+ * Wraps a validator to also accept `undefined`.
+ *
+ * @template T - The validated type
+ * @param validator - Base type guard
+ * @returns Type guard that also accepts `undefined`
+ * @since 1.0.0
  */
 const optional = (validator) => (value) => {
     return value === undefined || validator(value);
 };
 exports.optional = optional;
 /**
- * Common pattern validators for API responses
+ * Check if data looks like an API response (has `success` boolean).
+ * @since 1.0.0
  */
 const isApiResponse = (data) => {
     return (0, exports.isObject)(data) && (0, exports.isBoolean)(data.success);
@@ -92,7 +145,8 @@ const isErrorResponse = (data) => {
 };
 exports.isErrorResponse = isErrorResponse;
 /**
- * Date validation
+ * Check if a value is a string that parses to a valid date.
+ * @since 1.0.0
  */
 const isValidDate = (value) => {
     if (!(0, exports.isString)(value))
@@ -102,7 +156,8 @@ const isValidDate = (value) => {
 };
 exports.isValidDate = isValidDate;
 /**
- * Email validation (basic)
+ * Basic email format validation.
+ * @since 1.0.0
  */
 const isEmail = (value) => {
     if (!(0, exports.isString)(value))
@@ -112,7 +167,8 @@ const isEmail = (value) => {
 };
 exports.isEmail = isEmail;
 /**
- * URL validation (basic)
+ * Basic URL validation using the `URL` constructor.
+ * @since 1.0.0
  */
 const isUrl = (value) => {
     if (!(0, exports.isString)(value))
@@ -127,7 +183,21 @@ const isUrl = (value) => {
 };
 exports.isUrl = isUrl;
 /**
- * Creates a type assertion function that throws on invalid data
+ * Creates a type assertion function that throws `TypeError` on
+ * invalid data. Use with `createValidator` for the non-throwing variant.
+ *
+ * @template T - The asserted type
+ * @param validator - Type guard function
+ * @param typeName - Name used in error messages
+ * @returns An assertion function
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const assertString = createAssertion(isString, 'string');
+ * assertString('hello'); // passes
+ * assertString(42);      // throws TypeError
+ * ```
  */
 const createAssertion = (validator, typeName) => {
     return (data, context = typeName) => {
@@ -138,7 +208,20 @@ const createAssertion = (validator, typeName) => {
 };
 exports.createAssertion = createAssertion;
 /**
- * Safe JSON parsing with validation
+ * Safely parse a JSON string, optionally validating the result.
+ * Returns a {@link ValidationResult} instead of throwing.
+ *
+ * @template T - Expected parsed type
+ * @param jsonString - JSON string to parse
+ * @param validator - Optional type guard to validate the parsed result
+ * @returns Validation result with parsed data or error
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const result = parseJson('{"name":"Alice"}');
+ * if (result.isValid) console.log(result.data);
+ * ```
  */
 const parseJson = (jsonString, validator) => {
     try {

package/dist/utils/validation/type-validation.d.ts

@@ -7,32 +7,85 @@
 import type { ValidationResult, Optional } from '../../types/common';
 export type { ValidationResult };
 /**
- * Creates a validation function that safely checks if a value matches expected type
+ * Creates a validation function that safely checks if a value matches
+ * the expected type. Returns a {@link ValidationResult}.
+ *
+ * @template T - The validated type
+ * @param validationFn - Type guard function
+ * @param typeName - Name used in error messages
+ * @returns A function returning `ValidationResult<T>`
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const validateString = createValidator(isString, 'string');
+ * validateString('hi');  // { isValid: true, data: 'hi' }
+ * validateString(42);    // { isValid: false, error: 'Invalid string' }
+ * ```
  */
 export declare const createValidator: <T>(validationFn: (data: unknown) => data is T, typeName: string) => (data: unknown) => ValidationResult<T>;
 /**
- * Basic type validators
+ * Runtime type guard: checks if value is a `string`.
+ * @since 1.0.0
  */
 export declare const isString: (value: unknown) => value is string;
+/**
+ * Runtime type guard: checks if value is a finite `number` (excludes NaN).
+ * @since 1.0.0
+ */
 export declare const isNumber: (value: unknown) => value is number;
+/**
+ * Runtime type guard: checks if value is a `boolean`.
+ * @since 1.0.0
+ */
 export declare const isBoolean: (value: unknown) => value is boolean;
+/**
+ * Runtime type guard: checks if value is a non-null, non-array object.
+ * @since 1.0.0
+ */
 export declare const isObject: (value: unknown) => value is Record<string, unknown>;
+/**
+ * Runtime type guard: checks if value is an array.
+ * @since 1.0.0
+ */
 export declare const isArray: (value: unknown) => value is unknown[];
+/**
+ * Runtime type guard: checks if value is `null` or `undefined`.
+ * @since 1.0.0
+ */
 export declare const isNullish: (value: unknown) => value is null | undefined;
 /**
- * Validates that an object has required properties
+ * Validates that an object has all required properties present.
+ *
+ * @template T - Expected object shape
+ * @param obj - Value to check
+ * @param requiredProps - Array of required property keys
+ * @returns True if obj has all required properties
+ * @since 1.0.0
  */
 export declare const hasRequiredProperties: <T extends Record<string, unknown>>(obj: unknown, requiredProps: (keyof T)[]) => obj is T;
 /**
- * Validates array of objects with a validator function
+ * Validates that a value is an array where every item passes a validator.
+ *
+ * @template T - Expected item type
+ * @param data - Value to check
+ * @param itemValidator - Type guard for individual items
+ * @returns True if data is an array of T
+ * @since 1.0.0
  */
 export declare const validateArray: <T>(data: unknown, itemValidator: (item: unknown) => item is T) => data is T[];
 /**
- * Creates optional property validator
+ * Wraps a validator to also accept `undefined`.
+ *
+ * @template T - The validated type
+ * @param validator - Base type guard
+ * @returns Type guard that also accepts `undefined`
+ * @since 1.0.0
  */
 export declare const optional: <T>(validator: (value: unknown) => value is T) => (value: unknown) => value is T | undefined;
 /**
- * Common pattern validators for API responses
+ * Check if data looks like an API response (has `success` boolean).
+ * @since 1.0.0
  */
 export declare const isApiResponse: (data: unknown) => data is {
     success: boolean;
@@ -46,23 +99,53 @@ export declare const isErrorResponse: (data: unknown) => data is {
     error: string;
 };
 /**
- * Date validation
+ * Check if a value is a string that parses to a valid date.
+ * @since 1.0.0
  */
 export declare const isValidDate: (value: unknown) => value is string;
 /**
- * Email validation (basic)
+ * Basic email format validation.
+ * @since 1.0.0
  */
 export declare const isEmail: (value: unknown) => value is string;
 /**
- * URL validation (basic)
+ * Basic URL validation using the `URL` constructor.
+ * @since 1.0.0
  */
 export declare const isUrl: (value: unknown) => value is string;
 /**
- * Creates a type assertion function that throws on invalid data
+ * Creates a type assertion function that throws `TypeError` on
+ * invalid data. Use with `createValidator` for the non-throwing variant.
+ *
+ * @template T - The asserted type
+ * @param validator - Type guard function
+ * @param typeName - Name used in error messages
+ * @returns An assertion function
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const assertString = createAssertion(isString, 'string');
+ * assertString('hello'); // passes
+ * assertString(42);      // throws TypeError
+ * ```
  */
 export declare const createAssertion: <T>(validator: (data: unknown) => data is T, typeName: string) => (data: unknown, context?: string) => asserts data is T;
 /**
- * Safe JSON parsing with validation
+ * Safely parse a JSON string, optionally validating the result.
+ * Returns a {@link ValidationResult} instead of throwing.
+ *
+ * @template T - Expected parsed type
+ * @param jsonString - JSON string to parse
+ * @param validator - Optional type guard to validate the parsed result
+ * @returns Validation result with parsed data or error
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const result = parseJson('{"name":"Alice"}');
+ * if (result.isValid) console.log(result.data);
+ * ```
  */
 export declare const parseJson: <T>(jsonString: string, validator?: Optional<(data: unknown) => data is T>) => ValidationResult<T>;
 //# sourceMappingURL=type-validation.d.ts.map

package/dist/utils/validation/type-validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type-validation.d.ts","sourceRoot":"","sources":["../../../src/utils/validation/type-validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGrE,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAC/B,cAAc,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,EAC1C,UAAU,MAAM,MAER,MAAM,OAAO,KAAG,gBAAgB,CAAC,CAAC,CAc3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACxB,CAAC;AAE5B,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACP,CAAC;AAE7C,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OACxB,CAAC;AAE7B,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CACH,CAAC;AAEvE,eAAO,MAAM,OAAO,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAAO,EACnC,CAAC;AAEvB,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,IAAI,GAAG,SACpB,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,KAAK,OAAO,EACZ,eAAe,CAAC,MAAM,CAAC,CAAC,EAAE,KACzB,GAAG,IAAI,CAGT,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAC7B,MAAM,OAAO,EACb,eAAe,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,KAC1C,IAAI,IAAI,CAAC,EAGX,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,GAClB,CAAC,EAAE,WAAW,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,MAC5C,OAAO,OAAO,KAAG,KAAK,IAAI,CAAC,GAAG,SAE9B,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,OAAO,KAAG,IAAI,IAAI;IAAE,OAAO,EAAE,OAAO,CAAA;CAEvE,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,CAAC,EACjC,MAAM,OAAO,EACb,gBAAgB,QAAQ,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,KACvD,IAAI,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAMlC,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,MAAM,OAAO,KACZ,IAAI,IAAI;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAOzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAIrD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAIjD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAQ/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAC/B,WAAW,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,EACvC,UAAU,MAAM,MAER,MAAM,OAAO,EAAE,gBAAkB,KAAG,QAAQ,IAAI,IAAI,CAK7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EACzB,YAAY,MAAM,EAClB,YAAY,QAAQ,CAAC,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,KACjD,gBAAgB,CAAC,CAAC,CAqBpB,CAAC"}
+{"version":3,"file":"type-validation.d.ts","sourceRoot":"","sources":["../../../src/utils/validation/type-validation.ts"],"names":[],"mappings":"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"}