@explorins/pers-shared 2.1.97 → 2.1.98

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

@@ -1,5 +1,6 @@
 import { PublicWalletDTO } from "../wallet.dto";
 import { AccountTokenBalancesDTO } from "../account-token-balances.dto";
+import { UserStatusTypeDTO } from "../user-status-type.dto";
 export declare class UserDTO {
     id: string;
     email: string | null;
@@ -24,6 +25,10 @@ export declare class UserDTO {
     wallets: PublicWalletDTO[];
     createdAt: Date | null;
     updatedAt: Date | null;
+    included?: {
+        statusTypes?: UserStatusTypeDTO[];
+        tokenBalances?: AccountTokenBalancesDTO[];
+    };
 }
 export declare class PublicUserDTO {
     id: string;
@@ -31,6 +36,10 @@ export declare class PublicUserDTO {
         [key: string]: any;
     };
 }
+/**
+ * @deprecated Use UserDTO with include=balances pattern instead.
+ * Will be removed in future version.
+ */
 export declare class UserTokenBalancesDTO extends UserDTO {
     tokenBalances: AccountTokenBalancesDTO[];
 }

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

@@ -1 +1 @@
-{"version":3,"file":"user.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/user/user.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAGxE,qBAAa,OAAO;IAGhB,EAAE,EAAG,MAAM,CAAM;IAIjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAM5B,eAAe,EAAE,MAAM,CAAM;IAW7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAMhC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAM/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEjC;;OAEG;IAQH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAQ;IAQrC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAMzC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAKxC,UAAU,EAAE;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,GAAG,IAAI,CAAQ;IAOhD,aAAa,EAAE;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,GAAG,IAAI,CAAQ;IAKnD,QAAQ,EAAE,OAAO,CAAQ;IAMzB,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAO9C,OAAO,EAAE,eAAe,EAAE,CAAM;IAMhC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAQ;IAO9B,SAAS,EAAE,IAAI,GAAG,IAAI,CAAQ;CACjC;AAED,qBAAa,aAAa;IAEtB,EAAE,EAAG,MAAM,CAAM;IAKjB,aAAa,EAAE;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAM;CAC7C;AAED,qBAAa,oBAAqB,SAAQ,OAAO;IAK7C,aAAa,EAAE,uBAAuB,EAAE,CAAM;CACjD;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC"}
+{"version":3,"file":"user.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/user/user.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,qBAAa,OAAO;IAOhB,EAAE,EAAG,MAAM,CAAM;IAIjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAM5B,eAAe,EAAE,MAAM,CAAM;IAW7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAMhC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAM/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEjC;;OAEG;IAQH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAQ;IAQrC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAMzC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAKxC,UAAU,EAAE;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,GAAG,IAAI,CAAQ;IAOhD,aAAa,EAAE;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,GAAG,IAAI,CAAQ;IAKnD,QAAQ,EAAE,OAAO,CAAQ;IAMzB,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAO9C,OAAO,EAAE,eAAe,EAAE,CAAM;IAMhC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAQ;IAO9B,SAAS,EAAE,IAAI,GAAG,IAAI,CAAQ;IA0B9B,QAAQ,CAAC,EAAE;QACP,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;QAClC,aAAa,CAAC,EAAE,uBAAuB,EAAE,CAAC;KAC7C,CAAC;CACL;AAED,qBAAa,aAAa;IAEtB,EAAE,EAAG,MAAM,CAAM;IAKjB,aAAa,EAAE;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAM;CAC7C;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,OAAO;IAK7C,aAAa,EAAE,uBAAuB,EAAE,CAAM;CACjD;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC"}

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

@@ -13,7 +13,11 @@ exports.UserTokenBalancesDTO = exports.PublicUserDTO = exports.UserDTO = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const wallet_dto_1 = require("../wallet.dto");
 const account_token_balances_dto_1 = require("../account-token-balances.dto");
+const user_status_type_dto_1 = require("../user-status-type.dto");
 class UserDTO {
+    // =====================================
+    // SCALAR FIELDS
+    // =====================================
     id = '';
     // @IsDefined()
     email = null;
@@ -38,6 +42,12 @@ class UserDTO {
     wallets = [];
     createdAt = null;
     updatedAt = null;
+    // =====================================
+    // OPTIONAL INCLUDED ENTITIES
+    // =====================================
+    // Only populated when include query param is specified
+    // e.g., GET /users/me?include=status,balances
+    included;
 }
 exports.UserDTO = UserDTO;
 __decorate([
@@ -140,6 +150,27 @@ __decorate([
     }),
     __metadata("design:type", Object)
 ], UserDTO.prototype, "updatedAt", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Included related entities. Only populated when include parameter is specified.',
+        required: false,
+        nullable: true,
+        type: 'object',
+        properties: {
+            statusTypes: {
+                description: 'User status types earned based on token balances (via ?include=status)',
+                type: 'array',
+                items: { $ref: (0, swagger_1.getSchemaPath)(user_status_type_dto_1.UserStatusTypeDTO) }
+            },
+            tokenBalances: {
+                description: 'Token balances for user wallets (via ?include=balances)',
+                type: 'array',
+                items: { $ref: (0, swagger_1.getSchemaPath)(account_token_balances_dto_1.AccountTokenBalancesDTO) }
+            }
+        }
+    }),
+    __metadata("design:type", Object)
+], UserDTO.prototype, "included", void 0);
 class PublicUserDTO {
     id = '';
     publicProfile = {};
@@ -153,6 +184,10 @@ __decorate([
     (0, swagger_1.ApiProperty)({ description: 'Public profile data' }),
     __metadata("design:type", Object)
 ], PublicUserDTO.prototype, "publicProfile", void 0);
+/**
+ * @deprecated Use UserDTO with include=balances pattern instead.
+ * Will be removed in future version.
+ */
 class UserTokenBalancesDTO extends UserDTO {
     tokenBalances = [];
 }

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

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

package/dist/cjs/shared-lib/dto/user-status-type.dto.d.ts

@@ -4,11 +4,10 @@ export declare class UserStatusTypeCreateRequestDTO {
     minTokenBalance: number;
     discountPercentage: number;
     imageUrl?: string;
+    eligibleTokenAddresses?: string[];
     tags?: string[];
 }
 export declare class UserStatusTypeDTO extends UserStatusTypeCreateRequestDTO {
     id: number;
-    eligibleTokenAddresses: string[];
-    tags: string[];
 }
 //# sourceMappingURL=user-status-type.dto.d.ts.map

package/dist/cjs/shared-lib/dto/user-status-type.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-status-type.dto.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/dto/user-status-type.dto.ts"],"names":[],"mappings":"AAIA,qBAAa,8BAA8B;IAMvC,IAAI,EAAE,MAAM,CAAM;IAOlB,WAAW,CAAC,EAAE,MAAM,CAAC;IAOrB,eAAe,EAAE,MAAM,CAAK;IAO5B,kBAAkB,EAAE,MAAM,CAAK;IAO/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAUlB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,qBAAa,iBAAkB,SAAQ,8BAA8B;IAIjE,EAAE,EAAE,MAAM,CAAK;IAKf,sBAAsB,EAAE,MAAM,EAAE,CAAM;IAOtC,IAAI,EAAE,MAAM,EAAE,CAAM;CACvB"}
+{"version":3,"file":"user-status-type.dto.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/dto/user-status-type.dto.ts"],"names":[],"mappings":"AAIA,qBAAa,8BAA8B;IAMvC,IAAI,EAAE,MAAM,CAAM;IAOlB,WAAW,CAAC,EAAE,MAAM,CAAC;IAOrB,eAAe,EAAE,MAAM,CAAK;IAO5B,kBAAkB,EAAE,MAAM,CAAK;IAO/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAUlB,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAUlC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,qBAAa,iBAAkB,SAAQ,8BAA8B;IAIjE,EAAE,EAAE,MAAM,CAAK;CAClB"}

