@mohasinac/appkit 2.7.50 → 2.7.53

package/dist/index.d.ts

@@ -554,6 +554,7 @@ export type { ProductTemplateDocument, ProductTemplateCreateInput, ProductTempla
 export { tokenRepository } from "./repositories/index";
 export { userRepository } from "./repositories/index";
 export { wishlistRepository } from "./repositories/index";
+export { GroupedListingsRepository, groupedListingsRepository } from "./repositories/index";
 export type { NewsletterListModel } from "./repositories/index";
 export type { WishlistItem } from "./repositories/index";
 export { ADDRESS_FIXTURES } from "./seed/index";
@@ -1558,7 +1559,6 @@ export { CATEGORY_FIELDS } from "./features/categories/index";
 export { CATEGORY_FILTER_KEYS } from "./features/categories/index";
 export { CATEGORY_PUBLIC_SORT_OPTIONS } from "./features/categories/index";
 export { CATEGORY_SELLER_SORT_OPTIONS } from "./features/categories/index";
-export { CategoriesListView } from "./features/categories/index";
 export { CategoryCard } from "./features/categories/index";
 export { CategoryFilters } from "./features/categories/index";
 export { CategoryForm } from "./features/categories/index";
@@ -1600,7 +1600,6 @@ export { useCategoryDetail } from "./features/categories/index";
 export { useCategorySelector } from "./features/categories/index";
 export { useCreateCategory } from "./features/categories/index";
 export type { BreadcrumbTrailProps } from "./features/categories/index";
-export type { CategoriesListViewProps } from "./features/categories/index";
 export type { CategoriesResponse } from "./features/categories/index";
 export type { Category } from "./features/categories/index";
 export type { CategoryAncestor } from "./features/categories/index";
@@ -2312,7 +2311,6 @@ export { BundleCollage } from "./features/categories/components/BundleCollage";
 export type { BundleCollageProps } from "./features/categories/components/BundleCollage";
 export { BundleBuyNowCta } from "./features/categories/components/BundleBuyNowCta";
 export type { BundleBuyNowCtaProps } from "./features/categories/components/BundleBuyNowCta";
-export { AuctionsView } from "./features/products/index";
 export { BidHistory } from "./features/products/index";
 export { BuyBar } from "./features/products/index";
 export { DEFAULT_PRODUCT_DATA } from "./features/products/index";
@@ -2343,7 +2341,6 @@ export { PRODUCT_STATUS_OPTIONS } from "./features/products/index";
 export { PRODUCT_UPDATABLE_FIELDS } from "./features/products/index";
 export { PlaceBidForm } from "./features/products/index";
 export { PreOrderDetailView } from "./features/products/index";
-export { PreOrdersView } from "./features/products/index";
 export type { PrizeDrawsListingViewProps } from "./features/products/components/PrizeDrawsListingView";
 export { PrizeDrawsIndexListing } from "./features/products/index";
 export type { PrizeDrawsIndexListingProps } from "./features/products/index";
@@ -2397,7 +2394,6 @@ export { useProductDetail } from "./features/products/index";
 export { useProducts } from "./features/products/index";
 export { useRelatedProducts } from "./features/products/index";
 export type { AuctionDetailViewProps } from "./features/products/index";
-export type { AuctionsViewProps } from "./features/products/index";
 export type { BidHistoryEntry } from "./features/products/index";
 export type { BidHistoryProps } from "./features/products/index";
 export type { BuyBarProps } from "./features/products/index";
@@ -2406,7 +2402,6 @@ export type { ListingType } from "./features/products/index";
 export type { MakeOfferFormProps } from "./features/products/index";
 export type { PlaceBidFormProps } from "./features/products/index";
 export type { PreOrderDetailViewProps } from "./features/products/index";
-export type { PreOrdersViewProps } from "./features/products/index";
 export type { ProductAdminUpdateInput } from "./features/products/index";
 export type { ProductCondition } from "./features/products/index";
 export type { ProductCreateInput } from "./features/products/index";
@@ -2531,7 +2526,6 @@ export { ReviewFilters } from "./features/reviews/index";
 export { ReviewStatusValues } from "./features/reviews/index";
 export { ReviewSummary } from "./features/reviews/index";
 export { ReviewsList } from "./features/reviews/index";
-export { ReviewsListView } from "./features/reviews/index";
 export type { ReviewDetailPageViewProps } from "./features/reviews/components/ReviewDetailPageView";
 export { ReviewsIndexListing } from "./features/reviews/components/ReviewsIndexListing";
 export type { ReviewsIndexListingProps } from "./features/reviews/components/ReviewsIndexListing";
@@ -2568,7 +2562,6 @@ export type { ReviewUpdateInput } from "./features/reviews/index";
 export type { ReviewVideo } from "./features/reviews/index";
 export type { ReviewVideoField } from "./features/reviews/index";
 export type { ReviewsListProps } from "./features/reviews/index";
-export type { ReviewsListViewProps } from "./features/reviews/index";
 export type { ViewReviewModalProps } from "./features/reviews/index";
 export { adminDeleteReview } from "./features/reviews/server";
 export { adminUpdateReview } from "./features/reviews/server";
@@ -2635,6 +2628,12 @@ export { SellerDashboardView } from "./features/seller/index";
 export { SellerEditProductView } from "./features/seller/index";
 export { SellerGuideView } from "./features/seller/index";
 export { SellerOffersView } from "./features/seller/index";
+export { SellerGroupedListingsView } from "./features/seller/index";
+export type { SellerGroupedListingsViewProps } from "./features/seller/index";
+export { SellerGroupedListingsView as StoreGroupedListingsView } from "./features/seller/index";
+export { SellerAnalyticsAlertsView } from "./features/seller/index";
+export type { SellerAnalyticsAlertsViewProps } from "./features/seller/index";
+export { SellerAnalyticsAlertsView as StoreAnalyticsAlertsView } from "./features/seller/index";
 export { SellerOffersPanel } from "./features/seller/index";
 export type { SellerOffersPanelProps, SellerOfferAction } from "./features/seller/index";
 export { SellerOrdersView } from "./features/seller/index";
@@ -2807,7 +2806,6 @@ export { StoreNavTabs } from "./features/stores/index";
 export { StoreProductsView } from "./features/stores/index";
 export { StoreReviewsView } from "./features/stores/index";
 export { StoreStatusValues } from "./features/stores/index";
-export { StoresListView } from "./features/stores/index";
 export { StoresIndexListing } from "./features/stores/index";
 export type { StoresIndexListingProps } from "./features/stores/index";
 export { StoreProductsListing } from "./features/stores/components/StoreProductsListing";
@@ -2819,6 +2817,33 @@ export type { StoreReviewsListingProps } from "./features/stores/components/Stor
 export { StoreReviewsPageView } from "./features/stores/components/StoreReviewsPageView";
 export type { StorePrizeDrawsPageViewProps } from "./features/stores/components/StorePrizeDrawsPageView";
 export type { StoreBundlesPageViewProps } from "./features/stores/components/StoreBundlesPageView";
+export { AdminGuideHubView } from "./features/admin/components/AdminGuideHubView";
+export type { AdminGuideHubViewProps } from "./features/admin/components/AdminGuideHubView";
+export { AdminUsersGuideView } from "./features/admin/components/AdminUsersGuideView";
+export { AdminCatalogGuideView } from "./features/admin/components/AdminCatalogGuideView";
+export { AdminStoresGuideView } from "./features/admin/components/AdminStoresGuideView";
+export { AdminOrdersGuideView } from "./features/admin/components/AdminOrdersGuideView";
+export { AdminContentGuideView } from "./features/admin/components/AdminContentGuideView";
+export { AdminSiteConfigGuideView } from "./features/admin/components/AdminSiteConfigGuideView";
+export { AdminTeamGuideView } from "./features/admin/components/AdminTeamGuideView";
+export { AdminAnalyticsGuideView } from "./features/admin/components/AdminAnalyticsGuideView";
+export { AdminTrustGuideView } from "./features/admin/components/AdminTrustGuideView";
+export { BuyerShoppingGuideView } from "./features/account/components/BuyerShoppingGuideView";
+export { BuyerAuctionsGuideView } from "./features/account/components/BuyerAuctionsGuideView";
+export { BuyerOrdersGuideView } from "./features/account/components/BuyerOrdersGuideView";
+export { BuyerAccountGuideView } from "./features/account/components/BuyerAccountGuideView";
+export { StoreGuideHubView } from "./features/stores/components/StoreGuideHubView";
+export type { StoreGuideHubViewProps } from "./features/stores/components/StoreGuideHubView";
+export { StoreListingsGuideView } from "./features/stores/components/StoreListingsGuideView";
+export type { StoreListingsGuideViewProps } from "./features/stores/components/StoreListingsGuideView";
+export { StoreOrdersGuideView } from "./features/stores/components/StoreOrdersGuideView";
+export type { StoreOrdersGuideViewProps } from "./features/stores/components/StoreOrdersGuideView";
+export { StoreFinanceGuideView } from "./features/stores/components/StoreFinanceGuideView";
+export type { StoreFinanceGuideViewProps } from "./features/stores/components/StoreFinanceGuideView";
+export { StoreCapabilitiesGuideView } from "./features/stores/components/StoreCapabilitiesGuideView";
+export type { StoreCapabilitiesGuideViewProps } from "./features/stores/components/StoreCapabilitiesGuideView";
+export { StoreSettingsGuideView } from "./features/stores/components/StoreSettingsGuideView";
+export type { StoreSettingsGuideViewProps } from "./features/stores/components/StoreSettingsGuideView";
 export { StorePreOrdersListing } from "./features/stores/components/StorePreOrdersListing";
 export type { StorePreOrdersListingProps } from "./features/stores/components/StorePreOrdersListing";
 export { buildStoreColumns } from "./features/stores/index";
@@ -3104,3 +3129,23 @@ export { getDigitalCodeForDetail } from "./_internal/server/features/digital-cod
 export { PRODUCT_CODES_SUBCOLLECTION } from "./features/products/schemas/firestore";
 export type { ProductCodeDocument } from "./features/products/schemas/firestore";
 export { getLiveItemForDetail } from "./_internal/server/features/live/data";
+export { MarketplaceBundleCard } from "./features/products/index";
+export type { MarketplaceBundleCardProps, MarketplaceBundleCardData, MarketplaceBundleCardLabels, } from "./features/products/index";
+export { SellerStoreCategoriesView } from "./features/seller/components/SellerStoreCategoriesView";
+export type { SellerStoreCategoriesViewProps } from "./features/seller/components/SellerStoreCategoriesView";
+export { SellerTemplatesView } from "./features/seller/components/SellerTemplatesView";
+export type { SellerTemplatesViewProps } from "./features/seller/components/SellerTemplatesView";
+export { SellerPayoutMethodsView } from "./features/seller/components/SellerPayoutMethodsView";
+export type { SellerPayoutMethodsViewProps } from "./features/seller/components/SellerPayoutMethodsView";
+export { SellerShippingConfigsView } from "./features/seller/components/SellerShippingConfigsView";
+export type { SellerShippingConfigsViewProps } from "./features/seller/components/SellerShippingConfigsView";
+export { SellerGoogleReviewsView } from "./features/seller/components/SellerGoogleReviewsView";
+export type { SellerGoogleReviewsViewProps } from "./features/seller/components/SellerGoogleReviewsView";
+export { SellerBundlesView } from "./features/seller/components/SellerBundlesView";
+export type { SellerBundlesViewProps } from "./features/seller/components/SellerBundlesView";
+export { SellerClassifiedView } from "./features/seller/components/SellerClassifiedView";
+export type { SellerClassifiedViewProps } from "./features/seller/components/SellerClassifiedView";
+export { SellerDigitalCodesView } from "./features/seller/components/SellerDigitalCodesView";
+export type { SellerDigitalCodesViewProps } from "./features/seller/components/SellerDigitalCodesView";
+export { SellerLiveView } from "./features/seller/components/SellerLiveView";
+export type { SellerLiveViewProps } from "./features/seller/components/SellerLiveView";

package/dist/index.js

@@ -1118,6 +1118,7 @@ export { userRepository } from "./repositories/index";
 // [DB]-Database layer â€" uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
 // wishlistRepository - Shared export for wishlist repository.
 export { wishlistRepository } from "./repositories/index";
+export { GroupedListingsRepository, groupedListingsRepository } from "./repositories/index";
 // ./seed/index
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // ADDRESS_FIXTURES - Constant used across modules.
@@ -2977,9 +2978,6 @@ export { CATEGORY_PUBLIC_SORT_OPTIONS } from "./features/categories/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // CATEGORY_SELLER_SORT_OPTIONS - Constant used across modules.
 export { CATEGORY_SELLER_SORT_OPTIONS } from "./features/categories/index";
-// [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
-// CategoriesListView - Component for categories list view.
-export { CategoriesListView } from "./features/categories/index";
 // [SERVER-RSC]-Self-fetching index/detail page views for categories.
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // CategoryCard - Component for category card.
@@ -4286,9 +4284,6 @@ export { BundleBuyNowCta } from "./features/categories/components/BundleBuyNowCt
 // CategoryBundlesListing is also re-exported lower in this file (line ~8871);
 // the canonical export lives there next to BUNDLE_MIN_ITEMS / BUNDLE_MAX_ITEMS.
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
-// AuctionsView - Component for auctions view.
-export { AuctionsView } from "./features/products/index";
-// [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // BidHistory - Shared export for bid history.
 export { BidHistory } from "./features/products/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
@@ -4352,9 +4347,6 @@ export { PlaceBidForm } from "./features/products/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // PreOrderDetailView - Component for pre order detail view.
 export { PreOrderDetailView } from "./features/products/index";
-// [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
-// PreOrdersView - Component for pre orders view.
-export { PreOrdersView } from "./features/products/index";
 // [CLIENT]-Client toolbar+grid for prize draws (SB4-F).
 export { PrizeDrawsIndexListing } from "./features/products/index";
 // [CLIENT]-Marketplace card for prize draws (SB4-F).
@@ -4681,9 +4673,6 @@ export { ReviewSummary } from "./features/reviews/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // ReviewsList - Shared export for reviews list.
 export { ReviewsList } from "./features/reviews/index";
-// [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
-// ReviewsListView - Component for reviews list view.
-export { ReviewsListView } from "./features/reviews/index";
 // ReviewsIndexListing - Client listing component with sort/filter/pagination.
 export { ReviewsIndexListing } from "./features/reviews/components/ReviewsIndexListing";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
@@ -4873,6 +4862,10 @@ export { SellerGuideView } from "./features/seller/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // SellerOffersView - Component for seller offers view.
 export { SellerOffersView } from "./features/seller/index";
+export { SellerGroupedListingsView } from "./features/seller/index";
+export { SellerGroupedListingsView as StoreGroupedListingsView } from "./features/seller/index";
+export { SellerAnalyticsAlertsView } from "./features/seller/index";
+export { SellerAnalyticsAlertsView as StoreAnalyticsAlertsView } from "./features/seller/index";
 // [CLIENT]-Runs in browser only â€" uses useState/useEffect/fetch.
 // SellerOffersPanel - Interactive panel with accept/decline/counter actions for seller offers.
 export { SellerOffersPanel } from "./features/seller/index";
@@ -5166,15 +5159,52 @@ export { StoreReviewsView } from "./features/stores/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // StoreStatusValues - Model for store status values.
 export { StoreStatusValues } from "./features/stores/index";
-// [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
-// StoresListView - Component for stores list view.
-export { StoresListView } from "./features/stores/index";
 // [SERVER-RSC] â€" Self-fetching RSC page views for store tab pages.
 export { StoresIndexListing } from "./features/stores/index";
 export { StoreProductsListing } from "./features/stores/components/StoreProductsListing";
 export { StoreAuctionsListing } from "./features/stores/components/StoreAuctionsListing";
 export { StoreReviewsListing } from "./features/stores/components/StoreReviewsListing";
 export { StoreReviewsPageView } from "./features/stores/components/StoreReviewsPageView";
+// [CLIENT-SSR]-Admin guide hub — static view, permission-aware card grid.
+export { AdminGuideHubView } from "./features/admin/components/AdminGuideHubView";
+// [CLIENT-SSR]-Admin users guide — static view, no firebase-admin.
+export { AdminUsersGuideView } from "./features/admin/components/AdminUsersGuideView";
+// [CLIENT-SSR]-Admin catalog guide — static view, no firebase-admin.
+export { AdminCatalogGuideView } from "./features/admin/components/AdminCatalogGuideView";
+// [CLIENT-SSR]-Admin stores guide — static view, no firebase-admin.
+export { AdminStoresGuideView } from "./features/admin/components/AdminStoresGuideView";
+// [CLIENT-SSR]-Admin orders guide — static view, no firebase-admin.
+export { AdminOrdersGuideView } from "./features/admin/components/AdminOrdersGuideView";
+// [CLIENT-SSR]-Admin content guide — static view, no firebase-admin.
+export { AdminContentGuideView } from "./features/admin/components/AdminContentGuideView";
+// [CLIENT-SSR]-Admin site config guide — static view, no firebase-admin.
+export { AdminSiteConfigGuideView } from "./features/admin/components/AdminSiteConfigGuideView";
+// [CLIENT-SSR]-Admin team guide — static view, no firebase-admin.
+export { AdminTeamGuideView } from "./features/admin/components/AdminTeamGuideView";
+// [CLIENT-SSR]-Admin analytics guide — static view, no firebase-admin.
+export { AdminAnalyticsGuideView } from "./features/admin/components/AdminAnalyticsGuideView";
+// [CLIENT-SSR]-Admin trust & safety guide — static view, no firebase-admin.
+export { AdminTrustGuideView } from "./features/admin/components/AdminTrustGuideView";
+// [CLIENT-SSR]-Buyer shopping guide — static view, no firebase-admin.
+export { BuyerShoppingGuideView } from "./features/account/components/BuyerShoppingGuideView";
+// [CLIENT-SSR]-Buyer auctions & pre-orders guide — static view, no firebase-admin.
+export { BuyerAuctionsGuideView } from "./features/account/components/BuyerAuctionsGuideView";
+// [CLIENT-SSR]-Buyer orders & returns guide — static view, no firebase-admin.
+export { BuyerOrdersGuideView } from "./features/account/components/BuyerOrdersGuideView";
+// [CLIENT-SSR]-Buyer account & safety guide — static view, no firebase-admin.
+export { BuyerAccountGuideView } from "./features/account/components/BuyerAccountGuideView";
+// [CLIENT-SSR]-Store seller guide hub — static view, no firebase-admin.
+export { StoreGuideHubView } from "./features/stores/components/StoreGuideHubView";
+// [CLIENT-SSR]-Store listings guide — static view, no firebase-admin.
+export { StoreListingsGuideView } from "./features/stores/components/StoreListingsGuideView";
+// [CLIENT-SSR]-Store orders guide — static view, no firebase-admin.
+export { StoreOrdersGuideView } from "./features/stores/components/StoreOrdersGuideView";
+// [CLIENT-SSR]-Store finance guide — static view, no firebase-admin.
+export { StoreFinanceGuideView } from "./features/stores/components/StoreFinanceGuideView";
+// [CLIENT-SSR]-Store capabilities guide — static view, no firebase-admin.
+export { StoreCapabilitiesGuideView } from "./features/stores/components/StoreCapabilitiesGuideView";
+// [CLIENT-SSR]-Store settings guide — static view, no firebase-admin.
+export { StoreSettingsGuideView } from "./features/stores/components/StoreSettingsGuideView";
 export { StorePreOrdersListing } from "./features/stores/components/StorePreOrdersListing";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // buildStoreColumns - Helper for build store columns.
@@ -5542,3 +5572,16 @@ export { getDigitalCodeForDetail } from "./_internal/server/features/digital-cod
 export { PRODUCT_CODES_SUBCOLLECTION } from "./features/products/schemas/firestore";
 // ── Live-item listing feature ─────────────────────────────────────────────────
 export { getLiveItemForDetail } from "./_internal/server/features/live/data";
+// ── MarketplaceBundleCard (W3) ────────────────────────────────────────────────
+export { MarketplaceBundleCard } from "./features/products/index";
+// ── Wave 4 Seller management views ───────────────────────────────────────────
+export { SellerStoreCategoriesView } from "./features/seller/components/SellerStoreCategoriesView";
+export { SellerTemplatesView } from "./features/seller/components/SellerTemplatesView";
+export { SellerPayoutMethodsView } from "./features/seller/components/SellerPayoutMethodsView";
+export { SellerShippingConfigsView } from "./features/seller/components/SellerShippingConfigsView";
+export { SellerGoogleReviewsView } from "./features/seller/components/SellerGoogleReviewsView";
+// ── Wave 5 listing-type views ─────────────────────────────────────────────────
+export { SellerBundlesView } from "./features/seller/components/SellerBundlesView";
+export { SellerClassifiedView } from "./features/seller/components/SellerClassifiedView";
+export { SellerDigitalCodesView } from "./features/seller/components/SellerDigitalCodesView";
+export { SellerLiveView } from "./features/seller/components/SellerLiveView";

package/dist/next/routing/route-map.d.ts

@@ -53,6 +53,10 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly CONTACT: "/contact";
         readonly BLOG: "/blog";
         readonly HELP: "/help";
+        readonly HELP_SHOPPING: "/help/shopping";
+        readonly HELP_AUCTIONS: "/help/auctions";
+        readonly HELP_ORDERS: "/help/orders";
+        readonly HELP_ACCOUNT: "/help/account";
         readonly TERMS: "/terms";
         readonly PRIVACY: "/privacy";
         readonly SECURITY: "/security";
@@ -199,6 +203,9 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly SHIPPING_CONFIGS_EDIT: (id: string) => string;
         readonly ANALYTICS_CARDS: "/store/analytics/cards";
         readonly ANALYTICS_ALERTS: "/store/analytics/alerts";
+        readonly GROUPED_LISTINGS: "/store/grouped-listings";
+        readonly GROUPED_LISTINGS_NEW: "/store/grouped-listings/new";
+        readonly GROUPED_LISTINGS_EDIT: (id: string) => string;
         readonly STORE_CATEGORIES: "/store/categories";
         readonly STORE_CATEGORIES_NEW: "/store/categories/new";
         readonly STORE_CATEGORIES_EDIT: (id: string) => string;
@@ -206,6 +213,12 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly LISTING_TEMPLATES_NEW: "/store/listing-templates/new";
         readonly LISTING_TEMPLATES_EDIT: (id: string) => string;
         readonly GOOGLE_REVIEWS: "/store/google-reviews";
+        readonly GUIDE: "/store/guide";
+        readonly GUIDE_LISTINGS: "/store/guide/listings";
+        readonly GUIDE_ORDERS: "/store/guide/orders";
+        readonly GUIDE_FINANCE: "/store/guide/finance";
+        readonly GUIDE_CAPABILITIES: "/store/guide/capabilities";
+        readonly GUIDE_SETTINGS: "/store/guide/settings";
     };
     readonly ADMIN: {
         readonly DASHBOARD: "/admin/dashboard";
@@ -298,6 +311,16 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly ROLES_EDIT: (id: string) => string;
         readonly PERMISSIONS: "/admin/permissions";
         readonly ADMIN_NOTIFICATIONS: "/admin/admin-notifications";
+        readonly GUIDE: "/admin/guide";
+        readonly GUIDE_USERS: "/admin/guide/users";
+        readonly GUIDE_CATALOG: "/admin/guide/catalog";
+        readonly GUIDE_STORES: "/admin/guide/stores";
+        readonly GUIDE_ORDERS: "/admin/guide/orders";
+        readonly GUIDE_CONTENT: "/admin/guide/content";
+        readonly GUIDE_SITE: "/admin/guide/site";
+        readonly GUIDE_TEAM: "/admin/guide/team";
+        readonly GUIDE_ANALYTICS: "/admin/guide/analytics";
+        readonly GUIDE_TRUST: "/admin/guide/trust";
     };
     readonly DEMO: {
         readonly SEED: "/demo/seed";
@@ -350,6 +373,10 @@ export declare const ROUTES: {
         readonly CONTACT: "/contact";
         readonly BLOG: "/blog";
         readonly HELP: "/help";
+        readonly HELP_SHOPPING: "/help/shopping";
+        readonly HELP_AUCTIONS: "/help/auctions";
+        readonly HELP_ORDERS: "/help/orders";
+        readonly HELP_ACCOUNT: "/help/account";
         readonly TERMS: "/terms";
         readonly PRIVACY: "/privacy";
         readonly SECURITY: "/security";
@@ -496,6 +523,9 @@ export declare const ROUTES: {
         readonly SHIPPING_CONFIGS_EDIT: (id: string) => string;
         readonly ANALYTICS_CARDS: "/store/analytics/cards";
         readonly ANALYTICS_ALERTS: "/store/analytics/alerts";
+        readonly GROUPED_LISTINGS: "/store/grouped-listings";
+        readonly GROUPED_LISTINGS_NEW: "/store/grouped-listings/new";
+        readonly GROUPED_LISTINGS_EDIT: (id: string) => string;
         readonly STORE_CATEGORIES: "/store/categories";
         readonly STORE_CATEGORIES_NEW: "/store/categories/new";
         readonly STORE_CATEGORIES_EDIT: (id: string) => string;
@@ -503,6 +533,12 @@ export declare const ROUTES: {
         readonly LISTING_TEMPLATES_NEW: "/store/listing-templates/new";
         readonly LISTING_TEMPLATES_EDIT: (id: string) => string;
         readonly GOOGLE_REVIEWS: "/store/google-reviews";
+        readonly GUIDE: "/store/guide";
+        readonly GUIDE_LISTINGS: "/store/guide/listings";
+        readonly GUIDE_ORDERS: "/store/guide/orders";
+        readonly GUIDE_FINANCE: "/store/guide/finance";
+        readonly GUIDE_CAPABILITIES: "/store/guide/capabilities";
+        readonly GUIDE_SETTINGS: "/store/guide/settings";
     };
     readonly ADMIN: {
         readonly DASHBOARD: "/admin/dashboard";
@@ -595,6 +631,16 @@ export declare const ROUTES: {
         readonly ROLES_EDIT: (id: string) => string;
         readonly PERMISSIONS: "/admin/permissions";
         readonly ADMIN_NOTIFICATIONS: "/admin/admin-notifications";
+        readonly GUIDE: "/admin/guide";
+        readonly GUIDE_USERS: "/admin/guide/users";
+        readonly GUIDE_CATALOG: "/admin/guide/catalog";
+        readonly GUIDE_STORES: "/admin/guide/stores";
+        readonly GUIDE_ORDERS: "/admin/guide/orders";
+        readonly GUIDE_CONTENT: "/admin/guide/content";
+        readonly GUIDE_SITE: "/admin/guide/site";
+        readonly GUIDE_TEAM: "/admin/guide/team";
+        readonly GUIDE_ANALYTICS: "/admin/guide/analytics";
+        readonly GUIDE_TRUST: "/admin/guide/trust";
     };
     readonly DEMO: {
         readonly SEED: "/demo/seed";
@@ -667,6 +713,9 @@ export declare const SELLER_ROUTES: {
     readonly SHIPPING_CONFIGS_EDIT: (id: string) => string;
     readonly ANALYTICS_CARDS: "/store/analytics/cards";
     readonly ANALYTICS_ALERTS: "/store/analytics/alerts";
+    readonly GROUPED_LISTINGS: "/store/grouped-listings";
+    readonly GROUPED_LISTINGS_NEW: "/store/grouped-listings/new";
+    readonly GROUPED_LISTINGS_EDIT: (id: string) => string;
     readonly STORE_CATEGORIES: "/store/categories";
     readonly STORE_CATEGORIES_NEW: "/store/categories/new";
     readonly STORE_CATEGORIES_EDIT: (id: string) => string;
@@ -674,6 +723,12 @@ export declare const SELLER_ROUTES: {
     readonly LISTING_TEMPLATES_NEW: "/store/listing-templates/new";
     readonly LISTING_TEMPLATES_EDIT: (id: string) => string;
     readonly GOOGLE_REVIEWS: "/store/google-reviews";
+    readonly GUIDE: "/store/guide";
+    readonly GUIDE_LISTINGS: "/store/guide/listings";
+    readonly GUIDE_ORDERS: "/store/guide/orders";
+    readonly GUIDE_FINANCE: "/store/guide/finance";
+    readonly GUIDE_CAPABILITIES: "/store/guide/capabilities";
+    readonly GUIDE_SETTINGS: "/store/guide/settings";
 };
 export declare const PUBLIC_ROUTES: readonly ["/", string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, "/unauthorized", "/auth/login", "/auth/register", "/auth/forgot-password", "/auth/reset-password", "/auth/verify-email"];
 export declare const PROTECTED_ROUTES: readonly [string, string, string, string, string, string, string];

package/dist/next/routing/route-map.js

@@ -41,6 +41,10 @@ export const DEFAULT_ROUTE_MAP = {
         CONTACT: "/contact",
         BLOG: "/blog",
         HELP: "/help",
+        HELP_SHOPPING: "/help/shopping",
+        HELP_AUCTIONS: "/help/auctions",
+        HELP_ORDERS: "/help/orders",
+        HELP_ACCOUNT: "/help/account",
         TERMS: "/terms",
         PRIVACY: "/privacy",
         SECURITY: "/security",
@@ -190,6 +194,9 @@ export const DEFAULT_ROUTE_MAP = {
         SHIPPING_CONFIGS_EDIT: (id) => `/store/shipping-configs/${id}/edit`,
         ANALYTICS_CARDS: "/store/analytics/cards",
         ANALYTICS_ALERTS: "/store/analytics/alerts",
+        GROUPED_LISTINGS: "/store/grouped-listings",
+        GROUPED_LISTINGS_NEW: "/store/grouped-listings/new",
+        GROUPED_LISTINGS_EDIT: (id) => `/store/grouped-listings/${id}/edit`,
         STORE_CATEGORIES: "/store/categories",
         STORE_CATEGORIES_NEW: "/store/categories/new",
         STORE_CATEGORIES_EDIT: (id) => `/store/categories/${id}/edit`,
@@ -197,6 +204,13 @@ export const DEFAULT_ROUTE_MAP = {
         LISTING_TEMPLATES_NEW: "/store/listing-templates/new",
         LISTING_TEMPLATES_EDIT: (id) => `/store/listing-templates/${id}/edit`,
         GOOGLE_REVIEWS: "/store/google-reviews",
+        // GD1–GD6 — Store Guide Hub + sub-pages
+        GUIDE: "/store/guide",
+        GUIDE_LISTINGS: "/store/guide/listings",
+        GUIDE_ORDERS: "/store/guide/orders",
+        GUIDE_FINANCE: "/store/guide/finance",
+        GUIDE_CAPABILITIES: "/store/guide/capabilities",
+        GUIDE_SETTINGS: "/store/guide/settings",
     },
     ADMIN: {
         DASHBOARD: "/admin/dashboard",
@@ -292,6 +306,17 @@ export const DEFAULT_ROUTE_MAP = {
         ROLES_EDIT: (id) => `/admin/roles/${id}/edit`,
         PERMISSIONS: "/admin/permissions",
         ADMIN_NOTIFICATIONS: "/admin/admin-notifications",
+        // GD13–GD22 — Admin Guide Hub + sub-pages
+        GUIDE: "/admin/guide",
+        GUIDE_USERS: "/admin/guide/users",
+        GUIDE_CATALOG: "/admin/guide/catalog",
+        GUIDE_STORES: "/admin/guide/stores",
+        GUIDE_ORDERS: "/admin/guide/orders",
+        GUIDE_CONTENT: "/admin/guide/content",
+        GUIDE_SITE: "/admin/guide/site",
+        GUIDE_TEAM: "/admin/guide/team",
+        GUIDE_ANALYTICS: "/admin/guide/analytics",
+        GUIDE_TRUST: "/admin/guide/trust",
     },
     DEMO: {
         SEED: "/demo/seed",

package/dist/providers/db-firebase/__tests__/filter-aliases.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/providers/db-firebase/__tests__/filter-aliases.test.js

@@ -0,0 +1,93 @@
+import { describe, it, expect } from "vitest";
+import { expandFilterAliases } from "../filter-aliases";
+describe("expandFilterAliases", () => {
+    it("returns undefined when filters is undefined", () => {
+        const aliases = { scope: () => "status==active" };
+        expect(expandFilterAliases(undefined, aliases)).toBeUndefined();
+    });
+    it("returns filters unchanged when aliases is undefined", () => {
+        expect(expandFilterAliases("status==active", undefined)).toBe("status==active");
+    });
+    it("returns filters unchanged when aliases is empty object", () => {
+        expect(expandFilterAliases("status==active", {})).toBe("status==active");
+    });
+    it("expands a single alias clause", () => {
+        const aliases = {
+            scope: (value) => value === "publicAuctions" ? "status==published,listingType==auction" : "",
+        };
+        expect(expandFilterAliases("scope==publicAuctions", aliases)).toBe("status==published,listingType==auction");
+    });
+    it("passes the operator to the alias function", () => {
+        const received = [];
+        const aliases = {
+            myField: (value, op) => {
+                received.push({ value, op });
+                return "x==1";
+            },
+        };
+        expandFilterAliases("myField!=foo", aliases);
+        expect(received).toEqual([{ value: "foo", op: "!=" }]);
+    });
+    it("expands an alias and passes through unknown clauses", () => {
+        const aliases = {
+            scope: () => "status==published,listingType==auction",
+        };
+        const result = expandFilterAliases("scope==publicAuctions,storeId==store-abc", aliases);
+        expect(result).toBe("status==published,listingType==auction,storeId==store-abc");
+    });
+    it("passes through a clause whose field has no alias", () => {
+        const aliases = { scope: () => "status==active" };
+        expect(expandFilterAliases("category==brand-pokemon", aliases)).toBe("category==brand-pokemon");
+    });
+    it("drops a clause when the alias returns empty string", () => {
+        const aliases = {
+            scope: () => "",
+        };
+        expect(expandFilterAliases("scope==unknown", aliases)).toBe("");
+    });
+    it("drops an empty-expansion clause while keeping other clauses", () => {
+        const aliases = {
+            scope: (value) => (value === "known" ? "status==active" : ""),
+        };
+        const result = expandFilterAliases("scope==notknown,listingType==standard", aliases);
+        expect(result).toBe("listingType==standard");
+    });
+    it("handles multiple alias fields in one filter string", () => {
+        const aliases = {
+            scope: () => "status==active",
+            type: () => "listingType==auction",
+        };
+        const result = expandFilterAliases("scope==any,type==any", aliases);
+        expect(result).toBe("status==active,listingType==auction");
+    });
+    it("trims whitespace around clauses", () => {
+        const aliases = { scope: () => "status==active" };
+        const result = expandFilterAliases(" scope==x , name==foo ", aliases);
+        expect(result).toBe("status==active,name==foo");
+    });
+    it("passes through a clause that does not match the operator pattern", () => {
+        const aliases = { scope: () => "status==active" };
+        // A malformed clause has no operator — should pass through unchanged
+        expect(expandFilterAliases("malformed", aliases)).toBe("malformed");
+    });
+    it("handles @= operator", () => {
+        const received = [];
+        const aliases = {
+            tags: (_v, op) => { received.push(op); return "tags@=value"; },
+        };
+        expandFilterAliases("tags@=value", aliases);
+        expect(received[0]).toBe("@=");
+    });
+    it("handles @=* operator", () => {
+        const received = [];
+        const aliases = {
+            tags: (_v, op) => { received.push(op); return "tags@=*value"; },
+        };
+        expandFilterAliases("tags@=*value", aliases);
+        expect(received[0]).toBe("@=*");
+    });
+    it("returns empty string when all clauses expand to empty", () => {
+        const aliases = { scope: () => "" };
+        expect(expandFilterAliases("scope==x", aliases)).toBe("");
+    });
+});

package/dist/providers/db-firebase/sieve.d.ts

@@ -16,6 +16,55 @@
  *   }, { baseQuery });
  * }
  * ```
+ *
+ * ## Known Sieve ↔ Firestore incompatibilities
+ *
+ * These Sieve DSL features are silently unsupported or produce wrong results
+ * when translated to Firestore queries. Document them here to avoid surprise.
+ *
+ * ### 1. String-contains `@=*` (case-insensitive full-text)
+ * Sieve's `title@=*query` is a substring/CI match. Firestore has no native
+ * LIKE or ILIKE operator. The Firebase adapter maps it to `>=` / `<` prefix
+ * range tricks that only work for prefix matches on ASCII strings, not
+ * arbitrary substrings. Use a Firebase Function or in-memory post-filter for
+ * real substring search; never rely on `@=*` to match mid-string.
+ *
+ * ### 2. OR across different fields (`|` pipe between clauses)
+ * Sieve's `field1==v1|field2==v2` (OR across two different fields) is
+ * translated to `whereOr` by the stock Firebase adapter. Firestore's Admin SDK
+ * v6+ supports `Query.where(Filter.or(...))`, but the stock adapter version
+ * bundled with sievejs may emit an unsupported form. The enhanced adapter in
+ * this file only upgrades single-field OR groups (same-field equality → `in`
+ * query). Multi-field OR is still unsupported — apply it in memory.
+ *
+ * ### 3. OR on the same field (`field==v1|v2`) → Firestore `in`
+ * The custom `createEnhancedFirebaseAdapter` in this file upgrades these to
+ * Firestore `.where(field, "in", [v1, v2])`. Firestore supports up to 30
+ * values in an `in` clause. More than 30 values will throw. The stock adapter
+ * would have emitted a `whereOr` call that fails entirely.
+ *
+ * ### 4. Multi-field `orderBy` without a matching composite index
+ * Firestore requires a composite index for every combination of `where` +
+ * `orderBy` fields. Sieve sorts like `-createdAt,price` translate to two
+ * `orderBy` calls; if the Firestore collection has no index for that
+ * combination the query throws `FAILED_PRECONDITION`. Add the index to
+ * `appkit/firebase/base/firestore.indexes.json` and deploy before shipping.
+ *
+ * ### 5. Inequality filter + `orderBy` on a different field
+ * Firestore's rule: if you have an inequality filter (`!=`, `<`, `>`, `<=`,
+ * `>=`) on field A, the first `orderBy` must also be on field A. Sieve queries
+ * like `price>=100 & sorts=-createdAt` translate to an inequality on `price`
+ * with `orderBy createdAt`, which Firestore rejects. Work-arounds:
+ *   (a) move the inequality filter to the Firebase Function path where it can
+ *       be handled server-side, (b) apply it in-memory in the fallback path,
+ *       (c) restructure the sort to use the same field as the filter.
+ *
+ * ### 6. Dot-notation nested field filters (`address.city==Delhi`)
+ * Sieve parses the field name verbatim; the Firebase adapter passes it as the
+ * Firestore field path. Firestore Admin SDK supports dot-notation for nested
+ * fields, so `address.city==Delhi` works — but only if the field is indexed.
+ * Add nested-field indexes explicitly; Firestore does not auto-index nested
+ * paths in composite indexes declared at the root level.
  */
 import type { CollectionReference, DocumentData, Query } from "firebase-admin/firestore";
 import { FirebaseRepository } from "./base";