@helios-lang/effect 0.1.0

package/dist/internal/Base32.js.map

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

package/dist/internal/BigEndian.js

@@ -0,0 +1,56 @@
+import { Either } from "effect";
+import { DecodeException } from "./Bytes.js";
+/**
+ * Converts a list of big endian uint8 numbers into an unbounded int
+ * @param bytes
+ * @returns
+ * @throws
+ * If `bytes` is empty
+ * @throws
+ * If any input number is out of range [0,256) or not a whole number
+ */
+export function decode(bytes) {
+    if (bytes.length == 0) {
+        return Either.left(DecodeException(bytes, "Empty bytes"));
+    }
+    let p = 1n;
+    let total = 0n;
+    for (let i = bytes.length - 1; i >= 0; i--) {
+        const b = bytes[i];
+        if (b < 0 || b > 255 || b % 1.0 != 0.0) {
+            return Either.left(DecodeException(bytes, `Invalide bytes '${b}' at position ${i}`));
+        }
+        total += BigInt(b) * p;
+        p *= 256n;
+    }
+    return Either.right(total);
+}
+/**
+ * Converts an unbounded integer into a list of big endian uint8 numbers.
+ * @param x
+ * @returns
+ * @throws
+ * If `x` isn't a whole number
+ * @throws
+ * If `x` is negative.
+ */
+export function encode(x) {
+    if (typeof x == "number") {
+        return encode(BigInt(x));
+    }
+    else if (x < 0n) {
+        throw new RangeError(`Unexpected negative number: ${x}`);
+    }
+    else if (x == 0n) {
+        return [0];
+    }
+    else {
+        const res = [];
+        while (x > 0n) {
+            res.unshift(Number(x % 256n));
+            x = x / 256n;
+        }
+        return res;
+    }
+}
+//# sourceMappingURL=BigEndian.js.map

package/dist/internal/BigEndian.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BigEndian.js","sourceRoot":"","sources":["../../src/internal/BigEndian.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAY,MAAM,QAAQ,CAAA;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CACpB,KAA4B;IAE5B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAA;IAC3D,CAAC;IAED,IAAI,CAAC,GAAG,EAAE,CAAA;IACV,IAAI,KAAK,GAAG,EAAE,CAAA;IAEd,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QAElB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YACvC,OAAO,MAAM,CAAC,IAAI,CAChB,eAAe,CAAC,KAAK,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,CAAC,CACjE,CAAA;QACH,CAAC;QAED,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QAEtB,CAAC,IAAI,IAAI,CAAA;IACX,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;AAC5B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAC,CAAkB;IACvC,IAAI,OAAO,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1B,CAAC;SAAM,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,UAAU,CAAC,+BAA+B,CAAC,EAAE,CAAC,CAAA;IAC1D,CAAC;SAAM,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACnB,OAAO,CAAC,CAAC,CAAC,CAAA;IACZ,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAa,EAAE,CAAA;QAExB,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;YACd,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAA;YAE7B,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;QACd,CAAC;QAED,OAAO,GAAG,CAAA;IACZ,CAAC;AACH,CAAC"}

package/dist/internal/Bits.js

