@visa/cli 4.1.0-rc.160 → 4.1.0-rc.162

package/dist/checkout-engine/vic-confirmation.d.ts

@@ -12,11 +12,29 @@ export type PostVicConfirmation = (input: {
         transactionCurrencyCode: string;
     };
 }) => Promise<unknown>;
+/**
+ * Why a confirmation was not posted, as a BOUNDED value rather than prose.
+ *
+ * `reason` below is a human sentence built for the local receipt; it embeds
+ * upstream error text and is useless as an aggregate. These three codes are the
+ * whole space, and they mean very different things:
+ *
+ *  - `outcome_not_definitive` — the merchant never gave a definitive answer, so
+ *    there is nothing truthful to report. Expected, not a fault.
+ *  - `no_credential_minted` — no VIC credential existed for this run, so there
+ *    is no intent to confirm against. Expected, not a fault.
+ *  - `post_failed` — we HAD a definitive outcome and an intent to report it
+ *    against, and the POST did not land. This one is a fault: the processor
+ *    lifecycle row is never written, so the purchase can never rank above the
+ *    platform's own record no matter how well it actually went.
+ */
+export type VicConfirmationSkipCode = 'outcome_not_definitive' | 'no_credential_minted' | 'post_failed';
 export type VicConfirmationReport = {
     posted: true;
     transactionStatus: VicTransactionStatus;
 } | {
     posted: false;
+    code: VicConfirmationSkipCode;
     reason: string;
 };
 /** Definitive merchant answers map to a status; everything else maps to none. */

package/dist/checkout-engine/vic-confirmation.js

@@ -11,12 +11,17 @@ export async function reportVicOutcome(input) {
     if (!transactionStatus) {
         return {
             posted: false,
+            code: 'outcome_not_definitive',
             reason: `outcome '${input.outcome}' is not a definitive merchant answer — ` +
                 'resolve it with the merchant, then post the confirmation manually',
         };
     }
     if (!input.target) {
-        return { posted: false, reason: 'no VIC credential was minted in this run' };
+        return {
+            posted: false,
+            code: 'no_credential_minted',
+            reason: 'no VIC credential was minted in this run',
+        };
     }
     try {
         await input.post({
@@ -32,6 +37,7 @@ export async function reportVicOutcome(input) {
     catch (err) {
         return {
             posted: false,
+            code: 'post_failed',
             reason: `confirmation POST failed: ${err.message} — the merchant-reported outcome ` +
                 'remains unverified; retry the confirmation for this intent out-of-band',
         };