@tier0/sdk-v2 0.7.2 → 0.9.0

package/dist/cjs/streams/requests.d.ts

@@ -0,0 +1,93 @@
+import { StreamTransport, type StreamTransportConfig } from './transport.js';
+import type { components } from './contract.generated.js';
+/** Public request contracts do not expose runtime bindings. */
+export type StreamJSON = null | boolean | number | string | StreamJSON[] | {
+    [key: string]: StreamJSON;
+};
+export interface PublicStreamRequest extends Omit<components['schemas']['PublicStreamRequest'], 'inputSchema' | 'outputSchema' | 'sideEffect' | 'idempotency'> {
+    code: string;
+    name: string;
+    description: string;
+    contractVersion: string;
+    inputSchema: Record<string, StreamJSON>;
+    outputSchema: Record<string, StreamJSON>;
+    sideEffect: 'read' | 'write';
+    idempotency: 'none' | 'optional' | 'required';
+    timeoutMs: number;
+    status: string;
+}
+type WireDiscovery = components['schemas']['StreamRequestDiscoverReq'];
+export interface StreamRequestDiscoverOptions extends WireDiscovery {
+    page?: number;
+    size?: number;
+    search?: string;
+}
+export interface StreamRequestDiscoverResponse {
+    total: number;
+    list: PublicStreamRequest[];
+}
+/** HTTP transport settings do not override server execution semantics. */
+export interface StreamRequestTransportConfig extends StreamTransportConfig {
+}
+export declare const DEFAULT_STREAM_REQUEST_TRANSPORT_TIMEOUT_MS = 60000;
+export interface StreamRequestInvokeOptions {
+    /** Stable caller-owned key for one business intent, at most 128 UTF-8 bytes. Never generated or retried by the SDK. */
+    idempotencyKey?: string;
+}
+export interface StreamRequestInvokeResponse<Result = StreamJSON> extends Omit<components['schemas']['StreamRequestInvokeResp'], 'result' | 'status'> {
+    code: string;
+    contractVersion: string;
+    result: Result;
+    runID: string;
+    /** Persisted request ledger success; all other states reject conservatively. */
+    status: 'completed';
+    /** True only when the server explicitly reports an idempotent replay. */
+    replayed: boolean;
+}
+export interface StreamRequestErrorInfo {
+    /** HTTP status, absent when no HTTP response was received. */
+    status?: number;
+    /** Gateway string errorCode, or an SDK-local STREAM_REQUEST_* transport/protocol code. */
+    errorCode: string;
+    runID?: string;
+    contractVersion?: string;
+    runStatus?: string;
+    replayed?: boolean;
+}
+/** No StreamRequest error is automatically retried, including authentication failures. */
+export declare class StreamRequestError extends Error {
+    readonly status?: number;
+    readonly errorCode: string;
+    readonly runID?: string;
+    readonly contractVersion?: string;
+    readonly runStatus?: string;
+    readonly replayed?: boolean;
+    readonly retryable = false;
+    readonly outcomeUnknown: boolean;
+    constructor(message: string, info: StreamRequestErrorInfo);
+}
+/** Execution may have happened. Reconcile run information; any deliberate replay must reuse the same key. */
+export declare class StreamRequestResultUnknownError extends StreamRequestError {
+    readonly outcomeUnknown = true;
+    constructor(info: StreamRequestErrorInfo);
+}
+export interface StreamRequestHandle<Input = StreamJSON, Result = StreamJSON> {
+    describe(): Promise<PublicStreamRequest>;
+    /**
+     * One POST only. Input is opaque business JSON, including fields named streamId,
+     * entryId, deploymentVersion or timeoutMs. Only the server chooses binding/version/timeout.
+     * Generic types are caller assertions; the server validates the contract schemas.
+     */
+    invoke(input: Input, options?: StreamRequestInvokeOptions): Promise<StreamRequestInvokeResponse<Result>>;
+}
+export declare class StreamRequestsClient {
+    private readonly transport;
+    constructor(transport?: StreamTransport);
+    private post;
+    /** Discover visible contracts; defaults and authorization are resolved by the server. */
+    discover(options?: StreamRequestDiscoverOptions): Promise<StreamRequestDiscoverResponse>;
+    use<Input = StreamJSON, Result = StreamJSON>(selector: {
+        code: string;
+    }): StreamRequestHandle<Input, Result>;
+}
+export {};

