muonroi-cli 1.2.3 → 1.3.1

package/dist/src/utils/__tests__/ee-logger.test.js

@@ -0,0 +1,165 @@
+/**
+ * Unit tests for src/utils/ee-logger.ts.
+ *
+ * The logger is the foundation of Phase 21 observability — every silent EE
+ * catch site routes through it. These tests pin down the four guarantees:
+ *   1. Warn line has stable `[ee.<source>.<kind>]` prefix shape.
+ *   2. `ee-timeout` / `ee-error` events fire when the agent runtime is wired.
+ *   3. No-op event path when the runtime is absent (composer-only sessions).
+ *   4. Never throws on `null` / `undefined` / non-Error `err` arguments.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { classifyEeError, logEeFailure, withEeTimeout } from "../ee-logger.js";
+function installRuntime() {
+    const stub = { emitEvent: vi.fn() };
+    globalThis.__muonroiAgentRuntime = stub;
+    return stub;
+}
+function removeRuntime() {
+    delete globalThis.__muonroiAgentRuntime;
+}
+describe("ee-logger", () => {
+    let warnSpy;
+    beforeEach(() => {
+        warnSpy = vi.spyOn(console, "warn").mockImplementation(() => undefined);
+        removeRuntime();
+    });
+    afterEach(() => {
+        warnSpy.mockRestore();
+        removeRuntime();
+    });
+    describe("logEeFailure", () => {
+        it("emits warn with [ee.<source>.<kind>] prefix and structured error", () => {
+            const err = new Error("connection refused");
+            logEeFailure("bridge.classifyViaBrain", "error", err, { elapsedMs: 12 });
+            expect(warnSpy).toHaveBeenCalledTimes(1);
+            const args = warnSpy.mock.calls[0];
+            expect(args[0]).toBe("[ee.bridge.classifyViaBrain.error]");
+            expect(args[1]).toEqual({ name: "Error", message: "connection refused" });
+            expect(args[2]).toEqual({ elapsedMs: 12 });
+        });
+        it("emits ee-timeout event when runtime is present and kind=timeout", () => {
+            const stub = installRuntime();
+            const err = Object.assign(new Error("aborted"), { name: "TimeoutError" });
+            logEeFailure("bridge.searchByText", "timeout", err, {
+                elapsedMs: 1502,
+                budgetMs: 1500,
+            });
+            expect(stub.emitEvent).toHaveBeenCalledTimes(1);
+            const ev = stub.emitEvent.mock.calls[0][0];
+            expect(ev.t).toBe("event");
+            expect(ev.kind).toBe("ee-timeout");
+            expect(ev.source).toBe("bridge.searchByText");
+            expect(ev.elapsedMs).toBe(1502);
+            expect(ev.budgetMs).toBe(1500);
+            expect(typeof ev.ts).toBe("number");
+        });
+        it("emits ee-error event with name/message when runtime is present and kind=error", () => {
+            const stub = installRuntime();
+            const err = new TypeError("not a function");
+            logEeFailure("client.posttool", "error", err);
+            expect(stub.emitEvent).toHaveBeenCalledTimes(1);
+            const ev = stub.emitEvent.mock.calls[0][0];
+            expect(ev.kind).toBe("ee-error");
+            expect(ev.source).toBe("client.posttool");
+            expect(ev.name).toBe("TypeError");
+            expect(ev.message).toBe("not a function");
+            expect(typeof ev.ts).toBe("number");
+        });
+        it("is a no-op on the event path when runtime is absent", () => {
+            // No installRuntime() — runtime missing.
+            expect(() => logEeFailure("pil.layer4.routeTask", "error", new Error("x"))).not.toThrow();
+            expect(warnSpy).toHaveBeenCalledTimes(1);
+            // No runtime to assert on — just confirm no throw and warn still fires.
+        });
+        it("never throws on null err", () => {
+            installRuntime();
+            expect(() => logEeFailure("pil.pipeline.logInteraction", "error", null)).not.toThrow();
+            expect(warnSpy).toHaveBeenCalledOnce();
+            const args = warnSpy.mock.calls[0];
+            expect(args[1].name).toBe("Null");
+        });
+        it("never throws on undefined err", () => {
+            installRuntime();
+            expect(() => logEeFailure("phase-outcome.recordCouncilOutcome", "error", undefined)).not.toThrow();
+            const args = warnSpy.mock.calls[0];
+            expect(args[1].name).toBe("Undefined");
+        });
+        it("never throws on string err and uses the string as message", () => {
+            installRuntime();
+            expect(() => logEeFailure("client.feedback", "error", "boom")).not.toThrow();
+            const args = warnSpy.mock.calls[0];
+            expect(args[1]).toEqual({ name: "String", message: "boom" });
+        });
+        it("never throws on object-with-name err", () => {
+            installRuntime();
+            const errLike = { name: "AbortError", message: "request aborted" };
+            expect(() => logEeFailure("bridge.routeTask", "timeout", errLike)).not.toThrow();
+            const args = warnSpy.mock.calls[0];
+            expect(args[1]).toEqual({ name: "AbortError", message: "request aborted" });
+        });
+        it("does not propagate emitEvent exceptions", () => {
+            const stub = {
+                emitEvent: vi.fn(() => {
+                    throw new Error("subscriber blew up");
+                }),
+            };
+            globalThis.__muonroiAgentRuntime = stub;
+            expect(() => logEeFailure("client.touch", "error", new Error("x"))).not.toThrow();
+            expect(stub.emitEvent).toHaveBeenCalledTimes(1);
+        });
+        it("survives a runtime where emitEvent is not a function", () => {
+            globalThis.__muonroiAgentRuntime = { emitEvent: "nope" };
+            expect(() => logEeFailure("bridge.routeModel", "error", new Error("x"))).not.toThrow();
+        });
+    });
+    describe("classifyEeError", () => {
+        it("classifies TimeoutError as timeout", () => {
+            const err = Object.assign(new Error("x"), { name: "TimeoutError" });
+            expect(classifyEeError(err)).toBe("timeout");
+        });
+        it("classifies AbortError as timeout", () => {
+            const err = Object.assign(new Error("x"), { name: "AbortError" });
+            expect(classifyEeError(err)).toBe("timeout");
+        });
+        it("classifies generic Error as error", () => {
+            expect(classifyEeError(new Error("boom"))).toBe("error");
+        });
+        it("classifies TypeError as error", () => {
+            expect(classifyEeError(new TypeError("boom"))).toBe("error");
+        });
+        it("classifies null / undefined / string as error", () => {
+            expect(classifyEeError(null)).toBe("error");
+            expect(classifyEeError(undefined)).toBe("error");
+            expect(classifyEeError("boom")).toBe("error");
+        });
+        it("classifies plain object with TimeoutError name as timeout", () => {
+            expect(classifyEeError({ name: "TimeoutError" })).toBe("timeout");
+        });
+    });
+    describe("withEeTimeout (Phase 21.5)", () => {
+        it("resolves through when the inner promise settles in time", async () => {
+            const v = await withEeTimeout(Promise.resolve(42), 50);
+            expect(v).toBe(42);
+        });
+        it("rejects with TimeoutError when the inner promise takes too long", async () => {
+            const slow = new Promise((resolve) => setTimeout(() => resolve(7), 100));
+            await expect(withEeTimeout(slow, 20)).rejects.toMatchObject({ name: "TimeoutError" });
+        });
+        it("forwards inner rejection unchanged when it beats the timeout", async () => {
+            const err = new Error("inner boom");
+            await expect(withEeTimeout(Promise.reject(err), 50)).rejects.toBe(err);
+        });
+        it("rejected error classifies as timeout via classifyEeError", async () => {
+            const slow = new Promise((resolve) => setTimeout(() => resolve(0), 100));
+            try {
+                await withEeTimeout(slow, 10);
+                throw new Error("should not reach");
+            }
+            catch (e) {
+                expect(classifyEeError(e)).toBe("timeout");
+            }
+        });
+    });
+});
+//# sourceMappingURL=ee-logger.test.js.map

package/dist/src/utils/__tests__/ee-logger.test.js.map

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

package/dist/src/utils/__tests__/file-lock.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/utils/__tests__/file-lock.test.js

@@ -0,0 +1,66 @@
+import { promises as fs } from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { beforeEach, describe, expect, it } from "vitest";
+import { withFileLock } from "../file-lock.js";
+describe("withFileLock", () => {
+    let tmpFile;
+    beforeEach(async () => {
+        const dir = path.join(os.tmpdir(), `lock-${Math.random().toString(36).slice(2)}`);
+        await fs.mkdir(dir, { recursive: true });
+        tmpFile = path.join(dir, "target.json");
+    });
+    it("runs the callback and returns its value", async () => {
+        const result = await withFileLock(tmpFile, async () => 42);
+        expect(result).toBe(42);
+    });
+    it("removes lockfile after callback completes", async () => {
+        await withFileLock(tmpFile, async () => { });
+        await expect(fs.stat(`${tmpFile}.lock`)).rejects.toThrow();
+    });
+    it("removes lockfile even if callback throws", async () => {
+        await expect(withFileLock(tmpFile, async () => {
+            throw new Error("boom");
+        })).rejects.toThrow("boom");
+        await expect(fs.stat(`${tmpFile}.lock`)).rejects.toThrow();
+    });
+    it("serializes concurrent callers on same path", async () => {
+        const order = [];
+        const p1 = withFileLock(tmpFile, async () => {
+            order.push(1);
+            await new Promise((r) => setTimeout(r, 30));
+            order.push(2);
+        });
+        const p2 = withFileLock(tmpFile, async () => {
+            order.push(3);
+            order.push(4);
+        });
+        await Promise.all([p1, p2]);
+        expect(order).toEqual([1, 2, 3, 4]);
+    });
+    it("different paths do NOT block each other", async () => {
+        const other = `${tmpFile}.other`;
+        const start = Date.now();
+        await Promise.all([
+            withFileLock(tmpFile, async () => {
+                await new Promise((r) => setTimeout(r, 50));
+            }),
+            withFileLock(other, async () => {
+                await new Promise((r) => setTimeout(r, 50));
+            }),
+        ]);
+        const elapsed = Date.now() - start;
+        expect(elapsed).toBeLessThan(90);
+    });
+    it("respects retry timeout", async () => {
+        await fs.writeFile(`${tmpFile}.lock`, "manual");
+        let acquired = false;
+        const release = setTimeout(() => fs.unlink(`${tmpFile}.lock`).catch(() => { }), 50);
+        await withFileLock(tmpFile, async () => {
+            acquired = true;
+        });
+        clearTimeout(release);
+        expect(acquired).toBe(true);
+    });
+});
+//# sourceMappingURL=file-lock.test.js.map

package/dist/src/utils/__tests__/file-lock.test.js.map

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

package/dist/src/utils/__tests__/rate-limit.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/utils/__tests__/rate-limit.test.js

@@ -0,0 +1,38 @@
+import { describe, expect, it, vi } from "vitest";
+import { withRateLimitBackoff } from "../rate-limit.js";
+describe("withRateLimitBackoff", () => {
+    it("returns value on first success", async () => {
+        const fn = vi.fn().mockResolvedValue(42);
+        const result = await withRateLimitBackoff(fn);
+        expect(result).toBe(42);
+        expect(fn).toHaveBeenCalledTimes(1);
+    });
+    it("retries on 429 up to maxRetries", async () => {
+        const err = new Error("rate limit");
+        err.status = 429;
+        const fn = vi.fn().mockRejectedValueOnce(err).mockRejectedValueOnce(err).mockResolvedValue("ok");
+        const result = await withRateLimitBackoff(fn, { delays: [1, 1] });
+        expect(result).toBe("ok");
+        expect(fn).toHaveBeenCalledTimes(3);
+    });
+    it("gives up after maxRetries=3 total attempts", async () => {
+        const err = new Error("429");
+        err.status = 429;
+        const fn = vi.fn().mockRejectedValue(err);
+        await expect(withRateLimitBackoff(fn, { delays: [1] })).rejects.toThrow();
+        expect(fn).toHaveBeenCalledTimes(3);
+    });
+    it("throws non-429 immediately", async () => {
+        const err = new Error("500 boom");
+        const fn = vi.fn().mockRejectedValue(err);
+        await expect(withRateLimitBackoff(fn)).rejects.toThrow("500 boom");
+        expect(fn).toHaveBeenCalledTimes(1);
+    });
+    it("matches /429/ in message even without status", async () => {
+        const err = new Error("got 429 from server");
+        const fn = vi.fn().mockRejectedValueOnce(err).mockResolvedValue("ok");
+        const result = await withRateLimitBackoff(fn, { delays: [1] });
+        expect(result).toBe("ok");
+    });
+});
+//# sourceMappingURL=rate-limit.test.js.map

package/dist/src/utils/__tests__/rate-limit.test.js.map

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

package/dist/src/utils/__tests__/settings-disabled-models.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tests for per-model disable helpers added in Phase 19.
+ *
+ * Strategy: uses a temp HOME directory and vi.resetModules() to get a fresh
+ * module instance with a clean settings file — same pattern as settings-web-research.test.ts.
+ */
+export {};

