@tier0/sdk-v2 0.0.0-stage → 0.2.1

package/dist/esm/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAqB,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIzC,yFAAyF;AACzF,MAAM,UAAU,YAAY,CAAC,SAA4B,EAAE;IACzD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC;IAC3B,MAAM,GAAG,GAAG,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,KAAK,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC;QAC5B,YAAY,EAAE,IAAI,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC;QACvD,QAAQ,EAAE,IAAI,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC;QAC/C,MAAM,EAAE,gBAAgB,CAAC,GAAG,CAAC;QAC7B,MAAM,EAAE,gBAAgB,CAAC,GAAG,CAAC;QAC7B,GAAG,EAAE,iBAAiB,CAAC,GAAG,CAAC;QAC3B,GAAG;KACJ,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { HttpClient, type ClientConfig } from './openapi/client.js';\nimport { createOpenAPI } from './openapi/api.generated.js';\nimport { createUnsV2Client } from './uns-v2/client.js';\nimport { bindUnsDataClient } from './uns-v2/data-client.js';\nimport { bindSourceClient } from './source.js';\nimport { bindStreamClient } from './stream.js';\nimport { ControlsClient } from './controls.js';\nimport { CapabilitiesClient } from './capabilities.js';\nimport { FilesClient } from './files.js';\nimport type { CloudTransportConfig } from './cloud-transport.js';\n\nexport interface Tier0ClientConfig extends ClientConfig, CloudTransportConfig {}\n/** Use a fresh instance per incoming request when supplying employee data delegation. */\nexport function createClient(config: Tier0ClientConfig = {}) {\n  const snapshot = Object.freeze({ ...config });\n  const http = new HttpClient(snapshot);\n  const api = createOpenAPI(http);\n  const resolve = () => http;\n  const raw = createUnsV2Client(resolve, snapshot);\n  return Object.freeze({\n    system: api.system,\n    members: api.members,\n    notifications: api.notifications,\n    mqttAuth: api.mqttAuth,\n    agent: api.agent,\n    files: new FilesClient(http),\n    capabilities: new CapabilitiesClient(resolve, snapshot),\n    controls: new ControlsClient(resolve, snapshot),\n    source: bindSourceClient(raw),\n    stream: bindStreamClient(raw),\n    uns: bindUnsDataClient(raw),\n    api,\n  });\n}\nexport type Tier0Client = ReturnType<typeof createClient>;\n"]}

package/dist/esm/cloud-server.d.ts

@@ -0,0 +1,31 @@
+export declare const APP_REQUEST_IDENTITY_HEADER: "X-Tier0-App-Identity";
+export declare class AppRequestIdentityError extends Error {
+    readonly code: 'APP_IDENTITY_INVALID' | 'APP_IDENTITY_CONFIGURATION_INVALID';
+    constructor(code: 'APP_IDENTITY_INVALID' | 'APP_IDENTITY_CONFIGURATION_INVALID');
+}
+export interface VerifiedCloudAppUser {
+    readonly kind: 'gateway-user';
+    readonly userID: string;
+    readonly workspaceID: string;
+    readonly appID: string;
+    readonly roleKeys: readonly string[];
+    readonly requestID: string;
+    readonly issuedAt: number;
+    readonly expiresAt: number;
+    readonly verificationKeyID: string;
+}
+export interface CloudAppIdentityAuthority {
+    appID: string;
+    workspaceID: string;
+    /** Pinned server configuration, never a key or URL taken from the request. */
+    publicKeys: unknown;
+}
+export interface CloudAppIdentityRequest {
+    assertion: string | undefined;
+    method: string;
+    requestURI: string;
+    /** Exact bytes received from the gateway, before JSON parsing or normalization. */
+    body: Uint8Array;
+}
+/** Verifies request provenance, not business authorization or delegated UNS permissions. */
+export declare function createCloudAppRequestVerifier(authority: CloudAppIdentityAuthority): (request: CloudAppIdentityRequest) => VerifiedCloudAppUser;

package/dist/esm/cloud-server.js

