@designcrowd/library.brand-page 5.17.6 → 5.17.7

package/src/metadata-builder/builders/section-builders/mailing-list-builder.ts

@@ -0,0 +1,29 @@
+import type { BuilderResult } from '@src/metadata-builder/models';
+import type {
+  BrandPageModel,
+  MailingListContent,
+} from '../../../brand-page/models';
+import { applyScalarFields } from '../section-field-utils';
+import { BaseSectionBuilder } from './base-section-builder';
+
+export class MailingListBuilder extends BaseSectionBuilder<MailingListContent> {
+  async buildAsync(model: BrandPageModel): Promise<BuilderResult> {
+    this.log('Build called');
+
+    const validation = await this.validateAsync();
+
+    if (validation.errors.length) {
+      return { request: this.request, model, errors: validation.errors };
+    }
+
+    const resolved = this.resolveContent(model);
+
+    if ('error' in resolved) return resolved.error;
+
+    const content = resolved.content;
+
+    applyScalarFields(content, this.args, this.sectionType);
+
+    return { request: this.request, model };
+  }
+}

package/src/metadata-builder/builders/section-builders/mailing-list-section-builder.ts

@@ -0,0 +1,27 @@
+import type {
+  MailingListContent,
+  BrandPageModel,
+} from '../../../brand-page/models';
+import type { BuilderResult } from '../../models';
+import { applyScalarFields } from '../section-field-utils';
+import { BaseSectionBuilder } from './base-section-builder';
+
+export class MailingListSectionBuilder extends BaseSectionBuilder<MailingListContent> {
+  async buildAsync(model: BrandPageModel): Promise<BuilderResult> {
+    this.log('Build called');
+
+    const validation = await this.validateAsync();
+
+    if (validation.errors.length) {
+      return { request: this.request, model, errors: validation.errors };
+    }
+
+    const resolved = this.resolveContent(model);
+
+    if ('error' in resolved) return resolved.error;
+
+    applyScalarFields(resolved.content, this.args, this.sectionType);
+
+    return { request: this.request, model };
+  }
+}

package/src/metadata-builder/builders/section-builders/move-section-builder.ts

@@ -0,0 +1,100 @@
+import type { BrandPageModel } from '../../../brand-page/models';
+import {
+  BaseMetadataBuilder,
+  type BuilderResult,
+  type MetadataBuilderRequest,
+} from '../../models';
+import type { Logger } from '../../logger';
+
+export interface MoveSectionPayload {
+  contentId: string;
+  position: number;
+  targetPageId?: string;
+}
+
+export class MoveSectionBuilder extends BaseMetadataBuilder<MoveSectionPayload> {
+  constructor(
+    request: MetadataBuilderRequest<MoveSectionPayload>,
+    logger?: Logger,
+  ) {
+    super(request, logger);
+  }
+
+  async validateAsync(): Promise<{ errors: string[] }> {
+    const errors: string[] = [];
+    const payload = this.request.payload;
+
+    if (!payload?.contentId) {
+      errors.push('contentId is required for move_section');
+    }
+
+    if (payload?.position === undefined || payload.position < 0) {
+      errors.push('position must be a non-negative integer');
+    }
+
+    return { errors };
+  }
+
+  async buildAsync(model: BrandPageModel): Promise<BuilderResult> {
+    this.log('Build called');
+
+    const validation = await this.validateAsync();
+
+    if (validation.errors.length) {
+      return { request: this.request, model, errors: validation.errors };
+    }
+
+    const { contentId, position, targetPageId } = this.request.payload!;
+
+    for (const page of model.pages) {
+      const currentIndex = page.contents.findIndex((c) => c.id === contentId);
+
+      if (currentIndex !== -1) {
+        const [section] = page.contents.splice(currentIndex, 1);
+
+        // Cross-page move: insert into target page
+        if (targetPageId && targetPageId !== page.id) {
+          const targetPage = model.pages.find((p) => p.id === targetPageId);
+
+          if (!targetPage) {
+            // Undo the splice and return an error
+            page.contents.splice(currentIndex, 0, section);
+
+            return {
+              request: this.request,
+              model,
+              errors: [`Target page with ID "${targetPageId}" not found`],
+            };
+          }
+
+          const targetIndex = Math.min(position, targetPage.contents.length);
+
+          targetPage.contents.splice(targetIndex, 0, section);
+
+          this.log({
+            message: `Moved section ${contentId} from page ${page.id} index ${currentIndex} to page ${targetPageId} index ${targetIndex}`,
+          });
+
+          return { request: this.request, model };
+        }
+
+        // Within-page reorder
+        const targetIndex = Math.min(position, page.contents.length);
+
+        page.contents.splice(targetIndex, 0, section);
+
+        this.log({
+          message: `Moved section ${contentId} from index ${currentIndex} to ${targetIndex} on page ${page.id}`,
+        });
+
+        return { request: this.request, model };
+      }
+    }
+
+    return {
+      request: this.request,
+      model,
+      errors: [`Section with ID "${contentId}" not found`],
+    };
+  }
+}