package/dist/src/utils/__tests__/settings-disabled-models.test.js

@@ -0,0 +1,99 @@
+/**
+ * Tests for per-model disable helpers added in Phase 19.
+ *
+ * Strategy: uses a temp HOME directory and vi.resetModules() to get a fresh
+ * module instance with a clean settings file — same pattern as settings-web-research.test.ts.
+ */
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+describe("disabledModels settings helpers", () => {
+    const tmpHome = path.join(os.tmpdir(), `muonroi-cli-disabled-models-${process.pid}-${Date.now()}`);
+    const origHome = process.env.HOME;
+    const origUserProfile = process.env.USERPROFILE;
+    let getDisabledModels;
+    let isModelDisabled;
+    let setModelDisabled;
+    let saveUserSettings;
+    let loadUserSettings;
+    beforeEach(async () => {
+        fs.mkdirSync(tmpHome, { recursive: true });
+        process.env.HOME = tmpHome;
+        process.env.USERPROFILE = tmpHome;
+        vi.resetModules();
+        const mod = await import("../settings.js");
+        getDisabledModels = mod.getDisabledModels;
+        isModelDisabled = mod.isModelDisabled;
+        setModelDisabled = mod.setModelDisabled;
+        saveUserSettings = mod.saveUserSettings;
+        loadUserSettings = mod.loadUserSettings;
+        const settingsPath = path.join(tmpHome, ".muonroi-cli", "user-settings.json");
+        if (fs.existsSync(settingsPath))
+            fs.rmSync(settingsPath, { force: true });
+    });
+    afterEach(() => {
+        fs.rmSync(tmpHome, { recursive: true, force: true });
+        if (origHome === undefined)
+            delete process.env.HOME;
+        else
+            process.env.HOME = origHome;
+        if (origUserProfile === undefined)
+            delete process.env.USERPROFILE;
+        else
+            process.env.USERPROFILE = origUserProfile;
+    });
+    // ── getDisabledModels ────────────────────────────────────────────────────────
+    it("getDisabledModels returns [] when field is missing", () => {
+        expect(getDisabledModels()).toEqual([]);
+    });
+    it("getDisabledModels round-trips through save/load", () => {
+        saveUserSettings({ disabledModels: ["gpt-4o-mini", "claude-haiku-4-5"] });
+        expect(getDisabledModels()).toEqual(["gpt-4o-mini", "claude-haiku-4-5"]);
+    });
+    // ── isModelDisabled — list check ─────────────────────────────────────────────
+    it("isModelDisabled returns false when model is not in the list", () => {
+        saveUserSettings({ disabledModels: [], disabledProviders: [] });
+        expect(isModelDisabled("gpt-4o")).toBe(false);
+    });
+    it("isModelDisabled returns true when model id is in disabledModels", () => {
+        saveUserSettings({ disabledModels: ["gpt-4o-mini"], disabledProviders: [] });
+        expect(isModelDisabled("gpt-4o-mini")).toBe(true);
+    });
+    it("isModelDisabled returns false for an unlisted model", () => {
+        saveUserSettings({ disabledModels: ["some-other-model"], disabledProviders: [] });
+        expect(isModelDisabled("gpt-4o")).toBe(false);
+    });
+    // ── setModelDisabled ─────────────────────────────────────────────────────────
+    it("setModelDisabled adds model to list when disabled=true", () => {
+        const result = setModelDisabled("gpt-4o-mini", true);
+        expect(result).toContain("gpt-4o-mini");
+        // Persisted
+        expect(getDisabledModels()).toContain("gpt-4o-mini");
+    });
+    it("setModelDisabled removes model from list when disabled=false", () => {
+        saveUserSettings({ disabledModels: ["gpt-4o-mini", "claude-haiku-4-5"] });
+        const result = setModelDisabled("gpt-4o-mini", false);
+        expect(result).not.toContain("gpt-4o-mini");
+        expect(result).toContain("claude-haiku-4-5");
+        expect(loadUserSettings().disabledModels).toEqual(["claude-haiku-4-5"]);
+    });
+    it("setModelDisabled is idempotent when disabling an already-disabled model", () => {
+        saveUserSettings({ disabledModels: ["gpt-4o-mini"] });
+        const result = setModelDisabled("gpt-4o-mini", true);
+        expect(result).toEqual(["gpt-4o-mini"]); // still exactly one entry
+    });
+    it("setModelDisabled is idempotent when enabling an already-enabled model", () => {
+        saveUserSettings({ disabledModels: [] });
+        const result = setModelDisabled("gpt-4o-mini", false);
+        expect(result).toEqual([]);
+    });
+    // ── round-trip integration ───────────────────────────────────────────────────
+    it("disabled model can be re-enabled via setModelDisabled", () => {
+        setModelDisabled("gpt-4o-mini", true);
+        expect(isModelDisabled("gpt-4o-mini")).toBe(true);
+        setModelDisabled("gpt-4o-mini", false);
+        expect(isModelDisabled("gpt-4o-mini")).toBe(false);
+    });
+});
+//# sourceMappingURL=settings-disabled-models.test.js.map

