@mossbear/protocol 0.1.0-alpha.111 → 0.1.0-alpha.113

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 (44) hide show
  1. package/dist/artifact.test.js +6 -1
  2. package/dist/artifact.test.js.map +1 -1
  3. package/dist/deliverableSkillMembers.d.ts +24 -0
  4. package/dist/deliverableSkillMembers.d.ts.map +1 -0
  5. package/dist/deliverableSkillMembers.js +39 -0
  6. package/dist/deliverableSkillMembers.js.map +1 -0
  7. package/dist/deliverableSkillMembers.test.d.ts +2 -0
  8. package/dist/deliverableSkillMembers.test.d.ts.map +1 -0
  9. package/dist/deliverableSkillMembers.test.js +32 -0
  10. package/dist/deliverableSkillMembers.test.js.map +1 -0
  11. package/dist/frameDocument.d.ts.map +1 -1
  12. package/dist/frameDocument.js +10 -8
  13. package/dist/frameDocument.js.map +1 -1
  14. package/dist/frameDocument.test.js +7 -0
  15. package/dist/frameDocument.test.js.map +1 -1
  16. package/dist/index.d.ts +1 -0
  17. package/dist/index.d.ts.map +1 -1
  18. package/dist/index.js +1 -0
  19. package/dist/index.js.map +1 -1
  20. package/dist/pairing.d.ts +14 -1
  21. package/dist/pairing.d.ts.map +1 -1
  22. package/dist/pairing.js +12 -0
  23. package/dist/pairing.js.map +1 -1
  24. package/dist/photos.d.ts +93 -6
  25. package/dist/photos.d.ts.map +1 -1
  26. package/dist/photos.js +73 -5
  27. package/dist/photos.js.map +1 -1
  28. package/dist/photos.test.d.ts +2 -0
  29. package/dist/photos.test.d.ts.map +1 -0
  30. package/dist/photos.test.js +71 -0
  31. package/dist/photos.test.js.map +1 -0
  32. package/dist/schemas.d.ts +654 -52
  33. package/dist/schemas.d.ts.map +1 -1
  34. package/dist/schemas.js +123 -47
  35. package/dist/schemas.js.map +1 -1
  36. package/dist/schemas.test.js +1 -19
  37. package/dist/schemas.test.js.map +1 -1
  38. package/dist/types.d.ts +1 -3
  39. package/dist/types.d.ts.map +1 -1
  40. package/dist/types.js.map +1 -1
  41. package/dist/whatSyncs.d.ts.map +1 -1
  42. package/dist/whatSyncs.js +6 -2
  43. package/dist/whatSyncs.js.map +1 -1
  44. package/package.json +1 -1
package/dist/photos.d.ts CHANGED
@@ -109,21 +109,65 @@ export declare const BeginPhotoUploadRequestSchema: v.ObjectSchema<{
109
109
  }[], "A photo needs an original, a display and a thumb part">]>;
110
110
  }, undefined>;
111
111
  export type BeginPhotoUploadRequest = v.InferInput<typeof BeginPhotoUploadRequestSchema>;
112
+ /**
113
+ * Images one photo artifact holds at most: a capture's whole batch. The
114
+ * composer's batch ceiling is this number, so a batch always fits one artifact.
115
+ */
116
+ export declare const PHOTO_SET_LIMIT = 50;
112
117
  /**
113
118
  * `POST /api/v1/artifacts/captures/photos/uploads/<attemptId>/commit` — publish the
114
119
  * photo once every part has arrived. The name is the client's, typically the
115
120
  * picked file's: the server writes no fallback name of its own into the row.
121
+ *
122
+ * With `artifactId`, the photo is appended to that photo artifact as its next
123
+ * image instead of becoming a new one: how one capture of several photos
124
+ * becomes one artifact. The caller must own it; any other target is refused
125
+ * as not found. An append keeps the capture's name and source, so it takes
126
+ * neither; a new photo needs its `name`.
116
127
  */
117
- export declare const CommitPhotoUploadRequestSchema: v.ObjectSchema<{
118
- readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>;
128
+ export declare const CommitPhotoUploadRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
129
+ readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
119
130
  /** Where it was captured from, as a text capture's `source` says; `app` when omitted. */
120
131
  readonly source: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
121
- }, undefined>;
132
+ readonly artifactId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
133
+ }, undefined>, v.CheckAction<{
134
+ name?: string | undefined;
135
+ source?: string | undefined;
136
+ artifactId?: string | undefined;
137
+ }, "A new photo needs a name; an append takes neither a name nor a source">]>;
122
138
  export type CommitPhotoUploadRequest = v.InferInput<typeof CommitPhotoUploadRequestSchema>;
