@appport/sdk 1.0.1

package/node_modules/@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/node_modules/@appport/protocol/dist/envelopes.d.ts.map

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

package/node_modules/@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/node_modules/@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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"}

package/node_modules/@appport/protocol/dist/errors.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Standard AppPort error codes (specification §15).
+ *
+ * Implementations MAY define extension codes; extension codes MUST be
+ * namespaced (`feltdb.CAUSAL_TIMEOUT`).
+ */
+export declare const ERROR_CODES: readonly ["INVALID_PROTOCOL", "UNSUPPORTED_VERSION", "INVALID_REQUEST", "INVALID_INPUT", "UNKNOWN_CAPABILITY", "UNSUPPORTED_CAPABILITY_VERSION", "UNAUTHORIZED", "FORBIDDEN", "NOT_FOUND", "CONFLICT", "RATE_LIMITED", "TIMEOUT", "CANCELLED", "PAYLOAD_TOO_LARGE", "STREAM_ERROR", "INTERNAL_ERROR"];
+export type StandardErrorCode = (typeof ERROR_CODES)[number];
+/** A standard code, or a namespaced extension code such as `feltdb.CAUSAL_TIMEOUT`. */
+export type ErrorCode = StandardErrorCode | (string & {});
+export declare function isStandardErrorCode(code: unknown): code is StandardErrorCode;
+export declare function isExtensionErrorCode(code: unknown): boolean;
+export declare function isErrorCode(code: unknown): code is ErrorCode;
+/** The wire representation of a failure. */
+export interface AppErrorObject {
+    code: ErrorCode;
+    message: string;
+    /**
+     * Optional structured, non-sensitive detail (for example the list of input
+     * fields that failed validation). Never carries stack traces, filesystem
+     * paths, credentials or raw driver errors (specification §16).
+     */
+    details?: JsonValue;
+    /** Hint that the same request may succeed if retried. */
+    retryable?: boolean;
+}
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/**
+ * An error that carries an AppPort error code across the dispatch pipeline.
+ *
+ * Handlers throw `AppPortError` to produce a specific protocol error; any other
+ * thrown value is sanitized into `INTERNAL_ERROR`.
+ */
+export declare class AppPortError extends Error {
+    readonly code: ErrorCode;
+    readonly details?: JsonValue;
+    readonly retryable: boolean;
+    /** Detail retained for logs/telemetry but never serialized onto the wire. */
+    readonly internal?: unknown;
+    constructor(code: ErrorCode, message: string, options?: {
+        details?: JsonValue;
+        retryable?: boolean;
+        cause?: unknown;
+        internal?: unknown;
+    });
+    toErrorObject(): AppErrorObject;
+    static is(value: unknown): value is AppPortError;
+}
+/** Convenience constructors for the standard codes. */
+export declare const errors: {
+    readonly invalidProtocol: (message?: string, details?: JsonValue) => AppPortError;
+    readonly unsupportedVersion: (message?: string, details?: JsonValue) => AppPortError;
+    readonly invalidRequest: (message?: string, details?: JsonValue) => AppPortError;
+    readonly invalidInput: (message?: string, details?: JsonValue) => AppPortError;
+    readonly unknownCapability: (name: string) => AppPortError;
+    readonly unsupportedCapabilityVersion: (name: string, version: number, supported: number[]) => AppPortError;
+    readonly unauthorized: (message?: string) => AppPortError;
+    readonly forbidden: (message?: string, details?: JsonValue) => AppPortError;
+    readonly notFound: (message?: string, details?: JsonValue) => AppPortError;
+    readonly conflict: (message?: string, details?: JsonValue) => AppPortError;
+    readonly rateLimited: (message?: string, details?: JsonValue) => AppPortError;
+    readonly timeout: (message?: string, details?: JsonValue) => AppPortError;
+    readonly cancelled: (message?: string) => AppPortError;
+    readonly payloadTooLarge: (message?: string, details?: JsonValue) => AppPortError;
+    readonly streamError: (message?: string, details?: JsonValue) => AppPortError;
+    readonly internal: (message?: string, options?: {
+        cause?: unknown;
+        internal?: unknown;
+    }) => AppPortError;
+};
+//# sourceMappingURL=errors.d.ts.map

