@mohasinac/appkit 4.44.0 → 4.45.0

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

@@ -1,5 +1,5 @@
 import { cache } from "react";
-import { blogRepository } from "../../../../repositories";
+import { blogRepository } from "../../../../repositories/index.js";
 export const getBlogPostForDetail = cache(async (slug) => {
     return (await blogRepository.findBySlug(slug)) ?? null;
 });

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

@@ -1,5 +1,5 @@
-export { getBlogPostForDetail, getBlogPostById } from "./data";
-export { assertBlogPostExists, computeReadTime } from "./service";
-export { createBlogPostAction, updateBlogPostAction, deleteBlogPostAction, publishBlogPostAction, unpublishBlogPostAction, } from "./actions";
-export { BLOG_PAGE_SIZE, BLOG_FEATURED_LIMIT, BLOG_RELATED_LIMIT, BLOG_SITEMAP_LIMIT, } from "../../../shared/features/blog/config";
-export { renderBlogOgImage, renderBlogOg } from "./og";
+export { getBlogPostForDetail, getBlogPostById } from "./data.js";
+export { assertBlogPostExists, computeReadTime } from "./service.js";
+export { createBlogPostAction, updateBlogPostAction, deleteBlogPostAction, publishBlogPostAction, unpublishBlogPostAction, } from "./actions.js";
+export { BLOG_PAGE_SIZE, BLOG_FEATURED_LIMIT, BLOG_RELATED_LIMIT, BLOG_SITEMAP_LIMIT, } from "../../../shared/features/blog/config.js";
+export { renderBlogOgImage, renderBlogOg } from "./og.js";

package/dist/_internal/server/features/blog/og.js

