@poppinss/utils 6.5.0 → 6.5.1

package/build/{chunk-XHQBV7AF.js → chunk-IOBSMUFC.js}

@@ -37,3 +37,4 @@ var main_default = json;
 export {
   main_default
 };
+//# sourceMappingURL=chunk-IOBSMUFC.js.map

package/build/chunk-IOBSMUFC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/json/safe_parse.ts","../src/json/safe_stringify.ts","../src/json/main.ts"],"sourcesContent":["/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { parse } from 'secure-json-parse'\nimport { JSONReviver } from '../types.js'\n\n/**\n * A drop-in replacement for JSON.parse with prototype poisoning protection.\n */\nexport function safeParse(jsonString: string, reviver?: JSONReviver): any {\n  return parse(jsonString, reviver, {\n    protoAction: 'remove',\n    constructorAction: 'remove',\n  })\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { configure } from 'safe-stable-stringify'\nimport { JSONReplacer } from '../types.js'\n\nconst stringify = configure({\n  bigint: false,\n  circularValue: undefined,\n  deterministic: false,\n})\n\n/**\n * Replacer to handle custom data types.\n *\n * - Bigints are converted to string\n */\nfunction jsonStringifyReplacer(replacer?: JSONReplacer): JSONReplacer {\n  return function (key, value) {\n    const val = replacer ? replacer.call(this, key, value) : value\n\n    if (typeof val === 'bigint') {\n      return val.toString()\n    }\n\n    return val\n  }\n}\n\n/**\n * String Javascript values to a JSON string. Handles circular\n * references and bigints\n */\nexport function safeStringify(\n  value: any,\n  replacer?: JSONReplacer,\n  space?: string | number\n): string | undefined {\n  return stringify(value, jsonStringifyReplacer(replacer), space)\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { safeParse } from './safe_parse.js'\nimport { safeStringify } from './safe_stringify.js'\n\nconst json = {\n  safeParse,\n  safeStringify,\n}\n\nexport default json\n"],"mappings":";AASA,SAAS,aAAa;AAMf,SAAS,UAAU,YAAoB,SAA4B;AACxE,SAAO,MAAM,YAAY,SAAS;AAAA,IAChC,aAAa;AAAA,IACb,mBAAmB;AAAA,EACrB,CAAC;AACH;;;ACXA,SAAS,iBAAiB;AAG1B,IAAM,YAAY,UAAU;AAAA,EAC1B,QAAQ;AAAA,EACR,eAAe;AAAA,EACf,eAAe;AACjB,CAAC;AAOD,SAAS,sBAAsB,UAAuC;AACpE,SAAO,SAAU,KAAK,OAAO;AAC3B,UAAM,MAAM,WAAW,SAAS,KAAK,MAAM,KAAK,KAAK,IAAI;AAEzD,QAAI,OAAO,QAAQ,UAAU;AAC3B,aAAO,IAAI,SAAS;AAAA,IACtB;AAEA,WAAO;AAAA,EACT;AACF;AAMO,SAAS,cACd,OACA,UACA,OACoB;AACpB,SAAO,UAAU,OAAO,sBAAsB,QAAQ,GAAG,KAAK;AAChE;;;ACjCA,IAAM,OAAO;AAAA,EACX;AAAA,EACA;AACF;AAEA,IAAO,eAAQ;","names":[]}

package/build/{chunk-OKRMWJO4.js → chunk-K76IL3UP.js}

@@ -1,7 +1,7 @@
 import {
   base64,
   milliseconds_default
-} from "./chunk-PWRXO3NF.js";
+} from "./chunk-NKGAOHNN.js";
 
 // src/string/bytes.ts
 import bytes from "bytes";
@@ -267,3 +267,4 @@ var main_default = string;
 export {
   main_default
 };
+//# sourceMappingURL=chunk-K76IL3UP.js.map

package/build/chunk-K76IL3UP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/string/bytes.ts","../src/string/seconds.ts","../src/string/slugify.ts","../src/string/random.ts","../src/string/excerpt.ts","../src/string/ordinal.ts","../src/string/truncate.ts","../src/string/sentence.ts","../src/string/interpolate.ts","../src/string/pluralize.ts","../src/string/change_case.ts","../src/string/main.ts"],"sourcesContent":["/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport bytes, { BytesOptions } from 'bytes'\n\nexport default {\n  format(valueInBytes: number, options?: BytesOptions): string {\n    return bytes.format(valueInBytes, options)\n  },\n\n  /**\n   * Parse the unit expression to bytes. If the unit value\n   * is a number, then it will be returned as it is considering\n   * it is already in bytes.\n   */\n  parse(unit: string | number): number {\n    if (typeof unit === 'number') {\n      return unit\n    }\n\n    return bytes.parse(unit)\n  },\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { parse, format } from '@lukeed/ms'\n\nexport default {\n  format(seconds: number, long?: boolean): string {\n    return format(seconds * 1000, long)\n  },\n\n  /**\n   * Parse time expression string to seconds. The number value\n   * is returned as it is, considering it is already in seconds\n   */\n  parse(duration: string | number): number {\n    if (typeof duration === 'number') {\n      return duration\n    }\n\n    const milliseconds = parse(duration)\n    if (milliseconds === undefined) {\n      throw new Error(`Invalid duration expression \"${duration}\"`)\n    }\n\n    return Math.floor(milliseconds / 1000)\n  },\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { default as slugifyPkg } from 'slugify'\n\n/**\n * Typings of the slugify package are a bit off and therefore we have\n * to do this manual dance of re-assigning types\n */\nexport const slug = slugifyPkg as unknown as (typeof slugifyPkg)['default']\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { randomBytes } from 'node:crypto'\nimport { base64 } from '../base64.js'\n\n/**\n * Generates a random string of a given size\n */\nexport function random(size: number): string {\n  const bits = (size + 1) * 6\n  const buffer = randomBytes(Math.ceil(bits / 8))\n  return base64.urlEncode(buffer).slice(0, size)\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\n// @ts-expect-error (Package has no types)\nimport truncatise from 'truncatise'\n\n/**\n * Truncate a sentence to be under a certain characters limit and strip\n * out HTML tags from it.\n *\n * Optionally, you can force the truncate logic to complete words, which\n * may exceed the defined characters limit.\n */\nexport function excerpt(\n  sentence: string,\n  charactersLimit: number,\n  options?: {\n    completeWords?: boolean\n    suffix?: string\n  }\n): string {\n  return truncatise(sentence, {\n    TruncateLength: charactersLimit,\n    /**\n     * Do not complete words when \"completeWords\" is not explicitly set\n     * to true\n     */\n    Strict: options && options.completeWords === true ? false : true,\n    StripHTML: true,\n    TruncateBy: 'characters',\n    Suffix: options && options.suffix,\n  })\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\n/**\n * Ordinalize a give number or string\n */\nexport function ordinal(value: string | number): string {\n  const transformedValue = Math.abs(typeof value === 'string' ? Number.parseInt(value) : value)\n  if (!Number.isFinite(transformedValue) || Number.isNaN(transformedValue)) {\n    throw new Error('Cannot ordinalize invalid or infinite numbers')\n  }\n\n  const percent = transformedValue % 100\n  if (percent >= 10 && percent <= 20) {\n    return `${value}th`\n  }\n\n  const decimal = transformedValue % 10\n  switch (decimal) {\n    case 1:\n      return `${value}st`\n    case 2:\n      return `${value}nd`\n    case 3:\n      return `${value}rd`\n    default:\n      return `${value}th`\n  }\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\n// @ts-expect-error (Package has no types)\nimport truncatise from 'truncatise'\n\n/**\n * Truncate a sentence to be under a certain characters limit.\n *\n * Optionally, you can force the truncate logic to complete words, which\n * may exceed the defined characters limit.\n */\nexport function truncate(\n  sentence: string,\n  charactersLimit: number,\n  options?: {\n    completeWords?: boolean\n    suffix?: string\n  }\n): string {\n  return truncatise(sentence, {\n    TruncateLength: charactersLimit,\n    /**\n     * Do not complete words when \"completeWords\" is not explicitly set\n     * to true\n     */\n    Strict: options && options.completeWords === true ? false : true,\n    StripHTML: false,\n    TruncateBy: 'characters',\n    Suffix: options && options.suffix,\n  })\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\n/**\n * Convert an array of values to a sentence.\n */\nexport function sentence(\n  values: any[],\n  options?: {\n    separator?: string\n    pairSeparator?: string\n    lastSeparator?: string\n  }\n): string {\n  /**\n   * Empty array\n   */\n  if (values.length === 0) {\n    return ''\n  }\n\n  /**\n   * Just one item\n   */\n  if (values.length === 1) {\n    return values[0]\n  }\n\n  /**\n   * Giving some love to two items, so that one can ditch comma with two items\n   */\n  if (values.length === 2) {\n    return `${values[0]}${options?.pairSeparator || ' and '}${values[1]}`\n  }\n\n  const normalized = Object.assign({ separator: ', ', lastSeparator: ', and ' }, options)\n\n  /**\n   * Make sentence\n   */\n  return `${values.slice(0, -1).join(normalized.separator)}${normalized.lastSeparator}${\n    values[values.length - 1]\n  }`\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\n/**\n * Parses prop\n */\nfunction parseProp(data: any, key: string) {\n  const tokens = key.split('.')\n  while (tokens.length) {\n    if (data === null || typeof data !== 'object') {\n      return\n    }\n    const token = tokens.shift()!\n    data = Object.hasOwn(data, token) ? data[token] : undefined\n  }\n  return data\n}\n\n/**\n * A simple function interpolate values inside curly braces.\n *\n * ```\n * interpolate('hello {{ username }}', { username: 'virk' })\n * ```\n */\nexport function interpolate(input: string, data: any) {\n  return input.replace(/(\\\\)?{{(.*?)}}/g, (_, escapeChar, key) => {\n    if (escapeChar) {\n      return `{{${key}}}`\n    }\n\n    return parseProp(data, key.trim())\n  })\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { default as pluralizePkg } from 'pluralize'\n\n/**\n * Pluralize a word based upon the count. The method returns the\n * singular form when count is 1.\n */\nexport function pluralize(word: string, count?: number, inclusive?: boolean): string {\n  return pluralizePkg(word, count, inclusive)\n}\npluralize.addPluralRule = pluralizePkg.addPluralRule\npluralize.addSingularRule = pluralizePkg.addSingularRule\npluralize.addIrregularRule = pluralizePkg.addIrregularRule\npluralize.addUncountableRule = pluralizePkg.addUncountableRule\n\nexport const plural = pluralizePkg.plural\nexport const singular = pluralizePkg.singular\nexport const isPlural = pluralizePkg.isPlural\nexport const isSingular = pluralizePkg.isSingular\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport * as changeCase from 'case-anything'\n\n// Support camel case (\"camelCase\" -> \"camel Case\" and \"CAMELCase\" -> \"CAMEL Case\").\nconst NO_CASE_SPLIT_REGEXP = [/([a-z0-9])([A-Z])/g, /([A-Z])([A-Z][a-z])/g]\n\n// Remove all non-word characters.\nconst NO_CASE_STRIP_REGEXP = /[^A-Z0-9]+/gi\n\nconst SMALL_WORDS =\n  /\\b(?:an?d?|a[st]|because|but|by|en|for|i[fn]|neither|nor|o[fnr]|only|over|per|so|some|tha[tn]|the|to|up|upon|vs?\\.?|versus|via|when|with|without|yet)\\b/i\nconst TOKENS = /[^\\s:–—-]+|./g\nconst WHITESPACE = /\\s/\nconst IS_MANUAL_CASE = /.(?=[A-Z]|\\..)/\nconst ALPHANUMERIC_PATTERN = /[A-Za-z0-9\\u00C0-\\u00FF]/\n\n/**\n * The method is a copy/paste from the \"title-case\" package. They have\n * a dependency on \"tslib\", which I don't want.\n */\nexport function titleCase(input: string) {\n  let output = ''\n  let result: RegExpExecArray | null\n\n  while ((result = TOKENS.exec(input)) !== null) {\n    const { 0: token, index } = result\n\n    if (\n      !IS_MANUAL_CASE.test(token) &&\n      (!SMALL_WORDS.test(token) || index === 0 || index + token.length === input.length) &&\n      (input.charAt(index + token.length) !== ':' ||\n        WHITESPACE.test(input.charAt(index + token.length + 1)))\n    ) {\n      output += token.replace(ALPHANUMERIC_PATTERN, (char) => char.toUpperCase())\n      continue\n    }\n\n    output += token\n  }\n\n  return output\n}\n\n/**\n * Convert string to camelcase\n */\nexport function camelCase(value: string): string {\n  return changeCase.camelCase(value)\n}\n\n/**\n * Convert string to snakecase\n */\nexport function snakeCase(value: string): string {\n  return changeCase.snakeCase(value)\n}\n\n/**\n * Convert string to dashcase\n */\nexport function dashCase(value: string, options?: { capitalize?: boolean }): string {\n  if (options && options.capitalize) {\n    return changeCase.trainCase(value)\n  }\n\n  return changeCase.kebabCase(value)\n}\n\n/**\n * Convert string to pascal case\n */\nexport function pascalCase(value: string): string {\n  return changeCase.pascalCase(value)\n}\n\n/**\n * Convert string to capital case\n */\nexport function capitalCase(value: string): string {\n  return changeCase.capitalCase(value)\n}\n\n/**\n * Convert string to sentence case\n */\nexport function sentenceCase(value: string): string {\n  return noCase(value, (input, index) => {\n    const result = input.toLowerCase()\n    if (index === 0) {\n      return input.charAt(0).toUpperCase() + input.substring(1)\n    }\n    return result\n  })\n}\n\n/**\n * Convert string to dot case\n */\nexport function dotCase(value: string, options?: { lowerCase?: boolean }): string {\n  const transformedValue = changeCase.dotNotation(value)\n  if (options && options.lowerCase) {\n    return transformedValue.toLowerCase()\n  }\n\n  return transformedValue\n}\n\n/**\n * Remove all sort of casing from the string. Copy-pasted from\n * \"no-case\" package with slight modifications.\n */\nexport function noCase(\n  value: string,\n  transform?: (part: string, index: number, parts: string[]) => string\n): string {\n  let result = NO_CASE_SPLIT_REGEXP.reduce((input, regex) => input.replace(regex, '$1\\0$2'), value)\n  result = result.replace(NO_CASE_STRIP_REGEXP, '\\0')\n\n  let start = 0\n  let end = result.length\n\n  // Trim the delimiter from around the output string.\n  while (result.charAt(start) === '\\0') {\n    start++\n  }\n  while (result.charAt(end - 1) === '\\0') {\n    end--\n  }\n\n  return result\n    .slice(start, end)\n    .split('\\0')\n    .map(transform || ((input) => input.toLowerCase()))\n    .join(' ')\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport bytes from './bytes.js'\nimport seconds from './seconds.js'\nimport { slug } from './slugify.js'\nimport { random } from './random.js'\nimport { excerpt } from './excerpt.js'\nimport { ordinal } from './ordinal.js'\nimport { truncate } from './truncate.js'\nimport milliseconds from './milliseconds.js'\nimport { sentence } from './sentence.js'\nimport { interpolate } from './interpolate.js'\nimport { plural, pluralize, singular, isPlural, isSingular } from './pluralize.js'\nimport {\n  noCase,\n  dotCase,\n  dashCase,\n  camelCase,\n  snakeCase,\n  titleCase,\n  pascalCase,\n  capitalCase,\n  sentenceCase,\n} from './change_case.js'\n\n/**\n * Condense multiple whitespaces from a string\n */\nfunction condenseWhitespace(value: string): string {\n  return value.trim().replace(/\\s{2,}/g, ' ')\n}\n\nconst string = {\n  excerpt,\n  truncate,\n  slug,\n  interpolate,\n  plural,\n  pluralize,\n  singular,\n  isPlural,\n  isSingular,\n  camelCase,\n  capitalCase,\n  dashCase,\n  dotCase,\n  noCase,\n  pascalCase,\n  sentenceCase,\n  snakeCase,\n  titleCase,\n  random,\n  sentence,\n  condenseWhitespace,\n  seconds,\n  milliseconds,\n  bytes,\n  ordinal,\n}\n\nexport default string\n"],"mappings":"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","names":["sentence","truncatise","sentence","camelCase","snakeCase","pascalCase","capitalCase","camelCase","capitalCase","pascalCase","snakeCase"]}

package/build/{chunk-PWRXO3NF.js → chunk-NKGAOHNN.js}

@@ -61,3 +61,4 @@ export {
   base64,
   milliseconds_default
 };
+//# sourceMappingURL=chunk-NKGAOHNN.js.map

package/build/chunk-NKGAOHNN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/base64.ts","../src/string/milliseconds.ts"],"sourcesContent":["/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\n/**\n * Helper class to base64 encode/decode values with option\n * for url encoding and decoding\n */\nclass Base64 {\n  /**\n   * Base64 encode Buffer or string\n   */\n  encode(arrayBuffer: ArrayBuffer | SharedArrayBuffer): string\n  encode(data: string, encoding?: BufferEncoding): string\n  encode(data: ArrayBuffer | SharedArrayBuffer | string, encoding?: BufferEncoding): string {\n    if (typeof data === 'string') {\n      return Buffer.from(data, encoding).toString('base64')\n    }\n    return Buffer.from(data).toString('base64')\n  }\n\n  /**\n   * Base64 decode a previously encoded string or Buffer.\n   */\n  decode(encode: string, encoding: BufferEncoding, strict: true): string\n  decode(encode: string, encoding: undefined, strict: true): string\n  decode(encode: string, encoding?: BufferEncoding, strict?: false): string | null\n  decode(encode: Buffer, encoding?: BufferEncoding): string\n  decode(\n    encoded: string | Buffer,\n    encoding: BufferEncoding = 'utf-8',\n    strict: boolean = false\n  ): string | null {\n    if (Buffer.isBuffer(encoded)) {\n      return encoded.toString(encoding)\n    }\n\n    const decoded = Buffer.from(encoded, 'base64').toString(encoding)\n    const isInvalid = this.encode(decoded, encoding) !== encoded\n\n    if (strict && isInvalid) {\n      throw new Error('Cannot decode malformed value')\n    }\n\n    return isInvalid ? null : decoded\n  }\n\n  /**\n   * Base64 encode Buffer or string to be URL safe. (RFC 4648)\n   */\n  urlEncode(arrayBuffer: ArrayBuffer | SharedArrayBuffer): string\n  urlEncode(data: string, encoding?: BufferEncoding): string\n  urlEncode(data: ArrayBuffer | SharedArrayBuffer | string, encoding?: BufferEncoding): string {\n    const encoded = typeof data === 'string' ? this.encode(data, encoding) : this.encode(data)\n    return encoded.replace(/\\+/g, '-').replace(/\\//g, '_').replace(/\\=/g, '')\n  }\n\n  /**\n   * Base64 URL decode a previously encoded string or Buffer. (RFC 4648)\n   */\n  urlDecode(encode: string, encoding: BufferEncoding, strict: true): string\n  urlDecode(encode: string, encoding: undefined, strict: true): string\n  urlDecode(encode: string, encoding?: BufferEncoding, strict?: false): string | null\n  urlDecode(encode: Buffer, encoding?: BufferEncoding): string\n  urlDecode(\n    encoded: string | Buffer,\n    encoding: BufferEncoding = 'utf-8',\n    strict: boolean = false\n  ): string | null {\n    if (Buffer.isBuffer(encoded)) {\n      return encoded.toString(encoding)\n    }\n\n    const decoded = Buffer.from(encoded, 'base64').toString(encoding)\n    const isInvalid = this.urlEncode(decoded, encoding) !== encoded\n\n    if (strict && isInvalid) {\n      throw new Error('Cannot urlDecode malformed value')\n    }\n\n    return isInvalid ? null : decoded\n  }\n}\n\nexport const base64 = new Base64()\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { parse, format } from '@lukeed/ms'\n\nexport default {\n  format(milliseconds: number, long?: boolean): string {\n    return format(milliseconds, long)\n  },\n\n  /**\n   * Parse time expression string to milliseconds. The number value\n   * is returned as it is, considering it is already in milliseconds\n   */\n  parse(duration: string | number): number {\n    if (typeof duration === 'number') {\n      return duration\n    }\n\n    const milliseconds = parse(duration)\n    if (milliseconds === undefined) {\n      throw new Error(`Invalid duration expression \"${duration}\"`)\n    }\n\n    return milliseconds\n  },\n}\n"],"mappings":";AAaA,IAAM,SAAN,MAAa;AAAA,EAMX,OAAO,MAAgD,UAAmC;AACxF,QAAI,OAAO,SAAS,UAAU;AAC5B,aAAO,OAAO,KAAK,MAAM,QAAQ,EAAE,SAAS,QAAQ;AAAA,IACtD;AACA,WAAO,OAAO,KAAK,IAAI,EAAE,SAAS,QAAQ;AAAA,EAC5C;AAAA,EASA,OACE,SACA,WAA2B,SAC3B,SAAkB,OACH;AACf,QAAI,OAAO,SAAS,OAAO,GAAG;AAC5B,aAAO,QAAQ,SAAS,QAAQ;AAAA,IAClC;AAEA,UAAM,UAAU,OAAO,KAAK,SAAS,QAAQ,EAAE,SAAS,QAAQ;AAChE,UAAM,YAAY,KAAK,OAAO,SAAS,QAAQ,MAAM;AAErD,QAAI,UAAU,WAAW;AACvB,YAAM,IAAI,MAAM,+BAA+B;AAAA,IACjD;AAEA,WAAO,YAAY,OAAO;AAAA,EAC5B;AAAA,EAOA,UAAU,MAAgD,UAAmC;AAC3F,UAAM,UAAU,OAAO,SAAS,WAAW,KAAK,OAAO,MAAM,QAAQ,IAAI,KAAK,OAAO,IAAI;AACzF,WAAO,QAAQ,QAAQ,OAAO,GAAG,EAAE,QAAQ,OAAO,GAAG,EAAE,QAAQ,OAAO,EAAE;AAAA,EAC1E;AAAA,EASA,UACE,SACA,WAA2B,SAC3B,SAAkB,OACH;AACf,QAAI,OAAO,SAAS,OAAO,GAAG;AAC5B,aAAO,QAAQ,SAAS,QAAQ;AAAA,IAClC;AAEA,UAAM,UAAU,OAAO,KAAK,SAAS,QAAQ,EAAE,SAAS,QAAQ;AAChE,UAAM,YAAY,KAAK,UAAU,SAAS,QAAQ,MAAM;AAExD,QAAI,UAAU,WAAW;AACvB,YAAM,IAAI,MAAM,kCAAkC;AAAA,IACpD;AAEA,WAAO,YAAY,OAAO;AAAA,EAC5B;AACF;AAEO,IAAM,SAAS,IAAI,OAAO;;;AChFjC,SAAS,OAAO,cAAc;AAE9B,IAAO,uBAAQ;AAAA,EACb,OAAO,cAAsB,MAAwB;AACnD,WAAO,OAAO,cAAc,IAAI;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,UAAmC;AACvC,QAAI,OAAO,aAAa,UAAU;AAChC,aAAO;AAAA,IACT;AAEA,UAAM,eAAe,MAAM,QAAQ;AACnC,QAAI,iBAAiB,QAAW;AAC9B,YAAM,IAAI,MAAM,gCAAgC,QAAQ,GAAG;AAAA,IAC7D;AAEA,WAAO;AAAA,EACT;AACF;","names":[]}

package/build/index.d.ts

@@ -1,284 +1,25 @@
-import { Constructor as Constructor$1, ImportAllFilesOptions, ReadAllFilesOptions, OmitProperties } from './src/types.js';
-export { default as slash } from 'slash';
-
-/**
- * Helper class to base64 encode/decode values with option
- * for url encoding and decoding
- */
-declare class Base64 {
-    /**
-     * Base64 encode Buffer or string
-     */
-    encode(arrayBuffer: ArrayBuffer | SharedArrayBuffer): string;
-    encode(data: string, encoding?: BufferEncoding): string;
-    /**
-     * Base64 decode a previously encoded string or Buffer.
-     */
-    decode(encode: string, encoding: BufferEncoding, strict: true): string;
-    decode(encode: string, encoding: undefined, strict: true): string;
-    decode(encode: string, encoding?: BufferEncoding, strict?: false): string | null;
-    decode(encode: Buffer, encoding?: BufferEncoding): string;
-    /**
-     * Base64 encode Buffer or string to be URL safe. (RFC 4648)
-     */
-    urlEncode(arrayBuffer: ArrayBuffer | SharedArrayBuffer): string;
-    urlEncode(data: string, encoding?: BufferEncoding): string;
-    /**
-     * Base64 URL decode a previously encoded string or Buffer. (RFC 4648)
-     */
-    urlDecode(encode: string, encoding: BufferEncoding, strict: true): string;
-    urlDecode(encode: string, encoding: undefined, strict: true): string;
-    urlDecode(encode: string, encoding?: BufferEncoding, strict?: false): string | null;
-    urlDecode(encode: Buffer, encoding?: BufferEncoding): string;
-}
-declare const base64: Base64;
-
-interface UnaryFunction<T, R> {
-    (source: T): R;
-}
-/**
- * Compose a class by applying mixins to it.
- * The code is inspired by https://justinfagnani.com/2015/12/21/real-mixins-with-javascript-classes/, its
- * just that I have added the support for static types too.
- */
-declare function compose<T extends Constructor$1, A>(superclass: T, mixin: UnaryFunction<T, A>): A;
-declare function compose<T extends Constructor$1, A, B>(superclass: T, mixin: UnaryFunction<T, A>, mixinB: UnaryFunction<A, B>): B;
-declare function compose<T extends Constructor$1, A, B, C>(superclass: T, mixin: UnaryFunction<T, A>, mixinB: UnaryFunction<A, B>, mixinC: UnaryFunction<B, C>): C;
-declare function compose<T extends Constructor$1, A, B, C, D>(superclass: T, mixin: UnaryFunction<T, A>, mixinB: UnaryFunction<A, B>, mixinC: UnaryFunction<B, C>, mixinD: UnaryFunction<C, D>): D;
-declare function compose<T extends Constructor$1, A, B, C, D, E>(superclass: T, mixin: UnaryFunction<T, A>, mixinB: UnaryFunction<A, B>, mixinC: UnaryFunction<B, C>, mixinD: UnaryFunction<C, D>, mixinE: UnaryFunction<D, E>): E;
-declare function compose<T extends Constructor$1, A, B, C, D, E, F>(superclass: T, mixin: UnaryFunction<T, A>, mixinB: UnaryFunction<A, B>, mixinC: UnaryFunction<B, C>, mixinD: UnaryFunction<C, D>, mixinF: UnaryFunction<E, F>): F;
-declare function compose<T extends Constructor$1, A, B, C, D, E, F, G>(superclass: T, mixin: UnaryFunction<T, A>, mixinB: UnaryFunction<A, B>, mixinC: UnaryFunction<B, C>, mixinD: UnaryFunction<C, D>, mixinF: UnaryFunction<E, F>, mixinG: UnaryFunction<F, G>): G;
-declare function compose<T extends Constructor$1, A, B, C, D, E, F, G, H>(superclass: T, mixin: UnaryFunction<T, A>, mixinB: UnaryFunction<A, B>, mixinC: UnaryFunction<B, C>, mixinD: UnaryFunction<C, D>, mixinF: UnaryFunction<E, F>, mixinG: UnaryFunction<F, G>, mixinH: UnaryFunction<G, H>): H;
-declare function compose<T extends Constructor$1, A, B, C, D, E, F, G, H, I>(superclass: T, mixin: UnaryFunction<T, A>, mixinB: UnaryFunction<A, B>, mixinC: UnaryFunction<B, C>, mixinD: UnaryFunction<C, D>, mixinF: UnaryFunction<E, F>, mixinG: UnaryFunction<F, G>, mixinH: UnaryFunction<G, H>, mixinI: UnaryFunction<H, I>): I;
-
-/**
- * Dynamically import a module and ensure it has a default export
- */
-declare function importDefault<T extends object>(importFn: () => Promise<T>, filePath?: string): Promise<T extends {
-    default: infer A;
-} ? A : never>;
-
-type Constructor = new (...args: any[]) => any;
-type AbstractConstructor = abstract new (...args: any[]) => any;
-/**
- * Define static properties on a class with inheritance in play.
- */
-declare function defineStaticProperty<T extends Constructor | AbstractConstructor, Prop extends keyof T>(self: T, propertyName: Prop, { initialValue, strategy, }: {
-    initialValue: T[Prop];
-    strategy: 'inherit' | 'define' | ((value: T[Prop]) => T[Prop]);
-}): void;
-
-/**
- * Extended Error object with the option to set error `status` and `code`.
- * At AdonisJs, we prefer exceptions with proper error codes to handle
- * them without relying on message pattern matching.
- *
- * ```js
- * new Exception('message', 500, 'E_RUNTIME_EXCEPTION')
- * ```
- */
-declare class Exception extends Error {
-    /**
-     * Static properties to defined on the exception once
-     * and then re-use them
-     */
-    static help?: string;
-    static code?: string;
-    static status?: number;
-    static message?: string;
-    /**
-     * Name of the class that raised the exception.
-     */
-    name: string;
-    /**
-     * Optional help description for the error. You can use it to define additional
-     * human readable information for the error.
-     */
-    help?: string;
-    /**
-     * A machine readable error code. This will allow the error handling logic
-     * to narrow down exceptions based upon the error code.
-     */
-    code?: string;
-    /**
-     * A status code for the error. Usually helpful when converting errors
-     * to HTTP responses.
-     */
-    status: number;
-    constructor(message?: string, options?: ErrorOptions & {
-        code?: string;
-        status?: number;
-    });
-    get [Symbol.toStringTag](): string;
-    toString(): string;
-}
-/**
- * Helper to create anonymous error classes
- */
-declare function createError<T extends any[] = never>(message: string, code: string, status?: number): typeof Exception & T extends never ? {
-    new (args?: any, options?: ErrorOptions): Exception;
-} : {
-    new (args: T, options?: ErrorOptions): Exception;
-};
-
-/**
- * Recursively flatten an object/array.
- */
-declare function flatten<X = Record<string, any>, Y = unknown>(input: Y, glue?: string, keepNullish?: boolean): X;
-
-/**
- * Returns an array of file paths from the given location. You can
- * optionally filter and sort files by passing relevant options
- *
- * ```ts
- * await fsReadAll(new URL('./', import.meta.url))
- *
- * await fsReadAll(new URL('./', import.meta.url), {
- *   filter: (filePath) => filePath.endsWith('.js')
- * })
-
- * await fsReadAll(new URL('./', import.meta.url), {
- *   absolute: true,
- *   unixPaths: true
- * })
-* ```
- */
-declare function fsImportAll(location: string | URL, options?: ImportAllFilesOptions): Promise<any>;
-
-/**
- * Returns an array of file paths from the given location. You can
- * optionally filter and sort files by passing relevant options
- *
- * ```ts
- * await fsReadAll(new URL('./', import.meta.url))
- *
- * await fsReadAll(new URL('./', import.meta.url), {
- *   filter: (filePath) => filePath.endsWith('.js')
- * })
-
- * await fsReadAll(new URL('./', import.meta.url), {
- *   absolute: true,
- *   unixPaths: true
- * })
-* ```
- */
-declare function fsReadAll(location: string | URL, options?: ReadAllFilesOptions): Promise<string[]>;
-
-/**
- * Returns `true` when file ends with `.js`, `.json` or
- * `.ts` but not `.d.ts`.
- */
-declare function isScriptFile(filePath: string): boolean;
-
-/**
- * Message builder exposes an API to "JSON.stringify" values by
- * encoding purpose and expiry date inside them.
- *
- * The return value must be further encrypted to prevent tempering.
- */
-declare class MessageBuilder {
-    #private;
-    /**
-     * Builds a message by encoding expiry date and purpose inside it.
-     */
-    build(message: any, expiresIn?: string | number, purpose?: string): string;
-    /**
-     * Verifies the message for expiry and purpose.
-     */
-    verify<T extends any>(message: any, purpose?: string): null | T;
-}
-
-/**
- * Perform natural sorting with "Array.sort()" method
- */
-declare function naturalSort(current: string, next: string): number;
-
-/**
- * A simple class to build an object incrementally. It is helpful when you
- * want to add properties to the object conditionally.
- *
- * Instead of writing
- * ```
- * const obj = {
- *   ...(user.id ? { id: user.id } : {}),
- *   ...(user.firstName && user.lastName ? { name: `${user.firstName} ${user.lastName}` } : {}),
- * }
- * ```
- *
- * You can write
- *
- * const obj = new ObjectBuilder()
- *   .add('id', user.id)
- *   .add(
- *     'fullName',
- *     user.firstName && user.lastName ? `${user.firstName} ${user.lastName}` : undefined
- *   )
- *   .toObject()
- */
-declare class ObjectBuilder<ReturnType extends Record<string, any>, IgnoreNull extends boolean = false> {
-    #private;
-    values: ReturnType;
-    constructor(initialValue: ReturnType, ignoreNull?: IgnoreNull);
-    /**
-     * Add a key-value pair to the object
-     *
-     * - Undefined values are ignored
-     * - Null values are ignored, when `ignoreNull` is set to true
-     */
-    add<Prop extends string>(key: Prop, value: undefined): this;
-    add<Prop extends string, Value>(key: Prop, value: Value): ObjectBuilder<ReturnType & {
-        [P in Prop]: Value;
-    }, IgnoreNull>;
-    /**
-     * Remove key from the object
-     */
-    remove<K extends keyof ReturnType>(key: K): this;
-    /**
-     * Find if a value exists
-     */
-    has<K extends keyof ReturnType>(key: K): boolean;
-    /**
-     * Get the existing value for a given key
-     */
-    get<K extends keyof ReturnType>(key: K): ReturnType[K];
-    /**
-     * Get the underlying constructed object
-     */
-    toObject(): IgnoreNull extends true ? {
-        [K in keyof OmitProperties<ReturnType, null>]: ReturnType[K];
-    } : {
-        [K in keyof ReturnType]: ReturnType[K];
-    };
-}
-
-type BufferSafeValue = ArrayBuffer | SharedArrayBuffer | number[] | string | {
-    valueOf(): string | object;
-} | {
-    [Symbol.toPrimitive](hint: 'string'): string;
-};
-/**
- * Compare two values to see if they are equal. The comparison is done in
- * a way to avoid timing-attacks.
- */
-declare function safeEqual<T extends BufferSafeValue, U extends BufferSafeValue>(trustedValue: T, userInput: U): boolean;
-
-declare class RuntimeException extends Exception {
-    static code: string;
-    static status: number;
-}
-
-declare class InvalidArgumentsException extends Exception {
-    static code: string;
-    static status: number;
-}
-
+/// <reference types="node" resolution-mode="require"/>
+export { base64 } from './src/base64.js';
+export { compose } from './src/compose.js';
+export { importDefault } from './src/import_default.js';
+export { defineStaticProperty } from './src/define_static_property.js';
+export { Exception, createError } from './src/exception.js';
+export { flatten } from './src/flatten.js';
+export { fsImportAll } from './src/fs_import_all.js';
+export { fsReadAll } from './src/fs_read_all.js';
+export { isScriptFile } from './src/is_script_file.js';
+export { MessageBuilder } from './src/message_builder.js';
+export { naturalSort } from './src/natural_sort.js';
+export { ObjectBuilder } from './src/object_builder.js';
+export { safeEqual } from './src/safe_equal.js';
+export { slash } from './src/slash.js';
+export { RuntimeException } from './src/exceptions/runtime_exception.js';
+export { InvalidArgumentsException } from './src/exceptions/invalid_arguments_exception.js';
 /**
  * Get dirname for a given file path URL
  */
-declare function getDirname(url: string | URL): string;
+export declare function getDirname(url: string | URL): string;
 /**
  * Get filename for a given file path URL
  */
-declare function getFilename(url: string | URL): string;
-
-export { Exception, InvalidArgumentsException, MessageBuilder, ObjectBuilder, RuntimeException, base64, compose, createError, defineStaticProperty, flatten, fsImportAll, fsReadAll, getDirname, getFilename, importDefault, isScriptFile, naturalSort, safeEqual };
+export declare function getFilename(url: string | URL): string;

package/build/index.js

@@ -1,10 +1,10 @@
 import {
   base64,
   milliseconds_default
-} from "./chunk-PWRXO3NF.js";
+} from "./chunk-NKGAOHNN.js";
 import {
   main_default
-} from "./chunk-XHQBV7AF.js";
+} from "./chunk-IOBSMUFC.js";
 
 // index.ts
 import { fileURLToPath as fileURLToPath3 } from "node:url";
@@ -371,3 +371,4 @@ export {
   safeEqual,
   default2 as slash
 };
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../index.ts","../src/compose.ts","../src/exception.ts","../src/exceptions/runtime_exception.ts","../src/import_default.ts","../src/define_static_property.ts","../src/flatten.ts","../src/fs_import_all.ts","../src/fs_read_all.ts","../src/slash.ts","../src/natural_sort.ts","../src/is_script_file.ts","../src/message_builder.ts","../src/object_builder.ts","../src/safe_equal.ts","../src/exceptions/invalid_arguments_exception.ts"],"sourcesContent":["/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { fileURLToPath } from 'node:url'\nimport { dirname as pathDirname } from 'node:path'\n\nexport { base64 } from './src/base64.js'\nexport { compose } from './src/compose.js'\nexport { importDefault } from './src/import_default.js'\nexport { defineStaticProperty } from './src/define_static_property.js'\nexport { Exception, createError } from './src/exception.js'\nexport { flatten } from './src/flatten.js'\nexport { fsImportAll } from './src/fs_import_all.js'\nexport { fsReadAll } from './src/fs_read_all.js'\nexport { isScriptFile } from './src/is_script_file.js'\nexport { MessageBuilder } from './src/message_builder.js'\nexport { naturalSort } from './src/natural_sort.js'\nexport { ObjectBuilder } from './src/object_builder.js'\nexport { safeEqual } from './src/safe_equal.js'\nexport { slash } from './src/slash.js'\nexport { RuntimeException } from './src/exceptions/runtime_exception.js'\nexport { InvalidArgumentsException } from './src/exceptions/invalid_arguments_exception.js'\n\n/**\n * Get dirname for a given file path URL\n */\nexport function getDirname(url: string | URL) {\n  return pathDirname(getFilename(url))\n}\n\n/**\n * Get filename for a given file path URL\n */\nexport function getFilename(url: string | URL) {\n  return fileURLToPath(url)\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport type { Constructor } from './types.js'\n\ninterface UnaryFunction<T, R> {\n  (source: T): R\n}\n\n/**\n * Compose a class by applying mixins to it.\n * The code is inspired by https://justinfagnani.com/2015/12/21/real-mixins-with-javascript-classes/, its\n * just that I have added the support for static types too.\n */\nexport function compose<T extends Constructor, A>(superclass: T, mixin: UnaryFunction<T, A>): A\nexport function compose<T extends Constructor, A, B>(\n  superclass: T,\n  mixin: UnaryFunction<T, A>,\n  mixinB: UnaryFunction<A, B>\n): B\nexport function compose<T extends Constructor, A, B, C>(\n  superclass: T,\n  mixin: UnaryFunction<T, A>,\n  mixinB: UnaryFunction<A, B>,\n  mixinC: UnaryFunction<B, C>\n): C\nexport function compose<T extends Constructor, A, B, C, D>(\n  superclass: T,\n  mixin: UnaryFunction<T, A>,\n  mixinB: UnaryFunction<A, B>,\n  mixinC: UnaryFunction<B, C>,\n  mixinD: UnaryFunction<C, D>\n): D\nexport function compose<T extends Constructor, A, B, C, D, E>(\n  superclass: T,\n  mixin: UnaryFunction<T, A>,\n  mixinB: UnaryFunction<A, B>,\n  mixinC: UnaryFunction<B, C>,\n  mixinD: UnaryFunction<C, D>,\n  mixinE: UnaryFunction<D, E>\n): E\nexport function compose<T extends Constructor, A, B, C, D, E, F>(\n  superclass: T,\n  mixin: UnaryFunction<T, A>,\n  mixinB: UnaryFunction<A, B>,\n  mixinC: UnaryFunction<B, C>,\n  mixinD: UnaryFunction<C, D>,\n  mixinF: UnaryFunction<E, F>\n): F\nexport function compose<T extends Constructor, A, B, C, D, E, F, G>(\n  superclass: T,\n  mixin: UnaryFunction<T, A>,\n  mixinB: UnaryFunction<A, B>,\n  mixinC: UnaryFunction<B, C>,\n  mixinD: UnaryFunction<C, D>,\n  mixinF: UnaryFunction<E, F>,\n  mixinG: UnaryFunction<F, G>\n): G\nexport function compose<T extends Constructor, A, B, C, D, E, F, G, H>(\n  superclass: T,\n  mixin: UnaryFunction<T, A>,\n  mixinB: UnaryFunction<A, B>,\n  mixinC: UnaryFunction<B, C>,\n  mixinD: UnaryFunction<C, D>,\n  mixinF: UnaryFunction<E, F>,\n  mixinG: UnaryFunction<F, G>,\n  mixinH: UnaryFunction<G, H>\n): H\nexport function compose<T extends Constructor, A, B, C, D, E, F, G, H, I>(\n  superclass: T,\n  mixin: UnaryFunction<T, A>,\n  mixinB: UnaryFunction<A, B>,\n  mixinC: UnaryFunction<B, C>,\n  mixinD: UnaryFunction<C, D>,\n  mixinF: UnaryFunction<E, F>,\n  mixinG: UnaryFunction<F, G>,\n  mixinH: UnaryFunction<G, H>,\n  mixinI: UnaryFunction<H, I>\n): I\nexport function compose<T extends Constructor, Mixins extends UnaryFunction<T, T>>(\n  superclass: T,\n  ...mixins: Mixins[]\n) {\n  return mixins.reduce((c, mixin) => mixin(c), superclass)\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { format } from 'node:util'\n\n/**\n * Extended Error object with the option to set error `status` and `code`.\n * At AdonisJs, we prefer exceptions with proper error codes to handle\n * them without relying on message pattern matching.\n *\n * ```js\n * new Exception('message', 500, 'E_RUNTIME_EXCEPTION')\n * ```\n */\nexport class Exception extends Error {\n  /**\n   * Static properties to defined on the exception once\n   * and then re-use them\n   */\n  declare static help?: string\n  declare static code?: string\n  declare static status?: number\n  declare static message?: string\n\n  /**\n   * Name of the class that raised the exception.\n   */\n  name: string\n\n  /**\n   * Optional help description for the error. You can use it to define additional\n   * human readable information for the error.\n   */\n  declare help?: string\n\n  /**\n   * A machine readable error code. This will allow the error handling logic\n   * to narrow down exceptions based upon the error code.\n   */\n  declare code?: string\n\n  /**\n   * A status code for the error. Usually helpful when converting errors\n   * to HTTP responses.\n   */\n  status: number\n\n  constructor(message?: string, options?: ErrorOptions & { code?: string; status?: number }) {\n    super(message, options)\n\n    const ErrorConstructor = this.constructor as typeof Exception\n\n    this.name = ErrorConstructor.name\n    this.message = message || ErrorConstructor.message || ''\n    this.status = options?.status || ErrorConstructor.status || 500\n\n    const code = options?.code || ErrorConstructor.code\n    if (code !== undefined) {\n      this.code = code\n    }\n\n    const help = ErrorConstructor.help\n    if (help !== undefined) {\n      this.help = help\n    }\n\n    Error.captureStackTrace(this, ErrorConstructor)\n  }\n\n  get [Symbol.toStringTag]() {\n    return this.constructor.name\n  }\n\n  toString() {\n    if (this.code) {\n      return `${this.name} [${this.code}]: ${this.message}`\n    }\n    return `${this.name}: ${this.message}`\n  }\n}\n\n/**\n * Helper to create anonymous error classes\n */\nexport function createError<T extends any[] = never>(\n  message: string,\n  code: string,\n  status?: number\n): typeof Exception & T extends never\n  ? { new (args?: any, options?: ErrorOptions): Exception }\n  : { new (args: T, options?: ErrorOptions): Exception } {\n  return class extends Exception {\n    static message = message\n    static code = code\n    static status = status\n\n    constructor(args: T, options?: ErrorOptions) {\n      super(format(message, ...(args || [])), options)\n    }\n  }\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { Exception } from '../exception.js'\n\nexport class RuntimeException extends Exception {\n  static code = 'E_RUNTIME_EXCEPTION'\n  static status = 500\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { RuntimeException } from './exceptions/runtime_exception.js'\n\n/**\n * Dynamically import a module and ensure it has a default export\n */\nexport async function importDefault<T extends object>(\n  importFn: () => Promise<T>,\n  filePath?: string\n): Promise<T extends { default: infer A } ? A : never> {\n  const moduleExports = await importFn()\n\n  /**\n   * Make sure a default export exists\n   */\n  if (!('default' in moduleExports)) {\n    const errorMessage = filePath\n      ? `Missing \"export default\" in module \"${filePath}\"`\n      : `Missing \"export default\" from lazy import \"${importFn}\"`\n\n    throw new RuntimeException(errorMessage, {\n      cause: {\n        source: importFn,\n      },\n    })\n  }\n\n  return moduleExports.default as Promise<T extends { default: infer A } ? A : never>\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport lodash from '@poppinss/utils/lodash'\n\ntype Constructor = new (...args: any[]) => any\ntype AbstractConstructor = abstract new (...args: any[]) => any\n\n/**\n * Define static properties on a class with inheritance in play.\n */\nexport function defineStaticProperty<\n  T extends Constructor | AbstractConstructor,\n  Prop extends keyof T,\n>(\n  self: T,\n  propertyName: Prop,\n  {\n    initialValue,\n    strategy,\n  }: {\n    initialValue: T[Prop]\n    strategy: 'inherit' | 'define' | ((value: T[Prop]) => T[Prop])\n  }\n) {\n  if (!self.hasOwnProperty(propertyName)) {\n    const value = self[propertyName]\n\n    /**\n     * Define the property as it is when the strategy is set\n     * to \"define\". Or the value on the prototype chain\n     * is set to undefined.\n     */\n    if (strategy === 'define' || value === undefined) {\n      Object.defineProperty(self, propertyName, {\n        value: initialValue,\n        configurable: true,\n        enumerable: true,\n        writable: true,\n      })\n      return\n    }\n\n    Object.defineProperty(self, propertyName, {\n      value: typeof strategy === 'function' ? strategy(value) : lodash.cloneDeep(value),\n      configurable: true,\n      enumerable: true,\n      writable: true,\n    })\n  }\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\n// @ts-expect-error (Package has no types)\nimport { flattie } from 'flattie'\n\n/**\n * Recursively flatten an object/array.\n */\nexport function flatten<X = Record<string, any>, Y = unknown>(\n  input: Y,\n  glue?: string,\n  keepNullish?: boolean\n): X {\n  return flattie(input, glue, keepNullish)\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { fileURLToPath } from 'node:url'\nimport lodash from '@poppinss/utils/lodash'\nimport { extname, relative, sep } from 'node:path'\n\nimport { fsReadAll } from './fs_read_all.js'\nimport { ImportAllFilesOptions } from './types.js'\nimport { isScriptFile } from './is_script_file.js'\n\n/**\n * Import the file and update the values collection with the default\n * export.\n */\nasync function importFile(\n  basePath: string,\n  fileURL: string,\n  values: any,\n  options: ImportAllFilesOptions\n) {\n  /**\n   * Converting URL to file path\n   */\n  const filePath = fileURLToPath(fileURL)\n\n  /**\n   * Grab file extension\n   */\n  const fileExtension = extname(filePath)\n\n  const collectionKey = relative(basePath, filePath) // Get file relative path\n    .replace(new RegExp(`${fileExtension}$`), '') // Get rid of the file extension\n    .split(sep) // Convert nested paths to an array of keys\n\n  /**\n   * Import module\n   */\n  const exportedValue =\n    fileExtension === '.json'\n      ? await import(fileURL, { assert: { type: 'json' } })\n      : await import(fileURL)\n\n  lodash.set(\n    values,\n    options.transformKeys ? options.transformKeys(collectionKey) : collectionKey,\n    exportedValue.default ? exportedValue.default : { ...exportedValue }\n  )\n}\n\n/**\n * Returns an array of file paths from the given location. You can\n * optionally filter and sort files by passing relevant options\n *\n * ```ts\n * await fsReadAll(new URL('./', import.meta.url))\n *\n * await fsReadAll(new URL('./', import.meta.url), {\n *   filter: (filePath) => filePath.endsWith('.js')\n * })\n\n * await fsReadAll(new URL('./', import.meta.url), {\n *   absolute: true,\n *   unixPaths: true\n * })\n* ```\n */\nexport async function fsImportAll(\n  location: string | URL,\n  options?: ImportAllFilesOptions\n): Promise<any> {\n  options = options || {}\n  const collection: any = {}\n  const normalizedLocation = typeof location === 'string' ? location : fileURLToPath(location)\n  const files = await fsReadAll(normalizedLocation, {\n    filter: isScriptFile,\n    ...options,\n    pathType: 'url',\n  })\n\n  /**\n   * Parallelly import all the files and mutate the values collection\n   */\n  await Promise.all(files.map((file) => importFile(normalizedLocation, file, collection, options!)))\n\n  return collection\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { join } from 'node:path'\nimport { readdir, stat } from 'node:fs/promises'\nimport { fileURLToPath, pathToFileURL } from 'node:url'\n\nimport { slash } from './slash.js'\nimport { naturalSort } from './natural_sort.js'\nimport { ReadAllFilesOptions } from './types.js'\n\n/**\n * Filter to remove dot files\n */\nfunction filterDotFiles(fileName: string) {\n  return fileName[0] !== '.'\n}\n\n/**\n * Read all files from the directory recursively\n */\nasync function readFiles(\n  root: string,\n  files: string[],\n  options: ReadAllFilesOptions,\n  relativePath: string\n): Promise<void> {\n  const location = join(root, relativePath)\n  const stats = await stat(location)\n\n  if (stats.isDirectory()) {\n    let locationFiles = await readdir(location)\n\n    await Promise.all(\n      locationFiles.filter(filterDotFiles).map((file) => {\n        return readFiles(root, files, options, join(relativePath, file))\n      })\n    )\n\n    return\n  }\n\n  const pathType = options.pathType || 'relative'\n  switch (pathType) {\n    case 'relative':\n      files.push(relativePath)\n      break\n    case 'absolute':\n      files.push(location)\n      break\n    case 'unixRelative':\n      files.push(slash(relativePath))\n      break\n    case 'unixAbsolute':\n      files.push(slash(location))\n      break\n    case 'url':\n      files.push(pathToFileURL(location).href)\n  }\n}\n\n/**\n * Returns an array of file paths from the given location. You can\n * optionally filter and sort files by passing relevant options\n *\n * ```ts\n * await fsReadAll(new URL('./', import.meta.url))\n *\n * await fsReadAll(new URL('./', import.meta.url), {\n *   filter: (filePath) => filePath.endsWith('.js')\n * })\n\n * await fsReadAll(new URL('./', import.meta.url), {\n *   absolute: true,\n *   unixPaths: true\n * })\n* ```\n */\nexport async function fsReadAll(\n  location: string | URL,\n  options?: ReadAllFilesOptions\n): Promise<string[]> {\n  const normalizedLocation = typeof location === 'string' ? location : fileURLToPath(location)\n  const normalizedOptions = Object.assign({ absolute: false, sort: naturalSort }, options)\n  const files: string[] = []\n\n  /**\n   * Check to see if the root directory exists and ignore\n   * error when \"ignoreMissingRoot\" is set to true\n   */\n  try {\n    await stat(normalizedLocation)\n  } catch (error) {\n    if (normalizedOptions.ignoreMissingRoot) {\n      return []\n    }\n\n    throw error\n  }\n\n  await readFiles(normalizedLocation, files, normalizedOptions, '')\n\n  if (normalizedOptions.filter) {\n    return files.filter(normalizedOptions.filter).sort(normalizedOptions.sort)\n  }\n\n  return files.sort(normalizedOptions.sort)\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nexport { default as slash } from 'slash'\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\n/**\n * Perform natural sorting with \"Array.sort()\" method\n */\nexport function naturalSort(current: string, next: string) {\n  return current.localeCompare(next, undefined, { numeric: true, sensitivity: 'base' })\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { extname } from 'node:path'\nconst JS_MODULES = ['.js', '.json', '.cjs', '.mjs']\n\n/**\n * Returns `true` when file ends with `.js`, `.json` or\n * `.ts` but not `.d.ts`.\n */\nexport function isScriptFile(filePath: string) {\n  const ext = extname(filePath)\n\n  if (JS_MODULES.includes(ext)) {\n    return true\n  }\n\n  if (ext === '.ts' && !filePath.endsWith('.d.ts')) {\n    return true\n  }\n\n  return false\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport json from './json/main.js'\nimport milliseconds from './string/milliseconds.js'\n\n/**\n * Message builder exposes an API to \"JSON.stringify\" values by\n * encoding purpose and expiry date inside them.\n *\n * The return value must be further encrypted to prevent tempering.\n */\nexport class MessageBuilder {\n  #getExpiryDate(expiresIn?: string | number): undefined | Date {\n    if (!expiresIn) {\n      return undefined\n    }\n\n    const expiryMs = milliseconds.parse(expiresIn)\n    return new Date(Date.now() + expiryMs)\n  }\n\n  /**\n   * Returns a boolean telling, if message has been expired or not\n   */\n  #isExpired(message: any) {\n    if (!message.expiryDate) {\n      return false\n    }\n\n    const expiryDate = new Date(message.expiryDate)\n    return Number.isNaN(expiryDate.getTime()) || expiryDate < new Date()\n  }\n\n  /**\n   * Builds a message by encoding expiry date and purpose inside it.\n   */\n  build(message: any, expiresIn?: string | number, purpose?: string): string {\n    const expiryDate = this.#getExpiryDate(expiresIn)\n    return json.safeStringify({ message, purpose, expiryDate })!\n  }\n\n  /**\n   * Verifies the message for expiry and purpose.\n   */\n  verify<T extends any>(message: any, purpose?: string): null | T {\n    const parsed = json.safeParse(message)\n\n    /**\n     * After JSON.parse we do not receive a valid object\n     */\n    if (typeof parsed !== 'object' || !parsed) {\n      return null\n    }\n\n    /**\n     * Missing \".message\" property\n     */\n    if (!parsed.message) {\n      return null\n    }\n\n    /**\n     * Ensure purposes are same.\n     */\n    if (parsed.purpose !== purpose) {\n      return null\n    }\n\n    /**\n     * Ensure isn't expired\n     */\n    if (this.#isExpired(parsed)) {\n      return null\n    }\n\n    return parsed.message\n  }\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { OmitProperties } from './types.js'\n\n/**\n * A simple class to build an object incrementally. It is helpful when you\n * want to add properties to the object conditionally.\n *\n * Instead of writing\n * ```\n * const obj = {\n *   ...(user.id ? { id: user.id } : {}),\n *   ...(user.firstName && user.lastName ? { name: `${user.firstName} ${user.lastName}` } : {}),\n * }\n * ```\n *\n * You can write\n *\n * const obj = new ObjectBuilder()\n *   .add('id', user.id)\n *   .add(\n *     'fullName',\n *     user.firstName && user.lastName ? `${user.firstName} ${user.lastName}` : undefined\n *   )\n *   .toObject()\n */\nexport class ObjectBuilder<\n  ReturnType extends Record<string, any>,\n  IgnoreNull extends boolean = false,\n> {\n  #ignoreNull: boolean\n  values: ReturnType\n\n  constructor(initialValue: ReturnType, ignoreNull?: IgnoreNull) {\n    this.values = initialValue\n    this.#ignoreNull = ignoreNull === true ? true : false\n  }\n\n  /**\n   * Add a key-value pair to the object\n   *\n   * - Undefined values are ignored\n   * - Null values are ignored, when `ignoreNull` is set to true\n   */\n  add<Prop extends string>(key: Prop, value: undefined): this\n  add<Prop extends string, Value>(\n    key: Prop,\n    value: Value\n  ): ObjectBuilder<ReturnType & { [P in Prop]: Value }, IgnoreNull>\n  add<Prop extends string, Value>(key: Prop, value: Value): this {\n    if (value === undefined) {\n      return this\n    }\n\n    if (this.#ignoreNull === true && value === null) {\n      return this\n    }\n\n    ;(this.values as any)[key] = value\n    return this\n  }\n\n  /**\n   * Remove key from the object\n   */\n  remove<K extends keyof ReturnType>(key: K): this {\n    delete this.values[key]\n    return this\n  }\n\n  /**\n   * Find if a value exists\n   */\n  has<K extends keyof ReturnType>(key: K): boolean {\n    return this.get(key) !== undefined\n  }\n\n  /**\n   * Get the existing value for a given key\n   */\n  get<K extends keyof ReturnType>(key: K): ReturnType[K] {\n    return this.values[key]\n  }\n\n  /**\n   * Get the underlying constructed object\n   */\n  toObject(): IgnoreNull extends true\n    ? { [K in keyof OmitProperties<ReturnType, null>]: ReturnType[K] }\n    : { [K in keyof ReturnType]: ReturnType[K] } {\n    return this.values\n  }\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { Buffer } from 'node:buffer'\nimport { timingSafeEqual } from 'node:crypto'\n\ntype BufferSafeValue =\n  | ArrayBuffer\n  | SharedArrayBuffer\n  | number[]\n  | string\n  | { valueOf(): string | object }\n  | { [Symbol.toPrimitive](hint: 'string'): string }\n\n/**\n * Compare two values to see if they are equal. The comparison is done in\n * a way to avoid timing-attacks.\n */\nexport function safeEqual<T extends BufferSafeValue, U extends BufferSafeValue>(\n  trustedValue: T,\n  userInput: U\n): boolean {\n  if (typeof trustedValue === 'string' && typeof userInput === 'string') {\n    /**\n     * The length of the comparison value.\n     */\n    const trustedLength = Buffer.byteLength(trustedValue)\n\n    /**\n     * Expected value\n     */\n    const trustedValueBuffer = Buffer.alloc(trustedLength, 0, 'utf-8')\n    trustedValueBuffer.write(trustedValue)\n\n    /**\n     * Actual value (taken from user input)\n     */\n    const userValueBuffer = Buffer.alloc(trustedLength, 0, 'utf-8')\n    userValueBuffer.write(userInput)\n\n    /**\n     * Ensure values are same and also have same length\n     */\n    return (\n      timingSafeEqual(trustedValueBuffer, userValueBuffer) &&\n      trustedLength === Buffer.byteLength(userInput)\n    )\n  }\n\n  return timingSafeEqual(\n    Buffer.from(trustedValue as ArrayBuffer | SharedArrayBuffer),\n    Buffer.from(userInput as ArrayBuffer | SharedArrayBuffer)\n  )\n}\n","/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { Exception } from '../exception.js'\n\nexport class InvalidArgumentsException extends Exception {\n  static code = 'E_INVALID_ARGUMENTS_EXCEPTION'\n  static status = 500\n}\n"],"mappings":"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","names":["fileURLToPath","fileURLToPath","lodash","extname","default","default","fileURLToPath","extname","lodash","fileURLToPath"]}

package/build/src/assert.d.ts

@@ -1,5 +1,3 @@
-declare function assert(value: unknown, message?: string): asserts value;
-declare function assertUnreachable(x?: never): never;
-declare function assertNotNull<T>(value: T | null): asserts value is Exclude<T, null>;
-
-export { assert, assertNotNull, assertUnreachable };
+export declare function assert(value: unknown, message?: string): asserts value;
+export declare function assertUnreachable(x?: never): never;
+export declare function assertNotNull<T>(value: T | null): asserts value is Exclude<T, null>;

package/build/src/assert.js

@@ -17,3 +17,4 @@ export {
   assertNotNull,
   assertUnreachable
 };
+//# sourceMappingURL=assert.js.map

package/build/src/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/assert.ts"],"sourcesContent":["/*\n * @poppinss/utils\n *\n * (c) Poppinss\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nexport function assert(value: unknown, message?: string): asserts value {\n  if (!value) {\n    throw new Error(message ?? 'value is falsy')\n  }\n}\n\nexport function assertUnreachable(x?: never): never {\n  throw new Error(`unreachable code executed: ${String(x)}`)\n}\n\nexport function assertNotNull<T>(value: T | null): asserts value is Exclude<T, null> {\n  if (value === null) {\n    throw new Error('unexpected null value')\n  }\n}\n"],"mappings":";AASO,SAAS,OAAO,OAAgB,SAAiC;AACtE,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,WAAW,gBAAgB;AAAA,EAC7C;AACF;AAEO,SAAS,kBAAkB,GAAkB;AAClD,QAAM,IAAI,MAAM,8BAA8B,OAAO,CAAC,CAAC,EAAE;AAC3D;AAEO,SAAS,cAAiB,OAAoD;AACnF,MAAI,UAAU,MAAM;AAClB,UAAM,IAAI,MAAM,uBAAuB;AAAA,EACzC;AACF;","names":[]}

package/build/src/base64.d.ts

@@ -0,0 +1,33 @@
+/// <reference types="node" resolution-mode="require"/>
+/**
+ * Helper class to base64 encode/decode values with option
+ * for url encoding and decoding
+ */
+declare class Base64 {
+    /**
+     * Base64 encode Buffer or string
+     */
+    encode(arrayBuffer: ArrayBuffer | SharedArrayBuffer): string;
+    encode(data: string, encoding?: BufferEncoding): string;
+    /**
+     * Base64 decode a previously encoded string or Buffer.
+     */
+    decode(encode: string, encoding: BufferEncoding, strict: true): string;
+    decode(encode: string, encoding: undefined, strict: true): string;
+    decode(encode: string, encoding?: BufferEncoding, strict?: false): string | null;
+    decode(encode: Buffer, encoding?: BufferEncoding): string;
+    /**
+     * Base64 encode Buffer or string to be URL safe. (RFC 4648)
+     */
+    urlEncode(arrayBuffer: ArrayBuffer | SharedArrayBuffer): string;
+    urlEncode(data: string, encoding?: BufferEncoding): string;
+    /**
+     * Base64 URL decode a previously encoded string or Buffer. (RFC 4648)
+     */
+    urlDecode(encode: string, encoding: BufferEncoding, strict: true): string;
+    urlDecode(encode: string, encoding: undefined, strict: true): string;
+    urlDecode(encode: string, encoding?: BufferEncoding, strict?: false): string | null;
+    urlDecode(encode: Buffer, encoding?: BufferEncoding): string;
+}
+export declare const base64: Base64;
+export {};

package/build/src/compose.d.ts

@@ -0,0 +1,19 @@
+import type { Constructor } from './types.js';
+interface UnaryFunction<T, R> {
+    (source: T): R;
+}
+/**
+ * Compose a class by applying mixins to it.
+ * The code is inspired by https://justinfagnani.com/2015/12/21/real-mixins-with-javascript-classes/, its
+ * just that I have added the support for static types too.
+ */
+export declare function compose<T extends Constructor, A>(superclass: T, mixin: UnaryFunction<T, A>): A;
+export declare function compose<T extends Constructor, A, B>(superclass: T, mixin: UnaryFunction<T, A>, mixinB: UnaryFunction<A, B>): B;
+export declare function compose<T extends Constructor, A, B, C>(superclass: T, mixin: UnaryFunction<T, A>, mixinB: UnaryFunction<A, B>, mixinC: UnaryFunction<B, C>): C;
+export declare function compose<T extends Constructor, A, B, C, D>(superclass: T, mixin: UnaryFunction<T, A>, mixinB: UnaryFunction<A, B>, mixinC: UnaryFunction<B, C>, mixinD: UnaryFunction<C, D>): D;
+export declare function compose<T extends Constructor, A, B, C, D, E>(superclass: T, mixin: UnaryFunction<T, A>, mixinB: UnaryFunction<A, B>, mixinC: UnaryFunction<B, C>, mixinD: UnaryFunction<C, D>, mixinE: UnaryFunction<D, E>): E;
+export declare function compose<T extends Constructor, A, B, C, D, E, F>(superclass: T, mixin: UnaryFunction<T, A>, mixinB: UnaryFunction<A, B>, mixinC: UnaryFunction<B, C>, mixinD: UnaryFunction<C, D>, mixinF: UnaryFunction<E, F>): F;
+export declare function compose<T extends Constructor, A, B, C, D, E, F, G>(superclass: T, mixin: UnaryFunction<T, A>, mixinB: UnaryFunction<A, B>, mixinC: UnaryFunction<B, C>, mixinD: UnaryFunction<C, D>, mixinF: UnaryFunction<E, F>, mixinG: UnaryFunction<F, G>): G;
+export declare function compose<T extends Constructor, A, B, C, D, E, F, G, H>(superclass: T, mixin: UnaryFunction<T, A>, mixinB: UnaryFunction<A, B>, mixinC: UnaryFunction<B, C>, mixinD: UnaryFunction<C, D>, mixinF: UnaryFunction<E, F>, mixinG: UnaryFunction<F, G>, mixinH: UnaryFunction<G, H>): H;
+export declare function compose<T extends Constructor, A, B, C, D, E, F, G, H, I>(superclass: T, mixin: UnaryFunction<T, A>, mixinB: UnaryFunction<A, B>, mixinC: UnaryFunction<B, C>, mixinD: UnaryFunction<C, D>, mixinF: UnaryFunction<E, F>, mixinG: UnaryFunction<F, G>, mixinH: UnaryFunction<G, H>, mixinI: UnaryFunction<H, I>): I;
+export {};

package/build/src/define_static_property.d.ts

@@ -0,0 +1,10 @@
+type Constructor = new (...args: any[]) => any;
+type AbstractConstructor = abstract new (...args: any[]) => any;
+/**
+ * Define static properties on a class with inheritance in play.
+ */
+export declare function defineStaticProperty<T extends Constructor | AbstractConstructor, Prop extends keyof T>(self: T, propertyName: Prop, { initialValue, strategy, }: {
+    initialValue: T[Prop];
+    strategy: 'inherit' | 'define' | ((value: T[Prop]) => T[Prop]);
+}): void;
+export {};

package/build/src/exception.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Extended Error object with the option to set error `status` and `code`.
+ * At AdonisJs, we prefer exceptions with proper error codes to handle
+ * them without relying on message pattern matching.
+ *
+ * ```js
+ * new Exception('message', 500, 'E_RUNTIME_EXCEPTION')
+ * ```
+ */
+export declare class Exception extends Error {
+    /**
+     * Static properties to defined on the exception once
+     * and then re-use them
+     */
+    static help?: string;
+    static code?: string;
+    static status?: number;
+    static message?: string;
+    /**
+     * Name of the class that raised the exception.
+     */
+    name: string;
+    /**
+     * Optional help description for the error. You can use it to define additional
+     * human readable information for the error.
+     */
+    help?: string;
+    /**
+     * A machine readable error code. This will allow the error handling logic
+     * to narrow down exceptions based upon the error code.
+     */
+    code?: string;
+    /**
+     * A status code for the error. Usually helpful when converting errors
+     * to HTTP responses.
+     */
+    status: number;
+    constructor(message?: string, options?: ErrorOptions & {
+        code?: string;
+        status?: number;
+    });
+    get [Symbol.toStringTag](): string;
+    toString(): string;
+}
+/**
+ * Helper to create anonymous error classes
+ */
+export declare function createError<T extends any[] = never>(message: string, code: string, status?: number): typeof Exception & T extends never ? {
+    new (args?: any, options?: ErrorOptions): Exception;
+} : {
+    new (args: T, options?: ErrorOptions): Exception;
+};