@mohasinac/appkit 2.2.0 → 2.3.0

package/dist/features/homepage/repository/homepage-sections.repository.js

@@ -1,174 +0,0 @@
-/**
- * Homepage Sections Repository
- *
- * Manages homepage section configuration and ordering.
- */
-import { DatabaseError } from "../../../errors";
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
-import { HOMEPAGE_SECTIONS_COLLECTION, createHomepageSectionId, } from "../schemas";
-export class HomepageSectionsRepository extends BaseRepository {
-    constructor() {
-        super(HOMEPAGE_SECTIONS_COLLECTION);
-    }
-    async list(model) {
-        return this.sieveQuery(model, HomepageSectionsRepository.SIEVE_FIELDS, { defaultPageSize: 50, maxPageSize: 200 });
-    }
-    async create(input) {
-        const id = createHomepageSectionId(input.type);
-        const sectionData = {
-            ...input,
-            createdAt: new Date(),
-            updatedAt: new Date(),
-        };
-        await this.db
-            .collection(this.collection)
-            .doc(id)
-            .set(prepareForFirestore(sectionData));
-        return { id, ...sectionData };
-    }
-    async getEnabledSections() {
-        try {
-            const snapshot = await this.db
-                .collection(this.collection)
-                .where("enabled", "==", true)
-                .orderBy("order", "asc")
-                .get();
-            return snapshot.docs.map((doc) => this.mapDoc(doc));
-        }
-        catch (error) {
-            throw new DatabaseError(`Failed to retrieve enabled sections: ${error instanceof Error ? error.message : "Unknown error"}`);
-        }
-    }
-    async getDisabledSections() {
-        try {
-            const snapshot = await this.db
-                .collection(this.collection)
-                .where("enabled", "==", false)
-                .orderBy("order", "asc")
-                .get();
-            return snapshot.docs.map((doc) => this.mapDoc(doc));
-        }
-        catch (error) {
-            throw new DatabaseError(`Failed to retrieve disabled sections: ${error instanceof Error ? error.message : "Unknown error"}`);
-        }
-    }
-    async getSectionByType(type) {
-        try {
-            const snapshot = await this.db
-                .collection(this.collection)
-                .where("type", "==", type)
-                .limit(1)
-                .get();
-            if (snapshot.empty)
-                return null;
-            const doc = snapshot.docs[0];
-            return this.mapDoc(doc);
-        }
-        catch (error) {
-            throw new DatabaseError(`Failed to retrieve section by type: ${error instanceof Error ? error.message : "Unknown error"}`);
-        }
-    }
-    async enableSection(sectionId) {
-        try {
-            await this.db.collection(this.collection).doc(sectionId).update({
-                enabled: true,
-                updatedAt: new Date(),
-            });
-            return await this.findByIdOrFail(sectionId);
-        }
-        catch (error) {
-            throw new DatabaseError(`Failed to enable section: ${error instanceof Error ? error.message : "Unknown error"}`);
-        }
-    }
-    async disableSection(sectionId) {
-        try {
-            await this.db.collection(this.collection).doc(sectionId).update({
-                enabled: false,
-                updatedAt: new Date(),
-            });
-            return await this.findByIdOrFail(sectionId);
-        }
-        catch (error) {
-            throw new DatabaseError(`Failed to disable section: ${error instanceof Error ? error.message : "Unknown error"}`);
-        }
-    }
-    async toggleSection(sectionId) {
-        try {
-            const section = await this.findByIdOrFail(sectionId);
-            await this.db.collection(this.collection).doc(sectionId).update({
-                enabled: !section.enabled,
-                updatedAt: new Date(),
-            });
-            return await this.findByIdOrFail(sectionId);
-        }
-        catch (error) {
-            throw new DatabaseError(`Failed to toggle section: ${error instanceof Error ? error.message : "Unknown error"}`);
-        }
-    }
-    async reorderSections(sectionOrders) {
-        try {
-            const batch = this.db.batch();
-            const now = new Date();
-            for (const { id, order } of sectionOrders) {
-                const ref = this.db.collection(this.collection).doc(id);
-                batch.update(ref, {
-                    order,
-                    updatedAt: now,
-                });
-            }
-            await batch.commit();
-        }
-        catch (error) {
-            throw new DatabaseError(`Failed to reorder sections: ${error instanceof Error ? error.message : "Unknown error"}`);
-        }
-    }
-    async updateSectionConfig(sectionId, config) {
-        try {
-            await this.db.collection(this.collection).doc(sectionId).update({
-                config,
-                updatedAt: new Date(),
-            });
-            return await this.findByIdOrFail(sectionId);
-        }
-        catch (error) {
-            throw new DatabaseError(`Failed to update section config: ${error instanceof Error ? error.message : "Unknown error"}`);
-        }
-    }
-    async batchToggleSections(sectionIds, enabled) {
-        try {
-            const batch = this.db.batch();
-            const now = new Date();
-            for (const id of sectionIds) {
-                const ref = this.db.collection(this.collection).doc(id);
-                batch.update(ref, {
-                    enabled,
-                    updatedAt: now,
-                });
-            }
-            await batch.commit();
-        }
-        catch (error) {
-            throw new DatabaseError(`Failed to batch toggle sections: ${error instanceof Error ? error.message : "Unknown error"}`);
-        }
-    }
-    async resetSectionToDefault(sectionId, defaultConfig) {
-        try {
-            await this.db.collection(this.collection).doc(sectionId).update({
-                config: defaultConfig,
-                updatedAt: new Date(),
-            });
-            return await this.findByIdOrFail(sectionId);
-        }
-        catch (error) {
-            throw new DatabaseError(`Failed to reset section: ${error instanceof Error ? error.message : "Unknown error"}`);
-        }
-    }
-}
-HomepageSectionsRepository.SIEVE_FIELDS = {
-    type: { canFilter: true, canSort: false },
-    enabled: { canFilter: true, canSort: false },
-    order: { canFilter: true, canSort: true },
-    createdAt: { canFilter: true, canSort: true },
-    updatedAt: { canFilter: true, canSort: true },
-};
-export const homepageSectionsRepository = new HomepageSectionsRepository();

