@explorins/pers-shared 2.1.97 → 2.1.98

package/dist/esm/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,MAAM,OAAO,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"}
+{"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/esm/shared-lib/value-objects/token-transaction-entity-reference-input.vo.js

@@ -6,8 +6,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { IsNotEmpty, IsNumber, IsString, ValidateNested, IsOptional, IsEnum, IsObject } from 'class-validator';
 import { Type } from 'class-transformer';
-import { Web3TransactionType } from '../enum/transaction-type.enum.js';
-import { AccountSelectorVo } from './account-selector.vo.js';
+import { Web3TransactionType } from '../enum/transaction-type.enum';
+import { AccountSelectorVo } from './account-selector.vo';
 /**
  * Token Transaction Entity Reference Input VO
  *

package/dist/esm/shared-lib/value-objects/token-transaction-input.vo.js

@@ -6,8 +6,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { IsNotEmpty, IsNumber, IsString, ValidateNested, IsOptional, IsEnum, IsObject, IsArray } from 'class-validator';
 import { Type } from 'class-transformer';
-import { Web3TransactionType } from '../enum/transaction-type.enum.js';
-import { Address } from './address.value-object.js';
+import { Web3TransactionType } from '../enum/transaction-type.enum';
+import { Address } from './address.value-object';
 export class TokenTransactionInputDataVo {
     transactionId;
     chainId;

package/dist/esm/shared-patterns/errors/error-factory.js

@@ -1,17 +1,17 @@
 // Import directly from source files (not the barrel which only exports types)
-import { BusinessNotFoundError, BusinessNotMinterError, CampaignNotFoundError, MembershipNotFoundError, MembershipAlreadyExistsError, MembershipLastOwnerError, GeographicRestrictionError, LocationVerificationRequiredError, RedemptionLimitReachedError, UserStatusRestrictedError, } from '../../shared-lib/errors/domains/business-errors.js';
-import { UserNotFoundError, } from '../../shared-lib/errors/domains/user-errors.js';
-import { TokenNotFoundError, TokenNotActiveError, TokenIdRequiredError, TokenTypeNotFoundError, TokenUnitNotFoundError, } from '../../shared-lib/errors/domains/token-errors.js';
-import { TransactionNotFoundError, TransactionAlreadyCompletedError, TransactionNotPendingError, TransactionValidationError, UnexpectedValidationScenarioError, TransactionExpiredError, } from '../../shared-lib/errors/domains/transaction-errors.js';
-import { AuthenticationRequiredError, InvalidTokenError, TokenExpiredError, AuthorizationFailedError, MultipleContextSelectionRequiredError, } from '../../shared-lib/errors/domains/authentication-errors.js';
-import { InsufficientBalanceError, } from '../../shared-lib/errors/domains/balance-errors.js';
-import { InvalidInputError, RequiredFieldError, InvalidFormatError, } from '../../shared-lib/errors/domains/validation-errors.js';
-import { SystemError, ExternalServiceError, ConfigurationMissingError, } from '../../shared-lib/errors/domains/system-errors.js';
-import { TriggerSourceNotFoundError, } from '../../shared-lib/errors/domains/trigger-source-errors.js';
-import { SigningAccountValidationError, SigningAccountNotFoundError, SigningAccountAlreadyExistsError, KeyGenerationError, } from '../../shared-lib/errors/domains/signing-account-errors.js';
-import { WalletNotFoundError, WalletMissingSigningError, SmartWalletProcessingError, } from '../../shared-lib/errors/domains/wallet-errors.js';
-import { TenantNotFoundError, } from '../../shared-lib/errors/domains/tenant-errors.js';
-import { CampaignUserInfoRequiredError, CampaignBusinessRequiredError, CampaignConditionNotMetError, CampaignAlreadyClaimedError, CampaignNoTriggerError, CampaignLocationRequiredError, CampaignDistanceExceededError, CampaignNotActiveError, CampaignEndedError, CampaignNotStartedError, CampaignClaimLimitReachedError, CampaignCooldownActiveError, CampaignDailyLimitReachedError, CampaignGlobalLimitReachedError, CampaignGlobalDailyLimitReachedError, TriggerNotFoundError, ResourceAlreadyExistsError, ResourceInUseError, } from '../../shared-lib/errors/domains/campaign-errors.js';
+import { BusinessNotFoundError, BusinessNotMinterError, CampaignNotFoundError, MembershipNotFoundError, MembershipAlreadyExistsError, MembershipLastOwnerError, GeographicRestrictionError, LocationVerificationRequiredError, RedemptionLimitReachedError, UserStatusRestrictedError, } from '../../shared-lib/errors/domains/business-errors';
+import { UserNotFoundError, } from '../../shared-lib/errors/domains/user-errors';
+import { TokenNotFoundError, TokenNotActiveError, TokenIdRequiredError, TokenTypeNotFoundError, TokenUnitNotFoundError, } from '../../shared-lib/errors/domains/token-errors';
+import { TransactionNotFoundError, TransactionAlreadyCompletedError, TransactionNotPendingError, TransactionValidationError, UnexpectedValidationScenarioError, TransactionExpiredError, } from '../../shared-lib/errors/domains/transaction-errors';
+import { AuthenticationRequiredError, InvalidTokenError, TokenExpiredError, AuthorizationFailedError, MultipleContextSelectionRequiredError, } from '../../shared-lib/errors/domains/authentication-errors';
+import { InsufficientBalanceError, } from '../../shared-lib/errors/domains/balance-errors';
+import { InvalidInputError, RequiredFieldError, InvalidFormatError, } from '../../shared-lib/errors/domains/validation-errors';
+import { SystemError, ExternalServiceError, ConfigurationMissingError, } from '../../shared-lib/errors/domains/system-errors';
+import { TriggerSourceNotFoundError, } from '../../shared-lib/errors/domains/trigger-source-errors';
+import { SigningAccountValidationError, SigningAccountNotFoundError, SigningAccountAlreadyExistsError, KeyGenerationError, } from '../../shared-lib/errors/domains/signing-account-errors';
+import { WalletNotFoundError, WalletMissingSigningError, SmartWalletProcessingError, } from '../../shared-lib/errors/domains/wallet-errors';
+import { TenantNotFoundError, } from '../../shared-lib/errors/domains/tenant-errors';
+import { CampaignUserInfoRequiredError, CampaignBusinessRequiredError, CampaignConditionNotMetError, CampaignAlreadyClaimedError, CampaignNoTriggerError, CampaignLocationRequiredError, CampaignDistanceExceededError, CampaignNotActiveError, CampaignEndedError, CampaignNotStartedError, CampaignClaimLimitReachedError, CampaignCooldownActiveError, CampaignDailyLimitReachedError, CampaignGlobalLimitReachedError, CampaignGlobalDailyLimitReachedError, TriggerNotFoundError, ResourceAlreadyExistsError, ResourceInUseError, } from '../../shared-lib/errors/domains/campaign-errors';
 /**
  * Universal Error Factory for NestJS Applications
  *

package/dist/esm/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/esm/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/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":"AAEA,OAAO,EAAE,kBAAkB,EAA0B,MAAM,gDAAgD,CAAC;AAC5G,OAAO,EAAoB,8BAA8B,EAAE,MAAM,0DAA0D,CAAC;AAE5H;;;;;KAKK;AACL,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,oBAAmC,EAAY,EAAE;IACpG,OAAO,oBAAoB;QACzB,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QACtE,CAAC,CAAC,EAAE,CAAC;AACP,CAAC,CAAA;AAGL,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAsB,EAAW,EAAE;IACnE,MAAM,QAAQ,GAAG,uBAAuB,CAAC;IAC3C,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAgB,EAAE,QAAgB,EAAU,EAAE;IAC5E,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAE3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,IAAI,GAAG,IAAI;YAAE,OAAO,CAAC,CAAC;QAC1B,IAAI,IAAI,GAAG,IAAI;YAAE,OAAO,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,YAAgC,EAChC,gBAAyB,EACzB,eAAsB,EACtB,eAAqB,IAAI,IAAI,EAAE,EACb,EAAE;IACpB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,8DAA8D;QAC9D,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,QAAQ,YAAY,EAAE,CAAC;QACrB,KAAK,kBAAkB,CAAC,UAAU;YAChC,OAAO,eAAe,CAAC;QAEzB,KAAK,kBAAkB,CAAC,kBAAkB;YACxC,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,IAAI,CAAC;gBAAE,OAAO,SAAS,CAAC;YACjE,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC;YAC1C,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,gBAAgB,CAAC,CAAC;YAC5D,OAAO,UAAU,CAAC;QAEpB,KAAK,kBAAkB,CAAC,mBAAmB;YACzC,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,IAAI,CAAC;gBAAE,OAAO,SAAS,CAAC;YACjE,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3C,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,gBAAgB,CAAC,CAAC;YAChE,OAAO,WAAW,CAAC;QAErB,KAAK,kBAAkB,CAAC,oBAAoB;YAC1C,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,IAAI,CAAC;gBAAE,OAAO,SAAS,CAAC;YACjE,MAAM,YAAY,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC;YAC5C,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,GAAG,gBAAgB,CAAC,CAAC;YAClE,OAAO,YAAY,CAAC;QAEtB,KAAK,kBAAkB,CAAC,YAAY;YAClC,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC;YAC1C,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;YAC/C,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,mDAAmD;YAC1E,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YACrC,OAAO,UAAU,CAAC;QAEpB,KAAK,kBAAkB,CAAC,WAAW;YACjC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC;YACzC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW;YACnC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACtB,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YACpC,OAAO,SAAS,CAAC;QAEnB;YACE,OAAO,eAAe,CAAC;IAC3B,CAAC;AACH,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,UAAwB,EACxB,gBAAsB,IAAI,IAAI,EAAE,EACX,EAAE;IACvB,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC;AAC9C,CAAC,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAsB,EAAY,EAAE;IAChE,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAE7C,MAAM,UAAU,GAAG,IAAI;SACpB,GAAG,CAAC,GAAG,CAAC,EAAE,CACT,GAAG;SACA,WAAW,EAAE;SACb,IAAI,EAAE;SACN,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAE,6BAA6B;SACnD,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAE,0CAA0C;SACtE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAE,sCAAsC;SAC3D,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAE,iCAAiC;KAC5D;SACA,MAAM,CAAC,OAAO,CAAC,CAAC,CAAE,uBAAuB;IAE5C,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAE,oBAAoB;AACxD,CAAC,CAAA;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,QAAiC,EAAe,EAAE;IAC9F,IAAI,CAAC,QAAQ,EAAE,UAAU;QAAE,OAAO,IAAI,CAAC;IAEvC,uDAAuD;IACvD,MAAM,eAAe,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CAC9C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,8BAA8B,CAAC,WAAW,CAAC,WAAW,EAAE,CACnG,CAAC;IAEF,IAAI,eAAe,EAAE,KAAK,EAAE,CAAC;QAC3B,OAAO,IAAI,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,QAAiC,EAAY,EAAE;IACrF,IAAI,CAAC,QAAQ,EAAE,UAAU;QAAE,OAAO,EAAE,CAAC;IAErC,8EAA8E;IAC9E,MAAM,aAAa,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CAC5C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,8BAA8B,CAAC,IAAI,CAAC,WAAW,EAAE,CAC5F,CAAC;IAEF,IAAI,aAAa,EAAE,KAAK,EAAE,CAAC;QACzB,4DAA4D;QAC5D,OAAO,aAAa,CAAC,KAAK;aACvB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;aACtB,MAAM,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-shared",
-  "version": "2.1.97",
+  "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",