@explorins/pers-shared 2.1.0

package/dist/esm/types/unique-user-identifier-keys.js

@@ -0,0 +1,107 @@
+// Define the keys as a constant array
+const uniqueUserIdentifierKeysArray = [
+    'id',
+    'email',
+    'instagramAccountId',
+    'externalId', // This is a special key that can be used to search all fields
+];
+// Export the array
+export const uniqueUserIdentifierKeys = [...uniqueUserIdentifierKeysArray];
+// Define identifier type configurations
+const identifierTypes = {
+    id: {
+        key: 'id',
+        detect: () => false, // ID is not auto-detected from wildcards
+        process: (value) => value
+    },
+    email: {
+        key: 'email',
+        detect: (value) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value),
+        process: (value) => value
+    },
+    instagramAccountId: {
+        key: 'instagramAccountId',
+        detect: (value) => /^@/.test(value) || value.toLowerCase().includes('instagram'),
+        process: (value) => value.replace(/^@/, '') // Remove @ if present for consistency
+    },
+    externalId: {
+        key: 'externalId',
+        detect: () => true, // Default fallback
+        process: (value) => value
+    }
+};
+/**
+ * Register a new identifier type configuration
+ * @param key The identifier key
+ * @param config The identifier configuration (without the key)
+ */
+export const registerIdentifierType = (key, config) => {
+    if (!uniqueUserIdentifierKeysArray.includes(key)) {
+        console.warn(`Warning: Registering identifier type '${key}' that is not in uniqueUserIdentifierKeys`);
+    }
+    identifierTypes[key] = {
+        key,
+        ...config
+    };
+};
+/**
+ * Detects the type of identifier from a wildcard input
+ * @param wildcardValue The value to analyze
+ * @returns Object containing the type and processed value
+ */
+export const detectIdentifierType = (wildcardValue) => {
+    if (wildcardValue === null || wildcardValue === undefined) {
+        return { type: 'externalId', value: '' };
+    }
+    const value = String(wildcardValue);
+    // Try each identifier type in priority order
+    for (const type of ['email', 'instagramAccountId', 'externalId']) {
+        const config = identifierTypes[type];
+        if (config.detect(value)) {
+            return { type, value: config.process(value) };
+        }
+    }
+    // Default fallback should never be reached due to externalId's detect always returning true
+    return { type: 'externalId', value };
+};
+/**
+ * Checks if an object is a properly formed UserIdentifierObject
+ * @param obj Object to check
+ * @returns Boolean indicating if the object is a UserIdentifierObject
+ */
+export const isUserIdentifierObject = (obj) => {
+    return obj &&
+        obj.type === 'identifierObject' &&
+        uniqueUserIdentifierKeys.every(key => key in obj);
+};
+/**
+ * Creates a UserIdentifierObject with all required fields, setting missing values to null
+ * @param params Partial parameters for the identifier object
+ * @returns A properly formed UserIdentifierObject
+ */
+export const createUserIdentifierObject = (params) => {
+    // Extract the wildcard or use empty string
+    const wildcard = params.wildcard || '';
+    // Create base object with all identifier fields set to null
+    const identifierObject = {
+        type: 'identifierObject',
+        id: null,
+        email: null,
+        instagramAccountId: null,
+        externalId: null,
+        wildcard
+    };
+    // Override nulls with any provided values
+    uniqueUserIdentifierKeys.forEach(key => {
+        if (params[key]) {
+            identifierObject[key] = params[key];
+        }
+    });
+    // If wildcard is provided but no specific fields, auto-detect the field type
+    if (wildcard && !params.id && !params.email && !params.instagramAccountId && !params.externalId) {
+        const detected = detectIdentifierType(wildcard);
+        identifierObject[detected.type] = detected.value;
+    }
+    return identifierObject;
+};
+//# sourceMappingURL=unique-user-identifier-keys.js.map

package/dist/esm/types/unique-user-identifier-keys.js.map

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

