@onkernel/sdk 0.80.0 → 0.81.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.81.0 (2026-07-21)
+
+Full Changelog: [v0.80.0...v0.81.0](https://github.com/kernel/kernel-node-sdk/compare/v0.80.0...v0.81.0)
+
+### Features
+
+* add complete audit log downloads ([6cb8e9e](https://github.com/kernel/kernel-node-sdk/commit/6cb8e9e38540b5e2954a6304b61b848fca70909e))
+
 ## 0.80.0 (2026-07-19)
 
 Full Changelog: [v0.79.0...v0.80.0](https://github.com/kernel/kernel-node-sdk/compare/v0.79.0...v0.80.0)

package/index.d.mts

@@ -3,6 +3,7 @@ export { type Uploadable, toFile } from "./core/uploads.mjs";
 export { APIPromise } from "./core/api-promise.mjs";
 export { Kernel, type ClientOptions } from "./client.mjs";
 export { type BrowserFetchInit } from "./lib/browser-fetch.mjs";
+export { AuditLogDownloadError, type AuditLogDownloadDestination, type AuditLogDownloadOptions, type AuditLogDownloadParams, type AuditLogDownloadProgress, type AuditLogDownloadResult, type AuditLogDownloadWriteResult, } from "./lib/audit-log-download.mjs";
 export { BrowserRouteCache, type BrowserRoute } from "./lib/browser-routing.mjs";
 export { PagePromise } from "./core/pagination.mjs";
 export { KernelError, APIError, APIConnectionError, APIConnectionTimeoutError, APIUserAbortError, NotFoundError, ConflictError, RateLimitError, BadRequestError, AuthenticationError, InternalServerError, PermissionDeniedError, UnprocessableEntityError, } from "./core/error.mjs";

package/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,qBAAiB;AAE7C,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,EAAE,2BAAuB;AACzD,OAAO,EAAE,UAAU,EAAE,+BAA2B;AAChD,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,qBAAiB;AACtD,OAAO,EAAE,KAAK,gBAAgB,EAAE,gCAA4B;AAC5D,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,kCAA8B;AAC7E,OAAO,EAAE,WAAW,EAAE,8BAA0B;AAChD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,GACzB,yBAAqB;AAEtB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,iCAA6B"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,qBAAiB;AAE7C,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,EAAE,2BAAuB;AACzD,OAAO,EAAE,UAAU,EAAE,+BAA2B;AAChD,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,qBAAiB;AACtD,OAAO,EAAE,KAAK,gBAAgB,EAAE,gCAA4B;AAC5D,OAAO,EACL,qBAAqB,EACrB,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,GACjC,qCAAiC;AAClC,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,kCAA8B;AAC7E,OAAO,EAAE,WAAW,EAAE,8BAA0B;AAChD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,GACzB,yBAAqB;AAEtB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,iCAA6B"}

package/index.d.ts

@@ -3,6 +3,7 @@ export { type Uploadable, toFile } from "./core/uploads.js";
 export { APIPromise } from "./core/api-promise.js";
 export { Kernel, type ClientOptions } from "./client.js";
 export { type BrowserFetchInit } from "./lib/browser-fetch.js";
+export { AuditLogDownloadError, type AuditLogDownloadDestination, type AuditLogDownloadOptions, type AuditLogDownloadParams, type AuditLogDownloadProgress, type AuditLogDownloadResult, type AuditLogDownloadWriteResult, } from "./lib/audit-log-download.js";
 export { BrowserRouteCache, type BrowserRoute } from "./lib/browser-routing.js";
 export { PagePromise } from "./core/pagination.js";
 export { KernelError, APIError, APIConnectionError, APIConnectionTimeoutError, APIUserAbortError, NotFoundError, ConflictError, RateLimitError, BadRequestError, AuthenticationError, InternalServerError, PermissionDeniedError, UnprocessableEntityError, } from "./core/error.js";

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,oBAAiB;AAE7C,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,EAAE,0BAAuB;AACzD,OAAO,EAAE,UAAU,EAAE,8BAA2B;AAChD,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,oBAAiB;AACtD,OAAO,EAAE,KAAK,gBAAgB,EAAE,+BAA4B;AAC5D,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,iCAA8B;AAC7E,OAAO,EAAE,WAAW,EAAE,6BAA0B;AAChD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,GACzB,wBAAqB;AAEtB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,gCAA6B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,oBAAiB;AAE7C,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,EAAE,0BAAuB;AACzD,OAAO,EAAE,UAAU,EAAE,8BAA2B;AAChD,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,oBAAiB;AACtD,OAAO,EAAE,KAAK,gBAAgB,EAAE,+BAA4B;AAC5D,OAAO,EACL,qBAAqB,EACrB,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,GACjC,oCAAiC;AAClC,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,iCAA8B;AAC7E,OAAO,EAAE,WAAW,EAAE,6BAA0B;AAChD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,GACzB,wBAAqB;AAEtB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,gCAA6B"}

package/index.js

@@ -4,7 +4,7 @@ exports = module.exports = function (...args) {
   return new exports.default(...args)
 }
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.appRegistry = exports.UnprocessableEntityError = exports.PermissionDeniedError = exports.InternalServerError = exports.AuthenticationError = exports.BadRequestError = exports.RateLimitError = exports.ConflictError = exports.NotFoundError = exports.APIUserAbortError = exports.APIConnectionTimeoutError = exports.APIConnectionError = exports.APIError = exports.KernelError = exports.PagePromise = exports.BrowserRouteCache = exports.Kernel = exports.APIPromise = exports.toFile = exports.default = void 0;
+exports.appRegistry = exports.UnprocessableEntityError = exports.PermissionDeniedError = exports.InternalServerError = exports.AuthenticationError = exports.BadRequestError = exports.RateLimitError = exports.ConflictError = exports.NotFoundError = exports.APIUserAbortError = exports.APIConnectionTimeoutError = exports.APIConnectionError = exports.APIError = exports.KernelError = exports.PagePromise = exports.BrowserRouteCache = exports.AuditLogDownloadError = exports.Kernel = exports.APIPromise = exports.toFile = exports.default = void 0;
 var client_1 = require("./client.js");
 Object.defineProperty(exports, "default", { enumerable: true, get: function () { return client_1.Kernel; } });
 var uploads_1 = require("./core/uploads.js");
@@ -13,6 +13,8 @@ var api_promise_1 = require("./core/api-promise.js");
 Object.defineProperty(exports, "APIPromise", { enumerable: true, get: function () { return api_promise_1.APIPromise; } });
 var client_2 = require("./client.js");
 Object.defineProperty(exports, "Kernel", { enumerable: true, get: function () { return client_2.Kernel; } });
+var audit_log_download_1 = require("./lib/audit-log-download.js");
+Object.defineProperty(exports, "AuditLogDownloadError", { enumerable: true, get: function () { return audit_log_download_1.AuditLogDownloadError; } });
 var browser_routing_1 = require("./lib/browser-routing.js");
 Object.defineProperty(exports, "BrowserRouteCache", { enumerable: true, get: function () { return browser_routing_1.BrowserRouteCache; } });
 var pagination_1 = require("./core/pagination.js");

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,sCAA6C;AAApC,iGAAA,MAAM,OAAW;AAE1B,6CAAyD;AAA/B,iGAAA,MAAM,OAAA;AAChC,qDAAgD;AAAvC,yGAAA,UAAU,OAAA;AACnB,sCAAsD;AAA7C,gGAAA,MAAM,OAAA;AAEf,4DAA6E;AAApE,oHAAA,iBAAiB,OAAA;AAC1B,mDAAgD;AAAvC,yGAAA,WAAW,OAAA;AACpB,yCAcsB;AAbpB,oGAAA,WAAW,OAAA;AACX,iGAAA,QAAQ,OAAA;AACR,2GAAA,kBAAkB,OAAA;AAClB,kHAAA,yBAAyB,OAAA;AACzB,0GAAA,iBAAiB,OAAA;AACjB,sGAAA,aAAa,OAAA;AACb,sGAAA,aAAa,OAAA;AACb,uGAAA,cAAc,OAAA;AACd,wGAAA,eAAe,OAAA;AACf,4GAAA,mBAAmB,OAAA;AACnB,4GAAA,mBAAmB,OAAA;AACnB,8GAAA,qBAAqB,OAAA;AACrB,iHAAA,wBAAwB,OAAA;AAG1B,yDAA4F;AAA1C,4GAAA,WAAW,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,sCAA6C;AAApC,iGAAA,MAAM,OAAW;AAE1B,6CAAyD;AAA/B,iGAAA,MAAM,OAAA;AAChC,qDAAgD;AAAvC,yGAAA,UAAU,OAAA;AACnB,sCAAsD;AAA7C,gGAAA,MAAM,OAAA;AAEf,kEAQkC;AAPhC,2HAAA,qBAAqB,OAAA;AAQvB,4DAA6E;AAApE,oHAAA,iBAAiB,OAAA;AAC1B,mDAAgD;AAAvC,yGAAA,WAAW,OAAA;AACpB,yCAcsB;AAbpB,oGAAA,WAAW,OAAA;AACX,iGAAA,QAAQ,OAAA;AACR,2GAAA,kBAAkB,OAAA;AAClB,kHAAA,yBAAyB,OAAA;AACzB,0GAAA,iBAAiB,OAAA;AACjB,sGAAA,aAAa,OAAA;AACb,sGAAA,aAAa,OAAA;AACb,uGAAA,cAAc,OAAA;AACd,wGAAA,eAAe,OAAA;AACf,4GAAA,mBAAmB,OAAA;AACnB,4GAAA,mBAAmB,OAAA;AACnB,8GAAA,qBAAqB,OAAA;AACrB,iHAAA,wBAAwB,OAAA;AAG1B,yDAA4F;AAA1C,4GAAA,WAAW,OAAA"}

package/index.mjs

@@ -3,6 +3,7 @@ export { Kernel as default } from "./client.mjs";
 export { toFile } from "./core/uploads.mjs";
 export { APIPromise } from "./core/api-promise.mjs";
 export { Kernel } from "./client.mjs";
+export { AuditLogDownloadError, } from "./lib/audit-log-download.mjs";
 export { BrowserRouteCache } from "./lib/browser-routing.mjs";
 export { PagePromise } from "./core/pagination.mjs";
 export { KernelError, APIError, APIConnectionError, APIConnectionTimeoutError, APIUserAbortError, NotFoundError, ConflictError, RateLimitError, BadRequestError, AuthenticationError, InternalServerError, PermissionDeniedError, UnprocessableEntityError, } from "./core/error.mjs";

package/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,qBAAiB;AAE7C,OAAO,EAAmB,MAAM,EAAE,2BAAuB;AACzD,OAAO,EAAE,UAAU,EAAE,+BAA2B;AAChD,OAAO,EAAE,MAAM,EAAsB,qBAAiB;AAEtD,OAAO,EAAE,iBAAiB,EAAqB,kCAA8B;AAC7E,OAAO,EAAE,WAAW,EAAE,8BAA0B;AAChD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,GACzB,yBAAqB;AAEtB,OAAO,EAA2C,WAAW,EAAE,iCAA6B"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,qBAAiB;AAE7C,OAAO,EAAmB,MAAM,EAAE,2BAAuB;AACzD,OAAO,EAAE,UAAU,EAAE,+BAA2B;AAChD,OAAO,EAAE,MAAM,EAAsB,qBAAiB;AAEtD,OAAO,EACL,qBAAqB,GAOtB,qCAAiC;AAClC,OAAO,EAAE,iBAAiB,EAAqB,kCAA8B;AAC7E,OAAO,EAAE,WAAW,EAAE,8BAA0B;AAChD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,GACzB,yBAAqB;AAEtB,OAAO,EAA2C,WAAW,EAAE,iCAA6B"}

package/lib/audit-log-download.d.mts

@@ -0,0 +1,28 @@
+import { KernelError } from "../core/error.mjs";
+import type { RequestOptions } from "../internal/request-options.mjs";
+import type { AuditLogExportChunkParams } from "../resources/audit-logs.mjs";
+export declare class AuditLogDownloadError extends KernelError {
+}
+export type AuditLogDownloadParams = Omit<AuditLogExportChunkParams, 'cursor' | 'format'>;
+export interface AuditLogDownloadResult {
+    bytesWritten: number;
+    chunks: number;
+    rows: number;
+}
+export interface AuditLogDownloadProgress extends AuditLogDownloadResult {
+    chunkRows: number;
+}
+export type AuditLogDownloadWriteResult = void | number | {
+    bytesWritten: number;
+};
+export interface AuditLogDownloadDestination {
+    write(chunk: Uint8Array): AuditLogDownloadWriteResult | Promise<AuditLogDownloadWriteResult>;
+}
+export interface AuditLogDownloadOptions extends Omit<RequestOptions, 'method' | 'path' | 'query' | 'body' | 'stream' | '__binaryResponse' | '__streamClass'> {
+    onProgress?(progress: AuditLogDownloadProgress): void | Promise<void>;
+    maxTransferRetries?: number;
+}
+type FetchChunk = (query: AuditLogExportChunkParams, options?: RequestOptions) => Promise<Response>;
+export declare function downloadAuditLogs(fetchChunk: FetchChunk, query: AuditLogDownloadParams, destination: AuditLogDownloadDestination, defaultTimeout: number, options?: AuditLogDownloadOptions): Promise<AuditLogDownloadResult>;
+export {};
+//# sourceMappingURL=audit-log-download.d.mts.map

package/lib/audit-log-download.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log-download.d.mts","sourceRoot":"","sources":["../src/lib/audit-log-download.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgD,WAAW,EAAE,0BAAsB;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,wCAAoC;AAClE,OAAO,KAAK,EAAE,yBAAyB,EAAE,oCAAgC;AAMzE,qBAAa,qBAAsB,SAAQ,WAAW;CAAG;AAEzD,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,yBAAyB,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC;AAE1F,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,wBAAyB,SAAQ,sBAAsB;IACtE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,2BAA2B,GAAG,IAAI,GAAG,MAAM,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF,MAAM,WAAW,2BAA2B;IAC1C,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,2BAA2B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;CAC9F;AAED,MAAM,WAAW,uBACf,SAAQ,IAAI,CACV,cAAc,EACd,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,kBAAkB,GAAG,eAAe,CACvF;IACD,UAAU,CAAC,CAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,KAAK,UAAU,GAAG,CAAC,KAAK,EAAE,yBAAyB,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEpG,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,sBAAsB,EAC7B,WAAW,EAAE,2BAA2B,EACxC,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CA0CjC"}

package/lib/audit-log-download.d.ts

@@ -0,0 +1,28 @@
+import { KernelError } from "../core/error.js";
+import type { RequestOptions } from "../internal/request-options.js";
+import type { AuditLogExportChunkParams } from "../resources/audit-logs.js";
+export declare class AuditLogDownloadError extends KernelError {
+}
+export type AuditLogDownloadParams = Omit<AuditLogExportChunkParams, 'cursor' | 'format'>;
+export interface AuditLogDownloadResult {
+    bytesWritten: number;
+    chunks: number;
+    rows: number;
+}
+export interface AuditLogDownloadProgress extends AuditLogDownloadResult {
+    chunkRows: number;
+}
+export type AuditLogDownloadWriteResult = void | number | {
+    bytesWritten: number;
+};
+export interface AuditLogDownloadDestination {
+    write(chunk: Uint8Array): AuditLogDownloadWriteResult | Promise<AuditLogDownloadWriteResult>;
+}
+export interface AuditLogDownloadOptions extends Omit<RequestOptions, 'method' | 'path' | 'query' | 'body' | 'stream' | '__binaryResponse' | '__streamClass'> {
+    onProgress?(progress: AuditLogDownloadProgress): void | Promise<void>;
+    maxTransferRetries?: number;
+}
+type FetchChunk = (query: AuditLogExportChunkParams, options?: RequestOptions) => Promise<Response>;
+export declare function downloadAuditLogs(fetchChunk: FetchChunk, query: AuditLogDownloadParams, destination: AuditLogDownloadDestination, defaultTimeout: number, options?: AuditLogDownloadOptions): Promise<AuditLogDownloadResult>;
+export {};
+//# sourceMappingURL=audit-log-download.d.ts.map

package/lib/audit-log-download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log-download.d.ts","sourceRoot":"","sources":["../src/lib/audit-log-download.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgD,WAAW,EAAE,yBAAsB;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,uCAAoC;AAClE,OAAO,KAAK,EAAE,yBAAyB,EAAE,mCAAgC;AAMzE,qBAAa,qBAAsB,SAAQ,WAAW;CAAG;AAEzD,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,yBAAyB,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC;AAE1F,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,wBAAyB,SAAQ,sBAAsB;IACtE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,2BAA2B,GAAG,IAAI,GAAG,MAAM,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF,MAAM,WAAW,2BAA2B;IAC1C,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,2BAA2B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;CAC9F;AAED,MAAM,WAAW,uBACf,SAAQ,IAAI,CACV,cAAc,EACd,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,kBAAkB,GAAG,eAAe,CACvF;IACD,UAAU,CAAC,CAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,KAAK,UAAU,GAAG,CAAC,KAAK,EAAE,yBAAyB,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEpG,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,sBAAsB,EAC7B,WAAW,EAAE,2BAA2B,EACxC,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CA0CjC"}

package/lib/audit-log-download.js

@@ -0,0 +1,176 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditLogDownloadError = void 0;
+exports.downloadAuditLogs = downloadAuditLogs;
+const error_1 = require("../core/error.js");
+const DEFAULT_MAX_TRANSFER_RETRIES = 6;
+const MAX_CHUNK_ROWS = 50000;
+const MAX_RETRY_DELAY_MS = 8000;
+class AuditLogDownloadError extends error_1.KernelError {
+}
+exports.AuditLogDownloadError = AuditLogDownloadError;
+async function downloadAuditLogs(fetchChunk, query, destination, defaultTimeout, options = {}) {
+    if (!destination || typeof destination.write !== 'function') {
+        throw new TypeError('audit log download destination must provide write()');
+    }
+    const { onProgress, maxTransferRetries = DEFAULT_MAX_TRANSFER_RETRIES, ...requestOptions } = options;
+    if (!Number.isInteger(maxTransferRetries) || maxTransferRetries < 0) {
+        throw new TypeError('maxTransferRetries must be a non-negative integer');
+    }
+    const timeout = requestOptions.timeout ?? defaultTimeout;
+    let cursor;
+    const result = { bytesWritten: 0, chunks: 0, rows: 0 };
+    const seenCursors = new Set();
+    while (true) {
+        const chunk = await fetchVerifiedChunk(fetchChunk, cursor ? { ...query, cursor } : query, requestOptions, maxTransferRetries, timeout);
+        const { nextCursor, hasMore, rows } = parseChunkHeaders(chunk.headers, cursor);
+        if (hasMore && nextCursor) {
+            if (seenCursors.has(nextCursor)) {
+                throw new AuditLogDownloadError('response repeated X-Next-Cursor header');
+            }
+            seenCursors.add(nextCursor);
+        }
+        await writeChunk(destination, chunk.body);
+        cursor = nextCursor;
+        result.bytesWritten += chunk.body.byteLength;
+        result.chunks += 1;
+        result.rows += rows;
+        if (onProgress) {
+            await onProgress({ ...result, chunkRows: rows });
+        }
+        if (!hasMore) {
+            return result;
+        }
+    }
+}
+async function fetchVerifiedChunk(fetchChunk, query, options, maxTransferRetries, timeout) {
+    for (let retries = 0;; retries += 1) {
+        const controller = new AbortController();
+        const onAbort = () => controller.abort();
+        if (options.signal?.aborted) {
+            controller.abort();
+        }
+        else {
+            options.signal?.addEventListener('abort', onAbort, { once: true });
+        }
+        let response;
+        try {
+            response = await fetchChunk(query, { ...options, signal: controller.signal });
+        }
+        catch (error) {
+            options.signal?.removeEventListener('abort', onAbort);
+            throw error;
+        }
+        let bodyTimedOut = false;
+        const timer = setTimeout(() => {
+            bodyTimedOut = true;
+            controller.abort();
+        }, timeout);
+        try {
+            const body = new Uint8Array(await response.arrayBuffer());
+            clearTimeout(timer);
+            if (options.signal?.aborted) {
+                throw new error_1.APIUserAbortError();
+            }
+            if (bodyTimedOut) {
+                throw new error_1.APIConnectionTimeoutError();
+            }
+            const expected = response.headers.get('x-content-sha256');
+            if (!expected) {
+                throw new AuditLogDownloadError('response missing X-Content-Sha256 header');
+            }
+            const actual = await sha256Hex(body);
+            if (options.signal?.aborted) {
+                throw new error_1.APIUserAbortError();
+            }
+            if (actual !== expected) {
+                throw new AuditLogDownloadError(`audit log chunk checksum mismatch (got ${actual}, want ${expected})`);
+            }
+            return { body, headers: response.headers };
+        }
+        catch (error) {
+            if (options.signal?.aborted && !(error instanceof error_1.APIUserAbortError)) {
+                error = new error_1.APIUserAbortError();
+            }
+            else if (bodyTimedOut) {
+                error = new error_1.APIConnectionTimeoutError();
+            }
+            if (retries === maxTransferRetries || error instanceof error_1.APIUserAbortError) {
+                throw error;
+            }
+            await retryDelay(retries + 1, options.signal);
+        }
+        finally {
+            clearTimeout(timer);
+            options.signal?.removeEventListener('abort', onAbort);
+        }
+    }
+}
+function parseChunkHeaders(headers, currentCursor) {
+    const hasMoreValue = headers.get('x-has-more');
+    if (hasMoreValue !== 'true' && hasMoreValue !== 'false') {
+        throw new AuditLogDownloadError('response missing or invalid X-Has-More header');
+    }
+    const hasMore = hasMoreValue === 'true';
+    const rowCount = headers.get('x-row-count');
+    if (rowCount === null || !/^[0-9]+$/.test(rowCount)) {
+        throw new AuditLogDownloadError('response missing or invalid X-Row-Count header');
+    }
+    const rows = Number(rowCount);
+    if (!Number.isSafeInteger(rows) || rows > MAX_CHUNK_ROWS) {
+        throw new AuditLogDownloadError('response missing or invalid X-Row-Count header');
+    }
+    const nextCursor = headers.get('x-next-cursor') || undefined;
+    if (hasMore && (!nextCursor || nextCursor === currentCursor)) {
+        throw new AuditLogDownloadError('response has invalid X-Next-Cursor header');
+    }
+    if (!hasMore && nextCursor) {
+        throw new AuditLogDownloadError('response returned a cursor after the final chunk');
+    }
+    return { rows, nextCursor, hasMore };
+}
+async function sha256Hex(body) {
+    const digest = await globalThis.crypto.subtle.digest('SHA-256', body);
+    return Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, '0')).join('');
+}
+async function retryDelay(attempt, signal) {
+    const delay = Math.min(1000 * 2 ** (attempt - 1), MAX_RETRY_DELAY_MS);
+    await new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new error_1.APIUserAbortError());
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new error_1.APIUserAbortError());
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, delay);
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+async function writeChunk(destination, body) {
+    let offset = 0;
+    while (offset < body.byteLength) {
+        const result = await destination.write(offset === 0 ? body : body.subarray(offset));
+        if (typeof result === 'number') {
+            offset += validateWriteCount(result, body.byteLength - offset);
+            continue;
+        }
+        if (result && typeof result === 'object' && 'bytesWritten' in result) {
+            const bytesWritten = result.bytesWritten;
+            offset += validateWriteCount(bytesWritten, body.byteLength - offset);
+            continue;
+        }
+        return;
+    }
+}
+function validateWriteCount(value, remaining) {
+    if (!Number.isSafeInteger(value) || value <= 0 || value > remaining) {
+        throw new AuditLogDownloadError('audit log download destination performed a short write');
+    }
+    return value;
+}
+//# sourceMappingURL=audit-log-download.js.map

