@finueva/drive 0.7.0 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @finueva/drive
 
+## 0.10.0
+
+### Minor Changes
+
+- 5275884: Add registered-recipient sharing and manager-only readable people pages through `registerItemRecipient` and `listItemSharingPeople`, with normalized email, canonical UTF-8 bounds, strong grant/collection preconditions, exact replay and display-only expiring snapshots. Add incoming external-share discovery and grant-bound metadata writes using the recipient's own personal credential, without issuer membership or permission-management authority.
+
+  Use additive issued-authority table families that preserve legacy grants, collections, foreign keys and canonical history while sharing the global physical capacity budget. Local populated migration, rollback/retry and legacy/issued coexistence qualification pass.
+
+  Support external Editor new-file uploads through the existing upload API, including verified zero/nonempty transfers, status, abort and exact replay. Keep upload records in additive families while sharing workspace byte usage and global capacity, route verification jobs across both checkpoint stores, and recheck current grants before atomic publication.
+
+  Support same-workspace moves with current source/destination grant proofs, stable replay and late-revocation rollback, plus the native historical-version restore operation. Resolve legacy/external ready transfer evidence for descriptors and recheck content authority and transfer identity before URL disclosure.
+
+  Wire production recipient resolution through the published `@finueva/auth@0.15.0` server SDK with mandatory private signing keys, fresh environment/audience-bound service assertions, bounded key caching and value-free failures. Do not forward incoming User authority or perform recipient lookups on ordinary file reads.
+
+  The native API has no replacement-upload field; no replacement API is introduced. Older Workers must not serve admission traffic while external reservations are active. Local backend and packed SDK qualification do not establish deployment or hosted acceptance.
+
+## 0.9.0
+
+### Minor Changes
+
+- 6560cae: Add getCurrentWorkspaceSources, listWorkspaceItems, and getWorkspaceUsage for authorized Files discovery. List recently modified items, actual incoming user/team grants, and trash with authenticated pagination, nullable genuine creation/modification/creator metadata, published version details, and retained mutation ETags. Read exact managed quota byte strings including unresolved reservations. Separate actual managed volumes from known provider kinds without fabricated connections or health. Existing SDK operations retain their contracts. The backend requires generated migration 0010 before these discovery routes are deployed.
+
+## 0.8.0
+
+### Minor Changes
+
+- 8809e4e: Add getCurrentWorkspaceSources, listWorkspaceItems, and getWorkspaceUsage for authorized Files discovery. List recently modified items, actual incoming user/team grants, and trash with authenticated pagination, nullable genuine creation/modification/creator metadata, published version details, and retained mutation ETags. Read exact managed quota byte strings including unresolved reservations. Separate actual managed volumes from known provider kinds without fabricated connections or health. Existing SDK operations retain their contracts. The backend requires generated migration 0010 before these discovery routes are deployed.
+
 ## 0.7.0
 
 ### Minor Changes

package/README.md

