cabloy 5.1.112 → 5.1.114

package/vona/src/suite/a-commerce/modules/commerce-trade/src/service/order.ts

@@ -0,0 +1,556 @@
+import type { TableIdentity } from 'table-identity';
+
+import { BeanBase } from 'vona';
+import { Service } from 'vona-module-a-bean';
+import { Core } from 'vona-module-a-core';
+
+import type { DtoCheckoutCreate } from '../dto/checkoutCreate.tsx';
+import type { DtoCheckoutResult } from '../dto/checkoutResult.tsx';
+import type { DtoOrderAddressSnapshot } from '../dto/orderAddressSnapshot.tsx';
+import type { DtoOrderCouponSnapshot } from '../dto/orderCouponSnapshot.tsx';
+import type { DtoOrderLineSkuAttributeSnapshot } from '../dto/orderLineSkuAttributeSnapshot.tsx';
+import type { EntityOrder } from '../entity/order.tsx';
+import type { EntityOrderLine } from '../entity/orderLine.tsx';
+
+const maxOrderCents = 2_147_483_647;
+
+const serializationRetryOptions = {
+  retries: 1,
+  factor: 1,
+  minTimeout: 0,
+  maxTimeout: 0,
+  randomize: false,
+  errorCodes: ['40001'],
+};
+
+export interface IOrderSnapshotLineCommand {
+  skuId: TableIdentity;
+  quantity: number;
+}
+
+export interface IOrderSnapshotCreateCommand {
+  addressId: TableIdentity;
+  correlationId: string;
+  couponGrantId?: TableIdentity;
+  lines: IOrderSnapshotLineCommand[];
+}
+
+export interface IOrderSnapshotCreateResult {
+  order: EntityOrder;
+  lines: EntityOrderLine[];
+}
+
+interface IPreparedOrderLine {
+  index: number;
+  skuId: TableIdentity;
+  productId: TableIdentity;
+  skuCodeSnapshot: string;
+  titleSnapshot: string;
+  skuAttributesSnapshot: DtoOrderLineSkuAttributeSnapshot[];
+  unitPriceCents: number;
+  quantity: number;
+  eligibleSubtotalCents: number;
+}
+
+@Service()
+export class ServiceOrder extends BeanBase {
+  @Core.transaction({ isolationLevel: 'SERIALIZABLE' })
+  @Core.retryable(serializationRetryOptions)
+  async createSnapshot(command: IOrderSnapshotCreateCommand): Promise<IOrderSnapshotCreateResult> {
+    this._assertCommand(command);
+
+    const existingOrder = await this.scope.model.order.getForUpdate({
+      userId: this.bean.passport.currentUser!.id,
+      correlationId: command.correlationId,
+    });
+    if (existingOrder) {
+      await this._assertExistingSnapshotMatchesCommand(existingOrder, command);
+      return (await this._viewSnapshot(existingOrder))!;
+    }
+
+    const address = await this.$scope.commerceMember.model.address.get({
+      id: command.addressId,
+      userId: this.bean.passport.currentUser!.id,
+    });
+    if (!address) {
+      this.app.throw(404, 'Address not found');
+    }
+
+    const preparedLines = await Promise.all(
+      command.lines.map((line, index) => this._prepareLine(line, index)),
+    );
+    const eligibleSubtotalCents = preparedLines.reduce((total, line) => {
+      const nextTotal = total + line.eligibleSubtotalCents;
+      if (!Number.isSafeInteger(nextTotal) || nextTotal > maxOrderCents) {
+        this.app.throw(400, 'order total exceeds the supported range');
+      }
+      return nextTotal;
+    }, 0);
+    const order = await this.scope.model.order.insert({
+      userId: this.bean.passport.currentUser!.id,
+      addressId: address.id,
+      correlationId: command.correlationId,
+      addressSnapshot: this._toAddressSnapshot(address),
+      state: 'awaiting_payment',
+      currency: 'USD',
+      eligibleSubtotalCents,
+      discountCents: 0,
+      payableTotalCents: eligibleSubtotalCents,
+      reservationExpiresAt: new Date(Date.now() + 30 * 60 * 1000),
+    });
+    let couponSnapshot: DtoOrderCouponSnapshot | undefined;
+    if (command.couponGrantId) {
+      const reservation = await this.$scope.commercePromotion.service.coupon.reserve({
+        couponGrantId: command.couponGrantId,
+        userId: this.bean.passport.currentUser!.id,
+        orderId: order.id,
+        eligibleSubtotalCents,
+        currency: 'USD',
+        correlationId: `${command.correlationId}:coupon`,
+        reason: 'order snapshot created',
+      });
+      const couponGrant = reservation.couponGrant;
+      couponSnapshot = {
+        couponGrantId: couponGrant.id,
+        couponTemplateId: couponGrant.templateId,
+        couponCode: couponGrant.couponCode,
+        templateName: couponGrant.templateNameSnapshot,
+        currency: couponGrant.currencySnapshot,
+        fixedDiscountCents: couponGrant.discountCentsSnapshot,
+        minSpendCents: couponGrant.minSpendCentsSnapshot,
+        appliedDiscountCents: reservation.discountCents,
+      };
+      await this.scope.model.order.updateById(order.id, {
+        couponSnapshot,
+        discountCents: reservation.discountCents,
+        payableTotalCents: eligibleSubtotalCents - reservation.discountCents,
+      });
+      order.couponSnapshot = couponSnapshot;
+      order.discountCents = reservation.discountCents;
+      order.payableTotalCents = eligibleSubtotalCents - reservation.discountCents;
+    }
+    const lines = await Promise.all(
+      preparedLines.map(async line => {
+        const orderLine = await this.scope.model.orderLine.insert({
+          orderId: order.id,
+          skuId: line.skuId,
+          productId: line.productId,
+          skuCodeSnapshot: line.skuCodeSnapshot,
+          titleSnapshot: line.titleSnapshot,
+          skuAttributesSnapshot: line.skuAttributesSnapshot,
+          unitPriceCents: line.unitPriceCents,
+          quantity: line.quantity,
+          eligibleSubtotalCents: line.eligibleSubtotalCents,
+          lineTotalCents: line.eligibleSubtotalCents,
+        });
+        await this.scope.service.stockBalance.reserve({
+          skuId: orderLine.skuId,
+          orderLineId: orderLine.id,
+          quantity: orderLine.quantity,
+          correlationId: `${command.correlationId}:line:${line.index}`,
+          reason: 'order snapshot created',
+        });
+        return orderLine;
+      }),
+    );
+    return { order, lines };
+  }
+
+  @Core.transaction({ isolationLevel: 'SERIALIZABLE' })
+  @Core.retryable(serializationRetryOptions)
+  async checkout(command: DtoCheckoutCreate): Promise<DtoCheckoutResult> {
+    this._assertCheckoutCommand(command);
+    const userId = this.bean.passport.currentUser!.id;
+    const existingOrder = await this.scope.model.order.getForUpdate({
+      userId,
+      correlationId: command.correlationId,
+    });
+    if (existingOrder) {
+      if (
+        String(existingOrder.addressId) !== String(command.addressId) ||
+        String(existingOrder.couponSnapshot?.couponGrantId ?? '') !==
+          String(command.couponGrantId ?? '')
+      ) {
+        this.app.throw(409, 'checkout correlation conflicts with an existing order');
+      }
+      return await this._checkoutResult(existingOrder);
+    }
+
+    const cart = await this.scope.model.cart.getForUpdate({ userId });
+    if (!cart) this.app.throw(409, 'cart is empty');
+    const cartItems = await this.scope.model.cartItem.select({
+      where: { cartId: cart.id },
+      orders: [['skuId', 'asc']],
+    });
+    if (cartItems.length === 0) this.app.throw(409, 'cart is empty');
+
+    const lockedCartItems: typeof cartItems = [];
+    for (const item of cartItems) {
+      const lockedItem = await this.scope.model.cartItem.getByIdForUpdate(item.id);
+      if (lockedItem && String(lockedItem.cartId) === String(cart.id))
+        lockedCartItems.push(lockedItem);
+    }
+    if (lockedCartItems.length === 0) this.app.throw(409, 'cart is empty');
+
+    const preparedLines: IPreparedOrderLine[] = [];
+    for (const [index, item] of lockedCartItems.entries()) {
+      preparedLines.push(
+        await this._prepareLine({ skuId: item.skuId, quantity: item.quantity }, index),
+      );
+    }
+    const address = await this.$scope.commerceMember.model.address.get({
+      id: command.addressId,
+      userId,
+    });
+    if (!address) this.app.throw(404, 'Address not found');
+
+    const { order } = await this._createOrder({
+      userId,
+      address,
+      correlationId: command.correlationId,
+      couponGrantId: command.couponGrantId,
+      preparedLines,
+      reason: 'checkout created',
+    });
+    const paymentAttempt = await this.$scope.commercePayment.service.paymentAttempt.create({
+      orderId: order.id,
+      userId,
+      currency: order.currency,
+      amountCents: order.payableTotalCents,
+      correlationId: `${command.correlationId}:payment`,
+    });
+    await this._appendAudit({
+      orderId: order.id,
+      operation: 'created',
+      toState: 'awaiting_payment',
+      correlationId: command.correlationId,
+      reason: 'checkout created',
+    });
+    for (const item of lockedCartItems) {
+      await this.scope.model.cartItem.deleteById(item.id);
+    }
+    return {
+      orderId: order.id,
+      paymentAttemptId: paymentAttempt.id,
+      state: 'awaiting_payment',
+      paymentAttemptState: 'created',
+      currency: order.currency,
+      payableTotalCents: order.payableTotalCents,
+      reservationExpiresAt: order.reservationExpiresAt,
+    };
+  }
+
+  @Core.transaction({ isolationLevel: 'SERIALIZABLE' })
+  @Core.retryable(serializationRetryOptions)
+  async expireIfDue(orderId: TableIdentity, now = new Date()): Promise<boolean> {
+    const order = await this.scope.model.order.getByIdForUpdate(orderId);
+    if (!order || order.state !== 'awaiting_payment' || order.reservationExpiresAt > now)
+      return false;
+
+    if (order.couponSnapshot) {
+      await this.$scope.commercePromotion.service.coupon.release({
+        couponGrantId: order.couponSnapshot.couponGrantId,
+        orderId: order.id,
+        correlationId: `${order.correlationId}:expiry:coupon`,
+        reason: 'unpaid order expired',
+      });
+    }
+    const lines = await this.scope.model.orderLine.select({
+      where: { orderId: order.id },
+      orders: [['skuId', 'asc']],
+    });
+    for (const line of lines) {
+      const reservation = await this.scope.model.stockReservation.get({ orderLineId: line.id });
+      if (reservation) {
+        await this.scope.service.stockBalance.release({
+          reservationId: reservation.id,
+          reason: 'unpaid order expired',
+        });
+      }
+    }
+    await this.$scope.commercePayment.service.paymentAttempt.cancel(order.id);
+    await this.scope.model.order.updateById(order.id, { state: 'expired' });
+    await this._appendAudit({
+      orderId: order.id,
+      operation: 'expired',
+      fromState: 'awaiting_payment',
+      toState: 'expired',
+      correlationId: `${order.correlationId}:expiry`,
+      reason: 'unpaid order expired',
+    });
+    return true;
+  }
+
+  async viewSnapshot(id: TableIdentity): Promise<IOrderSnapshotCreateResult | undefined> {
+    const order = await this.scope.model.order.get({
+      id,
+      userId: this.bean.passport.currentUser!.id,
+    });
+    if (!order) return undefined;
+    return await this._viewSnapshot(order);
+  }
+
+  private async _checkoutResult(order: EntityOrder): Promise<DtoCheckoutResult> {
+    const paymentAttempt = await this.$scope.commercePayment.model.paymentAttempt.get({
+      orderId: order.id,
+    });
+    if (!paymentAttempt || paymentAttempt.state !== 'created') {
+      this.app.throw(409, 'checkout payment attempt is no longer available');
+    }
+    return {
+      orderId: order.id,
+      paymentAttemptId: paymentAttempt.id,
+      state: 'awaiting_payment',
+      paymentAttemptState: 'created',
+      currency: order.currency,
+      payableTotalCents: order.payableTotalCents,
+      reservationExpiresAt: order.reservationExpiresAt,
+    };
+  }
+
+  private async _createOrder({
+    userId,
+    address,
+    correlationId,
+    couponGrantId,
+    preparedLines,
+    reason,
+  }: {
+    userId: TableIdentity;
+    address: {
+      id: TableIdentity;
+      recipientName: string;
+      phone: string;
+      countryCode: string;
+      region: string;
+      city: string;
+      postalCode: string;
+      addressLine1: string;
+      addressLine2?: string;
+    };
+    correlationId: string;
+    couponGrantId?: TableIdentity;
+    preparedLines: IPreparedOrderLine[];
+    reason: string;
+  }): Promise<IOrderSnapshotCreateResult> {
+    const eligibleSubtotalCents = preparedLines.reduce((total, line) => {
+      const nextTotal = total + line.eligibleSubtotalCents;
+      if (!Number.isSafeInteger(nextTotal) || nextTotal > maxOrderCents) {
+        this.app.throw(400, 'order total exceeds the supported range');
+      }
+      return nextTotal;
+    }, 0);
+    const order = await this.scope.model.order.insert({
+      userId,
+      addressId: address.id,
+      correlationId,
+      addressSnapshot: this._toAddressSnapshot(address),
+      state: 'awaiting_payment',
+      currency: 'USD',
+      eligibleSubtotalCents,
+      discountCents: 0,
+      payableTotalCents: eligibleSubtotalCents,
+      reservationExpiresAt: new Date(Date.now() + 30 * 60 * 1000),
+    });
+    if (couponGrantId) {
+      const reservation = await this.$scope.commercePromotion.service.coupon.reserve({
+        couponGrantId,
+        userId,
+        orderId: order.id,
+        eligibleSubtotalCents,
+        currency: 'USD',
+        correlationId: `${correlationId}:coupon`,
+        reason,
+      });
+      const couponGrant = reservation.couponGrant;
+      const couponSnapshot: DtoOrderCouponSnapshot = {
+        couponGrantId: couponGrant.id,
+        couponTemplateId: couponGrant.templateId,
+        couponCode: couponGrant.couponCode,
+        templateName: couponGrant.templateNameSnapshot,
+        currency: couponGrant.currencySnapshot,
+        fixedDiscountCents: couponGrant.discountCentsSnapshot,
+        minSpendCents: couponGrant.minSpendCentsSnapshot,
+        appliedDiscountCents: reservation.discountCents,
+      };
+      await this.scope.model.order.updateById(order.id, {
+        couponSnapshot,
+        discountCents: reservation.discountCents,
+        payableTotalCents: eligibleSubtotalCents - reservation.discountCents,
+      });
+      order.couponSnapshot = couponSnapshot;
+      order.discountCents = reservation.discountCents;
+      order.payableTotalCents = eligibleSubtotalCents - reservation.discountCents;
+    }
+    const lines: EntityOrderLine[] = [];
+    for (const line of preparedLines) {
+      const orderLine = await this.scope.model.orderLine.insert({
+        orderId: order.id,
+        skuId: line.skuId,
+        productId: line.productId,
+        skuCodeSnapshot: line.skuCodeSnapshot,
+        titleSnapshot: line.titleSnapshot,
+        skuAttributesSnapshot: line.skuAttributesSnapshot,
+        unitPriceCents: line.unitPriceCents,
+        quantity: line.quantity,
+        eligibleSubtotalCents: line.eligibleSubtotalCents,
+        lineTotalCents: line.eligibleSubtotalCents,
+      });
+      await this.scope.service.stockBalance.reserve({
+        skuId: orderLine.skuId,
+        orderLineId: orderLine.id,
+        quantity: orderLine.quantity,
+        correlationId: `${correlationId}:line:${line.index}`,
+        reason,
+      });
+      lines.push(orderLine);
+    }
+    return { order, lines };
+  }
+
+  private async _appendAudit({
+    orderId,
+    operation,
+    fromState,
+    toState,
+    correlationId,
+    reason,
+  }: {
+    orderId: TableIdentity;
+    operation: 'created' | 'expired';
+    fromState?: 'awaiting_payment' | 'expired';
+    toState: 'awaiting_payment' | 'expired';
+    correlationId: string;
+    reason: string;
+  }) {
+    await this.scope.model.orderAudit.insert({
+      orderId,
+      operation,
+      fromState,
+      toState,
+      actorId: this.bean.passport.currentUser?.anonymous
+        ? undefined
+        : this.bean.passport.currentUser?.id,
+      correlationId,
+      reason,
+    });
+  }
+
+  private async _viewSnapshot(order: EntityOrder): Promise<IOrderSnapshotCreateResult> {
+    const lines = await this.scope.model.orderLine.select({
+      where: { orderId: order.id },
+      orders: [['id', 'asc']],
+    });
+    return { order, lines };
+  }
+
+  private async _assertExistingSnapshotMatchesCommand(
+    order: EntityOrder,
+    command: IOrderSnapshotCreateCommand,
+  ) {
+    const lines = await this.scope.model.orderLine.select({
+      where: { orderId: order.id },
+      orders: [['id', 'asc']],
+    });
+    if (
+      String(order.addressId) !== String(command.addressId) ||
+      String(order.couponSnapshot?.couponGrantId ?? '') !== String(command.couponGrantId ?? '') ||
+      lines.length !== command.lines.length ||
+      lines.some(
+        (line, index) =>
+          String(line.skuId) !== String(command.lines[index].skuId) ||
+          line.quantity !== command.lines[index].quantity,
+      )
+    ) {
+      this.app.throw(409, 'order snapshot correlation conflicts with an existing order');
+    }
+  }
+
+  private async _prepareLine(command: IOrderSnapshotLineCommand, index = 0) {
+    if (!Number.isInteger(command.quantity) || command.quantity <= 0) {
+      this.app.throw(400, 'order line quantity must be a positive integer');
+    }
+    const sku = await this.$scope.commerceCatalog.model.sku.getById(command.skuId, {
+      include: {
+        product: {
+          include: {
+            category: true,
+          },
+        },
+      },
+    });
+    if (!sku || sku.lifecycle !== 'active') {
+      this.app.throw(404, 'SKU not found');
+    }
+    if (!sku.product?.published || !sku.product.category?.published) {
+      this.app.throw(409, 'SKU is not sellable');
+    }
+    const eligibleSubtotalCents = sku.priceCents * command.quantity;
+    if (!Number.isSafeInteger(eligibleSubtotalCents) || eligibleSubtotalCents > maxOrderCents) {
+      this.app.throw(400, 'order line total exceeds the supported range');
+    }
+    return {
+      index,
+      skuId: sku.id,
+      productId: sku.product.id,
+      skuCodeSnapshot: sku.code,
+      titleSnapshot: sku.product.title,
+      skuAttributesSnapshot: sku.attributes.map(
+        attribute =>
+          ({
+            name: attribute.name,
+            value: attribute.value,
+          }) satisfies DtoOrderLineSkuAttributeSnapshot,
+      ),
+      unitPriceCents: sku.priceCents,
+      quantity: command.quantity,
+      eligibleSubtotalCents,
+    };
+  }
+
+  private _toAddressSnapshot(address: {
+    recipientName: string;
+    phone: string;
+    countryCode: string;
+    region: string;
+    city: string;
+    postalCode: string;
+    addressLine1: string;
+    addressLine2?: string;
+  }): DtoOrderAddressSnapshot {
+    return {
+      recipientName: address.recipientName,
+      phone: address.phone,
+      countryCode: address.countryCode,
+      region: address.region,
+      city: address.city,
+      postalCode: address.postalCode,
+      addressLine1: address.addressLine1,
+      addressLine2: address.addressLine2,
+    };
+  }
+
+  private _assertCheckoutCommand(command: DtoCheckoutCreate) {
+    if (!command.correlationId.trim()) {
+      this.app.throw(400, 'checkout correlationId is required');
+    }
+    if (command.correlationId.length > 80) {
+      this.app.throw(400, 'checkout correlationId is too long');
+    }
+  }
+
+  private _assertCommand(command: IOrderSnapshotCreateCommand) {
+    if (!command.correlationId.trim()) {
+      this.app.throw(400, 'order snapshot correlationId is required');
+    }
+    if (command.correlationId.length > 70) {
+      this.app.throw(400, 'order snapshot correlationId is too long');
+    }
+    if (command.lines.length === 0) {
+      this.app.throw(400, 'order snapshot requires at least one line');
+    }
+    if (new Set(command.lines.map(line => String(line.skuId))).size !== command.lines.length) {
+      this.app.throw(400, 'order snapshot cannot contain duplicate SKUs');
+    }
+  }
+}