package/lib/audit-log-download.js.map

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

package/lib/audit-log-download.mjs

@@ -0,0 +1,171 @@
+import { APIConnectionTimeoutError, APIUserAbortError, KernelError } from "../core/error.mjs";
+const DEFAULT_MAX_TRANSFER_RETRIES = 6;
+const MAX_CHUNK_ROWS = 50000;
+const MAX_RETRY_DELAY_MS = 8000;
+export class AuditLogDownloadError extends KernelError {
+}
+export async function downloadAuditLogs(fetchChunk, query, destination, defaultTimeout, options = {}) {
+    if (!destination || typeof destination.write !== 'function') {
+        throw new TypeError('audit log download destination must provide write()');
+    }
+    const { onProgress, maxTransferRetries = DEFAULT_MAX_TRANSFER_RETRIES, ...requestOptions } = options;
+    if (!Number.isInteger(maxTransferRetries) || maxTransferRetries < 0) {
+        throw new TypeError('maxTransferRetries must be a non-negative integer');
+    }
+    const timeout = requestOptions.timeout ?? defaultTimeout;
+    let cursor;
+    const result = { bytesWritten: 0, chunks: 0, rows: 0 };
+    const seenCursors = new Set();
+    while (true) {
+        const chunk = await fetchVerifiedChunk(fetchChunk, cursor ? { ...query, cursor } : query, requestOptions, maxTransferRetries, timeout);
+        const { nextCursor, hasMore, rows } = parseChunkHeaders(chunk.headers, cursor);
+        if (hasMore && nextCursor) {
+            if (seenCursors.has(nextCursor)) {
+                throw new AuditLogDownloadError('response repeated X-Next-Cursor header');
+            }
+            seenCursors.add(nextCursor);
+        }
+        await writeChunk(destination, chunk.body);
+        cursor = nextCursor;
+        result.bytesWritten += chunk.body.byteLength;
+        result.chunks += 1;
+        result.rows += rows;
+        if (onProgress) {
+            await onProgress({ ...result, chunkRows: rows });
+        }
+        if (!hasMore) {
+            return result;
+        }
+    }
+}
+async function fetchVerifiedChunk(fetchChunk, query, options, maxTransferRetries, timeout) {
+    for (let retries = 0;; retries += 1) {
+        const controller = new AbortController();
+        const onAbort = () => controller.abort();
+        if (options.signal?.aborted) {
+            controller.abort();
+        }
+        else {
+            options.signal?.addEventListener('abort', onAbort, { once: true });
+        }
+        let response;
+        try {
+            response = await fetchChunk(query, { ...options, signal: controller.signal });
+        }
+        catch (error) {
+            options.signal?.removeEventListener('abort', onAbort);
+            throw error;
+        }
+        let bodyTimedOut = false;
+        const timer = setTimeout(() => {
+            bodyTimedOut = true;
+            controller.abort();
+        }, timeout);
+        try {
+            const body = new Uint8Array(await response.arrayBuffer());
+            clearTimeout(timer);
+            if (options.signal?.aborted) {
+                throw new APIUserAbortError();
+            }
+            if (bodyTimedOut) {
+                throw new APIConnectionTimeoutError();
+            }
+            const expected = response.headers.get('x-content-sha256');
+            if (!expected) {
+                throw new AuditLogDownloadError('response missing X-Content-Sha256 header');
+            }
+            const actual = await sha256Hex(body);
+            if (options.signal?.aborted) {
+                throw new APIUserAbortError();
+            }
+            if (actual !== expected) {
+                throw new AuditLogDownloadError(`audit log chunk checksum mismatch (got ${actual}, want ${expected})`);
+            }
+            return { body, headers: response.headers };
+        }
+        catch (error) {
+            if (options.signal?.aborted && !(error instanceof APIUserAbortError)) {
+                error = new APIUserAbortError();
+            }
+            else if (bodyTimedOut) {
+                error = new APIConnectionTimeoutError();
+            }
+            if (retries === maxTransferRetries || error instanceof APIUserAbortError) {
+                throw error;
+            }
+            await retryDelay(retries + 1, options.signal);
+        }
+        finally {
+            clearTimeout(timer);
+            options.signal?.removeEventListener('abort', onAbort);
+        }
+    }
+}
+function parseChunkHeaders(headers, currentCursor) {
+    const hasMoreValue = headers.get('x-has-more');
+    if (hasMoreValue !== 'true' && hasMoreValue !== 'false') {
+        throw new AuditLogDownloadError('response missing or invalid X-Has-More header');
+    }
+    const hasMore = hasMoreValue === 'true';
+    const rowCount = headers.get('x-row-count');
+    if (rowCount === null || !/^[0-9]+$/.test(rowCount)) {
+        throw new AuditLogDownloadError('response missing or invalid X-Row-Count header');
+    }
+    const rows = Number(rowCount);
+    if (!Number.isSafeInteger(rows) || rows > MAX_CHUNK_ROWS) {
+        throw new AuditLogDownloadError('response missing or invalid X-Row-Count header');
+    }
+    const nextCursor = headers.get('x-next-cursor') || undefined;
+    if (hasMore && (!nextCursor || nextCursor === currentCursor)) {
+        throw new AuditLogDownloadError('response has invalid X-Next-Cursor header');
+    }
+    if (!hasMore && nextCursor) {
+        throw new AuditLogDownloadError('response returned a cursor after the final chunk');
+    }
+    return { rows, nextCursor, hasMore };
+}
+async function sha256Hex(body) {
+    const digest = await globalThis.crypto.subtle.digest('SHA-256', body);
+    return Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, '0')).join('');
+}
+async function retryDelay(attempt, signal) {
+    const delay = Math.min(1000 * 2 ** (attempt - 1), MAX_RETRY_DELAY_MS);
+    await new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new APIUserAbortError());
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new APIUserAbortError());
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, delay);
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+async function writeChunk(destination, body) {
+    let offset = 0;
+    while (offset < body.byteLength) {
+        const result = await destination.write(offset === 0 ? body : body.subarray(offset));
+        if (typeof result === 'number') {
+            offset += validateWriteCount(result, body.byteLength - offset);
+            continue;
+        }
+        if (result && typeof result === 'object' && 'bytesWritten' in result) {
+            const bytesWritten = result.bytesWritten;
+            offset += validateWriteCount(bytesWritten, body.byteLength - offset);
+            continue;
+        }
+        return;
+    }
+}
+function validateWriteCount(value, remaining) {
+    if (!Number.isSafeInteger(value) || value <= 0 || value > remaining) {
+        throw new AuditLogDownloadError('audit log download destination performed a short write');
+    }
+    return value;
+}
+//# sourceMappingURL=audit-log-download.mjs.map

