cipher-kit 2.0.0-beta.1 → 2.0.0-beta.3

package/dist/{export-oVEmcDLI.d.cts → export-CPUbAFZA.d.ts}

@@ -1,4 +1,4 @@
-import { R as Result, c as ENCRYPTION_ALGORITHMS, D as DIGEST_ALGORITHMS, S as SecretKey, b as EncodingFormat } from './validate-TRx4DDtg.cjs';
+import { R as Result, d as CreateSecretKeyOptions, S as SecretKey, e as EncryptOptions, f as DecryptOptions, H as HashOptions, g as HashPasswordOptions, V as VerifyPasswordOptions, b as Encoding } from './validate-CULVlPck.js';
 import { Buffer } from 'node:buffer';
 
 /**
@@ -21,12 +21,7 @@ declare function generateUuid(): string;
  * @param secret - The input string to derive the secret key from.
  * @returns A Result containing a SecretKey object representing the derived secret key or an error.
  */
-declare function tryCreateSecretKey(secret: string, options?: {
-    algorithm?: keyof typeof ENCRYPTION_ALGORITHMS;
-    digest?: keyof typeof DIGEST_ALGORITHMS;
-    salt?: string;
-    info?: string;
-}): Result<{
+declare function tryCreateSecretKey(secret: string, options?: CreateSecretKeyOptions): Result<{
     result: SecretKey<'node'>;
 }>;
 /**
@@ -37,12 +32,7 @@ declare function tryCreateSecretKey(secret: string, options?: {
  * @returns A SecretKey object representing the derived secret key.
  * @throws {Error} If the input key is invalid or key generation fails.
  */
-declare function createSecretKey(secret: string, options?: {
-    algorithm?: keyof typeof ENCRYPTION_ALGORITHMS;
-    digest?: keyof typeof DIGEST_ALGORITHMS;
-    salt?: string;
-    info?: string;
-}): SecretKey<'node'>;
+declare function createSecretKey(secret: string, options?: CreateSecretKeyOptions): SecretKey<'node'>;
 /**
  * Encrypts the input string using the provided secret key.
  * The output is a string in the format "iv.cipher.tag." where each component is base64url encoded.
@@ -51,7 +41,7 @@ declare function createSecretKey(secret: string, options?: {
  * @param secretKey - The SecretKey object used for encryption.
  * @returns A Result containing a string representing the encrypted data in the specified format or an error.
  */
-declare function tryEncrypt(data: string, secretKey: SecretKey<'node'>): Result<string>;
+declare function tryEncrypt(data: string, secretKey: SecretKey<'node'>, options?: EncryptOptions): Result<string>;
 /**
  * Encrypts the input string using the provided secret key.
  * The output is a string in the format "iv.cipher.tag." where each component is base64url encoded.
@@ -61,7 +51,7 @@ declare function tryEncrypt(data: string, secretKey: SecretKey<'node'>): Result<
  * @returns A string representing the encrypted data in the specified format.
  * @throws {Error} If the input data or key is invalid, or if encryption fails.
  */
-declare function encrypt(data: string, secretKey: SecretKey<'node'>): string;
+declare function encrypt(data: string, secretKey: SecretKey<'node'>, options?: EncryptOptions): string;
 /**
  * Decrypts the input string using the provided secret key.
  * The input must be in the format "iv.cipher.tag." where each component is base64url encoded.
@@ -70,7 +60,7 @@ declare function encrypt(data: string, secretKey: SecretKey<'node'>): string;
  * @param secretKey - The SecretKey object used for decryption.
  * @returns A Result containing a string representing the decrypted data or an error.
  */
-declare function tryDecrypt(encrypted: string, secretKey: SecretKey<'node'>): Result<string>;
+declare function tryDecrypt(encrypted: string, secretKey: SecretKey<'node'>, options?: DecryptOptions): Result<string>;
 /**
  * Decrypts the input string using the provided secret key.
  * The input must be in the format "iv.cipher.tag." where each component is base64url encoded.
@@ -80,7 +70,7 @@ declare function tryDecrypt(encrypted: string, secretKey: SecretKey<'node'>): Re
  * @returns A string representing the decrypted data.
  * @throws {Error} If the input data or key is invalid, or if decryption fails.
  */
-declare function decrypt(encrypted: string, secretKey: SecretKey<'node'>): string;
+declare function decrypt(encrypted: string, secretKey: SecretKey<'node'>, options?: DecryptOptions): string;
 /**
  * Encrypts the input object using the provided secret key.
  * The object is first serialized to a JSON string before encryption.
@@ -90,7 +80,7 @@ declare function decrypt(encrypted: string, secretKey: SecretKey<'node'>): strin
  * @param secretKey - The SecretKey object used for encryption.
  * @returns A Result containing a string representing the encrypted object in the specified format or an error.
  */
-declare function tryEncryptObj<T extends object = Record<string, unknown>>(data: T, secretKey: SecretKey<'node'>): Result<string>;
+declare function tryEncryptObj<T extends object = Record<string, unknown>>(data: T, secretKey: SecretKey<'node'>, options?: EncryptOptions): Result<string>;
 /**
  * Encrypts the input object using the provided secret key.
  * The object is first serialized to a JSON string before encryption.
@@ -101,7 +91,7 @@ declare function tryEncryptObj<T extends object = Record<string, unknown>>(data:
  * @returns A string representing the encrypted object in the specified format.
  * @throws {Error} If the input data or key is invalid, or if encryption fails.
  */
-declare function encryptObj<T extends object = Record<string, unknown>>(data: T, secretKey: SecretKey<'node'>): string;
+declare function encryptObj<T extends object = Record<string, unknown>>(data: T, secretKey: SecretKey<'node'>, options?: EncryptOptions): string;
 /**
  * Decrypts the input string to an object using the provided secret key.
  * The input must be in the format "iv.cipher.tag." where each component is base64url encoded.
@@ -111,7 +101,7 @@ declare function encryptObj<T extends object = Record<string, unknown>>(data: T,
  * @param secretKey - The SecretKey object used for decryption.
  * @returns A Result containing an object representing the decrypted data or an error.
  */
-declare function tryDecryptObj<T extends object = Record<string, unknown>>(encrypted: string, secretKey: SecretKey<'node'>): Result<{
+declare function tryDecryptObj<T extends object = Record<string, unknown>>(encrypted: string, secretKey: SecretKey<'node'>, options?: DecryptOptions): Result<{
     result: T;
 }>;
 /**
@@ -124,16 +114,14 @@ declare function tryDecryptObj<T extends object = Record<string, unknown>>(encry
  * @returns An object representing the decrypted data.
  * @throws {Error} If the input data or key is invalid, or if decryption fails.
  */
-declare function decryptObj<T extends object = Record<string, unknown>>(encrypted: string, secretKey: SecretKey<'node'>): {
-    result: T;
-};
+declare function decryptObj<T extends object = Record<string, unknown>>(encrypted: string, secretKey: SecretKey<'node'>, options?: DecryptOptions): T;
 /**
  * Hashes the input string using SHA-256 and returns the hash in base64url format.
  *
  * @param data - The input string to hash.
  * @returns A Result containing a string representing the SHA-256 hash in base64url format or an error.
  */
-declare function tryHash(data: string): Result<string>;
+declare function tryHash(data: string, options?: HashOptions): Result<string>;
 /**
  * Hashes the input string using SHA-256 and returns the hash in base64url format.
  *
@@ -141,14 +129,31 @@ declare function tryHash(data: string): Result<string>;
  * @returns A string representing the SHA-256 hash in base64url format.
  * @throws {Error} If the input data is invalid or hashing fails.
  */
-declare function hash(data: string): string;
+declare function hash(data: string, options?: HashOptions): string;
+/**
+ * Hashes the input object by first serializing it to a JSON string using stable key ordering,
+ * then hashing the string using SHA-256 and returning the hash in base64url format.
+ *
+ * @param data - The input object to hash.
+ * @returns A Result containing a string representing the SHA-256 hash of the serialized object in base64url format or an error.
+ * */
+declare function tryHashObj<T extends object = Record<string, unknown>>(data: T, options?: HashOptions): Result<string>;
+/**
+ * Hashes the input object by first serializing it to a JSON string using stable key ordering,
+ * then hashing the string using SHA-256 and returning the hash in base64url format.
+ *
+ * @param data - The input object to hash.
+ * @returns A string representing the SHA-256 hash of the serialized object in base64url format.
+ * @throws {Error} If the input data is invalid or hashing fails.
+ */
+declare function hashObj<T extends object = Record<string, unknown>>(data: T, options?: HashOptions): string;
 /**
  * Hashes a password using PBKDF2 with SHA-512.
  *
  * @param password - The password to hash.
  * @returns A Result containing an object with the hash and salt, or an error.
  */
-declare function tryHashPassword(password: string): Result<{
+declare function tryHashPassword(password: string, options?: HashPasswordOptions): Result<{
     hash: string;
     salt: string;
 }>;
@@ -159,7 +164,7 @@ declare function tryHashPassword(password: string): Result<{
  * @returns An object with the hash and salt.
  * @throws {Error} If the input password is invalid or hashing fails.
  */
-declare function hashPassword(password: string): {
+declare function hashPassword(password: string, options?: HashPasswordOptions): {
     hash: string;
     salt: string;
 };
@@ -171,16 +176,16 @@ declare function hashPassword(password: string): {
  * @param salt - The salt used during hashing (in base64url format).
  * @returns A boolean indicating whether the password matches the hashed password.
  */
-declare function verifyPassword(password: string, hashedPassword: string, salt: string): boolean;
+declare function verifyPassword(password: string, hashedPassword: string, salt: string, options?: VerifyPasswordOptions): boolean;
 /**
  * Converts a string to a Buffer (byte array) using the specified encoding format.
  * Supported formats: 'base64', 'base64url', 'hex', 'utf8', 'latin1'.
  *
  * @param data - The input string to convert.
- * @param format - The encoding format to use (default is 'utf8').
+ * @param inputEncoding - The encoding format to use (default is 'utf8').
  * @returns A Result containing a Node.js Buffer with the encoded data or an error.
  */
-declare function tryConvertStrToBytes(data: string, format?: EncodingFormat): Result<{
+declare function tryConvertStrToBytes(data: string, inputEncoding?: Encoding): Result<{
     result: Buffer;
 }>;
 /**
@@ -188,30 +193,30 @@ declare function tryConvertStrToBytes(data: string, format?: EncodingFormat): Re
  * Supported formats: 'base64', 'base64url', 'hex', 'utf8', 'latin1'.
  *
  * @param data - The input string to convert.
- * @param format - The encoding format to use (default is 'utf8').
+ * @param inputEncoding - The encoding format to use (default is 'utf8').
  * @returns A Node.js Buffer containing the encoded data.
  * @throws {Error} If the input data is invalid or conversion fails.
  */
-declare function convertStrToBytes(data: string, format?: EncodingFormat): Buffer;
+declare function convertStrToBytes(data: string, inputEncoding?: Encoding): Buffer;
 /**
  * Converts a Buffer (byte array) to a string using the specified encoding format.
  * Supported formats: 'base64', 'base64url', 'hex', 'utf8', 'latin1'.
  *
  * @param data - The input Buffer to convert.
- * @param format - The encoding format to use (default is 'utf8').
+ * @param outputEncoding - The encoding format to use (default is 'utf8').
  * @returns A Result containing the string representation of the Buffer or an error.
  */
-declare function tryConvertBytesToStr(data: Buffer, format?: EncodingFormat): Result<string>;
+declare function tryConvertBytesToStr(data: Buffer, outputEncoding?: Encoding): Result<string>;
 /**
  * Converts a Buffer (byte array) to a string using the specified encoding format.
  * Supported formats: 'base64', 'base64url', 'hex', 'utf8', 'latin1'.
  *
  * @param data - The input Buffer to convert.
- * @param format - The encoding format to use (default is 'utf8').
+ * @param outputEncoding - The encoding format to use (default is 'utf8').
  * @returns A string representation of the Buffer in the specified format.
  * @throws {Error} If the input data is invalid or conversion fails.
  */
-declare function convertBytesToStr(data: Buffer, format?: EncodingFormat): string;
+declare function convertBytesToStr(data: Buffer, outputEncoding?: Encoding): string;
 /**
  * Convert data from one encoding format to another.
  *
@@ -220,7 +225,7 @@ declare function convertBytesToStr(data: Buffer, format?: EncodingFormat): strin
  * @param to - The encoding format to convert to.
  * @returns A Result containing the converted string or an error.
  */
-declare function tryConvertFormat(data: string, from: EncodingFormat, to: EncodingFormat): Result<{
+declare function tryConvertEncoding(data: string, from: Encoding, to: Encoding): Result<{
     result: string;
 }>;
 /**
@@ -232,10 +237,10 @@ declare function tryConvertFormat(data: string, from: EncodingFormat, to: Encodi
  * @returns A converted string.
  * @throws {Error} If the input data is invalid or conversion fails.
  */
-declare function convertFormat(data: string, from: EncodingFormat, to: EncodingFormat): string;
+declare function convertEncoding(data: string, from: Encoding, to: Encoding): string;
 
 declare const kit_convertBytesToStr: typeof convertBytesToStr;
-declare const kit_convertFormat: typeof convertFormat;
+declare const kit_convertEncoding: typeof convertEncoding;
 declare const kit_convertStrToBytes: typeof convertStrToBytes;
 declare const kit_createSecretKey: typeof createSecretKey;
 declare const kit_decrypt: typeof decrypt;
@@ -244,9 +249,10 @@ declare const kit_encrypt: typeof encrypt;
 declare const kit_encryptObj: typeof encryptObj;
 declare const kit_generateUuid: typeof generateUuid;
 declare const kit_hash: typeof hash;
+declare const kit_hashObj: typeof hashObj;
 declare const kit_hashPassword: typeof hashPassword;
 declare const kit_tryConvertBytesToStr: typeof tryConvertBytesToStr;
-declare const kit_tryConvertFormat: typeof tryConvertFormat;
+declare const kit_tryConvertEncoding: typeof tryConvertEncoding;
 declare const kit_tryConvertStrToBytes: typeof tryConvertStrToBytes;
 declare const kit_tryCreateSecretKey: typeof tryCreateSecretKey;
 declare const kit_tryDecrypt: typeof tryDecrypt;
@@ -255,10 +261,11 @@ declare const kit_tryEncrypt: typeof tryEncrypt;
 declare const kit_tryEncryptObj: typeof tryEncryptObj;
 declare const kit_tryGenerateUuid: typeof tryGenerateUuid;
 declare const kit_tryHash: typeof tryHash;
+declare const kit_tryHashObj: typeof tryHashObj;
 declare const kit_tryHashPassword: typeof tryHashPassword;
 declare const kit_verifyPassword: typeof verifyPassword;
 declare namespace kit {
-  export { kit_convertBytesToStr as convertBytesToStr, kit_convertFormat as convertFormat, kit_convertStrToBytes as convertStrToBytes, kit_createSecretKey as createSecretKey, kit_decrypt as decrypt, kit_decryptObj as decryptObj, kit_encrypt as encrypt, kit_encryptObj as encryptObj, kit_generateUuid as generateUuid, kit_hash as hash, kit_hashPassword as hashPassword, kit_tryConvertBytesToStr as tryConvertBytesToStr, kit_tryConvertFormat as tryConvertFormat, kit_tryConvertStrToBytes as tryConvertStrToBytes, kit_tryCreateSecretKey as tryCreateSecretKey, kit_tryDecrypt as tryDecrypt, kit_tryDecryptObj as tryDecryptObj, kit_tryEncrypt as tryEncrypt, kit_tryEncryptObj as tryEncryptObj, kit_tryGenerateUuid as tryGenerateUuid, kit_tryHash as tryHash, kit_tryHashPassword as tryHashPassword, kit_verifyPassword as verifyPassword };
+  export { kit_convertBytesToStr as convertBytesToStr, kit_convertEncoding as convertEncoding, kit_convertStrToBytes as convertStrToBytes, kit_createSecretKey as createSecretKey, kit_decrypt as decrypt, kit_decryptObj as decryptObj, kit_encrypt as encrypt, kit_encryptObj as encryptObj, kit_generateUuid as generateUuid, kit_hash as hash, kit_hashObj as hashObj, kit_hashPassword as hashPassword, kit_tryConvertBytesToStr as tryConvertBytesToStr, kit_tryConvertEncoding as tryConvertEncoding, kit_tryConvertStrToBytes as tryConvertStrToBytes, kit_tryCreateSecretKey as tryCreateSecretKey, kit_tryDecrypt as tryDecrypt, kit_tryDecryptObj as tryDecryptObj, kit_tryEncrypt as tryEncrypt, kit_tryEncryptObj as tryEncryptObj, kit_tryGenerateUuid as tryGenerateUuid, kit_tryHash as tryHash, kit_tryHashObj as tryHashObj, kit_tryHashPassword as tryHashPassword, kit_verifyPassword as verifyPassword };
 }
 
-export { tryCreateSecretKey as a, tryEncrypt as b, createSecretKey as c, tryDecrypt as d, encrypt as e, decrypt as f, generateUuid as g, tryEncryptObj as h, encryptObj as i, tryDecryptObj as j, kit as k, decryptObj as l, tryHash as m, hash as n, tryHashPassword as o, hashPassword as p, tryConvertStrToBytes as q, convertStrToBytes as r, tryConvertBytesToStr as s, tryGenerateUuid as t, convertBytesToStr as u, verifyPassword as v, tryConvertFormat as w, convertFormat as x };
+export { tryCreateSecretKey as a, tryEncrypt as b, createSecretKey as c, tryDecrypt as d, encrypt as e, decrypt as f, generateUuid as g, tryEncryptObj as h, encryptObj as i, tryDecryptObj as j, kit as k, decryptObj as l, tryHash as m, hash as n, tryHashObj as o, hashObj as p, tryHashPassword as q, hashPassword as r, tryConvertStrToBytes as s, tryGenerateUuid as t, convertStrToBytes as u, verifyPassword as v, tryConvertBytesToStr as w, convertBytesToStr as x, tryConvertEncoding as y, convertEncoding as z };

package/dist/{export-C2vQXrZa.d.cts → export-v9ULdDL0.d.ts}

@@ -1,4 +1,4 @@
-import { R as Result, c as ENCRYPTION_ALGORITHMS, D as DIGEST_ALGORITHMS, S as SecretKey, b as EncodingFormat } from './validate-TRx4DDtg.cjs';
+import { R as Result, d as CreateSecretKeyOptions, S as SecretKey, e as EncryptOptions, f as DecryptOptions, H as HashOptions, g as HashPasswordOptions, V as VerifyPasswordOptions, b as Encoding } from './validate-CULVlPck.js';
 
 /**
  * Generates a UUID (v4).
@@ -20,12 +20,7 @@ declare function generateUuid(): string;
  * @param secret - The input string to derive the secret key from.
  * @returns A Result containing a SecretKey object representing the derived secret key or an error.
  */
-declare function tryCreateSecretKey(secret: string, options?: {
-    algorithm?: keyof typeof ENCRYPTION_ALGORITHMS;
-    digest?: keyof typeof DIGEST_ALGORITHMS;
-    salt?: string;
-    info?: string;
-}): Promise<Result<{
+declare function tryCreateSecretKey(secret: string, options?: CreateSecretKeyOptions): Promise<Result<{
     result: SecretKey<'web'>;
 }>>;
 /**
@@ -36,12 +31,7 @@ declare function tryCreateSecretKey(secret: string, options?: {
  * @returns A SecretKey object representing the derived secret key.
  * @throws {Error} If the input key is invalid or key generation fails.
  */
-declare function createSecretKey(secret: string, options?: {
-    algorithm?: keyof typeof ENCRYPTION_ALGORITHMS;
-    digest?: keyof typeof DIGEST_ALGORITHMS;
-    salt?: string;
-    info?: string;
-}): Promise<SecretKey<'web'>>;
+declare function createSecretKey(secret: string, options?: CreateSecretKeyOptions): Promise<SecretKey<'web'>>;
 /**
  * Encrypts the input string using the provided secret key.
  * The output is a string in the format "iv.cipherWithTag." where each component is base64url encoded.
@@ -50,7 +40,7 @@ declare function createSecretKey(secret: string, options?: {
  * @param secretKey - The SecretKey object used for encryption.
  * @returns A Result containing a string representing the encrypted data in the specified format or an error.
  */
-declare function tryEncrypt(data: string, secretKey: SecretKey<'web'>): Promise<Result<string>>;
+declare function tryEncrypt(data: string, secretKey: SecretKey<'web'>, options?: EncryptOptions): Promise<Result<string>>;
 /**
  * Encrypts the input string using the provided secret key.
  * The output is a string in the format "iv.cipherWithTag." where each component is base64url encoded.
@@ -60,7 +50,7 @@ declare function tryEncrypt(data: string, secretKey: SecretKey<'web'>): Promise<
  * @returns A string representing the encrypted data in the specified format.
  * @throws {Error} If the input data or key is invalid, or if encryption fails.
  */
-declare function encrypt(data: string, secretKey: SecretKey<'web'>): Promise<string>;
+declare function encrypt(data: string, secretKey: SecretKey<'web'>, options?: EncryptOptions): Promise<string>;
 /**
  * Decrypts the input string using the provided secret key.
  * The input must be in the format "iv.cipherWithTag." where each component is base64url encoded.
@@ -69,7 +59,7 @@ declare function encrypt(data: string, secretKey: SecretKey<'web'>): Promise<str
  * @param secretKey - The SecretKey object used for decryption.
  * @returns A Result containing a string representing the decrypted data or an error.
  */
-declare function tryDecrypt(encrypted: string, secretKey: SecretKey<'web'>): Promise<Result<string>>;
+declare function tryDecrypt(encrypted: string, secretKey: SecretKey<'web'>, options?: DecryptOptions): Promise<Result<string>>;
 /**
  * Decrypts the input string using the provided secret key.
  * The input must be in the format "iv.cipherWithTag" where each component is base64url encoded.
@@ -79,7 +69,7 @@ declare function tryDecrypt(encrypted: string, secretKey: SecretKey<'web'>): Pro
  * @returns A string representing the decrypted data.
  * @throws {Error} If the input data or key is invalid, or if decryption fails.
  */
-declare function decrypt(encrypted: string, secretKey: SecretKey<'web'>): Promise<string>;
+declare function decrypt(encrypted: string, secretKey: SecretKey<'web'>, options?: DecryptOptions): Promise<string>;
 /**
  * Encrypts the input object using the provided secret key.
  * The object is first serialized to a JSON string before encryption.
@@ -89,7 +79,7 @@ declare function decrypt(encrypted: string, secretKey: SecretKey<'web'>): Promis
  * @param secretKey - The SecretKey object used for encryption.
  * @returns A Result containing a string representing the encrypted object in the specified format or an error.
  */
-declare function tryEncryptObj<T extends object = Record<string, unknown>>(data: T, secretKey: SecretKey<'web'>): Promise<Result<string>>;
+declare function tryEncryptObj<T extends object = Record<string, unknown>>(data: T, secretKey: SecretKey<'web'>, options?: EncryptOptions): Promise<Result<string>>;
 /**
  * Encrypts the input object using the provided secret key.
  * The object is first serialized to a JSON string before encryption.
@@ -100,7 +90,7 @@ declare function tryEncryptObj<T extends object = Record<string, unknown>>(data:
  * @returns A string representing the encrypted object in the specified format.
  * @throws {Error} If the input data or key is invalid, or if encryption fails.
  */
-declare function encryptObj<T extends object = Record<string, unknown>>(data: T, secretKey: SecretKey<'web'>): Promise<string>;
+declare function encryptObj<T extends object = Record<string, unknown>>(data: T, secretKey: SecretKey<'web'>, options?: EncryptOptions): Promise<string>;
 /**
  * Decrypts the input string to an object using the provided secret key.
  * The input must be in the format "iv.cipherWithTag." where each component is base64url encoded.
@@ -110,7 +100,7 @@ declare function encryptObj<T extends object = Record<string, unknown>>(data: T,
  * @param secretKey - The SecretKey object used for decryption.
  * @returns A Result containing an object representing the decrypted data or an error.
  */
-declare function tryDecryptObj<T extends object = Record<string, unknown>>(encrypted: string, secretKey: SecretKey<'web'>): Promise<Result<{
+declare function tryDecryptObj<T extends object = Record<string, unknown>>(encrypted: string, secretKey: SecretKey<'web'>, options?: DecryptOptions): Promise<Result<{
     result: T;
 }>>;
 /**
@@ -123,16 +113,14 @@ declare function tryDecryptObj<T extends object = Record<string, unknown>>(encry
  * @returns An object representing the decrypted data.
  * @throws {Error} If the input data or key is invalid, or if decryption fails.
  */
-declare function decryptObj<T extends object = Record<string, unknown>>(encrypted: string, secretKey: SecretKey<'web'>): Promise<{
-    result: T;
-}>;
+declare function decryptObj<T extends object = Record<string, unknown>>(encrypted: string, secretKey: SecretKey<'web'>, options?: DecryptOptions): Promise<T>;
 /**
  * Hashes the input string using SHA-256 and returns the hash in base64url format.
  *
  * @param data - The input string to hash.
  * @returns A Result containing a string representing the SHA-256 hash in base64url format or an error.
  */
-declare function tryHash(data: string): Promise<Result<string>>;
+declare function tryHash(data: string, options?: HashOptions): Promise<Result<string>>;
 /**
  * Hashes the input string using SHA-256 and returns the hash in base64url format.
  *
@@ -140,14 +128,31 @@ declare function tryHash(data: string): Promise<Result<string>>;
  * @returns A string representing the SHA-256 hash in base64url format.
  * @throws {Error} If the input data is invalid or hashing fails.
  */
-declare function hash(data: string): Promise<string>;
+declare function hash(data: string, options?: HashOptions): Promise<string>;
+/**
+ * Hashes the input object by first serializing it to a JSON string using stable key ordering,
+ * then hashing the string using SHA-256 and returning the hash in base64url format.
+ *
+ * @param data - The input object to hash.
+ * @returns A Result containing a string representing the SHA-256 hash of the serialized object in base64url format or an error.
+ * */
+declare function tryHashObj<T extends object = Record<string, unknown>>(data: T, options?: HashOptions): Promise<Result<string>>;
+/**
+ * Hashes the input object by first serializing it to a JSON string using stable key ordering,
+ * then hashing the string using SHA-256 and returning the hash in base64url format.
+ *
+ * @param data - The input object to hash.
+ * @returns A string representing the SHA-256 hash of the serialized object in base64url format.
+ * @throws {Error} If the input data is invalid or hashing fails.
+ */
+declare function hashObj<T extends object = Record<string, unknown>>(data: T, options?: HashOptions): Promise<string>;
 /**
  * Hashes a password using PBKDF2 with SHA-512.
  *
  * @param password - The password to hash.
  * @returns A Result containing an object with the hash and salt, or an error.
  */
-declare function tryHashPassword(password: string): Promise<Result<{
+declare function tryHashPassword(password: string, options?: HashPasswordOptions): Promise<Result<{
     hash: string;
     salt: string;
 }>>;
@@ -158,7 +163,7 @@ declare function tryHashPassword(password: string): Promise<Result<{
  * @returns An object with the hash and salt.
  * @throws {Error} If the input password is invalid or hashing fails.
  */
-declare function hashPassword(password: string): Promise<{
+declare function hashPassword(password: string, options?: HashPasswordOptions): Promise<{
     hash: string;
     salt: string;
 }>;
@@ -170,16 +175,16 @@ declare function hashPassword(password: string): Promise<{
  * @param salt - The salt used during hashing (in base64url format).
  * @returns A boolean indicating whether the password matches the hashed password.
  */
-declare function verifyPassword(password: string, hashedPassword: string, salt: string): Promise<boolean>;
+declare function verifyPassword(password: string, hashedPassword: string, salt: string, options?: VerifyPasswordOptions): Promise<boolean>;
 /**
  * Converts a string to a Buffer (byte array) using the specified encoding format.
  * Supported formats: 'base64', 'base64url', 'hex', 'utf8', 'latin1'.
  *
  * @param data - The input string to convert.
- * @param format - The encoding format to use (default is 'utf8').
+ * @param inputEncoding - The encoding format to use (default is 'utf8').
  * @returns A Result containing a Uint8Array with the encoded data or an error.
  */
-declare function tryConvertStrToBytes(data: string, format?: EncodingFormat): Result<{
+declare function tryConvertStrToBytes(data: string, inputEncoding?: Encoding): Result<{
     result: Uint8Array<ArrayBuffer>;
 }>;
 /**
@@ -187,30 +192,30 @@ declare function tryConvertStrToBytes(data: string, format?: EncodingFormat): Re
  * Supported formats: 'base64', 'base64url', 'hex', 'utf8', 'latin1'.
  *
  * @param data - The input string to convert.
- * @param format - The encoding format to use (default is 'utf8').
+ * @param inputEncoding - The encoding format to use (default is 'utf8').
  * @returns A Uint8Array containing the encoded data.
  * @throws {Error} If the input data is invalid or conversion fails.
  */
-declare function convertStrToBytes(data: string, format?: EncodingFormat): Uint8Array<ArrayBuffer>;
+declare function convertStrToBytes(data: string, inputEncoding?: Encoding): Uint8Array<ArrayBuffer>;
 /**
  * Converts a Uint8Array or ArrayBuffer (byte array) to a string using the specified encoding format.
  * Supported formats: 'base64', 'base64url', 'hex', 'utf8', 'latin1'.
  *
  * @param data - The input Uint8Array or ArrayBuffer to convert.
- * @param format - The encoding format to use (default is 'utf8').
+ * @param outputEncoding - The encoding format to use (default is 'utf8').
  * @returns A Result containing the string representation of the Uint8Array or an error.
  */
-declare function tryConvertBytesToStr(data: Uint8Array | ArrayBuffer, format?: EncodingFormat): Result<string>;
+declare function tryConvertBytesToStr(data: Uint8Array | ArrayBuffer, outputEncoding?: Encoding): Result<string>;
 /**
  * Converts a Uint8Array or ArrayBuffer (byte array) to a string using the specified encoding format.
  * Supported formats: 'base64', 'base64url', 'hex', 'utf8', 'latin1'.
  *
  * @param data - The input Uint8Array or ArrayBuffer to convert.
- * @param format - The encoding format to use (default is 'utf8').
+ * @param outputEncoding - The encoding format to use (default is 'utf8').
  * @returns A string representation of the Uint8Array in the specified format.
  * @throws {Error} If the input data is invalid or conversion fails.
  */
-declare function convertBytesToStr(data: Uint8Array | ArrayBuffer, format?: EncodingFormat): string;
+declare function convertBytesToStr(data: Uint8Array | ArrayBuffer, outputEncoding?: Encoding): string;
 /**
  * Convert data from one encoding format to another.
  *
@@ -219,7 +224,7 @@ declare function convertBytesToStr(data: Uint8Array | ArrayBuffer, format?: Enco
  * @param to - The encoding format to convert to.
  * @returns A Result containing the converted string or an error.
  */
-declare function tryConvertFormat(data: string, from: EncodingFormat, to: EncodingFormat): Result<{
+declare function tryConvertEncoding(data: string, from: Encoding, to: Encoding): Result<{
     result: string;
 }>;
 /**
@@ -231,10 +236,10 @@ declare function tryConvertFormat(data: string, from: EncodingFormat, to: Encodi
  * @returns A converted string.
  * @throws {Error} If the input data is invalid or conversion fails.
  */
-declare function convertFormat(data: string, from: EncodingFormat, to: EncodingFormat): string;
+declare function convertEncoding(data: string, from: Encoding, to: Encoding): string;
 
 declare const kit_convertBytesToStr: typeof convertBytesToStr;
-declare const kit_convertFormat: typeof convertFormat;
+declare const kit_convertEncoding: typeof convertEncoding;
 declare const kit_convertStrToBytes: typeof convertStrToBytes;
 declare const kit_createSecretKey: typeof createSecretKey;
 declare const kit_decrypt: typeof decrypt;
@@ -243,9 +248,10 @@ declare const kit_encrypt: typeof encrypt;
 declare const kit_encryptObj: typeof encryptObj;
 declare const kit_generateUuid: typeof generateUuid;
 declare const kit_hash: typeof hash;
+declare const kit_hashObj: typeof hashObj;
 declare const kit_hashPassword: typeof hashPassword;
 declare const kit_tryConvertBytesToStr: typeof tryConvertBytesToStr;
-declare const kit_tryConvertFormat: typeof tryConvertFormat;
+declare const kit_tryConvertEncoding: typeof tryConvertEncoding;
 declare const kit_tryConvertStrToBytes: typeof tryConvertStrToBytes;
 declare const kit_tryCreateSecretKey: typeof tryCreateSecretKey;
 declare const kit_tryDecrypt: typeof tryDecrypt;
@@ -254,10 +260,11 @@ declare const kit_tryEncrypt: typeof tryEncrypt;
 declare const kit_tryEncryptObj: typeof tryEncryptObj;
 declare const kit_tryGenerateUuid: typeof tryGenerateUuid;
 declare const kit_tryHash: typeof tryHash;
+declare const kit_tryHashObj: typeof tryHashObj;
 declare const kit_tryHashPassword: typeof tryHashPassword;
 declare const kit_verifyPassword: typeof verifyPassword;
 declare namespace kit {
-  export { kit_convertBytesToStr as convertBytesToStr, kit_convertFormat as convertFormat, kit_convertStrToBytes as convertStrToBytes, kit_createSecretKey as createSecretKey, kit_decrypt as decrypt, kit_decryptObj as decryptObj, kit_encrypt as encrypt, kit_encryptObj as encryptObj, kit_generateUuid as generateUuid, kit_hash as hash, kit_hashPassword as hashPassword, kit_tryConvertBytesToStr as tryConvertBytesToStr, kit_tryConvertFormat as tryConvertFormat, kit_tryConvertStrToBytes as tryConvertStrToBytes, kit_tryCreateSecretKey as tryCreateSecretKey, kit_tryDecrypt as tryDecrypt, kit_tryDecryptObj as tryDecryptObj, kit_tryEncrypt as tryEncrypt, kit_tryEncryptObj as tryEncryptObj, kit_tryGenerateUuid as tryGenerateUuid, kit_tryHash as tryHash, kit_tryHashPassword as tryHashPassword, kit_verifyPassword as verifyPassword };
+  export { kit_convertBytesToStr as convertBytesToStr, kit_convertEncoding as convertEncoding, kit_convertStrToBytes as convertStrToBytes, kit_createSecretKey as createSecretKey, kit_decrypt as decrypt, kit_decryptObj as decryptObj, kit_encrypt as encrypt, kit_encryptObj as encryptObj, kit_generateUuid as generateUuid, kit_hash as hash, kit_hashObj as hashObj, kit_hashPassword as hashPassword, kit_tryConvertBytesToStr as tryConvertBytesToStr, kit_tryConvertEncoding as tryConvertEncoding, kit_tryConvertStrToBytes as tryConvertStrToBytes, kit_tryCreateSecretKey as tryCreateSecretKey, kit_tryDecrypt as tryDecrypt, kit_tryDecryptObj as tryDecryptObj, kit_tryEncrypt as tryEncrypt, kit_tryEncryptObj as tryEncryptObj, kit_tryGenerateUuid as tryGenerateUuid, kit_tryHash as tryHash, kit_tryHashObj as tryHashObj, kit_tryHashPassword as tryHashPassword, kit_verifyPassword as verifyPassword };
 }
 
-export { tryCreateSecretKey as a, tryEncrypt as b, createSecretKey as c, tryDecrypt as d, encrypt as e, decrypt as f, generateUuid as g, tryEncryptObj as h, encryptObj as i, tryDecryptObj as j, kit as k, decryptObj as l, tryHash as m, hash as n, tryHashPassword as o, hashPassword as p, tryConvertStrToBytes as q, convertStrToBytes as r, tryConvertBytesToStr as s, tryGenerateUuid as t, convertBytesToStr as u, verifyPassword as v, tryConvertFormat as w, convertFormat as x };
+export { tryCreateSecretKey as a, tryEncrypt as b, createSecretKey as c, tryDecrypt as d, encrypt as e, decrypt as f, generateUuid as g, tryEncryptObj as h, encryptObj as i, tryDecryptObj as j, kit as k, decryptObj as l, tryHash as m, hash as n, tryHashObj as o, hashObj as p, tryHashPassword as q, hashPassword as r, tryConvertStrToBytes as s, tryGenerateUuid as t, convertStrToBytes as u, verifyPassword as v, tryConvertBytesToStr as w, convertBytesToStr as x, tryConvertEncoding as y, convertEncoding as z };