@minnovate/shadow-publisher 0.18.2 → 0.18.4

package/dist/claude/plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "git-publisher",
   "displayName": "Git Publisher",
-  "version": "0.18.2",
+  "version": "0.18.4",
   "description": "Publish an app folder's Git history to the serverless Git publishing backend and keep it updated (\"publish my app\", \"update my app\", \"fetch the engineered version\").",
   "author": { "name": "git-publisher project" },
   "keywords": ["git", "publish", "deploy", "serverless"]

package/dist/publisher.cjs

@@ -21651,8 +21651,107 @@ async function updateEntry(url2, change) {
   await writeCredentials(file2);
 }
 
-// ../client/src/clients/portal/portal-request.ts
-var PortalSession = class {
+// ../client/src/clients/applications/api.generated.ts
+var getApiTerminalRepositoriesRuns = {
+  path: (params) => `/api/v1/terminal/repositories/${encodeURIComponent(params.repoId)}/runs`,
+  query: external_exports.object({
+    publication: external_exports.string().optional(),
+    ref: external_exports.string().optional(),
+    commit: external_exports.string().optional()
+  }),
+  answers: {
+    200: external_exports.record(external_exports.string(), external_exports.unknown())
+  }
+};
+var getApiTerminalRepositoriesPreparation = {
+  path: (params) => `/api/v1/terminal/repositories/${encodeURIComponent(params.repoId)}/preparation`,
+  answers: {
+    200: external_exports.object({
+      id: external_exports.string(),
+      revision: external_exports.int(),
+      status: external_exports.enum(["queued", "running", "needs-choice", "ready", "blocked", "canceled"]),
+      message: external_exports.string(),
+      questions: external_exports.array(external_exports.object({
+        id: external_exports.string(),
+        text: external_exports.string(),
+        options: external_exports.array(external_exports.object({
+          value: external_exports.string(),
+          label: external_exports.string()
+        }))
+      })),
+      publication: external_exports.object({
+        status: external_exports.string(),
+        message: external_exports.string(),
+        url: external_exports.string().optional()
+      }).nullable().optional(),
+      canRetry: external_exports.boolean().optional(),
+      answerable: external_exports.boolean().optional()
+    }).nullable()
+  }
+};
+var postApiTerminalRepositoriesPreparation = {
+  path: (params) => `/api/v1/terminal/repositories/${encodeURIComponent(params.repoId)}/preparation`,
+  body: external_exports.record(external_exports.string(), external_exports.unknown()),
+  answers: {
+    200: external_exports.object({
+      id: external_exports.string(),
+      revision: external_exports.int(),
+      status: external_exports.enum(["queued", "running", "needs-choice", "ready", "blocked", "canceled"]),
+      message: external_exports.string(),
+      questions: external_exports.array(external_exports.object({
+        id: external_exports.string(),
+        text: external_exports.string(),
+        options: external_exports.array(external_exports.object({
+          value: external_exports.string(),
+          label: external_exports.string()
+        }))
+      })),
+      publication: external_exports.object({
+        status: external_exports.string(),
+        message: external_exports.string(),
+        url: external_exports.string().optional()
+      }).nullable().optional(),
+      canRetry: external_exports.boolean().optional(),
+      answerable: external_exports.boolean().optional()
+    })
+  }
+};
+var postApiTerminalApplications = {
+  path: () => "/api/v1/terminal/applications",
+  body: external_exports.object({
+    name: external_exports.string().min(1).max(80),
+    creationId: external_exports.string().regex(new RegExp("^[0-9a-hjkmnp-tv-z]{26}$")),
+    defaultBranch: external_exports.string().regex(new RegExp("^(?!.*\\.\\.)(?!\\/)(?!.*\\/$)[A-Za-z0-9._/-]{1,200}$")).nullable().optional()
+  }),
+  answers: {
+    200: external_exports.object({
+      application: external_exports.object({
+        appId: external_exports.string(),
+        name: external_exports.string()
+      }),
+      repository: external_exports.record(external_exports.string(), external_exports.unknown())
+    }),
+    201: external_exports.object({
+      application: external_exports.object({
+        appId: external_exports.string(),
+        name: external_exports.string()
+      }),
+      repository: external_exports.record(external_exports.string(), external_exports.unknown())
+    })
+  }
+};
+var postApiTerminalTools = {
+  path: (params) => `/api/v1/terminal/tools/${encodeURIComponent(params.tool)}`,
+  body: external_exports.record(external_exports.string(), external_exports.unknown()),
+  answers: {
+    200: external_exports.object({
+      isError: external_exports.boolean()
+    }).catchall(external_exports.unknown())
+  }
+};
+
+// ../client/src/clients/applications/request.ts
+var TerminalSession = class {
   constructor(credential) {
     this.credential = credential;
   }
@@ -21661,7 +21760,7 @@ var PortalSession = class {
   async ask(url2, body) {
     const { token, refresh } = this.credential;
     for (; ; ) {
-      const answer2 = await askPortal(this.credential.fetch ?? fetch, url2, await token(), body);
+      const answer2 = await askOnce(this.credential.fetch ?? fetch, url2, await token(), body);
       if (answer2.status === 401 && !this.#refreshed && refresh !== void 0) {
         this.#refreshed = true;
         if (await refresh()) {
@@ -21672,7 +21771,7 @@ var PortalSession = class {
     }
   }
 };
-async function askPortal(fetchImpl, url2, token, body) {
+async function askOnce(fetchImpl, url2, token, body) {
   try {
     const res = await fetchImpl(url2, {
       method: body === void 0 ? "GET" : "POST",
@@ -21682,7 +21781,7 @@ async function askPortal(fetchImpl, url2, token, body) {
     });
     const text = await res.text();
     try {
-      return { status: res.status, body: text ? JSON.parse(text) : null };
+      return { status: res.status, body: text ? JSON.parse(text) : void 0 };
     } catch {
       return { status: res.status, body: void 0 };
     }
@@ -21690,6 +21789,9 @@ async function askPortal(fetchImpl, url2, token, body) {
     return { status: 0, body: null };
   }
 }
+function terminalUrl(portal, path) {
+  return `${portal.replace(/\/+$/, "")}${path}`;
+}
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -21718,8 +21820,8 @@ function featureOffWords(feature) {
   return `This is not available for this organization${named}, and nobody in it can turn it on.`;
 }
 
-// ../client/src/clients/portal/portal-refusal.ts
-function portalRefusalCode(body) {
+// ../client/src/clients/applications/refusal.ts
+function refusalCode(body) {
   if (!isRecord(body)) {
     return null;
   }
@@ -21733,7 +21835,7 @@ function portalRefusalCode(body) {
   const { code, message } = error62;
   return typeof code === "string" && code !== "" && typeof message === "string" ? code : null;
 }
-function portalRefusalLimit(body) {
+function refusalLimit(body) {
   const error62 = isRecord(body) ? body["error"] : null;
   const details = isRecord(error62) ? error62["details"] : null;
   if (!isRecord(details)) {
@@ -21744,7 +21846,7 @@ function portalRefusalLimit(body) {
   return limit.permission === null && limit.reason === null && limit.contact === null ? null : limit;
 }
 
-// ../client/src/clients/portal/application.ts
+// ../client/src/clients/applications/application.ts
 var APPLICATION_CREATION = "application-creation";
 var ATTEMPTS = 3;
 var REFUSALS = {
@@ -21752,21 +21854,21 @@ var REFUSALS = {
   "repository-conflict": "REPOSITORY_CONFLICT"
 };
 async function createApplication(input2, opts) {
-  const url2 = `${input2.portal.replace(/\/+$/, "")}/api/v1/terminal/applications`;
+  const url2 = terminalUrl(input2.portal, postApiTerminalApplications.path());
   const body = { creationId: input2.creationId ?? newCreationId(), name: input2.name, defaultBranch: input2.defaultBranch ?? "main" };
-  const portal = new PortalSession(opts);
+  const session = new TerminalSession(opts);
   let lastOutage = "";
   for (let attempt = 0; attempt < ATTEMPTS; ) {
-    const answer2 = await portal.ask(url2, body);
+    const answer2 = await session.ask(url2, body);
     if (answer2.status === 200 || answer2.status === 201) {
       return read(answer2.body, answer2.status === 201);
     }
-    const code = portalRefusalCode(answer2.body) ?? "";
+    const code = refusalCode(answer2.body) ?? "";
     if (answer2.status === 401) {
       throw new PublisherError("UNAUTHORIZED", 'the portal did not accept this credential; run "publisher login" again');
     }
     if (answer2.status === 403) {
-      const limit = portalRefusalLimit(answer2.body);
+      const limit = refusalLimit(answer2.body);
       throw new PublisherError(
         "FORBIDDEN",
         answer2.say ?? `the portal refused to make an application here (${limit?.permission ?? (code || "forbidden")})`,
@@ -21788,12 +21890,12 @@ async function createApplication(input2, opts) {
   throw new PublisherError("UNAVAILABLE", `could not make the application: ${lastOutage}; run init again`, { retryable: true });
 }
 function read(body, created) {
-  const application = isRecord(body) ? body["application"] : void 0;
-  const repository = RepositoryInfo.safeParse(isRecord(body) ? body["repository"] : void 0);
-  if (!isRecord(application) || typeof application["appId"] !== "string" || !repository.success) {
+  const answer2 = postApiTerminalApplications.answers[created ? 201 : 200].safeParse(body);
+  const repository = RepositoryInfo.safeParse(answer2.data?.repository);
+  if (!answer2.success || !repository.success) {
     throw new PublisherError("UNAVAILABLE", "the portal answered with an application this version cannot read");
   }
-  return { appId: application["appId"], created, repository: repository.data };
+  return { appId: answer2.data.application.appId, created, repository: repository.data };
 }
 
 // ../client/src/clients/git-publisher/errors.ts
@@ -21995,7 +22097,7 @@ function sleep(ms, signal) {
   });
 }
 
-// ../client/src/clients/portal/run-progress.ts
+// ../client/src/clients/applications/run-progress.ts
 var RUN_STAGES = ["received", "running", "deploying", "live"];
 var STAGE_WORDS = { received: "received", running: "checked", deploying: "going live", live: "live" };
 var STATES = ["pending", "in-progress", "done", "failed", "skipped"];
@@ -22056,19 +22158,19 @@ function reasonOf(run2, end) {
 }
 var FOLLOW_TIMEOUT_MS = 15 * 6e4;
 async function followRun(input2, opts) {
-  const portal = new PortalSession(opts);
+  const session = new TerminalSession(opts);
   const sleep2 = opts.sleep ?? sleep;
   const now = opts.now ?? Date.now;
   const interval2 = opts.intervalMs ?? POLL_INTERVAL_MS;
   const deadline = now() + (opts.timeoutMs ?? FOLLOW_TIMEOUT_MS);
   const query = new URLSearchParams({ publication: input2.publicationId, ref: input2.ref, commit: input2.commit });
-  const url2 = `${input2.portal.replace(/\/+$/, "")}/api/v1/terminal/repositories/${encodeURIComponent(input2.repoId)}/runs?${query}`;
+  const url2 = terminalUrl(input2.portal, `${getApiTerminalRepositoriesRuns.path({ repoId: input2.repoId })}?${query}`);
   const seen = /* @__PURE__ */ new Map();
   let last = null;
   let lastError = null;
   let answered2 = false;
   for (; ; ) {
-    const answer2 = await portal.ask(url2, void 0);
+    const answer2 = await session.ask(url2, void 0);
     if (answer2.status === 401) {
       return { kind: "unauthorized" };
     }
@@ -22076,7 +22178,7 @@ async function followRun(input2, opts) {
       return { kind: "unavailable", reason: "no-route" };
     }
     if (answer2.status === 403) {
-      return { kind: "forbidden", say: answer2.say, limit: portalRefusalLimit(answer2.body) };
+      return { kind: "forbidden", say: answer2.say, limit: refusalLimit(answer2.body) };
     }
     if (answer2.status === 200) {
       const run2 = soleRun(answer2.body);
@@ -22133,41 +22235,11 @@ function soleRun(body) {
   }
   return { run: runs[0] ?? null };
 }
-function portalForEndpoint(endpoint) {
-  let url2;
-  try {
-    url2 = new URL(endpoint);
-  } catch {
-    return null;
-  }
-  if (url2.protocol !== "https:" || url2.pathname.replace(/\/+$/, "") !== "/publish") {
-    return null;
-  }
-  return url2.origin;
-}
 var RUN_PROGRESS = "run-progress";
-async function confirmPortal(portal, endpoint, fetchImpl = fetch) {
-  try {
-    const res = await fetchImpl(`${portal}/api/v1/config`, { signal: AbortSignal.timeout(1e4) });
-    if (!res.ok) {
-      return null;
-    }
-    const body = await res.json();
-    const named = body?.publishingEndpoint;
-    const bare = (u) => u.replace(/\/+$/, "");
-    if (typeof named !== "string" || bare(named) !== bare(endpoint)) {
-      return null;
-    }
-    const terminal = body?.terminal;
-    return { terminal: Array.isArray(terminal) && terminal.every((name) => typeof name === "string") ? terminal : [] };
-  } catch {
-    return null;
-  }
-}
 
-// ../client/src/clients/portal/preparation.ts
+// ../client/src/clients/applications/preparation.ts
 var PREPARATION = "preparation";
-var STATUSES = ["queued", "running", "needs-choice", "ready", "blocked", "canceled"];
+var View = getApiTerminalRepositoriesPreparation.answers[200].unwrap();
 var MAX_FINDINGS = 10;
 var MAX_TEXT = 500;
 function readPreparation(input2, opts) {
@@ -22180,73 +22252,50 @@ function retryPreparation(input2, opts) {
   return call(input2, opts, { id: input2.id, revision: input2.revision, action: "retry" });
 }
 async function call(input2, opts, body) {
-  const url2 = `${input2.portal.replace(/\/+$/, "")}/api/v1/terminal/repositories/${encodeURIComponent(input2.repoId)}/preparation`;
-  const answer2 = await new PortalSession(opts).ask(url2, body);
+  const url2 = terminalUrl(input2.portal, getApiTerminalRepositoriesPreparation.path({ repoId: input2.repoId }));
+  const answer2 = await new TerminalSession(opts).ask(url2, body);
   if (answer2.status === 401) {
     return { kind: "unauthorized" };
   }
   if (answer2.status === 403) {
-    return { kind: "forbidden", say: answer2.say, limit: portalRefusalLimit(answer2.body) };
+    return { kind: "forbidden", say: answer2.say, limit: refusalLimit(answer2.body) };
   }
   if (answer2.status === 409) {
     return { kind: "moved-on" };
   }
   if (answer2.status === 404) {
-    return portalRefusalCode(answer2.body) === "no-such-application" ? { kind: "no-application" } : { kind: "unavailable", detail: "the portal does not serve this address" };
+    return refusalCode(answer2.body) === "no-such-application" ? { kind: "no-application" } : { kind: "unavailable", detail: "the portal does not serve this address" };
   }
   if (answer2.status === 200) {
+    if (answer2.body === null && body === void 0) {
+      return { kind: "nothing-prepared" };
+    }
     const view = readView(answer2.body);
     return "detail" in view ? { kind: "malformed", detail: view.detail } : { kind: "view", view };
   }
   return { kind: "unavailable", detail: answer2.status === 0 ? "the portal could not be reached" : `the portal answered ${answer2.status}` };
 }
 function readView(body) {
-  if (!isRecord(body)) {
+  const read2 = View.safeParse(body);
+  if (!read2.success) {
     return { detail: "an answer that is not a preparation" };
   }
-  const { id, revision, status: status2, message, questions, publication } = body;
-  if (typeof id !== "string" || id === "") {
-    return { detail: "a preparation with no id" };
+  const { id, revision, status: status2, message, questions, publication, canRetry } = read2.data;
+  if (id === "" || revision < 1) {
+    return { detail: "a preparation with no id or revision" };
   }
-  if (typeof revision !== "number" || !Number.isSafeInteger(revision) || revision < 1) {
-    return { detail: "a preparation with no revision" };
-  }
-  if (!STATUSES.includes(status2)) {
-    return { detail: "a preparation with an unknown status" };
-  }
-  if (typeof message !== "string") {
-    return { detail: "a preparation with no message" };
-  }
-  if (!Array.isArray(questions)) {
-    return { detail: "a preparation with no list of questions" };
-  }
-  const read2 = [];
-  for (const q of questions) {
-    if (!isRecord(q) || typeof q["id"] !== "string" || typeof q["text"] !== "string" || !Array.isArray(q["options"]) || q["options"].length === 0) {
-      return { detail: "a question that cannot be answered" };
-    }
-    const options = [];
-    for (const o of q["options"]) {
-      if (!isRecord(o) || typeof o["value"] !== "string" || typeof o["label"] !== "string") {
-        return { detail: "a question with an unreadable option" };
-      }
-      options.push({ value: o["value"], label: o["label"] });
-    }
-    read2.push({ id: q["id"], text: q["text"], options });
-  }
-  let pub = null;
-  if (isRecord(publication) && typeof publication["status"] === "string" && typeof publication["message"] === "string") {
-    pub = { status: publication["status"], message: publication["message"], ...typeof publication["url"] === "string" ? { url: publication["url"] } : {} };
+  if (questions.some((question2) => question2.options.length === 0)) {
+    return { detail: "a question that cannot be answered" };
   }
   return {
     id,
     revision,
     status: status2,
     message,
-    questions: read2,
-    publication: pub,
-    findings: readFindings(body["findings"]),
-    canRetry: body["canRetry"] === true
+    questions,
+    publication: publication ?? null,
+    findings: readFindings(isRecord(body) ? body["findings"] : void 0),
+    canRetry: canRetry === true
   };
 }
 function readFindings(value) {
@@ -22282,16 +22331,17 @@ function readFindings(value) {
   return out;
 }
 
-// ../client/src/clients/portal/creator-tools.ts
+// ../client/src/clients/applications/creator-tools.ts
 var CREATOR_TOOLS = "creator-tools";
+var ToolAnswer = postApiTerminalTools.answers[200].partial().extend({ say: external_exports.string(), next: external_exports.string() });
 async function runCreatorTool(input2, opts) {
-  const url2 = `${input2.portal.replace(/\/+$/, "")}/api/v1/terminal/tools/${encodeURIComponent(input2.tool)}`;
-  const answer2 = await new PortalSession(opts).ask(url2, input2.args);
+  const url2 = terminalUrl(input2.portal, postApiTerminalTools.path({ tool: input2.tool }));
+  const answer2 = await new TerminalSession(opts).ask(url2, input2.args);
   if (answer2.status === 401) {
     return { kind: "unauthorized" };
   }
   if (answer2.status === 403) {
-    return { kind: "forbidden", say: answer2.say, limit: portalRefusalLimit(answer2.body) };
+    return { kind: "forbidden", say: answer2.say, limit: refusalLimit(answer2.body) };
   }
   if (answer2.status === 404) {
     return { kind: "unavailable", detail: "the portal does not serve this tool" };
@@ -22299,11 +22349,11 @@ async function runCreatorTool(input2, opts) {
   if (answer2.status !== 200) {
     return { kind: "unavailable", detail: answer2.status === 0 ? "the portal could not be reached" : `the portal answered ${answer2.status}` };
   }
-  const body = answer2.body;
-  if (!isRecord(body) || typeof body["say"] !== "string" || typeof body["next"] !== "string") {
+  const read2 = ToolAnswer.safeParse(answer2.body);
+  if (!read2.success) {
     return { kind: "malformed", detail: "an answer with no say and next" };
   }
-  const { say, next, isError, ...fields } = body;
+  const { say, next, isError, ...fields } = read2.data;
   const told = isError === true && fields["code"] === "feature-unavailable" ? featureOffWords(fields["feature"]) : say;
   return { kind: "answer", answer: { say: told, next, isError: isError === true, fields } };
 }
@@ -23568,6 +23618,38 @@ async function removePendingLogin() {
   await (0, import_promises9.rm)(pendingLoginPath(), { force: true });
 }
 
+// ../client/src/clients/portal/config.ts
+function portalForEndpoint(endpoint) {
+  let url2;
+  try {
+    url2 = new URL(endpoint);
+  } catch {
+    return null;
+  }
+  if (url2.protocol !== "https:" || url2.pathname.replace(/\/+$/, "") !== "/publish") {
+    return null;
+  }
+  return url2.origin;
+}
+async function confirmPortal(portal, endpoint, fetchImpl = fetch) {
+  try {
+    const res = await fetchImpl(`${portal}/api/v1/config`, { signal: AbortSignal.timeout(1e4) });
+    if (!res.ok) {
+      return null;
+    }
+    const body = await res.json();
+    const named = body?.publishingEndpoint;
+    const bare = (u) => u.replace(/\/+$/, "");
+    if (typeof named !== "string" || bare(named) !== bare(endpoint)) {
+      return null;
+    }
+    const terminal = body?.terminal;
+    return { terminal: Array.isArray(terminal) && terminal.every((name) => typeof name === "string") ? terminal : [] };
+  } catch {
+    return null;
+  }
+}
+
 // src/args.ts
 var import_node_util = require("node:util");
 var OPTIONS = {
@@ -24609,6 +24691,7 @@ function folderFor(name) {
 }
 
 // src/commands/question.ts
+var NOTHING_PREPARED = "nothing is being prepared for this app";
 async function questionAt(p, endpoint, repoId, opts = {}) {
   const at = await portalAt(endpoint, opts);
   if ("reason" in at) {
@@ -24623,6 +24706,9 @@ async function answerAt(p, endpoint, repoId, specs, opts = {}) {
     return at;
   }
   const read2 = shown(at.portal, await p.readPreparation({ portal: at.portal, repoId }), REFUSED2.read);
+  if (read2.kind === "nothing-prepared") {
+    throw new PublisherError("LOCAL_STATE", `nothing is waiting for an answer (${NOTHING_PREPARED})`);
+  }
   if (read2.kind !== "view") {
     return read2;
   }
@@ -24645,6 +24731,9 @@ async function answerAt(p, endpoint, repoId, specs, opts = {}) {
 }
 async function retryAt(p, endpoint, repoId, opts = {}) {
   const read2 = await questionAt(p, endpoint, repoId, opts);
+  if (read2.kind === "nothing-prepared") {
+    throw new PublisherError("LOCAL_STATE", `nothing to try again (${NOTHING_PREPARED})`);
+  }
   if (read2.kind !== "view") {
     return read2;
   }
@@ -24698,6 +24787,8 @@ function shown(portal, r, refused) {
       const { questions, ...preparation } = r.view;
       return { kind: "view", portal, preparation, questions, hint: hintFor(r.view) };
     }
+    case "nothing-prepared":
+      return { kind: "nothing-prepared", portal, hint: "Nothing is being prepared for this app, so nothing is waiting for an answer." };
     case "no-application":
       throw new PublisherError("NOT_FOUND", "this repository has no application in your organization yet; publish it first");
     case "moved-on":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minnovate/shadow-publisher",
-  "version": "0.18.2",
+  "version": "0.18.4",
   "description": "publisher: publish an app's Git history to the serverless Git backend",
   "license": "Apache-2.0",
   "type": "module",