@unifiedcommerce/core 0.0.1

package/dist/modules/fulfillment/schema.js

@@ -0,0 +1,83 @@
+import { integer, jsonb, pgTable, text, timestamp, uuid, boolean, } from "drizzle-orm/pg-core";
+import { orders, orderLineItems } from "../orders/schema";
+import { customers } from "../customers/schema";
+/**
+ * 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().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().default({}),
+    occurredAt: timestamp("occurred_at", { withTimezone: true })
+        .defaultNow()
+        .notNull(),
+});

package/dist/modules/fulfillment/service.d.ts

@@ -0,0 +1,58 @@
+import type { Actor } from "../../auth/types";
+import { type Result } from "../../kernel/result";
+import type { TxContext } from "../../kernel/database/tx-context";
+import type { FulfillmentRepository } from "./repository";
+import type { OrdersRepository } from "../orders/repository";
+import type { FulfillmentRecord } from "./types";
+interface InventoryServiceLike {
+    adjust(input: {
+        entityId: string;
+        variantId?: string;
+        warehouseId?: string;
+        adjustment: number;
+        reason: string;
+        referenceType?: string;
+        referenceId?: string;
+    }, actor?: unknown): Promise<unknown>;
+    release(input: {
+        entityId: string;
+        variantId?: string;
+        quantity: number;
+        orderId: string;
+        performedBy?: string;
+    }): Promise<unknown>;
+}
+interface FulfillmentServiceDeps {
+    repository: FulfillmentRepository;
+    ordersRepository: OrdersRepository;
+    inventoryService?: InventoryServiceLike;
+}
+export declare class FulfillmentService {
+    private deps;
+    private strategies;
+    constructor(deps: FulfillmentServiceDeps);
+    fulfillOrder(orderId: string, actor?: Actor | null, ctx?: TxContext): Promise<Result<void>>;
+    getByOrderId(orderId: string, ctx?: TxContext): Promise<Result<FulfillmentRecord[]>>;
+    updateTracking(input: {
+        fulfillmentId: string;
+        carrier?: string;
+        trackingNumber?: string;
+        trackingUrl?: string;
+        status?: string;
+    }, ctx?: TxContext): Promise<Result<void>>;
+    getDownloadUrl(orderId: string, lineItemId: string, userId: string, actor?: Actor | null, ctx?: TxContext): Promise<Result<{
+        url: string;
+        remaining: number;
+        expiresAt: string;
+    }>>;
+    getDigitalAccess(userId: string, type?: string, ctx?: TxContext): Promise<Result<Array<{
+        entityId: string;
+        title: string;
+        grantedAt: string;
+        expiresAt: string | null;
+        isActive: boolean;
+        orderId: string;
+    }>>>;
+}
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/modules/fulfillment/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/modules/fulfillment/service.ts"],"names":[],"mappings":"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"}

package/dist/modules/fulfillment/service.js

@@ -0,0 +1,338 @@
+import { createHmac } from "node:crypto";
+import { resolveOrgId } from "../../auth/org";
+import { CommerceNotFoundError } from "../../kernel/errors";
+import { Err, Ok } from "../../kernel/result";
+import { makeId } from "../../utils/id";
+function toFulfillmentLineItem(lineItem) {
+    return {
+        id: lineItem.id,
+        title: lineItem.title,
+        quantity: lineItem.quantity,
+        ...(lineItem.sku != null ? { sku: lineItem.sku } : {}),
+    };
+}
+class PhysicalFulfillmentStrategy {
+    type = "physical";
+    async canFulfill(_lineItem, _context) {
+        return Ok(true);
+    }
+    async fulfill(lineItem, _context) {
+        return Ok({
+            id: makeId(),
+            orderId: lineItem.orderId,
+            type: this.type,
+            status: "pending",
+            lineItems: [toFulfillmentLineItem(lineItem)],
+        });
+    }
+    async reverse(_fulfillmentId, _context) {
+        return Ok(undefined);
+    }
+}
+class DigitalDownloadFulfillmentStrategy {
+    type = "digital-download";
+    async canFulfill(_lineItem, _context) {
+        return Ok(true);
+    }
+    async fulfill(lineItem, _context) {
+        const expiresAt = new Date(Date.now() + 1000 * 60 * 60 * 24).toISOString();
+        return Ok({
+            id: makeId(),
+            orderId: lineItem.orderId,
+            type: this.type,
+            status: "fulfilled",
+            downloadUrl: `https://downloads.local/${lineItem.id}?token=${createHmac("sha256", "download").update(lineItem.id).digest("hex")}`,
+            downloadExpiresAt: expiresAt,
+            maxDownloads: 5,
+            downloadCount: 0,
+            lineItems: [toFulfillmentLineItem(lineItem)],
+            entityType: "digitalDownload",
+            entityId: lineItem.entityId,
+            ...(lineItem.customerId !== undefined
+                ? { customerId: lineItem.customerId }
+                : {}),
+        });
+    }
+    async reverse(_fulfillmentId, _context) {
+        return Ok(undefined);
+    }
+}
+class DigitalAccessFulfillmentStrategy {
+    type = "digital-access";
+    async canFulfill(_lineItem, _context) {
+        return Ok(true);
+    }
+    async fulfill(lineItem, _context) {
+        return Ok({
+            id: makeId(),
+            orderId: lineItem.orderId,
+            type: this.type,
+            status: "fulfilled",
+            lineItems: [toFulfillmentLineItem(lineItem)],
+            entityType: "course",
+            entityId: lineItem.entityId,
+            ...(lineItem.customerId !== undefined
+                ? { customerId: lineItem.customerId }
+                : {}),
+            isActive: true,
+            grantedAt: new Date().toISOString(),
+        });
+    }
+    async reverse(_fulfillmentId, _context) {
+        return Ok(undefined);
+    }
+}
+class InternalTransferFulfillmentStrategy {
+    type = "internal-transfer";
+    async canFulfill(_lineItem, _context) {
+        return Ok(true);
+    }
+    async fulfill(lineItem, _context) {
+        return Ok({
+            id: makeId(),
+            orderId: lineItem.orderId,
+            type: this.type,
+            status: "processing",
+            lineItems: [toFulfillmentLineItem(lineItem)],
+        });
+    }
+    async reverse(_fulfillmentId, _context) {
+        return Ok(undefined);
+    }
+}
+class AppointmentFulfillmentStrategy {
+    type = "appointment";
+    async canFulfill(_lineItem, _context) {
+        return Ok(true);
+    }
+    async fulfill(lineItem, _context) {
+        return Ok({
+            id: makeId(),
+            orderId: lineItem.orderId,
+            type: this.type,
+            status: "pending",
+            lineItems: [toFulfillmentLineItem(lineItem)],
+        });
+    }
+    async reverse(_fulfillmentId, _context) {
+        return Ok(undefined);
+    }
+}
+export class FulfillmentService {
+    deps;
+    strategies = new Map();
+    constructor(deps) {
+        this.deps = deps;
+        this.strategies.set("physical", new PhysicalFulfillmentStrategy());
+        this.strategies.set("digital-download", new DigitalDownloadFulfillmentStrategy());
+        this.strategies.set("digital-access", new DigitalAccessFulfillmentStrategy());
+        this.strategies.set("internal-transfer", new InternalTransferFulfillmentStrategy());
+        this.strategies.set("appointment", new AppointmentFulfillmentStrategy());
+    }
+    async fulfillOrder(orderId, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const order = await this.deps.ordersRepository.findById(orgId, orderId, ctx);
+        if (!order)
+            return Err(new CommerceNotFoundError("Order not found."));
+        const lineItems = await this.deps.ordersRepository.findLineItemsByOrderId(orderId, ctx);
+        for (const lineItem of lineItems) {
+            const strategyId = lineItem.entityType === "digitalDownload"
+                ? "digital-download"
+                : lineItem.entityType === "course"
+                    ? "digital-access"
+                    : lineItem.entityType === "internalAsset"
+                        ? "internal-transfer"
+                        : "physical";
+            const strategy = this.strategies.get(strategyId);
+            const result = await strategy.fulfill({
+                ...lineItem,
+                orderId,
+                ...(order.customerId != null ? { customerId: order.customerId } : {}),
+            }, {});
+            if (!result.ok)
+                return result;
+            const record = result.value;
+            // Persist the fulfillment record via repository
+            const created = await this.deps.repository.create({
+                id: record.id,
+                orderId: record.orderId,
+                type: record.type,
+                status: record.status,
+                carrier: record.carrier ?? null,
+                trackingNumber: record.trackingNumber ?? null,
+                trackingUrl: record.trackingUrl ?? null,
+                downloadUrl: record.downloadUrl ?? null,
+                downloadExpiresAt: record.downloadExpiresAt
+                    ? new Date(record.downloadExpiresAt)
+                    : null,
+                maxDownloads: record.maxDownloads ?? null,
+                downloadCount: record.downloadCount ?? 0,
+                entityType: record.entityType ?? null,
+                entityId: record.entityId ?? null,
+                grantedAt: record.grantedAt ? new Date(record.grantedAt) : null,
+                expiresAt: record.expiresAt ? new Date(record.expiresAt) : null,
+                isActive: record.isActive ?? true,
+                customerId: record.customerId ?? null,
+            }, ctx);
+            // Create a fulfillment line item linking this fulfillment to the order line item
+            for (const li of record.lineItems) {
+                await this.deps.repository.createLineItem({
+                    fulfillmentId: created.id,
+                    orderLineItemId: li.id,
+                    quantity: li.quantity,
+                }, ctx);
+            }
+        }
+        return Ok(undefined);
+    }
+    async getByOrderId(orderId, ctx) {
+        const dbRecords = await this.deps.repository.findByOrderId(orderId, ctx);
+        // Hydrate each record with its associated line items
+        const records = [];
+        for (const dbRecord of dbRecords) {
+            const fulfillmentLineItems = await this.deps.repository.findLineItemsByFulfillmentId(dbRecord.id, ctx);
+            records.push(toServiceRecord(dbRecord, fulfillmentLineItems));
+        }
+        return Ok(records);
+    }
+    async updateTracking(input, ctx) {
+        const existing = await this.deps.repository.findById(input.fulfillmentId, ctx);
+        if (!existing) {
+            return Err(new CommerceNotFoundError("Fulfillment record not found."));
+        }
+        const updateData = {};
+        if (input.carrier !== undefined)
+            updateData.carrier = input.carrier;
+        if (input.trackingNumber !== undefined)
+            updateData.trackingNumber = input.trackingNumber;
+        if (input.trackingUrl !== undefined)
+            updateData.trackingUrl = input.trackingUrl;
+        if (input.status !== undefined)
+            updateData.status = input.status;
+        if (input.status === "shipped")
+            updateData.shippedAt = new Date();
+        if (input.status === "delivered")
+            updateData.deliveredAt = new Date();
+        await this.deps.repository.update(input.fulfillmentId, updateData, ctx);
+        return Ok(undefined);
+    }
+    async getDownloadUrl(orderId, lineItemId, userId, actor, ctx) {
+        const dbRecords = await this.deps.repository.findByOrderId(orderId, ctx);
+        let matchedRecord;
+        for (const dbRecord of dbRecords) {
+            if (dbRecord.type !== "digital-download" && dbRecord.type !== "digital")
+                continue;
+            const fliItems = await this.deps.repository.findLineItemsByFulfillmentId(dbRecord.id, ctx);
+            if (fliItems.some((item) => item.orderLineItemId === lineItemId)) {
+                matchedRecord = dbRecord;
+                break;
+            }
+        }
+        if (!matchedRecord) {
+            return Err(new CommerceNotFoundError("Digital download not found."));
+        }
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const order = await this.deps.ordersRepository.findById(orgId, orderId, ctx);
+        if (!order || order.customerId !== userId) {
+            return Err(new CommerceNotFoundError("Order not found."));
+        }
+        if (!matchedRecord.downloadExpiresAt || !matchedRecord.downloadUrl) {
+            return Err(new CommerceNotFoundError("Download metadata missing."));
+        }
+        if (new Date(matchedRecord.downloadExpiresAt).getTime() < Date.now()) {
+            return Err(new CommerceNotFoundError("Download link expired."));
+        }
+        const updated = await this.deps.repository.incrementDownloadCount(matchedRecord.id, ctx);
+        const downloadCount = updated?.downloadCount ?? matchedRecord.downloadCount + 1;
+        const remaining = Math.max(0, (matchedRecord.maxDownloads ?? 5) - downloadCount);
+        return Ok({
+            url: matchedRecord.downloadUrl,
+            remaining,
+            expiresAt: matchedRecord.downloadExpiresAt.toISOString(),
+        });
+    }
+    async getDigitalAccess(userId, type = "course", ctx) {
+        const output = [];
+        // Find all fulfillments for this customer
+        const dbRecords = await this.deps.repository.findByCustomerId(userId, ctx);
+        for (const entry of dbRecords) {
+            if (entry.type !== "digital-access" && entry.type !== "access_grant")
+                continue;
+            if (entry.entityType !== type)
+                continue;
+            if (!entry.entityId || !entry.grantedAt)
+                continue;
+            // Get the first fulfillment line item to extract the title
+            const fliItems = await this.deps.repository.findLineItemsByFulfillmentId(entry.id, ctx);
+            let title = "Untitled";
+            if (fliItems.length > 0) {
+                const orderLineItem = await this.deps.ordersRepository.findLineItemById(fliItems[0].orderLineItemId, ctx);
+                if (orderLineItem) {
+                    title = orderLineItem.title;
+                }
+            }
+            output.push({
+                entityId: entry.entityId,
+                title,
+                grantedAt: entry.grantedAt.toISOString(),
+                expiresAt: entry.expiresAt?.toISOString() ?? null,
+                isActive: entry.isActive,
+                orderId: entry.orderId,
+            });
+        }
+        return Ok(output);
+    }
+}
+/**
+ * Maps a Drizzle FulfillmentRecord + its fulfillment line items back to
+ * the service-layer FulfillmentRecord shape used by callers.
+ */
+function toServiceRecord(dbRecord, fulfillmentLineItems) {
+    return {
+        id: dbRecord.id,
+        orderId: dbRecord.orderId,
+        type: dbRecord.type,
+        status: dbRecord.status,
+        lineItems: fulfillmentLineItems.map((fli) => ({
+            id: fli.orderLineItemId,
+            title: "", // Title is on the order line item; callers should join if needed
+            quantity: fli.quantity,
+        })),
+        ...(dbRecord.carrier != null ? { carrier: dbRecord.carrier } : {}),
+        ...(dbRecord.trackingNumber != null
+            ? { trackingNumber: dbRecord.trackingNumber }
+            : {}),
+        ...(dbRecord.trackingUrl != null
+            ? { trackingUrl: dbRecord.trackingUrl }
+            : {}),
+        ...(dbRecord.estimatedDelivery != null
+            ? { estimatedDelivery: dbRecord.estimatedDelivery.toISOString() }
+            : {}),
+        ...(dbRecord.shippedAt != null
+            ? { shippedAt: dbRecord.shippedAt.toISOString() }
+            : {}),
+        ...(dbRecord.deliveredAt != null
+            ? { deliveredAt: dbRecord.deliveredAt.toISOString() }
+            : {}),
+        ...(dbRecord.downloadUrl != null
+            ? { downloadUrl: dbRecord.downloadUrl }
+            : {}),
+        ...(dbRecord.downloadExpiresAt != null
+            ? { downloadExpiresAt: dbRecord.downloadExpiresAt.toISOString() }
+            : {}),
+        ...(dbRecord.maxDownloads != null
+            ? { maxDownloads: dbRecord.maxDownloads }
+            : {}),
+        downloadCount: dbRecord.downloadCount,
+        ...(dbRecord.customerId != null ? { customerId: dbRecord.customerId } : {}),
+        ...(dbRecord.entityType != null ? { entityType: dbRecord.entityType } : {}),
+        ...(dbRecord.entityId != null ? { entityId: dbRecord.entityId } : {}),
+        ...(dbRecord.grantedAt != null
+            ? { grantedAt: dbRecord.grantedAt.toISOString() }
+            : {}),
+        ...(dbRecord.expiresAt != null
+            ? { expiresAt: dbRecord.expiresAt.toISOString() }
+            : {}),
+        isActive: dbRecord.isActive,
+    };
+}

