@valbuild/shared 0.140.2 → 0.142.0

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(),
@@ -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;