@rocketlink/crm-model 1.0.339 → 1.0.340

package/dist/dtos/transactionHistory.request.dto.d.ts

@@ -0,0 +1,9 @@
+import { PaginatedRequest } from "./common/paginated.request.dto";
+export interface TransactionHistoryListRequest extends PaginatedRequest {
+    /** When set, restrict history rows to this transaction; omit to list all (within tenant scope). */
+    transactionId?: number;
+    changeSource?: string;
+    /** When true, tenant scope expands to sub-tenants (API auth); default false. */
+    includeSubTenants?: boolean;
+}
+//# sourceMappingURL=transactionHistory.request.dto.d.ts.map

package/dist/dtos/transactionHistory.request.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionHistory.request.dto.d.ts","sourceRoot":"","sources":["../../src/dtos/transactionHistory.request.dto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,MAAM,WAAW,6BAA8B,SAAQ,gBAAgB;IACrE,mGAAmG;IACnG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B"}

package/dist/dtos/transactionHistory.request.dto.js

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

package/dist/index.d.ts

@@ -43,6 +43,7 @@ export * from './dtos/aclAction.request.dto';
 export * from './dtos/hostedPage.request.dto';
 export * from './dtos/checkout.request.dto';
 export * from './dtos/auditTrail.request.dto';
+export * from './dtos/transactionHistory.request.dto';
 export * from './mappers/csv/csvRowDataOrder.csv.mapper';
 export * from './mappers/csv/csvRowDataSubscriptionId.csv.mapper';
 export * from './model/constants/lead.constants';
@@ -60,6 +61,7 @@ export * from './model/constants/offer.constants';
 export * from './model/constants/acl.constants';
 export * from './model/constants/inbound-webhook.constants';
 export * from './model/constants/auditTrail.constants';
+export * from './model/constants/transactionHistory.constants';
 export * from './model/campaign.model';
 export * from './model/category.model';
 export * from './model/csv.model';
@@ -96,6 +98,7 @@ export * from './model/aclRolePermission.model';
 export * from './model/hostedPage.model';
 export * from './model/inbound-webhook.model';
 export * from './model/auditTrail.model';
+export * from './model/transactionHistory.model';
 export * from './gateways/adapters/model/empChargeback.model';
 export * from './gateways/adapters/model/transactionEmp.model';
 export * from './gateways/adapters/model/transactionNovalNet.model';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -68,6 +68,7 @@ __exportStar(require("./dtos/aclAction.request.dto"), exports);
 __exportStar(require("./dtos/hostedPage.request.dto"), exports);
 __exportStar(require("./dtos/checkout.request.dto"), exports);
 __exportStar(require("./dtos/auditTrail.request.dto"), exports);
+__exportStar(require("./dtos/transactionHistory.request.dto"), exports);
 // Export all Mappers
 __exportStar(require("./mappers/csv/csvRowDataOrder.csv.mapper"), exports);
 __exportStar(require("./mappers/csv/csvRowDataSubscriptionId.csv.mapper"), exports);
@@ -88,6 +89,7 @@ __exportStar(require("./model/constants/offer.constants"), exports);
 __exportStar(require("./model/constants/acl.constants"), exports);
 __exportStar(require("./model/constants/inbound-webhook.constants"), exports);
 __exportStar(require("./model/constants/auditTrail.constants"), exports);
+__exportStar(require("./model/constants/transactionHistory.constants"), exports);
 // Export all Models
 __exportStar(require("./model/campaign.model"), exports);
 __exportStar(require("./model/category.model"), exports);
@@ -126,6 +128,7 @@ __exportStar(require("./model/aclRolePermission.model"), exports);
 __exportStar(require("./model/hostedPage.model"), exports);
 __exportStar(require("./model/inbound-webhook.model"), exports);
 __exportStar(require("./model/auditTrail.model"), exports);
+__exportStar(require("./model/transactionHistory.model"), exports);
 // Export Gateway Adapters Models
 __exportStar(require("./gateways/adapters/model/empChargeback.model"), exports);
 __exportStar(require("./gateways/adapters/model/transactionEmp.model"), exports);

package/dist/model/constants/transactionHistory.constants.d.ts

@@ -0,0 +1,36 @@
+/** Channel / mechanism stored in `transaction_history.change_source`. */
+export declare const TRANSACTION_HISTORY_SOURCE: {
+    readonly CSV: "CSV";
+    readonly ADMIN_PANEL: "ADMIN_PANEL";
+    readonly LIVE_TRAFFIC: "LIVE_TRAFFIC";
+    readonly RECONCILIATION: "RECONCILIATION";
+    readonly SYSTEM: "SYSTEM";
+    readonly INBOUND_WEBHOOK: "INBOUND_WEBHOOK";
+};
+export type TransactionHistorySource = (typeof TRANSACTION_HISTORY_SOURCE)[keyof typeof TRANSACTION_HISTORY_SOURCE];
+/** Actor / label stored in `transaction_history.changed_by`. */
+export declare const TRANSACTION_HISTORY_CHANGED_BY: {
+    readonly NA: "N/A";
+    readonly RECONCILIATION_CRM_TO_EMP: "RECONCILIATION_CRM_TO_EMP";
+    readonly RECONCILIATION_EMP_TO_CRM: "RECONCILIATION_EMP_TO_CRM";
+};
+export type TransactionHistoryChangedByLabel = (typeof TRANSACTION_HISTORY_CHANGED_BY)[keyof typeof TRANSACTION_HISTORY_CHANGED_BY];
+export interface TransactionHistoryContext {
+    changeSource: string;
+    changedBy: string | null;
+}
+/** @returns e.g. `user(42)` */
+export declare function formatTransactionHistoryUserChangedBy(userId: number): string;
+/** Gateway / live traffic updates when no explicit history is passed. */
+export declare const TRANSACTION_HISTORY_CTX_LIVE_TRAFFIC: TransactionHistoryContext;
+/** Subscription rebill / system-driven parent updates (pending rebill row, retry engine, etc.). */
+export declare const TRANSACTION_HISTORY_CTX_SUBSCRIPTION_REBILL: TransactionHistoryContext;
+/** CSV platform import when uploader is unknown (prefer {@link transactionHistoryCtxCsvUpload}). */
+export declare const TRANSACTION_HISTORY_CTX_CSV_IMPORT: TransactionHistoryContext;
+/** CSV uploads from the admin tool: `change_source` CSV and `user(id)` when uploader is known. */
+export declare function transactionHistoryCtxCsvUpload(uploadedByUserId?: number | null): TransactionHistoryContext;
+export declare const TRANSACTION_HISTORY_CTX_RECONCILIATION_EMP_TO_CRM: TransactionHistoryContext;
+export declare const TRANSACTION_HISTORY_CTX_RECONCILIATION_CRM_TO_EMP: TransactionHistoryContext;
+export declare const TRANSACTION_HISTORY_CTX_INBOUND_WEBHOOK: TransactionHistoryContext;
+export declare const TRANSACTION_HISTORY_CTX_ADMIN_PANEL_NA: TransactionHistoryContext;
+//# sourceMappingURL=transactionHistory.constants.d.ts.map

