bufferbase 1.3.0 → 2.0.0

package/src/types.ts

@@ -0,0 +1,129 @@
+import { Buffer } from 'node:buffer';
+
+/**
+ * Input type accepted by encode functions.
+ *
+ * Supports both Node.js `Buffer` and standard `Uint8Array` for browser compatibility.
+ *
+ * @example
+ * ```typescript
+ * // Node.js Buffer
+ * encode(Buffer.from('Hello'), 'base58');
+ *
+ * // Browser Uint8Array
+ * encode(new Uint8Array([72, 101, 108, 108, 111]), 'base58');
+ * ```
+ */
+export type BufferLike = Buffer | Uint8Array;
+
+/**
+ * Supported base encoding names.
+ *
+ * These names can be used with the function API:
+ * - `'decimal'` - Base 10 (0-9)
+ * - `'base16'` / `'hex'` - Hexadecimal (0-9A-F)
+ * - `'base32'` - RFC 4648 Base32 (A-Z2-7)
+ * - `'base32crockford'` - Crockford's Base32 (0-9A-HJKMNP-TV-Z)
+ * - `'base36'` - Alphanumeric (0-9A-Z)
+ * - `'base52'` - Letters only (A-Za-z)
+ * - `'base58'` - Bitcoin alphabet (no 0OIl)
+ * - `'base64'` - Standard Base64 (A-Za-z0-9+/)
+ * - `'base64url'` - URL-safe Base64 (A-Za-z0-9-_)
+ * - `'base64xml'` - XML token Base64 (A-Za-z0-9._)
+ * - `'base64xmlname'` - XML name Base64 (A-Za-z0-9_:)
+ * - `'ascii85'` - ASCII85 encoding
+ * - `'base85'` - Base85 encoding
+ * - `'z85'` - ZeroMQ Z85 encoding
+ *
+ * @example
+ * ```typescript
+ * import { encode, decode } from 'bufferbase';
+ *
+ * const encoded = encode(Buffer.from('Hello'), 'base58');
+ * const decoded = decode(encoded, 'base58');
+ * ```
+ */
+export type BaseName =
+  | 'decimal'
+  | 'base16'
+  | 'hex'
+  | 'base32'
+  | 'base32crockford'
+  | 'base36'
+  | 'base52'
+  | 'base58'
+  | 'base64'
+  | 'base64url'
+  | 'base64xml'
+  | 'base64xmlname'
+  | 'ascii85'
+  | 'base85'
+  | 'z85';
+
+/**
+ * Options for decode operations.
+ *
+ * @example
+ * ```typescript
+ * // Decode with fixed buffer size (pads with leading zeros)
+ * const buffer = decode(encoded, 'base58', { size: 32 });
+ * ```
+ */
+export interface DecodeOptions {
+  /**
+   * Expected buffer size in bytes.
+   * - If decoded result is smaller, pads with leading zeros.
+   * - If decoded result is larger, throws `BufferSizeError`.
+   */
+  size?: number;
+}
+
+/**
+ * Codec interface for encoding/decoding operations.
+ *
+ * Implemented by the `Codec` class and used by pre-defined codecs in `Codecs`.
+ *
+ * @example
+ * ```typescript
+ * import { Codecs } from 'bufferbase';
+ *
+ * const encoded = Codecs.base58.encode(Buffer.from('Hello'));
+ * const decoded = Codecs.base58.decode(encoded);
+ * ```
+ */
+export interface ICodec {
+  /** Character set used for encoding. */
+  readonly chars: string;
+
+  /**
+   * Encodes a buffer to a base-encoded string.
+   * @param buffer - The buffer or Uint8Array to encode
+   * @returns Base-encoded string
+   */
+  encode(buffer: BufferLike): string;
+
+  /**
+   * Decodes a base-encoded string to a buffer.
+   * @param encoded - The string to decode
+   * @param options - Decode options (e.g., fixed size)
+   * @returns Decoded buffer
+   * @throws {InvalidCharacterError} If the string contains invalid characters
+   * @throws {BufferSizeError} If the result exceeds the specified size
+   */
+  decode(encoded: string, options?: DecodeOptions): Buffer;
+
+  /**
+   * Validates if a string contains only valid characters for this base.
+   * @param input - The string to validate
+   * @returns `true` if valid, `false` otherwise
+   */
+  validate(input: string): boolean;
+
+  /**
+   * Converts a string from this base to another base.
+   * @param target - Target codec to convert to
+   * @param input - The string to convert
+   * @returns String in the target base encoding
+   */
+  convertTo(target: ICodec, input: string): string;
+}

