@enbox/browser 0.3.49 → 0.3.51

package/dist/types/dweb-connect-wallet.d.ts

@@ -12,7 +12,9 @@
  *    value-checks the `apv` origin binding against this wallet's origin.
  * 3. After the consent ceremony, the wallet posts the sealed response JWE via
  *    `sendResponse()` — or the deny token via `deny()` — back to the opener,
- *    again with a pinned `targetOrigin`.
+ *    again with a pinned `targetOrigin`. `sendResponseAwaitingAck()` does the
+ *    same but stays alive briefly for the dapp's completion ack, so the
+ *    wallet can show a confirmed "connected" state before closing itself.
  *
  * The dapp origin is never assumed: it is taken from an explicit option or
  * derived from `document.referrer`, and `create()` fails when neither is
@@ -59,6 +61,7 @@ export declare class WalletPostMessageTransport {
     private _requestReceived;
     private _timeoutId?;
     private _messageListener?;
+    private _resolveAck?;
     private readonly _requestPromise;
     private _resolveRequest?;
     private _rejectRequest?;
@@ -90,6 +93,25 @@ export declare class WalletPostMessageTransport {
      * @param idToken - The sealed response JWE, or the literal deny token.
      */
     sendResponse(idToken: string): void;
+    /**
+     * Posts the sealed response JWE back to the dapp like
+     * {@link sendResponse}, then keeps the channel open briefly for the dapp's
+     * completion ack — the signal that it opened the response successfully —
+     * before closing the transport.
+     *
+     * Lets the wallet's connect page show a confirmed "connected" state (and
+     * close itself with confidence) instead of asking the user to dismiss the
+     * screen blind. Dapps predating the ack simply never send one, so the
+     * wallet should keep a manual dismiss affordance for the `false` case.
+     *
+     * @param idToken - The sealed response JWE.
+     * @param options - The awaiting options.
+     * @param options.timeoutMs - Ack budget in milliseconds; defaults to 5 s.
+     * @returns Whether the dapp acknowledged completion within the budget.
+     */
+    sendResponseAwaitingAck(idToken: string, options?: {
+        timeoutMs?: number;
+    }): Promise<boolean>;
     /** Posts the deny token back to the dapp — the user rejected the request. */
     deny(): void;
     /** Stops listening and releases the session's timers. Idempotent. */

package/dist/types/dweb-connect-wallet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dweb-connect-wallet.d.ts","sourceRoot":"","sources":["../../src/dweb-connect-wallet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAgBrD,iEAAiE;AACjE,MAAM,MAAM,iCAAiC,GAAG;IAC9C;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAM;IAE3C,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,UAAU,CAAC,CAAgC;IACnD,OAAO,CAAC,gBAAgB,CAAC,CAAgC;IAEzD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0B;IAC1D,OAAO,CAAC,eAAe,CAAC,CAAoC;IAC5D,OAAO,CAAC,cAAc,CAAC,CAAyB;IAEhD,OAAO;IAsBP;;;;;;;OAOG;WACiB,MAAM,CAAC,OAAO,GAAE,iCAAsC,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAgChH,4EAA4E;IAC5E,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED;;;;;;OAMG;IACU,YAAY,IAAI,OAAO,CAAC,cAAc,CAAC;IAIpD;;;;;;OAMG;IACI,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ1C,6EAA6E;IACtE,IAAI,IAAI,IAAI;IAInB,qEAAqE;IAC9D,KAAK,IAAI,IAAI;IAQpB,OAAO,CAAC,SAAS;YAeH,WAAW;IAsBzB,OAAO,CAAC,aAAa;CAStB"}
+{"version":3,"file":"dweb-connect-wallet.d.ts","sourceRoot":"","sources":["../../src/dweb-connect-wallet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAoBrD,iEAAiE;AACjE,MAAM,MAAM,iCAAiC,GAAG;IAC9C;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAM;IAE3C,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,UAAU,CAAC,CAAgC;IACnD,OAAO,CAAC,gBAAgB,CAAC,CAAgC;IACzD,OAAO,CAAC,WAAW,CAAC,CAA2B;IAE/C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0B;IAC1D,OAAO,CAAC,eAAe,CAAC,CAAoC;IAC5D,OAAO,CAAC,cAAc,CAAC,CAAyB;IAEhD,OAAO;IAsBP;;;;;;;OAOG;WACiB,MAAM,CAAC,OAAO,GAAE,iCAAsC,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAgChH,4EAA4E;IAC5E,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED;;;;;;OAMG;IACU,YAAY,IAAI,OAAO,CAAC,cAAc,CAAC;IAIpD;;;;;;OAMG;IACI,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ1C;;;;;;;;;;;;;;;OAeG;IACU,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAqB7G,6EAA6E;IACtE,IAAI,IAAI,IAAI;IAInB,qEAAqE;IAC9D,KAAK,IAAI,IAAI;IAQpB,OAAO,CAAC,SAAS;YAoBH,WAAW;IAsBzB,OAAO,CAAC,aAAa;CAStB"}

package/dist/types/index.d.ts

@@ -36,8 +36,8 @@ export { connectViaPopup, PopupClientTransport, PopupWindowClosedError } from '.
 export type { PopupClientTransportOptions, PopupConnectOptions } from './dweb-connect-client.js';
 export { WalletPostMessageTransport } from './dweb-connect-wallet.js';
 export type { WalletPostMessageTransportOptions } from './dweb-connect-wallet.js';
-export { DWEB_CONNECT_LOADED_MESSAGE_TYPE, DWEB_CONNECT_PATH, DWEB_CONNECT_REQUEST_MESSAGE_TYPE, DWEB_CONNECT_RESPONSE_MESSAGE_TYPE, } from './dweb-connect-messages.js';
-export type { DWebConnectLoadedMessage, DWebConnectRequestMessage, DWebConnectResponseMessage, } from './dweb-connect-messages.js';
+export { DWEB_CONNECT_ACK_MESSAGE_TYPE, DWEB_CONNECT_LOADED_MESSAGE_TYPE, DWEB_CONNECT_PATH, DWEB_CONNECT_REQUEST_MESSAGE_TYPE, DWEB_CONNECT_RESPONSE_MESSAGE_TYPE, } from './dweb-connect-messages.js';
+export type { DWebConnectAckMessage, DWebConnectLoadedMessage, DWebConnectRequestMessage, DWebConnectResponseMessage, } from './dweb-connect-messages.js';
 export { fetchWalletWellKnown, probeWalletWellKnown, WALLET_WELL_KNOWN_PATH } from './ui/wallet-well-known.js';
 export type { WalletWellKnownDocument } from './ui/wallet-well-known.js';
 export { discoverWalletConnectServerUrl, runConnectModal } from './ui/connect-modal.js';

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAMH,OAAO,EACL,KAAK,EACL,cAAc,EACd,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAMpB,OAAO,EACL,WAAW,EACX,WAAW,EACX,yBAAyB,EACzB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAO7B,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EAAE,eAAe,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMhG,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACtF,YAAY,EAAE,4BAA4B,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACzG,YAAY,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,YAAY,EAAE,iCAAiC,EAAE,MAAM,0BAA0B,CAAC;AAClF,OAAO,EACL,gCAAgC,EAChC,iBAAiB,EACjB,iCAAiC,EACjC,kCAAkC,GACnC,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAC/G,YAAY,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,8BAA8B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxF,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1I,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC1G,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAWvD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIzC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGlF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC9E,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAMH,OAAO,EACL,KAAK,EACL,cAAc,EACd,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAMpB,OAAO,EACL,WAAW,EACX,WAAW,EACX,yBAAyB,EACzB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAO7B,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EAAE,eAAe,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMhG,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACtF,YAAY,EAAE,4BAA4B,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACzG,YAAY,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,YAAY,EAAE,iCAAiC,EAAE,MAAM,0BAA0B,CAAC;AAClF,OAAO,EACL,6BAA6B,EAC7B,gCAAgC,EAChC,iBAAiB,EACjB,iCAAiC,EACjC,kCAAkC,GACnC,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAC/G,YAAY,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,8BAA8B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxF,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1I,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC1G,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAWvD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIzC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGlF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC9E,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/types/relay-connect-runner.d.ts

@@ -72,8 +72,18 @@ export interface RelayConnectOptions {
         timeoutMs?: number;
         pollIntervalMs?: number;
         onClaimed?: () => void;
-    }) => Pick<RelayClientTransport, 'requestProfile' | 'deliverRequest' | 'awaitResponse' | 'requiresPin'>;
+    }) => Pick<RelayClientTransport, 'requestProfile' | 'deliverRequest' | 'awaitResponse' | 'requiresPin'> & Partial<Pick<RelayClientTransport, 'confirmComplete'>>;
 }