package/dist/src/utils/__tests__/settings-disabled-models.test.js.map

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

package/dist/src/utils/__tests__/settings-web-research.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/utils/__tests__/settings-web-research.test.js

@@ -0,0 +1,46 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+describe("UserSettings.webResearchPrompted", () => {
+    const tmpHome = path.join(os.tmpdir(), `muonroi-cli-settings-${process.pid}-${Date.now()}`);
+    const origHome = process.env.HOME;
+    const origUserProfile = process.env.USERPROFILE;
+    let saveUserSettings;
+    let loadUserSettings;
+    beforeEach(async () => {
+        fs.mkdirSync(tmpHome, { recursive: true });
+        process.env.HOME = tmpHome;
+        process.env.USERPROFILE = tmpHome;
+        // Reset module cache so settings.ts re-evaluates USER_DIR with new env
+        vi.resetModules();
+        const mod = await import("../settings.js");
+        saveUserSettings = mod.saveUserSettings;
+        loadUserSettings = mod.loadUserSettings;
+        // Ensure no stale settings file from any previous run
+        const settingsPath = path.join(tmpHome, ".muonroi-cli", "user-settings.json");
+        if (fs.existsSync(settingsPath))
+            fs.rmSync(settingsPath, { force: true });
+    });
+    afterEach(() => {
+        fs.rmSync(tmpHome, { recursive: true, force: true });
+        if (origHome === undefined)
+            delete process.env.HOME;
+        else
+            process.env.HOME = origHome;
+        if (origUserProfile === undefined)
+            delete process.env.USERPROFILE;
+        else
+            process.env.USERPROFILE = origUserProfile;
+    });
+    it("persists webResearchPrompted=true through save/load", () => {
+        saveUserSettings({ webResearchPrompted: true });
+        const loaded = loadUserSettings();
+        expect(loaded.webResearchPrompted).toBe(true);
+    });
+    it("returns undefined when never set", () => {
+        const loaded = loadUserSettings();
+        expect(loaded.webResearchPrompted).toBeUndefined();
+    });
+});
+//# sourceMappingURL=settings-web-research.test.js.map

