@captello/ulc-webview-sdk 0.1.0 → 0.2.0

package/dist/index.js

@@ -1,5 +1,5 @@
-export { ActionButtonPosition, EmbedParam, FormMode, LauncherType, buildEmbedUrl, targetOriginFromUrl } from './chunk-ETF52K7K.js';
-export { CaptelloWebview, InboundMessageType, OutboundMessageType, PrefillDataType, SubmissionError, SubmissionTimeoutError, parseOutboundMessage } from './chunk-ZMYMZK2A.js';
+export { ActionButtonPosition, EmbedParam, FormMode, LauncherType, buildEmbedUrl } from './chunk-RKAY66VV.js';
+export { CaptelloWebview, InboundMessageType, OutboundMessageType, PrefillDataType, SubmissionError, SubmissionTimeoutError, parseOutboundMessage } from './chunk-IMJYXGWK.js';
 
 // src/submission-data.ts
 var FormElementType = /* @__PURE__ */ ((FormElementType2) => {
@@ -41,126 +41,7 @@ var FormElementType = /* @__PURE__ */ ((FormElementType2) => {
   FormElementType2["attachments"] = "attachments";
   return FormElementType2;
 })(FormElementType || {});
-var VALUED_ELEMENT_TYPES = /* @__PURE__ */ new Set([
-  "email" /* email */,
-  "url" /* url */,
-  "text" /* text */,
-  "textarea" /* textarea */,
-  "money" /* money */,
-  "number" /* number */,
-  "phone" /* phone */,
-  "simple_phone" /* simple_phone */,
-  "date" /* date */,
-  "time" /* time */,
-  "datetime" /* datetime */,
-  "audio" /* audio */,
-  "rating" /* rating */,
-  "star_survey" /* star_rating */,
-  "assign_owner" /* assign_owner */,
-  "signature" /* signature */,
-  "barcode" /* barcode */,
-  "meeting" /* meeting */,
-  "activation" /* activation */,
-  "checkbox" /* checkbox */,
-  "radio" /* radio */,
-  "select" /* select */,
-  "image" /* image */,
-  "documents" /* document */,
-  "engagem_feeder" /* engagem_feeder */,
-  "business_card" /* business_card */,
-  "boolean" /* boolean */,
-  "attachments" /* attachments */,
-  "simple_name" /* simple_name */,
-  "address" /* address */
-]);
-function isPlainObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function isVisibleItem(value) {
-  if (!isPlainObject(value)) return false;
-  return typeof value["element_id"] === "string" && typeof value["element_title"] === "string" && typeof value["element_type"] === "string" && VALUED_ELEMENT_TYPES.has(value["element_type"]) && "element_value" in value;
-}
-function parseVisibleSubmissionsData(data) {
-  let list = data;
-  if (isPlainObject(data) && "visible_submissions_data" in data) {
-    list = data["visible_submissions_data"];
-  }
-  if (!Array.isArray(list)) return [];
-  return list.filter(isVisibleItem);
-}
-var DEFAULT_OPTIONS = {
-  listSeparator: ", ",
-  booleanLabels: { true: "Yes", false: "No" },
-  emptyText: ""
-};
-function isOrderCheckbox(value) {
-  return isPlainObject(value) && Array.isArray(value["values"]);
-}
-function isOrderRadio(value) {
-  return isPlainObject(value) && typeof value["value"] === "string";
-}
-function withQuantity(value, quantity) {
-  return quantity > 1 ? `${value} (x${quantity})` : value;
-}
-function joinNonEmpty(parts, sep) {
-  return parts.map((p) => (p ?? "").toString().trim()).filter(Boolean).join(sep);
-}
-function toDisplayValue(item, options = {}) {
-  const opts = {
-    listSeparator: options.listSeparator ?? DEFAULT_OPTIONS.listSeparator,
-    booleanLabels: options.booleanLabels ?? DEFAULT_OPTIONS.booleanLabels,
-    emptyText: options.emptyText ?? DEFAULT_OPTIONS.emptyText
-  };
-  const sep = opts.listSeparator;
-  const value = item.element_value;
-  switch (item.element_type) {
-    case "simple_name" /* simple_name */:
-      return joinNonEmpty(Object.values(value), " ") || opts.emptyText;
-    case "address" /* address */:
-      return joinNonEmpty(Object.values(value), sep) || opts.emptyText;
-    case "boolean" /* boolean */:
-      return value ? opts.booleanLabels.true : opts.booleanLabels.false;
-    case "checkbox" /* checkbox */:
-      if (Array.isArray(value)) return joinNonEmpty(value, sep) || opts.emptyText;
-      if (isOrderCheckbox(value)) {
-        const items = value.values.map((v) => withQuantity(v.value, v.quantity));
-        return joinNonEmpty([...items, value.note], sep) || opts.emptyText;
-      }
-      return opts.emptyText;
-    case "radio" /* radio */:
-    case "select" /* select */:
-      if (typeof value === "string") return value || opts.emptyText;
-      if (isOrderRadio(value)) {
-        return joinNonEmpty([withQuantity(value.value, value.quantity), value.note], sep) || opts.emptyText;
-      }
-      return opts.emptyText;
-    case "image" /* image */:
-      return joinNonEmpty(value, sep) || opts.emptyText;
-    case "documents" /* document */:
-      return joinNonEmpty(value.map(String), sep) || opts.emptyText;
-    case "attachments" /* attachments */:
-      return joinNonEmpty(
-        value.map((a) => a.name),
-        sep
-      ) || opts.emptyText;
-    case "engagem_feeder" /* engagem_feeder */:
-      return value.map((q) => joinNonEmpty([q.question, q.answers.join("/")], ": ")).filter(Boolean).join("; ") || opts.emptyText;
-    case "business_card" /* business_card */: {
-      const bc = value;
-      return joinNonEmpty([bc.front, bc.back], sep) || opts.emptyText;
-    }
-    default:
-      return typeof value === "string" ? value || opts.emptyText : opts.emptyText;
-  }
-}
-function toDisplayPairs(data, options) {
-  return parseVisibleSubmissionsData(data).map((item) => ({
-    elementId: item.element_id,
-    label: item.element_title,
-    value: toDisplayValue(item, options)
-  }));
-}
 
-export { FormElementType, parseVisibleSubmissionsData, toDisplayPairs, toDisplayValue };
+export { FormElementType };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/submission-data.ts"],"names":["FormElementType"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Typed access to a submission's **visible** data — the list a host renders as\n * key/value pairs (one row per filled, visible form element).\n *\n * The webview emits this as `visible_submissions_data` inside the `submission_body`\n * payload: an array of items discriminated by `element_type`, where `element_value`'s\n * shape depends on the type. This module mirrors that contract and provides:\n *\n * - {@link parseVisibleSubmissionsData} — narrow `unknown` to typed items, dropping\n *   anything that doesn't match the contract.\n * - {@link toDisplayValue} / {@link toDisplayPairs} — flatten each item to a string\n *   (and `{ id, label, value }` rows) for direct rendering.\n *\n * For custom rendering, narrow on `element_type` and read the precisely-typed\n * `element_value` yourself.\n */\n\n/* ------------------------------------------------------------------ *\n * Element types\n * ------------------------------------------------------------------ */\n\n/**\n * Every form element type, mirroring the webview's `FormElementType`. The string\n * values are the wire values. Structural types (sections, separators, …) never carry\n * a value and never appear in visible submission data.\n */\nexport enum FormElementType {\n    email = \"email\",\n    section = \"section_block\",\n    html_block = \"section\",\n    url = \"url\",\n    text = \"text\",\n    select = \"select\",\n    radio = \"radio\",\n    simple_name = \"simple_name\",\n    textarea = \"textarea\",\n    time = \"time\",\n    address = \"address\",\n    money = \"money\",\n    number = \"number\",\n    date = \"date\",\n    phone = \"phone\",\n    simple_phone = \"simple_phone\",\n    checkbox = \"checkbox\",\n    image = \"image\",\n    business_card = \"business_card\",\n    signature = \"signature\",\n    barcode = \"barcode\",\n    separator = \"column_separator\",\n    activation = \"activation\",\n    document = \"documents\",\n    datetime = \"datetime\",\n    meeting = \"meeting\",\n    audio = \"audio\",\n    rating = \"rating\",\n    assign_owner = \"assign_owner\",\n    boolean = \"boolean\",\n    engagem_feeder = \"engagem_feeder\",\n    speaker_section = \"speaker_section_block\",\n    session_section = \"session_section_block\",\n    image_placeholder = \"image_placeholder\",\n    star_rating = \"star_survey\",\n    attachments = \"attachments\",\n}\n\n/* ------------------------------------------------------------------ *\n * Element value shapes\n * ------------------------------------------------------------------ */\n\n/** Composite element value (simple_name / address): sub-field values keyed by sub-element id. */\nexport type CompositeSubmissionValue = { [subElementId: string]: string };\n\n/** Checkbox value when the element is an \"order\" checkbox (quantities + note). */\nexport type OrderCheckboxSubmissionData = {\n    values: { value: string; quantity: number }[];\n    note: string;\n};\n\n/** Radio/select value when the element is an \"order\" radio/select (quantity + note). */\nexport type OrderRadioSubmissionData = { value: string; quantity: number; note: string };\n\n/** An uploaded attachment. `blob` is not present on the wire (postMessage JSON drops it). */\nexport type AttachmentValue = { token: string; url: string; name: string; size: number };\n\n/** A business-card capture: front/back image references (either may be absent). */\nexport type BusinessCardValue = { front: string; back: string };\n\n/** One engagement-feeder question/answer entry. */\nexport type SubmissionQuestionData = {\n    question: string;\n    answers: string[];\n    /** `\"\"` when the element is hidden. */\n    correct_answer: number | \"\";\n};\n\n/**\n * Maps each value-carrying element type to its `element_value` shape. Structural\n * types are intentionally absent, so they can never appear in a visible item.\n */\nexport type VisibleSubmissionElementValueMap = {\n    [FormElementType.email]: string;\n    [FormElementType.url]: string;\n    [FormElementType.text]: string;\n    [FormElementType.textarea]: string;\n    [FormElementType.money]: string;\n    [FormElementType.number]: string;\n    [FormElementType.phone]: string;\n    [FormElementType.simple_phone]: string;\n    [FormElementType.date]: string;\n    [FormElementType.time]: string;\n    [FormElementType.datetime]: string;\n    [FormElementType.audio]: string;\n    [FormElementType.rating]: string;\n    [FormElementType.star_rating]: string;\n    [FormElementType.assign_owner]: string;\n    [FormElementType.signature]: string;\n    [FormElementType.barcode]: string;\n    [FormElementType.meeting]: string;\n    [FormElementType.activation]: string;\n    [FormElementType.checkbox]: string[] | OrderCheckboxSubmissionData;\n    [FormElementType.radio]: string | OrderRadioSubmissionData;\n    [FormElementType.select]: string | OrderRadioSubmissionData;\n    [FormElementType.image]: string[];\n    [FormElementType.document]: number[];\n    [FormElementType.engagem_feeder]: SubmissionQuestionData[];\n    [FormElementType.business_card]: Partial<BusinessCardValue>;\n    [FormElementType.boolean]: boolean;\n    [FormElementType.attachments]: AttachmentValue[];\n    [FormElementType.simple_name]: CompositeSubmissionValue;\n    [FormElementType.address]: CompositeSubmissionValue;\n};\n\n/** Element types that carry a user-facing value (i.e. can appear in visible data). */\nexport type VisibleSubmissionElementType = keyof VisibleSubmissionElementValueMap;\n\n/**\n * One entry in `visible_submissions_data`, discriminated by `element_type`. Narrowing\n * on `element_type` gives a precisely-typed `element_value`.\n */\nexport type VisibleSubmissionDataItem = {\n    [T in VisibleSubmissionElementType]: {\n        element_id: string;\n        element_title: string;\n        element_type: T;\n        element_value: VisibleSubmissionElementValueMap[T];\n    };\n}[VisibleSubmissionElementType];\n\n/* ------------------------------------------------------------------ *\n * Parsing\n * ------------------------------------------------------------------ */\n\nconst VALUED_ELEMENT_TYPES: ReadonlySet<string> = new Set([\n    FormElementType.email,\n    FormElementType.url,\n    FormElementType.text,\n    FormElementType.textarea,\n    FormElementType.money,\n    FormElementType.number,\n    FormElementType.phone,\n    FormElementType.simple_phone,\n    FormElementType.date,\n    FormElementType.time,\n    FormElementType.datetime,\n    FormElementType.audio,\n    FormElementType.rating,\n    FormElementType.star_rating,\n    FormElementType.assign_owner,\n    FormElementType.signature,\n    FormElementType.barcode,\n    FormElementType.meeting,\n    FormElementType.activation,\n    FormElementType.checkbox,\n    FormElementType.radio,\n    FormElementType.select,\n    FormElementType.image,\n    FormElementType.document,\n    FormElementType.engagem_feeder,\n    FormElementType.business_card,\n    FormElementType.boolean,\n    FormElementType.attachments,\n    FormElementType.simple_name,\n    FormElementType.address,\n]);\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n    return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isVisibleItem(value: unknown): value is VisibleSubmissionDataItem {\n    if (!isPlainObject(value)) return false;\n    return (\n        typeof value[\"element_id\"] === \"string\" &&\n        typeof value[\"element_title\"] === \"string\" &&\n        typeof value[\"element_type\"] === \"string\" &&\n        VALUED_ELEMENT_TYPES.has(value[\"element_type\"]) &&\n        \"element_value\" in value\n    );\n}\n\n/**\n * Narrows `unknown` to a typed `VisibleSubmissionDataItem[]`, ready for rendering.\n *\n * Accepts, in order of convenience:\n * - the `visible_submissions_data` array itself,\n * - a `submission_body` payload object (the `data` of a `SubmissionBody` message) —\n *   its `visible_submissions_data` is extracted,\n * - anything else → `[]`.\n *\n * Items that don't match the contract (missing fields, structural/unknown\n * `element_type`) are dropped, so the result is always safe to map over.\n *\n * @example\n * webview.on(OutboundMessageType.SubmissionBody, (msg) => {\n *   const rows = toDisplayPairs(msg.data); // [{ elementId, label, value }, ...]\n *   render(rows);\n * });\n */\nexport function parseVisibleSubmissionsData(data: unknown): VisibleSubmissionDataItem[] {\n    let list: unknown = data;\n    if (isPlainObject(data) && \"visible_submissions_data\" in data) {\n        list = data[\"visible_submissions_data\"];\n    }\n    if (!Array.isArray(list)) return [];\n    return list.filter(isVisibleItem);\n}\n\n/* ------------------------------------------------------------------ *\n * Display helpers\n * ------------------------------------------------------------------ */\n\n/** Options for {@link toDisplayValue} / {@link toDisplayPairs}. */\nexport interface DisplayValueOptions {\n    /** Separator for list-like values (checkbox, image, …). Default `\", \"`. */\n    listSeparator?: string;\n    /** Labels for boolean values. Default `{ true: \"Yes\", false: \"No\" }`. */\n    booleanLabels?: { true: string; false: string };\n    /** Text used when a value is empty/blank. Default `\"\"`. */\n    emptyText?: string;\n}\n\ntype ResolvedOptions = Required<DisplayValueOptions>;\n\nconst DEFAULT_OPTIONS: ResolvedOptions = {\n    listSeparator: \", \",\n    booleanLabels: { true: \"Yes\", false: \"No\" },\n    emptyText: \"\",\n};\n\nfunction isOrderCheckbox(value: unknown): value is OrderCheckboxSubmissionData {\n    return isPlainObject(value) && Array.isArray((value as Record<string, unknown>)[\"values\"]);\n}\n\nfunction isOrderRadio(value: unknown): value is OrderRadioSubmissionData {\n    return isPlainObject(value) && typeof (value as Record<string, unknown>)[\"value\"] === \"string\";\n}\n\nfunction withQuantity(value: string, quantity: number): string {\n    return quantity > 1 ? `${value} (x${quantity})` : value;\n}\n\nfunction joinNonEmpty(parts: (string | undefined | null)[], sep: string): string {\n    return parts\n        .map((p) => (p ?? \"\").toString().trim())\n        .filter(Boolean)\n        .join(sep);\n}\n\n/**\n * Flattens a single visible item's `element_value` to a human-readable string for\n * rendering — composites are joined, list/order values are summarized, booleans use\n * the configured labels. For full control, read `element_value` directly instead.\n */\nexport function toDisplayValue(item: VisibleSubmissionDataItem, options: DisplayValueOptions = {}): string {\n    const opts: ResolvedOptions = {\n        listSeparator: options.listSeparator ?? DEFAULT_OPTIONS.listSeparator,\n        booleanLabels: options.booleanLabels ?? DEFAULT_OPTIONS.booleanLabels,\n        emptyText: options.emptyText ?? DEFAULT_OPTIONS.emptyText,\n    };\n    const sep = opts.listSeparator;\n    const value: unknown = item.element_value;\n\n    switch (item.element_type) {\n        case FormElementType.simple_name:\n            return joinNonEmpty(Object.values(value as CompositeSubmissionValue), \" \") || opts.emptyText;\n        case FormElementType.address:\n            return joinNonEmpty(Object.values(value as CompositeSubmissionValue), sep) || opts.emptyText;\n\n        case FormElementType.boolean:\n            return value ? opts.booleanLabels.true : opts.booleanLabels.false;\n\n        case FormElementType.checkbox:\n            if (Array.isArray(value)) return joinNonEmpty(value as string[], sep) || opts.emptyText;\n            if (isOrderCheckbox(value)) {\n                const items = value.values.map((v) => withQuantity(v.value, v.quantity));\n                return joinNonEmpty([...items, value.note], sep) || opts.emptyText;\n            }\n            return opts.emptyText;\n\n        case FormElementType.radio:\n        case FormElementType.select:\n            if (typeof value === \"string\") return value || opts.emptyText;\n            if (isOrderRadio(value)) {\n                return joinNonEmpty([withQuantity(value.value, value.quantity), value.note], sep) || opts.emptyText;\n            }\n            return opts.emptyText;\n\n        case FormElementType.image:\n            return joinNonEmpty(value as string[], sep) || opts.emptyText;\n\n        case FormElementType.document:\n            return joinNonEmpty((value as number[]).map(String), sep) || opts.emptyText;\n\n        case FormElementType.attachments:\n            return (\n                joinNonEmpty(\n                    (value as AttachmentValue[]).map((a) => a.name),\n                    sep,\n                ) || opts.emptyText\n            );\n\n        case FormElementType.engagem_feeder:\n            return (\n                (value as SubmissionQuestionData[])\n                    .map((q) => joinNonEmpty([q.question, q.answers.join(\"/\")], \": \"))\n                    .filter(Boolean)\n                    .join(\"; \") || opts.emptyText\n            );\n\n        case FormElementType.business_card: {\n            const bc = value as Partial<BusinessCardValue>;\n            return joinNonEmpty([bc.front, bc.back], sep) || opts.emptyText;\n        }\n\n        default:\n            // All remaining types are plain strings.\n            return typeof value === \"string\" ? value || opts.emptyText : opts.emptyText;\n    }\n}\n\n/** A render-ready key/value row. */\nexport interface SubmissionDisplayPair {\n    elementId: string;\n    label: string;\n    value: string;\n}\n\n/**\n * One-shot helper: parse `unknown` and map each visible item to a\n * `{ elementId, label, value }` row, where `value` is {@link toDisplayValue}'s output.\n * Ideal for rendering a submission as a key/value list.\n */\nexport function toDisplayPairs(data: unknown, options?: DisplayValueOptions): SubmissionDisplayPair[] {\n    return parseVisibleSubmissionsData(data).map((item) => ({\n        elementId: item.element_id,\n        label: item.element_title,\n        value: toDisplayValue(item, options),\n    }));\n}\n"]}
+{"version":3,"sources":["../src/submission-data.ts"],"names":["FormElementType"],"mappings":";;;;AAiCO,IAAK,eAAA,qBAAAA,gBAAAA,KAAL;AACH,EAAAA,iBAAA,OAAA,CAAA,GAAQ,OAAA;AACR,EAAAA,iBAAA,SAAA,CAAA,GAAU,eAAA;AACV,EAAAA,iBAAA,YAAA,CAAA,GAAa,SAAA;AACb,EAAAA,iBAAA,KAAA,CAAA,GAAM,KAAA;AACN,EAAAA,iBAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,iBAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,iBAAA,OAAA,CAAA,GAAQ,OAAA;AACR,EAAAA,iBAAA,aAAA,CAAA,GAAc,aAAA;AACd,EAAAA,iBAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,iBAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,iBAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,iBAAA,OAAA,CAAA,GAAQ,OAAA;AACR,EAAAA,iBAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,iBAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,iBAAA,OAAA,CAAA,GAAQ,OAAA;AACR,EAAAA,iBAAA,cAAA,CAAA,GAAe,cAAA;AACf,EAAAA,iBAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,iBAAA,OAAA,CAAA,GAAQ,OAAA;AACR,EAAAA,iBAAA,eAAA,CAAA,GAAgB,eAAA;AAChB,EAAAA,iBAAA,WAAA,CAAA,GAAY,WAAA;AACZ,EAAAA,iBAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,iBAAA,WAAA,CAAA,GAAY,kBAAA;AACZ,EAAAA,iBAAA,YAAA,CAAA,GAAa,YAAA;AACb,EAAAA,iBAAA,UAAA,CAAA,GAAW,WAAA;AACX,EAAAA,iBAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,iBAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,iBAAA,OAAA,CAAA,GAAQ,OAAA;AACR,EAAAA,iBAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,iBAAA,cAAA,CAAA,GAAe,cAAA;AACf,EAAAA,iBAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,iBAAA,gBAAA,CAAA,GAAiB,gBAAA;AACjB,EAAAA,iBAAA,iBAAA,CAAA,GAAkB,uBAAA;AAClB,EAAAA,iBAAA,iBAAA,CAAA,GAAkB,uBAAA;AAClB,EAAAA,iBAAA,mBAAA,CAAA,GAAoB,mBAAA;AACpB,EAAAA,iBAAA,aAAA,CAAA,GAAc,aAAA;AACd,EAAAA,iBAAA,aAAA,CAAA,GAAc,aAAA;AApCN,EAAA,OAAAA,gBAAAA;AAAA,CAAA,EAAA,eAAA,IAAA,EAAA","file":"index.js","sourcesContent":["/**\n * Types for a submission's **visible** data — the list a host renders as key/value\n * pairs (one row per filled, visible form element).\n *\n * The webview emits this as `visible_submissions_data` inside the `submission_body`\n * payload: an array of {@link VisibleSubmissionDataItem}, discriminated by\n * `element_type`, where `element_value`'s shape depends on the type. Narrow on\n * `element_type` to get a precisely-typed `element_value` and render it however you\n * like:\n *\n * @example\n * for (const item of submission.visible_submissions_data ?? []) {\n *   switch (item.element_type) {\n *     case FormElementType.email:\n *       row(item.element_title, item.element_value); // element_value: string\n *       break;\n *     case FormElementType.checkbox:\n *       // element_value: string[] | OrderCheckboxSubmissionData\n *       break;\n *     // …\n *   }\n * }\n */\n\n/* ------------------------------------------------------------------ *\n * Element types\n * ------------------------------------------------------------------ */\n\n/**\n * Every form element type, mirroring the webview's `FormElementType`. The string\n * values are the wire values. Structural types (sections, separators, …) never carry\n * a value and never appear in visible submission data.\n */\nexport enum FormElementType {\n    email = \"email\",\n    section = \"section_block\",\n    html_block = \"section\",\n    url = \"url\",\n    text = \"text\",\n    select = \"select\",\n    radio = \"radio\",\n    simple_name = \"simple_name\",\n    textarea = \"textarea\",\n    time = \"time\",\n    address = \"address\",\n    money = \"money\",\n    number = \"number\",\n    date = \"date\",\n    phone = \"phone\",\n    simple_phone = \"simple_phone\",\n    checkbox = \"checkbox\",\n    image = \"image\",\n    business_card = \"business_card\",\n    signature = \"signature\",\n    barcode = \"barcode\",\n    separator = \"column_separator\",\n    activation = \"activation\",\n    document = \"documents\",\n    datetime = \"datetime\",\n    meeting = \"meeting\",\n    audio = \"audio\",\n    rating = \"rating\",\n    assign_owner = \"assign_owner\",\n    boolean = \"boolean\",\n    engagem_feeder = \"engagem_feeder\",\n    speaker_section = \"speaker_section_block\",\n    session_section = \"session_section_block\",\n    image_placeholder = \"image_placeholder\",\n    star_rating = \"star_survey\",\n    attachments = \"attachments\",\n}\n\n/* ------------------------------------------------------------------ *\n * Element value shapes\n * ------------------------------------------------------------------ */\n\n/** Composite element value (simple_name / address): sub-field values keyed by sub-element id. */\nexport type CompositeSubmissionValue = { [subElementId: string]: string };\n\n/** Checkbox value when the element is an \"order\" checkbox (quantities + note). */\nexport type OrderCheckboxSubmissionData = {\n    values: { value: string; quantity: number }[];\n    note: string;\n};\n\n/** Radio/select value when the element is an \"order\" radio/select (quantity + note). */\nexport type OrderRadioSubmissionData = { value: string; quantity: number; note: string };\n\n/** An uploaded attachment. `blob` is not present on the wire (postMessage JSON drops it). */\nexport type AttachmentValue = { token: string; url: string; name: string; size: number };\n\n/** A business-card capture: front/back image references (either may be absent). */\nexport type BusinessCardValue = { front: string; back: string };\n\n/** One engagement-feeder question/answer entry. */\nexport type SubmissionQuestionData = {\n    question: string;\n    answers: string[];\n    /** `\"\"` when the element is hidden. */\n    correct_answer: number | \"\";\n};\n\n/**\n * Maps each value-carrying element type to its `element_value` shape. Structural\n * types are intentionally absent, so they can never appear in a visible item.\n */\nexport type VisibleSubmissionElementValueMap = {\n    [FormElementType.email]: string;\n    [FormElementType.url]: string;\n    [FormElementType.text]: string;\n    [FormElementType.textarea]: string;\n    [FormElementType.money]: string;\n    [FormElementType.number]: string;\n    [FormElementType.phone]: string;\n    [FormElementType.simple_phone]: string;\n    [FormElementType.date]: string;\n    [FormElementType.time]: string;\n    [FormElementType.datetime]: string;\n    [FormElementType.audio]: string;\n    [FormElementType.rating]: string;\n    [FormElementType.star_rating]: string;\n    [FormElementType.assign_owner]: string;\n    [FormElementType.signature]: string;\n    [FormElementType.barcode]: string;\n    [FormElementType.meeting]: string;\n    [FormElementType.activation]: string;\n    [FormElementType.checkbox]: string[] | OrderCheckboxSubmissionData;\n    [FormElementType.radio]: string | OrderRadioSubmissionData;\n    [FormElementType.select]: string | OrderRadioSubmissionData;\n    [FormElementType.image]: string[];\n    [FormElementType.document]: number[];\n    [FormElementType.engagem_feeder]: SubmissionQuestionData[];\n    [FormElementType.business_card]: Partial<BusinessCardValue>;\n    [FormElementType.boolean]: boolean;\n    [FormElementType.attachments]: AttachmentValue[];\n    [FormElementType.simple_name]: CompositeSubmissionValue;\n    [FormElementType.address]: CompositeSubmissionValue;\n};\n\n/** Element types that carry a user-facing value (i.e. can appear in visible data). */\nexport type VisibleSubmissionElementType = keyof VisibleSubmissionElementValueMap;\n\n/**\n * One entry in `visible_submissions_data`, discriminated by `element_type`. Narrowing\n * on `element_type` gives a precisely-typed `element_value`.\n */\nexport type VisibleSubmissionDataItem = {\n    [T in VisibleSubmissionElementType]: {\n        element_id: string;\n        element_title: string;\n        element_type: T;\n        element_value: VisibleSubmissionElementValueMap[T];\n    };\n}[VisibleSubmissionElementType];\n"]}

