@fiado/type-kit 3.619.0 → 3.621.0

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.621.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/retailIntegration/dtos/GetReconciliationResponses.ts

@@ -4,8 +4,20 @@ import type { ReconciliationTriggerEnum } from '../enums/ReconciliationTriggerEn
 import type { ReconciliationPreview } from './ReconciliationPreview';
 import type { ReconciliationRunCounts } from './ReconciliationRunCounts';
 
+/** Fallos de una corrida: por qué se abortó y en qué intento de SQS va la página que falla. */
+export interface ReconciliationRunAttempts {
+    /** Motivo del ABORTED (`MAX_ATTEMPTS`, `ROW_WITHOUT_ID`, el `code` del externo caído, etc.); null si no se abortó. */
+    abortReason?: string | null;
+    /** `code` del último error de la página en curso; null si la página no ha fallado. */
+    lastErrorCode?: string | null;
+    /** Intento de SQS (1-based) en que falló la página en curso; null si no ha fallado. */
+    attempt?: number | null;
+    /** Intentos de SQS que tiene una página antes de abortar la corrida. */
+    maxAttempts?: number;
+}
+
 /** Respuesta 200 de GET .../reconciliations/{runId} en org (backofficeGetOrgReconciliation). */
-export interface GetOrgReconciliationResponse {
+export interface GetOrgReconciliationResponse extends ReconciliationRunAttempts {
     runId: string;
     retailerId: string;
     entity: ReconciliationEntityEnum.STORES | ReconciliationEntityEnum.USERS;
@@ -24,7 +36,7 @@ export interface GetOrgReconciliationResponse {
 }
 
 /** Respuesta 200 de GET .../reconciliations/{runId} en catalog (backofficeGetCatalogReconciliation). */
-export interface GetCatalogReconciliationResponse {
+export interface GetCatalogReconciliationResponse extends ReconciliationRunAttempts {
     runId: string;
     retailerId: string;
     entity: ReconciliationEntityEnum.CATALOG | ReconciliationEntityEnum.INVENTORY | ReconciliationEntityEnum.MOVEMENTS;

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) => {