@solarpunkltd/swarm-id 0.8.1 → 0.9.0

package/dist/sync/device-state.d.ts

@@ -43,8 +43,9 @@ export declare const DeviceStateSnapshotSchemaV1: z.ZodObject<{
         appDescription: z.ZodOptional<z.ZodString>;
         connectedUntil: z.ZodOptional<z.ZodNumber>;
         appSecret: z.ZodOptional<z.ZodString>;
-        postageStampBatchID: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<BatchId, string>>>;
+        postageStampBatchID: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"none">, z.ZodPipe<z.ZodString, z.ZodTransform<BatchId, string>>]>>;
         postageStampBatchIDAt: z.ZodOptional<z.ZodNumber>;
+        stampPending: z.ZodOptional<z.ZodLiteral<true>>;
         revokedAt: z.ZodOptional<z.ZodNumber>;
         disconnectedAt: z.ZodOptional<z.ZodNumber>;
         chatBinding: z.ZodOptional<z.ZodObject<{

package/dist/types.d.ts

@@ -537,8 +537,10 @@ export type UploadMode = z.infer<typeof UploadModeSchema>;
 /**
  * Why a session cannot upload, when `uploadMode` is `"unavailable"`.
  *
- * - `no-stamp` — no stamp resolved: the account has no drive, or its pointers
- *   name one that is gone
+ * - `no-stamp`: the site has no stamp to use. The account has no drive (or
+ *   its pointers name only drives that are gone), the person set this site to
+ *   no drive, or the person has not yet confirmed the site's drive in the
+ *   connect window since the site signed in.
  * - `stamper-failed` — the stamp resolved and the stamper still did not build.
  *   `initializeStamper` logs and returns rather than throwing, so without this
  *   the symptom is indistinguishable from having no stamp at all.
@@ -654,6 +656,7 @@ export declare const ConnectionInfoSchema: z.ZodObject<{
         signature: z.ZodString;
     }, z.core.$strip>>;
     beeApiUrl: z.ZodOptional<z.ZodString>;
+    postageBatchId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type ConnectionInfo = z.infer<typeof ConnectionInfoSchema>;
 export declare const AppMetadataSchema: z.ZodObject<{
@@ -662,52 +665,357 @@ export declare const AppMetadataSchema: z.ZodObject<{
     icon: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type AppMetadata = z.infer<typeof AppMetadataSchema>;
-export declare const ButtonConfigSchema: z.ZodOptional<z.ZodObject<{
-    connectText: z.ZodOptional<z.ZodString>;
-    disconnectText: z.ZodOptional<z.ZodString>;
-    loadingText: z.ZodOptional<z.ZodString>;
+/**
+ * What a mounted Swarm ID button does. Both open the connect window: signed
+ * out it signs the person in, signed in it is where they change the stamp the
+ * site uses, which the window asks for on every connect.
+ */
+export declare const ButtonActionSchema: z.ZodEnum<{
+    "sign-in": "sign-in";
+    "change-stamp": "change-stamp";
+}>;
+export type ButtonAction = z.infer<typeof ButtonActionSchema>;
+/**
+ * A font file's URL: https, or http on a loopback host for local work, with
+ * no user name or password in it. The button frame takes loopback http only
+ * in a development build.
+ */
+export declare function isButtonFontUrl(value: string): boolean;
+export declare const ButtonFontFaceSchema: z.ZodObject<{
+    family: z.ZodString;
+    url: z.ZodString;
+    weight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    style: z.ZodOptional<z.ZodEnum<{
+        normal: "normal";
+        italic: "italic";
+        oblique: "oblique";
+    }>>;
+}, z.core.$strip>;
+/**
+ * A font file the button frame loads itself, so the label can use a family
+ * the site serves. It is fetched cross-origin from Swarm ID's frame, so the
+ * site serves it with an `Access-Control-Allow-Origin` that names Swarm ID's
+ * origin. Name `family` in `fontFamily` too, ahead of a fallback.
+ */
+export type ButtonFontFace = z.infer<typeof ButtonFontFaceSchema>;
+export declare const ButtonConfigSchema: z.ZodObject<{
+    text: z.ZodOptional<z.ZodString>;
+    busyText: z.ZodOptional<z.ZodString>;
+    ariaLabel: z.ZodOptional<z.ZodString>;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    busy: z.ZodOptional<z.ZodBoolean>;
     backgroundColor: z.ZodOptional<z.ZodString>;
     color: z.ZodOptional<z.ZodString>;
     borderRadius: z.ZodOptional<z.ZodString>;
+    borderColor: z.ZodOptional<z.ZodString>;
+    borderWidth: z.ZodOptional<z.ZodString>;
+    borderStyle: z.ZodOptional<z.ZodEnum<{
+        solid: "solid";
+        dashed: "dashed";
+        dotted: "dotted";
+        double: "double";
+    }>>;
     fontFamily: z.ZodOptional<z.ZodString>;
     fontSize: z.ZodOptional<z.ZodString>;
     fontWeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
-}, z.core.$strip>>;
+    fontFaces: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        family: z.ZodString;
+        url: z.ZodString;
+        weight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        style: z.ZodOptional<z.ZodEnum<{
+            normal: "normal";
+            italic: "italic";
+            oblique: "oblique";
+        }>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * How a mounted Swarm ID button looks and reads. It is painted inside Swarm
+ * ID's own frame, where the site's CSS cannot reach, so everything the site
+ * wants it to match is said here. The button fills the frame, which fills the
+ * site's container, and text that does not fit ends in an ellipsis.
+ */
 export interface ButtonConfig {
-    connectText?: string;
-    disconnectText?: string;
-    loadingText?: string;
+    /** The label. Default: "Sign in with Swarm ID", or "Change stamp in Swarm ID" */
+    text?: string;
+    /** The label while the connect window is open or `busy` is set. Default: "Waiting for Swarm ID" */
+    busyText?: string;
+    /** The accessible name, where the label alone does not say what the button does. Default: the label */
+    ariaLabel?: string;
+    /** Shown but not clickable */
+    disabled?: boolean;
+    /** Shown as working and not clickable, for a step of the site's own, such as signing out */
+    busy?: boolean;
+    /** CSS colour. Default: "#dd7200" */
     backgroundColor?: string;
+    /** CSS colour of the label. Default: "white" */
     color?: string;
+    /** CSS border-radius of the button and its frame. Default: "0" */
     borderRadius?: string;
+    /**
+     * CSS colour of a border, for a secondary style. Naming this or
+     * `borderWidth` draws one, kept in the busy and disabled looks. Default: the
+     * label's colour
+     */
+    borderColor?: string;
+    /** CSS width of the border. Default: "1px" once a border is drawn */
+    borderWidth?: string;
+    /** Default: "solid" */
+    borderStyle?: "solid" | "dashed" | "dotted" | "double";
+    /** CSS font-family. A stack falls back to the first family the frame has, not the page. Default: the frame's own */
     fontFamily?: string;
+    /** CSS font-size. Default: "14px" */
     fontSize?: string;
+    /** CSS font-weight, a keyword or a number. Default: "600" */
     fontWeight?: string | number;
+    /**
+     * Font files the frame loads for the label, at most 8. A file that does not
+     * load leaves the label in the next family of `fontFamily`, and the frame
+     * says so once in the console
+     */
+    fontFaces?: ButtonFontFace[];
 }
-export declare const ParentIdentifyMessageSchema: z.ZodObject<{
-    type: z.ZodLiteral<"parentIdentify">;
-    requestId: z.ZodString;
-    beeApiUrl: z.ZodOptional<z.ZodString>;
+/** Where a mounted button's connect window is. `blocked`: the browser refused to open it */
+export declare const ButtonWindowStateSchema: z.ZodEnum<{
+    open: "open";
+    closed: "closed";
+    blocked: "blocked";
+}>;
+export type ButtonWindowState = z.infer<typeof ButtonWindowStateSchema>;
+/** What `SwarmIdClient.mountButton` takes */
+export interface MountButtonOptions {
+    action: ButtonAction;
+    config?: ButtonConfig;
+    /**
+     * Called when the button's connect window opens, closes or is blocked, for
+     * example to say that the browser blocked it.
+     */
+    onWindowChange?: (state: ButtonWindowState) => void;
+}
+/** A mounted Swarm ID button */
+export interface MountedButton {
+    /**
+     * Resolves once the button is shown. Rejects with `init-failed` when Swarm
+     * ID refuses the site or the frame does not answer in time.
+     */
+    ready: Promise<void>;
+    /** Change what the button does or how it looks, in place. Does nothing once unmounted */
+    update(options: {
+        action?: ButtonAction;
+        config?: ButtonConfig;
+    }): void;
+    /** Remove the button. The session stays as it is, and `onWindowChange` is not called again */
+    unmount(): void;
+}
+export declare const ButtonIdentifyMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"buttonIdentify">;
+    action: z.ZodEnum<{
+        "sign-in": "sign-in";
+        "change-stamp": "change-stamp";
+    }>;
+    config: z.ZodOptional<z.ZodObject<{
+        text: z.ZodOptional<z.ZodString>;
+        busyText: z.ZodOptional<z.ZodString>;
+        ariaLabel: z.ZodOptional<z.ZodString>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        busy: z.ZodOptional<z.ZodBoolean>;
+        backgroundColor: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodString>;
+        borderRadius: z.ZodOptional<z.ZodString>;
+        borderColor: z.ZodOptional<z.ZodString>;
+        borderWidth: z.ZodOptional<z.ZodString>;
+        borderStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            dashed: "dashed";
+            dotted: "dotted";
+            double: "double";
+        }>>;
+        fontFamily: z.ZodOptional<z.ZodString>;
+        fontSize: z.ZodOptional<z.ZodString>;
+        fontWeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontFaces: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            family: z.ZodString;
+            url: z.ZodString;
+            weight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            style: z.ZodOptional<z.ZodEnum<{
+                normal: "normal";
+                italic: "italic";
+                oblique: "oblique";
+            }>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    metadata: z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
     popupMode: z.ZodOptional<z.ZodEnum<{
         popup: "popup";
         window: "window";
     }>>;
+}, z.core.$strip>;
+export declare const ButtonUpdateMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"buttonUpdate">;
+    action: z.ZodEnum<{
+        "sign-in": "sign-in";
+        "change-stamp": "change-stamp";
+    }>;
+    config: z.ZodOptional<z.ZodObject<{
+        text: z.ZodOptional<z.ZodString>;
+        busyText: z.ZodOptional<z.ZodString>;
+        ariaLabel: z.ZodOptional<z.ZodString>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        busy: z.ZodOptional<z.ZodBoolean>;
+        backgroundColor: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodString>;
+        borderRadius: z.ZodOptional<z.ZodString>;
+        borderColor: z.ZodOptional<z.ZodString>;
+        borderWidth: z.ZodOptional<z.ZodString>;
+        borderStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            dashed: "dashed";
+            dotted: "dotted";
+            double: "double";
+        }>>;
+        fontFamily: z.ZodOptional<z.ZodString>;
+        fontSize: z.ZodOptional<z.ZodString>;
+        fontWeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontFaces: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            family: z.ZodString;
+            url: z.ZodString;
+            weight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            style: z.ZodOptional<z.ZodEnum<{
+                normal: "normal";
+                italic: "italic";
+                oblique: "oblique";
+            }>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const ParentToButtonMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"buttonIdentify">;
+    action: z.ZodEnum<{
+        "sign-in": "sign-in";
+        "change-stamp": "change-stamp";
+    }>;
+    config: z.ZodOptional<z.ZodObject<{
+        text: z.ZodOptional<z.ZodString>;
+        busyText: z.ZodOptional<z.ZodString>;
+        ariaLabel: z.ZodOptional<z.ZodString>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        busy: z.ZodOptional<z.ZodBoolean>;
+        backgroundColor: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodString>;
+        borderRadius: z.ZodOptional<z.ZodString>;
+        borderColor: z.ZodOptional<z.ZodString>;
+        borderWidth: z.ZodOptional<z.ZodString>;
+        borderStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            dashed: "dashed";
+            dotted: "dotted";
+            double: "double";
+        }>>;
+        fontFamily: z.ZodOptional<z.ZodString>;
+        fontSize: z.ZodOptional<z.ZodString>;
+        fontWeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontFaces: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            family: z.ZodString;
+            url: z.ZodString;
+            weight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            style: z.ZodOptional<z.ZodEnum<{
+                normal: "normal";
+                italic: "italic";
+                oblique: "oblique";
+            }>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
     metadata: z.ZodObject<{
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         icon: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
-    buttonConfig: z.ZodOptional<z.ZodObject<{
-        connectText: z.ZodOptional<z.ZodString>;
-        disconnectText: z.ZodOptional<z.ZodString>;
-        loadingText: z.ZodOptional<z.ZodString>;
+    popupMode: z.ZodOptional<z.ZodEnum<{
+        popup: "popup";
+        window: "window";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"buttonUpdate">;
+    action: z.ZodEnum<{
+        "sign-in": "sign-in";
+        "change-stamp": "change-stamp";
+    }>;
+    config: z.ZodOptional<z.ZodObject<{
+        text: z.ZodOptional<z.ZodString>;
+        busyText: z.ZodOptional<z.ZodString>;
+        ariaLabel: z.ZodOptional<z.ZodString>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        busy: z.ZodOptional<z.ZodBoolean>;
         backgroundColor: z.ZodOptional<z.ZodString>;
         color: z.ZodOptional<z.ZodString>;
         borderRadius: z.ZodOptional<z.ZodString>;
+        borderColor: z.ZodOptional<z.ZodString>;
+        borderWidth: z.ZodOptional<z.ZodString>;
+        borderStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            dashed: "dashed";
+            dotted: "dotted";
+            double: "double";
+        }>>;
         fontFamily: z.ZodOptional<z.ZodString>;
         fontSize: z.ZodOptional<z.ZodString>;
         fontWeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontFaces: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            family: z.ZodString;
+            url: z.ZodString;
+            weight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            style: z.ZodOptional<z.ZodEnum<{
+                normal: "normal";
+                italic: "italic";
+                oblique: "oblique";
+            }>>;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>;
+}, z.core.$strip>], "type">;
+export type ParentToButtonMessage = z.infer<typeof ParentToButtonMessageSchema>;
+export declare const ButtonToParentMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"buttonReady">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"buttonInitError">;
+    error: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"buttonWindowChanged">;
+    state: z.ZodEnum<{
+        open: "open";
+        closed: "closed";
+        blocked: "blocked";
+    }>;
+}, z.core.$strip>], "type">;
+export type ButtonToParentMessage = z.infer<typeof ButtonToParentMessageSchema>;
+/**
+ * The button frame telling the session frames beside it that it opened a
+ * connect window under this challenge, so the handover that comes back under
+ * it is theirs to take.
+ */
+export declare const ConnectWindowOpenedMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"connectWindowOpened">;
+    challenge: z.ZodString;
+}, z.core.$strip>;
+export type ConnectWindowOpenedMessage = z.infer<typeof ConnectWindowOpenedMessageSchema>;
+/**
+ * Sent by the button frame on a wildcard origin the moment it loads, before
+ * the parent has identified itself, so outside the unions above, as
+ * `proxyInitialized` is.
+ */
+export declare const BUTTON_FRAME_LOADED = "buttonFrameLoaded";
+export declare const ParentIdentifyMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"parentIdentify">;
+    requestId: z.ZodString;
+    beeApiUrl: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
     subsidisedGatewayUrl: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const CheckAuthMessageSchema: z.ZodObject<{
@@ -1292,38 +1600,15 @@ export declare const GetPostageBatchMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"getPostageBatch">;
     requestId: z.ZodString;
 }, z.core.$strip>;
