@mohasinac/appkit 2.6.3 → 2.6.5

package/dist/features/products/repository/products.repository.js

@@ -401,6 +401,10 @@ export class ProductRepository extends BaseRepository {
         batch.update(this.db.collection(this.collection).doc(productId), {
             currentBid,
             bidCount: increment(1),
+            // SB-UNI-H 2026-05-13 — flip `bidsHaveStarted` when any bid lands.
+            // Idempotent on subsequent bids; the BIN button is hidden by the PDP
+            // as soon as this is true (eBay-style hybrid auction rule).
+            bidsHaveStarted: true,
             updatedAt: serverTimestamp(),
         });
     }

package/dist/features/products/schemas/catalog-product.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Catalog Product schema — SB-UNI-L Phase 4 foundation slice 2026-05-13.
+ *
+ * Splits the per-seller `ProductDocument` (now `SellerOfferDocument` in
+ * spirit — see the optional `catalogProductId` link added in firestore.ts)
+ * out from a shared catalog row that aggregates N offers for the same SKU.
+ *
+ * Two modes per offer:
+ *   1. catalog-linked — `SellerOffer.catalogProductId` points at a
+ *      `CatalogProductDocument`. The PDP at `/catalog/{slug}` aggregates
+ *      every offer linked to the catalog row; sellers compete on price/
+ *      condition. Used for graded cards, sealed boxes, mass-produced toys.
+ *   2. standalone — `catalogProductId` is undefined. PDP renders at
+ *      `/products/{slug}` (the current path). Used for one-of-a-kind items
+ *      (custom dioramas, signed memorabilia, prototypes).
+ *
+ * The full PDP routing + admin "Promote to catalog" workflow lands in the
+ * Phase 4 second cohort. This file is the schema foundation — types, slug
+ * prefix, capability flag — so consumers can start writing against the
+ * shape today.
+ */
+import type { GradingService, ProductCardMetadata } from "./firestore";
+/** Identifier types attached to a catalog row for SKU-level deduplication. */
+export interface CatalogIdentifiers {
+    /** Industry standard SKU. */
+    gtin?: string;
+    /** Manufacturer part number. */
+    mpn?: string;
+    /** Internal catalog id (e.g. TCGPlayer product id). */
+    externalId?: string;
+}
+/**
+ * Top-level catalog row. One per SKU; offers link via `catalogProductId`.
+ *
+ * Slug prefix: `catalog-{slug}` (added to CLAUDE.md table by this commit).
+ */
+export interface CatalogProductDocument {
+    id: string;
+    slug: string;
+    title: string;
+    description?: string;
+    brandSlug?: string;
+    categorySlug?: string;
+    /** Card metadata reused from the per-offer schema for indexing parity. */
+    card?: ProductCardMetadata;
+    /** Optional grading service if the catalog row tracks slabs. */
+    gradingService?: GradingService;
+    /** Canonical images shared by all linked offers. */
+    images: string[];
+    /** Catalog-level identifiers (GTIN / MPN / external). */
+    identifiers?: CatalogIdentifiers;
+    /** Denormalised — count of active offers linking to this catalog row. */
+    offerCount: number;
+    /** Denormalised — minimum priceInPaise across active linked offers. */
+    minOfferPriceInPaise?: number;
+    /** Catalog is searchable / showable on `/catalog/{slug}`. */
+    isActive: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+    /** Admin who promoted this catalog from an offer (audit trail). */
+    promotedBy?: string;
+}
+export declare const CATALOG_COLLECTION: "catalogProducts";
+export declare const CATALOG_PUBLIC_FIELDS: readonly ["id", "slug", "title", "description", "brandSlug", "categorySlug", "card", "gradingService", "images", "identifiers", "offerCount", "minOfferPriceInPaise", "isActive", "createdAt", "updatedAt"];
+export declare const CATALOG_UPDATABLE_FIELDS: readonly ["title", "description", "brandSlug", "categorySlug", "card", "gradingService", "images", "identifiers", "isActive"];
+export type CatalogProductCreateInput = Omit<CatalogProductDocument, "id" | "createdAt" | "updatedAt" | "offerCount" | "minOfferPriceInPaise"> & {
+    offerCount?: number;
+    minOfferPriceInPaise?: number;
+};
+export type CatalogProductUpdateInput = Partial<Pick<CatalogProductDocument, (typeof CATALOG_UPDATABLE_FIELDS)[number]>>;

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

