@novha/anlia-core-lib 0.1.0

package/src/events/domain/InventoryEvents.ts

@@ -0,0 +1,184 @@
+import { DomainEvent } from "./DomainEvent";
+import { IInventoryItem } from "../../interfaces/domain/Inventory";
+import { InventoryTransactionType } from "../../enums/domain/Inventory";
+
+// ─── Lifecycle Events ──────────────────────────────────────────────────────────
+
+export interface InventoryItemCreated extends DomainEvent {
+    eventType: "InventoryItemCreated";
+    aggregateType: "InventoryItem";
+    item: IInventoryItem;
+}
+
+export interface InventoryItemUpdated extends DomainEvent {
+    eventType: "InventoryItemUpdated";
+    aggregateType: "InventoryItem";
+    before: Partial<IInventoryItem>;
+    after: Partial<IInventoryItem>;
+}
+
+export interface InventoryItemDeleted extends DomainEvent {
+    eventType: "InventoryItemDeleted";
+    aggregateType: "InventoryItem";
+    /** Snapshot of the item at the time of deletion. */
+    item: IInventoryItem;
+    deletedAt: Date;
+    deletedBy?: string;
+}
+
+// ─── Stock Movement Events ─────────────────────────────────────────────────────
+
+export interface InventoryAdjusted extends DomainEvent {
+    eventType: "InventoryAdjusted";
+    aggregateType: "InventoryItem";
+    itemId: string;
+    previousQuantity: number;
+    newQuantity: number;
+    delta: number;
+    reason?: string;
+    adjustedBy?: string;
+}
+
+export interface InventoryConsumed extends DomainEvent {
+    eventType: "InventoryConsumed";
+    aggregateType: "InventoryItem";
+    itemId: string;
+    quantityConsumed: number;
+    remainingQuantity: number;
+    /** Order or production run that triggered consumption. */
+    referenceId?: string;
+}
+
+export interface InventoryReceived extends DomainEvent {
+    eventType: "InventoryReceived";
+    aggregateType: "InventoryItem";
+    itemId: string;
+    quantityReceived: number;
+    newQuantity: number;
+    supplierId?: string;
+    purchaseOrderId?: string;
+    unitCost?: number;
+    receivedBy?: string;
+    receivedAt: Date;
+}
+
+export interface InventoryTransferred extends DomainEvent {
+    eventType: "InventoryTransferred";
+    aggregateType: "InventoryItem";
+    itemId: string;
+    quantity: number;
+    fromLocationId: string;
+    toLocationId: string;
+    transferredBy?: string;
+    transferredAt: Date;
+}
+
+export interface InventoryReturned extends DomainEvent {
+    eventType: "InventoryReturned";
+    aggregateType: "InventoryItem";
+    itemId: string;
+    quantityReturned: number;
+    newQuantity: number;
+    supplierId?: string;
+    reason?: string;
+    returnedBy?: string;
+    returnedAt: Date;
+}
+
+// ─── Loss Events ───────────────────────────────────────────────────────────────
+
+export interface InventoryExpired extends DomainEvent {
+    eventType: "InventoryExpired";
+    aggregateType: "InventoryItem";
+    itemId: string;
+    quantityExpired: number;
+    expiryDate: Date;
+    markedBy?: string;
+}
+
+export interface InventorySpoiled extends DomainEvent {
+    eventType: "InventorySpoiled";
+    aggregateType: "InventoryItem";
+    itemId: string;
+    quantitySpoiled: number;
+    reason?: string;
+    markedBy?: string;
+}
+
+// ─── Stock Level Events ────────────────────────────────────────────────────────
+
+export interface InventoryLowStock extends DomainEvent {
+    eventType: "InventoryLowStock";
+    aggregateType: "InventoryItem";
+    itemId: string;
+    currentQuantity: number;
+    minimumStockLevel: number;
+}
+
+export interface InventoryOutOfStock extends DomainEvent {
+    eventType: "InventoryOutOfStock";
+    aggregateType: "InventoryItem";
+    itemId: string;
+    occurredAt: Date;
+}
+
+export interface InventoryReplenished extends DomainEvent {
+    eventType: "InventoryReplenished";
+    aggregateType: "InventoryItem";
+    itemId: string;
+    quantityAdded: number;
+    newQuantity: number;
+    transactionType: InventoryTransactionType;
+    replenishedBy?: string;
+    replenishedAt: Date;
+}
+
+// ─── Transaction Events ──────────────────────────────────────────────────────
+
+export interface InventoryTransactionCreated extends DomainEvent {
+    eventType: "InventoryTransactionCreated";
+    aggregateType: "InventoryItem";
+    itemId: string;
+    transactionType: InventoryTransactionType;
+    quantity: number;
+    quantityBefore: number;
+    quantityAfter: number;
+    unitCost?: number;
+    referenceId?: string;
+    notes?: string;
+    createdBy?: string;
+}
+
+export interface InventoryTransactionReversed extends DomainEvent {
+    eventType: "InventoryTransactionReversed";
+    aggregateType: "InventoryItem";
+    itemId: string;
+    /** ID of the original transaction being reversed. */
+    originalTransactionId: string;
+    transactionType: InventoryTransactionType;
+    quantity: number;
+    quantityBefore: number;
+    quantityAfter: number;
+    reason?: string;
+    reversedBy?: string;
+    reversedAt: Date;
+}
+
+// ─── Union Type ────────────────────────────────────────────────────────────────
+
+export type InventoryEvent =
+    | InventoryItemCreated
+    | InventoryItemUpdated
+    | InventoryItemDeleted
+    | InventoryAdjusted
+    | InventoryConsumed
+    | InventoryReceived
+    | InventoryTransferred
+    | InventoryReturned
+    | InventoryExpired
+    | InventorySpoiled
+    | InventoryLowStock
+    | InventoryOutOfStock
+    | InventoryReplenished
+    | InventoryTransactionCreated
+    | InventoryTransactionReversed;