package/dist/model/constants/transactionHistory.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionHistory.constants.d.ts","sourceRoot":"","sources":["../../../src/model/constants/transactionHistory.constants.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,eAAO,MAAM,0BAA0B;;;;;;;CAO7B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,OAAO,0BAA0B,CAAC,CAAC;AAEpH,gEAAgE;AAChE,eAAO,MAAM,8BAA8B;;;;CAIjC,CAAC;AAEX,MAAM,MAAM,gCAAgC,GAAG,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,OAAO,8BAA8B,CAAC,CAAC;AAEpI,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,+BAA+B;AAC/B,wBAAgB,qCAAqC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,yEAAyE;AACzE,eAAO,MAAM,oCAAoC,EAAE,yBAGlD,CAAC;AAEF,mGAAmG;AACnG,eAAO,MAAM,2CAA2C,EAAE,yBAGzD,CAAC;AAEF,oGAAoG;AACpG,eAAO,MAAM,kCAAkC,EAAE,yBAGhD,CAAC;AAEF,kGAAkG;AAClG,wBAAgB,8BAA8B,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,yBAAyB,CAQ1G;AAED,eAAO,MAAM,iDAAiD,EAAE,yBAG/D,CAAC;AAEF,eAAO,MAAM,iDAAiD,EAAE,yBAG/D,CAAC;AAEF,eAAO,MAAM,uCAAuC,EAAE,yBAGrD,CAAC;AAEF,eAAO,MAAM,sCAAsC,EAAE,yBAGpD,CAAC"}

package/dist/model/constants/transactionHistory.constants.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRANSACTION_HISTORY_CTX_ADMIN_PANEL_NA = exports.TRANSACTION_HISTORY_CTX_INBOUND_WEBHOOK = exports.TRANSACTION_HISTORY_CTX_RECONCILIATION_CRM_TO_EMP = exports.TRANSACTION_HISTORY_CTX_RECONCILIATION_EMP_TO_CRM = exports.TRANSACTION_HISTORY_CTX_CSV_IMPORT = exports.TRANSACTION_HISTORY_CTX_SUBSCRIPTION_REBILL = exports.TRANSACTION_HISTORY_CTX_LIVE_TRAFFIC = exports.TRANSACTION_HISTORY_CHANGED_BY = exports.TRANSACTION_HISTORY_SOURCE = void 0;
+exports.formatTransactionHistoryUserChangedBy = formatTransactionHistoryUserChangedBy;
+exports.transactionHistoryCtxCsvUpload = transactionHistoryCtxCsvUpload;
+/** Channel / mechanism stored in `transaction_history.change_source`. */
+exports.TRANSACTION_HISTORY_SOURCE = {
+    CSV: "CSV",
+    ADMIN_PANEL: "ADMIN_PANEL",
+    LIVE_TRAFFIC: "LIVE_TRAFFIC",
+    RECONCILIATION: "RECONCILIATION",
+    SYSTEM: "SYSTEM",
+    INBOUND_WEBHOOK: "INBOUND_WEBHOOK",
+};
+/** Actor / label stored in `transaction_history.changed_by`. */
+exports.TRANSACTION_HISTORY_CHANGED_BY = {
+    NA: "N/A",
+    RECONCILIATION_CRM_TO_EMP: "RECONCILIATION_CRM_TO_EMP",
+    RECONCILIATION_EMP_TO_CRM: "RECONCILIATION_EMP_TO_CRM",
+};
+/** @returns e.g. `user(42)` */
+function formatTransactionHistoryUserChangedBy(userId) {
+    return `user(${userId})`;
+}
+/** Gateway / live traffic updates when no explicit history is passed. */
+exports.TRANSACTION_HISTORY_CTX_LIVE_TRAFFIC = {
+    changeSource: exports.TRANSACTION_HISTORY_SOURCE.LIVE_TRAFFIC,
+    changedBy: exports.TRANSACTION_HISTORY_CHANGED_BY.NA,
+};
+/** Subscription rebill / system-driven parent updates (pending rebill row, retry engine, etc.). */
+exports.TRANSACTION_HISTORY_CTX_SUBSCRIPTION_REBILL = {
+    changeSource: exports.TRANSACTION_HISTORY_SOURCE.SYSTEM,
+    changedBy: exports.TRANSACTION_HISTORY_CHANGED_BY.NA,
+};
+/** CSV platform import when uploader is unknown (prefer {@link transactionHistoryCtxCsvUpload}). */
+exports.TRANSACTION_HISTORY_CTX_CSV_IMPORT = {
+    changeSource: exports.TRANSACTION_HISTORY_SOURCE.CSV,
+    changedBy: exports.TRANSACTION_HISTORY_CHANGED_BY.NA,
+};
+/** CSV uploads from the admin tool: `change_source` CSV and `user(id)` when uploader is known. */
+function transactionHistoryCtxCsvUpload(uploadedByUserId) {
+    if (uploadedByUserId != null && uploadedByUserId > 0) {
+        return {
+            changeSource: exports.TRANSACTION_HISTORY_SOURCE.CSV,
+            changedBy: formatTransactionHistoryUserChangedBy(uploadedByUserId),
+        };
+    }
+    return exports.TRANSACTION_HISTORY_CTX_CSV_IMPORT;
+}
+exports.TRANSACTION_HISTORY_CTX_RECONCILIATION_EMP_TO_CRM = {
+    changeSource: exports.TRANSACTION_HISTORY_SOURCE.RECONCILIATION,
+    changedBy: exports.TRANSACTION_HISTORY_CHANGED_BY.RECONCILIATION_EMP_TO_CRM,
+};
+exports.TRANSACTION_HISTORY_CTX_RECONCILIATION_CRM_TO_EMP = {
+    changeSource: exports.TRANSACTION_HISTORY_SOURCE.RECONCILIATION,
+    changedBy: exports.TRANSACTION_HISTORY_CHANGED_BY.RECONCILIATION_CRM_TO_EMP,
+};
+exports.TRANSACTION_HISTORY_CTX_INBOUND_WEBHOOK = {
+    changeSource: exports.TRANSACTION_HISTORY_SOURCE.INBOUND_WEBHOOK,
+    changedBy: exports.TRANSACTION_HISTORY_CHANGED_BY.NA,
+};
+exports.TRANSACTION_HISTORY_CTX_ADMIN_PANEL_NA = {
+    changeSource: exports.TRANSACTION_HISTORY_SOURCE.ADMIN_PANEL,
+    changedBy: exports.TRANSACTION_HISTORY_CHANGED_BY.NA,
+};