-export declare const ConnectMessageSchema: z.ZodObject<{
-    type: z.ZodLiteral<"connect">;
-    requestId: z.ZodString;
-    popupMode: z.ZodOptional<z.ZodEnum<{
-        popup: "popup";
-        window: "window";
-    }>>;
-}, z.core.$strip>;
 export declare const ParentToIframeMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"parentIdentify">;
     requestId: z.ZodString;
     beeApiUrl: z.ZodOptional<z.ZodString>;
-    popupMode: z.ZodOptional<z.ZodEnum<{
-        popup: "popup";
-        window: "window";
-    }>>;
     metadata: z.ZodObject<{
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         icon: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
-    buttonConfig: z.ZodOptional<z.ZodObject<{
-        connectText: z.ZodOptional<z.ZodString>;
-        disconnectText: z.ZodOptional<z.ZodString>;
-        loadingText: z.ZodOptional<z.ZodString>;
-        backgroundColor: z.ZodOptional<z.ZodString>;
-        color: z.ZodOptional<z.ZodString>;
-        borderRadius: z.ZodOptional<z.ZodString>;
-        fontFamily: z.ZodOptional<z.ZodString>;
-        fontSize: z.ZodOptional<z.ZodString>;
-        fontWeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
-    }, z.core.$strip>>;
     subsidisedGatewayUrl: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"checkAuth">;
@@ -1832,13 +2117,6 @@ export declare const ParentToIframeMessageSchema: z.ZodDiscriminatedUnion<[z.Zod
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"getPostageBatch">;
     requestId: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"connect">;
-    requestId: z.ZodString;
-    popupMode: z.ZodOptional<z.ZodEnum<{
-        popup: "popup";
-        window: "window";
-    }>>;
 }, z.core.$strip>], "type">;
 export type ParentIdentifyMessage = z.infer<typeof ParentIdentifyMessageSchema>;
 export type CheckAuthMessage = z.infer<typeof CheckAuthMessageSchema>;
