cipher-kit 2.1.1 → 2.1.2

package/dist/{export-DO9n7Np-.d.cts → export-KFT0YyMg.d.cts}

@@ -1,23 +1,6 @@
-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-cJEdGlj1.cjs';
+import { R as Result, e as CreateSecretKeyOptions, N as NodeSecretKey, f as EncryptOptions, g as DecryptOptions, H as HashOptions, h as HashPasswordOptions, V as VerifyPasswordOptions, c as Encoding } from './validate-lkJAHCeJ.cjs';
 import { Buffer } from 'node:buffer';
 
-/**
- * Type guard to check if the provided value is a SecretKey object for Node.js environment.
- *
- * ### 🍼 Explain Like I'm Five
- * Checking if the key in your hand is the right kind of key for the lock.
- *
- * @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">;
 /**
  * Safely generates a UUID (v4) (non-throwing).
  *
@@ -77,7 +60,7 @@ declare function generateUuid(): string;
  * ```
  */
 declare function tryCreateSecretKey(secret: string, options?: CreateSecretKeyOptions): Result<{
-    result: SecretKey<"node">;
+    result: NodeSecretKey;
 }>;
 /**
  * Derives a `SecretKey` from the provided string for encryption/decryption (throwing).
@@ -101,7 +84,7 @@ declare function tryCreateSecretKey(secret: string, options?: CreateSecretKeyOpt
  * const secretKey = createSecretKey("my-secret"); // SecretKey object
  * ```
  */
-declare function createSecretKey(secret: string, options?: CreateSecretKeyOptions): SecretKey<"node">;
+declare function createSecretKey(secret: string, options?: CreateSecretKeyOptions): NodeSecretKey;
 /**
  * Safely encrypts a UTF-8 string using the provided `SecretKey` (non-throwing).
  *
@@ -125,7 +108,7 @@ declare function createSecretKey(secret: string, options?: CreateSecretKeyOption
  * else console.error(error); // { message: "...", description: "..." }
  * ```
  */
-declare function tryEncrypt(data: string, secretKey: SecretKey<"node">, options?: EncryptOptions): Result<string>;
+declare function tryEncrypt(data: string, secretKey: NodeSecretKey, options?: EncryptOptions): Result<string>;
 /**
  * Encrypts a UTF-8 string using the provided `SecretKey` (throwing).
  *
@@ -147,7 +130,7 @@ declare function tryEncrypt(data: string, secretKey: SecretKey<"node">, options?
  * const encrypted = encrypt("Hello, World!", secretKey); // "iv.cipher.tag." (Encrypted string)
  * ```
  */
-declare function encrypt(data: string, secretKey: SecretKey<"node">, options?: EncryptOptions): string;
+declare function encrypt(data: string, secretKey: NodeSecretKey, options?: EncryptOptions): string;
 /**
  * Safely decrypts the input string using the provided `SecretKey` (non-throwing).
  *
@@ -172,7 +155,7 @@ declare function encrypt(data: string, secretKey: SecretKey<"node">, options?: E
  * else console.error(error); // { message: "...", description: "..." }
  * ```
  */
-declare function tryDecrypt(encrypted: string, secretKey: SecretKey<"node">, options?: DecryptOptions): Result<string>;
+declare function tryDecrypt(encrypted: string, secretKey: NodeSecretKey, options?: DecryptOptions): Result<string>;
 /**
  * Decrypts the input string using the provided `SecretKey` (throwing).
  *
@@ -195,7 +178,7 @@ declare function tryDecrypt(encrypted: string, secretKey: SecretKey<"node">, opt
  * const decrypted = decrypt(encrypted, secretKey); // "Hello, World!" (Decrypted string)
  * ```
  */
-declare function decrypt(encrypted: string, secretKey: SecretKey<"node">, options?: DecryptOptions): string;
+declare function decrypt(encrypted: string, secretKey: NodeSecretKey, options?: DecryptOptions): string;
 /**
  * Safely encrypts a plain object using the provided `SecretKey` (non-throwing).
  *
@@ -223,7 +206,7 @@ declare function decrypt(encrypted: string, secretKey: SecretKey<"node">, option
  * else console.error(error); // { message: "...", description: "..." }
  * ```
  */
-declare function tryEncryptObj<T extends object = Record<string, unknown>>(obj: T, secretKey: SecretKey<"node">, options?: EncryptOptions): Result<string>;
+declare function tryEncryptObj<T extends object = Record<string, unknown>>(obj: T, secretKey: NodeSecretKey, options?: EncryptOptions): Result<string>;
 /**
  * Encrypts a plain object using the provided `SecretKey` (throwing).
  *
@@ -249,7 +232,7 @@ declare function tryEncryptObj<T extends object = Record<string, unknown>>(obj:
  * const encrypted = encryptObj({ a: 1 }, secretKey); // "iv.cipher.tag." (Encrypted string)
  * ```
  */
-declare function encryptObj<T extends object = Record<string, unknown>>(obj: T, secretKey: SecretKey<"node">, options?: EncryptOptions): string;
+declare function encryptObj<T extends object = Record<string, unknown>>(obj: T, secretKey: NodeSecretKey, options?: EncryptOptions): string;
 /**
  * Safely decrypts an encrypted JSON string into a plain object (non-throwing).
  *
@@ -275,7 +258,7 @@ declare function encryptObj<T extends object = Record<string, unknown>>(obj: T,
  * else console.error(error); // { message: "...", description: "..." }
  * ```
  */