@@ -0,0 +1,300 @@
+import { Either } from "effect";
+import * as Bytes from "./Bytes.js";
+/**
+ * @param bytes
+ * @param truncate defaults to true
+ * @returns {BitReader}
+ */
+export function makeReader(bytes, truncate = true) {
+    return new ReaderImpl(bytes, truncate ?? true);
+}
+class ReaderImpl {
+    view;
+    /**
+     * bit position, not byte position
+     */
+    pos;
+    /**
+     * If true then read last bits as low part of number, if false pad with zero bits (only applies when trying to read more bits than there are left )
+     */
+    truncate;
+    /**
+     * @param bytes
+     * @param truncate determines behavior when reading too many bits
+     */
+    constructor(bytes, truncate = true) {
+        this.view = Bytes.toUint8Array(bytes);
+        this.pos = 0;
+        this.truncate = truncate;
+    }
+    isAtEnd() {
+        return Math.trunc(this.pos / 8) >= this.view.length;
+    }
+    /**
+     * Moves position to next byte boundary
+     * @param force
+     * If true then move to next byte boundary if already at byte boundary
+     */
+    moveToByteBoundary(force = false) {
+        if (this.pos % 8 != 0) {
+            const n = 8 - (this.pos % 8);
+            void this.readBits(n);
+        }
+        else if (force) {
+            this.readBits(8);
+        }
+    }
+    /**
+     * Reads a number of bits (<= 8) and returns the result as an unsigned number
+     * @param n number of bits to read
+     * @returns
+     * @throws
+     * If at end
+     * @throws
+     * If n is larger than 8
+     */
+    readBits(n) {
+        if (n > 8) {
+            throw new RangeError(`Reading more than 1 byte (trying to read ${n} bits)`);
+        }
+        let leftShift = 0;
+        if (this.pos + n > this.view.length * 8) {
+            const newN = this.view.length * 8 - this.pos;
+            if (!this.truncate) {
+                leftShift = n - newN;
+            }
+            n = newN;
+        }
+        if (n == 0) {
+            throw new Error("Bits.Reader is at end");
+        }
+        // it is assumed we don't need to be at the byte boundary
+        let res = 0;
+        let i0 = this.pos;
+        for (let i = this.pos + 1; i <= this.pos + n; i++) {
+            if (i % 8 == 0) {
+                const nPart = i - i0;
+                res += mask(this.view[Math.trunc(i / 8) - 1], i0 % 8, 8) << (n - nPart);
+                i0 = i;
+            }
+            else if (i == this.pos + n) {
+                res += mask(this.view[Math.trunc(i / 8)], i0 % 8, i % 8);
+            }
+        }
+        this.pos += n;
+        return res << leftShift;
+    }
+    /**
+     * Reads 8 bits
+     * @returns
+     */
+    readByte() {
+        return this.readBits(8);
+    }
+}
+/**
+ * @returns
+ * Writer instance
+ */
+export function makeWriter() {
+    return new WriterImpl();
+}
+class WriterImpl {
+    /**
+     * Concatenated and padded upon finalization
+     */
+    parts;
+    /**
+     * Number of bits written so far
+     */
+    n;
+    constructor() {
+        this.parts = [];
+        this.n = 0;
+    }
+    get length() {
+        return this.n;
+    }
+    /**
+     * Pads the Bits.Writer to align with the byte boundary and returns the resulting bytes.
+     * @param force force padding (will add one byte if already aligned)
+     * @returns
+     */
+    finalize(force = true) {
+        this.padToByteBoundary(force);
+        const chars = this.parts.join("");
+        const bytes = [];
+        for (let i = 0; i < chars.length; i += 8) {
+            const byteChars = chars.slice(i, i + 8);
+            const byte = parseInt(byteChars, 2);
+            bytes.push(byte);
+        }
+        return bytes;
+    }
+    /**
+     * Add padding to the BitWriter in order to align with the byte boundary.
+     * @param force
+     * If 'force == true' then 8 bits are added if the Writer is already aligned.
+     */
+    padToByteBoundary(force = false) {
+        let nPad = 0;
+        if (this.n % 8 != 0) {
+            nPad = 8 - (this.n % 8);
+        }
+        else if (force) {
+            nPad = 8;
+        }
+        if (nPad != 0) {
+            const padding = new Array(nPad).fill("0");
+            padding[nPad - 1] = "1";
+            this.parts.push(padding.join(""));
+            this.n += nPad;
+        }
+    }
+    /**
+     * Pop n bits of the end
+     * @param n
+     * @returns
+     */
+    pop(n) {
+        if (n > this.n) {
+            throw new Error(`Too many bits to pop, only have ${this.n} bits, but want n=${n}`);
+        }
+        const n0 = n;
+        const parts = [];
+        while (n > 0) {
+            const last = this.parts.pop();
+            if (last !== undefined) {
+                if (last.length <= n) {
+                    parts.unshift(last);
+                    n -= last.length;
+                }
+                else {
+                    parts.unshift(last.slice(last.length - n));
+                    this.parts.push(last.slice(0, last.length - n));
+                    n = 0;
+                }
+            }
+        }
+        this.n -= n0;
+        const bits = parts.join("");
+        if (bits.length != n0) {
+            throw new Error(`Internal error: expected ${n0} bits popped, but popped ${bits.length}`);
+        }
+        return bits;
+    }
+    /**
+     * Write a string of '0's and '1's to the BitWriter.
+     * Returns the BitWriter to enable chaining
+     * @param bitChars
+     * @returns
+     * Self so these calls can be chain
+     */
+    writeBits(bitChars) {
+        for (const c of bitChars) {
+            if (c != "0" && c != "1") {
+                throw new Error(`Bit string contains invalid chars: ${bitChars}`);
+            }
+        }
+        this.parts.push(bitChars);
+        this.n += bitChars.length;
+        return this;
+    }
+    /**
+     * Returns the BitWriter to enable chaining
+     * @param byte
+     * @returns
+     * Self so these calls can be chain
+     */
+    writeByte(byte) {
+        if (byte < 0 || byte > 255) {
+            throw new Error(`Invalid byte: ${byte}`);
+        }
+        this.writeBits(pad(byte.toString(2), 8));
+        return this;
+    }
+}
+/**
+ * Converts a 8 bit integer number into a bit string with an optional "0b" prefix.
+ * The result is padded with leading zeroes to become 'n' chars long ('2 + n' chars long if you count the "0b" prefix).
+ * @example
+ * byteToBits(7) == "0b00000111"
+ * @param {number} b
+ * @param {number} n
+ * @param {boolean} prefix
+ * @returns {string}
+ */
+export function fromByte(b, n = 8, prefix = true) {
+    if (b < 0 || b > 255) {
+        return Either.left(new RangeError(`Invalid byte: ${b}`));
+    }
+    const bits = b.toString(2);
+    if (n < bits.length) {
+        return Either.left(new RangeError(`n is smaller than the number of bits: ${n} < ${bits.length}`));
+    }
+    const s = pad(bits, n);
+    if (prefix) {
+        return Either.right("0b" + s);
+    }
+    else {
+        return Either.right(s);
+    }
+}
+/**
+ * @param bytes
+ * @param i
+ * bit index
+ * @returns
+ * 0 or 1
+ */
+export function getBit(bytes, i) {
+    return ((bytes[Math.floor(i / 8)] >> (i % 8)) & 1);
+}
+const BIT_MASKS = [
+    0b11111111, 0b01111111, 0b00111111, 0b00011111, 0b00001111, 0b00000111,
+    0b00000011, 0b00000001
+];
+/**
+ * Masks bits of `b` by setting bits outside the range `[i0, i1)` to 0.
+ * `b` is an 8 bit integer (i.e. number between 0 and 255).
+ * The return value is also an 8 bit integer, shifted right by `i1`.
+ * @example
+ * maskBits(0b11111111, 1, 4) == 0b0111 // (i.e. 7)
+ * @param b
+ * @param i0
+ * @param i1
+ * @returns
+ */
+export function mask(b, i0, i1) {
+    if (i0 >= i1 || i0 < 0 || i0 > 7 || i1 > 8 || b < 0 || b > 255) {
+        throw new RangeError(`Invalid Bits.mask arguments: b=${b}, i0=${i0}, i1=${i1}`);
+    }
+    return (b & BIT_MASKS[i0]) >> (8 - i1);
+}
+/**
+ * Prepends zeroes to a bit-string so that 'result.length == n'.
+ * If `n < nCurrent`, pad to next multiple of `n`.
+ * @example
+ * padBits("1111", 8) == "00001111"
+ * @param bits
+ * @param n
+ * @returns
+ * @throws
+ * If n is zero or negative
+ */
+export function pad(bits, n) {
+    const nBits = bits.length;
+    if (nBits == n) {
+        return bits;
+    }
+    else if (n <= 0) {
+        throw new RangeError(`Expected pad length n to be > 0, got n=${n}`);
+    }
+    else if (nBits % n != 0) {
+        // padded to multiple of n
+        const nPad = n - (nBits % n);
+        bits = new Array(nPad).fill("0").join("") + bits;
+    }
+    return bits;
+}
+//# sourceMappingURL=Bits.js.map