@@ -0,0 +1,109 @@
+// Server-only entry point. Browser HTTP clients remain independent of node:crypto.
+import { createHash, createPublicKey, verify } from 'node:crypto';
+import { APP_REQUEST_IDENTITY_CONTRACT as contract } from './app-identity-contract.generated.js';
+export const APP_REQUEST_IDENTITY_HEADER = contract.header;
+export class AppRequestIdentityError extends Error {
+    code;
+    constructor(code) {
+        super(code);
+        this.code = code;
+        this.name = 'AppRequestIdentityError';
+    }
+}
+const invalid = () => new AppRequestIdentityError('APP_IDENTITY_INVALID');
+const invalidConfig = () => new AppRequestIdentityError('APP_IDENTITY_CONFIGURATION_INVALID');
+const appPattern = new RegExp(contract.appIDPattern);
+const kidPattern = new RegExp(contract.keyIDPattern);
+const methodPattern = new RegExp(contract.methodPattern);
+const maxID = BigInt('9223372036854775807');
+const validID = (value) => typeof value === 'string' && /^[1-9]\d{0,18}$/.test(value) && BigInt(value) <= maxID;
+const isObject = (value) => !!value && typeof value === 'object' && !Array.isArray(value);
+const exactKeys = (value, keys) => Object.keys(value).length === keys.length && Object.keys(value).every((key) => keys.includes(key));
+const validString = (value, maxBytes) => typeof value === 'string' && value.length > 0 && Buffer.byteLength(value) <= maxBytes &&
+    Buffer.from(value).toString('utf8') === value && !/[\u0000-\u001f\u007f-\u009f]/.test(value);
+const decode = (value) => {
+    if (!/^[A-Za-z0-9_-]+$/.test(value))
+        throw invalid();
+    const bytes = Buffer.from(value, 'base64url');
+    if (bytes.toString('base64url') !== value)
+        throw invalid();
+    return bytes;
+};
+/** Verifies request provenance, not business authorization or delegated UNS permissions. */
+export function createCloudAppRequestVerifier(authority) {
+    if (!isObject(authority) || typeof authority.appID !== 'string' || !appPattern.test(authority.appID) || !validID(authority.workspaceID))
+        throw invalidConfig();
+    const appID = authority.appID;
+    const workspaceID = authority.workspaceID;
+    const keys = new Map();
+    try {
+        let raw = authority.publicKeys;
+        if (typeof raw === 'string') {
+            if (Buffer.byteLength(raw) > contract.maxTokenBytes * contract.maxKeys)
+                throw invalidConfig();
+            raw = JSON.parse(raw);
+        }
+        if (!isObject(raw) || !exactKeys(raw, ['keys']) || !Array.isArray(raw.keys) ||
+            raw.keys.length === 0 || raw.keys.length > contract.maxKeys)
+            throw invalidConfig();
+        for (const key of raw.keys) {
+            if (!isObject(key) || !exactKeys(key, contract.publicKeyFields) || key.kty !== 'OKP' ||
+                key.crv !== 'Ed25519' || typeof key.kid !== 'string' || !kidPattern.test(key.kid) ||
+                keys.has(key.kid) || typeof key.x !== 'string' || decode(key.x).length !== 32)
+                throw invalidConfig();
+            keys.set(key.kid, createPublicKey({ key: { kty: 'OKP', crv: 'Ed25519', x: key.x }, format: 'jwk' }));
+        }
+    }
+    catch {
+        throw invalidConfig();
+    }
+    return (request) => {
+        try {
+            if (typeof request.assertion !== 'string' || Buffer.byteLength(request.assertion) > contract.maxTokenBytes ||
+                !(request.body instanceof Uint8Array) || request.body.byteLength > contract.maxBodyBytes ||
+                !methodPattern.test(request.method) || !validString(request.requestURI, contract.maxURIBytes) ||
+                !request.requestURI.startsWith('/') || request.requestURI.startsWith('//'))
+                throw invalid();
+            const parts = request.assertion.split('.');
+            if (parts.length !== 3)
+                throw invalid();
+            const header = JSON.parse(decode(parts[0]).toString('utf8'));
+            if (!isObject(header) || !exactKeys(header, contract.requiredHeaderFields) ||
+                header.alg !== contract.algorithm || header.typ !== contract.type ||
+                typeof header.kid !== 'string' || !kidPattern.test(header.kid))
+                throw invalid();
+            const key = keys.get(header.kid);
+            const signature = decode(parts[2]);
+            if (!key || signature.length !== 64 ||
+                !verify(null, Buffer.from(parts[0] + '.' + parts[1], 'ascii'), key, signature))
+                throw invalid();
+            const claims = JSON.parse(decode(parts[1]).toString('utf8'));
+            if (!isObject(claims) || !exactKeys(claims, contract.requiredClaims) ||
+                claims.ver !== contract.version || claims.iss !== contract.issuer || claims.aud !== contract.audience ||
+                !validID(claims.sub) || claims.workspaceID !== workspaceID || claims.appID !== appID ||
+                claims.method !== request.method || claims.requestURI !== request.requestURI ||
+                typeof claims.bodySHA256 !== 'string' || !/^[a-f0-9]{64}$/.test(claims.bodySHA256) ||
+                claims.bodySHA256 !== createHash('sha256').update(request.body).digest('hex') ||
+                typeof claims.iat !== 'number' || !Number.isSafeInteger(claims.iat) || claims.iat <= 0 ||
+                typeof claims.exp !== 'number' || !Number.isSafeInteger(claims.exp) || claims.exp <= claims.iat ||
+                claims.exp - claims.iat > contract.maxTTLSeconds ||
+                typeof claims.jti !== 'string' || !/^[a-f0-9]{32}$/.test(claims.jti) ||
+                !Array.isArray(claims.roles) || claims.roles.length > contract.maxRoles ||
+                claims.roles.some((role) => !validString(role, contract.maxRoleBytes) || role.trim() !== role) ||
+                new Set(claims.roles).size !== claims.roles.length)
+                throw invalid();
+            const now = Math.floor(Date.now() / 1000);
+            if (claims.iat > now + contract.clockSkewSeconds || now >= claims.exp + contract.clockSkewSeconds)
+                throw invalid();
+            return Object.freeze({
+                kind: 'gateway-user', userID: claims.sub, workspaceID, appID,
+                roleKeys: Object.freeze([...claims.roles]), requestID: claims.jti,
+                issuedAt: claims.iat, expiresAt: claims.exp, verificationKeyID: header.kid,
+            });
+        }
+        catch {
+            throw invalid();
+        }
+    };
+}
+//# sourceMappingURL=cloud-server.js.map