package/dist/promises.d.ts

@@ -1,5 +1,5 @@
-import { C as CaptelloWebviewOptions, S as SubmissionBody, O as OutboundMessageType, a as OutboundMessageMap } from './client-3IBxKbIE.js';
-export { b as SubmissionError, c as SubmissionTimeoutError } from './client-3IBxKbIE.js';
+import { C as CaptelloWebviewOptions, S as SubmissionBody, O as OutboundMessageType, a as OutboundMessageMap } from './client-BRIlJHCg.js';
+export { b as SubmissionError, c as SubmissionTimeoutError } from './client-BRIlJHCg.js';
 
 /**
  * Promise-based, one-shot helpers for imperative flows — `@captello/ulc-webview-sdk/promises`.

package/dist/promises.js

@@ -1,5 +1,5 @@
-import { CaptelloWebview } from './chunk-ZMYMZK2A.js';
-export { SubmissionError, SubmissionTimeoutError } from './chunk-ZMYMZK2A.js';
+import { CaptelloWebview } from './chunk-IMJYXGWK.js';
+export { SubmissionError, SubmissionTimeoutError } from './chunk-IMJYXGWK.js';
 
 // src/promises.ts
 var DEFAULT_TIMEOUT_MS = 6e4;

package/dist/react.d.ts

@@ -1,6 +1,6 @@
 import { RefCallback } from 'react';
-import { a as OutboundMessageMap, O as OutboundMessageType, d as OutboundMessage, C as CaptelloWebviewOptions, e as CaptelloWebview, V as ValidationTarget, P as PrefillInfoItem, f as SubmissionPrefill, S as SubmissionBody } from './client-3IBxKbIE.js';
-export { b as SubmissionError, c as SubmissionTimeoutError, U as Unsubscribe } from './client-3IBxKbIE.js';
+import { a as OutboundMessageMap, O as OutboundMessageType, d as OutboundMessage, C as CaptelloWebviewOptions, e as CaptelloWebview, V as ValidationTarget, P as PrefillInfoItem, f as SubmissionPrefill, S as SubmissionBody } from './client-BRIlJHCg.js';
+export { b as SubmissionError, c as SubmissionTimeoutError, U as Unsubscribe } from './client-BRIlJHCg.js';
 import { EmbedUrlOptions } from './index.js';
 
 /**
@@ -25,7 +25,7 @@ import { EmbedUrlOptions } from './index.js';
  * function UlcForm({ token, onSubmitted }: { token: string; onSubmitted: (b: SubmissionBody) => void }) {
  *   const { iframeProps, isReady, submit } = useCaptelloWebview({
  *     embedUrl: {
- *       baseUrl: "https://capture.captello.com/capture/submission",
+ *       baseUrl: "https://capture.captello.com",
  *       eventWebAccessToken: token,
  *       mode: FormMode.Submit,
  *       launcher: LauncherType.EventGenWeb,
@@ -55,7 +55,11 @@ interface CaptelloWebviewCallbacks {
 }
 /** Embed-URL config: a base URL plus {@link EmbedUrlOptions}. */
 interface EmbedUrlConfig extends EmbedUrlOptions {
-    /** The capture base URL, e.g. `"https://capture.captello.com/capture/submission"`. */
+    /**
+     * The capture **origin**, e.g. `"https://capture.captello.com"`. The SDK appends the
+     * capture path for you, so the origin, a trailing slash, or the full
+     * `…/capture/submission` URL all work — see {@link buildEmbedUrl}.
+     */
     baseUrl: string;
 }
 /**

package/dist/react.js

@@ -1,6 +1,6 @@
-import { buildEmbedUrl, targetOriginFromUrl } from './chunk-ETF52K7K.js';
-import { CaptelloWebview, OutboundMessageType } from './chunk-ZMYMZK2A.js';
-export { CaptelloWebview, SubmissionError, SubmissionTimeoutError } from './chunk-ZMYMZK2A.js';
+import { buildEmbedUrl } from './chunk-RKAY66VV.js';
+import { CaptelloWebview, OutboundMessageType } from './chunk-IMJYXGWK.js';
+export { CaptelloWebview, SubmissionError, SubmissionTimeoutError } from './chunk-IMJYXGWK.js';
 import { useRef, useState, useCallback, useEffect } from 'react';
 
 var CALLBACK_BY_TYPE = {
@@ -14,7 +14,7 @@ var CALLBACK_BY_TYPE = {
 function useCaptelloWebview(options) {
   const { embedUrl, matchSource, queueUntilReady, hostWindow } = options;
   const src = embedUrl ? buildEmbedUrl(embedUrl.baseUrl, embedUrl) : void 0;
-  const targetOrigin = src ? targetOriginFromUrl(src) : options.targetOrigin;
+  const targetOrigin = src ? new URL(src).origin : options.targetOrigin;
   const optionsRef = useRef(options);
   optionsRef.current = options;
   const clientRef = useRef(null);

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react.ts"],"names":[],"mappings":"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","file":"react.js","sourcesContent":["/**\n * React adapter for the Captello webview SDK — `@captello/ulc-webview-sdk/react`.\n *\n * {@link useCaptelloWebview} owns a {@link CaptelloWebview} for the lifetime of an\n * iframe: it creates the client once the iframe mounts, wires the outbound messages\n * you care about to typed callbacks, tracks readiness, and destroys the client on\n * unmount. You get back `iframeProps` to spread onto your `<iframe>` (or a bare `ref`),\n * an `isReady` flag, and stable senders (`submit`, `reset`, `prefillInfo`, …).\n *\n * Sends made before the form loads are queued by the client and flushed on\n * `form_load_complete`, so you can call `prefillInfo(...)` as soon as you have data —\n * no need to gate on readiness yourself.\n *\n * Callbacks are held in a ref and always called fresh, so you do NOT need to memoize\n * them — passing inline arrow functions will not re-subscribe or re-create the client.\n *\n * `react` is an optional peer dependency; importing this entry point requires React 18+.\n *\n * @example\n * function UlcForm({ token, onSubmitted }: { token: string; onSubmitted: (b: SubmissionBody) => void }) {\n *   const { iframeProps, isReady, submit } = useCaptelloWebview({\n *     embedUrl: {\n *       baseUrl: \"https://capture.captello.com/capture/submission\",\n *       eventWebAccessToken: token,\n *       mode: FormMode.Submit,\n *       launcher: LauncherType.EventGenWeb,\n *     },\n *     onSubmissionBody: (m) => onSubmitted(m.data),\n *   });\n *   return (\n *     <>\n *       {!isReady && <Spinner />}\n *       <iframe {...iframeProps} title=\"UlcForm\" allow=\"camera; microphone\" />\n *       <button onClick={submit}>Submit</button>\n *     </>\n *   );\n * }\n */\n\nimport { useCallback, useEffect, useRef, useState, type RefCallback } from \"react\";\n\nimport { CaptelloWebview } from \"./client\";\nimport type { CaptelloWebviewOptions, Unsubscribe } from \"./client\";\nimport { buildEmbedUrl, targetOriginFromUrl } from \"./embed-url\";\nimport type { EmbedUrlOptions } from \"./embed-url\";\nimport { OutboundMessageType } from \"./messages\";\nimport type {\n    OutboundMessage,\n    OutboundMessageMap,\n    PrefillInfoItem,\n    SubmissionBody,\n    SubmissionPrefill,\n    ValidationTarget,\n} from \"./messages\";\n\n/** Per-message-type callback props accepted by {@link useCaptelloWebview}. */\nexport interface CaptelloWebviewCallbacks {\n    onFormLoadComplete?: (message: OutboundMessageMap[OutboundMessageType.FormLoadComplete]) => void;\n    onFormErrorMessage?: (message: OutboundMessageMap[OutboundMessageType.FormErrorMessage]) => void;\n    onSubmissionBody?: (message: OutboundMessageMap[OutboundMessageType.SubmissionBody]) => void;\n    onFormSubmitSuccess?: (message: OutboundMessageMap[OutboundMessageType.FormSubmitSuccess]) => void;\n    onConnexionsProfileRedirect?: (message: OutboundMessageMap[OutboundMessageType.ConnexionsProfileRedirect]) => void;\n    onConnexionsDownloadVcard?: (message: OutboundMessageMap[OutboundMessageType.ConnexionsDownloadVcard]) => void;\n    /** Catch-all: called for every outbound message, after the specific handler above. */\n    onAnyMessage?: (message: OutboundMessage) => void;\n}\n\n/** Embed-URL config: a base URL plus {@link EmbedUrlOptions}. */\nexport interface EmbedUrlConfig extends EmbedUrlOptions {\n    /** The capture base URL, e.g. `\"https://capture.captello.com/capture/submission\"`. */\n    baseUrl: string;\n}\n\n/**\n * Options for {@link useCaptelloWebview}.\n *\n * Provide **either** `embedUrl` (the hook builds the URL and derives `targetOrigin`,\n * returning `iframeProps.src`) **or** your own `targetOrigin` (you set the iframe `src`\n * yourself). Plus message callbacks and the usual client options.\n */\nexport interface UseCaptelloWebviewOptions extends CaptelloWebviewOptions, CaptelloWebviewCallbacks {\n    /** Build the iframe URL and derive `targetOrigin` from it. Sets `iframeProps.src`. */\n    embedUrl?: EmbedUrlConfig;\n}\n\n/** Readiness of the embedded form. */\nexport type CaptelloWebviewStatus = \"loading\" | \"ready\" | \"error\";\n\n/** Props to spread onto the `<iframe>`. `src` is present only when `embedUrl` is given. */\nexport interface CaptelloIframeProps {\n    ref: RefCallback<HTMLIFrameElement | null>;\n    src?: string;\n}\n\n/** What {@link useCaptelloWebview} returns. */\nexport interface UseCaptelloWebviewResult {\n    /** Spread onto your iframe: `<iframe {...iframeProps} />`. Includes `src` if `embedUrl` was given. */\n    iframeProps: CaptelloIframeProps;\n    /** The iframe ref callback (same as `iframeProps.ref`), if you'd rather set `src` yourself. */\n    ref: RefCallback<HTMLIFrameElement | null>;\n    /** `true` once the form has reported `form_load_complete`. */\n    isReady: boolean;\n    /** `\"loading\"` → `\"ready\"`; flips to `\"error\"` if a `form_error_message` arrives. */\n    status: CaptelloWebviewStatus;\n    /** The live client, or `null` before the iframe mounts. For escape-hatch use. */\n    getClient: () => CaptelloWebview | null;\n    submit: () => void;\n    reset: () => void;\n    updateDraft: () => void;\n    triggerValidation: (target: ValidationTarget) => void;\n    prefillInfo: (info: PrefillInfoItem[]) => void;\n    prefillSubmission: (submission: SubmissionPrefill) => void;\n    prefillSubmissionAndInfo: (data: { submission?: SubmissionPrefill; info?: PrefillInfoItem[] }) => void;\n    submitAndWait: (timeoutMs?: number) => Promise<SubmissionBody>;\n}\n\nconst CALLBACK_BY_TYPE: Record<OutboundMessageType, keyof CaptelloWebviewCallbacks> = {\n    [OutboundMessageType.FormLoadComplete]: \"onFormLoadComplete\",\n    [OutboundMessageType.FormErrorMessage]: \"onFormErrorMessage\",\n    [OutboundMessageType.SubmissionBody]: \"onSubmissionBody\",\n    [OutboundMessageType.FormSubmitSuccess]: \"onFormSubmitSuccess\",\n    [OutboundMessageType.ConnexionsProfileRedirect]: \"onConnexionsProfileRedirect\",\n    [OutboundMessageType.ConnexionsDownloadVcard]: \"onConnexionsDownloadVcard\",\n};\n\n/**\n * Binds a {@link CaptelloWebview} to an iframe's lifecycle. See the module doc for usage.\n */\nexport function useCaptelloWebview(options: UseCaptelloWebviewOptions): UseCaptelloWebviewResult {\n    const { embedUrl, matchSource, queueUntilReady, hostWindow } = options;\n\n    // Resolve the URL + the targetOrigin to use. embedUrl wins; otherwise use the\n    // explicit targetOrigin. Recompute only when the URL-affecting inputs change.\n    const src = embedUrl ? buildEmbedUrl(embedUrl.baseUrl, embedUrl) : undefined;\n    const targetOrigin = src ? targetOriginFromUrl(src) : options.targetOrigin;\n\n    // Latest options/callbacks, read fresh inside listeners so callers needn't memoize.\n    const optionsRef = useRef(options);\n    optionsRef.current = options;\n\n    const clientRef = useRef<CaptelloWebview | null>(null);\n    const frameRef = useRef<HTMLIFrameElement | null>(null);\n    const teardown = useRef<(() => void) | null>(null);\n\n    const [status, setStatus] = useState<CaptelloWebviewStatus>(\"loading\");\n\n    const attach = useCallback(\n        (frame: HTMLIFrameElement | null) => {\n            // Tear down any previous client (ref changed or unmounting).\n            teardown.current?.();\n            teardown.current = null;\n            clientRef.current = null;\n            frameRef.current = frame;\n            setStatus(\"loading\");\n\n            if (!frame) return;\n\n            const client = new CaptelloWebview(frame, {\n                targetOrigin,\n                hostWindow: optionsRef.current.hostWindow,\n                matchSource: optionsRef.current.matchSource,\n                queueUntilReady: optionsRef.current.queueUntilReady,\n            });\n            clientRef.current = client;\n\n            const offs: Unsubscribe[] = [];\n            for (const type of Object.values(OutboundMessageType)) {\n                offs.push(\n                    client.on(type, (message) => {\n                        if (type === OutboundMessageType.FormLoadComplete) setStatus(\"ready\");\n                        else if (type === OutboundMessageType.FormErrorMessage) setStatus(\"error\");\n\n                        const handler = optionsRef.current[CALLBACK_BY_TYPE[type]] as\n                            | ((m: typeof message) => void)\n                            | undefined;\n                        handler?.(message);\n                        optionsRef.current.onAnyMessage?.(message);\n                    }),\n                );\n            }\n\n            teardown.current = () => {\n                for (const off of offs) off();\n                client.destroy();\n            };\n        },\n        // Re-create the client only when connection-level inputs change.\n        // Callbacks are read via optionsRef, so they intentionally aren't deps.\n        [targetOrigin, matchSource, queueUntilReady, hostWindow],\n    );\n\n    useEffect(() => {\n        if (frameRef.current) attach(frameRef.current);\n        return () => {\n            teardown.current?.();\n            teardown.current = null;\n            clientRef.current = null;\n        };\n    }, [attach]);\n\n    const getClient = useCallback(() => clientRef.current, []);\n\n    const submit = useCallback(() => clientRef.current?.submit(), []);\n    const reset = useCallback(() => clientRef.current?.reset(), []);\n    const updateDraft = useCallback(() => clientRef.current?.updateDraft(), []);\n    const triggerValidation = useCallback(\n        (target: ValidationTarget) => clientRef.current?.triggerValidation(target),\n        [],\n    );\n    const prefillInfo = useCallback((info: PrefillInfoItem[]) => clientRef.current?.prefillInfo(info), []);\n    const prefillSubmission = useCallback(\n        (submission: SubmissionPrefill) => clientRef.current?.prefillSubmission(submission),\n        [],\n    );\n    const prefillSubmissionAndInfo = useCallback(\n        (data: { submission?: SubmissionPrefill; info?: PrefillInfoItem[] }) =>\n            clientRef.current?.prefillSubmissionAndInfo(data),\n        [],\n    );\n    const submitAndWait = useCallback((timeoutMs?: number) => {\n        const client = clientRef.current;\n        if (!client) {\n            return Promise.reject(new Error(\"CaptelloWebview: iframe is not mounted yet.\"));\n        }\n        return client.submitAndWait(timeoutMs);\n    }, []);\n\n    const iframeProps: CaptelloIframeProps = src ? { ref: attach, src } : { ref: attach };\n\n    return {\n        iframeProps,\n        ref: attach,\n        isReady: status === \"ready\",\n        status,\n        getClient,\n        submit,\n        reset,\n        updateDraft,\n        triggerValidation,\n        prefillInfo,\n        prefillSubmission,\n        prefillSubmissionAndInfo,\n        submitAndWait,\n    };\n}\n\nexport { CaptelloWebview, SubmissionError, SubmissionTimeoutError } from \"./client\";\nexport type { Unsubscribe } from \"./client\";\n"]}
+{"version":3,"sources":["../src/react.ts"],"names":[],"mappings":";;;;;AAwHA,IAAM,gBAAA,GAAgF;AAAA,EAClF,+CAAwC,oBAAA;AAAA,EACxC,+CAAwC,oBAAA;AAAA,EACxC,0CAAsC,kBAAA;AAAA,EACtC,iDAAyC,qBAAA;AAAA,EACzC,iEAAiD,6BAAA;AAAA,EACjD,6DAA+C;AACnD,CAAA;AAKO,SAAS,mBAAmB,OAAA,EAA8D;AAC7F,EAAA,MAAM,EAAE,QAAA,EAAU,WAAA,EAAa,eAAA,EAAiB,YAAW,GAAI,OAAA;AAI/D,EAAA,MAAM,MAAM,QAAA,GAAW,aAAA,CAAc,QAAA,CAAS,OAAA,EAAS,QAAQ,CAAA,GAAI,MAAA;AACnE,EAAA,MAAM,eAAe,GAAA,GAAM,IAAI,IAAI,GAAG,CAAA,CAAE,SAAS,OAAA,CAAQ,YAAA;AAGzD,EAAA,MAAM,UAAA,GAAa,OAAO,OAAO,CAAA;AACjC,EAAA,UAAA,CAAW,OAAA,GAAU,OAAA;AAErB,EAAA,MAAM,SAAA,GAAY,OAA+B,IAAI,CAAA;AACrD,EAAA,MAAM,QAAA,GAAW,OAAiC,IAAI,CAAA;AACtD,EAAA,MAAM,QAAA,GAAW,OAA4B,IAAI,CAAA;AAEjD,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAI,SAAgC,SAAS,CAAA;AAErE,EAAA,MAAM,MAAA,GAAS,WAAA;AAAA,IACX,CAAC,KAAA,KAAoC;AAEjC,MAAA,QAAA,CAAS,OAAA,IAAU;AACnB,MAAA,QAAA,CAAS,OAAA,GAAU,IAAA;AACnB,MAAA,SAAA,CAAU,OAAA,GAAU,IAAA;AACpB,MAAA,QAAA,CAAS,OAAA,GAAU,KAAA;AACnB,MAAA,SAAA,CAAU,SAAS,CAAA;AAEnB,MAAA,IAAI,CAAC,KAAA,EAAO;AAEZ,MAAA,MAAM,MAAA,GAAS,IAAI,eAAA,CAAgB,KAAA,EAAO;AAAA,QACtC,YAAA;AAAA,QACA,UAAA,EAAY,WAAW,OAAA,CAAQ,UAAA;AAAA,QAC/B,WAAA,EAAa,WAAW,OAAA,CAAQ,WAAA;AAAA,QAChC,eAAA,EAAiB,WAAW,OAAA,CAAQ;AAAA,OACvC,CAAA;AACD,MAAA,SAAA,CAAU,OAAA,GAAU,MAAA;AAEpB,MAAA,MAAM,OAAsB,EAAC;AAC7B,MAAA,KAAA,MAAW,IAAA,IAAQ,MAAA,CAAO,MAAA,CAAO,mBAAmB,CAAA,EAAG;AACnD,QAAA,IAAA,CAAK,IAAA;AAAA,UACD,MAAA,CAAO,EAAA,CAAG,IAAA,EAAM,CAAC,OAAA,KAAY;AACzB,YAAA,IAAI,IAAA,KAAA,oBAAA,mCAAyD,OAAO,CAAA;AAAA,iBAAA,IAC3D,IAAA,KAAA,oBAAA,mCAAyD,OAAO,CAAA;AAEzE,YAAA,MAAM,OAAA,GAAU,UAAA,CAAW,OAAA,CAAQ,gBAAA,CAAiB,IAAI,CAAC,CAAA;AAGzD,YAAA,OAAA,GAAU,OAAO,CAAA;AACjB,YAAA,UAAA,CAAW,OAAA,CAAQ,eAAe,OAAO,CAAA;AAAA,UAC7C,CAAC;AAAA,SACL;AAAA,MACJ;AAEA,MAAA,QAAA,CAAS,UAAU,MAAM;AACrB,QAAA,KAAA,MAAW,GAAA,IAAO,MAAM,GAAA,EAAI;AAC5B,QAAA,MAAA,CAAO,OAAA,EAAQ;AAAA,MACnB,CAAA;AAAA,IACJ,CAAA;AAAA;AAAA;AAAA,IAGA,CAAC,YAAA,EAAc,WAAA,EAAa,eAAA,EAAiB,UAAU;AAAA,GAC3D;AAEA,EAAA,SAAA,CAAU,MAAM;AACZ,IAAA,IAAI,QAAA,CAAS,OAAA,EAAS,MAAA,CAAO,QAAA,CAAS,OAAO,CAAA;AAC7C,IAAA,OAAO,MAAM;AACT,MAAA,QAAA,CAAS,OAAA,IAAU;AACnB,MAAA,QAAA,CAAS,OAAA,GAAU,IAAA;AACnB,MAAA,SAAA,CAAU,OAAA,GAAU,IAAA;AAAA,IACxB,CAAA;AAAA,EACJ,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,MAAM,YAAY,WAAA,CAAY,MAAM,SAAA,CAAU,OAAA,EAAS,EAAE,CAAA;AAEzD,EAAA,MAAM,MAAA,GAAS,YAAY,MAAM,SAAA,CAAU,SAAS,MAAA,EAAO,EAAG,EAAE,CAAA;AAChE,EAAA,MAAM,KAAA,GAAQ,YAAY,MAAM,SAAA,CAAU,SAAS,KAAA,EAAM,EAAG,EAAE,CAAA;AAC9D,EAAA,MAAM,WAAA,GAAc,YAAY,MAAM,SAAA,CAAU,SAAS,WAAA,EAAY,EAAG,EAAE,CAAA;AAC1E,EAAA,MAAM,iBAAA,GAAoB,WAAA;AAAA,IACtB,CAAC,MAAA,KAA6B,SAAA,CAAU,OAAA,EAAS,kBAAkB,MAAM,CAAA;AAAA,IACzE;AAAC,GACL;AACA,EAAA,MAAM,WAAA,GAAc,WAAA,CAAY,CAAC,IAAA,KAA4B,SAAA,CAAU,SAAS,WAAA,CAAY,IAAI,CAAA,EAAG,EAAE,CAAA;AACrG,EAAA,MAAM,iBAAA,GAAoB,WAAA;AAAA,IACtB,CAAC,UAAA,KAAkC,SAAA,CAAU,OAAA,EAAS,kBAAkB,UAAU,CAAA;AAAA,IAClF;AAAC,GACL;AACA,EAAA,MAAM,wBAAA,GAA2B,WAAA;AAAA,IAC7B,CAAC,IAAA,KACG,SAAA,CAAU,OAAA,EAAS,yBAAyB,IAAI,CAAA;AAAA,IACpD;AAAC,GACL;AACA,EAAA,MAAM,aAAA,GAAgB,WAAA,CAAY,CAAC,SAAA,KAAuB;AACtD,IAAA,MAAM,SAAS,SAAA,CAAU,OAAA;AACzB,IAAA,IAAI,CAAC,MAAA,EAAQ;AACT,MAAA,OAAO,OAAA,CAAQ,MAAA,CAAO,IAAI,KAAA,CAAM,6CAA6C,CAAC,CAAA;AAAA,IAClF;AACA,IAAA,OAAO,MAAA,CAAO,cAAc,SAAS,CAAA;AAAA,EACzC,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,WAAA,GAAmC,MAAM,EAAE,GAAA,EAAK,QAAQ,GAAA,EAAI,GAAI,EAAE,GAAA,EAAK,MAAA,EAAO;AAEpF,EAAA,OAAO;AAAA,IACH,WAAA;AAAA,IACA,GAAA,EAAK,MAAA;AAAA,IACL,SAAS,MAAA,KAAW,OAAA;AAAA,IACpB,MAAA;AAAA,IACA,SAAA;AAAA,IACA,MAAA;AAAA,IACA,KAAA;AAAA,IACA,WAAA;AAAA,IACA,iBAAA;AAAA,IACA,WAAA;AAAA,IACA,iBAAA;AAAA,IACA,wBAAA;AAAA,IACA;AAAA,GACJ;AACJ","file":"react.js","sourcesContent":["/**\n * React adapter for the Captello webview SDK — `@captello/ulc-webview-sdk/react`.\n *\n * {@link useCaptelloWebview} owns a {@link CaptelloWebview} for the lifetime of an\n * iframe: it creates the client once the iframe mounts, wires the outbound messages\n * you care about to typed callbacks, tracks readiness, and destroys the client on\n * unmount. You get back `iframeProps` to spread onto your `<iframe>` (or a bare `ref`),\n * an `isReady` flag, and stable senders (`submit`, `reset`, `prefillInfo`, …).\n *\n * Sends made before the form loads are queued by the client and flushed on\n * `form_load_complete`, so you can call `prefillInfo(...)` as soon as you have data —\n * no need to gate on readiness yourself.\n *\n * Callbacks are held in a ref and always called fresh, so you do NOT need to memoize\n * them — passing inline arrow functions will not re-subscribe or re-create the client.\n *\n * `react` is an optional peer dependency; importing this entry point requires React 18+.\n *\n * @example\n * function UlcForm({ token, onSubmitted }: { token: string; onSubmitted: (b: SubmissionBody) => void }) {\n *   const { iframeProps, isReady, submit } = useCaptelloWebview({\n *     embedUrl: {\n *       baseUrl: \"https://capture.captello.com\",\n *       eventWebAccessToken: token,\n *       mode: FormMode.Submit,\n *       launcher: LauncherType.EventGenWeb,\n *     },\n *     onSubmissionBody: (m) => onSubmitted(m.data),\n *   });\n *   return (\n *     <>\n *       {!isReady && <Spinner />}\n *       <iframe {...iframeProps} title=\"UlcForm\" allow=\"camera; microphone\" />\n *       <button onClick={submit}>Submit</button>\n *     </>\n *   );\n * }\n */\n\nimport { useCallback, useEffect, useRef, useState, type RefCallback } from \"react\";\n\nimport { CaptelloWebview } from \"./client\";\nimport type { CaptelloWebviewOptions, Unsubscribe } from \"./client\";\nimport { buildEmbedUrl } from \"./embed-url\";\nimport type { EmbedUrlOptions } from \"./embed-url\";\nimport { OutboundMessageType } from \"./messages\";\nimport type {\n    OutboundMessage,\n    OutboundMessageMap,\n    PrefillInfoItem,\n    SubmissionBody,\n    SubmissionPrefill,\n    ValidationTarget,\n} from \"./messages\";\n\n/** Per-message-type callback props accepted by {@link useCaptelloWebview}. */\nexport interface CaptelloWebviewCallbacks {\n    onFormLoadComplete?: (message: OutboundMessageMap[OutboundMessageType.FormLoadComplete]) => void;\n    onFormErrorMessage?: (message: OutboundMessageMap[OutboundMessageType.FormErrorMessage]) => void;\n    onSubmissionBody?: (message: OutboundMessageMap[OutboundMessageType.SubmissionBody]) => void;\n    onFormSubmitSuccess?: (message: OutboundMessageMap[OutboundMessageType.FormSubmitSuccess]) => void;\n    onConnexionsProfileRedirect?: (message: OutboundMessageMap[OutboundMessageType.ConnexionsProfileRedirect]) => void;\n    onConnexionsDownloadVcard?: (message: OutboundMessageMap[OutboundMessageType.ConnexionsDownloadVcard]) => void;\n    /** Catch-all: called for every outbound message, after the specific handler above. */\n    onAnyMessage?: (message: OutboundMessage) => void;\n}\n\n/** Embed-URL config: a base URL plus {@link EmbedUrlOptions}. */\nexport interface EmbedUrlConfig extends EmbedUrlOptions {\n    /**\n     * The capture **origin**, e.g. `\"https://capture.captello.com\"`. The SDK appends the\n     * capture path for you, so the origin, a trailing slash, or the full\n     * `…/capture/submission` URL all work — see {@link buildEmbedUrl}.\n     */\n    baseUrl: string;\n}\n\n/**\n * Options for {@link useCaptelloWebview}.\n *\n * Provide **either** `embedUrl` (the hook builds the URL and derives `targetOrigin`,\n * returning `iframeProps.src`) **or** your own `targetOrigin` (you set the iframe `src`\n * yourself). Plus message callbacks and the usual client options.\n */\nexport interface UseCaptelloWebviewOptions extends CaptelloWebviewOptions, CaptelloWebviewCallbacks {\n    /** Build the iframe URL and derive `targetOrigin` from it. Sets `iframeProps.src`. */\n    embedUrl?: EmbedUrlConfig;\n}\n\n/** Readiness of the embedded form. */\nexport type CaptelloWebviewStatus = \"loading\" | \"ready\" | \"error\";\n\n/** Props to spread onto the `<iframe>`. `src` is present only when `embedUrl` is given. */\nexport interface CaptelloIframeProps {\n    ref: RefCallback<HTMLIFrameElement | null>;\n    src?: string;\n}\n\n/** What {@link useCaptelloWebview} returns. */\nexport interface UseCaptelloWebviewResult {\n    /** Spread onto your iframe: `<iframe {...iframeProps} />`. Includes `src` if `embedUrl` was given. */\n    iframeProps: CaptelloIframeProps;\n    /** The iframe ref callback (same as `iframeProps.ref`), if you'd rather set `src` yourself. */\n    ref: RefCallback<HTMLIFrameElement | null>;\n    /** `true` once the form has reported `form_load_complete`. */\n    isReady: boolean;\n    /** `\"loading\"` → `\"ready\"`; flips to `\"error\"` if a `form_error_message` arrives. */\n    status: CaptelloWebviewStatus;\n    /** The live client, or `null` before the iframe mounts. For escape-hatch use. */\n    getClient: () => CaptelloWebview | null;\n    submit: () => void;\n    reset: () => void;\n    updateDraft: () => void;\n    triggerValidation: (target: ValidationTarget) => void;\n    prefillInfo: (info: PrefillInfoItem[]) => void;\n    prefillSubmission: (submission: SubmissionPrefill) => void;\n    prefillSubmissionAndInfo: (data: { submission?: SubmissionPrefill; info?: PrefillInfoItem[] }) => void;\n    submitAndWait: (timeoutMs?: number) => Promise<SubmissionBody>;\n}\n\nconst CALLBACK_BY_TYPE: Record<OutboundMessageType, keyof CaptelloWebviewCallbacks> = {\n    [OutboundMessageType.FormLoadComplete]: \"onFormLoadComplete\",\n    [OutboundMessageType.FormErrorMessage]: \"onFormErrorMessage\",\n    [OutboundMessageType.SubmissionBody]: \"onSubmissionBody\",\n    [OutboundMessageType.FormSubmitSuccess]: \"onFormSubmitSuccess\",\n    [OutboundMessageType.ConnexionsProfileRedirect]: \"onConnexionsProfileRedirect\",\n    [OutboundMessageType.ConnexionsDownloadVcard]: \"onConnexionsDownloadVcard\",\n};\n\n/**\n * Binds a {@link CaptelloWebview} to an iframe's lifecycle. See the module doc for usage.\n */\nexport function useCaptelloWebview(options: UseCaptelloWebviewOptions): UseCaptelloWebviewResult {\n    const { embedUrl, matchSource, queueUntilReady, hostWindow } = options;\n\n    // Resolve the URL + the targetOrigin to use. embedUrl wins; otherwise use the\n    // explicit targetOrigin. Recompute only when the URL-affecting inputs change.\n    const src = embedUrl ? buildEmbedUrl(embedUrl.baseUrl, embedUrl) : undefined;\n    const targetOrigin = src ? new URL(src).origin : options.targetOrigin;\n\n    // Latest options/callbacks, read fresh inside listeners so callers needn't memoize.\n    const optionsRef = useRef(options);\n    optionsRef.current = options;\n\n    const clientRef = useRef<CaptelloWebview | null>(null);\n    const frameRef = useRef<HTMLIFrameElement | null>(null);\n    const teardown = useRef<(() => void) | null>(null);\n\n    const [status, setStatus] = useState<CaptelloWebviewStatus>(\"loading\");\n\n    const attach = useCallback(\n        (frame: HTMLIFrameElement | null) => {\n            // Tear down any previous client (ref changed or unmounting).\n            teardown.current?.();\n            teardown.current = null;\n            clientRef.current = null;\n            frameRef.current = frame;\n            setStatus(\"loading\");\n\n            if (!frame) return;\n\n            const client = new CaptelloWebview(frame, {\n                targetOrigin,\n                hostWindow: optionsRef.current.hostWindow,\n                matchSource: optionsRef.current.matchSource,\n                queueUntilReady: optionsRef.current.queueUntilReady,\n            });\n            clientRef.current = client;\n\n            const offs: Unsubscribe[] = [];\n            for (const type of Object.values(OutboundMessageType)) {\n                offs.push(\n                    client.on(type, (message) => {\n                        if (type === OutboundMessageType.FormLoadComplete) setStatus(\"ready\");\n                        else if (type === OutboundMessageType.FormErrorMessage) setStatus(\"error\");\n\n                        const handler = optionsRef.current[CALLBACK_BY_TYPE[type]] as\n                            | ((m: typeof message) => void)\n                            | undefined;\n                        handler?.(message);\n                        optionsRef.current.onAnyMessage?.(message);\n                    }),\n                );\n            }\n\n            teardown.current = () => {\n                for (const off of offs) off();\n                client.destroy();\n            };\n        },\n        // Re-create the client only when connection-level inputs change.\n        // Callbacks are read via optionsRef, so they intentionally aren't deps.\n        [targetOrigin, matchSource, queueUntilReady, hostWindow],\n    );\n\n    useEffect(() => {\n        if (frameRef.current) attach(frameRef.current);\n        return () => {\n            teardown.current?.();\n            teardown.current = null;\n            clientRef.current = null;\n        };\n    }, [attach]);\n\n    const getClient = useCallback(() => clientRef.current, []);\n\n    const submit = useCallback(() => clientRef.current?.submit(), []);\n    const reset = useCallback(() => clientRef.current?.reset(), []);\n    const updateDraft = useCallback(() => clientRef.current?.updateDraft(), []);\n    const triggerValidation = useCallback(\n        (target: ValidationTarget) => clientRef.current?.triggerValidation(target),\n        [],\n    );\n    const prefillInfo = useCallback((info: PrefillInfoItem[]) => clientRef.current?.prefillInfo(info), []);\n    const prefillSubmission = useCallback(\n        (submission: SubmissionPrefill) => clientRef.current?.prefillSubmission(submission),\n        [],\n    );\n    const prefillSubmissionAndInfo = useCallback(\n        (data: { submission?: SubmissionPrefill; info?: PrefillInfoItem[] }) =>\n            clientRef.current?.prefillSubmissionAndInfo(data),\n        [],\n    );\n    const submitAndWait = useCallback((timeoutMs?: number) => {\n        const client = clientRef.current;\n        if (!client) {\n            return Promise.reject(new Error(\"CaptelloWebview: iframe is not mounted yet.\"));\n        }\n        return client.submitAndWait(timeoutMs);\n    }, []);\n\n    const iframeProps: CaptelloIframeProps = src ? { ref: attach, src } : { ref: attach };\n\n    return {\n        iframeProps,\n        ref: attach,\n        isReady: status === \"ready\",\n        status,\n        getClient,\n        submit,\n        reset,\n        updateDraft,\n        triggerValidation,\n        prefillInfo,\n        prefillSubmission,\n        prefillSubmissionAndInfo,\n        submitAndWait,\n    };\n}\n\nexport { CaptelloWebview, SubmissionError, SubmissionTimeoutError } from \"./client\";\nexport type { Unsubscribe } from \"./client\";\n"]}