package/dist/modules/fulfillment/types.d.ts

@@ -0,0 +1,44 @@
+import type { Result } from "../../kernel/result";
+import type { OrderLineItem } from "../orders/repository";
+export interface FulfillmentRecord {
+    id: string;
+    orderId: string;
+    lineItems: Array<{
+        id: string;
+        title: string;
+        quantity: number;
+        sku?: string;
+    }>;
+    type: string;
+    status: string;
+    carrier?: string;
+    trackingNumber?: string;
+    trackingUrl?: string;
+    estimatedDelivery?: string;
+    shippedAt?: string;
+    deliveredAt?: string;
+    downloadUrl?: string;
+    downloadExpiresAt?: string;
+    maxDownloads?: number;
+    downloadCount?: number;
+    customerId?: string;
+    entityType?: string;
+    entityId?: string;
+    grantedAt?: string;
+    expiresAt?: string;
+    isActive?: boolean;
+}
+export interface FulfillmentStrategyContext {
+    actorId?: string;
+}
+export type FulfillmentLineItem = Pick<OrderLineItem, "id" | "entityId" | "entityType" | "sku" | "title" | "quantity"> & {
+    orderId: string;
+    customerId?: string;
+};
+export interface FulfillmentStrategy {
+    type: string;
+    canFulfill(lineItem: FulfillmentLineItem, context: FulfillmentStrategyContext): Promise<Result<boolean>>;
+    fulfill(lineItem: FulfillmentLineItem, context: FulfillmentStrategyContext): Promise<Result<FulfillmentRecord>>;
+    reverse(fulfillmentId: string, context: FulfillmentStrategyContext): Promise<Result<void>>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/modules/fulfillment/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/modules/fulfillment/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,mBAAmB,GAAG,IAAI,CACpC,aAAa,EACb,IAAI,GAAG,UAAU,GAAG,YAAY,GAAG,KAAK,GAAG,OAAO,GAAG,UAAU,CAChE,GAAG;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CACR,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5B,OAAO,CACL,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACtC,OAAO,CACL,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;CAC1B"}

package/dist/modules/fulfillment/types.js

@@ -0,0 +1 @@
+export {};

package/dist/modules/inventory/repository/in-memory.d.ts

@@ -0,0 +1,51 @@
+import type { TxContext } from "../../../kernel/database/tx-context";
+import type { Warehouse, WarehouseInsert, InventoryLevel, InventoryLevelInsert, InventoryMovement, InventoryMovementInsert } from "./index";
+/**
+ * In-memory implementation of InventoryRepository for testing.
+ * Provides the same interface as the Drizzle-based repository but stores data in memory.
+ */
+export declare class InMemoryInventoryRepository {
+    private warehouses;
+    private levels;
+    private movements;
+    findWarehouseById(id: string, _ctx?: TxContext): Promise<Warehouse | undefined>;
+    findWarehouseByCode(code: string, _ctx?: TxContext): Promise<Warehouse | undefined>;
+    findAllWarehouses(_ctx?: TxContext): Promise<Warehouse[]>;
+    findActiveWarehouses(_ctx?: TxContext): Promise<Warehouse[]>;
+    createWarehouse(data: WarehouseInsert, _ctx?: TxContext): Promise<Warehouse>;
+    updateWarehouse(id: string, data: Partial<Omit<WarehouseInsert, "id">>, _ctx?: TxContext): Promise<Warehouse | undefined>;
+    deleteWarehouse(id: string, _ctx?: TxContext): Promise<boolean>;
+    findAllLevels(_ctx?: TxContext): Promise<InventoryLevel[]>;
+    findLevelById(id: string, _ctx?: TxContext): Promise<InventoryLevel | undefined>;
+    findLevelByKey(entityId: string, warehouseId: string, variantId?: string, _ctx?: TxContext): Promise<InventoryLevel | undefined>;
+    findLevelsByEntityId(entityId: string, _ctx?: TxContext): Promise<InventoryLevel[]>;
+    findLevelsByEntityAndVariant(entityId: string, variantId?: string, _ctx?: TxContext): Promise<InventoryLevel[]>;
+    findLevelsByWarehouseId(warehouseId: string, _ctx?: TxContext): Promise<InventoryLevel[]>;
+    createLevel(data: InventoryLevelInsert, _ctx?: TxContext): Promise<InventoryLevel>;
+    updateLevel(id: string, data: Partial<Omit<InventoryLevelInsert, "id">>, _ctx?: TxContext): Promise<InventoryLevel | undefined>;
+    upsertLevel(entityId: string, warehouseId: string, variantId: string | undefined, data: Omit<InventoryLevelInsert, "id" | "entityId" | "warehouseId" | "variantId">, ctx?: TxContext): Promise<InventoryLevel>;
+    deleteLevel(id: string, _ctx?: TxContext): Promise<boolean>;
+    findMovementById(id: string, _ctx?: TxContext): Promise<InventoryMovement | undefined>;
+    findMovementsByEntityId(entityId: string, _ctx?: TxContext): Promise<InventoryMovement[]>;
+    findMovementsByReference(referenceType: string, referenceId: string, _ctx?: TxContext): Promise<InventoryMovement[]>;
+    createMovement(data: InventoryMovementInsert, _ctx?: TxContext): Promise<InventoryMovement>;
+    findLevelForUpdate(entityId: string, variantId: string | null, warehouseId: string, _ctx: TxContext): Promise<InventoryLevel | undefined>;
+    reserveWithLock(entityId: string, variantId: string | null, warehouseId: string, quantity: number, _ctx: TxContext): Promise<{
+        ok: true;
+        level: InventoryLevel;
+    } | {
+        ok: false;
+        reason: string;
+    }>;
+    releaseWithLock(entityId: string, variantId: string | null, warehouseId: string, quantity: number, _ctx: TxContext): Promise<{
+        ok: true;
+        level: InventoryLevel;
+    } | {
+        ok: false;
+        reason: string;
+    }>;
+    getAvailableQuantity(entityId: string, variantId?: string, _ctx?: TxContext): Promise<number>;
+    getAvailableQuantities(entityIds: string[], _ctx?: TxContext): Promise<Record<string, number>>;
+    getOrCreateDefaultWarehouse(_ctx?: TxContext): Promise<Warehouse>;
+}
+//# sourceMappingURL=in-memory.d.ts.map

package/dist/modules/inventory/repository/in-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../../../src/modules/inventory/repository/in-memory.ts"],"names":[],"mappings":"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"}