@explorins/pers-shared 2.1.86 → 2.1.88

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/dist/cjs/shared-lib/dto/pagination/pagination.response.dto.d.ts +12 -2
  2. package/dist/cjs/shared-lib/dto/pagination/pagination.response.dto.d.ts.map +1 -1
  3. package/dist/cjs/shared-lib/dto/pagination/pagination.response.dto.js +16 -3
  4. package/dist/cjs/shared-lib/dto/pagination/pagination.response.dto.js.map +1 -1
  5. package/dist/cjs/shared-lib/dto/transaction/transaction.dto.d.ts +7 -0
  6. package/dist/cjs/shared-lib/dto/transaction/transaction.dto.d.ts.map +1 -1
  7. package/dist/cjs/shared-lib/dto/transaction/transaction.dto.js +38 -0
  8. package/dist/cjs/shared-lib/dto/transaction/transaction.dto.js.map +1 -1
  9. package/dist/cjs/shared-lib/types/index.d.ts +1 -0
  10. package/dist/cjs/shared-lib/types/index.d.ts.map +1 -1
  11. package/dist/cjs/shared-lib/types/index.js +1 -0
  12. package/dist/cjs/shared-lib/types/index.js.map +1 -1
  13. package/dist/cjs/shared-lib/types/transaction-include-relation.type.d.ts +29 -0
  14. package/dist/cjs/shared-lib/types/transaction-include-relation.type.d.ts.map +1 -0
  15. package/dist/cjs/shared-lib/types/transaction-include-relation.type.js +19 -0
  16. package/dist/cjs/shared-lib/types/transaction-include-relation.type.js.map +1 -0
  17. package/dist/esm/shared-lib/dto/pagination/pagination.response.dto.d.ts +12 -2
  18. package/dist/esm/shared-lib/dto/pagination/pagination.response.dto.d.ts.map +1 -1
  19. package/dist/esm/shared-lib/dto/pagination/pagination.response.dto.js +15 -3
  20. package/dist/esm/shared-lib/dto/pagination/pagination.response.dto.js.map +1 -1
  21. package/dist/esm/shared-lib/dto/transaction/transaction.dto.d.ts +7 -0
  22. package/dist/esm/shared-lib/dto/transaction/transaction.dto.d.ts.map +1 -1
  23. package/dist/esm/shared-lib/dto/transaction/transaction.dto.js +38 -1
  24. package/dist/esm/shared-lib/dto/transaction/transaction.dto.js.map +1 -1
  25. package/dist/esm/shared-lib/types/index.d.ts +1 -0
  26. package/dist/esm/shared-lib/types/index.d.ts.map +1 -1
  27. package/dist/esm/shared-lib/types/index.js +1 -0
  28. package/dist/esm/shared-lib/types/index.js.map +1 -1
  29. package/dist/esm/shared-lib/types/transaction-include-relation.type.d.ts +29 -0
  30. package/dist/esm/shared-lib/types/transaction-include-relation.type.d.ts.map +1 -0
  31. package/dist/esm/shared-lib/types/transaction-include-relation.type.js +15 -0
  32. package/dist/esm/shared-lib/types/transaction-include-relation.type.js.map +1 -0
  33. package/package.json +1 -1