+/**
+ * Sleep used between relay polls that ends early when the page returns to
+ * the foreground. Browsers throttle — and mobile browsers freeze — timers in
+ * background tabs, so a plain interval sleep can leave the user staring at a
+ * stale stage after approving in the wallet tab; cutting the sleep short on
+ * `visibilitychange` makes the next poll (and with it the pairing-code
+ * prompt) land the moment they switch back. Falls back to a plain sleep
+ * outside DOM environments.
+ */
+export declare function visibilityAwareSleep(ms: number): Promise<void>;
 /**
  * Runs one relay-mediated connect handshake end-to-end and returns the
  * delegated credentials, or `undefined` when the user denied in the wallet.

package/dist/types/relay-connect-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relay-connect-runner.d.ts","sourceRoot":"","sources":["../../src/relay-connect-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EAExB,aAAa,EACb,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAIL,oBAAoB,EAErB,MAAM,gBAAgB,CAAC;AAExB,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,uEAAuE;AACvE,qBAAa,0BAA2B,SAAQ,KAAK;;CAKpD;AAED,2CAA2C;AAC3C,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,gBAAgB,EAAE,MAAM,CAAC;IAEzB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAElB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAEhB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,uEAAuE;IACvE,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAEvC,2DAA2D;IAC3D,kBAAkB,EAAE,wBAAwB,EAAE,CAAC;IAE/C,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,gBAAgB,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAEtD;;;;OAIG;IACH,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAExE;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IAEvC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IAEvB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE;QAC1B,gBAAgB,EAAE,MAAM,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;KACxB,KAAK,IAAI,CAAC,oBAAoB,EAAE,gBAAgB,GAAG,gBAAgB,GAAG,eAAe,GAAG,aAAa,CAAC,CAAC;CACzG;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CA4FtG"}
+{"version":3,"file":"relay-connect-runner.d.ts","sourceRoot":"","sources":["../../src/relay-connect-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EAExB,aAAa,EACb,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAIL,oBAAoB,EAErB,MAAM,gBAAgB,CAAC;AAExB,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,uEAAuE;AACvE,qBAAa,0BAA2B,SAAQ,KAAK;;CAKpD;AAED,2CAA2C;AAC3C,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,gBAAgB,EAAE,MAAM,CAAC;IAEzB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAElB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAEhB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,uEAAuE;IACvE,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAEvC,2DAA2D;IAC3D,kBAAkB,EAAE,wBAAwB,EAAE,CAAC;IAE/C,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,gBAAgB,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAEtD;;;;OAIG;IACH,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAExE;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IAEvC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IAEvB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE;QAC1B,gBAAgB,EAAE,MAAM,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;KACxB,KAAK,IAAI,CAAC,oBAAoB,EAAE,gBAAgB,GAAG,gBAAgB,GAAG,eAAe,GAAG,aAAa,CAAC,GACnG,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAC,CAAC;CAC5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB9D;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAoGtG"}

package/dist/types/ui/connect-modal.d.ts

@@ -2,17 +2,18 @@
  * Connect modal — the single surface that owns a whole connect session.
  *
  * One Shadow-DOM dialog whose stage morphs in place through the session:
- * QR (phone path) → pairing code → connected, with the in-browser popup
- * path and the wallet catalog folded in as in-place alternates. The modal
- * never chains into a second modal and stays mounted until the session
- * resolves (connected / denied / cancelled).
+ * QR / deep-link handoff (phone path) → pairing code → connected, with the
+ * in-browser popup path and the wallet catalog folded in as in-place
+ * alternates. The modal never chains into a second modal and stays mounted
+ * until the session resolves (connected / denied / cancelled).
  *
  * Layout: three zones —
  *
  * 1. **Header** — requesting app identity + close.
- * 2. **Stage** — a height-stable region where states crossfade: the QR
- *    (or deep link on phones), the pairing-code input, progress, success,
- *    and error states.
+ * 2. **Stage** — a height-stable region where states crossfade: the
+ *    clickable QR (joined by a Continue deep-link button on phones; both
+ *    open the wallet in a new tab so this session stays alive underneath),
+ *    the pairing-code input, progress, success, and error states.
  * 3. **Footer** — the wallet identity row ("Connecting with" + the selected
  *    wallet and the next catalog wallets as tiles), a More tile that expands
  *    the remaining wallets as a matching grid (search + custom URL) in

package/dist/types/ui/connect-modal.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enbox/browser",
-  "version": "0.3.49",
+  "version": "0.3.51",
   "description": "Enbox tools and features to use in the browser",
   "type": "module",
   "main": "./dist/esm/index.js",
@@ -66,14 +66,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@enbox/agent": "0.8.20",
-    "@enbox/api": "0.6.58",
-    "@enbox/auth": "0.6.66",
+    "@enbox/agent": "0.8.22",
+    "@enbox/api": "0.6.60",
+    "@enbox/auth": "0.6.68",
     "@enbox/common": "0.1.3",
-    "@enbox/connect": "0.1.2",
+    "@enbox/connect": "0.1.4",
     "@enbox/crypto": "0.1.5",
     "@enbox/dids": "0.1.5",
-    "@enbox/dwn-sdk-js": "0.4.10"
+    "@enbox/dwn-sdk-js": "0.4.11"
   },
   "devDependencies": {
     "@types/qrcode": "^1.5.6",

package/src/dweb-connect-client.ts

@@ -32,6 +32,7 @@ import type {
 import { assertX25519PublicJwk, CONNECT_DENIED_TOKEN, ConnectClient } from '@enbox/connect';
 
 import {
+  DWEB_CONNECT_ACK_MESSAGE_TYPE,
   DWEB_CONNECT_LOADED_MESSAGE_TYPE,
   DWEB_CONNECT_PATH,
   DWEB_CONNECT_REQUEST_MESSAGE_TYPE,
@@ -45,11 +46,42 @@ const DEFAULT_TIMEOUT_MS = 300_000;
 /** Interval at which the transport checks whether the user closed the popup. */
 const CLOSED_POLL_INTERVAL_MS = 500;
 
