@appport/sdk 1.1.19 → 1.1.20

package/vendor/@appport/client/dist/client.js

@@ -0,0 +1,214 @@
+import { AppPortError, createRequest, createStreamRequest, isValidName, newRequestId, newTraceId } from "../../protocol/dist/index.js";
+import { contractFromManifest } from "./contract.js";
+/**
+ * The transport-independent application client.
+ *
+ * Application code calls capabilities. It never builds an envelope, never sees
+ * the transport, and never branches on the runtime (§2, §33).
+ */
+export class AppPortClient {
+    transport;
+    #versions;
+    #streams;
+    #defaultTimeoutMs;
+    #metadata;
+    #createTraceId;
+    #manifest;
+    #connected = false;
+    constructor(options) {
+        this.transport = options.transport;
+        this.#versions = new Map(Object.entries(options.versions ?? {}));
+        this.#streams = new Set(options.streamCapabilities ?? []);
+        this.#defaultTimeoutMs = options.defaultTimeoutMs;
+        this.#metadata = options.metadata;
+        this.#createTraceId = options.createTraceId ?? newTraceId;
+        if (options.manifest)
+            this.#applyManifest(options.manifest);
+    }
+    get connected() {
+        return this.#connected;
+    }
+    async connect() {
+        if (this.#connected)
+            return;
+        await this.transport.connect();
+        this.#connected = true;
+    }
+    async close() {
+        if (!this.#connected)
+            return;
+        this.#connected = false;
+        await this.transport.close();
+    }
+    /**
+     * Loads the manifest through `appport.manifest`, so discovery works the same
+     * way over every transport (§39, §40).
+     */
+    async load() {
+        if (this.#manifest)
+            return this.#manifest;
+        const manifest = (await this.call("appport.manifest", {}));
+        this.#applyManifest(manifest);
+        return manifest;
+    }
+    get manifest() {
+        return this.#manifest;
+    }
+    #applyManifest(manifest) {
+        this.#manifest = manifest;
+        const { versions, streams } = contractFromManifest(manifest);
+        for (const [name, version] of Object.entries(versions)) {
+            if (!this.#versions.has(name))
+                this.#versions.set(name, version);
+        }
+        for (const name of streams)
+            this.#streams.add(name);
+    }
+    /** Resolves the capability version this client will send. */
+    versionOf(name) {
+        return this.#versions.get(name) ?? 1;
+    }
+    isStreamCapability(name) {
+        return this.#streams.has(name);
+    }
+    #buildRequest(name, input, options = {}) {
+        if (!isValidName(name)) {
+            throw new AppPortError("INVALID_REQUEST", `Invalid capability name: ${name}`);
+        }
+        const timeoutMs = options.timeoutMs ?? this.#defaultTimeoutMs;
+        return createRequest({
+            requestId: newRequestId(),
+            capability: { name, version: options.version ?? this.versionOf(name) },
+            input,
+            traceId: options.traceId ?? this.#createTraceId(),
+            ...(options.idempotencyKey ? { idempotencyKey: options.idempotencyKey } : {}),
+            ...(timeoutMs !== undefined ? { timeoutMs } : {}),
+            ...(this.#metadata ? { metadata: this.#metadata } : {})
+        });
+    }
+    /** Calls a request capability and unwraps the response. */
+    async call(name, input, options = {}) {
+        await this.#ensureConnected();
+        const request = this.#buildRequest(name, input, options);
+        const response = await this.#withAbort(options.signal, () => this.transport.request(request));
+        return unwrap(response);
+    }
+    /** Sends a pre-built envelope. Escape hatch for tooling; applications use `call`. */
+    async send(request) {
+        await this.#ensureConnected();
+        return this.transport.request(request);
+    }
+    /** Invokes a stream capability (§20). */
+    stream(name, input, options = {}) {
+        const base = this.#buildRequest(name, input, options);
+        const request = createStreamRequest({
+            requestId: base.requestId,
+            capability: base.capability,
+            input: base.input,
+            ...(base.traceId ? { traceId: base.traceId } : {}),
+            ...(base.timeoutMs !== undefined ? { timeoutMs: base.timeoutMs } : {}),
+            ...(base.metadata ? { metadata: base.metadata } : {})
+        });
+        const self = this;
+        let handle;
+        let cancelled;
+        const iterable = {
+            cancel(reason) {
+                cancelled = reason ?? "cancelled";
+                handle?.cancel(reason);
+            },
+            async *[Symbol.asyncIterator]() {
+                await self.#ensureConnected();
+                handle = self.transport.stream(request);
+                if (cancelled !== undefined)
+                    handle.cancel(cancelled);
+                const onAbort = () => handle?.cancel("aborted");
+                options.signal?.addEventListener("abort", onAbort, { once: true });
+                try {
+                    for await (const chunk of handle)
+                        yield chunk;
+                }
+                finally {
+                    options.signal?.removeEventListener("abort", onAbort);
+                }
+            }
+        };
+        return iterable;
+    }
+    /** Event subscriptions (§18). */
+    events = {
+        subscribe: async (name, handler) => {
+            await this.#ensureConnected();
+            const filter = typeof name === "string" ? { name } : name;
+            const listener = (event) => {
+                handler(event.payload, event);
+            };
+            return this.transport.subscribe(listener, filter);
+        }
+    };
+    /**
+     * Namespaced capability accessor: `client.capabilities.documents.save(input)`.
+     * The proxy resolves versions from the manifest and routes stream
+     * capabilities to `stream()`.
+     */
+    get capabilities() {
+        return createCapabilityProxy(this, []);
+    }
+    async #ensureConnected() {
+        if (!this.#connected)
+            await this.connect();
+    }
+    async #withAbort(signal, fn) {
+        if (!signal)
+            return fn();
+        if (signal.aborted)
+            throw new AppPortError("CANCELLED", "Request aborted before it was sent");
+        let onAbort;
+        try {
+            return await Promise.race([
+                fn(),
+                new Promise((_, reject) => {
+                    onAbort = () => reject(new AppPortError("CANCELLED", "Request aborted"));
+                    signal.addEventListener("abort", onAbort, { once: true });
+                })
+            ]);
+        }
+        finally {
+            // A caller may reuse one signal across many calls; do not accumulate
+            // listeners on it.
+            if (onAbort)
+                signal.removeEventListener("abort", onAbort);
+        }
+    }
+}
+function createCapabilityProxy(client, path) {
+    const call = (input, options) => {
+        const name = path.join(".");
+        return client.isStreamCapability(name)
+            ? client.stream(name, input, options)
+            : client.call(name, input, options);
+    };
+    return new Proxy(call, {
+        get(_target, property) {
+            if (typeof property !== "string")
+                return undefined;
+            return createCapabilityProxy(client, [...path, property]);
+        },
+        apply(_target, _thisArg, args) {
+            return call(args[0], args[1]);
+        }
+    });
+}
+/** Turns an error response into a thrown {@link AppPortError} (§14). */
+export function unwrap(response) {
+    if (response.ok)
+        return response.output;
+    throw new AppPortError(response.error.code, response.error.message, {
+        ...(response.error.details !== undefined ? { details: response.error.details } : {}),
+        ...(response.error.retryable ? { retryable: true } : {})
+    });
+}
+export function createClient(options) {
+    return new AppPortClient(options);
+}
+//# sourceMappingURL=client.js.map

package/vendor/@appport/client/dist/client.js.map

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

package/vendor/@appport/client/dist/contract.d.ts

@@ -0,0 +1,55 @@
+import type { AppPortManifest } from "../../protocol/dist/index.d.ts";
+/**
+ * The type-level description of an application, produced by
+ * `@appport/generators` from a manifest and consumed by the typed client.
+ */
+export interface CapabilityContract {
+    input: unknown;
+    output: unknown;
+    kind?: "request" | "stream";
+    version?: number;
+}
+export interface AppContract {
+    capabilities: Record<string, CapabilityContract>;
+    events: Record<string, unknown>;
+}
+/** An untyped contract; every call falls back to `unknown`. */
+export interface AnyContract extends AppContract {
+    capabilities: Record<string, {
+        input: unknown;
+        output: unknown;
+    }>;
+    events: Record<string, unknown>;
+}
+type Head<S extends string> = S extends `${infer H}.${string}` ? H : S;
+type Tails<Names extends string, H extends string> = Names extends `${H}.${infer R}` ? R : never;
+/**
+ * Turns dotted capability names into a nested namespace object type, so
+ * `documents.save` is reachable as `app.documents.save(input)`.
+ */
+export type CapabilityTree<Names extends string, C extends AppContract, Prefix extends string = ""> = {
+    [H in Head<Names>]: [Tails<Names, H>] extends [never] ? Leaf<C, `${Prefix}${H}`> : CapabilityTree<Tails<Names, H>, C, `${Prefix}${H}.`>;
+};
+type Leaf<C extends AppContract, Name extends string> = Name extends keyof C["capabilities"] ? C["capabilities"][Name] extends {
+    kind: "stream";
+} ? (input: C["capabilities"][Name]["input"], options?: CallOptions) => TypedStream<C["capabilities"][Name]["output"]> : (input: C["capabilities"][Name]["input"], options?: CallOptions) => Promise<C["capabilities"][Name]["output"]> : never;
+export interface CallOptions {
+    /** Overrides the capability version sent on the wire (§42). */
+    version?: number;
+    idempotencyKey?: string;
+    timeoutMs?: number;
+    traceId?: string;
+    signal?: AbortSignal;
+}
+export interface TypedStream<Chunk> extends AsyncIterable<Chunk> {
+    cancel(reason?: string): void;
+}
+/** The namespaced capability accessor exposed as `client.capabilities`. */
+export type CapabilityProxy<C extends AppContract> = CapabilityTree<keyof C["capabilities"] & string, C>;
+/** Derives the runtime facts a client needs from a manifest. */
+export declare function contractFromManifest(manifest: AppPortManifest): {
+    versions: Record<string, number>;
+    streams: Set<string>;
+};
+export {};
+//# sourceMappingURL=contract.d.ts.map

package/vendor/@appport/client/dist/contract.d.ts.map

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

package/vendor/@appport/client/dist/contract.js

@@ -0,0 +1,12 @@
+/** Derives the runtime facts a client needs from a manifest. */
+export function contractFromManifest(manifest) {
+    const versions = {};
+    const streams = new Set();
+    for (const entry of manifest.capabilities) {
+        versions[entry.name] = entry.latestVersion;
+        if (entry.kind === "stream")
+            streams.add(entry.name);
+    }
+    return { versions, streams };
+}
+//# sourceMappingURL=contract.js.map

package/vendor/@appport/client/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AA2DA,gEAAgE;AAChE,MAAM,UAAU,oBAAoB,CAAC,QAAyB;IAI5D,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;QAC1C,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC;QAC3C,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC"}

package/vendor/@appport/client/dist/discovery.d.ts

@@ -0,0 +1,17 @@
+import { type AppPortClient } from "./client.js";
+export interface DiscoverOptions {
+    origin: string;
+    fetch?: typeof globalThis.fetch;
+    WebSocket?: unknown;
+    sessionId?: string;
+    headers?: Record<string, string>;
+}
+/** Discovers a remote/desktop AppPort host and returns the normal client. */
+export declare function discover(options: DiscoverOptions): Promise<AppPortClient>;
+export declare const AppPort: {
+    discover: typeof discover;
+    connect: (options: {
+        url: string;
+    } & Omit<DiscoverOptions, "origin">) => Promise<AppPortClient<import("./contract.js").AnyContract>>;
+};
+//# sourceMappingURL=discovery.d.ts.map

package/vendor/@appport/client/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAG/D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAQD,6EAA6E;AAC7E,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,CAuC/E;AAED,eAAO,MAAM,OAAO;;uBAEC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC;CACrE,CAAC"}

package/vendor/@appport/client/dist/discovery.js

@@ -0,0 +1,56 @@
+import { AppPortError } from "../../protocol/dist/index.js";
+import { createClient } from "./client.js";
+function endpoint(origin, value) {
+    return new URL(value, `${origin.replace(/\/$/, "")}/`).toString();
+}
+/** Discovers a remote/desktop AppPort host and returns the normal client. */
+export async function discover(options) {
+    const origin = options.origin.replace(/\/$/, "");
+    const doFetch = options.fetch ?? globalThis.fetch;
+    if (!doFetch)
+        throw new AppPortError("INTERNAL_ERROR", "fetch is not available");
+    let response;
+    try {
+        response = await doFetch(`${origin}/.well-known/appport`, { headers: options.headers });
+    }
+    catch (error) {
+        throw new AppPortError("INTERNAL_ERROR", "The AppPort discovery endpoint is unreachable", { retryable: true, cause: error });
+    }
+    if (!response.ok)
+        throw new AppPortError(response.status === 403 ? "FORBIDDEN" : "INTERNAL_ERROR", `Discovery failed (HTTP ${response.status})`);
+    const document = await response.json();
+    if (document.protocol !== "appport/1" || !document.application?.id || !Array.isArray(document.transports)) {
+        throw new AppPortError("INVALID_PROTOCOL", "The discovery document is not compatible with appport/1");
+    }
+    const sessionId = options.sessionId ?? `ses_${globalThis.crypto?.randomUUID?.().replaceAll("-", "") ?? Math.random().toString(36).slice(2)}`;
+    const websocket = document.transports.find((item) => item.kind === "websocket" && item.endpoint);
+    const http = document.transports.find((item) => item.kind === "http" && item.endpoint);
+    let transport;
+    if (websocket) {
+        const name = "@appport/transport-websocket";
+        const module = await import(name);
+        const url = endpoint(origin, websocket.endpoint).replace(/^http:/, "ws:").replace(/^https:/, "wss:");
+        transport = module.createWebSocketTransport({ url, sessionId, headers: options.headers, ...(options.WebSocket ? { WebSocket: options.WebSocket } : {}) });
+    }
+    else if (http) {
+        const name = "@appport/transport-http";
+        const module = await import(name);
+        transport = module.createHttpTransport({ url: endpoint(origin, http.endpoint), sessionId, fetch: doFetch, credentials: "include", headers: options.headers });
+    }
+    else {
+        throw new AppPortError("INVALID_PROTOCOL", "Discovery advertised no compatible browser transport");
+    }
+    const client = createClient({ transport });
+    await client.connect();
+    const manifest = await client.load();
+    if (manifest.protocol !== "appport/1" || manifest.application.id !== document.application.id) {
+        await client.close();
+        throw new AppPortError("INVALID_PROTOCOL", "Discovery and manifest identities do not match");
+    }
+    return client;
+}
+export const AppPort = {
+    discover,
+    connect: (options) => discover({ ...options, origin: options.url })
+};
+//# sourceMappingURL=discovery.js.map

package/vendor/@appport/client/dist/discovery.js.map

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

package/vendor/@appport/client/dist/duplex.d.ts

@@ -0,0 +1,25 @@
+import { type ClientEnvelope } from "../../protocol/dist/index.d.ts";
+import { type AppTransport, type TransportFeatures } from "./transport.js";
+/**
+ * The carrier half of a duplex transport.
+ *
+ * WebSocket, Electron IPC, Tauri IPC and the in-process bridge differ only in
+ * how bytes move; the correlation of requests, events and streams is identical,
+ * so it lives here once (§72).
+ */
+export interface DuplexChannel {
+    readonly kind: string;
+    open(handlers: DuplexHandlers): Promise<void>;
+    send(envelope: ClientEnvelope): void | Promise<void>;
+    close(): Promise<void>;
+    readonly features?: TransportFeatures;
+}
+export interface DuplexHandlers {
+    /** Called with each envelope received from the server, decoded but unvalidated. */
+    onEnvelope(value: unknown): void;
+    /** Called once when the carrier closes. */
+    onClose(reason?: unknown): void;
+}
+/** Builds an {@link AppTransport} from a {@link DuplexChannel}. */
+export declare function createDuplexTransport(channel: DuplexChannel): AppTransport;
+//# sourceMappingURL=duplex.d.ts.map

package/vendor/@appport/client/dist/duplex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplex.d.ts","sourceRoot":"","sources":["../src/duplex.ts"],"names":[],"mappings":"AAAA,OAAO,EAaL,KAAK,cAAc,EAEpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAEL,KAAK,YAAY,EAGjB,KAAK,iBAAiB,EAGvB,MAAM,gBAAgB,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,mFAAmF;IACnF,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,2CAA2C;IAC3C,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACjC;AAaD,mEAAmE;AACnE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAkM1E"}

package/vendor/@appport/client/dist/duplex.js

@@ -0,0 +1,194 @@
+import { AppPortError, createStreamCancel, createSubscribe, createUnsubscribe, errors, newRequestId, newSubscriptionId, parseServerEnvelope } from "../../protocol/dist/index.js";
+import { ClientChannel } from "./channel.js";
+import { DEFAULT_FEATURES } from "./transport.js";
+/** Builds an {@link AppTransport} from a {@link DuplexChannel}. */
+export function createDuplexTransport(channel) {
+    const pending = new Map();
+    const subscriptions = new Map();
+    const streamsByRequest = new Map();
+    const streamsById = new Map();
+    let opened = false;
+    let closing = false;
+    let generation = 0;
+    const failAll = (reason) => {
+        for (const request of pending.values())
+            request.reject(reason);
+        pending.clear();
+        for (const stream of streamsById.values())
+            stream.channel.fail(reason);
+        for (const stream of streamsByRequest.values())
+            stream.channel.fail(reason);
+        streamsById.clear();
+        streamsByRequest.clear();
+        subscriptions.clear();
+    };
+    const onEnvelope = (value) => {
+        let envelope;
+        try {
+            envelope = parseServerEnvelope(value);
+        }
+        catch {
+            // A malformed server envelope must not corrupt client state (§57).
+            return;
+        }
+        switch (envelope.type) {
+            case "response": {
+                const request = pending.get(envelope.requestId);
+                if (request) {
+                    pending.delete(envelope.requestId);
+                    request.resolve(envelope);
+                    return;
+                }
+                // A stream request that failed before `stream.start` is answered with a
+                // plain error response; surface it on the stream the caller is holding.
+                const stream = streamsByRequest.get(envelope.requestId);
+                if (stream && !envelope.ok) {
+                    streamsByRequest.delete(envelope.requestId);
+                    stream.channel.fail(new AppPortError(envelope.error.code, envelope.error.message));
+                }
+                return;
+            }
+            case "event": {
+                const handler = envelope.subscriptionId ? subscriptions.get(envelope.subscriptionId) : undefined;
+                if (handler)
+                    handler(envelope);
+                else
+                    for (const listener of subscriptions.values())
+                        listener(envelope);
+                return;
+            }
+            case "stream.start": {
+                const stream = streamsByRequest.get(envelope.requestId);
+                if (!stream)
+                    return;
+                stream.streamId = envelope.streamId;
+                streamsById.set(envelope.streamId, stream);
+                return;
+            }
+            case "stream.chunk": {
+                const stream = streamsById.get(envelope.streamId);
+                if (!stream)
+                    return;
+                if (envelope.sequence !== stream.expectedSequence) {
+                    stream.channel.fail(errors.streamError(`Out-of-order stream chunk: expected ${stream.expectedSequence}, received ${envelope.sequence}`));
+                    return;
+                }
+                stream.expectedSequence += 1;
+                stream.channel.push(envelope.payload);
+                return;
+            }
+            case "stream.end": {
+                const stream = streamsById.get(envelope.streamId);
+                if (!stream)
+                    return;
+                streamsById.delete(envelope.streamId);
+                for (const [requestId, candidate] of streamsByRequest) {
+                    if (candidate === stream)
+                        streamsByRequest.delete(requestId);
+                }
+                if (envelope.error) {
+                    stream.channel.fail(new AppPortError(envelope.error.code, envelope.error.message));
+                }
+                else {
+                    stream.channel.end();
+                }
+                return;
+            }
+        }
+    };
+    const ensureOpen = async () => {
+        if (opened)
+            return;
+        generation += 1;
+        const current = generation;
+        await channel.open({
+            onEnvelope: (value) => {
+                if (current !== generation)
+                    return;
+                onEnvelope(value);
+            },
+            onClose: (reason) => {
+                // Ignore a close from a carrier that has already been superseded.
+                if (current !== generation)
+                    return;
+                opened = false;
+                failAll(reason ?? (closing ? errors.cancelled("Transport closed") : errors.streamError("Transport disconnected")));
+            }
+        });
+        opened = true;
+    };
+    const transport = {
+        kind: channel.kind,
+        features: channel.features ?? DEFAULT_FEATURES,
+        async connect() {
+            await ensureOpen();
+        },
+        async close() {
+            closing = true;
+            generation += 1;
+            if (opened) {
+                opened = false;
+                await channel.close();
+            }
+            failAll(errors.cancelled("Transport closed"));
+            closing = false;
+        },
+        async request(request) {
+            await ensureOpen();
+            return new Promise((resolve, reject) => {
+                pending.set(request.requestId, { resolve, reject });
+                Promise.resolve(channel.send(request)).catch((error) => {
+                    pending.delete(request.requestId);
+                    reject(error);
+                });
+            });
+        },
+        async subscribe(handler, filter) {
+            await ensureOpen();
+            const subscriptionId = newSubscriptionId();
+            const requestId = newRequestId();
+            subscriptions.set(subscriptionId, handler);
+            const ack = new Promise((resolve, reject) => {
+                pending.set(requestId, { resolve, reject });
+            });
+            await channel.send(createSubscribe(requestId, subscriptionId, {
+                name: filter?.name ?? "*",
+                ...(filter?.version !== undefined ? { version: filter.version } : {})
+            }));
+            const response = await ack;
+            if (!response.ok) {
+                subscriptions.delete(subscriptionId);
+                throw new AppPortError(response.error.code, response.error.message);
+            }
+            return () => {
+                subscriptions.delete(subscriptionId);
+                void Promise.resolve(channel.send(createUnsubscribe(newRequestId(), subscriptionId))).catch(() => undefined);
+            };
+        },
+        stream(request) {
+            const stream = { channel: new ClientChannel(), expectedSequence: 0 };
+            streamsByRequest.set(request.requestId, stream);
+            void (async () => {
+                try {
+                    await ensureOpen();
+                    await channel.send(request);
+                }
+                catch (error) {
+                    stream.channel.fail(error);
+                }
+            })();
+            return {
+                cancel(reason) {
+                    const streamId = stream.streamId;
+                    if (streamId) {
+                        void Promise.resolve(channel.send(createStreamCancel(streamId, reason))).catch(() => undefined);
+                    }
+                    stream.channel.fail(errors.cancelled(reason ?? "Cancelled by client"));
+                },
+                [Symbol.asyncIterator]: () => stream.channel[Symbol.asyncIterator]()
+            };
+        }
+    };
+    return transport;
+}
+//# sourceMappingURL=duplex.js.map

package/vendor/@appport/client/dist/duplex.js.map

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