@fkn/lib 0.9.24 → 0.9.25

package/contract-D6ksmIm6.d.ts

@@ -0,0 +1,394 @@
+import { o as TcpSocketOption, v as UdpSocketOption } from "./wire-Gbo-D74t.js";
+//#region src/contract.d.ts
+/** The signed-in account, or null when nobody is. */
+type Account = {
+  name: string;
+  image: string | null;
+  premium: boolean;
+  premiumUntil: string | null;
+};
+/** Metered proxy usage for the account behind the broker. */
+type Quota = {
+  overQuota: boolean;
+  remaining: number;
+  usedBytes: number;
+  limitBytes: number;
+  premium: boolean;
+  bytesPerSecond: number;
+};
+/**
+ * Three answers where `available()` has two. `disconnected` is an ANSWER and `unknown` is nobody
+ * having been asked; the library's local-first queue drops its cloud obligation only on the first
+ * and keeps the write queued on the second.
+ */
+type ConnectAvailability = 'connected' | 'disconnected' | 'unknown';
+type StorageEntry = {
+  path: string;
+  size: number;
+  contentType: string | null;
+  updatedAt: string;
+  encryption: string | null;
+};
+type StorageQuota = {
+  usedBytes: number;
+  limitBytes: number;
+  remaining: number;
+  objects: number;
+  maxObjects: number;
+};
+type WriteData = ArrayBuffer | Uint8Array | string;
+/** Encryption state of the account's cloud storage. */
+type EncryptionState = {
+  unlocked: boolean;
+  enrolled: boolean;
+  keyEpoch: number | null;
+};
+type AdoptState = {
+  files: number;
+  bytes: number;
+};
+type AdoptRequest = {
+  files: number;
+  bytes: number;
+};
+type ConflictSide = {
+  size: number;
+  updatedAt: string | null;
+};
+type ConflictRequest = {
+  path: string;
+  local: ConflictSide;
+  cloud: ConflictSide;
+};
+type ConflictChoice = 'local' | 'cloud' | null;
+type AddressLookupResult = {
+  address: string;
+  family: 0 | 4 | 6;
+};
+type FrameFetchScope = 'frame.fetchRead' | 'frame.fetchWrite';
+type FrameConsentRequest = {
+  scope: FrameFetchScope;
+  hosts: string[];
+};
+type DisplayCause =
+/** the frame is not being painted at all, so an ancestor is display:none, visibility:hidden or equivalent */
+'not-rendered' |
+/** laid out but outside the visible region, so clipped away or positioned off screen */
+'clipped' |
+/**
+ * Rendered and in view, but the browser says it would not be seen.
+ *
+ * Deliberately not narrower than that. From inside the frame a cover, an ancestor `opacity`, an
+ * ancestor `visibility: hidden` and a `filter` are the SAME observation: `isIntersecting` true with
+ * `isVisible` false. Naming only one of them sends the reader hunting for something that is not
+ * there, so the message lists all of them.
+ */
+'not-shown';
+/** `full` means this engine reported a boolean `isVisible`; `liveness` means we only know it paints */
+type DisplayLevel = 'full' | 'liveness';
+type HiddenSurface = {
+  kind: string;
+  cause: DisplayCause;
+  level: DisplayLevel;
+};
+type PackageQuery = {
+  /** package kind, e.g. 'plugin' - becomes the keyword `fkn-type:<type>` */
+  type: string;
+  /** host app scope, e.g. 'stub' - becomes the keyword `fkn-<type>--<id>` */
+  id?: string;
+  /** package source; npm is the only origin implemented */
+  origin?: 'npm';
+  /** free text mixed into the registry query */
+  text?: string;
+  /** result count, clamped to 1..100 */
+  size?: number;
+};
+type PackageResult = {
+  /** normalized version-free uri, e.g. 'npm:@banou/stub-plugin-foo' */
+  uri: string;
+  origin: 'npm';
+  name: string;
+  /** latest version per the search index - display only, install re-resolves from the packument */
+  version: string;
+  description: string;
+  keywords: string[];
+  publisher: string | null;
+  downloadsMonthly: number | null;
+  links: {
+    npm?: string;
+    homepage?: string;
+    repository?: string;
+  };
+  /** installed by the calling app */
+  installed: boolean;
+};
+type InstalledPackage = {
+  uri: string;
+  name: string;
+  /** null when the handler addresses code directly and has no version to pin, e.g. a dev server */
+  version: string | null;
+  installedAt: number;
+};
+type PickOptions = {
+  /** untrusted, rendered as text in the picker header */
+  title?: string;
+  multiple?: boolean;
+};
+type InstallOptions = {
+  /** exact version to pin; defaults to the packument's latest dist-tag */
+  version?: string;
+  /** skip the confirm prompt and report the install with a notice instead; the record stays scoped to the calling app */
+  noConfirm?: boolean;
+};
+type ConnectOptions = {
+  /** opaque contract tag delivered to the package's onConnect, e.g. 'stub-source@1' */
+  protocol?: string;
+};
+/** viewport coordinates, the space both the app and the broker frame measure in */
+type SurfaceRect = {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+};
+/** corner radii in css order: top-left, top-right, bottom-right, bottom-left */
+type Radii = [number, number, number, number];
+type Placement = {
+  /** where the package frame sits, so its own layout gets the full box */
+  rect: SurfaceRect;
+  /** the part of `rect` still visible after the placeholder's scroll ancestors clip it */
+  clip?: SurfaceRect;
+  /** the placeholder's corner radii, so the frame follows a rounded container */
+  radius?: Radii;
+};
+type PackagesErrorCode = 'invalid' | 'not-installed' | 'unaddressable' | 'timeout' | 'unavailable' | 'denied';
+type PackagesFail = {
+  error: PackagesErrorCode;
+  message: string;
+};
+/** Everything an app needs to mount a package's tenant in its OWN document. */
+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;
+};
+type IpFamily = 'IPv4' | 'IPv6';
+/** Viewport rect plus optional corner radii, as the overlay host reports them. */
+type OverlayRect = {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+  radius?: [number, number, number, number];
+};
+/** What the host page pushes to the broker frame so its UI stays clickable through app chrome. */
+type OverlayState = {
+  modal: boolean;
+  rects: OverlayRect[];
+  hidden: HiddenSurface[];
+  view: {
+    width: number;
+    height: number;
+  };
+  inset: {
+    top: number;
+  };
+};
+type SetOverlayHost = (push: (state: OverlayState) => unknown, options?: {
+  exactClips?: boolean;
+}) => void;
+type DnsLookup = <T extends boolean = false>(hostname: string, options?: {
+  all?: T;
+  family?: 0 | 4 | 6;
+}) => Promise<T extends true ? AddressLookupResult[] : AddressLookupResult | undefined>;
+type ProxyFetchInput = string | URL | Request;
+type ProxyFetchInit = (RequestInit & {
+  render?: boolean;
+}) | undefined;
+type ProxyFetch = (input: ProxyFetchInput, init: ProxyFetchInit) => Promise<Response>;
+type TcpSocketOptions = {
+  remoteAddress: string;
+  remotePort: number;
+};
+type TcpSocketResult = {
+  localAddress: string;
+  localFamily: IpFamily;
+  localPort: number;
+  remoteAddress: string;
+  remoteFamily: IpFamily;
+  remotePort: number;
+  dataReadableStream: ReadableStream<Uint8Array>;
+  dataWritableStream: WritableStream<Uint8Array>;
+  end: () => Promise<void>;
+  destroy: () => Promise<void>;
+  destroySoon: () => Promise<void>;
+  resetAndDestroy: () => Promise<void>;
+  setOption: (option: TcpSocketOption) => Promise<void>;
+};
+type TcpSocketListenerOptions = {
+  localAddress: string;
+  localPort: number;
+  onConnection: (connection: TcpSocketResult) => void | Promise<void>;
+  onClose?: (error?: Error) => void | Promise<void>;
+};
+type TcpSocketListenerResult = {
+  localAddress: string;
+  localFamily: IpFamily;
+  localPort: number;
+  close: () => Promise<void>;
+};
+type UdpSocketOptions = {
+  type: 'udp4' | 'udp6';
+  port: number;
+  address: string;
+  dataPort?: boolean;
+};
+type UdpDatagram = {
+  data: ArrayBuffer;
+  size: number;
+  family: IpFamily;
+  address: string;
+  port: number;
+};
+type UdpSocketResult = {
+  socketId: number;
+  dataPort: MessagePort | undefined;
+  dataPortAcks: true | undefined;
+  closed: Promise<{
+    reason: string;
+  }>;
+  localAddress: string;
+  localFamily: IpFamily;
+  localPort: number;
+  dataReadableStream: ReadableStream<UdpDatagram>;
+  connect: (options: {
+    remoteAddress: string;
+    remotePort: number;
+  }) => Promise<{
+    local: boolean;
+    address: string;
+    family: IpFamily;
+    port: number;
+  }>;
+  disconnect: () => Promise<void>;
+  send: (options: {
+    message: ArrayBuffer;
+    address?: string;
+    port?: number;
+  }) => Promise<void>;
+  close: () => Promise<void>;
+  setOption: (option: UdpSocketOption) => Promise<void>;
+};
+/**
+ * Everything the broker exposes over osra.
+ *
+ * The flat members at the bottom duplicate members of `cloud` and `overlay`. They predate the
+ * namespaced form and are kept because a published consumer may still be calling them: they are
+ * contract, not dead code.
+ */
+type Resolvers = {
+  cloud: {
+    fetch: ProxyFetch;
+    quota: () => Promise<Quota>;
+    dns: {
+      lookup: DnsLookup;
+    };
+    fs: {
+      available: () => Promise<boolean>;
+      availability: () => Promise<ConnectAvailability>;
+      list: () => Promise<StorageEntry[]>;
+      quota: () => Promise<StorageQuota>;
+      readFile: (path: string) => Promise<Uint8Array>;
+      writeFile: (path: string, data: WriteData, contentType: string | null) => Promise<void>;
+      remove: (path: string) => Promise<void>;
+      encryption: () => Promise<EncryptionState>;
+      unlock: () => Promise<boolean>;
+      promptAdopt: (request: AdoptRequest) => Promise<boolean>;
+      promptConflict: (request: ConflictRequest) => Promise<ConflictChoice>;
+      setAdoptSource: (next: AdoptState | null, run: (() => Promise<void>) | null) => void;
+    };
+    webvpn: {
+      tcpSocket: (options: TcpSocketOptions) => Promise<TcpSocketResult>;
+      tcpSocketListener: (options: TcpSocketListenerOptions) => Promise<TcpSocketListenerResult>;
+      udpSocket: (options: UdpSocketOptions) => Promise<UdpSocketResult>;
+    };
+  };
+  overlay: {
+    setHost: SetOverlayHost;
+  };
+  installPrompt: {
+    show: (reason?: string) => Promise<void>;
+    hide: () => void;
+  };
+  frameConsent: {
+    ensure: (request: FrameConsentRequest) => Promise<boolean>;
+  };
+  connect: {
+    prompt: (consumerOrigin: string) => Promise<boolean>;
+  };
+  relay: {
+    prompt: () => Promise<string>;
+  };
+  packages: {
+    search: (query: PackageQuery) => Promise<PackagesFail | {
+      results: PackageResult[];
+    }>;
+    pick: (query: PackageQuery, options?: PickOptions) => Promise<PackagesFail | {
+      results: PackageResult[];
+      failed: string[];
+    } | {
+      declined: true;
+    }>;
+    install: (uri: string, options?: InstallOptions) => Promise<PackagesFail | {
+      installed: InstalledPackage;
+    } | {
+      declined: true;
+    }>;
+    frame: (uri: string) => Promise<PackagesFail | MountDescriptor>;
+    list: () => Promise<{
+      results: InstalledPackage[];
+    }>;
+    uninstall: (uri: string) => Promise<PackagesFail | {
+      ok: true;
+    }>;
+    connect: (uri: string, options?: ConnectOptions) => Promise<PackagesFail | {
+      port: MessagePort;
+      closed: Promise<void>;
+    }>;
+    show: (uri: string, placement: Placement) => Promise<PackagesFail | {
+      ok: true;
+    }>;
+    hide: (uri: string) => Promise<PackagesFail | {
+      ok: true;
+    }>;
+  };
+  account: {
+    info: () => Promise<Account | null>;
+    login: (consumerOrigin: string) => Promise<boolean>;
+    logout: () => void;
+    onChange: (listener: () => void) => (() => void);
+  };
+  shell: {
+    updateReady: () => Promise<boolean>;
+    onUpdate: (callback: () => void) => () => void;
+    onUpdateTaken: (callback: () => void) => () => void;
+    applyUpdate: () => Promise<boolean>;
+  };
+  proxyFetch: ProxyFetch;
+  webVpnTcpSocket: (options: TcpSocketOptions) => Promise<TcpSocketResult>;
+  webVpnTcpSocketListener: (options: TcpSocketListenerOptions) => Promise<TcpSocketListenerResult>;
+  webVpnUdpSocket: (options: UdpSocketOptions) => Promise<UdpSocketResult>;
+  dnsLookup: DnsLookup;
+  setOverlayHost: SetOverlayHost;
+  showInstallPrompt: (reason?: string) => Promise<void>;
+  hideInstallPrompt: () => void;
+};
+//#endregion
+export { ProxyFetchInit as A, TcpSocketListenerResult as B, PackageQuery as C, PickOptions as D, PackagesFail as E, SetOverlayHost as F, UdpSocketResult as G, TcpSocketResult as H, StorageEntry as I, WriteData as K, StorageQuota as L, Quota as M, Radii as N, Placement as O, Resolvers as P, SurfaceRect as R, OverlayState as S, PackagesErrorCode as T, UdpDatagram as U, TcpSocketOptions as V, UdpSocketOptions as W, InstallOptions as _, ConflictChoice as a, MountDescriptor as b, ConnectAvailability as c, DisplayLevel as d, DnsLookup as f, HiddenSurface as g, FrameFetchScope as h, AdoptState as i, ProxyFetchInput as j, ProxyFetch as k, ConnectOptions as l, FrameConsentRequest as m, AddressLookupResult as n, ConflictRequest as o, EncryptionState as p, AdoptRequest as r, ConflictSide as s, Account as t, DisplayCause as u, InstalledPackage as v, PackageResult as w, OverlayRect as x, IpFamily as y, TcpSocketListenerOptions as z };