package/lib/audit-log-download.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log-download.mjs","sourceRoot":"","sources":["../src/lib/audit-log-download.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,WAAW,EAAE,0BAAsB;AAI1F,MAAM,4BAA4B,GAAG,CAAC,CAAC;AACvC,MAAM,cAAc,GAAG,KAAM,CAAC;AAC9B,MAAM,kBAAkB,GAAG,IAAK,CAAC;AAEjC,MAAM,OAAO,qBAAsB,SAAQ,WAAW;CAAG;AA+BzD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAsB,EACtB,KAA6B,EAC7B,WAAwC,EACxC,cAAsB,EACtB,UAAmC,EAAE;IAErC,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAC5D,MAAM,IAAI,SAAS,CAAC,qDAAqD,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,4BAA4B,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC;IACrG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,kBAAkB,CAAC,IAAI,kBAAkB,GAAG,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,SAAS,CAAC,mDAAmD,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,IAAI,cAAc,CAAC;IACzD,IAAI,MAA0B,CAAC;IAC/B,MAAM,MAAM,GAA2B,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/E,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IAEtC,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,KAAK,GAAG,MAAM,kBAAkB,CACpC,UAAU,EACV,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,EACrC,cAAc,EACd,kBAAkB,EAClB,OAAO,CACR,CAAC;QACF,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC/E,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;YAC1B,IAAI,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,qBAAqB,CAAC,wCAAwC,CAAC,CAAC;YAC5E,CAAC;YACD,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC9B,CAAC;QACD,MAAM,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE1C,MAAM,GAAG,UAAU,CAAC;QACpB,MAAM,CAAC,YAAY,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;QAC7C,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QACnB,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;QACpB,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,UAAU,CAAC,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,UAAsB,EACtB,KAAgC,EAChC,OAAuB,EACvB,kBAA0B,EAC1B,OAAe;IAEf,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YAC5B,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QAChF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACtD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,YAAY,GAAG,IAAI,CAAC;YACpB,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC,EAAE,OAAO,CAAC,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;YAC1D,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBAC5B,MAAM,IAAI,iBAAiB,EAAE,CAAC;YAChC,CAAC;YACD,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,IAAI,yBAAyB,EAAE,CAAC;YACxC,CAAC;YACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YAC1D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,qBAAqB,CAAC,0CAA0C,CAAC,CAAC;YAC9E,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBAC5B,MAAM,IAAI,iBAAiB,EAAE,CAAC;YAChC,CAAC;YACD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACxB,MAAM,IAAI,qBAAqB,CAC7B,0CAA0C,MAAM,UAAU,QAAQ,GAAG,CACtE,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,CAAC,KAAK,YAAY,iBAAiB,CAAC,EAAE,CAAC;gBACrE,KAAK,GAAG,IAAI,iBAAiB,EAAE,CAAC;YAClC,CAAC;iBAAM,IAAI,YAAY,EAAE,CAAC;gBACxB,KAAK,GAAG,IAAI,yBAAyB,EAAE,CAAC;YAC1C,CAAC;YACD,IAAI,OAAO,KAAK,kBAAkB,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;gBACzE,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,UAAU,CAAC,OAAO,GAAG,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAChD,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,OAAgB,EAChB,aAAiC;IAEjC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC/C,IAAI,YAAY,KAAK,MAAM,IAAI,YAAY,KAAK,OAAO,EAAE,CAAC;QACxD,MAAM,IAAI,qBAAqB,CAAC,+CAA+C,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,OAAO,GAAG,YAAY,KAAK,MAAM,CAAC;IAExC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC5C,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,qBAAqB,CAAC,gDAAgD,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,cAAc,EAAE,CAAC;QACzD,MAAM,IAAI,qBAAqB,CAAC,gDAAgD,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,SAAS,CAAC;IAC7D,IAAI,OAAO,IAAI,CAAC,CAAC,UAAU,IAAI,UAAU,KAAK,aAAa,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,qBAAqB,CAAC,2CAA2C,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,CAAC,OAAO,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,IAAI,qBAAqB,CAAC,kDAAkD,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AACvC,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAgB;IACvC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACtE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnG,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,OAAe,EAAE,MAAsC;IAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAK,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;IACvE,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;YAChC,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;QAClC,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,KAAK,CAAC,CAAC;QACV,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,WAAwC,EAAE,IAAgB;IAClF,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACpF,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,MAAM,IAAI,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,CAAC;YAC/D,SAAS;QACX,CAAC;QACD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,cAAc,IAAI,MAAM,EAAE,CAAC;YACrE,MAAM,YAAY,GAAI,MAAmC,CAAC,YAAY,CAAC;YACvE,MAAM,IAAI,kBAAkB,CAAC,YAAY,EAAE,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,CAAC;YACrE,SAAS;QACX,CAAC;QACD,OAAO;IACT,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa,EAAE,SAAiB;IAC1D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;QACpE,MAAM,IAAI,qBAAqB,CAAC,wDAAwD,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onkernel/sdk",
-  "version": "0.80.0",
+  "version": "0.81.0",
   "description": "The official TypeScript library for the Kernel API",
   "author": "Kernel <>",
   "types": "./index.d.ts",

