typetify 2.1.0 → 2.4.0

package/dist/chunk-EAUTTWTQ.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/input/index.ts","../src/input/safeJsonParse.ts","../src/input/safeJsonStringify.ts","../src/input/parseNumber.ts","../src/input/parseInteger.ts","../src/input/parseBoolean.ts","../src/input/parseDate.ts","../src/input/coerceString.ts","../src/input/coerceArray.ts","../src/input/trimAll.ts","../src/input/defaults.ts","../src/input/clamp.ts","../src/input/isEmail.ts","../src/input/isUrl.ts","../src/input/isUuid.ts","../src/input/isIpAddress.ts","../src/input/parseUrl.ts"],"names":[],"mappings":"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","file":"chunk-EAUTTWTQ.mjs","sourcesContent":["export { safeJsonParse } from './safeJsonParse'\nexport type { JsonParseResult } from './safeJsonParse'\nexport { safeJsonStringify } from './safeJsonStringify'\nexport type { JsonStringifyResult } from './safeJsonStringify'\nexport { parseNumber } from './parseNumber'\nexport { parseInteger } from './parseInteger'\nexport { parseBoolean } from './parseBoolean'\nexport { parseDate } from './parseDate'\nexport { coerceString } from './coerceString'\nexport { coerceArray } from './coerceArray'\nexport { trimAll } from './trimAll'\nexport { defaults } from './defaults'\nexport { clamp } from './clamp'\nexport { isEmail } from './isEmail'\nexport { isUrl } from './isUrl'\nexport { isUuid } from './isUuid'\nexport { isIpAddress } from './isIpAddress'\nexport { parseUrl } from './parseUrl'\n","import type { Result } from '../result/types'\nimport { ok } from '../result/ok'\nimport { err } from '../result/err'\n\n/**\n * @deprecated Use Result<T> instead\n */\nexport type JsonParseResult<T> = Result<T, Error>\n\n/**\n * Safely parses a JSON string. Returns a Result instead of throwing.\n *\n * @example\n * const result = safeJsonParse<User>('{\"name\": \"John\"}')\n * if (result.ok) {\n *   console.log(result.value.name)\n * } else {\n *   console.error(result.error)\n * }\n */\nexport function safeJsonParse<T = unknown>(json: string): Result<T, Error> {\n  try {\n    const data = JSON.parse(json) as T\n    return ok(data)\n  } catch (error) {\n    return err(error instanceof Error ? error : new Error(String(error)))\n  }\n}\n","import type { Result } from '../result/types'\nimport { ok } from '../result/ok'\nimport { err } from '../result/err'\n\n/**\n * @deprecated Use Result<string> instead\n */\nexport type JsonStringifyResult = Result<string, Error>\n\n/**\n * Safely stringifies a value to JSON. Returns a Result instead of throwing.\n * Handles circular references gracefully.\n *\n * @example\n * const result = safeJsonStringify({ name: 'John' })\n * if (result.ok) {\n *   console.log(result.value)\n * }\n */\nexport function safeJsonStringify(\n  value: unknown,\n  replacer?: (key: string, value: unknown) => unknown,\n  space?: string | number\n): Result<string, Error> {\n  try {\n    const data = JSON.stringify(value, replacer, space)\n    return ok(data)\n  } catch (error) {\n    return err(error instanceof Error ? error : new Error(String(error)))\n  }\n}\n","/**\n * Parses a value to a number. Returns undefined if parsing fails.\n * Handles strings, numbers, and null/undefined.\n *\n * @example\n * parseNumber('42') // 42\n * parseNumber('3.14') // 3.14\n * parseNumber('abc') // undefined\n * parseNumber(null) // undefined\n */\nexport function parseNumber(value: unknown): number | undefined {\n  if (value === null || value === undefined) {\n    return undefined\n  }\n\n  if (typeof value === 'number') {\n    return Number.isNaN(value) ? undefined : value\n  }\n\n  if (typeof value === 'string') {\n    const trimmed = value.trim()\n    if (trimmed === '') {\n      return undefined\n    }\n\n    const parsed = Number(trimmed)\n    return Number.isNaN(parsed) ? undefined : parsed\n  }\n\n  return undefined\n}\n","/**\n * Parses a value to an integer. Returns undefined if parsing fails.\n *\n * @example\n * parseInteger('42') // 42\n * parseInteger('3.14') // 3\n * parseInteger('abc') // undefined\n */\nexport function parseInteger(value: unknown): number | undefined {\n  if (value === null || value === undefined) {\n    return undefined\n  }\n\n  if (typeof value === 'number') {\n    return Number.isNaN(value) ? undefined : Math.trunc(value)\n  }\n\n  if (typeof value === 'string') {\n    const trimmed = value.trim()\n    if (trimmed === '') {\n      return undefined\n    }\n\n    const parsed = parseInt(trimmed, 10)\n    return Number.isNaN(parsed) ? undefined : parsed\n  }\n\n  return undefined\n}\n","/**\n * Parses a value to a boolean. Returns undefined if parsing fails.\n * Recognizes: true/false, 'true'/'false', '1'/'0', 1/0, 'yes'/'no', 'on'/'off'\n *\n * @example\n * parseBoolean('true') // true\n * parseBoolean('false') // false\n * parseBoolean(1) // true\n * parseBoolean('yes') // true\n * parseBoolean('maybe') // undefined\n */\nexport function parseBoolean(value: unknown): boolean | undefined {\n  if (value === null || value === undefined) {\n    return undefined\n  }\n\n  if (typeof value === 'boolean') {\n    return value\n  }\n\n  if (typeof value === 'number') {\n    if (value === 1) return true\n    if (value === 0) return false\n    return undefined\n  }\n\n  if (typeof value === 'string') {\n    const lower = value.toLowerCase().trim()\n\n    if (['true', '1', 'yes', 'on'].includes(lower)) {\n      return true\n    }\n\n    if (['false', '0', 'no', 'off'].includes(lower)) {\n      return false\n    }\n  }\n\n  return undefined\n}\n","/**\n * Parses a value to a Date. Returns undefined if parsing fails or date is invalid.\n *\n * @example\n * parseDate('2024-01-15') // Date object\n * parseDate(1705276800000) // Date object\n * parseDate('invalid') // undefined\n */\nexport function parseDate(value: unknown): Date | undefined {\n  if (value === null || value === undefined) {\n    return undefined\n  }\n\n  if (value instanceof Date) {\n    return Number.isNaN(value.getTime()) ? undefined : value\n  }\n\n  if (typeof value === 'number') {\n    const date = new Date(value)\n    return Number.isNaN(date.getTime()) ? undefined : date\n  }\n\n  if (typeof value === 'string') {\n    const trimmed = value.trim()\n    if (trimmed === '') {\n      return undefined\n    }\n\n    const date = new Date(trimmed)\n    return Number.isNaN(date.getTime()) ? undefined : date\n  }\n\n  return undefined\n}\n","/**\n * Coerces a value to a string. Returns empty string for null/undefined.\n *\n * @example\n * coerceString('hello') // 'hello'\n * coerceString(42) // '42'\n * coerceString(null) // ''\n * coerceString(undefined) // ''\n */\nexport function coerceString(value: unknown): string {\n  if (value === null || value === undefined) {\n    return ''\n  }\n\n  if (typeof value === 'string') {\n    return value\n  }\n\n  return String(value)\n}\n","/**\n * Coerces a value to an array.\n * - Arrays are returned as-is\n * - null/undefined returns empty array\n * - Other values are wrapped in an array\n *\n * @example\n * coerceArray([1, 2, 3]) // [1, 2, 3]\n * coerceArray('hello') // ['hello']\n * coerceArray(null) // []\n */\nexport function coerceArray<T>(value: T | readonly T[] | null | undefined): T[] {\n  if (value === null || value === undefined) {\n    return []\n  }\n\n  if (Array.isArray(value)) {\n    return [...value]\n  }\n\n  return [value as T]\n}\n","/**\n * Trims all string values in an object (shallow).\n *\n * @example\n * trimAll({ name: '  John  ', age: 30 })\n * // { name: 'John', age: 30 }\n */\nexport function trimAll<T extends Record<string, unknown>>(obj: T): T {\n  const result = { ...obj }\n\n  for (const key of Object.keys(result)) {\n    const value = result[key]\n    if (typeof value === 'string') {\n      ;(result as Record<string, unknown>)[key] = value.trim()\n    }\n  }\n\n  return result\n}\n","/**\n * Returns the value if defined, otherwise returns the default value.\n * Unlike the ?? operator, this also handles empty strings.\n *\n * @example\n * defaults(null, 'default') // 'default'\n * defaults(undefined, 'default') // 'default'\n * defaults('', 'default') // 'default'\n * defaults('value', 'default') // 'value'\n * defaults(0, 10) // 0 (0 is a valid value)\n */\nexport function defaults<T>(\n  value: T | null | undefined,\n  defaultValue: T,\n  options: { treatEmptyStringAsNull?: boolean } = {}\n): T {\n  const { treatEmptyStringAsNull = true } = options\n\n  if (value === null || value === undefined) {\n    return defaultValue\n  }\n\n  if (treatEmptyStringAsNull && value === '') {\n    return defaultValue\n  }\n\n  return value\n}\n","/**\n * Clamps a number between a minimum and maximum value.\n *\n * @example\n * clamp(5, 0, 10) // 5\n * clamp(-5, 0, 10) // 0\n * clamp(15, 0, 10) // 10\n */\nexport function clamp(value: number, min: number, max: number): number {\n  if (min > max) {\n    throw new Error('min must be less than or equal to max')\n  }\n\n  return Math.min(Math.max(value, min), max)\n}\n","/**\n * Checks if a string is a valid email address.\n *\n * @example\n * isEmail('user@example.com') // true\n * isEmail('invalid-email') // false\n */\nexport function isEmail(str: string): boolean {\n  const emailRegex = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/\n  return emailRegex.test(str)\n}\n","/**\n * Checks if a string is a valid URL.\n *\n * @example\n * isUrl('https://example.com') // true\n * isUrl('not-a-url') // false\n */\nexport function isUrl(str: string): boolean {\n  try {\n    new URL(str)\n    return true\n  } catch {\n    return false\n  }\n}\n","/**\n * Checks if a string is a valid UUID (v1-v5).\n *\n * @example\n * isUuid('550e8400-e29b-41d4-a716-446655440000') // true\n * isUuid('not-a-uuid') // false\n */\nexport function isUuid(str: string): boolean {\n  const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i\n  return uuidRegex.test(str)\n}\n","/**\n * Checks if a string is a valid IPv4 or IPv6 address.\n *\n * @example\n * isIpAddress('192.168.1.1') // true\n * isIpAddress('::1') // true\n * isIpAddress('not-an-ip') // false\n */\nexport function isIpAddress(str: string): boolean {\n  return isIpv4(str) || isIpv6(str)\n}\n\nfunction isIpv4(str: string): boolean {\n  const ipv4Regex = /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/\n  return ipv4Regex.test(str)\n}\n\nfunction isIpv6(str: string): boolean {\n  const ipv6Regex = /^(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}$|^::(?:[0-9a-fA-F]{1,4}:){0,6}[0-9a-fA-F]{1,4}$|^(?:[0-9a-fA-F]{1,4}:){1,7}:$|^(?:[0-9a-fA-F]{1,4}:){0,6}::(?:[0-9a-fA-F]{1,4}:){0,5}[0-9a-fA-F]{1,4}$/\n  return ipv6Regex.test(str)\n}\n","/**\n * Parses a URL string and returns a URL object, or undefined if invalid.\n *\n * @example\n * parseUrl('https://example.com/path') // URL object\n * parseUrl('not-a-url') // undefined\n */\nexport function parseUrl(str: string): URL | undefined {\n  try {\n    return new URL(str)\n  } catch {\n    return undefined\n  }\n}\n"]}