package/dist/model/csv.model.d.ts

@@ -2,6 +2,8 @@ import type { CSVStatusTypes, CSVRowStatusTypes, CSV_TYPES } from "./constants/c
 export interface CSV {
     id?: number;
     tenantId?: number;
+    /** Set when CSV is uploaded via an authenticated request (for transaction_history.changed_by). */
+    uploadedByUserId?: number | null;
     fileName: string;
     uploadedFileUrl: string;
     fileRows?: number;

package/dist/model/csv.model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"csv.model.d.ts","sourceRoot":"","sources":["../../src/model/csv.model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE9F,MAAM,WAAW,GAAG;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,iBAAiB,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAChC,eAAe,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB"}
+{"version":3,"file":"csv.model.d.ts","sourceRoot":"","sources":["../../src/model/csv.model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE9F,MAAM,WAAW,GAAG;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kGAAkG;IAClG,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,iBAAiB,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAChC,eAAe,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB"}

package/dist/model/transactionHistory.model.d.ts

@@ -0,0 +1,17 @@
+/** Full merged `Transaction` snapshot (parent + adapter-specific fields), API camelCase, stored in before_json / after_json. */
+export type TransactionSnapshotPayload = Record<string, unknown>;
+export interface TransactionHistory {
+    id?: number;
+    tenantId?: number;
+    transactionId?: number;
+    changedAt?: Date;
+    changedBy?: string | null;
+    changeSource?: string;
+    /** Post-update adapter enum name (duplicated for listing; also inside after_json). */
+    adapterName?: string | null;
+    /** Post-update provider enum name. */
+    providerName?: string | null;
+    beforeJson?: TransactionSnapshotPayload;
+    afterJson?: TransactionSnapshotPayload;
+}
+//# sourceMappingURL=transactionHistory.model.d.ts.map

package/dist/model/transactionHistory.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionHistory.model.d.ts","sourceRoot":"","sources":["../../src/model/transactionHistory.model.ts"],"names":[],"mappings":"AAAA,gIAAgI;AAChI,MAAM,MAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,EAAE,0BAA0B,CAAC;IACxC,SAAS,CAAC,EAAE,0BAA0B,CAAC;CACxC"}

package/dist/model/transactionHistory.model.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rocketlink/crm-model",
-  "version": "1.0.339",
+  "version": "1.0.340",
   "description": "Shared DTOs and Models for CRM Rocketlink",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/dtos/transactionHistory.request.dto.ts

@@ -0,0 +1,9 @@
+import { PaginatedRequest } from "./common/paginated.request.dto";
+
+export interface TransactionHistoryListRequest extends PaginatedRequest {
+  /** When set, restrict history rows to this transaction; omit to list all (within tenant scope). */
+  transactionId?: number;
+  changeSource?: string;
+  /** When true, tenant scope expands to sub-tenants (API auth); default false. */
+  includeSubTenants?: boolean;
+}

package/src/index.ts

@@ -47,6 +47,7 @@ export * from './dtos/aclAction.request.dto';
 export * from './dtos/hostedPage.request.dto';
 export * from './dtos/checkout.request.dto';
 export * from './dtos/auditTrail.request.dto';
+export * from './dtos/transactionHistory.request.dto';
 
 // Export all Mappers
 export * from './mappers/csv/csvRowDataOrder.csv.mapper';
@@ -69,6 +70,7 @@ export * from './model/constants/offer.constants';
 export * from './model/constants/acl.constants';
 export * from './model/constants/inbound-webhook.constants';
 export * from './model/constants/auditTrail.constants';
+export * from './model/constants/transactionHistory.constants';
 
 // Export all Models
 export * from './model/campaign.model';
@@ -108,6 +110,7 @@ export * from './model/aclRolePermission.model';
 export * from './model/hostedPage.model';
 export * from './model/inbound-webhook.model';
 export * from './model/auditTrail.model';
+export * from './model/transactionHistory.model';
 
 // Export Gateway Adapters Models
 export * from './gateways/adapters/model/empChargeback.model';

package/src/model/constants/transactionHistory.constants.ts

@@ -0,0 +1,79 @@
+/** Channel / mechanism stored in `transaction_history.change_source`. */
+export const TRANSACTION_HISTORY_SOURCE = {
+  CSV: "CSV",
+  ADMIN_PANEL: "ADMIN_PANEL",
+  LIVE_TRAFFIC: "LIVE_TRAFFIC",
+  RECONCILIATION: "RECONCILIATION",
+  SYSTEM: "SYSTEM",
+  INBOUND_WEBHOOK: "INBOUND_WEBHOOK",
+} as const;
+
+export type TransactionHistorySource = (typeof TRANSACTION_HISTORY_SOURCE)[keyof typeof TRANSACTION_HISTORY_SOURCE];
+
+/** Actor / label stored in `transaction_history.changed_by`. */
+export const TRANSACTION_HISTORY_CHANGED_BY = {
+  NA: "N/A",
+  RECONCILIATION_CRM_TO_EMP: "RECONCILIATION_CRM_TO_EMP",
+  RECONCILIATION_EMP_TO_CRM: "RECONCILIATION_EMP_TO_CRM",
+} as const;
+
+export type TransactionHistoryChangedByLabel = (typeof TRANSACTION_HISTORY_CHANGED_BY)[keyof typeof TRANSACTION_HISTORY_CHANGED_BY];
+
+export interface TransactionHistoryContext {
+  changeSource: string;
+  changedBy: string | null;
+}
+
+/** @returns e.g. `user(42)` */
+export function formatTransactionHistoryUserChangedBy(userId: number): string {
+  return `user(${userId})`;
+}
+
+/** Gateway / live traffic updates when no explicit history is passed. */
+export const TRANSACTION_HISTORY_CTX_LIVE_TRAFFIC: TransactionHistoryContext = {
+  changeSource: TRANSACTION_HISTORY_SOURCE.LIVE_TRAFFIC,
+  changedBy: TRANSACTION_HISTORY_CHANGED_BY.NA,
+};
+
+/** Subscription rebill / system-driven parent updates (pending rebill row, retry engine, etc.). */
+export const TRANSACTION_HISTORY_CTX_SUBSCRIPTION_REBILL: TransactionHistoryContext = {
+  changeSource: TRANSACTION_HISTORY_SOURCE.SYSTEM,
+  changedBy: TRANSACTION_HISTORY_CHANGED_BY.NA,
+};
+
+/** CSV platform import when uploader is unknown (prefer {@link transactionHistoryCtxCsvUpload}). */
+export const TRANSACTION_HISTORY_CTX_CSV_IMPORT: TransactionHistoryContext = {
+  changeSource: TRANSACTION_HISTORY_SOURCE.CSV,
+  changedBy: TRANSACTION_HISTORY_CHANGED_BY.NA,
+};
+
+/** CSV uploads from the admin tool: `change_source` CSV and `user(id)` when uploader is known. */
+export function transactionHistoryCtxCsvUpload(uploadedByUserId?: number | null): TransactionHistoryContext {
+  if (uploadedByUserId != null && uploadedByUserId > 0) {
+    return {
+      changeSource: TRANSACTION_HISTORY_SOURCE.CSV,
+      changedBy: formatTransactionHistoryUserChangedBy(uploadedByUserId),
+    };
+  }
+  return TRANSACTION_HISTORY_CTX_CSV_IMPORT;
+}
+
+export const TRANSACTION_HISTORY_CTX_RECONCILIATION_EMP_TO_CRM: TransactionHistoryContext = {
+  changeSource: TRANSACTION_HISTORY_SOURCE.RECONCILIATION,
+  changedBy: TRANSACTION_HISTORY_CHANGED_BY.RECONCILIATION_EMP_TO_CRM,
+};
+
+export const TRANSACTION_HISTORY_CTX_RECONCILIATION_CRM_TO_EMP: TransactionHistoryContext = {
+  changeSource: TRANSACTION_HISTORY_SOURCE.RECONCILIATION,
+  changedBy: TRANSACTION_HISTORY_CHANGED_BY.RECONCILIATION_CRM_TO_EMP,
+};
+
+export const TRANSACTION_HISTORY_CTX_INBOUND_WEBHOOK: TransactionHistoryContext = {
+  changeSource: TRANSACTION_HISTORY_SOURCE.INBOUND_WEBHOOK,
+  changedBy: TRANSACTION_HISTORY_CHANGED_BY.NA,
+};
+
+export const TRANSACTION_HISTORY_CTX_ADMIN_PANEL_NA: TransactionHistoryContext = {
+  changeSource: TRANSACTION_HISTORY_SOURCE.ADMIN_PANEL,
+  changedBy: TRANSACTION_HISTORY_CHANGED_BY.NA,
+};

package/src/model/csv.model.ts

@@ -3,6 +3,8 @@ import type { CSVStatusTypes, CSVRowStatusTypes, CSV_TYPES } from "./constants/c
 export interface CSV {
   id?: number;
   tenantId?: number;
+  /** Set when CSV is uploaded via an authenticated request (for transaction_history.changed_by). */
+  uploadedByUserId?: number | null;
   fileName: string;
   uploadedFileUrl: string;
   fileRows?: number;

package/src/model/transactionHistory.model.ts

@@ -0,0 +1,17 @@
+/** Full merged `Transaction` snapshot (parent + adapter-specific fields), API camelCase, stored in before_json / after_json. */
+export type TransactionSnapshotPayload = Record<string, unknown>;
+
+export interface TransactionHistory {
+  id?: number;
+  tenantId?: number;
+  transactionId?: number;
+  changedAt?: Date;
+  changedBy?: string | null;
+  changeSource?: string;
+  /** Post-update adapter enum name (duplicated for listing; also inside after_json). */
+  adapterName?: string | null;
+  /** Post-update provider enum name. */
+  providerName?: string | null;
+  beforeJson?: TransactionSnapshotPayload;
+  afterJson?: TransactionSnapshotPayload;
+}