@interop/was-client 0.60.0 → 0.61.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.
- package/README.md +66 -45
- package/dist/Collection.d.ts +135 -94
- package/dist/Collection.d.ts.map +1 -1
- package/dist/Collection.js +612 -194
- package/dist/Collection.js.map +1 -1
- package/dist/Resource.d.ts +1 -1
- package/dist/Resource.d.ts.map +1 -1
- package/dist/Resource.js +0 -3
- package/dist/Resource.js.map +1 -1
- package/dist/Space.d.ts +17 -16
- package/dist/Space.d.ts.map +1 -1
- package/dist/Space.js +41 -24
- package/dist/Space.js.map +1 -1
- package/dist/codec.d.ts +3 -3
- package/dist/edv/EdvCodec.js +1 -1
- package/dist/edv/descriptorStore.d.ts +16 -14
- package/dist/edv/descriptorStore.d.ts.map +1 -1
- package/dist/edv/descriptorStore.js +17 -14
- package/dist/edv/descriptorStore.js.map +1 -1
- package/dist/edv/index.d.ts +1 -1
- package/dist/edv/index.js +1 -1
- package/dist/edv/logGovernedDescriptorStore.d.ts +2 -2
- package/dist/edv/logGovernedDescriptorStore.d.ts.map +1 -1
- package/dist/edv/logGovernedDescriptorStore.js +10 -9
- package/dist/edv/logGovernedDescriptorStore.js.map +1 -1
- package/dist/edv/recipients.d.ts +1 -1
- package/dist/edv/recipients.js +2 -2
- package/dist/edv/recipients.js.map +1 -1
- package/dist/edv/refresh.d.ts +1 -1
- package/dist/edv/refresh.js +1 -1
- package/dist/errors.d.ts +1 -1
- package/dist/errors.js +3 -3
- package/dist/errors.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/internal/codec.d.ts +22 -1
- package/dist/internal/codec.d.ts.map +1 -1
- package/dist/internal/codec.js +117 -46
- package/dist/internal/codec.js.map +1 -1
- package/dist/internal/describe.d.ts +98 -24
- package/dist/internal/describe.d.ts.map +1 -1
- package/dist/internal/describe.js +125 -18
- package/dist/internal/describe.js.map +1 -1
- package/dist/internal/meta.d.ts +32 -17
- package/dist/internal/meta.d.ts.map +1 -1
- package/dist/internal/meta.js +64 -35
- package/dist/internal/meta.js.map +1 -1
- package/dist/internal/paths.d.ts +33 -17
- package/dist/internal/paths.d.ts.map +1 -1
- package/dist/internal/paths.js +92 -40
- package/dist/internal/paths.js.map +1 -1
- package/dist/internal/reserved.d.ts +14 -0
- package/dist/internal/reserved.d.ts.map +1 -1
- package/dist/internal/reserved.js +23 -4
- package/dist/internal/reserved.js.map +1 -1
- package/dist/paths.d.ts +8 -5
- package/dist/paths.d.ts.map +1 -1
- package/dist/paths.js +8 -5
- package/dist/paths.js.map +1 -1
- package/dist/sync/provisioning.d.ts +5 -5
- package/dist/sync/provisioning.d.ts.map +1 -1
- package/dist/sync/provisioning.js +2 -2
- package/dist/sync/provisioning.js.map +1 -1
- package/dist/types.d.ts +16 -9
- package/dist/types.d.ts.map +1 -1
- package/package.json +2 -2
package/dist/internal/paths.js
CHANGED
|
@@ -3,9 +3,25 @@
|
|
|
3
3
|
*/
|
|
4
4
|
/**
|
|
5
5
|
* URL path builders for the WAS server, encoding the trailing-slash
|
|
6
|
-
* canonicalization once.
|
|
7
|
-
*
|
|
8
|
-
*
|
|
6
|
+
* canonicalization once. The convention: a trailing slash marks a container in
|
|
7
|
+
* canonical form (`/spaces/`, `/space/{s}/`, `/space/{s}/{c}/`), everything
|
|
8
|
+
* else has none, and no two paths differ only by a trailing slash. Path
|
|
9
|
+
* segments are percent-encoded so ids never break out of their slot.
|
|
10
|
+
*
|
|
11
|
+
* A container's own description is not at its URL: it lives at the reserved
|
|
12
|
+
* `meta` segment (`spaceMeta`, `collectionMeta`), beside the Resource-level
|
|
13
|
+
* `resourceMeta`. The bare (slash-less) form of a container URL only
|
|
14
|
+
* 308-redirects, and a signed invocation covers the target it was signed for,
|
|
15
|
+
* so no builder here emits the bare form -- a redirect would have to be signed
|
|
16
|
+
* again.
|
|
17
|
+
*
|
|
18
|
+
* The parser is deliberately laxer than the builders. `parseSpacePath` accepts
|
|
19
|
+
* the bare form too, because the targets it classifies are not this client's
|
|
20
|
+
* own URLs: they are the `invocationTarget` strings of delegated capabilities
|
|
21
|
+
* a third party minted, and those name containers in either form. Reading one
|
|
22
|
+
* as the Space or Collection it addresses is what `WasClient.fromCapability`
|
|
23
|
+
* and the revocation route's `spaceIdOf` do; refusing the bare form there would
|
|
24
|
+
* reject valid capabilities over a spelling this client does not control.
|
|
9
25
|
*
|
|
10
26
|
* The zcap `invocationTarget` is derived from the request URL, so these
|
|
11
27
|
* trailing-slash rules must match the server's per-operation `allowedTarget`
|
|
@@ -16,9 +32,8 @@
|
|
|
16
32
|
* resource / sub-resource), so `WasClient.fromCapability` and the builders stay
|
|
17
33
|
* in lockstep.
|
|
18
34
|
*/
|
|
19
|
-
import { RESERVED_COLLECTION_IDS, RESERVED_RESOURCE_IDS } from '@interop/storage-core';
|
|
20
35
|
import { ValidationError } from '../errors.js';
|
|
21
|
-
import { assertNotReserved } from './reserved.js';
|
|
36
|
+
import { assertNotReserved, isReservedCollectionId, isReservedResourceId } from './reserved.js';
|
|
22
37
|
/**
|
|
23
38
|
* Rejects an id that would escape its path slot even after percent-encoding:
|
|
24
39
|
* `encodeURIComponent` leaves `.` and `..` intact, and WHATWG URL resolution
|
|
@@ -74,41 +89,59 @@ export function spacesRoot() {
|
|
|
74
89
|
return '/spaces/';
|
|
75
90
|
}
|
|
76
91
|
/**
|
|
77
|
-
* `/space/:spaceId` --
|
|
92
|
+
* `/space/:spaceId` -- the slash-less prefix the space-level sub-endpoints hang
|
|
93
|
+
* off. Module-private: the bare form is not a path this client ever requests
|
|
94
|
+
* (the server only 308-redirects it), so it is a prefix here and never a
|
|
95
|
+
* builder's return value. It is still a form the parser below reads, since a
|
|
96
|
+
* third party's capability target may be written that way.
|
|
97
|
+
*
|
|
98
|
+
* @param spaceId {string}
|
|
99
|
+
* @returns {string}
|
|
78
100
|
*/
|
|
79
|
-
|
|
101
|
+
function spacePrefix(spaceId) {
|
|
80
102
|
return `/space/${encode(spaceId)}`;
|
|
81
103
|
}
|
|
82
104
|
/**
|
|
83
|
-
* `/space/:spaceId/` --
|
|
105
|
+
* `/space/:spaceId/` -- the Space container in canonical form: the target a
|
|
106
|
+
* Space root capability names, the URL whose `GET` lists the Space's
|
|
107
|
+
* Collections, whose `POST` creates one, and whose `DELETE` removes the Space.
|
|
108
|
+
* The Space is an ordinary container, so its members are listed and created at
|
|
109
|
+
* the container itself -- there is no second builder for that.
|
|
110
|
+
*
|
|
111
|
+
* @param spaceId {string}
|
|
112
|
+
* @returns {string}
|
|
84
113
|
*/
|
|
85
|
-
export function
|
|
86
|
-
return `${
|
|
114
|
+
export function spacePath(spaceId) {
|
|
115
|
+
return `${spacePrefix(spaceId)}/`;
|
|
87
116
|
}
|
|
88
117
|
/**
|
|
89
|
-
* `/space/:spaceId/
|
|
118
|
+
* `/space/:spaceId/meta` -- the Space Metadata object: the Space's description
|
|
119
|
+
* (`name`, `controller`, `type`), read with `GET` and replaced with `PUT`.
|
|
120
|
+
*
|
|
121
|
+
* @param spaceId {string}
|
|
122
|
+
* @returns {string}
|
|
90
123
|
*/
|
|
91
|
-
export function
|
|
92
|
-
return `${
|
|
124
|
+
export function spaceMeta(spaceId) {
|
|
125
|
+
return `${spacePrefix(spaceId)}/meta`;
|
|
93
126
|
}
|
|
94
127
|
/**
|
|
95
128
|
* `/space/:spaceId/export` -- export a space as a tar archive.
|
|
96
129
|
*/
|
|
97
130
|
export function spaceExport(spaceId) {
|
|
98
|
-
return `${
|
|
131
|
+
return `${spacePrefix(spaceId)}/export`;
|
|
99
132
|
}
|
|
100
133
|
/**
|
|
101
134
|
* `/space/:spaceId/import` -- import a tar archive into a space.
|
|
102
135
|
*/
|
|
103
136
|
export function spaceImport(spaceId) {
|
|
104
|
-
return `${
|
|
137
|
+
return `${spacePrefix(spaceId)}/import`;
|
|
105
138
|
}
|
|
106
139
|
/**
|
|
107
140
|
* `/space/:spaceId/backends` -- the backends available within a space (list, and
|
|
108
141
|
* register a new `external` backend).
|
|
109
142
|
*/
|
|
110
143
|
export function spaceBackends(spaceId) {
|
|
111
|
-
return `${
|
|
144
|
+
return `${spacePrefix(spaceId)}/backends`;
|
|
112
145
|
}
|
|
113
146
|
/**
|
|
114
147
|
* `/space/:spaceId/backends/:backendId` -- a single registered `external`
|
|
@@ -121,19 +154,19 @@ export function registeredBackend(spaceId, backendId) {
|
|
|
121
154
|
* `/space/:spaceId/quotas` -- the space-level storage quota report.
|
|
122
155
|
*/
|
|
123
156
|
export function spaceQuotas(spaceId) {
|
|
124
|
-
return `${
|
|
157
|
+
return `${spacePrefix(spaceId)}/quotas`;
|
|
125
158
|
}
|
|
126
159
|
/**
|
|
127
160
|
* `/space/:spaceId/policy` -- the space-level access-control policy resource.
|
|
128
161
|
*/
|
|
129
162
|
export function spacePolicy(spaceId) {
|
|
130
|
-
return `${
|
|
163
|
+
return `${spacePrefix(spaceId)}/policy`;
|
|
131
164
|
}
|
|
132
165
|
/**
|
|
133
166
|
* `/space/:spaceId/linkset` -- the space-level linkset (policy discovery).
|
|
134
167
|
*/
|
|
135
168
|
export function spaceLinkset(spaceId) {
|
|
136
|
-
return `${
|
|
169
|
+
return `${spacePrefix(spaceId)}/linkset`;
|
|
137
170
|
}
|
|
138
171
|
/**
|
|
139
172
|
* `/space/:spaceId/zcaps/revocations/:capabilityId` -- submit a revocation of a
|
|
@@ -144,57 +177,69 @@ export function spaceLinkset(spaceId) {
|
|
|
144
177
|
* deeper than any Collection or Resource route, so it shadows nothing.
|
|
145
178
|
*/
|
|
146
179
|
export function spaceRevocation(spaceId, capabilityId) {
|
|
147
|
-
return `${
|
|
180
|
+
return `${spacePrefix(spaceId)}/zcaps/revocations/${encode(capabilityId)}`;
|
|
148
181
|
}
|
|
149
182
|
/**
|
|
150
|
-
* `/space/:spaceId/:collectionId` --
|
|
151
|
-
*
|
|
183
|
+
* `/space/:spaceId/:collectionId` -- the slash-less prefix the collection-level
|
|
184
|
+
* sub-endpoints and the Resource ids hang off. Module-private, like
|
|
185
|
+
* {@link spacePrefix}.
|
|
186
|
+
*
|
|
187
|
+
* @param spaceId {string}
|
|
188
|
+
* @param collectionId {string}
|
|
189
|
+
* @returns {string}
|
|
152
190
|
*/
|
|
153
|
-
|
|
154
|
-
return `${
|
|
191
|
+
function collectionPrefix(spaceId, collectionId) {
|
|
192
|
+
return `${spacePrefix(spaceId)}/${encodeCollectionId(collectionId)}`;
|
|
155
193
|
}
|
|
156
194
|
/**
|
|
157
|
-
* `/space/:spaceId/:collectionId/` --
|
|
158
|
-
*
|
|
195
|
+
* `/space/:spaceId/:collectionId/` -- the Collection container in canonical
|
|
196
|
+
* form: the target a "share this collection" capability names, the URL whose
|
|
197
|
+
* `GET` lists its Resources, whose `POST` adds one, and whose `DELETE` removes
|
|
198
|
+
* the Collection.
|
|
199
|
+
*
|
|
200
|
+
* @param spaceId {string}
|
|
201
|
+
* @param collectionId {string}
|
|
202
|
+
* @returns {string}
|
|
159
203
|
*/
|
|
160
|
-
export function
|
|
161
|
-
return `${
|
|
204
|
+
export function collectionPath(spaceId, collectionId) {
|
|
205
|
+
return `${collectionPrefix(spaceId, collectionId)}/`;
|
|
162
206
|
}
|
|
163
207
|
/**
|
|
164
208
|
* `/space/:spaceId/:collectionId/policy` -- the collection-level access-control
|
|
165
209
|
* policy resource.
|
|
166
210
|
*/
|
|
167
211
|
export function collectionPolicy(spaceId, collectionId) {
|
|
168
|
-
return `${
|
|
212
|
+
return `${collectionPrefix(spaceId, collectionId)}/policy`;
|
|
169
213
|
}
|
|
170
214
|
/**
|
|
171
215
|
* `/space/:spaceId/:collectionId/linkset` -- the collection-level linkset
|
|
172
216
|
* (policy discovery).
|
|
173
217
|
*/
|
|
174
218
|
export function collectionLinkset(spaceId, collectionId) {
|
|
175
|
-
return `${
|
|
219
|
+
return `${collectionPrefix(spaceId, collectionId)}/linkset`;
|
|
176
220
|
}
|
|
177
221
|
/**
|
|
178
222
|
* `/space/:spaceId/:collectionId/backend` -- the "Collection Backend Selected"
|
|
179
223
|
* descriptor (the backend this collection is stored on).
|
|
180
224
|
*/
|
|
181
225
|
export function collectionBackend(spaceId, collectionId) {
|
|
182
|
-
return `${
|
|
226
|
+
return `${collectionPrefix(spaceId, collectionId)}/backend`;
|
|
183
227
|
}
|
|
184
228
|
/**
|
|
185
229
|
* `/space/:spaceId/:collectionId/quota` -- the per-collection storage quota
|
|
186
230
|
* report (spec "Quotas").
|
|
187
231
|
*/
|
|
188
232
|
export function collectionQuota(spaceId, collectionId) {
|
|
189
|
-
return `${
|
|
233
|
+
return `${collectionPrefix(spaceId, collectionId)}/quota`;
|
|
190
234
|
}
|
|
191
235
|
/**
|
|
192
|
-
* `/space/:spaceId/:collectionId/meta` -- the Collection
|
|
193
|
-
*
|
|
194
|
-
*
|
|
236
|
+
* `/space/:spaceId/:collectionId/meta` -- the Collection Metadata object: the
|
|
237
|
+
* Collection's configuration (`name`, `backend`, `encryption`, `generator`)
|
|
238
|
+
* together with the server-managed timestamps / `createdBy` and the
|
|
239
|
+
* user-writable `custom` and `epoch`, as one object under one validator.
|
|
195
240
|
*/
|
|
196
241
|
export function collectionMeta(spaceId, collectionId) {
|
|
197
|
-
return `${
|
|
242
|
+
return `${collectionPrefix(spaceId, collectionId)}/meta`;
|
|
198
243
|
}
|
|
199
244
|
/**
|
|
200
245
|
* `/space/:spaceId/:collectionId/meta/log` -- the Collection's governing
|
|
@@ -209,14 +254,14 @@ export function collectionLog(spaceId, collectionId) {
|
|
|
209
254
|
* whose body's `profile` selects the query (e.g. `changes`, `blinded-index`).
|
|
210
255
|
*/
|
|
211
256
|
export function collectionQuery(spaceId, collectionId) {
|
|
212
|
-
return `${
|
|
257
|
+
return `${collectionPrefix(spaceId, collectionId)}/query`;
|
|
213
258
|
}
|
|
214
259
|
/**
|
|
215
260
|
* `/space/:spaceId/:collectionId/:resourceId` -- get / put / delete a resource
|
|
216
261
|
* (no trailing slash).
|
|
217
262
|
*/
|
|
218
263
|
export function resourcePath(spaceId, collectionId, resourceId) {
|
|
219
|
-
return `${
|
|
264
|
+
return `${collectionPrefix(spaceId, collectionId)}/${encodeResourceId(resourceId)}`;
|
|
220
265
|
}
|
|
221
266
|
/**
|
|
222
267
|
* `/space/:spaceId/:collectionId/:resourceId/meta` -- the resource metadata
|
|
@@ -322,6 +367,13 @@ export function parseSpaceTarget({ serverUrl, target }) {
|
|
|
322
367
|
* or any 5-segment target like `/space/s/c/r/meta` -- is classified
|
|
323
368
|
* `sub-resource`, never silently truncated to the nearest handle.
|
|
324
369
|
*
|
|
370
|
+
* Empty segments are dropped, so a container addressed in either form
|
|
371
|
+
* classifies the same: `/space/s` and `/space/s/` are both the Space, and
|
|
372
|
+
* `/space/s/c` and `/space/s/c/` both the Collection. That is deliberate. The
|
|
373
|
+
* builders emit only the canonical trailing-slash form, but the targets parsed
|
|
374
|
+
* here come from capabilities minted elsewhere, and a client that reads only
|
|
375
|
+
* one spelling would refuse valid ones.
|
|
376
|
+
*
|
|
325
377
|
* @param pathname {string} a URL pathname (e.g. from `new URL(...).pathname`)
|
|
326
378
|
* @returns {ParsedSpacePath | null}
|
|
327
379
|
*/
|
|
@@ -346,7 +398,7 @@ export function parseSpacePath(pathname) {
|
|
|
346
398
|
// A reserved segment directly under the space (`policy`, `backends`,
|
|
347
399
|
// `export`, ...) addresses a space-level sub-endpoint, as does anything
|
|
348
400
|
// nested beneath one (`/space/s/backends/:backendId`).
|
|
349
|
-
if (
|
|
401
|
+
if (isReservedCollectionId(rest[0])) {
|
|
350
402
|
return { kind: 'sub-resource', spaceId, segments: rest };
|
|
351
403
|
}
|
|
352
404
|
if (rest.length === 1) {
|
|
@@ -354,7 +406,7 @@ export function parseSpacePath(pathname) {
|
|
|
354
406
|
}
|
|
355
407
|
// A reserved segment under the collection (`policy`, `backend`, `quota`,
|
|
356
408
|
// ...) addresses a collection-level sub-endpoint.
|
|
357
|
-
if (
|
|
409
|
+
if (isReservedResourceId(rest[1])) {
|
|
358
410
|
return { kind: 'sub-resource', spaceId, segments: rest };
|
|
359
411
|
}
|
|
360
412
|
if (rest.length === 2) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/internal/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH
|
|
1
|
+
{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/internal/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,eAAe,CAAA;AAEtB;;;;;;;;;;GAUG;AACH,SAAS,aAAa,CAAC,OAAe;IACpC,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QAC1D,MAAM,IAAI,eAAe,CACvB,cAAc,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,+BAA+B;YAClE,qDAAqD,CACxD,CAAA;IACH,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,OAAe;IAC7B,aAAa,CAAC,OAAO,CAAC,CAAA;IACtB,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAA;AACpC,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,kBAAkB,CAAC,YAAoB;IAC9C,iBAAiB,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAA;IAC3D,OAAO,MAAM,CAAC,YAAY,CAAC,CAAA;AAC7B,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,gBAAgB,CAAC,UAAkB;IAC1C,iBAAiB,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAA;IACvD,OAAO,MAAM,CAAC,UAAU,CAAC,CAAA;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO,UAAU,MAAM,CAAC,OAAO,CAAC,EAAE,CAAA;AACpC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAA;AACnC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAA;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAA;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAA;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,CAAA;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,SAAiB;IAClE,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,CAAA;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAA;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAA;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,UAAU,CAAA;AAC1C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,YAAoB;IACnE,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,sBAAsB,MAAM,CAAC,YAAY,CAAC,EAAE,CAAA;AAC5E,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,gBAAgB,CAAC,OAAe,EAAE,YAAoB;IAC7D,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC,YAAY,CAAC,EAAE,CAAA;AACtE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,YAAoB;IAClE,OAAO,GAAG,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,GAAG,CAAA;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,YAAoB;IAEpB,OAAO,GAAG,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,SAAS,CAAA;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,YAAoB;IAEpB,OAAO,GAAG,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,UAAU,CAAA;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,YAAoB;IAEpB,OAAO,GAAG,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,UAAU,CAAA;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,YAAoB;IACnE,OAAO,GAAG,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAA;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,YAAoB;IAClE,OAAO,GAAG,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,CAAA;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,YAAoB;IACjE,OAAO,GAAG,cAAc,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,CAAA;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,YAAoB;IACnE,OAAO,GAAG,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAA;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,YAAoB,EACpB,UAAkB;IAElB,OAAO,GAAG,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,gBAAgB,CAAC,UAAU,CAAC,EAAE,CAAA;AACrF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,YAAoB,EACpB,UAAkB;IAElB,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,OAAO,CAAA;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,YAAoB,EACpB,UAAkB;IAElB,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,SAAS,CAAA;AACpE,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,YAAoB,EACpB,UAAkB,EAClB,UAAkB;IAElB,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,WAAW,UAAU,EAAE,CAAA;AAClF,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,KAAK,CAAC,EACpB,SAAS,EACT,IAAI,EAIL;IACC,2EAA2E;IAC3E,2EAA2E;IAC3E,qDAAqD;IACrD,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,CAAA;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC5D,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAA;AAC3C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,aAAqB;IACtD,OAAO,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,GAAG,CAAA;AAC1E,CAAC;AAoBD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,SAAS,EACT,MAAM,EAIP;IACC,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,CAAA;IAClE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,QAAgB,CAAA;IACpB,IAAI,CAAC;QACH,CAAC;QAAA,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAA;IAC3C,OAAO,cAAc,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AAClE,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,IAAI,QAAkB,CAAA;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAA;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;QAC3E,4EAA4E;QAC5E,mEAAmE;QACnE,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACzD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,QAAyC,CAAA;IACtE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;IACnC,CAAC;IACD,qEAAqE;IACrE,wEAAwE;IACxE,uDAAuD;IACvD,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAW,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IAC1D,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC,CAAW,EAAE,CAAA;IACzE,CAAC;IACD,yEAAyE;IACzE,kDAAkD;IAClD,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAW,CAAC,EAAE,CAAC;QAC5C,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IAC1D,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,OAAO;YACP,YAAY,EAAE,IAAI,CAAC,CAAC,CAAW;YAC/B,UAAU,EAAE,IAAI,CAAC,CAAC,CAAW;SAC9B,CAAA;IACH,CAAC;IACD,qEAAqE;IACrE,uDAAuD;IACvD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;AAC1D,CAAC"}
|
|
@@ -1,3 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Whether `id` is a reserved Collection-id path segment.
|
|
3
|
+
*
|
|
4
|
+
* @param id {string}
|
|
5
|
+
* @returns {boolean}
|
|
6
|
+
*/
|
|
7
|
+
export declare function isReservedCollectionId(id: string): boolean;
|
|
8
|
+
/**
|
|
9
|
+
* Whether `id` is a reserved Resource-id path segment.
|
|
10
|
+
*
|
|
11
|
+
* @param id {string}
|
|
12
|
+
* @returns {boolean}
|
|
13
|
+
*/
|
|
14
|
+
export declare function isReservedResourceId(id: string): boolean;
|
|
1
15
|
/**
|
|
2
16
|
* Throws a `ValidationError` if the given id collides with a reserved path
|
|
3
17
|
* segment for its kind.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"reserved.d.ts","sourceRoot":"","sources":["../../src/internal/reserved.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"reserved.d.ts","sourceRoot":"","sources":["../../src/internal/reserved.ts"],"names":[],"mappings":"AAoBA;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,EAAE,EACF,IAAI,EACL,EAAE;IACD,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,YAAY,GAAG,UAAU,CAAA;CAChC,GAAG,IAAI,CAQP"}
|
|
@@ -7,11 +7,30 @@
|
|
|
7
7
|
* than letting the server answer `409 Conflict`.
|
|
8
8
|
*
|
|
9
9
|
* The reserved sets themselves are single-sourced from `@interop/storage-core`
|
|
10
|
-
* (the spec's Reserved Path Segment Registry)
|
|
11
|
-
*
|
|
10
|
+
* (the spec's Reserved Path Segment Registry). This module adds the
|
|
11
|
+
* client-side `ValidationError`-throwing guard and the two membership
|
|
12
|
+
* predicates the path grammar asks with.
|
|
12
13
|
*/
|
|
13
14
|
import { RESERVED_COLLECTION_IDS, RESERVED_RESOURCE_IDS } from '@interop/storage-core';
|
|
14
15
|
import { ValidationError } from '../errors.js';
|
|
16
|
+
/**
|
|
17
|
+
* Whether `id` is a reserved Collection-id path segment.
|
|
18
|
+
*
|
|
19
|
+
* @param id {string}
|
|
20
|
+
* @returns {boolean}
|
|
21
|
+
*/
|
|
22
|
+
export function isReservedCollectionId(id) {
|
|
23
|
+
return RESERVED_COLLECTION_IDS.has(id);
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Whether `id` is a reserved Resource-id path segment.
|
|
27
|
+
*
|
|
28
|
+
* @param id {string}
|
|
29
|
+
* @returns {boolean}
|
|
30
|
+
*/
|
|
31
|
+
export function isReservedResourceId(id) {
|
|
32
|
+
return RESERVED_RESOURCE_IDS.has(id);
|
|
33
|
+
}
|
|
15
34
|
/**
|
|
16
35
|
* Throws a `ValidationError` if the given id collides with a reserved path
|
|
17
36
|
* segment for its kind.
|
|
@@ -23,8 +42,8 @@ import { ValidationError } from '../errors.js';
|
|
|
23
42
|
* @returns {void}
|
|
24
43
|
*/
|
|
25
44
|
export function assertNotReserved({ id, kind }) {
|
|
26
|
-
const
|
|
27
|
-
if (
|
|
45
|
+
const isReserved = kind === 'collection' ? isReservedCollectionId : isReservedResourceId;
|
|
46
|
+
if (isReserved(id)) {
|
|
28
47
|
throw new ValidationError(`Cannot use reserved path segment "${id}" as a ${kind} id.`);
|
|
29
48
|
}
|
|
30
49
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"reserved.js","sourceRoot":"","sources":["../../src/internal/reserved.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH
|
|
1
|
+
{"version":3,"file":"reserved.js","sourceRoot":"","sources":["../../src/internal/reserved.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;GASG;AACH,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,EAAU;IAC/C,OAAO,uBAAuB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAU;IAC7C,OAAO,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;AACtC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAChC,EAAE,EACF,IAAI,EAIL;IACC,MAAM,UAAU,GACd,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,oBAAoB,CAAA;IACvE,IAAI,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,eAAe,CACvB,qCAAqC,EAAE,UAAU,IAAI,MAAM,CAC5D,CAAA;IACH,CAAC;AACH,CAAC"}
|
package/dist/paths.d.ts
CHANGED
|
@@ -6,12 +6,15 @@
|
|
|
6
6
|
* standalone functions, for a consumer that has to form a WAS path or a zcap
|
|
7
7
|
* `invocationTarget` without going through a navigational handle.
|
|
8
8
|
*
|
|
9
|
-
* The path builders own the trailing-slash canonicalization (
|
|
10
|
-
*
|
|
11
|
-
*
|
|
9
|
+
* The path builders own the trailing-slash canonicalization (a trailing slash
|
|
10
|
+
* marks a container in canonical form -- `/space/{s}/`, `/space/{s}/{c}/` --
|
|
11
|
+
* everything else has none, and no two paths differ only by a trailing slash)
|
|
12
|
+
* and the per-segment percent-encoding, and the zcap `invocationTarget` is
|
|
12
13
|
* derived from the request URL -- so a caller that hand-assembles a path is
|
|
13
14
|
* re-deriving rules that must match the server's `allowedTarget` byte for byte.
|
|
14
|
-
* Exporting the builders instead is what keeps that from happening.
|
|
15
|
+
* Exporting the builders instead is what keeps that from happening. A
|
|
16
|
+
* container's description lives at its `meta` segment (`spaceMeta`,
|
|
17
|
+
* `collectionMeta`) instead of at the container URL.
|
|
15
18
|
*
|
|
16
19
|
* `parseSpacePath` / `parseSpaceTarget` are the inverse grammar (a pathname or
|
|
17
20
|
* an absolute URL back to the containment depth it addresses), and
|
|
@@ -24,7 +27,7 @@
|
|
|
24
27
|
* Kept off the core entry so a consumer opts in; every export here is a pure
|
|
25
28
|
* function with no I/O and no client state.
|
|
26
29
|
*/
|
|
27
|
-
export { spacePath,
|
|
30
|
+
export { spacePath, spaceMeta, collectionPath, collectionMeta, collectionLog, collectionQuery, resourcePath, resourceMeta, toUrl, parseSpacePath, parseSpaceTarget } from './internal/paths.js';
|
|
28
31
|
export type { ParsedSpacePath } from './internal/paths.js';
|
|
29
32
|
export { rootCapabilityId, rootCapability } from './internal/revoke.js';
|
|
30
33
|
//# sourceMappingURL=paths.d.ts.map
|
package/dist/paths.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH
|
|
1
|
+
{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EACL,SAAS,EACT,SAAS,EACT,cAAc,EACd,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,KAAK,EACL,cAAc,EACd,gBAAgB,EACjB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAE1D,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA"}
|
package/dist/paths.js
CHANGED
|
@@ -6,12 +6,15 @@
|
|
|
6
6
|
* standalone functions, for a consumer that has to form a WAS path or a zcap
|
|
7
7
|
* `invocationTarget` without going through a navigational handle.
|
|
8
8
|
*
|
|
9
|
-
* The path builders own the trailing-slash canonicalization (
|
|
10
|
-
*
|
|
11
|
-
*
|
|
9
|
+
* The path builders own the trailing-slash canonicalization (a trailing slash
|
|
10
|
+
* marks a container in canonical form -- `/space/{s}/`, `/space/{s}/{c}/` --
|
|
11
|
+
* everything else has none, and no two paths differ only by a trailing slash)
|
|
12
|
+
* and the per-segment percent-encoding, and the zcap `invocationTarget` is
|
|
12
13
|
* derived from the request URL -- so a caller that hand-assembles a path is
|
|
13
14
|
* re-deriving rules that must match the server's `allowedTarget` byte for byte.
|
|
14
|
-
* Exporting the builders instead is what keeps that from happening.
|
|
15
|
+
* Exporting the builders instead is what keeps that from happening. A
|
|
16
|
+
* container's description lives at its `meta` segment (`spaceMeta`,
|
|
17
|
+
* `collectionMeta`) instead of at the container URL.
|
|
15
18
|
*
|
|
16
19
|
* `parseSpacePath` / `parseSpaceTarget` are the inverse grammar (a pathname or
|
|
17
20
|
* an absolute URL back to the containment depth it addresses), and
|
|
@@ -24,6 +27,6 @@
|
|
|
24
27
|
* Kept off the core entry so a consumer opts in; every export here is a pure
|
|
25
28
|
* function with no I/O and no client state.
|
|
26
29
|
*/
|
|
27
|
-
export { spacePath,
|
|
30
|
+
export { spacePath, spaceMeta, collectionPath, collectionMeta, collectionLog, collectionQuery, resourcePath, resourceMeta, toUrl, parseSpacePath, parseSpaceTarget } from './internal/paths.js';
|
|
28
31
|
export { rootCapabilityId, rootCapability } from './internal/revoke.js';
|
|
29
32
|
//# sourceMappingURL=paths.js.map
|
package/dist/paths.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH
|
|
1
|
+
{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EACL,SAAS,EACT,SAAS,EACT,cAAc,EACd,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,KAAK,EACL,cAAc,EACd,gBAAgB,EACjB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA"}
|
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
* collection is created descriptor-less here and declared governed afterwards,
|
|
23
23
|
* by the caller's guarded create of the log.
|
|
24
24
|
*/
|
|
25
|
-
import type { IDID, IZcap,
|
|
25
|
+
import type { IDID, IZcap, SpaceMetadata } from '../types.js';
|
|
26
26
|
import type { WasClient } from '../WasClient.js';
|
|
27
27
|
/**
|
|
28
28
|
* Ensures the controller's Space exists and one synced collection is
|
|
@@ -78,7 +78,7 @@ import type { WasClient } from '../WasClient.js';
|
|
|
78
78
|
* Space creation; defaults to `'WAS Space'`
|
|
79
79
|
* @param [options.collectionName] {string} the collection display name,
|
|
80
80
|
* applied only at collection creation; defaults to the collection id
|
|
81
|
-
* @param [options.spaceDescription] {
|
|
81
|
+
* @param [options.spaceDescription] {SpaceMetadata} the Space's
|
|
82
82
|
* description, when the caller has already ensured the Space (with
|
|
83
83
|
* {@link ensureSpace}). Supplying it skips the Space half entirely, which is
|
|
84
84
|
* what keeps a caller provisioning N collections from ensuring one Space N
|
|
@@ -111,7 +111,7 @@ export declare function ensureSpaceAndCollection({ was, spaceId, controllerDid,
|
|
|
111
111
|
isPublic?: boolean;
|
|
112
112
|
spaceName?: string;
|
|
113
113
|
collectionName?: string;
|
|
114
|
-
spaceDescription?:
|
|
114
|
+
spaceDescription?: SpaceMetadata;
|
|
115
115
|
capability?: IZcap;
|
|
116
116
|
generator?: IDID;
|
|
117
117
|
generatorOrigin?: string;
|
|
@@ -138,7 +138,7 @@ export declare function ensureSpaceAndCollection({ was, spaceId, controllerDid,
|
|
|
138
138
|
* Space creation; defaults to `'WAS Space'`
|
|
139
139
|
* @param [options.capability] {IZcap} an invocation capability both
|
|
140
140
|
* requests ride; the root capability is invoked otherwise
|
|
141
|
-
* @returns {Promise<
|
|
141
|
+
* @returns {Promise<SpaceMetadata>} the Space's description, existing or
|
|
142
142
|
* just written -- pass it to {@link ensureSpaceAndCollection} as
|
|
143
143
|
* `spaceDescription` so each collection skips the Space ensure
|
|
144
144
|
*/
|
|
@@ -148,5 +148,5 @@ export declare function ensureSpace({ was, spaceId, controllerDid, spaceName, ca
|
|
|
148
148
|
controllerDid: string;
|
|
149
149
|
spaceName?: string;
|
|
150
150
|
capability?: IZcap;
|
|
151
|
-
}): Promise<
|
|
151
|
+
}): Promise<SpaceMetadata>;
|
|
152
152
|
//# sourceMappingURL=provisioning.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"provisioning.d.ts","sourceRoot":"","sources":["../../src/sync/provisioning.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAEV,IAAI,EACJ,KAAK,EACL,
|
|
1
|
+
{"version":3,"file":"provisioning.d.ts","sourceRoot":"","sources":["../../src/sync/provisioning.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAEV,IAAI,EACJ,KAAK,EACL,aAAa,EACd,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AA+GhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EG;AACH,wBAAsB,wBAAwB,CAAC,EAC7C,GAAG,EACH,OAAO,EACP,aAAa,EACb,YAAY,EACZ,UAAkB,EAClB,QAAgB,EAChB,SAA8B,EAC9B,cAA6B,EAC7B,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,eAAe,EAChB,EAAE;IACD,GAAG,EAAE,SAAS,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,KAAK,GAAG,WAAW,GAAG,UAAU,CAAA;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gBAAgB,CAAC,EAAE,aAAa,CAAA;IAChC,UAAU,CAAC,EAAE,KAAK,CAAA;IAClB,SAAS,CAAC,EAAE,IAAI,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsHhB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,WAAW,CAAC,EAChC,GAAG,EACH,OAAO,EACP,aAAa,EACb,SAA8B,EAC9B,UAAU,EACX,EAAE;IACD,GAAG,EAAE,SAAS,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,KAAK,CAAA;CACnB,GAAG,OAAO,CAAC,aAAa,CAAC,CAqBzB"}
|
|
@@ -151,7 +151,7 @@ async function readOrCreate({ read, create, unreadable }) {
|
|
|
151
151
|
* Space creation; defaults to `'WAS Space'`
|
|
152
152
|
* @param [options.collectionName] {string} the collection display name,
|
|
153
153
|
* applied only at collection creation; defaults to the collection id
|
|
154
|
-
* @param [options.spaceDescription] {
|
|
154
|
+
* @param [options.spaceDescription] {SpaceMetadata} the Space's
|
|
155
155
|
* description, when the caller has already ensured the Space (with
|
|
156
156
|
* {@link ensureSpace}). Supplying it skips the Space half entirely, which is
|
|
157
157
|
* what keeps a caller provisioning N collections from ensuring one Space N
|
|
@@ -297,7 +297,7 @@ export async function ensureSpaceAndCollection({ was, spaceId, controllerDid, co
|
|
|
297
297
|
* Space creation; defaults to `'WAS Space'`
|
|
298
298
|
* @param [options.capability] {IZcap} an invocation capability both
|
|
299
299
|
* requests ride; the root capability is invoked otherwise
|
|
300
|
-
* @returns {Promise<
|
|
300
|
+
* @returns {Promise<SpaceMetadata>} the Space's description, existing or
|
|
301
301
|
* just written -- pass it to {@link ensureSpaceAndCollection} as
|
|
302
302
|
* `spaceDescription` so each collection skips the Space ensure
|
|
303
303
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"provisioning.js","sourceRoot":"","sources":["../../src/sync/provisioning.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"provisioning.js","sourceRoot":"","sources":["../../src/sync/provisioning.ts"],"names":[],"mappings":"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"}
|
package/dist/types.d.ts
CHANGED
|
@@ -17,12 +17,15 @@ import type { IDID, ISigner } from '@interop/data-integrity-core';
|
|
|
17
17
|
import type { ActionInput } from '@interop/storage-core';
|
|
18
18
|
export type { IZcap, IDelegatedZcap, IRootZcap, IDID, ISigner };
|
|
19
19
|
/**
|
|
20
|
-
* Re-export the shared WAS wire model from `@interop/storage-core`.
|
|
21
|
-
*
|
|
22
|
-
* `
|
|
23
|
-
*
|
|
20
|
+
* Re-export the shared WAS wire model from `@interop/storage-core`. A
|
|
21
|
+
* container's description is its Metadata object: `SpaceMetadata` for a Space
|
|
22
|
+
* and `CollectionMetadata` for a Collection, the latter carrying the
|
|
23
|
+
* configuration members beside `custom` and the timestamps under one
|
|
24
|
+
* validator. The resources-in-a-collection listing is
|
|
25
|
+
* `CollectionResourcesList` and the collections-in-a-space listing is
|
|
26
|
+
* `CollectionsList`.
|
|
24
27
|
*/
|
|
25
|
-
export type { Action, ActionInput, ChangeDocument, ChangesCheckpoint, ChangesPage,
|
|
28
|
+
export type { Action, ActionInput, ChangeDocument, ChangesCheckpoint, ChangesPage, SpaceMetadata, CollectionEncryption, CollectionEncryptionEpoch, CollectionEncryptionRecipient, PolicyDocument, LinkSet, LinkSetEntry, CollectionSummary, CollectionsList, SpaceSummary, SpaceListing, ResourceSummary, CollectionResourcesList, ResourceMetadata, ResourceMetadataCustom, CollectionMetadata, ImportStats, BackendReference, BackendDescriptor, BackendRegistration, BackendConnectionInput, BackendConnectionPublic, StorageLimit, CollectionUsage, BackendUsage, SpaceQuotaReport } from '@interop/storage-core';
|
|
26
29
|
import type { BackendReference, CollectionEncryption, ResourceMetadataCustom } from '@interop/storage-core';
|
|
27
30
|
/**
|
|
28
31
|
* The user-writable metadata `custom` value as a caller passes it in. The
|
|
@@ -65,10 +68,14 @@ export type CollectionEncryptionHmac = NonNullable<CollectionEncryption['hmac']>
|
|
|
65
68
|
*/
|
|
66
69
|
export type EncryptionWithHmac = CollectionEncryption;
|
|
67
70
|
/**
|
|
68
|
-
* The client-writable
|
|
69
|
-
* by `Collection.configure` and
|
|
70
|
-
* place a new writable
|
|
71
|
-
* in `
|
|
71
|
+
* The client-writable configuration members of a Collection Metadata object --
|
|
72
|
+
* the shape shared by `Collection.configure` and
|
|
73
|
+
* `Collection.replaceDescription` and the single place a new writable member is
|
|
74
|
+
* declared (the inclusion rule lives in `collectionWritableFields`).
|
|
75
|
+
*
|
|
76
|
+
* The object's other writable members are not configuration and are not listed
|
|
77
|
+
* here: `custom` (and its `epoch` stamp) is written through `setMeta`, which
|
|
78
|
+
* preserves these, exactly as a configuration write preserves `custom`.
|
|
72
79
|
*/
|
|
73
80
|
export interface CollectionWritableFields {
|
|
74
81
|
name?: string;
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EACV,KAAK,EACL,cAAc,EACd,SAAS,EACV,MAAM,mCAAmC,CAAA;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;AAE/D
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@interop/was-client",
|
|
3
3
|
"description": "A developer-friendly client for Wallet Attached Storage (WAS) servers.",
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.61.0",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"scripts": {
|
|
7
7
|
"build": "pnpm run clear && tsc",
|
|
@@ -74,7 +74,7 @@
|
|
|
74
74
|
"@interop/ezcap": "^7.4.8",
|
|
75
75
|
"@interop/http-client": "^1.0.5",
|
|
76
76
|
"@interop/minimal-cipher": "^7.10.2",
|
|
77
|
-
"@interop/storage-core": "^0.
|
|
77
|
+
"@interop/storage-core": "^0.14.1",
|
|
78
78
|
"@interop/vh-resource-log": "^0.5.1",
|
|
79
79
|
"@interop/x25519-key-agreement-key": "^5.4.0",
|
|
80
80
|
"@noble/hashes": "^2.3.0",
|