@finueva/drive 0.21.1 → 0.23.0

package/dist/contract.d.ts

@@ -3695,7 +3695,7 @@ interface operations {
               action: "items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:manage" | "items:permissions:read" | "items:update";
               allowed: boolean;
               /** @enum {string|null} */
-              basis: "workspace_visibility" | "restricted_administrator_bypass" | "direct_grant" | "inherited_grant" | null;
+              basis: "workspace_visibility" | "restricted_administrator_bypass" | "item_owner" | "direct_grant" | "inherited_grant" | null;
               grantId: string | null;
               sourceItemId: string | null;
             }[] & (unknown & unknown & unknown & unknown & unknown & unknown & unknown);
@@ -3821,6 +3821,454 @@ interface operations {
       };
     };
   };
+  createInternalItemPermission: {
+    parameters: {
+      query?: never;
+      header: {
+        "Idempotency-Key": string;
+        "If-Match": string;
+      };
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+          expiresAtEpochMilliseconds: number | null;
+          grantee: {
+            /** @enum {string} */
+            type: "user";
+            userId: string;
+          } | {
+            teamId: string;
+            /** @enum {string} */
+            type: "team";
+          };
+        };
+      };
+    };
+    responses: {
+      /** @description The exact committed result was replayed. */
+      200: {
+        headers: {
+          /** @description Current direct collection precondition for the next POST. */
+          "Drive-Permission-Collection-ETag"?: string;
+          /** @description Current direct-grant precondition for PATCH or DELETE; omitted when the current row is not mutable. */
+          "Drive-Permission-Grant-ETag"?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            collectionRevision: number;
+            grant: {
+              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+              /** @enum {string} */
+              availability: "active" | "expired" | "revoked";
+              expiresAtEpochMilliseconds: number | null;
+              grantId: string;
+              grantee: {
+                /** @enum {string} */
+                type: "user";
+                userId: string;
+              } | {
+                teamId: string;
+                /** @enum {string} */
+                type: "team";
+              };
+              revision: number;
+              /** @enum {string} */
+              source: "direct";
+              sourceItemId: string;
+            };
+            /** @enum {string} */
+            outcome: "committed" | "replayed";
+          };
+        };
+      };
+      /** @description The direct grant was committed. */
+      201: {
+        headers: {
+          /** @description Current direct collection precondition for the next POST. */
+          "Drive-Permission-Collection-ETag"?: string;
+          /** @description Current direct-grant precondition for PATCH or DELETE; omitted when the current row is not mutable. */
+          "Drive-Permission-Grant-ETag"?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            collectionRevision: number;
+            grant: {
+              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+              /** @enum {string} */
+              availability: "active" | "expired" | "revoked";
+              expiresAtEpochMilliseconds: number | null;
+              grantId: string;
+              grantee: {
+                /** @enum {string} */
+                type: "user";
+                userId: string;
+              } | {
+                teamId: string;
+                /** @enum {string} */
+                type: "team";
+              };
+              revision: number;
+              /** @enum {string} */
+              source: "direct";
+              sourceItemId: string;
+            };
+            /** @enum {string} */
+            outcome: "committed" | "replayed";
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is required.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The discoverable item does not permit this permission operation. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "permission_denied";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested action is not permitted.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "resource_not_found";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested resource was not found.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The idempotency key was reused for a different semantic request. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "idempotency_conflict";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key conflicts with an earlier request.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The supplied revision or post-preflight authority is stale. */
+      412: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, headers, idempotency key, or body are invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "invalid_request";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request is invalid.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "invalid_idempotency_key";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "identity_authority_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is temporarily unavailable.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "service_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The service is temporarily unavailable.";
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
+  revokeInternalItemPermission: {
+    parameters: {
+      query?: never;
+      header: {
+        "Idempotency-Key": string;
+        "If-Match": string;
+      };
+      path: {
+        workspaceId: string;
+        itemId: string;
+        grantId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description The retained revoked grant was committed, replayed, or unchanged. */
+      200: {
+        headers: {
+          /** @description Current direct collection precondition for POST. */
+          "Drive-Permission-Collection-ETag"?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            collectionRevision: number;
+            grant: {
+              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+              /** @enum {string} */
+              availability: "active" | "expired" | "revoked";
+              expiresAtEpochMilliseconds: number | null;
+              grantId: string;
+              grantee: {
+                /** @enum {string} */
+                type: "user";
+                userId: string;
+              } | {
+                teamId: string;
+                /** @enum {string} */
+                type: "team";
+              };
+              revision: number;
+              /** @enum {string} */
+              source: "direct";
+              sourceItemId: string;
+            };
+            /** @enum {string} */
+            outcome: "committed" | "replayed";
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is required.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The discoverable item does not permit this permission operation. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "permission_denied";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested action is not permitted.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "resource_not_found";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested resource was not found.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The idempotency key was reused for a different semantic request. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "idempotency_conflict";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key conflicts with an earlier request.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The supplied revision or post-preflight authority is stale. */
+      412: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, headers, idempotency key, or body are invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "invalid_request";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request is invalid.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "invalid_idempotency_key";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "identity_authority_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is temporarily unavailable.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "service_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The service is temporarily unavailable.";
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
   revokeItemPermission: {
     parameters: {
       query?: never;
@@ -5062,6 +5510,8 @@ interface operations {
           contentMd5?: string;
           digest: string;
           expectedVersionId: string;
+          /** @constant */
+          singleIntegrity?: "sha256";
         };
       };
     };
@@ -5099,6 +5549,24 @@ interface operations {
                   "x-amz-server-side-encryption-customer-algorithm": "AES256";
                   "x-amz-server-side-encryption-customer-key": string;
                   "x-amz-server-side-encryption-customer-key-md5": string;
+                } | {
+                  /** @enum {string} */
+                  "cache-control": "no-store, no-transform";
+                  "content-type": string;
+                  /** @enum {string} */
+                  "if-none-match": "*";
+                  "x-amz-checksum-sha256": string;
+                } | {
+                  /** @enum {string} */
+                  "cache-control": "no-store, no-transform";
+                  "content-type": string;
+                  /** @enum {string} */
+                  "if-none-match": "*";
+                  "x-amz-checksum-sha256": string;
+                  /** @enum {string} */
+                  "x-amz-server-side-encryption-customer-algorithm": "AES256";
+                  "x-amz-server-side-encryption-customer-key": string;
+                  "x-amz-server-side-encryption-customer-key-md5": string;
                 };
                 /** @enum {string} */
                 method: "PUT";
@@ -5146,6 +5614,24 @@ interface operations {
                   "x-amz-server-side-encryption-customer-algorithm": "AES256";
                   "x-amz-server-side-encryption-customer-key": string;
                   "x-amz-server-side-encryption-customer-key-md5": string;
+                } | {
+                  /** @enum {string} */
+                  "cache-control": "no-store, no-transform";
+                  "content-type": string;
+                  /** @enum {string} */
+                  "if-none-match": "*";
+                  "x-amz-checksum-sha256": string;
+                } | {
+                  /** @enum {string} */
+                  "cache-control": "no-store, no-transform";
+                  "content-type": string;
+                  /** @enum {string} */
+                  "if-none-match": "*";
+                  "x-amz-checksum-sha256": string;
+                  /** @enum {string} */
+                  "x-amz-server-side-encryption-customer-algorithm": "AES256";
+                  "x-amz-server-side-encryption-customer-key": string;
+                  "x-amz-server-side-encryption-customer-key-md5": string;
                 };
                 /** @enum {string} */
                 method: "PUT";
@@ -6436,6 +6922,11 @@ interface operations {
           parentItemId: string;
           /** @enum {string} */
           protectionClassification: "ordinary" | "opaque-encrypted";
+          /**
+           * @description Explicitly negotiates a provider-validated full SHA256 single PUT and its exact header tuple; requires contentMd5 and a nonempty file up to 8 MiB.
+           * @enum {string}
+           */
+          singleIntegrity?: "sha256";
         };
       };
     };
@@ -6473,6 +6964,24 @@ interface operations {
                   "x-amz-server-side-encryption-customer-algorithm": "AES256";
                   "x-amz-server-side-encryption-customer-key": string;
                   "x-amz-server-side-encryption-customer-key-md5": string;
+                } | {
+                  /** @enum {string} */
+                  "cache-control": "no-store, no-transform";
+                  "content-type": string;
+                  /** @enum {string} */
+                  "if-none-match": "*";
+                  "x-amz-checksum-sha256": string;
+                } | {
+                  /** @enum {string} */
+                  "cache-control": "no-store, no-transform";
+                  "content-type": string;
+                  /** @enum {string} */
+                  "if-none-match": "*";
+                  "x-amz-checksum-sha256": string;
+                  /** @enum {string} */
+                  "x-amz-server-side-encryption-customer-algorithm": "AES256";
+                  "x-amz-server-side-encryption-customer-key": string;
+                  "x-amz-server-side-encryption-customer-key-md5": string;
                 };
                 /** @enum {string} */
                 method: "PUT";
@@ -6520,6 +7029,24 @@ interface operations {
                   "x-amz-server-side-encryption-customer-algorithm": "AES256";
                   "x-amz-server-side-encryption-customer-key": string;
                   "x-amz-server-side-encryption-customer-key-md5": string;
+                } | {
+                  /** @enum {string} */
+                  "cache-control": "no-store, no-transform";
+                  "content-type": string;
+                  /** @enum {string} */
+                  "if-none-match": "*";
+                  "x-amz-checksum-sha256": string;
+                } | {
+                  /** @enum {string} */
+                  "cache-control": "no-store, no-transform";
+                  "content-type": string;
+                  /** @enum {string} */
+                  "if-none-match": "*";
+                  "x-amz-checksum-sha256": string;
+                  /** @enum {string} */
+                  "x-amz-server-side-encryption-customer-algorithm": "AES256";
+                  "x-amz-server-side-encryption-customer-key": string;
+                  "x-amz-server-side-encryption-customer-key-md5": string;
                 };
                 /** @enum {string} */
                 method: "PUT";
@@ -8179,6 +8706,8 @@ interface UploadFileProgress {
 }
 type UploadFileProgressCallback = (progress: UploadFileProgress) => void;
 interface UploadFileInput {
+  /** Opt in only after the service supports provider-validated single-object SHA256 receipts. */
+  readonly singleIntegrity?: "sha256";
   readonly workspaceId: string;
   readonly parentItemId: string;
   readonly source: Blob;
@@ -8193,6 +8722,7 @@ interface UploadFileInput {
   readonly onProgress?: UploadFileProgressCallback;
 }
 interface UploadFileVersionInput {
+  readonly singleIntegrity?: "sha256";
   readonly workspaceId: string;
   readonly itemId: string;
   readonly expectedVersionId: string;
@@ -8246,8 +8776,11 @@ interface DriveOperations {
   listItemPermissions(input: ListItemPermissionsInput): Promise<DriveOperationResult<PermissionPage, 200>>;
   readEffectiveItemPermissions(input: ReadEffectiveItemPermissionsInput): Promise<DriveOperationResult<EffectivePermissionResponse, 200>>;
   createItemPermission(input: CreateItemPermissionInput): Promise<DriveOperationResult<PermissionMutation, 200 | 201>>;
+  /** Owner-only file sharing to a fresh member of the same organization; viewer/editor actions only. */
+  createInternalItemPermission(input: CreateItemPermissionInput): Promise<DriveOperationResult<PermissionMutation, 200 | 201>>;
   updateItemPermission(input: UpdateItemPermissionInput): Promise<DriveOperationResult<PermissionMutation, 200>>;
   revokeItemPermission(input: RevokeItemPermissionInput): Promise<DriveOperationResult<PermissionMutation, 200>>;
+  revokeInternalItemPermission(input: RevokeItemPermissionInput): Promise<DriveOperationResult<PermissionMutation, 200>>;
   createUpload(input: CreateUploadInput): Promise<DriveOperationResult<UploadSession, 200 | 201>>;
   getUploadStatus(input: GetUploadStatusInput): Promise<DriveOperationResult<UploadStatus, 200>>;
   createUploadPartDescriptor(input: CreateUploadPartDescriptorInput): Promise<DriveOperationResult<UploadPartDescriptor, 200>>;