package/dist/cjs/shared-lib/dto/user-status-type.dto.js

@@ -19,6 +19,7 @@ class UserStatusTypeCreateRequestDTO {
     minTokenBalance = 0;
     discountPercentage = 0;
     imageUrl;
+    eligibleTokenAddresses;
     tags;
 }
 exports.UserStatusTypeCreateRequestDTO = UserStatusTypeCreateRequestDTO;
@@ -62,6 +63,17 @@ __decorate([
     (0, class_validator_1.IsUrl)(),
     __metadata("design:type", String)
 ], UserStatusTypeCreateRequestDTO.prototype, "imageUrl", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Eligible token contract addresses for this status type',
+        type: [String],
+        example: ['0x1234...', '0x5678...']
+    }),
+    (0, decorators_1.OptionalStrip)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], UserStatusTypeCreateRequestDTO.prototype, "eligibleTokenAddresses", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
         description: 'Tags for categorization and filtering',
@@ -75,8 +87,6 @@ __decorate([
 ], UserStatusTypeCreateRequestDTO.prototype, "tags", void 0);
 class UserStatusTypeDTO extends UserStatusTypeCreateRequestDTO {
     id = 0;
-    eligibleTokenAddresses = [];
-    tags = [];
 }
 exports.UserStatusTypeDTO = UserStatusTypeDTO;
 __decorate([
@@ -85,18 +95,4 @@ __decorate([
     }),
     __metadata("design:type", Number)
 ], UserStatusTypeDTO.prototype, "id", void 0);
-__decorate([
-    (0, swagger_1.ApiProperty)({
-        description: 'User Status Type eligible Token Addresses',
-    }),
-    __metadata("design:type", Array)
-], UserStatusTypeDTO.prototype, "eligibleTokenAddresses", void 0);
-__decorate([
-    (0, swagger_1.ApiProperty)({
-        description: 'Tags for categorization and filtering',
-        type: [String],
-        default: []
-    }),
-    __metadata("design:type", Array)
-], UserStatusTypeDTO.prototype, "tags", void 0);
 //# sourceMappingURL=user-status-type.dto.js.map

