@finueva/drive 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @finueva/drive
 
+## 0.8.0
+
+### Minor Changes
+
+- 8809e4e: Add getCurrentWorkspaceSources, listWorkspaceItems, and getWorkspaceUsage for authorized Files discovery. List recently modified items, actual incoming user/team grants, and trash with authenticated pagination, nullable genuine creation/modification/creator metadata, published version details, and retained mutation ETags. Read exact managed quota byte strings including unresolved reservations. Separate actual managed volumes from known provider kinds without fabricated connections or health. Existing SDK operations retain their contracts. The backend requires generated migration 0010 before these discovery routes are deployed.
+
 ## 0.7.0
 
 ### Minor Changes

package/README.md

@@ -78,13 +78,39 @@ const drive = createDriveServerClient({
 
 Create a client per request when using user authority. A fixed `credential` string is accepted for an explicitly scoped credential, but the SDK does not create, refresh, persist, or infer sessions, cookies, provider tokens, or service authority.
 
-The server client exposes all 24 Native Drive operations plus streaming `downloadItem`, but intentionally has no Blob-only `uploadFile` method. The package root and browser client add `uploadFile`, for 26 methods total.
+The server client exposes all 27 normal-user Native Drive operations plus streaming `downloadItem`, but intentionally has no Blob-only `uploadFile` method. The package root and browser client add `uploadFile`, for 29 methods total.
+
+## Workspace Discovery
+
+`getCurrentWorkspaceSources()` returns the actual managed volume separately from
+known provider kinds. It does not invent external connections or provider health.
+
+```ts
+const recent = await drive.listWorkspaceItems({ workspaceId, view: "recent", limit: 25 });
+const shared = await drive.listWorkspaceItems({ workspaceId, view: "shared" });
+const trash = await drive.listWorkspaceItems({ workspaceId, view: "trash" });
+const usage = await drive.getWorkspaceUsage({ workspaceId });
+```
+
+Recent means recorded modification time, not viewing activity. Historical unknown
+timestamps and creator user IDs stay null; unknown modification times are excluded
+from recent results until a real mutation. Shared lists actual incoming direct
+user/team grants, not inherited descendants or all workspace-visible items. Trash
+requires delete authority and retains current ETags for the existing mutation
+methods. Continuations are encrypted, principal/root/filter-bound and short-lived;
+restart on stale-page errors. Optional `kind` and `creatorUserId` filters apply on
+the service before pagination. Quota reads require `usage:read` and return exact
+decimal byte strings, clamped availability and unresolved-reservation evidence.
+These source additions require backend migration `0010`, deployment and SDK release.
 
 ## Operations
 
 Methods use the Native API operation IDs:
 
 - `getCurrentWorkspace`
+- `getCurrentWorkspaceSources`
+- `listWorkspaceItems`
+- `getWorkspaceUsage`
 - `getItem`
 - `searchWorkspaceItems`
 - `listFolderChildren`

package/dist/client.d.ts

@@ -1,5 +1,5 @@
-import { $ as TrashItemInput, A as ListItemVersionsInput, C as FolderPage, D as GetUploadStatusInput, E as GetItemVersionInput, F as ManagedItemVersionPage, G as ProtectionClassification, I as ManagedItemVersionResource, J as RecordUploadPartInput, L as ManagedItemVersionRestoreResult, M as ManagedDownloadRestorePending, N as ManagedItemMetadata, O as ListFolderChildrenInput, P as ManagedItemVersion, Q as SearchWorkspaceItemsInput, R as ManagedLifecycleItem, S as FolderItem, T as GetItemInput, X as RestoreItemVersionInput, Y as RestoreItemInput, at as UploadFilePhase, c as CurrentWorkspace, ct as UploadPartDescriptor, d as DriveClient, dt as UploadStatus, et as UpdateItemInput, f as DriveClientConfig, ft as WorkspaceItemSearchItem, it as UploadFileInput, j as ManagedDownloadDescriptor, l as DeleteItemInput, lt as UploadPartResult, m as DriveCredentialProvider, n as CompleteUploadInput, nt as UploadCompletion, o as CreateUploadInput, ot as UploadFileProgress, pt as WorkspaceItemSearchPage, q as ReadyUpload, r as CreateDownloadInput, rt as UploadConfirmedPart, s as CreateUploadPartDescriptorInput, st as UploadFileProgressCallback, t as AbortUploadInput, u as DownloadItemResult, ut as UploadSession, w as GetCurrentWorkspaceInput, z as PendingUpload } from "./contract.js";
+import { $ as RestoreItemVersionInput, A as ListFolderChildrenInput, B as ManagedItemVersionRestoreResult, C as FolderItem, D as GetItemVersionInput, E as GetItemInput, F as ManagedDownloadRestorePending, H as PendingUpload, I as ManagedItemMetadata, J as ProtectionClassification, L as ManagedItemVersion, M as ListItemVersionsInput, N as ListWorkspaceItemsInput, O as GetUploadStatusInput, P as ManagedDownloadDescriptor, Q as RestoreItemInput, R as ManagedItemVersionPage, T as GetCurrentWorkspaceInput, V as ManagedLifecycleItem, X as ReadyUpload, Z as RecordUploadPartInput, _t as WorkspaceItemSearchItem, at as UploadCompletion, c as CurrentWorkspace, ct as UploadFilePhase, d as DownloadItemResult, dt as UploadPartDescriptor, f as DriveClient, ft as UploadPartResult, gt as WorkspaceDiscoveryPage, h as DriveCredentialProvider, ht as WorkspaceDiscoveryItem, k as GetWorkspaceUsageInput, l as CurrentWorkspaceSources, lt as UploadFileProgress, mt as UploadStatus, n as CompleteUploadInput, nt as TrashItemInput, o as CreateUploadInput, ot as UploadConfirmedPart, p as DriveClientConfig, pt as UploadSession, r as CreateDownloadInput, rt as UpdateItemInput, s as CreateUploadPartDescriptorInput, st as UploadFileInput, t as AbortUploadInput, tt as SearchWorkspaceItemsInput, u as DeleteItemInput, ut as UploadFileProgressCallback, vt as WorkspaceItemSearchPage, w as FolderPage, yt as WorkspaceUsage, z as ManagedItemVersionResource } from "./contract.js";
 //#region src/client.d.ts
 declare function createDriveClient(config: DriveClientConfig): DriveClient;
 //#endregion
-export { type AbortUploadInput, type CompleteUploadInput, type CreateDownloadInput, type CreateUploadInput, type CreateUploadPartDescriptorInput, type CurrentWorkspace, type DeleteItemInput, type DownloadItemResult, type DriveClient, type DriveClientConfig, type DriveCredentialProvider, type FolderItem, type FolderPage, type GetCurrentWorkspaceInput, type GetItemInput, type GetItemVersionInput, type GetUploadStatusInput, type ListFolderChildrenInput, type ListItemVersionsInput, type ManagedDownloadDescriptor, type ManagedDownloadRestorePending, type ManagedItemMetadata, type ManagedItemVersion, type ManagedItemVersionPage, type ManagedItemVersionResource, type ManagedItemVersionRestoreResult, type ManagedLifecycleItem, type PendingUpload, type ProtectionClassification, type ReadyUpload, type RecordUploadPartInput, type RestoreItemInput, type RestoreItemVersionInput, type SearchWorkspaceItemsInput, type TrashItemInput, type UpdateItemInput, type UploadCompletion, type UploadConfirmedPart, type UploadFileInput, type UploadFilePhase, type UploadFileProgress, type UploadFileProgressCallback, type UploadPartDescriptor, type UploadPartResult, type UploadSession, type UploadStatus, type WorkspaceItemSearchItem, type WorkspaceItemSearchPage, createDriveClient };
+export { type AbortUploadInput, type CompleteUploadInput, type CreateDownloadInput, type CreateUploadInput, type CreateUploadPartDescriptorInput, type CurrentWorkspace, type CurrentWorkspaceSources, type DeleteItemInput, type DownloadItemResult, type DriveClient, type DriveClientConfig, type DriveCredentialProvider, type FolderItem, type FolderPage, type GetCurrentWorkspaceInput, type GetItemInput, type GetItemVersionInput, type GetUploadStatusInput, type GetWorkspaceUsageInput, type ListFolderChildrenInput, type ListItemVersionsInput, type ListWorkspaceItemsInput, type ManagedDownloadDescriptor, type ManagedDownloadRestorePending, type ManagedItemMetadata, type ManagedItemVersion, type ManagedItemVersionPage, type ManagedItemVersionResource, type ManagedItemVersionRestoreResult, type ManagedLifecycleItem, type PendingUpload, type ProtectionClassification, type ReadyUpload, type RecordUploadPartInput, type RestoreItemInput, type RestoreItemVersionInput, type SearchWorkspaceItemsInput, type TrashItemInput, type UpdateItemInput, type UploadCompletion, type UploadConfirmedPart, type UploadFileInput, type UploadFilePhase, type UploadFileProgress, type UploadFileProgressCallback, type UploadPartDescriptor, type UploadPartResult, type UploadSession, type UploadStatus, type WorkspaceDiscoveryItem, type WorkspaceDiscoveryPage, type WorkspaceItemSearchItem, type WorkspaceItemSearchPage, type WorkspaceUsage, createDriveClient };

package/dist/client.js

@@ -327,6 +327,101 @@ const MAX_UPLOAD_BYTE_LENGTH$1 = 33554432e4;
 const UPLOAD_PART_BYTE_LENGTH$2 = 32 * 1024 * 1024;
 const CONTENT_DIGEST$1 = /^sha256:[0-9a-f]{64}$/;
 const UTF8 = new TextEncoder();
+function isWorkspaceUsage(value) {
+	if (!isExactRecord(value, [
+		"workspaceId",
+		"provider",
+		"usedBytes",
+		"reservedBytes",
+		"limitBytes",
+		"availableBytes",
+		"accounting",
+		"reservedBytesIncludeUnresolvedUploads",
+		"unresolvedReservedBytes",
+		"warnings"
+	]) || typeof value.workspaceId !== "string" || !WORKSPACE_ID$1.test(value.workspaceId) || value.provider !== "managed" || value.accounting !== "current-versions-and-reservations" || value.reservedBytesIncludeUnresolvedUploads !== true || !Array.isArray(value.warnings) || value.warnings.length > 1 || value.warnings.some((warning) => warning !== "unresolved-archive-ownership") || ![
+		value.usedBytes,
+		value.reservedBytes,
+		value.limitBytes,
+		value.availableBytes,
+		value.unresolvedReservedBytes
+	].every((bytes) => typeof bytes === "string" && /^(0|[1-9][0-9]{0,18})$/.test(bytes))) return false;
+	const available = BigInt(value.limitBytes) - BigInt(value.usedBytes) - BigInt(value.reservedBytes);
+	const valid = BigInt(value.availableBytes) === (available > 0n ? available : 0n) && BigInt(value.unresolvedReservedBytes) <= BigInt(value.reservedBytes) && (value.unresolvedReservedBytes === "0" || value.warnings.length === 1);
+	if (valid) Object.freeze(value.warnings);
+	return valid;
+}
+function isWorkspaceDiscoveryPage(value) {
+	if (!isExactRecord(value, ["items", "nextCursor"]) || !Array.isArray(value.items) || value.items.length > 50 || !(value.nextCursor === null || typeof value.nextCursor === "string" && value.nextCursor.length > 0 && value.nextCursor.length <= 2048 && /^[A-Za-z0-9_.-]+$/.test(value.nextCursor)) || value.items.length === 0 && value.nextCursor !== null) return false;
+	const ids = new Set();
+	const valid = value.items.every((item) => {
+		if (!isExactRecord(item, [
+			"workspaceId",
+			"itemId",
+			"parentId",
+			"type",
+			"name",
+			"lifecycleState",
+			"revision",
+			"currentVersion",
+			"volumeId",
+			"provider",
+			"createdAtEpochMilliseconds",
+			"modifiedAtEpochMilliseconds",
+			"creatorUserId",
+			"etag",
+			"trashedAtEpochMilliseconds",
+			"purgeAfterEpochMilliseconds"
+		]) || item.lifecycleState !== "active" && item.lifecycleState !== "trashed" || typeof item.volumeId !== "string" || !VOLUME_ID.test(item.volumeId) || item.provider !== "managed" || item.creatorUserId !== null && (typeof item.creatorUserId !== "string" || !AUTH_ID$1.test(item.creatorUserId)) || ![
+			item.createdAtEpochMilliseconds,
+			item.modifiedAtEpochMilliseconds,
+			item.trashedAtEpochMilliseconds,
+			item.purgeAfterEpochMilliseconds
+		].every((date) => date === null || isSafeInteger$1(date))) return false;
+		const metadata = {
+			workspaceId: item.workspaceId,
+			itemId: item.itemId,
+			parentId: item.parentId,
+			type: item.type,
+			name: item.name,
+			lifecycleState: "active",
+			revision: item.revision,
+			currentVersion: item.currentVersion
+		};
+		if (typeof metadata.workspaceId !== "string" || !WORKSPACE_ID$1.test(metadata.workspaceId) || typeof metadata.itemId !== "string" || !ITEM_ID$1.test(metadata.itemId) || metadata.parentId === null || metadata.parentId === metadata.itemId || !isManagedItemMetadata(metadata, metadata.workspaceId, metadata.itemId) || item.etag !== `"drive.item.v1.${metadata.revision}"` || ids.has(metadata.itemId)) return false;
+		if (item.lifecycleState === "active" ? item.trashedAtEpochMilliseconds !== null || item.purgeAfterEpochMilliseconds !== null : !isSafeInteger$1(item.trashedAtEpochMilliseconds) || !isSafeInteger$1(item.purgeAfterEpochMilliseconds) || item.purgeAfterEpochMilliseconds <= item.trashedAtEpochMilliseconds) return false;
+		ids.add(metadata.itemId);
+		return true;
+	});
+	if (valid) {
+		for (const item of value.items) Object.freeze(item);
+		Object.freeze(value.items);
+		Object.freeze(value);
+	}
+	return valid;
+}
+function isCurrentWorkspaceSources(value) {
+	if (!isExactRecord(value, [
+		"workspace",
+		"volumes",
+		"knownProviders",
+		"externalConnectionsSupported"
+	]) || !isCurrentWorkspace(value.workspace) || !Array.isArray(value.volumes) || value.volumes.length !== 1 || !Array.isArray(value.knownProviders) || value.externalConnectionsSupported !== false) return false;
+	const volume = value.volumes[0];
+	const providers = [
+		"managed",
+		"google-drive",
+		"onedrive",
+		"dropbox",
+		"s3-compatible"
+	];
+	return isExactRecord(volume, [
+		"volumeId",
+		"rootItemId",
+		"provider",
+		"name"
+	]) && volume.volumeId === value.workspace.rootVolumeId && volume.rootItemId === value.workspace.rootItemId && volume.provider === "managed" && volume.name === "Files" && value.knownProviders.length === providers.length && value.knownProviders.every((provider, index) => provider === providers[index]);
+}
 function isCurrentWorkspace(value) {
 	if (!isExactRecord(value, [
 		"workspaceId",
@@ -846,6 +941,29 @@ function validateCurrentWorkspaceInput(value) {
 	const signal = validateSignal(captureRecord(value === void 0 ? {} : value, [], ["signal"]).signal);
 	return signal === void 0 ? {} : { signal };
 }
+function validateWorkspaceDiscoveryInput(value, list) {
+	const input = captureRecord(value, ["workspaceId"], list ? [
+		"signal",
+		"view",
+		"kind",
+		"creatorUserId",
+		"limit",
+		"cursor"
+	] : ["signal"]);
+	const signal = validateSignal(input.signal);
+	if (typeof input.workspaceId !== "string" || !WORKSPACE_ID.test(input.workspaceId) || input.view !== void 0 && input.view !== "recent" && input.view !== "shared" && input.view !== "trash" || input.kind !== void 0 && input.kind !== "file" && input.kind !== "folder" || input.creatorUserId !== void 0 && (typeof input.creatorUserId !== "string" || !AUTH_ID.test(input.creatorUserId)) || input.limit !== void 0 && (typeof input.limit !== "number" || !Number.isInteger(input.limit) || input.limit < 1 || input.limit > 50) || input.cursor !== void 0 && (typeof input.cursor !== "string" || input.cursor.length < 1 || input.cursor.length > 2048 || !/^[A-Za-z0-9_.-]+$/.test(input.cursor))) throw new DriveError("invalid_input");
+	return {
+		workspaceId: input.workspaceId,
+		signal,
+		query: {
+			...input.view === void 0 ? {} : { view: input.view },
+			...input.kind === void 0 ? {} : { kind: input.kind },
+			...input.creatorUserId === void 0 ? {} : { creatorUserId: input.creatorUserId },
+			...input.limit === void 0 ? {} : { limit: input.limit },
+			...input.cursor === void 0 ? {} : { cursor: input.cursor }
+		}
+	};
+}
 function validateResourceInput(value) {
 	const input = captureRecord(value, ["workspaceId", "itemId"], ["signal"]);
 	const workspaceId = input.workspaceId;
@@ -2022,6 +2140,9 @@ const DOWNLOAD_ERROR_CODES = Object.freeze([
 function createDriveOperations(runtime) {
 	return Object.freeze({
 		getCurrentWorkspace: (input) => getCurrentWorkspace(runtime, input),
+		listWorkspaceItems: (input) => listWorkspaceItems(runtime, input),
+		getWorkspaceUsage: (input) => getWorkspaceUsage(runtime, input),
+		getCurrentWorkspaceSources: (input) => getCurrentWorkspaceSources(runtime, input),
 		getItem: (input) => getItem(runtime, input),
 		searchWorkspaceItems: (input) => searchWorkspaceItems(runtime, input),
 		listFolderChildren: (input) => listFolderChildren(runtime, input),
@@ -2220,6 +2341,29 @@ function streamWithOperationLifetime(source, expectedLength, signal) {
 		}
 	});
 }
+async function getCurrentWorkspaceSources(runtime, input) {
+	return execute(runtime, validateCurrentWorkspaceInput(input).signal, null, (api, requestOptions) => api.GET("/api/v1/workspaces/current/sources", {
+		...operationOptions("getCurrentWorkspaceSources", { params: {} }),
+		...requestOptions
+	}), [200], isCurrentWorkspaceSources, false, CURRENT_WORKSPACE_ERROR_CODES);
+}
+async function listWorkspaceItems(runtime, input) {
+	const validated = validateWorkspaceDiscoveryInput(input, true);
+	return execute(runtime, validated.signal, null, (api, options) => api.GET("/api/v1/workspaces/{workspaceId}/items", {
+		...operationOptions("listWorkspaceItems", { params: {
+			path: { workspaceId: validated.workspaceId },
+			query: validated.query
+		} }),
+		...options
+	}), [200], (value) => isWorkspaceDiscoveryPage(value) && value.items.length <= (validated.query.limit ?? 25) && value.items.every((item, index, items) => item.workspaceId === validated.workspaceId && item.lifecycleState === (validated.query.view === "trash" ? "trashed" : "active") && ((validated.query.view ?? "recent") !== "recent" || item.modifiedAtEpochMilliseconds !== null) && (validated.query.kind === void 0 || item.type === validated.query.kind) && (validated.query.creatorUserId === void 0 || item.creatorUserId === validated.query.creatorUserId) && (index === 0 || ((validated.query.view ?? "recent") === "recent" ? items[index - 1].modifiedAtEpochMilliseconds > item.modifiedAtEpochMilliseconds || items[index - 1].modifiedAtEpochMilliseconds === item.modifiedAtEpochMilliseconds && items[index - 1].itemId < item.itemId : items[index - 1].itemId < item.itemId))), false, SEARCH_WORKSPACE_ITEMS_ERROR_CODES);
+}
+async function getWorkspaceUsage(runtime, input) {
+	const validated = validateWorkspaceDiscoveryInput(input, false);
+	return execute(runtime, validated.signal, null, (api, options) => api.GET("/api/v1/workspaces/{workspaceId}/usage", {
+		...operationOptions("getWorkspaceUsage", { params: { path: { workspaceId: validated.workspaceId } } }),
+		...options
+	}), [200], (value) => isWorkspaceUsage(value) && value.workspaceId === validated.workspaceId, false, SEARCH_WORKSPACE_ITEMS_ERROR_CODES);
+}
 async function getCurrentWorkspace(runtime, input) {
 	return execute(runtime, validateCurrentWorkspaceInput(input).signal, null, (api, requestOptions) => api.GET("/api/v1/workspaces/current", {
 		...operationOptions("getCurrentWorkspace", { params: {} }),

package/dist/contract.d.ts

@@ -355,6 +355,312 @@ interface operations {
       };
     };
   };
+  getCurrentWorkspaceSources: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description One canonical managed volume. Known providers are not connections or health evidence. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            /** @enum {boolean} */
+            externalConnectionsSupported: false;
+            knownProviders: ("managed" | "google-drive" | "onedrive" | "dropbox" | "s3-compatible")[];
+            volumes: {
+              /** @enum {string} */
+              name: "Files";
+              /** @enum {string} */
+              provider: "managed";
+              rootItemId: string;
+              volumeId: string;
+            }[];
+            workspace: {
+              rootItemId: string;
+              rootVolumeId: string;
+              workspaceId: string;
+              workspaceReference: {
+                /** @enum {string} */
+                type: "personal";
+                userId: string;
+              } | {
+                organizationId: string;
+                /** @enum {string} */
+                type: "organization";
+              };
+            };
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is required.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Managed storage is disabled. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "permission_denied";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested action is not permitted.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The current workspace is not provisioned or accessible. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "resource_not_found";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested resource was not found.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Unsupported query input. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "invalid_request";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity authority, D1, or canonical managed root is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "identity_authority_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is temporarily unavailable.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "service_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The service is temporarily unavailable.";
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
+  listWorkspaceItems: {
+    parameters: {
+      query?: {
+        view?: "recent" | "shared" | "trash";
+        kind?: "file" | "folder";
+        creatorUserId?: string;
+        limit?: number;
+        cursor?: string;
+      };
+      header?: never;
+      path: {
+        workspaceId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Authorized items and an authenticated continuation; no total count. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            items: {
+              createdAtEpochMilliseconds: number | null;
+              creatorUserId: string | null;
+              currentVersion: {
+                byteLength: number;
+                mediaType: string;
+                /** @enum {string} */
+                protectionClassification: "ordinary" | "opaque-encrypted";
+                /** @enum {string} */
+                state: "current";
+                versionId: string;
+              } | null;
+              etag: string;
+              itemId: string;
+              /** @enum {string} */
+              lifecycleState: "active" | "trashed";
+              modifiedAtEpochMilliseconds: number | null;
+              name: string;
+              parentId: string | null;
+              /** @enum {string} */
+              provider: "managed";
+              purgeAfterEpochMilliseconds: number | null;
+              revision: number;
+              trashedAtEpochMilliseconds: number | null;
+              /** @enum {string} */
+              type: "file" | "folder";
+              volumeId: string;
+              workspaceId: string;
+            }[];
+            nextCursor: string | null;
+          };
+        };
+      };
+      /** @description Authentication required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The action is not permitted. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Workspace not found. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The selected authority or page changed; restart the query. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Invalid request or cursor. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Authoritative state is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
   getItem: {
     parameters: {
       query?: never;
@@ -4562,6 +4868,144 @@ interface operations {
       };
     };
   };
+  getWorkspaceUsage: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        workspaceId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Current committed and retained reserved bytes, not physical archive usage. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            /** @enum {string} */
+            accounting: "current-versions-and-reservations";
+            availableBytes: string;
+            limitBytes: string;
+            /** @enum {string} */
+            provider: "managed";
+            reservedBytes: string;
+            /** @enum {boolean} */
+            reservedBytesIncludeUnresolvedUploads: true;
+            unresolvedReservedBytes: string;
+            usedBytes: string;
+            warnings: "unresolved-archive-ownership"[];
+            workspaceId: string;
+          };
+        };
+      };
+      /** @description Authentication required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The action is not permitted. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Workspace not found. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The selected authority or page changed; restart the query. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Invalid request or cursor. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Authoritative state is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
 }
 //#endregion
 //#region src/types.d.ts
@@ -4610,6 +5054,35 @@ type CreateDownloadPath = operations["createDownload"]["parameters"]["path"];
 type CreateDownloadQuery = NonNullable<operations["createDownload"]["parameters"]["query"]>;
 type CreateDownloadHeaders = operations["createDownload"]["parameters"]["header"];
 type GeneratedCurrentWorkspace = JsonResponse<"getCurrentWorkspace", 200>;
+type GeneratedDiscoveryPage = JsonResponse<"listWorkspaceItems", 200>;
+type WorkspaceDiscoveryItem = Readonly<Omit<GeneratedDiscoveryPage["items"][number], "currentVersion"> & {
+  readonly currentVersion: ManagedItemMetadata["currentVersion"];
+}>;
+type WorkspaceDiscoveryPage = Readonly<{
+  items: readonly WorkspaceDiscoveryItem[];
+  nextCursor: string | null;
+}>;
+type GeneratedWorkspaceUsage = JsonResponse<"getWorkspaceUsage", 200>;
+type WorkspaceUsage = Readonly<Omit<GeneratedWorkspaceUsage, "warnings"> & {
+  readonly warnings: readonly GeneratedWorkspaceUsage["warnings"][number][];
+}>;
+interface GetWorkspaceUsageInput {
+  readonly workspaceId: string;
+  readonly signal?: AbortSignal;
+}
+interface ListWorkspaceItemsInput extends GetWorkspaceUsageInput {
+  readonly view?: "recent" | "shared" | "trash";
+  readonly kind?: "file" | "folder";
+  readonly creatorUserId?: string;
+  readonly limit?: number;
+  readonly cursor?: string;
+}
+type GeneratedCurrentWorkspaceSources = JsonResponse<"getCurrentWorkspaceSources", 200>;
+type CurrentWorkspaceSources = Readonly<Omit<GeneratedCurrentWorkspaceSources, "workspace" | "volumes" | "knownProviders"> & {
+  readonly workspace: CurrentWorkspace;
+  readonly volumes: readonly Readonly<GeneratedCurrentWorkspaceSources["volumes"][number]>[];
+  readonly knownProviders: readonly GeneratedCurrentWorkspaceSources["knownProviders"][number][];
+}>;
 type CurrentWorkspace = Readonly<Omit<GeneratedCurrentWorkspace, "workspaceReference"> & {
   readonly workspaceReference: Readonly<GeneratedCurrentWorkspace["workspaceReference"]>;
 }>;
@@ -4817,6 +5290,9 @@ interface GetCurrentWorkspaceInput {
   readonly signal?: AbortSignal;
 }
 interface DriveOperations {
+  listWorkspaceItems(input: ListWorkspaceItemsInput): Promise<DriveOperationResult<WorkspaceDiscoveryPage, 200>>;
+  getWorkspaceUsage(input: GetWorkspaceUsageInput): Promise<DriveOperationResult<WorkspaceUsage, 200>>;
+  getCurrentWorkspaceSources(input?: GetCurrentWorkspaceInput): Promise<DriveOperationResult<CurrentWorkspaceSources, 200>>;
   getCurrentWorkspace(input?: GetCurrentWorkspaceInput): Promise<DriveOperationResult<CurrentWorkspace, 200>>;
   getItem(input: GetItemInput): Promise<DriveOperationResult<ManagedItemMetadata, 200>>;
   searchWorkspaceItems(input: SearchWorkspaceItemsInput): Promise<DriveOperationResult<WorkspaceItemSearchPage, 200>>;
@@ -4848,4 +5324,4 @@ interface DriveClient extends DriveOperations {
   uploadFile(input: UploadFileInput): Promise<DriveOperationResult<UploadCompletion, 200 | 202>>;
 }
 //#endregion
-export { TrashItemInput as $, ListItemVersionsInput as A, PermissionAction as B, FolderPage as C, GetUploadStatusInput as D, GetItemVersionInput as E, ManagedItemVersionPage as F, ProtectionClassification as G, PermissionGrantee as H, ManagedItemVersionResource as I, RecordUploadPartInput as J, ReadEffectiveItemPermissionsInput as K, ManagedItemVersionRestoreResult as L, ManagedDownloadRestorePending as M, ManagedItemMetadata as N, ListFolderChildrenInput as O, ManagedItemVersion as P, SearchWorkspaceItemsInput as Q, ManagedLifecycleItem as R, FolderItem as S, GetItemInput as T, PermissionMutation as U, PermissionGrant as V, PermissionPage as W, RestoreItemVersionInput as X, RestoreItemInput as Y, RevokeItemPermissionInput as Z, DriveResponseValidators as _, CreateItemPermissionInput as a, UploadFilePhase as at, EffectivePermissionAction as b, CurrentWorkspace as c, UploadPartDescriptor as ct, DriveClient as d, UploadStatus as dt, UpdateItemInput as et, DriveClientConfig as f, WorkspaceItemSearchItem as ft, DriveOperations as g, DriveOperationResult as h, CreateFolderInput as i, UploadFileInput as it, ManagedDownloadDescriptor as j, ListItemPermissionsInput as k, DeleteItemInput as l, UploadPartResult as lt, DriveCredentialProvider as m, operations as mt, CompleteUploadInput as n, UploadCompletion as nt, CreateUploadInput as o, UploadFileProgress as ot, DriveCredentialContext as p, WorkspaceItemSearchPage as pt, ReadyUpload as q, CreateDownloadInput as r, UploadConfirmedPart as rt, CreateUploadPartDescriptorInput as s, UploadFileProgressCallback as st, AbortUploadInput as t, UpdateItemPermissionInput as tt, DownloadItemResult as u, UploadSession as ut, DriveServerClient as v, GetCurrentWorkspaceInput as w, EffectivePermissionResponse as x, DriveServerClientConfig as y, PendingUpload as z };
+export { RestoreItemVersionInput as $, ListFolderChildrenInput as A, ManagedItemVersionRestoreResult as B, FolderItem as C, GetItemVersionInput as D, GetItemInput as E, ManagedDownloadRestorePending as F, PermissionGrantee as G, PendingUpload as H, ManagedItemMetadata as I, ProtectionClassification as J, PermissionMutation as K, ManagedItemVersion as L, ListItemVersionsInput as M, ListWorkspaceItemsInput as N, GetUploadStatusInput as O, ManagedDownloadDescriptor as P, RestoreItemInput as Q, ManagedItemVersionPage as R, EffectivePermissionResponse as S, GetCurrentWorkspaceInput as T, PermissionAction as U, ManagedLifecycleItem as V, PermissionGrant as W, ReadyUpload as X, ReadEffectiveItemPermissionsInput as Y, RecordUploadPartInput as Z, DriveOperations as _, WorkspaceItemSearchItem as _t, CreateItemPermissionInput as a, UploadCompletion as at, DriveServerClientConfig as b, operations as bt, CurrentWorkspace as c, UploadFilePhase as ct, DownloadItemResult as d, UploadPartDescriptor as dt, RevokeItemPermissionInput as et, DriveClient as f, UploadPartResult as ft, DriveOperationResult as g, WorkspaceDiscoveryPage as gt, DriveCredentialProvider as h, WorkspaceDiscoveryItem as ht, CreateFolderInput as i, UpdateItemPermissionInput as it, ListItemPermissionsInput as j, GetWorkspaceUsageInput as k, CurrentWorkspaceSources as l, UploadFileProgress as lt, DriveCredentialContext as m, UploadStatus as mt, CompleteUploadInput as n, TrashItemInput as nt, CreateUploadInput as o, UploadConfirmedPart as ot, DriveClientConfig as p, UploadSession as pt, PermissionPage as q, CreateDownloadInput as r, UpdateItemInput as rt, CreateUploadPartDescriptorInput as s, UploadFileInput as st, AbortUploadInput as t, SearchWorkspaceItemsInput as tt, DeleteItemInput as u, UploadFileProgressCallback as ut, DriveResponseValidators as v, WorkspaceItemSearchPage as vt, FolderPage as w, EffectivePermissionAction as x, DriveServerClient as y, WorkspaceUsage as yt, ManagedItemVersionResource as z };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as TrashItemInput, A as ListItemVersionsInput, B as PermissionAction, C as FolderPage, D as GetUploadStatusInput, E as GetItemVersionInput, F as ManagedItemVersionPage, G as ProtectionClassification, H as PermissionGrantee, I as ManagedItemVersionResource, J as RecordUploadPartInput, K as ReadEffectiveItemPermissionsInput, L as ManagedItemVersionRestoreResult, M as ManagedDownloadRestorePending, N as ManagedItemMetadata, O as ListFolderChildrenInput, P as ManagedItemVersion, Q as SearchWorkspaceItemsInput, R as ManagedLifecycleItem, S as FolderItem, T as GetItemInput, U as PermissionMutation, V as PermissionGrant, X as RestoreItemVersionInput, Y as RestoreItemInput, Z as RevokeItemPermissionInput, _ as DriveResponseValidators, a as CreateItemPermissionInput, at as UploadFilePhase, b as EffectivePermissionAction, c as CurrentWorkspace, ct as UploadPartDescriptor, d as DriveClient, dt as UploadStatus, et as UpdateItemInput, f as DriveClientConfig, ft as WorkspaceItemSearchItem, g as DriveOperations, h as DriveOperationResult, i as CreateFolderInput, it as UploadFileInput, j as ManagedDownloadDescriptor, k as ListItemPermissionsInput, l as DeleteItemInput, lt as UploadPartResult, m as DriveCredentialProvider, n as CompleteUploadInput, nt as UploadCompletion, o as CreateUploadInput, ot as UploadFileProgress, pt as WorkspaceItemSearchPage, q as ReadyUpload, r as CreateDownloadInput, rt as UploadConfirmedPart, s as CreateUploadPartDescriptorInput, st as UploadFileProgressCallback, t as AbortUploadInput, tt as UpdateItemPermissionInput, u as DownloadItemResult, ut as UploadSession, w as GetCurrentWorkspaceInput, z as PendingUpload } from "./contract.js";
+import { $ as RestoreItemVersionInput, A as ListFolderChildrenInput, B as ManagedItemVersionRestoreResult, C as FolderItem, D as GetItemVersionInput, E as GetItemInput, F as ManagedDownloadRestorePending, G as PermissionGrantee, H as PendingUpload, I as ManagedItemMetadata, J as ProtectionClassification, K as PermissionMutation, L as ManagedItemVersion, M as ListItemVersionsInput, N as ListWorkspaceItemsInput, O as GetUploadStatusInput, P as ManagedDownloadDescriptor, Q as RestoreItemInput, R as ManagedItemVersionPage, T as GetCurrentWorkspaceInput, U as PermissionAction, V as ManagedLifecycleItem, W as PermissionGrant, X as ReadyUpload, Y as ReadEffectiveItemPermissionsInput, Z as RecordUploadPartInput, _ as DriveOperations, _t as WorkspaceItemSearchItem, a as CreateItemPermissionInput, at as UploadCompletion, c as CurrentWorkspace, ct as UploadFilePhase, d as DownloadItemResult, dt as UploadPartDescriptor, et as RevokeItemPermissionInput, f as DriveClient, ft as UploadPartResult, g as DriveOperationResult, gt as WorkspaceDiscoveryPage, h as DriveCredentialProvider, ht as WorkspaceDiscoveryItem, i as CreateFolderInput, it as UpdateItemPermissionInput, j as ListItemPermissionsInput, k as GetWorkspaceUsageInput, l as CurrentWorkspaceSources, lt as UploadFileProgress, mt as UploadStatus, n as CompleteUploadInput, nt as TrashItemInput, o as CreateUploadInput, ot as UploadConfirmedPart, p as DriveClientConfig, pt as UploadSession, r as CreateDownloadInput, rt as UpdateItemInput, s as CreateUploadPartDescriptorInput, st as UploadFileInput, t as AbortUploadInput, tt as SearchWorkspaceItemsInput, u as DeleteItemInput, ut as UploadFileProgressCallback, v as DriveResponseValidators, vt as WorkspaceItemSearchPage, w as FolderPage, x as EffectivePermissionAction, yt as WorkspaceUsage, z as ManagedItemVersionResource } from "./contract.js";
 import { createDriveClient } from "./client.js";
 import { DRIVE_API_ERROR_CODES, DRIVE_API_ERROR_MESSAGES, DriveApiErrorCode, DriveError, DriveErrorCode, DriveSdkErrorCode } from "./core.js";
-export { type AbortUploadInput, type CompleteUploadInput, type CreateDownloadInput, type CreateFolderInput, type CreateItemPermissionInput, type CreateUploadInput, type CreateUploadPartDescriptorInput, type CurrentWorkspace, DRIVE_API_ERROR_CODES, DRIVE_API_ERROR_MESSAGES, type DeleteItemInput, type DownloadItemResult, type DriveApiErrorCode, type DriveClient, type DriveClientConfig, type DriveCredentialProvider, DriveError, type DriveErrorCode, type DriveOperationResult, type DriveOperations, type DriveResponseValidators, type DriveSdkErrorCode, type EffectivePermissionAction, type FolderItem, type FolderPage, type GetCurrentWorkspaceInput, type GetItemInput, type GetItemVersionInput, type GetUploadStatusInput, type ListFolderChildrenInput, type ListItemPermissionsInput, type ListItemVersionsInput, type ManagedDownloadDescriptor, type ManagedDownloadRestorePending, type ManagedItemMetadata, type ManagedItemVersion, type ManagedItemVersionPage, type ManagedItemVersionResource, type ManagedItemVersionRestoreResult, type ManagedLifecycleItem, type PendingUpload, type PermissionAction, type PermissionGrant, type PermissionGrantee, type PermissionMutation, type ProtectionClassification, type ReadEffectiveItemPermissionsInput, type ReadyUpload, type RecordUploadPartInput, type RestoreItemInput, type RestoreItemVersionInput, type RevokeItemPermissionInput, type SearchWorkspaceItemsInput, type TrashItemInput, type UpdateItemInput, type UpdateItemPermissionInput, type UploadCompletion, type UploadConfirmedPart, type UploadFileInput, type UploadFilePhase, type UploadFileProgress, type UploadFileProgressCallback, type UploadPartDescriptor, type UploadPartResult, type UploadSession, type UploadStatus, type WorkspaceItemSearchItem, type WorkspaceItemSearchPage, createDriveClient };
+export { type AbortUploadInput, type CompleteUploadInput, type CreateDownloadInput, type CreateFolderInput, type CreateItemPermissionInput, type CreateUploadInput, type CreateUploadPartDescriptorInput, type CurrentWorkspace, type CurrentWorkspaceSources, DRIVE_API_ERROR_CODES, DRIVE_API_ERROR_MESSAGES, type DeleteItemInput, type DownloadItemResult, type DriveApiErrorCode, type DriveClient, type DriveClientConfig, type DriveCredentialProvider, DriveError, type DriveErrorCode, type DriveOperationResult, type DriveOperations, type DriveResponseValidators, type DriveSdkErrorCode, type EffectivePermissionAction, type FolderItem, type FolderPage, type GetCurrentWorkspaceInput, type GetItemInput, type GetItemVersionInput, type GetUploadStatusInput, type GetWorkspaceUsageInput, type ListFolderChildrenInput, type ListItemPermissionsInput, type ListItemVersionsInput, type ListWorkspaceItemsInput, type ManagedDownloadDescriptor, type ManagedDownloadRestorePending, type ManagedItemMetadata, type ManagedItemVersion, type ManagedItemVersionPage, type ManagedItemVersionResource, type ManagedItemVersionRestoreResult, type ManagedLifecycleItem, type PendingUpload, type PermissionAction, type PermissionGrant, type PermissionGrantee, type PermissionMutation, type ProtectionClassification, type ReadEffectiveItemPermissionsInput, type ReadyUpload, type RecordUploadPartInput, type RestoreItemInput, type RestoreItemVersionInput, type RevokeItemPermissionInput, type SearchWorkspaceItemsInput, type TrashItemInput, type UpdateItemInput, type UpdateItemPermissionInput, type UploadCompletion, type UploadConfirmedPart, type UploadFileInput, type UploadFilePhase, type UploadFileProgress, type UploadFileProgressCallback, type UploadPartDescriptor, type UploadPartResult, type UploadSession, type UploadStatus, type WorkspaceDiscoveryItem, type WorkspaceDiscoveryPage, type WorkspaceItemSearchItem, type WorkspaceItemSearchPage, type WorkspaceUsage, createDriveClient };

package/dist/index.js

@@ -327,6 +327,101 @@ const MAX_UPLOAD_BYTE_LENGTH$1 = 33554432e4;
 const UPLOAD_PART_BYTE_LENGTH$2 = 32 * 1024 * 1024;
 const CONTENT_DIGEST$1 = /^sha256:[0-9a-f]{64}$/;
 const UTF8 = new TextEncoder();
+function isWorkspaceUsage(value) {
+	if (!isExactRecord(value, [
+		"workspaceId",
+		"provider",
+		"usedBytes",
+		"reservedBytes",
+		"limitBytes",
+		"availableBytes",
+		"accounting",
+		"reservedBytesIncludeUnresolvedUploads",
+		"unresolvedReservedBytes",
+		"warnings"
+	]) || typeof value.workspaceId !== "string" || !WORKSPACE_ID$1.test(value.workspaceId) || value.provider !== "managed" || value.accounting !== "current-versions-and-reservations" || value.reservedBytesIncludeUnresolvedUploads !== true || !Array.isArray(value.warnings) || value.warnings.length > 1 || value.warnings.some((warning) => warning !== "unresolved-archive-ownership") || ![
+		value.usedBytes,
+		value.reservedBytes,
+		value.limitBytes,
+		value.availableBytes,
+		value.unresolvedReservedBytes
+	].every((bytes) => typeof bytes === "string" && /^(0|[1-9][0-9]{0,18})$/.test(bytes))) return false;
+	const available = BigInt(value.limitBytes) - BigInt(value.usedBytes) - BigInt(value.reservedBytes);
+	const valid = BigInt(value.availableBytes) === (available > 0n ? available : 0n) && BigInt(value.unresolvedReservedBytes) <= BigInt(value.reservedBytes) && (value.unresolvedReservedBytes === "0" || value.warnings.length === 1);
+	if (valid) Object.freeze(value.warnings);
+	return valid;
+}
+function isWorkspaceDiscoveryPage(value) {
+	if (!isExactRecord(value, ["items", "nextCursor"]) || !Array.isArray(value.items) || value.items.length > 50 || !(value.nextCursor === null || typeof value.nextCursor === "string" && value.nextCursor.length > 0 && value.nextCursor.length <= 2048 && /^[A-Za-z0-9_.-]+$/.test(value.nextCursor)) || value.items.length === 0 && value.nextCursor !== null) return false;
+	const ids = new Set();
+	const valid = value.items.every((item) => {
+		if (!isExactRecord(item, [
+			"workspaceId",
+			"itemId",
+			"parentId",
+			"type",
+			"name",
+			"lifecycleState",
+			"revision",
+			"currentVersion",
+			"volumeId",
+			"provider",
+			"createdAtEpochMilliseconds",
+			"modifiedAtEpochMilliseconds",
+			"creatorUserId",
+			"etag",
+			"trashedAtEpochMilliseconds",
+			"purgeAfterEpochMilliseconds"
+		]) || item.lifecycleState !== "active" && item.lifecycleState !== "trashed" || typeof item.volumeId !== "string" || !VOLUME_ID.test(item.volumeId) || item.provider !== "managed" || item.creatorUserId !== null && (typeof item.creatorUserId !== "string" || !AUTH_ID$1.test(item.creatorUserId)) || ![
+			item.createdAtEpochMilliseconds,
+			item.modifiedAtEpochMilliseconds,
+			item.trashedAtEpochMilliseconds,
+			item.purgeAfterEpochMilliseconds
+		].every((date) => date === null || isSafeInteger$1(date))) return false;
+		const metadata = {
+			workspaceId: item.workspaceId,
+			itemId: item.itemId,
+			parentId: item.parentId,
+			type: item.type,
+			name: item.name,
+			lifecycleState: "active",
+			revision: item.revision,
+			currentVersion: item.currentVersion
+		};
+		if (typeof metadata.workspaceId !== "string" || !WORKSPACE_ID$1.test(metadata.workspaceId) || typeof metadata.itemId !== "string" || !ITEM_ID$1.test(metadata.itemId) || metadata.parentId === null || metadata.parentId === metadata.itemId || !isManagedItemMetadata(metadata, metadata.workspaceId, metadata.itemId) || item.etag !== `"drive.item.v1.${metadata.revision}"` || ids.has(metadata.itemId)) return false;
+		if (item.lifecycleState === "active" ? item.trashedAtEpochMilliseconds !== null || item.purgeAfterEpochMilliseconds !== null : !isSafeInteger$1(item.trashedAtEpochMilliseconds) || !isSafeInteger$1(item.purgeAfterEpochMilliseconds) || item.purgeAfterEpochMilliseconds <= item.trashedAtEpochMilliseconds) return false;
+		ids.add(metadata.itemId);
+		return true;
+	});
+	if (valid) {
+		for (const item of value.items) Object.freeze(item);
+		Object.freeze(value.items);
+		Object.freeze(value);
+	}
+	return valid;
+}
+function isCurrentWorkspaceSources(value) {
+	if (!isExactRecord(value, [
+		"workspace",
+		"volumes",
+		"knownProviders",
+		"externalConnectionsSupported"
+	]) || !isCurrentWorkspace(value.workspace) || !Array.isArray(value.volumes) || value.volumes.length !== 1 || !Array.isArray(value.knownProviders) || value.externalConnectionsSupported !== false) return false;
+	const volume = value.volumes[0];
+	const providers = [
+		"managed",
+		"google-drive",
+		"onedrive",
+		"dropbox",
+		"s3-compatible"
+	];
+	return isExactRecord(volume, [
+		"volumeId",
+		"rootItemId",
+		"provider",
+		"name"
+	]) && volume.volumeId === value.workspace.rootVolumeId && volume.rootItemId === value.workspace.rootItemId && volume.provider === "managed" && volume.name === "Files" && value.knownProviders.length === providers.length && value.knownProviders.every((provider, index) => provider === providers[index]);
+}
 function isCurrentWorkspace(value) {
 	if (!isExactRecord(value, [
 		"workspaceId",
@@ -846,6 +941,29 @@ function validateCurrentWorkspaceInput(value) {
 	const signal = validateSignal(captureRecord(value === void 0 ? {} : value, [], ["signal"]).signal);
 	return signal === void 0 ? {} : { signal };
 }
+function validateWorkspaceDiscoveryInput(value, list) {
+	const input = captureRecord(value, ["workspaceId"], list ? [
+		"signal",
+		"view",
+		"kind",
+		"creatorUserId",
+		"limit",
+		"cursor"
+	] : ["signal"]);
+	const signal = validateSignal(input.signal);
+	if (typeof input.workspaceId !== "string" || !WORKSPACE_ID.test(input.workspaceId) || input.view !== void 0 && input.view !== "recent" && input.view !== "shared" && input.view !== "trash" || input.kind !== void 0 && input.kind !== "file" && input.kind !== "folder" || input.creatorUserId !== void 0 && (typeof input.creatorUserId !== "string" || !AUTH_ID.test(input.creatorUserId)) || input.limit !== void 0 && (typeof input.limit !== "number" || !Number.isInteger(input.limit) || input.limit < 1 || input.limit > 50) || input.cursor !== void 0 && (typeof input.cursor !== "string" || input.cursor.length < 1 || input.cursor.length > 2048 || !/^[A-Za-z0-9_.-]+$/.test(input.cursor))) throw new DriveError("invalid_input");
+	return {
+		workspaceId: input.workspaceId,
+		signal,
+		query: {
+			...input.view === void 0 ? {} : { view: input.view },
+			...input.kind === void 0 ? {} : { kind: input.kind },
+			...input.creatorUserId === void 0 ? {} : { creatorUserId: input.creatorUserId },
+			...input.limit === void 0 ? {} : { limit: input.limit },
+			...input.cursor === void 0 ? {} : { cursor: input.cursor }
+		}
+	};
+}
 function validateResourceInput(value) {
 	const input = captureRecord(value, ["workspaceId", "itemId"], ["signal"]);
 	const workspaceId = input.workspaceId;
@@ -2022,6 +2140,9 @@ const DOWNLOAD_ERROR_CODES = Object.freeze([
 function createDriveOperations(runtime) {
 	return Object.freeze({
 		getCurrentWorkspace: (input) => getCurrentWorkspace(runtime, input),
+		listWorkspaceItems: (input) => listWorkspaceItems(runtime, input),
+		getWorkspaceUsage: (input) => getWorkspaceUsage(runtime, input),
+		getCurrentWorkspaceSources: (input) => getCurrentWorkspaceSources(runtime, input),
 		getItem: (input) => getItem(runtime, input),
 		searchWorkspaceItems: (input) => searchWorkspaceItems(runtime, input),
 		listFolderChildren: (input) => listFolderChildren(runtime, input),
@@ -2220,6 +2341,29 @@ function streamWithOperationLifetime(source, expectedLength, signal) {
 		}
 	});
 }
+async function getCurrentWorkspaceSources(runtime, input) {
+	return execute(runtime, validateCurrentWorkspaceInput(input).signal, null, (api, requestOptions) => api.GET("/api/v1/workspaces/current/sources", {
+		...operationOptions("getCurrentWorkspaceSources", { params: {} }),
+		...requestOptions
+	}), [200], isCurrentWorkspaceSources, false, CURRENT_WORKSPACE_ERROR_CODES);
+}
+async function listWorkspaceItems(runtime, input) {
+	const validated = validateWorkspaceDiscoveryInput(input, true);
+	return execute(runtime, validated.signal, null, (api, options) => api.GET("/api/v1/workspaces/{workspaceId}/items", {
+		...operationOptions("listWorkspaceItems", { params: {
+			path: { workspaceId: validated.workspaceId },
+			query: validated.query
+		} }),
+		...options
+	}), [200], (value) => isWorkspaceDiscoveryPage(value) && value.items.length <= (validated.query.limit ?? 25) && value.items.every((item, index, items) => item.workspaceId === validated.workspaceId && item.lifecycleState === (validated.query.view === "trash" ? "trashed" : "active") && ((validated.query.view ?? "recent") !== "recent" || item.modifiedAtEpochMilliseconds !== null) && (validated.query.kind === void 0 || item.type === validated.query.kind) && (validated.query.creatorUserId === void 0 || item.creatorUserId === validated.query.creatorUserId) && (index === 0 || ((validated.query.view ?? "recent") === "recent" ? items[index - 1].modifiedAtEpochMilliseconds > item.modifiedAtEpochMilliseconds || items[index - 1].modifiedAtEpochMilliseconds === item.modifiedAtEpochMilliseconds && items[index - 1].itemId < item.itemId : items[index - 1].itemId < item.itemId))), false, SEARCH_WORKSPACE_ITEMS_ERROR_CODES);
+}
+async function getWorkspaceUsage(runtime, input) {
+	const validated = validateWorkspaceDiscoveryInput(input, false);
+	return execute(runtime, validated.signal, null, (api, options) => api.GET("/api/v1/workspaces/{workspaceId}/usage", {
+		...operationOptions("getWorkspaceUsage", { params: { path: { workspaceId: validated.workspaceId } } }),
+		...options
+	}), [200], (value) => isWorkspaceUsage(value) && value.workspaceId === validated.workspaceId, false, SEARCH_WORKSPACE_ITEMS_ERROR_CODES);
+}
 async function getCurrentWorkspace(runtime, input) {
 	return execute(runtime, validateCurrentWorkspaceInput(input).signal, null, (api, requestOptions) => api.GET("/api/v1/workspaces/current", {
 		...operationOptions("getCurrentWorkspace", { params: {} }),

package/dist/server.d.ts

@@ -1,4 +1,4 @@
-import { $ as TrashItemInput, A as ListItemVersionsInput, C as FolderPage, D as GetUploadStatusInput, E as GetItemVersionInput, F as ManagedItemVersionPage, G as ProtectionClassification, I as ManagedItemVersionResource, J as RecordUploadPartInput, L as ManagedItemVersionRestoreResult, M as ManagedDownloadRestorePending, N as ManagedItemMetadata, O as ListFolderChildrenInput, P as ManagedItemVersion, Q as SearchWorkspaceItemsInput, R as ManagedLifecycleItem, S as FolderItem, T as GetItemInput, X as RestoreItemVersionInput, Y as RestoreItemInput, c as CurrentWorkspace, ct as UploadPartDescriptor, dt as UploadStatus, et as UpdateItemInput, ft as WorkspaceItemSearchItem, h as DriveOperationResult, j as ManagedDownloadDescriptor, l as DeleteItemInput, lt as UploadPartResult, m as DriveCredentialProvider, mt as operations, n as CompleteUploadInput, nt as UploadCompletion, o as CreateUploadInput, pt as WorkspaceItemSearchPage, q as ReadyUpload, r as CreateDownloadInput, rt as UploadConfirmedPart, s as CreateUploadPartDescriptorInput, t as AbortUploadInput, u as DownloadItemResult, ut as UploadSession, v as DriveServerClient, w as GetCurrentWorkspaceInput, y as DriveServerClientConfig, z as PendingUpload } from "./contract.js";
+import { $ as RestoreItemVersionInput, A as ListFolderChildrenInput, B as ManagedItemVersionRestoreResult, C as FolderItem, D as GetItemVersionInput, E as GetItemInput, F as ManagedDownloadRestorePending, H as PendingUpload, I as ManagedItemMetadata, J as ProtectionClassification, L as ManagedItemVersion, M as ListItemVersionsInput, N as ListWorkspaceItemsInput, O as GetUploadStatusInput, P as ManagedDownloadDescriptor, Q as RestoreItemInput, R as ManagedItemVersionPage, T as GetCurrentWorkspaceInput, V as ManagedLifecycleItem, X as ReadyUpload, Z as RecordUploadPartInput, _t as WorkspaceItemSearchItem, at as UploadCompletion, b as DriveServerClientConfig, bt as operations, c as CurrentWorkspace, d as DownloadItemResult, dt as UploadPartDescriptor, ft as UploadPartResult, g as DriveOperationResult, gt as WorkspaceDiscoveryPage, h as DriveCredentialProvider, ht as WorkspaceDiscoveryItem, k as GetWorkspaceUsageInput, l as CurrentWorkspaceSources, mt as UploadStatus, n as CompleteUploadInput, nt as TrashItemInput, o as CreateUploadInput, ot as UploadConfirmedPart, pt as UploadSession, r as CreateDownloadInput, rt as UpdateItemInput, s as CreateUploadPartDescriptorInput, t as AbortUploadInput, tt as SearchWorkspaceItemsInput, u as DeleteItemInput, vt as WorkspaceItemSearchPage, w as FolderPage, y as DriveServerClient, yt as WorkspaceUsage, z as ManagedItemVersionResource } from "./contract.js";
 //#region src/internal/provisioning.d.ts
 type Operation = operations["provisionManagedWorkspace"];
 type ProvisionWorkspaceCommand = Operation["requestBody"]["content"]["application/json"];
@@ -20,4 +20,4 @@ declare function createDriveProvisioningClient(config: DriveProvisioningClientCo
 //#region src/server.d.ts
 declare function createDriveServerClient(config: DriveServerClientConfig): DriveServerClient;
 //#endregion
-export { type AbortUploadInput, type CompleteUploadInput, type CreateDownloadInput, type CreateUploadInput, type CreateUploadPartDescriptorInput, type CurrentWorkspace, type DeleteItemInput, type DownloadItemResult, type DriveProvisioningClient, type DriveProvisioningClientConfig, type DriveServerClient, type DriveServerClientConfig, type FolderItem, type FolderPage, type GetCurrentWorkspaceInput, type GetItemInput, type GetItemVersionInput, type GetUploadStatusInput, type ListFolderChildrenInput, type ListItemVersionsInput, type ManagedDownloadDescriptor, type ManagedDownloadRestorePending, type ManagedItemMetadata, type ManagedItemVersion, type ManagedItemVersionPage, type ManagedItemVersionResource, type ManagedItemVersionRestoreResult, type ManagedLifecycleItem, type PendingUpload, type ProtectionClassification, type ProvisionWorkspaceCommand, type ProvisionWorkspaceResult, type ReadyUpload, type RecordUploadPartInput, type RestoreItemInput, type RestoreItemVersionInput, type SearchWorkspaceItemsInput, type TrashItemInput, type UpdateItemInput, type UploadCompletion, type UploadConfirmedPart, type UploadPartDescriptor, type UploadPartResult, type UploadSession, type UploadStatus, type WorkspaceItemSearchItem, type WorkspaceItemSearchPage, createDriveProvisioningClient, createDriveServerClient };
+export { type AbortUploadInput, type CompleteUploadInput, type CreateDownloadInput, type CreateUploadInput, type CreateUploadPartDescriptorInput, type CurrentWorkspace, type CurrentWorkspaceSources, type DeleteItemInput, type DownloadItemResult, type DriveProvisioningClient, type DriveProvisioningClientConfig, type DriveServerClient, type DriveServerClientConfig, type FolderItem, type FolderPage, type GetCurrentWorkspaceInput, type GetItemInput, type GetItemVersionInput, type GetUploadStatusInput, type GetWorkspaceUsageInput, type ListFolderChildrenInput, type ListItemVersionsInput, type ListWorkspaceItemsInput, type ManagedDownloadDescriptor, type ManagedDownloadRestorePending, type ManagedItemMetadata, type ManagedItemVersion, type ManagedItemVersionPage, type ManagedItemVersionResource, type ManagedItemVersionRestoreResult, type ManagedLifecycleItem, type PendingUpload, type ProtectionClassification, type ProvisionWorkspaceCommand, type ProvisionWorkspaceResult, type ReadyUpload, type RecordUploadPartInput, type RestoreItemInput, type RestoreItemVersionInput, type SearchWorkspaceItemsInput, type TrashItemInput, type UpdateItemInput, type UploadCompletion, type UploadConfirmedPart, type UploadPartDescriptor, type UploadPartResult, type UploadSession, type UploadStatus, type WorkspaceDiscoveryItem, type WorkspaceDiscoveryPage, type WorkspaceItemSearchItem, type WorkspaceItemSearchPage, type WorkspaceUsage, createDriveProvisioningClient, createDriveServerClient };

package/dist/server.js

@@ -327,6 +327,101 @@ const MAX_UPLOAD_BYTE_LENGTH$1 = 33554432e4;
 const UPLOAD_PART_BYTE_LENGTH$1 = 32 * 1024 * 1024;
 const CONTENT_DIGEST$1 = /^sha256:[0-9a-f]{64}$/;
 const UTF8 = new TextEncoder();
+function isWorkspaceUsage(value) {
+	if (!isExactRecord(value, [
+		"workspaceId",
+		"provider",
+		"usedBytes",
+		"reservedBytes",
+		"limitBytes",
+		"availableBytes",
+		"accounting",
+		"reservedBytesIncludeUnresolvedUploads",
+		"unresolvedReservedBytes",
+		"warnings"
+	]) || typeof value.workspaceId !== "string" || !WORKSPACE_ID$1.test(value.workspaceId) || value.provider !== "managed" || value.accounting !== "current-versions-and-reservations" || value.reservedBytesIncludeUnresolvedUploads !== true || !Array.isArray(value.warnings) || value.warnings.length > 1 || value.warnings.some((warning) => warning !== "unresolved-archive-ownership") || ![
+		value.usedBytes,
+		value.reservedBytes,
+		value.limitBytes,
+		value.availableBytes,
+		value.unresolvedReservedBytes
+	].every((bytes) => typeof bytes === "string" && /^(0|[1-9][0-9]{0,18})$/.test(bytes))) return false;
+	const available = BigInt(value.limitBytes) - BigInt(value.usedBytes) - BigInt(value.reservedBytes);
+	const valid = BigInt(value.availableBytes) === (available > 0n ? available : 0n) && BigInt(value.unresolvedReservedBytes) <= BigInt(value.reservedBytes) && (value.unresolvedReservedBytes === "0" || value.warnings.length === 1);
+	if (valid) Object.freeze(value.warnings);
+	return valid;
+}
+function isWorkspaceDiscoveryPage(value) {
+	if (!isExactRecord(value, ["items", "nextCursor"]) || !Array.isArray(value.items) || value.items.length > 50 || !(value.nextCursor === null || typeof value.nextCursor === "string" && value.nextCursor.length > 0 && value.nextCursor.length <= 2048 && /^[A-Za-z0-9_.-]+$/.test(value.nextCursor)) || value.items.length === 0 && value.nextCursor !== null) return false;
+	const ids = new Set();
+	const valid = value.items.every((item) => {
+		if (!isExactRecord(item, [
+			"workspaceId",
+			"itemId",
+			"parentId",
+			"type",
+			"name",
+			"lifecycleState",
+			"revision",
+			"currentVersion",
+			"volumeId",
+			"provider",
+			"createdAtEpochMilliseconds",
+			"modifiedAtEpochMilliseconds",
+			"creatorUserId",
+			"etag",
+			"trashedAtEpochMilliseconds",
+			"purgeAfterEpochMilliseconds"
+		]) || item.lifecycleState !== "active" && item.lifecycleState !== "trashed" || typeof item.volumeId !== "string" || !VOLUME_ID.test(item.volumeId) || item.provider !== "managed" || item.creatorUserId !== null && (typeof item.creatorUserId !== "string" || !AUTH_ID$1.test(item.creatorUserId)) || ![
+			item.createdAtEpochMilliseconds,
+			item.modifiedAtEpochMilliseconds,
+			item.trashedAtEpochMilliseconds,
+			item.purgeAfterEpochMilliseconds
+		].every((date) => date === null || isSafeInteger$1(date))) return false;
+		const metadata = {
+			workspaceId: item.workspaceId,
+			itemId: item.itemId,
+			parentId: item.parentId,
+			type: item.type,
+			name: item.name,
+			lifecycleState: "active",
+			revision: item.revision,
+			currentVersion: item.currentVersion
+		};
+		if (typeof metadata.workspaceId !== "string" || !WORKSPACE_ID$1.test(metadata.workspaceId) || typeof metadata.itemId !== "string" || !ITEM_ID$1.test(metadata.itemId) || metadata.parentId === null || metadata.parentId === metadata.itemId || !isManagedItemMetadata(metadata, metadata.workspaceId, metadata.itemId) || item.etag !== `"drive.item.v1.${metadata.revision}"` || ids.has(metadata.itemId)) return false;
+		if (item.lifecycleState === "active" ? item.trashedAtEpochMilliseconds !== null || item.purgeAfterEpochMilliseconds !== null : !isSafeInteger$1(item.trashedAtEpochMilliseconds) || !isSafeInteger$1(item.purgeAfterEpochMilliseconds) || item.purgeAfterEpochMilliseconds <= item.trashedAtEpochMilliseconds) return false;
+		ids.add(metadata.itemId);
+		return true;
+	});
+	if (valid) {
+		for (const item of value.items) Object.freeze(item);
+		Object.freeze(value.items);
+		Object.freeze(value);
+	}
+	return valid;
+}
+function isCurrentWorkspaceSources(value) {
+	if (!isExactRecord(value, [
+		"workspace",
+		"volumes",
+		"knownProviders",
+		"externalConnectionsSupported"
+	]) || !isCurrentWorkspace(value.workspace) || !Array.isArray(value.volumes) || value.volumes.length !== 1 || !Array.isArray(value.knownProviders) || value.externalConnectionsSupported !== false) return false;
+	const volume = value.volumes[0];
+	const providers = [
+		"managed",
+		"google-drive",
+		"onedrive",
+		"dropbox",
+		"s3-compatible"
+	];
+	return isExactRecord(volume, [
+		"volumeId",
+		"rootItemId",
+		"provider",
+		"name"
+	]) && volume.volumeId === value.workspace.rootVolumeId && volume.rootItemId === value.workspace.rootItemId && volume.provider === "managed" && volume.name === "Files" && value.knownProviders.length === providers.length && value.knownProviders.every((provider, index) => provider === providers[index]);
+}
 function isCurrentWorkspace(value) {
 	if (!isExactRecord(value, [
 		"workspaceId",
@@ -846,6 +941,29 @@ function validateCurrentWorkspaceInput(value) {
 	const signal = validateSignal(captureRecord(value === void 0 ? {} : value, [], ["signal"]).signal);
 	return signal === void 0 ? {} : { signal };
 }
+function validateWorkspaceDiscoveryInput(value, list) {
+	const input = captureRecord(value, ["workspaceId"], list ? [
+		"signal",
+		"view",
+		"kind",
+		"creatorUserId",
+		"limit",
+		"cursor"
+	] : ["signal"]);
+	const signal = validateSignal(input.signal);
+	if (typeof input.workspaceId !== "string" || !WORKSPACE_ID.test(input.workspaceId) || input.view !== void 0 && input.view !== "recent" && input.view !== "shared" && input.view !== "trash" || input.kind !== void 0 && input.kind !== "file" && input.kind !== "folder" || input.creatorUserId !== void 0 && (typeof input.creatorUserId !== "string" || !AUTH_ID.test(input.creatorUserId)) || input.limit !== void 0 && (typeof input.limit !== "number" || !Number.isInteger(input.limit) || input.limit < 1 || input.limit > 50) || input.cursor !== void 0 && (typeof input.cursor !== "string" || input.cursor.length < 1 || input.cursor.length > 2048 || !/^[A-Za-z0-9_.-]+$/.test(input.cursor))) throw new DriveError("invalid_input");
+	return {
+		workspaceId: input.workspaceId,
+		signal,
+		query: {
+			...input.view === void 0 ? {} : { view: input.view },
+			...input.kind === void 0 ? {} : { kind: input.kind },
+			...input.creatorUserId === void 0 ? {} : { creatorUserId: input.creatorUserId },
+			...input.limit === void 0 ? {} : { limit: input.limit },
+			...input.cursor === void 0 ? {} : { cursor: input.cursor }
+		}
+	};
+}
 function validateResourceInput(value) {
 	const input = captureRecord(value, ["workspaceId", "itemId"], ["signal"]);
 	const workspaceId = input.workspaceId;
@@ -1983,6 +2101,9 @@ function createDriveClientInternal(config) {
 function createDriveOperations(runtime) {
 	return Object.freeze({
 		getCurrentWorkspace: (input) => getCurrentWorkspace(runtime, input),
+		listWorkspaceItems: (input) => listWorkspaceItems(runtime, input),
+		getWorkspaceUsage: (input) => getWorkspaceUsage(runtime, input),
+		getCurrentWorkspaceSources: (input) => getCurrentWorkspaceSources(runtime, input),
 		getItem: (input) => getItem(runtime, input),
 		searchWorkspaceItems: (input) => searchWorkspaceItems(runtime, input),
 		listFolderChildren: (input) => listFolderChildren(runtime, input),
@@ -2181,6 +2302,29 @@ function streamWithOperationLifetime(source, expectedLength, signal) {
 		}
 	});
 }
+async function getCurrentWorkspaceSources(runtime, input) {
+	return execute(runtime, validateCurrentWorkspaceInput(input).signal, null, (api, requestOptions) => api.GET("/api/v1/workspaces/current/sources", {
+		...operationOptions("getCurrentWorkspaceSources", { params: {} }),
+		...requestOptions
+	}), [200], isCurrentWorkspaceSources, false, CURRENT_WORKSPACE_ERROR_CODES);
+}
+async function listWorkspaceItems(runtime, input) {
+	const validated = validateWorkspaceDiscoveryInput(input, true);
+	return execute(runtime, validated.signal, null, (api, options) => api.GET("/api/v1/workspaces/{workspaceId}/items", {
+		...operationOptions("listWorkspaceItems", { params: {
+			path: { workspaceId: validated.workspaceId },
+			query: validated.query
+		} }),
+		...options
+	}), [200], (value) => isWorkspaceDiscoveryPage(value) && value.items.length <= (validated.query.limit ?? 25) && value.items.every((item, index, items) => item.workspaceId === validated.workspaceId && item.lifecycleState === (validated.query.view === "trash" ? "trashed" : "active") && ((validated.query.view ?? "recent") !== "recent" || item.modifiedAtEpochMilliseconds !== null) && (validated.query.kind === void 0 || item.type === validated.query.kind) && (validated.query.creatorUserId === void 0 || item.creatorUserId === validated.query.creatorUserId) && (index === 0 || ((validated.query.view ?? "recent") === "recent" ? items[index - 1].modifiedAtEpochMilliseconds > item.modifiedAtEpochMilliseconds || items[index - 1].modifiedAtEpochMilliseconds === item.modifiedAtEpochMilliseconds && items[index - 1].itemId < item.itemId : items[index - 1].itemId < item.itemId))), false, SEARCH_WORKSPACE_ITEMS_ERROR_CODES);
+}
+async function getWorkspaceUsage(runtime, input) {
+	const validated = validateWorkspaceDiscoveryInput(input, false);
+	return execute(runtime, validated.signal, null, (api, options) => api.GET("/api/v1/workspaces/{workspaceId}/usage", {
+		...operationOptions("getWorkspaceUsage", { params: { path: { workspaceId: validated.workspaceId } } }),
+		...options
+	}), [200], (value) => isWorkspaceUsage(value) && value.workspaceId === validated.workspaceId, false, SEARCH_WORKSPACE_ITEMS_ERROR_CODES);
+}
 async function getCurrentWorkspace(runtime, input) {
 	return execute(runtime, validateCurrentWorkspaceInput(input).signal, null, (api, requestOptions) => api.GET("/api/v1/workspaces/current", {
 		...operationOptions("getCurrentWorkspace", { params: {} }),

package/dist/types.d.ts

@@ -1,2 +1,2 @@
-import { $ as TrashItemInput, A as ListItemVersionsInput, B as PermissionAction, C as FolderPage, D as GetUploadStatusInput, E as GetItemVersionInput, F as ManagedItemVersionPage, G as ProtectionClassification, H as PermissionGrantee, I as ManagedItemVersionResource, J as RecordUploadPartInput, K as ReadEffectiveItemPermissionsInput, L as ManagedItemVersionRestoreResult, M as ManagedDownloadRestorePending, N as ManagedItemMetadata, O as ListFolderChildrenInput, P as ManagedItemVersion, Q as SearchWorkspaceItemsInput, R as ManagedLifecycleItem, S as FolderItem, T as GetItemInput, U as PermissionMutation, V as PermissionGrant, W as PermissionPage, X as RestoreItemVersionInput, Y as RestoreItemInput, Z as RevokeItemPermissionInput, _ as DriveResponseValidators, a as CreateItemPermissionInput, at as UploadFilePhase, b as EffectivePermissionAction, c as CurrentWorkspace, ct as UploadPartDescriptor, d as DriveClient, dt as UploadStatus, et as UpdateItemInput, f as DriveClientConfig, ft as WorkspaceItemSearchItem, g as DriveOperations, h as DriveOperationResult, i as CreateFolderInput, it as UploadFileInput, j as ManagedDownloadDescriptor, k as ListItemPermissionsInput, l as DeleteItemInput, lt as UploadPartResult, m as DriveCredentialProvider, n as CompleteUploadInput, nt as UploadCompletion, o as CreateUploadInput, ot as UploadFileProgress, p as DriveCredentialContext, pt as WorkspaceItemSearchPage, q as ReadyUpload, r as CreateDownloadInput, rt as UploadConfirmedPart, s as CreateUploadPartDescriptorInput, st as UploadFileProgressCallback, t as AbortUploadInput, tt as UpdateItemPermissionInput, u as DownloadItemResult, ut as UploadSession, v as DriveServerClient, w as GetCurrentWorkspaceInput, x as EffectivePermissionResponse, y as DriveServerClientConfig, z as PendingUpload } from "./contract.js";
-export { AbortUploadInput, CompleteUploadInput, CreateDownloadInput, CreateFolderInput, CreateItemPermissionInput, CreateUploadInput, CreateUploadPartDescriptorInput, CurrentWorkspace, DeleteItemInput, DownloadItemResult, DriveClient, DriveClientConfig, DriveCredentialContext, DriveCredentialProvider, DriveOperationResult, DriveOperations, DriveResponseValidators, DriveServerClient, DriveServerClientConfig, EffectivePermissionAction, EffectivePermissionResponse, FolderItem, FolderPage, GetCurrentWorkspaceInput, GetItemInput, GetItemVersionInput, GetUploadStatusInput, ListFolderChildrenInput, ListItemPermissionsInput, ListItemVersionsInput, ManagedDownloadDescriptor, ManagedDownloadRestorePending, ManagedItemMetadata, ManagedItemVersion, ManagedItemVersionPage, ManagedItemVersionResource, ManagedItemVersionRestoreResult, ManagedLifecycleItem, PendingUpload, PermissionAction, PermissionGrant, PermissionGrantee, PermissionMutation, PermissionPage, ProtectionClassification, ReadEffectiveItemPermissionsInput, ReadyUpload, RecordUploadPartInput, RestoreItemInput, RestoreItemVersionInput, RevokeItemPermissionInput, SearchWorkspaceItemsInput, TrashItemInput, UpdateItemInput, UpdateItemPermissionInput, UploadCompletion, UploadConfirmedPart, UploadFileInput, UploadFilePhase, UploadFileProgress, UploadFileProgressCallback, UploadPartDescriptor, UploadPartResult, UploadSession, UploadStatus, WorkspaceItemSearchItem, WorkspaceItemSearchPage };
+import { $ as RestoreItemVersionInput, A as ListFolderChildrenInput, B as ManagedItemVersionRestoreResult, C as FolderItem, D as GetItemVersionInput, E as GetItemInput, F as ManagedDownloadRestorePending, G as PermissionGrantee, H as PendingUpload, I as ManagedItemMetadata, J as ProtectionClassification, K as PermissionMutation, L as ManagedItemVersion, M as ListItemVersionsInput, N as ListWorkspaceItemsInput, O as GetUploadStatusInput, P as ManagedDownloadDescriptor, Q as RestoreItemInput, R as ManagedItemVersionPage, S as EffectivePermissionResponse, T as GetCurrentWorkspaceInput, U as PermissionAction, V as ManagedLifecycleItem, W as PermissionGrant, X as ReadyUpload, Y as ReadEffectiveItemPermissionsInput, Z as RecordUploadPartInput, _ as DriveOperations, _t as WorkspaceItemSearchItem, a as CreateItemPermissionInput, at as UploadCompletion, b as DriveServerClientConfig, c as CurrentWorkspace, ct as UploadFilePhase, d as DownloadItemResult, dt as UploadPartDescriptor, et as RevokeItemPermissionInput, f as DriveClient, ft as UploadPartResult, g as DriveOperationResult, gt as WorkspaceDiscoveryPage, h as DriveCredentialProvider, ht as WorkspaceDiscoveryItem, i as CreateFolderInput, it as UpdateItemPermissionInput, j as ListItemPermissionsInput, k as GetWorkspaceUsageInput, l as CurrentWorkspaceSources, lt as UploadFileProgress, m as DriveCredentialContext, mt as UploadStatus, n as CompleteUploadInput, nt as TrashItemInput, o as CreateUploadInput, ot as UploadConfirmedPart, p as DriveClientConfig, pt as UploadSession, q as PermissionPage, r as CreateDownloadInput, rt as UpdateItemInput, s as CreateUploadPartDescriptorInput, st as UploadFileInput, t as AbortUploadInput, tt as SearchWorkspaceItemsInput, u as DeleteItemInput, ut as UploadFileProgressCallback, v as DriveResponseValidators, vt as WorkspaceItemSearchPage, w as FolderPage, x as EffectivePermissionAction, y as DriveServerClient, yt as WorkspaceUsage, z as ManagedItemVersionResource } from "./contract.js";
+export { AbortUploadInput, CompleteUploadInput, CreateDownloadInput, CreateFolderInput, CreateItemPermissionInput, CreateUploadInput, CreateUploadPartDescriptorInput, CurrentWorkspace, CurrentWorkspaceSources, DeleteItemInput, DownloadItemResult, DriveClient, DriveClientConfig, DriveCredentialContext, DriveCredentialProvider, DriveOperationResult, DriveOperations, DriveResponseValidators, DriveServerClient, DriveServerClientConfig, EffectivePermissionAction, EffectivePermissionResponse, FolderItem, FolderPage, GetCurrentWorkspaceInput, GetItemInput, GetItemVersionInput, GetUploadStatusInput, GetWorkspaceUsageInput, ListFolderChildrenInput, ListItemPermissionsInput, ListItemVersionsInput, ListWorkspaceItemsInput, ManagedDownloadDescriptor, ManagedDownloadRestorePending, ManagedItemMetadata, ManagedItemVersion, ManagedItemVersionPage, ManagedItemVersionResource, ManagedItemVersionRestoreResult, ManagedLifecycleItem, PendingUpload, PermissionAction, PermissionGrant, PermissionGrantee, PermissionMutation, PermissionPage, ProtectionClassification, ReadEffectiveItemPermissionsInput, ReadyUpload, RecordUploadPartInput, RestoreItemInput, RestoreItemVersionInput, RevokeItemPermissionInput, SearchWorkspaceItemsInput, TrashItemInput, UpdateItemInput, UpdateItemPermissionInput, UploadCompletion, UploadConfirmedPart, UploadFileInput, UploadFilePhase, UploadFileProgress, UploadFileProgressCallback, UploadPartDescriptor, UploadPartResult, UploadSession, UploadStatus, WorkspaceDiscoveryItem, WorkspaceDiscoveryPage, WorkspaceItemSearchItem, WorkspaceItemSearchPage, WorkspaceUsage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finueva/drive",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Public browser, Worker, and Node client for Finueva Drive",
   "type": "module",
   "types": "./dist/index.d.ts",