@provex/utils 1.2.3 → 1.2.4

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@provex/utils",
-  "version": "1.2.3",
-  "main": "dist/src/index.js",
-  "types": "dist/src/index.d.ts",
+  "version": "1.2.4",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "type": "module",
   "repository": {
     "type": "git",
@@ -14,100 +14,100 @@
   },
   "exports": {
     ".": {
-      "import": "./dist/src/index.js",
-      "types": "./dist/src/index.d.ts"
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
     },
     "./contracts": {
-      "import": "./dist/src/contracts.js",
-      "types": "./dist/src/contracts.d.ts"
+      "import": "./dist/contracts.js",
+      "types": "./dist/contracts.d.ts"
     },
     "./currencies": {
-      "import": "./dist/src/currencies.js",
-      "types": "./dist/src/currencies.d.ts"
+      "import": "./dist/currencies.js",
+      "types": "./dist/currencies.d.ts"
     },
     "./units": {
-      "import": "./dist/src/units.js",
-      "types": "./dist/src/units.d.ts"
+      "import": "./dist/units.js",
+      "types": "./dist/units.d.ts"
     },
     "./payment": {
-      "import": "./dist/src/payment.js",
-      "types": "./dist/src/payment.d.ts"
+      "import": "./dist/payment.js",
+      "types": "./dist/payment.d.ts"
     },
     "./sort": {
-      "import": "./dist/src/sort.js",
-      "types": "./dist/src/sort.d.ts"
+      "import": "./dist/sort.js",
+      "types": "./dist/sort.d.ts"
     },
     "./time": {
-      "import": "./dist/src/time.js",
-      "types": "./dist/src/time.d.ts"
+      "import": "./dist/time.js",
+      "types": "./dist/time.d.ts"
     },
     "./tokens": {
-      "import": "./dist/src/tokens.js",
-      "types": "./dist/src/tokens.d.ts"
+      "import": "./dist/tokens.js",
+      "types": "./dist/tokens.d.ts"
     },
     "./intent": {
-      "import": "./dist/src/intent.js",
-      "types": "./dist/src/intent.d.ts"
+      "import": "./dist/intent.js",
+      "types": "./dist/intent.d.ts"
     },
     "./conversionRates": {
-      "import": "./dist/src/conversionRates.js",
-      "types": "./dist/src/conversionRates.d.ts"
+      "import": "./dist/conversionRates.js",
+      "types": "./dist/conversionRates.d.ts"
     },
     "./json": {
-      "import": "./dist/src/json.js",
-      "types": "./dist/src/json.d.ts"
+      "import": "./dist/json.js",
+      "types": "./dist/json.d.ts"
     },
     "./profit": {
-      "import": "./dist/src/profit.js",
-      "types": "./dist/src/profit.d.ts"
+      "import": "./dist/profit.js",
+      "types": "./dist/profit.d.ts"
     },
     "./chain": {
-      "import": "./dist/src/chain.js",
-      "types": "./dist/src/chain.d.ts"
+      "import": "./dist/chain.js",
+      "types": "./dist/chain.d.ts"
     },
     "./participants": {
-      "import": "./dist/src/participants.js",
-      "types": "./dist/src/participants.d.ts"
+      "import": "./dist/participants.js",
+      "types": "./dist/participants.d.ts"
     },
     "./input": {
-      "import": "./dist/src/input.js",
-      "types": "./dist/src/input.d.ts"
+      "import": "./dist/input.js",
+      "types": "./dist/input.d.ts"
     },
     "./stats": {
-      "import": "./dist/src/stats.js",
-      "types": "./dist/src/stats.d.ts"
+      "import": "./dist/stats.js",
+      "types": "./dist/stats.d.ts"
     },
     "./stateKey": {
-      "import": "./dist/src/stateKey.js",
-      "types": "./dist/src/stateKey.d.ts"
+      "import": "./dist/stateKey.js",
+      "types": "./dist/stateKey.d.ts"
     },
     "./ids": {
-      "import": "./dist/src/ids.js",
-      "types": "./dist/src/ids.d.ts"
+      "import": "./dist/ids.js",
+      "types": "./dist/ids.d.ts"
     },
     "./events": {
-      "import": "./dist/src/events.js",
-      "types": "./dist/src/events.d.ts"
+      "import": "./dist/events.js",
+      "types": "./dist/events.d.ts"
     },
     "./peer-types": {
-      "import": "./dist/src/peer-types.js",
-      "types": "./dist/src/peer-types.d.ts"
+      "import": "./dist/peer-types.js",
+      "types": "./dist/peer-types.d.ts"
     },
     "./deposit": {
-      "import": "./dist/src/deposit.js",
-      "types": "./dist/src/deposit.d.ts"
+      "import": "./dist/deposit.js",
+      "types": "./dist/deposit.d.ts"
     },
     "./fees": {
-      "import": "./dist/src/fees.js",
-      "types": "./dist/src/fees.d.ts"
+      "import": "./dist/fees.js",
+      "types": "./dist/fees.d.ts"
     },
     "./reputation": {
-      "import": "./dist/src/reputation.js",
-      "types": "./dist/src/reputation.d.ts"
+      "import": "./dist/reputation.js",
+      "types": "./dist/reputation.d.ts"
     }
   },
   "scripts": {
-    "build": "tsx scripts/convert-svg && tsc && cp -r src/data dist/src/",
+    "build": "tsx scripts/convert-svg && tsc && cp -r src/data dist/",
     "test": "node --import tsx --test 'src/**/*.test.ts'",
     "test:watch": "node --import tsx --test --watch 'src/**/*.test.ts'",
     "test:coverage": "node --import tsx --test --experimental-test-coverage --test-coverage-exclude='src/**/*.test.ts' --test-coverage-exclude='src/data/**' --test-coverage-exclude='src/flags/**' --test-coverage-exclude='src/flags.ts' --test-coverage-exclude='src/global.d.ts' 'src/**/*.test.ts'"
@@ -132,4 +132,4 @@
     "typescript": "^5.9.2",
     "viem": "^2.38.0"
   }