package/dist/cjs/shared-lib/dto/user-status-type.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-status-type.dto.js","sourceRoot":"","sources":["../../../../src/shared-lib/dto/user-status-type.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AACnE,qDAAiF;AACjF,8CAA8C;AAE9C,MAAa,8BAA8B;IAMvC,IAAI,GAAW,EAAE,CAAC;IAOlB,WAAW,CAAU;IAOrB,eAAe,GAAW,CAAC,CAAC;IAO5B,kBAAkB,GAAW,CAAC,CAAC;IAO/B,QAAQ,CAAU;IAUlB,IAAI,CAAY;CACnB;AA7CD,wEA6CC;AAvCG;IALC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,uBAAuB;KACvC,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;4DACO;AAOlB;IALC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,8BAA8B;KAC9C,CAAC;IACD,IAAA,0BAAa,GAAE;IACf,IAAA,0BAAQ,GAAE;;mEACU;AAOrB;IALC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,2CAA2C;KAC3D,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;uEACiB;AAO5B;IALC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,8CAA8C;KAC9D,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;0EACoB;AAO/B;IALC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,4BAA4B;KAC5C,CAAC;IACD,IAAA,0BAAa,GAAE;IACf,IAAA,uBAAK,GAAE;;gEACU;AAUlB;IARC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,uCAAuC;QACpD,IAAI,EAAE,CAAC,MAAM,CAAC;QACd,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC;KACtC,CAAC;IACD,IAAA,0BAAa,GAAE;IACf,IAAA,yBAAO,GAAE;IACT,IAAA,0BAAQ,EAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;;4DACT;AAGpB,MAAa,iBAAkB,SAAQ,8BAA8B;IAIjE,EAAE,GAAW,CAAC,CAAC;IAKf,sBAAsB,GAAa,EAAE,CAAC;IAOtC,IAAI,GAAa,EAAE,CAAC;CACvB;AAjBD,8CAiBC;AAbG;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,qBAAqB;KACrC,CAAC;;6CACa;AAKf;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,2CAA2C;KAC3D,CAAC;;iEACoC;AAOtC;IALC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,uCAAuC;QACpD,IAAI,EAAE,CAAC,MAAM,CAAC;QACd,OAAO,EAAE,EAAE;KACd,CAAC;;+CACkB"}
+{"version":3,"file":"user-status-type.dto.js","sourceRoot":"","sources":["../../../../src/shared-lib/dto/user-status-type.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AACnE,qDAAiF;AACjF,8CAA8C;AAE9C,MAAa,8BAA8B;IAMvC,IAAI,GAAW,EAAE,CAAC;IAOlB,WAAW,CAAU;IAOrB,eAAe,GAAW,CAAC,CAAC;IAO5B,kBAAkB,GAAW,CAAC,CAAC;IAO/B,QAAQ,CAAU;IAUlB,sBAAsB,CAAY;IAUlC,IAAI,CAAY;CACnB;AAvDD,wEAuDC;AAjDG;IALC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,uBAAuB;KACvC,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;4DACO;AAOlB;IALC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,8BAA8B;KAC9C,CAAC;IACD,IAAA,0BAAa,GAAE;IACf,IAAA,0BAAQ,GAAE;;mEACU;AAOrB;IALC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,2CAA2C;KAC3D,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;uEACiB;AAO5B;IALC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,8CAA8C;KAC9D,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;0EACoB;AAO/B;IALC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,4BAA4B;KAC5C,CAAC;IACD,IAAA,0BAAa,GAAE;IACf,IAAA,uBAAK,GAAE;;gEACU;AAUlB;IARC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,wDAAwD;QACrE,IAAI,EAAE,CAAC,MAAM,CAAC;QACd,OAAO,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;KACtC,CAAC;IACD,IAAA,0BAAa,GAAE;IACf,IAAA,yBAAO,GAAE;IACT,IAAA,0BAAQ,EAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;;8EACS;AAUlC;IARC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,uCAAuC;QACpD,IAAI,EAAE,CAAC,MAAM,CAAC;QACd,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC;KACtC,CAAC;IACD,IAAA,0BAAa,GAAE;IACf,IAAA,yBAAO,GAAE;IACT,IAAA,0BAAQ,EAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;;4DACT;AAGpB,MAAa,iBAAkB,SAAQ,8BAA8B;IAIjE,EAAE,GAAW,CAAC,CAAC;CAClB;AALD,8CAKC;AADG;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,qBAAqB;KACrC,CAAC;;6CACa"}

package/dist/cjs/shared-lib/enum/balance-migration-type.enum.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Balance Migration Type
+ *
+ * Defines how token balances should be migrated between accounts.
+ * Used during user merge operations and account balance transfers.
+ */
+export declare enum BalanceMigrationType {
+    /** Replace: New balance = from balance - to balance (diff only) */
+    REPLACE = "replace",
+    /** Merge: New balance = from balance (full transfer) */
+    MERGE = "merge"
+}
+//# sourceMappingURL=balance-migration-type.enum.d.ts.map

package/dist/cjs/shared-lib/enum/balance-migration-type.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance-migration-type.enum.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/enum/balance-migration-type.enum.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oBAAY,oBAAoB;IAC5B,mEAAmE;IACnE,OAAO,YAAY;IACnB,wDAAwD;IACxD,KAAK,UAAU;CAClB"}

package/dist/cjs/shared-lib/enum/balance-migration-type.enum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BalanceMigrationType = void 0;
+/**
+ * Balance Migration Type
+ *
+ * Defines how token balances should be migrated between accounts.
+ * Used during user merge operations and account balance transfers.
+ */
+var BalanceMigrationType;
+(function (BalanceMigrationType) {
+    /** Replace: New balance = from balance - to balance (diff only) */
+    BalanceMigrationType["REPLACE"] = "replace";
+    /** Merge: New balance = from balance (full transfer) */
+    BalanceMigrationType["MERGE"] = "merge";
+})(BalanceMigrationType || (exports.BalanceMigrationType = BalanceMigrationType = {}));
+//# sourceMappingURL=balance-migration-type.enum.js.map

package/dist/cjs/shared-lib/enum/balance-migration-type.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance-migration-type.enum.js","sourceRoot":"","sources":["../../../../src/shared-lib/enum/balance-migration-type.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC5B,mEAAmE;IACnE,2CAAmB,CAAA;IACnB,wDAAwD;IACxD,uCAAe,CAAA;AACnB,CAAC,EALW,oBAAoB,oCAApB,oBAAoB,QAK/B"}

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

@@ -19,6 +19,7 @@ export * from './process-record-status.enum';
 export * from './file-upload-entity-type.enum';
 export * from './signed-url-type.enum';
 export * from './token-validity-type.enum';
+export * from './balance-migration-type.enum';
 export * from './purchase';
 export * from './campaign';
 export * from './ai-operation-type.enum';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/enum/index.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC;AACxD,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,YAAY,CAAC;AAE3B,cAAc,YAAY,CAAC;AAE3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAG3C,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/enum/index.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC;AACxD,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAE9C,cAAc,YAAY,CAAC;AAE3B,cAAc,YAAY,CAAC;AAE3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAG3C,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC"}

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

@@ -37,6 +37,7 @@ __exportStar(require("./process-record-status.enum"), exports);
 __exportStar(require("./file-upload-entity-type.enum"), exports);
 __exportStar(require("./signed-url-type.enum"), exports);
 __exportStar(require("./token-validity-type.enum"), exports);
+__exportStar(require("./balance-migration-type.enum"), exports);
 __exportStar(require("./purchase"), exports);
 __exportStar(require("./campaign"), exports);
 __exportStar(require("./ai-operation-type.enum"), exports);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/enum/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,wCAAwC;AACxC,0DAAwC;AACxC,0DAAwC;AACxC,4DAA0C;AAC1C,0EAAwD;AACxD,sDAAoC;AACpC,oDAAkC;AAClC,yDAAuC;AACvC,4DAA0C;AAC1C,oDAAkC;AAClC,qDAAmC;AACnC,yDAAuC;AACvC,iEAA+C;AAC/C,kEAAgD;AAChD,gEAA8C;AAC9C,gDAA8B;AAC9B,gDAA8B;AAC9B,oDAAkC;AAClC,+DAA6C;AAC7C,iEAA+C;AAC/C,yDAAuC;AACvC,6DAA2C;AAE3C,6CAA2B;AAE3B,6CAA2B;AAE3B,2DAAyC;AACzC,iEAA+C;AAC/C,6DAA2C;AAE3C,4BAA4B;AAC5B,wFAA0E;AAAjE,2HAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/enum/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,wCAAwC;AACxC,0DAAwC;AACxC,0DAAwC;AACxC,4DAA0C;AAC1C,0EAAwD;AACxD,sDAAoC;AACpC,oDAAkC;AAClC,yDAAuC;AACvC,4DAA0C;AAC1C,oDAAkC;AAClC,qDAAmC;AACnC,yDAAuC;AACvC,iEAA+C;AAC/C,kEAAgD;AAChD,gEAA8C;AAC9C,gDAA8B;AAC9B,gDAA8B;AAC9B,oDAAkC;AAClC,+DAA6C;AAC7C,iEAA+C;AAC/C,yDAAuC;AACvC,6DAA2C;AAC3C,gEAA8C;AAE9C,6CAA2B;AAE3B,6CAA2B;AAE3B,2DAAyC;AACzC,iEAA+C;AAC/C,6DAA2C;AAE3C,4BAA4B;AAC5B,wFAA0E;AAAjE,2HAAA,aAAa,OAAA"}

package/dist/cjs/shared-lib/interfaces/balance-filter-options.interface.d.ts

@@ -0,0 +1,43 @@
+import { NativeTokenType } from '../types/native-token.type';
+/**
+ * Filter options for retrieving token balances.
+ * Provides flexible filtering by token type, tags, contract addresses, and expiry status.
+ */
+export interface BalanceFilterOptions {
+    /** Only return balances for active tokens (default: true) */
+    activeOnly?: boolean;
+    /** Filter out tokens that have expired based on metadata expiry_date attribute */
+    excludeExpired?: boolean;
+    /**
+     * Filter by token types.
+     * - If not specified (undefined), no type filtering is applied
+     * - Set to null to explicitly disable type filtering
+     * - Provide specific types like ['ERC721', 'ERC1155'] to filter by type
+     *
+     * Note: When tokenTypes is null and includeContractAddresses is set,
+     * ONLY the specified contract addresses will be returned (exclusive filter).
+     */
+    tokenTypes?: NativeTokenType[] | null;
+    /**
+     * Filter by tags from on-chain metadata (IPFS).
+     * Applied AFTER fetching balances - filters by each token's IPFS metadata tags.
+     * - If not specified or empty, includes all tokens regardless of tags
+     * - If specified, only returns tokens that have at least one matching tag
+     *
+     * Note: This adds network calls to fetch metadata from IPFS for each token with balance.
+     */
+    tags?: string[];
+    /**
+     * Contract addresses to include in the results.
+     *
+     * Behavior depends on tokenTypes:
+     * - If tokenTypes is null: Acts as EXCLUSIVE filter - ONLY these addresses are returned
+     * - If tokenTypes has values: These addresses are ALWAYS included IN ADDITION to tokenTypes filter
+     *
+     * This allows two usage patterns:
+     * 1. Exclusive: { tokenTypes: null, includeContractAddresses: ['0x...'] } - Only specific contracts
+     * 2. Additive: { tokenTypes: ['ERC721'], includeContractAddresses: ['0x...'] } - ERC721 + specific contracts
+     */
+    includeContractAddresses?: string[];
+}
+//# sourceMappingURL=balance-filter-options.interface.d.ts.map

package/dist/cjs/shared-lib/interfaces/balance-filter-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance-filter-options.interface.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/balance-filter-options.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACjC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kFAAkF;IAClF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IACtC;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;;;;;;;;OAUG;IACH,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;CACvC"}

package/dist/cjs/shared-lib/interfaces/balance-filter-options.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=balance-filter-options.interface.js.map

package/dist/cjs/shared-lib/interfaces/balance-filter-options.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance-filter-options.interface.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/balance-filter-options.interface.ts"],"names":[],"mappings":""}

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

@@ -18,4 +18,5 @@ export * from './transaction.interface';
 export * from './counterfactual-wallet-response.interface';
 export * from './campaign';
 export * from './ai-prompt-config.interface';
+export * from './balance-filter-options.interface';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,kCAAkC,CAAC;AAEjD,cAAc,yBAAyB,CAAC;AAExC,cAAc,4CAA4C,CAAC;AAE3D,cAAc,YAAY,CAAC;AAE3B,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,kCAAkC,CAAC;AAEjD,cAAc,yBAAyB,CAAC;AAExC,cAAc,4CAA4C,CAAC;AAE3D,cAAc,YAAY,CAAC;AAE3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC"}

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

@@ -35,4 +35,5 @@ __exportStar(require("./transaction.interface"), exports);
 __exportStar(require("./counterfactual-wallet-response.interface"), exports);
 __exportStar(require("./campaign"), exports);
 __exportStar(require("./ai-prompt-config.interface"), exports);
+__exportStar(require("./balance-filter-options.interface"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAkD;AAClD,mEAAiD;AACjD,uEAAqD;AACrD,iEAA+C;AAC/C,iEAA+C;AAC/C,0DAAwC;AACxC,+DAA6C;AAC7C,2EAAyD;AACzD,iEAA+C;AAC/C,qDAAmC;AACnC,gEAA8C;AAC9C,kEAAgD;AAChD,sEAAoD;AACpD,8DAA4C;AAC5C,kEAAgD;AAChD,4EAA0D;AAC1D,mEAAiD;AAEjD,0DAAwC;AAExC,6EAA2D;AAE3D,6CAA2B;AAE3B,+DAA6C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAkD;AAClD,mEAAiD;AACjD,uEAAqD;AACrD,iEAA+C;AAC/C,iEAA+C;AAC/C,0DAAwC;AACxC,+DAA6C;AAC7C,2EAAyD;AACzD,iEAA+C;AAC/C,qDAAmC;AACnC,gEAA8C;AAC9C,kEAAgD;AAChD,sEAAoD;AACpD,8DAA4C;AAC5C,kEAAgD;AAChD,4EAA0D;AAC1D,mEAAiD;AAEjD,0DAAwC;AAExC,6EAA2D;AAE3D,6CAA2B;AAE3B,+DAA6C;AAC7C,qEAAmD"}

package/dist/cjs/shared-lib/interfaces/token-storage-data.interface.d.ts

@@ -15,6 +15,10 @@ export interface TokenStorageDataAttribute {
 export declare enum TokenStorageDataAttributesType {
     EXPIRY_DATE = "expiry_date",
     CREATOR_ACCOUNT_ADDRESS = "creator_account_address",
-    PREVIEW_URL = "preview_url"
+    PREVIEW_URL = "preview_url",
+    TAGS = "tags",
+    VALIDITY_TYPE = "validity_type",
+    VALIDITY_DURATION = "validity_duration",
+    TIMESTAMP = "timestamp"
 }
 //# sourceMappingURL=token-storage-data.interface.d.ts.map

package/dist/cjs/shared-lib/interfaces/token-storage-data.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-storage-data.interface.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/token-storage-data.interface.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,oBAAY,8BAA8B;IACtC,WAAW,gBAAgB;IAC3B,uBAAuB,4BAA4B;IACnD,WAAW,gBAAgB;CAC9B"}
+{"version":3,"file":"token-storage-data.interface.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/token-storage-data.interface.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,oBAAY,8BAA8B;IACtC,WAAW,gBAAgB;IAC3B,uBAAuB,4BAA4B;IACnD,WAAW,gBAAgB;IAC3B,IAAI,SAAS;IACb,aAAa,kBAAkB;IAC/B,iBAAiB,sBAAsB;IACvC,SAAS,cAAc;CAC1B"}

package/dist/cjs/shared-lib/interfaces/token-storage-data.interface.js

@@ -6,5 +6,9 @@ var TokenStorageDataAttributesType;
     TokenStorageDataAttributesType["EXPIRY_DATE"] = "expiry_date";
     TokenStorageDataAttributesType["CREATOR_ACCOUNT_ADDRESS"] = "creator_account_address";
     TokenStorageDataAttributesType["PREVIEW_URL"] = "preview_url";
+    TokenStorageDataAttributesType["TAGS"] = "tags";
+    TokenStorageDataAttributesType["VALIDITY_TYPE"] = "validity_type";
+    TokenStorageDataAttributesType["VALIDITY_DURATION"] = "validity_duration";
+    TokenStorageDataAttributesType["TIMESTAMP"] = "timestamp";
 })(TokenStorageDataAttributesType || (exports.TokenStorageDataAttributesType = TokenStorageDataAttributesType = {}));
 //# sourceMappingURL=token-storage-data.interface.js.map

package/dist/cjs/shared-lib/interfaces/token-storage-data.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"token-storage-data.interface.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/token-storage-data.interface.ts"],"names":[],"mappings":";;;AAiBA,IAAY,8BAIX;AAJD,WAAY,8BAA8B;IACtC,6DAA2B,CAAA;IAC3B,qFAAmD,CAAA;IACnD,6DAA2B,CAAA;AAC/B,CAAC,EAJW,8BAA8B,8CAA9B,8BAA8B,QAIzC"}
+{"version":3,"file":"token-storage-data.interface.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/token-storage-data.interface.ts"],"names":[],"mappings":";;;AAiBA,IAAY,8BAQX;AARD,WAAY,8BAA8B;IACtC,6DAA2B,CAAA;IAC3B,qFAAmD,CAAA;IACnD,6DAA2B,CAAA;IAC3B,+CAAa,CAAA;IACb,iEAA+B,CAAA;IAC/B,yEAAuC,CAAA;IACvC,yDAAuB,CAAA;AAC3B,CAAC,EARW,8BAA8B,8CAA9B,8BAA8B,QAQzC"}

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

