@kvman/testkit 0.1.0

package/dist/preset/preset-bin.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import { BinFailure, printFailure } from "../bin/bin-failure.js";
+import { findRunningKvman } from "../running/running-kvman.js";
+import { checkPreset } from "./preset-check.js";
+import { writePresetFile } from "./preset-new.js";
+// The `kvman-preset` bin (plan 09 §9.1, plan 10, ADR 0010, 2): writes a starting preset (`new`) and validates a
+// preset's schema and references (`check`), for any harness or none. `check` asks the running kvman for its
+// extensions, settings, and pages; with none running it checks the schema and the `path:` folders only. With
+// `--json` each prints its output as one JSON line.
+const usage = 'Usage: kvman-preset new <file> --name <name> [--json]\nUsage: kvman-preset check <file> [--json] [--home <dir>] [--url <url>]';
+function parseOptions(argv) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: argv,
+            allowPositionals: true,
+            options: {
+                name: { type: 'string' },
+                json: { type: 'boolean', default: false },
+                home: { type: 'string' },
+                url: { type: 'string' },
+            },
+        });
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new BinFailure('VALIDATION_FAILED', `${reason} ${usage}`);
+    }
+    const [subcommand, ...rest] = parsed.positionals;
+    if (subcommand === 'new') {
+        if (parsed.values.home !== undefined || parsed.values.url !== undefined)
+            throw new BinFailure('VALIDATION_FAILED', `new takes no --home or --url. ${usage}`);
+        const [file, ...extra] = rest;
+        if (file === undefined || extra.length > 0)
+            throw new BinFailure('VALIDATION_FAILED', `new takes a single <file> argument. ${usage}`);
+        if (parsed.values.name === undefined)
+            throw new BinFailure('VALIDATION_FAILED', `--name is required. ${usage}`);
+        if (parsed.values.name === '')
+            throw new BinFailure('VALIDATION_FAILED', `--name must not be empty. ${usage}`);
+        return { kind: 'new', file, name: parsed.values.name, json: parsed.values.json ?? false };
+    }
+    if (subcommand === 'check') {
+        if (parsed.values.name !== undefined)
+            throw new BinFailure('VALIDATION_FAILED', `check takes no --name. ${usage}`);
+        const [file, ...extra] = rest;
+        if (file === undefined || extra.length > 0)
+            throw new BinFailure('VALIDATION_FAILED', `check takes a single <file> argument. ${usage}`);
+        return { kind: 'check', file, json: parsed.values.json ?? false, home: parsed.values.home, url: parsed.values.url };
+    }
+    if (subcommand === undefined)
+        throw new BinFailure('VALIDATION_FAILED', `A subcommand is required. ${usage}`);
+    throw new BinFailure('VALIDATION_FAILED', `Unknown subcommand ${JSON.stringify(subcommand)}; give new or check. ${usage}`);
+}
+function readableFindings(findings) {
+    if (findings.length === 0)
+        return 'No findings.\n';
+    return `${findings.map((finding) => `${finding.file}: ${finding.message}\n  ${finding.hint}`).join('\n')}\n`;
+}
+const json = process.argv.includes('--json');
+try {
+    const command = parseOptions(process.argv.slice(2));
+    if (command.kind === 'new') {
+        const created = writePresetFile(command.file, command.name);
+        if (command.json)
+            process.stdout.write(`${JSON.stringify({ file: created.file })}\n`);
+        else
+            process.stdout.write(`Wrote ${command.file}.\n`);
+    }
+    else {
+        const locate = {};
+        if (command.home !== undefined)
+            locate.home = command.home;
+        if (command.url !== undefined)
+            locate.url = command.url;
+        const checked = await checkPreset(command.file, findRunningKvman(locate));
+        if (command.json)
+            process.stdout.write(`${JSON.stringify(checked.findings)}\n`);
+        else
+            process.stdout.write(readableFindings(checked.findings));
+        if (!checked.running)
+            process.stderr.write("kvman isn't running; only the preset's schema and path: folders were checked.\n");
+        if (checked.findings.length > 0)
+            process.exitCode = 1;
+    }
+}
+catch (error) {
+    printFailure(error, json);
+    process.exitCode = 1;
+}
+//# sourceMappingURL=preset-bin.js.map

