@vol-a/client 0.0.0-stage → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +284 -2
  3. package/dist/access-tokens.d.ts +21 -0
  4. package/dist/access-tokens.d.ts.map +1 -0
  5. package/dist/access-tokens.js +34 -0
  6. package/dist/access-tokens.js.map +1 -0
  7. package/dist/body.d.ts +40 -0
  8. package/dist/body.d.ts.map +1 -0
  9. package/dist/body.js +112 -0
  10. package/dist/body.js.map +1 -0
  11. package/dist/client.d.ts +185 -0
  12. package/dist/client.d.ts.map +1 -0
  13. package/dist/client.js +311 -0
  14. package/dist/client.js.map +1 -0
  15. package/dist/env.d.ts +19 -0
  16. package/dist/env.d.ts.map +1 -0
  17. package/dist/env.js +52 -0
  18. package/dist/env.js.map +1 -0
  19. package/dist/errors.d.ts +43 -0
  20. package/dist/errors.d.ts.map +1 -0
  21. package/dist/errors.js +93 -0
  22. package/dist/errors.js.map +1 -0
  23. package/dist/files.d.ts +144 -0
  24. package/dist/files.d.ts.map +1 -0
  25. package/dist/files.js +239 -0
  26. package/dist/files.js.map +1 -0
  27. package/dist/folders.d.ts +35 -0
  28. package/dist/folders.d.ts.map +1 -0
  29. package/dist/folders.js +62 -0
  30. package/dist/folders.js.map +1 -0
  31. package/dist/index.d.ts +21 -0
  32. package/dist/index.d.ts.map +1 -0
  33. package/dist/index.js +12 -0
  34. package/dist/index.js.map +1 -0
  35. package/dist/keyrings.d.ts +44 -0
  36. package/dist/keyrings.d.ts.map +1 -0
  37. package/dist/keyrings.js +111 -0
  38. package/dist/keyrings.js.map +1 -0
  39. package/dist/management.d.ts +47 -0
  40. package/dist/management.d.ts.map +1 -0
  41. package/dist/management.js +65 -0
  42. package/dist/management.js.map +1 -0
  43. package/dist/shares.d.ts +87 -0
  44. package/dist/shares.d.ts.map +1 -0
  45. package/dist/shares.js +144 -0
  46. package/dist/shares.js.map +1 -0
  47. package/dist/uploads.d.ts +112 -0
  48. package/dist/uploads.d.ts.map +1 -0
  49. package/dist/uploads.js +290 -0
  50. package/dist/uploads.js.map +1 -0
  51. package/package.json +48 -3