123
139
  /**
124
- * The media description an item carries when it is a photo: one entry per
125
- * stored part, so a list can lay out a thumbnail and a viewer can size the
126
- * display variant without fetching either.
140
+ * One image of a photo artifact: one entry per stored part, and the id the
141
+ * server gave it when it was committed. The id names the image across a
142
+ * reorder, where its index does not; an image stored before ids existed has
143
+ * none, and is only ever the one image of its set.
144
+ */
145
+ export declare const PhotoImageSchema: v.ObjectSchema<{
146
+ readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
147
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
148
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
149
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
150
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
151
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
152
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
153
+ }, undefined>, undefined>;
154
+ }, undefined>;
155
+ export type PhotoImage = v.InferOutput<typeof PhotoImageSchema>;
156
+ /**
157
+ * The media description an item carries when it is a photo, so a list can lay
158
+ * out thumbnails and a viewer can size each display variant without fetching
159
+ * any of them.
160
+ *
161
+ * `images` is the photo's ordered set: one capture of several photos is one
162
+ * artifact, and a single photo is a set of one. A part is fetched by its
163
+ * image's index in this array.
164
+ *
165
+ * `parts` repeats the first image's parts. It is a compatibility projection
166
+ * for readers that predate `images` (published CLI versions, installed app
167
+ * builds); it goes once no supported reader needs it, which the
168
+ * `photo-asset-parts-retire` work item tracks. `images` is absent only from a
169
+ * server or stored row that predates it, which is why it is optional here:
170
+ * read the set through {@link photoImagesOf}, never `parts`.
127
171
  */
128
172
  export declare const PhotoAssetSchema: v.ObjectSchema<{
129
173
  readonly parts: v.ArraySchema<v.ObjectSchema<{
@@ -133,8 +177,51 @@ export declare const PhotoAssetSchema: v.ObjectSchema<{
133
177
  readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
134
178
  readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
135
179
  }, undefined>, undefined>;
180
+ readonly images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
181
+ readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
182
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
183
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
184
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
185
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
186
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
187
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
188
+ }, undefined>, undefined>;
189
+ }, undefined>, undefined>, v.MinLengthAction<{
190
+ id?: string | undefined;
191
+ parts: {
192
+ role: "original" | "display" | "thumb";
193
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
194
+ bytes: number;
195
+ width: number;
196
+ height: number;
197
+ }[];
198
+ }[], 1, undefined>]>, undefined>;
136
199
  }, undefined>;
137
200
  export type PhotoAsset = v.InferOutput<typeof PhotoAssetSchema>;