package/dist/src/utils/__tests__/settings-web-research.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-web-research.test.js","sourceRoot":"","sources":["../../../../src/utils/__tests__/settings-web-research.test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzE,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,wBAAwB,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5F,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;IAClC,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAChD,IAAI,gBAAkE,CAAC;IACvE,IAAI,gBAAkE,CAAC;IAEvE,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC;QAClC,uEAAuE;QACvE,EAAE,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAC3C,gBAAgB,GAAG,GAAG,CAAC,gBAAgB,CAAC;QACxC,gBAAgB,GAAG,GAAG,CAAC,gBAAgB,CAAC;QACxC,sDAAsD;QACtD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,oBAAoB,CAAC,CAAC;QAC9E,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;YAAE,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;;YAC/C,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC;QACjC,IAAI,eAAe,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;;YAC7D,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,eAAe,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,gBAAgB,CAAC,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,aAAa,EAAE,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/utils/__tests__/slugify.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/utils/__tests__/slugify.test.js

@@ -0,0 +1,37 @@
+import { describe, expect, it } from "vitest";
+import { slugify } from "../slugify.js";
+describe("slugify", () => {
+    it("lowercases all alphabetic chars", () => {
+        expect(slugify("Hello World")).toBe("hello-world");
+    });
+    it("replaces non-alphanumeric with single dash", () => {
+        expect(slugify("foo!@#$bar")).toBe("foo-bar");
+    });
+    it("collapses consecutive dashes", () => {
+        expect(slugify("a    b    c")).toBe("a-b-c");
+    });
+    it("trims leading and trailing dashes", () => {
+        expect(slugify("---hello---")).toBe("hello");
+    });
+    it("strips Unicode combining marks (NFKD)", () => {
+        expect(slugify("Café résumé")).toBe("cafe-resume");
+    });
+    it("handles empty input", () => {
+        expect(slugify("")).toBe("");
+    });
+    it("Discord-name round-trip: lowercase + only [a-z0-9-]", () => {
+        const out = slugify("Hello, World! 2026");
+        expect(out).toBe("hello-world-2026");
+        expect(/^[a-z0-9-]*$/.test(out)).toBe(true);
+    });
+    it("does not slice — caller decides length", () => {
+        const out = slugify("a".repeat(200));
+        expect(out.length).toBe(200);
+    });
+    it("Vietnamese with diacritics produces alphanumeric only", () => {
+        const out = slugify("Sản phẩm mới");
+        expect(/^[a-z0-9-]*$/.test(out)).toBe(true);
+        expect(out.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=slugify.test.js.map

package/dist/src/utils/__tests__/slugify.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.test.js","sourceRoot":"","sources":["../../../../src/utils/__tests__/slugify.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACrC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;QACpC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/utils/__tests__/visible-retry.test.d.ts

@@ -0,0 +1 @@
+export {};