@captello/ulc-webview-sdk 0.5.0 → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,131 @@
+# Changelog
+
+## 1.0.0
+
+### Major Changes
+
+- First stable release. Adds `defaultFormValues`, makes `embedUrl` required, and simplifies the
+  React callback signatures.
+
+    **`defaultFormValues`** — a new option on `<CaptelloForm>` and `useCaptelloWebview` that
+    populates the form as soon as it reports `form_load_complete`:
+
+    ```tsx
+    <CaptelloForm
+        embedUrl={{ baseUrl: "https://capture.captello.com", eventWebAccessToken }}
+        defaultFormValues={{
+            info: [{ ll_field_unique_identifier: "Email", value: user.email }],
+            submission: { data: { "1042": "Acme Inc." } },
+        }}
+    />
+    ```
+
+    It's the declarative form of `prefill(...)` — same wire message, same shapes — so seeding a
+    form no longer needs a `ref`, an effect, or a readiness check. It is sent as the _first_
+    outbound message (a later explicit `prefill(...)` still wins) and read once at mount, so
+    changing the prop afterwards does not re-populate the form. No memoization required.
+
+    **Breaking — callbacks receive payloads, not message envelopes.** The React callback props
+    are named after their message type, so the `type` discriminator they carried was redundant.
+    Each now receives just the payload, and payload-free messages pass no argument:
+
+    ```diff
+    -onSubmissionBody={(m) => save(m.data)}
+    +onSubmissionBody={(body) => save(body)}     // or simply: onSubmissionBody={save}
+
+    -onFormErrorMessage={(m) => showToast(m.data)}
+    +onFormErrorMessage={(message) => showToast(message)}
+
+    -onFormLoadComplete={(m) => track(m.type)}
+    +onFormLoadComplete={() => track("form_load_complete")}
+
+    -onFormSubmitSuccess={(m) => log(m.action)}
+    +onFormSubmitSuccess={(action) => log(action)}
+    ```
+
+    | Callback                      | Now receives           |
+    | ----------------------------- | ---------------------- |
+    | `onFormLoadComplete`          | — (no payload)         |
+    | `onFormErrorMessage`          | `string`               |
+    | `onSubmissionBody`            | `SubmissionBody`       |
+    | `onFormSubmitSuccess`         | `"create" \| "update"` |
+    | `onConnexionsProfileRedirect` | — (no payload)         |
+    | `onConnexionsDownloadVcard`   | — (no payload)         |
+
+    `onAnyMessage` is unchanged — it fires for every type, so it still gets the whole message
+    including `type`. The low-level `CaptelloWebview.on(type, listener)` is also unchanged.
+
+    **Breaking — `embedUrl` is now required** on both `<CaptelloForm>` and
+    `useCaptelloWebview`, and `targetOrigin` has been dropped from their options: the origin is
+    always derived from `embedUrl`. Consequently `iframeProps.src` is now always a `string`, and
+    a `src` passed via `<CaptelloForm iframeProps={{ src }}>` is ignored.
+
+    To migrate, move your URL into `embedUrl`:
+
+    ```diff
+    -useCaptelloWebview({ targetOrigin: "https://capture.captello.com", ... })
+    +useCaptelloWebview({ embedUrl: { baseUrl: "https://capture.captello.com", eventWebAccessToken }, ... })
+    ```
+
+    If you need to own both the URL and the origin, use the `CaptelloWebview` class directly —
+    it still accepts `targetOrigin`.
+
+## 0.6.0
+
+### Minor Changes
+
+- **Breaking:** `visible_submissions_data` now reports `simple_name` and `address` values as
+  objects keyed by their transcription identifier (`ll_field_unique_identifier`) instead of by
+  opaque sub-element id.
+
+    - `simple_name` → `NameSubmissionValue` (`{ FirstName?, LastName? }`)
+    - `address` → `AddressSubmissionValue` (`{ StreetAddress?, StreetAddress2?, City?, State?, Zipcode?, Country? }`)
+
+    Hidden sub-fields are omitted, so all keys are optional. The shared `CompositeSubmissionValue`
+    type (sub-element-id → string) is removed; narrow on `element_type` and read the named fields.
+
+    ```ts
+    // before
+    case FormElementType.simple_name:
+        Object.values(item.element_value).join(" "); // { "el_1_1": "Jane", "el_1_2": "Doe" }
+
+    // after
+    case FormElementType.simple_name:
+        [item.element_value.FirstName, item.element_value.LastName].filter(Boolean).join(" ");
+    ```
+
+## 0.5.0
+
+### Minor Changes
+
+- 15aef07: Add `<CaptelloForm>` to the React adapter (`@captello/ulc-webview-sdk/react`) — a turnkey
+  component built on `useCaptelloWebview`. It renders the `<iframe>`, wires the embed URL and
+  message callbacks, shows centered `loading` / `error` overlays, accepts render-prop
+  `children` that receive the live api, and forwards a `CaptelloFormHandle` on `ref`
+  (`submit`, `reset`, `updateDraft`, `triggerValidation`, `prefill`, `submitAndWait`, plus
+  `status` / `isReady`, `getIframe()`, and `getClient()`) so a parent can drive the form
+  without lifting state. The hook remains available for callers that prefer to own the markup.
+
+## 0.4.0
+
+### Breaking Changes
+
+- **Unified prefill API:** `prefillSubmission()`, `prefillInfo()`, and `prefillSubmissionAndInfo()` have been replaced by a single `prefill()` method.
+
+    ```ts
+    // Before
+    client.prefillSubmission(submission);
+    client.prefillInfo(info);
+    client.prefillSubmissionAndInfo({ submission, info });
+
+    // After
+    client.prefill({ submission });
+    client.prefill({ info });
+    client.prefill({ submission, info });
+    ```
+
+- **Removed `PrefillDataType` export:** The enum is now an internal implementation detail. Consumers no longer need to specify a data type discriminator — the SDK resolves it automatically.
+
+### React Hook
+
+- `useCaptelloWebview` now returns `prefill` instead of the three separate methods.

