@finueva/drive 0.31.1 → 0.32.0

package/dist/contract.d.ts

@@ -1045,6 +1045,102 @@ interface operations {
       };
     };
   };
+  createVisitorRendition: {
+    parameters: {
+      query?: {
+        itemId?: string;
+      };
+      header: {
+        /** @description DriveVisitor followed by a space and the capability. Never place tokens in URLs. */
+        Authorization: string;
+      };
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description A ready, pending or unsupported rendition. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            byteLength: number;
+            /** @enum {string} */
+            contentType: "image/webp";
+            etag: string;
+            expiresAtEpochMilliseconds: number;
+            height: number;
+            itemId: string;
+            /** @enum {string} */
+            rendition: "preview-640";
+            /** @enum {string} */
+            state: "ready";
+            /** Format: uri */
+            url: string;
+            versionId: string;
+            width: number;
+          } | {
+            itemId: string;
+            /** @enum {string} */
+            rendition: "preview-640";
+            /** @enum {string} */
+            state: "pending";
+            versionId: string;
+          } | {
+            itemId: string;
+            /** @enum {string} */
+            reason: "encrypted" | "protected-archive" | "media-type" | "too-large" | "limits" | "undecodable" | "archive" | "attempts" | "failed";
+            /** @enum {string} */
+            rendition: "preview-640";
+            /** @enum {string} */
+            state: "unsupported";
+            versionId: string;
+          } | {
+            itemId: string;
+            /** @enum {string} */
+            state: "denied" | "not-found" | "unavailable";
+          };
+        };
+      };
+      /** @description Capability or resource unavailable. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Conflicting request identity. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Invalid request; an editor grant is one file for at most 24 hours. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Bounded admission exhausted; retry after one minute. */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Service unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
   redeemVisitorInvitation: {
     parameters: {
       query?: never;
@@ -1235,10 +1331,264 @@ interface operations {
           } | {
             error: {
               /** @enum {string} */
-              code: "service_unavailable";
+              code: "service_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The service is temporarily unavailable.";
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
+  getWorkspaceLinkPolicy: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description The current policy. Revision 0 means it was never changed (disabled). */
+      200: {
+        headers: {
+          /** @description Policy revision for If-Match. */
+          ETag?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            /** @enum {string} */
+            anyoneLinks: "allowed" | "disabled";
+            canManage: boolean;
+            revision: number;
+            updatedAt: number | null;
+            workspaceId: string;
+          };
+        };
+      };
+      /** @description A valid Drive user credential is 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" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Managed storage is disabled, or (update) the caller is not an organization owner or admin. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The credential selects a personal workspace or an organization workspace not available to this User. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Unsupported query, header or body input. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity authority or storage 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" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
+  updateWorkspaceLinkPolicy: {
+    parameters: {
+      query?: never;
+      header: {
+        "If-Match": string;
+      };
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          /** @enum {string} */
+          anyoneLinks: "allowed" | "disabled";
+        };
+      };
+    };
+    responses: {
+      /** @description The policy after the change. */
+      200: {
+        headers: {
+          /** @description Policy revision for If-Match. */
+          ETag?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            /** @enum {string} */
+            anyoneLinks: "allowed" | "disabled";
+            canManage: boolean;
+            revision: number;
+            updatedAt: number | null;
+            workspaceId: string;
+          };
+        };
+      };
+      /** @description A valid Drive user credential is 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" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Managed storage is disabled, or (update) the caller is not an organization owner or admin. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The credential selects a personal workspace or an organization workspace not available to this User. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The policy changed since the supplied revision. */
+      412: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Unsupported query, header or body input. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity authority or storage 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" | "precondition_failed" | "service_unavailable";
               details: Record<string, never>;
-              /** @enum {string} */
-              message: "The service is temporarily unavailable.";
+              message: string;
               requestId: string;
             };
           };