package/dist/cjs/streams/requests.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamRequestsClient = exports.StreamRequestResultUnknownError = exports.StreamRequestError = exports.DEFAULT_STREAM_REQUEST_TRANSPORT_TIMEOUT_MS = void 0;
+const transport_js_1 = require("./transport.js");
+exports.DEFAULT_STREAM_REQUEST_TRANSPORT_TIMEOUT_MS = transport_js_1.DEFAULT_STREAM_TRANSPORT_TIMEOUT_MS;
+/** No StreamRequest error is automatically retried, including authentication failures. */
+class StreamRequestError extends Error {
+    status;
+    errorCode;
+    runID;
+    contractVersion;
+    runStatus;
+    replayed;
+    retryable = false;
+    outcomeUnknown = false;
+    constructor(message, info) {
+        super(message);
+        this.name = 'StreamRequestError';
+        this.status = info.status;
+        this.errorCode = info.errorCode;
+        this.runID = info.runID;
+        this.contractVersion = info.contractVersion;
+        this.runStatus = info.runStatus;
+        this.replayed = info.replayed;
+    }
+}
+exports.StreamRequestError = StreamRequestError;
+/** Execution may have happened. Reconcile run information; any deliberate replay must reuse the same key. */
+class StreamRequestResultUnknownError extends StreamRequestError {
+    outcomeUnknown = true;
+    constructor(info) {
+        super('StreamRequest result is unknown; execution may have occurred. Do not automatically retry.', info);
+        this.name = 'StreamRequestResultUnknownError';
+    }
+}
+exports.StreamRequestResultUnknownError = StreamRequestResultUnknownError;
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function keys(value, allowed) {
+    if (!record(value) || Reflect.ownKeys(value).some(key => typeof key !== 'string' || !allowed.includes(key))) {
+        throw new TypeError('Tier0 SDK: unsupported StreamRequest option.');
+    }
+}
+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 (typeof value !== 'object' || seen.has(value))
+        return false;
+    if (!Array.isArray(value) && Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null) {
+        return false;
+    }
+    seen.add(value);
+    const valid = (Array.isArray(value) ? Array.from(value) : Object.values(value)).every(item => json(item, seen));
+    seen.delete(value);
+    return valid;
+}
+function definition(value) {
+    if (!record(value))
+        return false;
+    return ['code', 'name', 'description', 'contractVersion', 'status'].every(key => typeof value[key] === 'string') &&
+        value.code !== '' && value.contractVersion !== '' && record(value.inputSchema) && record(value.outputSchema) &&
+        ['read', 'write'].includes(value.sideEffect) &&
+        ['none', 'optional', 'required'].includes(value.idempotency) &&
+        typeof value.timeoutMs === 'number' && Number.isSafeInteger(value.timeoutMs) && value.timeoutMs > 0;
+}
+function runInfo(value) {
+    if (!record(value))
+        return {};
+    return {
+        runID: typeof value.runID === 'string' ? value.runID : undefined,
+        contractVersion: typeof value.contractVersion === 'string' ? value.contractVersion : undefined,
+        runStatus: typeof value.status === 'string' ? value.status : undefined,
+        replayed: typeof value.replayed === 'boolean' ? value.replayed : undefined,
+    };
+}
+class StreamRequestsClient {
+    transport;
+    constructor(transport = new transport_js_1.StreamTransport()) {
+        this.transport = transport;
+    }
+    async post(path, body, invoked) {
+        let response;
+        try {
+            response = await this.transport.post(path, body);
+        }
+        catch (error) {
+            if (!(error instanceof transport_js_1.StreamTransportError))
+                throw error;
+            const info = { status: error.status, errorCode: `STREAM_REQUEST_${error.kind}` };
+            if (invoked)
+                throw new StreamRequestResultUnknownError(info);
+            const message = error.kind === 'TRANSPORT_TIMEOUT' ? 'StreamRequest HTTP transport deadline exceeded.' :
+                error.kind === 'PROTOCOL_ERROR' ? 'Invalid StreamRequest response.' : 'StreamRequest transport failed.';
+            throw new StreamRequestError(message, info);
+        }
+        const { value, status, ok } = response;
+        if (!ok) {
+            const error = record(value) ? value : {};
+            const valid = typeof error.errorCode === 'string' && typeof error.message === 'string';
+            const info = {
+                ...runInfo(value), status,
+                errorCode: valid ? error.errorCode : 'STREAM_REQUEST_PROTOCOL_ERROR',
+            };
+            if (info.errorCode === 'STREAM_REQUEST_RESULT_UNKNOWN' || (invoked && !valid)) {
+                throw new StreamRequestResultUnknownError(info);
+            }
+            throw new StreamRequestError(valid ? error.message : 'Invalid StreamRequest error response.', info);
+        }
+        return { value, status };
+    }
+    /** Discover visible contracts; defaults and authorization are resolved by the server. */
+    async discover(options = {}) {
+        keys(options, ['page', 'size', 'search']);
+        if ((options.page !== undefined && (!Number.isSafeInteger(options.page) || options.page < 1)) ||
+            (options.size !== undefined && (!Number.isSafeInteger(options.size) || options.size < 1 || options.size > 200)) ||
+            (options.search !== undefined && typeof options.search !== 'string')) {
+            throw new TypeError('Tier0 SDK: invalid StreamRequest discovery options.');
+        }
+        const { value, status } = await this.post('/openapi/v2/stream-requests/discover', options, false);
+        if (!record(value) || !Number.isSafeInteger(value.total) || value.total < 0 ||
+            !Array.isArray(value.list) || !value.list.every(definition)) {
+            throw new StreamRequestError('Invalid StreamRequest discovery response.', { status, errorCode: 'STREAM_REQUEST_PROTOCOL_ERROR' });
+        }
+        return value;
+    }
+    use(selector) {
+        keys(selector, ['code']);
+        const code = selector.code;
+        if (typeof code !== 'string' || code.length > 128 || !/^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$/.test(code)) {
+            throw new TypeError('Tier0 SDK: invalid StreamRequest code.');
+        }
+        const path = `/openapi/v2/stream-requests/${encodeURIComponent(code)}`;
+        return {
+            describe: async () => {
+                const { value, status } = await this.post(`${path}/describe`, {}, false);
+                if (!definition(value) || value.code !== code) {
+                    throw new StreamRequestError('Invalid StreamRequest description.', { status, errorCode: 'STREAM_REQUEST_PROTOCOL_ERROR' });
+                }
+                return value;
+            },
+            invoke: async (input, options = {}) => {
+                keys(options, ['idempotencyKey']);
+                const key = options.idempotencyKey;
+                if (key !== undefined && (typeof key !== 'string' || !key || key.trim() !== key || new TextEncoder().encode(key).length > 128)) {
+                    throw new TypeError('Tier0 SDK: invalid StreamRequest idempotency key.');
+                }
+                if (!json(input))
+                    throw new TypeError('Tier0 SDK: StreamRequest input must be JSON.');
+                const { value, status } = await this.post(`${path}/invoke`, {
+                    input, ...(key === undefined ? {} : { idempotencyKey: key }),
+                }, true);
+                if (!record(value) || value.code !== code || typeof value.contractVersion !== 'string' || !value.contractVersion ||
+                    !Object.prototype.hasOwnProperty.call(value, 'result') || typeof value.runID !== 'string' || !value.runID ||
+                    value.status !== 'completed' ||
+                    typeof value.replayed !== 'boolean') {
+                    throw new StreamRequestResultUnknownError({ ...runInfo(value), status, errorCode: 'STREAM_REQUEST_PROTOCOL_ERROR' });
+                }
+                return value;
+            },
+        };
+    }
+}
+exports.StreamRequestsClient = StreamRequestsClient;
+//# sourceMappingURL=requests.js.map