package/dist/esm/value-objects/account-token-balances.value-object.d.ts

@@ -0,0 +1,48 @@
+import { Address } from './address.value-object';
+import { TokenBalance } from './token-balance.value-object';
+/**
+ * Value object representing the token balances for a specific account.
+ */
+export declare class AccountTokenBalances {
+    private readonly accountAddress;
+    private readonly tokenBalances;
+    /**
+     * Constructs a new AccountTokenBalances value object.
+     *
+     * @param {Address} accountAddress - The account address.
+     * @param {TokenBalance[]} tokenBalances - Array of TokenBalance objects.
+     */
+    constructor(accountAddress: Address, tokenBalances: TokenBalance[]);
+    /**
+     * Gets the account address.
+     *
+     * @returns {Address} The account address.
+     */
+    getAccountAddress(): Address;
+    /**
+     * Gets the token balances for the account.
+     *
+     * @returns {TokenBalance[]} The array of token balances.
+     */
+    getTokenBalances(): TokenBalance[];
+    /**
+     * Adds a new token balance to the account.
+     *
+     * @param {TokenBalance} tokenBalance - The TokenBalance to add.
+     */
+    addTokenBalance(tokenBalance: TokenBalance): void;
+    /**
+     * Returns a string representation of the account and its token balances.
+     *
+     * @returns {string} A formatted string showing the account address and token balances.
+     */
+    toString(): string;
+    /**
+     * Compares this AccountTokenBalances with another AccountTokenBalances instance for equality.
+     *
+     * @param {AccountTokenBalances} other - The other AccountTokenBalances instance to compare with.
+     * @returns {boolean} True if the two instances are equal, false otherwise.
+     */
+    equals(other: AccountTokenBalances): boolean;
+}
+//# sourceMappingURL=account-token-balances.value-object.d.ts.map

package/dist/esm/value-objects/account-token-balances.value-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-token-balances.value-object.d.ts","sourceRoot":"","sources":["../../../src/value-objects/account-token-balances.value-object.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAG5D;;GAEG;AACH,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAE/C;;;;;OAKG;gBACS,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE;IAKlE;;;;OAIG;IACI,iBAAiB,IAAI,OAAO;IAInC;;;;OAIG;IACI,gBAAgB,IAAI,YAAY,EAAE;IAIzC;;;;OAIG;IACI,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI;IAIxD;;;;OAIG;IACI,QAAQ,IAAI,MAAM;IAIzB;;;;;OAKG;IACI,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO;CAKtD"}

package/dist/esm/value-objects/account-token-balances.value-object.js

@@ -0,0 +1,62 @@
+// Assuming TokenBalance is in a separate file
+/**
+ * Value object representing the token balances for a specific account.
+ */
+export class AccountTokenBalances {
+    accountAddress;
+    tokenBalances;
+    /**
+     * Constructs a new AccountTokenBalances value object.
+     *
+     * @param {Address} accountAddress - The account address.
+     * @param {TokenBalance[]} tokenBalances - Array of TokenBalance objects.
+     */
+    constructor(accountAddress, tokenBalances) {
+        this.accountAddress = accountAddress;
+        this.tokenBalances = tokenBalances;
+    }
+    /**
+     * Gets the account address.
+     *
+     * @returns {Address} The account address.
+     */
+    getAccountAddress() {
+        return this.accountAddress;
+    }
+    /**
+     * Gets the token balances for the account.
+     *
+     * @returns {TokenBalance[]} The array of token balances.
+     */
+    getTokenBalances() {
+        return this.tokenBalances;
+    }
+    /**
+     * Adds a new token balance to the account.
+     *
+     * @param {TokenBalance} tokenBalance - The TokenBalance to add.
+     */
+    addTokenBalance(tokenBalance) {
+        this.tokenBalances.push(tokenBalance);
+    }
+    /**
+     * Returns a string representation of the account and its token balances.
+     *
+     * @returns {string} A formatted string showing the account address and token balances.
+     */
+    toString() {
+        return `AccountTokenBalances: [Account: ${this.accountAddress.getValue()}, Balances: [${this.tokenBalances.map(tb => tb.toString()).join(', ')}]]`;
+    }
+    /**
+     * Compares this AccountTokenBalances with another AccountTokenBalances instance for equality.
+     *
+     * @param {AccountTokenBalances} other - The other AccountTokenBalances instance to compare with.
+     * @returns {boolean} True if the two instances are equal, false otherwise.
+     */
+    equals(other) {
+        return this.accountAddress.equals(other.getAccountAddress()) &&
+            this.tokenBalances.length === other.getTokenBalances().length &&
+            this.tokenBalances.every((tb, index) => tb.equals(other.getTokenBalances()[index]));
+    }
+}
+//# sourceMappingURL=account-token-balances.value-object.js.map

