@latchprotocol/widgets 0.1.0

package/dist/embed/iframe.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Iframe embedding: the postMessage contract.
+ *
+ * The web component is the right answer for most hosts. The iframe exists for
+ * the case the web component cannot serve: a host that will not run third-party
+ * script in its own realm - which, for a widget asking users to sign
+ * transactions, is a reasonable position for a host to take.
+ *
+ * ## The split
+ *
+ * The **widget** runs inside the iframe and owns only rendering. It holds no
+ * keys and opens no RPC connections. Every chain read and write is a request to
+ * the host.
+ *
+ * The **host** runs in the parent page, owns the wallet and a real
+ * {@link ../adapters/protocol.js | ProtocolAdapter}, and answers those requests.
+ *
+ * ```text
+ *  iframe (widget)                         parent (host)
+ *  ────────────────                        ─────────────
+ *   ready ─────────────────────────────────▶
+ *        ◀───────────────────────────── init { chain, integrator, theme }
+ *   invoke { id, method, args } ───────────▶
+ *        ◀────────── result { id, ok, value } | { id, ok: false, error }
+ *   resize { height } ─────────────────────▶
+ *   event  { name, payload } ──────────────▶
+ * ```
+ *
+ * ## Message contract
+ *
+ * Every message is `{ channel: "latch-widget", version: 1, ... }`. Anything
+ * without that envelope is ignored. Both sides pin the counterpart origin -
+ * the host passes the widget's origin, the widget receives the host's in
+ * `init` - and every later message is checked against it. `event.origin` is the
+ * only trustworthy field on a `MessageEvent`; nothing inside `data` is trusted
+ * for identity.
+ *
+ * `BigInt` survives structured clone, so amounts cross the boundary as exact
+ * integers. Never stringify them for transport - a float round-trip is how
+ * money goes missing.
+ *
+ * ## What the host must validate
+ *
+ * The host is the security boundary. Before signing anything it should check:
+ *
+ * - the transaction's `to` is a contract it expects (its own router address);
+ * - `value` matches what the user was shown;
+ * - `integratorFee.referrer` is the host's own address, if it configured one.
+ *
+ * A widget in an iframe is still third-party code. This contract makes it
+ * *inspectable*, not trusted.
+ */
+import type { ProtocolAdapter, WidgetTransactionRequest } from "../adapters/protocol.js";
+import type { IntegratorConfig } from "../config/integrator.js";
+import type { WidgetTheme } from "../context/WidgetProvider.js";
+/** Channel name on every message in this protocol. */
+export declare const WIDGET_CHANNEL = "latch-widget";
+/** Version of the message contract. Bumped on any breaking change. */
+export declare const WIDGET_PROTOCOL_VERSION = 1;
+/** Adapter methods the widget may invoke on the host. */
+export type BridgeMethod = Extract<keyof ProtocolAdapter, "getAccount" | "listTokens" | "getToken" | "getBalance" | "listPools" | "getPoolState" | "getApprovalRequirements" | "buildApproval" | "quoteSwap" | "buildSwap" | "quoteAddLiquidity" | "buildAddLiquidity" | "listPositions" | "quoteRemoveLiquidity" | "buildRemoveLiquidity" | "listLaunches" | "getLaunch" | "getLaunchesForToken" | "sendTransaction" | "waitForTransaction">;
+/** Sent by the widget once it has mounted and is ready for `init`. */
+export interface WidgetReadyMessage {
+    readonly channel: typeof WIDGET_CHANNEL;
+    readonly version: number;
+    readonly type: "ready";
+}
+/** Sent by the host in response to `ready`. */
+export interface HostInitMessage {
+    readonly channel: typeof WIDGET_CHANNEL;
+    readonly version: number;
+    readonly type: "init";
+    readonly widget: "swap" | "liquidity" | "launch";
+    readonly integrator: IntegratorConfig | null;
+    readonly theme: WidgetTheme;
+    /** Chain metadata, minus anything unserialisable (no transport). */
+    readonly chain: {
+        readonly chainId: number;
+        readonly name: string;
+        readonly nativeCurrency: {
+            name: string;
+            symbol: string;
+            decimals: number;
+        };
+        readonly blockExplorerUrl?: string;
+    };
+    /** `true` when the host's adapter is a mock, so the widget can warn. */
+    readonly isMock: boolean;
+}
+/** A remote adapter call, widget to host. */
+export interface WidgetInvokeMessage {
+    readonly channel: typeof WIDGET_CHANNEL;
+    readonly version: number;
+    readonly type: "invoke";
+    readonly id: string;
+    readonly method: BridgeMethod;
+    readonly args: readonly unknown[];
+}
+/** The host's answer to an `invoke`. */
+export type HostResultMessage = {
+    readonly channel: typeof WIDGET_CHANNEL;
+    readonly version: number;
+    readonly type: "result";
+    readonly id: string;
+    readonly ok: true;
+    readonly value: unknown;
+} | {
+    readonly channel: typeof WIDGET_CHANNEL;
+    readonly version: number;
+    readonly type: "result";
+    readonly id: string;
+    readonly ok: false;
+    readonly error: {
+        readonly name: string;
+        readonly message: string;
+    };
+};
+/** Height report, so the host can size the iframe without scrollbars. */
+export interface WidgetResizeMessage {
+    readonly channel: typeof WIDGET_CHANNEL;
+    readonly version: number;
+    readonly type: "resize";
+    readonly height: number;
+}
+/** Lifecycle notifications the host may log or act on. */
+export interface WidgetEventMessage {
+    readonly channel: typeof WIDGET_CHANNEL;
+    readonly version: number;
+    readonly type: "event";
+    readonly name: "quote" | "transaction-submitted" | "transaction-confirmed" | "error";
+    readonly payload: Record<string, unknown>;
+}
+/** Anything the widget sends. */
+export type WidgetMessage = WidgetReadyMessage | WidgetInvokeMessage | WidgetResizeMessage | WidgetEventMessage;
+/** Anything the host sends. */
+export type HostMessage = HostInitMessage | HostResultMessage;
+/** Options for {@link serveWidgetIframe}. */
+export interface ServeWidgetIframeOptions {
+    /** The iframe element the widget is running in. */
+    readonly iframe: HTMLIFrameElement;
+    /** Exact origin the iframe is served from. Never `"*"`. */
+    readonly widgetOrigin: string;
+    /** The adapter that answers the widget's requests. */
+    readonly adapter: ProtocolAdapter;
+    readonly widget: "swap" | "liquidity" | "launch";
+    readonly integrator?: IntegratorConfig;
+    readonly theme?: WidgetTheme;
+    /**
+     * Last-line inspection before a transaction is signed. Return `false` to
+     * refuse. Use it to assert the fee recipient is you.
+     */
+    readonly approveTransaction?: (request: WidgetTransactionRequest) => boolean | Promise<boolean>;
+    /** Called on every widget event, for analytics. */
+    readonly onEvent?: (message: WidgetEventMessage) => void;
+    /** Called when the widget reports its height. */
+    readonly onResize?: (height: number) => void;
+}
+/**
+ * Host side of the bridge: answers the widget's adapter calls.
+ *
+ * @returns a disposer that removes the listener.
+ */
+export declare function serveWidgetIframe(options: ServeWidgetIframeOptions): () => void;
+/** Options for {@link createIframeBridgeAdapter}. */
+export interface IframeBridgeOptions {
+    /** Exact origin of the host page. */
+    readonly hostOrigin: string;
+    /** How long to wait for a reply before failing, in ms. */
+    readonly timeoutMs?: number;
+}
+/**
+ * Widget side of the bridge: a {@link ProtocolAdapter} that forwards every call
+ * to the host page.
+ *
+ * Runs inside the iframe. Resolves once the host's `init` arrives, so a widget
+ * never renders against a half-configured bridge.
+ */
+export declare function createIframeBridgeAdapter(options: IframeBridgeOptions): Promise<{
+    adapter: ProtocolAdapter;
+    init: HostInitMessage;
+    dispose(): void;
+}>;
+/** Reports the widget's height to the host, so the iframe can be sized to it. */
+export declare function reportWidgetHeight(hostOrigin: string, element: HTMLElement): () => void;
+//# sourceMappingURL=iframe.d.ts.map

