@visa/cli 4.1.0-rc.252 → 4.1.0-rc.254

package/dist/checkout-engine/cli-engine.d.ts

@@ -42,6 +42,11 @@ export type CliReviewInput = {
     cardLast4?: string;
     contact: Contact;
     approvalBaseUrl: string;
+    /**
+     * #8047: agent-authored purchase narrative captured at review time and
+     * replayed into the card draw's Transaction Intent Journal at pay time.
+     */
+    intentNarrative?: CardIntentNarrative;
     merchantName?: string;
     merchantCountryCode?: string;
     trustedMerchantIdentity?: Readonly<{
@@ -199,8 +204,24 @@ type Session = {
     currency: string;
     contact: Contact;
     agentJkt?: string;
+    /** #8047: narrative for this review's journal, carried review -> pay. */
+    intentNarrative?: CardIntentNarrative;
     cleanupTimer: ReturnType<typeof setTimeout>;
 };
+/**
+ * #8047 Transaction Intent Journal narrative — the agent-authored half of the
+ * journal. Structural mirror of the CLI card client's `CardIntentNarrative`;
+ * the engine only threads it through and never interprets it.
+ */
+export interface CardIntentNarrative {
+    userRequest: string;
+    product: string;
+    purpose?: string;
+    quantity?: number;
+    expectedResult?: string;
+    recurring?: boolean;
+    userIntentSalt?: string;
+}
 export interface CardDrawVerdictDraw {
     tokenId: string;
     amount: string;
@@ -227,6 +248,8 @@ export interface CardDrawVerdictSeam {
         mandateId: string;
         drawId: string;
         draw: CardDrawVerdictDraw;
+        /** #8047: narrative the client turns into the draw's journal sidecar. */
+        intentNarrative?: CardIntentNarrative;
     }) => Promise<{
         verdict: string;
         remainingCents: number;

package/dist/checkout-engine/cli-engine.js

@@ -641,6 +641,7 @@ export function createCliCheckoutEngine(deps = {}) {
                     currency: input.currency,
                     contact: input.contact,
                     ...(input.agentJkt ? { agentJkt: input.agentJkt } : {}),
+                    ...(input.intentNarrative ? { intentNarrative: input.intentNarrative } : {}),
                     cleanupTimer,
                 });
                 return {
@@ -945,6 +946,9 @@ export function createCliCheckoutEngine(deps = {}) {
                                             merchantUrl: session.target.merchantUrl,
                                             merchantCountryCode: session.target.merchantCountryCode,
                                         },
+                                        ...(session.intentNarrative
+                                            ? { intentNarrative: session.intentNarrative }
+                                            : {}),
                                     });
                                     confirmationAuthority = verdict;
                                     return fetchMandateCryptogram(confirmBase, verdict, i);