@salixcommerce/core 0.1.0

package/dist/inventory.d.ts

@@ -0,0 +1,27 @@
+import { z } from "zod";
+export declare const inventoryStateSchema: z.ZodObject<{
+    mode: z.ZodEnum<{
+        tracked: "tracked";
+        untracked: "untracked";
+    }>;
+    onHand: z.ZodNumber;
+    reserved: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const inventoryMovementSchema: z.ZodObject<{
+    delta: z.ZodNumber;
+    idempotencyKey: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strict>;
+export declare const inventoryAvailabilitySchema: z.ZodEnum<{
+    untracked: "untracked";
+    backorder: "backorder";
+    in_stock: "in_stock";
+    out_of_stock: "out_of_stock";
+}>;
+export type InventoryState = z.output<typeof inventoryStateSchema>;
+export type InventoryMovement = z.output<typeof inventoryMovementSchema>;
+export type InventoryAvailability = z.output<typeof inventoryAvailabilitySchema>;
+export declare function resolveInventoryAvailability(state: InventoryState, allowBackorders: boolean): InventoryAvailability;
+export declare function applyInventoryReservation(state: InventoryState, delta: number): InventoryState;
+export declare function applyInventoryMovement(state: InventoryState, movement: InventoryMovement): InventoryState;
+//# sourceMappingURL=inventory.d.ts.map

package/dist/inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.d.ts","sourceRoot":"","sources":["../src/inventory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,oBAAoB;;;;;;;kBAqB7B,CAAC;AAEL,eAAO,MAAM,uBAAuB;;;;kBAalC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;EAKtC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACnE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACzE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEjF,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,cAAc,EACrB,eAAe,EAAE,OAAO,GACvB,qBAAqB,CAKvB;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAmC9F;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,iBAAiB,GAC1B,cAAc,CA8BhB"}

package/dist/inventory.js

@@ -0,0 +1,95 @@
+import { z } from "zod";
+import { DomainInvariantError } from "./invariant-error.js";
+const inventoryQuantitySchema = z.number().int().safe().nonnegative();
+export const inventoryStateSchema = z
+    .strictObject({
+    mode: z.enum(["tracked", "untracked"]),
+    onHand: inventoryQuantitySchema,
+    reserved: inventoryQuantitySchema.default(0),
+})
+    .superRefine((value, context) => {
+    if (value.mode === "untracked" && (value.onHand !== 0 || value.reserved !== 0)) {
+        context.addIssue({
+            code: "custom",
+            message: "Untracked inventory must use zero on-hand and reserved placeholders.",
+            path: ["onHand"],
+        });
+    }
+    if (value.mode === "tracked" && value.reserved > value.onHand) {
+        context.addIssue({
+            code: "custom",
+            message: "Reserved inventory cannot exceed physical on-hand inventory.",
+            path: ["reserved"],
+        });
+    }
+});
+export const inventoryMovementSchema = z.strictObject({
+    delta: z
+        .number()
+        .int()
+        .safe()
+        .refine((value) => value !== 0, "Movement delta cannot be zero."),
+    idempotencyKey: z
+        .string()
+        .trim()
+        .min(8)
+        .max(160)
+        .regex(/^[A-Za-z0-9][A-Za-z0-9._:-]*$/u, "Invalid inventory idempotency key."),
+    reason: z.string().trim().min(1).max(240),
+});
+export const inventoryAvailabilitySchema = z.enum([
+    "backorder",
+    "in_stock",
+    "out_of_stock",
+    "untracked",
+]);
+export function resolveInventoryAvailability(state, allowBackorders) {
+    const parsed = inventoryStateSchema.parse(state);
+    if (parsed.mode === "untracked")
+        return "untracked";
+    if (parsed.onHand - parsed.reserved > 0)
+        return "in_stock";
+    return allowBackorders ? "backorder" : "out_of_stock";
+}
+export function applyInventoryReservation(state, delta) {
+    const parsedState = inventoryStateSchema.parse(state);
+    const parsedDelta = z
+        .number()
+        .int()
+        .safe()
+        .refine((value) => value !== 0)
+        .parse(delta);
+    if (parsedState.mode === "untracked") {
+        throw new DomainInvariantError("INVENTORY_UNTRACKED_MOVEMENT", "Inventory reservations require tracked inventory.");
+    }
+    const nextReserved = parsedState.reserved + parsedDelta;
+    if (!Number.isSafeInteger(nextReserved)) {
+        throw new DomainInvariantError("INVENTORY_ARITHMETIC_OVERFLOW", "Inventory reservation exceeds the safe-integer range.");
+    }
+    if (nextReserved < 0) {
+        throw new DomainInvariantError("INVENTORY_RESERVATION_NEGATIVE", "Inventory reservation cannot create a negative reserved balance.");
+    }
+    if (nextReserved > parsedState.onHand) {
+        throw new DomainInvariantError("INVENTORY_RESERVATION_EXCEEDS_ON_HAND", "Inventory reservation cannot exceed physical on-hand inventory.");
+    }
+    return { ...parsedState, reserved: nextReserved };
+}
+export function applyInventoryMovement(state, movement) {
+    const parsedState = inventoryStateSchema.parse(state);
+    const parsedMovement = inventoryMovementSchema.parse(movement);
+    if (parsedState.mode === "untracked") {
+        throw new DomainInvariantError("INVENTORY_UNTRACKED_MOVEMENT", "Inventory movements require tracked inventory.");
+    }
+    const nextOnHand = parsedState.onHand + parsedMovement.delta;
+    if (!Number.isSafeInteger(nextOnHand)) {
+        throw new DomainInvariantError("INVENTORY_ARITHMETIC_OVERFLOW", "Inventory movement exceeds safe integer range.");
+    }
+    if (nextOnHand < 0) {
+        throw new DomainInvariantError("INVENTORY_NEGATIVE_BALANCE", "Inventory movement cannot create a negative physical balance.");
+    }
+    if (nextOnHand < parsedState.reserved) {
+        throw new DomainInvariantError("INVENTORY_MOVEMENT_BELOW_RESERVED", "Inventory movement cannot reduce physical stock below the reserved balance.");
+    }
+    return { ...parsedState, onHand: nextOnHand };
+}
+//# sourceMappingURL=inventory.js.map

package/dist/inventory.js.map

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

package/dist/lifecycle.d.ts

@@ -0,0 +1,30 @@
+export interface LifecycleTransition<TState extends string, TCapability extends string> {
+    readonly capability: TCapability;
+    readonly from: TState;
+    readonly to: TState;
+}
+export interface LifecycleTableDefect {
+    readonly detail: string;
+    readonly kind: "CONTRADICTORY_TRANSITION" | "DEAD_NON_TERMINAL" | "DUPLICATE_EDGE" | "UNREACHABLE_STATE";
+}
+export type LifecycleGuardResult<TState extends string, TCapability extends string> = {
+    readonly ok: true;
+    readonly transition: LifecycleTransition<TState, TCapability>;
+} | {
+    readonly error: {
+        readonly code: "ILLEGAL_TRANSITION";
+        readonly from: TState;
+        readonly to: TState;
+    } | {
+        readonly capability: TCapability;
+        readonly code: "UNAUTHORIZED_ACTOR";
+    };
+    readonly ok: false;
+};
+export declare function guardLifecycleTransition<TState extends string, TCapability extends string>(table: readonly LifecycleTransition<TState, TCapability>[], request: Readonly<{
+    capabilities: readonly TCapability[];
+    from: TState;
+    to: TState;
+}>): LifecycleGuardResult<TState, TCapability>;
+export declare function validateLifecycleTransitionTable<TState extends string, TCapability extends string>(table: readonly LifecycleTransition<TState, TCapability>[], initial: TState, declaredTerminal: readonly TState[]): LifecycleTableDefect[];
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB,CAAC,MAAM,SAAS,MAAM,EAAE,WAAW,SAAS,MAAM;IACpF,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EACX,0BAA0B,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;CAC7F;AAED,MAAM,MAAM,oBAAoB,CAAC,MAAM,SAAS,MAAM,EAAE,WAAW,SAAS,MAAM,IAC9E;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CAC/D,GACD;IACE,QAAQ,CAAC,KAAK,EACV;QACE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;QACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;KACrB,GACD;QACE,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;QACjC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;KACrC,CAAC;IACN,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;CACpB,CAAC;AAEN,wBAAgB,wBAAwB,CAAC,MAAM,SAAS,MAAM,EAAE,WAAW,SAAS,MAAM,EACxF,KAAK,EAAE,SAAS,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,EAC1D,OAAO,EAAE,QAAQ,CAAC;IAChB,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC,GACD,oBAAoB,CAAC,MAAM,EAAE,WAAW,CAAC,CAiB3C;AAED,wBAAgB,gCAAgC,CAAC,MAAM,SAAS,MAAM,EAAE,WAAW,SAAS,MAAM,EAChG,KAAK,EAAE,SAAS,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,EAC1D,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAClC,oBAAoB,EAAE,CA2DxB"}

package/dist/lifecycle.js

@@ -0,0 +1,76 @@
+export function guardLifecycleTransition(table, request) {
+    const transition = table.find((candidate) => candidate.from === request.from && candidate.to === request.to);
+    if (transition === undefined) {
+        return {
+            error: { code: "ILLEGAL_TRANSITION", from: request.from, to: request.to },
+            ok: false,
+        };
+    }
+    if (!request.capabilities.includes(transition.capability)) {
+        return {
+            error: { capability: transition.capability, code: "UNAUTHORIZED_ACTOR" },
+            ok: false,
+        };
+    }
+    return { ok: true, transition };
+}
+export function validateLifecycleTransitionTable(table, initial, declaredTerminal) {
+    const defects = [];
+    const states = new Set([initial]);
+    const edges = new Map();
+    const edgeCounts = new Map();
+    const adjacency = new Map();
+    for (const transition of table) {
+        states.add(transition.from);
+        states.add(transition.to);
+        const key = `${transition.from}->${transition.to}`;
+        const capabilities = edges.get(key) ?? new Set();
+        capabilities.add(transition.capability);
+        edges.set(key, capabilities);
+        edgeCounts.set(key, (edgeCounts.get(key) ?? 0) + 1);
+        adjacency.set(transition.from, [...(adjacency.get(transition.from) ?? []), transition.to]);
+    }
+    for (const [key, capabilities] of edges) {
+        if (capabilities.size > 1) {
+            defects.push({
+                detail: `${key} has conflicting capabilities: ${[...capabilities].join(", ")}`,
+                kind: "CONTRADICTORY_TRANSITION",
+            });
+        }
+        else if ((edgeCounts.get(key) ?? 0) > 1) {
+            defects.push({ detail: `${key} is declared more than once.`, kind: "DUPLICATE_EDGE" });
+        }
+    }
+    const seen = new Set([initial]);
+    const queue = [initial];
+    while (queue.length > 0) {
+        const state = queue.shift();
+        if (state === undefined)
+            break;
+        for (const next of adjacency.get(state) ?? []) {
+            if (seen.has(next))
+                continue;
+            seen.add(next);
+            queue.push(next);
+        }
+    }
+    for (const state of states) {
+        if (!seen.has(state)) {
+            defects.push({
+                detail: `'${state}' is unreachable from '${initial}'.`,
+                kind: "UNREACHABLE_STATE",
+            });
+        }
+    }
+    const terminal = new Set(declaredTerminal);
+    for (const state of states) {
+        if (!adjacency.has(state) && !terminal.has(state)) {
+            defects.push({
+                detail: `'${state}' has no outgoing edge and is not declared terminal.`,
+                kind: "DEAD_NON_TERMINAL",
+            });
+        }
+    }
+    return defects;
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

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

package/dist/money.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+export declare const currencyCodeSchema: z.ZodString;
+export declare const nonNegativeMinorUnitSchema: z.ZodNumber;
+export declare const moneySchema: z.ZodObject<{
+    amountMinor: z.ZodNumber;
+    currency: z.ZodString;
+}, z.core.$strict>;
+export type Money = z.output<typeof moneySchema>;
+export declare function createMoney(amountMinor: number, currency: string): Money;
+export declare function addMoney(left: Money, right: Money): Money;
+export declare function multiplyMoney(money: Money, multiplier: number): Money;
+export declare function formatMoney(money: Money, locale: string): string;
+//# sourceMappingURL=money.d.ts.map

package/dist/money.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../src/money.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,kBAAkB,aAIsD,CAAC;AAEtF,eAAO,MAAM,0BAA0B,aAIgC,CAAC;AAExE,eAAO,MAAM,WAAW;;;kBAGtB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,WAAW,CAAC,CAAC;AAEjD,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CAExE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAQzD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,GAAG,KAAK,CAOrE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAWhE"}

package/dist/money.js

@@ -0,0 +1,67 @@
+import { z } from "zod";
+import { DomainInvariantError } from "./invariant-error.js";
+export const currencyCodeSchema = z
+    .string()
+    .trim()
+    .regex(/^[A-Z]{3}$/u, "Currency must be an uppercase ISO 4217 code.")
+    .refine(isRuntimeCurrency, "Currency must be supported by the JavaScript runtime.");
+export const nonNegativeMinorUnitSchema = z
+    .number()
+    .int()
+    .safe()
+    .nonnegative("Money amount must be nonnegative integer minor units.");
+export const moneySchema = z.strictObject({
+    amountMinor: nonNegativeMinorUnitSchema,
+    currency: currencyCodeSchema,
+});
+export function createMoney(amountMinor, currency) {
+    return moneySchema.parse({ amountMinor, currency });
+}
+export function addMoney(left, right) {
+    const parsedLeft = moneySchema.parse(left);
+    const parsedRight = moneySchema.parse(right);
+    assertMatchingCurrency(parsedLeft, parsedRight);
+    return createMoney(safeMoneyArithmetic(parsedLeft.amountMinor + parsedRight.amountMinor), parsedLeft.currency);
+}
+export function multiplyMoney(money, multiplier) {
+    const parsedMoney = moneySchema.parse(money);
+    const parsedMultiplier = z.number().int().safe().nonnegative().parse(multiplier);
+    return createMoney(safeMoneyArithmetic(parsedMoney.amountMinor * parsedMultiplier), parsedMoney.currency);
+}
+export function formatMoney(money, locale) {
+    const parsed = moneySchema.parse(money);
+    const formatter = new Intl.NumberFormat(locale, {
+        currency: parsed.currency,
+        style: "currency",
+    });
+    const fractionDigits = formatter.resolvedOptions().maximumFractionDigits;
+    if (fractionDigits === undefined) {
+        throw new RangeError(`No minor-unit exponent is available for ${parsed.currency}.`);
+    }
+    return formatter.format(parsed.amountMinor / 10 ** fractionDigits);
+}
+function isRuntimeCurrency(value) {
+    const supportedValuesOf = Intl.supportedValuesOf;
+    if (supportedValuesOf) {
+        return supportedValuesOf("currency").includes(value);
+    }
+    try {
+        new Intl.NumberFormat("en", { currency: value, style: "currency" }).format(0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function assertMatchingCurrency(left, right) {
+    if (left.currency !== right.currency) {
+        throw new DomainInvariantError("MONEY_CURRENCY_MISMATCH", `Cannot combine ${left.currency} and ${right.currency}.`);
+    }
+}
+function safeMoneyArithmetic(value) {
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw new DomainInvariantError("MONEY_ARITHMETIC_OVERFLOW", "Money calculation exceeds the nonnegative safe-integer range.");
+    }
+    return value;
+}
+//# sourceMappingURL=money.js.map

package/dist/money.js.map

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

package/dist/order.d.ts

@@ -0,0 +1,119 @@
+import { z } from "zod";
+import { type PricedCartLine } from "./cart.js";
+import { type LifecycleGuardResult } from "./lifecycle.js";
+import { type Money } from "./money.js";
+export declare const orderStatusSchema: z.ZodEnum<{
+    fulfilled: "fulfilled";
+    processing: "processing";
+    pending_payment: "pending_payment";
+    paid: "paid";
+    cancelled: "cancelled";
+}>;
+export declare const orderCapabilitySchema: z.ZodEnum<{
+    "order.cancel": "order.cancel";
+    "order.process": "order.process";
+    "order.fulfill": "order.fulfill";
+    "payment.succeed": "payment.succeed";
+}>;
+export declare const orderReferenceSchema: z.ZodString;
+export declare const contactEmailSchema: z.ZodString;
+export declare const orderCreateCommandSchema: z.ZodObject<{
+    contactEmail: z.ZodString;
+    idempotencyKey: z.ZodString;
+}, z.core.$strict>;
+export declare const orderCancelCommandSchema: z.ZodObject<{
+    idempotencyKey: z.ZodString;
+    reason: z.ZodDefault<z.ZodString>;
+}, z.core.$strict>;
+export declare const orderItemSnapshotSchema: z.ZodObject<{
+    backorderedQuantity: z.ZodNumber;
+    inventoryMode: z.ZodEnum<{
+        tracked: "tracked";
+        untracked: "untracked";
+    }>;
+    lineTotal: z.ZodObject<{
+        amountMinor: z.ZodNumber;
+        currency: z.ZodString;
+    }, z.core.$strict>;
+    productName: z.ZodString;
+    productSlug: z.ZodString;
+    quantity: z.ZodNumber;
+    reservedQuantity: z.ZodNumber;
+    sku: z.ZodNullable<z.ZodString>;
+    sourceVariantId: z.ZodString;
+    unitPrice: z.ZodObject<{
+        amountMinor: z.ZodNumber;
+        currency: z.ZodString;
+    }, z.core.$strict>;
+    variantName: z.ZodString;
+}, z.core.$strict>;
+export declare const orderSnapshotSchema: z.ZodObject<{
+    contactEmail: z.ZodString;
+    createdAt: z.ZodString;
+    currency: z.ZodString;
+    id: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{
+        backorderedQuantity: z.ZodNumber;
+        inventoryMode: z.ZodEnum<{
+            tracked: "tracked";
+            untracked: "untracked";
+        }>;
+        lineTotal: z.ZodObject<{
+            amountMinor: z.ZodNumber;
+            currency: z.ZodString;
+        }, z.core.$strict>;
+        productName: z.ZodString;
+        productSlug: z.ZodString;
+        quantity: z.ZodNumber;
+        reservedQuantity: z.ZodNumber;
+        sku: z.ZodNullable<z.ZodString>;
+        sourceVariantId: z.ZodString;
+        unitPrice: z.ZodObject<{
+            amountMinor: z.ZodNumber;
+            currency: z.ZodString;
+        }, z.core.$strict>;
+        variantName: z.ZodString;
+    }, z.core.$strict>>;
+    merchandiseSubtotal: z.ZodObject<{
+        amountMinor: z.ZodNumber;
+        currency: z.ZodString;
+    }, z.core.$strict>;
+    reference: z.ZodString;
+    status: z.ZodEnum<{
+        fulfilled: "fulfilled";
+        processing: "processing";
+        pending_payment: "pending_payment";
+        paid: "paid";
+        cancelled: "cancelled";
+    }>;
+}, z.core.$strict>;
+export type OrderStatus = z.output<typeof orderStatusSchema>;
+export type OrderCapability = z.output<typeof orderCapabilitySchema>;
+export type OrderItemSnapshot = z.output<typeof orderItemSnapshotSchema>;
+export type OrderSnapshot = z.output<typeof orderSnapshotSchema>;
+export declare const ORDER_TRANSITIONS: readonly [{
+    readonly capability: "order.cancel";
+    readonly from: "pending_payment";
+    readonly to: "cancelled";
+}, {
+    readonly capability: "payment.succeed";
+    readonly from: "pending_payment";
+    readonly to: "paid";
+}, {
+    readonly capability: "order.process";
+    readonly from: "paid";
+    readonly to: "processing";
+}, {
+    readonly capability: "order.fulfill";
+    readonly from: "processing";
+    readonly to: "fulfilled";
+}];
+export declare function guardOrderTransition(from: OrderStatus, to: OrderStatus, capabilities: readonly OrderCapability[]): LifecycleGuardResult<OrderStatus, OrderCapability>;
+export declare function validateOrderTransitionTable(): import("./lifecycle.js").LifecycleTableDefect[];
+export declare function createOrderItemSnapshot(line: PricedCartLine, allocation: Readonly<{
+    backorderedQuantity: number;
+    inventoryMode: "tracked" | "untracked";
+    reservedQuantity: number;
+}>): OrderItemSnapshot;
+export declare function verifyOrderLineTotal(item: OrderItemSnapshot): Money;
+//# sourceMappingURL=order.d.ts.map

package/dist/order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../src/order.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAA8C,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAE5F,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAA4D,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAElG,eAAO,MAAM,iBAAiB;;;;;;EAM5B,CAAC;AACH,eAAO,MAAM,qBAAqB;;;;;EAKhC,CAAC;AACH,eAAO,MAAM,oBAAoB,aAAuC,CAAC;AACzE,eAAO,MAAM,kBAAkB,aAAmD,CAAC;AAEnF,eAAO,MAAM,wBAAwB;;;kBAGnC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;kBAGnC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;kBAwChC,CAAC;AAEL,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA6B5B,CAAC;AAEL,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC7D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACrE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACzE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;EAKoD,CAAC;AAEnF,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,WAAW,EACf,YAAY,EAAE,SAAS,eAAe,EAAE,GACvC,oBAAoB,CAAC,WAAW,EAAE,eAAe,CAAC,CAEpD;AAED,wBAAgB,4BAA4B,oDAK3C;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,QAAQ,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,SAAS,GAAG,WAAW,CAAC;IACvC,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC,GACD,iBAAiB,CAenB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,KAAK,CAGnE"}

package/dist/order.js

@@ -0,0 +1,132 @@
+import { z } from "zod";
+import { idempotencyKeySchema, pricedCartLineSchema } from "./cart.js";
+import { positiveIdentifierSchema, productSlugSchema } from "./catalog.js";
+import { guardLifecycleTransition, validateLifecycleTransitionTable, } from "./lifecycle.js";
+import { addMoney, currencyCodeSchema, moneySchema, multiplyMoney } from "./money.js";
+export const orderStatusSchema = z.enum([
+    "pending_payment",
+    "paid",
+    "processing",
+    "fulfilled",
+    "cancelled",
+]);
+export const orderCapabilitySchema = z.enum([
+    "order.cancel",
+    "order.process",
+    "order.fulfill",
+    "payment.succeed",
+]);
+export const orderReferenceSchema = z.string().regex(/^ORD-[0-9]{12}$/u);
+export const contactEmailSchema = z.string().trim().max(320).email().toLowerCase();
+export const orderCreateCommandSchema = z.strictObject({
+    contactEmail: contactEmailSchema,
+    idempotencyKey: idempotencyKeySchema,
+});
+export const orderCancelCommandSchema = z.strictObject({
+    idempotencyKey: idempotencyKeySchema,
+    reason: z.string().trim().min(1).max(240).default("Customer cancelled before payment."),
+});
+export const orderItemSnapshotSchema = z
+    .strictObject({
+    backorderedQuantity: z.number().int().safe().nonnegative(),
+    inventoryMode: z.enum(["tracked", "untracked"]),
+    lineTotal: moneySchema,
+    productName: z.string().trim().min(1).max(240),
+    productSlug: productSlugSchema,
+    quantity: z.number().int().safe().min(1).max(99),
+    reservedQuantity: z.number().int().safe().nonnegative(),
+    sku: z.string().trim().min(1).max(120).nullable(),
+    sourceVariantId: positiveIdentifierSchema,
+    unitPrice: moneySchema,
+    variantName: z.string().trim().min(1).max(160),
+})
+    .superRefine((item, context) => {
+    const allocatedQuantity = item.reservedQuantity + item.backorderedQuantity;
+    const invalidTrackedAllocation = item.inventoryMode === "tracked" &&
+        (!Number.isSafeInteger(allocatedQuantity) || allocatedQuantity !== item.quantity);
+    const invalidUntrackedAllocation = item.inventoryMode === "untracked" &&
+        (item.reservedQuantity !== 0 || item.backorderedQuantity !== 0);
+    if (invalidTrackedAllocation || invalidUntrackedAllocation) {
+        context.addIssue({ code: "custom", message: "Order allocation must equal item quantity." });
+    }
+    let expectedLineTotal;
+    try {
+        expectedLineTotal = multiplyMoney(item.unitPrice, item.quantity);
+    }
+    catch {
+        expectedLineTotal = undefined;
+    }
+    if (expectedLineTotal?.currency !== item.lineTotal.currency ||
+        expectedLineTotal.amountMinor !== item.lineTotal.amountMinor) {
+        context.addIssue({
+            code: "custom",
+            message: "Order line total must match its price snapshot.",
+        });
+    }
+});
+export const orderSnapshotSchema = z
+    .strictObject({
+    contactEmail: contactEmailSchema,
+    createdAt: z.string().datetime({ offset: true }),
+    currency: currencyCodeSchema,
+    id: positiveIdentifierSchema,
+    items: z.array(orderItemSnapshotSchema).min(1).max(100),
+    merchandiseSubtotal: moneySchema,
+    reference: orderReferenceSchema,
+    status: orderStatusSchema,
+})
+    .superRefine((order, context) => {
+    if (order.merchandiseSubtotal.currency !== order.currency) {
+        context.addIssue({ code: "custom", message: "Order currency and subtotal must match." });
+        return;
+    }
+    let total = { amountMinor: 0, currency: order.currency };
+    try {
+        for (const item of order.items)
+            total = addMoney(total, item.lineTotal);
+    }
+    catch {
+        context.addIssue({ code: "custom", message: "Order item currencies must match." });
+        return;
+    }
+    if (total.amountMinor !== order.merchandiseSubtotal.amountMinor) {
+        context.addIssue({
+            code: "custom",
+            message: "Order subtotal must equal its item snapshots.",
+        });
+    }
+});
+export const ORDER_TRANSITIONS = Object.freeze([
+    { capability: "order.cancel", from: "pending_payment", to: "cancelled" },
+    { capability: "payment.succeed", from: "pending_payment", to: "paid" },
+    { capability: "order.process", from: "paid", to: "processing" },
+    { capability: "order.fulfill", from: "processing", to: "fulfilled" },
+]);
+export function guardOrderTransition(from, to, capabilities) {
+    return guardLifecycleTransition(ORDER_TRANSITIONS, { capabilities, from, to });
+}
+export function validateOrderTransitionTable() {
+    return validateLifecycleTransitionTable(ORDER_TRANSITIONS, "pending_payment", [
+        "cancelled",
+        "fulfilled",
+    ]);
+}
+export function createOrderItemSnapshot(line, allocation) {
+    const parsedLine = pricedCartLineSchema.parse(line);
+    return Object.freeze(orderItemSnapshotSchema.parse({
+        ...allocation,
+        lineTotal: parsedLine.lineTotal,
+        productName: parsedLine.productName,
+        productSlug: parsedLine.productSlug,
+        quantity: parsedLine.quantity,
+        sku: parsedLine.sku,
+        sourceVariantId: parsedLine.variantId,
+        unitPrice: parsedLine.unitPrice,
+        variantName: parsedLine.variantName,
+    }));
+}
+export function verifyOrderLineTotal(item) {
+    const parsed = orderItemSnapshotSchema.parse(item);
+    return multiplyMoney(parsed.unitPrice, parsed.quantity);
+}
+//# sourceMappingURL=order.js.map

package/dist/order.js.map

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