@unifiedcommerce/core 0.1.0 → 0.2.0

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

@@ -1,426 +0,0 @@
-import { eq, desc, and, sql } from "drizzle-orm";
-import type { TxContext } from "../../../kernel/database/tx-context.js";
-import type {
-  DrizzleDatabase,
-  DbOrTx,
-} from "../../../kernel/database/drizzle-db.js";
-import {
-  fulfillmentRecords,
-  fulfillmentLineItems,
-  fulfillmentEvents,
-} from "../schema.js";
-
-// Infer types from Drizzle schema
-export type FulfillmentRecord = typeof fulfillmentRecords.$inferSelect;
-export type FulfillmentRecordInsert = typeof fulfillmentRecords.$inferInsert;
-export type FulfillmentLineItem = typeof fulfillmentLineItems.$inferSelect;
-export type FulfillmentLineItemInsert =
-  typeof fulfillmentLineItems.$inferInsert;
-export type FulfillmentEvent = typeof fulfillmentEvents.$inferSelect;
-export type FulfillmentEventInsert = typeof fulfillmentEvents.$inferInsert;
-
-/**
- * FulfillmentRepository provides type-safe database operations for fulfillments.
- *
- * This repository manages fulfillment records, line item associations, and events.
- * Supports physical shipments, digital deliveries, and access grants.
- * All methods support an optional TxContext parameter for transaction participation.
- */
-export class FulfillmentRepository {
-  constructor(private readonly db: DrizzleDatabase) {}
-
-  private getDb(ctx?: TxContext): DbOrTx {
-    return (ctx?.tx as DbOrTx | undefined) ?? this.db;
-  }
-
-  // ─────────────────────────────────────────────────────────────────────────────
-  // Fulfillment Records
-  // ─────────────────────────────────────────────────────────────────────────────
-
-  async findById(
-    id: string,
-    ctx?: TxContext,
-  ): Promise<FulfillmentRecord | undefined> {
-    const db = this.getDb(ctx);
-    const rows = await db
-      .select()
-      .from(fulfillmentRecords)
-      .where(eq(fulfillmentRecords.id, id));
-    return rows[0];
-  }
-
-  async findByOrderId(
-    orderId: string,
-    ctx?: TxContext,
-  ): Promise<FulfillmentRecord[]> {
-    const db = this.getDb(ctx);
-    return db
-      .select()
-      .from(fulfillmentRecords)
-      .where(eq(fulfillmentRecords.orderId, orderId))
-      .orderBy(desc(fulfillmentRecords.createdAt));
-  }
-
-  async findByCustomerId(
-    customerId: string,
-    ctx?: TxContext,
-  ): Promise<FulfillmentRecord[]> {
-    const db = this.getDb(ctx);
-    return db
-      .select()
-      .from(fulfillmentRecords)
-      .where(eq(fulfillmentRecords.customerId, customerId))
-      .orderBy(desc(fulfillmentRecords.createdAt));
-  }
-
-  async findByStatus(
-    status: string,
-    ctx?: TxContext,
-  ): Promise<FulfillmentRecord[]> {
-    const db = this.getDb(ctx);
-    return db
-      .select()
-      .from(fulfillmentRecords)
-      .where(eq(fulfillmentRecords.status, status))
-      .orderBy(desc(fulfillmentRecords.createdAt));
-  }
-
-  async findByType(
-    type: string,
-    ctx?: TxContext,
-  ): Promise<FulfillmentRecord[]> {
-    const db = this.getDb(ctx);
-    return db
-      .select()
-      .from(fulfillmentRecords)
-      .where(eq(fulfillmentRecords.type, type))
-      .orderBy(desc(fulfillmentRecords.createdAt));
-  }
-
-  async findByOrderIdAndStatus(
-    orderId: string,
-    status: string,
-    ctx?: TxContext,
-  ): Promise<FulfillmentRecord[]> {
-    const db = this.getDb(ctx);
-    return db
-      .select()
-      .from(fulfillmentRecords)
-      .where(
-        and(
-          eq(fulfillmentRecords.orderId, orderId),
-          eq(fulfillmentRecords.status, status),
-        ),
-      )
-      .orderBy(desc(fulfillmentRecords.createdAt));
-  }
-
-  async findActiveAccessGrants(
-    customerId: string,
-    ctx?: TxContext,
-  ): Promise<FulfillmentRecord[]> {
-    const db = this.getDb(ctx);
-    return db
-      .select()
-      .from(fulfillmentRecords)
-      .where(
-        and(
-          eq(fulfillmentRecords.customerId, customerId),
-          eq(fulfillmentRecords.type, "access_grant"),
-          eq(fulfillmentRecords.isActive, true),
-        ),
-      )
-      .orderBy(desc(fulfillmentRecords.grantedAt));
-  }
-
-  async findAll(
-    options?: { limit?: number; offset?: number },
-    ctx?: TxContext,
-  ): Promise<FulfillmentRecord[]> {
-    const db = this.getDb(ctx);
-    let query = db
-      .select()
-      .from(fulfillmentRecords)
-      .orderBy(desc(fulfillmentRecords.createdAt))
-      .$dynamic();
-
-    if (options?.limit !== undefined) {
-      query = query.limit(options.limit);
-    }
-    if (options?.offset !== undefined) {
-      query = query.offset(options.offset);
-    }
-    return query;
-  }
-
-  async create(
-    data: FulfillmentRecordInsert,
-    ctx?: TxContext,
-  ): Promise<FulfillmentRecord> {
-    const db = this.getDb(ctx);
-    const rows = await db.insert(fulfillmentRecords).values(data).returning();
-    return rows[0]!;
-  }
-
-  async update(
-    id: string,
-    data: Partial<Omit<FulfillmentRecordInsert, "id">>,
-    ctx?: TxContext,
-  ): Promise<FulfillmentRecord | undefined> {
-    const db = this.getDb(ctx);
-    const rows = await db
-      .update(fulfillmentRecords)
-      .set({ ...data, updatedAt: new Date() })
-      .where(eq(fulfillmentRecords.id, id))
-      .returning();
-    return rows[0];
-  }
-
-  async updateStatus(
-    id: string,
-    status: string,
-    ctx?: TxContext,
-  ): Promise<FulfillmentRecord | undefined> {
-    const data: Partial<FulfillmentRecordInsert> = { status };
-
-    // Set timestamps based on status
-    if (status === "shipped") {
-      data.shippedAt = new Date();
-    } else if (status === "delivered") {
-      data.deliveredAt = new Date();
-    }
-
-    return this.update(id, data, ctx);
-  }
-
-  async delete(id: string, ctx?: TxContext): Promise<boolean> {
-    const db = this.getDb(ctx);
-    const result = await db
-      .delete(fulfillmentRecords)
-      .where(eq(fulfillmentRecords.id, id))
-      .returning();
-    return result.length > 0;
-  }
-
-  // ─────────────────────────────────────────────────────────────────────────────
-  // Digital Delivery Operations
-  // ─────────────────────────────────────────────────────────────────────────────
-
-  async incrementDownloadCount(
-    id: string,
-    ctx?: TxContext,
-  ): Promise<FulfillmentRecord | undefined> {
-    const db = this.getDb(ctx);
-    const rows = await db
-      .update(fulfillmentRecords)
-      .set({
-        downloadCount: sql`${fulfillmentRecords.downloadCount} + 1`,
-        updatedAt: new Date(),
-      })
-      .where(eq(fulfillmentRecords.id, id))
-      .returning();
-    return rows[0];
-  }
-
-  async isDownloadAllowed(id: string, ctx?: TxContext): Promise<boolean> {
-    const fulfillment = await this.findById(id, ctx);
-    if (!fulfillment || fulfillment.type !== "digital") return false;
-
-    // Check expiration
-    if (
-      fulfillment.downloadExpiresAt &&
-      new Date() > fulfillment.downloadExpiresAt
-    ) {
-      return false;
-    }
-
-    // Check download limit
-    if (
-      fulfillment.maxDownloads !== null &&
-      fulfillment.downloadCount >= fulfillment.maxDownloads
-    ) {
-      return false;
-    }
-
-    return true;
-  }
-
-  // ─────────────────────────────────────────────────────────────────────────────
-  // Access Grant Operations
-  // ─────────────────────────────────────────────────────────────────────────────
-
-  async deactivateAccessGrant(
-    id: string,
-    ctx?: TxContext,
-  ): Promise<FulfillmentRecord | undefined> {
-    return this.update(id, { isActive: false }, ctx);
-  }
-
-  async activateAccessGrant(
-    id: string,
-    ctx?: TxContext,
-  ): Promise<FulfillmentRecord | undefined> {
-    return this.update(id, { isActive: true, grantedAt: new Date() }, ctx);
-  }
-
-  async isAccessGrantActive(id: string, ctx?: TxContext): Promise<boolean> {
-    const fulfillment = await this.findById(id, ctx);
-    if (!fulfillment || fulfillment.type !== "access_grant") return false;
-
-    if (!fulfillment.isActive) return false;
-
-    // Check expiration
-    if (fulfillment.expiresAt && new Date() > fulfillment.expiresAt) {
-      return false;
-    }
-
-    return true;
-  }
-
-  // ─────────────────────────────────────────────────────────────────────────────
-  // Fulfillment Line Items
-  // ─────────────────────────────────────────────────────────────────────────────
-
-  async findLineItemsByFulfillmentId(
-    fulfillmentId: string,
-    ctx?: TxContext,
-  ): Promise<FulfillmentLineItem[]> {
-    const db = this.getDb(ctx);
-    return db
-      .select()
-      .from(fulfillmentLineItems)
-      .where(eq(fulfillmentLineItems.fulfillmentId, fulfillmentId));
-  }
-
-  async findLineItemsByOrderLineItemId(
-    orderLineItemId: string,
-    ctx?: TxContext,
-  ): Promise<FulfillmentLineItem[]> {
-    const db = this.getDb(ctx);
-    return db
-      .select()
-      .from(fulfillmentLineItems)
-      .where(eq(fulfillmentLineItems.orderLineItemId, orderLineItemId));
-  }
-
-  async createLineItem(
-    data: FulfillmentLineItemInsert,
-    ctx?: TxContext,
-  ): Promise<FulfillmentLineItem> {
-    const db = this.getDb(ctx);
-    const rows = await db.insert(fulfillmentLineItems).values(data).returning();
-    return rows[0]!;
-  }
-
-  async createLineItems(
-    data: FulfillmentLineItemInsert[],
-    ctx?: TxContext,
-  ): Promise<FulfillmentLineItem[]> {
-    if (data.length === 0) return [];
-    const db = this.getDb(ctx);
-    return db.insert(fulfillmentLineItems).values(data).returning();
-  }
-
-  async deleteLineItemsByFulfillmentId(
-    fulfillmentId: string,
-    ctx?: TxContext,
-  ): Promise<void> {
-    const db = this.getDb(ctx);
-    await db
-      .delete(fulfillmentLineItems)
-      .where(eq(fulfillmentLineItems.fulfillmentId, fulfillmentId));
-  }
-
-  // ─────────────────────────────────────────────────────────────────────────────
-  // Fulfillment Events
-  // ─────────────────────────────────────────────────────────────────────────────
-
-  async findEventsByFulfillmentId(
-    fulfillmentId: string,
-    ctx?: TxContext,
-  ): Promise<FulfillmentEvent[]> {
-    const db = this.getDb(ctx);
-    return db
-      .select()
-      .from(fulfillmentEvents)
-      .where(eq(fulfillmentEvents.fulfillmentId, fulfillmentId))
-      .orderBy(desc(fulfillmentEvents.occurredAt));
-  }
-
-  async createEvent(
-    data: FulfillmentEventInsert,
-    ctx?: TxContext,
-  ): Promise<FulfillmentEvent> {
-    const db = this.getDb(ctx);
-    const rows = await db.insert(fulfillmentEvents).values(data).returning();
-    return rows[0]!;
-  }
-
-  async recordStatusChange(
-    fulfillmentId: string,
-    fromStatus: string,
-    toStatus: string,
-    actorId?: string,
-    description?: string,
-    ctx?: TxContext,
-  ): Promise<FulfillmentEvent> {
-    return this.createEvent(
-      {
-        fulfillmentId,
-        eventType: "status_change",
-        fromStatus,
-        toStatus,
-        actorId,
-        description,
-      },
-      ctx,
-    );
-  }
-
-  // ─────────────────────────────────────────────────────────────────────────────
-  // Aggregate Operations
-  // ─────────────────────────────────────────────────────────────────────────────
-
-  async findWithLineItems(
-    id: string,
-    ctx?: TxContext,
-  ): Promise<
-    | { fulfillment: FulfillmentRecord; lineItems: FulfillmentLineItem[] }
-    | undefined
-  > {
-    const fulfillment = await this.findById(id, ctx);
-    if (!fulfillment) return undefined;
-    const lineItems = await this.findLineItemsByFulfillmentId(id, ctx);
-    return { fulfillment, lineItems };
-  }
-
-  async findWithEvents(
-    id: string,
-    ctx?: TxContext,
-  ): Promise<
-    { fulfillment: FulfillmentRecord; events: FulfillmentEvent[] } | undefined
-  > {
-    const fulfillment = await this.findById(id, ctx);
-    if (!fulfillment) return undefined;
-    const events = await this.findEventsByFulfillmentId(id, ctx);
-    return { fulfillment, events };
-  }
-
-  /**
-   * Get fulfilled quantity for an order line item.
-   * Sums all fulfillment line items linked to the order line item.
-   */
-  async getFulfilledQuantity(
-    orderLineItemId: string,
-    ctx?: TxContext,
-  ): Promise<number> {
-    const db = this.getDb(ctx);
-    const result = await db
-      .select({
-        total: sql<number>`COALESCE(SUM(${fulfillmentLineItems.quantity}), 0)::int`,
-      })
-      .from(fulfillmentLineItems)
-      .where(eq(fulfillmentLineItems.orderLineItemId, orderLineItemId));
-    return result[0]?.total ?? 0;
-  }
-}

