@finueva/drive 0.1.0

package/dist/contract.d.ts

@@ -0,0 +1,2101 @@
+//#region src/generated/openapi.d.ts
+interface operations {
+  listFolderChildren: {
+    parameters: {
+      query?: {
+        limit?: number;
+        cursor?: string;
+      };
+      header?: never;
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description At most 50 active children in stable item-ID order. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            items: {
+              itemId: string;
+              /** @enum {string} */
+              kind: "file" | "folder";
+              /**
+               * Format: finueva-safe-filename
+               * @description NFC-normalized filename of at most 255 Unicode code points and 255 UTF-8 bytes. Slash, backslash, control characters, U+2028/U+2029, trailing dot/space, dot entries, and Windows reserved base names are forbidden.
+               */
+              name: string;
+              parentItemId: string;
+              revision: number;
+              /** @enum {string} */
+              visibility: "workspace" | "restricted";
+              volumeId: string;
+              workspaceId: string;
+            }[];
+            nextCursor: string | null;
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "authentication_required";
+              /** @enum {string} */
+              message?: "Authentication is required.";
+            };
+          };
+        };
+      };
+      /** @description Managed storage is disabled for the canonical workspace entitlement. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "permission_denied";
+              /** @enum {string} */
+              message?: "The requested action is not permitted.";
+            };
+          };
+        };
+      };
+      /** @description The parent is absent or undiscoverable. */
+      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 Folder authority changed after preflight. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, or cursor is invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "invalid_request";
+              /** @enum {string} */
+              message?: "The request is invalid.";
+            };
+          }) | {
+            error: {
+              /** @enum {string} */
+              code: "invalid_pagination_cursor";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The pagination cursor is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity authority, D1, authorization evidence, or required cursor keys are unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "identity_authority_unavailable";
+              /** @enum {string} */
+              message?: "Authentication is temporarily unavailable.";
+            };
+          }) | ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "service_unavailable";
+              /** @enum {string} */
+              message?: "The service is temporarily unavailable.";
+            };
+          });
+        };
+      };
+    };
+  };
+  createFolder: {
+    parameters: {
+      query?: never;
+      header: {
+        "Idempotency-Key": string;
+      };
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          /**
+           * Format: finueva-safe-filename
+           * @description NFC-normalized filename of at most 255 Unicode code points and 255 UTF-8 bytes. Slash, backslash, control characters, U+2028/U+2029, trailing dot/space, dot entries, and Windows reserved base names are forbidden.
+           */
+          name: string;
+        };
+      };
+    };
+    responses: {
+      /** @description The exact committed folder is replayed. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            itemId: string;
+            /** @enum {string} */
+            kind: "file" | "folder";
+            /**
+             * Format: finueva-safe-filename
+             * @description NFC-normalized filename of at most 255 Unicode code points and 255 UTF-8 bytes. Slash, backslash, control characters, U+2028/U+2029, trailing dot/space, dot entries, and Windows reserved base names are forbidden.
+             */
+            name: string;
+            parentItemId: string;
+            revision: number;
+            /** @enum {string} */
+            visibility: "workspace" | "restricted";
+            volumeId: string;
+            workspaceId: string;
+          };
+        };
+      };
+      /** @description The folder is committed. */
+      201: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            itemId: string;
+            /** @enum {string} */
+            kind: "file" | "folder";
+            /**
+             * Format: finueva-safe-filename
+             * @description NFC-normalized filename of at most 255 Unicode code points and 255 UTF-8 bytes. Slash, backslash, control characters, U+2028/U+2029, trailing dot/space, dot entries, and Windows reserved base names are forbidden.
+             */
+            name: string;
+            parentItemId: string;
+            revision: number;
+            /** @enum {string} */
+            visibility: "workspace" | "restricted";
+            volumeId: string;
+            workspaceId: string;
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "authentication_required";
+              /** @enum {string} */
+              message?: "Authentication is required.";
+            };
+          };
+        };
+      };
+      /** @description The discoverable parent does not permit folder creation. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "permission_denied";
+              /** @enum {string} */
+              message?: "The requested action is not permitted.";
+            };
+          };
+        };
+      };
+      /** @description The parent is absent or undiscoverable. */
+      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 The idempotency key conflicts or folder authority changed after preflight. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "idempotency_conflict";
+              /** @enum {string} */
+              message?: "The idempotency key conflicts with an earlier request.";
+            };
+          }) | {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, idempotency key, body, or name is invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "invalid_request";
+              /** @enum {string} */
+              message?: "The request is invalid.";
+            };
+          }) | {
+            error: {
+              /** @enum {string} */
+              code: "invalid_idempotency_key";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity authority, D1, authorization evidence, or trusted capacity evidence is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "identity_authority_unavailable";
+              /** @enum {string} */
+              message?: "Authentication is temporarily unavailable.";
+            };
+          }) | ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "service_unavailable";
+              /** @enum {string} */
+              message?: "The service is temporarily unavailable.";
+            };
+          });
+        };
+      };
+    };
+  };
+  listItemPermissions: {
+    parameters: {
+      query?: {
+        limit?: number;
+        cursor?: string;
+      };
+      header?: never;
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description A stable permission page. */
+      200: {
+        headers: {
+          /** @description Current direct collection precondition for POST on this item. */
+          "Drive-Permission-Collection-ETag"?: string;
+          /** @description Strong validator for the exact returned permission-list representation. */
+          ETag?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            collectionEtag: string;
+            collectionRevision: number;
+            items: {
+              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+              /** @enum {string} */
+              availability: "active" | "expired" | "revoked";
+              etag: string;
+              expiresAtEpochMilliseconds: number | null;
+              grantId: string;
+              grantee: {
+                /** @enum {string} */
+                type: "user";
+                userId: string;
+              } | {
+                teamId: string;
+                /** @enum {string} */
+                type: "team";
+              };
+              revision: number;
+              /** @enum {string} */
+              source: "direct" | "inherited";
+              sourceItemId: string;
+            }[];
+            nextCursor: string | null;
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "authentication_required";
+              /** @enum {string} */
+              message?: "Authentication is required.";
+            };
+          };
+        };
+      };
+      /** @description The discoverable item does not permit this permission operation. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "permission_denied";
+              /** @enum {string} */
+              message?: "The requested action is not permitted.";
+            };
+          };
+        };
+      };
+      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      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 The supplied revision or post-preflight authority is stale. */
+      412: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, headers, or pagination cursor are invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "invalid_request";
+              /** @enum {string} */
+              message?: "The request is invalid.";
+            };
+          }) | {
+            error: {
+              /** @enum {string} */
+              code: "invalid_pagination_cursor";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The pagination cursor is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "identity_authority_unavailable";
+              /** @enum {string} */
+              message?: "Authentication is temporarily unavailable.";
+            };
+          }) | ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "service_unavailable";
+              /** @enum {string} */
+              message?: "The service is temporarily unavailable.";
+            };
+          });
+        };
+      };
+    };
+  };
+  createItemPermission: {
+    parameters: {
+      query?: never;
+      header: {
+        "Idempotency-Key": string;
+        "If-Match": string;
+      };
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+          expiresAtEpochMilliseconds: number | null;
+          grantee: {
+            /** @enum {string} */
+            type: "user";
+            userId: string;
+          } | {
+            teamId: string;
+            /** @enum {string} */
+            type: "team";
+          };
+        };
+      };
+    };
+    responses: {
+      /** @description The exact committed result was replayed. */
+      200: {
+        headers: {
+          /** @description Current direct collection precondition for the next POST. */
+          "Drive-Permission-Collection-ETag"?: string;
+          /** @description Current direct-grant precondition for PATCH or DELETE; omitted when the current row is not mutable. */
+          "Drive-Permission-Grant-ETag"?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            collectionRevision: number;
+            grant: {
+              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+              /** @enum {string} */
+              availability: "active" | "expired" | "revoked";
+              expiresAtEpochMilliseconds: number | null;
+              grantId: string;
+              grantee: {
+                /** @enum {string} */
+                type: "user";
+                userId: string;
+              } | {
+                teamId: string;
+                /** @enum {string} */
+                type: "team";
+              };
+              revision: number;
+              /** @enum {string} */
+              source: "direct";
+              sourceItemId: string;
+            };
+            /** @enum {string} */
+            outcome: "committed" | "replayed";
+          };
+        };
+      };
+      /** @description The direct grant was committed. */
+      201: {
+        headers: {
+          /** @description Current direct collection precondition for the next POST. */
+          "Drive-Permission-Collection-ETag"?: string;
+          /** @description Current direct-grant precondition for PATCH or DELETE; omitted when the current row is not mutable. */
+          "Drive-Permission-Grant-ETag"?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            collectionRevision: number;
+            grant: {
+              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+              /** @enum {string} */
+              availability: "active" | "expired" | "revoked";
+              expiresAtEpochMilliseconds: number | null;
+              grantId: string;
+              grantee: {
+                /** @enum {string} */
+                type: "user";
+                userId: string;
+              } | {
+                teamId: string;
+                /** @enum {string} */
+                type: "team";
+              };
+              revision: number;
+              /** @enum {string} */
+              source: "direct";
+              sourceItemId: string;
+            };
+            /** @enum {string} */
+            outcome: "committed" | "replayed";
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "authentication_required";
+              /** @enum {string} */
+              message?: "Authentication is required.";
+            };
+          };
+        };
+      };
+      /** @description The discoverable item does not permit this permission operation. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "permission_denied";
+              /** @enum {string} */
+              message?: "The requested action is not permitted.";
+            };
+          };
+        };
+      };
+      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      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 The idempotency key was reused for a different semantic request. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "idempotency_conflict";
+              /** @enum {string} */
+              message?: "The idempotency key conflicts with an earlier request.";
+            };
+          };
+        };
+      };
+      /** @description The supplied revision or post-preflight authority is stale. */
+      412: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, headers, idempotency key, or body are invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "invalid_request";
+              /** @enum {string} */
+              message?: "The request is invalid.";
+            };
+          }) | {
+            error: {
+              /** @enum {string} */
+              code: "invalid_idempotency_key";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "identity_authority_unavailable";
+              /** @enum {string} */
+              message?: "Authentication is temporarily unavailable.";
+            };
+          }) | ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "service_unavailable";
+              /** @enum {string} */
+              message?: "The service is temporarily unavailable.";
+            };
+          });
+        };
+      };
+    };
+  };
+  readEffectiveItemPermissions: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description All seven caller-specific item actions. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            actions: {
+              /** @enum {string} */
+              action: "items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:manage" | "items:permissions:read" | "items:update";
+              allowed: boolean;
+              basis: ("workspace_visibility" | "restricted_administrator_bypass" | "direct_grant" | "inherited_grant") | null;
+              grantId: string | null;
+              sourceItemId: string | null;
+            }[] & (unknown & unknown & unknown & unknown & unknown & unknown & unknown);
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "authentication_required";
+              /** @enum {string} */
+              message?: "Authentication is required.";
+            };
+          };
+        };
+      };
+      /** @description The discoverable item does not permit this permission operation. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "permission_denied";
+              /** @enum {string} */
+              message?: "The requested action is not permitted.";
+            };
+          };
+        };
+      };
+      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      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 The supplied revision or post-preflight authority is stale. */
+      412: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, headers, or body are invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "invalid_request";
+              /** @enum {string} */
+              message?: "The request is invalid.";
+            };
+          };
+        };
+      };
+      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "identity_authority_unavailable";
+              /** @enum {string} */
+              message?: "Authentication is temporarily unavailable.";
+            };
+          }) | ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "service_unavailable";
+              /** @enum {string} */
+              message?: "The service is temporarily unavailable.";
+            };
+          });
+        };
+      };
+    };
+  };
+  revokeItemPermission: {
+    parameters: {
+      query?: never;
+      header: {
+        "Idempotency-Key": string;
+        "If-Match": string;
+      };
+      path: {
+        workspaceId: string;
+        itemId: string;
+        grantId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description The retained revoked grant was committed, replayed, or unchanged. */
+      200: {
+        headers: {
+          /** @description Current direct collection precondition for POST. */
+          "Drive-Permission-Collection-ETag"?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            collectionRevision: number;
+            grant: {
+              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+              /** @enum {string} */
+              availability: "active" | "expired" | "revoked";
+              expiresAtEpochMilliseconds: number | null;
+              grantId: string;
+              grantee: {
+                /** @enum {string} */
+                type: "user";
+                userId: string;
+              } | {
+                teamId: string;
+                /** @enum {string} */
+                type: "team";
+              };
+              revision: number;
+              /** @enum {string} */
+              source: "direct";
+              sourceItemId: string;
+            };
+            /** @enum {string} */
+            outcome: "committed" | "replayed";
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "authentication_required";
+              /** @enum {string} */
+              message?: "Authentication is required.";
+            };
+          };
+        };
+      };
+      /** @description The discoverable item does not permit this permission operation. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "permission_denied";
+              /** @enum {string} */
+              message?: "The requested action is not permitted.";
+            };
+          };
+        };
+      };
+      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      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 The idempotency key was reused for a different semantic request. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "idempotency_conflict";
+              /** @enum {string} */
+              message?: "The idempotency key conflicts with an earlier request.";
+            };
+          };
+        };
+      };
+      /** @description The supplied revision or post-preflight authority is stale. */
+      412: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, headers, idempotency key, or body are invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "invalid_request";
+              /** @enum {string} */
+              message?: "The request is invalid.";
+            };
+          }) | {
+            error: {
+              /** @enum {string} */
+              code: "invalid_idempotency_key";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "identity_authority_unavailable";
+              /** @enum {string} */
+              message?: "Authentication is temporarily unavailable.";
+            };
+          }) | ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "service_unavailable";
+              /** @enum {string} */
+              message?: "The service is temporarily unavailable.";
+            };
+          });
+        };
+      };
+    };
+  };
+  updateItemPermission: {
+    parameters: {
+      query?: never;
+      header: {
+        "Idempotency-Key": string;
+        "If-Match": string;
+      };
+      path: {
+        workspaceId: string;
+        itemId: string;
+        grantId: string;
+      };
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          actions?: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+          expiresAtEpochMilliseconds?: number | null;
+        };
+      };
+    };
+    responses: {
+      /** @description The direct grant was committed or replayed. */
+      200: {
+        headers: {
+          /** @description Current direct collection precondition for POST. */
+          "Drive-Permission-Collection-ETag"?: string;
+          /** @description Current direct-grant precondition for the next PATCH or DELETE; omitted when the current row is not mutable. */
+          "Drive-Permission-Grant-ETag"?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            collectionRevision: number;
+            grant: {
+              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+              /** @enum {string} */
+              availability: "active" | "expired" | "revoked";
+              expiresAtEpochMilliseconds: number | null;
+              grantId: string;
+              grantee: {
+                /** @enum {string} */
+                type: "user";
+                userId: string;
+              } | {
+                teamId: string;
+                /** @enum {string} */
+                type: "team";
+              };
+              revision: number;
+              /** @enum {string} */
+              source: "direct";
+              sourceItemId: string;
+            };
+            /** @enum {string} */
+            outcome: "committed" | "replayed";
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "authentication_required";
+              /** @enum {string} */
+              message?: "Authentication is required.";
+            };
+          };
+        };
+      };
+      /** @description The discoverable item does not permit this permission operation. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "permission_denied";
+              /** @enum {string} */
+              message?: "The requested action is not permitted.";
+            };
+          };
+        };
+      };
+      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      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 The idempotency key was reused for a different semantic request. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "idempotency_conflict";
+              /** @enum {string} */
+              message?: "The idempotency key conflicts with an earlier request.";
+            };
+          };
+        };
+      };
+      /** @description The supplied revision or post-preflight authority is stale. */
+      412: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, headers, idempotency key, or body are invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "invalid_request";
+              /** @enum {string} */
+              message?: "The request is invalid.";
+            };
+          }) | {
+            error: {
+              /** @enum {string} */
+              code: "invalid_idempotency_key";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "identity_authority_unavailable";
+              /** @enum {string} */
+              message?: "Authentication is temporarily unavailable.";
+            };
+          }) | ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "service_unavailable";
+              /** @enum {string} */
+              message?: "The service is temporarily unavailable.";
+            };
+          });
+        };
+      };
+    };
+  };
+  createUpload: {
+    parameters: {
+      query?: never;
+      header: {
+        "Idempotency-Key": string;
+      };
+      path: {
+        workspaceId: string;
+      };
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          expectedByteLength: number;
+          parentItemId: string;
+        };
+      };
+    };
+    responses: {
+      /** @description The exact retained reservation is replayed. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            createdAtEpochMilliseconds: number;
+            expectedByteLength: number;
+            expiresAtEpochMilliseconds: number;
+            parentItemId: string;
+            /** @enum {string} */
+            state: "reserved";
+            terminalAtEpochMilliseconds: null;
+            terminalReason: null;
+            uploadId: string;
+            workspaceId: string;
+          };
+        };
+      };
+      /** @description Quota and mandatory D1 capacity are reserved. */
+      201: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            createdAtEpochMilliseconds: number;
+            expectedByteLength: number;
+            expiresAtEpochMilliseconds: number;
+            parentItemId: string;
+            /** @enum {string} */
+            state: "reserved";
+            terminalAtEpochMilliseconds: null;
+            terminalReason: null;
+            uploadId: string;
+            workspaceId: string;
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "authentication_required";
+              /** @enum {string} */
+              message?: "Authentication is required.";
+            };
+          };
+        };
+      };
+      /** @description Managed storage is disabled or the discoverable parent does not permit item creation. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "permission_denied";
+              /** @enum {string} */
+              message?: "The requested action is not permitted.";
+            };
+          };
+        };
+      };
+      /** @description The parent is absent or undiscoverable. */
+      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 Quota is exceeded, the key conflicts, or authority changed before commit. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": Record<string, never> & ({
+            error: {
+              /** @enum {string} */
+              code: "quota_exceeded";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The workspace storage quota would be exceeded.";
+              requestId: string;
+            };
+          } | ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "idempotency_conflict";
+              /** @enum {string} */
+              message?: "The idempotency key conflicts with an earlier request.";
+            };
+          }) | {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          });
+        };
+      };
+      /** @description The path, key, media type, or strict request body is invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": Record<string, never> & (({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "invalid_request";
+              /** @enum {string} */
+              message?: "The request is invalid.";
+            };
+          }) | {
+            error: {
+              /** @enum {string} */
+              code: "invalid_idempotency_key";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key is invalid.";
+              requestId: string;
+            };
+          });
+        };
+      };
+      /** @description Identity, D1, authorization, entitlement, or trusted capacity authority is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": Record<string, never> & (({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "identity_authority_unavailable";
+              /** @enum {string} */
+              message?: "Authentication is temporarily unavailable.";
+            };
+          }) | ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "service_unavailable";
+              /** @enum {string} */
+              message?: "The service is temporarily unavailable.";
+            };
+          }));
+        };
+      };
+    };
+  };
+  abortUpload: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        workspaceId: string;
+        uploadId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description The reservation is released or its exact abort is replayed. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            createdAtEpochMilliseconds: number;
+            expectedByteLength: number;
+            expiresAtEpochMilliseconds: number;
+            parentItemId: string;
+            /** @enum {string} */
+            state: "released";
+            terminalAtEpochMilliseconds: number;
+            /** @enum {string} */
+            terminalReason: "aborted";
+            uploadId: string;
+            workspaceId: string;
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "authentication_required";
+              /** @enum {string} */
+              message?: "Authentication is required.";
+            };
+          };
+        };
+      };
+      /** @description The retained parent is discoverable but no longer permits item creation. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "permission_denied";
+              /** @enum {string} */
+              message?: "The requested action is not permitted.";
+            };
+          };
+        };
+      };
+      /** @description The upload is unknown, cross-workspace, or its retained parent is undiscoverable. */
+      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 Another terminal settlement won or parent authority changed before commit. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, or unexpected request body is invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "invalid_request";
+              /** @enum {string} */
+              message?: "The request is invalid.";
+            };
+          };
+        };
+      };
+      /** @description Identity, D1, authorization, or retained capacity authority is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": Record<string, never> & (({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "identity_authority_unavailable";
+              /** @enum {string} */
+              message?: "Authentication is temporarily unavailable.";
+            };
+          }) | ({
+            error: {
+              code: string;
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } & {
+            error?: {
+              /** @enum {string} */
+              code?: "service_unavailable";
+              /** @enum {string} */
+              message?: "The service is temporarily unavailable.";
+            };
+          }));
+        };
+      };
+    };
+  };
+}
+//#endregion
+//#region src/types.d.ts
+type JsonResponse<Name extends keyof operations, Status extends keyof operations[Name]["responses"]> = operations[Name]["responses"][Status] extends {
+  content: {
+    "application/json": infer Body;
+  };
+} ? Body : never;
+type JsonRequest<Name extends keyof operations> = operations[Name] extends {
+  requestBody: {
+    content: {
+      "application/json": infer Body;
+    };
+  };
+} ? Body : never;
+type ResourcePath = operations["listFolderChildren"]["parameters"]["path"];
+type PageQuery = NonNullable<operations["listFolderChildren"]["parameters"]["query"]>;
+type CreateFolderBody = JsonRequest<"createFolder">;
+type CreatePermissionBody = JsonRequest<"createItemPermission">;
+type UpdatePermissionBody = JsonRequest<"updateItemPermission">;
+type CreateFolderHeaders = operations["createFolder"]["parameters"]["header"];
+type CreatePermissionHeaders = operations["createItemPermission"]["parameters"]["header"];
+type GrantMutationPath = operations["updateItemPermission"]["parameters"]["path"];
+type GrantMutationHeaders = operations["updateItemPermission"]["parameters"]["header"];
+type CreateUploadPath = operations["createUpload"]["parameters"]["path"];
+type CreateUploadHeaders = operations["createUpload"]["parameters"]["header"];
+type CreateUploadBody = JsonRequest<"createUpload">;
+type AbortUploadPath = operations["abortUpload"]["parameters"]["path"];
+type FolderItem = Readonly<JsonResponse<"createFolder", 201>>;
+type ReservedUploadQuota = Readonly<JsonResponse<"createUpload", 201>>;
+type AbortedUploadQuota = Readonly<JsonResponse<"abortUpload", 200>>;
+type UploadQuotaReservation = ReservedUploadQuota | AbortedUploadQuota;
+type PermissionAction = CreatePermissionBody["actions"][number];
+type PermissionGrantee = Readonly<CreatePermissionBody["grantee"]>;
+type GeneratedPermissionGrant = JsonResponse<"listItemPermissions", 200>["items"][number];
+type PermissionGrant = Readonly<Omit<GeneratedPermissionGrant, "actions" | "grantee"> & {
+  readonly actions: readonly PermissionAction[];
+  readonly grantee: PermissionGrantee;
+}>;
+type GeneratedPermissionMutation = JsonResponse<"createItemPermission", 201>;
+type PermissionMutation = Readonly<Omit<GeneratedPermissionMutation, "grant"> & {
+  readonly grant: Readonly<Omit<GeneratedPermissionMutation["grant"], "actions" | "grantee"> & {
+    readonly actions: readonly PermissionAction[];
+    readonly grantee: PermissionGrantee;
+  }>;
+}>;
+type GeneratedEffectivePermissionResponse = JsonResponse<"readEffectiveItemPermissions", 200>;
+type EffectivePermissionAction = Readonly<GeneratedEffectivePermissionResponse["actions"][number]>;
+type FolderPage = Readonly<Omit<JsonResponse<"listFolderChildren", 200>, "items"> & {
+  readonly items: readonly FolderItem[];
+}>;
+type PermissionPage = Readonly<Omit<JsonResponse<"listItemPermissions", 200>, "items"> & {
+  readonly items: readonly PermissionGrant[];
+}>;
+type EffectivePermissionResponse = Readonly<Omit<GeneratedEffectivePermissionResponse, "actions"> & {
+  readonly actions: readonly EffectivePermissionAction[];
+}>;
+interface DriveCredentialContext {
+  readonly signal: AbortSignal;
+}
+type DriveCredentialProvider = (context: DriveCredentialContext) => Promise<string>;
+interface DriveClientConfig {
+  readonly baseUrl: string;
+  readonly fetch?: typeof globalThis.fetch;
+  readonly getCredential: DriveCredentialProvider;
+  readonly timeoutMilliseconds?: number;
+}
+interface DriveServerClientConfig {
+  readonly baseUrl: string;
+  readonly fetch?: typeof globalThis.fetch;
+  readonly credential: string | DriveCredentialProvider;
+  readonly timeoutMilliseconds?: number;
+}
+interface DriveResponseValidators {
+  readonly etag?: string;
+  readonly permissionCollectionEtag?: string;
+  readonly permissionGrantEtag?: string;
+}
+interface DriveOperationResult<Data, Status extends number = number> {
+  readonly data: Data;
+  readonly status: Status;
+  readonly requestId: string;
+  readonly validators: DriveResponseValidators;
+}
+type ResourceInput = Readonly<ResourcePath> & {
+  readonly signal?: AbortSignal;
+};
+type PageInput = ResourceInput & Readonly<PageQuery>;
+type ListFolderChildrenInput = PageInput;
+type CreateFolderInput = ResourceInput & Readonly<CreateFolderBody> & {
+  readonly idempotencyKey: CreateFolderHeaders["Idempotency-Key"];
+};
+type ListItemPermissionsInput = PageInput;
+type ReadEffectiveItemPermissionsInput = ResourceInput;
+type CreateItemPermissionInput = ResourceInput & Readonly<Omit<CreatePermissionBody, "actions" | "grantee">> & {
+  readonly actions: readonly PermissionAction[];
+  readonly grantee: PermissionGrantee;
+  readonly ifMatch: CreatePermissionHeaders["If-Match"];
+  readonly idempotencyKey: CreatePermissionHeaders["Idempotency-Key"];
+};
+type GrantMutationInput = ResourceInput & Readonly<Pick<GrantMutationPath, "grantId">> & {
+  readonly ifMatch: GrantMutationHeaders["If-Match"];
+  readonly idempotencyKey: GrantMutationHeaders["Idempotency-Key"];
+};
+type UpdateItemPermissionInput = GrantMutationInput & Readonly<Omit<UpdatePermissionBody, "actions">> & {
+  readonly actions?: readonly PermissionAction[];
+};
+type RevokeItemPermissionInput = GrantMutationInput;
+type CreateUploadInput = Readonly<CreateUploadPath> & Readonly<CreateUploadBody> & {
+  readonly idempotencyKey: CreateUploadHeaders["Idempotency-Key"];
+  readonly signal?: AbortSignal;
+};
+type AbortUploadInput = Readonly<AbortUploadPath> & {
+  readonly signal?: AbortSignal;
+};
+interface DriveClient {
+  listFolderChildren(input: ListFolderChildrenInput): Promise<DriveOperationResult<FolderPage, 200>>;
+  createFolder(input: CreateFolderInput): Promise<DriveOperationResult<FolderItem, 200 | 201>>;
+  listItemPermissions(input: ListItemPermissionsInput): Promise<DriveOperationResult<PermissionPage, 200>>;
+  readEffectiveItemPermissions(input: ReadEffectiveItemPermissionsInput): Promise<DriveOperationResult<EffectivePermissionResponse, 200>>;
+  createItemPermission(input: CreateItemPermissionInput): Promise<DriveOperationResult<PermissionMutation, 200 | 201>>;
+  updateItemPermission(input: UpdateItemPermissionInput): Promise<DriveOperationResult<PermissionMutation, 200>>;
+  revokeItemPermission(input: RevokeItemPermissionInput): Promise<DriveOperationResult<PermissionMutation, 200>>;
+  createUpload(input: CreateUploadInput): Promise<DriveOperationResult<ReservedUploadQuota, 200 | 201>>;
+  abortUpload(input: AbortUploadInput): Promise<DriveOperationResult<AbortedUploadQuota, 200>>;
+}
+//#endregion
+export { PermissionPage as C, UpdateItemPermissionInput as D, RevokeItemPermissionInput as E, UploadQuotaReservation as O, PermissionMutation as S, ReservedUploadQuota as T, ListFolderChildrenInput as _, CreateUploadInput as a, PermissionGrant as b, DriveCredentialContext as c, DriveResponseValidators as d, DriveServerClientConfig as f, FolderPage as g, FolderItem as h, CreateItemPermissionInput as i, DriveCredentialProvider as l, EffectivePermissionResponse as m, AbortedUploadQuota as n, DriveClient as o, EffectivePermissionAction as p, CreateFolderInput as r, DriveClientConfig as s, AbortUploadInput as t, DriveOperationResult as u, ListItemPermissionsInput as v, ReadEffectiveItemPermissionsInput as w, PermissionGrantee as x, PermissionAction as y };