package/dist/esm/value-objects/account-token-balances.value-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-token-balances.value-object.js","sourceRoot":"","sources":["../../../src/value-objects/account-token-balances.value-object.ts"],"names":[],"mappings":"AAGC,8CAA8C;AAE/C;;GAEG;AACH,MAAM,OAAO,oBAAoB;IACZ,cAAc,CAAU;IACxB,aAAa,CAAiB;IAE/C;;;;;OAKG;IACH,YAAY,cAAuB,EAAE,aAA6B;QAC9D,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACI,iBAAiB;QACpB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACI,gBAAgB;QACnB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACI,eAAe,CAAC,YAA0B;QAC7C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACI,QAAQ;QACX,OAAO,mCAAmC,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,gBAAgB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACvJ,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,KAA2B;QACrC,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC;YACxD,IAAI,CAAC,aAAa,CAAC,MAAM,KAAK,KAAK,CAAC,gBAAgB,EAAE,CAAC,MAAM;YAC7D,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5F,CAAC;CACJ"}

package/dist/esm/value-objects/address.value-object.d.ts

@@ -0,0 +1,8 @@
+export declare class Address {
+    private readonly value;
+    constructor(value: string);
+    getValue(): string;
+    equals(other: Address): boolean;
+    private isValidAddress;
+}
+//# sourceMappingURL=address.value-object.d.ts.map

package/dist/esm/value-objects/address.value-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.value-object.d.ts","sourceRoot":"","sources":["../../../src/value-objects/address.value-object.ts"],"names":[],"mappings":"AAEA,qBAAa,OAAO;IAChB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,KAAK,EAAE,MAAM;IAOzB,QAAQ,IAAI,MAAM;IAIlB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAI/B,OAAO,CAAC,cAAc;CAIvB"}

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

@@ -0,0 +1,20 @@
+export class Address {
+    value;
+    constructor(value) {
+        if (!this.isValidAddress(value)) {
+            throw new Error('Invalid address for value: ' + value);
+        }
+        this.value = value;
+    }
+    getValue() {
+        return this.value;
+    }
+    equals(other) {
+        return this.value === other.value;
+    }
+    isValidAddress(value) {
+        // Add address validation logic here, for example, for Ethereum addresses
+        return value.length === 42 && value.startsWith('0x');
+    }
+}
+//# sourceMappingURL=address.value-object.js.map

package/dist/esm/value-objects/address.value-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.value-object.js","sourceRoot":"","sources":["../../../src/value-objects/address.value-object.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,OAAO;IACC,KAAK,CAAS;IAE/B,YAAY,KAAa;QACvB,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,KAAK,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,KAAc;QACnB,OAAO,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC;IACpC,CAAC;IAEO,cAAc,CAAC,KAAa;QAClC,yEAAyE;QACzE,OAAO,KAAK,CAAC,MAAM,KAAK,EAAE,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/esm/value-objects/index.d.ts