-declare function tryDecryptObj<T extends object = Record<string, unknown>>(encrypted: string, secretKey: SecretKey<"node">, options?: DecryptOptions): Result<{
+declare function tryDecryptObj<T extends object = Record<string, unknown>>(encrypted: string, secretKey: NodeSecretKey, options?: DecryptOptions): Result<{
     result: T;
 }>;
 /**
@@ -301,7 +284,7 @@ declare function tryDecryptObj<T extends object = Record<string, unknown>>(encry
  * 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;
+declare function decryptObj<T extends object = Record<string, unknown>>(encrypted: string, secretKey: NodeSecretKey, options?: DecryptOptions): T;
 /**
  * Safely hashes a UTF-8 string (non-throwing).
  *
@@ -571,7 +554,6 @@ declare const nodeCryptoKit_encryptObj: typeof encryptObj;
 declare const nodeCryptoKit_generateUuid: typeof generateUuid;
 declare const nodeCryptoKit_hash: typeof hash;
 declare const nodeCryptoKit_hashPassword: typeof hashPassword;
-declare const nodeCryptoKit_isNodeSecretKey: typeof isNodeSecretKey;
 declare const nodeCryptoKit_tryConvertBytesToStr: typeof tryConvertBytesToStr;
 declare const nodeCryptoKit_tryConvertEncoding: typeof tryConvertEncoding;
 declare const nodeCryptoKit_tryConvertStrToBytes: typeof tryConvertStrToBytes;
@@ -585,7 +567,7 @@ declare const nodeCryptoKit_tryHash: typeof tryHash;
 declare const nodeCryptoKit_tryHashPassword: typeof tryHashPassword;
 declare const nodeCryptoKit_verifyPassword: typeof verifyPassword;
 declare namespace nodeCryptoKit {
-  export { nodeCryptoKit_convertBytesToStr as convertBytesToStr, nodeCryptoKit_convertEncoding as convertEncoding, nodeCryptoKit_convertStrToBytes as convertStrToBytes, nodeCryptoKit_createSecretKey as createSecretKey, nodeCryptoKit_decrypt as decrypt, nodeCryptoKit_decryptObj as decryptObj, nodeCryptoKit_encrypt as encrypt, nodeCryptoKit_encryptObj as encryptObj, nodeCryptoKit_generateUuid as generateUuid, nodeCryptoKit_hash as hash, nodeCryptoKit_hashPassword as hashPassword, nodeCryptoKit_isNodeSecretKey as isNodeSecretKey, nodeCryptoKit_tryConvertBytesToStr as tryConvertBytesToStr, nodeCryptoKit_tryConvertEncoding as tryConvertEncoding, nodeCryptoKit_tryConvertStrToBytes as tryConvertStrToBytes, nodeCryptoKit_tryCreateSecretKey as tryCreateSecretKey, nodeCryptoKit_tryDecrypt as tryDecrypt, nodeCryptoKit_tryDecryptObj as tryDecryptObj, nodeCryptoKit_tryEncrypt as tryEncrypt, nodeCryptoKit_tryEncryptObj as tryEncryptObj, nodeCryptoKit_tryGenerateUuid as tryGenerateUuid, nodeCryptoKit_tryHash as tryHash, nodeCryptoKit_tryHashPassword as tryHashPassword, nodeCryptoKit_verifyPassword as verifyPassword };
+  export { nodeCryptoKit_convertBytesToStr as convertBytesToStr, nodeCryptoKit_convertEncoding as convertEncoding, nodeCryptoKit_convertStrToBytes as convertStrToBytes, nodeCryptoKit_createSecretKey as createSecretKey, nodeCryptoKit_decrypt as decrypt, nodeCryptoKit_decryptObj as decryptObj, nodeCryptoKit_encrypt as encrypt, nodeCryptoKit_encryptObj as encryptObj, nodeCryptoKit_generateUuid as generateUuid, nodeCryptoKit_hash as hash, nodeCryptoKit_hashPassword as hashPassword, nodeCryptoKit_tryConvertBytesToStr as tryConvertBytesToStr, nodeCryptoKit_tryConvertEncoding as tryConvertEncoding, nodeCryptoKit_tryConvertStrToBytes as tryConvertStrToBytes, nodeCryptoKit_tryCreateSecretKey as tryCreateSecretKey, nodeCryptoKit_tryDecrypt as tryDecrypt, nodeCryptoKit_tryDecryptObj as tryDecryptObj, nodeCryptoKit_tryEncrypt as tryEncrypt, nodeCryptoKit_tryEncryptObj as tryEncryptObj, nodeCryptoKit_tryGenerateUuid as tryGenerateUuid, nodeCryptoKit_tryHash as tryHash, nodeCryptoKit_tryHashPassword as tryHashPassword, nodeCryptoKit_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, isNodeSecretKey as i, encryptObj as j, tryDecryptObj as k, decryptObj as l, tryHash as m, nodeCryptoKit as n, hash as o, tryHashPassword as p, hashPassword as q, tryConvertStrToBytes as r, convertStrToBytes as s, tryGenerateUuid as t, tryConvertBytesToStr as u, verifyPassword as v, convertBytesToStr as w, tryConvertEncoding as x, convertEncoding as y };
+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, decryptObj as k, tryHash as l, hash as m, nodeCryptoKit 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/index.cjs

@@ -1,36 +1,44 @@
 'use strict';
 
-var chunk56PVVFVM_cjs = require('./chunk-56PVVFVM.cjs');
-var chunkLTVOIZP5_cjs = require('./chunk-LTVOIZP5.cjs');
-var chunkX4CS7UXE_cjs = require('./chunk-X4CS7UXE.cjs');
+var chunkZNM5M6RD_cjs = require('./chunk-ZNM5M6RD.cjs');
+var chunk66WIL32E_cjs = require('./chunk-66WIL32E.cjs');
+var chunkHTRGOBZF_cjs = require('./chunk-HTRGOBZF.cjs');
 
 // src/export.ts
-var nodeKit = chunk56PVVFVM_cjs.kit_exports;
-var webKit = chunkLTVOIZP5_cjs.kit_exports;
+var nodeKit = chunkZNM5M6RD_cjs.kit_exports;
+var webKit = chunk66WIL32E_cjs.kit_exports;
 
 Object.defineProperty(exports, "ENCRYPTED_REGEX", {
   enumerable: true,
-  get: function () { return chunkX4CS7UXE_cjs.ENCRYPTED_REGEX; }
+  get: function () { return chunkHTRGOBZF_cjs.ENCRYPTED_REGEX; }
+});
+Object.defineProperty(exports, "isNodeSecretKey", {
+  enumerable: true,
+  get: function () { return chunkHTRGOBZF_cjs.isNodeSecretKey; }
+});
+Object.defineProperty(exports, "isWebSecretKey", {
+  enumerable: true,
+  get: function () { return chunkHTRGOBZF_cjs.isWebSecretKey; }
 });
 Object.defineProperty(exports, "matchEncryptedPattern", {
   enumerable: true,
-  get: function () { return chunkX4CS7UXE_cjs.matchEncryptedPattern; }
+  get: function () { return chunkHTRGOBZF_cjs.matchEncryptedPattern; }
 });
 Object.defineProperty(exports, "parseToObj", {
   enumerable: true,
-  get: function () { return chunkX4CS7UXE_cjs.parseToObj; }
+  get: function () { return chunkHTRGOBZF_cjs.parseToObj; }
 });
 Object.defineProperty(exports, "stringifyObj", {
   enumerable: true,
-  get: function () { return chunkX4CS7UXE_cjs.stringifyObj; }
+  get: function () { return chunkHTRGOBZF_cjs.stringifyObj; }
 });
 Object.defineProperty(exports, "tryParseToObj", {
   enumerable: true,
-  get: function () { return chunkX4CS7UXE_cjs.tryParseToObj; }
+  get: function () { return chunkHTRGOBZF_cjs.tryParseToObj; }
 });
 Object.defineProperty(exports, "tryStringifyObj", {
   enumerable: true,
-  get: function () { return chunkX4CS7UXE_cjs.tryStringifyObj; }
+  get: function () { return chunkHTRGOBZF_cjs.tryStringifyObj; }
 });
 exports.nodeKit = nodeKit;
 exports.webKit = webKit;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/export.ts"],"names":["kit_exports"],"mappings":";;;;;;;AAoCO,IAAM,OAAA,GAAUA;AAwBhB,IAAM,MAAA,GAASA","file":"index.cjs","sourcesContent":["import * as nodeCryptoKit from \"./node/kit\";\r\nimport * as webCryptoKit from \"./web/kit\";\r\n\r\nexport {\r\n  parseToObj,\r\n  stringifyObj,\r\n  tryParseToObj,\r\n  tryStringifyObj,\r\n} from \"~/helpers/object\";\r\nexport {\r\n  ENCRYPTED_REGEX,\r\n  matchEncryptedPattern,\r\n} from \"~/helpers/validate\";\r\nexport type * from \"./helpers/types\";\r\n\r\n/**\r\n * Node.js cryptography kit (Crypto Node.js API).\r\n *\r\n * Can be imported directly from 'cipher-kit/node' for smaller bundle size.\r\n *\r\n * - Uses Node's `crypto` module.\r\n * - Synchronous API (throwing) + safe wrappers that return `Result` (non-throwing).\r\n * - JSDoc comments with `Explain Like I'm Five` sections.\r\n *\r\n * #### Contains:\r\n * - Secret key creation from passphrase.\r\n * - Data encryption and decryption.\r\n * - Object encryption and decryption.\r\n * - Data hashing (digest).\r\n * - Password hashing and verification with time-safe comparison.\r\n * - Object serialization and deserialization (to/from JSON).\r\n * - Pattern matching to validate encrypted data format.\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * It's like a toolkit that helps you keep your and your users' secrets safe when using Node.js.\r\n */\r\nexport const nodeKit = nodeCryptoKit;\r\n\r\n/**\r\n * Web, Deno, Bun and Cloudflare Workers cryptography kit (Crypto Web API).\r\n *\r\n * Can be imported directly from 'cipher-kit/web-api' for smaller bundle size.\r\n *\r\n * - Uses the Web Crypto API (`crypto.subtle`).\r\n * - Async API (Promise) + safe wrappers that return `Result`.\r\n * - JSDoc comments with `Explain Like I'm Five` sections.\r\n *\r\n * #### Contains:\r\n * - Secret key creation from passphrase.\r\n * - Data encryption and decryption.\r\n * - Object encryption and decryption.\r\n * - Data hashing (digest).\r\n * - Password hashing and verification with time-safe comparison.\r\n * - Object serialization and deserialization (to/from JSON).\r\n * - Pattern matching to validate encrypted data format.\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * It's like a toolkit that helps you keep your and your users' secrets safe when using the web\r\n * or other Node.js alternatives like Deno, Bun, or Cloudflare Workers.\r\n */\r\nexport const webKit = webCryptoKit;\r\n"]}
+{"version":3,"sources":["../src/export.ts"],"names":["kit_exports"],"mappings":";;;;;;;AAsCO,IAAM,OAAA,GAAUA;AAwBhB,IAAM,MAAA,GAASA","file":"index.cjs","sourcesContent":["import * as nodeCryptoKit from \"./node/kit\";\r\nimport * as webCryptoKit from \"./web/kit\";\r\n\r\nexport {\r\n  parseToObj,\r\n  stringifyObj,\r\n  tryParseToObj,\r\n  tryStringifyObj,\r\n} from \"~/helpers/object\";\r\nexport {\r\n  ENCRYPTED_REGEX,\r\n  isNodeSecretKey,\r\n  isWebSecretKey,\r\n  matchEncryptedPattern,\r\n} from \"~/helpers/validate\";\r\nexport type * from \"./helpers/types\";\r\n\r\n/**\r\n * Node.js cryptography kit (Crypto Node.js API).\r\n *\r\n * Can be imported directly from 'cipher-kit/node' for smaller bundle size.\r\n *\r\n * - Uses Node's `crypto` module.\r\n * - Synchronous API (throwing) + safe wrappers that return `Result` (non-throwing).\r\n * - JSDoc comments with `Explain Like I'm Five` sections.\r\n *\r\n * #### Contains:\r\n * - Secret key creation from passphrase.\r\n * - Data encryption and decryption.\r\n * - Object encryption and decryption.\r\n * - Data hashing (digest).\r\n * - Password hashing and verification with time-safe comparison.\r\n * - Object serialization and deserialization (to/from JSON).\r\n * - Pattern matching to validate encrypted data format.\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * It's like a toolkit that helps you keep your and your users' secrets safe when using Node.js.\r\n */\r\nexport const nodeKit = nodeCryptoKit;\r\n\r\n/**\r\n * Web, Deno, Bun and Cloudflare Workers cryptography kit (Crypto Web API).\r\n *\r\n * Can be imported directly from 'cipher-kit/web-api' for smaller bundle size.\r\n *\r\n * - Uses the Web Crypto API (`crypto.subtle`).\r\n * - Async API (Promise) + safe wrappers that return `Result`.\r\n * - JSDoc comments with `Explain Like I'm Five` sections.\r\n *\r\n * #### Contains:\r\n * - Secret key creation from passphrase.\r\n * - Data encryption and decryption.\r\n * - Object encryption and decryption.\r\n * - Data hashing (digest).\r\n * - Password hashing and verification with time-safe comparison.\r\n * - Object serialization and deserialization (to/from JSON).\r\n * - Pattern matching to validate encrypted data format.\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * It's like a toolkit that helps you keep your and your users' secrets safe when using the web\r\n * or other Node.js alternatives like Deno, Bun, or Cloudflare Workers.\r\n */\r\nexport const webKit = webCryptoKit;\r\n"]}

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { n as nodeCryptoKit } from './export-DO9n7Np-.cjs';
-import { w as webCryptoKit } from './export-CpZ7s25O.cjs';
-export { C as CipherEncoding, d as CreateSecretKeyOptions, f as DecryptOptions, D as DigestAlgorithm, E as ENCRYPTED_REGEX, b as Encoding, e as EncryptOptions, c as EncryptionAlgorithm, H as HashOptions, g as HashPasswordOptions, S as SecretKey, V as VerifyPasswordOptions, m as matchEncryptedPattern, p as parseToObj, s as stringifyObj, t as tryParseToObj, a as tryStringifyObj } from './validate-cJEdGlj1.cjs';
+import { n as nodeCryptoKit } from './export-KFT0YyMg.cjs';
+import { w as webCryptoKit } from './export-FYHgb-8E.cjs';
+export { C as CipherEncoding, e as CreateSecretKeyOptions, g as DecryptOptions, D as DigestAlgorithm, E as ENCRYPTED_REGEX, c as Encoding, f as EncryptOptions, d as EncryptionAlgorithm, H as HashOptions, h as HashPasswordOptions, N as NodeSecretKey, V as VerifyPasswordOptions, W as WebSecretKey, i as isNodeSecretKey, b as isWebSecretKey, m as matchEncryptedPattern, p as parseToObj, s as stringifyObj, t as tryParseToObj, a as tryStringifyObj } from './validate-lkJAHCeJ.cjs';
 import 'node:buffer';
 import 'node:crypto';
 

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { n as nodeCryptoKit } from './export-DUgIcobC.js';
-import { w as webCryptoKit } from './export-C4DbO5zM.js';
-export { C as CipherEncoding, d as CreateSecretKeyOptions, f as DecryptOptions, D as DigestAlgorithm, E as ENCRYPTED_REGEX, b as Encoding, e as EncryptOptions, c as EncryptionAlgorithm, H as HashOptions, g as HashPasswordOptions, S as SecretKey, V as VerifyPasswordOptions, m as matchEncryptedPattern, p as parseToObj, s as stringifyObj, t as tryParseToObj, a as tryStringifyObj } from './validate-cJEdGlj1.js';
+import { n as nodeCryptoKit } from './export-BaM_OTFk.js';
+import { w as webCryptoKit } from './export-CCTGAosO.js';
+export { C as CipherEncoding, e as CreateSecretKeyOptions, g as DecryptOptions, D as DigestAlgorithm, E as ENCRYPTED_REGEX, c as Encoding, f as EncryptOptions, d as EncryptionAlgorithm, H as HashOptions, h as HashPasswordOptions, N as NodeSecretKey, V as VerifyPasswordOptions, W as WebSecretKey, i as isNodeSecretKey, b as isWebSecretKey, m as matchEncryptedPattern, p as parseToObj, s as stringifyObj, t as tryParseToObj, a as tryStringifyObj } from './validate-lkJAHCeJ.js';
 import 'node:buffer';
 import 'node:crypto';
 

package/dist/index.js

@@ -1,6 +1,6 @@
-import { kit_exports } from './chunk-PWTFVMW6.js';
-import { kit_exports as kit_exports$1 } from './chunk-FSEA3UXJ.js';
-export { ENCRYPTED_REGEX, matchEncryptedPattern, parseToObj, stringifyObj, tryParseToObj, tryStringifyObj } from './chunk-6C4NIWQ4.js';
+import { kit_exports } from './chunk-S6SNCTU6.js';
+import { kit_exports as kit_exports$1 } from './chunk-JLFVTZY4.js';
+export { ENCRYPTED_REGEX, isNodeSecretKey, isWebSecretKey, matchEncryptedPattern, parseToObj, stringifyObj, tryParseToObj, tryStringifyObj } from './chunk-LU7QOSQH.js';
 
 // src/export.ts
 var nodeKit = kit_exports;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/export.ts"],"names":["kit_exports"],"mappings":";;;;;AAoCO,IAAM,OAAA,GAAU;AAwBhB,IAAM,MAAA,GAASA","file":"index.js","sourcesContent":["import * as nodeCryptoKit from \"./node/kit\";\r\nimport * as webCryptoKit from \"./web/kit\";\r\n\r\nexport {\r\n  parseToObj,\r\n  stringifyObj,\r\n  tryParseToObj,\r\n  tryStringifyObj,\r\n} from \"~/helpers/object\";\r\nexport {\r\n  ENCRYPTED_REGEX,\r\n  matchEncryptedPattern,\r\n} from \"~/helpers/validate\";\r\nexport type * from \"./helpers/types\";\r\n\r\n/**\r\n * Node.js cryptography kit (Crypto Node.js API).\r\n *\r\n * Can be imported directly from 'cipher-kit/node' for smaller bundle size.\r\n *\r\n * - Uses Node's `crypto` module.\r\n * - Synchronous API (throwing) + safe wrappers that return `Result` (non-throwing).\r\n * - JSDoc comments with `Explain Like I'm Five` sections.\r\n *\r\n * #### Contains:\r\n * - Secret key creation from passphrase.\r\n * - Data encryption and decryption.\r\n * - Object encryption and decryption.\r\n * - Data hashing (digest).\r\n * - Password hashing and verification with time-safe comparison.\r\n * - Object serialization and deserialization (to/from JSON).\r\n * - Pattern matching to validate encrypted data format.\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * It's like a toolkit that helps you keep your and your users' secrets safe when using Node.js.\r\n */\r\nexport const nodeKit = nodeCryptoKit;\r\n\r\n/**\r\n * Web, Deno, Bun and Cloudflare Workers cryptography kit (Crypto Web API).\r\n *\r\n * Can be imported directly from 'cipher-kit/web-api' for smaller bundle size.\r\n *\r\n * - Uses the Web Crypto API (`crypto.subtle`).\r\n * - Async API (Promise) + safe wrappers that return `Result`.\r\n * - JSDoc comments with `Explain Like I'm Five` sections.\r\n *\r\n * #### Contains:\r\n * - Secret key creation from passphrase.\r\n * - Data encryption and decryption.\r\n * - Object encryption and decryption.\r\n * - Data hashing (digest).\r\n * - Password hashing and verification with time-safe comparison.\r\n * - Object serialization and deserialization (to/from JSON).\r\n * - Pattern matching to validate encrypted data format.\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * It's like a toolkit that helps you keep your and your users' secrets safe when using the web\r\n * or other Node.js alternatives like Deno, Bun, or Cloudflare Workers.\r\n */\r\nexport const webKit = webCryptoKit;\r\n"]}
