@e280/stz 0.0.0-3 → 0.0.0-30

package/x/data/base-x.js

@@ -0,0 +1,147 @@
+import { Bytes } from "./bytes.js";
+export class BaseX {
+    lexicon;
+    static lexicons = Object.freeze({
+        base2: { characters: "01" },
+        hex: { characters: "0123456789abcdef" },
+        base36: { characters: "0123456789abcdefghijklmnopqrstuvwxyz" },
+        base58: { characters: "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz" },
+        base62: { characters: "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz" },
+        base64url: {
+            negativePrefix: "~",
+            characters: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_",
+        },
+        base64: {
+            characters: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/",
+            padding: { character: "=", size: 4 },
+        },
+    });
+    lookup;
+    negativePrefix;
+    constructor(lexicon) {
+        this.lexicon = lexicon;
+        this.lookup = Object.fromEntries([...lexicon.characters].map((char, i) => [char, i]));
+        this.negativePrefix = lexicon.negativePrefix ?? "-";
+    }
+    toBytes(s) {
+        const bitsPerChar = Math.log2(this.lexicon.characters.length);
+        if (Number.isInteger(bitsPerChar)) {
+            // Bitstream mode (for power-of-2 lexicons)
+            let bitBuffer = 0;
+            let bitCount = 0;
+            const output = [];
+            for (const char of s) {
+                if (char === this.lexicon.padding?.character)
+                    continue;
+                const val = this.lookup[char];
+                if (val === undefined)
+                    throw new Error(`Invalid character: ${char}`);
+                bitBuffer = (bitBuffer << bitsPerChar) | val;
+                bitCount += bitsPerChar;
+                while (bitCount >= 8) {
+                    bitCount -= 8;
+                    output.push((bitBuffer >> bitCount) & 0xFF);
+                }
+            }
+            return new Uint8Array(output);
+        }
+        // Radix mode fallback
+        let num = 0n;
+        const base = BigInt(this.lexicon.characters.length);
+        let negative = false;
+        if (s.startsWith(this.negativePrefix)) {
+            s = s.slice(this.negativePrefix.length);
+            negative = true;
+        }
+        for (const char of s) {
+            const val = this.lookup[char];
+            if (val === undefined)
+                throw new Error(`Invalid character: ${char}`);
+            num = num * base + BigInt(val);
+        }
+        const out = [];
+        while (num > 0n) {
+            out.unshift(Number(num % 256n));
+            num = num / 256n;
+        }
+        return new Uint8Array(out);
+    }
+    fromBytes(bytes) {
+        const bitsPerChar = Math.log2(this.lexicon.characters.length);
+        if (Number.isInteger(bitsPerChar)) {
+            // Bitstream mode (for power-of-2 lexicons)
+            let bitBuffer = 0;
+            let bitCount = 0;
+            let out = "";
+            for (const byte of bytes) {
+                bitBuffer = (bitBuffer << 8) | byte;
+                bitCount += 8;
+                while (bitCount >= bitsPerChar) {
+                    bitCount -= bitsPerChar;
+                    const index = (bitBuffer >> bitCount) & ((1 << bitsPerChar) - 1);
+                    out += this.lexicon.characters[index];
+                }
+            }
+            // 🩹 flush remaining bits
+            if (bitCount > 0) {
+                const index = (bitBuffer << (bitsPerChar - bitCount)) & ((1 << bitsPerChar) - 1);
+                out += this.lexicon.characters[index];
+            }
+            // Add padding if applicable
+            if (this.lexicon.padding) {
+                while (out.length % this.lexicon.padding.size !== 0)
+                    out += this.lexicon.padding.character;
+            }
+            return out;
+        }
+        // Radix mode fallback
+        let num = 0n;
+        for (const byte of bytes)
+            num = (num << 8n) + BigInt(byte);
+        if (num === 0n)
+            return this.lexicon.characters[0];
+        const base = BigInt(this.lexicon.characters.length);
+        let out = "";
+        while (num > 0n) {
+            out = this.lexicon.characters[Number(num % base)] + out;
+            num = num / base;
+        }
+        return out;
+    }
+    toInteger(s) {
+        if (!s)
+            return 0;
+        let n = 0n;
+        let negative = false;
+        const base = BigInt(this.lexicon.characters.length);
+        if (s.startsWith(this.negativePrefix)) {
+            s = s.slice(this.negativePrefix.length);
+            negative = true;
+        }
+        for (const char of s) {
+            const value = this.lookup[char];
+            if (value === undefined)
+                throw new Error(`Invalid character: ${char}`);
+            n = n * base + BigInt(value);
+        }
+        return Number(negative ? -n : n);
+    }
+    fromInteger(n) {
+        n = Math.floor(n);
+        const negative = n < 0;
+        let num = BigInt(negative ? -n : n);
+        if (num === 0n)
+            return this.lexicon.characters[0];
+        const base = BigInt(this.lexicon.characters.length);
+        let out = "";
+        while (num > 0n) {
+            out = this.lexicon.characters[Number(num % base)] + out;
+            num = num / base;
+        }
+        return negative ? `${this.negativePrefix}${out}` : out;
+    }
+    random(count = 32) {
+        return this.fromBytes(Bytes.random(count));
+    }
+}
+//# sourceMappingURL=base-x.js.map

