tt-entities 0.0.30 → 0.0.31

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

@@ -53,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
 // =============================================================================
@@ -120,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';
@@ -188,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.30",
+  "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",