@@ -5,11 +5,21 @@ import { type PaginatedResponse, type PaginationMetadata } from "../../interface
5
5
  export declare class PaginatedResponseDTO<T> implements PaginatedResponse<T> {
6
6
  readonly data: ReadonlyArray<T>;
7
7
  readonly pagination: PaginationMetadata;
8
- constructor(data: T[], page: number | null, limit: number | null, total: number);
8
+ readonly metadata?: {
9
+ includes?: string[];
10
+ [key: string]: any;
11
+ };
12
+ constructor(data: T[], page: number | null, limit: number | null, total: number, metadata?: {
13
+ includes?: string[];
14
+ [key: string]: any;
15
+ });
9
16
  /**
10
17
  * ✅ FACTORY: Create paginated response from service layer
11
18
  */
12
- static create<T>(data: T[], page: number, limit: number, total: number): PaginatedResponseDTO<T>;
19
+ static create<T>(data: T[], page: number, limit: number, total: number, metadata?: {
20
+ includes?: string[];
21
+ [key: string]: any;
22
+ }): PaginatedResponseDTO<T>;
13
23
  /**
14
24
  * ✅ FACTORY: Create empty paginated response
15
25
  */
@@ -1 +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"}
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;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"}
@@ -17,7 +17,8 @@ const swagger_1 = require("@nestjs/swagger");
17
17
  class PaginatedResponseDTO {
18
18
  data;
19
19
  pagination;
20
- constructor(data, page, limit, total) {
20
+ metadata;
21
+ constructor(data, page, limit, total, metadata) {
21
22
  this.data = Object.freeze([...data]);
22
23
  this.pagination = Object.freeze({
23
24
  page,
@@ -27,12 +28,13 @@ class PaginatedResponseDTO {
27
28
  hasNext: (page || 1) * (limit || 1) < total,
28
29
  hasPrev: (page || 1) > 1
29
30
  });
31
+ this.metadata = metadata ? Object.freeze(metadata) : undefined;
30
32
  }
31
33
  /**
32
34
  * ✅ FACTORY: Create paginated response from service layer
33
35
  */
34
- static create(data, page, limit, total) {
35
- return new PaginatedResponseDTO(data, page, limit, total);
36
+ static create(data, page, limit, total, metadata) {
37
+ return new PaginatedResponseDTO(data, page, limit, total, metadata);
36
38
  }
37
39
  /**
38
40
  * ✅ FACTORY: Create empty paginated response
@@ -63,4 +65,15 @@ __decorate([
63
65
  }),
64
66
  __metadata("design:type", Object)
65
67
  ], PaginatedResponseDTO.prototype, "pagination", void 0);
68
+ __decorate([
69
+ (0, swagger_1.ApiProperty)({
70
+ description: 'Additional metadata (e.g., enriched relations)',
71
+ required: false,
72
+ nullable: true,
73
+ example: {
74
+ includes: ['sender', 'recipient']
75
+ }
76
+ }),
77
+ __metadata("design:type", Object)
78
+ ], PaginatedResponseDTO.prototype, "metadata", void 0);
66
79
  //# sourceMappingURL=pagination.response.dto.js.map
@@ -1 +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"}
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;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"}
@@ -4,6 +4,8 @@ import { TransactionTriggerProcessType } from "../../enum/transaction-trigger-pr
4
4
  import type { NativeTokenType } from "../../types/native-token.type";
5
5
  import { AccountOwnerType } from "../../enum";
6
6
  import { TransactionCompleteFields } from "../../interfaces/transaction.interface";
7
+ import { UserDTO } from "../user.dto";
8
+ import { BusinessDTO } from "../business/business.dto";
7
9
  export declare class TransactionDTO implements TransactionCompleteFields {
8
10
  amount: number | null;
9
11
  id: string;
@@ -29,5 +31,10 @@ export declare class TransactionDTO implements TransactionCompleteFields {
29
31
  engagedBusinessId: string | null;
30
32
  authorizedSubmitterId: string | null;
31
33
  authorizedSubmitterType: AccountOwnerType | null;
34
+ included?: {
35
+ sender?: UserDTO | BusinessDTO;
36
+ recipient?: UserDTO | BusinessDTO;
37
+ engagedBusiness?: BusinessDTO;
38
+ };
32
39
  }
33
40
  //# sourceMappingURL=transaction.dto.d.ts.map
@@ -1 +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"}
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;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;IAmCxD,QAAQ,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;QAC/B,SAAS,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;QAClC,eAAe,CAAC,EAAE,WAAW,CAAC;KACjC,CAAC;CACL"}
@@ -15,6 +15,8 @@ const transaction_type_enum_1 = require("../../enum/transaction-type.enum");
15
15
  const transaction_status_enum_1 = require("../../enum/transaction-status.enum");
16
16
  const transaction_trigger_process_type_enum_1 = require("../../enum/transaction-trigger-process-type.enum");
17
17
  const enum_1 = require("../../enum");
18
+ const user_dto_1 = require("../user.dto");
19
+ const business_dto_1 = require("../business/business.dto");
18
20
  class TransactionDTO {
19
21
  amount = null;
20
22
  id = '';
@@ -40,6 +42,13 @@ class TransactionDTO {
40
42
  engagedBusinessId = null;
41
43
  authorizedSubmitterId = null;
42
44
  authorizedSubmitterType = null;
45
+ // =====================================
46
+ // OPTIONAL INCLUDED ENTITIES
47
+ // =====================================
48
+ // Only populated when include query param is specified
49
+ // e.g., GET /transactions?include=sender,recipient,business
50
+ // Follows JSON:API convention for sideloaded entities
51
+ included;
43
52
  }
44
53
  exports.TransactionDTO = TransactionDTO;
45
54
  __decorate([
@@ -181,4 +190,33 @@ __decorate([
181
190
  }),
182
191
  __metadata("design:type", Object)
183
192
  ], TransactionDTO.prototype, "authorizedSubmitterType", void 0);
193
+ __decorate([
194
+ (0, swagger_1.ApiProperty)({
195
+ description: 'Included related entities. Only populated when include parameter is specified. Contains sender, recipient, and/or engaged business entities based on requested relations.',
196
+ required: false,
197
+ nullable: true,
198
+ type: 'object',
199
+ properties: {
200
+ sender: {
201
+ description: 'Included sender entity (User or Business)',
202
+ oneOf: [
203
+ { $ref: (0, swagger_1.getSchemaPath)(user_dto_1.UserDTO) },
204
+ { $ref: (0, swagger_1.getSchemaPath)(business_dto_1.BusinessDTO) }
205
+ ]
206
+ },
207
+ recipient: {
208
+ description: 'Included recipient entity (User or Business)',
209
+ oneOf: [
210
+ { $ref: (0, swagger_1.getSchemaPath)(user_dto_1.UserDTO) },
211
+ { $ref: (0, swagger_1.getSchemaPath)(business_dto_1.BusinessDTO) }
212
+ ]
213
+ },
214
+ engagedBusiness: {
215
+ description: 'Included engaged business entity',
216
+ $ref: (0, swagger_1.getSchemaPath)(business_dto_1.BusinessDTO)
217
+ }
218
+ }
219
+ }),
220
+ __metadata("design:type", Object)
221
+ ], TransactionDTO.prototype, "included", void 0);
184
222
  //# sourceMappingURL=transaction.dto.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"transaction.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/transaction/transaction.dto.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"transaction.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/transaction/transaction.dto.ts"],"names":[],"mappings":"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"}
@@ -7,4 +7,5 @@ export * from './domains';
7
7
  export * from './query-specification.types';
8
8
  export * from './transaction-filters.type';
9
9
  export * from './includable-relation.type';
10
+ export * from './transaction-include-relation.type';
10
11
  //# sourceMappingURL=index.d.ts.map
@@ -1 +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"}
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;AAC3C,cAAc,qCAAqC,CAAC"}
@@ -24,4 +24,5 @@ __exportStar(require("./domains"), exports);
24
24
  __exportStar(require("./query-specification.types"), exports);
25
25
  __exportStar(require("./transaction-filters.type"), exports);
26
26
  __exportStar(require("./includable-relation.type"), exports);
27
+ __exportStar(require("./transaction-include-relation.type"), exports);
27
28
  //# sourceMappingURL=index.js.map
@@ -1 +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"}
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;AAC3C,sEAAoD"}
@@ -0,0 +1,29 @@
1
+ /**
2
+ * TRANSACTION INCLUDE RELATION TYPE
3
+ *
4
+ * Type-safe relations for optional enrichment in transaction queries.
5
+ * Prevents typos and provides IDE autocomplete.
6
+ *
7
+ * Usage:
8
+ * ```
9
+ * GET /transactions?include=sender,recipient,business
10
+ *
11
+ * include: ['sender', 'recipient'] // ✅ Type-safe
12
+ * include: ['snder'] // ❌ Compile error
13
+ * ```
14
+ *
15
+ * Relations:
16
+ * - sender: Enriches transaction sender (polymorphic: UserDTO | BusinessDTO)
17
+ * - recipient: Enriches transaction recipient (polymorphic: UserDTO | BusinessDTO)
18
+ * - business: Enriches engaged business (BusinessDTO)
19
+ */
20
+ export type TransactionIncludeRelation = 'sender' | 'recipient' | 'business';
21
+ /**
22
+ * Valid transaction relations for runtime validation
23
+ */
24
+ export declare const VALID_TRANSACTION_RELATIONS: readonly TransactionIncludeRelation[];
25
+ /**
26
+ * Type guard to validate relation strings at runtime
27
+ */
28
+ export declare function isValidTransactionRelation(value: string): value is TransactionIncludeRelation;
29
+ //# sourceMappingURL=transaction-include-relation.type.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,19 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.VALID_TRANSACTION_RELATIONS = void 0;
4
+ exports.isValidTransactionRelation = isValidTransactionRelation;
5
+ /**
6
+ * Valid transaction relations for runtime validation
7
+ */
8
+ exports.VALID_TRANSACTION_RELATIONS = [
9
+ 'sender',
10
+ 'recipient',
11
+ 'business'
12
+ ];
13
+ /**
14
+ * Type guard to validate relation strings at runtime
15
+ */
16
+ function isValidTransactionRelation(value) {
17
+ return exports.VALID_TRANSACTION_RELATIONS.includes(value);
18
+ }
19
+ //# sourceMappingURL=transaction-include-relation.type.js.map
@@ -0,0 +1 @@
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"}
@@ -5,11 +5,21 @@ import { type PaginatedResponse, type PaginationMetadata } from "../../interface
5
5
  export declare class PaginatedResponseDTO<T> implements PaginatedResponse<T> {
6
6
  readonly data: ReadonlyArray<T>;
7
7
  readonly pagination: PaginationMetadata;
8
- constructor(data: T[], page: number | null, limit: number | null, total: number);
8
+ readonly metadata?: {
9
+ includes?: string[];
10
+ [key: string]: any;
11
+ };
12
+ constructor(data: T[], page: number | null, limit: number | null, total: number, metadata?: {
13
+ includes?: string[];
14
+ [key: string]: any;
15
+ });
9
16
  /**
10
17
  * ✅ FACTORY: Create paginated response from service layer
11
18
  */
12
- static create<T>(data: T[], page: number, limit: number, total: number): PaginatedResponseDTO<T>;
19
+ static create<T>(data: T[], page: number, limit: number, total: number, metadata?: {
20
+ includes?: string[];
21
+ [key: string]: any;
22
+ }): PaginatedResponseDTO<T>;
13
23
  /**
14
24
  * ✅ FACTORY: Create empty paginated response
15
25
  */
@@ -1 +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"}
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;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"}
@@ -11,7 +11,8 @@ import { ApiProperty } from "@nestjs/swagger";
11
11
  export class PaginatedResponseDTO {
12
12
  data;
13
13
  pagination;
14
- constructor(data, page, limit, total) {
14
+ metadata;
15
+ constructor(data, page, limit, total, metadata) {
15
16
  this.data = Object.freeze([...data]);
16
17
  this.pagination = Object.freeze({
17
18
  page,
@@ -21,12 +22,13 @@ export class PaginatedResponseDTO {
21
22
  hasNext: (page || 1) * (limit || 1) < total,
22
23
  hasPrev: (page || 1) > 1
23
24
  });
25
+ this.metadata = metadata ? Object.freeze(metadata) : undefined;
24
26
  }
25
27
  /**
26
28
  * ✅ FACTORY: Create paginated response from service layer
27
29
  */
28
- static create(data, page, limit, total) {
29
- return new PaginatedResponseDTO(data, page, limit, total);
30
+ static create(data, page, limit, total, metadata) {
31
+ return new PaginatedResponseDTO(data, page, limit, total, metadata);
30
32
  }
31
33
  /**
32
34
  * ✅ FACTORY: Create empty paginated response
@@ -54,4 +56,14 @@ __decorate([
54
56
  }
55
57
  })
56
58
  ], PaginatedResponseDTO.prototype, "pagination", void 0);
59
+ __decorate([
60
+ ApiProperty({
61
+ description: 'Additional metadata (e.g., enriched relations)',
62
+ required: false,
63
+ nullable: true,
64
+ example: {
65
+ includes: ['sender', 'recipient']
66
+ }
67
+ })
68
+ ], PaginatedResponseDTO.prototype, "metadata", void 0);
57
69
  //# sourceMappingURL=pagination.response.dto.js.map
@@ -1 +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"}
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;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"}
@@ -4,6 +4,8 @@ import { TransactionTriggerProcessType } from "../../enum/transaction-trigger-pr
4
4
  import type { NativeTokenType } from "../../types/native-token.type";
5
5
  import { AccountOwnerType } from "../../enum";
6
6
  import { TransactionCompleteFields } from "../../interfaces/transaction.interface";
7
+ import { UserDTO } from "../user.dto";
8
+ import { BusinessDTO } from "../business/business.dto";
7
9
  export declare class TransactionDTO implements TransactionCompleteFields {
8
10
  amount: number | null;
9
11
  id: string;
@@ -29,5 +31,10 @@ export declare class TransactionDTO implements TransactionCompleteFields {
29
31
  engagedBusinessId: string | null;
30
32
  authorizedSubmitterId: string | null;
31
33
  authorizedSubmitterType: AccountOwnerType | null;
34
+ included?: {
35
+ sender?: UserDTO | BusinessDTO;
36
+ recipient?: UserDTO | BusinessDTO;
37
+ engagedBusiness?: BusinessDTO;
38
+ };
32
39
  }
33
40
  //# sourceMappingURL=transaction.dto.d.ts.map
@@ -1 +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"}
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;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;IAmCxD,QAAQ,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;QAC/B,SAAS,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;QAClC,eAAe,CAAC,EAAE,WAAW,CAAC;KACjC,CAAC;CACL"}
@@ -4,11 +4,13 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
4
4
  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;
5
5
  return c > 3 && r && Object.defineProperty(target, key, r), r;
6
6
  };
7
- import { ApiProperty } from "@nestjs/swagger";
7
+ import { ApiProperty, getSchemaPath } from "@nestjs/swagger";
8
8
  import { Web3TransactionType } from "../../enum/transaction-type.enum.js";
9
9
  import { TransactionStatus } from "../../enum/transaction-status.enum.js";
10
10
  import { TransactionTriggerProcessType } from "../../enum/transaction-trigger-process-type.enum.js";
11
11
  import { AccountOwnerType } from "../../enum/index.js";
12
+ import { UserDTO } from "../user.dto.js";
13
+ import { BusinessDTO } from "../business/business.dto.js";
12
14
  export class TransactionDTO {
13
15
  amount = null;
14
16
  id = '';
@@ -34,6 +36,13 @@ export class TransactionDTO {
34
36
  engagedBusinessId = null;
35
37
  authorizedSubmitterId = null;
36
38
  authorizedSubmitterType = null;
39
+ // =====================================
40
+ // OPTIONAL INCLUDED ENTITIES
41
+ // =====================================
42
+ // Only populated when include query param is specified
43
+ // e.g., GET /transactions?include=sender,recipient,business
44
+ // Follows JSON:API convention for sideloaded entities
45
+ included;
37
46
  }
38
47
  __decorate([
39
48
  ApiProperty({ description: 'Transaction amount' })
@@ -150,4 +159,32 @@ __decorate([
150
159
  enum: AccountOwnerType
151
160
  })
152
161
  ], TransactionDTO.prototype, "authorizedSubmitterType", void 0);
162
+ __decorate([
163
+ ApiProperty({
164
+ description: 'Included related entities. Only populated when include parameter is specified. Contains sender, recipient, and/or engaged business entities based on requested relations.',
165
+ required: false,
166
+ nullable: true,
167
+ type: 'object',
168
+ properties: {
169
+ sender: {
170
+ description: 'Included sender entity (User or Business)',
171
+ oneOf: [
172
+ { $ref: getSchemaPath(UserDTO) },
173
+ { $ref: getSchemaPath(BusinessDTO) }
174
+ ]
175
+ },
176
+ recipient: {
177
+ description: 'Included recipient entity (User or Business)',
178
+ oneOf: [
179
+ { $ref: getSchemaPath(UserDTO) },
180
+ { $ref: getSchemaPath(BusinessDTO) }
181
+ ]
182
+ },
183
+ engagedBusiness: {
184
+ description: 'Included engaged business entity',
185
+ $ref: getSchemaPath(BusinessDTO)
186
+ }
187
+ }
188
+ })
189
+ ], TransactionDTO.prototype, "included", void 0);
153
190
  //# sourceMappingURL=transaction.dto.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"transaction.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/transaction/transaction.dto.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"transaction.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/transaction/transaction.dto.ts"],"names":[],"mappings":"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"}
@@ -7,4 +7,5 @@ export * from './domains';
7
7
  export * from './query-specification.types';
8
8
  export * from './transaction-filters.type';
9
9
  export * from './includable-relation.type';
10
+ export * from './transaction-include-relation.type';
10
11
  //# sourceMappingURL=index.d.ts.map
@@ -1 +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"}
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;AAC3C,cAAc,qCAAqC,CAAC"}
@@ -8,4 +8,5 @@ export * from './domains.js';
8
8
  export * from './query-specification.types.js';
9
9
  export * from './transaction-filters.type.js';
10
10
  export * from './includable-relation.type.js';
11
+ export * from './transaction-include-relation.type.js';
11
12
  //# sourceMappingURL=index.js.map
@@ -1 +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"}
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;AAC3C,cAAc,qCAAqC,CAAC"}
@@ -0,0 +1,29 @@
1
+ /**
2
+ * TRANSACTION INCLUDE RELATION TYPE
3
+ *
4
+ * Type-safe relations for optional enrichment in transaction queries.
5
+ * Prevents typos and provides IDE autocomplete.
6
+ *
7
+ * Usage:
8
+ * ```
9
+ * GET /transactions?include=sender,recipient,business
10
+ *
11
+ * include: ['sender', 'recipient'] // ✅ Type-safe
12
+ * include: ['snder'] // ❌ Compile error
13
+ * ```
14
+ *
15
+ * Relations:
16
+ * - sender: Enriches transaction sender (polymorphic: UserDTO | BusinessDTO)
17
+ * - recipient: Enriches transaction recipient (polymorphic: UserDTO | BusinessDTO)
18
+ * - business: Enriches engaged business (BusinessDTO)
19
+ */
20
+ export type TransactionIncludeRelation = 'sender' | 'recipient' | 'business';
21
+ /**
22
+ * Valid transaction relations for runtime validation
23
+ */
24
+ export declare const VALID_TRANSACTION_RELATIONS: readonly TransactionIncludeRelation[];
25
+ /**
26
+ * Type guard to validate relation strings at runtime
27
+ */
28
+ export declare function isValidTransactionRelation(value: string): value is TransactionIncludeRelation;
29
+ //# sourceMappingURL=transaction-include-relation.type.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Valid transaction relations for runtime validation
3
+ */
4
+ export const VALID_TRANSACTION_RELATIONS = [
5
+ 'sender',
6
+ 'recipient',
7
+ 'business'
8
+ ];
9
+ /**
10
+ * Type guard to validate relation strings at runtime
11
+ */
12
+ export function isValidTransactionRelation(value) {
13
+ return VALID_TRANSACTION_RELATIONS.includes(value);
14
+ }
15
+ //# sourceMappingURL=transaction-include-relation.type.js.map
@@ -0,0 +1 @@
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 CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@explorins/pers-shared",
3
- "version": "2.1.86",
3
+ "version": "2.1.88",
4
4
  "scripts": {
5
5
  "clean": "find dist -type f -delete 2>/dev/null || true",
6
6
  "build:esm": "tsc -p tsconfig.esm.json && node scripts/add-js-extensions.js",