package/dist/embed/iframe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iframe.d.ts","sourceRoot":"","sources":["../../src/embed/iframe.ts"],"names":[],"mappings":"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"}

package/dist/embed/lockBadge.d.ts

@@ -0,0 +1,55 @@
+/**
+ * `<latch-lock-badge>`: the lock badge for any web page, with no framework.
+ *
+ * ```html
+ * <script src="https://<latch site>/embed/latch-embed.js" defer></script>
+ * <latch-lock-badge chain="4663" pool="0x…"></latch-lock-badge>
+ * <latch-lock-badge chain="4663" token="0x…" site="https://<latch site>"></latch-lock-badge>
+ * ```
+ *
+ * Attributes:
+ *   chain      chain id (required); must be a chain in the SDK's address book
+ *   pool       a pool id (bytes32), or
+ *   token      a token address
+ *   pool-type  `cl` (default) or `bin`
+ *   rpc        an RPC URL to read through instead of the chain's public RPCs
+ *   site       the Latch site origin; with it the badge links to its public
+ *              lock page (`/locks/pool/<id>?net=<chain>`); without it, no link
+ *   theme      `light` | `dark` | `system` (default)
+ *   refresh    seconds between re-reads (default 60, 0 = never)
+ *
+ * It reads the chain directly, through the MIT SDK, with the same readers as
+ * `LocksBadge`, and renders plain DOM into a shadow root: no React, no wallet,
+ * no writes. The words are only what was read (see `../locks/embedModel.ts`).
+ */
+import { type Address, type Hex } from "viem";
+export declare const LOCK_BADGE_TAG = "latch-lock-badge";
+declare const ElementBase: typeof HTMLElement;
+type Parsed = {
+    readonly ok: false;
+    readonly message: string;
+} | {
+    readonly ok: true;
+    readonly chainId: number;
+    readonly target: {
+        readonly kind: "pool";
+        readonly poolId: Hex;
+        readonly poolType: "cl" | "bin";
+    } | {
+        readonly kind: "token";
+        readonly token: Address;
+    };
+};
+/** Pure: the element's attributes, validated. */
+export declare function parseLockBadgeAttributes(get: (name: string) => string | null): Parsed;
+export declare class LatchLockBadgeElement extends ElementBase {
+    #private;
+    static get observedAttributes(): readonly string[];
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+}
+/** Registers `<latch-lock-badge>`. Safe to call twice. */
+export declare function defineLatchLockBadge(): void;
+export {};
+//# sourceMappingURL=lockBadge.d.ts.map