package/dist/cjs/bufferbase.d.mts

@@ -1,60 +0,0 @@
-/// <reference types="node" />
-/**
- * A collection of common bases.
- */
-export declare const Chars: {
-    Decimal: string;
-    Base16: string;
-    Base32: string;
-    Base32Crockford: string;
-    Base36: string;
-    Base52: string;
-    Base58: string;
-    Base64_STD: string;
-    Base64_URL_SAFE: string;
-    Base64_XML_NMTOKEN: string;
-    Base64_XML_NAME: string;
-    Ascii85: string;
-    Base85: string;
-    Z85: string;
-};
-export declare class InvalidCharacterError extends Error {
-    message: string;
-}
-export declare class BufferSizeError extends Error {
-    message: string;
-}
-/**
- * Encodes and decodes buffers to and from a base.
- */
-export declare class BufferEncoder {
-    private baseChars;
-    constructor(baseChars: string);
-    /**
-     * Encodes a buffer to a string.
-     */
-    encode(buffer: Buffer): string;
-    /**
-     * Decodes a string to a buffer.
-     */
-    decode(encoded: string, bufferSize?: number): Buffer;
-}
-/**
- * Creates a converter function that can convert between two bases.
- */
-export declare class Converter {
-    decoder: BufferEncoder;
-    encoder: BufferEncoder;
-    constructor(inputBase: string, outputBase: string);
-    /**
-     * Converts a string from the input base to the output base.
-     */
-    convert(input: string): string;
-}
-export declare class Validator {
-    decorder: BufferEncoder;
-    constructor(inputBase: string);
-    validate(input: string): boolean;
-}
-export declare const validate: (input: string, base: string) => boolean;
-//# sourceMappingURL=bufferbase.d.mts.map

package/dist/cjs/bufferbase.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bufferbase.d.mts","sourceRoot":"","sources":["../../src/bufferbase.mts"],"names":[],"mappings":";AAAA;;GAEG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;CAqBjB,CAAC;AAEF,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,OAAO,SAA6B;CACrC;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,OAAO,SAAwC;CAChD;AAED;;GAEG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM;IAErC;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IA2B9B;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;CAgCrD;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;gBAEX,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAKjD;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAG/B;AAED,qBAAa,SAAS;IACpB,QAAQ,EAAE,aAAa,CAAC;gBAEZ,SAAS,EAAE,MAAM;IAI7B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAWjC;AAED,eAAO,MAAM,QAAQ,UAAW,MAAM,QAAQ,MAAM,KAAG,OAEtD,CAAC"}

package/dist/cjs/bufferbase.mjs

