@finueva/drive 0.29.0 → 0.31.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @finueva/drive
 
+## 0.31.0
+
+### Minor Changes
+
+- 910abd4: Add private item favourites and sidebar counts. `starItem` and `unstarItem` star or unstar one item for the caller; both are idempotent, a star needs current listing authority over the active item (`404 resource_not_found` otherwise) and never changes the item, its revision or any grant. A caller keeps at most 1,000 visible stars per workspace (stars on items they can no longer list do not count); another star is a nonretryable `409 precondition_failed` with reason `favorite_limit_reached`. `listFavoriteItems` pages the caller's starred items they can still list, in item order; trashed, deleted and no-longer-authorized items are omitted and reappear if access returns. `getWorkspaceCounts` returns `allItems`, `sharedWithMe`, `media` (current `image/*` or `video/*` files), `trash` and `favorites`, each authorized exactly like its listing and capped at `999` with `capped: true`; a count is optional in the contract and omitted if Drive cannot compute it exactly. `listWorkspaceItems({ includeFavorite: true })` and `listFolderChildren({ include })` with `favorite`, `favorite,metadata` or `metadata,favorite` add the caller's `favorite` flag to each item. Requires a Drive backend that serves `/api/v1/workspaces/{workspaceId}/favorites`, `/counts` and `/items/{itemId}/favorite`.
+
+## 0.30.0
+
+### Minor Changes
+
+- 6764e73: Add `registerItemRecipients`, which shares one item with up to 15 registered recipients in one request. Every new grant commits atomically under one collection `If-Match` and one `Idempotency-Key`; results report each recipient in request order as `added` (or replayed), `already_present` or `refused` with `recipient_unavailable`, `registration_conflict` or `duplicate_recipient`. Resolver throttling or outage fails the whole batch before any write; reusing the batch key for a different batch is `409 idempotency_conflict`. Workspace sharing ceilings apply to the whole batch: needing more grants or history than remain is a nonretryable `409 precondition_failed` with reason `sharing_grant_limit_reached` or `sharing_history_limit_reached`, and nothing is written. Requires a Drive backend that serves `POST /api/v1/workspaces/{workspaceId}/items/{itemId}/sharing/batch`.
+
+  Deployment order: the matching Drive backend signs recipient assertions with `actorUserId`, which Auth accepts only from Ifkafin/auth#399. Deploy Auth #399 (with its migration `0090`) before that Drive backend; an older Auth rejects the assertion and every recipient registration fails with `identity_authority_unavailable`.
+
+### Patch Changes
+
+- 7a4f1d7: Accept a file access `validUntil` from 60 seconds before to 120 seconds after the device clock. The SDK previously rejected any value more than 60 seconds ahead, so a client clock running even a second behind Drive failed every healthy `getFileAccessContext` answer with `invalid_response`. Drive now issues the expiry at 55 seconds so older SDKs stop failing too.
+- ff86503: Recognize `sharing_grant_limit_reached` and `sharing_history_limit_reached` error reasons on nonretryable `409 precondition_failed` permission and registered-sharing refusals. These distinguish the retained 64-grant and 4,160-change workspace ceilings from temporary sharing maintenance failures.
+
 ## 0.29.0
 
 ### Minor Changes

package/README.md

