@finueva/drive 0.32.1 → 0.33.0

package/dist/contract.d.ts

@@ -1342,6 +1342,898 @@ interface operations {
       };
     };
   };
+  getArchiveConnection: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description The connection, or null. */
+      200: {
+        headers: {
+          /** @description Connection revision for If-Match. */
+          ETag?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            connection: {
+              accessKeyHint: string;
+              /** @enum {string} */
+              addressingMode: "path" | "virtual-hosted";
+              bucket: string;
+              checkedAt: number;
+              /** Format: uuid */
+              connectionId: string;
+              createdAt: number;
+              endpoint: string;
+              hasCloudflareApiToken: boolean;
+              prefix: string;
+              profile: {
+                conditionalCreate: boolean;
+                cors: boolean;
+                /** @enum {string} */
+                lifecycleRead: "s3" | "cloudflare-api" | "none";
+                quirks: ("md5-with-sha256-rejected" | "single-region-only")[];
+                responseOverrides: boolean;
+                sha256FullObject: boolean;
+                sseC: boolean;
+                /** @enum {number} */
+                version: 1;
+              };
+              /** @enum {string} */
+              provider: "s3" | "r2";
+              region: string;
+              report: {
+                bindable: boolean;
+                checkedAt: number;
+                checks: {
+                  detail?: string;
+                  explanation: string;
+                  /** @enum {string} */
+                  id: "access" | "write" | "read" | "range" | "if-match" | "empty-object" | "multipart" | "conditional-create" | "sha256" | "sse-c" | "response-overrides" | "cors" | "lifecycle" | "cleanup";
+                  /** @enum {string} */
+                  outcome: "pass" | "fail" | "skipped";
+                  required: boolean;
+                }[];
+                profile: {
+                  conditionalCreate: boolean;
+                  cors: boolean;
+                  /** @enum {string} */
+                  lifecycleRead: "s3" | "cloudflare-api" | "none";
+                  quirks: ("md5-with-sha256-rejected" | "single-region-only")[];
+                  responseOverrides: boolean;
+                  sha256FullObject: boolean;
+                  sseC: boolean;
+                  /** @enum {number} */
+                  version: 1;
+                } & unknown;
+                /** @enum {number} */
+                version: 1;
+              };
+              revision: number;
+              /** @enum {string} */
+              status: "healthy" | "degraded" | "failing";
+              updatedAt: number;
+            } | null;
+          };
+        };
+      };
+      /** @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 The caller is not an owner of the organization. */
+      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 unavailable organization. */
+      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, storage or connection keys are 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;
+            };
+          };
+        };
+      };
+    };
+  };
+  saveArchiveConnection: {
+    parameters: {
+      query?: never;
+      header?: {
+        "If-Match"?: string;
+        "If-None-Match"?: string;
+      };
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          accessKeyId: string;
+          /** @enum {string} */
+          addressingMode: "path" | "virtual-hosted";
+          bucket: string;
+          cloudflareApiToken?: string;
+          endpoint: string;
+          prefix: string;
+          /** @enum {string} */
+          provider: "s3" | "r2";
+          region: string;
+          secretAccessKey: string;
+        };
+      };
+    };
+    responses: {
+      /** @description The saved connection. */
+      200: {
+        headers: {
+          /** @description Connection revision for If-Match. */
+          ETag?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            connection: {
+              accessKeyHint: string;
+              /** @enum {string} */
+              addressingMode: "path" | "virtual-hosted";
+              bucket: string;
+              checkedAt: number;
+              /** Format: uuid */
+              connectionId: string;
+              createdAt: number;
+              endpoint: string;
+              hasCloudflareApiToken: boolean;
+              prefix: string;
+              profile: {
+                conditionalCreate: boolean;
+                cors: boolean;
+                /** @enum {string} */
+                lifecycleRead: "s3" | "cloudflare-api" | "none";
+                quirks: ("md5-with-sha256-rejected" | "single-region-only")[];
+                responseOverrides: boolean;
+                sha256FullObject: boolean;
+                sseC: boolean;
+                /** @enum {number} */
+                version: 1;
+              };
+              /** @enum {string} */
+              provider: "s3" | "r2";
+              region: string;
+              report: {
+                bindable: boolean;
+                checkedAt: number;
+                checks: {
+                  detail?: string;
+                  explanation: string;
+                  /** @enum {string} */
+                  id: "access" | "write" | "read" | "range" | "if-match" | "empty-object" | "multipart" | "conditional-create" | "sha256" | "sse-c" | "response-overrides" | "cors" | "lifecycle" | "cleanup";
+                  /** @enum {string} */
+                  outcome: "pass" | "fail" | "skipped";
+                  required: boolean;
+                }[];
+                profile: {
+                  conditionalCreate: boolean;
+                  cors: boolean;
+                  /** @enum {string} */
+                  lifecycleRead: "s3" | "cloudflare-api" | "none";
+                  quirks: ("md5-with-sha256-rejected" | "single-region-only")[];
+                  responseOverrides: boolean;
+                  sha256FullObject: boolean;
+                  sseC: boolean;
+                  /** @enum {number} */
+                  version: 1;
+                } & unknown;
+                /** @enum {number} */
+                version: 1;
+              };
+              revision: number;
+              /** @enum {string} */
+              status: "healthy" | "degraded" | "failing";
+              updatedAt: number;
+            } | null;
+          };
+        };
+      };
+      /** @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 The caller is not an owner of the organization. */
+      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 unavailable organization. */
+      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 connection changed, already exists, or does not exist. */
+      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, storage or connection keys are 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;
+            };
+          };
+        };
+      };
+    };
+  };
+  deleteArchiveConnection: {
+    parameters: {
+      query?: never;
+      header?: {
+        "If-Match"?: string;
+      };
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Disconnected. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            connection: {
+              accessKeyHint: string;
+              /** @enum {string} */
+              addressingMode: "path" | "virtual-hosted";
+              bucket: string;
+              checkedAt: number;
+              /** Format: uuid */
+              connectionId: string;
+              createdAt: number;
+              endpoint: string;
+              hasCloudflareApiToken: boolean;
+              prefix: string;
+              profile: {
+                conditionalCreate: boolean;
+                cors: boolean;
+                /** @enum {string} */
+                lifecycleRead: "s3" | "cloudflare-api" | "none";
+                quirks: ("md5-with-sha256-rejected" | "single-region-only")[];
+                responseOverrides: boolean;
+                sha256FullObject: boolean;
+                sseC: boolean;
+                /** @enum {number} */
+                version: 1;
+              };
+              /** @enum {string} */
+              provider: "s3" | "r2";
+              region: string;
+              report: {
+                bindable: boolean;
+                checkedAt: number;
+                checks: {
+                  detail?: string;
+                  explanation: string;
+                  /** @enum {string} */
+                  id: "access" | "write" | "read" | "range" | "if-match" | "empty-object" | "multipart" | "conditional-create" | "sha256" | "sse-c" | "response-overrides" | "cors" | "lifecycle" | "cleanup";
+                  /** @enum {string} */
+                  outcome: "pass" | "fail" | "skipped";
+                  required: boolean;
+                }[];
+                profile: {
+                  conditionalCreate: boolean;
+                  cors: boolean;
+                  /** @enum {string} */
+                  lifecycleRead: "s3" | "cloudflare-api" | "none";
+                  quirks: ("md5-with-sha256-rejected" | "single-region-only")[];
+                  responseOverrides: boolean;
+                  sha256FullObject: boolean;
+                  sseC: boolean;
+                  /** @enum {number} */
+                  version: 1;
+                } & unknown;
+                /** @enum {number} */
+                version: 1;
+              };
+              revision: number;
+              /** @enum {string} */
+              status: "healthy" | "degraded" | "failing";
+              updatedAt: number;
+            } | null;
+          };
+        };
+      };
+      /** @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 The caller is not an owner of the organization. */
+      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 unavailable organization. */
+      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 connection changed since the supplied ETag. */
+      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, storage or connection keys are 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;
+            };
+          };
+        };
+      };
+    };
+  };
+  recheckArchiveConnection: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description The connection with its new status and report. */
+      200: {
+        headers: {
+          /** @description Connection revision for If-Match. */
+          ETag?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            connection: {
+              accessKeyHint: string;
+              /** @enum {string} */
+              addressingMode: "path" | "virtual-hosted";
+              bucket: string;
+              checkedAt: number;
+              /** Format: uuid */
+              connectionId: string;
+              createdAt: number;
+              endpoint: string;
+              hasCloudflareApiToken: boolean;
+              prefix: string;
+              profile: {
+                conditionalCreate: boolean;
+                cors: boolean;
+                /** @enum {string} */
+                lifecycleRead: "s3" | "cloudflare-api" | "none";
+                quirks: ("md5-with-sha256-rejected" | "single-region-only")[];
+                responseOverrides: boolean;
+                sha256FullObject: boolean;
+                sseC: boolean;
+                /** @enum {number} */
+                version: 1;
+              };
+              /** @enum {string} */
+              provider: "s3" | "r2";
+              region: string;
+              report: {
+                bindable: boolean;
+                checkedAt: number;
+                checks: {
+                  detail?: string;
+                  explanation: string;
+                  /** @enum {string} */
+                  id: "access" | "write" | "read" | "range" | "if-match" | "empty-object" | "multipart" | "conditional-create" | "sha256" | "sse-c" | "response-overrides" | "cors" | "lifecycle" | "cleanup";
+                  /** @enum {string} */
+                  outcome: "pass" | "fail" | "skipped";
+                  required: boolean;
+                }[];
+                profile: {
+                  conditionalCreate: boolean;
+                  cors: boolean;
+                  /** @enum {string} */
+                  lifecycleRead: "s3" | "cloudflare-api" | "none";
+                  quirks: ("md5-with-sha256-rejected" | "single-region-only")[];
+                  responseOverrides: boolean;
+                  sha256FullObject: boolean;
+                  sseC: boolean;
+                  /** @enum {number} */
+                  version: 1;
+                } & unknown;
+                /** @enum {number} */
+                version: 1;
+              };
+              revision: number;
+              /** @enum {string} */
+              status: "healthy" | "degraded" | "failing";
+              updatedAt: number;
+            } | null;
+          };
+        };
+      };
+      /** @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 The caller is not an owner of the organization. */
+      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 unavailable organization. */
+      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 connection changed during the check. */
+      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, storage or connection keys are 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;
+            };
+          };
+        };
+      };
+    };
+  };
+  testArchiveConnection: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          accessKeyId: string;
+          /** @enum {string} */
+          addressingMode: "path" | "virtual-hosted";
+          bucket: string;
+          cloudflareApiToken?: string;
+          endpoint: string;
+          prefix: string;
+          /** @enum {string} */
+          provider: "s3" | "r2";
+          region: string;
+          secretAccessKey: string;
+        };
+      };
+    };
+    responses: {
+      /** @description Field errors, or the probe report. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            errors: {
+              /** @enum {string} */
+              field: "provider" | "endpoint" | "region" | "bucket" | "prefix" | "addressingMode" | "accessKeyId" | "secretAccessKey" | "cloudflareApiToken";
+              reason: string;
+            }[];
+            report: {
+              bindable: boolean;
+              checkedAt: number;
+              checks: {
+                detail?: string;
+                explanation: string;
+                /** @enum {string} */
+                id: "access" | "write" | "read" | "range" | "if-match" | "empty-object" | "multipart" | "conditional-create" | "sha256" | "sse-c" | "response-overrides" | "cors" | "lifecycle" | "cleanup";
+                /** @enum {string} */
+                outcome: "pass" | "fail" | "skipped";
+                required: boolean;
+              }[];
+              profile: {
+                conditionalCreate: boolean;
+                cors: boolean;
+                /** @enum {string} */
+                lifecycleRead: "s3" | "cloudflare-api" | "none";
+                quirks: ("md5-with-sha256-rejected" | "single-region-only")[];
+                responseOverrides: boolean;
+                sha256FullObject: boolean;
+                sseC: boolean;
+                /** @enum {number} */
+                version: 1;
+              } & unknown;
+              /** @enum {number} */
+              version: 1;
+            } & unknown;
+          };
+        };
+      };
+      /** @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 The caller is not an owner of the organization. */
+      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 unavailable organization. */
+      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, storage or connection keys are 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;
+            };
+          };
+        };
+      };
+    };
+  };
   getWorkspaceLinkPolicy: {
     parameters: {
       query?: never;
@@ -9834,6 +10726,61 @@ interface UpdateWorkspaceLinkPolicyInput {
   readonly ifMatch: string;
   readonly signal?: AbortSignal;
 }
+type ArchiveConnectionReadBody = JsonResponse<"getArchiveConnection", 200>;
+type GeneratedArchiveConnection = NonNullable<ArchiveConnectionReadBody["connection"]>;
+type GeneratedArchiveProbeReport = NonNullable<JsonResponse<"testArchiveConnection", 200>["report"]>;
+/** What the bucket supports, fixed when it was connected. */
+type ArchiveCapabilityProfile = Readonly<GeneratedArchiveConnection["profile"]>;
+/**
+ * One probe run: a checklist with a plain explanation per check. `profile` is null while a required check fails,
+ * and `bindable` is true only when every check passes.
+ */
+type ArchiveProbeReport = Readonly<Omit<GeneratedArchiveProbeReport, "profile"> & {
+  profile: ArchiveCapabilityProfile | null;
+}>;
+/** The organization workspace's own archive bucket. Credentials are never returned; only a four-character key hint. */
+type ArchiveConnection = Readonly<Omit<GeneratedArchiveConnection, "report"> & {
+  report: ArchiveProbeReport;
+}>;
+/** The current connection, or null while the workspace uses Finueva's managed archive. Organization owners only. */
+type ArchiveConnectionRead = Readonly<{
+  connection: ArchiveConnection | null;
+}>;
+/** Field errors (and no report) for an invalid form, or the probe report (and no errors). Nothing is stored. */
+type ArchiveConnectionTest = Readonly<Omit<JsonResponse<"testArchiveConnection", 200>, "report"> & {
+  report: ArchiveProbeReport | null;
+}>;
+/** The connect form. Secrets are sent to Drive only; the SDK never logs or echoes them. */
+interface ArchiveConnectionInput {
+  readonly provider: "s3" | "r2";
+  /** The provider's HTTPS S3 endpoint origin. R2 uses `https://<account id>.r2.cloudflarestorage.com`. */
+  readonly endpoint: string;
+  readonly region: string;
+  readonly bucket: string;
+  readonly prefix: string;
+  readonly addressingMode: "path" | "virtual-hosted";
+  readonly accessKeyId: string;
+  readonly secretAccessKey: string;
+  /** Required for R2 (lifecycle read); not allowed for other providers. */
+  readonly cloudflareApiToken?: string;
+  readonly signal?: AbortSignal;
+}
+/**
+ * Connects a bucket (`create: true`, sent as `If-None-Match: *`) or replaces the keys of the connected bucket at
+ * the same location (`ifMatch`, the `validators.etag` of the current connection). Exactly one is required.
+ */
+type SaveArchiveConnectionInput = ArchiveConnectionInput & ({
+  readonly create: true;
+  readonly ifMatch?: never;
+} | {
+  readonly ifMatch: string;
+  readonly create?: never;
+});
+interface DeleteArchiveConnectionInput {
+  /** The `validators.etag` of the connection to disconnect. */
+  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.
@@ -10132,6 +11079,16 @@ interface DriveOperations {
   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.33. Organization owners only. */
+  getArchiveConnection(input?: GetCurrentWorkspaceInput): Promise<DriveOperationResult<ArchiveConnectionRead, 200>>;
+  /** Present from SDK 0.33. Probes the bucket without saving anything. Organization owners only. */
+  testArchiveConnection(input: ArchiveConnectionInput): Promise<DriveOperationResult<ArchiveConnectionTest, 200>>;
+  /** Present from SDK 0.33. Re-probes, then connects a bucket or replaces its keys. Organization owners only. */
+  saveArchiveConnection(input: SaveArchiveConnectionInput): Promise<DriveOperationResult<ArchiveConnectionRead, 200>>;
+  /** Present from SDK 0.33. Probes the connected bucket again with its stored keys. Organization owners only. */
+  recheckArchiveConnection(input?: GetCurrentWorkspaceInput): Promise<DriveOperationResult<ArchiveConnectionRead, 200>>;
+  /** Present from SDK 0.33. Erases the stored keys; nothing in the bucket is deleted. Organization owners only. */
+  deleteArchiveConnection(input: DeleteArchiveConnectionInput): Promise<DriveOperationResult<ArchiveConnectionRead, 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. */
@@ -10224,4 +11181,4 @@ interface DriveClient extends DriveOperations, VerifiedTransferOperations {
   uploadVerifiedFile(input: UploadVerifiedFileInput): Promise<DriveOperationResult<PublishedVerifiedTransfer, 200>>;
 }
 //#endregion
-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 };
+export { GetItemInput as $, RestoreItemVersionInput as $t, DriveCredentialProvider as A, WorkspaceCount as An, ManagedLifecycleItem as At, DriveVisitorClient as B, operations as Bn, PrepareVerifiedTransferInput as Bt, CurrentWorkspaceSources as C, VisitorEditingSession as Cn, ManagedDownloadDescriptor as Ct, DriveClient as D, VisitorItem as Dn, ManagedItemVersionPage as Dt, DownloadItemResult as E, VisitorGrantPage as En, ManagedItemVersion as Et, DriveOperations as F, WorkspaceItemSearchItem as Fn, PermissionAction as Ft, EffectivePermissionResponse as G, ReadEffectiveItemPermissionsInput as Gt, EditingSession as H, ProtectionClassification as Ht, DriveResponseValidators as I, WorkspaceItemSearchPage as In, PermissionGrant as It, FolderListInclude as J, RegisterItemRecipientsInput as Jt, FileAccessContext as K, RecoverVerifiedTransferInput as Kt, DriveServerClient as L, WorkspaceLinkPolicy as Ln, PermissionGrantee as Lt, DriveEditingClientConfig as M, WorkspaceCountsInput as Mn, OrganizationMemberStorageUsageInput as Mt, DriveEditingServerClient as N, WorkspaceDiscoveryItem as Nn, OwnedItem as Nt, DriveClientConfig as O, VisitorReadInput as On, ManagedItemVersionResource as Ot, DriveOperationResult as P, WorkspaceDiscoveryPage as Pn, OwnedItemPage as Pt, GetItemGeneralAccessInput as Q, RestoreItemInput as Qt, DriveServerClientConfig as R, WorkspaceSharingPolicy as Rn, PermissionMutation as Rt, CurrentWorkspace as S, VisitorDownloadInput as Sn, ListWorkspaceItemsInput as St, DeleteItemInput as T, VisitorGrantCreation as Tn, ManagedItemMetadata as Tt, EditingSessionCreation as U, PublishVerifiedTransferInput as Ut, DriveVisitorClientConfig as V, PreparedVerifiedTransfer as Vt, EffectivePermissionAction as W, PublishedVerifiedTransfer as Wt, FolderPage as X, RenditionDescriptor as Xt, FolderListedItem as Y, RegisteredRecipientDisplay as Yt, GetCurrentWorkspaceInput as Z, RenditionDescriptorBatch as Zt, CreateRenditionDescriptorInput as _, UploadSmallVerifiedFileInput as _n, ListIncomingSharesInput as _t, ArchiveConnectionRead as a, TransferItemOwnershipInput as an, IncomingShareContext as at, CreateVisitorGrantInput as b, VisitorChildren as bn, ListItemVersionsInput as bt, ArchiveProbeReport as c, UpdateItemGeneralAccessInput as cn, ItemGeneralAccess as ct, CollectOwnedItemsInput as d, UpdateWorkspaceLinkPolicyInput as dn, ItemSharingBatch as dt, RevokeItemPermissionInput as en, GetItemVersionInput as et, CollectedOwnedItems as f, UpdateWorkspaceSharingPolicyInput as fn, ItemSharingBatchResult as ft, CreateItemPermissionInput as g, UploadFileStage as gn, ListIncomingItemsInput as gt, CreateFolderInput as h, UploadFileProgressCallback as hn, ListFolderChildrenInput as ht, ArchiveConnectionInput as i, StarItemInput as in, IncomingItemPage as it, DriveEditingClient as j, WorkspaceCounts as jn, OrganizationMemberStorageUsage as jt, DriveCredentialContext as k, VisitorSession as kn, ManagedItemVersionRestoreResult as kt, ArchivedItem as l, UpdateItemInput as ln, ItemOwnershipTransfer as lt, CreateEditingSessionInput as m, UploadFileProgress as mn, ListFavoriteItemsInput as mt, ArchiveCapabilityProfile as n, SaveArchiveConnectionInput as nn, GetWorkspaceUsageInput as nt, ArchiveConnectionTest as o, TrashItemInput as on, IncomingSharePage as ot, CreateDownloadInput as p, UploadFilePhase as pn, ItemSharingPeoplePage as pt, FolderItem as q, RegisterItemRecipientInput as qt, ArchiveConnection as r, SearchWorkspaceItemsInput as rn, IncomingItemMetadata as rt, ArchiveItemInput as s, UnstarItemInput as sn, ItemFavorite as st, AdmittedVerifiedTransfer as t, RevokeVisitorGrantInput as tn, GetVisitorGrantInput as tt, ChangeEditingSessionInput as u, UpdateItemPermissionInput as un, ItemRecipientBatchEntry as ut, CreateRenditionDescriptorsInput as v, UploadVerifiedFileInput as vn, ListItemPermissionsInput as vt, DeleteArchiveConnectionInput as w, VisitorGrant as wn, ManagedDownloadRestorePending as wt, CurrentUserWorkspaceUsage as x, VisitorChildrenInput as xn, ListOwnedItemsInput as xt, CreateVisitorEditingSessionInput as y, VerifiedTransferOperations as yn, ListItemSharingPeopleInput as yt, DriveUploadConfig as z, WorkspaceUsage as zn, PermissionPage as zt };