package/dist/embed/lockBadge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockBadge.d.ts","sourceRoot":"","sources":["../../src/embed/lockBadge.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAiC,KAAK,OAAO,EAAE,KAAK,GAAG,EAAqB,MAAM,MAAM,CAAC;AAWhG,eAAO,MAAM,cAAc,qBAAqB,CAAC;AAsBjD,QAAA,MAAM,WAAW,EAAE,OAAO,WAA4G,CAAC;AAKvI,KAAK,MAAM,GACP;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAChD;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,GAAG,KAAK,CAAA;KAAE,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CACzJ,CAAC;AAEN,iDAAiD;AACjD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,MAAM,CAerF;AAOD,qBAAa,qBAAsB,SAAQ,WAAW;;IACpD,MAAM,KAAK,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAEjD;IAUD,iBAAiB,IAAI,IAAI;IAYzB,oBAAoB,IAAI,IAAI;IAK5B,wBAAwB,IAAI,IAAI;CAkNjC;AAED,0DAA0D;AAC1D,wBAAgB,oBAAoB,IAAI,IAAI,CAG3C"}

package/dist/embed/webComponent.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Custom-element wrappers, for hosts that are not React.
+ *
+ * Vue, Svelte, Angular, Astro and plain HTML can all render a custom element.
+ * These mount the same React components into a shadow root, so the widget's CSS
+ * cannot leak into the host page and the host's CSS cannot break the widget -
+ * while `--latch-*` custom properties still inherit through the shadow boundary,
+ * which is exactly the theming behaviour an embedder wants.
+ *
+ * ```html
+ * <script type="module" src="/latch-widgets.js"></script>
+ * <latch-swap-widget theme="dark"></latch-swap-widget>
+ * ```
+ *
+ * The adapter cannot come from an attribute - a viem transport is not JSON -
+ * so set it as a property:
+ *
+ * ```js
+ * document.querySelector("latch-swap-widget").adapter = createViemAdapter({...});
+ * ```
+ */
+import { type ComponentType } from "react";
+import type { ProtocolAdapter } from "../adapters/protocol.js";
+/**
+ * SSR-safe `HTMLElement`.
+ *
+ * `class X extends HTMLElement` is evaluated at module load, so importing this
+ * file in Node - which any host doing server-side rendering does - would throw
+ * `HTMLElement is not defined` before a single line of user code ran. On the
+ * server the classes extend an inert stand-in instead. They are never
+ * instantiated there: `defineLatchWidgets` no-ops without `customElements`, and
+ * only the browser's custom-element machinery constructs them.
+ */
+declare const ElementBase: typeof HTMLElement;
+/** Base class shared by every widget element. */
+declare abstract class LatchWidgetElement extends ElementBase {
+    #private;
+    /** Observed attributes, extended by each subclass. */
+    static get observedAttributes(): readonly string[];
+    /** The adapter, when set imperatively. Takes precedence over the attribute. */
+    get adapter(): ProtocolAdapter | null;
+    set adapter(value: ProtocolAdapter | null);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    /** The React component this element renders. */
+    protected abstract component(): ComponentType<Record<string, unknown>>;
+    /** Extra props derived from element attributes. */
+    protected widgetProps(): Record<string, unknown>;
+}
+/** `<latch-swap-widget>`. */
+export declare class LatchSwapWidgetElement extends LatchWidgetElement {
+    static get observedAttributes(): readonly string[];
+    protected component(): ComponentType<Record<string, unknown>>;
+    protected widgetProps(): Record<string, unknown>;
+}
+/** `<latch-liquidity-widget>`. */
+export declare class LatchLiquidityWidgetElement extends LatchWidgetElement {
+    static get observedAttributes(): readonly string[];
+    protected component(): ComponentType<Record<string, unknown>>;
+    protected widgetProps(): Record<string, unknown>;
+}
+/** `<latch-launch-widget>`. */
+export declare class LatchLaunchWidgetElement extends LatchWidgetElement {
+    static get observedAttributes(): readonly string[];
+    protected component(): ComponentType<Record<string, unknown>>;
+    protected widgetProps(): Record<string, unknown>;
+}
+/** Element tag names, so hosts do not have to hardcode strings. */
+export declare const WIDGET_TAG_NAMES: {
+    readonly swap: "latch-swap-widget";
+    readonly liquidity: "latch-liquidity-widget";
+    readonly launch: "latch-launch-widget";
+};
+/**
+ * Registers every widget element.
+ *
+ * Safe to call more than once; already-registered tags are skipped rather than
+ * throwing, so two copies of the bundle on one page do not break it.
+ */
+export declare function defineLatchWidgets(): void;
+export {};
+//# sourceMappingURL=webComponent.d.ts.map

