@fiado/type-kit 3.541.0 → 3.542.0

package/bin/card/dtos/CardAuditInfo.d.ts

@@ -0,0 +1,19 @@
+import { CardAuditActorType } from "../enums/CardAuditActorType";
+import { Status } from "../enums/Status";
+/**
+ * Traza aditiva del último cambio de una tarjeta. Se guarda en `createdBy` (una sola vez, al
+ * crear la fila) y en `updatedBy` (se reescribe en cada cambio). El histórico completo vive en el
+ * datalake, no aquí. Las filas anteriores a este campo simplemente no lo traen.
+ */
+export interface CardAuditInfo {
+    actorType: CardAuditActorType;
+    /** email (BACKOFFICE/AGENT), "<proveedor>:<event_type>" (WEBHOOK), componente (SYSTEM). Vacío para USER. */
+    actorId?: string;
+    /** Operación de negocio: CHANGE_STATUS, ACTIVATE, CREATE, REPLACE, SHIPPING_UPDATE, PIN_UPDATE, ... */
+    action: string;
+    /** Status anterior y nuevo, solo cuando la operación cambia el status. */
+    from?: Status;
+    to?: Status;
+    /** ISO 8601. */
+    at: string;
+}

package/bin/card/dtos/CardAuditInfo.js

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

package/bin/card/enums/CardAuditActorType.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Quién originó el último cambio de una tarjeta (`createdBy` / `updatedBy`).
+ *
+ * - USER: el dueño desde la app; no lleva actorId porque el directoryId ya está en la fila.
+ * - BACKOFFICE / AGENT: persona con sesión W4; actorId = email del AuthContext.
+ * - WEBHOOK: evento del emisor (CP, Pomelo); actorId = "<proveedor>:<event_type>".
+ * - SYSTEM: proceso interno sin usuario (colas, cron, callbacks); actorId = componente.
+ */
+export declare enum CardAuditActorType {
+    USER = "USER",
+    BACKOFFICE = "BACKOFFICE",
+    AGENT = "AGENT",
+    WEBHOOK = "WEBHOOK",
+    SYSTEM = "SYSTEM"
+}

package/bin/card/enums/CardAuditActorType.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CardAuditActorType = void 0;
+/**
+ * Quién originó el último cambio de una tarjeta (`createdBy` / `updatedBy`).
+ *
+ * - USER: el dueño desde la app; no lleva actorId porque el directoryId ya está en la fila.
+ * - BACKOFFICE / AGENT: persona con sesión W4; actorId = email del AuthContext.
+ * - WEBHOOK: evento del emisor (CP, Pomelo); actorId = "<proveedor>:<event_type>".
+ * - SYSTEM: proceso interno sin usuario (colas, cron, callbacks); actorId = componente.
+ */
+var CardAuditActorType;
+(function (CardAuditActorType) {
+    CardAuditActorType["USER"] = "USER";
+    CardAuditActorType["BACKOFFICE"] = "BACKOFFICE";
+    CardAuditActorType["AGENT"] = "AGENT";
+    CardAuditActorType["WEBHOOK"] = "WEBHOOK";
+    CardAuditActorType["SYSTEM"] = "SYSTEM";
+})(CardAuditActorType || (exports.CardAuditActorType = CardAuditActorType = {}));

package/bin/card/index.d.ts

@@ -72,3 +72,5 @@ export * from './enums/CardReasonStatus';
 export * from './enums/KycReason';
 export * from './enums/PinChangedStatus';
 export * from './constants/LevelOneAutoIssuanceTags';
+export * from './enums/CardAuditActorType';
+export * from './dtos/CardAuditInfo';

package/bin/card/index.js

@@ -91,3 +91,5 @@ __exportStar(require("./enums/CardReasonStatus"), exports);
 __exportStar(require("./enums/KycReason"), exports);
 __exportStar(require("./enums/PinChangedStatus"), exports);
 __exportStar(require("./constants/LevelOneAutoIssuanceTags"), exports);
+__exportStar(require("./enums/CardAuditActorType"), exports);
+__exportStar(require("./dtos/CardAuditInfo"), exports);

package/package.json

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

package/src/card/dtos/CardAuditInfo.ts

@@ -0,0 +1,20 @@
+import { CardAuditActorType } from "../enums/CardAuditActorType";
+import { Status } from "../enums/Status";
+
+/**
+ * Traza aditiva del último cambio de una tarjeta. Se guarda en `createdBy` (una sola vez, al
+ * crear la fila) y en `updatedBy` (se reescribe en cada cambio). El histórico completo vive en el
+ * datalake, no aquí. Las filas anteriores a este campo simplemente no lo traen.
+ */
+export interface CardAuditInfo {
+    actorType: CardAuditActorType;
+    /** email (BACKOFFICE/AGENT), "<proveedor>:<event_type>" (WEBHOOK), componente (SYSTEM). Vacío para USER. */
+    actorId?: string;
+    /** Operación de negocio: CHANGE_STATUS, ACTIVATE, CREATE, REPLACE, SHIPPING_UPDATE, PIN_UPDATE, ... */
+    action: string;
+    /** Status anterior y nuevo, solo cuando la operación cambia el status. */
+    from?: Status;
+    to?: Status;
+    /** ISO 8601. */
+    at: string;
+}

package/src/card/enums/CardAuditActorType.ts

@@ -0,0 +1,15 @@
+/**
+ * Quién originó el último cambio de una tarjeta (`createdBy` / `updatedBy`).
+ *
+ * - USER: el dueño desde la app; no lleva actorId porque el directoryId ya está en la fila.
+ * - BACKOFFICE / AGENT: persona con sesión W4; actorId = email del AuthContext.
+ * - WEBHOOK: evento del emisor (CP, Pomelo); actorId = "<proveedor>:<event_type>".
+ * - SYSTEM: proceso interno sin usuario (colas, cron, callbacks); actorId = componente.
+ */
+export enum CardAuditActorType {
+    USER = "USER",
+    BACKOFFICE = "BACKOFFICE",
+    AGENT = "AGENT",
+    WEBHOOK = "WEBHOOK",
+    SYSTEM = "SYSTEM"
+}

package/src/card/index.ts

@@ -78,3 +78,5 @@ export * from './enums/CardReasonStatus'
 export * from './enums/KycReason'
 export * from './enums/PinChangedStatus'
 export * from './constants/LevelOneAutoIssuanceTags';
+export * from './enums/CardAuditActorType';
+export * from './dtos/CardAuditInfo';