@@ -134,6 +134,7 @@ Methods use the current API operation IDs; `downloadItem` and `uploadVerifiedFil
 - `getWorkspaceSharingPolicy`
 - `updateWorkspaceSharingPolicy`
 - `registerItemRecipient`
+- `registerItemRecipients`
 - `listItemSharingPeople`
 - `listIncomingShares`
 - `getCurrentWorkspace`

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { $ as ListFolderChildrenInput, A as DriveUploadConfig, At as RecoverVerifiedTransferInput, B as FolderListedItem, Bt as UpdateItemInput, C as DriveEditingClientConfig, Dt as PublishVerifiedTransferInput, Et as ProtectionClassification, G as GetVisitorGrantInput, Gt as UploadFileProgressCallback, H as GetCurrentWorkspaceInput, Ht as UpdateWorkspaceSharingPolicyInput, It as RevokeVisitorGrantInput, J as IncomingItemPage, Jt as UploadVerifiedFileInput, K as GetWorkspaceUsageInput, Kt as UploadFileStage, L as FileAccessContext, Lt as SearchWorkspaceItemsInput, M as DriveVisitorClientConfig, Mt as RegisteredRecipientDisplay, N as EditingSession, Nt as RestoreItemInput, Ot as PublishedVerifiedTransfer, P as EditingSessionCreation, Pt as RestoreItemVersionInput, Q as ItemSharingPeoplePage, R as FolderItem, Rt as TransferItemOwnershipInput, S as DriveEditingClient, Tt as PreparedVerifiedTransfer, U as GetItemInput, Ut as UploadFilePhase, V as FolderPage, W as GetItemVersionInput, Wt as UploadFileProgress, X as IncomingSharePage, Xt as VisitorChildren, Y as IncomingShareContext, Yt as VerifiedTransferOperations, Z as ItemOwnershipTransfer, _ as DownloadItemResult, _t as OwnedItem, a as CollectOwnedItemsInput, an as VisitorSession, at as ListOwnedItemsInput, c as CreateEditingSessionInput, cn as WorkspaceItemSearchItem, ct as ManagedDownloadRestorePending, dn as WorkspaceUsage, dt as ManagedItemVersionPage, en as VisitorGrant, et as ListIncomingItemsInput, f as CreateVisitorGrantInput, ft as ManagedItemVersionResource, g as DeleteItemInput, h as CurrentWorkspaceSources, i as ChangeEditingSessionInput, it as ListItemVersionsInput, j as DriveVisitorClient, jt as RegisterItemRecipientInput, ln as WorkspaceItemSearchPage, lt as ManagedItemMetadata, m as CurrentWorkspace, mt as ManagedLifecycleItem, n as ArchiveItemInput, nn as VisitorGrantPage, o as CollectedOwnedItems, on as WorkspaceDiscoveryItem, ot as ListWorkspaceItemsInput, pt as ManagedItemVersionRestoreResult, q as IncomingItemMetadata, qt as UploadSmallVerifiedFileInput, r as ArchivedItem, rn as VisitorItem, rt as ListItemSharingPeopleInput, s as CreateDownloadInput, sn as WorkspaceDiscoveryPage, st as ManagedDownloadDescriptor, t as AdmittedVerifiedTransfer, tn as VisitorGrantCreation, tt as ListIncomingSharesInput, un as WorkspaceSharingPolicy, ut as ManagedItemVersion, v as DriveClient, vt as OwnedItemPage, wt as PrepareVerifiedTransferInput, x as DriveCredentialProvider, y as DriveClientConfig, z as FolderListInclude, zt as TrashItemInput } from "./contract.js";
+import { $ as ItemRecipientBatchEntry, $t as UploadFileProgressCallback, A as DriveUploadConfig, At as PreparedVerifiedTransfer, B as FolderListedItem, Bt as RestoreItemVersionInput, C as DriveEditingClientConfig, Ct as OwnedItemPage, Ft as RecoverVerifiedTransferInput, G as GetVisitorGrantInput, Gt as TransferItemOwnershipInput, H as GetCurrentWorkspaceInput, Ht as RevokeVisitorGrantInput, It as RegisterItemRecipientInput, J as IncomingItemPage, Jt as UpdateItemInput, K as GetWorkspaceUsageInput, Kt as TrashItemInput, L as FileAccessContext, Lt as RegisterItemRecipientsInput, M as DriveVisitorClientConfig, Mt as PublishVerifiedTransferInput, N as EditingSession, Nt as PublishedVerifiedTransfer, P as EditingSessionCreation, Q as ItemOwnershipTransfer, Qt as UploadFileProgress, R as FolderItem, Rt as RegisteredRecipientDisplay, S as DriveEditingClient, Sn as WorkspaceUsage, St as OwnedItem, U as GetItemInput, Ut as SearchWorkspaceItemsInput, V as FolderPage, W as GetItemVersionInput, Wt as StarItemInput, X as IncomingSharePage, Xt as UpdateWorkspaceSharingPolicyInput, Y as IncomingShareContext, Z as ItemFavorite, Zt as UploadFilePhase, _ as DownloadItemResult, _n as WorkspaceDiscoveryItem, _t as ManagedItemVersionResource, a as CollectOwnedItemsInput, at as ListIncomingItemsInput, bn as WorkspaceItemSearchPage, c as CreateEditingSessionInput, cn as VisitorGrant, ct as ListItemSharingPeopleInput, dn as VisitorItem, dt as ListWorkspaceItemsInput, en as UploadFileStage, et as ItemSharingBatch, f as CreateVisitorGrantInput, ft as ManagedDownloadDescriptor, g as DeleteItemInput, gn as WorkspaceCountsInput, gt as ManagedItemVersionPage, h as CurrentWorkspaceSources, hn as WorkspaceCounts, ht as ManagedItemVersion, i as ChangeEditingSessionInput, in as VisitorChildren, it as ListFolderChildrenInput, j as DriveVisitorClient, jt as ProtectionClassification, kt as PrepareVerifiedTransferInput, ln as VisitorGrantCreation, lt as ListItemVersionsInput, m as CurrentWorkspace, mn as WorkspaceCount, mt as ManagedItemMetadata, n as ArchiveItemInput, nn as UploadVerifiedFileInput, nt as ItemSharingPeoplePage, o as CollectedOwnedItems, ot as ListIncomingSharesInput, pn as VisitorSession, pt as ManagedDownloadRestorePending, q as IncomingItemMetadata, qt as UnstarItemInput, r as ArchivedItem, rn as VerifiedTransferOperations, rt as ListFavoriteItemsInput, s as CreateDownloadInput, t as AdmittedVerifiedTransfer, tn as UploadSmallVerifiedFileInput, tt as ItemSharingBatchResult, un as VisitorGrantPage, ut as ListOwnedItemsInput, v as DriveClient, vn as WorkspaceDiscoveryPage, vt as ManagedItemVersionRestoreResult, x as DriveCredentialProvider, xn as WorkspaceSharingPolicy, y as DriveClientConfig, yn as WorkspaceItemSearchItem, yt as ManagedLifecycleItem, z as FolderListInclude, zt as RestoreItemInput } from "./contract.js";
 import { n as createDriveVisitorClient, r as createVisitorSessionToken, t as collectOwnedItems } from "./contract2.js";
 import { n as createDriveEditingClient, r as createUploadProgressFetch, t as createDriveClient } from "./contract3.js";
-export { type AdmittedVerifiedTransfer, type ArchiveItemInput, type ArchivedItem, type ChangeEditingSessionInput, type CollectOwnedItemsInput, type CollectedOwnedItems, type CreateDownloadInput, type CreateEditingSessionInput, type CreateVisitorGrantInput, type CurrentWorkspace, type CurrentWorkspaceSources, type DeleteItemInput, type DownloadItemResult, type DriveClient, type DriveClientConfig, type DriveCredentialProvider, type DriveEditingClient, type DriveEditingClientConfig, type DriveUploadConfig, type DriveVisitorClient, type DriveVisitorClientConfig, type EditingSession, type EditingSessionCreation, type FileAccessContext, type FolderItem, type FolderListInclude, type FolderListedItem, type FolderPage, type GetCurrentWorkspaceInput, type GetItemInput, type GetItemVersionInput, type GetVisitorGrantInput, type GetWorkspaceUsageInput, type IncomingItemMetadata, type IncomingItemPage, type IncomingShareContext, type IncomingSharePage, type ItemOwnershipTransfer, type ItemSharingPeoplePage, type ListFolderChildrenInput, type ListIncomingItemsInput, type ListIncomingSharesInput, type ListItemSharingPeopleInput, type ListItemVersionsInput, type ListOwnedItemsInput, type ListWorkspaceItemsInput, type ManagedDownloadDescriptor, type ManagedDownloadRestorePending, type ManagedItemMetadata, type ManagedItemVersion, type ManagedItemVersionPage, type ManagedItemVersionResource, type ManagedItemVersionRestoreResult, type ManagedLifecycleItem, type OwnedItem, type OwnedItemPage, type PrepareVerifiedTransferInput, type PreparedVerifiedTransfer, type ProtectionClassification, type PublishVerifiedTransferInput, type PublishedVerifiedTransfer, type RecoverVerifiedTransferInput, type RegisterItemRecipientInput, type RegisteredRecipientDisplay, type RestoreItemInput, type RestoreItemVersionInput, type RevokeVisitorGrantInput, type SearchWorkspaceItemsInput, type TransferItemOwnershipInput, type TrashItemInput, type UpdateItemInput, type UpdateWorkspaceSharingPolicyInput, type UploadFilePhase, type UploadFileProgress, type UploadFileProgressCallback, type UploadFileStage, type UploadSmallVerifiedFileInput, type UploadVerifiedFileInput, type VerifiedTransferOperations, type VisitorChildren, type VisitorGrant, type VisitorGrantCreation, type VisitorGrantPage, type VisitorItem, type VisitorSession, type WorkspaceDiscoveryItem, type WorkspaceDiscoveryPage, type WorkspaceItemSearchItem, type WorkspaceItemSearchPage, type WorkspaceSharingPolicy, type WorkspaceUsage, collectOwnedItems, createDriveClient, createDriveEditingClient, createDriveVisitorClient, createUploadProgressFetch, createVisitorSessionToken };
+export { type AdmittedVerifiedTransfer, type ArchiveItemInput, type ArchivedItem, type ChangeEditingSessionInput, type CollectOwnedItemsInput, type CollectedOwnedItems, type CreateDownloadInput, type CreateEditingSessionInput, type CreateVisitorGrantInput, type CurrentWorkspace, type CurrentWorkspaceSources, type DeleteItemInput, type DownloadItemResult, type DriveClient, type DriveClientConfig, type DriveCredentialProvider, type DriveEditingClient, type DriveEditingClientConfig, type DriveUploadConfig, type DriveVisitorClient, type DriveVisitorClientConfig, type EditingSession, type EditingSessionCreation, type FileAccessContext, type FolderItem, type FolderListInclude, type FolderListedItem, type FolderPage, type GetCurrentWorkspaceInput, type GetItemInput, type GetItemVersionInput, type GetVisitorGrantInput, type GetWorkspaceUsageInput, type IncomingItemMetadata, type IncomingItemPage, type IncomingShareContext, type IncomingSharePage, type ItemFavorite, type ItemOwnershipTransfer, type ItemRecipientBatchEntry, type ItemSharingBatch, type ItemSharingBatchResult, type ItemSharingPeoplePage, type ListFavoriteItemsInput, type ListFolderChildrenInput, type ListIncomingItemsInput, type ListIncomingSharesInput, type ListItemSharingPeopleInput, type ListItemVersionsInput, type ListOwnedItemsInput, type ListWorkspaceItemsInput, type ManagedDownloadDescriptor, type ManagedDownloadRestorePending, type ManagedItemMetadata, type ManagedItemVersion, type ManagedItemVersionPage, type ManagedItemVersionResource, type ManagedItemVersionRestoreResult, type ManagedLifecycleItem, type OwnedItem, type OwnedItemPage, type PrepareVerifiedTransferInput, type PreparedVerifiedTransfer, type ProtectionClassification, type PublishVerifiedTransferInput, type PublishedVerifiedTransfer, type RecoverVerifiedTransferInput, type RegisterItemRecipientInput, type RegisterItemRecipientsInput, type RegisteredRecipientDisplay, type RestoreItemInput, type RestoreItemVersionInput, type RevokeVisitorGrantInput, type SearchWorkspaceItemsInput, type StarItemInput, type TransferItemOwnershipInput, type TrashItemInput, type UnstarItemInput, type UpdateItemInput, type UpdateWorkspaceSharingPolicyInput, type UploadFilePhase, type UploadFileProgress, type UploadFileProgressCallback, type UploadFileStage, type UploadSmallVerifiedFileInput, type UploadVerifiedFileInput, type VerifiedTransferOperations, type VisitorChildren, type VisitorGrant, type VisitorGrantCreation, type VisitorGrantPage, type VisitorItem, type VisitorSession, type WorkspaceCount, type WorkspaceCounts, type WorkspaceCountsInput, type WorkspaceDiscoveryItem, type WorkspaceDiscoveryPage, type WorkspaceItemSearchItem, type WorkspaceItemSearchPage, type WorkspaceSharingPolicy, type WorkspaceUsage, collectOwnedItems, createDriveClient, createDriveEditingClient, createDriveVisitorClient, createUploadProgressFetch, createVisitorSessionToken };