@fapost/jig-ui 0.2.0-next.21 → 0.2.0-next.23

package/dist/registry/instance.js

@@ -1,6 +1,9 @@
 import { randomBytes } from 'node:crypto';
 import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
+import { z } from 'zod';
+/** What a running instance records so that a second start can find it. */
+const InstanceInfo = z.object({ port: z.int(), token: z.string(), pid: z.int(), version: z.string() });
 const FILE = 'instance.json';
 /** The page that sends the browser on to the instance; it carries the token, so it lives here too. */
 export const OPEN_FILE = 'open.html';
@@ -8,10 +11,7 @@ export const OPEN_FILE = 'open.html';
 export const cookieName = (port) => `jig-ui-${port}`;
 export async function readInstance(dir) {
     try {
-        const info = JSON.parse(await readFile(join(dir, FILE), 'utf8'));
-        if (typeof info.port !== 'number' || typeof info.token !== 'string')
-            return undefined;
-        return info;
+        return InstanceInfo.safeParse(JSON.parse(await readFile(join(dir, FILE), 'utf8'))).data;
     }
     catch {
         return undefined;
@@ -48,6 +48,11 @@ export async function probeInstance(info, timeoutMs = 1000) {
         return false;
     }
 }
+// An instance before 0.2.0 answers a failure it did not foresee in plain text: neither of these.
+const Answer = z.union([
+    z.object({ project: z.object({ id: z.string() }) }),
+    z.object({ error: z.object({ code: z.string(), message: z.string() }) }),
+]);
 /** Asks the instance to connect `path`, as the page does: the instance owns the registry, so no second process writes it. */
 export async function connectThrough(info, path, timeoutMs = 15_000) {
     try {
@@ -57,13 +62,10 @@ export async function connectThrough(info, path, timeoutMs = 15_000) {
             body: JSON.stringify({ path }),
             signal: AbortSignal.timeout(timeoutMs),
         });
-        // An instance before 0.2.0 answers a failure it did not foresee in plain text.
-        const body = (await res.json().catch(() => ({})));
-        if (body.project)
+        const body = Answer.safeParse(await res.json().catch(() => undefined)).data;
+        if (body && 'project' in body)
             return { id: body.project.id, created: res.status === 201 };
-        if (typeof body.error === 'object')
-            return body.error;
-        return { code: 'unexpected', message: `Jig UI answered ${res.status}.` };
+        return body?.error ?? { code: 'unexpected', message: `Jig UI answered ${res.status}.` };
     }
     catch (error) {
         return { code: 'unreachable', message: error instanceof Error ? error.message : String(error) };

package/dist/registry/projects.js

@@ -1,5 +1,6 @@
 import { readFile } from 'node:fs/promises';
 import { basename, join } from 'node:path';
+import { z } from 'zod';
 import { writeConfigFile } from './instance.js';
 const FILE = 'projects.json';
 /** The registry file exists but cannot be read; it is never overwritten then, so the list is not lost. */
@@ -8,7 +9,8 @@ export class RegistryUnreadable extends Error {
         super(`${FILE} in Jig UI's config directory cannot be read; fix or remove it.`);
     }
 }
-const isProject = (p) => typeof p === 'object' && p !== null && typeof p.id === 'string' && typeof p.path === 'string';
+// A row keeps the fields it does not know, so a later version's additions survive this one's writes.
+const Registry = z.object({ projects: z.array(z.looseObject({ id: z.string(), path: z.string() })) });
 /** The connected projects in the order they were connected; none when there is no registry yet. */
 export async function readProjects(dir) {
     let text;
@@ -20,15 +22,17 @@ export async function readProjects(dir) {
             return [];
         throw new RegistryUnreadable();
     }
+    let json;
     try {
-        const { projects } = JSON.parse(text);
-        if (Array.isArray(projects) && projects.every(isProject))
-            return projects;
+        json = JSON.parse(text);
     }
     catch {
-        // falls through
+        throw new RegistryUnreadable();
     }
-    throw new RegistryUnreadable();
+    const registry = Registry.safeParse(json);
+    if (!registry.success)
+        throw new RegistryUnreadable();
+    return registry.data.projects;
 }
 /** The id for a checkout: its directory name as a slug, with `-2`, `-3`… when that is taken. */
 export function slugFor(root, taken) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fapost/jig-ui",
-  "version": "0.2.0-next.21",
+  "version": "0.2.0-next.23",
   "description": "A local web interface for Jig, the agent SDLC framework.",
   "license": "MIT",
   "type": "module",