package/src/events/domain/OrderEvents.ts

@@ -0,0 +1,142 @@
+import { DomainEvent } from "./DomainEvent";
+import { IOrder } from "../../orders/domain/Order";
+import { IOrderItem } from "../../orders/domain/OrderItem";
+import { OrderStatus } from "../../orders/domain/Enums";
+
+// ─── Lifecycle Events ──────────────────────────────────────────────────────────
+
+export interface OrderCreated extends DomainEvent {
+    eventType: "OrderCreated";
+    aggregateType: "Order";
+    order: IOrder;
+}
+
+export interface OrderUpdated extends DomainEvent {
+    eventType: "OrderUpdated";
+    aggregateType: "Order";
+    before: Partial<IOrder>;
+    after: Partial<IOrder>;
+}
+
+export interface OrderSubmitted extends DomainEvent {
+    eventType: "OrderSubmitted";
+    aggregateType: "Order";
+    submittedAt: Date;
+    submittedBy?: string;
+}
+
+export interface OrderConfirmed extends DomainEvent {
+    eventType: "OrderConfirmed";
+    aggregateType: "Order";
+    confirmedAt: Date;
+    confirmedBy?: string;
+}
+
+export interface OrderRejected extends DomainEvent {
+    eventType: "OrderRejected";
+    aggregateType: "Order";
+    reason?: string;
+    rejectedAt: Date;
+    rejectedBy?: string;
+}
+
+export interface OrderCancelled extends DomainEvent {
+    eventType: "OrderCancelled";
+    aggregateType: "Order";
+    previousStatus: OrderStatus;
+    reason?: string;
+    cancelledAt: Date;
+    cancelledBy?: string;
+}
+
+export interface OrderCompleted extends DomainEvent {
+    eventType: "OrderCompleted";
+    aggregateType: "Order";
+    completedAt: Date;
+    completedBy?: string;
+}
+
+export interface OrderReopened extends DomainEvent {
+    eventType: "OrderReopened";
+    aggregateType: "Order";
+    previousStatus: OrderStatus;
+    reason?: string;
+    reopenedAt: Date;
+    reopenedBy?: string;
+}
+
+export interface OrderClosed extends DomainEvent {
+    eventType: "OrderClosed";
+    aggregateType: "Order";
+    closedAt: Date;
+    closedBy?: string;
+}
+
+// ─── Order Item Events ────────────────────────────────────────────────────────
+
+export interface OrderItemAdded extends DomainEvent {
+    eventType: "OrderItemAdded";
+    aggregateType: "Order";
+    item: IOrderItem;
+    addedBy?: string;
+}
+
+export interface OrderItemUpdated extends DomainEvent {
+    eventType: "OrderItemUpdated";
+    aggregateType: "Order";
+    before: Partial<IOrderItem>;
+    after: Partial<IOrderItem>;
+    updatedBy?: string;
+}
+
+export interface OrderItemRemoved extends DomainEvent {
+    eventType: "OrderItemRemoved";
+    aggregateType: "Order";
+    itemId: string;
+    reason?: string;
+    removedBy?: string;
+}
+
+export interface OrderItemPrepared extends DomainEvent {
+    eventType: "OrderItemPrepared";
+    aggregateType: "Order";
+    itemId: string;
+    preparedAt: Date;
+    preparedBy?: string;
+}
+
+export interface OrderItemServed extends DomainEvent {
+    eventType: "OrderItemServed";
+    aggregateType: "Order";
+    itemId: string;
+    servedAt: Date;
+    servedBy?: string;
+}
+
+export interface OrderItemVoided extends DomainEvent {
+    eventType: "OrderItemVoided";
+    aggregateType: "Order";
+    itemId: string;
+    reason?: string;
+    voidedAt: Date;
+    voidedBy?: string;
+}
+
+// ─── Union Type ────────────────────────────────────────────────────────────────
+
+export type OrderEvent =
+    | OrderCreated
+    | OrderUpdated
+    | OrderSubmitted
+    | OrderConfirmed
+    | OrderRejected
+    | OrderCancelled
+    | OrderCompleted
+    | OrderReopened
+    | OrderClosed
+    | OrderItemAdded
+    | OrderItemUpdated
+    | OrderItemRemoved
+    | OrderItemPrepared
+    | OrderItemServed
+    | OrderItemVoided;

