@designcrowd/library.brand-page 5.19.1-id-based-items-2 → 5.19.1

package/src/metadata-builder/builders/item-id-utils.ts

@@ -1,117 +0,0 @@
-import { v4 as uuidv4 } from 'uuid';
-import type { BrandPageModel } from '../../brand-page/models';
-
-/**
- * Sentinel anchor meaning "the end of the list", mirroring the section-level
- * `move_before_content_id: "__end__"` convention used in base-section-builder.
- */
-export const END_ITEM_ANCHOR = '__end__';
-
-/** Generate a stable item id. Mirrors section-level `uuid.v4()` id generation. */
-export const generateItemId = (): string => uuidv4();
-
-/**
- * Walk an entire BrandPageModel and backfill a stable uuid `id` onto every
- * nested array item that lacks one (gallery images, images/shapes/testimonial
- * items, text items, social links, and footer social links).
- *
- * BP-5603: this must run BEFORE the model is minified for the AI, so the same
- * id the AI is shown (and copies into `item_id`) is the one the executor later
- * matches. The maker holds a single live model instance for both the minify
- * and the apply step, so mutating it here makes the ids round-trip; they then
- * persist on the next save. Idempotent — existing ids are preserved.
- */
-export const ensureBrandPageItemIds = (model: BrandPageModel): void => {
-  const ensureContentItemIds = (content: Record<string, unknown>): void => {
-    // Every array field that the minifier surfaces as a list of items.
-    for (const field of ['images', 'items', 'textItems', 'links'] as const) {
-      const arr = content[field];
-
-      if (Array.isArray(arr)) ensureItemIds(arr as { id?: string }[]);
-    }
-  };
-
-  for (const page of model.pages ?? []) {
-    for (const content of page.contents ?? []) {
-      ensureContentItemIds(content as unknown as Record<string, unknown>);
-    }
-  }
-
-  ensureItemIds(model.pageFooterDesktop?.socialLinks);
-  ensureItemIds(model.pageFooterMobile?.socialLinks);
-};
-
-/**
- * Backfill ids onto any items missing one. Per BP-5603 this runs in the
- * metadata builder when a section is processed, so the persisted metadata
- * returned to the client gains stable ids that subsequent AI tool calls can
- * reference. Mutates in place.
- */
-export const ensureItemIds = <T extends { id?: string }>(
-  items: T[] | undefined,
-): void => {
-  if (!items) return;
-
-  for (const item of items) {
-    if (!item.id) item.id = generateItemId();
-  }
-};
-
-/**
- * Remove items whose id appears in `ids`. Order-independent (no descending
- * index sort needed) — the whole point of the id-based migration. Items
- * without an id are never removed by id.
- */
-export const removeItemsByIds = <T extends { id?: string }>(
-  items: T[] | undefined,
-  ids: string[] | undefined,
-): T[] => {
-  if (!items?.length) return items ?? [];
-
-  if (!ids?.length) return items;
-
-  const toRemove = new Set(ids);
-
-  return items.filter((item) => !item.id || !toRemove.has(item.id));
-};
-
-/**
- * Position `item` within `items` relative to an anchor id — the item-level
- * mirror of base-section-builder's `moveContent`:
- *
- * - `moveBeforeItemId === undefined`  → leave an existing item where it is;
- *   append a new (not-yet-present) item to the end.
- * - `moveBeforeItemId === "__end__"`  → move/insert at the very end.
- * - anchor id found                   → insert immediately before it.
- * - anchor id not found               → fall through to the end (same
- *   forgiving behaviour as `moveContent`).
- *
- * Mutates `items` in place. `item` may be an existing element of `items`
- * (a move) or a brand-new object (an insert).
- */
-export const repositionItemByAnchor = <T extends { id?: string }>(
-  items: T[],
-  item: T,
-  moveBeforeItemId: string | undefined,
-): void => {
-  const currentIndex = items.indexOf(item);
-
-  if (moveBeforeItemId === undefined) {
-    if (currentIndex === -1) items.push(item);
-
-    return;
-  }
-
-  if (currentIndex !== -1) items.splice(currentIndex, 1);
-
-  const anchorIndex =
-    moveBeforeItemId === END_ITEM_ANCHOR
-      ? -1
-      : items.findIndex((i) => i.id === moveBeforeItemId);
-
-  if (anchorIndex !== -1) {
-    items.splice(anchorIndex, 0, item);
-  } else {
-    items.push(item);
-  }
-};