@xyo-network/dapp-kit-port 0.1.2

package/README.md

@@ -0,0 +1,23 @@
+# `@xyo-network/dapp-kit-port`
+
+Shared application-port client and host peers for browser and Node transports.
+
+The package owns protocol state for unary requests, acknowledged cancellation,
+bounded-credit streams, exact redelivery checks, and durable resume cursors.
+Every frame is validated against its attachment grant, plan, system
+incarnation, host session, request, port, operation, and deadline before domain
+delivery.
+
+The peers depend only on a small message-endpoint interface. Platform packages
+adapt `MessagePort`, WebSocket, or future native transports to that interface;
+they do not duplicate the protocol state machine. Actor and provider locators
+never cross the endpoint.
+
+The package also owns the transport-neutral WebSocket wire mapping. Frames are
+strict I-JSON text messages with canonical serialization, a negotiated byte
+limit, and an attachment `hello` that carries the existing grant. The shared
+`connectWebSocketApplicationPort()` client works with browser `WebSocket` and
+compatible Node implementations. It verifies the expected dApp, plan, protocol
+version, and grant lifetime before publishing an `ApplicationPortClient`.
+Transport loss rejects pending unary and streaming work; reconnecting creates a
+new attachment and resumes only through the existing cursor protocol.

package/dist/browser/applicationPortClient.d.ts

@@ -0,0 +1,6 @@
+import type { ApplicationPortClient, ApplicationPortPeerOptions } from './applicationPortModel.ts';
+export interface CreateApplicationPortClientOptions extends ApplicationPortPeerOptions {
+    readonly nextRequestId: () => string;
+}
+export declare function createApplicationPortClient(options: CreateApplicationPortClientOptions): ApplicationPortClient;
+//# sourceMappingURL=applicationPortClient.d.ts.map

package/dist/browser/applicationPortClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applicationPortClient.d.ts","sourceRoot":"","sources":["../../src/applicationPortClient.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,qBAAqB,EACrB,0BAA0B,EAO3B,MAAM,2BAA2B,CAAA;AAWlC,MAAM,WAAW,kCAAmC,SAAQ,0BAA0B;IACpF,QAAQ,CAAC,aAAa,EAAE,MAAM,MAAM,CAAA;CACrC;AA+cD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,kCAAkC,GAAG,qBAAqB,CAE9G"}

package/dist/browser/applicationPortHost.d.ts

@@ -0,0 +1,10 @@
+import type { ApplicationPortErrorData, ApplicationPortOperation, ApplicationPortPeerOptions } from './applicationPortModel.ts';
+export interface CreateApplicationPortHostOptions extends ApplicationPortPeerOptions {
+    readonly mapError: (error: unknown) => ApplicationPortErrorData;
+    readonly operations: readonly ApplicationPortOperation[];
+}
+export interface ApplicationPortHost {
+    close(): Promise<void>;
+}
+export declare function createApplicationPortHost(options: CreateApplicationPortHostOptions): ApplicationPortHost;
+//# sourceMappingURL=applicationPortHost.d.ts.map

package/dist/browser/applicationPortHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applicationPortHost.d.ts","sourceRoot":"","sources":["../../src/applicationPortHost.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAI3B,MAAM,2BAA2B,CAAA;AAWlC,MAAM,WAAW,gCAAiC,SAAQ,0BAA0B;IAClF,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,wBAAwB,CAAA;IAC/D,QAAQ,CAAC,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAA;CACzD;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAmbD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gCAAgC,GAAG,mBAAmB,CAExG"}

package/dist/browser/applicationPortModel.d.ts