package/src/events/domain/PaymentEvents.ts

@@ -0,0 +1,92 @@
+import { DomainEvent } from "./DomainEvent";
+import { IPayment } from "../../interfaces/domain/Payment";
+import { PaymentMethod, PaymentStatus } from "../../enums/domain/Payments";
+import { Money } from "../../interfaces/domain/Money";
+
+// ─── Lifecycle Events ──────────────────────────────────────────────────────────
+
+export interface PaymentCreated extends DomainEvent {
+    eventType: "PaymentCreated";
+    aggregateType: "Payment";
+    payment: IPayment;
+    orderId: string;
+}
+
+export interface PaymentAuthorized extends DomainEvent {
+    eventType: "PaymentAuthorized";
+    aggregateType: "Payment";
+    paymentId: string;
+    orderId: string;
+    amount: Money;
+    method: PaymentMethod;
+    authorizationCode?: string;
+    authorizedAt: Date;
+}
+
+export interface PaymentCaptured extends DomainEvent {
+    eventType: "PaymentCaptured";
+    aggregateType: "Payment";
+    paymentId: string;
+    orderId: string;
+    amount: Money;
+    capturedAt: Date;
+}
+
+export interface PaymentDeclined extends DomainEvent {
+    eventType: "PaymentDeclined";
+    aggregateType: "Payment";
+    paymentId: string;
+    orderId: string;
+    amount: Money;
+    method: PaymentMethod;
+    reason?: string;
+    declinedAt: Date;
+}
+
+export interface PaymentRefunded extends DomainEvent {
+    eventType: "PaymentRefunded";
+    aggregateType: "Payment";
+    paymentId: string;
+    orderId: string;
+    /** Amount refunded — may be partial. */
+    refundedAmount: Money;
+    /** Remaining balance after the refund. */
+    remainingAmount: Money;
+    reason?: string;
+    refundedBy?: string;
+    refundedAt: Date;
+}
+
+export interface PaymentVoided extends DomainEvent {
+    eventType: "PaymentVoided";
+    aggregateType: "Payment";
+    paymentId: string;
+    orderId: string;
+    previousStatus: PaymentStatus;
+    reason?: string;
+    voidedBy?: string;
+    voidedAt: Date;
+}
+
+export interface PaymentFailed extends DomainEvent {
+    eventType: "PaymentFailed";
+    aggregateType: "Payment";
+    paymentId: string;
+    orderId: string;
+    amount: Money;
+    method: PaymentMethod;
+    errorCode?: string;
+    errorMessage?: string;
+    failedAt: Date;
+}
+
+// ─── Union Type ────────────────────────────────────────────────────────────────
+
+export type PaymentEvent =
+    | PaymentCreated
+    | PaymentAuthorized
+    | PaymentCaptured
+    | PaymentDeclined
+    | PaymentRefunded
+    | PaymentVoided
+    | PaymentFailed;

package/src/events/domain/RecipeEvents.ts