package/dist/preset/preset-bin.js.map

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

package/dist/preset/preset-check.d.ts

@@ -0,0 +1,15 @@
+import { type RunningKvman } from '../running/running-kvman.ts';
+/** A preset finding: `file` is the checked file exactly as given. */
+export type PresetFinding = {
+    file: string;
+    message: string;
+    hint: string;
+};
+/** The check's findings, and whether a running kvman answered. */
+export type PresetCheck = {
+    findings: PresetFinding[];
+    running: boolean;
+};
+/** Checks the preset in `file`: `file` resolves against the current working folder and stays as given in findings. */
+export declare function checkPreset(file: string, found: RunningKvman | undefined): Promise<PresetCheck>;
+//# sourceMappingURL=preset-check.d.ts.map

package/dist/preset/preset-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-check.d.ts","sourceRoot":"","sources":["../../src/preset/preset-check.ts"],"names":[],"mappings":"AAIA,OAAO,EAAyB,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AASvF,qEAAqE;AACrE,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,kEAAkE;AAClE,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAgF1E,sHAAsH;AACtH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAiBrG"}

package/dist/preset/preset-check.js

@@ -0,0 +1,113 @@
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { healthSchema, kernelQuerySchemas, presetSchema, ProblemError, z } from '@kvman/sdk';
+import { callQuery } from "../running/call-query.js";
+import { KvmanUnreachableError } from "../running/running-kvman.js";
+import { presetReach } from "./preset-reach.js";
+// kvwebui's own pages (plan 06 §6.6), which no ui.get lists.
+const builtInPages = ['kvwebui.settings', 'kvwebui.extensions'];
+const extensionsListOutput = kernelQuerySchemas['kernel.extensions.list'].output;
+const settingsListOutput = kernelQuerySchemas['kernel.settings.list'].output;
+const uiGetOutput = z.object({ pages: z.array(z.object({ id: z.string() }).loose()) }).loose();
+function readPreset(absolute) {
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(absolute, 'utf8'));
+    }
+    catch (error) {
+        if (error instanceof SyntaxError || (error instanceof Error && 'code' in error && error.code === 'ENOENT'))
+            return { problems: [{ message: `The preset can't be read: ${error.message}`, hint: 'A preset is one JSON object.' }] };
+        throw error;
+    }
+    const parsed = presetSchema.safeParse(raw);
+    if (parsed.success)
+        return { preset: parsed.data };
+    return { problems: parsed.error.issues.map((issue) => ({ message: `${issue.path.join('.') || 'preset'}: ${issue.message}`, hint: 'A preset is { name, extensions, settings? }, with no other keys (plan 02 §2.10).' })) };
+}
+function settingProblems(settings, reach, registered) {
+    const problems = [];
+    for (const [key, value] of Object.entries(settings)) {
+        const namespace = key.split('.')[0] ?? '';
+        if (namespace === 'kernel' || reach.loaded.has(namespace)) {
+            const setting = registered.find((candidate) => candidate.key === key);
+            if (setting === undefined)
+                problems.push({ message: `${key} isn't a setting of ${namespace}.`, hint: 'kernel.settings.list lists every registered key.' });
+            else {
+                const checked = z.fromJSONSchema(setting.schema).safeParse(value);
+                if (!checked.success)
+                    problems.push({ message: `${key}: ${checked.error.issues.map((issue) => issue.message).join('; ')}`, hint: `${key} is: ${setting.description}` });
+            }
+        }
+        else if (!reach.unloaded.has(namespace) && !reach.hasNpm) {
+            problems.push({ message: `${key} belongs to ${namespace}, which isn't kernel or one of the preset's extensions.`, hint: 'Add the extension that registers it, or remove the key.' });
+        }
+    }
+    return problems;
+}
+async function pagesOf(running, namespace) {
+    let answer;
+    try {
+        answer = await callQuery(running, `${namespace}.ui.get`, {}, uiGetOutput);
+    }
+    catch (error) {
+        if (error instanceof ProblemError)
+            return error;
+        throw error;
+    }
+    return answer.pages.map((page) => `${namespace}.${page.id}`);
+}
+async function homeProblems(running, home, reach) {
+    if (typeof home !== 'string' || builtInPages.includes(home))
+        return [];
+    const namespace = home.split('.')[0] ?? '';
+    if (reach.unloaded.has(namespace) || (reach.hasNpm && !reach.loaded.has(namespace)))
+        return [];
+    const hint = 'kvwebui.home names a page with no params, as <namespace>.<page>, or kvwebui.extensions.';
+    if (!reach.loaded.has(namespace))
+        return [{ message: `kvwebui.home ${home} is under ${namespace}, which isn't one of the preset's extensions.`, hint }];
+    const pages = await pagesOf(running, namespace);
+    if (pages instanceof ProblemError)
+        return [{ message: `kvwebui.home ${home}: ${namespace}.ui.get fails with ${pages.problem.code}.`, hint }];
+    return pages.includes(home) ? [] : [{ message: `kvwebui.home ${home} isn't a page of ${namespace}.`, hint: `${namespace}'s pages: ${pages.join(', ') || 'none'}.` }];
+}
+function toFindings(file, problems) {
+    return problems.map((problem) => ({ file, ...problem }));
+}
+// A kvman that was found counts as running only once it answers; a refused connection means it doesn't.
+async function answering(found) {
+    if (found === undefined)
+        return undefined;
+    try {
+        await callQuery(found, 'kernel.health.get', {}, healthSchema);
+        return found;
+    }
+    catch (error) {
+        if (error instanceof KvmanUnreachableError)
+            return undefined;
+        throw error;
+    }
+}
+/** Checks the preset in `file`: `file` resolves against the current working folder and stays as given in findings. */
+export async function checkPreset(file, found) {
+    const running = await answering(found);
+    const absolute = path.resolve(file);
+    const read = readPreset(absolute);
+    if ('problems' in read)
+        return { findings: toFindings(file, read.problems), running: running !== undefined };
+    const preset = read.preset;
+    const local = presetReach(preset, absolute, undefined);
+    if (running === undefined)
+        return { findings: toFindings(file, local.problems), running: false };
+    try {
+        const reach = presetReach(preset, absolute, await callQuery(running, 'kernel.extensions.list', {}, extensionsListOutput));
+        const registered = await callQuery(running, 'kernel.settings.list', {}, settingsListOutput);
+        const settings = preset.settings ?? {};
+        return { findings: toFindings(file, [...reach.problems, ...settingProblems(settings, reach, registered), ...(await homeProblems(running, settings['kvwebui.home'], reach))]), running: true };
+    }
+    catch (error) {
+        if (error instanceof KvmanUnreachableError)
+            return { findings: toFindings(file, local.problems), running: false };
+        throw error;
+    }
+}
+//# sourceMappingURL=preset-check.js.map

