@appport/sdk 1.1.19 → 1.1.20

package/vendor/@appport/protocol/dist/blob.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Binary references (specification §51).
+ *
+ * AppPort v1 carries references to binary content rather than embedding large
+ * blobs in JSON envelopes. Transfer of the bytes themselves is provided by the
+ * application or an extension, not by the core protocol.
+ */
+export interface BlobRef {
+    type: "blob";
+    id: string;
+    size: number;
+    contentType: string;
+    /** Optional URL a client may fetch the bytes from, when the deployment offers one. */
+    url?: string;
+    /** Optional content digest, e.g. `sha256:...`. */
+    digest?: string;
+}
+export declare function isBlobRef(value: unknown): value is BlobRef;
+export declare const BLOB_REF_SCHEMA: {
+    readonly type: "object";
+    readonly title: "BlobRef";
+    readonly properties: {
+        readonly type: {
+            readonly const: "blob";
+        };
+        readonly id: {
+            readonly type: "string";
+        };
+        readonly size: {
+            readonly type: "integer";
+            readonly minimum: 0;
+        };
+        readonly contentType: {
+            readonly type: "string";
+        };
+        readonly url: {
+            readonly type: "string";
+        };
+        readonly digest: {
+            readonly type: "string";
+        };
+    };
+    readonly required: readonly ["type", "id", "size", "contentType"];
+    readonly additionalProperties: false;
+};
+//# sourceMappingURL=blob.d.ts.map

package/vendor/@appport/protocol/dist/blob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob.d.ts","sourceRoot":"","sources":["../src/blob.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAS1D;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;CAalB,CAAC"}

package/vendor/@appport/protocol/dist/blob.js

@@ -0,0 +1,23 @@
+export function isBlobRef(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value.type === "blob" &&
+        typeof value.id === "string" &&
+        typeof value.size === "number" &&
+        typeof value.contentType === "string");
+}
+export const BLOB_REF_SCHEMA = {
+    type: "object",
+    title: "BlobRef",
+    properties: {
+        type: { const: "blob" },
+        id: { type: "string" },
+        size: { type: "integer", minimum: 0 },
+        contentType: { type: "string" },
+        url: { type: "string" },
+        digest: { type: "string" }
+    },
+    required: ["type", "id", "size", "contentType"],
+    additionalProperties: false
+};
+//# sourceMappingURL=blob.js.map

package/vendor/@appport/protocol/dist/blob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob.js","sourceRoot":"","sources":["../src/blob.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAiB,CAAC,IAAI,KAAK,MAAM;QAClC,OAAQ,KAAiB,CAAC,EAAE,KAAK,QAAQ;QACzC,OAAQ,KAAiB,CAAC,IAAI,KAAK,QAAQ;QAC3C,OAAQ,KAAiB,CAAC,WAAW,KAAK,QAAQ,CACnD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,SAAS;IAChB,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;QACvB,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACtB,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QACrC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC/B,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACvB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC3B;IACD,QAAQ,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC;IAC/C,oBAAoB,EAAE,KAAK;CACnB,CAAC"}

package/vendor/@appport/protocol/dist/compatibility.d.ts

@@ -0,0 +1,25 @@
+import type { AppPortManifest } from "./manifest.js";
+/**
+ * Backwards-compatibility analysis (specification §43).
+ *
+ * Adding an optional field, adding a capability or adding a capability version
+ * is non-breaking. Removing a required field, removing a capability version,
+ * changing a field's type, or tightening authorization is breaking.
+ */
+export type ChangeSeverity = "breaking" | "non-breaking";
+export interface ManifestChange {
+    severity: ChangeSeverity;
+    /** Machine-readable change kind, e.g. `capability.removed`. */
+    kind: string;
+    /** Where the change applies, e.g. `documents.save@1 input.content`. */
+    target: string;
+    message: string;
+}
+export interface CompatibilityReport {
+    compatible: boolean;
+    breaking: ManifestChange[];
+    nonBreaking: ManifestChange[];
+}
+/** Compares two manifests and classifies every difference. */
+export declare function compareManifests(previous: AppPortManifest, next: AppPortManifest): CompatibilityReport;
+//# sourceMappingURL=compatibility.d.ts.map

