@explorins/pers-sdk 1.6.28 → 1.6.32

package/dist/chunks/transaction-service-B7h_4Hg3.js

@@ -0,0 +1,333 @@
+import { TransactionRole } from '@explorins/pers-shared';
+
+/**
+ * Platform-Agnostic Transaction API Client (UPDATED FOR NEW RESTful ENDPOINTS)
+ *
+ * Handles transaction operations using the PERS backend.
+ * Uses @explorins/pers-shared DTOs for consistency with backend.
+ *
+ * MIGRATION NOTES:
+ * - All endpoints changed from /transaction to /transactions
+ * - Role-based paths removed (no more /auth, /admin, /business in URLs)
+ * - New RESTful resource-based structure
+ * - Added new client-side transaction flow methods
+ * - Enhanced admin query capabilities
+ */
+class TransactionApi {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+        this.basePath = '/transactions';
+    }
+    /**
+     * Get transaction by ID (public endpoint)
+     *
+     * UPDATED: /transaction/{id} → /transactions/{id}
+     */
+    async getTransactionById(transactionId) {
+        return this.apiClient.get(`${this.basePath}/${transactionId}`);
+    }
+    /**
+     * Unique method to create a transaction
+     * @param request
+     * @returns
+     */
+    async createTransaction(request) {
+        return this.apiClient.post(`${this.basePath}`, request);
+        // return this.apiClient.post<TransactionDTO>(`${this.basePath}/system`, request);
+    }
+    // ==========================================
+    // AUTHENTICATED USER OPERATIONS
+    // ==========================================
+    /**
+     * AUTH: Get user transaction history with role-based filtering
+     *
+     * UPDATED: Uses consolidated /transactions/me endpoint with role parameter
+     * @param role - Optional role filter (SENDER, RECIPIENT). If undefined, returns all user transactions
+     * @param limit - Maximum number of transactions to return (default: 1000)
+     */
+    async getUserTransactionHistory(role, limit = 1000) {
+        const params = new URLSearchParams({
+            limit: limit.toString(),
+            timestamp: Date.now().toString()
+        });
+        // Add role parameter if specified
+        if (role === TransactionRole.SENDER) {
+            params.set('role', TransactionRole.SENDER);
+        }
+        else if (role === TransactionRole.RECIPIENT) {
+            params.set('role', TransactionRole.RECIPIENT);
+        }
+        // If no role specified, get all transactions for the user
+        const response = await this.apiClient.get(`${this.basePath}/me?${params.toString()}`);
+        return [...(response.data || [])];
+    }
+    /**
+     * AUTH: Prepare existing transaction for client-side signing
+     *
+     * NEW ENDPOINT: GET /transactions/{id}/prepare
+     */
+    async prepareExistingTransaction(transactionId) {
+        return this.apiClient.get(`${this.basePath}/${transactionId}/prepare`);
+    }
+    /**
+     * AUTH: Submit client-side signed transaction
+     *
+     * NEW ENDPOINT: POST /transactions/submit
+     */
+    async submitSignedTransaction(signedTxData) {
+        return this.apiClient.post(`${this.basePath}/submit`, signedTxData);
+    }
+    // ==========================================
+    // BUSINESS OPERATIONS
+    // ==========================================
+    /**
+     * BUSINESS: Create business transaction
+     *
+     * UPDATED: /transaction/business/transaction → /transactions/business
+     */
+    /* async createBusinessTransaction(request: TransactionRequestDTO): Promise<TransactionRequestResponseDTO> {
+      return this.apiClient.post<TransactionRequestResponseDTO>(`${this.basePath}`, request);
+    } */
+    // ==========================================
+    // ADMIN OPERATIONS
+    // ==========================================
+    /**
+     * ADMIN: Create admin transaction
+     *
+     * UPDATED: /transaction/admin/transaction → /transactions/admin
+     */
+    /* async createAdminTransaction(request: TransactionRequestDTO): Promise<TransactionRequestResponseDTO> {
+      // return this.apiClient.post<TransactionRequestResponseDTO>(`${this.basePath}`, request);
+      return this.apiClient.post<TransactionDTO>(`${this.basePath}/system`, request);
+    } */
+    /**
+     * AUTH: Prepare client signed transaction (Create new transaction for signing)
+     *
+     * UPDATED: /transaction/auth/prepare-signing → /transactions (POST)
+     */
+    async prepareClientSignedTransaction(request) {
+        return this.apiClient.post(`${this.basePath}`, request);
+    }
+    /**
+     * ADMIN: Get all tenant transactions
+     *
+     * UPDATED: /transaction/admin → /transactions
+     */
+    async getTenantTransactions(limit = 1000) {
+        const params = new URLSearchParams({
+            limit: limit.toString()
+        });
+        const result = await this.apiClient.get(`${this.basePath}?${params.toString()}`);
+        // Extract data array from paginated response
+        return [...(result.data || [])];
+    }
+    /**
+     * ADMIN: Get paginated transactions with filtering and sorting
+     *
+     * UPDATED: /transaction/admin → /transactions (same endpoint, better structure)
+     */
+    async getPaginatedTransactions(params) {
+        const queryString = this.buildQueryParams(params).toString();
+        return this.apiClient.get(`${this.basePath}?${queryString}`);
+    }
+    /**
+     * ADMIN: Export transactions to CSV
+     *
+     * UPDATED: /transaction/admin/export/csv → /transactions/export/csv
+     */
+    async exportTransactionsCSV() {
+        return this.apiClient.get(`${this.basePath}/export/csv`, 'blob');
+    }
+    // ==========================================
+    // NEW ADMIN QUERY METHODS
+    // ==========================================
+    /**
+     * ADMIN: Query transactions by sender
+     *
+     * NEW ENDPOINT: POST /transactions/query-sender
+     */
+    /**
+   * Query transactions by sender using unified endpoint
+   */
+    async queryTransactionsBySender(accountSelector) {
+        // Build query parameters safely
+        const queryParams = {};
+        if (accountSelector.accountId) {
+            queryParams['participantId'] = accountSelector.accountId;
+        }
+        queryParams['role'] = TransactionRole.SENDER.toString();
+        const params = new URLSearchParams(queryParams);
+        return this.apiClient.get(`${this.basePath}?${params.toString()}`).then(response => response); // Extract items from paginated response
+    }
+    /**
+     * Query transactions by recipient using unified endpoint
+     */
+    async queryTransactionsByRecipient(accountSelector) {
+        // Build query parameters safely
+        const queryParams = {};
+        if (accountSelector.accountId) {
+            queryParams['participantId'] = accountSelector.accountId;
+        }
+        queryParams['role'] = TransactionRole.RECIPIENT.toString();
+        const params = new URLSearchParams(queryParams);
+        return this.apiClient.get(`${this.basePath}?${params.toString()}`).then(response => response); // Extract items from paginated response
+    }
+    /**
+     * ADMIN: Get transaction analytics
+     *
+     * NEW ENDPOINT: POST /transactions/analytics
+     */
+    async getTransactionAnalytics(analyticsRequest) {
+        return this.apiClient.post(`${this.basePath}/analytics`, analyticsRequest);
+    }
+    /**
+     * Helper to convert DTO object to URLSearchParams
+     * Handles nested 'filters' object and arrays correctly.
+     */
+    buildQueryParams(params) {
+        const query = new URLSearchParams();
+        // 1. Handle Root Pagination Fields
+        if (params.page !== undefined)
+            query.append('page', params.page.toString());
+        if (params.limit !== undefined)
+            query.append('limit', params.limit.toString());
+        if (params.sortBy)
+            query.append('sortBy', params.sortBy);
+        if (params.sortOrder)
+            query.append('sortOrder', params.sortOrder);
+        // 2. Handle Nested Filters
+        if (params.filters) {
+            Object.entries(params.filters).forEach(([key, value]) => {
+                // Skip undefined/null values
+                if (value === undefined || value === null || value === '')
+                    return;
+                if (Array.isArray(value)) {
+                    // Handle Arrays: NestJS expects 'status=A&status=B'
+                    value.forEach((item) => query.append(key, String(item)));
+                }
+                else {
+                    // Handle Single Values: 'search=0x123'
+                    // NOTE: Backend Controller expects flat query params for filters
+                    // e.g. ?search=...&status=... NOT ?filters[search]=...
+                    // This mapping flattens 'filters.search' -> 'search' to match @Query('search') in Controller
+                    const stringValue = (value instanceof Date) ? value.toISOString() : String(value);
+                    query.append(key, stringValue);
+                }
+            });
+        }
+        return query;
+    }
+}
+
+/**
+ * Platform-Agnostic Transaction Service
+ *
+ * Contains transaction business logic and operations that work across platforms.
+ * No framework dependencies - pure TypeScript business logic.
+ *
+ * Focuses only on actual backend capabilities.
+ */
+class TransactionService {
+    constructor(transactionApi) {
+        this.transactionApi = transactionApi;
+    }
+    /**
+     * Get transaction by ID
+     */
+    async getTransactionById(transactionId) {
+        return this.transactionApi.getTransactionById(transactionId);
+    }
+    // ==========================================
+    // AUTHENTICATED OPERATIONS
+    // ==========================================
+    /**
+     * AUTH: Create authenticated transaction
+     */
+    /* async createAuthTransaction(request: TransactionRequestDTO): Promise<TransactionRequestResponseDTO> {
+      return this.transactionApi.createAuthTransaction(request);
+    } */
+    async createTransaction(request) {
+        return this.transactionApi.createTransaction(request);
+    }
+    async submitSignedTransaction(signedTxData) {
+        return this.transactionApi.submitSignedTransaction(signedTxData);
+    }
+    /**
+     * AUTH: Get user transaction history by type
+     */
+    async getUserTransactionHistory(role, limit = 1000) {
+        return this.transactionApi.getUserTransactionHistory(role, limit);
+    }
+    /**
+     * AUTH: Prepare existing transaction for client-side signing
+     */
+    async prepareExistingTransaction(transactionId) {
+        return this.transactionApi.prepareExistingTransaction(transactionId);
+    }
+    /**
+     * AUTH: Prepare client signed transaction
+     */
+    async prepareClientSignedTransaction(request) {
+        return this.transactionApi.prepareClientSignedTransaction(request);
+    }
+    // ==========================================
+    // BUSINESS OPERATIONS
+    // ==========================================
+    /**
+     * BUSINESS: Create business transaction
+     */
+    /* async createBusinessTransaction(request: TransactionRequestDTO): Promise<TransactionRequestResponseDTO> {
+      return this.transactionApi.createBusinessTransaction(request);
+    } */
+    // ==========================================
+    // ADMIN OPERATIONS
+    // ==========================================
+    /**
+     * ADMIN: Create admin transaction
+     */
+    /* async createAdminTransaction(request: TransactionRequestDTO): Promise<TransactionRequestResponseDTO> {
+      return this.transactionApi.createAdminTransaction(request);
+    } */
+    /**
+     * ADMIN: Get all tenant transactions
+     */
+    async getTenantTransactions(limit = 1000) {
+        return this.transactionApi.getTenantTransactions(limit);
+    }
+    /**
+     * ADMIN: Get paginated transactions with filtering and sorting
+     */
+    async getPaginatedTransactions(params) {
+        return this.transactionApi.getPaginatedTransactions(params);
+    }
+    /**
+     * ADMIN: Export transactions to CSV
+     */
+    async exportTransactionsCSV() {
+        return this.transactionApi.exportTransactionsCSV();
+    }
+    // ==========================================
+    // QUERY & ANALYTICS OPERATIONS
+    // ==========================================
+    /**
+     * Query transactions by sender
+     */
+    async queryTransactionsBySender(accountSelector) {
+        return this.transactionApi.queryTransactionsBySender(accountSelector);
+    }
+    /**
+     * Query transactions by recipient
+     */
+    async queryTransactionsByRecipient(accountSelector) {
+        return this.transactionApi.queryTransactionsByRecipient(accountSelector);
+    }
+    /**
+     * ADMIN: Get transaction analytics
+     */
+    async getTransactionAnalytics(analyticsRequest) {
+        return this.transactionApi.getTransactionAnalytics(analyticsRequest);
+    }
+}
+
+export { TransactionApi as T, TransactionService as a };
+//# sourceMappingURL=transaction-service-B7h_4Hg3.js.map