+{"version":3,"sources":["../src/export.ts"],"names":["kit_exports"],"mappings":";;;;;AAsCO,IAAM,OAAA,GAAU;AAwBhB,IAAM,MAAA,GAASA","file":"index.js","sourcesContent":["import * as nodeCryptoKit from \"./node/kit\";\r\nimport * as webCryptoKit from \"./web/kit\";\r\n\r\nexport {\r\n  parseToObj,\r\n  stringifyObj,\r\n  tryParseToObj,\r\n  tryStringifyObj,\r\n} from \"~/helpers/object\";\r\nexport {\r\n  ENCRYPTED_REGEX,\r\n  isNodeSecretKey,\r\n  isWebSecretKey,\r\n  matchEncryptedPattern,\r\n} from \"~/helpers/validate\";\r\nexport type * from \"./helpers/types\";\r\n\r\n/**\r\n * Node.js cryptography kit (Crypto Node.js API).\r\n *\r\n * Can be imported directly from 'cipher-kit/node' for smaller bundle size.\r\n *\r\n * - Uses Node's `crypto` module.\r\n * - Synchronous API (throwing) + safe wrappers that return `Result` (non-throwing).\r\n * - JSDoc comments with `Explain Like I'm Five` sections.\r\n *\r\n * #### Contains:\r\n * - Secret key creation from passphrase.\r\n * - Data encryption and decryption.\r\n * - Object encryption and decryption.\r\n * - Data hashing (digest).\r\n * - Password hashing and verification with time-safe comparison.\r\n * - Object serialization and deserialization (to/from JSON).\r\n * - Pattern matching to validate encrypted data format.\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * It's like a toolkit that helps you keep your and your users' secrets safe when using Node.js.\r\n */\r\nexport const nodeKit = nodeCryptoKit;\r\n\r\n/**\r\n * Web, Deno, Bun and Cloudflare Workers cryptography kit (Crypto Web API).\r\n *\r\n * Can be imported directly from 'cipher-kit/web-api' for smaller bundle size.\r\n *\r\n * - Uses the Web Crypto API (`crypto.subtle`).\r\n * - Async API (Promise) + safe wrappers that return `Result`.\r\n * - JSDoc comments with `Explain Like I'm Five` sections.\r\n *\r\n * #### Contains:\r\n * - Secret key creation from passphrase.\r\n * - Data encryption and decryption.\r\n * - Object encryption and decryption.\r\n * - Data hashing (digest).\r\n * - Password hashing and verification with time-safe comparison.\r\n * - Object serialization and deserialization (to/from JSON).\r\n * - Pattern matching to validate encrypted data format.\r\n *\r\n * ### 🍼 Explain Like I'm Five\r\n * It's like a toolkit that helps you keep your and your users' secrets safe when using the web\r\n * or other Node.js alternatives like Deno, Bun, or Cloudflare Workers.\r\n */\r\nexport const webKit = webCryptoKit;\r\n"]}