@@ -0,0 +1,64 @@
+import { DomainEvent } from "./DomainEvent";
+import { IRecipe, IRecipeIngredient } from "../../interfaces/domain/Recipe";
+
+// ─── Lifecycle Events ──────────────────────────────────────────────────────────
+
+export interface RecipeCreated extends DomainEvent {
+    eventType: "RecipeCreated";
+    aggregateType: "Recipe";
+    recipe: IRecipe;
+}
+
+export interface RecipeUpdated extends DomainEvent {
+    eventType: "RecipeUpdated";
+    aggregateType: "Recipe";
+    before: Partial<IRecipe>;
+    after: Partial<IRecipe>;
+    /** Version number after the update. */
+    version: number;
+}
+
+export interface RecipeDeleted extends DomainEvent {
+    eventType: "RecipeDeleted";
+    aggregateType: "Recipe";
+    /** Snapshot of the recipe at the time of deletion. */
+    recipe: IRecipe;
+    deletedAt: Date;
+    deletedBy?: string;
+}
+
+// ─── Ingredient Events ─────────────────────────────────────────────────────────
+
+export interface RecipeIngredientAdded extends DomainEvent {
+    eventType: "RecipeIngredientAdded";
+    aggregateType: "Recipe";
+    ingredient: IRecipeIngredient;
+    addedBy?: string;
+}
+
+export interface RecipeIngredientUpdated extends DomainEvent {
+    eventType: "RecipeIngredientUpdated";
+    aggregateType: "Recipe";
+    ingredientId: string;
+    before: Partial<IRecipeIngredient>;
+    after: Partial<IRecipeIngredient>;
+    updatedBy?: string;
+}
+
+export interface RecipeIngredientRemoved extends DomainEvent {
+    eventType: "RecipeIngredientRemoved";
+    aggregateType: "Recipe";
+    ingredientId: string;
+    reason?: string;
+    removedBy?: string;
+}
+
+// ─── Union Type ────────────────────────────────────────────────────────────────
+
+export type RecipeEvent =
+    | RecipeCreated
+    | RecipeUpdated
+    | RecipeDeleted
+    | RecipeIngredientAdded
+    | RecipeIngredientUpdated
+    | RecipeIngredientRemoved;

package/src/events/domain/ReservationEvents.ts

@@ -0,0 +1,133 @@
+import { DomainEvent } from "./DomainEvent";
+import { IReservation } from "../../interfaces/domain/Reservation";
+import { ReservationStatus } from "../../enums/domain/Reservation";
+
+// ─── Lifecycle Events ──────────────────────────────────────────────────────────
+
+export interface ReservationCreated extends DomainEvent {
+    eventType: "ReservationCreated";
+    aggregateType: "Reservation";
+    reservation: IReservation;
+}
+
+export interface ReservationConfirmed extends DomainEvent {
+    eventType: "ReservationConfirmed";
+    aggregateType: "Reservation";
+    confirmedAt: Date;
+    confirmedBy?: string;
+}
+
+export interface ReservationRejected extends DomainEvent {
+    eventType: "ReservationRejected";
+    aggregateType: "Reservation";
+    reason?: string;
+    rejectedAt: Date;
+    rejectedBy?: string;
+}
+
+export interface ReservationUpdated extends DomainEvent {
+    eventType: "ReservationUpdated";
+    aggregateType: "Reservation";
+    before: Partial<IReservation>;
+    after: Partial<IReservation>;
+}
+
+export interface ReservationCancelled extends DomainEvent {
+    eventType: "ReservationCancelled";
+    aggregateType: "Reservation";
+    reason?: string;
+    cancelledAt: Date;
+    cancelledBy?: string;
+}
+
+// ─── Floor Events ──────────────────────────────────────────────────────────────
+
+export interface ReservationCheckedIn extends DomainEvent {
+    eventType: "ReservationCheckedIn";
+    aggregateType: "Reservation";
+    checkedInAt: Date;
+    checkedInBy?: string;
+}
+
+export interface ReservationSeated extends DomainEvent {
+    eventType: "ReservationSeated";
+    aggregateType: "Reservation";
+    tableIds: string[];
+    seatedAt: Date;
+    seatedBy?: string;
+}
+
+export interface ReservationCompleted extends DomainEvent {
+    eventType: "ReservationCompleted";
+    aggregateType: "Reservation";
+    completedAt: Date;
+}
+
+export interface ReservationNoShow extends DomainEvent {
+    eventType: "ReservationNoShow";
+    aggregateType: "Reservation";
+    markedAt: Date;
+    markedBy?: string;
+}
+
+// ─── Table Assignment Events ───────────────────────────────────────────────────
+
+export interface ReservationTableAssigned extends DomainEvent {
+    eventType: "ReservationTableAssigned";
+    aggregateType: "Reservation";
+    tableIds: string[];
+    assignedBy?: string;
+}
+
+export interface ReservationTableChanged extends DomainEvent {
+    eventType: "ReservationTableChanged";
+    aggregateType: "Reservation";
+    previousTableIds: string[];
+    newTableIds: string[];
+    changedBy?: string;
+    reason?: string;
+}
+
+// ─── Waitlist Events ───────────────────────────────────────────────────────────
+
+export interface WaitlistJoined extends DomainEvent {
+    eventType: "WaitlistJoined";
+    aggregateType: "Reservation";
+    partySize: number;
+    estimatedWaitMinutes?: number;
+    joinedAt: Date;
+}
+
+export interface WaitlistPromoted extends DomainEvent {
+    eventType: "WaitlistPromoted";
+    aggregateType: "Reservation";
+    tableIds: string[];
+    promotedAt: Date;
+    promotedBy?: string;
+}
+
+export interface WaitlistCancelled extends DomainEvent {
+    eventType: "WaitlistCancelled";
+    aggregateType: "Reservation";
+    reason?: string;
+    cancelledAt: Date;
+    cancelledBy?: string;
+}
+
+// ─── Union Type ────────────────────────────────────────────────────────────────
+
+export type ReservationEvent =
+    | ReservationCreated
+    | ReservationConfirmed
+    | ReservationRejected
+    | ReservationUpdated
+    | ReservationCancelled
+    | ReservationCheckedIn
+    | ReservationSeated
+    | ReservationCompleted
+    | ReservationNoShow
+    | ReservationTableAssigned
+    | ReservationTableChanged
+    | WaitlistJoined
+    | WaitlistPromoted
+    | WaitlistCancelled;

