@fiado/type-kit 3.616.0 → 3.618.0

package/bin/transactionProcessor/dtos/PrivateAuthorizeReconciliationAdjustmentRequest.js

@@ -0,0 +1,107 @@
+"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.PrivateAuthorizeReconciliationAdjustmentRequest = exports.AdjustmentKeyOfTenantConstraint = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const regex_1 = require("../../helpers/constans/regex");
+const CurrencyId_1 = require("../../currency/enums/CurrencyId");
+const OperationEnum_1 = require("../../transaction/enums/OperationEnum");
+const ReconciliationAdjustmentReference_1 = require("./ReconciliationAdjustmentReference");
+/** La llave `{tenantId}#{definitionId}#{itemKey}#{resolutionVersion}` debe empezar con el tenant del body. */
+let AdjustmentKeyOfTenantConstraint = class AdjustmentKeyOfTenantConstraint {
+    validate(value, args) {
+        const { tenantId } = args.object;
+        return typeof value === 'string' && typeof tenantId === 'string' && tenantId.length > 0
+            && value.startsWith(`${tenantId}#`) && value.split('#').length >= 4;
+    }
+    defaultMessage() {
+        return 'adjustmentKey debe ser {tenantId}#{definitionId}#{itemKey}#{resolutionVersion}';
+    }
+};
+exports.AdjustmentKeyOfTenantConstraint = AdjustmentKeyOfTenantConstraint;
+exports.AdjustmentKeyOfTenantConstraint = AdjustmentKeyOfTenantConstraint = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'adjustmentKeyOfTenant' })
+], AdjustmentKeyOfTenantConstraint);
+/** Body de privateAuthorizeReconciliationAdjustment: ajuste al cliente idempotente por `adjustmentKey`. */
+class PrivateAuthorizeReconciliationAdjustmentRequest {
+}
+exports.PrivateAuthorizeReconciliationAdjustmentRequest = PrivateAuthorizeReconciliationAdjustmentRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], PrivateAuthorizeReconciliationAdjustmentRequest.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.Validate)(AdjustmentKeyOfTenantConstraint),
+    __metadata("design:type", String)
+], PrivateAuthorizeReconciliationAdjustmentRequest.prototype, "adjustmentKey", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.Matches)(regex_1.regexUuidV4, { message: 'directoryId must be a valid UUID v4' }),
+    __metadata("design:type", String)
+], PrivateAuthorizeReconciliationAdjustmentRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(OperationEnum_1.OperationEnum),
+    __metadata("design:type", String)
+], PrivateAuthorizeReconciliationAdjustmentRequest.prototype, "operation", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], PrivateAuthorizeReconciliationAdjustmentRequest.prototype, "amountCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(CurrencyId_1.CurrencyId),
+    __metadata("design:type", String)
+], PrivateAuthorizeReconciliationAdjustmentRequest.prototype, "currencyId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], PrivateAuthorizeReconciliationAdjustmentRequest.prototype, "originalTransactionId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], PrivateAuthorizeReconciliationAdjustmentRequest.prototype, "executionId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => ReconciliationAdjustmentReference_1.ReconciliationAdjustmentReference),
+    __metadata("design:type", ReconciliationAdjustmentReference_1.ReconciliationAdjustmentReference)
+], PrivateAuthorizeReconciliationAdjustmentRequest.prototype, "reference", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.trim() : value)),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], PrivateAuthorizeReconciliationAdjustmentRequest.prototype, "reason", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEmail)(),
+    __metadata("design:type", String)
+], PrivateAuthorizeReconciliationAdjustmentRequest.prototype, "actor", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], PrivateAuthorizeReconciliationAdjustmentRequest.prototype, "author", void 0);

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

@@ -0,0 +1,7 @@
+/** Respuesta de privateAuthorizeReconciliationAdjustment; un `adjustmentKey` repetido devuelve el primer movimiento. */
+export interface PrivateAuthorizeReconciliationAdjustmentResponse {
+    adjustmentKey: string;
+    transactionId: string;
+    /** `true` si la llave ya existía y no se movió dinero otra vez. */
+    replayed: boolean;
+}

package/bin/transactionProcessor/dtos/PrivateAuthorizeReconciliationAdjustmentResponse.js

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

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

