@explorins/pers-sdk 1.1.2 → 1.2.0

package/dist/transaction/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @explorins/pers-sdk-transaction
+ *
+ * Platform-agnostic Transaction Domain SDK for PERS ecosystem
+ * Handles transaction operations across different authorization levels
+ */
+export { TransactionApi } from './api/transaction-api';
+export { TransactionService } from './services/transaction-service';
+export * from './models';
+export * from '../shared/interfaces/pers-shared-lib.interfaces';
+export * from './models';
+import { ClientTransactionRequestDTO, TransactionRequestDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
+import { PersApiClient } from '../core/pers-api-client';
+import { TransactionApi } from './api/transaction-api';
+import { TransactionService } from './services/transaction-service';
+import { TransactionPaginationParams, UserBurnTokenRequestDTO } from './models';
+/**
+ * Create a complete Transaction SDK instance
+ *
+ * @param apiClient - Configured PERS API client
+ * @returns Transaction SDK with flattened structure for better DX
+ */
+export declare function createTransactionSDK(apiClient: PersApiClient): {
+    getTransactionById: (transactionId: string) => Promise<import("@explorins/pers-shared/dist/cjs/dto/transaction/transaction.dto").TransactionDTO>;
+    createAuthTransaction: (request: TransactionRequestDTO) => Promise<import("@explorins/pers-shared/dist/cjs/dto/transaction/transaction.dto").TransactionDTO>;
+    getUserTransactionHistory: (type: string) => Promise<import("@explorins/pers-shared/dist/cjs/dto/transaction/transaction.dto").TransactionDTO[]>;
+    prepareClientSignedTransaction: (request: ClientTransactionRequestDTO) => Promise<import("@explorins/pers-shared/dist/cjs/dto/transaction/transaction-client.request.dto").ClientTransactionRequestResponseDto>;
+    burnUserTokens: (request: UserBurnTokenRequestDTO) => Promise<import("@explorins/pers-shared/dist/cjs/dto/transaction/transaction.dto").TransactionDTO>;
+    createBusinessTransaction: (request: TransactionRequestDTO) => Promise<import("@explorins/pers-shared/dist/cjs/dto/transaction/transaction.dto").TransactionDTO>;
+    createAdminTransaction: (request: TransactionRequestDTO) => Promise<import("@explorins/pers-shared/dist/cjs/dto/transaction/transaction.dto").TransactionDTO>;
+    getTenantTransactions: () => Promise<import("@explorins/pers-shared/dist/cjs/dto/transaction/transaction.dto").TransactionDTO[]>;
+    getPaginatedTransactions: (params: TransactionPaginationParams) => Promise<import("./models").TransactionPaginationResponse>;
+    exportTransactionsCSV: () => Promise<Blob>;
+    api: TransactionApi;
+    service: TransactionService;
+};
+export type TransactionSDK = ReturnType<typeof createTransactionSDK>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transaction/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGpE,cAAc,UAAU,CAAC;AACzB,cAAc,iDAAiD,CAAC;AAGhE,cAAc,UAAU,CAAC;AAEzB,OAAO,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAErH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAEhF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,aAAa;wCAQrB,MAAM;qCAGT,qBAAqB;sCACpB,MAAM;8CACE,2BAA2B;8BAC3C,uBAAuB;yCAGZ,qBAAqB;sCAGxB,qBAAqB;;uCAEpB,2BAA2B;;;;EAOjE;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/transaction/models/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Transaction Domain Models
+ *
+ * Re-exports from @explorins/pers-shared for consistency with backend
+ * and to provide a single import source for transaction-related types.
+ */
+export type { TransactionDTO, TransactionRequestDTO, ClientTransactionRequestDTO, ClientTransactionRequestResponseDto, UserToBusinessTokenTransactionCreateRequestDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
+import { TransactionDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
+export interface TransactionPaginationParams {
+    page: number;
+    limit: number;
+    participantId?: string;
+    status?: string;
+    sortBy?: string;
+    sortOrder?: 'ASC' | 'DESC';
+    filters?: {
+        startDate?: string;
+        endDate?: string;
+        type?: string[];
+        tokenType?: string[];
+    };
+}
+export interface TransactionPaginationResponse {
+    data: TransactionDTO[];
+    pagination: {
+        page: string;
+        limit: string;
+        total: number;
+        pages: number;
+        hasNext: boolean;
+        hasPrev: boolean;
+    };
+}
+export interface UserBurnTokenRequestDTO {
+    tokenAddress: string;
+    tokenMetadataIncrementalId: string;
+    chainId: number;
+    amount: number;
+}
+export declare enum TransactionAccountType {
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/transaction/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transaction/models/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,2BAA2B,EAC3B,mCAAmC,EACnC,8CAA8C,EAC/C,MAAM,oDAAoD,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AAIpF,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B,EAAE,MAAM,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAGD,oBAAY,sBAAsB;CAGjC"}

package/dist/transaction/services/transaction-service.d.ts

@@ -0,0 +1,56 @@
+import { TransactionDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
+import { TransactionApi } from '../api/transaction-api';
+import { TransactionRequestDTO, ClientTransactionRequestDTO, ClientTransactionRequestResponseDto, TransactionPaginationParams, TransactionPaginationResponse, UserBurnTokenRequestDTO } from '../models';
+/**
+ * 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.
+ */
+export declare class TransactionService {
+    private transactionApi;
+    constructor(transactionApi: TransactionApi);
+    /**
+     * Get transaction by ID
+     */
+    getTransactionById(transactionId: string): Promise<TransactionDTO>;
+    /**
+     * AUTH: Create authenticated transaction
+     */
+    createAuthTransaction(request: TransactionRequestDTO): Promise<TransactionDTO>;
+    /**
+     * AUTH: Get user transaction history by type
+     */
+    getUserTransactionHistory(type: string): Promise<TransactionDTO[]>;
+    /**
+     * AUTH: Prepare client signed transaction
+     */
+    prepareClientSignedTransaction(request: ClientTransactionRequestDTO): Promise<ClientTransactionRequestResponseDto>;
+    /**
+     * AUTH: Burn user tokens
+     */
+    burnUserTokens(request: UserBurnTokenRequestDTO): Promise<TransactionDTO>;
+    /**
+     * BUSINESS: Create business transaction
+     */
+    createBusinessTransaction(request: TransactionRequestDTO): Promise<TransactionDTO>;
+    /**
+     * ADMIN: Create admin transaction
+     */
+    createAdminTransaction(request: TransactionRequestDTO): Promise<TransactionDTO>;
+    /**
+     * ADMIN: Get all tenant transactions
+     */
+    getTenantTransactions(): Promise<TransactionDTO[]>;
+    /**
+     * ADMIN: Get paginated transactions with filtering and sorting
+     */
+    getPaginatedTransactions(params: TransactionPaginationParams): Promise<TransactionPaginationResponse>;
+    /**
+     * ADMIN: Export transactions to CSV
+     */
+    exportTransactionsCSV(): Promise<Blob>;
+}
+//# sourceMappingURL=transaction-service.d.ts.map

package/dist/transaction/services/transaction-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-service.d.ts","sourceRoot":"","sources":["../../../src/transaction/services/transaction-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,mCAAmC,EACnC,2BAA2B,EAC3B,6BAA6B,EAC7B,uBAAuB,EACxB,MAAM,WAAW,CAAC;AAEnB;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IACjB,OAAO,CAAC,cAAc;gBAAd,cAAc,EAAE,cAAc;IAElD;;OAEG;IACG,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAQxE;;OAEG;IACG,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIpF;;OAEG;IACG,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAIxE;;OAEG;IACG,8BAA8B,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,mCAAmC,CAAC;IAIxH;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,cAAc,CAAC;IAQ/E;;OAEG;IACG,yBAAyB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;IAQxF;;OAEG;IACG,sBAAsB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIrF;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIxD;;OAEG;IACG,wBAAwB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAI3G;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7C"}

package/dist/transaction.cjs

@@ -0,0 +1,394 @@
+'use strict';
+
+/**
+ * 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}`);
+    }
+    // ==========================================
+    // AUTHENTICATED USER OPERATIONS
+    // ==========================================
+    /**
+     * AUTH: Create authenticated user transaction
+     *
+     * UPDATED: /transaction/auth/transaction → /transactions/user
+     */
+    async createAuthTransaction(request) {
+        return this.apiClient.post(`${this.basePath}/user`, request);
+    }
+    /**
+     * AUTH: Get user's sent transactions
+     *
+     * UPDATED: /transaction/auth/sender → /transactions/me/sent
+     */
+    async getUserSentTransactions() {
+        const params = new URLSearchParams({
+            timestamp: Date.now().toString()
+        });
+        return this.apiClient.get(`${this.basePath}/me/sent?${params.toString()}`);
+    }
+    /**
+     * AUTH: Get user's received transactions
+     *
+     * UPDATED: /transaction/auth/recipient → /transactions/me/received
+     */
+    async getUserReceivedTransactions() {
+        const params = new URLSearchParams({
+            timestamp: Date.now().toString()
+        });
+        return this.apiClient.get(`${this.basePath}/me/received?${params.toString()}`);
+    }
+    /**
+     * AUTH: Get user transaction history by type (backwards compatibility)
+     *
+     * UPDATED: Maps to appropriate /transactions/me/* endpoints
+     */
+    async getUserTransactionHistory(type) {
+        const params = new URLSearchParams({
+            timestamp: Date.now().toString()
+        });
+        // Map legacy type parameter to new endpoints
+        switch (type.toLowerCase()) {
+            case 'sender':
+            case 'sent':
+                return this.apiClient.get(`${this.basePath}/me/sent?${params.toString()}`);
+            case 'recipient':
+            case 'received':
+                return this.apiClient.get(`${this.basePath}/me/received?${params.toString()}`);
+            default:
+                // Default to sent transactions for backwards compatibility
+                return this.apiClient.get(`${this.basePath}/me/sent?${params.toString()}`);
+        }
+    }
+    /**
+     * AUTH: Prepare client signed transaction
+     *
+     * UPDATED: /transaction/auth/prepare-signing → /transactions/prepare
+     */
+    async prepareClientSignedTransaction(request) {
+        return this.apiClient.post(`${this.basePath}/prepare`, request);
+    }
+    /**
+     * 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/{id}/submit
+     */
+    async submitSignedTransaction(transactionId, signedData) {
+        return this.apiClient.post(`${this.basePath}/${transactionId}/submit`, signedData);
+    }
+    /**
+     * AUTH: Burn user tokens
+     *
+     * UPDATED: Uses new user transaction endpoint with burn-specific parameters
+     * Note: This might need backend confirmation on burn functionality implementation
+     */
+    async burnUserTokens(request) {
+        // Map burn request to TransactionRequestDTO format for new endpoint
+        const transactionRequest = {
+            ...request,
+            // Add any specific burn transaction parameters here
+        };
+        return this.apiClient.post(`${this.basePath}/user`, transactionRequest);
+    }
+    // ==========================================
+    // BUSINESS OPERATIONS
+    // ==========================================
+    /**
+     * BUSINESS: Create business transaction
+     *
+     * UPDATED: /transaction/business/transaction → /transactions/business
+     */
+    async createBusinessTransaction(request) {
+        return this.apiClient.post(`${this.basePath}/business`, request);
+    }
+    // ==========================================
+    // ADMIN OPERATIONS
+    // ==========================================
+    /**
+     * ADMIN: Create admin transaction
+     *
+     * UPDATED: /transaction/admin/transaction → /transactions/admin
+     */
+    async createAdminTransaction(request) {
+        return this.apiClient.post(`${this.basePath}/system`, request);
+    }
+    /**
+     * ADMIN: Get all tenant transactions
+     *
+     * UPDATED: /transaction/admin → /transactions
+     */
+    async getTenantTransactions() {
+        const result = await this.apiClient.get(`${this.basePath}`);
+        // If the new endpoint returns paginated response, extract the data array
+        if ('data' in result) {
+            return result.data;
+        }
+        // Fallback for direct array response
+        return result;
+    }
+    /**
+     * ADMIN: Get paginated transactions with filtering and sorting
+     *
+     * UPDATED: /transaction/admin → /transactions (same endpoint, better structure)
+     */
+    async getPaginatedTransactions(params) {
+        // Build query parameters
+        const queryParams = {
+            page: params.page.toString(),
+            limit: params.limit.toString()
+        };
+        // Add sorting parameters if provided
+        if (params.sortBy) {
+            queryParams['sortBy'] = params.sortBy;
+        }
+        if (params.sortOrder) {
+            queryParams['sortOrder'] = params.sortOrder;
+        }
+        // Add user-specific filtering if provided
+        if (params.participantId) {
+            queryParams['participantId'] = params.participantId;
+        }
+        // Add status filtering if provided
+        if (params.status) {
+            queryParams['status'] = params.status;
+        }
+        // Add additional filters if provided
+        if (params.filters) {
+            if (params.filters.startDate) {
+                queryParams['startDate'] = params.filters.startDate;
+            }
+            if (params.filters.endDate) {
+                queryParams['endDate'] = params.filters.endDate;
+            }
+            if (params.filters.type && params.filters.type.length > 0) {
+                queryParams['type'] = params.filters.type.join(',');
+            }
+            if (params.filters.tokenType && params.filters.tokenType.length > 0) {
+                queryParams['tokenType'] = params.filters.tokenType.join(',');
+            }
+        }
+        // Build query string
+        const queryString = Object.entries(queryParams)
+            .map(([key, value]) => `${key}=${encodeURIComponent(value)}`)
+            .join('&');
+        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
+     */
+    async queryTransactionsBySender(accountSelector) {
+        return this.apiClient.post(`${this.basePath}/query-sender`, accountSelector);
+    }
+    /**
+     * ADMIN: Query transactions by recipient
+     *
+     * NEW ENDPOINT: POST /transactions/query-recipient
+     */
+    async queryTransactionsByRecipient(accountSelector) {
+        return this.apiClient.post(`${this.basePath}/query-recipient`, accountSelector);
+    }
+    /**
+     * ADMIN: Get transaction analytics
+     *
+     * NEW ENDPOINT: POST /transactions/analytics
+     */
+    async getTransactionAnalytics(analyticsRequest) {
+        return this.apiClient.post(`${this.basePath}/analytics`, analyticsRequest);
+    }
+    // ==========================================
+    // CONVENIENCE METHODS (BACKWARDS COMPATIBILITY)
+    // ==========================================
+    /**
+     * Convenience method: Get user sent transactions (alias)
+     */
+    async getUserSenderTransactions() {
+        return this.getUserSentTransactions();
+    }
+    /**
+     * Convenience method: Get user received transactions (alias)
+     */
+    async getUserRecipientTransactions() {
+        return this.getUserReceivedTransactions();
+    }
+}
+
+/**
+ * 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) {
+        return this.transactionApi.createAuthTransaction(request);
+    }
+    /**
+     * AUTH: Get user transaction history by type
+     */
+    async getUserTransactionHistory(type) {
+        return this.transactionApi.getUserTransactionHistory(type);
+    }
+    /**
+     * AUTH: Prepare client signed transaction
+     */
+    async prepareClientSignedTransaction(request) {
+        return this.transactionApi.prepareClientSignedTransaction(request);
+    }
+    /**
+     * AUTH: Burn user tokens
+     */
+    async burnUserTokens(request) {
+        return this.transactionApi.burnUserTokens(request);
+    }
+    // ==========================================
+    // BUSINESS OPERATIONS
+    // ==========================================
+    /**
+     * BUSINESS: Create business transaction
+     */
+    async createBusinessTransaction(request) {
+        return this.transactionApi.createBusinessTransaction(request);
+    }
+    // ==========================================
+    // ADMIN OPERATIONS
+    // ==========================================
+    /**
+     * ADMIN: Create admin transaction
+     */
+    async createAdminTransaction(request) {
+        return this.transactionApi.createAdminTransaction(request);
+    }
+    /**
+     * ADMIN: Get all tenant transactions
+     */
+    async getTenantTransactions() {
+        return this.transactionApi.getTenantTransactions();
+    }
+    /**
+     * 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();
+    }
+}
+
+/**
+ * Transaction Domain Models
+ *
+ * Re-exports from @explorins/pers-shared for consistency with backend
+ * and to provide a single import source for transaction-related types.
+ */
+// Transaction account types (domain-specific enum)
+exports.TransactionAccountType = void 0;
+(function (TransactionAccountType) {
+    // Add specific transaction account types as needed
+    // This should match the enum used in the infrastructure layer
+})(exports.TransactionAccountType || (exports.TransactionAccountType = {}));
+
+/**
+ * @explorins/pers-sdk-transaction
+ *
+ * Platform-agnostic Transaction Domain SDK for PERS ecosystem
+ * Handles transaction operations across different authorization levels
+ */
+// API Layer
+/**
+ * Create a complete Transaction SDK instance
+ *
+ * @param apiClient - Configured PERS API client
+ * @returns Transaction SDK with flattened structure for better DX
+ */
+function createTransactionSDK(apiClient) {
+    const transactionApi = new TransactionApi(apiClient);
+    const transactionService = new TransactionService(transactionApi);
+    return {
+        // Direct access to service methods (primary interface)
+        // Public methods
+        getTransactionById: (transactionId) => transactionService.getTransactionById(transactionId),
+        // Auth methods
+        createAuthTransaction: (request) => transactionService.createAuthTransaction(request),
+        getUserTransactionHistory: (type) => transactionService.getUserTransactionHistory(type),
+        prepareClientSignedTransaction: (request) => transactionService.prepareClientSignedTransaction(request),
+        burnUserTokens: (request) => transactionService.burnUserTokens(request),
+        // Business methods
+        createBusinessTransaction: (request) => transactionService.createBusinessTransaction(request),
+        // Admin methods
+        createAdminTransaction: (request) => transactionService.createAdminTransaction(request),
+        getTenantTransactions: () => transactionService.getTenantTransactions(),
+        getPaginatedTransactions: (params) => transactionService.getPaginatedTransactions(params),
+        exportTransactionsCSV: () => transactionService.exportTransactionsCSV(),
+        // Advanced access for edge cases
+        api: transactionApi,
+        service: transactionService
+    };
+}
+
+exports.TransactionApi = TransactionApi;
+exports.TransactionService = TransactionService;
+exports.createTransactionSDK = createTransactionSDK;
+//# sourceMappingURL=transaction.cjs.map

package/dist/transaction.cjs.map

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