@explorins/pers-shared 2.1.85 → 2.1.87

package/dist/cjs/shared-lib/dto/analytics/retention-analytics.dto.d.ts

@@ -25,15 +25,26 @@ export declare class RetentionAnalyticsRequestDTO {
     monthsBack?: number;
     filters?: RetentionAnalyticsFiltersDTO;
 }
+/**
+ * Retention data for a month offset within a cohort
+ * Tracks how many users from the original cohort are still active
+ */
+export declare class CohortRetentionMonthDTO {
+    retainedUsers: number;
+    retentionRate: number;
+}
+/**
+ * Cohort retention result for a single month
+ * Contains the cohort (new users in month) and their retention over subsequent months
+ */
 export declare class RetentionMonthResultDTO {
     monthKey: string;
     startDate: Date;
     endDate: Date;
-    activeUsers: number;
-    newUsers: number;
-    returningUsers: number;
-    retentionRate: number;
-    transactionCount: number;
+    cohortSize: number;
+    monthlyRetention: {
+        [monthOffset: string]: CohortRetentionMonthDTO;
+    };
     byTriggerType?: {
         [key: string]: {
             count: number;

package/dist/cjs/shared-lib/dto/analytics/retention-analytics.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retention-analytics.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/retention-analytics.dto.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;;;;;;;;;;GAeG;AAIH,qBAAa,4BAA4B;IAQvC,SAAS,CAAC,EAAE,eAAe,CAAC;IAQ5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAID,qBAAa,4BAA4B;IAOvC,UAAU,CAAC,EAAE,IAAI,CAAC;IAalB,UAAU,CAAC,EAAE,MAAM,CAAC;IASpB,OAAO,CAAC,EAAE,4BAA4B,CAAC;CACxC;AAID,qBAAa,uBAAuB;IAKlC,QAAQ,EAAG,MAAM,CAAC;IAMlB,SAAS,EAAG,IAAI,CAAC;IAMjB,OAAO,EAAG,IAAI,CAAC;IAMf,WAAW,EAAG,MAAM,CAAC;IAMrB,QAAQ,EAAG,MAAM,CAAC;IAMlB,cAAc,EAAG,MAAM,CAAC;IAMxB,aAAa,EAAG,MAAM,CAAC;IAMvB,gBAAgB,EAAG,MAAM,CAAC;IAS1B,aAAa,CAAC,EAAE;QACd,CAAC,GAAG,EAAE,MAAM,GAAG;YACb,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;CACH;AAID,qBAAa,6BAA6B;IAKxC,OAAO,EAAG,uBAAuB,EAAE,CAAC;IAMpC,WAAW,EAAG,MAAM,CAAC;IAMrB,QAAQ,EAAG,qBAAqB,GAAG;QACjC;;WAEG;QACH,iBAAiB,EAAE,gBAAgB,CAAC;KACrC,CAAC;CACH"}
+{"version":3,"file":"retention-analytics.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/retention-analytics.dto.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;;;;;;;;;;GAeG;AAIH,qBAAa,4BAA4B;IAQvC,SAAS,CAAC,EAAE,eAAe,CAAC;IAQ5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAID,qBAAa,4BAA4B;IAOvC,UAAU,CAAC,EAAE,IAAI,CAAC;IAalB,UAAU,CAAC,EAAE,MAAM,CAAC;IASpB,OAAO,CAAC,EAAE,4BAA4B,CAAC;CACxC;AAID;;;GAGG;AACH,qBAAa,uBAAuB;IAKlC,aAAa,EAAG,MAAM,CAAC;IAMvB,aAAa,EAAG,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,uBAAuB;IAKlC,QAAQ,EAAG,MAAM,CAAC;IAMlB,SAAS,EAAG,IAAI,CAAC;IAMjB,OAAO,EAAG,IAAI,CAAC;IAMf,UAAU,EAAG,MAAM,CAAC;IAWpB,gBAAgB,EAAG;QACjB,CAAC,WAAW,EAAE,MAAM,GAAG,uBAAuB,CAAC;KAChD,CAAC;IASF,aAAa,CAAC,EAAE;QACd,CAAC,GAAG,EAAE,MAAM,GAAG;YACb,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;CACH;AAID,qBAAa,6BAA6B;IAKxC,OAAO,EAAG,uBAAuB,EAAE,CAAC;IAMpC,WAAW,EAAG,MAAM,CAAC;IAMrB,QAAQ,EAAG,qBAAqB,GAAG;QACjC;;WAEG;QACH,iBAAiB,EAAE,gBAAgB,CAAC;KACrC,CAAC;CACH"}

package/dist/cjs/shared-lib/dto/analytics/retention-analytics.dto.js

@@ -9,7 +9,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RetentionAnalyticsResponseDTO = exports.RetentionMonthResultDTO = exports.RetentionAnalyticsRequestDTO = exports.RetentionAnalyticsFiltersDTO = void 0;
+exports.RetentionAnalyticsResponseDTO = exports.RetentionMonthResultDTO = exports.CohortRetentionMonthDTO = exports.RetentionAnalyticsRequestDTO = exports.RetentionAnalyticsFiltersDTO = void 0;
 const class_validator_1 = require("class-validator");
 const class_transformer_1 = require("class-transformer");
 const swagger_1 = require("@nestjs/swagger");
@@ -96,15 +96,39 @@ __decorate([
     __metadata("design:type", RetentionAnalyticsFiltersDTO)
 ], RetentionAnalyticsRequestDTO.prototype, "filters", void 0);
 // ========== MONTH RESULT ==========
+/**
+ * Retention data for a month offset within a cohort
+ * Tracks how many users from the original cohort are still active
+ */
+class CohortRetentionMonthDTO {
+    retainedUsers;
+    retentionRate;
+}
+exports.CohortRetentionMonthDTO = CohortRetentionMonthDTO;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Number of users from original cohort still active in this month offset',
+        example: 85
+    }),
+    __metadata("design:type", Number)
+], CohortRetentionMonthDTO.prototype, "retainedUsers", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Retention rate: (retainedUsers / cohortSize) * 100',
+        example: 70.8
+    }),
+    __metadata("design:type", Number)
+], CohortRetentionMonthDTO.prototype, "retentionRate", void 0);
+/**
+ * Cohort retention result for a single month
+ * Contains the cohort (new users in month) and their retention over subsequent months
+ */
 class RetentionMonthResultDTO {
     monthKey;
     startDate;
     endDate;
-    activeUsers;
-    newUsers;
-    returningUsers;
-    retentionRate;
-    transactionCount;
+    cohortSize;
+    monthlyRetention;
     byTriggerType;
 }
 exports.RetentionMonthResultDTO = RetentionMonthResultDTO;
