@comity/order 0.9.3 → 0.10.0

package/dist/errors/order.d.ts

@@ -7,8 +7,14 @@ import { BaseError } from "@comity/primitives/errors";
  * a `null` repository result, never an error; infrastructure and
  * cross-module failures (`repository_error`, `insufficient_stock`,
  * `product_not_available`, coupon validation) belong to other layers/modules.
+ *
+ * The four `currency_mismatch`, `price_incoherent`, `commitment_immutable` and
+ * `payment_fact_conflict` reasons are additive (errors.md §10): no existing
+ * reason changed its meaning, and no other reason exists. The former
+ * `invalid_buyer` reason is removed with O-11, whose commercial/fiscal buyer
+ * coherence belongs to Commerce.
  */
-export type OrderErrorReason = "invalid_quantity" | "invalid_item" | "invalid_status_transition" | "shipping_destination_immutable" | "ambiguous_shipping_destination" | "duplicate_item_id";
+export type OrderErrorReason = "invalid_quantity" | "invalid_item" | "invalid_status_transition" | "shipping_destination_immutable" | "ambiguous_shipping_destination" | "duplicate_item_id" | "currency_mismatch" | "price_incoherent" | "commitment_immutable" | "payment_fact_conflict";
 /**
  * Order error metadata.
  */

package/dist/errors/order.js

@@ -1,11 +1,15 @@
 import { BaseError } from "@comity/primitives/errors";
 const REASON_MESSAGES = {
-    invalid_quantity: "Invalid order item quantity",
-    invalid_item: "Order item not found",
+    invalid_quantity: "Invalid order line quantity",
+    invalid_item: "Order line not found",
     invalid_status_transition: "Invalid order status transition",
     shipping_destination_immutable: "Shipping destination cannot be changed in the current order status",
     ambiguous_shipping_destination: "Order must contain exactly one shipping destination",
-    duplicate_item_id: "Duplicate order item identifier",
+    duplicate_item_id: "Duplicate order line identifier",
+    currency_mismatch: "Order lines and price must share one currency",
+    price_incoherent: "Order price is not coherent with its lines",
+    commitment_immutable: "Committed lines and price cannot be changed outside draft",
+    payment_fact_conflict: "Payment fact conflicts with the recorded payment facts",
 };
 const REASON_HTTP_STATUS = {
     invalid_quantity: 400,
@@ -14,6 +18,10 @@ const REASON_HTTP_STATUS = {
     shipping_destination_immutable: 409,
     ambiguous_shipping_destination: 409,
     duplicate_item_id: 400,
+    currency_mismatch: 409,
+    price_incoherent: 409,
+    commitment_immutable: 409,
+    payment_fact_conflict: 409,
 };
 /**
  * Order operation error with typed reasons.

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 export type { OrderAddressRole, OrderAddressSnapshot } from "./contracts/address-snapshot.js";
 export type { OrderContact } from "./contracts/contact.js";
 export type { OrderCustomerSnapshot } from "./contracts/customer-snapshot.js";
-export type { OrderItem, OrderProductAttribute, OrderProductOption, OrderProductSnapshot, OrderVariantSnapshot, } from "./contracts/item.js";
+export type { OrderLine, OrderLineSubject } from "./contracts/line.js";
 export type { OrderRepository, OrderRepositoryContext, OrderSearchCriteria, OrderSearchResult, } from "./contracts/order-repository.js";
-export type { OrderCreate, OrderData, OrderItemInput, OrderSnapshot, OrderState, OrderStatus, OrderUpdate, } from "./contracts/order.js";
+export type { OrderCreate, OrderData, OrderSnapshot, OrderState, OrderStatus, OrderUpdate, } from "./contracts/order.js";
 export type { OrderPaymentSnapshot, OrderPaymentStatus } from "./contracts/payment-snapshot.js";
 export { Order } from "./entities/order.js";
 export { OrderId } from "./value-objects/order-id.js";

package/dist/repositories/memory.js

@@ -8,6 +8,14 @@ import { success } from "@comity/primitives/result";
 export class MemoryOrderRepository {
     /** Internal storage keyed by tenant + order ID */
     #orders = new Map();
+    /**
+     * Builds the tenant-scoped storage key.
+     *
+     * @param tenant - The tenant identifier.
+     * @param id - The order identifier.
+     *
+     * @returns The storage key.
+     */
     #makeKey(tenant, id) {
         return `${tenant.toString()}\u0000${id.toString()}`;
     }
