@statewalker/webrun-http-browser 0.3.2 → 0.3.4

package/dist/relay/index-sw.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Boots the relay ServiceWorker: routes fetches shaped `<origin>/~<key>/…` to
+ * the client that registered `key`, and exposes REGISTER/UNREGISTER/CONNECT
+ * channel calls used by the page-side relay client.
+ */
+export declare function startRelayServiceWorker(self: ServiceWorkerGlobalScope): () => void;
+//# sourceMappingURL=index-sw.d.ts.map

package/dist/relay/index-sw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-sw.d.ts","sourceRoot":"","sources":["../../src/relay/index-sw.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,wBAAwB,GAAG,MAAM,IAAI,CAwElF"}

package/dist/relay/index.d.ts

@@ -0,0 +1,69 @@
+import type { HttpHandler } from "@statewalker/webrun-http-streams";
+import type { MessageTarget } from "../core/message-target.js";
+export * from "./split-service-url.js";
+/**
+ * Returns a MessagePort that transparently bridges messages to/from the
+ * ServiceWorker controlling this page.
+ */
+export declare function newServiceWorkerPort(): MessagePort;
+export interface InitServiceWorkerOptions {
+    swUrl: string;
+    scopeUrl?: string;
+    type?: WorkerType;
+}
+/**
+ * Registers a ServiceWorker and resolves once it's activated and controlling the page.
+ */
+export declare function initServiceWorker({ swUrl, scopeUrl, type, }: InitServiceWorkerOptions): Promise<ServiceWorker>;
+export interface ServiceOptions {
+    key: string;
+    port: MessageTarget;
+}
+/**
+ * Registers `handler` as the server for the given service `key` on the relay.
+ * Returns a cleanup function that unregisters the service.
+ */
+export declare function initHttpService(handler: HttpHandler, { key, port }: ServiceOptions): Promise<() => void>;
+/**
+ * Sends a `Request` to the service registered under `key` on the relay and
+ * resolves with the corresponding `Response`.
+ */
+export declare function callHttpService(request: Request, { key, port }: ServiceOptions): Promise<Response>;
+export interface RelayWindowHandlerOptions {
+    swUrl?: string;
+    scopeUrl?: string;
+}
+/**
+ * Returns a `window.onmessage` handler for use inside the relay iframe:
+ * it accepts a CONNECT message, starts the relay ServiceWorker, and bridges
+ * the parent's MessagePort with the SW.
+ */
+export declare function getRelayWindowMessageHandler({ swUrl, scopeUrl, }?: RelayWindowHandlerOptions): (ev: MessageEvent) => Promise<void>;
+export interface RemoteRelayChannelOptions {
+    baseUrl?: URL;
+    url?: URL;
+    container?: HTMLElement;
+}
+export interface RemoteRelayChannel {
+    baseUrl: URL;
+    port: MessagePort;
+    close(): void;
+}
+/**
+ * Embeds a hidden relay iframe, establishes a MessageChannel with it, and
+ * returns the port to be used with `initHttpService` / `callHttpService`.
+ */
+export declare function newRemoteRelayChannel({ baseUrl, url, container, }?: RemoteRelayChannelOptions): Promise<RemoteRelayChannel>;
+export interface InitializeConnectionOptions {
+    key: string;
+    communicationPort: MessageTarget;
+    [key: string]: unknown;
+}
+export declare function initializeConnection({ key, communicationPort, ...options }: InitializeConnectionOptions): Promise<MessagePort | null>;
+export interface RegisterConnectionsHandlerOptions {
+    key: string;
+    handler: (event: MessageEvent, data: unknown, port: MessagePort) => boolean | Promise<boolean>;
+    communicationPort: MessageTarget;
+}
+export declare function registerConnectionsHandler({ key, handler, communicationPort, }: RegisterConnectionsHandlerOptions): Promise<() => void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/relay/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI/D,cAAc,wBAAwB,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,WAAW,CASlD;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,EACtC,KAAK,EACL,QAAQ,EACR,IAAI,GACL,EAAE,wBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC,CAKnD;AAiCD,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,aAAa,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,WAAW,EACpB,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,cAAc,GAC5B,OAAO,CAAC,MAAM,IAAI,CAAC,CASrB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,EAChB,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,cAAc,GAC5B,OAAO,CAAC,QAAQ,CAAC,CAInB;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,EAC3C,KAAsD,EACtD,QAA+C,GAChD,GAAE,yBAA8B,GAAG,CAAC,EAAE,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAoBtE;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,SAAS,CAAC,EAAE,WAAW,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,GAAG,CAAC;IACb,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,OAAsD,EACtD,GAAoC,EACpC,SAAyB,GAC1B,GAAE,yBAA8B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+C9D;AAED,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB,EAAE,aAAa,CAAC;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAsB,oBAAoB,CAAC,EACzC,GAAG,EACH,iBAAiB,EACjB,GAAG,OAAO,EACX,EAAE,2BAA2B,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAc3D;AAED,MAAM,WAAW,iCAAiC;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/F,iBAAiB,EAAE,aAAa,CAAC;CAClC;AAED,wBAAsB,0BAA0B,CAAC,EAC/C,GAAG,EACH,OAAO,EACP,iBAAiB,GAClB,EAAE,iCAAiC,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAUzD"}

package/dist/relay/split-service-url.d.ts

@@ -0,0 +1,13 @@
+export interface SplitServiceUrl {
+    url: string;
+    key: string;
+    baseUrl: string;
+    path: string;
+    [extra: string]: unknown;
+}
+/**
+ * Splits a URL of the form `<base>/<separator><key>/<path>` into parts.
+ * Example: `https://host/~FS/a/b` → `{ baseUrl: "https://host/~FS/", key: "FS", path: "a/b" }`.
+ */
+export declare function splitServiceUrl(url: URL | string, separator?: string): SplitServiceUrl;
+//# sourceMappingURL=split-service-url.d.ts.map

package/dist/relay/split-service-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-service-url.d.ts","sourceRoot":"","sources":["../../src/relay/split-service-url.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,EAAE,SAAS,SAAM,GAAG,eAAe,CAiBnF"}

package/dist/relay-sw.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=relay-sw.d.ts.map

package/dist/relay-sw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-sw.d.ts","sourceRoot":"","sources":["../src/relay-sw.ts"],"names":[],"mappings":""}