@@ -1,150 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validate = exports.Validator = exports.Converter = exports.BufferEncoder = exports.BufferSizeError = exports.InvalidCharacterError = exports.Chars = void 0;
-/**
- * A collection of common bases.
- */
-exports.Chars = {
-    Decimal: '0123456789',
-    Base16: '0123456789ABCDEF',
-    Base32: 'ABCDEFGHIJKLMNOPQRSTUVWXYZ234567',
-    Base32Crockford: '0123456789ABCDEFGHJKMNPQRSTVWXYZ',
-    Base36: '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ',
-    Base52: 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz',
-    Base58: '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz',
-    Base64_STD: 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/',
-    Base64_URL_SAFE: 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_',
-    Base64_XML_NMTOKEN: 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._',
-    Base64_XML_NAME: 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_:',
-    Ascii85: '!"#$%&\'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[]^_`abcdefghijklmnopqrstu',
-    Base85: '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ!#$%&()*+-;<=>?@^_`{|}~',
-    Z85: '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ.-:+=^!/*?&<>()[]{}@%$#',
-};
-class InvalidCharacterError extends Error {
-    constructor() {
-        super(...arguments);
-        this.message = 'Invalid character found';
-    }
-}
-exports.InvalidCharacterError = InvalidCharacterError;
-class BufferSizeError extends Error {
-    constructor() {
-        super(...arguments);
-        this.message = 'Buffer size exceeds specified size';
-    }
-}
-exports.BufferSizeError = BufferSizeError;
-/**
- * Encodes and decodes buffers to and from a base.
- */
-class BufferEncoder {
-    constructor(baseChars) {
-        this.baseChars = baseChars;
-    }
-    /**
-     * Encodes a buffer to a string.
-     */
-    encode(buffer) {
-        let result = [];
-        for (const byte of buffer) {
-            let carry = byte;
-            for (let j = 0; j < result.length; j++) {
-                carry += result[j] * 256;
-                result[j] = carry % this.baseChars.length;
-                carry = Math.floor(carry / this.baseChars.length);
-            }
-            while (carry > 0) {
-                result.push(carry % this.baseChars.length);
-                carry = Math.floor(carry / this.baseChars.length);
-            }
-        }
-        for (const byte of buffer) {
-            if (byte === 0) {
-                result.push(0);
-            }
-            else {
-                break;
-            }
-        }
-        return result
-            .reverse()
-            .map((index) => this.baseChars[index])
-            .join('');
-    }
-    /**
-     * Decodes a string to a buffer.
-     */
-    decode(encoded, bufferSize) {
-        let result = Buffer.alloc(0);
-        for (const char of encoded) {
-            const value = this.baseChars.indexOf(char);
-            if (value === -1)
-                throw new InvalidCharacterError();
-            let carry = value;
-            let tempResult = Buffer.alloc(result.length);
-            let i;
-            for (i = 0; i < result.length; i++) {
-                carry += result[i] * this.baseChars.length;
-                tempResult[i] = carry % 256;
-                carry = Math.floor(carry / 256);
-            }
-            while (carry > 0) {
-                tempResult = Buffer.concat([tempResult, Buffer.from([carry % 256])]);
-                carry = Math.floor(carry / 256);
-            }
-            result = tempResult;
-        }
-        // buffer size
-        if (bufferSize && result.length < bufferSize) {
-            result = Buffer.concat([
-                result,
-                Buffer.from(Array(bufferSize - result.length).fill(0)),
-            ]);
-        }
-        if (bufferSize && result.length > bufferSize) {
-            throw new BufferSizeError();
-        }
-        result.reverse();
-        return result;
-    }
-}
-exports.BufferEncoder = BufferEncoder;
-/**
- * Creates a converter function that can convert between two bases.
- */
-class Converter {
-    constructor(inputBase, outputBase) {
-        this.decoder = new BufferEncoder(inputBase);
-        this.encoder = new BufferEncoder(outputBase);
-    }
-    /**
-     * Converts a string from the input base to the output base.
-     */
-    convert(input) {
-        return this.encoder.encode(this.decoder.decode(input));
-    }
-}
-exports.Converter = Converter;
-class Validator {
-    constructor(inputBase) {
-        this.decorder = new BufferEncoder(inputBase);
-    }
-    validate(input) {
-        try {
-            this.decorder.decode(input);
-            return true;
-        }
-        catch (e) {
-            if (e instanceof InvalidCharacterError) {
-                return false;
-            }
-            throw e;
-        }
-    }
-}
-exports.Validator = Validator;
-const validate = (input, base) => {
-    return new Validator(base).validate(input);
-};
-exports.validate = validate;
-//# sourceMappingURL=bufferbase.mjs.map

package/dist/cjs/bufferbase.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"bufferbase.mjs","sourceRoot":"","sources":["../../src/bufferbase.mts"],"names":[],"mappings":"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"}

package/dist/cjs/example.d.mts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=example.d.mts.map

package/dist/cjs/example.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"example.d.mts","sourceRoot":"","sources":["../../src/example.mts"],"names":[],"mappings":""}

package/dist/cjs/example.mjs