+/**
+ * Grace period after the popup is seen closed for an already-posted response
+ * to finish delivery before the close is treated as a denial.
+ */
+const CLOSED_RESPONSE_GRACE_MS = 1_500;
+
 /** Window name given to the wallet popup. */
 const POPUP_WINDOW_NAME = 'enbox-dweb-connect';
 
-/** Window features given to the wallet popup. */
-const POPUP_WINDOW_FEATURES = 'width=500,height=700,menubar=no,toolbar=no,location=no,status=no';
+/** Outer size of the wallet popup window. */
+const POPUP_WIDTH = 500;
+const POPUP_HEIGHT = 700;
+
+/**
+ * Builds the wallet popup's window features, centring it over the opener
+ * window — without `left`/`top` browsers park the popup wherever they like
+ * (usually offset into a corner). Falls back to centring on the screen when
+ * the opener's metrics are unavailable, and lets the browser clamp
+ * off-screen coordinates. Mobile browsers ignore the features entirely and
+ * open a tab.
+ */
+function popupWindowFeatures(): string {
+  const base = `width=${POPUP_WIDTH},height=${POPUP_HEIGHT},menubar=no,toolbar=no,location=no,status=no`;
+
+  // `screenX`/`outerWidth` describe the opener window; `screen.avail*`
+  // describe its monitor — so the popup lands on the same display.
+  const openerWidth = window.outerWidth > 0 ? window.outerWidth : (window.screen?.availWidth ?? 0);
+  const openerHeight = window.outerHeight > 0 ? window.outerHeight : (window.screen?.availHeight ?? 0);
+  if (openerWidth === 0 || openerHeight === 0) {
+    return base;
+  }
+
+  const left = Math.max(0, Math.round((window.screenX ?? 0) + (openerWidth - POPUP_WIDTH) / 2));
+  const top = Math.max(0, Math.round((window.screenY ?? 0) + (openerHeight - POPUP_HEIGHT) / 2));
+  return `${base},left=${left},top=${top}`;
+}
 
 /** Guards against calling browser-only entry points outside a browser. */
 function assertBrowserEnvironment(): void {
@@ -137,7 +169,7 @@ export class PopupClientTransport implements ConnectTransport {
     // the stack has yielded to a prior `await`, so opening it here — instead of
     // inside the awaited `requestProfile()` — is what keeps the flow usable.
     const popupUrl = new URL(DWEB_CONNECT_PATH, options.walletUrl).toString();
-    const popup = window.open(popupUrl, POPUP_WINDOW_NAME, POPUP_WINDOW_FEATURES);
+    const popup = window.open(popupUrl, POPUP_WINDOW_NAME, popupWindowFeatures());
     if (!popup) {
       throw new Error('[@enbox/browser] Popup blocked. Allow popups for this site to connect to a wallet.');
     }
@@ -212,6 +244,19 @@ export class PopupClientTransport implements ConnectTransport {
     return await this._responsePromise;
   }
 
+  /**
+   * {@inheritDoc ConnectTransport.confirmComplete}
+   *
+   * Posts the payload-less ack to the wallet popup (pinned `targetOrigin`)
+   * so a wallet still holding its "finishing up" screen can flip to a
+   * confirmed "connected" state before closing itself. A popup the user
+   * already closed is skipped silently.
+   */
+  public async confirmComplete(): Promise<void> {
+    if (this._popup.closed === true) { return; }
+    this._popup.postMessage({ type: DWEB_CONNECT_ACK_MESSAGE_TYPE }, this._walletOrigin);
+  }
+
   private onMessage(event: MessageEvent): void {
     const message = getTrustedMessage(event, this._walletOrigin, this._popup);
     if (message === undefined) { return; }
@@ -275,10 +320,19 @@ export class PopupClientTransport implements ConnectTransport {
       return;
     }
 
-    // Closed after the handshake was established — treat as a user denial.
-    this._settled = true;
-    this.cleanup();
-    this._resolveResponse?.(CONNECT_DENIED_TOKEN);
+    // Closed after the handshake was established. A wallet that posts its
+    // response and immediately closes itself can lose the race between that
+    // final message and this poll — especially when this page was
+    // backgrounded (mobile tabs) and both signals arrive together on
+    // resume — so give a queued response a grace window before treating the
+    // close as a user denial.
+    clearInterval(this._closedPollId);
+    setTimeout((): void => {
+      if (this._settled) { return; }
+      this._settled = true;
+      this.cleanup();
+      this._resolveResponse?.(CONNECT_DENIED_TOKEN);
+    }, CLOSED_RESPONSE_GRACE_MS);
   }
 
   private fail(error: Error): void {

package/src/dweb-connect-messages.ts

@@ -1,7 +1,7 @@
 /**
  * Wire shapes for the DWeb Connect popup/postMessage channel.
  *
- * The dapp and the wallet exchange exactly three message kinds over
+ * The dapp and the wallet exchange exactly four message kinds over
  * `window.postMessage`:
  *
  * 1. `loaded` beacon (wallet → dapp): announces the wallet page is ready and
@@ -11,6 +11,10 @@
  *    bound into the JWE `apv` header.
  * 3. `response` (wallet → dapp): the sealed connect response JWE, or the
  *    literal deny token — again ciphertext only.
+ * 4. `ack` (dapp → wallet): payload-less completion signal — the dapp opened
+ *    the response successfully, so the wallet can flip to a confirmed
+ *    "connected" state before closing itself. Optional and observational;
+ *    wallets unaware of it simply ignore the message.
  *
  * Plaintext never crosses the channel, and both sides pin `targetOrigin`
  * and verify `event.origin` / `event.source` on every message.
@@ -32,6 +36,9 @@ export const DWEB_CONNECT_REQUEST_MESSAGE_TYPE = 'enbox-connect-request';
 /** Message type carrying the sealed connect response JWE or deny token (wallet → dapp). */
 export const DWEB_CONNECT_RESPONSE_MESSAGE_TYPE = 'enbox-connect-response';
 
+/** Message type of the dapp's completion acknowledgement (dapp → wallet). */
+export const DWEB_CONNECT_ACK_MESSAGE_TYPE = 'enbox-connect-ack';
+
 /**
  * The wallet's readiness beacon. Emitted to `window.opener` once the wallet's
  * DWeb Connect page has generated its per-session ephemeral X25519 key.
@@ -62,6 +69,14 @@ export type DWebConnectResponseMessage = {
   payload: string;
 };
 
+/**
+ * The dapp's completion acknowledgement: it opened the wallet's response
+ * successfully. Carries no payload by design.
+ */
+export type DWebConnectAckMessage = {
+  type: typeof DWEB_CONNECT_ACK_MESSAGE_TYPE;
+};
+
 /**
  * Applies the shared inbound-message trust filter for the popup channel:
  * pins the message to the expected `event.origin`, pins its `event.source` to

package/src/dweb-connect-wallet.ts

@@ -12,7 +12,9 @@
  *    value-checks the `apv` origin binding against this wallet's origin.
  * 3. After the consent ceremony, the wallet posts the sealed response JWE via
  *    `sendResponse()` — or the deny token via `deny()` — back to the opener,
- *    again with a pinned `targetOrigin`.
+ *    again with a pinned `targetOrigin`. `sendResponseAwaitingAck()` does the
+ *    same but stays alive briefly for the dapp's completion ack, so the
+ *    wallet can show a confirmed "connected" state before closing itself.
  *
  * The dapp origin is never assumed: it is taken from an explicit option or
  * derived from `document.referrer`, and `create()` fails when neither is
@@ -28,6 +30,7 @@ import { X25519 } from '@enbox/crypto';
 import { CONNECT_DENIED_TOKEN, ConnectProvider } from '@enbox/connect';
 
 import {
+  DWEB_CONNECT_ACK_MESSAGE_TYPE,
   DWEB_CONNECT_LOADED_MESSAGE_TYPE,
   DWEB_CONNECT_REQUEST_MESSAGE_TYPE,
   DWEB_CONNECT_RESPONSE_MESSAGE_TYPE,
@@ -37,6 +40,9 @@ import {
 /** Default budget for awaiting the dapp's sealed request. */
 const DEFAULT_REQUEST_TIMEOUT_MS = 300_000;
 
+/** Default budget for awaiting the dapp's completion ack after a response. */
+const DEFAULT_ACK_TIMEOUT_MS = 5_000;
+
 /** Options for creating a {@link WalletPostMessageTransport}. */
 export type WalletPostMessageTransportOptions = {
   /**
@@ -79,6 +85,7 @@ export class WalletPostMessageTransport {
   private _requestReceived = false;
   private _timeoutId?: ReturnType<typeof setTimeout>;
   private _messageListener?: (event: MessageEvent) => void;
+  private _resolveAck?: (acked: boolean) => void;
 
   private readonly _requestPromise: Promise<ConnectRequest>;
   private _resolveRequest?: (request: ConnectRequest) => void;
@@ -177,6 +184,43 @@ export class WalletPostMessageTransport {
     this.close();
   }
 
+  /**
+   * Posts the sealed response JWE back to the dapp like
+   * {@link sendResponse}, then keeps the channel open briefly for the dapp's
+   * completion ack — the signal that it opened the response successfully —
+   * before closing the transport.
+   *
+   * Lets the wallet's connect page show a confirmed "connected" state (and
+   * close itself with confidence) instead of asking the user to dismiss the
+   * screen blind. Dapps predating the ack simply never send one, so the
+   * wallet should keep a manual dismiss affordance for the `false` case.
+   *
+   * @param idToken - The sealed response JWE.
+   * @param options - The awaiting options.
+   * @param options.timeoutMs - Ack budget in milliseconds; defaults to 5 s.
+   * @returns Whether the dapp acknowledged completion within the budget.
+   */
+  public async sendResponseAwaitingAck(idToken: string, options: { timeoutMs?: number } = {}): Promise<boolean> {
+    const ackPromise = new Promise<boolean>((resolve): void => {
+      this._resolveAck = resolve;
+    });
+
+    this._dappWindow.postMessage({
+      type    : DWEB_CONNECT_RESPONSE_MESSAGE_TYPE,
+      payload : idToken,
+    }, this._dappOrigin);
+
+    const ackTimeoutId = setTimeout((): void => {
+      this._resolveAck?.(false);
+    }, options.timeoutMs ?? DEFAULT_ACK_TIMEOUT_MS);
+
+    const acked = await ackPromise;
+    clearTimeout(ackTimeoutId);
+    this._resolveAck = undefined;
+    this.close();
+    return acked;
+  }
+
   /** Posts the deny token back to the dapp — the user rejected the request. */
   public deny(): void {
     this.sendResponse(CONNECT_DENIED_TOKEN);
@@ -195,6 +239,11 @@ export class WalletPostMessageTransport {
     const message = getTrustedMessage(event, this._dappOrigin, this._dappWindow);
     if (message === undefined) { return; }
 
+    if (message.type === DWEB_CONNECT_ACK_MESSAGE_TYPE) {
+      this._resolveAck?.(true);
+      return;
+    }
+
     if (message.type !== DWEB_CONNECT_REQUEST_MESSAGE_TYPE || this._requestReceived) { return; }
     this._requestReceived = true;
 

package/src/index.ts

@@ -94,12 +94,14 @@ export type { PopupClientTransportOptions, PopupConnectOptions } from './dweb-co
 export { WalletPostMessageTransport } from './dweb-connect-wallet.js';
 export type { WalletPostMessageTransportOptions } from './dweb-connect-wallet.js';
 export {
+  DWEB_CONNECT_ACK_MESSAGE_TYPE,
   DWEB_CONNECT_LOADED_MESSAGE_TYPE,
   DWEB_CONNECT_PATH,
   DWEB_CONNECT_REQUEST_MESSAGE_TYPE,
   DWEB_CONNECT_RESPONSE_MESSAGE_TYPE,
 } from './dweb-connect-messages.js';
 export type {
+  DWebConnectAckMessage,
   DWebConnectLoadedMessage,
   DWebConnectRequestMessage,
   DWebConnectResponseMessage,

package/src/relay-connect-runner.ts

@@ -107,7 +107,39 @@ export interface RelayConnectOptions {
     timeoutMs?: number;
     pollIntervalMs?: number;
     onClaimed?: () => void;
-  }) => Pick<RelayClientTransport, 'requestProfile' | 'deliverRequest' | 'awaitResponse' | 'requiresPin'>;
+  }) => Pick<RelayClientTransport, 'requestProfile' | 'deliverRequest' | 'awaitResponse' | 'requiresPin'>
+    & Partial<Pick<RelayClientTransport, 'confirmComplete'>>;
+}
+
+/**
+ * Sleep used between relay polls that ends early when the page returns to
+ * the foreground. Browsers throttle — and mobile browsers freeze — timers in
+ * background tabs, so a plain interval sleep can leave the user staring at a
+ * stale stage after approving in the wallet tab; cutting the sleep short on
+ * `visibilitychange` makes the next poll (and with it the pairing-code
+ * prompt) land the moment they switch back. Falls back to a plain sleep
+ * outside DOM environments.
+ */
+export function visibilityAwareSleep(ms: number): Promise<void> {
+  return new Promise((resolve) => {
+    if (typeof document === 'undefined') {
+      setTimeout(resolve, ms);
+      return;
+    }
+
+    const finish = (): void => {
+      clearTimeout(timer);
+      document.removeEventListener('visibilitychange', onVisibilityChange);
+      resolve();
+    };
+    const onVisibilityChange = (): void => {
+      if (document.visibilityState === 'visible') {
+        finish();
+      }
+    };
+    const timer = setTimeout(finish, ms);
+    document.addEventListener('visibilitychange', onVisibilityChange);
+  });
 }
 
 /**
@@ -116,7 +148,10 @@ export interface RelayConnectOptions {
  */
 export async function runRelayConnect(options: RelayConnectOptions): Promise<ConnectResult | undefined> {
   const createTransport = options.createTransport
-    ?? ((transportOptions): RelayClientTransport => new RelayClientTransport(transportOptions));
+    ?? ((transportOptions): RelayClientTransport => new RelayClientTransport({
+      ...transportOptions,
+      sleep: visibilityAwareSleep,
+    }));
 
   const transport = createTransport({
     connectServerUrl : options.connectServerUrl,
@@ -189,6 +224,11 @@ export async function runRelayConnect(options: RelayConnectOptions): Promise<Con
         throw new Error('Connect: wallet response omitted `delegatePortableDid`.');
       }
 
+      // Best-effort completion signal so the wallet can flip its pairing
+      // screen to a confirmed "connected" state instead of leaving the user
+      // to dismiss it blind. Fire-and-forget — mirrors the kernel client.
+      void transport.confirmComplete?.().catch((): undefined => undefined);
+
       return {
         delegatePortableDid : response.delegatePortableDid,
         delegateGrants      : response.delegateGrants,