package/dist/esm/cloud-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-server.js","sourceRoot":"","sources":["../../src/cloud-server.ts"],"names":[],"mappings":"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","sourcesContent":["// Server-only entry point. Browser HTTP clients remain independent of node:crypto.\nimport { createHash, createPublicKey, verify, type KeyObject } from 'node:crypto';\nimport { APP_REQUEST_IDENTITY_CONTRACT as contract } from './app-identity-contract.generated.js';\n\nexport const APP_REQUEST_IDENTITY_HEADER = contract.header;\n\nexport class AppRequestIdentityError extends Error {\n  constructor(public readonly code: 'APP_IDENTITY_INVALID' | 'APP_IDENTITY_CONFIGURATION_INVALID') {\n    super(code);\n    this.name = 'AppRequestIdentityError';\n  }\n}\n\nexport interface VerifiedCloudAppUser {\n  readonly kind: 'gateway-user';\n  readonly userID: string;\n  readonly workspaceID: string;\n  readonly appID: string;\n  readonly roleKeys: readonly string[];\n  readonly requestID: string;\n  readonly issuedAt: number;\n  readonly expiresAt: number;\n  readonly verificationKeyID: string;\n}\n\nexport interface CloudAppIdentityAuthority {\n  appID: string;\n  workspaceID: string;\n  /** Pinned server configuration, never a key or URL taken from the request. */\n  publicKeys: unknown;\n}\n\nexport interface CloudAppIdentityRequest {\n  assertion: string | undefined;\n  method: string;\n  requestURI: string;\n  /** Exact bytes received from the gateway, before JSON parsing or normalization. */\n  body: Uint8Array;\n}\n\nconst invalid = () => new AppRequestIdentityError('APP_IDENTITY_INVALID');\nconst invalidConfig = () => new AppRequestIdentityError('APP_IDENTITY_CONFIGURATION_INVALID');\nconst appPattern = new RegExp(contract.appIDPattern);\nconst kidPattern = new RegExp(contract.keyIDPattern);\nconst methodPattern = new RegExp(contract.methodPattern);\nconst maxID = BigInt('9223372036854775807');\nconst validID = (value: unknown): value is string =>\n  typeof value === 'string' && /^[1-9]\\d{0,18}$/.test(value) && BigInt(value) <= maxID;\nconst isObject = (value: unknown): value is Record<string, unknown> =>\n  !!value && typeof value === 'object' && !Array.isArray(value);\nconst exactKeys = (value: Record<string, unknown>, keys: readonly string[]) =>\n  Object.keys(value).length === keys.length && Object.keys(value).every((key) => keys.includes(key));\nconst validString = (value: unknown, maxBytes: number): value is string =>\n  typeof value === 'string' && value.length > 0 && Buffer.byteLength(value) <= maxBytes &&\n  Buffer.from(value).toString('utf8') === value && !/[\\u0000-\\u001f\\u007f-\\u009f]/.test(value);\nconst decode = (value: string) => {\n  if (!/^[A-Za-z0-9_-]+$/.test(value)) throw invalid();\n  const bytes = Buffer.from(value, 'base64url');\n  if (bytes.toString('base64url') !== value) throw invalid();\n  return bytes;\n};\n\n/** Verifies request provenance, not business authorization or delegated UNS permissions. */\nexport function createCloudAppRequestVerifier(authority: CloudAppIdentityAuthority) {\n  if (!isObject(authority) || typeof authority.appID !== 'string' || !appPattern.test(authority.appID) || !validID(authority.workspaceID)) throw invalidConfig();\n  const appID = authority.appID;\n  const workspaceID = authority.workspaceID;\n  const keys = new Map<string, KeyObject>();\n  try {\n    let raw = authority.publicKeys;\n    if (typeof raw === 'string') {\n      if (Buffer.byteLength(raw) > contract.maxTokenBytes * contract.maxKeys) throw invalidConfig();\n      raw = JSON.parse(raw);\n    }\n    if (!isObject(raw) || !exactKeys(raw, ['keys']) || !Array.isArray(raw.keys) ||\n        raw.keys.length === 0 || raw.keys.length > contract.maxKeys) throw invalidConfig();\n    for (const key of raw.keys) {\n      if (!isObject(key) || !exactKeys(key, contract.publicKeyFields) || key.kty !== 'OKP' ||\n          key.crv !== 'Ed25519' || typeof key.kid !== 'string' || !kidPattern.test(key.kid) ||\n          keys.has(key.kid) || typeof key.x !== 'string' || decode(key.x).length !== 32) throw invalidConfig();\n      keys.set(key.kid, createPublicKey({ key: { kty: 'OKP', crv: 'Ed25519', x: key.x }, format: 'jwk' }));\n    }\n  } catch { throw invalidConfig(); }\n\n  return (request: CloudAppIdentityRequest): VerifiedCloudAppUser => {\n    try {\n      if (typeof request.assertion !== 'string' || Buffer.byteLength(request.assertion) > contract.maxTokenBytes ||\n          !(request.body instanceof Uint8Array) || request.body.byteLength > contract.maxBodyBytes ||\n          !methodPattern.test(request.method) || !validString(request.requestURI, contract.maxURIBytes) ||\n          !request.requestURI.startsWith('/') || request.requestURI.startsWith('//')) throw invalid();\n      const parts = request.assertion.split('.');\n      if (parts.length !== 3) throw invalid();\n      const header: unknown = JSON.parse(decode(parts[0]).toString('utf8'));\n      if (!isObject(header) || !exactKeys(header, contract.requiredHeaderFields) ||\n          header.alg !== contract.algorithm || header.typ !== contract.type ||\n          typeof header.kid !== 'string' || !kidPattern.test(header.kid)) throw invalid();\n      const key = keys.get(header.kid);\n      const signature = decode(parts[2]);\n      if (!key || signature.length !== 64 ||\n          !verify(null, Buffer.from(parts[0] + '.' + parts[1], 'ascii'), key, signature)) throw invalid();\n      const claims: unknown = JSON.parse(decode(parts[1]).toString('utf8'));\n      if (!isObject(claims) || !exactKeys(claims, contract.requiredClaims) ||\n          claims.ver !== contract.version || claims.iss !== contract.issuer || claims.aud !== contract.audience ||\n          !validID(claims.sub) || claims.workspaceID !== workspaceID || claims.appID !== appID ||\n          claims.method !== request.method || claims.requestURI !== request.requestURI ||\n          typeof claims.bodySHA256 !== 'string' || !/^[a-f0-9]{64}$/.test(claims.bodySHA256) ||\n          claims.bodySHA256 !== createHash('sha256').update(request.body).digest('hex') ||\n          typeof claims.iat !== 'number' || !Number.isSafeInteger(claims.iat) || claims.iat <= 0 ||\n          typeof claims.exp !== 'number' || !Number.isSafeInteger(claims.exp) || claims.exp <= claims.iat ||\n          claims.exp - claims.iat > contract.maxTTLSeconds ||\n          typeof claims.jti !== 'string' || !/^[a-f0-9]{32}$/.test(claims.jti) ||\n          !Array.isArray(claims.roles) || claims.roles.length > contract.maxRoles ||\n          claims.roles.some((role) => !validString(role, contract.maxRoleBytes) || role.trim() !== role) ||\n          new Set(claims.roles).size !== claims.roles.length) throw invalid();\n      const now = Math.floor(Date.now() / 1000);\n      if (claims.iat > now + contract.clockSkewSeconds || now >= claims.exp + contract.clockSkewSeconds) throw invalid();\n      return Object.freeze({\n        kind: 'gateway-user' as const, userID: claims.sub, workspaceID, appID,\n        roleKeys: Object.freeze([...claims.roles] as string[]), requestID: claims.jti,\n        issuedAt: claims.iat, expiresAt: claims.exp, verificationKeyID: header.kid,\n      });\n    } catch { throw invalid(); }\n  };\n}\n"]}

