@hegeldev/hegel 0.1.0

package/dist/combinators.js

@@ -0,0 +1,152 @@
+import { generateFromSchema } from "./connection.js";
+import { BaseGenerator } from "./generator.js";
+import { booleans } from "./primitives.js";
+import { integers } from "./integers.js";
+import { LABELS } from "./labels.js";
+import { group } from "./spans.js";
+/**
+ * Check if a value is a primitive type that can be represented in sampled_from schema.
+ */
+function isPrimitive(value) {
+    const type = typeof value;
+    return type === "string" || type === "number" || type === "boolean" || value === null;
+}
+/**
+ * Generator that samples uniformly from a fixed collection.
+ */
+class SampledFromGenerator extends BaseGenerator {
+    elements;
+    constructor(elements) {
+        super();
+        this.elements = elements;
+        if (elements.length === 0) {
+            throw new Error("sampledFrom: cannot sample from empty array");
+        }
+    }
+    generate() {
+        const schema = this.schema();
+        if (schema) {
+            return generateFromSchema(schema);
+        }
+        // Compositional fallback for non-primitive types
+        return group(LABELS.SAMPLED_FROM, () => {
+            const index = integers()
+                .min(0)
+                .max(this.elements.length - 1)
+                .generate();
+            return this.elements[index];
+        });
+    }
+    schema() {
+        // Only use sampled_from schema for primitive types
+        if (this.elements.every(isPrimitive)) {
+            return { sampled_from: this.elements };
+        }
+        return null;
+    }
+}
+/**
+ * Create a generator that samples uniformly from a fixed collection.
+ *
+ * @example
+ * ```typescript
+ * const colors = sampledFrom(["red", "green", "blue"]);
+ * const color: string = colors.generate();
+ * ```
+ */
+export function sampledFrom(elements) {
+    return new SampledFromGenerator(elements);
+}
+/**
+ * Generator that chooses from one of several generators.
+ */
+class OneOfGenerator extends BaseGenerator {
+    generators;
+    constructor(generators) {
+        super();
+        this.generators = generators;
+        if (generators.length === 0) {
+            throw new Error("oneOf: no generators provided");
+        }
+    }
+    generate() {
+        const schema = this.schema();
+        if (schema) {
+            return generateFromSchema(schema);
+        }
+        // Compositional fallback
+        return group(LABELS.ONE_OF, () => {
+            const index = integers()
+                .min(0)
+                .max(this.generators.length - 1)
+                .generate();
+            return this.generators[index].generate();
+        });
+    }
+    schema() {
+        const schemas = [];
+        for (const gen of this.generators) {
+            const s = gen.schema();
+            if (!s)
+                return null;
+            schemas.push(s);
+        }
+        return { one_of: schemas };
+    }
+}
+/**
+ * Create a generator that chooses from one of several generators.
+ *
+ * @example
+ * ```typescript
+ * const gen = oneOf(
+ *   integers().min(0).max(10),
+ *   integers().min(100).max(110)
+ * );
+ * ```
+ */
+export function oneOf(...generators) {
+    return new OneOfGenerator(generators);
+}
+/**
+ * Generator for optional values (T | null).
+ */
+class OptionalGenerator extends BaseGenerator {
+    inner;
+    constructor(inner) {
+        super();
+        this.inner = inner;
+    }
+    generate() {
+        const schema = this.schema();
+        if (schema) {
+            return generateFromSchema(schema);
+        }
+        // Compositional fallback
+        return group(LABELS.OPTIONAL, () => {
+            const isNull = booleans().generate();
+            return isNull ? null : this.inner.generate();
+        });
+    }
+    schema() {
+        const innerSchema = this.inner.schema();
+        if (!innerSchema)
+            return null;
+        return {
+            one_of: [{ type: "null" }, innerSchema],
+        };
+    }
+}
+/**
+ * Create a generator for optional values (T | null).
+ *
+ * @example
+ * ```typescript
+ * const gen = optional(integers());
+ * const value: number | null = gen.generate();
+ * ```
+ */
+export function optional(inner) {
+    return new OptionalGenerator(inner);
+}
+//# sourceMappingURL=combinators.js.map

