qca-sdk 0.1.0-dev.4 → 0.2.0

package/dist/core/detect-platform.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.platformHeaders = platformHeaders;
+const version_js_1 = require("../version.js");
+// The spellings match the Go SDK's convention/requestconfig.go on purpose: the
+// server aggregates SDK usage across languages, so the same machine has to land in
+// the same bucket no matter which SDK called. process.arch and Go's runtime.GOARCH
+// name the same architecture differently, hence the aliases.
+const OS_NAMES = {
+    darwin: 'MacOS',
+    win32: 'Windows',
+    windows: 'Windows',
+    linux: 'Linux',
+    ios: 'iOS',
+    android: 'Android',
+    freebsd: 'FreeBSD',
+    openbsd: 'OpenBSD',
+};
+const ARCH_NAMES = {
+    ia32: 'x32',
+    x32: 'x32',
+    x64: 'x64',
+    x86_64: 'x64',
+    arm: 'arm',
+    arm64: 'arm64',
+    aarch64: 'arm64',
+};
+// The package targets Node (see engines), and has no @types/node, so reach for
+// process the same way credentials.ts does.
+function nodeProcess() {
+    return globalThis.process ?? {};
+}
+function platformHeaders() {
+    const { platform, arch, version } = nodeProcess();
+    return {
+        'X-Qoder-Lang': 'js',
+        'X-Qoder-Package-Version': version_js_1.VERSION,
+        'X-Qoder-OS': platform ? OS_NAMES[platform] ?? `Other:${platform}` : 'Unknown',
+        'X-Qoder-Arch': arch ? ARCH_NAMES[arch] ?? `other:${arch}` : 'unknown',
+        // Only Node is supported today; report the runtime we actually detect rather
+        // than claiming node when process is missing.
+        'X-Qoder-Runtime': version ? 'node' : 'unknown',
+        'X-Qoder-Runtime-Version': version ? version.replace(/^v/, '') : 'unknown',
+    };
+}
+//# sourceMappingURL=detect-platform.js.map

package/dist/core/detect-platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-platform.js","sourceRoot":"","sources":["../../src/core/detect-platform.ts"],"names":[],"mappings":";;AAiCA,0CAYC;AA7CD,8CAAwC;AAExC,+EAA+E;AAC/E,mFAAmF;AACnF,mFAAmF;AACnF,6DAA6D;AAC7D,MAAM,QAAQ,GAA2B;IACvC,MAAM,EAAE,OAAO;IACf,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF,MAAM,UAAU,GAA2B;IACzC,IAAI,EAAE,KAAK;IACX,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,KAAK;IACb,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,OAAO;CACjB,CAAC;AAEF,+EAA+E;AAC/E,4CAA4C;AAC5C,SAAS,WAAW;IAClB,OAAQ,UAA8F,CAAC,OAAO,IAAI,EAAE,CAAC;AACvH,CAAC;AAED,SAAgB,eAAe;IAC7B,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE,CAAC;IAClD,OAAO;QACL,cAAc,EAAE,IAAI;QACpB,yBAAyB,EAAE,oBAAO;QAClC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,SAAS,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS;QAC9E,cAAc,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;QACtE,6EAA6E;QAC7E,8CAA8C;QAC9C,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;QAC/C,yBAAyB,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;KAC3E,CAAC;AACJ,CAAC"}

package/dist/core/error.d.ts

@@ -1,39 +1,41 @@
 export declare class QoderError extends Error {
     constructor(message: string, options?: ErrorOptions);
 }
