@mohasinac/appkit 4.60.1 → 4.61.0

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

@@ -17,16 +17,19 @@ export declare const discountConfigSchema: z.ZodObject<{
 export declare const bxgyConfigSchema: z.ZodObject<{
     buyQuantity: z.ZodNumber;
     getQuantity: z.ZodNumber;
+    maxItemPrice: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodNumber, number, number>, number, number>>;
     applicableProducts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     applicableCategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     buyQuantity: number;
     getQuantity: number;
+    maxItemPrice?: number | undefined;
     applicableProducts?: string[] | undefined;
     applicableCategories?: string[] | undefined;
 }, {
     buyQuantity: number;
     getQuantity: number;
+    maxItemPrice?: number | undefined;
     applicableProducts?: string[] | undefined;
     applicableCategories?: string[] | undefined;
 }>;
@@ -160,16 +163,19 @@ export declare const couponFirestoreSchema: z.ZodObject<{
     bxgy: z.ZodOptional<z.ZodObject<{
         buyQuantity: z.ZodNumber;
         getQuantity: z.ZodNumber;
+        maxItemPrice: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodNumber, number, number>, number, number>>;
         applicableProducts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         applicableCategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         buyQuantity: number;
         getQuantity: number;
+        maxItemPrice?: number | undefined;
         applicableProducts?: string[] | undefined;
         applicableCategories?: string[] | undefined;
     }, {
         buyQuantity: number;
         getQuantity: number;
+        maxItemPrice?: number | undefined;
         applicableProducts?: string[] | undefined;
         applicableCategories?: string[] | undefined;
     }>>;
@@ -316,6 +322,7 @@ export declare const couponFirestoreSchema: z.ZodObject<{
     bxgy?: {
         buyQuantity: number;
         getQuantity: number;
+        maxItemPrice?: number | undefined;
         applicableProducts?: string[] | undefined;
         applicableCategories?: string[] | undefined;
     } | undefined;
@@ -374,6 +381,7 @@ export declare const couponFirestoreSchema: z.ZodObject<{
     bxgy?: {
         buyQuantity: number;
         getQuantity: number;
+        maxItemPrice?: number | undefined;
         applicableProducts?: string[] | undefined;
         applicableCategories?: string[] | undefined;
     } | undefined;
@@ -382,6 +390,471 @@ export declare const couponFirestoreSchema: z.ZodObject<{
         discountValue: number;
     }[] | undefined;
 }>;
+/**
+ * The admin create-coupon REQUEST BODY.
+ *
+ * 🛑 It lives here, in appkit, because `bxgyConfigSchema` does — and a zod
+ * schema CANNOT cross the version boundary. The consumer root is on zod 4 and
+ * appkit depends on zod 3, so `/api/admin/coupons` composing
+ * `bxgy: bxgyConfigSchema.optional()` into a consumer `z.object({...})` did
+ * not merely infer `unknown`: zod 4 **throws** on it —
+ *
+ *     Invalid element at key "bx": expected a Zod schema
+ *
+ * — so every POST to that route failed. The type error was the only signal,
+ * and it reads as a cosmetic inference problem.
+ *
+ * Composed from the pieces above rather than restated, which is the concern
+ * the route's own comment raised about `bxgy`: "four write paths validate this
+ * shape and a fifth copy is how they drift". Re-declaring the shape in
+ * consumer zod would have been that fifth copy; moving the whole body schema
+ * to where the pieces live is the version of that fix which also works.
+ */
+export declare const couponCreateBodySchema: z.ZodEffects<z.ZodObject<{
+    code: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    type: z.ZodEnum<["percentage", "fixed", "free_shipping", "buy_x_get_y"]>;
+    tiers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        minAmount: z.ZodEffects<z.ZodNumber, number, number>;
+        discountValue: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        minAmount: number;
+        discountValue: number;
+    }, {
+        minAmount: number;
+        discountValue: number;
+    }>, "many">>;
+    bxgy: z.ZodOptional<z.ZodObject<{
+        buyQuantity: z.ZodNumber;
+        getQuantity: z.ZodNumber;
+        maxItemPrice: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodNumber, number, number>, number, number>>;
+        applicableProducts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        applicableCategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        buyQuantity: number;
+        getQuantity: number;
+        maxItemPrice?: number | undefined;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+    }, {
+        buyQuantity: number;
+        getQuantity: number;
+        maxItemPrice?: number | undefined;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+    }>>;
+    discount: z.ZodObject<{
+        value: z.ZodNumber;
+        maxDiscount: z.ZodOptional<z.ZodNumber>;
+        minPurchase: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        value: number;
+        minPurchase?: number | undefined;
+        maxDiscount?: number | undefined;
+    }, {
+        value: number;
+        minPurchase?: number | undefined;
+        maxDiscount?: number | undefined;
+    }>;
+    usage: z.ZodObject<{
+        totalLimit: z.ZodOptional<z.ZodNumber>;
+        perUserLimit: z.ZodOptional<z.ZodNumber>;
+        currentUsage: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        currentUsage: number;
+        totalLimit?: number | undefined;
+        perUserLimit?: number | undefined;
+    }, {
+        currentUsage?: number | undefined;
+        totalLimit?: number | undefined;
+        perUserLimit?: number | undefined;
+    }>;
+    validity: z.ZodObject<{
+        startDate: z.ZodEffects<z.ZodString, Date, string>;
+        endDate: z.ZodEffects<z.ZodOptional<z.ZodString>, Date | undefined, string | undefined>;
+        isActive: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        isActive: boolean;
+        startDate: Date;
+        endDate?: Date | undefined;
+    }, {
+        startDate: string;
+        isActive?: boolean | undefined;
+        endDate?: string | undefined;
+    }>;
+    restrictions: z.ZodDefault<z.ZodObject<{
+        applicableProducts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        applicableCategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        applicableSellers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        excludeProducts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        excludeCategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        firstTimeUserOnly: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        firstTimeUserOnly: boolean;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+        applicableSellers?: string[] | undefined;
+        excludeProducts?: string[] | undefined;
+        excludeCategories?: string[] | undefined;
+    }, {
+        firstTimeUserOnly?: boolean | undefined;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+        applicableSellers?: string[] | undefined;
+        excludeProducts?: string[] | undefined;
+        excludeCategories?: string[] | undefined;
+    }>>;
+    createdBy: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
+    name: string;
+    createdBy: string;
+    description: string;
+    discount: {
+        value: number;
+        minPurchase?: number | undefined;
+        maxDiscount?: number | undefined;
+    };
+    usage: {
+        currentUsage: number;
+        totalLimit?: number | undefined;
+        perUserLimit?: number | undefined;
+    };
+    validity: {
+        isActive: boolean;
+        startDate: Date;
+        endDate?: Date | undefined;
+    };
+    restrictions: {
+        firstTimeUserOnly: boolean;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+        applicableSellers?: string[] | undefined;
+        excludeProducts?: string[] | undefined;
+        excludeCategories?: string[] | undefined;
+    };
+    bxgy?: {
+        buyQuantity: number;
+        getQuantity: number;
+        maxItemPrice?: number | undefined;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+    } | undefined;
+    tiers?: {
+        minAmount: number;
+        discountValue: number;
+    }[] | undefined;
+}, {
+    code: string;
+    type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
+    name: string;
+    discount: {
+        value: number;
+        minPurchase?: number | undefined;
+        maxDiscount?: number | undefined;
+    };
+    usage: {
+        currentUsage?: number | undefined;
+        totalLimit?: number | undefined;
+        perUserLimit?: number | undefined;
+    };
+    validity: {
+        startDate: string;
+        isActive?: boolean | undefined;
+        endDate?: string | undefined;
+    };
+    createdBy?: string | undefined;
+    description?: string | undefined;
+    bxgy?: {
+        buyQuantity: number;
+        getQuantity: number;
+        maxItemPrice?: number | undefined;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+    } | undefined;
+    tiers?: {
+        minAmount: number;
+        discountValue: number;
+    }[] | undefined;
+    restrictions?: {
+        firstTimeUserOnly?: boolean | undefined;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+        applicableSellers?: string[] | undefined;
+        excludeProducts?: string[] | undefined;
+        excludeCategories?: string[] | undefined;
+    } | undefined;
+}>, {
+    code: string;
+    type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
+    name: string;
+    createdBy: string;
+    description: string;
+    discount: {
+        value: number;
+        minPurchase?: number | undefined;
+        maxDiscount?: number | undefined;
+    };
+    usage: {
+        currentUsage: number;
+        totalLimit?: number | undefined;
+        perUserLimit?: number | undefined;
+    };
+    validity: {
+        isActive: boolean;
+        startDate: Date;
+        endDate?: Date | undefined;
+    };
+    restrictions: {
+        firstTimeUserOnly: boolean;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+        applicableSellers?: string[] | undefined;
+        excludeProducts?: string[] | undefined;
+        excludeCategories?: string[] | undefined;
+    };
+    bxgy?: {
+        buyQuantity: number;
+        getQuantity: number;
+        maxItemPrice?: number | undefined;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+    } | undefined;
+    tiers?: {
+        minAmount: number;
+        discountValue: number;
+    }[] | undefined;
+}, {
+    code: string;
+    type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
+    name: string;
+    discount: {
+        value: number;
+        minPurchase?: number | undefined;
+        maxDiscount?: number | undefined;
+    };
+    usage: {
+        currentUsage?: number | undefined;
+        totalLimit?: number | undefined;
+        perUserLimit?: number | undefined;
+    };
+    validity: {
+        startDate: string;
+        isActive?: boolean | undefined;
+        endDate?: string | undefined;
+    };
+    createdBy?: string | undefined;
+    description?: string | undefined;
+    bxgy?: {
+        buyQuantity: number;
+        getQuantity: number;
+        maxItemPrice?: number | undefined;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+    } | undefined;
+    tiers?: {
+        minAmount: number;
+        discountValue: number;
+    }[] | undefined;
+    restrictions?: {
+        firstTimeUserOnly?: boolean | undefined;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+        applicableSellers?: string[] | undefined;
+        excludeProducts?: string[] | undefined;
+        excludeCategories?: string[] | undefined;
+    } | undefined;
+}>;
+export type CouponCreateBody = z.infer<typeof couponCreateBodySchema>;
+/**
+ * The admin update-coupon REQUEST BODY (`PATCH /api/admin/coupons/[id]`).
+ *
+ * 🛑 HERE FOR THE SAME REASON AS `couponCreateBodySchema` — read its note
+ * first. It embeds `bxgyConfigSchema`, and a zod-3 schema composed into a
+ * consumer zod-4 `z.object({...})` THROWS at parse time rather than merely
+ * mistyping. The POST route was migrated when that was discovered; this is
+ * the sibling PATCH, which has the same embed and would fail the same way.
+ *
+ * 🛑 NOT `couponCreateBodySchema.partial()`. That schema carries a
+ * `.superRefine`, so it is a ZodEffects and has no `.partial()` — and the
+ * update body is genuinely a different shape anyway: no `code` (a coupon's
+ * code is immutable after creation), plus the `action` discriminator the
+ * route uses for activate/deactivate.
+ *
+ * Every nested object stays OPTIONAL as a whole, which is what lets the route
+ * merge `validity` and `restrictions` against the stored document instead of
+ * replacing them — a caller sending only `{isActive: false}` must not wipe
+ * the coupon's real dates.
+ */
+export declare const couponUpdateBodySchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tiers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        minAmount: z.ZodEffects<z.ZodNumber, number, number>;
+        discountValue: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        minAmount: number;
+        discountValue: number;
+    }, {
+        minAmount: number;
+        discountValue: number;
+    }>, "many">>;
+    bxgy: z.ZodOptional<z.ZodObject<{
+        buyQuantity: z.ZodNumber;
+        getQuantity: z.ZodNumber;
+        maxItemPrice: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodNumber, number, number>, number, number>>;
+        applicableProducts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        applicableCategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        buyQuantity: number;
+        getQuantity: number;
+        maxItemPrice?: number | undefined;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+    }, {
+        buyQuantity: number;
+        getQuantity: number;
+        maxItemPrice?: number | undefined;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+    }>>;
+    discount: z.ZodOptional<z.ZodObject<{
+        value: z.ZodNumber;
+        maxDiscount: z.ZodOptional<z.ZodNumber>;
+        minPurchase: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        value: number;
+        minPurchase?: number | undefined;
+        maxDiscount?: number | undefined;
+    }, {
+        value: number;
+        minPurchase?: number | undefined;
+        maxDiscount?: number | undefined;
+    }>>;
+    usage: z.ZodOptional<z.ZodObject<{
+        totalLimit: z.ZodOptional<z.ZodNumber>;
+        perUserLimit: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        totalLimit?: number | undefined;
+        perUserLimit?: number | undefined;
+    }, {
+        totalLimit?: number | undefined;
+        perUserLimit?: number | undefined;
+    }>>;
+    validity: z.ZodOptional<z.ZodObject<{
+        startDate: z.ZodOptional<z.ZodEffects<z.ZodString, Date, string>>;
+        endDate: z.ZodEffects<z.ZodOptional<z.ZodString>, Date | undefined, string | undefined>;
+        isActive: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        isActive?: boolean | undefined;
+        endDate?: Date | undefined;
+        startDate?: Date | undefined;
+    }, {
+        isActive?: boolean | undefined;
+        endDate?: string | undefined;
+        startDate?: string | undefined;
+    }>>;
+    restrictions: z.ZodOptional<z.ZodObject<{
+        applicableProducts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        applicableCategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        applicableSellers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        excludeProducts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        excludeCategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        firstTimeUserOnly: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        firstTimeUserOnly?: boolean | undefined;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+        applicableSellers?: string[] | undefined;
+        excludeProducts?: string[] | undefined;
+        excludeCategories?: string[] | undefined;
+    }, {
+        firstTimeUserOnly?: boolean | undefined;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+        applicableSellers?: string[] | undefined;
+        excludeProducts?: string[] | undefined;
+        excludeCategories?: string[] | undefined;
+    }>>;
+    action: z.ZodOptional<z.ZodEnum<["activate", "deactivate"]>>;
+}, "strip", z.ZodTypeAny, {
+    action?: "activate" | "deactivate" | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
+    discount?: {
+        value: number;
+        minPurchase?: number | undefined;
+        maxDiscount?: number | undefined;
+    } | undefined;
+    bxgy?: {
+        buyQuantity: number;
+        getQuantity: number;
+        maxItemPrice?: number | undefined;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+    } | undefined;
+    tiers?: {
+        minAmount: number;
+        discountValue: number;
+    }[] | undefined;
+    usage?: {
+        totalLimit?: number | undefined;
+        perUserLimit?: number | undefined;
+    } | undefined;
+    validity?: {
+        isActive?: boolean | undefined;
+        endDate?: Date | undefined;
+        startDate?: Date | undefined;
+    } | undefined;
+    restrictions?: {
+        firstTimeUserOnly?: boolean | undefined;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+        applicableSellers?: string[] | undefined;
+        excludeProducts?: string[] | undefined;
+        excludeCategories?: string[] | undefined;
+    } | undefined;
+}, {
+    action?: "activate" | "deactivate" | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
+    discount?: {
+        value: number;
+        minPurchase?: number | undefined;
+        maxDiscount?: number | undefined;
+    } | undefined;
+    bxgy?: {
+        buyQuantity: number;
+        getQuantity: number;
+        maxItemPrice?: number | undefined;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+    } | undefined;
+    tiers?: {
+        minAmount: number;
+        discountValue: number;
+    }[] | undefined;
+    usage?: {
+        totalLimit?: number | undefined;
+        perUserLimit?: number | undefined;
+    } | undefined;
+    validity?: {
+        isActive?: boolean | undefined;
+        endDate?: string | undefined;
+        startDate?: string | undefined;
+    } | undefined;
+    restrictions?: {
+        firstTimeUserOnly?: boolean | undefined;
+        applicableProducts?: string[] | undefined;
+        applicableCategories?: string[] | undefined;
+        applicableSellers?: string[] | undefined;
+        excludeProducts?: string[] | undefined;
+        excludeCategories?: string[] | undefined;
+    } | undefined;
+}>;
+export type CouponUpdateBody = z.infer<typeof couponUpdateBodySchema>;
 export declare const couponUsageFirestoreSchema: z.ZodObject<{
     id: z.ZodString;
     userId: z.ZodString;
@@ -621,6 +1094,9 @@ export declare const claimedCouponFirestoreSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">;
     userId: string;
     couponCode: string;
+    claimedAt: string | Date | z.objectOutputType<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, z.ZodTypeAny, "passthrough">;
     couponId: string;
     couponSnapshot: {
         type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
@@ -642,9 +1118,6 @@ export declare const claimedCouponFirestoreSchema: z.ZodObject<{
         storeId?: string | undefined;
         description?: string | undefined;
     };
-    claimedAt: string | Date | z.objectOutputType<{
-        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
-    }, z.ZodTypeAny, "passthrough">;
     expiresAt?: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | null | undefined;
@@ -661,6 +1134,9 @@ export declare const claimedCouponFirestoreSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">;
     userId: string;
     couponCode: string;
+    claimedAt: string | Date | z.objectInputType<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, z.ZodTypeAny, "passthrough">;
     couponId: string;
     couponSnapshot: {
         type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
@@ -682,9 +1158,6 @@ export declare const claimedCouponFirestoreSchema: z.ZodObject<{
         storeId?: string | undefined;
         description?: string | undefined;
     };
-    claimedAt: string | Date | z.objectInputType<{
-        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
-    }, z.ZodTypeAny, "passthrough">;
     expiresAt?: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | null | undefined;