@unifiedcommerce/core 0.0.1

package/dist/modules/customers/service.js

@@ -0,0 +1,91 @@
+import { resolveOrgId } from "../../auth/org";
+import { CommerceNotFoundError } from "../../kernel/errors";
+import { Err, Ok } from "../../kernel/result";
+export class CustomerService {
+    deps;
+    repo;
+    constructor(deps) {
+        this.deps = deps;
+        this.repo = deps.repository;
+    }
+    async getOrCreateByUserId(orgId, userId, ctx) {
+        const existing = await this.repo.findByUserId(orgId, userId, ctx);
+        if (existing) {
+            return existing;
+        }
+        const customer = await this.repo.create({
+            organizationId: orgId,
+            userId,
+            metadata: {},
+        }, ctx);
+        return customer;
+    }
+    async getById(id, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const customer = await this.repo.findById(orgId, id, ctx);
+        if (!customer)
+            return Err(new CommerceNotFoundError("Customer not found."));
+        return Ok(customer);
+    }
+    async getByUserId(userId, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const customer = await this.getOrCreateByUserId(orgId, userId, ctx);
+        return Ok(customer);
+    }
+    async updateByUserId(userId, updates, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const customer = await this.getOrCreateByUserId(orgId, userId, ctx);
+        const updated = await this.repo.update(customer.id, updates, ctx);
+        if (!updated) {
+            return Err(new CommerceNotFoundError("Customer not found."));
+        }
+        return Ok(updated);
+    }
+    async getAddresses(userId, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const customer = await this.getOrCreateByUserId(orgId, userId, ctx);
+        const addresses = await this.repo.findAddressesByCustomerId(customer.id, ctx);
+        return Ok(addresses);
+    }
+    async addAddress(userId, input, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const customer = await this.getOrCreateByUserId(orgId, userId, ctx);
+        // If new address is default, unset other defaults of same type
+        if (input.isDefault) {
+            const addresses = await this.repo.findAddressesByCustomerId(customer.id, ctx);
+            for (const addr of addresses) {
+                if (addr.type === input.type && addr.isDefault) {
+                    await this.repo.updateAddress(addr.id, { isDefault: false }, ctx);
+                }
+            }
+        }
+        const address = await this.repo.createAddress({
+            ...input,
+            customerId: customer.id,
+        }, ctx);
+        return Ok(address);
+    }
+    async deleteAddress(userId, addressId, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const customer = await this.getOrCreateByUserId(orgId, userId, ctx);
+        const addresses = await this.repo.findAddressesByCustomerId(customer.id, ctx);
+        const addressExists = addresses.some((addr) => addr.id === addressId);
+        if (!addressExists) {
+            return Err(new CommerceNotFoundError("Address not found."));
+        }
+        await this.repo.deleteAddress(addressId, ctx);
+        return Ok(undefined);
+    }
+    async findPOSOperatorByPin(hashedPin, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const user = await this.repo.findByPosPin(orgId, hashedPin, ctx);
+        if (!user)
+            return null;
+        return {
+            id: user.userId,
+            name: [user.firstName, user.lastName].filter(Boolean).join(" ") ||
+                user.email ||
+                "POS Operator",
+        };
+    }
+}

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