201
+ /** A photo's images in order; one that predates `images` is a set of one. */
202
+ export declare function photoImagesOf(asset: PhotoAsset): PhotoImage[];
203
+ /**
204
+ * The asset a photo of these images carries: the ordered set, and `parts` as
205
+ * the first image's, the compatibility projection {@link PhotoAssetSchema}
206
+ * describes.
207
+ */
208
+ export declare function photoAssetOfImages(images: readonly PhotoImage[]): PhotoAsset;
209
+ /**
210
+ * `PUT /api/v1/artifacts/<id>/images` — remove images from a photo artifact,
211
+ * or reorder them. `from` is the set as the caller last saw it, every image's
212
+ * id in order, and `images` is the set it should become: some or all of those
213
+ * ids, each at most once, in their new order. The server refuses the edit when
214
+ * the set is no longer `from`, so an edit made against a stale view never
215
+ * drops an image the caller did not see.
216
+ */
217
+ export declare const EditPhotoSetRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
218
+ readonly from: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>, v.MinLengthAction<string[], 1, undefined>]>;
219
+ readonly images: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>, v.MinLengthAction<string[], 1, undefined>]>;
220
+ }, undefined>, v.CheckAction<{
221
+ from: string[];
222
+ images: string[];
223
+ }, "images must be some of from, each at most once">]>;
224
+ export type EditPhotoSetRequest = v.InferInput<typeof EditPhotoSetRequestSchema>;
138
225
  /**
139
226
  * `GET /api/v1/artifacts/captures/photos/storage` — whether photo capture is
140
227
  * available, and the caller's storage when the caller is the one who pays for
@@ -1 +1 @@
1
- {"version":3,"file":"photos.d.ts","sourceRoot":"","sources":["../src/photos.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,eAAO,MAAM,WAAW,2CAA4C,CAAA;AACpE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;AACpD,eAAO,MAAM,eAAe,wEAA0B,CAAA;AAEtD,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,6FAOpB,CAAA;AACV,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/D,wEAAwE;AACxE,eAAO,MAAM,yBAAyB,oDAI5B,CAAA;AAEV,KAAK,SAAS,GAAG;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,SAAS,cAAc,EAAE,CAAA;IACrC,uCAAuC;IACvC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAID;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,CAmB1D,CAAA;AAID,iFAAiF;AACjF,eAAO,MAAM,oBAAoB;;;;;;aAM/B,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAWzE;AAED,iFAAiF;AACjF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;kCAMjC,CAAA;AACD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAUxC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAExF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;IAEzC,yFAAyF;;aAEzF,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,8BAA8B,CAAC,CAAA;AAE1F;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;aAE3B,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;;;;;aAQrC,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAA"}
1
+ {"version":3,"file":"photos.d.ts","sourceRoot":"","sources":["../src/photos.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,eAAO,MAAM,WAAW,2CAA4C,CAAA;AACpE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;AACpD,eAAO,MAAM,eAAe,wEAA0B,CAAA;AAEtD,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,6FAOpB,CAAA;AACV,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/D,wEAAwE;AACxE,eAAO,MAAM,yBAAyB,oDAI5B,CAAA;AAEV,KAAK,SAAS,GAAG;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,SAAS,cAAc,EAAE,CAAA;IACrC,uCAAuC;IACvC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAID;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,CAmB1D,CAAA;AAID,iFAAiF;AACjF,eAAO,MAAM,oBAAoB;;;;;;aAM/B,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAWzE;AAED,iFAAiF;AACjF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;kCAMjC,CAAA;AACD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAUxC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAExF;;;GAGG;AACH,eAAO,MAAM,eAAe,KAAK,CAAA;AAEjC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,8BAA8B;;IAGvC,yFAAyF;;;;;;;6EAW5F,CAAA;AACD,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,8BAA8B,CAAC,CAAA;AAI1F;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;aAG3B,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;aAK3B,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,EAAE,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,CAI5E;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB;;;;;;sDAYrC,CAAA;AACD,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAEhF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;;;;;aAQrC,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAA"}
package/dist/photos.js CHANGED
@@ -100,24 +100,92 @@ export const BeginPhotoUploadRequestSchema = v.object({
100
100
  idempotencyKey: v.pipe(v.string(), v.regex(/^[A-Za-z0-9_-]{16,128}$/)),
101
101
  parts: v.pipe(v.array(PhotoUploadPartSchema), v.length(PHOTO_ROLES.length), v.check((parts) => PHOTO_ROLES.every((role) => parts.some((part) => part.role === role)), 'A photo needs an original, a display and a thumb part')),
102
102
  });
103
+ /**
104
+ * Images one photo artifact holds at most: a capture's whole batch. The
105
+ * composer's batch ceiling is this number, so a batch always fits one artifact.
106
+ */
107
+ export const PHOTO_SET_LIMIT = 50;
103
108
  /**
104
109
  * `POST /api/v1/artifacts/captures/photos/uploads/<attemptId>/commit` — publish the
105
110
  * photo once every part has arrived. The name is the client's, typically the
106
111
  * picked file's: the server writes no fallback name of its own into the row.
112
+ *
113
+ * With `artifactId`, the photo is appended to that photo artifact as its next
114
+ * image instead of becoming a new one: how one capture of several photos
115
+ * becomes one artifact. The caller must own it; any other target is refused
116
+ * as not found. An append keeps the capture's name and source, so it takes
117
+ * neither; a new photo needs its `name`.
107
118
  */