package/resources/audit-logs.d.mts

@@ -2,6 +2,8 @@ import { APIResource } from "../core/resource.mjs";
 import { APIPromise } from "../core/api-promise.mjs";
 import { PagePromise, PageTokenPagination, type PageTokenPaginationParams } from "../core/pagination.mjs";
 import { RequestOptions } from "../internal/request-options.mjs";
+import { type AuditLogDownloadDestination, type AuditLogDownloadOptions, type AuditLogDownloadParams, type AuditLogDownloadProgress, type AuditLogDownloadResult } from "../lib/audit-log-download.mjs";
+export type { AuditLogDownloadDestination, AuditLogDownloadOptions, AuditLogDownloadParams, AuditLogDownloadProgress, AuditLogDownloadResult, } from "../lib/audit-log-download.mjs";
 /**
  * Read audit log records for the authenticated organization.
  */
@@ -17,6 +19,14 @@ export declare class AuditLogs extends APIResource {
      * /audit-logs.
      */
     exportChunk(query: AuditLogExportChunkParams, options?: RequestOptions): APIPromise<Response>;
+    /**
+     * Download a complete gzip-compressed JSON Lines audit log export to a writable
+     * destination. The SDK verifies every chunk and retries transient transfer
+     * failures. It does not close the destination. If the download fails, the
+     * destination may contain a partial export; use a temporary file and atomic
+     * rename when the completed export must be published atomically.
+     */
+    download(query: AuditLogDownloadParams, destination: AuditLogDownloadDestination, options?: AuditLogDownloadOptions): Promise<AuditLogDownloadResult>;
 }
 export type AuditLogEntriesPageTokenPagination = PageTokenPagination<AuditLogEntry>;
 export interface AuditLogEntry {
@@ -150,6 +160,6 @@ export interface AuditLogExportChunkParams {
     service?: string;
 }
 export declare namespace AuditLogs {
-    export { type AuditLogEntry as AuditLogEntry, type AuditLogEntriesPageTokenPagination as AuditLogEntriesPageTokenPagination, type AuditLogListParams as AuditLogListParams, type AuditLogExportChunkParams as AuditLogExportChunkParams, };
+    export { type AuditLogEntry as AuditLogEntry, type AuditLogEntriesPageTokenPagination as AuditLogEntriesPageTokenPagination, type AuditLogListParams as AuditLogListParams, type AuditLogExportChunkParams as AuditLogExportChunkParams, type AuditLogDownloadDestination as AuditLogDownloadDestination, type AuditLogDownloadOptions as AuditLogDownloadOptions, type AuditLogDownloadParams as AuditLogDownloadParams, type AuditLogDownloadProgress as AuditLogDownloadProgress, type AuditLogDownloadResult as AuditLogDownloadResult, };
 }
 //# sourceMappingURL=audit-logs.d.mts.map

package/resources/audit-logs.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"audit-logs.d.mts","sourceRoot":"","sources":["../src/resources/audit-logs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"audit-logs.d.mts","sourceRoot":"","sources":["../src/resources/audit-logs.ts"],"names":[],"mappings":"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"}

package/resources/audit-logs.d.ts

@@ -2,6 +2,8 @@ import { APIResource } from "../core/resource.js";
 import { APIPromise } from "../core/api-promise.js";
 import { PagePromise, PageTokenPagination, type PageTokenPaginationParams } from "../core/pagination.js";
 import { RequestOptions } from "../internal/request-options.js";
+import { type AuditLogDownloadDestination, type AuditLogDownloadOptions, type AuditLogDownloadParams, type AuditLogDownloadProgress, type AuditLogDownloadResult } from "../lib/audit-log-download.js";
+export type { AuditLogDownloadDestination, AuditLogDownloadOptions, AuditLogDownloadParams, AuditLogDownloadProgress, AuditLogDownloadResult, } from "../lib/audit-log-download.js";
 /**
  * Read audit log records for the authenticated organization.
  */
@@ -17,6 +19,14 @@ export declare class AuditLogs extends APIResource {
      * /audit-logs.
      */
     exportChunk(query: AuditLogExportChunkParams, options?: RequestOptions): APIPromise<Response>;
+    /**
+     * Download a complete gzip-compressed JSON Lines audit log export to a writable
+     * destination. The SDK verifies every chunk and retries transient transfer
+     * failures. It does not close the destination. If the download fails, the
+     * destination may contain a partial export; use a temporary file and atomic
+     * rename when the completed export must be published atomically.
+     */
+    download(query: AuditLogDownloadParams, destination: AuditLogDownloadDestination, options?: AuditLogDownloadOptions): Promise<AuditLogDownloadResult>;
 }
 export type AuditLogEntriesPageTokenPagination = PageTokenPagination<AuditLogEntry>;
 export interface AuditLogEntry {
@@ -150,6 +160,6 @@ export interface AuditLogExportChunkParams {
     service?: string;
 }
 export declare namespace AuditLogs {
-    export { type AuditLogEntry as AuditLogEntry, type AuditLogEntriesPageTokenPagination as AuditLogEntriesPageTokenPagination, type AuditLogListParams as AuditLogListParams, type AuditLogExportChunkParams as AuditLogExportChunkParams, };
+    export { type AuditLogEntry as AuditLogEntry, type AuditLogEntriesPageTokenPagination as AuditLogEntriesPageTokenPagination, type AuditLogListParams as AuditLogListParams, type AuditLogExportChunkParams as AuditLogExportChunkParams, type AuditLogDownloadDestination as AuditLogDownloadDestination, type AuditLogDownloadOptions as AuditLogDownloadOptions, type AuditLogDownloadParams as AuditLogDownloadParams, type AuditLogDownloadProgress as AuditLogDownloadProgress, type AuditLogDownloadResult as AuditLogDownloadResult, };
 }
 //# sourceMappingURL=audit-logs.d.ts.map

package/resources/audit-logs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit-logs.d.ts","sourceRoot":"","sources":["../src/resources/audit-logs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,+BAA4B;AACjD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,KAAK,yBAAyB,EAAE,8BAA2B;AAEtG,OAAO,EAAE,cAAc,EAAE,uCAAoC;AAE7D;;GAEG;AACH,qBAAa,SAAU,SAAQ,WAAW;IACxC;;;OAGG;IACH,IAAI,CACF,KAAK,EAAE,kBAAkB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,kCAAkC,EAAE,aAAa,CAAC;IAIjE;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,yBAAyB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC;CAQ9F;AAED,MAAM,MAAM,kCAAkC,GAAG,mBAAmB,CAAC,aAAa,CAAC,CAAC;AAEpF,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAmB,SAAQ,yBAAyB;IACnE;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE/B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE/B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE/B;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAE9B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE/B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,OAAO,EACL,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,kCAAkC,IAAI,kCAAkC,EAC7E,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,yBAAyB,IAAI,yBAAyB,GAC5D,CAAC;CACH"}
+{"version":3,"file":"audit-logs.d.ts","sourceRoot":"","sources":["../src/resources/audit-logs.ts"],"names":[],"mappings":"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"}

package/resources/audit-logs.js

@@ -5,6 +5,7 @@ exports.AuditLogs = void 0;
 const resource_1 = require("../core/resource.js");
 const pagination_1 = require("../core/pagination.js");
 const headers_1 = require("../internal/headers.js");
+const audit_log_download_1 = require("../lib/audit-log-download.js");
 /**
  * Read audit log records for the authenticated organization.
  */
@@ -29,6 +30,16 @@ class AuditLogs extends resource_1.APIResource {
             __binaryResponse: true,
         });
     }
+    /**
+     * Download a complete gzip-compressed JSON Lines audit log export to a writable
+     * destination. The SDK verifies every chunk and retries transient transfer
+     * failures. It does not close the destination. If the download fails, the
+     * destination may contain a partial export; use a temporary file and atomic
+     * rename when the completed export must be published atomically.
+     */
+    download(query, destination, options) {
+        return (0, audit_log_download_1.downloadAuditLogs)((chunkQuery, chunkOptions) => this.exportChunk(chunkQuery, chunkOptions), query, destination, this._client.timeout, options);
+    }
 }
 exports.AuditLogs = AuditLogs;
 //# sourceMappingURL=audit-logs.js.map

