@catbee/utils 0.0.2 → 0.0.4

package/build/esm/utils/crypto.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"crypto.utils.js","sourceRoot":"","sources":["../../../src/utils/crypto.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  createHmac,\n  createHash,\n  BinaryToTextEncoding,\n  randomUUID,\n  randomBytes,\n  createCipheriv,\n  createDecipheriv,\n  scrypt,\n  timingSafeEqual,\n  CipherGCMTypes,\n} from \"crypto\";\nimport { promisify } from \"util\";\n\nexport type BufferEncoding =\n  | \"ascii\"\n  | \"utf8\"\n  | \"utf-8\"\n  | \"utf16le\"\n  | \"utf-16le\"\n  | \"ucs2\"\n  | \"ucs-2\"\n  | \"base64\"\n  | \"base64url\"\n  | \"latin1\"\n  | \"binary\"\n  | \"hex\";\n\n/**\n * Generates an HMAC digest using the specified algorithm and secret key.\n *\n * @param {string} algorithm - The hashing algorithm (e.g., 'sha256', 'sha1').\n * @param {string} input - The string to hash.\n * @param {string} secret - The secret key for HMAC.\n * @param {BinaryToTextEncoding} [encoding='hex'] - Output encoding ('hex', 'base64', etc).\n * @returns {string} HMAC digest as a string.\n */\nexport function hmac(\n  algorithm: string,\n  input: string,\n  secret: string,\n  encoding: BinaryToTextEncoding = \"hex\",\n): string {\n  return createHmac(algorithm, secret).update(input).digest(encoding);\n}\n\n/**\n * Generates a hash digest using the specified algorithm.\n *\n * @param {string} algorithm - The hashing algorithm (e.g., 'sha256', 'md5').\n * @param {string} input - The string to hash.\n * @param {BinaryToTextEncoding} [encoding='hex'] - Output encoding ('hex', 'base64', etc).\n * @returns {string} Hash digest as a string.\n */\nexport function hash(\n  algorithm: string,\n  input: string,\n  encoding: BinaryToTextEncoding = \"hex\",\n): string {\n  return createHash(algorithm).update(input).digest(encoding);\n}\n\n/**\n * Generates an HMAC-SHA256 digest.\n *\n * @param {string} input - The string to hash.\n * @param {string} secret - The secret key.\n * @returns {string} SHA-256 HMAC digest as a string.\n */\nexport function sha256Hmac(input: string, secret: string): string {\n  return hmac(\"sha256\", input, secret);\n}\n\n/**\n * Generates a SHA1 hash digest.\n *\n * @param {string} input - The string to hash.\n * @param {BinaryToTextEncoding} [encoding='hex'] - Output encoding.\n * @returns {string} SHA-1 hash as a string.\n */\nexport function sha1(\n  input: string,\n  encoding: BinaryToTextEncoding = \"hex\",\n): string {\n  return hash(\"sha1\", input, encoding);\n}\n\n/**\n * Generates a SHA256 hash digest.\n *\n * @param {string} input - The string to hash.\n * @param {BinaryToTextEncoding} [encoding='hex'] - Output encoding.\n * @returns {string} SHA-256 hash as a string.\n */\nexport function sha256(\n  input: string,\n  encoding: BinaryToTextEncoding = \"hex\",\n): string {\n  return hash(\"sha256\", input, encoding);\n}\n\n/**\n * Generates an MD5 hash digest.\n *\n * @param {string} input - The string to hash.\n * @returns {string} MD5 hash as a string.\n */\nexport function md5(input: string): string {\n  return hash(\"md5\", input);\n}\n\n/**\n * Generates a cryptographically strong random string by hashing a random UUID with SHA-256.\n *\n * @returns {string} Random string hashed with SHA-256 (hex encoding).\n */\nexport function randomString(): string {\n  return sha256(randomUUID());\n}\n\n/**\n * Generates a secure random buffer of specified byte length.\n *\n * @param {number} [byteLength=32] - Number of random bytes to generate.\n * @returns {Buffer} Buffer containing random bytes.\n */\nexport function generateRandomBytes(byteLength: number = 32): Buffer {\n  return randomBytes(byteLength);\n}\n\n/**\n * Generates a secure random string of specified byte length with specified encoding.\n *\n * @param {number} [byteLength=32] - Number of random bytes to generate.\n * @param {BinaryToTextEncoding} [encoding='hex'] - Output encoding.\n * @returns {string} Random string in specified encoding.\n */\nexport function generateRandomBytesAsString(\n  byteLength: number = 32,\n  encoding: BinaryToTextEncoding = \"hex\",\n): string {\n  return randomBytes(byteLength).toString(encoding);\n}\n\n/**\n * Generates a secure API key with a specified format.\n *\n * @param {string} [prefix=''] - Optional prefix for the key.\n * @param {number} [byteLength=24] - Number of random bytes to generate.\n * @returns {string} Formatted API key.\n */\nexport function generateApiKey(\n  prefix: string = \"\",\n  byteLength: number = 24,\n): string {\n  const randomString = generateRandomBytesAsString(byteLength, \"base64\");\n  const key = randomString\n    .replace(/[+/=]/g, \"\") // Remove non-URL-safe characters\n    .substring(0, 32); // Limit length\n\n  return prefix ? `${prefix}_${key}` : key;\n}\n\n/**\n * Compares two strings, arrays, or buffers in constant time to prevent timing attacks.\n *\n * @param {string | Buffer | Uint8Array} a - First value to compare\n * @param {string | Buffer | Uint8Array} b - Second value to compare\n * @returns {boolean} True if values are equal\n */\nexport function safeCompare(\n  a: string | Buffer | Uint8Array,\n  b: string | Buffer | Uint8Array,\n): boolean {\n  if (typeof a === \"string\" && typeof b === \"string\") {\n    // Convert strings to buffers\n    const bufA = Buffer.from(a);\n    const bufB = Buffer.from(b);\n\n    // Compare lengths first (not constant time, but prevents timing attack on contents)\n    if (bufA.length !== bufB.length) return false;\n\n    return timingSafeEqual(bufA, bufB);\n  } else if (\n    (a instanceof Buffer || a instanceof Uint8Array) &&\n    (b instanceof Buffer || b instanceof Uint8Array)\n  ) {\n    // Compare lengths first\n    if (a.length !== b.length) return false;\n\n    return timingSafeEqual(\n      a instanceof Buffer ? a : Buffer.from(a),\n      b instanceof Buffer ? b : Buffer.from(b),\n    );\n  }\n\n  throw new Error(\n    \"Cannot compare: inputs must be strings, Buffers, or Uint8Arrays\",\n  );\n}\n\n/**\n * Interface for encryption options\n */\nexport interface EncryptionOptions {\n  /** Algorithm to use (default: aes-256-gcm) */\n  algorithm?: CipherGCMTypes;\n  /** Input encoding for plaintext if string (default: utf8) */\n  inputEncoding?: BufferEncoding;\n  /** Output encoding for ciphertext (default: hex) */\n  outputEncoding?: BinaryToTextEncoding;\n}\n\n/**\n * Interface for decryption options\n */\nexport interface DecryptionOptions {\n  /** Algorithm to use (default: aes-256-gcm) */\n  algorithm?: CipherGCMTypes;\n  /** Input encoding for ciphertext if string (default: hex) */\n  inputEncoding?: BinaryToTextEncoding;\n  /** Output encoding for plaintext (default: utf8) */\n  outputEncoding?: BufferEncoding;\n}\n\n/**\n * Result of encryption operation including all data needed for decryption\n */\nexport interface EncryptionResult {\n  /** Encrypted data (string or Buffer based on options) */\n  ciphertext: string | Buffer;\n  /** Initialization vector */\n  iv: Buffer;\n  /** Authentication tag (for GCM mode) */\n  authTag?: Buffer;\n  /** Algorithm used */\n  algorithm: string;\n}\n\n// Promisified version of scrypt for key derivation\nconst scryptAsync = promisify<string | Buffer, string | Buffer, number, Buffer>(\n  scrypt,\n);\n\n/**\n * Encrypts data using a symmetric key with secure defaults (AES-256-GCM).\n *\n * @param {string | Buffer} data - Data to encrypt\n * @param {string | Buffer} key - Encryption key or passphrase\n * @param {EncryptionOptions} [options] - Encryption options\n * @returns {Promise<EncryptionResult>} Encrypted data with metadata\n */\nexport async function encrypt(\n  data: string | Buffer,\n  key: string | Buffer,\n  options: EncryptionOptions = {},\n): Promise<EncryptionResult> {\n  const algorithm = options.algorithm || \"aes-256-gcm\";\n  const inputEncoding = options.inputEncoding || \"utf8\";\n  const outputEncoding = options.outputEncoding || \"hex\";\n\n  // Generate a random IV\n  const iv = randomBytes(16);\n\n  // Derive key using scrypt if key is a string (passphrase)\n  const derivedKey =\n    typeof key === \"string\" ? await scryptAsync(key, iv.slice(0, 8), 32) : key;\n\n  // Create cipher\n  const cipher = createCipheriv(algorithm, derivedKey, iv);\n\n  // Encrypt the data\n  let ciphertext: string | Buffer;\n\n  if (typeof data === \"string\") {\n    ciphertext = cipher.update(\n      data,\n      inputEncoding,\n      outputEncoding as BufferEncoding,\n    );\n    ciphertext += cipher.final(outputEncoding as BufferEncoding);\n  } else {\n    const encrypted = Buffer.concat([cipher.update(data), cipher.final()]);\n    ciphertext = outputEncoding\n      ? encrypted.toString(outputEncoding)\n      : encrypted;\n  }\n\n  // Get authentication tag if using GCM mode\n  const authTag = algorithm.includes(\"gcm\")\n    ? (cipher as any).getAuthTag()\n    : undefined;\n\n  return {\n    ciphertext,\n    iv,\n    authTag,\n    algorithm,\n  };\n}\n\n/**\n * Decrypts data that was encrypted with the encrypt function.\n *\n * @param {EncryptionResult} encryptedData - The encrypted data and metadata\n * @param {string | Buffer} key - Decryption key or passphrase\n * @param {DecryptionOptions} [options] - Decryption options\n * @returns {Promise<string | Buffer>} Decrypted data\n */\nexport async function decrypt(\n  encryptedData: EncryptionResult,\n  key: string | Buffer,\n  options: DecryptionOptions = {},\n): Promise<string | Buffer> {\n  const algorithm =\n    options.algorithm || encryptedData.algorithm || \"aes-256-gcm\";\n  const inputEncoding = options.inputEncoding || \"hex\";\n  const outputEncoding = options.outputEncoding || \"utf8\";\n\n  // Derive key using scrypt if key is a string (passphrase)\n  const derivedKey =\n    typeof key === \"string\"\n      ? await scryptAsync(key, encryptedData.iv.slice(0, 8), 32)\n      : key;\n\n  // Create decipher\n  const decipher = createDecipheriv(algorithm, derivedKey, encryptedData.iv);\n\n  // Set auth tag if using GCM mode\n  if (encryptedData.authTag && algorithm.includes(\"gcm\")) {\n    (decipher as any).setAuthTag(encryptedData.authTag);\n  }\n\n  // Decrypt the data\n  let decrypted: string | Buffer;\n\n  if (typeof encryptedData.ciphertext === \"string\") {\n    decrypted = decipher.update(\n      encryptedData.ciphertext,\n      inputEncoding as BufferEncoding,\n      outputEncoding,\n    );\n    decrypted += decipher.final(outputEncoding);\n  } else {\n    const result = Buffer.concat([\n      decipher.update(encryptedData.ciphertext),\n      decipher.final(),\n    ]);\n    decrypted = outputEncoding ? result.toString(outputEncoding) : result;\n  }\n\n  return decrypted;\n}\n\n/**\n * Creates a signed token with an expiration time and payload.\n *\n * @param {object} payload - Data to include in the token\n * @param {string} secret - Secret key for signing\n * @param {number} [expiresInSeconds=3600] - Token expiration in seconds\n * @returns {string} Signed token string\n */\nexport function createSignedToken(\n  payload: Record<string, any>,\n  secret: string,\n  expiresInSeconds: number = 3600,\n): string {\n  // Create payload with expiration\n  const tokenPayload = {\n    ...payload,\n    exp: Math.floor(Date.now() / 1000) + expiresInSeconds,\n  };\n\n  // Convert to string\n  const payloadStr = JSON.stringify(tokenPayload);\n\n  // Base64 encode the payload\n  const base64Payload = Buffer.from(payloadStr).toString(\"base64url\");\n\n  // Create signature\n  const signature = hmac(\"sha256\", base64Payload, secret, \"base64url\");\n\n  // Combine payload and signature\n  return `${base64Payload}.${signature}`;\n}\n\n/**\n * Verifies and decodes a signed token.\n *\n * @param {string} token - The token to verify\n * @param {string} secret - Secret key for verification\n * @returns {object | null} Decoded payload if valid, null if invalid\n */\nexport function verifySignedToken(\n  token: string,\n  secret: string,\n): Record<string, any> | null {\n  try {\n    // Split token into parts\n    const [payloadB64, signature] = token.split(\".\");\n\n    if (!payloadB64 || !signature) return null;\n\n    // Verify signature\n    const expectedSignature = hmac(\"sha256\", payloadB64, secret, \"base64url\");\n    if (!safeCompare(signature, expectedSignature)) return null;\n\n    // Decode payload\n    const payloadStr = Buffer.from(payloadB64, \"base64url\").toString(\"utf8\");\n    const payload = JSON.parse(payloadStr);\n\n    // Check expiration\n    if (payload.exp && payload.exp < Math.floor(Date.now() / 1000)) {\n      return null;\n    }\n\n    return payload;\n  } catch {\n    return null;\n  }\n}\n"]}
+{"version":3,"file":"crypto.utils.js","sourceRoot":"","sources":["../../../src/utils/crypto.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  createHmac,\n  createHash,\n  BinaryToTextEncoding,\n  randomUUID,\n  randomBytes,\n  createCipheriv,\n  createDecipheriv,\n  scrypt,\n  timingSafeEqual,\n  CipherGCMTypes\n} from 'crypto';\nimport { promisify } from 'util';\n\nexport type BufferEncoding =\n  | 'ascii'\n  | 'utf8'\n  | 'utf-8'\n  | 'utf16le'\n  | 'utf-16le'\n  | 'ucs2'\n  | 'ucs-2'\n  | 'base64'\n  | 'base64url'\n  | 'latin1'\n  | 'binary'\n  | 'hex';\n\n/**\n * Generates an HMAC digest using the specified algorithm and secret key.\n *\n * @param {string} algorithm - The hashing algorithm (e.g., 'sha256', 'sha1').\n * @param {string} input - The string to hash.\n * @param {string} secret - The secret key for HMAC.\n * @param {BinaryToTextEncoding} [encoding='hex'] - Output encoding ('hex', 'base64', etc).\n * @returns {string} HMAC digest as a string.\n */\nexport function hmac(algorithm: string, input: string, secret: string, encoding: BinaryToTextEncoding = 'hex'): string {\n  return createHmac(algorithm, secret).update(input).digest(encoding);\n}\n\n/**\n * Generates a hash digest using the specified algorithm.\n *\n * @param {string} algorithm - The hashing algorithm (e.g., 'sha256', 'md5').\n * @param {string} input - The string to hash.\n * @param {BinaryToTextEncoding} [encoding='hex'] - Output encoding ('hex', 'base64', etc).\n * @returns {string} Hash digest as a string.\n */\nexport function hash(algorithm: string, input: string, encoding: BinaryToTextEncoding = 'hex'): string {\n  return createHash(algorithm).update(input).digest(encoding);\n}\n\n/**\n * Generates an HMAC-SHA256 digest.\n *\n * @param {string} input - The string to hash.\n * @param {string} secret - The secret key.\n * @returns {string} SHA-256 HMAC digest as a string.\n */\nexport function sha256Hmac(input: string, secret: string): string {\n  return hmac('sha256', input, secret);\n}\n\n/**\n * Generates a SHA1 hash digest.\n *\n * @param {string} input - The string to hash.\n * @param {BinaryToTextEncoding} [encoding='hex'] - Output encoding.\n * @returns {string} SHA-1 hash as a string.\n */\nexport function sha1(input: string, encoding: BinaryToTextEncoding = 'hex'): string {\n  return hash('sha1', input, encoding);\n}\n\n/**\n * Generates a SHA256 hash digest.\n *\n * @param {string} input - The string to hash.\n * @param {BinaryToTextEncoding} [encoding='hex'] - Output encoding.\n * @returns {string} SHA-256 hash as a string.\n */\nexport function sha256(input: string, encoding: BinaryToTextEncoding = 'hex'): string {\n  return hash('sha256', input, encoding);\n}\n\n/**\n * Generates an MD5 hash digest.\n *\n * @param {string} input - The string to hash.\n * @returns {string} MD5 hash as a string.\n */\nexport function md5(input: string): string {\n  return hash('md5', input);\n}\n\n/**\n * Generates a cryptographically strong random string by hashing a random UUID with SHA-256.\n *\n * @returns {string} Random string hashed with SHA-256 (hex encoding).\n */\nexport function randomString(): string {\n  return sha256(randomUUID());\n}\n\n/**\n * Generates a secure random buffer of specified byte length.\n *\n * @param {number} [byteLength=32] - Number of random bytes to generate.\n * @returns {Buffer} Buffer containing random bytes.\n */\nexport function generateRandomBytes(byteLength: number = 32): Buffer {\n  return randomBytes(byteLength);\n}\n\n/**\n * Generates a secure random string of specified byte length with specified encoding.\n *\n * @param {number} [byteLength=32] - Number of random bytes to generate.\n * @param {BinaryToTextEncoding} [encoding='hex'] - Output encoding.\n * @returns {string} Random string in specified encoding.\n */\nexport function generateRandomBytesAsString(byteLength: number = 32, encoding: BinaryToTextEncoding = 'hex'): string {\n  return randomBytes(byteLength).toString(encoding);\n}\n\n/**\n * Generates a secure API key with a specified format.\n *\n * @param {string} [prefix=''] - Optional prefix for the key.\n * @param {number} [byteLength=24] - Number of random bytes to generate.\n * @returns {string} Formatted API key.\n */\nexport function generateApiKey(prefix: string = '', byteLength: number = 24): string {\n  const randomString = generateRandomBytesAsString(byteLength, 'base64');\n  const key = randomString\n    .replace(/[+/=]/g, '') // Remove non-URL-safe characters\n    .substring(0, 32); // Limit length\n\n  return prefix ? `${prefix}_${key}` : key;\n}\n\n/**\n * Compares two strings, arrays, or buffers in constant time to prevent timing attacks.\n *\n * @param {string | Buffer | Uint8Array} a - First value to compare\n * @param {string | Buffer | Uint8Array} b - Second value to compare\n * @returns {boolean} True if values are equal\n */\nexport function safeCompare(a: string | Buffer | Uint8Array, b: string | Buffer | Uint8Array): boolean {\n  if (typeof a === 'string' && typeof b === 'string') {\n    // Convert strings to buffers\n    const bufA = Buffer.from(a);\n    const bufB = Buffer.from(b);\n\n    // Compare lengths first (not constant time, but prevents timing attack on contents)\n    if (bufA.length !== bufB.length) return false;\n\n    return timingSafeEqual(bufA, bufB);\n  } else if ((a instanceof Buffer || a instanceof Uint8Array) && (b instanceof Buffer || b instanceof Uint8Array)) {\n    // Compare lengths first\n    if (a.length !== b.length) return false;\n\n    return timingSafeEqual(a instanceof Buffer ? a : Buffer.from(a), b instanceof Buffer ? b : Buffer.from(b));\n  }\n\n  throw new Error('Cannot compare: inputs must be strings, Buffers, or Uint8Arrays');\n}\n\n/**\n * Interface for encryption options\n */\nexport interface EncryptionOptions {\n  /** Algorithm to use (default: aes-256-gcm) */\n  algorithm?: CipherGCMTypes;\n  /** Input encoding for plaintext if string (default: utf8) */\n  inputEncoding?: BufferEncoding;\n  /** Output encoding for ciphertext (default: hex) */\n  outputEncoding?: BinaryToTextEncoding;\n}\n\n/**\n * Interface for decryption options\n */\nexport interface DecryptionOptions {\n  /** Algorithm to use (default: aes-256-gcm) */\n  algorithm?: CipherGCMTypes;\n  /** Input encoding for ciphertext if string (default: hex) */\n  inputEncoding?: BinaryToTextEncoding;\n  /** Output encoding for plaintext (default: utf8) */\n  outputEncoding?: BufferEncoding;\n}\n\n/**\n * Result of encryption operation including all data needed for decryption\n */\nexport interface EncryptionResult {\n  /** Encrypted data (string or Buffer based on options) */\n  ciphertext: string | Buffer;\n  /** Initialization vector */\n  iv: Buffer;\n  /** Authentication tag (for GCM mode) */\n  authTag?: Buffer;\n  /** Algorithm used */\n  algorithm: string;\n}\n\n// Promisified version of scrypt for key derivation\nconst scryptAsync = promisify<string | Buffer, string | Buffer, number, Buffer>(scrypt);\n\n/**\n * Encrypts data using a symmetric key with secure defaults (AES-256-GCM).\n *\n * @param {string | Buffer} data - Data to encrypt\n * @param {string | Buffer} key - Encryption key or passphrase\n * @param {EncryptionOptions} [options] - Encryption options\n * @returns {Promise<EncryptionResult>} Encrypted data with metadata\n */\nexport async function encrypt(\n  data: string | Buffer,\n  key: string | Buffer,\n  options: EncryptionOptions = {}\n): Promise<EncryptionResult> {\n  const algorithm = options.algorithm || 'aes-256-gcm';\n  const inputEncoding = options.inputEncoding || 'utf8';\n  const outputEncoding = options.outputEncoding || 'hex';\n\n  // Generate a random IV\n  const iv = randomBytes(16);\n\n  // Derive key using scrypt if key is a string (passphrase)\n  const derivedKey = typeof key === 'string' ? await scryptAsync(key, iv.slice(0, 8), 32) : key;\n\n  // Create cipher\n  const cipher = createCipheriv(algorithm, derivedKey, iv);\n\n  // Encrypt the data\n  let ciphertext: string | Buffer;\n\n  if (typeof data === 'string') {\n    ciphertext = cipher.update(data, inputEncoding, outputEncoding as BufferEncoding);\n    ciphertext += cipher.final(outputEncoding as BufferEncoding);\n  } else {\n    const encrypted = Buffer.concat([cipher.update(data), cipher.final()]);\n    ciphertext = outputEncoding ? encrypted.toString(outputEncoding) : encrypted;\n  }\n\n  // Get authentication tag if using GCM mode\n  const authTag = algorithm.includes('gcm') ? (cipher as any).getAuthTag() : undefined;\n\n  return {\n    ciphertext,\n    iv,\n    authTag,\n    algorithm\n  };\n}\n\n/**\n * Decrypts data that was encrypted with the encrypt function.\n *\n * @param {EncryptionResult} encryptedData - The encrypted data and metadata\n * @param {string | Buffer} key - Decryption key or passphrase\n * @param {DecryptionOptions} [options] - Decryption options\n * @returns {Promise<string | Buffer>} Decrypted data\n */\nexport async function decrypt(\n  encryptedData: EncryptionResult,\n  key: string | Buffer,\n  options: DecryptionOptions = {}\n): Promise<string | Buffer> {\n  const algorithm = options.algorithm || encryptedData.algorithm || 'aes-256-gcm';\n  const inputEncoding = options.inputEncoding || 'hex';\n  const outputEncoding = options.outputEncoding || 'utf8';\n\n  // Derive key using scrypt if key is a string (passphrase)\n  const derivedKey = typeof key === 'string' ? await scryptAsync(key, encryptedData.iv.slice(0, 8), 32) : key;\n\n  // Create decipher\n  const decipher = createDecipheriv(algorithm, derivedKey, encryptedData.iv);\n\n  // Set auth tag if using GCM mode\n  if (encryptedData.authTag && algorithm.includes('gcm')) {\n    (decipher as any).setAuthTag(encryptedData.authTag);\n  }\n\n  // Decrypt the data\n  let decrypted: string | Buffer;\n\n  if (typeof encryptedData.ciphertext === 'string') {\n    decrypted = decipher.update(encryptedData.ciphertext, inputEncoding as BufferEncoding, outputEncoding);\n    decrypted += decipher.final(outputEncoding);\n  } else {\n    const result = Buffer.concat([decipher.update(encryptedData.ciphertext), decipher.final()]);\n    decrypted = outputEncoding ? result.toString(outputEncoding) : result;\n  }\n\n  return decrypted;\n}\n\n/**\n * Creates a signed token with an expiration time and payload.\n *\n * @param {object} payload - Data to include in the token\n * @param {string} secret - Secret key for signing\n * @param {number} [expiresInSeconds=3600] - Token expiration in seconds\n * @returns {string} Signed token string\n */\nexport function createSignedToken(\n  payload: Record<string, any>,\n  secret: string,\n  expiresInSeconds: number = 3600\n): string {\n  // Create payload with expiration\n  const tokenPayload = {\n    ...payload,\n    exp: Math.floor(Date.now() / 1000) + expiresInSeconds\n  };\n\n  // Convert to string\n  const payloadStr = JSON.stringify(tokenPayload);\n\n  // Base64 encode the payload\n  const base64Payload = Buffer.from(payloadStr).toString('base64url');\n\n  // Create signature\n  const signature = hmac('sha256', base64Payload, secret, 'base64url');\n\n  // Combine payload and signature\n  return `${base64Payload}.${signature}`;\n}\n\n/**\n * Verifies and decodes a signed token.\n *\n * @param {string} token - The token to verify\n * @param {string} secret - Secret key for verification\n * @returns {object | null} Decoded payload if valid, null if invalid\n */\nexport function verifySignedToken(token: string, secret: string): Record<string, any> | null {\n  try {\n    // Split token into parts\n    const [payloadB64, signature] = token.split('.');\n\n    if (!payloadB64 || !signature) return null;\n\n    // Verify signature\n    const expectedSignature = hmac('sha256', payloadB64, secret, 'base64url');\n    if (!safeCompare(signature, expectedSignature)) return null;\n\n    // Decode payload\n    const payloadStr = Buffer.from(payloadB64, 'base64url').toString('utf8');\n    const payload = JSON.parse(payloadStr);\n\n    // Check expiration\n    if (payload.exp && payload.exp < Math.floor(Date.now() / 1000)) {\n      return null;\n    }\n\n    return payload;\n  } catch {\n    return null;\n  }\n}\n"]}