@@ -1,39 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const bufferbase_mjs_1 = require("./bufferbase.mjs");
-// Example buffer
-const bytes = Buffer.from('Hello, World!', 'utf8');
-// Encoding buffer to Base32
-const encoder = new bufferbase_mjs_1.BufferEncoder(bufferbase_mjs_1.Chars.Base32Crockford);
-const base32encoded = encoder.encode(bytes);
-// Converting Base32 to Base58
-const converter_32to58 = new bufferbase_mjs_1.Converter(bufferbase_mjs_1.Chars.Base32Crockford, bufferbase_mjs_1.Chars.Base58);
-const base58encoded = converter_32to58.convert(base32encoded);
-// Converting Base32 to Base58
-const converter_58to64 = new bufferbase_mjs_1.Converter(bufferbase_mjs_1.Chars.Base58, bufferbase_mjs_1.Chars.Base64_URL_SAFE);
-const base64encoded = converter_58to64.convert(base58encoded);
-// Validating Base64
-const validatorB64 = new bufferbase_mjs_1.Validator(bufferbase_mjs_1.Chars.Base64_URL_SAFE);
-const isValidAsBase64 = validatorB64.validate(base64encoded);
-// Decoding Base64
-const decoder = new bufferbase_mjs_1.BufferEncoder(bufferbase_mjs_1.Chars.Base64_URL_SAFE);
-const decoded = decoder.decode(base64encoded);
-console.table({
-    bytes: bytes.toString('utf8'),
-    base32encoded,
-    base58encoded,
-    base64encoded,
-    isValidAsBase64,
-    decoded: decoded.toString('utf8'),
-});
-// ┌─────────────────┬─────────────────────────┐
-// │ (index)         │ Values                  │
-// ├─────────────────┼─────────────────────────┤
-// │ bytes           │ 'Hello, World!'         │
-// │ base32encoded   │ '4GSBCDHQJR82QDXS6RS11' │
-// │ base58encoded   │ '72k1xXWG59fYdzSNoA'    │
-// │ base64encoded   │ 'BIZWxsbywgV29ybGQh'    │
-// │ isValidAsBase64 │ true                    │
-// │ decoded         │ 'Hello, World!'         │
-// └─────────────────┴─────────────────────────┘
-//# sourceMappingURL=example.mjs.map

package/dist/cjs/example.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"example.mjs","sourceRoot":"","sources":["../../src/example.mts"],"names":[],"mappings":";;AAAA,qDAA8E;AAE9E,iBAAiB;AACjB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;AAEnD,4BAA4B;AAC5B,MAAM,OAAO,GAAG,IAAI,8BAAa,CAAC,sBAAK,CAAC,eAAe,CAAC,CAAC;AACzD,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAE5C,8BAA8B;AAC9B,MAAM,gBAAgB,GAAG,IAAI,0BAAS,CAAC,sBAAK,CAAC,eAAe,EAAE,sBAAK,CAAC,MAAM,CAAC,CAAC;AAC5E,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;AAE9D,8BAA8B;AAC9B,MAAM,gBAAgB,GAAG,IAAI,0BAAS,CAAC,sBAAK,CAAC,MAAM,EAAE,sBAAK,CAAC,eAAe,CAAC,CAAC;AAC5E,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;AAE9D,oBAAoB;AACpB,MAAM,YAAY,GAAG,IAAI,0BAAS,CAAC,sBAAK,CAAC,eAAe,CAAC,CAAC;AAC1D,MAAM,eAAe,GAAG,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;AAE7D,kBAAkB;AAClB,MAAM,OAAO,GAAG,IAAI,8BAAa,CAAC,sBAAK,CAAC,eAAe,CAAC,CAAC;AACzD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;AAE9C,OAAO,CAAC,KAAK,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC7B,aAAa;IACb,aAAa;IACb,aAAa;IACb,eAAe;IACf,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;CAClC,CAAC,CAAC;AACH,gDAAgD;AAChD,gDAAgD;AAChD,gDAAgD;AAChD,gDAAgD;AAChD,gDAAgD;AAChD,gDAAgD;AAChD,gDAAgD;AAChD,gDAAgD;AAChD,gDAAgD;AAChD,gDAAgD"}

package/dist/cjs/index.d.mts

@@ -1,2 +0,0 @@
-export { Chars, BufferEncoder, Converter, InvalidCharacterError, Validator, validate, } from './bufferbase.mjs';
-//# sourceMappingURL=index.d.mts.map

package/dist/cjs/index.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/index.mts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,aAAa,EACb,SAAS,EACT,qBAAqB,EACrB,SAAS,EACT,QAAQ,GACT,MAAM,kBAAkB,CAAC"}

