@hegeldev/hegel 0.1.0

package/dist/embedded.js

@@ -0,0 +1,237 @@
+/**
+ * Embedded mode implementation for Hegel TypeScript SDK.
+ *
+ * Creates a Unix socket server, spawns the hegel CLI in client mode,
+ * and manages the test loop.
+ */
+import * as net from "node:net";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { spawn } from "node:child_process";
+import { ensureHegel } from "./install.js";
+import { setEmbeddedConnection, clearEmbeddedConnection, setIsLastRun, } from "./connection.js";
+export var Verbosity;
+(function (Verbosity) {
+    Verbosity["Quiet"] = "quiet";
+    Verbosity["Normal"] = "normal";
+    Verbosity["Verbose"] = "verbose";
+    Verbosity["Debug"] = "debug";
+})(Verbosity || (Verbosity = {}));
+/**
+ * Special error thrown by assume() to signal test rejection.
+ */
+export class RejectError extends Error {
+    constructor() {
+        super("HEGEL_REJECT");
+        this.name = "RejectError";
+    }
+}
+/**
+ * Builder class for configuring and running Hegel tests.
+ */
+export class Hegel {
+    testFn;
+    _testCases = 100;
+    _verbosity = Verbosity.Normal;
+    constructor(testFn) {
+        this.testFn = testFn;
+    }
+    /**
+     * Set the number of test cases to run.
+     */
+    testCases(n) {
+        this._testCases = n;
+        return this;
+    }
+    /**
+     * Set the verbosity level.
+     */
+    verbosity(v) {
+        this._verbosity = v;
+        return this;
+    }
+    /**
+     * Run the test.
+     */
+    run() {
+        return runEmbedded(this.testFn, this._testCases, this._verbosity);
+    }
+}
+/**
+ * Simple wrapper for running a Hegel test with default options.
+ */
+export function hegel(testFn) {
+    return new Hegel(testFn).run();
+}
+/**
+ * Run embedded mode: create socket server, spawn hegel, handle connections.
+ * Returns a Promise that resolves when all tests complete.
+ */
+function runEmbedded(testFn, testCases, verbosity) {
+    return new Promise((resolve, reject) => {
+        const hegelPath = ensureHegel();
+        // Create temp directory for socket
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "hegel-ts-"));
+        const socketPath = path.join(tmpDir, "hegel.sock");
+        // Track exit code from hegel process
+        let hegelExitCode = 0;
+        // Track cleanup state
+        let cleaned = false;
+        const cleanup = () => {
+            if (cleaned)
+                return;
+            cleaned = true;
+            try {
+                fs.unlinkSync(socketPath);
+            }
+            catch { }
+            try {
+                fs.rmdirSync(tmpDir);
+            }
+            catch { }
+        };
+        // Create Unix socket server
+        const server = net.createServer();
+        server.listen(socketPath);
+        // Spawn hegel in client mode
+        const child = spawn(hegelPath, [
+            "--client-mode",
+            socketPath,
+            "--test-cases",
+            testCases.toString(),
+            "--no-tui",
+            "--verbosity",
+            verbosity,
+        ], {
+            stdio: ["ignore", "inherit", "inherit"],
+        });
+        child.on("exit", code => {
+            if (verbosity === Verbosity.Debug) {
+                console.error(`hegel-ts: hegel exited with code ${code}`);
+            }
+            hegelExitCode = code ?? 0;
+            server.close();
+        });
+        child.on("error", err => {
+            console.error(`hegel-ts: failed to spawn hegel: ${err.message}`);
+            cleanup();
+            reject(new Error(`Failed to spawn hegel: ${err.message}`));
+        });
+        // Handle connections synchronously using a queue
+        const connectionQueue = [];
+        let processing = false;
+        let connectionCount = 0;
+        server.on("connection", socket => {
+            connectionCount++;
+            if (verbosity === Verbosity.Debug) {
+                console.error(`hegel-ts: connection #${connectionCount} received`);
+            }
+            connectionQueue.push(socket);
+            processQueue();
+        });
+        function processQueue() {
+            if (processing || connectionQueue.length === 0)
+                return;
+            processing = true;
+            const socket = connectionQueue.shift();
+            if (verbosity === Verbosity.Debug) {
+                console.error(`hegel-ts: processing connection, queue size: ${connectionQueue.length}`);
+            }
+            handleConnection(socket, testFn, verbosity)
+                .catch(err => {
+                console.error(`hegel-ts: connection error: ${err.message}`);
+            })
+                .finally(() => {
+                if (verbosity === Verbosity.Debug) {
+                    console.error(`hegel-ts: connection complete`);
+                }
+                processing = false;
+                processQueue();
+            });
+        }
+        server.on("close", () => {
+            if (verbosity === Verbosity.Debug) {
+                console.error("hegel-ts: server closed");
+            }
+            cleanup();
+            if (hegelExitCode !== 0) {
+                reject(new Error(`Hegel server exited with code ${hegelExitCode}`));
+                return;
+            }
+            resolve();
+        });
+    });
+}
+/**
+ * Handle a single connection from hegel (one test case).
+ */
+async function handleConnection(socket, testFn, verbosity) {
+    return new Promise((resolve, reject) => {
+        let buffer = "";
+        const onData = (data) => {
+            buffer += data.toString();
+            // Check for complete handshake message
+            const newlineIndex = buffer.indexOf("\n");
+            if (newlineIndex === -1)
+                return;
+            const line = buffer.slice(0, newlineIndex);
+            buffer = buffer.slice(newlineIndex + 1);
+            socket.removeListener("data", onData);
+            try {
+                // Parse handshake
+                const handshake = JSON.parse(line);
+                const isLastRun = handshake.is_last_run ?? false;
+                if (verbosity === Verbosity.Debug) {
+                    console.error(`hegel-ts: handshake received: is_last_run=${isLastRun}`);
+                }
+                // Send acknowledgment
+                socket.write(JSON.stringify({ type: "handshake_ack" }) + "\n");
+                // Set up connection state for generators
+                setIsLastRun(isLastRun);
+                setEmbeddedConnection(socket, buffer);
+                // Run test function
+                let result;
+                try {
+                    testFn();
+                    result = { type: "test_result", result: "pass" };
+                }
+                catch (err) {
+                    if (err instanceof RejectError) {
+                        result = { type: "test_result", result: "reject" };
+                    }
+                    else {
+                        const message = err instanceof Error ? err.message : String(err);
+                        result = { type: "test_result", result: "fail", message };
+                        // Print error details on last run
+                        if (isLastRun) {
+                            console.error(`\nTest failed: ${message}`);
+                            if (err instanceof Error && err.stack) {
+                                console.error(err.stack);
+                            }
+                        }
+                    }
+                }
+                finally {
+                    clearEmbeddedConnection();
+                }
+                if (verbosity === Verbosity.Debug) {
+                    console.error(`hegel-ts: sending result: ${JSON.stringify(result)}`);
+                }
+                // Send result
+                socket.write(JSON.stringify(result) + "\n", () => {
+                    socket.end();
+                    resolve();
+                });
+            }
+            catch (err) {
+                socket.end();
+                reject(err);
+            }
+        };
+        socket.on("data", onData);
+        socket.on("error", reject);
+        socket.on("close", () => resolve());
+    });
+}
+//# sourceMappingURL=embedded.js.map