package/dist/features/homepage/repository/homepage.repository.d.ts

@@ -1,11 +0,0 @@
-import type { IRepository, PagedResult, SieveQuery } from "../../../contracts";
-import type { HomepageSection } from "../types";
-export declare class HomepageSectionsRepository {
-    private readonly repo;
-    constructor(repo: IRepository<HomepageSection>);
-    findAll(query?: SieveQuery): Promise<PagedResult<HomepageSection>>;
-    findById(id: string): Promise<HomepageSection | null>;
-    create(data: Omit<HomepageSection, "id">): Promise<HomepageSection>;
-    update(id: string, data: Partial<HomepageSection>): Promise<HomepageSection>;
-    delete(id: string): Promise<void>;
-}

package/dist/features/homepage/repository/homepage.repository.js

@@ -1,25 +0,0 @@
-export class HomepageSectionsRepository {
-    constructor(repo) {
-        this.repo = repo;
-    }
-    async findAll(query) {
-        return this.repo.findAll({
-            filters: "isVisible==true",
-            sort: "order",
-            perPage: 50,
-            ...query,
-        });
-    }
-    async findById(id) {
-        return this.repo.findById(id);
-    }
-    async create(data) {
-        return this.repo.create(data);
-    }
-    async update(id, data) {
-        return this.repo.update(id, data);
-    }
-    async delete(id) {
-        return this.repo.delete(id);
-    }
-}

package/dist/features/homepage/schemas/firestore.d.ts

