cipher-kit 2.0.0 → 2.1.0

package/dist/chunk-UVEMRK5F.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/web/kit.ts","../src/web/web-encode.ts","../src/web/web-encrypt.ts"],"names":["__export","$isStr","$err","ENCODING","$ok","$fmtError","title","$isPlainObj","ENCRYPTION_ALGORITHMS","DIGEST_ALGORITHMS","CIPHER_ENCODING","$isSecretKey","$fmtResultErr","error","matchEncryptedPattern","$stringifyObj","$parseToObj"],"mappings":"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","file":"chunk-UVEMRK5F.cjs","sourcesContent":["import { $fmtResultErr, type Result } from \"~/helpers/error\";\r\nimport type {\r\n  CreateSecretKeyOptions,\r\n  DecryptOptions,\r\n  Encoding,\r\n  EncryptOptions,\r\n  HashOptions,\r\n  HashPasswordOptions,\r\n  SecretKey,\r\n  VerifyPasswordOptions,\r\n} from \"~/helpers/types\";\r\nimport { $isSecretKey } from \"~/helpers/validate\";\r\nimport { $convertBytesToStr, $convertEncoding, $convertStrToBytes } from \"./web-encode\";\r\nimport {\r\n  $createSecretKey,\r\n  $decrypt,\r\n  $decryptObj,\r\n  $encrypt,\r\n  $encryptObj,\r\n  $generateUuid,\r\n  $hash,\r\n  $hashPassword,\r\n  $verifyPassword,\r\n} from \"./web-encrypt\";\r\n\r\n/**\r\n * Type guard to check if the provided value is a SecretKey object for Web (Deno, Bun, Cloudflare included) environment.\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * Checking if the key in your hand is the right kind of key for the lock.\r\n *\r\n * @param x - The value to check.\r\n * @returns True if the value is a SecretKey object for Web, false otherwise.\r\n *\r\n * @example\r\n * ```ts\r\n * isWebSecretKey(webKey); // true\r\n * isWebSecretKey(nodeKey); // false\r\n * isWebSecretKey({}); // false\r\n * ```\r\n */\r\nexport function isWebSecretKey(x: unknown): x is SecretKey<\"web\"> {\r\n  return $isSecretKey(x, \"web\") !== null;\r\n}\r\n\r\n/**\r\n * Safely generates a UUID (v4) (non-throwing).\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * It's like giving your pet a name tag with a super random name made of numbers and letters.\r\n * The chance of two pets getting the same name tag is practically zero, and it's very hard to guess!\r\n *\r\n * @returns A `Result` containing the UUID string or an error.\r\n *\r\n * @example\r\n * ```ts\r\n * const {result, error, success} = tryGenerateUuid();\r\n *\r\n * if (success) console.log(result); // \"...\" (a UUID string)\r\n * else console.error(error); // { message: \"...\", description: \"...\" }\r\n * ```\r\n */\r\nexport function tryGenerateUuid(): Result<string> {\r\n  return $generateUuid();\r\n}\r\n\r\n/**\r\n * Generates a UUID (v4) (throwing).\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * It's like giving your pet a name tag with a super random name made of numbers and letters.\r\n * The chance of two pets getting the same name tag is practically zero, and it's very hard to guess!\r\n *\r\n * @returns A UUID string.\r\n * @throws {Error} If UUID generation fails.\r\n *\r\n * @example\r\n * ```ts\r\n * const uuid = generateUuid(); // \"...\" (a UUID string)\r\n * ```\r\n */\r\nexport function generateUuid(): string {\r\n  const { result, error } = $generateUuid();\r\n  if (error) throw new Error($fmtResultErr(error));\r\n  return result;\r\n}\r\n\r\n/**\r\n * Safely derives a `SecretKey` from the provided string for encryption/decryption (non-throwing).\r\n *\r\n * Uses HKDF to derive a key from the input string.\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * Imagine you want to create a special key for future use to lock your treasure box (data).\r\n * So, you stir in some secret ingredients (like salt and info) to make sure your key is one-of-a-kind.\r\n *\r\n * @param secret - The input string to derive the `SecretKey` from, must be at least 8 characters.\r\n * @param options.algorithm - The encryption algorithm to use (default: `'aes256gcm'`).\r\n * @param options.digest - The hash algorithm for HKDF (default: `'sha256'`).\r\n * @param options.salt - A salt string (default: `'cipher-kit-salt'`, must be ≥ 8 chars).\r\n * @param options.info - An info string (default: `'cipher-kit'`).\r\n * @returns A `Result` promise containing the derived `SecretKey` or an error.\r\n *\r\n * @example\r\n * ```ts\r\n * const {result, error, success} = await tryCreateSecretKey(\"my-secret\");\r\n *\r\n * if (success) console.log(result); // SecretKey object\r\n * else console.error(error); // { message: \"...\", description: \"...\" }\r\n * ```\r\n */\r\nexport async function tryCreateSecretKey(\r\n  secret: string,\r\n  options: CreateSecretKeyOptions = {},\r\n): Promise<Result<{ result: SecretKey<\"web\"> }>> {\r\n  return await $createSecretKey(secret, options);\r\n}\r\n\r\n/**\r\n * Derives a `SecretKey` from the provided string for encryption/decryption (throwing).\r\n *\r\n * Uses HKDF to derive a key from the input string.\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * Imagine you want to create a special key for future use to lock your treasure box (data).\r\n * So, you stir in some secret ingredients (like salt and info) to make sure your key is one-of-a-kind.\r\n *\r\n * @param secret - The input string to derive the `SecretKey` from, must be at least 8 characters.\r\n * @param options.algorithm - The encryption algorithm to use (default: `'aes256gcm'`).\r\n * @param options.digest - The hash algorithm for HKDF (default: `'sha256'`).\r\n * @param options.salt - A salt string (default: `'cipher-kit-salt'`, must be ≥ 8 chars).\r\n * @param options.info - An info string (default: `'cipher-kit'`).\r\n * @returns A promise of the derived `SecretKey`.\r\n * @throws {Error} If key derivation fails.\r\n *\r\n * @example\r\n * ```ts\r\n * const secretKey = await createSecretKey(\"my-secret\"); // SecretKey object\r\n * ```\r\n */\r\nexport async function createSecretKey(secret: string, options: CreateSecretKeyOptions = {}): Promise<SecretKey<\"web\">> {\r\n  const { result, error } = await $createSecretKey(secret, options);\r\n  if (error) throw new Error($fmtResultErr(error));\r\n  return result;\r\n}\r\n\r\n/**\r\n * Safely encrypts a UTF-8 string using the provided `SecretKey` (non-throwing).\r\n *\r\n * Output format: \"iv.cipherWithTag.\"\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * You scramble a secret message with your special key,\r\n * creating a jumbled code that only someone with the right key can read.\r\n *\r\n * @param data - A UTF-8 string to encrypt.\r\n * @param secretKey - The `SecretKey` object used for encryption.\r\n * @param options.outputEncoding - The encoding format for the output ciphertext (default: `'base64url'`).\r\n * @returns A `Result` promise containing the encrypted string in the specified format or an error.\r\n *\r\n * @example\r\n * ```ts\r\n * const secretKey = await createSecretKey(\"my-secret\");\r\n * const {result, error, success} = await tryEncrypt(\"Hello, World!\", secretKey);\r\n *\r\n * if (success) console.log(result); // \"iv.cipherWithTag.\" (Encrypted string)\r\n * else console.error(error); // { message: \"...\", description: \"...\" }\r\n * ```\r\n */\r\nexport async function tryEncrypt(\r\n  data: string,\r\n  secretKey: SecretKey<\"web\">,\r\n  options: EncryptOptions = {},\r\n): Promise<Result<string>> {\r\n  return await $encrypt(data, secretKey, options);\r\n}\r\n\r\n/**\r\n * Encrypts a UTF-8 string using the provided `SecretKey` (throwing).\r\n *\r\n * Output format: \"iv.cipherWithTag.\"\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * You scramble a secret message with your special key,\r\n * creating a jumbled code that only someone with the right key can read.\r\n *\r\n * @param data - A UTF-8 string to encrypt.\r\n * @param secretKey - The `SecretKey` object used for encryption.\r\n * @param options.outputEncoding - The encoding format for the output ciphertext (default: `'base64url'`).\r\n * @returns A promise with the encrypted string in the specified format.\r\n * @throws {Error} If the input data or key is invalid, or if encryption fails.\r\n *\r\n * @example\r\n * ```ts\r\n * const secretKey = await createSecretKey(\"my-secret\");\r\n * const encrypted = await encrypt(\"Hello, World!\", secretKey); // \"iv.cipherWithTag.\" (Encrypted string)\r\n * ```\r\n */\r\nexport async function encrypt(\r\n  data: string,\r\n  secretKey: SecretKey<\"web\">,\r\n  options: EncryptOptions = {},\r\n): Promise<string> {\r\n  const { result, error } = await $encrypt(data, secretKey, options);\r\n  if (error) throw new Error($fmtResultErr(error));\r\n  return result;\r\n}\r\n\r\n/**\r\n * Safely decrypts the input string using the provided `SecretKey` (non-throwing).\r\n *\r\n * Expects input in the format \"iv.cipherWithTag.\" and returns the decrypted UTF-8 string.\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * You take a scrambled secret message and use your special key to unscramble it,\r\n * revealing the original message inside.\r\n *\r\n * @param encrypted - The input string to decrypt, in the format \"iv.cipherWithTag.\".\r\n * @param secretKey - The `SecretKey` object used for decryption.\r\n * @param options.inputEncoding - The encoding format for the input ciphertext (default: `'base64url'`).\r\n * @returns A `Result` promise containing the decrypted UTF-8 string or an error.\r\n *\r\n * @example\r\n * ```ts\r\n * const secretKey = await createSecretKey(\"my-secret\");\r\n * const encrypted = await encrypt(\"Hello, World!\", secretKey);\r\n * const {result, error, success} = await tryDecrypt(encrypted, secretKey);\r\n *\r\n * if (success) console.log(result); // \"Hello, World!\"\r\n * else console.error(error); // { message: \"...\", description: \"...\" }\r\n * ```\r\n */\r\nexport async function tryDecrypt(\r\n  encrypted: string,\r\n  secretKey: SecretKey<\"web\">,\r\n  options: DecryptOptions = {},\r\n): Promise<Result<string>> {\r\n  return await $decrypt(encrypted, secretKey, options);\r\n}\r\n\r\n/**\r\n * Decrypts the input string using the provided `SecretKey` (throwing).\r\n *\r\n * Expects input in the format \"iv.cipherWithTag.\" and returns the decrypted UTF-8 string.\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * You take a scrambled secret message and use your special key to unscramble it,\r\n * revealing the original message inside.\r\n *\r\n * @param encrypted - The input string to decrypt, in the format \"iv.cipherWithTag.\".\r\n * @param secretKey - The `SecretKey` object used for decryption.\r\n * @param options.inputEncoding - The encoding format for the input ciphertext (default: `'base64url'`).\r\n * @returns A promise with the decrypted UTF-8 string.\r\n * @throws {Error} If the input data or key is invalid, or if decryption fails.\r\n *\r\n * @example\r\n * ```ts\r\n * const secretKey = await createSecretKey(\"my-secret\");\r\n * const encrypted = await encrypt(\"Hello, World!\", secretKey);\r\n * const decrypted = await decrypt(encrypted, secretKey); // \"Hello, World!\"\r\n * ```\r\n */\r\nexport async function decrypt(\r\n  encrypted: string,\r\n  secretKey: SecretKey<\"web\">,\r\n  options: DecryptOptions = {},\r\n): Promise<string> {\r\n  const { result, error } = await $decrypt(encrypted, secretKey, options);\r\n  if (error) throw new Error($fmtResultErr(error));\r\n  return result;\r\n}\r\n\r\n/**\r\n * Safely encrypts a plain object using the provided `SecretKey` (non-throwing).\r\n *\r\n * Only plain objects (POJOs) are accepted. Class instances, Maps, Sets, etc. are rejected.\r\n *\r\n * Output format: \"iv.cipherWithTag.\"\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * Imagine you have a toy box (an object) that you want to keep secret.\r\n * So, you take a picture of your toy box (convert it to JSON), and scramble that with\r\n * your special key, creating a jumbled code that only someone with the right key can read.\r\n *\r\n * @template T - The type of the plain object to encrypt.\r\n * @param data - A plain object to encrypt.\r\n * @param secretKey - The `SecretKey` object used for encryption.\r\n * @param options.outputEncoding - The encoding format for the output ciphertext (default: `'base64url'`).\r\n * @returns A `Result` promise containing the encrypted string in the specified format or an error.\r\n *\r\n * @example\r\n * ```ts\r\n * const secretKey = await createSecretKey(\"my-secret\");\r\n * const {result, error, success} = await tryEncryptObj({ a: 1 }, secretKey);\r\n *\r\n * if (success) console.log(result); // \"iv.cipherWithTag.\" (Encrypted string)\r\n * else console.error(error); // { message: \"...\", description: \"...\" }\r\n * ```\r\n */\r\nexport async function tryEncryptObj<T extends object = Record<string, unknown>>(\r\n  data: T,\r\n  secretKey: SecretKey<\"web\">,\r\n  options: EncryptOptions = {},\r\n): Promise<Result<string>> {\r\n  return await $encryptObj(data, secretKey, options);\r\n}\r\n\r\n/**\r\n * Encrypts a plain object using the provided `SecretKey` (throwing).\r\n *\r\n * Only plain objects (POJOs) are accepted. Class instances, Maps, Sets, etc. are rejected.\r\n *\r\n * Output format: \"iv.cipherWithTag.\"\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * Imagine you have a toy box (an object) that you want to keep secret.\r\n * So, you take a picture of your toy box (convert it to JSON), and scramble that with\r\n * your special key, creating a jumbled code that only someone with the right key can read.\r\n *\r\n * @template T - The type of the plain object to encrypt.\r\n * @param data - A plain object to encrypt.\r\n * @param secretKey - The `SecretKey` object used for encryption.\r\n * @param options.outputEncoding - The encoding format for the output ciphertext (default: `'base64url'`).\r\n * @returns A promise with the encrypted string in the specified format.\r\n * @throws {Error} If the input data or key is invalid, or if encryption fails.\r\n *\r\n * @example\r\n * ```ts\r\n * const secretKey = await createSecretKey(\"my-secret\");\r\n * const encrypted = await encryptObj({ a: 1 }, secretKey); // \"iv.cipherWithTag.\" (Encrypted string)\r\n * ```\r\n */\r\nexport async function encryptObj<T extends object = Record<string, unknown>>(\r\n  data: T,\r\n  secretKey: SecretKey<\"web\">,\r\n  options: EncryptOptions = {},\r\n): Promise<string> {\r\n  const { result, error } = await $encryptObj(data, secretKey, options);\r\n  if (error) throw new Error($fmtResultErr(error));\r\n  return result;\r\n}\r\n\r\n/**\r\n * Safely decrypts an encrypted JSON string into an object (non-throwing).\r\n *\r\n * Expects input in the format `\"iv.cipherWithTag.\"` and returns a plain object.\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * You rebuild your toy box (an object) by unscrambling the jumbled code (encrypted text),\r\n * using your special key to open it.\r\n *\r\n * @template T - The expected shape of the decrypted object.\r\n * @param encrypted - The encrypted string (format: `\"iv.cipherWithTag.\"`).\r\n * @param secretKey - The `SecretKey` used for decryption.\r\n * @param options.inputEncoding - Input ciphertext encoding (default: `'base64url'`).\r\n * @returns A `Result` promise with the decrypted object on success, or an error.\r\n *\r\n * @example\r\n * ```ts\r\n * const secretKey = await createSecretKey(\"my-secret\");\r\n * const encrypted = await encryptObj({ a: 1 }, secretKey);\r\n * const {result, error, success} = await tryDecryptObj<{ a: number }>(encrypted, secretKey);\r\n *\r\n * if (success) console.log(result); // { a: 1 }\r\n * else console.error(error); // { message: \"...\", description: \"...\" }\r\n * ```\r\n */\r\nexport async function tryDecryptObj<T extends object = Record<string, unknown>>(\r\n  encrypted: string,\r\n  secretKey: SecretKey<\"web\">,\r\n  options: DecryptOptions = {},\r\n): Promise<Result<{ result: T }>> {\r\n  return await $decryptObj<T>(encrypted, secretKey, options);\r\n}\r\n\r\n/**\r\n * Decrypts an encrypted JSON string into an object (throwing).\r\n *\r\n * Expects input in the format `\"iv.cipherWithTag.\"` and returns a plain object.\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * You rebuild your toy box (an object) by unscrambling the jumbled code (encrypted text),\r\n * using your special key to open it.\r\n *\r\n * @template T - The expected shape of the decrypted object.\r\n * @param encrypted - The encrypted string (format: `\"iv.cipherWithTag.\"`).\r\n * @param secretKey - The `SecretKey` used for decryption.\r\n * @param options.inputEncoding - Input ciphertext encoding (default: `'base64url'`).\r\n * @returns A promise with the decrypted object.\r\n * @throws {Error} If decryption or JSON parsing fails.\r\n *\r\n * @example\r\n * ```ts\r\n * const secretKey = await createSecretKey(\"my-secret\");\r\n * const encrypted = await encryptObj({ a: 1 }, secretKey);\r\n * const obj = await decryptObj<{ a: number }>(encrypted, secretKey); // obj.a === 1\r\n * ```\r\n */\r\nexport async function decryptObj<T extends object = Record<string, unknown>>(\r\n  encrypted: string,\r\n  secretKey: SecretKey<\"web\">,\r\n  options: DecryptOptions = {},\r\n): Promise<T> {\r\n  const { result, error } = await $decryptObj<T>(encrypted, secretKey, options);\r\n  if (error) throw new Error($fmtResultErr(error));\r\n  return result;\r\n}\r\n\r\n/**\r\n * Safely hashes a UTF-8 string (non-throwing).\r\n *\r\n * Uses the selected digest (default: `'sha256'`) and returns the hash\r\n * in the chosen encoding (default: `'base64url'`).\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * Like putting something in a blender and getting a smoothie, you can’t get the original ingredients back,\r\n * but the smoothie is always the same if you use the same ingredients.\r\n *\r\n * @param data - The input string to hash.\r\n * @param options.digest - Hash algorithm (`'sha256' | 'sha384' | 'sha512'`, default: `'sha256'`).\r\n * @param options.outputEncoding - Output encoding (`'base64' | 'base64url' | 'hex'`, default: `'base64url'`).\r\n * @returns A `Result` promise with the hash string or an error.\r\n *\r\n * @example\r\n * ```ts\r\n * const {result, error, success} = await tryHash(\"my data\");\r\n *\r\n * if (success) console.log(result); // \"...\" (Hashed string)\r\n * else console.error(error); // { message: \"...\", description: \"...\" }\r\n * ```\r\n */\r\nexport async function tryHash(data: string, options: HashOptions = {}): Promise<Result<string>> {\r\n  return await $hash(data, options);\r\n}\r\n\r\n/**\r\n * Hashes a UTF-8 string (throwing).\r\n *\r\n * Uses the selected digest (default: `'sha256'`) and returns the hash\r\n * in the chosen encoding (default: `'base64url'`).\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * Like putting something in a blender and getting a smoothie, you can’t get the original ingredients back,\r\n * but the smoothie is always the same if you use the same ingredients.\r\n *\r\n * @param data - The input string to hash.\r\n * @param options.digest - Hash algorithm (`'sha256' | 'sha384' | 'sha512'`, default: `'sha256'`).\r\n * @param options.outputEncoding - Output encoding (`'base64' | 'base64url' | 'hex'`, default: `'base64url'`).\r\n * @returns A promise of the hashed string.\r\n * @throws {Error} If input is invalid or hashing fails.\r\n *\r\n * @example\r\n * ```ts\r\n * const hashed = await hash(\"my data\"); // \"...\" (Hashed string)\r\n * ```\r\n */\r\nexport async function hash(data: string, options: HashOptions = {}): Promise<string> {\r\n  const { result, error } = await $hash(data, options);\r\n  if (error) throw new Error($fmtResultErr(error));\r\n  return result;\r\n}\r\n\r\n/**\r\n * Safely hashes a password using PBKDF2 (non-throwing).\r\n *\r\n * Uses strong defaults (`sha512`, 320k iterations, 64-byte key, 16-byte salt) and\r\n * returns `{ hash, salt }` encoded (default: `'base64url'`).\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * We take your password, mix in some random salt, and stir many times.\r\n * The result is a super-secret soup that’s hard to copy.\r\n *\r\n * @param password - The password to hash.\r\n * @param options.digest - Hash algorithm (`'sha256' | 'sha384' | 'sha512'`; default: `'sha512'`).\r\n * @param options.outputEncoding - Output encoding (`'base64' | 'base64url' | 'hex'`; default: `'base64url'`).\r\n * @param options.saltLength - Length of the random salt in bytes (default: `16` bytes, min: `8` bytes).\r\n * @param options.iterations - Number of iterations (default: `320000`, min: `1000`).\r\n * @param options.keyLength - Length of the derived key in bytes (default: `64` bytes, min: `16` bytes).\r\n * @returns A `Result` promise with `{ result, salt }` or an error.\r\n *\r\n * @example\r\n * ```ts\r\n * const {result, error, success} = await tryHashPassword(\"my-password\");\r\n *\r\n * if (success) console.log(result, salt); // \"...\" (hashed password), \"...\" (salt)\r\n * else console.error(error); // { message: \"...\", description: \"...\" }\r\n * ```\r\n */\r\nexport async function tryHashPassword(\r\n  password: string,\r\n  options: HashPasswordOptions = {},\r\n): Promise<Result<{ result: string; salt: string }>> {\r\n  return await $hashPassword(password, options);\r\n}\r\n\r\n/**\r\n * Hashes a password using PBKDF2 (throwing).\r\n *\r\n * Uses strong defaults (`sha512`, 320k iterations, 64-byte key, 16-byte salt) and\r\n * returns `{ hash, salt }` encoded (default: `'base64url'`).\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * We take your password, mix in some random salt, and stir many times.\r\n * The result is a super-secret soup that’s hard to copy.\r\n *\r\n * @param password - The password to hash.\r\n * @param options.digest - Hash algorithm (`'sha256' | 'sha384' | 'sha512'`; default: `'sha512'`).\r\n * @param options.outputEncoding - Output encoding (`'base64' | 'base64url' | 'hex'`; default: `'base64url'`).\r\n * @param options.saltLength - Length of the random salt in bytes (default: `16` bytes, min: `8` bytes).\r\n * @param options.iterations - Number of iterations (default: `320000`, min: `1000`).\r\n * @param options.keyLength - Length of the derived key in bytes (default: `64` bytes, min: `16` bytes).\r\n * @returns A promise with `{ result, salt }` for storage.\r\n * @throws {Error} If inputs are invalid or hashing fails.\r\n *\r\n * @example\r\n * ```ts\r\n * const {result, salt} = await hashPassword(\"my-password\"); // \"...\" (hashed password), \"...\" (salt)\r\n * ```\r\n */\r\nexport async function hashPassword(\r\n  password: string,\r\n  options: HashPasswordOptions = {},\r\n): Promise<{ result: string; salt: string }> {\r\n  const { result, salt, error } = await $hashPassword(password, options);\r\n  if (error) throw new Error($fmtResultErr(error));\r\n  return { result, salt };\r\n}\r\n\r\n/**\r\n * Verifies a password against a stored PBKDF2 hash (non-throwing).\r\n *\r\n * Re-derives the key using the same parameters and compares in constant time, to prevent timing attacks.\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * We follow the same recipe as when we made the secret.\r\n * If the new soup tastes exactly the same, the password is correct.\r\n *\r\n * @param password - The plain password to verify.\r\n * @param hashedPassword - The stored hash (encoded).\r\n * @param salt - The stored salt (encoded).\r\n * @param options.digest - Hash algorithm used during hashing (`'sha256' | 'sha384' | 'sha512'`; default: `'sha512'`).\r\n * @param options.inputEncoding - Encoding of the stored hash and salt (`'base64' | 'base64url' | 'hex'`; default: `'base64url'`).\r\n * @param options.iterations - Number of iterations used during hashing (default: `320000`).\r\n * @param options.keyLength - Length of the derived key in bytes used during hashing (default: `64` bytes).\r\n * @returns A promise of boolean, `true` if the password matches, otherwise `false`.\r\n *\r\n * @example\r\n * ```ts\r\n * const {result, salt} = await hashPassword(\"my-password\");\r\n *\r\n * await verifyPassword(\"my-password\", result, salt); // true\r\n * await verifyPassword(\"wrong-password\", result, salt); // false\r\n * ```\r\n */\r\nexport async function verifyPassword(\r\n  password: string,\r\n  hashedPassword: string,\r\n  salt: string,\r\n  options: VerifyPasswordOptions = {},\r\n): Promise<boolean> {\r\n  return await $verifyPassword(password, hashedPassword, salt, options);\r\n}\r\n\r\n/**\r\n * Safely converts a string to a `Uint8Array` using the specified encoding (non-throwing).\r\n *\r\n * Supported encodings: `'base64' | 'base64url' | 'hex' | 'utf8' | 'latin1'` (default: `'utf8'`).\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * This turns your words into tiny computer building blocks (bytes) so computers can work with them.\r\n *\r\n * @param data - The input string to convert.\r\n * @param inputEncoding - The encoding of the input string (default: `'utf8'`).\r\n * @returns A `Result` with `{ result: Uint8Array }` or an error.\r\n *\r\n * @example\r\n * ```ts\r\n * const {result, error, success} = tryConvertStrToBytes(\"Hello\", \"utf8\");\r\n *\r\n * if (success) console.log(result); // Uint8Array([...])\r\n * else console.error(error); // { message: \"...\", description: \"...\" }\r\n * ```\r\n */\r\nexport function tryConvertStrToBytes(\r\n  data: string,\r\n  inputEncoding: Encoding = \"utf8\",\r\n): Result<{ result: Uint8Array<ArrayBuffer> }> {\r\n  return $convertStrToBytes(data, inputEncoding);\r\n}\r\n\r\n/**\r\n * Converts a string to a `Uint8Array` using the specified encoding (throwing).\r\n *\r\n * Supported encodings: `'base64' | 'base64url' | 'hex' | 'utf8' | 'latin1'` (default: `'utf8'`).\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * This turns your words into tiny computer building blocks (bytes) so computers can work with them.\r\n *\r\n * @param data - The input string to convert.\r\n * @param inputEncoding - The encoding of the input string (default: `'utf8'`).\r\n * @returns A `Uint8Array` containing the bytes.\r\n * @throws {Error} If input is invalid or conversion fails.\r\n *\r\n * @example\r\n * ```ts\r\n * const bytes = convertStrToBytes(\"Hello\", \"utf8\"); // Uint8Array([...])\r\n * ```\r\n */\r\nexport function convertStrToBytes(data: string, inputEncoding: Encoding = \"utf8\"): Uint8Array<ArrayBuffer> {\r\n  const { result, error } = $convertStrToBytes(data, inputEncoding);\r\n  if (error) throw new Error($fmtResultErr(error));\r\n  return result;\r\n}\r\n\r\n/**\r\n * Safely converts a `Uint8Array` or `ArrayBuffer` to a string using the specified encoding (non-throwing).\r\n *\r\n * Supported encodings: `'base64' | 'base64url' | 'hex' | 'utf8' | 'latin1'` (default: `'utf8'`).\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * This turns the tiny computer building blocks (bytes) back into a readable sentence.\r\n *\r\n * @param data - The `Uint8Array` or `ArrayBuffer` to convert.\r\n * @param outputEncoding - The output encoding (default: `'utf8'`).\r\n * @returns A `Result` with the string or an error.\r\n *\r\n * @example\r\n * ```ts\r\n * const bytes = convertStrToBytes(\"Hello\", \"utf8\"); // Uint8Array([...])\r\n * const {result, error, success} = tryConvertBytesToStr(bytes, \"utf8\");\r\n *\r\n * if (success) console.log(result); // \"Hello\"\r\n * else console.error(error); // { message: \"...\", description: \"...\" }\r\n * ```\r\n */\r\nexport function tryConvertBytesToStr(\r\n  data: Uint8Array | ArrayBuffer,\r\n  outputEncoding: Encoding = \"utf8\",\r\n): Result<string> {\r\n  return $convertBytesToStr(data, outputEncoding);\r\n}\r\n\r\n/**\r\n * Converts a `Uint8Array` or `ArrayBuffer` to a string using the specified encoding (throwing).\r\n *\r\n * Supported encodings: `'base64' | 'base64url' | 'hex' | 'utf8' | 'latin1'` (default: `'utf8'`).\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * This turns the tiny computer building blocks (bytes) back into a readable sentence.\r\n *\r\n * @param data - The `Uint8Array` or `ArrayBuffer` to convert.\r\n * @param outputEncoding - The output encoding (default: `'utf8'`).\r\n * @returns The encoded string.\r\n * @throws {Error} If input is invalid or conversion fails.\r\n *\r\n * @example\r\n * ```ts\r\n * const bytes = convertStrToBytes(\"Hello\", \"utf8\"); // Uint8Array([...])\r\n * const str = convertBytesToStr(bytes, \"utf8\"); // \"Hello\"\r\n * ```\r\n */\r\nexport function convertBytesToStr(data: Uint8Array | ArrayBuffer, outputEncoding: Encoding = \"utf8\"): string {\r\n  const { result, error } = $convertBytesToStr(data, outputEncoding);\r\n  if (error) throw new Error($fmtResultErr(error));\r\n  return result;\r\n}\r\n\r\n/**\r\n * Safely converts text between encodings (non-throwing).\r\n *\r\n * Example: convert `'utf8'` text to `'base64url'`, or `'hex'` to `'utf8'`.\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * It’s like translating your sentence from one alphabet to another.\r\n *\r\n * @param data - The input string to convert.\r\n * @param from - The current encoding of `data`.\r\n * @param to - The target encoding for `data`.\r\n * @returns A `Result` with a string or an error.\r\n *\r\n * @example\r\n * ```ts\r\n * const {result, error, success} = tryConvertEncoding(\"Hello\", \"utf8\", \"base64url\");\r\n *\r\n * if (success) console.log(result); // \"...\" (Base64url encoded string)\r\n * else console.error(error); // { message: \"...\", description: \"...\" }\r\n * ```\r\n */\r\nexport function tryConvertEncoding(data: string, from: Encoding, to: Encoding): Result<string> {\r\n  return $convertEncoding(data, from, to);\r\n}\r\n\r\n/**\r\n * Converts text between encodings (throwing).\r\n *\r\n * Example: convert `'utf8'` text to `'base64url'`, or `'hex'` to `'utf8'`.\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * It’s like translating your sentence from one alphabet to another.\r\n *\r\n * @param data - The input string to convert.\r\n * @param from - The current encoding of `data`.\r\n * @param to - The target encoding for `data`.\r\n * @returns The converted string.\r\n * @throws {Error} If encodings are invalid or conversion fails.\r\n *\r\n * @example\r\n * ```ts\r\n * const base64url = convertEncoding(\"Hello\", \"utf8\", \"base64url\"); // \"...\" (Base64url encoded string)\r\n * ```\r\n */\r\nexport function convertEncoding(data: string, from: Encoding, to: Encoding): string {\r\n  const { result, error } = $convertEncoding(data, from, to);\r\n  if (error) throw new Error($fmtResultErr(error));\r\n  return result;\r\n}\r\n","import { ENCODING } from \"~/helpers/consts\";\r\nimport { $err, $fmtError, $ok, type Result } from \"~/helpers/error\";\r\nimport type { Encoding } from \"~/helpers/types\";\r\nimport { $isStr } from \"~/helpers/validate\";\r\n\r\nexport const textEncoder = new TextEncoder();\r\nexport const textDecoder = new TextDecoder();\r\n\r\nexport function $convertStrToBytes(\r\n  data: string,\r\n  inputEncoding: Encoding = \"utf8\",\r\n): Result<{ result: Uint8Array<ArrayBuffer> }> {\r\n  if (!$isStr(data)) {\r\n    return $err({\r\n      msg: \"Crypto Web API - String to Bytes: Empty data\",\r\n      desc: \"Data must be a non-empty string\",\r\n    });\r\n  }\r\n  if (!ENCODING.includes(inputEncoding)) {\r\n    return $err({\r\n      msg: `Crypto Web API - String to Bytes: Unsupported encoding: ${inputEncoding}`,\r\n      desc: \"Use base64, base64url, hex, utf8, or latin1\",\r\n    });\r\n  }\r\n\r\n  try {\r\n    const bytes = strToBytes[inputEncoding](data);\r\n    return $ok({ result: bytes });\r\n  } catch (error) {\r\n    return $err({ msg: \"Crypto Web API - String to Bytes: Failed to convert data\", desc: $fmtError(error) });\r\n  }\r\n}\r\n\r\nexport function $convertBytesToStr(data: Uint8Array | ArrayBuffer, outputEncoding: Encoding = \"utf8\"): Result<string> {\r\n  if (!(data instanceof ArrayBuffer || data instanceof Uint8Array)) {\r\n    return $err({\r\n      msg: \"Crypto Web API - Bytes to String: Invalid data type\",\r\n      desc: \"Data must be an ArrayBuffer or Uint8Array\",\r\n    });\r\n  }\r\n  if (!ENCODING.includes(outputEncoding)) {\r\n    return $err({\r\n      msg: `Crypto Web API - Bytes to String: Unsupported encoding: ${outputEncoding}`,\r\n      desc: \"Use base64, base64url, hex, utf8, or latin1\",\r\n    });\r\n  }\r\n  try {\r\n    const bytes = data instanceof Uint8Array ? data : new Uint8Array(data);\r\n    const str = bytesToStr[outputEncoding](bytes);\r\n    return $ok(str);\r\n  } catch (error) {\r\n    return $err({ msg: \"Crypto Web API - Bytes to String: Failed to convert data\", desc: $fmtError(error) });\r\n  }\r\n}\r\n\r\nexport function $convertEncoding(data: string, from: Encoding, to: Encoding): Result<string> {\r\n  if (!$isStr(data)) {\r\n    return $err({\r\n      msg: \"Crypto Web API - Convert Format: Empty data\",\r\n      desc: \"Data must be a non-empty string\",\r\n    });\r\n  }\r\n  if (!ENCODING.includes(from) || !ENCODING.includes(to)) {\r\n    return $err({\r\n      msg: `Crypto Web API - Convert Format: Unsupported encoding: from ${from} to ${to}`,\r\n      desc: \"Use base64, base64url, hex, utf8, or latin1\",\r\n    });\r\n  }\r\n\r\n  const bytes = $convertStrToBytes(data, from);\r\n  if (bytes.error) return $err({ msg: bytes.error.message, desc: bytes.error.description });\r\n\r\n  const str = $convertBytesToStr(bytes.result, to);\r\n  if (str.error) return $err({ msg: str.error.message, desc: str.error.description });\r\n\r\n  return $ok({ result: str.result });\r\n}\r\n\r\nconst strToBytes = {\r\n  base64: $fromBase64,\r\n  base64url: $fromBase64Url,\r\n  hex: $fromHex,\r\n  latin1: $fromLatin1,\r\n  utf8: (data: string) => textEncoder.encode(data),\r\n} as const satisfies Record<Encoding, (data: string) => Uint8Array<ArrayBuffer>>;\r\n\r\nconst bytesToStr = {\r\n  base64: $toBase64,\r\n  base64url: $toBase64Url,\r\n  hex: $toHex,\r\n  latin1: $toLatin1,\r\n  utf8: (data: Uint8Array) => textDecoder.decode(data),\r\n} as const satisfies Record<Encoding, (data: Uint8Array) => string>;\r\n\r\nfunction $toLatin1(bytes: Uint8Array): string {\r\n  let out = \"\";\r\n  const chunk = 1 << 15; // 32KiB per chunk\r\n  for (let i = 0; i < bytes.length; i += chunk) {\r\n    out += String.fromCharCode(...bytes.subarray(i, i + chunk));\r\n  }\r\n  return out;\r\n}\r\n\r\nfunction $fromLatin1(data: string): Uint8Array<ArrayBuffer> {\r\n  const out = new Uint8Array(data.length);\r\n  for (let i = 0; i < data.length; i++) {\r\n    const charCode = data.charCodeAt(i);\r\n    if (charCode > 255) throw new Error(\"Invalid latin1 string\");\r\n    out[i] = charCode;\r\n  }\r\n  return out;\r\n}\r\n\r\nfunction $toBase64(bytes: Uint8Array): string {\r\n  return btoa($toLatin1(bytes));\r\n}\r\n\r\nfunction $fromBase64(data: string): Uint8Array<ArrayBuffer> {\r\n  return $fromLatin1(atob(data));\r\n}\r\n\r\nfunction $toBase64Url(bytes: Uint8Array): string {\r\n  return $toBase64(bytes).replace(/\\+/g, \"-\").replace(/\\//g, \"_\").replace(/=+$/, \"\");\r\n}\r\n\r\nfunction $fromBase64Url(data: string): Uint8Array<ArrayBuffer> {\r\n  let base64 = data.replace(/-/g, \"+\").replace(/_/g, \"/\");\r\n  const padLen = (4 - (base64.length % 4)) % 4;\r\n  base64 += \"=\".repeat(padLen);\r\n  return $fromBase64(base64);\r\n}\r\n\r\nfunction $toHex(bytes: Uint8Array): string {\r\n  return Array.from(bytes)\r\n    .map((b) => b.toString(16).padStart(2, \"0\"))\r\n    .join(\"\");\r\n}\r\n\r\nfunction $fromHex(data: string): Uint8Array<ArrayBuffer> {\r\n  const clean = data.startsWith(\"0x\") ? data.slice(2) : data;\r\n  if (clean.length % 2 !== 0) throw new Error(\"Invalid hex string\");\r\n  const out = new Uint8Array(clean.length / 2);\r\n  for (let i = 0; i < out.length; i++) {\r\n    const byte = Number.parseInt(clean.slice(i * 2, i * 2 + 2), 16);\r\n    if (Number.isNaN(byte)) throw new Error(\"Invalid hex string\");\r\n    out[i] = byte;\r\n  }\r\n  return out;\r\n}\r\n","import { CIPHER_ENCODING, DIGEST_ALGORITHMS, ENCRYPTION_ALGORITHMS } from \"~/helpers/consts\";\r\nimport { $err, $fmtError, $fmtResultErr, $ok, type Result, title } from \"~/helpers/error\";\r\nimport { $parseToObj, $stringifyObj } from \"~/helpers/object\";\r\nimport type {\r\n  CreateSecretKeyOptions,\r\n  DecryptOptions,\r\n  EncryptOptions,\r\n  HashOptions,\r\n  HashPasswordOptions,\r\n  SecretKey,\r\n  VerifyPasswordOptions,\r\n} from \"~/helpers/types\";\r\nimport { $isPlainObj, $isSecretKey, $isStr, matchEncryptedPattern } from \"~/helpers/validate\";\r\nimport { $convertBytesToStr, $convertStrToBytes, textEncoder } from \"./web-encode\";\r\n\r\nexport function $generateUuid(): Result<string> {\r\n  try {\r\n    return $ok(crypto.randomUUID());\r\n  } catch (error) {\r\n    return $err({ msg: `${title(\"web\", \"UUID Generation\")}: Failed to generate UUID`, desc: $fmtError(error) });\r\n  }\r\n}\r\n\r\nexport async function $createSecretKey(\r\n  secret: string,\r\n  options?: CreateSecretKeyOptions,\r\n): Promise<Result<{ result: SecretKey<\"web\"> }>> {\r\n  if (!$isStr(secret, 8)) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Key Generation\")}: Empty Secret`,\r\n      desc: \"Secret must be a non-empty string with at least 8 characters\",\r\n    });\r\n  }\r\n\r\n  if (!$isPlainObj<CreateSecretKeyOptions>(options)) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Key Generation\")}: Invalid options`,\r\n      desc: \"Options must be an object\",\r\n    });\r\n  }\r\n\r\n  const algorithm = options.algorithm ?? \"aes256gcm\";\r\n  if (!(algorithm in ENCRYPTION_ALGORITHMS)) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Key Generation\")}: Unsupported algorithm: ${algorithm}`,\r\n      desc: `Supported algorithms are: ${Object.keys(ENCRYPTION_ALGORITHMS).join(\", \")}`,\r\n    });\r\n  }\r\n\r\n  const digest = options.digest ?? \"sha256\";\r\n  if (!(digest in DIGEST_ALGORITHMS)) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Key Generation\")}: Unsupported digest: ${digest}`,\r\n      desc: `Supported digests are: ${Object.keys(DIGEST_ALGORITHMS).join(\", \")}`,\r\n    });\r\n  }\r\n\r\n  const salt = options.salt ?? \"cipher-kit-salt\";\r\n  if (!$isStr(salt, 8)) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Key Generation\")}: Weak salt`,\r\n      desc: \"Salt must be a non-empty string with at least 8 characters\",\r\n    });\r\n  }\r\n\r\n  const info = options.info ?? \"cipher-kit\";\r\n  if (!$isStr(info)) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Key Generation\")}: Invalid info`,\r\n      desc: \"Info must be a non-empty string\",\r\n    });\r\n  }\r\n\r\n  const encryptAlgo = ENCRYPTION_ALGORITHMS[algorithm];\r\n  const digestAlgo = DIGEST_ALGORITHMS[digest];\r\n\r\n  try {\r\n    const ikm = await crypto.subtle.importKey(\"raw\", textEncoder.encode(secret.normalize(\"NFKC\")), \"HKDF\", false, [\r\n      \"deriveKey\",\r\n    ]);\r\n    const key = await crypto.subtle.deriveKey(\r\n      {\r\n        name: \"HKDF\",\r\n        hash: digestAlgo.web,\r\n        salt: textEncoder.encode(salt.normalize(\"NFKC\")),\r\n        info: textEncoder.encode(info.normalize(\"NFKC\")),\r\n      },\r\n      ikm,\r\n      { name: encryptAlgo.web, length: encryptAlgo.keyBytes * 8 },\r\n      true,\r\n      [\"encrypt\", \"decrypt\"],\r\n    );\r\n    const secretKey = Object.freeze({\r\n      platform: \"web\",\r\n      digest: digest,\r\n      algorithm: algorithm,\r\n      key: key,\r\n    }) as SecretKey<\"web\">;\r\n\r\n    return $ok({ result: secretKey });\r\n  } catch (error) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Key Generation\")}: Failed to create secret key`,\r\n      desc: $fmtError(error),\r\n    });\r\n  }\r\n}\r\n\r\nexport async function $encrypt(\r\n  data: string,\r\n  secretKey: SecretKey<\"web\">,\r\n  options?: EncryptOptions,\r\n): Promise<Result<string>> {\r\n  if (!$isStr(data)) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Encryption\")}: Empty data for encryption`,\r\n      desc: \"Data must be a non-empty string\",\r\n    });\r\n  }\r\n\r\n  if (!$isPlainObj<EncryptOptions>(options)) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Encryption\")}: Invalid options`,\r\n      desc: \"Options must be an object\",\r\n    });\r\n  }\r\n\r\n  const outputEncoding = options.outputEncoding ?? \"base64url\";\r\n  if (!CIPHER_ENCODING.includes(outputEncoding)) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Encryption\")}: Unsupported output encoding: ${outputEncoding}`,\r\n      desc: \"Use base64, base64url, or hex\",\r\n    });\r\n  }\r\n\r\n  const injectedKey = $isSecretKey(secretKey, \"web\");\r\n  if (!injectedKey) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Encryption\")}: Invalid Secret Key`,\r\n      desc: \"Expected a Web SecretKey\",\r\n    });\r\n  }\r\n\r\n  const { result, error } = $convertStrToBytes(data, \"utf8\");\r\n  if (error) return $err(error);\r\n\r\n  try {\r\n    const iv = crypto.getRandomValues(new Uint8Array(injectedKey.injected.ivLength));\r\n    const cipherWithTag = await crypto.subtle.encrypt(\r\n      { name: injectedKey.injected.web, iv: iv },\r\n      injectedKey.key,\r\n      result,\r\n    );\r\n\r\n    const ivStr = $convertBytesToStr(iv, outputEncoding);\r\n    const cipherStr = $convertBytesToStr(cipherWithTag, outputEncoding);\r\n\r\n    if (ivStr.error || cipherStr.error) {\r\n      return $err({\r\n        msg: `${title(\"web\", \"Encryption\")}: Failed to convert IV or encrypted data`,\r\n        desc: `Conversion error: ${$fmtResultErr(ivStr.error || cipherStr.error)}`,\r\n      });\r\n    }\r\n\r\n    return $ok(`${ivStr.result}.${cipherStr.result}.`);\r\n  } catch (error) {\r\n    return $err({ msg: `${title(\"web\", \"Encryption\")}: Failed to encrypt data`, desc: $fmtError(error) });\r\n  }\r\n}\r\n\r\nexport async function $decrypt(\r\n  encrypted: string,\r\n  secretKey: SecretKey<\"web\">,\r\n  options?: DecryptOptions,\r\n): Promise<Result<string>> {\r\n  if (!matchEncryptedPattern(encrypted, \"web\")) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Decryption\")}: Invalid encrypted data format`,\r\n      desc: 'Encrypted data must be in the format \"iv.cipherWithTag.\"',\r\n    });\r\n  }\r\n\r\n  if (!$isPlainObj<DecryptOptions>(options)) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Decryption\")}: Invalid options`,\r\n      desc: \"Options must be an object\",\r\n    });\r\n  }\r\n\r\n  const inputEncoding = options.inputEncoding ?? \"base64url\";\r\n  if (!CIPHER_ENCODING.includes(inputEncoding)) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Decryption\")}: Unsupported input encoding: ${inputEncoding}`,\r\n      desc: \"Use base64, base64url, or hex\",\r\n    });\r\n  }\r\n\r\n  const [iv, encryptedWithTag] = encrypted.split(\".\", 3);\r\n  if (!$isStr(iv) || !$isStr(encryptedWithTag)) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Decryption\")}: Invalid encrypted data`,\r\n      desc: \"Encrypted data must contain valid IV, encrypted and tag components\",\r\n    });\r\n  }\r\n\r\n  const injectedKey = $isSecretKey(secretKey, \"web\");\r\n  if (!injectedKey) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Decryption\")}: Invalid Secret Key`,\r\n      desc: \"Expected a Web SecretKey\",\r\n    });\r\n  }\r\n\r\n  const ivBytes = $convertStrToBytes(iv, inputEncoding);\r\n  const cipherWithTagBytes = $convertStrToBytes(encryptedWithTag, inputEncoding);\r\n\r\n  if (ivBytes.error || cipherWithTagBytes.error) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Decryption\")}: Failed to convert IV or encrypted data`,\r\n      desc: `Conversion error: ${$fmtResultErr(ivBytes.error || cipherWithTagBytes.error)}`,\r\n    });\r\n  }\r\n\r\n  try {\r\n    const decrypted = await crypto.subtle.decrypt(\r\n      { name: injectedKey.injected.web, iv: ivBytes.result },\r\n      injectedKey.key,\r\n      cipherWithTagBytes.result,\r\n    );\r\n\r\n    return $convertBytesToStr(decrypted, \"utf8\");\r\n  } catch (error) {\r\n    return $err({ msg: `${title(\"web\", \"Decryption\")}: Failed to decrypt data`, desc: $fmtError(error) });\r\n  }\r\n}\r\n\r\nexport async function $encryptObj<T extends object = Record<string, unknown>>(\r\n  data: T,\r\n  secretKey: SecretKey<\"web\">,\r\n  options?: EncryptOptions,\r\n): Promise<Result<string>> {\r\n  const { result, error } = $stringifyObj(data);\r\n  if (error) return $err(error);\r\n  return await $encrypt(result, secretKey, options);\r\n}\r\n\r\nexport async function $decryptObj<T extends object = Record<string, unknown>>(\r\n  encrypted: string,\r\n  secretKey: SecretKey<\"web\">,\r\n  options?: DecryptOptions,\r\n): Promise<Result<{ result: T }>> {\r\n  const { result, error } = await $decrypt(encrypted, secretKey, options);\r\n  if (error) return $err(error);\r\n  return $parseToObj<T>(result);\r\n}\r\n\r\nexport async function $hash(data: string, options?: HashOptions): Promise<Result<string>> {\r\n  if (!$isStr(data)) {\r\n    return $err({ msg: `${title(\"web\", \"Hashing\")}: Empty data for hashing`, desc: \"Data must be a non-empty string\" });\r\n  }\r\n\r\n  if (!$isPlainObj<HashOptions>(options)) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Hashing\")}: Invalid options`,\r\n      desc: \"Options must be an object\",\r\n    });\r\n  }\r\n\r\n  const outputEncoding = options.outputEncoding ?? \"base64url\";\r\n  if (!CIPHER_ENCODING.includes(outputEncoding)) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Hashing\")}: Unsupported output encoding: ${outputEncoding}`,\r\n      desc: \"Use base64, base64url, or hex\",\r\n    });\r\n  }\r\n\r\n  const digest = options.digest ?? \"sha256\";\r\n  if (!(digest in DIGEST_ALGORITHMS)) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Hashing\")}: Unsupported digest: ${digest}`,\r\n      desc: `Supported digests are: ${Object.keys(DIGEST_ALGORITHMS).join(\", \")}`,\r\n    });\r\n  }\r\n  const digestAlgo = DIGEST_ALGORITHMS[digest];\r\n\r\n  const { result, error } = $convertStrToBytes(data, \"utf8\");\r\n  if (error) return $err(error);\r\n\r\n  try {\r\n    const hashed = await crypto.subtle.digest(digestAlgo.web, result);\r\n    return $convertBytesToStr(hashed, outputEncoding);\r\n  } catch (error) {\r\n    return $err({ msg: `${title(\"web\", \"Hashing\")}: Failed to hash data`, desc: $fmtError(error) });\r\n  }\r\n}\r\n\r\nexport async function $hashPassword(\r\n  password: string,\r\n  options?: HashPasswordOptions,\r\n): Promise<Result<{ result: string; salt: string }>> {\r\n  if (!$isStr(password)) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Password Hashing\")}: Empty password`,\r\n      desc: \"Password must be a non-empty string\",\r\n    });\r\n  }\r\n\r\n  if (!$isPlainObj<HashPasswordOptions>(options)) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Password Hashing\")}: Invalid options`,\r\n      desc: \"Options must be an object\",\r\n    });\r\n  }\r\n\r\n  const digest = options.digest ?? \"sha512\";\r\n  if (!(digest in DIGEST_ALGORITHMS)) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Password Hashing\")}: Unsupported digest: ${digest}`,\r\n      desc: `Supported digests are: ${Object.keys(DIGEST_ALGORITHMS).join(\", \")}`,\r\n    });\r\n  }\r\n  const digestAlgo = DIGEST_ALGORITHMS[digest];\r\n\r\n  const outputEncoding = options.outputEncoding ?? \"base64url\";\r\n  if (!CIPHER_ENCODING.includes(outputEncoding)) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Password Hashing\")}: Unsupported output encoding: ${outputEncoding}`,\r\n      desc: \"Use base64, base64url, or hex\",\r\n    });\r\n  }\r\n\r\n  const saltLength = options.saltLength ?? 16;\r\n  if (typeof saltLength !== \"number\" || saltLength < 8) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Password Hashing\")}: Weak salt length`,\r\n      desc: \"Salt length must be a number and at least 8 bytes (recommended 16)\",\r\n    });\r\n  }\r\n\r\n  const iterations = options.iterations ?? 320_000;\r\n  if (typeof iterations !== \"number\" || iterations < 1000) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Password Hashing\")}: Weak iteration count`,\r\n      desc: \"Iterations must be a number and at least 1000 (recommended 320,000 or more)\",\r\n    });\r\n  }\r\n\r\n  const keyLength = options.keyLength ?? 64;\r\n  if (typeof keyLength !== \"number\" || keyLength < 16) {\r\n    return $err({\r\n      msg: `${title(\"web\", \"Password Hashing\")}: Weak key length`,\r\n      desc: \"Key length must be a number and at least 16 bytes (recommended 64)\",\r\n    });\r\n  }\r\n\r\n  try {\r\n    const salt = crypto.getRandomValues(new Uint8Array(saltLength));\r\n    const baseKey = await crypto.subtle.importKey(\r\n      \"raw\",\r\n      textEncoder.encode(password.normalize(\"NFKC\")),\r\n      \"PBKDF2\",\r\n      false,\r\n      [\"deriveBits\"],\r\n    );\r\n    const bits = await crypto.subtle.deriveBits(\r\n      { name: \"PBKDF2\", salt, iterations: iterations, hash: digestAlgo.web },\r\n      baseKey,\r\n      keyLength * 8,\r\n    );\r\n\r\n    const saltStr = $convertBytesToStr(salt, outputEncoding);\r\n    if (saltStr.error) return $err(saltStr.error);\r\n\r\n    const hashedPasswordStr = $convertBytesToStr(bits, outputEncoding);\r\n    if (hashedPasswordStr.error) return $err(hashedPasswordStr.error);\r\n\r\n    return $ok({ result: hashedPasswordStr.result, salt: saltStr.result });\r\n  } catch (error) {\r\n    return $err({ msg: `${title(\"web\", \"Password Hashing\")}: Failed to hash password`, desc: $fmtError(error) });\r\n  }\r\n}\r\n\r\nexport async function $verifyPassword(\r\n  password: string,\r\n  hashedPassword: string,\r\n  salt: string,\r\n  options?: VerifyPasswordOptions,\r\n): Promise<boolean> {\r\n  if (!$isStr(password) || !$isStr(hashedPassword) || !$isStr(salt) || !$isPlainObj<VerifyPasswordOptions>(options)) {\r\n    return false;\r\n  }\r\n\r\n  const digest = options.digest ?? \"sha512\";\r\n  if (!(digest in DIGEST_ALGORITHMS)) return false;\r\n  const digestAlgo = DIGEST_ALGORITHMS[digest];\r\n\r\n  const inputEncoding = options.inputEncoding ?? \"base64url\";\r\n  if (!CIPHER_ENCODING.includes(inputEncoding)) return false;\r\n\r\n  const iterations = options.iterations ?? 320_000;\r\n  if (typeof iterations !== \"number\" || iterations < 1000) return false;\r\n\r\n  const keyLength = options.keyLength ?? 64;\r\n  if (typeof keyLength !== \"number\" || keyLength < 16) return false;\r\n\r\n  const saltBytes = $convertStrToBytes(salt, inputEncoding);\r\n  if (saltBytes.error) return false;\r\n\r\n  const hashedPasswordBytes = $convertStrToBytes(hashedPassword, inputEncoding);\r\n  if (hashedPasswordBytes.error) return false;\r\n\r\n  try {\r\n    const baseKey = await crypto.subtle.importKey(\r\n      \"raw\",\r\n      textEncoder.encode(password.normalize(\"NFKC\")),\r\n      \"PBKDF2\",\r\n      false,\r\n      [\"deriveBits\"],\r\n    );\r\n\r\n    const bits = new Uint8Array(\r\n      await crypto.subtle.deriveBits(\r\n        {\r\n          name: \"PBKDF2\",\r\n          salt: saltBytes.result,\r\n          iterations: iterations,\r\n          hash: digestAlgo.web,\r\n        },\r\n        baseKey,\r\n        keyLength * 8,\r\n      ),\r\n    );\r\n\r\n    if (bits === undefined || hashedPasswordBytes.result === undefined) return false;\r\n    if (bits.length !== hashedPasswordBytes.result.length) return false;\r\n\r\n    let diff = 0;\r\n    for (let i = 0; i < bits.length; i++) {\r\n      diff |= (bits[i] as number) ^ (hashedPasswordBytes.result[i] as number);\r\n    }\r\n    return diff === 0;\r\n  } catch {\r\n    return false;\r\n  }\r\n}\r\n"]}

