@mattstack/rt-client 0.23.0 → 0.24.0

package/dist/commands.d.ts

@@ -123,8 +123,10 @@ export interface GateQuestion {
     multi: boolean;
     options: GateOption[];
 }
-export declare function gateOptionValue(o: GateOption): string;
-export declare function gateOptionLabel(o: GateOption): string;
+/** Implementations live in gate-options.ts (the browser-safe ./gate
+    subpath); re-exported here so existing commands.ts/index.ts consumers
+    are unaffected. */
+export { gateOptionValue, gateOptionLabel } from "./gate-options.ts";
 /** `session` is the answering surface's own session id, recorded so the
     push facility can tell a self-answer from a remote one and skip the
     doorbell it would otherwise send back to the writer. Optional: a caller

package/dist/gate-options.d.ts

@@ -6,6 +6,8 @@ export interface GateOptionObject {
     value: string;
     label: string;
 }
+export declare function gateOptionValue(o: GateOption): string;
+export declare function gateOptionLabel(o: GateOption): string;
 /** Bare string s becomes {value: s, label: s}; a well-formed {value,label}
     object passes through untouched. Total over whatever actually arrives
     on the wire, not just the declared GateOption union: a partial object

package/dist/gate.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Browser-safe entry point (the "./gate" subpath export): the pure gate
+ * helpers only, so a browser bundle (mattstack-apps gate-kit) never drags in
+ * commands.ts's Node-only neighbors the way importing from "." would.
+ */
+export * from "./gate-answers.ts";
+export * from "./gate-options.ts";
+export * from "./gate-presentation.ts";
+export type { GateOption, GateQuestion, GateAnswer } from "./commands.ts";

package/dist/gate.js

@@ -0,0 +1,103 @@
+// src/gate-options.ts
+function gateOptionValue(o) {
+  return typeof o === "string" ? o : o.value;
+}
+function gateOptionLabel(o) {
+  return typeof o === "string" ? o : o.label || o.value;
+}
+var RECOMMENDED_SUFFIX = " (Recommended)";
+var HAS_RECOMMENDED_SUFFIX = /\(\s*recommended\s*\)\s*$/i;
+function isWordLikeLabel(label) {
+  return /^[a-z][^A-Z0-9/:\\@]*$/.test(label);
+}
+function capitalize(label) {
+  return isWordLikeLabel(label) ? label[0].toUpperCase() + label.slice(1) : label;
+}
+function normalizeGateOptions(options) {
+  return options.map((o) => {
+    const recommended = o !== null && typeof o === "object" && o.recommended === true;
+    let value;
+    let label;
+    if (typeof o === "string") {
+      value = o;
+      label = o;
+    } else if (o !== null && typeof o === "object") {
+      const v = typeof o.value === "string" ? o.value : undefined;
+      const l = typeof o.label === "string" ? o.label : undefined;
+      value = v ?? l ?? String(o);
+      label = l ?? v ?? String(o);
+    } else {
+      value = String(o);
+      label = String(o);
+    }
+    label = capitalize(label);
+    if (recommended && label && !HAS_RECOMMENDED_SUFFIX.test(label))
+      label += RECOMMENDED_SUFFIX;
+    return { value, label };
+  });
+}
+function normalizeGateQuestions(questions) {
+  return questions.map((q) => ({ ...q, options: normalizeGateOptions(q.options) }));
+}
+
+// src/gate-answers.ts
+function unwrapGateAnswerValue(raw) {
+  if (raw && typeof raw === "object" && !Array.isArray(raw) && "value" in raw) {
+    return raw.value;
+  }
+  return raw;
+}
+function wrapperNoteIsValid(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw) || !("value" in raw)) {
+    return true;
+  }
+  const note = raw.note;
+  return note === undefined || typeof note === "string";
+}
+function validateGateAnswers(questions, answers) {
+  const byId = new Map(questions.map((q) => [q.id, q]));
+  for (const [qid, raw] of Object.entries(answers)) {
+    const question = byId.get(qid);
+    if (!question)
+      return `unknown question id: ${qid}`;
+    if (!wrapperNoteIsValid(raw))
+      return `question ${qid} note must be a string`;
+    const value = unwrapGateAnswerValue(raw);
+    const isArray = Array.isArray(value);
+    if (question.multi && !isArray)
+      return `question ${qid} expects an array (multi)`;
+    if (!question.multi && isArray)
+      return `question ${qid} expects a single value`;
+    const values = isArray ? value : [value];
+    if (!values.every((v) => typeof v === "string"))
+      return `question ${qid} value must be a string`;
+    if (question.options.length > 0) {
+      const members = question.options.map(gateOptionValue);
+      for (const v of values) {
+        if (!members.includes(v))
+          return `answer for "${qid}" is not one of its options: "${v}"`;
+      }
+    }
+  }
+  const missing = questions.map((q) => q.id).filter((id) => !Object.prototype.hasOwnProperty.call(answers, id));
+  if (missing.length > 0)
+    return `missing answer(s) for: ${missing.join(", ")}`;
+  return null;
+}
+// src/gate-presentation.ts
+var GATE_FORM_OPTION_CAP = 4;
+function gatePresentation(args) {
+  if (!args.paneId || !args.sessionId)
+    return "wait";
+  return args.questions.every((q) => q.options.length <= GATE_FORM_OPTION_CAP) ? "form" : "wait";
+}
+export {
+  validateGateAnswers,
+  unwrapGateAnswerValue,
+  normalizeGateQuestions,
+  normalizeGateOptions,
+  gatePresentation,
+  gateOptionValue,
+  gateOptionLabel,
+  GATE_FORM_OPTION_CAP
+};

