@captello/ulc-webview-sdk 1.2.0 → 1.3.0

package/dist/app-host.d.ts

@@ -1,228 +0,0 @@
-import { P as PrefillInfoItem, U as Unsubscribe } from './client-CAMlFA8s.js';
-
-/**
- * Pages embedded inside the Captello mobile app — `@captello/ulc-webview-sdk/app`.
- *
- * The mobile app hosts web pages (the meeting platform, Connexions, …) in an iframe and
- * offers them native services over `postMessage`: an auth token, the badge scanner,
- * back navigation, sharing. This module is the page-side client for that channel.
- *
- * It is the mirror image of {@link CaptelloWebview}: there your page is the host and
- * the Captello capture webview is the child; here the Captello *app* is the host and
- * your page is the child. The wire format differs too — match it exactly:
- * - Messages are posted as **plain objects**, not JSON strings.
- * - `type` values are SCREAMING_CASE.
- * - Requests (page → app) and responses (app → page) are disjoint enums.
- *
- * @example
- * import { CaptelloAppHost } from "@captello/ulc-webview-sdk/app";
- *
- * const app = new CaptelloAppHost();
- * const token = await app.requestAuthToken();
- * app.notifyReady();
- * const [person] = await app.openScanner();
- */
-
-/** Message `type` values a page sends to the Captello app. */
-declare enum AppRequestType {
-    /** The page finished loading; the app hides its loading spinner. */
-    AppReady = "APP_READY",
-    /** A user-facing error; the app shows `message`. */
-    Error = "ERROR",
-    /** Close the page (the app dismisses the modal or pops the route). */
-    NavigateBack = "NAVIGATE_BACK",
-    /** Ask for a magic token; answered with {@link AppResponseType.AuthToken}. */
-    RequestAuthToken = "REQUEST_AUTH_TOKEN",
-    /**
-     * Open the app's badge scanner. Answered with one
-     * {@link AppResponseType.ScannerResult} per scanned person, then
-     * {@link AppResponseType.ScannerClosed}.
-     */
-    OpenScanner = "OPEN_ULC_FORM_SCANNER",
-    /** Open `url` in the system browser. */
-    OpenUrl = "OPEN_URL",
-    /** Copy `text` to the clipboard; acknowledged with `COPIED_SUCCESS` / `COPIED_ERROR`. */
-    CopyText = "COPY_TEXT",
-    /** Open the native share sheet. */
-    ShareUrl = "SHARE_URL",
-    /** Save a vCard to the contacts; acknowledged with `SAVE_VCARD_SUCCESS` / `SAVE_VCARD_ERROR`. */
-    SaveVCard = "SAVE_VCARD",
-    /** Add a wallet pass; acknowledged with `ADD_TO_WALLET_SUCCESS` / `ADD_TO_WALLET_ERROR`. */
-    AddToWallet = "ADD_TO_WALLET",
-    /** Ask the app to synchronize its data. */
-    SyncApp = "SYNC_APP"
-}
-interface AppReadyRequest {
-    type: AppRequestType.AppReady;
-}
-interface ErrorRequest {
-    type: AppRequestType.Error;
-    message: string;
-}
-interface NavigateBackRequest {
-    type: AppRequestType.NavigateBack;
-}
-interface RequestAuthTokenRequest {
-    type: AppRequestType.RequestAuthToken;
-}
-interface OpenScannerRequest {
-    type: AppRequestType.OpenScanner;
-}
-interface OpenUrlRequest {
-    type: AppRequestType.OpenUrl;
-    url: string;
-}
-interface CopyTextRequest {
-    type: AppRequestType.CopyText;
-    text: string;
-}
-interface ShareUrlRequest {
-    type: AppRequestType.ShareUrl;
-    title: string;
-    text: string;
-}
-interface SaveVCardRequest {
-    type: AppRequestType.SaveVCard;
-    /** vCard text. */
-    text: string;
-}
-interface AddToWalletRequest {
-    type: AppRequestType.AddToWallet;
-    /** Base64 pass data, with or without a `data:` prefix. */
-    text: string;
-}
-interface SyncAppRequest {
-    type: AppRequestType.SyncApp;
-}
-/** Discriminated union of every message a page can send to the app. */
-type AppRequest = AppReadyRequest | ErrorRequest | NavigateBackRequest | RequestAuthTokenRequest | OpenScannerRequest | OpenUrlRequest | CopyTextRequest | ShareUrlRequest | SaveVCardRequest | AddToWalletRequest | SyncAppRequest;
-/** Message `type` values the Captello app sends to a page. */
-declare enum AppResponseType {
-    /** Answer to {@link AppRequestType.RequestAuthToken}. */
-    AuthToken = "AUTH_TOKEN",
-    /** One scanned person (or a scanner failure) after {@link AppRequestType.OpenScanner}. */
-    ScannerResult = "ULC_FORM_SCANNER_RESULT",
-    /** The scanner session ended: every result was posted, or the user cancelled. */
-    ScannerClosed = "ULC_FORM_SCANNER_CLOSED",
-    CopiedSuccess = "COPIED_SUCCESS",
-    CopiedError = "COPIED_ERROR",
-    SaveVCardSuccess = "SAVE_VCARD_SUCCESS",
-    SaveVCardError = "SAVE_VCARD_ERROR",
-    AddToWalletSuccess = "ADD_TO_WALLET_SUCCESS",
-    AddToWalletError = "ADD_TO_WALLET_ERROR"
-}
-/** App → page: the magic token requested with {@link AppRequestType.RequestAuthToken}. */
-interface AuthTokenMessage {
-    type: AppResponseType.AuthToken;
-    token: string;
-}
-/**
- * App → page: one scanned person, or a scanner failure.
- *
- * The app posts one of these per person the scanner captured — several for a group
- * scan — then a {@link ScannerClosedMessage}. `result` holds the looked-up attendee
- * fields in the same shape {@link PrefillInfoItem} uses, so they can be fed straight to
- * a capture form's `prefill({ info })`. It is empty (not absent) when the badge had no
- * lookup data; the badge can still be linked via `badgeId`.
- *
- * On failure `result` is absent and `message` carries the error text.
- */
-interface ScannerResultMessage {
-    type: AppResponseType.ScannerResult;
-    /**
-     * Badge ID the person was scanned from. Empty for business cards and manual search.
-     * Absent altogether on app builds that predate multi-person sessions — those post a
-     * single result and never a {@link ScannerClosedMessage}.
-     */
-    badgeId?: string;
-    /** Looked-up attendee fields (success). */
-    result?: PrefillInfoItem[];
-    /** Error text (failure) — `result` is absent. */
-    message?: string;
-}
-/** App → page: the scanner session ended. Follows the last {@link ScannerResultMessage}. */
-interface ScannerClosedMessage {
-    type: AppResponseType.ScannerClosed;
-}
-interface AckMessage<T extends AppResponseType> {
-    type: T;
-}
-/** Discriminated union of every message the app can send to a page. */
-type AppResponse = AuthTokenMessage | ScannerResultMessage | ScannerClosedMessage | AckMessage<AppResponseType.CopiedSuccess> | AckMessage<AppResponseType.CopiedError> | AckMessage<AppResponseType.SaveVCardSuccess> | AckMessage<AppResponseType.SaveVCardError> | AckMessage<AppResponseType.AddToWalletSuccess> | AckMessage<AppResponseType.AddToWalletError>;
-/** Maps each response `type` to its full message shape (used by {@link CaptelloAppHost.on}). */
-type AppResponseMap = {
-    [M in AppResponse as M["type"]]: M;
-};
-/** One person captured by the app's scanner, as resolved by {@link CaptelloAppHost.openScanner}. */
-interface ScannedPerson {
-    /** Badge ID the person was scanned from; empty for business cards and manual search. */
-    badgeId: string;
-    /** Looked-up attendee fields; empty when the badge had no lookup data. */
-    fields: PrefillInfoItem[];
-}
-/** Rejection reason from {@link CaptelloAppHost.openScanner} when the app reports a failure. */
-declare class ScannerError extends Error {
-    constructor(message: string);
-}
-/**
- * Parses a raw `MessageEvent.data` value into a typed {@link AppResponse}, or returns
- * `null` if it is not a recognized Captello app message.
- *
- * The app posts plain objects; a JSON string is accepted too for robustness.
- */
-declare function parseAppResponse(data: unknown): AppResponse | null;
-/** Listener for a specific app response type. */
-type AppResponseListener<T extends AppResponseType> = (message: AppResponseMap[T]) => void;
-interface CaptelloAppHostOptions {
-    /** Window the app is listening on. Defaults to `window.parent`. */
-    appWindow?: Window;
-    /** Window to receive the app's responses on. Defaults to `window`. */
-    pageWindow?: Window;
-    /**
-     * `targetOrigin` for outgoing `postMessage` calls. Defaults to `"*"`: the app's
-     * webview origin differs per platform (`capacitor://localhost`, `http://localhost`),
-     * and the page only ever runs inside the app when it uses this channel.
-     */
-    targetOrigin?: string;
-}
-/**
- * Page-side client for the Captello mobile app that embeds the page.
- *
- * Construct one per page and keep it for the page's lifetime. It attaches a single
- * `message` listener on construction; call {@link destroy} to remove it.
- */
-declare class CaptelloAppHost {
-    private readonly appWindow;
-    private readonly pageWindow;
-    private readonly targetOrigin;
-    private readonly listeners;
-    private readonly boundHandler;
-    private destroyed;
-    constructor(options?: CaptelloAppHostOptions);
-    /** Post a request to the app. Prefer the typed methods; this is the escape hatch. */
-    send(request: AppRequest): void;
-    /** Subscribe to a response type. Returns a handle with `unsubscribe()` (also callable). */
-    on<T extends AppResponseType>(type: T, listener: AppResponseListener<T>): Unsubscribe;
-    /** Tell the app the page is ready; it hides its loading spinner. */
-    notifyReady(): void;
-    /** Show a user-facing error in the app. */
-    notifyError(message: string): void;
-    /** Ask the app to close the page. */
-    navigateBack(): void;
-    /** Resolves with the magic token the app mints for the current user. */
-    requestAuthToken(): Promise<string>;
-    /**
-     * Opens the app's badge scanner and resolves once the session ends with every
-     * person it captured, in scan order — several for a group scan, none if the user
-     * cancelled. Rejects with a {@link ScannerError} if the app reports a failure.
-     *
-     * A badge whose lookup returned nothing is still included, with its `badgeId` and
-     * empty `fields`, so it can be linked to the attendee.
-     */
-    openScanner(): Promise<ScannedPerson[]>;
-    /** Remove the `message` listener and drop every subscription. Safe to call more than once. */
-    destroy(): void;
-    private handleMessage;
-}
-
-export { type AppRequest, AppRequestType, type AppResponse, type AppResponseListener, type AppResponseMap, AppResponseType, type AuthTokenMessage, CaptelloAppHost, type CaptelloAppHostOptions, type ScannedPerson, type ScannerClosedMessage, ScannerError, type ScannerResultMessage, parseAppResponse };