@@ -0,0 +1,21 @@
1
+ export { AccessTokensApi } from "./access-tokens.js";
2
+ export type { ByteSource, MultipartBody, MultipartFile, StreamSource, UploadSource, } from "./body.js";
3
+ export { multipartBody } from "./body.js";
4
+ export type { CallOptions, ContentKey, LockOnUnloadOptions, QueryValue, RequestOptions, ResponseSchema, VolaClientOptions, } from "./client.js";
5
+ export { ok2xx, VolaClient } from "./client.js";
6
+ export { base64ToBytes, bytesToBase64, bytesToBase64Url, isBrowser, randomBytes } from "./env.js";
7
+ export type { VolaErrorInit } from "./errors.js";
8
+ export { errorFromResponse, VolaApiError, VolaError, VolaIntegrityError, VolaLockedError, } from "./errors.js";
9
+ export type { ByteRange, DownloadOptions, InfoOptions, ListOptions, ThumbnailOptions, ThumbnailResult, UploadOptions, UploadPlacement, VersionsOptions, } from "./files.js";
10
+ export { FilesApi, filePath, instancePath, rangeHeader } from "./files.js";
11
+ export type { FolderDeleteOptions } from "./folders.js";
12
+ export { FoldersApi, folderPath } from "./folders.js";
13
+ export type { UnlockOptions } from "./keyrings.js";
14
+ export { KeyringsApi } from "./keyrings.js";
15
+ export type { StatsOptions, TransferInput } from "./management.js";
16
+ export { AdminApi, KeysApi, StatsApi } from "./management.js";
17
+ export type { CallerGrant, OpenShareOptions, ShareCreateInput, ShareListOptions, } from "./shares.js";
18
+ export { callerGrant, openShareUrl, parseShareUrl, SharesApi } from "./shares.js";
19
+ export type { FingerprintStore, ResumableCreate, ResumableOptions, ResumableResult, UploadProgress, UploadProtocol, UploadState, } from "./uploads.js";
20
+ export { DEFAULT_CHUNK_SIZE, defaultFingerprintStore, MemoryFingerprintStore, storageFingerprintStore, UploadsApi, } from "./uploads.js";
21
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,YAAY,GACb,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,YAAY,EACV,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAClG,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,SAAS,EACT,eAAe,EACf,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC3E,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAClF,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,UAAU,GACX,MAAM,cAAc,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,12 @@
1
+ export { AccessTokensApi } from "./access-tokens.js";
2
+ export { multipartBody } from "./body.js";
3
+ export { ok2xx, VolaClient } from "./client.js";
4
+ export { base64ToBytes, bytesToBase64, bytesToBase64Url, isBrowser, randomBytes } from "./env.js";
5
+ export { errorFromResponse, VolaApiError, VolaError, VolaIntegrityError, VolaLockedError, } from "./errors.js";
6
+ export { FilesApi, filePath, instancePath, rangeHeader } from "./files.js";
7
+ export { FoldersApi, folderPath } from "./folders.js";
8
+ export { KeyringsApi } from "./keyrings.js";
9
+ export { AdminApi, KeysApi, StatsApi } from "./management.js";
10
+ export { callerGrant, openShareUrl, parseShareUrl, SharesApi } from "./shares.js";
11
+ export { DEFAULT_CHUNK_SIZE, defaultFingerprintStore, MemoryFingerprintStore, storageFingerprintStore, UploadsApi, } from "./uploads.js";
12
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAQrD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAU1C,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAElG,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,eAAe,GAChB,MAAM,aAAa,CAAC;AAYrB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE3E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAO9D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAUlF,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,UAAU,GACX,MAAM,cAAc,CAAC"}
@@ -0,0 +1,44 @@
1
+ import { type KeyringCreated, type KeyringDeletePreview, type KeyringResetResult, type KeyringStatus, type Recovered, type Unlocked } from "@vol-a/core";
2
+ import type { CallOptions, VolaClient } from "./client.js";
3
+ export interface UnlockOptions extends CallOptions {
4
+ /** Keep the token in the instance (every later call sends it). Default `true`. */
5
+ remember?: boolean | undefined;
6
+ }
7
+ /**
8
+ * The keyring of the instance's `userId` (`/keyrings/me`, scope `keyrings:write`): a PIN
9
+ * that locks the keys of that principal's `keyring`-encrypted files. An unlock is a token
10
+ * the instance keeps in memory and sends as `X-Vola-Unlock` until `lock()`, `changePin()`,
11
+ * `recover()` or `reset()` — or the server's sliding TTL — ends it. The PIN, the recovery
12
+ * key and the token go in request bodies and headers, never in a URL.
13
+ */
14
+ export declare class KeyringsApi {
15
+ private readonly client;
16
+ constructor(client: VolaClient);
17
+ /** `GET /keyrings/me/status`: has a PIN, locked, the token's remaining seconds, a lock-out. Does not extend the token. */
18
+ status(options?: CallOptions): Promise<KeyringStatus>;
19
+ /** `POST /keyrings/me {pin}` → `201 {keyring_id, recovery_key}`: the recovery key is shown this once — store it with the user. */
20
+ setup(pin: string, options?: CallOptions): Promise<KeyringCreated>;
21
+ /** `PUT /keyrings/me/pin {current_pin, new_pin}`: every token of the principal dies, this instance's too. */
22
+ changePin(currentPin: string, newPin: string, options?: CallOptions): Promise<void>;
23
+ /** `POST /keyrings/me/recover {recovery_key, new_pin}` → a NEW recovery key (the old one is retired). */
24
+ recover(recoveryKey: string, newPin: string, options?: CallOptions): Promise<Recovered>;
25
+ /**
26
+ * `POST /keyrings/me/unlock {pin}` → `{token, expires_in}`; the instance keeps the token
27
+ * (`remember: false` leaves that to the caller). `403 pin_wrong` (with `attempts` in
28
+ * `details`), `429 too_many_attempts` with `retryAfter` while locked out — even for the right PIN.
29
+ */
30
+ unlock(pin: string, options?: UnlockOptions): Promise<Unlocked>;
31
+ /** `DELETE /keyrings/me/unlock`: ends the token the instance holds (or `options.unlock`) and forgets it. Idempotent; nothing held → nothing sent. */
32
+ lock(options?: CallOptions): Promise<void>;
33
+ /** `POST /keyrings/me/unlock/close {token}`: the beacon alias — ends `token` without an API key (what `lockOnUnload` sends). */
34
+ close(token: string, options?: Pick<CallOptions, "signal">): Promise<void>;
35
+ /** `POST /keyrings/me/reset {confirm: "RESET"}`: the crypto-shred of every file under the keyring and of the keyring. Re-authenticate the person first. */
36
+ reset(options?: CallOptions): Promise<KeyringResetResult>;
37
+ /** `GET /keyrings/me/delete-preview`: what a reset would remove. */
38
+ deletePreview(options?: CallOptions): Promise<KeyringDeletePreview>;
39
+ /** Admin: `GET /keyrings/by-principal/:principal/status`. */
40
+ statusOf(principal: string, options?: CallOptions): Promise<KeyringStatus>;
41
+ /** Admin: `POST /keyrings/by-principal/:principal/reset`. */
42
+ resetOf(principal: string, options?: CallOptions): Promise<KeyringResetResult>;
43
+ }
44
+ //# sourceMappingURL=keyrings.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"keyrings.d.ts","sourceRoot":"","sources":["../src/keyrings.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,oBAAoB,EAEzB,KAAK,kBAAkB,EAEvB,KAAK,aAAa,EAGlB,KAAK,SAAS,EAEd,KAAK,QAAQ,EAEd,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC;AAED;;;;;;GAMG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,0HAA0H;IAC1H,MAAM,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAIzD,kIAAkI;IAClI,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;IAQtE,6GAA6G;IACvG,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7F,yGAAyG;IACnG,OAAO,CACX,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,SAAS,CAAC;IAUrB;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAWzE,qJAAqJ;IAC/I,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAapD,gIAAgI;IAC1H,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpF,2JAA2J;IACrJ,KAAK,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAUnE,oEAAoE;IACpE,aAAa,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIvE,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAQ9E,6DAA6D;IAC7D,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAOnF"}
@@ -0,0 +1,111 @@
1
+ import { KeyringCreatedSchema, KeyringDeletePreviewSchema, KeyringResetResultSchema, KeyringStatusSchema, RESET_CONFIRMATION, RecoveredSchema, UnlockedSchema, } from "@vol-a/core";
2
+ /**
3
+ * The keyring of the instance's `userId` (`/keyrings/me`, scope `keyrings:write`): a PIN
4
+ * that locks the keys of that principal's `keyring`-encrypted files. An unlock is a token
5
+ * the instance keeps in memory and sends as `X-Vola-Unlock` until `lock()`, `changePin()`,
6
+ * `recover()` or `reset()` — or the server's sliding TTL — ends it. The PIN, the recovery
7
+ * key and the token go in request bodies and headers, never in a URL.
8
+ */
9
+ export class KeyringsApi {
10
+ client;
11
+ constructor(client) {
12
+ this.client = client;
13
+ }
14
+ /** `GET /keyrings/me/status`: has a PIN, locked, the token's remaining seconds, a lock-out. Does not extend the token. */
15
+ status(options = {}) {
16
+ return this.client.json("/keyrings/me/status", KeyringStatusSchema, options);
17
+ }
18
+ /** `POST /keyrings/me {pin}` → `201 {keyring_id, recovery_key}`: the recovery key is shown this once — store it with the user. */
19
+ setup(pin, options = {}) {
20
+ return this.client.json("/keyrings/me", KeyringCreatedSchema, {
21
+ method: "POST",
22
+ json: { pin },
23
+ ...options,
24
+ });
25
+ }
26
+ /** `PUT /keyrings/me/pin {current_pin, new_pin}`: every token of the principal dies, this instance's too. */
27
+ async changePin(currentPin, newPin, options = {}) {
28
+ const response = await this.client.request("/keyrings/me/pin", {
29
+ method: "PUT",
30
+ json: { current_pin: currentPin, new_pin: newPin },
31
+ ...options,
32
+ });
33
+ await response.body?.cancel().catch(() => undefined);
34
+ this.client.setUnlock(null);
35
+ }
36
+ /** `POST /keyrings/me/recover {recovery_key, new_pin}` → a NEW recovery key (the old one is retired). */
37
+ async recover(recoveryKey, newPin, options = {}) {
38
+ const recovered = await this.client.json("/keyrings/me/recover", RecoveredSchema, {
39
+ method: "POST",
40
+ json: { recovery_key: recoveryKey, new_pin: newPin },
41
+ ...options,
42
+ });
43
+ this.client.setUnlock(null);
44
+ return recovered;
45
+ }
46
+ /**
47
+ * `POST /keyrings/me/unlock {pin}` → `{token, expires_in}`; the instance keeps the token
48
+ * (`remember: false` leaves that to the caller). `403 pin_wrong` (with `attempts` in
49
+ * `details`), `429 too_many_attempts` with `retryAfter` while locked out — even for the right PIN.
50
+ */
51
+ async unlock(pin, options = {}) {
52
+ const { remember, ...call } = options;
53
+ const unlocked = await this.client.json("/keyrings/me/unlock", UnlockedSchema, {
54
+ method: "POST",
55
+ json: { pin },
56
+ ...call,
57
+ });
58
+ if (remember ?? true)
59
+ this.client.setUnlock(unlocked.token);
60
+ return unlocked;
61
+ }
62
+ /** `DELETE /keyrings/me/unlock`: ends the token the instance holds (or `options.unlock`) and forgets it. Idempotent; nothing held → nothing sent. */
63
+ async lock(options = {}) {
64
+ if (!options.unlock && !this.client.unlocked)
65
+ return;
66
+ try {
67
+ const response = await this.client.request("/keyrings/me/unlock", {
68
+ method: "DELETE",
69
+ ...options,
70
+ });
71
+ await response.body?.cancel().catch(() => undefined);
72
+ }
73
+ finally {
74
+ if (!options.unlock)
75
+ this.client.setUnlock(null);
76
+ }
77
+ }
78
+ /** `POST /keyrings/me/unlock/close {token}`: the beacon alias — ends `token` without an API key (what `lockOnUnload` sends). */
79
+ async close(token, options = {}) {
80
+ const response = await this.client.request("/keyrings/me/unlock/close", {
81
+ method: "POST",
82
+ anonymous: true,
83
+ json: { token },
84
+ signal: options.signal,
85
+ });
86
+ await response.body?.cancel().catch(() => undefined);
87
+ }
88
+ /** `POST /keyrings/me/reset {confirm: "RESET"}`: the crypto-shred of every file under the keyring and of the keyring. Re-authenticate the person first. */
89
+ async reset(options = {}) {
90
+ const result = await this.client.json("/keyrings/me/reset", KeyringResetResultSchema, {
91
+ method: "POST",
92
+ json: { confirm: RESET_CONFIRMATION },
93
+ ...options,
94
+ });
95
+ this.client.setUnlock(null);
96
+ return result;
97
+ }
98
+ /** `GET /keyrings/me/delete-preview`: what a reset would remove. */
99
+ deletePreview(options = {}) {
100
+ return this.client.json("/keyrings/me/delete-preview", KeyringDeletePreviewSchema, options);
101
+ }
102
+ /** Admin: `GET /keyrings/by-principal/:principal/status`. */
103
+ statusOf(principal, options = {}) {
104
+ return this.client.json(`/keyrings/by-principal/${encodeURIComponent(principal)}/status`, KeyringStatusSchema, options);
105
+ }
106
+ /** Admin: `POST /keyrings/by-principal/:principal/reset`. */
107
+ resetOf(principal, options = {}) {
108
+ return this.client.json(`/keyrings/by-principal/${encodeURIComponent(principal)}/reset`, KeyringResetResultSchema, { method: "POST", json: { confirm: RESET_CONFIRMATION }, ...options });
109
+ }
110
+ }
111
+ //# sourceMappingURL=keyrings.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"keyrings.js","sourceRoot":"","sources":["../src/keyrings.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,47 @@
1
+ import { type ApiKey, type ApiKeyCreate, type ApiKeyCreated, type ApiKeyList, type StorageStats, type TenantStats, type TransferResult } from "@vol-a/core";
2
+ import type { CallOptions, VolaClient } from "./client.js";
3
+ export interface StatsOptions extends CallOptions {
4
+ /** Recompute the snapshot now instead of reading the cached one. */
5
+ recompute?: boolean | undefined;
6
+ }
7
+ /** `POST /admin/transfer` as a caller writes it (`user_map` and `dry_run` optional). */
8
+ export interface TransferInput {
9
+ from_tenant: string;
10
+ to_tenant: string;
11
+ instances: {
12
+ instance_type: string;
13
+ instance_id: string;
14
+ }[];
15
+ user_map?: Record<string, string> | undefined;
16
+ dry_run?: boolean | undefined;
17
+ }
18
+ /** Statistics (scope `files:read`). */
19
+ export declare class StatsApi {
20
+ private readonly client;
21
+ constructor(client: VolaClient);
22
+ /** `GET /stats/tenant[?recompute=1]`: the tenant's live files — count, bytes, per kind, oldest, newest. */
23
+ tenant(options?: StatsOptions): Promise<TenantStats>;
24
+ /** `GET /stats/instance/:type/:id[?recompute=1]`: the same for one instance. */
25
+ instance(type: string, id: string, options?: StatsOptions): Promise<TenantStats>;
26
+ /** `GET /stats/storage`: logical bytes and distinct blobs; an admin key also gets `physical` (and, without a tenant, the whole deployment). */
27
+ storage(options?: CallOptions): Promise<StorageStats>;
28
+ }
29
+ /** API keys of the tenant (scope `keys:write`). */
30
+ export declare class KeysApi {
31
+ private readonly client;
32
+ constructor(client: VolaClient);
33
+ /** `POST /keys {name, scopes, env, expires_at?}` → `201`: the key with its plaintext, this once. */
34
+ create(body: ApiKeyCreate, options?: CallOptions): Promise<ApiKeyCreated>;
35
+ /** `GET /keys`: the tenant's keys, newest first, never the hash. */
36
+ list(options?: CallOptions): Promise<ApiKeyList>;
37
+ /** `DELETE /keys/:id`: revoke (idempotent). */
38
+ revoke(id: string, options?: CallOptions): Promise<ApiKey>;
39
+ }
40
+ /** Cross-tenant administration (an admin key, scope `admin`). */
41
+ export declare class AdminApi {
42
+ private readonly client;
43
+ constructor(client: VolaClient);
44
+ /** `POST /admin/transfer`: move the files of instances from one tenant to another (`dry_run` counts only). */
45
+ transfer(body: TransferInput, options?: CallOptions): Promise<TransferResult>;
46
+ }
47
+ //# sourceMappingURL=management.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"management.d.ts","sourceRoot":"","sources":["../src/management.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,aAAa,EAElB,KAAK,UAAU,EAIf,KAAK,YAAY,EAEjB,KAAK,WAAW,EAEhB,KAAK,cAAc,EAEpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,oEAAoE;IACpE,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjC;AAED,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC9C,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,uCAAuC;AACvC,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,2GAA2G;IAC3G,MAAM,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAOxD,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAQpF,+IAA+I;IAC/I,OAAO,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;CAG1D;AAED,mDAAmD;AACnD,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,oGAAoG;IACpG,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAQ7E,oEAAoE;IACpE,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAIpD,+CAA+C;IAC/C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;CAM/D;AAED,iEAAiE;AACjE,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,8GAA8G;IAC9G,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;CAOlF"}
@@ -0,0 +1,65 @@
1
+ import { ApiKeyCreatedSchema, ApiKeyListSchema, ApiKeySchema, RECOMPUTE_QUERY, StorageStatsSchema, TenantStatsSchema, TransferResultSchema, } from "@vol-a/core";
2
+ /** Statistics (scope `files:read`). */
3
+ export class StatsApi {
4
+ client;
5
+ constructor(client) {
6
+ this.client = client;
7
+ }
8
+ /** `GET /stats/tenant[?recompute=1]`: the tenant's live files — count, bytes, per kind, oldest, newest. */
9
+ tenant(options = {}) {
10
+ return this.client.json("/stats/tenant", TenantStatsSchema, {
11
+ query: { [RECOMPUTE_QUERY]: options.recompute },
12
+ signal: options.signal,
13
+ });
14
+ }
15
+ /** `GET /stats/instance/:type/:id[?recompute=1]`: the same for one instance. */
16
+ instance(type, id, options = {}) {
17
+ return this.client.json(`/stats/instance/${encodeURIComponent(type)}/${encodeURIComponent(id)}`, TenantStatsSchema, { query: { [RECOMPUTE_QUERY]: options.recompute }, signal: options.signal });
18
+ }
19
+ /** `GET /stats/storage`: logical bytes and distinct blobs; an admin key also gets `physical` (and, without a tenant, the whole deployment). */
20
+ storage(options = {}) {
21
+ return this.client.json("/stats/storage", StorageStatsSchema, options);
22
+ }
23
+ }
24
+ /** API keys of the tenant (scope `keys:write`). */
25
+ export class KeysApi {
26
+ client;
27
+ constructor(client) {
28
+ this.client = client;
29
+ }
30
+ /** `POST /keys {name, scopes, env, expires_at?}` → `201`: the key with its plaintext, this once. */
31
+ create(body, options = {}) {
32
+ return this.client.json("/keys", ApiKeyCreatedSchema, {
33
+ method: "POST",
34
+ json: body,
35
+ ...options,
36
+ });
37
+ }
38
+ /** `GET /keys`: the tenant's keys, newest first, never the hash. */
39
+ list(options = {}) {
40
+ return this.client.json("/keys", ApiKeyListSchema, options);
41
+ }
42
+ /** `DELETE /keys/:id`: revoke (idempotent). */
43
+ revoke(id, options = {}) {
44
+ return this.client.json(`/keys/${encodeURIComponent(id)}`, ApiKeySchema, {
45
+ method: "DELETE",
46
+ ...options,
47
+ });
48
+ }
49
+ }
50
+ /** Cross-tenant administration (an admin key, scope `admin`). */
51
+ export class AdminApi {
52
+ client;
53
+ constructor(client) {
54
+ this.client = client;
55
+ }
56
+ /** `POST /admin/transfer`: move the files of instances from one tenant to another (`dry_run` counts only). */
57
+ transfer(body, options = {}) {
58
+ return this.client.json("/admin/transfer", TransferResultSchema, {
59
+ method: "POST",
60
+ json: body,
61
+ ...options,
62
+ });
63
+ }
64
+ }
65
+ //# sourceMappingURL=management.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"management.js","sourceRoot":"","sources":["../src/management.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,mBAAmB,EAEnB,gBAAgB,EAChB,YAAY,EACZ,eAAe,EAEf,kBAAkB,EAElB,iBAAiB,EAEjB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAiBrB,uCAAuC;AACvC,MAAM,OAAO,QAAQ;IACU;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,2GAA2G;IAC3G,MAAM,CAAC,UAAwB,EAAE;QAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,iBAAiB,EAAE;YAC1D,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE;YAC/C,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IAED,gFAAgF;IAChF,QAAQ,CAAC,IAAY,EAAE,EAAU,EAAE,UAAwB,EAAE;QAC3D,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CACrB,mBAAmB,kBAAkB,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,EAAE,CAAC,EAAE,EACvE,iBAAiB,EACjB,EAAE,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAC5E,CAAC;IACJ,CAAC;IAED,+IAA+I;IAC/I,OAAO,CAAC,UAAuB,EAAE;QAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;CACF;AAED,mDAAmD;AACnD,MAAM,OAAO,OAAO;IACW;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,oGAAoG;IACpG,MAAM,CAAC,IAAkB,EAAE,UAAuB,EAAE;QAClD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,mBAAmB,EAAE;YACpD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI;YACV,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED,oEAAoE;IACpE,IAAI,CAAC,UAAuB,EAAE;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED,+CAA+C;IAC/C,MAAM,CAAC,EAAU,EAAE,UAAuB,EAAE;QAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,YAAY,EAAE;YACvE,MAAM,EAAE,QAAQ;YAChB,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;CACF;AAED,iEAAiE;AACjE,MAAM,OAAO,QAAQ;IACU;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,8GAA8G;IAC9G,QAAQ,CAAC,IAAmB,EAAE,UAAuB,EAAE;QACrD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,oBAAoB,EAAE;YAC/D,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI;YACV,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;CACF"}
@@ -0,0 +1,87 @@
1
+ import { type ShareCreated, type SharedFolderListing, type ShareInfo, type ShareList } from "@vol-a/core";
2
+ import type { CallOptions, VolaClient } from "./client.js";
3
+ import { type ByteRange } from "./files.js";
4
+ /** `POST /shares` as a caller writes it (the schema's defaults are optional here). */
5
+ export interface ShareCreateInput {
6
+ file_id?: string | undefined;
7
+ folder?: {
8
+ instance_type: string;
9
+ instance_id: string;
10
+ path: string;
11
+ } | undefined;
12
+ scope?: "PUBLIC_LINK" | "TENANT" | "INSTANCE_VIEWERS" | "EMAIL" | undefined;
13
+ password?: string | undefined;
14
+ expires_at?: string | undefined;
15
+ max_downloads?: number | undefined;
16
+ /** A `caller` file only: the grant the caller made (`callerGrant()`). */
17
+ fk_share_ct?: string | undefined;
18
+ }
19
+ export interface ShareListOptions extends CallOptions {
20
+ fileId?: string | undefined;
21
+ folderId?: string | undefined;
22
+ includeRevoked?: boolean | undefined;
23
+ }
24
+ export interface OpenShareOptions {
25
+ /** `fetch` to use (the static `VolaClient.openShare`); default: the global one. */
26
+ fetch?: typeof fetch | undefined;
27
+ /** The password of a protected share (`X-Share-Password`, never the query string). */
28
+ password?: string | undefined;
29
+ range?: ByteRange | undefined;
30
+ /** A file (or subfolder) INSIDE a shared folder, by its path relative to the share. */
31
+ path?: string | undefined;
32
+ method?: "GET" | "HEAD" | undefined;
33
+ /** `?download=1`. */
34
+ download?: boolean | undefined;
35
+ signal?: AbortSignal | undefined;
36
+ }
37
+ /** The share URL without its fragment, and the secret the fragment carried (`null` without one). */
38
+ export declare function parseShareUrl(url: string): {
39
+ url: string;
40
+ secret: string | null;
41
+ };
42
+ /** `openShare` over a given `fetch`: the secret from the fragment as `X-Share-Secret`, the password as a header. */
43
+ export declare function openShareUrl(fetchImpl: typeof fetch, url: string, options?: OpenShareOptions): Promise<Response>;
44
+ export interface CallerGrant {
45
+ /** `fk_share_ct` for `POST /shares`: `nonce ∥ AES-256-GCM(S, FK, "<file id>:key:share:caller")`, base64. */
46
+ fkShareCt: string;
47
+ /** The link secret `S` (32 bytes). Give it to the recipient in the URL fragment ONLY. */
48
+ secret: Uint8Array;
49
+ /** `S` as base64url: what goes after `#` in the share URL. */
50
+ fragment: string;
51
+ }
52
+ /**
53
+ * The share grant of a `caller`-encrypted file, made by the caller (the server never holds
54
+ * that file's key, so it cannot make one): the file key `fileKey` wrapped under a fresh link
55
+ * secret with the platform's WebCrypto. `fileKey` is the file's FK, which the caller
56
+ * unwrapped from `fk_ct` under its content key (`docs/CRYPTO.md` § 9) — NOT the content key.
57
+ */
58
+ export declare function callerGrant(fileId: string, fileKey: Uint8Array, secret?: Uint8Array): Promise<CallerGrant>;
59
+ /** Share links: the owner's side (`/shares`, scope `shares:write`) and the recipient's (`/s/<token>`, no key). */
60
+ export declare class SharesApi {
61
+ private readonly client;
62
+ constructor(client: VolaClient);
63
+ /**
64
+ * `POST /shares`: `{file_id}` or `{folder}`, with `password`, `expires_at`, `max_downloads`.
65
+ * Resolves with the info, the `token` (this once) and the public `url` — for an encrypted
66
+ * file (`tenant`, or `keyring` with the owner's unlock) the `url` ends in `#<secret>`: the
67
+ * recipient gets plaintext, and the secret is nowhere but in that link.
68
+ */
69
+ create(body: ShareCreateInput, options?: CallOptions): Promise<ShareCreated>;
70
+ /** `GET /shares[?file_id=|folder_id=][&include_revoked=1]`, newest first, never the token. */
71
+ list(options?: ShareListOptions): Promise<ShareList>;
72
+ /** `GET /shares/:id`. */
73
+ get(id: string, options?: CallOptions): Promise<ShareInfo>;
74
+ /** `DELETE /shares/:id`: revoke (idempotent); the link answers `410 share_gone` from then on, and a grant is shredded. */
75
+ revoke(id: string, options?: CallOptions): Promise<ShareInfo>;
76
+ /**
77
+ * `POST /shares` for a `caller`-encrypted file: makes the grant (`callerGrant`) and creates
78
+ * the share with it. The `url` returned INCLUDES the `#<secret>` fragment (the server's
79
+ * does not: it never saw the secret). Node only, like everything `caller`.
80
+ */
81
+ createCallerGrant(fileId: string, fileKey: Uint8Array, body?: Omit<ShareCreateInput, "file_id" | "folder" | "fk_share_ct">, options?: CallOptions): Promise<ShareCreated>;
82
+ /** The recipient's side with this instance's `fetch` (no API key is sent): see `VolaClient.openShare`. */
83
+ open(url: string, options?: Omit<OpenShareOptions, "fetch">): Promise<Response>;
84
+ /** The listing of a shared FOLDER (`GET /s/<token>[/path/<subfolder>]` as JSON). */
85
+ listing(url: string, options?: Omit<OpenShareOptions, "fetch" | "method" | "range">): Promise<SharedFolderListing>;
86
+ }
87
+ //# sourceMappingURL=shares.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shares.d.ts","sourceRoot":"","sources":["../src/shares.ts"],"names":[],"mappings":"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"}
package/dist/shares.js ADDED
@@ -0,0 +1,144 @@
1
+ import { CONTENT_KEY_BYTES, callerGrantAad, FORCE_DOWNLOAD_QUERY, INCLUDE_REVOKED_QUERY, SHARE_PASSWORD_HEADER, SHARE_SECRET_BYTES, SHARE_SECRET_HEADER, ShareCreatedSchema, SharedFolderListingSchema, ShareInfoSchema, ShareListSchema, } from "@vol-a/core";
2
+ import { ok2xx } from "./client.js";
3
+ import { bytesToBase64, bytesToBase64Url, encodePath, randomBytes } from "./env.js";
4
+ import { errorFromResponse, VolaError } from "./errors.js";
5
+ import { rangeHeader } from "./files.js";
6
+ /** The share URL without its fragment, and the secret the fragment carried (`null` without one). */
7
+ export function parseShareUrl(url) {
8
+ const parsed = new URL(url);
9
+ const secret = parsed.hash.length > 1 ? parsed.hash.slice(1) : null;
10
+ parsed.hash = "";
11
+ return { url: parsed.toString(), secret };
12
+ }
13
+ /** `openShare` over a given `fetch`: the secret from the fragment as `X-Share-Secret`, the password as a header. */
14
+ export async function openShareUrl(fetchImpl, url, options = {}) {
15
+ const { url: bare, secret } = parseShareUrl(url);
16
+ const target = new URL(bare);
17
+ if (options.path !== undefined) {
18
+ target.pathname = `${target.pathname.replace(/\/+$/, "")}/path/${encodePath(options.path)}`;
19
+ }
20
+ if (options.download)
21
+ target.searchParams.set(FORCE_DOWNLOAD_QUERY, "1");
22
+ const headers = new Headers();
23
+ if (secret)
24
+ headers.set(SHARE_SECRET_HEADER, secret);
25
+ if (options.password !== undefined)
26
+ headers.set(SHARE_PASSWORD_HEADER, options.password);
27
+ if (options.range !== undefined)
28
+ headers.set("range", rangeHeader(options.range));
29
+ const response = await fetchImpl(target.toString(), {
30
+ method: options.method ?? "GET",
31
+ headers,
32
+ ...(options.signal ? { signal: options.signal } : {}),
33
+ });
34
+ if (!ok2xx(response.status))
35
+ throw await errorFromResponse(response);
36
+ return response;
37
+ }
38
+ /**
39
+ * The share grant of a `caller`-encrypted file, made by the caller (the server never holds
40
+ * that file's key, so it cannot make one): the file key `fileKey` wrapped under a fresh link
41
+ * secret with the platform's WebCrypto. `fileKey` is the file's FK, which the caller
42
+ * unwrapped from `fk_ct` under its content key (`docs/CRYPTO.md` § 9) — NOT the content key.
43
+ */
44
+ export async function callerGrant(fileId, fileKey, secret = randomBytes(SHARE_SECRET_BYTES)) {
45
+ if (fileKey.byteLength !== CONTENT_KEY_BYTES) {
46
+ throw new VolaError({
47
+ status: 0,
48
+ code: "bad_request",
49
+ message: `callerGrant: the file key is ${CONTENT_KEY_BYTES} bytes`,
50
+ });
51
+ }
52
+ if (secret.byteLength !== SHARE_SECRET_BYTES) {
53
+ throw new VolaError({
54
+ status: 0,
55
+ code: "bad_request",
56
+ message: `callerGrant: the secret is ${SHARE_SECRET_BYTES} bytes`,
57
+ });
58
+ }
59
+ const key = await crypto.subtle.importKey("raw", secret.slice(), "AES-GCM", false, ["encrypt"]);
60
+ const nonce = randomBytes(12);
61
+ const sealed = new Uint8Array(await crypto.subtle.encrypt({
62
+ name: "AES-GCM",
63
+ iv: nonce.slice(),
64
+ additionalData: new TextEncoder().encode(callerGrantAad(fileId)).slice(),
65
+ tagLength: 128,
66
+ }, key, fileKey.slice()));
67
+ const out = new Uint8Array(nonce.length + sealed.length);
68
+ out.set(nonce);
69
+ out.set(sealed, nonce.length);
70
+ return { fkShareCt: bytesToBase64(out), secret, fragment: bytesToBase64Url(secret) };
71
+ }
72
+ /** Share links: the owner's side (`/shares`, scope `shares:write`) and the recipient's (`/s/<token>`, no key). */
73
+ export class SharesApi {
74
+ client;
75
+ constructor(client) {
76
+ this.client = client;
77
+ }
78
+ /**
79
+ * `POST /shares`: `{file_id}` or `{folder}`, with `password`, `expires_at`, `max_downloads`.
80
+ * Resolves with the info, the `token` (this once) and the public `url` — for an encrypted
81
+ * file (`tenant`, or `keyring` with the owner's unlock) the `url` ends in `#<secret>`: the
82
+ * recipient gets plaintext, and the secret is nowhere but in that link.
83
+ */
84
+ create(body, options = {}) {
85
+ return this.client.json("/shares", ShareCreatedSchema, {
86
+ method: "POST",
87
+ json: body,
88
+ ...options,
89
+ });
90
+ }
91
+ /** `GET /shares[?file_id=|folder_id=][&include_revoked=1]`, newest first, never the token. */
92
+ list(options = {}) {
93
+ return this.client.json("/shares", ShareListSchema, {
94
+ query: {
95
+ file_id: options.fileId,
96
+ folder_id: options.folderId,
97
+ [INCLUDE_REVOKED_QUERY]: options.includeRevoked,
98
+ },
99
+ signal: options.signal,
100
+ });
101
+ }
102
+ /** `GET /shares/:id`. */
103
+ get(id, options = {}) {
104
+ return this.client.json(`/shares/${encodeURIComponent(id)}`, ShareInfoSchema, options);
105
+ }
106
+ /** `DELETE /shares/:id`: revoke (idempotent); the link answers `410 share_gone` from then on, and a grant is shredded. */
107
+ revoke(id, options = {}) {
108
+ return this.client.json(`/shares/${encodeURIComponent(id)}`, ShareInfoSchema, {
109
+ method: "DELETE",
110
+ ...options,
111
+ });
112
+ }
113
+ /**
114
+ * `POST /shares` for a `caller`-encrypted file: makes the grant (`callerGrant`) and creates
115
+ * the share with it. The `url` returned INCLUDES the `#<secret>` fragment (the server's
116
+ * does not: it never saw the secret). Node only, like everything `caller`.
117
+ */
118
+ async createCallerGrant(fileId, fileKey, body = {}, options = {}) {
119
+ const grant = await callerGrant(fileId, fileKey);
120
+ const created = await this.create({ ...body, file_id: fileId, fk_share_ct: grant.fkShareCt }, options);
121
+ return { ...created, url: `${created.url}#${grant.fragment}` };
122
+ }
123
+ /** The recipient's side with this instance's `fetch` (no API key is sent): see `VolaClient.openShare`. */
124
+ open(url, options = {}) {
125
+ return openShareUrl(this.client.rawFetch, url, options);
126
+ }
127
+ /** The listing of a shared FOLDER (`GET /s/<token>[/path/<subfolder>]` as JSON). */
128
+ async listing(url, options = {}) {
129
+ const response = await openShareUrl(this.client.rawFetch, url, { ...options, method: "GET" });
130
+ const body = await response.json();
131
+ if (!(this.client.options.validate ?? false))
132
+ return body;
133
+ const parsed = SharedFolderListingSchema.safeParse(body);
134
+ if (!parsed.success) {
135
+ throw new VolaError({
136
+ status: response.status,
137
+ code: "invalid_response",
138
+ message: `share listing: ${parsed.error.issues[0]?.message ?? "invalid"}`,
139
+ });
140
+ }
141
+ return parsed.data;
142
+ }
143
+ }
144
+ //# sourceMappingURL=shares.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shares.js","sourceRoot":"","sources":["../src/shares.ts"],"names":[],"mappings":"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"}