package/dist/node.cjs

@@ -1,129 +1,129 @@
 'use strict';
 
-var chunk56PVVFVM_cjs = require('./chunk-56PVVFVM.cjs');
-var chunkX4CS7UXE_cjs = require('./chunk-X4CS7UXE.cjs');
+var chunkZNM5M6RD_cjs = require('./chunk-ZNM5M6RD.cjs');
+var chunkHTRGOBZF_cjs = require('./chunk-HTRGOBZF.cjs');
 
 
 
 Object.defineProperty(exports, "convertBytesToStr", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.convertBytesToStr; }
+  get: function () { return chunkZNM5M6RD_cjs.convertBytesToStr; }
 });
 Object.defineProperty(exports, "convertEncoding", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.convertEncoding; }
+  get: function () { return chunkZNM5M6RD_cjs.convertEncoding; }
 });
 Object.defineProperty(exports, "convertStrToBytes", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.convertStrToBytes; }
+  get: function () { return chunkZNM5M6RD_cjs.convertStrToBytes; }
 });
 Object.defineProperty(exports, "createSecretKey", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.createSecretKey; }
+  get: function () { return chunkZNM5M6RD_cjs.createSecretKey; }
 });
 Object.defineProperty(exports, "decrypt", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.decrypt; }
+  get: function () { return chunkZNM5M6RD_cjs.decrypt; }
 });
 Object.defineProperty(exports, "decryptObj", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.decryptObj; }
