@finueva/drive 0.5.1 → 0.7.0

package/dist/contract.d.ts

@@ -1,5 +1,228 @@
 //#region src/generated/openapi.d.ts
 interface operations {
+  provisionManagedWorkspace: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          entitlement: {
+            managedStorageByteLimit: number;
+            managedStorageEnabled: boolean;
+            version: number;
+          } & ({
+            /** @constant */
+            managedStorageByteLimit?: 0;
+            /** @constant */
+            managedStorageEnabled?: false;
+          } | {
+            managedStorageByteLimit?: number;
+            /** @constant */
+            managedStorageEnabled?: true;
+          });
+          /** @enum {string} */
+          environment: "local" | "development" | "staging" | "production";
+          provisioningId: string;
+          /** @constant */
+          version: 1;
+          workspaceReference: {
+            /** @enum {string} */
+            type: "personal";
+            userId: string;
+          } | {
+            organizationId: string;
+            /** @enum {string} */
+            type: "organization";
+          };
+        };
+      };
+    };
+    responses: {
+      /** @description The exact request replayed or was superseded by a later entitlement. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            /** @enum {string} */
+            outcome: "replayed" | "superseded";
+            workspace: {
+              entitlement: {
+                managedStorageByteLimit: number;
+                managedStorageEnabled: boolean;
+                version: number;
+              } & ({
+                /** @constant */
+                managedStorageByteLimit?: 0;
+                /** @constant */
+                managedStorageEnabled?: false;
+              } | {
+                managedStorageByteLimit?: number;
+                /** @constant */
+                managedStorageEnabled?: true;
+              });
+              rootItemId: string;
+              rootVolumeId: string;
+              workspaceId: string;
+              workspaceReference: {
+                /** @enum {string} */
+                type: "personal";
+                userId: string;
+              } | {
+                organizationId: string;
+                /** @enum {string} */
+                type: "organization";
+              };
+            };
+          };
+        };
+      };
+      /** @description The provisioning state was committed. */
+      201: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            /** @enum {string} */
+            outcome: "committed";
+            workspace: {
+              entitlement: {
+                managedStorageByteLimit: number;
+                managedStorageEnabled: boolean;
+                version: number;
+              } & ({
+                /** @constant */
+                managedStorageByteLimit?: 0;
+                /** @constant */
+                managedStorageEnabled?: false;
+              } | {
+                managedStorageByteLimit?: number;
+                /** @constant */
+                managedStorageEnabled?: true;
+              });
+              rootItemId: string;
+              rootVolumeId: string;
+              workspaceId: string;
+              workspaceReference: {
+                /** @enum {string} */
+                type: "personal";
+                userId: string;
+              } | {
+                organizationId: string;
+                /** @enum {string} */
+                type: "organization";
+              };
+            };
+          };
+        };
+      };
+      /** @description A valid ecosystem provisioning 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 verified principal lacks the exact provisioning capability. */
+      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 provisioning identity conflicts with retained state. */
+      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 strict provisioning request is 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;
+            };
+          };
+        };
+      };
+      /** @description Auth authority, D1, or trusted capacity evidence 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;
+            };
+          };
+        };
+      };
+    };
+  };
   getCurrentWorkspace: {
     parameters: {
       query?: never;
@@ -3536,7 +3759,7 @@ interface operations {
             expiresAtEpochMilliseconds: number;
             itemId: string;
             /** @enum {string} */
-            lifecycle: "initiating" | "recovery-required" | "uploading" | "completing" | "provider-completed" | "ready" | "aborting" | "aborted";
+            lifecycle: "initiating" | "recovery-required" | "uploading" | "completing" | "provider-completed" | "verifying" | "failed" | "ready" | "aborting" | "aborted";
             /** @enum {string} */
             mode: "presigned-multipart" | "server-mediated-zero-byte";
             nextAfterPartNumber: number | null;
@@ -3549,7 +3772,7 @@ interface operations {
             };
             ready: {
               byteLength: number;
-              /** @description Caller-declared whole-file SHA-256 metadata; archive publication is gated by provider checksum evidence. */
+              /** @description Caller-declared whole-file SHA-256. Portable profiles independently verify file bytes before publication; legacy profiles retain provider-checksum semantics. */
               callerDeclaredContentDigest: string;
               displayFilename: string;
               itemId: string;
@@ -3561,6 +3784,13 @@ interface operations {
             } | null;
             revision: number;
             uploadId: string;
+            verification?: {
+              revision: number;
+              /** @enum {string} */
+              state: "pending" | "verified" | "failed";
+              totalByteLength: number;
+              verifiedByteLength: number;
+            };
             versionId: string;
           };
         };
