@explorins/pers-shared 2.1.96 → 2.1.98

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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"}

package/dist/cjs/shared-patterns/functions/helper.functions.d.ts

@@ -0,0 +1,71 @@
+import { type TokenValidityType } from '../../shared-lib/enum/token-validity-type.enum';
+import { TokenStorageData } from '../../shared-lib/interfaces/token-storage-data.interface';
+/**
+   * Parses a comma-separated string into an array of strings.
+   *
+   * @param commaSeparatedString - The string to parse.
+   * @returns An array of trimmed, non-empty strings.
+   */
+export declare const parseCommaSeparatedStringToStringArray: (commaSeparatedString: string | null) => string[];
+export declare const checkIfTokenIdIsUri: (tokenId: string | null) => boolean;
+export declare const compareVersions: (version1: string, version2: string) => number;
+/**
+ * Computes the expiry date based on validity configuration.
+ *
+ * @param validityType - The type of validity calculation
+ * @param validityDuration - Duration in days or hours (for relative types)
+ * @param fixedExpiryDate - Fixed expiry date (for fixed_date type)
+ * @param issuanceDate - The date of issuance (defaults to now)
+ * @returns The computed expiry date, or undefined if no validity is configured
+ */
+export declare const computeExpiryDate: (validityType?: TokenValidityType, validityDuration?: number, fixedExpiryDate?: Date, issuanceDate?: Date) => Date | undefined;
+/**
+ * Checks if a token has expired based on its expiry date.
+ *
+ * @param expiryDate - The expiry date to check
+ * @param referenceDate - The date to compare against (defaults to now)
+ * @returns true if expired, false if still valid, undefined if no expiry date
+ */
+export declare const isTokenExpired: (expiryDate?: Date | null, referenceDate?: Date) => boolean | undefined;
+/**
+ * Normalizes an array of tags for consistent storage.
+ * - Converts to lowercase
+ * - Trims whitespace
+ * - Replaces spaces with dashes
+ * - Removes duplicates
+ * - Filters out empty strings
+ *
+ * @param tags - Array of tag strings to normalize
+ * @returns Normalized, deduplicated array of tags
+ *
+ * @example
+ * normalizeTags(['Summer', ' VIP ', 'Black Friday', 'summer'])
+ * // Returns: ['summer', 'vip', 'black-friday']
+ */
+export declare const normalizeTags: (tags?: string[] | null) => string[];
+/**
+ * Extracts the expiry_date attribute from token metadata (OpenSea standard format).
+ * This is the inverse operation of computeExpiryDate - it reads the expiry that was
+ * stored in the metadata when the token was minted.
+ *
+ * @param metadata - The token metadata object containing attributes array
+ * @returns The expiry date if found, null otherwise
+ *
+ * @example
+ * const metadata = { attributes: [{ trait_type: 'expiry_date', value: '2024-12-31T23:59:59.000Z' }] };
+ * extractExpiryDateFromMetadata(metadata); // Returns Date object
+ */
+export declare const extractExpiryDateFromMetadata: (metadata: TokenStorageData | null) => Date | null;
+/**
+ * Extracts tags from token metadata (OpenSea standard format).
+ * Tags are stored as a comma-separated string in the 'Tags' attribute.
+ *
+ * @param metadata - The token metadata object containing attributes array
+ * @returns Array of tags found in the metadata, or empty array if none
+ *
+ * @example
+ * const metadata = { attributes: [{ trait_type: 'Tags', value: 'techno, mindfulness' }] };
+ * extractTagsFromMetadata(metadata); // Returns ['techno', 'mindfulness']
+ */
+export declare const extractTagsFromMetadata: (metadata: TokenStorageData | null) => string[];
+//# sourceMappingURL=helper.functions.d.ts.map

