@tier0/sdk-v2 0.1.0 → 0.2.2

package/dist/esm/uns-v2/client.d.ts

@@ -1,15 +1,27 @@
 import { type CloudTransportConfig } from '../cloud-transport.js';
 import { type HttpClient, type RequestOptions } from '../openapi/client.js';
-import { type RetryAdvice, type UnsV2OperationName, type UnsV2Operations, type UnsV2Request, type UnsV2Response } from './generated.js';
+import { type CloudRecordSubscribeReq, type UnsV2OperationName, type UnsV2StreamOperationName, type UnsV2Operations, type UnsV2Request, type UnsV2Response } from './generated.js';
 type RecordValue = Record<string, unknown>;
+/**
+ * How far a failed request got. `unknown` only for a mutation whose commit
+ * cannot be confirmed; a read is never `unknown`.
+ */
+export type UnsV2Execution = 'notStarted' | 'rolledBack' | 'committed' | 'unknown';
+export declare const UNS_V2_EXECUTIONS: readonly UnsV2Execution[];
+/** Whether the identical request (same idempotency key) may be sent again, and after how long. */
+export interface UnsV2Retry {
+    safe: boolean;
+    afterMs?: number;
+}
+/** Generated POST operations, or a GET event stream such as `recordSubscribe`. */
+export type UnsV2ErrorOperation = UnsV2OperationName | UnsV2StreamOperationName;
 export interface UnsV2ErrorInfo {
     status?: number;
-    operation: UnsV2OperationName;
+    operation: UnsV2ErrorOperation;
     code: string;
     requestId?: string;
-    retryable: boolean;
-    retryAdvice?: RetryAdvice;
-    rolledBack?: boolean;
+    execution: UnsV2Execution;
+    retry: UnsV2Retry;
     opId?: string;
     path?: string;
     details?: RecordValue[];
@@ -19,15 +31,19 @@ export interface UnsV2ErrorInfo {
     /** The error envelope's `data`, verbatim; stable access codes such as `data.reason` live here. */
     data?: unknown;
 }
-/** Server advice is exposed verbatim. The SDK never acts on it or retries a request. */
+/**
+ * A failed UNS v2 call. `execution` and `retry` come from the error body; for
+ * failures without one (timeout, network, invalid response) the SDK fills them
+ * like the gateway does: a read `rolledBack` and safe to resend, a mutation
+ * `unknown` and not safe. This client never retries; it exposes the advice.
+ */
 export declare class UnsV2Error extends Error implements UnsV2ErrorInfo {
     readonly status?: number;
-    readonly operation: UnsV2OperationName;
+    readonly operation: UnsV2ErrorOperation;
     readonly code: string;
     readonly requestId?: string;
-    readonly retryable: boolean;
-    readonly retryAdvice?: RetryAdvice;
-    readonly rolledBack?: boolean;
+    readonly execution: UnsV2Execution;
+    readonly retry: UnsV2Retry;
     readonly opId?: string;
     readonly path?: string;
     readonly details?: RecordValue[];
@@ -36,16 +52,78 @@ export declare class UnsV2Error extends Error implements UnsV2ErrorInfo {
     readonly queryId?: string;
     readonly data?: unknown;
     constructor(message: string, info: UnsV2ErrorInfo);
+    get outcomeUnknown(): boolean;
 }
-/** A mutating request may have reached the service. Reconcile before any deliberate replay. */
+/**
+ * `execution: "unknown"`: a mutation may have committed. Reconcile (read back,
+ * or replay with the same idempotency key when `retry.safe`) before acting again.
+ */
 export declare class UnsV2OutcomeUnknownError extends UnsV2Error {
-    readonly outcomeUnknown = true;
     constructor(message: string, info: UnsV2ErrorInfo);
 }
+/** The wire error object (an envelope's `error`, a batch item's `error`); undefined when it is not one. */
+export declare function parseUnsV2Fault(value: unknown): Omit<UnsV2ErrorInfo, 'status' | 'operation' | 'requestId' | 'data'> | undefined;
+/** Contract limits of one `records:subscribe` stream. */
+export declare const UNS_V2_SUBSCRIBE_MAX_COLLECTIONS = 64;
+export declare const UNS_V2_SUBSCRIBE_MAX_RECORD_IDS = 100;
+/**
+ * Rejects a resume position that cannot be an event id (1–8192 visible ASCII
+ * characters), such as a `Last-Event-ID` with CR/LF taken from a browser:
+ * sent as a header it would fail every connection.
+ */
+export declare function assertEventId(value: string): void;
+/**
+ * Query of `records:subscribe`; the resume position travels as `lastEventId`
+ * (the `Last-Event-ID` header). Without `collectionIds` the stream covers every
+ * collection the caller may read (an App key: every collection granted to the App).
+ */
+export type UnsV2RecordSubscribeRequest = Pick<CloudRecordSubscribeReq, 'collectionIds' | 'recordIds'>;
+/**
+ * A committed record change. Events carry identities only: read the record to
+ * see its data. `restricted`: the collection has employee data rules, so who
+ * may see this record depends on the employee (see `data.subscribe`).
+ */
+export interface UnsV2RecordChangeEvent {
+    type: 'change';
+    /** Stream position (also the frame id); resume after it with `lastEventId`. */
+    eventId: string;
+    collectionId: string;
+    recordId: string;
+    revision: number;
+    change: 'record' | 'delete';
+    occurredAt: number;
+    restricted: boolean;
+}
+export type UnsV2SubscriptionEvent = UnsV2RecordChangeEvent
+/** Sent on connect and every 15 s; `eventId` is the current position, resumable like a change's. */
+ | {
+    type: 'heartbeat';
+    eventId?: string;
+}
+/**
+ * The server closes the stream after it. `CURSOR_EXPIRED`: the position is
+ * outside the 24 h retention; `SCOPE_CHANGED`: access narrowed. Reload, then
+ * subscribe again without `lastEventId`.
+ */
+ | {
+    type: 'reset';
+    reason: string;
+    message?: string;
+};
 export declare class UnsV2ClientCore {
     private readonly transport;
     constructor(resolveClient?: () => HttpClient, config?: CloudTransportConfig);
     call<Name extends UnsV2OperationName>(name: Name, request: UnsV2Request<Name>, options?: RequestOptions): Promise<UnsV2Response<Name>>;
+    /**
+     * Opens one `records:subscribe` event stream and yields its events until
+     * the server ends it or `signal` aborts (the generator then returns). It
+     * neither reconnects nor watches heartbeats; `data.subscribe` does. A
+     * refused or broken connection throws UnsV2Error (operation
+     * `recordSubscribe`, a read: `retry.safe` says whether to reconnect).
+     */
+    subscribeRecords(request: UnsV2RecordSubscribeRequest, options?: RequestOptions & {
+        lastEventId?: string;
+    }): AsyncGenerator<UnsV2SubscriptionEvent>;
 }
 export type UnsV2Client = UnsV2ClientCore & UnsV2Operations;
 export declare function createUnsV2Client(resolveClient?: () => HttpClient, config?: CloudTransportConfig): UnsV2Client;

package/dist/esm/uns-v2/client.js

@@ -1,16 +1,22 @@
 import { CloudTransport, CloudTransportError, UNS_V2_MAX_REQUEST_BYTES, } from '../cloud-transport.js';
 import { getClient } from '../openapi/client.js';
 import { decodeUnsV2JSON, encodeUnsV2JSON } from './codec.js';
-import { UNS_V2_OPERATIONS, } from './generated.js';
-/** Server advice is exposed verbatim. The SDK never acts on it or retries a request. */
+import { parseServerSentEvents, ServerSentEventsError } from './sse.js';
+import { UNS_V2_OPERATIONS, UNS_V2_STREAM_OPERATIONS, } from './generated.js';
+export const UNS_V2_EXECUTIONS = ['notStarted', 'rolledBack', 'committed', 'unknown'];
+/**
+ * A failed UNS v2 call. `execution` and `retry` come from the error body; for
+ * failures without one (timeout, network, invalid response) the SDK fills them
+ * like the gateway does: a read `rolledBack` and safe to resend, a mutation
+ * `unknown` and not safe. This client never retries; it exposes the advice.
+ */
 export class UnsV2Error extends Error {
     status;
     operation;
     code;
     requestId;
-    retryable;
-    retryAdvice;
-    rolledBack;
+    execution;
+    retry;
     opId;
     path;
     details;
@@ -25,12 +31,18 @@ export class UnsV2Error extends Error {
         this.status = info.status;
         this.operation = info.operation;
         this.code = info.code;
-        this.retryable = info.retryable;
+        this.execution = info.execution;
+        this.retry = info.retry;
+    }
+    get outcomeUnknown() {
+        return this.execution === 'unknown';
     }
 }
-/** A mutating request may have reached the service. Reconcile before any deliberate replay. */
+/**
+ * `execution: "unknown"`: a mutation may have committed. Reconcile (read back,
+ * or replay with the same idempotency key when `retry.safe`) before acting again.
+ */
 export class UnsV2OutcomeUnknownError extends UnsV2Error {
-    outcomeUnknown = true;
     constructor(message, info) {
         super(message, info);
         this.name = 'UnsV2OutcomeUnknownError';
@@ -51,32 +63,105 @@ function resourcePath(operation, request) {
     }
     return path;
 }
+function afterMs(value) {
+    return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0 ? value : undefined;
+}
+/** The wire error object (an envelope's `error`, a batch item's `error`); undefined when it is not one. */
+export function parseUnsV2Fault(value) {
+    if (!record(value) || typeof value.code !== 'string' || !Array.isArray(value.details) ||
+        !UNS_V2_EXECUTIONS.includes(value.execution) ||
+        !record(value.retry) || typeof value.retry.safe !== 'boolean')
+        return undefined;
+    const wait = afterMs(value.retry.afterMs);
+    return {
+        code: value.code,
+        execution: value.execution,
+        retry: { safe: value.retry.safe, ...(wait === undefined ? {} : { afterMs: wait }) },
+        opId: typeof value.opId === 'string' ? value.opId : undefined,
+        path: typeof value.path === 'string' ? value.path : undefined,
+        details: value.details.every(record) ? value.details : undefined,
+        repair: typeof value.repair === 'string' ? value.repair : undefined,
+        reason: typeof value.reason === 'string' ? value.reason : undefined,
+        queryId: typeof value.queryId === 'string' ? value.queryId : undefined,
+    };
+}
 function errorInfo(value, status, operation) {
-    if (!record(value) || !record(value.error) || typeof value.error.code !== 'string' ||
-        typeof value.error.retryable !== 'boolean' || !Array.isArray(value.error.details) ||
-        !record(value.error.retryAdvice))
+    if (!record(value))
         return undefined;
-    const advice = value.error.retryAdvice;
-    if (typeof advice.recommendedAction !== 'string' || typeof advice.canRetrySameRequest !== 'boolean' ||
-        typeof advice.keepIdempotencyKey !== 'boolean')
+    const fault = parseUnsV2Fault(value.error);
+    if (!fault)
         return undefined;
     return {
+        ...fault,
         status,
         operation,
-        code: value.error.code,
         requestId: typeof value.requestId === 'string' ? value.requestId : undefined,
-        retryable: value.error.retryable,
-        retryAdvice: advice,
-        rolledBack: typeof value.error.rolledBack === 'boolean' ? value.error.rolledBack : undefined,
-        opId: typeof value.error.opId === 'string' ? value.error.opId : undefined,
-        path: typeof value.error.path === 'string' ? value.error.path : undefined,
-        details: value.error.details.every(record) ? value.error.details : undefined,
-        repair: typeof value.error.repair === 'string' ? value.error.repair : undefined,
-        reason: typeof value.error.reason === 'string' ? value.error.reason : undefined,
-        queryId: typeof value.error.queryId === 'string' ? value.error.queryId : undefined,
         data: value.data ?? undefined,
     };
 }
+/**
+ * Builds the error for a failure without a UNS error body. The gateway's rule
+ * applies: a read is `rolledBack` (safe to resend when `safeRead`), a mutation
+ * `unknown` and not safe. `notStarted` overrides both for answers that prove
+ * the request never reached UNS.
+ */
+function localError(message, operation, mutation, code, status, safeRead = true, extra = {}) {
+    const info = {
+        status,
+        operation,
+        code,
+        execution: extra.notStarted ? 'notStarted' : mutation ? 'unknown' : 'rolledBack',
+        retry: { safe: !mutation && safeRead, ...(extra.afterMs === undefined || mutation ? {} : { afterMs: extra.afterMs }) },
+    };
+    return info.execution === 'unknown' ? new UnsV2OutcomeUnknownError(message, info) : new UnsV2Error(message, info);
+}
+/** `Retry-After` as delay-seconds or an HTTP date, in milliseconds from now. */
+function retryAfterMs(value) {
+    if (value === undefined)
+        return undefined;
+    if (/^\d+$/.test(value.trim()))
+        return Number(value.trim()) * 1000;
+    const at = Date.parse(value);
+    return Number.isNaN(at) ? undefined : Math.max(0, at - Date.now());
+}
+/**
+ * UNS v2 routes answer every error with the envelope, so a 4xx whose body is
+ * no envelope at all comes from an intermediary (edge 401 / 413 page) that
+ * never forwarded the request; 408 is the exception, the request may have
+ * been forwarded.
+ */
+const rejectedBeforeUns = (status) => status >= 400 && status < 500 && status !== 408;
+/** Contract limits of one `records:subscribe` stream. */
+export const UNS_V2_SUBSCRIBE_MAX_COLLECTIONS = 64;
+export const UNS_V2_SUBSCRIBE_MAX_RECORD_IDS = 100;
+const EVENT_ID_MAX_LENGTH = 8192;
+/**
+ * Rejects a resume position that cannot be an event id (1–8192 visible ASCII
+ * characters), such as a `Last-Event-ID` with CR/LF taken from a browser:
+ * sent as a header it would fail every connection.
+ */
+export function assertEventId(value) {
+    if (typeof value !== 'string' || value.length < 1 || value.length > EVENT_ID_MAX_LENGTH || !/^[\x21-\x7e]+$/.test(value)) {
+        throw new TypeError(`Tier0 SDK: lastEventId must be 1–${EVENT_ID_MAX_LENGTH} visible ASCII characters.`);
+    }
+}
+function changeEvent(value) {
+    if (!record(value) || typeof value.eventId !== 'string' || typeof value.collectionId !== 'string' ||
+        typeof value.recordId !== 'string' || typeof value.revision !== 'number' || !Number.isSafeInteger(value.revision) ||
+        (value.change !== 'record' && value.change !== 'delete') || typeof value.occurredAt !== 'number' ||
+        typeof value.restricted !== 'boolean')
+        return undefined;
+    return {
+        type: 'change',
+        eventId: value.eventId,
+        collectionId: value.collectionId,
+        recordId: value.recordId,
+        revision: value.revision,
+        change: value.change,
+        occurredAt: value.occurredAt,
+        restricted: value.restricted,
+    };
+}
 export class UnsV2ClientCore {
     transport;
     constructor(resolveClient = getClient, config = {}) {
@@ -101,64 +186,152 @@ export class UnsV2ClientCore {
         catch (error) {
             if (!(error instanceof CloudTransportError))
                 throw error;
-            const info = {
-                status: error.status,
-                operation: name,
-                code: `UNS_V2_${error.kind}`,
-                retryable: false,
-            };
             const message = error.kind === 'TRANSPORT_TIMEOUT'
                 ? 'UNS v2 HTTP transport deadline exceeded.'
-                : error.kind === 'PROTOCOL_ERROR' ? 'Invalid UNS v2 HTTP response.' : 'UNS v2 transport failed.';
-            if (mutation)
-                throw new UnsV2OutcomeUnknownError(message, info);
-            throw new UnsV2Error(message, info);
+                : error.kind === 'PROTOCOL_ERROR' ? 'Invalid UNS v2 HTTP response.'
+                    : error.kind === 'TRANSPORT_ABORTED' ? 'UNS v2 request aborted.' : 'UNS v2 transport failed.';
+            const resendable = error.kind === 'TRANSPORT_TIMEOUT' || error.kind === 'TRANSPORT_ERROR';
+            throw localError(message, name, mutation, `UNS_V2_${error.kind}`, error.status, resendable);
         }
+        // An ingress answers 502/503/504 without the UNS envelope during rollouts and restarts.
+        const unavailable = response.status === 502 || response.status === 503 || response.status === 504;
+        // `enveloped`: the body looks like a UNS envelope, so UNS may have answered it.
+        const invalid = (message, enveloped) => localError(message, name, mutation, 'UNS_V2_PROTOCOL_ERROR', response.status, unavailable, {
+            notStarted: !enveloped && rejectedBeforeUns(response.status),
+            afterMs: unavailable ? retryAfterMs(response.retryAfter) : undefined,
+        });
         let value;
         try {
             value = decodeUnsV2JSON(response.text, response.status === 200 ? operation.response : 'UnsV2ErrorResponse');
         }
         catch {
-            const info = {
-                status: response.status,
-                operation: name,
-                code: 'UNS_V2_PROTOCOL_ERROR',
-                retryable: false,
-            };
-            if (mutation)
-                throw new UnsV2OutcomeUnknownError('Invalid UNS v2 response.', info);
-            throw new UnsV2Error('Invalid UNS v2 response.', info);
+            throw invalid('Invalid UNS v2 response.', false);
         }
         if (response.status !== 200) {
             const info = errorInfo(value, response.status, name);
             if (!info || !record(value) || value.code !== response.status) {
-                const invalid = {
-                    status: response.status,
-                    operation: name,
-                    code: 'UNS_V2_PROTOCOL_ERROR',
-                    retryable: false,
-                };
-                if (mutation)
-                    throw new UnsV2OutcomeUnknownError('Invalid UNS v2 error response.', invalid);
-                throw new UnsV2Error('Invalid UNS v2 error response.', invalid);
+                throw invalid('Invalid UNS v2 error response.', record(value) && typeof value.code === 'number');
             }
-            const message = record(value) && typeof value.msg === 'string' ? value.msg : info.code;
-            throw new UnsV2Error(message, info);
+            // A read never has an unknown outcome; hold UNS to the rule it states for itself.
+            if (!mutation && info.execution === 'unknown')
+                info.execution = 'rolledBack';
+            const message = typeof value.msg === 'string' ? value.msg : info.code;
+            throw info.execution === 'unknown' ? new UnsV2OutcomeUnknownError(message, info) : new UnsV2Error(message, info);
         }
         if (!record(value) || value.code !== 200 || typeof value.msg !== 'string' ||
             typeof value.requestId !== 'string' || !Object.prototype.hasOwnProperty.call(value, 'data')) {
-            const info = {
-                status: response.status,
-                operation: name,
-                code: 'UNS_V2_PROTOCOL_ERROR',
-                retryable: false,
-            };
-            if (mutation)
-                throw new UnsV2OutcomeUnknownError('Invalid UNS v2 success envelope.', info);
-            throw new UnsV2Error('Invalid UNS v2 success envelope.', info);
+            throw localError('Invalid UNS v2 success envelope.', name, mutation, 'UNS_V2_PROTOCOL_ERROR', response.status, false);
         }
         return value;
     }
+    /**
+     * Opens one `records:subscribe` event stream and yields its events until
+     * the server ends it or `signal` aborts (the generator then returns). It
+     * neither reconnects nor watches heartbeats; `data.subscribe` does. A
+     * refused or broken connection throws UnsV2Error (operation
+     * `recordSubscribe`, a read: `retry.safe` says whether to reconnect).
+     */
+    async *subscribeRecords(request, options = {}) {
+        const name = 'recordSubscribe';
+        const { collectionIds, recordIds } = request;
+        if (collectionIds !== undefined && (!Array.isArray(collectionIds) || collectionIds.length < 1 || collectionIds.length > UNS_V2_SUBSCRIBE_MAX_COLLECTIONS)) {
+            throw new TypeError(`Tier0 SDK: records:subscribe lists 1–${UNS_V2_SUBSCRIBE_MAX_COLLECTIONS} collections, or none for all.`);
+        }
+        if (recordIds !== undefined && (recordIds.length < 1 || recordIds.length > UNS_V2_SUBSCRIBE_MAX_RECORD_IDS || collectionIds?.length !== 1)) {
+            throw new TypeError(`Tier0 SDK: records:subscribe takes 1–${UNS_V2_SUBSCRIBE_MAX_RECORD_IDS} recordIds of exactly one collection.`);
+        }
+        if (options.lastEventId !== undefined)
+            assertEventId(options.lastEventId);
+        // Repeated query parameters, as the contract specifies.
+        const query = new URLSearchParams();
+        for (const id of collectionIds ?? [])
+            query.append('collectionIds', id);
+        for (const id of recordIds ?? [])
+            query.append('recordIds', id);
+        const path = UNS_V2_STREAM_OPERATIONS.recordSubscribe.path + (query.size ? `?${query}` : '');
+        let opened;
+        try {
+            opened = await this.transport.getEventStream(path, options);
+        }
+        catch (error) {
+            if (!(error instanceof CloudTransportError))
+                throw error;
+            if (error.kind === 'TRANSPORT_ABORTED')
+                return;
+            const resendable = error.kind === 'TRANSPORT_TIMEOUT' || error.kind === 'TRANSPORT_ERROR';
+            throw localError('UNS v2 event stream could not be opened.', name, false, `UNS_V2_${error.kind}`, error.status, resendable);
+        }
+        if ('text' in opened) {
+            const unavailable = opened.status === 502 || opened.status === 503 || opened.status === 504;
+            const invalid = (enveloped) => localError('Invalid UNS v2 event stream response.', name, false, 'UNS_V2_PROTOCOL_ERROR', opened.status, unavailable, {
+                notStarted: !enveloped && rejectedBeforeUns(opened.status),
+            });
+            let value;
+            try {
+                value = decodeUnsV2JSON(opened.text, 'UnsV2ErrorResponse');
+            }
+            catch {
+                throw invalid(false);
+            }
+            const info = opened.status === 200 ? undefined : errorInfo(value, opened.status, name);
+            if (!info || !record(value) || value.code !== opened.status)
+                throw invalid(record(value) && typeof value.code === 'number');
+            // A subscription is a read: never an unknown outcome.
+            if (info.execution === 'unknown')
+                info.execution = 'rolledBack';
+            throw new UnsV2Error(typeof value.msg === 'string' ? value.msg : info.code, info);
+        }
+        try {
+            for await (const event of parseServerSentEvents(opened.stream)) {
+                // A keep-alive comment counts as a heartbeat too.
+                if ('comment' in event) {
+                    yield { type: 'heartbeat' };
+                }
+                else if (event.event === 'heartbeat') {
+                    yield event.id === undefined ? { type: 'heartbeat' } : { type: 'heartbeat', eventId: event.id };
+                }
+                else if (event.event === 'reset') {
+                    let body;
+                    try {
+                        body = JSON.parse(event.data);
+                    }
+                    catch {
+                        body = undefined;
+                    }
+                    if (!record(body) || typeof body.reason !== 'string') {
+                        throw localError('Invalid UNS v2 reset event.', name, false, 'UNS_V2_PROTOCOL_ERROR', 200, true);
+                    }
+                    yield typeof body.message === 'string'
+                        ? { type: 'reset', reason: body.reason, message: body.message }
+                        : { type: 'reset', reason: body.reason };
+                }
+                else if (event.event === 'change') {
+                    let parsed;
+                    try {
+                        parsed = changeEvent(JSON.parse(event.data));
+                    }
+                    catch {
+                        parsed = undefined;
+                    }
+                    if (!parsed)
+                        throw localError('Invalid UNS v2 change event.', name, false, 'UNS_V2_PROTOCOL_ERROR', 200, true);
+                    yield parsed;
+                }
+            }
+        }
+        catch (error) {
+            if (options.signal?.aborted)
+                return;
+            if (error instanceof UnsV2Error)
+                throw error;
+            if (error instanceof ServerSentEventsError)
+                throw localError(error.message, name, false, 'UNS_V2_PROTOCOL_ERROR', 200, true);
+            throw localError('UNS v2 event stream broke.', name, false, 'UNS_V2_TRANSPORT_ERROR', 200, true);
+        }
+        finally {
+            opened.close();
+        }
+    }
 }
 export function createUnsV2Client(resolveClient = getClient, config = {}) {
     const core = new UnsV2ClientCore(resolveClient, config);

package/dist/esm/uns-v2/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/uns-v2/client.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  CloudTransport,\n  CloudTransportError,\n  UNS_V2_MAX_REQUEST_BYTES,\n  type CloudTransportConfig,\n} from '../cloud-transport.js';\nimport { getClient, type HttpClient, type RequestOptions } from '../openapi/client.js';\nimport { decodeUnsV2JSON, encodeUnsV2JSON } from './codec.js';\nimport {\n  UNS_V2_OPERATIONS,\n  type RetryAdvice,\n  type UnsV2OperationName,\n  type UnsV2Operations,\n  type UnsV2Request,\n  type UnsV2Response,\n} from './generated.js';\n\ntype RecordValue = Record<string, unknown>;\n\nexport interface UnsV2ErrorInfo {\n  status?: number;\n  operation: UnsV2OperationName;\n  code: string;\n  requestId?: string;\n  retryable: boolean;\n  retryAdvice?: RetryAdvice;\n  rolledBack?: boolean;\n  opId?: string;\n  path?: string;\n  details?: RecordValue[];\n  repair?: string;\n  reason?: string;\n  queryId?: string;\n  /** The error envelope's `data`, verbatim; stable access codes such as `data.reason` live here. */\n  data?: unknown;\n}\n\n/** Server advice is exposed verbatim. The SDK never acts on it or retries a request. */\nexport class UnsV2Error extends Error implements UnsV2ErrorInfo {\n  readonly status?: number;\n  readonly operation: UnsV2OperationName;\n  readonly code: string;\n  readonly requestId?: string;\n  readonly retryable: boolean;\n  readonly retryAdvice?: RetryAdvice;\n  readonly rolledBack?: boolean;\n  readonly opId?: string;\n  readonly path?: string;\n  readonly details?: RecordValue[];\n  readonly repair?: string;\n  readonly reason?: string;\n  readonly queryId?: string;\n  readonly data?: unknown;\n\n  constructor(message: string, info: UnsV2ErrorInfo) {\n    super(message);\n    this.name = 'UnsV2Error';\n    Object.assign(this, info);\n    this.status = info.status;\n    this.operation = info.operation;\n    this.code = info.code;\n    this.retryable = info.retryable;\n  }\n}\n\n/** A mutating request may have reached the service. Reconcile before any deliberate replay. */\nexport class UnsV2OutcomeUnknownError extends UnsV2Error {\n  readonly outcomeUnknown = true;\n  constructor(message: string, info: UnsV2ErrorInfo) {\n    super(message, info);\n    this.name = 'UnsV2OutcomeUnknownError';\n  }\n}\n\nfunction record(value: unknown): value is RecordValue {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction resourcePath(operation: { path: string; readonly pathParams: readonly string[] }, request: unknown): string {\n  let path = operation.path;\n  for (const key of operation.pathParams) {\n    const value = record(request) && Object.prototype.hasOwnProperty.call(request, key) ? request[key] : undefined;\n    if (typeof value !== 'string' || value.length < 1 || value.length > 128 ||\n        value === '.' || value === '..' || /[/\\\\\\u0000-\\u001f\\u007f]/.test(value)) {\n      throw new TypeError(`Tier0 SDK: invalid UNS v2 path identity ${key}.`);\n    }\n    path = path.replace(`:${key}`, encodeURIComponent(value));\n  }\n  return path;\n}\n\nfunction errorInfo(value: unknown, status: number, operation: UnsV2OperationName): UnsV2ErrorInfo | undefined {\n  if (!record(value) || !record(value.error) || typeof value.error.code !== 'string' ||\n      typeof value.error.retryable !== 'boolean' || !Array.isArray(value.error.details) ||\n      !record(value.error.retryAdvice)) return undefined;\n  const advice = value.error.retryAdvice;\n  if (typeof advice.recommendedAction !== 'string' || typeof advice.canRetrySameRequest !== 'boolean' ||\n      typeof advice.keepIdempotencyKey !== 'boolean') return undefined;\n  return {\n    status,\n    operation,\n    code: value.error.code,\n    requestId: typeof value.requestId === 'string' ? value.requestId : undefined,\n    retryable: value.error.retryable,\n    retryAdvice: advice as unknown as RetryAdvice,\n    rolledBack: typeof value.error.rolledBack === 'boolean' ? value.error.rolledBack : undefined,\n    opId: typeof value.error.opId === 'string' ? value.error.opId : undefined,\n    path: typeof value.error.path === 'string' ? value.error.path : undefined,\n    details: value.error.details.every(record) ? value.error.details : undefined,\n    repair: typeof value.error.repair === 'string' ? value.error.repair : undefined,\n    reason: typeof value.error.reason === 'string' ? value.error.reason : undefined,\n    queryId: typeof value.error.queryId === 'string' ? value.error.queryId : undefined,\n    data: value.data ?? undefined,\n  };\n}\n\nexport class UnsV2ClientCore {\n  private readonly transport: CloudTransport;\n\n  constructor(resolveClient: () => HttpClient = getClient, config: CloudTransportConfig = {}) {\n    this.transport = new CloudTransport(resolveClient, config);\n  }\n\n  async call<Name extends UnsV2OperationName>(name: Name, request: UnsV2Request<Name>, options: RequestOptions = {}): Promise<UnsV2Response<Name>> {\n    options.signal?.throwIfAborted();\n    if (typeof name !== 'string' || !Object.prototype.hasOwnProperty.call(UNS_V2_OPERATIONS, name)) {\n      throw new TypeError('Tier0 SDK: unknown UNS v2 operation.');\n    }\n    const operation = UNS_V2_OPERATIONS[name];\n    const mutation = operation.mutation;\n    const path = resourcePath(operation, request);\n    const body = encodeUnsV2JSON(request, operation.request);\n    if (new TextEncoder().encode(body).byteLength > UNS_V2_MAX_REQUEST_BYTES) {\n      throw new TypeError('Tier0 SDK: UNS v2 request body exceeds the 16777216-byte contract limit.');\n    }\n    let response: Awaited<ReturnType<CloudTransport['postText']>>;\n    try {\n      response = await this.transport.postText(path, body, options);\n    } catch (error) {\n      if (!(error instanceof CloudTransportError)) throw error;\n      const info: UnsV2ErrorInfo = {\n        status: error.status,\n        operation: name,\n        code: `UNS_V2_${error.kind}`,\n        retryable: false,\n      };\n      const message = error.kind === 'TRANSPORT_TIMEOUT'\n        ? 'UNS v2 HTTP transport deadline exceeded.'\n        : error.kind === 'PROTOCOL_ERROR' ? 'Invalid UNS v2 HTTP response.' : 'UNS v2 transport failed.';\n      if (mutation) throw new UnsV2OutcomeUnknownError(message, info);\n      throw new UnsV2Error(message, info);\n    }\n\n    let value: unknown;\n    try {\n      value = decodeUnsV2JSON(response.text, response.status === 200 ? operation.response : 'UnsV2ErrorResponse');\n    } catch {\n      const info: UnsV2ErrorInfo = {\n        status: response.status,\n        operation: name,\n        code: 'UNS_V2_PROTOCOL_ERROR',\n        retryable: false,\n      };\n      if (mutation) throw new UnsV2OutcomeUnknownError('Invalid UNS v2 response.', info);\n      throw new UnsV2Error('Invalid UNS v2 response.', info);\n    }\n\n    if (response.status !== 200) {\n      const info = errorInfo(value, response.status, name);\n      if (!info || !record(value) || value.code !== response.status) {\n        const invalid: UnsV2ErrorInfo = {\n          status: response.status,\n          operation: name,\n          code: 'UNS_V2_PROTOCOL_ERROR',\n          retryable: false,\n        };\n        if (mutation) throw new UnsV2OutcomeUnknownError('Invalid UNS v2 error response.', invalid);\n        throw new UnsV2Error('Invalid UNS v2 error response.', invalid);\n      }\n      const message = record(value) && typeof value.msg === 'string' ? value.msg : info.code;\n      throw new UnsV2Error(message, info);\n    }\n\n    if (!record(value) || value.code !== 200 || typeof value.msg !== 'string' ||\n        typeof value.requestId !== 'string' || !Object.prototype.hasOwnProperty.call(value, 'data')) {\n      const info: UnsV2ErrorInfo = {\n        status: response.status,\n        operation: name,\n        code: 'UNS_V2_PROTOCOL_ERROR',\n        retryable: false,\n      };\n      if (mutation) throw new UnsV2OutcomeUnknownError('Invalid UNS v2 success envelope.', info);\n      throw new UnsV2Error('Invalid UNS v2 success envelope.', info);\n    }\n    return value as UnsV2Response<Name>;\n  }\n}\n\nexport type UnsV2Client = UnsV2ClientCore & UnsV2Operations;\n\nexport function createUnsV2Client(resolveClient: () => HttpClient = getClient, config: CloudTransportConfig = {}): UnsV2Client {\n  const core = new UnsV2ClientCore(resolveClient, config);\n  const methods = Object.fromEntries(Object.keys(UNS_V2_OPERATIONS).map(name => [name, (request: unknown, options?: RequestOptions) =>\n    core.call(name as UnsV2OperationName, request as UnsV2Request<UnsV2OperationName>, options)]));\n  return Object.assign(core, methods) as unknown as UnsV2Client;\n}\n\n/** Uses configureClient()/TIER0_API_HOST/TIER0_API_KEY and does not imply v2 readiness. */\nexport const unsV2 = createUnsV2Client();\n"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/uns-v2/client.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  CloudTransport,\n  CloudTransportError,\n  UNS_V2_MAX_REQUEST_BYTES,\n  type CloudTransportConfig,\n} from '../cloud-transport.js';\nimport { getClient, type HttpClient, type RequestOptions } from '../openapi/client.js';\nimport { decodeUnsV2JSON, encodeUnsV2JSON } from './codec.js';\nimport { parseServerSentEvents, ServerSentEventsError } from './sse.js';\nimport {\n  UNS_V2_OPERATIONS,\n  UNS_V2_STREAM_OPERATIONS,\n  type CloudRecordSubscribeReq,\n  type UnsV2OperationName,\n  type UnsV2StreamOperationName,\n  type UnsV2Operations,\n  type UnsV2Request,\n  type UnsV2Response,\n} from './generated.js';\n\ntype RecordValue = Record<string, unknown>;\n\n/**\n * How far a failed request got. `unknown` only for a mutation whose commit\n * cannot be confirmed; a read is never `unknown`.\n */\nexport type UnsV2Execution = 'notStarted' | 'rolledBack' | 'committed' | 'unknown';\nexport const UNS_V2_EXECUTIONS: readonly UnsV2Execution[] = ['notStarted', 'rolledBack', 'committed', 'unknown'];\n\n/** Whether the identical request (same idempotency key) may be sent again, and after how long. */\nexport interface UnsV2Retry {\n  safe: boolean;\n  afterMs?: number;\n}\n\n/** Generated POST operations, or a GET event stream such as `recordSubscribe`. */\nexport type UnsV2ErrorOperation = UnsV2OperationName | UnsV2StreamOperationName;\n\nexport interface UnsV2ErrorInfo {\n  status?: number;\n  operation: UnsV2ErrorOperation;\n  code: string;\n  requestId?: string;\n  execution: UnsV2Execution;\n  retry: UnsV2Retry;\n  opId?: string;\n  path?: string;\n  details?: RecordValue[];\n  repair?: string;\n  reason?: string;\n  queryId?: string;\n  /** The error envelope's `data`, verbatim; stable access codes such as `data.reason` live here. */\n  data?: unknown;\n}\n\n/**\n * A failed UNS v2 call. `execution` and `retry` come from the error body; for\n * failures without one (timeout, network, invalid response) the SDK fills them\n * like the gateway does: a read `rolledBack` and safe to resend, a mutation\n * `unknown` and not safe. This client never retries; it exposes the advice.\n */\nexport class UnsV2Error extends Error implements UnsV2ErrorInfo {\n  readonly status?: number;\n  readonly operation: UnsV2ErrorOperation;\n  readonly code: string;\n  readonly requestId?: string;\n  readonly execution: UnsV2Execution;\n  readonly retry: UnsV2Retry;\n  readonly opId?: string;\n  readonly path?: string;\n  readonly details?: RecordValue[];\n  readonly repair?: string;\n  readonly reason?: string;\n  readonly queryId?: string;\n  readonly data?: unknown;\n\n  constructor(message: string, info: UnsV2ErrorInfo) {\n    super(message);\n    this.name = 'UnsV2Error';\n    Object.assign(this, info);\n    this.status = info.status;\n    this.operation = info.operation;\n    this.code = info.code;\n    this.execution = info.execution;\n    this.retry = info.retry;\n  }\n\n  get outcomeUnknown(): boolean {\n    return this.execution === 'unknown';\n  }\n}\n\n/**\n * `execution: \"unknown\"`: a mutation may have committed. Reconcile (read back,\n * or replay with the same idempotency key when `retry.safe`) before acting again.\n */\nexport class UnsV2OutcomeUnknownError extends UnsV2Error {\n  constructor(message: string, info: UnsV2ErrorInfo) {\n    super(message, info);\n    this.name = 'UnsV2OutcomeUnknownError';\n  }\n}\n\nfunction record(value: unknown): value is RecordValue {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction resourcePath(operation: { path: string; readonly pathParams: readonly string[] }, request: unknown): string {\n  let path = operation.path;\n  for (const key of operation.pathParams) {\n    const value = record(request) && Object.prototype.hasOwnProperty.call(request, key) ? request[key] : undefined;\n    if (typeof value !== 'string' || value.length < 1 || value.length > 128 ||\n        value === '.' || value === '..' || /[/\\\\\\u0000-\\u001f\\u007f]/.test(value)) {\n      throw new TypeError(`Tier0 SDK: invalid UNS v2 path identity ${key}.`);\n    }\n    path = path.replace(`:${key}`, encodeURIComponent(value));\n  }\n  return path;\n}\n\nfunction afterMs(value: unknown): number | undefined {\n  return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0 ? value : undefined;\n}\n\n/** The wire error object (an envelope's `error`, a batch item's `error`); undefined when it is not one. */\nexport function parseUnsV2Fault(value: unknown): Omit<UnsV2ErrorInfo, 'status' | 'operation' | 'requestId' | 'data'> | undefined {\n  if (!record(value) || typeof value.code !== 'string' || !Array.isArray(value.details) ||\n      !UNS_V2_EXECUTIONS.includes(value.execution as UnsV2Execution) ||\n      !record(value.retry) || typeof value.retry.safe !== 'boolean') return undefined;\n  const wait = afterMs(value.retry.afterMs);\n  return {\n    code: value.code,\n    execution: value.execution as UnsV2Execution,\n    retry: { safe: value.retry.safe, ...(wait === undefined ? {} : { afterMs: wait }) },\n    opId: typeof value.opId === 'string' ? value.opId : undefined,\n    path: typeof value.path === 'string' ? value.path : undefined,\n    details: value.details.every(record) ? value.details : undefined,\n    repair: typeof value.repair === 'string' ? value.repair : undefined,\n    reason: typeof value.reason === 'string' ? value.reason : undefined,\n    queryId: typeof value.queryId === 'string' ? value.queryId : undefined,\n  };\n}\n\nfunction errorInfo(value: unknown, status: number, operation: UnsV2ErrorOperation): UnsV2ErrorInfo | undefined {\n  if (!record(value)) return undefined;\n  const fault = parseUnsV2Fault(value.error);\n  if (!fault) return undefined;\n  return {\n    ...fault,\n    status,\n    operation,\n    requestId: typeof value.requestId === 'string' ? value.requestId : undefined,\n    data: value.data ?? undefined,\n  };\n}\n\n/**\n * Builds the error for a failure without a UNS error body. The gateway's rule\n * applies: a read is `rolledBack` (safe to resend when `safeRead`), a mutation\n * `unknown` and not safe. `notStarted` overrides both for answers that prove\n * the request never reached UNS.\n */\nfunction localError(\n  message: string,\n  operation: UnsV2ErrorOperation,\n  mutation: boolean,\n  code: string,\n  status?: number,\n  safeRead = true,\n  extra: { notStarted?: boolean; afterMs?: number } = {},\n): UnsV2Error {\n  const info: UnsV2ErrorInfo = {\n    status,\n    operation,\n    code,\n    execution: extra.notStarted ? 'notStarted' : mutation ? 'unknown' : 'rolledBack',\n    retry: { safe: !mutation && safeRead, ...(extra.afterMs === undefined || mutation ? {} : { afterMs: extra.afterMs }) },\n  };\n  return info.execution === 'unknown' ? new UnsV2OutcomeUnknownError(message, info) : new UnsV2Error(message, info);\n}\n\n/** `Retry-After` as delay-seconds or an HTTP date, in milliseconds from now. */\nfunction retryAfterMs(value: string | undefined): number | undefined {\n  if (value === undefined) return undefined;\n  if (/^\\d+$/.test(value.trim())) return Number(value.trim()) * 1000;\n  const at = Date.parse(value);\n  return Number.isNaN(at) ? undefined : Math.max(0, at - Date.now());\n}\n\n/**\n * UNS v2 routes answer every error with the envelope, so a 4xx whose body is\n * no envelope at all comes from an intermediary (edge 401 / 413 page) that\n * never forwarded the request; 408 is the exception, the request may have\n * been forwarded.\n */\nconst rejectedBeforeUns = (status: number) => status >= 400 && status < 500 && status !== 408;\n\n/** Contract limits of one `records:subscribe` stream. */\nexport const UNS_V2_SUBSCRIBE_MAX_COLLECTIONS = 64;\nexport const UNS_V2_SUBSCRIBE_MAX_RECORD_IDS = 100;\nconst EVENT_ID_MAX_LENGTH = 8192;\n\n/**\n * Rejects a resume position that cannot be an event id (1–8192 visible ASCII\n * characters), such as a `Last-Event-ID` with CR/LF taken from a browser:\n * sent as a header it would fail every connection.\n */\nexport function assertEventId(value: string): void {\n  if (typeof value !== 'string' || value.length < 1 || value.length > EVENT_ID_MAX_LENGTH || !/^[\\x21-\\x7e]+$/.test(value)) {\n    throw new TypeError(`Tier0 SDK: lastEventId must be 1–${EVENT_ID_MAX_LENGTH} visible ASCII characters.`);\n  }\n}\n\n/**\n * Query of `records:subscribe`; the resume position travels as `lastEventId`\n * (the `Last-Event-ID` header). Without `collectionIds` the stream covers every\n * collection the caller may read (an App key: every collection granted to the App).\n */\nexport type UnsV2RecordSubscribeRequest = Pick<CloudRecordSubscribeReq, 'collectionIds' | 'recordIds'>;\n\n/**\n * A committed record change. Events carry identities only: read the record to\n * see its data. `restricted`: the collection has employee data rules, so who\n * may see this record depends on the employee (see `data.subscribe`).\n */\nexport interface UnsV2RecordChangeEvent {\n  type: 'change';\n  /** Stream position (also the frame id); resume after it with `lastEventId`. */\n  eventId: string;\n  collectionId: string;\n  recordId: string;\n  revision: number;\n  change: 'record' | 'delete';\n  occurredAt: number;\n  restricted: boolean;\n}\n\nexport type UnsV2SubscriptionEvent =\n  | UnsV2RecordChangeEvent\n  /** Sent on connect and every 15 s; `eventId` is the current position, resumable like a change's. */\n  | { type: 'heartbeat'; eventId?: string }\n  /**\n   * The server closes the stream after it. `CURSOR_EXPIRED`: the position is\n   * outside the 24 h retention; `SCOPE_CHANGED`: access narrowed. Reload, then\n   * subscribe again without `lastEventId`.\n   */\n  | { type: 'reset'; reason: string; message?: string };\n\nfunction changeEvent(value: unknown): UnsV2RecordChangeEvent | undefined {\n  if (!record(value) || typeof value.eventId !== 'string' || typeof value.collectionId !== 'string' ||\n      typeof value.recordId !== 'string' || typeof value.revision !== 'number' || !Number.isSafeInteger(value.revision) ||\n      (value.change !== 'record' && value.change !== 'delete') || typeof value.occurredAt !== 'number' ||\n      typeof value.restricted !== 'boolean') return undefined;\n  return {\n    type: 'change',\n    eventId: value.eventId,\n    collectionId: value.collectionId,\n    recordId: value.recordId,\n    revision: value.revision,\n    change: value.change,\n    occurredAt: value.occurredAt,\n    restricted: value.restricted,\n  };\n}\n\nexport class UnsV2ClientCore {\n  private readonly transport: CloudTransport;\n\n  constructor(resolveClient: () => HttpClient = getClient, config: CloudTransportConfig = {}) {\n    this.transport = new CloudTransport(resolveClient, config);\n  }\n\n  async call<Name extends UnsV2OperationName>(name: Name, request: UnsV2Request<Name>, options: RequestOptions = {}): Promise<UnsV2Response<Name>> {\n    options.signal?.throwIfAborted();\n    if (typeof name !== 'string' || !Object.prototype.hasOwnProperty.call(UNS_V2_OPERATIONS, name)) {\n      throw new TypeError('Tier0 SDK: unknown UNS v2 operation.');\n    }\n    const operation = UNS_V2_OPERATIONS[name];\n    const mutation = operation.mutation;\n    const path = resourcePath(operation, request);\n    const body = encodeUnsV2JSON(request, operation.request);\n    if (new TextEncoder().encode(body).byteLength > UNS_V2_MAX_REQUEST_BYTES) {\n      throw new TypeError('Tier0 SDK: UNS v2 request body exceeds the 16777216-byte contract limit.');\n    }\n    let response: Awaited<ReturnType<CloudTransport['postText']>>;\n    try {\n      response = await this.transport.postText(path, body, options);\n    } catch (error) {\n      if (!(error instanceof CloudTransportError)) throw error;\n      const message = error.kind === 'TRANSPORT_TIMEOUT'\n        ? 'UNS v2 HTTP transport deadline exceeded.'\n        : error.kind === 'PROTOCOL_ERROR' ? 'Invalid UNS v2 HTTP response.'\n          : error.kind === 'TRANSPORT_ABORTED' ? 'UNS v2 request aborted.' : 'UNS v2 transport failed.';\n      const resendable = error.kind === 'TRANSPORT_TIMEOUT' || error.kind === 'TRANSPORT_ERROR';\n      throw localError(message, name, mutation, `UNS_V2_${error.kind}`, error.status, resendable);\n    }\n\n    // An ingress answers 502/503/504 without the UNS envelope during rollouts and restarts.\n    const unavailable = response.status === 502 || response.status === 503 || response.status === 504;\n    // `enveloped`: the body looks like a UNS envelope, so UNS may have answered it.\n    const invalid = (message: string, enveloped: boolean) => localError(message, name, mutation, 'UNS_V2_PROTOCOL_ERROR', response.status, unavailable, {\n      notStarted: !enveloped && rejectedBeforeUns(response.status),\n      afterMs: unavailable ? retryAfterMs(response.retryAfter) : undefined,\n    });\n    let value: unknown;\n    try {\n      value = decodeUnsV2JSON(response.text, response.status === 200 ? operation.response : 'UnsV2ErrorResponse');\n    } catch {\n      throw invalid('Invalid UNS v2 response.', false);\n    }\n\n    if (response.status !== 200) {\n      const info = errorInfo(value, response.status, name);\n      if (!info || !record(value) || value.code !== response.status) {\n        throw invalid('Invalid UNS v2 error response.', record(value) && typeof value.code === 'number');\n      }\n      // A read never has an unknown outcome; hold UNS to the rule it states for itself.\n      if (!mutation && info.execution === 'unknown') info.execution = 'rolledBack';\n      const message = typeof value.msg === 'string' ? value.msg : info.code;\n      throw info.execution === 'unknown' ? new UnsV2OutcomeUnknownError(message, info) : new UnsV2Error(message, info);\n    }\n\n    if (!record(value) || value.code !== 200 || typeof value.msg !== 'string' ||\n        typeof value.requestId !== 'string' || !Object.prototype.hasOwnProperty.call(value, 'data')) {\n      throw localError('Invalid UNS v2 success envelope.', name, mutation, 'UNS_V2_PROTOCOL_ERROR', response.status, false);\n    }\n    return value as UnsV2Response<Name>;\n  }\n\n  /**\n   * Opens one `records:subscribe` event stream and yields its events until\n   * the server ends it or `signal` aborts (the generator then returns). It\n   * neither reconnects nor watches heartbeats; `data.subscribe` does. A\n   * refused or broken connection throws UnsV2Error (operation\n   * `recordSubscribe`, a read: `retry.safe` says whether to reconnect).\n   */\n  async *subscribeRecords(request: UnsV2RecordSubscribeRequest, options: RequestOptions & { lastEventId?: string } = {}): AsyncGenerator<UnsV2SubscriptionEvent> {\n    const name = 'recordSubscribe';\n    const { collectionIds, recordIds } = request;\n    if (collectionIds !== undefined && (!Array.isArray(collectionIds) || collectionIds.length < 1 || collectionIds.length > UNS_V2_SUBSCRIBE_MAX_COLLECTIONS)) {\n      throw new TypeError(`Tier0 SDK: records:subscribe lists 1–${UNS_V2_SUBSCRIBE_MAX_COLLECTIONS} collections, or none for all.`);\n    }\n    if (recordIds !== undefined && (recordIds.length < 1 || recordIds.length > UNS_V2_SUBSCRIBE_MAX_RECORD_IDS || collectionIds?.length !== 1)) {\n      throw new TypeError(`Tier0 SDK: records:subscribe takes 1–${UNS_V2_SUBSCRIBE_MAX_RECORD_IDS} recordIds of exactly one collection.`);\n    }\n    if (options.lastEventId !== undefined) assertEventId(options.lastEventId);\n    // Repeated query parameters, as the contract specifies.\n    const query = new URLSearchParams();\n    for (const id of collectionIds ?? []) query.append('collectionIds', id);\n    for (const id of recordIds ?? []) query.append('recordIds', id);\n    const path = UNS_V2_STREAM_OPERATIONS.recordSubscribe.path + (query.size ? `?${query}` : '');\n    let opened: Awaited<ReturnType<CloudTransport['getEventStream']>>;\n    try {\n      opened = await this.transport.getEventStream(path, options);\n    } catch (error) {\n      if (!(error instanceof CloudTransportError)) throw error;\n      if (error.kind === 'TRANSPORT_ABORTED') return;\n      const resendable = error.kind === 'TRANSPORT_TIMEOUT' || error.kind === 'TRANSPORT_ERROR';\n      throw localError('UNS v2 event stream could not be opened.', name, false, `UNS_V2_${error.kind}`, error.status, resendable);\n    }\n    if ('text' in opened) {\n      const unavailable = opened.status === 502 || opened.status === 503 || opened.status === 504;\n      const invalid = (enveloped: boolean) => localError('Invalid UNS v2 event stream response.', name, false, 'UNS_V2_PROTOCOL_ERROR', opened.status, unavailable, {\n        notStarted: !enveloped && rejectedBeforeUns(opened.status),\n      });\n      let value: unknown;\n      try {\n        value = decodeUnsV2JSON(opened.text, 'UnsV2ErrorResponse');\n      } catch {\n        throw invalid(false);\n      }\n      const info = opened.status === 200 ? undefined : errorInfo(value, opened.status, name);\n      if (!info || !record(value) || value.code !== opened.status) throw invalid(record(value) && typeof value.code === 'number');\n      // A subscription is a read: never an unknown outcome.\n      if (info.execution === 'unknown') info.execution = 'rolledBack';\n      throw new UnsV2Error(typeof value.msg === 'string' ? value.msg : info.code, info);\n    }\n    try {\n      for await (const event of parseServerSentEvents(opened.stream)) {\n        // A keep-alive comment counts as a heartbeat too.\n        if ('comment' in event) {\n          yield { type: 'heartbeat' };\n        } else if (event.event === 'heartbeat') {\n          yield event.id === undefined ? { type: 'heartbeat' } : { type: 'heartbeat', eventId: event.id };\n        } else if (event.event === 'reset') {\n          let body: unknown;\n          try { body = JSON.parse(event.data); } catch { body = undefined; }\n          if (!record(body) || typeof body.reason !== 'string') {\n            throw localError('Invalid UNS v2 reset event.', name, false, 'UNS_V2_PROTOCOL_ERROR', 200, true);\n          }\n          yield typeof body.message === 'string'\n            ? { type: 'reset', reason: body.reason, message: body.message }\n            : { type: 'reset', reason: body.reason };\n        } else if (event.event === 'change') {\n          let parsed: UnsV2RecordChangeEvent | undefined;\n          try { parsed = changeEvent(JSON.parse(event.data)); } catch { parsed = undefined; }\n          if (!parsed) throw localError('Invalid UNS v2 change event.', name, false, 'UNS_V2_PROTOCOL_ERROR', 200, true);\n          yield parsed;\n        }\n      }\n    } catch (error) {\n      if (options.signal?.aborted) return;\n      if (error instanceof UnsV2Error) throw error;\n      if (error instanceof ServerSentEventsError) throw localError(error.message, name, false, 'UNS_V2_PROTOCOL_ERROR', 200, true);\n      throw localError('UNS v2 event stream broke.', name, false, 'UNS_V2_TRANSPORT_ERROR', 200, true);\n    } finally {\n      opened.close();\n    }\n  }\n}\n\nexport type UnsV2Client = UnsV2ClientCore & UnsV2Operations;\n\nexport function createUnsV2Client(resolveClient: () => HttpClient = getClient, config: CloudTransportConfig = {}): UnsV2Client {\n  const core = new UnsV2ClientCore(resolveClient, config);\n  const methods = Object.fromEntries(Object.keys(UNS_V2_OPERATIONS).map(name => [name, (request: unknown, options?: RequestOptions) =>\n    core.call(name as UnsV2OperationName, request as UnsV2Request<UnsV2OperationName>, options)]));\n  return Object.assign(core, methods) as unknown as UnsV2Client;\n}\n\n/** Uses configureClient()/TIER0_API_HOST/TIER0_API_KEY and does not imply v2 readiness. */\nexport const unsV2 = createUnsV2Client();\n"]}