@@ -0,0 +1,53 @@
+import type { TxContext } from "../../../kernel/database/tx-context";
+import type { FulfillmentRecord, FulfillmentRecordInsert, FulfillmentLineItem, FulfillmentLineItemInsert, FulfillmentEvent, FulfillmentEventInsert } from "./index";
+/**
+ * In-memory implementation of FulfillmentRepository for testing.
+ * Provides the same interface as the Drizzle-based repository but stores data in memory.
+ */
+export declare class InMemoryFulfillmentRepository {
+    private fulfillments;
+    private lineItems;
+    private events;
+    findById(id: string, _ctx?: TxContext): Promise<FulfillmentRecord | undefined>;
+    findByOrderId(orderId: string, _ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    findByCustomerId(customerId: string, _ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    findByStatus(status: string, _ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    findByType(type: string, _ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    findByOrderIdAndStatus(orderId: string, status: string, _ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    findActiveAccessGrants(customerId: string, _ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    findAll(options?: {
+        limit?: number;
+        offset?: number;
+    }, _ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    create(data: FulfillmentRecordInsert, _ctx?: TxContext): Promise<FulfillmentRecord>;
+    update(id: string, data: Partial<Omit<FulfillmentRecordInsert, "id">>, _ctx?: TxContext): Promise<FulfillmentRecord | undefined>;
+    updateStatus(id: string, status: string, _ctx?: TxContext): Promise<FulfillmentRecord | undefined>;
+    delete(id: string, _ctx?: TxContext): Promise<boolean>;
+    incrementDownloadCount(id: string, _ctx?: TxContext): Promise<FulfillmentRecord | undefined>;
+    isDownloadAllowed(id: string, _ctx?: TxContext): Promise<boolean>;
+    deactivateAccessGrant(id: string, _ctx?: TxContext): Promise<FulfillmentRecord | undefined>;
+    activateAccessGrant(id: string, _ctx?: TxContext): Promise<FulfillmentRecord | undefined>;
+    isAccessGrantActive(id: string, _ctx?: TxContext): Promise<boolean>;
+    findLineItemsByFulfillmentId(fulfillmentId: string, _ctx?: TxContext): Promise<FulfillmentLineItem[]>;
+    findLineItemsByOrderLineItemId(orderLineItemId: string, _ctx?: TxContext): Promise<FulfillmentLineItem[]>;
+    createLineItem(data: FulfillmentLineItemInsert, _ctx?: TxContext): Promise<FulfillmentLineItem>;
+    createLineItems(data: FulfillmentLineItemInsert[], _ctx?: TxContext): Promise<FulfillmentLineItem[]>;
+    deleteLineItemsByFulfillmentId(fulfillmentId: string, _ctx?: TxContext): Promise<void>;
+    findEventsByFulfillmentId(fulfillmentId: string, _ctx?: TxContext): Promise<FulfillmentEvent[]>;
+    createEvent(data: FulfillmentEventInsert, _ctx?: TxContext): Promise<FulfillmentEvent>;
+    recordStatusChange(fulfillmentId: string, fromStatus: string, toStatus: string, actorId?: string, description?: string, _ctx?: TxContext): Promise<FulfillmentEvent>;
+    findWithLineItems(id: string, _ctx?: TxContext): Promise<{
+        fulfillment: FulfillmentRecord;
+        lineItems: FulfillmentLineItem[];
+    } | undefined>;
+    findWithEvents(id: string, _ctx?: TxContext): Promise<{
+        fulfillment: FulfillmentRecord;
+        events: FulfillmentEvent[];
+    } | undefined>;
+    /**
+     * Get fulfilled quantity for an order line item.
+     * Sums all fulfillment line items linked to the order line item.
+     */
+    getFulfilledQuantity(orderLineItemId: string, _ctx?: TxContext): Promise<number>;
+}
+//# sourceMappingURL=in-memory.d.ts.map

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

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

package/dist/modules/fulfillment/repository/in-memory.js

@@ -0,0 +1,327 @@
+function makeId() {
+    return crypto.randomUUID();
+}
+/**
+ * In-memory implementation of FulfillmentRepository for testing.
+ * Provides the same interface as the Drizzle-based repository but stores data in memory.
+ */
+export class InMemoryFulfillmentRepository {
+    fulfillments = new Map();
+    lineItems = new Map();
+    events = [];
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Fulfillment Records
+    // ─────────────────────────────────────────────────────────────────────────────
+    async findById(id, _ctx) {
+        return this.fulfillments.get(id);
+    }
+    async findByOrderId(orderId, _ctx) {
+        return [...this.fulfillments.values()]
+            .filter((f) => f.orderId === orderId)
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+    }
+    async findByCustomerId(customerId, _ctx) {
+        return [...this.fulfillments.values()]
+            .filter((f) => f.customerId === customerId)
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+    }
+    async findByStatus(status, _ctx) {
+        return [...this.fulfillments.values()]
+            .filter((f) => f.status === status)
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+    }
+    async findByType(type, _ctx) {
+        return [...this.fulfillments.values()]
+            .filter((f) => f.type === type)
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+    }
+    async findByOrderIdAndStatus(orderId, status, _ctx) {
+        return [...this.fulfillments.values()]
+            .filter((f) => f.orderId === orderId && f.status === status)
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+    }
+    async findActiveAccessGrants(customerId, _ctx) {
+        return [...this.fulfillments.values()]
+            .filter((f) => f.customerId === customerId &&
+            f.type === "access_grant" &&
+            f.isActive === true)
+            .sort((a, b) => {
+            const aTime = a.grantedAt?.getTime() ?? 0;
+            const bTime = b.grantedAt?.getTime() ?? 0;
+            return bTime - aTime;
+        });
+    }
+    async findAll(options, _ctx) {
+        let items = [...this.fulfillments.values()].sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+        if (options?.offset !== undefined) {
+            items = items.slice(options.offset);
+        }
+        if (options?.limit !== undefined) {
+            items = items.slice(0, options.limit);
+        }
+        return items;
+    }
+    async create(data, _ctx) {
+        const now = new Date();
+        const record = {
+            id: data.id ?? makeId(),
+            orderId: data.orderId,
+            customerId: data.customerId === undefined ? null : data.customerId,
+            type: data.type,
+            status: data.status ?? "pending",
+            carrier: data.carrier === undefined ? null : data.carrier,
+            trackingNumber: data.trackingNumber === undefined ? null : data.trackingNumber,
+            trackingUrl: data.trackingUrl === undefined ? null : data.trackingUrl,
+            estimatedDelivery: data.estimatedDelivery === undefined ? null : data.estimatedDelivery,
+            shippedAt: data.shippedAt === undefined ? null : data.shippedAt,
+            deliveredAt: data.deliveredAt === undefined ? null : data.deliveredAt,
+            downloadUrl: data.downloadUrl === undefined ? null : data.downloadUrl,
+            downloadExpiresAt: data.downloadExpiresAt === undefined ? null : data.downloadExpiresAt,
+            maxDownloads: data.maxDownloads === undefined ? null : data.maxDownloads,
+            downloadCount: data.downloadCount ?? 0,
+            entityType: data.entityType === undefined ? null : data.entityType,
+            entityId: data.entityId === undefined ? null : data.entityId,
+            grantedAt: data.grantedAt === undefined ? null : data.grantedAt,
+            expiresAt: data.expiresAt === undefined ? null : data.expiresAt,
+            isActive: data.isActive ?? true,
+            metadata: data.metadata ?? {},
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.fulfillments.set(record.id, record);
+        this.lineItems.set(record.id, []);
+        return record;
+    }
+    async update(id, data, _ctx) {
+        const existing = this.fulfillments.get(id);
+        if (!existing)
+            return undefined;
+        const updated = {
+            id: existing.id,
+            orderId: data.orderId ?? existing.orderId,
+            customerId: data.customerId !== undefined
+                ? (data.customerId ?? null)
+                : existing.customerId,
+            type: data.type ?? existing.type,
+            status: data.status ?? existing.status,
+            carrier: data.carrier !== undefined ? (data.carrier ?? null) : existing.carrier,
+            trackingNumber: data.trackingNumber !== undefined
+                ? (data.trackingNumber ?? null)
+                : existing.trackingNumber,
+            trackingUrl: data.trackingUrl !== undefined
+                ? (data.trackingUrl ?? null)
+                : existing.trackingUrl,
+            estimatedDelivery: data.estimatedDelivery !== undefined
+                ? (data.estimatedDelivery ?? null)
+                : existing.estimatedDelivery,
+            shippedAt: data.shippedAt !== undefined
+                ? (data.shippedAt ?? null)
+                : existing.shippedAt,
+            deliveredAt: data.deliveredAt !== undefined
+                ? (data.deliveredAt ?? null)
+                : existing.deliveredAt,
+            downloadUrl: data.downloadUrl !== undefined
+                ? (data.downloadUrl ?? null)
+                : existing.downloadUrl,
+            downloadExpiresAt: data.downloadExpiresAt !== undefined
+                ? (data.downloadExpiresAt ?? null)
+                : existing.downloadExpiresAt,
+            maxDownloads: data.maxDownloads !== undefined
+                ? (data.maxDownloads ?? null)
+                : existing.maxDownloads,
+            downloadCount: data.downloadCount ?? existing.downloadCount,
+            entityType: data.entityType !== undefined
+                ? (data.entityType ?? null)
+                : existing.entityType,
+            entityId: data.entityId !== undefined
+                ? (data.entityId ?? null)
+                : existing.entityId,
+            grantedAt: data.grantedAt !== undefined
+                ? (data.grantedAt ?? null)
+                : existing.grantedAt,
+            expiresAt: data.expiresAt !== undefined
+                ? (data.expiresAt ?? null)
+                : existing.expiresAt,
+            isActive: data.isActive ?? existing.isActive,
+            metadata: data.metadata !== undefined ? (data.metadata ?? {}) : existing.metadata,
+            createdAt: existing.createdAt,
+            updatedAt: new Date(),
+        };
+        this.fulfillments.set(id, updated);
+        return updated;
+    }
+    async updateStatus(id, status, _ctx) {
+        const data = { 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, _ctx) {
+        this.lineItems.delete(id);
+        this.events = this.events.filter((e) => e.fulfillmentId !== id);
+        return this.fulfillments.delete(id);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Digital Delivery Operations
+    // ─────────────────────────────────────────────────────────────────────────────
+    async incrementDownloadCount(id, _ctx) {
+        const existing = this.fulfillments.get(id);
+        if (!existing)
+            return undefined;
+        const updated = {
+            ...existing,
+            downloadCount: existing.downloadCount + 1,
+            updatedAt: new Date(),
+        };
+        this.fulfillments.set(id, updated);
+        return updated;
+    }
+    async isDownloadAllowed(id, _ctx) {
+        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, _ctx) {
+        return this.update(id, { isActive: false }, _ctx);
+    }
+    async activateAccessGrant(id, _ctx) {
+        return this.update(id, { isActive: true, grantedAt: new Date() }, _ctx);
+    }
+    async isAccessGrantActive(id, _ctx) {
+        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, _ctx) {
+        return this.lineItems.get(fulfillmentId) ?? [];
+    }
+    async findLineItemsByOrderLineItemId(orderLineItemId, _ctx) {
+        const result = [];
+        for (const items of this.lineItems.values()) {
+            for (const item of items) {
+                if (item.orderLineItemId === orderLineItemId) {
+                    result.push(item);
+                }
+            }
+        }
+        return result;
+    }
+    async createLineItem(data, _ctx) {
+        const item = {
+            id: data.id ?? makeId(),
+            fulfillmentId: data.fulfillmentId,
+            orderLineItemId: data.orderLineItemId,
+            quantity: data.quantity,
+        };
+        const items = this.lineItems.get(data.fulfillmentId) ?? [];
+        items.push(item);
+        this.lineItems.set(data.fulfillmentId, items);
+        return item;
+    }
+    async createLineItems(data, _ctx) {
+        if (data.length === 0)
+            return [];
+        const created = [];
+        for (const item of data) {
+            created.push(await this.createLineItem(item, _ctx));
+        }
+        return created;
+    }
+    async deleteLineItemsByFulfillmentId(fulfillmentId, _ctx) {
+        this.lineItems.set(fulfillmentId, []);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Fulfillment Events
+    // ─────────────────────────────────────────────────────────────────────────────
+    async findEventsByFulfillmentId(fulfillmentId, _ctx) {
+        return this.events
+            .filter((e) => e.fulfillmentId === fulfillmentId)
+            .sort((a, b) => b.occurredAt.getTime() - a.occurredAt.getTime());
+    }
+    async createEvent(data, _ctx) {
+        const event = {
+            id: data.id ?? makeId(),
+            fulfillmentId: data.fulfillmentId,
+            eventType: data.eventType,
+            fromStatus: data.fromStatus === undefined ? null : data.fromStatus,
+            toStatus: data.toStatus === undefined ? null : data.toStatus,
+            description: data.description === undefined ? null : data.description,
+            actorId: data.actorId === undefined ? null : data.actorId,
+            metadata: data.metadata ?? {},
+            occurredAt: new Date(),
+        };
+        this.events.push(event);
+        return event;
+    }
+    async recordStatusChange(fulfillmentId, fromStatus, toStatus, actorId, description, _ctx) {
+        return this.createEvent({
+            fulfillmentId,
+            eventType: "status_change",
+            fromStatus,
+            toStatus,
+            actorId,
+            description,
+        }, _ctx);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Aggregate Operations
+    // ─────────────────────────────────────────────────────────────────────────────
+    async findWithLineItems(id, _ctx) {
+        const fulfillment = await this.findById(id, _ctx);
+        if (!fulfillment)
+            return undefined;
+        const lineItems = await this.findLineItemsByFulfillmentId(id, _ctx);
+        return { fulfillment, lineItems };
+    }
+    async findWithEvents(id, _ctx) {
+        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, _ctx) {
+        let total = 0;
+        for (const items of this.lineItems.values()) {
+            for (const item of items) {
+                if (item.orderLineItemId === orderLineItemId) {
+                    total += item.quantity;
+                }
+            }
+        }
+        return total;
+    }
+}

package/dist/modules/fulfillment/repository/index.d.ts

@@ -0,0 +1,63 @@
+import type { TxContext } from "../../../kernel/database/tx-context";
+import type { DrizzleDatabase } from "../../../kernel/database/drizzle-db";
+import { fulfillmentRecords, fulfillmentLineItems, fulfillmentEvents } from "../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 declare class FulfillmentRepository {
+    private readonly db;
+    constructor(db: DrizzleDatabase);
+    private getDb;
+    findById(id: string, ctx?: TxContext): Promise<FulfillmentRecord | undefined>;
+    findByOrderId(orderId: string, ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    findByCustomerId(customerId: string, ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    findByStatus(status: string, ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    findByType(type: string, ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    findByOrderIdAndStatus(orderId: string, status: string, ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    findActiveAccessGrants(customerId: string, ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    findAll(options?: {
+        limit?: number;
+        offset?: number;
+    }, ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    create(data: FulfillmentRecordInsert, ctx?: TxContext): Promise<FulfillmentRecord>;
+    update(id: string, data: Partial<Omit<FulfillmentRecordInsert, "id">>, ctx?: TxContext): Promise<FulfillmentRecord | undefined>;
+    updateStatus(id: string, status: string, ctx?: TxContext): Promise<FulfillmentRecord | undefined>;
+    delete(id: string, ctx?: TxContext): Promise<boolean>;
+    incrementDownloadCount(id: string, ctx?: TxContext): Promise<FulfillmentRecord | undefined>;
+    isDownloadAllowed(id: string, ctx?: TxContext): Promise<boolean>;
+    deactivateAccessGrant(id: string, ctx?: TxContext): Promise<FulfillmentRecord | undefined>;
+    activateAccessGrant(id: string, ctx?: TxContext): Promise<FulfillmentRecord | undefined>;
+    isAccessGrantActive(id: string, ctx?: TxContext): Promise<boolean>;
+    findLineItemsByFulfillmentId(fulfillmentId: string, ctx?: TxContext): Promise<FulfillmentLineItem[]>;
+    findLineItemsByOrderLineItemId(orderLineItemId: string, ctx?: TxContext): Promise<FulfillmentLineItem[]>;
+    createLineItem(data: FulfillmentLineItemInsert, ctx?: TxContext): Promise<FulfillmentLineItem>;
+    createLineItems(data: FulfillmentLineItemInsert[], ctx?: TxContext): Promise<FulfillmentLineItem[]>;
+    deleteLineItemsByFulfillmentId(fulfillmentId: string, ctx?: TxContext): Promise<void>;
+    findEventsByFulfillmentId(fulfillmentId: string, ctx?: TxContext): Promise<FulfillmentEvent[]>;
+    createEvent(data: FulfillmentEventInsert, ctx?: TxContext): Promise<FulfillmentEvent>;
+    recordStatusChange(fulfillmentId: string, fromStatus: string, toStatus: string, actorId?: string, description?: string, ctx?: TxContext): Promise<FulfillmentEvent>;
+    findWithLineItems(id: string, ctx?: TxContext): Promise<{
+        fulfillment: FulfillmentRecord;
+        lineItems: FulfillmentLineItem[];
+    } | undefined>;
+    findWithEvents(id: string, ctx?: TxContext): Promise<{
+        fulfillment: FulfillmentRecord;
+        events: FulfillmentEvent[];
+    } | undefined>;
+    /**
+     * Get fulfilled quantity for an order line item.
+     * Sums all fulfillment line items linked to the order line item.
+     */
+    getFulfilledQuantity(orderLineItemId: string, ctx?: TxContext): Promise<number>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/fulfillment/repository/index.d.ts.map

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