@@ -1,5 +1,5 @@
-import { renderOgLayout } from "../seo/og-layout";
-import { resolveOgImageUrl } from "../seo/og";
+import { renderOgLayout } from "../seo/og-layout.js";
+import { resolveOgImageUrl } from "../seo/og.js";
 /** High-level OG renderer — accepts the raw blog post document from `getBlogPostForDetail`. */
 export function renderBlogOg(doc, opts) {
     const rawCoverImage = typeof doc?.coverImage === "string"

package/dist/_internal/server/features/blog/service.js

@@ -1,5 +1,5 @@
-import { blogRepository } from "../../../../repositories";
-import { BlogPostNotFoundError, BlogSlugConflictError } from "../../../shared/features/blog/errors";
+import { blogRepository } from "../../../../repositories/index.js";
+import { BlogPostNotFoundError, BlogSlugConflictError } from "../../../shared/features/blog/errors.js";
 export async function assertBlogPostExists(slugOrId) {
     const post = await blogRepository.findBySlug(slugOrId)
         ?? await blogRepository.findById(slugOrId);

package/dist/_internal/server/features/brands/actions.js

@@ -1,10 +1,10 @@
 "use server";
 import { wrapAction } from "@mohasinac/appkit/server";
-import { categoriesRepository } from "../../../../repositories";
-import { requireRoleUser } from "../../../../providers/auth-firebase/helpers";
-import { brandInputSchema, brandUpdateSchema } from "../../../shared/features/brands/schema";
-import { assertBrandExists, assertBrandSlugUnique } from "./service";
-import { ValidationError } from "../../../shared/errors/index";
+import { categoriesRepository } from "../../../../repositories/index.js";
+import { requireRoleUser } from "../../../../providers/auth-firebase/helpers.js";
+import { brandInputSchema, brandUpdateSchema } from "../../../shared/features/brands/schema.js";
+import { assertBrandExists, assertBrandSlugUnique } from "./service.js";
+import { ValidationError } from "../../../shared/errors/index.js";
 /**
  * Translate the brand-input wire format (logoURL / bannerURL / website /
  * country / founded) to the CategoryDocument storage shape after

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

@@ -1,5 +1,5 @@
 import { cache } from "react";
-import { categoriesRepository } from "../../../../repositories";
+import { categoriesRepository } from "../../../../repositories/index.js";
 /**
  * Brand detail loader — SB-UNI-C moved brands into the `categories`
  * collection with `categoryType: "brand"`. Both `generateMetadata` and

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

@@ -1,5 +1,5 @@
-export { getBrandForDetail, getBrandCategoryForDetail } from "./data";
-export { assertBrandExists, assertBrandSlugUnique } from "./service";
-export { createBrandAction, updateBrandAction, deleteBrandAction, toggleBrandActiveAction } from "./actions";
-export { BRANDS_PAGE_SIZE, BRANDS_FEATURED_LIMIT, BRAND_NAME_MAX_LENGTH, } from "../../../shared/features/brands/config";
-export { renderBrandOgImage, renderBrandOg } from "./og";
+export { getBrandForDetail, getBrandCategoryForDetail } from "./data.js";
+export { assertBrandExists, assertBrandSlugUnique } from "./service.js";
+export { createBrandAction, updateBrandAction, deleteBrandAction, toggleBrandActiveAction } from "./actions.js";
+export { BRANDS_PAGE_SIZE, BRANDS_FEATURED_LIMIT, BRAND_NAME_MAX_LENGTH, } from "../../../shared/features/brands/config.js";
+export { renderBrandOgImage, renderBrandOg } from "./og.js";

package/dist/_internal/server/features/brands/og.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { resolveOgImageUrl } from "../seo/og";
+import { resolveOgImageUrl } from "../seo/og.js";
 /** High-level OG renderer — accepts the raw brand document from `getBrandForDetail`. */
 export function renderBrandOg(doc, opts) {
     const name = doc?.name ?? "Brand";

package/dist/_internal/server/features/brands/service.js

@@ -1,5 +1,5 @@
-import { categoriesRepository } from "../../../../repositories";
-import { BrandNotFoundError, BrandSlugConflictError } from "../../../shared/features/brands/errors";
+import { categoriesRepository } from "../../../../repositories/index.js";
+import { BrandNotFoundError, BrandSlugConflictError } from "../../../shared/features/brands/errors.js";
 export async function assertBrandExists(slugOrId) {
     const brand = (await categoriesRepository.findBySlugAndType(slugOrId, "brand")) ??
         (await categoriesRepository.findById(slugOrId));

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

@@ -12,14 +12,14 @@
  * bundleCategorySlug + bundleProductIds so checkout's bundle-expansion
  * helpers can fan out stock decrements to member products.
  */
-import { NotFoundError, ValidationError } from "../../../../errors";
-import { safeRead } from "../../../../errors/safe-read";
-import { categoriesRepository } from "../../../../repositories";
-import { cartRepository } from "../../../../features/cart/repository/cart.repository";
-import { assertCanAddNewItems } from "../../../../features/cart/actions/cart-actions";
-import { productRepository } from "../../../../features/products/repository/products.repository";
-import { normalizeListingType } from "../../../../features/products/utils/listing-type";
-import { getDefaultCurrency } from "../../../../core/baseline-resolver";
+import { NotFoundError, ValidationError } from "../../../../errors/index.js";
+import { safeRead } from "../../../../errors/safe-read.js";
+import { categoriesRepository } from "../../../../repositories/index.js";
+import { cartRepository } from "../../../../features/cart/repository/cart.repository.js";
+import { assertCanAddNewItems } from "../../../../features/cart/actions/cart-actions.js";
+import { productRepository } from "../../../../features/products/repository/products.repository.js";
+import { normalizeListingType } from "../../../../features/products/utils/listing-type.js";
+import { getDefaultCurrency } from "../../../../core/baseline-resolver.js";
 export async function addBundleToCartAction(userId, bundleSlug, 
 /** Number of COPIES of the whole bundle. Bundles are all-or-nothing, so this
  *  is the only quantity a buyer can change — member quantities are fixed. */

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

@@ -6,10 +6,10 @@
  * and its `generateMetadata` share one Firestore read per request.
  */
 import { cache } from "react";
-import { categoriesRepository } from "../../../../repositories";
-import { productRepository } from "../../../../repositories";
-import { safeRead } from "../../../../errors/safe-read";
-import { hidePublicTestData } from "../tester/visibility";
+import { categoriesRepository } from "../../../../repositories/index.js";
+import { productRepository } from "../../../../repositories/index.js";
+import { safeRead } from "../../../../errors/safe-read.js";
+import { hidePublicTestData } from "../tester/visibility.js";
 /**
  * Fetch a single bundle by slug for the public detail page. Returns null
  * when the slug is empty or no matching `categoryType:"bundle"` row exists.

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

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

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

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { resolveOgImageUrl } from "../seo/og";
+import { resolveOgImageUrl } from "../seo/og.js";
 export function renderBundleOg(doc, opts) {
     const name = doc?.name ?? "Bundle";
     return renderBundleOgImage({

package/dist/_internal/server/features/cart/actions.js

@@ -1,10 +1,10 @@
 "use server";
 import { wrapAction } from "@mohasinac/appkit/server";
-import { cartRepository } from "../../../../repositories";
-import { requireRoleUser } from "../../../../providers/auth-firebase/helpers";
-import { addToCartSchema, removeFromCartSchema, mergeGuestCartSchema } from "../../../shared/features/cart/schema";
-import { upsertCartItem, mergeGuestItems } from "./service";
-import { ValidationError } from "../../../shared/errors/index";
+import { cartRepository } from "../../../../repositories/index.js";
+import { requireRoleUser } from "../../../../providers/auth-firebase/helpers.js";
+import { addToCartSchema, removeFromCartSchema, mergeGuestCartSchema } from "../../../shared/features/cart/schema.js";
+import { upsertCartItem, mergeGuestItems } from "./service.js";
+import { ValidationError } from "../../../shared/errors/index.js";
 export async function addToCartAction(input) {
     return wrapAction(async () => {
         const user = await requireRoleUser(["user", "buyer", "seller", "admin"]);

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

@@ -1,5 +1,5 @@
 import { cache } from "react";
-import { cartRepository } from "../../../../repositories";
+import { cartRepository } from "../../../../repositories/index.js";
 export const getCartForUser = cache(async (userId) => {
     // No catch: this cart IS the page. Degrading a Firestore failure to null
     // renders an EMPTY CART to someone whose cart is full — money path.

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

@@ -1,4 +1,4 @@
-export { getCartForUser } from "./data";
-export { assertCartCapacity, upsertCartItem, mergeGuestItems } from "./service";
-export { addToCartAction, removeFromCartAction, clearCartAction, mergeGuestCartAction } from "./actions";
-export { CART_MAX_ITEMS, CART_GUEST_STORAGE_KEY } from "../../../shared/features/cart/config";
+export { getCartForUser } from "./data.js";
+export { assertCartCapacity, upsertCartItem, mergeGuestItems } from "./service.js";
+export { addToCartAction, removeFromCartAction, clearCartAction, mergeGuestCartAction } from "./actions.js";
+export { CART_MAX_ITEMS, CART_GUEST_STORAGE_KEY } from "../../../shared/features/cart/config.js";

package/dist/_internal/server/features/cart/service.js

@@ -1,8 +1,8 @@
-import { cartRepository } from "../../../../repositories";
-import { CART_MAX_ITEMS } from "../../../shared/features/cart/config";
-import { CartFullError, CartQuantityError } from "../../../shared/features/cart/errors";
-import { normalizeError } from "../../../../errors/normalize";
-import { serverLogger } from "../../../../monitoring/server-logger";
+import { cartRepository } from "../../../../repositories/index.js";
+import { CART_MAX_ITEMS } from "../../../shared/features/cart/config.js";
+import { CartFullError, CartQuantityError } from "../../../shared/features/cart/errors.js";
+import { normalizeError } from "../../../../errors/normalize.js";
+import { serverLogger } from "../../../../monitoring/server-logger.js";
 export async function assertCartCapacity(userId, addingQty) {
     // No catch. Swallowing to null made `currentItemCount` 0, so a Firestore
     // failure silently DISABLED the cart cap and let the add through — a guard

package/dist/_internal/server/features/catalogue/og.js

@@ -1,5 +1,5 @@
-import { renderOgLayout } from "../seo/og-layout";
-import { resolveOgImageUrl } from "../seo/og";
+import { renderOgLayout } from "../seo/og-layout.js";
+import { resolveOgImageUrl } from "../seo/og.js";
 export function renderCatalogueItemOg(doc, opts) {
     return renderCatalogueItemOgImage({
         title: doc?.title ?? "Catalogue Item",

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

@@ -1,9 +1,9 @@
 "use server";
 import { cache } from "react";
-import { categoriesRepository } from "../../../../repositories";
-import { safeRead } from "../../../../errors/safe-read";
-import { CATEGORIES_FEATURED_LIMIT, CATEGORIES_MENU_LIMIT, CATEGORIES_SITEMAP_LIMIT } from "../../../shared/features/categories/config";
-import { hidePublicTestData } from "../tester/visibility";
+import { categoriesRepository } from "../../../../repositories/index.js";
+import { safeRead } from "../../../../errors/safe-read.js";
+import { CATEGORIES_FEATURED_LIMIT, CATEGORIES_MENU_LIMIT, CATEGORIES_SITEMAP_LIMIT } from "../../../shared/features/categories/config.js";
+import { hidePublicTestData } from "../tester/visibility.js";
 /** Full category document by slug — deduped per request via React.cache(). */
 export const getCategoryForDetail = cache(async (slug) => {
     /*

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

@@ -1,2 +1,2 @@
-export { getCategoryForDetail, listRootCategories, listFeaturedCategories, listMenuCategories, getCategoryTree, listSitemapCategories, } from "./data";
-export { CATEGORIES_PAGE_SIZE, CATEGORIES_ROOT_TIER, CATEGORIES_MAX_DEPTH, CATEGORIES_SITEMAP_LIMIT, CATEGORIES_FEATURED_LIMIT, CATEGORIES_MENU_LIMIT, } from "../../../shared/features/categories/config";
+export { getCategoryForDetail, listRootCategories, listFeaturedCategories, listMenuCategories, getCategoryTree, listSitemapCategories, } from "./data.js";
+export { CATEGORIES_PAGE_SIZE, CATEGORIES_ROOT_TIER, CATEGORIES_MAX_DEPTH, CATEGORIES_SITEMAP_LIMIT, CATEGORIES_FEATURED_LIMIT, CATEGORIES_MENU_LIMIT, } from "../../../shared/features/categories/config.js";

package/dist/_internal/server/features/categories/og.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { resolveOgImageUrl } from "../seo/og";
+import { resolveOgImageUrl } from "../seo/og.js";
 export function renderCategoryOg(doc, opts) {
     const name = doc?.name ?? "Category";
     return renderCategoryOgImage({

package/dist/_internal/server/features/checkout/actions.d.ts

@@ -1,3 +1,4 @@
+import { type StoreShippingPolicy } from "../../../shared/features/shipping/mode";
 import { type CartLane } from "../../../shared/checkout/lanes";
 import type { OutOfStockPolicy } from "../../../../features/orders/schemas/index";
 import { type CheckoutPaymentMethod } from "../../../shared/features/checkout/config";
@@ -36,6 +37,33 @@ export declare function resolveShippingCost(storeId: string | undefined): Promis
     storeOwnerId: string | undefined;
     storeEmiEnabled: boolean;
     storeState: string | undefined;
+    /** C5b — the resolved policy, so a caller can quote with the cart in hand. */
+    shippingPolicy: StoreShippingPolicy;
+    /**
+     * 🛑 True when the mode is `estimate` and no carrier rate was supplied.
+     *
+     * The caller MUST act on this rather than trusting `shippingFee: 0` — a
+     * zero there would ship every parcel free at our expense, silently, until
+     * somebody noticed. Returning both is what makes the distinction visible.
+     */
+    shippingUnavailable: boolean;
+    /**
+     * C5e tier 2 — which protections this seller has agreed to be held to.
+     *
+     * Carried here rather than read separately because this function already
+     * holds the store document, and a second `findById` per order group would
+     * spend a Firestore read against Rule #6's ~3-round-trip budget to learn two
+     * booleans. (The function already returns `storeEmiEnabled` and `storeState`
+     * for the same reason; it resolves per-store checkout facts, and its name is
+     * narrower than its job.)
+     *
+     * 🛑 Absence resolves to `false` HERE, once, so no caller has to decide what
+     * `undefined` means on a liability flag.
+     */
+    storeProtections: {
+        shipping: boolean;
+        sale: boolean;
+    };
 }>;
 export interface DroppedCoupon {
     code: string;
@@ -74,9 +102,30 @@ export interface CheckoutPricingPreviewStore {
     whatsappNotifyFee: number;
     giftWrapFee: number;
     shipmentProtectionFee: number;
+    saleProtectionFee: number;
     gstAmount: number;
     couponDiscount: number;
     total: number;
+    /**
+     * ── C5e tiers 2 and 3, resolved SERVER-SIDE for this store ───────────────
+     *
+     * 🛑 Carried on the preview rather than fetched by the client, for two
+     * reasons that both matter. The cart has neither the store document nor the
+     * products — `CartItemDocument` snapshots only `storeId`/`storeName` — so a
+     * client-side gate would need a store fetch per seller, which is both a
+     * read per render and an invitation to pass a raw `StoreDocument` into a
+     * `"use client"` component (Root Cause #70, the leak this plan's projection
+     * work exists to close).
+     *
+     * And the tiers are already computed here to price the fee. Returning the
+     * same three booleans the fee was computed from is what makes the checkbox
+     * the buyer sees and the amount they are charged provably the same decision
+     * — rather than two gates that agree by discipline.
+     */
+    supportsShippingProtection: boolean;
+    supportsSaleProtection: boolean;
+    /** True when any of this store's priced lines is `finalSale`. */
+    hasFinalSaleItem: boolean;
 }
 export interface CheckoutPricingPreview {
     subtotal: number;
@@ -85,6 +134,7 @@ export interface CheckoutPricingPreview {
     whatsappNotifyFee: number;
     giftWrapFee: number;
     shipmentProtectionFee: number;
+    saleProtectionFee: number;
     gstAmount: number;
     couponDiscount: number;
     /** Buyer-facing platform commission, capped, charged once for this checkout. */