@explorins/pers-shared 2.1.94 → 2.1.95

package/dist/cjs/shared-lib/dto/token/token-unit.dto.js

@@ -14,6 +14,17 @@ const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 const token_dto_1 = require("./token.dto");
 const decorators_1 = require("../../decorators");
+/**
+ * Token Unit - Defines what tokens to mint/transfer in a transaction
+ *
+ * A TokenUnit specifies:
+ * - Which token contract (Token) to use
+ * - Which metadata template (TokenMetadata via tokenMetadataIncrementalId) to mint
+ * - How many tokens to mint/transfer (amount)
+ *
+ * This is used in campaigns, purchases, and transactions to define
+ * the token rewards or transfers.
+ */
 class TokenUnitCreateRequestDTO {
     /**
      * @deprecated Use tokenEntityId instead. Will be removed in v3.0.0
@@ -44,7 +55,7 @@ __decorate([
 ], TokenUnitCreateRequestDTO.prototype, "tokenEntityId", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
-        description: 'token metadata incremental id for the token unit, this is used to identify the specific token metadata that should be minted ',
+        description: 'Token metadata template ID. For ERC1155: becomes on-chain tokenId. For ERC721: lookup key for template to generate unique metadata.',
     }),
     (0, decorators_1.OptionalStripNumber)(),
     (0, class_validator_1.IsNumber)(),
@@ -52,7 +63,7 @@ __decorate([
 ], TokenUnitCreateRequestDTO.prototype, "tokenMetadataIncrementalId", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Token unit amount is the amount of tokens that the user will receive when aquiring the token unit',
+        description: 'Amount of tokens to mint/transfer. For ERC721 this is typically 1, for ERC1155/ERC20 can be any quantity.',
     }),
     (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.IsNumber)(),
@@ -76,13 +87,13 @@ class TokenUnitDTO {
 exports.TokenUnitDTO = TokenUnitDTO;
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Token unit id',
+        description: 'Database UUID for this token unit',
     }),
     __metadata("design:type", String)
 ], TokenUnitDTO.prototype, "id", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'TokenDTO object',
+        description: 'The token contract this unit references',
         type: () => token_dto_1.TokenDTO
     }),
     __metadata("design:type", token_dto_1.TokenDTO)
@@ -91,13 +102,13 @@ __decorate([
     (0, swagger_1.ApiPropertyOptional)({
         type: Number,
         nullable: true,
-        description: 'token metadata incremental id for the token unit, this is used to identify the specific token metadata that should be minted ',
+        description: 'Token metadata template ID. For ERC1155: becomes on-chain tokenId. For ERC721: lookup key for template to generate unique metadata.',
     }),
     __metadata("design:type", Object)
 ], TokenUnitDTO.prototype, "tokenMetadataIncrementalId", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Token unit amount is the amount of tokens that the user will receive when aquiring the token unit',
+        description: 'Amount of tokens to mint/transfer. For ERC721 this is typically 1, for ERC1155/ERC20 can be any quantity.',
     }),
     __metadata("design:type", Number)
 ], TokenUnitDTO.prototype, "amount", void 0);

package/dist/cjs/shared-lib/dto/token/token-unit.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"token-unit.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/token/token-unit.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AACnE,qDAA+D;AAC/D,2CAAuC;AACvC,iDAAsE;AAEtE,MAAa,yBAAyB;IAElC;;OAEG;IAOH,OAAO,CAAU;IAOjB,aAAa,CAAU;IAOvB,0BAA0B,CAAU;IAOpC,MAAM,GAAW,CAAC,CAAC;IAOnB,SAAS,CAAU;CACtB;AAxCD,8DAwCC;AA7BG;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,6BAA6B;QAC1C,UAAU,EAAE,IAAI;KACnB,CAAC;IACD,IAAA,0BAAa,GAAE;IACf,IAAA,wBAAM,GAAE;;0DACQ;AAOjB;IALC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,iBAAiB;KACjC,CAAC;IACD,IAAA,0BAAa,GAAE;IACf,IAAA,wBAAM,GAAE;;gEACc;AAOvB;IALC,IAAA,6BAAmB,EAAC;QACb,WAAW,EAAE,+HAA+H;KACnJ,CAAC;IACD,IAAA,gCAAmB,GAAE;IACrB,IAAA,0BAAQ,GAAE;;6EACyB;AAOpC;IALC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,mGAAmG;KACnH,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;yDACQ;AAOnB;IALC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,mNAAmN;KACnO,CAAC;IACD,IAAA,gCAAmB,GAAE;IACrB,IAAA,0BAAQ,GAAE;;4DACQ;AAGvB,MAAa,YAAY;IAKrB,EAAE,GAAW,EAAE,CAAC;IAMhB,KAAK,GAAa,IAAI,oBAAQ,EAAE,CAAC;IAOjC,0BAA0B,GAAkB,IAAI,CAAC;IAKjD,MAAM,GAAW,CAAC,CAAC;IAOnB,SAAS,GAAkB,IAAI,CAAC;CACnC;AA/BD,oCA+BC;AA1BG;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,eAAe;KAC3B,CAAC;;wCACU;AAMhB;IAJC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,iBAAiB;QAC9B,IAAI,EAAE,GAAG,EAAE,CAAC,oBAAQ;KACnB,CAAC;8BACC,oBAAQ;2CAAkB;AAOjC;IALC,IAAA,6BAAmB,EAAC;QACb,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,+HAA+H;KACnJ,CAAC;;gEAC+C;AAKjD;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,mGAAmG;KACnH,CAAC;;4CACiB;AAOnB;IALC,IAAA,6BAAmB,EAAC;QACjB,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,mNAAmN;KACnO,CAAC;;+CAC8B"}
+{"version":3,"file":"token-unit.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/token/token-unit.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AACnE,qDAA+D;AAC/D,2CAAuC;AACvC,iDAAsE;AAEtE;;;;;;;;;;GAUG;AACH,MAAa,yBAAyB;IAElC;;OAEG;IAOH,OAAO,CAAU;IAOjB,aAAa,CAAU;IAOvB,0BAA0B,CAAU;IAOpC,MAAM,GAAW,CAAC,CAAC;IAOnB,SAAS,CAAU;CACtB;AAxCD,8DAwCC;AA7BG;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,6BAA6B;QAC1C,UAAU,EAAE,IAAI;KACnB,CAAC;IACD,IAAA,0BAAa,GAAE;IACf,IAAA,wBAAM,GAAE;;0DACQ;AAOjB;IALC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,iBAAiB;KACjC,CAAC;IACD,IAAA,0BAAa,GAAE;IACf,IAAA,wBAAM,GAAE;;gEACc;AAOvB;IALC,IAAA,6BAAmB,EAAC;QACb,WAAW,EAAE,qIAAqI;KACzJ,CAAC;IACD,IAAA,gCAAmB,GAAE;IACrB,IAAA,0BAAQ,GAAE;;6EACyB;AAOpC;IALC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,2GAA2G;KAC3H,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;yDACQ;AAOnB;IALC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,mNAAmN;KACnO,CAAC;IACD,IAAA,gCAAmB,GAAE;IACrB,IAAA,0BAAQ,GAAE;;4DACQ;AAGvB,MAAa,YAAY;IAKrB,EAAE,GAAW,EAAE,CAAC;IAMhB,KAAK,GAAa,IAAI,oBAAQ,EAAE,CAAC;IAOjC,0BAA0B,GAAkB,IAAI,CAAC;IAKjD,MAAM,GAAW,CAAC,CAAC;IAOnB,SAAS,GAAkB,IAAI,CAAC;CACnC;AA/BD,oCA+BC;AA1BG;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,mCAAmC;KAC/C,CAAC;;wCACU;AAMhB;IAJC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,yCAAyC;QACtD,IAAI,EAAE,GAAG,EAAE,CAAC,oBAAQ;KACnB,CAAC;8BACC,oBAAQ;2CAAkB;AAOjC;IALC,IAAA,6BAAmB,EAAC;QACb,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,qIAAqI;KACzJ,CAAC;;gEAC+C;AAKjD;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,2GAA2G;KAC3H,CAAC;;4CACiB;AAOnB;IALC,IAAA,6BAAmB,EAAC;QACjB,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,mNAAmN;KACnO,CAAC;;+CAC8B"}

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

@@ -1,6 +1,18 @@
 import type { ContractAbi } from "web3";
 import { TokenMetadataDTO } from "./token-metadata.dto";
 import type { NativeTokenType } from "../../types/native-token.type";
+/**
+ * Token DTO - Smart Contract Wrapper
+ *
+ * Represents a deployed smart contract on the blockchain (ERC20/ERC721/ERC1155).
+ * This is the top-level entity in the token hierarchy:
+ *
+ * Token (Contract) → TokenMetadata (Template) → On-chain Token (Minted Instance)
+ *
+ * - Token: The wrapping smart contract deployed on a specific chain
+ * - TokenMetadata: Templates/blueprints defining NFT properties (name, image, expiry)
+ * - On-chain Token: Actual minted instances identified by contractTokenId
+ */
 export declare class TokenDTO {
     id: string;
     contractAddress: string;

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

@@ -1 +1 @@
-{"version":3,"file":"token.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/token/token.dto.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGrE,qBAAa,QAAQ;IAKjB,EAAE,EAAE,MAAM,CAAM;IAKhB,eAAe,EAAE,MAAM,CAAM;IAM7B,QAAQ,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAO;IAK1C,GAAG,EAAE,WAAW,CAAM;IAKtB,OAAO,EAAE,MAAM,CAAK;IAKpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAK7B,IAAI,CAAC,EAAE,MAAM,CAAC;IAKd,MAAM,CAAC,EAAE,MAAM,CAAC;IAKhB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAKlB,QAAQ,EAAE,OAAO,CAAS;IAK1B,SAAS,EAAE,OAAO,CAAS;IAM3B,IAAI,EAAE,eAAe,CAA0B;CAClD"}
+{"version":3,"file":"token.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/token/token.dto.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGrE;;;;;;;;;;;GAWG;AACH,qBAAa,QAAQ;IAKjB,EAAE,EAAE,MAAM,CAAM;IAKhB,eAAe,EAAE,MAAM,CAAM;IAM7B,QAAQ,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAO;IAK1C,GAAG,EAAE,WAAW,CAAM;IAKtB,OAAO,EAAE,MAAM,CAAK;IAKpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAK7B,IAAI,CAAC,EAAE,MAAM,CAAC;IAKd,MAAM,CAAC,EAAE,MAAM,CAAC;IAKhB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAKlB,QAAQ,EAAE,OAAO,CAAS;IAK1B,SAAS,EAAE,OAAO,CAAS;IAM3B,IAAI,EAAE,eAAe,CAA0B;CAClD"}

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

@@ -13,6 +13,18 @@ exports.TokenDTO = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const token_metadata_dto_1 = require("./token-metadata.dto");
 const native_token_type_1 = require("../../types/native-token.type");
+/**
+ * Token DTO - Smart Contract Wrapper
+ *
+ * Represents a deployed smart contract on the blockchain (ERC20/ERC721/ERC1155).
+ * This is the top-level entity in the token hierarchy:
+ *
+ * Token (Contract) → TokenMetadata (Template) → On-chain Token (Minted Instance)
+ *
+ * - Token: The wrapping smart contract deployed on a specific chain
+ * - TokenMetadata: Templates/blueprints defining NFT properties (name, image, expiry)
+ * - On-chain Token: Actual minted instances identified by contractTokenId
+ */
 class TokenDTO {
     id = '';
     contractAddress = '';
@@ -30,19 +42,19 @@ class TokenDTO {
 exports.TokenDTO = TokenDTO;
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Id of the token',
+        description: 'Database UUID for this token contract entity',
     }),
     __metadata("design:type", String)
 ], TokenDTO.prototype, "id", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Address of the token',
+        description: 'Smart contract address deployed on the blockchain',
     }),
     __metadata("design:type", String)
 ], TokenDTO.prototype, "contractAddress", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