@@ -1,251 +0,0 @@
-/**
- * Homepage Feature Firestore Document Types & Constants
- * Covers: carousel slides, homepage sections
- */
-export interface GridCard {
-    id: string;
-    gridRow: 1 | 2;
-    gridCol: 1 | 2 | 3;
-    background: {
-        type: "color" | "gradient" | "image" | "video";
-        value: string;
-        overlay?: {
-            enabled: boolean;
-            color: string;
-            opacity: number;
-        };
-    };
-    content?: {
-        title?: string;
-        subtitle?: string;
-        description?: string;
-        textColor?: string;
-    };
-    buttons?: Array<{
-        id?: string;
-        text: string;
-        link: string;
-        variant: "primary" | "secondary" | "outline";
-        openInNewTab: boolean;
-    }>;
-    isButtonOnly: boolean;
-    sizing?: {
-        width?: "auto" | "full" | "1/2" | "1/3" | "2/3";
-        height?: "auto" | "full" | "sm" | "md" | "lg";
-    };
-}
-export type GridCardCreateInput = Omit<GridCard, "id">;
-export interface CarouselSlideDocument {
-    id: string;
-    title: string;
-    order: number;
-    active: boolean;
-    media: {
-        type: "image" | "video";
-        url: string;
-        alt?: string;
-        thumbnail?: string;
-    };
-    link?: {
-        url: string;
-        openInNewTab: boolean;
-    };
-    mobileMedia?: {
-        type: "image" | "video";
-        url: string;
-        alt?: string;
-    };
-    cards: GridCard[];
-    overlay?: {
-        /** Visual overlay — dims the background image */
-        enabled?: boolean;
-        color?: string;
-        opacity?: number;
-        /** Content overlay — text and CTA layered over the slide */
-        title?: string;
-        subtitle?: string;
-        description?: string;
-        button?: {
-            id?: string;
-            text: string;
-            link: string;
-            variant: "primary" | "secondary" | "outline";
-            openInNewTab: boolean;
-        };
-    };
-    analytics?: {
-        views: number;
-        lastViewed?: Date;
-    };
-    createdAt: Date;
-    updatedAt: Date;
-    createdBy: string;
-}
-export declare const CAROUSEL_SLIDES_COLLECTION: "carouselSlides";
-export declare const CAROUSEL_SLIDES_INDEXED_FIELDS: readonly ["active", "order", "createdBy", "createdAt"];
-export declare const MAX_ACTIVE_SLIDES: 5;
-export declare const GRID_CONFIG: {
-    readonly rows: 2;
-    readonly cols: 3;
-};
-export declare const DEFAULT_CAROUSEL_SLIDE_DATA: Partial<CarouselSlideDocument>;
-export declare const CAROUSEL_SLIDES_PUBLIC_FIELDS: readonly ["id", "title", "order", "active", "media", "link", "mobileMedia", "cards", "overlay"];
-export type CarouselSlideCreateInput = Omit<CarouselSlideDocument, "id" | "createdAt" | "updatedAt">;
-export type CarouselSlideUpdateInput = Partial<Pick<CarouselSlideDocument, "title" | "order" | "active" | "media" | "link" | "mobileMedia" | "cards">>;
-export declare const carouselSlideQueryHelpers: {
-    readonly active: () => readonly ["active", "==", true];
-    readonly inactive: () => readonly ["active", "==", false];
-    readonly byCreator: (userId: string) => readonly ["createdBy", "==", string];
-};
-export declare function createCarouselId(title: string): string;
-export declare function isValidGridPosition(gridRow: number, gridCol: number): boolean;
-export declare function canActivateSlide(currentActiveCount: number): boolean;
-export interface WelcomeSectionConfig {
-    h1: string;
-    subtitle: string;
-    description: string;
-    showCTA: boolean;
-    ctaText?: string;
-    ctaLink?: string;
-}
-export interface TrustIndicatorsSectionConfig {
-    title: string;
-    indicators: Array<{
-        id: string;
-        icon: string;
-        title: string;
-        description: string;
-    }>;
-}
-export interface CategoriesSectionConfig {
-    title: string;
-    maxCategories: 4;
-    autoScroll: boolean;
-    scrollInterval: number;
-}
-export interface BrandsSectionConfig {
-    title: string;
-    subtitle?: string;
-    maxBrands: number;
-    autoScroll: boolean;
-    scrollInterval: number;
-}
-export interface ProductsSectionConfig {
-    title: string;
-    subtitle?: string;
-    maxProducts: 18;
-    rows: 2;
-    itemsPerRow: 3;
-    mobileItemsPerRow: 1;
-    autoScroll: boolean;
-    scrollInterval: number;
-}
-export interface AuctionsSectionConfig {
-    title: string;
-    subtitle?: string;
-    maxAuctions: 18;
-    rows: 2;
-    itemsPerRow: 3;
-    mobileItemsPerRow: 1;
-    autoScroll: boolean;
-    scrollInterval: number;
-}
-export interface ReviewsSectionConfig {
-    title: string;
-    maxReviews: 18;
-    itemsPerView: 3;
-    mobileItemsPerView: 1;
-    autoScroll: boolean;
-    scrollInterval: number;
-}
-export interface WhatsAppCommunitySectionConfig {
-    title: string;
-    description: string;
-    groupLink: string;
-    memberCount?: number;
-    benefits: string[];
-    buttonText: string;
-    testimonial?: string;
-}
-export interface FeaturesSectionConfig {
-    title: string;
-    features: string[];
-}
-export interface FAQSectionConfig {
-    title: string;
-    subtitle?: string;
-    showOnHomepage: boolean;
-    displayCount: number;
-    expandedByDefault: boolean;
-    linkToFullPage: boolean;
-    categories: Array<"general" | "shipping" | "returns" | "payment" | "account" | "products" | "sellers">;
-}
-export interface BlogArticlesSectionConfig {
-    title: string;
-    maxArticles: 4;
-    showReadTime: boolean;
-    showAuthor: boolean;
-    showThumbnails: boolean;
-}
-export interface NewsletterSectionConfig {
-    title: string;
-    description: string;
-    placeholder: string;
-    buttonText: string;
-    privacyText: string;
-    privacyLink: string;
-}
-export interface StoresSectionConfig {
-    title: string;
-    subtitle?: string;
-    maxStores: number;
-    autoScroll: boolean;
-    scrollInterval: number;
-}
-export interface EventsSectionConfig {
-    title: string;
-    subtitle?: string;
-    maxEvents: number;
-    autoScroll: boolean;
-    scrollInterval: number;
-}
-export interface BannerSectionConfig {
-    height: "sm" | "md" | "lg" | "xl";
-    backgroundImage?: string;
-    backgroundColor?: string;
-    gradient?: string;
-    content: {
-        title: string;
-        subtitle?: string;
-        description?: string;
-    };
-    buttons: Array<{
-        text: string;
-        link: string;
-        variant: "primary" | "secondary" | "outline";
-    }>;
-    clickable: boolean;
-    clickLink?: string;
-}
-export type SectionType = "welcome" | "trust-indicators" | "categories" | "brands" | "products" | "auctions" | "banner" | "features" | "reviews" | "whatsapp-community" | "faq" | "blog-articles" | "newsletter" | "stores" | "events";
-export type SectionConfig = WelcomeSectionConfig | TrustIndicatorsSectionConfig | CategoriesSectionConfig | BrandsSectionConfig | ProductsSectionConfig | AuctionsSectionConfig | BannerSectionConfig | FeaturesSectionConfig | ReviewsSectionConfig | WhatsAppCommunitySectionConfig | FAQSectionConfig | BlogArticlesSectionConfig | NewsletterSectionConfig | StoresSectionConfig | EventsSectionConfig;
-export interface HomepageSectionDocument {
-    id: string;
-    type: SectionType;
-    order: number;
-    enabled: boolean;
-    config: SectionConfig;
-    createdAt: Date;
-    updatedAt: Date;
-}
-export declare const HOMEPAGE_SECTIONS_COLLECTION: "homepageSections";
-export declare const HOMEPAGE_SECTIONS_INDEXED_FIELDS: readonly ["enabled", "order", "type"];
-export declare const DEFAULT_SECTION_ORDER: Record<SectionType, number>;
-export declare const BANNER_HEIGHTS: Record<BannerSectionConfig["height"], string>;
-export type HomepageSectionCreateInput = Omit<HomepageSectionDocument, "id" | "createdAt" | "updatedAt">;
-export type HomepageSectionUpdateInput = Partial<Pick<HomepageSectionDocument, "order" | "enabled" | "config">>;
-export declare const homepageSectionQueryHelpers: {
-    readonly enabled: () => readonly ["enabled", "==", true];
-    readonly byType: (type: SectionType) => readonly ["type", "==", SectionType];
-};
-export declare function createHomepageSectionId(type: SectionType): string;