package/dist/chunks/transaction-service-B7h_4Hg3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-service-B7h_4Hg3.js","sources":["../../src/transaction/api/transaction-api.ts","../../src/transaction/services/transaction-service.ts"],"sourcesContent":[null,null],"names":[],"mappings":"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"}

package/dist/chunks/transaction-service-CXjTHCFu.cjs

@@ -0,0 +1,336 @@
+'use strict';
+
+var persShared = require('@explorins/pers-shared');
+
+/**
+ * Platform-Agnostic Transaction API Client (UPDATED FOR NEW RESTful ENDPOINTS)
+ *
+ * Handles transaction operations using the PERS backend.
+ * Uses @explorins/pers-shared DTOs for consistency with backend.
+ *
+ * MIGRATION NOTES:
+ * - All endpoints changed from /transaction to /transactions
+ * - Role-based paths removed (no more /auth, /admin, /business in URLs)
+ * - New RESTful resource-based structure
+ * - Added new client-side transaction flow methods
+ * - Enhanced admin query capabilities
+ */
+class TransactionApi {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+        this.basePath = '/transactions';
+    }
+    /**
+     * Get transaction by ID (public endpoint)
+     *
+     * UPDATED: /transaction/{id} → /transactions/{id}
+     */
+    async getTransactionById(transactionId) {
+        return this.apiClient.get(`${this.basePath}/${transactionId}`);
+    }
+    /**
+     * Unique method to create a transaction
+     * @param request
+     * @returns
+     */
+    async createTransaction(request) {
+        return this.apiClient.post(`${this.basePath}`, request);
+        // return this.apiClient.post<TransactionDTO>(`${this.basePath}/system`, request);
+    }
+    // ==========================================
+    // AUTHENTICATED USER OPERATIONS
+    // ==========================================
+    /**
+     * AUTH: Get user transaction history with role-based filtering
+     *
+     * UPDATED: Uses consolidated /transactions/me endpoint with role parameter
+     * @param role - Optional role filter (SENDER, RECIPIENT). If undefined, returns all user transactions
+     * @param limit - Maximum number of transactions to return (default: 1000)
+     */
+    async getUserTransactionHistory(role, limit = 1000) {
+        const params = new URLSearchParams({
+            limit: limit.toString(),
+            timestamp: Date.now().toString()
+        });
+        // Add role parameter if specified
+        if (role === persShared.TransactionRole.SENDER) {
+            params.set('role', persShared.TransactionRole.SENDER);
+        }
+        else if (role === persShared.TransactionRole.RECIPIENT) {
+            params.set('role', persShared.TransactionRole.RECIPIENT);
+        }
+        // If no role specified, get all transactions for the user
+        const response = await this.apiClient.get(`${this.basePath}/me?${params.toString()}`);
+        return [...(response.data || [])];
+    }
+    /**
+     * AUTH: Prepare existing transaction for client-side signing
+     *
+     * NEW ENDPOINT: GET /transactions/{id}/prepare
+     */
+    async prepareExistingTransaction(transactionId) {
+        return this.apiClient.get(`${this.basePath}/${transactionId}/prepare`);
+    }
+    /**
+     * AUTH: Submit client-side signed transaction
+     *
+     * NEW ENDPOINT: POST /transactions/submit
+     */
+    async submitSignedTransaction(signedTxData) {
+        return this.apiClient.post(`${this.basePath}/submit`, signedTxData);
+    }
+    // ==========================================
+    // BUSINESS OPERATIONS
+    // ==========================================
+    /**
+     * BUSINESS: Create business transaction
+     *
+     * UPDATED: /transaction/business/transaction → /transactions/business
+     */
+    /* async createBusinessTransaction(request: TransactionRequestDTO): Promise<TransactionRequestResponseDTO> {
+      return this.apiClient.post<TransactionRequestResponseDTO>(`${this.basePath}`, request);
+    } */
+    // ==========================================
+    // ADMIN OPERATIONS
+    // ==========================================
+    /**
+     * ADMIN: Create admin transaction
+     *
+     * UPDATED: /transaction/admin/transaction → /transactions/admin
+     */
+    /* async createAdminTransaction(request: TransactionRequestDTO): Promise<TransactionRequestResponseDTO> {
+      // return this.apiClient.post<TransactionRequestResponseDTO>(`${this.basePath}`, request);
+      return this.apiClient.post<TransactionDTO>(`${this.basePath}/system`, request);
+    } */
+    /**
+     * AUTH: Prepare client signed transaction (Create new transaction for signing)
+     *
+     * UPDATED: /transaction/auth/prepare-signing → /transactions (POST)
+     */
+    async prepareClientSignedTransaction(request) {
+        return this.apiClient.post(`${this.basePath}`, request);
+    }
+    /**
+     * ADMIN: Get all tenant transactions
+     *
+     * UPDATED: /transaction/admin → /transactions
+     */
+    async getTenantTransactions(limit = 1000) {
+        const params = new URLSearchParams({
+            limit: limit.toString()
+        });
+        const result = await this.apiClient.get(`${this.basePath}?${params.toString()}`);
+        // Extract data array from paginated response
+        return [...(result.data || [])];
+    }
+    /**
+     * ADMIN: Get paginated transactions with filtering and sorting
+     *
+     * UPDATED: /transaction/admin → /transactions (same endpoint, better structure)
+     */
+    async getPaginatedTransactions(params) {
+        const queryString = this.buildQueryParams(params).toString();
+        return this.apiClient.get(`${this.basePath}?${queryString}`);
+    }
+    /**
+     * ADMIN: Export transactions to CSV
+     *
+     * UPDATED: /transaction/admin/export/csv → /transactions/export/csv
+     */
+    async exportTransactionsCSV() {
+        return this.apiClient.get(`${this.basePath}/export/csv`, 'blob');
+    }
+    // ==========================================
+    // NEW ADMIN QUERY METHODS
+    // ==========================================
+    /**
+     * ADMIN: Query transactions by sender
+     *
+     * NEW ENDPOINT: POST /transactions/query-sender
+     */
+    /**
+   * Query transactions by sender using unified endpoint
+   */
+    async queryTransactionsBySender(accountSelector) {
+        // Build query parameters safely
+        const queryParams = {};
+        if (accountSelector.accountId) {
+            queryParams['participantId'] = accountSelector.accountId;
+        }
+        queryParams['role'] = persShared.TransactionRole.SENDER.toString();
+        const params = new URLSearchParams(queryParams);
+        return this.apiClient.get(`${this.basePath}?${params.toString()}`).then(response => response); // Extract items from paginated response
+    }
+    /**
+     * Query transactions by recipient using unified endpoint
+     */
+    async queryTransactionsByRecipient(accountSelector) {
+        // Build query parameters safely
+        const queryParams = {};
+        if (accountSelector.accountId) {
+            queryParams['participantId'] = accountSelector.accountId;
+        }
+        queryParams['role'] = persShared.TransactionRole.RECIPIENT.toString();
+        const params = new URLSearchParams(queryParams);
+        return this.apiClient.get(`${this.basePath}?${params.toString()}`).then(response => response); // Extract items from paginated response
+    }
+    /**
+     * ADMIN: Get transaction analytics
+     *
+     * NEW ENDPOINT: POST /transactions/analytics
+     */
+    async getTransactionAnalytics(analyticsRequest) {
+        return this.apiClient.post(`${this.basePath}/analytics`, analyticsRequest);
+    }
+    /**
+     * Helper to convert DTO object to URLSearchParams
+     * Handles nested 'filters' object and arrays correctly.
+     */
+    buildQueryParams(params) {
+        const query = new URLSearchParams();
+        // 1. Handle Root Pagination Fields
+        if (params.page !== undefined)
+            query.append('page', params.page.toString());
+        if (params.limit !== undefined)
+            query.append('limit', params.limit.toString());
+        if (params.sortBy)
+            query.append('sortBy', params.sortBy);
+        if (params.sortOrder)
+            query.append('sortOrder', params.sortOrder);
+        // 2. Handle Nested Filters
+        if (params.filters) {
+            Object.entries(params.filters).forEach(([key, value]) => {
+                // Skip undefined/null values
+                if (value === undefined || value === null || value === '')
+                    return;
+                if (Array.isArray(value)) {
+                    // Handle Arrays: NestJS expects 'status=A&status=B'
+                    value.forEach((item) => query.append(key, String(item)));
+                }
+                else {
+                    // Handle Single Values: 'search=0x123'
+                    // NOTE: Backend Controller expects flat query params for filters
+                    // e.g. ?search=...&status=... NOT ?filters[search]=...
+                    // This mapping flattens 'filters.search' -> 'search' to match @Query('search') in Controller
+                    const stringValue = (value instanceof Date) ? value.toISOString() : String(value);
+                    query.append(key, stringValue);
+                }
+            });
+        }
+        return query;
+    }
+}
+
+/**
+ * Platform-Agnostic Transaction Service
+ *
+ * Contains transaction business logic and operations that work across platforms.
+ * No framework dependencies - pure TypeScript business logic.
+ *
+ * Focuses only on actual backend capabilities.
+ */
+class TransactionService {
+    constructor(transactionApi) {
+        this.transactionApi = transactionApi;
+    }
+    /**
+     * Get transaction by ID
+     */
+    async getTransactionById(transactionId) {
+        return this.transactionApi.getTransactionById(transactionId);
+    }
+    // ==========================================
+    // AUTHENTICATED OPERATIONS
+    // ==========================================
+    /**
+     * AUTH: Create authenticated transaction
+     */
+    /* async createAuthTransaction(request: TransactionRequestDTO): Promise<TransactionRequestResponseDTO> {
+      return this.transactionApi.createAuthTransaction(request);
+    } */
+    async createTransaction(request) {
+        return this.transactionApi.createTransaction(request);
+    }
+    async submitSignedTransaction(signedTxData) {
+        return this.transactionApi.submitSignedTransaction(signedTxData);
+    }
+    /**
+     * AUTH: Get user transaction history by type
+     */
+    async getUserTransactionHistory(role, limit = 1000) {
+        return this.transactionApi.getUserTransactionHistory(role, limit);
+    }
+    /**
+     * AUTH: Prepare existing transaction for client-side signing
+     */
+    async prepareExistingTransaction(transactionId) {
+        return this.transactionApi.prepareExistingTransaction(transactionId);
+    }
+    /**
+     * AUTH: Prepare client signed transaction
+     */
+    async prepareClientSignedTransaction(request) {
+        return this.transactionApi.prepareClientSignedTransaction(request);
+    }
+    // ==========================================
+    // BUSINESS OPERATIONS
+    // ==========================================
+    /**
+     * BUSINESS: Create business transaction
+     */
+    /* async createBusinessTransaction(request: TransactionRequestDTO): Promise<TransactionRequestResponseDTO> {
+      return this.transactionApi.createBusinessTransaction(request);
+    } */
+    // ==========================================
+    // ADMIN OPERATIONS
+    // ==========================================
+    /**
+     * ADMIN: Create admin transaction
+     */
+    /* async createAdminTransaction(request: TransactionRequestDTO): Promise<TransactionRequestResponseDTO> {
+      return this.transactionApi.createAdminTransaction(request);
+    } */
+    /**
+     * ADMIN: Get all tenant transactions
+     */
+    async getTenantTransactions(limit = 1000) {
+        return this.transactionApi.getTenantTransactions(limit);
+    }
+    /**
+     * ADMIN: Get paginated transactions with filtering and sorting
+     */
+    async getPaginatedTransactions(params) {
+        return this.transactionApi.getPaginatedTransactions(params);
+    }
+    /**
+     * ADMIN: Export transactions to CSV
+     */
+    async exportTransactionsCSV() {
+        return this.transactionApi.exportTransactionsCSV();
+    }
+    // ==========================================
+    // QUERY & ANALYTICS OPERATIONS
+    // ==========================================
+    /**
+     * Query transactions by sender
+     */
+    async queryTransactionsBySender(accountSelector) {
+        return this.transactionApi.queryTransactionsBySender(accountSelector);
+    }
+    /**
+     * Query transactions by recipient
+     */
+    async queryTransactionsByRecipient(accountSelector) {
+        return this.transactionApi.queryTransactionsByRecipient(accountSelector);
+    }
+    /**
+     * ADMIN: Get transaction analytics
+     */
+    async getTransactionAnalytics(analyticsRequest) {
+        return this.transactionApi.getTransactionAnalytics(analyticsRequest);
+    }
+}
+
+exports.TransactionApi = TransactionApi;
+exports.TransactionService = TransactionService;
+//# sourceMappingURL=transaction-service-CXjTHCFu.cjs.map