package/src/metadata-builder/builders/section-builders/profile-section-builder.ts

@@ -0,0 +1,27 @@
+import type {
+  ProfileContent,
+  BrandPageModel,
+} from '../../../brand-page/models';
+import type { BuilderResult } from '../../models';
+import { applyScalarFields } from '../section-field-utils';
+import { BaseSectionBuilder } from './base-section-builder';
+
+export class ProfileSectionBuilder extends BaseSectionBuilder<ProfileContent> {
+  async buildAsync(model: BrandPageModel): Promise<BuilderResult> {
+    this.log('Build called');
+
+    const validation = await this.validateAsync();
+
+    if (validation.errors.length) {
+      return { request: this.request, model, errors: validation.errors };
+    }
+
+    const resolved = this.resolveContent(model);
+
+    if ('error' in resolved) return resolved.error;
+
+    applyScalarFields(resolved.content, this.args, this.sectionType);
+
+    return { request: this.request, model };
+  }
+}

package/src/metadata-builder/builders/section-builders/shapes-section-builder.ts

@@ -0,0 +1,231 @@
+import type {
+  ShapesSectionContent,
+  BrandPageModel,
+} from '../../../brand-page/models';
+import type {
+  ShapesSectionArguments,
+  ShapesSectionItem,
+} from '../../parsers/section-tool-arguments';
+import type { BuilderResult } from '../../models';
+import {
+  applyScalarFields,
+  applyStyleFields,
+  applyRTEStyles,
+} from '../section-field-utils';
+import { BaseSectionBuilder } from './base-section-builder';
+
+const applyShapeItems = (
+  content: ShapesSectionContent,
+  items: ShapesSectionItem[],
+): void => {
+  content.items = items.map((item, index) => ({
+    imageUrl: item.shape_url || item.icon_image_url || '',
+    imageTitle: '',
+    width: 0,
+    height: 0,
+    mediaType: 'shape',
+    imageLink: '',
+    title: item.heading || '',
+    paragraph: item.text || '',
+    itemsId: index,
+    colorReplacements: [],
+    keepColor: item.keep_color ?? false,
+  }));
+};
+
+const mergeShapeItems = (
+  content: ShapesSectionContent,
+  items: ShapesSectionItem[],
+  replaceAll: boolean,
+): void => {
+  const hasIndexedItems = items.some((item) => item.item_index !== undefined);
+
+  if (hasIndexedItems) {
+    for (const item of items) {
+      const targetIndex = item.item_index;
+
+      if (
+        targetIndex === undefined ||
+        targetIndex < 0 ||
+        !content.items?.[targetIndex]
+      )
+        continue;
+
+      const existing = content.items[targetIndex];
+
+      if (item.shape_url !== undefined || item.icon_image_url !== undefined) {
+        existing.imageUrl =
+          item.shape_url ?? item.icon_image_url ?? existing.imageUrl;
+      }
+
+      if (item.heading !== undefined) existing.title = item.heading;
+
+      if (item.text !== undefined) existing.paragraph = item.text;
+
+      if (item.keep_color !== undefined) {
+        (existing as any).keepColor = item.keep_color;
+      }
+    }
+
+    return;
+  }
+
+  const updatedItems = items.map((item, index) => {
+    const existing = content.items?.[index];
+    const imageUrl =
+      item.shape_url ?? item.icon_image_url ?? existing?.imageUrl ?? '';
+
+    return {
+      ...(existing || {}),
+      imageUrl,
+      imageTitle: existing?.imageTitle ?? '',
+      width: existing?.width ?? 0,
+      height: existing?.height ?? 0,
+      mediaType: existing?.mediaType ?? 'shape',
+      imageLink: existing?.imageLink ?? '',
+      title: item.heading ?? existing?.title ?? '',
+      paragraph: item.text ?? existing?.paragraph ?? '',
+      itemsId: existing?.itemsId ?? index,
+      colorReplacements: existing?.colorReplacements ?? [],
+      keepColor:
+        item.keep_color ??
+        (existing && 'keepColor' in existing ? existing.keepColor : false),
+    };
+  });
+
+  if (!replaceAll && content.items && content.items.length > items.length) {
+    const remaining = content.items.slice(items.length) as typeof updatedItems;
+
+    updatedItems.push(...remaining);
+  }
+
+  content.items = updatedItems;
+};
+
+export class ShapesSectionBuilder extends BaseSectionBuilder<ShapesSectionContent> {
+  async buildAsync(model: BrandPageModel): Promise<BuilderResult> {
+    this.log('Build called');
+
+    const validation = await this.validateAsync();
+
+    if (validation.errors.length) {
+      return { request: this.request, model, errors: validation.errors };
+    }
+
+    const resolved = this.resolveContent(model);
+
+    if ('error' in resolved) return resolved.error;
+
+    const content = resolved.content;
+
+    applyScalarFields(content, this.args, this.sectionType);
+    applyStyleFields(content, this.args, this.sectionType);
+    applyRTEStyles(content, this.args, this.sectionType);
+
+    const args = this.args as ShapesSectionArguments;
+
+    if (args.background_style && typeof args.background_style === 'object') {
+      const existing = content.backgroundStyle || {};
+
+      content.backgroundStyle = {
+        ...existing,
+        ...Object.fromEntries(
+          Object.entries(args.background_style).map(([k, v]) => [
+            k,
+            v === null ? '' : v,
+          ]),
+        ),
+      };
+    }
+
+    if (args.card_style && typeof args.card_style === 'object') {
+      const existing = content.cardStyle || {};
+
+      content.cardStyle = {
+        ...existing,
+        ...Object.fromEntries(
+          Object.entries(args.card_style).map(([k, v]) => [
+            k,
+            v === null ? '' : v,
+          ]),
+        ),
+      };
+    }
+
+    if (args.items && Array.isArray(args.items)) {
+      if (this.mode === 'create') {
+        applyShapeItems(content, args.items);
+      } else {
+        mergeShapeItems(content, args.items, !!args._replace_items);
+      }
+    }
+
+    // Phase 2: Item operations (remove, insert, reorder)
+    if (args._remove_item_indices?.length && content.items) {
+      const sorted = [...args._remove_item_indices].sort((a, b) => b - a);
+
+      for (const idx of sorted) {
+        if (idx >= 0 && idx < content.items.length) {
+          content.items.splice(idx, 1);
+        }
+      }
+    }
+
+    if (args.items && Array.isArray(args.items)) {
+      const insertItems = args.items.filter(
+        (item) => item.insert_at !== undefined && item.item_index === undefined,
+      );
+      // Process inserts in reverse order of insert_at to preserve indices
+      const sortedInserts = [...insertItems].sort(
+        (a, b) => (b.insert_at ?? 0) - (a.insert_at ?? 0),
+      );
+
+      for (const item of sortedInserts) {
+        const pos = Math.max(
+          0,
+          Math.min(item.insert_at ?? 0, content.items?.length ?? 0),
+        );
+        const newItem = {
+          imageUrl: item.shape_url ?? item.icon_image_url ?? '',
+          imageTitle: '',
+          width: 0,
+          height: 0,
+          mediaType: 'shape',
+          imageLink: '',
+          title: item.heading ?? '',
+          paragraph: item.text ?? '',
+          itemsId: pos,
+          colorReplacements: [],
+          keepColor: item.keep_color ?? false,
+        };
+
+        content.items = content.items ?? [];
+        content.items.splice(pos, 0, newItem as any);
+      }
+    }
+
+    if (args._reorder_items?.length && content.items) {
+      const newOrder = args._reorder_items;
+      const unique = new Set(newOrder);
+
+      if (unique.size === newOrder.length) {
+        const reordered = newOrder
+          .filter((idx) => idx >= 0 && idx < content.items!.length)
+          .map((idx) => content.items![idx]);
+
+        if (reordered.length === content.items.length) {
+          content.items = reordered;
+        }
+      }
+    }
+
+    // Re-index itemsId after any item operations
+    if (content.items) {
+      content.items.forEach((item, i) => {
+        item.itemsId = i;
+      });
+    }
+
+    return { request: this.request, model };
+  }
+}