+  get: function () { return chunkZNM5M6RD_cjs.decryptObj; }
 });
 Object.defineProperty(exports, "encrypt", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.encrypt; }
+  get: function () { return chunkZNM5M6RD_cjs.encrypt; }
 });
 Object.defineProperty(exports, "encryptObj", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.encryptObj; }
+  get: function () { return chunkZNM5M6RD_cjs.encryptObj; }
 });
 Object.defineProperty(exports, "generateUuid", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.generateUuid; }
+  get: function () { return chunkZNM5M6RD_cjs.generateUuid; }
 });
 Object.defineProperty(exports, "hash", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.hash; }
+  get: function () { return chunkZNM5M6RD_cjs.hash; }
 });
 Object.defineProperty(exports, "hashPassword", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.hashPassword; }
-});
-Object.defineProperty(exports, "isNodeSecretKey", {
-  enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.isNodeSecretKey; }
+  get: function () { return chunkZNM5M6RD_cjs.hashPassword; }
 });
 Object.defineProperty(exports, "tryConvertBytesToStr", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.tryConvertBytesToStr; }
+  get: function () { return chunkZNM5M6RD_cjs.tryConvertBytesToStr; }
 });
 Object.defineProperty(exports, "tryConvertEncoding", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.tryConvertEncoding; }