@@ -0,0 +1,50 @@
+/**
+ * Catalog Product schema — SB-UNI-L Phase 4 foundation slice 2026-05-13.
+ *
+ * Splits the per-seller `ProductDocument` (now `SellerOfferDocument` in
+ * spirit — see the optional `catalogProductId` link added in firestore.ts)
+ * out from a shared catalog row that aggregates N offers for the same SKU.
+ *
+ * Two modes per offer:
+ *   1. catalog-linked — `SellerOffer.catalogProductId` points at a
+ *      `CatalogProductDocument`. The PDP at `/catalog/{slug}` aggregates
+ *      every offer linked to the catalog row; sellers compete on price/
+ *      condition. Used for graded cards, sealed boxes, mass-produced toys.
+ *   2. standalone — `catalogProductId` is undefined. PDP renders at
+ *      `/products/{slug}` (the current path). Used for one-of-a-kind items
+ *      (custom dioramas, signed memorabilia, prototypes).
+ *
+ * The full PDP routing + admin "Promote to catalog" workflow lands in the
+ * Phase 4 second cohort. This file is the schema foundation — types, slug
+ * prefix, capability flag — so consumers can start writing against the
+ * shape today.
+ */
+export const CATALOG_COLLECTION = "catalogProducts";
+export const CATALOG_PUBLIC_FIELDS = [
+    "id",
+    "slug",
+    "title",
+    "description",
+    "brandSlug",
+    "categorySlug",
+    "card",
+    "gradingService",
+    "images",
+    "identifiers",
+    "offerCount",
+    "minOfferPriceInPaise",
+    "isActive",
+    "createdAt",
+    "updatedAt",
+];
+export const CATALOG_UPDATABLE_FIELDS = [
+    "title",
+    "description",
+    "brandSlug",
+    "categorySlug",
+    "card",
+    "gradingService",
+    "images",
+    "identifiers",
+    "isActive",
+];

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

@@ -30,6 +30,79 @@ export interface CustomSection {
     text?: string;
     fields?: CustomField[];
 }
