@morphika/andami 0.1.7 → 0.1.9

package/lib/builder/serializer/shared.ts

@@ -0,0 +1,102 @@
+/**
+ * Shared utilities used by both Document→State (normalizers) and State→Document (serializers).
+ *
+ * Extracted from serializer.ts in Session 162.
+ */
+
+import { generateKey } from "../utils";
+
+// ============================================
+// Constants
+// ============================================
+
+/**
+ * Map block types to section_type values.
+ * Used during migration and validation to ensure consistent section type naming.
+ */
+export const SECTION_TYPE_MAP: Record<string, string> = {
+  projectGridBlock: "projectGrid",
+};
+
+// ============================================
+// Utility Functions
+// ============================================
+
+/**
+ * Ensure every item has a _key.
+ * Sanity sometimes omits _key on newly created objects.
+ */
+export function ensureKeys<T extends { _key?: string }>(items: T[] | undefined): (T & { _key: string })[] {
+  if (!items) return [];
+  return items.map((item) => ({
+    ...item,
+    _key: item._key || generateKey(),
+  }));
+}
+
+/**
+ * Strip undefined values from an object (Sanity rejects undefined).
+ */
+export function stripUndefined<T extends Record<string, unknown>>(obj: T): T {
+  const result = {} as T;
+  for (const key of Object.keys(obj) as (keyof T)[]) {
+    if (obj[key] !== undefined) {
+      result[key] = obj[key];
+    }
+  }
+  return result;
+}
+
+/**
+ * Clean a layout object by removing empty, null, and empty-string values.
+ * Returns undefined if the cleaned object has no keys.
+ */
+export function cleanLayoutObject(obj: Record<string, unknown>): Record<string, unknown> | undefined {
+  const cleaned: Record<string, unknown> = {};
+  for (const [key, val] of Object.entries(obj)) {
+    if (val !== undefined && val !== null && val !== "") {
+      cleaned[key] = val;
+    }
+  }
+  return Object.keys(cleaned).length > 0 ? cleaned : undefined;
+}
+
+/**
+ * Normalize block layout responsive overrides.
+ * Cleans up empty/invalid values within responsive.tablet.layout and responsive.phone.layout.
+ * Strips empty viewport objects and empty layout sub-objects.
+ */
+export function normalizeBlockResponsive(
+  responsive: Record<string, Record<string, unknown>> | undefined
+): Record<string, Record<string, unknown>> | undefined {
+  if (!responsive) return undefined;
+
+  const result: Record<string, Record<string, unknown>> = {};
+
+  for (const vp of ["tablet", "phone"] as const) {
+    const vpOverrides = responsive[vp];
+    if (!vpOverrides || typeof vpOverrides !== "object") continue;
+
+    const cleaned: Record<string, unknown> = {};
+
+    for (const [key, val] of Object.entries(vpOverrides)) {
+      if (val === undefined || val === null) continue;
+
+      if (key === "layout" && typeof val === "object" && val !== null) {
+        const layoutCleaned = cleanLayoutObject(val as Record<string, unknown>);
+        if (layoutCleaned) cleaned.layout = layoutCleaned;
+        continue;
+      }
+
+      // Other block properties (non-layout)
+      if (typeof val === "string" && val.trim() === "") continue;
+      cleaned[key] = val;
+    }
+
+    if (Object.keys(cleaned).length > 0) {
+      result[vp] = cleaned;
+    }
+  }
+
+  return Object.keys(result).length > 0 ? result : undefined;
+}