@explorins/pers-shared 2.1.96 → 2.1.98

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

@@ -0,0 +1,174 @@
+import { TokenValidityTypes } from '../../shared-lib/enum/token-validity-type.enum';
+import { TokenStorageDataAttributesType } 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 const parseCommaSeparatedStringToStringArray = (commaSeparatedString) => {
+    return commaSeparatedString
+        ? commaSeparatedString.split(',').map((s) => s.trim()).filter(Boolean)
+        : [];
+};
+export const checkIfTokenIdIsUri = (tokenId) => {
+    const uriRegex = /^(https?|ipfs):\/\/.*/;
+    if (!tokenId || !uriRegex.test(tokenId)) {
+        return false;
+    }
+    return true;
+};
+export 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;
+};
+/**
+ * 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 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 TokenValidityTypes.FIXED_DATE:
+            return fixedExpiryDate;
+        case TokenValidityTypes.DAYS_FROM_ISSUANCE:
+            if (!validityDuration || validityDuration <= 0)
+                return undefined;
+            const daysResult = new Date(issuanceDate);
+            daysResult.setDate(daysResult.getDate() + validityDuration);
+            return daysResult;
+        case TokenValidityTypes.HOURS_FROM_ISSUANCE:
+            if (!validityDuration || validityDuration <= 0)
+                return undefined;
+            const hoursResult = new Date(issuanceDate);
+            hoursResult.setHours(hoursResult.getHours() + validityDuration);
+            return hoursResult;
+        case TokenValidityTypes.MONTHS_FROM_ISSUANCE:
+            if (!validityDuration || validityDuration <= 0)
+                return undefined;
+            const monthsResult = new Date(issuanceDate);
+            monthsResult.setMonth(monthsResult.getMonth() + validityDuration);
+            return monthsResult;
+        case 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 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;
+    }
+};
+/**
+ * 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 const isTokenExpired = (expiryDate, referenceDate = new Date()) => {
+    if (!expiryDate)
+        return undefined;
+    return new Date(expiryDate) < referenceDate;
+};
+/**
+ * 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 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
+};
+/**
+ * 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 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() === TokenStorageDataAttributesType.EXPIRY_DATE.toLowerCase());
+    if (expiryAttribute?.value) {
+        return new Date(expiryAttribute.value);
+    }
+    return 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 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() === 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 [];
+};
+//# sourceMappingURL=helper.functions.js.map

package/dist/esm/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-shared",
-  "version": "2.1.96",
+  "version": "2.1.98",
   "scripts": {
     "clean": "find dist -type f -delete 2>/dev/null || true",
     "build:esm": "tsc -p tsconfig.esm.json && node scripts/add-js-extensions.js",