@valbuild/shared 0.140.2 → 0.141.0

package/CHANGELOG.md

@@ -1,5 +1,73 @@
 # @valbuild/shared
 
+## 0.141.0
+
+### Minor Changes
+
+- [#802](https://github.com/valbuild/val/pull/802) [`199e214`](https://github.com/valbuild/val/commit/199e21471d98806fb34c579cb876560078c928b9) Thanks [@freekh](https://github.com/freekh)! - New: `files: { remote: true }` in `val.config.ts` stores every image, file and video on Val's remote content host.
+
+  ```ts
+  const { s, c, val, config } = initVal({
+    project: "myorg/myproject",
+    files: { remote: true },
+  });
+  ```
+
+  With it, `s.image()`, `s.file()`, `s.video()`, `s.imageset()`, `s.fileset()`, `s.videoset()` and `s.richtext({ img: true })` behave as though `.remote()` had been written on them. Images already in the project are reported as `image:upload-remote` until they are uploaded; `npx val validate --fix` does that.
+
+  **Required in the Val app.** A project running there (`VAL_ENV=app`) refuses to start without it, with an error that says what to add, and `val publish` refuses before it builds.
+
+  **Breaking:** `files.directory` has been removed from `val.config.ts`. Local files that have no `dir` of their own are stored in `/public/val`, which was the default.
+
+- [#779](https://github.com/valbuild/val/pull/779) [`ba3f330`](https://github.com/valbuild/val/commit/ba3f3300a3dd8649e154097cdfca3b64db209d89) Thanks [@freekh](https://github.com/freekh)! - New: `s.video()`, for mp4/WebM files and HLS streams.
+
+  ```ts
+  const schema = s.object({
+    intro: s.video({ stream: { type: "hls" } }),
+  });
+  ```
+
+  - **Upload and play in the Studio.** A video field shows a player, the file's size and length, and progress while it uploads.
+  - **HLS streaming without a video service.** With `stream: { type: "hls" }`, the Studio converts an upload to an HLS stream in the editor's browser before it uploads it. It makes one H.264 rendition per height (1080p, 720p and 480p by default, and never larger than the upload) and stores them as a folder of files next to your other uploads. Nothing is installed in your app for this: the converter ships inside the Studio and is only downloaded when someone uploads to a streaming field. A browser that can't convert (no WebCodecs, or a non-https address) uploads the original file and says so.
+  - **Poster:** pause on a frame and choose "Use current frame". The frame is saved as an image, and `posterTime` records where it was taken.
+  - **Start and end:** play part of a video without cutting the file.
+  - **Focal point:** marks what must stay in frame when the page crops the video.
+  - **Description:** text for people who can't see the video.
+  - **Captions:** one WebVTT file per language. `.srt` files are converted on upload.
+  - **`<ValVideo>`** in `@valbuild/next` and `@valbuild/tanstack` renders all of the above and is click-to-edit. For HLS in browsers that can't play it natively, pass `hls={() => import("hls.js")}`. It is only loaded when it's needed.
+  - **Rename** a video in the Studio. An HLS stream is renamed as a whole: every playlist and segment moves to the new folder.
+  - `npx val validate --fix` fills in `mimeType`, `width`, `height` and `duration` for a hand-written `.mp4`, `.mov`, `.webm`, `.mkv` or HLS video, on disk or on Val Remote. A remote video is not downloaded: only its headers are read, usually in one to three small requests.
+  - `.remote()` works for videos. `npx val validate --fix` moves a video to Val Remote, or back into the project, together with its poster, captions and every file of an HLS stream.
+
+  A video value always has a `mimeType`: it is how a page knows whether it has an `.mp4` or an `.m3u8`.
+
+  New: `s.videoset()`, a collection of videos, like `s.imageset()` for images.
+
+  ```ts
+  const videosVal = c.define(
+    "/content/videos.val.ts",
+    s.videoset({ dir: "/public/val/videos", stream: { type: "hls" } }),
+    {},
+  );
+  const schema = s.object({ intro: s.video(videosVal) });
+  ```
+
+  - **Upload once, set it up once, use anywhere.** A set's entry holds what is true of the file (its type, size and length) and, as defaults, a description, poster, start and end, focal point and captions. A field that picks from the set (`s.video(videosVal)`) gets all of those, and can override any of them on its own. For example, the same clip can open one page at 0:02 and every other page where the set says.
+  - **Media in the Studio.** A set is listed under Media and opens as a gallery of videos, with each video's poster as its thumbnail. Hovering a video previews it, and the selected video plays in a real player (HLS streams too) beside the poster, times, focal point and captions you edit for it. You can upload into the set (with `stream`, uploads become HLS streams, and each upload gets a poster), rename a video, and delete a video that nothing uses. Renaming a video updates every field that uses it. An HLS stream is one entry, and renaming or deleting it moves or removes all of its files.
+  - **Picking.** A set-backed field picks from the set, or uploads into it. Each value the set provides is marked "From gallery · Override", and once overridden, "Overridden · Use gallery's".
+  - `useVal` and `fetchVal` fill in what the set holds (`mimeType`, `width`, `height`, `duration`, and every default the field does not override), so `<ValVideo>` works the same either way.
+  - `.remote()` works for sets. `npx val validate --fix` fills in missing metadata for an entry, adds untracked videos found in the set's directory, and moves a set's videos to Val Remote.
+
+  Image and file galleries use the same new gallery layout: a grid or list of entries, with the selected one open in a panel beside it.
+
+  - An `s.imageset()` entry can hold a default focal point, as well as its description. An `s.image(galleryVal)` field shows both, and can override either.
+  - Fixed: outside draft mode, `useVal` and `fetchVal` now fill a gallery-backed image or file from its gallery (dimensions, mime type, description). Before, a published page got only the `path`.
+
+### Patch Changes
+
+- Updated dependencies [[`199e214`](https://github.com/valbuild/val/commit/199e21471d98806fb34c579cb876560078c928b9), [`ba3f330`](https://github.com/valbuild/val/commit/ba3f3300a3dd8649e154097cdfca3b64db209d89)]:
+  - @valbuild/core@0.141.0
+
 ## 0.140.2
 
 ### Patch Changes

package/dist/declarations/src/internal/ApiRoutes.d.ts

@@ -422,7 +422,7 @@ export declare const Api: {
                         project: z.ZodOptional<z.ZodString>;
                         root: z.ZodOptional<z.ZodString>;
                         files: z.ZodOptional<z.ZodObject<{
-                            directory: z.ZodString;
+                            remote: z.ZodOptional<z.ZodBoolean>;
                         }, z.core.$strip>>;
                         gitCommit: z.ZodOptional<z.ZodString>;
                         gitBranch: z.ZodOptional<z.ZodString>;
@@ -478,7 +478,7 @@ export declare const Api: {
                         project: z.ZodOptional<z.ZodString>;
                         root: z.ZodOptional<z.ZodString>;
                         files: z.ZodOptional<z.ZodObject<{
-                            directory: z.ZodString;
+                            remote: z.ZodOptional<z.ZodBoolean>;
                         }, z.core.$strip>>;
                         gitCommit: z.ZodOptional<z.ZodString>;
                         gitBranch: z.ZodOptional<z.ZodString>;
@@ -1090,7 +1090,7 @@ export declare const Api: {
                             message: z.ZodString;
                             value: z.ZodOptional<z.ZodUnknown>;
                             fatal: z.ZodOptional<z.ZodBoolean>;
-                            fixes: z.ZodOptional<z.ZodArray<z.ZodType<"image:add-metadata" | "image:check-metadata" | "image:upload-remote" | "image:download-remote" | "image:check-remote" | "images:check-remote" | "images:upload-remote" | "file:add-metadata" | "file:check-metadata" | "file:upload-remote" | "file:download-remote" | "file:check-remote" | "files:check-remote" | "files:upload-remote" | "keyof:check-keys" | "router:check-route" | "locale:check-locale" | "images:check-unique-folder" | "files:check-unique-folder" | "images:check-all-files" | "files:check-all-files" | "jsonValues:extract-entry" | "record:fill-keys" | "external:upload" | "view:check-module", unknown, z.core.$ZodTypeInternals<"image:add-metadata" | "image:check-metadata" | "image:upload-remote" | "image:download-remote" | "image:check-remote" | "images:check-remote" | "images:upload-remote" | "file:add-metadata" | "file:check-metadata" | "file:upload-remote" | "file:download-remote" | "file:check-remote" | "files:check-remote" | "files:upload-remote" | "keyof:check-keys" | "router:check-route" | "locale:check-locale" | "images:check-unique-folder" | "files:check-unique-folder" | "images:check-all-files" | "files:check-all-files" | "jsonValues:extract-entry" | "record:fill-keys" | "external:upload" | "view:check-module", unknown>>>>;
+                            fixes: z.ZodOptional<z.ZodArray<z.ZodType<"image:add-metadata" | "image:check-metadata" | "image:upload-remote" | "image:download-remote" | "image:check-remote" | "images:check-remote" | "images:upload-remote" | "file:add-metadata" | "file:check-metadata" | "file:upload-remote" | "file:download-remote" | "file:check-remote" | "files:check-remote" | "files:upload-remote" | "video:add-metadata" | "video:upload-remote" | "video:download-remote" | "videos:add-metadata" | "videos:check-remote" | "videos:upload-remote" | "keyof:check-keys" | "router:check-route" | "locale:check-locale" | "images:check-unique-folder" | "files:check-unique-folder" | "images:check-all-files" | "files:check-all-files" | "videos:check-unique-folder" | "videos:check-all-files" | "jsonValues:extract-entry" | "record:fill-keys" | "external:upload" | "view:check-module", unknown, z.core.$ZodTypeInternals<"image:add-metadata" | "image:check-metadata" | "image:upload-remote" | "image:download-remote" | "image:check-remote" | "images:check-remote" | "images:upload-remote" | "file:add-metadata" | "file:check-metadata" | "file:upload-remote" | "file:download-remote" | "file:check-remote" | "files:check-remote" | "files:upload-remote" | "video:add-metadata" | "video:upload-remote" | "video:download-remote" | "videos:add-metadata" | "videos:check-remote" | "videos:upload-remote" | "keyof:check-keys" | "router:check-route" | "locale:check-locale" | "images:check-unique-folder" | "files:check-unique-folder" | "images:check-all-files" | "files:check-all-files" | "videos:check-unique-folder" | "videos:check-all-files" | "jsonValues:extract-entry" | "record:fill-keys" | "external:upload" | "view:check-module", unknown>>>>;
                         }, z.core.$strip>>>>;
                     }, z.core.$strip>>;
                 }, z.core.$strip>;
@@ -1668,6 +1668,9 @@ export declare const Api: {
                     })[]>>>;
                     remote: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>>>;
                 };
+                headers: {
+                    range: z.ZodOptional<z.ZodString>;
+                };
             };
             res: z.ZodUnion<readonly [z.ZodObject<{
                 status: z.ZodLiteral<401>;
@@ -1682,6 +1685,14 @@ export declare const Api: {
             }, z.core.$strip>, z.ZodObject<{
                 status: z.ZodLiteral<200>;
                 body: z.ZodCustom<import("node:stream/web").ReadableStream<unknown>, import("node:stream/web").ReadableStream<unknown>>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<206>;
+                body: z.ZodCustom<import("node:stream/web").ReadableStream<unknown>, import("node:stream/web").ReadableStream<unknown>>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<416>;
+                json: z.ZodObject<{
+                    message: z.ZodString;
+                }, z.core.$strip>;
             }, z.core.$strip>]>;
         };
     };