108
- export const CommitPhotoUploadRequestSchema = v.object({
109
- name: v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(200)),
119
+ export const CommitPhotoUploadRequestSchema = v.pipe(v.object({
120
+ name: v.optional(v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(200))),
110
121
  /** Where it was captured from, as a text capture's `source` says; `app` when omitted. */
111
122
  source: v.optional(v.pipe(v.string(), v.minLength(1), v.maxLength(64))),
123
+ artifactId: v.optional(v.pipe(v.string(), v.regex(/^[A-Za-z0-9_-]{1,64}$/))),
124
+ }), v.check((body) => body.artifactId === undefined
125
+ ? body.name !== undefined
126
+ : body.name === undefined && body.source === undefined, 'A new photo needs a name; an append takes neither a name nor a source'));
127
+ const ImageIdSchema = v.pipe(v.string(), v.regex(/^[A-Za-z0-9_-]{1,64}$/));
128
+ /**
129
+ * One image of a photo artifact: one entry per stored part, and the id the
130
+ * server gave it when it was committed. The id names the image across a
131
+ * reorder, where its index does not; an image stored before ids existed has
132
+ * none, and is only ever the one image of its set.
133
+ */
134
+ export const PhotoImageSchema = v.object({
135
+ id: v.optional(ImageIdSchema),
136
+ parts: v.array(PhotoPartMediaSchema),
112
137
  });
113
138
  /**
114
- * The media description an item carries when it is a photo: one entry per
115
- * stored part, so a list can lay out a thumbnail and a viewer can size the
116
- * display variant without fetching either.
139
+ * The media description an item carries when it is a photo, so a list can lay
140
+ * out thumbnails and a viewer can size each display variant without fetching
141
+ * any of them.
142
+ *
143
+ * `images` is the photo's ordered set: one capture of several photos is one
144
+ * artifact, and a single photo is a set of one. A part is fetched by its
145
+ * image's index in this array.
146
+ *
147
+ * `parts` repeats the first image's parts. It is a compatibility projection
148
+ * for readers that predate `images` (published CLI versions, installed app
149
+ * builds); it goes once no supported reader needs it, which the
150
+ * `photo-asset-parts-retire` work item tracks. `images` is absent only from a
151
+ * server or stored row that predates it, which is why it is optional here:
152
+ * read the set through {@link photoImagesOf}, never `parts`.
117
153
  */
118
154
  export const PhotoAssetSchema = v.object({
119
155
  parts: v.array(PhotoPartMediaSchema),
156
+ // No upper bound here: the cap is the server's to enforce at commit, and a
157
+ // reader that refused a longer set would lose the whole item it rides in.
158
+ images: v.optional(v.pipe(v.array(PhotoImageSchema), v.minLength(1))),
120
159
  });
