@dbx-tools/shared-core 0.3.37 → 0.3.40

package/package.json

@@ -3,7 +3,7 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/reggie-db/dbx-tools.git",
-    "directory": "workspaces/shared/core"
+    "directory": "packages/shared/core"
   },
   "devDependencies": {
     "@types/node": "^24.6.0",
@@ -22,13 +22,17 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.3.37",
+  "version": "0.3.40",
   "types": "index.ts",
   "type": "module",
   "exports": {
     ".": "./index.ts",
     "./package.json": "./package.json"
   },
+  "files": [
+    "index.ts",
+    "src"
+  ],
   "peerDependenciesMeta": {
     "consola": {
       "optional": true

package/.projen/deps.json

@@ -1,34 +0,0 @@
-{
-  "dependencies": [
-    {
-      "name": "@types/node",
-      "version": "^24.6.0",
-      "type": "build"
-    },
-    {
-      "name": "consola",
-      "version": "catalog:",
-      "type": "build"
-    },
-    {
-      "name": "tsx",
-      "version": "^4.23.0",
-      "type": "build"
-    },
-    {
-      "name": "typescript",
-      "type": "build"
-    },
-    {
-      "name": "consola",
-      "version": "catalog:",
-      "type": "peer"
-    },
-    {
-      "name": "zod",
-      "version": "catalog:",
-      "type": "runtime"
-    }
-  ],
-  "//": "~~ Generated by projen. To modify, edit .projenrc.js and run \"pnpm exec projen\"."
-}

package/.projen/files.json

@@ -1,11 +0,0 @@
-{
-  "files": [
-    ".projen/deps.json",
-    ".projen/files.json",
-    ".projen/tasks.json",
-    "package.json",
-    "test/tsconfig.json",
-    "tsconfig.json"
-  ],
-  "//": "~~ Generated by projen. To modify, edit .projenrc.js and run \"pnpm exec projen\"."
-}

package/.projen/tasks.json

@@ -1,121 +0,0 @@
-{
-  "manifestVersion": 3,
-  "env": {
-    "PATH": "$(pnpm -c exec \"node --print process.env.PATH\")"
-  },
-  "tasks": {
-    "build": {
-      "name": "build",
-      "description": "Full release build",
-      "steps": [
-        {
-          "spawn": "pre-compile"
-        },
-        {
-          "spawn": "compile"
-        },
-        {
-          "spawn": "post-compile"
-        },
-        {
-          "spawn": "test"
-        },
-        {
-          "spawn": "package"
-        }
-      ]
-    },
-    "compile": {
-      "name": "compile",
-      "description": "Only compile",
-      "steps": [
-        {
-          "execArgs": [
-            "tsc",
-            "--build"
-          ]
-        }
-      ]
-    },
-    "default": {
-      "name": "default",
-      "description": "Synthesize project files",
-      "steps": [
-        {
-          "exec": "pnpm exec projen default",
-          "cwd": "../../.."
-        }
-      ]
-    },
-    "install": {
-      "name": "install",
-      "description": "Install project dependencies and update lockfile (non-frozen)",
-      "steps": [
-        {
-          "exec": "pnpm i --no-frozen-lockfile"
-        }
-      ]
-    },
-    "install:ci": {
-      "name": "install:ci",
-      "description": "Install project dependencies using frozen lockfile",
-      "steps": [
-        {
-          "exec": "pnpm i --frozen-lockfile"
-        }
-      ]
-    },
-    "package": {
-      "name": "package",
-      "description": "Creates the distribution package",
-      "steps": [
-        {
-          "execArgs": [
-            "mkdir",
-            "-p",
-            "dist/js"
-          ]
-        },
-        {
-          "execArgs": [
-            "pnpm",
-            "pack",
-            "--pack-destination",
-            "dist/js"
-          ]
-        }
-      ]
-    },
-    "post-compile": {
-      "name": "post-compile",
-      "description": "Runs after successful compilation"
-    },
-    "pre-compile": {
-      "name": "pre-compile",
-      "description": "Prepare the project for compilation"
-    },
-    "test": {
-      "name": "test",
-      "description": "Run tests",
-      "steps": [
-        {
-          "exec": "tsx --test 'test/**/*.test.ts'"
-        }
-      ]
-    },
-    "watch": {
-      "name": "watch",
-      "description": "Watch & compile in the background",
-      "steps": [
-        {
-          "execArgs": [
-            "tsc",
-            "--build",
-            "-w"
-          ]
-        }
-      ]
-    }
-  },
-  "//": "~~ Generated by projen. To modify, edit .projenrc.js and run \"pnpm exec projen\"."
-}

package/test/async.test.ts

@@ -1,44 +0,0 @@
-import assert from "node:assert/strict";
-import { describe, it } from "node:test";
-import { async } from "../index";
-
-describe("async.combineAbortSignals", () => {
-  it("returns undefined when every source is absent", () => {
-    assert.equal(async.combineAbortSignals(), undefined);
-    assert.equal(async.combineAbortSignals(undefined, undefined), undefined);
-  });
-
-  it("passes a lone signal through without wrapping it", () => {
-    const { signal } = new AbortController();
-    assert.equal(async.combineAbortSignals(signal), signal);
-    assert.equal(async.combineAbortSignals(undefined, signal, undefined), signal);
-  });
-
-  it("aborts when any source aborts, carrying that source's reason", () => {
-    for (const index of [0, 1, 2]) {
-      const controllers = [new AbortController(), new AbortController(), new AbortController()];
-      const combined = async.combineAbortSignals(...controllers.map((c) => c.signal));
-      assert.equal(combined?.aborted, false);
-      controllers[index]!.abort(new Error(`source ${index}`));
-      assert.equal(combined?.aborted, true);
-      assert.equal((combined?.reason as Error).message, `source ${index}`);
-    }
-  });
-
-  it("is already aborted when a source aborted before combining", () => {
-    const early = new AbortController();
-    early.abort(new Error("gone"));
-    const combined = async.combineAbortSignals(early.signal, new AbortController().signal);
-    assert.equal(combined?.aborted, true);
-    assert.equal((combined?.reason as Error).message, "gone");
-  });
-
-  it("does not propagate back to the sources", () => {
-    const first = new AbortController();
-    const second = new AbortController();
-    const combined = async.combineAbortSignals(first.signal, second.signal);
-    first.abort();
-    assert.equal(combined?.aborted, true);
-    assert.equal(second.signal.aborted, false);
-  });
-});

package/test/brand.test.ts

@@ -1,33 +0,0 @@
-import assert from "node:assert/strict";
-import { describe, it } from "node:test";
-import { brand } from "../index";
-
-describe("brand context", () => {
-  it("fills dbx tools defaults", () => {
-    const context = brand.parseBrandContext();
-
-    assert.equal(context.name, "dbx tools");
-    assert.equal(context.assets.icon.light, brand.DEFAULT_BRAND_ASSETS.icon.light);
-    assert.equal(context.colors.primary, "#FF3621");
-  });
-
-  it("validates nested overrides and preserves defaults", () => {
-    const context = brand.parseBrandContext({
-      name: "Example",
-      colors: { primary: "#123456" },
-    });
-
-    assert.equal(context.name, "Example");
-    assert.equal(context.colors.primary, "#123456");
-    assert.equal(context.colors.background, "#FFFFFF");
-  });
-
-  it("exports schema and prompt forms for LLM consumers", () => {
-    const schema = brand.brandContextJsonSchema();
-    const prompt = brand.brandContextPrompt();
-
-    assert.equal(schema.type, "object");
-    assert.match(prompt, /dbx tools brand context/);
-    assert.match(prompt, /"schemaVersion": "1"/);
-  });
-});

package/test/hash.test.ts

@@ -1,55 +0,0 @@
-import assert from "node:assert/strict";
-import { afterEach, describe, it } from "node:test";
-import { hash } from "../index";
-
-const UUID_V4 = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
-
-const original = globalThis.crypto;
-
-const withCrypto = (value: unknown, body: () => void) => {
-  Object.defineProperty(globalThis, "crypto", { value, configurable: true, writable: true });
-  try {
-    body();
-  } finally {
-    Object.defineProperty(globalThis, "crypto", {
-      value: original,
-      configurable: true,
-      writable: true,
-    });
-  }
-};
-
-describe("hash.id", () => {
-  afterEach(() => {
-    assert.equal(globalThis.crypto, original);
-  });
-
-  it("mints a v4 UUID from crypto.randomUUID when available", () => {
-    assert.match(hash.id(), UUID_V4);
-    assert.notEqual(hash.id(), hash.id());
-  });
-
-  it("returns a short hex slice when a length is given", () => {
-    assert.match(hash.id(8), /^[0-9a-f]{8}$/);
-    assert.equal(hash.id(1).length, 1);
-  });
-
-  it("rejects a non-positive length", () => {
-    assert.throws(() => hash.id(0), /greater than 0/);
-    assert.throws(() => hash.id(-1), /greater than 0/);
-  });
-
-  it("falls back to getRandomValues where randomUUID is absent (plain-http browser)", () => {
-    withCrypto({ getRandomValues: original.getRandomValues.bind(original) }, () => {
-      assert.match(hash.id(), UUID_V4);
-      assert.notEqual(hash.id(), hash.id());
-    });
-  });
-
-  it("falls back to Math.random where crypto is absent entirely", () => {
-    withCrypto(undefined, () => {
-      assert.match(hash.id(), UUID_V4);
-      assert.match(hash.id(12), /^[0-9a-f]{12}$/);
-    });
-  });
-});

package/test/json.test.ts

@@ -1,42 +0,0 @@
-import assert from "node:assert/strict";
-import { describe, it } from "node:test";
-import { json } from "../index";
-
-describe("json.parse", () => {
-  it("parses a well-formed document", () => {
-    assert.deepEqual(json.parse('{"a":1}'), { a: 1 });
-    assert.deepEqual(json.parse("[1,2]"), [1, 2]);
-    assert.equal(json.parse('"text"'), "text");
-  });
-
-  it("returns the fallback for malformed JSON instead of throwing", () => {
-    assert.equal(json.parse("{not json"), undefined);
-    assert.deepEqual(json.parse("{not json", { ok: false }), { ok: false });
-  });
-
-  it("treats absent / blank / non-string input as a miss", () => {
-    assert.equal(json.parse(undefined), undefined);
-    assert.equal(json.parse(null), undefined);
-    assert.equal(json.parse("   "), undefined);
-    assert.equal(json.parse(42), undefined);
-    assert.deepEqual(json.parse(undefined, []), []);
-  });
-});
-
-describe("json.parseRecord", () => {
-  it("returns the object for a record document", () => {
-    assert.deepEqual(json.parseRecord('{"name":"pkg"}'), { name: "pkg" });
-  });
-
-  it("rejects documents that parse to a non-record", () => {
-    assert.equal(json.parseRecord("[1,2]"), undefined);
-    assert.equal(json.parseRecord('"text"'), undefined);
-    assert.equal(json.parseRecord("null"), undefined);
-    assert.equal(json.parseRecord("7"), undefined);
-  });
-
-  it("returns undefined for malformed or absent input", () => {
-    assert.equal(json.parseRecord("{oops"), undefined);
-    assert.equal(json.parseRecord(undefined), undefined);
-  });
-});

package/test/string.test.ts

@@ -1,43 +0,0 @@
-import assert from "node:assert/strict";
-import { describe, it } from "node:test";
-import { string } from "../index";
-
-describe("string.trimToEmpty", () => {
-  it("trims a string", () => {
-    assert.equal(string.trimToEmpty("  hi  "), "hi");
-  });
-
-  it("yields an empty string for a non-string or blank value", () => {
-    assert.equal(string.trimToEmpty(undefined), "");
-    assert.equal(string.trimToEmpty(null), "");
-    assert.equal(string.trimToEmpty(42), "");
-    assert.equal(string.trimToEmpty("   "), "");
-  });
-});
-
-describe("string.parseList", () => {
-  it("splits a comma / whitespace separated string", () => {
-    assert.deepEqual(string.parseList("a, b  c,d"), ["a", "b", "c", "d"]);
-  });
-
-  it("accepts an array and trims its entries", () => {
-    assert.deepEqual(string.parseList([" a ", "b"]), ["a", "b"]);
-  });
-
-  it("drops empties and de-duplicates, first occurrence winning", () => {
-    assert.deepEqual(string.parseList("a,,b, a ,b"), ["a", "b"]);
-  });
-
-  it("returns an empty list for absent input", () => {
-    assert.deepEqual(string.parseList(undefined), []);
-    assert.deepEqual(string.parseList(null), []);
-    assert.deepEqual(string.parseList(""), []);
-  });
-
-  it("applies a transform and de-duplicates on the transformed value", () => {
-    assert.deepEqual(
-      string.parseList("A, a, B", (entry) => entry.trim().toLowerCase()),
-      ["a", "b"],
-    );
-  });
-});

package/test/tsconfig.json

@@ -1,14 +0,0 @@
-// ~~ Generated by projen. To modify, edit .projenrc.js and run "pnpm exec projen".
-{
-  "extends": "../tsconfig.json",
-  "compilerOptions": {
-    "noEmit": true,
-    "rootDir": ".."
-  },
-  "include": [
-    "**/*.ts"
-  ],
-  "exclude": [
-    "node_modules"
-  ]
-}

package/tsconfig.json

@@ -1,40 +0,0 @@
-// ~~ Generated by projen. To modify, edit .projenrc.js and run "pnpm exec projen".
-{
-  "compilerOptions": {
-    "rootDir": "src",
-    "outDir": "lib",
-    "alwaysStrict": true,
-    "declaration": true,
-    "esModuleInterop": true,
-    "experimentalDecorators": true,
-    "inlineSourceMap": true,
-    "inlineSources": true,
-    "lib": [
-      "ES2022",
-      "WebWorker"
-    ],
-    "module": "ESNext",
-    "noEmitOnError": false,
-    "noFallthroughCasesInSwitch": true,
-    "noImplicitAny": true,
-    "noImplicitReturns": true,
-    "noImplicitThis": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "resolveJsonModule": true,
-    "strict": true,
-    "strictNullChecks": true,
-    "strictPropertyInitialization": true,
-    "stripInternal": true,
-    "target": "ES2022",
-    "types": [],
-    "moduleResolution": "bundler",
-    "skipLibCheck": true
-  },
-  "include": [
-    "src/**/*.ts"
-  ],
-  "exclude": [
-    "node_modules"
-  ]
-}