package/dist/cjs/index.mjs

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validate = exports.Validator = exports.InvalidCharacterError = exports.Converter = exports.BufferEncoder = exports.Chars = void 0;
-var bufferbase_mjs_1 = require("./bufferbase.mjs");
-Object.defineProperty(exports, "Chars", { enumerable: true, get: function () { return bufferbase_mjs_1.Chars; } });
-Object.defineProperty(exports, "BufferEncoder", { enumerable: true, get: function () { return bufferbase_mjs_1.BufferEncoder; } });
-Object.defineProperty(exports, "Converter", { enumerable: true, get: function () { return bufferbase_mjs_1.Converter; } });
-Object.defineProperty(exports, "InvalidCharacterError", { enumerable: true, get: function () { return bufferbase_mjs_1.InvalidCharacterError; } });
-Object.defineProperty(exports, "Validator", { enumerable: true, get: function () { return bufferbase_mjs_1.Validator; } });
-Object.defineProperty(exports, "validate", { enumerable: true, get: function () { return bufferbase_mjs_1.validate; } });
-//# sourceMappingURL=index.mjs.map

package/dist/cjs/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/index.mts"],"names":[],"mappings":";;;AAAA,mDAO0B;AANxB,uGAAA,KAAK,OAAA;AACL,+GAAA,aAAa,OAAA;AACb,2GAAA,SAAS,OAAA;AACT,uHAAA,qBAAqB,OAAA;AACrB,2GAAA,SAAS,OAAA;AACT,0GAAA,QAAQ,OAAA"}

package/dist/esm/bufferbase.d.mts

@@ -1,60 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-/**
- * A collection of common bases.
- */
-export declare const Chars: {
-    Decimal: string;
-    Base16: string;
-    Base32: string;
-    Base32Crockford: string;
-    Base36: string;
-    Base52: string;
-    Base58: string;
-    Base64_STD: string;
-    Base64_URL_SAFE: string;
-    Base64_XML_NMTOKEN: string;
-    Base64_XML_NAME: string;
-    Ascii85: string;
-    Base85: string;
-    Z85: string;
-};
-export declare class InvalidCharacterError extends Error {
-    message: string;
-}
-export declare class BufferSizeError extends Error {
-    message: string;
-}
-/**
- * Encodes and decodes buffers to and from a base.
- */
-export declare class BufferEncoder {
-    private baseChars;
-    constructor(baseChars: string);
-    /**
-     * Encodes a buffer to a string.
-     */
-    encode(buffer: Buffer): string;
-    /**
-     * Decodes a string to a buffer.
-     */
-    decode(encoded: string, bufferSize?: number): Buffer;
-}
-/**
- * Creates a converter function that can convert between two bases.
- */
-export declare class Converter {
-    decoder: BufferEncoder;
-    encoder: BufferEncoder;
-    constructor(inputBase: string, outputBase: string);
-    /**
-     * Converts a string from the input base to the output base.
-     */
-    convert(input: string): string;
-}
-export declare class Validator {
-    decorder: BufferEncoder;
-    constructor(inputBase: string);
-    validate(input: string): boolean;
-}
-export declare const validate: (input: string, base: string) => boolean;
-//# sourceMappingURL=bufferbase.d.mts.map

package/dist/esm/bufferbase.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bufferbase.d.mts","sourceRoot":"","sources":["../../src/bufferbase.mts"],"names":[],"mappings":";AAAA;;GAEG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;CAqBjB,CAAC;AAEF,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,OAAO,SAA6B;CACrC;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,OAAO,SAAwC;CAChD;AAED;;GAEG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM;IAErC;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IA2B9B;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;CAgCrD;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;gBAEX,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAKjD;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAG/B;AAED,qBAAa,SAAS;IACpB,QAAQ,EAAE,aAAa,CAAC;gBAEZ,SAAS,EAAE,MAAM;IAI7B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAWjC;AAED,eAAO,MAAM,QAAQ,UAAW,MAAM,QAAQ,MAAM,KAAG,OAEtD,CAAC"}

package/dist/esm/bufferbase.mjs

