@mohasinac/appkit 4.14.0 → 4.16.0

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

@@ -338,13 +338,26 @@ export declare const productItemSchema: z.ZodObject<{
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     storeId?: string | undefined;
-    features?: string[] | undefined;
-    description?: string | undefined;
-    slug?: string | undefined;
+    listingType?: "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live" | undefined;
     category?: string | undefined;
     categorySlug?: string | undefined;
-    subcategory?: string | undefined;
     stockQuantity?: number | undefined;
+    rating?: number | undefined;
+    publishedAt?: string | undefined;
+    slug?: string | undefined;
+    viewCount?: number | undefined;
+    features?: 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;
+    description?: string | undefined;
+    subcategory?: string | undefined;
     availableQuantity?: number | undefined;
     mainImage?: string | undefined;
     images?: string[] | undefined;
@@ -361,7 +374,6 @@ 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;
@@ -377,11 +389,10 @@ export declare const productItemSchema: z.ZodObject<{
     preOrderDepositAmount?: number | undefined;
     preOrderMaxQuantity?: number | undefined;
     preOrderCurrentCount?: number | undefined;
-    preOrderProductionStatus?: "in_production" | "upcoming" | "ready_to_ship" | 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;
@@ -390,17 +401,6 @@ export declare const productItemSchema: z.ZodObject<{
     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;
@@ -477,13 +477,26 @@ export declare const productItemSchema: z.ZodObject<{
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     storeId?: string | undefined;
-    features?: string[] | undefined;
-    description?: string | undefined;
-    slug?: string | undefined;
+    listingType?: "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live" | undefined;
     category?: string | undefined;
     categorySlug?: string | undefined;
-    subcategory?: string | undefined;
     stockQuantity?: number | undefined;
+    rating?: number | undefined;
+    publishedAt?: string | undefined;
+    slug?: string | undefined;
+    viewCount?: number | undefined;
+    features?: 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;
+    description?: string | undefined;
+    subcategory?: string | undefined;
     availableQuantity?: number | undefined;
     mainImage?: string | undefined;
     images?: string[] | undefined;
@@ -500,7 +513,6 @@ 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;
@@ -516,11 +528,10 @@ export declare const productItemSchema: z.ZodObject<{
     preOrderDepositAmount?: number | undefined;
     preOrderMaxQuantity?: number | undefined;
     preOrderCurrentCount?: number | undefined;
-    preOrderProductionStatus?: "in_production" | "upcoming" | "ready_to_ship" | 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;
@@ -529,17 +540,6 @@ export declare const productItemSchema: z.ZodObject<{
     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;
@@ -625,10 +625,10 @@ export declare const productListParamsSchema: z.ZodObject<{
     q?: string | undefined;
     perPage?: number | undefined;
     storeId?: string | undefined;
+    listingType?: "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live" | undefined;
     category?: string | undefined;
     featured?: boolean | 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;
@@ -639,10 +639,10 @@ export declare const productListParamsSchema: z.ZodObject<{
     q?: string | undefined;
     perPage?: number | undefined;
     storeId?: string | undefined;
+    listingType?: "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live" | undefined;
     category?: string | undefined;
     featured?: boolean | 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

@@ -86,8 +86,8 @@ export declare const productFeatureUpdateSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     label?: string | undefined;
     icon?: string | undefined;
-    description?: string | undefined;
     category?: "shipping" | "custom" | "seller" | "condition" | "auction" | "platform" | "preorder" | undefined;
+    description?: string | 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;
-    description?: string | undefined;
     category?: "shipping" | "custom" | "seller" | "condition" | "auction" | "platform" | "preorder" | undefined;
+    description?: string | 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/promotions/schemas/index.d.ts

@@ -269,7 +269,7 @@ export declare const couponFirestoreSchema: z.ZodObject<{
     code: string;
     type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
     id: string;
-    scope: "seller" | "admin";
+    scope: "admin" | "seller";
     name: string;
     createdAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
@@ -277,8 +277,8 @@ export declare const couponFirestoreSchema: z.ZodObject<{
     updatedAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    description: string;
     createdBy: string;
+    description: string;
     stats: {
         totalUses: number;
         totalRevenue: number;
@@ -327,7 +327,7 @@ export declare const couponFirestoreSchema: z.ZodObject<{
     code: string;
     type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
     id: string;
-    scope: "seller" | "admin";
+    scope: "admin" | "seller";
     name: string;
     createdAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
@@ -335,8 +335,8 @@ export declare const couponFirestoreSchema: z.ZodObject<{
     updatedAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    description: string;
     createdBy: string;
+    description: string;
     stats: {
         totalUses: number;
         totalRevenue: number;
@@ -459,7 +459,7 @@ export declare const claimedCouponSnapshotSchema: z.ZodObject<{
     }>;
 }, "strip", z.ZodTypeAny, {
     type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
-    scope: "seller" | "admin";
+    scope: "admin" | "seller";
     name: string;
     discount: {
         value: number;
@@ -478,7 +478,7 @@ export declare const claimedCouponSnapshotSchema: z.ZodObject<{
     description?: string | undefined;
 }, {
     type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
-    scope: "seller" | "admin";
+    scope: "admin" | "seller";
     name: string;
     discount: {
         value: number;
@@ -545,7 +545,7 @@ export declare const claimedCouponFirestoreSchema: z.ZodObject<{
         }>;
     }, "strip", z.ZodTypeAny, {
         type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
-        scope: "seller" | "admin";
+        scope: "admin" | "seller";
         name: string;
         discount: {
             value: number;
@@ -564,7 +564,7 @@ export declare const claimedCouponFirestoreSchema: z.ZodObject<{
         description?: string | undefined;
     }, {
         type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
-        scope: "seller" | "admin";
+        scope: "admin" | "seller";
         name: string;
         discount: {
             value: number;
@@ -624,7 +624,7 @@ export declare const claimedCouponFirestoreSchema: z.ZodObject<{
     couponId: string;
     couponSnapshot: {
         type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
-        scope: "seller" | "admin";
+        scope: "admin" | "seller";
         name: string;
         discount: {
             value: number;
@@ -664,7 +664,7 @@ export declare const claimedCouponFirestoreSchema: z.ZodObject<{
     couponId: string;
     couponSnapshot: {
         type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
-        scope: "seller" | "admin";
+        scope: "admin" | "seller";
         name: string;
         discount: {
             value: number;
@@ -738,7 +738,7 @@ export declare const couponItemSchema: z.ZodObject<{
     code: string;
     type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
     id: string;
-    scope: "seller" | "admin";
+    scope: "admin" | "seller";
     name: string;
     createdAt: string;
     updatedAt: string;
@@ -762,7 +762,7 @@ export declare const couponItemSchema: z.ZodObject<{
     code: string;
     type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
     id: string;
-    scope: "seller" | "admin";
+    scope: "admin" | "seller";
     name: string;
     createdAt: string;
     updatedAt: string;
@@ -794,7 +794,7 @@ export declare const promotionsListParamsSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     sort?: string | undefined;
     page?: number | undefined;
-    scope?: "seller" | "admin" | undefined;
+    scope?: "admin" | "seller" | undefined;
     pageSize?: number | undefined;
     storeId?: string | undefined;
     isActive?: boolean | undefined;
@@ -802,7 +802,7 @@ export declare const promotionsListParamsSchema: z.ZodObject<{
 }, {
     sort?: string | undefined;
     page?: number | undefined;
-    scope?: "seller" | "admin" | undefined;
+    scope?: "admin" | "seller" | undefined;
     pageSize?: number | undefined;
     storeId?: string | undefined;
     isActive?: boolean | undefined;

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

@@ -110,11 +110,11 @@ export declare const reviewFirestoreSchema: z.ZodObject<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
     userId: string;
+    rating: number;
     verified: boolean;
     productId: string;
     productTitle: string;
     userName: string;
-    rating: number;
     comment: string;
     helpfulCount: number;
     reportCount: number;
@@ -126,9 +126,10 @@ export declare const reviewFirestoreSchema: z.ZodObject<{
         trimStart?: number | undefined;
     } | undefined;
     storeId?: string | undefined;
+    listingType?: string | undefined;
+    storeName?: string | undefined;
     images?: string[] | undefined;
     featured?: boolean | undefined;
-    listingType?: string | undefined;
     userAvatar?: string | undefined;
     moderatorId?: string | undefined;
     moderatorNote?: string | undefined;
@@ -139,7 +140,6 @@ 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;
@@ -158,11 +158,11 @@ export declare const reviewFirestoreSchema: z.ZodObject<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
     userId: string;
+    rating: number;
     verified: boolean;
     productId: string;
     productTitle: string;
     userName: string;
-    rating: number;
     comment: string;
     helpfulCount: number;
     reportCount: number;
@@ -174,9 +174,10 @@ export declare const reviewFirestoreSchema: z.ZodObject<{
         trimStart?: number | undefined;
     } | undefined;
     storeId?: string | undefined;
+    listingType?: string | undefined;
+    storeName?: string | undefined;
     images?: string[] | undefined;
     featured?: boolean | undefined;
-    listingType?: string | undefined;
     userAvatar?: string | undefined;
     moderatorId?: string | undefined;
     moderatorNote?: string | undefined;
@@ -187,7 +188,6 @@ 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;
@@ -306,27 +306,27 @@ export declare const reviewSchema: z.ZodObject<{
     } | undefined;
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
+    listingType?: string | undefined;
+    storeName?: string | undefined;
     verified?: boolean | undefined;
     images?: {
         url: string;
         thumbnailUrl?: string | undefined;
     }[] | 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;
@@ -337,19 +337,19 @@ export declare const reviewSchema: z.ZodObject<{
     } | undefined;
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
+    listingType?: string | undefined;
+    storeName?: string | undefined;
     verified?: boolean | undefined;
     images?: {
         url: string;
         thumbnailUrl?: string | undefined;
     }[] | 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. */
@@ -370,9 +370,9 @@ export declare const reviewListParamsSchema: z.ZodObject<{
     perPage?: number | undefined;
     storeId?: string | undefined;
     userId?: string | undefined;
+    rating?: number | undefined;
     featured?: boolean | undefined;
     productId?: string | undefined;
-    rating?: number | undefined;
 }, {
     sort?: string | undefined;
     status?: "pending" | "approved" | "rejected" | undefined;
@@ -380,7 +380,7 @@ export declare const reviewListParamsSchema: z.ZodObject<{
     perPage?: number | undefined;
     storeId?: string | undefined;
     userId?: string | undefined;
+    rating?: number | undefined;
     featured?: boolean | 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;