package/dist/embed/webComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webComponent.d.ts","sourceRoot":"","sources":["../../src/embed/webComponent.tsx"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAE1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AA2B/D;;;;;;;;;GASG;AACH,QAAA,MAAM,WAAW,EAAE,OAAO,WAGT,CAAC;AAElB,iDAAiD;AACjD,uBAAe,kBAAmB,SAAQ,WAAW;;IAMnD,sDAAsD;IACtD,MAAM,KAAK,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAEjD;IAED,+EAA+E;IAC/E,IAAI,OAAO,IAAI,eAAe,GAAG,IAAI,CAEpC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,EAGxC;IAED,iBAAiB,IAAI,IAAI;IAazB,oBAAoB,IAAI,IAAI;IAQ5B,wBAAwB,IAAI,IAAI;IAIhC,gDAAgD;IAChD,SAAS,CAAC,QAAQ,CAAC,SAAS,IAAI,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEtE,mDAAmD;IACnD,SAAS,CAAC,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAyDjD;AAED,6BAA6B;AAC7B,qBAAa,sBAAuB,SAAQ,kBAAkB;IAC5D,WAAoB,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAE1D;cAEkB,SAAS,IAAI,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;cAInD,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAY1D;AAED,kCAAkC;AAClC,qBAAa,2BAA4B,SAAQ,kBAAkB;IACjE,WAAoB,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAE1D;cAEkB,SAAS,IAAI,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;cAInD,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAS1D;AAED,+BAA+B;AAC/B,qBAAa,wBAAyB,SAAQ,kBAAkB;IAC9D,WAAoB,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAE1D;cAEkB,SAAS,IAAI,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;cAInD,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAS1D;AAED,mEAAmE;AACnE,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAYzC"}