package/resources/audit-logs.js.map

@@ -1 +1 @@
-{"version":3,"file":"audit-logs.js","sourceRoot":"","sources":["../src/resources/audit-logs.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAE/C,sDAAsG;AACtG,oDAAmD;AAGnD;;GAEG;AACH,MAAa,SAAU,SAAQ,sBAAW;IACxC;;;OAGG;IACH,IAAI,CACF,KAAyB,EACzB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAA,gCAAkC,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3G,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,KAAgC,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE;YAClD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,0BAA0B,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACjF,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;CACF;AAzBD,8BAyBC"}
+{"version":3,"file":"audit-logs.js","sourceRoot":"","sources":["../src/resources/audit-logs.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAE/C,sDAAsG;AACtG,oDAAmD;AAEnD,qEAOmC;AAUnC;;GAEG;AACH,MAAa,SAAU,SAAQ,sBAAW;IACxC;;;OAGG;IACH,IAAI,CACF,KAAyB,EACzB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAA,gCAAkC,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3G,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,KAAgC,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE;YAClD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,0BAA0B,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACjF,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CACN,KAA6B,EAC7B,WAAwC,EACxC,OAAiC;QAEjC,OAAO,IAAA,sCAAiB,EACtB,CAAC,UAAU,EAAE,YAAY,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,YAAY,CAAC,EACxE,KAAK,EACL,WAAW,EACX,IAAI,CAAC,OAAO,CAAC,OAAO,EACpB,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AA9CD,8BA8CC"}

package/resources/audit-logs.mjs

@@ -2,6 +2,7 @@
 import { APIResource } from "../core/resource.mjs";
 import { PageTokenPagination } from "../core/pagination.mjs";
 import { buildHeaders } from "../internal/headers.mjs";
+import { downloadAuditLogs, } from "../lib/audit-log-download.mjs";
 /**
  * Read audit log records for the authenticated organization.
  */
@@ -26,5 +27,15 @@ export class AuditLogs extends APIResource {
             __binaryResponse: true,
         });
     }