package/src/metadata-builder/builders/section-builders/social-links-builder.ts

@@ -0,0 +1,79 @@
+import type {
+  SocialLinksContent,
+  BrandPageModel,
+} from '../../../brand-page/models';
+import type {
+  SocialLink,
+  SocialLinksSectionArguments,
+} from '../../parsers/section-tool-arguments';
+import type { BuilderResult } from '../../models';
+import { applyScalarFields } from '../section-field-utils';
+import { BaseSectionBuilder } from './base-section-builder';
+
+const applySocialLinks = (
+  content: SocialLinksContent,
+  links: SocialLink[],
+): void => {
+  content.links = links.map((link) => ({
+    imageUrl: link.platform || '',
+    imageTitle: '',
+    width: 0,
+    height: 0,
+    imageLink: '',
+    url: link.url || '',
+  }));
+};
+
+const mergeSocialLinks = (
+  content: SocialLinksContent,
+  links: SocialLink[],
+  replaceAll: boolean,
+): void => {
+  const updatedLinks = links.map((link, index) => {
+    const existing = content.links?.[index];
+
+    return {
+      ...(existing || {}),
+      imageUrl: link.platform ?? existing?.imageUrl ?? '',
+      url: link.url ?? existing?.url ?? '',
+    };
+  });
+
+  if (!replaceAll && content.links && content.links.length > links.length) {
+    updatedLinks.push(...content.links.slice(links.length));
+  }
+
+  content.links = updatedLinks;
+};
+
+export class SocialLinksBuilder extends BaseSectionBuilder<SocialLinksContent> {
+  async buildAsync(model: BrandPageModel): Promise<BuilderResult> {
+    this.log('Build called');
+
+    const validation = await this.validateAsync();
+
+    if (validation.errors.length) {
+      return { request: this.request, model, errors: validation.errors };
+    }
+
+    const resolved = this.resolveContent(model);
+
+    if ('error' in resolved) return resolved.error;
+
+    const content = resolved.content;
+
+    applyScalarFields(content, this.args, this.sectionType);
+
+    const args = this.args as SocialLinksSectionArguments;
+
+    if (args.links && Array.isArray(args.links)) {
+      if (this.mode === 'create') {
+        applySocialLinks(content, args.links);
+      } else {
+        mergeSocialLinks(content, args.links, !!args._replace_items);
+      }
+    }
+
+    return { request: this.request, model };
+  }
+}