@@ -0,0 +1,8 @@
+export * from './address.value-object';
+export * from './token-balance.value-object';
+export * from './account-token-balances.value-object';
+export * from './token-unit.value-object';
+export * from './token-transaction-input.vo';
+export * from './token-transaction-entity-reference-input.vo';
+export * from './signed-tx-data.vo';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/value-objects/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/value-objects/index.ts"],"names":[],"mappings":"AACA,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uCAAuC,CAAC;AACtD,cAAc,2BAA2B,CAAC;AAG1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+CAA+C,CAAC;AAC9D,cAAc,qBAAqB,CAAC"}

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

@@ -0,0 +1,11 @@
+// Value Objects Barrel - Auto-exports all value objects
+export * from './address.value-object';
+export * from './token-balance.value-object';
+export * from './account-token-balances.value-object';
+export * from './token-unit.value-object';
+// Server build: Export full classes (needed for instantiation with 'new')
+// These use decorators but server environment can handle reflect-metadata
+export * from './token-transaction-input.vo';
+export * from './token-transaction-entity-reference-input.vo';
+export * from './signed-tx-data.vo';
+//# sourceMappingURL=index.js.map

package/dist/esm/value-objects/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/value-objects/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uCAAuC,CAAC;AACtD,cAAc,2BAA2B,CAAC;AAC1C,0EAA0E;AAC1E,0EAA0E;AAC1E,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+CAA+C,CAAC;AAC9D,cAAc,qBAAqB,CAAC"}

package/dist/esm/value-objects/signed-tx-data.vo.d.ts

@@ -0,0 +1,26 @@
+import { EIP712SignedTransactionData } from "@explorins/web3-ts/types";
+export declare class SignedTransactionDataVo {
+    private readonly _signedTransaction;
+    private readonly _signedSmartWalletTransaction;
+    private readonly _chainId;
+    private readonly _transactionId;
+    constructor(chainId: number, transactionId: string, signedTransaction?: string | null, signedSmartWalletTransaction?: EIP712SignedTransactionData | null);
+    get signedTransaction(): string | null;
+    get signedSmartWalletTransaction(): EIP712SignedTransactionData | null;
+    get chainId(): number;
+    get transactionId(): string;
+    equals(other: SignedTransactionDataVo): boolean;
+    static fromPlainObject(data: {
+        signedTransaction: string | null;
+        signedSmartWalletTransaction: EIP712SignedTransactionData | null;
+        chainId: number;
+        transactionId: string;
+    }): SignedTransactionDataVo;
+    toPlainObject(): {
+        signedTransaction: string | null;
+        signedSmartWalletTransaction: EIP712SignedTransactionData | null;
+        chainId: number;
+        transactionId: string;
+    };
+}
+//# sourceMappingURL=signed-tx-data.vo.d.ts.map

package/dist/esm/value-objects/signed-tx-data.vo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signed-tx-data.vo.d.ts","sourceRoot":"","sources":["../../../src/value-objects/signed-tx-data.vo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAGvE,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAuB;IAC1D,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAA4C;IAC1F,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAGtC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,iBAAiB,GAAE,MAAM,GAAG,IAAW,EACvC,4BAA4B,GAAE,2BAA2B,GAAG,IAAW;IAiCzE,IAAI,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAErC;IAED,IAAI,4BAA4B,IAAI,2BAA2B,GAAG,IAAI,CAErE;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAGD,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO;IAS/C,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE;QAC3B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,4BAA4B,EAAE,2BAA2B,GAAG,IAAI,CAAC;QACjE,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;KACvB,GAAG,uBAAuB;IAW3B,aAAa,IAAI;QACf,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,4BAA4B,EAAE,2BAA2B,GAAG,IAAI,CAAC;QACjE,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;KACvB;CAQF"}

package/dist/esm/value-objects/signed-tx-data.vo.js