package/dist/features/homepage/schemas/firestore.js

@@ -1,83 +0,0 @@
-/**
- * Homepage Feature Firestore Document Types & Constants
- * Covers: carousel slides, homepage sections
- */
-import { generateCarouselId, generateHomepageSectionId, } from "../../../utils/id-generators";
-export const CAROUSEL_SLIDES_COLLECTION = "carouselSlides";
-export const CAROUSEL_SLIDES_INDEXED_FIELDS = [
-    "active",
-    "order",
-    "createdBy",
-    "createdAt",
-];
-export const MAX_ACTIVE_SLIDES = 5;
-export const GRID_CONFIG = { rows: 2, cols: 3 };
-export const DEFAULT_CAROUSEL_SLIDE_DATA = {
-    active: false,
-    order: 0,
-    cards: [],
-};
-export const CAROUSEL_SLIDES_PUBLIC_FIELDS = [
-    "id",
-    "title",
-    "order",
-    "active",
-    "media",
-    "link",
-    "mobileMedia",
-    "cards",
-    "overlay",
-];
-export const carouselSlideQueryHelpers = {
-    active: () => ["active", "==", true],
-    inactive: () => ["active", "==", false],
-    byCreator: (userId) => ["createdBy", "==", userId],
-};
-export function createCarouselId(title) {
-    return generateCarouselId({ title });
-}
-export function isValidGridPosition(gridRow, gridCol) {
-    return (gridRow >= 1 &&
-        gridRow <= GRID_CONFIG.rows &&
-        gridCol >= 1 &&
-        gridCol <= GRID_CONFIG.cols);
-}
-export function canActivateSlide(currentActiveCount) {
-    return currentActiveCount < MAX_ACTIVE_SLIDES;
-}
-export const HOMEPAGE_SECTIONS_COLLECTION = "homepageSections";
-export const HOMEPAGE_SECTIONS_INDEXED_FIELDS = [
-    "enabled",
-    "order",
-    "type",
-];
-export const DEFAULT_SECTION_ORDER = {
-    welcome: 1,
-    "trust-indicators": 3,
-    categories: 2,
-    brands: 2,
-    products: 4,
-    auctions: 5,
-    banner: 4,
-    features: 5,
-    reviews: 6,
-    "whatsapp-community": 6,
-    faq: 4,
-    "blog-articles": 5,
-    newsletter: 6,
-    stores: 7,
-    events: 8,
-};
-export const BANNER_HEIGHTS = {
-    sm: "200px",
-    md: "300px",
-    lg: "400px",
-    xl: "500px",
-};
-export const homepageSectionQueryHelpers = {
-    enabled: () => ["enabled", "==", true],
-    byType: (type) => ["type", "==", type],
-};
-export function createHomepageSectionId(type) {
-    return generateHomepageSectionId({ type });
-}

