unjwt 0.4.0 → 0.5.0

package/dist/shared/unjwt.DKq5VF7t.mjs

@@ -0,0 +1,1186 @@
+import { g as isCryptoKey, e as concatUint8Arrays, b as base64UrlEncode, t as textEncoder, r as randomBytes, a as isJWK, d as base64UrlDecode } from './unjwt.CjHZv3F3.mjs';
+
+/**
+ * This is a fork of Jose library's utility functions.
+ * @source https://github.com/panva/jose/tree/69b7960c67e05be55fa2ec31c74b987696c20c60/src/lib/buffer_utils.ts
+ * @license MIT https://github.com/panva/jose/blob/69b7960c67e05be55fa2ec31c74b987696c20c60/LICENSE.md
+ */
+const MAX_INT32 = 2 ** 32;
+function writeUInt32BE(buf, value, offset) {
+  if (value < 0 || value >= MAX_INT32) {
+    throw new RangeError(
+      `value must be >= 0 and <= ${MAX_INT32 - 1}. Received ${value}`
+    );
+  }
+  buf.set([value >>> 24, value >>> 16, value >>> 8, value & 255], offset);
+}
+function uint64be(value) {
+  const high = Math.floor(value / MAX_INT32);
+  const low = value % MAX_INT32;
+  const buf = new Uint8Array(8);
+  writeUInt32BE(buf, high, 0);
+  writeUInt32BE(buf, low, 4);
+  return buf;
+}
+function uint32be(value) {
+  const buf = new Uint8Array(4);
+  writeUInt32BE(buf, value);
+  return buf;
+}
+
+/**
+ * This is a fork of Jose library's utility functions.
+ * @source https://github.com/panva/jose/tree/69b7960c67e05be55fa2ec31c74b987696c20c60/src/lib/cek.ts
+ * @source https://github.com/panva/jose/tree/69b7960c67e05be55fa2ec31c74b987696c20c60/src/lib/iv.ts
+ * @license MIT https://github.com/panva/jose/blob/69b7960c67e05be55fa2ec31c74b987696c20c60/LICENSE.md
+ */
+function bitLengthIV(alg) {
+  switch (alg) {
+    case "A128GCM":
+    case "A128GCMKW":
+    case "A192GCM":
+    case "A192GCMKW":
+    case "A256GCM":
+    case "A256GCMKW": {
+      return 96;
+    }
+    case "A128CBC-HS256":
+    case "A192CBC-HS384":
+    case "A256CBC-HS512": {
+      return 128;
+    }
+    default: {
+      throw new Error(`Unsupported JWE Algorithm: ${alg}`);
+    }
+  }
+}
+function generateIV(alg) {
+  return crypto.getRandomValues(new Uint8Array(bitLengthIV(alg) >> 3));
+}
+function checkIvLength(enc, iv) {
+  if (iv.length << 3 !== bitLengthIV(enc)) {
+    throw new Error("Invalid Initialization Vector length");
+  }
+}
+function bitLengthCEK(alg) {
+  switch (alg) {
+    case "A128GCM": {
+      return 128;
+    }
+    case "A192GCM": {
+      return 192;
+    }
+    case "A256GCM":
+    case "A128CBC-HS256": {
+      return 256;
+    }
+    case "A192CBC-HS384": {
+      return 384;
+    }
+    case "A256CBC-HS512": {
+      return 512;
+    }
+    default: {
+      throw new Error(`Unsupported JWE Algorithm: ${alg}`);
+    }
+  }
+}
+function generateCEK(alg) {
+  return crypto.getRandomValues(new Uint8Array(bitLengthCEK(alg) >> 3));
+}
+function checkCEKLength(cek, expected) {
+  const actual = cek.byteLength << 3;
+  if (actual !== expected) {
+    throw new Error(
+      `Invalid Content Encryption Key length. Expected ${expected} bits, got ${actual} bits`
+    );
+  }
+}
+
+/**
+ * This is a fork of Jose library's utility functions.
+ * @source https://github.com/panva/jose/tree/69b7960c67e05be55fa2ec31c74b987696c20c60/src/lib/crypto_key.ts
+ * @license MIT https://github.com/panva/jose/blob/69b7960c67e05be55fa2ec31c74b987696c20c60/LICENSE.md
+ */
+function unusable(name, prop = "algorithm.name") {
+  return new TypeError(
+    `CryptoKey does not support this operation, its ${prop} must be ${name}`
+  );
+}
+function isAlgorithm(algorithm, name) {
+  return algorithm.name === name;
+}
+function getHashLength(hash) {
+  return Number.parseInt(hash.name.slice(4), 10);
+}
+function getNamedCurve(alg) {
+  switch (alg) {
+    case "ES256": {
+      return "P-256";
+    }
+    case "ES384": {
+      return "P-384";
+    }
+    case "ES512": {
+      return "P-521";
+    }
+    default: {
+      throw new Error("unreachable");
+    }
+  }
+}
+function checkUsage(key, usage) {
+  if (usage && !key.usages.includes(usage)) {
+    throw new TypeError(
+      `CryptoKey does not support this operation, its usages must include ${usage}.`
+    );
+  }
+}
+function checkSigCryptoKey(key, alg, usage) {
+  switch (alg) {
+    case "HS256":
+    case "HS384":
+    case "HS512": {
+      if (!isAlgorithm(key.algorithm, "HMAC"))
+        throw unusable("HMAC");
+      const expected = Number.parseInt(alg.slice(2), 10);
+      const actual = getHashLength(key.algorithm.hash);
+      if (actual !== expected)
+        throw unusable(`SHA-${expected}`, "algorithm.hash");
+      break;
+    }
+    case "RS256":
+    case "RS384":
+    case "RS512": {
+      if (!isAlgorithm(key.algorithm, "RSASSA-PKCS1-v1_5"))
+        throw unusable("RSASSA-PKCS1-v1_5");
+      const expected = Number.parseInt(alg.slice(2), 10);
+      const actual = getHashLength(key.algorithm.hash);
+      if (actual !== expected)
+        throw unusable(`SHA-${expected}`, "algorithm.hash");
+      break;
+    }
+    case "PS256":
+    case "PS384":
+    case "PS512": {
+      if (!isAlgorithm(key.algorithm, "RSA-PSS"))
+        throw unusable("RSA-PSS");
+      const expected = Number.parseInt(alg.slice(2), 10);
+      const actual = getHashLength(key.algorithm.hash);
+      if (actual !== expected)
+        throw unusable(`SHA-${expected}`, "algorithm.hash");
+      break;
+    }
+    case "Ed25519":
+    // Fall through
+    case "EdDSA": {
+      if (!isAlgorithm(key.algorithm, "Ed25519")) throw unusable("Ed25519");
+      break;
+    }
+    case "ES256":
+    case "ES384":
+    case "ES512": {
+      if (!isAlgorithm(key.algorithm, "ECDSA"))
+        throw unusable("ECDSA");
+      const expected = getNamedCurve(alg);
+      const actual = key.algorithm.namedCurve;
+      if (actual !== expected) throw unusable(expected, "algorithm.namedCurve");
+      break;
+    }
+    default: {
+      throw new TypeError("CryptoKey does not support this operation");
+    }
+  }
+  checkUsage(key, usage);
+}
+function checkEncCryptoKey(key, alg, usage) {
+  switch (alg) {
+    case "A128GCM":
+    case "A192GCM":
+    case "A256GCM": {
+      if (!isAlgorithm(key.algorithm, "AES-GCM"))
+        throw unusable("AES-GCM");
+      const expected = Number.parseInt(alg.slice(1, 4), 10);
+      const actual = key.algorithm.length;
+      if (actual !== expected) throw unusable(expected, "algorithm.length");
+      break;
+    }
+    case "A128KW":
+    case "A192KW":
+    case "A256KW": {
+      if (!isAlgorithm(key.algorithm, "AES-KW"))
+        throw unusable("AES-KW");
+      const expected = Number.parseInt(alg.slice(1, 4), 10);
+      const actual = key.algorithm.length;
+      if (actual !== expected) throw unusable(expected, "algorithm.length");
+      break;
+    }
+    case "ECDH": {
+      switch (key.algorithm.name) {
+        case "ECDH":
+        case "X25519": {
+          break;
+        }
+        default: {
+          throw unusable("ECDH or X25519");
+        }
+      }
+      break;
+    }
+    case "PBES2-HS256+A128KW":
+    case "PBES2-HS384+A192KW":
+    case "PBES2-HS512+A256KW": {
+      if (!isAlgorithm(key.algorithm, "PBKDF2")) throw unusable("PBKDF2");
+      break;
+    }
+    case "RSA-OAEP":
+    case "RSA-OAEP-256":
+    case "RSA-OAEP-384":
+    case "RSA-OAEP-512": {
+      if (!isAlgorithm(key.algorithm, "RSA-OAEP"))
+        throw unusable("RSA-OAEP");
+      const expected = Number.parseInt(alg.slice(9), 10) || 1;
+      const actual = getHashLength(key.algorithm.hash);
+      if (actual !== expected)
+        throw unusable(`SHA-${expected}`, "algorithm.hash");
+      break;
+    }
+    default: {
+      throw new TypeError("CryptoKey does not support this operation");
+    }
+  }
+  checkUsage(key, usage);
+}
+
+/**
+ * This is a fork of Jose library's utility functions.
+ * @source https://github.com/panva/jose/tree/69b7960c67e05be55fa2ec31c74b987696c20c60/src/lib/encrypt.ts
+ * @source https://github.com/panva/jose/tree/69b7960c67e05be55fa2ec31c74b987696c20c60/src/lib/decrypt.ts
+ * @license MIT https://github.com/panva/jose/blob/69b7960c67e05be55fa2ec31c74b987696c20c60/LICENSE.md
+ */
+async function cbcEncrypt(enc, plaintext, cek, iv, aad) {
+  if (!(cek instanceof Uint8Array)) {
+    throw new TypeError(`Key must be ${cek} of type: Uint8Array`);
+  }
+  const keySize = Number.parseInt(enc.slice(1, 4), 10);
+  const encKey = await crypto.subtle.importKey(
+    "raw",
+    cek.subarray(keySize >> 3),
+    "AES-CBC",
+    false,
+    ["encrypt"]
+  );
+  const macKey = await crypto.subtle.importKey(
+    "raw",
+    cek.subarray(0, keySize >> 3),
+    {
+      hash: `SHA-${keySize << 1}`,
+      name: "HMAC"
+    },
+    false,
+    ["sign"]
+  );
+  const ciphertext = new Uint8Array(
+    await crypto.subtle.encrypt(
+      {
+        iv,
+        name: "AES-CBC"
+      },
+      encKey,
+      plaintext
+    )
+  );
+  const macData = concatUint8Arrays(
+    aad,
+    iv,
+    ciphertext,
+    uint64be(aad.length << 3)
+  );
+  const tag = new Uint8Array(
+    (await crypto.subtle.sign("HMAC", macKey, macData)).slice(0, keySize >> 3)
+  );
+  return { ciphertext, tag, iv };
+}
+async function gcmEncrypt(enc, plaintext, cek, iv, aad) {
+  let encKey;
+  if (cek instanceof Uint8Array) {
+    encKey = await crypto.subtle.importKey("raw", cek, "AES-GCM", false, [
+      "encrypt"
+    ]);
+  } else {
+    checkEncCryptoKey(cek, enc, "encrypt");
+    encKey = cek;
+  }
+  const encrypted = new Uint8Array(
+    await crypto.subtle.encrypt(
+      {
+        additionalData: aad,
+        iv,
+        name: "AES-GCM",
+        tagLength: 128
+      },
+      encKey,
+      plaintext
+    )
+  );
+  const tag = encrypted.slice(-16);
+  const ciphertext = encrypted.slice(0, -16);
+  return { ciphertext, tag, iv };
+}
+async function encrypt(enc, plaintext, cek, iv, aad) {
+  if (!isCryptoKey(cek) && !(cek instanceof Uint8Array)) {
+    throw new TypeError(
+      `Key must be ${cek} one of type: CryptoKey, Uint8Array, or JSON Web Key`
+    );
+  }
+  if (iv) {
+    checkIvLength(enc, iv);
+  } else {
+    iv = generateIV(enc);
+  }
+  switch (enc) {
+    case "A128CBC-HS256":
+    case "A192CBC-HS384":
+    case "A256CBC-HS512": {
+      if (cek instanceof Uint8Array) {
+        checkCEKLength(cek, Number.parseInt(enc.slice(-3), 10));
+      }
+      return cbcEncrypt(enc, plaintext, cek, iv, aad);
+    }
+    case "A128GCM":
+    case "A192GCM":
+    case "A256GCM": {
+      if (cek instanceof Uint8Array) {
+        checkCEKLength(cek, Number.parseInt(enc.slice(1, 4), 10));
+      }
+      return gcmEncrypt(enc, plaintext, cek, iv, aad);
+    }
+    default: {
+      throw new Error("Unsupported JWE Content Encryption Algorithm");
+    }
+  }
+}
+async function timingSafeEqual(a, b) {
+  if (!(a instanceof Uint8Array)) {
+    throw new TypeError("First argument must be a buffer");
+  }
+  if (!(b instanceof Uint8Array)) {
+    throw new TypeError("Second argument must be a buffer");
+  }
+  const algorithm = { name: "HMAC", hash: "SHA-256" };
+  const key = await crypto.subtle.generateKey(algorithm, false, [
+    "sign"
+  ]);
+  const aHmac = new Uint8Array(await crypto.subtle.sign(algorithm, key, a));
+  const bHmac = new Uint8Array(await crypto.subtle.sign(algorithm, key, b));
+  let out = 0;
+  let i = -1;
+  while (++i < 32) {
+    out |= aHmac[i] ^ bHmac[i];
+  }
+  return out === 0;
+}
+async function cbcDecrypt(enc, cek, ciphertext, iv, tag, aad) {
+  if (!(cek instanceof Uint8Array)) {
+    throw new TypeError(`Key must be ${cek} of type: Uint8Array`);
+  }
+  const keySize = Number.parseInt(enc.slice(1, 4), 10);
+  const encKey = await crypto.subtle.importKey(
+    "raw",
+    cek.subarray(keySize >> 3),
+    "AES-CBC",
+    false,
+    ["decrypt"]
+  );
+  const macKey = await crypto.subtle.importKey(
+    "raw",
+    cek.subarray(0, keySize >> 3),
+    {
+      hash: `SHA-${keySize << 1}`,
+      name: "HMAC"
+    },
+    false,
+    ["sign"]
+  );
+  const macData = concatUint8Arrays(
+    aad,
+    iv,
+    ciphertext,
+    uint64be(aad.length << 3)
+  );
+  const expectedTag = new Uint8Array(
+    (await crypto.subtle.sign("HMAC", macKey, macData)).slice(0, keySize >> 3)
+  );
+  let macCheckPassed;
+  try {
+    macCheckPassed = await timingSafeEqual(tag, expectedTag);
+  } catch {
+  }
+  if (!macCheckPassed) {
+    throw new Error("JWE Decryption Failed");
+  }
+  let plaintext;
+  try {
+    plaintext = new Uint8Array(
+      await crypto.subtle.decrypt({ iv, name: "AES-CBC" }, encKey, ciphertext)
+    );
+  } catch {
+  }
+  if (!plaintext) {
+    throw new Error("JWE Decryption Failed");
+  }
+  return plaintext;
+}
+async function gcmDecrypt(enc, cek, ciphertext, iv, tag, aad) {
+  let encKey;
+  if (cek instanceof Uint8Array) {
+    encKey = await crypto.subtle.importKey("raw", cek, "AES-GCM", false, [
+      "decrypt"
+    ]);
+  } else {
+    checkEncCryptoKey(cek, enc, "decrypt");
+    encKey = cek;
+  }
+  try {
+    return new Uint8Array(
+      await crypto.subtle.decrypt(
+        {
+          additionalData: aad,
+          iv,
+          name: "AES-GCM",
+          tagLength: 128
+        },
+        encKey,
+        concatUint8Arrays(ciphertext, tag)
+      )
+    );
+  } catch {
+    throw new Error("JWE Decryption Failed");
+  }
+}
+async function decrypt(enc, cek, ciphertext, iv, tag, aad) {
+  if (!isCryptoKey(cek) && !(cek instanceof Uint8Array)) {
+    throw new TypeError(
+      `Key must be ${cek} one of type: CryptoKey, Uint8Array, or JSON Web Key`
+    );
+  }
+  if (!iv) {
+    throw new Error("JWE Initialization Vector missing");
+  }
+  if (!tag) {
+    throw new Error("JWE Authentication Tag missing");
+  }
+  checkIvLength(enc, iv);
+  switch (enc) {
+    case "A128CBC-HS256":
+    case "A192CBC-HS384":
+    case "A256CBC-HS512": {
+      if (cek instanceof Uint8Array)
+        checkCEKLength(cek, Number.parseInt(enc.slice(-3), 10));
+      return cbcDecrypt(enc, cek, ciphertext, iv, tag, aad);
+    }
+    case "A128GCM":
+    case "A192GCM":
+    case "A256GCM": {
+      if (cek instanceof Uint8Array)
+        checkCEKLength(cek, Number.parseInt(enc.slice(1, 4), 10));
+      return gcmDecrypt(enc, cek, ciphertext, iv, tag, aad);
+    }
+    default: {
+      throw new Error("Unsupported JWE Content Encryption Algorithm");
+    }
+  }
+}
+
+/**
+ * This is a fork of Jose library's utility functions.
+ * @source https://github.com/panva/jose/tree/69b7960c67e05be55fa2ec31c74b987696c20c60/src/lib/aesgcmkw.ts
+ * @license MIT https://github.com/panva/jose/blob/69b7960c67e05be55fa2ec31c74b987696c20c60/LICENSE.md
+ */
+async function encryptIV(alg, key, cek, iv) {
+  const jweAlgorithm = alg.slice(0, 7);
+  const wrapped = await encrypt(jweAlgorithm, cek, key, iv, new Uint8Array(0));
+  return {
+    encryptedKey: wrapped.ciphertext,
+    iv: base64UrlEncode(wrapped.iv),
+    tag: base64UrlEncode(wrapped.tag)
+  };
+}
+async function decryptIV(alg, key, encryptedKey, iv, tag) {
+  const jweAlgorithm = alg.slice(0, 7);
+  return decrypt(jweAlgorithm, key, encryptedKey, iv, tag, new Uint8Array(0));
+}
+
+/**
+ * This is a fork of Jose library's utility functions.
+ * @source https://github.com/panva/jose/tree/69b7960c67e05be55fa2ec31c74b987696c20c60/src/lib/jwt_to_key.ts
+ * @license MIT https://github.com/panva/jose/blob/69b7960c67e05be55fa2ec31c74b987696c20c60/LICENSE.md
+ */
+function subtleMapping(jwk) {
+  let algorithm;
+  let keyUsages;
+  switch (jwk.kty) {
+    case "RSA": {
+      switch (jwk.alg) {
+        case "PS256":
+        case "PS384":
+        case "PS512": {
+          algorithm = { name: "RSA-PSS", hash: `SHA-${jwk.alg.slice(-3)}` };
+          keyUsages = jwk.d ? ["sign"] : ["verify"];
+          break;
+        }
+        case "RS256":
+        case "RS384":
+        case "RS512": {
+          algorithm = {
+            name: "RSASSA-PKCS1-v1_5",
+            hash: `SHA-${jwk.alg.slice(-3)}`
+          };
+          keyUsages = jwk.d ? ["sign"] : ["verify"];
+          break;
+        }
+        case "RSA-OAEP":
+        case "RSA-OAEP-256":
+        case "RSA-OAEP-384":
+        case "RSA-OAEP-512": {
+          algorithm = {
+            name: "RSA-OAEP",
+            hash: `SHA-${Number.parseInt(jwk.alg.slice(-3), 10) || 1}`
+          };
+          keyUsages = jwk.d ? ["decrypt", "unwrapKey"] : ["encrypt", "wrapKey"];
+          break;
+        }
+        default: {
+          throw new Error(
+            'Invalid or unsupported JWK "alg" (Algorithm) Parameter value'
+          );
+        }
+      }
+      break;
+    }
+    case "EC": {
+      switch (jwk.alg) {
+        case "ES256": {
+          algorithm = { name: "ECDSA", namedCurve: "P-256" };
+          keyUsages = jwk.d ? ["sign"] : ["verify"];
+          break;
+        }
+        case "ES384": {
+          algorithm = { name: "ECDSA", namedCurve: "P-384" };
+          keyUsages = jwk.d ? ["sign"] : ["verify"];
+          break;
+        }
+        case "ES512": {
+          algorithm = { name: "ECDSA", namedCurve: "P-521" };
+          keyUsages = jwk.d ? ["sign"] : ["verify"];
+          break;
+        }
+        case "ECDH-ES":
+        case "ECDH-ES+A128KW":
+        case "ECDH-ES+A192KW":
+        case "ECDH-ES+A256KW": {
+          algorithm = { name: "ECDH", namedCurve: jwk.crv };
+          keyUsages = jwk.d ? ["deriveBits"] : [];
+          break;
+        }
+        default: {
+          throw new Error(
+            'Invalid or unsupported JWK "alg" (Algorithm) Parameter value'
+          );
+        }
+      }
+      break;
+    }
+    case "OKP": {
+      switch (jwk.alg) {
+        case "Ed25519":
+        // Fall through
+        case "EdDSA": {
+          algorithm = { name: "Ed25519" };
+          keyUsages = jwk.d ? ["sign"] : ["verify"];
+          break;
+        }
+        case "ECDH-ES":
+        case "ECDH-ES+A128KW":
+        case "ECDH-ES+A192KW":
+        case "ECDH-ES+A256KW": {
+          algorithm = { name: jwk.crv };
+          keyUsages = jwk.d ? ["deriveBits"] : [];
+          break;
+        }
+        default: {
+          throw new Error(
+            'Invalid or unsupported JWK "alg" (Algorithm) Parameter value'
+          );
+        }
+      }
+      break;
+    }
+    default: {
+      throw new Error(
+        'Invalid or unsupported JWK "kty" (Key Type) Parameter value'
+      );
+    }
+  }
+  return { algorithm, keyUsages };
+}
+async function jwkTokey(jwk) {
+  if (!jwk.alg) {
+    throw new TypeError(
+      '"alg" argument is required when "jwk.alg" is not present'
+    );
+  }
+  const { algorithm, keyUsages } = subtleMapping(jwk);
+  const keyData = { ...jwk };
+  delete keyData.alg;
+  delete keyData.use;
+  return crypto.subtle.importKey(
+    "jwk",
+    keyData,
+    algorithm,
+    jwk.ext ?? (jwk.d ? false : true),
+    jwk.key_ops ?? keyUsages
+  );
+}
+
+/**
+ * This is a fork of Jose library's utility functions.
+ * @source https://github.com/panva/jose/tree/69b7960c67e05be55fa2ec31c74b987696c20c60/src/lib/key_to_jwt.ts
+ * @license MIT https://github.com/panva/jose/blob/69b7960c67e05be55fa2ec31c74b987696c20c60/LICENSE.md
+ */
+async function keyToJWK(key) {
+  if (key instanceof Uint8Array) {
+    return {
+      kty: "oct",
+      k: base64UrlEncode(key)
+    };
+  }
+  if (!isCryptoKey(key)) {
+    throw new TypeError(
+      `Key must be ${key} one of type: CryptoKey, or Uint8Array`
+    );
+  }
+  if (!key.extractable) {
+    throw new TypeError(
+      "non-extractable CryptoKey cannot be exported as a JWK"
+    );
+  }
+  const jwk = await crypto.subtle.exportKey("jwk", key);
+  return jwk;
+}
+
+/**
+ * This is a fork of Jose library's utility functions.
+ * @source https://github.com/panva/jose/tree/69b7960c67e05be55fa2ec31c74b987696c20c60/src/lib/pbes2kw.ts
+ * @license MIT https://github.com/panva/jose/blob/69b7960c67e05be55fa2ec31c74b987696c20c60/LICENSE.md
+ */
+async function wrap(alg, key, cek, p2c, p2s) {
+  if (p2c && p2s) {
+    const derived = await deriveKey(p2s, alg, p2c, key);
+    const encryptedKey = await _wrap(alg.slice(-6), derived, cek);
+    return { encryptedKey, p2c, p2s: base64UrlEncode(p2s) };
+  } else {
+    const encryptedKey = await _wrap(alg, key, cek);
+    return { encryptedKey };
+  }
+}
+async function unwrap(alg, key, encryptedKey, p2c, p2s) {
+  if (p2c && p2s) {
+    const derived = await deriveKey(p2s, alg, p2c, key);
+    return _unwrap(alg.slice(-6), derived, encryptedKey);
+  } else {
+    return _unwrap(alg, key, encryptedKey);
+  }
+}
+function getCryptoKey(key, alg, options = {}) {
+  const {
+    importAlg = "PBKDF2",
+    extractable = false,
+    usage = "deriveBits"
+  } = options;
+  if (key instanceof Uint8Array) {
+    return crypto.subtle.importKey("raw", key, importAlg, extractable, [usage]);
+  }
+  checkEncCryptoKey(key, alg, usage);
+  return key;
+}
+async function deriveKey(p2s, alg, p2c, key) {
+  if (!(p2s instanceof Uint8Array) || p2s.length < 8) {
+    throw new Error("PBES2 Salt Input must be 8 or more octets");
+  }
+  if (p2c === void 0 || p2c < 1) {
+    throw new Error(
+      "PBES2 Iteration Count Parameter must be a positive integer"
+    );
+  }
+  const salt = concatUint8Arrays(
+    textEncoder.encode(alg),
+    new Uint8Array([0]),
+    p2s
+  );
+  const keylen = Number.parseInt(alg.slice(13, 16), 10);
+  const subtleAlg = {
+    hash: `SHA-${alg.slice(8, 11)}`,
+    iterations: p2c,
+    name: "PBKDF2",
+    salt
+  };
+  const cryptoKey = await getCryptoKey(key, alg);
+  return new Uint8Array(
+    await crypto.subtle.deriveBits(subtleAlg, cryptoKey, keylen)
+  );
+}
+function checkKeySize(key, alg) {
+  if (key.algorithm.length !== Number.parseInt(alg.slice(1, 4), 10)) {
+    throw new TypeError(`Invalid key size for alg: ${alg}`);
+  }
+}
+async function _wrap(alg, key, cek) {
+  const cryptoKey = await getCryptoKey(key, alg, {
+    importAlg: "AES-KW",
+    extractable: true,
+    usage: "wrapKey"
+  });
+  checkKeySize(cryptoKey, alg);
+  const cryptoKeyCek = await crypto.subtle.importKey(
+    "raw",
+    cek,
+    { hash: "SHA-256", name: "HMAC" },
+    true,
+    ["sign"]
+  );
+  return new Uint8Array(
+    await crypto.subtle.wrapKey("raw", cryptoKeyCek, cryptoKey, "AES-KW")
+  );
+}
+async function _unwrap(alg, key, encryptedKey) {
+  const cryptoKey = await getCryptoKey(key, alg, {
+    importAlg: "AES-KW",
+    extractable: true,
+    usage: "unwrapKey"
+  });
+  checkKeySize(cryptoKey, alg);
+  const cryptoKeyCek = await crypto.subtle.unwrapKey(
+    "raw",
+    encryptedKey,
+    cryptoKey,
+    "AES-KW",
+    { hash: "SHA-256", name: "HMAC" },
+    true,
+    ["sign"]
+  );
+  return new Uint8Array(await crypto.subtle.exportKey("raw", cryptoKeyCek));
+}
+
+async function generateKey(alg, options = {}) {
+  const exportToJWK = options.toJWK === true;
+  const defaultExtractable = options.extractable !== false;
+  if (alg === "A128CBC-HS256" || alg === "A192CBC-HS384" || alg === "A256CBC-HS512") {
+    const keyLength = bitLengthCEK(alg);
+    const keyBytes = randomBytes(keyLength >> 3);
+    if (exportToJWK) {
+      return keyToJWK(keyBytes);
+    }
+    return keyBytes;
+  }
+  const { algorithm, keyUsages } = getGenerateKeyParams(alg, options);
+  const key = await crypto.subtle.generateKey(
+    algorithm,
+    defaultExtractable,
+    keyUsages
+  );
+  if (exportToJWK) {
+    if (key instanceof CryptoKey) {
+      return exportKey(key, { alg });
+    } else {
+      const [publicKey, privateKey] = await Promise.all([
+        exportKey(key.publicKey, { alg }),
+        exportKey(key.privateKey, { alg })
+      ]);
+      return { privateKey, publicKey };
+    }
+  }
+  return key;
+}
+async function deriveKeyFromPassword(password, alg, options) {
+  const { salt, iterations, toJWK, extractable, keyUsage } = options;
+  if (!(salt instanceof Uint8Array) || salt.length < 8) {
+    throw new Error("PBES2 Salt Input (salt) must be 8 or more octets");
+  }
+  if (typeof iterations !== "number" || iterations < 1) {
+    throw new Error(
+      "PBES2 Iteration Count (iterations) must be a positive integer"
+    );
+  }
+  const passwordBytes = typeof password === "string" ? textEncoder.encode(password) : password;
+  const derivedBytes = await deriveKey(
+    salt,
+    alg,
+    iterations,
+    passwordBytes
+  );
+  const wrappingAlg = alg.slice(-6);
+  const defaultUsages = ["wrapKey", "unwrapKey"];
+  const finalUsages = keyUsage ?? defaultUsages;
+  const finalExtractable = toJWK === true ? true : extractable === true;
+  const derivedKey = await crypto.subtle.importKey(
+    "raw",
+    derivedBytes,
+    { name: "AES-KW" },
+    finalExtractable,
+    finalUsages
+  );
+  if (toJWK === true) {
+    const jwk = await keyToJWK(derivedKey);
+    return { ...jwk, alg: wrappingAlg, kty: "oct" };
+  }
+  return derivedKey;
+}
+async function importKey(key, alg) {
+  if (typeof key === "string") {
+    key = textEncoder.encode(key);
+  }
+  if (key instanceof Uint8Array) {
+    return key;
+  }
+  if (isCryptoKey(key)) {
+    return key;
+  }
+  if (isJWK(key)) {
+    if ("k" in key && typeof key.k === "string") {
+      return base64UrlDecode(key.k, false);
+    } else {
+      if (!alg) {
+        throw new TypeError(
+          "Algorithm must be provided when importing non-oct JWK"
+        );
+      }
+      return jwkTokey({ ...key, alg });
+    }
+  }
+  throw new Error("Invalid key type provided to importKey");
+}
+async function exportKey(key, jwk) {
+  const exportedJwk = await keyToJWK(key);
+  if (jwk) {
+    return { ...exportedJwk, ...jwk };
+  }
+  return exportedJwk;
+}
+async function wrapKey(alg, keyToWrap, wrappingKey, options = {}) {
+  const cekBytes = keyToWrap instanceof Uint8Array ? keyToWrap : new Uint8Array(await crypto.subtle.exportKey("raw", keyToWrap));
+  let importedWrappingKey;
+  const isPbes = alg.startsWith("PBES2");
+  const isAesKw = ["A128KW", "A192KW", "A256KW"].includes(alg);
+  if (isPbes && (typeof wrappingKey === "string" || wrappingKey instanceof Uint8Array)) {
+    importedWrappingKey = typeof wrappingKey === "string" ? textEncoder.encode(wrappingKey) : wrappingKey;
+  } else if (isPbes || isAesKw) {
+    if (typeof wrappingKey === "string") {
+      throw new TypeError(
+        "Wrapping key must be a CryptoKey, JWK, or Uint8Array for AES-KW or non-password PBES2"
+      );
+    }
+    importedWrappingKey = await importKey(wrappingKey, alg);
+  } else {
+    if (typeof wrappingKey === "string") {
+      throw new TypeError(
+        "Wrapping key must be a CryptoKey, JWK, or Uint8Array for non-PBES2 algorithms"
+      );
+    }
+    importedWrappingKey = await importKey(wrappingKey, alg);
+  }
+  switch (alg) {
+    // AES Key Wrap and PBES2 are handled by the same helper
+    case "A128KW":
+    case "A192KW":
+    case "A256KW":
+    case "PBES2-HS256+A128KW":
+    case "PBES2-HS384+A192KW":
+    case "PBES2-HS512+A256KW": {
+      const { p2s, p2c } = options;
+      if (isPbes && (!p2s || typeof p2c !== "number")) {
+        throw new Error(
+          "PBES2 requires 'p2s' (salt) and 'p2c' (count) options"
+        );
+      }
+      return wrap(alg, importedWrappingKey, cekBytes, p2c, p2s);
+    }
+    case "A128GCMKW":
+    case "A192GCMKW":
+    case "A256GCMKW": {
+      const { encryptedKey, iv, tag } = await encryptIV(
+        alg,
+        importedWrappingKey,
+        cekBytes,
+        options.iv
+      );
+      return { encryptedKey, iv, tag };
+    }
+    case "RSA-OAEP":
+    case "RSA-OAEP-256":
+    case "RSA-OAEP-384":
+    case "RSA-OAEP-512": {
+      const keyToWrapImported = await crypto.subtle.importKey(
+        "raw",
+        cekBytes,
+        { name: "AES-GCM", length: cekBytes.length * 8 },
+        true,
+        ["encrypt", "decrypt"]
+      );
+      const encryptedKey = new Uint8Array(
+        await crypto.subtle.wrapKey(
+          "raw",
+          keyToWrapImported,
+          importedWrappingKey,
+          { name: "RSA-OAEP" }
+        )
+      );
+      return { encryptedKey };
+    }
+    case "ECDH-ES":
+    case "ECDH-ES+A128KW":
+    case "ECDH-ES+A192KW":
+    case "ECDH-ES+A256KW": {
+      throw new Error(`Algorithm ${alg} not yet implemented in wrapKey`);
+    }
+    default: {
+      throw new Error(`Unsupported key wrapping algorithm: ${alg}`);
+    }
+  }
+}
+async function unwrapKey(alg, wrappedKey, unwrappingKey, options = {}) {
+  const { returnAs = true } = options;
+  const defaultExtractable = options.extractable !== false;
+  let importedUnwrappingKey;
+  const isPbes = alg.startsWith("PBES2");
+  const isAesKw = ["A128KW", "A192KW", "A256KW"].includes(alg);
+  if (isPbes && (typeof unwrappingKey === "string" || unwrappingKey instanceof Uint8Array)) {
+    importedUnwrappingKey = typeof unwrappingKey === "string" ? textEncoder.encode(unwrappingKey) : unwrappingKey;
+  } else if (isPbes || isAesKw) {
+    if (typeof unwrappingKey === "string") {
+      throw new TypeError(
+        "Unwrapping key must be a CryptoKey, JWK, or Uint8Array for AES-KW or non-password PBES2"
+      );
+    }
+    importedUnwrappingKey = await importKey(unwrappingKey, alg);
+  } else {
+    if (typeof unwrappingKey === "string") {
+      throw new TypeError(
+        "Unwrapping key must be a CryptoKey, JWK, or Uint8Array for non-PBES2 algorithms"
+      );
+    }
+    importedUnwrappingKey = await importKey(unwrappingKey, alg);
+  }
+  let unwrappedCekBytes;
+  switch (alg) {
+    // AES Key Wrap and PBES2 are handled by the same helper
+    case "A128KW":
+    case "A192KW":
+    case "A256KW":
+    case "PBES2-HS256+A128KW":
+    case "PBES2-HS384+A192KW":
+    case "PBES2-HS512+A256KW": {
+      const { p2s, p2c } = options;
+      let p2sBytes;
+      if (isPbes) {
+        if (!p2s || typeof p2c !== "number") {
+          throw new Error(
+            "PBES2 requires 'p2s' (salt) and 'p2c' (count) options"
+          );
+        }
+        p2sBytes = typeof p2s === "string" ? base64UrlDecode(p2s, false) : p2s;
+      }
+      unwrappedCekBytes = await unwrap(
+        alg,
+        importedUnwrappingKey,
+        wrappedKey,
+        p2c,
+        p2sBytes
+      );
+      break;
+    }
+    case "A128GCMKW":
+    case "A192GCMKW":
+    case "A256GCMKW": {
+      if (!options.iv || !options.tag) {
+        throw new Error(
+          "AES-GCMKW requires 'iv' and 'tag' options for unwrapping"
+        );
+      }
+      const ivBytes = typeof options.iv === "string" ? base64UrlDecode(options.iv, false) : options.iv;
+      const tagBytes = typeof options.tag === "string" ? base64UrlDecode(options.tag, false) : options.tag;
+      unwrappedCekBytes = await decryptIV(
+        alg,
+        importedUnwrappingKey,
+        wrappedKey,
+        ivBytes,
+        tagBytes
+      );
+      break;
+    }
+    case "RSA-OAEP":
+    case "RSA-OAEP-256":
+    case "RSA-OAEP-384":
+    case "RSA-OAEP-512": {
+      const unwrappedKey = await crypto.subtle.unwrapKey(
+        "raw",
+        wrappedKey,
+        importedUnwrappingKey,
+        { name: "RSA-OAEP" },
+        options.unwrappedKeyAlgorithm || { name: "AES-GCM" },
+        // Fallback
+        defaultExtractable,
+        options.keyUsage || ["encrypt", "decrypt"]
+        // Default usages
+      );
+      if (returnAs) return unwrappedKey;
+      unwrappedCekBytes = new Uint8Array(
+        await crypto.subtle.exportKey("raw", unwrappedKey)
+      );
+      break;
+    }
+    case "ECDH-ES":
+    case "ECDH-ES+A128KW":
+    case "ECDH-ES+A192KW":
+    case "ECDH-ES+A256KW": {
+      if (!options.epk) {
+        throw new Error("ECDH-ES requires 'epk' (Ephemeral Public Key) option");
+      }
+      throw new Error(`Algorithm ${alg} not yet implemented in unwrapKey`);
+    }
+    default: {
+      throw new Error(`Unsupported key unwrapping algorithm: ${alg}`);
+    }
+  }
+  if (!returnAs) {
+    return unwrappedCekBytes;
+  }
+  const finalKey = await crypto.subtle.importKey(
+    "raw",
+    unwrappedCekBytes,
+    options.unwrappedKeyAlgorithm || { name: "AES-GCM" },
+    defaultExtractable,
+    options.keyUsage || ["encrypt", "decrypt"]
+  );
+  return finalKey;
+}
+function getGenerateKeyParams(alg, options) {
+  let algorithm;
+  let keyUsages;
+  const defaultKeyUsage = options?.keyUsage;
+  switch (alg) {
+    // HMAC Signatures
+    case "HS256":
+    case "HS384":
+    case "HS512": {
+      algorithm = {
+        name: "HMAC",
+        hash: `SHA-${alg.slice(2)}`
+      };
+      keyUsages = defaultKeyUsage ?? ["sign", "verify"];
+      break;
+    }
+    // RSA Signatures
+    case "RS256":
+    case "RS384":
+    case "RS512": {
+      algorithm = {
+        name: "RSASSA-PKCS1-v1_5",
+        modulusLength: options?.modulusLength ?? 2048,
+        publicExponent: options?.publicExponent ?? new Uint8Array([1, 0, 1]),
+        hash: `SHA-${alg.slice(2)}`
+      };
+      keyUsages = defaultKeyUsage ?? ["sign", "verify"];
+      break;
+    }
+    // RSA PSS Signatures
+    case "PS256":
+    case "PS384":
+    case "PS512": {
+      algorithm = {
+        name: "RSA-PSS",
+        modulusLength: options?.modulusLength ?? 2048,
+        publicExponent: options?.publicExponent ?? new Uint8Array([1, 0, 1]),
+        hash: `SHA-${alg.slice(2)}`
+      };
+      keyUsages = defaultKeyUsage ?? ["sign", "verify"];
+      break;
+    }
+    // ECDSA Signatures
+    case "ES256": {
+      algorithm = { name: "ECDSA", namedCurve: "P-256" };
+      keyUsages = defaultKeyUsage ?? ["sign", "verify"];
+      break;
+    }
+    case "ES384": {
+      algorithm = { name: "ECDSA", namedCurve: "P-384" };
+      keyUsages = defaultKeyUsage ?? ["sign", "verify"];
+      break;
+    }
+    case "ES512": {
+      algorithm = { name: "ECDSA", namedCurve: "P-521" };
+      keyUsages = defaultKeyUsage ?? ["sign", "verify"];
+      break;
+    }
+    // EdDSA Signatures should be imported
+    // RSA Encryption
+    case "RSA-OAEP":
+    case "RSA-OAEP-256":
+    case "RSA-OAEP-384":
+    case "RSA-OAEP-512": {
+      algorithm = {
+        name: "RSA-OAEP",
+        modulusLength: options?.modulusLength ?? 2048,
+        publicExponent: options?.publicExponent ?? new Uint8Array([1, 0, 1]),
+        hash: `SHA-${Number.parseInt(alg.slice(9), 10) || 1}`
+      };
+      keyUsages = defaultKeyUsage ?? [
+        "encrypt",
+        "decrypt",
+        "wrapKey",
+        "unwrapKey"
+      ];
+      break;
+    }
+    // AES Key Wrap
+    case "A128KW":
+    case "A192KW":
+    case "A256KW": {
+      const length = Number.parseInt(alg.slice(1, 4), 10);
+      algorithm = { name: "AES-KW", length };
+      keyUsages = defaultKeyUsage ?? ["wrapKey", "unwrapKey"];
+      break;
+    }
+    // AES GCM Encryption
+    case "A128GCM":
+    case "A192GCM":
+    case "A256GCM": {
+      const length = Number.parseInt(alg.slice(1, 4), 10);
+      algorithm = { name: "AES-GCM", length };
+      keyUsages = defaultKeyUsage ?? ["encrypt", "decrypt"];
+      break;
+    }
+    // ECDH Key Agreement (requires specific curve in JWK for import, generation is simpler)
+    // For generation, typically generate the EC key pair first (e.g., P-256, P-384, P-521, X25519)
+    // then use deriveBits/deriveKey. Direct generation for "ECDH-ES*" alg isn't standard.
+    // Handle EC key pair generation under ES256/ES384/ES512.
+    default: {
+      throw new Error(
+        `Unsupported or invalid algorithm for key generation: ${alg}`
+      );
+    }
+  }
+  return { algorithm, keyUsages };
+}
+
+const jwk = {
+  __proto__: null,
+  deriveKeyFromPassword: deriveKeyFromPassword,
+  exportKey: exportKey,
+  generateKey: generateKey,
+  importKey: importKey,
+  unwrapKey: unwrapKey,
+  wrapKey: wrapKey
+};
+
+export { checkEncCryptoKey as a, bitLengthCEK as b, checkSigCryptoKey as c, jwkTokey as d, encryptIV as e, generateIV as f, generateCEK as g, encrypt as h, importKey as i, jwk as j, keyToJWK as k, unwrapKey as l, decrypt as m, generateKey as n, deriveKeyFromPassword as o, exportKey as p, wrapKey as q, uint32be as u, wrap as w };