@@ -1883,7 +2161,6 @@ export type ActAddGranteesMessage = z.infer<typeof ActAddGranteesMessageSchema>;
 export type ActRevokeGranteesMessage = z.infer<typeof ActRevokeGranteesMessageSchema>;
 export type ActGetGranteesMessage = z.infer<typeof ActGetGranteesMessageSchema>;
 export type GetPostageBatchMessage = z.infer<typeof GetPostageBatchMessageSchema>;
-export type ConnectMessage = z.infer<typeof ConnectMessageSchema>;
 export type ParentToIframeMessage = z.infer<typeof ParentToIframeMessageSchema>;
 export declare const ProxyReadyMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"proxyReady">;
@@ -2027,6 +2304,7 @@ export declare const SwarmIdErrorCodeSchema: z.ZodEnum<{
     "invalid-state": "invalid-state";
     "init-failed": "init-failed";
     "popup-blocked": "popup-blocked";
+    "button-required": "button-required";
     internal: "internal";
 }>;
 export type SwarmIdErrorCode = z.infer<typeof SwarmIdErrorCodeSchema>;
@@ -2045,6 +2323,7 @@ export declare const WireErrorSchema: z.ZodObject<{
         "invalid-state": "invalid-state";
         "init-failed": "init-failed";
         "popup-blocked": "popup-blocked";
+        "button-required": "button-required";
         internal: "internal";
     }>>;
     reason: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
