@captello/ulc-webview-sdk 0.4.0 → 0.5.0

package/README.md

@@ -105,14 +105,83 @@ try {
 
 ## React — `@captello/ulc-webview-sdk/react`
 
-The React adapter is the smoothest way to integrate. `useCaptelloWebview` owns a
-`CaptelloWebview` for the iframe's lifetime: it builds the embed URL, creates the client
-when the iframe mounts, wires outbound messages to typed callbacks, tracks readiness,
-and destroys the client on unmount. You get back `iframeProps` to spread, an `isReady`
-flag, and stable senders — so a typical form is just the hook plus an `<iframe>`.
+The React adapter is the smoothest way to integrate, in two flavors:
+
+- **`<CaptelloForm>`** — a turnkey component. Drop it in with an `embedUrl` and message
+  callbacks; it renders the `<iframe>`, shows your loading / error overlays, and forwards
+  the senders on a `ref`. The shortest path.
+- **`useCaptelloWebview`** — the underlying hook, for when you'd rather own the markup.
+
+Both own one `CaptelloWebview` for the iframe's lifetime: they build the embed URL, create
+the client when the iframe mounts, wire outbound messages to typed callbacks, track
+readiness, and destroy the client on unmount.
 
 `react` is an optional peer dependency (React 18+).
 
+### `<CaptelloForm>` — the turnkey component
+
+```tsx
+import { useRef } from "react";
+import { FormMode, LauncherType, ActionButtonPosition, type SubmissionBody } from "@captello/ulc-webview-sdk";
+import { CaptelloForm, type CaptelloFormHandle } from "@captello/ulc-webview-sdk/react";
+
+function UlcForm({
+    eventWebAccessToken,
+    onSubmitted,
+}: {
+    eventWebAccessToken: string;
+    onSubmitted: (body: SubmissionBody) => void;
+}) {
+    const form = useRef<CaptelloFormHandle>(null);
+
+    return (
+        <CaptelloForm
+            ref={form}
+            style={{ height: 600 }} // an iframe has no intrinsic height — size the form here
+            embedUrl={{
+                baseUrl: "https://capture.captello.com",
+                eventWebAccessToken,
+                actionButtonPosition: ActionButtonPosition.Hidden, // b=2
+                mode: FormMode.Submit,
+                launcher: LauncherType.EventGenWeb,
+            }}
+            onSubmissionBody={(m) => onSubmitted(m.data)}
+            loading={<Spinner />}
+            error={(message) => <ErrorBanner>{message}</ErrorBanner>}
+        >
+            {({ isReady }) => (
+                <button disabled={!isReady} onClick={() => form.current?.submit()}>
+                    Submit
+                </button>
+            )}
+        </CaptelloForm>
+    );
+}
+```
+
+Props are the hook options (`embedUrl` or `targetOrigin`, every message callback, and the
+client options) plus a few rendering conveniences:
+
+- **`className` / `style` / `id`** — applied to the wrapper element. Size the form here; the
+  iframe fills it.
+- **`iframeProps`** — attributes spread onto the `<iframe>` (`title`, `allow`, `sandbox`,
+  `name`, …). Defaults: `title="Captello form"`, `allow="camera; microphone; geolocation"`.
+  When you drive the URL yourself (no `embedUrl`), set `src` here.
+- **`loading`** — a node shown, centered over the iframe, until `form_load_complete`. The
+  iframe stays mounted underneath so it keeps loading.
+- **`error`** — a node (or `(message) => node`) shown when the form reports
+  `form_error_message`; the function form receives the translated, display-ready text.
+- **`children`** — inline controls rendered after the form. A function receives the live api
+  (status + senders), so a submit button needs no separate `ref`.
+- **`ref`** — a `CaptelloFormHandle`: the senders (`submit`, `reset`, `updateDraft`,
+  `triggerValidation`, `prefill`, `submitAndWait`) plus `status` / `isReady`, `getIframe()`,
+  and `getClient()`. Use it to drive the form from a parent without lifting state.
+
+### `useCaptelloWebview` — the hook
+
+Prefer to own the markup? The hook returns `iframeProps` to spread, an `isReady` flag, and
+stable senders — so a typical form is just the hook plus an `<iframe>`.
+
 ```tsx
 import { FormMode, LauncherType, ActionButtonPosition, type SubmissionBody } from "@captello/ulc-webview-sdk";
 import { useCaptelloWebview } from "@captello/ulc-webview-sdk/react";
@@ -124,7 +193,7 @@ function UlcForm({
     eventWebAccessToken: string;
     onSubmitted: (body: SubmissionBody) => void;
 }) {
-    const { iframeProps, isReady, submit, prefillInfo } = useCaptelloWebview({
+    const { iframeProps, isReady, submit, prefill } = useCaptelloWebview({
         embedUrl: {
             baseUrl: "https://capture.captello.com",
             eventWebAccessToken,
@@ -146,7 +215,7 @@ function UlcForm({
 }
 ```
 
-What the hook handles for you:
+What the hook (and the component built on it) handle for you:
 
 - **URL + origin.** Pass `embedUrl: { baseUrl, ...EmbedUrlOptions }` and the hook builds
   the URL, derives `targetOrigin`, and returns it as `iframeProps.src` — no separate
@@ -155,14 +224,14 @@ What the hook handles for you:
 - **Readiness.** `isReady` and `status` (`"loading" | "ready" | "error"`) — no manual
   `useState` + `onFormLoadComplete` for a spinner.
 - **Prefill timing.** Sends made before the form loads are queued and flushed on
-  `form_load_complete`, so you can `prefillInfo(...)` as soon as you have data — no
+  `form_load_complete`, so you can `prefill(...)` as soon as you have data — no
   gating on readiness, and no silently-dropped messages.
 - **No memoization.** Callbacks are read fresh via a ref, so inline arrow functions
   won't re-subscribe or re-create the client. The client is recreated only when
   `targetOrigin` (or `embedUrl`) / `hostWindow` / `matchSource` / `queueUntilReady` change.
-- **Stable senders** (`submit`, `reset`, `updateDraft`, `triggerValidation`,
-  `prefillInfo`, `prefillSubmission`, `prefillSubmissionAndInfo`, `submitAndWait`) — safe
-  in deps or passed to children. `getClient()` returns the live client for escape hatches.
+- **Stable senders** (`submit`, `reset`, `updateDraft`, `triggerValidation`, `prefill`,
+  `submitAndWait`) — safe in deps or passed to children. `getClient()` returns the live
+  client for escape hatches.
 
 ### Callback props
 
@@ -200,24 +269,26 @@ point of view.
 
 ### Inbound — host → webview (you send)
 
-| `type`               | Method                                                                                  | Notes                                              |
-| -------------------- | --------------------------------------------------------------------------------------- | -------------------------------------------------- |
-| `submit_form`        | `webview.submit()`                                                                      | Submit as if the user pressed the button.          |
-| `reset_form`         | `webview.reset()`                                                                       | Clear all entered values.                          |
-| `update_draft`       | `webview.updateDraft()`                                                                 | Switch to draft-update mode.                       |
-| `trigger_validation` | `webview.triggerValidation(target)`                                                     | `target`: `"email" \| "invitation_code" \| "all"`. |
-| `form_prefill`       | `webview.prefillSubmission(...)` / `prefillInfo(...)` / `prefillSubmissionAndInfo(...)` | Three payload shapes (see below).                  |
+| `type`               | Method                                    | Notes                                              |
+| -------------------- | ----------------------------------------- | -------------------------------------------------- |
+| `submit_form`        | `webview.submit()`                        | Submit as if the user pressed the button.          |
+| `reset_form`         | `webview.reset()`                         | Clear all entered values.                          |
+| `update_draft`       | `webview.updateDraft()`                   | Switch to draft-update mode.                       |
+| `trigger_validation` | `webview.triggerValidation(target)`       | `target`: `"email" \| "invitation_code" \| "all"`. |
+| `form_prefill`       | `webview.prefill({ submission?, info? })` | Submission body, transcription items, or both.     |
+
+### Prefill (`form_prefill`)
 
-### Prefill variants (`form_prefill`)
+A single `prefill({ submission?, info? })` carries either or both payloads:
 
-`form_prefill` carries a `data_type` selecting the payload shape:
+- `submission` — a `SubmissionPrefill` (a received `SubmissionBody` round-tripped, or a
+  partial `{ data?, ... }` you assemble).
+- `info` — a list of `PrefillInfoItem`. The webview matches each item by
+  `ll_field_unique_identifier` (e.g. `"FirstName"`, `"Email"`); `ll_field_id` is optional
+  metadata (number or string) and `value` may be a string or boolean.
 
-- `PrefillDataType.UlcSubmission` → `prefillSubmission(submission)` — a `SubmissionPrefill`
-  (a received `SubmissionBody` round-tripped, or a partial `{ data?, ...} ` you assemble).
-- `PrefillDataType.Info` → `prefillInfo(items)` — a list of `PrefillInfoItem`. The webview
-  matches each item by `ll_field_unique_identifier` (e.g. `"FirstName"`, `"Email"`);
-  `ll_field_id` is optional metadata (number or string) and `value` may be a string or boolean.
-- `PrefillDataType.UlcSubmissionAndInfo` → `prefillSubmissionAndInfo({ submission, info })`.
+Both ride the same wire `data_type` (`ulc_submission_and_info`); pass just the key(s) you
+have.
 
 ## Rendering a submission
 
@@ -310,13 +381,13 @@ new CaptelloWebview(iframe, {
 - `onAny(listener) => unsubscribe` — every outbound message.
 - `submit()`, `reset()`, `updateDraft()`, `triggerValidation(target)` — inbound helpers.
 - `submitAndWait(timeoutMs?)` — submit and await `submission_body` / `form_error_message` (see above).
-- `prefillSubmission(...)`, `prefillInfo(...)`, `prefillSubmissionAndInfo(...)`.
+- `prefill({ submission?, info? })` — pre-fill from a submission body, transcription items, or both.
 - `send(message)` — low-level escape hatch for any `InboundMessage`.
 - `destroy()` — detach the listener and drop subscriptions (idempotent).
 
 **Send queueing.** With `queueUntilReady` (default `true`), any send before the webview
 reports `form_load_complete` is buffered and flushed, in order, on load — so calling
-`prefillInfo(...)` right after mount won't be silently dropped. A client that attaches
+`prefill(...)` right after mount won't be silently dropped. A client that attaches
 _after_ the form already loaded won't observe `form_load_complete`; either create the
 client with the iframe, or pass `queueUntilReady: false` to send immediately. The
 one-shot `/promises` helpers set `queueUntilReady: false` automatically.
@@ -375,8 +446,8 @@ short keys, and ad-hoc `window.addEventListener("message")` / `iframe.contentWin
 calls. Replace them as follows.
 
 **1. Message-type constants → SDK enums.** Delete local copies (e.g. `UlcFormActionTypeSent`,
-`UlcFormActionTypeReceived`, `UlcFormDataType`) and import `InboundMessageType`,
-`OutboundMessageType`, `PrefillDataType`.
+`UlcFormActionTypeReceived`, `UlcFormDataType`) and import `InboundMessageType` /
+`OutboundMessageType` (the `form_prefill` `data_type` is set for you by `prefill(...)`).
 
 **2. Manual URL building → `buildEmbedUrl`.**
 
@@ -408,12 +479,12 @@ const body = await client.submitAndWait(); // throws SubmissionError on form_err
 
 **5. `document.querySelector("#ulcForm").contentWindow.postMessage(...)` → client methods.**
 Hold the `CaptelloWebview` instance in a ref/context and call `submit()` / `reset()` /
-`prefillInfo()` instead of re-querying the DOM and stringifying messages by hand.
+`prefill()` instead of re-querying the DOM and stringifying messages by hand.
 
-**Prefill notes for migrators.** `prefillInfo` items are matched by
+**Prefill notes for migrators.** `prefill({ info })` items are matched by
 `ll_field_unique_identifier`; `ll_field_id` is optional (number or string) and `value`
 may be a string or boolean — so existing payloads with numeric ids and boolean values
-type-check as-is. `prefillSubmission` accepts a loose `SubmissionPrefill`, so a
+type-check as-is. `prefill({ submission })` accepts a loose `SubmissionPrefill`, so a
 previously-received `SubmissionBody` (or a partial `{ email?, data?, ... }`) can be passed
 back directly.
 

package/dist/react.d.ts

@@ -1,47 +1,9 @@
-import { RefCallback } from 'react';
-import { a as OutboundMessageMap, O as OutboundMessageType, d as OutboundMessage, C as CaptelloWebviewOptions, e as CaptelloWebview, V as ValidationTarget, f as SubmissionPrefill, P as PrefillInfoItem, S as SubmissionBody } from './client-Dik-Mjid.js';
+import * as react from 'react';
+import { CSSProperties, IframeHTMLAttributes, ReactNode, RefCallback } from 'react';
+import { C as CaptelloWebviewOptions, a as OutboundMessageMap, O as OutboundMessageType, d as OutboundMessage, e as CaptelloWebview, V as ValidationTarget, f as SubmissionPrefill, P as PrefillInfoItem, S as SubmissionBody } from './client-Dik-Mjid.js';
 export { b as SubmissionError, c as SubmissionTimeoutError, U as Unsubscribe } from './client-Dik-Mjid.js';
 import { EmbedUrlOptions } from './index.js';
 
-/**
- * React adapter for the Captello webview SDK — `@captello/ulc-webview-sdk/react`.
- *
- * {@link useCaptelloWebview} owns a {@link CaptelloWebview} for the lifetime of an
- * iframe: it creates the client once the iframe mounts, wires the outbound messages
- * you care about to typed callbacks, tracks readiness, and destroys the client on
- * unmount. You get back `iframeProps` to spread onto your `<iframe>` (or a bare `ref`),
- * an `isReady` flag, and stable senders (`submit`, `reset`, `prefill`, …).
- *
- * Sends made before the form loads are queued by the client and flushed on
- * `form_load_complete`, so you can call `prefill(...)` as soon as you have data —
- * no need to gate on readiness yourself.
- *
- * Callbacks are held in a ref and always called fresh, so you do NOT need to memoize
- * them — passing inline arrow functions will not re-subscribe or re-create the client.
- *
- * `react` is an optional peer dependency; importing this entry point requires React 18+.
- *
- * @example
- * function UlcForm({ token, onSubmitted }: { token: string; onSubmitted: (b: SubmissionBody) => void }) {
- *   const { iframeProps, isReady, submit } = useCaptelloWebview({
- *     embedUrl: {
- *       baseUrl: "https://capture.captello.com",
- *       eventWebAccessToken: token,
- *       mode: FormMode.Submit,
- *       launcher: LauncherType.EventGenWeb,
- *     },
- *     onSubmissionBody: (m) => onSubmitted(m.data),
- *   });
- *   return (
- *     <>
- *       {!isReady && <Spinner />}
- *       <iframe {...iframeProps} title="UlcForm" allow="camera; microphone" />
- *       <button onClick={submit}>Submit</button>
- *     </>
- *   );
- * }
- */
-
 /** Per-message-type callback props accepted by {@link useCaptelloWebview}. */
 interface CaptelloWebviewCallbacks {
     onFormLoadComplete?: (message: OutboundMessageMap[OutboundMessageType.FormLoadComplete]) => void;
@@ -106,5 +68,81 @@ interface UseCaptelloWebviewResult {
  * Binds a {@link CaptelloWebview} to an iframe's lifecycle. See the module doc for usage.
  */
 declare function useCaptelloWebview(options: UseCaptelloWebviewOptions): UseCaptelloWebviewResult;
+/**
+ * Imperative handle exposed on {@link CaptelloForm}'s `ref` — the same senders the hook
+ * returns, plus the current status and the underlying `<iframe>` node. Lets a parent
+ * drive the form (e.g. an external submit button) without lifting state.
+ */
+interface CaptelloFormHandle extends Pick<UseCaptelloWebviewResult, "submit" | "reset" | "updateDraft" | "triggerValidation" | "prefill" | "submitAndWait" | "getClient"> {
+    /** Current readiness: `"loading" | "ready" | "error"`. */
+    readonly status: CaptelloWebviewStatus;
+    /** `true` once the form has reported `form_load_complete`. */
+    readonly isReady: boolean;
+    /** The underlying `<iframe>` DOM node, or `null` before it mounts. */
+    getIframe: () => HTMLIFrameElement | null;
+}
+/**
+ * Props for {@link CaptelloForm}: every {@link useCaptelloWebviewOptions} option (embed
+ * config + message callbacks + client options) plus rendering conveniences.
+ */
+interface CaptelloFormProps extends UseCaptelloWebviewOptions {
+    /** `className` for the wrapper element. */
+    className?: string;
+    /** `style` for the wrapper element — size the form here. The component adds `position: relative`; your values win. */
+    style?: CSSProperties;
+    /** `id` for the wrapper element. */
+    id?: string;
+    /**
+     * Attributes spread onto the `<iframe>` — `title`, `allow`, `sandbox`, `name`, etc.
+     * Defaults: `title="Captello form"`, `allow="camera; microphone; geolocation"`. When you
+     * drive the URL yourself (no `embedUrl`), set `src` here.
+     */
+    iframeProps?: Omit<IframeHTMLAttributes<HTMLIFrameElement>, "ref">;
+    /** Rendered, centered over the iframe, while it is loading. The iframe stays mounted underneath. */
+    loading?: ReactNode;
+    /**
+     * Rendered, centered over the iframe, when the form reports `form_error_message`.
+     * Pass a function to receive the translated, display-ready error text.
+     */
+    error?: ReactNode | ((message: string | undefined) => ReactNode);
+    /**
+     * Inline controls rendered after the form. A function receives the live api
+     * (status + senders), so you can wire a submit button without a `ref`.
+     */
+    children?: ReactNode | ((api: UseCaptelloWebviewResult) => ReactNode);
+}
+/**
+ * Turnkey component for embedding a Captello capture form — the shortest path to a
+ * working integration. Renders the `<iframe>`, wires {@link useCaptelloWebview} to it,
+ * shows your `loading` / `error` overlays, and forwards a {@link CaptelloFormHandle} on
+ * `ref` so a parent can `submit()` / `prefill()` without lifting state.
+ *
+ * Pass `embedUrl` and the form fills its wrapper — size the form via `className` / `style`
+ * (an iframe has no intrinsic height). Reach for {@link useCaptelloWebview} instead when
+ * you need to own the markup.
+ *
+ * @example
+ * function UlcForm({ token }: { token: string }) {
+ *   const ref = useRef<CaptelloFormHandle>(null);
+ *   return (
+ *     <CaptelloForm
+ *       ref={ref}
+ *       style={{ height: 600 }}
+ *       embedUrl={{
+ *         baseUrl: "https://capture.captello.com",
+ *         eventWebAccessToken: token,
+ *         mode: FormMode.Submit,
+ *         launcher: LauncherType.EventGenWeb,
+ *       }}
+ *       onSubmissionBody={(m) => save(m.data)}
+ *       loading={<Spinner />}
+ *       error={(msg) => <ErrorBanner>{msg}</ErrorBanner>}
+ *     >
+ *       {({ isReady }) => <button disabled={!isReady} onClick={() => ref.current?.submit()}>Submit</button>}
+ *     </CaptelloForm>
+ *   );
+ * }
+ */
+declare const CaptelloForm: react.ForwardRefExoticComponent<CaptelloFormProps & react.RefAttributes<CaptelloFormHandle>>;
 
-export { type CaptelloIframeProps, CaptelloWebview, type CaptelloWebviewCallbacks, type CaptelloWebviewStatus, type EmbedUrlConfig, type UseCaptelloWebviewOptions, type UseCaptelloWebviewResult, useCaptelloWebview };
+export { CaptelloForm, type CaptelloFormHandle, type CaptelloFormProps, type CaptelloIframeProps, CaptelloWebview, type CaptelloWebviewCallbacks, type CaptelloWebviewStatus, type EmbedUrlConfig, type UseCaptelloWebviewOptions, type UseCaptelloWebviewResult, useCaptelloWebview };

package/dist/react.js

@@ -1,7 +1,8 @@
 import { buildEmbedUrl } from './chunk-4E7OW4RJ.js';
 import { CaptelloWebview, OutboundMessageType } from './chunk-PFFBCSJ2.js';
 export { CaptelloWebview, SubmissionError, SubmissionTimeoutError } from './chunk-PFFBCSJ2.js';
-import { useRef, useState, useCallback, useEffect } from 'react';
+import { forwardRef, useState, useRef, useCallback, useImperativeHandle, useEffect } from 'react';
+import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
 
 var CALLBACK_BY_TYPE = {
   ["form_load_complete" /* FormLoadComplete */]: "onFormLoadComplete",
@@ -99,7 +100,94 @@ function useCaptelloWebview(options) {
     submitAndWait
   };
 }
+var DEFAULT_ALLOW = "camera; microphone; geolocation";
+var WRAPPER_STYLE = { position: "relative" };
+var IFRAME_STYLE = { display: "block", width: "100%", height: "100%", border: 0 };
+var OVERLAY_STYLE = {
+  position: "absolute",
+  inset: 0,
+  display: "flex",
+  alignItems: "center",
+  justifyContent: "center"
+};
+function CaptelloFormImpl(props, ref) {
+  const {
+    className,
+    style,
+    id,
+    iframeProps,
+    loading,
+    error,
+    children,
+    onFormLoadComplete,
+    onFormErrorMessage,
+    ...options
+  } = props;
+  const [errorMessage, setErrorMessage] = useState(void 0);
+  const api = useCaptelloWebview({
+    ...options,
+    // Wrap the two status-bearing callbacks to track the error text, then forward to
+    // the caller's handler. The hook reads callbacks fresh, so these inline wrappers
+    // don't re-subscribe or re-create the client.
+    onFormLoadComplete: (message) => {
+      setErrorMessage(void 0);
+      onFormLoadComplete?.(message);
+    },
+    onFormErrorMessage: (message) => {
+      setErrorMessage(message.data);
+      onFormErrorMessage?.(message);
+    }
+  });
+  const nodeRef = useRef(null);
+  const hookRef = api.iframeProps.ref;
+  const setIframe = useCallback(
+    (node) => {
+      nodeRef.current = node;
+      hookRef(node);
+    },
+    [hookRef]
+  );
+  useImperativeHandle(
+    ref,
+    () => ({
+      submit: api.submit,
+      reset: api.reset,
+      updateDraft: api.updateDraft,
+      triggerValidation: api.triggerValidation,
+      prefill: api.prefill,
+      submitAndWait: api.submitAndWait,
+      getClient: api.getClient,
+      getIframe: () => nodeRef.current,
+      status: api.status,
+      isReady: api.isReady
+    }),
+    [api]
+  );
+  const src = api.iframeProps.src ?? iframeProps?.src;
+  const showLoading = api.status === "loading" && loading != null;
+  const showError = api.status === "error" && error != null;
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsxs("div", { className, id, style: { ...WRAPPER_STYLE, ...style }, children: [
+      /* @__PURE__ */ jsx(
+        "iframe",
+        {
+          title: "Captello form",
+          allow: DEFAULT_ALLOW,
+          ...iframeProps,
+          ref: setIframe,
+          src,
+          style: { ...IFRAME_STYLE, ...iframeProps?.style }
+        }
+      ),
+      showLoading ? /* @__PURE__ */ jsx("div", { style: OVERLAY_STYLE, children: loading }) : null,
+      showError ? /* @__PURE__ */ jsx("div", { style: OVERLAY_STYLE, children: typeof error === "function" ? error(errorMessage) : error }) : null
+    ] }),
+    typeof children === "function" ? children(api) : children
+  ] });
+}
+var CaptelloForm = forwardRef(CaptelloFormImpl);
+CaptelloForm.displayName = "CaptelloForm";
 
-export { useCaptelloWebview };
+export { CaptelloForm, useCaptelloWebview };
 //# sourceMappingURL=react.js.map
 //# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react.ts"],"names":[],"mappings":";;;;;AAsHA,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,OAAA,GAAU,WAAA;AAAA,IACZ,CAAC,IAAA,KACG,SAAA,CAAU,OAAA,EAAS,QAAQ,IAAI,CAAA;AAAA,IACnC;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,OAAA;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`, `prefill`, …).\n *\n * Sends made before the form loads are queued by the client and flushed on\n * `form_load_complete`, so you can call `prefill(...)` 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    prefill: (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 prefill = useCallback(\n        (data: { submission?: SubmissionPrefill; info?: PrefillInfoItem[] }) =>\n            clientRef.current?.prefill(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        prefill,\n        submitAndWait,\n    };\n}\n\nexport { CaptelloWebview, SubmissionError, SubmissionTimeoutError } from \"./client\";\nexport type { Unsubscribe } from \"./client\";\n"]}
+{"version":3,"sources":["../src/react.tsx"],"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 * Two entry points, same engine:\n * - {@link CaptelloForm} — a turnkey `<iframe>` component. Drop it in with an `embedUrl`\n *   and message callbacks; it renders the frame, shows your `loading` / `error` overlays,\n *   and exposes the senders via an imperative `ref`. This is the shortest path.\n * - {@link useCaptelloWebview} — the underlying hook, for when you want to own the markup.\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`, `prefill`, …).\n *\n * Sends made before the form loads are queued by the client and flushed on\n * `form_load_complete`, so you can call `prefill(...)` 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 {\n    forwardRef,\n    useCallback,\n    useEffect,\n    useImperativeHandle,\n    useRef,\n    useState,\n    type CSSProperties,\n    type IframeHTMLAttributes,\n    type ReactElement,\n    type ReactNode,\n    type Ref,\n    type RefCallback,\n} 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    prefill: (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 prefill = useCallback(\n        (data: { submission?: SubmissionPrefill; info?: PrefillInfoItem[] }) => clientRef.current?.prefill(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        prefill,\n        submitAndWait,\n    };\n}\n\n/* ------------------------------------------------------------------ *\n * <CaptelloForm /> — the turnkey component\n * ------------------------------------------------------------------ */\n\n/** Default iframe permissions for a capture form (business-card camera scan, mic, geo). */\nconst DEFAULT_ALLOW = \"camera; microphone; geolocation\";\n\n/** Wrapper is the positioning context for the loading / error overlays. */\nconst WRAPPER_STYLE: CSSProperties = { position: \"relative\" };\n\n/** The iframe fills the wrapper; size the component, not this. */\nconst IFRAME_STYLE: CSSProperties = { display: \"block\", width: \"100%\", height: \"100%\", border: 0 };\n\n/** Centers the `loading` / `error` node over the iframe. */\nconst OVERLAY_STYLE: CSSProperties = {\n    position: \"absolute\",\n    inset: 0,\n    display: \"flex\",\n    alignItems: \"center\",\n    justifyContent: \"center\",\n};\n\n/**\n * Imperative handle exposed on {@link CaptelloForm}'s `ref` — the same senders the hook\n * returns, plus the current status and the underlying `<iframe>` node. Lets a parent\n * drive the form (e.g. an external submit button) without lifting state.\n */\nexport interface CaptelloFormHandle\n    extends Pick<\n        UseCaptelloWebviewResult,\n        \"submit\" | \"reset\" | \"updateDraft\" | \"triggerValidation\" | \"prefill\" | \"submitAndWait\" | \"getClient\"\n    > {\n    /** Current readiness: `\"loading\" | \"ready\" | \"error\"`. */\n    readonly status: CaptelloWebviewStatus;\n    /** `true` once the form has reported `form_load_complete`. */\n    readonly isReady: boolean;\n    /** The underlying `<iframe>` DOM node, or `null` before it mounts. */\n    getIframe: () => HTMLIFrameElement | null;\n}\n\n/**\n * Props for {@link CaptelloForm}: every {@link useCaptelloWebviewOptions} option (embed\n * config + message callbacks + client options) plus rendering conveniences.\n */\nexport interface CaptelloFormProps extends UseCaptelloWebviewOptions {\n    /** `className` for the wrapper element. */\n    className?: string;\n    /** `style` for the wrapper element — size the form here. The component adds `position: relative`; your values win. */\n    style?: CSSProperties;\n    /** `id` for the wrapper element. */\n    id?: string;\n    /**\n     * Attributes spread onto the `<iframe>` — `title`, `allow`, `sandbox`, `name`, etc.\n     * Defaults: `title=\"Captello form\"`, `allow=\"camera; microphone; geolocation\"`. When you\n     * drive the URL yourself (no `embedUrl`), set `src` here.\n     */\n    iframeProps?: Omit<IframeHTMLAttributes<HTMLIFrameElement>, \"ref\">;\n    /** Rendered, centered over the iframe, while it is loading. The iframe stays mounted underneath. */\n    loading?: ReactNode;\n    /**\n     * Rendered, centered over the iframe, when the form reports `form_error_message`.\n     * Pass a function to receive the translated, display-ready error text.\n     */\n    error?: ReactNode | ((message: string | undefined) => ReactNode);\n    /**\n     * Inline controls rendered after the form. A function receives the live api\n     * (status + senders), so you can wire a submit button without a `ref`.\n     */\n    children?: ReactNode | ((api: UseCaptelloWebviewResult) => ReactNode);\n}\n\nfunction CaptelloFormImpl(props: CaptelloFormProps, ref: Ref<CaptelloFormHandle>): ReactElement {\n    const {\n        className,\n        style,\n        id,\n        iframeProps,\n        loading,\n        error,\n        children,\n        onFormLoadComplete,\n        onFormErrorMessage,\n        ...options\n    } = props;\n\n    // The translated error text from the last form_error_message, for the `error` render.\n    const [errorMessage, setErrorMessage] = useState<string | undefined>(undefined);\n\n    const api = useCaptelloWebview({\n        ...options,\n        // Wrap the two status-bearing callbacks to track the error text, then forward to\n        // the caller's handler. The hook reads callbacks fresh, so these inline wrappers\n        // don't re-subscribe or re-create the client.\n        onFormLoadComplete: (message) => {\n            setErrorMessage(undefined);\n            onFormLoadComplete?.(message);\n        },\n        onFormErrorMessage: (message) => {\n            setErrorMessage(message.data);\n            onFormErrorMessage?.(message);\n        },\n    });\n\n    // Merge the hook's iframe ref with our own node ref so getIframe() can return the DOM node.\n    const nodeRef = useRef<HTMLIFrameElement | null>(null);\n    const hookRef = api.iframeProps.ref;\n    const setIframe = useCallback<RefCallback<HTMLIFrameElement | null>>(\n        (node) => {\n            nodeRef.current = node;\n            hookRef(node);\n        },\n        [hookRef],\n    );\n\n    useImperativeHandle(\n        ref,\n        () => ({\n            submit: api.submit,\n            reset: api.reset,\n            updateDraft: api.updateDraft,\n            triggerValidation: api.triggerValidation,\n            prefill: api.prefill,\n            submitAndWait: api.submitAndWait,\n            getClient: api.getClient,\n            getIframe: () => nodeRef.current,\n            status: api.status,\n            isReady: api.isReady,\n        }),\n        [api],\n    );\n\n    // embedUrl-derived src wins; otherwise use a src the caller passed via iframeProps.\n    const src = api.iframeProps.src ?? iframeProps?.src;\n    const showLoading = api.status === \"loading\" && loading != null;\n    const showError = api.status === \"error\" && error != null;\n\n    return (\n        <>\n            <div className={className} id={id} style={{ ...WRAPPER_STYLE, ...style }}>\n                <iframe\n                    title=\"Captello form\"\n                    allow={DEFAULT_ALLOW}\n                    {...iframeProps}\n                    ref={setIframe}\n                    src={src}\n                    style={{ ...IFRAME_STYLE, ...iframeProps?.style }}\n                />\n                {showLoading ? <div style={OVERLAY_STYLE}>{loading}</div> : null}\n                {showError ? (\n                    <div style={OVERLAY_STYLE}>{typeof error === \"function\" ? error(errorMessage) : error}</div>\n                ) : null}\n            </div>\n            {typeof children === \"function\" ? children(api) : children}\n        </>\n    );\n}\n\n/**\n * Turnkey component for embedding a Captello capture form — the shortest path to a\n * working integration. Renders the `<iframe>`, wires {@link useCaptelloWebview} to it,\n * shows your `loading` / `error` overlays, and forwards a {@link CaptelloFormHandle} on\n * `ref` so a parent can `submit()` / `prefill()` without lifting state.\n *\n * Pass `embedUrl` and the form fills its wrapper — size the form via `className` / `style`\n * (an iframe has no intrinsic height). Reach for {@link useCaptelloWebview} instead when\n * you need to own the markup.\n *\n * @example\n * function UlcForm({ token }: { token: string }) {\n *   const ref = useRef<CaptelloFormHandle>(null);\n *   return (\n *     <CaptelloForm\n *       ref={ref}\n *       style={{ height: 600 }}\n *       embedUrl={{\n *         baseUrl: \"https://capture.captello.com\",\n *         eventWebAccessToken: token,\n *         mode: FormMode.Submit,\n *         launcher: LauncherType.EventGenWeb,\n *       }}\n *       onSubmissionBody={(m) => save(m.data)}\n *       loading={<Spinner />}\n *       error={(msg) => <ErrorBanner>{msg}</ErrorBanner>}\n *     >\n *       {({ isReady }) => <button disabled={!isReady} onClick={() => ref.current?.submit()}>Submit</button>}\n *     </CaptelloForm>\n *   );\n * }\n */\nexport const CaptelloForm = forwardRef(CaptelloFormImpl);\nCaptelloForm.displayName = \"CaptelloForm\";\n\nexport { CaptelloWebview, SubmissionError, SubmissionTimeoutError } from \"./client\";\nexport type { Unsubscribe } from \"./client\";\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@captello/ulc-webview-sdk",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Typed SDK for embedding the Captello capture webview: message protocol, host client, and embed-URL builder.",
   "author": "Lead Liaison",
   "license": "MIT",