package/dist/preset/preset-check.js.map

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

package/dist/preset/preset-new.d.ts

@@ -0,0 +1,5 @@
+/** Writes the starting preset to `file` and resolves to its absolute path. */
+export declare function writePresetFile(file: string, name: string): {
+    file: string;
+};
+//# sourceMappingURL=preset-new.d.ts.map

package/dist/preset/preset-new.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-new.d.ts","sourceRoot":"","sources":["../../src/preset/preset-new.ts"],"names":[],"mappings":"AAQA,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAO5E"}

package/dist/preset/preset-new.js

@@ -0,0 +1,16 @@
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { BinFailure } from "../bin/bin-failure.js";
+// `kvman-preset new` (plan 09 §9.1): a preset that runs as-is, kvai and kvwebui with the Extensions page as its
+// home, for the person to add extensions and settings to. `<file>` resolves against the current working folder.
+/** Writes the starting preset to `file` and resolves to its absolute path. */
+export function writePresetFile(file, name) {
+    const absolute = path.resolve(file);
+    if (existsSync(absolute))
+        throw new BinFailure('FILE_EXISTS', `${file} already exists; choose another file.`, { file });
+    const preset = { name, extensions: { '@kvman/kvai': 'bundled', '@kvman/kvwebui': 'bundled' }, settings: { 'kvwebui.home': 'kvwebui.extensions' } };
+    mkdirSync(path.dirname(absolute), { recursive: true });
+    writeFileSync(absolute, `${JSON.stringify(preset, null, 2)}\n`);
+    return { file: absolute };
+}
+//# sourceMappingURL=preset-new.js.map

