@explorins/pers-shared 2.1.97 → 2.1.98

package/dist/esm/shared-lib/errors/base-business-error.js

@@ -1,5 +1,5 @@
 import { HttpException, HttpStatus } from '@nestjs/common';
-import { ErrorCategory } from './base/error-classification-enums.js';
+import { ErrorCategory } from './base/error-classification-enums';
 /**
  * Base class for business logic errors that should be surfaced to clients
  * with meaningful error messages and appropriate HTTP status codes.

package/dist/esm/shared-lib/errors/domains/authentication-errors.js

@@ -1,7 +1,7 @@
 import { HttpStatus } from '@nestjs/common';
-import { BusinessLogicError, SecurityError } from '../base-business-error.js';
-import { CommonErrorCodes, ErrorDomains } from '../error-codes.js';
-import { ErrorCategory } from '../base/error-classification-enums.js';
+import { BusinessLogicError, SecurityError } from '../base-business-error';
+import { CommonErrorCodes, ErrorDomains } from '../error-codes';
+import { ErrorCategory } from '../base/error-classification-enums';
 /**
  * Authentication domain business errors
  */

package/dist/esm/shared-lib/errors/domains/balance-errors.js

@@ -1,6 +1,6 @@
 import { HttpStatus } from '@nestjs/common';
-import { DomainRuleError } from '../base-business-error.js';
-import { CommonErrorCodes, ErrorDomains } from '../error-codes.js';
+import { DomainRuleError } from '../base-business-error';
+import { CommonErrorCodes, ErrorDomains } from '../error-codes';
 /**
  * Balance/Account domain business errors
  */

package/dist/esm/shared-lib/errors/domains/business-errors.js

@@ -1,6 +1,6 @@
 import { HttpStatus } from '@nestjs/common';
-import { DomainRuleError, ValidationError } from '../base-business-error.js';
-import { CommonErrorCodes, ErrorDomains } from '../error-codes.js';
+import { DomainRuleError, ValidationError } from '../base-business-error';
+import { CommonErrorCodes, ErrorDomains } from '../error-codes';
 /**
  * Business domain business errors
  */

package/dist/esm/shared-lib/errors/domains/campaign-errors.js

@@ -1,6 +1,6 @@
 import { HttpStatus } from '@nestjs/common';