@@ -0,0 +1,65 @@
+export class SignedTransactionDataVo {
+    _signedTransaction = null;
+    _signedSmartWalletTransaction = null;
+    _chainId;
+    _transactionId;
+    constructor(chainId, transactionId, signedTransaction = null, signedSmartWalletTransaction = null) {
+        // Validation
+        if (!chainId || typeof chainId !== 'number' || chainId <= 0) {
+            throw new Error('Chain ID must be a positive number');
+        }
+        if (!transactionId || typeof transactionId !== 'string' || !transactionId.trim()) {
+            throw new Error('Transaction ID must be a non-empty string');
+        }
+        if (signedTransaction && signedSmartWalletTransaction) {
+            throw new Error('Only one of signedTransaction or signedSmartWalletTransaction should be provided');
+        }
+        if (signedSmartWalletTransaction) {
+            this._signedSmartWalletTransaction = signedSmartWalletTransaction;
+        }
+        else if (signedTransaction) {
+            // Normalize the transaction data (ensure 0x prefix)
+            this._signedTransaction = signedTransaction.startsWith('0x')
+                ? signedTransaction
+                : `0x${signedTransaction}`;
+        }
+        else {
+            throw new Error('Signed transaction must be a non-empty');
+        }
+        this._transactionId = transactionId;
+        this._chainId = chainId;
+    }
+    // Getters
+    get signedTransaction() {
+        return this._signedTransaction;
+    }
+    get signedSmartWalletTransaction() {
+        return this._signedSmartWalletTransaction;
+    }
+    get chainId() {
+        return this._chainId;
+    }
+    get transactionId() {
+        return this._transactionId;
+    }
+    // Equality comparison
+    equals(other) {
+        return (this.signedTransaction === other.signedTransaction &&
+            this.chainId === other.chainId &&
+            this.transactionId === other.transactionId);
+    }
+    // Create a new instance from plain object data
+    static fromPlainObject(data) {
+        return new SignedTransactionDataVo(data.chainId, data.transactionId, data.signedTransaction, data.signedSmartWalletTransaction);
+    }
+    // Convert to plain object (useful for serialization)
+    toPlainObject() {
+        return {
+            signedTransaction: this.signedTransaction,
+            signedSmartWalletTransaction: this.signedSmartWalletTransaction,
+            chainId: this.chainId,
+            transactionId: this.transactionId,
+        };
+    }
+}
+//# sourceMappingURL=signed-tx-data.vo.js.map

package/dist/esm/value-objects/signed-tx-data.vo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signed-tx-data.vo.js","sourceRoot":"","sources":["../../../src/value-objects/signed-tx-data.vo.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,uBAAuB;IACjB,kBAAkB,GAAkB,IAAI,CAAC;IACzC,6BAA6B,GAAuC,IAAI,CAAC;IACzE,QAAQ,CAAS;IACjB,cAAc,CAAS;IAExC,YACE,OAAe,EACf,aAAqB,EACrB,oBAAmC,IAAI,EACvC,+BAAmE,IAAI;QAEvE,aAAa;QAEb,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,CAAC,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC;YACjF,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QAED,IAAG,iBAAiB,IAAI,4BAA4B,EAAC,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;QACtG,CAAC;QAED,IAAG,4BAA4B,EAAE,CAAC;YAChC,IAAI,CAAC,6BAA6B,GAAG,4BAA4B,CAAC;QACpE,CAAC;aAAM,IAAG,iBAAiB,EAAE,CAAC;YAC5B,oDAAoD;YACpD,IAAI,CAAC,kBAAkB,GAAG,iBAAiB,CAAC,UAAU,CAAC,IAAI,CAAC;gBAC1D,CAAC,CAAC,iBAAiB;gBACnB,CAAC,CAAC,KAAK,iBAAiB,EAAE,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAE1B,CAAC;IAED,UAAU;IACV,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED,IAAI,4BAA4B;QAC9B,OAAO,IAAI,CAAC,6BAA6B,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,sBAAsB;IACtB,MAAM,CAAC,KAA8B;QACnC,OAAO,CACL,IAAI,CAAC,iBAAiB,KAAK,KAAK,CAAC,iBAAiB;YAClD,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO;YAC9B,IAAI,CAAC,aAAa,KAAK,KAAK,CAAC,aAAa,CAC3C,CAAC;IACJ,CAAC;IAED,+CAA+C;IAC/C,MAAM,CAAC,eAAe,CAAC,IAKtB;QACC,OAAO,IAAI,uBAAuB,CAEhC,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,iBAAiB,EACtB,IAAI,CAAC,4BAA4B,CAClC,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,aAAa;QAMX,OAAO;YACL,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,4BAA4B,EAAE,IAAI,CAAC,4BAA4B;YAC/D,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/value-objects/token-balance.value-object.d.ts

@@ -0,0 +1,90 @@
+import { NativeTokenType } from '../types/native-token.type';
+import { Address } from './address.value-object';
+/**
+ * Value object representing the token balance details.
+ */
+export declare class TokenBalance {
+    private readonly chainId;
+    private readonly smartContractAddress;
+    private readonly tokenId;
+    private readonly metadataUri;
+    private readonly balance;
+    private readonly tokenName;
+    private readonly tokenSymbol;
+    private readonly tokenType;
+    /**
+     * Constructs a new TokenBalance value object.
+     *
+     * @param {number} chainId - The chain ID of the blockchain.
+     * @param {Address} smartContractAddress - The smart contract address of the token.
+     * @param {string | null} tokenId - The ID of the token (can be null for certain token types).
+     * @param {number} balance - The balance of the token.
+     * @param {string} metadataUri - The URI of the token (optional).
+     * @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).
+     */
+    constructor(chainId: number, smartContractAddress: Address, tokenId: string | null | undefined, metadataUri: string | null | undefined, balance: number, tokenName: string, tokenSymbol: string, tokenType: NativeTokenType);
+    /**
+     * Gets the chain ID.
+     *
+     * @returns {number} The chain ID.
+     */
+    getChainId(): number;
+    /**
+     * Gets the smart contract address.
+     *
+     * @returns {Address} The smart contract address.
+     */
+    getSmartContractAddress(): Address;
+    /**
+     * Gets the token ID.
+     *
+     * @returns {string | null} The token ID (or null if not applicable).
+     */
+    getTokenId(): string | null;
+    /**
+     * Gets the token URI.
+     *
+     * @returns {string | null} The token URI (or null if not applicable).
+     */
+    getMetadataUri(): string | null;
+    /**
+     * Gets the balance of the token.
+     *
+     * @returns {number} The token balance.
+     */
+    getBalance(): number;
+    /**
+     * Gets the name of the token.
+     *
+     * @returns {string} The name of the token.
+     */
+    getTokenName(): string;
+    /**
+     * Gets the symbol of the token.
+     *
+     * @returns {string} The symbol of the token.
+     */
+    getTokenSymbol(): string;
+    /**
+     * Gets the type of the token.
+     *
+     * @returns {NativeTokenType} The type of the token (e.g., ERC20, ERC721).
+     */
+    getTokenType(): NativeTokenType;
+    /**
+     * Returns a string representation of the TokenBalance.
+     *
+     * @returns {string} A formatted string showing the token balance parameters.
+     */
+    toString(): string;
+    /**
+     * Compares this TokenBalance with another TokenBalance instance for equality.
+     *
+     * @param {TokenBalance} other - The other TokenBalance instance to compare with.
+     * @returns {boolean} True if the two instances are equal, false otherwise.
+     */
+    equals(other: TokenBalance): boolean;
+}
+//# sourceMappingURL=token-balance.value-object.d.ts.map

package/dist/esm/value-objects/token-balance.value-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-balance.value-object.d.ts","sourceRoot":"","sources":["../../../src/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"}

package/dist/esm/value-objects/token-balance.value-object.js