+    /**
+     * Download a complete gzip-compressed JSON Lines audit log export to a writable
+     * destination. The SDK verifies every chunk and retries transient transfer
+     * failures. It does not close the destination. If the download fails, the
+     * destination may contain a partial export; use a temporary file and atomic
+     * rename when the completed export must be published atomically.
+     */
+    download(query, destination, options) {
+        return downloadAuditLogs((chunkQuery, chunkOptions) => this.exportChunk(chunkQuery, chunkOptions), query, destination, this._client.timeout, options);
+    }
 }
 //# sourceMappingURL=audit-logs.mjs.map

package/resources/audit-logs.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"audit-logs.mjs","sourceRoot":"","sources":["../src/resources/audit-logs.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAE/C,OAAO,EAAe,mBAAmB,EAAkC,+BAA2B;AACtG,OAAO,EAAE,YAAY,EAAE,gCAA4B;AAGnD;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,WAAW;IACxC;;;OAGG;IACH,IAAI,CACF,KAAyB,EACzB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAA,mBAAkC,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3G,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,KAAgC,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE;YAClD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,0BAA0B,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACjF,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"audit-logs.mjs","sourceRoot":"","sources":["../src/resources/audit-logs.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAE/C,OAAO,EAAe,mBAAmB,EAAkC,+BAA2B;AACtG,OAAO,EAAE,YAAY,EAAE,gCAA4B;AAEnD,OAAO,EACL,iBAAiB,GAMlB,sCAAkC;AAUnC;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,WAAW;IACxC;;;OAGG;IACH,IAAI,CACF,KAAyB,EACzB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAA,mBAAkC,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3G,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,KAAgC,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE;YAClD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,0BAA0B,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACjF,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CACN,KAA6B,EAC7B,WAAwC,EACxC,OAAiC;QAEjC,OAAO,iBAAiB,CACtB,CAAC,UAAU,EAAE,YAAY,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,YAAY,CAAC,EACxE,KAAK,EACL,WAAW,EACX,IAAI,CAAC,OAAO,CAAC,OAAO,EACpB,OAAO,CACR,CAAC;IACJ,CAAC;CACF"}

package/src/index.ts

@@ -6,6 +6,15 @@ export { type Uploadable, toFile } from './core/uploads';
 export { APIPromise } from './core/api-promise';
 export { Kernel, type ClientOptions } from './client';
 export { type BrowserFetchInit } from './lib/browser-fetch';
+export {
+  AuditLogDownloadError,
+  type AuditLogDownloadDestination,
+  type AuditLogDownloadOptions,
+  type AuditLogDownloadParams,
+  type AuditLogDownloadProgress,
+  type AuditLogDownloadResult,
+  type AuditLogDownloadWriteResult,
+} from './lib/audit-log-download';
 export { BrowserRouteCache, type BrowserRoute } from './lib/browser-routing';
 export { PagePromise } from './core/pagination';
 export {

package/src/lib/audit-log-download.ts

@@ -0,0 +1,234 @@
+import { APIConnectionTimeoutError, APIUserAbortError, KernelError } from '../core/error';
+import type { RequestOptions } from '../internal/request-options';
+import type { AuditLogExportChunkParams } from '../resources/audit-logs';
+
+const DEFAULT_MAX_TRANSFER_RETRIES = 6;
+const MAX_CHUNK_ROWS = 50_000;
+const MAX_RETRY_DELAY_MS = 8_000;
+
+export class AuditLogDownloadError extends KernelError {}
+
+export type AuditLogDownloadParams = Omit<AuditLogExportChunkParams, 'cursor' | 'format'>;
+
+export interface AuditLogDownloadResult {
+  bytesWritten: number;
+  chunks: number;
+  rows: number;
+}
+
+export interface AuditLogDownloadProgress extends AuditLogDownloadResult {
+  chunkRows: number;
+}
+
+export type AuditLogDownloadWriteResult = void | number | { bytesWritten: number };
+
+export interface AuditLogDownloadDestination {
+  write(chunk: Uint8Array): AuditLogDownloadWriteResult | Promise<AuditLogDownloadWriteResult>;
+}
+
+export interface AuditLogDownloadOptions
+  extends Omit<
+    RequestOptions,
+    'method' | 'path' | 'query' | 'body' | 'stream' | '__binaryResponse' | '__streamClass'
+  > {
+  onProgress?(progress: AuditLogDownloadProgress): void | Promise<void>;
+  maxTransferRetries?: number;
+}
+
+type FetchChunk = (query: AuditLogExportChunkParams, options?: RequestOptions) => Promise<Response>;
+
+export async function downloadAuditLogs(
+  fetchChunk: FetchChunk,
+  query: AuditLogDownloadParams,
+  destination: AuditLogDownloadDestination,
+  defaultTimeout: number,
+  options: AuditLogDownloadOptions = {},
+): Promise<AuditLogDownloadResult> {
+  if (!destination || typeof destination.write !== 'function') {
+    throw new TypeError('audit log download destination must provide write()');
+  }
+
+  const { onProgress, maxTransferRetries = DEFAULT_MAX_TRANSFER_RETRIES, ...requestOptions } = options;
+  if (!Number.isInteger(maxTransferRetries) || maxTransferRetries < 0) {
+    throw new TypeError('maxTransferRetries must be a non-negative integer');
+  }
+  const timeout = requestOptions.timeout ?? defaultTimeout;
+  let cursor: string | undefined;
+  const result: AuditLogDownloadResult = { bytesWritten: 0, chunks: 0, rows: 0 };
+  const seenCursors = new Set<string>();
+
+  while (true) {
+    const chunk = await fetchVerifiedChunk(
+      fetchChunk,
+      cursor ? { ...query, cursor } : query,
+      requestOptions,
+      maxTransferRetries,
+      timeout,
+    );
+    const { nextCursor, hasMore, rows } = parseChunkHeaders(chunk.headers, cursor);
+    if (hasMore && nextCursor) {
+      if (seenCursors.has(nextCursor)) {
+        throw new AuditLogDownloadError('response repeated X-Next-Cursor header');
+      }
+      seenCursors.add(nextCursor);
+    }
+    await writeChunk(destination, chunk.body);
+
+    cursor = nextCursor;
+    result.bytesWritten += chunk.body.byteLength;
+    result.chunks += 1;
+    result.rows += rows;
+    if (onProgress) {
+      await onProgress({ ...result, chunkRows: rows });
+    }
+    if (!hasMore) {
+      return result;
+    }
+  }
+}
+
+async function fetchVerifiedChunk(
+  fetchChunk: FetchChunk,
+  query: AuditLogExportChunkParams,
+  options: RequestOptions,
+  maxTransferRetries: number,
+  timeout: number,
+): Promise<{ body: Uint8Array; headers: Headers }> {
+  for (let retries = 0; ; retries += 1) {
+    const controller = new AbortController();
+    const onAbort = () => controller.abort();
+    if (options.signal?.aborted) {
+      controller.abort();
+    } else {
+      options.signal?.addEventListener('abort', onAbort, { once: true });
+    }
+
+    let response: Response;
+    try {
+      response = await fetchChunk(query, { ...options, signal: controller.signal });
+    } catch (error) {
+      options.signal?.removeEventListener('abort', onAbort);
+      throw error;
+    }
+
+    let bodyTimedOut = false;
+    const timer = setTimeout(() => {
+      bodyTimedOut = true;
+      controller.abort();
+    }, timeout);
+    try {
+      const body = new Uint8Array(await response.arrayBuffer());
+      clearTimeout(timer);
+      if (options.signal?.aborted) {
+        throw new APIUserAbortError();
+      }
+      if (bodyTimedOut) {
+        throw new APIConnectionTimeoutError();
+      }
+      const expected = response.headers.get('x-content-sha256');
+      if (!expected) {
+        throw new AuditLogDownloadError('response missing X-Content-Sha256 header');
+      }
+      const actual = await sha256Hex(body);
+      if (options.signal?.aborted) {
+        throw new APIUserAbortError();
+      }
+      if (actual !== expected) {
+        throw new AuditLogDownloadError(
+          `audit log chunk checksum mismatch (got ${actual}, want ${expected})`,
+        );
+      }
+      return { body, headers: response.headers };
+    } catch (error) {
+      if (options.signal?.aborted && !(error instanceof APIUserAbortError)) {
+        error = new APIUserAbortError();
+      } else if (bodyTimedOut) {
+        error = new APIConnectionTimeoutError();
+      }
+      if (retries === maxTransferRetries || error instanceof APIUserAbortError) {
+        throw error;
+      }
+      await retryDelay(retries + 1, options.signal);
+    } finally {
+      clearTimeout(timer);
+      options.signal?.removeEventListener('abort', onAbort);
+    }
+  }
+}
+
+function parseChunkHeaders(
+  headers: Headers,
+  currentCursor: string | undefined,
+): { rows: number; nextCursor: string | undefined; hasMore: boolean } {
+  const hasMoreValue = headers.get('x-has-more');
+  if (hasMoreValue !== 'true' && hasMoreValue !== 'false') {
+    throw new AuditLogDownloadError('response missing or invalid X-Has-More header');
+  }
+  const hasMore = hasMoreValue === 'true';
+
+  const rowCount = headers.get('x-row-count');
+  if (rowCount === null || !/^[0-9]+$/.test(rowCount)) {
+    throw new AuditLogDownloadError('response missing or invalid X-Row-Count header');
+  }
+  const rows = Number(rowCount);
+  if (!Number.isSafeInteger(rows) || rows > MAX_CHUNK_ROWS) {
+    throw new AuditLogDownloadError('response missing or invalid X-Row-Count header');
+  }
+
+  const nextCursor = headers.get('x-next-cursor') || undefined;
+  if (hasMore && (!nextCursor || nextCursor === currentCursor)) {
+    throw new AuditLogDownloadError('response has invalid X-Next-Cursor header');
+  }
+  if (!hasMore && nextCursor) {
+    throw new AuditLogDownloadError('response returned a cursor after the final chunk');
+  }
+  return { rows, nextCursor, hasMore };
+}
+
+async function sha256Hex(body: Uint8Array): Promise<string> {
+  const digest = await globalThis.crypto.subtle.digest('SHA-256', body);
+  return Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, '0')).join('');
+}
+
+async function retryDelay(attempt: number, signal: AbortSignal | null | undefined): Promise<void> {
+  const delay = Math.min(1_000 * 2 ** (attempt - 1), MAX_RETRY_DELAY_MS);
+  await new Promise<void>((resolve, reject) => {
+    if (signal?.aborted) {
+      reject(new APIUserAbortError());
+      return;
+    }
+    const onAbort = () => {
+      clearTimeout(timer);
+      reject(new APIUserAbortError());
+    };
+    const timer = setTimeout(() => {
+      signal?.removeEventListener('abort', onAbort);
+      resolve();
+    }, delay);
+    signal?.addEventListener('abort', onAbort, { once: true });
+  });
+}
+
+async function writeChunk(destination: AuditLogDownloadDestination, body: Uint8Array): Promise<void> {
+  let offset = 0;
+  while (offset < body.byteLength) {
+    const result = await destination.write(offset === 0 ? body : body.subarray(offset));
+    if (typeof result === 'number') {
+      offset += validateWriteCount(result, body.byteLength - offset);
+      continue;
+    }
+    if (result && typeof result === 'object' && 'bytesWritten' in result) {
+      const bytesWritten = (result as { bytesWritten: number }).bytesWritten;
+      offset += validateWriteCount(bytesWritten, body.byteLength - offset);
+      continue;
+    }
+    return;
+  }
+}
+
+function validateWriteCount(value: number, remaining: number): number {
+  if (!Number.isSafeInteger(value) || value <= 0 || value > remaining) {
+    throw new AuditLogDownloadError('audit log download destination performed a short write');
+  }
+  return value;
+}

