@mohasinac/appkit 4.25.0 → 4.27.0

package/dist/features/tester/seed-data/tester-checklist-seed-data.js

@@ -729,6 +729,124 @@ const rawTesterChecklistItems = [
             href: "/cart",
             cases: [
                 { key: "update-qty", label: "Updating item quantity in cart recalculates the total" },
+                // ── Grouped & bundle cart lines ──────────────────────────────────
+                // Fixtures backing these: product-tester-standard-1/2/3 (three members
+                // of one group, deliberately spanning two GST rates),
+                // product-tester-group-soldout (blocked member),
+                // product-tester-crossstore-a/b (a group spanning two sellers),
+                // bundle-tester-sandbox (a priced, all-or-nothing bundle).
+                {
+                    key: "group-picker-opens",
+                    label: "On a product that belongs to a group, the \"Part of: …\" strip has a \"Pick items →\" control that opens a picker with a Qty column and a +/- stepper on each member",
+                    description: "Before this existed the panel was navigation only — the buyer had to open each member separately and add it as its own cart line.",
+                    href: "/products/product-tester-standard-1",
+                },
+                {
+                    key: "group-picker-running-total",
+                    label: "Changing any member's quantity updates the picker's running total (\"N items · ₹X\") immediately, and \"Add selected to cart\" stays disabled while nothing is selected",
+                    href: "/products/product-tester-standard-1",
+                },
+                {
+                    key: "group-picker-stock-cap",
+                    label: "A member's + button stops at that member's available stock — it cannot be pushed past it",
+                    href: "/products/product-tester-standard-1",
+                },
+                {
+                    key: "group-picker-blocked-member",
+                    label: "A sold-out member shows a reason chip (e.g. \"Sold\" / \"Out of stock\") in place of its stepper and cannot be selected",
+                    description: "Test Part — Sold Out is seeded into the tester group specifically for this. The rest of the group must stay selectable around it.",
+                    href: "/products/product-tester-group-soldout",
+                },
+                {
+                    key: "group-picker-one-line",
+                    label: "\"Add selected to cart\" with two or more members creates ONE cart line, not one line per product",
+                    description: "Pick 2 of one member and 1 of another, then open the cart: a single line reading \"N items\", not three separate rows.",
+                    href: "/products/product-tester-standard-1",
+                },
+                {
+                    key: "group-picker-single-member-plain-line",
+                    label: "Selecting exactly ONE member produces an ordinary product line (with a normal quantity stepper), not a grouped line",
+                    description: "1 item × qty N is already what a normal cart line means, so it deliberately does not become a group line.",
+                    href: "/products/product-tester-standard-1",
+                },
+                {
+                    key: "group-picker-cross-store",
+                    label: "A group whose members belong to DIFFERENT sellers renders read-only — no Qty column, no \"Add selected\" button — with an explanation, rather than a button that always fails",
+                    description: "Use the Test Cross-Store Set. Its two members sit in different stores on purpose.",
+                    href: "/products/product-tester-crossstore-a",
+                },
+                {
+                    key: "group-picker-guest",
+                    label: "A signed-out visitor using the picker is shown the login prompt rather than silently losing the selection",
+                    href: "/products/product-tester-standard-1",
+                },
+                {
+                    key: "group-line-expands-in-cart",
+                    label: "A grouped cart line in the cart expands to list its members with a thumbnail, unit price and its own +/- stepper each",
+                    href: "/cart",
+                },
+                {
+                    key: "group-line-no-line-level-stepper",
+                    label: "A grouped line has NO line-level quantity stepper — only the per-member ones",
+                    description: "The member quantities carry the whole selection; a second multiplier on top would double every price, tax and stock decrement.",
+                    href: "/cart",
+                },
+                {
+                    key: "group-line-member-edit-recalculates",
+                    label: "Changing one member's quantity in the cart updates that line's total AND the seller-group subtotal above it",
+                    href: "/cart",
+                },
+                {
+                    key: "group-line-remove-member",
+                    label: "Removing one member from a grouped line leaves the rest of the line intact; removing the LAST member removes the whole line",
+                    href: "/cart",
+                },
+                {
+                    key: "group-line-link-target",
+                    label: "Clicking a grouped or bundle line's title in the cart lands on a real page — never a 404",
+                    description: "A bundle line goes to /bundles/{slug}, a grouped-listing line to /groups/{slug}, a product-group line to its parent product. It used to point at /products/{categoryId}, which never existed.",
+                    href: "/cart",
+                },
+                {
+                    key: "bundle-copies-stepper",
+                    label: "A bundle page has a \"Copies\" +/- stepper and BOTH \"Buy now\" and \"Add to cart\" — Add to cart stays on the page, Buy now goes to checkout",
+                    description: "A bundle is all-or-nothing: there must be no per-member quantity controls anywhere on the bundle page, only the copies stepper.",
+                    href: "/bundles/bundle-tester-sandbox",
+                },
+                {
+                    key: "bundle-line-in-cart",
+                    label: "A bundle in the cart lists its members READ-ONLY and offers a copies stepper; raising copies multiplies the bundle's discounted price, never the sum of the members' individual prices",
+                    description: "Test Bundle is ₹199 while its members list at ₹199 + ₹149. Two copies must read ₹398, not ₹696.",
+                    href: "/cart",
+                },
+                {
+                    key: "bundle-cross-store-rejected",
+                    label: "Saving a bundle whose items come from two different sellers is refused with a clear message naming how many sellers they span",
+                    description: "Build a bundle mixing Test Cross-Store Set — Seller A with any Tester Sandbox product and save. Applies to both creating and editing, on the admin and the seller bundle editors. A bundle's storeId is a single value and is what decides which seller gets the order, the shipment and the payout — so a two-seller bundle would pay only one of them.",
+                    href: "/store/bundles/new",
+                },
+                {
+                    key: "grouped-listing-page-picker",
+                    label: "A grouped listing has its own public page with the same picker, reachable from the \"Pick items from this group →\" button on a group carousel",
+                    href: "/groups/group-beyblade-original-lineage",
+                },
+                {
+                    key: "group-lane-gate",
+                    label: "While an unpaid won auction or accepted offer is sitting in the cart, adding a group selection is refused with the same lane message as any other add",
+                    description: "This path used to bypass the gate entirely, so a buyer could keep shopping around an obligation they had already committed to.",
+                    href: "/products/product-tester-standard-1",
+                },
+                {
+                    key: "group-checkout-order-rows",
+                    label: "After checking out a grouped or bundle line, the order shows one row PER MEMBER under a single group header, and the line totals add up to the order total",
+                    description: "Rows are expanded so each carries its own HSN code and GST rate — a collapsed row can only carry one of each, which is why bundles previously showed none.",
+                    href: "/user/orders",
+                },
+                {
+                    key: "group-checkout-stock",
+                    label: "Checking out a grouped line decrements each member by (its per-copy quantity × the number of copies), not by one each",
+                    href: "/user/orders",
+                },
                 { key: "apply-coupon", label: "Applying a coupon code at checkout works" },
                 { key: "remove-coupon", label: "Removing an already-applied coupon from the cart recalculates the total back down" },
                 { key: "remove-item", label: "Removing an item from the cart works" },

package/dist/index.d.ts

@@ -3125,7 +3125,7 @@ export type { SessionUser } from "./react/index";
 export type { UseUrlTableOptions } from "./react/index";
 export { SUCCESS_MESSAGES } from "./values/index";
 export { splitCartIntoOrderGroups } from "./features/orders/index";
-export { groupOrderItemsByBundle, type BundleOrderGroup, type OrderItemForBundleGrouping, } from "./features/orders/index";
+export { groupOrderItemsByLine, type LineOrderGroup, type OrderItemForLineGrouping, } from "./features/orders/index";
 export { buildSieveFilters } from "./utils/filter.helper";
 export { formatCurrency, formatFileSize } from "./utils/number.formatter";
 export { formatMonthYear } from "./utils/date.formatter";

package/dist/index.js

@@ -5530,7 +5530,7 @@ export { SUCCESS_MESSAGES } from "./values/index";
 // -- Missing order utils
 export { splitCartIntoOrderGroups } from "./features/orders/index";
 // S-SBUNI-5 2026-05-13 â€" bundle-aware order item grouping for receipts.
-export { groupOrderItemsByBundle, } from "./features/orders/index";
+export { groupOrderItemsByLine, } from "./features/orders/index";
 // -- Missing utils
 export { buildSieveFilters } from "./utils/filter.helper";
 export { formatCurrency, formatFileSize } from "./utils/number.formatter";

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

@@ -25,6 +25,12 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly PRE_ORDER_DETAIL: (id: string) => string;
         readonly BUNDLES: "/bundles";
         readonly BUNDLE_DETAIL: (slug: string) => string;
+        /**
+         * A `groupedListings` document's public page. Distinct from a product
+         * GROUP (`product.groupId`), whose canonical page is its parent product's
+         * detail page — see § "Bundles vs Product Groups vs Grouped Listings".
+         */
+        readonly GROUP_DETAIL: (slug: string) => string;
         readonly PRIZE_DRAWS: "/prize-draws";
         readonly PRIZE_DRAW_DETAIL: (slug: string) => string;
         readonly SELLER_GUIDE_BUNDLES: "/seller-guide/bundles";
@@ -407,6 +413,12 @@ export declare const ROUTES: {
         readonly PRE_ORDER_DETAIL: (id: string) => string;
         readonly BUNDLES: "/bundles";
         readonly BUNDLE_DETAIL: (slug: string) => string;
+        /**
+         * A `groupedListings` document's public page. Distinct from a product
+         * GROUP (`product.groupId`), whose canonical page is its parent product's
+         * detail page — see § "Bundles vs Product Groups vs Grouped Listings".
+         */
+        readonly GROUP_DETAIL: (slug: string) => string;
         readonly PRIZE_DRAWS: "/prize-draws";
         readonly PRIZE_DRAW_DETAIL: (slug: string) => string;
         readonly SELLER_GUIDE_BUNDLES: "/seller-guide/bundles";

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

@@ -14,6 +14,12 @@ export const DEFAULT_ROUTE_MAP = {
         // SB1-J — bundles + prize draws (additive, pages not yet built)
         BUNDLES: "/bundles",
         BUNDLE_DETAIL: (slug) => `/bundles/${slug}`,
+        /**
+         * A `groupedListings` document's public page. Distinct from a product
+         * GROUP (`product.groupId`), whose canonical page is its parent product's
+         * detail page — see § "Bundles vs Product Groups vs Grouped Listings".
+         */
+        GROUP_DETAIL: (slug) => `/groups/${slug}`,
         PRIZE_DRAWS: "/prize-draws",
         PRIZE_DRAW_DETAIL: (slug) => `/prize-draws/${slug}`,
         SELLER_GUIDE_BUNDLES: "/seller-guide/bundles",

package/dist/server-entry.d.ts

@@ -65,7 +65,7 @@ export { renderFaqOg, renderFaqOgImage, type FaqOgData, } from "./_internal/serv
 export { renderScamOg, renderScamOgImage, type ScamOgData, getScammerForDetail, getScammerProfilePageData as getScammerProfilePageDataCached, } from "./_internal/server/features/scams/index";
 export { getSearchResults, searchAction, type SearchQuery, } from "./_internal/server/features/search/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";
-export { getGroupedListingForDetail, getGroupedListingWithItems, listGroupedListings, listFeaturedGroupedListings, listSitemapGroupedListings, getGroupsForProduct, getGroupsWithItemsForProduct, GROUPED_LISTINGS_PAGE_SIZE, GROUPED_LISTINGS_FEATURED_LIMIT, GROUPED_LISTINGS_SITEMAP_LIMIT, type GroupedListingWithItems, type ListGroupedListingsParams, type SitemapGroupedListing, } 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, type GroupedListingWithItems, type ListGroupedListingsParams, type SitemapGroupedListing, type GroupedListingMetadataOptions, } from "./_internal/server/features/grouped/index";
 export { createCheckoutOrderAction, attachPaymentAction, verifyAndPlaceRazorpayOrderAction, previewCheckoutPricing, resolveShippingCost, formatShippingAddress, CHECKOUT_DEFAULT_COMMISSIONS, CHECKOUT_PAYMENT_METHODS, type CreateCheckoutOrderInput, type VerifyAndPlaceRazorpayOrderInput, type CheckoutOrderResult, type CheckoutPaymentMethod, type CheckoutPricingPreviewInput, type CheckoutPricingPreview, } from "./_internal/server/features/checkout/index";
 export { unitPriceFor, lineTotalFor, computePreOrderDepositAmount, } from "./_internal/shared/checkout/order-math";
 export { processRefundAction, type ProcessRefundInput, } from "./_internal/server/features/refunds/actions";

package/dist/server-entry.js

@@ -91,7 +91,7 @@ export { getSearchResults, searchAction, } from "./_internal/server/features/sea
 // 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";
 // 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, } 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";
 // SB-UNI-V — bundles data layer deleted; consumers should query
 // `categoriesRepository.findBySlugAndType(slug, "bundle")` /
 // `.listByType("bundle", opts)` / `.findById(id)` directly.

package/dist/server.d.ts

@@ -501,8 +501,10 @@ export { GoogleReviewsSection } from "./features/homepage/components/GoogleRevie
 export type { GoogleReviewsSectionProps } from "./features/homepage/components/GoogleReviewsSection";
 export { getProductForDetail, listSitemapProducts, computeRelatedItems, toProductItem, type SitemapProduct, type RelatedItemsResult, } from "./_internal/server/features/products/index";
 export { listPublicProducts, parsePublicProductParams, defaultAvailabilityForListingTypes, PUBLIC_PRODUCT_MAX_PAGE_SIZE, ANY_STATUS, type PublicProductListInput, type PublicProductListResult, type PublicProductListOptions, type PublicProductExecutor, type PublicProductQuery, } from "./_internal/server/features/products/index";
-export { getBundleForDetail, listBundleMembers, listFeaturedBundles, getRelatedBundles, resolveBundleMemberIds, resolveBundleOriginalTotal, resolveBundleCategorySlugs, buildBundleMetadata, renderBundleOg, renderBundleOgImage, addBundleToCartAction, type BundleDataOptions, type BundleMetadataOptions, type BundleOgData, } from "./_internal/server/features/bundles/index";
+export { getBundleForDetail, listBundleMembers, listFeaturedBundles, getRelatedBundles, resolveBundleMemberIds, resolveBundleOriginalTotal, findBundleMemberStores, resolveBundleCategorySlugs, buildBundleMetadata, renderBundleOg, renderBundleOgImage, addBundleToCartAction, type BundleDataOptions, type BundleMetadataOptions, type BundleOgData, } from "./_internal/server/features/bundles/index";
 export { getGroupsForProduct, getGroupsWithItemsForProduct, getGroupsForCategory, getGroupsForBrand } from "./_internal/server/features/grouped/index";
+export { getGroupedListingForDetail, getGroupedListingWithItems, buildGroupedListingMetadata, renderGroupedListingOg, type GroupedListingWithItems, type GroupedListingMetadataOptions, } from "./_internal/server/features/grouped/index";
+export { toPublicGroupMember, toPublicGroupMembers, type PublicGroupMember, } from "./_internal/server/features/products/group-members";
 export { getAuctionForDetail, getProductFeaturesForAuction } from "./_internal/server/features/auctions/index";
 export { getPreOrderForDetail, getProductFeaturesForPreOrder } from "./_internal/server/features/pre-orders/index";
 export { getStoreForDetail, listStoreProductsInitial, listStoreAuctionsInitial, listStorePreOrdersInitial, listSitemapStores } from "./_internal/server/features/stores/index";

package/dist/server.js

@@ -1356,8 +1356,12 @@ export { getProductForDetail, listSitemapProducts, computeRelatedItems, toProduc
 // share it so their filter semantics cannot drift (Root Cause #30).
 export { listPublicProducts, parsePublicProductParams, defaultAvailabilityForListingTypes, PUBLIC_PRODUCT_MAX_PAGE_SIZE, ANY_STATUS, } from "./_internal/server/features/products/index";
 // S-SBUNI-3/4 2026-05-13 — bundle data/metadata/og layer.
-export { getBundleForDetail, listBundleMembers, listFeaturedBundles, getRelatedBundles, resolveBundleMemberIds, resolveBundleOriginalTotal, resolveBundleCategorySlugs, buildBundleMetadata, renderBundleOg, renderBundleOgImage, addBundleToCartAction, } from "./_internal/server/features/bundles/index";
+export { getBundleForDetail, listBundleMembers, listFeaturedBundles, getRelatedBundles, resolveBundleMemberIds, resolveBundleOriginalTotal, findBundleMemberStores, resolveBundleCategorySlugs, buildBundleMetadata, renderBundleOg, renderBundleOgImage, addBundleToCartAction, } from "./_internal/server/features/bundles/index";
 export { getGroupsForProduct, getGroupsWithItemsForProduct, getGroupsForCategory, getGroupsForBrand } from "./_internal/server/features/grouped/index";
+// Public /groups/{slug} page — data, metadata and OG.
+export { getGroupedListingForDetail, getGroupedListingWithItems, buildGroupedListingMetadata, renderGroupedListingOg, } from "./_internal/server/features/grouped/index";
+// Allow-list projection for group members — see § "Public Data Projections".
+export { toPublicGroupMember, toPublicGroupMembers, } from "./_internal/server/features/products/group-members";
 export { getAuctionForDetail, getProductFeaturesForAuction } from "./_internal/server/features/auctions/index";
 export { getPreOrderForDetail, getProductFeaturesForPreOrder } from "./_internal/server/features/pre-orders/index";
 export { getStoreForDetail, listStoreProductsInitial, listStoreAuctionsInitial, listStorePreOrdersInitial, listSitemapStores } from "./_internal/server/features/stores/index";