package/dist/embedded.js.map

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

package/dist/floats.d.ts

@@ -0,0 +1,57 @@
+import { JsonSchema, BaseGenerator } from "./generator.js";
+/**
+ * Generator for floating-point values with builder pattern.
+ */
+export declare class FloatGenerator extends BaseGenerator<number> {
+    private readonly _min?;
+    private readonly _max?;
+    private readonly _excludeMin;
+    private readonly _excludeMax;
+    private readonly _allowNan;
+    private readonly _allowInfinity;
+    private constructor();
+    /**
+     * Create a new FloatGenerator.
+     */
+    static create(): FloatGenerator;
+    /**
+     * Set the minimum value.
+     */
+    min(value: number): FloatGenerator;
+    /**
+     * Set the maximum value.
+     */
+    max(value: number): FloatGenerator;
+    /**
+     * Exclude the minimum value from the range.
+     */
+    excludeMin(): FloatGenerator;
+    /**
+     * Exclude the maximum value from the range.
+     */
+    excludeMax(): FloatGenerator;
+    /**
+     * Set whether NaN values can be generated.
+     */
+    allowNan(allow: boolean): FloatGenerator;
+    /**
+     * Set whether infinity values can be generated.
+     */
+    allowInfinity(allow: boolean): FloatGenerator;
+    generate(): number;
+    schema(): JsonSchema;
+}
+/**
+ * Create a generator for floating-point values.
+ *
+ * @example
+ * ```typescript
+ * // Generate any float
+ * const gen = floats();
+ *
+ * // Generate floats in a range (exclusive)
+ * const bounded = floats().min(0).max(1).excludeMin().excludeMax();
+ * ```
+ */
+export declare function floats(): FloatGenerator;
+//# sourceMappingURL=floats.d.ts.map

