@vinaverse/client 0.0.0-stage → 0.1.0-alpha.10

package/dist/conversation/index.d.cts

@@ -0,0 +1,65 @@
+export { C as CONTRACT } from '../contract-DmQs8amJ.cjs';
+import { Q as Question, A as AnswerInput } from '../session-CPz4pcPu.cjs';
+export { a as Card, b as CardGroup, c as CardImage, d as CardKind, C as CardLink, e as ClientErrorCode, H as HeldCard, f as HeldQuestion, P as Proposal, g as ProposalOutcome, T as ToolLine, V as VinaverseClientError, W as Welcome, i as isKnownCard } from '../session-CPz4pcPu.cjs';
+import { C as ConversationStore, a as ConversationOptions, S as SessionRequest, b as ConversationSession } from '../store-BxiicOKG.cjs';
+export { c as CardItem, d as ConversationActivity, e as ConversationBanner, f as ConversationPersistence, g as ConversationStatus, h as ConversationView, F as FrameScheduler, M as MAX_TEXT, i as MessageItem, j as MessageState, k as SessionReason, l as StreamingText, m as SystemEvent, n as SystemItem, T as TimelineItem, o as createConversation } from '../store-BxiicOKG.cjs';
+
+type AnswerProblem = 
+/** Nothing chosen or typed, and the question is required (or skipped while required). */
+'required'
+/** Fewer choices than `min`. */
+ | 'too_few'
+/** More choices than `max`, or more than one where one is asked. */
+ | 'too_many'
+/** A value that is not on the card, `none_of_the_above` with another choice, or a form the kind does not take. */
+ | 'not_allowed'
+/** The text, or the "Other" text, is longer than the card allows (in code points). */
+ | 'too_long'
+/** A number outside `min`…`max`, or off its `step`. */
+ | 'out_of_range'
+/** Not a calendar date, or outside the card's bounds. */
+ | 'bad_date';
+/** Unicode code points, as the contract counts every text limit (an emoji outside the BMP is one). */
+declare function codePoints(text: string): number;
+/**
+ * The first rule an answer breaks, or null when it can be sent. For `rate_each`, check each row's answer against
+ * the question: one column from `options`, or `skipped` when not required. A kind this client does not know is the
+ * server's to judge (null).
+ */
+declare function answerProblem(question: Question, input: AnswerInput): AnswerProblem | null;
+
+/** Whether a prefix may be registered: the contract's prefix pattern, no refused scheme, no control character. */
+declare function isValidLinkPrefix(prefix: string): boolean;
+/**
+ * Whether a card's link may be opened: it starts with one of the registered prefixes (invalid ones are ignored) and
+ * what follows is a path and an optional query of the allowed characters. Route by the page it names; never open a
+ * query value.
+ */
+declare function isAllowedLink(link: string, prefixes: readonly string[]): boolean;
+
+/** A session request, with the mode it is for. */
+interface ModeSessionRequest extends SessionRequest {
+    readonly mode: string;
+}
+interface ConversationsByModeOptions extends Omit<ConversationOptions, 'getSession'> {
+    /** Your backend creates the session for the mode's agent (its `subject.type`, its agent), with its service key. */
+    readonly getSession: (request: ModeSessionRequest) => Promise<ConversationSession>;
+    /** Every mode the app has, so `clear()` forgets each one's kept history, even one not opened since launch. */
+    readonly modes?: readonly string[];
+}
+interface ConversationsByMode {
+    /** The mode's store, made the first time it is asked for; the same store after that. */
+    get(mode: string): ConversationStore;
+    /**
+     * The mode the person switched to: its store, with every other mode's sent to the background (no pings; closed
+     * with `closeInBackground`). The kit then drives the selected one with the app's foreground and background.
+     */
+    select(mode: string): ConversationStore;
+    /** Close every mode's store. */
+    dispose(): void;
+    /** Close every mode's store and forget what each kept on the device (sign-out). */
+    clear(): void;
+}
+declare function createConversationsByMode(options: ConversationsByModeOptions): ConversationsByMode;
+
+export { AnswerInput, type AnswerProblem, ConversationOptions, ConversationSession, ConversationStore, type ConversationsByMode, type ConversationsByModeOptions, type ModeSessionRequest, Question, SessionRequest, answerProblem, codePoints, createConversationsByMode, isAllowedLink, isValidLinkPrefix };

package/dist/conversation/index.d.ts

