@mohasinac/appkit 4.23.0 → 4.24.0

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

@@ -6,6 +6,53 @@
  */
 import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 import type { ListingType } from "../../products/types/index";
+/**
+ * What KIND of thing one cart line represents.
+ *
+ *  - absent      — an ordinary single-product line.
+ *  - `"bundle"`  — a fixed, all-or-nothing set priced as a whole
+ *                  (`categoryType:"bundle"` row on `categories`). Members are
+ *                  not pickable; the only stepper is the line-level one and it
+ *                  means COPIES OF THE BUNDLE.
+ *  - `"group"`   — a buyer-assembled selection out of a product group
+ *                  (`product.groupId`) or a `groupedListings` doc. Members ARE
+ *                  pickable; there is no line-level stepper.
+ */
+export type CartLineKind = "bundle" | "group";
+/** Which collection a `"group"` line's members were picked from. */
+export type CartGroupSource = "product-group" | "grouped-listing";
+/**
+ * One member product inside a multi-member cart line.
+ *
+ * 🛑 THE QUANTITY INVARIANT — every reader and writer depends on it:
+ *
+ *   `CartItemDocument.quantity` = copies of the whole selection
+ *   `CartLineMember.quantity`   = units of THIS member per copy
+ *   demand for a product        = item.quantity × member.quantity
+ *
+ * A `"group"` line pins `item.quantity` to 1, which is what lets `unitPriceFor`
+ * keep returning a UNIT price that every existing call site multiplies by
+ * `item.quantity` without double-counting. A `"bundle"` line is the mirror
+ * image: `item.quantity` is the editable one and member quantities are frozen
+ * at add time.
+ *
+ * Prices/titles/images are SNAPSHOTS taken server-side at add time. They are
+ * never accepted from the client — see `POST /api/cart/group`, which takes ids
+ * and quantities only.
+ */
+export interface CartLineMember {
+    productId: string;
+    /** Units of this member per copy of the line. See the invariant above. */
+    quantity: number;
+    /** Snapshot of the member's own price at add time, in decimal rupees. */
+    unitPrice: number;
+    title: string;
+    image?: string;
+    /** Snapshot for per-member GST proration at checkout (`lineTaxComponentsFor`). */
+    gstRate?: number;
+    hsnCode?: string;
+    listingType?: ListingType;
+}
 export interface CartItemDocument {
     itemId: string;
     productId: string;
@@ -64,16 +111,47 @@ export interface CartItemDocument {
     /**
      * SB-UNI-4 2026-05-13 — bundle identifier when this cart line represents a
      * bundle (categoryType:"bundle" row on the categories collection). When set,
-     * `productId` points at the bundle category's id, `price` is the locked
-     * bundlePrice, and `bundleProductIds` snapshots the member product
-     * ids at add-to-cart time. Order-side fan-out into per-product OrderItem
-     * entries lands in S-SBUNI-5 (checkout-side stock decrement + per-store
-     * grouping); until then the foundation is here but BundleDetailView keeps
-     * the "Add to cart coming soon" notice up.
+     * `productId` points at the bundle category's id and `price` is the locked
+     * bundlePrice.
+     *
+     * This is an IDENTITY, not a mirror — it is what the order-side collapse key
+     * (`groupOrderItemsByLine`) groups on, and it keeps being written.
      */
     bundleCategorySlug?: string;
-    /** Snapshot of `bundle.bundleProductIds` at add-to-cart time. */
+    /**
+     * @deprecated Legacy carts only. Superseded by `groupMembers`, which can
+     * express per-member quantities where a bare id array cannot.
+     *
+     * Do NOT write this from new code and do NOT read it directly — a
+     * hand-maintained mirror alongside `groupMembers` is exactly the drift
+     * Recurrent Root Cause #42 describes. Read through `getCartLineMembers()`
+     * (`_internal/server/features/checkout/bundle-expansion.ts`), which falls
+     * back to these ids at quantity 1 so lines written before `groupMembers`
+     * existed keep behaving byte-identically.
+     */
     bundleProductIds?: string[];
+    /**
+     * Discriminator for a multi-member line. Absent on an ordinary
+     * single-product line. See `CartLineKind` for the two behaviours.
+     */
+    lineKind?: CartLineKind;
+    /** Which collection the members came from. `"group"` lines only. */
+    groupSource?: CartGroupSource;
+    /** `product.groupId` | `groupedListing.id` | the bundle category's id. */
+    groupId?: string;
+    /** Slug for the line's detail href. Bundles use `bundleCategorySlug` instead. */
+    groupSlug?: string;
+    /** Display snapshot of the group/bundle name. */
+    groupTitle?: string;
+    /**
+     * The members of a multi-member line, AUTHORITATIVE over `bundleProductIds`.
+     * See `CartLineMember` for the quantity invariant.
+     *
+     * `price` on this document is derived from this array by the repository
+     * (`deriveLinePrice`) at every write, never set by a caller — so no caller
+     * can forget to keep the two in step.
+     */
+    groupMembers?: CartLineMember[];
     /**
      * S-SBUNI-RULES 2026-05-13 — buyer's chosen shipping provider for this
      * item, snapshotted at cart time. Locked at checkout; the per-tab
@@ -149,10 +227,32 @@ export declare const CART_FIELDS: {
         readonly STORE_ID: "storeId";
         readonly STORE_NAME: "storeName";
         readonly LISTING_TYPE: "listingType";
+        readonly IS_OFFER: "isOffer";
+        readonly OFFER_ID: "offerId";
+        readonly IS_AUCTION_WIN: "isAuctionWin";
+        readonly AUCTION_ID: "auctionId";
+        readonly BID_ID: "bidId";
+        readonly IS_BUYOUT: "isBuyout";
+        readonly LOCKED_PRICE: "lockedPrice";
+        readonly CHECKOUT_DEADLINE: "checkoutDeadline";
+        readonly LOCKED: "locked";
+        readonly BUNDLE_CATEGORY_SLUG: "bundleCategorySlug";
+        /** @deprecated legacy read path — see CartItemDocument.bundleProductIds */
+        readonly BUNDLE_PRODUCT_IDS: "bundleProductIds";
+        readonly LINE_KIND: "lineKind";
+        readonly GROUP_SOURCE: "groupSource";
+        readonly GROUP_ID: "groupId";
+        readonly GROUP_SLUG: "groupSlug";
+        readonly GROUP_TITLE: "groupTitle";
+        readonly GROUP_MEMBERS: "groupMembers";
+        readonly CHOSEN_SHIPPING_PROVIDER_ID: "chosenShippingProviderId";
+        readonly CHOSEN_SHIPPING_FEE: "chosenShippingFee";
         readonly ADDED_AT: "addedAt";
         readonly UPDATED_AT: "updatedAt";
     };
 };