+  get: function () { return chunkZNM5M6RD_cjs.tryConvertEncoding; }
 });
 Object.defineProperty(exports, "tryConvertStrToBytes", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.tryConvertStrToBytes; }
+  get: function () { return chunkZNM5M6RD_cjs.tryConvertStrToBytes; }
 });
 Object.defineProperty(exports, "tryCreateSecretKey", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.tryCreateSecretKey; }
+  get: function () { return chunkZNM5M6RD_cjs.tryCreateSecretKey; }
 });
 Object.defineProperty(exports, "tryDecrypt", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.tryDecrypt; }
+  get: function () { return chunkZNM5M6RD_cjs.tryDecrypt; }
 });
 Object.defineProperty(exports, "tryDecryptObj", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.tryDecryptObj; }
+  get: function () { return chunkZNM5M6RD_cjs.tryDecryptObj; }
 });
 Object.defineProperty(exports, "tryEncrypt", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.tryEncrypt; }
+  get: function () { return chunkZNM5M6RD_cjs.tryEncrypt; }
 });
 Object.defineProperty(exports, "tryEncryptObj", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.tryEncryptObj; }
+  get: function () { return chunkZNM5M6RD_cjs.tryEncryptObj; }
 });
 Object.defineProperty(exports, "tryGenerateUuid", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.tryGenerateUuid; }
+  get: function () { return chunkZNM5M6RD_cjs.tryGenerateUuid; }
 });
 Object.defineProperty(exports, "tryHash", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.tryHash; }
+  get: function () { return chunkZNM5M6RD_cjs.tryHash; }
 });
 Object.defineProperty(exports, "tryHashPassword", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.tryHashPassword; }
+  get: function () { return chunkZNM5M6RD_cjs.tryHashPassword; }
 });
 Object.defineProperty(exports, "verifyPassword", {
   enumerable: true,
-  get: function () { return chunk56PVVFVM_cjs.verifyPassword; }
+  get: function () { return chunkZNM5M6RD_cjs.verifyPassword; }
 });
 Object.defineProperty(exports, "ENCRYPTED_REGEX", {
   enumerable: true,
-  get: function () { return chunkX4CS7UXE_cjs.ENCRYPTED_REGEX; }
+  get: function () { return chunkHTRGOBZF_cjs.ENCRYPTED_REGEX; }
+});
+Object.defineProperty(exports, "isNodeSecretKey", {
+  enumerable: true,
+  get: function () { return chunkHTRGOBZF_cjs.isNodeSecretKey; }
 });
 Object.defineProperty(exports, "matchEncryptedPattern", {
   enumerable: true,
-  get: function () { return chunkX4CS7UXE_cjs.matchEncryptedPattern; }
+  get: function () { return chunkHTRGOBZF_cjs.matchEncryptedPattern; }
 });
 Object.defineProperty(exports, "parseToObj", {
   enumerable: true,
-  get: function () { return chunkX4CS7UXE_cjs.parseToObj; }
+  get: function () { return chunkHTRGOBZF_cjs.parseToObj; }
 });
 Object.defineProperty(exports, "stringifyObj", {
   enumerable: true,
-  get: function () { return chunkX4CS7UXE_cjs.stringifyObj; }
+  get: function () { return chunkHTRGOBZF_cjs.stringifyObj; }
 });
 Object.defineProperty(exports, "tryParseToObj", {
   enumerable: true,
-  get: function () { return chunkX4CS7UXE_cjs.tryParseToObj; }
+  get: function () { return chunkHTRGOBZF_cjs.tryParseToObj; }
 });
 Object.defineProperty(exports, "tryStringifyObj", {
   enumerable: true,
-  get: function () { return chunkX4CS7UXE_cjs.tryStringifyObj; }
+  get: function () { return chunkHTRGOBZF_cjs.tryStringifyObj; }
 });
 //# sourceMappingURL=node.cjs.map
 //# sourceMappingURL=node.cjs.map

package/dist/node.d.cts

@@ -1,4 +1,4 @@
-export { C as CipherEncoding, d as CreateSecretKeyOptions, f as DecryptOptions, D as DigestAlgorithm, E as ENCRYPTED_REGEX, b as Encoding, e as EncryptOptions, c as EncryptionAlgorithm, H as HashOptions, g as HashPasswordOptions, S as SecretKey, V as VerifyPasswordOptions, m as matchEncryptedPattern, p as parseToObj, s as stringifyObj, t as tryParseToObj, a as tryStringifyObj } from './validate-cJEdGlj1.cjs';
-export { w as convertBytesToStr, y as convertEncoding, s as convertStrToBytes, c as createSecretKey, f as decrypt, l as decryptObj, e as encrypt, j as encryptObj, g as generateUuid, o as hash, q as hashPassword, i as isNodeSecretKey, u as tryConvertBytesToStr, x as tryConvertEncoding, r as tryConvertStrToBytes, a as tryCreateSecretKey, d as tryDecrypt, k as tryDecryptObj, b as tryEncrypt, h as tryEncryptObj, t as tryGenerateUuid, m as tryHash, p as tryHashPassword, v as verifyPassword } from './export-DO9n7Np-.cjs';
+export { C as CipherEncoding, e as CreateSecretKeyOptions, g as DecryptOptions, D as DigestAlgorithm, E as ENCRYPTED_REGEX, c as Encoding, f as EncryptOptions, d as EncryptionAlgorithm, H as HashOptions, h as HashPasswordOptions, N as NodeSecretKey, V as VerifyPasswordOptions, W as WebSecretKey, i as isNodeSecretKey, m as matchEncryptedPattern, p as parseToObj, s as stringifyObj, t as tryParseToObj, a as tryStringifyObj } from './validate-lkJAHCeJ.cjs';
+export { u as convertBytesToStr, x as convertEncoding, r as convertStrToBytes, c as createSecretKey, f as decrypt, k as decryptObj, e as encrypt, i as encryptObj, g as generateUuid, m as hash, p as hashPassword, s as tryConvertBytesToStr, w as tryConvertEncoding, q as tryConvertStrToBytes, a as tryCreateSecretKey, d as tryDecrypt, j as tryDecryptObj, b as tryEncrypt, h as tryEncryptObj, t as tryGenerateUuid, l as tryHash, o as tryHashPassword, v as verifyPassword } from './export-KFT0YyMg.cjs';
 import 'node:crypto';
 import 'node:buffer';