package/vendor/@appport/protocol/dist/compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../src/compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAA0B,MAAM,eAAe,CAAC;AAG7E;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,cAAc,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,cAAc,CAAC;IACzB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AA+HD,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,GAAG,mBAAmB,CAwFtG"}

package/vendor/@appport/protocol/dist/compatibility.js

@@ -0,0 +1,189 @@
+function typesOf(schema) {
+    if (!schema?.type)
+        return [];
+    return Array.isArray(schema.type) ? [...schema.type].sort() : [schema.type];
+}
+function sameType(a, b) {
+    const ta = typesOf(a);
+    const tb = typesOf(b);
+    if (ta.length !== tb.length)
+        return false;
+    return ta.every((t, i) => t === tb[i]);
+}
+function compareSchema(previous, next, target, direction, changes) {
+    if (!sameType(previous, next)) {
+        changes.push({
+            severity: "breaking",
+            kind: `${direction}.type-changed`,
+            target,
+            message: `type changed from ${typesOf(previous).join("|") || "any"} to ${typesOf(next).join("|") || "any"}`
+        });
+        return;
+    }
+    const previousProps = previous.properties ?? {};
+    const nextProps = next.properties ?? {};
+    const previousRequired = new Set(previous.required ?? []);
+    const nextRequired = new Set(next.required ?? []);
+    for (const [key, schema] of Object.entries(previousProps)) {
+        const nextSchema = nextProps[key];
+        if (!nextSchema) {
+            // Removing an input field the client may still send is tolerated for
+            // inputs only when it was optional; removing output fields is breaking.
+            const wasRequired = previousRequired.has(key);
+            changes.push({
+                severity: direction === "output" || wasRequired ? "breaking" : "non-breaking",
+                kind: `${direction}.field-removed`,
+                target: `${target}.${key}`,
+                message: `field "${key}" was removed`
+            });
+            continue;
+        }
+        compareSchema(schema, nextSchema, `${target}.${key}`, direction, changes);
+    }
+    for (const key of Object.keys(nextProps)) {
+        if (previousProps[key])
+            continue;
+        const required = nextRequired.has(key);
+        if (direction === "input") {
+            changes.push({
+                severity: required ? "breaking" : "non-breaking",
+                kind: "input.field-added",
+                target: `${target}.${key}`,
+                message: required ? `required field "${key}" was added` : `optional field "${key}" was added`
+            });
+        }
+        else {
+            changes.push({
+                severity: "non-breaking",
+                kind: "output.field-added",
+                target: `${target}.${key}`,
+                message: `field "${key}" was added`
+            });
+        }
+    }
+    for (const key of nextRequired) {
+        if (!previousRequired.has(key) && previousProps[key] && direction === "input") {
+            changes.push({
+                severity: "breaking",
+                kind: "input.field-now-required",
+                target: `${target}.${key}`,
+                message: `optional field "${key}" is now required`
+            });
+        }
+    }
+    for (const key of previousRequired) {
+        if (!nextRequired.has(key) && nextProps[key] && direction === "output") {
+            changes.push({
+                severity: "breaking",
+                kind: "output.field-now-optional",
+                target: `${target}.${key}`,
+                message: `guaranteed field "${key}" is no longer required`
+            });
+        }
+    }
+}
+function compareVersion(name, previous, next, changes) {
+    const target = `${name}@${previous.version}`;
+    if (previous.kind !== next.kind) {
+        changes.push({
+            severity: "breaking",
+            kind: "capability.kind-changed",
+            target,
+            message: `kind changed from ${previous.kind} to ${next.kind}`
+        });
+    }
+    compareSchema(previous.inputSchema, next.inputSchema, `${target} input`, "input", changes);
+    compareSchema(previous.outputSchema, next.outputSchema, `${target} output`, "output", changes);
+    const previousPermissions = new Set(previous.authorization);
+    for (const permission of next.authorization) {
+        if (!previousPermissions.has(permission)) {
+            changes.push({
+                severity: "breaking",
+                kind: "capability.authorization-tightened",
+                target,
+                message: `now requires permission "${permission}"`
+            });
+        }
+    }
+}
+/** Compares two manifests and classifies every difference. */
+export function compareManifests(previous, next) {
+    const changes = [];
+    const nextCapabilities = new Map(next.capabilities.map((entry) => [entry.name, entry]));
+    for (const previousEntry of previous.capabilities) {
+        const nextEntry = nextCapabilities.get(previousEntry.name);
+        if (!nextEntry) {
+            changes.push({
+                severity: "breaking",
+                kind: "capability.removed",
+                target: previousEntry.name,
+                message: `capability "${previousEntry.name}" was removed`
+            });
+            continue;
+        }
+        const nextVersions = new Map(nextEntry.definitions.map((d) => [d.version, d]));
+        for (const previousVersion of previousEntry.definitions) {
+            const nextVersion = nextVersions.get(previousVersion.version);
+            if (!nextVersion) {
+                changes.push({
+                    severity: "breaking",
+                    kind: "capability.version-removed",
+                    target: `${previousEntry.name}@${previousVersion.version}`,
+                    message: `version ${previousVersion.version} was removed`
+                });
+                continue;
+            }
+            compareVersion(previousEntry.name, previousVersion, nextVersion, changes);
+        }
+        for (const nextVersion of nextEntry.definitions) {
+            if (!previousEntry.definitions.some((d) => d.version === nextVersion.version)) {
+                changes.push({
+                    severity: "non-breaking",
+                    kind: "capability.version-added",
+                    target: `${nextEntry.name}@${nextVersion.version}`,
+                    message: `version ${nextVersion.version} was added`
+                });
+            }
+        }
+    }
+    const previousCapabilities = new Set(previous.capabilities.map((entry) => entry.name));
+    for (const entry of next.capabilities) {
+        if (!previousCapabilities.has(entry.name)) {
+            changes.push({
+                severity: "non-breaking",
+                kind: "capability.added",
+                target: entry.name,
+                message: `capability "${entry.name}" was added`
+            });
+        }
+    }
+    const nextEvents = new Map(next.events.map((entry) => [entry.name, entry]));
+    for (const previousEvent of previous.events) {
+        const nextEvent = nextEvents.get(previousEvent.name);
+        if (!nextEvent) {
+            changes.push({
+                severity: "breaking",
+                kind: "event.removed",
+                target: previousEvent.name,
+                message: `event "${previousEvent.name}" was removed`
+            });
+            continue;
+        }
+        compareSchema(previousEvent.payloadSchema, nextEvent.payloadSchema, `${previousEvent.name} payload`, "output", changes);
+    }
+    const previousEvents = new Set(previous.events.map((entry) => entry.name));
+    for (const entry of next.events) {
+        if (!previousEvents.has(entry.name)) {
+            changes.push({
+                severity: "non-breaking",
+                kind: "event.added",
+                target: entry.name,
+                message: `event "${entry.name}" was added`
+            });
+        }
+    }
+    const breaking = changes.filter((change) => change.severity === "breaking");
+    const nonBreaking = changes.filter((change) => change.severity === "non-breaking");
+    return { compatible: breaking.length === 0, breaking, nonBreaking };
+}
+//# sourceMappingURL=compatibility.js.map

