@fiado/type-kit 3.618.0 → 3.620.0

package/_test_/unit/collection/authorizeCollectionMovementRequest.test.ts

@@ -0,0 +1,33 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { AuthorizeCollectionMovementRequest } from '../../../src/collection/index';
+
+const VALID = {
+    executionId: 'exec-1',
+    directoryId: 'dir-1',
+    provider: 'wallet',
+    mechanism: 'MXN_DIRECT',
+    amount: 100,
+    currencyId: 'MXN',
+};
+
+async function invalidProperties(body: Record<string, unknown>): Promise<string[]> {
+    const dto = plainToInstance(AuthorizeCollectionMovementRequest, body);
+    return (await validate(dto as object)).map((e) => e.property);
+}
+
+describe('AuthorizeCollectionMovementRequest.tenantId', () => {
+    it('acepta el request sin tenantId', async () => {
+        expect(await invalidProperties(VALID)).toEqual([]);
+    });
+
+    it('acepta el tenant SOFOM del intento de cobro', async () => {
+        expect(await invalidProperties({ ...VALID, tenantId: 'surekeep' })).toEqual([]);
+    });
+
+    it('rechaza tenantId vacío o no string', async () => {
+        expect(await invalidProperties({ ...VALID, tenantId: '' })).toEqual(['tenantId']);
+        expect(await invalidProperties({ ...VALID, tenantId: 42 })).toEqual(['tenantId']);
+    });
+});

package/_test_/unit/reconciliation/reconciliationCatalogs.test.ts

@@ -106,6 +106,15 @@ describe('catálogos de reconciliation', () => {
         expect(RECONCILIATION_FEED_ERROR_HTTP_STATUS[ReconciliationFeedErrorCodeEnum.FEED_RECORD_NOT_FOUND]).toBe(404);
     });
 
