@veruna/api-contracts 19.1.0 → 20.1.0

package/build-esm/v1/payment/commands/create-order.command.js

@@ -1,6 +1,15 @@
 import { z } from 'zod';
 import { UUID_REGEX, BIGINT_STRING_REGEX } from '../../../shared';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Create a new Order (server-side anti-tamper purchase record).
+ * Called by subscription services before redirecting user to CloudPayments widget.
+ * Amount, grantedBalance, entitlements are server-computed and snapshotted here.
+ *
+ * Internal cross-module command: subscription → payment.
+ * Handler owns 1 repository: OrderRepository.
+ * No HTTP endpoint — invoked only via TypedCommandBus.
+ */
 export var CreateOrderCommand;
 (function (CreateOrderCommand) {
     CreateOrderCommand.Request = z.object({
@@ -8,24 +17,31 @@ export var CreateOrderCommand;
             .string({ error: 'CreateOrderCommand.userId.required' })
             .regex(UUID_REGEX, { message: 'CreateOrderCommand.userId.invalid' }),
         kind: z.string({ error: 'CreateOrderCommand.kind.required' }),
+        /** Order amount as integer string (BigInt, ×100 of RUB). */
         amount: z
             .string({ error: 'CreateOrderCommand.amount.required' })
             .regex(BIGINT_STRING_REGEX, { message: 'CreateOrderCommand.amount.invalid' }),
         currency: z
             .string({ error: 'CreateOrderCommand.currency.required' })
             .length(3, { message: 'CreateOrderCommand.currency.length' }),
+        /** Human-readable description shown to user in payment widget. */
         description: z.string({ error: 'CreateOrderCommand.description.required' }).min(1),
+        /** Granted balance as integer string (BigInt, ×100 of RUB; server-computed). */
         grantedBalance: z
             .string({ error: 'CreateOrderCommand.grantedBalance.required' })
             .regex(BIGINT_STRING_REGEX, { message: 'CreateOrderCommand.grantedBalance.invalid' }),
+        /** Entitlements snapshot (JSON — server-computed from plan at time of order). */
         entitlements: z.record(z.string(), z.unknown()),
+        /** UUIDv5 idempotency key — deterministic from order parameters. */
         idempotencyKey: z
             .string({ error: 'CreateOrderCommand.idempotencyKey.required' })
             .regex(UUID_REGEX, { message: 'CreateOrderCommand.idempotencyKey.invalid' }),
+        /** Order TTL in milliseconds from now. */
         ttlMs: z.number({ error: 'CreateOrderCommand.ttlMs.required' }).int().positive(),
         subscriptionId: z.string().regex(UUID_REGEX).nullable().optional(),
         planId: z.string().regex(UUID_REGEX).nullable().optional(),
         periodMonths: z.number().int().positive().nullable().optional(),
+        /** Custom price as BigInt string (internal units). */
         customPrice: z
             .string()
             .regex(BIGINT_STRING_REGEX)

package/build-esm/v1/payment/commands/create-order.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-order.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/create-order.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAW9D,MAAM,KAAW,kBAAkB,CA8ClC;AA9CD,WAAiB,kBAAkB;IAClB,0BAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;aACvD,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;QACxE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;QAE7D,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;aACvD,KAAK,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;QACjF,QAAQ,EAAE,CAAC;aACN,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;aACzD,MAAM,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;QAEjE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAElF,cAAc,EAAE,CAAC;aACZ,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;aAC/D,KAAK,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;QAEzF,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAE/C,cAAc,EAAE,CAAC;aACZ,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;aAC/D,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;QAEhF,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QAChF,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAClE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAC1D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAE/D,WAAW,EAAE,CAAC;aACT,MAAM,EAAE;aACR,KAAK,CAAC,mBAAmB,CAAC;aAC1B,QAAQ,EAAE;aACV,QAAQ,EAAE;KAClB,CAAC,CAAC;IAEU,2BAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;QAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;KACxC,CAAC,CAAC;IAEU,yBAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EA9CgB,kBAAkB,KAAlB,kBAAkB,QA8ClC"}
+{"version":3,"file":"create-order.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/create-order.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D;;;;;;;;GAQG;AACH,MAAM,KAAW,kBAAkB,CA8ClC;AA9CD,WAAiB,kBAAkB;IAClB,0BAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;aACvD,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;QACxE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;QAC7D,4DAA4D;QAC5D,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;aACvD,KAAK,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;QACjF,QAAQ,EAAE,CAAC;aACN,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;aACzD,MAAM,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;QACjE,kEAAkE;QAClE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAClF,gFAAgF;QAChF,cAAc,EAAE,CAAC;aACZ,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;aAC/D,KAAK,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;QACzF,iFAAiF;QACjF,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAC/C,oEAAoE;QACpE,cAAc,EAAE,CAAC;aACZ,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;aAC/D,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;QAChF,0CAA0C;QAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QAChF,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAClE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAC1D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAC/D,sDAAsD;QACtD,WAAW,EAAE,CAAC;aACT,MAAM,EAAE;aACR,KAAK,CAAC,mBAAmB,CAAC;aAC1B,QAAQ,EAAE;aACV,QAAQ,EAAE;KAClB,CAAC,CAAC;IAEU,2BAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;QAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;KACxC,CAAC,CAAC;IAEU,yBAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EA9CgB,kBAAkB,KAAlB,kBAAkB,QA8ClC"}

package/build-esm/v1/payment/commands/fail-webhook.command.js

@@ -1,6 +1,14 @@
 import { HttpMethod } from '../../../shared/http-method.enum';
 import { REST_API } from '../../../rest-api';
 import { CloudPaymentsFailRequestSchema, CloudPaymentsResponseSchema, } from '../schemas/cloudpayments-webhook.schemas';
+/**
+ * CloudPayments `fail` webhook command.
+ * Sent when a payment attempt is declined. Payment→DECLINED; Order stays PENDING for retry.
+ * Controller derives DTOs from this namespace via createZodDto(FailWebhookCommand.Request/.Response).
+ *
+ * No JWT — protected by CloudPaymentsWebhookGuard (HMAC).
+ * Handler: CloudPaymentsWebhookService.handleFail().
+ */
 export var FailWebhookCommand;
 (function (FailWebhookCommand) {
     FailWebhookCommand.Request = CloudPaymentsFailRequestSchema;

package/build-esm/v1/payment/commands/fail-webhook.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"fail-webhook.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/fail-webhook.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACH,8BAA8B,EAC9B,2BAA2B,GAC9B,MAAM,0CAA0C,CAAC;AAUlD,MAAM,KAAW,kBAAkB,CASlC;AATD,WAAiB,kBAAkB;IAClB,0BAAO,GAAG,8BAA8B,CAAC;IACzC,2BAAQ,GAAG,2BAA2B,CAAC;IAEvC,sBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IACxC,yBAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,kBAAkB,KAAlB,kBAAkB,QASlC"}
+{"version":3,"file":"fail-webhook.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/fail-webhook.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACH,8BAA8B,EAC9B,2BAA2B,GAC9B,MAAM,0CAA0C,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,KAAW,kBAAkB,CASlC;AATD,WAAiB,kBAAkB;IAClB,0BAAO,GAAG,8BAA8B,CAAC;IACzC,2BAAQ,GAAG,2BAA2B,CAAC;IAEvC,sBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IACxC,yBAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,kBAAkB,KAAlB,kBAAkB,QASlC"}

package/build-esm/v1/payment/commands/pay-webhook.command.js

@@ -1,6 +1,15 @@
 import { HttpMethod } from '../../../shared/http-method.enum';
 import { REST_API } from '../../../rest-api';
 import { CloudPaymentsPayRequestSchema, CloudPaymentsResponseSchema, } from '../schemas/cloudpayments-webhook.schemas';
+/**
+ * CloudPayments `pay` webhook command.
+ * Sent when payment is confirmed. Server marks Order→PAID, Payment→CONFIRMED,
+ * and if Token is present — upserts SavedPaymentMethod.
+ * Controller derives DTOs from this namespace via createZodDto(PayWebhookCommand.Request/.Response).
+ *
+ * No JWT — protected by CloudPaymentsWebhookGuard (HMAC).
+ * Handler: CloudPaymentsWebhookService.handlePay().
+ */
 export var PayWebhookCommand;
 (function (PayWebhookCommand) {
     PayWebhookCommand.Request = CloudPaymentsPayRequestSchema;

package/build-esm/v1/payment/commands/pay-webhook.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"pay-webhook.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/pay-webhook.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACH,6BAA6B,EAC7B,2BAA2B,GAC9B,MAAM,0CAA0C,CAAC;AAWlD,MAAM,KAAW,iBAAiB,CASjC;AATD,WAAiB,iBAAiB;IACjB,yBAAO,GAAG,6BAA6B,CAAC;IACxC,0BAAQ,GAAG,2BAA2B,CAAC;IAEvC,qBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;IACvC,wBAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,iBAAiB,KAAjB,iBAAiB,QASjC"}
+{"version":3,"file":"pay-webhook.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/pay-webhook.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACH,6BAA6B,EAC7B,2BAA2B,GAC9B,MAAM,0CAA0C,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,KAAW,iBAAiB,CASjC;AATD,WAAiB,iBAAiB;IACjB,yBAAO,GAAG,6BAA6B,CAAC;IACxC,0BAAQ,GAAG,2BAA2B,CAAC;IAEvC,qBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;IACvC,wBAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,iBAAiB,KAAjB,iBAAiB,QASjC"}

package/build-esm/v1/payment/commands/refund-webhook.command.js

@@ -1,6 +1,16 @@
 import { HttpMethod } from '../../../shared/http-method.enum';
 import { REST_API } from '../../../rest-api';
 import { CloudPaymentsRefundRequestSchema, CloudPaymentsResponseSchema, } from '../schemas/cloudpayments-webhook.schemas';
+/**
+ * CloudPayments `refund` webhook command.
+ * Sent when a confirmed payment is refunded. Writes a Refund row (matches our REQUESTED one, otherwise SUCCEEDED/PROVIDER).
+ * A full refund of the payment that paid the order → Order→REFUNDED; a partial one leaves the order PAID.
+ * A refund of a payment we do not know yet is answered with code 13: CloudPayments repeats it after Pay.
+ * Controller derives DTOs from this namespace via createZodDto(RefundWebhookCommand.Request/.Response).
+ *
+ * No JWT — protected by CloudPaymentsWebhookGuard (HMAC).
+ * Handler: CloudPaymentsWebhookService.handleRefund().
+ */
 export var RefundWebhookCommand;
 (function (RefundWebhookCommand) {
     RefundWebhookCommand.Request = CloudPaymentsRefundRequestSchema;

package/build-esm/v1/payment/commands/refund-webhook.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"refund-webhook.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/refund-webhook.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACH,gCAAgC,EAChC,2BAA2B,GAC9B,MAAM,0CAA0C,CAAC;AAYlD,MAAM,KAAW,oBAAoB,CASpC;AATD,WAAiB,oBAAoB;IACpB,4BAAO,GAAG,gCAAgC,CAAC;IAC3C,6BAAQ,GAAG,2BAA2B,CAAC;IAEvC,wBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC1C,2BAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,oBAAoB,KAApB,oBAAoB,QASpC"}
+{"version":3,"file":"refund-webhook.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/refund-webhook.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACH,gCAAgC,EAChC,2BAA2B,GAC9B,MAAM,0CAA0C,CAAC;AAElD;;;;;;;;;GASG;AACH,MAAM,KAAW,oBAAoB,CASpC;AATD,WAAiB,oBAAoB;IACpB,4BAAO,GAAG,gCAAgC,CAAC;IAC3C,6BAAQ,GAAG,2BAA2B,CAAC;IAEvC,wBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC1C,2BAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,oBAAoB,KAApB,oBAAoB,QASpC"}

package/build-esm/v1/payment/commands/revoke-saved-method.command.js

@@ -2,6 +2,13 @@ import { z } from 'zod';
 import { UUID_REGEX } from '../../../shared';
 import { HttpMethod } from '../../../shared/http-method.enum';
 import { REST_API } from '../../../rest-api';
+/**
+ * Revoke (delete) a saved payment method.
+ * Owner derived from JWT; 404 instead of 403 if not found or not owned.
+ *
+ * User-facing command: DELETE /v1/payment/saved-methods/:id
+ * Handler owns 1 repository: SavedPaymentMethodRepository.
+ */
 export var RevokeSavedMethodCommand;
 (function (RevokeSavedMethodCommand) {
     RevokeSavedMethodCommand.Request = z.object({
@@ -15,6 +22,7 @@ export var RevokeSavedMethodCommand;
     RevokeSavedMethodCommand.Response = z.object({
         revoked: z.boolean(),
     });
+    /** URL factory — call with savedMethodId to get the full URL. */
     RevokeSavedMethodCommand.URL = (id) => REST_API.V1.PAYMENT.REG.REVOKE_SAVED_METHOD(id);
     RevokeSavedMethodCommand.METHOD = HttpMethod.DELETE;
 })(RevokeSavedMethodCommand || (RevokeSavedMethodCommand = {}));

package/build-esm/v1/payment/commands/revoke-saved-method.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"revoke-saved-method.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/revoke-saved-method.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAS7C,MAAM,KAAW,wBAAwB,CAoBxC;AApBD,WAAiB,wBAAwB;IACxB,gCAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;aAC7D,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;QAC9E,aAAa,EAAE,CAAC;aACX,MAAM,CAAC,EAAE,KAAK,EAAE,iDAAiD,EAAE,CAAC;aACpE,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;KACxF,CAAC,CAAC;IAEU,iCAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;QAC7B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;KACvB,CAAC,CAAC;IAGU,4BAAG,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;IACtE,+BAAM,GAAG,UAAU,CAAC,MAAM,CAAC;AAI5C,CAAC,EApBgB,wBAAwB,KAAxB,wBAAwB,QAoBxC"}
+{"version":3,"file":"revoke-saved-method.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/revoke-saved-method.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,KAAW,wBAAwB,CAoBxC;AApBD,WAAiB,wBAAwB;IACxB,gCAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;aAC7D,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;QAC9E,aAAa,EAAE,CAAC;aACX,MAAM,CAAC,EAAE,KAAK,EAAE,iDAAiD,EAAE,CAAC;aACpE,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;KACxF,CAAC,CAAC;IAEU,iCAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;QAC7B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;KACvB,CAAC,CAAC;IAEH,iEAAiE;IACpD,4BAAG,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;IACtE,+BAAM,GAAG,UAAU,CAAC,MAAM,CAAC;AAI5C,CAAC,EApBgB,wBAAwB,KAAxB,wBAAwB,QAoBxC"}

package/build-esm/v1/payment/commands/set-default-saved-method.command.js

@@ -3,6 +3,17 @@ import { UUID_REGEX } from '../../../shared';
 import { HttpMethod } from '../../../shared/http-method.enum';
 import { REST_API } from '../../../rest-api';
 import { SavedPaymentMethodViewSchema } from '../queries/get-saved-methods.query';
+/**
+ * Set a saved payment method as the user's default.
+ * Owner derived from JWT; 404 instead of 403 if not found or not owned.
+ * 409 (SAVED_METHOD_NOT_ACTIVE) if the method is revoked/expired.
+ *
+ * Responds with the now-default method view. By the one-active-default
+ * invariant, every other method of the user is non-default afterwards.
+ *
+ * User-facing command: PATCH /v1/payment/saved-methods/:id/default
+ * Handler owns 1 repository: SavedPaymentMethodRepository.
+ */
 export var SetDefaultSavedMethodCommand;
 (function (SetDefaultSavedMethodCommand) {
     SetDefaultSavedMethodCommand.Request = z.object({
@@ -14,6 +25,7 @@ export var SetDefaultSavedMethodCommand;
             .regex(UUID_REGEX, { message: 'SetDefaultSavedMethodCommand.savedMethodId.invalid' }),
     });
     SetDefaultSavedMethodCommand.Response = SavedPaymentMethodViewSchema;
+    /** URL factory — call with savedMethodId to get the full URL. */
     SetDefaultSavedMethodCommand.URL = (id) => REST_API.V1.PAYMENT.REG.SET_DEFAULT_SAVED_METHOD(id);
     SetDefaultSavedMethodCommand.METHOD = HttpMethod.PATCH;
 })(SetDefaultSavedMethodCommand || (SetDefaultSavedMethodCommand = {}));

package/build-esm/v1/payment/commands/set-default-saved-method.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"set-default-saved-method.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/set-default-saved-method.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAalF,MAAM,KAAW,4BAA4B,CAkB5C;AAlBD,WAAiB,4BAA4B;IAC5B,oCAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,8CAA8C,EAAE,CAAC;aACjE,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;QAClF,aAAa,EAAE,CAAC;aACX,MAAM,CAAC,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC;aACxE,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC;KAC5F,CAAC,CAAC;IAEU,qCAAQ,GAAG,4BAA4B,CAAC;IAGxC,gCAAG,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC;IAC3E,mCAAM,GAAG,UAAU,CAAC,KAAK,CAAC;AAI3C,CAAC,EAlBgB,4BAA4B,KAA5B,4BAA4B,QAkB5C"}
+{"version":3,"file":"set-default-saved-method.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/set-default-saved-method.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAElF;;;;;;;;;;GAUG;AACH,MAAM,KAAW,4BAA4B,CAkB5C;AAlBD,WAAiB,4BAA4B;IAC5B,oCAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,8CAA8C,EAAE,CAAC;aACjE,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;QAClF,aAAa,EAAE,CAAC;aACX,MAAM,CAAC,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC;aACxE,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC;KAC5F,CAAC,CAAC;IAEU,qCAAQ,GAAG,4BAA4B,CAAC;IAErD,iEAAiE;IACpD,gCAAG,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC;IAC3E,mCAAM,GAAG,UAAU,CAAC,KAAK,CAAC;AAI3C,CAAC,EAlBgB,4BAA4B,KAA5B,4BAA4B,QAkB5C"}

package/build-esm/v1/payment/commands/three-ds-complete.command.js

@@ -1,6 +1,16 @@
 import { HttpMethod } from '../../../shared/http-method.enum';
 import { REST_API } from '../../../rest-api';
 import { ThreeDsCompleteRequestSchema } from '../schemas/three-ds-complete.schema';
+/**
+ * Item 10 — 3-D Secure TermUrl completion. The bank's ACS page posts MD+PaRes here after
+ * the cardholder completes the challenge; PaymentThreeDsController forwards it to the
+ * gateway and replies with an HTTP redirect (302), never JSON — there is deliberately no
+ * `Response` schema below (mirrors NotificationsUnsubscribeController's GET redirect).
+ *
+ * No JWT (the ACS page's cross-site form POST carries no Authorization header) and no
+ * HMAC (the ACS page is the issuing bank, not CloudPayments) — see PAYMENT_3DS_CONTROLLER's
+ * doc comment for the full trust-boundary rationale.
+ */
 export var ThreeDsCompleteCommand;
 (function (ThreeDsCompleteCommand) {
     ThreeDsCompleteCommand.Request = ThreeDsCompleteRequestSchema;

package/build-esm/v1/payment/commands/three-ds-complete.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"three-ds-complete.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/three-ds-complete.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAYnF,MAAM,KAAW,sBAAsB,CAOtC;AAPD,WAAiB,sBAAsB;IACtB,8BAAO,GAAG,4BAA4B,CAAC;IAEvC,0BAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC5C,6BAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAG1C,CAAC,EAPgB,sBAAsB,KAAtB,sBAAsB,QAOtC"}
+{"version":3,"file":"three-ds-complete.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/three-ds-complete.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAEnF;;;;;;;;;GASG;AACH,MAAM,KAAW,sBAAsB,CAOtC;AAPD,WAAiB,sBAAsB;IACtB,8BAAO,GAAG,4BAA4B,CAAC;IAEvC,0BAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC5C,6BAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAG1C,CAAC,EAPgB,sBAAsB,KAAtB,sBAAsB,QAOtC"}

package/build-esm/v1/payment/index.js

@@ -3,6 +3,7 @@ export * from './payment.errors';
 export * from './commands';
 export * from './queries';
 export * from './admin';
+// Re-export from centralized locations
 export { PAYMENT_CONTROLLER, PAYMENT_WEBHOOKS_CONTROLLER, PAYMENT_ADMIN_CONTROLLER, PAYMENT_3DS_CONTROLLER } from '../../controllers';
 export { PAYMENT_ROUTES, PAYMENT_WEBHOOKS_ROUTES, PAYMENT_ADMIN_ROUTES, PAYMENT_3DS_ROUTES } from '../../routes';
 //# sourceMappingURL=index.js.map

package/build-esm/v1/payment/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/payment/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACtI,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/payment/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,uCAAuC;AACvC,OAAO,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACtI,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/build-esm/v1/payment/payment.errors.js

@@ -1,27 +1,64 @@
+/**
+ * Error codes for the payment module.
+ * All codes are mapped to HTTP status codes in PAYMENT_ERRORS.
+ */
 export var PaymentErrorCode;
 (function (PaymentErrorCode) {
+    /** Order not found by ID. */
     PaymentErrorCode["ORDER_NOT_FOUND"] = "ORDER_NOT_FOUND";
+    /** Amount in pay/check webhook does not match server-stored order amount. */
     PaymentErrorCode["ORDER_AMOUNT_MISMATCH"] = "ORDER_AMOUNT_MISMATCH";
+    /** Attempt to fulfill an already-fulfilled order (idempotency guard). */
     PaymentErrorCode["ORDER_ALREADY_FULFILLED"] = "ORDER_ALREADY_FULFILLED";
+    /** HMAC signature on webhook request failed verification. */
     PaymentErrorCode["WEBHOOK_SIGNATURE_INVALID"] = "WEBHOOK_SIGNATURE_INVALID";
+    /** No active SavedPaymentMethod found for the user (cannot run recurrent charge). */
     PaymentErrorCode["NO_SAVED_METHOD"] = "NO_SAVED_METHOD";
+    /** Saved method exists but is not ACTIVE (revoked/expired) — cannot be set as default. */
     PaymentErrorCode["SAVED_METHOD_NOT_ACTIVE"] = "SAVED_METHOD_NOT_ACTIVE";
+    /** Recurrent charge was synchronously declined by the payment gateway. */
     PaymentErrorCode["CHARGE_DECLINED"] = "CHARGE_DECLINED";
+    /** Order has already expired (TTL elapsed). */
     PaymentErrorCode["ORDER_EXPIRED"] = "ORDER_EXPIRED";
+    /** Order cannot be cancelled because it is already paid (or otherwise non-pending). */
     PaymentErrorCode["ORDER_NOT_CANCELLABLE"] = "ORDER_NOT_CANCELLABLE";
+    /** Order is not in a refundable state (not PAID, or no confirmed payment to refund). */
     PaymentErrorCode["ORDER_NOT_REFUNDABLE"] = "ORDER_NOT_REFUNDABLE";
+    /** Gateway rejected the refund request. */
     PaymentErrorCode["REFUND_FAILED"] = "REFUND_FAILED";
+    /**
+     * The refund gateway call failed (network/timeout/non-2xx) before a definitive
+     * decision was read — the refund MAY have been processed. NOT the same as
+     * REFUND_FAILED: the admin must reconcile before retrying, not simply resubmit.
+     */
     PaymentErrorCode["REFUND_OUTCOME_UNKNOWN"] = "REFUND_OUTCOME_UNKNOWN";
+    /** Payment gateway provider value from DB is not a recognised PaymentProvider enum member. */
     PaymentErrorCode["PAYMENT_PROVIDER_UNSUPPORTED"] = "PAYMENT_PROVIDER_UNSUPPORTED";
+    /** Order acceptance check failed — see OrderAcceptanceDecision for specific reason. */
     PaymentErrorCode["ORDER_ACCEPTANCE_FAILED"] = "ORDER_ACCEPTANCE_FAILED";
+    /** Subscription linked to a refunded order not found for revocation. */
     PaymentErrorCode["SUBSCRIPTION_NOT_FOUND_FOR_REVOCATION"] = "SUBSCRIPTION_NOT_FOUND_FOR_REVOCATION";
+    /** Currency value from DB or external source is not a recognised Currency enum member. */
     PaymentErrorCode["INVALID_CURRENCY"] = "INVALID_CURRENCY";
+    /** Amount value from external webhook is not a finite number (NaN, Infinity). */
     PaymentErrorCode["INVALID_AMOUNT"] = "INVALID_AMOUNT";
+    /**
+     * cp-subscriptions-v3 (v5.0 — manual payment without a reservation): checkout-config
+     * refuses to open the widget because a server-side (dunning / one-click) charge is
+     * currently in flight for this order or its subscription. The caller should treat this
+     * exactly like the `CHARGE_PROCESSING` ChargeStatus: do not open the widget, poll
+     * `GET /subscription/me` instead.
+     */
     PaymentErrorCode["ORDER_CHARGE_IN_FLIGHT"] = "ORDER_CHARGE_IN_FLIGHT";
+    /** Payment not found by id or provider transaction id. */
     PaymentErrorCode["PAYMENT_NOT_FOUND"] = "PAYMENT_NOT_FOUND";
+    /** Refund not found by id. */
     PaymentErrorCode["REFUND_NOT_FOUND"] = "REFUND_NOT_FOUND";
+    /** A refund of this payment is already in flight (REQUESTED), or the payment already has its automatic refund. */
     PaymentErrorCode["REFUND_ALREADY_REQUESTED"] = "REFUND_ALREADY_REQUESTED";
+    /** The refund status does not allow this transition. */
     PaymentErrorCode["REFUND_INVALID_TRANSITION"] = "REFUND_INVALID_TRANSITION";
+    /** The payment status does not allow this transition. */
     PaymentErrorCode["PAYMENT_INVALID_TRANSITION"] = "PAYMENT_INVALID_TRANSITION";
 })(PaymentErrorCode || (PaymentErrorCode = {}));
 export const PAYMENT_ERRORS = {

package/build-esm/v1/payment/payment.errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment.errors.js","sourceRoot":"","sources":["../../../v1/payment/payment.errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"payment.errors.js","sourceRoot":"","sources":["../../../v1/payment/payment.errors.ts"],"names":[],"mappings":"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"}

package/build-esm/v1/payment/queries/get-checkout-config.query.js

@@ -3,6 +3,14 @@ import { UUID_REGEX } from '../../../shared';
 import { REST_API } from '../../../rest-api';
 import { HttpMethod } from '../../../shared/http-method.enum';
 import { CheckoutConfigSchema } from '../schemas/cloudpayments-webhook.schemas';
+/**
+ * Get CloudPayments widget initialization parameters for an Order.
+ * Used by frontend to open the payment widget after checkout.
+ * Owner derived from JWT; 404 if order not found or not owned.
+ *
+ * User-facing query: GET /v1/payment/checkout-config?orderId=
+ * Handler owns 1 repository: OrderRepository + reads ConfigService (CLOUDPAYMENTS_PUBLIC_ID).
+ */
 export var GetCheckoutConfigQuery;
 (function (GetCheckoutConfigQuery) {
     GetCheckoutConfigQuery.Request = z.object({

package/build-esm/v1/payment/queries/get-checkout-config.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-checkout-config.query.js","sourceRoot":"","sources":["../../../../v1/payment/queries/get-checkout-config.query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAUhF,MAAM,KAAW,sBAAsB,CAiBtC;AAjBD,WAAiB,sBAAsB;IACtB,8BAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC;aAC3D,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;QAC5E,OAAO,EAAE,CAAC;aACL,MAAM,CAAC,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC;aAC5D,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC;KAChF,CAAC,CAAC;IAEU,+BAAQ,GAAG,oBAAoB,CAAC;IAEhC,0BAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC9C,6BAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EAjBgB,sBAAsB,KAAtB,sBAAsB,QAiBtC"}
+{"version":3,"file":"get-checkout-config.query.js","sourceRoot":"","sources":["../../../../v1/payment/queries/get-checkout-config.query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAEhF;;;;;;;GAOG;AACH,MAAM,KAAW,sBAAsB,CAiBtC;AAjBD,WAAiB,sBAAsB;IACtB,8BAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC;aAC3D,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;QAC5E,OAAO,EAAE,CAAC;aACL,MAAM,CAAC,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC;aAC5D,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC;KAChF,CAAC,CAAC;IAEU,+BAAQ,GAAG,oBAAoB,CAAC;IAEhC,0BAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC9C,6BAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EAjBgB,sBAAsB,KAAtB,sBAAsB,QAiBtC"}

package/build-esm/v1/payment/queries/get-order-outcome.query.js

@@ -9,10 +9,24 @@ export const OrderOutcomeSchema = z.object({
     orderId: z.string().regex(UUID_REGEX),
     kind: z.nativeEnum(OrderKind),
     outcome: z.nativeEnum(OrderOutcome),
+    /** Set for DECLINED, and for CLOSED when the last real payment was a decline. null otherwise. */
     declineClass: z.nativeEnum(PaymentDeclineClass).nullable(),
+    /** true while the order can still be paid in the widget (PENDING, not expired, not a provider renewal) after a decline or with no charge. */
     payable: z.boolean(),
+    /**
+     * true while a payment of the order is unresolved (with the bank, or of unknown result). The outcome
+     * stays authoritative — APPLIED is still APPLIED — but money may still be moving.
+     */
     unresolvedMoney: z.boolean(),
 });
+/**
+ * What became of the caller's own purchase order — the strict read behind a one-click
+ * CHARGE_PROCESSING: APPLIED is the only proof of success.
+ * Owner derived from JWT; 404 ORDER_NOT_FOUND for a missing order and for someone else's alike.
+ *
+ * User-facing query: GET /v1/payment/orders/:orderId/outcome
+ * Handler owns 1 repository: OrderRepository (+ the decline classifier port).
+ */
 export var GetOrderOutcomeQuery;
 (function (GetOrderOutcomeQuery) {
     GetOrderOutcomeQuery.Request = z.object({

package/build-esm/v1/payment/queries/get-order-outcome.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-order-outcome.query.js","sourceRoot":"","sources":["../../../../v1/payment/queries/get-order-outcome.query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAE5E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC;IAC7B,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC;IAEnC,YAAY,EAAE,CAAC,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE;IAE1D,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IAKpB,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE;CAC/B,CAAC,CAAC;AAUH,MAAM,KAAW,oBAAoB,CAiBpC;AAjBD,WAAiB,oBAAoB;IACpB,4BAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;aACzD,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;QAC1E,OAAO,EAAE,CAAC;aACL,MAAM,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC;aAC1D,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;KAC9E,CAAC,CAAC;IAEU,6BAAQ,GAAG,kBAAkB,CAAC;IAE9B,wBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC5C,2BAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EAjBgB,oBAAoB,KAApB,oBAAoB,QAiBpC"}
+{"version":3,"file":"get-order-outcome.query.js","sourceRoot":"","sources":["../../../../v1/payment/queries/get-order-outcome.query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAE5E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC;IAC7B,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC;IACnC,iGAAiG;IACjG,YAAY,EAAE,CAAC,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE;IAC1D,6IAA6I;IAC7I,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB;;;OAGG;IACH,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE;CAC/B,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,KAAW,oBAAoB,CAiBpC;AAjBD,WAAiB,oBAAoB;IACpB,4BAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;aACzD,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;QAC1E,OAAO,EAAE,CAAC;aACL,MAAM,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC;aAC1D,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;KAC9E,CAAC,CAAC;IAEU,6BAAQ,GAAG,kBAAkB,CAAC;IAE9B,wBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC5C,2BAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EAjBgB,oBAAoB,KAApB,oBAAoB,QAiBpC"}

package/build-esm/v1/payment/queries/get-order.query.js

@@ -2,6 +2,14 @@ import { z } from 'zod';
 import { UUID_REGEX } from '../../../shared';
 import { HttpMethod } from '../../../shared/http-method.enum';
 import { OrderViewSchema } from '../schemas/cloudpayments-webhook.schemas';
+/**
+ * Get a single Order by ID.
+ * Used by subscription fulfillment service and CloudPayments webhook service.
+ *
+ * Cross-module query: subscription / payment internal → payment.
+ * Handler owns 1 repository: OrderRepository.
+ * No HTTP endpoint — invoked only via TypedQueryBus.
+ */
 export var GetOrderQuery;
 (function (GetOrderQuery) {
     GetOrderQuery.Request = z.object({

package/build-esm/v1/payment/queries/get-order.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-order.query.js","sourceRoot":"","sources":["../../../../v1/payment/queries/get-order.query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAU3E,MAAM,KAAW,aAAa,CAa7B;AAbD,WAAiB,aAAa;IACb,qBAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,OAAO,EAAE,CAAC;aACL,MAAM,CAAC,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC;aACnD,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;KACvE,CAAC,CAAC;IAEU,sBAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAC;IAEtC,oBAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EAbgB,aAAa,KAAb,aAAa,QAa7B"}
+{"version":3,"file":"get-order.query.js","sourceRoot":"","sources":["../../../../v1/payment/queries/get-order.query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAE3E;;;;;;;GAOG;AACH,MAAM,KAAW,aAAa,CAa7B;AAbD,WAAiB,aAAa;IACb,qBAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,OAAO,EAAE,CAAC;aACL,MAAM,CAAC,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC;aACnD,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;KACvE,CAAC,CAAC;IAEU,sBAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAC;IAEtC,oBAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EAbgB,aAAa,KAAb,aAAa,QAa7B"}

package/build-esm/v1/payment/queries/get-saved-methods.query.js

@@ -8,17 +8,29 @@ export const SavedPaymentMethodViewSchema = z.object({
     id: z.string().regex(UUID_REGEX),
     cardMask: z.string(),
     cardType: z.string().nullable(),
+    /** Card product type from CP (e.g. "Visa Classic"). */
     cardProduct: z.string().nullable(),
+    /** Issuing bank name from CP (e.g. "Sberbank of Russia"). */
     cardIssuer: z.string().nullable(),
+    /** Issuing bank country — ISO 3166-1 alpha-2 (e.g. "RU"). */
     issuerCountry: z.string().nullable(),
+    /** Unique card identifier in CloudPayments. */
     cardId: z.string().nullable(),
     expMonth: z.number().int().min(1).max(12).nullable(),
     expYear: z.number().int().positive().nullable(),
     status: z.nativeEnum(SavedMethodStatus),
+    /** Set only for UNUSABLE cards: why the bank refused the card. */
     unusableReason: z.nativeEnum(SavedMethodUnusableReason).nullable(),
     isDefault: z.boolean(),
     createdAt: z.string().datetime({ offset: true }),
 });
+/**
+ * List the authenticated user's saved cards: ACTIVE and UNUSABLE (REVOKED cards are not returned).
+ * Owner derived from JWT.
+ *
+ * User-facing query: GET /v1/payment/saved-methods
+ * Handler owns 1 repository: SavedPaymentMethodRepository.
+ */
 export var GetSavedMethodsQuery;
 (function (GetSavedMethodsQuery) {
     GetSavedMethodsQuery.Request = z.object({

package/build-esm/v1/payment/queries/get-saved-methods.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-saved-methods.query.js","sourceRoot":"","sources":["../../../../v1/payment/queries/get-saved-methods.query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AAEzF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAElC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEjC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC/C,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC;IAEvC,cAAc,EAAE,CAAC,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAC,QAAQ,EAAE;IAClE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;CACnD,CAAC,CAAC;AAWH,MAAM,KAAW,oBAAoB,CAcpC;AAdD,WAAiB,oBAAoB;IACpB,4BAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;aACzD,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;KAC7E,CAAC,CAAC;IAEU,6BAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAEjD,wBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC5C,2BAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EAdgB,oBAAoB,KAApB,oBAAoB,QAcpC"}
+{"version":3,"file":"get-saved-methods.query.js","sourceRoot":"","sources":["../../../../v1/payment/queries/get-saved-methods.query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AAEzF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,uDAAuD;IACvD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,6DAA6D;IAC7D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,6DAA6D;IAC7D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,+CAA+C;IAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC/C,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC;IACvC,kEAAkE;IAClE,cAAc,EAAE,CAAC,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAC,QAAQ,EAAE;IAClE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;CACnD,CAAC,CAAC;AAIH;;;;;;GAMG;AACH,MAAM,KAAW,oBAAoB,CAcpC;AAdD,WAAiB,oBAAoB;IACpB,4BAAO,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;aACzD,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;KAC7E,CAAC,CAAC;IAEU,6BAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAEjD,wBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC5C,2BAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EAdgB,oBAAoB,KAApB,oBAAoB,QAcpC"}

package/build-esm/v1/payment/schemas/charge-initiator.enum.js

@@ -1,3 +1,16 @@
+// libs/contracts/v1/payment/schemas/charge-initiator.enum.ts
+/**
+ * Identifies which party initiated a stored-credential charge.
+ *
+ * MERCHANT_SCHEDULED — charge initiated by merchant on stored credentials
+ *                      (auto-renewal / dunning). CP fields: TrInitiatorCode=0 + PaymentScheduled=1.
+ *                      https://developers.cloudpayments.ru/#oplata-po-tokenu-rekarring
+ *
+ * CARDHOLDER         — charge initiated by the cardholder pressing a "Pay" button in the UI.
+ *                      CP fields: TrInitiatorCode=1. PaymentScheduled MUST NOT be sent.
+ *                      Legal requirement: one-click purchases for new items MUST be
+ *                      explicitly triggered by the cardholder — silent auto-charges are forbidden.
+ */
 export var ChargeInitiator;
 (function (ChargeInitiator) {
     ChargeInitiator["MERCHANT_SCHEDULED"] = "MERCHANT_SCHEDULED";

package/build-esm/v1/payment/schemas/charge-initiator.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"charge-initiator.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/charge-initiator.enum.ts"],"names":[],"mappings":"AAcA,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACvB,4DAAyC,CAAA;IACzC,4CAAyB,CAAA;AAC7B,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B"}
+{"version":3,"file":"charge-initiator.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/charge-initiator.enum.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D;;;;;;;;;;;GAWG;AACH,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACvB,4DAAyC,CAAA;IACzC,4CAAyB,CAAA;AAC7B,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B"}

package/build-esm/v1/payment/schemas/charge-outcome.enum.js

@@ -1,3 +1,23 @@
+/**
+ * Outcome of a synchronous gateway charge/refund attempt (ChargeSavedMethod, admin
+ * refund). Distinguishes a real business decline from an ambiguous technical failure
+ * where we cannot tell whether the provider actually processed the money movement.
+ *
+ * ACCEPTED     — gateway confirmed it received and is processing the request.
+ * DECLINED     — gateway responded with a definitive business rejection (e.g. Success:false
+ *                with a reason code). Safe to let the user retry / advance dunning.
+ * REQUIRES_3DS — gateway did not decline the charge; it needs 3-D Secure cardholder
+ *                authentication (Success:false, Model.AcsUrl/PaReq present, NO ReasonCode).
+ *                Not a decline: do not classify it with a DeclineKind or advance dunning
+ *                as if the card failed. A one-click (cardholder-present) caller must send
+ *                the payer through the AcsUrl/PaReq challenge; a merchant-initiated (no
+ *                cardholder present) caller cannot complete 3DS automatically and must stop
+ *                — the payer needs to pay it themselves.
+ * UNKNOWN      — the HTTP call itself failed (network error, timeout, non-2xx status) before
+ *                we could read a definitive gateway decision. The money MAY have moved.
+ *                Callers MUST NOT treat this as a clean decline: no automatic retry charge,
+ *                no new order/widget attempt for the same payment until reconciled.
+ */
 export var ChargeOutcome;
 (function (ChargeOutcome) {
     ChargeOutcome["ACCEPTED"] = "ACCEPTED";

package/build-esm/v1/payment/schemas/charge-outcome.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"charge-outcome.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/charge-outcome.enum.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACrB,sCAAqB,CAAA;IACrB,sCAAqB,CAAA;IACrB,8CAA6B,CAAA;IAC7B,oCAAmB,CAAA;AACvB,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB"}
+{"version":3,"file":"charge-outcome.enum.js","sourceRoot":"","sources":["../../../../v1/payment/schemas/charge-outcome.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACrB,sCAAqB,CAAA;IACrB,sCAAqB,CAAA;IACrB,8CAA6B,CAAA;IAC7B,oCAAmB,CAAA;AACvB,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB"}