@finueva/drive 0.17.0 → 0.18.0

package/dist/contract.d.ts

@@ -335,7 +335,7 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Invalid request; visitor roles are viewer only. */
+      /** @description Invalid request; an editor grant is one file for at most 24 hours. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -439,7 +439,92 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Invalid request; visitor roles are viewer only. */
+      /** @description Invalid request; an editor grant is one file for at most 24 hours. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Bounded admission exhausted; retry after one minute. */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Service unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  createVisitorEditingSession: {
+    parameters: {
+      query?: {
+        itemId?: string;
+      };
+      header: {
+        /** @description DriveVisitor followed by a space and the capability. Never place tokens in URLs. */
+        Authorization: string;
+      };
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          audience: string;
+          sourceVersionId?: string;
+          writable: boolean;
+        };
+      };
+    };
+    responses: {
+      /** @description Scoped capability attributed to the visitor grant; the token is returned once. */
+      201: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            audience: string;
+            /** Format: uuid */
+            contentGeneration: string;
+            expectedVersionId: string;
+            expiresAt: number;
+            /** Format: uuid */
+            grantId: string;
+            itemId: string;
+            leaseUntil: number;
+            revoked: boolean;
+            /** Format: uuid */
+            sessionId: string;
+            sourceVersionId: string;
+            token: string;
+            workspaceId: string;
+            writable: boolean;
+          };
+        };
+      };
+      /** @description Capability or resource unavailable. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Conflicting request identity. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Invalid request; an editor grant is one file for at most 24 hours. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -488,7 +573,7 @@ interface operations {
             kind: "file" | "folder";
             name: string | null;
             /** @enum {string} */
-            role: "viewer";
+            role: "viewer" | "editor";
             rootItemId: string;
           };
         };
@@ -507,7 +592,7 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Invalid request; visitor roles are viewer only. */
+      /** @description Invalid request; an editor grant is one file for at most 24 hours. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -558,7 +643,7 @@ interface operations {
             expiresAt: number;
             grantId: string;
             /** @enum {string} */
-            role: "viewer";
+            role: "viewer" | "editor";
           };
         };
       };
@@ -576,7 +661,7 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Invalid request; visitor roles are viewer only. */
+      /** @description Invalid request; an editor grant is one file for at most 24 hours. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -5007,7 +5092,7 @@ interface operations {
               /** @enum {string} */
               mode: "anyone" | "email";
               /** @enum {string} */
-              role: "viewer";
+              role: "viewer" | "editor";
               /** @enum {string} */
               source: "direct" | "inherited";
               sourceItemId: string;
@@ -5045,7 +5130,7 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Invalid request; visitor roles are viewer only. */
+      /** @description Invalid request; an editor grant is one file for at most 24 hours. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -5086,15 +5171,15 @@ interface operations {
           expiresAt: number;
           /** @constant */
           mode: "anyone";
-          /** @constant */
-          role: "viewer";
+          /** @enum {string} */
+          role: "viewer" | "editor";
         } | {
           email: string;
           expiresAt: number;
           /** @constant */
           mode: "email";
-          /** @constant */
-          role: "viewer";
+          /** @enum {string} */
+          role: "viewer" | "editor";
         };
       };
     };
@@ -5115,7 +5200,7 @@ interface operations {
               /** @enum {string} */
               mode: "anyone" | "email";
               /** @enum {string} */
-              role: "viewer";
+              role: "viewer" | "editor";
               /** @enum {string} */
               status: "pending" | "active" | "expired" | "revoked";
             };
@@ -5153,7 +5238,7 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Invalid request; visitor roles are viewer only. */
+      /** @description Invalid request; an editor grant is one file for at most 24 hours. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -5205,7 +5290,7 @@ interface operations {
               /** @enum {string} */
               mode: "anyone" | "email";
               /** @enum {string} */
-              role: "viewer";
+              role: "viewer" | "editor";
               /** @enum {string} */
               status: "pending" | "active" | "expired" | "revoked";
             };