-        description: 'Metadata of the token, this is optional and can be null in case of Point token',
+        description: 'Token metadata templates - blueprints used when minting NFTs. Each template defines properties (name, image, expiry) and has a unique tokenMetadataIncrementalId. Null for ERC20 (Points) tokens.',
         type: () => [token_metadata_dto_1.TokenMetadataDTO]
     }),
     __metadata("design:type", Object)

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

@@ -1 +1 @@
-{"version":3,"file":"token.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/token/token.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AAEnE,6DAAwD;AAExD,qEAAiE;AAEjE,MAAa,QAAQ;IAKjB,EAAE,GAAW,EAAE,CAAC;IAKhB,eAAe,GAAW,EAAE,CAAC;IAM7B,QAAQ,GAA8B,IAAI,CAAA;IAK1C,GAAG,GAAgB,EAAE,CAAC;IAKtB,OAAO,GAAW,CAAC,CAAC;IAKpB,MAAM,GAAkB,IAAI,CAAC;IAK7B,IAAI,CAAU;IAKd,MAAM,CAAU;IAKhB,QAAQ,CAAU;IAKlB,QAAQ,GAAY,KAAK,CAAC;IAK1B,SAAS,GAAY,KAAK,CAAC;IAM3B,IAAI,GAAoB,oCAAgB,CAAC,KAAK,CAAC;CAClD;AA/DD,4BA+DC;AA1DG;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,iBAAiB;KACjC,CAAC;;oCACc;AAKhB;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,sBAAsB;KACtC,CAAC;;iDAC2B;AAM7B;IAJC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,gFAAgF;QAC7F,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,qCAAgB,CAAC;KACjC,CAAC;;0CACwC;AAK1C;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,4FAA4F;KAC5G,CAAC;;qCACoB;AAKtB;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,+DAA+D;KAC/E,CAAC;;yCACkB;AAKpB;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,yFAAyF;KACzG,CAAC;;wCAC2B;AAK7B;IAHC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,wCAAwC;KACxD,CAAC;;sCACY;AAKd;IAHC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,4EAA4E;KAC5F,CAAC;;wCACc;AAKhB;IAHC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,6FAA6F;KAC7G,CAAC;;0CACgB;AAKlB;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,iDAAiD;KACjE,CAAC;;0CACwB;AAK1B;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,6DAA6D;KAC7E,CAAC;;2CACyB;AAM3B;IAJC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,+DAA+D;QAC5E,IAAI,EAAE,oCAAgB;KACzB,CAAC;;sCAC6C"}
+{"version":3,"file":"token.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/token/token.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AAEnE,6DAAwD;AAExD,qEAAiE;AAEjE;;;;;;;;;;;GAWG;AACH,MAAa,QAAQ;IAKjB,EAAE,GAAW,EAAE,CAAC;IAKhB,eAAe,GAAW,EAAE,CAAC;IAM7B,QAAQ,GAA8B,IAAI,CAAA;IAK1C,GAAG,GAAgB,EAAE,CAAC;IAKtB,OAAO,GAAW,CAAC,CAAC;IAKpB,MAAM,GAAkB,IAAI,CAAC;IAK7B,IAAI,CAAU;IAKd,MAAM,CAAU;IAKhB,QAAQ,CAAU;IAKlB,QAAQ,GAAY,KAAK,CAAC;IAK1B,SAAS,GAAY,KAAK,CAAC;IAM3B,IAAI,GAAoB,oCAAgB,CAAC,KAAK,CAAC;CAClD;AA/DD,4BA+DC;AA1DG;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,8CAA8C;KAC9D,CAAC;;oCACc;AAKhB;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,mDAAmD;KACnE,CAAC;;iDAC2B;AAM7B;IAJC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,mMAAmM;QAChN,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,qCAAgB,CAAC;KACjC,CAAC;;0CACwC;AAK1C;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,4FAA4F;KAC5G,CAAC;;qCACoB;AAKtB;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,+DAA+D;KAC/E,CAAC;;yCACkB;AAKpB;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,yFAAyF;KACzG,CAAC;;wCAC2B;AAK7B;IAHC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,wCAAwC;KACxD,CAAC;;sCACY;AAKd;IAHC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,4EAA4E;KAC5F,CAAC;;wCACc;AAKhB;IAHC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,6FAA6F;KAC7G,CAAC;;0CACgB;AAKlB;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,iDAAiD;KACjE,CAAC;;0CACwB;AAK1B;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,6DAA6D;KAC7E,CAAC;;2CACyB;AAM3B;IAJC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,+DAA+D;QAC5E,IAAI,EAAE,oCAAgB;KACzB,CAAC;;sCAC6C"}

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