package/node_modules/@appport/protocol/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,WAAW,uSAiBd,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,uFAAuF;AACvF,MAAM,MAAM,SAAS,GAAG,iBAAiB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAI1D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,iBAAiB,CAE5E;AAQD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAE3D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,SAAS,CAE5D;AAED,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEnF;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;gBAG1B,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO;IAUjG,aAAa,IAAI,cAAc;IAO/B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY;CAGjD;AAED,uDAAuD;AACvD,eAAO,MAAM,MAAM;2DACgE,SAAS;8DAEjB,SAAS;0DAEhB,SAAS;wDAEF,SAAS;uCAExD,MAAM;kDAEK,MAAM,WAAW,MAAM,aAAa,MAAM,EAAE;;qDAOjB,SAAS;oDAEpB,SAAS;oDAEV,SAAS;uDACJ,SAAS;mDAEf,SAAS;;2DAGkB,SAAS;uDAEpC,SAAS;oDAEZ;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE;CAE/E,CAAC"}

package/node_modules/@appport/protocol/dist/errors.js

@@ -0,0 +1,91 @@
+/**
+ * Standard AppPort error codes (specification §15).
+ *
+ * Implementations MAY define extension codes; extension codes MUST be
+ * namespaced (`feltdb.CAUSAL_TIMEOUT`).
+ */
+export const ERROR_CODES = [
+    "INVALID_PROTOCOL",
+    "UNSUPPORTED_VERSION",
+    "INVALID_REQUEST",
+    "INVALID_INPUT",
+    "UNKNOWN_CAPABILITY",
+    "UNSUPPORTED_CAPABILITY_VERSION",
+    "UNAUTHORIZED",
+    "FORBIDDEN",
+    "NOT_FOUND",
+    "CONFLICT",
+    "RATE_LIMITED",
+    "TIMEOUT",
+    "CANCELLED",
+    "PAYLOAD_TOO_LARGE",
+    "STREAM_ERROR",
+    "INTERNAL_ERROR"
+];
+const STANDARD = new Set(ERROR_CODES);
+export function isStandardErrorCode(code) {
+    return typeof code === "string" && STANDARD.has(code);
+}
+/**
+ * Extension error codes are `<namespace>.<CODE>` where the namespace is a
+ * lowercase dotted identifier and the code is upper snake case.
+ */
+const EXTENSION_CODE = /^[a-z][a-z0-9]*(\.[a-z0-9]+)*\.[A-Z][A-Z0-9_]*$/;
+export function isExtensionErrorCode(code) {
+    return typeof code === "string" && EXTENSION_CODE.test(code);
+}
+export function isErrorCode(code) {
+    return isStandardErrorCode(code) || isExtensionErrorCode(code);
+}
+/**
+ * An error that carries an AppPort error code across the dispatch pipeline.
+ *
+ * Handlers throw `AppPortError` to produce a specific protocol error; any other
+ * thrown value is sanitized into `INTERNAL_ERROR`.
+ */
+export class AppPortError extends Error {
+    code;
+    details;
+    retryable;
+    /** Detail retained for logs/telemetry but never serialized onto the wire. */
+    internal;
+    constructor(code, message, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = "AppPortError";
+        this.code = code;
+        this.details = options.details;
+        this.retryable = options.retryable ?? false;
+        this.internal = options.internal;
+    }
+    toErrorObject() {
+        const error = { code: this.code, message: this.message };
+        if (this.details !== undefined)
+            error.details = this.details;
+        if (this.retryable)
+            error.retryable = true;
+        return error;
+    }
+    static is(value) {
+        return value instanceof AppPortError;
+    }
+}
+/** Convenience constructors for the standard codes. */
+export const errors = {
+    invalidProtocol: (message = "Unsupported AppPort protocol identifier", details) => new AppPortError("INVALID_PROTOCOL", message, { details }),
+    unsupportedVersion: (message = "Unsupported protocol version", details) => new AppPortError("UNSUPPORTED_VERSION", message, { details }),
+    invalidRequest: (message = "Malformed AppPort request", details) => new AppPortError("INVALID_REQUEST", message, { details }),
+    invalidInput: (message = "Input failed capability validation", details) => new AppPortError("INVALID_INPUT", message, { details }),
+    unknownCapability: (name) => new AppPortError("UNKNOWN_CAPABILITY", `Unknown capability: ${name}`, { details: { capability: name } }),
+    unsupportedCapabilityVersion: (name, version, supported) => new AppPortError("UNSUPPORTED_CAPABILITY_VERSION", `Capability ${name} does not support version ${version}`, { details: { capability: name, requested: version, supported } }),
+    unauthorized: (message = "Authentication is required") => new AppPortError("UNAUTHORIZED", message),
+    forbidden: (message = "Capability is not authorized", details) => new AppPortError("FORBIDDEN", message, { details }),
+    notFound: (message = "Resource not found", details) => new AppPortError("NOT_FOUND", message, { details }),
+    conflict: (message = "Conflicting state", details) => new AppPortError("CONFLICT", message, { details }),
+    rateLimited: (message = "Rate limit exceeded", details) => new AppPortError("RATE_LIMITED", message, { details, retryable: true }),
+    timeout: (message = "Request timed out", details) => new AppPortError("TIMEOUT", message, { details, retryable: true }),
+    cancelled: (message = "Operation cancelled") => new AppPortError("CANCELLED", message),
+    payloadTooLarge: (message = "Payload exceeds the configured limit", details) => new AppPortError("PAYLOAD_TOO_LARGE", message, { details }),
+    streamError: (message = "Stream failed", details) => new AppPortError("STREAM_ERROR", message, { details }),
+    internal: (message = "Internal error", options = {}) => new AppPortError("INTERNAL_ERROR", message, options)
+};
+//# sourceMappingURL=errors.js.map