-import { DomainRuleError, ValidationError } from '../base-business-error.js';
-import { CommonErrorCodes, ErrorDomains } from '../error-codes.js';
+import { DomainRuleError, ValidationError } from '../base-business-error';
+import { CommonErrorCodes, ErrorDomains } from '../error-codes';
 export class CampaignUserInfoRequiredError extends DomainRuleError {
     constructor(requiredField) {
         super(CommonErrorCodes.CAMPAIGN_USER_INFO_REQUIRED, ErrorDomains.CAMPAIGN, `Campaign requires missing user info: ${requiredField}`, HttpStatus.BAD_REQUEST, 'Please complete your profile information to claim this campaign');

package/dist/esm/shared-lib/errors/domains/contract-errors.js

@@ -1,6 +1,6 @@
 import { HttpStatus } from '@nestjs/common';
-import { DomainRuleError } from '../base-business-error.js';
-import { CommonErrorCodes, ErrorDomains } from '../error-codes.js';
+import { DomainRuleError } from '../base-business-error';
+import { CommonErrorCodes, ErrorDomains } from '../error-codes';
 /**
  * Contract domain business errors
  */

package/dist/esm/shared-lib/errors/domains/signing-account-errors.js

@@ -1,6 +1,6 @@
 import { HttpStatus } from '@nestjs/common';
-import { DomainRuleError, ValidationError, TechnicalError } from '../base-business-error.js';
-import { CommonErrorCodes, ErrorDomains } from '../error-codes.js';
+import { DomainRuleError, ValidationError, TechnicalError } from '../base-business-error';
+import { CommonErrorCodes, ErrorDomains } from '../error-codes';
 /**
  * Signing Account domain business errors
  *

package/dist/esm/shared-lib/errors/domains/system-errors.js

@@ -1,6 +1,6 @@
 import { HttpStatus } from '@nestjs/common';
-import { TechnicalError, InfrastructureError } from '../base-business-error.js';
-import { CommonErrorCodes, ErrorDomains } from '../error-codes.js';
+import { TechnicalError, InfrastructureError } from '../base-business-error';
+import { CommonErrorCodes, ErrorDomains } from '../error-codes';
 /**
  * System domain business errors
  */

package/dist/esm/shared-lib/errors/domains/tenant-errors.js

@@ -1,6 +1,6 @@
 import { HttpStatus } from '@nestjs/common';
-import { BusinessLogicError } from '../base-business-error.js';
-import { CommonErrorCodes, ErrorDomains } from '../error-codes.js';
+import { BusinessLogicError } from '../base-business-error';
+import { CommonErrorCodes, ErrorDomains } from '../error-codes';
 /**
  * Tenant domain business errors
  */

package/dist/esm/shared-lib/errors/domains/token-errors.js

@@ -1,6 +1,6 @@
 import { HttpStatus } from '@nestjs/common';
-import { DomainRuleError, ValidationError } from '../base-business-error.js';
-import { CommonErrorCodes, ErrorDomains } from '../error-codes.js';
+import { DomainRuleError, ValidationError } from '../base-business-error';
+import { CommonErrorCodes, ErrorDomains } from '../error-codes';
 /**
  * Token domain business errors
  */

package/dist/esm/shared-lib/errors/domains/transaction-errors.js

@@ -1,6 +1,6 @@
 import { HttpStatus } from '@nestjs/common';
-import { ValidationError, DomainRuleError, TechnicalError } from '../base-business-error.js';
-import { CommonErrorCodes, ErrorDomains } from '../error-codes.js';
+import { ValidationError, DomainRuleError, TechnicalError } from '../base-business-error';
+import { CommonErrorCodes, ErrorDomains } from '../error-codes';
 /**
  * Transaction domain business errors
  */

package/dist/esm/shared-lib/errors/domains/trigger-source-errors.js

@@ -1,6 +1,6 @@
 import { HttpStatus } from '@nestjs/common';
-import { DomainRuleError } from '../base-business-error.js';
-import { CommonErrorCodes, ErrorDomains } from '../error-codes.js';
+import { DomainRuleError } from '../base-business-error';
+import { CommonErrorCodes, ErrorDomains } from '../error-codes';
 /**
  * Trigger Source domain errors
  */

package/dist/esm/shared-lib/errors/domains/user-errors.js

@@ -1,6 +1,6 @@
 import { HttpStatus } from '@nestjs/common';
-import { DomainRuleError } from '../base-business-error.js';
-import { CommonErrorCodes, ErrorDomains } from '../error-codes.js';
+import { DomainRuleError } from '../base-business-error';
+import { CommonErrorCodes, ErrorDomains } from '../error-codes';
 /**
  * User domain business errors
  */

package/dist/esm/shared-lib/errors/domains/validation-errors.js

@@ -1,5 +1,5 @@
-import { ValidationError } from '../base-business-error.js';
-import { CommonErrorCodes, ErrorDomains } from '../error-codes.js';
+import { ValidationError } from '../base-business-error';
+import { CommonErrorCodes, ErrorDomains } from '../error-codes';
 /**
  * Generic validation errors used across multiple domains
  */

package/dist/esm/shared-lib/errors/domains/wallet-errors.js

@@ -1,6 +1,6 @@
 import { HttpStatus } from '@nestjs/common';
-import { DomainRuleError, TechnicalError } from '../base-business-error.js';
-import { CommonErrorCodes, ErrorDomains } from '../error-codes.js';
+import { DomainRuleError, TechnicalError } from '../base-business-error';
+import { CommonErrorCodes, ErrorDomains } from '../error-codes';
 /**
  * Wallet domain business errors
  */

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

@@ -1,24 +1,24 @@
 // Base error classes and interfaces
-export { BusinessLogicError, ValidationError, DomainRuleError, TechnicalError, InfrastructureError, SecurityError, RateLimitError, TimeoutError, UnknownError } from './base-business-error.js';
-export * from './technical-errors.js';
-export * from './domains/transaction-errors.js';
+export { BusinessLogicError, ValidationError, DomainRuleError, TechnicalError, InfrastructureError, SecurityError, RateLimitError, TimeoutError, UnknownError } from './base-business-error';
+export * from './technical-errors';
+export * from './domains/transaction-errors';
 // Error classification system
-export * from './base/error-classification-enums.js';
+export * from './base/error-classification-enums';
 // Note: Error classification system moved to @explorins/pers-shared-patterns
 // Error codes extracted from domain classes
-export * from './error-codes.js';
+export * from './error-codes';
 // Domain-specific errors (organized by domain)
-export * from './domains/token-errors.js';
-export * from './domains/user-errors.js';
-export * from './domains/wallet-errors.js';
-export * from './domains/business-errors.js';
-export * from './domains/balance-errors.js';
-export * from './domains/contract-errors.js';
-export * from './domains/system-errors.js';
-export * from './domains/authentication-errors.js';
-export * from './domains/signing-account-errors.js';
-export * from './domains/validation-errors.js';
-export * from './domains/tenant-errors.js';
-export * from './domains/campaign-errors.js';
-export * from './domains/trigger-source-errors.js';
+export * from './domains/token-errors';
+export * from './domains/user-errors';
+export * from './domains/wallet-errors';
+export * from './domains/business-errors';
+export * from './domains/balance-errors';
+export * from './domains/contract-errors';
+export * from './domains/system-errors';
+export * from './domains/authentication-errors';
+export * from './domains/signing-account-errors';
+export * from './domains/validation-errors';
+export * from './domains/tenant-errors';
+export * from './domains/campaign-errors';
+export * from './domains/trigger-source-errors';
 //# sourceMappingURL=index.js.map

package/dist/esm/shared-lib/errors/technical-errors.js

@@ -1,6 +1,6 @@
 import { HttpException, HttpStatus } from '@nestjs/common';
-import { ErrorCategory } from './base/error-classification-enums.js';
-import { CommonErrorCodes } from './error-codes.js';
+import { ErrorCategory } from './base/error-classification-enums';
+import { CommonErrorCodes } from './error-codes';
 /**
  * Technical errors with meaningful messages that should be preserved
  * Use for system errors that have specific, actionable messages but aren't business logic errors

package/dist/esm/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/esm/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/esm/shared-lib/interfaces/balance-filter-options.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=balance-filter-options.interface.js.map

package/dist/esm/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/esm/shared-lib/interfaces/campaign/index.js

@@ -1,2 +1,2 @@
-export * from "./trigger-settings.interface.js";
+export * from "./trigger-settings.interface";
 //# sourceMappingURL=index.js.map

package/dist/esm/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/esm/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/esm/shared-lib/interfaces/index.js

@@ -1,22 +1,23 @@
 // Interfaces Barrel - Auto-exports all interfaces
-export * from './auth-request-context.interface.js';
-export * from './transaction-account-data.interface.js';
-export * from './local-storage-item.interface.js';
-export * from './token-storage-data.interface.js';
-export * from './jwt.payload.interface.js';
-export * from './user-upload-data.interface.js';
-export * from './token-transaction-input-data.interface.js';
-export * from './geolocation-result.interface.js';
-export * from './wallet.interface.js';
-export * from './polymorphic-owner.interface.js';
-export * from './signer-verification.interface.js';
-export * from './wallet-signing-scenario.interface.js';
-export * from './base-pagination.interface.js';
-export * from './group-by-expression.interface.js';
-export * from './transaction-analytics-request.interface.js';
-export * from './location-coordinates.interface.js';
-export * from './transaction.interface.js';
-export * from './counterfactual-wallet-response.interface.js';
-export * from './campaign/index.js';
-export * from './ai-prompt-config.interface.js';
+export * from './auth-request-context.interface';
+export * from './transaction-account-data.interface';
+export * from './local-storage-item.interface';
+export * from './token-storage-data.interface';
+export * from './jwt.payload.interface';
+export * from './user-upload-data.interface';
+export * from './token-transaction-input-data.interface';
+export * from './geolocation-result.interface';
+export * from './wallet.interface';
+export * from './polymorphic-owner.interface';
+export * from './signer-verification.interface';
+export * from './wallet-signing-scenario.interface';
+export * from './base-pagination.interface';
+export * from './group-by-expression.interface';
+export * from './transaction-analytics-request.interface';
+export * from './location-coordinates.interface';
+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.js.map

package/dist/esm/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,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.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,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/esm/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/esm/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/esm/shared-lib/interfaces/token-storage-data.interface.js

@@ -3,5 +3,9 @@ export 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 || (TokenStorageDataAttributesType = {}));
 //# sourceMappingURL=token-storage-data.interface.js.map

package/dist/esm/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,MAAM,CAAN,IAAY,8BAIX;AAJD,WAAY,8BAA8B;IACtC,6DAA2B,CAAA;IAC3B,qFAAmD,CAAA;IACnD,6DAA2B,CAAA;AAC/B,CAAC,EAJW,8BAA8B,KAA9B,8BAA8B,QAIzC"}
+{"version":3,"file":"token-storage-data.interface.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/token-storage-data.interface.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAN,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,KAA9B,8BAA8B,QAQzC"}

package/dist/esm/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/esm/shared-lib/types/index.d.ts.map

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

@@ -1,16 +1,17 @@
 // Types Barrel - Auto-exports all type definitions
-export * from './testnet-prefix.js';
-export * from './unique-user-identifier-keys.js';
-export * from './native-token.type.js';
-export * from './analytics.type.js';
-export * from './account-selector.type.js';
-export * from './domains.js';
-export * from './query-specification.types.js';
-export * from './transaction-filters.type.js';
-export * from './includable-relation.type.js';
-export * from './transaction-include-relation.type.js';
-export * from './campaign-include-relation.type.js';
-export * from './campaign-claim-include-relation.type.js';
-export * from './redemption-redeem-include-relation.type.js';
-export * from './business-membership-include-relation.type.js';
+export * from './testnet-prefix';
+export * from './unique-user-identifier-keys';
+export * from './native-token.type';
+export * from './analytics.type';
+export * from './account-selector.type';
+export * from './domains';
+export * from './query-specification.types';
+export * from './transaction-filters.type';
+export * from './includable-relation.type';
+export * from './transaction-include-relation.type';
+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.js.map

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

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

package/dist/esm/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/esm/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/esm/shared-lib/types/user-include-relation.type.js

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

package/dist/esm/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":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAU,CAAC;AAIpE;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC7C,OAAO,oBAAoB,CAAC,QAAQ,CAAC,KAA4B,CAAC,CAAC;AACvE,CAAC"}

package/dist/esm/shared-lib/value-objects/account-selector.vo.js

@@ -6,9 +6,9 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { Type } from "class-transformer";
 import { IsEnum, IsNotEmpty, IsString, IsOptional, ValidateNested } from "class-validator";
-import { AccountOwnerType } from "./../enum/index.js";
-import { Address } from "./address.value-object.js";
-import { Errors } from '../../shared-patterns/errors/error-factory.js';
+import { AccountOwnerType } from "./../enum";
+import { Address } from "./address.value-object";
+import { Errors } from '../../shared-patterns/errors/error-factory';
 export class AccountSelectorVo {
     static fromDTO(selector) {
         // Create the appropriate AccountSelector based on accountType

package/dist/esm/shared-lib/value-objects/address.value-object.js

@@ -1,4 +1,4 @@
-import { Errors } from '../../shared-patterns/errors/error-factory.js';
+import { Errors } from '../../shared-patterns/errors/error-factory';
 export class Address {
     value;
     constructor(value) {

package/dist/esm/shared-lib/value-objects/index.js

@@ -1,11 +1,11 @@
 // Value Objects Barrel - Auto-exports all value objects
-export * from './address.value-object.js';
-export * from './token-balance.value-object.js';
-export * from './account-token-balances.value-object.js';
-export * from './token-unit.value-object.js';
+export * from './address.value-object';
+export * from './token-balance.value-object';
+export * from './account-token-balances.value-object';
+export * from './token-unit.value-object';
 // These use decorators but server environment can handle reflect-metadata
-export * from './token-transaction-input.vo.js';
-export * from './token-transaction-entity-reference-input.vo.js';
-export * from './signed-tx-data.vo.js';
-export * from './account-selector.vo.js';
+export * from './token-transaction-input.vo';
+export * from './token-transaction-entity-reference-input.vo';
+export * from './signed-tx-data.vo';
+export * from './account-selector.vo';
 //# sourceMappingURL=index.js.map

package/dist/esm/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/esm/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/esm/shared-lib/value-objects/token-balance.value-object.js

@@ -1,3 +1,4 @@
+import { isTokenExpired } from '../../shared-patterns/functions/helper.functions';
 /**
  * Value object representing the token balance details.
  */
@@ -10,6 +11,7 @@ export class TokenBalance {
     tokenName;
     tokenSymbol;
     tokenType;
+    expiryDate;
     /**
      * Constructs a new TokenBalance value object.
      *
@@ -21,9 +23,10 @@ export 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;
@@ -32,6 +35,7 @@ export class TokenBalance {
         this.tokenName = tokenName;
         this.tokenSymbol = tokenSymbol;
         this.tokenType = tokenType;
+        this.expiryDate = expiryDate;
     }
     /**
      * Gets the chain ID.
@@ -97,6 +101,24 @@ export 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 isTokenExpired(this.expiryDate) ?? false;
+    }
     /**
      * Returns a string representation of the TokenBalance.
      *