@@ -4181,11 +4531,273 @@ interface operations {
           "application/json": {
             error: {
               /** @enum {string} */
-              code: "authentication_required" | "identity_authority_unavailable" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
-              details: {
-                /** @enum {string} */
-                reason?: "favorite_limit_reached";
-              };
+              code: "authentication_required" | "identity_authority_unavailable" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: {
+                /** @enum {string} */
+                reason?: "favorite_limit_reached";
+              };
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
+  getItemGeneralAccess: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description The file's general access. Revision 0 means it was never changed (restricted). */
+      200: {
+        headers: {
+          /** @description General-access revision for If-Match. */
+          ETag?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            /** @enum {string} */
+            access: "restricted" | "viewer" | "editor";
+            canManage: boolean;
+            itemId: string;
+            revision: number;
+            updatedAt: number | null;
+            workspaceId: string;
+          };
+        };
+      };
+      /** @description A valid Drive user credential is 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" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description (update) The caller is neither the file's manager nor its owner. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The item is not visible to this organization credential, or the credential selects a personal workspace. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Unsupported input, or the item is a folder. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity authority or storage 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" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
+  updateItemGeneralAccess: {
+    parameters: {
+      query?: never;
+      header: {
+        "If-Match": string;
+      };
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          /** @enum {string} */
+          access: "restricted" | "viewer" | "editor";
+        };
+      };
+    };
+    responses: {
+      /** @description The general access after the change. */
+      200: {
+        headers: {
+          /** @description General-access revision for If-Match. */
+          ETag?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            /** @enum {string} */
+            access: "restricted" | "viewer" | "editor";
+            canManage: boolean;
+            itemId: string;
+            revision: number;
+            updatedAt: number | null;
+            workspaceId: string;
+          };
+        };
+      };
+      /** @description A valid Drive user credential is 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" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description (update) The caller is neither the file's manager nor its owner. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The item is not visible to this organization credential, or the credential selects a personal workspace. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The general access changed since the supplied revision. */
+      412: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Unsupported input, or the item is a folder. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity authority or storage 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" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
               message: string;
               requestId: string;
             };
@@ -5868,6 +6480,153 @@ interface operations {
       };
     };
   };