package/src/metadata-builder/builders/section-builders/testimonial-section-builder.ts

@@ -0,0 +1,194 @@
+import type {
+  TestimonialSectionContent,
+  BrandPageModel,
+} from '../../../brand-page/models';
+import type {
+  TestimonialItem,
+  TestimonialSectionArguments,
+} from '../../parsers/section-tool-arguments';
+import type { BuilderResult } from '../../models';
+import { applyScalarFields, applyStyleFields } from '../section-field-utils';
+import { BaseSectionBuilder } from './base-section-builder';
+
+const applyTestimonialItems = (
+  content: TestimonialSectionContent,
+  items: TestimonialItem[],
+): void => {
+  content.items = items.map((item) => ({
+    imageUrl: item.avatar_image_url || '',
+    name: item.name || '',
+    position: item.position || '',
+    testimonials: item.testimonial || '',
+    colorReplacements: [],
+    mediaType: 'image',
+  }));
+};
+
+const mergeTestimonialItems = (
+  content: TestimonialSectionContent,
+  items: TestimonialItem[],
+  replaceAll: boolean,
+): void => {
+  const hasIndexedItems = items.some((item) => item.item_index !== undefined);
+
+  if (hasIndexedItems) {
+    for (const item of items) {
+      const targetIndex = item.item_index;
+
+      if (
+        targetIndex === undefined ||
+        targetIndex < 0 ||
+        !content.items?.[targetIndex]
+      )
+        continue;
+
+      const existing = content.items[targetIndex];
+
+      if (item.avatar_image_url !== undefined)
+        existing.imageUrl = item.avatar_image_url;
+
+      if (item.name !== undefined) existing.name = item.name;
+
+      if (item.position !== undefined) existing.position = item.position;
+
+      if (item.testimonial !== undefined)
+        existing.testimonials = item.testimonial;
+    }
+
+    return;
+  }
+
+  const updatedItems = items.map((item, index) => {
+    const existing = content.items?.[index];
+
+    return {
+      ...(existing || {}),
+      imageUrl: item.avatar_image_url ?? existing?.imageUrl ?? '',
+      name: item.name ?? existing?.name ?? '',
+      position: item.position ?? existing?.position ?? '',
+      testimonials: item.testimonial ?? existing?.testimonials ?? '',
+      colorReplacements: existing?.colorReplacements ?? [],
+      mediaType: existing?.mediaType ?? 'image',
+    };
+  });
+
+  if (!replaceAll && content.items && content.items.length > items.length) {
+    updatedItems.push(...content.items.slice(items.length));
+  }
+
+  content.items = updatedItems;
+};
+
+export class TestimonialSectionBuilder extends BaseSectionBuilder<TestimonialSectionContent> {
+  async buildAsync(model: BrandPageModel): Promise<BuilderResult> {
+    this.log('Build called');
+
+    const validation = await this.validateAsync();
+
+    if (validation.errors.length) {
+      return { request: this.request, model, errors: validation.errors };
+    }
+
+    const resolved = this.resolveContent(model);
+
+    if ('error' in resolved) return resolved.error;
+
+    const content = resolved.content;
+
+    applyScalarFields(content, this.args, this.sectionType);
+    applyStyleFields(content, this.args, this.sectionType);
+
+    const args = this.args as TestimonialSectionArguments;
+
+    if (args.background_style && typeof args.background_style === 'object') {
+      const existing = content.backgroundStyle || {};
+
+      content.backgroundStyle = {
+        ...existing,
+        ...Object.fromEntries(
+          Object.entries(args.background_style).map(([k, v]) => [
+            k,
+            v === null ? '' : v,
+          ]),
+        ),
+      };
+    }
+
+    if (args.card_style && typeof args.card_style === 'object') {
+      const existing = content.cardStyle || {};
+
+      content.cardStyle = {
+        ...existing,
+        ...Object.fromEntries(
+          Object.entries(args.card_style).map(([k, v]) => [
+            k,
+            v === null ? '' : v,
+          ]),
+        ),
+      };
+    }
+
+    if (args.items && Array.isArray(args.items)) {
+      if (this.mode === 'create') {
+        applyTestimonialItems(content, args.items);
+      } else {
+        mergeTestimonialItems(content, args.items, !!args._replace_items);
+      }
+    }
+
+    // Phase 2: Item operations (remove, insert, reorder)
+    if (args._remove_item_indices?.length && content.items) {
+      const sorted = [...args._remove_item_indices].sort((a, b) => b - a);
+
+      for (const idx of sorted) {
+        if (idx >= 0 && idx < content.items.length) {
+          content.items.splice(idx, 1);
+        }
+      }
+    }
+
+    if (args.items && Array.isArray(args.items)) {
+      const insertItems = args.items.filter(
+        (item) => item.insert_at !== undefined && item.item_index === undefined,
+      );
+      const sortedInserts = [...insertItems].sort(
+        (a, b) => (b.insert_at ?? 0) - (a.insert_at ?? 0),
+      );
+
+      for (const item of sortedInserts) {
+        const pos = Math.max(
+          0,
+          Math.min(item.insert_at ?? 0, content.items?.length ?? 0),
+        );
+        const newItem = {
+          imageUrl: item.avatar_image_url ?? '',
+          name: item.name ?? '',
+          position: item.position ?? '',
+          testimonials: item.testimonial ?? '',
+          colorReplacements: [],
+          mediaType: 'image',
+        };
+
+        content.items = content.items ?? [];
+        content.items.splice(pos, 0, newItem as any);
+      }
+    }
+
+    if (args._reorder_items?.length && content.items) {
+      const newOrder = args._reorder_items;
+      const unique = new Set(newOrder);
+
+      if (unique.size === newOrder.length) {
+        const reordered = newOrder
+          .filter((idx) => idx >= 0 && idx < content.items!.length)
+          .map((idx) => content.items![idx]);
+
+        if (reordered.length === content.items.length) {
+          content.items = reordered;
+        }
+      }
+    }
+
+    return { request: this.request, model };
+  }
+}