-}
+}

package/dist/scripts/convert-svg.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/scripts/convert-svg.js

@@ -1,17 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-const __dirname = import.meta.dirname;
-// Read SVG files and convert to TypeScript constants
-const svgDir = path.join(__dirname, '../src/flags');
-const outputFile = path.join(__dirname, '../src/flags.ts');
-const svgFiles = ['usd.svg', 'eur.svg'];
-let output = '// Auto-generated from SVG files\n\n';
-svgFiles.forEach(filename => {
-    const svgPath = path.join(svgDir, filename);
-    const svgContent = fs.readFileSync(svgPath, 'utf8');
-    const cleanSvg = svgContent.replace(/[\r\n]/g, ' ').replace(/\s+/g, ' ').trim();
-    const constName = filename.replace('.svg', '').toUpperCase() + '_FLAG_SVG';
-    output += `export const ${constName} = '${cleanSvg}';\n`;
-});
-fs.writeFileSync(outputFile, output);
-console.log('Generated flags.ts from SVG files');

package/dist/src/endpoints.d.ts

@@ -1,51 +0,0 @@
-/**
- * Service endpoint URLs for the Provex platform.
- *
- * Each URL resolves at module load time using this priority:
- * 1. Vite env (`import.meta.env.VITE_<NAME>`)
- * 2. Node env (`process.env.<NAME>` or `process.env.VITE_<NAME>`)
- * 3. Hardcoded production default
- *
- * Override any URL by setting the corresponding environment variable
- * before the module is imported.
- *
- * @example
- * // In .env or shell
- * VITE_SPONSOR_SERVER_URL=http://localhost:3001
- */
-/**
- * Base URL for the gas-sponsorship relay server.
- *
- * The sponsor server wraps user operations in a sponsored transaction
- * so end-users never need native gas tokens.
- *
- * @defaultValue `https://sponsor.provex.xyz`
- */
-export declare const SPONSOR_SERVER_URL: string;
-/**
- * WebSocket URL for the Reclaim Protocol attestor node.
- *
- * Used during the ZK proof generation flow to obtain a TLS attestation
- * of payment-provider API responses.
- *
- * @defaultValue `wss://attestor.reclaimprotocol.org/ws`
- */
-export declare const ATTESTOR_WS_URL: string;
-/**
- * GraphQL endpoint for the Provex indexer.
- *
- * Serves deposit listings, intent history, and on-chain event data
- * consumed by the UI and analytics dashboard.
- *
- * @defaultValue `https://indexer.provex.xyz/graphql`
- */
-export declare const INDEXER_GRAPHQL_URL: string;
-/**
- * Base URL for the attestation verification service.
- *
- * Validates TLS attestations produced by the attestor before they
- * are submitted on-chain as proof of payment.
- *
- * @defaultValue `https://attestation.provex.xyz`
- */
-export declare const ATTESTATION_SERVICE_URL: string;

package/dist/src/endpoints.js

