lifecycleion 0.0.1

package/dist/lib/event-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/strings.ts","../../src/lib/constants.ts","../../src/lib/padding-utils.ts","../../src/lib/ascii-tables/ascii-table-utils.ts","../../src/lib/ascii-tables/multi-column-ascii-table.ts","../../src/lib/ascii-tables/key-value-ascii-table.ts","../../src/lib/clamp.ts","../../src/lib/error-to-string.ts","../../src/lib/is-promise.ts","../../src/lib/is-function.ts","../../src/lib/safe-handle-callback.ts","../../src/lib/event-emitter.ts"],"sourcesContent":["import { removeEmptyStringsFromArray } from './arrays';\n\nexport function isString(value: unknown): value is string {\n  return typeof value === 'string';\n}\n\n/**\n * Converts a string or an array of strings to Pascal Case.\n *\n * This function takes an input string or an array of strings, each potentially containing hyphens,\n * and converts them to Pascal Case. It removes any characters that are not letters or numbers,\n * capitalizes the first letter of each substring, and ensures the rest of the substring\n * is in lowercase. Finally, it concatenates all these substrings to produce a Pascal Case\n * output.\n *\n * @param {string | string[]} input - The input string or array of strings to be converted to Pascal Case.\n * @returns {string} The converted string in Pascal Case.\n *\n * Examples:\n * toPascalCase(\"hello-world-123!$\") will return \"HelloWorld123\"\n * toPascalCase([\"hello\", \"world-123!$\"]) will return \"HelloWorld123\"\n */\n\nexport function toPascalCase(input: string | string[]): string {\n  // Ensure input is an array\n  const inputArray = Array.isArray(input) ? input : [input];\n\n  // Process each string in the array\n  const parts: string[] = [];\n\n  for (const item of inputArray) {\n    // Clean the string, split by hyphen, and remove empty strings\n    const cleanedItem = item.replace(/[^a-zA-Z0-9-]/g, '');\n    parts.push(...removeEmptyStringsFromArray(cleanedItem.split('-')));\n  }\n\n  // Process and rejoin the input strings\n  return parts\n    .map(\n      (subString) =>\n        subString.charAt(0).toUpperCase() + subString.slice(1).toLowerCase(),\n    )\n    .join('');\n}\n\n/**\n * Converts a string or an array of strings to Camel Case.\n *\n * This function takes an input string or an array of strings, each potentially containing hyphens,\n * and converts them to Camel Case. It removes any characters that are not letters or numbers,\n * capitalizes the first letter of each substring after the first one, and ensures the rest of the substring\n * is in lowercase. For the first substring, it ensures the entire substring is in lowercase.\n * Finally, it concatenates all these substrings to produce a Camel Case output.\n *\n * @param {string | string[]} input - The input string or array of strings to be converted to Camel Case.\n * @returns {string} The converted string in Camel Case.\n *\n * Examples:\n * toCamelCase(\"hello-world-123!$\") will return \"helloWorld123\"\n * toCamelCase([\"hello\", \"world-123!$\"]) will return \"helloWorld123\"\n */\n\nexport function toCamelCase(input: string | string[]): string {\n  // Ensure input is an array\n  const inputArray = Array.isArray(input) ? input : [input];\n\n  // Process each string in the array\n  const parts: string[] = [];\n\n  for (const item of inputArray) {\n    // Clean the string, split by hyphen, and remove empty strings\n    const cleanedItem = item.replace(/[^a-zA-Z0-9-]/g, '');\n    parts.push(...removeEmptyStringsFromArray(cleanedItem.split('-')));\n  }\n\n  // Process and rejoin the input strings\n  return parts\n    .map((subString, index) =>\n      index === 0\n        ? subString.toLowerCase()\n        : subString.charAt(0).toUpperCase() + subString.slice(1).toLowerCase(),\n    )\n    .join('');\n}\n\n/**\n * This method converts a string or an array of strings to camel case,\n * but if starting with a leading hyphen, it will convert to Pascal case.\n */\n\nexport function toCamelCaseWithPascalOverride(\n  input: string | string[],\n): string {\n  if (isString(input) && input.startsWith('-')) {\n    return toPascalCase(input);\n  } else if (\n    Array.isArray(input) &&\n    input.length > 0 &&\n    input[0].startsWith('-')\n  ) {\n    return toPascalCase(input);\n  } else {\n    return toCamelCase(input);\n  }\n}\n\n/**\n * Converts a string or an array of strings to constant case.\n *\n * The function takes a string or an array of strings, where each string can be separated by a '-',\n * and converts them into a constant case format (all uppercase with underscores between words).\n * It first cleans the input by removing non-alphanumeric characters (except for hyphens), splits the\n * string into parts on hyphens, and then joins these parts with underscores, converting the entire\n * result to uppercase.\n *\n * @param {string | string[]} input - The input string or array of strings to be converted.\n * @returns {string} The converted string in constant case.\n *\n * Example:\n * toConstantCase(\"hello-world\") will return \"HELLO_WORLD\"\n * toConstantCase([\"hello\", \"world\"]) will return \"HELLO_WORLD\"\n */\n\nexport function toConstantCase(input: string | string[]): string {\n  // Ensure input is an array\n  const inputArray = Array.isArray(input) ? input : [input];\n\n  // Process each string in the array\n  let parts: string[] = [];\n\n  for (const item of inputArray) {\n    // Clean the string and split by hyphen\n    const cleanedItem = item.replace(/[^a-zA-Z0-9-]/g, '');\n    parts.push(...cleanedItem.split('-'));\n  }\n\n  // Remove empty strings from the array\n  parts = removeEmptyStringsFromArray(parts);\n\n  // Join parts with underscore and convert to uppercase\n  return parts.join('_').toUpperCase();\n}\n\nexport function splitGraphemes(text: string): string[] {\n  const graphemes: string[] = [];\n  let grapheme = '';\n  let zwjSequence = '';\n\n  for (let i = 0; i < text.length; i++) {\n    const char = text[i];\n    const nextChar = text[i + 1] || '';\n    const code = char.charCodeAt(0);\n\n    // Handling combining marks and zero width joiner\n    if (\n      (code >= 0x0300 && code <= 0x036f) || // Combining Diacritical Marks\n      (code >= 0x1ab0 && code <= 0x1aff) || // Combining Diacritical Marks Extended\n      (code >= 0x1dc0 && code <= 0x1dff) || // Combining Diacritical Marks Supplement\n      (code >= 0xfe20 && code <= 0xfe2f) || // Combining Half Marks\n      (code >= 0x0e31 && code <= 0x0e3a) || // Thai combining marks\n      (code >= 0x0e47 && code <= 0x0e4e)\n    ) {\n      // Thai combining marks\n      grapheme += char;\n    } else if (char === '\\u200d') {\n      // Zero Width Joiner (ZWJ)\n      zwjSequence += grapheme + char;\n      grapheme = '';\n    } else {\n      if (grapheme) {\n        if (zwjSequence) {\n          graphemes.push(zwjSequence + grapheme);\n          zwjSequence = '';\n        } else {\n          graphemes.push(grapheme);\n        }\n      }\n      grapheme = char;\n\n      // Handle surrogate pairs (needed for certain characters including emojis)\n      if (\n        char >= '\\ud800' &&\n        char <= '\\udbff' &&\n        nextChar >= '\\udc00' &&\n        nextChar <= '\\udfff'\n      ) {\n        grapheme += nextChar;\n        i++;\n      }\n    }\n  }\n\n  if (grapheme) {\n    if (zwjSequence) {\n      graphemes.push(zwjSequence + grapheme);\n    } else {\n      graphemes.push(grapheme);\n    }\n  }\n\n  return graphemes;\n}\n\nexport function skipTrailingNewLines(str: string): string {\n  return str.replace(/\\n+$/, '');\n}\n\n/**\n * Filters a string to include only specified characters, optionally replacing disallowed characters.\n *\n * @param str - The input string to be filtered.\n * @param list - An array of allowed characters.\n * @param caseInsensitive - Optional. If true, the filtering is case-insensitive. Default is false.\n * @param replacementChar - Optional. Character to replace disallowed characters. If empty, disallowed characters are removed. Default is ''.\n * @returns A new string containing only the allowed characters from the input string, with disallowed characters optionally replaced.\n *\n * @example\n * // Case-sensitive usage, removing disallowed characters\n * characterAllowedOnly(\"Hello123!\", [\"H\", \"e\", \"l\", \"o\"]);\n * // Returns: \"Hello\"\n *\n * @example\n * // Case-insensitive usage, removing disallowed characters\n * characterAllowedOnly(\"Hello123!\", [\"h\", \"E\", \"L\", \"O\"], true);\n * // Returns: \"Hello\"\n *\n * @example\n * // Using replacement character\n * characterAllowedOnly(\"Hello123!\", [\"H\", \"e\", \"l\", \"o\"], false, \"-\");\n * // Returns: \"Hello---\"\n */\n\nexport function characterAllowedOnly(\n  str: string,\n  list: string[],\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  caseInsensitive = false,\n  replacementChar = '',\n): string {\n  let newStr = '';\n\n  // Convert the allowed list to lowercase if case-insensitive\n  if (caseInsensitive) {\n    list = Array.from(new Set(list.map((item) => item.toLowerCase())));\n  }\n\n  // Convert the entire input string to lowercase if case-insensitive\n  const processedStr = caseInsensitive ? str.toLowerCase() : str;\n\n  for (const c of processedStr) {\n    if (list.includes(c)) {\n      newStr += c;\n    } else if (replacementChar !== '') {\n      newStr += replacementChar;\n    }\n  }\n\n  return newStr;\n}\n\n// functions to chop characters from a string.\n\n/**\n * Will remove the matching first character from a string\n * @param str\n * @param char\n * @returns\n */\n\nexport function chopBeginningCharacter(str: string, char: string): string {\n  if (str.startsWith(char)) {\n    return str.slice(1);\n  } else {\n    return str;\n  }\n}\n\n/**\n * Will remove the matching last character from the string\n * @param str\n * @param char\n * @returns\n */\nexport function chopEndingCharacter(str: string, char: string): string {\n  if (str.endsWith(char)) {\n    return str.slice(0, -1);\n  } else {\n    return str;\n  }\n}\n\n/**\n * Will remove the matching character, from the beginning and/or end of the string if matching\n * @param str\n * @param char\n * @returns\n */\n\nexport function chopBothBeginningAndEndingCharacters(\n  str: string,\n  char: string,\n): string {\n  return chopBeginningCharacter(chopEndingCharacter(str, char), char);\n}\n","// prettier-ignore\nexport const BLANK_SPACE = ' ';\n\nexport const EOL = '\\n';\nexport const DOUBLE_EOL = EOL + EOL;\nexport const INDENT = ' '.repeat(4);\nexport const DOUBLE_INDENT = INDENT + INDENT;\n\n// prettier-ignore\nexport const SINGLE_QUOTE = \"'\";\n\n// similar to Python string library\nexport const ASCII_LOWERCASE = 'abcdefghijklmnopqrstuvwxyz';\nexport const ASCII_UPPERCASE = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';\nexport const ASCII_LETTERS = ASCII_LOWERCASE + ASCII_UPPERCASE;\nexport const DIGITS = '0123456789';\nexport const HEX_DIGITS = DIGITS + 'abcdefABCDEF';\nexport const OCT_DIGITS = '01234567';\nexport const PUNCTUATION = '!\"#$%&\\'()*+,-./:;<=>?@[\\\\]^_`{|}~';\nexport const WHITESPACE = ' \\t\\n\\r\\v\\f';\nexport const PRINTABLE = DIGITS + ASCII_LETTERS + PUNCTUATION + WHITESPACE;\n","/**\n * Utilities to pad strings with another string up to a defined length.\n * Each function takes a string, length to pad and the string to be used for padding (but defaults to a blank space if not provided) and returns the modified string\n *\n * This only pads on the left side, so text is added to the front until the total string equals the given length.\n *\n * ```typescript\n * padLeft('Hey', 6, '*'); // returns ***Hey\n * ```\n * @category String Padding\n */\n\nimport { BLANK_SPACE } from './constants';\n\nexport function padLeft(\n  str: string,\n  length: number,\n  padStr = BLANK_SPACE,\n): string {\n  return str.padStart(length, padStr);\n}\n\n/**\n * This only pads on the right side, so text is added to the end until the total string equals the given length.\n *\n * ```typescript\n * padRight('Hey', 6, '*'); // returns Hey***\n * ```\n *\n * @category String Padding\n */\n\nexport function padRight(\n  str: string,\n  length: number,\n  padStr = BLANK_SPACE,\n): string {\n  return str.padEnd(length, padStr);\n}\n\n/**\n * Same as `padCenterPreferLeft` and `padCenterPreferRight` but you can pass in a string with `left` or `right` before the padStr to use more direct.\n *\n * Defaults to `left`\n *\n * @category String Padding\n */\n\nexport function padCenter(\n  str: string,\n  length: number,\n  prefer: 'left' | 'right' = 'left',\n  padStr = BLANK_SPACE,\n): string {\n  const midStrLength = length - str.length;\n\n  if (midStrLength > 0) {\n    const padLeftAmount =\n      prefer === 'left'\n        ? Math.ceil(midStrLength / 2)\n        : Math.floor(midStrLength / 2);\n\n    const padRightAmount =\n      prefer === 'left'\n        ? Math.floor(midStrLength / 2)\n        : Math.ceil(midStrLength / 2);\n\n    return (\n      padLeft('', padLeftAmount, padStr) +\n      str +\n      padRight('', padRightAmount, padStr)\n    );\n  } else {\n    return str;\n  }\n}\n\n/**\n * It tries to pad equally on both sides in an attempt to center your text. However if it can't the extra character will be added to the left side\n *\n * @category String Padding\n */\n\nexport function padCenterPreferLeft(\n  str: string,\n  length: number,\n  padStr = BLANK_SPACE,\n): string {\n  return padCenter(str, length, 'left', padStr);\n}\n\n/**\n * It tries to pad equally, but if it can't the extra character will be added to the right side\n *\n * @category String Padding\n */\n\nexport function padCenterPreferRight(\n  str: string,\n  length: number,\n  padStr = BLANK_SPACE,\n): string {\n  return padCenter(str, length, 'right', padStr);\n}\n","import { padCenterPreferRight, padRight } from '../padding-utils';\nimport stringWidth from 'string-width';\nimport { splitGraphemes } from '../strings';\n\nexport class ASCIITableUtils {\n  public static centerText(text: string, width: number): string {\n    return padCenterPreferRight(text, width, ' ');\n  }\n\n  public static createSeparator(\n    columnWidths: number[],\n    character: string = '=',\n  ): string {\n    const totalWidth =\n      columnWidths.reduce((sum, width) => sum + width + 3, 0) - 1;\n\n    return `+${padRight('', totalWidth, character)}+`;\n  }\n\n  public static wrapText(text: string, maxLength: number): string[] {\n    const words = text.split(' ');\n    const lines: string[] = [];\n    let currentLine = '';\n\n    for (const word of words) {\n      if (stringWidth(currentLine) + stringWidth(word) + 1 <= maxLength) {\n        currentLine += (currentLine ? ' ' : '') + word;\n      } else {\n        if (currentLine) {\n          lines.push(currentLine);\n        }\n\n        if (stringWidth(word) <= maxLength) {\n          currentLine = word;\n        } else {\n          const subWords = ASCIITableUtils.splitWord(word, maxLength);\n          lines.push(...subWords.slice(0, -1));\n          currentLine = subWords[subWords.length - 1];\n        }\n      }\n    }\n\n    if (currentLine) {\n      lines.push(currentLine);\n    }\n\n    return lines;\n  }\n\n  public static splitWord(word: string, maxLength: number): string[] {\n    const graphemes = splitGraphemes(word);\n    const subWords: string[] = [];\n    let currentSubWord = '';\n\n    for (const grapheme of graphemes) {\n      if (stringWidth(currentSubWord + grapheme) <= maxLength) {\n        currentSubWord += grapheme;\n      } else {\n        subWords.push(currentSubWord);\n        currentSubWord = grapheme;\n      }\n    }\n\n    if (currentSubWord) {\n      subWords.push(currentSubWord);\n    }\n\n    return subWords;\n  }\n}\n","import { ASCIITableUtils } from './ascii-table-utils';\nimport stringWidth from 'string-width';\n\ninterface MultiColumnASCIITableOptions {\n  tableWidth?: number;\n  emptyMessage?: string;\n  widthMode?: 'flex' | 'fixed';\n}\n\nexport class MultiColumnASCIITable {\n  private headers: string[];\n  private rows: string[][];\n  private tableWidth: number;\n  private emptyMessage: string;\n  private widthMode: 'flex' | 'fixed';\n\n  constructor(headers: string[], options: MultiColumnASCIITableOptions = {}) {\n    this.headers = headers;\n    this.rows = [];\n    this.tableWidth = options.tableWidth || 80;\n    this.emptyMessage = options.emptyMessage || '';\n    this.widthMode = options.widthMode || 'flex';\n\n    const minTableWidth = this.getMinimumWidth();\n\n    if (this.tableWidth < minTableWidth) {\n      throw new Error(\n        `Table width must be at least ${minTableWidth} to accommodate the headers.`,\n      );\n    }\n  }\n\n  public getMinimumWidth(): number {\n    return this.headers.length * 4 + 1;\n  }\n\n  public addRow(row: string[]): void {\n    if (row.length !== this.headers.length) {\n      throw new Error(\n        `Number of values in the row (${row.length}) must match the number of headers (${this.headers.length}).`,\n      );\n    }\n\n    this.rows.push(row);\n  }\n\n  public toString(options: MultiColumnASCIITableOptions = {}): string {\n    const tableWidth = options.tableWidth || this.tableWidth;\n    const emptyMessage = options.emptyMessage || this.emptyMessage;\n\n    if (this.rows.length === 0) {\n      const emptyTableWidth = Math.min(tableWidth, 40);\n\n      const separator = '+' + '-'.repeat(emptyTableWidth - 2) + '+';\n      const emptyMessageLines = ASCIITableUtils.wrapText(\n        emptyMessage,\n        emptyTableWidth - 4,\n      );\n\n      const emptyRows = emptyMessageLines.map((line) => {\n        const paddingLeft = ' '.repeat(\n          Math.floor((emptyTableWidth - stringWidth(line) - 4) / 2),\n        );\n\n        const paddingRight = ' '.repeat(\n          Math.ceil((emptyTableWidth - stringWidth(line) - 4) / 2),\n        );\n\n        return `| ${paddingLeft}${line}${paddingRight} |`;\n      });\n\n      if (emptyRows.length === 0) {\n        emptyRows.push(`| ${' '.repeat(emptyTableWidth - 4)} |`);\n      }\n\n      return [separator, ...emptyRows, separator].join('\\n');\n    }\n\n    const columnWidths = this.calculateColumnWidths(options);\n\n    const headerSeparator = ASCIITableUtils.createSeparator(columnWidths);\n    const rowSeparator = ASCIITableUtils.createSeparator(columnWidths, '-');\n    let tableString = headerSeparator + '\\n';\n\n    const header = this.renderRow(this.headers, columnWidths);\n    tableString += header + '\\n' + rowSeparator + '\\n';\n\n    const rows = this.rows.map((row) => {\n      return this.renderRow(row, columnWidths);\n    });\n\n    tableString += rows.join('\\n' + rowSeparator + '\\n');\n    tableString += '\\n' + headerSeparator;\n\n    return tableString;\n  }\n\n  public calculateColumnWidths(\n    options: MultiColumnASCIITableOptions = {},\n  ): number[] {\n    const tableWidth = options.tableWidth || this.tableWidth;\n    const widthMode = options.widthMode || this.widthMode;\n\n    const numColumns = this.headers.length;\n\n    if (widthMode === 'fixed') {\n      const availableWidth = tableWidth - (numColumns + 1) * 3 + 1;\n      const columnWidth = Math.floor(availableWidth / numColumns);\n      const extraWidth = availableWidth % numColumns;\n      const columnWidths = new Array(numColumns).fill(columnWidth);\n\n      // if there is any remaining width (extraWidth), we distribute it evenly among the columns starting from the first column.\n      for (let i = 0; i < extraWidth; i++) {\n        columnWidths[i] += 1;\n      }\n\n      return columnWidths as number[];\n    }\n\n    const availableWidth = tableWidth - (numColumns + 1) * 3 + 1;\n    const maxColumnWidth = Math.floor(availableWidth / numColumns);\n    const totalContentWidth = this.headers.reduce(\n      (sum, header) => sum + stringWidth(header),\n      0,\n    );\n\n    if (availableWidth >= totalContentWidth) {\n      const remainingWidth = availableWidth - totalContentWidth;\n      const extraCharWidth = Math.floor(remainingWidth / numColumns);\n      const extraCharRemainder = remainingWidth % numColumns;\n\n      const columnWidths = this.headers.map((header, index) => {\n        const extraWidth = index < extraCharRemainder ? 1 : 0;\n        return stringWidth(header) + extraCharWidth + extraWidth;\n      });\n\n      return columnWidths;\n    } else {\n      const columnWidths = this.headers.map(() => maxColumnWidth);\n\n      return columnWidths;\n    }\n  }\n\n  private renderRow(row: string[], columnWidths: number[]): string {\n    const wrappedCells = row.map((value, index) => {\n      const wrappedLines = ASCIITableUtils.wrapText(value, columnWidths[index]);\n\n      return wrappedLines\n        .map((line) => line.padEnd(columnWidths[index]))\n        .join('\\n');\n    });\n\n    const maxLines = Math.max(\n      ...wrappedCells.map((cell) => cell.split('\\n').length),\n    );\n\n    const paddedRows = [];\n\n    for (let i = 0; i < maxLines; i++) {\n      const rowLine = wrappedCells.map((cell, index) => {\n        const cellLines = cell.split('\\n');\n        const cellLine = cellLines[i] || '';\n        const padding = ' '.repeat(columnWidths[index] - stringWidth(cellLine));\n\n        return ' ' + cellLine + padding + ' ';\n      });\n\n      paddedRows.push('|' + rowLine.join('|') + '|');\n    }\n\n    return paddedRows.join('\\n');\n  }\n}\n","import { isString } from '../strings';\nimport { padRight } from '../padding-utils';\nimport { MultiColumnASCIITable } from './multi-column-ascii-table';\nimport { ASCIITableUtils } from './ascii-table-utils';\nimport stringWidth from 'string-width';\nimport { clamp } from '../clamp';\n\nexport type TableRowValue =\n  | string\n  | number\n  | boolean\n  | null\n  | undefined\n  | KeyValueASCIITable\n  | MultiColumnASCIITable\n  | NestedKeyValueEntry[];\n\ntype TableRow = TableRowRegular | TableRowOwn;\n\ninterface TableRowRegular {\n  kind: 'regular';\n  key: string;\n  value: TableRowValue;\n}\n\ninterface TableRowOwn {\n  kind: 'own';\n  key: string;\n  value: string | NestedKeyValueEntry[];\n}\n\nexport interface NestedKeyValueEntry {\n  key: string;\n  value: string | KeyValueASCIITable | NestedKeyValueEntry[];\n}\n\ninterface KeyValueASCIITableOptions {\n  tableWidth?: number;\n  autoAdjustWidthWhenPossible?: boolean;\n  emptyMessage?: string;\n}\n\nexport class KeyValueASCIITable {\n  public readonly tableWidth: number;\n  private emptyMessage: string;\n  private autoAdjustWidthWhenPossible: boolean = true;\n\n  private rows: TableRow[] = [];\n\n  constructor(options: KeyValueASCIITableOptions = {}) {\n    const minTableWidth = this.getMinimumWidth();\n\n    if (options.tableWidth && options.tableWidth < minTableWidth) {\n      throw new Error(\n        `Table width must be at least ${minTableWidth} to accommodate the table structure.`,\n      );\n    }\n\n    this.tableWidth = options.tableWidth || 80;\n    this.autoAdjustWidthWhenPossible =\n      options.autoAdjustWidthWhenPossible ?? true;\n    this.emptyMessage = options.emptyMessage || '';\n  }\n\n  public getMinimumWidth(): number {\n    // The minimum width for the KeyValueASCIITable is 9 characters:\n    // - 2 character for the '| ' at the start\n    // - 1 character for the minimum key column width\n    // - 3 character for the ' | ' separating the key and value columns\n    // - 1 character for the minimum value column width\n    // - 2 character for the ' |' at the end\n\n    return 9;\n  }\n\n  /**\n   * Adds key and value to the table but placing the value on its own row.\n   *\n   * @param key\n   * @param value\n   */\n\n  public addValueOnSeparateRow(key: string, value: string): void {\n    const row: TableRow = { kind: 'own', key, value };\n\n    this.rows.push(row);\n  }\n\n  /**\n   * Adds key and value to the table.\n   *\n   * If provided value is an instance of ASCIITable or MultiColumnASCIITable, it will be rendered as a nested table on its own row for readability.\n   *\n   * @param key\n   * @param value\n   */\n\n  public addRow(key: string, value: TableRowValue): void {\n    const row: TableRow = { kind: 'regular', key, value };\n\n    this.rows.push(row);\n  }\n\n  public toString(options: KeyValueASCIITableOptions = {}): string {\n    const tableWidth = options.tableWidth || this.tableWidth;\n    const canAutoAdjustWidthWhenPossible =\n      options.autoAdjustWidthWhenPossible ?? this.autoAdjustWidthWhenPossible;\n\n    const emptyMessage = options.emptyMessage || this.emptyMessage;\n\n    if (this.rows.length === 0) {\n      const emptyTableWidth = Math.min(tableWidth, 40);\n\n      const separator = '+' + '-'.repeat(emptyTableWidth - 2) + '+';\n      const emptyMessageLines = ASCIITableUtils.wrapText(\n        emptyMessage,\n        emptyTableWidth - 4,\n      );\n\n      const emptyRows = emptyMessageLines.map((line) => {\n        const paddingLeft = padRight(\n          '',\n          Math.floor((emptyTableWidth - stringWidth(line) - 4) / 2),\n          ' ',\n        );\n\n        const paddingRight = padRight(\n          '',\n          Math.ceil((emptyTableWidth - stringWidth(line) - 4) / 2),\n          ' ',\n        );\n\n        return `| ${paddingLeft}${line}${paddingRight} |`;\n      });\n\n      if (emptyRows.length === 0) {\n        emptyRows.push(`| ${' '.repeat(emptyTableWidth - 4)} |`);\n      }\n\n      return [separator, ...emptyRows, separator].join('\\n');\n    }\n\n    const columnWidths = this.calculateColumnWidths(options);\n\n    const headerSeparator = ASCIITableUtils.createSeparator(columnWidths);\n    const rowSeparator = ASCIITableUtils.createSeparator(columnWidths, '-');\n\n    let tableString = headerSeparator + '\\n';\n\n    for (const [rowIndex, row] of this.rows.entries()) {\n      const { kind, key, value } = row;\n\n      if (\n        kind === 'own' ||\n        value instanceof KeyValueASCIITable ||\n        value instanceof MultiColumnASCIITable ||\n        Array.isArray(value)\n      ) {\n        const keyString = ASCIITableUtils.centerText(\n          key,\n          columnWidths[0] + columnWidths[1] + 3,\n        );\n\n        tableString += `| ${keyString} |\\n`;\n        tableString += rowSeparator + '\\n';\n\n        let valueString = '';\n\n        if (value instanceof KeyValueASCIITable) {\n          valueString = this.formatValue(\n            value,\n            tableWidth - 4,\n            canAutoAdjustWidthWhenPossible,\n            '',\n          );\n        } else if (value instanceof MultiColumnASCIITable) {\n          valueString = this.formatValue(\n            value,\n            tableWidth - 4,\n            canAutoAdjustWidthWhenPossible,\n            '',\n          );\n        } else if (Array.isArray(value)) {\n          valueString = this.formatValue(\n            value,\n            tableWidth - 4,\n            canAutoAdjustWidthWhenPossible,\n            '',\n          );\n        } else if (row.kind === 'own') {\n          valueString = this.formatTableRowOnOwnRow(\n            value as string,\n            tableWidth - 4,\n            tableWidth,\n          );\n        }\n\n        const valueLines = valueString.split('\\n');\n        const paddedValueLines = valueLines.map((line) => {\n          const padding = padRight('', tableWidth - stringWidth(line) - 4, ' ');\n\n          return `| ${line}${padding} |`;\n        });\n\n        tableString += paddedValueLines.join('\\n') + '\\n';\n        tableString += headerSeparator + '\\n';\n      } else {\n        const keyLines = ASCIITableUtils.wrapText(key, columnWidths[0]);\n\n        const valueLines = ASCIITableUtils.wrapText(\n          this.formatValue(\n            value,\n            columnWidths[1],\n            canAutoAdjustWidthWhenPossible,\n            '',\n          ),\n          columnWidths[1],\n        );\n\n        const maxLines = Math.max(keyLines.length, valueLines.length);\n\n        for (let i = 0; i < maxLines; i++) {\n          const keyLine = keyLines[i] || '';\n          const valueLine = valueLines[i] || '';\n\n          const keyPadding = ' '.repeat(columnWidths[0] - stringWidth(keyLine));\n\n          const valuePadding = ' '.repeat(\n            columnWidths[1] - stringWidth(valueLine),\n          );\n\n          tableString += `| ${keyLine}${keyPadding} | ${valueLine}${valuePadding} |\\n`;\n\n          if (i === maxLines - 1) {\n            if (rowIndex === this.rows.length - 1) {\n              tableString += headerSeparator + '\\n';\n            } else {\n              tableString += rowSeparator + '\\n';\n            }\n          }\n        }\n      }\n    }\n\n    return tableString.trim();\n  }\n\n  private calculateColumnWidths(\n    options: KeyValueASCIITableOptions = {},\n  ): number[] {\n    const tableWidth = options.tableWidth || this.tableWidth;\n    const canAutoAdjustWidthWhenPossible =\n      options.autoAdjustWidthWhenPossible ?? this.autoAdjustWidthWhenPossible;\n\n    const columnWidths: number[] = [0, 0];\n\n    for (const row of this.rows) {\n      const { key, value } = row;\n\n      const keyWidth = stringWidth(key);\n      const maxKeyWidth = Math.floor((tableWidth - 7) / 2);\n\n      if (keyWidth > columnWidths[0]) {\n        columnWidths[0] = Math.min(keyWidth, maxKeyWidth);\n        columnWidths[1] = Math.max(0, tableWidth - columnWidths[0] - 7);\n      }\n\n      if (typeof value === 'string') {\n        const valueWidth = Math.max(\n          ...value.split('\\n').map((line) => stringWidth(line)),\n        );\n\n        if (valueWidth > columnWidths[1]) {\n          columnWidths[1] = Math.min(\n            valueWidth,\n            tableWidth - columnWidths[0] - 7,\n          );\n\n          columnWidths[0] = Math.max(0, tableWidth - columnWidths[1] - 7);\n        }\n      } else if (row.kind === 'own') {\n        let valueWidth = 0;\n\n        if (isString(value)) {\n          valueWidth = Math.max(\n            ...value.split('\\n').map((line) => stringWidth(line)),\n          );\n        }\n\n        if (valueWidth > columnWidths[1]) {\n          columnWidths[1] = Math.min(\n            valueWidth,\n            tableWidth - columnWidths[0] - 7,\n          );\n\n          columnWidths[0] = Math.max(0, tableWidth - columnWidths[1] - 7);\n        }\n      } else if (value instanceof KeyValueASCIITable) {\n        // Update column widths based on the nested table\n        let nestedTableColumnWidths: number[] = [];\n\n        if (canAutoAdjustWidthWhenPossible) {\n          const minWidth = value.getMinimumWidth();\n\n          const availableWidth = tableWidth - columnWidths[0] - 7;\n          const adjustedWidth = clamp(availableWidth, minWidth, availableWidth);\n\n          nestedTableColumnWidths = value.calculateColumnWidths({\n            tableWidth: adjustedWidth,\n          });\n        } else {\n          nestedTableColumnWidths = value.calculateColumnWidths();\n        }\n\n        const nestedTableWidth =\n          nestedTableColumnWidths.reduce((sum, width) => sum + width, 0) +\n          nestedTableColumnWidths.length * 3 -\n          1;\n\n        const availableWidth = tableWidth - columnWidths[0] - 7;\n\n        if (nestedTableWidth > availableWidth) {\n          columnWidths[1] = availableWidth;\n        } else {\n          columnWidths[1] = Math.max(columnWidths[1], nestedTableWidth);\n        }\n      } else if (value instanceof MultiColumnASCIITable) {\n        // Update column widths based on the nested multi-column table\n        let nestedTableColumnWidths: number[] = [];\n\n        if (canAutoAdjustWidthWhenPossible) {\n          const minWidth = value.getMinimumWidth();\n\n          const availableWidth = tableWidth - columnWidths[0] - 7;\n          const adjustedWidth = clamp(availableWidth, minWidth, availableWidth);\n\n          nestedTableColumnWidths = value.calculateColumnWidths({\n            tableWidth: adjustedWidth,\n          });\n        } else {\n          nestedTableColumnWidths = value.calculateColumnWidths();\n        }\n\n        const nestedTableWidth =\n          nestedTableColumnWidths.reduce((sum, width) => sum + width, 0) +\n          nestedTableColumnWidths.length * 3 -\n          1;\n\n        const availableWidth = tableWidth - columnWidths[0] - 7;\n\n        if (nestedTableWidth > availableWidth) {\n          columnWidths[1] = availableWidth;\n        } else {\n          columnWidths[1] = Math.max(columnWidths[1], nestedTableWidth);\n        }\n      } else if (Array.isArray(value)) {\n        for (const nestedCell of value) {\n          const nestedKeyWidth = stringWidth(nestedCell.key);\n          const maxNestedKeyWidth = Math.floor((tableWidth - 7) / 2);\n\n          if (nestedKeyWidth > columnWidths[0]) {\n            columnWidths[0] = Math.min(nestedKeyWidth, maxNestedKeyWidth);\n            columnWidths[1] = Math.max(0, tableWidth - columnWidths[0] - 7);\n          }\n\n          if (typeof nestedCell.value === 'string') {\n            const nestedValueWidth = Math.max(\n              ...nestedCell.value.split('\\n').map((line) => stringWidth(line)),\n            );\n\n            if (nestedValueWidth > columnWidths[1]) {\n              columnWidths[1] = Math.min(\n                nestedValueWidth,\n                tableWidth - columnWidths[0] - 7,\n              );\n              columnWidths[0] = Math.max(0, tableWidth - columnWidths[1] - 7);\n            }\n          }\n        }\n      }\n    }\n\n    return columnWidths;\n  }\n\n  private formatValue(\n    value:\n      | string\n      | number\n      | boolean\n      | null\n      | undefined\n      | KeyValueASCIITable\n      | MultiColumnASCIITable\n      | NestedKeyValueEntry[],\n    cellWidth: number,\n    canAutoAdjustWidthWhenPossible: boolean,\n    indent = '',\n  ): string {\n    if (typeof value === 'string') {\n      return value;\n    } else if (typeof value === 'number') {\n      return String(value);\n    } else if (typeof value === 'boolean') {\n      return String(value);\n    } else if (value === null) {\n      return 'null';\n    } else if (value === undefined) {\n      return 'undefined';\n    } else if (value instanceof KeyValueASCIITable) {\n      let nestedTableLines: string[];\n\n      if (canAutoAdjustWidthWhenPossible) {\n        const minWidth = value.getMinimumWidth();\n\n        const adjustedWidth = clamp(cellWidth, minWidth, cellWidth);\n\n        nestedTableLines = value\n          .toString({ tableWidth: adjustedWidth })\n          .split('\\n');\n      } else {\n        nestedTableLines = value.toString().split('\\n');\n      }\n\n      const indentedLines = nestedTableLines.map((line) => `${indent}${line}`);\n\n      return indentedLines.join('\\n');\n    } else if (value instanceof MultiColumnASCIITable) {\n      let nestedTableLines: string[];\n\n      if (canAutoAdjustWidthWhenPossible) {\n        const minWidth = value.getMinimumWidth();\n\n        const adjustedWidth = clamp(cellWidth, minWidth, cellWidth);\n        nestedTableLines = value\n          .toString({ tableWidth: adjustedWidth })\n          .split('\\n');\n      } else {\n        nestedTableLines = value.toString().split('\\n');\n      }\n\n      const indentedLines = nestedTableLines.map((line) => `${indent}${line}`);\n\n      return indentedLines.join('\\n');\n    } else if (Array.isArray(value)) {\n      const nestedValueLines: string[] = [];\n\n      for (const { key, value: nestedValue } of value) {\n        const formattedKey = `${indent}${key}:`;\n        const formattedValue = this.formatValue(\n          nestedValue,\n          cellWidth - indent.length - stringWidth(key) - 2,\n          canAutoAdjustWidthWhenPossible,\n          `${indent}`,\n        );\n\n        const wrappedSpacer = padRight('', 4, ' ');\n\n        const wrappedValue = formattedValue\n          .split('\\n')\n          .map((line) => `${indent}${wrappedSpacer}${line}`);\n\n        nestedValueLines.push(formattedKey);\n        nestedValueLines.push(...wrappedValue);\n        nestedValueLines.push('');\n      }\n\n      return nestedValueLines.slice(0, -1).join('\\n');\n    } else {\n      throw new TypeError('Invalid value type provided');\n    }\n  }\n\n  private formatTableRowOnOwnRow(\n    value: string,\n    width: number,\n    maxRowLength: number,\n  ): string {\n    const lines = value.split('\\n');\n\n    const paddedLines = lines.map((line) => {\n      const wrappedLines = ASCIITableUtils.wrapText(line, maxRowLength - 4);\n\n      return wrappedLines\n        .map((wrappedLine) => {\n          const padding = padRight(\n            '',\n            width - stringWidth(wrappedLine) - 2,\n            ' ',\n          );\n\n          return `${wrappedLine}${padding}`;\n        })\n        .join('\\n');\n    });\n\n    return paddedLines.join('\\n');\n  }\n}\n","export function clamp(value: number, min: number, max: number): number {\n  return Math.max(min, Math.min(value, max));\n}\n\n/**\n * Clamps a value to a minimum, returning a default if the value is not finite or is undefined/null.\n *\n * Useful for config/settings validation where you want to:\n * - Enforce a minimum value\n * - Handle invalid inputs (Infinity, NaN, undefined, null) gracefully\n *\n * @param value - The value to clamp (can be undefined or null)\n * @param min - The minimum allowed value\n * @param defaultValue - The default to return if value is not finite or is undefined/null\n * @returns The clamped value, or defaultValue if value is not finite/undefined/null\n *\n * @example\n * ```typescript\n * finiteClampMin(5000, 1000, 3000) // 5000 (value > min)\n * finiteClampMin(500, 1000, 3000)  // 1000 (enforces min)\n * finiteClampMin(Infinity, 1000, 3000) // 3000 (not finite, use default)\n * finiteClampMin(NaN, 1000, 3000)      // 3000 (not finite, use default)\n * finiteClampMin(undefined, 1000, 3000) // 3000 (undefined, use default)\n * finiteClampMin(null, 1000, 3000)      // 3000 (null, use default)\n * ```\n */\nexport function finiteClampMin(\n  value: number | undefined | null,\n  min: number,\n  defaultValue: number,\n): number {\n  if (value === null || value === undefined || !Number.isFinite(value)) {\n    return defaultValue;\n  }\n\n  return Math.max(value, min);\n}\n","import type { NestedKeyValueEntry } from './ascii-tables/key-value-ascii-table';\nimport { KeyValueASCIITable } from './ascii-tables/key-value-ascii-table';\n\nfunction safeStringify(value: unknown): string {\n  if (value === null || value === undefined) {\n    return String(value);\n  }\n\n  switch (typeof value) {\n    case 'string':\n      return value;\n    case 'number':\n    case 'boolean':\n    case 'bigint':\n      return String(value);\n    case 'object':\n      return JSON.stringify(value);\n    case 'function':\n      return '[Function]';\n    case 'symbol':\n      return value.toString();\n    default:\n      // This should never happen, but satisfy the linter\n      return String(value as string | number | boolean);\n  }\n}\n\nexport function errorToString(error: unknown, maxRowLength = 80): string {\n  const table = errorToASCIITable(error, maxRowLength);\n\n  return table.toString();\n}\n\nfunction errorToASCIITable(\n  error: unknown,\n  maxRowLength: number,\n): KeyValueASCIITable {\n  const table = new KeyValueASCIITable({\n    tableWidth: maxRowLength,\n    autoAdjustWidthWhenPossible: true,\n  });\n\n  if (error && typeof error === 'object') {\n    const err = error as Record<string, unknown>;\n    table.addRow('Key', 'Value');\n\n    if (err['message']) {\n      table.addRow('Message', safeStringify(err['message']));\n    }\n\n    if (err['name']) {\n      table.addRow('Name', safeStringify(err['name']));\n    }\n\n    if (err['code']) {\n      table.addRow('Code', safeStringify(err['code']));\n    }\n\n    if (err['errno']) {\n      table.addRow('Errno', safeStringify(err['errno']));\n    }\n\n    // other conventional that might be used to enhance the error object\n    if (err['errPrefix']) {\n      table.addRow('Prefix', safeStringify(err['errPrefix']));\n    }\n\n    if (err['errType']) {\n      table.addRow('errType', safeStringify(err['errType']));\n    }\n\n    if (err['errCode']) {\n      table.addRow('errCode', safeStringify(err['errCode']));\n    }\n\n    if (err['additionalInfo']) {\n      const additionalInfo = err['additionalInfo'] as Record<string, unknown>;\n      const sensitiveFieldNames =\n        (err['sensitiveFieldNames'] as string[]) || [];\n\n      for (const key in additionalInfo) {\n        if (sensitiveFieldNames.includes(key)) {\n          table.addRow(`AdditionalInfo.${key}`, '***');\n        } else {\n          const value = additionalInfo[key];\n\n          table.addRow(\n            `AdditionalInfo.${key}`,\n            stringifyValue(value, table, maxRowLength),\n          );\n        }\n      }\n    }\n\n    if (err['stack']) {\n      table.addValueOnSeparateRow('Stack', safeStringify(err['stack']));\n    }\n  }\n\n  return table;\n}\n\nfunction stringifyValue(\n  value: unknown,\n  table: KeyValueASCIITable,\n  maxRowLength: number,\n): string | KeyValueASCIITable | NestedKeyValueEntry[] {\n  if (typeof value === 'string') {\n    return value;\n  } else if (Array.isArray(value)) {\n    // Handle arrays differently\n    return value\n      .map((item) => {\n        const result = stringifyValue(item, table, maxRowLength);\n        // Convert complex types to strings for joining\n        if (typeof result === 'string') {\n          return result;\n        } else if (result instanceof KeyValueASCIITable) {\n          return result.toString();\n        } else {\n          return JSON.stringify(result);\n        }\n      })\n      .join(', ');\n  } else if (typeof value === 'object' && value !== null) {\n    if (value instanceof Error) {\n      return errorToASCIITable(value, maxRowLength - 4);\n    } else {\n      // Handle objects differently\n      const entries: NestedKeyValueEntry[] = Object.entries(value).map(\n        ([key, val]) => ({\n          key,\n          value: stringifyValue(val, table, maxRowLength - 4),\n        }),\n      );\n\n      return entries;\n    }\n  } else {\n    return String(value);\n  }\n}\n","// Helper from https://github.com/then/is-promise/tree/master\n// For some reason the @types/is-promise package stopped being picked up on\n\nexport function isPromise(obj: unknown): obj is Promise<unknown> {\n  return (\n    !!obj &&\n    (typeof obj === 'object' || typeof obj === 'function') &&\n    // @ts-expect-error - obj is checked to be object/function, then property access works at runtime\n    typeof obj['then'] === 'function'\n  );\n}\n","export function isFunction(value: unknown): boolean {\n  return typeof value === 'function' || value instanceof Function;\n}\n","import { errorToString } from './error-to-string';\nimport { isPromise } from './is-promise';\nimport { isFunction } from './is-function';\nimport { DOUBLE_EOL } from './constants';\n\n/**\n * Safely handles a callback function by catching any errors and reporting them\n * using the global `reportError` event (standard API available in Node.js 15+, Bun, Deno, and browsers).\n * This function can seamlessly handle both synchronous and asynchronous (Promise-based) callback functions.\n *\n * Errors are dispatched as ErrorEvent objects with type 'reportError' via `globalThis.dispatchEvent()`.\n * You can listen for these errors using `globalThis.addEventListener('reportError', handler)`.\n *\n * This function is a \"fire-and-forget\" type of function, meaning it doesn't wait\n * for the callback to complete and doesn't return any result or error. If you need\n * to handle the result or error of the callback, consider using the\n * `safeHandleCallbackAndWait` function instead.\n *\n * @param {string} callbackName - The name of the callback function, used for error reporting.\n * @param {unknown} callback - The callback function to be executed. It can be either a\n *                             synchronous function or a function that returns a Promise.\n * @param {...unknown[]} args - Additional arguments to pass to the callback function.\n */\n\nexport function safeHandleCallback(\n  callbackName: string,\n  callback: unknown,\n  ...args: unknown[]\n): void {\n  const handleError = (error: Error): void => {\n    // Dispatch error using the standard reportError event API\n    // Available in Node.js 15+, Bun, Deno, and browsers\n    if (\n      typeof (globalThis as Record<string, unknown>).dispatchEvent ===\n      'function'\n    ) {\n      (\n        globalThis as unknown as {\n          dispatchEvent: (event: Event) => void;\n        }\n      ).dispatchEvent(\n        new ErrorEvent('reportError', {\n          error: new Error(\n            `Error in a callback ${callbackName}: ${DOUBLE_EOL}${errorToString(error)}`,\n          ),\n        }),\n      );\n    }\n  };\n\n  if (isFunction(callback)) {\n    try {\n      // We need to cast callback to the appropriate function type now\n      const result = (callback as (...args: unknown[]) => unknown)(...args);\n\n      if (isPromise(result)) {\n        // Fire-and-forget async callback\n        result.catch((error: unknown) => {\n          handleError(error as Error);\n        });\n      }\n    } catch (error) {\n      handleError(error as Error);\n    }\n  } else {\n    handleError(\n      new Error(`Callback provided for ${callbackName} is not a function`),\n    );\n  }\n}\n\ninterface CallbackResult<T> {\n  success: boolean;\n  value?: T;\n  error?: Error;\n}\n\n/**\n * Safely handles a callback function by catching any errors and reporting them\n * using the global `reportError` event (standard API available in Node.js 15+, Bun, Deno, and browsers).\n * This function can seamlessly handle both synchronous and asynchronous (Promise-based) callback\n * functions, and it waits for the callback to complete before returning the result or an error.\n *\n * Errors are dispatched as ErrorEvent objects with type 'reportError' via `globalThis.dispatchEvent()`.\n * You can listen for these errors using `globalThis.addEventListener('reportError', handler)`.\n *\n * @param {string} callbackName - The name of the callback function, used for error reporting.\n * @param {unknown} callback - The callback function to be executed. It can be either a\n *                             synchronous function or a function that returns a Promise.\n * @param {...unknown[]} args - Additional arguments to pass to the callback function.\n * @returns {Promise<CallbackResult<unknown>>} - A promise that resolves with an object containing\n *                                               the success status, value (if any), and error (if any).\n */\n\nexport async function safeHandleCallbackAndWait<T>(\n  callbackName: string,\n  callback: unknown,\n  ...args: unknown[]\n): Promise<CallbackResult<T>> {\n  const handleError = (error: Error): CallbackResult<T> => {\n    // Dispatch error using the standard reportError event API\n    // Available in Node.js 15+, Bun, Deno, and browsers\n    if (\n      typeof (globalThis as Record<string, unknown>).dispatchEvent ===\n      'function'\n    ) {\n      (\n        globalThis as unknown as {\n          dispatchEvent: (event: Event) => void;\n        }\n      ).dispatchEvent(\n        new ErrorEvent('reportError', {\n          error: new Error(\n            `Error in a callback ${callbackName}: ${DOUBLE_EOL}${errorToString(error)}`,\n          ),\n        }),\n      );\n    }\n\n    return { success: false, error };\n  };\n\n  if (isFunction(callback)) {\n    try {\n      // We need to cast callback to the appropriate function type now\n      const result = (callback as (...args: unknown[]) => unknown)(...args);\n\n      if (isPromise(result)) {\n        // Wait for the async callback to complete\n        const value = await (result as Promise<T>);\n\n        return { success: true, value };\n      } else {\n        return { success: true, value: result as T };\n      }\n    } catch (error) {\n      return handleError(error as Error);\n    }\n  } else {\n    return handleError(\n      new Error(`Callback provided for ${callbackName} is not a function`),\n    );\n  }\n}\n","/**\n * Instead of using `EventEmitter`, you could extend `EventEmitterProtected`\n * if you want the emit method to be protected, and allow only your class to emit events.\n *\n * A simplified event emitter implementation that works in both browser and Node.js environments.\n * This provides basic event handling functionality with type safety and memory management.\n */\n\nimport { safeHandleCallback } from './safe-handle-callback';\n\ntype EventCallback<T = unknown> = (data: T) => void | Promise<void>;\n\nexport class EventEmitterProtected {\n  private events: Map<string, Set<EventCallback<unknown>>>;\n\n  constructor() {\n    this.events = new Map();\n  }\n\n  /**\n   * Subscribe to an event\n   * @param event The event name to subscribe to\n   * @param callback The callback function to be called when the event is emitted\n   * @returns A function to unsubscribe from the event\n   */\n  public on<T = unknown>(\n    event: string,\n    callback: EventCallback<T>,\n  ): () => void {\n    if (!this.events.has(event)) {\n      this.events.set(event, new Set());\n    }\n    const callbacks = this.events.get(event);\n\n    if (callbacks) {\n      callbacks.add(callback as EventCallback<unknown>);\n    }\n\n    // Return unsubscribe function for cleanup\n    return () => {\n      const callbacks = this.events.get(event);\n      if (callbacks) {\n        callbacks.delete(callback as EventCallback<unknown>);\n\n        if (callbacks.size === 0) {\n          this.events.delete(event);\n        }\n      }\n    };\n  }\n\n  /**\n   * Subscribe to an event once - automatically unsubscribes after first emission\n   * @param event The event name to subscribe to\n   * @param callback The callback function to be called when the event is emitted\n   * @returns A function to unsubscribe from the event before it's called\n   */\n  public once<T = unknown>(\n    event: string,\n    callback: EventCallback<T>,\n  ): () => void {\n    const unsubscribe = this.on(event, (data: T) => {\n      unsubscribe();\n      return callback(data);\n    });\n\n    return unsubscribe;\n  }\n\n  /**\n   * Check if a specific callback is registered for an event.\n   * Note: For 'once' handlers, this will return true for the wrapper function, not the original callback.\n   * This means hasListener will return false when checking for the original callback of a 'once' subscription.\n   *\n   * @param event The event name to check\n   * @param callback The callback function to look for\n   * @returns true if the exact callback is registered, false otherwise\n   */\n  public hasListener<T = unknown>(\n    event: string,\n    callback: EventCallback<T>,\n  ): boolean {\n    const callbacks = this.events.get(event);\n    return callbacks?.has(callback as EventCallback<unknown>) ?? false;\n  }\n\n  /**\n   * Check if an event has any subscribers\n   * @param event The event name to check\n   * @returns true if the event has subscribers, false otherwise\n   */\n  public hasListeners(event: string): boolean {\n    const callbacks = this.events.get(event);\n    return callbacks !== undefined && callbacks.size > 0;\n  }\n\n  /**\n   * Get the number of subscribers for an event\n   * @param event The event name to check\n   * @returns The number of subscribers\n   */\n  public listenerCount(event: string): number {\n    const callbacks = this.events.get(event);\n    return callbacks ? callbacks.size : 0;\n  }\n\n  /**\n   * Remove all event listeners\n   * @param event Optional event name. If not provided, removes all listeners for all events\n   */\n  public clear(event?: string): void {\n    if (event) {\n      this.events.delete(event);\n    } else {\n      this.events.clear();\n    }\n  }\n\n  /**\n   * Emit an event with optional data\n   * This method is protected to allow only derived classes to trigger events.\n   * @param event The event name to emit\n   * @param data Optional data to pass to the event handlers\n   */\n  protected emit<T = unknown>(event: string, data?: T): void {\n    const callbacks = this.events.get(event);\n    if (callbacks) {\n      for (const callback of callbacks) {\n        safeHandleCallback(`event handler for ${event}`, callback, data);\n      }\n    }\n  }\n}\n\n/**\n * A class that implements the event emitter pattern with public emit method.\n * This class extends EventEmitterProtected and makes the emit method public.\n *\n * Use this when you want any code with access to the emitter to be able to trigger events.\n * If you want to control who can emit events, extend EventEmitterProtected instead.\n */\n\nexport class EventEmitter extends EventEmitterProtected {\n  /**\n   * Emit an event with optional data\n   * This method is public, allowing any code with access to the emitter to trigger events.\n   * @param event The event name to emit\n   * @param data Optional data to pass to the event handlers\n   */\n\n  public emit<T = unknown>(event: string, data?: T): void {\n    super.emit(event, data);\n  }\n}\n"],"mappings":"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","names":["stringWidth","availableWidth","stringWidth","stringWidth","availableWidth","callbacks"]}

package/dist/lib/id-helpers.cjs

@@ -0,0 +1,205 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/id-helpers.ts
+var id_helpers_exports = {};
+__export(id_helpers_exports, {
+  IDENTIFIER_TYPES: () => IDENTIFIER_TYPES,
+  IDHelpers: () => IDHelpers,
+  emptyID: () => emptyID,
+  generateID: () => generateID,
+  isEmptyID: () => isEmptyID,
+  validateID: () => validateID
+});
+module.exports = __toCommonJS(id_helpers_exports);
+var import_bson_objectid = __toESM(require("bson-objectid"), 1);
+var import_uuid = require("uuid");
+var import_ulid = require("ulid");
+
+// src/lib/unix-time-helpers.ts
+function convertMSToUnix(value) {
+  return Math.floor(value / 1e3);
+}
+
+// src/lib/id-helpers.ts
+var IDENTIFIER_TYPES = ["objectID", "uuid4", "uuid7", "ulid"];
+function assertIdentifierType(type) {
+  if (!IDENTIFIER_TYPES.includes(type)) {
+    throw new TypeError(
+      `Invalid ID type given: "${type}". Expected one of: ${IDENTIFIER_TYPES.join(", ")}`
+    );
+  }
+}
+function generateID(type, seedTime) {
+  assertIdentifierType(type);
+  if (seedTime !== void 0 && (!Number.isFinite(seedTime) || seedTime < 0)) {
+    throw new TypeError(
+      `seedTime must be a non-negative finite number (milliseconds), got: ${seedTime}`
+    );
+  }
+  if (type === "objectID") {
+    if (seedTime !== void 0) {
+      const unixTime = convertMSToUnix(seedTime);
+      return new import_bson_objectid.default(unixTime).toHexString();
+    } else {
+      return new import_bson_objectid.default().toHexString();
+    }
+  } else if (type === "uuid4") {
+    return (0, import_uuid.v4)();
+  } else if (type === "uuid7") {
+    if (seedTime !== void 0) {
+      return (0, import_uuid.v7)({ msecs: seedTime });
+    } else {
+      return (0, import_uuid.v7)();
+    }
+  } else if (type === "ulid") {
+    if (seedTime !== void 0) {
+      return (0, import_ulid.ulid)(seedTime);
+    } else {
+      return (0, import_ulid.ulid)();
+    }
+  } else {
+    throw new TypeError(`Unhandled identifier type: "${type}"`);
+  }
+}
+function validateID(type, id) {
+  assertIdentifierType(type);
+  if (typeof id !== "string") {
+    return false;
+  }
+  if (type === "objectID") {
+    if (id.match(/^[0-9a-fA-F]{24}$/)) {
+      return true;
+    } else {
+      return false;
+    }
+  } else if (type === "uuid4" || type === "uuid7") {
+    if (isEmptyID(type, id)) {
+      return true;
+    }
+    const isValid = (0, import_uuid.validate)(id);
+    if (!isValid) {
+      return false;
+    }
+    const version = (0, import_uuid.version)(id);
+    if (type === "uuid4" && version === 4) {
+      return true;
+    } else if (type === "uuid7" && version === 7) {
+      return true;
+    } else {
+      return false;
+    }
+  } else if (type === "ulid") {
+    if (id.match(/^[0-7][0-9A-HJKMNP-TV-Z]{25}$/i)) {
+      return true;
+    } else {
+      return false;
+    }
+  } else {
+    throw new TypeError(`Unhandled identifier type: "${type}"`);
+  }
+}
+function emptyID(type) {
+  assertIdentifierType(type);
+  if (type === "objectID") {
+    return "0".repeat(24);
+  } else if (type === "uuid4" || type === "uuid7") {
+    return "00000000-0000-0000-0000-000000000000";
+  } else if (type === "ulid") {
+    return "0".repeat(26);
+  } else {
+    throw new TypeError(`Unhandled identifier type: "${type}"`);
+  }
+}
+function isEmptyID(type, id) {
+  assertIdentifierType(type);
+  if (typeof id !== "string") {
+    return false;
+  }
+  return emptyID(type) === id;
+}
+var IDHelpers = class {
+  _type;
+  /**
+   * Gets the identifier type this helper is configured for.
+   */
+  get type() {
+    return this._type;
+  }
+  /**
+   * Creates a new ID helper for the specified type.
+   * @param type - The identifier type to use for all operations
+   * @throws {TypeError} If an invalid type is provided
+   */
+  constructor(type) {
+    assertIdentifierType(type);
+    this._type = type;
+  }
+  /**
+   * Generates a new identifier using the configured type.
+   * @param seedTime - Optional timestamp in milliseconds to seed the ID with
+   * @returns A unique identifier string
+   */
+  generateID(seedTime) {
+    return generateID(this._type, seedTime);
+  }
+  /**
+   * Validates an identifier against the configured type.
+   * @param id - The identifier string to validate
+   * @returns `true` if valid, `false` otherwise
+   */
+  validateID(id) {
+    return validateID(this._type, id);
+  }
+  /**
+   * Returns an empty identifier for the configured type.
+   * @returns An empty identifier string
+   */
+  emptyID() {
+    return emptyID(this._type);
+  }
+  /**
+   * Checks if an identifier is empty for the configured type.
+   * @param id - The identifier string to check
+   * @returns `true` if empty, `false` otherwise
+   */
+  isEmptyID(id) {
+    return isEmptyID(this._type, id);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  IDENTIFIER_TYPES,
+  IDHelpers,
+  emptyID,
+  generateID,
+  isEmptyID,
+  validateID
+});
+//# sourceMappingURL=id-helpers.cjs.map

package/dist/lib/id-helpers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/id-helpers.ts","../../src/lib/unix-time-helpers.ts"],"sourcesContent":["import ObjectID from 'bson-objectid';\nimport {\n  v4 as UUIDv4,\n  v7 as UUIDv7,\n  validate as uuidValidate,\n  version as uuidVersion,\n} from 'uuid';\nimport { ulid } from 'ulid';\nimport { convertMSToUnix } from './unix-time-helpers';\n\n/**\n * Supported identifier types:\n *\n * - **`objectID`**: MongoDB-style ObjectID\n *   - Format: 24 hexadecimal characters\n *   - Timestamp-based: Yes (sortable by creation time)\n *   - Case-sensitive: No (accepts both uppercase and lowercase)\n *   - Example: `\"507f1f77bcf86cd799439011\"`\n *\n * - **`uuid4`**: UUID version 4\n *   - Format: 36 characters (32 hex + 4 dashes): `xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx`\n *   - Timestamp-based: No (random)\n *   - Case-sensitive: No (accepts both uppercase and lowercase)\n *   - Example: `\"9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d\"`\n *\n * - **`uuid7`**: UUID version 7\n *   - Format: 36 characters (32 hex + 4 dashes): `xxxxxxxx-xxxx-7xxx-yxxx-xxxxxxxxxxxx`\n *   - Timestamp-based: Yes (sortable by creation time)\n *   - Case-sensitive: No (accepts both uppercase and lowercase)\n *   - Example: `\"018e8c6e-4f7e-7000-8000-0123456789ab\"`\n *\n * - **`ulid`**: Universally Unique Lexicographically Sortable Identifier\n *   - Format: 26 characters using Crockford's base32 alphabet\n *   - Timestamp-based: Yes (sortable by creation time)\n *   - Case-sensitive: No (canonical form is uppercase, but accepts lowercase)\n *   - Example: `\"01ARZ3NDEKTSV4RRFFQ69G5FAV\"`\n */\nexport type IdentifierType = 'objectID' | 'uuid4' | 'uuid7' | 'ulid';\n\n/**\n * Array of all supported identifier types.\n */\nexport const IDENTIFIER_TYPES = ['objectID', 'uuid4', 'uuid7', 'ulid'] as const;\n\nfunction assertIdentifierType(type: unknown): asserts type is IdentifierType {\n  if (!IDENTIFIER_TYPES.includes(type as IdentifierType)) {\n    throw new TypeError(\n      `Invalid ID type given: \"${type as string}\". Expected one of: ${IDENTIFIER_TYPES.join(', ')}`,\n    );\n  }\n}\n\n/**\n * Generates a unique identifier of the specified type.\n *\n * @param type - The type of identifier to generate:\n *   - `objectID`: MongoDB ObjectID (24 hex chars, timestamp-based)\n *   - `uuid4`: UUID v4 (random, not sortable)\n *   - `uuid7`: UUID v7 (timestamp-based, sortable)\n *   - `ulid`: ULID (timestamp-based, sortable, case-insensitive)\n * @param seedTime - Optional timestamp in milliseconds to seed the ID with.\n *   - Supported by: `objectID`, `uuid7`, `ulid`\n *   - Ignored by: `uuid4` (always random)\n *   - Use this for testing or when you need IDs to have a specific timestamp\n * @returns A unique identifier string\n * @throws {TypeError} If an invalid type is provided\n * @throws {TypeError} If `seedTime` is provided but is not a non-negative finite number\n *\n * @example\n * ```typescript\n * // Generate random IDs\n * const objId = generateID('objectID');  // \"507f1f77bcf86cd799439011\"\n * const uuid4 = generateID('uuid4');     // \"9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d\"\n * const uuid7 = generateID('uuid7');     // \"018e8c6e-4f7e-7000-8000-0123456789ab\"\n * const ulid = generateID('ulid');       // \"01ARZ3NDEKTSV4RRFFQ69G5FAV\"\n *\n * // Generate IDs with a specific timestamp\n * const timestamp = Date.now();\n * const seededId = generateID('uuid7', timestamp);\n * ```\n */\nexport function generateID(type: IdentifierType, seedTime?: number): string {\n  assertIdentifierType(type);\n\n  if (seedTime !== undefined && (!Number.isFinite(seedTime) || seedTime < 0)) {\n    throw new TypeError(\n      `seedTime must be a non-negative finite number (milliseconds), got: ${seedTime}`,\n    );\n  }\n\n  if (type === 'objectID') {\n    if (seedTime !== undefined) {\n      // expects as unix time\n      const unixTime = convertMSToUnix(seedTime);\n\n      return new ObjectID(unixTime).toHexString();\n    } else {\n      return new ObjectID().toHexString();\n    }\n  } else if (type === 'uuid4') {\n    return UUIDv4();\n  } else if (type === 'uuid7') {\n    if (seedTime !== undefined) {\n      // expect in milliseconds\n      return UUIDv7({ msecs: seedTime });\n    } else {\n      return UUIDv7();\n    }\n  } else if (type === 'ulid') {\n    if (seedTime !== undefined) {\n      // expect in milliseconds\n      return ulid(seedTime);\n    } else {\n      return ulid();\n    }\n  } else {\n    throw new TypeError(`Unhandled identifier type: \"${type as string}\"`);\n  }\n}\n\n/**\n * Validates that a string is a valid identifier of the specified type.\n *\n * Performs strict validation:\n * - `objectID`: Must be 24 hexadecimal characters\n * - `uuid4`: Must be a valid UUID with version 4\n * - `uuid7`: Must be a valid UUID with version 7\n * - `ulid`: Must be 26 characters from the ULID character set\n *\n * Empty IDs (from `emptyID()`) are considered valid.\n * Non-string `id` values return `false`.\n *\n * @param type - The expected identifier type\n * @param id - The identifier string to validate\n * @returns `true` if the ID is valid for the specified type, `false` otherwise\n * @throws {TypeError} If an invalid type is provided\n *\n * @example\n * ```typescript\n * validateID('uuid4', '9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d');  // true\n * validateID('uuid4', '018e8c6e-4f7e-7000-8000-0123456789ab');  // false (this is uuid7)\n * validateID('objectID', '507f1f77bcf86cd799439011');           // true\n * validateID('objectID', 'invalid');                            // false\n * ```\n */\nexport function validateID(type: IdentifierType, id: string): boolean {\n  assertIdentifierType(type);\n\n  if (typeof id !== 'string') {\n    return false;\n  }\n\n  if (type === 'objectID') {\n    if (id.match(/^[0-9a-fA-F]{24}$/)) {\n      return true;\n    } else {\n      return false;\n    }\n  } else if (type === 'uuid4' || type === 'uuid7') {\n    // Check if it's the empty ID first\n    if (isEmptyID(type, id)) {\n      return true;\n    }\n\n    const isValid = uuidValidate(id);\n    if (!isValid) {\n      return false;\n    }\n\n    // Check the specific UUID version\n    const version = uuidVersion(id);\n    if (type === 'uuid4' && version === 4) {\n      return true;\n    } else if (type === 'uuid7' && version === 7) {\n      return true;\n    } else {\n      return false;\n    }\n  } else if (type === 'ulid') {\n    if (id.match(/^[0-7][0-9A-HJKMNP-TV-Z]{25}$/i)) {\n      return true;\n    } else {\n      return false;\n    }\n  } else {\n    throw new TypeError(`Unhandled identifier type: \"${type as string}\"`);\n  }\n}\n\n/**\n * Returns an empty/null identifier for the specified type.\n *\n * Empty IDs are valid IDs (pass `validateID()`) but represent a null/empty state.\n * Useful as default values or placeholders in databases.\n *\n * Empty ID formats:\n * - `objectID`: `\"000000000000000000000000\"` (24 zeros)\n * - `uuid4`: `\"00000000-0000-0000-0000-000000000000\"` (nil UUID)\n * - `uuid7`: `\"00000000-0000-0000-0000-000000000000\"` (nil UUID)\n * - `ulid`: `\"00000000000000000000000000\"` (26 zeros)\n *\n * @param type - The type of empty identifier to generate\n * @returns An empty identifier string\n * @throws {TypeError} If an invalid type is provided\n *\n * @example\n * ```typescript\n * const emptyUuid = emptyID('uuid4');  // \"00000000-0000-0000-0000-000000000000\"\n * validateID('uuid4', emptyUuid);      // true\n * isEmptyID('uuid4', emptyUuid);       // true\n * ```\n */\nexport function emptyID(type: IdentifierType): string {\n  assertIdentifierType(type);\n\n  if (type === 'objectID') {\n    return '0'.repeat(24);\n  } else if (type === 'uuid4' || type === 'uuid7') {\n    return '00000000-0000-0000-0000-000000000000';\n  } else if (type === 'ulid') {\n    return '0'.repeat(26);\n  } else {\n    throw new TypeError(`Unhandled identifier type: \"${type as string}\"`);\n  }\n}\n\n/**\n * Checks if an identifier is an empty/null ID.\n *\n * Compares the provided ID against the empty ID for the specified type.\n * This is useful for checking if an ID represents a null/empty state.\n *\n * @param type - The identifier type to check against\n * @param id - The identifier string to check\n * @returns `true` if the ID is empty for the specified type, `false` otherwise.\n * Non-string `id` values return `false`.\n * @throws {TypeError} If an invalid type is provided\n *\n * @example\n * ```typescript\n * const emptyUuid = emptyID('uuid4');\n * const realUuid = generateID('uuid4');\n *\n * isEmptyID('uuid4', emptyUuid);  // true\n * isEmptyID('uuid4', realUuid);   // false\n * ```\n */\nexport function isEmptyID(type: IdentifierType, id: string): boolean {\n  assertIdentifierType(type);\n\n  if (typeof id !== 'string') {\n    return false;\n  }\n\n  return emptyID(type) === id;\n}\n\n/**\n * Helper class for working with identifiers of a specific type.\n *\n * This class provides a convenient way to work with IDs without repeatedly\n * specifying the type parameter. Initialize it with your preferred ID type,\n * then use its methods without passing the type each time.\n *\n * @example\n * ```typescript\n * // Create a helper for UUID v7 identifiers\n * const idHelper = new IDHelpers('uuid7');\n *\n * // Generate IDs without specifying type each time\n * const id1 = idHelper.generateID();\n * const id2 = idHelper.generateID(Date.now());\n *\n * // Validate IDs\n * if (idHelper.validateID(someId)) {\n *   console.log('Valid uuid7');\n * }\n *\n * // Check for empty IDs\n * const empty = idHelper.emptyID();\n * console.log(idHelper.isEmptyID(empty));  // true\n * ```\n */\nexport class IDHelpers {\n  private _type: IdentifierType;\n\n  /**\n   * Gets the identifier type this helper is configured for.\n   */\n  public get type(): IdentifierType {\n    return this._type;\n  }\n\n  /**\n   * Creates a new ID helper for the specified type.\n   * @param type - The identifier type to use for all operations\n   * @throws {TypeError} If an invalid type is provided\n   */\n  constructor(type: IdentifierType) {\n    assertIdentifierType(type);\n    this._type = type;\n  }\n\n  /**\n   * Generates a new identifier using the configured type.\n   * @param seedTime - Optional timestamp in milliseconds to seed the ID with\n   * @returns A unique identifier string\n   */\n  public generateID(seedTime?: number): string {\n    return generateID(this._type, seedTime);\n  }\n\n  /**\n   * Validates an identifier against the configured type.\n   * @param id - The identifier string to validate\n   * @returns `true` if valid, `false` otherwise\n   */\n  public validateID(id: string): boolean {\n    return validateID(this._type, id);\n  }\n\n  /**\n   * Returns an empty identifier for the configured type.\n   * @returns An empty identifier string\n   */\n  public emptyID(): string {\n    return emptyID(this._type);\n  }\n\n  /**\n   * Checks if an identifier is empty for the configured type.\n   * @param id - The identifier string to check\n   * @returns `true` if empty, `false` otherwise\n   */\n  public isEmptyID(id: string): boolean {\n    return isEmptyID(this._type, id);\n  }\n}\n","/**\n * Returns the current unix time in seconds\n *\n * ```typescript\n * const time = unix();\n * ```\n */\n\nexport function unix(): number {\n  return Math.floor(Date.now() / 1000);\n}\n\n/**\n * Returns the current unix time in milliseconds\n *\n *  ```typescript\n * const time = ms();\n * ```\n */\n\nexport function ms(): number {\n  return Date.now();\n}\n\n/**\n * Returns a high resolution timestamp\n * Returns the time measured in milliseconds\n * This is aimed at performance monitoring\n *\n * ```typescript\n * const time = performance();\n * ```\n */\n\nexport function performance(): number {\n  return globalThis.performance.now();\n}\n\n/**\n * Converts a Unix timestamp from milliseconds to seconds.\n * Useful for converting the millisecond-based timestamp from JavaScript's Date.now() into a Unix timestamp in seconds.\n *\n * @param {number} value - Unix timestamp in milliseconds.\n * @returns {number} - Unix timestamp converted to seconds.\n *\n * ```typescript\n * convertMSToUnix(1593189055006); // returns 1593189055\n * ```\n */\n\nexport function convertMSToUnix(value: number): number {\n  return Math.floor(value / 1000);\n}\n\n/**\n * Converts a Unix timestamp from seconds to milliseconds.\n *\n * This function takes a Unix timestamp in seconds and converts it to milliseconds.\n * This is useful when dealing with JavaScript's Date object or other systems that\n * require time in milliseconds.\n *\n * @param {number} value - The Unix timestamp in seconds.\n * @returns {number} The Unix timestamp in milliseconds.\n *\n * Example:\n * ```typescript\n * convertUnix(1593189055); // returns 1593189055000\n * ```\n */\n\nexport function convertUnixToMS(value: number): number {\n  return value * 1000;\n}\n"],"mappings":"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","names":["ObjectID","UUIDv4","UUIDv7","uuidValidate","uuidVersion"]}

package/dist/lib/id-helpers.d.cts

@@ -0,0 +1,198 @@
+/**
+ * Supported identifier types:
+ *
+ * - **`objectID`**: MongoDB-style ObjectID
+ *   - Format: 24 hexadecimal characters
+ *   - Timestamp-based: Yes (sortable by creation time)
+ *   - Case-sensitive: No (accepts both uppercase and lowercase)
+ *   - Example: `"507f1f77bcf86cd799439011"`
+ *
+ * - **`uuid4`**: UUID version 4
+ *   - Format: 36 characters (32 hex + 4 dashes): `xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx`
+ *   - Timestamp-based: No (random)
+ *   - Case-sensitive: No (accepts both uppercase and lowercase)
+ *   - Example: `"9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"`
+ *
+ * - **`uuid7`**: UUID version 7
+ *   - Format: 36 characters (32 hex + 4 dashes): `xxxxxxxx-xxxx-7xxx-yxxx-xxxxxxxxxxxx`
+ *   - Timestamp-based: Yes (sortable by creation time)
+ *   - Case-sensitive: No (accepts both uppercase and lowercase)
+ *   - Example: `"018e8c6e-4f7e-7000-8000-0123456789ab"`
+ *
+ * - **`ulid`**: Universally Unique Lexicographically Sortable Identifier
+ *   - Format: 26 characters using Crockford's base32 alphabet
+ *   - Timestamp-based: Yes (sortable by creation time)
+ *   - Case-sensitive: No (canonical form is uppercase, but accepts lowercase)
+ *   - Example: `"01ARZ3NDEKTSV4RRFFQ69G5FAV"`
+ */
+type IdentifierType = 'objectID' | 'uuid4' | 'uuid7' | 'ulid';
+/**
+ * Array of all supported identifier types.
+ */
+declare const IDENTIFIER_TYPES: readonly ["objectID", "uuid4", "uuid7", "ulid"];
+/**
+ * Generates a unique identifier of the specified type.
+ *
+ * @param type - The type of identifier to generate:
+ *   - `objectID`: MongoDB ObjectID (24 hex chars, timestamp-based)
+ *   - `uuid4`: UUID v4 (random, not sortable)
+ *   - `uuid7`: UUID v7 (timestamp-based, sortable)
+ *   - `ulid`: ULID (timestamp-based, sortable, case-insensitive)
+ * @param seedTime - Optional timestamp in milliseconds to seed the ID with.
+ *   - Supported by: `objectID`, `uuid7`, `ulid`
+ *   - Ignored by: `uuid4` (always random)
+ *   - Use this for testing or when you need IDs to have a specific timestamp
+ * @returns A unique identifier string
+ * @throws {TypeError} If an invalid type is provided
+ * @throws {TypeError} If `seedTime` is provided but is not a non-negative finite number
+ *
+ * @example
+ * ```typescript
+ * // Generate random IDs
+ * const objId = generateID('objectID');  // "507f1f77bcf86cd799439011"
+ * const uuid4 = generateID('uuid4');     // "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"
+ * const uuid7 = generateID('uuid7');     // "018e8c6e-4f7e-7000-8000-0123456789ab"
+ * const ulid = generateID('ulid');       // "01ARZ3NDEKTSV4RRFFQ69G5FAV"
+ *
+ * // Generate IDs with a specific timestamp
+ * const timestamp = Date.now();
+ * const seededId = generateID('uuid7', timestamp);
+ * ```
+ */
+declare function generateID(type: IdentifierType, seedTime?: number): string;
+/**
+ * Validates that a string is a valid identifier of the specified type.
+ *
+ * Performs strict validation:
+ * - `objectID`: Must be 24 hexadecimal characters
+ * - `uuid4`: Must be a valid UUID with version 4
+ * - `uuid7`: Must be a valid UUID with version 7
+ * - `ulid`: Must be 26 characters from the ULID character set
+ *
+ * Empty IDs (from `emptyID()`) are considered valid.
+ * Non-string `id` values return `false`.
+ *
+ * @param type - The expected identifier type
+ * @param id - The identifier string to validate
+ * @returns `true` if the ID is valid for the specified type, `false` otherwise
+ * @throws {TypeError} If an invalid type is provided
+ *
+ * @example
+ * ```typescript
+ * validateID('uuid4', '9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d');  // true
+ * validateID('uuid4', '018e8c6e-4f7e-7000-8000-0123456789ab');  // false (this is uuid7)
+ * validateID('objectID', '507f1f77bcf86cd799439011');           // true
+ * validateID('objectID', 'invalid');                            // false
+ * ```
+ */
+declare function validateID(type: IdentifierType, id: string): boolean;
+/**
+ * Returns an empty/null identifier for the specified type.
+ *
+ * Empty IDs are valid IDs (pass `validateID()`) but represent a null/empty state.
+ * Useful as default values or placeholders in databases.
+ *
+ * Empty ID formats:
+ * - `objectID`: `"000000000000000000000000"` (24 zeros)
+ * - `uuid4`: `"00000000-0000-0000-0000-000000000000"` (nil UUID)
+ * - `uuid7`: `"00000000-0000-0000-0000-000000000000"` (nil UUID)
+ * - `ulid`: `"00000000000000000000000000"` (26 zeros)
+ *
+ * @param type - The type of empty identifier to generate
+ * @returns An empty identifier string
+ * @throws {TypeError} If an invalid type is provided
+ *
+ * @example
+ * ```typescript
+ * const emptyUuid = emptyID('uuid4');  // "00000000-0000-0000-0000-000000000000"
+ * validateID('uuid4', emptyUuid);      // true
+ * isEmptyID('uuid4', emptyUuid);       // true
+ * ```
+ */
+declare function emptyID(type: IdentifierType): string;
+/**
+ * Checks if an identifier is an empty/null ID.
+ *
+ * Compares the provided ID against the empty ID for the specified type.
+ * This is useful for checking if an ID represents a null/empty state.
+ *
+ * @param type - The identifier type to check against
+ * @param id - The identifier string to check
+ * @returns `true` if the ID is empty for the specified type, `false` otherwise.
+ * Non-string `id` values return `false`.
+ * @throws {TypeError} If an invalid type is provided
+ *
+ * @example
+ * ```typescript
+ * const emptyUuid = emptyID('uuid4');
+ * const realUuid = generateID('uuid4');
+ *
+ * isEmptyID('uuid4', emptyUuid);  // true
+ * isEmptyID('uuid4', realUuid);   // false
+ * ```
+ */
+declare function isEmptyID(type: IdentifierType, id: string): boolean;
+/**
+ * Helper class for working with identifiers of a specific type.
+ *
+ * This class provides a convenient way to work with IDs without repeatedly
+ * specifying the type parameter. Initialize it with your preferred ID type,
+ * then use its methods without passing the type each time.
+ *
+ * @example
+ * ```typescript
+ * // Create a helper for UUID v7 identifiers
+ * const idHelper = new IDHelpers('uuid7');
+ *
+ * // Generate IDs without specifying type each time
+ * const id1 = idHelper.generateID();
+ * const id2 = idHelper.generateID(Date.now());
+ *
+ * // Validate IDs
+ * if (idHelper.validateID(someId)) {
+ *   console.log('Valid uuid7');
+ * }
+ *
+ * // Check for empty IDs
+ * const empty = idHelper.emptyID();
+ * console.log(idHelper.isEmptyID(empty));  // true
+ * ```
+ */
+declare class IDHelpers {
+    private _type;
+    /**
+     * Gets the identifier type this helper is configured for.
+     */
+    get type(): IdentifierType;
+    /**
+     * Creates a new ID helper for the specified type.
+     * @param type - The identifier type to use for all operations
+     * @throws {TypeError} If an invalid type is provided
+     */
+    constructor(type: IdentifierType);
+    /**
+     * Generates a new identifier using the configured type.
+     * @param seedTime - Optional timestamp in milliseconds to seed the ID with
+     * @returns A unique identifier string
+     */
+    generateID(seedTime?: number): string;
+    /**
+     * Validates an identifier against the configured type.
+     * @param id - The identifier string to validate
+     * @returns `true` if valid, `false` otherwise
+     */
+    validateID(id: string): boolean;
+    /**
+     * Returns an empty identifier for the configured type.
+     * @returns An empty identifier string
+     */
+    emptyID(): string;
+    /**
+     * Checks if an identifier is empty for the configured type.
+     * @param id - The identifier string to check
+     * @returns `true` if empty, `false` otherwise
+     */
+    isEmptyID(id: string): boolean;
+}
+
+export { IDENTIFIER_TYPES, IDHelpers, type IdentifierType, emptyID, generateID, isEmptyID, validateID };