@@ -22,7 +22,7 @@ export declare class UserDTO {
     isActive: boolean;
     currentSigningAccountId: string | null;
     wallets: PublicWalletDTO[];
-    createdAt: Date;
+    createdAt: Date | null;
     updatedAt: Date | null;
 }
 export declare class PublicUserDTO {

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,CAAc;IAO7B,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;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"}

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

@@ -36,7 +36,7 @@ class UserDTO {
     isActive = true;
     currentSigningAccountId = null;
     wallets = [];
-    createdAt = new Date();
+    createdAt = null;
     updatedAt = null;
 }
 exports.UserDTO = UserDTO;
@@ -130,7 +130,7 @@ __decorate([
         description: 'Timestamp when the user was created',
         type: Date
     }),
-    __metadata("design:type", Date)
+    __metadata("design:type", Object)
 ], UserDTO.prototype, "createdAt", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({

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,9 +4,11 @@ export declare class UserStatusTypeCreateRequestDTO {
     minTokenBalance: number;
     discountPercentage: number;
     imageUrl?: 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;CACrB;AAED,qBAAa,iBAAkB,SAAQ,8BAA8B;IAIjE,EAAE,EAAE,MAAM,CAAK;IAKf,sBAAsB,EAAE,MAAM,EAAE,CAAM;CACzC"}
+{"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"}

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

@@ -19,6 +19,7 @@ class UserStatusTypeCreateRequestDTO {
     minTokenBalance = 0;
     discountPercentage = 0;
     imageUrl;
+    tags;
 }
 exports.UserStatusTypeCreateRequestDTO = UserStatusTypeCreateRequestDTO;
 __decorate([
@@ -61,9 +62,21 @@ __decorate([
     (0, class_validator_1.IsUrl)(),
     __metadata("design:type", String)
 ], UserStatusTypeCreateRequestDTO.prototype, "imageUrl", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Tags for categorization and filtering',
+        type: [String],
+        example: ['vip', 'premium', 'gold']
+    }),
+    (0, decorators_1.OptionalStrip)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], UserStatusTypeCreateRequestDTO.prototype, "tags", void 0);
 class UserStatusTypeDTO extends UserStatusTypeCreateRequestDTO {
     id = 0;
     eligibleTokenAddresses = [];
+    tags = [];
 }
 exports.UserStatusTypeDTO = UserStatusTypeDTO;
 __decorate([
@@ -78,4 +91,12 @@ __decorate([
     }),
     __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,qDAAwE;AACxE,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;CACrB;AAnCD,wEAmCC;AA7BG;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;AAGtB,MAAa,iBAAkB,SAAQ,8BAA8B;IAIjE,EAAE,GAAW,CAAC,CAAC;IAKf,sBAAsB,GAAa,EAAE,CAAC;CACzC;AAVD,8CAUC;AANG;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,qBAAqB;KACrC,CAAC;;6CACa;AAKf;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,2CAA2C;KAC3D,CAAC;;iEACoC"}
+{"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"}

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

@@ -18,6 +18,7 @@ export * from './sort-order.enum';
 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 './purchase';
 export * from './campaign';
 export { ErrorCategory } from '../errors/base/error-classification-enums';

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;AAEvC,cAAc,YAAY,CAAC;AAE3B,cAAc,YAAY,CAAC;AAG3B,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;AAE3C,cAAc,YAAY,CAAC;AAE3B,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC"}

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

@@ -36,6 +36,7 @@ __exportStar(require("./sort-order.enum"), exports);
 __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("./purchase"), exports);
 __exportStar(require("./campaign"), exports);
 // Error classification enum

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;AAEvC,6CAA2B;AAE3B,6CAA2B;AAE3B,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;AAE3C,6CAA2B;AAE3B,6CAA2B;AAE3B,4BAA4B;AAC5B,wFAA0E;AAAjE,2HAAA,aAAa,OAAA"}

package/dist/cjs/shared-lib/enum/token-validity-type.enum.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Token Validity Type Enum
+ *
+ * Defines how token expiry is calculated:
+ * - FIXED_DATE: Uses expiryDate directly as absolute expiration
+ * - DAYS_FROM_ISSUANCE: Computes expiry as issuance date + validityDuration days
+ * - HOURS_FROM_ISSUANCE: Computes expiry as issuance date + validityDuration hours
+ * - MONTHS_FROM_ISSUANCE: Computes expiry as issuance date + validityDuration months
+ * - END_OF_MONTH: Token expires at end of the month when issued
+ * - END_OF_YEAR: Token expires at end of the year when issued
+ */
+export declare const TokenValidityTypes: {
+    readonly FIXED_DATE: "fixed_date";
+    readonly DAYS_FROM_ISSUANCE: "days_from_issuance";
+    readonly HOURS_FROM_ISSUANCE: "hours_from_issuance";
+    readonly MONTHS_FROM_ISSUANCE: "months_from_issuance";
+    readonly END_OF_MONTH: "end_of_month";
+    readonly END_OF_YEAR: "end_of_year";
+};
+export type TokenValidityType = typeof TokenValidityTypes[keyof typeof TokenValidityTypes];
+export declare const TOKEN_VALIDITY_TYPE_VALUES: ("fixed_date" | "days_from_issuance" | "hours_from_issuance" | "months_from_issuance" | "end_of_month" | "end_of_year")[];
+//# sourceMappingURL=token-validity-type.enum.d.ts.map

package/dist/cjs/shared-lib/enum/token-validity-type.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-validity-type.enum.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/enum/token-validity-type.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB;;;;;;;CAOrB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,OAAO,kBAAkB,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE3F,eAAO,MAAM,0BAA0B,2HAAoC,CAAC"}

package/dist/cjs/shared-lib/enum/token-validity-type.enum.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOKEN_VALIDITY_TYPE_VALUES = exports.TokenValidityTypes = void 0;
+/**
+ * Token Validity Type Enum
+ *
+ * Defines how token expiry is calculated:
+ * - FIXED_DATE: Uses expiryDate directly as absolute expiration
+ * - DAYS_FROM_ISSUANCE: Computes expiry as issuance date + validityDuration days
+ * - HOURS_FROM_ISSUANCE: Computes expiry as issuance date + validityDuration hours
+ * - MONTHS_FROM_ISSUANCE: Computes expiry as issuance date + validityDuration months
+ * - END_OF_MONTH: Token expires at end of the month when issued
+ * - END_OF_YEAR: Token expires at end of the year when issued
+ */
+exports.TokenValidityTypes = {
+    FIXED_DATE: 'fixed_date',
+    DAYS_FROM_ISSUANCE: 'days_from_issuance',
+    HOURS_FROM_ISSUANCE: 'hours_from_issuance',
+    MONTHS_FROM_ISSUANCE: 'months_from_issuance',
+    END_OF_MONTH: 'end_of_month',
+    END_OF_YEAR: 'end_of_year',
+};
+exports.TOKEN_VALIDITY_TYPE_VALUES = Object.values(exports.TokenValidityTypes);
+//# sourceMappingURL=token-validity-type.enum.js.map

package/dist/cjs/shared-lib/enum/token-validity-type.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-validity-type.enum.js","sourceRoot":"","sources":["../../../../src/shared-lib/enum/token-validity-type.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACU,QAAA,kBAAkB,GAAG;IAC9B,UAAU,EAAE,YAAY;IACxB,kBAAkB,EAAE,oBAAoB;IACxC,mBAAmB,EAAE,qBAAqB;IAC1C,oBAAoB,EAAE,sBAAsB;IAC5C,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;CACpB,CAAC;AAIE,QAAA,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC,0BAAkB,CAAC,CAAC"}

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,mBAAmB,kBAAkB,CAAC;AAMtC,cAAc,uBAAuB,CAAC;AAGtC,mBAAmB,qBAAqB,CAAC;AACzC,OAAO,EAAE,KAAK,eAAe,EAAE,aAAa,EAAE,MAAM,qDAAqD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,mBAAmB,kBAAkB,CAAC;AAGtC,cAAc,uBAAuB,CAAC;AAGtC,mBAAmB,qBAAqB,CAAC;AACzC,OAAO,EAAE,KAAK,eAAe,EAAE,aAAa,EAAE,MAAM,qDAAqD,CAAC"}

package/dist/esm/index.js

@@ -4,8 +4,6 @@
 export * from './shared-lib/enum/index.js';
 export * from './shared-lib/interfaces/index.js';
 export * from './shared-lib/types/index.js';
-// Decorators - Validation decorators for DTO handling (Zapier/automation tool compatibility)
-// export * from './shared-lib/decorators/index.js';
 // Re-export web3 types for convenience
 export * from '@explorins/web3-types';
 export { ErrorCategory } from './shared-lib/errors/base/error-classification-enums.js';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8FAA8F;AAE9F,wBAAwB;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AAGnC,6FAA6F;AAC7F,2CAA2C;AAE3C,uCAAuC;AACvC,cAAc,uBAAuB,CAAC;AAItC,OAAO,EAAwB,aAAa,EAAE,MAAM,qDAAqD,CAAC;AAE1G,4CAA4C;AAC5C,2CAA2C;AAC3C,iFAAiF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8FAA8F;AAE9F,wBAAwB;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AAGnC,uCAAuC;AACvC,cAAc,uBAAuB,CAAC;AAItC,OAAO,EAAwB,aAAa,EAAE,MAAM,qDAAqD,CAAC;AAE1G,4CAA4C;AAC5C,2CAA2C;AAC3C,iFAAiF"}

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

@@ -4,5 +4,6 @@ export * from './campaign-claim-analytics.dto';
 export * from './campaign-claim-analytics-request.dto';
 export * from './group-by-expression.dto';
 export * from './retention-analytics.dto';
+export * from './tag-analytics.dto';
 export * from './user-ranking-analytics.dto';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/index.ts"],"names":[],"mappings":"AAEA,cAAc,sBAAsB,CAAC;AACrC,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wCAAwC,CAAC;AACvD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/index.ts"],"names":[],"mappings":"AAEA,cAAc,sBAAsB,CAAC;AACrC,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wCAAwC,CAAC;AACvD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC"}

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

@@ -4,5 +4,6 @@ export * from './campaign-claim-analytics.dto.js';
 export * from './campaign-claim-analytics-request.dto.js';
 export * from './group-by-expression.dto.js';
 export * from './retention-analytics.dto.js';
+export * from './tag-analytics.dto.js';
 export * from './user-ranking-analytics.dto.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/index.ts"],"names":[],"mappings":"AAEA,cAAc,sBAAsB,CAAC;AACrC,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wCAAwC,CAAC;AACvD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/index.ts"],"names":[],"mappings":"AAEA,cAAc,sBAAsB,CAAC;AACrC,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wCAAwC,CAAC;AACvD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC"}

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

@@ -0,0 +1,46 @@
+/**
+ * Entity types that support tags for aggregation
+ */
+export declare enum TaggableEntityType {
+    CAMPAIGN = "campaign",
+    REDEMPTION = "redemption",
+    BUSINESS = "business",
+    TOKEN_METADATA = "token_metadata",
+    USER_STATUS_TYPE = "user_status_type"
+}
+/**
+ * Request DTO for tags analytics
+ *
+ * Allows filtering by entity types to get tags from specific entities only.
+ */
+export declare class TagAnalyticsRequestDTO {
+    entityTypes?: TaggableEntityType[];
+}
+/**
+ * Usage count per entity type
+ */
+export declare class EntityTypeUsageDTO {
+    entityType: TaggableEntityType;
+    count: number;
+}
+/**
+ * Individual tag result with usage information
+ */
+export declare class TagUsageDTO {
+    tag: string;
+    count: number;
+    usageByEntityType: EntityTypeUsageDTO[];
+}
+/**
+ * Response DTO for tags analytics
+ *
+ * Returns aggregated tag usage across all requested entity types.
+ * Tags are sorted by count (descending) by default.
+ */
+export declare class TagAnalyticsResponseDTO {
+    tags: TagUsageDTO[];
+    totalTags: number;
+    totalUsage: number;
+    entityTypes: TaggableEntityType[];
+}
+//# sourceMappingURL=tag-analytics.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tag-analytics.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/tag-analytics.dto.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,cAAc,mBAAmB;IACjC,gBAAgB,qBAAqB;CACtC;AAED;;;;GAIG;AACH,qBAAa,sBAAsB;IAUjC,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAM7B,UAAU,EAAE,kBAAkB,CAA+B;IAM7D,KAAK,EAAE,MAAM,CAAK;CACnB;AAED;;GAEG;AACH,qBAAa,WAAW;IAMtB,GAAG,EAAE,MAAM,CAAM;IAMjB,KAAK,EAAE,MAAM,CAAK;IAYlB,iBAAiB,EAAE,kBAAkB,EAAE,CAAM;CAC9C;AAED;;;;;GAKG;AACH,qBAAa,uBAAuB;IAKlC,IAAI,EAAE,WAAW,EAAE,CAAM;IAMzB,SAAS,EAAE,MAAM,CAAK;IAMtB,UAAU,EAAE,MAAM,CAAK;IAUvB,WAAW,EAAE,kBAAkB,EAAE,CAAM;CACxC"}

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

@@ -0,0 +1,132 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsArray, IsEnum, IsOptional, IsString } from 'class-validator';
+/**
+ * Entity types that support tags for aggregation
+ */
+export var TaggableEntityType;
+(function (TaggableEntityType) {
+    TaggableEntityType["CAMPAIGN"] = "campaign";
+    TaggableEntityType["REDEMPTION"] = "redemption";
+    TaggableEntityType["BUSINESS"] = "business";
+    TaggableEntityType["TOKEN_METADATA"] = "token_metadata";
+    TaggableEntityType["USER_STATUS_TYPE"] = "user_status_type";
+})(TaggableEntityType || (TaggableEntityType = {}));
+/**
+ * Request DTO for tags analytics
+ *
+ * Allows filtering by entity types to get tags from specific entities only.
+ */
+export class TagAnalyticsRequestDTO {
+    entityTypes;
+}
+__decorate([
+    ApiPropertyOptional({
+        description: 'Filter tags by entity types. If empty or not provided, returns tags from all taggable entities.',
+        example: ['campaign', 'business'],
+        enum: TaggableEntityType,
+        isArray: true
+    }),
+    IsOptional(),
+    IsArray(),
+    IsEnum(TaggableEntityType, { each: true })
+], TagAnalyticsRequestDTO.prototype, "entityTypes", void 0);
+/**
+ * Usage count per entity type
+ */
+export class EntityTypeUsageDTO {
+    entityType = TaggableEntityType.CAMPAIGN;
+    count = 0;
+}
+__decorate([
+    ApiProperty({
+        description: 'The entity type',
+        enum: TaggableEntityType,
+        example: 'campaign'
+    })
+], EntityTypeUsageDTO.prototype, "entityType", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Number of entities of this type using the tag',
+        example: 8
+    })
+], EntityTypeUsageDTO.prototype, "count", void 0);
+/**
+ * Individual tag result with usage information
+ */
+export class TagUsageDTO {
+    tag = '';
+    count = 0;
+    usageByEntityType = [];
+}
+__decorate([
+    ApiProperty({
+        description: 'The normalized tag name',
+        example: 'summer-sale'
+    }),
+    IsString()
+], TagUsageDTO.prototype, "tag", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Total number of entities using this tag (across all entity types)',
+        example: 15
+    })
+], TagUsageDTO.prototype, "count", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Usage breakdown per entity type',
+        type: [EntityTypeUsageDTO],
+        example: [
+            { entityType: 'campaign', count: 8 },
+            { entityType: 'business', count: 5 },
+            { entityType: 'token_metadata', count: 2 }
+        ]
+    }),
+    IsArray()
+], TagUsageDTO.prototype, "usageByEntityType", void 0);
+/**
+ * Response DTO for tags analytics
+ *
+ * Returns aggregated tag usage across all requested entity types.
+ * Tags are sorted by count (descending) by default.
+ */
+export class TagAnalyticsResponseDTO {
+    tags = [];
+    totalTags = 0;
+    totalUsage = 0;
+    entityTypes = [];
+}
+__decorate([
+    ApiProperty({
+        description: 'List of tags with usage information',
+        type: [TagUsageDTO]
+    })
+], TagAnalyticsResponseDTO.prototype, "tags", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Total number of unique tags',
+        example: 25
+    })
+], TagAnalyticsResponseDTO.prototype, "totalTags", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Total tag usage count (sum of all tag assignments across all entities)',
+        example: 150
+    })
+], TagAnalyticsResponseDTO.prototype, "totalUsage", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Entity types included in this aggregation',
+        example: ['campaign', 'redemption', 'business', 'token_metadata', 'user_status_type'],
+        enum: TaggableEntityType,
+        isArray: true
+    }),
+    IsArray(),
+    IsEnum(TaggableEntityType, { each: true })
+], TagAnalyticsResponseDTO.prototype, "entityTypes", void 0);
+//# sourceMappingURL=tag-analytics.dto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tag-analytics.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/tag-analytics.dto.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAExE;;GAEG;AACH,MAAM,CAAN,IAAY,kBAMX;AAND,WAAY,kBAAkB;IAC5B,2CAAqB,CAAA;IACrB,+CAAyB,CAAA;IACzB,2CAAqB,CAAA;IACrB,uDAAiC,CAAA;IACjC,2DAAqC,CAAA;AACvC,CAAC,EANW,kBAAkB,KAAlB,kBAAkB,QAM7B;AAED;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IAUjC,WAAW,CAAwB;CACpC;AADC;IATC,mBAAmB,CAAC;QACnB,WAAW,EAAE,iGAAiG;QAC9G,OAAO,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;QACjC,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,IAAI;KACd,CAAC;IACD,UAAU,EAAE;IACZ,OAAO,EAAE;IACT,MAAM,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;2DACR;AAGrC;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAM7B,UAAU,GAAuB,kBAAkB,CAAC,QAAQ,CAAC;IAM7D,KAAK,GAAW,CAAC,CAAC;CACnB;AAPC;IALC,WAAW,CAAC;QACX,WAAW,EAAE,iBAAiB;QAC9B,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,UAAU;KACpB,CAAC;sDAC2D;AAM7D;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,+CAA+C;QAC5D,OAAO,EAAE,CAAC;KACX,CAAC;iDACgB;AAGpB;;GAEG;AACH,MAAM,OAAO,WAAW;IAMtB,GAAG,GAAW,EAAE,CAAC;IAMjB,KAAK,GAAW,CAAC,CAAC;IAYlB,iBAAiB,GAAyB,EAAE,CAAC;CAC9C;AAnBC;IALC,WAAW,CAAC;QACX,WAAW,EAAE,yBAAyB;QACtC,OAAO,EAAE,aAAa;KACvB,CAAC;IACD,QAAQ,EAAE;wCACM;AAMjB;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,mEAAmE;QAChF,OAAO,EAAE,EAAE;KACZ,CAAC;0CACgB;AAYlB;IAVC,WAAW,CAAC;QACX,WAAW,EAAE,iCAAiC;QAC9C,IAAI,EAAE,CAAC,kBAAkB,CAAC;QAC1B,OAAO,EAAE;YACP,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE;YACpC,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE;YACpC,EAAE,UAAU,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE;SAC3C;KACF,CAAC;IACD,OAAO,EAAE;sDACmC;AAG/C;;;;;GAKG;AACH,MAAM,OAAO,uBAAuB;IAKlC,IAAI,GAAkB,EAAE,CAAC;IAMzB,SAAS,GAAW,CAAC,CAAC;IAMtB,UAAU,GAAW,CAAC,CAAC;IAUvB,WAAW,GAAyB,EAAE,CAAC;CACxC;AAvBC;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,qCAAqC;QAClD,IAAI,EAAE,CAAC,WAAW,CAAC;KACpB,CAAC;qDACuB;AAMzB;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,6BAA6B;QAC1C,OAAO,EAAE,EAAE;KACZ,CAAC;0DACoB;AAMtB;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,wEAAwE;QACrF,OAAO,EAAE,GAAG;KACb,CAAC;2DACqB;AAUvB;IARC,WAAW,CAAC;QACX,WAAW,EAAE,2CAA2C;QACxD,OAAO,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,CAAC;QACrF,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,IAAI;KACd,CAAC;IACD,OAAO,EAAE;IACT,MAAM,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;4DACJ"}

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

@@ -25,6 +25,7 @@ export declare class BusinessDTO {
     canChargeToken: boolean;
     canManageUsers: boolean;
     canReceiveDonation: boolean;
+    tags: string[];
 }
 export declare class BusinessApiKeyDTO extends BusinessDTO {
     apiPrivateKey: string;