disk 0.8.19 → 0.8.20

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { c as listDisks, i as deleteApiKey, n as createApiKey, o as getDisk, r as createDisk, s as listApiKeys, t as configure, y as ArchilApiError } from "./src--b7LHPh_.mjs";
+import { c as listDisks, i as deleteApiKey, n as createApiKey, o as getDisk, r as createDisk, s as listApiKeys, t as configure, y as ArchilApiError } from "./src-BuqSzAcO.mjs";
 import { createRequire } from "node:module";
 import { Command, Option } from "commander";
 //#region bin/cli.ts

package/dist/index.cjs

@@ -134,7 +134,7 @@ function deriveS3BaseUrl(controlBaseUrl) {
 }
 //#endregion
 //#region src/version.ts
-const VERSION = "0.8.19";
+const VERSION = "0.8.20";
 const USER_AGENT = `archil-js/${VERSION}`;
 //#endregion
 //#region src/client.ts
@@ -153,10 +153,21 @@ function createApiClient(opts) {
 * Unwrap the API envelope: return data on success, throw ArchilApiError on failure.
 */
 async function unwrap(promise) {
+	return (await unwrapPage(promise)).data;
+}
+/**
+* Unwrap a paginated list envelope: like {@link unwrap}, but also surface the
+* envelope's `nextCursor` (undefined on the last page or from a server that
+* doesn't paginate).
+*/
+async function unwrapPage(promise) {
 	const { data: body, error, response } = await promise;
 	if (error || !body) throw new ArchilApiError(error?.error ?? `API request failed with status ${response.status}`, response.status);
 	if (!body.success) throw new ArchilApiError(body.error ?? "Unknown API error", response.status);
-	return body.data;
+	return {
+		data: body.data,
+		nextCursor: body.nextCursor
+	};
 }
 /**
 * Unwrap an API response that has no data payload (e.g., delete operations).
@@ -995,6 +1006,8 @@ function parseListMultipartUploadsResult(xml) {
 }
 //#endregion
 //#region src/disks.ts
+/** Server-side maximum page size for GET /api/disks. */
+const DISK_PAGE_LIMIT = 100;
 var Disks = class {
 	/** @internal */
 	_client;
@@ -1008,12 +1021,45 @@ var Disks = class {
 		this._region = region;
 		this._s3BaseUrl = s3BaseUrl;
 	}
+	/**
+	* List the account's disks. Fetches in cursor-driven pages (bounded server
+	* work per request) and follows `nextCursor` until exhausted, so the result
+	* is complete even for very large accounts. Use `limit` to cap the total, or
+	* {@link listPage} to walk pages yourself.
+	*/
 	async list(opts) {
-		return (await unwrap(this._client.GET("/api/disks", { params: { query: {
+		if (opts?.name !== void 0) return (await this.listPage(opts)).disks;
+		const limit = opts?.limit;
+		let cursor = opts?.cursor;
+		const disks = [];
+		for (;;) {
+			const remaining = limit === void 0 ? void 0 : limit - disks.length;
+			if (remaining !== void 0 && remaining <= 0) return disks;
+			const pageLimit = remaining === void 0 ? DISK_PAGE_LIMIT : Math.min(remaining, DISK_PAGE_LIMIT);
+			const page = await this.listPage({
+				limit: pageLimit,
+				cursor
+			});
+			disks.push(...remaining === void 0 ? page.disks : page.disks.slice(0, remaining));
+			if (!page.nextCursor || page.nextCursor === cursor) return disks;
+			cursor = page.nextCursor;
+		}
+	}
+	/**
+	* Fetch a single page of disks. `nextCursor` on the result resumes the
+	* listing (it can also be persisted, e.g. across requests of a paginated UI).
+	*/
+	async listPage(opts) {
+		const { data, nextCursor } = await unwrapPage(this._client.GET("/api/disks", { params: { query: {
 			limit: opts?.limit,
 			cursor: opts?.cursor,
 			name: opts?.name
-		} } }))).map((d) => new Disk(d, this._client, this._region, this._s3BaseUrl));
+		} } }));
+		const disks = (data ?? []).map((d) => new Disk(d, this._client, this._region, this._s3BaseUrl));
+		return nextCursor ? {
+			disks,
+			nextCursor
+		} : { disks };
 	}
 	async get(id) {
 		return new Disk(await unwrap(this._client.GET("/api/disks/{id}", { params: { path: { id } } })), this._client, this._region, this._s3BaseUrl);

package/dist/index.d.cts

@@ -2,10 +2,20 @@ import { A as AwsStsUser, B as ExecRequest, C as S3Object, D as effectiveUploadP
 
 //#region src/disks.d.ts
 interface ListDisksOptions {
+  /** Cap on the total number of disks returned. */
   limit?: number;
+  /** Resume listing from a previous page's `nextCursor`. */
   cursor?: string;
   name?: string;
 }
+interface DiskListPage {
+  disks: Disk[];
+  /**
+   * Set when more disks remain beyond this page; pass it back as `cursor` to
+   * fetch the next one. Undefined on the last page.
+   */
+  nextCursor?: string;
+}
 interface CreateDiskResult {
   disk: Disk;
   token: string | null;
@@ -21,7 +31,18 @@ declare class Disks {
   private readonly _s3BaseUrl?;
   /** @internal */
   constructor(client: ApiClient, region: string, s3BaseUrl?: string);
+  /**
+   * List the account's disks. Fetches in cursor-driven pages (bounded server
+   * work per request) and follows `nextCursor` until exhausted, so the result
+   * is complete even for very large accounts. Use `limit` to cap the total, or
+   * {@link listPage} to walk pages yourself.
+   */
   list(opts?: ListDisksOptions): Promise<Disk[]>;
+  /**
+   * Fetch a single page of disks. `nextCursor` on the result resumes the
+   * listing (it can also be persisted, e.g. across requests of a paginated UI).
+   */
+  listPage(opts?: ListDisksOptions): Promise<DiskListPage>;
   get(id: string): Promise<Disk>;
   /**
    * Create a new disk with an auto-generated mount token.
@@ -263,4 +284,4 @@ declare function exec(opts: ExecOptions): Promise<ExecDiskResult>;
  */
 declare function workspace(mounts: Record<string, ExecMount>): Workspace;
 //#endregion
-export { type ApiTokenResponse, Archil, ArchilApiError, ArchilError, type ArchilOptions, ArchilS3Error, type AuthorizedUser, type AwsStsUser, type AzureBlobMount, type CompletedMultipartUpload, type ConnectedClient, type CreateApiTokenRequest, type CreateDiskRequest, type CreateDiskResult, type DeleteObjectsError, type DeleteObjectsOptions, type DeleteObjectsResult, Disk, type DiskMetrics, DiskMultipart, type DiskResponse, type DiskStatus, type DiskUser, Disks, type ExecMount, type ExecMountSpec, type ExecOptions, type ExecRequest, type ExecResult, type FileSystem, type GCSMount, type GrepMatch, type GrepOptions, type GrepResult, type GrepStoppedReason, type ListDisksOptions, type ListMultipartUploadsOptions, type ListObjectsOptions, type ListObjectsResult, type ListPartsOptions, type ListTokensOptions, type MountConfig, type MountConfigResponse, type MountOptions, type MountResponse, type MultipartUpload, type MultipartUploadListing, type MultipartUploadSummary, type ObjectMetadata, type PartInfo, type PartListing, type PutObjectOptions, type PutObjectResult, type R2Mount, type S3CompatibleMount, type S3Mount, type S3Object, type ShareUrlOptions, type ShareUrlResult, type TokenUser, Tokens, USER_AGENT, type UploadPart, VERSION, Workspace, configure, createApiKey, createDisk, deleteApiKey, effectiveUploadPartSize, exec, getDisk, listApiKeys, listDisks, workspace };
+export { type ApiTokenResponse, Archil, ArchilApiError, ArchilError, type ArchilOptions, ArchilS3Error, type AuthorizedUser, type AwsStsUser, type AzureBlobMount, type CompletedMultipartUpload, type ConnectedClient, type CreateApiTokenRequest, type CreateDiskRequest, type CreateDiskResult, type DeleteObjectsError, type DeleteObjectsOptions, type DeleteObjectsResult, Disk, type DiskListPage, type DiskMetrics, DiskMultipart, type DiskResponse, type DiskStatus, type DiskUser, Disks, type ExecMount, type ExecMountSpec, type ExecOptions, type ExecRequest, type ExecResult, type FileSystem, type GCSMount, type GrepMatch, type GrepOptions, type GrepResult, type GrepStoppedReason, type ListDisksOptions, type ListMultipartUploadsOptions, type ListObjectsOptions, type ListObjectsResult, type ListPartsOptions, type ListTokensOptions, type MountConfig, type MountConfigResponse, type MountOptions, type MountResponse, type MultipartUpload, type MultipartUploadListing, type MultipartUploadSummary, type ObjectMetadata, type PartInfo, type PartListing, type PutObjectOptions, type PutObjectResult, type R2Mount, type S3CompatibleMount, type S3Mount, type S3Object, type ShareUrlOptions, type ShareUrlResult, type TokenUser, Tokens, USER_AGENT, type UploadPart, VERSION, Workspace, configure, createApiKey, createDisk, deleteApiKey, effectiveUploadPartSize, exec, getDisk, listApiKeys, listDisks, workspace };

package/dist/index.d.mts

@@ -2,10 +2,20 @@ import { A as AwsStsUser, B as ExecRequest, C as S3Object, D as effectiveUploadP
 
 //#region src/disks.d.ts
 interface ListDisksOptions {
+  /** Cap on the total number of disks returned. */
   limit?: number;
+  /** Resume listing from a previous page's `nextCursor`. */
   cursor?: string;
   name?: string;
 }
+interface DiskListPage {
+  disks: Disk[];
+  /**
+   * Set when more disks remain beyond this page; pass it back as `cursor` to
+   * fetch the next one. Undefined on the last page.
+   */
+  nextCursor?: string;
+}
 interface CreateDiskResult {
   disk: Disk;
   token: string | null;
@@ -21,7 +31,18 @@ declare class Disks {
   private readonly _s3BaseUrl?;
   /** @internal */
   constructor(client: ApiClient, region: string, s3BaseUrl?: string);
+  /**
+   * List the account's disks. Fetches in cursor-driven pages (bounded server
+   * work per request) and follows `nextCursor` until exhausted, so the result
+   * is complete even for very large accounts. Use `limit` to cap the total, or
+   * {@link listPage} to walk pages yourself.
+   */
   list(opts?: ListDisksOptions): Promise<Disk[]>;
+  /**
+   * Fetch a single page of disks. `nextCursor` on the result resumes the
+   * listing (it can also be persisted, e.g. across requests of a paginated UI).
+   */
+  listPage(opts?: ListDisksOptions): Promise<DiskListPage>;
   get(id: string): Promise<Disk>;
   /**
    * Create a new disk with an auto-generated mount token.
@@ -263,4 +284,4 @@ declare function exec(opts: ExecOptions): Promise<ExecDiskResult>;
  */
 declare function workspace(mounts: Record<string, ExecMount>): Workspace;
 //#endregion
-export { type ApiTokenResponse, Archil, ArchilApiError, ArchilError, type ArchilOptions, ArchilS3Error, type AuthorizedUser, type AwsStsUser, type AzureBlobMount, type CompletedMultipartUpload, type ConnectedClient, type CreateApiTokenRequest, type CreateDiskRequest, type CreateDiskResult, type DeleteObjectsError, type DeleteObjectsOptions, type DeleteObjectsResult, Disk, type DiskMetrics, DiskMultipart, type DiskResponse, type DiskStatus, type DiskUser, Disks, type ExecMount, type ExecMountSpec, type ExecOptions, type ExecRequest, type ExecResult, type FileSystem, type GCSMount, type GrepMatch, type GrepOptions, type GrepResult, type GrepStoppedReason, type ListDisksOptions, type ListMultipartUploadsOptions, type ListObjectsOptions, type ListObjectsResult, type ListPartsOptions, type ListTokensOptions, type MountConfig, type MountConfigResponse, type MountOptions, type MountResponse, type MultipartUpload, type MultipartUploadListing, type MultipartUploadSummary, type ObjectMetadata, type PartInfo, type PartListing, type PutObjectOptions, type PutObjectResult, type R2Mount, type S3CompatibleMount, type S3Mount, type S3Object, type ShareUrlOptions, type ShareUrlResult, type TokenUser, Tokens, USER_AGENT, type UploadPart, VERSION, Workspace, configure, createApiKey, createDisk, deleteApiKey, effectiveUploadPartSize, exec, getDisk, listApiKeys, listDisks, workspace };
+export { type ApiTokenResponse, Archil, ArchilApiError, ArchilError, type ArchilOptions, ArchilS3Error, type AuthorizedUser, type AwsStsUser, type AzureBlobMount, type CompletedMultipartUpload, type ConnectedClient, type CreateApiTokenRequest, type CreateDiskRequest, type CreateDiskResult, type DeleteObjectsError, type DeleteObjectsOptions, type DeleteObjectsResult, Disk, type DiskListPage, type DiskMetrics, DiskMultipart, type DiskResponse, type DiskStatus, type DiskUser, Disks, type ExecMount, type ExecMountSpec, type ExecOptions, type ExecRequest, type ExecResult, type FileSystem, type GCSMount, type GrepMatch, type GrepOptions, type GrepResult, type GrepStoppedReason, type ListDisksOptions, type ListMultipartUploadsOptions, type ListObjectsOptions, type ListObjectsResult, type ListPartsOptions, type ListTokensOptions, type MountConfig, type MountConfigResponse, type MountOptions, type MountResponse, type MultipartUpload, type MultipartUploadListing, type MultipartUploadSummary, type ObjectMetadata, type PartInfo, type PartListing, type PutObjectOptions, type PutObjectResult, type R2Mount, type S3CompatibleMount, type S3Mount, type S3Object, type ShareUrlOptions, type ShareUrlResult, type TokenUser, Tokens, USER_AGENT, type UploadPart, VERSION, Workspace, configure, createApiKey, createDisk, deleteApiKey, effectiveUploadPartSize, exec, getDisk, listApiKeys, listDisks, workspace };

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { _ as USER_AGENT, a as exec, b as ArchilError, c as listDisks, d as Workspace, f as Tokens, g as effectiveUploadPartSize, h as DiskMultipart, i as deleteApiKey, l as workspace, m as Disk, n as createApiKey, o as getDisk, p as Disks, r as createDisk, s as listApiKeys, t as configure, u as Archil, v as VERSION, x as ArchilS3Error, y as ArchilApiError } from "./src--b7LHPh_.mjs";
+import { _ as USER_AGENT, a as exec, b as ArchilError, c as listDisks, d as Workspace, f as Tokens, g as effectiveUploadPartSize, h as DiskMultipart, i as deleteApiKey, l as workspace, m as Disk, n as createApiKey, o as getDisk, p as Disks, r as createDisk, s as listApiKeys, t as configure, u as Archil, v as VERSION, x as ArchilS3Error, y as ArchilApiError } from "./src-BuqSzAcO.mjs";
 export { Archil, ArchilApiError, ArchilError, ArchilS3Error, Disk, DiskMultipart, Disks, Tokens, USER_AGENT, VERSION, Workspace, configure, createApiKey, createDisk, deleteApiKey, effectiveUploadPartSize, exec, getDisk, listApiKeys, listDisks, workspace };

package/dist/{src--b7LHPh_.mjs → src-BuqSzAcO.mjs}

@@ -111,7 +111,7 @@ function deriveS3BaseUrl(controlBaseUrl) {
 }
 //#endregion
 //#region src/version.ts
-const VERSION = "0.8.19";
+const VERSION = "0.8.20";
 const USER_AGENT = `archil-js/${VERSION}`;
 //#endregion
 //#region src/client.ts
@@ -130,10 +130,21 @@ function createApiClient(opts) {
 * Unwrap the API envelope: return data on success, throw ArchilApiError on failure.
 */
 async function unwrap(promise) {
+	return (await unwrapPage(promise)).data;
+}
+/**
+* Unwrap a paginated list envelope: like {@link unwrap}, but also surface the
+* envelope's `nextCursor` (undefined on the last page or from a server that
+* doesn't paginate).
+*/
+async function unwrapPage(promise) {
 	const { data: body, error, response } = await promise;
 	if (error || !body) throw new ArchilApiError(error?.error ?? `API request failed with status ${response.status}`, response.status);
 	if (!body.success) throw new ArchilApiError(body.error ?? "Unknown API error", response.status);
-	return body.data;
+	return {
+		data: body.data,
+		nextCursor: body.nextCursor
+	};
 }
 /**
 * Unwrap an API response that has no data payload (e.g., delete operations).
@@ -972,6 +983,8 @@ function parseListMultipartUploadsResult(xml) {
 }
 //#endregion
 //#region src/disks.ts
+/** Server-side maximum page size for GET /api/disks. */
+const DISK_PAGE_LIMIT = 100;
 var Disks = class {
 	/** @internal */
 	_client;
@@ -985,12 +998,45 @@ var Disks = class {
 		this._region = region;
 		this._s3BaseUrl = s3BaseUrl;
 	}
+	/**
+	* List the account's disks. Fetches in cursor-driven pages (bounded server
+	* work per request) and follows `nextCursor` until exhausted, so the result
+	* is complete even for very large accounts. Use `limit` to cap the total, or
+	* {@link listPage} to walk pages yourself.
+	*/
 	async list(opts) {
-		return (await unwrap(this._client.GET("/api/disks", { params: { query: {
+		if (opts?.name !== void 0) return (await this.listPage(opts)).disks;
+		const limit = opts?.limit;
+		let cursor = opts?.cursor;
+		const disks = [];
+		for (;;) {
+			const remaining = limit === void 0 ? void 0 : limit - disks.length;
+			if (remaining !== void 0 && remaining <= 0) return disks;
+			const pageLimit = remaining === void 0 ? DISK_PAGE_LIMIT : Math.min(remaining, DISK_PAGE_LIMIT);
+			const page = await this.listPage({
+				limit: pageLimit,
+				cursor
+			});
+			disks.push(...remaining === void 0 ? page.disks : page.disks.slice(0, remaining));
+			if (!page.nextCursor || page.nextCursor === cursor) return disks;
+			cursor = page.nextCursor;
+		}
+	}
+	/**
+	* Fetch a single page of disks. `nextCursor` on the result resumes the
+	* listing (it can also be persisted, e.g. across requests of a paginated UI).
+	*/
+	async listPage(opts) {
+		const { data, nextCursor } = await unwrapPage(this._client.GET("/api/disks", { params: { query: {
 			limit: opts?.limit,
 			cursor: opts?.cursor,
 			name: opts?.name
-		} } }))).map((d) => new Disk(d, this._client, this._region, this._s3BaseUrl));
+		} } }));
+		const disks = (data ?? []).map((d) => new Disk(d, this._client, this._region, this._s3BaseUrl));
+		return nextCursor ? {
+			disks,
+			nextCursor
+		} : { disks };
 	}
 	async get(id) {
 		return new Disk(await unwrap(this._client.GET("/api/disks/{id}", { params: { path: { id } } })), this._client, this._region, this._s3BaseUrl);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "disk",
-  "version": "0.8.19",
+  "version": "0.8.20",
   "description": "Pure-JS client and CLI for Archil disks",
   "type": "module",
   "main": "dist/index.cjs",
@@ -29,7 +29,7 @@
   "dependencies": {
     "@archildata/api-types": "^0.0.1",
     "commander": "^14.0.3",
-    "fast-xml-parser": "^4.5.1",
+    "fast-xml-parser": "^5.7.0",
     "openapi-fetch": "^0.13.5",
     "zod": "^4.4.3"
   },