tt-entities 0.0.29 → 0.0.31

package/libs/tatayab-entities-library/src/entities/bundle-product.entity.ts

@@ -0,0 +1,38 @@
+import {
+  Table, Column, Model, ForeignKey, BelongsTo, DataType,
+} from 'sequelize-typescript';
+import { Bundle } from './bundle.entity';
+import { Product } from './product.entity';
+import { ProductVariant } from './product-variant.entity';
+
+@Table
+export class BundleProduct extends Model {
+  @ForeignKey(() => Bundle)
+  @Column({ allowNull: false })
+  declare bundleId: number;
+
+  @ForeignKey(() => Product)
+  @Column({ allowNull: false })
+  declare productId: number;
+
+  // Optional — if set, only this specific variant is part of the bundle
+  // null = customer can pick any variant of this product
+  @ForeignKey(() => ProductVariant)
+  @Column({ allowNull: true })
+  declare productVariantId?: number;
+
+  // Display order inside the bundle picker UI
+  @Column({ defaultValue: 0 })
+  declare sortOrder: number;
+
+  // ─── Associations ─────────────────────────────────────────────────────────────
+
+  @BelongsTo(() => Bundle)
+  declare bundle: Bundle;
+
+  @BelongsTo(() => Product)
+  declare product: Product;
+
+  @BelongsTo(() => ProductVariant)
+  declare variant?: ProductVariant;
+}

package/libs/tatayab-entities-library/src/entities/bundle-store.entity.ts

@@ -0,0 +1,37 @@
+import {
+  Table, Column, Model, ForeignKey, DataType,
+} from 'sequelize-typescript';
+import { Bundle } from './bundle.entity';
+import { Store } from './store.entity';
+import { Status } from '../utils/enums/status';
+
+@Table
+export class BundleStore extends Model {
+  @ForeignKey(() => Bundle)
+  @Column({ allowNull: false })
+  declare bundleId: number;
+
+  @ForeignKey(() => Store)
+  @Column({ allowNull: false })
+  declare storeId: number;
+
+  // Store-specific regular price — null = use bundle.defaultPrice
+  @Column({ type: DataType.DECIMAL(10, 3), allowNull: true })
+  declare price?: number;
+
+  // Sale price — active only within saleStartDate → saleEndDate
+  @Column({ type: DataType.DECIMAL(10, 3), allowNull: true })
+  declare salePrice?: number;
+
+  @Column({ type: DataType.DATE, allowNull: true })
+  declare saleStartDate?: Date;
+
+  @Column({ type: DataType.DATE, allowNull: true })
+  declare saleEndDate?: Date;
+
+  @Column({
+    type: DataType.ENUM(...Object.values(Status)),
+    defaultValue: Status.ACTIVE,
+  })
+  declare status: Status;
+}

package/libs/tatayab-entities-library/src/entities/bundle.entity.ts

@@ -0,0 +1,77 @@
+import {
+  Table, Column, Model, ForeignKey, BelongsTo,
+  HasMany, BelongsToMany, DataType,
+} from 'sequelize-typescript';
+import { Category } from './category.entity';
+import { Store } from './store.entity';
+import { BundleProduct } from './bundle-product.entity';
+import { BundleStore } from './bundle-store.entity';
+import { Product } from './product.entity';
+import { Status } from '../utils/enums/status';
+
+@Table
+export class Bundle extends Model {
+  @Column({ allowNull: false, unique: true })
+  declare sku: string; // Bundle SKU e.g. BNDL-001
+
+  @Column({ allowNull: false })
+  declare nameEn: string;
+
+  @Column({ allowNull: false })
+  declare nameAr: string;
+
+  @Column({ type: DataType.TEXT, allowNull: true })
+  declare descriptionEn?: string;
+
+  @Column({ type: DataType.TEXT, allowNull: true })
+  declare descriptionAr?: string;
+
+  @Column({ allowNull: true })
+  declare image?: string;
+
+  // Total products available to choose from in this bundle
+  @Column({ allowNull: false, defaultValue: 0 })
+  declare totalProducts: number;
+
+  // How many the customer must choose
+  // e.g. totalProducts=10, choiceCount=3 → pick any 3 from 10
+  @Column({ allowNull: false, defaultValue: 1 })
+  declare choiceCount: number;
+
+  // Default price (fallback if no store-specific price)
+  @Column({ type: DataType.DECIMAL(10, 3), allowNull: false, defaultValue: 0 })
+  declare defaultPrice: number;
+
+  @ForeignKey(() => Category)
+  @Column({ allowNull: true })
+  declare categoryId?: number;
+
+  @Column({ defaultValue: 0 })
+  declare sortOrder: number;
+
+  @Column({ defaultValue: false })
+  declare isFeatured: boolean;
+
+  @Column({
+    type: DataType.ENUM(...Object.values(Status)),
+    defaultValue: Status.ACTIVE,
+  })
+  declare status: Status;
+
+  // ─── Associations ─────────────────────────────────────────────────────────────
+
+  @BelongsTo(() => Category)
+  declare category?: Category;
+
+  @HasMany(() => BundleProduct)
+  declare bundleProducts: BundleProduct[];
+
+  @BelongsToMany(() => Product, () => BundleProduct)
+  declare products: Product[];
+
+  @HasMany(() => BundleStore)
+  declare bundleStores: BundleStore[];
+
+  @BelongsToMany(() => Store, () => BundleStore)
+  declare stores: Store[];
+}

