@tier0/sdk-v2 0.7.2 → 0.9.0

package/dist/esm/streams/contract.generated.js

@@ -0,0 +1,6 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export {};
+//# sourceMappingURL=contract.generated.js.map

package/dist/esm/streams/contract.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.generated.js","sourceRoot":"","sources":["../../../src/streams/contract.generated.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file was auto-generated by openapi-typescript.\n * Do not make direct changes to the file.\n */\n\nexport interface paths {\n    \"/openapi/v2/stream-requests/discover\": {\n        parameters: {\n            query?: never;\n            header?: never;\n            path?: never;\n            cookie?: never;\n        };\n        get?: never;\n        put?: never;\n        /**\n         * Discover Stream requests\n         * @description 发现可见Stream 请求合同，只公开Stream 请求合同，不返回内部运行绑定\n         */\n        post: operations[\"PlatformV2StreamRequestDiscover\"];\n        delete?: never;\n        options?: never;\n        head?: never;\n        patch?: never;\n        trace?: never;\n    };\n    \"/openapi/v2/stream-requests/{requestCode}/describe\": {\n        parameters: {\n            query?: never;\n            header?: never;\n            path?: never;\n            cookie?: never;\n        };\n        get?: never;\n        put?: never;\n        /**\n         * Describe Stream request\n         * @description 读取公开Stream 请求合同，只公开Stream 请求合同，不返回内部运行绑定\n         */\n        post: operations[\"PlatformV2StreamRequestDescribe\"];\n        delete?: never;\n        options?: never;\n        head?: never;\n        patch?: never;\n        trace?: never;\n    };\n    \"/openapi/v2/stream-requests/{requestCode}/invoke\": {\n        parameters: {\n            query?: never;\n            header?: never;\n            path?: never;\n            cookie?: never;\n        };\n        get?: never;\n        put?: never;\n        /**\n         * Invoke Stream request\n         * @description 按公开合同调用Stream 请求；原始 body 为有效 UTF-8，最多 1MiB 字节；可选 idempotencyKey 解码后最多 128 UTF-8 字节，是否必填由冻结合同决定。返回 code、contractVersion、result、runID、status、replayed(boolean)，不返回内部运行绑定。结果未知返回 HTTP 504，errorCode=STREAM_REQUEST_RESULT_UNKNOWN；未知内部错误返回 HTTP 500，errorCode=STREAM_REQUEST_INTERNAL_ERROR，message 不泄漏内部异常\n         */\n        post: operations[\"PlatformV2StreamRequestInvoke\"];\n        delete?: never;\n        options?: never;\n        head?: never;\n        patch?: never;\n        trace?: never;\n    };\n    \"/openapi/v2/stream-messages/connect\": {\n        parameters: {\n            query?: never;\n            header?: never;\n            path?: never;\n            cookie?: never;\n        };\n        get?: never;\n        put?: never;\n        /** Connect Stream messages */\n        post: operations[\"PlatformV2StreamMessagesConnect\"];\n        delete?: never;\n        options?: never;\n        head?: never;\n        patch?: never;\n        trace?: never;\n    };\n    \"/openapi/v2/capabilities/discover\": {\n        parameters: {\n            query?: never;\n            header?: never;\n            path?: never;\n            cookie?: never;\n        };\n        get?: never;\n        put?: never;\n        /**\n         * 发现当前 Workspace 的公开能力与版本合同\n         * @description 需要有效 Workspace API Key，Body 仅接受空 JSON 对象，最大 4KiB UTF-8 字节，不接受查询参数或 Workspace 覆盖。成功响应直接为 CapabilityDiscoverV2Resp，不包裹 code/msg/data。能力由默认关闭的公开发布开关、Workspace FeatureGate、Key 显式授权共同裁决；Namespace 与 Stream request 能力仅报告当前发布与授权，运行可用性保持 readiness_unknown，不触发运行时探针。Source/Stream 保留独立操作前提的证据。state=ready 不替代具体资源授权或实际运行回执。合同版本 2.0 使用 state、reasonCode、operations，不再返回重复布尔状态。实际操作由后端执行安全检查，失败返回真实错误。响应允许客户端忽略未知扩展字段；版本标签不表示设备 ACK 或 npm 包版本。错误直接返回 CapabilityErrorResp 和真实 HTTP 状态，不泄漏内部异常。\n         */\n        post: operations[\"PlatformV2CapabilityDiscoverV2\"];\n        delete?: never;\n        options?: never;\n        head?: never;\n        patch?: never;\n        trace?: never;\n    };\n}\nexport type webhooks = Record<string, never>;\nexport interface components {\n    schemas: {\n        StreamRequestDiscoverReq: {\n            /** @description 缺省为 1 */\n            page?: number;\n            search?: string;\n            /** @description 缺省为 20 */\n            size?: number;\n        };\n        StreamRequestDiscoverResp: {\n            list: components[\"schemas\"][\"PublicStreamRequest\"][];\n            total: number;\n        };\n        PublicStreamRequest: {\n            code: string;\n            contractVersion: string;\n            description: string;\n            idempotency: string;\n            inputSchema: {\n                [key: string]: unknown;\n            };\n            name: string;\n            outputSchema: {\n                [key: string]: unknown;\n            };\n            sideEffect: string;\n            status: string;\n            timeoutMs: number;\n        };\n        NotificationError: {\n            errorCode: string;\n            message: string;\n        };\n        StreamRequestInvokeReq: {\n            /** @description 解码后的 UTF-8 字节数最多 128；是否必填由冻结合同决定 */\n            idempotencyKey?: string;\n            input: unknown;\n        };\n        StreamRequestInvokeResp: {\n            code: string;\n            /** @description 实际执行使用的冻结合同版本 */\n            contractVersion: string;\n            /** @description true=幂等重放，false=首次执行 */\n            replayed: boolean;\n            /** @description 合同定义的 JSON 结果，允许 null */\n            result: unknown;\n            /** @description 服务端返回的执行标识，不透明字符串 */\n            runID: string;\n            /** @description 服务端返回的终态，非 accepted/queued/pending/running */\n            status: string;\n        };\n        StreamMessagesConnectReq: {\n            appId: string;\n            clientPublicKey: string;\n            topics: components[\"schemas\"][\"StreamMessageTopicPermission\"][];\n        };\n        StreamMessageTopicPermission: {\n            publish: boolean;\n            subscribe: boolean;\n            topic: string;\n        };\n        StreamMessagesConnectResp: {\n            contractVersion: string;\n            expiresAt: string;\n            maxPayloadBytes: number;\n            permissions: components[\"schemas\"][\"StreamMessageGrantedTopic\"][];\n            url: string;\n            userJwt: string;\n        };\n        StreamMessageGrantedTopic: {\n            publishSubject: string;\n            subscribeSubject: string;\n            topic: string;\n        };\n        /**\n         * Tier0 capability discovery 2.0\n         * @description OpenAPI 3.0 wire schema. Array contains/cardinality annotations and cross-field proof ordering require the shared JSON Schema plus SDK semantic checks; this projection alone is not full contract acceptance.\n         */\n        CapabilityDiscoverV2Resp: {\n            /** @enum {unknown} */\n            product: \"cloud\" | \"enterprise\";\n            productVersion?: string;\n            /** @enum {unknown} */\n            contractVersion: \"2.0\";\n            apiContractVersions: string[];\n            sdkContractVersions: string[];\n            capabilities: components[\"schemas\"][\"CapabilityDiscoverycapability\"][] & (unknown & unknown & unknown & unknown & unknown);\n            deprecations: {\n                contract: string;\n                replacement?: string;\n                sunsetAt?: string;\n            }[];\n        };\n        /** @description Unknown capability codes are ignored; only recognized codes use the frozen assessment contract. */\n        CapabilityDiscoverycapability: {\n            code: string;\n        } & (unknown | components[\"schemas\"][\"CapabilityDiscoveryknownCapability\"]);\n        /** @description State reports publication and assessed prerequisites only; ready never grants resource access or confirms an actual execution. */\n        CapabilityDiscoveryknownCapability: {\n            /** @enum {unknown} */\n            state: \"disabled\" | \"not_supported\" | \"unavailable\" | \"readiness_unknown\" | \"ready\";\n            reasonCode: string;\n            /** Format: date-time */\n            checkedAt?: string;\n            /**\n             * Format: date-time\n             * @description Proof expiry must follow checkedAt. Cross-field chronological ordering is a semantic constraint checked by consumers in addition to this structural JSON Schema.\n             */\n            validUntil?: string;\n            retryAfterMs?: number;\n            code: string;\n            contractVersions: string[];\n            operations?: components[\"schemas\"][\"CapabilityDiscoveryoperation\"][];\n        } & ((unknown | {\n            /** @enum {unknown} */\n            state?: \"ready\";\n            checkedAt: unknown;\n        }) & (unknown | ({\n            operations?: ((unknown | components[\"schemas\"][\"CapabilityDiscoveryknownOperation\"]) & (unknown | {\n                /** @enum {unknown} */\n                requiresResourceCheck?: true;\n            }))[] & (unknown & unknown & unknown & unknown & unknown & unknown);\n        } & (unknown | {\n            operations?: (unknown | {\n                /** @enum {unknown} */\n                state?: \"disabled\";\n            })[];\n        }))) & (unknown | ({\n            operations?: ((unknown | components[\"schemas\"][\"CapabilityDiscoveryknownOperation\"]) & (unknown | {\n                /** @enum {unknown} */\n                requiresResourceCheck?: true;\n            }))[] & (unknown & unknown & unknown & unknown & unknown & unknown);\n        } & (unknown | {\n            operations?: (unknown | {\n                /** @enum {unknown} */\n                state?: \"disabled\";\n            })[];\n        }))) & (unknown | {\n            contractVersions?: unknown[];\n        }) & (unknown | {\n            contractVersions?: unknown[] & (unknown & unknown);\n        }));\n        /** @description Unknown operation names are ignored within their parent capability; known names are validated by that capability. */\n        CapabilityDiscoveryoperation: {\n            operation: string;\n        };\n        /** @description State reports publication and assessed prerequisites only; ready never grants resource access or confirms an actual execution. */\n        CapabilityDiscoveryknownOperation: {\n            /** @enum {unknown} */\n            state: \"disabled\" | \"not_supported\" | \"unavailable\" | \"readiness_unknown\" | \"ready\";\n            reasonCode: string;\n            /** Format: date-time */\n            checkedAt?: string;\n            /**\n             * Format: date-time\n             * @description Proof expiry must follow checkedAt. Cross-field chronological ordering is a semantic constraint checked by consumers in addition to this structural JSON Schema.\n             */\n            validUntil?: string;\n            retryAfterMs?: number;\n            operation: string;\n            requiresResourceCheck: boolean;\n        } & (unknown | {\n            /** @enum {unknown} */\n            state?: \"ready\";\n            checkedAt: unknown;\n        });\n        CapabilityErrorResp: {\n            /** @description INVALID_CREDENTIAL / CAPABILITY_INVALID_REQUEST / CAPABILITY_FORBIDDEN / CAPABILITY_UNAVAILABLE / CAPABILITY_INTERNAL_ERROR */\n            errorCode: string;\n            /** @description 固定公开消息，不透传内部异常 */\n            message: string;\n        };\n    };\n    responses: never;\n    parameters: never;\n    requestBodies: never;\n    headers: never;\n    pathItems: never;\n}\nexport type $defs = Record<string, never>;\nexport interface operations {\n    PlatformV2StreamRequestDiscover: {\n        parameters: {\n            query?: never;\n            header?: never;\n            path?: never;\n            cookie?: never;\n        };\n        requestBody: {\n            content: {\n                \"application/json\": components[\"schemas\"][\"StreamRequestDiscoverReq\"];\n            };\n        };\n        responses: {\n            200: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"StreamRequestDiscoverResp\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            400: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            401: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            403: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            404: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            409: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            422: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            429: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            500: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            503: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            504: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n        };\n    };\n    PlatformV2StreamRequestDescribe: {\n        parameters: {\n            query?: never;\n            header?: never;\n            path: {\n                requestCode: string;\n            };\n            cookie?: never;\n        };\n        requestBody?: never;\n        responses: {\n            200: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"PublicStreamRequest\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            400: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            401: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            403: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            404: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            409: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            422: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            429: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            500: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            503: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            504: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n        };\n    };\n    PlatformV2StreamRequestInvoke: {\n        parameters: {\n            query?: never;\n            header?: never;\n            path: {\n                requestCode: string;\n            };\n            cookie?: never;\n        };\n        requestBody: {\n            content: {\n                \"application/json\": components[\"schemas\"][\"StreamRequestInvokeReq\"];\n            };\n        };\n        responses: {\n            200: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"StreamRequestInvokeResp\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            400: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            401: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            403: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            404: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            409: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            422: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            429: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            500: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            503: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            504: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n        };\n    };\n    PlatformV2StreamMessagesConnect: {\n        parameters: {\n            query?: never;\n            header?: never;\n            path?: never;\n            cookie?: never;\n        };\n        requestBody: {\n            content: {\n                \"application/json\": components[\"schemas\"][\"StreamMessagesConnectReq\"];\n            };\n        };\n        responses: {\n            200: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"StreamMessagesConnectResp\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            400: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            401: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            403: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            404: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            409: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            422: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            429: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            500: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            503: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            504: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"NotificationError\"];\n                };\n            };\n        };\n    };\n    PlatformV2CapabilityDiscoverV2: {\n        parameters: {\n            query?: never;\n            header?: never;\n            path?: never;\n            cookie?: never;\n        };\n        requestBody?: never;\n        responses: {\n            200: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"CapabilityDiscoverV2Resp\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            400: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"CapabilityErrorResp\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            401: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"CapabilityErrorResp\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            403: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"CapabilityErrorResp\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            500: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"CapabilityErrorResp\"];\n                };\n            };\n            /** @description Platform operation failed. */\n            503: {\n                headers: {\n                    [name: string]: unknown;\n                };\n                content: {\n                    \"application/json\": components[\"schemas\"][\"CapabilityErrorResp\"];\n                };\n            };\n        };\n    };\n}\n"]}

package/dist/esm/streams/index.d.ts

@@ -0,0 +1,3 @@
+export * from './requests.js';
+export * from './messages.js';
+export * from './capabilities.js';

package/dist/esm/streams/index.js

@@ -0,0 +1,4 @@
+export * from './requests.js';
+export * from './messages.js';
+export * from './capabilities.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/streams/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/streams/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC","sourcesContent":["export * from './requests.js';\nexport * from './messages.js';\nexport * from './capabilities.js';\n"]}

package/dist/esm/streams/messages.d.ts

@@ -0,0 +1,42 @@
+import type { StreamJSON } from './requests.js';
+import { StreamTransport } from './transport.js';
+export interface StreamMessage<Payload = StreamJSON> {
+    version: 'stream-messages/v1';
+    messageId: string;
+    correlationId?: string;
+    payload: Payload;
+}
+export interface StreamMessagePublishOptions {
+    messageId?: string;
+    correlationId?: string;
+}
+export interface StreamMessageSubscription {
+    readonly disposed: boolean;
+    dispose(): Promise<void>;
+}
+export type StreamMessageErrorHandler = (error: StreamMessageError) => void;
+export interface StreamMessageHandle<Payload = StreamJSON> {
+    /** Resolves after broker flush, not after receiver acknowledgement. No retry or offline queue. */
+    publish(payload: Payload, options?: StreamMessagePublishOptions): Promise<StreamMessage<Payload>>;
+    subscribe(handler: (message: StreamMessage<Payload>) => void | Promise<void>, options?: {
+        onError?: StreamMessageErrorHandler;
+    }): Promise<StreamMessageSubscription>;
+}
+export declare class StreamMessageError extends Error {
+    readonly errorCode: string;
+    readonly retryable = false;
+    constructor(errorCode: string, message: string);
+}
+export declare class StreamMessagesClient {
+    private readonly transport;
+    private sessions;
+    private listeners;
+    private disposed;
+    private disposing?;
+    constructor(transport?: StreamTransport);
+    onError(handler: StreamMessageErrorHandler): () => void;
+    use<Payload = StreamJSON>(selector: {
+        topic: string;
+    }): StreamMessageHandle<Payload>;
+    dispose(): Promise<void>;
+}

package/dist/esm/streams/messages.js

@@ -0,0 +1,475 @@
+import { getCurrentAppId } from '../runtime-context.js';
+import { onAppRuntimeDispose } from '../runtime.js';
+import { StreamTransport } from './transport.js';
+export class StreamMessageError extends Error {
+    errorCode;
+    retryable = false;
+    constructor(errorCode, message) {
+        super(message);
+        this.errorCode = errorCode;
+        this.name = 'StreamMessageError';
+    }
+}
+const encoder = new TextEncoder();
+const uuid = /^(?!00000000-0000-0000-0000-000000000000$)[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
+const MAX_PAYLOAD = 60 * 1024;
+const MAX_ENVELOPE = 64 * 1024;
+const MAX_FLUSH_TIMEOUT_MS = 10_000;
+function plain(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value) &&
+        [Object.prototype, null].includes(Object.getPrototypeOf(value));
+}
+function json(value, seen = new Set()) {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return true;
+    if (typeof value === 'number')
+        return Number.isFinite(value);
+    if ((!plain(value) && !Array.isArray(value)) || seen.has(value))
+        return false;
+    seen.add(value);
+    const valid = (Array.isArray(value) ? Array.from(value) : Object.values(value)).every(v => json(v, seen));
+    seen.delete(value);
+    return valid;
+}
+function fail(code, message) {
+    return new StreamMessageError(`STREAM_MESSAGE_${code}`, message);
+}
+function envelope(value, maxPayload) {
+    if (!plain(value) || Object.keys(value).some(k => !['version', 'messageId', 'correlationId', 'payload'].includes(k)) ||
+        value.version !== 'stream-messages/v1' || typeof value.messageId !== 'string' || !uuid.test(value.messageId) ||
+        (value.correlationId !== undefined && (typeof value.correlationId !== 'string' ||
+            encoder.encode(value.correlationId).length > 128 || /[\u0000\r\n]/.test(value.correlationId))) ||
+        !json(value.payload))
+        return false;
+    return encoder.encode(JSON.stringify(value.payload)).length <= maxPayload;
+}
+/** One permission-scoped session. Every connection gets a fresh key and JWT. */
+class MessageSession {
+    transport;
+    topic;
+    mode;
+    report;
+    remove;
+    handler;
+    disposed = false;
+    runtime;
+    connection;
+    subscription;
+    connecting;
+    watching;
+    abort = new AbortController();
+    reconnectTimer;
+    expiryTimer;
+    started = false;
+    connected = false;
+    attempts = 0;
+    subject = '';
+    payloadLimit = MAX_PAYLOAD;
+    expiresAt = 0;
+    brokerError;
+    disposing;
+    removeRuntimeListener;
+    constructor(transport, topic, mode, report, remove, handler) {
+        this.transport = transport;
+        this.topic = topic;
+        this.mode = mode;
+        this.report = report;
+        this.remove = remove;
+        this.handler = handler;
+        this.runtime = transport.runtime();
+        if (this.runtime)
+            this.removeRuntimeListener = onAppRuntimeDispose(this.runtime, () => { void this.dispose(); });
+    }
+    async ready() {
+        if (this.disposed)
+            throw fail('DISPOSED', 'Stream messages session disposed.');
+        if (this.connected)
+            return;
+        if (this.connecting)
+            return this.connecting;
+        if (this.started)
+            throw fail('DISCONNECTED', 'Stream messages disconnected.');
+        this.started = true;
+        try {
+            await this.connect();
+            if (this.disposed)
+                throw fail('DISPOSED', 'Stream messages session disposed.');
+        }
+        catch (error) {
+            await this.dispose();
+            throw error;
+        }
+    }
+    connect() {
+        const operation = this.open();
+        this.connecting = operation;
+        return operation.finally(() => { if (this.connecting === operation)
+            this.connecting = undefined; });
+    }
+    async open() {
+        let nc;
+        let key;
+        let watched = false;
+        try {
+            // HTTP-only Cloud Apps must not load broker libraries or require their dependencies.
+            const [{ jwtAuthenticator, wsconnect }, { createUser }] = await Promise.all([
+                import('@nats-io/nats-core'), import('@nats-io/nkeys'),
+            ]);
+            if (this.disposed)
+                return;
+            const connectionKey = createUser();
+            key = connectionKey;
+            const appId = this.transport.runtime()?.appId ?? getCurrentAppId();
+            const request = {
+                appId, topics: [{ topic: this.topic, publish: this.mode === 'publish', subscribe: this.mode === 'subscribe' }],
+                clientPublicKey: connectionKey.getPublicKey(),
+            };
+            const { value, ok } = await this.transport.post('/openapi/v2/stream-messages/connect', request, this.abort.signal);
+            const ticket = this.ticket(value, ok);
+            if (this.disposed)
+                return;
+            const expiresAt = Date.parse(ticket.expiresAt);
+            const permission = ticket.permissions[0];
+            this.subject = (this.mode === 'publish' ? permission.publishSubject : permission.subscribeSubject);
+            this.payloadLimit = ticket.maxPayloadBytes;
+            // Disable library reconnection so it cannot buffer writes or reuse expired JWTs.
+            nc = await wsconnect({
+                servers: [ticket.url], reconnect: false, waitOnFirstConnect: false,
+                ignoreClusterUpdates: true, timeout: Math.max(1, Math.min(MAX_FLUSH_TIMEOUT_MS, expiresAt - Date.now())),
+                authenticator: jwtAuthenticator(ticket.userJwt, () => connectionKey.getSeed()),
+            });
+            if (this.disposed) {
+                await nc.close();
+                return;
+            }
+            this.connection = nc;
+            this.expiresAt = expiresAt;
+            this.brokerError = undefined;
+            watched = true;
+            this.watching = this.watch(nc, connectionKey);
+            // Renewal also bounds the initial handshake; it must not wait for its first PONG.
+            const untilExpiry = expiresAt - Date.now();
+            this.expiryTimer = setTimeout(() => {
+                if (this.connection !== nc)
+                    return;
+                this.connected = false;
+                void nc.close();
+            }, Math.max(1, Math.min(2_147_483_647, untilExpiry - Math.min(5_000, untilExpiry / 10))));
+            if (this.mode === 'subscribe') {
+                this.subscription = nc.subscribe(this.subject, { callback: (error, msg) => {
+                        if (this.disposed || this.connection !== nc || Date.now() >= expiresAt)
+                            return;
+                        if (error) {
+                            this.report(fail('SUBSCRIBE_FAILED', 'Stream subscription failed.'));
+                            return;
+                        }
+                        try {
+                            if (msg.data.length > MAX_ENVELOPE)
+                                throw fail('INVALID_ENVELOPE', 'Stream message envelope exceeds limit.');
+                            const value = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(msg.data));
+                            if (!envelope(value, this.payloadLimit))
+                                throw fail('INVALID_ENVELOPE', 'Invalid Stream message envelope.');
+                            // Identity comes from the authorized physical subject; never accept identity fields in the envelope.
+                            const prefix = this.subject.slice(0, -1);
+                            if (!msg.subject.startsWith(prefix) || !/^[^.\s*>]+$/.test(msg.subject.slice(prefix.length))) {
+                                throw fail('INVALID_SUBJECT', 'Invalid Stream message subject.');
+                            }
+                            let result;
+                            try {
+                                result = this.handler(value);
+                            }
+                            catch {
+                                this.report(fail('HANDLER_FAILED', 'Stream message handler failed.'));
+                                return;
+                            }
+                            Promise.resolve(result).catch(() => {
+                                if (!this.disposed)
+                                    this.report(fail('HANDLER_FAILED', 'Stream message handler failed.'));
+                            });
+                        }
+                        catch (error) {
+                            this.report(error instanceof StreamMessageError ? error : fail('INVALID_ENVELOPE', 'Invalid Stream message envelope.'));
+                        }
+                    } });
+            }
+            await this.flush(nc, false);
+            if (this.disposed)
+                return;
+            if (nc.isClosed() || this.connection !== nc)
+                throw fail('CONNECT_FAILED', 'Stream messages connection failed.');
+            this.connected = true;
+            this.attempts = 0;
+        }
+        catch (error) {
+            if (nc)
+                await nc.close();
+            if (this.disposed)
+                return;
+            throw error instanceof StreamMessageError ? error : fail('CONNECT_FAILED', 'Stream messages connection failed.');
+        }
+        finally {
+            // Before a successful handoff, this attempt owns its key, including when
+            // the issuer or dial fails. A live connection's watcher owns later wiping.
+            if (!watched) {
+                await nc?.close();
+                key?.clear();
+            }
+        }
+    }
+    async flush(nc, publishing) {
+        const failure = () => publishing
+            ? fail('RESULT_UNKNOWN', 'Stream publish result unknown; do not automatically retry.')
+            : fail('CONNECT_FAILED', 'Stream messages connection failed.');
+        let timer;
+        let stopped;
+        try {
+            if (this.disposed || nc.isClosed() || this.expiresAt <= Date.now())
+                throw failure();
+            const deadline = new Promise((_resolve, reject) => {
+                stopped = () => reject(failure());
+                this.abort.signal.addEventListener('abort', stopped, { once: true });
+                if (this.abort.signal.aborted)
+                    stopped();
+                timer = setTimeout(stopped, Math.max(1, Math.min(MAX_FLUSH_TIMEOUT_MS, this.expiresAt - Date.now())));
+            });
+            await Promise.race([nc.flush(), deadline, nc.closed().then(() => { throw failure(); })]);
+        }
+        catch {
+            const watching = this.connection === nc ? this.watching : undefined;
+            if (this.connection === nc)
+                this.connected = false;
+            // Stop the transport and wipe its key before reporting a failed/unknown operation.
+            await nc.close();
+            await watching;
+            throw failure();
+        }
+        finally {
+            clearTimeout(timer);
+            if (stopped)
+                this.abort.signal.removeEventListener('abort', stopped);
+        }
+    }
+    ticket(value, ok) {
+        if (!ok)
+            throw fail('CONNECT_DENIED', 'Stream messages connection denied.');
+        if (!plain(value) || value.contractVersion !== 'stream-messages/v1' ||
+            typeof value.url !== 'string' || typeof value.userJwt !== 'string' || !value.userJwt ||
+            typeof value.expiresAt !== 'string' || !/^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d(?:\.\d+)?(?:Z|[+-]\d\d:\d\d)$/.test(value.expiresAt) ||
+            !(Date.parse(value.expiresAt) > Date.now()) ||
+            !Number.isSafeInteger(value.maxPayloadBytes) || value.maxPayloadBytes < 1 || value.maxPayloadBytes > MAX_PAYLOAD ||
+            !Array.isArray(value.permissions) || value.permissions.length !== 1) {
+            throw fail('CONNECT_PROTOCOL_ERROR', 'Invalid Stream messages connection response.');
+        }
+        const url = new URL(value.url);
+        if (url.protocol !== 'wss:' || url.username || url.password || url.hash || url.search) {
+            throw fail('CONNECT_PROTOCOL_ERROR', 'Stream messages requires a credential-free WSS URL.');
+        }
+        const permission = value.permissions[0];
+        if (!plain(permission) || permission.topic !== this.topic)
+            throw fail('CONNECT_PROTOCOL_ERROR', 'Invalid topic permission.');
+        // Subject layout belongs to SYS. Only check NATS syntax and requested access.
+        const validSubject = (subject, mode) => {
+            if (typeof subject !== 'string' || !subject)
+                return false;
+            if (mode === 'subscribe' && !subject.endsWith('.*'))
+                return false;
+            const parts = subject.split('.');
+            return parts.every((part, index) => !!part &&
+                (mode === 'subscribe' && index === parts.length - 1 && part === '*' || !/[\s*>]/.test(part)));
+        };
+        const publish = permission.publishSubject;
+        const subscribe = permission.subscribeSubject;
+        if ((publish !== undefined && !validSubject(publish, 'publish')) ||
+            (subscribe !== undefined && !validSubject(subscribe, 'subscribe')) ||
+            (this.mode === 'publish' ? !publish || !!subscribe : !subscribe || !!publish)) {
+            throw fail('CONNECT_PROTOCOL_ERROR', 'Invalid scoped topic subjects.');
+        }
+        return value;
+    }
+    async watch(nc, key) {
+        try {
+            for await (const status of nc.status()) {
+                if (this.disposed || this.connection !== nc)
+                    break;
+                if (status.type === 'disconnect' || status.type === 'close' || status.type === 'staleConnection')
+                    this.connected = false;
+                if (status.type === 'error' || status.type === 'slowConsumer') {
+                    this.brokerError = fail(status.type === 'error' ? 'BROKER_ERROR' : 'SLOW_CONSUMER', 'Stream messages asynchronous broker error.');
+                    this.report(this.brokerError);
+                }
+            }
+            const error = await nc.closed();
+            if (error && !this.disposed)
+                this.report(fail('CONNECTION_LOST', 'Stream messages connection lost.'));
+        }
+        catch {
+            if (!this.disposed)
+                this.report(fail('CONNECTION_LOST', 'Stream messages connection lost.'));
+        }
+        finally {
+            // Close even if the status iterator failed. A replacement must never be
+            // issued while the prior, potentially wider, authenticated socket is live.
+            await nc.close();
+            key.clear();
+            if (this.connection === nc) {
+                this.connection = undefined;
+                this.connected = false;
+                this.subscription = undefined;
+                clearTimeout(this.expiryTimer);
+                this.scheduleReconnect();
+            }
+        }
+    }
+    scheduleReconnect() {
+        if (this.disposed || this.reconnectTimer)
+            return;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = undefined;
+            if (this.disposed)
+                return;
+            void this.connect().catch(error => {
+                this.report(error instanceof StreamMessageError ? error : fail('CONNECT_FAILED', 'Stream messages reconnection failed.'));
+                this.scheduleReconnect();
+            });
+        }, Math.min(30_000, 500 * 2 ** Math.min(this.attempts++, 6)));
+    }
+    async publish(value) {
+        // Only the very first publish may establish a connection. Subsequent disconnected writes fail.
+        if (!this.started)
+            await this.ready();
+        const nc = this.connection;
+        if (this.disposed || !this.connected || !nc || nc.isClosed())
+            throw fail('DISCONNECTED', 'Stream messages disconnected.');
+        if (!envelope(value, this.payloadLimit))
+            throw fail('INVALID_ENVELOPE', 'Invalid Stream message envelope or payload limit exceeded.');
+        const bytes = encoder.encode(JSON.stringify(value));
+        if (bytes.length > MAX_ENVELOPE)
+            throw fail('PAYLOAD_TOO_LARGE', 'Stream message envelope exceeds limit.');
+        this.brokerError = undefined;
+        try {
+            nc.publish(this.subject, bytes);
+            await this.flush(nc, true);
+            if (this.brokerError)
+                throw this.brokerError;
+            if (!this.connected || this.connection !== nc)
+                throw fail('RESULT_UNKNOWN', 'Stream publish result unknown.');
+        }
+        catch (error) {
+            throw error instanceof StreamMessageError ? error : fail('RESULT_UNKNOWN', 'Stream publish result unknown; do not automatically retry.');
+        }
+    }
+    dispose() {
+        if (this.disposing)
+            return this.disposing;
+        this.disposed = true;
+        this.connected = false;
+        this.abort.abort();
+        this.removeRuntimeListener?.();
+        clearTimeout(this.reconnectTimer);
+        clearTimeout(this.expiryTimer);
+        this.subscription?.unsubscribe();
+        this.disposing = (async () => {
+            await this.connection?.close();
+            await this.connecting?.catch(() => undefined);
+            await this.watching;
+            this.connection = undefined;
+            this.remove();
+        })();
+        return this.disposing;
+    }
+}
+export class StreamMessagesClient {
+    transport;
+    sessions = new Set();
+    listeners = new Set();
+    disposed = false;
+    disposing;
+    constructor(transport = new StreamTransport()) {
+        this.transport = transport;
+    }
+    onError(handler) {
+        if (this.disposed)
+            throw fail('DISPOSED', 'Stream messages client disposed.');
+        this.listeners.add(handler);
+        return () => { this.listeners.delete(handler); };
+    }
+    use(selector) {
+        if (!plain(selector) || Object.keys(selector).some(k => k !== 'topic') ||
+            typeof selector.topic !== 'string' || !/^[a-zA-Z0-9][a-zA-Z0-9._/-]{0,127}$/.test(selector.topic)) {
+            throw new TypeError('Tier0 SDK: invalid logical Stream topic.');
+        }
+        const topic = selector.topic;
+        let publisher;
+        const session = (mode, handler, onError) => {
+            if (this.disposed)
+                throw fail('DISPOSED', 'Stream messages client disposed.');
+            const report = (error) => {
+                const listeners = new Set(this.listeners);
+                if (onError)
+                    listeners.add(onError);
+                if (!listeners.size)
+                    console.error(error);
+                for (const listener of listeners) {
+                    try {
+                        listener(error);
+                    }
+                    catch {
+                        console.error(fail('ERROR_HANDLER_FAILED', 'Stream messages error handler failed.'));
+                    }
+                }
+            };
+            const value = new MessageSession(this.transport, topic, mode, report, () => this.sessions.delete(value), handler);
+            this.sessions.add(value);
+            return value;
+        };
+        return {
+            publish: async (payload, options = {}) => {
+                if (this.disposed)
+                    throw fail('DISPOSED', 'Stream messages client disposed.');
+                if (!plain(options) || Object.keys(options).some(k => !['messageId', 'correlationId'].includes(k)) ||
+                    (options.messageId !== undefined && typeof options.messageId !== 'string') ||
+                    (options.correlationId !== undefined && typeof options.correlationId !== 'string')) {
+                    throw new TypeError('Tier0 SDK: unsupported Stream publish option.');
+                }
+                const message = {
+                    version: 'stream-messages/v1', messageId: options.messageId ?? crypto.randomUUID(),
+                    ...(options.correlationId === undefined ? {} : { correlationId: options.correlationId }), payload,
+                };
+                if (!envelope(message, MAX_PAYLOAD))
+                    throw fail('INVALID_ENVELOPE', 'Invalid Stream message envelope.');
+                if (encoder.encode(JSON.stringify(message)).length > MAX_ENVELOPE)
+                    throw fail('PAYLOAD_TOO_LARGE', 'Stream message envelope exceeds limit.');
+                if (publisher?.disposed) {
+                    const previous = publisher;
+                    await previous.dispose();
+                    if (previous.runtime !== this.transport.runtime())
+                        throw fail('DISCONNECTED', 'Stream messages disconnected.');
+                    if (publisher === previous)
+                        publisher = undefined;
+                }
+                if (!publisher)
+                    publisher = session('publish');
+                await publisher.publish(message);
+                return message;
+            },
+            subscribe: async (handler, options = {}) => {
+                if (typeof handler !== 'function' || !plain(options) || Object.keys(options).some(k => k !== 'onError') ||
+                    (options.onError !== undefined && typeof options.onError !== 'function'))
+                    throw new TypeError('Tier0 SDK: invalid Stream subscription.');
+                const value = session('subscribe', handler, options.onError);
+                await value.ready();
+                return value;
+            },
+        };
+    }
+    dispose() {
+        if (this.disposing)
+            return this.disposing;
+        this.disposed = true;
+        this.disposing = Promise.all([...this.sessions].map(session => session.dispose())).then(() => {
+            this.listeners.clear();
+        });
+        return this.disposing;
+    }
+}
+//# sourceMappingURL=messages.js.map