@explorins/pers-shared 2.1.0

package/dist/esm/exceptions/technical-errors.js

@@ -0,0 +1,68 @@
+import { HttpException, HttpStatus } from '@nestjs/common';
+/**
+ * Technical errors that should be logged but not exposed to clients
+ */
+export class TechnicalError extends HttpException {
+    correlationId;
+    originalError;
+    constructor(message, originalError, correlationId, httpStatus = HttpStatus.INTERNAL_SERVER_ERROR) {
+        super({
+            code: 'TECHNICAL_ERROR',
+            message: 'An unexpected error occurred',
+            correlationId,
+            timestamp: new Date().toISOString(),
+            category: 'TECHNICAL'
+        }, httpStatus);
+        this.originalError = originalError;
+        this.correlationId = correlationId;
+        this.name = this.constructor.name;
+    }
+    static isTechnicalError(error) {
+        return error instanceof TechnicalError;
+    }
+}
+/**
+ * Orchestration errors that wrap other errors but preserve business context
+ */
+export class OrchestrationError extends HttpException {
+    operation;
+    originalError;
+    constructor(operation, originalError) {
+        // If the original error is a business error, preserve its HTTP status and message
+        const isBusinessError = originalError instanceof HttpException;
+        const status = isBusinessError ? originalError.getStatus() : HttpStatus.INTERNAL_SERVER_ERROR;
+        const response = isBusinessError ? originalError.getResponse() : {
+            code: 'ORCHESTRATION_ERROR',
+            message: 'Operation failed',
+            timestamp: new Date().toISOString(),
+            category: 'ORCHESTRATION'
+        };
+        super(response, status);
+        this.operation = operation;
+        this.originalError = originalError;
+        this.name = this.constructor.name;
+    }
+    static isOrchestrationError(error) {
+        return error instanceof OrchestrationError;
+    }
+    /**
+     * Get the root business error if it exists
+     */
+    getRootBusinessError() {
+        let current = this.originalError;
+        while (current) {
+            if (current instanceof HttpException &&
+                current.getResponse?.()?.category === 'BUSINESS_LOGIC') {
+                return current;
+            }
+            if (current instanceof OrchestrationError) {
+                current = current.originalError;
+            }
+            else {
+                break;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=technical-errors.js.map

package/dist/esm/exceptions/technical-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"technical-errors.js","sourceRoot":"","sources":["../../../src/exceptions/technical-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,aAAa;IAC/B,aAAa,CAAU;IACvB,aAAa,CAAS;IAEtC,YACE,OAAe,EACf,aAAqB,EACrB,aAAsB,EACtB,aAAyB,UAAU,CAAC,qBAAqB;QAEzD,KAAK,CACH;YACE,IAAI,EAAE,iBAAiB;YACvB,OAAO,EAAE,8BAA8B;YACvC,aAAa;YACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ,EAAE,WAAW;SACtB,EACD,UAAU,CACX,CAAC;QAEF,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,KAAU;QAChC,OAAO,KAAK,YAAY,cAAc,CAAC;IACzC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnC,SAAS,CAAS;IAClB,aAAa,CAAQ;IAErC,YAAY,SAAiB,EAAE,aAAoB;QACjD,kFAAkF;QAClF,MAAM,eAAe,GAAG,aAAa,YAAY,aAAa,CAAC;QAC/D,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,qBAAqB,CAAC;QAC9F,MAAM,QAAQ,GAAG,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YAC/D,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,kBAAkB;YAC3B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ,EAAE,eAAe;SAC1B,CAAC;QAEF,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAExB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,oBAAoB,CAAC,KAAU;QACpC,OAAO,KAAK,YAAY,kBAAkB,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,IAAI,OAAO,GAAU,IAAI,CAAC,aAAa,CAAC;QAExC,OAAO,OAAO,EAAE,CAAC;YACf,IAAI,OAAO,YAAY,aAAa;gBAC/B,OAAe,CAAC,WAAW,EAAE,EAAE,EAAE,QAAQ,KAAK,gBAAgB,EAAE,CAAC;gBACpE,OAAO,OAAO,CAAC;YACjB,CAAC;YAED,IAAI,OAAO,YAAY,kBAAkB,EAAE,CAAC;gBAC1C,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,MAAM;YACR,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/esm/exceptions/transaction-errors.d.ts

@@ -0,0 +1,44 @@
+import { BusinessError } from './business-error.base';
+/**
+ * Transaction-specific business errors
+ */
+export declare class TransactionAlreadyCompletedError extends BusinessError {
+    constructor(transactionId: string, currentStatus: string);
+}
+export declare class TransactionNotPendingError extends BusinessError {
+    constructor(transactionId: string, currentStatus: string);
+}
+export declare class TransactionValidationError extends BusinessError {
+    constructor(field: string, reason: string);
+}
+export declare class WalletMissingSigningError extends BusinessError {
+    constructor(walletAddress: string);
+}
+export declare class WalletNotFoundError extends BusinessError {
+    constructor(ownerAddress: string);
+}
+export declare class SmartWalletProcessingError extends BusinessError {
+    constructor(reason: string);
+}
+export declare class ContractNotFoundError extends BusinessError {
+    constructor(contractAddress: string);
+}
+export declare class InsufficientBalanceError extends BusinessError {
+    constructor(required: string, available: string, tokenSymbol?: string);
+}
+export declare class TokenNotActiveError extends BusinessError {
+    constructor(tokenId: string);
+}
+export declare class BusinessNotMinterError extends BusinessError {
+    constructor(businessId: string, tokenId: string);
+}
+export declare class TokenIdRequiredError extends BusinessError {
+    constructor(tokenType: string);
+}
+export declare class UserNotFoundError extends BusinessError {
+    constructor(identifier: string);
+}
+export declare class UnexpectedValidationScenarioError extends BusinessError {
+    constructor(scenario: string);
+}
+//# sourceMappingURL=transaction-errors.d.ts.map

package/dist/esm/exceptions/transaction-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-errors.d.ts","sourceRoot":"","sources":["../../../src/exceptions/transaction-errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;GAEG;AACH,qBAAa,gCAAiC,SAAQ,aAAa;gBACrD,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;CAUzD;AAED,qBAAa,0BAA2B,SAAQ,aAAa;gBAC/C,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;CAUzD;AAED,qBAAa,0BAA2B,SAAQ,aAAa;gBAC/C,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAU1C;AAED,qBAAa,yBAA0B,SAAQ,aAAa;gBAC9C,aAAa,EAAE,MAAM;CAUlC;AAED,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,YAAY,EAAE,MAAM;CAUjC;AAED,qBAAa,0BAA2B,SAAQ,aAAa;gBAC/C,MAAM,EAAE,MAAM;CAU3B;AAED,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,eAAe,EAAE,MAAM;CAUpC;AAED,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAWtE;AAED,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,OAAO,EAAE,MAAM;CAU5B;AAED,qBAAa,sBAAuB,SAAQ,aAAa;gBAC3C,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAUhD;AAED,qBAAa,oBAAqB,SAAQ,aAAa;gBACzC,SAAS,EAAE,MAAM;CAU9B;AAED,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,UAAU,EAAE,MAAM;CAU/B;AAED,qBAAa,iCAAkC,SAAQ,aAAa;gBACtD,QAAQ,EAAE,MAAM;CAU7B"}

package/dist/esm/exceptions/transaction-errors.js

@@ -0,0 +1,72 @@
+import { HttpStatus } from '@nestjs/common';
+import { BusinessError } from './business-error.base';
+/**
+ * Transaction-specific business errors
+ */
+export class TransactionAlreadyCompletedError extends BusinessError {
+    constructor(transactionId, currentStatus) {
+        super('TRANSACTION_ALREADY_COMPLETED', 'transaction', 'This transaction has already been completed', `Transaction ${transactionId} is in status: ${currentStatus}`, HttpStatus.CONFLICT, 'Please refresh and check the transaction status');
+    }
+}
+export class TransactionNotPendingError extends BusinessError {
+    constructor(transactionId, currentStatus) {
+        super('TRANSACTION_NOT_PENDING', 'transaction', 'Transaction is not in a pending state', `Transaction ${transactionId} has status: ${currentStatus}, expected: pending`, HttpStatus.CONFLICT, 'Please check the current transaction status');
+    }
+}
+export class TransactionValidationError extends BusinessError {
+    constructor(field, reason) {
+        super('TRANSACTION_VALIDATION_ERROR', 'transaction', `Transaction validation failed: ${reason}`, `Field '${field}' validation failed: ${reason}`, HttpStatus.BAD_REQUEST, 'Please check the transaction data and try again');
+    }
+}
+export class WalletMissingSigningError extends BusinessError {
+    constructor(walletAddress) {
+        super('WALLET_MISSING_SIGNING', 'wallet', 'Wallet exists but has no linked signing account', `Wallet ${walletAddress} exists but has no linked signing account`, HttpStatus.CONFLICT, 'Please set up a signing account for this wallet');
+    }
+}
+export class WalletNotFoundError extends BusinessError {
+    constructor(ownerAddress) {
+        super('WALLET_NOT_FOUND', 'wallet', 'No wallet found for this address', `No wallet found for owner address: ${ownerAddress}`, HttpStatus.NOT_FOUND, 'Please create a wallet first');
+    }
+}
+export class SmartWalletProcessingError extends BusinessError {
+    constructor(reason) {
+        super('SMART_WALLET_PROCESSING_FAILED', 'wallet', 'Smart wallet transaction processing failed', `Smart wallet processing failed: ${reason}`, HttpStatus.UNPROCESSABLE_ENTITY, 'Please try with a standard wallet transaction');
+    }
+}
+export class ContractNotFoundError extends BusinessError {
+    constructor(contractAddress) {
+        super('CONTRACT_NOT_FOUND', 'contract', 'Contract not found or ABI unavailable', `Contract at address ${contractAddress} not found or ABI unavailable`, HttpStatus.NOT_FOUND, 'Please verify the contract address');
+    }
+}
+export class InsufficientBalanceError extends BusinessError {
+    constructor(required, available, tokenSymbol) {
+        const token = tokenSymbol ? ` ${tokenSymbol}` : '';
+        super('INSUFFICIENT_BALANCE', 'balance', `Insufficient${token} balance for this transaction`, `Required: ${required}${token}, Available: ${available}${token}`, HttpStatus.UNPROCESSABLE_ENTITY, 'Please ensure you have sufficient balance');
+    }
+}
+export class TokenNotActiveError extends BusinessError {
+    constructor(tokenId) {
+        super('TOKEN_NOT_ACTIVE', 'token', 'Token is not active', `Token ${tokenId} is not in an active state`, HttpStatus.UNPROCESSABLE_ENTITY, 'Please use an active token');
+    }
+}
+export class BusinessNotMinterError extends BusinessError {
+    constructor(businessId, tokenId) {
+        super('BUSINESS_NOT_MINTER', 'token', 'Business is not authorized as a minter for this token', `Business ${businessId} is not a minter for token ${tokenId}`, HttpStatus.FORBIDDEN, 'Please verify token minting permissions');
+    }
+}
+export class TokenIdRequiredError extends BusinessError {
+    constructor(tokenType) {
+        super('TOKEN_ID_REQUIRED', 'token', `TokenId is required for ${tokenType} tokens`, `TokenId parameter is required for token type: ${tokenType}`, HttpStatus.BAD_REQUEST, 'Please provide a valid tokenId');
+    }
+}
+export class UserNotFoundError extends BusinessError {
+    constructor(identifier) {
+        super('USER_NOT_FOUND', 'user', 'User not found', `User not found for identifier: ${identifier}`, HttpStatus.NOT_FOUND, 'Please verify the user exists');
+    }
+}
+export class UnexpectedValidationScenarioError extends BusinessError {
+    constructor(scenario) {
+        super('UNEXPECTED_VALIDATION_SCENARIO', 'validation', 'Unexpected validation scenario encountered', `Unexpected validation scenario: ${scenario}`, HttpStatus.INTERNAL_SERVER_ERROR, 'Please contact support');
+    }
+}
+//# sourceMappingURL=transaction-errors.js.map

package/dist/esm/exceptions/transaction-errors.js.map

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

package/dist/esm/functions/crypto.functions.d.ts

@@ -0,0 +1,12 @@
+type KeyFormat = 'pem';
+type KeyType = 'pkcs1' | 'pkcs8';
+export declare const generatePublicKeyId: (publicKey: string) => string;
+export declare const generateDecryptedPrivateKey: (privateKey: string, passphrase: string | undefined, keyType?: KeyType, keyFormat?: KeyFormat) => string;
+export declare const encryptData: (data: string, encryptionKey: string) => {
+    encryptedData: string;
+    iv: string;
+    authTag: string;
+};
+export declare const decryptData: (encryptedData: string, iv: string, authTag: string, encryptionKey: string) => string;
+export {};
+//# sourceMappingURL=crypto.functions.d.ts.map

package/dist/esm/functions/crypto.functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.functions.d.ts","sourceRoot":"","sources":["../../../src/functions/crypto.functions.ts"],"names":[],"mappings":"AAEA,KAAK,SAAS,GAAG,KAAK,CAAE;AACxB,KAAK,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEjC,eAAO,MAAM,mBAAmB,GAAI,WAAW,MAAM,KAAG,MAGrD,CAAA;AAED,eAAO,MAAM,2BAA2B,GACtC,YAAY,MAAM,EAClB,YAAY,MAAM,GAAG,SAAS,EAC9B,UAAS,OAAiB,EAC1B,YAAW,SAAiB,KAC7B,MAWA,CAAA;AAEH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,eAAe,MAAM,KAAG;IAC9D,aAAa,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CAoBnB,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,eAAe,MAAM,EAAE,IAAI,MAAM,EAAE,SAAS,MAAM,EAAE,eAAe,MAAM,KAAG,MAgBvG,CAAA"}

package/dist/esm/functions/crypto.functions.js

@@ -0,0 +1,48 @@
+import * as crypto from 'crypto';
+export const generatePublicKeyId = (publicKey) => {
+    // Generate a hash of the public key
+    return crypto.createHash('sha256').update(publicKey).digest('hex');
+};
+export const generateDecryptedPrivateKey = (privateKey, passphrase, keyType = 'pkcs8', keyFormat = 'pem') => {
+    const decryptedPrivateKey = crypto.createPrivateKey({
+        key: privateKey,
+        format: keyFormat,
+        type: keyType,
+        passphrase: passphrase,
+    });
+    return decryptedPrivateKey.export({ format: keyFormat, type: keyType }).toString();
+};
+export const encryptData = (data, encryptionKey) => {
+    try {
+        const key = Buffer.from(encryptionKey, 'hex');
+        const iv = crypto.randomBytes(16);
+        const cipher = crypto.createCipheriv('aes-256-gcm', key, iv);
+        let encryptedData = cipher.update(data, 'utf8', 'hex');
+        encryptedData += cipher.final('hex');
+        const authTag = cipher.getAuthTag().toString('hex');
+        return {
+            encryptedData,
+            iv: iv.toString('hex'),
+            authTag
+        };
+    }
+    catch (error) {
+        throw new Error('Error encrypting data: ' + error.message);
+    }
+};
+export const decryptData = (encryptedData, iv, authTag, encryptionKey) => {
+    try {
+        const key = Buffer.from(encryptionKey, 'hex');
+        const ivBuffer = Buffer.from(iv, 'hex');
+        const authTagBuffer = Buffer.from(authTag, 'hex');
+        const decipher = crypto.createDecipheriv('aes-256-gcm', key, ivBuffer);
+        decipher.setAuthTag(authTagBuffer);
+        let decryptedData = decipher.update(encryptedData, 'hex', 'utf8');
+        decryptedData += decipher.final('utf8');
+        return decryptedData;
+    }
+    catch (error) {
+        throw new Error('Error decrypting data: ' + error.message);
+    }
+};
+//# sourceMappingURL=crypto.functions.js.map

package/dist/esm/functions/crypto.functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.functions.js","sourceRoot":"","sources":["../../../src/functions/crypto.functions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAKjC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAiB,EAAU,EAAE;IAC7D,oCAAoC;IACpC,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACrE,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,UAAkB,EAClB,UAA8B,EAC9B,UAAmB,OAAO,EAC1B,YAAuB,KAAK,EACtB,EAAE;IAER,MAAM,mBAAmB,GAAG,MAAM,CAAC,gBAAgB,CAAC;QAChD,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,UAAU;KACrB,CAAC,CAAC;IAEH,OAAO,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;AAEzF,CAAC,CAAA;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,aAAqB,EAI1D,EAAE;IACH,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QAC9C,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAElC,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC7D,IAAI,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACvD,aAAa,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAErC,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAEpD,OAAO;YACP,aAAa;YACb,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;YACtB,OAAO;SACN,CAAC;IACN,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/D,CAAC;AACL,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,aAAqB,EAAE,EAAU,EAAE,OAAe,EAAE,aAAqB,EAAU,EAAE;IAC7G,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAElD,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QACvE,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;QAEnC,IAAI,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAClE,aAAa,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAExC,OAAO,aAAa,CAAC;IACzB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/D,CAAC;AACL,CAAC,CAAA"}

package/dist/esm/functions/helper.functions.d.ts

@@ -0,0 +1,10 @@
+/**
+   * 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;
+//# sourceMappingURL=helper.functions.d.ts.map

package/dist/esm/functions/helper.functions.d.ts.map

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

package/dist/esm/functions/helper.functions.js

@@ -0,0 +1,32 @@
+/**
+   * 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;
+};
+//# sourceMappingURL=helper.functions.js.map

package/dist/esm/functions/helper.functions.js.map

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

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

@@ -0,0 +1,4 @@
+export * from './helper.functions';
+export * from './request.functions';
+export * from './crypto.functions';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/functions/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/esm/functions/index.js

@@ -0,0 +1,5 @@
+// Functions Barrel - Auto-exports all functions
+export * from './helper.functions';
+export * from './request.functions';
+export * from './crypto.functions';
+//# sourceMappingURL=index.js.map

package/dist/esm/functions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/functions/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/esm/functions/request.functions.d.ts

@@ -0,0 +1,14 @@
+import { AllowedAppRequestHeaders, ExtendedAppRequest } from "../interfaces/request.interface";
+export declare const extractTokenFromHeader: (request: Request, tokenName: keyof AllowedAppRequestHeaders) => string | undefined;
+export declare const getIpFromRequest: (request: Request | ExtendedAppRequest) => string | null;
+/**
+ * Anonymize IP address for privacy compliance (GDPR/CCPA)
+ * Removes last octet for IPv4, last 80 bits for IPv6
+ */
+export declare const anonymizeIp: (ip: string | null) => string | null;
+export declare const getTenantFromStripeRequest: (req: Request) => {
+    tenantId: string;
+    isTestnet: boolean;
+} | undefined;
+export declare const setRequestValue: (request: Request, key: keyof ExtendedAppRequest, value: any) => void;
+//# sourceMappingURL=request.functions.d.ts.map

package/dist/esm/functions/request.functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.functions.d.ts","sourceRoot":"","sources":["../../../src/functions/request.functions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAI/F,eAAO,MAAM,sBAAsB,GAAI,SAAS,OAAO,EAAE,WAAW,MAAM,wBAAwB,KAAG,MAAM,GAAG,SAI3G,CAAA;AAGH,eAAO,MAAM,gBAAgB,GAAI,SAAS,OAAO,GAAG,kBAAkB,KAAG,MAAM,GAAG,IAejF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,GAAG,IAAI,KAAG,MAAM,GAAG,IAoBxD,CAAA;AAED,eAAO,MAAM,0BAA0B,GAAI,KAAK,OAAO;cASnB,MAAM;eACJ,OAAO;aAE5C,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,SAAS,OAAO,EAAE,KAAK,MAAM,kBAAkB,EAAE,OAAO,GAAG,SAE1F,CAAA"}

package/dist/esm/functions/request.functions.js

@@ -0,0 +1,61 @@
+export const extractTokenFromHeader = (request, tokenName) => {
+    // get key from header
+    const token = request?.headers ? (request?.headers)[tokenName] || '' : '';
+    return token;
+};
+// Enhanced IP extraction with better proxy support
+export const getIpFromRequest = (request) => {
+    // Try multiple IP sources in order of preference
+    const ip = request.ip ||
+        request.headers['x-forwarded-for']?.split(',')[0]?.trim() ||
+        request.headers['x-real-ip']?.trim() ||
+        request.connection?.remoteAddress?.trim() ||
+        request.socket?.remoteAddress?.trim() ||
+        null;
+    // Clean IPv6 mapped IPv4 addresses
+    if (ip?.startsWith('::ffff:')) {
+        return ip.substring(7);
+    }
+    return ip;
+};
+/**
+ * Anonymize IP address for privacy compliance (GDPR/CCPA)
+ * Removes last octet for IPv4, last 80 bits for IPv6
+ */
+export const anonymizeIp = (ip) => {
+    if (!ip)
+        return null;
+    // IPv4 anonymization - remove last octet
+    if (ip.includes('.') && !ip.includes(':')) {
+        const parts = ip.split('.');
+        if (parts.length === 4) {
+            return `${parts[0]}.${parts[1]}.${parts[2]}.0`;
+        }
+    }
+    // IPv6 anonymization - remove last 80 bits (keep first 48 bits)
+    if (ip.includes(':')) {
+        const parts = ip.split(':');
+        if (parts.length >= 3) {
+            return `${parts[0]}:${parts[1]}:${parts[2]}::`;
+        }
+    }
+    return ip; // Return as-is if format not recognized
+};
+export const getTenantFromStripeRequest = (req) => {
+    const sig = req?.headers ? (req?.headers)['stripe-signature'] || '' : '';
+    if (!sig)
+        return;
+    const body = req?.body;
+    const data = body?.data;
+    const object = data?.object;
+    const metadata = object?.metadata;
+    return {
+        tenantId: metadata?.tenantId,
+        isTestnet: metadata?.isTestnet,
+    };
+};
+export const setRequestValue = (request, key, value) => {
+    if (request)
+        request[key] = value;
+};
+//# sourceMappingURL=request.functions.js.map

package/dist/esm/functions/request.functions.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,7 @@
+export * from './enum';
+export * from './value-objects';
+export * from './functions';
+export * from './interfaces';
+export * from './types';
+export * from './dto';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,12 @@
+// 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 './enum';
+export * from './value-objects';
+export * from './functions';
+export * from './interfaces';
+export * from './types';
+export * from './dto';
+// Note: Architecture patterns (orchestrators, database schemas) moved to @explorins/pers-shared-patterns
+// This library now contains only pure data contracts safe for external consumption
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8FAA8F;AAE9F,wBAAwB;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AAGtB,yGAAyG;AACzG,mFAAmF"}

package/dist/esm/interfaces/audit-metadata.interface.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Audit Metadata Interface
+ *
+ * Standardized interface for all audit information across the PERS platform.
+ * This interface should be used consistently across all domains for audit tracking.
+ */
+export interface AuditMetadata {
+    createdAt: string;
+    requestId: string;
+    clientVersion?: string;
+    userAgent?: string;
+    ipAddress?: string;
+    userId?: string;
+    businessId?: string;
+    location?: {
+        country?: string;
+        region?: string;
+        city?: string;
+    };
+    sessionId?: string;
+    correlationId?: string;
+    customMetadata?: Record<string, any>;
+    securityContext?: {
+        riskScore?: number;
+        sensitiveOperation?: boolean;
+        complianceLevel?: 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+    };
+}
+/**
+ * Financial Audit Metadata Extension
+ *
+ * Specialized metadata for financial operations requiring enhanced audit trails.
+ */
+export interface FinancialAuditMetadata extends AuditMetadata {
+    financial: {
+        amount: number;
+        currency: string;
+        transactionType: 'TRANSFER' | 'MINT' | 'BURN' | 'APPROVE' | 'STAKE' | 'UNSTAKE';
+        riskScore: number;
+        highValueFlag?: boolean;
+        crossBorderFlag?: boolean;
+        regulatoryFlags?: string[];
+    };
+}
+/**
+ * Authentication Audit Metadata Extension
+ *
+ * Specialized metadata for authentication and authorization events.
+ */
+export interface AuthAuditMetadata extends AuditMetadata {
+    authentication: {
+        loginMethod: 'EMAIL_PASSWORD' | 'OAUTH' | 'MFA' | 'SSO' | 'API_KEY';
+        securityLevel: 'LOW' | 'MEDIUM' | 'HIGH';
+        mfaUsed: boolean;
+        deviceFingerprint?: string;
+        successfulAttempt: boolean;
+        failureReason?: string;
+        previousLoginAt?: string;
+    };
+}
+/**
+ * Administrative Audit Metadata Extension
+ *
+ * Specialized metadata for administrative operations.
+ */
+export interface AdminAuditMetadata extends AuditMetadata {
+    administrative: {
+        actionType: string;
+        targetEntity: string;
+        targetEntityId: string;
+        adminLevel: 'SUPPORT' | 'ADMIN' | 'SUPER_ADMIN';
+        approvalRequired: boolean;
+        approvedBy?: string;
+        justification?: string;
+    };
+}
+//# sourceMappingURL=audit-metadata.interface.d.ts.map

package/dist/esm/interfaces/audit-metadata.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-metadata.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/audit-metadata.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAE5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAGlB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IAGF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAGrC,eAAe,CAAC,EAAE;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,eAAe,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;KAC1D,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC3D,SAAS,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;QAChF,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,cAAc,EAAE;QACd,WAAW,EAAE,gBAAgB,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;QACpE,aAAa,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QACzC,OAAO,EAAE,OAAO,CAAC;QACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,iBAAiB,EAAE,OAAO,CAAC;QAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,cAAc,EAAE;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;QAChD,gBAAgB,EAAE,OAAO,CAAC;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH"}

package/dist/esm/interfaces/audit-metadata.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=audit-metadata.interface.js.map

package/dist/esm/interfaces/audit-metadata.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-metadata.interface.js","sourceRoot":"","sources":["../../../src/interfaces/audit-metadata.interface.ts"],"names":[],"mappings":""}

package/dist/esm/interfaces/geolocation-result.interface.d.ts

@@ -0,0 +1,12 @@
+export interface GeoLocationResult {
+    country_code: string;
+    country_name: string;
+    region_code: string;
+    region_name: string;
+    city_name: string;
+    postal_code: string;
+    latitude: number;
+    longitude: number;
+    accuracy_radius: number;
+}
+//# sourceMappingURL=geolocation-result.interface.d.ts.map

package/dist/esm/interfaces/geolocation-result.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geolocation-result.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/geolocation-result.interface.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/esm/interfaces/geolocation-result.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=geolocation-result.interface.js.map

package/dist/esm/interfaces/geolocation-result.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geolocation-result.interface.js","sourceRoot":"","sources":["../../../src/interfaces/geolocation-result.interface.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,16 @@
+export * from './audit-metadata.interface';
+export * from './transaction-account-data.interface';
+export * from './stripe-payment-intent-metadata.interface';
+export * from './request.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 './transaction-actor.interface';
+export * from './wallet-signing-scenario.interface';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/index.ts"],"names":[],"mappings":"AACA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AACrD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,qBAAqB,CAAC;AACpC,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,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC"}

package/dist/esm/interfaces/index.js

@@ -0,0 +1,17 @@
+// Interfaces Barrel - Auto-exports all interfaces
+export * from './audit-metadata.interface';
+export * from './transaction-account-data.interface';
+export * from './stripe-payment-intent-metadata.interface';
+export * from './request.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 './transaction-actor.interface';
+export * from './wallet-signing-scenario.interface';
+//# sourceMappingURL=index.js.map

package/dist/esm/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AACrD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,qBAAqB,CAAC;AACpC,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,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC"}