package/dist/cjs/shared-patterns/functions/helper.functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.functions.d.ts","sourceRoot":"","sources":["../../../../src/shared-patterns/functions/helper.functions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AAC5G,OAAO,EAAE,gBAAgB,EAAkC,MAAM,0DAA0D,CAAC;AAE5H;;;;;KAKK;AACL,eAAO,MAAM,sCAAsC,GAAI,sBAAsB,MAAM,GAAG,IAAI,KAAG,MAAM,EAI9F,CAAA;AAGL,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,GAAG,IAAI,KAAG,OAM5D,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,UAAU,MAAM,KAAG,MAWpE,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAC5B,eAAe,iBAAiB,EAChC,mBAAmB,MAAM,EACzB,kBAAkB,IAAI,EACtB,eAAc,IAAiB,KAC9B,IAAI,GAAG,SA6CT,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GACzB,aAAa,IAAI,GAAG,IAAI,EACxB,gBAAe,IAAiB,KAC/B,OAAO,GAAG,SAGZ,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,EAAE,GAAG,IAAI,KAAG,MAAM,EAgB5D,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,6BAA6B,GAAI,UAAU,gBAAgB,GAAG,IAAI,KAAG,IAAI,GAAG,IAaxF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,GAAI,UAAU,gBAAgB,GAAG,IAAI,KAAG,MAAM,EAiBjF,CAAA"}

package/dist/cjs/shared-patterns/functions/helper.functions.js