@@ -3835,7 +4065,7 @@ interface operations {
         content: {
           "application/json": {
             byteLength: number;
-            /** @description Caller-declared whole-file SHA-256 metadata; archive publication is gated by provider checksum evidence. */
+            /** @description Caller-declared whole-file SHA-256. Portable profiles independently verify file bytes before publication; legacy profiles retain provider-checksum semantics. */
             callerDeclaredContentDigest: string;
             displayFilename: string;
             itemId: string;
@@ -3847,6 +4077,24 @@ interface operations {
           };
         };
       };
+      /** @description Archive verification is pending; retry completion with the same key. */
+      202: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            itemId: string;
+            /** @enum {string} */
+            state: "verifying";
+            totalByteLength: number;
+            uploadId: string;
+            verificationRevision: number;
+            verifiedByteLength: number;
+            versionId: string;
+          };
+        };
+      };
       /** @description Authentication is required. */
       401: {
         headers: {
@@ -3998,6 +4246,7 @@ interface operations {
       content: {
         "application/json": {
           checksumSha256: string;
+          contentMd5: string;
           partNumber: number;
         };
       };
@@ -4013,7 +4262,7 @@ interface operations {
             expectedByteLength: number;
             expiresAtEpochMilliseconds: number;
             headers: {
-              "x-amz-checksum-sha256": string;
+              "content-md5": string;
             };
             /** @enum {string} */
             method: "PUT";
@@ -4371,6 +4620,8 @@ type UploadPartDescriptor = Readonly<Omit<JsonResponse<"createUploadPartDescript
 }>;
 type UploadPartResult = Readonly<JsonResponse<"recordUploadPart", 200>>;
 type ReadyUpload = Readonly<JsonResponse<"completeUpload", 200>>;
+type PendingUpload = Readonly<JsonResponse<"completeUpload", 202>>;
+type UploadCompletion = ReadyUpload | PendingUpload;
 type ManagedLifecycleItem = Readonly<JsonResponse<"updateItem", 200>>;
 type GeneratedManagedItemMetadata = JsonResponse<"getItem", 200>;
 type ManagedItemMetadata = Readonly<Omit<GeneratedManagedItemMetadata, "currentVersion"> & {
@@ -4397,10 +4648,11 @@ type ManagedDownloadDescriptor = Readonly<Omit<JsonResponse<"createDownload", 20
 type ManagedDownloadRestorePending = Readonly<JsonResponse<"createDownload", 202>>;
 type GeneratedUploadStatus = JsonResponse<"getUploadStatus", 200>;
 type UploadConfirmedPart = Readonly<GeneratedUploadStatus["confirmedParts"][number]>;
-type UploadStatus = Readonly<Omit<GeneratedUploadStatus, "confirmedParts" | "partPolicy" | "ready"> & {
+type UploadStatus = Readonly<Omit<GeneratedUploadStatus, "confirmedParts" | "partPolicy" | "ready" | "verification"> & {
   readonly confirmedParts: readonly UploadConfirmedPart[];
   readonly partPolicy: Readonly<GeneratedUploadStatus["partPolicy"]>;
   readonly ready: ReadyUpload | null;
+  readonly verification?: Readonly<NonNullable<GeneratedUploadStatus["verification"]>>;
 }>;
 type ProtectionClassification = CreateUploadBody["protectionClassification"];
 type PermissionAction = CreatePermissionBody["actions"][number];
@@ -4540,7 +4792,7 @@ type CreateDownloadInput = Readonly<CreateDownloadPath> & Readonly<CreateDownloa
   readonly signal?: AbortSignal;
 };
 type DownloadItemResult = Response | DriveOperationResult<ManagedDownloadRestorePending, 202> | DriveOperationResult<undefined, 304>;
-type UploadFilePhase = "preparing" | "uploading" | "completing";
+type UploadFilePhase = "preparing" | "uploading" | "completing" | "verifying";
 interface UploadFileProgress {
   readonly phase: UploadFilePhase;
   readonly confirmedByteLength: number;
@@ -4588,12 +4840,12 @@ interface DriveOperations {
   getUploadStatus(input: GetUploadStatusInput): Promise<DriveOperationResult<UploadStatus, 200>>;
   createUploadPartDescriptor(input: CreateUploadPartDescriptorInput): Promise<DriveOperationResult<UploadPartDescriptor, 200>>;
   recordUploadPart(input: RecordUploadPartInput): Promise<DriveOperationResult<UploadPartResult, 200>>;
-  completeUpload(input: CompleteUploadInput): Promise<DriveOperationResult<ReadyUpload, 200>>;
+  completeUpload(input: CompleteUploadInput): Promise<DriveOperationResult<UploadCompletion, 200 | 202>>;
   abortUpload(input: AbortUploadInput): Promise<DriveOperationResult<undefined, 204>>;
 }
 interface DriveServerClient extends DriveOperations {}
 interface DriveClient extends DriveOperations {
-  uploadFile(input: UploadFileInput): Promise<DriveOperationResult<ReadyUpload, 200>>;
+  uploadFile(input: UploadFileInput): Promise<DriveOperationResult<UploadCompletion, 200 | 202>>;
 }
 //#endregion
-export { UpdateItemInput as $, ListItemVersionsInput as A, PermissionGrant as B, FolderPage as C, GetUploadStatusInput as D, GetItemVersionInput as E, ManagedItemVersionPage as F, ReadEffectiveItemPermissionsInput as G, PermissionMutation as H, ManagedItemVersionResource as I, RestoreItemInput as J, ReadyUpload as K, ManagedItemVersionRestoreResult as L, ManagedDownloadRestorePending as M, ManagedItemMetadata as N, ListFolderChildrenInput as O, ManagedItemVersion as P, TrashItemInput as Q, ManagedLifecycleItem as R, FolderItem as S, GetItemInput as T, PermissionPage as U, PermissionGrantee as V, ProtectionClassification as W, RevokeItemPermissionInput as X, RestoreItemVersionInput as Y, SearchWorkspaceItemsInput as Z, DriveResponseValidators as _, CreateItemPermissionInput as a, UploadFileProgressCallback as at, EffectivePermissionAction as b, CurrentWorkspace as c, UploadSession as ct, DriveClient as d, WorkspaceItemSearchPage as dt, UpdateItemPermissionInput as et, DriveClientConfig as f, DriveOperations as g, DriveOperationResult as h, CreateFolderInput as i, UploadFileProgress as it, ManagedDownloadDescriptor as j, ListItemPermissionsInput as k, DeleteItemInput as l, UploadStatus as lt, DriveCredentialProvider as m, CompleteUploadInput as n, UploadFileInput as nt, CreateUploadInput as o, UploadPartDescriptor as ot, DriveCredentialContext as p, RecordUploadPartInput as q, CreateDownloadInput as r, UploadFilePhase as rt, CreateUploadPartDescriptorInput as s, UploadPartResult as st, AbortUploadInput as t, UploadConfirmedPart as tt, DownloadItemResult as u, WorkspaceItemSearchItem as ut, DriveServerClient as v, GetCurrentWorkspaceInput as w, EffectivePermissionResponse as x, DriveServerClientConfig as y, PermissionAction as z };
+export { TrashItemInput as $, ListItemVersionsInput as A, PermissionAction as B, FolderPage as C, GetUploadStatusInput as D, GetItemVersionInput as E, ManagedItemVersionPage as F, ProtectionClassification as G, PermissionGrantee as H, ManagedItemVersionResource as I, RecordUploadPartInput as J, ReadEffectiveItemPermissionsInput as K, ManagedItemVersionRestoreResult as L, ManagedDownloadRestorePending as M, ManagedItemMetadata as N, ListFolderChildrenInput as O, ManagedItemVersion as P, SearchWorkspaceItemsInput as Q, ManagedLifecycleItem as R, FolderItem as S, GetItemInput as T, PermissionMutation as U, PermissionGrant as V, PermissionPage as W, RestoreItemVersionInput as X, RestoreItemInput as Y, RevokeItemPermissionInput as Z, DriveResponseValidators as _, CreateItemPermissionInput as a, UploadFilePhase as at, EffectivePermissionAction as b, CurrentWorkspace as c, UploadPartDescriptor as ct, DriveClient as d, UploadStatus as dt, UpdateItemInput as et, DriveClientConfig as f, WorkspaceItemSearchItem as ft, DriveOperations as g, DriveOperationResult as h, CreateFolderInput as i, UploadFileInput as it, ManagedDownloadDescriptor as j, ListItemPermissionsInput as k, DeleteItemInput as l, UploadPartResult as lt, DriveCredentialProvider as m, operations as mt, CompleteUploadInput as n, UploadCompletion as nt, CreateUploadInput as o, UploadFileProgress as ot, DriveCredentialContext as p, WorkspaceItemSearchPage as pt, ReadyUpload as q, CreateDownloadInput as r, UploadConfirmedPart as rt, CreateUploadPartDescriptorInput as s, UploadFileProgressCallback as st, AbortUploadInput as t, UpdateItemPermissionInput as tt, DownloadItemResult as u, UploadSession as ut, DriveServerClient as v, GetCurrentWorkspaceInput as w, EffectivePermissionResponse as x, DriveServerClientConfig as y, PendingUpload as z };

package/dist/index.d.ts

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