cipher-kit 2.0.0-beta.0 → 2.0.0-beta.2

package/dist/{export-CrT_Y2Cy.d.cts → export-C0WDJZUy.d.ts}

@@ -1,4 +1,4 @@
-import { R as Result, W as WebSecretKey, c as EncodingFormat, b as isWebSecretKey } from './validate-CPWPEEAt.cjs';
+import { R as Result, C as CreateSecretKeyOptions, S as SecretKey, d as EncryptOptions, e as DecryptOptions, H as HashOptions, f as HashPasswordOptions, V as VerifyPasswordOptions, b as Encoding } from './validate-CS4PFmY1.js';
 
 /**
  * Generates a UUID (v4).
@@ -17,90 +17,90 @@ declare function generateUuid(): string;
  * Derives a secret key from the provided string for encryption/decryption.
  * Internally, the key is hashed using SHA-256 to ensure it meets the required length.
  *
- * @param key - The input string to derive the secret key from.
- * @returns A Result containing a WebApiKey object representing the derived secret key or an error.
+ * @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(key: string): Promise<Result<{
-    result: WebSecretKey;
+declare function tryCreateSecretKey(secret: string, options?: CreateSecretKeyOptions): Promise<Result<{
+    result: SecretKey<'web'>;
 }>>;
 /**
  * Derives a secret key from the provided string for encryption/decryption.
  * Internally, the key is hashed using SHA-256 to ensure it meets the required length.
  *
- * @param key - The input string to derive the secret key from.
- * @returns A WebApiKey object representing the derived secret key.
+ * @param secret - The input string to derive the secret key from.
+ * @returns A SecretKey object representing the derived secret key.
  * @throws {Error} If the input key is invalid or key generation fails.
  */
-declare function createSecretKey(key: string): Promise<WebSecretKey>;
+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.
  *
  * @param data - The input string to encrypt.
- * @param secretKey - The WebApiKey object used for encryption.
+ * @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: WebSecretKey): 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.
  *
  * @param data - The input string to encrypt.
- * @param secretKey - The WebApiKey object used for encryption.
+ * @param secretKey - The SecretKey object used for encryption.
  * @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: WebSecretKey): 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.
  *
  * @param encrypted - The input string to decrypt.
- * @param secretKey - The WebApiKey object used for decryption.
+ * @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: WebSecretKey): 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.
  *
  * @param encrypted - The input string to decrypt.
- * @param secretKey - The WebApiKey object used for decryption.
+ * @param secretKey - The SecretKey object used for decryption.
  * @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: WebSecretKey): 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.
  * The output is a string in the format "iv.cipherWithTag." where each component is base64url encoded.
  *
  * @param data - The input object to encrypt.
- * @param secretKey - The WebApiKey object used for encryption.
+ * @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: WebSecretKey): 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.
  * The output is a string in the format "iv.cipherWithTag." where each component is base64url encoded.
  *
  * @param data - The input object to encrypt.
- * @param secretKey - The WebApiKey object used for encryption.
+ * @param secretKey - The SecretKey object used for encryption.
  * @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: WebSecretKey): 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.
  * The decrypted string is parsed as JSON to reconstruct the original object.
  *
  * @param encrypted - The input string to decrypt.