package/build/esm/utils/decorators.utils.d.ts

@@ -1,21 +1,5 @@
-import "reflect-metadata";
-export interface Request {
-    query: any;
-    params: any;
-    body?: any;
-    [key: string]: any;
-}
-export interface Response {
-    json: (body: any) => void;
-    headersSent: boolean;
-    [key: string]: any;
-}
-export type NextFunction = (err?: any) => void;
-export type RequestHandler = (req: Request, res: Response, next: NextFunction) => any;
-export interface Router {
-    [method: string]: (path: string, ...handlers: RequestHandler[]) => void;
-}
-export type HttpMethod = "get" | "post" | "put" | "patch" | "delete" | "options" | "head" | "trace" | "connect";
+import type { RequestHandler, Router } from 'express';
+import 'reflect-metadata';
 export declare const Get: (path: string) => MethodDecorator;
 export declare const Post: (path: string) => MethodDecorator;
 export declare const Put: (path: string) => MethodDecorator;

package/build/esm/utils/decorators.utils.js

@@ -71,11 +71,11 @@ var __values = (this && this.__values) || function(o) {
     };
     throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
 };
-import "reflect-metadata";
+import 'reflect-metadata';
 // --- End sample Express interfaces ---
-var ROUTES_KEY = Symbol("routes");
-var MIDDLEWARE_KEY = Symbol("middlewares");
-var PARAMS_KEY = Symbol("params");
+var ROUTES_KEY = Symbol('routes');
+var MIDDLEWARE_KEY = Symbol('middlewares');
+var PARAMS_KEY = Symbol('params');
 // ---- Route Decorators ----
 function createRouteDecorator(method) {
     return function (path) {
@@ -84,25 +84,25 @@ function createRouteDecorator(method) {
             routes.push({
                 path: path,
                 method: method,
-                handlerName: propertyKey,
+                handlerName: propertyKey
             });
             Reflect.defineMetadata(ROUTES_KEY, routes, target.constructor);
         };
     };
 }