package/libs/tatayab-entities-library/src/entities/cart-item-bundle-selection.entity.ts

@@ -0,0 +1,36 @@
+import {
+  Table, Column, Model, ForeignKey, BelongsTo,
+} from 'sequelize-typescript';
+import { CartItem } from './cart-item.entity';
+import { Product } from './product.entity';
+import { ProductVariant } from './product-variant.entity';
+
+@Table
+export class CartItemBundleSelection extends Model {
+  @ForeignKey(() => CartItem)
+  @Column({ allowNull: false })
+  declare cartItemId: number;
+
+  @ForeignKey(() => Product)
+  @Column({ allowNull: false })
+  declare productId: number;
+
+  @ForeignKey(() => ProductVariant)
+  @Column({ allowNull: true })
+  declare productVariantId?: number;
+
+  // Display order within the bundle selection
+  @Column({ allowNull: false, defaultValue: 0 })
+  declare sortOrder: number;
+
+  // ── Associations ──────────────────────────────────────────────────────────────
+
+  @BelongsTo(() => CartItem)
+  declare cartItem: CartItem;
+
+  @BelongsTo(() => Product)
+  declare product: Product;
+
+  @BelongsTo(() => ProductVariant)
+  declare variant?: ProductVariant;
+}

package/libs/tatayab-entities-library/src/entities/cart-item.entity.ts

@@ -0,0 +1,75 @@
+import {
+  Table, Column, Model, ForeignKey, BelongsTo,
+  HasMany, DataType,
+} from 'sequelize-typescript';
+import { Cart } from './cart.entity';
+import { Product } from './product.entity';
+import { ProductVariant } from './product-variant.entity';
+import { Bundle } from './bundle.entity';
+import { CartItemBundleSelection } from './cart-item-bundle-selection.entity';
+
+export enum CartItemType {
+  PRODUCT = 'product',
+  BUNDLE  = 'bundle',
+}
+
+@Table
+export class CartItem extends Model {
+  @ForeignKey(() => Cart)
+  @Column({ allowNull: false })
+  declare cartId: number;
+
+  @Column({
+    type: DataType.ENUM(...Object.values(CartItemType)),
+    allowNull: false,
+  })
+  declare itemType: CartItemType;
+
+  // ── Product fields (null when itemType = bundle) ───────────────────────────
+  @ForeignKey(() => Product)
+  @Column({ allowNull: true })
+  declare productId?: number;
+
+  @ForeignKey(() => ProductVariant)
+  @Column({ allowNull: true })
+  declare productVariantId?: number;
+
+  // ── Bundle fields (null when itemType = product) ───────────────────────────
+  @ForeignKey(() => Bundle)
+  @Column({ allowNull: true })
+  declare bundleId?: number;
+
+  // Composed SKU built at selection time e.g. BNDL-001+PERF-M-001-V3+PERF-W-002
+  @Column({ allowNull: true })
+  declare composedSku?: string;
+
+  // ── Shared ────────────────────────────────────────────────────────────────────
+  @Column({ allowNull: false, defaultValue: 1 })
+  declare quantity: number;
+
+  // Price captured at time of adding — so price changes don't silently update cart
+  @Column({ type: DataType.DECIMAL(10, 3), allowNull: false })
+  declare unitPrice: number;
+
+  // ── Stock flag — set true by the stock-check endpoint ─────────────────────────
+  // Cleared when user updates qty or item is re-validated
+  @Column({ allowNull: false, defaultValue: false })
+  declare isOutOfStock: boolean;
+
+  // ── Associations ──────────────────────────────────────────────────────────────
+
+  @BelongsTo(() => Cart)
+  declare cart: Cart;
+
+  @BelongsTo(() => Product)
+  declare product?: Product;
+
+  @BelongsTo(() => ProductVariant)
+  declare variant?: ProductVariant;
+
+  @BelongsTo(() => Bundle)
+  declare bundle?: Bundle;
+
+  @HasMany(() => CartItemBundleSelection)
+  declare bundleSelections: CartItemBundleSelection[];
+}

package/libs/tatayab-entities-library/src/entities/cart.entity.ts