package/dist/floats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floats.d.ts","sourceRoot":"","sources":["../src/floats.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAE1D;;GAEG;AACH,qBAAa,cAAe,SAAQ,aAAa,CAAC,MAAM,CAAC;IAErD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc;IANjC,OAAO;IAWP;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,cAAc;IAI/B;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc;IAWlC;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc;IAWlC;;OAEG;IACH,UAAU,IAAI,cAAc;IAW5B;;OAEG;IACH,UAAU,IAAI,cAAc;IAW5B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc;IAWxC;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc;IAW7C,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI,UAAU;CAoBrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,IAAI,cAAc,CAEvC"}

package/dist/floats.js

@@ -0,0 +1,100 @@
+import { generateFromSchema } from "./connection.js";
+import { BaseGenerator } from "./generator.js";
+/**
+ * Generator for floating-point values with builder pattern.
+ */
+export class FloatGenerator extends BaseGenerator {
+    _min;
+    _max;
+    _excludeMin;
+    _excludeMax;
+    _allowNan;
+    _allowInfinity;
+    constructor(_min, _max, _excludeMin = false, _excludeMax = false, _allowNan = true, _allowInfinity = true) {
+        super();
+        this._min = _min;
+        this._max = _max;
+        this._excludeMin = _excludeMin;
+        this._excludeMax = _excludeMax;
+        this._allowNan = _allowNan;
+        this._allowInfinity = _allowInfinity;
+    }
+    /**
+     * Create a new FloatGenerator.
+     */
+    static create() {
+        return new FloatGenerator();
+    }
+    /**
+     * Set the minimum value.
+     */
+    min(value) {
+        return new FloatGenerator(value, this._max, this._excludeMin, this._excludeMax, this._allowNan, this._allowInfinity);
+    }
+    /**
+     * Set the maximum value.
+     */
+    max(value) {
+        return new FloatGenerator(this._min, value, this._excludeMin, this._excludeMax, this._allowNan, this._allowInfinity);
+    }
+    /**
+     * Exclude the minimum value from the range.
+     */
+    excludeMin() {
+        return new FloatGenerator(this._min, this._max, true, this._excludeMax, this._allowNan, this._allowInfinity);
+    }
+    /**
+     * Exclude the maximum value from the range.
+     */
+    excludeMax() {
+        return new FloatGenerator(this._min, this._max, this._excludeMin, true, this._allowNan, this._allowInfinity);
+    }
+    /**
+     * Set whether NaN values can be generated.
+     */
+    allowNan(allow) {
+        return new FloatGenerator(this._min, this._max, this._excludeMin, this._excludeMax, allow, this._allowInfinity);
+    }
+    /**
+     * Set whether infinity values can be generated.
+     */
+    allowInfinity(allow) {
+        return new FloatGenerator(this._min, this._max, this._excludeMin, this._excludeMax, this._allowNan, allow);
+    }
+    generate() {
+        return generateFromSchema(this.schema());
+    }
+    schema() {
+        const schema = {
+            type: "number",
+            exclude_minimum: this._excludeMin,
+            exclude_maximum: this._excludeMax,
+            allow_nan: this._allowNan,
+            allow_infinity: this._allowInfinity,
+            width: 64, // JavaScript numbers are always f64
+        };
+        if (this._min !== undefined) {
+            schema.minimum = this._min;
+        }
+        if (this._max !== undefined) {
+            schema.maximum = this._max;
+        }
+        return schema;
+    }
+}
+/**
+ * Create a generator for floating-point values.
+ *
+ * @example
+ * ```typescript
+ * // Generate any float
+ * const gen = floats();
+ *
+ * // Generate floats in a range (exclusive)
+ * const bounded = floats().min(0).max(1).excludeMin().excludeMax();
+ * ```
+ */
+export function floats() {
+    return FloatGenerator.create();
+}
+//# sourceMappingURL=floats.js.map