@@ -2078,6 +2357,7 @@ export declare const ErrorMessageSchema: z.ZodObject<{
         "invalid-state": "invalid-state";
         "init-failed": "init-failed";
         "popup-blocked": "popup-blocked";
+        "button-required": "button-required";
         internal: "internal";
     }>>;
     reason: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
@@ -2143,11 +2423,7 @@ export declare const ConnectionInfoChangedMessageSchema: z.ZodObject<{
         signature: z.ZodString;
     }, z.core.$strip>>;
     beeApiUrl: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export declare const ConnectResponseMessageSchema: z.ZodObject<{
-    type: z.ZodLiteral<"connectResponse">;
-    requestId: z.ZodString;
-    success: z.ZodBoolean;
+    postageBatchId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const IsConnectedResponseMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"isConnectedResponse">;
@@ -2447,6 +2723,7 @@ export declare const IframeToParentMessageSchema: z.ZodDiscriminatedUnion<[z.Zod
         "invalid-state": "invalid-state";
         "init-failed": "init-failed";
         "popup-blocked": "popup-blocked";
+        "button-required": "button-required";
         internal: "internal";
     }>>;
     reason: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
@@ -2511,10 +2788,7 @@ export declare const IframeToParentMessageSchema: z.ZodDiscriminatedUnion<[z.Zod
         signature: z.ZodString;
     }, z.core.$strip>>;
     beeApiUrl: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"connectResponse">;
-    requestId: z.ZodString;
-    success: z.ZodBoolean;
+    postageBatchId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"isConnectedResponse">;
     requestId: z.ZodString;
@@ -2709,7 +2983,6 @@ export type DownloadChunkResponseMessage = z.infer<typeof DownloadChunkResponseM
 export type UploadProgressMessage = z.infer<typeof UploadProgressMessageSchema>;
 export type ErrorMessage = z.infer<typeof ErrorMessageSchema>;
 export type ConnectionInfoChangedMessage = z.infer<typeof ConnectionInfoChangedMessageSchema>;
-export type ConnectResponseMessage = z.infer<typeof ConnectResponseMessageSchema>;
 export type IsConnectedResponseMessage = z.infer<typeof IsConnectedResponseMessageSchema>;
 export type GetNodeInfoResponseMessage = z.infer<typeof GetNodeInfoResponseMessageSchema>;
 export type GsocMineResponseMessage = z.infer<typeof GsocMineResponseMessageSchema>;
@@ -2766,8 +3039,9 @@ export declare const AuthDataSchema: z.ZodObject<{
             appDescription: z.ZodOptional<z.ZodString>;
             connectedUntil: z.ZodOptional<z.ZodNumber>;
             appSecret: z.ZodOptional<z.ZodString>;
-            postageStampBatchID: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("@ethersphere/core-sdk").BatchId, string>>>;
+            postageStampBatchID: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"none">, z.ZodPipe<z.ZodString, z.ZodTransform<import("@ethersphere/core-sdk").BatchId, string>>]>>;
             postageStampBatchIDAt: z.ZodOptional<z.ZodNumber>;
+            stampPending: z.ZodOptional<z.ZodLiteral<true>>;
             revokedAt: z.ZodOptional<z.ZodNumber>;
             disconnectedAt: z.ZodOptional<z.ZodNumber>;
             chatBinding: z.ZodOptional<z.ZodObject<{
@@ -2806,6 +3080,7 @@ export declare const AuthDataSchema: z.ZodObject<{
         message: z.ZodString;
         signature: z.ZodString;
     }, z.core.$strip>>;
+    stampPending: z.ZodOptional<z.ZodLiteral<true>>;
 }, z.core.$strip>;
 export type AuthData = z.infer<typeof AuthDataSchema>;
 /**
@@ -2879,8 +3154,9 @@ export declare const SetSecretMessageSchema: z.ZodObject<{
                 appDescription: z.ZodOptional<z.ZodString>;
                 connectedUntil: z.ZodOptional<z.ZodNumber>;
                 appSecret: z.ZodOptional<z.ZodString>;
-                postageStampBatchID: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("@ethersphere/core-sdk").BatchId, string>>>;
+                postageStampBatchID: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"none">, z.ZodPipe<z.ZodString, z.ZodTransform<import("@ethersphere/core-sdk").BatchId, string>>]>>;
                 postageStampBatchIDAt: z.ZodOptional<z.ZodNumber>;
+                stampPending: z.ZodOptional<z.ZodLiteral<true>>;
                 revokedAt: z.ZodOptional<z.ZodNumber>;
                 disconnectedAt: z.ZodOptional<z.ZodNumber>;
                 chatBinding: z.ZodOptional<z.ZodObject<{
@@ -2919,8 +3195,14 @@ export declare const SetSecretMessageSchema: z.ZodObject<{
             message: z.ZodString;
             signature: z.ZodString;
         }, z.core.$strip>>;
+        stampPending: z.ZodOptional<z.ZodLiteral<true>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
+/**
+ * What the connect popup posts to the session frame. The popup was opened by
+ * the button frame, and posts to the Swarm ID frames beside its opener
+ * (`ui/src/lib/handover-targets.ts`).
+ */
 export declare const PopupToIframeMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"setSecret">;
     appOrigin: z.ZodString;
@@ -2954,8 +3236,9 @@ export declare const PopupToIframeMessageSchema: z.ZodDiscriminatedUnion<[z.ZodO
                 appDescription: z.ZodOptional<z.ZodString>;
                 connectedUntil: z.ZodOptional<z.ZodNumber>;
                 appSecret: z.ZodOptional<z.ZodString>;
-                postageStampBatchID: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("@ethersphere/core-sdk").BatchId, string>>>;
+                postageStampBatchID: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"none">, z.ZodPipe<z.ZodString, z.ZodTransform<import("@ethersphere/core-sdk").BatchId, string>>]>>;
                 postageStampBatchIDAt: z.ZodOptional<z.ZodNumber>;
+                stampPending: z.ZodOptional<z.ZodLiteral<true>>;
                 revokedAt: z.ZodOptional<z.ZodNumber>;
                 disconnectedAt: z.ZodOptional<z.ZodNumber>;
                 chatBinding: z.ZodOptional<z.ZodObject<{
@@ -2994,6 +3277,7 @@ export declare const PopupToIframeMessageSchema: z.ZodDiscriminatedUnion<[z.ZodO
             message: z.ZodString;
             signature: z.ZodString;
         }, z.core.$strip>>;
+        stampPending: z.ZodOptional<z.ZodLiteral<true>>;
     }, z.core.$strip>;
 }, z.core.$strip>], "type">;
 export type SetSecretMessage = z.infer<typeof SetSecretMessageSchema>;