package/dist/node.d.ts

@@ -1,4 +1,4 @@
-export { C as CipherEncoding, d as CreateSecretKeyOptions, f as DecryptOptions, D as DigestAlgorithm, E as ENCRYPTED_REGEX, b as Encoding, e as EncryptOptions, c as EncryptionAlgorithm, H as HashOptions, g as HashPasswordOptions, S as SecretKey, V as VerifyPasswordOptions, m as matchEncryptedPattern, p as parseToObj, s as stringifyObj, t as tryParseToObj, a as tryStringifyObj } from './validate-cJEdGlj1.js';
-export { w as convertBytesToStr, y as convertEncoding, s as convertStrToBytes, c as createSecretKey, f as decrypt, l as decryptObj, e as encrypt, j as encryptObj, g as generateUuid, o as hash, q as hashPassword, i as isNodeSecretKey, u as tryConvertBytesToStr, x as tryConvertEncoding, r as tryConvertStrToBytes, a as tryCreateSecretKey, d as tryDecrypt, k as tryDecryptObj, b as tryEncrypt, h as tryEncryptObj, t as tryGenerateUuid, m as tryHash, p as tryHashPassword, v as verifyPassword } from './export-DUgIcobC.js';
+export { C as CipherEncoding, e as CreateSecretKeyOptions, g as DecryptOptions, D as DigestAlgorithm, E as ENCRYPTED_REGEX, c as Encoding, f as EncryptOptions, d as EncryptionAlgorithm, H as HashOptions, h as HashPasswordOptions, N as NodeSecretKey, V as VerifyPasswordOptions, W as WebSecretKey, i as isNodeSecretKey, m as matchEncryptedPattern, p as parseToObj, s as stringifyObj, t as tryParseToObj, a as tryStringifyObj } from './validate-lkJAHCeJ.js';
+export { u as convertBytesToStr, x as convertEncoding, r as convertStrToBytes, c as createSecretKey, f as decrypt, k as decryptObj, e as encrypt, i as encryptObj, g as generateUuid, m as hash, p as hashPassword, s as tryConvertBytesToStr, w as tryConvertEncoding, q as tryConvertStrToBytes, a as tryCreateSecretKey, d as tryDecrypt, j as tryDecryptObj, b as tryEncrypt, h as tryEncryptObj, t as tryGenerateUuid, l as tryHash, o as tryHashPassword, v as verifyPassword } from './export-BaM_OTFk.js';
 import 'node:crypto';
 import 'node:buffer';

package/dist/node.js

@@ -1,4 +1,4 @@
-export { convertBytesToStr, convertEncoding, convertStrToBytes, createSecretKey, decrypt, decryptObj, encrypt, encryptObj, generateUuid, hash, hashPassword, isNodeSecretKey, tryConvertBytesToStr, tryConvertEncoding, tryConvertStrToBytes, tryCreateSecretKey, tryDecrypt, tryDecryptObj, tryEncrypt, tryEncryptObj, tryGenerateUuid, tryHash, tryHashPassword, verifyPassword } from './chunk-PWTFVMW6.js';
-export { ENCRYPTED_REGEX, matchEncryptedPattern, parseToObj, stringifyObj, tryParseToObj, tryStringifyObj } from './chunk-6C4NIWQ4.js';
+export { convertBytesToStr, convertEncoding, convertStrToBytes, createSecretKey, decrypt, decryptObj, encrypt, encryptObj, generateUuid, hash, hashPassword, tryConvertBytesToStr, tryConvertEncoding, tryConvertStrToBytes, tryCreateSecretKey, tryDecrypt, tryDecryptObj, tryEncrypt, tryEncryptObj, tryGenerateUuid, tryHash, tryHashPassword, verifyPassword } from './chunk-S6SNCTU6.js';
+export { ENCRYPTED_REGEX, isNodeSecretKey, matchEncryptedPattern, parseToObj, stringifyObj, tryParseToObj, tryStringifyObj } from './chunk-LU7QOSQH.js';
 //# sourceMappingURL=node.js.map
 //# sourceMappingURL=node.js.map

package/dist/{validate-cJEdGlj1.d.cts → validate-lkJAHCeJ.d.cts}

@@ -91,19 +91,9 @@ declare const ENCRYPTION_ALGORITHMS: Readonly<{
 }>;
 
 declare const __brand: unique symbol;
-/** A brand type to distinguish between different types */
 type Brand<T> = {
     readonly [__brand]: T;
 };
