@mohasinac/appkit 4.44.0 → 4.46.0

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

@@ -159,11 +159,57 @@ export interface ProductDocument extends BaseDocument {
     seoTitle?: string;
     seoDescription?: string;
     seoKeywords?: string[];
-    /** Primary category FK slugs (1-to-many). Use categorySlugs[0] for display. */
+    /**
+     * I1 — the ASSIGNED categories. What a human picked, and the only one of the
+     * three category fields that is authored rather than derived.
+     *
+     * At most `MAX_CATEGORY_ASSIGNMENTS` (4), and 🛑 **at most ONE per root** —
+     * "a category can be multiple, they should not be under same tree". A single
+     * files at LEAVES, a lot at NON-LEAVES. All of it is enforced in
+     * `assertAssignmentShape`, which `deriveTaxonomy` calls on every write path.
+     *
+     * `categoryIds[0]` is NOT the default — the default is the DEEPEST assignment
+     * (count breaks a tie), and `categorySlugs[0]` is what carries it.
+     */
+    categoryIds?: string[];
+    /**
+     * I5b — DERIVED. One display name per assignment, parallel to `categoryIds`.
+     *
+     * Lets the breadcrumb row offer the OTHER categories as real links without a
+     * second read on a cached page. Deliberately not their full chains: the
+     * alternate crumb shows the other categories, never N stacked trails.
+     */
+    categoryIdNames?: string[];
+    /**
+     * DERIVED closure over every assignment — the field every category QUERY
+     * matches on, via `array-contains` / `array-contains-any`.
+     *
+     * 🛑 ORDERED, and that is load-bearing: the DEFAULT chain first (so
+     * `categorySlugs[0]` is still the default leaf, which ~30 call sites read it
+     * as), then each remaining chain leaf-first, deduped. A set-shaped union
+     * would break all of them silently — see `category-assignment.ts`'s header.
+     *
+     * Never authored. An inbound value is treated as a legacy single leaf: only
+     * its HEAD is read, as one assignment.
+     */
     categorySlugs: string[];
-    /** Display-name cache parallel to categorySlugs[]. */
+    /**
+     * Display-name cache for the DEFAULT chain only, leaf-first.
+     *
+     * 🛑 Deliberately NOT parallel to `categorySlugs` once a product has two
+     * assignments: a union of two chains has no readable path, and the breadcrumb
+     * builder reverses this array to render root-first. Keeping it single-chain
+     * is what leaves every existing breadcrumb byte-identical.
+     */
     categoryNames?: string[];
-    /** @deprecated Read-only alias — normalised from legacy docs on load. */
+    /**
+     * The default leaf, mirrored. 🛑 NOT dead and NOT read-only, whatever the
+     * `@deprecated` tag here said for a long time: it is in
+     * `PRODUCT_UPDATABLE_FIELDS`, it is what `CategoryInlineSelect` writes, it is
+     * the one category key `productCreateSchema` declares, and `deriveTaxonomy`
+     * prefers it over the derived chain. Sending it alone still means exactly
+     * "one assignment".
+     */
     category?: string;
     /** @deprecated Read-only alias. */
     categoryName?: string;
@@ -224,6 +270,101 @@ export interface ProductDocument extends BaseDocument {
      * always accepted. See `_internal/shared/features/orders/return-reasons`.
      */
     finalSale?: boolean;
+    /**
+     * This listing is a multi-item LOT rather than a single item.
+     *
+     * 🛑 A lot files under a NON-LEAF category and a single may file anywhere —
+     * enforced one-directionally in `ProductRepository.deriveTaxonomy`, which
+     * already holds the leaf document so the check costs no extra read. The
+     * reason is a claim about the ITEMS, not about counting: filing "12 assorted
+     * Burst beys" under `category-dragoon-g` asserts all twelve are Dragoon G.
+     *
+     * Counting is disambiguated separately, by `categoryCounts` carrying its own
+     * `lots` pair — so singles and lots are never summed into one number.
+     *
+     * A lot is the INVERSE of per-unit selling: many objects, one listing, one
+     * stock count. Two physically distinct units of one model are two listings
+     * each at `stockQuantity: 1` (see `unitLabel`), never one listing of two.
+     */
+    isLot?: boolean;
+    /**
+     * How many items the lot contains. Drives the "lot of 12" label and the
+     * per-item price hint.
+     *
+     * Deliberately NOT required when `isLot` is true: a seller who knows it is a
+     * lot but has not counted the pile yet must still be able to save a draft.
+     */
+    lotSize?: number;
+    /**
+     * Distinguishes two physically distinct units of the SAME model and the same
+     * catalogue variant — both white Dragoon G, one with a scuffed attack ring.
+     *
+     * 🛑 Referenced by `isLot`'s comment above since G3a and declared NOWHERE
+     * until now, so the rule that comment states had no field to state it about.
+     *
+     * 🛑 NOT `itemCode`, which is the grading axis and documents `"PSA 10"` as
+     * its example — a grade is a third party's claim about condition. A unit
+     * label is a disambiguator the seller chose.
+     *
+     * It exists because the alternative is what the crawl measured at
+     * thelimitlesscorner: one listing per physical unit with the condition
+     * defects welded into the TITLE.
+     */
+    unitLabel?: string;
+    /**
+     * This listing is a COMPONENT, and this is which one.
+     *
+     * The `partGlossary` document id (`${slot}--${tail}`), stored whole.
+     *
+     * 🛑 A single id rather than the `{classification, code}` pair the plan
+     * proposed, and the departure is deliberate: a pair is a second place the
+     * key gets composed, and `partGlossaryId()` is already the one place that
+     * composes it. Two composers of one key is Root Cause #75's shape, and the
+     * id is also directly the URL (`/parts/{slot}/{tail}`) with no re-derivation.
+     *
+     * Optional even on a part listing: the glossary holds 753 rows and does not
+     * cover every component ever moulded, so a spare we cannot classify is still
+     * sellable and still countable.
+     */
+    partGlossaryId?: string;
+    /**
+     * What distinguishes two physical units of the same part code — "pink",
+     * "translucent blue", "gold".
+     *
+     * 🛑 NOT a `productFeature`. That vocabulary is ~169 curated terms in 13
+     * groups and `colour` is not one of them, deliberately: colourways are
+     * open-ended and per-part, and pouring them into a shared vocabulary gives a
+     * facet with hundreds of single-use values — the long-tail-tag anti-pattern
+     * this project REJECTED when redeyemerch was crawled (50–160 tags per
+     * product, 162 products on one tag).
+     *
+     * 🛑 Free text, and the VOCABULARY is deliberately not seeded. The corpus
+     * carries part names, codes and weights and no colours at all, so a seeded
+     * list would be invented. It accumulates from real spares (GAP-8: data
+     * entry, not code).
+     */
+    colourway?: string;
+    /** Mould/version variant — the "storm pegasus version" of a shared part. */
+    mouldVariant?: string;
+    /**
+     * Built HERE from components. Each entry decremented a part listing's stock.
+     *
+     * 🛑 The decrement must happen in a real transaction that RE-READS, and it
+     * must read `availableQuantity` rather than `stockQuantity`: a component with
+     * 10 in stock and 3 reserved has SEVEN assemblable, and assembling from the
+     * wrong field builds a bey out of parts somebody has already bought. The
+     * PhonePe path's `runBatch` over a snapshot read outside any transaction is
+     * the oversell this avoids, five components at a time.
+     */
+    assembledFrom?: Array<{
+        slotKey: string;
+        productId: string;
+        quantity: number;
+    }>;
+    /** Views in the trailing 7 days. */
+    views7d?: number;
+    /** Views in the trailing 30 days. */
+    views30d?: number;
     condition?: "new" | "like_new" | "good" | "fair" | "poor" | "used" | "refurbished" | "broken" | "graded";
     insurance?: boolean;
     insuranceCost?: number;
@@ -437,6 +578,31 @@ export interface ProductDocument extends BaseDocument {
             etaDaysMax?: number;
         }>;
     };
+    /**
+     * The PACKED parcel — C5a. Optional on purpose.
+     *
+     * 🛑 The figure a carrier bills on is the packed box, not the item: a bey is
+     * ~30 g and ~300 g boxed. A REQUIRED product weight would therefore be an
+     * item weight that systematically under-estimates every booking — and
+     * because a booking is capped at the amount collected from the buyer,
+     * systematic under-estimation means silently absorbing the difference on
+     * every order.
+     *
+     * So three tiers: the category's packed default drives the checkout
+     * estimate, this refines it when a seller has actually weighed a box, and
+     * the real figure is entered at shipment time. See
+     * `_internal/shared/features/shipping/parcel.ts`.
+     *
+     * `dimensionsCm` is all three or nothing — a box with a length and no width
+     * is not a dimension, and a volumetric calculation fed two of three yields a
+     * quote for a flat sheet.
+     */
+    weightG?: number;
+    dimensionsCm?: {
+        l: number;
+        w: number;
+        h: number;
+    };
     /** Physical storage location for inventory management (Print & Label Center). */
     physicalLocation?: {
         zone: string;
@@ -480,10 +646,10 @@ export declare const ProductStatusValues: {
     readonly ARCHIVED: "archived";
 };
 export declare const PRODUCT_COLLECTION: "products";
-export declare const PRODUCT_INDEXED_FIELDS: readonly ["storeId", "status", "category", "featured", "listingType", "isPromoted", "isOnSale", "isSold", "searchTxt", "createdAt", "barcodeId"];
+export declare const PRODUCT_INDEXED_FIELDS: readonly ["storeId", "status", "category", "categoryIds", "featured", "listingType", "isPromoted", "isOnSale", "isSold", "searchTxt", "createdAt", "barcodeId", "physicalLocation.zone"];
 export declare const DEFAULT_PRODUCT_DATA: Partial<ProductDocument>;
-export declare const PRODUCT_PUBLIC_FIELDS: readonly ["allowOffers", "minOfferPercent", "id", "title", "description", "category", "subcategory", "brand", "price", "currency", "stockQuantity", "availableQuantity", "images", "status", "storeName", "featured", "tags", "specifications", "features", "shippingInfo", "returnPolicy", "finalSale", "listingType", "auctionEndDate", "startingBid", "currentBid", "bidCount", "reservePrice", "buyNowPrice", "minBidIncrement", "autoExtendable", "auctionExtensionMinutes", "auctionShippingPaidBy", "bidsHaveStarted", "grading", "card", "classified", "digitalCode", "liveItem", "catalogProductId", "preOrderDeliveryDate", "preOrderDepositPercent", "preOrderDepositAmount", "preOrderMaxQuantity", "preOrderCurrentCount", "preOrderProductionStatus", "preOrderCancellable", "condition", "insurance", "insuranceCost", "shippingPaidBy", "isPromoted", "isOnSale", "isSold", "slug", "seoTitle", "seoDescription", "seoKeywords", "viewCount", "customFields", "customSections", "sublistingCategoryId", "groupId", "isGroupParent", "groupParentSlug", "groupChildSlugs", "groupTitle", "createdAt"];
-export declare const PRODUCT_UPDATABLE_FIELDS: readonly ["title", "description", "category", "subcategory", "brand", "price", "stockQuantity", "images", "status", "tags", "specifications", "features", "shippingInfo", "returnPolicy", "finalSale", "pickupAddressId", "condition", "insurance", "shippingPaidBy", "autoExtendable", "auctionExtensionMinutes", "auctionShippingPaidBy", "reservePrice", "buyNowPrice", "minBidIncrement", "bidsHaveStarted", "grading", "card", "classified", "digitalCode", "liveItem", "catalogProductId", "listingType", "preOrderDeliveryDate", "preOrderDepositPercent", "preOrderDepositAmount", "preOrderMaxQuantity", "preOrderProductionStatus", "preOrderCancellable", "isOnSale", "isSold", "allowShipBeforeEmiComplete", "gstRate", "hsnCode", "authenticity", "printMeta", "seoTitle", "seoDescription", "seoKeywords", "customFields", "customSections", "sublistingCategoryId", "groupId", "isGroupParent", "groupParentSlug", "groupChildSlugs", "groupTitle", "barcodeId"];
+export declare const PRODUCT_PUBLIC_FIELDS: readonly ["allowOffers", "minOfferPercent", "id", "title", "description", "category", "categoryIds", "categoryIdNames", "subcategory", "brand", "price", "currency", "stockQuantity", "availableQuantity", "images", "status", "storeName", "featured", "tags", "specifications", "features", "shippingInfo", "returnPolicy", "finalSale", "isLot", "lotSize", "unitLabel", "partGlossaryId", "colourway", "mouldVariant", "assembledFrom", "views7d", "views30d", "unitLabel", "partGlossaryId", "colourway", "mouldVariant", "assembledFrom", "listingType", "auctionEndDate", "startingBid", "currentBid", "bidCount", "reservePrice", "buyNowPrice", "minBidIncrement", "autoExtendable", "auctionExtensionMinutes", "auctionShippingPaidBy", "bidsHaveStarted", "grading", "card", "classified", "digitalCode", "liveItem", "catalogProductId", "preOrderDeliveryDate", "preOrderDepositPercent", "preOrderDepositAmount", "preOrderMaxQuantity", "preOrderCurrentCount", "preOrderProductionStatus", "preOrderCancellable", "condition", "insurance", "insuranceCost", "shippingPaidBy", "isPromoted", "isOnSale", "isSold", "slug", "seoTitle", "seoDescription", "seoKeywords", "viewCount", "customFields", "customSections", "sublistingCategoryId", "groupId", "isGroupParent", "groupParentSlug", "groupChildSlugs", "groupTitle", "createdAt"];
+export declare const PRODUCT_UPDATABLE_FIELDS: readonly ["title", "description", "category", "categoryIds", "subcategory", "brand", "price", "stockQuantity", "images", "status", "tags", "specifications", "features", "shippingInfo", "returnPolicy", "finalSale", "isLot", "lotSize", "pickupAddressId", "condition", "insurance", "shippingPaidBy", "autoExtendable", "auctionExtensionMinutes", "auctionShippingPaidBy", "reservePrice", "buyNowPrice", "minBidIncrement", "bidsHaveStarted", "grading", "card", "classified", "digitalCode", "liveItem", "catalogProductId", "listingType", "preOrderDeliveryDate", "preOrderDepositPercent", "preOrderDepositAmount", "preOrderMaxQuantity", "preOrderProductionStatus", "preOrderCancellable", "isOnSale", "isSold", "allowShipBeforeEmiComplete", "gstRate", "hsnCode", "authenticity", "printMeta", "seoTitle", "seoDescription", "seoKeywords", "customFields", "customSections", "sublistingCategoryId", "groupId", "isGroupParent", "groupParentSlug", "groupChildSlugs", "groupTitle", "barcodeId"];
 export type ProductCreateInput = Omit<ProductDocument, "id" | "createdAt" | "updatedAt" | "availableQuantity" | "bidCount" | "currentBid" | "auctionOriginalEndDate">;
 export type ProductUpdateInput = Partial<Pick<ProductDocument, (typeof PRODUCT_UPDATABLE_FIELDS)[number]>>;
 export type ProductAdminUpdateInput = Partial<Omit<ProductDocument, "id" | "createdAt">>;

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

@@ -1,7 +1,7 @@
 /**
  * Products Firestore Document Types & Constants
  */
-import { generateProductId, generateAuctionId, generatePreOrderId, } from "../../../utils/id-generators";
+import { generateProductId, generateAuctionId, generatePreOrderId, } from "../../../utils/id-generators.js";
 export const MAX_CUSTOM_FIELDS = 50;
 export const MAX_CUSTOM_SECTIONS = 3;
 /** Runtime-accessible product status values — use instead of bare string literals. */
@@ -16,6 +16,10 @@ export const PRODUCT_INDEXED_FIELDS = [
     "storeId",
     "status",
     "category",
+    /* Indexed: `array-contains` on the ASSIGNED list is what the category
+     * delete cascade queries to find a product filed here as its SECOND
+     * category — `findBy("category", id)` sees only the default leaf. */
+    "categoryIds",
     "featured",
     "listingType",
     "isPromoted",
@@ -24,6 +28,23 @@ export const PRODUCT_INDEXED_FIELDS = [
     "searchTxt",
     "createdAt",
     "barcodeId",
+    /*
+     * The warehouse location — C4.
+     *
+     * 🛑 A single-field entry, deliberately, and the distinction matters.
+     * Firestore indexes single fields automatically, so this list is
+     * documentation of what the collection is QUERIED by rather than the
+     * mechanism — and the real answer for location is `searchTxt`, which is
+     * already here. Listing the nested paths records that they are now a
+     * supported query shape (the Sieve config accepts them), so the next person
+     * adding a composite sees them rather than discovering a dropped clause.
+     *
+     * `physicalLocation.zone` is the only part worth naming: a zone is the
+     * coarse bucket a dashboard groups by, while shelf and bin are what search
+     * resolves. Naming all three would imply three query shapes exist when one
+     * does.
+     */
+    "physicalLocation.zone",
 ];
 export const DEFAULT_PRODUCT_DATA = {
     status: "draft",
@@ -57,6 +78,9 @@ export const PRODUCT_PUBLIC_FIELDS = [
     "title",
     "description",
     "category",
+    /* Public: the chips on a detail page render the assignments. */
+    "categoryIds",
+    "categoryIdNames",
     "subcategory",
     "brand",
     "price",
@@ -75,6 +99,35 @@ export const PRODUCT_PUBLIC_FIELDS = [
     // Buyer-facing: drives the "Final Sale" card pill and the detail-page
     // Delivery & Returns line. Absent means final sale — read via isFinalSale().
     "finalSale",
+    // Buyer-facing by necessity: "lot of 12" is the single most important thing
+    // about a lot listing, and a buyer who cannot see it thinks they are bidding
+    // on one item.
+    "isLot",
+    "lotSize",
+    /* D13/D14 — buyer-facing by definition: a colourway is WHY someone buys that
+     * particular spare, and a unit label is how they tell two identical listings
+     * apart. `assembledFrom` is listed too — it names product ids that are
+     * already public listings, and "built from these parts" is provenance a
+     * buyer should see. */
+    "unitLabel",
+    "partGlossaryId",
+    "colourway",
+    "mouldVariant",
+    "assembledFrom",
+    /* D8 — public because "N people viewed this this week" is the honest social
+     * proof H2 is built on, and it is a figure we measured. 🛑 Deliberately NOT
+     * in PRODUCT_UPDATABLE_FIELDS: a seller who could write their own view count
+     * turns a measurement into a claim. */
+    "views7d",
+    "views30d",
+    /* 🛑 D13/D14. Listed here or an update STRIPS them: the write schema has no
+     * `.passthrough()`, so a field absent from this list is dropped before it
+     * reaches Firestore while the write still returns 200 (Root Cause #101). */
+    "unitLabel",
+    "partGlossaryId",
+    "colourway",
+    "mouldVariant",
+    "assembledFrom",
     "listingType",
     "auctionEndDate",
     "startingBid",
@@ -130,6 +183,12 @@ export const PRODUCT_UPDATABLE_FIELDS = [
     "title",
     "description",
     "category",
+    /* I1 — the ASSIGNED list. 🛑 Named here or an update STRIPS it while still
+     * returning 200 (Root Cause #101), which is exactly how a UI-created
+     * product lost its chain. `categorySlugs`/`categoryNames` stay OUT: they
+     * are derived, and a caller that could set them could desync the closure
+     * from the assignments it is supposed to be the closure OF. */
+    "categoryIds",
     "subcategory",
     "brand",
     "price",
@@ -142,6 +201,13 @@ export const PRODUCT_UPDATABLE_FIELDS = [
     "shippingInfo",
     "returnPolicy",
     "finalSale",
+    /* 🛑 Listed here or an update STRIPS them. The write schema has no
+     * `.passthrough()`, so a field absent from this list is dropped before it
+     * reaches Firestore while the write still returns 200 — exactly how a
+     * UI-created product lost its `categorySlugs` chain (Root Cause #101) and how
+     * `compareAtPrice` is silently discarded today (F1 #25). */
+    "isLot",
+    "lotSize",
     "pickupAddressId",
     "condition",
     "insurance",

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

@@ -459,10 +459,10 @@ export declare const productItemSchema: z.ZodObject<{
     }[] | undefined;
     prizeGithubFileUrl?: string | undefined;
     inStock?: boolean | undefined;
-    attributes?: Record<string, string> | undefined;
     originalPrice?: number | undefined;
     sellerAvatar?: string | undefined;
     stockCount?: number | undefined;
+    attributes?: Record<string, string> | undefined;
 }, {
     status: "published" | "draft" | "in_review" | "archived";
     id: string;
@@ -598,10 +598,10 @@ export declare const productItemSchema: z.ZodObject<{
     }[] | undefined;
     prizeGithubFileUrl?: string | undefined;
     inStock?: boolean | undefined;
-    attributes?: Record<string, string> | undefined;
     originalPrice?: number | undefined;
     sellerAvatar?: string | undefined;
     stockCount?: number | undefined;
+    attributes?: Record<string, string> | undefined;
 }>;
 /** Base Zod schema for list-query parameters. */
 export declare const productListParamsSchema: z.ZodObject<{

package/dist/features/products/schemas/index.js

@@ -1,7 +1,7 @@
-export * from "./firestore";
+export * from "./firestore.js";
 import { z } from "zod";
-import { mediaFieldSchema } from "../../media/types/index";
-import { PRIZE_DRAW_DURATION_DAYS_MIN, PRIZE_DRAW_DURATION_DAYS_MAX, } from "../../../_internal/shared/checkout/rules/_limits";
+import { mediaFieldSchema } from "../../media/types/index.js";
+import { PRIZE_DRAW_DURATION_DAYS_MIN, PRIZE_DRAW_DURATION_DAYS_MAX, } from "../../../_internal/shared/checkout/rules/_limits.js";
 // --- Sub-schemas --------------------------------------------------------------
 export const productImageSchema = z.object({
     url: z.string(),

package/dist/features/products/schemas/product-features.validators.js

@@ -6,7 +6,7 @@
  * of hand-rolling parallel schemas.
  */
 import { z } from "zod";
-import { annotate } from "../../shell/field-ui-meta";
+import { annotate } from "../../shell/field-ui-meta.js";
 export const PRODUCT_FEATURE_PRODUCT_TYPE_ENUM = z.enum([
     "product",
     "auction",

package/dist/features/products/server.js

@@ -3,7 +3,7 @@
  *
  * Server-only entry point — repositories and API route handlers.
  */
-export * from "./actions";
-export { ProductRepository, productRepository, } from "./repository/products.repository";
-export { GET, POST } from "./api/route";
-export { GET as productItemGET, PATCH as productItemPATCH, DELETE as productItemDELETE, } from "./api/[id]/route";
+export * from "./actions/index.js";
+export { ProductRepository, productRepository, } from "./repository/products.repository.js";
+export { GET, POST } from "./api/route.js";
+export { GET as productItemGET, PATCH as productItemPATCH, DELETE as productItemDELETE, } from "./api/[id]/route.js";

package/dist/features/products/utils/listing-badge-variant.js

@@ -1,4 +1,4 @@
-import { isListingType } from "./listing-type";
+import { isListingType } from "./listing-type.js";
 /**
  * Listing-kind → Badge variant map.
  *

package/dist/features/products/utils/listing-type.js

@@ -1,4 +1,4 @@
-import { ALL_LISTING_TYPES } from "../../../_internal/shared/listing-types/feature-flags";
+import { ALL_LISTING_TYPES } from "../../../_internal/shared/listing-types/feature-flags.js";
 const LISTING_TYPE_SET = new Set(ALL_LISTING_TYPES);
 /** True when `value` is a member of the canonical `ListingType` union. */
 export function isListingType(value) {

package/dist/features/promotions/actions/coupon-actions.js

@@ -4,8 +4,8 @@
  * Pure business functions — auth, rate-limiting, and Next.js specifics
  * are handled by the calling server action in the consumer.
  */
-import { couponsRepository } from "../repository/coupons.repository";
-import { productRepository } from "../../products/repository/products.repository";
+import { couponsRepository } from "../repository/coupons.repository.js";
+import { productRepository } from "../../products/repository/products.repository.js";
 export async function validateCoupon(userId, code, orderTotal) {
     return couponsRepository.validateCoupon(code, userId, orderTotal);
 }

package/dist/features/promotions/actions/index.js

@@ -1,4 +1,4 @@
-export * from "./coupon-actions";
-export * from "./coupon-stacking";
-export * from "./promotions-actions";
-export * from "./seller-coupon-actions";
+export * from "./coupon-actions.js";
+export * from "./coupon-stacking.js";
+export * from "./promotions-actions.js";
+export * from "./seller-coupon-actions.js";

package/dist/features/promotions/actions/promotions-actions.js

@@ -4,9 +4,9 @@
  * Pure business functions — auth, rate-limiting, and Next.js specifics
  * are handled by the calling server action in the consumer.
  */
-import { productRepository } from "../../../features/products/repository/products.repository";
-import { couponsRepository } from "../repository/coupons.repository";
-import { ProductStatusValues } from "../../../features/products/schemas";
+import { productRepository } from "../../../features/products/repository/products.repository.js";
+import { couponsRepository } from "../repository/coupons.repository.js";
+import { ProductStatusValues } from "../../../features/products/schemas/index.js";
 /**
  * Fetch all promotions data in parallel:
  * promoted products, featured products, and active/valid coupons.

package/dist/features/promotions/actions/seller-coupon-actions.js

@@ -4,11 +4,11 @@
  * Business logic for seller-scoped coupon management.
  * Auth, rate-limiting, and input validation are handled by the calling server action.
  */
-import { serverLogger } from "../../../monitoring";
-import { couponsRepository } from "../repository/coupons.repository";
-import { storeRepository } from "../../stores/repository/store.repository";
-import { buildSellerCouponCode } from "../schemas/firestore";
-import { AuthorizationError, ValidationError, NotFoundError, } from "../../../errors";
+import { serverLogger } from "../../../monitoring/index.js";
+import { couponsRepository } from "../repository/coupons.repository.js";
+import { storeRepository } from "../../stores/repository/store.repository.js";
+import { buildSellerCouponCode } from "../schemas/firestore.js";
+import { AuthorizationError, ValidationError, NotFoundError, } from "../../../errors/index.js";
 // --- Create ----------------------------------------------------------------
 export async function sellerCreateCoupon(userId, input) {
     const store = await storeRepository.findByOwnerId(userId);

package/dist/features/promotions/api/route.js

@@ -18,8 +18,8 @@
  * Collection: "coupons"
  */
 import { NextResponse } from "next/server.js";
-import { getProviders } from "../../../contracts";
-import { normalizeError } from "../../../errors/normalize";
+import { getProviders } from "../../../contracts/index.js";
+import { normalizeError } from "../../../errors/normalize.js";
 function param(url, key) {
     return url.searchParams.get(key);
 }

package/dist/features/promotions/columns/index.js

@@ -1,4 +1,4 @@
-import { buildColumns, renderBoolean } from "../../../ui/columns";
+import { buildColumns, renderBoolean } from "../../../ui/columns/index.js";
 /**
  * Default admin column definitions for a coupons/promotions table.
  *

package/dist/features/promotions/components/CouponCard.js

@@ -1,11 +1,11 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { normalizeError } from "../../../errors/normalize";
+import { normalizeError } from "../../../errors/normalize.js";
 import { useState } from "react";
 import { Pencil, Trash2, ToggleLeft, ToggleRight } from "lucide-react";
-import { Badge, BaseListingCard, Button, ConfirmDeleteModal, Div, IconButton, Row, Span, Stack, Text } from "../../../ui";
-import { useLongPress } from "../../../react/hooks/useLongPress";
-import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints";
+import { Badge, BaseListingCard, Button, ConfirmDeleteModal, Div, IconButton, Row, Span, Stack, Text } from "../../../ui/index.js";
+import { useLongPress } from "../../../react/hooks/useLongPress.js";
+import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints.js";
 const CLS_TOGGLE_ON = "h-4 w-4 text-success dark:text-success";
 const CLS_DELETE_BTN = "p-[var(--appkit-space-1-5)] text-[var(--appkit-color-text-muted)] hover:bg-error-surface dark:hover:bg-error-surface hover:text-error dark:hover:text-error transition-colors disabled:opacity-50";
 const TYPE_COLORS = {

package/dist/features/promotions/components/CouponHelpDetails.js

@@ -1,7 +1,7 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Details, Summary, Stack, Text, Ul, Li, Span } from "../../../ui";
-import { COUPON_HELP } from "../constants/coupon-help";
+import { Details, Summary, Stack, Text, Ul, Li, Span } from "../../../ui/index.js";
+import { COUPON_HELP } from "../constants/coupon-help.js";
 function HelpSection({ heading, items }) {
     return (_jsxs(Stack, { gap: "dense", children: [_jsx(Text, { size: "sm", weight: "semibold", children: heading }), _jsx(Ul, { marker: "disc", indent: "md", spacing: "tight", size: "sm", children: items.map((item) => (_jsx(Li, { color: "muted", children: item }, item))) })] }));
 }

package/dist/features/promotions/components/CouponsIndexListing.js

@@ -2,14 +2,14 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useState, useCallback, useMemo } from "react";
 import { Search, SlidersHorizontal, X } from "lucide-react";
-import { useUrlTable } from "../../../react/hooks/useUrlTable";
-import { Button, DateInput, IconButton, Input, ListingFilterDrawer, Pagination, RadioGroup, SortDropdown, Div, Grid, Row, Span, Stack, Text, Heading, StickyToolbar } from "../../../ui";
-import { usePromotions } from "../hooks/usePromotions";
-import { CouponCard } from "./CouponCard";
-import { CouponHelpDetails } from "./CouponHelpDetails";
-import { TABLE_KEYS } from "../../../constants/table-keys";
-import { COUPON_FIELDS } from "../../../constants/field-names";
-import { sortBy } from "../../../constants/sort";
+import { useUrlTable } from "../../../react/hooks/useUrlTable.js";
+import { Button, DateInput, IconButton, Input, ListingFilterDrawer, Pagination, RadioGroup, SortDropdown, Div, Grid, Row, Span, Stack, Text, Heading, StickyToolbar } from "../../../ui/index.js";
+import { usePromotions } from "../hooks/usePromotions.js";
+import { CouponCard } from "./CouponCard.js";
+import { CouponHelpDetails } from "./CouponHelpDetails.js";
+import { TABLE_KEYS } from "../../../constants/table-keys.js";
+import { COUPON_FIELDS } from "../../../constants/field-names.js";
+import { sortBy } from "../../../constants/sort.js";
 const __O = {
     hidden: "overflow-hidden",
 };

package/dist/features/promotions/components/PromotionsView.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Div, Heading, Section, Stack, Text } from "../../../ui";
+import { Div, Heading, Section, Stack, Text } from "../../../ui/index.js";
 export function PromotionsViewProductSection({ title, subtitle, renderProducts, hasProducts, }) {
     if (!hasProducts)
         return null;

package/dist/features/promotions/components/index.js

@@ -1,4 +1,4 @@
-export { CouponCard } from "./CouponCard";
-export { CouponHelpDetails } from "./CouponHelpDetails";
-export { CouponsIndexListing } from "./CouponsIndexListing";
-export { PromotionsView, PromotionsViewProductSection, PromotionsHero, } from "./PromotionsView";
+export { CouponCard } from "./CouponCard.js";
+export { CouponHelpDetails } from "./CouponHelpDetails.js";
+export { CouponsIndexListing } from "./CouponsIndexListing.js";
+export { PromotionsView, PromotionsViewProductSection, PromotionsHero, } from "./PromotionsView.js";

package/dist/features/promotions/hooks/useCouponValidate.js

@@ -1,6 +1,6 @@
 import { useMutation } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import { PROMOTION_ENDPOINTS } from "../../../constants/api-endpoints";
+import { apiClient } from "../../../http/index.js";
+import { PROMOTION_ENDPOINTS } from "../../../constants/api-endpoints.js";
 export function useCouponValidate(options) {
     const endpoint = options?.endpoint ?? PROMOTION_ENDPOINTS.COUPON_VALIDATE;
     return useMutation({

package/dist/features/promotions/hooks/usePromotions.js

@@ -1,6 +1,6 @@
 import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import { PROMOTION_ENDPOINTS } from "../../../constants/api-endpoints";
+import { apiClient } from "../../../http/index.js";
+import { PROMOTION_ENDPOINTS } from "../../../constants/api-endpoints.js";
 export function usePromotions(params = {}, opts) {
     const sp = new URLSearchParams();
     if (params.scope)

package/dist/features/promotions/index.js

@@ -1,7 +1,7 @@
-export * from "./types";
-export * from "./schemas";
-export * from "./columns";
-export * from "./hooks/usePromotions";
-export * from "./hooks/useCouponValidate";
-export * from "./components";
-export { manifest } from "./manifest";
+export * from "./types/index.js";
+export * from "./schemas/index.js";
+export * from "./columns/index.js";
+export * from "./hooks/usePromotions.js";
+export * from "./hooks/useCouponValidate.js";
+export * from "./components/index.js";
+export { manifest } from "./manifest.js";

package/dist/features/promotions/repository/claimed-coupons.repository.js

@@ -5,11 +5,11 @@
  * page is a single indexed read. Status is lazily flipped to "expired" on
  * read when `expiresAt < now`. Soft-delete only (status stays, no destroy).
  */
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
-import { normalizeError } from "../../../errors/normalize";
-import { CLAIMED_COUPONS_COLLECTION, createClaimedCouponId } from "../schemas";
-import { DatabaseError } from "../../../errors";
-import { COUPON_USAGE_FIELDS } from "../../../constants/field-names";
+import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase/index.js";
+import { normalizeError } from "../../../errors/normalize.js";
+import { CLAIMED_COUPONS_COLLECTION, createClaimedCouponId } from "../schemas/index.js";
+import { DatabaseError } from "../../../errors/index.js";
+import { COUPON_USAGE_FIELDS } from "../../../constants/field-names.js";
 export class ClaimedCouponsRepository extends BaseRepository {
     constructor() {
         super(CLAIMED_COUPONS_COLLECTION);