package/vendor/@appport/protocol/dist/compatibility.js.map

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

package/vendor/@appport/protocol/dist/envelopes.d.ts

@@ -0,0 +1,175 @@
+import type { AppErrorObject, JsonValue } from "./errors.js";
+import { type ProtocolId } from "./version.js";
+/** A capability reference: name plus the requested capability version (§42). */
+export interface CapabilityRef {
+    name: string;
+    version: number;
+}
+/**
+ * Transport-neutral request metadata (§10).
+ *
+ * Metadata never carries transport primitives (HTTP headers, IPC handles).
+ * A transport MAY populate `transport` and `receivedAt`; everything else is
+ * supplied by the application.
+ */
+export interface RequestMetadata {
+    /** Kind of the transport that carried the request, e.g. `http`, `ipc`. */
+    transport?: string;
+    /** ISO-8601 timestamp assigned when the server accepted the envelope. */
+    receivedAt?: string;
+    /** BCP-47 locale hint. */
+    locale?: string;
+    /** Free-form, non-sensitive application metadata. */
+    attributes?: Record<string, JsonValue>;
+}
+/** Fields shared by every envelope. */
+export interface EnvelopeBase {
+    protocol: ProtocolId;
+    type: EnvelopeType;
+    /** Correlation identifier propagated across process boundaries (§54). */
+    traceId?: string;
+    /** Namespaced protocol extensions (§71). Unknown extensions are ignored. */
+    extensions?: Record<string, JsonValue>;
+}
+export declare const ENVELOPE_TYPES: readonly ["request", "response", "event", "subscribe", "unsubscribe", "stream.request", "stream.start", "stream.chunk", "stream.end", "stream.cancel"];
+export type EnvelopeType = (typeof ENVELOPE_TYPES)[number];
+/** Request → response (§11). */
+export interface AppRequest<Input = unknown> extends EnvelopeBase {
+    type: "request";
+    requestId: string;
+    capability: CapabilityRef;
+    input: Input;
+    /** Deduplication key for mutating capabilities (§44). */
+    idempotencyKey?: string;
+    /** Client-requested deadline in milliseconds (§46). Servers MAY clamp it. */
+    timeoutMs?: number;
+    metadata?: RequestMetadata;
+}
+/** Request → sequence of values (§20). Same shape as {@link AppRequest}. */
+export interface AppStreamRequest<Input = unknown> extends Omit<AppRequest<Input>, "type"> {
+    type: "stream.request";
+}
+export interface AppSuccessResponse<Output = unknown> extends EnvelopeBase {
+    type: "response";
+    requestId: string;
+    ok: true;
+    output: Output;
+}
+export interface AppErrorResponse extends EnvelopeBase {
+    type: "response";
+    requestId: string;
+    ok: false;
+    error: AppErrorObject;
+}
+export type AppResponse<Output = unknown> = AppSuccessResponse<Output> | AppErrorResponse;
+/** Publisher → subscribers (§17). Events are one-way and never answered. */
+export interface AppEventEnvelope<Payload = unknown> extends EnvelopeBase {
+    type: "event";
+    event: CapabilityRef;
+    eventId: string;
+    /** ISO-8601 timestamp of publication. */
+    timestamp: string;
+    payload: Payload;
+    /** Set when the event is delivered against a specific subscription (§18). */
+    subscriptionId?: string;
+}
+/** Client → server subscription control (§18). */
+export interface AppSubscribeRequest extends EnvelopeBase {
+    type: "subscribe";
+    requestId: string;
+    subscriptionId: string;
+    /** Event name, or `*` for every event the session may observe. */
+    event: {
+        name: string;
+        version?: number;
+    };
+}
+export interface AppUnsubscribeRequest extends EnvelopeBase {
+    type: "unsubscribe";
+    requestId: string;
+    subscriptionId: string;
+}
+export interface AppStreamStart extends EnvelopeBase {
+    type: "stream.start";
+    requestId: string;
+    streamId: string;
+}
+export interface AppStreamChunk<Payload = unknown> extends EnvelopeBase {
+    type: "stream.chunk";
+    streamId: string;
+    /** Zero-based, strictly increasing within a stream. */
+    sequence: number;
+    payload: Payload;
+}
+export interface AppStreamEnd extends EnvelopeBase {
+    type: "stream.end";
+    streamId: string;
+    /** Present when the stream terminated abnormally (`STREAM_ERROR`, `CANCELLED`). */
+    error?: AppErrorObject;
+}
+/** Client → server stream cancellation (§21). */
+export interface AppStreamCancel extends EnvelopeBase {
+    type: "stream.cancel";
+    streamId: string;
+    reason?: string;
+}
+export type AppEnvelope = AppRequest | AppStreamRequest | AppResponse | AppEventEnvelope | AppSubscribeRequest | AppUnsubscribeRequest | AppStreamStart | AppStreamChunk | AppStreamEnd | AppStreamCancel;
+/** Envelopes a client sends to a server. */
+export type ClientEnvelope = AppRequest | AppStreamRequest | AppSubscribeRequest | AppUnsubscribeRequest | AppStreamCancel;
+/** Envelopes a server sends to a client. */
+export type ServerEnvelope = AppResponse | AppEventEnvelope | AppStreamStart | AppStreamChunk | AppStreamEnd;
+export interface CreateRequestOptions {
+    requestId: string;
+    capability: CapabilityRef;
+    input: unknown;
+    idempotencyKey?: string;
+    timeoutMs?: number;
+    traceId?: string;
+    metadata?: RequestMetadata;
+    extensions?: Record<string, JsonValue>;
+}
+export declare function createRequest(options: CreateRequestOptions): AppRequest;
+export declare function createStreamRequest(options: CreateRequestOptions): AppStreamRequest;
+export declare function createSuccessResponse<Output>(requestId: string, output: Output, extra?: {
+    traceId?: string;
+    extensions?: Record<string, JsonValue>;
+}): AppSuccessResponse<Output>;
+export declare function createErrorResponse(requestId: string, error: AppErrorObject, extra?: {
+    traceId?: string;
+    extensions?: Record<string, JsonValue>;
+}): AppErrorResponse;
+export declare function createEvent<Payload>(options: {
+    name: string;
+    version: number;
+    eventId: string;
+    payload: Payload;
+    timestamp?: string;
+    subscriptionId?: string;
+    traceId?: string;
+    extensions?: Record<string, JsonValue>;
+}): AppEventEnvelope<Payload>;
+export declare function createStreamStart(requestId: string, streamId: string, traceId?: string): AppStreamStart;
+export declare function createStreamChunk<Payload>(streamId: string, sequence: number, payload: Payload): AppStreamChunk<Payload>;
+export declare function createStreamEnd(streamId: string, error?: AppErrorObject): AppStreamEnd;
+export declare function createStreamCancel(streamId: string, reason?: string): AppStreamCancel;
+export declare function createSubscribe(requestId: string, subscriptionId: string, event: {
+    name: string;
+    version?: number;
+}): AppSubscribeRequest;
+export declare function createUnsubscribe(requestId: string, subscriptionId: string): AppUnsubscribeRequest;
+declare function isEnvelopeLike(value: unknown): value is EnvelopeBase;
+export declare const isEnvelope: typeof isEnvelopeLike;
+export declare const isRequest: (v: unknown) => v is AppRequest;
+export declare const isStreamRequest: (v: unknown) => v is AppStreamRequest;
+export declare const isResponse: (v: unknown) => v is AppResponse;
+export declare const isEventEnvelope: (v: unknown) => v is AppEventEnvelope;
+export declare const isSubscribeRequest: (v: unknown) => v is AppSubscribeRequest;
+export declare const isUnsubscribeRequest: (v: unknown) => v is AppUnsubscribeRequest;
+export declare const isStreamStart: (v: unknown) => v is AppStreamStart;
+export declare const isStreamChunk: (v: unknown) => v is AppStreamChunk;
+export declare const isStreamEnd: (v: unknown) => v is AppStreamEnd;
+export declare const isStreamCancel: (v: unknown) => v is AppStreamCancel;
+export declare const isSuccessResponse: <O>(v: AppResponse<O>) => v is AppSuccessResponse<O>;
+export declare const isErrorResponse: (v: AppResponse<unknown>) => v is AppErrorResponse;
+export {};
+//# sourceMappingURL=envelopes.d.ts.map

