@tier0/sdk-v2 0.0.0-stage → 0.1.0

package/dist/cjs/uns-v2/index.d.ts

@@ -0,0 +1,5 @@
+export * from './generated.js';
+export * from './client.js';
+export { UnsV2RawNumber } from './codec.js';
+export { createUnsDataClient } from './data-client.js';
+export type { UnsDataClient, UnsDataClientConfig, UnsDataOperationName } from './data-client.js';

package/dist/cjs/uns-v2/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUnsDataClient = exports.UnsV2RawNumber = void 0;
+__exportStar(require("./generated.js"), exports);
+__exportStar(require("./client.js"), exports);
+var codec_js_1 = require("./codec.js");
+Object.defineProperty(exports, "UnsV2RawNumber", { enumerable: true, get: function () { return codec_js_1.UnsV2RawNumber; } });
+var data_client_js_1 = require("./data-client.js");
+Object.defineProperty(exports, "createUnsDataClient", { enumerable: true, get: function () { return data_client_js_1.createUnsDataClient; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/uns-v2/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/uns-v2/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,8CAA4B;AAC5B,uCAA4C;AAAnC,0GAAA,cAAc,OAAA;AACvB,mDAAuD;AAA9C,qHAAA,mBAAmB,OAAA","sourcesContent":["export * from './generated.js';\r\nexport * from './client.js';\r\nexport { UnsV2RawNumber } from './codec.js';\r\nexport { createUnsDataClient } from './data-client.js';\r\nexport type { UnsDataClient, UnsDataClientConfig, UnsDataOperationName } from './data-client.js';\r\n"]}

package/dist/cjs/vue.d.ts

@@ -0,0 +1,9 @@
+import type { Tier0Client } from './client.js';
+/** Explicit execution, with latest-result wins and no automatic mutation replay. */
+export declare function useTier0Request<T, Variables>(client: Tier0Client, request: (client: Tier0Client, variables: Variables, signal: AbortSignal) => Promise<T>): {
+    data: import("vue").ShallowRef<T | undefined, T | undefined>;
+    error: import("vue").ShallowRef<unknown, unknown>;
+    loading: import("vue").ShallowRef<boolean, boolean>;
+    execute: (variables: Variables) => Promise<T>;
+    cancel: () => void;
+};

package/dist/cjs/vue.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTier0Request = useTier0Request;
+const vue_1 = require("vue");
+/** Explicit execution, with latest-result wins and no automatic mutation replay. */
+function useTier0Request(client, request) {
+    const data = (0, vue_1.shallowRef)();
+    const error = (0, vue_1.shallowRef)();
+    const loading = (0, vue_1.shallowRef)(false);
+    let controller;
+    let generation = 0;
+    const cancel = () => { generation++; controller?.abort(); loading.value = false; };
+    if ((0, vue_1.getCurrentScope)())
+        (0, vue_1.onScopeDispose)(cancel);
+    async function execute(variables) {
+        controller?.abort();
+        const own = ++generation;
+        const current = controller = new AbortController();
+        loading.value = true;
+        error.value = undefined;
+        try {
+            const result = await request(client, variables, current.signal);
+            if (own === generation)
+                data.value = result;
+            return result;
+        }
+        catch (failure) {
+            if (own === generation)
+                error.value = failure;
+            throw failure;
+        }
+        finally {
+            if (own === generation)
+                loading.value = false;
+        }
+    }
+    return { data, error, loading, execute, cancel };
+}
+//# sourceMappingURL=vue.js.map

package/dist/cjs/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.js","sourceRoot":"","sources":["../../src/vue.ts"],"names":[],"mappings":";;AAIA,0CAwBC;AA5BD,6BAAkE;AAGlE,oFAAoF;AACpF,SAAgB,eAAe,CAAe,MAAmB,EAAE,OAAuF;IACxJ,MAAM,IAAI,GAAG,IAAA,gBAAU,GAAK,CAAC;IAC7B,MAAM,KAAK,GAAG,IAAA,gBAAU,GAAW,CAAC;IACpC,MAAM,OAAO,GAAG,IAAA,gBAAU,EAAC,KAAK,CAAC,CAAC;IAClC,IAAI,UAAuC,CAAC;IAC5C,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,MAAM,MAAM,GAAG,GAAG,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACnF,IAAI,IAAA,qBAAe,GAAE;QAAE,IAAA,oBAAc,EAAC,MAAM,CAAC,CAAC;IAC9C,KAAK,UAAU,OAAO,CAAC,SAAoB;QACzC,UAAU,EAAE,KAAK,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,EAAE,UAAU,CAAC;QACzB,MAAM,OAAO,GAAG,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACnD,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;QACrB,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YAChE,IAAI,GAAG,KAAK,UAAU;gBAAE,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;YAC5C,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,OAAO,EAAE,CAAC;YACjB,IAAI,GAAG,KAAK,UAAU;gBAAE,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC;YAC9C,MAAM,OAAO,CAAC;QAChB,CAAC;gBAAS,CAAC;YAAC,IAAI,GAAG,KAAK,UAAU;gBAAE,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;QAAC,CAAC;IAC9D,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACnD,CAAC","sourcesContent":["import { shallowRef, onScopeDispose, getCurrentScope } from 'vue';\nimport type { Tier0Client } from './client.js';\n\n/** Explicit execution, with latest-result wins and no automatic mutation replay. */\nexport function useTier0Request<T, Variables>(client: Tier0Client, request: (client: Tier0Client, variables: Variables, signal: AbortSignal) => Promise<T>) {\n  const data = shallowRef<T>();\n  const error = shallowRef<unknown>();\n  const loading = shallowRef(false);\n  let controller: AbortController | undefined;\n  let generation = 0;\n  const cancel = () => { generation++; controller?.abort(); loading.value = false; };\n  if (getCurrentScope()) onScopeDispose(cancel);\n  async function execute(variables: Variables): Promise<T> {\n    controller?.abort();\n    const own = ++generation;\n    const current = controller = new AbortController();\n    loading.value = true;\n    error.value = undefined;\n    try {\n      const result = await request(client, variables, current.signal);\n      if (own === generation) data.value = result;\n      return result;\n    } catch (failure) {\n      if (own === generation) error.value = failure;\n      throw failure;\n    } finally { if (own === generation) loading.value = false; }\n  }\n  return { data, error, loading, execute, cancel };\n}\n"]}

package/dist/esm/app-identity-contract.generated.d.ts

@@ -0,0 +1,22 @@
+export declare const APP_REQUEST_IDENTITY_CONTRACT: {
+    readonly version: "tier0.app-request-identity/v1";
+    readonly header: "X-Tier0-App-Identity";
+    readonly type: "tier0-app-request+jwt";
+    readonly algorithm: "EdDSA";
+    readonly issuer: "tier0-app-gateway";
+    readonly audience: "tier0-app-runtime";
+    readonly maxTokenBytes: 8192;
+    readonly maxBodyBytes: 65536;
+    readonly maxURIBytes: 8192;
+    readonly maxTTLSeconds: 30;
+    readonly clockSkewSeconds: 5;
+    readonly maxRoles: 32;
+    readonly maxRoleBytes: 128;
+    readonly maxKeys: 8;
+    readonly keyIDPattern: "^[A-Za-z0-9][A-Za-z0-9_.-]{0,63}$";
+    readonly appIDPattern: "^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$";
+    readonly requiredClaims: readonly ["ver", "iss", "aud", "sub", "workspaceID", "appID", "method", "requestURI", "bodySHA256", "iat", "exp", "jti", "roles"];
+    readonly methodPattern: "^[A-Z]{1,16}$";
+    readonly requiredHeaderFields: readonly ["alg", "typ", "kid"];
+    readonly publicKeyFields: readonly ["kty", "crv", "x", "kid"];
+};

package/dist/esm/app-identity-contract.generated.js

@@ -0,0 +1,48 @@
+// Generated from SWE gatewayheader/app-request-identity.v1.json; do not edit.
+// Source SHA-256: ac5ec2efb882395e63a46c9ec479de16c09943b88fc0bd906dd77c7f9f4bfaa3
+export const APP_REQUEST_IDENTITY_CONTRACT = {
+    "version": "tier0.app-request-identity/v1",
+    "header": "X-Tier0-App-Identity",
+    "type": "tier0-app-request+jwt",
+    "algorithm": "EdDSA",
+    "issuer": "tier0-app-gateway",
+    "audience": "tier0-app-runtime",
+    "maxTokenBytes": 8192,
+    "maxBodyBytes": 65536,
+    "maxURIBytes": 8192,
+    "maxTTLSeconds": 30,
+    "clockSkewSeconds": 5,
+    "maxRoles": 32,
+    "maxRoleBytes": 128,
+    "maxKeys": 8,
+    "keyIDPattern": "^[A-Za-z0-9][A-Za-z0-9_.-]{0,63}$",
+    "appIDPattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+    "requiredClaims": [
+        "ver",
+        "iss",
+        "aud",
+        "sub",
+        "workspaceID",
+        "appID",
+        "method",
+        "requestURI",
+        "bodySHA256",
+        "iat",
+        "exp",
+        "jti",
+        "roles"
+    ],
+    "methodPattern": "^[A-Z]{1,16}$",
+    "requiredHeaderFields": [
+        "alg",
+        "typ",
+        "kid"
+    ],
+    "publicKeyFields": [
+        "kty",
+        "crv",
+        "x",
+        "kid"
+    ]
+};
+//# sourceMappingURL=app-identity-contract.generated.js.map

package/dist/esm/app-identity-contract.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-identity-contract.generated.js","sourceRoot":"","sources":["../../src/app-identity-contract.generated.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,mFAAmF;AACnF,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,SAAS,EAAE,+BAA+B;IAC1C,QAAQ,EAAE,sBAAsB;IAChC,MAAM,EAAE,uBAAuB;IAC/B,WAAW,EAAE,OAAO;IACpB,QAAQ,EAAE,mBAAmB;IAC7B,UAAU,EAAE,mBAAmB;IAC/B,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,KAAK;IACrB,aAAa,EAAE,IAAI;IACnB,eAAe,EAAE,EAAE;IACnB,kBAAkB,EAAE,CAAC;IACrB,UAAU,EAAE,EAAE;IACd,cAAc,EAAE,GAAG;IACnB,SAAS,EAAE,CAAC;IACZ,cAAc,EAAE,mCAAmC;IACnD,cAAc,EAAE,2EAA2E;IAC3F,gBAAgB,EAAE;QAChB,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,aAAa;QACb,OAAO;QACP,QAAQ;QACR,YAAY;QACZ,YAAY;QACZ,KAAK;QACL,KAAK;QACL,KAAK;QACL,OAAO;KACR;IACD,eAAe,EAAE,eAAe;IAChC,sBAAsB,EAAE;QACtB,KAAK;QACL,KAAK;QACL,KAAK;KACN;IACD,iBAAiB,EAAE;QACjB,KAAK;QACL,KAAK;QACL,GAAG;QACH,KAAK;KACN;CACO,CAAC","sourcesContent":["// Generated from SWE gatewayheader/app-request-identity.v1.json; do not edit.\r\n// Source SHA-256: ac5ec2efb882395e63a46c9ec479de16c09943b88fc0bd906dd77c7f9f4bfaa3\r\nexport const APP_REQUEST_IDENTITY_CONTRACT = {\r\n  \"version\": \"tier0.app-request-identity/v1\",\r\n  \"header\": \"X-Tier0-App-Identity\",\r\n  \"type\": \"tier0-app-request+jwt\",\r\n  \"algorithm\": \"EdDSA\",\r\n  \"issuer\": \"tier0-app-gateway\",\r\n  \"audience\": \"tier0-app-runtime\",\r\n  \"maxTokenBytes\": 8192,\r\n  \"maxBodyBytes\": 65536,\r\n  \"maxURIBytes\": 8192,\r\n  \"maxTTLSeconds\": 30,\r\n  \"clockSkewSeconds\": 5,\r\n  \"maxRoles\": 32,\r\n  \"maxRoleBytes\": 128,\r\n  \"maxKeys\": 8,\r\n  \"keyIDPattern\": \"^[A-Za-z0-9][A-Za-z0-9_.-]{0,63}$\",\r\n  \"appIDPattern\": \"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$\",\r\n  \"requiredClaims\": [\r\n    \"ver\",\r\n    \"iss\",\r\n    \"aud\",\r\n    \"sub\",\r\n    \"workspaceID\",\r\n    \"appID\",\r\n    \"method\",\r\n    \"requestURI\",\r\n    \"bodySHA256\",\r\n    \"iat\",\r\n    \"exp\",\r\n    \"jti\",\r\n    \"roles\"\r\n  ],\r\n  \"methodPattern\": \"^[A-Z]{1,16}$\",\r\n  \"requiredHeaderFields\": [\r\n    \"alg\",\r\n    \"typ\",\r\n    \"kid\"\r\n  ],\r\n  \"publicKeyFields\": [\r\n    \"kty\",\r\n    \"crv\",\r\n    \"x\",\r\n    \"kid\"\r\n  ]\r\n} as const;\r\n"]}

package/dist/esm/capabilities.d.ts

@@ -0,0 +1,54 @@
+import { type CloudTransportConfig } from './cloud-transport.js';
+import { type HttpClient } from './openapi/client.js';
+export type CapabilityCode = 'namespace.v2' | 'source.v1' | 'stream.v2' | 'control.v1' | 'control.invoke.v1';
+export type CapabilityState = 'disabled' | 'not_supported' | 'unavailable' | 'readiness_unknown' | 'ready';
+export type CapabilityAvailability = 'unavailable' | 'unknown' | 'available';
+export interface PublicCapability {
+    code: CapabilityCode;
+    /** Public release and workspace gates; does not establish runtime readiness. */
+    releaseEnabled: boolean;
+    /** Server-assessed implementation/readiness, never inferred from releaseEnabled. */
+    enabled: boolean;
+    /** Authorization summary, not a grant for every individual Control code. */
+    allowed: boolean;
+    state: CapabilityState;
+    /** Not device online status or execution/ACK confirmation. */
+    availability: CapabilityAvailability;
+    contractVersions: string[];
+}
+export interface CapabilityDeprecation {
+    contract: string;
+    replacement?: string;
+    sunsetAt?: string;
+}
+export interface CapabilityDiscoverResponse {
+    product: 'cloud';
+    /** Trusted server configuration only; absent when unconfigured. */
+    productVersion?: string;
+    contractVersion: '1.0';
+    apiContractVersions: string[];
+    interpreterContractVersions: string[];
+    /** Public SDK contract labels, not npm package versions. */
+    sdkContractVersions: string[];
+    capabilities: PublicCapability[];
+    deprecations: CapabilityDeprecation[];
+}
+export interface CapabilityErrorInfo {
+    status?: number;
+    /** Gateway string code (including unknown future codes), or an SDK-local CAPABILITY_* code. */
+    errorCode: string;
+}
+export declare class CapabilityError extends Error {
+    readonly status?: number;
+    readonly errorCode: string;
+    readonly retryable = false;
+    constructor(message: string, info: CapabilityErrorInfo);
+}
+export declare class CapabilitiesClient {
+    private readonly transport;
+    constructor(resolveClient?: () => HttpClient, config?: CloudTransportConfig);
+    /** Workspace comes exclusively from the authenticated key. One POST, no automatic retries or caching. */
+    discover(): Promise<CapabilityDiscoverResponse>;
+}
+/** Uses configureClient()/runtime environment, resolving the host and workspace key on every call. */
+export declare const capabilities: CapabilitiesClient;

package/dist/esm/capabilities.js

@@ -0,0 +1,129 @@
+import { CloudTransport, CloudTransportError } from './cloud-transport.js';
+import { getClient } from './openapi/client.js';
+export class CapabilityError extends Error {
+    status;
+    errorCode;
+    retryable = false;
+    constructor(message, info) {
+        super(message);
+        this.name = 'CapabilityError';
+        this.status = info.status;
+        this.errorCode = info.errorCode;
+    }
+}
+const contracts = {
+    'namespace.v2': ['openapi/v2'],
+    'source.v1': ['openapi/v1'],
+    'stream.v2': ['tier0-stream/v2'],
+    'control.v1': ['openapi/v1', 'control/v1'],
+    'control.invoke.v1': ['openapi/v1', 'tier0-stream/v2', 'control/v1'],
+};
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function text(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+function strings(value) {
+    return Array.isArray(value) && value.every(text) && new Set(value).size === value.length;
+}
+/** Validate and explicitly project the frozen contract; unknown capabilities/extension fields are ignored. */
+function discovery(value, status) {
+    const fail = (version = false) => {
+        throw new CapabilityError(version ? 'Unsupported capability contract version.' : 'Invalid capability discovery response.', {
+            status, errorCode: version ? 'CAPABILITY_UNSUPPORTED_VERSION' : 'CAPABILITY_PROTOCOL_ERROR',
+        });
+    };
+    if (!record(value))
+        return fail();
+    if (!text(value.product) || !text(value.contractVersion) ||
+        !strings(value.apiContractVersions) || !strings(value.interpreterContractVersions) || !strings(value.sdkContractVersions) ||
+        !Array.isArray(value.capabilities) || !Array.isArray(value.deprecations) ||
+        (value.productVersion !== undefined && !text(value.productVersion)))
+        return fail();
+    if (value.product !== 'cloud' || value.contractVersion !== '1.0' ||
+        !value.apiContractVersions.includes('openapi/v1') ||
+        !value.interpreterContractVersions.includes('tier0-stream/v2') ||
+        !value.sdkContractVersions.includes('control/v1'))
+        return fail(true);
+    const capabilities = [];
+    const seen = new Set();
+    for (const item of value.capabilities) {
+        if (!record(item) || !text(item.code))
+            return fail();
+        if (!Object.prototype.hasOwnProperty.call(contracts, item.code))
+            continue;
+        const code = item.code;
+        if (seen.has(code))
+            return fail();
+        seen.add(code);
+        if (typeof item.releaseEnabled !== 'boolean' || typeof item.enabled !== 'boolean' || typeof item.allowed !== 'boolean' ||
+            !['disabled', 'not_supported', 'unavailable', 'readiness_unknown', 'ready'].includes(item.state) ||
+            !['unavailable', 'unknown', 'available'].includes(item.availability) || !strings(item.contractVersions))
+            return fail();
+        if (contracts[code].some(version => !item.contractVersions.includes(version) ||
+            (version.startsWith('openapi/') && !value.apiContractVersions.includes(version))))
+            return fail(true);
+        const ready = item.state === 'ready';
+        const expectedAvailability = ready ? 'available' : item.state === 'readiness_unknown' ? 'unknown' : 'unavailable';
+        if (item.enabled !== ready || item.availability !== expectedAvailability ||
+            (ready && (!item.releaseEnabled || !item.allowed)) ||
+            (item.state === 'disabled' ? item.releaseEnabled : !item.releaseEnabled))
+            return fail();
+        capabilities.push({
+            code, releaseEnabled: item.releaseEnabled, enabled: item.enabled, allowed: item.allowed,
+            state: item.state, availability: item.availability,
+            contractVersions: [...item.contractVersions],
+        });
+    }
+    const deprecations = [];
+    for (const item of value.deprecations) {
+        if (!record(item) || !text(item.contract) ||
+            (item.replacement !== undefined && !text(item.replacement)) ||
+            (item.sunsetAt !== undefined && !text(item.sunsetAt)))
+            return fail();
+        deprecations.push({ contract: item.contract,
+            ...(item.replacement === undefined ? {} : { replacement: item.replacement }),
+            ...(item.sunsetAt === undefined ? {} : { sunsetAt: item.sunsetAt }),
+        });
+    }
+    return {
+        product: 'cloud', ...(value.productVersion === undefined ? {} : { productVersion: value.productVersion }),
+        contractVersion: '1.0', apiContractVersions: [...value.apiContractVersions],
+        interpreterContractVersions: [...value.interpreterContractVersions], sdkContractVersions: [...value.sdkContractVersions],
+        capabilities, deprecations,
+    };
+}
+export class CapabilitiesClient {
+    transport;
+    constructor(resolveClient = getClient, config = {}) {
+        this.transport = new CloudTransport(resolveClient, config);
+    }
+    /** Workspace comes exclusively from the authenticated key. One POST, no automatic retries or caching. */
+    async discover() {
+        if (arguments.length !== 0)
+            throw new TypeError('Tier0 SDK: capability discovery accepts no arguments.');
+        let response;
+        try {
+            response = await this.transport.post('/openapi/v1/capabilities/discover', {});
+        }
+        catch (error) {
+            if (!(error instanceof CloudTransportError))
+                throw error;
+            throw new CapabilityError('Capability discovery HTTP exchange failed.', {
+                status: error.status, errorCode: `CAPABILITY_${error.kind}`,
+            });
+        }
+        const { value, status, ok } = response;
+        if (!ok) {
+            if (!record(value) || !text(value.errorCode) || typeof value.message !== 'string') {
+                throw new CapabilityError('Invalid capability error response.', { status, errorCode: 'CAPABILITY_PROTOCOL_ERROR' });
+            }
+            throw new CapabilityError(value.message, { status, errorCode: value.errorCode });
+        }
+        return discovery(value, status);
+    }
+}
+/** Uses configureClient()/runtime environment, resolving the host and workspace key on every call. */
+export const capabilities = new CapabilitiesClient();
+//# sourceMappingURL=capabilities.js.map

package/dist/esm/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/capabilities.ts"],"names":[],"mappings":"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","sourcesContent":["import { CloudTransport, CloudTransportError, type CloudTransportConfig } from './cloud-transport.js';\r\nimport { getClient, type HttpClient } from './openapi/client.js';\r\n\r\nexport type CapabilityCode = 'namespace.v2' | 'source.v1' | 'stream.v2' | 'control.v1' | 'control.invoke.v1';\r\nexport type CapabilityState = 'disabled' | 'not_supported' | 'unavailable' | 'readiness_unknown' | 'ready';\r\nexport type CapabilityAvailability = 'unavailable' | 'unknown' | 'available';\r\n\r\nexport interface PublicCapability {\r\n  code: CapabilityCode;\r\n  /** Public release and workspace gates; does not establish runtime readiness. */\r\n  releaseEnabled: boolean;\r\n  /** Server-assessed implementation/readiness, never inferred from releaseEnabled. */\r\n  enabled: boolean;\r\n  /** Authorization summary, not a grant for every individual Control code. */\r\n  allowed: boolean;\r\n  state: CapabilityState;\r\n  /** Not device online status or execution/ACK confirmation. */\r\n  availability: CapabilityAvailability;\r\n  contractVersions: string[];\r\n}\r\n\r\nexport interface CapabilityDeprecation {\r\n  contract: string;\r\n  replacement?: string;\r\n  sunsetAt?: string;\r\n}\r\n\r\nexport interface CapabilityDiscoverResponse {\r\n  product: 'cloud';\r\n  /** Trusted server configuration only; absent when unconfigured. */\r\n  productVersion?: string;\r\n  contractVersion: '1.0';\r\n  apiContractVersions: string[];\r\n  interpreterContractVersions: string[];\r\n  /** Public SDK contract labels, not npm package versions. */\r\n  sdkContractVersions: string[];\r\n  capabilities: PublicCapability[];\r\n  deprecations: CapabilityDeprecation[];\r\n}\r\n\r\nexport interface CapabilityErrorInfo {\r\n  status?: number;\r\n  /** Gateway string code (including unknown future codes), or an SDK-local CAPABILITY_* code. */\r\n  errorCode: string;\r\n}\r\n\r\nexport class CapabilityError extends Error {\r\n  readonly status?: number;\r\n  readonly errorCode: string;\r\n  readonly retryable = false;\r\n\r\n  constructor(message: string, info: CapabilityErrorInfo) {\r\n    super(message);\r\n    this.name = 'CapabilityError';\r\n    this.status = info.status;\r\n    this.errorCode = info.errorCode;\r\n  }\r\n}\r\n\r\nconst contracts: Record<CapabilityCode, string[]> = {\r\n  'namespace.v2': ['openapi/v2'],\r\n  'source.v1': ['openapi/v1'],\r\n  'stream.v2': ['tier0-stream/v2'],\r\n  'control.v1': ['openapi/v1', 'control/v1'],\r\n  'control.invoke.v1': ['openapi/v1', 'tier0-stream/v2', 'control/v1'],\r\n};\r\n\r\nfunction record(value: unknown): value is Record<string, unknown> {\r\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\r\n}\r\nfunction text(value: unknown): value is string {\r\n  return typeof value === 'string' && value.length > 0;\r\n}\r\nfunction strings(value: unknown): value is string[] {\r\n  return Array.isArray(value) && value.every(text) && new Set(value).size === value.length;\r\n}\r\n\r\n/** Validate and explicitly project the frozen contract; unknown capabilities/extension fields are ignored. */\r\nfunction discovery(value: unknown, status: number): CapabilityDiscoverResponse {\r\n  const fail = (version = false): never => {\r\n    throw new CapabilityError(version ? 'Unsupported capability contract version.' : 'Invalid capability discovery response.', {\r\n      status, errorCode: version ? 'CAPABILITY_UNSUPPORTED_VERSION' : 'CAPABILITY_PROTOCOL_ERROR',\r\n    });\r\n  };\r\n  if (!record(value)) return fail();\r\n  if (!text(value.product) || !text(value.contractVersion) ||\r\n      !strings(value.apiContractVersions) || !strings(value.interpreterContractVersions) || !strings(value.sdkContractVersions) ||\r\n      !Array.isArray(value.capabilities) || !Array.isArray(value.deprecations) ||\r\n      (value.productVersion !== undefined && !text(value.productVersion))) return fail();\r\n  if (value.product !== 'cloud' || value.contractVersion !== '1.0' ||\r\n      !value.apiContractVersions.includes('openapi/v1') ||\r\n      !value.interpreterContractVersions.includes('tier0-stream/v2') ||\r\n      !value.sdkContractVersions.includes('control/v1')) return fail(true);\r\n\r\n  const capabilities: PublicCapability[] = [];\r\n  const seen = new Set<string>();\r\n  for (const item of value.capabilities) {\r\n    if (!record(item) || !text(item.code)) return fail();\r\n    if (!Object.prototype.hasOwnProperty.call(contracts, item.code)) continue;\r\n    const code = item.code as CapabilityCode;\r\n    if (seen.has(code)) return fail();\r\n    seen.add(code);\r\n    if (typeof item.releaseEnabled !== 'boolean' || typeof item.enabled !== 'boolean' || typeof item.allowed !== 'boolean' ||\r\n        !['disabled', 'not_supported', 'unavailable', 'readiness_unknown', 'ready'].includes(item.state as string) ||\r\n        !['unavailable', 'unknown', 'available'].includes(item.availability as string) || !strings(item.contractVersions)) return fail();\r\n    if (contracts[code].some(version =>\r\n      !(item.contractVersions as string[]).includes(version) ||\r\n      (version.startsWith('openapi/') && !(value.apiContractVersions as string[]).includes(version)))) return fail(true);\r\n    const ready = item.state === 'ready';\r\n    const expectedAvailability = ready ? 'available' : item.state === 'readiness_unknown' ? 'unknown' : 'unavailable';\r\n    if (item.enabled !== ready || item.availability !== expectedAvailability ||\r\n        (ready && (!item.releaseEnabled || !item.allowed)) ||\r\n        (item.state === 'disabled' ? item.releaseEnabled : !item.releaseEnabled)) return fail();\r\n    capabilities.push({\r\n      code, releaseEnabled: item.releaseEnabled, enabled: item.enabled, allowed: item.allowed,\r\n      state: item.state as CapabilityState, availability: item.availability as CapabilityAvailability,\r\n      contractVersions: [...item.contractVersions],\r\n    });\r\n  }\r\n  const deprecations: CapabilityDeprecation[] = [];\r\n  for (const item of value.deprecations) {\r\n    if (!record(item) || !text(item.contract) ||\r\n        (item.replacement !== undefined && !text(item.replacement)) ||\r\n        (item.sunsetAt !== undefined && !text(item.sunsetAt))) return fail();\r\n    deprecations.push({ contract: item.contract,\r\n      ...(item.replacement === undefined ? {} : { replacement: item.replacement as string }),\r\n      ...(item.sunsetAt === undefined ? {} : { sunsetAt: item.sunsetAt as string }),\r\n    });\r\n  }\r\n  return {\r\n    product: 'cloud', ...(value.productVersion === undefined ? {} : { productVersion: value.productVersion as string }),\r\n    contractVersion: '1.0', apiContractVersions: [...value.apiContractVersions],\r\n    interpreterContractVersions: [...value.interpreterContractVersions], sdkContractVersions: [...value.sdkContractVersions],\r\n    capabilities, deprecations,\r\n  };\r\n}\r\n\r\nexport class CapabilitiesClient {\r\n  private readonly transport: CloudTransport;\r\n\r\n  constructor(resolveClient: () => HttpClient = getClient, config: CloudTransportConfig = {}) {\r\n    this.transport = new CloudTransport(resolveClient, config);\r\n  }\r\n\r\n  /** Workspace comes exclusively from the authenticated key. One POST, no automatic retries or caching. */\r\n  async discover(): Promise<CapabilityDiscoverResponse> {\r\n    if (arguments.length !== 0) throw new TypeError('Tier0 SDK: capability discovery accepts no arguments.');\r\n    let response: Awaited<ReturnType<CloudTransport['post']>>;\r\n    try {\r\n      response = await this.transport.post('/openapi/v1/capabilities/discover', {});\r\n    } catch (error) {\r\n      if (!(error instanceof CloudTransportError)) throw error;\r\n      throw new CapabilityError('Capability discovery HTTP exchange failed.', {\r\n        status: error.status, errorCode: `CAPABILITY_${error.kind}`,\r\n      });\r\n    }\r\n    const { value, status, ok } = response;\r\n    if (!ok) {\r\n      if (!record(value) || !text(value.errorCode) || typeof value.message !== 'string') {\r\n        throw new CapabilityError('Invalid capability error response.', { status, errorCode: 'CAPABILITY_PROTOCOL_ERROR' });\r\n      }\r\n      throw new CapabilityError(value.message, { status, errorCode: value.errorCode });\r\n    }\r\n    return discovery(value, status);\r\n  }\r\n}\r\n\r\n/** Uses configureClient()/runtime environment, resolving the host and workspace key on every call. */\r\nexport const capabilities = new CapabilitiesClient();\r\n"]}