@explorins/pers-sdk 2.1.2 → 2.1.4

package/dist/managers/transaction-manager.d.ts

@@ -1,9 +1,8 @@
 import { PersApiClient } from '../core/pers-api-client';
 import { PersEventEmitter } from '../core/events';
-import { TransactionService } from '../transaction';
-import { PaginatedResponseDTO, TransactionAnalyticsRequestDTO, TransactionAnalyticsResponseDTO, TransactionPaginationRequestDTO, TransactionRequestResponseDTO, TransactionRole } from '@explorins/pers-shared';
+import { TransactionService, TransactionQueryOptions } from '../transaction';
+import { PaginatedResponseDTO, TransactionAnalyticsRequestDTO, TransactionAnalyticsResponseDTO, TransactionPaginationRequestDTO, TransactionRequestResponseDTO, TransactionIncludeRelation } from '@explorins/pers-shared';
 import { AccountSelectorDTO, TransactionDTO, TransactionRequestDTO, TransactionSubmissionRequestDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
-import { PaginationOptions } from '../shared/utils/pagination-utils';
 /**
  * Transaction Manager - Clean, high-level interface for transaction operations
  *
@@ -50,8 +49,8 @@ import { PaginationOptions } from '../shared/utils/pagination-utils';
  *
  * @example Administrative Reporting
  * ```typescript
- * // Admin: Get all tenant transactions for analysis
- * const allTransactions = await sdk.transactions.getTenantTransactions();
+ * // Admin: Get paginated transactions for analysis
+ * const allTransactions = await sdk.transactions.getPaginatedTransactions({ page: 1, limit: 100 });
  *
  * // Export transaction data
  * const csvBlob = await sdk.transactions.exportTransactionsCSV();
@@ -72,13 +71,18 @@ export declare class TransactionManager {
      * Provides complete transaction audit trail and verification data.
      *
      * @param transactionId - Unique transaction identifier
+     * @param include - Optional relations to include (sender, recipient, business) for enriched entity data
      * @returns Promise resolving to complete transaction data
      * @throws {PersApiError} When transaction with specified ID is not found or access denied
      *
      * @example
      * ```typescript
      * try {
-     *   const transaction = await sdk.transactions.getTransactionById('txn-abc123');
+     *   // Get transaction with enriched sender/recipient data
+     *   const transaction = await sdk.transactions.getTransactionById(
+     *     'txn-abc123',
+     *     ['sender', 'recipient', 'business']
+     *   );
      *
      *   console.log('Transaction Details:');
      *   console.log('ID:', transaction.id);
@@ -91,16 +95,19 @@ export declare class TransactionManager {
      *     console.log('Description:', transaction.description);
      *   }
      *
-     *   if (transaction.business) {
-     *     console.log('Business:', transaction.business.displayName);
+     *   // Access enriched sender data
+     *   if (transaction.included?.sender) {
+     *     console.log('Sender:', transaction.included.sender);
      *   }
      *
-     *   // Show token movements
-     *   if (transaction.tokenTransfers?.length) {
-     *     console.log('\nToken Transfers:');
-     *     transaction.tokenTransfers.forEach(transfer => {
-     *       console.log(`${transfer.amount} ${transfer.token.symbol} ${transfer.direction}`);
-     *     });
+     *   // Access enriched recipient data
+     *   if (transaction.included?.recipient) {
+     *     console.log('Recipient:', transaction.included.recipient);
+     *   }
+     *
+     *   // Access enriched business data
+     *   if (transaction.included?.engagedBusiness) {
+     *     console.log('Business:', transaction.included.engagedBusiness.displayName);
      *   }
      *
      *   // Show blockchain confirmation
@@ -113,7 +120,7 @@ export declare class TransactionManager {
      * }
      * ```
      */
-    getTransactionById(transactionId: string): Promise<TransactionDTO>;
+    getTransactionById(transactionId: string, include?: TransactionIncludeRelation[]): Promise<TransactionDTO>;
     /**
      * Create a new transaction
      *
@@ -197,147 +204,61 @@ export declare class TransactionManager {
     /**
      * Get user's transaction history
      *
-     * Retrieves transaction history for the authenticated user, filtered by
-     * transaction role. Provides chronological view of all user's loyalty
+     * Retrieves transaction history for the authenticated user with comprehensive
+     * filtering options. Provides chronological view of all user's loyalty
      * activities including purchases, rewards, redemptions, and transfers.
+     * Optionally enrich with related entities (sender, recipient, business).
      *
-     * @param role - Optional role filter (TransactionRole.SENDER, TransactionRole.RECIPIENT). If undefined, returns all user transactions
-     * @param limit - Maximum number of transactions to return (default: 1000)
-     * @returns Promise resolving to array of user's transactions
+     * @param options - Query options including filters, pagination, and include relations
+     * @returns Promise resolving to paginated transaction data with optional included entities
      *
      * @example All Transactions
      * ```typescript
-     * const allTransactions = await sdk.transactions.getUserTransactionHistory('ALL');
+     * const result = await sdk.transactions.getUserTransactionHistory();
      *
-     * console.log(` Transaction History (${allTransactions.length} transactions):`);
+     * console.log(`Transaction History (${result.data.length} of ${result.pagination.total} transactions)`);
      *
-     * allTransactions.forEach((transaction, index) => {
+     * result.data.forEach((transaction, index) => {
      *   const date = new Date(transaction.createdAt).toLocaleDateString();
      *   console.log(`\n${index + 1}. ${transaction.type} - ${date}`);
      *   console.log(`   ${transaction.description || 'No description'}`);
      *   console.log(`   Status: ${transaction.status}`);
-     *
-     *   if (transaction.amount && transaction.currency) {
-     *     console.log(`   Amount: ${transaction.amount} ${transaction.currency}`);
-     *   }
-     *
-     *   if (transaction.business) {
-     *     console.log(`   Business: ${transaction.business.displayName}`);
-     *   }
      * });
      * ```
      *
-     * @example Filtered by Type
+     * @example Filter by Role and Status
      * ```typescript
-     * // Get only purchase transactions
-     * const purchases = await sdk.transactions.getUserTransactionHistory('PURCHASE');
-     *
-     * let totalSpent = 0;
-     * let totalRewards = 0;
-     *
-     * purchases.forEach(purchase => {
-     *   if (purchase.amount) {
-     *     totalSpent += purchase.amount;
-     *   }
-     *
-     *   if (purchase.tokensEarned?.length) {
-     *     purchase.tokensEarned.forEach(reward => {
-     *       totalRewards += reward.amount;
-     *     });
-     *   }
+     * // Get only completed sent transactions
+     * const sent = await sdk.transactions.getUserTransactionHistory({
+     *   role: TransactionRole.SENDER,
+     *   status: TransactionStatus.COMPLETED,
+     *   include: ['recipient', 'business'],
+     *   page: 1,
+     *   limit: 50
      * });
      *
-     * console.log('Purchase Summary:');
-     * console.log(`Total purchases: ${purchases.length}`);
-     * console.log(`Total spent: $${totalSpent.toFixed(2)}`);
-     * console.log(`Total rewards earned: ${totalRewards} points`);
-     * ```
-     *
-     * @example Recent Activity
-     * ```typescript
-     * const recentTransactions = await sdk.transactions.getUserTransactionHistory('ALL');
-     *
-     * // Filter to last 30 days
-     * const thirtyDaysAgo = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000);
-     * const recentActivity = recentTransactions.filter(t =>
-     *   new Date(t.createdAt) > thirtyDaysAgo
-     * );
-     *
-     * console.log(`Recent Activity (${recentActivity.length} transactions in last 30 days):`);
-     *
-     * // Group by type
-     * const activityByType = recentActivity.reduce((acc, t) => {
-     *   acc[t.type] = (acc[t.type] || 0) + 1;
-     *   return acc;
-     * }, {});
-     *
-     * Object.entries(activityByType).forEach(([type, count]) => {
-     *   console.log(`${type}: ${count} transactions`);
+     * sent.data.forEach(tx => {
+     *   console.log(`Sent to: ${tx.included?.recipient?.displayName || tx.recipientAddress}`);
      * });
      * ```
-     */
-    getUserTransactionHistory(role?: TransactionRole, options?: PaginationOptions): Promise<PaginatedResponseDTO<TransactionDTO>>;
-    /**
-     * Admin: Get all tenant transactions
-     *
-     * Retrieves all transactions across the entire tenant/organization for
-     * comprehensive reporting and analysis. This operation requires administrator
-     * privileges and provides system-wide transaction visibility.
      *
-     * @param limit - Maximum number of transactions to return (default: 1000)
-     * @returns Promise resolving to array of all tenant transactions
-     * @throws {PersApiError} When not authenticated as administrator
-     *
-     * @example
+     * @example Filter by Trigger Process (Campaign/Redemption)
      * ```typescript
-     * // Admin operation - comprehensive transaction analysis
-     * const allTransactions = await sdk.transactions.getTenantTransactions();
-     *
-     * console.log(`Tenant Transaction Overview:`);
-     * console.log(`Total transactions: ${allTransactions.length}`);
-     *
-     * // Analyze by status
-     * const statusCounts = allTransactions.reduce((acc, t) => {
-     *   acc[t.status] = (acc[t.status] || 0) + 1;
-     *   return acc;
-     * }, {});
-     *
-     * console.log('\nBy status:');
-     * Object.entries(statusCounts).forEach(([status, count]) => {
-     *   console.log(`${status}: ${count} transactions`);
+     * // Get all transactions triggered by a specific campaign claim
+     * const claimTxs = await sdk.transactions.getUserTransactionHistory({
+     *   triggerProcessId: 'claim-abc123',
+     *   include: ['sender', 'recipient', 'business']
      * });
      *
-     * // Analyze by type
-     * const typeCounts = allTransactions.reduce((acc, t) => {
-     *   acc[t.type] = (acc[t.type] || 0) + 1;
-     *   return acc;
-     * }, {});
-     *
-     * console.log('\nBy type:');
-     * Object.entries(typeCounts).forEach(([type, count]) => {
-     *   console.log(`${type}: ${count} transactions`);
+     * claimTxs.data.forEach(tx => {
+     *   console.log('Transaction from claim:', tx.id);
+     *   if (tx.included?.engagedBusiness) {
+     *     console.log('Business:', tx.included.engagedBusiness.displayName);
+     *   }
      * });
-     *
-     * // Calculate volume metrics
-     * const totalVolume = allTransactions.reduce((sum, t) =>
-     *   sum + (t.amount || 0), 0
-     * );
-     *
-     * const avgTransactionSize = totalVolume / allTransactions.length;
-     *
-     * console.log('\nVolume metrics:');
-     * console.log(`Total volume: $${totalVolume.toFixed(2)}`);
-     * console.log(`Average transaction: $${avgTransactionSize.toFixed(2)}`);
-     *
-     * // Recent activity analysis
-     * const last24Hours = allTransactions.filter(t =>
-     *   new Date(t.createdAt) > new Date(Date.now() - 24 * 60 * 60 * 1000)
-     * );
-     *
-     * console.log(`\n⏰ Last 24 hours: ${last24Hours.length} transactions`);
      * ```
      */
-    getTenantTransactions(options?: PaginationOptions): Promise<PaginatedResponseDTO<TransactionDTO>>;
+    getUserTransactionHistory(options?: TransactionQueryOptions): Promise<PaginatedResponseDTO<TransactionDTO>>;
     /**
      * Admin: Get paginated transactions
      *
@@ -400,8 +321,22 @@ export declare class TransactionManager {
      *   console.log(`$${transaction.amount} - ${transaction.business?.displayName}`);
      * });
      * ```
+     *
+     * @example With Included Relations
+     * ```typescript
+     * // Include sender and recipient entities
+     * const result = await sdk.transactions.getPaginatedTransactions(
+     *   { page: 1, limit: 50 },
+     *   ['sender', 'recipient', 'business']
+     * );
+     *
+     * result.data.forEach(tx => {
+     *   if (tx.included?.sender) console.log('From:', tx.included.sender);
+     *   if (tx.included?.recipient) console.log('To:', tx.included.recipient);
+     * });
+     * ```
      */
-    getPaginatedTransactions(params: TransactionPaginationRequestDTO): Promise<PaginatedResponseDTO<TransactionDTO>>;
+    getPaginatedTransactions(params: TransactionPaginationRequestDTO, include?: TransactionIncludeRelation[]): Promise<PaginatedResponseDTO<TransactionDTO>>;
     /**
      * Admin: Export transactions as CSV
      *

package/dist/managers/transaction-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction-manager.d.ts","sourceRoot":"","sources":["../../src/managers/transaction-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAkB,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,+BAA+B,EAAE,+BAA+B,EAAE,6BAA6B,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAChN,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,qBAAqB,EAAE,+BAA+B,EAAE,MAAM,iDAAiD,CAAC;AAC7J,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM,CAAC;IAJjB,OAAO,CAAC,kBAAkB,CAAqB;gBAGrC,SAAS,EAAE,aAAa,EACxB,MAAM,CAAC,8BAAkB;IAMnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgDG;IACG,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAIxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8EG;IACG,iBAAiB,CAAC,eAAe,EAAE,qBAAqB;IAa9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiFG;IACG,yBAAyB,CAAC,IAAI,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAInI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2DG;IACG,qBAAqB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAIvG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8DG;IACG,wBAAwB,CAAC,MAAM,EAAE,+BAA+B,GAAG,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAItH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoDG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;;;;;;;OAQG;IACG,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAI/F;;;;;;;;OAQG;IACG,8BAA8B,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAI5G;;;;;;;OAOG;IACG,uBAAuB,CAAC,YAAY,EAAE,+BAA+B,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAapH;;;;;;;OAOG;IACG,yBAAyB,CAAC,eAAe,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAInH;;;;;;;OAOG;IACG,4BAA4B,CAAC,eAAe,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAItH;;;;;;;;OAQG;IACG,uBAAuB,CAAC,gBAAgB,EAAE,8BAA8B,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAIzH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,qBAAqB,IAAI,kBAAkB;CAG5C"}
+{"version":3,"file":"transaction-manager.d.ts","sourceRoot":"","sources":["../../src/managers/transaction-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAkB,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,+BAA+B,EAAE,+BAA+B,EAAE,6BAA6B,EAAmB,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAC5O,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,qBAAqB,EAAE,+BAA+B,EAAE,MAAM,iDAAiD,CAAC;AAE7J;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM,CAAC;IAJjB,OAAO,CAAC,kBAAkB,CAAqB;gBAGrC,SAAS,EAAE,aAAa,EACxB,MAAM,CAAC,8BAAkB;IAMnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwDG;IACG,kBAAkB,CACtB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,0BAA0B,EAAE,GACrC,OAAO,CAAC,cAAc,CAAC;IAI1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8EG;IACG,iBAAiB,CAAC,eAAe,EAAE,qBAAqB;IAa9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwDG;IACG,yBAAyB,CAC7B,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAIhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4EG;IACG,wBAAwB,CAC5B,MAAM,EAAE,+BAA+B,EACvC,OAAO,CAAC,EAAE,0BAA0B,EAAE,GACrC,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAIhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoDG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;;;;;;;OAQG;IACG,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAI/F;;;;;;;;OAQG;IACG,8BAA8B,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAI5G;;;;;;;OAOG;IACG,uBAAuB,CAAC,YAAY,EAAE,+BAA+B,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAapH;;;;;;;OAOG;IACG,yBAAyB,CAAC,eAAe,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAInH;;;;;;;OAOG;IACG,4BAA4B,CAAC,eAAe,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAItH;;;;;;;;OAQG;IACG,uBAAuB,CAAC,gBAAgB,EAAE,8BAA8B,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAIzH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,qBAAqB,IAAI,kBAAkB;CAG5C"}

package/dist/managers/trigger-source-manager.d.ts

@@ -0,0 +1,194 @@
+import { PaginatedResponseDTO, SortOrder, TriggerSourceDTO, TriggerSourceCreateRequestDTO, TriggerSourceType } from '@explorins/pers-shared';
+import { PersApiClient } from '../core/pers-api-client';
+import { PersEventEmitter } from '../core/events';
+import { TriggerSourceService } from '../trigger-source';
+/**
+ * TriggerSource Manager - Clean, high-level interface for trigger source operations
+ *
+ * Manages trigger sources which are physical or digital activation points for campaigns:
+ * - QR_CODE: Scannable QR codes
+ * - NFC_TAG: NFC tap points
+ * - GPS_GEOFENCE: Location-based triggers
+ * - API_WEBHOOK: External system integration
+ * - TRANSACTION: Purchase/payment based triggers
+ *
+ * Trigger sources are independent entities that can be created, managed, and then
+ * assigned to campaigns. This separation allows reuse and flexible campaign configuration.
+ *
+ * @group Managers
+ * @category TriggerSource Management
+ *
+ * @example Basic TriggerSource Operations
+ * ```typescript
+ * // Get all QR code trigger sources
+ * const qrSources = await sdk.triggerSources.getAll({ type: 'QR_CODE' });
+ *
+ * // Create a new QR code trigger source
+ * const source = await sdk.triggerSources.create({
+ *   type: 'QR_CODE',
+ *   name: 'Store Entrance QR',
+ *   businessId: 'business-123'
+ * });
+ *
+ * // Assign to campaign (via CampaignManager)
+ * await sdk.campaigns.assignTriggerSource('campaign-456', source.id);
+ * ```
+ */
+export declare class TriggerSourceManager {
+    private apiClient;
+    private events?;
+    private triggerSourceService;
+    constructor(apiClient: PersApiClient, events?: PersEventEmitter | undefined);
+    /**
+     * Get trigger sources with optional filters and pagination
+     *
+     * Retrieves trigger sources (QR codes, NFC tags, GPS geofences, webhooks, etc.)
+     * that can be used to activate campaigns. Supports filtering by type, business,
+     * campaign association, and active status.
+     *
+     * @param options - Filter and pagination options
+     * @returns Promise resolving to paginated trigger sources
+     *
+     * @example
+     * ```typescript
+     * // Get all QR code trigger sources
+     * const qrSources = await sdk.triggerSources.getAll({ type: 'QR_CODE' });
+     *
+     * // Get trigger sources for a specific business
+     * const businessSources = await sdk.triggerSources.getAll({
+     *   businessId: 'business-123',
+     *   active: true,
+     *   page: 1,
+     *   limit: 20
+     * });
+     *
+     * // Get trigger sources assigned to a campaign
+     * const campaignSources = await sdk.triggerSources.getAll({
+     *   campaignId: 'campaign-456'
+     * });
+     * ```
+     */
+    getAll(options?: {
+        type?: TriggerSourceType;
+        businessId?: string;
+        campaignId?: string;
+        active?: boolean;
+        page?: number;
+        limit?: number;
+        sortBy?: 'name' | 'createdAt' | 'type';
+        sortOrder?: SortOrder;
+    }): Promise<PaginatedResponseDTO<TriggerSourceDTO>>;
+    /**
+     * Get trigger source by ID
+     *
+     * Retrieves detailed information for a specific trigger source including
+     * its type, location, metadata, and usage analytics.
+     *
+     * @param triggerSourceId - UUID of the trigger source
+     * @returns Promise resolving to trigger source details
+     * @throws {PersApiError} When trigger source with specified ID is not found
+     *
+     * @example
+     * ```typescript
+     * const source = await sdk.triggerSources.getById('source-123');
+     *
+     * console.log('Trigger Source:', source.name);
+     * console.log('Type:', source.type);
+     * console.log('Active:', source.isActive);
+     *
+     * if (source.coordsLatitude && source.coordsLongitude) {
+     *   console.log('Location:', source.coordsLatitude, source.coordsLongitude);
+     * }
+     * ```
+     */
+    getById(triggerSourceId: string): Promise<TriggerSourceDTO>;
+    /**
+     * Admin: Create a new trigger source
+     *
+     * Creates a new trigger source (QR code, NFC tag, GPS geofence, webhook, or
+     * transaction-based trigger) that can be assigned to campaigns. Requires
+     * administrator privileges.
+     *
+     * @param triggerSource - Trigger source creation data
+     * @returns Promise resolving to created trigger source
+     * @throws {PersApiError} When not authenticated as admin or validation fails
+     *
+     * @example
+     * ```typescript
+     * // Create a QR code trigger source
+     * const qrSource = await sdk.triggerSources.create({
+     *   type: 'QR_CODE',
+     *   name: 'Store Entrance QR',
+     *   description: 'QR code at main entrance',
+     *   businessId: 'business-123',
+     *   coordsLatitude: 47.6062,
+     *   coordsLongitude: -122.3321
+     * });
+     *
+     * // Create an NFC tag trigger source
+     * const nfcSource = await sdk.triggerSources.create({
+     *   type: 'NFC_TAG',
+     *   name: 'Product Display NFC',
+     *   metadata: { productId: 'SKU-12345' }
+     * });
+     *
+     * // Create a GPS geofence trigger source
+     * const geoSource = await sdk.triggerSources.create({
+     *   type: 'GPS_GEOFENCE',
+     *   name: 'Store Area',
+     *   coordsLatitude: 47.6062,
+     *   coordsLongitude: -122.3321,
+     *   metadata: { radiusMeters: 100 }
+     * });
+     * ```
+     */
+    create(triggerSource: TriggerSourceCreateRequestDTO): Promise<TriggerSourceDTO>;
+    /**
+     * Admin: Update a trigger source
+     *
+     * Updates an existing trigger source's configuration. All fields are optional;
+     * only provided fields will be updated. Requires administrator privileges.
+     *
+     * @param triggerSourceId - UUID of the trigger source to update
+     * @param triggerSource - Updated trigger source data (partial)
+     * @returns Promise resolving to updated trigger source
+     * @throws {PersApiError} When not authenticated as admin or trigger source not found
+     *
+     * @example
+     * ```typescript
+     * // Update trigger source name and location
+     * const updated = await sdk.triggerSources.update('source-123', {
+     *   name: 'Updated Store Entrance QR',
+     *   description: 'New description',
+     *   coordsLatitude: 47.6063,
+     *   coordsLongitude: -122.3322
+     * });
+     * ```
+     */
+    update(triggerSourceId: string, triggerSource: Partial<TriggerSourceCreateRequestDTO>): Promise<TriggerSourceDTO>;
+    /**
+     * Admin: Delete a trigger source
+     *
+     * Soft deletes a trigger source, making it inactive. The trigger source will
+     * be removed from any campaigns it was assigned to. Requires administrator
+     * privileges.
+     *
+     * @param triggerSourceId - UUID of the trigger source to delete
+     * @returns Promise resolving to success status
+     * @throws {PersApiError} When not authenticated as admin or trigger source not found
+     *
+     * @example
+     * ```typescript
+     * const success = await sdk.triggerSources.delete('source-123');
+     * console.log('Trigger source deleted:', success);
+     * ```
+     */
+    delete(triggerSourceId: string): Promise<boolean>;
+    /**
+     * Get the full trigger source service for advanced operations
+     *
+     * @returns TriggerSourceService instance with full API access
+     */
+    getTriggerSourceService(): TriggerSourceService;
+}
+//# sourceMappingURL=trigger-source-manager.d.ts.map

package/dist/managers/trigger-source-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-source-manager.d.ts","sourceRoot":"","sources":["../../src/managers/trigger-source-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,gBAAgB,EAChB,6BAA6B,EAC7B,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAoB,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,oBAAoB;IAI7B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM,CAAC;IAJjB,OAAO,CAAC,oBAAoB,CAAuB;gBAGzC,SAAS,EAAE,aAAa,EACxB,MAAM,CAAC,8BAAkB;IAMnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE;QACrB,IAAI,CAAC,EAAE,iBAAiB,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;QACvC,SAAS,CAAC,EAAE,SAAS,CAAC;KACvB,GAAG,OAAO,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;IAInD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,OAAO,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACG,MAAM,CAAC,aAAa,EAAE,6BAA6B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAarF;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,MAAM,CACV,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,OAAO,CAAC,6BAA6B,CAAC,GACpD,OAAO,CAAC,gBAAgB,CAAC;IAa5B;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAavD;;;;OAIG;IACH,uBAAuB,IAAI,oBAAoB;CAGhD"}

package/dist/managers/user-manager.d.ts

@@ -184,25 +184,56 @@ export declare class UserManager {
      * requires administrator privileges and returns full user profiles including
      * private information.
      *
-     * @returns Promise resolving to array of all users with complete data
+     * @param options - Pagination and sorting options
+     * @param options.page - Page number (1-based, default: 1)
+     * @param options.limit - Items per page (default: 50)
+     * @param options.sortBy - Sort by field. Supported fields:
+     *   - 'id', 'email', 'identifierEmail', 'firstName', 'lastName'
+     *   - 'externalId', 'accountAddress', 'isActive'
+     *   - 'createdAt', 'updatedAt'
+     *   - Default: 'createdAt'
+     * @param options.sortOrder - Sort order: SortOrder.ASC or SortOrder.DESC (default: DESC)
+     * @param search - Optional search query to filter users
+     * @returns Promise resolving to paginated users with complete data
      * @throws {PersApiError} When not authenticated as admin
      *
-     * @example
+     * @example Basic Usage
      * ```typescript
      * // Admin operation - requires admin authentication
      * try {
-     *   const allUsers = await sdk.users.getAllUsers();
-     *   console.log(`Total users: ${allUsers.length}`);
+     *   const result = await sdk.users.getAllUsers();
+     *   console.log(`Total users: ${result.pagination.total}`);
      *
-     *   allUsers.forEach(user => {
-     *     console.log(`${user.name} - ${user.email} - Active: ${user.isActive}`);
+     *   result.data.forEach(user => {
+     *     console.log(`${user.firstName} - ${user.email} - Active: ${user.isActive}`);
      *   });
      * } catch (error) {
      *   console.log('Admin access required');
      * }
      * ```
+     *
+     * @example With Sorting
+     * ```typescript
+     * import { SortOrder } from '@explorins/pers-sdk';
+     *
+     * // Get users sorted by email ascending
+     * const result = await sdk.users.getAllUsers({
+     *   page: 1,
+     *   limit: 20,
+     *   sortBy: 'email',
+     *   sortOrder: SortOrder.ASC
+     * });
+     *
+     * // Get users sorted by creation date (newest first)
+     * const recent = await sdk.users.getAllUsers({
+     *   page: 1,
+     *   limit: 10,
+     *   sortBy: 'createdAt',
+     *   sortOrder: SortOrder.DESC
+     * });
+     * ```
      */
-    getAllUsers(options?: PaginationOptions): Promise<PaginatedResponseDTO<UserDTO>>;
+    getAllUsers(options?: PaginationOptions, search?: string): Promise<PaginatedResponseDTO<UserDTO>>;
     /**
      * Business/Admin: Create or update a user
      *

package/dist/managers/user-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-manager.d.ts","sourceRoot":"","sources":["../../src/managers/user-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAW,WAAW,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,qBAAa,WAAW;IAIpB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM,CAAC;IAJjB,OAAO,CAAC,WAAW,CAAc;gBAGvB,SAAS,EAAE,aAAa,EACxB,MAAM,CAAC,8BAAkB;IAMnC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,iBAAiB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAazE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACG,iBAAiB,CAAC,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;IAIlJ;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,WAAW,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAItF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1E;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAI5E;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlF;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD;;;;;;;;;;;;;;;OAeG;IACH,cAAc,IAAI,WAAW;CAI9B"}
+{"version":3,"file":"user-manager.d.ts","sourceRoot":"","sources":["../../src/managers/user-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAW,WAAW,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,qBAAa,WAAW;IAIpB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM,CAAC;IAJjB,OAAO,CAAC,WAAW,CAAc;gBAGvB,SAAS,EAAE,aAAa,EACxB,MAAM,CAAC,8BAAkB;IAMnC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,iBAAiB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAazE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACG,iBAAiB,CAAC,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;IAIlJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuDG;IACG,WAAW,CAAC,OAAO,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAIvG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1E;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAI5E;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlF;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD;;;;;;;;;;;;;;;OAeG;IACH,cAAc,IAAI,WAAW;CAI9B"}

package/dist/node.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var persSdk = require('./chunks/pers-sdk-D5lE9ZFW.cjs');
+var persSdk = require('./chunks/pers-sdk-Di_R6AiT.cjs');
 var persShared = require('@explorins/pers-shared');
 var nodeHttpClient = require('./chunks/node-http-client-D_avaa5F.cjs');
 require('./chunks/index-B-g2JPVK.cjs');
@@ -10,11 +10,11 @@ require('./user-status.cjs');
 require('./chunks/token-service-BlbXrxnS.cjs');
 require('./chunks/business-membership-service-8KC_qRj7.cjs');
 require('./campaign.cjs');
-require('./chunks/redemption-service-rMB6T2W5.cjs');
-require('./chunks/transaction-request.builder-BpgtuMMq.cjs');
+require('./chunks/redemption-service-DsH7sRdv.cjs');
+require('./chunks/transaction-request.builder-CkYd5bl6.cjs');
 require('./chunks/payment-service-Bkw7ZXev.cjs');
 require('./chunks/tenant-service-fj-pkXTw.cjs');
-require('./analytics.cjs');
+require('./chunks/analytics-service-DwkeBB08.cjs');
 require('./donation.cjs');
 
 /**

package/dist/node.js

@@ -1,4 +1,4 @@
-import { j as StaticJwtAuthProvider, P as PersSDK } from './chunks/pers-sdk-DnLw822h.js';
+import { j as StaticJwtAuthProvider, P as PersSDK } from './chunks/pers-sdk-CAM0iQyK.js';
 import { AccountOwnerType } from '@explorins/pers-shared';
 export { AccountOwnerType } from '@explorins/pers-shared';
 import { N as NodeHttpClientAdapter } from './chunks/node-http-client-DloDLfm9.js';
@@ -9,11 +9,11 @@ import './user-status.js';
 import './chunks/token-service-Bfj6C0yz.js';
 import './chunks/business-membership-service-D6vaVQTR.js';
 import './campaign.js';
-import './chunks/redemption-service-D-hBqh42.js';
-import './chunks/transaction-request.builder-C1vVVFto.js';
+import './chunks/redemption-service-CQtTLdic.js';
+import './chunks/transaction-request.builder-C8ahJYwi.js';
 import './chunks/payment-service-IvM6rryM.js';
 import './chunks/tenant-service-CsRA3O2V.js';
-import './analytics.js';
+import './chunks/analytics-service-B9IfG6ox.js';
 import './donation.js';
 
 /**

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-sdk",
-  "version": "2.1.2",
+  "version": "2.1.4",
   "description": "Platform-agnostic SDK for PERS (Phygital Experience Rewards System) - Core business logic and API integration",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -127,7 +127,7 @@
     "publish-with-docs": "npm run clean && npm run build && npm run docs && npm version patch && npm publish"
   },
   "dependencies": {
-    "@explorins/pers-shared": "^2.1.75",
+    "@explorins/pers-shared": "^2.1.92",
     "@explorins/web3-ts": "^0.3.77",
     "ethers": "^6.15.0"
   },