@@ -0,0 +1,58 @@
+import {
+  Table, Column, Model, ForeignKey, BelongsTo,
+  HasMany, DataType,
+} from 'sequelize-typescript';
+import { User } from './user.entity';
+import { Store } from './store.entity';
+import { CartItem } from './cart-item.entity';
+
+export enum CartStatus {
+  ACTIVE    = 'active',     // In use
+  MERGED    = 'merged',     // Guest cart merged into user cart
+  CONVERTED = 'converted',  // Converted to an order
+  ABANDONED = 'abandoned',  // Expired / not used
+}
+
+@Table
+export class Cart extends Model {
+  // ── Identity — one of these two will always be set, never both null ──────────
+
+  // Logged-in user — null for guests
+  @ForeignKey(() => User)
+  @Column({ allowNull: true })
+  declare userId?: number;
+
+  // Guest identifier — UUID generated on first cart creation, stored on device
+  // null once cart is merged/claimed by a logged-in user
+  @Column({ allowNull: true })
+  declare guestToken?: string;
+
+  // ── Store scope ───────────────────────────────────────────────────────────────
+  @ForeignKey(() => Store)
+  @Column({ allowNull: false })
+  declare storeId: number;
+
+  // ── State ─────────────────────────────────────────────────────────────────────
+  @Column({
+    type: DataType.ENUM(...Object.values(CartStatus)),
+    allowNull: false,
+    defaultValue: CartStatus.ACTIVE,
+  })
+  declare status: CartStatus;
+
+  // Guest carts expire after 30 days of inactivity
+  // User carts expire after 90 days
+  @Column({ type: DataType.DATE, allowNull: true })
+  declare expiresAt?: Date;
+
+  // ── Associations ──────────────────────────────────────────────────────────────
+
+  @BelongsTo(() => User)
+  declare user?: User;
+
+  @BelongsTo(() => Store)
+  declare store: Store;
+
+  @HasMany(() => CartItem)
+  declare items: CartItem[];
+}

package/libs/tatayab-entities-library/src/index.ts

@@ -22,6 +22,9 @@ import { ProductVariant } from './entities/product-variant.entity';
 import { ProductVariantOption } from './entities/product-variant-option.entity';
 import { Tag } from './entities/tag.entity';
 import { ProductTag } from './entities/product-tag.entity';
+import { Bundle } from './entities/bundle.entity';
+import { BundleProduct } from './entities/bundle-product.entity';
+import { BundleStore } from './entities/bundle-store.entity';
 
 // ─── Stores ───────────────────────────────────────────────────────────────────
 import { Store } from './entities/store.entity';
@@ -50,6 +53,11 @@ import { PaymentMethod } from './entities/payment-method.entity';
 import { PaymentMethodCountry } from './entities/payment-method-country.entity';
 import { StorePaymentMethod } from './entities/store-payment-method.entity';
 
+// ─── Carts ────────────────────────────────────────────────────────────────────
+import { Cart } from './entities/cart.entity';
+import { CartItem } from './entities/cart-item.entity';
+import { CartItemBundleSelection } from './entities/cart-item-bundle-selection.entity';
+
 // =============================================================================
 // EXPORTS
 // =============================================================================
@@ -76,6 +84,9 @@ export { ProductVariant } from './entities/product-variant.entity';
 export { ProductVariantOption } from './entities/product-variant-option.entity';
 export { Tag } from './entities/tag.entity';
 export { ProductTag } from './entities/product-tag.entity';
+export { Bundle } from './entities/bundle.entity';
+export { BundleProduct } from './entities/bundle-product.entity';
+export { BundleStore } from './entities/bundle-store.entity';
 
 // ─── Stores ───────────────────────────────────────────────────────────────────
 export { Store } from './entities/store.entity';
@@ -114,6 +125,11 @@ export {
 export { PaymentMethodCountry } from './entities/payment-method-country.entity';
 export { StorePaymentMethod } from './entities/store-payment-method.entity';
 
+// ─── Carts ────────────────────────────────────────────────────────────────────
+export { Cart, CartStatus } from './entities/cart.entity';
+export { CartItem, CartItemType } from './entities/cart-item.entity';
+export { CartItemBundleSelection } from './entities/cart-item-bundle-selection.entity';
+
 // ─── Enums ────────────────────────────────────────────────────────────────────
 export { OsName } from './utils/enums/osName';
 export { ProductApp } from './utils/enums/productApp';
@@ -152,6 +168,9 @@ export function getDbModels(): ModelCtor[] {
     ProductVariantOption,
     Tag,
     ProductTag,
+    Bundle,
+    BundleProduct,
+    BundleStore,
 
     // Stores
     Store,
@@ -179,5 +198,10 @@ export function getDbModels(): ModelCtor[] {
     PaymentMethod,
     PaymentMethodCountry,
     StorePaymentMethod,
+
+    // Cart
+    Cart,
+    CartItem,
+    CartItemBundleSelection,
   ];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tt-entities",
-  "version": "0.0.29",
+  "version": "0.0.31",
   "description": "Tatayab entities library",
   "main": "dist/libs/tatayab-entities-library/index.js",
   "types": "dist/libs/tatayab-entities-library/index.d.ts",