@@ -0,0 +1,185 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTagsFromMetadata = exports.extractExpiryDateFromMetadata = exports.normalizeTags = exports.isTokenExpired = exports.computeExpiryDate = exports.compareVersions = exports.checkIfTokenIdIsUri = exports.parseCommaSeparatedStringToStringArray = void 0;
+const token_validity_type_enum_1 = require("../../shared-lib/enum/token-validity-type.enum");
+const token_storage_data_interface_1 = require("../../shared-lib/interfaces/token-storage-data.interface");
+/**
+   * Parses a comma-separated string into an array of strings.
+   *
+   * @param commaSeparatedString - The string to parse.
+   * @returns An array of trimmed, non-empty strings.
+   */
+const parseCommaSeparatedStringToStringArray = (commaSeparatedString) => {
+    return commaSeparatedString
+        ? commaSeparatedString.split(',').map((s) => s.trim()).filter(Boolean)
+        : [];
+};
+exports.parseCommaSeparatedStringToStringArray = parseCommaSeparatedStringToStringArray;
+const checkIfTokenIdIsUri = (tokenId) => {
+    const uriRegex = /^(https?|ipfs):\/\/.*/;
+    if (!tokenId || !uriRegex.test(tokenId)) {
+        return false;
+    }
+    return true;
+};
+exports.checkIfTokenIdIsUri = checkIfTokenIdIsUri;
+const compareVersions = (version1, version2) => {
+    const v1 = version1.split('.').map(Number);
+    const v2 = version2.split('.').map(Number);
+    for (let i = 0; i < Math.max(v1.length, v2.length); i++) {
+        const num1 = v1[i] || 0;
+        const num2 = v2[i] || 0;
+        if (num1 > num2)
+            return 1;
+        if (num1 < num2)
+            return -1;
+    }
+    return 0;
+};
+exports.compareVersions = compareVersions;
+/**
+ * Computes the expiry date based on validity configuration.
+ *
+ * @param validityType - The type of validity calculation
+ * @param validityDuration - Duration in days or hours (for relative types)
+ * @param fixedExpiryDate - Fixed expiry date (for fixed_date type)
+ * @param issuanceDate - The date of issuance (defaults to now)
+ * @returns The computed expiry date, or undefined if no validity is configured
+ */
+const computeExpiryDate = (validityType, validityDuration, fixedExpiryDate, issuanceDate = new Date()) => {
+    if (!validityType) {
+        // Fallback to fixed expiry date if no validity type specified
+        return fixedExpiryDate;
+    }
+    switch (validityType) {
+        case token_validity_type_enum_1.TokenValidityTypes.FIXED_DATE:
+            return fixedExpiryDate;
+        case token_validity_type_enum_1.TokenValidityTypes.DAYS_FROM_ISSUANCE:
+            if (!validityDuration || validityDuration <= 0)
+                return undefined;
+            const daysResult = new Date(issuanceDate);
+            daysResult.setDate(daysResult.getDate() + validityDuration);
+            return daysResult;
+        case token_validity_type_enum_1.TokenValidityTypes.HOURS_FROM_ISSUANCE:
+            if (!validityDuration || validityDuration <= 0)
+                return undefined;
+            const hoursResult = new Date(issuanceDate);
+            hoursResult.setHours(hoursResult.getHours() + validityDuration);
+            return hoursResult;
+        case token_validity_type_enum_1.TokenValidityTypes.MONTHS_FROM_ISSUANCE:
+            if (!validityDuration || validityDuration <= 0)
+                return undefined;
+            const monthsResult = new Date(issuanceDate);
+            monthsResult.setMonth(monthsResult.getMonth() + validityDuration);
+            return monthsResult;
+        case token_validity_type_enum_1.TokenValidityTypes.END_OF_MONTH:
+            const endOfMonth = new Date(issuanceDate);
+            endOfMonth.setMonth(endOfMonth.getMonth() + 1);
+            endOfMonth.setDate(0); // Last day of previous month (i.e., current month)
+            endOfMonth.setHours(23, 59, 59, 999);
+            return endOfMonth;
+        case token_validity_type_enum_1.TokenValidityTypes.END_OF_YEAR:
+            const endOfYear = new Date(issuanceDate);
+            endOfYear.setMonth(11); // December
+            endOfYear.setDate(31);
+            endOfYear.setHours(23, 59, 59, 999);
+            return endOfYear;
+        default:
+            return fixedExpiryDate;
+    }
+};
+exports.computeExpiryDate = computeExpiryDate;
+/**
+ * Checks if a token has expired based on its expiry date.
+ *
+ * @param expiryDate - The expiry date to check
+ * @param referenceDate - The date to compare against (defaults to now)
+ * @returns true if expired, false if still valid, undefined if no expiry date
+ */
+const isTokenExpired = (expiryDate, referenceDate = new Date()) => {
+    if (!expiryDate)
+        return undefined;
+    return new Date(expiryDate) < referenceDate;
+};
+exports.isTokenExpired = isTokenExpired;
+/**
+ * Normalizes an array of tags for consistent storage.
+ * - Converts to lowercase
+ * - Trims whitespace
+ * - Replaces spaces with dashes
+ * - Removes duplicates
+ * - Filters out empty strings
+ *
+ * @param tags - Array of tag strings to normalize
+ * @returns Normalized, deduplicated array of tags
+ *
+ * @example
+ * normalizeTags(['Summer', ' VIP ', 'Black Friday', 'summer'])
+ * // Returns: ['summer', 'vip', 'black-friday']
+ */
+const normalizeTags = (tags) => {
+    if (!tags || !Array.isArray(tags))
+        return [];
+    const normalized = tags
+        .map(tag => tag
+        .toLowerCase()
+        .trim()
+        .replace(/\s+/g, '-') // Replace spaces with dashes
+        .replace(/[^a-z0-9-]/g, '') // Remove special characters except dashes
+        .replace(/-+/g, '-') // Replace multiple dashes with single
+        .replace(/^-|-$/g, '') // Remove leading/trailing dashes
+    )
+        .filter(Boolean); // Remove empty strings
+    return [...new Set(normalized)]; // Remove duplicates
+};
+exports.normalizeTags = normalizeTags;
+/**
+ * Extracts the expiry_date attribute from token metadata (OpenSea standard format).
+ * This is the inverse operation of computeExpiryDate - it reads the expiry that was
+ * stored in the metadata when the token was minted.
+ *
+ * @param metadata - The token metadata object containing attributes array
+ * @returns The expiry date if found, null otherwise
+ *
+ * @example
+ * const metadata = { attributes: [{ trait_type: 'expiry_date', value: '2024-12-31T23:59:59.000Z' }] };
+ * extractExpiryDateFromMetadata(metadata); // Returns Date object
+ */
+const extractExpiryDateFromMetadata = (metadata) => {
+    if (!metadata?.attributes)
+        return null;
+    // Case-insensitive comparison to handle legacy formats
+    const expiryAttribute = metadata.attributes.find(attr => attr.trait_type.toLowerCase() === token_storage_data_interface_1.TokenStorageDataAttributesType.EXPIRY_DATE.toLowerCase());
+    if (expiryAttribute?.value) {
+        return new Date(expiryAttribute.value);
+    }
+    return null;
+};
+exports.extractExpiryDateFromMetadata = extractExpiryDateFromMetadata;
+/**
+ * Extracts tags from token metadata (OpenSea standard format).
+ * Tags are stored as a comma-separated string in the 'Tags' attribute.
+ *
+ * @param metadata - The token metadata object containing attributes array
+ * @returns Array of tags found in the metadata, or empty array if none
+ *
+ * @example
+ * const metadata = { attributes: [{ trait_type: 'Tags', value: 'techno, mindfulness' }] };
+ * extractTagsFromMetadata(metadata); // Returns ['techno', 'mindfulness']
+ */
+const extractTagsFromMetadata = (metadata) => {
+    if (!metadata?.attributes)
+        return [];
+    // Case-insensitive comparison to handle legacy formats ('Tags', 'tags', etc.)
+    const tagsAttribute = metadata.attributes.find(attr => attr.trait_type.toLowerCase() === token_storage_data_interface_1.TokenStorageDataAttributesType.TAGS.toLowerCase());
+    if (tagsAttribute?.value) {
+        // Tags are stored as comma-separated string, split and trim
+        return tagsAttribute.value
+            .split(',')
+            .map(tag => tag.trim())
+            .filter(Boolean);
+    }
+    return [];
+};
+exports.extractTagsFromMetadata = extractTagsFromMetadata;
+//# sourceMappingURL=helper.functions.js.map