+  createRenditionDescriptor: {
+    parameters: {
+      query?: {
+        versionId?: string;
+        rendition?: string;
+      };
+      header?: never;
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description A ready, pending or unsupported rendition. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            byteLength: number;
+            /** @enum {string} */
+            contentType: "image/webp";
+            etag: string;
+            expiresAtEpochMilliseconds: number;
+            height: number;
+            itemId: string;
+            /** @enum {string} */
+            rendition: "preview-640";
+            /** @enum {string} */
+            state: "ready";
+            /** Format: uri */
+            url: string;
+            versionId: string;
+            width: number;
+          } | {
+            itemId: string;
+            /** @enum {string} */
+            rendition: "preview-640";
+            /** @enum {string} */
+            state: "pending";
+            versionId: string;
+          } | {
+            itemId: string;
+            /** @enum {string} */
+            reason: "encrypted" | "protected-archive" | "media-type" | "too-large" | "limits" | "undecodable" | "archive" | "attempts" | "failed";
+            /** @enum {string} */
+            rendition: "preview-640";
+            /** @enum {string} */
+            state: "unsupported";
+            versionId: string;
+          } | {
+            itemId: string;
+            /** @enum {string} */
+            state: "denied" | "not-found" | "unavailable";
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "invalid_request" | "permission_denied" | "resource_not_found" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The visible file cannot be downloaded under current authority. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "invalid_request" | "permission_denied" | "resource_not_found" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The file or selected version is absent or undiscoverable. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "invalid_request" | "permission_denied" | "resource_not_found" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query or body is invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "invalid_request" | "permission_denied" | "resource_not_found" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity, D1 or authorization is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "invalid_request" | "permission_denied" | "resource_not_found" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
   restoreItem: {
     parameters: {
       query?: never;
@@ -7568,7 +8327,7 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Current item manager authority required, or (create and get) permission_denied with reason external_sharing_disabled when the organization turned external sharing off. */
+      /** @description Current item manager authority required, or (create and get) permission_denied with reason external_sharing_disabled when the organization turned external sharing off, or anyone_links_disabled for an anyone link while the organization has not allowed anyone links. */
       403: {
         headers: {
           [name: string]: unknown;
@@ -7676,7 +8435,7 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Current item manager authority required, or (create and get) permission_denied with reason external_sharing_disabled when the organization turned external sharing off. */
+      /** @description Current item manager authority required, or (create and get) permission_denied with reason external_sharing_disabled when the organization turned external sharing off, or anyone_links_disabled for an anyone link while the organization has not allowed anyone links. */
       403: {
         headers: {
           [name: string]: unknown;
@@ -7766,7 +8525,7 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Current item manager authority required, or (create and get) permission_denied with reason external_sharing_disabled when the organization turned external sharing off. */
+      /** @description Current item manager authority required, or (create and get) permission_denied with reason external_sharing_disabled when the organization turned external sharing off, or anyone_links_disabled for an anyone link while the organization has not allowed anyone links. */
       403: {
         headers: {
           [name: string]: unknown;
@@ -7851,7 +8610,7 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Current item manager authority required, or (create and get) permission_denied with reason external_sharing_disabled when the organization turned external sharing off. */
+      /** @description Current item manager authority required, or (create and get) permission_denied with reason external_sharing_disabled when the organization turned external sharing off, or anyone_links_disabled for an anyone link while the organization has not allowed anyone links. */
       403: {
         headers: {
           [name: string]: unknown;
@@ -8063,6 +8822,128 @@ interface operations {
       };
     };
   };
+  createRenditionDescriptors: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        workspaceId: string;
+      };
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          items: {
+            itemId: string;
+            versionId?: string;
+          }[];
+          /** @enum {string} */
+          rendition?: "preview-640";
+        };
+      };
+    };
+    responses: {
+      /** @description One descriptor per requested item, in request order. Each item is authorized exactly as its download. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            items: ({
+              byteLength: number;
+              /** @enum {string} */
+              contentType: "image/webp";
+              etag: string;
+              expiresAtEpochMilliseconds: number;
+              height: number;
+              itemId: string;
+              /** @enum {string} */
+              rendition: "preview-640";
+              /** @enum {string} */
+              state: "ready";
+              /** Format: uri */
+              url: string;
+              versionId: string;
+              width: number;
+            } | {
+              itemId: string;
+              /** @enum {string} */
+              rendition: "preview-640";
+              /** @enum {string} */
+              state: "pending";
+              versionId: string;
+            } | {
+              itemId: string;
+              /** @enum {string} */
+              reason: "encrypted" | "protected-archive" | "media-type" | "too-large" | "limits" | "undecodable" | "archive" | "attempts" | "failed";
+              /** @enum {string} */
+              rendition: "preview-640";
+              /** @enum {string} */
+              state: "unsupported";
+              versionId: string;
+            } | {
+              itemId: string;
+              /** @enum {string} */
+              state: "denied" | "not-found" | "unavailable";
+            })[];
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "invalid_request" | "permission_denied" | "resource_not_found" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query or body is invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "invalid_request" | "permission_denied" | "resource_not_found" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity, D1 or authorization is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "invalid_request" | "permission_denied" | "resource_not_found" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
   searchWorkspaceItems: {
     parameters: {
       query: {
@@ -8942,6 +9823,32 @@ interface UpdateWorkspaceSharingPolicyInput {
   readonly ifMatch: string;
   readonly signal?: AbortSignal;
 }
+/**
+ * Whether the current organization workspace allows anyone links. Off until an owner or admin allows it; while
+ * off, Drive refuses new anyone links and ignores existing ones. The external-sharing policy applies on top.
+ */
+type WorkspaceLinkPolicy = Readonly<JsonResponse<"getWorkspaceLinkPolicy", 200>>;
+interface UpdateWorkspaceLinkPolicyInput {
+  readonly anyoneLinks: "allowed" | "disabled";
+  /** The `validators.etag` of the policy this change is based on. */
+  readonly ifMatch: string;
+  readonly signal?: AbortSignal;
+}
+/**
+ * One organization file's general access. `viewer` or `editor` lets every current member of the organization
+ * open the exact file under their own credential; it never lists the file for them or lets them reshare it.
+ */
+type ItemGeneralAccess = Readonly<JsonResponse<"getItemGeneralAccess", 200>>;
+interface GetItemGeneralAccessInput {
+  readonly workspaceId: string;
+  readonly itemId: string;
+  readonly signal?: AbortSignal;
+}
+interface UpdateItemGeneralAccessInput extends GetItemGeneralAccessInput {
+  readonly access: ItemGeneralAccess["access"];
+  /** The `validators.etag` of the general access this change is based on. */
+  readonly ifMatch: string;
+}
 type GeneratedCurrentWorkspaceSources = JsonResponse<"getCurrentWorkspaceSources", 200>;
 type CurrentWorkspaceSources = Readonly<Omit<GeneratedCurrentWorkspaceSources, "workspace" | "volumes" | "knownProviders"> & {
   readonly workspace: CurrentWorkspace;
@@ -8984,6 +9891,29 @@ type ManagedDownloadDescriptor = Readonly<Omit<JsonResponse<"createDownload", 20
   readonly response: Readonly<JsonResponse<"createDownload", 200>["response"]>;
 }>;
 type ManagedDownloadRestorePending = Readonly<JsonResponse<"createDownload", 202>>;
+/** A file's preview rendition: `ready` with a signed URL, `pending`, `unsupported`, or a per-item refusal in a batch. */
+type RenditionDescriptor = Readonly<JsonResponse<"createRenditionDescriptor", 200>>;
+type RenditionDescriptorBatch = Readonly<{
+  readonly items: readonly Readonly<JsonResponse<"createRenditionDescriptors", 200>["items"][number]>[];
+}>;
+interface CreateRenditionDescriptorInput {
+  readonly workspaceId: string;
+  readonly itemId: string;
+  /** Defaults to the current version. */
+  readonly versionId?: string;
+  readonly rendition?: "preview-640";
+  readonly signal?: AbortSignal;
+}
+interface CreateRenditionDescriptorsInput {
+  readonly workspaceId: string;
+  /** 1 to 25 distinct items; the response answers them in this order. */
+  readonly items: readonly {
+    readonly itemId: string;
+    readonly versionId?: string;
+  }[];
+  readonly rendition?: "preview-640";
+  readonly signal?: AbortSignal;
+}
 type ProtectionClassification = PrepareVerifiedTransferInput["protectionClassification"];
 type PermissionAction = CreatePermissionBody["actions"][number];
 type PermissionGrantee = Readonly<CreatePermissionBody["grantee"]>;
@@ -9198,6 +10128,14 @@ interface DriveOperations {
   archiveItem(input: ArchiveItemInput): Promise<DriveOperationResult<ArchivedItem, 200>>;
   getWorkspaceSharingPolicy(input?: GetCurrentWorkspaceInput): Promise<DriveOperationResult<WorkspaceSharingPolicy, 200>>;
   updateWorkspaceSharingPolicy(input: UpdateWorkspaceSharingPolicyInput): Promise<DriveOperationResult<WorkspaceSharingPolicy, 200>>;
+  /** Present from SDK 0.32. Organization workspaces only. */
+  getWorkspaceLinkPolicy(input?: GetCurrentWorkspaceInput): Promise<DriveOperationResult<WorkspaceLinkPolicy, 200>>;
+  /** Present from SDK 0.32. Organization owners and admins only. */
+  updateWorkspaceLinkPolicy(input: UpdateWorkspaceLinkPolicyInput): Promise<DriveOperationResult<WorkspaceLinkPolicy, 200>>;
+  /** Present from SDK 0.32. Organization files only. */
+  getItemGeneralAccess(input: GetItemGeneralAccessInput): Promise<DriveOperationResult<ItemGeneralAccess, 200>>;
+  /** Present from SDK 0.32. The file's manager or owner only. */
+  updateItemGeneralAccess(input: UpdateItemGeneralAccessInput): Promise<DriveOperationResult<ItemGeneralAccess, 200>>;
   getCurrentWorkspaceSources(input?: GetCurrentWorkspaceInput): Promise<DriveOperationResult<CurrentWorkspaceSources, 200>>;
   getCurrentWorkspace(input?: GetCurrentWorkspaceInput): Promise<DriveOperationResult<CurrentWorkspace, 200>>;
   ensurePersonalWorkspace(input?: GetCurrentWorkspaceInput): Promise<DriveOperationResult<CurrentWorkspace, 200>>;
@@ -9215,6 +10153,13 @@ interface DriveOperations {
   restoreItemVersion(input: RestoreItemVersionInput): Promise<DriveOperationResult<ManagedItemVersionRestoreResult, 200>>;
   createDownload(input: CreateDownloadInput): Promise<DriveOperationResult<ManagedDownloadDescriptor, 200> | DriveOperationResult<ManagedDownloadRestorePending, 202> | DriveOperationResult<undefined, 304>>;
   downloadItem(input: CreateDownloadInput): Promise<DownloadItemResult>;
+  /**
+   * Present from SDK 0.32. One file's preview rendition under exactly its download authority; a refused file throws
+   * like `createDownload`. `ready` URLs are stable within a 30-minute window and privately cacheable.
+   */
+  createRenditionDescriptor(input: CreateRenditionDescriptorInput): Promise<DriveOperationResult<RenditionDescriptor, 200>>;
+  /** Present from SDK 0.32. Up to 25 files' renditions in one request; each item is authorized like its download. */
+  createRenditionDescriptors(input: CreateRenditionDescriptorsInput): Promise<DriveOperationResult<RenditionDescriptorBatch, 200>>;
   listItemPermissions(input: ListItemPermissionsInput): Promise<DriveOperationResult<PermissionPage, 200>>;
   readEffectiveItemPermissions(input: ReadEffectiveItemPermissionsInput): Promise<DriveOperationResult<EffectivePermissionResponse, 200>>;
   createItemPermission(input: CreateItemPermissionInput): Promise<DriveOperationResult<PermissionMutation, 200 | 201>>;
@@ -9264,6 +10209,8 @@ interface DriveVisitorClient {
   listChildren(input?: VisitorChildrenInput): Promise<DriveOperationResult<VisitorChildren, 200>>;
   createDownload(input?: VisitorDownloadInput): Promise<DriveOperationResult<ManagedDownloadDescriptor, 200>>;
   downloadItem(input?: VisitorDownloadInput): Promise<Response>;
+  /** Present from SDK 0.32. The visitor's file preview rendition under the visitor download authority. */
+  createRendition(input?: VisitorReadInput): Promise<DriveOperationResult<RenditionDescriptor, 200>>;
   redeemInvitation(input: {
     readonly sessionToken: string;
     readonly signal?: AbortSignal;
@@ -9277,4 +10224,4 @@ interface DriveClient extends DriveOperations, VerifiedTransferOperations {
   uploadVerifiedFile(input: UploadVerifiedFileInput): Promise<DriveOperationResult<PublishedVerifiedTransfer, 200>>;
 }
 //#endregion
-export { ItemRecipientBatchEntry as $, UploadFileProgressCallback as $t, DriveUploadConfig as A, PreparedVerifiedTransfer as At, FolderListedItem as B, RestoreItemVersionInput as Bt, DriveEditingClientConfig as C, operations as Cn, OwnedItemPage as Ct, DriveResponseValidators as D, PermissionMutation as Dt, DriveOperations as E, PermissionGrantee as Et, EffectivePermissionAction as F, RecoverVerifiedTransferInput as Ft, GetVisitorGrantInput as G, TransferItemOwnershipInput as Gt, GetCurrentWorkspaceInput as H, RevokeVisitorGrantInput as Ht, EffectivePermissionResponse as I, RegisterItemRecipientInput as It, IncomingItemPage as J, UpdateItemInput as Jt, GetWorkspaceUsageInput as K, TrashItemInput as Kt, FileAccessContext as L, RegisterItemRecipientsInput as Lt, DriveVisitorClientConfig as M, PublishVerifiedTransferInput as Mt, EditingSession as N, PublishedVerifiedTransfer as Nt, DriveServerClient as O, PermissionPage as Ot, EditingSessionCreation as P, ReadEffectiveItemPermissionsInput as Pt, ItemOwnershipTransfer as Q, UploadFileProgress as Qt, FolderItem as R, RegisteredRecipientDisplay as Rt, DriveEditingClient as S, WorkspaceUsage as Sn, OwnedItem as St, DriveOperationResult as T, PermissionGrant as Tt, GetItemInput as U, SearchWorkspaceItemsInput as Ut, FolderPage as V, RevokeItemPermissionInput as Vt, GetItemVersionInput as W, StarItemInput as Wt, IncomingSharePage as X, UpdateWorkspaceSharingPolicyInput as Xt, IncomingShareContext as Y, UpdateItemPermissionInput as Yt, ItemFavorite as Z, UploadFilePhase as Zt, DownloadItemResult as _, WorkspaceDiscoveryItem as _n, ManagedItemVersionResource as _t, CollectOwnedItemsInput as a, VisitorChildrenInput as an, ListIncomingItemsInput as at, DriveCredentialContext as b, WorkspaceItemSearchPage as bn, OrganizationMemberStorageUsage as bt, CreateEditingSessionInput as c, VisitorGrant as cn, ListItemSharingPeopleInput as ct, CreateVisitorEditingSessionInput as d, VisitorItem as dn, ListWorkspaceItemsInput as dt, UploadFileStage as en, ItemSharingBatch as et, CreateVisitorGrantInput as f, VisitorReadInput as fn, ManagedDownloadDescriptor as ft, DeleteItemInput as g, WorkspaceCountsInput as gn, ManagedItemVersionPage as gt, CurrentWorkspaceSources as h, WorkspaceCounts as hn, ManagedItemVersion as ht, ChangeEditingSessionInput as i, VisitorChildren as in, ListFolderChildrenInput as it, DriveVisitorClient as j, ProtectionClassification as jt, DriveServerClientConfig as k, PrepareVerifiedTransferInput as kt, CreateFolderInput as l, VisitorGrantCreation as ln, ListItemVersionsInput as lt, CurrentWorkspace as m, WorkspaceCount as mn, ManagedItemMetadata as mt, ArchiveItemInput as n, UploadVerifiedFileInput as nn, ItemSharingPeoplePage as nt, CollectedOwnedItems as o, VisitorDownloadInput as on, ListIncomingSharesInput as ot, CurrentUserWorkspaceUsage as p, VisitorSession as pn, ManagedDownloadRestorePending as pt, IncomingItemMetadata as q, UnstarItemInput as qt, ArchivedItem as r, VerifiedTransferOperations as rn, ListFavoriteItemsInput as rt, CreateDownloadInput as s, VisitorEditingSession as sn, ListItemPermissionsInput as st, AdmittedVerifiedTransfer as t, UploadSmallVerifiedFileInput as tn, ItemSharingBatchResult as tt, CreateItemPermissionInput as u, VisitorGrantPage as un, ListOwnedItemsInput as ut, DriveClient as v, WorkspaceDiscoveryPage as vn, ManagedItemVersionRestoreResult as vt, DriveEditingServerClient as w, PermissionAction as wt, DriveCredentialProvider as x, WorkspaceSharingPolicy as xn, OrganizationMemberStorageUsageInput as xt, DriveClientConfig as y, WorkspaceItemSearchItem as yn, ManagedLifecycleItem as yt, FolderListInclude as z, RestoreItemInput as zt };
+export { IncomingSharePage as $, UnstarItemInput as $t, DriveServerClient as A, WorkspaceSharingPolicy as An, PermissionGrantee as At, FolderItem as B, RegisterItemRecipientInput as Bt, DriveCredentialProvider as C, WorkspaceCounts as Cn, ManagedLifecycleItem as Ct, DriveOperationResult as D, WorkspaceItemSearchItem as Dn, OwnedItemPage as Dt, DriveEditingServerClient as E, WorkspaceDiscoveryPage as En, OwnedItem as Et, EditingSession as F, ProtectionClassification as Ft, GetItemGeneralAccessInput as G, RestoreItemInput as Gt, FolderListedItem as H, RegisteredRecipientDisplay as Ht, EditingSessionCreation as I, PublishVerifiedTransferInput as It, GetVisitorGrantInput as J, RevokeVisitorGrantInput as Jt, GetItemInput as K, RestoreItemVersionInput as Kt, EffectivePermissionAction as L, PublishedVerifiedTransfer as Lt, DriveUploadConfig as M, operations as Mn, PermissionPage as Mt, DriveVisitorClient as N, PrepareVerifiedTransferInput as Nt, DriveOperations as O, WorkspaceItemSearchPage as On, PermissionAction as Ot, DriveVisitorClientConfig as P, PreparedVerifiedTransfer as Pt, IncomingShareContext as Q, TrashItemInput as Qt, EffectivePermissionResponse as R, ReadEffectiveItemPermissionsInput as Rt, DriveCredentialContext as S, WorkspaceCount as Sn, ManagedItemVersionRestoreResult as St, DriveEditingClientConfig as T, WorkspaceDiscoveryItem as Tn, OrganizationMemberStorageUsageInput as Tt, FolderPage as U, RenditionDescriptor as Ut, FolderListInclude as V, RegisterItemRecipientsInput as Vt, GetCurrentWorkspaceInput as W, RenditionDescriptorBatch as Wt, IncomingItemMetadata as X, StarItemInput as Xt, GetWorkspaceUsageInput as Y, SearchWorkspaceItemsInput as Yt, IncomingItemPage as Z, TransferItemOwnershipInput as Zt, CurrentWorkspaceSources as _, VisitorGrantCreation as _n, ManagedDownloadRestorePending as _t, CollectOwnedItemsInput as a, UploadFilePhase as an, ItemSharingBatchResult as at, DriveClient as b, VisitorReadInput as bn, ManagedItemVersionPage as bt, CreateEditingSessionInput as c, UploadFileStage as cn, ListFolderChildrenInput as ct, CreateRenditionDescriptorInput as d, VerifiedTransferOperations as dn, ListItemPermissionsInput as dt, UpdateItemGeneralAccessInput as en, ItemFavorite as et, CreateRenditionDescriptorsInput as f, VisitorChildren as fn, ListItemSharingPeopleInput as ft, CurrentWorkspace as g, VisitorGrant as gn, ManagedDownloadDescriptor as gt, CurrentUserWorkspaceUsage as h, VisitorEditingSession as hn, ListWorkspaceItemsInput as ht, ChangeEditingSessionInput as i, UpdateWorkspaceSharingPolicyInput as in, ItemSharingBatch as it, DriveServerClientConfig as j, WorkspaceUsage as jn, PermissionMutation as jt, DriveResponseValidators as k, WorkspaceLinkPolicy as kn, PermissionGrant as kt, CreateFolderInput as l, UploadSmallVerifiedFileInput as ln, ListIncomingItemsInput as lt, CreateVisitorGrantInput as m, VisitorDownloadInput as mn, ListOwnedItemsInput as mt, ArchiveItemInput as n, UpdateItemPermissionInput as nn, ItemOwnershipTransfer as nt, CollectedOwnedItems as o, UploadFileProgress as on, ItemSharingPeoplePage as ot, CreateVisitorEditingSessionInput as p, VisitorChildrenInput as pn, ListItemVersionsInput as pt, GetItemVersionInput as q, RevokeItemPermissionInput as qt, ArchivedItem as r, UpdateWorkspaceLinkPolicyInput as rn, ItemRecipientBatchEntry as rt, CreateDownloadInput as s, UploadFileProgressCallback as sn, ListFavoriteItemsInput as st, AdmittedVerifiedTransfer as t, UpdateItemInput as tn, ItemGeneralAccess as tt, CreateItemPermissionInput as u, UploadVerifiedFileInput as un, ListIncomingSharesInput as ut, DeleteItemInput as v, VisitorGrantPage as vn, ManagedItemMetadata as vt, DriveEditingClient as w, WorkspaceCountsInput as wn, OrganizationMemberStorageUsage as wt, DriveClientConfig as x, VisitorSession as xn, ManagedItemVersionResource as xt, DownloadItemResult as y, VisitorItem as yn, ManagedItemVersion as yt, FileAccessContext as z, RecoverVerifiedTransferInput as zt };