package/node_modules/@appport/protocol/dist/errors.js.map

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

package/node_modules/@appport/protocol/dist/ids.d.ts

@@ -0,0 +1,12 @@
+/** Generates a monotonic-ish ULID string (26 Crockford base32 characters). */
+export declare function ulid(now?: number): string;
+export type IdPrefix = "req" | "evt" | "str" | "sub" | "ses" | "op" | "trace" | "blob" | "idem";
+export declare function createId(prefix: IdPrefix): string;
+export declare const newRequestId: () => string;
+export declare const newEventId: () => string;
+export declare const newStreamId: () => string;
+export declare const newSubscriptionId: () => string;
+export declare const newSessionId: () => string;
+export declare const newOperationId: () => string;
+export declare const newTraceId: () => string;
+//# sourceMappingURL=ids.d.ts.map

package/node_modules/@appport/protocol/dist/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAqCA,8EAA8E;AAC9E,wBAAgB,IAAI,CAAC,GAAG,GAAE,MAAmB,GAAG,MAAM,CAErD;AAED,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhG,wBAAgB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAEjD;AAED,eAAO,MAAM,YAAY,QAAO,MAAyB,CAAC;AAC1D,eAAO,MAAM,UAAU,QAAO,MAAyB,CAAC;AACxD,eAAO,MAAM,WAAW,QAAO,MAAyB,CAAC;AACzD,eAAO,MAAM,iBAAiB,QAAO,MAAyB,CAAC;AAC/D,eAAO,MAAM,YAAY,QAAO,MAAyB,CAAC;AAC1D,eAAO,MAAM,cAAc,QAAO,MAAwB,CAAC;AAC3D,eAAO,MAAM,UAAU,QAAO,MAA2B,CAAC"}

package/node_modules/@appport/protocol/dist/ids.js