package/dist/preset/preset-new.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-new.js","sourceRoot":"","sources":["../../src/preset/preset-new.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,gHAAgH;AAChH,gHAAgH;AAEhH,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,IAAY;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,UAAU,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,aAAa,EAAE,GAAG,IAAI,uCAAuC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACxH,MAAM,MAAM,GAAW,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,EAAE,cAAc,EAAE,oBAAoB,EAAE,EAAE,CAAC;IAC3J,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,aAAa,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAChE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC"}

package/dist/preset/preset-reach.d.ts

@@ -0,0 +1,18 @@
+import { extensionInfoSchema, type Preset, type z } from '@kvman/sdk';
+/** An extension as `kernel.extensions.list` describes it. */
+export type ExtensionInfo = z.infer<typeof extensionInfoSchema>;
+export type PresetReach = {
+    /** Namespaces of the preset's extensions loaded by the running kvman, whose settings and pages can be checked. */
+    loaded: ReadonlySet<string>;
+    /** Namespaces of its `path:` extensions, which aren't loaded by the running kvman. */
+    unloaded: ReadonlySet<string>;
+    /** Whether it has `npm:` extensions, whose namespaces aren't known without fetching them. */
+    hasNpm: boolean;
+    problems: {
+        message: string;
+        hint: string;
+    }[];
+};
+/** Sorts the preset's extensions into loaded and unloaded namespaces, with a problem per bad reference. */
+export declare function presetReach(preset: Preset, presetFile: string, extensions: readonly ExtensionInfo[] | undefined): PresetReach;
+//# sourceMappingURL=preset-reach.d.ts.map

package/dist/preset/preset-reach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-reach.d.ts","sourceRoot":"","sources":["../../src/preset/preset-reach.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,KAAK,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,YAAY,CAAC;AAQtE,6DAA6D;AAC7D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,MAAM,MAAM,WAAW,GAAG;IACxB,kHAAkH;IAClH,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5B,sFAAsF;IACtF,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B,6FAA6F;IAC7F,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/C,CAAC;AAEF,2GAA2G;AAC3G,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,GAAG,WAAW,CAsB7H"}

package/dist/preset/preset-reach.js

@@ -0,0 +1,33 @@
+import path from 'node:path';
+import { extensionInfoSchema } from '@kvman/sdk';
+import { readProjectManifest } from "./project-manifest.js";
+/** Sorts the preset's extensions into loaded and unloaded namespaces, with a problem per bad reference. */
+export function presetReach(preset, presetFile, extensions) {
+    const loaded = new Set();
+    const unloaded = new Set();
+    const problems = [];
+    let hasNpm = false;
+    for (const [name, source] of Object.entries(preset.extensions)) {
+        if (source === 'bundled') {
+            const bundled = extensions?.find((extension) => extension.name === name && extension.source === 'bundled');
+            if (bundled !== undefined)
+                loaded.add(bundled.namespace);
+            else if (extensions !== undefined) {
+                problems.push({ message: `${name} isn't a bundled extension.`, hint: `The bundled extensions are ${extensions.filter((extension) => extension.source === 'bundled').map((extension) => extension.name).join(', ')}.` });
+            }
+        }
+        else if (source.startsWith('path:')) {
+            const folder = path.resolve(path.dirname(presetFile), source.slice('path:'.length));
+            const manifest = readProjectManifest(folder);
+            if (manifest === undefined)
+                problems.push({ message: `${name}: ${folder} has no package.json with a kvman field.`, hint: 'A path: source is a project folder, relative to the preset file.' });
+            else
+                unloaded.add(manifest.namespace);
+        }
+        else {
+            hasNpm = true;
+        }
+    }
+    return { loaded, unloaded, hasNpm, problems };
+}
+//# sourceMappingURL=preset-reach.js.map