-export declare class APIError extends QoderError {
-    readonly status: number;
-    readonly error: unknown;
-    readonly headers: Headers;
+export declare class APIError<TStatus extends number | undefined = number | undefined, THeaders extends Headers | undefined = Headers | undefined, TError = unknown> extends QoderError {
+    readonly status: TStatus;
+    readonly error: TError;
+    readonly headers: THeaders;
     readonly response?: Response | undefined;
     readonly request_id: string | null;
     readonly requestID: string | null;
     readonly code?: string;
     readonly type?: string;
     request?: Request;
-    constructor(status: number, error: unknown, message?: string, headers?: Headers, response?: Response | undefined);
-    static generate(status: number, error: unknown, message?: string, headers?: Headers, response?: Response): APIError;
+    constructor(status: TStatus, error: TError, message?: string, headers?: THeaders, response?: Response | undefined, options?: ErrorOptions);
+    static generate(status: number, error: unknown, message?: string, headers?: Headers, response?: Response): APIError<number, Headers>;
 }
-export declare class BadRequestError extends APIError {
+export declare class BadRequestError extends APIError<400, Headers> {
 }
-export declare class AuthenticationError extends APIError {
+export declare class AuthenticationError extends APIError<401, Headers> {
 }
-export declare class PermissionDeniedError extends APIError {
+export declare class PermissionDeniedError extends APIError<403, Headers> {
 }
-export declare class NotFoundError extends APIError {
+export declare class NotFoundError extends APIError<404, Headers> {
 }
-export declare class ConflictError extends APIError {
+export declare class ConflictError extends APIError<409, Headers> {
 }
-export declare class UnprocessableEntityError extends APIError {
+export declare class UnprocessableEntityError extends APIError<422, Headers> {
 }
-export declare class RateLimitError extends APIError {
+export declare class RateLimitError extends APIError<429, Headers> {
 }
-export declare class InternalServerError extends APIError {
+export declare class InternalServerError extends APIError<number, Headers> {
 }
-export declare class APIConnectionError extends QoderError {
+export declare class APIConnectionError extends APIError<undefined, undefined, undefined> {
+    constructor(message: string, options?: ErrorOptions);
 }
 export declare class APIConnectionTimeoutError extends APIConnectionError {
 }
-export declare class APIUserAbortError extends QoderError {
+export declare class APIUserAbortError extends APIError<undefined, undefined, undefined> {
+    constructor(message: string, options?: ErrorOptions);
 }
 //# sourceMappingURL=error.d.ts.map

package/dist/core/error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/core/error.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED,qBAAa,QAAS,SAAQ,UAAU;IAOpC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO;IAEvB,QAAQ,CAAC,OAAO;IAChB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ;IAV9B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEP,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACvB,OAAO,CAAC,EAAE,MAAM,EACP,OAAO,UAAgB,EACvB,QAAQ,CAAC,EAAE,QAAQ,YAAA;IAY9B,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ;CAMpH;AACD,qBAAa,eAAgB,SAAQ,QAAQ;CAAG;AAChD,qBAAa,mBAAoB,SAAQ,QAAQ;CAAG;AACpD,qBAAa,qBAAsB,SAAQ,QAAQ;CAAG;AACtD,qBAAa,aAAc,SAAQ,QAAQ;CAAG;AAC9C,qBAAa,aAAc,SAAQ,QAAQ;CAAG;AAC9C,qBAAa,wBAAyB,SAAQ,QAAQ;CAAG;AACzD,qBAAa,cAAe,SAAQ,QAAQ;CAAG;AAC/C,qBAAa,mBAAoB,SAAQ,QAAQ;CAAG;AACpD,qBAAa,kBAAmB,SAAQ,UAAU;CAAG;AACrD,qBAAa,yBAA0B,SAAQ,kBAAkB;CAAG;AACpE,qBAAa,iBAAkB,SAAQ,UAAU;CAAG"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/core/error.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED,qBAAa,QAAQ,CACnB,OAAO,SAAS,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,EACvD,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,EAC1D,MAAM,GAAG,OAAO,CAChB,SAAQ,UAAU;IAOhB,QAAQ,CAAC,MAAM,EAAE,OAAO;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM;IAEtB,QAAQ,CAAC,OAAO,EAAE,QAAQ;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ;IAV9B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEP,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,MAAM,EACP,OAAO,GAAE,QAAyE,EAClF,QAAQ,CAAC,EAAE,QAAQ,YAAA,EAC5B,OAAO,CAAC,EAAE,YAAY;IAYxB,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,UAAgB,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAa3I;AACD,qBAAa,eAAgB,SAAQ,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CAAG;AAC9D,qBAAa,mBAAoB,SAAQ,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CAAG;AAClE,qBAAa,qBAAsB,SAAQ,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CAAG;AACpE,qBAAa,aAAc,SAAQ,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CAAG;AAC5D,qBAAa,aAAc,SAAQ,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CAAG;AAC5D,qBAAa,wBAAyB,SAAQ,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CAAG;AACvE,qBAAa,cAAe,SAAQ,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CAAG;AAC7D,qBAAa,mBAAoB,SAAQ,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAAG;AACrE,qBAAa,kBAAmB,SAAQ,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;gBACnE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAGpD;AACD,qBAAa,yBAA0B,SAAQ,kBAAkB;CAAG;AACpE,qBAAa,iBAAkB,SAAQ,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;gBAClE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAGpD"}

package/dist/core/error.js

@@ -18,25 +18,32 @@ class APIError extends QoderError {
     code;
     type;
     request;
-    constructor(status, error, message, headers = new Headers(), response) {
+    constructor(status, error, message, headers = (status === undefined ? undefined : new Headers()), response, options) {
         const envelope = error && typeof error === 'object' ? error : {};
         const detail = envelope.error && typeof envelope.error === 'object'
             ? envelope.error : envelope;
-        super(message ?? (typeof detail.message === 'string' ? detail.message : `HTTP ${status}${typeof error === 'string' && error ? `: ${error}` : ''}`));
+        super(message ?? (typeof detail.message === 'string' ? detail.message : `HTTP ${status}${typeof error === 'string' && error ? `: ${error}` : ''}`), options);
         this.status = status;
         this.error = error;
         this.headers = headers;
         this.response = response;
-        this.request_id = typeof envelope.request_id === 'string' && envelope.request_id ? envelope.request_id : headers.get('x-request-id') ?? headers.get('request-id');
+        this.request_id = typeof envelope.request_id === 'string' && envelope.request_id ? envelope.request_id : headers?.get('x-request-id') ?? headers?.get('request-id') ?? null;
         this.requestID = this.request_id;
         this.code = typeof detail.code === 'string' ? detail.code : undefined;
         this.type = typeof detail.type === 'string' ? detail.type : undefined;
     }
-    static generate(status, error, message, headers, response) {
-        const Type = { 400: BadRequestError, 401: AuthenticationError, 403: PermissionDeniedError,
-            404: NotFoundError, 409: ConflictError, 422: UnprocessableEntityError, 429: RateLimitError }[status]
-            ?? (status >= 500 ? InternalServerError : APIError);
-        return new Type(status, error, message, headers, response);
+    static generate(status, error, message, headers = new Headers(), response) {
+        switch (status) {
+            case 400: return new BadRequestError(status, error, message, headers, response);
+            case 401: return new AuthenticationError(status, error, message, headers, response);
+            case 403: return new PermissionDeniedError(status, error, message, headers, response);
+            case 404: return new NotFoundError(status, error, message, headers, response);
+            case 409: return new ConflictError(status, error, message, headers, response);
+            case 422: return new UnprocessableEntityError(status, error, message, headers, response);
+            case 429: return new RateLimitError(status, error, message, headers, response);
+            default: return status >= 500 ? new InternalServerError(status, error, message, headers, response)
+                : new APIError(status, error, message, headers, response);
+        }
     }
 }
 exports.APIError = APIError;
@@ -64,13 +71,19 @@ exports.RateLimitError = RateLimitError;
 class InternalServerError extends APIError {
 }
 exports.InternalServerError = InternalServerError;
-class APIConnectionError extends QoderError {
+class APIConnectionError extends APIError {
+    constructor(message, options) {
+        super(undefined, undefined, message, undefined, undefined, options);
+    }
 }
 exports.APIConnectionError = APIConnectionError;
 class APIConnectionTimeoutError extends APIConnectionError {
 }
 exports.APIConnectionTimeoutError = APIConnectionTimeoutError;
-class APIUserAbortError extends QoderError {
+class APIUserAbortError extends APIError {
+    constructor(message, options) {
+        super(undefined, undefined, message, undefined, undefined, options);
+    }
 }
 exports.APIUserAbortError = APIUserAbortError;
 //# sourceMappingURL=error.js.map

package/dist/core/error.js.map

@@ -1 +1 @@
-{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/core/error.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/core/error.ts"],"names":[],"mappings":"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"}

package/dist/core/pagination.d.ts

@@ -30,7 +30,7 @@ export declare class Page<T> implements AsyncIterable<T> {
     toJSON(): PageResponse<T>;
     hasNextPage(): boolean;
     getPaginatedItems(): T[];
-    getNextPage(): Promise<Page<T> | null>;
+    getNextPage(): Promise<Page<T>>;
     iterPages(): AsyncGenerator<Page<T>>;
     [Symbol.asyncIterator](): AsyncGenerator<T>;
 }

package/dist/core/pagination.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/core/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,YAAY,CAAC;AAC9D,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,IAAI,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAU5C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAfvB,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;IACnB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;gBAGJ,MAAM,EAAE,SAAS,EACzB,QAAQ,EAAE,QAAQ,EACV,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EACrB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,cAAc;IAcvC,OAAO,CAAC,SAAS;IAuBjB,MAAM,IAAI,YAAY,CAAC,CAAC,CAAC;IAEzB,WAAW,IAAI,OAAO;IACtB,iBAAiB,IAAI,CAAC,EAAE;IAElB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAKrC,SAAS,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAcpC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC;CAGnD;AAED,qBAAa,WAAW,CAAC,CAAC,CAAE,SAAQ,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAC1E,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC;CACnD"}
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/core/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,YAAY,CAAC;AAC9D,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,IAAI,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAU5C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAfvB,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;IACnB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;gBAGJ,MAAM,EAAE,SAAS,EACzB,QAAQ,EAAE,QAAQ,EACV,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EACrB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,cAAc;IAcvC,OAAO,CAAC,SAAS;IAuBjB,MAAM,IAAI,YAAY,CAAC,CAAC,CAAC;IAEzB,WAAW,IAAI,OAAO;IACtB,iBAAiB,IAAI,CAAC,EAAE;IAElB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAQ9B,SAAS,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAcpC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC;CAGnD;AAED,qBAAa,WAAW,CAAC,CAAC,CAAE,SAAQ,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAC1E,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC;CACnD"}

package/dist/core/pagination.js

@@ -71,12 +71,15 @@ class Page {
     getPaginatedItems() { return this.data; }
     async getNextPage() {
         const query = this.nextQuery();
-        return query ? await this.client.getAPIList(this.path, query, this.options, this.mode) : null;
+        if (!query) {
+            throw new error_js_1.QoderError('No next page expected; please check `.hasNextPage()` before calling `.getNextPage()`.');
+        }
+        return await this.client.getAPIList(this.path, query, this.options, this.mode);
     }
     async *iterPages() {
         let page = this;
         const cursors = new Set();
-        while (page) {
+        while (true) {
             yield page;
             const next = page.nextQuery();
             if (!next)

package/dist/core/pagination.js.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/core/pagination.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/core/pagination.ts"],"names":[],"mappings":"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"}

package/dist/core/resumable-session-event-stream.d.ts

@@ -0,0 +1,34 @@
+import { type HeadersLike } from './client.js';
+import type { Stream } from './streaming.js';
+type StreamFactory<T> = (lastEventID: string | undefined, signal: AbortSignal) => Promise<Stream<T>>;
+/** @internal Resolve the cursor with the same precedence as a direct stream request. */
+export declare function initialLastEventID(value: string | null | undefined, defaultHeaders?: HeadersLike, headers?: HeadersLike): string | undefined;
+/** @internal Replace only the cursor while retaining all other header overrides and deletions. */
+export declare function resumableRequestHeaders(headers: HeadersLike | undefined, lastEventID: string | undefined): HeadersLike;
+/** @internal Exported for deterministic retry-policy tests. */
+export declare function isResumableStreamRetryable(error: unknown): boolean;
+/** @internal Exported for deterministic backoff tests. */
+export declare function resumableStreamRetryDelay(attempt: number, random?: () => number): number;
+/**
+ * A stateful, single-consumer Session Events stream that reconnects after retryable
+ * failures and resumes from the last fully decoded SSE frame.
+ */
+export declare class ResumableSessionEventStream<T> implements AsyncIterable<T> {
+    private readonly openStream;
+    readonly controller: AbortController;
+    lastEventID: string | undefined;
+    private activeStream?;
+    private activeIterator?;
+    private consumed;
+    private closed;
+    private abortCleanup?;
+    private readonly callerSignal?;
+    private readonly onCallerAbort;
+    private readonly onAbort;
+    constructor(openStream: StreamFactory<T>, initialLastEventID?: string | null, signal?: AbortSignal | null);
+    private releaseActiveStream;
+    close(): Promise<void>;
+    [Symbol.asyncIterator](): AsyncGenerator<T>;
+}
+export {};
+//# sourceMappingURL=resumable-session-event-stream.d.ts.map

package/dist/core/resumable-session-event-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resumable-session-event-stream.d.ts","sourceRoot":"","sources":["../../src/core/resumable-session-event-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAK7C,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAErG,wFAAwF;AACxF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,cAAc,CAAC,EAAE,WAAW,EAC5B,OAAO,CAAC,EAAE,WAAW,GACpB,MAAM,GAAG,SAAS,CAGpB;AAED,kGAAkG;AAClG,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAYtH;AAED,+DAA+D;AAC/D,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAWlE;AAED,0DAA0D;AAC1D,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAc,GAAG,MAAM,CAGvF;AA4BD;;;GAGG;AACH,qBAAa,2BAA2B,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAcnE,OAAO,CAAC,QAAQ,CAAC,UAAU;IAb7B,QAAQ,CAAC,UAAU,kBAAyB;IAC5C,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAEhC,OAAO,CAAC,YAAY,CAAC,CAAY;IACjC,OAAO,CAAC,cAAc,CAAC,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAC,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAc;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAa;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;gBAGlB,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,EAC7C,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,EAClC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI;YAWf,mBAAmB;IAS3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWrB,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC;CAyDnD"}

package/dist/core/resumable-session-event-stream.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResumableSessionEventStream = void 0;
+exports.initialLastEventID = initialLastEventID;
+exports.resumableRequestHeaders = resumableRequestHeaders;
+exports.isResumableStreamRetryable = isResumableStreamRetryable;
+exports.resumableStreamRetryDelay = resumableStreamRetryDelay;
+const client_js_1 = require("./client.js");
+const error_js_1 = require("./error.js");
+const INITIAL_RETRY_DELAY = 500;
+const MAX_RETRY_DELAY = 10_000;
+/** @internal Resolve the cursor with the same precedence as a direct stream request. */
+function initialLastEventID(value, defaultHeaders, headers) {
+    const typedHeader = value == null ? undefined : { 'Last-Event-ID': value };
+    return (0, client_js_1.mergeHeaders)(defaultHeaders, typedHeader, headers).get('last-event-id') ?? undefined;
+}
+/** @internal Replace only the cursor while retaining all other header overrides and deletions. */
+function resumableRequestHeaders(headers, lastEventID) {
+    const values = {};
+    if (headers instanceof Headers || Array.isArray(headers)) {
+        new Headers(headers).forEach((value, key) => { values[key] = value; });
+    }
+    else if (headers) {
+        Object.assign(values, headers);
+    }
+    for (const key of Object.keys(values)) {
+        if (key.toLowerCase() === 'last-event-id')
+            delete values[key];
+    }
+    values['Last-Event-ID'] = lastEventID ?? null;
+    return values;
+}
+/** @internal Exported for deterministic retry-policy tests. */
+function isResumableStreamRetryable(error) {
+    if (error instanceof error_js_1.APIUserAbortError)
+        return false;
+    if (error instanceof error_js_1.APIConnectionError)
+        return true;
+    if (error instanceof error_js_1.APIError) {
+        if (error.status === 409)
+            return false;
+        if (error.headers?.get('x-should-retry') === 'false')
+            return false;
+        if (error.headers?.get('x-should-retry') === 'true')
+            return true;
+        return error.status === 408 || error.status === 429 || (error.status !== undefined && error.status >= 500);
+    }
+    // Response-body transport failures are surfaced by ReadableStream as their original error.
+    return !(error instanceof error_js_1.QoderError) && !(error instanceof SyntaxError);
+}
+/** @internal Exported for deterministic backoff tests. */
+function resumableStreamRetryDelay(attempt, random = Math.random) {
+    const backoff = Math.min(INITIAL_RETRY_DELAY * 2 ** attempt, MAX_RETRY_DELAY);
+    return backoff * (0.5 + random() * 0.5);
+}
+function aborted(signal) {
+    return new error_js_1.APIUserAbortError('Request was aborted', { cause: signal.reason });
+}
+function isTerminalSessionEvent(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const type = value.type;
+    return type === 'session.status_terminated' || type === 'session.deleted';
+}
+async function waitForRetry(ms, signal) {
+    if (signal.aborted)
+        throw aborted(signal);
+    let timer;
+    await new Promise((resolve, reject) => {
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(aborted(signal));
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        timer = setTimeout(() => {
+            signal.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+    });
+}
+/**
+ * A stateful, single-consumer Session Events stream that reconnects after retryable
+ * failures and resumes from the last fully decoded SSE frame.
+ */
+class ResumableSessionEventStream {
+    openStream;
+    controller = new AbortController();
+    lastEventID;
+    activeStream;
+    activeIterator;
+    consumed = false;
+    closed = false;
+    abortCleanup;
+    callerSignal;
+    onCallerAbort;
+    onAbort;
+    constructor(openStream, initialLastEventID, signal) {
+        this.openStream = openStream;
+        this.lastEventID = initialLastEventID ?? undefined;
+        this.callerSignal = signal ?? undefined;
+        this.onCallerAbort = () => this.controller.abort(this.callerSignal?.reason);
+        this.onAbort = () => { this.abortCleanup ??= this.releaseActiveStream(); };
+        this.controller.signal.addEventListener('abort', this.onAbort, { once: true });
+        if (this.callerSignal?.aborted)
+            this.onCallerAbort();
+        else
+            this.callerSignal?.addEventListener('abort', this.onCallerAbort, { once: true });
+    }
+    async releaseActiveStream() {
+        const iterator = this.activeIterator;
+        const stream = this.activeStream;
+        this.activeIterator = undefined;
+        this.activeStream = undefined;
+        await iterator?.return?.().catch(() => { });
+        await stream?.close();
+    }
+    async close() {
+        if (this.closed) {
+            await this.abortCleanup;
+            return;
+        }
+        this.closed = true;
+        this.callerSignal?.removeEventListener('abort', this.onCallerAbort);
+        this.controller.abort();
+        await (this.abortCleanup ?? this.releaseActiveStream());
+    }
+    async *[Symbol.asyncIterator]() {
+        if (this.consumed)
+            throw new error_js_1.QoderError('Cannot iterate over a consumed stream');
+        this.consumed = true;
+        let attempt = 0;
+        try {
+            while (!this.closed) {
+                let stream;
+                try {
+                    stream = await this.openStream(this.lastEventID, this.controller.signal);
+                    if (this.closed) {
+                        await stream.close();
+                        return;
+                    }
+                    this.activeStream = stream;
+                    const iterator = stream[Symbol.asyncIterator]();
+                    this.activeIterator = iterator;
+                    for (;;) {
+                        const result = await iterator.next();
+                        if (stream.hasLastEventID)
+                            this.lastEventID = stream.lastEventID;
+                        if (result.done) {
+                            if (stream.completed)
+                                return;
+                            break;
+                        }
+                        if (this.closed)
+                            return;
+                        attempt = 0;
+                        const terminal = isTerminalSessionEvent(result.value);
+                        yield result.value;
+                        if (terminal)
+                            return;
+                    }
+                }
+                catch (error) {
+                    if (stream?.hasLastEventID)
+                        this.lastEventID = stream.lastEventID;
+                    if (this.closed)
+                        return;
+                    if (this.controller.signal.aborted)
+                        throw error instanceof error_js_1.APIUserAbortError ? error : aborted(this.controller.signal);
+                    if (!isResumableStreamRetryable(error))
+                        throw error;
+                }
+                finally {
+                    const iterator = this.activeIterator;
+                    if (this.activeStream === stream) {
+                        this.activeIterator = undefined;
+                        this.activeStream = undefined;
+                    }
+                    await iterator?.return?.().catch(() => { });
+                    await stream?.close();
+                }
+                if (this.closed)
+                    return;
+                try {
+                    await waitForRetry(resumableStreamRetryDelay(attempt++), this.controller.signal);
+                }
+                catch (error) {
+                    if (this.closed)
+                        return;
+                    throw error;
+                }
+            }
+        }
+        finally {
+            await this.close();
+        }
+    }
+}
+exports.ResumableSessionEventStream = ResumableSessionEventStream;
+//# sourceMappingURL=resumable-session-event-stream.js.map

package/dist/core/resumable-session-event-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resumable-session-event-stream.js","sourceRoot":"","sources":["../../src/core/resumable-session-event-stream.ts"],"names":[],"mappings":"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"}

package/dist/core/streaming.d.ts

@@ -2,6 +2,7 @@ export interface ServerSentEvent {
     event: string;
     data: string;
     id: string;
+    hasID: boolean;
     retry?: number;
 }
 /** Incremental SSE decoding: IDs identify events, not individual delta frames. */
@@ -10,6 +11,8 @@ export declare class Stream<T> implements AsyncIterable<T> {
     readonly response: Response;
     readonly controller: AbortController;
     lastEventID: string;
+    hasLastEventID: boolean;
+    completed: boolean;
     private consumed;
     private closed;
     constructor(response: Response, controller?: AbortController);

package/dist/core/streaming.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/core/streaming.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kFAAkF;AAClF,wBAAuB,SAAS,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,eAAe,CAAC,CAmDlG;AAED,qBAAa,MAAM,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAMpC,QAAQ,CAAC,QAAQ,EAAE,QAAQ;IALvC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,WAAW,SAAM;IACjB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEF,QAAQ,EAAE,QAAQ,EAAE,UAAU,kBAAwB;IAI3E,MAAM,CAAC,eAAe,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,kBAAwB,GAAG,MAAM,CAAC,CAAC,CAAC;IAItF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC;CAwBnD"}
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/core/streaming.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kFAAkF;AAClF,wBAAuB,SAAS,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,eAAe,CAAC,CAkDlG;AAED,qBAAa,MAAM,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAQpC,QAAQ,CAAC,QAAQ,EAAE,QAAQ;IAPvC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,WAAW,SAAM;IACjB,cAAc,UAAS;IACvB,SAAS,UAAS;IAClB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEF,QAAQ,EAAE,QAAQ,EAAE,UAAU,kBAAwB;IAI3E,MAAM,CAAC,eAAe,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,kBAAwB,GAAG,MAAM,CAAC,CAAC,CAAC;IAItF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC;CA2BnD"}

package/dist/core/streaming.js

@@ -9,6 +9,7 @@ async function* decodeSSE(body) {
     const decoder = new TextDecoder();
     let buffer = '';
     let lastID = '';
+    let hasID = false;
     let type = 'message';
     let data = [];
     let retry;
@@ -17,9 +18,10 @@ async function* decodeSSE(body) {
         if (new TextEncoder().encode(text).byteLength > 32 * 1024 * 1024)
             throw new error_js_1.QoderError('SSE line exceeds 32 MiB');
         if (!text) {
-            const event = data.length ? { event: type, data: data.join('\n'), id: lastID, retry } : undefined;
+            const event = data.length || hasID ? { event: type, data: data.join('\n'), id: lastID, hasID, retry } : undefined;
             type = 'message';
             data = [];
+            hasID = false;
             retry = undefined;
             return event;
         }
@@ -34,8 +36,10 @@ async function* decodeSSE(body) {
             type = value;
         if (key === 'data')
             data.push(value);
-        if (key === 'id' && !value.includes('\0'))
+        if (key === 'id' && !value.includes('\0')) {
             lastID = value;
+            hasID = true;
+        }
         if (key === 'retry' && /^\d+$/.test(value))
             retry = Number(value);
     };
@@ -62,14 +66,7 @@ async function* decodeSSE(body) {
             if (buffer.length > 32 * 1024 * 1024)
                 throw new error_js_1.QoderError('SSE line exceeds 32 MiB');
         }
-        if (buffer) {
-            const event = line(buffer);
-            if (event)
-                yield event;
-        }
-        const event = line('');
-        if (event)
-            yield event;
+        // EOF does not complete a frame; retain the last cursor only after a blank-line dispatch.
     }
     finally {
         if (!done)
@@ -81,6 +78,8 @@ class Stream {
     response;
     controller;
     lastEventID = '';
+    hasLastEventID = false;
+    completed = false;
     consumed = false;
     closed = false;
     constructor(response, controller = new AbortController()) {
@@ -108,13 +107,18 @@ class Stream {
             throw new error_js_1.QoderError('Missing SSE response body');
         try {
             for await (const frame of decodeSSE(this.response.body)) {
-                this.lastEventID = frame.id;
+                if (frame.hasID) {
+                    this.lastEventID = frame.id;
+                    this.hasLastEventID = true;
+                }
                 if (this.closed)
                     return;
                 if (frame.event === 'ping' || !frame.data)
                     continue;
-                if (frame.data === '[DONE]')
+                if (frame.data === '[DONE]') {
+                    this.completed = true;
                     return;
+                }
                 const data = JSON.parse(frame.data);
                 if (frame.event === 'error') {
                     throw error_js_1.APIError.generate(this.response.status, data, undefined, this.response.headers, this.response);