-export var Get = createRouteDecorator("get");
-export var Post = createRouteDecorator("post");
-export var Put = createRouteDecorator("put");
-export var Patch = createRouteDecorator("patch");
-export var Delete = createRouteDecorator("delete");
-export var Options = createRouteDecorator("options");
-export var Head = createRouteDecorator("head");
-export var Trace = createRouteDecorator("trace");
-export var Connect = createRouteDecorator("connect");
+export var Get = createRouteDecorator('get');
+export var Post = createRouteDecorator('post');
+export var Put = createRouteDecorator('put');
+export var Patch = createRouteDecorator('patch');
+export var Delete = createRouteDecorator('delete');
+export var Options = createRouteDecorator('options');
+export var Head = createRouteDecorator('head');
+export var Trace = createRouteDecorator('trace');
+export var Connect = createRouteDecorator('connect');
 // ---- Controller Decorator ----
 export function Controller(basePath) {
     return function (target) {
-        Reflect.defineMetadata("basePath", basePath, target);
+        Reflect.defineMetadata('basePath', basePath, target);
     };
 }
 // ---- Middleware Decorator ----
@@ -128,20 +128,20 @@ function createParamDecorator(type, key) {
         };
     };
 }
-export var Query = createParamDecorator("query");
-export var Param = createParamDecorator("param");
-export var Body = createParamDecorator("body");
-export var Req = createParamDecorator("req");
-export var Res = createParamDecorator("res");
+export var Query = createParamDecorator('query');
+export var Param = createParamDecorator('param');
+export var Body = createParamDecorator('body');
+export var Req = createParamDecorator('req');
+export var Res = createParamDecorator('res');
 // Custom HTTP status code decorator