@@ -0,0 +1,5 @@
+/** Partida del motor que pidió el ajuste. */
+export declare class ReconciliationAdjustmentReference {
+    definitionId: string;
+    itemKey: string;
+}

package/bin/transactionProcessor/dtos/ReconciliationAdjustmentReference.js

@@ -0,0 +1,30 @@
+"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.ReconciliationAdjustmentReference = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Partida del motor que pidió el ajuste. */
+class ReconciliationAdjustmentReference {
+}
+exports.ReconciliationAdjustmentReference = ReconciliationAdjustmentReference;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ReconciliationAdjustmentReference.prototype, "definitionId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ReconciliationAdjustmentReference.prototype, "itemKey", void 0);

package/bin/transactionProcessor/index.d.ts

@@ -42,6 +42,9 @@ export * from './dtos/AuthorizeRenewalPreAuthRequest';
 export * from './dtos/AuthorizeRenewalPreAuthResponse';
 export * from './dtos/PublishFiadoTxRequest';
 export * from './dtos/PublishFiadoTxResponse';
+export * from './dtos/ReconciliationAdjustmentReference';
+export * from './dtos/PrivateAuthorizeReconciliationAdjustmentRequest';
+export * from './dtos/PrivateAuthorizeReconciliationAdjustmentResponse';
 export * from './enums/TransactionProcessorCodesEnum';
 export * from './enums/AsyncTxStatusEnum';
 export * from './enums/AppEnum';

package/bin/transactionProcessor/index.js

@@ -58,6 +58,9 @@ __exportStar(require("./dtos/AuthorizeRenewalPreAuthRequest"), exports);
 __exportStar(require("./dtos/AuthorizeRenewalPreAuthResponse"), exports);
 __exportStar(require("./dtos/PublishFiadoTxRequest"), exports);
 __exportStar(require("./dtos/PublishFiadoTxResponse"), exports);
+__exportStar(require("./dtos/ReconciliationAdjustmentReference"), exports);
+__exportStar(require("./dtos/PrivateAuthorizeReconciliationAdjustmentRequest"), exports);
+__exportStar(require("./dtos/PrivateAuthorizeReconciliationAdjustmentResponse"), exports);
 __exportStar(require("./enums/TransactionProcessorCodesEnum"), exports);
 __exportStar(require("./enums/AsyncTxStatusEnum"), exports);
 __exportStar(require("./enums/AppEnum"), exports);

package/bin/transferNote/constants/transferNoteDefaultFees.d.ts

@@ -0,0 +1,5 @@
+/** Tarifa por omisión en centavos por crédito firmado (REQ-52), si el tenant no configura otra. */
+export declare const TRANSFER_NOTE_DEFAULT_FEE_CENTS: {
+    readonly ORIGINATION_BONUS: 5000;
+    readonly ACCOUNT_OPENING: 2500;
+};

package/bin/transferNote/constants/transferNoteDefaultFees.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRANSFER_NOTE_DEFAULT_FEE_CENTS = void 0;
+const TransferNoteConceptEnum_1 = require("../enums/TransferNoteConceptEnum");
+/** Tarifa por omisión en centavos por crédito firmado (REQ-52), si el tenant no configura otra. */
+exports.TRANSFER_NOTE_DEFAULT_FEE_CENTS = {
+    [TransferNoteConceptEnum_1.TransferNoteConceptEnum.ORIGINATION_BONUS]: 5000,
+    [TransferNoteConceptEnum_1.TransferNoteConceptEnum.ACCOUNT_OPENING]: 2500,
+};

package/bin/transferNote/constants/transferNoteErrorHttpStatus.d.ts

@@ -0,0 +1,3 @@
+import { TransferNoteErrorCodeEnum as C } from '../enums/TransferNoteErrorCodeEnum';
+/** Status HTTP de cada code: 400 request inválido · 404 no existe · 409 conflicto de estado · 422 regla de negocio. */
+export declare const TRANSFER_NOTE_ERROR_HTTP_STATUS: Readonly<Record<C, 400 | 404 | 409 | 422>>;

package/bin/transferNote/constants/transferNoteErrorHttpStatus.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRANSFER_NOTE_ERROR_HTTP_STATUS = void 0;
+const reconciliationErrorHttpStatus_1 = require("../../reconciliation/constants/reconciliationErrorHttpStatus");
+const ReconciliationFeedErrorCodeEnum_1 = require("../../reconciliation/enums/ReconciliationFeedErrorCodeEnum");
+const TransferNoteErrorCodeEnum_1 = require("../enums/TransferNoteErrorCodeEnum");
+/** Status HTTP de cada code: 400 request inválido · 404 no existe · 409 conflicto de estado · 422 regla de negocio. */
+exports.TRANSFER_NOTE_ERROR_HTTP_STATUS = {
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.TRANSFER_NOTE_NOT_FOUND]: 404,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.NOTE_NOT_DISPUTABLE]: 409,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.NET_NOT_POSITIVE]: 422,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.NOT_NOTE_CONTROLLER]: 422,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.PAYEE_ACCOUNT_NOT_REGISTERED]: 422,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.ITEM_ALREADY_INCLUDED]: 409,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.WEEK_ALREADY_CUT]: 409,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.NOTE_NOT_ISSUED]: 409,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.NOTE_DISPUTED]: 409,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.NOT_NOTE_PAYER]: 422,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.NOTE_NOT_SENT]: 409,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.NOT_NOTE_PAYEE]: 422,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.NOTE_NOT_DISPUTED]: 409,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.CONTACT_EMAIL_MISSING]: 422,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.INVALID_CONFIG_RECORD_TYPE]: 400,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.AUTHOR_NOT_ALLOWED]: 422,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.SETTLEMENT_NOT_REQUIRED]: 422,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.RUN_IN_PROGRESS]: 409,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.SOURCE_ITEM_NOT_FOUND]: 404,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.TRANSFER_NOTE_ITEM_NOT_FOUND]: 404,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.FEED_RECORD_NOT_FOUND]: reconciliationErrorHttpStatus_1.RECONCILIATION_FEED_ERROR_HTTP_STATUS[ReconciliationFeedErrorCodeEnum_1.ReconciliationFeedErrorCodeEnum.FEED_RECORD_NOT_FOUND],
+};

package/bin/transferNote/constants/transferNoteValidation.d.ts

@@ -0,0 +1,7 @@
+/** Largo mínimo de la razón de una emisión manual y de una objeción. */
+export declare const TRANSFER_NOTE_MIN_REASON_LENGTH = 20;
+/** Semana ISO `YYYY-Www`, p. ej. `2026-W43`. */
+export declare const TRANSFER_NOTE_ISO_WEEK_PATTERN: RegExp;
+/** CLABE interbancaria de 18 dígitos. */
+export declare const TRANSFER_NOTE_CLABE_PATTERN: RegExp;
+export declare const TRANSFER_NOTE_MAX_PAGE_SIZE = 100;

package/bin/transferNote/constants/transferNoteValidation.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRANSFER_NOTE_MAX_PAGE_SIZE = exports.TRANSFER_NOTE_CLABE_PATTERN = exports.TRANSFER_NOTE_ISO_WEEK_PATTERN = exports.TRANSFER_NOTE_MIN_REASON_LENGTH = void 0;
+/** Largo mínimo de la razón de una emisión manual y de una objeción. */
+exports.TRANSFER_NOTE_MIN_REASON_LENGTH = 20;
+/** Semana ISO `YYYY-Www`, p. ej. `2026-W43`. */
+exports.TRANSFER_NOTE_ISO_WEEK_PATTERN = /^\d{4}-W(0[1-9]|[1-4]\d|5[0-3])$/;
+/** CLABE interbancaria de 18 dígitos. */
+exports.TRANSFER_NOTE_CLABE_PATTERN = /^\d{18}$/;
+exports.TRANSFER_NOTE_MAX_PAGE_SIZE = 100;

package/bin/transferNote/dtos/TransferNote.d.ts

@@ -0,0 +1,81 @@
+import { CurrencyId } from '../../currency/enums/CurrencyId';
+import { TransferNoteConceptEnum } from '../enums/TransferNoteConceptEnum';
+import { TransferNoteConfirmationSourceEnum } from '../enums/TransferNoteConfirmationSourceEnum';
+import { TransferNoteConfirmationTypeEnum } from '../enums/TransferNoteConfirmationTypeEnum';
+import { TransferNoteDisputeCategoryEnum } from '../enums/TransferNoteDisputeCategoryEnum';
+import { TransferNoteIssueOriginEnum } from '../enums/TransferNoteIssueOriginEnum';
+import { TransferNotePartyTypeEnum } from '../enums/TransferNotePartyTypeEnum';
+import { TransferNoteStatusEnum } from '../enums/TransferNoteStatusEnum';
+/** Parte de una nota, sin datos de contacto ni de cuenta. */
+export interface TransferNoteParty {
+    partyId: string;
+    partyType: TransferNotePartyTypeEnum;
+    /** Solo en partes RETAILER. */
+    retailerId?: string;
+}
+export interface TransferNoteSubtotal {
+    concept: TransferNoteConceptEnum;
+    amountCents: number;
+    itemCount: number;
+}
+export interface TransferNoteSpeiPayment {
+    trackingKey: string;
+    paidAt: string;
+    amountCents: number;
+    capturedBy: string;
+    capturedAt: string;
+    receiptUploaded: boolean;
+}
+export interface TransferNoteConfirmation {
+    type: TransferNoteConfirmationTypeEnum;
+    source: TransferNoteConfirmationSourceEnum;
+    confirmedBy: string;
+    confirmedAt: string;
+}
+export interface TransferNoteDispute {
+    category: TransferNoteDisputeCategoryEnum;
+    reason: string;
+    disputedBy: string;
+    disputedAt: string;
+    /** Estado al que vuelve la nota si se rechaza la objeción. */
+    previousStatus: TransferNoteStatusEnum;
+}
+/** Fila de los listados de notas. */
+export interface TransferNoteSummary {
+    noteId: string;
+    tenantId: string;
+    pairKey: string;
+    isoWeek: string;
+    payer: TransferNoteParty;
+    payee: TransferNoteParty;
+    /** Calculado de pagador y receptor; no se guarda. */
+    controllerPartyType: TransferNotePartyTypeEnum;
+    status: TransferNoteStatusEnum;
+    issueOrigin: TransferNoteIssueOriginEnum;
+    netAmountCents: number;
+    currency: CurrencyId;
+    itemCount: number;
+    issuedAt?: string;
+    dueAt?: string;
+}
+/** Detalle de una nota. */
+export interface TransferNote extends TransferNoteSummary {
+    subtotals: TransferNoteSubtotal[];
+    requiredConfirmations: TransferNoteConfirmationTypeEnum[];
+    confirmations: TransferNoteConfirmation[];
+    /** Razón de la emisión manual. */
+    issueReason?: string;
+    speiPayment?: TransferNoteSpeiPayment;
+    dispute?: TransferNoteDispute;
+    /** Nota cancelada de la que nace esta, o la regenerada que la reemplaza. */
+    regeneratedFromNoteId?: string;
+    regeneratedNoteId?: string;
+    createdAt: string;
+    createdBy: string;
+    updatedAt: string;
+    updatedBy?: string;
+}
+export interface TransferNoteStatusCount {
+    status: TransferNoteStatusEnum;
+    count: number;
+}

package/bin/transferNote/dtos/TransferNote.js

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

package/bin/transferNote/dtos/TransferNoteConfigRecords.d.ts