@@ -0,0 +1,154 @@
+import type { JsonValue, PortAttachmentGrant, PortConsistencyEvidence, PortFrame, PortFrameIssue, PortOperationGrant } from '@xyo-network/dapp-kit';
+export interface ApplicationPortMessageEndpoint {
+    addMessageListener(listener: (message: unknown) => void): void;
+    removeMessageListener(listener: (message: unknown) => void): void;
+    send(message: unknown): void;
+    start?(): void;
+}
+export declare const ApplicationPortProxyErrorCode: {
+    readonly cancelled: "port.cancelled";
+    readonly detached: "port.detached";
+    readonly directionInvalid: "port.direction-invalid";
+    readonly duplicateRequest: "port.duplicate-request";
+    readonly hostFailure: "port.host-failure";
+    readonly operationKindMismatch: "port.operation-kind-mismatch";
+    readonly operationUnavailable: "port.operation-unavailable";
+    readonly requestUnknown: "port.request-unknown";
+    readonly streamStateInvalid: "port.stream-state-invalid";
+};
+export type ApplicationPortProxyErrorCode = typeof ApplicationPortProxyErrorCode[keyof typeof ApplicationPortProxyErrorCode];
+export interface ApplicationPortErrorData {
+    readonly code: string;
+    readonly details?: JsonValue;
+    readonly retriable: boolean;
+}
+export declare class ApplicationPortProxyError extends Error {
+    readonly code: ApplicationPortProxyErrorCode;
+    readonly issues?: readonly PortFrameIssue[];
+    constructor(code: ApplicationPortProxyErrorCode, message: string, issues?: readonly PortFrameIssue[]);
+}
+export declare class ApplicationPortRemoteError extends Error {
+    readonly code: string;
+    readonly details?: JsonValue;
+    readonly retriable: boolean;
+    constructor(error: ApplicationPortErrorData);
+}
+export declare class ApplicationPortCancelledError extends Error {
+    readonly code: "port.cancelled";
+    readonly reasonCode: string;
+    constructor(reasonCode: string);
+}
+export interface ApplicationPortProtocolErrorContext {
+    readonly cause: ApplicationPortProxyError;
+    readonly value: unknown;
+}
+export interface ApplicationPortPeerOptions {
+    readonly authenticatedPrincipalId: string;
+    readonly endpoint: ApplicationPortMessageEndpoint;
+    readonly grant: PortAttachmentGrant;
+    readonly now: () => number;
+    readonly onProtocolError: (context: ApplicationPortProtocolErrorContext) => void;
+}
+export interface ApplicationPortRequestContext {
+    readonly body: JsonValue;
+    readonly grant: PortAttachmentGrant;
+    readonly requestId: string;
+    readonly signal: AbortSignal;
+}
+export interface ApplicationPortUnaryResult {
+    readonly body: JsonValue;
+    readonly consistency: PortConsistencyEvidence;
+}
+export interface ApplicationPortUnaryOperation {
+    readonly operationId: string;
+    readonly portId: string;
+    readonly streaming: false;
+    handle(context: ApplicationPortRequestContext): Promise<ApplicationPortUnaryResult>;
+}
+export interface ApplicationPortStreamItem {
+    readonly body: JsonValue;
+    readonly consistency: PortConsistencyEvidence;
+    readonly resumeCursor?: string;
+}
+export type ApplicationPortStreamRead = {
+    readonly done: false;
+    readonly value: ApplicationPortStreamItem;
+} | {
+    readonly done: true;
+    readonly resumeCursor?: string;
+};
+export interface ApplicationPortStreamSource {
+    readonly nextSequence: number;
+    readonly resumable: boolean;
+    readonly resumeCursor?: string;
+    readonly streamId: string;
+    cancel?(reasonCode: string): Promise<void>;
+    next(signal: AbortSignal): Promise<ApplicationPortStreamRead>;
+}
+export interface ApplicationPortStreamResumeContext extends ApplicationPortRequestContext {
+    readonly lastAcceptedSequence: number;
+    readonly resumeCursor: string;
+    readonly streamId: string;
+}
+export interface ApplicationPortStreamOperation {
+    readonly operationId: string;
+    readonly portId: string;
+    readonly streaming: true;
+    open(context: ApplicationPortRequestContext): Promise<ApplicationPortStreamSource>;
+    resume?(context: ApplicationPortStreamResumeContext): Promise<ApplicationPortStreamSource>;
+}
+export type ApplicationPortOperation = ApplicationPortStreamOperation | ApplicationPortUnaryOperation;
+export interface ApplicationPortRequestOptions {
+    readonly body: JsonValue;
+    readonly deadlineUnixMs: number;
+    readonly operationId: string;
+    readonly portId: string;
+    readonly signal?: AbortSignal;
+}
+export interface ApplicationPortStreamRequestOptions extends ApplicationPortRequestOptions {
+    readonly initialCredit: number;
+}
+export interface ApplicationPortStreamResumeOptions {
+    readonly credit: number;
+    readonly deadlineUnixMs: number;
+    readonly lastAcceptedSequence: number;
+    readonly operationId: string;
+    readonly portId: string;
+    readonly resumeCursor: string;
+    readonly signal?: AbortSignal;
+    readonly streamId: string;
+}
+export interface ApplicationPortStreamValue extends ApplicationPortStreamItem {
+    readonly sequence: number;
+}
+export interface ApplicationPortStream extends AsyncIterableIterator<ApplicationPortStreamValue> {
+    readonly requestId: string;
+    readonly streamId: string;
+    cancel(reasonCode?: string): void;
+    credit(value: number): void;
+}
+export interface ApplicationPortClient {
+    close(): void;
+    request(options: ApplicationPortRequestOptions): Promise<ApplicationPortUnaryResult>;
+    resumeStream(options: ApplicationPortStreamResumeOptions): Promise<ApplicationPortStream>;
+    stream(options: ApplicationPortStreamRequestOptions): Promise<ApplicationPortStream>;
+}
+export declare function applicationPortOperationKey(portId: string, operationId: string): string;
+export declare function applicationPortOperationGrant(grant: PortAttachmentGrant, portId: string, operationId: string): PortOperationGrant | undefined;
+export declare function applicationPortFrameBase(grant: PortAttachmentGrant, frame: Pick<PortFrame, 'deadlineUnixMs' | 'operationId' | 'portId' | 'requestId'>): {
+    schema: "network.xyo.dapp.port.frame";
+    schemaVersion: 1;
+    dappId: string;
+    protocolVersion: string;
+    planId: string;
+    systemInstanceId: string;
+    hostSessionId: string;
+    attachmentId: string;
+    requestId: string;
+    deadlineUnixMs: number;
+    portId: string;
+    operationId: string;
+};
+export declare function parseApplicationPortFrame(value: unknown): PortFrame;
+export declare function applicationPortErrorFrame(grant: PortAttachmentGrant, frame: PortFrame, error: ApplicationPortErrorData): PortFrame;
+//# sourceMappingURL=applicationPortModel.d.ts.map

