@antelopejs/dms-frontend 0.9.1 → 0.9.3

package/dist/materialize.js

@@ -15,6 +15,7 @@ const derived_outputs_1 = require("./derived-outputs");
 const layers_1 = require("./layers");
 const manifest_secrets_1 = require("./manifest-secrets");
 const fs_sync_1 = require("./fs-sync");
+const guards_1 = require("./internal/guards");
 function getPackageRoot() {
     return (0, node_path_1.resolve)(__dirname, "..");
 }
@@ -87,7 +88,7 @@ function collectAuthEstablishEndpoints(layers) {
     const endpoints = new Set();
     for (const layer of layers) {
         for (const endpoint of layer.authEstablishEndpoints ?? []) {
-            if (typeof endpoint === "string" && BACKEND_API_PATH.test(endpoint)) {
+            if ((0, guards_1.isText)(endpoint) && BACKEND_API_PATH.test(endpoint)) {
                 endpoints.add(endpoint);
                 continue;
             }
@@ -103,11 +104,11 @@ function writeAuthEstablishEndpoints(workspaceDir, layers) {
     (0, node_fs_1.writeFileSync)((0, node_path_1.join)(workspaceDir, config_1.AUTH_ESTABLISH_FILE), `${JSON.stringify({ endpoints }, null, 2)}\n`);
 }
 function collectPublicEndpoints(layers) {
-    return layers.flatMap((layer) => (Array.isArray(layer.publicEndpoints) ? layer.publicEndpoints : []).filter((endpoint) => typeof endpoint === "object" && endpoint !== null));
+    return layers.flatMap((layer) => (Array.isArray(layer.publicEndpoints) ? layer.publicEndpoints : []).filter(guards_1.isObjectLike));
 }
 function collectBackendProxies(layers) {
     return layers.flatMap((layer) => (Array.isArray(layer.backendProxies) ? layer.backendProxies : [])
-        .filter((proxy) => typeof proxy === "object" && proxy !== null)
+        .filter(guards_1.isObjectLike)
         .map((proxy) => ({
         ...proxy,
         module: layer.name ?? layer.packageName ?? "unknown",
@@ -121,9 +122,9 @@ function writePublicEndpoints(workspaceDir, layers) {
     (0, node_fs_1.writeFileSync)((0, node_path_1.join)(workspaceDir, config_1.PUBLIC_ENDPOINTS_FILE), `${JSON.stringify(declared, null, 2)}\n`);
 }
 function holdsValue(value) {
-    if (typeof value === "string")
+    if ((0, guards_1.isText)(value))
         return value !== "";
-    if (value !== null && typeof value === "object")
+    if ((0, guards_1.isObjectLike)(value))
         return Object.values(value).some(holdsValue);
     return false;
 }

package/dist/module-set.js

@@ -48,8 +48,7 @@ function followModuleSet(options) {
                 inspect(moduleSetFingerprint(manifest.modules));
             }
         }
-        catch {
-        }
+        catch { }
         if (!isStopped)
             schedule();
     };
@@ -102,8 +101,7 @@ async function reportFrontendReadyOnceAnswered(backendUrl, modules, bootstrapSec
             if (response.status < SERVER_ERROR)
                 return response.ok;
         }
-        catch {
-        }
+        catch { }
         await (0, promises_1.setTimeout)(delayMs, undefined, { ref: false });
         delayMs = Math.min(retry.maxDelayMs, delayMs * 2);
     }

package/dist/ports.js

@@ -5,6 +5,7 @@ exports.reserveFreePort = reserveFreePort;
 exports.reservePort = reservePort;
 const node_net_1 = require("node:net");
 const cli_1 = require("@antelopejs/core/cli");
+const guards_1 = require("./internal/guards");
 exports.PORT_FALLBACK_RANGE = 20;
 exports.MAX_TCP_PORT = 65535;
 function tryListen(port) {
@@ -27,12 +28,18 @@ async function reserveFreePort(preferred, range = exports.PORT_FALLBACK_RANGE) {
         fixes: ["Free one of these ports, or pass another one: -p <port>"],
     });
 }
+function listeningPort(server) {
+    const address = server.address();
+    if (!(0, guards_1.isObjectLike)(address))
+        throw new Error("The reserved server does not listen on a TCP port");
+    return address.port;
+}
 async function reservePort(port) {
     const server = await tryListen(port);
     if (!server)
         return undefined;
     return {
-        port: server.address().port,
+        port: listeningPort(server),
         release: () => new Promise((resolve) => {
             server.close(() => resolve());
         }),

package/dist/private-values.js

@@ -6,26 +6,33 @@ exports.filledOptions = filledOptions;
 exports.parsePrivateOptions = parsePrivateOptions;
 exports.unfilledPrivateValues = unfilledPrivateValues;
 const config_1 = require("./config");
+const guards_1 = require("./internal/guards");
+function isOptions(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isContainer(value) {
+    return typeof value === "object" && value !== null;
+}
 function emptied(value) {
-    if (typeof value === "string")
+    if ((0, guards_1.isText)(value))
         return "";
     if (Array.isArray(value))
         return value.map(emptied);
-    if (value !== null && typeof value === "object")
+    if (isOptions(value))
         return emptiedOptions(value);
     return value;
 }
 function emptiedOptions(options) {
     return Object.fromEntries(Object.entries(options).map(([key, value]) => [key, emptied(value)]));
 }
-function filled(shape, value) {
-    if (typeof shape === "string")
-        return typeof value === "string" ? value : "";
-    if (Array.isArray(shape))
-        return shape.map((item, index) => filled(item, Array.isArray(value) ? value[index] : undefined));
-    if (shape !== null && typeof shape === "object")
-        return filledOptions(shape, isOptions(value) ? value : undefined);
-    return shape;
+function filled(declared, value) {
+    if ((0, guards_1.isText)(declared))
+        return (0, guards_1.isText)(value) ? value : "";
+    if (Array.isArray(declared))
+        return declared.map((item, index) => filled(item, Array.isArray(value) ? value[index] : undefined));
+    if (isOptions(declared))
+        return filledOptions(declared, isOptions(value) ? value : undefined);
+    return declared;
 }
 function filledOptions(shape, values) {
     return Object.fromEntries(Object.entries(shape).map(([key, value]) => [
@@ -34,8 +41,10 @@ function filledOptions(shape, values) {
     ]));
 }
 exports.PRIVATE_OPTIONS_VARIABLE = "DMS_PRIVATE_OPTIONS";
-function isOptions(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
+function isOptionsById(value) {
+    return ((0, guards_1.isObjectLike)(value) &&
+        !Array.isArray(value) &&
+        Object.values(value).every(isOptions));
 }
 function parsePrivateOptions(raw) {
     if (!raw?.trim())
@@ -47,7 +56,7 @@ function parsePrivateOptions(raw) {
     catch {
         given = undefined;
     }
-    if (!isOptions(given) || !Object.values(given).every(isOptions)) {
+    if (!isOptionsById(given)) {
         throw new config_1.UsageError({
             title: `${exports.PRIVATE_OPTIONS_VARIABLE} is not a JSON object of options by module id`,
             fixes: [
@@ -60,18 +69,18 @@ function parsePrivateOptions(raw) {
 function readPath(options, path) {
     let value = options;
     for (const key of path) {
-        if (typeof value !== "object" || value === null)
+        if (!isContainer(value))
             return undefined;
         if (!Object.prototype.hasOwnProperty.call(value, key))
             return undefined;
-        value = value[key];
+        value = isOptions(value) ? value[key] : value[Number(key)];
     }
     return value;
 }
 function* emptyStrings(value, path = []) {
     if (value === "")
         yield path;
-    else if (typeof value === "object" && value !== null)
+    else if (isContainer(value))
         for (const [key, child] of Object.entries(value))
             yield* emptyStrings(child, [...path, key]);
 }
@@ -82,7 +91,7 @@ function unfilledPrivateValues(modules, given, covered) {
         .filter((path) => path.length > 0 && !isCovered(path))
         .filter((path) => {
         const value = readPath(given[module], path);
-        return typeof value !== "string" || value === "";
+        return !(0, guards_1.isText)(value) || value === "";
     })
         .map((path) => ({ module, path })));
 }

package/dist/project-modules.js

@@ -41,6 +41,7 @@ const node_fs_1 = require("node:fs");
 const fsPromises = __importStar(require("node:fs/promises"));
 const node_path_1 = require("node:path");
 const cli_1 = require("@antelopejs/core/cli");
+const guards_1 = require("./internal/guards");
 const layers_1 = require("./layers");
 const private_values_1 = require("./private-values");
 exports.FRONTEND_DECLARATION_FIELD = "dmsFrontend";
@@ -66,9 +67,12 @@ const NODE_FILE_SYSTEM = {
 };
 function readAntelopeManifest(folder) {
     const dedicated = (0, node_path_1.join)(folder, MODULE_MANIFEST_FILE);
-    if ((0, node_fs_1.existsSync)(dedicated))
-        return JSON.parse((0, node_fs_1.readFileSync)(dedicated, "utf-8"));
-    return (0, layers_1.readLayerPackage)(folder)?.antelopeJs;
+    if ((0, node_fs_1.existsSync)(dedicated)) {
+        const manifest = JSON.parse((0, node_fs_1.readFileSync)(dedicated, "utf-8"));
+        return (0, guards_1.isObjectLike)(manifest) ? manifest : undefined;
+    }
+    const block = (0, layers_1.readLayerPackage)(folder)?.antelopeJs;
+    return (0, guards_1.isObjectLike)(block) ? block : undefined;
 }
 function warnUndeclaredConfigVars(id) {
     (0, cli_1.getProcessUi)().message("warn", `${id} declares no antelopeJs.configVarsFile in its package.json: the \${@${id}.<VAR>} references are left unresolved`, { detail: `Upgrade ${id} to a version that declares it` });
@@ -76,19 +80,19 @@ function warnUndeclaredConfigVars(id) {
 function configVarsProvider(id, folder) {
     const manifest = readAntelopeManifest(folder);
     const file = manifest?.configVarsFile;
-    if (typeof file !== "string") {
+    if (!(0, guards_1.isText)(file)) {
         warnUndeclaredConfigVars(id);
         return undefined;
     }
     const { configVars } = require((0, node_path_1.join)(folder, file));
-    if (typeof configVars !== "function") {
+    if (!(0, guards_1.isCallable)(configVars)) {
         throw new cli_1.CliError({
             title: `${id}: ${file} exports no configVars function`,
             fixes: [`Export configVars(config) from ${file}`],
         });
     }
     const declared = Array.isArray(manifest?.configVars)
-        ? manifest.configVars.filter((name) => typeof name === "string")
+        ? manifest.configVars.filter(guards_1.isText)
         : [];
     return { declared, configVars };
 }
@@ -146,7 +150,7 @@ async function loadProjectConfig(projectDir, environment) {
     const loader = new ConfigLoader(NODE_FILE_SYSTEM);
     let loaded;
     try {
-        loaded = (await loader.load(projectDir, environment));
+        loaded = await loader.load(projectDir, environment);
     }
     catch (error) {
         throw new cli_1.CliError({
@@ -185,7 +189,9 @@ function moduleFolder(projectDir, cacheFolder, source) {
 function readShippingVersion(sourcePath) {
     try {
         const pkg = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)((0, node_path_1.dirname)(sourcePath), "package.json"), "utf-8"));
-        return typeof pkg.version === "string" ? pkg.version : undefined;
+        return (0, guards_1.isObjectLike)(pkg) && "version" in pkg && (0, guards_1.isText)(pkg.version)
+            ? pkg.version
+            : undefined;
     }
     catch {
         return undefined;
@@ -197,7 +203,7 @@ function toLayer(registration) {
         path: registration.sourcePath,
         name: registration.name,
         sourcePath: registration.sourcePath,
-        packageName: typeof name === "string" ? name : undefined,
+        packageName: (0, guards_1.isText)(name) ? name : undefined,
         priority: registration.priority ?? 0,
         configKey: registration.configKey,
         options: registration.options ?? {},
@@ -218,12 +224,12 @@ function warnUndeclaredFrontend(id, folder) {
 }
 function registrationOf(id, folder, config, context) {
     const declaration = (0, layers_1.readLayerPackage)(folder)?.[exports.FRONTEND_DECLARATION_FIELD];
-    if (typeof declaration !== "string") {
+    if (!(0, guards_1.isText)(declaration)) {
         warnUndeclaredFrontend(id, folder);
         return undefined;
     }
     const { frontendModule } = require((0, node_path_1.join)(folder, declaration));
-    if (typeof frontendModule !== "function") {
+    if (!(0, guards_1.isCallable)(frontendModule)) {
         throw new cli_1.CliError({
             title: `${id}: ${declaration} exports no frontendModule function`,
             fixes: [`Export frontendModule(config, context) from ${declaration}`],

package/dist/renderer-range.js

@@ -10,6 +10,7 @@ const cli_1 = require("@antelopejs/core/cli");
 const semver_1 = __importDefault(require("semver"));
 const layers_1 = require("./layers");
 const output_1 = require("./output");
+const guards_1 = require("./internal/guards");
 const OWN_RELEASE = require("../package.json");
 const noticedModules = new Set();
 const NOTICED_MODULES_FILE = ".renderer-range-noticed";
@@ -45,7 +46,7 @@ function releaseLine(version) {
 }
 function describeProblem(declaration, version) {
     const { shown, range } = declaration;
-    if (typeof range !== "string" || semver_1.default.validRange(range) === null)
+    if (!(0, guards_1.isText)(range) || semver_1.default.validRange(range) === null)
         return `${shown} declares an unreadable range: ${JSON.stringify(range)}`;
     if (semver_1.default.satisfies(releaseLine(version), range))
         return undefined;

package/dist/server-process.js

@@ -11,6 +11,7 @@ const node_path_1 = require("node:path");
 const cli_1 = require("@antelopejs/core/cli");
 const cancellation_1 = require("./cancellation");
 const workspace_setup_1 = require("./workspace-setup");
+const guards_1 = require("./internal/guards");
 const READY_MESSAGE = "dms:ready";
 const LISTEN_ERROR_MESSAGE = "dms:listen-error";
 const START_ERROR_MESSAGE = "dms:start-error";
@@ -36,8 +37,7 @@ function stopOnAbort(child, signal) {
                 process.kill(-child.pid, "SIGTERM");
             }
         }
-        catch {
-        }
+        catch { }
     };
     if (signal.aborted) {
         stop();
@@ -46,43 +46,44 @@ function stopOnAbort(child, signal) {
     signal.addEventListener("abort", stop, { once: true });
     child.once("exit", () => signal.removeEventListener("abort", stop));
 }
-function isRecord(value) {
-    return typeof value === "object" && value !== null;
+function hasFile(value) {
+    return (0, guards_1.isObjectLike)(value) && "file" in value && (0, guards_1.isText)(value.file);
+}
+function isServerMessage(message) {
+    return (0, guards_1.isObjectLike)(message);
 }
 function readReady(message) {
-    if (!isRecord(message) || message.type !== READY_MESSAGE)
+    if (!isServerMessage(message) || message.type !== READY_MESSAGE)
         return undefined;
     const { address, port } = message;
-    if (typeof address !== "string" || typeof port !== "number")
+    if (!(0, guards_1.isText)(address) || !(0, guards_1.isNumber)(port))
         return undefined;
     return { address, port };
 }
 function readListenError(message) {
-    if (!isRecord(message) || message.type !== LISTEN_ERROR_MESSAGE)
+    if (!isServerMessage(message) || message.type !== LISTEN_ERROR_MESSAGE)
         return undefined;
     return {
-        code: typeof message.code === "string" ? message.code : undefined,
+        code: (0, guards_1.isText)(message.code) ? message.code : undefined,
         message: String(message.message),
         host: String(message.host),
         port: Number(message.port),
     };
 }
 function readStartError(message) {
-    if (!isRecord(message) || message.type !== START_ERROR_MESSAGE)
+    if (!isServerMessage(message) || message.type !== START_ERROR_MESSAGE)
         return undefined;
     const { location } = message;
-    const isLocated = isRecord(location) && typeof location.file === "string";
+    const isLocated = hasFile(location);
     return {
         message: String(message.message),
-        code: typeof message.code === "string" ? message.code : undefined,
+        code: (0, guards_1.isText)(message.code) ? message.code : undefined,
         location: isLocated
             ? {
                 file: String(location.file),
-                line: typeof location.line === "number" ? location.line : undefined,
-                column: typeof location.column === "number" ? location.column : undefined,
-                lineText: typeof location.lineText === "string"
-                    ? location.lineText
-                    : undefined,
+                line: (0, guards_1.isNumber)(location.line) ? location.line : undefined,
+                column: (0, guards_1.isNumber)(location.column) ? location.column : undefined,
+                lineText: (0, guards_1.isText)(location.lineText) ? location.lineText : undefined,
             }
             : undefined,
     };

package/dist/update-check.js

@@ -48,6 +48,7 @@ const node_path_1 = require("node:path");
 const cli_1 = require("@antelopejs/core/cli");
 const config_1 = require("./config");
 const output_1 = require("./output");
+const guards_1 = require("./internal/guards");
 exports.UPDATE_CHECK_PACKAGE = "@antelopejs/dms-frontend";
 const DEFAULT_REGISTRY_URL = "https://registry.npmjs.org/";
 const UPDATE_COMMAND = "ajs update dms";
@@ -104,20 +105,24 @@ function isUpdateCheckEnabled(argv, env) {
 function updateCheckCacheFile() {
     return (0, node_path_1.join)(config_1.DMS_FRONTEND_HOME, "update-check.json");
 }
+function isUpdateCheckCache(value) {
+    return ((0, guards_1.isObjectLike)(value) &&
+        "checkedAt" in value &&
+        (0, guards_1.isNumber)(value.checkedAt) &&
+        (!("latestVersion" in value) ||
+            value.latestVersion === undefined ||
+            (0, guards_1.isText)(value.latestVersion)) &&
+        (!("succeeded" in value) ||
+            value.succeeded === undefined ||
+            (0, guards_1.isFlag)(value.succeeded)));
+}
 function readCache(file) {
     try {
         const parsed = JSON.parse((0, node_fs_1.readFileSync)(file, "utf-8"));
-        if (typeof parsed?.checkedAt !== "number")
-            return undefined;
-        const latestVersion = parsed.latestVersion;
-        if (latestVersion !== undefined && typeof latestVersion !== "string") {
-            return undefined;
-        }
-        const succeeded = parsed.succeeded;
-        if (succeeded !== undefined && typeof succeeded !== "boolean") {
+        if (!isUpdateCheckCache(parsed))
             return undefined;
-        }
-        return { checkedAt: parsed.checkedAt, latestVersion, succeeded };
+        const { checkedAt, latestVersion, succeeded } = parsed;
+        return { checkedAt, latestVersion, succeeded };
     }
     catch {
         return undefined;
@@ -128,8 +133,7 @@ function writeCache(file, cache) {
         (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(file), { recursive: true });
         (0, node_fs_1.writeFileSync)(file, `${JSON.stringify(cache)}\n`);
     }
-    catch {
-    }
+    catch { }
 }
 function fetchLatestVersionFromRegistry(packageName, registryUrl = DEFAULT_REGISTRY_URL, timeoutMs = exports.UPDATE_CHECK_TIMEOUT_MS) {
     return new Promise((resolve) => {
@@ -160,8 +164,12 @@ function fetchLatestVersionFromRegistry(packageName, registryUrl = DEFAULT_REGIS
                 });
                 response.on("end", () => {
                     try {
-                        const version = JSON.parse(body)?.version;
-                        settle(typeof version === "string" ? version : undefined);
+                        const parsed = JSON.parse(body);
+                        settle((0, guards_1.isObjectLike)(parsed) &&
+                            "version" in parsed &&
+                            (0, guards_1.isText)(parsed.version)
+                            ? parsed.version
+                            : undefined);
                     }
                     catch {
                         settle();
@@ -220,8 +228,7 @@ function startUpdateCheck(options) {
                     latestVersion,
                     succeeded: published !== undefined,
                 });
-            }, () => {
-            });
+            }, () => { });
         let isReported = false;
         const report = async (placement = {}) => {
             if (isReported)

package/dist/verify-source-runner.js

@@ -98,7 +98,7 @@ function checkClientBundle(workspace) {
     const clientRoot = (0, node_path_1.join)(workspace, "dist", "client");
     const manifest = readJson((0, node_path_1.join)(clientRoot, ".vite", "manifest.json"));
     const mainEntry = Object.values(manifest).find((entry) => entry.isEntry);
-    ensure(mainEntry, "The Vite manifest names no entry chunk");
+    ensure(mainEntry !== undefined, "The Vite manifest names no entry chunk");
     const mainJavascript = (0, node_fs_1.readFileSync)((0, node_path_1.join)(clientRoot, mainEntry.file), "utf8");
     const javascript = (0, node_fs_1.readdirSync)((0, node_path_1.join)(clientRoot, "assets"))
         .filter((file) => file.endsWith(".js"))
@@ -119,7 +119,7 @@ async function checkServerModulesBundle(workspace) {
         .map((file) => (0, node_fs_1.readFileSync)((0, node_path_1.join)(root, file), "utf8"))
         .join("\n");
     ensure(!/\.vue["'?]|createApp\(|DefaultLayout/.test(javascript), "The server modules bundle loads application code", "A dms.server.ts imports server code only, never .vue files or dms.frontend.ts.");
-    const { serverModules } = (await Promise.resolve(`${(0, node_path_1.join)(root, "server-modules.generated.js")}`).then(s => __importStar(require(s))));
+    const { serverModules } = await Promise.resolve(`${(0, node_path_1.join)(root, "server-modules.generated.js")}`).then(s => __importStar(require(s)));
     ensure(Array.isArray(serverModules), "The server modules bundle exports none");
     return `${(0, cli_1.pluralize)(serverModules.length, "server module")}, ${(0, output_1.formatSize)(Buffer.byteLength(javascript))} JS`;
 }

package/dist/workspace-setup.js

@@ -127,8 +127,7 @@ function runCommand(command, args, options, onSpawn) {
                     process.kill(-child.pid, signal);
                 }
             }
-            catch {
-            }
+            catch { }
         };
         const stopChild = (signal) => {
             if (!alive())

package/dist/workspace.js

@@ -15,6 +15,7 @@ exports.isUnauthorized = isUnauthorized;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const config_1 = require("./config");
+const guards_1 = require("./internal/guards");
 const WORKSPACE_META_FILE = ".ajs-dms-meta.json";
 function getWorkspaceDirForKey(key) {
     return (0, node_path_1.join)(config_1.DMS_FRONTEND_HOME, (0, config_1.sha256Hex)(key));
@@ -75,15 +76,16 @@ function readWorkspaceMeta(dir) {
     catch {
         return undefined;
     }
-    const record = meta;
+    const backendUrl = (0, guards_1.isObjectLike)(meta) && "backendUrl" in meta ? meta.backendUrl : undefined;
+    const workspaceKey = (0, guards_1.isObjectLike)(meta) && "workspaceKey" in meta
+        ? meta.workspaceKey
+        : undefined;
+    const updatedAt = (0, guards_1.isObjectLike)(meta) && "updatedAt" in meta ? meta.updatedAt : undefined;
     return {
-        backendUrl: typeof record?.backendUrl === "string" ? record.backendUrl : undefined,
-        workspaceKey: typeof record?.workspaceKey === "string"
-            ? record.workspaceKey
-            : undefined,
-        updatedAt: typeof record?.updatedAt === "string" &&
-            !Number.isNaN(Date.parse(record.updatedAt))
-            ? new Date(record.updatedAt).toISOString()
+        backendUrl: (0, guards_1.isText)(backendUrl) ? backendUrl : undefined,
+        workspaceKey: (0, guards_1.isText)(workspaceKey) ? workspaceKey : undefined,
+        updatedAt: (0, guards_1.isText)(updatedAt) && !Number.isNaN(Date.parse(updatedAt))
+            ? new Date(updatedAt).toISOString()
             : undefined,
     };
 }
@@ -116,8 +118,7 @@ function directorySize(dir) {
                 seen.add(inode);
                 total += stats.size;
             }
-            catch {
-            }
+            catch { }
         }
     }
     return total;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antelopejs/dms-frontend",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "description": "Frontend-agnostic loader for AntelopeJS DMS, shipping the Vue 3 renderer (Vite, Inertia, SSR)",
   "keywords": [
     "antelope",
@@ -65,13 +65,14 @@
     "test:cli": "pnpm run build && DMS_PREBUILT=1 node --import tsx --test tests/cli.test.ts 'tests/cli-*.test.{ts,mts}'",
     "test:real-source": "pnpm run build && node dist/verify-source-runner.js",
     "format": "oxfmt .",
-    "lint": "oxlint && antelopejs-check-interface-ranges && pnpm run docs:reference:check",
+    "lint": "oxlint && antelopejs-check-interface-ranges && pnpm run docs:reference:check && pnpm run source-checks",
     "typecheck": "tsc --noEmit",
     "lint:fix": "oxlint --fix --max-warnings=1000000 && oxfmt .",
     "knip": "knip --dependencies",
     "knip:all": "knip",
     "docs:reference": "tsx scripts/docs-reference.ts",
     "docs:reference:check": "tsx scripts/docs-reference.ts --check",
+    "source-checks": "tsx scripts/source-checks.ts",
     "prepare": "if git rev-parse --is-inside-work-tree >/dev/null 2>&1 && command -v lefthook >/dev/null 2>&1; then lefthook install; fi",
     "checks": "antelopejs-checks",
     "size": "antelopejs-check-size",
@@ -79,7 +80,9 @@
     "sync": "antelopejs-sync",
     "ratchet:update": "antelopejs-ratchet --update",
     "sync:check": "antelopejs-sync --check",
-    "format:check": "oxfmt --check ."
+    "format:check": "oxfmt --check .",
+    "suppressions": "antelopejs-suppressions",
+    "suppressions:update": "antelopejs-suppressions --update"
   },
   "dependencies": {
     "@intlify/message-compiler": "^11.1.12",
@@ -90,7 +93,7 @@
   },
   "devDependencies": {
     "@antelopejs/core": "^1.16.0",
-    "@antelopejs/tooling-configs": "^0.2.0",
+    "@antelopejs/tooling-configs": "^0.2.17",
     "@iconify/utils": "^3.1.0",
     "@iconify/vue": "^5.0.1",
     "@inertiajs/vue3": "^3.7.1",

package/skills/dms-frontend/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: dms-frontend
-description: Runs, builds, deploys and extends the AntelopeJS DMS frontend with @antelopejs/dms-frontend (the ajs dms CLI, the Vue renderer, the frontend-module SDK). Use when running ajs dms dev, build, start, prepare, workspaces, clean or verify-source; configuring DMS_* environment variables, the session or bootstrap secret; writing a frontend module's dms.frontend.ts, dms.server.ts (server routes, auth hooks, route rules, backend proxies) or dms.frontend.build.ts; declaring engines["@antelopejs/dms-frontend"]; deploying the frontend server behind a reverse proxy; or debugging a refused range, a missing secret, a 404 from the proxy or a stale workspace.
+description: Runs, builds, deploys and extends the AntelopeJS DMS frontend with @antelopejs/dms-frontend (the ajs dms CLI, the Vue renderer, the frontend-module SDK). Use when running ajs dms dev, build, start, prepare, workspaces, clean or verify-source; configuring DMS_* environment variables, the session or bootstrap secret; writing a frontend module's dms.frontend.ts, dms.server.ts (server routes, auth hooks, route rules, backend proxies) or dms.frontend.build.ts; declaring engines["@antelopejs/dms-frontend"]; deploying the frontend server behind a reverse proxy; or debugging a refused range, a missing secret, a 404 from the proxy or a stale workspace. Not for restarting a DMS project's running backend and frontend dev servers or reading their logs (use dms-project).
 icon: i-lucide-app-window
 category: tooling
 tags: [frontend, cli, renderer, vue, inertia, ssr, deployment, dms-module]

package/skills/dms-frontend/cases.json

@@ -0,0 +1,77 @@
+{
+  "version": 1,
+  "cases": [
+    {
+      "id": "deploy-dashboard",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Deploy the dashboard to production behind an nginx reverse proxy.",
+      "expect": {
+        "skills": ["dms-frontend"],
+        "acceptable": ["dms-project", "dms"]
+      }
+    },
+    {
+      "id": "dms-build-401-casual",
+      "area": "dms",
+      "style": "casual",
+      "prompt": "ajs dms build fails with a 401, wtf",
+      "expect": {
+        "skills": ["dms-frontend"],
+        "acceptable": ["dms-project", "ajs-cli"]
+      }
+    },
+    {
+      "id": "frontend-session-secret",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "The frontend server refuses to start because of a missing session secret. How do I configure it?",
+      "expect": {
+        "skills": ["dms-frontend"],
+        "acceptable": ["dms-project"]
+      }
+    },
+    {
+      "id": "frontend-server-route",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Add a server route to my module's frontend (dms.server.ts) that proxies to an external API.",
+      "expect": {
+        "skills": ["dms-frontend"],
+        "acceptable": ["dms-module", "dms"]
+      }
+    },
+    {
+      "id": "dms-frontend-not-dev-servers",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "My page change does not show live. How do I restart the backend and the frontend dev servers of my DMS project and read their logs?",
+      "expect": {
+        "skills": ["dms-project"],
+        "acceptable": ["dms"],
+        "avoid": ["dms-frontend"]
+      }
+    },
+    {
+      "id": "dms-frontend-backend-proxy",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Browser requests to /reports/summary answer 404 although my backend serves that route. How do I let the frontend server reach it?",
+      "expect": {
+        "skills": ["dms-frontend"],
+        "acceptable": ["dms-project", "dms-module"]
+      }
+    },
+    {
+      "id": "dms-frontend-module-entry",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Write the dms.frontend.ts entry for my module so its components are namespaced under the Acme prefix.",
+      "expect": {
+        "skills": ["dms-frontend"],
+        "acceptable": ["dms-module", "dms"],
+        "mustMention": ["componentPrefix", "setup"]
+      }
+    }
+  ]
+}