-/**
- * A platform-specific secret key for encryption/decryption.
- *
- * ### 🍼 Explain Like I'm Five
- * You have a treasure (your secret data) and want to keep it safe.
- * For that you create a key (the secret key) and lock your treasure with it.
- *
- * @template Platform - 'web' or 'node' to specify the platform of the secret key.
- */
 type SecretKey<Platform extends "web" | "node"> = {
     /** The platform the key is for ('web' or 'node'). */
     readonly platform: Platform;
@@ -114,6 +104,10 @@ type SecretKey<Platform extends "web" | "node"> = {
     /** The actual secret key object (CryptoKey for web, KeyObject for node). */
     readonly key: Platform extends "web" ? webcrypto.CryptoKey : nodeCrypto.KeyObject;
 } & Brand<`secretKey-${Platform}`>;
+/** A secret key for Node.js platform. */
+type NodeSecretKey = SecretKey<"node">;
+/** A secret key for Web platform. */
+type WebSecretKey = SecretKey<"web">;
 /** Supported **cipher text** encodings for encrypted/hash outputs. */
 type CipherEncoding = (typeof CIPHER_ENCODING)[number];
 /** Supported data encodings for **plain text/bytes** conversions. */
@@ -320,6 +314,40 @@ declare function tryParseToObj<T extends object = Record<string, unknown>>(str:
  */
 declare function parseToObj<T extends object = Record<string, unknown>>(str: string): T;
 
+/**
+ * Type guard to check if the provided value is a SecretKey object for Node.js environment.
+ *
+ * ### 🍼 Explain Like I'm Five
+ * Checking if the key in your hand is the right kind of key for the lock.
+ *
+ * @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 NodeSecretKey;
+/**
+ * Type guard to check if the provided value is a SecretKey object for Web (Deno, Bun, Cloudflare included) environment.
+ *
+ * ### 🍼 Explain Like I'm Five
+ * Checking if the key in your hand is the right kind of key for the lock.
+ *
+ * @param x - The value to check.
+ * @returns True if the value is a SecretKey object for Web, false otherwise.
+ *
+ * @example
+ * ```ts
+ * isWebSecretKey(webKey); // true
+ * isWebSecretKey(nodeKey); // false
+ * isWebSecretKey({}); // false
+ * ```
+ */
+declare function isWebSecretKey(x: unknown): x is WebSecretKey;
 /**
  * Regular expressions for encrypted data patterns.
  *
@@ -368,4 +396,4 @@ declare const ENCRYPTED_REGEX: Readonly<{
  */
 declare function matchEncryptedPattern(data: string, format: "node" | "web" | "general"): boolean;
 
-export { type CipherEncoding as C, type DigestAlgorithm as D, ENCRYPTED_REGEX as E, type HashOptions as H, type Result as R, type SecretKey as S, type VerifyPasswordOptions as V, tryStringifyObj as a, type Encoding as b, type EncryptionAlgorithm as c, type CreateSecretKeyOptions as d, type EncryptOptions as e, type DecryptOptions as f, type HashPasswordOptions as g, matchEncryptedPattern as m, parseToObj as p, stringifyObj as s, tryParseToObj as t };
+export { type CipherEncoding as C, type DigestAlgorithm as D, ENCRYPTED_REGEX as E, type HashOptions as H, type NodeSecretKey as N, type Result as R, type VerifyPasswordOptions as V, type WebSecretKey as W, tryStringifyObj as a, isWebSecretKey as b, type Encoding as c, type EncryptionAlgorithm as d, type CreateSecretKeyOptions as e, type EncryptOptions as f, type DecryptOptions as g, type HashPasswordOptions as h, isNodeSecretKey as i, matchEncryptedPattern as m, parseToObj as p, stringifyObj as s, tryParseToObj as t };

package/dist/{validate-cJEdGlj1.d.ts → validate-lkJAHCeJ.d.ts}

@@ -91,19 +91,9 @@ declare const ENCRYPTION_ALGORITHMS: Readonly<{
 }>;
 
 declare const __brand: unique symbol;
-/** A brand type to distinguish between different types */
 type Brand<T> = {
     readonly [__brand]: T;
 };
-/**
- * A platform-specific secret key for encryption/decryption.
- *
- * ### 🍼 Explain Like I'm Five
- * You have a treasure (your secret data) and want to keep it safe.
- * For that you create a key (the secret key) and lock your treasure with it.
- *
- * @template Platform - 'web' or 'node' to specify the platform of the secret key.
- */
 type SecretKey<Platform extends "web" | "node"> = {
     /** The platform the key is for ('web' or 'node'). */
     readonly platform: Platform;
@@ -114,6 +104,10 @@ type SecretKey<Platform extends "web" | "node"> = {
     /** The actual secret key object (CryptoKey for web, KeyObject for node). */
     readonly key: Platform extends "web" ? webcrypto.CryptoKey : nodeCrypto.KeyObject;
 } & Brand<`secretKey-${Platform}`>;
+/** A secret key for Node.js platform. */
+type NodeSecretKey = SecretKey<"node">;
+/** A secret key for Web platform. */
+type WebSecretKey = SecretKey<"web">;
 /** Supported **cipher text** encodings for encrypted/hash outputs. */
 type CipherEncoding = (typeof CIPHER_ENCODING)[number];
 /** Supported data encodings for **plain text/bytes** conversions. */
@@ -320,6 +314,40 @@ declare function tryParseToObj<T extends object = Record<string, unknown>>(str:
  */
 declare function parseToObj<T extends object = Record<string, unknown>>(str: string): T;
 
+/**
+ * Type guard to check if the provided value is a SecretKey object for Node.js environment.
+ *
+ * ### 🍼 Explain Like I'm Five
+ * Checking if the key in your hand is the right kind of key for the lock.
+ *
+ * @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 NodeSecretKey;
+/**
+ * Type guard to check if the provided value is a SecretKey object for Web (Deno, Bun, Cloudflare included) environment.
+ *
+ * ### 🍼 Explain Like I'm Five
+ * Checking if the key in your hand is the right kind of key for the lock.
+ *
+ * @param x - The value to check.
+ * @returns True if the value is a SecretKey object for Web, false otherwise.
+ *
+ * @example
+ * ```ts
+ * isWebSecretKey(webKey); // true
+ * isWebSecretKey(nodeKey); // false
+ * isWebSecretKey({}); // false
+ * ```
+ */
+declare function isWebSecretKey(x: unknown): x is WebSecretKey;
 /**
  * Regular expressions for encrypted data patterns.
  *
@@ -368,4 +396,4 @@ declare const ENCRYPTED_REGEX: Readonly<{
  */
 declare function matchEncryptedPattern(data: string, format: "node" | "web" | "general"): boolean;
 
-export { type CipherEncoding as C, type DigestAlgorithm as D, ENCRYPTED_REGEX as E, type HashOptions as H, type Result as R, type SecretKey as S, type VerifyPasswordOptions as V, tryStringifyObj as a, type Encoding as b, type EncryptionAlgorithm as c, type CreateSecretKeyOptions as d, type EncryptOptions as e, type DecryptOptions as f, type HashPasswordOptions as g, matchEncryptedPattern as m, parseToObj as p, stringifyObj as s, tryParseToObj as t };
+export { type CipherEncoding as C, type DigestAlgorithm as D, ENCRYPTED_REGEX as E, type HashOptions as H, type NodeSecretKey as N, type Result as R, type VerifyPasswordOptions as V, type WebSecretKey as W, tryStringifyObj as a, isWebSecretKey as b, type Encoding as c, type EncryptionAlgorithm as d, type CreateSecretKeyOptions as e, type EncryptOptions as f, type DecryptOptions as g, type HashPasswordOptions as h, isNodeSecretKey as i, matchEncryptedPattern as m, parseToObj as p, stringifyObj as s, tryParseToObj as t };