package/dist/browser/applicationPortModel.d.ts.map

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

package/dist/browser/applicationPortWire.d.ts

@@ -0,0 +1,327 @@
+import type { PortFrame } from '@xyo-network/dapp-kit';
+import { z } from 'zod';
+export declare const ApplicationPortTransportSchema: "network.xyo.dapp.port.transport";
+export declare const ApplicationPortTransportHelloZod: z.ZodObject<{
+    schema: z.ZodLiteral<"network.xyo.dapp.port.transport">;
+    schemaVersion: z.ZodLiteral<1>;
+    messageKind: z.ZodLiteral<"hello">;
+    maximumFrameBytes: z.ZodNumber;
+    grant: z.ZodObject<{
+        attachmentId: z.ZodString;
+        principalId: z.ZodString;
+        dappId: z.ZodString;
+        protocolVersion: z.ZodString;
+        planId: z.ZodString;
+        systemInstanceId: z.ZodString;
+        hostSessionId: z.ZodString;
+        createdAt: z.ZodNumber;
+        lastSeenAt: z.ZodNumber;
+        expiresAt: z.ZodNumber;
+        leasePolicy: z.ZodEnum<{
+            "fixed-expiry": "fixed-expiry";
+            "disconnect-expiry": "disconnect-expiry";
+        }>;
+        operations: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            portId: z.ZodString;
+            operationId: z.ZodString;
+            streaming: z.ZodLiteral<false>;
+        }, z.core.$strict>, z.ZodObject<{
+            portId: z.ZodString;
+            operationId: z.ZodString;
+            streaming: z.ZodLiteral<true>;
+            resumable: z.ZodBoolean;
+            maximumCredit: z.ZodNumber;
+        }, z.core.$strict>], "streaming">>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ApplicationPortTransportHello = z.infer<typeof ApplicationPortTransportHelloZod>;
+export declare const ApplicationPortTransportErrorZod: z.ZodObject<{
+    schema: z.ZodLiteral<"network.xyo.dapp.port.transport">;
+    schemaVersion: z.ZodLiteral<1>;
+    messageKind: z.ZodLiteral<"error">;
+    code: z.ZodString;
+    retriable: z.ZodBoolean;
+}, z.core.$strict>;
+export type ApplicationPortTransportError = z.infer<typeof ApplicationPortTransportErrorZod>;
+export declare const ApplicationPortWireMessageZod: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    frameKind: z.ZodLiteral<"request">;
+    body: z.ZodType<import("@xyo-network/dapp-kit").JsonValue, unknown, z.core.$ZodTypeInternals<import("@xyo-network/dapp-kit").JsonValue, unknown>>;
+    schema: z.ZodLiteral<"network.xyo.dapp.port.frame">;
+    schemaVersion: z.ZodLiteral<1>;
+    dappId: z.ZodString;
+    protocolVersion: z.ZodString;
+    planId: z.ZodString;
+    systemInstanceId: z.ZodString;
+    hostSessionId: z.ZodString;
+    attachmentId: z.ZodString;
+    requestId: z.ZodString;
+    deadlineUnixMs: z.ZodNumber;
+    portId: z.ZodString;
+    operationId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    frameKind: z.ZodLiteral<"response">;
+    consistency: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        mode: z.ZodLiteral<"not-applicable">;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"finalized-through">;
+        blockNumber: z.ZodNumber;
+        blockHash: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"projection-through">;
+        blockNumber: z.ZodNumber;
+        blockHash: z.ZodString;
+        projectionId: z.ZodString;
+        projectionVersion: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"provisional">;
+        blockNumber: z.ZodNumber;
+        blockHash: z.ZodString;
+        transactionHash: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"local-ephemeral">;
+    }, z.core.$strict>], "mode">;
+    body: z.ZodType<import("@xyo-network/dapp-kit").JsonValue, unknown, z.core.$ZodTypeInternals<import("@xyo-network/dapp-kit").JsonValue, unknown>>;
+    schema: z.ZodLiteral<"network.xyo.dapp.port.frame">;
+    schemaVersion: z.ZodLiteral<1>;
+    dappId: z.ZodString;
+    protocolVersion: z.ZodString;
+    planId: z.ZodString;
+    systemInstanceId: z.ZodString;
+    hostSessionId: z.ZodString;
+    attachmentId: z.ZodString;
+    requestId: z.ZodString;
+    deadlineUnixMs: z.ZodNumber;
+    portId: z.ZodString;
+    operationId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    frameKind: z.ZodLiteral<"error">;
+    error: z.ZodObject<{
+        code: z.ZodString;
+        retriable: z.ZodBoolean;
+        details: z.ZodOptional<z.ZodType<import("@xyo-network/dapp-kit").JsonValue, unknown, z.core.$ZodTypeInternals<import("@xyo-network/dapp-kit").JsonValue, unknown>>>;
+    }, z.core.$strict>;
+    schema: z.ZodLiteral<"network.xyo.dapp.port.frame">;
+    schemaVersion: z.ZodLiteral<1>;
+    dappId: z.ZodString;
+    protocolVersion: z.ZodString;
+    planId: z.ZodString;
+    systemInstanceId: z.ZodString;
+    hostSessionId: z.ZodString;
+    attachmentId: z.ZodString;
+    requestId: z.ZodString;
+    deadlineUnixMs: z.ZodNumber;
+    portId: z.ZodString;
+    operationId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    frameKind: z.ZodLiteral<"cancel">;
+    reasonCode: z.ZodString;
+    schema: z.ZodLiteral<"network.xyo.dapp.port.frame">;
+    schemaVersion: z.ZodLiteral<1>;
+    dappId: z.ZodString;
+    protocolVersion: z.ZodString;
+    planId: z.ZodString;
+    systemInstanceId: z.ZodString;
+    hostSessionId: z.ZodString;
+    attachmentId: z.ZodString;
+    requestId: z.ZodString;
+    deadlineUnixMs: z.ZodNumber;
+    portId: z.ZodString;
+    operationId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    frameKind: z.ZodLiteral<"cancel-ack">;
+    willEmitNoNewWork: z.ZodLiteral<true>;
+    schema: z.ZodLiteral<"network.xyo.dapp.port.frame">;
+    schemaVersion: z.ZodLiteral<1>;
+    dappId: z.ZodString;
+    protocolVersion: z.ZodString;
+    planId: z.ZodString;
+    systemInstanceId: z.ZodString;
+    hostSessionId: z.ZodString;
+    attachmentId: z.ZodString;
+    requestId: z.ZodString;
+    deadlineUnixMs: z.ZodNumber;
+    portId: z.ZodString;
+    operationId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    frameKind: z.ZodLiteral<"stream-open">;
+    streamId: z.ZodString;
+    delivery: z.ZodLiteral<"at-least-once">;
+    resumable: z.ZodBoolean;
+    nextSequence: z.ZodNumber;
+    resumeCursor: z.ZodOptional<z.ZodString>;
+    schema: z.ZodLiteral<"network.xyo.dapp.port.frame">;
+    schemaVersion: z.ZodLiteral<1>;
+    dappId: z.ZodString;
+    protocolVersion: z.ZodString;
+    planId: z.ZodString;
+    systemInstanceId: z.ZodString;
+    hostSessionId: z.ZodString;
+    attachmentId: z.ZodString;
+    requestId: z.ZodString;
+    deadlineUnixMs: z.ZodNumber;
+    portId: z.ZodString;
+    operationId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    frameKind: z.ZodLiteral<"stream-item">;
+    streamId: z.ZodString;
+    sequence: z.ZodNumber;
+    resumeCursor: z.ZodOptional<z.ZodString>;
+    consistency: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        mode: z.ZodLiteral<"not-applicable">;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"finalized-through">;
+        blockNumber: z.ZodNumber;
+        blockHash: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"projection-through">;
+        blockNumber: z.ZodNumber;
+        blockHash: z.ZodString;
+        projectionId: z.ZodString;
+        projectionVersion: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"provisional">;
+        blockNumber: z.ZodNumber;
+        blockHash: z.ZodString;
+        transactionHash: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"local-ephemeral">;
+    }, z.core.$strict>], "mode">;
+    body: z.ZodType<import("@xyo-network/dapp-kit").JsonValue, unknown, z.core.$ZodTypeInternals<import("@xyo-network/dapp-kit").JsonValue, unknown>>;
+    schema: z.ZodLiteral<"network.xyo.dapp.port.frame">;
+    schemaVersion: z.ZodLiteral<1>;
+    dappId: z.ZodString;
+    protocolVersion: z.ZodString;
+    planId: z.ZodString;
+    systemInstanceId: z.ZodString;
+    hostSessionId: z.ZodString;
+    attachmentId: z.ZodString;
+    requestId: z.ZodString;
+    deadlineUnixMs: z.ZodNumber;
+    portId: z.ZodString;
+    operationId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    frameKind: z.ZodLiteral<"stream-credit">;
+    streamId: z.ZodString;
+    credit: z.ZodNumber;
+    schema: z.ZodLiteral<"network.xyo.dapp.port.frame">;
+    schemaVersion: z.ZodLiteral<1>;
+    dappId: z.ZodString;
+    protocolVersion: z.ZodString;
+    planId: z.ZodString;
+    systemInstanceId: z.ZodString;
+    hostSessionId: z.ZodString;
+    attachmentId: z.ZodString;
+    requestId: z.ZodString;
+    deadlineUnixMs: z.ZodNumber;
+    portId: z.ZodString;
+    operationId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    frameKind: z.ZodLiteral<"stream-close">;
+    streamId: z.ZodString;
+    lastSequence: z.ZodNumber;
+    resumeCursor: z.ZodOptional<z.ZodString>;
+    schema: z.ZodLiteral<"network.xyo.dapp.port.frame">;
+    schemaVersion: z.ZodLiteral<1>;
+    dappId: z.ZodString;
+    protocolVersion: z.ZodString;
+    planId: z.ZodString;
+    systemInstanceId: z.ZodString;
+    hostSessionId: z.ZodString;
+    attachmentId: z.ZodString;
+    requestId: z.ZodString;
+    deadlineUnixMs: z.ZodNumber;
+    portId: z.ZodString;
+    operationId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    frameKind: z.ZodLiteral<"stream-error">;
+    streamId: z.ZodString;
+    lastSequence: z.ZodNumber;
+    resumeCursor: z.ZodOptional<z.ZodString>;
+    error: z.ZodObject<{
+        code: z.ZodString;
+        retriable: z.ZodBoolean;
+        details: z.ZodOptional<z.ZodType<import("@xyo-network/dapp-kit").JsonValue, unknown, z.core.$ZodTypeInternals<import("@xyo-network/dapp-kit").JsonValue, unknown>>>;
+    }, z.core.$strict>;
+    schema: z.ZodLiteral<"network.xyo.dapp.port.frame">;
+    schemaVersion: z.ZodLiteral<1>;
+    dappId: z.ZodString;
+    protocolVersion: z.ZodString;
+    planId: z.ZodString;
+    systemInstanceId: z.ZodString;
+    hostSessionId: z.ZodString;
+    attachmentId: z.ZodString;
+    requestId: z.ZodString;
+    deadlineUnixMs: z.ZodNumber;
+    portId: z.ZodString;
+    operationId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    frameKind: z.ZodLiteral<"stream-resume">;
+    streamId: z.ZodString;
+    lastAcceptedSequence: z.ZodNumber;
+    resumeCursor: z.ZodString;
+    credit: z.ZodNumber;
+    schema: z.ZodLiteral<"network.xyo.dapp.port.frame">;
+    schemaVersion: z.ZodLiteral<1>;
+    dappId: z.ZodString;
+    protocolVersion: z.ZodString;
+    planId: z.ZodString;
+    systemInstanceId: z.ZodString;
+    hostSessionId: z.ZodString;
+    attachmentId: z.ZodString;
+    requestId: z.ZodString;
+    deadlineUnixMs: z.ZodNumber;
+    portId: z.ZodString;
+    operationId: z.ZodString;
+}, z.core.$strict>], "frameKind">, z.ZodObject<{
+    schema: z.ZodLiteral<"network.xyo.dapp.port.transport">;
+    schemaVersion: z.ZodLiteral<1>;
+    messageKind: z.ZodLiteral<"hello">;
+    maximumFrameBytes: z.ZodNumber;
+    grant: z.ZodObject<{
+        attachmentId: z.ZodString;
+        principalId: z.ZodString;
+        dappId: z.ZodString;
+        protocolVersion: z.ZodString;
+        planId: z.ZodString;
+        systemInstanceId: z.ZodString;
+        hostSessionId: z.ZodString;
+        createdAt: z.ZodNumber;
+        lastSeenAt: z.ZodNumber;
+        expiresAt: z.ZodNumber;
+        leasePolicy: z.ZodEnum<{
+            "fixed-expiry": "fixed-expiry";
+            "disconnect-expiry": "disconnect-expiry";
+        }>;
+        operations: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            portId: z.ZodString;
+            operationId: z.ZodString;
+            streaming: z.ZodLiteral<false>;
+        }, z.core.$strict>, z.ZodObject<{
+            portId: z.ZodString;
+            operationId: z.ZodString;
+            streaming: z.ZodLiteral<true>;
+            resumable: z.ZodBoolean;
+            maximumCredit: z.ZodNumber;
+        }, z.core.$strict>], "streaming">>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    schema: z.ZodLiteral<"network.xyo.dapp.port.transport">;
+    schemaVersion: z.ZodLiteral<1>;
+    messageKind: z.ZodLiteral<"error">;
+    code: z.ZodString;
+    retriable: z.ZodBoolean;
+}, z.core.$strict>]>;
+export type ApplicationPortWireMessage = z.infer<typeof ApplicationPortWireMessageZod>;
+export declare const ApplicationPortWireErrorCode: {
+    readonly frameTooLarge: "port.wire-frame-too-large";
+    readonly invalidMessage: "port.wire-invalid-message";
+};
+export type ApplicationPortWireErrorCode = typeof ApplicationPortWireErrorCode[keyof typeof ApplicationPortWireErrorCode];
+export declare class ApplicationPortWireError extends Error {
+    readonly code: ApplicationPortWireErrorCode;
+    constructor(code: ApplicationPortWireErrorCode, message: string, options?: ErrorOptions);
+}
+export declare function isApplicationPortFrame(message: ApplicationPortWireMessage): message is PortFrame;
+export declare function parseApplicationPortWireText(source: string, maximumFrameBytes: number): ApplicationPortWireMessage;
+export declare function serializeApplicationPortWireMessage(message: ApplicationPortWireMessage, maximumFrameBytes: number): string;
+//# sourceMappingURL=applicationPortWire.d.ts.map