package/dist/preset/preset-reach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-reach.js","sourceRoot":"","sources":["../../src/preset/preset-reach.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAuB,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAoB5D,2GAA2G;AAC3G,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,UAAkB,EAAE,UAAgD;IAC9G,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,UAAU,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;YAC3G,IAAI,OAAO,KAAK,SAAS;gBAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;iBACpD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,6BAA6B,EAAE,IAAI,EAAE,8BAA8B,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAC1N,CAAC;QACH,CAAC;aAAM,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YACpF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;YAC7C,IAAI,QAAQ,KAAK,SAAS;gBAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,KAAK,MAAM,0CAA0C,EAAE,IAAI,EAAE,kEAAkE,EAAE,CAAC,CAAC;;gBAC1L,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAChD,CAAC"}

package/dist/preset/project-manifest.d.ts

@@ -0,0 +1,5 @@
+/** The namespace of the project in `folder`, or `undefined` when it has no package.json with a `kvman` field. */
+export declare function readProjectManifest(folder: string): {
+    namespace: string;
+} | undefined;
+//# sourceMappingURL=project-manifest.d.ts.map

package/dist/preset/project-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-manifest.d.ts","sourceRoot":"","sources":["../../src/preset/project-manifest.ts"],"names":[],"mappings":"AAaA,iHAAiH;AACjH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAarF"}

package/dist/preset/project-manifest.js

@@ -0,0 +1,30 @@
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { z } from '@kvman/sdk';
+// Where a `path:` extension's namespace comes from (ADR 0009, 121): the folder, relative to the preset file, must
+// hold a package.json with a `kvman` field. Anything else means the folder isn't a project.
+const manifestSchema = z
+    .object({
+    kvman: z.object({ namespace: z.string() }).loose(),
+})
+    .loose();
+/** The namespace of the project in `folder`, or `undefined` when it has no package.json with a `kvman` field. */
+export function readProjectManifest(folder) {
+    const file = path.join(folder, 'package.json');
+    if (!existsSync(file))
+        return undefined;
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            return undefined;
+        throw error;
+    }
+    const parsed = manifestSchema.safeParse(raw);
+    if (!parsed.success)
+        return undefined;
+    return { namespace: parsed.data.kvman.namespace };
+}
+//# sourceMappingURL=project-manifest.js.map

package/dist/preset/project-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-manifest.js","sourceRoot":"","sources":["../../src/preset/project-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAE/B,kHAAkH;AAClH,4FAA4F;AAE5F,MAAM,cAAc,GAAG,CAAC;KACrB,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE;CACnD,CAAC;KACD,KAAK,EAAE,CAAC;AAEX,iHAAiH;AACjH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,WAAW;YAAE,OAAO,SAAS,CAAC;QACnD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IACtC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;AACpD,CAAC"}

package/dist/preview/preview-bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=preview-bin.d.ts.map

package/dist/preview/preview-bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-bin.d.ts","sourceRoot":"","sources":["../../src/preview/preview-bin.ts"],"names":[],"mappings":""}