package/vendor/@appport/protocol/dist/envelopes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelopes.d.ts","sourceRoot":"","sources":["../src/envelopes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE5D,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACxC;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,UAAU,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACxC;AAED,eAAO,MAAM,cAAc,wJAWjB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,gCAAgC;AAChC,MAAM,WAAW,UAAU,CAAC,KAAK,GAAG,OAAO,CAAE,SAAQ,YAAY;IAC/D,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,aAAa,CAAC;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,4EAA4E;AAC5E,MAAM,WAAW,gBAAgB,CAAC,KAAK,GAAG,OAAO,CAAE,SAAQ,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxF,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB,CAAC,MAAM,GAAG,OAAO,CAAE,SAAQ,YAAY;IACxE,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,cAAc,CAAC;CACvB;AAED,MAAM,MAAM,WAAW,CAAC,MAAM,GAAG,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,GAAG,gBAAgB,CAAC;AAE1F,4EAA4E;AAC5E,MAAM,WAAW,gBAAgB,CAAC,OAAO,GAAG,OAAO,CAAE,SAAQ,YAAY;IACvE,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,kDAAkD;AAClD,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc,CAAC,OAAO,GAAG,OAAO,CAAE,SAAQ,YAAY;IACrE,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,WAAW,GACnB,UAAU,GACV,gBAAgB,GAChB,WAAW,GACX,gBAAgB,GAChB,mBAAmB,GACnB,qBAAqB,GACrB,cAAc,GACd,cAAc,GACd,YAAY,GACZ,eAAe,CAAC;AAEpB,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,gBAAgB,GAChB,mBAAmB,GACnB,qBAAqB,GACrB,eAAe,CAAC;AAEpB,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,gBAAgB,GAChB,cAAc,GACd,cAAc,GACd,YAAY,CAAC;AAMjB,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,aAAa,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACxC;AASD,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU,CAiBvE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,gBAAgB,CAEnF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAC1C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CAAO,GACvE,kBAAkB,CAAC,MAAM,CAAC,CAK5B;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,cAAc,EACrB,KAAK,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CAAO,GACvE,gBAAgB,CAKlB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACxC,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAY5B;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,CAIvG;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EACvC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,GACf,cAAc,CAAC,OAAO,CAAC,CAEzB;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,cAAc,GAAG,YAAY,CAEtF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAErF;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,mBAAmB,CAErB;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,qBAAqB,CAElG;AAMD,iBAAS,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAO7D;AAED,eAAO,MAAM,UAAU,uBAAiB,CAAC;AAEzC,eAAO,MAAM,SAAS,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,UAAuD,CAAC;AACpG,eAAO,MAAM,eAAe,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,gBACA,CAAC;AACnD,eAAO,MAAM,UAAU,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,WAAyD,CAAC;AACvG,eAAO,MAAM,eAAe,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,gBAA2D,CAAC;AAC9G,eAAO,MAAM,kBAAkB,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,mBACR,CAAC;AAC9C,eAAO,MAAM,oBAAoB,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,qBACR,CAAC;AAChD,eAAO,MAAM,aAAa,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,cAAgE,CAAC;AACjH,eAAO,MAAM,aAAa,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,cAAgE,CAAC;AACjH,eAAO,MAAM,WAAW,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,YAA4D,CAAC;AAC3G,eAAO,MAAM,cAAc,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,eAAkE,CAAC;AAEpH,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,KAAG,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAkB,CAAC;AACrG,eAAO,MAAM,eAAe,GAAI,GAAG,WAAW,CAAC,OAAO,CAAC,KAAG,CAAC,IAAI,gBAAkC,CAAC"}