package/dist/combinators.js.map

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

package/dist/conformance.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Conformance testing helpers for Hegel for TypeScript.
+ *
+ * Provides utilities used by conformance binary scripts to read test
+ * configuration from environment variables and write per-test-case metrics
+ * to the conformance metrics file.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Return the number of conformance test cases to run.
+ *
+ * Reads `CONFORMANCE_TEST_CASES` from the environment. Defaults to 50 if
+ * the variable is absent, empty, non-numeric, or non-positive.
+ *
+ * @returns Number of test cases (always ≥ 1).
+ */
+export declare function getTestCases(): number;
+/**
+ * Append a JSON metrics line to the conformance metrics file.
+ *
+ * The metrics file path is read from the `CONFORMANCE_METRICS_FILE`
+ * environment variable. Panics (throws) if the variable is not set or the
+ * file cannot be written.
+ *
+ * @param metrics - Plain object to serialise as a single JSON line.
+ * @throws {Error} If `CONFORMANCE_METRICS_FILE` is not set.
+ * @throws {Error} If the file cannot be opened or written.
+ */
+export declare function writeMetrics(metrics: Record<string, unknown>): void;
+//# sourceMappingURL=conformance.d.ts.map

package/dist/conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../src/conformance.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAcnE"}

package/dist/conformance.js

@@ -0,0 +1,60 @@
+/**
+ * Conformance testing helpers for Hegel for TypeScript.
+ *
+ * Provides utilities used by conformance binary scripts to read test
+ * configuration from environment variables and write per-test-case metrics
+ * to the conformance metrics file.
+ *
+ * @packageDocumentation
+ */
+import * as fs from "node:fs";
+// ---------------------------------------------------------------------------
+// getTestCases
+// ---------------------------------------------------------------------------
+/**
+ * Return the number of conformance test cases to run.
+ *
+ * Reads `CONFORMANCE_TEST_CASES` from the environment. Defaults to 50 if
+ * the variable is absent, empty, non-numeric, or non-positive.
+ *
+ * @returns Number of test cases (always ≥ 1).
+ */
+export function getTestCases() {
+    const val = process.env["CONFORMANCE_TEST_CASES"];
+    if (!val)
+        return 50;
+    const n = parseInt(val, 10);
+    if (!Number.isFinite(n) || n <= 0)
+        return 50;
+    return n;
+}
+// ---------------------------------------------------------------------------
+// writeMetrics
+// ---------------------------------------------------------------------------
+/**
+ * Append a JSON metrics line to the conformance metrics file.
+ *
+ * The metrics file path is read from the `CONFORMANCE_METRICS_FILE`
+ * environment variable. Panics (throws) if the variable is not set or the
+ * file cannot be written.
+ *
+ * @param metrics - Plain object to serialise as a single JSON line.
+ * @throws {Error} If `CONFORMANCE_METRICS_FILE` is not set.
+ * @throws {Error} If the file cannot be opened or written.
+ */
+export function writeMetrics(metrics) {
+    const path = process.env["CONFORMANCE_METRICS_FILE"];
+    if (!path) {
+        throw new Error("hegel: CONFORMANCE_METRICS_FILE env var not set");
+    }
+    // JSON.stringify does not escape U+0085 (NEL), U+2028 (LINE SEPARATOR),
+    // or U+2029 (PARAGRAPH SEPARATOR). Python's str.splitlines() splits on
+    // all three, breaking JSONL parsing. Escape them explicitly.
+    const json = JSON.stringify(metrics)
+        .replace(/\u0085/g, "\\u0085")
+        .replace(/\u2028/g, "\\u2028")
+        .replace(/\u2029/g, "\\u2029");
+    const line = json + "\n";
+    fs.appendFileSync(path, line, "utf8");
+}
+//# sourceMappingURL=conformance.js.map

package/dist/conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../src/conformance.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAClD,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7C,OAAO,CAAC,CAAC;AACX,CAAC;AAED,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,OAAgC;IAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IACrD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,wEAAwE;IACxE,uEAAuE;IACvE,6DAA6D;IAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SACjC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC;SAC7B,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC;SAC7B,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACzB,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC"}

