@chopkola/common 1.0.185 → 1.0.187

package/build/types/cart.d.ts

@@ -1,26 +1,10 @@
 import { CartItemTypeEnum, CartStatusEnum, CartTypeEnum } from "./enum/collection";
-import { MoneyString, Timestamps, UUID, Nullable } from "./global";
-import { SelectedModifierOption } from "./menu_n_meal";
-/**
- * PRODUCTION NOTE:
- * We assign a `vendor_id` and `cart_type` directly to the Cart.
- * In food delivery platforms (like UberEats/Instacart), you generally
- * cannot mix hot restaurant food and grocery items in the same checkout,
- * nor can you easily mix vendors. This enforces business rules at the DB level.
- */
-export interface Cart extends Timestamps {
-    id: UUID;
-    user_id: Nullable<UUID>;
-    session_id: string;
-    cart_type: CartTypeEnum;
-    status: CartStatusEnum;
-    expires_at: Date;
-    total_items: number;
-    subtotal: MoneyString;
+import { MoneyString, Timestamps, UUID, Nullable, DateString, TimeString } from "./global";
+export interface CartSelectedModifierOption {
+    modifier_group_id: UUID;
+    modifier_option_id: UUID;
+    quantity: number;
 }
-/**
- * Base fields shared by ALL cart items
- */
 export interface BaseCartItem extends Timestamps {
     id: UUID;
     cart_id: UUID;
@@ -29,13 +13,9 @@ export interface BaseCartItem extends Timestamps {
     unit_price: MoneyString;
     total_price: MoneyString;
 }
-/**
- * MEAL CART ITEM (Restaurant)
- * Requires exact knowledge of which modifiers the user selected.
- */
 export interface MealCartItemMetadata {
     special_instructions: Nullable<string>;
-    selected_options: SelectedModifierOption[];
+    selected_options: CartSelectedModifierOption[];
 }
 export interface MealCartItem extends BaseCartItem {
     item_type: CartItemTypeEnum.MEAL;
@@ -45,10 +25,6 @@ export interface MealCartItem extends BaseCartItem {
     inventory_item_id: null;
     metadata: MealCartItemMetadata;
 }
-/**
- * PRODUCT CART ITEM (Grocery/Retail)
- * Requires exact knowledge of the Inventory Item to reserve stock.
- */
 export interface ProductCartItemMetadata {
     special_instructions: Nullable<string>;
     accepts_substitutions: boolean;
@@ -61,38 +37,44 @@ export interface ProductCartItem extends BaseCartItem {
     inventory_item_id: UUID;
     metadata: ProductCartItemMetadata;
 }
-/**
- * 🚀 FINAL CART ITEM UNION
- * DB constraint: Item is either a Meal OR a Product.
- */
-export type CartItem = MealCartItem | ProductCartItem;
-/**
- * Used for the frontend Cart Page view.
- * Contains the Cart and an array of fully populated items.
- */
-export interface CartAggregate extends Cart {
-    items: CartItem[];
+export interface ReservationCartItemMetadata {
+    reservation_date: DateString;
+    reservation_time: TimeString;
+    party_size: number;
+    special_requests: Nullable<string>;
+}
+export interface ReservationCartItem extends BaseCartItem {
+    item_type: CartItemTypeEnum.RESERVATION;
+    meal_id: null;
+    product_id: null;
+    product_variant_id: null;
+    inventory_item_id: null;
+    metadata: ReservationCartItemMetadata;
+}
+export type CartItem = MealCartItem | ProductCartItem | ReservationCartItem;
+export interface BaseCart<T extends CartItem> extends Timestamps {
+    id: UUID;
+    user_id: Nullable<UUID>;
+    session_id: string;
+    cart_type: CartTypeEnum;
+    vendor_id: UUID;
+    status: CartStatusEnum;
+    expires_at: Date;
+    total_items: number;
+    subtotal: MoneyString;
+    items: T[];
+}
+export interface RestaurantCart extends BaseCart<MealCartItem | ReservationCartItem> {
+    cart_type: CartTypeEnum.RESTAURANT;
+    delivery_fee_estimate?: MoneyString;
     tax_estimate?: MoneyString;
+    total_estimate?: MoneyString;
+}
+export interface GroceryCart extends BaseCart<ProductCartItem> {
+    cart_type: CartTypeEnum.GROCERY;
+    bag_fee_estimate?: MoneyString;
     delivery_fee_estimate?: MoneyString;
+    tax_estimate?: MoneyString;
     total_estimate?: MoneyString;
 }
-/** Base fields required from the frontend to add an item */
-type BaseAddToCartInput = {
-    cart_id: UUID;
-    quantity: number;
-};
-export type AddMealToCartInput = BaseAddToCartInput & {
-    item_type: CartItemTypeEnum.MEAL;
-    meal_id: UUID;
-    metadata: MealCartItemMetadata;
-};
-export type AddProductToCartInput = BaseAddToCartInput & {
-    item_type: CartItemTypeEnum.PRODUCT;
-    product_id: UUID;
-    product_variant_id?: UUID;
-    inventory_item_id: UUID;
-    metadata: ProductCartItemMetadata;
-};
-/** Frontend payload type for "Add To Cart" requests */
-export type AddToCartInput = AddMealToCartInput | AddProductToCartInput;
-export {};
+export type CartAggregate = RestaurantCart | GroceryCart;

package/build/types/cart.js

@@ -1,2 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+// function renderCart(cart: CartAggregate) {
+//   if (cart.cart_type === CartTypeEnum.RESTAURANT) {
+//     // TypeScript KNOWS this is a RestaurantCart.
+//     // It will auto-complete `meal_id` and `party_size` but throw an error if you type `product_id`.
+//     cart.items.forEach(item => {
+//       if (item.item_type === CartItemTypeEnum.MEAL) {
+//         console.log(item.meal_id); // ✅ Works
+//       }
+//     });
+//   } 
+//   if (cart.cart_type === CartTypeEnum.GROCERY) {
+//     // TypeScript KNOWS this is a GroceryCart.
+//     // It will auto-complete `inventory_item_id`.
+//     cart.items.forEach(item => {
+//       console.log(item.inventory_item_id); // ✅ Works
+//     })
+//   }
+// }

package/build/types/enum/collection.d.ts

@@ -109,7 +109,8 @@ export declare enum CartTypeEnum {
 }
 export declare enum CartItemTypeEnum {
     MEAL = "meal",
-    PRODUCT = "product"
+    PRODUCT = "product",
+    RESERVATION = "reservation"
 }
 export declare enum CartStatusEnum {
     ACTIVE = "active",

package/build/types/enum/collection.js

@@ -132,6 +132,7 @@ var CartItemTypeEnum;
 (function (CartItemTypeEnum) {
     CartItemTypeEnum["MEAL"] = "meal";
     CartItemTypeEnum["PRODUCT"] = "product";
+    CartItemTypeEnum["RESERVATION"] = "reservation";
 })(CartItemTypeEnum || (exports.CartItemTypeEnum = CartItemTypeEnum = {}));
 var CartStatusEnum;
 (function (CartStatusEnum) {

package/build/types/global.d.ts

@@ -10,6 +10,10 @@ export type DecimalString = string & {
 };
 export type MoneyString = DecimalString;
 export type QuantityString = DecimalString;
+/** ISO 8601 date string e.g. "2023-10-27" */
+export type DateString = string & {
+    readonly __brand: "DateString";
+};
 /** ISO 8601 time string e.g. "17:00" */
 export type TimeString = string & {
     readonly __brand: "TimeString";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chopkola/common",
-  "version": "1.0.185",
+  "version": "1.0.187",
   "description": "",
   "license": "ISC",
   "author": "akrosoft technology ltd",