@valbuild/shared 0.140.2 → 0.142.0

package/dist/declarations/src/internal/server/types.d.ts

@@ -1,7 +1,7 @@
 import { Json } from "@valbuild/core";
-export declare const VAL_SESSION_COOKIE: "val_session";
-export declare const VAL_STATE_COOKIE: "val_state";
-export declare const VAL_ENABLE_COOKIE_NAME: "val_enable";
+export declare const VAL_SESSION_COOKIE: any;
+export declare const VAL_STATE_COOKIE: any;
+export declare const VAL_ENABLE_COOKIE_NAME: any;
 export type VAL_SESSION_COOKIE = typeof VAL_SESSION_COOKIE;
 export type VAL_STATE_COOKIE = typeof VAL_STATE_COOKIE;
 export type VAL_ENABLE_COOKIE_NAME = typeof VAL_ENABLE_COOKIE_NAME;

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

@@ -64,9 +64,9 @@ export declare const BinaryFileRef: z.ZodObject<{
 }, z.core.$strip>;
 export type BinaryFileRef = z.infer<typeof BinaryFileRef>;
 export declare const HistoricalModule: z.ZodObject<{
-    source: z.ZodNullable<z.ZodType<import("@valbuild/core/patch").JSONValue, unknown, z.core.$ZodTypeInternals<import("@valbuild/core/patch").JSONValue, unknown>>>;
-    schema: z.ZodNullable<z.ZodType<import("@valbuild/core").SerializedSchema, unknown, z.core.$ZodTypeInternals<import("@valbuild/core").SerializedSchema, unknown>>>;
-    patchIds: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
+    source: z.ZodNullable<z.ZodType<JSONValueT, unknown, z.core.$ZodTypeInternals<JSONValueT, unknown>>>;
+    schema: z.ZodNullable<z.ZodType<SerializedSchemaT, unknown, z.core.$ZodTypeInternals<SerializedSchemaT, unknown>>>;
+    patchIds: z.ZodArray<z.ZodString & z.ZodType<PatchIdT, string, z.core.$ZodTypeInternals<PatchIdT, string>>>;
     changedPaths: z.ZodArray<z.ZodString>;
     failures: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"commit-not-found">;
@@ -109,9 +109,9 @@ export declare const HistoricalPatchSet: z.ZodObject<{
         hasArchive: z.ZodBoolean;
     }, z.core.$strip>;
     modules: z.ZodRecord<z.ZodString, z.ZodObject<{
-        source: z.ZodNullable<z.ZodType<import("@valbuild/core/patch").JSONValue, unknown, z.core.$ZodTypeInternals<import("@valbuild/core/patch").JSONValue, unknown>>>;
-        schema: z.ZodNullable<z.ZodType<import("@valbuild/core").SerializedSchema, unknown, z.core.$ZodTypeInternals<import("@valbuild/core").SerializedSchema, unknown>>>;
-        patchIds: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
+        source: z.ZodNullable<z.ZodType<JSONValueT, unknown, z.core.$ZodTypeInternals<JSONValueT, unknown>>>;
+        schema: z.ZodNullable<z.ZodType<SerializedSchemaT, unknown, z.core.$ZodTypeInternals<SerializedSchemaT, unknown>>>;
+        patchIds: z.ZodArray<z.ZodString & z.ZodType<PatchIdT, string, z.core.$ZodTypeInternals<PatchIdT, string>>>;
         changedPaths: z.ZodArray<z.ZodString>;
         failures: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"commit-not-found">;
@@ -139,7 +139,7 @@ export declare const HistoricalPatchSet: z.ZodObject<{
         }, z.core.$strip>], "kind">>;
     }, z.core.$strip>>;
     patches: z.ZodArray<z.ZodObject<{
-        patchId: z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>;
+        patchId: z.ZodString & z.ZodType<PatchIdT, string, z.core.$ZodTypeInternals<PatchIdT, string>>;
         moduleFilePath: z.ZodString;
         patch: z.ZodUnknown;
         authorId: z.ZodNullable<z.ZodString>;

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

@@ -1,5 +1,4 @@
 import type { JSONValue as JSONValueT, PatchJSON as PatchJSONT, PatchBlock as PatchBlockT, ParentRef as ParentRefT } from "@valbuild/core/patch";
-import type { PatchId as PatchIdT } from "@valbuild/core";
 import { z } from "zod";
 /**
  * JSON, recursively — the shape of a Source over the wire.

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>;
@@ -51,25 +66,7 @@ export declare const ColorOptions: z.ZodObject<{
 export declare const SerializedColorSchema: z.ZodType<SerializedColorSchemaT>;
 export declare const CodeOptions: z.ZodObject<{
     language: z.ZodOptional<z.ZodEnum<{
-        json: "json";
-        typescript: "typescript";
-        javascript: "javascript";
-        javascriptreact: "javascriptreact";
-        typescriptreact: "typescriptreact";
-        java: "java";
-        html: "html";
-        css: "css";
-        xml: "xml";
-        markdown: "markdown";
-        sql: "sql";
-        python: "python";
-        rust: "rust";
-        php: "php";
-        go: "go";
-        cpp: "cpp";
-        sass: "sass";
-        vue: "vue";
-        angular: "angular";
+        [x: string]: any;
     }>>;
 }, z.core.$strip>;
 export declare const SerializedCodeSchema: z.ZodType<SerializedCodeSchemaT>;
@@ -86,7 +83,7 @@ export declare const SerializedSettingsSchema: z.ZodType<SerializedSettingsSchem
  */
 export declare const SerializedValViewSchema: z.ZodObject<{
     type: z.ZodLiteral<"view">;
-    moduleFilePath: z.ZodType<import("@valbuild/core").ModuleFilePath, unknown, z.core.$ZodTypeInternals<import("@valbuild/core").ModuleFilePath, unknown>>;
+    moduleFilePath: z.ZodType<ModuleFilePathT, unknown, z.core.$ZodTypeInternals<ModuleFilePathT, unknown>>;
     opt: z.ZodLiteral<false>;
     readonly: z.ZodOptional<z.ZodBoolean>;
     hidden: z.ZodOptional<z.ZodBoolean>;

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(),
@@ -1576,6 +1602,14 @@ var PublishRefusal = zod.z.object({
   message: zod.z.string()
 });
 
+/** See `proposal` on `/stat`. */
+var StatProposal = zod.z.object({
+  /** Twenty hex characters, the hash of what it was made from. */
+  name: zod.z.string(),
+  /** `val/p/<name>`. */
+  branch: zod.z.string()
+});
+
 /**
  * A patch group: the set of patches one user has chosen to publish.
  *
@@ -2006,7 +2040,13 @@ var Api = {
            * connected ones by commit.
            */
           publishJobs: zod.z["boolean"]().optional(),
-          publishRefusal: PublishRefusal.optional()
+          publishRefusal: PublishRefusal.optional(),
+          /**
+           * The proposal this server runs at the address of, or absent
+           * on the site. What the Studio's switcher says it is in, and
+           * where its Save goes (valbuild/home `docs/proposals.md`).
+           */
+          proposal: StatProposal.optional()
         }), zod.z.object({
           type: zod.z.literal("use-websocket"),
           url: zod.z.string(),
@@ -2124,7 +2164,13 @@ var Api = {
            * connected ones by commit.
            */
           publishJobs: zod.z["boolean"]().optional(),
-          publishRefusal: PublishRefusal.optional()
+          publishRefusal: PublishRefusal.optional(),
+          /**
+           * The proposal this server runs at the address of, or absent
+           * on the site. What the Studio's switcher says it is in, and
+           * where its Save goes (valbuild/home `docs/proposals.md`).
+           */
+          proposal: StatProposal.optional()
         })])
       })])
     }