+export declare const CART_LINE_KIND_VALUES: readonly ["bundle", "group"];
+export declare const CART_GROUP_SOURCE_VALUES: readonly ["product-group", "grouped-listing"];
 export declare const DEFAULT_CART_DATA: Partial<CartDocument>;
 export type CartCreateInput = Omit<CartDocument, "id" | "createdAt" | "updatedAt">;
 export type AddToCartInput = {
@@ -178,12 +278,36 @@ export type AddToCartInput = {
     locked?: boolean;
     /** SB-UNI-4 2026-05-13 — bundle identifier when the line is a bundle. */
     bundleCategorySlug?: string;
-    /** Snapshot of bundle members at add-to-cart time. */
+    /** @deprecated Legacy only — write `groupMembers` instead. */
     bundleProductIds?: string[];
+    lineKind?: CartLineKind;
+    groupSource?: CartGroupSource;
+    groupId?: string;
+    groupSlug?: string;
+    groupTitle?: string;
+    groupMembers?: CartLineMember[];
+};
+/**
+ * Input for creating a multi-member line. `price` is deliberately absent — the
+ * repository derives it from `groupMembers` so the two can never disagree.
+ */
+export type AddGroupLineInput = Omit<AddToCartInput, "price" | "groupMembers"> & {
+    groupMembers: CartLineMember[];
 };
 export type UpdateCartItemInput = {
     quantity: number;
 };
+/**
+ * Body of a per-member edit. The WHOLE array is sent, not a delta: the cart is
+ * a single Firestore document written with `set()`, so N per-member writes
+ * would be both a Rule #6 cost and a real lost-update race on a double-click.
+ */
+export type UpdateCartGroupMembersInput = {
+    groupMembers: Array<{
+        productId: string;
+        quantity: number;
+    }>;
+};
 export declare const cartQueryHelpers: {
     readonly byUserId: (userId: string) => {
         field: "userId";

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

@@ -23,10 +23,32 @@ export const CART_FIELDS = {
         STORE_ID: "storeId",
         STORE_NAME: "storeName",
         LISTING_TYPE: "listingType",
+        IS_OFFER: "isOffer",
+        OFFER_ID: "offerId",
+        IS_AUCTION_WIN: "isAuctionWin",
+        AUCTION_ID: "auctionId",
+        BID_ID: "bidId",
+        IS_BUYOUT: "isBuyout",
+        LOCKED_PRICE: "lockedPrice",
+        CHECKOUT_DEADLINE: "checkoutDeadline",
+        LOCKED: "locked",
+        BUNDLE_CATEGORY_SLUG: "bundleCategorySlug",
+        /** @deprecated legacy read path — see CartItemDocument.bundleProductIds */
+        BUNDLE_PRODUCT_IDS: "bundleProductIds",
+        LINE_KIND: "lineKind",
+        GROUP_SOURCE: "groupSource",
+        GROUP_ID: "groupId",
+        GROUP_SLUG: "groupSlug",
+        GROUP_TITLE: "groupTitle",
+        GROUP_MEMBERS: "groupMembers",
+        CHOSEN_SHIPPING_PROVIDER_ID: "chosenShippingProviderId",
+        CHOSEN_SHIPPING_FEE: "chosenShippingFee",
         ADDED_AT: "addedAt",
         UPDATED_AT: "updatedAt",
     },
 };
+export const CART_LINE_KIND_VALUES = ["bundle", "group"];
+export const CART_GROUP_SOURCE_VALUES = ["product-group", "grouped-listing"];
 export const DEFAULT_CART_DATA = {
     items: [],
 };

package/dist/features/email/index.d.ts

@@ -5,5 +5,5 @@
  * `renderToStaticMarkup`. They emit table-based, inline-styled markup that
  * email clients render correctly.
  */
-export { EmailButton, EmailColumn, EmailContainer, EmailDivider, EmailDoc, EmailFooter, EmailHeader, EmailImage, EmailLink, EmailRow, } from "./primitives";
+export { EmailBold, EmailButton, EmailColumn, EmailContainer, EmailDivider, EmailDoc, EmailFooter, EmailHeader, EmailImage, EmailLink, EmailRow, } from "./primitives";
 export type { EmailButtonProps, EmailColumnProps, EmailContainerProps, EmailDividerProps, EmailDocProps, EmailFooterProps, EmailHeaderProps, EmailImageProps, EmailLinkProps, EmailRowProps, EmailTone, } from "./primitives";

package/dist/features/email/index.js

@@ -5,4 +5,8 @@
  * `renderToStaticMarkup`. They emit table-based, inline-styled markup that
  * email clients render correctly.
  */
-export { EmailButton, EmailColumn, EmailContainer, EmailDivider, EmailDoc, EmailFooter, EmailHeader, EmailImage, EmailLink, EmailRow, } from "./primitives";
+export { 
+// Was MISSING from this barrel, so both consumers reached past it into
+// ./primitives directly — a workaround that reads as intentional and
+// quietly says "the barrel is not the public surface after all".
+EmailBold, EmailButton, EmailColumn, EmailContainer, EmailDivider, EmailDoc, EmailFooter, EmailHeader, EmailImage, EmailLink, EmailRow, } from "./primitives";

package/dist/features/email/notification-templates.d.ts

@@ -0,0 +1,35 @@
+import "server-only";
+import type { NotificationType } from "../admin/schemas/firestore";
+export interface NotificationEmailContext {
+    title: string;
+    message: string;
+    siteName: string;
+    /** Absolute URL the CTA opens. Absent → the email renders without a button. */
+    actionUrl?: string;
+}
+export interface NotificationTemplateDef {
+    /** CTA label. Absent → no button, for a type with nowhere to go. */
+    cta?: string;
+    /**
+     * One line of framing above the message, so the reader knows what KIND of
+     * mail this is before reading it. Deliberately not the message itself —
+     * duplicating it is worse than omitting it.
+     */
+    lead: string;
+    /** Terminal-negative types render in the danger tone. */
+    tone?: "default" | "danger" | "success";
+}
+/**
+ * 🛑 Every notification type, no exceptions.
+ *
+ * When adding a type, the compiler will ask for an entry here. Answer three
+ * questions: what does the reader need to know before the message (`lead`),
+ * where are they going (`cta`, or none if nowhere), and is this good news.
+ */
+export declare const NOTIFICATION_EMAIL_TEMPLATES: Record<NotificationType, NotificationTemplateDef>;
+/**
+ * Render one notification as an email.
+ *
+ * Returns the full HTML document, ready for `emailHtml`.
+ */
+export declare function renderNotificationEmail(type: NotificationType, ctx: NotificationEmailContext): string;

package/dist/features/email/notification-templates.js

@@ -0,0 +1,96 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import "server-only";
+import { EmailBold, EmailButton, EmailContainer, EmailDivider, EmailDoc, EmailFooter, EmailHeader, EmailRow, } from "./primitives";
+/**
+ * A real email per notification type.
+ *
+ * ## What this replaces
+ *
+ * `emailHtml` has existed on `SendNotificationInput` since the channel was
+ * built, and **0 of 40** call sites passed it — so every one of the 28
+ * notification types fell through to `html: \`<p>${message}</p>\``. A bare
+ * paragraph, no subject context, no branding, nothing to click. That is the
+ * reported "emails are sent but I can't understand what is being sent".
+ *
+ * ## Why a Record, not a lookup with a fallback
+ *
+ * `Record<NotificationType, TemplateDef>` — a new notification type cannot
+ * compile without an email. A `Partial` with a default would have let the
+ * next type silently go back to `<p>{message}</p>`, which is how the feature
+ * got here in the first place.
+ *
+ * ## The two structural constraints
+ *
+ * 1. **`renderToStaticMarkup` must be a lazy `require`.** A top-level
+ *    `import` from "react-dom/server" is flagged by Next's static tracer as
+ *    soon as any module in the re-export chain is reachable from a Server
+ *    Component — and this one is, via `@mohasinac/appkit/server`. `require()`
+ *    is opaque to that analyser, so the chain stops here. Same reason
+ *    `features/contact/email.tsx` does it.
+ * 2. **Never a raw `<table>`.** The `Email*` primitives emit the table-based,
+ *    inline-styled markup email clients actually render; hand-rolled markup
+ *    is what `audit-email-raw-html` blocks.
+ */
+// See constraint (1) above — this MUST stay a lazy require.
+function renderToStaticMarkup(el) {
+    const m = require("react-dom/server");
+    return m.renderToStaticMarkup(el);
+}
+/**
+ * 🛑 Every notification type, no exceptions.
+ *
+ * When adding a type, the compiler will ask for an entry here. Answer three
+ * questions: what does the reader need to know before the message (`lead`),
+ * where are they going (`cta`, or none if nowhere), and is this good news.
+ */
+export const NOTIFICATION_EMAIL_TEMPLATES = {
+    order_placed: { lead: "We've received your order.", cta: "View order", tone: "success" },
+    order_confirmed: { lead: "Your order is confirmed and being prepared.", cta: "View order", tone: "success" },
+    order_shipped: { lead: "Your order is on its way.", cta: "Track order", tone: "success" },
+    order_delivered: { lead: "Your order has been delivered.", cta: "View order", tone: "success" },
+    order_cancelled: { lead: "Your order has been cancelled.", cta: "View order", tone: "danger" },
+    refund_initiated: { lead: "A refund is on its way back to you.", cta: "View order" },
+    payment_review: { lead: "There's an update on your payment.", cta: "View payment" },
+    emi_installment_due_soon: { lead: "An EMI installment is due soon.", cta: "View order" },
+    emi_installment_overdue: { lead: "An EMI installment is overdue.", cta: "View order", tone: "danger" },
+    bid_placed: { lead: "Your bid has been placed.", cta: "View bids" },
+    bid_outbid: { lead: "Someone has outbid you.", cta: "View bids", tone: "danger" },
+    bid_won: { lead: "You won the auction.", cta: "Complete checkout", tone: "success" },
+    bid_lost: { lead: "This auction closed without you.", cta: "View bids" },
+    auction_ended: { lead: "Your auction has ended.", cta: "View auction" },
+    offer_received: { lead: "A buyer has made you an offer.", cta: "Review offer" },
+    offer_responded: { lead: "The seller has responded to your offer.", cta: "View offer" },
+    offer_counter_accepted: { lead: "Your counter-offer was accepted.", cta: "Complete checkout", tone: "success" },
+    offer_expired: { lead: "An offer has expired.", cta: "View offers" },
+    prize_won: { lead: "You've won a prize.", cta: "View prize", tone: "success" },
+    prize_reveal_expired: { lead: "A prize reveal window has closed.", cta: "View prize draws" },
+    review_approved: { lead: "A review has been published.", cta: "Read review" },
+    review_replied: { lead: "Someone replied to your review.", cta: "Read reply" },
+    product_available: { lead: "Something you were watching is back in stock.", cta: "View listing" },
+    catalogue_images_stale: { lead: "Your catalogue photos need refreshing.", cta: "Update photos" },
+    welcome: { lead: "Welcome aboard.", cta: "Go to your account", tone: "success" },
+    account_action: { lead: "There's been a change to your account.", cta: "View account" },
+    // No CTA: a promotion's destination is whatever the copy names, and a
+    // generic "View" button on a marketing mail is worse than none.
+    promotion: { lead: "An offer you might like." },
+    // No CTA for the same reason — a system announcement has no record behind
+    // it, and `resolveNotificationActionUrl` correctly returns undefined.
+    system: { lead: "A message from the team." },
+};
+/**
+ * Render one notification as an email.
+ *
+ * Returns the full HTML document, ready for `emailHtml`.
+ */
+export function renderNotificationEmail(type, ctx) {
+    const def = NOTIFICATION_EMAIL_TEMPLATES[type];
+    /*
+     * `EmailButton` takes a narrower tone set than `EmailTone` — brand / accent
+     * / neutral only, because a button is a call to action and there is no
+     * useful "danger" button. So the template's tone drives the BUTTON's
+     * emphasis, not its colour: bad news gets the neutral button ("View order"
+     * on a cancellation should not shout), good news gets the brand one.
+     */
+    const buttonTone = def.tone === "danger" ? "neutral" : "brand";
+    return `<!DOCTYPE html>${renderToStaticMarkup(_jsx(EmailDoc, { title: ctx.title, children: _jsxs(EmailContainer, { children: [_jsx(EmailHeader, { brandName: ctx.siteName }), _jsxs(EmailRow, { children: [_jsx(EmailBold, { children: ctx.title }), _jsx("br", {}), _jsx("br", {}), def.lead] }), _jsx(EmailDivider, {}), _jsx(EmailRow, { children: ctx.message }), def.cta && ctx.actionUrl ? (_jsx(EmailRow, { children: _jsx(EmailButton, { href: ctx.actionUrl, tone: buttonTone, children: def.cta }) })) : null, _jsx(EmailFooter, { copyright: `© ${ctx.siteName}` })] }) }))}`;
+}

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

@@ -612,6 +612,7 @@ export declare const orderFirestoreSchema: z.ZodObject<{
         shelf: string;
         bin: string;
     } | undefined;
+    offerId?: string | undefined;
     orderType?: string | undefined;
     imageUrls?: string[] | undefined;
     refundFeeDeducted?: number | undefined;
@@ -649,7 +650,6 @@ export declare const orderFirestoreSchema: z.ZodObject<{
     }[] | undefined;
     emiRemainingBalance?: number | undefined;
     emiComplete?: boolean | undefined;
-    offerId?: string | undefined;
     isNonRefundable?: boolean | undefined;
     paymentBatchId?: string | undefined;
     refunds?: {
@@ -760,6 +760,7 @@ export declare const orderFirestoreSchema: z.ZodObject<{
         shelf: string;
         bin: string;
     } | undefined;
+    offerId?: string | undefined;
     orderType?: string | undefined;
     imageUrls?: string[] | undefined;
     refundFeeDeducted?: number | undefined;
@@ -797,7 +798,6 @@ export declare const orderFirestoreSchema: z.ZodObject<{
     }[] | undefined;
     emiRemainingBalance?: number | undefined;
     emiComplete?: boolean | undefined;
-    offerId?: string | undefined;
     isNonRefundable?: boolean | undefined;
     paymentBatchId?: string | undefined;
     refunds?: {

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

@@ -1156,6 +1156,36 @@ const rawTesterChecklistItems = [
                     description: "The fix had to cover the update path as well as create — a create-only fix would mean the listing saved correctly and then lost its per-type block the first time anyone edited anything else (Root Cause #39).",
                     href: "/store/classified",
                 },
+                {
+                    key: "notification-email-is-a-real-email",
+                    label: "A notification email has a heading, a lead line and a button — not one bare paragraph",
+                    description: "`emailHtml` existed on the input since the channel was built and 0 of 40 call sites passed it, so all 28 notification types shipped `<p>{message}</p>`. Trigger any notification that emails (place an order as a buyer). The mail must carry the site header, a bold title, a one-line lead saying what kind of mail it is, the message, and a CTA button.",
+                    href: "/user/notifications",
+                },
+                {
+                    key: "notification-click-lands-on-the-right-page",
+                    label: "Clicking a notification opens the record it is about, in YOUR portal",
+                    description: "actionUrl was set by 5 of 40 writers, so 35 notifications had nothing to click. It is now resolved centrally from relatedType + relatedId + audience. Check that an order notification opens /user/orders/view/... for the buyer and /store/orders/.../view for the seller — the SAME event, two destinations. A bid or offer lands on the list, deliberately: no per-record page exists in any role yet.",
+                    href: "/user/notifications",
+                },
+                {
+                    key: "admin-can-filter-every-notification-type",
+                    label: "The admin notifications filter offers all 28 types, and no imaginary ones",
+                    description: "The chips came from a hand-written 9-value list while the document held 27 — so 18 real types were unfilterable and two chips (`review_posted`, `payout_processed`) matched zero rows because no notification has ever had those values. The list is derived now. Confirm `offer_received` and `payment_review` are both present.",
+                    href: "/admin/notifications",
+                },
+                {
+                    key: "admin-can-allowlist-every-type-per-channel",
+                    label: "Site Settings can allow-list offer and payment-review notifications for email",
+                    description: "Same 9-value list fed the per-channel allow-list, so an admin literally could not allow-list `offer_received` or `payment_review` — the toggle did not exist. Open Site Settings → Notifications and confirm every type appears in the per-channel type picker.",
+                    href: "/admin/site",
+                },
+                {
+                    key: "notification-optout-is-honoured-for-emi-and-payment",
+                    label: "Turning off order updates actually stops EMI and payment-review emails",
+                    description: "`typeToPrefsKey` was a Partial map missing `emi_installment_due_soon`, `emi_installment_overdue` and `payment_review` — and a missing key meant the opt-out check never ran, so the user's setting was silently ignored while reading as honoured. Turn off Order updates in /user/settings, then trigger a payment-review notification and confirm no email arrives.",
+                    href: "/user/settings",
+                },
                 {
                     key: "ticket-resolution-timestamp-stamped",
                     label: "Resolving a support ticket records WHEN it was resolved",

package/dist/index.d.ts

@@ -678,7 +678,8 @@ export { groupedListingsSeedData } from "./seed/index";
 export type { CouponDiscountType } from "./seed/index";
 export type { FirestoreIndexConfig } from "./seed/index";
 export type { HomepageSectionType } from "./seed/index";
-export type { NotificationType } from "./seed/index";
+export type { NotificationType } from "./features/admin/schemas/firestore";
+export { NOTIFICATION_TYPE_VALUES } from "./features/admin/schemas/firestore";
 export type { PayoutStatus } from "./seed/index";
 export type { SeedAddressDocument } from "./seed/index";
 export type { SeedBaseOrderDocument } from "./seed/index";
@@ -1047,7 +1048,6 @@ export type { UserAccountHubViewProps } from "./features/account/index";
 export type { UserAddress } from "./features/account/index";
 export type { UserAddressesViewLabels } from "./features/account/index";
 export type { UserAddressesViewProps } from "./features/account/index";
-export type { UserNotification } from "./features/account/index";
 export type { UserNotificationsViewLabels } from "./features/account/index";
 export type { UserNotificationsViewProps } from "./features/account/index";
 export type { UserOffer } from "./features/account/index";
@@ -1551,7 +1551,7 @@ export { updateBlogPostSchema } from "./features/blog/server";
 export type { BlogPostDetailResponse } from "./features/blog/server";
 export type { CreateBlogPostInput } from "./features/blog/server";
 export type { UpdateBlogPostInput } from "./features/blog/server";
-export { addItemToCart } from "./features/cart/server";
+export { addItemToCart, assertCanAddNewItems } from "./features/cart/server";
 export { clearCart } from "./features/cart/server";
 export { getCart } from "./features/cart/server";
 export { mergeGuestCart } from "./features/cart/server";

package/dist/index.js

@@ -1395,6 +1395,7 @@ export { conversationsSeedData } from "./seed/index";
 // SB-UNI-B â€" sublistingCategoriesSeedData merged into categoriesSeedData with categoryType:"sublisting".
 // groupedListingsSeedData - Model for grouped listings seed data.
 export { groupedListingsSeedData } from "./seed/index";
+export { NOTIFICATION_TYPE_VALUES } from "./features/admin/schemas/firestore";
 // ./monitoring/index
 // [UTIL]-Pure utility â€" no framework or runtime dependency; safe to import from any environment.
 // ANALYTICS_EVENTS - Constant used across modules.
@@ -2910,7 +2911,8 @@ export { updateBlogPostSchema } from "./features/blog/server";
 // ./features/cart/server
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // addItemToCart - Helper for add item to cart.
-export { addItemToCart } from "./features/cart/server";
+// assertCanAddNewItems - the lane gate every add-to-cart entry point must run.
+export { addItemToCart, assertCanAddNewItems } from "./features/cart/server";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // clearCart - Shared export for clear cart.
 export { clearCart } from "./features/cart/server";

package/dist/schemas/registry.d.ts

@@ -2658,6 +2658,7 @@ export declare const SCHEMAS: {
                 shelf: string;
                 bin: string;
             } | undefined;
+            offerId?: string | undefined;
             orderType?: string | undefined;
             imageUrls?: string[] | undefined;
             refundFeeDeducted?: number | undefined;
@@ -2695,7 +2696,6 @@ export declare const SCHEMAS: {
             }[] | undefined;
             emiRemainingBalance?: number | undefined;
             emiComplete?: boolean | undefined;
-            offerId?: string | undefined;
             isNonRefundable?: boolean | undefined;
             paymentBatchId?: string | undefined;
             refunds?: {
@@ -2806,6 +2806,7 @@ export declare const SCHEMAS: {
                 shelf: string;
                 bin: string;
             } | undefined;
+            offerId?: string | undefined;
             orderType?: string | undefined;
             imageUrls?: string[] | undefined;
             refundFeeDeducted?: number | undefined;
@@ -2843,7 +2844,6 @@ export declare const SCHEMAS: {
             }[] | undefined;
             emiRemainingBalance?: number | undefined;
             emiComplete?: boolean | undefined;
-            offerId?: string | undefined;
             isNonRefundable?: boolean | undefined;
             paymentBatchId?: string | undefined;
             refunds?: {

package/dist/seed/factories/notification.factory.d.ts

@@ -1,4 +1,5 @@
-export type NotificationType = "order_placed" | "order_shipped" | "order_delivered" | "order_cancelled" | "bid_outbid" | "bid_won" | "review_received" | "payout_completed" | "system";
+import type { NotificationType } from "../../features/admin/schemas/firestore";
+export type { NotificationType };
 export interface SeedNotificationDocument {
     id: string;
     userId: string;

package/dist/server-entry.d.ts

@@ -67,6 +67,7 @@ export { getSearchResults, searchAction, type SearchQuery, } from "./_internal/s
 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 { 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";
 export { createPaymentIntentAction, verifyPaymentSignatureAction, resolvePaymentFee, PAYMENTS_DEFAULT_PLATFORM_FEE_PERCENT, PAYMENTS_DEFAULT_GST_PERCENT, PAYMENTS_RECEIPT_PREFIX, type CreatePaymentIntentInput, type CreatePaymentIntentResult, type VerifyPaymentSignatureInput, type ResolvedPaymentFee, } from "./_internal/server/features/payments/index";
 export { getSublistingCategoryForDetail } from "./_internal/server/features/sublisting-categories/index";

package/dist/server-entry.js

@@ -97,6 +97,11 @@ export { getGroupedListingForDetail, getGroupedListingWithItems, listGroupedList
 // `.listByType("bundle", opts)` / `.findById(id)` directly.
 // S4: checkout actions
 export { createCheckoutOrderAction, attachPaymentAction, verifyAndPlaceRazorpayOrderAction, previewCheckoutPricing, resolveShippingCost, formatShippingAddress, CHECKOUT_DEFAULT_COMMISSIONS, CHECKOUT_PAYMENT_METHODS, } from "./_internal/server/features/checkout/index";
+// 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
+// for an accepted offer. Pure math — no Firestore, no server-only imports.
+export { unitPriceFor, lineTotalFor, computePreOrderDepositAmount, } from "./_internal/shared/checkout/order-math";
 // S-SBUNI-RULES: refund action
 export { processRefundAction, } from "./_internal/server/features/refunds/actions";
 // S4: payments actions

package/dist/server.d.ts

@@ -231,7 +231,7 @@ export { getLatestBlogPosts } from "./features/blog/server";
 export { listBlogPosts } from "./features/blog/server";
 export { updateBlogPost } from "./features/blog/server";
 export { updateBlogPostSchema } from "./features/blog/server";
-export { addItemToCart } from "./features/cart/server";
+export { addItemToCart, assertCanAddNewItems } from "./features/cart/server";
 export { clearCart } from "./features/cart/server";
 export { getCart } from "./features/cart/server";
 export { mergeGuestCart } from "./features/cart/server";
@@ -573,3 +573,7 @@ export { toClientLotterySlot, toClientLotteryConfig } from "./_internal/server/f
 export { buildLotteryMetadata } from "./_internal/server/features/lottery/metadata";
 export { submitLotteryPullAction, flagLotteryEntryAction, reopenLotterySlotAction, createLotteryEventAction, updateLotteryEventAction, setProductLotteryModeAction, } from "./_internal/server/features/lottery/actions";
 export { lotteryEntryRepository } from "./features/lottery/repository/lottery-entry.repository";
+export { renderNotificationEmail, NOTIFICATION_EMAIL_TEMPLATES, } from "./features/email/notification-templates";
+export type { NotificationTemplateDef, NotificationEmailContext, } from "./features/email/notification-templates";
+export { resolveNotificationActionUrl, } from "./_internal/shared/features/notifications/action-url";
+export type { NotificationAudience } from "./_internal/shared/features/notifications/action-url";

package/dist/server.js

@@ -658,7 +658,8 @@ export { updateBlogPost } from "./features/blog/server";
 export { updateBlogPostSchema } from "./features/blog/server";
 // [SERVER-ONLY]-Server-only — uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // addItemToCart - Helper for add item to cart.
-export { addItemToCart } from "./features/cart/server";
+// assertCanAddNewItems - the lane gate every add-to-cart entry point must run.
+export { addItemToCart, assertCanAddNewItems } from "./features/cart/server";
 // [SERVER-ONLY]-Server-only — uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // clearCart - Shared export for clear cart.
 export { clearCart } from "./features/cart/server";
@@ -1444,3 +1445,11 @@ export { toClientLotterySlot, toClientLotteryConfig } from "./_internal/server/f
 export { buildLotteryMetadata } from "./_internal/server/features/lottery/metadata";
 export { submitLotteryPullAction, flagLotteryEntryAction, reopenLotterySlotAction, createLotteryEventAction, updateLotteryEventAction, setProductLotteryModeAction, } from "./_internal/server/features/lottery/actions";
 export { lotteryEntryRepository } from "./features/lottery/repository/lottery-entry.repository";
+/*
+ * Notification email templates + the shared actionUrl resolver.
+ *
+ * Server-only: the templates call `renderToStaticMarkup` through a lazy
+ * `require`, which must never end up reachable from a client chunk.
+ */
+export { renderNotificationEmail, NOTIFICATION_EMAIL_TEMPLATES, } from "./features/email/notification-templates";
+export { resolveNotificationActionUrl, } from "./_internal/shared/features/notifications/action-url";