package/dist/app-host.js

@@ -1,170 +0,0 @@
-// src/app-host.ts
-var AppRequestType = /* @__PURE__ */ ((AppRequestType2) => {
-  AppRequestType2["AppReady"] = "APP_READY";
-  AppRequestType2["Error"] = "ERROR";
-  AppRequestType2["NavigateBack"] = "NAVIGATE_BACK";
-  AppRequestType2["RequestAuthToken"] = "REQUEST_AUTH_TOKEN";
-  AppRequestType2["OpenScanner"] = "OPEN_ULC_FORM_SCANNER";
-  AppRequestType2["OpenUrl"] = "OPEN_URL";
-  AppRequestType2["CopyText"] = "COPY_TEXT";
-  AppRequestType2["ShareUrl"] = "SHARE_URL";
-  AppRequestType2["SaveVCard"] = "SAVE_VCARD";
-  AppRequestType2["AddToWallet"] = "ADD_TO_WALLET";
-  AppRequestType2["SyncApp"] = "SYNC_APP";
-  return AppRequestType2;
-})(AppRequestType || {});
-var AppResponseType = /* @__PURE__ */ ((AppResponseType2) => {
-  AppResponseType2["AuthToken"] = "AUTH_TOKEN";
-  AppResponseType2["ScannerResult"] = "ULC_FORM_SCANNER_RESULT";
-  AppResponseType2["ScannerClosed"] = "ULC_FORM_SCANNER_CLOSED";
-  AppResponseType2["CopiedSuccess"] = "COPIED_SUCCESS";
-  AppResponseType2["CopiedError"] = "COPIED_ERROR";
-  AppResponseType2["SaveVCardSuccess"] = "SAVE_VCARD_SUCCESS";
-  AppResponseType2["SaveVCardError"] = "SAVE_VCARD_ERROR";
-  AppResponseType2["AddToWalletSuccess"] = "ADD_TO_WALLET_SUCCESS";
-  AppResponseType2["AddToWalletError"] = "ADD_TO_WALLET_ERROR";
-  return AppResponseType2;
-})(AppResponseType || {});
-var ScannerError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "ScannerError";
-  }
-};
-var RESPONSE_TYPES = new Set(Object.values(AppResponseType));
-function isPlainObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function parseAppResponse(data) {
-  let value = data;
-  if (typeof value === "string") {
-    try {
-      value = JSON.parse(value);
-    } catch {
-      return null;
-    }
-  }
-  if (!isPlainObject(value)) return null;
-  if (typeof value["type"] !== "string" || !RESPONSE_TYPES.has(value["type"])) return null;
-  return value;
-}
-function makeSubscription(off) {
-  const handle = () => {
-    off();
-  };
-  handle.unsubscribe = off;
-  return handle;
-}
-var CaptelloAppHost = class {
-  constructor(options = {}) {
-    this.listeners = /* @__PURE__ */ new Map();
-    this.boundHandler = (event) => this.handleMessage(event);
-    this.destroyed = false;
-    const pageWindow = options.pageWindow ?? (typeof window !== "undefined" ? window : void 0);
-    if (!pageWindow) {
-      throw new Error(
-        "CaptelloAppHost: no page window available. Pass `pageWindow` when constructing outside a browser."
-      );
-    }
-    this.pageWindow = pageWindow;
-    this.appWindow = options.appWindow ?? pageWindow.parent;
-    this.targetOrigin = options.targetOrigin ?? "*";
-    this.pageWindow.addEventListener("message", this.boundHandler);
-  }
-  /** Post a request to the app. Prefer the typed methods; this is the escape hatch. */
-  send(request) {
-    if (this.destroyed) return;
-    this.appWindow.postMessage(request, this.targetOrigin);
-  }
-  /** Subscribe to a response type. Returns a handle with `unsubscribe()` (also callable). */
-  on(type, listener) {
-    let set = this.listeners.get(type);
-    if (!set) {
-      set = /* @__PURE__ */ new Set();
-      this.listeners.set(type, set);
-    }
-    set.add(listener);
-    return makeSubscription(() => {
-      set?.delete(listener);
-    });
-  }
-  /** Tell the app the page is ready; it hides its loading spinner. */
-  notifyReady() {
-    this.send({ type: "APP_READY" /* AppReady */ });
-  }
-  /** Show a user-facing error in the app. */
-  notifyError(message) {
-    this.send({ type: "ERROR" /* Error */, message });
-  }
-  /** Ask the app to close the page. */
-  navigateBack() {
-    this.send({ type: "NAVIGATE_BACK" /* NavigateBack */ });
-  }
-  /** Resolves with the magic token the app mints for the current user. */
-  requestAuthToken() {
-    return new Promise((resolve) => {
-      const off = this.on("AUTH_TOKEN" /* AuthToken */, (message) => {
-        off();
-        resolve(message.token);
-      });
-      this.send({ type: "REQUEST_AUTH_TOKEN" /* RequestAuthToken */ });
-    });
-  }
-  /**
-   * Opens the app's badge scanner and resolves once the session ends with every
-   * person it captured, in scan order — several for a group scan, none if the user
-   * cancelled. Rejects with a {@link ScannerError} if the app reports a failure.
-   *
-   * A badge whose lookup returned nothing is still included, with its `badgeId` and
-   * empty `fields`, so it can be linked to the attendee.
-   */
-  openScanner() {
-    return new Promise((resolve, reject) => {
-      const people = [];
-      const done = () => {
-        offResult();
-        offClosed();
-      };
-      const offResult = this.on("ULC_FORM_SCANNER_RESULT" /* ScannerResult */, (message) => {
-        if (!Array.isArray(message.result)) {
-          done();
-          reject(new ScannerError(message.message || "Scan failed."));
-          return;
-        }
-        people.push({
-          badgeId: typeof message.badgeId === "string" ? message.badgeId : "",
-          fields: message.result
-        });
-        if (!("badgeId" in message)) {
-          done();
-          resolve(people);
-        }
-      });
-      const offClosed = this.on("ULC_FORM_SCANNER_CLOSED" /* ScannerClosed */, () => {
-        done();
-        resolve(people);
-      });
-      this.send({ type: "OPEN_ULC_FORM_SCANNER" /* OpenScanner */ });
-    });
-  }
-  /** Remove the `message` listener and drop every subscription. Safe to call more than once. */
-  destroy() {
-    if (this.destroyed) return;
-    this.destroyed = true;
-    this.pageWindow.removeEventListener("message", this.boundHandler);
-    this.listeners.clear();
-  }
-  handleMessage(event) {
-    const message = parseAppResponse(event.data);
-    if (!message) return;
-    const set = this.listeners.get(message.type);
-    if (!set) return;
-    for (const listener of Array.from(set)) {
-      listener(message);
-    }
-  }
-};
-
-export { AppRequestType, AppResponseType, CaptelloAppHost, ScannerError, parseAppResponse };
-//# sourceMappingURL=app-host.js.map
-//# sourceMappingURL=app-host.js.map

