@stryke/crypto 0.3.0 → 0.4.0

package/dist/base-64.cjs

@@ -5,70 +5,75 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.base64FromBase64url = base64FromBase64url;
 exports.base64ToBase64url = base64ToBase64url;
-exports.fromBase64 = fromBase64;
-exports.toBase64 = toBase64;
+exports.decodeBase64 = decodeBase64;
+exports.encodeBase64 = encodeBase64;
+var _stringToUtf8Array = require("@stryke/convert/string-to-utf8-array");
+var _utf8ArrayToString = require("@stryke/convert/utf8-array-to-string");
+var _isString = require("@stryke/type-checks/is-string");
 var _isUndefined = require("@stryke/type-checks/is-undefined");
 const a = new Uint8Array([65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 43, 47]),
   h = 61,
   s = new Uint8Array([100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 62, 100, 100, 100, 63, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 100, 100, 100, 100, 100, 100, 100, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 100, 100, 100, 100, 100, 100, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100]);
-function toBase64(e) {
-  const f = e.length,
+function encodeBase64(r) {
+  (0, _isString.isString)(r) && (r = (0, _stringToUtf8Array.stringToUtf8Array)(r));
+  const f = r.length,
     n = new Uint8Array(Math.ceil(f / 3) * 4),
     l = Math.floor(f / 3);
-  for (let r = 0; r < l; r++) {
-    const c = e[3 * r + 0] << 16 | e[3 * r + 1] << 8 | e[3 * r + 2];
-    n[4 * r + 0] = a[c >> 18 & 63], n[4 * r + 1] = a[c >> 12 & 63], n[4 * r + 2] = a[c >> 6 & 63], n[4 * r + 3] = a[c >> 0 & 63];
+  for (let e = 0; e < l; e++) {
+    const c = r[3 * e + 0] << 16 | r[3 * e + 1] << 8 | r[3 * e + 2];
+    n[4 * e + 0] = a[c >> 18 & 63], n[4 * e + 1] = a[c >> 12 & 63], n[4 * e + 2] = a[c >> 6 & 63], n[4 * e + 3] = a[c >> 0 & 63];
   }
-  const o = l;
+  const t = l;
   switch (f % 3) {
     case 1:
       {
-        const r = e[3 * o + 0] << 16;
-        n[4 * o + 0] = a[r >> 18 & 63], n[4 * o + 1] = a[r >> 12 & 63], n[4 * o + 2] = h, n[4 * o + 3] = h;
+        const e = r[3 * t + 0] << 16;
+        n[4 * t + 0] = a[e >> 18 & 63], n[4 * t + 1] = a[e >> 12 & 63], n[4 * t + 2] = h, n[4 * t + 3] = h;
         break;
       }
     case 2:
       {
-        const r = e[3 * o + 0] << 16 | e[3 * o + 1] << 8;
-        n[4 * o + 0] = a[r >> 18 & 63], n[4 * o + 1] = a[r >> 12 & 63], n[4 * o + 2] = a[r >> 6 & 63], n[4 * o + 3] = h;
+        const e = r[3 * t + 0] << 16 | r[3 * t + 1] << 8;
+        n[4 * t + 0] = a[e >> 18 & 63], n[4 * t + 1] = a[e >> 12 & 63], n[4 * t + 2] = a[e >> 6 & 63], n[4 * t + 3] = h;
         break;
       }
   }
-  return n;
+  return (0, _utf8ArrayToString.utf8ArrayToString)(n);
 }
-function fromBase64(e) {
-  const f = e.length;
+function decodeBase64(r) {
+  (0, _isString.isString)(r) && (r = (0, _stringToUtf8Array.stringToUtf8Array)(r));
+  const f = r.length;
   if (f % 4 !== 0) throw new Error("invalid length");
   let n = 0;
-  for (; n < 2 && n < e.length && e[e.length - 1 - n] === h;) n++;
-  for (let t = 0; t < e.length - n; t++) if ((0, _isUndefined.isUndefined)(e[t]) || (0, _isUndefined.isUndefined)(s[e[t]]) || s[e[t]] >= 64) throw new Error("invalid data");
+  for (; n < 2 && n < r.length && r[r.length - 1 - n] === h;) n++;
+  for (let o = 0; o < r.length - n; o++) if ((0, _isUndefined.isUndefined)(r[o]) || (0, _isUndefined.isUndefined)(s[r[o]]) || s[r[o]] >= 64) throw new Error("invalid data");
   const l = Math.floor((f - n) / 4),
-    o = 3 * l + (3 - n) % 3,
-    r = new Uint8Array(o);
-  for (let t = 0; t < l; t++) {
-    const g = s[e[4 * t + 0]] << 18 | s[e[4 * t + 1]] << 12 | s[e[4 * t + 2]] << 6 | s[e[4 * t + 3]] << 0;
-    r[3 * t] = g >> 16 & 255, r[3 * t + 1] = g >> 8 & 255, r[3 * t + 2] = g >> 0 & 255;
+    t = 3 * l + (3 - n) % 3,
+    e = new Uint8Array(t);
+  for (let o = 0; o < l; o++) {
+    const g = s[r[4 * o + 0]] << 18 | s[r[4 * o + 1]] << 12 | s[r[4 * o + 2]] << 6 | s[r[4 * o + 3]] << 0;
+    e[3 * o] = g >> 16 & 255, e[3 * o + 1] = g >> 8 & 255, e[3 * o + 2] = g >> 0 & 255;
   }
   const c = l;
-  switch (o % 3) {
+  switch (t % 3) {
     case 1:
       {
-        const t = s[e[4 * c + 0]] << 18 | s[e[4 * c + 1]] << 12;
-        r[3 * c] = t >> 16 & 255;
+        const o = s[r[4 * c + 0]] << 18 | s[r[4 * c + 1]] << 12;
+        e[3 * c] = o >> 16 & 255;
         break;
       }
     case 2:
       {
-        const t = s[e[4 * c + 0]] << 18 | s[e[4 * c + 1]] << 12 | s[e[4 * c + 2]] << 6;
-        r[3 * c] = t >> 16 & 255, r[3 * c + 1] = t >> 8 & 255;
+        const o = s[r[4 * c + 0]] << 18 | s[r[4 * c + 1]] << 12 | s[r[4 * c + 2]] << 6;
+        e[3 * c] = o >> 16 & 255, e[3 * c + 1] = o >> 8 & 255;
         break;
       }
   }
-  return r;
+  return e;
 }
-function base64ToBase64url(e) {
-  return e.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/g, "");
+function base64ToBase64url(r) {
+  return r.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/g, "");
 }
-function base64FromBase64url(e) {
-  return e.replace(/-/g, "+").replace(/_/g, "/") + "=".repeat((4 - e.length % 4) % 4);
+function base64FromBase64url(r) {
+  return r.replace(/-/g, "+").replace(/_/g, "/") + "=".repeat((4 - r.length % 4) % 4);
 }

package/dist/base-64.d.ts

@@ -1,17 +1,21 @@
 /**
  * Encodes a Uint8Array into a Base64 encoded Uint8Array.
  *
- * @param input - The input Uint8Array to encode.
+ * @credits https://github.com/hi-ogawa/js-utils
+ *
+ * @param input - The input Uint8Array or string to encode.
  * @returns The Base64 encoded Uint8Array.
  */
-export declare function toBase64(input: Uint8Array): Uint8Array;
+export declare function encodeBase64(input: Uint8Array | string): string;
 /**
  * Decodes a Base64 encoded Uint8Array into a Uint8Array.
  *
- * @param input - The Base64 encoded Uint8Array to decode.
+ * @credits https://github.com/hi-ogawa/js-utils
+ *
+ * @param input - The Base64 encoded Uint8Array or string to decode.
  * @returns The decoded Uint8Array.
  */
-export declare function fromBase64(input: Uint8Array): Uint8Array;
+export declare function decodeBase64(input: Uint8Array | string): Uint8Array;
 /**
  * Converts a Base64 encoded string to a [Base64url](https://datatracker.ietf.org/doc/html/rfc7515#appendix-C) encoded string.
  *
@@ -24,7 +28,7 @@ export declare function base64ToBase64url(base64: string): string;
 /**
  * Converts a [Base64url](https://datatracker.ietf.org/doc/html/rfc7515#appendix-C) encoded string to a Base64 encoded string.
  *
- * @see https://datatracker.ietf.org/doc/html/rfc7515#appendix-C *
+ * @see https://datatracker.ietf.org/doc/html/rfc7515#appendix-C
  *
  * @param base64url - The Base64url encoded string to convert.
  * @returns The Base64 encoded string.

package/dist/base-64.mjs

@@ -1 +1 @@
-import{isUndefined as b}from"@stryke/type-checks/is-undefined";const a=new Uint8Array([65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,48,49,50,51,52,53,54,55,56,57,43,47]),h=61,s=new Uint8Array([100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,62,100,100,100,63,52,53,54,55,56,57,58,59,60,61,100,100,100,100,100,100,100,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,100,100,100,100,100,100,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100]);export function toBase64(e){const f=e.length,n=new Uint8Array(Math.ceil(f/3)*4),l=Math.floor(f/3);for(let r=0;r<l;r++){const c=e[3*r+0]<<16|e[3*r+1]<<8|e[3*r+2];n[4*r+0]=a[c>>18&63],n[4*r+1]=a[c>>12&63],n[4*r+2]=a[c>>6&63],n[4*r+3]=a[c>>0&63]}const o=l;switch(f%3){case 1:{const r=e[3*o+0]<<16;n[4*o+0]=a[r>>18&63],n[4*o+1]=a[r>>12&63],n[4*o+2]=h,n[4*o+3]=h;break}case 2:{const r=e[3*o+0]<<16|e[3*o+1]<<8;n[4*o+0]=a[r>>18&63],n[4*o+1]=a[r>>12&63],n[4*o+2]=a[r>>6&63],n[4*o+3]=h;break}}return n}export function fromBase64(e){const f=e.length;if(f%4!==0)throw new Error("invalid length");let n=0;for(;n<2&&n<e.length&&e[e.length-1-n]===h;)n++;for(let t=0;t<e.length-n;t++)if(b(e[t])||b(s[e[t]])||s[e[t]]>=64)throw new Error("invalid data");const l=Math.floor((f-n)/4),o=3*l+(3-n)%3,r=new Uint8Array(o);for(let t=0;t<l;t++){const g=s[e[4*t+0]]<<18|s[e[4*t+1]]<<12|s[e[4*t+2]]<<6|s[e[4*t+3]]<<0;r[3*t]=g>>16&255,r[3*t+1]=g>>8&255,r[3*t+2]=g>>0&255}const c=l;switch(o%3){case 1:{const t=s[e[4*c+0]]<<18|s[e[4*c+1]]<<12;r[3*c]=t>>16&255;break}case 2:{const t=s[e[4*c+0]]<<18|s[e[4*c+1]]<<12|s[e[4*c+2]]<<6;r[3*c]=t>>16&255,r[3*c+1]=t>>8&255;break}}return r}export function base64ToBase64url(e){return e.replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/g,"")}export function base64FromBase64url(e){return e.replace(/-/g,"+").replace(/_/g,"/")+"=".repeat((4-e.length%4)%4)}
+import{stringToUtf8Array as i}from"@stryke/convert/string-to-utf8-array";import{utf8ArrayToString as x}from"@stryke/convert/utf8-array-to-string";import{isString as b}from"@stryke/type-checks/is-string";import{isUndefined as k}from"@stryke/type-checks/is-undefined";const a=new Uint8Array([65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,48,49,50,51,52,53,54,55,56,57,43,47]),h=61,s=new Uint8Array([100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,62,100,100,100,63,52,53,54,55,56,57,58,59,60,61,100,100,100,100,100,100,100,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,100,100,100,100,100,100,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100]);export function encodeBase64(r){b(r)&&(r=i(r));const f=r.length,n=new Uint8Array(Math.ceil(f/3)*4),l=Math.floor(f/3);for(let e=0;e<l;e++){const c=r[3*e+0]<<16|r[3*e+1]<<8|r[3*e+2];n[4*e+0]=a[c>>18&63],n[4*e+1]=a[c>>12&63],n[4*e+2]=a[c>>6&63],n[4*e+3]=a[c>>0&63]}const t=l;switch(f%3){case 1:{const e=r[3*t+0]<<16;n[4*t+0]=a[e>>18&63],n[4*t+1]=a[e>>12&63],n[4*t+2]=h,n[4*t+3]=h;break}case 2:{const e=r[3*t+0]<<16|r[3*t+1]<<8;n[4*t+0]=a[e>>18&63],n[4*t+1]=a[e>>12&63],n[4*t+2]=a[e>>6&63],n[4*t+3]=h;break}}return x(n)}export function decodeBase64(r){b(r)&&(r=i(r));const f=r.length;if(f%4!==0)throw new Error("invalid length");let n=0;for(;n<2&&n<r.length&&r[r.length-1-n]===h;)n++;for(let o=0;o<r.length-n;o++)if(k(r[o])||k(s[r[o]])||s[r[o]]>=64)throw new Error("invalid data");const l=Math.floor((f-n)/4),t=3*l+(3-n)%3,e=new Uint8Array(t);for(let o=0;o<l;o++){const g=s[r[4*o+0]]<<18|s[r[4*o+1]]<<12|s[r[4*o+2]]<<6|s[r[4*o+3]]<<0;e[3*o]=g>>16&255,e[3*o+1]=g>>8&255,e[3*o+2]=g>>0&255}const c=l;switch(t%3){case 1:{const o=s[r[4*c+0]]<<18|s[r[4*c+1]]<<12;e[3*c]=o>>16&255;break}case 2:{const o=s[r[4*c+0]]<<18|s[r[4*c+1]]<<12|s[r[4*c+2]]<<6;e[3*c]=o>>16&255,e[3*c+1]=o>>8&255;break}}return e}export function base64ToBase64url(r){return r.replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/g,"")}export function base64FromBase64url(r){return r.replace(/-/g,"+").replace(/_/g,"/")+"=".repeat((4-r.length%4)%4)}

package/dist/encryption.cjs

@@ -0,0 +1,64 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createKey = createKey;
+exports.decodeKey = decodeKey;
+exports.decrypt = decrypt;
+exports.decryptBuffer = decryptBuffer;
+exports.encodeKey = encodeKey;
+exports.encrypt = encrypt;
+exports.encryptBuffer = encryptBuffer;
+var _stringToUint8Array = require("@stryke/convert/string-to-uint8-array");
+var _stringToUtf8Array = require("@stryke/convert/string-to-utf8-array");
+var _uint8ArrayToStream = require("@stryke/convert/uint8-array-to-stream");
+var _uint8ArrayToString = require("@stryke/convert/uint8-array-to-string");
+var _utf8ArrayToString = require("@stryke/convert/utf8-array-to-string");
+var _base = require("./base-64.cjs");
+var _hex = require("./hex.cjs");
+async function createKey() {
+  return crypto.subtle.generateKey({
+    name: "AES-GCM",
+    length: 256
+  }, !0, ["encrypt", "decrypt"]);
+}
+async function encodeKey(t) {
+  const r = await crypto.subtle.exportKey("raw", t);
+  return (0, _base.encodeBase64)(new Uint8Array(r)).toString();
+}
+async function decodeKey(t) {
+  const r = (0, _base.decodeBase64)(t);
+  return crypto.subtle.importKey("raw", r.buffer, "AES-GCM", !0, ["encrypt", "decrypt"]);
+}
+const o = 24;
+async function encrypt(t, r) {
+  const e = crypto.getRandomValues(new Uint8Array(o / 2)),
+    n = await crypto.subtle.encrypt({
+      name: "AES-GCM",
+      iv: e
+    }, t, (0, _stringToUtf8Array.stringToUtf8Array)(r));
+  return (0, _hex.encodeHex)(e) + (0, _base.encodeBase64)(new Uint8Array(n));
+}
+async function decrypt(t, r) {
+  const e = await crypto.subtle.decrypt({
+    name: "AES-GCM",
+    iv: (0, _hex.decodeHex)(r.slice(0, o))
+  }, t, (0, _base.decodeBase64)(r.slice(o)));
+  return (0, _utf8ArrayToString.utf8ArrayToString)(e);
+}
+async function encryptBuffer(t, r) {
+  const e = crypto.getRandomValues(new Uint8Array(16)),
+    n = await crypto.subtle.encrypt({
+      name: "AES-GCM",
+      iv: e
+    }, t, r);
+  return (0, _uint8ArrayToString.base64Uint8ArrayToString)((0, _uint8ArrayToStream.concatUint8Array)([e, new Uint8Array(n)]));
+}
+async function decryptBuffer(t, r) {
+  const e = (0, _stringToUint8Array.base64StringToUint8Array)(r);
+  return crypto.subtle.decrypt({
+    name: "AES-GCM",
+    iv: e.slice(0, 16)
+  }, t, e.slice(16));
+}

package/dist/encryption.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Creates a CryptoKey object that can be used to encrypt any string.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/generateKey
+ *
+ * @returns A promise that resolves to a CryptoKey object that can be used to encrypt and decrypt strings.
+ */
+export declare function createKey(): Promise<CryptoKey>;
+/**
+ * Encodes a CryptoKey to base64 string, so that it can be embedded in JSON / JavaScript
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/exportKey
+ *
+ * @param key - The CryptoKey to encode
+ * @returns A promise that resolves to a base64 string representing the key
+ */
+export declare function encodeKey(key: CryptoKey): Promise<string>;
+/**
+ * Decodes a base64 string into bytes and then imports the key.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/importKey
+ *
+ * @param encoded - The base64 encoded key
+ * @returns A promise that resolves to a CryptoKey object that can be used to encrypt and decrypt strings
+ */
+export declare function decodeKey(encoded: string): Promise<CryptoKey>;
+/**
+ * Using a CryptoKey, use AES-GCM to encrypt a string into a base64 string.
+ *
+ * @remarks
+ * The initialization vector is randomly generated and prepended to the encrypted string. The IV is required for decryption, so it must be stored alongside the encrypted data.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/encrypt
+ *
+ * @param key - The CryptoKey to use for encryption
+ * @param plaintext - The plaintext string to encrypt
+ * @returns A promise that resolves to a base64 string representing the encrypted data
+ */
+export declare function encrypt(key: CryptoKey, plaintext: string): Promise<string>;
+/**
+ * Takes a base64 encoded string, decodes it and returns the AES-GCM decrypted text.
+ *
+ * @remarks
+ * The initialization vector is expected to be prepended to the encrypted string. The IV is required for decryption, so it must be extracted from the start of the string.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/decrypt
+ *
+ * @param key - The CryptoKey to use for decryption
+ * @param encrypted - The encrypted base64 encoded string to decrypt
+ * @returns A promise that resolves to the decrypted string
+ */
+export declare function decrypt(key: CryptoKey, encrypted: string): Promise<string>;
+/**
+ * Encrypts a buffer using AES-GCM with a given CryptoKey.
+ *
+ * @remarks
+ * The initialization vector (IV) is randomly generated and prepended to the encrypted data. The resulting data is then encoded as a base64 string for easy storage/transmission.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/encrypt
+ *
+ * @param key - The CryptoKey to use for encryption
+ * @param buffer - The buffer to encrypt
+ * @returns A promise that resolves to a base64 string representing the encrypted data
+ */
+export declare function encryptBuffer(key: CryptoKey, buffer: BufferSource): Promise<string>;
+/**
+ * Decrypts a buffer using AES-GCM with a given CryptoKey.
+ *
+ * @remarks
+ * The initialization vector (IV) is expected to be prepended to the encrypted data. The IV is required for decryption, so it must be extracted from the start of the buffer.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/decrypt
+ *
+ * @param key - The CryptoKey to use for decryption
+ * @param encrypted - The encrypted base64 encoded string to decrypt
+ * @returns A promise that resolves to the decrypted string
+ */
+export declare function decryptBuffer(key: CryptoKey, encrypted: string): Promise<ArrayBuffer>;

package/dist/encryption.mjs

@@ -0,0 +1 @@
+import{base64StringToUint8Array as i}from"@stryke/convert/string-to-uint8-array";import{stringToUtf8Array as s}from"@stryke/convert/string-to-utf8-array";import{concatUint8Array as a}from"@stryke/convert/uint8-array-to-stream";import{base64Uint8ArrayToString as p}from"@stryke/convert/uint8-array-to-string";import{utf8ArrayToString as u}from"@stryke/convert/utf8-array-to-string";import{decodeBase64 as y,encodeBase64 as c}from"./base-64";import{decodeHex as m,encodeHex as f}from"./hex";export async function createKey(){return crypto.subtle.generateKey({name:"AES-GCM",length:256},!0,["encrypt","decrypt"])}export async function encodeKey(t){const r=await crypto.subtle.exportKey("raw",t);return c(new Uint8Array(r)).toString()}export async function decodeKey(t){const r=y(t);return crypto.subtle.importKey("raw",r.buffer,"AES-GCM",!0,["encrypt","decrypt"])}const o=24;export async function encrypt(t,r){const e=crypto.getRandomValues(new Uint8Array(o/2)),n=await crypto.subtle.encrypt({name:"AES-GCM",iv:e},t,s(r));return f(e)+c(new Uint8Array(n))}export async function decrypt(t,r){const e=await crypto.subtle.decrypt({name:"AES-GCM",iv:m(r.slice(0,o))},t,y(r.slice(o)));return u(e)}export async function encryptBuffer(t,r){const e=crypto.getRandomValues(new Uint8Array(16)),n=await crypto.subtle.encrypt({name:"AES-GCM",iv:e},t,r);return p(a([e,new Uint8Array(n)]))}export async function decryptBuffer(t,r){const e=i(r);return crypto.subtle.decrypt({name:"AES-GCM",iv:e.slice(0,16)},t,e.slice(16))}

package/dist/hex.cjs

@@ -0,0 +1,47 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.decodeHex = decodeHex;
+exports.encodeHex = encodeHex;
+const o = "0123456789ABCDEF",
+  t = {
+    0: 0,
+    1: 1,
+    2: 2,
+    3: 3,
+    4: 4,
+    5: 5,
+    6: 6,
+    7: 7,
+    8: 8,
+    9: 9,
+    a: 10,
+    A: 10,
+    b: 11,
+    B: 11,
+    c: 12,
+    C: 12,
+    d: 13,
+    D: 13,
+    e: 14,
+    E: 14,
+    f: 15,
+    F: 15
+  };
+function encodeHex(e) {
+  let n = "";
+  for (let r = 0; r < e.length; r++) n += o[e[r] >> 4], n += o[e[r] & 15];
+  return n;
+}
+function decodeHex(e) {
+  if (e.length % 2 !== 0) throw new Error("Invalid hex string");
+  const n = new Uint8Array(e.length / 2);
+  for (let r = 0; r < e.length; r += 2) {
+    if (!(e[r] in t)) throw new Error("Invalid character");
+    if (!(e[r + 1] in t)) throw new Error("Invalid character");
+    n[r / 2] |= t[e[r]] << 4, n[r / 2] |= t[e[r + 1]];
+  }
+  return n;
+}

package/dist/hex.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Encodes a Uint8Array into a hexadecimal string.
+ *
+ * @param input - The input Uint8Array.
+ * @returns The hexadecimal string.
+ */
+export declare function encodeHex(input: Uint8Array): string;
+/**
+ * Encodes a Uint8Array into an uppercase hexadecimal string.
+ *
+ * @param input - The input Uint8Array.
+ * @returns The uppercase hexadecimal string.
+ */
+export declare function decodeHex(input: string): Uint8Array;

package/dist/hex.mjs

@@ -0,0 +1 @@
+const o="0123456789ABCDEF",t={0:0,1:1,2:2,3:3,4:4,5:5,6:6,7:7,8:8,9:9,a:10,A:10,b:11,B:11,c:12,C:12,d:13,D:13,e:14,E:14,f:15,F:15};export function encodeHex(e){let n="";for(let r=0;r<e.length;r++)n+=o[e[r]>>4],n+=o[e[r]&15];return n}export function decodeHex(e){if(e.length%2!==0)throw new Error("Invalid hex string");const n=new Uint8Array(e.length/2);for(let r=0;r<e.length;r+=2){if(!(e[r]in t))throw new Error("Invalid character");if(!(e[r+1]in t))throw new Error("Invalid character");n[r/2]|=t[e[r]]<<4,n[r/2]|=t[e[r+1]]}return n}

package/dist/index.cjs

@@ -3,14 +3,36 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-var _sym = require("./sym.cjs");
-Object.keys(_sym).forEach(function (key) {
+var _base = require("./base-64.cjs");
+Object.keys(_base).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
-  if (key in exports && exports[key] === _sym[key]) return;
+  if (key in exports && exports[key] === _base[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
     get: function () {
-      return _sym[key];
+      return _base[key];
+    }
+  });
+});
+var _encryption = require("./encryption.cjs");
+Object.keys(_encryption).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _encryption[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _encryption[key];
+    }
+  });
+});
+var _hex = require("./hex.cjs");
+Object.keys(_hex).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _hex[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _hex[key];
     }
   });
 });