160
+ /** A photo's images in order; one that predates `images` is a set of one. */
161
+ export function photoImagesOf(asset) {
162
+ return asset.images ?? [{ parts: asset.parts }];
163
+ }
164
+ /**
165
+ * The asset a photo of these images carries: the ordered set, and `parts` as
166
+ * the first image's, the compatibility projection {@link PhotoAssetSchema}
167
+ * describes.
168
+ */
169
+ export function photoAssetOfImages(images) {
170
+ const [first] = images;
171
+ if (!first)
172
+ throw new Error('a photo has at least one image');
173
+ return { parts: first.parts, images: [...images] };
174
+ }
175
+ /**
176
+ * `PUT /api/v1/artifacts/<id>/images` — remove images from a photo artifact,
177
+ * or reorder them. `from` is the set as the caller last saw it, every image's
178
+ * id in order, and `images` is the set it should become: some or all of those
179
+ * ids, each at most once, in their new order. The server refuses the edit when
180
+ * the set is no longer `from`, so an edit made against a stale view never
181
+ * drops an image the caller did not see.
182
+ */
183
+ export const EditPhotoSetRequestSchema = v.pipe(v.object({
184
+ from: v.pipe(v.array(ImageIdSchema), v.minLength(1)),
185
+ images: v.pipe(v.array(ImageIdSchema), v.minLength(1)),
186
+ }), v.check((body) => new Set(body.from).size === body.from.length &&
187
+ new Set(body.images).size === body.images.length &&
188
+ body.images.every((id) => body.from.includes(id)), 'images must be some of from, each at most once'));
121
189
  /**
122
190
  * `GET /api/v1/artifacts/captures/photos/storage` — whether photo capture is
123
191
  * available, and the caller's storage when the caller is the one who pays for
@@ -1 +1 @@
1
- {"version":3,"file":"photos.js","sourceRoot":"","sources":["../src/photos.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"photos.js","sourceRoot":"","sources":["../src/photos.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=photos.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"photos.test.d.ts","sourceRoot":"","sources":["../src/photos.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,71 @@
1
+ import * as v from 'valibot';
2
+ import { describe, expect, it } from 'vitest';
3
+ import { CommitPhotoUploadRequestSchema, EditPhotoSetRequestSchema, PHOTO_SET_LIMIT, PhotoAssetSchema, photoAssetOfImages, photoImagesOf, } from './photos.js';
4
+ const image = (bytes) => ({
5
+ parts: [{ role: 'thumb', mediaType: 'image/webp', bytes, width: 64, height: 48 }],
6
+ });
7
+ describe('a photo’s ordered images', () => {
8
+ it('reads an asset that predates the set as a set of one', () => {
9
+ const { parts } = image(10);
10
+ expect(photoImagesOf({ parts })).toEqual([{ parts }]);
11
+ });
12
+ it('reads the set in order when it is there, never the projection', () => {
13
+ const images = [image(1), image(2), image(3)];
14
+ expect(photoImagesOf({ parts: image(99).parts, images })).toEqual(images);
15
+ });
16
+ it('projects the first image’s parts beside the set, for readers that predate it', () => {
17
+ const images = [image(1), image(2)];
18
+ const asset = photoAssetOfImages(images);
19
+ expect(asset).toEqual({ parts: images[0].parts, images });
20
+ expect(v.parse(PhotoAssetSchema, asset)).toEqual(asset);
21
+ });
22
+ it('has no shape for a photo of no images', () => {
23
+ expect(() => photoAssetOfImages([])).toThrow();
24
+ expect(v.safeParse(PhotoAssetSchema, { parts: [], images: [] }).success).toBe(false);
25
+ });
26
+ it('reads a set longer than today’s cap, which is the server’s to enforce', () => {
27
+ const over = Array.from({ length: PHOTO_SET_LIMIT + 1 }, (_, i) => image(i + 1));
28
+ expect(v.safeParse(PhotoAssetSchema, photoAssetOfImages(over)).success).toBe(true);
29
+ });
30
+ });
31
+ describe('committing a photo upload', () => {
32
+ it('names a new photo, or a capture to append to and nothing else', () => {
33
+ expect(v.parse(CommitPhotoUploadRequestSchema, { name: 'IMG_1' })).toEqual({
34
+ name: 'IMG_1',
35
+ });
36
+ expect(v.parse(CommitPhotoUploadRequestSchema, { artifactId: 'abc_DEF-12' })).toEqual({
37
+ artifactId: 'abc_DEF-12',
38
+ });
39
+ for (const body of [
40
+ {},
41
+ { name: 'IMG_1', artifactId: 'abc' },
42
+ { source: 'ios', artifactId: 'abc' },
43
+ ])
44
+ expect(v.safeParse(CommitPhotoUploadRequestSchema, body).success).toBe(false);
45
+ });
46
+ it('refuses a target that is not an id', () => {
47
+ for (const artifactId of ['', 'a/b', 'x'.repeat(65), '../etc'])
48
+ expect(v.safeParse(CommitPhotoUploadRequestSchema, { artifactId }).success).toBe(false);
49
+ });
50
+ });
51
+ describe('an image’s id', () => {
52
+ it('carries through the set, and an image without one still parses', () => {
53
+ const images = [{ id: 'a1', ...image(1) }, image(2)];
54
+ const parsed = v.parse(PhotoAssetSchema, photoAssetOfImages(images));
55
+ expect(parsed.images?.map((i) => i.id)).toEqual(['a1', undefined]);
56
+ });
57
+ });
58
+ describe('the edit of a photo set', () => {
59
+ const ok = (body) => v.safeParse(EditPhotoSetRequestSchema, body).success;
60
+ it('takes some or all of the set, in a new order', () => {
61
+ expect(ok({ from: ['a', 'b', 'c'], images: ['c', 'a'] })).toBe(true);
62
+ expect(ok({ from: ['a', 'b'], images: ['b', 'a'] })).toBe(true);
63
+ });
64
+ it('refuses an image the set did not hold, a repeat, or nothing left', () => {
65
+ expect(ok({ from: ['a', 'b'], images: ['a', 'z'] })).toBe(false);
66
+ expect(ok({ from: ['a', 'b'], images: ['a', 'a'] })).toBe(false);
67
+ expect(ok({ from: ['a', 'a'], images: ['a'] })).toBe(false);
68
+ expect(ok({ from: ['a'], images: [] })).toBe(false);
69
+ });
70
+ });
71
+ //# sourceMappingURL=photos.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"photos.test.js","sourceRoot":"","sources":["../src/photos.test.ts"],"names":[],"mappings":"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"}