package/dist/cjs/streams/requests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.js","sourceRoot":"","sources":["../../../src/streams/requests.ts"],"names":[],"mappings":"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","sourcesContent":["import { StreamTransport, StreamTransportError, DEFAULT_STREAM_TRANSPORT_TIMEOUT_MS, type StreamTransportConfig } from './transport.js';\nimport type { components } from './contract.generated.js';\n/** Public request contracts do not expose runtime bindings. */\nexport type StreamJSON = null | boolean | number | string | StreamJSON[] | { [key: string]: StreamJSON };\n\nexport interface PublicStreamRequest extends Omit<components['schemas']['PublicStreamRequest'], 'inputSchema' | 'outputSchema' | 'sideEffect' | 'idempotency'> {\n  code: string;\n  name: string;\n  description: string;\n  contractVersion: string;\n  inputSchema: Record<string, StreamJSON>;\n  outputSchema: Record<string, StreamJSON>;\n  sideEffect: 'read' | 'write';\n  idempotency: 'none' | 'optional' | 'required';\n  timeoutMs: number;\n  status: string;\n}\n\ntype WireDiscovery = components['schemas']['StreamRequestDiscoverReq'];\nexport interface StreamRequestDiscoverOptions extends WireDiscovery {\n  page?: number;\n  size?: number;\n  search?: string;\n}\n\nexport interface StreamRequestDiscoverResponse {\n  total: number;\n  list: PublicStreamRequest[];\n}\n\n/** HTTP transport settings do not override server execution semantics. */\nexport interface StreamRequestTransportConfig extends StreamTransportConfig {}\n\nexport const DEFAULT_STREAM_REQUEST_TRANSPORT_TIMEOUT_MS = DEFAULT_STREAM_TRANSPORT_TIMEOUT_MS;\n\nexport interface StreamRequestInvokeOptions {\n  /** Stable caller-owned key for one business intent, at most 128 UTF-8 bytes. Never generated or retried by the SDK. */\n  idempotencyKey?: string;\n}\n\nexport interface StreamRequestInvokeResponse<Result = StreamJSON> extends Omit<components['schemas']['StreamRequestInvokeResp'], 'result' | 'status'> {\n  code: string;\n  contractVersion: string;\n  result: Result;\n  runID: string;\n  /** Persisted request ledger success; all other states reject conservatively. */\n  status: 'completed';\n  /** True only when the server explicitly reports an idempotent replay. */\n  replayed: boolean;\n}\n\nexport interface StreamRequestErrorInfo {\n  /** HTTP status, absent when no HTTP response was received. */\n  status?: number;\n  /** Gateway string errorCode, or an SDK-local STREAM_REQUEST_* transport/protocol code. */\n  errorCode: string;\n  runID?: string;\n  contractVersion?: string;\n  runStatus?: string;\n  replayed?: boolean;\n}\n\n/** No StreamRequest error is automatically retried, including authentication failures. */\nexport class StreamRequestError extends Error {\n  readonly status?: number;\n  readonly errorCode: string;\n  readonly runID?: string;\n  readonly contractVersion?: string;\n  readonly runStatus?: string;\n  readonly replayed?: boolean;\n  readonly retryable = false;\n  readonly outcomeUnknown: boolean = false;\n\n  constructor(message: string, info: StreamRequestErrorInfo) {\n    super(message);\n    this.name = 'StreamRequestError';\n    this.status = info.status;\n    this.errorCode = info.errorCode;\n    this.runID = info.runID;\n    this.contractVersion = info.contractVersion;\n    this.runStatus = info.runStatus;\n    this.replayed = info.replayed;\n  }\n}\n\n/** Execution may have happened. Reconcile run information; any deliberate replay must reuse the same key. */\nexport class StreamRequestResultUnknownError extends StreamRequestError {\n  readonly outcomeUnknown = true;\n\n  constructor(info: StreamRequestErrorInfo) {\n    super('StreamRequest result is unknown; execution may have occurred. Do not automatically retry.', info);\n    this.name = 'StreamRequestResultUnknownError';\n  }\n}\n\nfunction record(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction keys(value: unknown, allowed: string[]): void {\n  if (!record(value) || Reflect.ownKeys(value).some(key => typeof key !== 'string' || !allowed.includes(key))) {\n    throw new TypeError('Tier0 SDK: unsupported StreamRequest option.');\n  }\n}\n\nfunction json(value: unknown, seen = new Set<unknown>()): boolean {\n  if (value === null || typeof value === 'string' || typeof value === 'boolean') return true;\n  if (typeof value === 'number') return Number.isFinite(value);\n  if (typeof value !== 'object' || seen.has(value)) return false;\n  if (!Array.isArray(value) && Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null) {\n    return false;\n  }\n  seen.add(value);\n  const valid = (Array.isArray(value) ? Array.from(value) : Object.values(value)).every(item => json(item, seen));\n  seen.delete(value);\n  return valid;\n}\n\nfunction definition(value: unknown): value is PublicStreamRequest {\n  if (!record(value)) return false;\n  return ['code', 'name', 'description', 'contractVersion', 'status'].every(key => typeof value[key] === 'string') &&\n    value.code !== '' && value.contractVersion !== '' && record(value.inputSchema) && record(value.outputSchema) &&\n    ['read', 'write'].includes(value.sideEffect as string) &&\n    ['none', 'optional', 'required'].includes(value.idempotency as string) &&\n    typeof value.timeoutMs === 'number' && Number.isSafeInteger(value.timeoutMs) && value.timeoutMs > 0;\n}\n\nfunction runInfo(value: unknown): Partial<StreamRequestErrorInfo> {\n  if (!record(value)) return {};\n  return {\n    runID: typeof value.runID === 'string' ? value.runID : undefined,\n    contractVersion: typeof value.contractVersion === 'string' ? value.contractVersion : undefined,\n    runStatus: typeof value.status === 'string' ? value.status : undefined,\n    replayed: typeof value.replayed === 'boolean' ? value.replayed : undefined,\n  };\n}\n\nexport interface StreamRequestHandle<Input = StreamJSON, Result = StreamJSON> {\n  describe(): Promise<PublicStreamRequest>;\n  /**\n   * One POST only. Input is opaque business JSON, including fields named streamId,\n   * entryId, deploymentVersion or timeoutMs. Only the server chooses binding/version/timeout.\n   * Generic types are caller assertions; the server validates the contract schemas.\n   */\n  invoke(input: Input, options?: StreamRequestInvokeOptions): Promise<StreamRequestInvokeResponse<Result>>;\n}\n\nexport class StreamRequestsClient {\n  private readonly transport: StreamTransport;\n\n  constructor(transport = new StreamTransport()) {\n    this.transport = transport;\n  }\n\n  private async post(path: string, body: unknown, invoked: boolean): Promise<{ value: unknown; status: number }> {\n    let response: Awaited<ReturnType<StreamTransport['post']>>;\n    try {\n      response = await this.transport.post(path, body);\n    } catch (error) {\n      if (!(error instanceof StreamTransportError)) throw error;\n      const info = { status: error.status, errorCode: `STREAM_REQUEST_${error.kind}` };\n      if (invoked) throw new StreamRequestResultUnknownError(info);\n      const message = error.kind === 'TRANSPORT_TIMEOUT' ? 'StreamRequest HTTP transport deadline exceeded.' :\n        error.kind === 'PROTOCOL_ERROR' ? 'Invalid StreamRequest response.' : 'StreamRequest transport failed.';\n      throw new StreamRequestError(message, info);\n    }\n    const { value, status, ok } = response;\n    if (!ok) {\n      const error = record(value) ? value : {};\n      const valid = typeof error.errorCode === 'string' && typeof error.message === 'string';\n      const info: StreamRequestErrorInfo = {\n        ...runInfo(value), status,\n        errorCode: valid ? error.errorCode as string : 'STREAM_REQUEST_PROTOCOL_ERROR',\n      };\n      if (info.errorCode === 'STREAM_REQUEST_RESULT_UNKNOWN' || (invoked && !valid)) {\n        throw new StreamRequestResultUnknownError(info);\n      }\n      throw new StreamRequestError(valid ? error.message as string : 'Invalid StreamRequest error response.', info);\n    }\n    return { value, status };\n  }\n\n  /** Discover visible contracts; defaults and authorization are resolved by the server. */\n  async discover(options: StreamRequestDiscoverOptions = {}): Promise<StreamRequestDiscoverResponse> {\n    keys(options, ['page', 'size', 'search']);\n    if ((options.page !== undefined && (!Number.isSafeInteger(options.page) || options.page < 1)) ||\n        (options.size !== undefined && (!Number.isSafeInteger(options.size) || options.size < 1 || options.size > 200)) ||\n        (options.search !== undefined && typeof options.search !== 'string')) {\n      throw new TypeError('Tier0 SDK: invalid StreamRequest discovery options.');\n    }\n    const { value, status } = await this.post('/openapi/v2/stream-requests/discover', options, false);\n    if (!record(value) || !Number.isSafeInteger(value.total) || (value.total as number) < 0 ||\n        !Array.isArray(value.list) || !value.list.every(definition)) {\n      throw new StreamRequestError('Invalid StreamRequest discovery response.', { status, errorCode: 'STREAM_REQUEST_PROTOCOL_ERROR' });\n    }\n    return value as unknown as StreamRequestDiscoverResponse;\n  }\n\n  use<Input = StreamJSON, Result = StreamJSON>(selector: { code: string }): StreamRequestHandle<Input, Result> {\n    keys(selector, ['code']);\n    const code = selector.code;\n    if (typeof code !== 'string' || code.length > 128 || !/^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$/.test(code)) {\n      throw new TypeError('Tier0 SDK: invalid StreamRequest code.');\n    }\n    const path = `/openapi/v2/stream-requests/${encodeURIComponent(code)}`;\n    return {\n      describe: async () => {\n        const { value, status } = await this.post(`${path}/describe`, {}, false);\n        if (!definition(value) || value.code !== code) {\n          throw new StreamRequestError('Invalid StreamRequest description.', { status, errorCode: 'STREAM_REQUEST_PROTOCOL_ERROR' });\n        }\n        return value;\n      },\n      invoke: async (input, options = {}) => {\n        keys(options, ['idempotencyKey']);\n        const key = options.idempotencyKey;\n        if (key !== undefined && (typeof key !== 'string' || !key || key.trim() !== key || new TextEncoder().encode(key).length > 128)) {\n          throw new TypeError('Tier0 SDK: invalid StreamRequest idempotency key.');\n        }\n        if (!json(input)) throw new TypeError('Tier0 SDK: StreamRequest input must be JSON.');\n        const { value, status } = await this.post(`${path}/invoke`, {\n          input, ...(key === undefined ? {} : { idempotencyKey: key }),\n        }, true);\n        if (!record(value) || value.code !== code || typeof value.contractVersion !== 'string' || !value.contractVersion ||\n            !Object.prototype.hasOwnProperty.call(value, 'result') || typeof value.runID !== 'string' || !value.runID ||\n            value.status !== 'completed' ||\n            typeof value.replayed !== 'boolean') {\n          throw new StreamRequestResultUnknownError({ ...runInfo(value), status, errorCode: 'STREAM_REQUEST_PROTOCOL_ERROR' });\n        }\n        return value as unknown as StreamRequestInvokeResponse<Result>;\n      },\n    };\n  }\n}\n"]}

package/dist/cjs/streams/transport.d.ts

@@ -0,0 +1,16 @@
+import { type HttpClient } from '../openapi/client.js';
+import { type AppRuntime } from '../runtime.js';
+import { CloudTransport, CloudTransportError, type CloudTransportConfig } from '../cloud-transport.js';
+export type StreamTransportConfig = Pick<CloudTransportConfig, 'transportTimeoutMs'>;
+export declare const DEFAULT_STREAM_TRANSPORT_TIMEOUT_MS = 60000;
+export { CloudTransportError as StreamTransportError };
+/** Add the trusted App bridge to the existing single-attempt Cloud transport. */
+export declare class StreamTransport extends CloudTransport {
+    readonly runtime: () => AppRuntime | undefined;
+    constructor(resolveClient?: () => HttpClient, config?: StreamTransportConfig, runtime?: () => AppRuntime | undefined);
+    post(path: string, body: unknown, signal?: AbortSignal): Promise<{
+        value: unknown;
+        status: number;
+        ok: boolean;
+    }>;
+}

package/dist/cjs/streams/transport.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamTransport = exports.StreamTransportError = exports.DEFAULT_STREAM_TRANSPORT_TIMEOUT_MS = void 0;
+const client_js_1 = require("../openapi/client.js");
+const runtime_js_1 = require("../runtime.js");
+const cloud_transport_js_1 = require("../cloud-transport.js");
+Object.defineProperty(exports, "StreamTransportError", { enumerable: true, get: function () { return cloud_transport_js_1.CloudTransportError; } });
+exports.DEFAULT_STREAM_TRANSPORT_TIMEOUT_MS = cloud_transport_js_1.DEFAULT_CLOUD_TRANSPORT_TIMEOUT_MS;
+/** Add the trusted App bridge to the existing single-attempt Cloud transport. */
+class StreamTransport extends cloud_transport_js_1.CloudTransport {
+    runtime;
+    constructor(resolveClient = client_js_1.getClient, config = {}, runtime = runtime_js_1.getAppRuntime) {
+        super(resolveClient, config);
+        this.runtime = runtime;
+    }
+    async post(path, body, signal) {
+        const runtime = this.runtime();
+        if (!runtime && typeof window !== 'undefined')
+            throw new cloud_transport_js_1.CloudTransportError('TRANSPORT_ERROR');
+        return super.post(path, body, signal, runtime);
+    }
+}
+exports.StreamTransport = StreamTransport;
+//# sourceMappingURL=transport.js.map

package/dist/cjs/streams/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/streams/transport.ts"],"names":[],"mappings":";;;AAAA,oDAAkE;AAClE,8CAA+D;AAC/D,8DAA2I;AAI3G,qGAJP,wCAAmB,OAIQ;AADvC,QAAA,mCAAmC,GAAG,uDAAkC,CAAC;AAGtF,iFAAiF;AACjF,MAAa,eAAgB,SAAQ,mCAAc;IAItC;IAHX,YACE,gBAAkC,qBAAS,EAC3C,SAAgC,EAAE,EACzB,UAAwC,0BAAa;QAE9D,KAAK,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAFpB,YAAO,GAAP,OAAO,CAA8C;IAGhE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,IAAa,EAAE,MAAoB;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,MAAM,IAAI,wCAAmB,CAAC,iBAAiB,CAAC,CAAC;QAChG,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;CACF;AAdD,0CAcC","sourcesContent":["import { getClient, type HttpClient } from '../openapi/client.js';\nimport { getAppRuntime, type AppRuntime } from '../runtime.js';\nimport { CloudTransport, CloudTransportError, DEFAULT_CLOUD_TRANSPORT_TIMEOUT_MS, type CloudTransportConfig } from '../cloud-transport.js';\n\nexport type StreamTransportConfig = Pick<CloudTransportConfig, 'transportTimeoutMs'>;\nexport const DEFAULT_STREAM_TRANSPORT_TIMEOUT_MS = DEFAULT_CLOUD_TRANSPORT_TIMEOUT_MS;\nexport { CloudTransportError as StreamTransportError };\n\n/** Add the trusted App bridge to the existing single-attempt Cloud transport. */\nexport class StreamTransport extends CloudTransport {\n  constructor(\n    resolveClient: () => HttpClient = getClient,\n    config: StreamTransportConfig = {},\n    readonly runtime: () => AppRuntime | undefined = getAppRuntime,\n  ) {\n    super(resolveClient, config);\n  }\n\n  async post(path: string, body: unknown, signal?: AbortSignal) {\n    const runtime = this.runtime();\n    if (!runtime && typeof window !== 'undefined') throw new CloudTransportError('TRANSPORT_ERROR');\n    return super.post(path, body, signal, runtime);\n  }\n}\n"]}

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

@@ -29,8 +29,10 @@ export type UnsV2FieldOperation = ({
 }) | ({
     "op"?: "append" | "addToSet";
     "value"?: Array<UnsV2JSONValue>;
-}) | ({
+}) | (({
     "op"?: "unset";
+}) & {
+    "value"?: never;
 }));
 export type UnsV2ResultBinding = {
     "path": string;
@@ -64,8 +66,10 @@ export type UnsV2PipelinePage = ({
     "mode"?: "offset" | "cursor";
     "page"?: UnsV2Integer;
     "cursor"?: string;
-}) & ((({
+}) & (((({
     "mode": "cursor";
+}) & {
+    "page"?: never;
 }) | ({
     "mode"?: "offset";
 })));
@@ -392,7 +396,7 @@ export type TransactionQueryResult = {
 };
 export type UnsV2SourceStateUpdateReq = {
     "idempotencyKey"?: string;
-    "dryRun": boolean;
+    "dryRun"?: boolean;
     "allowPartial"?: false;
     "mode"?: "auto" | "sync";
     "items": (Array<({
@@ -508,7 +512,7 @@ export type UnsV2StreamProgramVersionsListResponse = {
 };
 export type UnsV2StreamProgramDeployReq = {
     "idempotencyKey"?: string;
-    "dryRun": boolean;
+    "dryRun"?: boolean;
     "id": string;
     "expectedRevision"?: UnsV2Integer;
     "expectedSourceRevision"?: UnsV2Integer;
@@ -722,8 +726,10 @@ export type UnsV2RecordChange = ({
     "conditions"?: UnsV2JSONValue;
 }))) & ((({
     "selection": "first";
-}) | ({
+}) | (({
     "selection"?: "exactOne";
+}) & {
+    "sort"?: never;
 }))) & ((({
     "upsert"?: false;
 }) | ({
@@ -908,8 +914,10 @@ export type UnsV2PipelineStage = (({
         "pipeline"?: Array<UnsV2PipelineStage>;
     }) & (({
         "kind": "samples";
-    }) | ({
+    }) | (({
         "kind"?: "records";
+    }) & {
+        "recordId"?: never;
     })));
 }) | ({
     "$unwind": ((string | ({
@@ -1395,7 +1403,7 @@ export type CloudSourceConfig = (({
 export type CloudSourceDocument = ({
     "name": string;
     "description"?: string;
-    "protocol": "http-api" | "modbus" | "mqtt" | "opcua" | "sap" | "teamcenter" | "mqtt_device" | "sql";
+    "protocol": "http-api" | "modbus" | "mqtt" | "opcua" | "sap" | "teamcenter" | "mqtt_device" | "sql" | "edge";
     "config": CloudSourceConfig;
 });
 export type CloudStreamRequestDefinition = {
@@ -1528,7 +1536,7 @@ export type CloudSourceDocumentGetResponse = {
     "data": ((CloudSourceDocumentView | CloudSourceDocumentSummary));
 };
 export type CloudSourceDocumentCreateReq = ({
-    "dryRun": boolean;
+    "dryRun"?: boolean;
     "idempotencyKey"?: string;
     "document"?: CloudSourceDocument;
     "credentials"?: CloudSourceCreateCredentials;
@@ -1544,7 +1552,7 @@ export type CloudSourceDocumentCreateResponse = {
     "data": ((CloudSourceDocumentView | CloudPreviewResult | Outcome));
 };
 export type CloudSourceDocumentUpdateReq = ({
-    "dryRun": boolean;
+    "dryRun"?: boolean;
     "idempotencyKey"?: string;
     "id"?: string;
     "expectedRevision"?: UnsV2Integer;
@@ -1576,7 +1584,7 @@ export type CloudStreamDocumentGetResponse = {
     "data": ((CloudStreamDocumentView | CloudStreamDocumentSummary));
 };
 export type CloudStreamDocumentCreateReq = ({
-    "dryRun": boolean;
+    "dryRun"?: boolean;
     "idempotencyKey"?: string;
     "document"?: CloudStreamDocument;
     "program"?: RuntimeStreamDefinition;
@@ -1589,7 +1597,7 @@ export type CloudStreamDocumentCreateResponse = {
     "data": ((CloudStreamDocumentView | CloudPreviewResult));
 };
 export type CloudStreamDocumentUpdateReq = ({
-    "dryRun": boolean;
+    "dryRun"?: boolean;
     "idempotencyKey"?: string;
     "id": string;
     "expectedRevision"?: UnsV2Integer;
@@ -1611,7 +1619,7 @@ export type CloudSourceDocumentListReq = {
     "page"?: UnsV2Integer;
     "size"?: UnsV2Integer;
     "search"?: string;
-    "protocol"?: "http-api" | "modbus" | "mqtt" | "opcua" | "sap" | "teamcenter" | "mqtt_device" | "sql";
+    "protocol"?: "http-api" | "modbus" | "mqtt" | "opcua" | "sap" | "teamcenter" | "mqtt_device" | "sql" | "edge";
     "desiredState"?: "enabled" | "disabled";
     "health"?: string;
     "archived"?: boolean;
@@ -2000,6 +2008,7 @@ export type CloudAppDataRule = {
 };
 export type CloudAppCollectionDeclaration = {
     "alias": string;
+    "name": string;
     "recordSchema": Schema;
     "indexes"?: Array<IndexSpec>;
     "description"?: string;
@@ -2353,10 +2362,14 @@ export type UnsV2RecordUnlockReq = ({
     })>);
     "ids"?: Array<string>;
     "force"?: boolean;
-}) & (({
+}) & ((({
     "force"?: false;
-}) | ({
+}) & {
+    "ids"?: never;
+}) | (({
     "force": true;
+}) & {
+    "locks"?: never;
 }));
 export type UnsV2RecordUnlockResponse = {
     "code": UnsV2Integer;
@@ -2575,7 +2588,7 @@ export type CloudStreamRunError = {
 };
 export type CloudSourceCreateCredentials = ({
     "method"?: "GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "REQUEST";
-    "kind": "basic" | "bearer" | "apiKey" | "oauth2ClientCredentials";
+    "kind": "basic" | "bearer" | "apiKey" | "oauth2ClientCredentials" | "usernamePassword";
     "material": {};
 }) & (({
     "kind"?: "basic";
@@ -2605,6 +2618,14 @@ export type CloudSourceCreateCredentials = ({
         "scope"?: string;
         "clientAuthentication"?: "client_secret_post" | "client_secret_basic";
     });
+}) | (({
+    "kind"?: "usernamePassword";
+    "material"?: ({
+        "username": string;
+        "password": string;
+    });
+}) & {
+    "method"?: never;
 }));
 export type UnsV2MetadataFindReq = ((({
     "kind": "directory" | "topic" | "collection";
@@ -7084,6 +7105,9 @@ export declare const UNS_V2_CODEC_SCHEMAS: {
             readonly a: readonly [{
                 readonly k: "o";
                 readonly p: {
+                    readonly credentials: {
+                        readonly k: "o";
+                    };
                     readonly document: {
                         readonly k: "o";
                         readonly p: {
@@ -7093,6 +7117,16 @@ export declare const UNS_V2_CODEC_SCHEMAS: {
                         };
                     };
                 };
+            }, {
+                readonly k: "o";
+                readonly p: {
+                    readonly credentials: {
+                        readonly k: "o";
+                    };
+                    readonly document: {
+                        readonly k: "o";
+                    };
+                };
             }];
         }];
     };
@@ -8878,6 +8912,13 @@ export declare const UNS_V2_CODEC_SCHEMAS: {
                     readonly k: "o";
                 };
             };
+        }, {
+            readonly k: "o";
+            readonly p: {
+                readonly material: {
+                    readonly k: "o";
+                };
+            };
         }];
     };
     readonly UnsV2MetadataFindReq: {
@@ -9773,11 +9814,11 @@ export declare const UNS_V2_CODEC_SCHEMAS: {
 };
 export declare const UNS_V2_CONTRACT_PROVENANCE: {
     readonly repository: "FREEZONEX/Tier0-Backend";
-    readonly revision: "397ac88a89593872cf76ad579a3c59753d832668";
+    readonly revision: "2828a0b9f9d16ebfbf2bf25c750a0a931c80354e";
     readonly version: "5.0.0";
     readonly source: "service/unssvr/internal/domain/unsv2/contract_generated.go#ContractJSON";
-    readonly cloudRevision: "397ac88a89593872cf76ad579a3c59753d832668";
-    readonly cloudContractRevision: "cloud-source-impact/2+source-vendor/2+app-create-capability/1+data/3+record-reads/1+stream-receipt/1+stream-run-error/1+collection-namespace/1+http-acquisition/2+http-source-role/1+http-source-request/1+app-collection/2+collection-ownership/1+metadata/1+app-context/3+collection-ttl/1+error-model/1+crud-consolidation/1+record-insert-return/1+lifecycle-consolidation/1+api-surface/2+source-stream-single-model+app-data/2+hosted-control/1+source-bindings/1+record-notifications/1+record-delete-samples/1+stream-history/1+app-collections/1+http-in/1+app-resource-access/2+stream-control-probe-retirement/1+http-push-retirement/1";
+    readonly cloudRevision: "2828a0b9f9d16ebfbf2bf25c750a0a931c80354e";
+    readonly cloudContractRevision: "cloud-source-impact/2+source-vendor/2+app-create-capability/1+data/3+record-reads/1+stream-receipt/1+stream-run-error/1+collection-namespace/1+business-name/1+http-acquisition/2+http-source-role/1+http-source-request/1+sql-inline-credentials/1+app-collection/2+collection-ownership/1+metadata/1+app-context/3+collection-ttl/1+error-model/1+crud-consolidation/1+record-insert-return/1+lifecycle-consolidation/1+mutation-defaults/1+api-surface/2+source-stream-single-model+app-data/2+hosted-control/1+source-bindings/1+record-notifications/1+record-delete-samples/1+stream-history/1+app-collections/1+http-in/1+app-resource-access/2+stream-control-probe-retirement/1+http-push-retirement/1";
     readonly resolvedCloudContract: true;
     readonly enterpriseBase: {
         readonly repository: "FREEZONEX/Tier0-Enterprise-New";
@@ -9793,12 +9834,37 @@ export declare const UNS_V2_CONTRACT_PROVENANCE: {
             readonly capability: "x-tier0-opcua-server: static available=false; online availability is workspace/registry authoritative";
         };
     };
-    readonly sourceDerivedContractSHA256: "79ff4d98f2239e3b2a3fbdea7afe4683171ff2dac0e0a917aaab3492d806910d";
+    readonly sourceDerivedContractSHA256: "a8c280d90b9d865a80637d7b563bd72611aead54bf0422a0cf83e05feaacd724";
+    readonly schemaUpdates: readonly [{
+        readonly scope: "source-stream-acquisition";
+        readonly repository: "FREEZONEX/Tier0-Backend";
+        readonly revision: "2828a0b9f9d16ebfbf2bf25c750a0a931c80354e";
+        readonly sourceKind: "committed";
+        readonly source: "share/unscontract/manifest.json";
+        readonly sourceSHA256: "c92e134799190fda29360a2983692ed47fb421a85fa7d92267ce091ac263dac8";
+        readonly sourceContractRevision: "cloud-source-impact/2+source-vendor/2+app-create-capability/1+data/3+record-reads/1+stream-receipt/1+stream-run-error/1+collection-namespace/1+business-name/1+http-acquisition/2+http-source-role/1+http-source-request/1+sql-inline-credentials/1+app-collection/2+collection-ownership/1+metadata/1+app-context/3+collection-ttl/1+error-model/1+crud-consolidation/1+record-insert-return/1+lifecycle-consolidation/1+mutation-defaults/1+api-surface/2+source-stream-single-model+app-data/2+hosted-control/1+source-bindings/1+record-notifications/1+record-delete-samples/1+stream-history/1+app-collections/1+http-in/1+app-resource-access/2+stream-control-probe-retirement/1+http-push-retirement/1";
+        readonly schemas: readonly ["CloudSourceCreateCredentials", "CloudSourceDocumentCreateReq", "CloudSourceDocumentUpdateReq", "UnsV2SourceStateUpdateReq", "CloudStreamDocumentCreateReq", "CloudStreamDocumentUpdateReq", "UnsV2StreamProgramDeployReq"];
+        readonly inputs: {
+            readonly "contracts/uns-v2/manifest.json": {
+                readonly path: "share/unscontract/manifest.json";
+                readonly sourceSHA256: "c92e134799190fda29360a2983692ed47fb421a85fa7d92267ce091ac263dac8";
+                readonly baseSHA256: "c92e134799190fda29360a2983692ed47fb421a85fa7d92267ce091ac263dac8";
+                readonly resultSHA256: "c92e134799190fda29360a2983692ed47fb421a85fa7d92267ce091ac263dac8";
+            };
+            readonly "contracts/uns-v2/contract.json": {
+                readonly path: "share/unscontract/manifest.json";
+                readonly sourceSHA256: "c92e134799190fda29360a2983692ed47fb421a85fa7d92267ce091ac263dac8";
+                readonly baseSHA256: "a8c280d90b9d865a80637d7b563bd72611aead54bf0422a0cf83e05feaacd724";
+                readonly resultSHA256: "a8c280d90b9d865a80637d7b563bd72611aead54bf0422a0cf83e05feaacd724";
+            };
+        };
+    }];
+    readonly note: "Pinned base with reviewed acquisition schema updates; schemaUpdates records the exact source revision and hashes. Other data-model inputs remain pinned.";
     readonly hashes: {
-        readonly contract: "79ff4d98f2239e3b2a3fbdea7afe4683171ff2dac0e0a917aaab3492d806910d";
+        readonly contract: "a8c280d90b9d865a80637d7b563bd72611aead54bf0422a0cf83e05feaacd724";
         readonly cloudSupport: "4ff9d5ff69e35e38459287cf15df45ab627684e2e2294dfd1e076ebc4fc34b46";
-        readonly manifest: "99ec4e32de02c631281631a9601b9d1596ecc4197b55de14dbdd68082b984086";
-        readonly provenance: "2ab9d24b0953242259acf240609b4fbc6142071d6fd462852d2ed71f8674cae4";
+        readonly manifest: "c92e134799190fda29360a2983692ed47fb421a85fa7d92267ce091ac263dac8";
+        readonly provenance: "297cb4fdbca4ea5a01f9191fc32e0cf0374575dbca8d700403726af78dae0c88";
         readonly registry: "c74313c217742d50391a94c09e60d5c5bd1a89c305fa4145cbf23b35ba7dbcdb";
     };
     readonly publicOperationCount: 82;