@riverbankcms/sdk 0.90.1 → 0.91.0

package/dist/cli/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import z42, { z, ZodError } from 'zod';
+import z41, { z } from 'zod';
 import 'react/jsx-runtime';
 import { createJiti } from 'jiti';
 import * as fs11 from 'fs';
@@ -229,11 +229,11 @@ function isValidTimeZone(timeZone) {
 }
 function getSafeTimeZone(timeZone) {
   const normalized = typeof timeZone === "string" ? timeZone.trim() : "";
-  return normalized && isValidTimeZone(normalized) ? normalized : FALLBACK_TIMEZONE;
+  return normalized.length > 0 && isValidTimeZone(normalized) ? normalized : FALLBACK_TIMEZONE;
 }
 function parseStrictBookingTimeZone(timeZone) {
   const normalized = timeZone.trim();
-  if (!normalized || !isValidTimeZone(normalized)) {
+  if (normalized.length === 0 || !isValidTimeZone(normalized)) {
     return null;
   }
   return normalized;
@@ -307,7 +307,7 @@ function parseScheduledBookingDateTime(input) {
   try {
     const startsAt = toUtcIsoDateTimeString(input.startsAt);
     const timeZone = parseStrictBookingTimeZone(input.timeZone);
-    if (!timeZone) {
+    if (timeZone === null) {
       return {
         ok: false,
         field: "timeZone",
@@ -373,10 +373,10 @@ function normalizeLocationAddressText(value) {
     return null;
   }
   const trimmed = value.trim();
-  return trimmed ? trimmed : null;
+  return trimmed.length > 0 ? trimmed : null;
 }
 function hasLocationCoordinates(value) {
-  return typeof value?.lat === "number" && typeof value?.lng === "number";
+  return value != null && typeof value.lat === "number" && typeof value.lng === "number";
 }
 function toLocationCoordinates(value) {
   if (!hasLocationCoordinates(value)) {
@@ -392,6 +392,18 @@ var init_location = __esm({
   }
 });
 
+// ../core/src/string.ts
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.length > 0;
+}
+function hasText(value) {
+  return isNonEmptyString(value);
+}
+var init_string = __esm({
+  "../core/src/string.ts"() {
+  }
+});
+
 // ../core/src/business-address.ts
 var init_business_address = __esm({
   "../core/src/business-address.ts"() {
@@ -512,12 +524,6 @@ var init_slug = __esm({
   }
 });
 
-// ../core/src/string.ts
-var init_string = __esm({
-  "../core/src/string.ts"() {
-  }
-});
-
 // ../core/src/uuid.ts
 var init_uuid = __esm({
   "../core/src/uuid.ts"() {
@@ -4894,44 +4900,44 @@ var init_styleTags = __esm({
 var hotspotSchema, rotationSchema, rectSchema, aspectCropSchema, transformSchema, mediaSchema;
 var init_media = __esm({
   "../theme-core/src/lib/media.ts"() {
-    hotspotSchema = z42.object({
-      x: z42.number().min(0).max(1),
-      y: z42.number().min(0).max(1),
-      radius: z42.number().optional()
+    hotspotSchema = z41.object({
+      x: z41.number().min(0).max(1),
+      y: z41.number().min(0).max(1),
+      radius: z41.number().optional()
     });
-    rotationSchema = z42.union([z42.literal(0), z42.literal(90), z42.literal(180), z42.literal(270)]);
-    rectSchema = z42.tuple([z42.number(), z42.number(), z42.number(), z42.number()]);
-    aspectCropSchema = z42.object({
-      aspect: z42.preprocess((value) => value == null ? void 0 : value, z42.string().optional()),
-      rect: z42.preprocess((value) => value == null ? void 0 : value, rectSchema.optional()),
-      hotspot: z42.preprocess((value) => value == null ? void 0 : value, hotspotSchema.optional()),
-      rotation: z42.preprocess((value) => value == null ? void 0 : value, rotationSchema.optional())
+    rotationSchema = z41.union([z41.literal(0), z41.literal(90), z41.literal(180), z41.literal(270)]);
+    rectSchema = z41.tuple([z41.number(), z41.number(), z41.number(), z41.number()]);
+    aspectCropSchema = z41.object({
+      aspect: z41.preprocess((value) => value == null ? void 0 : value, z41.string().optional()),
+      rect: z41.preprocess((value) => value == null ? void 0 : value, rectSchema.optional()),
+      hotspot: z41.preprocess((value) => value == null ? void 0 : value, hotspotSchema.optional()),
+      rotation: z41.preprocess((value) => value == null ? void 0 : value, rotationSchema.optional())
     });
-    transformSchema = z42.object({
-      aspectCrops: z42.preprocess((value) => {
+    transformSchema = z41.object({
+      aspectCrops: z41.preprocess((value) => {
         if (!value || typeof value !== "object" || Array.isArray(value)) {
           return void 0;
         }
         return value;
-      }, z42.record(z42.string(), aspectCropSchema.catch({}))).optional(),
+      }, z41.record(z41.string(), aspectCropSchema.catch({}))).optional(),
       rect: rectSchema.optional(),
       hotspot: hotspotSchema.optional(),
       rotation: rotationSchema.optional()
     });
-    mediaSchema = z42.object({
-      type: z42.enum(["image", "video", "audio", "document", "spreadsheet", "archive"]),
-      purpose: z42.string().optional(),
-      placeholder: z42.boolean().default(true).optional(),
-      assetId: z42.string().optional(),
-      identifier: z42.string().optional(),
-      src: z42.string().optional(),
-      alt: z42.string().optional(),
-      filename: z42.string().optional(),
-      mimeType: z42.string().optional(),
-      width: z42.number().optional(),
-      height: z42.number().optional(),
-      storageBucket: z42.string().optional(),
-      storagePath: z42.string().optional(),
+    mediaSchema = z41.object({
+      type: z41.enum(["image", "video", "audio", "document", "spreadsheet", "archive"]),
+      purpose: z41.string().optional(),
+      placeholder: z41.boolean().default(true).optional(),
+      assetId: z41.string().optional(),
+      identifier: z41.string().optional(),
+      src: z41.string().optional(),
+      alt: z41.string().optional(),
+      filename: z41.string().optional(),
+      mimeType: z41.string().optional(),
+      width: z41.number().optional(),
+      height: z41.number().optional(),
+      storageBucket: z41.string().optional(),
+      storagePath: z41.string().optional(),
       transform: transformSchema.optional()
     });
   }
@@ -18545,66 +18551,66 @@ var init_media2 = __esm({
       "archive",
       "audio"
     ];
-    hotspotSchema2 = z42.object({
-      x: z42.number().min(0).max(1),
-      y: z42.number().min(0).max(1),
-      radius: z42.number().optional()
+    hotspotSchema2 = z41.object({
+      x: z41.number().min(0).max(1),
+      y: z41.number().min(0).max(1),
+      radius: z41.number().optional()
     });
-    rotationSchema2 = z42.union([z42.literal(0), z42.literal(90), z42.literal(180), z42.literal(270)]);
-    rectSchema2 = z42.tuple([z42.number(), z42.number(), z42.number(), z42.number()]);
-    aspectCropSchema2 = z42.object({
-      aspect: z42.preprocess((value) => value == null ? void 0 : value, z42.string().optional()),
-      rect: z42.preprocess((value) => value == null ? void 0 : value, rectSchema2.optional()),
-      hotspot: z42.preprocess((value) => value == null ? void 0 : value, hotspotSchema2.optional()),
-      rotation: z42.preprocess((value) => value == null ? void 0 : value, rotationSchema2.optional())
+    rotationSchema2 = z41.union([z41.literal(0), z41.literal(90), z41.literal(180), z41.literal(270)]);
+    rectSchema2 = z41.tuple([z41.number(), z41.number(), z41.number(), z41.number()]);
+    aspectCropSchema2 = z41.object({
+      aspect: z41.preprocess((value) => value == null ? void 0 : value, z41.string().optional()),
+      rect: z41.preprocess((value) => value == null ? void 0 : value, rectSchema2.optional()),
+      hotspot: z41.preprocess((value) => value == null ? void 0 : value, hotspotSchema2.optional()),
+      rotation: z41.preprocess((value) => value == null ? void 0 : value, rotationSchema2.optional())
     });
-    transformSchema2 = z42.object({
-      aspectCrops: z42.preprocess((value) => {
+    transformSchema2 = z41.object({
+      aspectCrops: z41.preprocess((value) => {
         if (!value || typeof value !== "object" || Array.isArray(value)) {
           return void 0;
         }
         return value;
-      }, z42.record(z42.string(), aspectCropSchema2.catch({}))).optional(),
+      }, z41.record(z41.string(), aspectCropSchema2.catch({}))).optional(),
       rect: rectSchema2.optional(),
       hotspot: hotspotSchema2.optional(),
       rotation: rotationSchema2.optional()
     });
-    mediaPosterSchema = z42.discriminatedUnion("tag", [
-      z42.object({
-        tag: z42.literal("storage"),
-        assetId: z42.string().optional(),
-        storageBucket: z42.string().min(1),
-        storagePath: z42.string().min(1)
+    mediaPosterSchema = z41.discriminatedUnion("tag", [
+      z41.object({
+        tag: z41.literal("storage"),
+        assetId: z41.string().optional(),
+        storageBucket: z41.string().min(1),
+        storagePath: z41.string().min(1)
       }),
-      z42.object({
-        tag: z42.literal("external-src"),
-        assetId: z42.string().optional(),
-        src: z42.string().url()
+      z41.object({
+        tag: z41.literal("external-src"),
+        assetId: z41.string().optional(),
+        src: z41.string().url()
       })
     ]);
-    mediaBaseSchema = z42.object({
-      purpose: z42.string().optional(),
-      placeholder: z42.boolean().default(true).optional(),
-      assetId: z42.string().optional(),
-      identifier: z42.string().optional(),
-      src: z42.string().optional(),
-      alt: z42.string().optional(),
-      filename: z42.string().optional(),
-      mimeType: z42.string().optional(),
-      width: z42.number().optional(),
-      height: z42.number().optional(),
-      storageBucket: z42.string().optional(),
-      storagePath: z42.string().optional(),
+    mediaBaseSchema = z41.object({
+      purpose: z41.string().optional(),
+      placeholder: z41.boolean().default(true).optional(),
+      assetId: z41.string().optional(),
+      identifier: z41.string().optional(),
+      src: z41.string().optional(),
+      alt: z41.string().optional(),
+      filename: z41.string().optional(),
+      mimeType: z41.string().optional(),
+      width: z41.number().optional(),
+      height: z41.number().optional(),
+      storageBucket: z41.string().optional(),
+      storagePath: z41.string().optional(),
       poster: mediaPosterSchema.optional(),
       transform: transformSchema2.optional()
     });
-    imageMediaSchema = mediaBaseSchema.extend({ type: z42.literal("image") });
-    videoMediaSchema = mediaBaseSchema.extend({ type: z42.literal("video") });
-    audioMediaSchema = mediaBaseSchema.extend({ type: z42.literal("audio") });
-    documentMediaSchema = mediaBaseSchema.extend({ type: z42.literal("document") });
-    spreadsheetMediaSchema = mediaBaseSchema.extend({ type: z42.literal("spreadsheet") });
-    archiveMediaSchema = mediaBaseSchema.extend({ type: z42.literal("archive") });
-    mediaSchema2 = z42.discriminatedUnion("type", [
+    imageMediaSchema = mediaBaseSchema.extend({ type: z41.literal("image") });
+    videoMediaSchema = mediaBaseSchema.extend({ type: z41.literal("video") });
+    audioMediaSchema = mediaBaseSchema.extend({ type: z41.literal("audio") });
+    documentMediaSchema = mediaBaseSchema.extend({ type: z41.literal("document") });
+    spreadsheetMediaSchema = mediaBaseSchema.extend({ type: z41.literal("spreadsheet") });
+    archiveMediaSchema = mediaBaseSchema.extend({ type: z41.literal("archive") });
+    mediaSchema2 = z41.discriminatedUnion("type", [
       imageMediaSchema,
       videoMediaSchema,
       audioMediaSchema,
@@ -29017,12 +29023,16 @@ function validationContext(options = {}) {
     allowIncomplete: isDraft || (options.allowIncomplete ?? false)
   };
 }
+function strictValidationContext(options = {}) {
+  const ctx = validationContext(options);
+  return {
+    ...ctx,
+    allowNull: options.allowNull ?? false
+  };
+}
 function formatFieldPath(path28) {
   return path28.map((segment) => String(segment)).join(".");
 }
-function toZodIssuePath(path28) {
-  return [...path28];
-}
 function fieldIssueToMessage(issue5) {
   switch (issue5.kind) {
     case "required":
@@ -29259,70 +29269,10 @@ function resolveSelectConstraintSource(field) {
       return assertNever2(source);
   }
 }
-function normalizeStoredContentValues(plans, content, options = {}) {
-  if (!content || typeof content !== "object" || Array.isArray(content)) {
-    return {};
-  }
-  const planMap = new Map(plans.map((plan) => [plan.fieldId, plan]));
-  const normalized = {};
-  const ctx = validationContext(options);
-  for (const [key, value] of Object.entries(content)) {
-    const plan = planMap.get(key);
-    normalized[key] = plan ? normalizeStoredFieldValueWithContext(plan, value, ctx) : value;
-  }
-  return normalized;
-}
-function normalizeStoredFieldValueWithContext(plan, value, ctx) {
-  if (value === null && !plan.required) {
-    return void 0;
-  }
-  switch (plan.kind) {
-    case "group":
-      return normalizeStoredObjectChildren(plan.children, value, childValidationContext(plan, ctx));
-    case "repeater":
-      return normalizeStoredRepeaterItems(plan, value, ctx);
-    case "string":
-    case "number":
-    case "boolean":
-    case "richText":
-    case "media":
-    case "link":
-    case "select":
-    case "passthrough":
-      return normalizeFieldValue(plan, value, ctx);
-    default:
-      return assertNever2(plan);
-  }
-}
-function normalizeStoredObjectChildren(children, value, ctx) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    return value;
-  }
-  const normalized = { ...value };
-  for (const child of children) {
-    normalized[child.fieldId] = normalizeStoredFieldValueWithContext(
-      child,
-      normalized[child.fieldId],
-      ctx
-    );
-  }
-  return normalized;
-}
-function normalizeStoredRepeaterItems(plan, value, ctx) {
-  if (!isUnknownArray(value)) {
-    return value;
-  }
-  return value.map((item) => {
-    if (!item || typeof item !== "object" || Array.isArray(item)) {
-      return item;
-    }
-    const itemRecord = item;
-    const fields3 = plan.repeatedItemVariants ? plan.repeatedItemVariants.find((variant) => variant.typeId === itemRecord._type)?.fields : plan.repeatedItemPlan;
-    if (!fields3) {
-      return item;
-    }
-    return normalizeStoredObjectChildren(fields3, itemRecord, ctx);
-  });
+function validateFieldValue(plan, value, options = {}) {
+  const ctx = strictValidationContext(options);
+  const normalized = normalizeFieldValue(plan, value, ctx);
+  return validateNormalizedFieldValue(plan, normalized, ctx);
 }
 function normalizeFieldValue(plan, value, ctx) {
   switch (plan.kind) {
@@ -29600,72 +29550,32 @@ function requiredIssue(plan, value) {
   if (Array.isArray(value)) return issue(plan, "required", { emptyOrigin: "array" });
   return issue(plan, "required");
 }
-function fieldPlanToZod(plan, options = {}) {
-  const ctx = validationContext(options);
-  return z.any().transform((value) => normalizeFieldValue(plan, value, ctx)).superRefine((value, zodCtx) => {
-    for (const validationIssue of validateNormalizedFieldValue(plan, value, ctx)) {
-      addFieldIssueToZodContext(zodCtx, validationIssue, plan.path);
-    }
-  });
+function validateManifestValues(fields3, values, options = {}) {
+  return deriveFieldValidationPlans(fields3).flatMap(
+    (plan) => validateFieldValue(plan, values[plan.fieldId], options)
+  );
 }
-function addFieldIssueToZodContext(zodCtx, validationIssue, rootPath) {
-  const message = fieldIssueToMessage(validationIssue);
-  const path28 = relativeZodIssuePath(validationIssue.path, rootPath);
-  const issuePath = path28.length > 0 ? { path: toZodIssuePath(path28) } : {};
-  switch (validationIssue.kind) {
-    case "required":
-      if (validationIssue.emptyOrigin) {
-        zodCtx.addIssue({
-          ...issuePath,
-          code: "too_small",
-          origin: validationIssue.emptyOrigin,
-          minimum: 1,
-          inclusive: true,
-          message
-        });
-        return;
-      }
-      zodCtx.addIssue({ ...issuePath, code: "invalid_type", expected: "nonoptional", message });
-      return;
-    case "tooLong":
-      zodCtx.addIssue({
-        ...issuePath,
-        code: "too_big",
-        origin: "string",
-        maximum: validationIssue.maximum,
-        inclusive: true,
-        message
-      });
-      return;
-    case "invalidOption":
-      zodCtx.addIssue({ ...issuePath, code: "invalid_value", values: [], message });
-      return;
-    case "wrongType":
-    case "invalidEmail":
-    case "invalidPhone":
-    case "invalidPattern":
-    case "invalidUrl":
-    case "invalidDate":
-    case "invalidTime":
-    case "invalidDateTime":
-    case "invalidNumber":
-    case "tooSmall":
-    case "tooLarge":
-    case "invalidSlug":
-    case "tooFewItems":
-    case "tooManyItems":
-    case "invalidRichText":
-    case "invalidMedia":
-    case "invalidLink":
-    case "invalidReference":
-      zodCtx.addIssue({ ...issuePath, code: "custom", message });
-      return;
-    default:
-      assertNever2(validationIssue);
-  }
+function validateManifestContentForPush(fields3, values, options = {}) {
+  const issues = validateManifestValues(fields3, values, options).map(toManifestContentValidationIssue);
+  return issues.length === 0 ? { kind: "valid", issues: [] } : { kind: "invalid", issues };
+}
+function isTopLevelRequiredManifestContentIssue(issue5) {
+  return issue5.requiredScope === "topLevel";
 }
-function relativeZodIssuePath(path28, rootPath) {
-  return startsWithFieldPath(path28, rootPath) ? path28.slice(rootPath.length) : path28;
+function formatManifestContentValidationIssue(issue5) {
+  return `Invalid content${issue5.field ? ` in "${issue5.field}"` : ""}: ${issue5.message}`;
+}
+function toManifestContentValidationIssue(issue5) {
+  return {
+    kind: issue5.kind,
+    field: formatFieldPath(issue5.path),
+    message: fieldIssueToMessage(issue5),
+    requiredScope: requiredScopeForIssue(issue5)
+  };
+}
+function requiredScopeForIssue(issue5) {
+  if (issue5.kind !== "required") return null;
+  return issue5.path.length === 1 ? "topLevel" : "nested";
 }
 function compilePattern(pattern) {
   try {
@@ -29746,13 +29656,6 @@ function isValidSelectValue(value, values, multiple) {
   }
   return typeof value === "string" && values.includes(value);
 }
-function isEmptyValue(value) {
-  if (value === null || value === void 0) return true;
-  if (typeof value === "string" && value.trim() === "") return true;
-  if (Array.isArray(value) && value.length === 0) return true;
-  if (isEmptyRichTextDoc(value)) return true;
-  return false;
-}
 function isPlainObject(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
@@ -29763,16 +29666,6 @@ function isValidRichTextDoc(value) {
   const doc = richTextDoc(value);
   return Boolean(isPlainObject(doc) && doc.type === "doc");
 }
-function isEmptyRichTextDoc(value) {
-  const doc = richTextDoc(value);
-  if (!isPlainObject(doc)) return false;
-  if (doc.type !== "doc") return false;
-  const content = doc.content;
-  if (!Array.isArray(content) || content.length === 0) return true;
-  if (content.length !== 1) return false;
-  const first = content[0];
-  return first?.type === "paragraph" && (!Array.isArray(first.content) || first.content.length === 0);
-}
 function richTextDoc(value) {
   if (!isPlainObject(value)) return value;
   return isPlainObject(value.doc) ? value.doc : value;
@@ -29787,44 +29680,6 @@ function registerManifest(manifest) {
   manifestStore.set(manifest.name, manifest);
   return manifest;
 }
-function preprocessEmptyValues(content) {
-  if (!content || typeof content !== "object" || Array.isArray(content)) {
-    return {};
-  }
-  const result = {};
-  for (const [key, value] of Object.entries(content)) {
-    result[key] = isEmptyValue(value) ? void 0 : value;
-  }
-  return result;
-}
-function createManifestValidator(manifestOrFields, options = {}) {
-  const isDraft = options.mode === "draft";
-  const plans = derivePlansFromManifestOrFields(manifestOrFields);
-  const baseSchema = deriveContentZodFromPlans(plans, options);
-  if (isDraft) {
-    return z.preprocess(
-      (content) => preprocessEmptyValues(
-        normalizeStoredContentValues(plans, content, options)
-      ),
-      baseSchema
-    );
-  }
-  return z.preprocess(
-    (content) => normalizeStoredContentValues(plans, content, options),
-    baseSchema
-  );
-}
-function deriveContentZodFromPlans(plans, options) {
-  const shape = {};
-  for (const plan of plans) {
-    shape[plan.fieldId] = fieldPlanToZod(plan, options);
-  }
-  return z.object(shape).catchall(z.unknown()).passthrough();
-}
-function derivePlansFromManifestOrFields(manifestOrFields) {
-  const fields3 = Array.isArray(manifestOrFields) ? manifestOrFields : manifestOrFields.fields ?? [];
-  return deriveFieldValidationPlans(fields3);
-}
 
 // ../blocks/src/system/blocks/index.ts
 init_site_styles();
@@ -41542,11 +41397,11 @@ function extractRouteUpdatedAt(candidate) {
 }
 function resolveRouteTargetForStage(routeIdValue, routes, stageInput) {
   const routeId = typeof routeIdValue === "string" ? routeIdValue : null;
-  if (!routeId || !routes) return null;
+  if (routeId === null || routeId.length === 0 || routes === void 0) return null;
   const routeEntry = routes[routeId];
   if (!isRouteVisibleInStage(routeEntry, stageInput)) return null;
   const href = extractRouteHref(routeEntry, stageInput);
-  if (!href) return null;
+  if (href === null) return null;
   return {
     routeId,
     href,
@@ -48481,6 +48336,11 @@ var MIME_TYPES = {
   ".mp4": "video/mp4",
   ".webm": "video/webm",
   ".mov": "video/quicktime",
+  ".mp3": "audio/mpeg",
+  ".m4a": "audio/mp4",
+  ".wav": "audio/wav",
+  ".ogg": "audio/ogg",
+  ".flac": "audio/flac",
   ".pdf": "application/pdf"
 };
 var EXTENSIONS_BY_MIME = {
@@ -48494,6 +48354,13 @@ var EXTENSIONS_BY_MIME = {
   "video/mp4": ".mp4",
   "video/webm": ".webm",
   "video/quicktime": ".mov",
+  "audio/mpeg": ".mp3",
+  "audio/mp4": ".m4a",
+  "audio/wav": ".wav",
+  "audio/x-wav": ".wav",
+  "audio/ogg": ".ogg",
+  "audio/webm": ".webm",
+  "audio/flac": ".flac",
   "application/pdf": ".pdf"
 };
 function getMimeType(filename) {
@@ -54408,7 +54275,8 @@ var salesWindowSchema = z.object({
   });
 });
 function validateChronologicalFields(input) {
-  if (!input.start || !input.end) return;
+  if (input.start === void 0 || input.start.length === 0) return;
+  if (input.end === void 0 || input.end.length === 0) return;
   if (Date.parse(input.start) < Date.parse(input.end)) return;
   input.ctx.addIssue({
     code: "custom",
@@ -54592,7 +54460,7 @@ var upsertNavigationMenuCommandSchema = z.object({
     location: z.enum(navigationLocations).optional(),
     role: z.enum(navigationMenuRoles).optional(),
     items: z.array(navigationItemSchema).readonly()
-  }).strict().refine((input) => input.name || input.location, {
+  }).strict().refine((input) => input.name !== void 0 || input.location !== void 0, {
     message: "Navigation commands require either input.name or input.location."
   })
 }).strict();
@@ -54932,14 +54800,14 @@ var upsertBookingPassProductCommandSchema = z.object({
     productUseCase: z.enum(bookingPassProductUseCases).default("event_pass"),
     appointmentScope: appointmentPackageScopeSchema.optional()
   }).strict().superRefine((input, ctx) => {
-    if (input.productUseCase === "event_pass" && input.appointmentScope) {
+    if (input.productUseCase === "event_pass" && input.appointmentScope !== void 0) {
       ctx.addIssue({
         code: "custom",
         path: ["appointmentScope"],
         message: "appointmentScope is only valid for appointment_package passes"
       });
     }
-    if (input.productUseCase === "appointment_package" && !input.appointmentScope) {
+    if (input.productUseCase === "appointment_package" && input.appointmentScope === void 0) {
       ctx.addIssue({
         code: "custom",
         path: ["appointmentScope"],
@@ -55248,7 +55116,7 @@ var siteCommandBatchSchema = z.object({
   commands: z.array(siteCommandSchema).readonly()
 }).strict();
 function entryIdentifierForCommand(command) {
-  if (command.input.identifier) return command.input.identifier;
+  if (command.input.identifier !== void 0 && command.input.identifier.length > 0) return command.input.identifier;
   switch (command.type) {
     case "upsertContentEntry":
       return refSlug(command.ref);
@@ -55259,13 +55127,13 @@ function entryIdentifierForCommand(command) {
   }
 }
 function pageIdentifierForCommand(command) {
-  if (command.input.identifier) return command.input.identifier;
+  if (command.input.identifier !== void 0 && command.input.identifier.length > 0) return command.input.identifier;
   switch (command.type) {
     case "upsertPage":
       return refSlug(command.ref);
     case "publishPage":
     case "unpublishPage": {
-      if (!command.input.pageRef) {
+      if (command.input.pageRef === void 0) {
         throw new Error(`Page command ${command.ref} is missing identifier and pageRef.`);
       }
       return refSlug(command.input.pageRef);
@@ -55279,7 +55147,7 @@ function pageIdentifierForBlockCommand(command) {
   return command.input.pageIdentifier;
 }
 function blockIdentifierForCommand(command) {
-  if (command.input.identifier) return command.input.identifier;
+  if (command.input.identifier !== void 0 && command.input.identifier.length > 0) return command.input.identifier;
   switch (command.type) {
     case "upsertPageBlock":
       return refSlug(command.ref);
@@ -55885,7 +55753,7 @@ function getSiteCommandMetadata(type) {
 }
 function getSiteCommandLifecycleIntent(command) {
   if (command.type === "ensureTeamMemberProfile") {
-    return command.input.publish ? "publish" : "mutation";
+    return command.input.publish === true ? "publish" : "mutation";
   }
   return getSiteCommandMetadata(command.type).lifecycleIntent;
 }
@@ -56040,7 +55908,7 @@ function commandRefContributions(command) {
         provides: [{ ref: command.ref, field: "ref" }],
         requires: [
           { ref: command.input.resourceRef, field: "input.resourceRef" },
-          ...command.input.serviceRef ? [{ ref: command.input.serviceRef, field: "input.serviceRef" }] : []
+          ...command.input.serviceRef !== void 0 && command.input.serviceRef !== null ? [{ ref: command.input.serviceRef, field: "input.serviceRef" }] : []
         ]
       };
     case "upsertBlockTree":
@@ -56054,22 +55922,22 @@ function commandRefContributions(command) {
     case "upsertPageBlock":
       return {
         provides: [{ ref: command.ref, field: "ref" }],
-        requires: command.input.pageRef ? [{ ref: command.input.pageRef, field: "input.pageRef" }] : []
+        requires: command.input.pageRef !== void 0 ? [{ ref: command.input.pageRef, field: "input.pageRef" }] : []
       };
     case "patchPageBlockContent":
       return {
         provides: [],
-        requires: command.input.pageRef ? [{ ref: command.input.pageRef, field: "input.pageRef" }] : []
+        requires: command.input.pageRef !== void 0 ? [{ ref: command.input.pageRef, field: "input.pageRef" }] : []
       };
     case "deletePageBlock":
       return {
         provides: [],
-        requires: command.input.pageRef ? [{ ref: command.input.pageRef, field: "input.pageRef" }] : []
+        requires: command.input.pageRef !== void 0 ? [{ ref: command.input.pageRef, field: "input.pageRef" }] : []
       };
     case "reorderPageBlocks":
       return {
         provides: [{ ref: command.ref, field: "ref" }],
-        requires: command.input.pageRef ? [{ ref: command.input.pageRef, field: "input.pageRef" }] : [],
+        requires: command.input.pageRef !== void 0 ? [{ ref: command.input.pageRef, field: "input.pageRef" }] : [],
         requiresIfProvided: command.input.blocks.map((block, index) => ({
           ref: block.blockRef,
           field: `input.blocks[${index}].blockRef`
@@ -56079,7 +55947,7 @@ function commandRefContributions(command) {
       return {
         provides: [{ ref: command.ref, field: "ref" }],
         requires: [
-          ...command.input.linkedSubjectRef ? [{ ref: command.input.linkedSubjectRef, field: "input.linkedSubjectRef" }] : [],
+          ...command.input.linkedSubjectRef !== void 0 ? [{ ref: command.input.linkedSubjectRef, field: "input.linkedSubjectRef" }] : [],
           ...(command.input.mediaRefs ?? []).map((ref, index) => ({
             ref,
             field: `input.mediaRefs[${index}]`
@@ -56096,18 +55964,18 @@ function commandRefContributions(command) {
     case "unpublishPage":
       return {
         provides: [],
-        requires: command.input.pageRef ? [{ ref: command.input.pageRef, field: "input.pageRef" }] : []
+        requires: command.input.pageRef !== void 0 ? [{ ref: command.input.pageRef, field: "input.pageRef" }] : []
       };
     case "publishContentEntry":
       return {
         provides: [],
-        requires: command.input.contentEntryRef ? [{ ref: command.input.contentEntryRef, field: "input.contentEntryRef" }] : []
+        requires: command.input.contentEntryRef !== void 0 ? [{ ref: command.input.contentEntryRef, field: "input.contentEntryRef" }] : []
       };
     case "unpublishContentEntry":
     case "deleteContentEntry":
       return {
         provides: [],
-        requires: command.input.contentEntryRef ? [{ ref: command.input.contentEntryRef, field: "input.contentEntryRef" }] : []
+        requires: command.input.contentEntryRef !== void 0 ? [{ ref: command.input.contentEntryRef, field: "input.contentEntryRef" }] : []
       };
     default:
       return assertNever(command);
@@ -56152,7 +56020,7 @@ function collectOfferingRequires(input, intervals, intervalPath) {
   ];
 }
 function optionalRef(ref, field) {
-  return ref ? [{ ref, field }] : [];
+  return ref !== void 0 && ref.length > 0 ? [{ ref, field }] : [];
 }
 function collectVenueRefsFromIntervals(intervals, path28) {
   return intervals.flatMap((interval, index) => optionalRef(interval.venueRef, `${path28}[${index}].venueRef`));
@@ -56217,19 +56085,19 @@ function eventSeriesStaticExecutionGaps(command) {
       "event_external_payment_unsupported",
       "External-payment event commands need public checkout/link policy mapping before mutation."
     )] : [],
-    ...command.input.waitlist && command.input.waitlist.kind !== "disabled" ? [staticGap(
+    ...command.input.waitlist !== void 0 && command.input.waitlist.kind !== "disabled" ? [staticGap(
       "event_waitlist_requires_waitlist_adapter",
       "Event waitlist commands need waitlist service mapping before mutation."
     )] : [],
-    ...command.input.content?.imageRef || command.input.content?.mediaRefs ? [staticGap(
+    ...command.input.content?.imageRef !== void 0 || command.input.content?.mediaRefs !== void 0 ? [staticGap(
       "event_media_content_requires_media_adapter",
       "Event media content needs media adapter mapping before mutation."
     )] : [],
-    ...command.input.content?.contentEntryRef ? [staticGap(
+    ...command.input.content?.contentEntryRef !== void 0 ? [staticGap(
       "event_linked_content_requires_content_adapter",
       "Event linked content-entry refs need content adapter mapping before mutation."
     )] : [],
-    ...command.input.staffRefs?.length ? [staticGap(
+    ...(command.input.staffRefs?.length ?? 0) > 0 ? [staticGap(
       "event_staff_assignment_unsupported",
       "Event staff refs need staff assignment mapping before mutation."
     )] : [],
@@ -56255,11 +56123,11 @@ function courseStaticExecutionGaps(command) {
       "course_external_payment_unsupported",
       "External-payment course commands need public checkout/link policy mapping before mutation."
     )] : [],
-    ...command.input.waitlist && command.input.waitlist.kind !== "disabled" ? [staticGap(
+    ...command.input.waitlist !== void 0 && command.input.waitlist.kind !== "disabled" ? [staticGap(
       "course_waitlist_requires_waitlist_adapter",
       "Course waitlist commands need waitlist service mapping before mutation."
     )] : [],
-    ...command.input.staffRefs?.length ? [staticGap(
+    ...(command.input.staffRefs?.length ?? 0) > 0 ? [staticGap(
       "course_staff_assignment_unsupported",
       "Course staff refs need staff assignment mapping before mutation."
     )] : []
@@ -56526,7 +56394,7 @@ function validateBatchRefs(batch) {
     requiresByCommand.set(command.ref, [...dedupeContributions(requires)]);
     for (const { ref } of provides) {
       const existing = providerByRef.get(ref);
-      if (existing) {
+      if (existing !== void 0) {
         errors.push({
           code: "duplicate_resource_ref",
           resourceRef: ref,
@@ -56583,7 +56451,7 @@ function addInBatchProvidedRefRequirement(input) {
   const nextRequires = [...dedupeContributions([...currentRequires, input.requirement])];
   input.requiresByCommand.set(input.commandRef, nextRequires);
   const contribution = input.contributionsByCommand.get(input.commandRef);
-  if (contribution) {
+  if (contribution !== void 0) {
     input.contributionsByCommand.set(input.commandRef, {
       ...contribution,
       requires: nextRequires
@@ -56629,7 +56497,7 @@ function checkPortalOrdersHaveUniqueSubjects(batch) {
     if (command.type !== "seedPortalOrder") continue;
     const key = portalOrderSubjectKey(command.input.subject);
     const previous = seenBySubject.get(key);
-    if (previous) {
+    if (previous !== void 0) {
       errors.push(commandInvariantViolation(
         command.ref,
         "input.subject",
@@ -56751,7 +56619,7 @@ function checkTicketQuantitiesWithinCapacity(indexes) {
 function checkTicketsTargetTicketPricedEvents(indexes) {
   return indexes.ticketGroups.flatMap((tickets) => tickets.flatMap((ticket) => {
     const event = indexes.eventByRef.get(ticket.input.eventRef);
-    if (!event || event.input.pricing.kind === "ticket_types") return [];
+    if (event === void 0 || event.input.pricing.kind === "ticket_types") return [];
     return [commandInvariantViolation(
       ticket.ref,
       "input.eventRef",
@@ -56762,10 +56630,10 @@ function checkTicketsTargetTicketPricedEvents(indexes) {
 function checkTicketCurrencyMatchesEvent(indexes) {
   return indexes.ticketGroups.flatMap((tickets) => tickets.flatMap((ticket) => {
     const event = indexes.eventByRef.get(ticket.input.eventRef);
-    if (!event || event.input.pricing.kind !== "ticket_types") return [];
+    if (event === void 0 || event.input.pricing.kind !== "ticket_types") return [];
     const expectedCurrency = event.input.pricing.currency;
     const ticketCurrency = ticket.input.price.currency;
-    if (!expectedCurrency || !ticketCurrency || ticketCurrency === expectedCurrency) return [];
+    if (!hasText(expectedCurrency) || !hasText(ticketCurrency) || ticketCurrency === expectedCurrency) return [];
     return [commandInvariantViolation(
       ticket.ref,
       "input.price.currency",
@@ -56793,10 +56661,11 @@ function orderCommands(commands, providerByRef, requiresByCommand) {
     const requires = requiresByCommand.get(command.ref) ?? [];
     for (const { ref } of requires) {
       const provider = providerByRef.get(ref);
-      if (!provider || provider === command.ref) continue;
+      if (provider === void 0 || provider === command.ref) continue;
       if (!outgoing.has(provider)) outgoing.set(provider, /* @__PURE__ */ new Set());
-      if (!outgoing.get(provider)?.has(command.ref)) {
-        outgoing.get(provider)?.add(command.ref);
+      const dependents = outgoing.get(provider);
+      if (dependents !== void 0 && !dependents.has(command.ref)) {
+        dependents.add(command.ref);
         indegree.set(command.ref, (indegree.get(command.ref) ?? 0) + 1);
       }
     }
@@ -56806,9 +56675,9 @@ function orderCommands(commands, providerByRef, requiresByCommand) {
   while (ready.length > 0) {
     ready.sort((left, right) => (authorIndex.get(left) ?? 0) - (authorIndex.get(right) ?? 0) || left.localeCompare(right));
     const nextRef = ready.shift();
-    if (!nextRef) continue;
+    if (nextRef === void 0) continue;
     const command = commandByRef.get(nextRef);
-    if (command) ordered.push(command);
+    if (command !== void 0) ordered.push(command);
     for (const dependent of outgoing.get(nextRef) ?? []) {
       const nextDegree = (indegree.get(dependent) ?? 0) - 1;
       indegree.set(dependent, nextDegree);
@@ -56931,7 +56800,7 @@ function stableStringify(value) {
 }
 function sortValue(value) {
   if (Array.isArray(value)) return value.map(sortValue);
-  if (value && typeof value === "object") return sortRecord(value);
+  if (value !== null && typeof value === "object") return sortRecord(value);
   return value;
 }
 function sortRecord(record) {
@@ -58728,6 +58597,8 @@ function recordNavigationFailure(result, identifier, message) {
 
 // src/cli/site-commands/pageCommands.ts
 init_src();
+
+// src/cli/sync/validation.ts
 function assertNeverField(field) {
   throw new Error(`Unhandled field type while extracting field ids: ${JSON.stringify(field)}`);
 }
@@ -58805,31 +58676,17 @@ function getDataKeys(data) {
   return new Set(Object.keys(data));
 }
 function validateBlockContent(data, manifest, customFields) {
-  const warnings = [];
-  try {
-    const manifestWithCustomFields = customFields ? { ...manifest, fields: [...manifest.fields, ...customFields] } : manifest;
-    const normalizedFields = parseFieldDefinitions([...manifestWithCustomFields.fields]);
-    const validator = createManifestValidator(normalizedFields, {
-      allowNull: true,
-      allowIncomplete: true
-    });
-    validator.parse(data);
-  } catch (error) {
-    if (error instanceof ZodError) {
-      for (const issue5 of error.issues) {
-        const fieldPath = issue5.path.join(".");
-        if (issue5.code === "invalid_type" && issue5.received === "undefined") {
-          continue;
-        }
-        warnings.push({
-          type: "invalid_content",
-          field: fieldPath || "(root)",
-          message: `Invalid content${fieldPath ? ` in "${fieldPath}"` : ""}: ${issue5.message}`
-        });
-      }
-    }
-  }
-  return warnings;
+  const manifestWithCustomFields = customFields ? { ...manifest, fields: [...manifest.fields, ...customFields] } : manifest;
+  const normalizedFields = parseFieldDefinitions([...manifestWithCustomFields.fields]);
+  const validation = validateManifestContentForPush(normalizedFields, data);
+  if (validation.kind === "valid") return [];
+  return validation.issues.filter((issue5) => !isTopLevelRequiredManifestContentIssue(issue5)).map((issue5) => {
+    return {
+      type: "invalid_content",
+      field: issue5.field || "(root)",
+      message: formatManifestContentValidationIssue(issue5)
+    };
+  });
 }
 function validateBlockData(data, manifest, customFields) {
   const warnings = [];
@@ -64508,6 +64365,12 @@ function buildBlockTypesTemplate() {
     "",
     "Reference list of all built-in CMS block types.",
     "The generated section is updated by `riverbankcms init-docs`.",
+    "",
+    "Authoring notes:",
+    "- Fields marked `required` must be present with a valid value.",
+    "- Optional fields may be omitted from pushed JSON; you do not need to include every key or set unused fields to `null`.",
+    "- Defaults shown here document the editor/rendering contract. Include an optional field only when you want to override the default.",
+    "- Required nested fields apply when their parent object or repeater item is present.",
     ""
   ].join("\n");
   const generated = buildBlockTypesGeneratedSection();
@@ -64526,6 +64389,12 @@ function buildSiteBlockTypesTemplate(state) {
     "- System blocks (`block.*`) with `blockFieldExtensions` and `blockFieldOptions` merged in",
     "- Custom blocks (`custom.*`) from `riverbank.config.ts`",
     "",
+    "Authoring notes:",
+    "- Fields marked `required` must be present with a valid value.",
+    "- Optional fields may be omitted from pushed JSON; you do not need to include every key or set unused fields to `null`.",
+    "- Defaults shown here document the editor/rendering contract. Include an optional field only when you want to override the default.",
+    "- Required nested fields apply when their parent object or repeater item is present.",
+    "",
     "The generated section is updated by `riverbankcms init-docs`.",
     ""
   ].join("\n");
@@ -65565,7 +65434,7 @@ var SimpleCache = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.90.1";
+var SDK_VERSION = "0.91.0";
 
 // src/client/error.ts
 var RiverbankApiError = class _RiverbankApiError extends Error {