@@ -1,141 +0,0 @@
-/**
- * A collection of common bases.
- */
-export const Chars = {
-    Decimal: '0123456789',
-    Base16: '0123456789ABCDEF',
-    Base32: 'ABCDEFGHIJKLMNOPQRSTUVWXYZ234567',
-    Base32Crockford: '0123456789ABCDEFGHJKMNPQRSTVWXYZ',
-    Base36: '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ',
-    Base52: 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz',
-    Base58: '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz',
-    Base64_STD: 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/',
-    Base64_URL_SAFE: 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_',
-    Base64_XML_NMTOKEN: 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._',
-    Base64_XML_NAME: 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_:',
-    Ascii85: '!"#$%&\'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[]^_`abcdefghijklmnopqrstu',
-    Base85: '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ!#$%&()*+-;<=>?@^_`{|}~',
-    Z85: '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ.-:+=^!/*?&<>()[]{}@%$#',
-};
-export class InvalidCharacterError extends Error {
-    constructor() {
-        super(...arguments);
-        this.message = 'Invalid character found';
-    }
-}
-export class BufferSizeError extends Error {
-    constructor() {
-        super(...arguments);
-        this.message = 'Buffer size exceeds specified size';
-    }
-}
-/**
- * Encodes and decodes buffers to and from a base.
- */
-export class BufferEncoder {
-    constructor(baseChars) {
-        this.baseChars = baseChars;
-    }
-    /**
-     * Encodes a buffer to a string.
-     */
-    encode(buffer) {
-        let result = [];
-        for (const byte of buffer) {
-            let carry = byte;
-            for (let j = 0; j < result.length; j++) {
-                carry += result[j] * 256;
-                result[j] = carry % this.baseChars.length;
-                carry = Math.floor(carry / this.baseChars.length);
-            }
-            while (carry > 0) {
-                result.push(carry % this.baseChars.length);
-                carry = Math.floor(carry / this.baseChars.length);
-            }
-        }
-        for (const byte of buffer) {
-            if (byte === 0) {
-                result.push(0);
-            }
-            else {
-                break;
-            }
-        }
-        return result
-            .reverse()
-            .map((index) => this.baseChars[index])
-            .join('');
-    }
-    /**
-     * Decodes a string to a buffer.
-     */
-    decode(encoded, bufferSize) {
-        let result = Buffer.alloc(0);
-        for (const char of encoded) {
-            const value = this.baseChars.indexOf(char);
-            if (value === -1)
-                throw new InvalidCharacterError();
-            let carry = value;
-            let tempResult = Buffer.alloc(result.length);
-            let i;
-            for (i = 0; i < result.length; i++) {
-                carry += result[i] * this.baseChars.length;
-                tempResult[i] = carry % 256;
-                carry = Math.floor(carry / 256);
-            }
-            while (carry > 0) {
-                tempResult = Buffer.concat([tempResult, Buffer.from([carry % 256])]);
-                carry = Math.floor(carry / 256);
-            }
-            result = tempResult;
-        }
-        // buffer size
-        if (bufferSize && result.length < bufferSize) {
-            result = Buffer.concat([
-                result,
-                Buffer.from(Array(bufferSize - result.length).fill(0)),
-            ]);
-        }
-        if (bufferSize && result.length > bufferSize) {
-            throw new BufferSizeError();
-        }
-        result.reverse();
-        return result;
-    }
-}
-/**
- * Creates a converter function that can convert between two bases.
- */
-export class Converter {
-    constructor(inputBase, outputBase) {
-        this.decoder = new BufferEncoder(inputBase);
-        this.encoder = new BufferEncoder(outputBase);
-    }
-    /**
-     * Converts a string from the input base to the output base.
-     */
-    convert(input) {
-        return this.encoder.encode(this.decoder.decode(input));
-    }
-}
-export class Validator {
-    constructor(inputBase) {
-        this.decorder = new BufferEncoder(inputBase);
-    }
-    validate(input) {
-        try {
-            this.decorder.decode(input);
-            return true;
-        }
-        catch (e) {
-            if (e instanceof InvalidCharacterError) {
-                return false;
-            }
-            throw e;
-        }
-    }
-}
-export const validate = (input, base) => {
-    return new Validator(base).validate(input);
-};
-//# sourceMappingURL=bufferbase.mjs.map

package/dist/esm/bufferbase.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"bufferbase.mjs","sourceRoot":"","sources":["../../src/bufferbase.mts"],"names":[],"mappings":"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"}

package/dist/esm/example.d.mts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=example.d.mts.map

package/dist/esm/example.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"example.d.mts","sourceRoot":"","sources":["../../src/example.mts"],"names":[],"mappings":""}