@@ -0,0 +1,50 @@
+import { CurrencyId } from '../../currency/enums/CurrencyId';
+import { TransferNoteConceptEnum } from '../enums/TransferNoteConceptEnum';
+import { TransferNoteConceptSignEnum } from '../enums/TransferNoteConceptSignEnum';
+import { TransferNoteConfigRecordTypeEnum } from '../enums/TransferNoteConfigRecordTypeEnum';
+import { TransferNotePartyTypeEnum } from '../enums/TransferNotePartyTypeEnum';
+/** Registro TENANT. */
+export interface TransferNoteTenantSettings {
+    activeFrom: string;
+    currency: CurrencyId;
+}
+/** Registro PARTY#partyId: la cuenta destino y el correo de contacto de una parte. */
+export interface TransferNotePartySettings {
+    partyId: string;
+    partyType: TransferNotePartyTypeEnum;
+    displayName: string;
+    retailerId?: string;
+    clabe?: string;
+    contactEmail?: string;
+}
+/** Registro CONCEPT#concept: a qué tipo de par va, con qué signo y desde cuándo. */
+export interface TransferNoteConceptSettings {
+    concept: TransferNoteConceptEnum;
+    payerPartyType: TransferNotePartyTypeEnum;
+    payeePartyType: TransferNotePartyTypeEnum;
+    sign: TransferNoteConceptSignEnum;
+    activeFrom: string;
+    /** Tarifa por crédito firmado, solo en conceptos derivados. */
+    rateCents?: number;
+}
+/** Registro PAIR#pairKey con su contador de cortes sin emitir. */
+export interface TransferNotePairSettings {
+    pairKey: string;
+    payerPartyId: string;
+    payeePartyId: string;
+    activeFrom: string;
+    consecutiveUnissuedCutoffs: number;
+    /** Se llena al 4.º corte seguido sin emitir. */
+    discrepancyOpenedAt?: string;
+}
+/** Un registro de configuración; trae solo el sub-shape de su `recordType`. */
+export interface TransferNoteConfigRecord {
+    recordKey: string;
+    recordType: TransferNoteConfigRecordTypeEnum;
+    tenant?: TransferNoteTenantSettings;
+    party?: TransferNotePartySettings;
+    concept?: TransferNoteConceptSettings;
+    pair?: TransferNotePairSettings;
+    updatedAt: string;
+    updatedBy: string;
+}

package/bin/transferNote/dtos/TransferNoteConfigRecords.js

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

package/bin/transferNote/dtos/TransferNoteFeedRecords.d.ts

@@ -0,0 +1,38 @@
+import type { ReconciliationFeedRecord, ReconciliationFeedRefs } from '../../reconciliation/dtos/ReconciliationFeedRecord';
+import type { ReconciliationFeedConceptEnum } from '../../reconciliation/enums/ReconciliationFeedConceptEnum';
+import { TransferNoteConceptEnum } from '../enums/TransferNoteConceptEnum';
+import { TransferNotePartyTypeEnum } from '../enums/TransferNotePartyTypeEnum';
+import { TransferNoteStatusEnum } from '../enums/TransferNoteStatusEnum';
+/** Registro del feed TRANSFER_NOTE_ITEM: un item ya incluido en una nota; `recordId` es su itemId. */
+export interface TransferNoteItemFeedRecord extends ReconciliationFeedRecord {
+    concept: ReconciliationFeedConceptEnum.TRANSFER_NOTE_ITEM;
+    /** `matchKey` del registro de origen; `feedDay` es el día CDMX de `includedAt`. */
+    refs: ReconciliationFeedRefs & {
+        noteId: string;
+        itemId: string;
+    };
+    itemConcept: TransferNoteConceptEnum;
+    pairKey: string;
+    /** `recordId` en el feed del dueño del que salió el item. */
+    sourceRecordId: string;
+    includedAt: string;
+}
+/** Registro del feed TRANSFER_NOTE_SETTLEMENT: lo que una nota debe pagar y lo capturado; `recordId` y `matchKey` son el noteId. */
+export interface TransferNoteSettlementFeedRecord extends ReconciliationFeedRecord {
+    concept: ReconciliationFeedConceptEnum.TRANSFER_NOTE_SETTLEMENT;
+    /** `amountCents` es el neto de la nota; `occurredAt` su emisión. */
+    refs: ReconciliationFeedRefs & {
+        noteId: string;
+    };
+    pairKey: string;
+    payerPartyType: TransferNotePartyTypeEnum;
+    payerPartyId: string;
+    payeePartyType: TransferNotePartyTypeEnum;
+    payeePartyId: string;
+    status: TransferNoteStatusEnum;
+    dueAt: string;
+    /** Cuenta registrada del receptor al emitir. */
+    payeeClabe: string;
+    paidAt?: string;
+    paidAmountCents?: number;
+}

package/bin/transferNote/dtos/TransferNoteFeedRecords.js

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

package/bin/transferNote/dtos/TransferNoteHistoryEntry.d.ts

