@chainfuse/helpers 0.3.1 → 0.4.1

package/dist/buffers.d.mts

@@ -1,18 +1,18 @@
-import type { UndefinedProperties } from '@chainfuse/types';
-import type { PrefixedUuid, UuidExport } from '@chainfuse/types/d1';
+import type { D1Blob, PrefixedUuid, UndefinedProperties, UuidExport } from '@chainfuse/types';
 export declare class BufferHelpers {
     /**
      * @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 bufferToHex(buffer: UuidExport['blob'] | D1Blob): Promise<UuidExport['hex']>;
     static base64ToBuffer(rawBase64: string, urlSafe: boolean): Promise<UuidExport['blob']>;
-    static bufferToBase64(buffer: UuidExport['blob'], urlSafe: boolean): Promise<string>;
+    static bufferToBase64(buffer: UuidExport['blob'] | D1Blob, urlSafe: boolean): Promise<string>;
     static get generateUuid(): Promise<UuidExport>;
-    static uuidConvert(input: UuidExport['blob']): Promise<UuidExport>;
+    static uuidConvert(input: undefined): Promise<UndefinedProperties<UuidExport>>;
     static uuidConvert(prefixedUtf: PrefixedUuid): Promise<UuidExport>;
     static uuidConvert(input: UuidExport['utf8']): Promise<UuidExport>;
     static uuidConvert(input: UuidExport['hex']): Promise<UuidExport>;
-    static uuidConvert(input: undefined): Promise<UndefinedProperties<UuidExport>>;
+    static uuidConvert(input: UuidExport['blob']): Promise<UuidExport>;
+    static uuidConvert(input: D1Blob): Promise<UuidExport>;
 }

package/dist/buffers.mjs

@@ -19,10 +19,12 @@ export class BufferHelpers {
     }
     static bufferToHex(buffer) {
         return (import('node:buffer')
+            // @ts-expect-error `ArrayBufferLike` or D1Blob is actually accepted and fine
             .then(({ Buffer }) => Buffer.from(buffer).toString('hex'))
             /**
              * @link https://jsbm.dev/AoXo8dEke1GUg
              */
+            // @ts-expect-error `ArrayBufferLike` or D1Blob is actually accepted and fine
             .catch(() => new Uint8Array(buffer).reduce((output, elem) => output + ('0' + elem.toString(16)).slice(-2), '')));
     }
     static base64ToBuffer(rawBase64, urlSafe) {
@@ -44,9 +46,11 @@ export class BufferHelpers {
         });
     }
     static bufferToBase64(buffer, urlSafe) {
-        return import('node:buffer')
+        return (import('node:buffer')
+            // @ts-expect-error `ArrayBufferLike` or D1Blob is actually accepted and fine
             .then(({ Buffer }) => Buffer.from(buffer).toString(urlSafe ? 'base64url' : 'base64'))
             .catch(() => {
+            // @ts-expect-error `ArrayBufferLike` is actually accepted and fine
             const raw = btoa(new TextDecoder().decode(buffer));
             if (urlSafe) {
                 return raw.replaceAll('+', '-').replaceAll('/', '_').replaceAll('=', '');
@@ -54,7 +58,7 @@ export class BufferHelpers {
             else {
                 return raw;
             }
-        });
+        }));
     }
     static get generateUuid() {
         return Promise.all([CryptoHelpers.secretBytes(16), import('uuid')]).then(([random, { v7: uuidv7 }]) => {
@@ -93,11 +97,11 @@ export class BufferHelpers {
                 }
             }
             else {
-                const blob = input;
-                return this.bufferToHex(blob).then((hex) => ({
+                return this.bufferToHex(input).then((hex) => ({
                     utf8: `${hex.substring(0, 8)}-${hex.substring(8, 12)}-${hex.substring(12, 16)}-${hex.substring(16, 20)}-${hex.substring(20)}`,
                     hex,
-                    blob,
+                    // @ts-expect-error `ArrayBufferLike` or D1Blob is actually accepted and fine
+                    blob: new Uint8Array(input).buffer,
                 }));
             }
         }

package/dist/crypto.d.mts

@@ -1,5 +1,5 @@
 export declare class CryptoHelpers {
-    static secretBytes(byteSize: number): Promise<Buffer | Uint8Array>;
+    static secretBytes(byteSize: number): Promise<Uint8Array<ArrayBuffer> | Uint8Array<ArrayBuffer | SharedArrayBuffer>>;
     /**
      * @yields secret length = (`byteSize` * Math.log2(16)) / 8
      */

package/dist/crypto.mjs

@@ -2,7 +2,10 @@ import { BufferHelpers } from './buffers.mjs';
 export class CryptoHelpers {
     static secretBytes(byteSize) {
         return import('node:crypto')
-            .then(({ randomBytes }) => randomBytes(byteSize))
+            .then(({ randomBytes }) => {
+            const mainBuffer = randomBytes(byteSize);
+            return new Uint8Array(mainBuffer.buffer.slice(mainBuffer.byteOffset, mainBuffer.byteOffset + mainBuffer.byteLength));
+        })
             .catch(() => {
             const randomBytes = new Uint8Array(byteSize);
             crypto.getRandomValues(randomBytes);
@@ -13,7 +16,7 @@ export class CryptoHelpers {
      * @yields secret length = (`byteSize` * Math.log2(16)) / 8
      */
     static base16secret(byteSize) {
-        return this.secretBytes(byteSize).then((bytes) => BufferHelpers.bufferToHex(bytes));
+        return this.secretBytes(byteSize).then((bytes) => BufferHelpers.bufferToHex(bytes.buffer));
     }
     /**
      * @yields secret length = (`byteSize` * Math.log2(62)) / 8
@@ -36,7 +39,7 @@ export class CryptoHelpers {
         });
     }
     static getHash(algorithm, input) {
-        return import('node:crypto')
+        return (import('node:crypto')
             .then(async ({ createHash }) => {
             const hash = createHash(algorithm.replace('-', '').toLowerCase());
             if (typeof input === 'string') {
@@ -47,7 +50,8 @@ export class CryptoHelpers {
             }
             return hash.digest('hex');
         })
-            .catch(() => crypto.subtle.digest(algorithm, typeof input === 'string' ? new TextEncoder().encode(input) : input).then((hashBuffer) => BufferHelpers.bufferToHex(hashBuffer)));
+            // @ts-expect-error `ArrayBufferLike` is actually accepted and fine
+            .catch(() => crypto.subtle.digest(algorithm, typeof input === 'string' ? new TextEncoder().encode(input) : input).then((hashBuffer) => BufferHelpers.bufferToHex(hashBuffer))));
     }
     /**
      * @returns Fully formatted (double quote encapsulated) `ETag` header value

package/dist/discord.d.mts

@@ -1,6 +1,6 @@
 import type { CustomLoging } from '@chainfuse/types';
 import type { ExecutionContext } from '@cloudflare/workers-types/experimental';
-import { REST } from '@discordjs/rest';
+import { REST, type RESTOptions } from '@discordjs/rest';
 export declare class DiscordHelpers {
     /**
      * Discord Epoch, the first second of 2015 or 1420070400000
@@ -17,5 +17,5 @@ export declare class DiscordHelpers {
      * @link https://discord.com/developers/docs/reference#snowflakes-snowflake-id-format-structure-left-to-right
      */
     static discordSnowflakeToDate(snowflakeRaw?: bigint | string): Date;
-    static discordRest(apiKey: string, cacheTtl?: number, forceCache?: boolean, executionContext?: ExecutionContext, logger?: CustomLoging): REST;
+    static discordRest(apiKey: string, cacheTtl?: number, forceCache?: boolean, executionContext?: ExecutionContext, logger?: CustomLoging, restOptions?: Partial<Omit<RESTOptions, 'agent' | 'authPrefix' | 'makeRequest'>>): REST;
 }

package/dist/discord.mjs

@@ -30,8 +30,9 @@ export class DiscordHelpers {
         const snowflake = BigInt(snowflakeRaw);
         return new Date(Number((snowflake >> BigInt(22)) + this.discordEpoch));
     }
-    static discordRest(apiKey, cacheTtl = 24 * 60 * 60, forceCache = false, executionContext, logger = false) {
+    static discordRest(apiKey, cacheTtl = 24 * 60 * 60, forceCache = false, executionContext, logger = false, restOptions) {
         return new REST({
+            ...restOptions,
             agent: null,
             authPrefix: 'Bot',
             makeRequest: (url, rawInit) => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@chainfuse/helpers",
-	"version": "0.3.1",
+	"version": "0.4.1",
 	"description": "",
 	"author": "ChainFuse",
 	"homepage": "https://github.com/ChainFuse/packages/tree/main/packages/helpers#readme",
@@ -55,8 +55,8 @@
 		"uuid": "^11.0.3"
 	},
 	"devDependencies": {
-		"@chainfuse/types": "^1.1.8",
-		"@types/node": "^22.9.1"
+		"@chainfuse/types": "^1.3.0",
+		"@types/node": "^22.10.0"
 	},
-	"gitHead": "50cb4ae5092e0c748de2c9e8a74f1afc79e0102e"
+	"gitHead": "ea93b05607f7e9687526434591370bfad1ad8605"
 }