@unifiedcommerce/core 0.2.0 → 0.2.1

package/src/modules/orders/repository/index.ts

@@ -0,0 +1,287 @@
+import { eq, and, desc, sql } from "drizzle-orm";
+import type { TxContext } from "../../../kernel/database/tx-context.js";
+import type {
+  DrizzleDatabase,
+  DbOrTx,
+} from "../../../kernel/database/drizzle-db.js";
+import { orders, orderLineItems, orderStatusHistory } from "../schema.js";
+
+// Infer types from Drizzle schema
+export type Order = typeof orders.$inferSelect;
+export type OrderInsert = typeof orders.$inferInsert;
+export type OrderLineItem = typeof orderLineItems.$inferSelect;
+export type OrderLineItemInsert = typeof orderLineItems.$inferInsert;
+export type OrderStatusHistory = typeof orderStatusHistory.$inferSelect;
+export type OrderStatusHistoryInsert = typeof orderStatusHistory.$inferInsert;
+
+/**
+ * OrdersRepository provides type-safe database operations for orders.
+ *
+ * This repository manages orders, order line items, and order status history.
+ * All methods support an optional TxContext parameter for transaction participation.
+ */
+export class OrdersRepository {
+  constructor(private readonly db: DrizzleDatabase) {}
+
+  private getDb(ctx?: TxContext): DbOrTx {
+    return (ctx?.tx as DbOrTx | undefined) ?? this.db;
+  }
+
+  // ─────────────────────────────────────────────────────────────────────────────
+  // Orders
+  // ─────────────────────────────────────────────────────────────────────────────
+
+  async findById(orgId: string, id: string, ctx?: TxContext): Promise<Order | undefined> {
+    const db = this.getDb(ctx);
+    const rows = await db
+      .select()
+      .from(orders)
+      .where(and(eq(orders.organizationId, orgId), eq(orders.id, id)));
+    return rows[0];
+  }
+
+  async findByOrderNumber(
+    orgId: string,
+    orderNumber: string,
+    ctx?: TxContext,
+  ): Promise<Order | undefined> {
+    const db = this.getDb(ctx);
+    const rows = await db
+      .select()
+      .from(orders)
+      .where(and(eq(orders.organizationId, orgId), eq(orders.orderNumber, orderNumber)));
+    return rows[0];
+  }
+
+  async findByCustomerId(
+    orgId: string,
+    customerId: string,
+    ctx?: TxContext,
+  ): Promise<Order[]> {
+    const db = this.getDb(ctx);
+    return db
+      .select()
+      .from(orders)
+      .where(and(eq(orders.organizationId, orgId), eq(orders.customerId, customerId)))
+      .orderBy(desc(orders.placedAt));
+  }
+
+  async findByStatus(orgId: string, status: string, ctx?: TxContext): Promise<Order[]> {
+    const db = this.getDb(ctx);
+    return db
+      .select()
+      .from(orders)
+      .where(and(eq(orders.organizationId, orgId), eq(orders.status, status)))
+      .orderBy(desc(orders.placedAt));
+  }
+
+  async findAll(
+    orgId: string,
+    options?: { limit?: number; offset?: number },
+    ctx?: TxContext,
+  ): Promise<Order[]> {
+    const db = this.getDb(ctx);
+    let query = db
+      .select()
+      .from(orders)
+      .where(eq(orders.organizationId, orgId))
+      .orderBy(desc(orders.placedAt))
+      .$dynamic();
+
+    if (options?.limit !== undefined) {
+      query = query.limit(options.limit);
+    }
+    if (options?.offset !== undefined) {
+      query = query.offset(options.offset);
+    }
+    return query;
+  }
+
+  async create(data: OrderInsert, ctx?: TxContext): Promise<Order> {
+    const db = this.getDb(ctx);
+    const rows = await db.insert(orders).values(data).returning();
+    return rows[0]!;
+  }
+
+  async update(
+    id: string,
+    data: Partial<Omit<OrderInsert, "id">>,
+    ctx?: TxContext,
+  ): Promise<Order | undefined> {
+    const db = this.getDb(ctx);
+    const rows = await db
+      .update(orders)
+      .set(data)
+      .where(eq(orders.id, id))
+      .returning();
+    return rows[0];
+  }
+
+  async updateStatus(
+    id: string,
+    currentStatus: string,
+    newStatus: string,
+    ctx?: TxContext,
+  ): Promise<Order | undefined> {
+    const db = this.getDb(ctx);
+    const data: Partial<OrderInsert> = { status: newStatus };
+    if (newStatus === "fulfilled") {
+      data.fulfilledAt = new Date();
+    } else if (newStatus === "cancelled") {
+      data.cancelledAt = new Date();
+    }
+    // Atomic guard: only update if current status matches expected
+    const rows = await db
+      .update(orders)
+      .set(data)
+      .where(and(eq(orders.id, id), eq(orders.status, currentStatus)))
+      .returning();
+    return rows[0];
+  }
+
+  async delete(id: string, ctx?: TxContext): Promise<boolean> {
+    const db = this.getDb(ctx);
+    const result = await db.delete(orders).where(eq(orders.id, id)).returning();
+    return result.length > 0;
+  }
+
+  // ─────────────────────────────────────────────────────────────────────────────
+  // Order Line Items
+  // ─────────────────────────────────────────────────────────────────────────────
+
+  async findAllLineItems(ctx?: TxContext): Promise<OrderLineItem[]> {
+    const db = this.getDb(ctx);
+    return db.select().from(orderLineItems);
+  }
+
+  async findLineItemById(
+    id: string,
+    ctx?: TxContext,
+  ): Promise<OrderLineItem | undefined> {
+    const db = this.getDb(ctx);
+    const rows = await db
+      .select()
+      .from(orderLineItems)
+      .where(eq(orderLineItems.id, id));
+    return rows[0];
+  }
+
+  async findLineItemsByOrderId(
+    orderId: string,
+    ctx?: TxContext,
+  ): Promise<OrderLineItem[]> {
+    const db = this.getDb(ctx);
+    return db
+      .select()
+      .from(orderLineItems)
+      .where(eq(orderLineItems.orderId, orderId));
+  }
+
+  async createLineItem(
+    data: OrderLineItemInsert,
+    ctx?: TxContext,
+  ): Promise<OrderLineItem> {
+    const db = this.getDb(ctx);
+    const rows = await db.insert(orderLineItems).values(data).returning();
+    return rows[0]!;
+  }
+
+  async createLineItems(
+    data: OrderLineItemInsert[],
+    ctx?: TxContext,
+  ): Promise<OrderLineItem[]> {
+    if (data.length === 0) return [];
+    const db = this.getDb(ctx);
+    return db.insert(orderLineItems).values(data).returning();
+  }
+
+  async updateLineItem(
+    id: string,
+    data: Partial<Omit<OrderLineItemInsert, "id">>,
+    ctx?: TxContext,
+  ): Promise<OrderLineItem | undefined> {
+    const db = this.getDb(ctx);
+    const rows = await db
+      .update(orderLineItems)
+      .set(data)
+      .where(eq(orderLineItems.id, id))
+      .returning();
+    return rows[0];
+  }
+
+  async deleteLineItem(id: string, ctx?: TxContext): Promise<boolean> {
+    const db = this.getDb(ctx);
+    const result = await db
+      .delete(orderLineItems)
+      .where(eq(orderLineItems.id, id))
+      .returning();
+    return result.length > 0;
+  }
+
+  async deleteLineItemsByOrderId(
+    orderId: string,
+    ctx?: TxContext,
+  ): Promise<void> {
+    const db = this.getDb(ctx);
+    await db.delete(orderLineItems).where(eq(orderLineItems.orderId, orderId));
+  }
+
+  // ─────────────────────────────────────────────────────────────────────────────
+  // Order Status History
+  // ─────────────────────────────────────────────────────────────────────────────
+
+  async findStatusHistoryByOrderId(
+    orderId: string,
+    ctx?: TxContext,
+  ): Promise<OrderStatusHistory[]> {
+    const db = this.getDb(ctx);
+    return db
+      .select()
+      .from(orderStatusHistory)
+      .where(eq(orderStatusHistory.orderId, orderId))
+      .orderBy(desc(orderStatusHistory.changedAt));
+  }
+
+  async createStatusHistory(
+    data: OrderStatusHistoryInsert,
+    ctx?: TxContext,
+  ): Promise<OrderStatusHistory> {
+    const db = this.getDb(ctx);
+    const rows = await db.insert(orderStatusHistory).values(data).returning();
+    return rows[0]!;
+  }
+
+  // ─────────────────────────────────────────────────────────────────────────────
+  // Order with Line Items (Aggregate)
+  // ─────────────────────────────────────────────────────────────────────────────
+
+  async findWithLineItems(
+    orgId: string,
+    id: string,
+    ctx?: TxContext,
+  ): Promise<{ order: Order; lineItems: OrderLineItem[] } | undefined> {
+    const order = await this.findById(orgId, id, ctx);
+    if (!order) return undefined;
+    const lineItems = await this.findLineItemsByOrderId(id, ctx);
+    return { order, lineItems };
+  }
+
+  // ─────────────────────────────────────────────────────────────────────────────
+  // Order Number Generation
+  // ─────────────────────────────────────────────────────────────────────────────
+
+  async getNextOrderNumber(ctx?: TxContext): Promise<string> {
+    const year = new Date().getFullYear();
+    const db = this.getDb(ctx);
+
+    // Count orders from this year to generate sequential number
+    const result = await db
+      .select({ count: sql<number>`count(*)::int` })
+      .from(orders)
+      .where(sql`EXTRACT(YEAR FROM ${orders.placedAt}) = ${year}`);
+
+    const count = result[0]?.count ?? 0;
+    const sequence = count + 1;
+    return `ORD-${year}-${String(sequence).padStart(6, "0")}`;
+  }
+}