package/dist/esm/cloud-transport.d.ts

@@ -0,0 +1,67 @@
+import { type HttpClient, type RequestOptions } from './openapi/client.js';
+export interface CloudTransportConfig {
+    /** Whole HTTP exchange including the response body, in milliseconds; default 60,000. */
+    transportTimeoutMs?: number;
+    /** UNS v2 response body limit; may only tighten the 20 MiB contract/RPC ceiling. */
+    unsV2MaxResponseBytes?: number;
+    /**
+     * Opaque proof from the trusted App Gateway only: tier0.app-data-subject/v1,
+     * X-Tier0-App-Data-Subject, aud tier0-uns-data. Proof alone is not authentication;
+     * the SDK checks only compact syntax, never parses or trusts claims.
+     * Create a new client per incoming request; never reuse a token across users.
+     * Do not automatically forward the runtime App request assertion: its audience differs.
+     */
+    unsV2AppDataSubject?: string;
+}
+export declare const DEFAULT_CLOUD_TRANSPORT_TIMEOUT_MS = 60000;
+/** Header carrying `unsV2AppDataSubject`; the trusted App Gateway sets it on each business request. */
+export declare const UNS_V2_APP_DATA_SUBJECT_HEADER = "X-Tier0-App-Data-Subject";
+export declare const UNS_V2_MAX_REQUEST_BYTES: number;
+export declare const UNS_V2_MAX_RESPONSE_BYTES: number;
+type Failure = 'TRANSPORT_ERROR' | 'PROTOCOL_ERROR' | 'TRANSPORT_TIMEOUT' | 'TRANSPORT_ABORTED';
+/** Internal redacted failure, translated by each public contract client. */
+export declare class CloudTransportError extends Error {
+    readonly kind: Failure;
+    readonly status?: number | undefined;
+    constructor(kind: Failure, status?: number | undefined);
+}
+/** Single fetch, no redirects/retries; one deadline covers both headers and body. */
+export declare class CloudTransport {
+    #private;
+    private readonly resolveClient;
+    private readonly timeoutMs;
+    private readonly unsV2MaxResponseBytes;
+    constructor(resolveClient?: () => HttpClient, config?: CloudTransportConfig);
+    /** `retryAfter`: the raw `Retry-After` header, for answers without a UNS error body. */
+    postText(path: string, body: string, options?: RequestOptions): Promise<{
+        text: string;
+        status: number;
+        ok: boolean;
+        retryAfter?: string;
+    }>;
+    /**
+     * Opens a server-sent event stream (GET, `Accept: text/event-stream`
+     * exactly, as the gateway requires). The deadline covers the response
+     * headers, and a non-stream body; a response that is not an event stream
+     * is read whole (bounded like any UNS v2 response) and returned as `text`.
+     * An open stream belongs to the caller: `close()` ends it and drops the
+     * link to `signal`, which also ends it.
+     */
+    getEventStream(path: string, options?: {
+        lastEventId?: string;
+        signal?: AbortSignal;
+    }): Promise<{
+        status: number;
+        stream: ReadableStream<Uint8Array>;
+        close(): void;
+    } | {
+        status: number;
+        text: string;
+    }>;
+    post(path: string, body: unknown): Promise<{
+        value: unknown;
+        status: number;
+        ok: boolean;
+    }>;
+}
+export {};

package/dist/esm/cloud-transport.js