package/src/modules/fulfillment/schema.ts

@@ -1,101 +0,0 @@
-import {
-  integer,
-  jsonb,
-  pgTable,
-  text,
-  timestamp,
-  uuid,
-  boolean,
-} from "drizzle-orm/pg-core";
-import { orders, orderLineItems } from "../orders/schema.js";
-import { customers } from "../customers/schema.js";
-
-/**
- * Fulfillment Records Table
- *
- * Tracks physical shipments, digital deliveries, and access grants.
- * Each fulfillment can be associated with one or more order line items.
- */
-export const fulfillmentRecords = pgTable("fulfillment_records", {
-  id: uuid("id").defaultRandom().primaryKey(),
-  orderId: uuid("order_id")
-    .references(() => orders.id, { onDelete: "cascade" })
-    .notNull(),
-  customerId: uuid("customer_id").references(() => customers.id),
-
-  // Fulfillment type: "physical", "digital", "access_grant"
-  type: text("type").notNull(),
-
-  // Status: "pending", "processing", "shipped", "delivered", "cancelled", "failed"
-  status: text("status").notNull().default("pending"),
-
-  // Physical shipment fields
-  carrier: text("carrier"),
-  trackingNumber: text("tracking_number"),
-  trackingUrl: text("tracking_url"),
-  estimatedDelivery: timestamp("estimated_delivery", { withTimezone: true }),
-  shippedAt: timestamp("shipped_at", { withTimezone: true }),
-  deliveredAt: timestamp("delivered_at", { withTimezone: true }),
-
-  // Digital delivery fields
-  downloadUrl: text("download_url"),
-  downloadExpiresAt: timestamp("download_expires_at", { withTimezone: true }),
-  maxDownloads: integer("max_downloads"),
-  downloadCount: integer("download_count").notNull().default(0),
-
-  // Access grant fields (e.g., course access, membership)
-  entityType: text("entity_type"),
-  entityId: uuid("entity_id"),
-  grantedAt: timestamp("granted_at", { withTimezone: true }),
-  expiresAt: timestamp("expires_at", { withTimezone: true }),
-  isActive: boolean("is_active").notNull().default(true),
-
-  // Metadata for extensibility
-  metadata: jsonb("metadata").$type<Record<string, unknown>>().default({}),
-
-  // Timestamps
-  createdAt: timestamp("created_at", { withTimezone: true })
-    .defaultNow()
-    .notNull(),
-  updatedAt: timestamp("updated_at", { withTimezone: true })
-    .defaultNow()
-    .notNull(),
-});
-
-/**
- * Fulfillment Line Items Junction Table
- *
- * Links fulfillment records to order line items (many-to-many).
- * Allows partial fulfillments where only some items from an order are fulfilled together.
- */
-export const fulfillmentLineItems = pgTable("fulfillment_line_items", {
-  id: uuid("id").defaultRandom().primaryKey(),
-  fulfillmentId: uuid("fulfillment_id")
-    .references(() => fulfillmentRecords.id, { onDelete: "cascade" })
-    .notNull(),
-  orderLineItemId: uuid("order_line_item_id")
-    .references(() => orderLineItems.id, { onDelete: "cascade" })
-    .notNull(),
-  quantity: integer("quantity").notNull(),
-});
-
-/**
- * Fulfillment Events Table
- *
- * Audit trail of fulfillment status changes and events.
- */
-export const fulfillmentEvents = pgTable("fulfillment_events", {
-  id: uuid("id").defaultRandom().primaryKey(),
-  fulfillmentId: uuid("fulfillment_id")
-    .references(() => fulfillmentRecords.id, { onDelete: "cascade" })
-    .notNull(),
-  eventType: text("event_type").notNull(), // "created", "shipped", "delivered", "cancelled", "download", etc.
-  fromStatus: text("from_status"),
-  toStatus: text("to_status"),
-  description: text("description"),
-  actorId: text("actor_id"), // User/system that triggered the event
-  metadata: jsonb("metadata").$type<Record<string, unknown>>().default({}),
-  occurredAt: timestamp("occurred_at", { withTimezone: true })
-    .defaultNow()
-    .notNull(),
-});