package/README.md

@@ -145,7 +145,13 @@ function UlcForm({
                 mode: FormMode.Submit,
                 launcher: LauncherType.EventGenWeb,
             }}
-            onSubmissionBody={(m) => onSubmitted(m.data)}
+            defaultFormValues={{
+                info: [
+                    { ll_field_unique_identifier: "FirstName", value: "Ada" },
+                    { ll_field_unique_identifier: "Email", value: "ada@example.com" },
+                ],
+            }}
+            onSubmissionBody={onSubmitted}
             loading={<Spinner />}
             error={(message) => <ErrorBanner>{message}</ErrorBanner>}
         >
@@ -159,14 +165,14 @@ function UlcForm({
 }
 ```
 
-Props are the hook options (`embedUrl` or `targetOrigin`, every message callback, and the
-client options) plus a few rendering conveniences:
+Props are the hook options (the required `embedUrl`, `defaultFormValues`, 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.
+  `src` is ignored — the URL comes from `embedUrl`.
 - **`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
@@ -201,8 +207,8 @@ function UlcForm({
             mode: FormMode.Submit,
             launcher: LauncherType.EventGenWeb,
         },
-        onSubmissionBody: (m) => onSubmitted(m.data),
-        onFormErrorMessage: (m) => showToast(m.data),
+        onSubmissionBody: onSubmitted,
+        onFormErrorMessage: showToast,
     });
 
     return (
@@ -217,30 +223,77 @@ function UlcForm({
 
 What the hook (and the component built on it) handle for you:
 
-- **URL + origin.** Pass `embedUrl: { baseUrl, ...EmbedUrlOptions }` and the hook builds
+- **URL + origin.** `embedUrl: { baseUrl, ...EmbedUrlOptions }` is required; the hook builds
   the URL, derives `targetOrigin`, and returns it as `iframeProps.src` — no separate
-  `buildEmbedUrl` / manual `src` wiring to keep in sync. (Prefer
-  to own the `src`? Omit `embedUrl`, pass `targetOrigin`, and use the returned `ref`.)
+  `buildEmbedUrl` / manual `src` wiring to keep in sync. (Need to own both the URL and the
+  origin? Use the `CaptelloWebview` class directly.)
 - **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 `prefill(...)` as soon as you have data — no
   gating on readiness, and no silently-dropped messages.
+- **Default values.** `defaultFormValues: { submission?, info? }` populates the form as soon
+  as it's ready, so seeding a known email or a previous submission needs no `ref`, no effect,
+  and no readiness check. See below.
 - **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.
+  won't re-subscribe or re-create the client. The client is recreated only when the
+  `embedUrl`-derived origin / `hostWindow` / `matchSource` / `queueUntilReady` change.
 - **Stable senders** (`submit`, `reset`, `updateDraft`, `triggerValidation`, `prefill`,
   `submitAndWait`) — safe in deps or passed to children. `getClient()` returns the live
   client for escape hatches.
 
+### `defaultFormValues` — populate the form on load
+
+Both `<CaptelloForm>` and `useCaptelloWebview` take a `defaultFormValues` option that seeds
+the form the moment it reports `form_load_complete`:
+
+```tsx
+<CaptelloForm
+    embedUrl={{ baseUrl: "https://capture.captello.com", eventWebAccessToken }}
+    defaultFormValues={{
+        // matched by ll_field_unique_identifier
+        info: [{ ll_field_unique_identifier: "Email", value: user.email }],
+        // and/or keyed by element id, same shape prefill() takes
+        submission: { data: { "1042": "Acme Inc." } },
+    }}
+/>
+```
+
+It's the declarative form of `prefill(...)` — same wire message, same shapes — so you don't
+need a `ref`, an effect, or a readiness check just to seed a form. Semantics:
+
+- **Sent first.** It goes out ahead of everything else, so an explicit `prefill(...)` you
+  make later overwrites it.
+- **Read once, at mount.** These are _defaults_, not controlled values: changing the prop
+  afterwards does **not** re-populate the form. Call `prefill(...)` for that.
+- **No memoization needed.** An inline object literal won't re-fire it or re-create the client.
+- **Omit or leave empty** (`{}`) and no message is sent at all.
+
+`submission` accepts a partial, and a whole `SubmissionBody` handed to you by
+`onSubmissionBody` also fits — handy for re-opening a captured lead.
+
 ### Callback props
 
-`useCaptelloWebview` accepts a callback per outbound message — `onFormLoadComplete`,
-`onFormErrorMessage`, `onSubmissionBody`, `onFormSubmitSuccess`,
-`onConnexionsProfileRedirect`, `onConnexionsDownloadVcard` — plus `onAnyMessage` (fires
-for every message, after the specific handler). All are optional. Connection options
-(`embedUrl` or `targetOrigin`, `hostWindow`, `matchSource`, `queueUntilReady`) go in the
-same object.
+`useCaptelloWebview` accepts one optional callback per outbound message. Each receives the
+message's **payload**, not the `{ type, … }` envelope — the callback name already tells you
+the type, so there's nothing to discriminate on:
+
+| Callback                      | Receives                    |
+| ----------------------------- | --------------------------- |
+| `onFormLoadComplete`          | — (no payload)              |
+| `onFormErrorMessage`          | `string` (translated text)  |
+| `onSubmissionBody`            | `SubmissionBody`            |
+| `onFormSubmitSuccess`         | `"create" \| "update"`      |
+| `onConnexionsProfileRedirect` | — (no payload)              |
+| `onConnexionsDownloadVcard`   | — (no payload)              |
+| `onAnyMessage`                | the whole `OutboundMessage` |
+
+`onAnyMessage` is the exception: it fires for every type (after the specific handler), so it
+gets the full message including `type`. So does the low-level `CaptelloWebview.on(type, …)`,
+which is unchanged — envelopes there, payloads here.
+
+`embedUrl` (required), `defaultFormValues`, and the client options (`hostWindow`,
+`matchSource`, `queueUntilReady`) go in the same object.
 
 ### Without the adapter
 
@@ -295,7 +348,7 @@ have.
 A `submission_body` payload includes `visible_submissions_data` — one entry per filled,
 visible element, typed as `VisibleSubmissionDataItem[]` and discriminated by
 `element_type`. Narrow on `element_type` and `element_value` is precisely typed (string,
-string array, composite name/address, order quantities, etc.), so you render it exactly
+string array, name/address objects, order quantities, etc.), so you render it exactly
 how your UI needs — no flattening helper to fight:
 
 ```ts
@@ -312,8 +365,18 @@ webview.on(OutboundMessageType.SubmissionBody, (msg) => {
                 addRow(item.element_title, renderChoices(item.element_value));
                 break;
             case FormElementType.simple_name:
-                // element_value: CompositeSubmissionValue (sub-field id → string)
-                addRow(item.element_title, Object.values(item.element_value).join(" "));
+                // element_value: NameSubmissionValue ({ FirstName?, LastName? })
+                addRow(
+                    item.element_title,
+                    [item.element_value.FirstName, item.element_value.LastName].filter(Boolean).join(" "),
+                );
+                break;
+            case FormElementType.address:
+                // element_value: AddressSubmissionValue ({ StreetAddress?, City?, State?, Zipcode?, Country?, … })
+                addRow(
+                    item.element_title,
+                    [item.element_value.StreetAddress, item.element_value.City].filter(Boolean).join(", "),
+                );
                 break;
             // …other element types
         }

package/dist/{client-Dik-Mjid.d.ts → client-CalIoKT6.d.ts}

@@ -64,9 +64,26 @@ declare enum FormElementType {
     star_rating = "star_survey",
     attachments = "attachments"
 }
-/** Composite element value (simple_name / address): sub-field values keyed by sub-element id. */
-type CompositeSubmissionValue = {
-    [subElementId: string]: string;
+/**
+ * `simple_name` value: the visible sub-fields keyed by their transcription identifier
+ * (`ll_field_unique_identifier`), the same identifiers used by prefill. Hidden sub-fields are
+ * omitted, so keys are optional.
+ */
+type NameSubmissionValue = {
+    FirstName?: string;
+    LastName?: string;
+};
+/**
+ * `address` value: the visible sub-fields keyed by their transcription identifier
+ * (`ll_field_unique_identifier`). Hidden sub-fields are omitted, so keys are optional.
+ */
+type AddressSubmissionValue = {
+    StreetAddress?: string;
+    StreetAddress2?: string;
+    City?: string;
+    State?: string;
+    Zipcode?: string;
+    Country?: string;
 };
 /** Checkbox value when the element is an "order" checkbox (quantities + note). */
 type OrderCheckboxSubmissionData = {
@@ -134,8 +151,8 @@ type VisibleSubmissionElementValueMap = {
     [FormElementType.business_card]: Partial<BusinessCardValue>;
     [FormElementType.boolean]: boolean;
     [FormElementType.attachments]: AttachmentValue[];
-    [FormElementType.simple_name]: CompositeSubmissionValue;
-    [FormElementType.address]: CompositeSubmissionValue;
+    [FormElementType.simple_name]: NameSubmissionValue;
+    [FormElementType.address]: AddressSubmissionValue;
 };
 /** Element types that carry a user-facing value (i.e. can appear in visible data). */
 type VisibleSubmissionElementType = keyof VisibleSubmissionElementValueMap;
@@ -497,4 +514,4 @@ declare class CaptelloWebview {
     private handleMessage;
 }
 
-export { type AnyOutboundListener as A, type BusinessCardValue as B, type CaptelloWebviewOptions as C, FormElementType as F, type InboundMessage as I, OutboundMessageType as O, type PrefillInfoItem as P, type SubmissionBody as S, type Unsubscribe as U, type ValidationTarget as V, type OutboundMessageMap as a, SubmissionError as b, SubmissionTimeoutError as c, type OutboundMessage as d, CaptelloWebview as e, type SubmissionPrefill as f, type AttachmentValue as g, type CompositeSubmissionValue as h, InboundMessageType as i, type OrderCheckboxSubmissionData as j, type OrderRadioSubmissionData as k, type OutboundListener as l, type SubmissionQuestionData as m, type VisibleSubmissionDataItem as n, type VisibleSubmissionElementType as o, type VisibleSubmissionElementValueMap as p, parseOutboundMessage as q };
+export { type AddressSubmissionValue as A, type BusinessCardValue as B, type CaptelloWebviewOptions as C, FormElementType as F, type InboundMessage as I, type NameSubmissionValue as N, OutboundMessageType as O, type PrefillInfoItem as P, type SubmissionBody as S, type Unsubscribe as U, type ValidationTarget as V, type OutboundMessageMap as a, SubmissionError as b, SubmissionTimeoutError as c, type OutboundMessage as d, type SubmissionPrefill as e, CaptelloWebview as f, type AnyOutboundListener as g, type AttachmentValue as h, InboundMessageType as i, type OrderCheckboxSubmissionData as j, type OrderRadioSubmissionData as k, type OutboundListener as l, type SubmissionQuestionData as m, type VisibleSubmissionDataItem as n, type VisibleSubmissionElementType as o, type VisibleSubmissionElementValueMap as p, parseOutboundMessage as q };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { A as AnyOutboundListener, g as AttachmentValue, B as BusinessCardValue, e as CaptelloWebview, C as CaptelloWebviewOptions, h as CompositeSubmissionValue, F as FormElementType, I as InboundMessage, i as InboundMessageType, j as OrderCheckboxSubmissionData, k as OrderRadioSubmissionData, l as OutboundListener, d as OutboundMessage, a as OutboundMessageMap, O as OutboundMessageType, P as PrefillInfoItem, S as SubmissionBody, b as SubmissionError, f as SubmissionPrefill, m as SubmissionQuestionData, c as SubmissionTimeoutError, U as Unsubscribe, V as ValidationTarget, n as VisibleSubmissionDataItem, o as VisibleSubmissionElementType, p as VisibleSubmissionElementValueMap, q as parseOutboundMessage } from './client-Dik-Mjid.js';
+export { A as AddressSubmissionValue, g as AnyOutboundListener, h as AttachmentValue, B as BusinessCardValue, f as CaptelloWebview, C as CaptelloWebviewOptions, F as FormElementType, I as InboundMessage, i as InboundMessageType, N as NameSubmissionValue, j as OrderCheckboxSubmissionData, k as OrderRadioSubmissionData, l as OutboundListener, d as OutboundMessage, a as OutboundMessageMap, O as OutboundMessageType, P as PrefillInfoItem, S as SubmissionBody, b as SubmissionError, e as SubmissionPrefill, m as SubmissionQuestionData, c as SubmissionTimeoutError, U as Unsubscribe, V as ValidationTarget, n as VisibleSubmissionDataItem, o as VisibleSubmissionElementType, p as VisibleSubmissionElementValueMap, q as parseOutboundMessage } from './client-CalIoKT6.js';
 
 /**
  * Builder for the Captello capture webview embed URL.

package/dist/index.js.map

@@ -1 +1 @@
-{"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"]}
+{"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/**\n * `simple_name` value: the visible sub-fields keyed by their transcription identifier\n * (`ll_field_unique_identifier`), the same identifiers used by prefill. Hidden sub-fields are\n * omitted, so keys are optional.\n */\nexport type NameSubmissionValue = {\n    FirstName?: string;\n    LastName?: string;\n};\n\n/**\n * `address` value: the visible sub-fields keyed by their transcription identifier\n * (`ll_field_unique_identifier`). Hidden sub-fields are omitted, so keys are optional.\n */\nexport type AddressSubmissionValue = {\n    StreetAddress?: string;\n    StreetAddress2?: string;\n    City?: string;\n    State?: string;\n    Zipcode?: string;\n    Country?: string;\n};\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]: NameSubmissionValue;\n    [FormElementType.address]: AddressSubmissionValue;\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-Dik-Mjid.js';
-export { b as SubmissionError, c as SubmissionTimeoutError } from './client-Dik-Mjid.js';
+import { C as CaptelloWebviewOptions, S as SubmissionBody, O as OutboundMessageType, a as OutboundMessageMap } from './client-CalIoKT6.js';
+export { b as SubmissionError, c as SubmissionTimeoutError } from './client-CalIoKT6.js';
 
 /**
  * Promise-based, one-shot helpers for imperative flows — `@captello/ulc-webview-sdk/promises`.

package/dist/react.d.ts

@@ -1,18 +1,33 @@
 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 { C as CaptelloWebviewOptions, S as SubmissionBody, d as OutboundMessage, e as SubmissionPrefill, P as PrefillInfoItem, f as CaptelloWebview, V as ValidationTarget } from './client-CalIoKT6.js';
+export { b as SubmissionError, c as SubmissionTimeoutError, U as Unsubscribe } from './client-CalIoKT6.js';
 import { EmbedUrlOptions } from './index.js';
 
-/** Per-message-type callback props accepted by {@link useCaptelloWebview}. */
+/**
+ * Per-message-type callback props accepted by {@link useCaptelloWebview}.
+ *
+ * Each callback receives the message's **payload**, not the message envelope — the
+ * callback name already carries the `type`, so there is nothing to discriminate on.
+ * Messages that carry no payload take no argument.
+ *
+ * {@link CaptelloWebviewCallbacks.onAnyMessage} is the exception: it fires for every
+ * type, so it gets the whole message including the `type` discriminator.
+ */
 interface CaptelloWebviewCallbacks {
-    onFormLoadComplete?: (message: OutboundMessageMap[OutboundMessageType.FormLoadComplete]) => void;
-    onFormErrorMessage?: (message: OutboundMessageMap[OutboundMessageType.FormErrorMessage]) => void;
-    onSubmissionBody?: (message: OutboundMessageMap[OutboundMessageType.SubmissionBody]) => void;
-    onFormSubmitSuccess?: (message: OutboundMessageMap[OutboundMessageType.FormSubmitSuccess]) => void;
-    onConnexionsProfileRedirect?: (message: OutboundMessageMap[OutboundMessageType.ConnexionsProfileRedirect]) => void;
-    onConnexionsDownloadVcard?: (message: OutboundMessageMap[OutboundMessageType.ConnexionsDownloadVcard]) => void;
-    /** Catch-all: called for every outbound message, after the specific handler above. */
+    /** The form finished loading and rendering. Safe to interact with it after this. */
+    onFormLoadComplete?: () => void;
+    /** A user-facing error occurred. Receives the translated, display-ready text. */
+    onFormErrorMessage?: (message: string) => void;
+    /** Receives the full submission body, for the host to persist / forward. */
+    onSubmissionBody?: (body: SubmissionBody) => void;
+    /** The form was submitted successfully. Receives whether it created or updated. */
+    onFormSubmitSuccess?: (action: "create" | "update") => void;
+    /** Connexions: the host should perform the profile redirect (embed mode). */
+    onConnexionsProfileRedirect?: () => void;
+    /** Connexions: the host should trigger the vCard download (embed mode). */
+    onConnexionsDownloadVcard?: () => void;
+    /** Catch-all: the full message, including `type`. Called after the specific handler above. */
     onAnyMessage?: (message: OutboundMessage) => void;
 }
 /** Embed-URL config: a base URL plus {@link EmbedUrlOptions}. */
@@ -25,28 +40,54 @@ interface EmbedUrlConfig extends EmbedUrlOptions {
     baseUrl: string;
 }
 /**
- * Options for {@link useCaptelloWebview}.
+ * Values to seed a form with on load — see {@link UseCaptelloWebviewOptions.defaultFormValues}.
+ *
+ * `submission` is typed as {@link SubmissionPrefill} (every field optional) so a partial
+ * is valid; a whole {@link SubmissionBody} echoed back from `onSubmissionBody` also fits.
+ */
+interface DefaultFormValues {
+    /** Values keyed by element id / sub-element id, under `data`. */
+    submission?: SubmissionPrefill;
+    /** Field values matched by `ll_field_unique_identifier` (e.g. `"Email"`). */
+    info?: PrefillInfoItem[];
+}
+/**
+ * Options for {@link useCaptelloWebview}: the embed config, message callbacks, and the
+ * usual client options.
  *
- * Provide **either** `embedUrl` (the hook builds the URL and derives `targetOrigin`,
- * returning `iframeProps.src`) **or** your own `targetOrigin` (you set the iframe `src`
- * yourself). Plus message callbacks and the usual client options.
+ * `embedUrl` is required — the hook builds the URL from it, derives `targetOrigin`, and
+ * returns it as `iframeProps.src`. Any `targetOrigin` you pass is ignored; drop to
+ * {@link CaptelloWebview} directly if you need to own both the URL and the origin.
  */
-interface UseCaptelloWebviewOptions extends CaptelloWebviewOptions, CaptelloWebviewCallbacks {
+interface UseCaptelloWebviewOptions extends Omit<CaptelloWebviewOptions, "targetOrigin">, CaptelloWebviewCallbacks {
     /** Build the iframe URL and derive `targetOrigin` from it. Sets `iframeProps.src`. */
-    embedUrl?: EmbedUrlConfig;
+    embedUrl: EmbedUrlConfig;
+    /**
+     * Values to populate the form with as soon as it is ready. Saves you from wiring a
+     * `ref` and calling `prefill(...)` from an effect just to seed the form.
+     *
+     * Sent as the *first* outbound message, so a later explicit `prefill(...)` wins.
+     * Read once when the client attaches — changing the value afterwards does **not**
+     * re-populate the form (these are defaults, not controlled values); call `prefill(...)`
+     * for that. No memoization needed: an inline object literal is fine.
+     *
+     * @example
+     * defaultFormValues={{ info: [{ ll_field_unique_identifier: "Email", value: user.email }] }}
+     */
+    defaultFormValues?: DefaultFormValues;
 }
 /** Readiness of the embedded form. */
 type CaptelloWebviewStatus = "loading" | "ready" | "error";
-/** Props to spread onto the `<iframe>`. `src` is present only when `embedUrl` is given. */
+/** Props to spread onto the `<iframe>` — the ref plus the `embedUrl`-derived `src`. */
 interface CaptelloIframeProps {
     ref: RefCallback<HTMLIFrameElement | null>;
-    src?: string;
+    src: string;
 }
 /** What {@link useCaptelloWebview} returns. */
 interface UseCaptelloWebviewResult {
-    /** Spread onto your iframe: `<iframe {...iframeProps} />`. Includes `src` if `embedUrl` was given. */
+    /** Spread onto your iframe: `<iframe {...iframeProps} />`. Carries the `embedUrl`-derived `src`. */
     iframeProps: CaptelloIframeProps;
-    /** The iframe ref callback (same as `iframeProps.ref`), if you'd rather set `src` yourself. */
+    /** The iframe ref callback (same as `iframeProps.ref`), if you'd rather wire `src` yourself. */
     ref: RefCallback<HTMLIFrameElement | null>;
     /** `true` once the form has reported `form_load_complete`. */
     isReady: boolean;
@@ -82,7 +123,7 @@ interface CaptelloFormHandle extends Pick<UseCaptelloWebviewResult, "submit" | "
     getIframe: () => HTMLIFrameElement | null;
 }
 /**
- * Props for {@link CaptelloForm}: every {@link useCaptelloWebviewOptions} option (embed
+ * Props for {@link CaptelloForm}: every {@link UseCaptelloWebviewOptions} option (embed
  * config + message callbacks + client options) plus rendering conveniences.
  */
 interface CaptelloFormProps extends UseCaptelloWebviewOptions {
@@ -94,8 +135,8 @@ interface CaptelloFormProps extends UseCaptelloWebviewOptions {
     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.
+     * Defaults: `title="Captello form"`, `allow="camera; microphone; geolocation"`.
+     * `src` is ignored: it comes from `embedUrl`.
      */
     iframeProps?: Omit<IframeHTMLAttributes<HTMLIFrameElement>, "ref">;
     /** Rendered, centered over the iframe, while it is loading. The iframe stays mounted underneath. */
@@ -117,12 +158,12 @@ interface CaptelloFormProps extends UseCaptelloWebviewOptions {
  * 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.
+ * `embedUrl` is required 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 }) {
+ * function UlcForm({ token, email }: { token: string; email: string }) {
  *   const ref = useRef<CaptelloFormHandle>(null);
  *   return (
  *     <CaptelloForm
@@ -134,7 +175,8 @@ interface CaptelloFormProps extends UseCaptelloWebviewOptions {
  *         mode: FormMode.Submit,
  *         launcher: LauncherType.EventGenWeb,
  *       }}
- *       onSubmissionBody={(m) => save(m.data)}
+ *       defaultFormValues={{ info: [{ ll_field_unique_identifier: "Email", value: email }] }}
+ *       onSubmissionBody={save}
  *       loading={<Spinner />}
  *       error={(msg) => <ErrorBanner>{msg}</ErrorBanner>}
  *     >
@@ -145,4 +187,4 @@ interface CaptelloFormProps extends UseCaptelloWebviewOptions {
  */
 declare const CaptelloForm: react.ForwardRefExoticComponent<CaptelloFormProps & react.RefAttributes<CaptelloFormHandle>>;
 
-export { CaptelloForm, type CaptelloFormHandle, type CaptelloFormProps, 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 DefaultFormValues, type EmbedUrlConfig, type UseCaptelloWebviewOptions, type UseCaptelloWebviewResult, useCaptelloWebview };

package/dist/react.js

@@ -4,18 +4,32 @@ export { CaptelloWebview, SubmissionError, SubmissionTimeoutError } from './chun
 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",
-  ["form_error_message" /* FormErrorMessage */]: "onFormErrorMessage",
-  ["submission_body" /* SubmissionBody */]: "onSubmissionBody",
-  ["form_submit_success" /* FormSubmitSuccess */]: "onFormSubmitSuccess",
-  ["connexions_profile_redirect" /* ConnexionsProfileRedirect */]: "onConnexionsProfileRedirect",
-  ["connexions_download_vcard" /* ConnexionsDownloadVcard */]: "onConnexionsDownloadVcard"
-};
+function dispatchToCallback(callbacks, message) {
+  switch (message.type) {
+    case "form_load_complete" /* FormLoadComplete */:
+      callbacks.onFormLoadComplete?.();
+      break;
+    case "form_error_message" /* FormErrorMessage */:
+      callbacks.onFormErrorMessage?.(message.data);
+      break;
+    case "submission_body" /* SubmissionBody */:
+      callbacks.onSubmissionBody?.(message.data);
+      break;
+    case "form_submit_success" /* FormSubmitSuccess */:
+      callbacks.onFormSubmitSuccess?.(message.action);
+      break;
+    case "connexions_profile_redirect" /* ConnexionsProfileRedirect */:
+      callbacks.onConnexionsProfileRedirect?.();
+      break;
+    case "connexions_download_vcard" /* ConnexionsDownloadVcard */:
+      callbacks.onConnexionsDownloadVcard?.();
+      break;
+  }
+}
 function useCaptelloWebview(options) {
   const { embedUrl, matchSource, queueUntilReady, hostWindow } = options;
-  const src = embedUrl ? buildEmbedUrl(embedUrl.baseUrl, embedUrl) : void 0;
-  const targetOrigin = src ? new URL(src).origin : options.targetOrigin;
+  const src = buildEmbedUrl(embedUrl.baseUrl, embedUrl);
+  const targetOrigin = new URL(src).origin;
   const optionsRef = useRef(options);
   optionsRef.current = options;
   const clientRef = useRef(null);
@@ -38,13 +52,27 @@ function useCaptelloWebview(options) {
       });
       clientRef.current = client;
       const offs = [];
+      const defaults = optionsRef.current.defaultFormValues;
+      if (defaults && (defaults.submission != null || defaults.info != null)) {
+        if (optionsRef.current.queueUntilReady === false) {
+          offs.push(
+            client.once("form_load_complete" /* FormLoadComplete */, () => {
+              try {
+                client.prefill(defaults);
+              } catch {
+              }
+            })
+          );
+        } else {
+          client.prefill(defaults);
+        }
+      }
       for (const type of Object.values(OutboundMessageType)) {
         offs.push(
           client.on(type, (message) => {
             if (type === "form_load_complete" /* FormLoadComplete */) setStatus("ready");
             else if (type === "form_error_message" /* FormErrorMessage */) setStatus("error");
-            const handler = optionsRef.current[CALLBACK_BY_TYPE[type]];
-            handler?.(message);
+            dispatchToCallback(optionsRef.current, message);
             optionsRef.current.onAnyMessage?.(message);
           })
         );
@@ -85,7 +113,7 @@ function useCaptelloWebview(options) {
     }
     return client.submitAndWait(timeoutMs);
   }, []);
-  const iframeProps = src ? { ref: attach, src } : { ref: attach };
+  const iframeProps = { ref: attach, src };
   return {
     iframeProps,
     ref: attach,
@@ -129,12 +157,12 @@ function CaptelloFormImpl(props, ref) {
     // 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) => {
+    onFormLoadComplete: () => {
       setErrorMessage(void 0);
-      onFormLoadComplete?.(message);
+      onFormLoadComplete?.();
     },
     onFormErrorMessage: (message) => {
-      setErrorMessage(message.data);
+      setErrorMessage(message);
       onFormErrorMessage?.(message);
     }
   });
@@ -163,7 +191,6 @@ function CaptelloFormImpl(props, ref) {
     }),
     [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: [
@@ -175,7 +202,7 @@ function CaptelloFormImpl(props, ref) {
           allow: DEFAULT_ALLOW,
           ...iframeProps,
           ref: setIframe,
-          src,
+          src: api.iframeProps.src,
           style: { ...IFRAME_STYLE, ...iframeProps?.style }
         }
       ),

package/dist/react.js.map

@@ -1 +1 @@
-{"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"]}
+{"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. To seed a form declaratively, pass\n * `defaultFormValues` instead and skip the `prefill(...)` wiring entirely.\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: onSubmitted,\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    PrefillInfoItem,\n    SubmissionBody,\n    SubmissionPrefill,\n    ValidationTarget,\n} from \"./messages\";\n\n/**\n * Per-message-type callback props accepted by {@link useCaptelloWebview}.\n *\n * Each callback receives the message's **payload**, not the message envelope — the\n * callback name already carries the `type`, so there is nothing to discriminate on.\n * Messages that carry no payload take no argument.\n *\n * {@link CaptelloWebviewCallbacks.onAnyMessage} is the exception: it fires for every\n * type, so it gets the whole message including the `type` discriminator.\n */\nexport interface CaptelloWebviewCallbacks {\n    /** The form finished loading and rendering. Safe to interact with it after this. */\n    onFormLoadComplete?: () => void;\n    /** A user-facing error occurred. Receives the translated, display-ready text. */\n    onFormErrorMessage?: (message: string) => void;\n    /** Receives the full submission body, for the host to persist / forward. */\n    onSubmissionBody?: (body: SubmissionBody) => void;\n    /** The form was submitted successfully. Receives whether it created or updated. */\n    onFormSubmitSuccess?: (action: \"create\" | \"update\") => void;\n    /** Connexions: the host should perform the profile redirect (embed mode). */\n    onConnexionsProfileRedirect?: () => void;\n    /** Connexions: the host should trigger the vCard download (embed mode). */\n    onConnexionsDownloadVcard?: () => void;\n    /** Catch-all: the full message, including `type`. Called 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 * Values to seed a form with on load — see {@link UseCaptelloWebviewOptions.defaultFormValues}.\n *\n * `submission` is typed as {@link SubmissionPrefill} (every field optional) so a partial\n * is valid; a whole {@link SubmissionBody} echoed back from `onSubmissionBody` also fits.\n */\nexport interface DefaultFormValues {\n    /** Values keyed by element id / sub-element id, under `data`. */\n    submission?: SubmissionPrefill;\n    /** Field values matched by `ll_field_unique_identifier` (e.g. `\"Email\"`). */\n    info?: PrefillInfoItem[];\n}\n\n/**\n * Options for {@link useCaptelloWebview}: the embed config, message callbacks, and the\n * usual client options.\n *\n * `embedUrl` is required — the hook builds the URL from it, derives `targetOrigin`, and\n * returns it as `iframeProps.src`. Any `targetOrigin` you pass is ignored; drop to\n * {@link CaptelloWebview} directly if you need to own both the URL and the origin.\n */\nexport interface UseCaptelloWebviewOptions extends Omit<CaptelloWebviewOptions, \"targetOrigin\">, CaptelloWebviewCallbacks {\n    /** Build the iframe URL and derive `targetOrigin` from it. Sets `iframeProps.src`. */\n    embedUrl: EmbedUrlConfig;\n    /**\n     * Values to populate the form with as soon as it is ready. Saves you from wiring a\n     * `ref` and calling `prefill(...)` from an effect just to seed the form.\n     *\n     * Sent as the *first* outbound message, so a later explicit `prefill(...)` wins.\n     * Read once when the client attaches — changing the value afterwards does **not**\n     * re-populate the form (these are defaults, not controlled values); call `prefill(...)`\n     * for that. No memoization needed: an inline object literal is fine.\n     *\n     * @example\n     * defaultFormValues={{ info: [{ ll_field_unique_identifier: \"Email\", value: user.email }] }}\n     */\n    defaultFormValues?: DefaultFormValues;\n}\n\n/** Readiness of the embedded form. */\nexport type CaptelloWebviewStatus = \"loading\" | \"ready\" | \"error\";\n\n/** Props to spread onto the `<iframe>` — the ref plus the `embedUrl`-derived `src`. */\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} />`. Carries the `embedUrl`-derived `src`. */\n    iframeProps: CaptelloIframeProps;\n    /** The iframe ref callback (same as `iframeProps.ref`), if you'd rather wire `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\n/**\n * Unwraps `message` to its payload and calls the matching callback.\n *\n * Exhaustive over {@link OutboundMessageType}: adding a message type without handling it\n * here is a compile error, so a new type can't silently go undelivered.\n */\nfunction dispatchToCallback(callbacks: CaptelloWebviewCallbacks, message: OutboundMessage): void {\n    switch (message.type) {\n        case OutboundMessageType.FormLoadComplete:\n            callbacks.onFormLoadComplete?.();\n            break;\n        case OutboundMessageType.FormErrorMessage:\n            callbacks.onFormErrorMessage?.(message.data);\n            break;\n        case OutboundMessageType.SubmissionBody:\n            callbacks.onSubmissionBody?.(message.data);\n            break;\n        case OutboundMessageType.FormSubmitSuccess:\n            callbacks.onFormSubmitSuccess?.(message.action);\n            break;\n        case OutboundMessageType.ConnexionsProfileRedirect:\n            callbacks.onConnexionsProfileRedirect?.();\n            break;\n        case OutboundMessageType.ConnexionsDownloadVcard:\n            callbacks.onConnexionsDownloadVcard?.();\n            break;\n        default: {\n            const exhaustive: never = message;\n            void exhaustive;\n        }\n    }\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    // Build the iframe URL and scope messaging to its origin. Recomputed on every render\n    // (cheap), but only the derived origin feeds `attach`'s deps, so a same-origin URL\n    // change doesn't tear the client down.\n    const src = buildEmbedUrl(embedUrl.baseUrl, embedUrl);\n    const targetOrigin = new URL(src).origin;\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\n            // Seed the form with `defaultFormValues`. With `queueUntilReady` (the default)\n            // this lands first in the outbox and flushes on load, so an explicit prefill()\n            // made later still wins. With queueing off there's no outbox to ride in on, so\n            // wait for the form to report in — subscribed before the callback loop below,\n            // to seed before the caller's onFormLoadComplete runs.\n            const defaults = optionsRef.current.defaultFormValues;\n            if (defaults && (defaults.submission != null || defaults.info != null)) {\n                if (optionsRef.current.queueUntilReady === false) {\n                    offs.push(\n                        client.once(OutboundMessageType.FormLoadComplete, () => {\n                            try {\n                                client.prefill(defaults);\n                            } catch {\n                                /* iframe detached between load and seed — drop silently */\n                            }\n                        }),\n                    );\n                } else {\n                    client.prefill(defaults);\n                }\n            }\n\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                        dispatchToCallback(optionsRef.current, 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 = { ref: attach, src };\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\"`.\n     * `src` is ignored: it comes from `embedUrl`.\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: () => {\n            setErrorMessage(undefined);\n            onFormLoadComplete?.();\n        },\n        onFormErrorMessage: (message) => {\n            setErrorMessage(message);\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    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={api.iframeProps.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 * `embedUrl` is required and the form fills its wrapper — size the form via `className` /\n * `style` (an iframe has no intrinsic height). Reach for {@link useCaptelloWebview} instead\n * when you need to own the markup.\n *\n * @example\n * function UlcForm({ token, email }: { token: string; email: 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 *       defaultFormValues={{ info: [{ ll_field_unique_identifier: \"Email\", value: email }] }}\n *       onSubmissionBody={save}\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,78 +1,79 @@
 {
-  "name": "@captello/ulc-webview-sdk",
-  "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",
-  "type": "module",
-  "sideEffects": false,
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "promises": [
-        "./dist/promises.d.ts"
-      ],
-      "react": [
-        "./dist/react.d.ts"
-      ]
-    }
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+    "name": "@captello/ulc-webview-sdk",
+    "version": "1.0.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,
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "typesVersions": {
+        "*": {
+            "promises": [
+                "./dist/promises.d.ts"
+            ],
+            "react": [
+                "./dist/react.d.ts"
+            ]
+        }
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        },
+        "./promises": {
+            "types": "./dist/promises.d.ts",
+            "import": "./dist/promises.js"
+        },
+        "./react": {
+            "types": "./dist/react.d.ts",
+            "import": "./dist/react.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "dist",
+        "LICENSE",
+        "CHANGELOG.md"
+    ],
+    "scripts": {
+        "build": "tsup",
+        "dev": "tsup --watch",
+        "typecheck": "tsc --noEmit",
+        "typecheck:test": "tsc -p tsconfig.test.json",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "clean": "rm -rf dist"
+    },
+    "keywords": [
+        "captello",
+        "webview",
+        "iframe",
+        "postmessage",
+        "embed",
+        "sdk"
+    ],
+    "peerDependencies": {
+        "react": ">=18"
     },
-    "./promises": {
-      "types": "./dist/promises.d.ts",
-      "import": "./dist/promises.js"
+    "peerDependenciesMeta": {
+        "react": {
+            "optional": true
+        }
     },
-    "./react": {
-      "types": "./dist/react.d.ts",
-      "import": "./dist/react.js"
+    "devDependencies": {
+        "@testing-library/react": "16.1.0",
+        "@types/react": "19.2.2",
+        "jsdom": "25.0.1",
+        "react": "19.2.2",
+        "react-dom": "19.2.2",
+        "tsup": "8.3.5",
+        "typescript": "5.9.3",
+        "vitest": "2.1.9"
     },
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "dist",
-    "LICENSE"
-  ],
-  "keywords": [
-    "captello",
-    "webview",
-    "iframe",
-    "postmessage",
-    "embed",
-    "sdk"
-  ],
-  "peerDependencies": {
-    "react": ">=18"
-  },
-  "peerDependenciesMeta": {
-    "react": {
-      "optional": true
+    "publishConfig": {
+        "access": "public"
     }
-  },
-  "devDependencies": {
-    "@testing-library/react": "16.1.0",
-    "@types/react": "19.2.2",
-    "jsdom": "25.0.1",
-    "react": "19.2.2",
-    "react-dom": "19.2.2",
-    "tsup": "8.3.5",
-    "typescript": "5.9.3",
-    "vitest": "2.1.9"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit",
-    "typecheck:test": "tsc -p tsconfig.test.json",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "clean": "rm -rf dist"
-  }
-}
+}