@@ -1,70 +0,0 @@
-/**
- * Service endpoint URLs for the Provex platform.
- *
- * Each URL resolves at module load time using this priority:
- * 1. Vite env (`import.meta.env.VITE_<NAME>`)
- * 2. Node env (`process.env.<NAME>` or `process.env.VITE_<NAME>`)
- * 3. Hardcoded production default
- *
- * Override any URL by setting the corresponding environment variable
- * before the module is imported.
- *
- * @example
- * // In .env or shell
- * VITE_SPONSOR_SERVER_URL=http://localhost:3001
- */
-/**
- * Read an environment variable from either Vite or Node runtime.
- *
- * Checks `import.meta.env.VITE_<name>` first (browser / Vite dev server),
- * then falls back to `process.env.<name>` and `process.env.VITE_<name>`
- * (Node / scripts).
- *
- * @param name - The bare variable name without the `VITE_` prefix.
- * @returns The value if found, otherwise `undefined`.
- */
-function readEnv(name) {
-    const viteVal = typeof import.meta !== 'undefined'
-        ? import.meta.env?.[`VITE_${name}`]
-        : undefined;
-    const nodeVal = typeof process !== 'undefined'
-        ? (process.env?.[name] ?? process.env?.[`VITE_${name}`])
-        : undefined;
-    return viteVal ?? nodeVal ?? undefined;
-}
-/**
- * Base URL for the gas-sponsorship relay server.
- *
- * The sponsor server wraps user operations in a sponsored transaction
- * so end-users never need native gas tokens.
- *
- * @defaultValue `https://sponsor.provex.xyz`
- */
-export const SPONSOR_SERVER_URL = readEnv('SPONSOR_SERVER_URL') ?? 'https://sponsor.provex.xyz';
-/**
- * WebSocket URL for the Reclaim Protocol attestor node.
- *
- * Used during the ZK proof generation flow to obtain a TLS attestation
- * of payment-provider API responses.
- *
- * @defaultValue `wss://attestor.reclaimprotocol.org/ws`
- */
-export const ATTESTOR_WS_URL = readEnv('ATTESTOR_WS_URL') ?? 'wss://attestor.reclaimprotocol.org/ws';
-/**
- * GraphQL endpoint for the Provex indexer.
- *
- * Serves deposit listings, intent history, and on-chain event data
- * consumed by the UI and analytics dashboard.
- *
- * @defaultValue `https://indexer.provex.xyz/graphql`
- */
-export const INDEXER_GRAPHQL_URL = readEnv('INDEXER_GRAPHQL_URL') ?? 'https://indexer.provex.xyz/graphql';
-/**
- * Base URL for the attestation verification service.
- *
- * Validates TLS attestations produced by the attestor before they
- * are submitted on-chain as proof of payment.
- *
- * @defaultValue `https://attestation.provex.xyz`
- */
-export const ATTESTATION_SERVICE_URL = readEnv('ATTESTATION_SERVICE_URL') ?? 'https://attestation.provex.xyz';

package/dist/src/endpoints.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/endpoints.test.js

@@ -1,54 +0,0 @@
-import { describe, it } from 'node:test';
-import assert from 'node:assert/strict';
-import { SPONSOR_SERVER_URL, ATTESTOR_WS_URL, INDEXER_GRAPHQL_URL, ATTESTATION_SERVICE_URL, } from './endpoints.js';
-describe('endpoints', () => {
-    const endpoints = [
-        { name: 'SPONSOR_SERVER_URL', value: SPONSOR_SERVER_URL },
-        { name: 'ATTESTOR_WS_URL', value: ATTESTOR_WS_URL },
-        { name: 'INDEXER_GRAPHQL_URL', value: INDEXER_GRAPHQL_URL },
-        { name: 'ATTESTATION_SERVICE_URL', value: ATTESTATION_SERVICE_URL },
-    ];
-    for (const { name, value } of endpoints) {
-        describe(name, () => {
-            it('should be a non-empty string', () => {
-                assert.ok(typeof value === 'string', `${name} should be a string`);
-                assert.ok(value.length > 0, `${name} should not be empty`);
-            });
-            it('should start with https:// or wss://', () => {
-                assert.ok(value.startsWith('https://') || value.startsWith('wss://'), `${name} should start with https:// or wss://, got: ${value}`);
-            });
-            it('should not have a trailing slash', () => {
-                assert.ok(!value.endsWith('/'), `${name} should not end with a trailing slash, got: ${value}`);
-            });
-            it('should not contain whitespace', () => {
-                assert.equal(value, value.trim(), `${name} should not have leading/trailing whitespace`);
-                assert.ok(!/\s/.test(value), `${name} should not contain whitespace`);
-            });
-        });
-    }
-    describe('default values', () => {
-        it('SPONSOR_SERVER_URL defaults to production', () => {
-            assert.equal(SPONSOR_SERVER_URL, 'https://sponsor.provex.xyz');
-        });
-        it('ATTESTOR_WS_URL defaults to Reclaim attestor', () => {
-            assert.equal(ATTESTOR_WS_URL, 'wss://attestor.reclaimprotocol.org/ws');
-        });
-        it('INDEXER_GRAPHQL_URL defaults to production GraphQL', () => {
-            assert.equal(INDEXER_GRAPHQL_URL, 'https://indexer.provex.xyz/graphql');
-        });
-        it('ATTESTATION_SERVICE_URL defaults to production', () => {
-            assert.equal(ATTESTATION_SERVICE_URL, 'https://attestation.provex.xyz');
-        });
-    });
-    describe('protocol expectations', () => {
-        it('ATTESTOR_WS_URL uses wss:// protocol', () => {
-            assert.ok(ATTESTOR_WS_URL.startsWith('wss://'), 'WebSocket URL should use wss://');
-        });
-        it('HTTPS endpoints use https:// protocol', () => {
-            const httpsEndpoints = [SPONSOR_SERVER_URL, INDEXER_GRAPHQL_URL, ATTESTATION_SERVICE_URL];
-            for (const url of httpsEndpoints) {
-                assert.ok(url.startsWith('https://'), `Expected https://, got: ${url}`);
-            }
-        });
-    });
-});