package/dist/cjs/shared-patterns/functions/helper.functions.js.map

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

package/dist/esm/browser.js

@@ -3,9 +3,9 @@
  * Uses barrel exports for automatic inclusion - no manual maintenance needed!
  */
 // Export enums - these are safe for browser use (barrel export)
-export * from './shared-lib/enum/index.js';
+export * from './shared-lib/enum';
 // Export types and constants (runtime exports) - browser-safe only
-export * from './shared-lib/types/index.js';
+export * from './shared-lib/types';
 // Re-export web3 types for convenience
 export * from '@explorins/web3-types';
 // Note: Backend-specific types (like TRANSACTION_FORMATS) are excluded from browser build

package/dist/esm/index.js

@@ -1,13 +1,13 @@
 // PERS Shared Contracts Library - Pure Data Contracts and Domain Vocabulary
 // 🌐 PUBLIC: Safe for external consumption - contains only DTOs, interfaces, types, and enums
 // Core domain contracts
-export * from './shared-lib/enum/index.js';
-export * from './shared-lib/interfaces/index.js';
-export * from './shared-lib/types/index.js';
+export * from './shared-lib/enum';
+export * from './shared-lib/interfaces';
+export * from './shared-lib/types';
 // Re-export web3 types for convenience
 export * from '@explorins/web3-types';
-export { ErrorCategory } from './shared-lib/errors/base/error-classification-enums.js';
+export { ErrorCategory } from './shared-lib/errors/base/error-classification-enums';
 // Shared patterns (architecture components)
-// export * from './shared-patterns/index.js';
+// export * from './shared-patterns/index';
 // External consumers should only use the type exports and documented public APIs
 //# sourceMappingURL=index.js.map

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

@@ -1,2 +1,2 @@
-export * from './validation.decorators.js';
+export * from './validation.decorators';
 //# sourceMappingURL=index.js.map

package/dist/esm/shared-lib/dto/account-selector.dto.js

@@ -6,8 +6,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
 import { IsString, IsEnum } from "class-validator";