@@ -0,0 +1,50 @@
+/**
+ * Identifier helpers (specification §12).
+ *
+ * The protocol does not mandate ULID; any value unique within a session is
+ * valid. The reference implementation emits `<prefix>_<ULID>` because ULIDs
+ * sort lexicographically by creation time, which makes logs readable.
+ */
+const CROCKFORD = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+function randomBytes(length) {
+    const bytes = new Uint8Array(length);
+    const cryptoRef = globalThis.crypto;
+    if (cryptoRef && typeof cryptoRef.getRandomValues === "function") {
+        cryptoRef.getRandomValues(bytes);
+        return bytes;
+    }
+    for (let i = 0; i < length; i += 1)
+        bytes[i] = Math.floor(Math.random() * 256);
+    return bytes;
+}
+function encodeTime(time) {
+    let out = "";
+    let remaining = time;
+    for (let i = 0; i < 10; i += 1) {
+        out = CROCKFORD[remaining % 32] + out;
+        remaining = Math.floor(remaining / 32);
+    }
+    return out;
+}
+function encodeRandom() {
+    const bytes = randomBytes(16);
+    let out = "";
+    for (let i = 0; i < 16; i += 1)
+        out += CROCKFORD[bytes[i] % 32];
+    return out;
+}
+/** Generates a monotonic-ish ULID string (26 Crockford base32 characters). */
+export function ulid(now = Date.now()) {
+    return encodeTime(now) + encodeRandom();
+}
+export function createId(prefix) {
+    return `${prefix}_${ulid()}`;
+}
+export const newRequestId = () => createId("req");
+export const newEventId = () => createId("evt");
+export const newStreamId = () => createId("str");
+export const newSubscriptionId = () => createId("sub");
+export const newSessionId = () => createId("ses");
+export const newOperationId = () => createId("op");
+export const newTraceId = () => createId("trace");
+//# sourceMappingURL=ids.js.map

package/node_modules/@appport/protocol/dist/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,SAAS,GAAG,kCAAkC,CAAC;AAErD,SAAS,WAAW,CAAC,MAAc;IACjC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,SAAS,GAAuB,UAAU,CAAC,MAAM,CAAC;IACxD,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QACjE,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC;QAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;IAC/E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,GAAG,GAAG,SAAS,CAAC,SAAS,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC;QACtC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,YAAY;IACnB,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAC9B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC;QAAE,GAAG,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAE,GAAG,EAAE,CAAC,CAAC;IACjE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,IAAI,CAAC,MAAc,IAAI,CAAC,GAAG,EAAE;IAC3C,OAAO,UAAU,CAAC,GAAG,CAAC,GAAG,YAAY,EAAE,CAAC;AAC1C,CAAC;AAID,MAAM,UAAU,QAAQ,CAAC,MAAgB;IACvC,OAAO,GAAG,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,GAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC1D,MAAM,CAAC,MAAM,UAAU,GAAG,GAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,WAAW,GAAG,GAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,YAAY,GAAG,GAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC1D,MAAM,CAAC,MAAM,cAAc,GAAG,GAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,UAAU,GAAG,GAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC"}

package/node_modules/@appport/protocol/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `@appport/protocol` — the AppPort wire contract.
+ *
+ * This package is pure: envelope types, error codes, naming rules, manifest
+ * shapes and structural validation. It has no runtime dependencies and knows
+ * nothing about transports, servers or clients.
+ */
+export * from "./version.js";
+export * from "./errors.js";
+export * from "./names.js";
+export * from "./ids.js";
+export * from "./envelopes.js";
+export * from "./validate.js";
+export * from "./jsonschema.js";
+export * from "./manifest.js";
+export * from "./session.js";
+export * from "./blob.js";
+export * from "./operations.js";
+export * from "./compatibility.js";
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@appport/protocol/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}

package/node_modules/@appport/protocol/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * `@appport/protocol` — the AppPort wire contract.
+ *
+ * This package is pure: envelope types, error codes, naming rules, manifest
+ * shapes and structural validation. It has no runtime dependencies and knows
+ * nothing about transports, servers or clients.
+ */
+export * from "./version.js";
+export * from "./errors.js";
+export * from "./names.js";
+export * from "./ids.js";
+export * from "./envelopes.js";
+export * from "./validate.js";
+export * from "./jsonschema.js";
+export * from "./manifest.js";
+export * from "./session.js";
+export * from "./blob.js";
+export * from "./operations.js";
+export * from "./compatibility.js";
+//# sourceMappingURL=index.js.map

package/node_modules/@appport/protocol/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}