package/dist/app-host.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/app-host.ts"],"names":["AppRequestType","AppResponseType"],"mappings":"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","file":"app-host.js","sourcesContent":["/**\n * Pages embedded inside the Captello mobile app — `@captello/ulc-webview-sdk/app`.\n *\n * The mobile app hosts web pages (the meeting platform, Connexions, …) in an iframe and\n * offers them native services over `postMessage`: an auth token, the badge scanner,\n * back navigation, sharing. This module is the page-side client for that channel.\n *\n * It is the mirror image of {@link CaptelloWebview}: there your page is the host and\n * the Captello capture webview is the child; here the Captello *app* is the host and\n * your page is the child. The wire format differs too — match it exactly:\n * - Messages are posted as **plain objects**, not JSON strings.\n * - `type` values are SCREAMING_CASE.\n * - Requests (page → app) and responses (app → page) are disjoint enums.\n *\n * @example\n * import { CaptelloAppHost } from \"@captello/ulc-webview-sdk/app\";\n *\n * const app = new CaptelloAppHost();\n * const token = await app.requestAuthToken();\n * app.notifyReady();\n * const [person] = await app.openScanner();\n */\n\nimport type { Unsubscribe } from \"./client\";\nimport type { PrefillInfoItem } from \"./messages\";\n\n/* ------------------------------------------------------------------ *\n * Requests: page → app\n * ------------------------------------------------------------------ */\n\n/** Message `type` values a page sends to the Captello app. */\nexport enum AppRequestType {\n    /** The page finished loading; the app hides its loading spinner. */\n    AppReady = \"APP_READY\",\n    /** A user-facing error; the app shows `message`. */\n    Error = \"ERROR\",\n    /** Close the page (the app dismisses the modal or pops the route). */\n    NavigateBack = \"NAVIGATE_BACK\",\n    /** Ask for a magic token; answered with {@link AppResponseType.AuthToken}. */\n    RequestAuthToken = \"REQUEST_AUTH_TOKEN\",\n    /**\n     * Open the app's badge scanner. Answered with one\n     * {@link AppResponseType.ScannerResult} per scanned person, then\n     * {@link AppResponseType.ScannerClosed}.\n     */\n    OpenScanner = \"OPEN_ULC_FORM_SCANNER\",\n    /** Open `url` in the system browser. */\n    OpenUrl = \"OPEN_URL\",\n    /** Copy `text` to the clipboard; acknowledged with `COPIED_SUCCESS` / `COPIED_ERROR`. */\n    CopyText = \"COPY_TEXT\",\n    /** Open the native share sheet. */\n    ShareUrl = \"SHARE_URL\",\n    /** Save a vCard to the contacts; acknowledged with `SAVE_VCARD_SUCCESS` / `SAVE_VCARD_ERROR`. */\n    SaveVCard = \"SAVE_VCARD\",\n    /** Add a wallet pass; acknowledged with `ADD_TO_WALLET_SUCCESS` / `ADD_TO_WALLET_ERROR`. */\n    AddToWallet = \"ADD_TO_WALLET\",\n    /** Ask the app to synchronize its data. */\n    SyncApp = \"SYNC_APP\",\n}\n\ninterface AppReadyRequest {\n    type: AppRequestType.AppReady;\n}\ninterface ErrorRequest {\n    type: AppRequestType.Error;\n    message: string;\n}\ninterface NavigateBackRequest {\n    type: AppRequestType.NavigateBack;\n}\ninterface RequestAuthTokenRequest {\n    type: AppRequestType.RequestAuthToken;\n}\ninterface OpenScannerRequest {\n    type: AppRequestType.OpenScanner;\n}\ninterface OpenUrlRequest {\n    type: AppRequestType.OpenUrl;\n    url: string;\n}\ninterface CopyTextRequest {\n    type: AppRequestType.CopyText;\n    text: string;\n}\ninterface ShareUrlRequest {\n    type: AppRequestType.ShareUrl;\n    title: string;\n    text: string;\n}\ninterface SaveVCardRequest {\n    type: AppRequestType.SaveVCard;\n    /** vCard text. */\n    text: string;\n}\ninterface AddToWalletRequest {\n    type: AppRequestType.AddToWallet;\n    /** Base64 pass data, with or without a `data:` prefix. */\n    text: string;\n}\ninterface SyncAppRequest {\n    type: AppRequestType.SyncApp;\n}\n\n/** Discriminated union of every message a page can send to the app. */\nexport type AppRequest =\n    | AppReadyRequest\n    | ErrorRequest\n    | NavigateBackRequest\n    | RequestAuthTokenRequest\n    | OpenScannerRequest\n    | OpenUrlRequest\n    | CopyTextRequest\n    | ShareUrlRequest\n    | SaveVCardRequest\n    | AddToWalletRequest\n    | SyncAppRequest;\n\n/* ------------------------------------------------------------------ *\n * Responses: app → page\n * ------------------------------------------------------------------ */\n\n/** Message `type` values the Captello app sends to a page. */\nexport enum AppResponseType {\n    /** Answer to {@link AppRequestType.RequestAuthToken}. */\n    AuthToken = \"AUTH_TOKEN\",\n    /** One scanned person (or a scanner failure) after {@link AppRequestType.OpenScanner}. */\n    ScannerResult = \"ULC_FORM_SCANNER_RESULT\",\n    /** The scanner session ended: every result was posted, or the user cancelled. */\n    ScannerClosed = \"ULC_FORM_SCANNER_CLOSED\",\n    CopiedSuccess = \"COPIED_SUCCESS\",\n    CopiedError = \"COPIED_ERROR\",\n    SaveVCardSuccess = \"SAVE_VCARD_SUCCESS\",\n    SaveVCardError = \"SAVE_VCARD_ERROR\",\n    AddToWalletSuccess = \"ADD_TO_WALLET_SUCCESS\",\n    AddToWalletError = \"ADD_TO_WALLET_ERROR\",\n}\n\n/** App → page: the magic token requested with {@link AppRequestType.RequestAuthToken}. */\nexport interface AuthTokenMessage {\n    type: AppResponseType.AuthToken;\n    token: string;\n}\n\n/**\n * App → page: one scanned person, or a scanner failure.\n *\n * The app posts one of these per person the scanner captured — several for a group\n * scan — then a {@link ScannerClosedMessage}. `result` holds the looked-up attendee\n * fields in the same shape {@link PrefillInfoItem} uses, so they can be fed straight to\n * a capture form's `prefill({ info })`. It is empty (not absent) when the badge had no\n * lookup data; the badge can still be linked via `badgeId`.\n *\n * On failure `result` is absent and `message` carries the error text.\n */\nexport interface ScannerResultMessage {\n    type: AppResponseType.ScannerResult;\n    /**\n     * Badge ID the person was scanned from. Empty for business cards and manual search.\n     * Absent altogether on app builds that predate multi-person sessions — those post a\n     * single result and never a {@link ScannerClosedMessage}.\n     */\n    badgeId?: string;\n    /** Looked-up attendee fields (success). */\n    result?: PrefillInfoItem[];\n    /** Error text (failure) — `result` is absent. */\n    message?: string;\n}\n\n/** App → page: the scanner session ended. Follows the last {@link ScannerResultMessage}. */\nexport interface ScannerClosedMessage {\n    type: AppResponseType.ScannerClosed;\n}\n\ninterface AckMessage<T extends AppResponseType> {\n    type: T;\n}\n\n/** Discriminated union of every message the app can send to a page. */\nexport type AppResponse =\n    | AuthTokenMessage\n    | ScannerResultMessage\n    | ScannerClosedMessage\n    | AckMessage<AppResponseType.CopiedSuccess>\n    | AckMessage<AppResponseType.CopiedError>\n    | AckMessage<AppResponseType.SaveVCardSuccess>\n    | AckMessage<AppResponseType.SaveVCardError>\n    | AckMessage<AppResponseType.AddToWalletSuccess>\n    | AckMessage<AppResponseType.AddToWalletError>;\n\n/** Maps each response `type` to its full message shape (used by {@link CaptelloAppHost.on}). */\nexport type AppResponseMap = {\n    [M in AppResponse as M[\"type\"]]: M;\n};\n\n/** One person captured by the app's scanner, as resolved by {@link CaptelloAppHost.openScanner}. */\nexport interface ScannedPerson {\n    /** Badge ID the person was scanned from; empty for business cards and manual search. */\n    badgeId: string;\n    /** Looked-up attendee fields; empty when the badge had no lookup data. */\n    fields: PrefillInfoItem[];\n}\n\n/** Rejection reason from {@link CaptelloAppHost.openScanner} when the app reports a failure. */\nexport class ScannerError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"ScannerError\";\n    }\n}\n\nconst RESPONSE_TYPES: ReadonlySet<string> = new Set(Object.values(AppResponseType));\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n    return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Parses a raw `MessageEvent.data` value into a typed {@link AppResponse}, or returns\n * `null` if it is not a recognized Captello app message.\n *\n * The app posts plain objects; a JSON string is accepted too for robustness.\n */\nexport function parseAppResponse(data: unknown): AppResponse | null {\n    let value: unknown = data;\n    if (typeof value === \"string\") {\n        try {\n            value = JSON.parse(value);\n        } catch {\n            return null;\n        }\n    }\n    if (!isPlainObject(value)) return null;\n    if (typeof value[\"type\"] !== \"string\" || !RESPONSE_TYPES.has(value[\"type\"])) return null;\n    return value as unknown as AppResponse;\n}\n\n/* ------------------------------------------------------------------ *\n * Client\n * ------------------------------------------------------------------ */\n\n/** Listener for a specific app response type. */\nexport type AppResponseListener<T extends AppResponseType> = (message: AppResponseMap[T]) => void;\n\nexport interface CaptelloAppHostOptions {\n    /** Window the app is listening on. Defaults to `window.parent`. */\n    appWindow?: Window;\n    /** Window to receive the app's responses on. Defaults to `window`. */\n    pageWindow?: Window;\n    /**\n     * `targetOrigin` for outgoing `postMessage` calls. Defaults to `\"*\"`: the app's\n     * webview origin differs per platform (`capacitor://localhost`, `http://localhost`),\n     * and the page only ever runs inside the app when it uses this channel.\n     */\n    targetOrigin?: string;\n}\n\nfunction makeSubscription(off: () => void): Unsubscribe {\n    const handle = (() => {\n        off();\n    }) as Unsubscribe;\n    handle.unsubscribe = off;\n    return handle;\n}\n\n/**\n * Page-side client for the Captello mobile app that embeds the page.\n *\n * Construct one per page and keep it for the page's lifetime. It attaches a single\n * `message` listener on construction; call {@link destroy} to remove it.\n */\nexport class CaptelloAppHost {\n    private readonly appWindow: Window;\n    private readonly pageWindow: Window;\n    private readonly targetOrigin: string;\n    private readonly listeners = new Map<AppResponseType, Set<AppResponseListener<AppResponseType>>>();\n    private readonly boundHandler = (event: MessageEvent) => this.handleMessage(event);\n    private destroyed = false;\n\n    constructor(options: CaptelloAppHostOptions = {}) {\n        const pageWindow = options.pageWindow ?? (typeof window !== \"undefined\" ? window : undefined);\n        if (!pageWindow) {\n            throw new Error(\n                \"CaptelloAppHost: no page window available. Pass `pageWindow` when constructing outside a browser.\",\n            );\n        }\n        this.pageWindow = pageWindow;\n        this.appWindow = options.appWindow ?? pageWindow.parent;\n        this.targetOrigin = options.targetOrigin ?? \"*\";\n        this.pageWindow.addEventListener(\"message\", this.boundHandler);\n    }\n\n    /** Post a request to the app. Prefer the typed methods; this is the escape hatch. */\n    send(request: AppRequest): void {\n        if (this.destroyed) return;\n        this.appWindow.postMessage(request, this.targetOrigin);\n    }\n\n    /** Subscribe to a response type. Returns a handle with `unsubscribe()` (also callable). */\n    on<T extends AppResponseType>(type: T, listener: AppResponseListener<T>): Unsubscribe {\n        let set = this.listeners.get(type);\n        if (!set) {\n            set = new Set();\n            this.listeners.set(type, set);\n        }\n        set.add(listener as AppResponseListener<AppResponseType>);\n        return makeSubscription(() => {\n            set?.delete(listener as AppResponseListener<AppResponseType>);\n        });\n    }\n\n    /** Tell the app the page is ready; it hides its loading spinner. */\n    notifyReady(): void {\n        this.send({ type: AppRequestType.AppReady });\n    }\n\n    /** Show a user-facing error in the app. */\n    notifyError(message: string): void {\n        this.send({ type: AppRequestType.Error, message });\n    }\n\n    /** Ask the app to close the page. */\n    navigateBack(): void {\n        this.send({ type: AppRequestType.NavigateBack });\n    }\n\n    /** Resolves with the magic token the app mints for the current user. */\n    requestAuthToken(): Promise<string> {\n        return new Promise((resolve) => {\n            const off = this.on(AppResponseType.AuthToken, (message) => {\n                off();\n                resolve(message.token);\n            });\n            this.send({ type: AppRequestType.RequestAuthToken });\n        });\n    }\n\n    /**\n     * Opens the app's badge scanner and resolves once the session ends with every\n     * person it captured, in scan order — several for a group scan, none if the user\n     * cancelled. Rejects with a {@link ScannerError} if the app reports a failure.\n     *\n     * A badge whose lookup returned nothing is still included, with its `badgeId` and\n     * empty `fields`, so it can be linked to the attendee.\n     */\n    openScanner(): Promise<ScannedPerson[]> {\n        return new Promise((resolve, reject) => {\n            const people: ScannedPerson[] = [];\n            const done = () => {\n                offResult();\n                offClosed();\n            };\n            const offResult = this.on(AppResponseType.ScannerResult, (message) => {\n                if (!Array.isArray(message.result)) {\n                    done();\n                    reject(new ScannerError(message.message || \"Scan failed.\"));\n                    return;\n                }\n                people.push({\n                    badgeId: typeof message.badgeId === \"string\" ? message.badgeId : \"\",\n                    fields: message.result,\n                });\n                // App builds that predate multi-person sessions post one result, without a\n                // badgeId, and never a ScannerClosed — settle on it.\n                if (!(\"badgeId\" in message)) {\n                    done();\n                    resolve(people);\n                }\n            });\n            const offClosed = this.on(AppResponseType.ScannerClosed, () => {\n                done();\n                resolve(people);\n            });\n            this.send({ type: AppRequestType.OpenScanner });\n        });\n    }\n\n    /** Remove the `message` listener and drop every subscription. Safe to call more than once. */\n    destroy(): void {\n        if (this.destroyed) return;\n        this.destroyed = true;\n        this.pageWindow.removeEventListener(\"message\", this.boundHandler);\n        this.listeners.clear();\n    }\n\n    private handleMessage(event: MessageEvent): void {\n        const message = parseAppResponse(event.data);\n        if (!message) return;\n        const set = this.listeners.get(message.type);\n        if (!set) return;\n        for (const listener of Array.from(set)) {\n            listener(message);\n        }\n    }\n}\n"]}