-var HTTP_CODE_KEY = Symbol("httpCode");
+var HTTP_CODE_KEY = Symbol('httpCode');
 export function HttpCode(status) {
     return function (target, propertyKey, descriptor) {
         Reflect.defineMetadata(HTTP_CODE_KEY, status, target, propertyKey);
     };
 }
 // Custom header decorator
-var HEADER_KEY = Symbol("headers");
+var HEADER_KEY = Symbol('headers');
 export function Header(name, value) {
     return function (target, propertyKey, descriptor) {
         var headers = Reflect.getMetadata(HEADER_KEY, target, propertyKey) || {};
@@ -150,8 +150,8 @@ export function Header(name, value) {
     };
 }
 // Before/After hooks (not Express middleware, but can be used for logging, etc.)
-var BEFORE_KEY = Symbol("before");
-var AFTER_KEY = Symbol("after");
+var BEFORE_KEY = Symbol('before');
+var AFTER_KEY = Symbol('after');
 export function Before(fn) {
     return function (target, propertyKey, descriptor) {
         var hooks = Reflect.getMetadata(BEFORE_KEY, target, propertyKey) || [];
@@ -171,7 +171,7 @@ export function registerControllers(router, controllers) {
     var _this = this;
     controllers.forEach(function (ControllerClass) {
         var instance = new ControllerClass();
-        var basePath = Reflect.getMetadata("basePath", ControllerClass) || "";
+        var basePath = Reflect.getMetadata('basePath', ControllerClass) || '';
         var routes = Reflect.getMetadata(ROUTES_KEY, ControllerClass) || [];
         routes.forEach(function (_a) {
             var _b;
@@ -223,19 +223,19 @@ export function registerControllers(router, controllers) {
                                     var _b;
                                     var index = _a.index, type = _a.type, key = _a.key;
                                     switch (type) {
-                                        case "query":
+                                        case 'query':
                                             args_1[index] = key ? req.query[key] : req.query;
                                             break;
-                                        case "param":
+                                        case 'param':
                                             args_1[index] = key ? req.params[key] : req.params;
                                             break;
-                                        case "body":
+                                        case 'body':
                                             args_1[index] = key ? (_b = req.body) === null || _b === void 0 ? void 0 : _b[key] : req.body;
                                             break;
-                                        case "req":
+                                        case 'req':
                                             args_1[index] = req;
                                             break;
-                                        case "res":
+                                        case 'res':
                                             args_1[index] = res;
                                             break;
                                     }
@@ -252,7 +252,7 @@ export function registerControllers(router, controllers) {
                             _l.label = 11;
                         case 11:
                             awaited = _a;
-                            if (!res.headersSent && typeof awaited !== "undefined") {
+                            if (!res.headersSent && typeof awaited !== 'undefined') {
                                 if (httpCode)
                                     (_j = res.status) === null || _j === void 0 ? void 0 : _j.call(res, httpCode);
                                 try {

package/build/esm/utils/decorators.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.utils.js","sourceRoot":"","sources":["../../../src/utils/decorators.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable @typescript-eslint/no-unused-vars */\n\nimport \"reflect-metadata\";\n\n// --- Sample Express interfaces for type safety ---\nexport interface Request {\n  query: any;\n  params: any;\n  body?: any;\n  [key: string]: any;\n}\nexport interface Response {\n  json: (body: any) => void;\n  headersSent: boolean;\n  [key: string]: any;\n}\nexport type NextFunction = (err?: any) => void;\nexport type RequestHandler = (\n  req: Request,\n  res: Response,\n  next: NextFunction,\n) => any;\nexport interface Router {\n  [method: string]: (path: string, ...handlers: RequestHandler[]) => void;\n}\n// --- End sample Express interfaces ---\n\nconst ROUTES_KEY = Symbol(\"routes\");\nconst MIDDLEWARE_KEY = Symbol(\"middlewares\");\nconst PARAMS_KEY = Symbol(\"params\");\n\nexport type HttpMethod =\n  | \"get\"\n  | \"post\"\n  | \"put\"\n  | \"patch\"\n  | \"delete\"\n  | \"options\"\n  | \"head\"\n  | \"trace\"\n  | \"connect\";\n\ninterface RouteDefinition {\n  path: string;\n  method: HttpMethod;\n  handlerName: string;\n}\n\ninterface ParamDefinition {\n  index: number;\n  type: \"query\" | \"param\" | \"body\" | \"req\" | \"res\";\n  key?: string;\n}\n\n// ---- Route Decorators ----\nfunction createRouteDecorator(method: HttpMethod) {\n  return (path: string): MethodDecorator => {\n    return (target, propertyKey, descriptor) => {\n      const routes: RouteDefinition[] =\n        Reflect.getMetadata(ROUTES_KEY, target.constructor) || [];\n      routes.push({\n        path,\n        method,\n        handlerName: propertyKey as string,\n      });\n      Reflect.defineMetadata(ROUTES_KEY, routes, target.constructor);\n    };\n  };\n}\n\nexport const Get = createRouteDecorator(\"get\");\nexport const Post = createRouteDecorator(\"post\");\nexport const Put = createRouteDecorator(\"put\");\nexport const Patch = createRouteDecorator(\"patch\");\nexport const Delete = createRouteDecorator(\"delete\");\nexport const Options = createRouteDecorator(\"options\");\nexport const Head = createRouteDecorator(\"head\");\nexport const Trace = createRouteDecorator(\"trace\");\nexport const Connect = createRouteDecorator(\"connect\");\n\n// ---- Controller Decorator ----\nexport function Controller(basePath: string): ClassDecorator {\n  return (target) => {\n    Reflect.defineMetadata(\"basePath\", basePath, target);\n  };\n}\n\n// ---- Middleware Decorator ----\nexport function Use(...middlewares: RequestHandler[]): MethodDecorator {\n  return (target, propertyKey, descriptor) => {\n    const existing: RequestHandler[] =\n      Reflect.getMetadata(MIDDLEWARE_KEY, target, propertyKey as string) || [];\n    Reflect.defineMetadata(\n      MIDDLEWARE_KEY,\n      [...existing, ...middlewares],\n      target,\n      propertyKey as string,\n    );\n  };\n}\n\n// ---- Parameter Decorators ----\nfunction createParamDecorator(type: ParamDefinition[\"type\"], key?: string) {\n  return (paramKey?: string): ParameterDecorator => {\n    return (target, propertyKey, parameterIndex) => {\n      const params: ParamDefinition[] =\n        Reflect.getMetadata(PARAMS_KEY, target, propertyKey as string) || [];\n      // Ensure parameters are ordered by index\n      params.push({ index: parameterIndex, type, key: paramKey || key });\n      params.sort((a, b) => a.index - b.index);\n      Reflect.defineMetadata(PARAMS_KEY, params, target, propertyKey as string);\n    };\n  };\n}\n\nexport const Query = createParamDecorator(\"query\");\nexport const Param = createParamDecorator(\"param\");\nexport const Body = createParamDecorator(\"body\");\nexport const Req = createParamDecorator(\"req\");\nexport const Res = createParamDecorator(\"res\");\n\n// Custom HTTP status code decorator\nconst HTTP_CODE_KEY = Symbol(\"httpCode\");\nexport function HttpCode(status: number): MethodDecorator {\n  return (target, propertyKey, descriptor) => {\n    Reflect.defineMetadata(\n      HTTP_CODE_KEY,\n      status,\n      target,\n      propertyKey as string,\n    );\n  };\n}\n\n// Custom header decorator\nconst HEADER_KEY = Symbol(\"headers\");\nexport function Header(name: string, value: string): MethodDecorator {\n  return (target, propertyKey, descriptor) => {\n    const headers: Record<string, string> =\n      Reflect.getMetadata(HEADER_KEY, target, propertyKey as string) || {};\n    headers[name] = value;\n    Reflect.defineMetadata(HEADER_KEY, headers, target, propertyKey as string);\n  };\n}\n\n// Before/After hooks (not Express middleware, but can be used for logging, etc.)\nconst BEFORE_KEY = Symbol(\"before\");\nconst AFTER_KEY = Symbol(\"after\");\nexport function Before(fn: Function): MethodDecorator {\n  return (target, propertyKey, descriptor) => {\n    const hooks: Function[] =\n      Reflect.getMetadata(BEFORE_KEY, target, propertyKey as string) || [];\n    hooks.push(fn);\n    Reflect.defineMetadata(BEFORE_KEY, hooks, target, propertyKey as string);\n  };\n}\nexport function After(fn: Function): MethodDecorator {\n  return (target, propertyKey, descriptor) => {\n    const hooks: Function[] =\n      Reflect.getMetadata(AFTER_KEY, target, propertyKey as string) || [];\n    hooks.push(fn);\n    Reflect.defineMetadata(AFTER_KEY, hooks, target, propertyKey as string);\n  };\n}\n\n// ---- Register Controllers ----\nexport function registerControllers(router: Router, controllers: any[]) {\n  controllers.forEach((ControllerClass) => {\n    const instance = new ControllerClass();\n    const basePath: string =\n      Reflect.getMetadata(\"basePath\", ControllerClass) || \"\";\n    const routes: RouteDefinition[] =\n      Reflect.getMetadata(ROUTES_KEY, ControllerClass) || [];\n\n    routes.forEach(({ path, method, handlerName }) => {\n      const middlewares: RequestHandler[] =\n        Reflect.getMetadata(MIDDLEWARE_KEY, instance, handlerName) || [];\n      const params: ParamDefinition[] =\n        Reflect.getMetadata(PARAMS_KEY, instance, handlerName) || [];\n\n      const httpCode: number | undefined = Reflect.getMetadata(\n        HTTP_CODE_KEY,\n        instance,\n        handlerName,\n      );\n      const headers: Record<string, string> =\n        Reflect.getMetadata(HEADER_KEY, instance, handlerName) || {};\n      const beforeHooks: Function[] =\n        Reflect.getMetadata(BEFORE_KEY, instance, handlerName) || [];\n      const afterHooks: Function[] =\n        Reflect.getMetadata(AFTER_KEY, instance, handlerName) || [];\n\n      const handler: RequestHandler = async (req, res, next) => {\n        try {\n          for (const fn of beforeHooks) await fn(req, res);\n          const args: any[] = [];\n          if (params.length) {\n            params.forEach(({ index, type, key }) => {\n              switch (type) {\n                case \"query\":\n                  args[index] = key ? req.query[key] : req.query;\n                  break;\n                case \"param\":\n                  args[index] = key ? req.params[key] : req.params;\n                  break;\n                case \"body\":\n                  args[index] = key ? req.body?.[key] : req.body;\n                  break;\n                case \"req\":\n                  args[index] = req;\n                  break;\n                case \"res\":\n                  args[index] = res;\n                  break;\n              }\n            });\n          }\n          const result = (instance as any)[handlerName](...args);\n          // Support both sync and async handlers\n          const awaited = result instanceof Promise ? await result : result;\n          if (!res.headersSent && typeof awaited !== \"undefined\") {\n            if (httpCode) res.status?.(httpCode);\n            for (const [k, v] of Object.entries(headers)) res.set?.(k, v);\n            res.json(awaited);\n          }\n          for (const fn of afterHooks) await fn(req, res, awaited);\n        } catch (err) {\n          next(err);\n        }\n      };\n\n      (router as any)[method](basePath + path, ...middlewares, handler);\n    });\n  });\n}\n"]}
+{"version":3,"file":"decorators.utils.js","sourceRoot":"","sources":["../../../src/utils/decorators.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable @typescript-eslint/no-unused-vars */\n\nimport type { RequestHandler, Router } from 'express';\nimport 'reflect-metadata';\n\n// --- End sample Express interfaces ---\n\nconst ROUTES_KEY = Symbol('routes');\nconst MIDDLEWARE_KEY = Symbol('middlewares');\nconst PARAMS_KEY = Symbol('params');\n\ntype HttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete' | 'options' | 'head' | 'trace' | 'connect';\n\ninterface RouteDefinition {\n  path: string;\n  method: HttpMethod;\n  handlerName: string;\n}\n\ninterface ParamDefinition {\n  index: number;\n  type: 'query' | 'param' | 'body' | 'req' | 'res';\n  key?: string;\n}\n\n// ---- Route Decorators ----\nfunction createRouteDecorator(method: HttpMethod) {\n  return (path: string): MethodDecorator => {\n    return (target, propertyKey, descriptor) => {\n      const routes: RouteDefinition[] = Reflect.getMetadata(ROUTES_KEY, target.constructor) || [];\n      routes.push({\n        path,\n        method,\n        handlerName: propertyKey as string\n      });\n      Reflect.defineMetadata(ROUTES_KEY, routes, target.constructor);\n    };\n  };\n}\n\nexport const Get = createRouteDecorator('get');\nexport const Post = createRouteDecorator('post');\nexport const Put = createRouteDecorator('put');\nexport const Patch = createRouteDecorator('patch');\nexport const Delete = createRouteDecorator('delete');\nexport const Options = createRouteDecorator('options');\nexport const Head = createRouteDecorator('head');\nexport const Trace = createRouteDecorator('trace');\nexport const Connect = createRouteDecorator('connect');\n\n// ---- Controller Decorator ----\nexport function Controller(basePath: string): ClassDecorator {\n  return target => {\n    Reflect.defineMetadata('basePath', basePath, target);\n  };\n}\n\n// ---- Middleware Decorator ----\nexport function Use(...middlewares: RequestHandler[]): MethodDecorator {\n  return (target, propertyKey, descriptor) => {\n    const existing: RequestHandler[] = Reflect.getMetadata(MIDDLEWARE_KEY, target, propertyKey as string) || [];\n    Reflect.defineMetadata(MIDDLEWARE_KEY, [...existing, ...middlewares], target, propertyKey as string);\n  };\n}\n\n// ---- Parameter Decorators ----\nfunction createParamDecorator(type: ParamDefinition['type'], key?: string) {\n  return (paramKey?: string): ParameterDecorator => {\n    return (target, propertyKey, parameterIndex) => {\n      const params: ParamDefinition[] = Reflect.getMetadata(PARAMS_KEY, target, propertyKey as string) || [];\n      // Ensure parameters are ordered by index\n      params.push({ index: parameterIndex, type, key: paramKey || key });\n      params.sort((a, b) => a.index - b.index);\n      Reflect.defineMetadata(PARAMS_KEY, params, target, propertyKey as string);\n    };\n  };\n}\n\nexport const Query = createParamDecorator('query');\nexport const Param = createParamDecorator('param');\nexport const Body = createParamDecorator('body');\nexport const Req = createParamDecorator('req');\nexport const Res = createParamDecorator('res');\n\n// Custom HTTP status code decorator\nconst HTTP_CODE_KEY = Symbol('httpCode');\nexport function HttpCode(status: number): MethodDecorator {\n  return (target, propertyKey, descriptor) => {\n    Reflect.defineMetadata(HTTP_CODE_KEY, status, target, propertyKey as string);\n  };\n}\n\n// Custom header decorator\nconst HEADER_KEY = Symbol('headers');\nexport function Header(name: string, value: string): MethodDecorator {\n  return (target, propertyKey, descriptor) => {\n    const headers: Record<string, string> = Reflect.getMetadata(HEADER_KEY, target, propertyKey as string) || {};\n    headers[name] = value;\n    Reflect.defineMetadata(HEADER_KEY, headers, target, propertyKey as string);\n  };\n}\n\n// Before/After hooks (not Express middleware, but can be used for logging, etc.)\nconst BEFORE_KEY = Symbol('before');\nconst AFTER_KEY = Symbol('after');\nexport function Before(fn: Function): MethodDecorator {\n  return (target, propertyKey, descriptor) => {\n    const hooks: Function[] = Reflect.getMetadata(BEFORE_KEY, target, propertyKey as string) || [];\n    hooks.push(fn);\n    Reflect.defineMetadata(BEFORE_KEY, hooks, target, propertyKey as string);\n  };\n}\nexport function After(fn: Function): MethodDecorator {\n  return (target, propertyKey, descriptor) => {\n    const hooks: Function[] = Reflect.getMetadata(AFTER_KEY, target, propertyKey as string) || [];\n    hooks.push(fn);\n    Reflect.defineMetadata(AFTER_KEY, hooks, target, propertyKey as string);\n  };\n}\n\n// ---- Register Controllers ----\nexport function registerControllers(router: Router, controllers: any[]) {\n  controllers.forEach(ControllerClass => {\n    const instance = new ControllerClass();\n    const basePath: string = Reflect.getMetadata('basePath', ControllerClass) || '';\n    const routes: RouteDefinition[] = Reflect.getMetadata(ROUTES_KEY, ControllerClass) || [];\n\n    routes.forEach(({ path, method, handlerName }) => {\n      const middlewares: RequestHandler[] = Reflect.getMetadata(MIDDLEWARE_KEY, instance, handlerName) || [];\n      const params: ParamDefinition[] = Reflect.getMetadata(PARAMS_KEY, instance, handlerName) || [];\n\n      const httpCode: number | undefined = Reflect.getMetadata(HTTP_CODE_KEY, instance, handlerName);\n      const headers: Record<string, string> = Reflect.getMetadata(HEADER_KEY, instance, handlerName) || {};\n      const beforeHooks: Function[] = Reflect.getMetadata(BEFORE_KEY, instance, handlerName) || [];\n      const afterHooks: Function[] = Reflect.getMetadata(AFTER_KEY, instance, handlerName) || [];\n\n      const handler: RequestHandler = async (req, res, next) => {\n        try {\n          for (const fn of beforeHooks) await fn(req, res);\n          const args: any[] = [];\n          if (params.length) {\n            params.forEach(({ index, type, key }) => {\n              switch (type) {\n                case 'query':\n                  args[index] = key ? req.query[key] : req.query;\n                  break;\n                case 'param':\n                  args[index] = key ? req.params[key] : req.params;\n                  break;\n                case 'body':\n                  args[index] = key ? req.body?.[key] : req.body;\n                  break;\n                case 'req':\n                  args[index] = req;\n                  break;\n                case 'res':\n                  args[index] = res;\n                  break;\n              }\n            });\n          }\n          const result = (instance as any)[handlerName](...args);\n          // Support both sync and async handlers\n          const awaited = result instanceof Promise ? await result : result;\n          if (!res.headersSent && typeof awaited !== 'undefined') {\n            if (httpCode) res.status?.(httpCode);\n            for (const [k, v] of Object.entries(headers)) res.set?.(k, v);\n            res.json(awaited);\n          }\n          for (const fn of afterHooks) await fn(req, res, awaited);\n        } catch (err) {\n          next(err);\n        }\n      };\n\n      (router as any)[method](basePath + path, ...middlewares, handler);\n    });\n  });\n}\n"]}

package/build/esm/utils/dir.utils.d.ts

@@ -1,4 +1,4 @@
-import fs from "fs";
+import fs from 'fs';
 /**
  * Ensures that a directory exists, creating parent directories if needed (like `mkdir -p`).
  *
@@ -72,7 +72,7 @@ export declare function getDirSize(dirPath: string): Promise<number>;
  * @param {(eventType: "rename" | "change", filename: string | null) => void} callback - Callback for each change event.
  * @returns {() => void} A function to stop watching the directory.
  */
-export declare function watchDir(dirPath: string, callback: (eventType: "rename" | "change", filename: string | null) => void): () => void;
+export declare function watchDir(dirPath: string, callback: (eventType: 'rename' | 'change', filename: string | null) => void): () => void;
 /**
  * Finds files matching a glob pattern.
  *
@@ -161,7 +161,7 @@ export declare function findInDir(dirPath: string, predicate: (path: string, sta
  * @returns {Promise<() => void>} A function to stop watching the directory.
  * @throws {Error} If directory cannot be watched.
  */
-export declare function watchDirRecursive(dirPath: string, callback: (eventType: "rename" | "change", filename: string) => void, includeSubdirs?: boolean): Promise<() => void>;
+export declare function watchDirRecursive(dirPath: string, callback: (eventType: 'rename' | 'change', filename: string) => void, includeSubdirs?: boolean): Promise<() => void>;
 /**
  * Gets detailed directory statistics including file count, directory count, and size.
  *
@@ -191,6 +191,6 @@ export declare function walkDir(dirPath: string, options: {
         isDirectory: boolean;
         stats: fs.Stats;
     }) => boolean | void | Promise<boolean | void>;
-    traversalOrder?: "pre" | "post";
+    traversalOrder?: 'pre' | 'post';
 }): Promise<void>;
 //# sourceMappingURL=dir.utils.d.ts.map

package/build/esm/utils/dir.utils.js

@@ -81,12 +81,12 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     }
     return to.concat(ar || Array.prototype.slice.call(from));
 };
-import os from "os";
-import fs from "fs";
-import fsp from "fs/promises";
-import path from "path";
-import { glob } from "glob";
-import { randomBytes } from "crypto";
+import os from 'os';
+import fs from 'fs';
+import fsp from 'fs/promises';
+import path from 'path';
+import { glob } from 'glob';
+import { randomBytes } from 'crypto';
 /**
  * Ensures that a directory exists, creating parent directories if needed (like `mkdir -p`).
  *
@@ -449,9 +449,7 @@ export function getSubdirectories(dirPath_1) {
                 case 0: return [4 /*yield*/, fsp.readdir(dirPath, { withFileTypes: true })];
                 case 1:
                     entries = _a.sent();
-                    dirs = entries
-                        .filter(function (entry) { return entry.isDirectory(); })
-                        .map(function (entry) { return path.join(dirPath, entry.name); });
+                    dirs = entries.filter(function (entry) { return entry.isDirectory(); }).map(function (entry) { return path.join(dirPath, entry.name); });
                     if (!(recursive && dirs.length > 0)) return [3 /*break*/, 3];
                     return [4 /*yield*/, Promise.all(dirs.map(function (dir) { return getSubdirectories(dir, true); }))];
                 case 2:
@@ -490,7 +488,7 @@ export function ensureEmptyDir(dirPath) {
                 case 5:
                     error_1 = _a.sent();
                     // Ignore if file doesn't exist
-                    if (error_1.code !== "ENOENT") {
+                    if (error_1.code !== 'ENOENT') {
                         throw error_1;
                     }
                     return [3 /*break*/, 6];
@@ -521,9 +519,9 @@ export function createTempDir() {
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
-                    prefix = options.prefix || "tmp-";
+                    prefix = options.prefix || 'tmp-';
                     parentDir = options.parentDir || os.tmpdir();
-                    dirName = "".concat(prefix).concat(randomBytes(6).toString("hex"));
+                    dirName = "".concat(prefix).concat(randomBytes(6).toString('hex'));
                     tempDirPath = path.join(parentDir, dirName);
                     return [4 /*yield*/, ensureDir(tempDirPath)];
                 case 1:
@@ -546,7 +544,7 @@ export function createTempDir() {
                         });
                     }); };
                     if (options.cleanup) {
-                        process.once("exit", function () {
+                        process.once('exit', function () {
                             try {
                                 fs.rmSync(tempDirPath, { recursive: true, force: true });
                             }
@@ -555,7 +553,7 @@ export function createTempDir() {
                             }
                         });
                         // Handle signals for better cleanup
-                        ["SIGINT", "SIGTERM", "SIGUSR1", "SIGUSR2"].forEach(function (signal) {
+                        ['SIGINT', 'SIGTERM', 'SIGUSR1', 'SIGUSR2'].forEach(function (signal) {
                             process.once(signal, function () {
                                 cleanup().then(function () { return process.exit(); });
                             });
@@ -740,7 +738,7 @@ export function watchDirRecursive(dirPath_1, callback_1) {
                                 var relativePath = path.relative(normalizedBasePath, fullPath);
                                 callback(eventType, relativePath);
                                 // If a new directory is created, we should watch it
-                                if (eventType === "rename" && includeSubdirs) {
+                                if (eventType === 'rename' && includeSubdirs) {
                                     setTimeout(function () { return __awaiter(_this, void 0, void 0, function () {
                                         var _a;
                                         return __generator(this, function (_b) {
@@ -889,7 +887,7 @@ export function walkDir(dirPath, options) {
         return __generator(this, function (_b) {
             switch (_b.label) {
                 case 0:
-                    traversalOrder = options.traversalOrder || "pre";
+                    traversalOrder = options.traversalOrder || 'pre';
                     return [4 /*yield*/, fsp.readdir(dirPath, { withFileTypes: true })];
                 case 1:
                     entries = _b.sent();
@@ -909,10 +907,10 @@ export function walkDir(dirPath, options) {
                         path: entryPath,
                         name: entry.name,
                         isDirectory: entry.isDirectory(),
-                        stats: stats,
+                        stats: stats
                     };
                     if (!entry.isDirectory()) return [3 /*break*/, 12];
-                    if (!(traversalOrder === "pre")) return [3 /*break*/, 8];
+                    if (!(traversalOrder === 'pre')) return [3 /*break*/, 8];
                     return [4 /*yield*/, options.visitorFn(entryInfo)];
                 case 5:
                     shouldContinue = _b.sent();
@@ -955,7 +953,7 @@ export function walkDir(dirPath, options) {
                     finally { if (e_8) throw e_8.error; }
                     return [7 /*endfinally*/];
                 case 18:
-                    if (!(traversalOrder === "post")) return [3 /*break*/, 21];
+                    if (!(traversalOrder === 'post')) return [3 /*break*/, 21];
                     return [4 /*yield*/, fsp.stat(dirPath)];
                 case 19:
                     stats = _b.sent();
@@ -963,7 +961,7 @@ export function walkDir(dirPath, options) {
                         path: dirPath,
                         name: path.basename(dirPath),
                         isDirectory: true,
-                        stats: stats,
+                        stats: stats
                     };
                     return [4 /*yield*/, options.visitorFn(entryInfo)];
                 case 20: