@veruna/api-contracts 20.0.0 → 20.2.0

package/build/v1/payment/admin/schemas/admin-order.schema.js.map

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

package/build/v1/payment/admin/schemas/admin-saved-method.schema.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+/** Admin view of a user's saved cards — reuses the user-facing SavedPaymentMethodView. */
 export declare const AdminListSavedMethodsResponseSchema: z.ZodObject<{
     methods: z.ZodArray<z.ZodObject<{
         id: z.ZodString;

package/build/v1/payment/admin/schemas/admin-saved-method.schema.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AdminRevokeSavedMethodResponseSchema = exports.AdminListSavedMethodsResponseSchema = void 0;
 const zod_1 = require("zod");
 const get_saved_methods_query_1 = require("../../queries/get-saved-methods.query");
+/** Admin view of a user's saved cards — reuses the user-facing SavedPaymentMethodView. */
 exports.AdminListSavedMethodsResponseSchema = zod_1.z.object({
     methods: zod_1.z.array(get_saved_methods_query_1.SavedPaymentMethodViewSchema),
 });

package/build/v1/payment/admin/schemas/admin-saved-method.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-saved-method.schema.js","sourceRoot":"","sources":["../../../../../v1/payment/admin/schemas/admin-saved-method.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,mFAAqF;AAGxE,QAAA,mCAAmC,GAAG,OAAC,CAAC,MAAM,CAAC;IACxD,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,sDAA4B,CAAC;CACjD,CAAC,CAAC;AAIU,QAAA,oCAAoC,GAAG,OAAC,CAAC,MAAM,CAAC;IACzD,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;CACvB,CAAC,CAAC"}
+{"version":3,"file":"admin-saved-method.schema.js","sourceRoot":"","sources":["../../../../../v1/payment/admin/schemas/admin-saved-method.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,mFAAqF;AAErF,0FAA0F;AAC7E,QAAA,mCAAmC,GAAG,OAAC,CAAC,MAAM,CAAC;IACxD,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,sDAA4B,CAAC;CACjD,CAAC,CAAC;AAIU,QAAA,oCAAoC,GAAG,OAAC,CAAC,MAAM,CAAC;IACzD,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;CACvB,CAAC,CAAC"}

package/build/v1/payment/commands/charge-saved-method.command.d.ts

@@ -1,5 +1,13 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Initiate a server-to-server recurrent charge via CloudPayments.
+ * Uses the user's active default SavedPaymentMethod.
+ * The actual credit arrives via the pay-webhook (async).
+ *
+ * Cross-module command: subscription cycle service → payment.
+ * Handler owns: SavedPaymentMethodRepository (reads token) + CloudPaymentsClient (S2S HTTP).
+ */
 export declare namespace ChargeSavedMethodCommand {
     const Request: z.ZodObject<{
         userId: z.ZodString;

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

@@ -4,6 +4,14 @@ exports.ChargeSavedMethodCommand = void 0;
 const zod_1 = require("zod");
 const shared_1 = require("../../../shared");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
+/**
+ * Initiate a server-to-server recurrent charge via CloudPayments.
+ * Uses the user's active default SavedPaymentMethod.
+ * The actual credit arrives via the pay-webhook (async).
+ *
+ * Cross-module command: subscription cycle service → payment.
+ * Handler owns: SavedPaymentMethodRepository (reads token) + CloudPaymentsClient (S2S HTTP).
+ */
 var ChargeSavedMethodCommand;
 (function (ChargeSavedMethodCommand) {
     ChargeSavedMethodCommand.Request = zod_1.z.object({
@@ -13,11 +21,16 @@ var ChargeSavedMethodCommand;
         orderId: zod_1.z
             .string({ error: 'ChargeSavedMethodCommand.orderId.required' })
             .regex(shared_1.UUID_REGEX, { message: 'ChargeSavedMethodCommand.orderId.invalid' }),
+        /** Amount as integer string (BigInt, ×100 of RUB). */
         amount: zod_1.z
             .string({ error: 'ChargeSavedMethodCommand.amount.required' })
             .regex(shared_1.BIGINT_STRING_REGEX, { message: 'ChargeSavedMethodCommand.amount.invalid' }),
     });
     ChargeSavedMethodCommand.Response = zod_1.z.object({
+        /**
+         * true  — CP accepted the charge request (payment result comes via webhook).
+         * false — CP synchronously declined (no saved method or immediate rejection).
+         */
         accepted: zod_1.z.boolean(),
     });
     ChargeSavedMethodCommand.METHOD = http_method_enum_1.HttpMethod.POST;

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

@@ -1 +1 @@
-{"version":3,"file":"charge-saved-method.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/charge-saved-method.command.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAAkE;AAClE,uEAA8D;AAU9D,IAAiB,wBAAwB,CA0BxC;AA1BD,WAAiB,wBAAwB;IACxB,gCAAO,GAAG,OAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,OAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;aAC7D,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;QAC9E,OAAO,EAAE,OAAC;aACL,MAAM,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;aAC9D,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;QAE/E,MAAM,EAAE,OAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;aAC7D,KAAK,CAAC,4BAAmB,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;KAC1F,CAAC,CAAC;IAEU,iCAAQ,GAAG,OAAC,CAAC,MAAM,CAAC;QAK7B,QAAQ,EAAE,OAAC,CAAC,OAAO,EAAE;KACxB,CAAC,CAAC;IAEU,+BAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EA1BgB,wBAAwB,wCAAxB,wBAAwB,QA0BxC"}
+{"version":3,"file":"charge-saved-method.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/charge-saved-method.command.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAAkE;AAClE,uEAA8D;AAE9D;;;;;;;GAOG;AACH,IAAiB,wBAAwB,CA0BxC;AA1BD,WAAiB,wBAAwB;IACxB,gCAAO,GAAG,OAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,OAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;aAC7D,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;QAC9E,OAAO,EAAE,OAAC;aACL,MAAM,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;aAC9D,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;QAC/E,sDAAsD;QACtD,MAAM,EAAE,OAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;aAC7D,KAAK,CAAC,4BAAmB,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;KAC1F,CAAC,CAAC;IAEU,iCAAQ,GAAG,OAAC,CAAC,MAAM,CAAC;QAC7B;;;WAGG;QACH,QAAQ,EAAE,OAAC,CAAC,OAAO,EAAE;KACxB,CAAC,CAAC;IAEU,+BAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EA1BgB,wBAAwB,wCAAxB,wBAAwB,QA0BxC"}

package/build/v1/payment/commands/check-webhook.command.d.ts

@@ -1,5 +1,13 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * CloudPayments `check` webhook command.
+ * Provider sends this before charging to validate the order.
+ * Controller derives DTOs from this namespace via createZodDto(CheckWebhookCommand.Request/.Response).
+ *
+ * No JWT — protected by CloudPaymentsWebhookGuard (HMAC).
+ * Handler: CloudPaymentsWebhookService.handleCheck().
+ */
 export declare namespace CheckWebhookCommand {
     const Request: z.ZodObject<{
         Description: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/build/v1/payment/commands/check-webhook.command.js

@@ -4,6 +4,14 @@ exports.CheckWebhookCommand = void 0;
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 const rest_api_1 = require("../../../rest-api");
 const cloudpayments_webhook_schemas_1 = require("../schemas/cloudpayments-webhook.schemas");
+/**
+ * CloudPayments `check` webhook command.
+ * Provider sends this before charging to validate the order.
+ * Controller derives DTOs from this namespace via createZodDto(CheckWebhookCommand.Request/.Response).
+ *
+ * No JWT — protected by CloudPaymentsWebhookGuard (HMAC).
+ * Handler: CloudPaymentsWebhookService.handleCheck().
+ */
 var CheckWebhookCommand;
 (function (CheckWebhookCommand) {
     CheckWebhookCommand.Request = cloudpayments_webhook_schemas_1.CloudPaymentsCheckRequestSchema;

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

@@ -1 +1 @@
-{"version":3,"file":"check-webhook.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/check-webhook.command.ts"],"names":[],"mappings":";;;AACA,uEAA8D;AAC9D,gDAA6C;AAC7C,4FAGkD;AAUlD,IAAiB,mBAAmB,CASnC;AATD,WAAiB,mBAAmB;IACnB,2BAAO,GAAG,+DAA+B,CAAC;IAC1C,4BAAQ,GAAG,2DAA2B,CAAC;IAEvC,uBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IACzC,0BAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,mBAAmB,mCAAnB,mBAAmB,QASnC"}
+{"version":3,"file":"check-webhook.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/check-webhook.command.ts"],"names":[],"mappings":";;;AACA,uEAA8D;AAC9D,gDAA6C;AAC7C,4FAGkD;AAElD;;;;;;;GAOG;AACH,IAAiB,mBAAmB,CASnC;AATD,WAAiB,mBAAmB;IACnB,2BAAO,GAAG,+DAA+B,CAAC;IAC1C,4BAAQ,GAAG,2DAA2B,CAAC;IAEvC,uBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IACzC,0BAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,mBAAmB,mCAAnB,mBAAmB,QASnC"}

package/build/v1/payment/commands/create-order.command.d.ts

@@ -1,5 +1,14 @@
 import { z } from 'zod';
 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 declare namespace CreateOrderCommand {
     const Request: z.ZodObject<{
         userId: z.ZodString;

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

@@ -4,6 +4,15 @@ exports.CreateOrderCommand = void 0;
 const zod_1 = require("zod");
 const shared_1 = require("../../../shared");
 const http_method_enum_1 = require("../../../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.
+ */
 var CreateOrderCommand;
 (function (CreateOrderCommand) {
     CreateOrderCommand.Request = zod_1.z.object({
@@ -11,24 +20,31 @@ var CreateOrderCommand;
             .string({ error: 'CreateOrderCommand.userId.required' })
             .regex(shared_1.UUID_REGEX, { message: 'CreateOrderCommand.userId.invalid' }),
         kind: zod_1.z.string({ error: 'CreateOrderCommand.kind.required' }),
+        /** Order amount as integer string (BigInt, ×100 of RUB). */
         amount: zod_1.z
             .string({ error: 'CreateOrderCommand.amount.required' })
             .regex(shared_1.BIGINT_STRING_REGEX, { message: 'CreateOrderCommand.amount.invalid' }),
         currency: zod_1.z
             .string({ error: 'CreateOrderCommand.currency.required' })
             .length(3, { message: 'CreateOrderCommand.currency.length' }),
+        /** Human-readable description shown to user in payment widget. */
         description: zod_1.z.string({ error: 'CreateOrderCommand.description.required' }).min(1),
+        /** Granted balance as integer string (BigInt, ×100 of RUB; server-computed). */
         grantedBalance: zod_1.z
             .string({ error: 'CreateOrderCommand.grantedBalance.required' })
             .regex(shared_1.BIGINT_STRING_REGEX, { message: 'CreateOrderCommand.grantedBalance.invalid' }),
+        /** Entitlements snapshot (JSON — server-computed from plan at time of order). */
         entitlements: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+        /** UUIDv5 idempotency key — deterministic from order parameters. */
         idempotencyKey: zod_1.z
             .string({ error: 'CreateOrderCommand.idempotencyKey.required' })
             .regex(shared_1.UUID_REGEX, { message: 'CreateOrderCommand.idempotencyKey.invalid' }),
+        /** Order TTL in milliseconds from now. */
         ttlMs: zod_1.z.number({ error: 'CreateOrderCommand.ttlMs.required' }).int().positive(),
         subscriptionId: zod_1.z.string().regex(shared_1.UUID_REGEX).nullable().optional(),
         planId: zod_1.z.string().regex(shared_1.UUID_REGEX).nullable().optional(),
         periodMonths: zod_1.z.number().int().positive().nullable().optional(),
+        /** Custom price as BigInt string (internal units). */
         customPrice: zod_1.z
             .string()
             .regex(shared_1.BIGINT_STRING_REGEX)

package/build/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,6BAAwB;AACxB,4CAAkE;AAClE,uEAA8D;AAW9D,IAAiB,kBAAkB,CA8ClC;AA9CD,WAAiB,kBAAkB;IAClB,0BAAO,GAAG,OAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,OAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;aACvD,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;QACxE,IAAI,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;QAE7D,MAAM,EAAE,OAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;aACvD,KAAK,CAAC,4BAAmB,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;QACjF,QAAQ,EAAE,OAAC;aACN,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;aACzD,MAAM,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;QAEjE,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAElF,cAAc,EAAE,OAAC;aACZ,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;aAC/D,KAAK,CAAC,4BAAmB,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;QAEzF,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC;QAE/C,cAAc,EAAE,OAAC;aACZ,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;aAC/D,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;QAEhF,KAAK,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QAChF,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAClE,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAC1D,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAE/D,WAAW,EAAE,OAAC;aACT,MAAM,EAAE;aACR,KAAK,CAAC,4BAAmB,CAAC;aAC1B,QAAQ,EAAE;aACV,QAAQ,EAAE;KAClB,CAAC,CAAC;IAEU,2BAAQ,GAAG,OAAC,CAAC,MAAM,CAAC;QAC7B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;KACxC,CAAC,CAAC;IAEU,yBAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EA9CgB,kBAAkB,kCAAlB,kBAAkB,QA8ClC"}
+{"version":3,"file":"create-order.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/create-order.command.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAAkE;AAClE,uEAA8D;AAE9D;;;;;;;;GAQG;AACH,IAAiB,kBAAkB,CA8ClC;AA9CD,WAAiB,kBAAkB;IAClB,0BAAO,GAAG,OAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,OAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;aACvD,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;QACxE,IAAI,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;QAC7D,4DAA4D;QAC5D,MAAM,EAAE,OAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;aACvD,KAAK,CAAC,4BAAmB,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;QACjF,QAAQ,EAAE,OAAC;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,OAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAClF,gFAAgF;QAChF,cAAc,EAAE,OAAC;aACZ,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;aAC/D,KAAK,CAAC,4BAAmB,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;QACzF,iFAAiF;QACjF,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC;QAC/C,oEAAoE;QACpE,cAAc,EAAE,OAAC;aACZ,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;aAC/D,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;QAChF,0CAA0C;QAC1C,KAAK,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QAChF,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAClE,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAC1D,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAC/D,sDAAsD;QACtD,WAAW,EAAE,OAAC;aACT,MAAM,EAAE;aACR,KAAK,CAAC,4BAAmB,CAAC;aAC1B,QAAQ,EAAE;aACV,QAAQ,EAAE;KAClB,CAAC,CAAC;IAEU,2BAAQ,GAAG,OAAC,CAAC,MAAM,CAAC;QAC7B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;KACxC,CAAC,CAAC;IAEU,yBAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EA9CgB,kBAAkB,kCAAlB,kBAAkB,QA8ClC"}

package/build/v1/payment/commands/fail-webhook.command.d.ts

@@ -1,5 +1,13 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * 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 declare namespace FailWebhookCommand {
     const Request: z.ZodObject<{
         FallBackScenarioDeclinedTransactionId: z.ZodOptional<z.ZodNullable<z.ZodCoercedNumber<unknown>>>;

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

@@ -4,6 +4,14 @@ exports.FailWebhookCommand = void 0;
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 const rest_api_1 = require("../../../rest-api");
 const cloudpayments_webhook_schemas_1 = require("../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().
+ */
 var FailWebhookCommand;
 (function (FailWebhookCommand) {
     FailWebhookCommand.Request = cloudpayments_webhook_schemas_1.CloudPaymentsFailRequestSchema;

package/build/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,uEAA8D;AAC9D,gDAA6C;AAC7C,4FAGkD;AAUlD,IAAiB,kBAAkB,CASlC;AATD,WAAiB,kBAAkB;IAClB,0BAAO,GAAG,8DAA8B,CAAC;IACzC,2BAAQ,GAAG,2DAA2B,CAAC;IAEvC,sBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IACxC,yBAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,kBAAkB,kCAAlB,kBAAkB,QASlC"}
+{"version":3,"file":"fail-webhook.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/fail-webhook.command.ts"],"names":[],"mappings":";;;AACA,uEAA8D;AAC9D,gDAA6C;AAC7C,4FAGkD;AAElD;;;;;;;GAOG;AACH,IAAiB,kBAAkB,CASlC;AATD,WAAiB,kBAAkB;IAClB,0BAAO,GAAG,8DAA8B,CAAC;IACzC,2BAAQ,GAAG,2DAA2B,CAAC;IAEvC,sBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IACxC,yBAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,kBAAkB,kCAAlB,kBAAkB,QASlC"}

package/build/v1/payment/commands/pay-webhook.command.d.ts

@@ -1,5 +1,14 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * 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 declare namespace PayWebhookCommand {
     const Request: z.ZodObject<{
         TotalFee: z.ZodOptional<z.ZodNullable<z.ZodCoercedNumber<unknown>>>;

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

@@ -4,6 +4,15 @@ exports.PayWebhookCommand = void 0;
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 const rest_api_1 = require("../../../rest-api");
 const cloudpayments_webhook_schemas_1 = require("../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().
+ */
 var PayWebhookCommand;
 (function (PayWebhookCommand) {
     PayWebhookCommand.Request = cloudpayments_webhook_schemas_1.CloudPaymentsPayRequestSchema;

package/build/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,uEAA8D;AAC9D,gDAA6C;AAC7C,4FAGkD;AAWlD,IAAiB,iBAAiB,CASjC;AATD,WAAiB,iBAAiB;IACjB,yBAAO,GAAG,6DAA6B,CAAC;IACxC,0BAAQ,GAAG,2DAA2B,CAAC;IAEvC,qBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;IACvC,wBAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,iBAAiB,iCAAjB,iBAAiB,QASjC"}
+{"version":3,"file":"pay-webhook.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/pay-webhook.command.ts"],"names":[],"mappings":";;;AACA,uEAA8D;AAC9D,gDAA6C;AAC7C,4FAGkD;AAElD;;;;;;;;GAQG;AACH,IAAiB,iBAAiB,CASjC;AATD,WAAiB,iBAAiB;IACjB,yBAAO,GAAG,6DAA6B,CAAC;IACxC,0BAAQ,GAAG,2DAA2B,CAAC;IAEvC,qBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;IACvC,wBAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,iBAAiB,iCAAjB,iBAAiB,QASjC"}

package/build/v1/payment/commands/refund-webhook.command.d.ts

@@ -1,5 +1,15 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * 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 declare namespace RefundWebhookCommand {
     const Request: z.ZodObject<{
         TransactionId: z.ZodCoercedNumber<unknown>;

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

@@ -4,6 +4,16 @@ exports.RefundWebhookCommand = void 0;
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 const rest_api_1 = require("../../../rest-api");
 const cloudpayments_webhook_schemas_1 = require("../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().
+ */
 var RefundWebhookCommand;
 (function (RefundWebhookCommand) {
     RefundWebhookCommand.Request = cloudpayments_webhook_schemas_1.CloudPaymentsRefundRequestSchema;

package/build/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,uEAA8D;AAC9D,gDAA6C;AAC7C,4FAGkD;AAYlD,IAAiB,oBAAoB,CASpC;AATD,WAAiB,oBAAoB;IACpB,4BAAO,GAAG,gEAAgC,CAAC;IAC3C,6BAAQ,GAAG,2DAA2B,CAAC;IAEvC,wBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC1C,2BAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,oBAAoB,oCAApB,oBAAoB,QASpC"}
+{"version":3,"file":"refund-webhook.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/refund-webhook.command.ts"],"names":[],"mappings":";;;AACA,uEAA8D;AAC9D,gDAA6C;AAC7C,4FAGkD;AAElD;;;;;;;;;GASG;AACH,IAAiB,oBAAoB,CASpC;AATD,WAAiB,oBAAoB;IACpB,4BAAO,GAAG,gEAAgC,CAAC;IAC3C,6BAAQ,GAAG,2DAA2B,CAAC;IAEvC,wBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC1C,2BAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,oBAAoB,oCAApB,oBAAoB,QASpC"}

package/build/v1/payment/commands/revoke-saved-method.command.d.ts

@@ -1,5 +1,12 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * 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 declare namespace RevokeSavedMethodCommand {
     const Request: z.ZodObject<{
         userId: z.ZodString;
@@ -8,6 +15,7 @@ export declare namespace RevokeSavedMethodCommand {
     const Response: z.ZodObject<{
         revoked: z.ZodBoolean;
     }, z.core.$strip>;
+    /** URL factory — call with savedMethodId to get the full URL. */
     const URL: (id: string) => string;
     const METHOD = HttpMethod.DELETE;
     type RequestType = z.infer<typeof Request>;

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

@@ -5,6 +5,13 @@ const zod_1 = require("zod");
 const shared_1 = require("../../../shared");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 const rest_api_1 = require("../../../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.
+ */
 var RevokeSavedMethodCommand;
 (function (RevokeSavedMethodCommand) {
     RevokeSavedMethodCommand.Request = zod_1.z.object({
@@ -18,6 +25,7 @@ var RevokeSavedMethodCommand;
     RevokeSavedMethodCommand.Response = zod_1.z.object({
         revoked: zod_1.z.boolean(),
     });
+    /** URL factory — call with savedMethodId to get the full URL. */
     RevokeSavedMethodCommand.URL = (id) => rest_api_1.REST_API.V1.PAYMENT.REG.REVOKE_SAVED_METHOD(id);
     RevokeSavedMethodCommand.METHOD = http_method_enum_1.HttpMethod.DELETE;
 })(RevokeSavedMethodCommand || (exports.RevokeSavedMethodCommand = RevokeSavedMethodCommand = {}));

package/build/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,6BAAwB;AACxB,4CAA6C;AAC7C,uEAA8D;AAC9D,gDAA6C;AAS7C,IAAiB,wBAAwB,CAoBxC;AApBD,WAAiB,wBAAwB;IACxB,gCAAO,GAAG,OAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,OAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;aAC7D,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;QAC9E,aAAa,EAAE,OAAC;aACX,MAAM,CAAC,EAAE,KAAK,EAAE,iDAAiD,EAAE,CAAC;aACpE,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;KACxF,CAAC,CAAC;IAEU,iCAAQ,GAAG,OAAC,CAAC,MAAM,CAAC;QAC7B,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;KACvB,CAAC,CAAC;IAGU,4BAAG,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;IACtE,+BAAM,GAAG,6BAAU,CAAC,MAAM,CAAC;AAI5C,CAAC,EApBgB,wBAAwB,wCAAxB,wBAAwB,QAoBxC"}
+{"version":3,"file":"revoke-saved-method.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/revoke-saved-method.command.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6C;AAC7C,uEAA8D;AAC9D,gDAA6C;AAE7C;;;;;;GAMG;AACH,IAAiB,wBAAwB,CAoBxC;AApBD,WAAiB,wBAAwB;IACxB,gCAAO,GAAG,OAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,OAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;aAC7D,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;QAC9E,aAAa,EAAE,OAAC;aACX,MAAM,CAAC,EAAE,KAAK,EAAE,iDAAiD,EAAE,CAAC;aACpE,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;KACxF,CAAC,CAAC;IAEU,iCAAQ,GAAG,OAAC,CAAC,MAAM,CAAC;QAC7B,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;KACvB,CAAC,CAAC;IAEH,iEAAiE;IACpD,4BAAG,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;IACtE,+BAAM,GAAG,6BAAU,CAAC,MAAM,CAAC;AAI5C,CAAC,EApBgB,wBAAwB,wCAAxB,wBAAwB,QAoBxC"}

package/build/v1/payment/commands/set-default-saved-method.command.d.ts

@@ -1,5 +1,16 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * 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 declare namespace SetDefaultSavedMethodCommand {
     const Request: z.ZodObject<{
         userId: z.ZodString;
@@ -20,6 +31,7 @@ export declare namespace SetDefaultSavedMethodCommand {
         isDefault: z.ZodBoolean;
         createdAt: z.ZodString;
     }, z.core.$strip>;
+    /** URL factory — call with savedMethodId to get the full URL. */
     const URL: (id: string) => string;
     const METHOD = HttpMethod.PATCH;
     type RequestType = z.infer<typeof Request>;

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

@@ -6,6 +6,17 @@ const shared_1 = require("../../../shared");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 const rest_api_1 = require("../../../rest-api");
 const get_saved_methods_query_1 = require("../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.
+ */
 var SetDefaultSavedMethodCommand;
 (function (SetDefaultSavedMethodCommand) {
     SetDefaultSavedMethodCommand.Request = zod_1.z.object({
@@ -17,6 +28,7 @@ var SetDefaultSavedMethodCommand;
             .regex(shared_1.UUID_REGEX, { message: 'SetDefaultSavedMethodCommand.savedMethodId.invalid' }),
     });
     SetDefaultSavedMethodCommand.Response = get_saved_methods_query_1.SavedPaymentMethodViewSchema;
+    /** URL factory — call with savedMethodId to get the full URL. */
     SetDefaultSavedMethodCommand.URL = (id) => rest_api_1.REST_API.V1.PAYMENT.REG.SET_DEFAULT_SAVED_METHOD(id);
     SetDefaultSavedMethodCommand.METHOD = http_method_enum_1.HttpMethod.PATCH;
 })(SetDefaultSavedMethodCommand || (exports.SetDefaultSavedMethodCommand = SetDefaultSavedMethodCommand = {}));

package/build/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,6BAAwB;AACxB,4CAA6C;AAC7C,uEAA8D;AAC9D,gDAA6C;AAC7C,gFAAkF;AAalF,IAAiB,4BAA4B,CAkB5C;AAlBD,WAAiB,4BAA4B;IAC5B,oCAAO,GAAG,OAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,OAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,8CAA8C,EAAE,CAAC;aACjE,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;QAClF,aAAa,EAAE,OAAC;aACX,MAAM,CAAC,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC;aACxE,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC;KAC5F,CAAC,CAAC;IAEU,qCAAQ,GAAG,sDAA4B,CAAC;IAGxC,gCAAG,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC;IAC3E,mCAAM,GAAG,6BAAU,CAAC,KAAK,CAAC;AAI3C,CAAC,EAlBgB,4BAA4B,4CAA5B,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,6BAAwB;AACxB,4CAA6C;AAC7C,uEAA8D;AAC9D,gDAA6C;AAC7C,gFAAkF;AAElF;;;;;;;;;;GAUG;AACH,IAAiB,4BAA4B,CAkB5C;AAlBD,WAAiB,4BAA4B;IAC5B,oCAAO,GAAG,OAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,OAAC;aACJ,MAAM,CAAC,EAAE,KAAK,EAAE,8CAA8C,EAAE,CAAC;aACjE,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;QAClF,aAAa,EAAE,OAAC;aACX,MAAM,CAAC,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC;aACxE,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC;KAC5F,CAAC,CAAC;IAEU,qCAAQ,GAAG,sDAA4B,CAAC;IAErD,iEAAiE;IACpD,gCAAG,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC;IAC3E,mCAAM,GAAG,6BAAU,CAAC,KAAK,CAAC;AAI3C,CAAC,EAlBgB,4BAA4B,4CAA5B,4BAA4B,QAkB5C"}

package/build/v1/payment/commands/three-ds-complete.command.d.ts

@@ -1,5 +1,15 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * 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 declare namespace ThreeDsCompleteCommand {
     const Request: z.ZodObject<{
         MD: z.ZodString;

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

@@ -4,6 +4,16 @@ exports.ThreeDsCompleteCommand = void 0;
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 const rest_api_1 = require("../../../rest-api");
 const three_ds_complete_schema_1 = require("../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.
+ */
 var ThreeDsCompleteCommand;
 (function (ThreeDsCompleteCommand) {
     ThreeDsCompleteCommand.Request = three_ds_complete_schema_1.ThreeDsCompleteRequestSchema;

package/build/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,uEAA8D;AAC9D,gDAA6C;AAC7C,kFAAmF;AAYnF,IAAiB,sBAAsB,CAOtC;AAPD,WAAiB,sBAAsB;IACtB,8BAAO,GAAG,uDAA4B,CAAC;IAEvC,0BAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC5C,6BAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAG1C,CAAC,EAPgB,sBAAsB,sCAAtB,sBAAsB,QAOtC"}
+{"version":3,"file":"three-ds-complete.command.js","sourceRoot":"","sources":["../../../../v1/payment/commands/three-ds-complete.command.ts"],"names":[],"mappings":";;;AACA,uEAA8D;AAC9D,gDAA6C;AAC7C,kFAAmF;AAEnF;;;;;;;;;GASG;AACH,IAAiB,sBAAsB,CAOtC;AAPD,WAAiB,sBAAsB;IACtB,8BAAO,GAAG,uDAA4B,CAAC;IAEvC,0BAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC5C,6BAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAG1C,CAAC,EAPgB,sBAAsB,sCAAtB,sBAAsB,QAOtC"}

package/build/v1/payment/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./payment.errors"), exports);
 __exportStar(require("./commands"), exports);
 __exportStar(require("./queries"), exports);
 __exportStar(require("./admin"), exports);
+// Re-export from centralized locations
 var controllers_1 = require("../../controllers");
 Object.defineProperty(exports, "PAYMENT_CONTROLLER", { enumerable: true, get: function () { return controllers_1.PAYMENT_CONTROLLER; } });
 Object.defineProperty(exports, "PAYMENT_WEBHOOKS_CONTROLLER", { enumerable: true, get: function () { return controllers_1.PAYMENT_WEBHOOKS_CONTROLLER; } });

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/payment/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,mDAAiC;AACjC,6CAA2B;AAC3B,4CAA0B;AAC1B,0CAAwB;AAExB,iDAAsI;AAA7H,iHAAA,kBAAkB,OAAA;AAAE,0HAAA,2BAA2B,OAAA;AAAE,uHAAA,wBAAwB,OAAA;AAAE,qHAAA,sBAAsB,OAAA;AAC1G,uCAAiH;AAAxG,wGAAA,cAAc,OAAA;AAAE,iHAAA,uBAAuB,OAAA;AAAE,8GAAA,oBAAoB,OAAA;AAAE,4GAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/payment/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,mDAAiC;AACjC,6CAA2B;AAC3B,4CAA0B;AAC1B,0CAAwB;AACxB,uCAAuC;AACvC,iDAAsI;AAA7H,iHAAA,kBAAkB,OAAA;AAAE,0HAAA,2BAA2B,OAAA;AAAE,uHAAA,wBAAwB,OAAA;AAAE,qHAAA,sBAAsB,OAAA;AAC1G,uCAAiH;AAAxG,wGAAA,cAAc,OAAA;AAAE,iHAAA,uBAAuB,OAAA;AAAE,8GAAA,oBAAoB,OAAA;AAAE,4GAAA,kBAAkB,OAAA"}

package/build/v1/payment/payment.errors.d.ts

@@ -1,27 +1,64 @@
 import { ErrorMetadata } from '../../shared';
+/**
+ * Error codes for the payment module.
+ * All codes are mapped to HTTP status codes in PAYMENT_ERRORS.
+ */
 export declare enum PaymentErrorCode {
+    /** Order not found by ID. */
     ORDER_NOT_FOUND = "ORDER_NOT_FOUND",
+    /** Amount in pay/check webhook does not match server-stored order amount. */
     ORDER_AMOUNT_MISMATCH = "ORDER_AMOUNT_MISMATCH",
+    /** Attempt to fulfill an already-fulfilled order (idempotency guard). */
     ORDER_ALREADY_FULFILLED = "ORDER_ALREADY_FULFILLED",
+    /** HMAC signature on webhook request failed verification. */
     WEBHOOK_SIGNATURE_INVALID = "WEBHOOK_SIGNATURE_INVALID",
+    /** No active SavedPaymentMethod found for the user (cannot run recurrent charge). */
     NO_SAVED_METHOD = "NO_SAVED_METHOD",
+    /** Saved method exists but is not ACTIVE (revoked/expired) — cannot be set as default. */
     SAVED_METHOD_NOT_ACTIVE = "SAVED_METHOD_NOT_ACTIVE",
+    /** Recurrent charge was synchronously declined by the payment gateway. */
     CHARGE_DECLINED = "CHARGE_DECLINED",
+    /** Order has already expired (TTL elapsed). */
     ORDER_EXPIRED = "ORDER_EXPIRED",
+    /** Order cannot be cancelled because it is already paid (or otherwise non-pending). */
     ORDER_NOT_CANCELLABLE = "ORDER_NOT_CANCELLABLE",
+    /** Order is not in a refundable state (not PAID, or no confirmed payment to refund). */
     ORDER_NOT_REFUNDABLE = "ORDER_NOT_REFUNDABLE",
+    /** Gateway rejected the refund request. */
     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.
+     */
     REFUND_OUTCOME_UNKNOWN = "REFUND_OUTCOME_UNKNOWN",
+    /** Payment gateway provider value from DB is not a recognised PaymentProvider enum member. */
     PAYMENT_PROVIDER_UNSUPPORTED = "PAYMENT_PROVIDER_UNSUPPORTED",
+    /** Order acceptance check failed — see OrderAcceptanceDecision for specific reason. */
     ORDER_ACCEPTANCE_FAILED = "ORDER_ACCEPTANCE_FAILED",
+    /** Subscription linked to a refunded order not found for revocation. */
     SUBSCRIPTION_NOT_FOUND_FOR_REVOCATION = "SUBSCRIPTION_NOT_FOUND_FOR_REVOCATION",
+    /** Currency value from DB or external source is not a recognised Currency enum member. */
     INVALID_CURRENCY = "INVALID_CURRENCY",
+    /** Amount value from external webhook is not a finite number (NaN, Infinity). */
     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.
+     */
     ORDER_CHARGE_IN_FLIGHT = "ORDER_CHARGE_IN_FLIGHT",
+    /** Payment not found by id or provider transaction id. */
     PAYMENT_NOT_FOUND = "PAYMENT_NOT_FOUND",
+    /** Refund not found by id. */
     REFUND_NOT_FOUND = "REFUND_NOT_FOUND",
+    /** A refund of this payment is already in flight (REQUESTED), or the payment already has its automatic refund. */
     REFUND_ALREADY_REQUESTED = "REFUND_ALREADY_REQUESTED",
+    /** The refund status does not allow this transition. */
     REFUND_INVALID_TRANSITION = "REFUND_INVALID_TRANSITION",
+    /** The payment status does not allow this transition. */
     PAYMENT_INVALID_TRANSITION = "PAYMENT_INVALID_TRANSITION"
 }
 export declare const PAYMENT_ERRORS: Record<PaymentErrorCode, ErrorMetadata>;