@@ -0,0 +1,124 @@
+/**
+ * Value object representing the token balance details.
+ */
+export class TokenBalance {
+    chainId;
+    smartContractAddress;
+    tokenId;
+    metadataUri;
+    balance;
+    tokenName;
+    tokenSymbol;
+    tokenType;
+    /**
+     * Constructs a new TokenBalance value object.
+     *
+     * @param {number} chainId - The chain ID of the blockchain.
+     * @param {Address} smartContractAddress - The smart contract address of the token.
+     * @param {string | null} tokenId - The ID of the token (can be null for certain token types).
+     * @param {number} balance - The balance of the token.
+     * @param {string} metadataUri - The URI of the token (optional).
+     * @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).
+     */
+    constructor(chainId, smartContractAddress, tokenId = null, metadataUri = null, balance, tokenName, tokenSymbol, tokenType // = NativeTokenType.ERC20 // Default value set to ERC20
+    ) {
+        this.chainId = chainId;
+        this.smartContractAddress = smartContractAddress;
+        this.tokenId = tokenId;
+        this.metadataUri = metadataUri;
+        this.balance = balance;
+        this.tokenName = tokenName;
+        this.tokenSymbol = tokenSymbol;
+        this.tokenType = tokenType;
+    }
+    /**
+     * Gets the chain ID.
+     *
+     * @returns {number} The chain ID.
+     */
+    getChainId() {
+        return this.chainId;
+    }
+    /**
+     * Gets the smart contract address.
+     *
+     * @returns {Address} The smart contract address.
+     */
+    getSmartContractAddress() {
+        return this.smartContractAddress;
+    }
+    /**
+     * Gets the token ID.
+     *
+     * @returns {string | null} The token ID (or null if not applicable).
+     */
+    getTokenId() {
+        return this.tokenId;
+    }
+    /**
+     * Gets the token URI.
+     *
+     * @returns {string | null} The token URI (or null if not applicable).
+     */
+    getMetadataUri() {
+        return this.metadataUri;
+    }
+    /**
+     * Gets the balance of the token.
+     *
+     * @returns {number} The token balance.
+     */
+    getBalance() {
+        return this.balance;
+    }
+    /**
+     * Gets the name of the token.
+     *
+     * @returns {string} The name of the token.
+     */
+    getTokenName() {
+        return this.tokenName;
+    }
+    /**
+     * Gets the symbol of the token.
+     *
+     * @returns {string} The symbol of the token.
+     */
+    getTokenSymbol() {
+        return this.tokenSymbol;
+    }
+    /**
+     * Gets the type of the token.
+     *
+     * @returns {NativeTokenType} The type of the token (e.g., ERC20, ERC721).
+     */
+    getTokenType() {
+        return this.tokenType;
+    }
+    /**
+     * Returns a string representation of the TokenBalance.
+     *
+     * @returns {string} A formatted string showing the token balance parameters.
+     */
+    toString() {
+        return `TokenBalance: [ChainId: ${this.chainId}, SmartContract: ${this.smartContractAddress.getValue()}, TokenId: ${this.tokenId}, Balance: ${this.balance}, TokenName: ${this.tokenName}, TokenSymbol: ${this.tokenSymbol}, TokenType: ${this.tokenType}]`;
+    }
+    /**
+     * Compares this TokenBalance with another TokenBalance instance for equality.
+     *
+     * @param {TokenBalance} other - The other TokenBalance instance to compare with.
+     * @returns {boolean} True if the two instances are equal, false otherwise.
+     */
+    equals(other) {
+        return this.chainId === other.getChainId() &&
+            this.smartContractAddress.equals(other.getSmartContractAddress()) &&
+            this.tokenId === other.getTokenId() &&
+            this.balance === other.getBalance() &&
+            this.tokenName === other.getTokenName() &&
+            this.tokenSymbol === other.getTokenSymbol() &&
+            this.tokenType === other.getTokenType();
+    }
+}
+//# sourceMappingURL=token-balance.value-object.js.map

package/dist/esm/value-objects/token-balance.value-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-balance.value-object.js","sourceRoot":"","sources":["../../../src/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"}