@fiado/type-kit 3.619.0 → 3.620.0

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/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/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;

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

@@ -6,45 +6,66 @@ 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. */
+/** Caller del espejo que llama fiado-dashboard; el operador viaja por `actorId`. */
 export declare class PrivateTransferNoteOperatorCaller extends PrivateTransferNoteCaller {
-    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 privatePreviewTransferNote. */
 export declare class PrivatePreviewTransferNoteRequest extends PreviewTransferNoteRequest {
     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 privateIssueTransferNote. */
 export declare class PrivateIssueTransferNoteRequest extends IssueTransferNoteRequest {
     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 privateCaptureTransferNoteSpei. */
 export declare class PrivateCaptureTransferNoteSpeiRequest extends CaptureTransferNoteSpeiRequest {
     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 privateRevertTransferNoteSpei. */
 export declare class PrivateRevertTransferNoteSpeiRequest extends RevertTransferNoteSpeiRequest {
     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 privateCancelTransferNote. */
 export declare class PrivateCancelTransferNoteRequest extends CancelTransferNoteRequest {
     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 privateResolveTransferNoteDispute. */
 export declare class PrivateResolveTransferNoteDisputeRequest extends ResolveTransferNoteDisputeRequest {
     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 privateConfirmTransferNoteReception. */
 export declare class PrivateConfirmTransferNoteReceptionRequest extends PrivateTransferNoteOperatorCaller {
@@ -71,19 +92,28 @@ export declare class PrivateGetTransferNotePdfQuery extends PrivateTransferNoteO
 export declare class PrivateListTransferNotesQuery extends ListTransferNotesQuery {
     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 privateListTransferNotePool. */
 export declare class PrivateListTransferNotePoolQuery extends ListTransferNotePoolQuery {
     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 privateListTransferNoteItems. */
 export declare class PrivateListTransferNoteItemsQuery extends ListTransferNoteItemsQuery {
     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 privateRunTransferNoteCutoff: responde 202 con `runId` y corre asíncrono. */
 export declare class PrivateRunTransferNoteCutoffRequest extends PrivateTransferNoteCaller {

package/bin/transferNote/dtos/requests/PrivateTransferNoteRequests.js

@@ -29,12 +29,16 @@ __decorate([
     (0, transferNoteRequestDecorators_1.RequiredId)(),
     __metadata("design:type", String)
 ], PrivateTransferNoteCaller.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 PrivateTransferNoteOperatorCaller extends PrivateTransferNoteCaller {
 }
 exports.PrivateTransferNoteOperatorCaller = PrivateTransferNoteOperatorCaller;
 __decorate([
-    (0, transferNoteRequestDecorators_1.RequiredEmail)(),
+    (0, transferNoteRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateTransferNoteOperatorCaller.prototype, "actorId", void 0);
+__decorate([
+    (0, transferNoteRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateTransferNoteOperatorCaller.prototype, "actor", void 0);
 /** Body de privatePreviewTransferNote. */
@@ -50,7 +54,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivatePreviewTransferNoteRequest.prototype, "author", void 0);
 __decorate([
-    (0, transferNoteRequestDecorators_1.RequiredEmail)(),
+    (0, transferNoteRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivatePreviewTransferNoteRequest.prototype, "actorId", void 0);
+__decorate([
+    (0, transferNoteRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivatePreviewTransferNoteRequest.prototype, "actor", void 0);
 /** Body de privateIssueTransferNote. */
@@ -66,7 +74,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateIssueTransferNoteRequest.prototype, "author", void 0);
 __decorate([
-    (0, transferNoteRequestDecorators_1.RequiredEmail)(),
+    (0, transferNoteRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateIssueTransferNoteRequest.prototype, "actorId", void 0);
+__decorate([
+    (0, transferNoteRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateIssueTransferNoteRequest.prototype, "actor", void 0);
 /** Body de privateCaptureTransferNoteSpei. */
@@ -82,7 +94,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateCaptureTransferNoteSpeiRequest.prototype, "author", void 0);
 __decorate([
-    (0, transferNoteRequestDecorators_1.RequiredEmail)(),
+    (0, transferNoteRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateCaptureTransferNoteSpeiRequest.prototype, "actorId", void 0);
+__decorate([
+    (0, transferNoteRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateCaptureTransferNoteSpeiRequest.prototype, "actor", void 0);
 /** Body de privateRevertTransferNoteSpei. */
@@ -98,7 +114,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateRevertTransferNoteSpeiRequest.prototype, "author", void 0);
 __decorate([
-    (0, transferNoteRequestDecorators_1.RequiredEmail)(),
+    (0, transferNoteRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateRevertTransferNoteSpeiRequest.prototype, "actorId", void 0);
+__decorate([
+    (0, transferNoteRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateRevertTransferNoteSpeiRequest.prototype, "actor", void 0);
 /** Body de privateCancelTransferNote. */
@@ -114,7 +134,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateCancelTransferNoteRequest.prototype, "author", void 0);
 __decorate([
-    (0, transferNoteRequestDecorators_1.RequiredEmail)(),
+    (0, transferNoteRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateCancelTransferNoteRequest.prototype, "actorId", void 0);
+__decorate([
+    (0, transferNoteRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateCancelTransferNoteRequest.prototype, "actor", void 0);
 /** Body de privateResolveTransferNoteDispute. */
@@ -130,7 +154,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateResolveTransferNoteDisputeRequest.prototype, "author", void 0);
 __decorate([
-    (0, transferNoteRequestDecorators_1.RequiredEmail)(),
+    (0, transferNoteRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateResolveTransferNoteDisputeRequest.prototype, "actorId", void 0);
+__decorate([
+    (0, transferNoteRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateResolveTransferNoteDisputeRequest.prototype, "actor", void 0);
 /** Body de privateConfirmTransferNoteReception. */
@@ -174,7 +202,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateListTransferNotesQuery.prototype, "author", void 0);
 __decorate([
-    (0, transferNoteRequestDecorators_1.RequiredEmail)(),
+    (0, transferNoteRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateListTransferNotesQuery.prototype, "actorId", void 0);
+__decorate([
+    (0, transferNoteRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateListTransferNotesQuery.prototype, "actor", void 0);
 /** Query de privateListTransferNotePool. */
@@ -190,7 +222,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateListTransferNotePoolQuery.prototype, "author", void 0);
 __decorate([
-    (0, transferNoteRequestDecorators_1.RequiredEmail)(),
+    (0, transferNoteRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateListTransferNotePoolQuery.prototype, "actorId", void 0);
+__decorate([
+    (0, transferNoteRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateListTransferNotePoolQuery.prototype, "actor", void 0);
 /** Query de privateListTransferNoteItems. */
@@ -206,7 +242,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateListTransferNoteItemsQuery.prototype, "author", void 0);
 __decorate([
-    (0, transferNoteRequestDecorators_1.RequiredEmail)(),
+    (0, transferNoteRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateListTransferNoteItemsQuery.prototype, "actorId", void 0);
+__decorate([
+    (0, transferNoteRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateListTransferNoteItemsQuery.prototype, "actor", void 0);
 /** Body de privateRunTransferNoteCutoff: responde 202 con `runId` y corre asíncrono. */

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

@@ -6,6 +6,10 @@ export declare function RequiredReason(): PropertyDecorator;
 export declare function RequiredId(): PropertyDecorator;
 /** Email obligatorio. */
 export declare function RequiredEmail(): PropertyDecorator;
+/** Email opcional. */
+export declare function OptionalEmail(): PropertyDecorator;
+/** Id obligatorio del operador: no vacío, acotado y nunca con forma de email. */
+export declare function RequiredActorId(): PropertyDecorator;
 /** Semana ISO opcional `YYYY-Www`. */
 export declare function OptionalIsoWeek(): PropertyDecorator;
 /** Tamaño de página opcional, 1 a 100, llega como string en el query. */

package/bin/transferNote/dtos/requests/transferNoteRequestDecorators.js

@@ -4,6 +4,8 @@ exports.LongReason = LongReason;
 exports.RequiredReason = RequiredReason;
 exports.RequiredId = RequiredId;
 exports.RequiredEmail = RequiredEmail;
+exports.OptionalEmail = OptionalEmail;
+exports.RequiredActorId = RequiredActorId;
 exports.OptionalIsoWeek = OptionalIsoWeek;
 exports.PageLimit = PageLimit;
 exports.PageToken = PageToken;
@@ -44,6 +46,30 @@ function RequiredEmail() {
         (0, class_validator_1.IsEmail)()(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);
+    };
+}
+/** Id obligatorio del operador: no vacío, acotado y nunca con forma de email. */
+function RequiredActorId() {
+    return (target, key) => {
+        (0, class_transformer_1.Expose)()(target, key);
+        (0, class_validator_1.IsString)()(target, key);
+        (0, class_validator_1.IsNotEmpty)()(target, key);
+        (0, class_validator_1.MaxLength)(transferNoteValidation_1.TRANSFER_NOTE_ACTOR_ID_MAX_LENGTH)(target, key);
+        (0, class_validator_1.ValidateBy)({
+            name: 'isNotEmail',
+            validator: {
+                validate: (value) => typeof value === 'string' && !(0, class_validator_1.isEmail)(value),
+                defaultMessage: () => '$property no puede ser un email',
+            },
+        })(target, key);
+    };
+}
 /** Semana ISO opcional `YYYY-Www`. */
 function OptionalIsoWeek() {
     return (target, key) => {

package/package.json

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

package/src/reconciliation/dtos/requests/PrivateReconciliationRequests.ts

@@ -13,7 +13,7 @@ import {
     ListReconciliationItemsQuery,
     ListReconciliationRunsQuery,
 } from './ReconciliationQueries';
-import { RequiredEmail, RequiredId } from './reconciliationRequestDecorators';
+import { OptionalEmail, RequiredActorId, RequiredId } from './reconciliationRequestDecorators';
 
 /** Tenant y servicio que llama; el lambda valida `author` contra su lista permitida. */
 export class PrivateReconciliationCaller {
@@ -24,10 +24,15 @@ export class PrivateReconciliationCaller {
     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 class PrivateReconciliationOperatorCaller extends PrivateReconciliationCaller {
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Query de privateGetReconciliationItem. */
@@ -41,8 +46,13 @@ export class PrivateListReconciliationDefinitionsQuery extends ListReconciliatio
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Body de privateConfigureReconciliationDefinition. */
@@ -53,8 +63,13 @@ export class PrivateConfigureReconciliationDefinitionRequest extends ConfigureRe
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Query de privateListReconciliationRuns. */
@@ -65,8 +80,13 @@ export class PrivateListReconciliationRunsQuery extends ListReconciliationRunsQu
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Body de privateRunReconciliation: responde 202 con `runId`. */
@@ -77,8 +97,13 @@ export class PrivateRunReconciliationRequest extends RunReconciliationRequest {
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Query de privateGetReconciliationMatrix. */
@@ -89,8 +114,13 @@ export class PrivateGetReconciliationMatrixQuery extends GetReconciliationMatrix
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Query de privateGetReconciliationOverview. */
@@ -101,8 +131,13 @@ export class PrivateGetReconciliationOverviewQuery extends GetReconciliationOver
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Query de privateGetReconciliationSummary. */
@@ -113,8 +148,13 @@ export class PrivateGetReconciliationSummaryQuery extends GetReconciliationSumma
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Query de privateListReconciliationItems. */
@@ -125,8 +165,13 @@ export class PrivateListReconciliationItemsQuery extends ListReconciliationItems
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Body de privateResolveReconciliationItem. */
@@ -137,8 +182,13 @@ export class PrivateResolveReconciliationItemRequest extends ResolveReconciliati
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Body de privateReactivateReconciliationItem. */
@@ -149,8 +199,13 @@ export class PrivateReactivateReconciliationItemRequest extends ReactivateReconc
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Body de privateAddReconciliationItemNote. */
@@ -161,6 +216,11 @@ export class PrivateAddReconciliationItemNoteRequest extends AddReconciliationIt
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }

package/src/reconciliation/dtos/requests/reconciliationRequestDecorators.ts

@@ -1,8 +1,8 @@
 import { Expose, Transform } from 'class-transformer';
-import { IsEmail, IsOptional, IsString, Matches, MinLength } from 'class-validator';
+import { IsString, Matches, MinLength } from 'class-validator';
 import { RECONCILIATION_MIN_NOTE_LENGTH, RECONCILIATION_PERIOD_KEY_PATTERN } from '../../constants/reconciliationValidation';
 
-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 function PeriodKey(): PropertyDecorator {
@@ -21,12 +21,3 @@ export function NoteText(): PropertyDecorator {
         MinLength(RECONCILIATION_MIN_NOTE_LENGTH)(target, key);
     };
 }
-
-/** Email opcional. */
-export function OptionalEmail(): PropertyDecorator {
-    return (target, key) => {
-        Expose()(target, key);
-        IsOptional()(target, key);
-        IsEmail()(target, key);
-    };
-}

package/src/transferNote/constants/transferNoteValidation.ts

@@ -8,3 +8,6 @@ export const TRANSFER_NOTE_ISO_WEEK_PATTERN = /^\d{4}-W(0[1-9]|[1-4]\d|5[0-3])$/
 export const TRANSFER_NOTE_CLABE_PATTERN = /^\d{18}$/;
 
 export const TRANSFER_NOTE_MAX_PAGE_SIZE = 100;
+
+/** Largo máximo del id del operador (`sub` de Azure AD). */
+export const TRANSFER_NOTE_ACTOR_ID_MAX_LENGTH = 128;

package/src/transferNote/dtos/requests/PrivateTransferNoteRequests.ts

@@ -11,7 +11,7 @@ import {
     RevertTransferNoteSpeiRequest,
 } from './TransferNoteActionRequests';
 import { ListTransferNoteItemsQuery, ListTransferNotePoolQuery, ListTransferNotesQuery } from './TransferNoteQueries';
-import { RequiredEmail, RequiredId, RequiredReason } from './transferNoteRequestDecorators';
+import { OptionalEmail, RequiredActorId, RequiredId, RequiredReason } from './transferNoteRequestDecorators';
 
 /** Tenant y servicio que llama; el lambda valida `author` contra su lista permitida. */
 export class PrivateTransferNoteCaller {
@@ -22,10 +22,15 @@ export class PrivateTransferNoteCaller {
     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 class PrivateTransferNoteOperatorCaller extends PrivateTransferNoteCaller {
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Body de privatePreviewTransferNote. */
@@ -36,8 +41,13 @@ export class PrivatePreviewTransferNoteRequest extends PreviewTransferNoteReques
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Body de privateIssueTransferNote. */
@@ -48,8 +58,13 @@ export class PrivateIssueTransferNoteRequest extends IssueTransferNoteRequest {
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Body de privateCaptureTransferNoteSpei. */
@@ -60,8 +75,13 @@ export class PrivateCaptureTransferNoteSpeiRequest extends CaptureTransferNoteSp
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Body de privateRevertTransferNoteSpei. */
@@ -72,8 +92,13 @@ export class PrivateRevertTransferNoteSpeiRequest extends RevertTransferNoteSpei
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Body de privateCancelTransferNote. */
@@ -84,8 +109,13 @@ export class PrivateCancelTransferNoteRequest extends CancelTransferNoteRequest
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Body de privateResolveTransferNoteDispute. */
@@ -96,8 +126,13 @@ export class PrivateResolveTransferNoteDisputeRequest extends ResolveTransferNot
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Body de privateConfirmTransferNoteReception. */
@@ -129,8 +164,13 @@ export class PrivateListTransferNotesQuery extends ListTransferNotesQuery {
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Query de privateListTransferNotePool. */
@@ -141,8 +181,13 @@ export class PrivateListTransferNotePoolQuery extends ListTransferNotePoolQuery
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Query de privateListTransferNoteItems. */
@@ -153,8 +198,13 @@ export class PrivateListTransferNoteItemsQuery extends ListTransferNoteItemsQuer
     @RequiredId()
     author!: string;
 
-    @RequiredEmail()
-    actor!: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    @RequiredActorId()
+    actorId!: string;
+
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    @OptionalEmail()
+    actor?: string;
 }
 
 /** Body de privateRunTransferNoteCutoff: responde 202 con `runId` y corre asíncrono. */

package/src/transferNote/dtos/requests/transferNoteRequestDecorators.ts

@@ -1,6 +1,11 @@
 import { Expose, Transform, Type } from 'class-transformer';
-import { IsEmail, IsInt, IsNotEmpty, IsOptional, IsString, Matches, Max, Min, MinLength } from 'class-validator';
-import { TRANSFER_NOTE_ISO_WEEK_PATTERN, TRANSFER_NOTE_MAX_PAGE_SIZE, TRANSFER_NOTE_MIN_REASON_LENGTH } from '../../constants/transferNoteValidation';
+import { IsEmail, IsInt, IsNotEmpty, IsOptional, IsString, Matches, Max, MaxLength, Min, MinLength, ValidateBy, isEmail } from 'class-validator';
+import {
+    TRANSFER_NOTE_ACTOR_ID_MAX_LENGTH,
+    TRANSFER_NOTE_ISO_WEEK_PATTERN,
+    TRANSFER_NOTE_MAX_PAGE_SIZE,
+    TRANSFER_NOTE_MIN_REASON_LENGTH,
+} from '../../constants/transferNoteValidation';
 
 const trim = Transform(({ value }) => (typeof value === 'string' ? value.trim() : value));
 
@@ -41,6 +46,32 @@ export function RequiredEmail(): PropertyDecorator {
     };
 }
 
+/** Email opcional. */
+export function OptionalEmail(): PropertyDecorator {
+    return (target, key) => {
+        Expose()(target, key);
+        IsOptional()(target, key);
+        IsEmail()(target, key);
+    };
+}
+
+/** Id obligatorio del operador: no vacío, acotado y nunca con forma de email. */
+export function RequiredActorId(): PropertyDecorator {
+    return (target, key) => {
+        Expose()(target, key);
+        IsString()(target, key);
+        IsNotEmpty()(target, key);
+        MaxLength(TRANSFER_NOTE_ACTOR_ID_MAX_LENGTH)(target, key);
+        ValidateBy({
+            name: 'isNotEmail',
+            validator: {
+                validate: (value) => typeof value === 'string' && !isEmail(value),
+                defaultMessage: () => '$property no puede ser un email',
+            },
+        })(target, key);
+    };
+}
+
 /** Semana ISO opcional `YYYY-Www`. */
 export function OptionalIsoWeek(): PropertyDecorator {
     return (target, key) => {