-import { AccountOwnerType } from "../enum/index.js";
-import { OptionalStrip } from '../decorators/index.js';
+import { AccountOwnerType } from "../enum";
+import { OptionalStrip } from '../decorators';
 /**
  * Standard Account Identification for Transaction Participants
  * Supports multiple identification methods with auto-detection

package/dist/esm/shared-lib/dto/account-token-balances.dto.js

@@ -5,7 +5,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { ApiProperty } from "@nestjs/swagger";
-import { TokenBalanceDTO, TokenMetadataBalanceDTO } from "./token/token-balance.dto.js";
+import { TokenBalanceDTO, TokenMetadataBalanceDTO } from "./token/token-balance.dto";
 export class AccountTokenBalancesDTO {
     accountAddress = '';
     tokenBalances = [];

package/dist/esm/shared-lib/dto/admin/admin-create.request.dto.js

@@ -6,8 +6,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
 import { IsNotEmpty, IsEmail, IsString, IsEnum } from 'class-validator';
-import { AdminType } from './../../enum/admin-type.enum.js';
-import { OptionalStrip } from '../../decorators/index.js';
+import { AdminType } from './../../enum/admin-type.enum';
+import { OptionalStrip } from '../../decorators';
 export class AdminCreateRequestDTO {
     email = '';
     displayName;

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

@@ -5,8 +5,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
-import { AdminType } from "../../enum/admin-type.enum.js";
-import { TenantDTO } from "./../tenant/index.js";
+import { AdminType } from "../../enum/admin-type.enum";
+import { TenantDTO } from "./../tenant";
 export class AdminDTO {
     id = '';
     email = '';

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

@@ -1,3 +1,3 @@
-export * from './admin-create.request.dto.js';
-export * from './admin.dto.js';
+export * from './admin-create.request.dto';
+export * from './admin.dto';
 //# sourceMappingURL=index.js.map

package/dist/esm/shared-lib/dto/ai/ai-generation-log.dto.d.ts

@@ -0,0 +1,35 @@
+import { AiOperationType } from '../../enum/ai-operation-type.enum';
+import { AiTriggerProcessType } from '../../enum/ai-trigger-process-type.enum';
+/**
+ * AI Generation Log DTO
+ *
+ * Represents an AI generation operation record.
+ * Used for:
+ * - API responses from AI module
+ * - Cross-domain analytics queries
+ * - Billing and usage tracking
+ *
+ * DDD: Shared Kernel - used by AI module and Analytics module
+ */
+export declare class AiGenerationLogDTO {
+    id: string;
+    tenantId: string;
+    userId?: string;
+    operationType: AiOperationType;
+    triggerProcessType?: AiTriggerProcessType | null;
+    triggerProcessId?: string | null;
+    model: string;
+    promptHash?: string | null;
+    promptPreview?: string | null;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    estimatedCostUsd: number;
+    responseTimeMs: number;
+    success: boolean;
+    message?: string | null;
+    metadata?: Record<string, unknown> | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=ai-generation-log.dto.d.ts.map

package/dist/esm/shared-lib/dto/ai/ai-generation-log.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-generation-log.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/ai/ai-generation-log.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAE/E;;;;;;;;;;GAUG;AACH,qBAAa,kBAAkB;IAK7B,EAAE,EAAG,MAAM,CAAC;IAMZ,QAAQ,EAAG,MAAM,CAAC;IAMlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAOhB,aAAa,EAAG,eAAe,CAAC;IAOhC,kBAAkB,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAMjD,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAMjC,KAAK,EAAG,MAAM,CAAC;IAMf,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAM3B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAM9B,WAAW,EAAG,MAAM,CAAC;IAMrB,YAAY,EAAG,MAAM,CAAC;IAMtB,WAAW,EAAG,MAAM,CAAC;IAMrB,gBAAgB,EAAG,MAAM,CAAC;IAM1B,cAAc,EAAG,MAAM,CAAC;IAMxB,OAAO,EAAG,OAAO,CAAC;IAMlB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAMxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAM1C,SAAS,EAAG,IAAI,CAAC;IAMjB,SAAS,EAAG,IAAI,CAAC;CAClB"}

package/dist/esm/shared-lib/dto/ai/ai-generation-log.dto.js

@@ -0,0 +1,158 @@
+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 { AiOperationType } from '../../enum/ai-operation-type.enum';
+import { AiTriggerProcessType } from '../../enum/ai-trigger-process-type.enum';
+/**
+ * AI Generation Log DTO
+ *
+ * Represents an AI generation operation record.
+ * Used for:
+ * - API responses from AI module
+ * - Cross-domain analytics queries
+ * - Billing and usage tracking
+ *
+ * DDD: Shared Kernel - used by AI module and Analytics module
+ */
+export class AiGenerationLogDTO {
+    id;
+    tenantId;
+    userId;
+    operationType;
+    triggerProcessType;
+    triggerProcessId;
+    model;
+    promptHash;
+    promptPreview;
+    inputTokens;
+    outputTokens;
+    totalTokens;
+    estimatedCostUsd;
+    responseTimeMs;
+    success;
+    message;
+    metadata;
+    createdAt;
+    updatedAt;
+}
+__decorate([
+    ApiProperty({
+        description: 'Unique identifier',
+        example: '123e4567-e89b-12d3-a456-426614174000'
+    })
+], AiGenerationLogDTO.prototype, "id", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Tenant identifier (auto-populated via RLS)',
+        example: 'tenant-123'
+    })
+], AiGenerationLogDTO.prototype, "tenantId", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'User who triggered the generation (null for system operations)',
+        example: '123e4567-e89b-12d3-a456-426614174000'
+    })
+], AiGenerationLogDTO.prototype, "userId", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Type of AI operation performed',
+        enum: AiOperationType,
+        example: AiOperationType.TEXT_GENERATION
+    })
+], AiGenerationLogDTO.prototype, "operationType", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'Business process that triggered this AI generation (for cost allocation)',
+        enum: AiTriggerProcessType,
+        example: AiTriggerProcessType.TRANSACTION
+    })
+], AiGenerationLogDTO.prototype, "triggerProcessType", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'ID of the entity that triggered this generation (e.g., Transaction ID)',
+        example: '123e4567-e89b-12d3-a456-426614174000'
+    })
+], AiGenerationLogDTO.prototype, "triggerProcessId", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Model used for generation',
+        example: 'gemini-2.5-flash'
+    })
+], AiGenerationLogDTO.prototype, "model", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'SHA256 hash of prompt for deduplication (privacy-aware)',
+        example: 'a1b2c3d4e5f6...'
+    })
+], AiGenerationLogDTO.prototype, "promptHash", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'First N characters of prompt for debugging',
+        example: 'Generate a description for...'
+    })
+], AiGenerationLogDTO.prototype, "promptPreview", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Number of input tokens',
+        example: 150
+    })
+], AiGenerationLogDTO.prototype, "inputTokens", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Number of output tokens',
+        example: 500
+    })
+], AiGenerationLogDTO.prototype, "outputTokens", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Total tokens (input + output)',
+        example: 650
+    })
+], AiGenerationLogDTO.prototype, "totalTokens", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Estimated cost in USD',
+        example: 0.0013
+    })
+], AiGenerationLogDTO.prototype, "estimatedCostUsd", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Response time in milliseconds',
+        example: 1250
+    })
+], AiGenerationLogDTO.prototype, "responseTimeMs", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Whether the operation succeeded',
+        example: true
+    })
+], AiGenerationLogDTO.prototype, "success", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'Message (error details if failed, or context info)',
+        example: null
+    })
+], AiGenerationLogDTO.prototype, "message", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'Additional metadata (generation options, temperature, etc.)',
+        example: { temperature: 0.7, thinkingLevel: 'medium' }
+    })
+], AiGenerationLogDTO.prototype, "metadata", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Creation timestamp',
+        example: '2026-03-12T10:30:00Z'
+    })
+], AiGenerationLogDTO.prototype, "createdAt", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Last update timestamp',
+        example: '2026-03-12T10:30:00Z'
+    })
+], AiGenerationLogDTO.prototype, "updatedAt", void 0);
+//# sourceMappingURL=ai-generation-log.dto.js.map

package/dist/esm/shared-lib/dto/ai/ai-generation-log.dto.js.map

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