@designcrowd/library.brand-page 5.17.6 → 5.17.7

package/lib/src/metadata-builder/builders/section-builders/image-gallery-builder.js

@@ -0,0 +1,76 @@
+import { applyScalarFields } from '../section-field-utils';
+import { BaseSectionBuilder } from './base-section-builder';
+const applyGalleryType = (content, galleryType) => {
+    content.galleryStyles = {
+        ...(content.galleryStyles || {}),
+        galleryType: galleryType,
+    };
+};
+const applyGalleryImages = (content, images) => {
+    content.images = images
+        .filter((img) => !!img.image_url)
+        .map((img) => ({
+        imageUrl: img.image_url || '',
+        imageTitle: img.caption || '',
+        width: 0,
+        height: 0,
+        mediaType: 'image',
+        imageLink: '',
+    }));
+};
+const mergeGalleryImages = (content, images, replaceAll) => {
+    const updatedImages = images
+        .map((img, index) => {
+        const existing = content.images?.[index];
+        const imageUrl = img.image_url ?? existing?.imageUrl ?? '';
+        return {
+            ...(existing || {}),
+            imageUrl,
+            imageTitle: img.caption ?? existing?.imageTitle ?? '',
+            width: existing?.width ?? 0,
+            height: existing?.height ?? 0,
+            mediaType: existing?.mediaType ?? 'image',
+            imageLink: existing?.imageLink ?? '',
+        };
+    })
+        .filter((item) => !!item.imageUrl);
+    if (!replaceAll && content.images && content.images.length > images.length) {
+        const extras = content.images.slice(images.length).map((img) => ({
+            imageUrl: img.imageUrl ?? '',
+            imageTitle: img.imageTitle ?? '',
+            width: img.width ?? 0,
+            height: img.height ?? 0,
+            mediaType: img.mediaType ?? 'image',
+            imageLink: img.imageLink ?? '',
+        }));
+        updatedImages.push(...extras);
+    }
+    content.images = updatedImages;
+};
+export class ImageGalleryBuilder extends BaseSectionBuilder {
+    async buildAsync(model) {
+        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;
+        if (args.gallery_type) {
+            applyGalleryType(content, args.gallery_type);
+        }
+        if (args.images && Array.isArray(args.images)) {
+            if (this.mode === 'create') {
+                applyGalleryImages(content, args.images);
+            }
+            else {
+                mergeGalleryImages(content, args.images, !!args._replace_items);
+            }
+        }
+        return { request: this.request, model };
+    }
+}

package/lib/src/metadata-builder/builders/section-builders/image-section-builder.d.ts

@@ -0,0 +1,6 @@
+import type { ImageContent, BrandPageModel } from '../../../brand-page/models';
+import type { BuilderResult } from '../../models';
+import { BaseSectionBuilder } from './base-section-builder';
+export declare class ImageSectionBuilder extends BaseSectionBuilder<ImageContent> {
+    buildAsync(model: BrandPageModel): Promise<BuilderResult>;
+}

package/lib/src/metadata-builder/builders/section-builders/image-section-builder.js

