@mohasinac/appkit 4.44.0 → 4.45.0

package/dist/seo/json-ld.d.ts

@@ -163,4 +163,66 @@ export interface SiteIdentityOptions {
 export declare function organizationJsonLd(opts?: SiteIdentityOptions): Record<string, JsonLdValue>;
 export declare function searchBoxJsonLd(opts?: SiteIdentityOptions): Record<string, JsonLdValue>;
 export declare function auctionJsonLd(auction: ProductJsonLdInput): Record<string, JsonLdValue>;
+export interface ItemListJsonLdEntry {
+    name: string;
+    /** Path or absolute URL. Absolutised against the ONE canonical host. */
+    url: string;
+    image?: string;
+}
+/**
+ * `ItemList` — the names and URLs of what a listing page shows.
+ *
+ * 🛑 NO `offers`, NO price, and this is not a style choice.
+ *
+ * Two independent reasons, and either alone settles it. Prices are hidden from
+ * signed-out visitors and Googlebot crawls signed out, so a price here would be
+ * markup the user cannot see — the mismatch `gatedPriceWebPageJsonLd` exists to
+ * declare, except there is nothing to declare on a list because the list never
+ * shows a price at all. And `audit-guest-price-leak` R3 blocks it outright.
+ *
+ * It is also exactly what hobbykartindia.com does — server-side `ItemList`
+ * carrying price — and §2 records it as the thing not to copy.
+ *
+ * A list of names and URLs is still worth emitting: it tells a crawler what the
+ * page is a list OF, which is the one thing a grid of cards does not say in
+ * markup.
+ */
+export declare function itemListJsonLd(entries: readonly ItemListJsonLdEntry[]): Record<string, JsonLdValue>;
+export interface CollectionPageJsonLdInput {
+    name: string;
+    /** Path or absolute URL for this collection. */
+    url: string;
+    description?: string;
+    /**
+     * The items shown, if any. Omitted or empty emits a `CollectionPage` with no
+     * `mainEntity` — which is correct for a collection whose contents are
+     * paginated or filtered, and far better than an `ItemList` of zero claiming
+     * the collection is empty.
+     */
+    items?: readonly ItemListJsonLdEntry[];
+    /**
+     * Total across all pages, when it differs from `items.length`.
+     *
+     * 🛑 `truncated` matters here for the same reason it does in the list
+     * envelope: a `CollectionPage` on page 1 of 12 that declares
+     * `numberOfItems: 24` is telling a crawler the collection has 24 items. Pass
+     * the real total and the markup stops lying about scale.
+     */
+    totalItems?: number;
+}
+/**
+ * `CollectionPage` — what a category, brand or listing index actually is.
+ *
+ * 🛑 The category tab page emitted NO JSON-LD whatsoever (verified: zero
+ * `ld+json` under `features/categories/`), while worldhobbyshop — the SEO
+ * leader of the fifteen crawled — ships a 6-level `BreadcrumbList` and a
+ * `CollectionPage`, and no Shopify competitor has either. §5 ranks this the
+ * highest-impact SEO change in the plan, and it costs nothing at render: the
+ * route is already dynamic SSR and `ancestors[]` rides a read it already does.
+ *
+ * Pair it with `breadcrumbJsonLd` — the two answer different questions ("what
+ * is this page" and "where does it sit"), and the breadcrumb is the half the
+ * competition does not have.
+ */
+export declare function collectionPageJsonLd(input: CollectionPageJsonLdInput): Record<string, JsonLdValue>;
 export {};

package/dist/seo/json-ld.js

@@ -36,8 +36,8 @@ function absoluteUrl(value, base = SITE_URL) {
         return undefined; // no base to resolve against — omit rather than emit a bare path
     return `${base.replace(/\/+$/, "")}/${v.replace(/^\/+/, "")}`;
 }
-import { ProductStatusValues } from "../features/products/schemas";
-import { getDefaultCurrency } from "../core/baseline-resolver";
+import { ProductStatusValues } from "../features/products/schemas/index.js";
+import { getDefaultCurrency } from "../core/baseline-resolver.js";
 // --- Helpers -----------------------------------------------------------------
 /**
  * The CSS selector the price gate renders in every state.
@@ -258,3 +258,79 @@ export function auctionJsonLd(auction) {
         }),
     };
 }
+/**
+ * `ItemList` — the names and URLs of what a listing page shows.
+ *
+ * 🛑 NO `offers`, NO price, and this is not a style choice.
+ *
+ * Two independent reasons, and either alone settles it. Prices are hidden from
+ * signed-out visitors and Googlebot crawls signed out, so a price here would be
+ * markup the user cannot see — the mismatch `gatedPriceWebPageJsonLd` exists to
+ * declare, except there is nothing to declare on a list because the list never
+ * shows a price at all. And `audit-guest-price-leak` R3 blocks it outright.
+ *
+ * It is also exactly what hobbykartindia.com does — server-side `ItemList`
+ * carrying price — and §2 records it as the thing not to copy.
+ *
+ * A list of names and URLs is still worth emitting: it tells a crawler what the
+ * page is a list OF, which is the one thing a grid of cards does not say in
+ * markup.
+ */
+export function itemListJsonLd(entries) {
+    return {
+        "@context": "https://schema.org",
+        "@type": "ItemList",
+        numberOfItems: entries.length,
+        itemListElement: entries.map((e, i) => ({
+            "@type": "ListItem",
+            position: i + 1,
+            name: e.name,
+            url: absoluteUrl(e.url),
+            ...(e.image ? { image: absoluteUrl(e.image) } : {}),
+        })),
+    };
+}
+/**
+ * `CollectionPage` — what a category, brand or listing index actually is.
+ *
+ * 🛑 The category tab page emitted NO JSON-LD whatsoever (verified: zero
+ * `ld+json` under `features/categories/`), while worldhobbyshop — the SEO
+ * leader of the fifteen crawled — ships a 6-level `BreadcrumbList` and a
+ * `CollectionPage`, and no Shopify competitor has either. §5 ranks this the
+ * highest-impact SEO change in the plan, and it costs nothing at render: the
+ * route is already dynamic SSR and `ancestors[]` rides a read it already does.
+ *
+ * Pair it with `breadcrumbJsonLd` — the two answer different questions ("what
+ * is this page" and "where does it sit"), and the breadcrumb is the half the
+ * competition does not have.
+ */
+export function collectionPageJsonLd(input) {
+    const items = input.items ?? [];
+    const total = input.totalItems ?? items.length;
+    return {
+        "@context": "https://schema.org",
+        "@type": "CollectionPage",
+        name: input.name,
+        url: absoluteUrl(input.url),
+        ...(input.description ? { description: input.description } : {}),
+        /*
+         * `mainEntity` is omitted entirely for an empty collection rather than
+         * emitted as an `ItemList` of zero. "This page lists things, and here are
+         * none of them" is a claim; saying nothing is not.
+         */
+        ...(items.length > 0
+            ? {
+                mainEntity: {
+                    "@type": "ItemList",
+                    numberOfItems: total,
+                    itemListElement: items.map((e, i) => ({
+                        "@type": "ListItem",
+                        position: i + 1,
+                        name: e.name,
+                        url: absoluteUrl(e.url),
+                    })),
+                },
+            }
+            : {}),
+    };
+}

package/dist/seo/metadata.js

@@ -1,4 +1,4 @@
-import { ROUTES } from "../next/routing/route-map";
+import { ROUTES } from "../next/routing/route-map.js";
 export const SEO_CONFIG = {
     siteName: "App",
     siteUrl: process.env.NEXT_PUBLIC_SITE_URL || "http://localhost:3000",

package/dist/server-entry.js

@@ -13,90 +13,90 @@
  */
 // Full surface — same symbols as client entry for now.
 // firebase-admin is correctly reachable here since this is the server entry.
-export * from "./index";
+export * from "./index.js";
 // Server-only RSC views — removed from index.ts to prevent firebase-admin
 // leaking into the client bundle via client-entry.ts's export * from "./index".
 // These are async React Server Components that fetch data via repositories.
-export { PolicyPageView } from "./features/about/index";
-export { BlogIndexPageView } from "./features/blog/components/BlogIndexPageView";
-export { CategoriesIndexPageView } from "./features/categories/components/CategoriesIndexPageView";
-export { CategoryDetailPageView } from "./features/categories/components/CategoryDetailPageView";
-export { BrandDetailPageView } from "./features/categories/components/BrandDetailPageView";
-export { EventsListPageView } from "./features/events/components/EventsListPageView";
-export { MarketplaceHomepageView } from "./features/homepage/index";
-export { PreOrdersListView } from "./features/pre-orders/index";
-export { PreOrderDetailPageView } from "./features/pre-orders/index";
-export { AuctionDetailPageView } from "./features/auctions/index";
-export { AuctionsListView } from "./features/auctions/components/AuctionsListView";
-export { BundlesListView } from "./features/categories/components/BundlesListView";
-export { PrizeDrawsListingView } from "./features/products/components/PrizeDrawsListingView";
-export { PrizeDrawDetailPageView } from "./features/products/components/PrizeDrawDetailPageView";
-export { ProductDetailPageView } from "./features/products/components/ProductDetailPageView";
-export { ProductsIndexPageView } from "./features/products/components/ProductsIndexPageView";
-export { ClassifiedDetailPageView } from "./features/classified/components/ClassifiedDetailPageView";
-export { DigitalCodeDetailPageView } from "./features/digital-codes/components/DigitalCodeDetailPageView";
-export { LiveItemDetailPageView } from "./features/live/components/LiveItemDetailPageView";
-export { ArtStickersListView } from "./features/products/components/ArtStickersListView";
-export { ReviewsIndexPageView } from "./features/reviews/components/ReviewsIndexPageView";
-export { ReviewDetailPageView } from "./features/reviews/components/ReviewDetailPageView";
-export { StoresIndexPageView } from "./features/stores/components/StoresIndexPageView";
-export { StoreDetailLayoutView } from "./features/stores/components/StoreDetailLayoutView";
-export { StoreProductsPageView } from "./features/stores/components/StoreProductsPageView";
-export { StoreAuctionsPageView } from "./features/stores/components/StoreAuctionsPageView";
-export { StorePreOrdersPageView } from "./features/stores/components/StorePreOrdersPageView";
-export { StorePrizeDrawsPageView } from "./features/stores/components/StorePrizeDrawsPageView";
-export { StoreBundlesPageView } from "./features/stores/components/StoreBundlesPageView";
-export { StoreClassifiedsPageView } from "./features/stores/components/StoreClassifiedsPageView";
-export { StoreDigitalCodesPageView } from "./features/stores/components/StoreDigitalCodesPageView";
-export { StoreLiveItemsPageView } from "./features/stores/components/StoreLiveItemsPageView";
-export { StoreArtStickersPageView } from "./features/stores/components/StoreArtStickersPageView";
+export { PolicyPageView } from "./features/about/index.js";
+export { BlogIndexPageView } from "./features/blog/components/BlogIndexPageView.js";
+export { CategoriesIndexPageView } from "./features/categories/components/CategoriesIndexPageView.js";
+export { CategoryDetailPageView } from "./features/categories/components/CategoryDetailPageView.js";
+export { BrandDetailPageView } from "./features/categories/components/BrandDetailPageView.js";
+export { EventsListPageView } from "./features/events/components/EventsListPageView.js";
+export { MarketplaceHomepageView } from "./features/homepage/index.js";
+export { PreOrdersListView } from "./features/pre-orders/index.js";
+export { PreOrderDetailPageView } from "./features/pre-orders/index.js";
+export { AuctionDetailPageView } from "./features/auctions/index.js";
+export { AuctionsListView } from "./features/auctions/components/AuctionsListView.js";
+export { BundlesListView } from "./features/categories/components/BundlesListView.js";
+export { PrizeDrawsListingView } from "./features/products/components/PrizeDrawsListingView.js";
+export { PrizeDrawDetailPageView } from "./features/products/components/PrizeDrawDetailPageView.js";
+export { ProductDetailPageView } from "./features/products/components/ProductDetailPageView.js";
+export { ProductsIndexPageView } from "./features/products/components/ProductsIndexPageView.js";
+export { ClassifiedDetailPageView } from "./features/classified/components/ClassifiedDetailPageView.js";
+export { DigitalCodeDetailPageView } from "./features/digital-codes/components/DigitalCodeDetailPageView.js";
+export { LiveItemDetailPageView } from "./features/live/components/LiveItemDetailPageView.js";
+export { ArtStickersListView } from "./features/products/components/ArtStickersListView.js";
+export { ReviewsIndexPageView } from "./features/reviews/components/ReviewsIndexPageView.js";
+export { ReviewDetailPageView } from "./features/reviews/components/ReviewDetailPageView.js";
+export { StoresIndexPageView } from "./features/stores/components/StoresIndexPageView.js";
+export { StoreDetailLayoutView } from "./features/stores/components/StoreDetailLayoutView.js";
+export { StoreProductsPageView } from "./features/stores/components/StoreProductsPageView.js";
+export { StoreAuctionsPageView } from "./features/stores/components/StoreAuctionsPageView.js";
+export { StorePreOrdersPageView } from "./features/stores/components/StorePreOrdersPageView.js";
+export { StorePrizeDrawsPageView } from "./features/stores/components/StorePrizeDrawsPageView.js";
+export { StoreBundlesPageView } from "./features/stores/components/StoreBundlesPageView.js";
+export { StoreClassifiedsPageView } from "./features/stores/components/StoreClassifiedsPageView.js";
+export { StoreDigitalCodesPageView } from "./features/stores/components/StoreDigitalCodesPageView.js";
+export { StoreLiveItemsPageView } from "./features/stores/components/StoreLiveItemsPageView.js";
+export { StoreArtStickersPageView } from "./features/stores/components/StoreArtStickersPageView.js";
 // S2: products data layer — deduped via React.cache()
-export { getProductForDetail, listSitemapProducts, } from "./_internal/server/features/products/index";
-export { listPublicProducts, parsePublicProductParams, defaultAvailabilityForListingTypes, PUBLIC_PRODUCT_MAX_PAGE_SIZE, ANY_STATUS, } from "./_internal/server/features/products/index";
+export { getProductForDetail, listSitemapProducts, } from "./_internal/server/features/products/index.js";
+export { listPublicProducts, parsePublicProductParams, defaultAvailabilityForListingTypes, PUBLIC_PRODUCT_MAX_PAGE_SIZE, ANY_STATUS, } from "./_internal/server/features/products/index.js";
 // S3: auctions data layer — deduped via React.cache()
-export { getAuctionForDetail, getProductFeaturesForAuction, } from "./_internal/server/features/auctions/index";
+export { getAuctionForDetail, getProductFeaturesForAuction, } from "./_internal/server/features/auctions/index.js";
 // S3: pre-orders data layer — deduped via React.cache()
-export { getPreOrderForDetail, getProductFeaturesForPreOrder, } from "./_internal/server/features/pre-orders/index";
+export { getPreOrderForDetail, getProductFeaturesForPreOrder, } from "./_internal/server/features/pre-orders/index.js";
 // S3: brands data layer + actions
-export { getBrandForDetail, getBrandCategoryForDetail, createBrandAction, updateBrandAction, deleteBrandAction, toggleBrandActiveAction, } from "./_internal/server/features/brands/index";
+export { getBrandForDetail, getBrandCategoryForDetail, createBrandAction, updateBrandAction, deleteBrandAction, toggleBrandActiveAction, } from "./_internal/server/features/brands/index.js";
 // S3: blog data layer + actions
-export { getBlogPostForDetail, getBlogPostById, createBlogPostAction, updateBlogPostAction, deleteBlogPostAction, publishBlogPostAction, unpublishBlogPostAction, } from "./_internal/server/features/blog/index";
+export { getBlogPostForDetail, getBlogPostById, createBlogPostAction, updateBlogPostAction, deleteBlogPostAction, publishBlogPostAction, unpublishBlogPostAction, } from "./_internal/server/features/blog/index.js";
 // S3: events data layer + actions
-export { getEventForDetail, registerForEventAction, cancelEventRegistrationAction, createEventAction, updateEventAction, } from "./_internal/server/features/events/index";
+export { getEventForDetail, registerForEventAction, cancelEventRegistrationAction, createEventAction, updateEventAction, } from "./_internal/server/features/events/index.js";
 // S2–S3: products full layer (data + actions)
-export { createProductAction, createAuctionAction, createPreOrderAction, updateProductAction, deleteProductAction, setProductStatusAction, setProductFeaturedAction, } from "./_internal/server/features/products/index";
+export { createProductAction, createAuctionAction, createPreOrderAction, updateProductAction, deleteProductAction, setProductStatusAction, setProductFeaturedAction, } from "./_internal/server/features/products/index.js";
 // S3: auctions actions
-export { placeBidAction as placeBidServerAction } from "./_internal/server/features/auctions/index";
+export { placeBidAction as placeBidServerAction } from "./_internal/server/features/auctions/index.js";
 // S3: pre-orders actions
-export { reservePreOrderAction } from "./_internal/server/features/pre-orders/index";
+export { reservePreOrderAction } from "./_internal/server/features/pre-orders/index.js";
 // S4: cart actions
-export { getCartForUser, addToCartAction, removeFromCartAction, clearCartAction, mergeGuestCartAction, CART_MAX_ITEMS, CART_GUEST_STORAGE_KEY, } from "./_internal/server/features/cart/index";
+export { getCartForUser, addToCartAction, removeFromCartAction, clearCartAction, mergeGuestCartAction, CART_MAX_ITEMS, CART_GUEST_STORAGE_KEY, } from "./_internal/server/features/cart/index.js";
 // S4: orders data + actions + adapters
-export { getOrderForDetail, getOrdersForBuyer, getRecentOrdersForBuyer, createOrderAction, cancelOrderAction, requestReturnAction, updateOrderStatusAction, ORDERS_PAGE_SIZE, orderDocumentToOrder, } from "./_internal/server/features/orders/index";
+export { getOrderForDetail, getOrdersForBuyer, getRecentOrdersForBuyer, createOrderAction, cancelOrderAction, requestReturnAction, updateOrderStatusAction, ORDERS_PAGE_SIZE, orderDocumentToOrder, } from "./_internal/server/features/orders/index.js";
 // S4: promotions (coupons)
-export { getCouponByCode, applyCouponAction, createCouponAction, updateCouponAction, deactivateCouponAction, } from "./_internal/server/features/promotions/index";
+export { getCouponByCode, applyCouponAction, createCouponAction, updateCouponAction, deactivateCouponAction, } from "./_internal/server/features/promotions/index.js";
 // S5: wishlist data layer + actions
-export { getWishlistForUser, isProductInWishlist, addToWishlistAction, removeFromWishlistAction, mergeGuestWishlistAction, WISHLIST_MAX, WISHLIST_GUEST_STORAGE_KEY, WishlistCapError, } from "./_internal/server/features/wishlist/index";
+export { getWishlistForUser, isProductInWishlist, addToWishlistAction, removeFromWishlistAction, mergeGuestWishlistAction, WISHLIST_MAX, WISHLIST_GUEST_STORAGE_KEY, WishlistCapError, } from "./_internal/server/features/wishlist/index.js";
 // S5: history data layer + actions
-export { getHistoryForUser, trackProductViewAction, mergeGuestHistoryAction, HISTORY_MAX, HISTORY_GUEST_STORAGE_KEY, } from "./_internal/server/features/history/index";
+export { getHistoryForUser, trackProductViewAction, mergeGuestHistoryAction, HISTORY_MAX, HISTORY_GUEST_STORAGE_KEY, } from "./_internal/server/features/history/index.js";
 // S5: homepage data layer — getHomepageInitial / getHomepageSections /
 // getHeroCarouselSlides were deleted 2026-08-24 (zero call sites; see that
 // module's index.ts).
 // S5: reviews data layer + actions
-export { getReviewsForProduct, getReviewsForStore, hasUserPurchasedProduct, getReviewById, renderReviewOg, renderReviewOgImage, createReviewAction, replyToReviewAction, deleteReviewAction, markReviewHelpfulAction, } from "./_internal/server/features/reviews/index";
-export { renderFaqOg, renderFaqOgImage, } from "./_internal/server/features/faqs/index";
-export { renderScamOg, renderScamOgImage, getScammerForDetail, getScammerProfilePageData as getScammerProfilePageDataCached, } from "./_internal/server/features/scams/index";
+export { getReviewsForProduct, getReviewsForStore, hasUserPurchasedProduct, getReviewById, renderReviewOg, renderReviewOgImage, createReviewAction, replyToReviewAction, deleteReviewAction, markReviewHelpfulAction, } from "./_internal/server/features/reviews/index.js";
+export { renderFaqOg, renderFaqOgImage, } from "./_internal/server/features/faqs/index.js";
+export { renderScamOg, renderScamOgImage, getScammerForDetail, getScammerProfilePageData as getScammerProfilePageDataCached, } from "./_internal/server/features/scams/index.js";
 // S5: search data layer + action
-export { getSearchResults, searchAction, } from "./_internal/server/features/search/index";
+export { getSearchResults, searchAction, } from "./_internal/server/features/search/index.js";
 // S3: categories data layer
-export { getCategoryForDetail, listRootCategories, listFeaturedCategories, listMenuCategories, getCategoryTree, listSitemapCategories, CATEGORIES_PAGE_SIZE, CATEGORIES_ROOT_TIER, CATEGORIES_MAX_DEPTH, CATEGORIES_SITEMAP_LIMIT, CATEGORIES_FEATURED_LIMIT, CATEGORIES_MENU_LIMIT, } from "./_internal/server/features/categories/index";
+export { getCategoryForDetail, listRootCategories, listFeaturedCategories, listMenuCategories, getCategoryTree, listSitemapCategories, CATEGORIES_PAGE_SIZE, CATEGORIES_ROOT_TIER, CATEGORIES_MAX_DEPTH, CATEGORIES_SITEMAP_LIMIT, CATEGORIES_FEATURED_LIMIT, CATEGORIES_MENU_LIMIT, } from "./_internal/server/features/categories/index.js";
 // S3: grouped listings data layer
-export { getGroupedListingForDetail, getGroupedListingWithItems, listGroupedListings, listFeaturedGroupedListings, listSitemapGroupedListings, getGroupsForProduct, getGroupsWithItemsForProduct, GROUPED_LISTINGS_PAGE_SIZE, GROUPED_LISTINGS_FEATURED_LIMIT, GROUPED_LISTINGS_SITEMAP_LIMIT, buildGroupedListingMetadata, renderGroupedListingOg, } from "./_internal/server/features/grouped/index";
+export { getGroupedListingForDetail, getGroupedListingWithItems, listGroupedListings, listFeaturedGroupedListings, listSitemapGroupedListings, getGroupsForProduct, getGroupsWithItemsForProduct, GROUPED_LISTINGS_PAGE_SIZE, GROUPED_LISTINGS_FEATURED_LIMIT, GROUPED_LISTINGS_SITEMAP_LIMIT, buildGroupedListingMetadata, renderGroupedListingOg, } from "./_internal/server/features/grouped/index.js";
 // SB-UNI-V — bundles data layer deleted; consumers should query
 // `categoriesRepository.findBySlugAndType(slug, "bundle")` /
 // `.listByType("bundle", opts)` / `.findById(id)` directly.
 // S4: checkout actions
-export { createCheckoutOrderAction, attachPaymentAction, verifyAndPlacePhonePeOrderAction, previewCheckoutPricing, resolveShippingCost, formatShippingAddress, CHECKOUT_DEFAULT_COMMISSIONS, CHECKOUT_PAYMENT_METHODS, } from "./_internal/server/features/checkout/index";
+export { createCheckoutOrderAction, attachPaymentAction, verifyAndPlacePhonePeOrderAction, previewCheckoutPricing, resolveShippingCost, formatShippingAddress, CHECKOUT_DEFAULT_COMMISSIONS, CHECKOUT_PAYMENT_METHODS, } from "./_internal/server/features/checkout/index.js";
 // The one definition of "what does this cart line cost". Exported because the
 // consumer's Razorpay create-order route needs it: that route used to hand-roll
 // the rule and reproduced only the bundle branch, so it captured the LIST price
@@ -106,26 +106,26 @@ export { createCheckoutOrderAction, attachPaymentAction, verifyAndPlacePhonePeOr
 // GST entirely, so the buyer was shown the tax, charged without it, and the
 // order recorded none — with the verify-side mismatch guard omitting it too, so
 // the three were consistently wrong and the undercharge was undetectable.
-export { unitPriceFor, lineTotalFor, sumGroupGst, computePreOrderDepositAmount, } from "./_internal/shared/checkout/order-math";
+export { unitPriceFor, lineTotalFor, sumGroupGst, computePreOrderDepositAmount, } from "./_internal/shared/checkout/order-math.js";
 // S-SBUNI-RULES: refund action
-export { processRefundAction, } from "./_internal/server/features/refunds/actions";
+export { processRefundAction, } from "./_internal/server/features/refunds/actions.js";
 // S3: sublisting categories data layer
-export { getSublistingCategoryForDetail } from "./_internal/server/features/sublisting-categories/index";
+export { getSublistingCategoryForDetail } from "./_internal/server/features/sublisting-categories/index.js";
 // S3: stores data layer
-export { getStoreForDetail, listStoreProductsInitial, listStoreAuctionsInitial, listStorePreOrdersInitial, listSitemapStores, STORES_PAGE_SIZE, STORES_PRODUCTS_PAGE_SIZE, STORES_SITEMAP_LIMIT, STORES_FEATURED_LIMIT, } from "./_internal/server/features/stores/index";
+export { getStoreForDetail, listStoreProductsInitial, listStoreAuctionsInitial, listStorePreOrdersInitial, listSitemapStores, STORES_PAGE_SIZE, STORES_PRODUCTS_PAGE_SIZE, STORES_SITEMAP_LIMIT, STORES_FEATURED_LIMIT, } from "./_internal/server/features/stores/index.js";
 // S4–S5: Job handlers + Firebase binders moved to the `@mohasinac/appkit/jobs`
 // subpath (2.6.0, 2026-05-12). The chain reaches `firebase-functions/v2/*`
 // which is only available in the Firebase Functions runtime, not in Vercel
 // Next.js lambdas. Consumers that need them (i.e. `functions/src/index.ts`)
 // import directly from `@mohasinac/appkit/jobs`.
 // S6: client scaffolds (server-side type-aware import; runtime is "use client")
-export { AppShell } from "./_internal/client/scaffolds/index";
+export { AppShell } from "./_internal/client/scaffolds/index.js";
 // CC-3: hydration helpers
-export { toClient, clientInitial } from "./_internal/shared/serialization/index";
+export { toClient, clientInitial } from "./_internal/shared/serialization/index.js";
 // S7 server feature shims (data + actions) — canonical _internal/ entries
-export * as accountServer from "./_internal/server/features/account/index";
-export * as authServer from "./_internal/server/features/auth/index";
-export * as scamsServer from "./_internal/server/features/scams/index";
+export * as accountServer from "./_internal/server/features/account/index.js";
+export * as authServer from "./_internal/server/features/auth/index.js";
+export * as scamsServer from "./_internal/server/features/scams/index.js";
 // Shared domain errors.
 //
 // ValidationError/NotFoundError/ConflictError are sourced from `./errors/index`
@@ -144,22 +144,22 @@ export * as scamsServer from "./_internal/server/features/scams/index";
 // out to fix. AppkitError/UnauthorizedError/CapacityError/ExpiredError have
 // no real-module counterpart and no confirmed instanceof-mismatch bug, so
 // they stay sourced from `_internal/shared/errors` unchanged.
-export { AppkitError, UnauthorizedError, CapacityError, ExpiredError, } from "./_internal/shared/errors/index";
-export { NotFoundError, ValidationError, ConflictError } from "./errors/index";
-export { SEMANTIC_COLORS, SEMANTIC_COLORS_DARK, SEMANTIC_RADIUS, SEMANTIC_SHADOWS, SEMANTIC_Z_INDEX, MOTION_TOKENS, BREAKPOINTS, PLATFORM_LIMITS, } from "./_internal/shared/tokens/index";
+export { AppkitError, UnauthorizedError, CapacityError, ExpiredError, } from "./_internal/shared/errors/index.js";
+export { NotFoundError, ValidationError, ConflictError } from "./errors/index.js";
+export { SEMANTIC_COLORS, SEMANTIC_COLORS_DARK, SEMANTIC_RADIUS, SEMANTIC_SHADOWS, SEMANTIC_Z_INDEX, MOTION_TOKENS, BREAKPOINTS, PLATFORM_LIMITS, } from "./_internal/shared/tokens/index.js";
 // OG image renderers — pure JSX, no next/og dependency; wrap with ImageResponse in consumer.
 // Two layers per feature:
 //   - renderXOg(doc, opts)  — high-level: takes the raw doc from the data layer, does field
 //                             mapping internally. Use this for ~5-line consumer shims.
 //   - renderXOgImage(data, siteName)  — low-level primitive: takes a pre-mapped data shape.
 //                             Use only when overriding the default field extraction.
-export { renderProductOg, renderProductOgImage } from "./_internal/server/features/products/og";
-export { renderAuctionOg, renderAuctionOgImage } from "./_internal/server/features/auctions/og";
-export { renderPreOrderOg, renderPreOrderOgImage } from "./_internal/server/features/pre-orders/og";
-export { renderStoreOg, renderStoreOgImage } from "./_internal/server/features/stores/og";
-export { renderBrandOg, renderBrandOgImage } from "./_internal/server/features/brands/og";
-export { renderBlogOg, renderBlogOgImage } from "./_internal/server/features/blog/og";
-export { renderEventOg, renderEventOgImage } from "./_internal/server/features/events/og";
-export { renderSublistingCategoryOg, renderSublistingCategoryOgImage } from "./_internal/server/features/sublisting-categories/og";
-export { renderProfileOg, renderPrivateProfileOgImage, renderUserProfileOgImage } from "./_internal/server/features/profile/og";
-export { renderCategoryOg, renderCategoryOgImage } from "./_internal/server/features/categories/og";
+export { renderProductOg, renderProductOgImage } from "./_internal/server/features/products/og.js";
+export { renderAuctionOg, renderAuctionOgImage } from "./_internal/server/features/auctions/og.js";
+export { renderPreOrderOg, renderPreOrderOgImage } from "./_internal/server/features/pre-orders/og.js";
+export { renderStoreOg, renderStoreOgImage } from "./_internal/server/features/stores/og.js";
+export { renderBrandOg, renderBrandOgImage } from "./_internal/server/features/brands/og.js";
+export { renderBlogOg, renderBlogOgImage } from "./_internal/server/features/blog/og.js";
+export { renderEventOg, renderEventOgImage } from "./_internal/server/features/events/og.js";
+export { renderSublistingCategoryOg, renderSublistingCategoryOgImage } from "./_internal/server/features/sublisting-categories/og.js";
+export { renderProfileOg, renderPrivateProfileOgImage, renderUserProfileOgImage } from "./_internal/server/features/profile/og.js";
+export { renderCategoryOg, renderCategoryOgImage } from "./_internal/server/features/categories/og.js";

package/dist/server.d.ts

@@ -274,8 +274,12 @@ export { getRelatedEvents } from "./features/events/server";
 export { updateEvent } from "./features/events/server";
 export { triggerEventRaffleAction, assignSpinPrizeAction, } from "./_internal/server/features/raffle/actions";
 export { processRefundAction, type ProcessRefundInput, } from "./_internal/server/features/refunds/actions";
-export { computeCheckoutFees, computePayoutDeduction, computeCodHandlingFee, computeWhatsAppNotifyFee, computeGiftWrapFee, computeShipmentProtectionFee, } from "./_internal/shared/fees/calculator";
-export type { FeeCommissionRates, CheckoutFees, PayoutDeduction, CodHandlingFeeRates, WhatsAppNotifyFeeRates, GiftWrapFeeRates, ShipmentProtectionFeeRates, } from "./_internal/shared/fees/calculator";
+export { computeCheckoutFees, computePayoutDeduction, computeCodHandlingFee, computeWhatsAppNotifyFee, computeGiftWrapFee, computeShipmentProtectionFee, computeSaleProtectionFee, } from "./_internal/shared/fees/calculator";
+export { searchPriceIndex, PRICE_INDEX_SEARCH_LIMIT, PRICE_INDEX_MIN_QUERY_LENGTH } from "./_internal/server/features/price-index/search";
+export type { PriceIndexSearchResponse, PriceIndexSearchResult, PriceIndexSearchResultBand, } from "./_internal/server/features/price-index/search";
+export { protectionAvailability, computeProtectionFees, adjudicateClaim, badgesFor, showsRiskNotice, showsSafetyBadge, returnDestination, rtoDestination, PROTECTION_KINDS, } from "./_internal/shared/features/shipping/protections";
+export type { ProtectionKind, ProtectionAvailability, ProtectionTierInput, ProtectionUnavailableReason, ClaimFinding, ClaimOutcome, } from "./_internal/shared/features/shipping/protections";
+export type { FeeCommissionRates, CheckoutFees, PayoutDeduction, CodHandlingFeeRates, WhatsAppNotifyFeeRates, GiftWrapFeeRates, ShipmentProtectionFeeRates, SaleProtectionFeeRates, } from "./_internal/shared/fees/calculator";
 export { applyRefundDeductionAction, type ApplyRefundDeductionInput, type ApplyRefundDeductionResult, } from "./_internal/server/features/payouts/actions";
 export { createFaq } from "./features/faq/server";
 export { deleteFaq } from "./features/faq/server";
@@ -586,3 +590,9 @@ export { REFUND_COPY } from "./_internal/shared/features/orders/refund-copy";
 export { RETURN_REASON, FINAL_SALE_EXEMPT_REASONS, RETURN_REASON_LABEL, RETURN_REASON_GROUP_LABEL, isFinalSaleExempt, isReturnReason, selectableReturnReasons, } from "./_internal/shared/features/orders/return-reasons";
 export type { ReturnReason } from "./_internal/shared/features/orders/return-reasons";
 export { draftToProductInput, productToDraft, } from "./features/seller/utils/product-draft-mapping";
+export { RETURN_CUSTODY_STATES, RETURN_CUSTODY_COPY, isTerminalCustody, canAdvanceCustody, nextCustodyState, custodyOwner, isActionableBy, } from "./_internal/shared/features/returns/custody";
+export type { ReturnCustodyState } from "./_internal/shared/features/returns/custody";
+export { resolveReturnAddress, RTO_ENTRY_CUSTODY, rtoCostBearer, RETURN_ABUSE_SCAM_TYPES, RETURN_ABUSE_THRESHOLDS, returnAbuseSignals, enforcementFor, } from "./_internal/shared/features/returns/destination";
+export type { ReturnAddressResolution, ResolveReturnAddressInput, ReturnAbuseSignal, ReturnAbuseCounters, RtoCostBearer, } from "./_internal/shared/features/returns/destination";
+export { COURIER_RATING_MIN_CONFIDENT_SAMPLES, courierRatingDisplay, isValidCourierVote, courierVoteId, rollUpCourierVotes, } from "./_internal/shared/features/shipping/courier-rating";
+export type { CourierRatingPair, CourierRatingDisplay, CourierRatingVote, CourierStats, } from "./_internal/shared/features/shipping/courier-rating";