package/x/data/base-x.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-x.js","sourceRoot":"","sources":["../../s/data/base-x.ts"],"names":[],"mappings":"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"}

package/x/data/base58.d.ts

@@ -1,5 +1,9 @@
 export declare const Base58: Readonly<{
+    fromBytes(bytes: Uint8Array): string;
+    toBytes(string: string): Uint8Array<ArrayBuffer>;
+    random(count?: number): string;
+    /** @deprecated renamed to `fromBytes` */
     string(bytes: Uint8Array): string;
+    /** @deprecated renamed to `toBytes` */
     bytes(string: string): Uint8Array<ArrayBuffer>;
-    random(count?: number): string;
 }>;

package/x/data/base58.js

@@ -12,8 +12,8 @@ import { Bytes } from "./bytes.js";
 const base = 58;
 const characters = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
 export const Base58 = Object.freeze({
-    string(bytes) {
-        let intVal = BigInt("0x" + Hex.string(bytes));
+    fromBytes(bytes) {
+        let intVal = BigInt("0x" + Hex.fromBytes(bytes));
         let encoded = "";
         while (intVal > 0) {
             const remainder = intVal % BigInt(base);
@@ -28,7 +28,7 @@ export const Base58 = Object.freeze({
         }
         return encoded;
     },
-    bytes(string) {
+    toBytes(string) {
         let intVal = BigInt(0);
         for (const char of string) {
             const index = characters.indexOf(char);
@@ -39,7 +39,7 @@ export const Base58 = Object.freeze({
         let hex = intVal.toString(16);
         if (hex.length % 2 !== 0)
             hex = "0" + hex;
-        const bytes = Hex.bytes(hex);
+        const bytes = Hex.toBytes(hex);
         let leadingZeroes = 0;
         for (const char of string) {
             if (char === characters[0])
@@ -52,7 +52,15 @@ export const Base58 = Object.freeze({
         return decoded;
     },
     random(count = 32) {
-        return this.string(Bytes.random(count));
+        return this.fromBytes(Bytes.random(count));
+    },
+    /** @deprecated renamed to `fromBytes` */
+    string(bytes) {
+        return Base58.fromBytes(bytes);
+    },
+    /** @deprecated renamed to `toBytes` */
+    bytes(string) {
+        return Base58.toBytes(string);
     },
 });
 //# sourceMappingURL=base58.js.map

package/x/data/base58.js.map

@@ -1 +1 @@
-{"version":3,"file":"base58.js","sourceRoot":"","sources":["../../s/data/base58.ts"],"names":[],"mappings":"AACA;;;;;;;;EAQE;AAEF,OAAO,EAAC,GAAG,EAAC,MAAM,UAAU,CAAA;AAC5B,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAA;AAEhC,MAAM,IAAI,GAAG,EAAE,CAAA;AACf,MAAM,UAAU,GAAG,4DAA4D,CAAA;AAE/E,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,MAAM,CAAC,KAAiB;QACvB,IAAI,MAAM,GAAG,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QAC7C,IAAI,OAAO,GAAG,EAAE,CAAA;QAEhB,OAAO,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;YACvC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;YAC9B,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,OAAO,CAAA;QAClD,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAA;;gBAC5C,MAAK;QACX,CAAC;QAED,OAAO,OAAO,CAAA;IACf,CAAC;IAED,KAAK,CAAC,MAAc;QACnB,IAAI,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;QAEtB,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YACtC,IAAI,KAAK,KAAK,CAAC,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,oBAAoB,CAAC,CAAA;YACjF,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QAC/C,CAAC;QAED,IAAI,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;QAC7B,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;YAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;QACzC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAE5B,IAAI,aAAa,GAAG,CAAC,CAAA;QACrB,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC;gBAAE,aAAa,EAAE,CAAA;;gBACtC,MAAK;QACX,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;QAC5D,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,CAAA;QACjC,OAAO,OAAO,CAAA;IACf,CAAC;IAED,MAAM,CAAC,KAAK,GAAG,EAAE;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IACxC,CAAC;CACD,CAAC,CAAA"}
+{"version":3,"file":"base58.js","sourceRoot":"","sources":["../../s/data/base58.ts"],"names":[],"mappings":"AACA;;;;;;;;EAQE;AAEF,OAAO,EAAC,GAAG,EAAC,MAAM,UAAU,CAAA;AAC5B,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAA;AAEhC,MAAM,IAAI,GAAG,EAAE,CAAA;AACf,MAAM,UAAU,GAAG,4DAA4D,CAAA;AAE/E,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,SAAS,CAAC,KAAiB;QAC1B,IAAI,MAAM,GAAG,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;QAChD,IAAI,OAAO,GAAG,EAAE,CAAA;QAEhB,OAAO,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;YACvC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;YAC9B,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,OAAO,CAAA;QAClD,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAA;;gBAC5C,MAAK;QACX,CAAC;QAED,OAAO,OAAO,CAAA;IACf,CAAC;IAED,OAAO,CAAC,MAAc;QACrB,IAAI,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;QAEtB,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YACtC,IAAI,KAAK,KAAK,CAAC,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,oBAAoB,CAAC,CAAA;YACjF,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QAC/C,CAAC;QAED,IAAI,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;QAC7B,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;YAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;QACzC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAE9B,IAAI,aAAa,GAAG,CAAC,CAAA;QACrB,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC;gBAAE,aAAa,EAAE,CAAA;;gBACtC,MAAK;QACX,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;QAC5D,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,CAAA;QACjC,OAAO,OAAO,CAAA;IACf,CAAC;IAED,MAAM,CAAC,KAAK,GAAG,EAAE;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IAC3C,CAAC;IAED,yCAAyC;IACzC,MAAM,CAAC,KAAiB;QACvB,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAC/B,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,MAAc;QACnB,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9B,CAAC;CACD,CAAC,CAAA"}

package/x/data/base64.d.ts

@@ -1,5 +1,9 @@
-export declare const Base64: {
+export declare const Base64: Readonly<{
+    fromBytes(bytes: Uint8Array): string;
+    toBytes(string: string): Uint8Array<ArrayBuffer>;
+    random(count?: number): string;
+    /** @deprecated rename to "fromBytes" */
     string(bytes: Uint8Array): string;
+    /** @deprecated rename to "toBytes" */
     bytes(string: string): Uint8Array<ArrayBuffer>;
-    random(count?: number): string;
-};
+}>;

package/x/data/base64.js

@@ -1,17 +1,25 @@
 import { Bytes } from "./bytes.js";
-export const Base64 = {
-    string(bytes) {
+export const Base64 = Object.freeze({
+    fromBytes(bytes) {
         return (typeof btoa === "function")
             ? btoa(String.fromCharCode(...bytes))
             : Buffer.from(bytes).toString("base64");
     },
-    bytes(string) {
+    toBytes(string) {
         return (typeof atob === "function")
             ? Uint8Array.from(atob(string), char => char.charCodeAt(0))
             : Uint8Array.from(Buffer.from(string, "base64"));
     },
     random(count = 32) {
-        return this.string(Bytes.random(count));
+        return this.fromBytes(Bytes.random(count));
+    },
+    /** @deprecated rename to "fromBytes" */
+    string(bytes) {
+        return Base64.fromBytes(bytes);
+    },
+    /** @deprecated rename to "toBytes" */
+    bytes(string) {
+        return Base64.toBytes(string);
     },
-};
+});
 //# sourceMappingURL=base64.js.map

package/x/data/base64.js.map

@@ -1 +1 @@
-{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../s/data/base64.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAA;AAEhC,MAAM,CAAC,MAAM,MAAM,GAAG;IAErB,MAAM,CAAC,KAAiB;QACvB,OAAO,CAAC,OAAO,IAAI,KAAK,UAAU,CAAC;YAClC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,CAAC;YACrC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACzC,CAAC;IAED,KAAK,CAAC,MAAc;QACnB,OAAO,CAAC,OAAO,IAAI,KAAK,UAAU,CAAC;YAClC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC3D,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;IAClD,CAAC;IAED,MAAM,CAAC,KAAK,GAAG,EAAE;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IACxC,CAAC;CACD,CAAA"}
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../s/data/base64.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAA;AAEhC,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,SAAS,CAAC,KAAiB;QAC1B,OAAO,CAAC,OAAO,IAAI,KAAK,UAAU,CAAC;YAClC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,CAAC;YACrC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACzC,CAAC;IAED,OAAO,CAAC,MAAc;QACrB,OAAO,CAAC,OAAO,IAAI,KAAK,UAAU,CAAC;YAClC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC3D,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;IAClD,CAAC;IAED,MAAM,CAAC,KAAK,GAAG,EAAE;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IAC3C,CAAC;IAED,wCAAwC;IACxC,MAAM,CAAC,KAAiB;QACvB,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAC/B,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,MAAc;QACnB,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9B,CAAC;CACD,CAAC,CAAA"}

package/x/data/base64url.d.ts

@@ -1,5 +1,9 @@
 export declare const Base64url: {
+    fromBytes(bytes: Uint8Array): string;
+    toBytes(string: string): Uint8Array<ArrayBuffer>;
+    random(count?: number): string;
+    /** @deprecated renamed to "fromBytes" */
     string(bytes: Uint8Array): string;
+    /** @deprecated renamed to "toBytes" */
     bytes(string: string): Uint8Array<ArrayBuffer>;
-    random(count?: number): string;
 };

package/x/data/base64url.js

@@ -1,22 +1,30 @@
 import { Bytes } from "./bytes.js";
 import { Base64 } from "./base64.js";
 export const Base64url = {
-    string(bytes) {
-        return Base64.string(bytes)
+    fromBytes(bytes) {
+        return Base64.fromBytes(bytes)
             .replace(/\+/g, "-")
             .replace(/\//g, "_")
             .replace(/=+$/g, "");
     },
-    bytes(string) {
+    toBytes(string) {
         let b64 = string
             .replace(/-/g, "+")
             .replace(/_/g, "/");
         if (b64.length % 4 !== 0)
             b64 = b64.padEnd(b64.length + (4 - b64.length % 4) % 4, "=");
-        return Base64.bytes(b64);
+        return Base64.toBytes(b64);
     },
     random(count = 32) {
-        return this.string(Bytes.random(count));
+        return this.fromBytes(Bytes.random(count));
+    },
+    /** @deprecated renamed to "fromBytes" */
+    string(bytes) {
+        return Base64url.fromBytes(bytes);
+    },
+    /** @deprecated renamed to "toBytes" */
+    bytes(string) {
+        return Base64url.toBytes(string);
     },
 };
 //# sourceMappingURL=base64url.js.map

package/x/data/base64url.js.map

@@ -1 +1 @@
-{"version":3,"file":"base64url.js","sourceRoot":"","sources":["../../s/data/base64url.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAA;AAChC,OAAO,EAAC,MAAM,EAAC,MAAM,aAAa,CAAA;AAElC,MAAM,CAAC,MAAM,SAAS,GAAG;IAExB,MAAM,CAAC,KAAiB;QACvB,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;aACzB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;aACnB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;aACnB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,MAAc;QACnB,IAAI,GAAG,GAAG,MAAM;aACd,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;aAClB,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QACpB,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;YACvB,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;QAC7D,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACzB,CAAC;IAED,MAAM,CAAC,KAAK,GAAG,EAAE;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IACxC,CAAC;CACD,CAAA"}
+{"version":3,"file":"base64url.js","sourceRoot":"","sources":["../../s/data/base64url.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAA;AAChC,OAAO,EAAC,MAAM,EAAC,MAAM,aAAa,CAAA;AAElC,MAAM,CAAC,MAAM,SAAS,GAAG;IACxB,SAAS,CAAC,KAAiB;QAC1B,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;aAC5B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;aACnB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;aACnB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACtB,CAAC;IAED,OAAO,CAAC,MAAc;QACrB,IAAI,GAAG,GAAG,MAAM;aACd,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;aAClB,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QACpB,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;YACvB,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;QAC7D,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC3B,CAAC;IAED,MAAM,CAAC,KAAK,GAAG,EAAE;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IAC3C,CAAC;IAED,yCAAyC;IACzC,MAAM,CAAC,KAAiB;QACvB,OAAO,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,MAAc;QACnB,OAAO,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACjC,CAAC;CACD,CAAA"}

package/x/data/bytename/bytename.d.ts

@@ -0,0 +1,19 @@
+export type BytenameOptions = {
+    groupSize: number;
+    wordSeparator: string;
+    groupSeparator: string;
+};
+/**
+ * Bytename is a friendly presentation format for arbitrary binary data.
+ *  - looks like "midsen.picmyn.widrep.baclut dotreg.filtyp.nosnus.siptev"
+ *  - each byte maps to a three-letter triplet
+ *  - all delimiters are just sugar, parser doesn't care
+ */
+export declare const Bytename: {
+    defaults: BytenameOptions;
+    random(byteCount: number, options?: Partial<BytenameOptions>): string;
+    fromBytes(bytes: Uint8Array, options?: Partial<BytenameOptions>): string;
+    toBytes(bytename: string): Uint8Array<ArrayBuffer>;
+    toHex(bytename: string): string;
+    fromHex(hex: string, options?: Partial<BytenameOptions>): string;
+};

package/x/data/{barname/barname.js → bytename/bytename.js}

@@ -1,15 +1,25 @@
+import { Hex } from "../hex.js";
 import { Bytes } from "../bytes.js";
 import { prefixes } from "./utils/prefixes.js";
 import { suffixes } from "./utils/suffixes.js";
-const wordSeparator = "_";
-const groupSeparator = " ";
-const defaultWordsPerGroup = 4;
-export const Barname = {
-    random(byteCount) {
-        return this.string(Bytes.random(byteCount));
+/**
+ * Bytename is a friendly presentation format for arbitrary binary data.
+ *  - looks like "midsen.picmyn.widrep.baclut dotreg.filtyp.nosnus.siptev"
+ *  - each byte maps to a three-letter triplet
+ *  - all delimiters are just sugar, parser doesn't care
+ */
+export const Bytename = {
+    defaults: {
+        groupSize: 4,
+        wordSeparator: ".",
+        groupSeparator: " ",
     },
-    string(bytes, options) {
-        const groupSize = options?.wordsPerGroup ?? defaultWordsPerGroup;
+    random(byteCount, options) {
+        const bytes = Bytes.random(byteCount);
+        return this.fromBytes(bytes, options);
+    },
+    fromBytes(bytes, options = {}) {
+        const { groupSize = Bytename.defaults.groupSize, wordSeparator = Bytename.defaults.wordSeparator, groupSeparator = Bytename.defaults.groupSeparator, } = options;
         const words = [];
         let currentWord = [];
         bytes.forEach((byte, index) => {
@@ -27,8 +37,8 @@ export const Barname = {
             grouped.push(words.slice(i, i + groupSize).join(wordSeparator));
         return grouped.join(groupSeparator);
     },
-    bytes(string) {
-        const letters = string
+    toBytes(bytename) {
+        const letters = bytename
             .toLowerCase()
             .replace(/[^a-z]/g, ""); // strip everything except letters
         const count = letters.length / 3;
@@ -45,5 +55,11 @@ export const Barname = {
             return number;
         }));
     },
+    toHex(bytename) {
+        return Hex.fromBytes(Bytename.toBytes(bytename));
+    },
+    fromHex(hex, options) {
+        return Bytename.fromBytes(Hex.toBytes(hex), options);
+    },
 };
-//# sourceMappingURL=barname.js.map
+//# sourceMappingURL=bytename.js.map

package/x/data/bytename/bytename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytename.js","sourceRoot":"","sources":["../../../s/data/bytename/bytename.ts"],"names":[],"mappings":"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"}

package/x/data/bytename/bytename.test.d.ts

@@ -0,0 +1,17 @@
+import { Science } from "@e280/science";
+declare const _default: {
+    "bytes->string->bytes": Science.Test;
+    "zero bytes": Science.Test;
+    "one byte": Science.Test;
+    groupings: Science.Test;
+    wordsep: {
+        underscore: Science.Test;
+        uppercase: Science.Test;
+        dots: Science.Test;
+        crushed: Science.Test;
+        space: Science.Test;
+        spaces: Science.Test;
+        whitespace: Science.Test;
+    };
+};
+export default _default;

package/x/data/bytename/bytename.test.js

@@ -0,0 +1,41 @@
+import { Bytes } from "../bytes.js";
+import { Bytename } from "./bytename.js";
+import { Science, test, expect } from "@e280/science";
+const deadbeef = new Uint8Array([0xDE, 0xAD, 0xBE, 0xEF]);
+function good(bytes) {
+    expect(Bytes.eq(bytes, deadbeef)).ok();
+}
+export default Science.suite({
+    "bytes->string->bytes": test(async () => {
+        const text = Bytename.fromBytes(deadbeef);
+        expect(text).is("ribmug.hilmun");
+        good(Bytename.toBytes(text));
+    }),
+    "zero bytes": test(async () => {
+        const text = Bytename.fromBytes(new Uint8Array([]));
+        expect(text).is("");
+    }),
+    "one byte": test(async () => {
+        const text = Bytename.fromBytes(new Uint8Array([0x00]));
+        expect(text).is("doz");
+    }),
+    "groupings": test(async () => {
+        const bytes = new Uint8Array([...deadbeef, ...deadbeef]);
+        const text = Bytename.fromBytes(bytes, {
+            groupSize: 2,
+            groupSeparator: " ",
+            wordSeparator: ".",
+        });
+        expect(text).is("ribmug.hilmun ribmug.hilmun");
+    }),
+    "wordsep": Science.suite({
+        "underscore": test(async () => good(Bytename.toBytes("ribmug_hilmun"))),
+        "uppercase": test(async () => good(Bytename.toBytes("RIBMUG_HILMUN"))),
+        "dots": test(async () => good(Bytename.toBytes("ribmug.hilmun"))),
+        "crushed": test(async () => good(Bytename.toBytes("ribmughilmun"))),
+        "space": test(async () => good(Bytename.toBytes("ribmug hilmun"))),
+        "spaces": test(async () => good(Bytename.toBytes("ribmug  hilmun"))),
+        "whitespace": test(async () => good(Bytename.toBytes("\n ribmug \n \t \n hilmun \n"))),
+    }),
+});
+//# sourceMappingURL=bytename.test.js.map

package/x/data/bytename/bytename.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytename.test.js","sourceRoot":"","sources":["../../../s/data/bytename/bytename.test.ts"],"names":[],"mappings":"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"}

package/x/data/bytename/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./bytename.js";
+export * from "./thumbprint.js";

package/x/data/bytename/index.js

@@ -0,0 +1,3 @@
+export * from "./bytename.js";
+export * from "./thumbprint.js";
+//# sourceMappingURL=index.js.map

package/x/data/bytename/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../s/data/bytename/index.ts"],"names":[],"mappings":"AACA,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA"}

package/x/data/bytename/thumbprint.d.ts

@@ -0,0 +1,36 @@
+export type ThumbprintOptions = {
+    delimiter: string;
+    sigilBytes: number;
+    previewBytes: number;
+};
+export type ThumbprintData = {
+    bytes: Uint8Array;
+    thumbprint: string;
+    preview: string;
+    bulk: string;
+    sigil: string;
+};
+/**
+ * Thumbprint is a friendly presentation format for arbitrary binary data.
+ *  - looks like "nodlyn.fasrep.habbud.ralwel.Avo7gFmdWMRHkwsD149mcaBoZdS69iXuJ"
+ *  - the preview: "nodlyn.fasrep.habbud.ralwel" (bytename format)
+ *  - the bulk: "Avo7gFmdWMRHkwsD149mcaBoZdS69iXuJ" (base58 format)
+ *  - the sigil: "nodlyn.fasrep" (shorter part of the bytename)
+ *  - originally designed to be a nice way to present 256-bit ids, but can actually represent any number of bytes
+ */
+export declare const Thumbprint: {
+    defaults: ThumbprintOptions;
+    toBytes(thumbprint: string): Uint8Array<ArrayBuffer>;
+    parse(thumbprint: string, options?: Partial<ThumbprintOptions>): ThumbprintData;
+    build: {
+        fromBytes(bytes: Uint8Array, options?: Partial<ThumbprintOptions>): ThumbprintData;
+        fromHex(hex: string, options?: Partial<ThumbprintOptions>): ThumbprintData;
+    };
+    toHex(thumbprint: string): string;
+    fromBytes(bytes: Uint8Array, options?: Partial<ThumbprintOptions>): string;
+    fromHex(hex: string, options?: Partial<ThumbprintOptions>): string;
+    sigil: {
+        fromHex(hex: string, options?: Partial<ThumbprintOptions>): string;
+        fromBytes(bytes: Uint8Array, options?: Partial<ThumbprintOptions>): string;
+    };
+};

package/x/data/bytename/thumbprint.js

@@ -0,0 +1,79 @@
+import { Hex } from "../hex.js";
+import { Base58 } from "../base58.js";
+import { Bytename } from "./bytename.js";
+/**
+ * Thumbprint is a friendly presentation format for arbitrary binary data.
+ *  - looks like "nodlyn.fasrep.habbud.ralwel.Avo7gFmdWMRHkwsD149mcaBoZdS69iXuJ"
+ *  - the preview: "nodlyn.fasrep.habbud.ralwel" (bytename format)
+ *  - the bulk: "Avo7gFmdWMRHkwsD149mcaBoZdS69iXuJ" (base58 format)
+ *  - the sigil: "nodlyn.fasrep" (shorter part of the bytename)
+ *  - originally designed to be a nice way to present 256-bit ids, but can actually represent any number of bytes
+ */
+export const Thumbprint = {
+    defaults: {
+        delimiter: ".",
+        sigilBytes: 4,
+        previewBytes: 8,
+    },
+    toBytes(thumbprint) {
+        thumbprint = thumbprint.trim();
+        const beans = thumbprint.split(/[^a-zA-Z0-9]+/m)
+            .filter(Boolean)
+            .map(s => s.trim());
+        if (beans.length < 2)
+            return Bytename.toBytes(beans.join(""));
+        const bulk = beans.pop();
+        const preview = beans.join("");
+        return new Uint8Array([
+            ...Bytename.toBytes(preview),
+            ...Base58.toBytes(bulk),
+        ]);
+    },
+    parse(thumbprint, options) {
+        const bytes = Thumbprint.toBytes(thumbprint);
+        return Thumbprint.build.fromBytes(bytes, options);
+    },
+    build: {
+        fromBytes(bytes, options = {}) {
+            const { delimiter, previewBytes, sigilBytes } = { ...Thumbprint.defaults, ...options };
+            const yoink = (b) => (bytes.length > 0)
+                ? Bytename.fromBytes(bytes.slice(0, b), {
+                    wordSeparator: delimiter,
+                    groupSeparator: delimiter,
+                })
+                : "";
+            const sigil = yoink(sigilBytes);
+            const preview = yoink(previewBytes);
+            const bulk = (bytes.length > previewBytes)
+                ? Base58.fromBytes(bytes.slice(previewBytes))
+                : "";
+            const thumbprint = [preview, bulk]
+                .filter(s => s.length > 0)
+                .join(delimiter);
+            return { bytes, thumbprint, preview, bulk, sigil };
+        },
+        fromHex(hex, options) {
+            const bytes = Hex.toBytes(hex);
+            return Thumbprint.build.fromBytes(bytes, options);
+        },
+    },
+    toHex(thumbprint) {
+        const bytes = Thumbprint.toBytes(thumbprint);
+        return Hex.fromBytes(bytes);
+    },
+    fromBytes(bytes, options) {
+        return Thumbprint.build.fromBytes(bytes, options).thumbprint;
+    },
+    fromHex(hex, options) {
+        return Thumbprint.fromBytes(Hex.toBytes(hex), options);
+    },
+    sigil: {
+        fromHex(hex, options) {
+            return Thumbprint.build.fromHex(hex, options).sigil;
+        },
+        fromBytes(bytes, options) {
+            return Thumbprint.build.fromBytes(bytes, options).sigil;
+        },
+    },
+};
+//# sourceMappingURL=thumbprint.js.map

package/x/data/bytename/thumbprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thumbprint.js","sourceRoot":"","sources":["../../../s/data/bytename/thumbprint.ts"],"names":[],"mappings":"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"}