@@ -12,4 +12,5 @@ export * from './campaign-include-relation.type';
 export * from './campaign-claim-include-relation.type';
 export * from './redemption-redeem-include-relation.type';
 export * from './business-membership-include-relation.type';
+export * from './user-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;AAC3C,cAAc,qCAAqC,CAAC;AACpD,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,6CAA6C,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;AACpD,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,8BAA8B,CAAC"}

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

@@ -29,4 +29,5 @@ __exportStar(require("./campaign-include-relation.type"), exports);
 __exportStar(require("./campaign-claim-include-relation.type"), exports);
 __exportStar(require("./redemption-redeem-include-relation.type"), exports);
 __exportStar(require("./business-membership-include-relation.type"), exports);
+__exportStar(require("./user-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;AAC3C,sEAAoD;AACpD,mEAAiD;AACjD,yEAAuD;AACvD,4EAA0D;AAC1D,8EAA4D"}
+{"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;AACpD,mEAAiD;AACjD,yEAAuD;AACvD,4EAA0D;AAC1D,8EAA4D;AAC5D,+DAA6C"}

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

@@ -0,0 +1,11 @@
+/**
+ * Valid include relations for User endpoints.
+ * These relations can be requested via ?include=status,balances query parameter.
+ */
+export declare const VALID_USER_RELATIONS: readonly ["status", "balances"];
+export type UserIncludeRelation = typeof VALID_USER_RELATIONS[number];
+/**
+ * Type guard to check if a string is a valid UserIncludeRelation
+ */
+export declare function isValidUserRelation(value: string): value is UserIncludeRelation;
+//# sourceMappingURL=user-include-relation.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"user-include-relation.type.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/types/user-include-relation.type.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,iCAAkC,CAAC;AAEpE,MAAM,MAAM,mBAAmB,GAAG,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAEtE;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,mBAAmB,CAE/E"}

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

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_USER_RELATIONS = void 0;
+exports.isValidUserRelation = isValidUserRelation;
+/**
+ * Valid include relations for User endpoints.
+ * These relations can be requested via ?include=status,balances query parameter.
+ */
+exports.VALID_USER_RELATIONS = ['status', 'balances'];
+/**
+ * Type guard to check if a string is a valid UserIncludeRelation
+ */
+function isValidUserRelation(value) {
+    return exports.VALID_USER_RELATIONS.includes(value);
+}
+//# sourceMappingURL=user-include-relation.type.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"user-include-relation.type.js","sourceRoot":"","sources":["../../../../src/shared-lib/types/user-include-relation.type.ts"],"names":[],"mappings":";;;AAWA,kDAEC;AAbD;;;GAGG;AACU,QAAA,oBAAoB,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAU,CAAC;AAIpE;;GAEG;AACH,SAAgB,mBAAmB,CAAC,KAAa;IAC7C,OAAO,4BAAoB,CAAC,QAAQ,CAAC,KAA4B,CAAC,CAAC;AACvE,CAAC"}

package/dist/cjs/shared-lib/value-objects/token-balance.value-object.d.ts

@@ -12,6 +12,7 @@ export declare class TokenBalance {
     private readonly tokenName;
     private readonly tokenSymbol;
     private readonly tokenType;
+    private readonly expiryDate;
     /**
      * Constructs a new TokenBalance value object.
      *
@@ -23,8 +24,10 @@ export declare class TokenBalance {
      * @param {string} tokenName - The name of the token.
      * @param {string} tokenSymbol - The symbol of the token.
      * @param {NativeTokenType} tokenType - The type of the token (e.g., ERC20, ERC721).
+     * @param {Date | null} expiryDate - The expiry date of the token (optional).
      */
-    constructor(chainId: number, smartContractAddress: Address, tokenId: string | null | undefined, metadataUri: string | null | undefined, balance: number, tokenName: string, tokenSymbol: string, tokenType: NativeTokenType);
+    constructor(chainId: number, smartContractAddress: Address, tokenId: string | null | undefined, metadataUri: string | null | undefined, balance: number, tokenName: string, tokenSymbol: string, tokenType: NativeTokenType, // = NativeTokenType.ERC20 // Default value set to ERC20
+    expiryDate?: Date | null);
     /**
      * Gets the chain ID.
      *
@@ -73,6 +76,20 @@ export declare class TokenBalance {
      * @returns {NativeTokenType} The type of the token (e.g., ERC20, ERC721).
      */
     getTokenType(): NativeTokenType;
+    /**
+     * Gets the expiry date of the token.
+     *
+     * @returns {Date | null} The expiry date (or null if no expiry).
+     */
+    getExpiryDate(): Date | null;
+    /**
+     * Checks if the token has expired.
+     * Uses shared isTokenExpired helper for consistent date comparison logic.
+     *
+     * @returns {boolean} True if the token has an expiry date and it has passed.
+     *                    Returns false if no expiry date (never expires).
+     */
+    isExpired(): boolean;
     /**
      * Returns a string representation of the TokenBalance.
      *

package/dist/cjs/shared-lib/value-objects/token-balance.value-object.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-balance.value-object.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/token-balance.value-object.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD;;GAEG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAE5C;;;;;;;;;;;OAWG;gBAEC,OAAO,EAAE,MAAM,EACf,oBAAoB,EAAE,OAAO,EAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,YAAO,EAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,YAAO,EACjC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,eAAe;IAa9B;;;;OAIG;IACI,UAAU,IAAI,MAAM;IAI3B;;;;OAIG;IACI,uBAAuB,IAAI,OAAO;IAIzC;;;;OAIG;IACI,UAAU,IAAI,MAAM,GAAG,IAAI;IAIlC;;;;OAIG;IACI,cAAc,IAAI,MAAM,GAAG,IAAI;IAItC;;;;OAIG;IACI,UAAU,IAAI,MAAM;IAI3B;;;;OAIG;IACI,YAAY,IAAI,MAAM;IAI7B;;;;OAIG;IACI,cAAc,IAAI,MAAM;IAI/B;;;;OAIG;IACI,YAAY,IAAI,eAAe;IAItC;;;;OAIG;IACI,QAAQ,IAAI,MAAM;IAIzB;;;;;OAKG;IACI,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;CAS9C"}
+{"version":3,"file":"token-balance.value-object.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/token-balance.value-object.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGjD;;GAEG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IAEzC;;;;;;;;;;;;OAYG;gBAEC,OAAO,EAAE,MAAM,EACf,oBAAoB,EAAE,OAAO,EAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,YAAO,EAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,YAAO,EACjC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,eAAe,EAAE,wDAAwD;IACpF,UAAU,GAAE,IAAI,GAAG,IAAW;IAalC;;;;OAIG;IACI,UAAU,IAAI,MAAM;IAI3B;;;;OAIG;IACI,uBAAuB,IAAI,OAAO;IAIzC;;;;OAIG;IACI,UAAU,IAAI,MAAM,GAAG,IAAI;IAIlC;;;;OAIG;IACI,cAAc,IAAI,MAAM,GAAG,IAAI;IAItC;;;;OAIG;IACI,UAAU,IAAI,MAAM;IAI3B;;;;OAIG;IACI,YAAY,IAAI,MAAM;IAI7B;;;;OAIG;IACI,cAAc,IAAI,MAAM;IAI/B;;;;OAIG;IACI,YAAY,IAAI,eAAe;IAItC;;;;OAIG;IACI,aAAa,IAAI,IAAI,GAAG,IAAI;IAInC;;;;;;OAMG;IACI,SAAS,IAAI,OAAO;IAI3B;;;;OAIG;IACI,QAAQ,IAAI,MAAM;IAIzB;;;;;OAKG;IACI,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;CAS9C"}

package/dist/cjs/shared-lib/value-objects/token-balance.value-object.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TokenBalance = void 0;
+const helper_functions_1 = require("../../shared-patterns/functions/helper.functions");
 /**
  * Value object representing the token balance details.
  */
@@ -13,6 +14,7 @@ class TokenBalance {
     tokenName;
     tokenSymbol;
     tokenType;
+    expiryDate;
     /**
      * Constructs a new TokenBalance value object.
      *
@@ -24,9 +26,10 @@ class TokenBalance {
      * @param {string} tokenName - The name of the token.
      * @param {string} tokenSymbol - The symbol of the token.
      * @param {NativeTokenType} tokenType - The type of the token (e.g., ERC20, ERC721).
+     * @param {Date | null} expiryDate - The expiry date of the token (optional).
      */
-    constructor(chainId, smartContractAddress, tokenId = null, metadataUri = null, balance, tokenName, tokenSymbol, tokenType // = NativeTokenType.ERC20 // Default value set to ERC20
-    ) {
+    constructor(chainId, smartContractAddress, tokenId = null, metadataUri = null, balance, tokenName, tokenSymbol, tokenType, // = NativeTokenType.ERC20 // Default value set to ERC20
+    expiryDate = null) {
         this.chainId = chainId;
         this.smartContractAddress = smartContractAddress;
         this.tokenId = tokenId;
@@ -35,6 +38,7 @@ class TokenBalance {
         this.tokenName = tokenName;
         this.tokenSymbol = tokenSymbol;
         this.tokenType = tokenType;
+        this.expiryDate = expiryDate;
     }
     /**
      * Gets the chain ID.
@@ -100,6 +104,24 @@ class TokenBalance {
     getTokenType() {
         return this.tokenType;
     }
+    /**
+     * Gets the expiry date of the token.
+     *
+     * @returns {Date | null} The expiry date (or null if no expiry).
+     */
+    getExpiryDate() {
+        return this.expiryDate;
+    }
+    /**
+     * Checks if the token has expired.
+     * Uses shared isTokenExpired helper for consistent date comparison logic.
+     *
+     * @returns {boolean} True if the token has an expiry date and it has passed.
+     *                    Returns false if no expiry date (never expires).
+     */
+    isExpired() {
+        return (0, helper_functions_1.isTokenExpired)(this.expiryDate) ?? false;
+    }
     /**
      * Returns a string representation of the TokenBalance.
      *

package/dist/cjs/shared-lib/value-objects/token-balance.value-object.js.map

@@ -1 +1 @@
-{"version":3,"file":"token-balance.value-object.js","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/token-balance.value-object.ts"],"names":[],"mappings":";;;AAIA;;GAEG;AACH,MAAa,YAAY;IACJ,OAAO,CAAS;IAChB,oBAAoB,CAAU;IAC9B,OAAO,CAAgB;IACvB,WAAW,CAAgB;IAC3B,OAAO,CAAS;IAChB,SAAS,CAAS;IAClB,WAAW,CAAS;IACpB,SAAS,CAAkB;IAE5C;;;;;;;;;;;OAWG;IACH,YACI,OAAe,EACf,oBAA6B,EAC7B,UAAyB,IAAI,EAC7B,cAA6B,IAAI,EACjC,OAAe,EACf,SAAiB,EACjB,WAAmB,EACnB,SAA0B,CAAC,wDAAwD;;QAGnF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACI,UAAU;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACI,uBAAuB;QAC1B,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACI,UAAU;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACI,cAAc;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACI,UAAU;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACI,YAAY;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACI,cAAc;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACI,YAAY;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACI,QAAQ;QACX,OAAO,2BAA2B,IAAI,CAAC,OAAO,oBAAoB,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,cAAc,IAAI,CAAC,OAAO,cAAc,IAAI,CAAC,OAAO,gBAAgB,IAAI,CAAC,SAAS,kBAAkB,IAAI,CAAC,WAAW,gBAAgB,IAAI,CAAC,SAAS,GAAG,CAAC;IAChQ,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,KAAmB;QAC7B,OAAO,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,UAAU,EAAE;YACtC,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,CAAC;YACjE,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,UAAU,EAAE;YACnC,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,UAAU,EAAE;YACnC,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,YAAY,EAAE;YACvC,IAAI,CAAC,WAAW,KAAK,KAAK,CAAC,cAAc,EAAE;YAC3C,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC;IAChD,CAAC;CACJ;AA3ID,oCA2IC"}
+{"version":3,"file":"token-balance.value-object.js","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/token-balance.value-object.ts"],"names":[],"mappings":"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"}