@@ -47,8 +55,10 @@ export class MemoryOrderRepository {
             status: o.status,
             createdAt: o.createdAt,
             updatedAt: o.updatedAt,
-            items: o.items,
+            version: o.version,
+            lines: o.lines,
             price: o.price,
+            currency: o.currency,
             channelId: o.channelId,
             ...(o.customer !== undefined ? { customer: o.customer } : {}),
             ...(o.addresses !== undefined ? { addresses: o.addresses } : {}),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comity/order",
-  "version": "0.9.3",
+  "version": "0.10.0",
   "description": "Order domain contracts for Comity commerce modules.",
   "type": "module",
   "private": false,
@@ -65,9 +65,9 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@comity/organization": "^0.9.3",
-    "@comity/pricing": "^0.9.3",
-    "@comity/primitives": "^0.9.2"
+    "@comity/organization": "^0.9.4",
+    "@comity/pricing": "^0.10.0",
+    "@comity/primitives": "^0.9.3"
   },
   "devDependencies": {
     "@types/node": "^24.19.2",

package/dist/contracts/item.d.ts

@@ -1,107 +0,0 @@
-import type { Price } from "@comity/pricing";
-/**
- * Product attribute snapshot associated with an order item.
- *
- * A frozen copy of a product attribute at purchase time. It mirrors
- * `ProductAttribute` from `@comity/catalog` without importing catalog types:
- * the order stays independent of the catalog read model.
- */
-export interface OrderProductAttribute {
-    /** Attribute code. */
-    readonly code: string;
-    /** Display name of the attribute. */
-    readonly label?: string;
-    /** Attribute value. */
-    readonly value: string | number | boolean;
-}
-/**
- * Selected option snapshot for an order item (e.g. size = "M", color = "blue").
- *
- * A frozen copy of a chosen product option at purchase time. It mirrors
- * `ProductOptionSelection` from `@comity/catalog` without importing catalog
- * types; the `label` is preserved so the selection stays renderable without
- * the catalog.
- */
-export interface OrderProductOption {
-    /** Option code. */
-    readonly code: string;
-    /** Display name of the option. */
-    readonly label?: string;
-    /** Selected option value. */
-    readonly value: string;
-}
-/**
- * Product variant snapshot associated with an order item.
- *
- * A frozen copy of the purchased product variant at purchase time. It mirrors
- * `ProductVariant` from `@comity/catalog` without importing catalog types and
- * carries no pricing or inventory — those belong to their owning modules.
- */
-export interface OrderVariantSnapshot {
-    /** Variant identifier. */
-    readonly id: string;
-    /** Stock Keeping Unit of the variant. */
-    readonly sku?: string;
-    /** Display name of the variant. */
-    readonly name?: string;
-    /** Variant attribute snapshots. */
-    readonly attributes?: ReadonlyArray<OrderProductAttribute>;
-    /** Selected option snapshots of the variant. */
-    readonly options?: ReadonlyArray<OrderProductOption>;
-}
-/**
- * Immutable product snapshot associated with an order item.
- *
- * A self-contained representation of the product as it was at purchase time.
- * It is NOT `ProductProjection` from `@comity/catalog` and it is NOT a
- * reference to the catalog: once the order is created it MUST NOT depend on
- * the catalog for its content. Historical order rendering, customer support,
- * invoice generation, and returns workflows rely exclusively on this record.
- */
-export interface OrderProductSnapshot {
-    /** Reference to the catalog product identifier, if still known. */
-    readonly productId?: string;
-    /** Stock Keeping Unit. */
-    readonly sku: string;
-    /** Product name. */
-    readonly name: string;
-    /** The purchased variant, if the product is variant-based. */
-    readonly variant?: OrderVariantSnapshot;
-    /** Product attribute snapshots. */
-    readonly attributes?: ReadonlyArray<OrderProductAttribute>;
-    /** Selected option snapshots. */
-    readonly options?: ReadonlyArray<OrderProductOption>;
-    /** Free-form metadata (e.g. image URL, page URL). */
-    readonly metadata?: Readonly<Record<string, unknown>>;
-}
-/**
- * Order line item.
- *
- * Embedded value structure of the Order aggregate: it has no independent
- * identity, lifecycle, or repository.
- */
-export interface OrderItem {
-    /**
-     * Stable technical key for one occurrence within the order.
-     *
-     * The key identifies the occurrence, not the product: it carries no
-     * commercial equivalence meaning and must never be derived by comparing
-     * product data. Occurrence keys are unique within the order, preserved
-     * across retention/updates, and never reassigned after removal.
-     */
-    readonly id: string;
-    /** Associated product snapshot. */
-    readonly product: OrderProductSnapshot;
-    /** Requested quantity. */
-    readonly quantity: number;
-    /**
-     * Full line price (subtotal, applied modifiers, total).
-     *
-     * `@comity/pricing` is the single owner of price composition data: price
-     * modifiers are accessed exclusively through `price.modifiers`. The order
-     * stores the immutable `Price` value and never duplicates modifier storage.
-     */
-    readonly price: Price;
-    /** Custom metadata. */
-    readonly meta?: Record<string, unknown>;
-}

package/dist/contracts/item.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=item.js.map