+export type GradingService = "PSA" | "BGS" | "CGC" | "SGC" | "OTHER";
+export interface ProductGrading {
+    /** Grading service (PSA / BGS / CGC / SGC / OTHER) — sortable index field. */
+    service: GradingService;
+    /** Numeric grade out of 10 (BGS uses 0.5 increments; PSA/CGC integer). */
+    grade: number;
+    /** Slab cert number (PSA cert lookup URL is built from this client-side). */
+    certNumber?: string;
+    /** Slab/grade image media slug (uploaded via the signed-URL flow). */
+    slabImageMedia?: string;
+    /** Free-form key/value attrs (e.g. autograph=yes, subgrades=9.5/10/10/9.5). */
+    attributes?: Record<string, string>;
+}
+export interface ProductCardMetadata {
+    /** TCG set name (e.g. "Pokémon Base Set"). */
+    setName: string;
+    /** Year the set was published. */
+    setYear?: number;
+    /** Card number within the set (e.g. "108/120"). */
+    cardNumber?: string;
+    /** Rarity tier (Common / Uncommon / Rare / Holo / etc — free-form). */
+    rarity?: string;
+    /** Card language (en, jp, etc). */
+    language?: string;
+}
+export interface ProductClassifiedMeta {
+    /** Where the item is — drives the (listingType, classified.meetupArea.city, createdAt) index. */
+    meetupArea: {
+        city: string;
+        locality?: string;
+        pincode?: string;
+    };
+    /** How the buyer reaches the seller (chat | phone | both). */
+    contactMethod?: "chat" | "phone" | "both";
+    /** Seller offers shipping in addition to meetup. */
+    acceptsShipping?: boolean;
+    /** Price is negotiable — UI hints "₹X (negotiable)". */
+    negotiable?: boolean;
+}
+export interface ProductDigitalCodeMeta {
+    /** How the code is fulfilled — claim-at-paid / manual-via-email / etc. */
+    codeDeliveryMethod: "auto-claim" | "manual-email";
+    /** Total codes in the pool — operational view. */
+    codePoolSize?: number;
+    /** Atomic counter decremented on claim; never goes negative. */
+    codesAvailable?: number;
+    /** Free-form redemption instructions surfaced on the order detail page. */
+    redemptionInstructions?: string;
+    /** Codes expire at — orders past this point reject claim. */
+    expiresAt?: Date;
+}
+export interface ProductLiveItemMeta {
+    /** Species or cultivar name (taxonomic where applicable). */
+    species: string;
+    /** Animal/plant age in months at the time of listing. */
+    ageMonths?: number;
+    /** Biological sex / not-applicable. */
+    sex?: "male" | "female" | "unknown" | "n/a";
+    /** Free-form care instructions surfaced at checkout consent. */
+    careInfo?: string;
+    /** Transport details — carrier method, fees, insurance flag. */
+    transport: {
+        method: "courier" | "in-person" | "specialist";
+        handlingFeeInPaise?: number;
+        insuranceIncluded?: boolean;
+    };
+    /** Allowed buyer-state ISO 3166-2 codes (e.g. "IN-MH"). */
+    jurisdictionAllowed: string[];
+    /** Set by admin verification workflow — gate for listing creation. */
+    vendorVerified?: boolean;
+    /** CITES permit number (Appendix I/II species). */
+    cites?: string;
+}
 export interface ProductDocument {
     id: string;
     title: string;
@@ -74,6 +147,14 @@ export interface ProductDocument {
     auctionExtensionMinutes?: number;
     auctionOriginalEndDate?: Date;
     auctionShippingPaidBy?: "seller" | "winner";
+    buyItNowPriceInPaise?: number;
+    bidsHaveStarted?: boolean;
+    grading?: ProductGrading;
+    card?: ProductCardMetadata;
+    classified?: ProductClassifiedMeta;
+    digitalCode?: ProductDigitalCodeMeta;
+    liveItem?: ProductLiveItemMeta;
+    catalogProductId?: string;
     preOrderDeliveryDate?: Date;
     preOrderDepositPercent?: number;
     preOrderDepositAmount?: number;
@@ -127,6 +208,28 @@ export interface ProductDocument {
     prizeRevealDeadlineDays?: number;
     /** Public proof-of-fairness file (commit-reveal scheme). */
     prizeGithubFileUrl?: string;
+    /**
+     * Optional per-item shipping constraints. When absent the store's
+     * shippingConfig applies unchanged.
+     */
+    shipping?: {
+        /**
+         * Restrict this item to a subset of the store's providers
+         * (e.g. heavy item not eligible for store-pickup).
+         */
+        allowedProviderIds?: string[];
+        /**
+         * Per-provider fee / ETA overrides for this item (e.g. oversized surcharge).
+         * Merged on top of the provider's store-wide config when displaying the
+         * ShippingPicker.
+         */
+        overrides?: Array<{
+            providerId: string;
+            feeInPaise?: number;
+            etaDaysMin?: number;
+            etaDaysMax?: number;
+        }>;
+    };
     createdAt: Date;
     updatedAt: Date;
 }
@@ -160,8 +263,8 @@ export declare const ProductStatusValues: {
 export declare const PRODUCT_COLLECTION: "products";
 export declare const PRODUCT_INDEXED_FIELDS: readonly ["storeId", "status", "category", "featured", "listingType", "isPromoted", "isOnSale", "isSold", "createdAt"];
 export declare const DEFAULT_PRODUCT_DATA: Partial<ProductDocument>;
-export declare const PRODUCT_PUBLIC_FIELDS: readonly ["id", "title", "description", "category", "subcategory", "brand", "price", "currency", "stockQuantity", "availableQuantity", "images", "status", "storeName", "featured", "tags", "specifications", "features", "shippingInfo", "returnPolicy", "listingType", "auctionEndDate", "startingBid", "currentBid", "bidCount", "reservePrice", "buyNowPrice", "minBidIncrement", "autoExtendable", "auctionExtensionMinutes", "auctionShippingPaidBy", "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", "pickupAddressId", "condition", "insurance", "shippingPaidBy", "autoExtendable", "auctionExtensionMinutes", "auctionShippingPaidBy", "reservePrice", "buyNowPrice", "minBidIncrement", "listingType", "preOrderDeliveryDate", "preOrderDepositPercent", "preOrderDepositAmount", "preOrderMaxQuantity", "preOrderProductionStatus", "preOrderCancellable", "isOnSale", "isSold", "seoTitle", "seoDescription", "seoKeywords", "customFields", "customSections", "sublistingCategoryId", "groupId", "isGroupParent", "groupParentSlug", "groupChildSlugs", "groupTitle"];
+export declare const PRODUCT_PUBLIC_FIELDS: readonly ["id", "title", "description", "category", "subcategory", "brand", "price", "currency", "stockQuantity", "availableQuantity", "images", "status", "storeName", "featured", "tags", "specifications", "features", "shippingInfo", "returnPolicy", "listingType", "auctionEndDate", "startingBid", "currentBid", "bidCount", "reservePrice", "buyNowPrice", "minBidIncrement", "autoExtendable", "auctionExtensionMinutes", "auctionShippingPaidBy", "buyItNowPriceInPaise", "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", "pickupAddressId", "condition", "insurance", "shippingPaidBy", "autoExtendable", "auctionExtensionMinutes", "auctionShippingPaidBy", "reservePrice", "buyNowPrice", "minBidIncrement", "buyItNowPriceInPaise", "bidsHaveStarted", "grading", "card", "classified", "digitalCode", "liveItem", "catalogProductId", "listingType", "preOrderDeliveryDate", "preOrderDepositPercent", "preOrderDepositAmount", "preOrderMaxQuantity", "preOrderProductionStatus", "preOrderCancellable", "isOnSale", "isSold", "seoTitle", "seoDescription", "seoKeywords", "customFields", "customSections", "sublistingCategoryId", "groupId", "isGroupParent", "groupParentSlug", "groupChildSlugs", "groupTitle"];
 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">>;
@@ -174,6 +277,11 @@ export declare const productQueryHelpers: {
     readonly available: () => readonly ["availableQuantity", ">", 0];
     readonly auctions: () => readonly ["listingType", "==", "auction"];
     readonly preOrders: () => readonly ["listingType", "==", "pre-order"];
+    readonly prizeDraws: () => readonly ["listingType", "==", "prize-draw"];
+    readonly standardListings: () => readonly ["listingType", "==", "standard"];
+    readonly classifieds: () => readonly ["listingType", "==", "classified"];
+    readonly digitalCodes: () => readonly ["listingType", "==", "digital-code"];
+    readonly liveItems: () => readonly ["listingType", "==", "live"];
     readonly promoted: () => readonly ["isPromoted", "==", true];
     readonly activeAuction: (date: Date) => readonly ["auctionEndDate", ">=", Date];
 };

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

@@ -76,6 +76,18 @@ export const PRODUCT_PUBLIC_FIELDS = [
     "autoExtendable",
     "auctionExtensionMinutes",
     "auctionShippingPaidBy",
+    // SB-UNI-H 2026-05-13 — eBay hybrid BIN.
+    "buyItNowPriceInPaise",
+    "bidsHaveStarted",
+    // SB-UNI-G 2026-05-13 — TCGPlayer grading + card metadata.
+    "grading",
+    "card",
+    // SB-UNI-I / J / K 2026-05-13 — per-type field blocks.
+    "classified",
+    "digitalCode",
+    "liveItem",
+    // SB-UNI-L 2026-05-13 — catalog link (offer-side reference).
+    "catalogProductId",
     "preOrderDeliveryDate",
     "preOrderDepositPercent",
     "preOrderDepositAmount",
@@ -130,6 +142,18 @@ export const PRODUCT_UPDATABLE_FIELDS = [
     "reservePrice",
     "buyNowPrice",
     "minBidIncrement",
+    // SB-UNI-H 2026-05-13 — eBay hybrid BIN updatable.
+    "buyItNowPriceInPaise",
+    "bidsHaveStarted",
+    // SB-UNI-G 2026-05-13 — TCGPlayer grading + card metadata updatable.
+    "grading",
+    "card",
+    // SB-UNI-I / J / K 2026-05-13 — per-type field blocks updatable.
+    "classified",
+    "digitalCode",
+    "liveItem",
+    // SB-UNI-L 2026-05-13 — catalog link updatable.
+    "catalogProductId",
     "listingType",
     "preOrderDeliveryDate",
     "preOrderDepositPercent",
@@ -160,6 +184,12 @@ export const productQueryHelpers = {
     available: () => ["availableQuantity", ">", 0],
     auctions: () => ["listingType", "==", "auction"],
     preOrders: () => ["listingType", "==", "pre-order"],
+    prizeDraws: () => ["listingType", "==", "prize-draw"],
+    standardListings: () => ["listingType", "==", "standard"],
+    // SB-UNI-F 2026-05-13 — Phase 2 query helpers.
+    classifieds: () => ["listingType", "==", "classified"],
+    digitalCodes: () => ["listingType", "==", "digital-code"],
+    liveItems: () => ["listingType", "==", "live"],
     promoted: () => ["isPromoted", "==", true],
     activeAuction: (date) => ["auctionEndDate", ">=", date],
 };

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

@@ -308,8 +308,8 @@ export declare const productItemSchema: z.ZodObject<{
     images?: string[] | undefined;
     rating?: number | undefined;
     description?: string | undefined;
+    listingType?: "auction" | "standard" | "pre-order" | "prize-draw" | "bundle" | undefined;
     featured?: boolean | undefined;
-    listingType?: "auction" | "standard" | "prize-draw" | "pre-order" | "bundle" | undefined;
     isPromoted?: boolean | undefined;
     slug?: string | undefined;
     subcategory?: string | undefined;
@@ -326,7 +326,7 @@ export declare const productItemSchema: z.ZodObject<{
     features?: string[] | undefined;
     shippingInfo?: string | undefined;
     returnPolicy?: string | undefined;
-    condition?: "new" | "used" | "refurbished" | "fair" | "good" | "like_new" | "poor" | "broken" | undefined;
+    condition?: "new" | "used" | "refurbished" | "broken" | "like_new" | "good" | "fair" | "poor" | undefined;
     insurance?: boolean | undefined;
     insuranceCost?: number | undefined;
     shippingPaidBy?: "seller" | "buyer" | undefined;
@@ -437,8 +437,8 @@ export declare const productItemSchema: z.ZodObject<{
     images?: string[] | undefined;
     rating?: number | undefined;
     description?: string | undefined;
+    listingType?: "auction" | "standard" | "pre-order" | "prize-draw" | "bundle" | undefined;
     featured?: boolean | undefined;
-    listingType?: "auction" | "standard" | "prize-draw" | "pre-order" | "bundle" | undefined;
     isPromoted?: boolean | undefined;
     slug?: string | undefined;
     subcategory?: string | undefined;
@@ -455,7 +455,7 @@ export declare const productItemSchema: z.ZodObject<{
     features?: string[] | undefined;
     shippingInfo?: string | undefined;
     returnPolicy?: string | undefined;
-    condition?: "new" | "used" | "refurbished" | "fair" | "good" | "like_new" | "poor" | "broken" | undefined;
+    condition?: "new" | "used" | "refurbished" | "broken" | "like_new" | "good" | "fair" | "poor" | undefined;
     insurance?: boolean | undefined;
     insuranceCost?: number | undefined;
     shippingPaidBy?: "seller" | "buyer" | undefined;
@@ -567,9 +567,9 @@ export declare const productListParamsSchema: z.ZodObject<{
     category?: string | undefined;
     minPrice?: number | undefined;
     maxPrice?: number | undefined;
+    listingType?: "auction" | "standard" | "pre-order" | "prize-draw" | "bundle" | undefined;
     featured?: boolean | undefined;
-    listingType?: "auction" | "standard" | "prize-draw" | "pre-order" | "bundle" | undefined;
-    condition?: "new" | "used" | "refurbished" | "fair" | "good" | "like_new" | "poor" | "broken" | undefined;
+    condition?: "new" | "used" | "refurbished" | "broken" | "like_new" | "good" | "fair" | "poor" | undefined;
     inStock?: boolean | undefined;
 }, {
     sort?: string | undefined;
@@ -581,8 +581,8 @@ export declare const productListParamsSchema: z.ZodObject<{
     category?: string | undefined;
     minPrice?: number | undefined;
     maxPrice?: number | undefined;
+    listingType?: "auction" | "standard" | "pre-order" | "prize-draw" | "bundle" | undefined;
     featured?: boolean | undefined;
-    listingType?: "auction" | "standard" | "prize-draw" | "pre-order" | "bundle" | undefined;
-    condition?: "new" | "used" | "refurbished" | "fair" | "good" | "like_new" | "poor" | "broken" | undefined;
+    condition?: "new" | "used" | "refurbished" | "broken" | "like_new" | "good" | "fair" | "poor" | undefined;
     inStock?: boolean | undefined;
 }>;

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

@@ -10,7 +10,7 @@ export type ProductCondition = "new" | "like_new" | "good" | "fair" | "poor" | "
  * accepts legacy alias tokens (`preorder` → `pre-order`, `product` → `standard`)
  * but stored values are always one of these five.
  */
-export type ListingType = "standard" | "auction" | "pre-order" | "prize-draw";
+export type ListingType = "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
 export interface ProductImage {
     url: string;
     thumbnailUrl?: string;

package/dist/features/products/utils/listing-type.d.ts

@@ -24,3 +24,12 @@ export declare const isStandardListing: (input?: {
 export declare const isPrizeDrawListing: (input?: {
     listingType?: ListingType;
 }) => boolean;
+export declare const isClassifiedListing: (input?: {
+    listingType?: ListingType;
+}) => boolean;
+export declare const isDigitalCodeListing: (input?: {
+    listingType?: ListingType;
+}) => boolean;
+export declare const isLiveListing: (input?: {
+    listingType?: ListingType;
+}) => boolean;

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

@@ -15,6 +15,10 @@ export const isAuctionListing = (input) => normalizeListingType(input) === "auct
 export const isPreOrderListing = (input) => normalizeListingType(input) === "pre-order";
 export const isStandardListing = (input) => normalizeListingType(input) === "standard";
 export const isPrizeDrawListing = (input) => normalizeListingType(input) === "prize-draw";
+// SB-UNI-F 2026-05-13 — Phase 2 union extension predicates.
+export const isClassifiedListing = (input) => normalizeListingType(input) === "classified";
+export const isDigitalCodeListing = (input) => normalizeListingType(input) === "digital-code";
+export const isLiveListing = (input) => normalizeListingType(input) === "live";
 // SB-UNI-D — isBundleListing removed. Bundles are now a categoryType
 // discriminator on CategoryDocument; consumers should query
 // `categoriesRepository.findBySlugAndType(slug, "bundle")` instead.

package/dist/features/promotions/actions/coupon-actions.d.ts

@@ -1,7 +1,7 @@
 /**
  * Promotions / Coupon Domain Actions (appkit)
  *
- * Pure business functions — auth, rate-limiting, and Next.js specifics
+ * Pure business functions — auth, rate-limiting, and Next.js specifics
  * are handled by the calling server action in the consumer.
  */
 import type { CouponValidationResult } from "../schemas";
@@ -22,7 +22,7 @@ export type CouponCartItem = {
     price: number;
     quantity: number;
     /** Canonical listing-kind snapshot (SB1-G Phase 4). */
-    listingType: "standard" | "auction" | "pre-order" | "prize-draw";
+    listingType: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
 };
 export declare function validateCoupon(userId: string, code: string, orderTotal: number): Promise<CouponValidationResult>;
 export declare function validateCouponForCart(userId: string, code: string, cartItems: CouponCartItem[]): Promise<CouponCartValidationResult>;

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

@@ -1,7 +1,7 @@
 /**
  * Promotions / Coupon Domain Actions (appkit)
  *
- * Pure business functions — auth, rate-limiting, and Next.js specifics
+ * 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";

package/dist/features/promotions/components/CouponCard.d.ts

@@ -1,16 +1,34 @@
 import type { CouponItem } from "../types";
+export interface CouponCardLabels {
+    copy?: string;
+    copied?: string;
+    expires?: string;
+    minOrder?: string;
+    off?: string;
+    freeShipping?: string;
+    active?: string;
+    inactive?: string;
+    used?: string;
+    edit?: string;
+    activate?: string;
+    deactivate?: string;
+    delete?: string;
+    deleteConfirm?: string;
+}
 interface CouponCardProps {
-    coupon: CouponItem;
-    labels?: {
-        copy?: string;
-        copied?: string;
-        expires?: string;
-        minOrder?: string;
-        off?: string;
-        freeShipping?: string;
-    };
+    /** Accepts either `CouponItem` (flat) or `CouponDocument` (nested). */
+    coupon: CouponItem | Record<string, unknown>;
+    labels?: CouponCardLabels;
     onCopy?: (code: string) => void;
     className?: string;
+    /** Bulk-selection */
+    selectable?: boolean;
+    isSelected?: boolean;
+    onSelect?: (id: string, selected: boolean) => void;
+    /** Admin/seller CRUD actions — when any is provided, the action bar is rendered. */
+    onEdit?: (id: string) => void;
+    onToggleActive?: (id: string, currentlyActive: boolean) => void | Promise<void>;
+    onDelete?: (id: string) => void | Promise<void>;
 }
-export declare function CouponCard({ coupon, labels, onCopy, className, }: CouponCardProps): import("react/jsx-runtime").JSX.Element;
+export declare function CouponCard({ coupon, labels: labelsProp, onCopy, className, selectable, isSelected, onSelect, onEdit, onToggleActive, onDelete, }: CouponCardProps): import("react/jsx-runtime").JSX.Element;
 export {};