package/contract.d.ts

@@ -0,0 +1,3 @@
+import { o as TcpSocketOption, v as UdpSocketOption } from "./wire-Gbo-D74t.js";
+import { A as ProxyFetchInit, B as TcpSocketListenerResult, C as PackageQuery, D as PickOptions, E as PackagesFail, F as SetOverlayHost, G as UdpSocketResult, H as TcpSocketResult, I as StorageEntry, K as WriteData, L as StorageQuota, M as Quota, N as Radii, O as Placement, P as Resolvers, R as SurfaceRect, S as OverlayState, T as PackagesErrorCode, U as UdpDatagram, V as TcpSocketOptions, W as UdpSocketOptions, _ as InstallOptions, a as ConflictChoice, b as MountDescriptor, c as ConnectAvailability, d as DisplayLevel, f as DnsLookup, g as HiddenSurface, h as FrameFetchScope, i as AdoptState, j as ProxyFetchInput, k as ProxyFetch, l as ConnectOptions, m as FrameConsentRequest, n as AddressLookupResult, o as ConflictRequest, p as EncryptionState, r as AdoptRequest, s as ConflictSide, t as Account, u as DisplayCause, v as InstalledPackage, w as PackageResult, x as OverlayRect, y as IpFamily, z as TcpSocketListenerOptions } from "./contract-D6ksmIm6.js";
+export { Account, AddressLookupResult, AdoptRequest, AdoptState, ConflictChoice, ConflictRequest, ConflictSide, ConnectAvailability, ConnectOptions, DisplayCause, DisplayLevel, DnsLookup, EncryptionState, FrameConsentRequest, FrameFetchScope, HiddenSurface, InstallOptions, InstalledPackage, IpFamily, MountDescriptor, OverlayRect, OverlayState, PackageQuery, PackageResult, PackagesErrorCode, PackagesFail, PickOptions, Placement, ProxyFetch, ProxyFetchInit, ProxyFetchInput, Quota, Radii, Resolvers, SetOverlayHost, StorageEntry, StorageQuota, SurfaceRect, TcpSocketListenerOptions, TcpSocketListenerResult, type TcpSocketOption, TcpSocketOptions, TcpSocketResult, UdpDatagram, type UdpSocketOption, UdpSocketOptions, UdpSocketResult, WriteData };