package/vendor/@appport/protocol/dist/envelopes.js

@@ -0,0 +1,97 @@
+import { PROTOCOL_ID } from "./version.js";
+export const ENVELOPE_TYPES = [
+    "request",
+    "response",
+    "event",
+    "subscribe",
+    "unsubscribe",
+    "stream.request",
+    "stream.start",
+    "stream.chunk",
+    "stream.end",
+    "stream.cancel"
+];
+function withOptional(base, optional) {
+    for (const [key, value] of Object.entries(optional)) {
+        if (value !== undefined)
+            base[key] = value;
+    }
+    return base;
+}
+export function createRequest(options) {
+    return withOptional({
+        protocol: PROTOCOL_ID,
+        type: "request",
+        requestId: options.requestId,
+        capability: options.capability,
+        input: options.input
+    }, {
+        idempotencyKey: options.idempotencyKey,
+        timeoutMs: options.timeoutMs,
+        traceId: options.traceId,
+        metadata: options.metadata,
+        extensions: options.extensions
+    });
+}
+export function createStreamRequest(options) {
+    return { ...createRequest(options), type: "stream.request" };
+}
+export function createSuccessResponse(requestId, output, extra = {}) {
+    return withOptional({ protocol: PROTOCOL_ID, type: "response", requestId, ok: true, output }, extra);
+}
+export function createErrorResponse(requestId, error, extra = {}) {
+    return withOptional({ protocol: PROTOCOL_ID, type: "response", requestId, ok: false, error }, extra);
+}
+export function createEvent(options) {
+    return withOptional({
+        protocol: PROTOCOL_ID,
+        type: "event",
+        event: { name: options.name, version: options.version },
+        eventId: options.eventId,
+        timestamp: options.timestamp ?? new Date().toISOString(),
+        payload: options.payload
+    }, { subscriptionId: options.subscriptionId, traceId: options.traceId, extensions: options.extensions });
+}
+export function createStreamStart(requestId, streamId, traceId) {
+    return withOptional({ protocol: PROTOCOL_ID, type: "stream.start", requestId, streamId }, {
+        traceId
+    });
+}
+export function createStreamChunk(streamId, sequence, payload) {
+    return { protocol: PROTOCOL_ID, type: "stream.chunk", streamId, sequence, payload };
+}
+export function createStreamEnd(streamId, error) {
+    return withOptional({ protocol: PROTOCOL_ID, type: "stream.end", streamId }, { error });
+}
+export function createStreamCancel(streamId, reason) {
+    return withOptional({ protocol: PROTOCOL_ID, type: "stream.cancel", streamId }, { reason });
+}
+export function createSubscribe(requestId, subscriptionId, event) {
+    return { protocol: PROTOCOL_ID, type: "subscribe", requestId, subscriptionId, event };
+}
+export function createUnsubscribe(requestId, subscriptionId) {
+    return { protocol: PROTOCOL_ID, type: "unsubscribe", requestId, subscriptionId };
+}
+// ---------------------------------------------------------------------------
+// Guards
+// ---------------------------------------------------------------------------
+function isEnvelopeLike(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value.protocol === PROTOCOL_ID &&
+        typeof value.type === "string");
+}
+export const isEnvelope = isEnvelopeLike;
+export const isRequest = (v) => isEnvelopeLike(v) && v.type === "request";
+export const isStreamRequest = (v) => isEnvelopeLike(v) && v.type === "stream.request";
+export const isResponse = (v) => isEnvelopeLike(v) && v.type === "response";
+export const isEventEnvelope = (v) => isEnvelopeLike(v) && v.type === "event";
+export const isSubscribeRequest = (v) => isEnvelopeLike(v) && v.type === "subscribe";
+export const isUnsubscribeRequest = (v) => isEnvelopeLike(v) && v.type === "unsubscribe";
+export const isStreamStart = (v) => isEnvelopeLike(v) && v.type === "stream.start";
+export const isStreamChunk = (v) => isEnvelopeLike(v) && v.type === "stream.chunk";
+export const isStreamEnd = (v) => isEnvelopeLike(v) && v.type === "stream.end";
+export const isStreamCancel = (v) => isEnvelopeLike(v) && v.type === "stream.cancel";
+export const isSuccessResponse = (v) => v.ok === true;
+export const isErrorResponse = (v) => v.ok === false;
+//# sourceMappingURL=envelopes.js.map

package/vendor/@appport/protocol/dist/envelopes.js.map

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