package/src/events/domain/RestaurantEvents.ts

@@ -0,0 +1,89 @@
+import { DomainEvent } from "./DomainEvent";
+import { IRestaurant } from "../../interfaces/domain/Restaurant";
+import { IAddress } from "../../interfaces/domain/Address";
+import { OperatingHours } from "../../interfaces/domain/OpeningHours";
+import { RestaurantStatus } from "../../enums/domain/Restaurant";
+
+// ─── Lifecycle Events ──────────────────────────────────────────────────────────
+
+export interface RestaurantCreated extends DomainEvent {
+    eventType: "RestaurantCreated";
+    aggregateType: "Restaurant";
+    restaurant: IRestaurant;
+}
+
+export interface RestaurantUpdated extends DomainEvent {
+    eventType: "RestaurantUpdated";
+    aggregateType: "Restaurant";
+    before: Partial<IRestaurant>;
+    after: Partial<IRestaurant>;
+}
+
+export interface RestaurantActivated extends DomainEvent {
+    eventType: "RestaurantActivated";
+    aggregateType: "Restaurant";
+    previousStatus: RestaurantStatus;
+}
+
+export interface RestaurantSuspended extends DomainEvent {
+    eventType: "RestaurantSuspended";
+    aggregateType: "Restaurant";
+    previousStatus: RestaurantStatus;
+    reason?: string;
+}
+
+export interface RestaurantClosed extends DomainEvent {
+    eventType: "RestaurantClosed";
+    aggregateType: "Restaurant";
+    previousStatus: RestaurantStatus;
+    reason?: string;
+}
+
+export interface RestaurantDeleted extends DomainEvent {
+    eventType: "RestaurantDeleted";
+    aggregateType: "Restaurant";
+    deletedAt: Date;
+}
+
+// ─── Operational Events ────────────────────────────────────────────────────────
+
+export interface RestaurantHoursUpdated extends DomainEvent {
+    eventType: "RestaurantHoursUpdated";
+    aggregateType: "Restaurant";
+    before: OperatingHours[];
+    after: OperatingHours[];
+}
+
+export interface RestaurantLocationUpdated extends DomainEvent {
+    eventType: "RestaurantLocationUpdated";
+    aggregateType: "Restaurant";
+    before: IAddress;
+    after: IAddress;
+}
+
+export interface RestaurantCapacityChanged extends DomainEvent {
+    eventType: "RestaurantCapacityChanged";
+    aggregateType: "Restaurant";
+    previousCapacity: number;
+    newCapacity: number;
+}
+
+export interface RestaurantSettingsUpdated extends DomainEvent {
+    eventType: "RestaurantSettingsUpdated";
+    aggregateType: "Restaurant";
+    settings: Record<string, unknown>;
+}
+
+// ─── Union Type ────────────────────────────────────────────────────────────────
+
+export type RestaurantEvent =
+    | RestaurantCreated
+    | RestaurantUpdated
+    | RestaurantActivated
+    | RestaurantSuspended
+    | RestaurantClosed
+    | RestaurantDeleted
+    | RestaurantHoursUpdated
+    | RestaurantLocationUpdated
+    | RestaurantCapacityChanged
+    | RestaurantSettingsUpdated;