package/src/resources/audit-logs.ts

@@ -5,6 +5,22 @@ import { APIPromise } from '../core/api-promise';
 import { PagePromise, PageTokenPagination, type PageTokenPaginationParams } from '../core/pagination';
 import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
+import {
+  downloadAuditLogs,
+  type AuditLogDownloadDestination,
+  type AuditLogDownloadOptions,
+  type AuditLogDownloadParams,
+  type AuditLogDownloadProgress,
+  type AuditLogDownloadResult,
+} from '../lib/audit-log-download';
+
+export type {
+  AuditLogDownloadDestination,
+  AuditLogDownloadOptions,
+  AuditLogDownloadParams,
+  AuditLogDownloadProgress,
+  AuditLogDownloadResult,
+} from '../lib/audit-log-download';
 
 /**
  * Read audit log records for the authenticated organization.
@@ -34,6 +50,27 @@ export class AuditLogs extends APIResource {
       __binaryResponse: true,
     });
   }
+
+  /**
+   * Download a complete gzip-compressed JSON Lines audit log export to a writable
+   * destination. The SDK verifies every chunk and retries transient transfer
+   * failures. It does not close the destination. If the download fails, the
+   * destination may contain a partial export; use a temporary file and atomic
+   * rename when the completed export must be published atomically.
+   */
+  download(
+    query: AuditLogDownloadParams,
+    destination: AuditLogDownloadDestination,
+    options?: AuditLogDownloadOptions,
+  ): Promise<AuditLogDownloadResult> {
+    return downloadAuditLogs(
+      (chunkQuery, chunkOptions) => this.exportChunk(chunkQuery, chunkOptions),
+      query,
+      destination,
+      this._client.timeout,
+      options,
+    );
+  }
 }
 
 export type AuditLogEntriesPageTokenPagination = PageTokenPagination<AuditLogEntry>;
@@ -205,5 +242,10 @@ export declare namespace AuditLogs {
     type AuditLogEntriesPageTokenPagination as AuditLogEntriesPageTokenPagination,
     type AuditLogListParams as AuditLogListParams,
     type AuditLogExportChunkParams as AuditLogExportChunkParams,
+    type AuditLogDownloadDestination as AuditLogDownloadDestination,
+    type AuditLogDownloadOptions as AuditLogDownloadOptions,
+    type AuditLogDownloadParams as AuditLogDownloadParams,
+    type AuditLogDownloadProgress as AuditLogDownloadProgress,
+    type AuditLogDownloadResult as AuditLogDownloadResult,
   };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.80.0'; // x-release-please-version
+export const VERSION = '0.81.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.80.0";
+export declare const VERSION = "0.81.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.80.0";
+export declare const VERSION = "0.81.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.80.0'; // x-release-please-version
+exports.VERSION = '0.81.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.80.0'; // x-release-please-version
+export const VERSION = '0.81.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map