@wippy-fe/types-global-proxy 0.0.27 → 0.0.28

package/index.d.ts

@@ -115,9 +115,16 @@ type HostFloatingDef = HostOverlayContent & HostOverlayBase & {
 /**
  * Modal def — centered overlay. Size is either a single `ModalSize`
  * or a breakpoint-keyed map (desktop centered / mobile fullscreen).
+ *
+ * `useNativeDialog` defaults to `true` — the modal renders via
+ * `<dialog showModal()>` (top-layer stacking, focus trap, inert
+ * propagation). Set `false` to opt back into the legacy div-overlay
+ * implementation while consumers migrate; the legacy path is
+ * `@deprecated` and will be removed in the next major.
  */
 type HostModalDef = HostOverlayContent & HostOverlayBase & {
     size?: ModalSize | Record<string, ModalSize>;
+    useNativeDialog?: boolean;
 };
 /**
  * Coordinator def — headless coordinator app. Same content kinds as
@@ -449,6 +456,19 @@ interface HostConfig {
      * Ignored by `iframe.html` / `chat-iframe.html` shells.
      */
     layout?: HostLayoutDeclaration;
+    /**
+     * Lazy WebSocket connection: defer the WS handshake until the first
+     * `useSubscription()` registers, and disconnect when the last
+     * subscriber unmounts. Saves a connection (and the matching server
+     * resource) for shells that don't actually consume push events at
+     * boot — chat-only iframes and panels that page through artifacts
+     * via REST.
+     *
+     * Apps that call `wsClient.sendMessage(...)` directly without
+     * subscribing first should NOT enable this — sendMessage will throw
+     * "WebSocket is not connected". Default is `false` (eager connect).
+     */
+    lazyWS?: boolean;
 }
 interface AppContext {
     resourceId: string;
@@ -1025,6 +1045,19 @@ interface LayoutApi {
      * top-level fields replace wholesale.
      */
     updatePanel: (panelId: string, def: Partial<HostPanelDef>) => void;
+    /**
+     * Open a modal at runtime. The author's tagged-union content shape
+     * (`kind: 'page' | 'artifact' | 'component' | 'builtin'`) is mirrored
+     * into the host declaration so the modal's component / props can be
+     * resolved from the host side. Re-opening an already-open id is a
+     * silent no-op (matches host-side `manager.openModal`'s thrown
+     * `LayoutValidationError`, but downgraded for cross-boundary callers).
+     *
+     * Defaults to `<dialog showModal()>` rendering for top-layer stacking,
+     * focus trap, and inert propagation. Pass `def.useNativeDialog: false`
+     * to opt back into the legacy div-overlay path during migration.
+     */
+    openModal: (id: string, def: HostModalDef) => void;
     /** Close a currently-open modal by id. */
     closeModal: (modalId: string) => void;
     /** Add a floating panel at runtime. Existing id is overwritten. */
@@ -1334,3 +1367,31 @@ declare global {
         [GLOBAL_PROXY_CONFIG_VAR]?: ProxyConfig;
     }
 }
+
+// Augment axios's request config so consumers can opt out of the proxy
+// api's default auth handling on a per-request basis. The proxy's createApi
+// reads `skipDefaultAuth` in both the request and response interceptors;
+// see `gen-2-chat:src/proxy/shared/api.ts` for the runtime semantics.
+declare module 'axios' {
+    interface AxiosRequestConfig {
+        /**
+         * Skip the proxy api's default auth handling for THIS request.
+         *
+         * When `true`:
+         *   - the request interceptor will NOT attach `Authorization: Bearer <token>`
+         *   - the response interceptor will NOT call `host.handleError('auth-expired')` on 401
+         *
+         * Use for:
+         *   - calls to a backend that uses a different auth domain
+         *   - calls that legitimately probe an unauthenticated endpoint
+         *   - calls where a 401 is meaningful but should not log the user out
+         *
+         * Cross-origin requests (URL with a different origin from the api's
+         * `baseURL`) auto-skip the Wippy default regardless of this flag.
+         */
+        skipDefaultAuth?: boolean;
+    }
+    interface InternalAxiosRequestConfig {
+        skipDefaultAuth?: boolean;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wippy-fe/types-global-proxy",
-  "version": "0.0.27",
+  "version": "0.0.28",
   "description": "Global type declarations for Wippy iframe proxy (window.getWippyApi, $W, etc.)",
   "license": "UNLICENSED",
   "types": "index.d.ts"