@chainfuse/helpers 0.0.10 → 0.1.1

package/dist/buffers.d.mts

@@ -1,8 +1,14 @@
 import type { UndefinedProperties } from '@chainfuse/types';
 import type { PrefixedUuid, UuidExport } from '@chainfuse/types/d1';
 export declare class BufferHelpers {
-    static bufferFromHex(hex: UuidExport['hex']): Promise<UuidExport['blob']>;
+    /**
+     * @deprecated
+     */
+    static bufferFromHex(...args: Parameters<typeof this.hexToBuffer>): ReturnType<typeof this.hexToBuffer>;
+    static hexToBuffer(hex: UuidExport['hex']): Promise<UuidExport['blob']>;
     static bufferToHex(buffer: UuidExport['blob']): Promise<UuidExport['hex']>;
+    static base64ToBuffer(rawBase64: string, urlSafe: boolean): Promise<UuidExport['blob']>;
+    static bufferToBase64(buffer: UuidExport['blob'], urlSafe: boolean): Promise<string>;
     static get generateUuid(): Promise<UuidExport>;
     static uuidConvert(input: UuidExport['blob']): Promise<UuidExport>;
     static uuidConvert(prefixedUtf: PrefixedUuid): Promise<UuidExport>;

package/dist/buffers.mjs

@@ -1,6 +1,12 @@
 import { CryptoHelpers } from './crypto.mjs';
 export class BufferHelpers {
-    static bufferFromHex(hex) {
+    /**
+     * @deprecated
+     */
+    static bufferFromHex(...args) {
+        return this.hexToBuffer(...args);
+    }
+    static hexToBuffer(hex) {
         return (import('node:buffer')
             .then(({ Buffer }) => {
             const mainBuffer = Buffer.from(hex, 'hex');
@@ -19,6 +25,37 @@ export class BufferHelpers {
              */
             .catch(() => new Uint8Array(buffer).reduce((output, elem) => output + ('0' + elem.toString(16)).slice(-2), '')));
     }
+    static base64ToBuffer(rawBase64, urlSafe) {
+        return import('node:buffer')
+            .then(({ Buffer }) => {
+            const mainBuffer = Buffer.from(rawBase64, urlSafe ? 'base64url' : 'base64');
+            return mainBuffer.buffer.slice(mainBuffer.byteOffset, mainBuffer.byteOffset + mainBuffer.byteLength);
+        })
+            .catch(() => {
+            let base64 = rawBase64;
+            if (urlSafe) {
+                base64 = rawBase64.replaceAll('-', '+').replaceAll('_', '/');
+                // Add padding back to make length a multiple of 4
+                while (base64.length % 4 !== 0) {
+                    base64 += '=';
+                }
+            }
+            return new TextEncoder().encode(atob(base64)).buffer;
+        });
+    }
+    static bufferToBase64(buffer, urlSafe) {
+        return import('node:buffer')
+            .then(({ Buffer }) => Buffer.from(buffer).toString(urlSafe ? 'base64url' : 'base64'))
+            .catch(() => {
+            const raw = btoa(new TextDecoder().decode(buffer));
+            if (urlSafe) {
+                return raw.replaceAll('+', '-').replaceAll('/', '_').replaceAll('=', '');
+            }
+            else {
+                return raw;
+            }
+        });
+    }
     static get generateUuid() {
         return Promise.all([CryptoHelpers.secretBytes(16), import('uuid')]).then(([random, { v7: uuidv7 }]) => {
             const uuid = uuidv7({ random });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@chainfuse/helpers",
-	"version": "0.0.10",
+	"version": "0.1.1",
 	"description": "",
 	"author": "ChainFuse",
 	"homepage": "https://github.com/ChainFuse/packages/tree/main/packages/helpers#readme",
@@ -53,9 +53,9 @@
 		"uuid": "^10.0.0"
 	},
 	"devDependencies": {
-		"@chainfuse/types": "^1.0.0",
-		"@types/node": "^20.16.10",
+		"@chainfuse/types": "^1.0.1",
+		"@types/node": "^20.16.11",
 		"@types/uuid": "^10.0.0"
 	},
-	"gitHead": "39eacc48c44f8bcb3f2599404af48e7f20db7e33"
+	"gitHead": "86443611d415eb0a5a533dd5fa4c0818c04c3cec"
 }