@@ -5243,7 +5328,7 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Invalid request; visitor roles are viewer only. */
+      /** @description Invalid request; an editor grant is one file for at most 24 hours. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -5294,7 +5379,7 @@ interface operations {
             /** @enum {string} */
             mode: "anyone" | "email";
             /** @enum {string} */
-            role: "viewer";
+            role: "viewer" | "editor";
             /** @enum {string} */
             status: "pending" | "active" | "expired" | "revoked";
           };
@@ -5328,7 +5413,7 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Invalid request; visitor roles are viewer only. */
+      /** @description Invalid request; an editor grant is one file for at most 24 hours. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -7281,6 +7366,8 @@ type VisitorGrantPage = JsonResponse<"listVisitorGrants", 200>;
 type VisitorItem = JsonResponse<"readVisitorItem", 200>;
 type VisitorChildren = JsonResponse<"listVisitorChildren", 200>;
 type VisitorSession = JsonResponse<"redeemVisitorInvitation", 200>;
+type VisitorEditingSession = JsonResponse<"createVisitorEditingSession", 201>;
+type CreateVisitorEditingSessionInput = VisitorReadInput & JsonRequest<"createVisitorEditingSession">;
 type CreateVisitorGrantInput = GetItemInput & {
   readonly command: JsonRequest<"createVisitorGrant">;
   readonly idempotencyKey: string;
@@ -7317,6 +7404,7 @@ interface DriveVisitorClient {
     readonly sessionToken: string;
     readonly signal?: AbortSignal;
   }): Promise<DriveOperationResult<VisitorSession, 200>>;
+  createEditingSession(input: CreateVisitorEditingSessionInput): Promise<DriveOperationResult<VisitorEditingSession, 201>>;
 }
 interface DriveServerClient extends DriveOperations {}
 interface DriveClient extends DriveOperations {
@@ -7324,4 +7412,4 @@ interface DriveClient extends DriveOperations {
   uploadFile(input: UploadFileInput): Promise<DriveOperationResult<UploadCompletion, 200 | 202>>;
 }
 //#endregion
-export { ListItemVersionsInput as $, WorkspaceUsage as $t, DriveVisitorClientConfig as A, UploadConfirmedPart as At, GetCurrentWorkspaceInput as B, VisitorChildren as Bt, DriveEditingServerClient as C, RevokeItemPermissionInput as Ct, DriveServerClient as D, UpdateItemInput as Dt, DriveResponseValidators as E, TrashItemInput as Et, EffectivePermissionAction as F, UploadFileVersionInput as Ft, GetWorkspaceUsageInput as G, VisitorGrantPage as Gt, GetItemVersionInput as H, VisitorDownloadInput as Ht, EffectivePermissionResponse as I, UploadPartDescriptor as It, ItemSharingPeoplePage as J, VisitorSession as Jt, IncomingShareContext as K, VisitorItem as Kt, FileAccessContext as L, UploadPartResult as Lt, EditingFileVersionInput as M, UploadFilePhase as Mt, EditingSession as N, UploadFileProgress as Nt, DriveServerClientConfig as O, UpdateItemPermissionInput as Ot, EditingSessionCreation as P, UploadFileProgressCallback as Pt, ListItemSharingPeopleInput as Q, WorkspaceItemSearchPage as Qt, FolderItem as R, UploadSession as Rt, DriveEditingClientConfig as S, RestoreItemVersionInput as St, DriveOperations as T, SearchWorkspaceItemsInput as Tt, GetUploadStatusInput as U, VisitorGrant as Ut, GetItemInput as V, VisitorChildrenInput as Vt, GetVisitorGrantInput as W, VisitorGrantCreation as Wt, ListIncomingSharesInput as X, WorkspaceDiscoveryPage as Xt, ListFolderChildrenInput as Y, WorkspaceDiscoveryItem as Yt, ListItemPermissionsInput as Z, WorkspaceItemSearchItem as Zt, DriveClient as _, ReadyUpload as _t, CreateDownloadInput as a, ManagedItemVersionPage as at, DriveCredentialProvider as b, RegisteredRecipientDisplay as bt, CreateFolderInput as c, ManagedLifecycleItem as ct, CreateUploadPartDescriptorInput as d, PermissionGrant as dt, operations as en, ListWorkspaceItemsInput as et, CreateVisitorGrantInput as f, PermissionGrantee as ft, DownloadItemResult as g, ReadEffectiveItemPermissionsInput as gt, DeleteItemInput as h, ProtectionClassification as ht, CompleteUploadInput as i, ManagedItemVersion as it, EditingFileMetadata as j, UploadFileInput as jt, DriveVisitorClient as k, UploadCompletion as kt, CreateItemPermissionInput as l, PendingUpload as lt, CurrentWorkspaceSources as m, PermissionPage as mt, ChangeEditingSessionInput as n, ManagedDownloadRestorePending as nt, CreateEditingSessionInput as o, ManagedItemVersionResource as ot, CurrentWorkspace as p, PermissionMutation as pt, IncomingSharePage as q, VisitorReadInput as qt, CommitFileVersionInput as r, ManagedItemMetadata as rt, CreateFileVersionUploadInput as s, ManagedItemVersionRestoreResult as st, AbortUploadInput as t, ManagedDownloadDescriptor as tt, CreateUploadInput as u, PermissionAction as ut, DriveClientConfig as v, RecordUploadPartInput as vt, DriveOperationResult as w, RevokeVisitorGrantInput as wt, DriveEditingClient as x, RestoreItemInput as xt, DriveCredentialContext as y, RegisterItemRecipientInput as yt, FolderPage as z, UploadStatus as zt };
+export { ListItemSharingPeopleInput as $, WorkspaceItemSearchItem as $t, DriveVisitorClient as A, UploadCompletion as At, FolderPage as B, UploadStatus as Bt, DriveEditingClientConfig as C, RestoreItemVersionInput as Ct, DriveResponseValidators as D, TrashItemInput as Dt, DriveOperations as E, SearchWorkspaceItemsInput as Et, EditingSessionCreation as F, UploadFileProgressCallback as Ft, GetVisitorGrantInput as G, VisitorGrant as Gt, GetItemInput as H, VisitorChildrenInput as Ht, EffectivePermissionAction as I, UploadFileVersionInput as It, IncomingSharePage as J, VisitorItem as Jt, GetWorkspaceUsageInput as K, VisitorGrantCreation as Kt, EffectivePermissionResponse as L, UploadPartDescriptor as Lt, EditingFileMetadata as M, UploadFileInput as Mt, EditingFileVersionInput as N, UploadFilePhase as Nt, DriveServerClient as O, UpdateItemInput as Ot, EditingSession as P, UploadFileProgress as Pt, ListItemPermissionsInput as Q, WorkspaceDiscoveryPage as Qt, FileAccessContext as R, UploadPartResult as Rt, DriveEditingClient as S, RestoreItemInput as St, DriveOperationResult as T, RevokeVisitorGrantInput as Tt, GetItemVersionInput as U, VisitorDownloadInput as Ut, GetCurrentWorkspaceInput as V, VisitorChildren as Vt, GetUploadStatusInput as W, VisitorEditingSession as Wt, ListFolderChildrenInput as X, VisitorSession as Xt, ItemSharingPeoplePage as Y, VisitorReadInput as Yt, ListIncomingSharesInput as Z, WorkspaceDiscoveryItem as Zt, DownloadItemResult as _, ReadEffectiveItemPermissionsInput as _t, CreateDownloadInput as a, ManagedItemVersion as at, DriveCredentialContext as b, RegisterItemRecipientInput as bt, CreateFolderInput as c, ManagedItemVersionRestoreResult as ct, CreateUploadPartDescriptorInput as d, PermissionAction as dt, WorkspaceItemSearchPage as en, ListItemVersionsInput as et, CreateVisitorEditingSessionInput as f, PermissionGrant as ft, DeleteItemInput as g, ProtectionClassification as gt, CurrentWorkspaceSources as h, PermissionPage as ht, CompleteUploadInput as i, ManagedItemMetadata as it, DriveVisitorClientConfig as j, UploadConfirmedPart as jt, DriveServerClientConfig as k, UpdateItemPermissionInput as kt, CreateItemPermissionInput as l, ManagedLifecycleItem as lt, CurrentWorkspace as m, PermissionMutation as mt, ChangeEditingSessionInput as n, operations as nn, ManagedDownloadDescriptor as nt, CreateEditingSessionInput as o, ManagedItemVersionPage as ot, CreateVisitorGrantInput as p, PermissionGrantee as pt, IncomingShareContext as q, VisitorGrantPage as qt, CommitFileVersionInput as r, ManagedDownloadRestorePending as rt, CreateFileVersionUploadInput as s, ManagedItemVersionResource as st, AbortUploadInput as t, WorkspaceUsage as tn, ListWorkspaceItemsInput as tt, CreateUploadInput as u, PendingUpload as ut, DriveClient as v, ReadyUpload as vt, DriveEditingServerClient as w, RevokeItemPermissionInput as wt, DriveCredentialProvider as x, RegisteredRecipientDisplay as xt, DriveClientConfig as y, RecordUploadPartInput as yt, FolderItem as z, UploadSession as zt };

package/dist/contract2.d.ts

@@ -1,4 +1,4 @@
-import { A as DriveVisitorClientConfig, k as DriveVisitorClient } from "./contract.js";
+import { A as DriveVisitorClient, j as DriveVisitorClientConfig } from "./contract.js";
 //#region src/internal/client/visitors.d.ts
 declare function createDriveVisitorClient(config: DriveVisitorClientConfig): DriveVisitorClient;
 declare function createVisitorSessionToken(): string;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as ListItemVersionsInput, $t as WorkspaceUsage, A as DriveVisitorClientConfig, At as UploadConfirmedPart, B as GetCurrentWorkspaceInput, Bt as VisitorChildren, Ct as RevokeItemPermissionInput, Dt as UpdateItemInput, E as DriveResponseValidators, Et as TrashItemInput, F as EffectivePermissionAction, Ft as UploadFileVersionInput, G as GetWorkspaceUsageInput, Gt as VisitorGrantPage, H as GetItemVersionInput, Ht as VisitorDownloadInput, It as UploadPartDescriptor, Jt as VisitorSession, Kt as VisitorItem, L as FileAccessContext, Lt as UploadPartResult, M as EditingFileVersionInput, Mt as UploadFilePhase, N as EditingSession, Nt as UploadFileProgress, Ot as UpdateItemPermissionInput, P as EditingSessionCreation, Pt as UploadFileProgressCallback, Qt as WorkspaceItemSearchPage, R as FolderItem, Rt as UploadSession, S as DriveEditingClientConfig, St as RestoreItemVersionInput, T as DriveOperations, Tt as SearchWorkspaceItemsInput, U as GetUploadStatusInput, Ut as VisitorGrant, V as GetItemInput, Vt as VisitorChildrenInput, W as GetVisitorGrantInput, Wt as VisitorGrantCreation, Xt as WorkspaceDiscoveryPage, Y as ListFolderChildrenInput, Yt as WorkspaceDiscoveryItem, Z as ListItemPermissionsInput, Zt as WorkspaceItemSearchItem, _ as DriveClient, _t as ReadyUpload, a as CreateDownloadInput, at as ManagedItemVersionPage, b as DriveCredentialProvider, c as CreateFolderInput, ct as ManagedLifecycleItem, d as CreateUploadPartDescriptorInput, dt as PermissionGrant, et as ListWorkspaceItemsInput, f as CreateVisitorGrantInput, ft as PermissionGrantee, g as DownloadItemResult, gt as ReadEffectiveItemPermissionsInput, h as DeleteItemInput, ht as ProtectionClassification, i as CompleteUploadInput, it as ManagedItemVersion, j as EditingFileMetadata, jt as UploadFileInput, k as DriveVisitorClient, kt as UploadCompletion, l as CreateItemPermissionInput, lt as PendingUpload, m as CurrentWorkspaceSources, n as ChangeEditingSessionInput, nt as ManagedDownloadRestorePending, o as CreateEditingSessionInput, ot as ManagedItemVersionResource, p as CurrentWorkspace, pt as PermissionMutation, qt as VisitorReadInput, r as CommitFileVersionInput, rt as ManagedItemMetadata, s as CreateFileVersionUploadInput, st as ManagedItemVersionRestoreResult, t as AbortUploadInput, tt as ManagedDownloadDescriptor, u as CreateUploadInput, ut as PermissionAction, v as DriveClientConfig, vt as RecordUploadPartInput, w as DriveOperationResult, wt as RevokeVisitorGrantInput, x as DriveEditingClient, xt as RestoreItemInput, z as FolderPage, zt as UploadStatus } from "./contract.js";
+import { $t as WorkspaceItemSearchItem, A as DriveVisitorClient, At as UploadCompletion, B as FolderPage, Bt as UploadStatus, C as DriveEditingClientConfig, Ct as RestoreItemVersionInput, D as DriveResponseValidators, Dt as TrashItemInput, E as DriveOperations, Et as SearchWorkspaceItemsInput, F as EditingSessionCreation, Ft as UploadFileProgressCallback, G as GetVisitorGrantInput, Gt as VisitorGrant, H as GetItemInput, Ht as VisitorChildrenInput, I as EffectivePermissionAction, It as UploadFileVersionInput, Jt as VisitorItem, K as GetWorkspaceUsageInput, Kt as VisitorGrantCreation, Lt as UploadPartDescriptor, M as EditingFileMetadata, Mt as UploadFileInput, N as EditingFileVersionInput, Nt as UploadFilePhase, Ot as UpdateItemInput, P as EditingSession, Pt as UploadFileProgress, Q as ListItemPermissionsInput, Qt as WorkspaceDiscoveryPage, R as FileAccessContext, Rt as UploadPartResult, S as DriveEditingClient, St as RestoreItemInput, T as DriveOperationResult, Tt as RevokeVisitorGrantInput, U as GetItemVersionInput, Ut as VisitorDownloadInput, V as GetCurrentWorkspaceInput, Vt as VisitorChildren, W as GetUploadStatusInput, X as ListFolderChildrenInput, Xt as VisitorSession, Yt as VisitorReadInput, Zt as WorkspaceDiscoveryItem, _ as DownloadItemResult, _t as ReadEffectiveItemPermissionsInput, a as CreateDownloadInput, at as ManagedItemVersion, c as CreateFolderInput, ct as ManagedItemVersionRestoreResult, d as CreateUploadPartDescriptorInput, dt as PermissionAction, en as WorkspaceItemSearchPage, et as ListItemVersionsInput, ft as PermissionGrant, g as DeleteItemInput, gt as ProtectionClassification, h as CurrentWorkspaceSources, i as CompleteUploadInput, it as ManagedItemMetadata, j as DriveVisitorClientConfig, jt as UploadConfirmedPart, kt as UpdateItemPermissionInput, l as CreateItemPermissionInput, lt as ManagedLifecycleItem, m as CurrentWorkspace, mt as PermissionMutation, n as ChangeEditingSessionInput, nt as ManagedDownloadDescriptor, o as CreateEditingSessionInput, ot as ManagedItemVersionPage, p as CreateVisitorGrantInput, pt as PermissionGrantee, qt as VisitorGrantPage, r as CommitFileVersionInput, rt as ManagedDownloadRestorePending, s as CreateFileVersionUploadInput, st as ManagedItemVersionResource, t as AbortUploadInput, tn as WorkspaceUsage, tt as ListWorkspaceItemsInput, u as CreateUploadInput, ut as PendingUpload, v as DriveClient, vt as ReadyUpload, wt as RevokeItemPermissionInput, x as DriveCredentialProvider, y as DriveClientConfig, yt as RecordUploadPartInput, z as FolderItem, zt as UploadSession } from "./contract.js";
 import { DRIVE_API_ERROR_CODES, DRIVE_API_ERROR_MESSAGES, DRIVE_API_ERROR_REASONS, DriveApiErrorCode, DriveError, DriveErrorCode, DriveErrorDetails, DriveErrorReason, DriveSdkErrorCode } from "./core.js";
 import { n as createVisitorSessionToken, t as createDriveVisitorClient } from "./contract2.js";
 import { createDriveClient, createDriveEditingClient } from "./client.js";