@@ -78,13 +78,39 @@ const drive = createDriveServerClient({
 
 Create a client per request when using user authority. A fixed `credential` string is accepted for an explicitly scoped credential, but the SDK does not create, refresh, persist, or infer sessions, cookies, provider tokens, or service authority.
 
-The server client exposes all 24 Native Drive operations plus streaming `downloadItem`, but intentionally has no Blob-only `uploadFile` method. The package root and browser client add `uploadFile`, for 26 methods total.
+The server client exposes all 27 normal-user Native Drive operations plus streaming `downloadItem`, but intentionally has no Blob-only `uploadFile` method. The package root and browser client add `uploadFile`, for 29 methods total.
+
+## Workspace Discovery
+
+`getCurrentWorkspaceSources()` returns the actual managed volume separately from
+known provider kinds. It does not invent external connections or provider health.
+
+```ts
+const recent = await drive.listWorkspaceItems({ workspaceId, view: "recent", limit: 25 });
+const shared = await drive.listWorkspaceItems({ workspaceId, view: "shared" });
+const trash = await drive.listWorkspaceItems({ workspaceId, view: "trash" });
+const usage = await drive.getWorkspaceUsage({ workspaceId });
+```
+
+Recent means recorded modification time, not viewing activity. Historical unknown
+timestamps and creator user IDs stay null; unknown modification times are excluded
+from recent results until a real mutation. Shared lists actual incoming direct
+user/team grants, not inherited descendants or all workspace-visible items. Trash
+requires delete authority and retains current ETags for the existing mutation
+methods. Continuations are encrypted, principal/root/filter-bound and short-lived;
+restart on stale-page errors. Optional `kind` and `creatorUserId` filters apply on
+the service before pagination. Quota reads require `usage:read` and return exact
+decimal byte strings, clamped availability and unresolved-reservation evidence.
+These source additions require backend migration `0010`, deployment and SDK release.
 
 ## Operations
 
 Methods use the Native API operation IDs:
 
 - `getCurrentWorkspace`
+- `getCurrentWorkspaceSources`
+- `listWorkspaceItems`
+- `getWorkspaceUsage`
 - `getItem`
 - `searchWorkspaceItems`
 - `listFolderChildren`

package/dist/client.d.ts

@@ -1,5 +1,5 @@
-import { $ as TrashItemInput, A as ListItemVersionsInput, C as FolderPage, D as GetUploadStatusInput, E as GetItemVersionInput, F as ManagedItemVersionPage, G as ProtectionClassification, I as ManagedItemVersionResource, J as RecordUploadPartInput, 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, X as RestoreItemVersionInput, Y as RestoreItemInput, at as UploadFilePhase, c as CurrentWorkspace, ct as UploadPartDescriptor, d as DriveClient, dt as UploadStatus, et as UpdateItemInput, f as DriveClientConfig, ft as WorkspaceItemSearchItem, it as UploadFileInput, j as ManagedDownloadDescriptor, 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, u as DownloadItemResult, ut as UploadSession, w as GetCurrentWorkspaceInput, z as PendingUpload } from "./contract.js";
+import { $ as ProtectionClassification, A as IncomingShareContext, B as ManagedDownloadRestorePending, C as FolderItem, Ct as WorkspaceDiscoveryPage, D as GetItemVersionInput, E as GetItemInput, Et as WorkspaceUsage, G as ManagedItemVersionRestoreResult, H as ManagedItemVersion, I as ListItemSharingPeopleInput, K as ManagedLifecycleItem, L as ListItemVersionsInput, M as ItemSharingPeoplePage, N as ListFolderChildrenInput, O as GetUploadStatusInput, P as ListIncomingSharesInput, R as ListWorkspaceItemsInput, St as WorkspaceDiscoveryItem, T as GetCurrentWorkspaceInput, Tt as WorkspaceItemSearchPage, U as ManagedItemVersionPage, V as ManagedItemMetadata, W as ManagedItemVersionResource, _t as UploadFileProgressCallback, at as RestoreItemInput, bt as UploadSession, c as CurrentWorkspace, ct as SearchWorkspaceItemsInput, d as DownloadItemResult, f as DriveClient, ft as UploadCompletion, gt as UploadFileProgress, h as DriveCredentialProvider, ht as UploadFilePhase, it as RegisteredRecipientDisplay, j as IncomingSharePage, k as GetWorkspaceUsageInput, l as CurrentWorkspaceSources, lt as TrashItemInput, mt as UploadFileInput, n as CompleteUploadInput, nt as RecordUploadPartInput, o as CreateUploadInput, ot as RestoreItemVersionInput, p as DriveClientConfig, pt as UploadConfirmedPart, q as PendingUpload, r as CreateDownloadInput, rt as RegisterItemRecipientInput, s as CreateUploadPartDescriptorInput, t as AbortUploadInput, tt as ReadyUpload, u as DeleteItemInput, ut as UpdateItemInput, vt as UploadPartDescriptor, w as FolderPage, wt as WorkspaceItemSearchItem, xt as UploadStatus, yt as UploadPartResult, z as ManagedDownloadDescriptor } from "./contract.js";
 //#region src/client.d.ts
 declare function createDriveClient(config: DriveClientConfig): DriveClient;
 //#endregion
-export { type AbortUploadInput, type CompleteUploadInput, type CreateDownloadInput, type CreateUploadInput, type CreateUploadPartDescriptorInput, type CurrentWorkspace, type DeleteItemInput, type DownloadItemResult, type DriveClient, type DriveClientConfig, type DriveCredentialProvider, type FolderItem, type FolderPage, type GetCurrentWorkspaceInput, type GetItemInput, type GetItemVersionInput, type GetUploadStatusInput, type ListFolderChildrenInput, type ListItemVersionsInput, type ManagedDownloadDescriptor, type ManagedDownloadRestorePending, type ManagedItemMetadata, type ManagedItemVersion, type ManagedItemVersionPage, type ManagedItemVersionResource, type ManagedItemVersionRestoreResult, type ManagedLifecycleItem, type PendingUpload, type ProtectionClassification, type ReadyUpload, type RecordUploadPartInput, type RestoreItemInput, type RestoreItemVersionInput, type SearchWorkspaceItemsInput, type TrashItemInput, type UpdateItemInput, 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 };
+export { type AbortUploadInput, type CompleteUploadInput, type CreateDownloadInput, type CreateUploadInput, type CreateUploadPartDescriptorInput, type CurrentWorkspace, type CurrentWorkspaceSources, type DeleteItemInput, type DownloadItemResult, type DriveClient, type DriveClientConfig, type DriveCredentialProvider, type FolderItem, type FolderPage, type GetCurrentWorkspaceInput, type GetItemInput, type GetItemVersionInput, type GetUploadStatusInput, type GetWorkspaceUsageInput, type IncomingShareContext, type IncomingSharePage, type ItemSharingPeoplePage, type ListFolderChildrenInput, type ListIncomingSharesInput, type ListItemSharingPeopleInput, type ListItemVersionsInput, type ListWorkspaceItemsInput, type ManagedDownloadDescriptor, type ManagedDownloadRestorePending, type ManagedItemMetadata, type ManagedItemVersion, type ManagedItemVersionPage, type ManagedItemVersionResource, type ManagedItemVersionRestoreResult, type ManagedLifecycleItem, type PendingUpload, type ProtectionClassification, type ReadyUpload, type RecordUploadPartInput, type RegisterItemRecipientInput, type RegisteredRecipientDisplay, type RestoreItemInput, type RestoreItemVersionInput, type SearchWorkspaceItemsInput, type TrashItemInput, type UpdateItemInput, type UploadCompletion, type UploadConfirmedPart, type UploadFileInput, type UploadFilePhase, type UploadFileProgress, type UploadFileProgressCallback, type UploadPartDescriptor, type UploadPartResult, type UploadSession, type UploadStatus, type WorkspaceDiscoveryItem, type WorkspaceDiscoveryPage, type WorkspaceItemSearchItem, type WorkspaceItemSearchPage, type WorkspaceUsage, createDriveClient };