package/dist/index.d.ts

@@ -1 +1,3 @@
-export * from "./sym";
+export * from "./base-64";
+export * from "./encryption";
+export * from "./hex";

package/dist/index.mjs

@@ -1 +1 @@
-export*from"./sym";
+export*from"./base-64";export*from"./encryption";export*from"./hex";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stryke/crypto",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "A package containing cryptographic utilities used by Storm Software.",
   "repository": {
@@ -9,9 +9,12 @@
     "directory": "packages/crypto"
   },
   "private": false,
-  "dependencies": { "@stryke/type-checks": "^0.3.9" },
-  "devDependencies": { "@types/node": "^22.14.0" },
+  "dependencies": {
+    "@stryke/convert": "^0.5.0",
+    "@stryke/type-checks": "^0.3.9"
+  },
   "publishConfig": { "access": "public" },
+  "devDependencies": {},
   "sideEffects": false,
   "files": ["dist/**/*"],
   "homepage": "https://stormsoftware.com",
@@ -55,11 +58,6 @@
     }
   ],
   "exports": {
-    "./sym": {
-      "import": { "types": "./dist/sym.d.ts", "default": "./dist/sym.mjs" },
-      "require": { "types": "./dist/sym.d.ts", "default": "./dist/sym.cjs" },
-      "default": { "types": "./dist/sym.d.ts", "default": "./dist/sym.mjs" }
-    },
     "./index": {
       "import": { "types": "./dist/index.d.ts", "default": "./dist/index.mjs" },
       "require": {
@@ -68,6 +66,25 @@
       },
       "default": { "types": "./dist/index.d.ts", "default": "./dist/index.mjs" }
     },
+    "./hex": {
+      "import": { "types": "./dist/hex.d.ts", "default": "./dist/hex.mjs" },
+      "require": { "types": "./dist/hex.d.ts", "default": "./dist/hex.cjs" },
+      "default": { "types": "./dist/hex.d.ts", "default": "./dist/hex.mjs" }
+    },
+    "./encryption": {
+      "import": {
+        "types": "./dist/encryption.d.ts",
+        "default": "./dist/encryption.mjs"
+      },
+      "require": {
+        "types": "./dist/encryption.d.ts",
+        "default": "./dist/encryption.cjs"
+      },
+      "default": {
+        "types": "./dist/encryption.d.ts",
+        "default": "./dist/encryption.mjs"
+      }
+    },
     "./base-64": {
       "import": {
         "types": "./dist/base-64.d.ts",
@@ -95,5 +112,5 @@
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
-  "gitHead": "a27f10e735a05cca18b29026136249ed3bb76c1c"
+  "gitHead": "7331a32032c42269626a48f5011938b82dc80c45"
 }

package/dist/sym.cjs

@@ -1,39 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.createSecret = createSecret;
-exports.decrypt = decrypt;
-exports.encrypt = encrypt;
-var _isSetString = require("@stryke/type-checks/is-set-string");
-var _nodeBuffer = require("node:buffer");
-var _nodeCrypto = require("node:crypto");
-const E = "chacha20-poly1305",
-  h = 32,
-  o = 16,
-  S = 16,
-  r = 64,
-  T = 1e5;
-function createSecret(t, c) {
-  return (0, _isSetString.isSetString)(t) ? (0, _nodeCrypto.createSecretKey)(t, c) : (0, _nodeCrypto.createSecretKey)(t);
-}
-function encrypt(t, c) {
-  const e = (0, _nodeCrypto.randomBytes)(o),
-    i = (0, _nodeCrypto.randomBytes)(r),
-    s = (0, _nodeCrypto.pbkdf2Sync)(t, i, T, h, "sha512"),
-    n = (0, _nodeCrypto.createCipheriv)(E, s, e),
-    a = _nodeBuffer.Buffer.concat([n.update(c, "utf8"), n.final()]),
-    f = n.getAuthTag();
-  return _nodeBuffer.Buffer.concat([i, e, f, a]).toString("hex");
-}
-function decrypt(t, c) {
-  const e = _nodeBuffer.Buffer.from(c, "hex"),
-    i = e.slice(0, r),
-    s = e.slice(r, r + o),
-    n = e.slice(r + o, r + o + S),
-    a = e.slice(r + o + S),
-    f = (0, _nodeCrypto.pbkdf2Sync)(t, i, T, h, "sha512"),
-    p = (0, _nodeCrypto.createDecipheriv)(E, f, s);
-  return p.setAuthTag(n), p.update(a) + p.final("utf8");
-}

package/dist/sym.d.ts

@@ -1,36 +0,0 @@
-import type { BinaryLike, KeyObject } from "node:crypto";
-/**
- * Creates and returns a new key object containing a secret key for symmetric encryption or `Hmac`.
- *
- * @param key - The key to use when creating the `KeyObject`.
- * @returns The new `KeyObject`.
- */
-export declare function createSecret(key: NodeJS.ArrayBufferView): KeyObject;
-/**
- * Creates and returns a new key object containing a secret key for symmetric encryption or `Hmac`.
- *
- * @param key - The key to use. If `key` is a `Buffer`, `TypedArray`, or `DataView`, the `encoding` argument is ignored.
- * @param encoding - The `encoding` of the `key` string. Must be one of `'utf8'`, `'utf16le'`, `'latin1'`, or `'base64'`. Default is `'utf8'`.
- * @returns The new `KeyObject`.
- */
-export declare function createSecret(key: string, encoding: BufferEncoding): KeyObject;
-/**
- * Symmetrically encrypts data using the [ChaCha20-Poly1305](https://en.wikipedia.org/wiki/ChaCha20-Poly1305) cipher.
- *
- * @see https://en.wikipedia.org/wiki/ChaCha20-Poly1305
- *
- * @param secret - The secret key used for encryption.
- * @param data - The data to encrypt.
- * @returns The encrypted data.
- */
-export declare function encrypt(secret: BinaryLike, data: string): string;
-/**
- * Symmetrically decrypts data using the [ChaCha20-Poly1305](https://en.wikipedia.org/wiki/ChaCha20-Poly1305) cipher.
- *
- * @see https://en.wikipedia.org/wiki/ChaCha20-Poly1305
- *
- * @param secret - The secret key used for decryption.
- * @param encryptedData - The encrypted data to decrypt.
- * @returns The decrypted data.
- */
-export declare function decrypt(secret: BinaryLike, encryptedData: string): string;

package/dist/sym.mjs

@@ -1 +0,0 @@
-import{isSetString as _}from"@stryke/type-checks/is-set-string";import{Buffer as y}from"node:buffer";import{createCipheriv as m,createDecipheriv as B,createSecretKey as u,pbkdf2Sync as g,randomBytes as d}from"node:crypto";const E="chacha20-poly1305",h=32,o=16,S=16,r=64,T=1e5;export function createSecret(t,c){return _(t)?u(t,c):u(t)}export function encrypt(t,c){const e=d(o),i=d(r),s=g(t,i,T,h,"sha512"),n=m(E,s,e),a=y.concat([n.update(c,"utf8"),n.final()]),f=n.getAuthTag();return y.concat([i,e,f,a]).toString("hex")}export function decrypt(t,c){const e=y.from(c,"hex"),i=e.slice(0,r),s=e.slice(r,r+o),n=e.slice(r+o,r+o+S),a=e.slice(r+o+S),f=g(t,i,T,h,"sha512"),p=B(E,f,s);return p.setAuthTag(n),p.update(a)+p.final("utf8")}