@agenzo/merchant-cli 0.9.5 → 0.9.6

package/dist/index.js

@@ -910,6 +910,42 @@ function memberIdOf(opts) {
   return trimmed.length > 0 ? trimmed : void 0;
 }
 
+// src/price-annotation.ts
+var ORIGINAL_DESCRIPTION = "Original (pre-discount) price in integer cents. Optional, RECORD-ONLY: stored on our own order / charge record and echoed back in the order detail, never sent to the acquiring gateway and never used to derive or validate the amount charged (that always comes from the order's locked authoritative price).";
+var DISCOUNT_DESCRIPTION = "Discount amount in integer cents. Optional, RECORD-ONLY: same semantics as --original-amount-cents.";
+var PRICE_ANNOTATION_FLAGS = {
+  "original-amount-cents": {
+    type: "int",
+    required: false,
+    description: ORIGINAL_DESCRIPTION,
+    constraints: "non-negative integer cents"
+  },
+  "discount-amount-cents": {
+    type: "int",
+    required: false,
+    description: DISCOUNT_DESCRIPTION,
+    constraints: "non-negative integer cents"
+  }
+};
+function applyPriceAnnotation(body, opts) {
+  const mappings = [
+    ["--original-amount-cents", "originalAmountCents", "original_amount_cents"],
+    ["--discount-amount-cents", "discountAmountCents", "discount_amount_cents"]
+  ];
+  for (const [flag, optKey, bodyKey] of mappings) {
+    const raw = opts[optKey];
+    if (raw === void 0) continue;
+    const cents = Number(raw);
+    if (!Number.isInteger(cents) || cents < 0) {
+      throw new CliError(
+        "PARAM_INVALID",
+        `Invalid ${flag} "${raw}". Expected a non-negative integer number of cents (e.g. 10000 for 100.00).`
+      );
+    }
+    body[bodyKey] = cents;
+  }
+}
+
 // src/ride-elife/watch.ts
 var TERMINAL_STATUSES = /* @__PURE__ */ new Set([
   "At destination",
@@ -1250,7 +1286,8 @@ var ridePayOrderSchema = {
       type: "string",
       required: true,
       description: "Unique key (1-128 chars [A-Za-z0-9_-]) forwarded verbatim as the Idempotency-Key header; never auto-generated"
-    }
+    },
+    ...PRICE_ANNOTATION_FLAGS
   },
   response: {
     order_id: { type: "string", description: "Authoritative order_ref (rio_\u2026, = order document _id) that was settled" },
@@ -1851,6 +1888,7 @@ var hotelPayOrderSchema = {
       description: "Unique key forwarded verbatim as the Idempotency-Key header; never auto-generated. Derive from business intent (e.g. hash(order_id + attempt)) and reuse the SAME key when retrying the same payment",
       constraints: "1-128 chars [A-Za-z0-9_-]"
     },
+    ...PRICE_ANNOTATION_FLAGS,
     watch: { type: "bool", required: false, default: false, description: "Poll automatically on PAYMENT_NOT_COMPLETED until PAID or timeout. Each iteration emits one NDJSON line" },
     "watch-interval": { type: "int", required: false, default: 5, description: "Seconds between poll attempts in --watch mode" },
     "watch-timeout": { type: "int", required: false, default: 300, description: "Total seconds before giving up in --watch mode" }
@@ -2679,7 +2717,8 @@ var flightPayOrderSchema = flightSchema(
     "return-url": { type: "string", required: false, description: "Optional 3DS/passkey return URL for the network-token authenticate path; falls back to the platform EVO_3DS_RETURN_URL." },
     "authorized-charge-no": { type: "string", required: false, description: "Resume a network-token 3DS challenge: charge_no from a prior AUTHENTICATION_REQUIRED response (settled via resume_token), then triggers ticketing on success." },
     "evo-explicit": { type: "bool", required: false, default: false, description: "[\u65B9\u6848 B/R16] Explicit opt-in to settle this pay_per_call order via the EVO bound-card fallback rail. Set true ONLY when the user explicitly chose EVO; forwarded to the pay body as evo_explicit=true. Without it, a pay_per_call settlement lacking --payment-token-id is hard-gated server-side." },
-    "idempotency-key": { type: "string", required: true, description: "Forwarded verbatim as the Idempotency-Key header." }
+    "idempotency-key": { type: "string", required: true, description: "Forwarded verbatim as the Idempotency-Key header." },
+    ...PRICE_ANNOTATION_FLAGS
   },
   { order_no: { type: "string", description: "Our order reference." }, status: { type: "string", description: "PAID on success; AUTHENTICATION_REQUIRED when the card needs 3DS." } },
   { command: "agenzo-merchant-cli flight-flink pay-order --order-no ffo_... --idempotency-key k2", output_summary: "Order becomes PAID; poll get-order until TICKETED." }
@@ -2788,7 +2827,8 @@ var flightChangePaySchema = flightSchema(
     "payment-method-id": { type: "string", required: false, description: "Optional bound-card id (EVO path)." },
     "payment-token-id": { type: "string", required: false, description: "Optional UPI network-token id (unionpay charge path)." },
     "authorized-merchant-trans-id": { type: "string", required: false, description: "Resume a 3DS challenge with the merchant trans id of the already-authorised preauth; the platform reuses and captures it instead of authorizing again." },
-    "idempotency-key": { type: "string", required: true, description: "Idempotency-Key header." }
+    "idempotency-key": { type: "string", required: true, description: "Idempotency-Key header." },
+    ...PRICE_ANNOTATION_FLAGS
   },
   {
     change_order_no: { type: "string", description: "Change order number." },
@@ -3384,6 +3424,12 @@ function registerRidePayOrderCommand(parent, deps) {
   ).option(
     "--idempotency-key <key>",
     "Idempotency key forwarded verbatim as the Idempotency-Key header"
+  ).option(
+    "--original-amount-cents <cents>",
+    PRICE_ANNOTATION_FLAGS["original-amount-cents"].description
+  ).option(
+    "--discount-amount-cents <cents>",
+    PRICE_ANNOTATION_FLAGS["discount-amount-cents"].description
   );
   attachSchemaHelp(cmd, ridePayOrderSchema);
   cmd.action(async () => {
@@ -3411,6 +3457,7 @@ function registerRidePayOrderCommand(parent, deps) {
     if (opts.returnUrl !== void 0) body.return_url = opts.returnUrl;
     if (authorizedChargeNo !== void 0) body.authorized_charge_no = authorizedChargeNo;
     if (opts.evoExplicit) body.evo_explicit = true;
+    applyPriceAnnotation(body, opts);
     if (!isYes) {
       const confirmed = await confirm3({
         message: `Settle ride order ${orderId}? This charges the card and creates the ride (AWAITING_PAYMENT \u2192 PAID).`,
@@ -5408,7 +5455,7 @@ function registerHotelPayOrderCommand(parent, deps) {
   ).option(
     "--idempotency-key <key>",
     "Idempotency key forwarded verbatim as the Idempotency-Key header"
-  ).option("--watch", "Poll until PAID or timeout (NDJSON output)", false).option(
+  ).option("--original-amount-cents <cents>", PRICE_ANNOTATION_FLAGS["original-amount-cents"].description).option("--discount-amount-cents <cents>", PRICE_ANNOTATION_FLAGS["discount-amount-cents"].description).option("--watch", "Poll until PAID or timeout (NDJSON output)", false).option(
     "--watch-interval <seconds>",
     "Seconds between polls when --watch is set",
     String(DEFAULT_PAY_WATCH_INTERVAL_SECONDS)
@@ -5449,6 +5496,7 @@ function registerHotelPayOrderCommand(parent, deps) {
       body.authorized_charge_no = opts.authorizedChargeNo;
     }
     if (opts.evoExplicit) body.evo_explicit = true;
+    applyPriceAnnotation(body, opts);
     if (!isYes) {
       const confirmed = await confirm8({
         message: `Settle hotel order ${orderId}? This moves money via the order's configured billing mode (monthly_settlement or pay_per_call).`,
@@ -6865,7 +6913,13 @@ function registerPayOrderCommand(parent, deps) {
   ).option(
     "--evo-explicit",
     "[\u65B9\u6848 B/R16] Explicit opt-in to settle this pay_per_call order via the EVO bound-card fallback rail. Set ONLY when the user explicitly chose EVO; forwarded to the pay body as evo_explicit=true. Without it, a pay_per_call settlement lacking --payment-token-id is hard-gated server-side."
-  ).option("--idempotency-key <key>", "Forwarded verbatim as the Idempotency-Key header");
+  ).option("--idempotency-key <key>", "Forwarded verbatim as the Idempotency-Key header").option(
+    "--original-amount-cents <cents>",
+    PRICE_ANNOTATION_FLAGS["original-amount-cents"].description
+  ).option(
+    "--discount-amount-cents <cents>",
+    PRICE_ANNOTATION_FLAGS["discount-amount-cents"].description
+  );
   attachSchemaHelp(cmd, flightPayOrderSchema);
   cmd.action(async () => {
     const opts = cmd.optsWithGlobals();
@@ -6897,6 +6951,7 @@ function registerPayOrderCommand(parent, deps) {
       body.authorized_charge_no = opts.authorizedChargeNo;
     }
     if (opts.evoExplicit) body.evo_explicit = true;
+    applyPriceAnnotation(body, opts);
     const result = await deps.apiClient.post(
       `/flight/${encodeURIComponent(orderNo)}/pay`,
       { type: "api-key", key: apiKey },
@@ -7175,7 +7230,13 @@ function registerChangePayCommand(parent, deps) {
   const cmd = parent.command("change-pay").description("Pay a change request fee (like a normal order) and trigger change ticketing").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--change-order-no <id>", "Change order number").option("--order-no <id>", "Original order reference (ownership check)").option("--amount <amount>", "Change fee total in decimal units (change-detail price_total)").option("--currency <currency>", "ISO 4217 currency code", "USD").option("--payment-method-id <id>", "Optional bound-card id (EVO path)").option("--payment-token-id <id>", "Optional UPI network-token id (unionpay charge path)").option(
     "--authorized-merchant-trans-id <id>",
     "Resume a 3DS challenge: merchant trans id of the already-authorised preauth"
-  ).option("--idempotency-key <key>", "Forwarded verbatim as the Idempotency-Key header");
+  ).option("--idempotency-key <key>", "Forwarded verbatim as the Idempotency-Key header").option(
+    "--original-amount-cents <cents>",
+    PRICE_ANNOTATION_FLAGS["original-amount-cents"].description
+  ).option(
+    "--discount-amount-cents <cents>",
+    PRICE_ANNOTATION_FLAGS["discount-amount-cents"].description
+  );
   attachSchemaHelp(cmd, flightChangePaySchema);
   cmd.action(async () => {
     const opts = cmd.optsWithGlobals();
@@ -7196,6 +7257,7 @@ function registerChangePayCommand(parent, deps) {
     if (opts.authorizedMerchantTransId !== void 0) {
       body.authorized_merchant_trans_id = opts.authorizedMerchantTransId;
     }
+    applyPriceAnnotation(body, opts);
     if (!isYes) {
       const isResume = opts.authorizedMerchantTransId !== void 0;
       const message = isResume ? `Resume change fee ${amount} ${currency} for change order ${changeOrderNo}? The card is already authorised; this captures it and triggers change ticketing.` : `Pay change fee ${amount} ${currency} for change order ${changeOrderNo}? This charges the customer and triggers change ticketing.`;