+    it('codes del feed genérico con su status', () => {
+        expect(Object.values(ReconciliationFeedErrorCodeEnum).sort()).toEqual(
+            ['FEED_CONCEPT_NOT_SUPPORTED', 'FEED_RECORD_NOT_FOUND', 'FEED_SOURCE_UNAVAILABLE', 'INVALID_FEED_QUERY'],
+        );
+        expect(RECONCILIATION_FEED_ERROR_HTTP_STATUS[ReconciliationFeedErrorCodeEnum.FEED_CONCEPT_NOT_SUPPORTED]).toBe(400);
+        expect(RECONCILIATION_FEED_ERROR_HTTP_STATUS[ReconciliationFeedErrorCodeEnum.INVALID_FEED_QUERY]).toBe(400);
+        expect(RECONCILIATION_FEED_ERROR_HTTP_STATUS[ReconciliationFeedErrorCodeEnum.FEED_SOURCE_UNAVAILABLE]).toBe(502);
+    });
+
     it('nombres de los eventos que publica y consume el motor', () => {
         expect(RECONCILIATION_EVENTS_SOURCE).toBe('fiado.reconciliation');
         expect(ReconciliationEventDetailTypeEnum.RECONCILIATION_ITEM_MATCHED).toBe('reconciliation.ReconciliationItemMatched');

package/_test_/unit/reconciliation/reconciliationRequests.test.ts

@@ -35,7 +35,8 @@ function errorsOf<T extends object>(cls: new () => T, payload: Record<string, un
     return validateSync(dto).map((e) => e.property);
 }
 
-const operator = { tenantId: 'surekeep', author: 'conciliacion-dashboard', actor: 'operador@fsa.mx' };
+const service = { tenantId: 'surekeep', author: 'conciliacion-dashboard' };
+const operator = { ...service, actorId: 'aZ3x9Qk-azure-ad-sub_01' };
 
 describe('definiciones', () => {
     it('configurar pide un estado válido y listas de sandbox opcionales', () => {
@@ -138,7 +139,7 @@ describe('resolución, reactivación y notas', () => {
 });
 
 describe('espejo privado', () => {
-    it('agrega tenantId, author y actor a la versión pública', () => {
+    it('agrega tenantId, author y actorId a la versión pública', () => {
         expect(
             errorsOf(PrivateResolveReconciliationItemRequest, {
                 ...operator,
@@ -150,7 +151,7 @@ describe('espejo privado', () => {
             type: ReconciliationResolutionTypeEnum.EXCLUDE,
             reason: 'prueba interna',
         });
-        expect(missing).toEqual(expect.arrayContaining(['tenantId', 'author', 'actor']));
+        expect(missing).toEqual(expect.arrayContaining(['tenantId', 'author', 'actorId']));
         expect(errorsOf(PrivateAddReconciliationItemNoteRequest, { ...operator, actor: 'no-es-correo', text: 'revisar con tesorería' })).toContain(
             'actor',
         );
@@ -167,11 +168,29 @@ describe('espejo privado', () => {
         expect(errorsOf(PrivateRunReconciliationRequest, { ...operator, definitionId: 'm8-gateway-bank', periodKey: '2026-10-29' })).toEqual(
             [],
         );
-        expect(errorsOf(PrivateGetReconciliationItemQuery, { tenantId: 'surekeep', author: 'x' })).toContain('actor');
+        expect(errorsOf(PrivateGetReconciliationItemQuery, { tenantId: 'surekeep', author: 'x' })).toContain('actorId');
         expect(errorsOf(PrivateListReconciliationItemsQuery, { ...operator, definitionId: 'm8-gateway-sofom' })).toEqual([]);
     });
 });
 
+describe('operador del espejo', () => {
+    it('viaja por actorId, que no puede ser un email; actor (email) es opcional', () => {
+        const { PrivateReconciliationOperatorCaller } = Reconciliation;
+        expect(errorsOf(PrivateReconciliationOperatorCaller, operator)).toEqual([]);
+        expect(errorsOf(PrivateReconciliationOperatorCaller, { ...operator, actor: 'operador@fsa.mx' })).toEqual([]);
+        expect(errorsOf(PrivateReconciliationOperatorCaller, service)).toContain('actorId');
+        expect(errorsOf(PrivateReconciliationOperatorCaller, { ...service, actorId: 'operador@fsa.mx' })).toContain('actorId');
+        expect(
+            errorsOf(PrivateResolveReconciliationItemRequest, {
+                ...service,
+                actorId: 'operador@fsa.mx',
+                type: ReconciliationResolutionTypeEnum.EXCLUDE,
+                reason: 'prueba interna',
+            }),
+        ).toContain('actorId');
+    });
+});
+
 describe('feed genérico de los dueños', () => {
     it('lista por tenant y ventana, con cursor opcional', () => {
         expect(

package/_test_/unit/transferNote/transferNoteConfigAndPrivate.test.ts

@@ -30,7 +30,8 @@ function errorsOf<T extends object>(cls: new () => T, payload: Record<string, un
 }
 
 const service = { tenantId: 'surekeep', author: 'conciliacion-dashboard' };
-const caller = { ...service, actor: 'operador@fsa.mx' };
+const actorId = 'aZ3x9Qk-azure-ad-sub_01';
+const caller = { ...service, actorId };
 const longReason = 'emisión manual por corte fallido del lunes';
 
 describe('UpdateTransferNoteConfigRequest', () => {
@@ -97,12 +98,15 @@ describe('UpdateTransferNoteConfigRequest', () => {
 });
 
 describe('espejo privado', () => {
-    it('agrega tenantId, author y actor a la versión pública', () => {
+    it('agrega tenantId, author y actorId a la versión pública', () => {
         expect(errorsOf(PrivateIssueTransferNoteRequest, { ...caller, pairKey: 'p-1', isoWeek: '2026-W43', reason: longReason })).toEqual([]);
         expect(errorsOf(PrivateIssueTransferNoteRequest, { pairKey: 'p-1', isoWeek: '2026-W43', reason: longReason })).toEqual(
-            expect.arrayContaining(['tenantId', 'author', 'actor']),
+            expect.arrayContaining(['tenantId', 'author', 'actorId']),
         );
         expect(errorsOf(PrivateIssueTransferNoteRequest, { ...caller, actor: 'operador', pairKey: 'p-1', isoWeek: '2026-W43', reason: longReason })).toContain('actor');
+        expect(
+            errorsOf(PrivateIssueTransferNoteRequest, { ...caller, actorId: 'operador@fsa.mx', pairKey: 'p-1', isoWeek: '2026-W43', reason: longReason }),
+        ).toContain('actorId');
         expect(
             errorsOf(PrivateCaptureTransferNoteSpeiRequest, {
                 ...caller,
@@ -113,21 +117,32 @@ describe('espejo privado', () => {
         ).toEqual([]);
     });
 
-    it('las lecturas privadas también exigen author y actor', () => {
+    it('las lecturas privadas también exigen author y actorId', () => {
         expect(errorsOf(PrivateGetTransferNoteQuery, caller)).toEqual([]);
-        expect(errorsOf(PrivateGetTransferNoteQuery, { tenantId: 'surekeep' })).toEqual(expect.arrayContaining(['author', 'actor']));
+        expect(errorsOf(PrivateGetTransferNoteQuery, { tenantId: 'surekeep' })).toEqual(expect.arrayContaining(['author', 'actorId']));
         expect(errorsOf(PrivateListTransferNotesQuery, { ...caller, limit: '20' })).toEqual([]);
     });
 
-    it('confirm-settlement pide el caller con el email del operador', () => {
+    it('confirm-settlement pide el caller con el id del operador', () => {
         expect(errorsOf(PrivateConfirmTransferNoteSettlementRequest, caller)).toEqual([]);
-        expect(errorsOf(PrivateConfirmTransferNoteSettlementRequest, service)).toContain('actor');
+        expect(errorsOf(PrivateConfirmTransferNoteSettlementRequest, service)).toContain('actorId');
+    });
+
+    it('el operador viaja por actorId; actor (email) es opcional', () => {
+        const { PrivateTransferNoteOperatorCaller } = TransferNote;
+        expect(errorsOf(PrivateTransferNoteOperatorCaller, caller)).toEqual([]);
+        expect(errorsOf(PrivateTransferNoteOperatorCaller, { ...caller, actor: 'operador@fsa.mx' })).toEqual([]);
+        expect(errorsOf(PrivateTransferNoteOperatorCaller, service)).toContain('actorId');
+        expect(errorsOf(PrivateTransferNoteOperatorCaller, { ...service, actorId: '' })).toContain('actorId');
+        expect(errorsOf(PrivateTransferNoteOperatorCaller, { ...service, actorId: 'operador@fsa.mx' })).toContain('actorId');
+        expect(errorsOf(PrivateTransferNoteOperatorCaller, { ...service, actorId: 'x'.repeat(129) })).toContain('actorId');
+        expect(errorsOf(PrivateTransferNoteOperatorCaller, { ...caller, actor: 'no-es-correo' })).toContain('actor');
     });
 
     it('el corte manual pide tenant, semana y author', () => {
         expect(errorsOf(PrivateRunTransferNoteCutoffRequest, { ...service, isoWeek: '2026-W43' })).toEqual([]);
         expect(errorsOf(PrivateRunTransferNoteCutoffRequest, { ...service, isoWeek: 'W43' })).toContain('isoWeek');
-        expect(Object.keys(plainToInstance(PrivateRunTransferNoteCutoffRequest, caller, { excludeExtraneousValues: true }))).not.toContain('actor');
+        expect(Object.keys(plainToInstance(PrivateRunTransferNoteCutoffRequest, caller, { excludeExtraneousValues: true }))).not.toContain('actorId');
     });
 
     it('el ajuste es idempotente por adjustmentKey y lleva monto entero distinto de cero', () => {

package/bin/collection/dtos/AuthorizeCollectionMovementRequest.d.ts

@@ -11,6 +11,7 @@ export declare class AuthorizeCollectionMovementRequest {
     intentId?: string;
     chargeId?: string;
     holdTxId?: string;
+    tenantId?: string;
     /**
      * Tarifa con la que se registra el cobro. Presente, el movimiento deja además una transacción
      * Fiado: asiento contable, historial visible para el cliente y comisión declarada. Ausente, el

package/bin/collection/dtos/AuthorizeCollectionMovementRequest.js

@@ -57,6 +57,12 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], AuthorizeCollectionMovementRequest.prototype, "holdTxId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AuthorizeCollectionMovementRequest.prototype, "tenantId", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.ValidateNested)(),

package/bin/reconciliation/constants/reconciliationErrorHttpStatus.d.ts

@@ -1,6 +1,10 @@
 import { ReconciliationErrorCodeEnum as C } from '../enums/ReconciliationErrorCodeEnum';
-import { ReconciliationFeedErrorCodeEnum } from '../enums/ReconciliationFeedErrorCodeEnum';
 /** Status HTTP de cada code: 404 no existe · 409 conflicto de estado · 422 regla de negocio · 502 falló el dueño del dinero. */
 export declare const RECONCILIATION_ERROR_HTTP_STATUS: Readonly<Record<C, 404 | 409 | 422 | 502>>;
-/** Status HTTP de los codes del feed genérico. */
-export declare const RECONCILIATION_FEED_ERROR_HTTP_STATUS: Readonly<Record<ReconciliationFeedErrorCodeEnum, 404>>;
+/** Status HTTP de los codes del feed genérico: 400 request inválido · 404 no existe · 502 falló la fuente. */
+export declare const RECONCILIATION_FEED_ERROR_HTTP_STATUS: {
+    readonly FEED_RECORD_NOT_FOUND: 404;
+    readonly FEED_CONCEPT_NOT_SUPPORTED: 400;
+    readonly INVALID_FEED_QUERY: 400;
+    readonly FEED_SOURCE_UNAVAILABLE: 502;
+};

package/bin/reconciliation/constants/reconciliationErrorHttpStatus.js

@@ -17,7 +17,10 @@ exports.RECONCILIATION_ERROR_HTTP_STATUS = {
     [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.ITEM_ADJUSTED]: 409,
     [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.AUTHOR_NOT_ALLOWED]: 422,
 };
-/** Status HTTP de los codes del feed genérico. */
+/** Status HTTP de los codes del feed genérico: 400 request inválido · 404 no existe · 502 falló la fuente. */
 exports.RECONCILIATION_FEED_ERROR_HTTP_STATUS = {
     [ReconciliationFeedErrorCodeEnum_1.ReconciliationFeedErrorCodeEnum.FEED_RECORD_NOT_FOUND]: 404,
+    [ReconciliationFeedErrorCodeEnum_1.ReconciliationFeedErrorCodeEnum.FEED_CONCEPT_NOT_SUPPORTED]: 400,
+    [ReconciliationFeedErrorCodeEnum_1.ReconciliationFeedErrorCodeEnum.INVALID_FEED_QUERY]: 400,
+    [ReconciliationFeedErrorCodeEnum_1.ReconciliationFeedErrorCodeEnum.FEED_SOURCE_UNAVAILABLE]: 502,
 };

package/bin/reconciliation/dtos/requests/PrivateReconciliationRequests.d.ts

@@ -5,9 +5,12 @@ export declare class PrivateReconciliationCaller {
     tenantId: string;
     author: string;
 }
-/** Caller del espejo que llama fiado-dashboard; `actor` es el email del operador de la sesión. */
+/** Caller del espejo que llama fiado-dashboard; el operador viaja por `actorId`. */
 export declare class PrivateReconciliationOperatorCaller extends PrivateReconciliationCaller {
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Query de privateGetReconciliationItem. */
 export declare class PrivateGetReconciliationItemQuery extends PrivateReconciliationOperatorCaller {
@@ -16,65 +19,98 @@ export declare class PrivateGetReconciliationItemQuery extends PrivateReconcilia
 export declare class PrivateListReconciliationDefinitionsQuery extends ListReconciliationDefinitionsQuery {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Body de privateConfigureReconciliationDefinition. */
 export declare class PrivateConfigureReconciliationDefinitionRequest extends ConfigureReconciliationDefinitionRequest {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Query de privateListReconciliationRuns. */
 export declare class PrivateListReconciliationRunsQuery extends ListReconciliationRunsQuery {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Body de privateRunReconciliation: responde 202 con `runId`. */
 export declare class PrivateRunReconciliationRequest extends RunReconciliationRequest {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Query de privateGetReconciliationMatrix. */
 export declare class PrivateGetReconciliationMatrixQuery extends GetReconciliationMatrixQuery {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Query de privateGetReconciliationOverview. */
 export declare class PrivateGetReconciliationOverviewQuery extends GetReconciliationOverviewQuery {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Query de privateGetReconciliationSummary. */
 export declare class PrivateGetReconciliationSummaryQuery extends GetReconciliationSummaryQuery {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Query de privateListReconciliationItems. */
 export declare class PrivateListReconciliationItemsQuery extends ListReconciliationItemsQuery {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Body de privateResolveReconciliationItem. */
 export declare class PrivateResolveReconciliationItemRequest extends ResolveReconciliationItemRequest {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Body de privateReactivateReconciliationItem. */
 export declare class PrivateReactivateReconciliationItemRequest extends ReactivateReconciliationItemRequest {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Body de privateAddReconciliationItemNote. */
 export declare class PrivateAddReconciliationItemNoteRequest extends AddReconciliationItemNoteRequest {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }

package/bin/reconciliation/dtos/requests/PrivateReconciliationRequests.js

@@ -25,12 +25,16 @@ __decorate([
     (0, reconciliationRequestDecorators_1.RequiredId)(),
     __metadata("design:type", String)
 ], PrivateReconciliationCaller.prototype, "author", void 0);
-/** Caller del espejo que llama fiado-dashboard; `actor` es el email del operador de la sesión. */
+/** Caller del espejo que llama fiado-dashboard; el operador viaja por `actorId`. */
 class PrivateReconciliationOperatorCaller extends PrivateReconciliationCaller {
 }
 exports.PrivateReconciliationOperatorCaller = PrivateReconciliationOperatorCaller;
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateReconciliationOperatorCaller.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateReconciliationOperatorCaller.prototype, "actor", void 0);
 /** Query de privateGetReconciliationItem. */
@@ -50,7 +54,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateListReconciliationDefinitionsQuery.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateListReconciliationDefinitionsQuery.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateListReconciliationDefinitionsQuery.prototype, "actor", void 0);
 /** Body de privateConfigureReconciliationDefinition. */
@@ -66,7 +74,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateConfigureReconciliationDefinitionRequest.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateConfigureReconciliationDefinitionRequest.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateConfigureReconciliationDefinitionRequest.prototype, "actor", void 0);
 /** Query de privateListReconciliationRuns. */
@@ -82,7 +94,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateListReconciliationRunsQuery.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateListReconciliationRunsQuery.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateListReconciliationRunsQuery.prototype, "actor", void 0);
 /** Body de privateRunReconciliation: responde 202 con `runId`. */
@@ -98,7 +114,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateRunReconciliationRequest.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateRunReconciliationRequest.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateRunReconciliationRequest.prototype, "actor", void 0);
 /** Query de privateGetReconciliationMatrix. */
@@ -114,7 +134,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateGetReconciliationMatrixQuery.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateGetReconciliationMatrixQuery.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateGetReconciliationMatrixQuery.prototype, "actor", void 0);
 /** Query de privateGetReconciliationOverview. */
@@ -130,7 +154,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateGetReconciliationOverviewQuery.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateGetReconciliationOverviewQuery.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateGetReconciliationOverviewQuery.prototype, "actor", void 0);
 /** Query de privateGetReconciliationSummary. */
@@ -146,7 +174,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateGetReconciliationSummaryQuery.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateGetReconciliationSummaryQuery.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateGetReconciliationSummaryQuery.prototype, "actor", void 0);
 /** Query de privateListReconciliationItems. */
@@ -162,7 +194,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateListReconciliationItemsQuery.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateListReconciliationItemsQuery.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateListReconciliationItemsQuery.prototype, "actor", void 0);
 /** Body de privateResolveReconciliationItem. */
@@ -178,7 +214,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateResolveReconciliationItemRequest.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateResolveReconciliationItemRequest.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateResolveReconciliationItemRequest.prototype, "actor", void 0);
 /** Body de privateReactivateReconciliationItem. */
@@ -194,7 +234,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateReactivateReconciliationItemRequest.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateReactivateReconciliationItemRequest.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateReactivateReconciliationItemRequest.prototype, "actor", void 0);
 /** Body de privateAddReconciliationItemNote. */
@@ -210,6 +254,10 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateAddReconciliationItemNoteRequest.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateAddReconciliationItemNoteRequest.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateAddReconciliationItemNoteRequest.prototype, "actor", void 0);

package/bin/reconciliation/dtos/requests/reconciliationRequestDecorators.d.ts

@@ -1,7 +1,5 @@
-export { PageLimit, PageToken, RequiredEmail, RequiredId, RequiredReason } from '../../../transferNote/dtos/requests/transferNoteRequestDecorators';
+export { OptionalEmail, PageLimit, PageToken, RequiredActorId, RequiredEmail, RequiredId, RequiredReason } from '../../../transferNote/dtos/requests/transferNoteRequestDecorators';
 /** Periodo obligatorio: día, semana ISO o mes. */
 export declare function PeriodKey(): PropertyDecorator;
 /** Texto de 10+ caracteres sin contar espacios de relleno. */
 export declare function NoteText(): PropertyDecorator;
-/** Email opcional. */
-export declare function OptionalEmail(): PropertyDecorator;

package/bin/reconciliation/dtos/requests/reconciliationRequestDecorators.js

@@ -1,15 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RequiredReason = exports.RequiredId = exports.RequiredEmail = exports.PageToken = exports.PageLimit = void 0;
+exports.RequiredReason = exports.RequiredId = exports.RequiredEmail = exports.RequiredActorId = exports.PageToken = exports.PageLimit = exports.OptionalEmail = void 0;
 exports.PeriodKey = PeriodKey;
 exports.NoteText = NoteText;
-exports.OptionalEmail = OptionalEmail;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const reconciliationValidation_1 = require("../../constants/reconciliationValidation");
 var transferNoteRequestDecorators_1 = require("../../../transferNote/dtos/requests/transferNoteRequestDecorators");
+Object.defineProperty(exports, "OptionalEmail", { enumerable: true, get: function () { return transferNoteRequestDecorators_1.OptionalEmail; } });
 Object.defineProperty(exports, "PageLimit", { enumerable: true, get: function () { return transferNoteRequestDecorators_1.PageLimit; } });
 Object.defineProperty(exports, "PageToken", { enumerable: true, get: function () { return transferNoteRequestDecorators_1.PageToken; } });
+Object.defineProperty(exports, "RequiredActorId", { enumerable: true, get: function () { return transferNoteRequestDecorators_1.RequiredActorId; } });
 Object.defineProperty(exports, "RequiredEmail", { enumerable: true, get: function () { return transferNoteRequestDecorators_1.RequiredEmail; } });
 Object.defineProperty(exports, "RequiredId", { enumerable: true, get: function () { return transferNoteRequestDecorators_1.RequiredId; } });
 Object.defineProperty(exports, "RequiredReason", { enumerable: true, get: function () { return transferNoteRequestDecorators_1.RequiredReason; } });
@@ -29,11 +30,3 @@ function NoteText() {
         (0, class_validator_1.MinLength)(reconciliationValidation_1.RECONCILIATION_MIN_NOTE_LENGTH)(target, key);
     };
 }
-/** Email opcional. */
-function OptionalEmail() {
-    return (target, key) => {
-        (0, class_transformer_1.Expose)()(target, key);
-        (0, class_validator_1.IsOptional)()(target, key);
-        (0, class_validator_1.IsEmail)()(target, key);
-    };
-}

package/bin/reconciliation/enums/ReconciliationFeedErrorCodeEnum.d.ts

@@ -1,4 +1,7 @@
 /** Codes del feed genérico que implementa cada dueño del dato. */
 export declare enum ReconciliationFeedErrorCodeEnum {
-    FEED_RECORD_NOT_FOUND = "FEED_RECORD_NOT_FOUND"
+    FEED_RECORD_NOT_FOUND = "FEED_RECORD_NOT_FOUND",
+    FEED_CONCEPT_NOT_SUPPORTED = "FEED_CONCEPT_NOT_SUPPORTED",
+    INVALID_FEED_QUERY = "INVALID_FEED_QUERY",
+    FEED_SOURCE_UNAVAILABLE = "FEED_SOURCE_UNAVAILABLE"
 }

package/bin/reconciliation/enums/ReconciliationFeedErrorCodeEnum.js

@@ -5,4 +5,7 @@ exports.ReconciliationFeedErrorCodeEnum = void 0;
 var ReconciliationFeedErrorCodeEnum;
 (function (ReconciliationFeedErrorCodeEnum) {
     ReconciliationFeedErrorCodeEnum["FEED_RECORD_NOT_FOUND"] = "FEED_RECORD_NOT_FOUND";
+    ReconciliationFeedErrorCodeEnum["FEED_CONCEPT_NOT_SUPPORTED"] = "FEED_CONCEPT_NOT_SUPPORTED";
+    ReconciliationFeedErrorCodeEnum["INVALID_FEED_QUERY"] = "INVALID_FEED_QUERY";
+    ReconciliationFeedErrorCodeEnum["FEED_SOURCE_UNAVAILABLE"] = "FEED_SOURCE_UNAVAILABLE";
 })(ReconciliationFeedErrorCodeEnum || (exports.ReconciliationFeedErrorCodeEnum = ReconciliationFeedErrorCodeEnum = {}));

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

@@ -5,3 +5,5 @@ 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;
+/** Largo máximo del id del operador (`sub` de Azure AD). */
+export declare const TRANSFER_NOTE_ACTOR_ID_MAX_LENGTH = 128;

package/bin/transferNote/constants/transferNoteValidation.js

@@ -1,6 +1,6 @@
 "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;
+exports.TRANSFER_NOTE_ACTOR_ID_MAX_LENGTH = 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`. */
@@ -8,3 +8,5 @@ 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;
+/** Largo máximo del id del operador (`sub` de Azure AD). */
+exports.TRANSFER_NOTE_ACTOR_ID_MAX_LENGTH = 128;