@@ -0,0 +1,16 @@
+import { TransferNoteHistoryActionEnum } from '../enums/TransferNoteHistoryActionEnum';
+import { TransferNoteStatusEnum } from '../enums/TransferNoteStatusEnum';
+import { TransferNoteConfirmation } from './TransferNote';
+/** Una acción del historial de la nota. */
+export interface TransferNoteHistoryEntry {
+    action: TransferNoteHistoryActionEnum;
+    actor: string;
+    occurredAt: string;
+    reason?: string;
+    fromStatus?: TransferNoteStatusEnum;
+    toStatus?: TransferNoteStatusEnum;
+    /** Items que volvieron al pool al cancelar. */
+    itemIds?: string[];
+    /** Confirmaciones anuladas al revertir el SPEI. */
+    annulledConfirmations?: TransferNoteConfirmation[];
+}

package/bin/transferNote/dtos/TransferNoteHistoryEntry.js

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

package/bin/transferNote/dtos/TransferNoteItem.d.ts

@@ -0,0 +1,36 @@
+import { CurrencyId } from '../../currency/enums/CurrencyId';
+import { TransferNoteConceptEnum } from '../enums/TransferNoteConceptEnum';
+import { TransferNoteItemStatusEnum } from '../enums/TransferNoteItemStatusEnum';
+/** Lista cerrada de ids que ligan un item con su origen; nunca datos personales. */
+export interface TransferNoteItemRefs {
+    creditId?: string;
+    saleId?: string;
+    customerId?: string;
+    retailerId?: string;
+    promotionId?: string;
+    attemptId?: string;
+}
+/** Item de un par: en el pool no trae `noteId`. */
+export interface TransferNoteItem {
+    itemId: string;
+    tenantId: string;
+    pairKey: string;
+    concept: TransferNoteConceptEnum;
+    /** Centavos con signo: positivo suma a lo que el pagador le debe al receptor. */
+    amountCents: number;
+    currency: CurrencyId;
+    status: TransferNoteItemStatusEnum;
+    /** Id del registro en el feed del dueño; con `concept` es la llave del candado SOURCE. */
+    sourceRecordId: string;
+    /** Fecha del movimiento en el origen, ISO 8601. */
+    occurredAt: string;
+    refs: TransferNoteItemRefs;
+    noteId?: string;
+    /** Item que esta reversa compensa. */
+    reversedItemId?: string;
+    /** Llave idempotente del ajuste y el item que corrige. */
+    adjustmentKey?: string;
+    adjustedItemId?: string;
+    pooledAt: string;
+    includedAt?: string;
+}

package/bin/transferNote/dtos/TransferNoteItem.js

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

package/bin/transferNote/dtos/TransferNoteSignedUrl.d.ts

@@ -0,0 +1,5 @@
+/** URL firmada de S3 con su vencimiento ISO 8601. */
+export interface TransferNoteSignedUrl {
+    url: string;
+    expiresAt: string;
+}

package/bin/transferNote/dtos/TransferNoteSignedUrl.js

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

package/bin/transferNote/dtos/requests/PrivateTransferNoteRequests.d.ts