package/src/modules/orders/schema.ts

@@ -0,0 +1,66 @@
+import { index, integer, jsonb, pgTable, text, timestamp, uniqueIndex, uuid } from "drizzle-orm/pg-core";
+import { organization } from "../../auth/auth-schema.js";
+import { sellableEntities, variants } from "../catalog/schema.js";
+
+export const orders = pgTable("orders", {
+  id: uuid("id").defaultRandom().primaryKey(),
+  organizationId: text("organization_id").notNull().references(() => organization.id, { onDelete: "cascade" }),
+  orderNumber: text("order_number").notNull(),
+  customerId: uuid("customer_id"),
+  status: text("status").notNull().default("pending"),
+  currency: text("currency").notNull(),
+  subtotal: integer("subtotal").notNull(),
+  taxTotal: integer("tax_total").notNull(),
+  shippingTotal: integer("shipping_total").notNull(),
+  discountTotal: integer("discount_total").notNull().default(0),
+  grandTotal: integer("grand_total").notNull(),
+  paymentIntentId: text("payment_intent_id"),
+  paymentMethodId: text("payment_method_id"),
+  metadata: jsonb("metadata").$type<Record<string, unknown>>().default({}),
+  placedAt: timestamp("placed_at", { withTimezone: true }).defaultNow().notNull(),
+  fulfilledAt: timestamp("fulfilled_at", { withTimezone: true }),
+  cancelledAt: timestamp("cancelled_at", { withTimezone: true }),
+}, (table) => ({
+  orgIdx: index("idx_orders_org").on(table.organizationId),
+  orgOrderNumberUnique: uniqueIndex("orders_org_order_number_unique").on(table.organizationId, table.orderNumber),
+  statusIdx: index("idx_orders_status").on(table.status),
+  customerIdIdx: index("idx_orders_customer_id").on(table.customerId),
+  placedAtIdx: index("idx_orders_placed_at").on(table.placedAt),
+  paymentIntentIdx: index("idx_orders_payment_intent").on(table.paymentIntentId),
+}));
+
+export const orderLineItems = pgTable("order_line_items", {
+  id: uuid("id").defaultRandom().primaryKey(),
+  orderId: uuid("order_id")
+    .references(() => orders.id, { onDelete: "cascade" })
+    .notNull(),
+  entityId: uuid("entity_id").references(() => sellableEntities.id).notNull(),
+  entityType: text("entity_type").notNull(),
+  variantId: uuid("variant_id").references(() => variants.id),
+  sku: text("sku"),
+  title: text("title").notNull(),
+  quantity: integer("quantity").notNull(),
+  unitPrice: integer("unit_price").notNull(),
+  totalPrice: integer("total_price").notNull(),
+  taxAmount: integer("tax_amount").notNull().default(0),
+  discountAmount: integer("discount_amount").notNull().default(0),
+  fulfillmentStatus: text("fulfillment_status").notNull().default("unfulfilled"),
+  metadata: jsonb("metadata").$type<Record<string, unknown>>().default({}),
+}, (table) => [
+  index("idx_order_line_items_order_id").on(table.orderId),
+  index("idx_order_line_items_entity_id").on(table.entityId),
+]);
+
+export const orderStatusHistory = pgTable("order_status_history", {
+  id: uuid("id").defaultRandom().primaryKey(),
+  orderId: uuid("order_id")
+    .references(() => orders.id, { onDelete: "cascade" })
+    .notNull(),
+  fromStatus: text("from_status").notNull(),
+  toStatus: text("to_status").notNull(),
+  reason: text("reason"),
+  changedBy: text("changed_by").notNull(),
+  changedAt: timestamp("changed_at", { withTimezone: true }).defaultNow().notNull(),
+}, (table) => [
+  index("idx_order_status_history_order_id").on(table.orderId),
+]);