package/dist/browser/applicationPortWire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applicationPortWire.d.ts","sourceRoot":"","sources":["../../src/applicationPortWire.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAQtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,8BAA8B,EAAG,iCAA0C,CAAA;AAExF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAM3C,CAAA;AAEF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AAE5F,eAAO,MAAM,gCAAgC;;;;;;kBAM3C,CAAA;AAEF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AAE5F,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAIxC,CAAA;AAEF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAEtF,eAAO,MAAM,4BAA4B;;;CAG/B,CAAA;AAEV,MAAM,MAAM,4BAA4B,GACpC,OAAO,4BAA4B,CAAC,MAAM,OAAO,4BAA4B,CAAC,CAAA;AAElF,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAA;gBAE/B,IAAI,EAAE,4BAA4B,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKxF;AAaD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,IAAI,SAAS,CAEhG;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,GACxB,0BAA0B,CAkB5B;AAED,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,0BAA0B,EACnC,iBAAiB,EAAE,MAAM,GACxB,MAAM,CAmBR"}

package/dist/browser/index.d.ts

@@ -0,0 +1,6 @@
+export * from './applicationPortClient.ts';
+export * from './applicationPortHost.ts';
+export * from './applicationPortModel.ts';
+export * from './applicationPortWire.ts';
+export * from './webSocketApplicationPortClient.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,0BAA0B,CAAA;AACxC,cAAc,2BAA2B,CAAA;AACzC,cAAc,0BAA0B,CAAA;AACxC,cAAc,qCAAqC,CAAA"}