@finueva/drive 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @finueva/drive
 
+## 0.2.0
+
+### Minor Changes
+
+- 8e472b7: Add `getCurrentWorkspace` for resolving the authenticated Drive workspace and canonical managed root.
+
+## 0.1.1
+
+### Patch Changes
+
+- ad7d7e8: Correct the package README to reflect its npm publication status.
+
 ## 0.1.0
 
 ### Minor Changes

package/README.md

@@ -1,18 +1,18 @@
 # `@finueva/drive`
 
-The public TypeScript client for Finueva Drive. The initial API is Local Experimental and is not yet published to npm.
+The public TypeScript client for Finueva Drive. The package is published to npm; the API remains Local Experimental.
 
 The package is ESM-only. Node.js 22 is the exact minimum; package CI qualifies Node.js 22 and 24. Modern browsers and Cloudflare Workers use Web Fetch, Streams, URL, and AbortSignal.
 
 ## Exports
 
-| Import                  | Runtime                                                |
-| ----------------------- | ------------------------------------------------------ |
-| `@finueva/drive`        | Browser-safe client factory, errors, and curated types |
-| `@finueva/drive/client` | Browser-safe client factory                            |
-| `@finueva/drive/server` | Request-scoped Worker and Node client factory          |
-| `@finueva/drive/core`   | Reviewed error values only                             |
-| `@finueva/drive/types`  | Curated folder, permission, and upload quota types     |
+| Import                  | Runtime                                                       |
+| ----------------------- | ------------------------------------------------------------- |
+| `@finueva/drive`        | Browser-safe client factory, errors, and curated types        |
+| `@finueva/drive/client` | Browser-safe client factory                                   |
+| `@finueva/drive/server` | Request-scoped Worker and Node client factory                 |
+| `@finueva/drive/core`   | Reviewed error values only                                    |
+| `@finueva/drive/types`  | Curated workspace, folder, permission, and upload quota types |
 
 ## Browser
 
@@ -25,9 +25,10 @@ const drive = createDriveClient({
   timeoutMilliseconds: 30_000,
 });
 
+const { data: workspace } = await drive.getCurrentWorkspace();
 const page = await drive.listFolderChildren({
-  workspaceId,
-  itemId,
+  workspaceId: workspace.workspaceId,
+  itemId: workspace.rootItemId,
   limit: 50,
 });
 ```
@@ -51,6 +52,7 @@ Create a client per request when using user authority. A fixed `credential` stri
 
 Methods use the Native API operation IDs:
 
+- `getCurrentWorkspace`
 - `listFolderChildren`
 - `createFolder`
 - `listItemPermissions`
@@ -61,6 +63,8 @@ Methods use the Native API operation IDs:
 - `createUpload`
 - `abortUpload`
 
+`getCurrentWorkspace` maps the credential's selected Auth context to the provisioned Drive workspace and canonical managed root. It accepts only an optional `{ signal }` input, never provisions as a side effect, and returns no entitlement, credential, or private persistence fields.
+
 Every mutation requires the API's explicit idempotency key when the operation defines one and, for grants, a precondition validator. Mutations are never retried automatically. Sparse updates omit `undefined` properties and preserve explicit `null` expiry.
 
 Successful calls return `{ data, status, requestId, validators }`. A successful response must carry one valid `X-Request-ID`; canonical API errors must carry the same request ID in their header and body. Any missing, malformed, or mismatched value is an `invalid_response`. The only exposed validators are `etag`, `permissionCollectionEtag`, and `permissionGrantEtag`.
@@ -86,6 +90,6 @@ Use an absolute HTTPS URL. Plain HTTP is accepted only for `localhost`, `127.0.0
 
 ## Release Status
 
-This release prepares `0.1.0` from the reviewed minor Changesets. Qualification builds the exact compiled Drive Worker, obtains `/api/v1/openapi.json` through Miniflare, checks generated types byte-for-byte, packs the package, and installs that tarball into clean external projects with lifecycle scripts disabled.
+Releases are selected by reviewed Changesets. Qualification builds the exact compiled Drive Worker, obtains `/api/v1/openapi.json` through Miniflare, checks generated types byte-for-byte, packs the package, and installs that tarball into clean external projects with lifecycle scripts disabled.
 
-`@finueva/drive` does not yet exist on npm. The source repository is private, so public provenance is unavailable. First publication must follow ADR 0016's exact retained-artifact maintainer-2FA bootstrap. The protected OIDC workflow stages only later releases after npm trusts the exact workflow; it has no npm token and cannot bootstrap the package itself.
+`@finueva/drive` is published on npm. The source repository is private, so public provenance is unavailable. ADR 0016 records the completed maintainer-2FA bootstrap; later releases use the protected OIDC workflow and npm approval without a stored npm token.

package/dist/client.d.ts

@@ -1,5 +1,5 @@
-import { O as UploadQuotaReservation, T as ReservedUploadQuota, a as CreateUploadInput, l as DriveCredentialProvider, n as AbortedUploadQuota, o as DriveClient, s as DriveClientConfig, t as AbortUploadInput } from "./contract.js";
+import { A as UploadQuotaReservation, D as ReservedUploadQuota, _ as FolderPage, a as CreateUploadInput, c as DriveClientConfig, g as FolderItem, n as AbortedUploadQuota, o as CurrentWorkspace, s as DriveClient, t as AbortUploadInput, u as DriveCredentialProvider, v as GetCurrentWorkspaceInput, y as ListFolderChildrenInput } from "./contract.js";
 //#region src/client.d.ts
 declare function createDriveClient(config: DriveClientConfig): DriveClient;
 //#endregion
-export { type AbortUploadInput, type AbortedUploadQuota, type CreateUploadInput, type DriveClient, type DriveClientConfig, type DriveCredentialProvider, type ReservedUploadQuota, type UploadQuotaReservation, createDriveClient };
+export { type AbortUploadInput, type AbortedUploadQuota, type CreateUploadInput, type CurrentWorkspace, type DriveClient, type DriveClientConfig, type DriveCredentialProvider, type FolderItem, type FolderPage, type GetCurrentWorkspaceInput, type ListFolderChildrenInput, type ReservedUploadQuota, type UploadQuotaReservation, createDriveClient };