package/dist/index.js

@@ -418,14 +418,50 @@ function bgStop(o = {}) {
 function bgRelease(a, o = {}) {
   return rtCommand("bg:release", { claim: a.claim }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
 }
-// src/commands.ts
-var GATE_BY_PANE = "pane";
+// src/gate-options.ts
 function gateOptionValue(o) {
   return typeof o === "string" ? o : o.value;
 }
 function gateOptionLabel(o) {
   return typeof o === "string" ? o : o.label || o.value;
 }
+var RECOMMENDED_SUFFIX = " (Recommended)";
+var HAS_RECOMMENDED_SUFFIX = /\(\s*recommended\s*\)\s*$/i;
+function isWordLikeLabel(label) {
+  return /^[a-z][^A-Z0-9/:\\@]*$/.test(label);
+}
+function capitalize(label) {
+  return isWordLikeLabel(label) ? label[0].toUpperCase() + label.slice(1) : label;
+}
+function normalizeGateOptions(options) {
+  return options.map((o) => {
+    const recommended = o !== null && typeof o === "object" && o.recommended === true;
+    let value;
+    let label;
+    if (typeof o === "string") {
+      value = o;
+      label = o;
+    } else if (o !== null && typeof o === "object") {
+      const v = typeof o.value === "string" ? o.value : undefined;
+      const l = typeof o.label === "string" ? o.label : undefined;
+      value = v ?? l ?? String(o);
+      label = l ?? v ?? String(o);
+    } else {
+      value = String(o);
+      label = String(o);
+    }
+    label = capitalize(label);
+    if (recommended && label && !HAS_RECOMMENDED_SUFFIX.test(label))
+      label += RECOMMENDED_SUFFIX;
+    return { value, label };
+  });
+}
+function normalizeGateQuestions(questions) {
+  return questions.map((q) => ({ ...q, options: normalizeGateOptions(q.options) }));
+}
+
+// src/commands.ts
+var GATE_BY_PANE = "pane";
 var COMMAND_NAMES = [
   "project-mrs:read",
   "discussions:read",
@@ -547,41 +583,6 @@ function gatePresentation(args) {
     return "wait";
   return args.questions.every((q) => q.options.length <= GATE_FORM_OPTION_CAP) ? "form" : "wait";
 }
-// src/gate-options.ts
-var RECOMMENDED_SUFFIX = " (Recommended)";
-var HAS_RECOMMENDED_SUFFIX = /\(\s*recommended\s*\)\s*$/i;
-function isWordLikeLabel(label) {
-  return /^[a-z][^A-Z0-9/:\\@]*$/.test(label);
-}
-function capitalize(label) {
-  return isWordLikeLabel(label) ? label[0].toUpperCase() + label.slice(1) : label;
-}
-function normalizeGateOptions(options) {
-  return options.map((o) => {
-    const recommended = o !== null && typeof o === "object" && o.recommended === true;
-    let value;
-    let label;
-    if (typeof o === "string") {
-      value = o;
-      label = o;
-    } else if (o !== null && typeof o === "object") {
-      const v = typeof o.value === "string" ? o.value : undefined;
-      const l = typeof o.label === "string" ? o.label : undefined;
-      value = v ?? l ?? String(o);
-      label = l ?? v ?? String(o);
-    } else {
-      value = String(o);
-      label = String(o);
-    }
-    label = capitalize(label);
-    if (recommended && label && !HAS_RECOMMENDED_SUFFIX.test(label))
-      label += RECOMMENDED_SUFFIX;
-    return { value, label };
-  });
-}
-function normalizeGateQuestions(questions) {
-  return questions.map((q) => ({ ...q, options: normalizeGateOptions(q.options) }));
-}
 // src/gate-answers.ts
 function unwrapGateAnswerValue(raw) {
   if (raw && typeof raw === "object" && !Array.isArray(raw) && "value" in raw) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mattstack/rt-client",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "type": "module",
   "exports": {
     ".": {
@@ -15,6 +15,12 @@
       "import": "./dist/settings/identity-codec.js",
       "default": "./dist/settings/identity-codec.js"
     },
+    "./gate": {
+      "types": "./dist/gate.d.ts",
+      "bun": "./src/gate.ts",
+      "import": "./dist/gate.js",
+      "default": "./dist/gate.js"
+    },
     "./test/fake-daemon.ts": "./test/fake-daemon.ts"
   },
   "peerDependencies": {
@@ -45,7 +51,7 @@
     "bun": ">=1.0.0"
   },
   "scripts": {
-    "build": "bun build src/index.ts --outdir dist --target node --format esm --packages external && bun build src/settings/identity-codec.ts --outfile dist/settings/identity-codec.js --target browser --format esm && tsc -p tsconfig.json",
+    "build": "bun build src/index.ts --outdir dist --target node --format esm --packages external && bun build src/settings/identity-codec.ts --outfile dist/settings/identity-codec.js --target browser --format esm && bun build src/gate.ts --outfile dist/gate.js --target browser --format esm && tsc -p tsconfig.json",
     "check-types": "tsc --noEmit -p tsconfig.json",
     "prepack": "bun run build"
   },

package/src/commands.ts

@@ -107,12 +107,10 @@ export interface GateOrigin {
   presentation?: "form" | "wait";
 }
 export interface GateQuestion { id: string; label: string; multi: boolean; options: GateOption[] }
-export function gateOptionValue(o: GateOption): string {
-  return typeof o === "string" ? o : o.value;
-}
-export function gateOptionLabel(o: GateOption): string {
-  return typeof o === "string" ? o : (o.label || o.value);
-}
+/** Implementations live in gate-options.ts (the browser-safe ./gate
+    subpath); re-exported here so existing commands.ts/index.ts consumers
+    are unaffected. */
+export { gateOptionValue, gateOptionLabel } from "./gate-options.ts";
 /** `session` is the answering surface's own session id, recorded so the
     push facility can tell a self-answer from a remote one and skip the
     doorbell it would otherwise send back to the writer. Optional: a caller

package/src/gate-answers.ts

@@ -1,5 +1,5 @@
 import type { GateQuestion, GateAnswer } from "./commands.ts";
-import { gateOptionValue } from "./commands.ts";
+import { gateOptionValue } from "./gate-options.ts";
 
 export type GateAnswerWire = GateAnswer["answers"][string];
 

package/src/gate-options.ts

@@ -8,6 +8,13 @@ export interface GateOptionObject {
   label: string;
 }
 
+export function gateOptionValue(o: GateOption): string {
+  return typeof o === "string" ? o : o.value;
+}
+export function gateOptionLabel(o: GateOption): string {
+  return typeof o === "string" ? o : (o.label || o.value);
+}
+
 /** Suffix gate-kit's stripRecommended (mattstack-apps repo,
     packages/gate-kit/src/options.ts) parses off a label to render its own
     "recommended" badge. This is the

package/src/gate.ts

@@ -0,0 +1,9 @@
+/**
+ * Browser-safe entry point (the "./gate" subpath export): the pure gate
+ * helpers only, so a browser bundle (mattstack-apps gate-kit) never drags in
+ * commands.ts's Node-only neighbors the way importing from "." would.
+ */
+export * from "./gate-answers.ts";
+export * from "./gate-options.ts";
+export * from "./gate-presentation.ts";
+export type { GateOption, GateQuestion, GateAnswer } from "./commands.ts";