@porulle/plugin-channel-connector 0.70.2 → 0.72.0

package/dist/service.js

@@ -1,6 +1,6 @@
 import { createHash } from "node:crypto";
 import { z } from "zod";
-import { CommerceInvalidTransitionError, CommerceNotFoundError, CommerceValidationError, Ok, PluginErr, createTxContext, createSystemActor, linkFieldPaths, removeEntityLinks, writeEntityLinks, } from "@porulle/core";
+import { CHANNEL_OUT_OF_STOCK, CommerceInvalidTransitionError, CommerceNotFoundError, CommerceValidationError, Ok, PluginErr, createTxContext, createSystemActor, linkFieldPaths, removeEntityLinks, writeEntityLinks, } from "@porulle/core";
 import { isValidFieldPath, requireUserId } from "@porulle/core";
 import { CHANNEL_CONVERGENCE_CTX } from "./catalog-push-trigger.js";
 import { resolveLiveCredentials, withLiveCredentials } from "./live-credentials.js";
@@ -4452,7 +4452,14 @@ export class ChannelConnectorService {
             .where(and(eq(channelOrderExports.organizationId, orgId), eq(channelOrderExports.id, created.value.id)));
         const pushed = await connector.pushOrder(store, slice);
         if (!pushed.ok) {
-            return this.transitionExport(orgId, created.value.id, "failed", requireUserId(actor), pushed.error.message, pushed.error.retriable === true ? "transient" : "definitive");
+            const failed = await this.transitionExport(orgId, created.value.id, "failed", requireUserId(actor), pushed.error.message, pushed.error.retriable === true ? "transient" : "definitive");
+            if (pushed.error.code === CHANNEL_OUT_OF_STOCK) {
+                // The store has said nobody will send these goods: cancel, and let the host's cancel path
+                // refund the shopper. Any other refusal can be fixed and retried, so it waits for an operator.
+                const ordersService = this.services.orders;
+                await ordersService.changeStatus({ orderId: slice.orderId, newStatus: "cancelled", reason: "channel_out_of_stock" }, actor);
+            }
+            return failed;
         }
         await this.db
             .update(channelOrderExports)
@@ -4535,7 +4542,10 @@ export class ChannelConnectorService {
         const linesTotal = lines.reduce((sum, line) => sum + line.totalPrice, 0);
         // ponytail: a multi-store order sends no shipping to any store; apportion it when such orders exist.
         const shipping = selected.length === lineItems.length && order.shippingTotal > 0 ? { title: "Shipping", amount: order.shippingTotal } : null;
-        return Ok({ orderId, currency: order.currency, grandTotal: linesTotal + (shipping?.amount ?? 0), lines, ...(shipping ? { shipping } : {}), customer: { name, email, shippingAddress } });
+        // ponytail: like delivery, a discount is sent only with the whole order; apportion it when multi-store orders exist.
+        const discountCode = typeof metadata.promotionCode === "string" && metadata.promotionCode.trim() !== "" ? metadata.promotionCode.trim() : "DISCOUNT";
+        const discount = selected.length === lineItems.length && order.discountTotal > 0 ? { code: discountCode, amount: order.discountTotal } : null;
+        return Ok({ orderId, currency: order.currency, grandTotal: linesTotal + (shipping?.amount ?? 0) - (discount?.amount ?? 0), lines, ...(shipping ? { shipping } : {}), ...(discount ? { discount } : {}), customer: { name, email, shippingAddress } });
     }
     async reapExports(input) {
         const now = Date.now();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@porulle/plugin-channel-connector",
-  "version": "0.70.2",
+  "version": "0.72.0",
   "license": "MIT",
   "type": "module",
   "exports": {
@@ -22,15 +22,15 @@
   "dependencies": {
     "@hono/zod-openapi": "^1.2.2",
     "hono": "^4.12.5",
-    "@porulle/core": "0.70.2"
+    "@porulle/core": "0.72.0"
   },
   "devDependencies": {
     "@types/node": "^24.5.2",
     "eslint": "^9.39.1",
     "typescript": "5.9.2",
     "vitest": "^3.2.4",
-    "@porulle/eslint-config": "0.1.0",
-    "@porulle/typescript-config": "0.1.0"
+    "@porulle/typescript-config": "0.1.0",
+    "@porulle/eslint-config": "0.1.0"
   },
   "publishConfig": {
     "access": "public"

package/src/service.ts

@@ -1,6 +1,7 @@
 import { createHash } from "node:crypto";
 import { z } from "zod";
 import {
+  CHANNEL_OUT_OF_STOCK,
   CommerceInvalidTransitionError,
   CommerceNotFoundError,
   CommerceValidationError,
@@ -5613,7 +5614,7 @@ export class ChannelConnectorService {
 
     const pushed = await connector.pushOrder(store as ChannelStore, slice);
     if (!pushed.ok) {
-      return this.transitionExport(
+      const failed = await this.transitionExport(
         orgId,
         created.value.id,
         "failed",
@@ -5621,6 +5622,13 @@ export class ChannelConnectorService {
         pushed.error.message,
         pushed.error.retriable === true ? "transient" : "definitive",
       );
+      if (pushed.error.code === CHANNEL_OUT_OF_STOCK) {
+        // The store has said nobody will send these goods: cancel, and let the host's cancel path
+        // refund the shopper. Any other refusal can be fixed and retried, so it waits for an operator.
+        const ordersService = this.services.orders as { changeStatus(input: { orderId: string; newStatus: "cancelled"; reason: string }, actor: Actor): Promise<{ ok: boolean }> };
+        await ordersService.changeStatus({ orderId: slice.orderId, newStatus: "cancelled", reason: "channel_out_of_stock" }, actor);
+      }
+      return failed;
     }
 
     await this.db
@@ -5733,7 +5741,10 @@ export class ChannelConnectorService {
     const linesTotal = lines.reduce((sum, line) => sum + line.totalPrice, 0);
     // ponytail: a multi-store order sends no shipping to any store; apportion it when such orders exist.
     const shipping = selected.length === lineItems.length && order.shippingTotal > 0 ? { title: "Shipping", amount: order.shippingTotal } : null;
-    return Ok({ orderId, currency: order.currency, grandTotal: linesTotal + (shipping?.amount ?? 0), lines, ...(shipping ? { shipping } : {}), customer: { name, email, shippingAddress } });
+    // ponytail: like delivery, a discount is sent only with the whole order; apportion it when multi-store orders exist.
+    const discountCode = typeof metadata.promotionCode === "string" && metadata.promotionCode.trim() !== "" ? metadata.promotionCode.trim() : "DISCOUNT";
+    const discount = selected.length === lineItems.length && order.discountTotal > 0 ? { code: discountCode, amount: order.discountTotal } : null;
+    return Ok({ orderId, currency: order.currency, grandTotal: linesTotal + (shipping?.amount ?? 0) - (discount?.amount ?? 0), lines, ...(shipping ? { shipping } : {}), ...(discount ? { discount } : {}), customer: { name, email, shippingAddress } });
   }
 
   async reapExports(input: { definitiveMs: number; transientMs: number }): Promise<{ abandonedCount: number; refundedOrderIds: string[] }> {