package/dist/connection.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Synchronous connection and stream multiplexing over stdio pipes.
+ *
+ * The Connection reads/writes raw bytes via file descriptors using
+ * `fs.readSync`/`fs.writeSync`. The Stream class provides request/reply
+ * semantics with CBOR encoding on top.
+ *
+ * @packageDocumentation
+ */
+import { type Packet } from "./protocol.js";
+export declare class Connection {
+    private readFd;
+    private writeFd;
+    private nextStreamCounter;
+    private streamInboxes;
+    private serverExited;
+    constructor(readFd: number, writeFd: number);
+    markServerExited(): void;
+    hasServerExited(): boolean;
+    /**
+     * Read exactly `n` bytes from the pipe, blocking until available.
+     * Handles EAGAIN from non-blocking file descriptors.
+     */
+    readExact(n: number): Buffer;
+    /**
+     * Write a packet to the server synchronously.
+     */
+    sendPacket(packet: Packet): void;
+    /**
+     * Read packets until one for the given stream arrives.
+     * Packets for other streams are buffered in their inboxes.
+     */
+    readPacketForStream(streamId: number): Packet;
+    /**
+     * Create a new client-initiated stream (odd ID).
+     */
+    newStream(): Stream;
+    /**
+     * Connect to an existing server-allocated stream.
+     */
+    connectStream(streamId: number): Stream;
+    /**
+     * Get the control stream (stream ID 0).
+     */
+    controlStream(): Stream;
+    /**
+     * Remove buffered packets for a stream.
+     */
+    unregisterStream(streamId: number): void;
+}
+export declare class Stream {
+    readonly streamId: number;
+    private connection;
+    private nextMessageId;
+    private responses;
+    private requests;
+    private closed;
+    constructor(streamId: number, connection: Connection);
+    markClosed(): void;
+    private checkClosed;
+    /**
+     * Send a request packet and return the message ID.
+     */
+    sendRequest(payload: Buffer): number;
+    /**
+     * Send a reply to an incoming request.
+     */
+    writeReply(messageId: number, payload: Buffer): void;
+    /**
+     * Wait for a reply to a previously sent request.
+     */
+    receiveReply(messageId: number): Buffer;
+    /**
+     * Wait for an incoming request from the server.
+     */
+    receiveRequest(): [number, Buffer];
+    /**
+     * Close this stream gracefully.
+     */
+    close(): void;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,KAAK,MAAM,EAKZ,MAAM,eAAe,CAAC;AAgBvB,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAK3C,gBAAgB,IAAI,IAAI;IAIxB,eAAe,IAAI,OAAO;IAI1B;;;OAGG;IACH,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IA2B5B;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKhC;;;OAGG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAyB7C;;OAEG;IACH,SAAS,IAAI,MAAM;IAKnB;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIvC;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAGzC;AAMD,qBAAa,MAAM;IACjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,MAAM,CAAS;gBAEX,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU;IAKpD,UAAU,IAAI,IAAI;IAIlB,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAYpC;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IASpD;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAyBvC;;OAEG;IACH,cAAc,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC;IAmBlC;;OAEG;IACH,KAAK,IAAI,IAAI;CAWd"}

package/dist/connection.js

@@ -0,0 +1,231 @@
+/**
+ * Synchronous connection and stream multiplexing over stdio pipes.
+ *
+ * The Connection reads/writes raw bytes via file descriptors using
+ * `fs.readSync`/`fs.writeSync`. The Stream class provides request/reply
+ * semantics with CBOR encoding on top.
+ *
+ * @packageDocumentation
+ */
+import * as fs from "node:fs";
+import { encodePacket, readPacketFrom, CLOSE_STREAM_MESSAGE_ID, CLOSE_STREAM_PAYLOAD, } from "./protocol.js";
+// ---------------------------------------------------------------------------
+// Sleep helper (for EAGAIN retry on non-blocking fds)
+// ---------------------------------------------------------------------------
+const sleepArray = new Int32Array(new SharedArrayBuffer(4));
+function sleepMs(ms) {
+    Atomics.wait(sleepArray, 0, 0, ms);
+}
+// ---------------------------------------------------------------------------
+// Connection
+// ---------------------------------------------------------------------------
+export class Connection {
+    readFd;
+    writeFd;
+    nextStreamCounter = 0;
+    streamInboxes = new Map();
+    serverExited = false;
+    constructor(readFd, writeFd) {
+        this.readFd = readFd;
+        this.writeFd = writeFd;
+    }
+    markServerExited() {
+        this.serverExited = true;
+    }
+    hasServerExited() {
+        return this.serverExited;
+    }
+    /**
+     * Read exactly `n` bytes from the pipe, blocking until available.
+     * Handles EAGAIN from non-blocking file descriptors.
+     */
+    readExact(n) {
+        const buf = Buffer.alloc(n);
+        let offset = 0;
+        while (offset < n) {
+            try {
+                const bytesRead = fs.readSync(this.readFd, buf, offset, n - offset, null);
+                if (bytesRead === 0) {
+                    this.serverExited = true;
+                    throw new Error("Connection closed: server process exited");
+                }
+                offset += bytesRead;
+            }
+            catch (e) {
+                if (e instanceof Error &&
+                    "code" in e &&
+                    (e.code === "EAGAIN" ||
+                        e.code === "EWOULDBLOCK")) {
+                    sleepMs(1);
+                    continue;
+                }
+                throw e;
+            }
+        }
+        return buf;
+    }
+    /**
+     * Write a packet to the server synchronously.
+     */
+    sendPacket(packet) {
+        const data = encodePacket(packet);
+        fs.writeSync(this.writeFd, data);
+    }
+    /**
+     * Read packets until one for the given stream arrives.
+     * Packets for other streams are buffered in their inboxes.
+     */
+    readPacketForStream(streamId) {
+        // Check inbox first
+        const inbox = this.streamInboxes.get(streamId);
+        if (inbox && inbox.length > 0) {
+            return inbox.shift();
+        }
+        // Read from pipe until we get a packet for this stream
+        while (true) {
+            const packet = readPacketFrom((n) => this.readExact(n));
+            if (packet.streamId === streamId) {
+                return packet;
+            }
+            // Buffer for other streams
+            let otherInbox = this.streamInboxes.get(packet.streamId);
+            if (!otherInbox) {
+                otherInbox = [];
+                this.streamInboxes.set(packet.streamId, otherInbox);
+            }
+            otherInbox.push(packet);
+        }
+    }
+    /**
+     * Create a new client-initiated stream (odd ID).
+     */
+    newStream() {
+        const id = ((this.nextStreamCounter++ << 1) | 1) >>> 0;
+        return new Stream(id, this);
+    }
+    /**
+     * Connect to an existing server-allocated stream.
+     */
+    connectStream(streamId) {
+        return new Stream(streamId, this);
+    }
+    /**
+     * Get the control stream (stream ID 0).
+     */
+    controlStream() {
+        return new Stream(0, this);
+    }
+    /**
+     * Remove buffered packets for a stream.
+     */
+    unregisterStream(streamId) {
+        this.streamInboxes.delete(streamId);
+    }
+}
+// ---------------------------------------------------------------------------
+// Stream
+// ---------------------------------------------------------------------------
+export class Stream {
+    streamId;
+    connection;
+    nextMessageId = 1;
+    responses = new Map();
+    requests = [];
+    closed = false;
+    constructor(streamId, connection) {
+        this.streamId = streamId;
+        this.connection = connection;
+    }
+    markClosed() {
+        this.closed = true;
+    }
+    checkClosed() {
+        if (this.closed) {
+            throw new Error("Stream is closed");
+        }
+    }
+    /**
+     * Send a request packet and return the message ID.
+     */
+    sendRequest(payload) {
+        this.checkClosed();
+        const messageId = this.nextMessageId++;
+        this.connection.sendPacket({
+            streamId: this.streamId,
+            messageId,
+            isReply: false,
+            payload,
+        });
+        return messageId;
+    }
+    /**
+     * Send a reply to an incoming request.
+     */
+    writeReply(messageId, payload) {
+        this.connection.sendPacket({
+            streamId: this.streamId,
+            messageId,
+            isReply: true,
+            payload,
+        });
+    }
+    /**
+     * Wait for a reply to a previously sent request.
+     */
+    receiveReply(messageId) {
+        // Check buffered responses first
+        const buffered = this.responses.get(messageId);
+        if (buffered !== undefined) {
+            this.responses.delete(messageId);
+            return buffered;
+        }
+        while (true) {
+            this.checkClosed();
+            const packet = this.connection.readPacketForStream(this.streamId);
+            if (packet.isReply && packet.messageId === messageId) {
+                return packet.payload;
+            }
+            // Buffer for later
+            if (packet.isReply) {
+                this.responses.set(packet.messageId, packet.payload);
+            }
+            else {
+                this.requests.push(packet);
+            }
+        }
+    }
+    /**
+     * Wait for an incoming request from the server.
+     */
+    receiveRequest() {
+        if (this.requests.length > 0) {
+            const packet = this.requests.shift();
+            return [packet.messageId, packet.payload];
+        }
+        while (true) {
+            this.checkClosed();
+            const packet = this.connection.readPacketForStream(this.streamId);
+            if (!packet.isReply) {
+                return [packet.messageId, packet.payload];
+            }
+            // Buffer reply for later
+            this.responses.set(packet.messageId, packet.payload);
+        }
+    }
+    /**
+     * Close this stream gracefully.
+     */
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.connection.unregisterStream(this.streamId);
+        this.connection.sendPacket({
+            streamId: this.streamId,
+            messageId: CLOSE_STREAM_MESSAGE_ID,
+            isReply: false,
+            payload: CLOSE_STREAM_PAYLOAD,
+        });
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

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

package/dist/crc32.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CRC32 (IEEE 802.3 / ISO-HDLC, polynomial 0xEDB88320).
+ *
+ * Vendored so the library works on Node versions older than 22.2.0.
+ */
+/**
+ * Compute the CRC32 checksum of a byte buffer.
+ *
+ * @param data - The bytes to checksum.
+ * @returns The CRC32 as an unsigned 32-bit integer.
+ */
+export declare function crc32(data: Uint8Array): number;
+//# sourceMappingURL=crc32.d.ts.map

package/dist/crc32.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crc32.d.ts","sourceRoot":"","sources":["../src/crc32.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAM9C"}

package/dist/crc32.js

@@ -0,0 +1,30 @@
+/**
+ * CRC32 (IEEE 802.3 / ISO-HDLC, polynomial 0xEDB88320).
+ *
+ * Vendored so the library works on Node versions older than 22.2.0.
+ */
+const CRC_TABLE = (() => {
+    const table = new Uint32Array(256);
+    for (let i = 0; i < 256; i++) {
+        let c = i;
+        for (let k = 0; k < 8; k++) {
+            c = (c & 1) !== 0 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+        }
+        table[i] = c;
+    }
+    return table;
+})();
+/**
+ * Compute the CRC32 checksum of a byte buffer.
+ *
+ * @param data - The bytes to checksum.
+ * @returns The CRC32 as an unsigned 32-bit integer.
+ */
+export function crc32(data) {
+    let crc = 0xffffffff;
+    for (let i = 0; i < data.length; i++) {
+        crc = CRC_TABLE[(crc ^ data[i]) & 0xff] ^ (crc >>> 8);
+    }
+    return (crc ^ 0xffffffff) >>> 0;
+}
+//# sourceMappingURL=crc32.js.map

package/dist/crc32.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crc32.js","sourceRoot":"","sources":["../src/crc32.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,SAAS,GAAgB,CAAC,GAAG,EAAE;IACnC,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACvD,CAAC;QACD,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC,EAAE,CAAC;AAEL;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,IAAgB;IACpC,IAAI,GAAG,GAAG,UAAU,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,GAAG,GAAG,SAAS,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAE,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC"}