@@ -0,0 +1,267 @@
+import { getClient } from './openapi/client.js';
+export const DEFAULT_CLOUD_TRANSPORT_TIMEOUT_MS = 60_000;
+/** Header carrying `unsV2AppDataSubject`; the trusted App Gateway sets it on each business request. */
+export const UNS_V2_APP_DATA_SUBJECT_HEADER = 'X-Tier0-App-Data-Subject';
+export const UNS_V2_MAX_REQUEST_BYTES = 16 << 20;
+export const UNS_V2_MAX_RESPONSE_BYTES = 20 << 20;
+/** Internal redacted failure, translated by each public contract client. */
+export class CloudTransportError extends Error {
+    kind;
+    status;
+    constructor(kind, status) {
+        super(kind);
+        this.kind = kind;
+        this.status = status;
+        this.name = 'CloudTransportError';
+    }
+}
+/** Single fetch, no redirects/retries; one deadline covers both headers and body. */
+export class CloudTransport {
+    resolveClient;
+    timeoutMs;
+    unsV2MaxResponseBytes;
+    #unsV2AppDataSubject;
+    constructor(resolveClient = getClient, config = {}) {
+        this.resolveClient = resolveClient;
+        const timeout = config.transportTimeoutMs ?? DEFAULT_CLOUD_TRANSPORT_TIMEOUT_MS;
+        if (!Number.isInteger(timeout) || timeout < 1 || timeout > 2_147_483_647) {
+            throw new TypeError('Tier0 SDK: transportTimeoutMs must be an integer between 1 and 2147483647.');
+        }
+        this.timeoutMs = timeout;
+        const maxResponseBytes = config.unsV2MaxResponseBytes ?? UNS_V2_MAX_RESPONSE_BYTES;
+        if (!Number.isInteger(maxResponseBytes) || maxResponseBytes < 1 || maxResponseBytes > UNS_V2_MAX_RESPONSE_BYTES) {
+            throw new TypeError('Tier0 SDK: unsV2MaxResponseBytes must be an integer between 1 and 20971520.');
+        }
+        this.unsV2MaxResponseBytes = maxResponseBytes;
+        const subject = config.unsV2AppDataSubject;
+        // ASCII-only syntax makes string length equal byte length. Do not trim or decode.
+        if (subject !== undefined && (typeof subject !== 'string' || subject.length > 8192 || /[^A-Za-z0-9_.-]/.test(subject) ||
+            !/^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$/.test(subject))) {
+            throw new TypeError('Tier0 SDK: unsV2AppDataSubject must be a compact three-segment base64url token of at most 8192 ASCII bytes.');
+        }
+        this.#unsV2AppDataSubject = subject;
+    }
+    /** `retryAfter`: the raw `Retry-After` header, for answers without a UNS error body. */
+    async postText(path, body, options = {}) {
+        options.signal?.throwIfAborted();
+        const client = this.resolveClient();
+        const url = `${client.getBaseURL()}${path}`;
+        const key = client.getApiKey();
+        const headers = { 'Content-Type': 'application/json' };
+        // Control routes also live under UNS v2, but must never receive data delegation.
+        // Keep this per-client proof out of shared HTTP headers and Control capabilities.
+        if (path.startsWith('/openapi/v2/uns/') &&
+            !path.startsWith('/openapi/v2/uns/controls/') &&
+            path !== '/openapi/v2/uns/streams/runtime/capabilities/get' &&
+            this.#unsV2AppDataSubject !== undefined) {
+            headers[UNS_V2_APP_DATA_SUBJECT_HEADER] = this.#unsV2AppDataSubject;
+        }
+        if (key) {
+            headers.Authorization = `Bearer ${key}`;
+            headers['X-API-Key'] = key;
+        }
+        const controller = new AbortController();
+        let response;
+        let reader;
+        let timer;
+        let rejectAbort = () => undefined;
+        const cancelled = new Promise((_, reject) => { rejectAbort = reject; });
+        const onAbort = () => {
+            controller.abort();
+            void reader?.cancel().catch(() => undefined);
+            rejectAbort(new CloudTransportError('TRANSPORT_ABORTED', response?.status));
+        };
+        options.signal?.addEventListener('abort', onAbort, { once: true });
+        const exchange = async () => {
+            try {
+                response = await client.getFetch()(url, { method: 'POST', headers, body, redirect: 'manual', signal: controller.signal });
+            }
+            catch {
+                throw new CloudTransportError('TRANSPORT_ERROR');
+            }
+            const declaredLength = response.headers.get('content-length');
+            if (declaredLength !== null && /^\d+$/.test(declaredLength) && Number(declaredLength) > this.unsV2MaxResponseBytes) {
+                await response.body?.cancel().catch(() => undefined);
+                throw new CloudTransportError('PROTOCOL_ERROR', response.status);
+            }
+            if (!response.body)
+                throw new CloudTransportError('PROTOCOL_ERROR', response.status);
+            reader = response.body.getReader();
+            const decoder = new TextDecoder('utf-8', { fatal: true });
+            const chunks = [];
+            let receivedBytes = 0;
+            try {
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    receivedBytes += value.byteLength;
+                    if (receivedBytes > this.unsV2MaxResponseBytes) {
+                        await reader.cancel().catch(() => undefined);
+                        throw new CloudTransportError('PROTOCOL_ERROR', response.status);
+                    }
+                    chunks.push(decoder.decode(value, { stream: true }));
+                }
+                chunks.push(decoder.decode());
+            }
+            catch (error) {
+                if (error instanceof CloudTransportError)
+                    throw error;
+                throw new CloudTransportError('PROTOCOL_ERROR', response.status);
+            }
+            finally {
+                reader.releaseLock();
+                reader = undefined;
+            }
+            const retryAfter = response.headers.get('retry-after') ?? undefined;
+            return { text: chunks.join(''), status: response.status, ok: response.ok, ...(retryAfter === undefined ? {} : { retryAfter }) };
+        };
+        try {
+            const deadline = new Promise((_resolve, reject) => {
+                timer = setTimeout(() => {
+                    controller.abort();
+                    void reader?.cancel().catch(() => undefined);
+                    reject(new CloudTransportError('TRANSPORT_TIMEOUT', response?.status));
+                }, this.timeoutMs);
+            });
+            // Also bounds custom transports which ignore AbortSignal.
+            return await Promise.race([exchange(), deadline, cancelled]);
+        }
+        catch (error) {
+            if (controller.signal.aborted)
+                throw new CloudTransportError(options.signal?.aborted ? 'TRANSPORT_ABORTED' : 'TRANSPORT_TIMEOUT', response?.status);
+            throw error;
+        }
+        finally {
+            clearTimeout(timer);
+            options.signal?.removeEventListener('abort', onAbort);
+        }
+    }
+    /**
+     * Opens a server-sent event stream (GET, `Accept: text/event-stream`
+     * exactly, as the gateway requires). The deadline covers the response
+     * headers, and a non-stream body; a response that is not an event stream
+     * is read whole (bounded like any UNS v2 response) and returned as `text`.
+     * An open stream belongs to the caller: `close()` ends it and drops the
+     * link to `signal`, which also ends it.
+     */
+    async getEventStream(path, options = {}) {
+        options.signal?.throwIfAborted();
+        const client = this.resolveClient();
+        const url = `${client.getBaseURL()}${path}`;
+        const key = client.getApiKey();
+        const headers = { Accept: 'text/event-stream' };
+        if (path.startsWith('/openapi/v2/uns/') && this.#unsV2AppDataSubject !== undefined) {
+            headers[UNS_V2_APP_DATA_SUBJECT_HEADER] = this.#unsV2AppDataSubject;
+        }
+        if (options.lastEventId !== undefined)
+            headers['Last-Event-ID'] = options.lastEventId;
+        if (key) {
+            headers.Authorization = `Bearer ${key}`;
+            headers['X-API-Key'] = key;
+        }
+        const controller = new AbortController();
+        const onAbort = () => controller.abort();
+        const close = () => {
+            options.signal?.removeEventListener('abort', onAbort);
+            controller.abort();
+        };
+        options.signal?.addEventListener('abort', onAbort, { once: true });
+        let expired = false;
+        const timer = setTimeout(() => { expired = true; controller.abort(); }, this.timeoutMs);
+        const failure = (kind, status) => new CloudTransportError(expired ? 'TRANSPORT_TIMEOUT' : controller.signal.aborted ? 'TRANSPORT_ABORTED' : kind, status);
+        let response;
+        try {
+            response = await client.getFetch()(url, { method: 'GET', headers, redirect: 'manual', signal: controller.signal });
+        }
+        catch {
+            clearTimeout(timer);
+            close();
+            throw failure('TRANSPORT_ERROR');
+        }
+        const type = response.headers.get('content-type') ?? '';
+        if (response.status === 200 && /^text\/event-stream\b/i.test(type) && response.body) {
+            clearTimeout(timer);
+            return { status: response.status, stream: response.body, close };
+        }
+        try {
+            if (!response.body)
+                return { status: response.status, text: '' };
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder('utf-8', { fatal: true });
+            const chunks = [];
+            let size = 0;
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                size += value.byteLength;
+                if (size > this.unsV2MaxResponseBytes) {
+                    await reader.cancel().catch(() => undefined);
+                    throw new CloudTransportError('PROTOCOL_ERROR', response.status);
+                }
+                chunks.push(decoder.decode(value, { stream: true }));
+            }
+            chunks.push(decoder.decode());
+            return { status: response.status, text: chunks.join('') };
+        }
+        catch (error) {
+            if (error instanceof CloudTransportError)
+                throw error;
+            throw failure('PROTOCOL_ERROR', response.status);
+        }
+        finally {
+            clearTimeout(timer);
+            close();
+        }
+    }
+    async post(path, body) {
+        const client = this.resolveClient();
+        const url = `${client.getBaseURL()}${path}`;
+        const key = client.getApiKey();
+        const headers = { 'Content-Type': 'application/json' };
+        if (key) {
+            headers.Authorization = `Bearer ${key}`;
+            headers['X-API-Key'] = key;
+        }
+        const serialized = JSON.stringify(body);
+        const controller = new AbortController();
+        let response;
+        let timer;
+        const exchange = async () => {
+            try {
+                response = await client.getFetch()(url, { method: 'POST', headers, body: serialized, redirect: 'manual', signal: controller.signal });
+            }
+            catch {
+                throw new CloudTransportError('TRANSPORT_ERROR');
+            }
+            let value;
+            try {
+                value = await response.json();
+            }
+            catch {
+                throw new CloudTransportError('PROTOCOL_ERROR', response.status);
+            }
+            return { value, status: response.status, ok: response.ok };
+        };
+        try {
+            const deadline = new Promise((_resolve, reject) => {
+                timer = setTimeout(() => {
+                    controller.abort();
+                    reject(new CloudTransportError('TRANSPORT_TIMEOUT', response?.status));
+                }, this.timeoutMs);
+            });
+            // Also bounds custom transports which ignore AbortSignal.
+            return await Promise.race([exchange(), deadline]);
+        }
+        catch (error) {
+            if (controller.signal.aborted)
+                throw new CloudTransportError('TRANSPORT_TIMEOUT', response?.status);
+            throw error;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=cloud-transport.js.map

package/dist/esm/cloud-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-transport.js","sourceRoot":"","sources":["../../src/cloud-transport.ts"],"names":[],"mappings":"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","sourcesContent":["import { getClient, type HttpClient, type RequestOptions } from './openapi/client.js';\n\nexport interface CloudTransportConfig {\n  /** Whole HTTP exchange including the response body, in milliseconds; default 60,000. */\n  transportTimeoutMs?: number;\n  /** UNS v2 response body limit; may only tighten the 20 MiB contract/RPC ceiling. */\n  unsV2MaxResponseBytes?: number;\n  /**\n   * Opaque proof from the trusted App Gateway only: tier0.app-data-subject/v1,\n   * X-Tier0-App-Data-Subject, aud tier0-uns-data. Proof alone is not authentication;\n   * the SDK checks only compact syntax, never parses or trusts claims.\n   * Create a new client per incoming request; never reuse a token across users.\n   * Do not automatically forward the runtime App request assertion: its audience differs.\n   */\n  unsV2AppDataSubject?: string;\n}\n\nexport const DEFAULT_CLOUD_TRANSPORT_TIMEOUT_MS = 60_000;\n/** Header carrying `unsV2AppDataSubject`; the trusted App Gateway sets it on each business request. */\nexport const UNS_V2_APP_DATA_SUBJECT_HEADER = 'X-Tier0-App-Data-Subject';\nexport const UNS_V2_MAX_REQUEST_BYTES = 16 << 20;\nexport const UNS_V2_MAX_RESPONSE_BYTES = 20 << 20;\n\ntype Failure = 'TRANSPORT_ERROR' | 'PROTOCOL_ERROR' | 'TRANSPORT_TIMEOUT' | 'TRANSPORT_ABORTED';\n\n/** Internal redacted failure, translated by each public contract client. */\nexport class CloudTransportError extends Error {\n  constructor(readonly kind: Failure, readonly status?: number) {\n    super(kind);\n    this.name = 'CloudTransportError';\n  }\n}\n\n/** Single fetch, no redirects/retries; one deadline covers both headers and body. */\nexport class CloudTransport {\n  private readonly timeoutMs: number;\n  private readonly unsV2MaxResponseBytes: number;\n  readonly #unsV2AppDataSubject: string | undefined;\n\n  constructor(private readonly resolveClient: () => HttpClient = getClient, config: CloudTransportConfig = {}) {\n    const timeout = config.transportTimeoutMs ?? DEFAULT_CLOUD_TRANSPORT_TIMEOUT_MS;\n    if (!Number.isInteger(timeout) || timeout < 1 || timeout > 2_147_483_647) {\n      throw new TypeError('Tier0 SDK: transportTimeoutMs must be an integer between 1 and 2147483647.');\n    }\n    this.timeoutMs = timeout;\n    const maxResponseBytes = config.unsV2MaxResponseBytes ?? UNS_V2_MAX_RESPONSE_BYTES;\n    if (!Number.isInteger(maxResponseBytes) || maxResponseBytes < 1 || maxResponseBytes > UNS_V2_MAX_RESPONSE_BYTES) {\n      throw new TypeError('Tier0 SDK: unsV2MaxResponseBytes must be an integer between 1 and 20971520.');\n    }\n    this.unsV2MaxResponseBytes = maxResponseBytes;\n    const subject = config.unsV2AppDataSubject;\n    // ASCII-only syntax makes string length equal byte length. Do not trim or decode.\n    if (subject !== undefined && (typeof subject !== 'string' || subject.length > 8192 || /[^A-Za-z0-9_.-]/.test(subject) ||\n        !/^[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$/.test(subject))) {\n      throw new TypeError('Tier0 SDK: unsV2AppDataSubject must be a compact three-segment base64url token of at most 8192 ASCII bytes.');\n    }\n    this.#unsV2AppDataSubject = subject;\n  }\n\n  /** `retryAfter`: the raw `Retry-After` header, for answers without a UNS error body. */\n  async postText(path: string, body: string, options: RequestOptions = {}): Promise<{ text: string; status: number; ok: boolean; retryAfter?: string }> {\n    options.signal?.throwIfAborted();\n    const client = this.resolveClient();\n    const url = `${client.getBaseURL()}${path}`;\n    const key = client.getApiKey();\n    const headers: Record<string, string> = { 'Content-Type': 'application/json' };\n    // Control routes also live under UNS v2, but must never receive data delegation.\n    // Keep this per-client proof out of shared HTTP headers and Control capabilities.\n    if (path.startsWith('/openapi/v2/uns/') &&\n        !path.startsWith('/openapi/v2/uns/controls/') &&\n        path !== '/openapi/v2/uns/streams/runtime/capabilities/get' &&\n        this.#unsV2AppDataSubject !== undefined) {\n      headers[UNS_V2_APP_DATA_SUBJECT_HEADER] = this.#unsV2AppDataSubject;\n    }\n    if (key) {\n      headers.Authorization = `Bearer ${key}`;\n      headers['X-API-Key'] = key;\n    }\n    const controller = new AbortController();\n    let response: Response | undefined;\n    let reader: ReadableStreamDefaultReader<Uint8Array> | undefined;\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    let rejectAbort: (error: Error) => void = () => undefined;\n    const cancelled = new Promise<never>((_, reject) => { rejectAbort = reject; });\n    const onAbort = () => {\n      controller.abort();\n      void reader?.cancel().catch(() => undefined);\n      rejectAbort(new CloudTransportError('TRANSPORT_ABORTED', response?.status));\n    };\n    options.signal?.addEventListener('abort', onAbort, { once: true });\n    const exchange = async () => {\n      try {\n        response = await client.getFetch()(url, { method: 'POST', headers, body, redirect: 'manual', signal: controller.signal });\n      } catch {\n        throw new CloudTransportError('TRANSPORT_ERROR');\n      }\n      const declaredLength = response.headers.get('content-length');\n      if (declaredLength !== null && /^\\d+$/.test(declaredLength) && Number(declaredLength) > this.unsV2MaxResponseBytes) {\n        await response.body?.cancel().catch(() => undefined);\n        throw new CloudTransportError('PROTOCOL_ERROR', response.status);\n      }\n      if (!response.body) throw new CloudTransportError('PROTOCOL_ERROR', response.status);\n      reader = response.body.getReader();\n      const decoder = new TextDecoder('utf-8', { fatal: true });\n      const chunks: string[] = [];\n      let receivedBytes = 0;\n      try {\n        while (true) {\n          const { done, value } = await reader.read();\n          if (done) break;\n          receivedBytes += value.byteLength;\n          if (receivedBytes > this.unsV2MaxResponseBytes) {\n            await reader.cancel().catch(() => undefined);\n            throw new CloudTransportError('PROTOCOL_ERROR', response.status);\n          }\n          chunks.push(decoder.decode(value, { stream: true }));\n        }\n        chunks.push(decoder.decode());\n      } catch (error) {\n        if (error instanceof CloudTransportError) throw error;\n        throw new CloudTransportError('PROTOCOL_ERROR', response.status);\n      } finally {\n        reader.releaseLock();\n        reader = undefined;\n      }\n      const retryAfter = response.headers.get('retry-after') ?? undefined;\n      return { text: chunks.join(''), status: response.status, ok: response.ok, ...(retryAfter === undefined ? {} : { retryAfter }) };\n    };\n    try {\n      const deadline = new Promise<never>((_resolve, reject) => {\n        timer = setTimeout(() => {\n          controller.abort();\n          void reader?.cancel().catch(() => undefined);\n          reject(new CloudTransportError('TRANSPORT_TIMEOUT', response?.status));\n        }, this.timeoutMs);\n      });\n      // Also bounds custom transports which ignore AbortSignal.\n      return await Promise.race([exchange(), deadline, cancelled]);\n    } catch (error) {\n      if (controller.signal.aborted) throw new CloudTransportError(options.signal?.aborted ? 'TRANSPORT_ABORTED' : 'TRANSPORT_TIMEOUT', response?.status);\n      throw error;\n    } finally {\n      clearTimeout(timer);\n      options.signal?.removeEventListener('abort', onAbort);\n    }\n  }\n\n  /**\n   * Opens a server-sent event stream (GET, `Accept: text/event-stream`\n   * exactly, as the gateway requires). The deadline covers the response\n   * headers, and a non-stream body; a response that is not an event stream\n   * is read whole (bounded like any UNS v2 response) and returned as `text`.\n   * An open stream belongs to the caller: `close()` ends it and drops the\n   * link to `signal`, which also ends it.\n   */\n  async getEventStream(path: string, options: { lastEventId?: string; signal?: AbortSignal } = {}):\n    Promise<{ status: number; stream: ReadableStream<Uint8Array>; close(): void } | { status: number; text: string }> {\n    options.signal?.throwIfAborted();\n    const client = this.resolveClient();\n    const url = `${client.getBaseURL()}${path}`;\n    const key = client.getApiKey();\n    const headers: Record<string, string> = { Accept: 'text/event-stream' };\n    if (path.startsWith('/openapi/v2/uns/') && this.#unsV2AppDataSubject !== undefined) {\n      headers[UNS_V2_APP_DATA_SUBJECT_HEADER] = this.#unsV2AppDataSubject;\n    }\n    if (options.lastEventId !== undefined) headers['Last-Event-ID'] = options.lastEventId;\n    if (key) {\n      headers.Authorization = `Bearer ${key}`;\n      headers['X-API-Key'] = key;\n    }\n    const controller = new AbortController();\n    const onAbort = () => controller.abort();\n    const close = () => {\n      options.signal?.removeEventListener('abort', onAbort);\n      controller.abort();\n    };\n    options.signal?.addEventListener('abort', onAbort, { once: true });\n    let expired = false;\n    const timer = setTimeout(() => { expired = true; controller.abort(); }, this.timeoutMs);\n    const failure = (kind: Failure, status?: number) =>\n      new CloudTransportError(expired ? 'TRANSPORT_TIMEOUT' : controller.signal.aborted ? 'TRANSPORT_ABORTED' : kind, status);\n    let response: Response;\n    try {\n      response = await client.getFetch()(url, { method: 'GET', headers, redirect: 'manual', signal: controller.signal });\n    } catch {\n      clearTimeout(timer);\n      close();\n      throw failure('TRANSPORT_ERROR');\n    }\n    const type = response.headers.get('content-type') ?? '';\n    if (response.status === 200 && /^text\\/event-stream\\b/i.test(type) && response.body) {\n      clearTimeout(timer);\n      return { status: response.status, stream: response.body, close };\n    }\n    try {\n      if (!response.body) return { status: response.status, text: '' };\n      const reader = response.body.getReader();\n      const decoder = new TextDecoder('utf-8', { fatal: true });\n      const chunks: string[] = [];\n      let size = 0;\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n        size += value.byteLength;\n        if (size > this.unsV2MaxResponseBytes) {\n          await reader.cancel().catch(() => undefined);\n          throw new CloudTransportError('PROTOCOL_ERROR', response.status);\n        }\n        chunks.push(decoder.decode(value, { stream: true }));\n      }\n      chunks.push(decoder.decode());\n      return { status: response.status, text: chunks.join('') };\n    } catch (error) {\n      if (error instanceof CloudTransportError) throw error;\n      throw failure('PROTOCOL_ERROR', response.status);\n    } finally {\n      clearTimeout(timer);\n      close();\n    }\n  }\n\n  async post(path: string, body: unknown): Promise<{ value: unknown; status: number; ok: boolean }> {\n    const client = this.resolveClient();\n    const url = `${client.getBaseURL()}${path}`;\n    const key = client.getApiKey();\n    const headers: Record<string, string> = { 'Content-Type': 'application/json' };\n    if (key) {\n      headers.Authorization = `Bearer ${key}`;\n      headers['X-API-Key'] = key;\n    }\n    const serialized = JSON.stringify(body);\n    const controller = new AbortController();\n    let response: Response | undefined;\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    const exchange = async () => {\n      try {\n        response = await client.getFetch()(url, { method: 'POST', headers, body: serialized, redirect: 'manual', signal: controller.signal });\n      } catch {\n        throw new CloudTransportError('TRANSPORT_ERROR');\n      }\n      let value: unknown;\n      try {\n        value = await response.json();\n      } catch {\n        throw new CloudTransportError('PROTOCOL_ERROR', response.status);\n      }\n      return { value, status: response.status, ok: response.ok };\n    };\n    try {\n      const deadline = new Promise<never>((_resolve, reject) => {\n        timer = setTimeout(() => {\n          controller.abort();\n          reject(new CloudTransportError('TRANSPORT_TIMEOUT', response?.status));\n        }, this.timeoutMs);\n      });\n      // Also bounds custom transports which ignore AbortSignal.\n      return await Promise.race([exchange(), deadline]);\n    } catch (error) {\n      if (controller.signal.aborted) throw new CloudTransportError('TRANSPORT_TIMEOUT', response?.status);\n      throw error;\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n}\n"]}