@@ -131,39 +155,23 @@ __decorate([
 ], RetentionMonthResultDTO.prototype, "endDate", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Total number of users who made transactions in this month',
-        example: 450
-    }),
-    __metadata("design:type", Number)
-], RetentionMonthResultDTO.prototype, "activeUsers", void 0);
-__decorate([
-    (0, swagger_1.ApiProperty)({
-        description: 'Number of users making their first transaction ever',
+        description: 'Number of users who made their first transaction in this month (cohort size)',
         example: 120
     }),
     __metadata("design:type", Number)
-], RetentionMonthResultDTO.prototype, "newUsers", void 0);
-__decorate([
-    (0, swagger_1.ApiProperty)({
-        description: 'Number of users who were active in previous month and returned',
-        example: 330
-    }),
-    __metadata("design:type", Number)
-], RetentionMonthResultDTO.prototype, "returningUsers", void 0);
+], RetentionMonthResultDTO.prototype, "cohortSize", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Retention rate: (returningUsers / previousMonth.activeUsers) * 100',
-        example: 73.3
-    }),
-    __metadata("design:type", Number)
-], RetentionMonthResultDTO.prototype, "retentionRate", void 0);
-__decorate([
-    (0, swagger_1.ApiProperty)({
-        description: 'Total number of transactions in this month',
-        example: 1250
+        description: 'Retention data for this cohort over subsequent months. Key is month offset (0=same month, 1=next month, 2=2 months later, etc.)',
+        type: 'object',
+        example: {
+            '0': { retainedUsers: 120, retentionRate: 100 },
+            '1': { retainedUsers: 85, retentionRate: 70.8 },
+            '2': { retainedUsers: 65, retentionRate: 54.2 }
+        }
     }),
-    __metadata("design:type", Number)
-], RetentionMonthResultDTO.prototype, "transactionCount", void 0);
+    __metadata("design:type", Object)
+], RetentionMonthResultDTO.prototype, "monthlyRetention", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
         description: 'Breakdown of transactions by trigger type',

package/dist/cjs/shared-lib/dto/analytics/retention-analytics.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"retention-analytics.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/retention-analytics.dto.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"retention-analytics.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/retention-analytics.dto.ts"],"names":[],"mappings":"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"}

package/dist/cjs/shared-lib/dto/pagination/pagination.response.dto.d.ts