package/vona/src/suite/a-commerce/modules/commerce-trade/src/service/stockBalance.ts

@@ -17,6 +17,7 @@ import type { ModelStockBalance } from '../model/stockBalance.ts';
 
 export interface IStockReservationCommand {
   skuId: TableIdentity;
+  orderLineId?: TableIdentity;
   quantity: number;
   correlationId: string;
   reason: string;
@@ -27,6 +28,16 @@ export interface IStockReservationTransition {
   reason: string;
 }
 
+const serializationRetryOptions = {
+  retries: 1,
+  factor: 1,
+  minTimeout: 0,
+  maxTimeout: 0,
+  randomize: false,
+  errorCodes: ['40001'],
+  ownerOnly: true,
+};
+
 @Service()
 export class ServiceStockBalance extends BeanBase {
   async select(params?: IQueryParams<ModelStockBalance>): Promise<DtoStockBalanceSelectRes> {
@@ -47,6 +58,11 @@ export class ServiceStockBalance extends BeanBase {
     let stockBalance = await this.scope.model.stockBalance.getForUpdate({
       skuId: stockAdjust.skuId,
     });
+    const priorBalance = stockBalance ?? {
+      onHand: 0,
+      reserved: 0,
+      available: 0,
+    };
     if (!stockBalance) {
       if (stockAdjust.delta < 0) {
         throw new Error('stock adjustment would make balance negative');
@@ -79,6 +95,7 @@ export class ServiceStockBalance extends BeanBase {
 
     await this._appendAudit({
       stockBalance,
+      priorBalance,
       delta: stockAdjust.delta,
       operation: 'adjust',
       reason: stockAdjust.reason,
@@ -88,6 +105,7 @@ export class ServiceStockBalance extends BeanBase {
   }
 
   @Core.transaction({ isolationLevel: 'SERIALIZABLE' })
+  @Core.retryable(serializationRetryOptions)
   async reserve(command: IStockReservationCommand): Promise<EntityStockReservation> {
     this._assertReservationCommand(command);
     const sku = await this.$scope.commerceCatalog.model.sku.getById(command.skuId, {
@@ -116,6 +134,7 @@ export class ServiceStockBalance extends BeanBase {
     if (existingReservation) {
       if (
         String(existingReservation.skuId) !== String(command.skuId) ||
+        String(existingReservation.orderLineId ?? '') !== String(command.orderLineId ?? '') ||
         existingReservation.quantity !== command.quantity
       ) {
         this.app.throw(409, 'stock reservation correlation conflicts with an existing reservation');
@@ -129,16 +148,19 @@ export class ServiceStockBalance extends BeanBase {
     const reservation = await this.scope.model.stockReservation.insert({
       stockBalanceId: stockBalance.id,
       skuId: command.skuId,
+      orderLineId: command.orderLineId,
       quantity: command.quantity,
       state: 'reserved',
       correlationId: command.correlationId,
     });
+    const priorBalance = stockBalance;
     const updatedBalance = await this._updateBalance(stockBalance, {
       onHand: stockBalance.onHand,
       reserved: stockBalance.reserved + command.quantity,
     });
     await this._appendAudit({
       stockBalance: updatedBalance,
+      priorBalance,
       stockReservationId: reservation.id,
       delta: -command.quantity,
       operation: 'reserve',
@@ -218,6 +240,7 @@ export class ServiceStockBalance extends BeanBase {
     if (!stockBalance) {
       this.app.throw(404, 'stock balance not found');
     }
+    const priorBalance = stockBalance;
     const updatedBalance = await this._updateBalance(
       stockBalance,
       calculateBalance(stockBalance, reservation),
@@ -228,6 +251,7 @@ export class ServiceStockBalance extends BeanBase {
       targetState === 'consumed' ? 'consume' : targetState === 'released' ? 'release' : 'restore';
     await this._appendAudit({
       stockBalance: updatedBalance,
+      priorBalance,
       stockReservationId: reservation.id,
       delta:
         operation === 'consume'
@@ -264,6 +288,7 @@ export class ServiceStockBalance extends BeanBase {
 
   private async _appendAudit({
     stockBalance,
+    priorBalance,
     stockReservationId,
     delta,
     operation,
@@ -271,6 +296,7 @@ export class ServiceStockBalance extends BeanBase {
     correlationId,
   }: {
     stockBalance: EntityStockBalance;
+    priorBalance: Pick<EntityStockBalance, 'onHand' | 'reserved' | 'available'>;
     stockReservationId?: TableIdentity;
     delta: number;
     operation: 'adjust' | 'reserve' | 'consume' | 'release' | 'restore';
@@ -281,10 +307,16 @@ export class ServiceStockBalance extends BeanBase {
       stockBalanceId: stockBalance.id,
       skuId: stockBalance.skuId,
       stockReservationId,
+      actorId: this.bean.passport.currentUser?.anonymous
+        ? undefined
+        : this.bean.passport.currentUser?.id,
       operation,
       delta,
       reason,
       correlationId,
+      priorOnHand: priorBalance.onHand,
+      priorReserved: priorBalance.reserved,
+      priorAvailable: priorBalance.available,
       onHand: stockBalance.onHand,
       reserved: stockBalance.reserved,
       available: stockBalance.available,