package/desktop.js

@@ -1,5 +1,5 @@
 import { t as e } from "./rolldown-runtime-Dy4uBu1J.js";
-//#region src/lib/desktop.ts
+//#region src/desktop.ts
 var t = /* @__PURE__ */ e({
 	available: () => n,
 	dgram: () => s,

package/dgram.cjs

@@ -1 +1 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("./dgram-BLN-mfgq.cjs");exports.Socket=e.t,exports.createSocket=e.n,exports.default=e.r;
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("./rolldown-runtime-BIInC43l.cjs"),t=require("./api-BCJO3EWi.cjs"),n=require("./busy-Dv8wzE5M.cjs"),r=require("./utils-BvgGdrgN.cjs");require("./wire.cjs");let i=require("buffer"),a=require("events"),o=require("ip-address");var s=e.t({Socket:()=>c,createSocket:()=>m,default:()=>h}),c=class extends a.EventEmitter{_type;_localAddress;_remoteAddress;_connectedLocally;_connectGeneration=0;_destroyed=!1;_busyRelease;_webVPNUdpSocketPromise;_dataPort;_socketId;_sendQueue=[];_sendQueueBytes=0;_sendFlushScheduled=!1;_peerTailCache=new Map;constructor(e){if(super(e),!e)throw Error(`Missing options`);this._type=e.type,e.connection&&this.__webvpn_udp_socket_init__(e.connection)}_lastRecvBufferSize=0;_lastSendBufferSize=0;_lastTtl=64;_lastMulticastTtl=1;_lastMulticastLoopback=!0;_setUdpOption(e){if(!this._webVPNUdpSocketPromise){this.emit(`error`,Error(`Cannot set socket option before bind`));return}this._webVPNUdpSocketPromise.then(async t=>{if(t)try{await t.setOption(e)}catch(e){this.emit(`error`,e)}})}_dataPortAcks=!1;_dataPortConsumedBytes=0;_dataPortAckedBytes=0;_ackDataPortBatch(e){if(!this._dataPortAcks||!this._dataPort||(this._dataPortConsumedBytes+=e,this._dataPortAckedBytes!==0&&this._dataPortConsumedBytes-this._dataPortAckedBytes<524288))return;this._dataPortAckedBytes=this._dataPortConsumedBytes;let t={type:r.n,consumedBytes:this._dataPortConsumedBytes};this._dataPort.postMessage(t)}_onTransportClosed(e){this._destroyed||(this._destroyed=!0,this._busyRelease?.(),this._dataPort?.close(),this._dataPort=void 0,this.listenerCount(`error`)>0&&this.emit(`error`,Error(e||`WebVPN session closed`)),this.emit(`close`))}_onDataPortBatch(e){let t=new DataView(e),n=!1,r,a=0;for(;a+4<=e.byteLength;){let o=t.getUint32(a);a+=4;let s=a+o;if(s>e.byteLength)break;let c=a+4,l=t.getUint8(c);c+=1;let u,d,p;if(l===2){if(!this._remoteAddress){a=s;continue}u=this._remoteAddress.address,d=this._remoteAddress.family,p=this._remoteAddress.port}else{let n=new Uint8Array(e,c,l===0?4:16);l===0?(d=`IPv4`,u=`${n[0]}.${n[1]}.${n[2]}.${n[3]}`):(d=`IPv6`,u=f(n)),c+=n.byteLength,p=t.getUint16(c),c+=2}let m=t.getUint32(c);c+=4;try{this.emit(`message`,i.Buffer.from(e.slice(c,c+m)),{address:u,family:d,port:p,size:m})}catch(e){n||(n=!0,r=e)}a=s}if(n)throw r}_peerTail(e,t){if(e===void 0||t===void 0)return l;let n=`${e}|${t}`,r=this._peerTailCache.get(n);if(r)return r;let i=o.Address4.isValid(e)?d(e):p(e),a=new Uint8Array(1+i.byteLength+2);return a[0]=i.byteLength===4?0:1,a.set(i,1),new DataView(a.buffer).setUint16(1+i.byteLength,t),this._peerTailCache.size>=4096&&this._peerTailCache.clear(),this._peerTailCache.set(n,a),a}_portSend(e,t,n){let r=this._peerTail(t,n),i=new Uint8Array(8+r.byteLength+4+e.byteLength),a=new DataView(i.buffer);a.setUint32(0,i.byteLength-4),a.setUint32(4,this._socketId),i.set(r,8),a.setUint32(8+r.byteLength,e.byteLength),i.set(e,12+r.byteLength),this._sendQueue.push(i),this._sendQueueBytes+=i.byteLength,!this._sendFlushScheduled&&(this._sendFlushScheduled=!0,queueMicrotask(()=>{this._sendFlushScheduled=!1;let e=this._sendQueue,t=this._sendQueueBytes;if(this._sendQueue=[],this._sendQueueBytes=0,!e.length||!this._dataPort)return;let n=new Uint8Array(t),r=0;for(let t of e)n.set(t,r),r+=t.byteLength;this._dataPort.postMessage(n.buffer,[n.buffer])}))}addMembership(e,t){if(o.Address4.isValid(e)){let n=d(e),r=t&&o.Address4.isValid(t)?d(t):new Uint8Array([0,0,0,0]);this._setUdpOption({type:5,group:n,interface:r})}else if(o.Address6.isValid(e)){let t=p(e);this._setUdpOption({type:7,group:t,ifIndex:0})}else this.emit(`error`,Error(`Invalid multicast address: ${e}`))}address(){if(!this._localAddress)throw Error(`EBADF`);return this._localAddress}bind(...e){let n=r.o(...e),i=this._type===`udp6`?`::`:`0.0.0.0`,a=this.__webvpn_udp_socket_init__(t.o(`a udp socket`).then(e=>e.cloud.webvpn.udpSocket({type:this._type,address:n.address??i,port:n.port,dataPort:!0})));return n.callback&&a.then(e=>{e&&n.callback.call(this)}),this}__webvpn_udp_socket_init__(e,t){return t&&(this._localAddress={address:t.localAddress,family:t.localFamily,port:t.localPort}),this._busyRelease??=n.t(`udp socket`),this._webVPNUdpSocketPromise=e.then(e=>{if(e.dataPort)this._socketId=e.socketId,this._dataPort=e.dataPort,this._dataPortAcks=e.dataPortAcks===!0,this._dataPort.onmessage=e=>{try{this._onDataPortBatch(e.data)}finally{this._ackDataPortBatch(e.data.byteLength)}};else{let t=e.dataReadableStream.getReader();(async()=>{for(;;){let{value:e,done:n}=await t.read();if(n)return;this.emit(`message`,i.Buffer.from(e.data),{address:e.address,family:e.family,port:e.port,size:e.size})}})().catch(e=>this._onTransportClosed(e instanceof Error?e.message:void 0))}return e.closed?.then(e=>this._onTransportClosed(e?.reason)).catch(()=>{}),this._localAddress={address:e.localAddress,family:e.localFamily,port:e.localPort},e}).catch(e=>{this.emit(`error`,e)}),this._webVPNUdpSocketPromise.then(e=>{if(!e){this._busyRelease?.();return}this.emit(`listening`)}),this._webVPNUdpSocketPromise}close(e){if(!this._webVPNUdpSocketPromise)throw Error(`Socket not bound`);return this._webVPNUdpSocketPromise.then(async t=>{if(!t)throw Error(`Socket not bound`);let n=this._destroyed;this._destroyed=!0,this._busyRelease?.(),this._dataPort?.close(),this._dataPort=void 0;try{await t.close()}finally{try{e&&e()}finally{n||this.emit(`close`)}}}).catch(()=>{}),this}connect(...e){if(!this._webVPNUdpSocketPromise)throw Error(`Socket not bound`);this._webVPNUdpSocketPromise.then(async t=>{if(!t)throw Error(`Socket not bound`);let n=e[0],r=this._type===`udp6`?`::1`:`127.0.0.1`,i=typeof e[1]==`string`?e[1]:r,a=typeof e.at(-1)==`function`?e.at(-1):void 0,o=await t.connect({remotePort:n,remoteAddress:i});this._connectedLocally=o?.local===!0,this._remoteAddress=o?.address?{address:o.address,family:o.family,port:o.port}:{address:i,family:this._type===`udp6`?`IPv6`:`IPv4`,port:n},this._connectGeneration+=1,a&&a()}).catch(e=>{this.emit(`error`,e)})}disconnect(){if(!this._webVPNUdpSocketPromise)throw Error(`Socket not bound`);if(!this._remoteAddress)throw Error(`ERR_SOCKET_DGRAM_NOT_CONNECTED`);let e=this._remoteAddress,t=this._connectedLocally,n=this._connectGeneration;this._remoteAddress=void 0,this._connectedLocally=void 0,this._webVPNUdpSocketPromise.then(e=>e?.disconnect?.()).catch(r=>{this._connectGeneration===n&&(this._remoteAddress=e,this._connectedLocally=t),this.emit(`error`,r)})}dropMembership(e,t){if(o.Address4.isValid(e)){let n=d(e),r=t&&o.Address4.isValid(t)?d(t):new Uint8Array([0,0,0,0]);this._setUdpOption({type:6,group:n,interface:r})}else if(o.Address6.isValid(e)){let t=p(e);this._setUdpOption({type:8,group:t,ifIndex:0})}else this.emit(`error`,Error(`Invalid multicast address: ${e}`))}getRecvBufferSize(){return this._lastRecvBufferSize}getSendBufferSize(){return this._lastSendBufferSize}getSendQueueSize(){return 0}getSendQueueCount(){return 0}ref(){return this}remoteAddress(){if(!this._remoteAddress)throw Error(`ERR_SOCKET_DGRAM_NOT_CONNECTED`);return{address:this._remoteAddress.address,family:this._remoteAddress.family,port:this._remoteAddress.port}}send(...e){this._webVPNUdpSocketPromise||this.bind();let t=r.s(...e),n=u(t.message),i=n;if(t.hasRange){let{offset:e,length:r}=t;if(!Number.isInteger(e)||e<0||e>n.byteLength)throw Object.assign(RangeError(`"offset" is outside of buffer bounds`),{code:`ERR_BUFFER_OUT_OF_BOUNDS`});if(!Number.isInteger(r)||r<0||r>n.byteLength-e)throw Object.assign(RangeError(`"length" is outside of buffer bounds`),{code:`ERR_BUFFER_OUT_OF_BOUNDS`});i=n.subarray(e,e+r)}let a=this._type===`udp6`?`::1`:`127.0.0.1`;if(!this._webVPNUdpSocketPromise)throw Error(`Socket not bound`);this._webVPNUdpSocketPromise.then(e=>{if(!e)throw Error(`Socket not bound`);let n=t.callback,r=t.address??a,s=this._remoteAddress!==void 0&&t.address===void 0;if(this._dataPort&&(s||o.Address4.isValid(r)||o.Address6.isValid(r))){this._portSend(i,s?void 0:r,s?void 0:t.port),n?.call(this,null,i.byteLength);return}e.send({port:t.port,address:r,message:i.byteOffset===0&&i.byteLength===i.buffer.byteLength?i.buffer:i.buffer.slice(i.byteOffset,i.byteOffset+i.byteLength)}).then(()=>n?.call(this,null,i.byteLength),e=>n?n.call(this,e,0):this.emit(`error`,e))})}setBroadcast(e){this._setUdpOption({type:0,value:e})}setMulticastInterface(e){}setMulticastLoopback(e){return this._setUdpOption({type:3,value:e}),this._setUdpOption({type:4,value:e}),this._lastMulticastLoopback=e,e}setMulticastTTL(e){return this._setUdpOption({type:2,value:e}),this._lastMulticastTtl=e,e}setRecvBufferSize(e){this._setUdpOption({type:10,value:e}),this._lastRecvBufferSize=e}setSendBufferSize(e){this._setUdpOption({type:9,value:e}),this._lastSendBufferSize=e}setTTL(e){return this._setUdpOption({type:1,value:e}),this._lastTtl=e,e}unref(){return this}addSourceSpecificMembership(e,t,n){}dropSourceSpecificMembership(e,t,n){}async[Symbol.asyncDispose](){await new Promise(e=>{this.close(e)})}},l=new Uint8Array([2]),u=e=>{if(typeof e==`string`)return r.l.encode(e);if(e instanceof Uint8Array)return e;if(ArrayBuffer.isView(e))return new Uint8Array(e.buffer,e.byteOffset,e.byteLength);if(Array.isArray(e)){let t=e.map(u),n=new Uint8Array(t.reduce((e,t)=>e+t.byteLength,0)),r=0;for(let e of t)n.set(e,r),r+=e.byteLength;return n}return new Uint8Array(e)},d=e=>{let t=e.split(`.`).map(e=>parseInt(e,10));if(t.length!==4||t.some(e=>Number.isNaN(e)||e<0||e>255))throw Error(`Invalid IPv4 address: ${e}`);return new Uint8Array(t)},f=e=>{let t=[];for(let n=0;n<16;n+=2)t.push(e[n]<<8|e[n+1]);let n=-1,r=1;for(let e=0;e<8;){if(t[e]!==0){e++;continue}let i=e;for(;i<8&&t[i]===0;)i++;i-e>r&&(n=e,r=i-e),e=i}return n===-1?t.map(e=>e.toString(16)).join(`:`):`${t.slice(0,n).map(e=>e.toString(16)).join(`:`)}::${t.slice(n+r).map(e=>e.toString(16)).join(`:`)}`},p=e=>{let t=new o.Address6(e).getBitsBase16(0,128).match(/.{2}/g);if(!t||t.length!==16)throw Error(`Invalid IPv6 address: ${e}`);return new Uint8Array(t.map(e=>parseInt(e,16)))},m=(e,t)=>{let n=new c(typeof e==`string`?{type:e}:e);return t&&n.on(`message`,t),n},h={Socket:c,createSocket:m};exports.Socket=c,exports.createSocket=m,exports.default=h,Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return s}});