package/dist/features/homepage/schemas/index.d.ts

@@ -1 +0,0 @@
-export * from "./firestore";

package/dist/features/homepage/schemas/index.js

@@ -1 +0,0 @@
-export * from "./firestore";

package/dist/features/homepage/server.d.ts

@@ -1,10 +0,0 @@
-import "server-only";
-export * from "./actions";
-export { HomepageSectionsRepository } from "./repository/homepage.repository";
-export { carouselRepository } from "./repository/carousel.repository";
-export { homepageSectionsRepository } from "./repository/homepage-sections.repository";
-export { manifest } from "./manifest";
-export { GET as homepageGET, GET, POST } from "./api/route";
-export { homepageSectionItemGET, homepageSectionItemPATCH, homepageSectionItemDELETE, } from "./api/[id]/route";
-export { carouselGET, carouselPOST } from "./api/carousel/route";
-export { carouselItemGET, carouselItemPATCH, carouselItemDELETE, } from "./api/carousel/[id]/route";

package/dist/features/homepage/server.js

@@ -1,10 +0,0 @@
-import "server-only";
-export * from "./actions";
-export { HomepageSectionsRepository } from "./repository/homepage.repository";
-export { carouselRepository } from "./repository/carousel.repository";
-export { homepageSectionsRepository } from "./repository/homepage-sections.repository";
-export { manifest } from "./manifest";
-export { GET as homepageGET, GET, POST } from "./api/route";
-export { homepageSectionItemGET, homepageSectionItemPATCH, homepageSectionItemDELETE, } from "./api/[id]/route";
-export { carouselGET, carouselPOST } from "./api/carousel/route";
-export { carouselItemGET, carouselItemPATCH, carouselItemDELETE, } from "./api/carousel/[id]/route";