package/package.json

@@ -1,12 +1,11 @@
 {
     "name": "@captello/ulc-webview-sdk",
-    "version": "0.1.0",
+    "version": "0.2.0",
     "description": "Typed SDK for embedding the Captello capture webview: message protocol, host client, and embed-URL builder.",
     "author": "Lead Liaison",
     "license": "MIT",
     "type": "module",
     "sideEffects": false,
-    "main": "./dist/index.cjs",
     "module": "./dist/index.js",
     "types": "./dist/index.d.ts",
     "typesVersions": {
@@ -22,18 +21,15 @@
     "exports": {
         ".": {
             "types": "./dist/index.d.ts",
-            "import": "./dist/index.js",
-            "require": "./dist/index.cjs"
+            "import": "./dist/index.js"
         },
         "./promises": {
             "types": "./dist/promises.d.ts",
-            "import": "./dist/promises.js",
-            "require": "./dist/promises.cjs"
+            "import": "./dist/promises.js"
         },
         "./react": {
             "types": "./dist/react.d.ts",
-            "import": "./dist/react.js",
-            "require": "./dist/react.cjs"
+            "import": "./dist/react.js"
         },
         "./package.json": "./package.json"
     },

package/dist/chunk-ZMYMZK2A.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/messages.ts","../src/client.ts"],"names":["OutboundMessageType","InboundMessageType","PrefillDataType"],"mappings":"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","file":"chunk-ZMYMZK2A.js","sourcesContent":["/**\n * The message protocol exchanged between the Captello capture webview (the iframe)\n * and its host page.\n *\n * Wire format (this is the contract — match it exactly):\n * - Every message is a JSON **string**. The webview sends outbound messages with\n *   `JSON.stringify(message)` and reads inbound messages with `JSON.parse(event.data)`.\n *   A host that posts a raw object instead of a string will be ignored, because the\n *   webview's parser produces a non-object and bails.\n * - Every message is an object with a `type` discriminator. Inbound and outbound\n *   types are disjoint string enums.\n *\n * Direction is named from the **webview's** point of view:\n * - {@link OutboundMessageType}: webview → host (the host listens for these).\n * - {@link InboundMessageType}: host → webview (the host sends these).\n */\n\nimport type { VisibleSubmissionDataItem } from \"./submission-data\";\n\n/* ------------------------------------------------------------------ *\n * Outbound: webview → host\n * ------------------------------------------------------------------ */\n\n/** Message `type` values the webview emits to its host. */\nexport enum OutboundMessageType {\n    /** The form finished loading and rendering. Safe to interact with it after this. */\n    FormLoadComplete = \"form_load_complete\",\n    /** A user-facing error occurred; `data` is the translated, display-ready message. */\n    FormErrorMessage = \"form_error_message\",\n    /**\n     * Emitted for embedded forms instead of submitting directly: `data` is the full\n     * submission body for the host to persist/forward.\n     */\n    SubmissionBody = \"submission_body\",\n    /** The form was submitted successfully (used in kiosk / quick-capture flows). */\n    FormSubmitSuccess = \"form_submit_success\",\n    /** Connexions: the host should perform the profile redirect (embed mode). */\n    ConnexionsProfileRedirect = \"connexions_profile_redirect\",\n    /** Connexions: the host should trigger the vCard download (embed mode). */\n    ConnexionsDownloadVcard = \"connexions_download_vcard\",\n}\n\n/**\n * Opaque submission payload carried by {@link OutboundMessageType.SubmissionBody}.\n *\n * This mirrors the webview's internal `FormSubmission` model. It is intentionally\n * typed as an open record here so the SDK stays decoupled from the app's full model\n * graph; the documented fields below are stable, the rest are passed through as-is.\n * Host code that needs the deep element-value types should treat `data` as untyped\n * and key it by element id (e.g. `\"element_12\"`, `\"element_12_3\"`).\n */\nexport interface SubmissionBody {\n    id: number;\n    form_id: number;\n    prospect_id: number;\n    email: string;\n    first_name: string;\n    last_name: string;\n    full_name: string;\n    company: string;\n    phone: string;\n    /** Submitted values keyed by element id / sub-element id. */\n    data: Record<string, unknown>;\n    /**\n     * Visible, filled elements ready to render as key/value rows — one item per\n     * element, discriminated by `element_type`. Use {@link parseVisibleSubmissionsData}\n     * or {@link toDisplayPairs} to consume it. May be absent on older webview builds.\n     */\n    visible_submissions_data?: VisibleSubmissionDataItem[];\n    submission_date: string;\n    /** Query-string params the webview was loaded with, echoed back on submit. */\n    query_parameters?: Record<string, string>;\n    /** Additional fields from the webview's submission model are passed through verbatim. */\n    [key: string]: unknown;\n}\n\n/**\n * Loose submission shape accepted when **pre-filling** the form (host → webview).\n *\n * Distinct from {@link SubmissionBody}: a received `submission_body` is always fully\n * populated, but when pre-filling you typically either round-trip a previously-received\n * body or pass a partial object assembled from your own data. A {@link SubmissionBody}\n * is assignable to this, so round-tripping just works.\n */\nexport interface SubmissionPrefill {\n    /** Submitted values keyed by element id / sub-element id. */\n    data?: Record<string, unknown>;\n    [key: string]: unknown;\n}\n\ninterface FormLoadCompleteMessage {\n    type: OutboundMessageType.FormLoadComplete;\n}\ninterface FormSubmitSuccessMessage {\n    type: OutboundMessageType.FormSubmitSuccess;\n}\ninterface FormErrorMessageMessage {\n    type: OutboundMessageType.FormErrorMessage;\n    /** Translated, display-ready error text. */\n    data: string;\n}\ninterface SubmissionBodyMessage {\n    type: OutboundMessageType.SubmissionBody;\n    data: SubmissionBody;\n}\ninterface ConnexionsProfileRedirectMessage {\n    type: OutboundMessageType.ConnexionsProfileRedirect;\n}\ninterface ConnexionsDownloadVcardMessage {\n    type: OutboundMessageType.ConnexionsDownloadVcard;\n}\n\n/** Discriminated union of every message the webview can emit to its host. */\nexport type OutboundMessage =\n    | FormLoadCompleteMessage\n    | FormSubmitSuccessMessage\n    | FormErrorMessageMessage\n    | SubmissionBodyMessage\n    | ConnexionsProfileRedirectMessage\n    | ConnexionsDownloadVcardMessage;\n\n/** Maps each outbound `type` to its full message shape (used by the client's `.on`). */\nexport type OutboundMessageMap = {\n    [M in OutboundMessage as M[\"type\"]]: M;\n};\n\n/* ------------------------------------------------------------------ *\n * Inbound: host → webview\n * ------------------------------------------------------------------ */\n\n/** Message `type` values the host sends into the webview. */\nexport enum InboundMessageType {\n    /** Programmatically trigger form submission (as if the user pressed submit). */\n    Submit = \"submit_form\",\n    /** Reset the form, clearing all entered values. */\n    Reset = \"reset_form\",\n    /** Pre-fill the form with existing data. See {@link PrefillDataType}. */\n    FormPrefill = \"form_prefill\",\n    /** Switch the current submission into draft-update mode. */\n    UpdateDraft = \"update_draft\",\n    /** Run validation against a target field (or the whole form). */\n    TriggerValidation = \"trigger_validation\",\n}\n\n/** Shape selector for {@link InboundMessageType.FormPrefill} payloads. */\nexport enum PrefillDataType {\n    /** `data` is a full ULC submission (the webview's submission model). */\n    UlcSubmission = \"ulc_submission\",\n    /** `data` is a list of transcription field/value items. */\n    Info = \"info\",\n    /** `data` is `{ submission, info }` — a submission plus transcription items. */\n    UlcSubmissionAndInfo = \"ulc_submission_and_info\",\n}\n\n/** Targets for {@link InboundMessageType.TriggerValidation}. */\nexport type ValidationTarget = \"invitation_code\" | \"email\" | \"all\";\n\n/**\n * A single transcription field/value item used by {@link PrefillDataType.Info}.\n *\n * The webview matches each item to a form element by `ll_field_unique_identifier`\n * alone (e.g. `\"FirstName\"`, `\"Email\"`); `ll_field_id` is catalog metadata and is not\n * used for matching, so it is accepted as either a number or a string. `value` is\n * typically a string but may be a boolean (e.g. the PII opt-out field).\n */\nexport interface PrefillInfoItem {\n    ll_field_unique_identifier: string;\n    ll_field_id?: string | number;\n    value: string | boolean;\n}\n\ninterface SubmitMessage {\n    type: InboundMessageType.Submit;\n}\ninterface ResetMessage {\n    type: InboundMessageType.Reset;\n}\ninterface UpdateDraftMessage {\n    type: InboundMessageType.UpdateDraft;\n}\ninterface TriggerValidationMessage {\n    type: InboundMessageType.TriggerValidation;\n    target: ValidationTarget;\n}\ninterface PrefillSubmissionMessage {\n    type: InboundMessageType.FormPrefill;\n    data_type: PrefillDataType.UlcSubmission;\n    /** A submission body to pre-fill from (a received {@link SubmissionBody} or a partial). */\n    data: SubmissionPrefill;\n}\ninterface PrefillInfoMessage {\n    type: InboundMessageType.FormPrefill;\n    data_type: PrefillDataType.Info;\n    data: PrefillInfoItem[];\n}\ninterface PrefillSubmissionAndInfoMessage {\n    type: InboundMessageType.FormPrefill;\n    data_type: PrefillDataType.UlcSubmissionAndInfo;\n    data: { submission?: SubmissionPrefill; info?: PrefillInfoItem[] };\n}\n\n/** Discriminated union of every message the host can send into the webview. */\nexport type InboundMessage =\n    | SubmitMessage\n    | ResetMessage\n    | UpdateDraftMessage\n    | TriggerValidationMessage\n    | PrefillSubmissionMessage\n    | PrefillInfoMessage\n    | PrefillSubmissionAndInfoMessage;\n\n/* ------------------------------------------------------------------ *\n * Runtime guards / parsing\n * ------------------------------------------------------------------ */\n\nconst OUTBOUND_TYPES: ReadonlySet<string> = new Set(Object.values(OutboundMessageType));\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n    return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Parses a raw `MessageEvent.data` value into a typed {@link OutboundMessage}, or\n * returns `null` if it is not a recognized Captello webview message.\n *\n * Accepts either a JSON string (the webview always sends strings) or an\n * already-parsed object, so it is robust to hosts/proxies that pre-parse.\n */\nexport function parseOutboundMessage(data: unknown): OutboundMessage | null {\n    let value: unknown = data;\n    if (typeof value === \"string\") {\n        try {\n            value = JSON.parse(value);\n        } catch {\n            return null;\n        }\n    }\n    if (!isPlainObject(value)) return null;\n    if (typeof value[\"type\"] !== \"string\" || !OUTBOUND_TYPES.has(value[\"type\"])) return null;\n    return value as unknown as OutboundMessage;\n}\n","import { InboundMessageType, OutboundMessageType, parseOutboundMessage, PrefillDataType } from \"./messages\";\nimport type {\n    InboundMessage,\n    OutboundMessage,\n    OutboundMessageMap,\n    PrefillInfoItem,\n    SubmissionBody,\n    SubmissionPrefill,\n    ValidationTarget,\n} from \"./messages\";\n\n/** Listener for a specific outbound message type. */\nexport type OutboundListener<T extends OutboundMessageType> = (message: OutboundMessageMap[T]) => void;\n\n/** Listener for every outbound message (used by {@link CaptelloWebview.onAny}). */\nexport type AnyOutboundListener = (message: OutboundMessage) => void;\n\n/** Unsubscribe handle returned by every `on*` method. Calling it removes the listener. */\nexport type Unsubscribe = () => void;\n\n/**\n * Rejection reason from {@link CaptelloWebview.submitAndWait} when the webview reports\n * a `form_error_message`. `message` is the translated, display-ready text.\n */\nexport class SubmissionError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"SubmissionError\";\n    }\n}\n\n/**\n * Rejection reason from {@link CaptelloWebview.submitAndWait} when no `submission_body`\n * or `form_error_message` arrives within the timeout.\n */\nexport class SubmissionTimeoutError extends Error {\n    constructor(public readonly timeoutMs: number) {\n        super(`Captello webview did not respond to submit within ${timeoutMs}ms.`);\n        this.name = \"SubmissionTimeoutError\";\n    }\n}\n\nexport interface CaptelloWebviewOptions {\n    /**\n     * Origin to validate incoming messages against and to target outgoing messages.\n     * Strongly recommended — set it to the webview's origin (e.g.\n     * `\"https://capture.captello.com\"`). Use {@link targetOriginFromUrl} to derive it\n     * from the embed URL.\n     *\n     * Defaults to `\"*\"`, which accepts messages from any origin and posts without an\n     * origin check. Only acceptable for trusted/local development.\n     */\n    targetOrigin?: string;\n    /**\n     * The window to attach the `message` listener to. Defaults to the global `window`.\n     * Override for testing or non-standard host environments.\n     */\n    hostWindow?: Window;\n    /**\n     * If `true` (default), incoming messages are accepted only when they originate\n     * from the bound iframe's `contentWindow`. Set `false` only if the webview relays\n     * messages through an intermediate window and source matching is impossible.\n     */\n    matchSource?: boolean;\n    /**\n     * If `true` (default), messages sent before the webview reports\n     * `form_load_complete` are buffered and flushed, in order, once it's ready. This\n     * removes a common footgun: calling `prefillInfo(...)` right after mount would\n     * otherwise post to a form that isn't listening yet and be silently dropped.\n     *\n     * Set `false` to send immediately (the legacy behavior). Note: a client that\n     * attaches *after* the form already loaded will not have seen `form_load_complete`,\n     * so its queued messages won't flush — create the client with the iframe.\n     */\n    queueUntilReady?: boolean;\n}\n\n/** Emits a console warning in development builds only. No-op in production / no bundler. */\nfunction devWarn(message: string): void {\n    try {\n        if (typeof process !== \"undefined\" && process.env && process.env.NODE_ENV !== \"production\") {\n            // eslint-disable-next-line no-console\n            console.warn(message);\n        }\n    } catch {\n        /* `process` not defined (pure browser, no bundler define) → stay silent */\n    }\n}\n\ntype ElementOrFrame = HTMLIFrameElement | { contentWindow: Window | null };\n\n/**\n * Host-side controller for an embedded Captello capture webview.\n *\n * Wraps a single `<iframe>` and encodes the full message protocol:\n * - **Receiving** (webview → host): subscribe with {@link on} / {@link onAny}.\n * - **Sending** (host → webview): use {@link submit}, {@link reset}, {@link prefill},\n *   {@link triggerValidation}, {@link updateDraft}, or the lower-level {@link send}.\n *\n * Wire details handled for you: outgoing messages are `JSON.stringify`'d (the webview\n * parses inbound data with `JSON.parse`, so a raw object would be ignored), and\n * incoming messages are validated by origin + source before being parsed.\n *\n * @example\n * ```ts\n * const iframe = document.querySelector(\"iframe\")!;\n * const webview = new CaptelloWebview(iframe, {\n *   targetOrigin: \"https://capture.captello.com\",\n * });\n *\n * webview.on(OutboundMessageType.FormLoadComplete, () => console.log(\"ready\"));\n * webview.on(OutboundMessageType.SubmissionBody, (msg) => save(msg.data));\n *\n * // later, drive the form:\n * webview.submit();\n *\n * // on teardown:\n * webview.destroy();\n * ```\n */\nexport class CaptelloWebview {\n    private readonly frame: ElementOrFrame;\n    private readonly targetOrigin: string;\n    private readonly hostWindow: Window;\n    private readonly matchSource: boolean;\n\n    private readonly listeners = new Map<OutboundMessageType, Set<OutboundListener<OutboundMessageType>>>();\n    private readonly anyListeners = new Set<AnyOutboundListener>();\n    private readonly boundHandler: (event: MessageEvent) => void;\n    private destroyed = false;\n\n    private readonly queueUntilReady: boolean;\n    /** True once `form_load_complete` has been observed. */\n    private ready = false;\n    /** Messages sent before ready, flushed in order on load. */\n    private readonly outbox: InboundMessage[] = [];\n\n    constructor(frame: ElementOrFrame, options: CaptelloWebviewOptions = {}) {\n        if (!frame) {\n            throw new Error(\"CaptelloWebview: an iframe element (or { contentWindow }) is required.\");\n        }\n        this.frame = frame;\n        this.targetOrigin = options.targetOrigin ?? \"*\";\n        this.matchSource = options.matchSource ?? true;\n        this.queueUntilReady = options.queueUntilReady ?? true;\n\n        const hostWindow = options.hostWindow ?? (typeof window !== \"undefined\" ? window : undefined);\n        if (!hostWindow) {\n            throw new Error(\n                \"CaptelloWebview: no host window available. Pass `hostWindow` when constructing outside a browser.\",\n            );\n        }\n        this.hostWindow = hostWindow;\n\n        this.boundHandler = (event: MessageEvent) => this.handleMessage(event);\n        this.hostWindow.addEventListener(\"message\", this.boundHandler);\n    }\n\n    /** `true` once the webview has reported `form_load_complete`. */\n    get isReady(): boolean {\n        return this.ready;\n    }\n\n    /* -------------------------------------------------------------- *\n     * Receiving (webview → host)\n     * -------------------------------------------------------------- */\n\n    /**\n     * Subscribe to a single outbound message type. Returns an unsubscribe function.\n     *\n     * @example webview.on(OutboundMessageType.FormErrorMessage, (m) => toast(m.data));\n     */\n    on<T extends OutboundMessageType>(type: T, listener: OutboundListener<T>): Unsubscribe {\n        let set = this.listeners.get(type);\n        if (!set) {\n            set = new Set();\n            this.listeners.set(type, set);\n        }\n        set.add(listener as OutboundListener<OutboundMessageType>);\n        return () => {\n            set?.delete(listener as OutboundListener<OutboundMessageType>);\n        };\n    }\n\n    /**\n     * Subscribe once: the listener is removed automatically after it fires the first\n     * time for `type`. Returns an unsubscribe function for cancelling early.\n     */\n    once<T extends OutboundMessageType>(type: T, listener: OutboundListener<T>): Unsubscribe {\n        const off = this.on(type, (message) => {\n            off();\n            listener(message);\n        });\n        return off;\n    }\n\n    /** Subscribe to every outbound message regardless of type. Returns an unsubscribe function. */\n    onAny(listener: AnyOutboundListener): Unsubscribe {\n        this.anyListeners.add(listener);\n        return () => {\n            this.anyListeners.delete(listener);\n        };\n    }\n\n    /* -------------------------------------------------------------- *\n     * Sending (host → webview)\n     * -------------------------------------------------------------- */\n\n    /**\n     * Low-level send: posts any inbound message to the webview as a JSON string.\n     * Prefer the typed helpers below; use this only for forward-compatibility.\n     *\n     * When `queueUntilReady` is enabled (the default) and the form hasn't reported\n     * `form_load_complete` yet, the message is buffered and flushed on load instead of\n     * posted immediately.\n     *\n     * @throws if the iframe's `contentWindow` is not available (not yet loaded /\n     *   detached) and the message can't be queued.\n     */\n    send(message: InboundMessage): void {\n        if (this.destroyed) {\n            throw new Error(\"CaptelloWebview: cannot send after destroy().\");\n        }\n        if (this.queueUntilReady && !this.ready) {\n            this.outbox.push(message);\n            return;\n        }\n        this.postNow(message);\n    }\n\n    /** Posts a message immediately, bypassing the ready-queue. */\n    private postNow(message: InboundMessage): void {\n        const target = this.frame.contentWindow;\n        if (!target) {\n            throw new Error(\n                \"CaptelloWebview: iframe.contentWindow is null. Wait for the iframe to load before sending.\",\n            );\n        }\n        // The webview reads inbound data with JSON.parse(event.data), so it must be a string.\n        target.postMessage(JSON.stringify(message), this.targetOrigin);\n    }\n\n    /** Marks the client ready and flushes any queued messages, in order. */\n    private markReadyAndFlush(): void {\n        if (this.ready) return;\n        this.ready = true;\n        const queued = this.outbox.splice(0);\n        for (const message of queued) {\n            try {\n                this.postNow(message);\n            } catch {\n                /* iframe detached between load and flush — drop silently */\n            }\n        }\n    }\n\n    /** Programmatically submit the form (fire-and-forget). */\n    submit(): void {\n        this.send({ type: InboundMessageType.Submit });\n    }\n\n    /**\n     * Submit the form and await the outcome.\n     *\n     * Sends `submit_form`, then resolves with the {@link SubmissionBody} when the\n     * webview emits `submission_body`, or rejects with a {@link SubmissionError}\n     * (carrying the translated message) when it emits `form_error_message`. Rejects\n     * with a {@link SubmissionTimeoutError} if neither arrives within `timeoutMs`.\n     *\n     * This is the typed, leak-free version of the common \"click submit, wait for the\n     * result\" flow — listeners are always cleaned up, including on timeout.\n     *\n     * @param timeoutMs how long to wait before giving up. Defaults to 60_000.\n     * @example\n     * try {\n     *   const body = await webview.submitAndWait();\n     *   await persist(body);\n     * } catch (err) {\n     *   if (err instanceof SubmissionError) showToast(err.message);\n     * }\n     */\n    submitAndWait(timeoutMs = 60_000): Promise<SubmissionBody> {\n        return new Promise<SubmissionBody>((resolve, reject) => {\n            let settled = false;\n            let timer: ReturnType<typeof setTimeout> | undefined;\n\n            const cleanup = () => {\n                settled = true;\n                offSuccess();\n                offError();\n                if (timer !== undefined) clearTimeout(timer);\n            };\n\n            const offSuccess = this.on(OutboundMessageType.SubmissionBody, (message) => {\n                if (settled) return;\n                cleanup();\n                resolve(message.data);\n            });\n            const offError = this.on(OutboundMessageType.FormErrorMessage, (message) => {\n                if (settled) return;\n                cleanup();\n                reject(new SubmissionError(message.data));\n            });\n\n            if (timeoutMs > 0 && timeoutMs !== Infinity) {\n                timer = setTimeout(() => {\n                    if (settled) return;\n                    cleanup();\n                    reject(new SubmissionTimeoutError(timeoutMs));\n                }, timeoutMs);\n            }\n\n            try {\n                this.send({ type: InboundMessageType.Submit });\n            } catch (err) {\n                if (!settled) {\n                    cleanup();\n                    reject(err);\n                }\n            }\n        });\n    }\n\n    /** Reset the form, clearing all entered values. */\n    reset(): void {\n        this.send({ type: InboundMessageType.Reset });\n    }\n\n    /** Switch the current submission into draft-update mode. */\n    updateDraft(): void {\n        this.send({ type: InboundMessageType.UpdateDraft });\n    }\n\n    /** Run validation against a target field, or `\"all\"` for the whole form. */\n    triggerValidation(target: ValidationTarget): void {\n        this.send({ type: InboundMessageType.TriggerValidation, target });\n    }\n\n    /** Pre-fill the form from a submission body (a received body or a partial). */\n    prefillSubmission(submission: SubmissionPrefill): void {\n        this.send({\n            type: InboundMessageType.FormPrefill,\n            data_type: PrefillDataType.UlcSubmission,\n            data: submission,\n        });\n    }\n\n    /** Pre-fill the form from a list of transcription field/value items. */\n    prefillInfo(info: PrefillInfoItem[]): void {\n        this.send({\n            type: InboundMessageType.FormPrefill,\n            data_type: PrefillDataType.Info,\n            data: info,\n        });\n    }\n\n    /** Pre-fill the form from a submission plus transcription items. */\n    prefillSubmissionAndInfo(data: { submission?: SubmissionPrefill; info?: PrefillInfoItem[] }): void {\n        this.send({\n            type: InboundMessageType.FormPrefill,\n            data_type: PrefillDataType.UlcSubmissionAndInfo,\n            data,\n        });\n    }\n\n    /* -------------------------------------------------------------- *\n     * Lifecycle\n     * -------------------------------------------------------------- */\n\n    /** Remove the `message` listener and drop all subscriptions. Idempotent. */\n    destroy(): void {\n        if (this.destroyed) return;\n        this.destroyed = true;\n        this.hostWindow.removeEventListener(\"message\", this.boundHandler);\n        this.listeners.clear();\n        this.anyListeners.clear();\n        this.outbox.length = 0;\n    }\n\n    /* -------------------------------------------------------------- *\n     * Internals\n     * -------------------------------------------------------------- */\n\n    private handleMessage(event: MessageEvent): void {\n        if (this.destroyed) return;\n\n        // Origin check: skip when targetOrigin is the wildcard. Warn (dev only) if a\n        // message that *looks* like ours is dropped on origin — a common \"why isn't my\n        // listener firing?\" cause.\n        if (this.targetOrigin !== \"*\" && event.origin !== this.targetOrigin) {\n            if (parseOutboundMessage(event.data)) {\n                devWarn(\n                    `[captello-sdk] Ignored a Captello message from origin \"${event.origin}\" ` +\n                        `(expected \"${this.targetOrigin}\"). Check the targetOrigin you passed.`,\n                );\n            }\n            return;\n        }\n\n        // Source check: only accept messages from the bound iframe's window.\n        if (this.matchSource) {\n            const expected = this.frame.contentWindow;\n            if (expected && event.source !== expected) {\n                if (parseOutboundMessage(event.data)) {\n                    devWarn(\n                        \"[captello-sdk] Ignored a Captello message from an unexpected source window \" +\n                            \"(not the bound iframe). If the webview relays through another window, set matchSource: false.\",\n                    );\n                }\n                return;\n            }\n        }\n\n        const message = parseOutboundMessage(event.data);\n        if (!message) return;\n\n        // Flip to ready (and flush queued sends) the moment the form loads, before\n        // dispatching to listeners — so a listener can send and have it post immediately.\n        if (message.type === OutboundMessageType.FormLoadComplete) {\n            this.markReadyAndFlush();\n        }\n\n        const set = this.listeners.get(message.type);\n        if (set) {\n            // Copy to a snapshot so a listener that unsubscribes mid-dispatch is safe.\n            for (const listener of [...set]) listener(message);\n        }\n        if (this.anyListeners.size) {\n            for (const listener of [...this.anyListeners]) listener(message);\n        }\n    }\n}\n"]}