package/dist/src/normalization.d.ts

@@ -1,224 +0,0 @@
-import type { Hex } from 'viem';
-import type { Version } from './contracts.js';
-/**
- * V2 Deposit structure as stored in the database.
- * This represents the raw v2 deposit data from the indexer.
- */
-export type V2DepositData = {
-    escrow: Hex;
-    localId: bigint;
-    chainId: bigint;
-    orderId: Hex;
-    logId: Hex;
-    transactionId: Hex;
-    token: Hex;
-    participantId: Hex;
-    deposited: bigint;
-    remaining: bigint;
-    minAmount: bigint;
-    maxAmount: bigint;
-    depositConversionRateCurrencies: Hex[];
-    depositConversionRateVerifiers: Hex[];
-    version: 'v2';
-    acceptingIntents: boolean;
-    delegate: Hex;
-    intentGuardian: Hex;
-    status: 'active' | 'underfunded' | 'withdrawn' | 'closed';
-};
-/**
- * V3 Deposit structure - the normalized format.
- * V3 deposits have the same core fields but may include additional v3-specific metadata.
- */
-export type V3DepositData = Omit<V2DepositData, 'version'> & {
-    version: 'v3';
-    /**
-     * Tracks the original version if this deposit was normalized from v2.
-     * Undefined for native v3 deposits.
-     */
-    _originalVersion?: Version;
-};
-/**
- * Normalizes a V2 deposit to V3 format for unified UI consumption.
- *
- * Since deposits are already stored in a unified schema, this function
- * primarily marks the deposit as "appearing" as v3 while preserving
- * the original version information.
- *
- * @param v2Deposit - The v2 deposit data from the indexer
- * @returns The deposit in v3-normalized format
- *
- * @example
- * ```typescript
- * const v2Deposit = await getDeposit(escrow, depositId, chainId)
- * if (v2Deposit.version === 'v2') {
- *   const normalized = normalizeV2Deposit(v2Deposit)
- *   // normalized.version === 'v3'
- *   // normalized._originalVersion === 'v2'
- * }
- * ```
- */
-export declare function normalizeV2Deposit(v2Deposit: V2DepositData): V3DepositData;
-/**
- * V2 Intent structure as stored in the database.
- * V2 intents use v2Currency and v2ConversionRateChangeId for rate lookups.
- */
-export type V2IntentData = {
-    intentHash: Hex;
-    orderId: Hex;
-    logId: Hex;
-    transactionId: Hex;
-    depositEscrow: Hex;
-    depositLocalId: bigint;
-    depositChainId: bigint;
-    escrow: Hex;
-    paymentMethodId: Hex;
-    ownerParticipantId: Hex;
-    toParticipantId: Hex;
-    amount: bigint;
-    fiatCurrency: Hex;
-    conversionRate: bigint;
-    timestamp: bigint;
-    /** V2-specific: Currency hash used for conversion rate lookup */
-    v2Currency: Hex;
-    /** V2-specific: Conversion rate change ID at intent time */
-    v2ConversionRateChangeId: number;
-};
-/**
- * V3 Intent structure - the normalized format.
- * V3 intents rely on paymentMethodId for all rate/currency information.
- */
-export type V3IntentData = {
-    intentHash: Hex;
-    orderId: Hex;
-    logId: Hex;
-    transactionId: Hex;
-    depositEscrow: Hex;
-    depositLocalId: bigint;
-    depositChainId: bigint;
-    escrow: Hex;
-    paymentMethodId: Hex;
-    ownerParticipantId: Hex;
-    toParticipantId: Hex;
-    amount: bigint;
-    fiatCurrency: Hex;
-    conversionRate: bigint;
-    timestamp: bigint;
-    /** V2-specific fields are null in v3 native intents */
-    v2Currency: null;
-    v2ConversionRateChangeId: null;
-    /**
-     * Tracks the original version if this intent was normalized from v2.
-     * Undefined for native v3 intents.
-     */
-    _originalVersion?: Version;
-};
-/**
- * Normalizes a V2 intent to V3 format for unified UI consumption.
- *
- * V2 intents store currency and rate change ID explicitly, while V3 intents
- * derive this information from the paymentMethodId relationship.
- * This function converts v2 intent data to the v3 format.
- *
- * @param v2Intent - The v2 intent data from the indexer
- * @returns The intent in v3-normalized format
- *
- * @example
- * ```typescript
- * const intent = await getIntent(intentHash)
- * if (intent.v2Currency !== null) {
- *   const normalized = normalizeV2Intent(intent)
- *   // normalized.v2Currency === null
- *   // normalized._originalVersion === 'v2'
- * }
- * ```
- */
-export declare function normalizeV2Intent(v2Intent: V2IntentData): V3IntentData;
-/**
- * V2 Payment Verification data.
- * V2 uses ZK proofs verified on-chain via payment verifier contracts.
- */
-export type V2VerificationData = {
-    intentHash: Hex;
-    verifierAddress: Hex;
-    proofTimestamp: bigint;
-    transactionId: Hex;
-    depositorAddress: Hex;
-    depositId: bigint;
-    amount: bigint;
-};
-/**
- * V3-style attestation format.
- * V3 uses EIP-712 signed attestations from trusted attesters.
- */
-export type V3AttestationData = {
-    intentHash: Hex;
-    attestation: {
-        depositor: Hex;
-        depositId: bigint;
-        amount: bigint;
-        /** Payment identifier (synthesized from v2 proof data) */
-        paymentId: string;
-        timestamp: bigint;
-    };
-    /** Signature placeholder - v2 doesn't have signatures */
-    signature: null;
-    /**
-     * Tracks the original version if this attestation was normalized from v2.
-     */
-    _originalVersion: 'v2';
-    /** Original v2 verification data preserved for reference */
-    _v2Verification: V2VerificationData;
-};
-/**
- * Normalizes a V2 payment verification to V3 attestation format.
- *
- * V2 uses ZK proofs verified by on-chain verifier contracts, while V3 uses
- * EIP-712 signed attestations. This function synthesizes an attestation-like
- * structure from v2 verification data.
- *
- * Note: The signature field is null since v2 verifications don't use signatures.
- * The original v2 verification data is preserved in `_v2Verification`.
- *
- * @param v2Verification - The v2 verification data
- * @returns A v3-style attestation structure
- *
- * @example
- * ```typescript
- * const verification = getV2Verification(intentHash)
- * const attestation = normalizeV2Verification(verification)
- * // attestation.attestation.depositor === verification.depositorAddress
- * // attestation.signature === null (v2 doesn't have signatures)
- * // attestation._originalVersion === 'v2'
- * ```
- */
-export declare function normalizeV2Verification(v2Verification: V2VerificationData): V3AttestationData;
-/**
- * Type guard to check if a deposit is a v2 deposit.
- * @param deposit - The deposit data to check
- * @returns True if the deposit is from v2 escrow
- */
-export declare function isV2Deposit(deposit: {
-    version: Version;
-}): deposit is {
-    version: 'v2';
-} & typeof deposit;
-/**
- * Type guard to check if an intent is a v2 intent.
- * @param intent - The intent data to check
- * @returns True if the intent has v2-specific fields populated
- */
-export declare function isV2Intent(intent: {
-    v2Currency: Hex | null;
-}): intent is {
-    v2Currency: Hex;
-} & typeof intent;
-/**
- * Type guard to check if data was normalized from v2.
- * @param data - The data to check
- * @returns True if the data has _originalVersion === 'v2'
- */
-export declare function isNormalizedFromV2(data: {
-    _originalVersion?: Version;
-}): data is {
-    _originalVersion: 'v2';
-} & typeof data;