@@ -0,0 +1,65 @@
+export { C as CONTRACT } from '../contract-DmQs8amJ.js';
+import { Q as Question, A as AnswerInput } from '../session-CPz4pcPu.js';
+export { a as Card, b as CardGroup, c as CardImage, d as CardKind, C as CardLink, e as ClientErrorCode, H as HeldCard, f as HeldQuestion, P as Proposal, g as ProposalOutcome, T as ToolLine, V as VinaverseClientError, W as Welcome, i as isKnownCard } from '../session-CPz4pcPu.js';
+import { C as ConversationStore, a as ConversationOptions, S as SessionRequest, b as ConversationSession } from '../store-DZka9T2-.js';
+export { c as CardItem, d as ConversationActivity, e as ConversationBanner, f as ConversationPersistence, g as ConversationStatus, h as ConversationView, F as FrameScheduler, M as MAX_TEXT, i as MessageItem, j as MessageState, k as SessionReason, l as StreamingText, m as SystemEvent, n as SystemItem, T as TimelineItem, o as createConversation } from '../store-DZka9T2-.js';
+
+type AnswerProblem = 
+/** Nothing chosen or typed, and the question is required (or skipped while required). */
+'required'
+/** Fewer choices than `min`. */
+ | 'too_few'
+/** More choices than `max`, or more than one where one is asked. */
+ | 'too_many'
+/** A value that is not on the card, `none_of_the_above` with another choice, or a form the kind does not take. */
+ | 'not_allowed'
+/** The text, or the "Other" text, is longer than the card allows (in code points). */
+ | 'too_long'
+/** A number outside `min`…`max`, or off its `step`. */
+ | 'out_of_range'
+/** Not a calendar date, or outside the card's bounds. */
+ | 'bad_date';
+/** Unicode code points, as the contract counts every text limit (an emoji outside the BMP is one). */
+declare function codePoints(text: string): number;
+/**
+ * The first rule an answer breaks, or null when it can be sent. For `rate_each`, check each row's answer against
+ * the question: one column from `options`, or `skipped` when not required. A kind this client does not know is the
+ * server's to judge (null).
+ */
+declare function answerProblem(question: Question, input: AnswerInput): AnswerProblem | null;
+
+/** Whether a prefix may be registered: the contract's prefix pattern, no refused scheme, no control character. */
+declare function isValidLinkPrefix(prefix: string): boolean;
+/**
+ * Whether a card's link may be opened: it starts with one of the registered prefixes (invalid ones are ignored) and
+ * what follows is a path and an optional query of the allowed characters. Route by the page it names; never open a
+ * query value.
+ */
+declare function isAllowedLink(link: string, prefixes: readonly string[]): boolean;
+
+/** A session request, with the mode it is for. */
+interface ModeSessionRequest extends SessionRequest {
+    readonly mode: string;
+}
+interface ConversationsByModeOptions extends Omit<ConversationOptions, 'getSession'> {
+    /** Your backend creates the session for the mode's agent (its `subject.type`, its agent), with its service key. */
+    readonly getSession: (request: ModeSessionRequest) => Promise<ConversationSession>;
+    /** Every mode the app has, so `clear()` forgets each one's kept history, even one not opened since launch. */
+    readonly modes?: readonly string[];
+}
+interface ConversationsByMode {
+    /** The mode's store, made the first time it is asked for; the same store after that. */
+    get(mode: string): ConversationStore;
+    /**
+     * The mode the person switched to: its store, with every other mode's sent to the background (no pings; closed
+     * with `closeInBackground`). The kit then drives the selected one with the app's foreground and background.
+     */
+    select(mode: string): ConversationStore;
+    /** Close every mode's store. */
+    dispose(): void;
+    /** Close every mode's store and forget what each kept on the device (sign-out). */
+    clear(): void;
+}
+declare function createConversationsByMode(options: ConversationsByModeOptions): ConversationsByMode;
+
+export { AnswerInput, type AnswerProblem, ConversationOptions, ConversationSession, ConversationStore, type ConversationsByMode, type ConversationsByModeOptions, type ModeSessionRequest, Question, SessionRequest, answerProblem, codePoints, createConversationsByMode, isAllowedLink, isValidLinkPrefix };

package/dist/conversation/index.js