@@ -3013,8 +3297,6 @@ export interface ClientOptions {
     onConnectionChange?: (info: ConnectionInfo) => void;
     popupMode?: "popup" | "window";
     metadata: AppMetadata;
-    buttonConfig?: ButtonConfig;
-    containerId?: string;
     /** URL of a subsidised gateway for users without postage stamps. Gateway handles stamping server-side. */
     subsidisedGatewayUrl?: string;
     /**

package/dist/utils/button-view.d.ts

@@ -0,0 +1,16 @@
+import type { ButtonAction, ButtonConfig } from "../types";
+/** What the button frame paints, worked out from what the site asked for */
+export interface ButtonView {
+    text: string;
+    /** Set only when the site gave one, so the label is the name otherwise */
+    ariaLabel: string | undefined;
+    disabled: boolean;
+    busy: boolean;
+    style: Record<string, string>;
+}
+/**
+ * The button for `action` as `config` asks, busy while its connect window is
+ * open or the site says so. A busy button stays focusable and ignores clicks,
+ * a disabled one is out of the tab order.
+ */
+export declare function buttonView(action: ButtonAction, config: ButtonConfig, windowOpen: boolean): ButtonView;

package/dist/utils/postage-stamp-association.d.ts

@@ -1,10 +1,11 @@
-import type { ConnectedApp, PostageStamp, SignedInAccount } from "../schemas";
+import { type ConnectedApp, type PostageStamp, type SignedInAccount } from "../schemas";
 /**
  * Resolve which postage stamp an app should upload with.
  *
  * An app may carry its own batch override (`postageStampBatchID`); otherwise it
  * falls back to the account's default stamp. The account owns the stamp set, so
- * these pointers are the single source of truth.
+ * these pointers are the single source of truth. An app set to
+ * `NO_POSTAGE_STAMP` resolves to no stamp, the default included.
  *
  * The lookup is existence-checked: a pointer whose stamp is missing (e.g. a
  * removed or replaced batch) is skipped so resolution falls through to the next
@@ -36,4 +37,4 @@ export declare function resolveStampForApp(app: Pick<ConnectedApp, "postageStamp
  * cannot upload at all. Tombstones its pointers still name are kept too — a
  * tombstone is how the session learns the stamp it was spending is deleted.
  */
-export declare function stampsReachableByApp(app: Pick<ConnectedApp, "postageStampBatchID">, account: Pick<SignedInAccount, "defaultPostageStampBatchID">, stamps: PostageStamp[]): PostageStamp[];
+export declare function stampsReachableByApp(app: Pick<ConnectedApp, "postageStampBatchID" | "stampPending">, account: Pick<SignedInAccount, "defaultPostageStampBatchID">, stamps: PostageStamp[]): PostageStamp[];