package/dist/declarations/src/internal/zod/SerializedSchema.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { type SerializedSchema as SerializedSchemaT, type SerializedStringSchema as SerializedStringSchemaT, type SerializedLiteralSchema as SerializedLiteralSchemaT, type SerializedBooleanSchema as SerializedBooleanSchemaT, type SerializedNumberSchema as SerializedNumberSchemaT, type SerializedObjectSchema as SerializedObjectSchemaT, type SerializedArraySchema as SerializedArraySchemaT, type SerializedDiscriminatedUnionSchema as SerializedDiscriminatedUnionSchemaT, type SerializedEnumSchema as SerializedEnumSchemaT, type SerializedRichTextSchema as SerializedRichTextSchemaT, type SerializedRichTextOptions as SerializedRichTextOptionsT, type SerializedRecordSchema as SerializedRecordSchemaT, type SerializedKeyOfSchema as SerializedKeyOfSchemaT, type SerializedLocaleSchema as SerializedLocaleSchemaT, type SerializedRouteSchema as SerializedRouteSchemaT, type SerializedFileSchema as SerializedFileSchemaT, type SerializedDateSchema as SerializedDateSchemaT, type SerializedDateTimeSchema as SerializedDateTimeSchemaT, type SerializedColorSchema as SerializedColorSchemaT, type SerializedCodeSchema as SerializedCodeSchemaT, type SerializedImageSchema as SerializedImageSchemaT, type SerializedSettingsSchema as SerializedSettingsSchemaT } from "@valbuild/core";
+import { type SerializedSchema as SerializedSchemaT, type SerializedStringSchema as SerializedStringSchemaT, type SerializedLiteralSchema as SerializedLiteralSchemaT, type SerializedBooleanSchema as SerializedBooleanSchemaT, type SerializedNumberSchema as SerializedNumberSchemaT, type SerializedObjectSchema as SerializedObjectSchemaT, type SerializedArraySchema as SerializedArraySchemaT, type SerializedDiscriminatedUnionSchema as SerializedDiscriminatedUnionSchemaT, type SerializedEnumSchema as SerializedEnumSchemaT, type SerializedRichTextSchema as SerializedRichTextSchemaT, type SerializedRichTextOptions as SerializedRichTextOptionsT, type SerializedRecordSchema as SerializedRecordSchemaT, type SerializedKeyOfSchema as SerializedKeyOfSchemaT, type SerializedLocaleSchema as SerializedLocaleSchemaT, type SerializedRouteSchema as SerializedRouteSchemaT, type SerializedFileSchema as SerializedFileSchemaT, type SerializedDateSchema as SerializedDateSchemaT, type SerializedDateTimeSchema as SerializedDateTimeSchemaT, type SerializedColorSchema as SerializedColorSchemaT, type SerializedCodeSchema as SerializedCodeSchemaT, type SerializedImageSchema as SerializedImageSchemaT, type SerializedVideoSchema as SerializedVideoSchemaT, type SerializedSettingsSchema as SerializedSettingsSchemaT } from "@valbuild/core";
 export declare const SerializedStringSchema: z.ZodType<SerializedStringSchemaT>;
 export declare const SerializedLiteralSchema: z.ZodType<SerializedLiteralSchemaT>;
 export declare const SerializedBooleanSchema: z.ZodType<SerializedBooleanSchemaT>;
@@ -33,6 +33,21 @@ export declare const FileOptions: z.ZodObject<{
     accept: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const SerializedFileSchema: z.ZodType<SerializedFileSchemaT>;
+export declare const VideoStreamOption: z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodObject<{
+    type: z.ZodLiteral<"hls">;
+    renditions: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    segmentDuration: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>]>;
+export declare const VideoOptions: z.ZodObject<{
+    dir: z.ZodOptional<z.ZodString>;
+    accept: z.ZodOptional<z.ZodString>;
+    stream: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodObject<{
+        type: z.ZodLiteral<"hls">;
+        renditions: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        segmentDuration: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>>;
+}, z.core.$strip>;
+export declare const SerializedVideoSchema: z.ZodType<SerializedVideoSchemaT>;
 export declare const DateOptions: z.ZodObject<{
     from: z.ZodOptional<z.ZodString>;
     to: z.ZodOptional<z.ZodString>;

package/internal/dist/valbuild-shared-internal.cjs.dev.js

@@ -1165,13 +1165,16 @@ var SerializedRecordSchema = zod.z.lazy(function () {
     type: zod.z.literal("record"),
     item: SerializedSchema,
     opt: zod.z["boolean"](),
-    // Optional gallery marker for files/images
-    mediaType: zod.z.union([zod.z.literal("files"), zod.z.literal("images")]).optional(),
+    // Optional gallery marker for files/images/videos
+    mediaType: zod.z.union([zod.z.literal("files"), zod.z.literal("images"), zod.z.literal("videos")]).optional(),
     // Optional legacy gallery metadata
     accept: zod.z.string().optional(),
     dir: zod.z.string().optional(),
     remote: zod.z["boolean"]().optional(),
     encode: ImageEncodeOption.optional(),
+    // A videoset's: see `VideoStreamOption` below for why it is spelled
+    // out rather than passed through.
+    stream: VideoStreamOption.optional(),
     alt: SerializedSchema.optional(),
     moduleMetadata: zod.z.record(zod.z.string(), zod.z.record(zod.z.string(), zod.z.any())).optional()
   })).passthrough());
@@ -1205,6 +1208,29 @@ var SerializedFileSchema = zod.z.object(getSitemapTree._objectSpread2(getSitemap
   remote: zod.z["boolean"]().optional(),
   referencedModule: zod.z.string().optional()
 }));