package/dist/embed.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Framework-agnostic embedding.
+ *
+ * Two escape hatches for hosts that are not React:
+ *
+ * - **Custom elements** - `<latch-swap-widget>`, `<latch-liquidity-widget>` and
+ *   `<latch-launch-widget>`, rendered into a shadow root. Works anywhere a
+ *   browser runs, including plain HTML.
+ * - **`<latch-lock-badge>`** - the read-only lock badge as plain DOM, no React
+ *   and no wallet; {@link defineLatchLockBadge} registers it. The standalone
+ *   `latch-embed.js` bundle registers it on load for pages with no bundler.
+ * - **Iframe bridge** - the widget runs in its own realm and asks the host page
+ *   to perform every chain read and write over a documented postMessage
+ *   contract. For hosts that will not execute third-party script in their realm.
+ *
+ * Importing this module does not register anything. Call
+ * {@link defineLatchWidgets} when you want the elements defined.
+ *
+ * @packageDocumentation
+ */
+export { defineLatchWidgets, WIDGET_TAG_NAMES, LatchSwapWidgetElement, LatchLiquidityWidgetElement, LatchLaunchWidgetElement, } from "./embed/webComponent.js";
+export { WIDGET_CHANNEL, WIDGET_PROTOCOL_VERSION, createIframeBridgeAdapter, reportWidgetHeight, serveWidgetIframe, type BridgeMethod, type HostInitMessage, type HostMessage, type HostResultMessage, type IframeBridgeOptions, type ServeWidgetIframeOptions, type WidgetEventMessage, type WidgetInvokeMessage, type WidgetMessage, type WidgetReadyMessage, type WidgetResizeMessage, } from "./embed/iframe.js";
+export { LOCK_BADGE_TAG, LatchLockBadgeElement, defineLatchLockBadge, parseLockBadgeAttributes, } from "./embed/lockBadge.js";
+export { WIDGET_CSS, injectWidgetStyles } from "./styles/css.js";
+//# sourceMappingURL=embed.d.ts.map

package/dist/embed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../src/embed.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}