@@ -2210,6 +2256,60 @@ var Api = {
       })
     }
   },
+  /**
+   * The content service's proposals API, reached through this deployment:
+   * list, open, read, rename, close, reopen and retry a setup
+   * (valbuild/home `docs/proposals.md`, Flow B).
+   *
+   * The same arrangement as `/publish-api`, for the same reasons: the browser
+   * holds a session for this origin and no credential content accepts, so
+   * this server checks the session, sends the project's key with the person's
+   * profile id beside it -- a proposal is opened, renamed and closed by
+   * somebody -- and carries content's status and body back unread. The sub-path
+   * is content's, after `/proposals`; `ValOpsHttp.proposalsApi` holds the
+   * allow list. A save is not here: it is `/save`, which a proposal's server
+   * sends to the proposal's own route.
+   */
+  "/proposals-api": {
+    GET: {
+      req: {
+        path: zod.z.string().optional(),
+        cookies: {
+          val_session: zod.z.string().optional()
+        }
+      },
+      res: zod.z.object({
+        status: zod.z.number(),
+        json: zod.z.unknown()
+      })
+    },
+    POST: {
+      req: {
+        path: zod.z.string().optional(),
+        body: zod.z.unknown().optional(),
+        cookies: {
+          val_session: zod.z.string().optional()
+        }
+      },
+      res: zod.z.object({
+        status: zod.z.number(),
+        json: zod.z.unknown()
+      })
+    },
+    PATCH: {
+      req: {
+        path: zod.z.string().optional(),
+        body: zod.z.unknown().optional(),
+        cookies: {
+          val_session: zod.z.string().optional()
+        }
+      },
+      res: zod.z.object({
+        status: zod.z.number(),
+        json: zod.z.unknown()
+      })
+    }
+  },
   "/upload/patches": {
     POST: {
       req: {
@@ -2739,6 +2839,32 @@ var Api = {
       })])
     }
   },
+  /**
+   * In a proposal: the SITE's Source for every module the proposal has saved,
+   * as the build it is based on has it. What Compare with the site diffs the
+   * proposal against -- saved and unsaved alike -- because the Studio's own
+   * base Source there is the proposal's last save. 404 anywhere that is not a
+   * proposal's address. valbuild/home `docs/proposals.md`.
+   */
+  "/proposal-site-sources": {
+    GET: {
+      req: {
+        cookies: {
+          val_session: zod.z.string().optional()
+        }
+      },
+      res: zod.z.union([unauthorizedResponse, zod.z.object({
+        status: zod.z.literal(404),
+        json: GenericError
+      }), zod.z.object({
+        status: zod.z.literal(200),
+        json: zod.z.object({
+          /** By module file path. A module absent here is the same in both. */
+          modules: zod.z.record(zod.z.string(), zod.z.unknown())
+        })
+      })])
+    }
+  },
   "/profiles": {
     GET: {
       req: {
@@ -3194,11 +3320,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 +5460,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 +5670,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 +5772,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 +5808,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 +5845,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 +6166,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 +6498,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 +6846,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 +8021,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 +8030,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;