package/dgram.d.ts

@@ -1,10 +1,10 @@
-import { n as UdpSocketOption, t as Resolvers } from "./api-BGYSJVvR.js";
+import { v as UdpSocketOption } from "./wire-Gbo-D74t.js";
+import { G as UdpSocketResult, P as Resolvers } from "./contract-D6ksmIm6.js";
+import "./api-CesI0aMl.js";
 import { Buffer } from "buffer";
 import { AddressInfo } from "net";
 import { EventEmitter } from "events";
 import { BindOptions, RemoteInfo, Socket as Socket$2, SocketOptions, SocketType } from "dgram";
-
-//#region src/lib/webvpn/dgram.d.ts
 declare namespace dgram_d_exports {
   export { Socket, createSocket, _default as default };
 }
@@ -70,52 +70,11 @@ declare class Socket extends EventEmitter implements Socket$2 {
    * address in before it reports a socket as bound.
    *
    * Splitting this out of `bind()` is also what gives a test a seam. Everything a refused bind does
-   * lives past `apiPromise`, so without this the only way to reach it is to mock the resolver, and
+   * lives past `apiWithin`, so without this the only way to reach it is to mock the resolver, and
    * the guard on that path stayed untested through the whole period the relay could not refuse a
    * bind at all.
    */
-  __webvpn_udp_socket_init__(connection: ReturnType<WebVpnUdpSocket>, endpoints?: Awaited<ReturnType<WebVpnUdpSocket>>): Promise<{
-    socketId: number;
-    dataPort: MessagePort | undefined;
-    dataPortAcks: true | undefined;
-    closed: Promise<{
-      reason: string;
-    }>;
-    localAddress: string;
-    localFamily: "IPv4" | "IPv6";
-    localPort: number;
-    dataReadableStream: ReadableStream<{
-      data: ArrayBuffer;
-      size: number;
-      family: 'IPv4' | 'IPv6';
-      address: string;
-      port: number;
-    }>;
-    connect: ({
-      remoteAddress: _remoteAddress,
-      remotePort
-    }: {
-      remoteAddress: string;
-      remotePort: number;
-    }) => Promise<{
-      local: boolean;
-      address: string;
-      family: "IPv4" | "IPv6";
-      port: number;
-    }>;
-    disconnect: () => Promise<void>;
-    send: ({
-      message,
-      address: _remoteAddress,
-      port: remotePort
-    }: {
-      message: ArrayBuffer;
-      address?: string;
-      port?: number;
-    }) => Promise<void>;
-    close: () => Promise<void>;
-    setOption: (option: UdpSocketOption) => Promise<void>;
-  } | undefined>;
+  __webvpn_udp_socket_init__(connection: ReturnType<WebVpnUdpSocket>, endpoints?: Awaited<ReturnType<WebVpnUdpSocket>>): Promise<UdpSocketResult | undefined>;
   close(callback?: (() => void) | undefined): this;
   connect(port: number, address?: string, callback?: () => void): void;
   connect(port: number, callback: () => void): void;
@@ -156,7 +115,7 @@ declare class Socket extends EventEmitter implements Socket$2 {
 declare const createSocket: (options: SocketType | SocketOptions, callback?: (msg: Buffer, rinfo: RemoteInfo) => void) => Socket;
 declare const _default: {
   Socket: typeof Socket;
-  createSocket: (options: SocketType | SocketOptions, callback?: (msg: Buffer, rinfo: RemoteInfo) => void) => Socket;
+  createSocket: typeof createSocket;
 };
 //#endregion
 export { Socket, createSocket, _default as default, dgram_d_exports as t };