- * @param secretKey - The WebApiKey object used for decryption.
+ * @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: WebSecretKey): Promise<Result<{
+declare function tryDecryptObj<T extends object = Record<string, unknown>>(encrypted: string, secretKey: SecretKey<'web'>, options?: DecryptOptions): Promise<Result<{
     result: T;
 }>>;
 /**
@@ -109,20 +109,18 @@ declare function tryDecryptObj<T extends object = Record<string, unknown>>(encry
  * The decrypted string is parsed as JSON to reconstruct the original object.
  *
  * @param encrypted - The input string to decrypt.
- * @param secretKey - The WebApiKey object used for decryption.
+ * @param secretKey - The SecretKey object used for decryption.
  * @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: WebSecretKey): 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.
  *
@@ -130,14 +128,14 @@ 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 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;
 }>>;
@@ -148,7 +146,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;
 }>;
@@ -160,16 +158,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>;
 }>;
 /**
@@ -177,30 +175,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.
  *
@@ -209,7 +207,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;
 }>;
 /**
@@ -221,10 +219,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;
@@ -234,9 +232,8 @@ declare const kit_encryptObj: typeof encryptObj;
 declare const kit_generateUuid: typeof generateUuid;
 declare const kit_hash: typeof hash;
 declare const kit_hashPassword: typeof hashPassword;
-declare const kit_isWebSecretKey: typeof isWebSecretKey;
 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;
@@ -248,7 +245,7 @@ declare const kit_tryHash: typeof tryHash;
 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_isWebSecretKey as isWebSecretKey, 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_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_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, tryHashPassword as o, hashPassword as p, tryConvertStrToBytes as q, convertStrToBytes as r, tryConvertBytesToStr as s, tryGenerateUuid as t, convertBytesToStr as u, verifyPassword as v, tryConvertEncoding as w, convertEncoding as x };

package/dist/{export-Bh49U7Yf.d.ts → export-LPOfeH2z.d.cts}

@@ -1,4 +1,4 @@
-import { R as Result, W as WebSecretKey, c as EncodingFormat, b as isWebSecretKey } from './validate-CPWPEEAt.js';
+import { R as Result, C as CreateSecretKeyOptions, S as SecretKey, d as EncryptOptions, e as DecryptOptions, H as HashOptions, f as HashPasswordOptions, V as VerifyPasswordOptions, b as Encoding } from './validate-CS4PFmY1.cjs';
 
 /**
  * Generates a UUID (v4).
@@ -17,90 +17,90 @@ declare function generateUuid(): string;
  * Derives a secret key from the provided string for encryption/decryption.
  * Internally, the key is hashed using SHA-256 to ensure it meets the required length.
  *
- * @param key - The input string to derive the secret key from.
- * @returns A Result containing a WebApiKey object representing the derived secret key or an error.
+ * @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(key: string): Promise<Result<{
-    result: WebSecretKey;
+declare function tryCreateSecretKey(secret: string, options?: CreateSecretKeyOptions): Promise<Result<{
+    result: SecretKey<'web'>;
 }>>;
 /**
  * Derives a secret key from the provided string for encryption/decryption.
  * Internally, the key is hashed using SHA-256 to ensure it meets the required length.
  *
- * @param key - The input string to derive the secret key from.
- * @returns A WebApiKey object representing the derived secret key.
+ * @param secret - The input string to derive the secret key from.
+ * @returns A SecretKey object representing the derived secret key.
  * @throws {Error} If the input key is invalid or key generation fails.
  */
-declare function createSecretKey(key: string): Promise<WebSecretKey>;
+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.
  *
  * @param data - The input string to encrypt.
- * @param secretKey - The WebApiKey object used for encryption.
+ * @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: WebSecretKey): 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.
  *
  * @param data - The input string to encrypt.
- * @param secretKey - The WebApiKey object used for encryption.
+ * @param secretKey - The SecretKey object used for encryption.
  * @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: WebSecretKey): 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.
  *
  * @param encrypted - The input string to decrypt.
- * @param secretKey - The WebApiKey object used for decryption.
+ * @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: WebSecretKey): 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.
  *
  * @param encrypted - The input string to decrypt.
- * @param secretKey - The WebApiKey object used for decryption.
+ * @param secretKey - The SecretKey object used for decryption.
  * @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: WebSecretKey): 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.
  * The output is a string in the format "iv.cipherWithTag." where each component is base64url encoded.
  *
  * @param data - The input object to encrypt.
- * @param secretKey - The WebApiKey object used for encryption.
+ * @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: WebSecretKey): 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.
  * The output is a string in the format "iv.cipherWithTag." where each component is base64url encoded.
  *
  * @param data - The input object to encrypt.
- * @param secretKey - The WebApiKey object used for encryption.
+ * @param secretKey - The SecretKey object used for encryption.
  * @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: WebSecretKey): 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.
  * The decrypted string is parsed as JSON to reconstruct the original object.
  *
  * @param encrypted - The input string to decrypt.
- * @param secretKey - The WebApiKey object used for decryption.
+ * @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: WebSecretKey): Promise<Result<{
+declare function tryDecryptObj<T extends object = Record<string, unknown>>(encrypted: string, secretKey: SecretKey<'web'>, options?: DecryptOptions): Promise<Result<{
     result: T;
 }>>;
 /**
@@ -109,20 +109,18 @@ declare function tryDecryptObj<T extends object = Record<string, unknown>>(encry
  * The decrypted string is parsed as JSON to reconstruct the original object.
  *
  * @param encrypted - The input string to decrypt.
- * @param secretKey - The WebApiKey object used for decryption.
+ * @param secretKey - The SecretKey object used for decryption.
  * @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: WebSecretKey): 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.
  *
@@ -130,14 +128,14 @@ 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 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;
 }>>;
@@ -148,7 +146,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;
 }>;
@@ -160,16 +158,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>;
 }>;
 /**
@@ -177,30 +175,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.
  *
@@ -209,7 +207,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;
 }>;
 /**
@@ -221,10 +219,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;
@@ -234,9 +232,8 @@ declare const kit_encryptObj: typeof encryptObj;
 declare const kit_generateUuid: typeof generateUuid;
 declare const kit_hash: typeof hash;
 declare const kit_hashPassword: typeof hashPassword;
-declare const kit_isWebSecretKey: typeof isWebSecretKey;
 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;
@@ -248,7 +245,7 @@ declare const kit_tryHash: typeof tryHash;
 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_isWebSecretKey as isWebSecretKey, 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_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_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, tryHashPassword as o, hashPassword as p, tryConvertStrToBytes as q, convertStrToBytes as r, tryConvertBytesToStr as s, tryGenerateUuid as t, convertBytesToStr as u, verifyPassword as v, tryConvertEncoding as w, convertEncoding as x };