primitive-admin 1.0.61 → 1.0.63

package/dist/src/lib/local-test-cases.js

@@ -0,0 +1,135 @@
+/**
+ * The case files on disk that the server has never been told about (#3061).
+ *
+ * A `<key>.tests/*.toml` sidecar is authored locally and becomes runnable only
+ * when `config push` registers it. The test verbs run the REGISTERED set, so a
+ * file nobody pushed contributes nothing to `Total Tests` — and until this
+ * module existed, nothing to the output either. `Total Tests: 3 / Failed: 0`
+ * beside four case files is a pass standing in for work that did not happen,
+ * and is indistinguishable from a case that genuinely ran.
+ *
+ * Naming those files is only useful if the naming is never wrong, so pairing
+ * here mirrors what push pairs with:
+ *   1. the sync manifest, which maps a file to the live case it manages even
+ *      when the file has since been renamed;
+ *   2. the file name pull would give the case — its committed key, or the slug
+ *      of an unkeyed case's name (web-admin, an older CLI or the raw API),
+ *      collision suffixes included — from the one shared naming rule in
+ *      `test-case-file-names.ts`.
+ * Both passes CLAIM: one live case accounts for one file, the way pull assigns
+ * one file per case and push's adoption pass pairs. Matching a name loosely
+ * instead would let a single registered "foo" excuse both `foo.toml` and a
+ * newly authored `foo-2.toml`, which is the silence this issue is about.
+ * Anything left over is a file no live case accounts for. The bias is toward
+ * silence: a pairing this module cannot make is a warning it does not print.
+ *
+ * Reads only — the scan never registers anything. `config push` stays the one
+ * verb that mutates the server, which is what the warning tells the user.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from "fs";
+import { basename, join } from "path";
+import { testCaseFileBasenames } from "./test-case-file-names.js";
+import { normalizeTestCaseKey } from "./test-case-keys.js";
+/** Read the manifest's test-case rows, or nothing when it cannot be read. */
+export function readManagedTestCases(configDir) {
+    const syncFile = join(configDir, ".primitive-sync.json");
+    if (!existsSync(syncFile))
+        return {};
+    try {
+        const state = JSON.parse(readFileSync(syncFile, "utf-8"));
+        const managed = state?.entities?.testCases;
+        return managed && typeof managed === "object" ? managed : {};
+    }
+    catch {
+        // A manifest we cannot parse is a manifest we cannot pair with; the key and
+        // name passes still speak, and an unpairable file is left unnamed.
+        return {};
+    }
+}
+/**
+ * The `*.toml` case files in a suite's sidecar directory, if it has one.
+ *
+ * An empty array means the directory is absent or holds no case file. A
+ * directory that cannot be READ throws instead of reporting nothing: this whole
+ * issue is about a silence indistinguishable from having no work, and callers
+ * turn the throw into a diagnostic that names the directory.
+ */
+export function listLocalTestCaseFiles(testsDir) {
+    if (!existsSync(testsDir))
+        return [];
+    if (!statSync(testsDir).isDirectory())
+        return [];
+    return readdirSync(testsDir)
+        .filter((entry) => entry.endsWith(".toml"))
+        .filter((entry) => {
+        // Attachment folders live beside the cases (`<case>/`); only files are
+        // cases, and a directory named `x.toml` is neither.
+        try {
+            return statSync(join(testsDir, entry)).isFile();
+        }
+        catch (err) {
+            // Gone between the listing and the stat is gone — anything else is a
+            // directory we cannot read, which the caller has to hear about.
+            if (err?.code === "ENOENT")
+                return false;
+            throw err;
+        }
+    })
+        .sort();
+}
+/**
+ * Which of a suite's local case files no registered case accounts for.
+ *
+ * `managedPrefix` is the manifest's namespace for this block —
+ * `<blockType>/<blockKey>` — so a row that maps `foo.toml` to a live case is
+ * read only for the block that owns it.
+ */
+export function scanLocalTestCases(params) {
+    const localFiles = listLocalTestCaseFiles(params.testsDir);
+    if (localFiles.length === 0)
+        return { localFiles, unregistered: [] };
+    const registered = (params.registered ?? []).filter((live) => live && typeof live === "object");
+    // The file each live case belongs in, allocated exactly as pull allocates it:
+    // keys claim theirs first, unkeyed names take what is left, and a collision
+    // suffix is assigned rather than accepted from any name that carries one.
+    const liveByFileName = new Map();
+    for (const [live, name] of testCaseFileBasenames(registered)) {
+        liveByFileName.set(normalizeTestCaseKey(name), live);
+    }
+    const liveById = new Map();
+    for (const live of registered) {
+        if (typeof live.testCaseId === "string" && live.testCaseId) {
+            liveById.set(live.testCaseId, live);
+        }
+    }
+    const managedLiveFor = (slug) => {
+        if (!params.managedPrefix)
+            return undefined;
+        const id = params.managed?.[`${params.managedPrefix}/${slug}`]?.id;
+        return id ? liveById.get(id) : undefined;
+    };
+    // A live case accounts for ONE file. Claiming is what keeps a single
+    // registered "foo" from excusing `foo.toml` and `foo-2.toml` alike.
+    const claimed = new Set();
+    const unclaimed = [];
+    // The manifest states identity outright, so it is read first: a file renamed
+    // since it was pulled keeps its case even where the naming rules would hand
+    // that case to the file still sitting under its old name.
+    for (const file of localFiles) {
+        const live = managedLiveFor(basename(file, ".toml"));
+        if (live && !claimed.has(live)) {
+            claimed.add(live);
+            continue;
+        }
+        unclaimed.push(file);
+    }
+    const unregistered = unclaimed.filter((file) => {
+        const live = liveByFileName.get(normalizeTestCaseKey(basename(file, ".toml")));
+        if (!live || claimed.has(live))
+            return true;
+        claimed.add(live);
+        return false;
+    });
+    return { localFiles, unregistered };
+}
+//# sourceMappingURL=local-test-cases.js.map

package/dist/src/lib/local-test-cases.js.map

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