+
+// `stream` is the one option that changes what an upload BECOMES, so it is
+// declared field by field: these z.objects strip unknown keys, and a stream
+// dropped in transit is a Studio that uploads a 2 GB mp4 where an HLS stream
+// was asked for.
+var VideoStreamOption = zod.z.union([zod.z.literal(false), zod.z.object({
+  type: zod.z.literal("hls"),
+  renditions: zod.z.array(zod.z.number()).optional(),
+  segmentDuration: zod.z.number().optional()
+})]);
+var VideoOptions = zod.z.object({
+  dir: zod.z.string().optional(),
+  accept: zod.z.string().optional(),
+  stream: VideoStreamOption.optional()
+});
+var SerializedVideoSchema = zod.z.object(getSitemapTree._objectSpread2(getSitemapTree._objectSpread2({}, commonSchemaFields), {}, {
+  type: zod.z.literal("video"),
+  options: VideoOptions.optional(),
+  opt: zod.z["boolean"](),
+  remote: zod.z["boolean"]().optional(),
+  // The `s.videoset()` a set-backed field picks from.
+  referencedModule: zod.z.string().optional()
+}));
 var DateOptions = zod.z.object({
   from: zod.z.string().optional(),
   to: zod.z.string().optional()
@@ -1295,7 +1321,7 @@ var SerializedValViewSchema = zod.z.object({
   hidden: zod.z["boolean"]().optional(),
   description: zod.z.string().optional()
 });
-var SerializedSchema = zod.z.union([SerializedStringSchema, SerializedLiteralSchema, SerializedBooleanSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedArraySchema, SerializedDiscriminatedUnionSchema, SerializedEnumSchema, SerializedRichTextSchema, SerializedRecordSchema, SerializedKeyOfSchema, SerializedRouteSchema, SerializedLocaleSchema, SerializedFileSchema, SerializedDateSchema, SerializedDateTimeSchema, SerializedColorSchema, SerializedCodeSchema, SerializedSettingsSchema, SerializedImageSchema, SerializedValViewSchema]);
+var SerializedSchema = zod.z.union([SerializedStringSchema, SerializedLiteralSchema, SerializedBooleanSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedArraySchema, SerializedDiscriminatedUnionSchema, SerializedEnumSchema, SerializedRichTextSchema, SerializedRecordSchema, SerializedKeyOfSchema, SerializedRouteSchema, SerializedLocaleSchema, SerializedFileSchema, SerializedDateSchema, SerializedDateTimeSchema, SerializedColorSchema, SerializedCodeSchema, SerializedSettingsSchema, SerializedImageSchema, SerializedVideoSchema, SerializedValViewSchema]);
 
 var ValCommit = zod.z.object({
   commitSha: zod.z.string(),
@@ -1476,12 +1502,12 @@ var ValConfig = zod.z.object({
   project: zod.z.string().optional(),
   root: zod.z.string().optional(),
   files: zod.z.object({
-    directory: zod.z.string() // TODO: validate that it is prefixed by /public/
+    remote: zod.z["boolean"]().optional()
   }).optional(),
   gitCommit: zod.z.string().optional(),
   gitBranch: zod.z.string().optional()
 });
-var ValidationFixZ = zod.z.union([zod.z.literal("image:add-metadata"), zod.z.literal("image:check-metadata"), zod.z.literal("image:check-remote"), zod.z.literal("image:upload-remote"), zod.z.literal("image:download-remote"), zod.z.literal("images:check-remote"), zod.z.literal("images:upload-remote"), zod.z.literal("file:add-metadata"), zod.z.literal("file:check-metadata"), zod.z.literal("file:check-remote"), zod.z.literal("file:upload-remote"), zod.z.literal("file:download-remote"), zod.z.literal("files:check-remote"), zod.z.literal("files:upload-remote"), zod.z.literal("keyof:check-keys"), zod.z.literal("router:check-route"), zod.z.literal("locale:check-locale"), zod.z.literal("record:fill-keys"), zod.z.literal("images:check-unique-folder"), zod.z.literal("files:check-unique-folder"), zod.z.literal("images:check-all-files"), zod.z.literal("files:check-all-files"), zod.z.literal("jsonValues:extract-entry"), zod.z.literal("view:check-module")]);
+var ValidationFixZ = zod.z.union([zod.z.literal("image:add-metadata"), zod.z.literal("image:check-metadata"), zod.z.literal("image:check-remote"), zod.z.literal("image:upload-remote"), zod.z.literal("image:download-remote"), zod.z.literal("images:check-remote"), zod.z.literal("images:upload-remote"), zod.z.literal("file:add-metadata"), zod.z.literal("video:add-metadata"), zod.z.literal("video:upload-remote"), zod.z.literal("video:download-remote"), zod.z.literal("videos:add-metadata"), zod.z.literal("videos:check-remote"), zod.z.literal("videos:upload-remote"), zod.z.literal("file:check-metadata"), zod.z.literal("file:check-remote"), zod.z.literal("file:upload-remote"), zod.z.literal("file:download-remote"), zod.z.literal("files:check-remote"), zod.z.literal("files:upload-remote"), zod.z.literal("keyof:check-keys"), zod.z.literal("router:check-route"), zod.z.literal("locale:check-locale"), zod.z.literal("record:fill-keys"), zod.z.literal("images:check-unique-folder"), zod.z.literal("files:check-unique-folder"), zod.z.literal("images:check-all-files"), zod.z.literal("files:check-all-files"), zod.z.literal("videos:check-unique-folder"), zod.z.literal("videos:check-all-files"), zod.z.literal("jsonValues:extract-entry"), zod.z.literal("view:check-module")]);
 var ValidationError = zod.z.object({
   message: zod.z.string(),
   value: zod.z.unknown().optional(),
@@ -3194,11 +3220,23 @@ var Api = {
             return arg[0];
           }).optional(),
           remote: onlyOneStringQueryParam.optional()
+        },
+        // A `<video>` seeks with byte ranges, Safari will not play one from a
+        // server that ignores them, and HLS segments that are byte ranges of
+        // one file are fetched no other way.
+        headers: {
+          range: zod.z.string().optional()
         }
       },
       res: zod.z.union([unauthorizedResponse, notFoundResponse, zod.z.object({
         status: zod.z.literal(200),
         body: zod.z["instanceof"](ReadableStream)
+      }), zod.z.object({
+        status: zod.z.literal(206),
+        body: zod.z["instanceof"](ReadableStream)
+      }), zod.z.object({
+        status: zod.z.literal(416),
+        json: GenericError
       })])
     }
   },
@@ -5322,7 +5360,7 @@ function emptyOf(schema, context) {
     // language nobody chose, which is the thing this whole feature exists to
     // make visible.
     return (_context$selectedLoca = context === null || context === void 0 ? void 0 : context.selectedLocale) !== null && _context$selectedLoca !== void 0 ? _context$selectedLoca : "";
-  } else if (schema.type === "file" || schema.type === "image") {
+  } else if (schema.type === "file" || schema.type === "image" || schema.type === "video") {
     return null; // returning null is the only thing we can do, however, it means that the patches cannot be applied yet since that might fail
   } else if (schema.type === "literal") {
     return schema.value;
@@ -5532,6 +5570,14 @@ function checkGallerySchema(moduleSchema) {
   if (moduleSchema.type === "record" && moduleSchema.mediaType === "images") {
     return null;
   }
+  if (moduleSchema.type === "record" && moduleSchema.mediaType === "videos") {
+    // Said outright rather than as "not an images gallery": a set of videos
+    // looks like a gallery from here, and the tool can do nothing with one.
+    return {
+      kind: "error",
+      message: "Module is a video set (s.videoset()), not an images gallery. Videos cannot be added or removed by this tool: upload them in Val Studio."
+    };
+  }
   if (moduleSchema.type === "image") {
     return {
       kind: "wrong-tool",
@@ -5626,17 +5672,32 @@ var GALLERY_REDIRECT = {
   reason: "Destination is a media gallery (s.imageset() / s.fileset()). Gallery entries are keyed by file path and carry a file on disk, so they cannot be created with a plain patch. Use add_session_image_to_gallery."
 };
 
-/** An `s.imageset()` / `s.fileset()` record: a gallery, not an ordinary record. */
+/**
+ * A video set's entries are keyed by a file too, and a stream's by a
+ * directory of them — and there is no tool to send them to: a video is
+ * uploaded (and, for a stream, transcoded) in the Studio.
+ */
+var VIDEOSET_REFUSAL = {
+  kind: "error",
+  message: "Destination is a video set (s.videoset()). Its entries are keyed by file path and carry video files, so they cannot be created with a plain patch, and no tool here uploads a video: add it in Val Studio."
+};
+
+/** An `s.imageset()` / `s.fileset()` / `s.videoset()` record: a gallery, not an ordinary record. */
 function isGallery(schema) {
   return schema.type === "record" && schema.mediaType !== undefined;
 }
+
+/** Where to send someone whose destination is (in) the gallery `schema`. */
+function galleryRedirect(schema) {
+  return schema.type === "record" && schema.mediaType === "videos" ? VIDEOSET_REFUSAL : GALLERY_REDIRECT;
+}
 function decideOp(moduleSchema, destinationPath) {
   // The DESTINATION itself, checked before its parent: `["gallery"]` resolves
   // its parent to the enclosing object and would otherwise look like an
   // ordinary `replace` that overwrites a whole gallery.
   var destination = resolveSerializedSchemaAtPath(moduleSchema, destinationPath);
   if (destination.kind === "gallery-traversed") {
-    return GALLERY_REDIRECT;
+    return galleryRedirect(destination.schema);
   }
   if (destination.kind === "richtext") {
     return {
@@ -5647,7 +5708,7 @@ function decideOp(moduleSchema, destinationPath) {
   }
   if (destination.kind === "leaf") {
     if (isGallery(destination.schema)) {
-      return GALLERY_REDIRECT;
+      return galleryRedirect(destination.schema);
     }
     // A richtext value the path lands exactly ON resolves as a leaf, not as
     // `kind: "richtext"` (which only fires when the walk continues INTO it).
@@ -5684,7 +5745,7 @@ function decideOp(moduleSchema, destinationPath) {
   // destination is a gallery entry; `isGallery` catches the case where the
   // parent IS the gallery and the destination is a new entry key in it.
   if (parent.kind === "gallery-traversed" || isGallery(parent.schema)) {
-    return GALLERY_REDIRECT;
+    return galleryRedirect(parent.schema);
   }
   var schema = parent.schema;
   if (schema.type === "array" || schema.type === "record") {
@@ -6005,6 +6066,14 @@ function isSkippableFixCode(fix) {
     case "file:check-remote":
     case "files:check-remote":
     case "files:upload-remote":
+    case "video:add-metadata": // the Studio writes it on upload; --fix for the rest
+    case "video:upload-remote":
+    case "video:download-remote":
+    case "videos:add-metadata": // as `video:add-metadata`, for a set's entry
+    case "videos:check-remote":
+    case "videos:upload-remote":
+    case "videos:check-unique-folder":
+    case "videos:check-all-files":
     case "images:check-unique-folder":
     case "files:check-unique-folder":
     case "images:check-all-files":
@@ -6329,8 +6398,8 @@ function traverseSchemaSource(source, schema, path, callback) {
     return;
   }
 
-  // Handle file/image
-  if (schema.type === "file" || schema.type === "image") {
+  // Handle file/image/video
+  if (schema.type === "file" || schema.type === "image" || schema.type === "video") {
     if (source && getSitemapTree._typeof(source) === "object" && "path" in source && typeof source.path === "string") {
       callback({
         source: source,
@@ -6677,8 +6746,8 @@ function indexModule(searchIndex, moduleFilePath, source, schema) {
       // Use first 50 chars as label
       label = searchText.substring(0, 50) || "richtext";
     }
-    // Handle file/image
-    else if (schema.type === "file" || schema.type === "image") {
+    // Handle file/image/video
+    else if (schema.type === "file" || schema.type === "image" || schema.type === "video") {
       if (source !== null && getSitemapTree._typeof(source) === "object" && "path" in source && typeof source.path === "string") {
         // The label is the bare filename - the folder is shown separately in
         // the UI - but both are searchable.
@@ -7852,6 +7921,7 @@ exports.SerializedSchema = SerializedSchema;
 exports.SerializedSettingsSchema = SerializedSettingsSchema;
 exports.SerializedStringSchema = SerializedStringSchema;
 exports.SerializedValViewSchema = SerializedValViewSchema;
+exports.SerializedVideoSchema = SerializedVideoSchema;
 exports.SharedValConfig = SharedValConfig;
 exports.VAL_ENABLE_COOKIE_NAME = VAL_ENABLE_COOKIE_NAME;
 exports.VAL_GREEN_RAMP = VAL_GREEN_RAMP;
@@ -7860,6 +7930,8 @@ exports.VAL_STATE_COOKIE = VAL_STATE_COOKIE;
 exports.VAL_STUDIO_HEADER = VAL_STUDIO_HEADER;
 exports.ValCommit = ValCommit;
 exports.ValDeployment = ValDeployment;
+exports.VideoOptions = VideoOptions;
+exports.VideoStreamOption = VideoStreamOption;
 exports.accentRamp = accentRamp;
 exports.buildDuplicatePatch = buildDuplicatePatch;
 exports.buildEmptyAtPathPatch = buildEmptyAtPathPatch;

package/internal/dist/valbuild-shared-internal.cjs.prod.js

@@ -1165,13 +1165,16 @@ var SerializedRecordSchema = zod.z.lazy(function () {
     type: zod.z.literal("record"),
     item: SerializedSchema,
     opt: zod.z["boolean"](),
-    // Optional gallery marker for files/images
-    mediaType: zod.z.union([zod.z.literal("files"), zod.z.literal("images")]).optional(),
+    // Optional gallery marker for files/images/videos
+    mediaType: zod.z.union([zod.z.literal("files"), zod.z.literal("images"), zod.z.literal("videos")]).optional(),
     // Optional legacy gallery metadata
     accept: zod.z.string().optional(),
     dir: zod.z.string().optional(),
     remote: zod.z["boolean"]().optional(),
     encode: ImageEncodeOption.optional(),
+    // A videoset's: see `VideoStreamOption` below for why it is spelled
+    // out rather than passed through.
+    stream: VideoStreamOption.optional(),
     alt: SerializedSchema.optional(),
     moduleMetadata: zod.z.record(zod.z.string(), zod.z.record(zod.z.string(), zod.z.any())).optional()
   })).passthrough());
@@ -1205,6 +1208,29 @@ var SerializedFileSchema = zod.z.object(getSitemapTree._objectSpread2(getSitemap
   remote: zod.z["boolean"]().optional(),
   referencedModule: zod.z.string().optional()
 }));
+
+// `stream` is the one option that changes what an upload BECOMES, so it is
+// declared field by field: these z.objects strip unknown keys, and a stream
+// dropped in transit is a Studio that uploads a 2 GB mp4 where an HLS stream
+// was asked for.
+var VideoStreamOption = zod.z.union([zod.z.literal(false), zod.z.object({
+  type: zod.z.literal("hls"),
+  renditions: zod.z.array(zod.z.number()).optional(),
+  segmentDuration: zod.z.number().optional()
+})]);
+var VideoOptions = zod.z.object({
+  dir: zod.z.string().optional(),
+  accept: zod.z.string().optional(),
+  stream: VideoStreamOption.optional()
+});
+var SerializedVideoSchema = zod.z.object(getSitemapTree._objectSpread2(getSitemapTree._objectSpread2({}, commonSchemaFields), {}, {
+  type: zod.z.literal("video"),
+  options: VideoOptions.optional(),
+  opt: zod.z["boolean"](),
+  remote: zod.z["boolean"]().optional(),
+  // The `s.videoset()` a set-backed field picks from.
+  referencedModule: zod.z.string().optional()
+}));
 var DateOptions = zod.z.object({
   from: zod.z.string().optional(),
   to: zod.z.string().optional()
@@ -1295,7 +1321,7 @@ var SerializedValViewSchema = zod.z.object({
   hidden: zod.z["boolean"]().optional(),
   description: zod.z.string().optional()
 });
-var SerializedSchema = zod.z.union([SerializedStringSchema, SerializedLiteralSchema, SerializedBooleanSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedArraySchema, SerializedDiscriminatedUnionSchema, SerializedEnumSchema, SerializedRichTextSchema, SerializedRecordSchema, SerializedKeyOfSchema, SerializedRouteSchema, SerializedLocaleSchema, SerializedFileSchema, SerializedDateSchema, SerializedDateTimeSchema, SerializedColorSchema, SerializedCodeSchema, SerializedSettingsSchema, SerializedImageSchema, SerializedValViewSchema]);
+var SerializedSchema = zod.z.union([SerializedStringSchema, SerializedLiteralSchema, SerializedBooleanSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedArraySchema, SerializedDiscriminatedUnionSchema, SerializedEnumSchema, SerializedRichTextSchema, SerializedRecordSchema, SerializedKeyOfSchema, SerializedRouteSchema, SerializedLocaleSchema, SerializedFileSchema, SerializedDateSchema, SerializedDateTimeSchema, SerializedColorSchema, SerializedCodeSchema, SerializedSettingsSchema, SerializedImageSchema, SerializedVideoSchema, SerializedValViewSchema]);
 
 var ValCommit = zod.z.object({
   commitSha: zod.z.string(),
@@ -1476,12 +1502,12 @@ var ValConfig = zod.z.object({
   project: zod.z.string().optional(),
   root: zod.z.string().optional(),
   files: zod.z.object({
-    directory: zod.z.string() // TODO: validate that it is prefixed by /public/
+    remote: zod.z["boolean"]().optional()
   }).optional(),
   gitCommit: zod.z.string().optional(),
   gitBranch: zod.z.string().optional()
 });
-var ValidationFixZ = zod.z.union([zod.z.literal("image:add-metadata"), zod.z.literal("image:check-metadata"), zod.z.literal("image:check-remote"), zod.z.literal("image:upload-remote"), zod.z.literal("image:download-remote"), zod.z.literal("images:check-remote"), zod.z.literal("images:upload-remote"), zod.z.literal("file:add-metadata"), zod.z.literal("file:check-metadata"), zod.z.literal("file:check-remote"), zod.z.literal("file:upload-remote"), zod.z.literal("file:download-remote"), zod.z.literal("files:check-remote"), zod.z.literal("files:upload-remote"), zod.z.literal("keyof:check-keys"), zod.z.literal("router:check-route"), zod.z.literal("locale:check-locale"), zod.z.literal("record:fill-keys"), zod.z.literal("images:check-unique-folder"), zod.z.literal("files:check-unique-folder"), zod.z.literal("images:check-all-files"), zod.z.literal("files:check-all-files"), zod.z.literal("jsonValues:extract-entry"), zod.z.literal("view:check-module")]);
+var ValidationFixZ = zod.z.union([zod.z.literal("image:add-metadata"), zod.z.literal("image:check-metadata"), zod.z.literal("image:check-remote"), zod.z.literal("image:upload-remote"), zod.z.literal("image:download-remote"), zod.z.literal("images:check-remote"), zod.z.literal("images:upload-remote"), zod.z.literal("file:add-metadata"), zod.z.literal("video:add-metadata"), zod.z.literal("video:upload-remote"), zod.z.literal("video:download-remote"), zod.z.literal("videos:add-metadata"), zod.z.literal("videos:check-remote"), zod.z.literal("videos:upload-remote"), zod.z.literal("file:check-metadata"), zod.z.literal("file:check-remote"), zod.z.literal("file:upload-remote"), zod.z.literal("file:download-remote"), zod.z.literal("files:check-remote"), zod.z.literal("files:upload-remote"), zod.z.literal("keyof:check-keys"), zod.z.literal("router:check-route"), zod.z.literal("locale:check-locale"), zod.z.literal("record:fill-keys"), zod.z.literal("images:check-unique-folder"), zod.z.literal("files:check-unique-folder"), zod.z.literal("images:check-all-files"), zod.z.literal("files:check-all-files"), zod.z.literal("videos:check-unique-folder"), zod.z.literal("videos:check-all-files"), zod.z.literal("jsonValues:extract-entry"), zod.z.literal("view:check-module")]);
 var ValidationError = zod.z.object({
   message: zod.z.string(),
   value: zod.z.unknown().optional(),
@@ -3194,11 +3220,23 @@ var Api = {
             return arg[0];
           }).optional(),
           remote: onlyOneStringQueryParam.optional()
+        },
+        // A `<video>` seeks with byte ranges, Safari will not play one from a
+        // server that ignores them, and HLS segments that are byte ranges of
+        // one file are fetched no other way.
+        headers: {
+          range: zod.z.string().optional()
         }
       },
       res: zod.z.union([unauthorizedResponse, notFoundResponse, zod.z.object({
         status: zod.z.literal(200),
         body: zod.z["instanceof"](ReadableStream)
+      }), zod.z.object({
+        status: zod.z.literal(206),
+        body: zod.z["instanceof"](ReadableStream)
+      }), zod.z.object({
+        status: zod.z.literal(416),
+        json: GenericError
       })])
     }
   },
@@ -5322,7 +5360,7 @@ function emptyOf(schema, context) {
     // language nobody chose, which is the thing this whole feature exists to
     // make visible.
     return (_context$selectedLoca = context === null || context === void 0 ? void 0 : context.selectedLocale) !== null && _context$selectedLoca !== void 0 ? _context$selectedLoca : "";
-  } else if (schema.type === "file" || schema.type === "image") {
+  } else if (schema.type === "file" || schema.type === "image" || schema.type === "video") {
     return null; // returning null is the only thing we can do, however, it means that the patches cannot be applied yet since that might fail
   } else if (schema.type === "literal") {
     return schema.value;
@@ -5532,6 +5570,14 @@ function checkGallerySchema(moduleSchema) {
   if (moduleSchema.type === "record" && moduleSchema.mediaType === "images") {
     return null;
   }
+  if (moduleSchema.type === "record" && moduleSchema.mediaType === "videos") {
+    // Said outright rather than as "not an images gallery": a set of videos
+    // looks like a gallery from here, and the tool can do nothing with one.
+    return {
+      kind: "error",
+      message: "Module is a video set (s.videoset()), not an images gallery. Videos cannot be added or removed by this tool: upload them in Val Studio."
+    };
+  }
   if (moduleSchema.type === "image") {
     return {
       kind: "wrong-tool",
@@ -5626,17 +5672,32 @@ var GALLERY_REDIRECT = {
   reason: "Destination is a media gallery (s.imageset() / s.fileset()). Gallery entries are keyed by file path and carry a file on disk, so they cannot be created with a plain patch. Use add_session_image_to_gallery."
 };
 
-/** An `s.imageset()` / `s.fileset()` record: a gallery, not an ordinary record. */
+/**
+ * A video set's entries are keyed by a file too, and a stream's by a
+ * directory of them — and there is no tool to send them to: a video is
+ * uploaded (and, for a stream, transcoded) in the Studio.
+ */
+var VIDEOSET_REFUSAL = {
+  kind: "error",
+  message: "Destination is a video set (s.videoset()). Its entries are keyed by file path and carry video files, so they cannot be created with a plain patch, and no tool here uploads a video: add it in Val Studio."
+};
+
+/** An `s.imageset()` / `s.fileset()` / `s.videoset()` record: a gallery, not an ordinary record. */
 function isGallery(schema) {
   return schema.type === "record" && schema.mediaType !== undefined;
 }
+
+/** Where to send someone whose destination is (in) the gallery `schema`. */
+function galleryRedirect(schema) {
+  return schema.type === "record" && schema.mediaType === "videos" ? VIDEOSET_REFUSAL : GALLERY_REDIRECT;
+}
 function decideOp(moduleSchema, destinationPath) {
   // The DESTINATION itself, checked before its parent: `["gallery"]` resolves
   // its parent to the enclosing object and would otherwise look like an
   // ordinary `replace` that overwrites a whole gallery.
   var destination = resolveSerializedSchemaAtPath(moduleSchema, destinationPath);
   if (destination.kind === "gallery-traversed") {
-    return GALLERY_REDIRECT;
+    return galleryRedirect(destination.schema);
   }
   if (destination.kind === "richtext") {
     return {
@@ -5647,7 +5708,7 @@ function decideOp(moduleSchema, destinationPath) {
   }
   if (destination.kind === "leaf") {
     if (isGallery(destination.schema)) {
-      return GALLERY_REDIRECT;
+      return galleryRedirect(destination.schema);
     }
     // A richtext value the path lands exactly ON resolves as a leaf, not as
     // `kind: "richtext"` (which only fires when the walk continues INTO it).
@@ -5684,7 +5745,7 @@ function decideOp(moduleSchema, destinationPath) {
   // destination is a gallery entry; `isGallery` catches the case where the
   // parent IS the gallery and the destination is a new entry key in it.
   if (parent.kind === "gallery-traversed" || isGallery(parent.schema)) {
-    return GALLERY_REDIRECT;
+    return galleryRedirect(parent.schema);
   }
   var schema = parent.schema;
   if (schema.type === "array" || schema.type === "record") {
@@ -6005,6 +6066,14 @@ function isSkippableFixCode(fix) {
     case "file:check-remote":
     case "files:check-remote":
     case "files:upload-remote":
+    case "video:add-metadata": // the Studio writes it on upload; --fix for the rest
+    case "video:upload-remote":
+    case "video:download-remote":
+    case "videos:add-metadata": // as `video:add-metadata`, for a set's entry
+    case "videos:check-remote":
+    case "videos:upload-remote":
+    case "videos:check-unique-folder":
+    case "videos:check-all-files":
     case "images:check-unique-folder":
     case "files:check-unique-folder":
     case "images:check-all-files":
@@ -6329,8 +6398,8 @@ function traverseSchemaSource(source, schema, path, callback) {
     return;
   }
 
-  // Handle file/image
-  if (schema.type === "file" || schema.type === "image") {
+  // Handle file/image/video
+  if (schema.type === "file" || schema.type === "image" || schema.type === "video") {
     if (source && getSitemapTree._typeof(source) === "object" && "path" in source && typeof source.path === "string") {
       callback({
         source: source,
@@ -6677,8 +6746,8 @@ function indexModule(searchIndex, moduleFilePath, source, schema) {
       // Use first 50 chars as label
       label = searchText.substring(0, 50) || "richtext";
     }
-    // Handle file/image
-    else if (schema.type === "file" || schema.type === "image") {
+    // Handle file/image/video
+    else if (schema.type === "file" || schema.type === "image" || schema.type === "video") {
       if (source !== null && getSitemapTree._typeof(source) === "object" && "path" in source && typeof source.path === "string") {
         // The label is the bare filename - the folder is shown separately in
         // the UI - but both are searchable.
@@ -7852,6 +7921,7 @@ exports.SerializedSchema = SerializedSchema;
 exports.SerializedSettingsSchema = SerializedSettingsSchema;
 exports.SerializedStringSchema = SerializedStringSchema;
 exports.SerializedValViewSchema = SerializedValViewSchema;
+exports.SerializedVideoSchema = SerializedVideoSchema;
 exports.SharedValConfig = SharedValConfig;
 exports.VAL_ENABLE_COOKIE_NAME = VAL_ENABLE_COOKIE_NAME;
 exports.VAL_GREEN_RAMP = VAL_GREEN_RAMP;
@@ -7860,6 +7930,8 @@ exports.VAL_STATE_COOKIE = VAL_STATE_COOKIE;
 exports.VAL_STUDIO_HEADER = VAL_STUDIO_HEADER;
 exports.ValCommit = ValCommit;
 exports.ValDeployment = ValDeployment;
+exports.VideoOptions = VideoOptions;
+exports.VideoStreamOption = VideoStreamOption;
 exports.accentRamp = accentRamp;
 exports.buildDuplicatePatch = buildDuplicatePatch;
 exports.buildEmptyAtPathPatch = buildEmptyAtPathPatch;

package/internal/dist/valbuild-shared-internal.esm.js

@@ -1158,13 +1158,16 @@ var SerializedRecordSchema = z.lazy(function () {
     type: z.literal("record"),
     item: SerializedSchema,
     opt: z["boolean"](),
-    // Optional gallery marker for files/images
-    mediaType: z.union([z.literal("files"), z.literal("images")]).optional(),
+    // Optional gallery marker for files/images/videos
+    mediaType: z.union([z.literal("files"), z.literal("images"), z.literal("videos")]).optional(),
     // Optional legacy gallery metadata
     accept: z.string().optional(),
     dir: z.string().optional(),
     remote: z["boolean"]().optional(),
     encode: ImageEncodeOption.optional(),
+    // A videoset's: see `VideoStreamOption` below for why it is spelled
+    // out rather than passed through.
+    stream: VideoStreamOption.optional(),
     alt: SerializedSchema.optional(),
     moduleMetadata: z.record(z.string(), z.record(z.string(), z.any())).optional()
   })).passthrough());
@@ -1198,6 +1201,29 @@ var SerializedFileSchema = z.object(_objectSpread2(_objectSpread2({}, commonSche
   remote: z["boolean"]().optional(),
   referencedModule: z.string().optional()
 }));
+
+// `stream` is the one option that changes what an upload BECOMES, so it is
+// declared field by field: these z.objects strip unknown keys, and a stream
+// dropped in transit is a Studio that uploads a 2 GB mp4 where an HLS stream
+// was asked for.
+var VideoStreamOption = z.union([z.literal(false), z.object({
+  type: z.literal("hls"),
+  renditions: z.array(z.number()).optional(),
+  segmentDuration: z.number().optional()
+})]);
+var VideoOptions = z.object({
+  dir: z.string().optional(),
+  accept: z.string().optional(),
+  stream: VideoStreamOption.optional()
+});
+var SerializedVideoSchema = z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
+  type: z.literal("video"),
+  options: VideoOptions.optional(),
+  opt: z["boolean"](),
+  remote: z["boolean"]().optional(),
+  // The `s.videoset()` a set-backed field picks from.
+  referencedModule: z.string().optional()
+}));
 var DateOptions = z.object({
   from: z.string().optional(),
   to: z.string().optional()
@@ -1288,7 +1314,7 @@ var SerializedValViewSchema = z.object({
   hidden: z["boolean"]().optional(),
   description: z.string().optional()
 });
-var SerializedSchema = z.union([SerializedStringSchema, SerializedLiteralSchema, SerializedBooleanSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedArraySchema, SerializedDiscriminatedUnionSchema, SerializedEnumSchema, SerializedRichTextSchema, SerializedRecordSchema, SerializedKeyOfSchema, SerializedRouteSchema, SerializedLocaleSchema, SerializedFileSchema, SerializedDateSchema, SerializedDateTimeSchema, SerializedColorSchema, SerializedCodeSchema, SerializedSettingsSchema, SerializedImageSchema, SerializedValViewSchema]);
+var SerializedSchema = z.union([SerializedStringSchema, SerializedLiteralSchema, SerializedBooleanSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedArraySchema, SerializedDiscriminatedUnionSchema, SerializedEnumSchema, SerializedRichTextSchema, SerializedRecordSchema, SerializedKeyOfSchema, SerializedRouteSchema, SerializedLocaleSchema, SerializedFileSchema, SerializedDateSchema, SerializedDateTimeSchema, SerializedColorSchema, SerializedCodeSchema, SerializedSettingsSchema, SerializedImageSchema, SerializedVideoSchema, SerializedValViewSchema]);
 
 var ValCommit = z.object({
   commitSha: z.string(),
@@ -1469,12 +1495,12 @@ var ValConfig = z.object({
   project: z.string().optional(),
   root: z.string().optional(),
   files: z.object({
-    directory: z.string() // TODO: validate that it is prefixed by /public/
+    remote: z["boolean"]().optional()
   }).optional(),
   gitCommit: z.string().optional(),
   gitBranch: z.string().optional()
 });
-var ValidationFixZ = z.union([z.literal("image:add-metadata"), z.literal("image:check-metadata"), z.literal("image:check-remote"), z.literal("image:upload-remote"), z.literal("image:download-remote"), z.literal("images:check-remote"), z.literal("images:upload-remote"), z.literal("file:add-metadata"), z.literal("file:check-metadata"), z.literal("file:check-remote"), z.literal("file:upload-remote"), z.literal("file:download-remote"), z.literal("files:check-remote"), z.literal("files:upload-remote"), z.literal("keyof:check-keys"), z.literal("router:check-route"), z.literal("locale:check-locale"), z.literal("record:fill-keys"), z.literal("images:check-unique-folder"), z.literal("files:check-unique-folder"), z.literal("images:check-all-files"), z.literal("files:check-all-files"), z.literal("jsonValues:extract-entry"), z.literal("view:check-module")]);
+var ValidationFixZ = z.union([z.literal("image:add-metadata"), z.literal("image:check-metadata"), z.literal("image:check-remote"), z.literal("image:upload-remote"), z.literal("image:download-remote"), z.literal("images:check-remote"), z.literal("images:upload-remote"), z.literal("file:add-metadata"), z.literal("video:add-metadata"), z.literal("video:upload-remote"), z.literal("video:download-remote"), z.literal("videos:add-metadata"), z.literal("videos:check-remote"), z.literal("videos:upload-remote"), z.literal("file:check-metadata"), z.literal("file:check-remote"), z.literal("file:upload-remote"), z.literal("file:download-remote"), z.literal("files:check-remote"), z.literal("files:upload-remote"), z.literal("keyof:check-keys"), z.literal("router:check-route"), z.literal("locale:check-locale"), z.literal("record:fill-keys"), z.literal("images:check-unique-folder"), z.literal("files:check-unique-folder"), z.literal("images:check-all-files"), z.literal("files:check-all-files"), z.literal("videos:check-unique-folder"), z.literal("videos:check-all-files"), z.literal("jsonValues:extract-entry"), z.literal("view:check-module")]);
 var ValidationError = z.object({
   message: z.string(),
   value: z.unknown().optional(),
@@ -3187,11 +3213,23 @@ var Api = {
             return arg[0];
           }).optional(),
           remote: onlyOneStringQueryParam.optional()
+        },
+        // A `<video>` seeks with byte ranges, Safari will not play one from a
+        // server that ignores them, and HLS segments that are byte ranges of
+        // one file are fetched no other way.
+        headers: {
+          range: z.string().optional()
         }
       },
       res: z.union([unauthorizedResponse, notFoundResponse, z.object({
         status: z.literal(200),
         body: z["instanceof"](ReadableStream)
+      }), z.object({
+        status: z.literal(206),
+        body: z["instanceof"](ReadableStream)
+      }), z.object({
+        status: z.literal(416),
+        json: GenericError
       })])
     }
   },
@@ -5315,7 +5353,7 @@ function emptyOf(schema, context) {
     // language nobody chose, which is the thing this whole feature exists to
     // make visible.
     return (_context$selectedLoca = context === null || context === void 0 ? void 0 : context.selectedLocale) !== null && _context$selectedLoca !== void 0 ? _context$selectedLoca : "";
-  } else if (schema.type === "file" || schema.type === "image") {
+  } else if (schema.type === "file" || schema.type === "image" || schema.type === "video") {
     return null; // returning null is the only thing we can do, however, it means that the patches cannot be applied yet since that might fail
   } else if (schema.type === "literal") {
     return schema.value;
@@ -5525,6 +5563,14 @@ function checkGallerySchema(moduleSchema) {
   if (moduleSchema.type === "record" && moduleSchema.mediaType === "images") {
     return null;
   }
+  if (moduleSchema.type === "record" && moduleSchema.mediaType === "videos") {
+    // Said outright rather than as "not an images gallery": a set of videos
+    // looks like a gallery from here, and the tool can do nothing with one.
+    return {
+      kind: "error",
+      message: "Module is a video set (s.videoset()), not an images gallery. Videos cannot be added or removed by this tool: upload them in Val Studio."
+    };
+  }
   if (moduleSchema.type === "image") {
     return {
       kind: "wrong-tool",
@@ -5619,17 +5665,32 @@ var GALLERY_REDIRECT = {
   reason: "Destination is a media gallery (s.imageset() / s.fileset()). Gallery entries are keyed by file path and carry a file on disk, so they cannot be created with a plain patch. Use add_session_image_to_gallery."
 };
 
-/** An `s.imageset()` / `s.fileset()` record: a gallery, not an ordinary record. */
+/**
+ * A video set's entries are keyed by a file too, and a stream's by a
+ * directory of them — and there is no tool to send them to: a video is
+ * uploaded (and, for a stream, transcoded) in the Studio.
+ */
+var VIDEOSET_REFUSAL = {
+  kind: "error",
+  message: "Destination is a video set (s.videoset()). Its entries are keyed by file path and carry video files, so they cannot be created with a plain patch, and no tool here uploads a video: add it in Val Studio."
+};
+
+/** An `s.imageset()` / `s.fileset()` / `s.videoset()` record: a gallery, not an ordinary record. */
 function isGallery(schema) {
   return schema.type === "record" && schema.mediaType !== undefined;
 }
+
+/** Where to send someone whose destination is (in) the gallery `schema`. */
+function galleryRedirect(schema) {
+  return schema.type === "record" && schema.mediaType === "videos" ? VIDEOSET_REFUSAL : GALLERY_REDIRECT;
+}
 function decideOp(moduleSchema, destinationPath) {
   // The DESTINATION itself, checked before its parent: `["gallery"]` resolves
   // its parent to the enclosing object and would otherwise look like an
   // ordinary `replace` that overwrites a whole gallery.
   var destination = resolveSerializedSchemaAtPath(moduleSchema, destinationPath);
   if (destination.kind === "gallery-traversed") {
-    return GALLERY_REDIRECT;
+    return galleryRedirect(destination.schema);
   }
   if (destination.kind === "richtext") {
     return {
@@ -5640,7 +5701,7 @@ function decideOp(moduleSchema, destinationPath) {
   }
   if (destination.kind === "leaf") {
     if (isGallery(destination.schema)) {
-      return GALLERY_REDIRECT;
+      return galleryRedirect(destination.schema);
     }
     // A richtext value the path lands exactly ON resolves as a leaf, not as
     // `kind: "richtext"` (which only fires when the walk continues INTO it).
@@ -5677,7 +5738,7 @@ function decideOp(moduleSchema, destinationPath) {
   // destination is a gallery entry; `isGallery` catches the case where the
   // parent IS the gallery and the destination is a new entry key in it.
   if (parent.kind === "gallery-traversed" || isGallery(parent.schema)) {
-    return GALLERY_REDIRECT;
+    return galleryRedirect(parent.schema);
   }
   var schema = parent.schema;
   if (schema.type === "array" || schema.type === "record") {
@@ -5998,6 +6059,14 @@ function isSkippableFixCode(fix) {
     case "file:check-remote":
     case "files:check-remote":
     case "files:upload-remote":
+    case "video:add-metadata": // the Studio writes it on upload; --fix for the rest
+    case "video:upload-remote":
+    case "video:download-remote":
+    case "videos:add-metadata": // as `video:add-metadata`, for a set's entry
+    case "videos:check-remote":
+    case "videos:upload-remote":
+    case "videos:check-unique-folder":
+    case "videos:check-all-files":
     case "images:check-unique-folder":
     case "files:check-unique-folder":
     case "images:check-all-files":
@@ -6322,8 +6391,8 @@ function traverseSchemaSource(source, schema, path, callback) {
     return;
   }
 
-  // Handle file/image
-  if (schema.type === "file" || schema.type === "image") {
+  // Handle file/image/video
+  if (schema.type === "file" || schema.type === "image" || schema.type === "video") {
     if (source && _typeof(source) === "object" && "path" in source && typeof source.path === "string") {
       callback({
         source: source,
@@ -6670,8 +6739,8 @@ function indexModule(searchIndex, moduleFilePath, source, schema) {
       // Use first 50 chars as label
       label = searchText.substring(0, 50) || "richtext";
     }
-    // Handle file/image
-    else if (schema.type === "file" || schema.type === "image") {
+    // Handle file/image/video
+    else if (schema.type === "file" || schema.type === "image" || schema.type === "video") {
       if (source !== null && _typeof(source) === "object" && "path" in source && typeof source.path === "string") {
         // The label is the bare filename - the folder is shown separately in
         // the UI - but both are searchable.
@@ -7761,4 +7830,4 @@ function parse(schema, body, call) {
   return parsed.data;
 }
 
-export { AA_LARGE, AA_TEXT, Api, BRAND_CONTRAST_PAIRS, BinaryFileRef, CodeOptions, ColorOptions, DEFAULT_ERROR_MESSAGE, DateOptions, ENCODE_DEFAULTS, ENCODE_MIME_TYPE_OF, FileOptions, HistoricalCommit, HistoricalModule, HistoricalPatchSet, HistoryError, ImageEncodeOption, ImageOptions, JSONValue, JSON_ENTRIES_BATCH_MAX, ModuleComparison, NEVER_ENCODED, ParentRef$1 as ParentRef, Patch, PatchBlock, PatchGroup, PatchId, PatchJSON, PublishProtocolError, RAMP_STEPS, RemirrorBr, RemirrorBulletList, RemirrorHeading, RemirrorImage, RemirrorJSON, RemirrorLinkMark, RemirrorListItem, RemirrorOrderedList, RemirrorParagraph, RemirrorText, RemirrorTextMark, RestoreVerdict, RichTextOptions, SCHEMA_SOURCE_FIXES, SerializedArraySchema, SerializedBooleanSchema, SerializedCodeSchema, SerializedColorSchema, SerializedDateSchema, SerializedDateTimeSchema, SerializedDiscriminatedUnionSchema, SerializedEnumSchema, SerializedFileSchema, SerializedImageSchema, SerializedKeyOfSchema, SerializedLiteralSchema, SerializedLocaleSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedRecordSchema, SerializedRichTextSchema, SerializedRouteSchema, SerializedSchema, SerializedSettingsSchema, SerializedStringSchema, SerializedValViewSchema, SharedValConfig, VAL_ENABLE_COOKIE_NAME, VAL_GREEN_RAMP, VAL_SESSION_COOKIE, VAL_STATE_COOKIE, VAL_STUDIO_HEADER, ValCommit, ValDeployment, accentRamp, buildDuplicatePatch, buildEmptyAtPathPatch, buildFileRefValue, buildImageGalleryPatch, buildRemoveImageGalleryEntryPatch, buildSearchIndex, chainHeadOf, checkCompatibility, chooseEncoded, concatModulePath, contrastRatio, createRegExpFromPattern, createSearchIndex, createValClient, declaredLocales, describeContainerAtPath, emptyOf, explainIncompatible, filterBlockingValidationErrors, filterRoutesByPatterns, findSimilar, fitWithin, flattenRichText, getErrorMessageFromUnknownJson, getFilenameFromRef, getInlineImgInfo, getKeyOfRecordAt, getRefParts, getRoutesOf, getRoutesWithModulePaths, getSourceAt, indexModule, isMimeTypeAccepted, isRemoteSchema, isSchemaSourceFixError, isSkippedSource, keyOfRecordPath, levenshtein, localeAt, memoizePerRequest, newestCommitSha, parseArtifacts, parseBuildTarget, parseCancel, parseDeclare, parseDiscard, parseJob, parseNewestCiRun, parsePress, parseProblems, parseProjectSource, parsePromote, parsePublishToken, parseRenew, parseRequestStatus, parseStatus, parseUpdateTarget, parseVerify, partitionValidationErrors, performSearch, relativeLuminance, remirrorToRichTextSource, removeModule, resolveEncodeSettings, resolvePairGround, resolveSchemaSourceFixForError, resolveSchemaSourceFixes, resolveSerializedSchemaAtPath, richTextToRemirror, safeParsePatch, sourcePathOfChild, themeCustomProperties, toolNames, traverseSchemaSource, urlOf, validateRoutePatterns, withExtension };
+export { AA_LARGE, AA_TEXT, Api, BRAND_CONTRAST_PAIRS, BinaryFileRef, CodeOptions, ColorOptions, DEFAULT_ERROR_MESSAGE, DateOptions, ENCODE_DEFAULTS, ENCODE_MIME_TYPE_OF, FileOptions, HistoricalCommit, HistoricalModule, HistoricalPatchSet, HistoryError, ImageEncodeOption, ImageOptions, JSONValue, JSON_ENTRIES_BATCH_MAX, ModuleComparison, NEVER_ENCODED, ParentRef$1 as ParentRef, Patch, PatchBlock, PatchGroup, PatchId, PatchJSON, PublishProtocolError, RAMP_STEPS, RemirrorBr, RemirrorBulletList, RemirrorHeading, RemirrorImage, RemirrorJSON, RemirrorLinkMark, RemirrorListItem, RemirrorOrderedList, RemirrorParagraph, RemirrorText, RemirrorTextMark, RestoreVerdict, RichTextOptions, SCHEMA_SOURCE_FIXES, SerializedArraySchema, SerializedBooleanSchema, SerializedCodeSchema, SerializedColorSchema, SerializedDateSchema, SerializedDateTimeSchema, SerializedDiscriminatedUnionSchema, SerializedEnumSchema, SerializedFileSchema, SerializedImageSchema, SerializedKeyOfSchema, SerializedLiteralSchema, SerializedLocaleSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedRecordSchema, SerializedRichTextSchema, SerializedRouteSchema, SerializedSchema, SerializedSettingsSchema, SerializedStringSchema, SerializedValViewSchema, SerializedVideoSchema, SharedValConfig, VAL_ENABLE_COOKIE_NAME, VAL_GREEN_RAMP, VAL_SESSION_COOKIE, VAL_STATE_COOKIE, VAL_STUDIO_HEADER, ValCommit, ValDeployment, VideoOptions, VideoStreamOption, accentRamp, buildDuplicatePatch, buildEmptyAtPathPatch, buildFileRefValue, buildImageGalleryPatch, buildRemoveImageGalleryEntryPatch, buildSearchIndex, chainHeadOf, checkCompatibility, chooseEncoded, concatModulePath, contrastRatio, createRegExpFromPattern, createSearchIndex, createValClient, declaredLocales, describeContainerAtPath, emptyOf, explainIncompatible, filterBlockingValidationErrors, filterRoutesByPatterns, findSimilar, fitWithin, flattenRichText, getErrorMessageFromUnknownJson, getFilenameFromRef, getInlineImgInfo, getKeyOfRecordAt, getRefParts, getRoutesOf, getRoutesWithModulePaths, getSourceAt, indexModule, isMimeTypeAccepted, isRemoteSchema, isSchemaSourceFixError, isSkippedSource, keyOfRecordPath, levenshtein, localeAt, memoizePerRequest, newestCommitSha, parseArtifacts, parseBuildTarget, parseCancel, parseDeclare, parseDiscard, parseJob, parseNewestCiRun, parsePress, parseProblems, parseProjectSource, parsePromote, parsePublishToken, parseRenew, parseRequestStatus, parseStatus, parseUpdateTarget, parseVerify, partitionValidationErrors, performSearch, relativeLuminance, remirrorToRichTextSource, removeModule, resolveEncodeSettings, resolvePairGround, resolveSchemaSourceFixForError, resolveSchemaSourceFixes, resolveSerializedSchemaAtPath, richTextToRemirror, safeParsePatch, sourcePathOfChild, themeCustomProperties, toolNames, traverseSchemaSource, urlOf, validateRoutePatterns, withExtension };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valbuild/shared",
-  "version": "0.140.2",
+  "version": "0.141.0",
   "private": false,
   "description": "Val shared types and utilities",
   "repository": {
@@ -37,7 +37,7 @@
     "flexsearch": "^0.8.212",
     "zod": "^4.4.3",
     "zod-validation-error": "^5.0.0",
-    "@valbuild/core": "0.139.1"
+    "@valbuild/core": "0.141.0"
   },
   "files": [
     "CHANGELOG.md",