@mohasinac/appkit 4.13.1 → 4.15.0

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

@@ -339,17 +339,16 @@ export declare const productItemSchema: z.ZodObject<{
     updatedAt?: string | undefined;
     storeId?: string | undefined;
     features?: string[] | undefined;
-    category?: string | undefined;
-    featured?: boolean | undefined;
-    listingType?: "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live" | undefined;
-    isPromoted?: boolean | undefined;
     description?: string | undefined;
     slug?: string | undefined;
+    category?: string | undefined;
+    categorySlug?: string | undefined;
     subcategory?: string | undefined;
     stockQuantity?: number | undefined;
     availableQuantity?: number | undefined;
     mainImage?: string | undefined;
     images?: string[] | undefined;
+    featured?: boolean | undefined;
     tags?: string[] | undefined;
     specifications?: {
         value: string;
@@ -362,6 +361,7 @@ export declare const productItemSchema: z.ZodObject<{
     insurance?: boolean | undefined;
     insuranceCost?: number | undefined;
     shippingPaidBy?: "seller" | "buyer" | undefined;
+    listingType?: "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live" | undefined;
     auctionEndDate?: string | Date | undefined;
     startingBid?: number | undefined;
     currentBid?: number | undefined;
@@ -379,6 +379,33 @@ export declare const productItemSchema: z.ZodObject<{
     preOrderCurrentCount?: number | undefined;
     preOrderProductionStatus?: "upcoming" | "in_production" | "ready_to_ship" | undefined;
     preOrderCancellable?: boolean | undefined;
+    isPromoted?: boolean | undefined;
+    pickupAddressId?: string | undefined;
+    viewCount?: number | undefined;
+    prizeRevealStatus?: "closed" | "open" | "pending" | undefined;
+    prizeRevealWindowStart?: string | Date | undefined;
+    prizeRevealWindowEnd?: string | Date | undefined;
+    prizeDrawDurationDays?: number | undefined;
+    prizeRevealMode?: "scheduled" | "instant" | undefined;
+    prizeCurrentEntries?: number | undefined;
+    prizeMaxEntries?: number | undefined;
+    pricePerEntry?: number | undefined;
+    rating?: number | undefined;
+    publishedAt?: string | undefined;
+    media?: {
+        type: "video" | "image" | "file";
+        url: string;
+        source?: "upload" | "youtube" | "external" | undefined;
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
+        duration?: number | undefined;
+    }[] | undefined;
+    seo?: {
+        title?: string | undefined;
+        description?: string | undefined;
+        keywords?: string[] | undefined;
+    } | undefined;
     allowShipBeforeEmiComplete?: boolean | undefined;
     printMeta?: {
         size?: string | undefined;
@@ -386,8 +413,6 @@ export declare const productItemSchema: z.ZodObject<{
         finish?: string | undefined;
         editionSize?: number | undefined;
     } | undefined;
-    pickupAddressId?: string | undefined;
-    viewCount?: number | undefined;
     avgRating?: number | undefined;
     reviewCount?: number | undefined;
     bulkDiscounts?: {
@@ -432,33 +457,8 @@ export declare const productItemSchema: z.ZodObject<{
         estimatedValue?: number | undefined;
         wonByOrderId?: string | undefined;
     }[] | undefined;
-    pricePerEntry?: number | undefined;
-    prizeMaxEntries?: number | undefined;
-    prizeCurrentEntries?: number | undefined;
-    prizeRevealWindowStart?: string | Date | undefined;
-    prizeRevealWindowEnd?: string | Date | undefined;
-    prizeRevealStatus?: "closed" | "open" | "pending" | undefined;
-    prizeDrawDurationDays?: number | undefined;
     prizeGithubFileUrl?: string | undefined;
-    prizeRevealMode?: "scheduled" | "instant" | undefined;
-    media?: {
-        type: "video" | "image" | "file";
-        url: string;
-        source?: "upload" | "youtube" | "external" | undefined;
-        alt?: string | undefined;
-        thumbnailUrl?: string | undefined;
-        youtubeId?: string | undefined;
-        duration?: number | undefined;
-    }[] | undefined;
     inStock?: boolean | undefined;
-    rating?: number | undefined;
-    categorySlug?: string | undefined;
-    publishedAt?: string | undefined;
-    seo?: {
-        title?: string | undefined;
-        description?: string | undefined;
-        keywords?: string[] | undefined;
-    } | undefined;
     attributes?: Record<string, string> | undefined;
     originalPrice?: number | undefined;
     sellerAvatar?: string | undefined;
@@ -478,17 +478,16 @@ export declare const productItemSchema: z.ZodObject<{
     updatedAt?: string | undefined;
     storeId?: string | undefined;
     features?: string[] | undefined;
-    category?: string | undefined;
-    featured?: boolean | undefined;
-    listingType?: "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live" | undefined;
-    isPromoted?: boolean | undefined;
     description?: string | undefined;
     slug?: string | undefined;
+    category?: string | undefined;
+    categorySlug?: string | undefined;
     subcategory?: string | undefined;
     stockQuantity?: number | undefined;
     availableQuantity?: number | undefined;
     mainImage?: string | undefined;
     images?: string[] | undefined;
+    featured?: boolean | undefined;
     tags?: string[] | undefined;
     specifications?: {
         value: string;
@@ -501,6 +500,7 @@ export declare const productItemSchema: z.ZodObject<{
     insurance?: boolean | undefined;
     insuranceCost?: number | undefined;
     shippingPaidBy?: "seller" | "buyer" | undefined;
+    listingType?: "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live" | undefined;
     auctionEndDate?: string | Date | undefined;
     startingBid?: number | undefined;
     currentBid?: number | undefined;
@@ -518,6 +518,33 @@ export declare const productItemSchema: z.ZodObject<{
     preOrderCurrentCount?: number | undefined;
     preOrderProductionStatus?: "upcoming" | "in_production" | "ready_to_ship" | undefined;
     preOrderCancellable?: boolean | undefined;
+    isPromoted?: boolean | undefined;
+    pickupAddressId?: string | undefined;
+    viewCount?: number | undefined;
+    prizeRevealStatus?: "closed" | "open" | "pending" | undefined;
+    prizeRevealWindowStart?: string | Date | undefined;
+    prizeRevealWindowEnd?: string | Date | undefined;
+    prizeDrawDurationDays?: number | undefined;
+    prizeRevealMode?: "scheduled" | "instant" | undefined;
+    prizeCurrentEntries?: number | undefined;
+    prizeMaxEntries?: number | undefined;
+    pricePerEntry?: number | undefined;
+    rating?: number | undefined;
+    publishedAt?: string | undefined;
+    media?: {
+        type: "video" | "image" | "file";
+        url: string;
+        source?: "upload" | "youtube" | "external" | undefined;
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
+        duration?: number | undefined;
+    }[] | undefined;
+    seo?: {
+        title?: string | undefined;
+        description?: string | undefined;
+        keywords?: string[] | undefined;
+    } | undefined;
     allowShipBeforeEmiComplete?: boolean | undefined;
     printMeta?: {
         size?: string | undefined;
@@ -525,8 +552,6 @@ export declare const productItemSchema: z.ZodObject<{
         finish?: string | undefined;
         editionSize?: number | undefined;
     } | undefined;
-    pickupAddressId?: string | undefined;
-    viewCount?: number | undefined;
     avgRating?: number | undefined;
     reviewCount?: number | undefined;
     bulkDiscounts?: {
@@ -571,33 +596,8 @@ export declare const productItemSchema: z.ZodObject<{
         estimatedValue?: number | undefined;
         wonByOrderId?: string | undefined;
     }[] | undefined;
-    pricePerEntry?: number | undefined;
-    prizeMaxEntries?: number | undefined;
-    prizeCurrentEntries?: number | undefined;
-    prizeRevealWindowStart?: string | Date | undefined;
-    prizeRevealWindowEnd?: string | Date | undefined;
-    prizeRevealStatus?: "closed" | "open" | "pending" | undefined;
-    prizeDrawDurationDays?: number | undefined;
     prizeGithubFileUrl?: string | undefined;
-    prizeRevealMode?: "scheduled" | "instant" | undefined;
-    media?: {
-        type: "video" | "image" | "file";
-        url: string;
-        source?: "upload" | "youtube" | "external" | undefined;
-        alt?: string | undefined;
-        thumbnailUrl?: string | undefined;
-        youtubeId?: string | undefined;
-        duration?: number | undefined;
-    }[] | undefined;
     inStock?: boolean | undefined;
-    rating?: number | undefined;
-    categorySlug?: string | undefined;
-    publishedAt?: string | undefined;
-    seo?: {
-        title?: string | undefined;
-        description?: string | undefined;
-        keywords?: string[] | undefined;
-    } | undefined;
     attributes?: Record<string, string> | undefined;
     originalPrice?: number | undefined;
     sellerAvatar?: string | undefined;
@@ -627,8 +627,8 @@ export declare const productListParamsSchema: z.ZodObject<{
     storeId?: string | undefined;
     category?: string | undefined;
     featured?: boolean | undefined;
-    listingType?: "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live" | undefined;
     condition?: "new" | "used" | "refurbished" | "like_new" | "good" | "fair" | "poor" | "broken" | "graded" | undefined;
+    listingType?: "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live" | undefined;
     minPrice?: number | undefined;
     maxPrice?: number | undefined;
     inStock?: boolean | undefined;
@@ -641,8 +641,8 @@ export declare const productListParamsSchema: z.ZodObject<{
     storeId?: string | undefined;
     category?: string | undefined;
     featured?: boolean | undefined;
-    listingType?: "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live" | undefined;
     condition?: "new" | "used" | "refurbished" | "like_new" | "good" | "fair" | "poor" | "broken" | "graded" | undefined;
+    listingType?: "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live" | undefined;
     minPrice?: number | undefined;
     maxPrice?: number | undefined;
     inStock?: boolean | undefined;

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

@@ -25,7 +25,7 @@ export declare const productFeatureAdminCreateSchema: z.ZodObject<{
     label: string;
     scope: "store" | "platform";
     icon: string;
-    category: "shipping" | "custom" | "seller" | "auction" | "condition" | "platform" | "preorder";
+    category: "shipping" | "custom" | "seller" | "condition" | "auction" | "platform" | "preorder";
     isActive: boolean;
     displayOrder: number;
     productTypes: ("all" | "classified" | "auction" | "prize-draw" | "digital-code" | "live" | "product" | "preorder")[];
@@ -36,7 +36,7 @@ export declare const productFeatureAdminCreateSchema: z.ZodObject<{
     label: string;
     scope: "store" | "platform";
     icon: string;
-    category: "shipping" | "custom" | "seller" | "auction" | "condition" | "platform" | "preorder";
+    category: "shipping" | "custom" | "seller" | "condition" | "auction" | "platform" | "preorder";
     isActive: boolean;
     displayOrder: number;
     productTypes: ("all" | "classified" | "auction" | "prize-draw" | "digital-code" | "live" | "product" | "preorder")[];
@@ -57,7 +57,7 @@ export declare const productFeatureStoreCreateSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     label: string;
     icon: string;
-    category: "shipping" | "custom" | "seller" | "auction" | "condition" | "platform" | "preorder";
+    category: "shipping" | "custom" | "seller" | "condition" | "auction" | "platform" | "preorder";
     isActive: boolean;
     displayOrder: number;
     productTypes: ("all" | "classified" | "auction" | "prize-draw" | "digital-code" | "live" | "product" | "preorder")[];
@@ -66,7 +66,7 @@ export declare const productFeatureStoreCreateSchema: z.ZodObject<{
 }, {
     label: string;
     icon: string;
-    category: "shipping" | "custom" | "seller" | "auction" | "condition" | "platform" | "preorder";
+    category: "shipping" | "custom" | "seller" | "condition" | "auction" | "platform" | "preorder";
     isActive: boolean;
     displayOrder: number;
     productTypes: ("all" | "classified" | "auction" | "prize-draw" | "digital-code" | "live" | "product" | "preorder")[];
@@ -86,8 +86,8 @@ export declare const productFeatureUpdateSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     label?: string | undefined;
     icon?: string | undefined;
-    category?: "shipping" | "custom" | "seller" | "auction" | "condition" | "platform" | "preorder" | undefined;
     description?: string | undefined;
+    category?: "shipping" | "custom" | "seller" | "condition" | "auction" | "platform" | "preorder" | undefined;
     isActive?: boolean | undefined;
     displayOrder?: number | undefined;
     iconColor?: string | undefined;
@@ -95,13 +95,86 @@ export declare const productFeatureUpdateSchema: z.ZodObject<{
 }, {
     label?: string | undefined;
     icon?: string | undefined;
-    category?: "shipping" | "custom" | "seller" | "auction" | "condition" | "platform" | "preorder" | undefined;
     description?: string | undefined;
+    category?: "shipping" | "custom" | "seller" | "condition" | "auction" | "platform" | "preorder" | undefined;
     isActive?: boolean | undefined;
     displayOrder?: number | undefined;
     iconColor?: string | undefined;
     productTypes?: ("all" | "classified" | "auction" | "prize-draw" | "digital-code" | "live" | "product" | "preorder")[] | undefined;
 }>;
+/**
+ * The FORM schema for the product-feature editor, with UI metadata.
+ *
+ * `AdminFeatureEditorView` had **no validation whatsoever** before W5 — ten
+ * `useState` fields, `required` on the inputs (an HTML attribute any
+ * programmatic submit bypasses), and nothing else. Meanwhile these validators
+ * had existed all along and simply were not wired: the "schema exists, the
+ * consumer ignores it" case the plan catalogues.
+ *
+ * It reuses `productFeatureAdminCreateSchema`'s field shapes rather than
+ * restating them — a second copy of the same bounds is how the two would come
+ * to disagree. Only the annotations are new.
+ *
+ * 🛑 `annotate()` must be the OUTERMOST call — it keys a WeakMap by schema
+ * instance and every zod wrapper returns a new one.
+ */
+export declare const productFeatureFormSchema: z.ZodEffects<z.ZodObject<{
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    icon: z.ZodString;
+    iconColor: z.ZodOptional<z.ZodString>;
+    category: z.ZodEnum<["shipping", "seller", "condition", "platform", "auction", "preorder", "custom"]>;
+    scope: z.ZodEnum<["platform", "store"]>;
+    productTypes: z.ZodArray<z.ZodEnum<["product", "auction", "preorder", "prize-draw", "classified", "digital-code", "live", "all"]>, "many">;
+    storeId: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodBoolean;
+    displayOrder: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    scope: "store" | "platform";
+    icon: string;
+    category: "shipping" | "custom" | "seller" | "condition" | "auction" | "platform" | "preorder";
+    isActive: boolean;
+    displayOrder: number;
+    productTypes: ("all" | "classified" | "auction" | "prize-draw" | "digital-code" | "live" | "product" | "preorder")[];
+    storeId?: string | undefined;
+    description?: string | undefined;
+    iconColor?: string | undefined;
+}, {
+    label: string;
+    scope: "store" | "platform";
+    icon: string;
+    category: "shipping" | "custom" | "seller" | "condition" | "auction" | "platform" | "preorder";
+    isActive: boolean;
+    displayOrder: number;
+    productTypes: ("all" | "classified" | "auction" | "prize-draw" | "digital-code" | "live" | "product" | "preorder")[];
+    storeId?: string | undefined;
+    description?: string | undefined;
+    iconColor?: string | undefined;
+}>, {
+    label: string;
+    scope: "store" | "platform";
+    icon: string;
+    category: "shipping" | "custom" | "seller" | "condition" | "auction" | "platform" | "preorder";
+    isActive: boolean;
+    displayOrder: number;
+    productTypes: ("all" | "classified" | "auction" | "prize-draw" | "digital-code" | "live" | "product" | "preorder")[];
+    storeId?: string | undefined;
+    description?: string | undefined;
+    iconColor?: string | undefined;
+}, {
+    label: string;
+    scope: "store" | "platform";
+    icon: string;
+    category: "shipping" | "custom" | "seller" | "condition" | "auction" | "platform" | "preorder";
+    isActive: boolean;
+    displayOrder: number;
+    productTypes: ("all" | "classified" | "auction" | "prize-draw" | "digital-code" | "live" | "product" | "preorder")[];
+    storeId?: string | undefined;
+    description?: string | undefined;
+    iconColor?: string | undefined;
+}>;
+export type ProductFeatureFormValues = z.infer<typeof productFeatureFormSchema>;
 export type ProductFeatureAdminCreatePayload = z.infer<typeof productFeatureAdminCreateSchema>;
 export type ProductFeatureStoreCreatePayload = z.infer<typeof productFeatureStoreCreateSchema>;
 export type ProductFeatureUpdatePayload = z.infer<typeof productFeatureUpdateSchema>;

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

@@ -6,6 +6,7 @@
  * of hand-rolling parallel schemas.
  */
 import { z } from "zod";
+import { annotate } from "../../shell/field-ui-meta";
 export const PRODUCT_FEATURE_PRODUCT_TYPE_ENUM = z.enum([
     "product",
     "auction",
@@ -66,3 +67,65 @@ export const productFeatureUpdateSchema = z.object({
     isActive: z.boolean().optional(),
     displayOrder: z.number().int().min(0).max(FEATURE_DISPLAY_ORDER_MAX).optional(),
 });
+/**
+ * The FORM schema for the product-feature editor, with UI metadata.
+ *
+ * `AdminFeatureEditorView` had **no validation whatsoever** before W5 — ten
+ * `useState` fields, `required` on the inputs (an HTML attribute any
+ * programmatic submit bypasses), and nothing else. Meanwhile these validators
+ * had existed all along and simply were not wired: the "schema exists, the
+ * consumer ignores it" case the plan catalogues.
+ *
+ * It reuses `productFeatureAdminCreateSchema`'s field shapes rather than
+ * restating them — a second copy of the same bounds is how the two would come
+ * to disagree. Only the annotations are new.
+ *
+ * 🛑 `annotate()` must be the OUTERMOST call — it keys a WeakMap by schema
+ * instance and every zod wrapper returns a new one.
+ */
+export const productFeatureFormSchema = z.object({
+    label: annotate(productFeatureAdminCreateSchema.shape.label, {
+        section: "basics", sectionLabel: "Feature", sectionRequired: true,
+        quick: true, order: 1, row: "full",
+    }),
+    description: annotate(productFeatureAdminCreateSchema.shape.description, {
+        section: "basics", order: 2, row: "full",
+    }),
+    icon: annotate(productFeatureAdminCreateSchema.shape.icon, {
+        section: "basics", quick: true, order: 3, row: "pair",
+    }),
+    iconColor: annotate(productFeatureAdminCreateSchema.shape.iconColor, {
+        section: "basics", order: 4, row: "pair",
+    }),
+    category: annotate(productFeatureAdminCreateSchema.shape.category, {
+        section: "scope", sectionLabel: "Scope & Applicability",
+        quick: true, order: 1, row: "pair",
+    }),
+    scope: annotate(productFeatureAdminCreateSchema.shape.scope, {
+        section: "scope", quick: true, order: 2, row: "pair",
+    }),
+    productTypes: annotate(productFeatureAdminCreateSchema.shape.productTypes, {
+        section: "scope", order: 3, row: "full", kind: "list",
+    }),
+    storeId: annotate(productFeatureAdminCreateSchema.shape.storeId, {
+        section: "scope", order: 4, row: "pair",
+        help: "Only used when scope is \"store\".",
+    }),
+    isActive: annotate(productFeatureAdminCreateSchema.shape.isActive, {
+        section: "visibility", sectionLabel: "Visibility", order: 1, row: "quarter",
+    }),
+    displayOrder: annotate(productFeatureAdminCreateSchema.shape.displayOrder, {
+        section: "visibility", order: 2, row: "pair",
+    }),
+}).superRefine((v, ctx) => {
+    // The one rule no per-field bound can state: a store-scoped feature must
+    // name its store. The server enforces it too — this exists so the admin is
+    // told before submitting rather than by a 400.
+    if (v.scope === "store" && !v.storeId?.trim()) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["storeId"],
+            message: "A store-scoped feature must name a store.",
+        });
+    }
+});

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

@@ -1,4 +1,5 @@
 import type { MediaField } from "../../media/types/index";
+import type { AvailabilityFilter } from "../../../constants/field-names";
 import type { CustomField, CustomSection, ProductPrintMeta } from "../schemas/firestore";
 export type { CustomField, CustomSection, ProductPrintMeta } from "../schemas/firestore";
 export type ProductStatus = "draft" | "published" | "in_review" | "archived";
@@ -168,6 +169,13 @@ export interface ProductListResponse {
     hasMore: boolean;
     /** Set when the query fell back to an empty result due to a DB error (index missing, permission denied). */
     warning?: string;
+    /**
+     * A bounded fetch saturated its ceiling, so `total` is a FLOOR. Render it as
+     * "50+", never as an exact count, and never derive a final page number from
+     * it — `totalPages` is deliberately `page + 1` while this is set, so the
+     * pager offers a live Next instead of claiming a false last page.
+     */
+    truncated?: boolean;
 }
 export interface ProductListParams {
     q?: string;
@@ -177,7 +185,14 @@ export interface ProductListParams {
     condition?: ProductCondition;
     minPrice?: number;
     maxPrice?: number;
-    inStock?: boolean;
+    /**
+     * Which availability scope to request — the three-tab bar rendered by
+     * `<AvailabilityTabs>`. Browse surfaces must send this on EVERY request,
+     * including the default `"available"`: the API treats an absent value as
+     * "all", so omitting it makes the client refetch disagree with the SSR
+     * paint, permanently (Root Cause #30).
+     */
+    availability?: AvailabilityFilter;
     /** Canonical listing-kind discriminator (SB1-G Phase 4). Accepts a single
      * `ListingType`, or a `|`-joined multi-value string (sievejs OR-group,
      * e.g. `"standard|classified|digital-code|live"`) for the consolidated

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

@@ -797,14 +797,14 @@ export declare const promotionsListParamsSchema: z.ZodObject<{
     scope?: "seller" | "admin" | undefined;
     pageSize?: number | undefined;
     storeId?: string | undefined;
-    filters?: string | undefined;
     isActive?: boolean | undefined;
+    filters?: string | undefined;
 }, {
     sort?: string | undefined;
     page?: number | undefined;
     scope?: "seller" | "admin" | undefined;
     pageSize?: number | undefined;
     storeId?: string | undefined;
-    filters?: string | undefined;
     isActive?: boolean | undefined;
+    filters?: string | undefined;
 }>;

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

@@ -111,10 +111,10 @@ export declare const reviewFirestoreSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">;
     userId: string;
     verified: boolean;
-    rating: number;
     productId: string;
     productTitle: string;
     userName: string;
+    rating: number;
     comment: string;
     helpfulCount: number;
     reportCount: number;
@@ -126,10 +126,9 @@ export declare const reviewFirestoreSchema: z.ZodObject<{
         trimStart?: number | undefined;
     } | undefined;
     storeId?: string | undefined;
+    images?: string[] | undefined;
     featured?: boolean | undefined;
     listingType?: string | undefined;
-    images?: string[] | undefined;
-    storeName?: string | undefined;
     userAvatar?: string | undefined;
     moderatorId?: string | undefined;
     moderatorNote?: string | undefined;
@@ -140,6 +139,7 @@ export declare const reviewFirestoreSchema: z.ZodObject<{
     rejectedAt?: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
+    storeName?: string | undefined;
     userSlug?: string | undefined;
     hasImages?: boolean | undefined;
     isAnonymous?: boolean | undefined;
@@ -159,10 +159,10 @@ export declare const reviewFirestoreSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">;
     userId: string;
     verified: boolean;
-    rating: number;
     productId: string;
     productTitle: string;
     userName: string;
+    rating: number;
     comment: string;
     helpfulCount: number;
     reportCount: number;
@@ -174,10 +174,9 @@ export declare const reviewFirestoreSchema: z.ZodObject<{
         trimStart?: number | undefined;
     } | undefined;
     storeId?: string | undefined;
+    images?: string[] | undefined;
     featured?: boolean | undefined;
     listingType?: string | undefined;
-    images?: string[] | undefined;
-    storeName?: string | undefined;
     userAvatar?: string | undefined;
     moderatorId?: string | undefined;
     moderatorNote?: string | undefined;
@@ -188,6 +187,7 @@ export declare const reviewFirestoreSchema: z.ZodObject<{
     rejectedAt?: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
+    storeName?: string | undefined;
     userSlug?: string | undefined;
     hasImages?: boolean | undefined;
     isAnonymous?: boolean | undefined;
@@ -293,9 +293,9 @@ export declare const reviewSchema: z.ZodObject<{
     status: "pending" | "approved" | "rejected";
     id: string;
     userId: string;
-    rating: 3 | 1 | 2 | 4 | 5;
     productId: string;
     userName: string;
+    rating: 3 | 1 | 2 | 4 | 5;
     title?: string | undefined;
     video?: {
         url: string;
@@ -307,26 +307,26 @@ export declare const reviewSchema: z.ZodObject<{
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     verified?: boolean | undefined;
-    featured?: boolean | undefined;
-    listingType?: string | undefined;
     images?: {
         url: string;
         thumbnailUrl?: string | undefined;
     }[] | undefined;
-    storeName?: string | undefined;
+    featured?: boolean | undefined;
+    listingType?: string | undefined;
     productTitle?: string | undefined;
     userAvatar?: string | undefined;
     comment?: string | undefined;
     helpfulCount?: number | undefined;
     reportCount?: number | undefined;
+    storeName?: string | undefined;
     storeSlug?: string | undefined;
 }, {
     status: "pending" | "approved" | "rejected";
     id: string;
     userId: string;
-    rating: 3 | 1 | 2 | 4 | 5;
     productId: string;
     userName: string;
+    rating: 3 | 1 | 2 | 4 | 5;
     title?: string | undefined;
     video?: {
         url: string;
@@ -338,18 +338,18 @@ export declare const reviewSchema: z.ZodObject<{
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     verified?: boolean | undefined;
-    featured?: boolean | undefined;
-    listingType?: string | undefined;
     images?: {
         url: string;
         thumbnailUrl?: string | undefined;
     }[] | undefined;
-    storeName?: string | undefined;
+    featured?: boolean | undefined;
+    listingType?: string | undefined;
     productTitle?: string | undefined;
     userAvatar?: string | undefined;
     comment?: string | undefined;
     helpfulCount?: number | undefined;
     reportCount?: number | undefined;
+    storeName?: string | undefined;
     storeSlug?: string | undefined;
 }>;
 /** Base schema for list-query parameters. */
@@ -371,8 +371,8 @@ export declare const reviewListParamsSchema: z.ZodObject<{
     storeId?: string | undefined;
     userId?: string | undefined;
     featured?: boolean | undefined;
-    rating?: number | undefined;
     productId?: string | undefined;
+    rating?: number | undefined;
 }, {
     sort?: string | undefined;
     status?: "pending" | "approved" | "rejected" | undefined;
@@ -381,6 +381,6 @@ export declare const reviewListParamsSchema: z.ZodObject<{
     storeId?: string | undefined;
     userId?: string | undefined;
     featured?: boolean | undefined;
-    rating?: number | undefined;
     productId?: string | undefined;
+    rating?: number | undefined;
 }>;

package/dist/features/scams/constants/scammer-status-display.d.ts

@@ -0,0 +1,28 @@
+import { type ScammerStatus } from "../schemas/firestore";
+/** Human-readable label. Replaces two `.replace(/_/g, " ")` call sites, which
+ *  rendered "pending review" — mechanically correct, and not a written label. */
+export declare const SCAMMER_STATUS_LABEL: Record<ScammerStatus, string>;
+/**
+ * Inline-chip styling. Every entry is a `bg-{status}-surface` + `text-{status}`
+ * pair per Recurrent Root Cause #67 — the two tokens invert together with the
+ * theme, which a literal `text-white` would not.
+ *
+ * `removed` is the neutral case: it has no status colour because it is not a
+ * status outcome, it is a withdrawal. ONE background, ONE ink.
+ */
+export declare const SCAMMER_STATUS_BADGE: Record<ScammerStatus, string>;
+/** Dropdown options, derived from the union so one cannot go missing. */
+export declare const SCAMMER_STATUS_OPTIONS: {
+    value: "verified" | "rejected" | "removed" | "pending_review";
+    label: string;
+}[];
+/**
+ * Narrow an unknown API value to a real status.
+ *
+ * The list view used `toStringValue(item.status, "pending_review")`, which
+ * produces a `string` — so an unrecognised value flowed on as if it were a
+ * status and every consumer fell back to the pending styling. This maps
+ * anything unrecognised to `pending_review` explicitly, and the return type
+ * says so.
+ */
+export declare function toScammerStatus(value: unknown): ScammerStatus;