package/dist/preview/preview-bin.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import { z } from '@kvman/sdk';
+import { BinFailure, printFailure } from "../bin/bin-failure.js";
+import { runPreview } from "./preview-run.js";
+// The `kvman-preview` bin (plan 09 §9.3, plan 10, ADR 0010, 2, 7, 21): runs a preview kvman in a terminal's foreground
+// for the extension projects in `<folder>…`, on its own home and port. It prints the URL once the preview answers
+// and keeps running until SIGINT or SIGTERM. With `--json` it prints `{ "url" }` as one JSON line.
+const usage = 'Usage: kvman-preview <folder>… [--preset <file>] [--kvman <entry>] [--name <name>] [--json]';
+const optionsSchema = z.object({
+    folders: z.array(z.string().min(1)).min(1),
+    preset: z.string().min(1).optional(),
+    kvman: z.string().min(1).optional(),
+    name: z.string().min(1),
+    json: z.boolean(),
+});
+function parseOptions(argv) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: argv,
+            allowPositionals: true,
+            options: {
+                preset: { type: 'string' },
+                kvman: { type: 'string' },
+                name: { type: 'string', default: 'preview' },
+                json: { type: 'boolean', default: false },
+            },
+        });
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new BinFailure('VALIDATION_FAILED', `${reason} ${usage}`);
+    }
+    const checked = optionsSchema.safeParse({
+        folders: parsed.positionals,
+        preset: parsed.values.preset,
+        kvman: parsed.values.kvman,
+        name: parsed.values.name ?? 'preview',
+        json: parsed.values.json ?? false,
+    });
+    if (!checked.success) {
+        if (parsed.positionals.length === 0)
+            throw new BinFailure('VALIDATION_FAILED', `At least one <folder> argument is required. ${usage}`);
+        throw new BinFailure('VALIDATION_FAILED', `${checked.error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`).join('; ')} ${usage}`);
+    }
+    return checked.data;
+}
+const json = process.argv.includes('--json');
+try {
+    const options = parseOptions(process.argv.slice(2));
+    await runPreview(options, (url) => {
+        if (options.json)
+            process.stdout.write(`${JSON.stringify({ url })}\n`);
+        else
+            process.stdout.write(`Preview running at ${url}\n`);
+    });
+}
+catch (error) {
+    printFailure(error, json);
+    process.exitCode = 1;
+}
+//# sourceMappingURL=preview-bin.js.map

package/dist/preview/preview-bin.js.map

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

package/dist/preview/preview-home.d.ts

@@ -0,0 +1,5 @@
+/** The preview's home folder for `name`. */
+export declare function previewHome(name: string): string;
+/** Empties the preview's home, or fails `PREVIEW_FAILED` when its preview still runs. */
+export declare function preparePreviewHome(name: string): string;
+//# sourceMappingURL=preview-home.d.ts.map

package/dist/preview/preview-home.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-home.d.ts","sourceRoot":"","sources":["../../src/preview/preview-home.ts"],"names":[],"mappings":"AA8CA,4CAA4C;AAC5C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWvD"}

package/dist/preview/preview-home.js

@@ -0,0 +1,64 @@
+import { existsSync, mkdirSync, readFileSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { z } from '@kvman/sdk';
+import { BinFailure } from "../bin/bin-failure.js";
+// The preview's home (plan 09 §9.3, ADR 0009, 125): `<os temp>/kvman-preview-<name>`, emptied at each start and removed
+// when the preview stops. A home whose `kvman.lock` names a live pid means its preview still runs.
+const lockSchema = z.object({ pid: z.number().int().positive() }).loose();
+function hasCode(error, code) {
+    return error instanceof Error && 'code' in error && error.code === code;
+}
+// The same liveness rule as the running-kvman lookup: a pid that can't be signaled is gone, unless permission says
+// it exists.
+function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        if (hasCode(error, 'ESRCH'))
+            return false;
+        if (hasCode(error, 'EPERM'))
+            return true;
+        throw error;
+    }
+}
+function lockPid(home) {
+    let text;
+    try {
+        text = readFileSync(path.join(home, 'kvman.lock'), 'utf8');
+    }
+    catch (error) {
+        if (hasCode(error, 'ENOENT'))
+            return undefined;
+        throw error;
+    }
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+    const lock = lockSchema.safeParse(raw);
+    return lock.success ? lock.data.pid : undefined;
+}
+/** The preview's home folder for `name`. */
+export function previewHome(name) {
+    return path.join(tmpdir(), `kvman-preview-${name}`);
+}
+/** Empties the preview's home, or fails `PREVIEW_FAILED` when its preview still runs. */
+export function preparePreviewHome(name) {
+    const home = previewHome(name);
+    if (existsSync(home)) {
+        const pid = lockPid(home);
+        if (pid !== undefined && isAlive(pid)) {
+            throw new BinFailure('PREVIEW_FAILED', `A preview named ${name} already runs; stop it first or use --name.`, { name });
+        }
+        rmSync(home, { recursive: true, force: true });
+    }
+    mkdirSync(home, { recursive: true });
+    return home;
+}
+//# sourceMappingURL=preview-home.js.map

package/dist/preview/preview-home.js.map

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

package/dist/preview/preview-manifest.d.ts

@@ -0,0 +1,9 @@
+/** A project: its package name and whether it has a `web:watch` script. */
+export type PreviewProject = {
+    name: string;
+    folder: string;
+    webWatch: boolean;
+};
+/** Reads the project in `folder`, or `undefined` when it has no package.json with a `kvman` field. */
+export declare function readPreviewProject(folder: string): PreviewProject | undefined;
+//# sourceMappingURL=preview-manifest.d.ts.map

package/dist/preview/preview-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-manifest.d.ts","sourceRoot":"","sources":["../../src/preview/preview-manifest.ts"],"names":[],"mappings":"AAeA,2EAA2E;AAC3E,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAEjF,sGAAsG;AACtG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAa7E"}

package/dist/preview/preview-manifest.js

@@ -0,0 +1,32 @@
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { z } from '@kvman/sdk';
+// The project check (plan 09 §9.3, ADR 0009, 121): a folder is a project when its package.json has a `kvman` field.
+// The preview needs the package name for the generated preset and the scripts for `web:watch`.
+const manifestSchema = z
+    .object({
+    name: z.string(),
+    scripts: z.record(z.string(), z.string()).optional(),
+    kvman: z.object({ namespace: z.string() }).loose(),
+})
+    .loose();
+/** Reads the project in `folder`, or `undefined` when it has no package.json with a `kvman` field. */
+export function readPreviewProject(folder) {
+    const file = path.join(folder, 'package.json');
+    if (!existsSync(file))
+        return undefined;
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            return undefined;
+        throw error;
+    }
+    const parsed = manifestSchema.safeParse(raw);
+    if (!parsed.success)
+        return undefined;
+    return { name: parsed.data.name, folder, webWatch: parsed.data.scripts?.['web:watch'] !== undefined };
+}
+//# sourceMappingURL=preview-manifest.js.map

package/dist/preview/preview-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-manifest.js","sourceRoot":"","sources":["../../src/preview/preview-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAE/B,oHAAoH;AACpH,+FAA+F;AAE/F,MAAM,cAAc,GAAG,CAAC;KACrB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE;CACnD,CAAC;KACD,KAAK,EAAE,CAAC;AAKX,sGAAsG;AACtG,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,WAAW;YAAE,OAAO,SAAS,CAAC;QACnD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IACtC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,KAAK,SAAS,EAAE,CAAC;AACxG,CAAC"}

package/dist/preview/preview-port.d.ts

@@ -0,0 +1,5 @@
+export declare const firstPreviewPort = 3738;
+export declare const lastPreviewPort = 3837;
+/** The first free preview port, or `NO_FREE_PORT` when 3738 to 3837 are all taken. */
+export declare function previewPort(isFree?: (port: number) => Promise<boolean>): Promise<number>;
+//# sourceMappingURL=preview-port.d.ts.map

package/dist/preview/preview-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-port.d.ts","sourceRoot":"","sources":["../../src/preview/preview-port.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,eAAe,OAAO,CAAC;AAUpC,sFAAsF;AACtF,wBAAsB,WAAW,CAAC,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAK1G"}