package/dist/floats.js.map

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

package/dist/formats.d.ts

@@ -0,0 +1,62 @@
+import { Generator, JsonSchema, BaseGenerator } from "./generator.js";
+/**
+ * Create a generator for email addresses.
+ */
+export declare function emails(): Generator<string>;
+/**
+ * Create a generator for URLs.
+ */
+export declare function urls(): Generator<string>;
+/**
+ * Generator for domain names with optional max length.
+ */
+export declare class DomainGenerator extends BaseGenerator<string> {
+    private readonly _maxLength;
+    private constructor();
+    static create(): DomainGenerator;
+    /**
+     * Set the maximum length for the domain.
+     */
+    maxLength(value: number): DomainGenerator;
+    generate(): string;
+    schema(): JsonSchema;
+}
+/**
+ * Create a generator for domain names.
+ */
+export declare function domains(): DomainGenerator;
+/**
+ * Generator for IP addresses.
+ */
+export declare class IpAddressGenerator extends BaseGenerator<string> {
+    private readonly _version;
+    private constructor();
+    static create(): IpAddressGenerator;
+    /**
+     * Generate only IPv4 addresses.
+     */
+    v4(): IpAddressGenerator;
+    /**
+     * Generate only IPv6 addresses.
+     */
+    v6(): IpAddressGenerator;
+    generate(): string;
+    schema(): JsonSchema;
+}
+/**
+ * Create a generator for IP addresses.
+ */
+export declare function ipAddresses(): IpAddressGenerator;
+/**
+ * Create a generator for date strings (ISO 8601 date format).
+ */
+export declare function dates(): Generator<string>;
+/**
+ * Create a generator for time strings (ISO 8601 time format).
+ */
+export declare function times(): Generator<string>;
+/**
+ * Create a generator for datetime strings (ISO 8601 datetime format).
+ */
+export declare function datetimes(): Generator<string>;
+//# sourceMappingURL=formats.d.ts.map

package/dist/formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../src/formats.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AA0BrE;;GAEG;AACH,wBAAgB,MAAM,IAAI,SAAS,CAAC,MAAM,CAAC,CAE1C;AAWD;;GAEG;AACH,wBAAgB,IAAI,IAAI,SAAS,CAAC,MAAM,CAAC,CAExC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa,CAAC,MAAM,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAA/C,OAAO;IAIP,MAAM,CAAC,MAAM,IAAI,eAAe;IAIhC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe;IAIzC,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI,UAAU;CAMrB;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,eAAe,CAEzC;AAOD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,aAAa,CAAC,MAAM,CAAC;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAA7C,OAAO;IAIP,MAAM,CAAC,MAAM,IAAI,kBAAkB;IAInC;;OAEG;IACH,EAAE,IAAI,kBAAkB;IAIxB;;OAEG;IACH,EAAE,IAAI,kBAAkB;IAIxB,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI,UAAU;CAYrB;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,kBAAkB,CAEhD;AAWD;;GAEG;AACH,wBAAgB,KAAK,IAAI,SAAS,CAAC,MAAM,CAAC,CAEzC;AAWD;;GAEG;AACH,wBAAgB,KAAK,IAAI,SAAS,CAAC,MAAM,CAAC,CAEzC;AAWD;;GAEG;AACH,wBAAgB,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC,CAE7C"}