package/dist/{export-BMvZq46v.d.ts → export-5hmOiU0J.d.cts}

@@ -1,4 +1,4 @@
-import { S as SecretKey, R as Result, d as CreateSecretKeyOptions, e as EncryptOptions, f as DecryptOptions, H as HashOptions, g as HashPasswordOptions, V as VerifyPasswordOptions, b as Encoding } from './validate-EHuJC5QQ.js';
+import { S as SecretKey, R as Result, d as CreateSecretKeyOptions, e as EncryptOptions, f as DecryptOptions, H as HashOptions, g as HashPasswordOptions, V as VerifyPasswordOptions, b as Encoding } from './validate-B3uHoP8n.cjs';
 import { Buffer } from 'node:buffer';
 
 /**
@@ -9,6 +9,13 @@ import { Buffer } from 'node:buffer';
  *
  * @param x - The value to check.
  * @returns True if the value is a SecretKey object for Node.js, false otherwise.
+ *
+ * @example
+ * ```ts
+ * isNodeSecretKey(nodeKey); // true
+ * isNodeSecretKey(webKey);  // false
+ * isNodeSecretKey({}); // false
+ * ```
  */
 declare function isNodeSecretKey(x: unknown): x is SecretKey<"node">;
 /**
@@ -19,6 +26,14 @@ declare function isNodeSecretKey(x: unknown): x is SecretKey<"node">;
  * The chance of two pets getting the same name tag is practically zero, and it's very hard to guess!
  *
  * @returns A `Result` containing the UUID string or an error.
+ *
+ * @example
+ * ```ts
+ * const {result, error, success} = tryGenerateUuid();
+ *
+ * if (success) console.log(result); // "..." (a UUID string)
+ * else console.error(error); // { message: "...", description: "..." }
+ * ```
  */
 declare function tryGenerateUuid(): Result<string>;
 /**
@@ -30,6 +45,11 @@ declare function tryGenerateUuid(): Result<string>;
  *
  * @returns A UUID string.
  * @throws {Error} If UUID generation fails.
+ *
+ * @example
+ * ```ts
+ * const uuid = generateUuid(); // "..." (a UUID string)
+ * ```
  */
 declare function generateUuid(): string;
 /**
@@ -41,12 +61,20 @@ declare function generateUuid(): string;
  * Imagine you want to create a special key for future use to lock your treasure box (data).
  * So, you stir in some secret ingredients (like salt and info) to make sure your key is one-of-a-kind.
  *
- * @param secret - The input string to derive the `SecretKey` from.
+ * @param secret - The input string to derive the `SecretKey` from, must be at least 8 characters.
  * @param options.algorithm - The encryption algorithm to use (default: `'aes256gcm'`).
  * @param options.digest - The hash algorithm for HKDF (default: `'sha256'`).
  * @param options.salt - A salt string (default: `'cipher-kit-salt'`, must be ≥ 8 chars).
  * @param options.info - An info string (default: `'cipher-kit'`).
  * @returns A `Result` containing the derived `SecretKey` or an error.
+ *
+ * @example
+ * ```ts
+ * const {result, error, success} = tryCreateSecretKey("my-secret");
+ *
+ * if (success) console.log(result); // SecretKey object
+ * else console.error(error); // { message: "...", description: "..." }
+ * ```
  */
 declare function tryCreateSecretKey(secret: string, options?: CreateSecretKeyOptions): Result<{
     result: SecretKey<"node">;
@@ -60,13 +88,18 @@ declare function tryCreateSecretKey(secret: string, options?: CreateSecretKeyOpt
  * Imagine you want to create a special key for future use to lock your treasure box (data).
  * So, you stir in some secret ingredients (like salt and info) to make sure your key is one-of-a-kind.
  *
- * @param secret - The input string to derive the `SecretKey` from.
+ * @param secret - The input string to derive the `SecretKey` from, must be at least 8 characters.
  * @param options.algorithm - The encryption algorithm to use (default: `'aes256gcm'`).
  * @param options.digest - The hash algorithm for HKDF (default: `'sha256'`).
  * @param options.salt - A salt string (default: `'cipher-kit-salt'`, must be ≥ 8 chars).
  * @param options.info - An info string (default: `'cipher-kit'`).
  * @returns The derived `SecretKey`.
  * @throws {Error} If key derivation fails.
+ *
+ * @example
+ * ```ts
+ * const secretKey = createSecretKey("my-secret"); // SecretKey object
+ * ```
  */
 declare function createSecretKey(secret: string, options?: CreateSecretKeyOptions): SecretKey<"node">;
 /**
@@ -80,8 +113,17 @@ declare function createSecretKey(secret: string, options?: CreateSecretKeyOption
  *
  * @param data - A UTF-8 string to encrypt.
  * @param secretKey - The `SecretKey` object used for encryption.
- * @param options.encoding - The encoding format for the output ciphertext (default: `'base64url'`).
+ * @param options.outputEncoding - The encoding format for the output ciphertext (default: `'base64url'`).
  * @returns A `Result` containing the encrypted string in the specified format or an error.
+ *
+ * @example
+ * ```ts
+ * const secretKey = createSecretKey("my-secret");
+ * const {result, error, success} = tryEncrypt("Hello, World!", secretKey);
+ *
+ * if (success) console.log(result); // "iv.cipher.tag." (Encrypted string)
+ * else console.error(error); // { message: "...", description: "..." }
+ * ```
  */
 declare function tryEncrypt(data: string, secretKey: SecretKey<"node">, options?: EncryptOptions): Result<string>;
 /**
@@ -95,9 +137,15 @@ declare function tryEncrypt(data: string, secretKey: SecretKey<"node">, options?
  *
  * @param data - A UTF-8 string to encrypt.
  * @param secretKey - The `SecretKey` object used for encryption.
- * @param options.encoding - The encoding format for the output ciphertext (default: `'base64url'`).
+ * @param options.outputEncoding - The encoding format for the output ciphertext (default: `'base64url'`).
  * @returns The encrypted string in the specified format.
  * @throws {Error} If the input data or key is invalid, or if encryption fails.
+ *
+ * @example
+ * ```ts
+ * const secretKey = createSecretKey("my-secret");
+ * const encrypted = encrypt("Hello, World!", secretKey); // "iv.cipher.tag." (Encrypted string)
+ * ```
  */
 declare function encrypt(data: string, secretKey: SecretKey<"node">, options?: EncryptOptions): string;
 /**
@@ -111,8 +159,18 @@ declare function encrypt(data: string, secretKey: SecretKey<"node">, options?: E
  *
  * @param encrypted - The input string to decrypt, in the format "iv.cipher.tag.".
  * @param secretKey - The `SecretKey` object used for decryption.
- * @param options.encoding - The encoding format for the input ciphertext (default: `'base64url'`).
+ * @param options.inputEncoding - The encoding format for the input ciphertext (default: `'base64url'`).
  * @returns A `Result` containing the decrypted UTF-8 string or an error.
+ *
+ * @example
+ * ```ts
+ * const secretKey = createSecretKey("my-secret");
+ * const encrypted = encrypt("Hello, World!", secretKey);
+ * const {result, error, success} = tryDecrypt(encrypted, secretKey);
+ *
+ * if (success) console.log(result); // "Hello, World!" (Decrypted string)
+ * else console.error(error); // { message: "...", description: "..." }
+ * ```
  */
 declare function tryDecrypt(encrypted: string, secretKey: SecretKey<"node">, options?: DecryptOptions): Result<string>;
 /**
@@ -126,9 +184,16 @@ declare function tryDecrypt(encrypted: string, secretKey: SecretKey<"node">, opt
  *
  * @param encrypted - The input string to decrypt, in the format "iv.cipher.tag.".
  * @param secretKey - The `SecretKey` object used for decryption.
- * @param options.encoding - The encoding format for the input ciphertext (default: `'base64url'`).
+ * @param options.inputEncoding - The encoding format for the input ciphertext (default: `'base64url'`).
  * @returns The decrypted UTF-8 string.
  * @throws {Error} If the input data or key is invalid, or if decryption fails.
+ *
+ * @example
+ * ```ts
+ * const secretKey = createSecretKey("my-secret");
+ * const encrypted = encrypt("Hello, World!", secretKey);
+ * const decrypted = decrypt(encrypted, secretKey); // "Hello, World!" (Decrypted string)
+ * ```
  */
 declare function decrypt(encrypted: string, secretKey: SecretKey<"node">, options?: DecryptOptions): string;
 /**
@@ -143,10 +208,20 @@ declare function decrypt(encrypted: string, secretKey: SecretKey<"node">, option
  * So, you take a picture of your toy box (convert it to JSON), and scramble that with
  * your special key, creating a jumbled code that only someone with the right key can read.
  *
+ * @template T - The type of the plain object to encrypt.
  * @param data - A plain object to encrypt.
  * @param secretKey - The `SecretKey` object used for encryption.
- * @param options.encoding - The encoding format for the output ciphertext (default: `'base64url'`).
+ * @param options.outputEncoding - The encoding format for the output ciphertext (default: `'base64url'`).
  * @returns A `Result` containing the encrypted string in the specified format or an error.
+ *
+ * @example
+ * ```ts
+ * const secretKey = createSecretKey("my-secret");
+ * const {result, error, success} = tryEncryptObj({ a: 1 }, secretKey);
+ *
+ * if (success) console.log(result); // "iv.cipher.tag." (Encrypted string)
+ * else console.error(error); // { message: "...", description: "..." }
+ * ```
  */
 declare function tryEncryptObj<T extends object = Record<string, unknown>>(data: T, secretKey: SecretKey<"node">, options?: EncryptOptions): Result<string>;
 /**
@@ -161,11 +236,18 @@ declare function tryEncryptObj<T extends object = Record<string, unknown>>(data:
  * So, you take a picture of your toy box (convert it to JSON), and scramble that with
  * your special key, creating a jumbled code that only someone with the right key can read.
  *
+ * @template T - The type of the plain object to encrypt.
  * @param data - A plain object to encrypt.
  * @param secretKey - The `SecretKey` object used for encryption.
- * @param options.encoding - The encoding format for the output ciphertext (default: `'base64url'`).
+ * @param options.outputEncoding - The encoding format for the output ciphertext (default: `'base64url'`).
  * @returns The encrypted string in the specified format.
  * @throws {Error} If the input data or key is invalid, or if encryption fails.
+ *
+ * @example
+ * ```ts
+ * const secretKey = createSecretKey("my-secret");
+ * const encrypted = encryptObj({ a: 1 }, secretKey); // "iv.cipher.tag." (Encrypted string)
+ * ```
  */
 declare function encryptObj<T extends object = Record<string, unknown>>(data: T, secretKey: SecretKey<"node">, options?: EncryptOptions): string;
 /**
@@ -180,8 +262,18 @@ declare function encryptObj<T extends object = Record<string, unknown>>(data: T,
  * @template T - The expected shape of the decrypted object.
  * @param encrypted - The encrypted string (format: `"iv.cipher.tag."`).
  * @param secretKey - The `SecretKey` used for decryption.
- * @param options.encoding - Input ciphertext encoding (default: `'base64url'`).
+ * @param options.inputEncoding - Input ciphertext encoding (default: `'base64url'`).
  * @returns A `Result` with the decrypted object on success, or an error.
+ *
+ * @example
+ * ```ts
+ * const secretKey = createSecretKey("my-secret");
+ * const encrypted = encryptObj({ a: 1 }, secretKey);
+ * const {result, error, success} = tryDecryptObj<{ a: number }>(encrypted, secretKey);
+ *
+ * if (success) console.log(result); // { a: 1 } (Decrypted object)
+ * else console.error(error); // { message: "...", description: "..." }
+ * ```
  */
 declare function tryDecryptObj<T extends object = Record<string, unknown>>(encrypted: string, secretKey: SecretKey<"node">, options?: DecryptOptions): Result<{
     result: T;
@@ -198,9 +290,16 @@ declare function tryDecryptObj<T extends object = Record<string, unknown>>(encry
  * @template T - The expected shape of the decrypted object.
  * @param encrypted - The encrypted string (format: `"iv.cipher.tag."`).
  * @param secretKey - The `SecretKey` used for decryption.
- * @param options.encoding - Input ciphertext encoding (default: `'base64url'`).
+ * @param options.inputEncoding - Input ciphertext encoding (default: `'base64url'`).
  * @returns The decrypted object.
  * @throws {Error} If decryption or JSON parsing fails.
+ *
+ * @example
+ * ```ts
+ * const secretKey = createSecretKey("my-secret");
+ * const encrypted = encryptObj({ a: 1 }, secretKey);
+ * const obj = decryptObj<{ a: number }>(encrypted, secretKey); // obj.a === 1
+ * ```
  */
 declare function decryptObj<T extends object = Record<string, unknown>>(encrypted: string, secretKey: SecretKey<"node">, options?: DecryptOptions): T;
 /**
@@ -215,8 +314,16 @@ declare function decryptObj<T extends object = Record<string, unknown>>(encrypte
  *
  * @param data - The input string to hash.
  * @param options.digest - Hash algorithm (`'sha256' | 'sha384' | 'sha512'`, default: `'sha256'`).
- * @param options.encoding - Output encoding (`'base64' | 'base64url' | 'hex'`, default: `'base64url'`).
+ * @param options.outputEncoding - Output encoding (`'base64' | 'base64url' | 'hex'`, default: `'base64url'`).
  * @returns A `Result` with the hash string or an error.
+ *
+ * @example
+ * ```ts
+ * const {result, error, success} = tryHash("my data");
+ *
+ * if (success) console.log(result); // "..." (Hashed string)
+ * else console.error(error); // { message: "...", description: "..." }
+ * ```
  */
 declare function tryHash(data: string, options?: HashOptions): Result<string>;
 /**
@@ -231,9 +338,14 @@ declare function tryHash(data: string, options?: HashOptions): Result<string>;
  *
  * @param data - The input string to hash.
  * @param options.digest - Hash algorithm (`'sha256' | 'sha384' | 'sha512'`; default: `'sha256'`).
- * @param options.encoding - Output encoding (`'base64' | 'base64url' | 'hex'`; default: `'base64url'`).
+ * @param options.outputEncoding - Output encoding (`'base64' | 'base64url' | 'hex'`; default: `'base64url'`).
  * @returns The hashed string.
  * @throws {Error} If input is invalid or hashing fails.
+ *
+ * @example
+ * ```ts
+ * const hash = hash("my data"); // "..." (Hashed string)
+ * ```
  */
 declare function hash(data: string, options?: HashOptions): string;
 /**
@@ -248,14 +360,22 @@ declare function hash(data: string, options?: HashOptions): string;
  *
  * @param password - The password to hash.
  * @param options.digest - Hash algorithm (`'sha256' | 'sha384' | 'sha512'`; default: `'sha512'`).
- * @param options.encoding - Output encoding (`'base64' | 'base64url' | 'hex'`; default: `'base64url'`).
+ * @param options.outputEncoding - Output encoding (`'base64' | 'base64url' | 'hex'`; default: `'base64url'`).
  * @param options.saltLength - Length of the random salt in bytes (default: `16` bytes, min: `8` bytes).
  * @param options.iterations - Number of iterations (default: `320000`, min: `1000`).
  * @param options.keyLength - Length of the derived key in bytes (default: `64` bytes, min: `16` bytes).
- * @returns A `Result` with `{ hash, salt }` or an error.
+ * @returns A `Result` with `{ result, salt }` or an error.
+ *
+ * @example
+ * ```ts
+ * const {result, salt, error, success} = tryHashPassword("my-password");
+ *
+ * if (success) console.log(result, salt); // "..." (Hashed password string), "..." (salt)
+ * else console.error(error); // { message: "...", description: "..." }
+ * ```
  */
 declare function tryHashPassword(password: string, options?: HashPasswordOptions): Result<{
-    hash: string;
+    result: string;
     salt: string;
 }>;
 /**
@@ -270,15 +390,20 @@ declare function tryHashPassword(password: string, options?: HashPasswordOptions
  *
  * @param password - The password to hash.
  * @param options.digest - Hash algorithm (`'sha256' | 'sha384' | 'sha512'`; default: `'sha512'`).
- * @param options.encoding - Output encoding (`'base64' | 'base64url' | 'hex'`; default: `'base64url'`).
+ * @param options.outputEncoding - Output encoding (`'base64' | 'base64url' | 'hex'`; default: `'base64url'`).
  * @param options.saltLength - Length of the random salt in bytes (default: `16` bytes, min: `8` bytes).
  * @param options.iterations - Number of iterations (default: `320000`, min: `1000`).
  * @param options.keyLength - Length of the derived key in bytes (default: `64` bytes, min: `16` bytes).
- * @returns `{ hash, salt }` for storage.
+ * @returns `{ result, salt }` for storage.
  * @throws {Error} If inputs are invalid or hashing fails.
+ *
+ * @example
+ * ```ts
+ * const { result, salt } = hashPassword("my-password"); // "..." (Hashed password string), "..." (salt)
+ * ```
  */
 declare function hashPassword(password: string, options?: HashPasswordOptions): {
-    hash: string;
+    result: string;
     salt: string;
 };
 /**
@@ -294,10 +419,18 @@ declare function hashPassword(password: string, options?: HashPasswordOptions):
  * @param hashedPassword - The stored hash (encoded).
  * @param salt - The stored salt (encoded).
  * @param options.digest - Hash algorithm used during hashing (`'sha256' | 'sha384' | 'sha512'`; default: `'sha512'`).
- * @param options.encoding - Encoding of the stored hash and salt (`'base64' | 'base64url' | 'hex'`; default: `'base64url'`).
+ * @param options.inputEncoding - Encoding of the stored hash and salt (`'base64' | 'base64url' | 'hex'`; default: `'base64url'`).
  * @param options.iterations - Number of iterations used during hashing (default: `320000`).
  * @param options.keyLength - Length of the derived key in bytes used during hashing (default: `64` bytes).
  * @returns `true` if the password matches, otherwise `false`.
+ *
+ * @example
+ * ```ts
+ * const { result, salt } = hashPassword("my-password");
+ *
+ * verifyPassword("my-password", result, salt); // true
+ * verifyPassword("wrong-password", result, salt); // false
+ * ```
  */
 declare function verifyPassword(password: string, hashedPassword: string, salt: string, options?: VerifyPasswordOptions): boolean;
 /**
@@ -311,6 +444,14 @@ declare function verifyPassword(password: string, hashedPassword: string, salt:
  * @param data - The input string to convert.
  * @param inputEncoding - The encoding of the input string (default: `'utf8'`).
  * @returns A `Result` with `{ result: Buffer }` or an error.
+ *
+ * @example
+ * ```ts
+ * const {result, error, success} = tryConvertStrToBytes("Hello", "utf8");
+ *
+ * if (success) console.log(result); // <Buffer ...>
+ * else console.error(error); // { message: "...", description: "..." }
+ * ```
  */
 declare function tryConvertStrToBytes(data: string, inputEncoding?: Encoding): Result<{
     result: Buffer;
@@ -327,6 +468,11 @@ declare function tryConvertStrToBytes(data: string, inputEncoding?: Encoding): R
  * @param inputEncoding - The encoding of the input string (default: `'utf8'`).
  * @returns A `Buffer` containing the bytes.
  * @throws {Error} If input is invalid or conversion fails.
+ *
+ * @example
+ * ```ts
+ * const bytes = convertStrToBytes("Hello", "utf8"); // <Buffer ...>
+ * ```
  */
 declare function convertStrToBytes(data: string, inputEncoding?: Encoding): Buffer;
 /**
@@ -340,6 +486,15 @@ declare function convertStrToBytes(data: string, inputEncoding?: Encoding): Buff
  * @param data - The `Buffer` to convert.
  * @param outputEncoding - The output encoding (default: `'utf8'`).
  * @returns A `Result` with the string or an error.
+ *
+ * @example
+ * ```ts
+ * const bytes = convertStrToBytes("Hello", "utf8"); // <Buffer ...>
+ * const {result, error, success} = tryConvertBytesToStr(bytes, "utf8");
+ *
+ * if (success) console.log(result); // "Hello"
+ * else console.error(error); // { message: "...", description: "..." }
+ * ```
  */
 declare function tryConvertBytesToStr(data: Buffer, outputEncoding?: Encoding): Result<string>;
 /**
@@ -354,6 +509,12 @@ declare function tryConvertBytesToStr(data: Buffer, outputEncoding?: Encoding):
  * @param outputEncoding - The output encoding (default: `'utf8'`).
  * @returns The encoded string.
  * @throws {Error} If input is invalid or conversion fails.
+ *
+ * @example
+ * ```ts
+ * const bytes = convertStrToBytes("Hello", "utf8"); // <Buffer ...>
+ * const str = convertBytesToStr(bytes, "utf8"); // "Hello"
+ * ```
  */
 declare function convertBytesToStr(data: Buffer, outputEncoding?: Encoding): string;
 /**
@@ -368,6 +529,14 @@ declare function convertBytesToStr(data: Buffer, outputEncoding?: Encoding): str
  * @param from - The current encoding of `data`.
  * @param to - The target encoding for `data`.
  * @returns A `Result` with a string or an error.
+ *
+ * @example
+ * ```ts
+ * const {result, error, success} = tryConvertEncoding("Hello", "utf8", "base64url");
+ *
+ * if (success) console.log(result); // "..." (Base64url encoded string)
+ * else console.error(error); // { message: "...", description: "..." }
+ * ```
  */
 declare function tryConvertEncoding(data: string, from: Encoding, to: Encoding): Result<string>;
 /**
@@ -383,6 +552,11 @@ declare function tryConvertEncoding(data: string, from: Encoding, to: Encoding):
  * @param to - The target encoding for `data`.
  * @returns The converted string.
  * @throws {Error} If encodings are invalid or conversion fails.
+ *
+ * @example
+ * ```ts
+ * const encoded = convertEncoding("Hello", "utf8", "base64url"); // "..." (Base64url encoded string)
+ * ```
  */
 declare function convertEncoding(data: string, from: Encoding, to: Encoding): string;