@vol-a/client 0.0.0-stage → 1.1.1

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 (47) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +254 -2
  3. package/dist/body.d.ts +40 -0
  4. package/dist/body.d.ts.map +1 -0
  5. package/dist/body.js +112 -0
  6. package/dist/body.js.map +1 -0
  7. package/dist/client.d.ts +161 -0
  8. package/dist/client.d.ts.map +1 -0
  9. package/dist/client.js +245 -0
  10. package/dist/client.js.map +1 -0
  11. package/dist/env.d.ts +19 -0
  12. package/dist/env.d.ts.map +1 -0
  13. package/dist/env.js +52 -0
  14. package/dist/env.js.map +1 -0
  15. package/dist/errors.d.ts +43 -0
  16. package/dist/errors.d.ts.map +1 -0
  17. package/dist/errors.js +93 -0
  18. package/dist/errors.js.map +1 -0
  19. package/dist/files.d.ts +144 -0
  20. package/dist/files.d.ts.map +1 -0
  21. package/dist/files.js +239 -0
  22. package/dist/files.js.map +1 -0
  23. package/dist/folders.d.ts +35 -0
  24. package/dist/folders.d.ts.map +1 -0
  25. package/dist/folders.js +62 -0
  26. package/dist/folders.js.map +1 -0
  27. package/dist/index.d.ts +20 -0
  28. package/dist/index.d.ts.map +1 -0
  29. package/dist/index.js +11 -0
  30. package/dist/index.js.map +1 -0
  31. package/dist/keyrings.d.ts +44 -0
  32. package/dist/keyrings.d.ts.map +1 -0
  33. package/dist/keyrings.js +111 -0
  34. package/dist/keyrings.js.map +1 -0
  35. package/dist/management.d.ts +47 -0
  36. package/dist/management.d.ts.map +1 -0
  37. package/dist/management.js +65 -0
  38. package/dist/management.js.map +1 -0
  39. package/dist/shares.d.ts +87 -0
  40. package/dist/shares.d.ts.map +1 -0
  41. package/dist/shares.js +144 -0
  42. package/dist/shares.js.map +1 -0
  43. package/dist/uploads.d.ts +112 -0
  44. package/dist/uploads.d.ts.map +1 -0
  45. package/dist/uploads.js +290 -0
  46. package/dist/uploads.js.map +1 -0
  47. package/package.json +48 -3