package/dist/formats.js

@@ -0,0 +1,164 @@
+import { generateFromSchema } from "./connection.js";
+import { BaseGenerator } from "./generator.js";
+/**
+ * Base class for format string generators.
+ */
+class FormatGenerator extends BaseGenerator {
+    generate() {
+        return generateFromSchema(this.schema());
+    }
+    schema() {
+        return this.getSchema();
+    }
+}
+/**
+ * Generator for email addresses.
+ */
+class EmailGenerator extends FormatGenerator {
+    getSchema() {
+        return { type: "email" };
+    }
+}
+/**
+ * Create a generator for email addresses.
+ */
+export function emails() {
+    return new EmailGenerator();
+}
+/**
+ * Generator for URLs.
+ */
+class UrlGenerator extends FormatGenerator {
+    getSchema() {
+        return { type: "url" };
+    }
+}
+/**
+ * Create a generator for URLs.
+ */
+export function urls() {
+    return new UrlGenerator();
+}
+/**
+ * Generator for domain names with optional max length.
+ */
+export class DomainGenerator extends BaseGenerator {
+    _maxLength;
+    constructor(_maxLength = 255) {
+        super();
+        this._maxLength = _maxLength;
+    }
+    static create() {
+        return new DomainGenerator();
+    }
+    /**
+     * Set the maximum length for the domain.
+     */
+    maxLength(value) {
+        return new DomainGenerator(value);
+    }
+    generate() {
+        return generateFromSchema(this.schema());
+    }
+    schema() {
+        return {
+            type: "domain",
+            max_length: this._maxLength,
+        };
+    }
+}
+/**
+ * Create a generator for domain names.
+ */
+export function domains() {
+    return DomainGenerator.create();
+}
+/**
+ * Generator for IP addresses.
+ */
+export class IpAddressGenerator extends BaseGenerator {
+    _version;
+    constructor(_version = "any") {
+        super();
+        this._version = _version;
+    }
+    static create() {
+        return new IpAddressGenerator();
+    }
+    /**
+     * Generate only IPv4 addresses.
+     */
+    v4() {
+        return new IpAddressGenerator("v4");
+    }
+    /**
+     * Generate only IPv6 addresses.
+     */
+    v6() {
+        return new IpAddressGenerator("v6");
+    }
+    generate() {
+        return generateFromSchema(this.schema());
+    }
+    schema() {
+        switch (this._version) {
+            case "v4":
+                return { type: "ipv4" };
+            case "v6":
+                return { type: "ipv6" };
+            default:
+                return {
+                    one_of: [{ type: "ipv4" }, { type: "ipv6" }],
+                };
+        }
+    }
+}
+/**
+ * Create a generator for IP addresses.
+ */
+export function ipAddresses() {
+    return IpAddressGenerator.create();
+}
+/**
+ * Generator for date strings (YYYY-MM-DD format).
+ */
+class DateGenerator extends FormatGenerator {
+    getSchema() {
+        return { type: "date" };
+    }
+}
+/**
+ * Create a generator for date strings (ISO 8601 date format).
+ */
+export function dates() {
+    return new DateGenerator();
+}
+/**
+ * Generator for time strings (HH:MM:SS format).
+ */
+class TimeGenerator extends FormatGenerator {
+    getSchema() {
+        return { type: "time" };
+    }
+}
+/**
+ * Create a generator for time strings (ISO 8601 time format).
+ */
+export function times() {
+    return new TimeGenerator();
+}
+/**
+ * Generator for datetime strings (ISO 8601 format).
+ */
+class DateTimeGenerator extends FormatGenerator {
+    getSchema() {
+        return { type: "datetime" };
+    }
+}
+/**
+ * Create a generator for datetime strings (ISO 8601 datetime format).
+ */
+export function datetimes() {
+    return new DateTimeGenerator();
+}
+//# sourceMappingURL=formats.js.map

package/dist/formats.js.map

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