@fiado/type-kit 3.122.0 → 3.123.0

package/bin/transactionProcessor/dtos/PublishFiadoTxRequest.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Request del endpoint `POST /wallet-funding/publish` del processor.
+ *
+ * Publica el evento de FiadoTx (tupla EQ_CASH_SA / CASH_IN del wallet-funding
+ * cash-in) al SQS `TRANSACTION_QUEUE` para que `transaction-business` lo
+ * consuma y persista en `FiadoTx_GT`.
+ *
+ * Best-effort: el caller (equality-connector post-settlement, o el cron de
+ * gap-reconciliation del mismo connector) debe tratar el error como
+ * recuperable — el reconciler T+0 rescata gaps que queden.
+ *
+ * Ver spec 15 §6.2 (processor mantiene ownership del SQS publish) + §5.1
+ * (reconciler en el connector).
+ */
+export declare class PublishFiadoTxRequest {
+    /** Identificador idempotente del evento. Sugerido: `${providerName}:${providerTxId}`. */
+    idempotencyKey: string;
+    /**
+     * Spec completo de la tupla FiadoTx a persistir. Shape generado por el
+     * processor en `walletFundingValidate()` (campo `fiadoTxSpec` de la response).
+     * El caller lo recibe del processor y lo reenvía sin modificar.
+     *
+     * Es `unknown` aquí (no tipado fuerte) porque el shape interno del processor
+     * puede cambiar sin breaking change para los callers — el processor es dueño
+     * del shape y de su serialización al SQS.
+     */
+    fiadoTxSpec: Record<string, unknown>;
+    /** Contexto opcional para logs/auditoría (ej. "post-settlement" | "reconciler-gap"). */
+    origin?: string;
+}

package/bin/transactionProcessor/dtos/PublishFiadoTxRequest.js

@@ -0,0 +1,45 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PublishFiadoTxRequest = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Request del endpoint `POST /wallet-funding/publish` del processor.
+ *
+ * Publica el evento de FiadoTx (tupla EQ_CASH_SA / CASH_IN del wallet-funding
+ * cash-in) al SQS `TRANSACTION_QUEUE` para que `transaction-business` lo
+ * consuma y persista en `FiadoTx_GT`.
+ *
+ * Best-effort: el caller (equality-connector post-settlement, o el cron de
+ * gap-reconciliation del mismo connector) debe tratar el error como
+ * recuperable — el reconciler T+0 rescata gaps que queden.
+ *
+ * Ver spec 15 §6.2 (processor mantiene ownership del SQS publish) + §5.1
+ * (reconciler en el connector).
+ */
+class PublishFiadoTxRequest {
+}
+exports.PublishFiadoTxRequest = PublishFiadoTxRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(128),
+    __metadata("design:type", String)
+], PublishFiadoTxRequest.prototype, "idempotencyKey", void 0);
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], PublishFiadoTxRequest.prototype, "fiadoTxSpec", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], PublishFiadoTxRequest.prototype, "origin", void 0);

package/bin/transactionProcessor/dtos/PublishFiadoTxResponse.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Response del endpoint `POST /wallet-funding/publish` del processor.
+ *
+ * Best-effort: status="FAILED" indica que el publish al SQS no se ejecutó
+ * (sqs.sendMessage falló). El caller debe loggear y continuar — el
+ * reconciler T+0 del connector eventualmente recuperará el gap.
+ *
+ * Ver spec 15 §6.2.
+ */
+export interface PublishFiadoTxResponse {
+    status: "OK" | "FAILED";
+    /** Mensaje breve para logs. Vacío en happy path. */
+    message?: string;
+}

package/bin/transactionProcessor/dtos/PublishFiadoTxResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/transactionProcessor/index.d.ts

@@ -39,6 +39,8 @@ export * from './dtos/ProviderProcessServicePaymentTransactionRequest';
 export * from './dtos/ProviderProcessServicePaymentTransactionResponse';
 export * from './dtos/AuthorizeRenewalPreAuthRequest';
 export * from './dtos/AuthorizeRenewalPreAuthResponse';
+export * from './dtos/PublishFiadoTxRequest';
+export * from './dtos/PublishFiadoTxResponse';
 export * from './enums/TransactionProcessorCodesEnum';
 export * from './enums/AsyncTxStatusEnum';
 export * from './enums/AppEnum';