package/dist/internal/Bits.js.map

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

package/dist/internal/Bytes.js

@@ -0,0 +1,293 @@
+import { Data, Effect, Encoding } from "effect";
+import { encode as encodeIntBE } from "./BigEndian";
+export class EndOfStreamError extends Data.TaggedError("EndOfStreamError") {
+    constructor(stream) {
+        super({ message: `Bytes.Stream is at end (pos=${stream.pos})` });
+    }
+}
+/**
+ * Doesn't throw an error if any input number is outside the range [0,256)
+ * @param bytes
+ * @returns
+ */
+export function toArray(bytes) {
+    if (bytes instanceof Uint8Array) {
+        return Array.from(bytes);
+    }
+    else if (typeof bytes == "string") {
+        const result = Encoding.decodeHex(bytes);
+        if (result._tag == "Left") {
+            // eslint-disable-next-line @typescript-eslint/only-throw-error
+            throw result.left;
+        }
+        return Array.from(result.right);
+    }
+    else if (Array.isArray(bytes)) {
+        return bytes;
+    }
+    else if ("peekRemaining" in bytes) {
+        return bytes.peekRemaining();
+    }
+    else {
+        throw new Error("Expected BytesLike");
+    }
+}
+export function toHex(bytes) {
+    if (bytes instanceof Uint8Array) {
+        return Encoding.encodeHex(bytes);
+    }
+    else if (typeof bytes == "string") {
+        return bytes;
+    }
+    else if (Array.isArray(bytes)) {
+        return Encoding.encodeHex(Uint8Array.from(bytes));
+    }
+    else if ("peekRemaining" in bytes) {
+        return Encoding.encodeHex(Uint8Array.from(bytes.peekRemaining()));
+    }
+    else {
+        throw new Error("Expected BytesLike");
+    }
+}
+/**
+ * Doesn't throw an error if any input number is outside the range [0,256)
+ * @param bytes
+ * @returns
+ */
+export function toUint8Array(bytes) {
+    if (bytes instanceof Uint8Array) {
+        return bytes;
+    }
+    else if (typeof bytes == "string") {
+        const result = Encoding.decodeHex(bytes);
+        if (result._tag == "Left") {
+            // eslint-disable-next-line @typescript-eslint/only-throw-error
+            throw result.left;
+        }
+        return result.right;
+    }
+    else if (Array.isArray(bytes)) {
+        return Uint8Array.from(bytes);
+    }
+    else if ("peekRemaining" in bytes) {
+        return bytes.bytes.slice(bytes.pos);
+    }
+    else {
+        throw new Error(`Expected BytesLike`);
+    }
+}
+/**
+ * @param arg
+ * @returns
+ */
+export function makeStream(arg) {
+    if (arg instanceof StreamImpl) {
+        // most common case
+        return arg;
+    }
+    else if (typeof arg == "string" || Array.isArray(arg)) {
+        return new StreamImpl(toUint8Array(arg));
+    }
+    else if ("pos" in arg && "bytes" in arg) {
+        return arg;
+    }
+    else if (arg instanceof Uint8Array) {
+        return new StreamImpl(arg);
+    }
+    return makeStream(arg.bytes);
+}
+class StreamImpl {
+    bytes;
+    pos;
+    /**
+     * @param bytes
+     * @param pos
+     */
+    constructor(bytes, pos = 0) {
+        this.bytes = bytes;
+        this.pos = pos;
+    }
+    /**
+     * Copy ByteStream so mutations doesn't change original ByteStream
+     * @returns
+     */
+    copy() {
+        return new StreamImpl(this.bytes, this.pos);
+    }
+    isAtEnd() {
+        return this.pos >= this.bytes.length;
+    }
+    /**
+     * @returns
+     * The byte at the current position
+     */
+    peekOne() {
+        if (this.pos < this.bytes.length) {
+            return Effect.succeed(this.bytes[this.pos]);
+        }
+        else {
+            return Effect.fail(new EndOfStreamError(this));
+        }
+    }
+    /**
+     * @param n
+     * @returns
+     * @throws
+     * If n is negative
+     */
+    peekMany(n) {
+        if (n < 0) {
+            throw new RangeError(`Unexpected negative n: ${n}`);
+        }
+        if (this.pos + n <= this.bytes.length) {
+            return Effect.succeed(Array.from(this.bytes.slice(this.pos, this.pos + n)));
+        }
+        else {
+            return Effect.fail(new EndOfStreamError(this));
+        }
+    }
+    peekRemaining() {
+        return Array.from(this.bytes.slice(this.pos));
+    }
+    /**
+     * @returns
+     * @throws
+     * If at end
+     */
+    shiftOne() {
+        if (this.pos < this.bytes.length) {
+            const b = this.bytes[this.pos];
+            this.pos += 1;
+            return Effect.succeed(b);
+        }
+        else {
+            return Effect.fail(new EndOfStreamError(this));
+        }
+    }
+    /**
+     * @param n
+     * @returns {number[]}
+     * @throws
+     * If n is negative
+     */
+    shiftMany(n) {
+        if (n < 0) {
+            throw new RangeError(`Unexpected negative n: ${n}`);
+        }
+        if (this.pos + n <= this.bytes.length) {
+            const res = Array.from(this.bytes.slice(this.pos, this.pos + n));
+            this.pos += n;
+            return Effect.succeed(res);
+        }
+        else {
+            return Effect.fail(new EndOfStreamError(this));
+        }
+    }
+    shiftRemaining() {
+        const res = Array.from(this.bytes.slice(this.pos));
+        this.pos = this.bytes.length;
+        return res;
+    }
+}
+/**
+ * @param a
+ * @param b
+ * @param shortestFirst defaults to false (strictly lexicographic comparison)
+ * @returns
+ * -1 if a < b, 0 if a == b, 1 if a > b
+ */
+export function compare(a, b, shortestFirst = false) {
+    const la = toArray(a);
+    const lb = toArray(b);
+    const na = la.length;
+    const nb = lb.length;
+    if (shortestFirst && na != nb) {
+        return na < nb ? -1 : 1;
+    }
+    for (let i = 0; i < Math.min(na, nb); i++) {
+        if (la[i] < lb[i]) {
+            return -1;
+        }
+        else if (la[i] > lb[i]) {
+            return 1;
+        }
+    }
+    if (na != nb) {
+        return na < nb ? -1 : 1;
+    }
+    else {
+        return 0;
+    }
+}
+/**
+ * Used to create dummy hashes for testing
+ * @param n
+ * @param seed
+ * @returns
+ */
+export function dummy(n, seed = 0) {
+    return pad(encodeIntBE(seed), n).slice(0, n);
+}
+/**
+ * @param a
+ * @param b
+ * @returns
+ */
+export function equals(a, b) {
+    return compare(a, b) == 0;
+}
+/**
+ * Pad by appending zeroes.
+ * If `n < nCurrent`, pad to next multiple of `n`.
+ * @param bytes
+ * @param n pad length
+ * @returns
+ * @throws
+ * If pad length is zero or negative
+ */
+export function pad(bytes, n) {
+    const nBytes = bytes.length;
+    if (nBytes == n) {
+        return bytes;
+    }
+    else if (n <= 0) {
+        throw new Error(`Invalid pad length (must be > 0, got ${n})`);
+    }
+    else if (nBytes % n != 0 || nBytes == 0) {
+        // padded to multiple of n
+        const nPad = n - (nBytes % n);
+        bytes = bytes.concat(new Array(nPad).fill(0));
+    }
+    return bytes;
+}
+/**
+ * Pad by prepending zeroes.
+ * Throws an error
+ * @param bytes
+ * @param n prepad length
+ * @returns
+ * @throws
+ * If prepad length is zero or negative
+ * @throws
+ * if bytes.length > n
+ */
+export function prepad(bytes, n) {
+    const nBytes = bytes.length;
+    if (nBytes == n) {
+        return bytes;
+    }
+    else if (n <= 0) {
+        throw new Error(`Invalid prepad length (must be > 0, got ${n})`);
+    }
+    else if (nBytes > n) {
+        throw new Error(`Padding goal length smaller than bytes length (${n} < ${nBytes})`);
+    }
+    else {
+        const nPad = n - nBytes;
+        return new Array(nPad).fill(0).concat(bytes);
+    }
+}
+export function DecodeException(bytes, message) {
+    return Encoding.DecodeException(toHex(bytes), message);
+}
+//# sourceMappingURL=Bytes.js.map