@@ -0,0 +1,105 @@
+import { TransferNoteConceptEnum } from '../../enums/TransferNoteConceptEnum';
+import { CancelTransferNoteRequest, CaptureTransferNoteSpeiRequest, IssueTransferNoteRequest, PreviewTransferNoteRequest, ResolveTransferNoteDisputeRequest, RevertTransferNoteSpeiRequest } from './TransferNoteActionRequests';
+import { ListTransferNoteItemsQuery, ListTransferNotePoolQuery, ListTransferNotesQuery } from './TransferNoteQueries';
+/** Tenant y servicio que llama; el lambda valida `author` contra su lista permitida. */
+export declare class PrivateTransferNoteCaller {
+    tenantId: string;
+    author: string;
+}
+/** Caller del espejo que llama fiado-dashboard; `actor` es el email del operador de la sesión. */
+export declare class PrivateTransferNoteOperatorCaller extends PrivateTransferNoteCaller {
+    actor: string;
+}
+/** Body de privatePreviewTransferNote. */
+export declare class PrivatePreviewTransferNoteRequest extends PreviewTransferNoteRequest {
+    tenantId: string;
+    author: string;
+    actor: string;
+}
+/** Body de privateIssueTransferNote. */
+export declare class PrivateIssueTransferNoteRequest extends IssueTransferNoteRequest {
+    tenantId: string;
+    author: string;
+    actor: string;
+}
+/** Body de privateCaptureTransferNoteSpei. */
+export declare class PrivateCaptureTransferNoteSpeiRequest extends CaptureTransferNoteSpeiRequest {
+    tenantId: string;
+    author: string;
+    actor: string;
+}
+/** Body de privateRevertTransferNoteSpei. */
+export declare class PrivateRevertTransferNoteSpeiRequest extends RevertTransferNoteSpeiRequest {
+    tenantId: string;
+    author: string;
+    actor: string;
+}
+/** Body de privateCancelTransferNote. */
+export declare class PrivateCancelTransferNoteRequest extends CancelTransferNoteRequest {
+    tenantId: string;
+    author: string;
+    actor: string;
+}
+/** Body de privateResolveTransferNoteDispute. */
+export declare class PrivateResolveTransferNoteDisputeRequest extends ResolveTransferNoteDisputeRequest {
+    tenantId: string;
+    author: string;
+    actor: string;
+}
+/** Body de privateConfirmTransferNoteReception. */
+export declare class PrivateConfirmTransferNoteReceptionRequest extends PrivateTransferNoteOperatorCaller {
+}
+/** Body de privateSendTransferNoteNotice. */
+export declare class PrivateSendTransferNoteNoticeRequest extends PrivateTransferNoteOperatorCaller {
+}
+/** Body de privateCreateSpeiReceiptUploadUrl. */
+export declare class PrivateCreateSpeiReceiptUploadUrlRequest extends PrivateTransferNoteOperatorCaller {
+}
+/** Body de privateConfirmTransferNoteSettlement: FSA confirma el SPEI en su estado de cuenta. */
+export declare class PrivateConfirmTransferNoteSettlementRequest extends PrivateTransferNoteOperatorCaller {
+}
+/** Query de privateGetTransferNote. */
+export declare class PrivateGetTransferNoteQuery extends PrivateTransferNoteOperatorCaller {
+}
+/** Query de privateGetTransferNoteHistory. */
+export declare class PrivateGetTransferNoteHistoryQuery extends PrivateTransferNoteOperatorCaller {
+}
+/** Query de privateGetTransferNotePdf. */
+export declare class PrivateGetTransferNotePdfQuery extends PrivateTransferNoteOperatorCaller {
+}
+/** Query de privateListTransferNotes. */
+export declare class PrivateListTransferNotesQuery extends ListTransferNotesQuery {
+    tenantId: string;
+    author: string;
+    actor: string;
+}
+/** Query de privateListTransferNotePool. */
+export declare class PrivateListTransferNotePoolQuery extends ListTransferNotePoolQuery {
+    tenantId: string;
+    author: string;
+    actor: string;
+}
+/** Query de privateListTransferNoteItems. */
+export declare class PrivateListTransferNoteItemsQuery extends ListTransferNoteItemsQuery {
+    tenantId: string;
+    author: string;
+    actor: string;
+}
+/** Body de privateRunTransferNoteCutoff: responde 202 con `runId` y corre asíncrono. */
+export declare class PrivateRunTransferNoteCutoffRequest extends PrivateTransferNoteCaller {
+    isoWeek: string;
+}
+/** Body de privateCreateTransferNoteAdjustment; un `adjustmentKey` repetido devuelve el primer ajuste. */
+export declare class PrivateCreateTransferNoteAdjustmentRequest extends PrivateTransferNoteCaller {
+    adjustmentKey: string;
+    /** Item original; el ajuste va a su mismo par. */
+    sourceItemId: string;
+    /** Centavos con signo, distinto de cero. */
+    amountCents: number;
+    reason: string;
+}
+/** Query de privateGetTransferNoteItemBySource; la llama el motor, sin operador. */
+export declare class PrivateGetTransferNoteItemBySourceQuery extends PrivateTransferNoteCaller {
+    concept: TransferNoteConceptEnum;
+    sourceRecordId: string;
+}