@fkn/lib 0.9.9 → 0.9.11

package/{api-BYRsWdwB.d.ts → api-VR2xHGZu.d.ts}

@@ -1,4 +1,4 @@
-import { D as InstalledPackage, E as InstallOptions, M as PickOptions, N as Placement, O as PackageQuery, T as ConnectOptions, j as PackagesFail, k as PackageResult, w as Caller } from "./packages-BtbLwrrW.js";
+import { A as InstallOptions, D as MountDescriptor, F as PackagesFail, I as PickOptions, L as Placement, M as PackageQuery, N as PackageResult, O as Caller, j as InstalledPackage, k as ConnectOptions } from "./packages-vX-1yfRK.js";
 import { t as AddressLookupResult } from "./lookup-BtwWaCZJ.js";
 //#region src/api/storage.d.ts
 type StorageEntry = {
@@ -559,7 +559,7 @@ type DataPlane = typeof dataPlane;
 //#endregion
 //#region src/api/index.d.ts
 type Cloud = DataPlane['cloud'];
-declare const makeResolvers: (callerOf: () => Caller | undefined) => {
+declare const makeResolvers: (callerOf: () => Caller | undefined, ownsOverlay?: boolean) => {
   readonly cloud: {
     readonly fetch: (input: Parameters<Cloud['fetch']>[0], init: Parameters<Cloud['fetch']>[1]) => Promise<Response>;
     readonly quota: () => Promise<Quota>;
@@ -675,6 +675,7 @@ declare const makeResolvers: (callerOf: () => Caller | undefined) => {
     } | {
       declined: true;
     }>;
+    frame: (uri: string) => Promise<MountDescriptor | PackagesFail>;
     list: () => Promise<{
       results: InstalledPackage[];
     }>;

package/cloud/fetch.d.ts

@@ -1,2 +1,2 @@
-import { t as cloudFetch } from "../proxy-BypE6RbM.js";
+import { t as cloudFetch } from "../proxy-CAjDHzfq.js";
 export { cloudFetch as fetch };

package/cloud/net.d.ts

@@ -1,2 +1,2 @@
-import { a as createConnection, c as isIP, i as connect, l as isIPv4, n as Socket, o as createServer, r as _default, t as Server, u as isIPv6 } from "../net-BKkf8QK3.js";
+import { a as createConnection, c as isIP, i as connect, l as isIPv4, n as Socket, o as createServer, r as _default, t as Server, u as isIPv6 } from "../net-BhNzd0mR.js";
 export { Server, Socket, _default, _default as default, connect, createConnection, createServer, isIP, isIPv4, isIPv6 };

package/{cloud-CWJO6Q8h.d.ts → cloud-DRzA41UW.d.ts}

@@ -1,8 +1,8 @@
-import { t as cloudFetch } from "./proxy-BypE6RbM.js";
+import { t as cloudFetch } from "./proxy-CAjDHzfq.js";
 import { d as Frame, u as AttachFrameOptions } from "./index-DQfP-Uhy.js";
 import { t as dns_d_exports } from "./dns.js";
 import { n as fs_d_exports } from "./fs-DTmSCXwa.js";
-import { s as net_d_exports } from "./net-BKkf8QK3.js";
+import { s as net_d_exports } from "./net-BhNzd0mR.js";
 import { t as dgram_d_exports } from "./dgram.js";
 import { t as http_d_exports } from "./http.js";
 

package/cloud.d.ts

@@ -1,8 +1,8 @@
-import { t as cloudFetch } from "./proxy-BypE6RbM.js";
-import { a as attachFrame, i as quota, r as QuotaStatus, t as available } from "./cloud-CWJO6Q8h.js";
+import { t as cloudFetch } from "./proxy-CAjDHzfq.js";
+import { a as attachFrame, i as quota, r as QuotaStatus, t as available } from "./cloud-DRzA41UW.js";
 import { t as dns_d_exports } from "./dns.js";
 import { n as fs_d_exports } from "./fs-DTmSCXwa.js";
-import { s as net_d_exports } from "./net-BKkf8QK3.js";
+import { s as net_d_exports } from "./net-BhNzd0mR.js";
 import { t as dgram_d_exports } from "./dgram.js";
 import { t as http_d_exports } from "./http.js";
 export { type QuotaStatus, attachFrame, available, dgram_d_exports as dgram, dns_d_exports as dns, cloudFetch as fetch, fs_d_exports as fs, http_d_exports as http, net_d_exports as net, quota };

package/dgram.d.ts

@@ -1,4 +1,4 @@
-import { n as UdpSocketOption, t as Resolvers } from "./api-BYRsWdwB.js";
+import { n as UdpSocketOption, t as Resolvers } from "./api-VR2xHGZu.js";
 import { Buffer } from "buffer";
 import { AddressInfo } from "net";
 import { EventEmitter } from "events";

package/http.d.ts

@@ -1,4 +1,4 @@
-import { n as Socket, t as Server$1 } from "./net-BKkf8QK3.js";
+import { n as Socket, t as Server$1 } from "./net-BhNzd0mR.js";
 import { Buffer } from "buffer";
 import { Stream } from "stream";
 import { IncomingHttpHeaders, OutgoingHttpHeaders, RequestOptions } from "http";

package/index.d.ts

@@ -1,9 +1,9 @@
 import { t as account_d_exports } from "./account.js";
-import { y as packages_d_exports } from "./packages-BtbLwrrW.js";
+import { S as packages_d_exports } from "./packages-vX-1yfRK.js";
 import { A as LOCATOR_DENIED, B as SelectorPart, C as RemoteVideoElement, D as isType, E as createVideoElementHandle, F as isTerminalError, G as setRequestHeaderRule, H as RequestHeaderRule, I as Executor, J as cookies, K as CookieDetails, L as Gate, M as LOCATOR_UNSUPPORTED, N as isLocatorDenied, O as revive, P as isLocatorUnsupported, Q as assertFetchableUrl, R as GateTools, S as BoxedVideoElement, T as box, U as modifyRequestHeadersPermission, V as HeaderOperation, W as removeRequestHeaderRule, X as FetchInit, Y as readCookiePermission, Z as ProxyFetchRequest, _ as gotoPermission, a as PermissionGrant, at as FORGEABLE_HEADERS, b as isBlockedFrameUrl, c as ATTACH_FRAME_EVENT_KEY, ct as hasForgedCookie, d as Frame, et as fetchCredentialedPermission, f as FrameBackend, g as createFrame, h as attachFramePermission, i as waitForExtensionExposure, it as isLocalNetworkUrl, j as LOCATOR_ERROR, k as type, m as Locator, n as isExtensionExposed, nt as fetchPermission, o as PermissionRequest, ot as assertForgeableHeaders, p as GotoOptions, q as SiteCookie, r as setMissingExtensionHandler, rt as isBlockedFetchUrl, s as permissions, st as assertOneCookieIdentity, tt as fetchLocalPermission, u as AttachFrameOptions, v as assertAttachableFrameUrl, w as VideoElementState, x as handleRevivableModules, y as assertLockdownApplicable, z as OperationRequest } from "./index-DQfP-Uhy.js";
-import { n as cloud_d_exports } from "./cloud-CWJO6Q8h.js";
+import { n as cloud_d_exports } from "./cloud-DRzA41UW.js";
 import { t as dns_d_exports } from "./dns.js";
-import { s as net_d_exports } from "./net-BKkf8QK3.js";
+import { s as net_d_exports } from "./net-BhNzd0mR.js";
 import { t as dgram_d_exports } from "./dgram.js";
 import { t as http_d_exports } from "./http.js";
 import { t as desktop_d_exports } from "./desktop.js";

package/{net-BKkf8QK3.d.ts → net-BhNzd0mR.d.ts}

@@ -1,4 +1,4 @@
-import { i as TcpSocketOption, r as LocalTcpSocket, t as Resolvers } from "./api-BYRsWdwB.js";
+import { i as TcpSocketOption, r as LocalTcpSocket, t as Resolvers } from "./api-VR2xHGZu.js";
 import { AddressInfo, ListenOptions, Server, ServerOpts, Socket, SocketConnectOpts, SocketConstructorOpts } from "net";
 import { DuplexOptions, Stream } from "stream";
 import { EventEmitter } from "events";

package/net.d.ts

@@ -1,2 +1,2 @@
-import { a as createConnection, c as isIP, i as connect, l as isIPv4, n as Socket, o as createServer, r as _default, t as Server, u as isIPv6 } from "./net-BKkf8QK3.js";
+import { a as createConnection, c as isIP, i as connect, l as isIPv4, n as Socket, o as createServer, r as _default, t as Server, u as isIPv6 } from "./net-BhNzd0mR.js";
 export { Server, Socket, _default, _default as default, connect, createConnection, createServer, isIP, isIPv4, isIPv6 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fkn/lib",
-  "version": "0.9.9",
+  "version": "0.9.11",
   "main": "index.js",
   "types": "index.d.ts",
   "type": "module",

package/{packages-BtbLwrrW.d.ts → packages-vX-1yfRK.d.ts}

@@ -70,10 +70,27 @@ type PackagesFail = {
  */
 type Caller = {
   id: string;
-  origin: string;
+  origin: string; /** a package's display name, when provenance knew it. Attribution only, never an identity. */
+  name?: string;
+  /**
+   * Set when PROVENANCE established this caller is a package, which is the only way to know it for a
+   * connection whose `origin` is this realm's own (a broker nested inside a tenant we mounted). Every
+   * other package caller is recognised from its browser-set tenant origin instead.
+   */
+  isPackage?: boolean;
+};
+//#endregion
+//#region src/api/packages/host.d.ts
+type MountDescriptor = {
+  /** where to point the iframe: the tenant origin plus the package's path */url: string; /** the tenant origin alone, which is what a `postMessage` to that frame must target */
+  origin: string; /** the version-free identity, echoed to the package in the port message */
+  uri: string;
+  name: string;
+  version: string | null; /** the connecting app, as the BROKER knows it */
+  from: string;
 };
 declare namespace packages_d_exports {
-  export { AppConnectOptions, Connect, ConnectOptions, ConnectPayload, IncomingConnection, IncomingConnectionInfo, InstallOptions, InstalledPackage, PackageConnection, PackageQuery, PackageResult, PackageView, PackagesError, PackagesErrorCode, PickOptions, Placement, Radii, RawPackageConnection, ShowOptions, SurfaceRect, attach, connect, hide, install, isVisible, list, onConnect, onVisibilityChange, pick, search, show, uninstall };
+  export { AppConnectOptions, Connect, ConnectOptions, ConnectPayload, IncomingConnection, IncomingConnectionInfo, InstallOptions, InstalledPackage, MountOptions, MountedPackage, PackageConnection, PackageQuery, PackageResult, PackageView, PackagesError, PackagesErrorCode, PickOptions, Placement, Radii, RawPackageConnection, ShowOptions, SurfaceRect, attach, connect, hide, install, isVisible, list, mount, onConnect, onVisibilityChange, pick, search, show, uninstall };
 }
 type PackagesError = Error & {
   code: PackagesErrorCode;
@@ -135,6 +152,36 @@ type Connect = {
 };
 /** Connect to an installed package. Throws a PackagesError with code 'not-installed' when it is not. */
 declare const connect: Connect;
+type MountOptions = AppConnectOptions & {
+  /**
+   * the iframe the package is loaded into. YOU create it and YOU own it: its attributes, its styles and
+   * its place in your layout are yours, and `mount` only navigates it.
+   *
+   * Set `allow` yourself for anything the package needs delegated, e.g. `allow="fullscreen; autoplay"`.
+   * Permissions policy is not inherited, so a capability this frame is not granted cannot be recovered
+   * by the package or by anything it nests inside itself.
+   */
+  iframe: HTMLIFrameElement;
+};
+type MountedPackage<T = unknown> = PackageConnection<T> & {
+  /** the iframe you passed in, unchanged apart from its `src` */frame: HTMLIFrameElement; /** blank the frame and settle `closed`; the element stays in your layout because it is yours */
+  unmount: () => void;
+};
+/**
+ * Load a package into an iframe of YOUR OWN and connect to it, instead of positioning a frame the broker
+ * owns and clipping the overlay to it the way `show()` does.
+ *
+ * You pass the iframe, the same way `cloud.attachFrame` takes one. It lays out, scrolls, stacks and
+ * fullscreens with the rest of your page, there is no geometry to translate, and every attribute on it
+ * stays exactly as you set it: `mount` reads `sandbox` and `allow` to check the package can boot, then
+ * writes nothing but `src`. The package still gets its own origin and its own broker connection.
+ *
+ * Grant capabilities through the iframe's own `allow`, before calling this. Permissions policy is read
+ * at navigation and is not inherited, so it cannot be added afterwards on the frame handed back.
+ *
+ * Needs a package built against this version of the lib: an older one only accepts a port from fkn.app.
+ */
+declare const mount: <T = unknown>(uri: string, options: MountOptions) => Promise<MountedPackage<T>>;
 /** Run this end of an already-brokered connection port, e.g. after transferring it into a worker. */
 declare const attach: <T = unknown>(port: MessagePort, payload?: unknown, options?: {
   signal?: AbortSignal;
@@ -167,4 +214,4 @@ declare const onVisibilityChange: (handler: (visible: boolean) => void) => {
   unsubscribe: () => void;
 };
 //#endregion
-export { PackagesErrorCode as A, uninstall as C, InstalledPackage as D, InstallOptions as E, SurfaceRect as F, PickOptions as M, Placement as N, PackageQuery as O, Radii as P, show as S, ConnectOptions as T, onConnect as _, IncomingConnectionInfo as a, pick as b, PackagesError as c, attach as d, connect as f, list as g, isVisible as h, IncomingConnection as i, PackagesFail as j, PackageResult as k, RawPackageConnection as l, install as m, Connect as n, PackageConnection as o, hide as p, ConnectPayload as r, PackageView as s, AppConnectOptions as t, ShowOptions as u, onVisibilityChange as v, Caller as w, search as x, packages_d_exports as y };
+export { InstallOptions as A, pick as C, MountDescriptor as D, uninstall as E, PackagesFail as F, PickOptions as I, Placement as L, PackageQuery as M, PackageResult as N, Caller as O, PackagesErrorCode as P, Radii as R, packages_d_exports as S, show as T, isVisible as _, IncomingConnectionInfo as a, onConnect as b, PackageConnection as c, RawPackageConnection as d, ShowOptions as f, install as g, hide as h, IncomingConnection as i, InstalledPackage as j, ConnectOptions as k, PackageView as l, connect as m, Connect as n, MountOptions as o, attach as p, ConnectPayload as r, MountedPackage as s, AppConnectOptions as t, PackagesError as u, list as v, search as w, onVisibilityChange as x, mount as y, SurfaceRect as z };

package/packages.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./rolldown-runtime-BIInC43l.cjs"),t=require("./api-dp9SlXVw.cjs");let n=require("osra");var r=e.t({attach:()=>E,connect:()=>T,hide:()=>w,install:()=>p,isVisible:()=>B,list:()=>m,onConnect:()=>z,onVisibilityChange:()=>V,pick:()=>f,search:()=>d,show:()=>C,uninstall:()=>h}),i=`https://fkn.app`,a=`fkn-packages-connection`,o=3e4,s=(e,t)=>Object.assign(Error(t),{code:e}),c=async()=>{if(!t.r)throw s(`unavailable`,`packages: no FKN transport in this realm - use relayWorker to bridge workers`);return t.t},l=(e,t,r)=>(0,n.expose)(e??{},{transport:t,key:a,unregisterSignal:r}),u=async(e,t,n={})=>{let{signal:r,closed:i}=n;if(r?.aborted)throw s(`unavailable`,`packages.connect: aborted before connecting`);let a=new AbortController;r&&r.addEventListener(`abort`,()=>a.abort(r.reason),{once:!0});let c=new AbortController,u=new Promise((e,n)=>{let a=setTimeout(()=>n(s(`timeout`,`packages.connect: the package did not complete the connection`)),o);c.signal.addEventListener(`abort`,()=>clearTimeout(a),{once:!0}),t.addEventListener(`message`,e=>{if(e.data?.type===`fkn-packages-nack`){let t=e.data.message;n(s(`unavailable`,typeof t==`string`&&t?t:`packages.connect: the package refused the connection`))}},{signal:c.signal}),t.start(),r&&r.addEventListener(`abort`,()=>n(s(`unavailable`,`packages.connect: aborted before connecting`)),{once:!0,signal:c.signal}),i?.then(()=>n(s(`unavailable`,`packages.connect: the package closed before connecting`)))});try{return await Promise.race([l(e,t,a.signal),u])}catch(e){a.abort(e);try{t.close()}catch{}throw e}finally{c.abort()}},d=async e=>{let t=await(await c()).packages.search(e);if(`error`in t)throw s(t.error,t.message);return t.results},f=async(e,t)=>{let n=await(await c()).packages.pick(e,t);if(`error`in n)throw s(n.error,n.message);return`declined`in n?[]:n.results},p=async(e,t)=>{let n=await(await c()).packages.install(e,t);if(`error`in n)throw s(n.error,n.message);return`declined`in n?null:n.installed},m=async()=>(await(await c()).packages.list()).results,h=async e=>{let t=await(await c()).packages.uninstall(e);if(`error`in t)throw s(t.error,t.message)},g=({x:e,y:t,width:n,height:r})=>({x:Math.round(e),y:Math.round(t),width:Math.round(n),height:Math.round(r)}),_=(e,t)=>{let n=Math.max(e.x,t.x),r=Math.max(e.y,t.y);return{x:n,y:r,width:Math.max(0,Math.min(e.x+e.width,t.x+t.width)-n),height:Math.max(0,Math.min(e.y+e.height,t.y+t.height)-r)}},v=(e,t)=>{let n=t;for(let t=e.parentElement;t;t=t.parentElement){let e=getComputedStyle(t);if(!(e.overflowX===`visible`&&e.overflowY===`visible`)&&(n=_(n,g(t.getBoundingClientRect())),n.width===0||n.height===0))break}return n},y=e=>{let t=getComputedStyle(e),n=[t.borderTopLeftRadius,t.borderTopRightRadius,t.borderBottomRightRadius,t.borderBottomLeftRadius];if(n.some(e=>e.includes(`%`)||e.includes(` `)))return;let r=n.map(e=>{let t=Number.parseFloat(e);return Number.isFinite(t)&&t>0?t:0});return r.some(e=>e>0)?r:void 0},b=(e,t)=>{if(!e)return!1;let n=(e,t)=>e===t||!!e&&!!t&&e.x===t.x&&e.y===t.y&&e.width===t.width&&e.height===t.height;return n(e.rect,t.rect)&&n(e.clip,t.clip)&&((e,t)=>e===t||!!e&&!!t&&e.every((e,n)=>e===t[n]))(e.radius,t.radius)},x=new Map,S=async(e,t)=>{let n=x.get(e);if(n){for(let e of n)t&&e.element!==t||(e.stop(),n.delete(e));if(n.size>0)return;x.delete(e)}let r=await(await c()).packages.hide(e);if(`error`in r)throw s(r.error,r.message)},C=async(e,t)=>{let{element:n,rect:r}=t;if(!n&&!r)throw s(`invalid`,`packages.show: pass an element or a rect`);let i=(await c()).packages,a=()=>{if(!n)return{rect:g(r)};let e=g(n.getBoundingClientRect());return{rect:e,clip:v(n,e),radius:y(n)}},o=!0,l,u=0,d=async t=>{l=t;let n=await i.show(e,t);if(`error`in n)throw o=!1,s(n.error,n.message)};await d(a());let f=()=>{if(!o)return;let e=a();b(l,e)||d(e).catch(()=>{}),u=requestAnimationFrame(f)};n&&(u=requestAnimationFrame(f));let p={element:n,stop:()=>{o=!1,cancelAnimationFrame(u)}},m=x.get(e)??new Set;return m.add(p),x.set(e,m),{hide:()=>{S(e,n).catch(()=>{})},refresh:()=>{if(!o)return;let e=a();b(l,e)||d(e).catch(()=>{})}}},w=async(e,t={})=>S(e,t.element),T=(async(e,t={})=>{let n=await(await c()).packages.connect(e,{protocol:t.protocol});if(`error`in n)throw s(n.error,n.message);let{port:r,closed:i}=n;if(t.raw)return{closed:i,port:r};let a=await u(t.payload,r,{signal:t.signal,closed:i});return t.signal&&t.signal.addEventListener(`abort`,()=>{try{r.postMessage({type:`fkn-packages-disconnect`})}catch{}},{once:!0}),{remote:a,closed:i,port:r}}),E=(e,t,n)=>u(t,e,{signal:n?.signal}),D=null,O=!1,k=new Set,A=[],j=new Map,M=!1,N=!1,P=e=>{let t=j.get(e);t&&(j.delete(e),t())},F=(e,t)=>{try{e.postMessage({type:`fkn-packages-nack`,message:t})}catch{}try{e.close()}catch{}},I=async(e,t)=>{let{port:n,...r}=e;e.port.addEventListener(`message`,t=>{t.data?.type===`fkn-packages-disconnect`&&P(e.port)});let i;try{i=await t.createPayload(r)}catch(t){throw F(e.port,t instanceof Error?t.message:`the package failed to produce a connection`),t}let a=new Promise(t=>j.set(e.port,t)),o=await l(i,e.port);t.handler?.({...r,remote:o,closed:a,port:e.port})},L=()=>{M||typeof window>`u`||window.parent===window||(M=!0,window.addEventListener(`message`,e=>{if(e.source!==window.parent||e.origin!==i)return;let t=e.data;if(t?.type===`fkn-packages-port`){let n=e.ports[0];if(!n)return;let r={port:n,from:typeof t.from==`string`?t.from:``,protocol:typeof t.protocol==`string`?t.protocol:null,uri:typeof t.uri==`string`?t.uri:``,name:typeof t.name==`string`?t.name:``,version:typeof t.version==`string`?t.version:``};D?I(r,D).catch(e=>console.warn(`packages.onConnect:`,e)):A.push(r)}if(t?.type===`fkn-packages-close`)for(let e of[...j.keys()])P(e);if(t?.type===`fkn-packages-visibility`){O=t.visible===!0;for(let e of k)try{e(O)}catch{}}}))},R=()=>{N||typeof window>`u`||window.parent===window||(N=!0,window.parent.postMessage({type:`fkn-packages-ready`},i))},z=(e,t)=>{if(typeof window>`u`)return{unsubscribe:()=>{}};L();let n={createPayload:e,handler:t};for(D=n,R();A.length&&D===n;)I(A.shift(),n).catch(e=>console.warn(`packages.onConnect:`,e));return{unsubscribe:()=>{D===n&&(D=null)}}},B=()=>O,V=e=>{if(typeof window>`u`)return{unsubscribe:()=>{}};L(),k.add(e);try{e(O)}catch{}return{unsubscribe:()=>{k.delete(e)}}};exports.attach=E,exports.connect=T,exports.hide=w,exports.install=p,exports.isVisible=B,exports.list=m,exports.onConnect=z,exports.onVisibilityChange=V,exports.pick=f,exports.search=d,exports.show=C,Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return r}}),exports.uninstall=h;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./rolldown-runtime-BIInC43l.cjs"),t=require("./api-dp9SlXVw.cjs");let n=require("osra");var r=e.t({attach:()=>A,connect:()=>w,hide:()=>C,install:()=>f,isVisible:()=>W,list:()=>p,mount:()=>k,onConnect:()=>U,onVisibilityChange:()=>G,pick:()=>d,search:()=>u,show:()=>S,uninstall:()=>m}),i=`fkn-packages-connection`,a=3e4,o=(e,t)=>Object.assign(Error(t),{code:e}),s=async()=>{if(!t.r)throw o(`unavailable`,`packages: no FKN transport in this realm - use relayWorker to bridge workers`);return t.t},c=(e,t,r)=>(0,n.expose)(e??{},{transport:t,key:i,unregisterSignal:r}),l=async(e,t,n={})=>{let{signal:r,closed:i}=n;if(r?.aborted)throw o(`unavailable`,`packages.connect: aborted before connecting`);let s=new AbortController;r&&r.addEventListener(`abort`,()=>s.abort(r.reason),{once:!0});let l=new AbortController,u=new Promise((e,n)=>{let s=setTimeout(()=>n(o(`timeout`,`packages.connect: the package did not complete the connection`)),a);l.signal.addEventListener(`abort`,()=>clearTimeout(s),{once:!0}),t.addEventListener(`message`,e=>{if(e.data?.type===`fkn-packages-nack`){let t=e.data.message;n(o(`unavailable`,typeof t==`string`&&t?t:`packages.connect: the package refused the connection`))}},{signal:l.signal}),t.start(),r&&r.addEventListener(`abort`,()=>n(o(`unavailable`,`packages.connect: aborted before connecting`)),{once:!0,signal:l.signal}),i?.then(()=>n(o(`unavailable`,`packages.connect: the package closed before connecting`)))});try{return await Promise.race([c(e,t,s.signal),u])}catch(e){s.abort(e);try{t.close()}catch{}throw e}finally{l.abort()}},u=async e=>{let t=await(await s()).packages.search(e);if(`error`in t)throw o(t.error,t.message);return t.results},d=async(e,t)=>{let n=await(await s()).packages.pick(e,t);if(`error`in n)throw o(n.error,n.message);return`declined`in n?[]:n.results},f=async(e,t)=>{let n=await(await s()).packages.install(e,t);if(`error`in n)throw o(n.error,n.message);return`declined`in n?null:n.installed},p=async()=>(await(await s()).packages.list()).results,m=async e=>{let t=await(await s()).packages.uninstall(e);if(`error`in t)throw o(t.error,t.message)},h=({x:e,y:t,width:n,height:r})=>({x:Math.round(e),y:Math.round(t),width:Math.round(n),height:Math.round(r)}),g=(e,t)=>{let n=Math.max(e.x,t.x),r=Math.max(e.y,t.y);return{x:n,y:r,width:Math.max(0,Math.min(e.x+e.width,t.x+t.width)-n),height:Math.max(0,Math.min(e.y+e.height,t.y+t.height)-r)}},_=(e,t)=>{let n=t;for(let t=e.parentElement;t;t=t.parentElement){let e=getComputedStyle(t);if(!(e.overflowX===`visible`&&e.overflowY===`visible`)&&(n=g(n,h(t.getBoundingClientRect())),n.width===0||n.height===0))break}return n},v=e=>{let t=getComputedStyle(e),n=[t.borderTopLeftRadius,t.borderTopRightRadius,t.borderBottomRightRadius,t.borderBottomLeftRadius];if(n.some(e=>e.includes(`%`)||e.includes(` `)))return;let r=n.map(e=>{let t=Number.parseFloat(e);return Number.isFinite(t)&&t>0?t:0});return r.some(e=>e>0)?r:void 0},y=(e,t)=>{if(!e)return!1;let n=(e,t)=>e===t||!!e&&!!t&&e.x===t.x&&e.y===t.y&&e.width===t.width&&e.height===t.height;return n(e.rect,t.rect)&&n(e.clip,t.clip)&&((e,t)=>e===t||!!e&&!!t&&e.every((e,n)=>e===t[n]))(e.radius,t.radius)},b=new Map,x=async(e,t)=>{let n=b.get(e);if(n){for(let e of n)t&&e.element!==t||(e.stop(),n.delete(e));if(n.size>0)return;b.delete(e)}let r=await(await s()).packages.hide(e);if(`error`in r)throw o(r.error,r.message)},S=async(e,t)=>{let{element:n,rect:r}=t;if(!n&&!r)throw o(`invalid`,`packages.show: pass an element or a rect`);let i=(await s()).packages,a=()=>{if(!n)return{rect:h(r)};let e=h(n.getBoundingClientRect());return{rect:e,clip:_(n,e),radius:v(n)}},c=!0,l,u=0,d=async t=>{l=t;let n=await i.show(e,t);if(`error`in n)throw c=!1,o(n.error,n.message)};await d(a());let f=()=>{if(!c)return;let e=a();y(l,e)||d(e).catch(()=>{}),u=requestAnimationFrame(f)};n&&(u=requestAnimationFrame(f));let p={element:n,stop:()=>{c=!1,cancelAnimationFrame(u)}},m=b.get(e)??new Set;return m.add(p),b.set(e,m),{hide:()=>{x(e,n).catch(()=>{})},refresh:()=>{if(!c)return;let e=a();y(l,e)||d(e).catch(()=>{})}}},C=async(e,t={})=>x(e,t.element),w=(async(e,t={})=>{let n=await(await s()).packages.connect(e,{protocol:t.protocol});if(`error`in n)throw o(n.error,n.message);let{port:r,closed:i}=n;if(t.raw)return{closed:i,port:r};let a=await l(t.payload,r,{signal:t.signal,closed:i});return t.signal&&t.signal.addEventListener(`abort`,()=>{try{r.postMessage({type:`fkn-packages-disconnect`})}catch{}},{once:!0}),{remote:a,closed:i,port:r}}),T=[`allow-scripts`,`allow-same-origin`],E=e=>{let t=e.getAttribute(`sandbox`);if(t!==null){let e=new Set(t.toLowerCase().split(/\s+/).filter(Boolean)),n=T.filter(t=>!e.has(t));if(n.length)throw o(`invalid`,`packages.mount: the iframe's sandbox attribute must include ${n.join(` and `)}, or the package cannot start`)}if(globalThis.crossOriginIsolated&&!new Set((e.getAttribute(`allow`)??``).toLowerCase().split(`;`).map(e=>e.trim().split(/\s+/)[0]).filter(Boolean)).has(`cross-origin-isolated`))throw o(`invalid`,`packages.mount: this page is cross-origin isolated, so the iframe's allow attribute must include 'cross-origin-isolated' to hand that down to the package`)},D=3e4,O=(e,t)=>new Promise((n,r)=>{let i=e=>{clearTimeout(s),window.removeEventListener(`message`,a),e?r(e):n()},a=n=>{if(n.source!==e.contentWindow||n.origin!==t)return;let r=n.data;if(r?.type===`fkn-packages-ready`)return i();r?.type===`fkn-packages-failed`&&i(o(`unavailable`,typeof r.message==`string`&&r.message?r.message:`packages.mount: the package failed to boot`))},s=setTimeout(()=>i(o(`timeout`,`packages.mount: the package did not register a connection handler`)),D);window.addEventListener(`message`,a)}),k=async(e,t)=>{let{iframe:n}=t;if(!(n instanceof HTMLIFrameElement))throw o(`invalid`,`packages.mount: pass the iframe to load the package into`);if(!n.isConnected)throw o(`invalid`,`packages.mount: the iframe must be in the document before mounting into it`);E(n);let r=await(await s()).packages.frame(e);if(`error`in r)throw o(r.error,r.message);n.src=r.url;let i={done:!1},a=()=>{},c=new Promise(e=>{a=e}),u=()=>{if(!i.done){i.done=!0;try{n.contentWindow?.postMessage({type:`fkn-packages-close`},r.origin)}catch{}n.src=`about:blank`,a()}};try{await O(n,r.origin)}catch(e){throw u(),e}let d=new MessageChannel,f=n.contentWindow;if(!f)throw u(),o(`unavailable`,`packages.mount: the frame was detached before it could connect`);f.postMessage({type:`fkn-packages-port`,from:r.from,protocol:t.protocol,uri:r.uri,name:r.name,version:r.version},r.origin,[d.port2]);try{f.postMessage({type:`fkn-packages-visibility`,visible:!0},r.origin)}catch{}return t.raw?{closed:c,port:d.port1,frame:n,unmount:u}:{remote:await l(t.payload,d.port1,{signal:t.signal,closed:c}),closed:c,port:d.port1,frame:n,unmount:u}},A=(e,t,n)=>l(t,e,{signal:n?.signal}),j=null,M=!1,N=new Set,P=[],F=new Map,I=!1,L=!1,R=e=>{let t=F.get(e);t&&(F.delete(e),t())},z=(e,t)=>{try{e.postMessage({type:`fkn-packages-nack`,message:t})}catch{}try{e.close()}catch{}},B=async(e,t)=>{let{port:n,...r}=e;e.port.addEventListener(`message`,t=>{t.data?.type===`fkn-packages-disconnect`&&R(e.port)});let i;try{i=await t.createPayload(r)}catch(t){throw z(e.port,t instanceof Error?t.message:`the package failed to produce a connection`),t}let a=new Promise(t=>F.set(e.port,t)),o=await c(i,e.port);t.handler?.({...r,remote:o,closed:a,port:e.port})},V=()=>{I||typeof window>`u`||window.parent===window||(I=!0,window.addEventListener(`message`,e=>{if(e.source!==window.parent)return;let t=e.data;if(t?.type===`fkn-packages-port`){let n=e.ports[0];if(!n)return;let r={port:n,from:typeof t.from==`string`?t.from:``,protocol:typeof t.protocol==`string`?t.protocol:null,uri:typeof t.uri==`string`?t.uri:``,name:typeof t.name==`string`?t.name:``,version:typeof t.version==`string`?t.version:``};j?B(r,j).catch(e=>console.warn(`packages.onConnect:`,e)):P.push(r)}if(t?.type===`fkn-packages-close`)for(let e of[...F.keys()])R(e);if(t?.type===`fkn-packages-visibility`){M=t.visible===!0;for(let e of N)try{e(M)}catch{}}}))},H=()=>{L||typeof window>`u`||window.parent===window||(L=!0,window.parent.postMessage({type:`fkn-packages-ready`},`*`))},U=(e,t)=>{if(typeof window>`u`)return{unsubscribe:()=>{}};V();let n={createPayload:e,handler:t};for(j=n,H();P.length&&j===n;)B(P.shift(),n).catch(e=>console.warn(`packages.onConnect:`,e));return{unsubscribe:()=>{j===n&&(j=null)}}},W=()=>M,G=e=>{if(typeof window>`u`)return{unsubscribe:()=>{}};V(),N.add(e);try{e(M)}catch{}return{unsubscribe:()=>{N.delete(e)}}};exports.attach=A,exports.connect=w,exports.hide=C,exports.install=f,exports.isVisible=W,exports.list=p,exports.mount=k,exports.onConnect=U,exports.onVisibilityChange=G,exports.pick=d,exports.search=u,exports.show=S,Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return r}}),exports.uninstall=m;

package/packages.d.ts

@@ -1,2 +1,2 @@
-import { A as PackagesErrorCode, C as uninstall, D as InstalledPackage, E as InstallOptions, F as SurfaceRect, M as PickOptions, N as Placement, O as PackageQuery, P as Radii, S as show, T as ConnectOptions, _ as onConnect, a as IncomingConnectionInfo, b as pick, c as PackagesError, d as attach, f as connect, g as list, h as isVisible, i as IncomingConnection, k as PackageResult, l as RawPackageConnection, m as install, n as Connect, o as PackageConnection, p as hide, r as ConnectPayload, s as PackageView, t as AppConnectOptions, u as ShowOptions, v as onVisibilityChange, x as search } from "./packages-BtbLwrrW.js";
-export { AppConnectOptions, Connect, type ConnectOptions, ConnectPayload, IncomingConnection, IncomingConnectionInfo, type InstallOptions, type InstalledPackage, PackageConnection, type PackageQuery, type PackageResult, PackageView, PackagesError, type PackagesErrorCode, type PickOptions, type Placement, type Radii, RawPackageConnection, ShowOptions, type SurfaceRect, attach, connect, hide, install, isVisible, list, onConnect, onVisibilityChange, pick, search, show, uninstall };
+import { A as InstallOptions, C as pick, E as uninstall, I as PickOptions, L as Placement, M as PackageQuery, N as PackageResult, P as PackagesErrorCode, R as Radii, T as show, _ as isVisible, a as IncomingConnectionInfo, b as onConnect, c as PackageConnection, d as RawPackageConnection, f as ShowOptions, g as install, h as hide, i as IncomingConnection, j as InstalledPackage, k as ConnectOptions, l as PackageView, m as connect, n as Connect, o as MountOptions, p as attach, r as ConnectPayload, s as MountedPackage, t as AppConnectOptions, u as PackagesError, v as list, w as search, x as onVisibilityChange, y as mount, z as SurfaceRect } from "./packages-vX-1yfRK.js";
+export { AppConnectOptions, Connect, type ConnectOptions, ConnectPayload, IncomingConnection, IncomingConnectionInfo, type InstallOptions, type InstalledPackage, MountOptions, MountedPackage, PackageConnection, type PackageQuery, type PackageResult, PackageView, PackagesError, type PackagesErrorCode, type PickOptions, type Placement, type Radii, RawPackageConnection, ShowOptions, type SurfaceRect, attach, connect, hide, install, isVisible, list, mount, onConnect, onVisibilityChange, pick, search, show, uninstall };

package/packages.js

@@ -3,44 +3,45 @@ import { r as t, t as n } from "./api-B53pjQqI.js";
 import { expose as r } from "osra";
 //#region src/lib/packages.ts
 var i = /* @__PURE__ */ e({
-	attach: () => D,
-	connect: () => E,
-	hide: () => T,
-	install: () => m,
-	isVisible: () => V,
-	list: () => h,
-	onConnect: () => B,
-	onVisibilityChange: () => H,
-	pick: () => p,
-	search: () => f,
-	show: () => w,
-	uninstall: () => g
-}), a = "https://fkn.app", o = "fkn-packages-connection", s = 3e4, c = (e, t) => Object.assign(Error(t), { code: e }), l = async () => {
-	if (!t) throw c("unavailable", "packages: no FKN transport in this realm - use relayWorker to bridge workers");
+	attach: () => j,
+	connect: () => T,
+	hide: () => w,
+	install: () => p,
+	isVisible: () => G,
+	list: () => m,
+	mount: () => A,
+	onConnect: () => W,
+	onVisibilityChange: () => K,
+	pick: () => f,
+	search: () => d,
+	show: () => C,
+	uninstall: () => h
+}), a = "fkn-packages-connection", o = 3e4, s = (e, t) => Object.assign(Error(t), { code: e }), c = async () => {
+	if (!t) throw s("unavailable", "packages: no FKN transport in this realm - use relayWorker to bridge workers");
 	return n;
-}, u = (e, t, n) => r(e ?? {}, {
+}, l = (e, t, n) => r(e ?? {}, {
 	transport: t,
-	key: o,
+	key: a,
 	unregisterSignal: n
-}), d = async (e, t, n = {}) => {
+}), u = async (e, t, n = {}) => {
 	let { signal: r, closed: i } = n;
-	if (r?.aborted) throw c("unavailable", "packages.connect: aborted before connecting");
+	if (r?.aborted) throw s("unavailable", "packages.connect: aborted before connecting");
 	let a = new AbortController();
 	r && r.addEventListener("abort", () => a.abort(r.reason), { once: !0 });
-	let o = new AbortController(), l = new Promise((e, n) => {
-		let a = setTimeout(() => n(c("timeout", "packages.connect: the package did not complete the connection")), s);
-		o.signal.addEventListener("abort", () => clearTimeout(a), { once: !0 }), t.addEventListener("message", (e) => {
+	let c = new AbortController(), u = new Promise((e, n) => {
+		let a = setTimeout(() => n(s("timeout", "packages.connect: the package did not complete the connection")), o);
+		c.signal.addEventListener("abort", () => clearTimeout(a), { once: !0 }), t.addEventListener("message", (e) => {
 			if (e.data?.type === "fkn-packages-nack") {
 				let t = e.data.message;
-				n(c("unavailable", typeof t == "string" && t ? t : "packages.connect: the package refused the connection"));
+				n(s("unavailable", typeof t == "string" && t ? t : "packages.connect: the package refused the connection"));
 			}
-		}, { signal: o.signal }), t.start(), r && r.addEventListener("abort", () => n(c("unavailable", "packages.connect: aborted before connecting")), {
+		}, { signal: c.signal }), t.start(), r && r.addEventListener("abort", () => n(s("unavailable", "packages.connect: aborted before connecting")), {
 			once: !0,
-			signal: o.signal
-		}), i?.then(() => n(c("unavailable", "packages.connect: the package closed before connecting")));
+			signal: c.signal
+		}), i?.then(() => n(s("unavailable", "packages.connect: the package closed before connecting")));
 	});
 	try {
-		return await Promise.race([u(e, t, a.signal), l]);
+		return await Promise.race([l(e, t, a.signal), u]);
 	} catch (e) {
 		a.abort(e);
 		try {
@@ -48,29 +49,29 @@ var i = /* @__PURE__ */ e({
 		} catch {}
 		throw e;
 	} finally {
-		o.abort();
+		c.abort();
 	}
-}, f = async (e) => {
-	let t = await (await l()).packages.search(e);
-	if ("error" in t) throw c(t.error, t.message);
+}, d = async (e) => {
+	let t = await (await c()).packages.search(e);
+	if ("error" in t) throw s(t.error, t.message);
 	return t.results;
-}, p = async (e, t) => {
-	let n = await (await l()).packages.pick(e, t);
-	if ("error" in n) throw c(n.error, n.message);
+}, f = async (e, t) => {
+	let n = await (await c()).packages.pick(e, t);
+	if ("error" in n) throw s(n.error, n.message);
 	return "declined" in n ? [] : n.results;
-}, m = async (e, t) => {
-	let n = await (await l()).packages.install(e, t);
-	if ("error" in n) throw c(n.error, n.message);
+}, p = async (e, t) => {
+	let n = await (await c()).packages.install(e, t);
+	if ("error" in n) throw s(n.error, n.message);
 	return "declined" in n ? null : n.installed;
-}, h = async () => (await (await l()).packages.list()).results, g = async (e) => {
-	let t = await (await l()).packages.uninstall(e);
-	if ("error" in t) throw c(t.error, t.message);
-}, _ = ({ x: e, y: t, width: n, height: r }) => ({
+}, m = async () => (await (await c()).packages.list()).results, h = async (e) => {
+	let t = await (await c()).packages.uninstall(e);
+	if ("error" in t) throw s(t.error, t.message);
+}, g = ({ x: e, y: t, width: n, height: r }) => ({
 	x: Math.round(e),
 	y: Math.round(t),
 	width: Math.round(n),
 	height: Math.round(r)
-}), v = (e, t) => {
+}), _ = (e, t) => {
 	let n = Math.max(e.x, t.x), r = Math.max(e.y, t.y);
 	return {
 		x: n,
@@ -78,14 +79,14 @@ var i = /* @__PURE__ */ e({
 		width: Math.max(0, Math.min(e.x + e.width, t.x + t.width) - n),
 		height: Math.max(0, Math.min(e.y + e.height, t.y + t.height) - r)
 	};
-}, y = (e, t) => {
+}, v = (e, t) => {
 	let n = t;
 	for (let t = e.parentElement; t; t = t.parentElement) {
 		let e = getComputedStyle(t);
-		if (!(e.overflowX === "visible" && e.overflowY === "visible") && (n = v(n, _(t.getBoundingClientRect())), n.width === 0 || n.height === 0)) break;
+		if (!(e.overflowX === "visible" && e.overflowY === "visible") && (n = _(n, g(t.getBoundingClientRect())), n.width === 0 || n.height === 0)) break;
 	}
 	return n;
-}, b = (e) => {
+}, y = (e) => {
 	let t = getComputedStyle(e), n = [
 		t.borderTopLeftRadius,
 		t.borderTopRightRadius,
@@ -98,40 +99,40 @@ var i = /* @__PURE__ */ e({
 		return Number.isFinite(t) && t > 0 ? t : 0;
 	});
 	return r.some((e) => e > 0) ? r : void 0;
-}, x = (e, t) => {
+}, b = (e, t) => {
 	if (!e) return !1;
 	let n = (e, t) => e === t || !!e && !!t && e.x === t.x && e.y === t.y && e.width === t.width && e.height === t.height;
 	return n(e.rect, t.rect) && n(e.clip, t.clip) && ((e, t) => e === t || !!e && !!t && e.every((e, n) => e === t[n]))(e.radius, t.radius);
-}, S = /* @__PURE__ */ new Map(), C = async (e, t) => {
-	let n = S.get(e);
+}, x = /* @__PURE__ */ new Map(), S = async (e, t) => {
+	let n = x.get(e);
 	if (n) {
 		for (let e of n) t && e.element !== t || (e.stop(), n.delete(e));
 		if (n.size > 0) return;
-		S.delete(e);
+		x.delete(e);
 	}
-	let r = await (await l()).packages.hide(e);
-	if ("error" in r) throw c(r.error, r.message);
-}, w = async (e, t) => {
+	let r = await (await c()).packages.hide(e);
+	if ("error" in r) throw s(r.error, r.message);
+}, C = async (e, t) => {
 	let { element: n, rect: r } = t;
-	if (!n && !r) throw c("invalid", "packages.show: pass an element or a rect");
-	let i = (await l()).packages, a = () => {
-		if (!n) return { rect: _(r) };
-		let e = _(n.getBoundingClientRect());
+	if (!n && !r) throw s("invalid", "packages.show: pass an element or a rect");
+	let i = (await c()).packages, a = () => {
+		if (!n) return { rect: g(r) };
+		let e = g(n.getBoundingClientRect());
 		return {
 			rect: e,
-			clip: y(n, e),
-			radius: b(n)
+			clip: v(n, e),
+			radius: y(n)
 		};
-	}, o = !0, s, u = 0, d = async (t) => {
-		s = t;
+	}, o = !0, l, u = 0, d = async (t) => {
+		l = t;
 		let n = await i.show(e, t);
-		if ("error" in n) throw o = !1, c(n.error, n.message);
+		if ("error" in n) throw o = !1, s(n.error, n.message);
 	};
 	await d(a());
 	let f = () => {
 		if (!o) return;
 		let e = a();
-		x(s, e) || d(e).catch(() => {}), u = requestAnimationFrame(f);
+		b(l, e) || d(e).catch(() => {}), u = requestAnimationFrame(f);
 	};
 	n && (u = requestAnimationFrame(f));
 	let p = {
@@ -139,26 +140,26 @@ var i = /* @__PURE__ */ e({
 		stop: () => {
 			o = !1, cancelAnimationFrame(u);
 		}
-	}, m = S.get(e) ?? /* @__PURE__ */ new Set();
-	return m.add(p), S.set(e, m), {
+	}, m = x.get(e) ?? /* @__PURE__ */ new Set();
+	return m.add(p), x.set(e, m), {
 		hide: () => {
-			C(e, n).catch(() => {});
+			S(e, n).catch(() => {});
 		},
 		refresh: () => {
 			if (!o) return;
 			let e = a();
-			x(s, e) || d(e).catch(() => {});
+			b(l, e) || d(e).catch(() => {});
 		}
 	};
-}, T = async (e, t = {}) => C(e, t.element), E = (async (e, t = {}) => {
-	let n = await (await l()).packages.connect(e, { protocol: t.protocol });
-	if ("error" in n) throw c(n.error, n.message);
+}, w = async (e, t = {}) => S(e, t.element), T = (async (e, t = {}) => {
+	let n = await (await c()).packages.connect(e, { protocol: t.protocol });
+	if ("error" in n) throw s(n.error, n.message);
 	let { port: r, closed: i } = n;
 	if (t.raw) return {
 		closed: i,
 		port: r
 	};
-	let a = await d(t.payload, r, {
+	let a = await u(t.payload, r, {
 		signal: t.signal,
 		closed: i
 	});
@@ -171,10 +172,82 @@ var i = /* @__PURE__ */ e({
 		closed: i,
 		port: r
 	};
-}), D = (e, t, n) => d(t, e, { signal: n?.signal }), O = null, k = !1, A = /* @__PURE__ */ new Set(), j = [], M = /* @__PURE__ */ new Map(), N = !1, P = !1, F = (e) => {
-	let t = M.get(e);
-	t && (M.delete(e), t());
-}, I = (e, t) => {
+}), E = ["allow-scripts", "allow-same-origin"], D = (e) => {
+	let t = e.getAttribute("sandbox");
+	if (t !== null) {
+		let e = new Set(t.toLowerCase().split(/\s+/).filter(Boolean)), n = E.filter((t) => !e.has(t));
+		if (n.length) throw s("invalid", `packages.mount: the iframe's sandbox attribute must include ${n.join(" and ")}, or the package cannot start`);
+	}
+	if (globalThis.crossOriginIsolated && !new Set((e.getAttribute("allow") ?? "").toLowerCase().split(";").map((e) => e.trim().split(/\s+/)[0]).filter(Boolean)).has("cross-origin-isolated")) throw s("invalid", "packages.mount: this page is cross-origin isolated, so the iframe's allow attribute must include 'cross-origin-isolated' to hand that down to the package");
+}, O = 3e4, k = (e, t) => new Promise((n, r) => {
+	let i = (e) => {
+		clearTimeout(o), window.removeEventListener("message", a), e ? r(e) : n();
+	}, a = (n) => {
+		if (n.source !== e.contentWindow || n.origin !== t) return;
+		let r = n.data;
+		if (r?.type === "fkn-packages-ready") return i();
+		r?.type === "fkn-packages-failed" && i(s("unavailable", typeof r.message == "string" && r.message ? r.message : "packages.mount: the package failed to boot"));
+	}, o = setTimeout(() => i(s("timeout", "packages.mount: the package did not register a connection handler")), O);
+	window.addEventListener("message", a);
+}), A = async (e, t) => {
+	let { iframe: n } = t;
+	if (!(n instanceof HTMLIFrameElement)) throw s("invalid", "packages.mount: pass the iframe to load the package into");
+	if (!n.isConnected) throw s("invalid", "packages.mount: the iframe must be in the document before mounting into it");
+	D(n);
+	let r = await (await c()).packages.frame(e);
+	if ("error" in r) throw s(r.error, r.message);
+	n.src = r.url;
+	let i = { done: !1 }, a = () => {}, o = new Promise((e) => {
+		a = e;
+	}), l = () => {
+		if (!i.done) {
+			i.done = !0;
+			try {
+				n.contentWindow?.postMessage({ type: "fkn-packages-close" }, r.origin);
+			} catch {}
+			n.src = "about:blank", a();
+		}
+	};
+	try {
+		await k(n, r.origin);
+	} catch (e) {
+		throw l(), e;
+	}
+	let d = new MessageChannel(), f = n.contentWindow;
+	if (!f) throw l(), s("unavailable", "packages.mount: the frame was detached before it could connect");
+	f.postMessage({
+		type: "fkn-packages-port",
+		from: r.from,
+		protocol: t.protocol,
+		uri: r.uri,
+		name: r.name,
+		version: r.version
+	}, r.origin, [d.port2]);
+	try {
+		f.postMessage({
+			type: "fkn-packages-visibility",
+			visible: !0
+		}, r.origin);
+	} catch {}
+	return t.raw ? {
+		closed: o,
+		port: d.port1,
+		frame: n,
+		unmount: l
+	} : {
+		remote: await u(t.payload, d.port1, {
+			signal: t.signal,
+			closed: o
+		}),
+		closed: o,
+		port: d.port1,
+		frame: n,
+		unmount: l
+	};
+}, j = (e, t, n) => u(t, e, { signal: n?.signal }), M = null, N = !1, P = /* @__PURE__ */ new Set(), F = [], I = /* @__PURE__ */ new Map(), L = !1, R = !1, z = (e) => {
+	let t = I.get(e);
+	t && (I.delete(e), t());
+}, B = (e, t) => {
 	try {
 		e.postMessage({
 			type: "fkn-packages-nack",
@@ -184,27 +257,27 @@ var i = /* @__PURE__ */ e({
 	try {
 		e.close();
 	} catch {}
-}, L = async (e, t) => {
+}, V = async (e, t) => {
 	let { port: n, ...r } = e;
 	e.port.addEventListener("message", (t) => {
-		t.data?.type === "fkn-packages-disconnect" && F(e.port);
+		t.data?.type === "fkn-packages-disconnect" && z(e.port);
 	});
 	let i;
 	try {
 		i = await t.createPayload(r);
 	} catch (t) {
-		throw I(e.port, t instanceof Error ? t.message : "the package failed to produce a connection"), t;
+		throw B(e.port, t instanceof Error ? t.message : "the package failed to produce a connection"), t;
 	}
-	let a = new Promise((t) => M.set(e.port, t)), o = await u(i, e.port);
+	let a = new Promise((t) => I.set(e.port, t)), o = await l(i, e.port);
 	t.handler?.({
 		...r,
 		remote: o,
 		closed: a,
 		port: e.port
 	});
-}, R = () => {
-	N || typeof window > "u" || window.parent === window || (N = !0, window.addEventListener("message", (e) => {
-		if (e.source !== window.parent || e.origin !== a) return;
+}, H = () => {
+	L || typeof window > "u" || window.parent === window || (L = !0, window.addEventListener("message", (e) => {
+		if (e.source !== window.parent) return;
 		let t = e.data;
 		if (t?.type === "fkn-packages-port") {
 			let n = e.ports[0];
@@ -217,38 +290,38 @@ var i = /* @__PURE__ */ e({
 				name: typeof t.name == "string" ? t.name : "",
 				version: typeof t.version == "string" ? t.version : ""
 			};
-			O ? L(r, O).catch((e) => console.warn("packages.onConnect:", e)) : j.push(r);
+			M ? V(r, M).catch((e) => console.warn("packages.onConnect:", e)) : F.push(r);
 		}
-		if (t?.type === "fkn-packages-close") for (let e of [...M.keys()]) F(e);
+		if (t?.type === "fkn-packages-close") for (let e of [...I.keys()]) z(e);
 		if (t?.type === "fkn-packages-visibility") {
-			k = t.visible === !0;
-			for (let e of A) try {
-				e(k);
+			N = t.visible === !0;
+			for (let e of P) try {
+				e(N);
 			} catch {}
 		}
 	}));
-}, z = () => {
-	P || typeof window > "u" || window.parent === window || (P = !0, window.parent.postMessage({ type: "fkn-packages-ready" }, a));
-}, B = (e, t) => {
+}, U = () => {
+	R || typeof window > "u" || window.parent === window || (R = !0, window.parent.postMessage({ type: "fkn-packages-ready" }, "*"));
+}, W = (e, t) => {
 	if (typeof window > "u") return { unsubscribe: () => {} };
-	R();
+	H();
 	let n = {
 		createPayload: e,
 		handler: t
 	};
-	for (O = n, z(); j.length && O === n;) L(j.shift(), n).catch((e) => console.warn("packages.onConnect:", e));
+	for (M = n, U(); F.length && M === n;) V(F.shift(), n).catch((e) => console.warn("packages.onConnect:", e));
 	return { unsubscribe: () => {
-		O === n && (O = null);
+		M === n && (M = null);
 	} };
-}, V = () => k, H = (e) => {
+}, G = () => N, K = (e) => {
 	if (typeof window > "u") return { unsubscribe: () => {} };
-	R(), A.add(e);
+	H(), P.add(e);
 	try {
-		e(k);
+		e(N);
 	} catch {}
 	return { unsubscribe: () => {
-		A.delete(e);
+		P.delete(e);
 	} };
 };
 //#endregion
-export { D as attach, E as connect, T as hide, m as install, V as isVisible, h as list, B as onConnect, H as onVisibilityChange, p as pick, f as search, w as show, i as t, g as uninstall };
+export { j as attach, T as connect, w as hide, p as install, G as isVisible, m as list, A as mount, W as onConnect, K as onVisibilityChange, f as pick, d as search, C as show, i as t, h as uninstall };

package/{proxy-BypE6RbM.d.ts → proxy-CAjDHzfq.d.ts}

@@ -1,4 +1,4 @@
-import { t as Resolvers } from "./api-BYRsWdwB.js";
+import { t as Resolvers } from "./api-VR2xHGZu.js";
 
 //#region src/lib/proxy.d.ts
 type ProxyFetch = Resolvers['cloud']['fetch'];