@mohasinac/appkit 4.26.0 → 4.27.0

package/dist/_internal/server/features/bundles/data.d.ts

@@ -40,6 +40,25 @@ export declare const listBundleMembers: (bundle: Pick<CategoryDocument, "bundleP
  * displayed discount.
  */
 export declare function resolveBundleOriginalTotal(productIds: string[]): Promise<number | undefined>;
+/**
+ * Reject a bundle whose members belong to more than one seller.
+ *
+ * `storeId` is a SCALAR on the cart line, and it is simultaneously the
+ * order-splitting key and the key that per-store add-ons, coupons, shipping and
+ * payout all hang off. A bundle spanning two sellers therefore produces one
+ * order belonging to one of them while containing the other's products — the
+ * second seller gets no notification, no shipping resolution and no payout.
+ *
+ * Grouped cart lines refuse this at both the picker and the add-to-cart action.
+ * Bundles had no equivalent guard, so the only reason nothing was broken was
+ * that every bundle anyone had built happened to be single-store. This closes
+ * that at the point a bundle is SAVED, which is the cheapest place to say no:
+ * bundles already in the database keep working, and checkout is untouched.
+ *
+ * Returns the offending store ids (empty when fine) rather than throwing, so
+ * each route can phrase its own 400.
+ */
+export declare function findBundleMemberStores(productIds: string[]): Promise<string[]>;
 /**
  * Union of the member products' `categorySlugs` — the `bundleCategorySlugs`
  * mirror that lets a category page scope its Bundles tab.

package/dist/_internal/server/features/bundles/data.js

@@ -68,6 +68,38 @@ export async function resolveBundleOriginalTotal(productIds) {
     const total = prices.reduce((sum, p) => sum + p, 0);
     return Math.round(total * 100) / 100;
 }
+/**
+ * Reject a bundle whose members belong to more than one seller.
+ *
+ * `storeId` is a SCALAR on the cart line, and it is simultaneously the
+ * order-splitting key and the key that per-store add-ons, coupons, shipping and
+ * payout all hang off. A bundle spanning two sellers therefore produces one
+ * order belonging to one of them while containing the other's products — the
+ * second seller gets no notification, no shipping resolution and no payout.
+ *
+ * Grouped cart lines refuse this at both the picker and the add-to-cart action.
+ * Bundles had no equivalent guard, so the only reason nothing was broken was
+ * that every bundle anyone had built happened to be single-store. This closes
+ * that at the point a bundle is SAVED, which is the cheapest place to say no:
+ * bundles already in the database keep working, and checkout is untouched.
+ *
+ * Returns the offending store ids (empty when fine) rather than throwing, so
+ * each route can phrase its own 400.
+ */
+export async function findBundleMemberStores(productIds) {
+    if (productIds.length === 0)
+        return [];
+    const results = await Promise.all(productIds.map((id) => productRepository.findById(id).catch(() => null)));
+    const stores = new Set();
+    for (const p of results) {
+        // An unresolvable member says nothing about seller spread — the price
+        // helper above already refuses to guess in that case, and inventing a
+        // store here would produce a false positive that blocks a valid save.
+        if (p?.storeId)
+            stores.add(p.storeId);
+    }
+    return [...stores];
+}
 /**
  * Union of the member products' `categorySlugs` — the `bundleCategorySlugs`
  * mirror that lets a category page scope its Bundles tab.

package/dist/_internal/server/features/bundles/index.d.ts

@@ -1,4 +1,4 @@
-export { getBundleForDetail, listBundleMembers, listFeaturedBundles, getRelatedBundles, resolveBundleMemberIds, resolveBundleOriginalTotal, resolveBundleCategorySlugs, type BundleDataOptions, } from "./data";
+export { getBundleForDetail, listBundleMembers, listFeaturedBundles, getRelatedBundles, resolveBundleMemberIds, resolveBundleOriginalTotal, findBundleMemberStores, resolveBundleCategorySlugs, type BundleDataOptions, } from "./data";
 export { buildBundleMetadata, type BundleMetadataOptions } from "./metadata";
 export { renderBundleOg, renderBundleOgImage, type BundleOgData, } from "./og";
 export { addBundleToCartAction } from "./actions";

package/dist/_internal/server/features/bundles/index.js

@@ -1,4 +1,4 @@
-export { getBundleForDetail, listBundleMembers, listFeaturedBundles, getRelatedBundles, resolveBundleMemberIds, resolveBundleOriginalTotal, resolveBundleCategorySlugs, } from "./data";
+export { getBundleForDetail, listBundleMembers, listFeaturedBundles, getRelatedBundles, resolveBundleMemberIds, resolveBundleOriginalTotal, findBundleMemberStores, resolveBundleCategorySlugs, } from "./data";
 export { buildBundleMetadata } from "./metadata";
 // S-SBUNI-4 2026-05-13 — bundle OG renderer.
 export { renderBundleOg, renderBundleOgImage, } from "./og";

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

@@ -308,6 +308,111 @@ export const productsTesterSeedData = [
         createdAt: new Date(),
         updatedAt: new Date(),
     }),
+    // ── Grouped-cart-line fixtures ───────────────────────────────────────────
+    // Each of the three below exists to make ONE picker branch testable by hand.
+    // Without them the branch can only be reached by editing data live, which a
+    // reseed silently wipes out.
+    withTokens({
+        id: "product-tester-group-soldout",
+        slug: "product-tester-group-soldout",
+        title: "Test Part — Sold Out (Group Member)",
+        description: "A member of the tester product group that is deliberately out of stock. Exists so the group picker's blocked-member branch has real data: it must render a reason chip instead of a +/- stepper, and must not be selectable. Auto-expires in 7 days.",
+        categorySlugs: COLLECTIBLES_CATEGORY_SLUGS,
+        categoryNames: COLLECTIBLES_CATEGORY_NAMES,
+        brandSlug: "brand-tester-sandbox",
+        brand: "TestBrand",
+        price: 129,
+        currency: "INR",
+        stockQuantity: 0,
+        availableQuantity: 0,
+        isSold: true,
+        mainImage: seedExtMedia("https://picsum.photos/seed/product-image-tester-group-soldout-20260101/900/900"),
+        images: [seedExtMedia("https://picsum.photos/seed/product-image-tester-group-soldout-20260101/900/900")],
+        status: PRODUCT_FIELDS.STATUS_VALUES.PUBLISHED,
+        condition: PRODUCT_FIELDS.CONDITION_VALUES.NEW,
+        listingType: "standard",
+        customFields: [],
+        customSections: [],
+        isPromoted: false,
+        isOnSale: false,
+        gstRate: 18,
+        hsnCode: "95030090",
+        groupId: "group-tester-sandbox-bundle",
+        groupParentSlug: "group-tester-sandbox-bundle",
+        groupTitle: TESTER_GROUP_TITLE,
+        createdAt: new Date(),
+        updatedAt: new Date(),
+    }),
+    // A group whose members span TWO stores. `storeId` is the order-splitting key
+    // and the key per-store add-ons/coupons/shipping/payout hang off, so such a
+    // group can never become one cart line — the picker must stand down to a
+    // read-only table rather than offer a button that always fails.
+    // `withTokens` spreads `...p` last, so the storeId below overrides the
+    // sandbox default on purpose.
+    withTokens({
+        id: "product-tester-crossstore-a",
+        slug: "product-tester-crossstore-a",
+        title: "Test Cross-Store Set — Seller A",
+        description: "Parent of a deliberately CROSS-STORE tester group. Its sibling belongs to a different seller, so the group picker must render read-only with no quantity column and no \"Add selected\" button. Auto-expires in 7 days.",
+        categorySlugs: COLLECTIBLES_CATEGORY_SLUGS,
+        categoryNames: COLLECTIBLES_CATEGORY_NAMES,
+        brandSlug: "brand-tester-sandbox",
+        brand: "TestBrand",
+        price: 259,
+        currency: "INR",
+        stockQuantity: 6,
+        availableQuantity: 6,
+        isSold: false,
+        mainImage: seedExtMedia("https://picsum.photos/seed/product-image-tester-crossstore-a-20260101/900/900"),
+        images: [seedExtMedia("https://picsum.photos/seed/product-image-tester-crossstore-a-20260101/900/900")],
+        status: PRODUCT_FIELDS.STATUS_VALUES.PUBLISHED,
+        condition: PRODUCT_FIELDS.CONDITION_VALUES.NEW,
+        listingType: "standard",
+        customFields: [],
+        customSections: [],
+        isPromoted: false,
+        isOnSale: false,
+        gstRate: 18,
+        isGroupParent: true,
+        groupId: "group-tester-cross-store",
+        groupTitle: "Tester Cross-Store Set",
+        groupChildSlugs: ["product-tester-crossstore-b"],
+        createdAt: new Date(),
+        updatedAt: new Date(),
+    }),
+    withTokens({
+        id: "product-tester-crossstore-b",
+        slug: "product-tester-crossstore-b",
+        title: "Test Cross-Store Set — Seller B",
+        description: "Sibling of product-tester-crossstore-a, deliberately owned by a DIFFERENT store so the group spans two sellers. Still isTestData, so filterTestDataForViewer keeps it off that store's public listings for non-testers. Auto-expires in 7 days.",
+        categorySlugs: COLLECTIBLES_CATEGORY_SLUGS,
+        categoryNames: COLLECTIBLES_CATEGORY_NAMES,
+        brandSlug: "brand-tester-sandbox",
+        brand: "TestBrand",
+        price: 189,
+        currency: "INR",
+        stockQuantity: 6,
+        availableQuantity: 6,
+        isSold: false,
+        mainImage: seedExtMedia("https://picsum.photos/seed/product-image-tester-crossstore-b-20260101/900/900"),
+        images: [seedExtMedia("https://picsum.photos/seed/product-image-tester-crossstore-b-20260101/900/900")],
+        status: PRODUCT_FIELDS.STATUS_VALUES.PUBLISHED,
+        condition: PRODUCT_FIELDS.CONDITION_VALUES.NEW,
+        listingType: "standard",
+        customFields: [],
+        customSections: [],
+        isPromoted: false,
+        isOnSale: false,
+        gstRate: 12,
+        // The whole point of this fixture — a different seller from its sibling.
+        storeId: "store-beyblade-arena",
+        storeName: "Beyblade Arena",
+        groupId: "group-tester-cross-store",
+        groupParentSlug: "product-tester-crossstore-a",
+        groupTitle: "Tester Cross-Store Set",
+        createdAt: new Date(),
+        updatedAt: new Date(),
+    }),
     withTokens({
         id: "product-tester-standard-sold",
         slug: "product-tester-standard-sold",
@@ -687,6 +792,7 @@ export const productsTesterSeedData = [
             "product-tester-standard-1",
             "product-tester-standard-2",
             "product-tester-standard-3",
+            "product-tester-group-soldout",
         ],
         createdAt: new Date(),
         updatedAt: new Date(),

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

@@ -729,39 +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-add-selected",
-                    label: "On a product that is part of a group, \"Pick items →\" opens a picker with +/- per member, and \"Add selected to cart\" creates ONE cart line (not one per item)",
-                    description: "Use the Test Gadget page. Set two different members to different quantities, check the running total in the picker footer, then add. The cart should show a single line, not three.",
+                    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-line-editable-in-cart",
-                    label: "A grouped cart line expands to show its members, each with its own +/- and remove; removing the last member removes the whole line",
-                    description: "There should be NO line-level quantity stepper on a grouped line — the per-member steppers carry the whole selection. Changing one member should update both the line total and the seller subtotal.",
-                    href: "/cart",
+                    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 shows the read-only table with no quantity column and an explanation, rather than an \"Add selected\" button that always fails",
+                    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 on the bundle page, only the copies stepper.",
+                    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-editable-in-cart",
-                    label: "A bundle in the cart shows its member list read-only and a copies stepper; changing copies recalculates the line at the bundle's discounted price, not the sum of member prices",
+                    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 page with the same picker, reachable from the \"Pick items from this group →\" button on a group carousel",
+                    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/server.d.ts

@@ -501,7 +501,7 @@ 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";

package/dist/server.js

@@ -1356,7 +1356,7 @@ 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";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mohasinac/appkit",
-  "version": "4.26.0",
+  "version": "4.27.0",
   "license": "MIT",
   "publishConfig": {
     "access": "public"