@@ -5,11 +5,21 @@ import { type PaginatedResponse, type PaginationMetadata } from "../../interface
 export declare class PaginatedResponseDTO<T> implements PaginatedResponse<T> {
     readonly data: ReadonlyArray<T>;
     readonly pagination: PaginationMetadata;
-    constructor(data: T[], page: number | null, limit: number | null, total: number);
+    readonly metadata?: {
+        includes?: string[];
+        [key: string]: any;
+    };
+    constructor(data: T[], page: number | null, limit: number | null, total: number, metadata?: {
+        includes?: string[];
+        [key: string]: any;
+    });
     /**
      * ✅ FACTORY: Create paginated response from service layer
      */
-    static create<T>(data: T[], page: number, limit: number, total: number): PaginatedResponseDTO<T>;
+    static create<T>(data: T[], page: number, limit: number, total: number, metadata?: {
+        includes?: string[];
+        [key: string]: any;
+    }): PaginatedResponseDTO<T>;
     /**
      * ✅ FACTORY: Create empty paginated response
      */

package/dist/cjs/shared-lib/dto/pagination/pagination.response.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.response.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/pagination/pagination.response.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAG7G;;GAEG;AACH,qBAAa,oBAAoB,CAAC,CAAC,CAAE,YAAW,iBAAiB,CAAC,CAAC,CAAC;IAKlE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAahC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;gBAE5B,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM;IAY/E;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,EACb,IAAI,EAAE,CAAC,EAAE,EACT,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,oBAAoB,CAAC,CAAC,CAAC;IAI1B;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,GAAE,MAAU,EAAE,KAAK,GAAE,MAAW,GAAG,oBAAoB,CAAC,CAAC,CAAC;CAG/E"}
+{"version":3,"file":"pagination.response.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/pagination/pagination.response.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAG7G;;GAEG;AACH,qBAAa,oBAAoB,CAAC,CAAC,CAAE,YAAW,iBAAiB,CAAC,CAAC,CAAC;IAKlE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAahC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IAUxC,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;gBAGA,IAAI,EAAE,CAAC,EAAE,EACT,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE;IAcxD;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,EACb,IAAI,EAAE,CAAC,EAAE,EACT,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,GACrD,oBAAoB,CAAC,CAAC,CAAC;IAI1B;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,GAAE,MAAU,EAAE,KAAK,GAAE,MAAW,GAAG,oBAAoB,CAAC,CAAC,CAAC;CAG/E"}

package/dist/cjs/shared-lib/dto/pagination/pagination.response.dto.js

@@ -17,7 +17,8 @@ const swagger_1 = require("@nestjs/swagger");
 class PaginatedResponseDTO {
     data;
     pagination;
-    constructor(data, page, limit, total) {
+    metadata;
+    constructor(data, page, limit, total, metadata) {
         this.data = Object.freeze([...data]);
         this.pagination = Object.freeze({
             page,
@@ -27,12 +28,13 @@ class PaginatedResponseDTO {
             hasNext: (page || 1) * (limit || 1) < total,
             hasPrev: (page || 1) > 1
         });
+        this.metadata = metadata ? Object.freeze(metadata) : undefined;
     }
     /**
      * ✅ FACTORY: Create paginated response from service layer
      */
-    static create(data, page, limit, total) {
-        return new PaginatedResponseDTO(data, page, limit, total);
+    static create(data, page, limit, total, metadata) {
+        return new PaginatedResponseDTO(data, page, limit, total, metadata);
     }
     /**
      * ✅ FACTORY: Create empty paginated response
@@ -63,4 +65,15 @@ __decorate([
     }),
     __metadata("design:type", Object)
 ], PaginatedResponseDTO.prototype, "pagination", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Additional metadata (e.g., enriched relations)',
+        required: false,
+        nullable: true,
+        example: {
+            includes: ['sender', 'recipient']
+        }
+    }),
+    __metadata("design:type", Object)
+], PaginatedResponseDTO.prototype, "metadata", void 0);
 //# sourceMappingURL=pagination.response.dto.js.map

package/dist/cjs/shared-lib/dto/pagination/pagination.response.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.response.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/pagination/pagination.response.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAA8C;AAI9C;;GAEG;AACH,MAAa,oBAAoB;IAKtB,IAAI,CAAmB;IAavB,UAAU,CAAqB;IAExC,YAAY,IAAS,EAAE,IAAmB,EAAE,KAAoB,EAAE,KAAa;QAC7E,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;YAC9B,IAAI;YACJ,KAAK;YACL,KAAK;YACL,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;YACtC,OAAO,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK;YAC3C,OAAO,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC;SACzB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,IAAS,EACT,IAAY,EACZ,KAAa,EACb,KAAa;QAEb,OAAO,IAAI,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAI,OAAe,CAAC,EAAE,QAAgB,EAAE;QAClD,OAAO,IAAI,oBAAoB,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACtD,CAAC;CACF;AAlDD,oDAkDC;AA7CU;IAJR,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,qBAAqB;QAClC,IAAI,EAAE,OAAO;KACd,CAAC;;kDAC8B;AAavB;IAXR,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,qBAAqB;QAClC,OAAO,EAAE;YACP,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,KAAK;SACf;KACF,CAAC;;wDACsC"}
+{"version":3,"file":"pagination.response.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/pagination/pagination.response.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAA8C;AAI9C;;GAEG;AACH,MAAa,oBAAoB;IAKtB,IAAI,CAAmB;IAavB,UAAU,CAAqB;IAU/B,QAAQ,CAGf;IAEF,YACE,IAAS,EACT,IAAmB,EACnB,KAAoB,EACpB,KAAa,EACb,QAAsD;QAEtD,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;YAC9B,IAAI;YACJ,KAAK;YACL,KAAK;YACL,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;YACtC,OAAO,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK;YAC3C,OAAO,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC;SACzB,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,IAAS,EACT,IAAY,EACZ,KAAa,EACb,KAAa,EACb,QAAsD;QAEtD,OAAO,IAAI,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAI,OAAe,CAAC,EAAE,QAAgB,EAAE;QAClD,OAAO,IAAI,oBAAoB,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACtD,CAAC;CACF;AAvED,oDAuEC;AAlEU;IAJR,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,qBAAqB;QAClC,IAAI,EAAE,OAAO;KACd,CAAC;;kDAC8B;AAavB;IAXR,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,qBAAqB;QAClC,OAAO,EAAE;YACP,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,KAAK;SACf;KACF,CAAC;;wDACsC;AAU/B;IARR,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,gDAAgD;QAC7D,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE;YACP,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;SAClC;KACF,CAAC;;sDAIA"}

package/dist/cjs/shared-lib/dto/transaction/transaction.dto.d.ts

@@ -4,6 +4,8 @@ import { TransactionTriggerProcessType } from "../../enum/transaction-trigger-pr
 import type { NativeTokenType } from "../../types/native-token.type";
 import { AccountOwnerType } from "../../enum";
 import { TransactionCompleteFields } from "../../interfaces/transaction.interface";
+import { UserDTO } from "../user.dto";
+import { BusinessDTO } from "../business/business.dto";
 export declare class TransactionDTO implements TransactionCompleteFields {
     amount: number | null;
     id: string;
@@ -29,5 +31,8 @@ export declare class TransactionDTO implements TransactionCompleteFields {
     engagedBusinessId: string | null;
     authorizedSubmitterId: string | null;
     authorizedSubmitterType: AccountOwnerType | null;
+    sender?: UserDTO | BusinessDTO;
+    recipient?: UserDTO | BusinessDTO;
+    engagedBusiness?: BusinessDTO;
 }
 //# sourceMappingURL=transaction.dto.d.ts.map

package/dist/cjs/shared-lib/dto/transaction/transaction.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/transaction/transaction.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,6BAA6B,EAAE,MAAM,kDAAkD,CAAC;AACjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAEnF,qBAAa,cAAe,YAAW,yBAAyB;IAG5D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAO;IAG5B,EAAE,EAAE,MAAM,CAAK;IAGf,YAAY,EAAE,MAAM,CAAK;IAMzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAO;IAKrC,SAAS,EAAE,eAAe,GAAG,IAAI,CAAO;IAGxC,aAAa,EAAE,MAAM,CAAK;IAG1B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAO;IAGtC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAO;IAMrC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAO;IAMvC,kBAAkB,EAAE,6BAA6B,GAAG,IAAI,CAAO;IAK/D,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAO;IAMtC,MAAM,EAAE,iBAAiB,CAA+B;IAGxD,SAAS,EAAE,IAAI,GAAG,IAAI,CAAO;IAG7B,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAO;IAG9B,QAAQ,EAAE,MAAM,CAAK;IAGrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAO;IAM7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAO/B,eAAe,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IAMhD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAOlC,kBAAkB,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IAMnD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAQ;IAM9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAMxC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAO5C,uBAAuB,EAAE,gBAAgB,GAAG,IAAI,CAAQ;CAC3D"}
+{"version":3,"file":"transaction.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/transaction/transaction.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,6BAA6B,EAAE,MAAM,kDAAkD,CAAC;AACjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,qBAAa,cAAe,YAAW,yBAAyB;IAG5D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAO;IAG5B,EAAE,EAAE,MAAM,CAAK;IAGf,YAAY,EAAE,MAAM,CAAK;IAMzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAO;IAKrC,SAAS,EAAE,eAAe,GAAG,IAAI,CAAO;IAGxC,aAAa,EAAE,MAAM,CAAK;IAG1B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAO;IAGtC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAO;IAMrC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAO;IAMvC,kBAAkB,EAAE,6BAA6B,GAAG,IAAI,CAAO;IAK/D,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAO;IAMtC,MAAM,EAAE,iBAAiB,CAA+B;IAGxD,SAAS,EAAE,IAAI,GAAG,IAAI,CAAO;IAG7B,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAO;IAG9B,QAAQ,EAAE,MAAM,CAAK;IAGrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAO;IAM7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAO/B,eAAe,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IAMhD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAOlC,kBAAkB,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IAMnD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAQ;IAM9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAMxC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAO5C,uBAAuB,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IAiBxD,MAAM,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IAW/B,SAAS,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IAQlC,eAAe,CAAC,EAAE,WAAW,CAAC;CACjC"}

package/dist/cjs/shared-lib/dto/transaction/transaction.dto.js

@@ -15,6 +15,8 @@ const transaction_type_enum_1 = require("../../enum/transaction-type.enum");
 const transaction_status_enum_1 = require("../../enum/transaction-status.enum");
 const transaction_trigger_process_type_enum_1 = require("../../enum/transaction-trigger-process-type.enum");
 const enum_1 = require("../../enum");
+const user_dto_1 = require("../user.dto");
+const business_dto_1 = require("../business/business.dto");
 class TransactionDTO {
     amount = null;
     id = '';
@@ -40,6 +42,14 @@ class TransactionDTO {
     engagedBusinessId = null;
     authorizedSubmitterId = null;
     authorizedSubmitterType = null;
+    // =====================================
+    // OPTIONAL ENRICHMENT FIELDS
+    // =====================================
+    // Only populated when include query param is specified
+    // e.g., GET /transactions?include=sender,recipient,business
+    sender;
+    recipient;
+    engagedBusiness;
 }
 exports.TransactionDTO = TransactionDTO;
 __decorate([
@@ -181,4 +191,37 @@ __decorate([
     }),
     __metadata("design:type", Object)
 ], TransactionDTO.prototype, "authorizedSubmitterType", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Enriched sender entity (User or Business). Only populated when include=sender is specified. Type is determined by senderOwnerType field.',
+        required: false,
+        nullable: true,
+        oneOf: [
+            { $ref: (0, swagger_1.getSchemaPath)(user_dto_1.UserDTO) },
+            { $ref: (0, swagger_1.getSchemaPath)(business_dto_1.BusinessDTO) }
+        ]
+    }),
+    __metadata("design:type", Object)
+], TransactionDTO.prototype, "sender", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Enriched recipient entity (User or Business). Only populated when include=recipient is specified. Type is determined by recipientOwnerType field.',
+        required: false,
+        nullable: true,
+        oneOf: [
+            { $ref: (0, swagger_1.getSchemaPath)(user_dto_1.UserDTO) },
+            { $ref: (0, swagger_1.getSchemaPath)(business_dto_1.BusinessDTO) }
+        ]
+    }),
+    __metadata("design:type", Object)
+], TransactionDTO.prototype, "recipient", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Enriched engaged business entity. Only populated when include=business is specified.',
+        required: false,
+        nullable: true,
+        type: () => business_dto_1.BusinessDTO
+    }),
+    __metadata("design:type", business_dto_1.BusinessDTO)
+], TransactionDTO.prototype, "engagedBusiness", void 0);
 //# sourceMappingURL=transaction.dto.js.map

package/dist/cjs/shared-lib/dto/transaction/transaction.dto.js.map

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

package/dist/cjs/shared-lib/types/index.d.ts

@@ -7,4 +7,5 @@ export * from './domains';
 export * from './query-specification.types';
 export * from './transaction-filters.type';
 export * from './includable-relation.type';
+export * from './transaction-include-relation.type';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/shared-lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/types/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/types/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qCAAqC,CAAC"}

package/dist/cjs/shared-lib/types/index.js

@@ -24,4 +24,5 @@ __exportStar(require("./domains"), exports);
 __exportStar(require("./query-specification.types"), exports);
 __exportStar(require("./transaction-filters.type"), exports);
 __exportStar(require("./includable-relation.type"), exports);
+__exportStar(require("./transaction-include-relation.type"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/shared-lib/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAmD;AACnD,mDAAiC;AACjC,gEAA8C;AAC9C,sDAAoC;AACpC,mDAAiC;AACjC,0DAAwC;AACxC,4CAA0B;AAC1B,8DAA4C;AAC5C,6DAA2C;AAC3C,6DAA2C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAmD;AACnD,mDAAiC;AACjC,gEAA8C;AAC9C,sDAAoC;AACpC,mDAAiC;AACjC,0DAAwC;AACxC,4CAA0B;AAC1B,8DAA4C;AAC5C,6DAA2C;AAC3C,6DAA2C;AAC3C,sEAAoD"}

package/dist/cjs/shared-lib/types/transaction-include-relation.type.d.ts

@@ -0,0 +1,29 @@
+/**
+ * TRANSACTION INCLUDE RELATION TYPE
+ *
+ * Type-safe relations for optional enrichment in transaction queries.
+ * Prevents typos and provides IDE autocomplete.
+ *
+ * Usage:
+ * ```
+ * GET /transactions?include=sender,recipient,business
+ *
+ * include: ['sender', 'recipient'] // ✅ Type-safe
+ * include: ['snder'] // ❌ Compile error
+ * ```
+ *
+ * Relations:
+ * - sender: Enriches transaction sender (polymorphic: UserDTO | BusinessDTO)
+ * - recipient: Enriches transaction recipient (polymorphic: UserDTO | BusinessDTO)
+ * - business: Enriches engaged business (BusinessDTO)
+ */
+export type TransactionIncludeRelation = 'sender' | 'recipient' | 'business';
+/**
+ * Valid transaction relations for runtime validation
+ */
+export declare const VALID_TRANSACTION_RELATIONS: readonly TransactionIncludeRelation[];
+/**
+ * Type guard to validate relation strings at runtime
+ */
+export declare function isValidTransactionRelation(value: string): value is TransactionIncludeRelation;
+//# sourceMappingURL=transaction-include-relation.type.d.ts.map

package/dist/cjs/shared-lib/types/transaction-include-relation.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-include-relation.type.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/types/transaction-include-relation.type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,0BAA0B,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;AAE7E;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,0BAA0B,EAInE,CAAC;AAEX;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,0BAA0B,CAE7F"}

package/dist/cjs/shared-lib/types/transaction-include-relation.type.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_TRANSACTION_RELATIONS = void 0;
+exports.isValidTransactionRelation = isValidTransactionRelation;
+/**
+ * Valid transaction relations for runtime validation
+ */
+exports.VALID_TRANSACTION_RELATIONS = [
+    'sender',
+    'recipient',
+    'business'
+];
+/**
+ * Type guard to validate relation strings at runtime
+ */
+function isValidTransactionRelation(value) {
+    return exports.VALID_TRANSACTION_RELATIONS.includes(value);
+}
+//# sourceMappingURL=transaction-include-relation.type.js.map

package/dist/cjs/shared-lib/types/transaction-include-relation.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-include-relation.type.js","sourceRoot":"","sources":["../../../../src/shared-lib/types/transaction-include-relation.type.ts"],"names":[],"mappings":";;;AAiCA,gEAEC;AAdD;;GAEG;AACU,QAAA,2BAA2B,GAA0C;IAChF,QAAQ;IACR,WAAW;IACX,UAAU;CACF,CAAC;AAEX;;GAEG;AACH,SAAgB,0BAA0B,CAAC,KAAa;IACtD,OAAO,mCAA2B,CAAC,QAAQ,CAAC,KAAmC,CAAC,CAAC;AACnF,CAAC"}

package/dist/esm/shared-lib/dto/analytics/retention-analytics.dto.d.ts

@@ -25,15 +25,26 @@ export declare class RetentionAnalyticsRequestDTO {
     monthsBack?: number;
     filters?: RetentionAnalyticsFiltersDTO;
 }
+/**
+ * Retention data for a month offset within a cohort
+ * Tracks how many users from the original cohort are still active
+ */
+export declare class CohortRetentionMonthDTO {
+    retainedUsers: number;
+    retentionRate: number;
+}
+/**
+ * Cohort retention result for a single month
+ * Contains the cohort (new users in month) and their retention over subsequent months
+ */
 export declare class RetentionMonthResultDTO {
     monthKey: string;
     startDate: Date;
     endDate: Date;
-    activeUsers: number;
-    newUsers: number;
-    returningUsers: number;
-    retentionRate: number;
-    transactionCount: number;
+    cohortSize: number;
+    monthlyRetention: {
+        [monthOffset: string]: CohortRetentionMonthDTO;
+    };
     byTriggerType?: {
         [key: string]: {
             count: number;

package/dist/esm/shared-lib/dto/analytics/retention-analytics.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retention-analytics.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/retention-analytics.dto.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;;;;;;;;;;GAeG;AAIH,qBAAa,4BAA4B;IAQvC,SAAS,CAAC,EAAE,eAAe,CAAC;IAQ5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAID,qBAAa,4BAA4B;IAOvC,UAAU,CAAC,EAAE,IAAI,CAAC;IAalB,UAAU,CAAC,EAAE,MAAM,CAAC;IASpB,OAAO,CAAC,EAAE,4BAA4B,CAAC;CACxC;AAID,qBAAa,uBAAuB;IAKlC,QAAQ,EAAG,MAAM,CAAC;IAMlB,SAAS,EAAG,IAAI,CAAC;IAMjB,OAAO,EAAG,IAAI,CAAC;IAMf,WAAW,EAAG,MAAM,CAAC;IAMrB,QAAQ,EAAG,MAAM,CAAC;IAMlB,cAAc,EAAG,MAAM,CAAC;IAMxB,aAAa,EAAG,MAAM,CAAC;IAMvB,gBAAgB,EAAG,MAAM,CAAC;IAS1B,aAAa,CAAC,EAAE;QACd,CAAC,GAAG,EAAE,MAAM,GAAG;YACb,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;CACH;AAID,qBAAa,6BAA6B;IAKxC,OAAO,EAAG,uBAAuB,EAAE,CAAC;IAMpC,WAAW,EAAG,MAAM,CAAC;IAMrB,QAAQ,EAAG,qBAAqB,GAAG;QACjC;;WAEG;QACH,iBAAiB,EAAE,gBAAgB,CAAC;KACrC,CAAC;CACH"}
+{"version":3,"file":"retention-analytics.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/retention-analytics.dto.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;;;;;;;;;;GAeG;AAIH,qBAAa,4BAA4B;IAQvC,SAAS,CAAC,EAAE,eAAe,CAAC;IAQ5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAID,qBAAa,4BAA4B;IAOvC,UAAU,CAAC,EAAE,IAAI,CAAC;IAalB,UAAU,CAAC,EAAE,MAAM,CAAC;IASpB,OAAO,CAAC,EAAE,4BAA4B,CAAC;CACxC;AAID;;;GAGG;AACH,qBAAa,uBAAuB;IAKlC,aAAa,EAAG,MAAM,CAAC;IAMvB,aAAa,EAAG,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,uBAAuB;IAKlC,QAAQ,EAAG,MAAM,CAAC;IAMlB,SAAS,EAAG,IAAI,CAAC;IAMjB,OAAO,EAAG,IAAI,CAAC;IAMf,UAAU,EAAG,MAAM,CAAC;IAWpB,gBAAgB,EAAG;QACjB,CAAC,WAAW,EAAE,MAAM,GAAG,uBAAuB,CAAC;KAChD,CAAC;IASF,aAAa,CAAC,EAAE;QACd,CAAC,GAAG,EAAE,MAAM,GAAG;YACb,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;CACH;AAID,qBAAa,6BAA6B;IAKxC,OAAO,EAAG,uBAAuB,EAAE,CAAC;IAMpC,WAAW,EAAG,MAAM,CAAC;IAMrB,QAAQ,EAAG,qBAAqB,GAAG;QACjC;;WAEG;QACH,iBAAiB,EAAE,gBAAgB,CAAC;KACrC,CAAC;CACH"}

package/dist/esm/shared-lib/dto/analytics/retention-analytics.dto.js

@@ -83,15 +83,36 @@ __decorate([
     Type(() => RetentionAnalyticsFiltersDTO)
 ], RetentionAnalyticsRequestDTO.prototype, "filters", void 0);
 // ========== MONTH RESULT ==========
+/**
+ * Retention data for a month offset within a cohort
+ * Tracks how many users from the original cohort are still active
+ */
+export class CohortRetentionMonthDTO {
+    retainedUsers;
+    retentionRate;
+}
+__decorate([
+    ApiProperty({
+        description: 'Number of users from original cohort still active in this month offset',
+        example: 85
+    })
+], CohortRetentionMonthDTO.prototype, "retainedUsers", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Retention rate: (retainedUsers / cohortSize) * 100',
+        example: 70.8
+    })
+], CohortRetentionMonthDTO.prototype, "retentionRate", void 0);
+/**
+ * Cohort retention result for a single month
+ * Contains the cohort (new users in month) and their retention over subsequent months
+ */
 export class RetentionMonthResultDTO {
     monthKey;
     startDate;
     endDate;
-    activeUsers;
-    newUsers;
-    returningUsers;
-    retentionRate;
-    transactionCount;
+    cohortSize;
+    monthlyRetention;
     byTriggerType;
 }
 __decorate([
@@ -114,34 +135,21 @@ __decorate([
 ], RetentionMonthResultDTO.prototype, "endDate", void 0);
 __decorate([
     ApiProperty({
-        description: 'Total number of users who made transactions in this month',
-        example: 450
-    })
-], RetentionMonthResultDTO.prototype, "activeUsers", void 0);
-__decorate([
-    ApiProperty({
-        description: 'Number of users making their first transaction ever',
+        description: 'Number of users who made their first transaction in this month (cohort size)',
         example: 120
     })
-], RetentionMonthResultDTO.prototype, "newUsers", void 0);
-__decorate([
-    ApiProperty({
-        description: 'Number of users who were active in previous month and returned',
-        example: 330
-    })
-], RetentionMonthResultDTO.prototype, "returningUsers", void 0);
-__decorate([
-    ApiProperty({
-        description: 'Retention rate: (returningUsers / previousMonth.activeUsers) * 100',
-        example: 73.3
-    })
-], RetentionMonthResultDTO.prototype, "retentionRate", void 0);
+], RetentionMonthResultDTO.prototype, "cohortSize", void 0);
 __decorate([
     ApiProperty({
-        description: 'Total number of transactions in this month',
-        example: 1250
+        description: 'Retention data for this cohort over subsequent months. Key is month offset (0=same month, 1=next month, 2=2 months later, etc.)',
+        type: 'object',
+        example: {
+            '0': { retainedUsers: 120, retentionRate: 100 },
+            '1': { retainedUsers: 85, retentionRate: 70.8 },
+            '2': { retainedUsers: 65, retentionRate: 54.2 }
+        }
     })
-], RetentionMonthResultDTO.prototype, "transactionCount", void 0);
+], RetentionMonthResultDTO.prototype, "monthlyRetention", void 0);
 __decorate([
     ApiPropertyOptional({
         description: 'Breakdown of transactions by trigger type',

package/dist/esm/shared-lib/dto/analytics/retention-analytics.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"retention-analytics.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/retention-analytics.dto.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"retention-analytics.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/retention-analytics.dto.ts"],"names":[],"mappings":"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"}

package/dist/esm/shared-lib/dto/pagination/pagination.response.dto.d.ts

@@ -5,11 +5,21 @@ import { type PaginatedResponse, type PaginationMetadata } from "../../interface
 export declare class PaginatedResponseDTO<T> implements PaginatedResponse<T> {
     readonly data: ReadonlyArray<T>;
     readonly pagination: PaginationMetadata;
-    constructor(data: T[], page: number | null, limit: number | null, total: number);
+    readonly metadata?: {
+        includes?: string[];
+        [key: string]: any;
+    };
+    constructor(data: T[], page: number | null, limit: number | null, total: number, metadata?: {
+        includes?: string[];
+        [key: string]: any;
+    });
     /**
      * ✅ FACTORY: Create paginated response from service layer
      */
-    static create<T>(data: T[], page: number, limit: number, total: number): PaginatedResponseDTO<T>;
+    static create<T>(data: T[], page: number, limit: number, total: number, metadata?: {
+        includes?: string[];
+        [key: string]: any;
+    }): PaginatedResponseDTO<T>;
     /**
      * ✅ FACTORY: Create empty paginated response
      */

package/dist/esm/shared-lib/dto/pagination/pagination.response.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.response.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/pagination/pagination.response.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAG7G;;GAEG;AACH,qBAAa,oBAAoB,CAAC,CAAC,CAAE,YAAW,iBAAiB,CAAC,CAAC,CAAC;IAKlE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAahC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;gBAE5B,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM;IAY/E;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,EACb,IAAI,EAAE,CAAC,EAAE,EACT,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,oBAAoB,CAAC,CAAC,CAAC;IAI1B;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,GAAE,MAAU,EAAE,KAAK,GAAE,MAAW,GAAG,oBAAoB,CAAC,CAAC,CAAC;CAG/E"}
+{"version":3,"file":"pagination.response.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/pagination/pagination.response.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAG7G;;GAEG;AACH,qBAAa,oBAAoB,CAAC,CAAC,CAAE,YAAW,iBAAiB,CAAC,CAAC,CAAC;IAKlE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAahC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IAUxC,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;gBAGA,IAAI,EAAE,CAAC,EAAE,EACT,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE;IAcxD;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,EACb,IAAI,EAAE,CAAC,EAAE,EACT,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,GACrD,oBAAoB,CAAC,CAAC,CAAC;IAI1B;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,GAAE,MAAU,EAAE,KAAK,GAAE,MAAW,GAAG,oBAAoB,CAAC,CAAC,CAAC;CAG/E"}

package/dist/esm/shared-lib/dto/pagination/pagination.response.dto.js

@@ -11,7 +11,8 @@ import { ApiProperty } from "@nestjs/swagger";
 export class PaginatedResponseDTO {
     data;
     pagination;
-    constructor(data, page, limit, total) {
+    metadata;
+    constructor(data, page, limit, total, metadata) {
         this.data = Object.freeze([...data]);
         this.pagination = Object.freeze({
             page,
@@ -21,12 +22,13 @@ export class PaginatedResponseDTO {
             hasNext: (page || 1) * (limit || 1) < total,
             hasPrev: (page || 1) > 1
         });
+        this.metadata = metadata ? Object.freeze(metadata) : undefined;
     }
     /**
      * ✅ FACTORY: Create paginated response from service layer
      */
-    static create(data, page, limit, total) {
-        return new PaginatedResponseDTO(data, page, limit, total);
+    static create(data, page, limit, total, metadata) {
+        return new PaginatedResponseDTO(data, page, limit, total, metadata);
     }
     /**
      * ✅ FACTORY: Create empty paginated response
@@ -54,4 +56,14 @@ __decorate([
         }
     })
 ], PaginatedResponseDTO.prototype, "pagination", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Additional metadata (e.g., enriched relations)',
+        required: false,
+        nullable: true,
+        example: {
+            includes: ['sender', 'recipient']
+        }
+    })
+], PaginatedResponseDTO.prototype, "metadata", void 0);
 //# sourceMappingURL=pagination.response.dto.js.map

package/dist/esm/shared-lib/dto/pagination/pagination.response.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.response.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/pagination/pagination.response.dto.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI9C;;GAEG;AACH,MAAM,OAAO,oBAAoB;IAKtB,IAAI,CAAmB;IAavB,UAAU,CAAqB;IAExC,YAAY,IAAS,EAAE,IAAmB,EAAE,KAAoB,EAAE,KAAa;QAC7E,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;YAC9B,IAAI;YACJ,KAAK;YACL,KAAK;YACL,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;YACtC,OAAO,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK;YAC3C,OAAO,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC;SACzB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,IAAS,EACT,IAAY,EACZ,KAAa,EACb,KAAa;QAEb,OAAO,IAAI,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAI,OAAe,CAAC,EAAE,QAAgB,EAAE;QAClD,OAAO,IAAI,oBAAoB,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACtD,CAAC;CACF;AA7CU;IAJR,WAAW,CAAC;QACX,WAAW,EAAE,qBAAqB;QAClC,IAAI,EAAE,OAAO;KACd,CAAC;kDAC8B;AAavB;IAXR,WAAW,CAAC;QACX,WAAW,EAAE,qBAAqB;QAClC,OAAO,EAAE;YACP,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,KAAK;SACf;KACF,CAAC;wDACsC"}
+{"version":3,"file":"pagination.response.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/pagination/pagination.response.dto.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI9C;;GAEG;AACH,MAAM,OAAO,oBAAoB;IAKtB,IAAI,CAAmB;IAavB,UAAU,CAAqB;IAU/B,QAAQ,CAGf;IAEF,YACE,IAAS,EACT,IAAmB,EACnB,KAAoB,EACpB,KAAa,EACb,QAAsD;QAEtD,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;YAC9B,IAAI;YACJ,KAAK;YACL,KAAK;YACL,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;YACtC,OAAO,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK;YAC3C,OAAO,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC;SACzB,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,IAAS,EACT,IAAY,EACZ,KAAa,EACb,KAAa,EACb,QAAsD;QAEtD,OAAO,IAAI,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAI,OAAe,CAAC,EAAE,QAAgB,EAAE;QAClD,OAAO,IAAI,oBAAoB,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACtD,CAAC;CACF;AAlEU;IAJR,WAAW,CAAC;QACX,WAAW,EAAE,qBAAqB;QAClC,IAAI,EAAE,OAAO;KACd,CAAC;kDAC8B;AAavB;IAXR,WAAW,CAAC;QACX,WAAW,EAAE,qBAAqB;QAClC,OAAO,EAAE;YACP,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,KAAK;SACf;KACF,CAAC;wDACsC;AAU/B;IARR,WAAW,CAAC;QACX,WAAW,EAAE,gDAAgD;QAC7D,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE;YACP,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;SAClC;KACF,CAAC;sDAIA"}

package/dist/esm/shared-lib/dto/transaction/transaction.dto.d.ts

@@ -4,6 +4,8 @@ import { TransactionTriggerProcessType } from "../../enum/transaction-trigger-pr
 import type { NativeTokenType } from "../../types/native-token.type";
 import { AccountOwnerType } from "../../enum";
 import { TransactionCompleteFields } from "../../interfaces/transaction.interface";
+import { UserDTO } from "../user.dto";
+import { BusinessDTO } from "../business/business.dto";
 export declare class TransactionDTO implements TransactionCompleteFields {
     amount: number | null;
     id: string;
@@ -29,5 +31,8 @@ export declare class TransactionDTO implements TransactionCompleteFields {
     engagedBusinessId: string | null;
     authorizedSubmitterId: string | null;
     authorizedSubmitterType: AccountOwnerType | null;
+    sender?: UserDTO | BusinessDTO;
+    recipient?: UserDTO | BusinessDTO;
+    engagedBusiness?: BusinessDTO;
 }
 //# sourceMappingURL=transaction.dto.d.ts.map

package/dist/esm/shared-lib/dto/transaction/transaction.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/transaction/transaction.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,6BAA6B,EAAE,MAAM,kDAAkD,CAAC;AACjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAEnF,qBAAa,cAAe,YAAW,yBAAyB;IAG5D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAO;IAG5B,EAAE,EAAE,MAAM,CAAK;IAGf,YAAY,EAAE,MAAM,CAAK;IAMzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAO;IAKrC,SAAS,EAAE,eAAe,GAAG,IAAI,CAAO;IAGxC,aAAa,EAAE,MAAM,CAAK;IAG1B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAO;IAGtC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAO;IAMrC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAO;IAMvC,kBAAkB,EAAE,6BAA6B,GAAG,IAAI,CAAO;IAK/D,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAO;IAMtC,MAAM,EAAE,iBAAiB,CAA+B;IAGxD,SAAS,EAAE,IAAI,GAAG,IAAI,CAAO;IAG7B,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAO;IAG9B,QAAQ,EAAE,MAAM,CAAK;IAGrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAO;IAM7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAO/B,eAAe,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IAMhD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAOlC,kBAAkB,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IAMnD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAQ;IAM9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAMxC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAO5C,uBAAuB,EAAE,gBAAgB,GAAG,IAAI,CAAQ;CAC3D"}
+{"version":3,"file":"transaction.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/transaction/transaction.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,6BAA6B,EAAE,MAAM,kDAAkD,CAAC;AACjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,qBAAa,cAAe,YAAW,yBAAyB;IAG5D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAO;IAG5B,EAAE,EAAE,MAAM,CAAK;IAGf,YAAY,EAAE,MAAM,CAAK;IAMzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAO;IAKrC,SAAS,EAAE,eAAe,GAAG,IAAI,CAAO;IAGxC,aAAa,EAAE,MAAM,CAAK;IAG1B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAO;IAGtC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAO;IAMrC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAO;IAMvC,kBAAkB,EAAE,6BAA6B,GAAG,IAAI,CAAO;IAK/D,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAO;IAMtC,MAAM,EAAE,iBAAiB,CAA+B;IAGxD,SAAS,EAAE,IAAI,GAAG,IAAI,CAAO;IAG7B,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAO;IAG9B,QAAQ,EAAE,MAAM,CAAK;IAGrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAO;IAM7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAO/B,eAAe,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IAMhD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAOlC,kBAAkB,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IAMnD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAQ;IAM9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAMxC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAO5C,uBAAuB,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IAiBxD,MAAM,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IAW/B,SAAS,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IAQlC,eAAe,CAAC,EAAE,WAAW,CAAC;CACjC"}

package/dist/esm/shared-lib/dto/transaction/transaction.dto.js

@@ -4,11 +4,13 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { ApiProperty } from "@nestjs/swagger";
+import { ApiProperty, getSchemaPath } from "@nestjs/swagger";
 import { Web3TransactionType } from "../../enum/transaction-type.enum.js";
 import { TransactionStatus } from "../../enum/transaction-status.enum.js";
 import { TransactionTriggerProcessType } from "../../enum/transaction-trigger-process-type.enum.js";
 import { AccountOwnerType } from "../../enum/index.js";
+import { UserDTO } from "../user.dto.js";
+import { BusinessDTO } from "../business/business.dto.js";
 export class TransactionDTO {
     amount = null;
     id = '';
@@ -34,6 +36,14 @@ export class TransactionDTO {
     engagedBusinessId = null;
     authorizedSubmitterId = null;
     authorizedSubmitterType = null;
+    // =====================================
+    // OPTIONAL ENRICHMENT FIELDS
+    // =====================================
+    // Only populated when include query param is specified
+    // e.g., GET /transactions?include=sender,recipient,business
+    sender;
+    recipient;
+    engagedBusiness;
 }
 __decorate([
     ApiProperty({ description: 'Transaction amount' })
@@ -150,4 +160,34 @@ __decorate([
         enum: AccountOwnerType
     })
 ], TransactionDTO.prototype, "authorizedSubmitterType", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Enriched sender entity (User or Business). Only populated when include=sender is specified. Type is determined by senderOwnerType field.',
+        required: false,
+        nullable: true,
+        oneOf: [
+            { $ref: getSchemaPath(UserDTO) },
+            { $ref: getSchemaPath(BusinessDTO) }
+        ]
+    })
+], TransactionDTO.prototype, "sender", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Enriched recipient entity (User or Business). Only populated when include=recipient is specified. Type is determined by recipientOwnerType field.',
+        required: false,
+        nullable: true,
+        oneOf: [
+            { $ref: getSchemaPath(UserDTO) },
+            { $ref: getSchemaPath(BusinessDTO) }
+        ]
+    })
+], TransactionDTO.prototype, "recipient", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Enriched engaged business entity. Only populated when include=business is specified.',
+        required: false,
+        nullable: true,
+        type: () => BusinessDTO
+    })
+], TransactionDTO.prototype, "engagedBusiness", void 0);
 //# sourceMappingURL=transaction.dto.js.map

package/dist/esm/shared-lib/dto/transaction/transaction.dto.js.map

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

package/dist/esm/shared-lib/types/index.d.ts

@@ -7,4 +7,5 @@ export * from './domains';
 export * from './query-specification.types';
 export * from './transaction-filters.type';
 export * from './includable-relation.type';
+export * from './transaction-include-relation.type';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/shared-lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/types/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/types/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qCAAqC,CAAC"}

package/dist/esm/shared-lib/types/index.js

@@ -8,4 +8,5 @@ export * from './domains.js';
 export * from './query-specification.types.js';
 export * from './transaction-filters.type.js';
 export * from './includable-relation.type.js';
+export * from './transaction-include-relation.type.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/shared-lib/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/types/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/types/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qCAAqC,CAAC"}

package/dist/esm/shared-lib/types/transaction-include-relation.type.d.ts

@@ -0,0 +1,29 @@
+/**
+ * TRANSACTION INCLUDE RELATION TYPE
+ *
+ * Type-safe relations for optional enrichment in transaction queries.
+ * Prevents typos and provides IDE autocomplete.
+ *
+ * Usage:
+ * ```
+ * GET /transactions?include=sender,recipient,business
+ *
+ * include: ['sender', 'recipient'] // ✅ Type-safe
+ * include: ['snder'] // ❌ Compile error
+ * ```
+ *
+ * Relations:
+ * - sender: Enriches transaction sender (polymorphic: UserDTO | BusinessDTO)
+ * - recipient: Enriches transaction recipient (polymorphic: UserDTO | BusinessDTO)
+ * - business: Enriches engaged business (BusinessDTO)
+ */
+export type TransactionIncludeRelation = 'sender' | 'recipient' | 'business';
+/**
+ * Valid transaction relations for runtime validation
+ */
+export declare const VALID_TRANSACTION_RELATIONS: readonly TransactionIncludeRelation[];
+/**
+ * Type guard to validate relation strings at runtime
+ */
+export declare function isValidTransactionRelation(value: string): value is TransactionIncludeRelation;
+//# sourceMappingURL=transaction-include-relation.type.d.ts.map

package/dist/esm/shared-lib/types/transaction-include-relation.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-include-relation.type.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/types/transaction-include-relation.type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,0BAA0B,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;AAE7E;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,0BAA0B,EAInE,CAAC;AAEX;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,0BAA0B,CAE7F"}

package/dist/esm/shared-lib/types/transaction-include-relation.type.js

@@ -0,0 +1,15 @@
+/**
+ * Valid transaction relations for runtime validation
+ */
+export const VALID_TRANSACTION_RELATIONS = [
+    'sender',
+    'recipient',
+    'business'
+];
+/**
+ * Type guard to validate relation strings at runtime
+ */
+export function isValidTransactionRelation(value) {
+    return VALID_TRANSACTION_RELATIONS.includes(value);
+}
+//# sourceMappingURL=transaction-include-relation.type.js.map

package/dist/esm/shared-lib/types/transaction-include-relation.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-include-relation.type.js","sourceRoot":"","sources":["../../../../src/shared-lib/types/transaction-include-relation.type.ts"],"names":[],"mappings":"AAqBA;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAA0C;IAChF,QAAQ;IACR,WAAW;IACX,UAAU;CACF,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAa;IACtD,OAAO,2BAA2B,CAAC,QAAQ,CAAC,KAAmC,CAAC,CAAC;AACnF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-shared",
-  "version": "2.1.85",
+  "version": "2.1.87",
   "scripts": {
     "clean": "find dist -type f -delete 2>/dev/null || true",
     "build:esm": "tsc -p tsconfig.esm.json && node scripts/add-js-extensions.js",