package/bin/transactionProcessor/index.js

@@ -55,6 +55,8 @@ __exportStar(require("./dtos/ProviderProcessServicePaymentTransactionRequest"),
 __exportStar(require("./dtos/ProviderProcessServicePaymentTransactionResponse"), exports);
 __exportStar(require("./dtos/AuthorizeRenewalPreAuthRequest"), exports);
 __exportStar(require("./dtos/AuthorizeRenewalPreAuthResponse"), exports);
+__exportStar(require("./dtos/PublishFiadoTxRequest"), exports);
+__exportStar(require("./dtos/PublishFiadoTxResponse"), exports);
 __exportStar(require("./enums/TransactionProcessorCodesEnum"), exports);
 __exportStar(require("./enums/AsyncTxStatusEnum"), exports);
 __exportStar(require("./enums/AppEnum"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.122.0",
+  "version": "3.123.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/transactionProcessor/dtos/PublishFiadoTxRequest.ts

@@ -0,0 +1,34 @@
+import { IsObject, IsOptional, IsString, MaxLength } from "class-validator";
+
+/**
+ * Request del endpoint `POST /wallet-funding/publish` del processor.
+ *
+ * Publica el evento de FiadoTx (tupla EQ_CASH_SA / CASH_IN del wallet-funding
+ * cash-in) al SQS `TRANSACTION_QUEUE` para que `transaction-business` lo
+ * consuma y persista en `FiadoTx_GT`.
+ *
+ * Best-effort: el caller (equality-connector post-settlement, o el cron de
+ * gap-reconciliation del mismo connector) debe tratar el error como
+ * recuperable — el reconciler T+0 rescata gaps que queden.
+ *
+ * Ver spec 15 §6.2 (processor mantiene ownership del SQS publish) + §5.1
+ * (reconciler en el connector).
+ */
+export class PublishFiadoTxRequest {
+    /** Identificador idempotente del evento. Sugerido: `${providerName}:${providerTxId}`. */
+    @IsString() @MaxLength(128) idempotencyKey!: string;
+
+    /**
+     * Spec completo de la tupla FiadoTx a persistir. Shape generado por el
+     * processor en `walletFundingValidate()` (campo `fiadoTxSpec` de la response).
+     * El caller lo recibe del processor y lo reenvía sin modificar.
+     *
+     * Es `unknown` aquí (no tipado fuerte) porque el shape interno del processor
+     * puede cambiar sin breaking change para los callers — el processor es dueño
+     * del shape y de su serialización al SQS.
+     */
+    @IsObject() fiadoTxSpec!: Record<string, unknown>;
+
+    /** Contexto opcional para logs/auditoría (ej. "post-settlement" | "reconciler-gap"). */
+    @IsOptional() @IsString() @MaxLength(64) origin?: string;
+}

package/src/transactionProcessor/dtos/PublishFiadoTxResponse.ts

@@ -0,0 +1,14 @@
+/**
+ * Response del endpoint `POST /wallet-funding/publish` del processor.
+ *
+ * Best-effort: status="FAILED" indica que el publish al SQS no se ejecutó
+ * (sqs.sendMessage falló). El caller debe loggear y continuar — el
+ * reconciler T+0 del connector eventualmente recuperará el gap.
+ *
+ * Ver spec 15 §6.2.
+ */
+export interface PublishFiadoTxResponse {
+    status: "OK" | "FAILED";
+    /** Mensaje breve para logs. Vacío en happy path. */
+    message?: string;
+}

package/src/transactionProcessor/index.ts

@@ -39,6 +39,8 @@ export * from './dtos/ProviderProcessServicePaymentTransactionRequest';
 export * from './dtos/ProviderProcessServicePaymentTransactionResponse';
 export * from './dtos/AuthorizeRenewalPreAuthRequest';
 export * from './dtos/AuthorizeRenewalPreAuthResponse';
+export * from './dtos/PublishFiadoTxRequest';
+export * from './dtos/PublishFiadoTxResponse';
 
 export * from './enums/TransactionProcessorCodesEnum';
 export * from './enums/AsyncTxStatusEnum';