@@ -0,0 +1,16 @@
+import { applyScalarFields } from '../section-field-utils';
+import { BaseSectionBuilder } from './base-section-builder';
+export class ImageSectionBuilder extends BaseSectionBuilder {
+    async buildAsync(model) {
+        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/lib/src/metadata-builder/builders/section-builders/images-section-builder.d.ts

@@ -0,0 +1,6 @@
+import type { ImagesSectionContent, BrandPageModel } from '../../../brand-page/models';
+import type { BuilderResult } from '../../models';
+import { BaseSectionBuilder } from './base-section-builder';
+export declare class ImagesSectionBuilder extends BaseSectionBuilder<ImagesSectionContent> {
+    buildAsync(model: BrandPageModel): Promise<BuilderResult>;
+}

package/lib/src/metadata-builder/builders/section-builders/images-section-builder.js

@@ -0,0 +1,158 @@
+import { applyScalarFields, applyStyleFields, applyRTEStyles, } from '../section-field-utils';
+import { BaseSectionBuilder } from './base-section-builder';
+const applyImageItems = (content, items) => {
+    content.items = items
+        .filter((item) => !!item.image_url)
+        .map((item, index) => ({
+        imageUrl: item.image_url || '',
+        imageTitle: '',
+        width: 0,
+        height: 0,
+        mediaType: 'image',
+        imageLink: '',
+        title: item.heading || '',
+        paragraph: item.text || '',
+        itemsId: index,
+        colorReplacements: [],
+    }));
+};
+const mergeImageItems = (content, items, replaceAll) => {
+    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.image_url !== undefined)
+                existing.imageUrl = item.image_url;
+            if (item.heading !== undefined)
+                existing.title = item.heading;
+            if (item.text !== undefined)
+                existing.paragraph = item.text;
+        }
+        return;
+    }
+    const updatedItems = items
+        .map((item, index) => {
+        const existing = content.items?.[index];
+        return {
+            ...(existing || {}),
+            imageUrl: item.image_url ?? existing?.imageUrl ?? '',
+            imageTitle: existing?.imageTitle ?? '',
+            width: existing?.width ?? 0,
+            height: existing?.height ?? 0,
+            mediaType: existing?.mediaType ?? 'image',
+            imageLink: existing?.imageLink ?? '',
+            title: item.heading ?? existing?.title ?? '',
+            paragraph: item.text ?? existing?.paragraph ?? '',
+            itemsId: existing?.itemsId ?? index,
+            colorReplacements: existing?.colorReplacements ?? [],
+        };
+    })
+        .filter((item) => !!item.imageUrl);
+    if (!replaceAll && content.items && content.items.length > items.length) {
+        const remaining = content.items.slice(items.length);
+        updatedItems.push(...remaining);
+    }
+    content.items = updatedItems;
+};
+export class ImagesSectionBuilder extends BaseSectionBuilder {
+    async buildAsync(model) {
+        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;
+        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') {
+                applyImageItems(content, args.items);
+            }
+            else {
+                mergeImageItems(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) {
+                if (!item.image_url)
+                    continue;
+                const pos = Math.max(0, Math.min(item.insert_at ?? 0, content.items?.length ?? 0));
+                const newItem = {
+                    imageUrl: item.image_url,
+                    imageTitle: '',
+                    width: 0,
+                    height: 0,
+                    mediaType: 'image',
+                    imageLink: '',
+                    title: item.heading ?? '',
+                    paragraph: item.text ?? '',
+                    itemsId: pos,
+                    colorReplacements: [],
+                };
+                content.items = content.items ?? [];
+                content.items.splice(pos, 0, newItem);
+            }
+        }
+        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/lib/src/metadata-builder/builders/section-builders/index.d.ts

@@ -0,0 +1,17 @@
+export { BaseSectionBuilder, type SectionBuilderPayload, } from './base-section-builder';
+export { BannerSectionBuilder } from './banner-section-builder';
+export { AboutSectionBuilder } from './about-section-builder';
+export { ContactFormBuilder } from './contact-form-builder';
+export { DividerSectionBuilder } from './divider-section-builder';
+export { TextSectionBuilder } from './text-section-builder';
+export { TestimonialSectionBuilder } from './testimonial-section-builder';
+export { ImagesSectionBuilder } from './images-section-builder';
+export { ShapesSectionBuilder } from './shapes-section-builder';
+export { SocialLinksBuilder } from './social-links-builder';
+export { ImageGalleryBuilder } from './image-gallery-builder';
+export { ProfileSectionBuilder } from './profile-section-builder';
+export { MailingListSectionBuilder } from './mailing-list-section-builder';
+export { ImageSectionBuilder } from './image-section-builder';
+export { ButtonSectionBuilder } from './button-section-builder';
+export { DeleteSectionBuilder } from './delete-section-builder';
+export { MoveSectionBuilder } from './move-section-builder';

package/lib/src/metadata-builder/builders/section-builders/index.js

@@ -0,0 +1,17 @@
+export { BaseSectionBuilder, } from './base-section-builder';
+export { BannerSectionBuilder } from './banner-section-builder';
+export { AboutSectionBuilder } from './about-section-builder';
+export { ContactFormBuilder } from './contact-form-builder';
+export { DividerSectionBuilder } from './divider-section-builder';
+export { TextSectionBuilder } from './text-section-builder';
+export { TestimonialSectionBuilder } from './testimonial-section-builder';
+export { ImagesSectionBuilder } from './images-section-builder';
+export { ShapesSectionBuilder } from './shapes-section-builder';
+export { SocialLinksBuilder } from './social-links-builder';
+export { ImageGalleryBuilder } from './image-gallery-builder';
+export { ProfileSectionBuilder } from './profile-section-builder';
+export { MailingListSectionBuilder } from './mailing-list-section-builder';
+export { ImageSectionBuilder } from './image-section-builder';
+export { ButtonSectionBuilder } from './button-section-builder';
+export { DeleteSectionBuilder } from './delete-section-builder';
+export { MoveSectionBuilder } from './move-section-builder';

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

@@ -0,0 +1,6 @@
+import type { BuilderResult } from '@src/metadata-builder/models';
+import type { BrandPageModel, MailingListContent } from '../../../brand-page/models';
+import { BaseSectionBuilder } from './base-section-builder';
+export declare class MailingListBuilder extends BaseSectionBuilder<MailingListContent> {
+    buildAsync(model: BrandPageModel): Promise<BuilderResult>;
+}

package/lib/src/metadata-builder/builders/section-builders/mailing-list-builder.js

@@ -0,0 +1,17 @@
+import { applyScalarFields } from '../section-field-utils';
+import { BaseSectionBuilder } from './base-section-builder';
+export class MailingListBuilder extends BaseSectionBuilder {
+    async buildAsync(model) {
+        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/lib/src/metadata-builder/builders/section-builders/mailing-list-section-builder.d.ts

@@ -0,0 +1,6 @@
+import type { MailingListContent, BrandPageModel } from '../../../brand-page/models';
+import type { BuilderResult } from '../../models';
+import { BaseSectionBuilder } from './base-section-builder';
+export declare class MailingListSectionBuilder extends BaseSectionBuilder<MailingListContent> {
+    buildAsync(model: BrandPageModel): Promise<BuilderResult>;
+}

package/lib/src/metadata-builder/builders/section-builders/mailing-list-section-builder.js

@@ -0,0 +1,16 @@
+import { applyScalarFields } from '../section-field-utils';
+import { BaseSectionBuilder } from './base-section-builder';
+export class MailingListSectionBuilder extends BaseSectionBuilder {
+    async buildAsync(model) {
+        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/lib/src/metadata-builder/builders/section-builders/move-section-builder.d.ts

@@ -0,0 +1,15 @@
+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 declare class MoveSectionBuilder extends BaseMetadataBuilder<MoveSectionPayload> {
+    constructor(request: MetadataBuilderRequest<MoveSectionPayload>, logger?: Logger);
+    validateAsync(): Promise<{
+        errors: string[];
+    }>;
+    buildAsync(model: BrandPageModel): Promise<BuilderResult>;
+}

package/lib/src/metadata-builder/builders/section-builders/move-section-builder.js

@@ -0,0 +1,62 @@
+import { BaseMetadataBuilder, } from '../../models';
+export class MoveSectionBuilder extends BaseMetadataBuilder {
+    constructor(request, logger) {
+        super(request, logger);
+    }
+    async validateAsync() {
+        const errors = [];
+        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) {
+        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/lib/src/metadata-builder/builders/section-builders/profile-section-builder.d.ts

@@ -0,0 +1,6 @@
+import type { ProfileContent, BrandPageModel } from '../../../brand-page/models';
+import type { BuilderResult } from '../../models';
+import { BaseSectionBuilder } from './base-section-builder';
+export declare class ProfileSectionBuilder extends BaseSectionBuilder<ProfileContent> {
+    buildAsync(model: BrandPageModel): Promise<BuilderResult>;
+}

package/lib/src/metadata-builder/builders/section-builders/profile-section-builder.js

@@ -0,0 +1,16 @@
+import { applyScalarFields } from '../section-field-utils';
+import { BaseSectionBuilder } from './base-section-builder';
+export class ProfileSectionBuilder extends BaseSectionBuilder {
+    async buildAsync(model) {
+        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/lib/src/metadata-builder/builders/section-builders/shapes-section-builder.d.ts

@@ -0,0 +1,6 @@
+import type { ShapesSectionContent, BrandPageModel } from '../../../brand-page/models';
+import type { BuilderResult } from '../../models';
+import { BaseSectionBuilder } from './base-section-builder';
+export declare class ShapesSectionBuilder extends BaseSectionBuilder<ShapesSectionContent> {
+    buildAsync(model: BrandPageModel): Promise<BuilderResult>;
+}

package/lib/src/metadata-builder/builders/section-builders/shapes-section-builder.js

@@ -0,0 +1,162 @@
+import { applyScalarFields, applyStyleFields, applyRTEStyles, } from '../section-field-utils';
+import { BaseSectionBuilder } from './base-section-builder';
+const applyShapeItems = (content, items) => {
+    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, items, replaceAll) => {
+    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.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);
+        updatedItems.push(...remaining);
+    }
+    content.items = updatedItems;
+};
+export class ShapesSectionBuilder extends BaseSectionBuilder {
+    async buildAsync(model) {
+        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;
+        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);
+            }
+        }
+        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/lib/src/metadata-builder/builders/section-builders/social-links-builder.d.ts

@@ -0,0 +1,6 @@
+import type { SocialLinksContent, BrandPageModel } from '../../../brand-page/models';
+import type { BuilderResult } from '../../models';
+import { BaseSectionBuilder } from './base-section-builder';
+export declare class SocialLinksBuilder extends BaseSectionBuilder<SocialLinksContent> {
+    buildAsync(model: BrandPageModel): Promise<BuilderResult>;
+}