@@ -0,0 +1,134 @@
+export { CONTRACT } from '../chunk-YNUHXJD6.js';
+import { createConversation } from '../chunk-46D3FSLU.js';
+export { ConversationStore, MAX_TEXT, createConversation, isAllowedLink, isValidLinkPrefix } from '../chunk-46D3FSLU.js';
+export { VinaverseClientError, isKnownCard } from '../chunk-GWLLUOFY.js';
+
+// src/conversation/answers.ts
+var CHOICE = /* @__PURE__ */ new Set([
+  "single_choice",
+  "multi_choice",
+  "image_choice",
+  "yes_no",
+  "list_choice"
+]);
+var ONE_CHOICE = /* @__PURE__ */ new Set(["single_choice", "yes_no", "list_choice"]);
+function codePoints(text) {
+  let n = 0;
+  for (const _ of text) n++;
+  return n;
+}
+function answerProblem(question, input) {
+  const answer = input;
+  if (answer.skipped === true) return question.required ? "required" : null;
+  const kind = question.kind;
+  if (CHOICE.has(kind)) return choiceProblem(question, answer);
+  switch (kind) {
+    case "rate_each": {
+      const values = answer.values ?? [];
+      if (answer.other_text !== void 0) return "not_allowed";
+      if (values.length === 0) return "required";
+      if (values.length > 1) return "too_many";
+      return (question.options ?? []).some((o) => o.value === values[0]) ? null : "not_allowed";
+    }
+    case "short_text":
+    case "long_text": {
+      const text = answer.text ?? "";
+      if (!text.trim()) return "required";
+      return codePoints(text) > (question.text?.max_length ?? 2e3) ? "too_long" : null;
+    }
+    case "number":
+    case "scale": {
+      const n = answer.number;
+      if (typeof n !== "number" || !Number.isFinite(n)) return "required";
+      const range = kind === "number" ? question.number : question.scale;
+      if (!range) return null;
+      if (n < range.min || n > range.max) return "out_of_range";
+      const steps = (n - range.min) / range.step;
+      return Math.abs(steps - Math.round(steps)) > 1e-9 ? "out_of_range" : null;
+    }
+    case "date":
+      return dateProblem(question, answer.date);
+    case "photo":
+      return answer.upload_ref ? null : "required";
+    default:
+      return null;
+  }
+}
+function choiceProblem(question, answer) {
+  const values = answer.values ?? [];
+  const other = answer.other_text;
+  if (other !== void 0) {
+    if (!question.allows_other) return "not_allowed";
+    if (!other.trim()) return "required";
+    if (codePoints(other) > (question.other_max_length ?? 500))
+      return "too_long";
+    if (values.length > 0 && question.kind !== "single_choice" && question.kind !== "multi_choice")
+      return "not_allowed";
+  }
+  if (values.length === 0) return other !== void 0 ? null : "required";
+  if (new Set(values).size !== values.length) return "not_allowed";
+  const none = question.none_of_the_above?.value;
+  if (none !== void 0 && values.includes(none))
+    return values.length === 1 && other === void 0 ? null : "not_allowed";
+  const known = new Set((question.options ?? []).map((o) => o.value));
+  if (!values.every((v) => known.has(v))) return "not_allowed";
+  if (ONE_CHOICE.has(question.kind) && values.length > 1) return "too_many";
+  const chosen = values.length + (other !== void 0 ? 1 : 0);
+  if (question.min !== void 0 && chosen < question.min) return "too_few";
+  if (question.max !== void 0 && chosen > question.max) return "too_many";
+  return null;
+}
+function dateProblem(question, date) {
+  if (!date) return "required";
+  const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(date);
+  if (!m) return "bad_date";
+  const [y, mo, d] = [Number(m[1]), Number(m[2]), Number(m[3])];
+  const at = new Date(Date.UTC(y, mo - 1, d));
+  if (at.getUTCFullYear() !== y || at.getUTCMonth() !== mo - 1 || at.getUTCDate() !== d)
+    return "bad_date";
+  if (question.date?.min !== void 0 && date < question.date.min)
+    return "bad_date";
+  if (question.date?.max !== void 0 && date > question.date.max)
+    return "bad_date";
+  return null;
+}
+
+// src/conversation/modes.ts
+function createConversationsByMode(options) {
+  const { getSession, modes = [], ...shared } = options;
+  const base = shared.persistenceKey ?? "vinaverse.conversation";
+  const stores = /* @__PURE__ */ new Map();
+  const get = (mode) => {
+    let store = stores.get(mode);
+    if (!store) {
+      store = createConversation({
+        ...shared,
+        persistenceKey: `${base}.${mode}`,
+        getSession: (request) => getSession({ ...request, mode })
+      });
+      stores.set(mode, store);
+    }
+    return store;
+  };
+  return {
+    get,
+    select(mode) {
+      for (const [other, store] of stores)
+        if (other !== mode) store.setForeground(false);
+      return get(mode);
+    },
+    dispose() {
+      for (const store of stores.values()) store.dispose();
+      stores.clear();
+    },
+    clear() {
+      for (const mode of /* @__PURE__ */ new Set([...stores.keys(), ...modes]))
+        get(mode).clear();
+      stores.clear();
+    }
+  };
+}
+
+export { answerProblem, codePoints, createConversationsByMode };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/conversation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/conversation/answers.ts","../../src/conversation/modes.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// Whether an answer to a question card can be sent: the card's own rules (`Question`, `QuestionAnswer`), checked as\n// the person answers so a UI enables Send only for an answer the server will take. The server still decides: what it\n// rejects arrives as `ui.answer.rejected` and unlocks the question. Shared by every UI kit.\nimport type { AnswerInput, Question } from '../events.js';\n\nexport type AnswerProblem =\n  /** Nothing chosen or typed, and the question is required (or skipped while required). */\n  | 'required'\n  /** Fewer choices than `min`. */\n  | 'too_few'\n  /** More choices than `max`, or more than one where one is asked. */\n  | 'too_many'\n  /** A value that is not on the card, `none_of_the_above` with another choice, or a form the kind does not take. */\n  | 'not_allowed'\n  /** The text, or the \"Other\" text, is longer than the card allows (in code points). */\n  | 'too_long'\n  /** A number outside `min`…`max`, or off its `step`. */\n  | 'out_of_range'\n  /** Not a calendar date, or outside the card's bounds. */\n  | 'bad_date';\n\nconst CHOICE = new Set([\n  'single_choice',\n  'multi_choice',\n  'image_choice',\n  'yes_no',\n  'list_choice',\n]);\nconst ONE_CHOICE = new Set(['single_choice', 'yes_no', 'list_choice']);\n\n/** Unicode code points, as the contract counts every text limit (an emoji outside the BMP is one). */\nexport function codePoints(text: string): number {\n  let n = 0;\n  for (const _ of text) n++;\n  return n;\n}\n\ntype Answer = {\n  values?: readonly string[];\n  other_text?: string;\n  text?: string;\n  number?: number;\n  date?: string;\n  upload_ref?: string;\n  skipped?: boolean;\n};\n\n/**\n * The first rule an answer breaks, or null when it can be sent. For `rate_each`, check each row's answer against\n * the question: one column from `options`, or `skipped` when not required. A kind this client does not know is the\n * server's to judge (null).\n */\nexport function answerProblem(\n  question: Question,\n  input: AnswerInput,\n): AnswerProblem | null {\n  const answer = input as Answer;\n  if (answer.skipped === true) return question.required ? 'required' : null;\n  const kind = question.kind as string;\n  if (CHOICE.has(kind)) return choiceProblem(question, answer);\n  switch (kind) {\n    case 'rate_each': {\n      const values = answer.values ?? [];\n      if (answer.other_text !== undefined) return 'not_allowed';\n      if (values.length === 0) return 'required';\n      if (values.length > 1) return 'too_many';\n      return (question.options ?? []).some((o) => o.value === values[0])\n        ? null\n        : 'not_allowed';\n    }\n    case 'short_text':\n    case 'long_text': {\n      const text = answer.text ?? '';\n      if (!text.trim()) return 'required';\n      return codePoints(text) > (question.text?.max_length ?? 2000)\n        ? 'too_long'\n        : null;\n    }\n    case 'number':\n    case 'scale': {\n      const n = answer.number;\n      if (typeof n !== 'number' || !Number.isFinite(n)) return 'required';\n      const range = kind === 'number' ? question.number : question.scale;\n      if (!range) return null;\n      if (n < range.min || n > range.max) return 'out_of_range';\n      const steps = (n - range.min) / range.step;\n      return Math.abs(steps - Math.round(steps)) > 1e-9 ? 'out_of_range' : null;\n    }\n    case 'date':\n      return dateProblem(question, answer.date);\n    case 'photo':\n      return answer.upload_ref ? null : 'required';\n    default:\n      return null;\n  }\n}\n\nfunction choiceProblem(\n  question: Question,\n  answer: Answer,\n): AnswerProblem | null {\n  const values = answer.values ?? [];\n  const other = answer.other_text;\n  if (other !== undefined) {\n    if (!question.allows_other) return 'not_allowed';\n    if (!other.trim()) return 'required';\n    if (codePoints(other) > (question.other_max_length ?? 500))\n      return 'too_long';\n    if (\n      values.length > 0 &&\n      question.kind !== 'single_choice' &&\n      question.kind !== 'multi_choice'\n    )\n      return 'not_allowed';\n  }\n  if (values.length === 0) return other !== undefined ? null : 'required';\n  if (new Set(values).size !== values.length) return 'not_allowed';\n  const none = question.none_of_the_above?.value;\n  if (none !== undefined && values.includes(none))\n    return values.length === 1 && other === undefined ? null : 'not_allowed';\n  const known = new Set((question.options ?? []).map((o) => o.value));\n  if (!values.every((v) => known.has(v))) return 'not_allowed';\n  // One option for the single kinds (a single_choice may add its \"Other\" too, as the contract allows); the \"Other\"\n  // counts as a choice against min and max.\n  if (ONE_CHOICE.has(question.kind) && values.length > 1) return 'too_many';\n  const chosen = values.length + (other !== undefined ? 1 : 0);\n  if (question.min !== undefined && chosen < question.min) return 'too_few';\n  if (question.max !== undefined && chosen > question.max) return 'too_many';\n  return null;\n}\n\nfunction dateProblem(\n  question: Question,\n  date: string | undefined,\n): AnswerProblem | null {\n  if (!date) return 'required';\n  const m = /^(\\d{4})-(\\d{2})-(\\d{2})$/.exec(date);\n  if (!m) return 'bad_date';\n  const [y, mo, d] = [Number(m[1]), Number(m[2]), Number(m[3])];\n  const at = new Date(Date.UTC(y, mo - 1, d));\n  if (\n    at.getUTCFullYear() !== y ||\n    at.getUTCMonth() !== mo - 1 ||\n    at.getUTCDate() !== d\n  )\n    return 'bad_date';\n  // ISO dates compare as text.\n  if (question.date?.min !== undefined && date < question.date.min)\n    return 'bad_date';\n  if (question.date?.max !== undefined && date > question.date.max)\n    return 'bad_date';\n  return null;\n}\n","// One conversation store per mode (a customer and a professional, say, each with an agent of its own): each mode keeps\n// its own timeline, its own history on the device (a persistence key of its own) and its own sessions, so switching\n// modes never shows one mode's conversation in the other. The tenant's backend gets the mode with every session\n// request and creates the session for that mode's agent.\nimport {\n  type ConversationOptions,\n  type ConversationSession,\n  type ConversationStore,\n  createConversation,\n  type SessionRequest,\n} from './store.js';\n\n/** A session request, with the mode it is for. */\nexport interface ModeSessionRequest extends SessionRequest {\n  readonly mode: string;\n}\n\nexport interface ConversationsByModeOptions\n  extends Omit<ConversationOptions, 'getSession'> {\n  /** Your backend creates the session for the mode's agent (its `subject.type`, its agent), with its service key. */\n  readonly getSession: (\n    request: ModeSessionRequest,\n  ) => Promise<ConversationSession>;\n  /** Every mode the app has, so `clear()` forgets each one's kept history, even one not opened since launch. */\n  readonly modes?: readonly string[];\n}\n\nexport interface ConversationsByMode {\n  /** The mode's store, made the first time it is asked for; the same store after that. */\n  get(mode: string): ConversationStore;\n  /**\n   * The mode the person switched to: its store, with every other mode's sent to the background (no pings; closed\n   * with `closeInBackground`). The kit then drives the selected one with the app's foreground and background.\n   */\n  select(mode: string): ConversationStore;\n  /** Close every mode's store. */\n  dispose(): void;\n  /** Close every mode's store and forget what each kept on the device (sign-out). */\n  clear(): void;\n}\n\nexport function createConversationsByMode(\n  options: ConversationsByModeOptions,\n): ConversationsByMode {\n  const { getSession, modes = [], ...shared } = options;\n  const base = shared.persistenceKey ?? 'vinaverse.conversation';\n  const stores = new Map<string, ConversationStore>();\n  const get = (mode: string): ConversationStore => {\n    let store = stores.get(mode);\n    if (!store) {\n      store = createConversation({\n        ...shared,\n        persistenceKey: `${base}.${mode}`,\n        getSession: (request) => getSession({ ...request, mode }),\n      });\n      stores.set(mode, store);\n    }\n    return store;\n  };\n  return {\n    get,\n    select(mode) {\n      for (const [other, store] of stores)\n        if (other !== mode) store.setForeground(false);\n      return get(mode);\n    },\n    dispose() {\n      for (const store of stores.values()) store.dispose();\n      stores.clear();\n    },\n    clear() {\n      for (const mode of new Set([...stores.keys(), ...modes]))\n        get(mode).clear();\n      stores.clear();\n    },\n  };\n}\n"]}