@@ -0,0 +1,290 @@
1
+ import { decodeTusMetadata, ENCRYPTION_HEADER, encodeTusMetadata, TUS_EXTENSION_HEADER, TUS_MAX_SIZE_HEADER, TUS_PATCH_CONTENT_TYPE, TUS_RESUMABLE_HEADER, TUS_VERSION, TUS_VERSION_HEADER, UPLOAD_EXPIRES_HEADER, UPLOAD_LENGTH_HEADER, UPLOAD_META_KEYS, UPLOAD_METADATA_HEADER, UPLOAD_OFFSET_HEADER, VOLA_FILE_ID_HEADER, } from "@vol-a/core";
2
+ import { isStreamSource, nameOf, sizeOf, sliceOf, typeOf } from "./body.js";
3
+ import { isBrowser } from "./env.js";
4
+ import { VolaError } from "./errors.js";
5
+ /** Default chunk of a resumable upload: 8 MiB. */
6
+ export const DEFAULT_CHUNK_SIZE = 8 * 1024 * 1024;
7
+ export class MemoryFingerprintStore {
8
+ map = new Map();
9
+ get(key) {
10
+ return this.map.get(key) ?? null;
11
+ }
12
+ set(key, value) {
13
+ this.map.set(key, value);
14
+ }
15
+ remove(key) {
16
+ this.map.delete(key);
17
+ }
18
+ }
19
+ /** A `FingerprintStore` over `localStorage` (or any `Storage`). */
20
+ export function storageFingerprintStore(storage) {
21
+ return {
22
+ get: (key) => storage.getItem(key),
23
+ set: (key, value) => storage.setItem(key, value),
24
+ remove: (key) => storage.removeItem(key),
25
+ };
26
+ }
27
+ const memoryStore = new MemoryFingerprintStore();
28
+ /** `localStorage` in a browser that has one, the process-wide memory store otherwise. */
29
+ export function defaultFingerprintStore() {
30
+ if (isBrowser() && typeof localStorage !== "undefined") {
31
+ try {
32
+ return storageFingerprintStore(localStorage);
33
+ }
34
+ catch {
35
+ // a page that forbids storage
36
+ }
37
+ }
38
+ return memoryStore;
39
+ }
40
+ /** Thrown by `resumable()` for a source that cannot be sliced (a stream): the upload would not be resumable. */
41
+ function notSliceable() {
42
+ return new VolaError({
43
+ status: 0,
44
+ code: "bad_request",
45
+ message: "resumable upload: the source must be a Blob/File, a Uint8Array/Buffer or an ArrayBuffer (something that can be sized and sliced); for a stream use files.upload()",
46
+ });
47
+ }
48
+ const tus = { [TUS_RESUMABLE_HEADER]: TUS_VERSION };
49
+ function header(response, name) {
50
+ return response.headers.get(name);
51
+ }
52
+ function offsetOf(response) {
53
+ const raw = header(response, UPLOAD_OFFSET_HEADER);
54
+ if (raw === null || !/^\d+$/.test(raw)) {
55
+ throw new VolaError({
56
+ status: response.status,
57
+ code: "invalid_response",
58
+ message: `${UPLOAD_OFFSET_HEADER}: the server did not say where the upload stands`,
59
+ });
60
+ }
61
+ return Number(raw);
62
+ }
63
+ /**
64
+ * Resumable uploads (`/uploads`, tus 1.0 core + creation/termination/expiration, which the
65
+ * server implements natively). `resumable()` is the whole flow; `create`, `status`, `append`
66
+ * and `abort` are its steps, for a client that drives them itself.
67
+ */
68
+ export class UploadsApi {
69
+ client;
70
+ constructor(client) {
71
+ this.client = client;
72
+ }
73
+ /** `OPTIONS /uploads`: the protocol version, the extensions, the size limit. No key needed. */
74
+ async protocol(options = {}) {
75
+ const response = await this.client.request("/uploads", {
76
+ method: "OPTIONS",
77
+ anonymous: true,
78
+ signal: options.signal,
79
+ });
80
+ const max = header(response, TUS_MAX_SIZE_HEADER);
81
+ return {
82
+ version: header(response, TUS_VERSION_HEADER) ?? TUS_VERSION,
83
+ extensions: (header(response, TUS_EXTENSION_HEADER) ?? "").split(",").filter(Boolean),
84
+ maxSize: max !== null && /^\d+$/.test(max) ? Number(max) : null,
85
+ };
86
+ }
87
+ /** `POST /uploads`: creates the upload (`201`); the id comes from `Location`. */
88
+ async create(type, id, input) {
89
+ const K = UPLOAD_META_KEYS;
90
+ const metadata = encodeTusMetadata({
91
+ [K.instanceType]: type,
92
+ [K.instanceId]: id,
93
+ [K.filename]: input.filename,
94
+ [K.folderPath]: input.folderPath,
95
+ [K.parentId]: input.parentId,
96
+ [K.slug]: input.slug,
97
+ [K.contentType]: input.contentType,
98
+ [K.metadata]: input.metadata === undefined ? undefined : JSON.stringify(input.metadata),
99
+ [K.encryption]: input.encryption,
100
+ });
101
+ if (input.folderId !== undefined) {
102
+ throw new VolaError({
103
+ status: 0,
104
+ code: "bad_request",
105
+ message: "resumable upload: the folder is named by folderPath (folderId is not part of the tus metadata)",
106
+ });
107
+ }
108
+ const response = await this.client.request("/uploads", {
109
+ method: "POST",
110
+ headers: {
111
+ ...tus,
112
+ [UPLOAD_LENGTH_HEADER]: String(input.length),
113
+ [UPLOAD_METADATA_HEADER]: metadata,
114
+ [ENCRYPTION_HEADER]: input.encryption,
115
+ },
116
+ signal: input.signal,
117
+ unlock: input.unlock,
118
+ contentKey: input.contentKey,
119
+ });
120
+ const location = header(response, "location");
121
+ const uploadId = location?.split("/").pop();
122
+ if (!uploadId) {
123
+ throw new VolaError({
124
+ status: response.status,
125
+ code: "invalid_response",
126
+ message: "POST /uploads: no Location header",
127
+ });
128
+ }
129
+ await response.body?.cancel().catch(() => undefined);
130
+ return {
131
+ uploadId,
132
+ offset: offsetOf(response),
133
+ length: input.length,
134
+ fileId: header(response, VOLA_FILE_ID_HEADER),
135
+ expiresAt: header(response, UPLOAD_EXPIRES_HEADER),
136
+ metadata: {},
137
+ };
138
+ }
139
+ /** `HEAD /uploads/:id`: where the upload stands. `404 upload_not_found` / `410` throw. */
140
+ async status(uploadId, options = {}) {
141
+ const response = await this.client.request(`/uploads/${encodeURIComponent(uploadId)}`, {
142
+ method: "HEAD",
143
+ headers: tus,
144
+ ...options,
145
+ });
146
+ const length = header(response, UPLOAD_LENGTH_HEADER);
147
+ return {
148
+ uploadId,
149
+ offset: offsetOf(response),
150
+ length: length !== null && /^\d+$/.test(length) ? Number(length) : 0,
151
+ fileId: header(response, VOLA_FILE_ID_HEADER),
152
+ expiresAt: header(response, UPLOAD_EXPIRES_HEADER),
153
+ metadata: decodeTusMetadata(header(response, UPLOAD_METADATA_HEADER)) ?? {},
154
+ };
155
+ }
156
+ /**
157
+ * `PATCH /uploads/:id`: `chunk` from `offset` on. Resolves with the new offset and, when the
158
+ * upload is complete, the file id. A `keyring` upload needs the unlock token and a `caller`
159
+ * upload the content key on EVERY call (each one unwraps the file key).
160
+ */
161
+ async append(uploadId, chunk, offset, options = {}) {
162
+ const response = await this.client.request(`/uploads/${encodeURIComponent(uploadId)}`, {
163
+ method: "PATCH",
164
+ headers: {
165
+ ...tus,
166
+ "content-type": TUS_PATCH_CONTENT_TYPE,
167
+ [UPLOAD_OFFSET_HEADER]: String(offset),
168
+ },
169
+ body: chunk instanceof Uint8Array ? chunk.slice() : chunk,
170
+ ...options,
171
+ });
172
+ await response.body?.cancel().catch(() => undefined);
173
+ return { offset: offsetOf(response), fileId: header(response, VOLA_FILE_ID_HEADER) };
174
+ }
175
+ /** `DELETE /uploads/:id`: drops the upload and its partial bytes. */
176
+ async abort(uploadId, options = {}) {
177
+ const response = await this.client.request(`/uploads/${encodeURIComponent(uploadId)}`, {
178
+ method: "DELETE",
179
+ headers: tus,
180
+ ...options,
181
+ });
182
+ await response.body?.cancel().catch(() => undefined);
183
+ }
184
+ /** The default fingerprint of a source. */
185
+ fingerprintOf(type, id, source, filename) {
186
+ const modified = typeof Blob !== "undefined" && source instanceof Blob && "lastModified" in source
187
+ ? String(source.lastModified)
188
+ : "";
189
+ return `vola-upload:${this.client.baseUrl}:${type}/${id}:${filename}:${sizeOf(source)}:${modified}`;
190
+ }
191
+ /**
192
+ * The whole resumable flow: remembers the upload under its fingerprint, `HEAD`s a remembered
193
+ * one for its offset (a vanished one is forgotten and started again), creates a new one
194
+ * otherwise, `PATCH`es `chunkSize` bytes at a time from the offset on, reports progress, and
195
+ * resolves with the file id. An abort (`signal`) or a network failure mid-`PATCH` rejects
196
+ * and keeps the fingerprint: the next call with the same source continues where the server
197
+ * stands. A `409` (the server's offset moved) re-reads the offset and goes on.
198
+ */
199
+ async resumable(type, id, source, options = {}) {
200
+ if (isStreamSource(source))
201
+ throw notSliceable();
202
+ const filename = options.filename ?? nameOf(source);
203
+ if (!filename) {
204
+ throw new VolaError({
205
+ status: 0,
206
+ code: "bad_request",
207
+ message: "resumable upload: filename is required when the source is not a File",
208
+ });
209
+ }
210
+ const total = sizeOf(source);
211
+ const chunkSize = Math.max(1, options.chunkSize ?? DEFAULT_CHUNK_SIZE);
212
+ const store = options.fingerprint === false ? null : (options.store ?? defaultFingerprintStore());
213
+ const key = options.fingerprint === false
214
+ ? null
215
+ : (options.fingerprint ?? this.fingerprintOf(type, id, source, filename));
216
+ const call = {
217
+ signal: options.signal,
218
+ unlock: options.unlock,
219
+ contentKey: options.contentKey,
220
+ };
221
+ let state = null;
222
+ if (store && key) {
223
+ const remembered = await store.get(key);
224
+ if (remembered) {
225
+ try {
226
+ state = await this.status(remembered, call);
227
+ }
228
+ catch (error) {
229
+ if (!(error instanceof VolaError) || (error.status !== 404 && error.status !== 410)) {
230
+ throw error;
231
+ }
232
+ await store.remove(key);
233
+ }
234
+ }
235
+ }
236
+ if (!state) {
237
+ state = await this.create(type, id, {
238
+ length: total,
239
+ filename,
240
+ contentType: options.contentType ?? typeOf(source),
241
+ folderPath: options.folderPath,
242
+ parentId: options.parentId,
243
+ slug: options.slug,
244
+ metadata: options.metadata,
245
+ encryption: options.encryption,
246
+ ...call,
247
+ });
248
+ if (store && key)
249
+ await store.set(key, state.uploadId);
250
+ }
251
+ let offset = state.offset;
252
+ let fileId = state.fileId;
253
+ let conflicts = 0;
254
+ options.onProgress?.({ uploaded: offset, total, uploadId: state.uploadId });
255
+ while (offset < total || (total === 0 && fileId === null)) {
256
+ const end = Math.min(offset + chunkSize, total);
257
+ try {
258
+ const result = await this.append(state.uploadId, sliceOf(source, offset, end), offset, call);
259
+ offset = result.offset;
260
+ fileId = result.fileId ?? fileId;
261
+ conflicts = 0;
262
+ }
263
+ catch (error) {
264
+ if (error instanceof VolaError && error.status === 409 && conflicts++ < 3) {
265
+ offset = (await this.status(state.uploadId, call)).offset;
266
+ continue;
267
+ }
268
+ throw error;
269
+ }
270
+ options.onProgress?.({ uploaded: offset, total, uploadId: state.uploadId });
271
+ if (total === 0)
272
+ break;
273
+ }
274
+ if (offset >= total && fileId === null) {
275
+ // The last PATCH answered without the id (a proxy dropped the header): ask.
276
+ fileId = (await this.status(state.uploadId, call)).fileId;
277
+ }
278
+ if (fileId === null) {
279
+ throw new VolaError({
280
+ status: 0,
281
+ code: "invalid_response",
282
+ message: "resumable upload: complete, but the server did not name the file",
283
+ });
284
+ }
285
+ if (store && key)
286
+ await store.remove(key);
287
+ return { fileId, uploadId: state.uploadId };
288
+ }
289
+ }
290
+ //# sourceMappingURL=uploads.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"uploads.js","sourceRoot":"","sources":["../src/uploads.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,51 @@
1
1
  {
2
2
  "name": "@vol-a/client",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "1.1.1",
4
+ "description": "JSVola client SDK: a fetch-based, dependency-light client for the @vol-a/server API — files, folders, resumable uploads, shares, keyrings, stats — for Node 24+ and browsers.",
5
+ "license": "MIT",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "git+https://github.com/digital-cube/jsvola.git",
9
+ "directory": "packages/client"
10
+ },
11
+ "homepage": "https://github.com/digital-cube/jsvola#readme",
12
+ "bugs": "https://github.com/digital-cube/jsvola/issues",
13
+ "engines": {
14
+ "node": ">=24"
15
+ },
16
+ "type": "module",
17
+ "sideEffects": false,
18
+ "exports": {
19
+ ".": {
20
+ "@vol-a/source": "./src/index.ts",
21
+ "types": "./dist/index.d.ts",
22
+ "import": "./dist/index.js"
23
+ }
24
+ },
25
+ "files": [
26
+ "dist"
27
+ ],
28
+ "dependencies": {
29
+ "@jsudc/core": "0.3.0",
30
+ "@vol-a/core": "1.1.1"
31
+ },
32
+ "publishConfig": {
33
+ "access": "public"
34
+ },
35
+ "keywords": [
36
+ "vola",
37
+ "jsvola",
38
+ "file-storage",
39
+ "upload",
40
+ "resumable",
41
+ "tus",
42
+ "client",
43
+ "sdk"
44
+ ],
45
+ "scripts": {
46
+ "build": "tsc -p tsconfig.build.json",
47
+ "typecheck": "tsc -p tsconfig.json --noEmit",
48
+ "test": "vitest run",
49
+ "test:cov": "vitest run --coverage"
50
+ }
6
51
  }