@explorins/pers-sdk 2.1.2 → 2.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/analytics/api/analytics-api.d.ts +175 -1
- package/dist/analytics/api/analytics-api.d.ts.map +1 -1
- package/dist/analytics/models/index.d.ts +2 -5
- package/dist/analytics/models/index.d.ts.map +1 -1
- package/dist/analytics/services/analytics-service.d.ts +32 -1
- package/dist/analytics/services/analytics-service.d.ts.map +1 -1
- package/dist/analytics.cjs +9 -44
- package/dist/analytics.cjs.map +1 -1
- package/dist/analytics.js +2 -45
- package/dist/analytics.js.map +1 -1
- package/dist/campaign/api/campaign-api.d.ts +59 -4
- package/dist/campaign/api/campaign-api.d.ts.map +1 -1
- package/dist/campaign/services/campaign-service.d.ts +49 -7
- package/dist/campaign/services/campaign-service.d.ts.map +1 -1
- package/dist/campaign.cjs +150 -14
- package/dist/campaign.cjs.map +1 -1
- package/dist/campaign.js +150 -14
- package/dist/campaign.js.map +1 -1
- package/dist/chunks/analytics-service-B9IfG6ox.js +271 -0
- package/dist/chunks/analytics-service-B9IfG6ox.js.map +1 -0
- package/dist/chunks/analytics-service-DwkeBB08.cjs +274 -0
- package/dist/chunks/analytics-service-DwkeBB08.cjs.map +1 -0
- package/dist/chunks/{pers-sdk-DnLw822h.js → pers-sdk-CAM0iQyK.js} +1203 -267
- package/dist/chunks/pers-sdk-CAM0iQyK.js.map +1 -0
- package/dist/chunks/{pers-sdk-D5lE9ZFW.cjs → pers-sdk-Di_R6AiT.cjs} +1207 -268
- package/dist/chunks/pers-sdk-Di_R6AiT.cjs.map +1 -0
- package/dist/chunks/{redemption-service-D-hBqh42.js → redemption-service-CQtTLdic.js} +32 -10
- package/dist/chunks/redemption-service-CQtTLdic.js.map +1 -0
- package/dist/chunks/{redemption-service-rMB6T2W5.cjs → redemption-service-DsH7sRdv.cjs} +32 -10
- package/dist/chunks/redemption-service-DsH7sRdv.cjs.map +1 -0
- package/dist/chunks/{transaction-request.builder-C1vVVFto.js → transaction-request.builder-C8ahJYwi.js} +122 -70
- package/dist/chunks/transaction-request.builder-C8ahJYwi.js.map +1 -0
- package/dist/chunks/{transaction-request.builder-BpgtuMMq.cjs → transaction-request.builder-CkYd5bl6.cjs} +122 -70
- package/dist/chunks/transaction-request.builder-CkYd5bl6.cjs.map +1 -0
- package/dist/core/auth/auth-provider.interface.d.ts +1 -0
- package/dist/core/auth/auth-provider.interface.d.ts.map +1 -1
- package/dist/core/auth/default-auth-provider.d.ts +2 -0
- package/dist/core/auth/default-auth-provider.d.ts.map +1 -1
- package/dist/core/auth/refresh-manager.d.ts +2 -0
- package/dist/core/auth/refresh-manager.d.ts.map +1 -1
- package/dist/core/auth/services/auth-service.d.ts.map +1 -1
- package/dist/core/auth/token-storage.d.ts +2 -1
- package/dist/core/auth/token-storage.d.ts.map +1 -1
- package/dist/core/pers-api-client.d.ts.map +1 -1
- package/dist/core/pers-config.d.ts +0 -18
- package/dist/core/pers-config.d.ts.map +1 -1
- package/dist/core.cjs +5 -4
- package/dist/core.cjs.map +1 -1
- package/dist/core.js +4 -4
- package/dist/index.cjs +13 -6
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +5 -5
- package/dist/managers/analytics-manager.d.ts +165 -2
- package/dist/managers/analytics-manager.d.ts.map +1 -1
- package/dist/managers/campaign-manager.d.ts +180 -30
- package/dist/managers/campaign-manager.d.ts.map +1 -1
- package/dist/managers/index.d.ts +1 -0
- package/dist/managers/index.d.ts.map +1 -1
- package/dist/managers/redemption-manager.d.ts +52 -2
- package/dist/managers/redemption-manager.d.ts.map +1 -1
- package/dist/managers/transaction-manager.d.ts +66 -131
- package/dist/managers/transaction-manager.d.ts.map +1 -1
- package/dist/managers/trigger-source-manager.d.ts +194 -0
- package/dist/managers/trigger-source-manager.d.ts.map +1 -0
- package/dist/managers/user-manager.d.ts +38 -7
- package/dist/managers/user-manager.d.ts.map +1 -1
- package/dist/node.cjs +4 -4
- package/dist/node.js +4 -4
- package/dist/package.json +2 -2
- package/dist/pers-sdk.d.ts +68 -23
- package/dist/pers-sdk.d.ts.map +1 -1
- package/dist/redemption/api/redemption-api.d.ts +8 -4
- package/dist/redemption/api/redemption-api.d.ts.map +1 -1
- package/dist/redemption/services/redemption-service.d.ts +7 -3
- package/dist/redemption/services/redemption-service.d.ts.map +1 -1
- package/dist/redemption.cjs +1 -1
- package/dist/redemption.js +1 -1
- package/dist/transaction/api/transaction-api.d.ts +37 -42
- package/dist/transaction/api/transaction-api.d.ts.map +1 -1
- package/dist/transaction/models/index.d.ts +21 -0
- package/dist/transaction/models/index.d.ts.map +1 -1
- package/dist/transaction/services/transaction-service.d.ts +10 -15
- package/dist/transaction/services/transaction-service.d.ts.map +1 -1
- package/dist/transaction.cjs +1 -1
- package/dist/transaction.js +1 -1
- package/dist/trigger-source/api/trigger-source-api.d.ts +86 -0
- package/dist/trigger-source/api/trigger-source-api.d.ts.map +1 -0
- package/dist/trigger-source/index.d.ts +9 -0
- package/dist/trigger-source/index.d.ts.map +1 -0
- package/dist/trigger-source/services/trigger-source-service.d.ts +42 -0
- package/dist/trigger-source/services/trigger-source-service.d.ts.map +1 -0
- package/dist/user/api/user-api.d.ts +26 -1
- package/dist/user/api/user-api.d.ts.map +1 -1
- package/dist/user/services/user-service.d.ts +3 -1
- package/dist/user/services/user-service.d.ts.map +1 -1
- package/dist/user.cjs +34 -4
- package/dist/user.cjs.map +1 -1
- package/dist/user.js +34 -4
- package/dist/user.js.map +1 -1
- package/package.json +2 -2
- package/dist/chunks/pers-sdk-D5lE9ZFW.cjs.map +0 -1
- package/dist/chunks/pers-sdk-DnLw822h.js.map +0 -1
- package/dist/chunks/redemption-service-D-hBqh42.js.map +0 -1
- package/dist/chunks/redemption-service-rMB6T2W5.cjs.map +0 -1
- package/dist/chunks/transaction-request.builder-BpgtuMMq.cjs.map +0 -1
- package/dist/chunks/transaction-request.builder-C1vVVFto.js.map +0 -1
package/dist/pers-sdk.d.ts
CHANGED
|
@@ -24,7 +24,8 @@
|
|
|
24
24
|
* │ ├── users: UserManager // User profile management
|
|
25
25
|
* │ ├── tokens: TokenManager // Token balances & transfers
|
|
26
26
|
* │ ├── businesses: BusinessManager // Business operations
|
|
27
|
-
* │ ├── campaigns: CampaignManager // Marketing campaigns
|
|
27
|
+
* │ ├── campaigns: CampaignManager // Marketing campaigns + trigger rules
|
|
28
|
+
* │ ├── triggerSources: TriggerSourceManager // Campaign activation points
|
|
28
29
|
* │ ├── redemptions: RedemptionManager // Reward redemptions
|
|
29
30
|
* │ ├── transactions: TransactionManager // Transaction history
|
|
30
31
|
* │ ├── purchases: PurchaseManager // Purchase processing
|
|
@@ -168,7 +169,8 @@ import { HttpClient } from './core/abstractions/http-client';
|
|
|
168
169
|
import { PersConfig } from './core/pers-config';
|
|
169
170
|
import { PersApiClient } from './core/pers-api-client';
|
|
170
171
|
import { PersEventEmitter } from './core/events';
|
|
171
|
-
import {
|
|
172
|
+
import { UserDTO } from '@explorins/pers-shared';
|
|
173
|
+
import { AuthManager, UserManager, UserStatusManager, TokenManager, BusinessManager, CampaignManager, RedemptionManager, TransactionManager, PurchaseManager, FileManager, TenantManager, ApiKeyManager, AnalyticsManager, DonationManager, TriggerSourceManager } from './managers';
|
|
172
174
|
/**
|
|
173
175
|
* PERS SDK - Main SDK class with domain managers
|
|
174
176
|
*
|
|
@@ -229,20 +231,21 @@ import { AuthManager, UserManager, UserStatusManager, TokenManager, BusinessMana
|
|
|
229
231
|
export declare class PersSDK {
|
|
230
232
|
private apiClient;
|
|
231
233
|
private _events;
|
|
232
|
-
private _auth
|
|
233
|
-
private _users
|
|
234
|
-
private _userStatus
|
|
235
|
-
private _tokens
|
|
236
|
-
private _businesses
|
|
237
|
-
private _campaigns
|
|
238
|
-
private _redemptions
|
|
239
|
-
private _transactions
|
|
240
|
-
private _purchases
|
|
241
|
-
private _files
|
|
242
|
-
private _tenants
|
|
243
|
-
private _apiKeys
|
|
244
|
-
private _analytics
|
|
245
|
-
private _donations
|
|
234
|
+
private _auth?;
|
|
235
|
+
private _users?;
|
|
236
|
+
private _userStatus?;
|
|
237
|
+
private _tokens?;
|
|
238
|
+
private _businesses?;
|
|
239
|
+
private _campaigns?;
|
|
240
|
+
private _redemptions?;
|
|
241
|
+
private _transactions?;
|
|
242
|
+
private _purchases?;
|
|
243
|
+
private _files?;
|
|
244
|
+
private _tenants?;
|
|
245
|
+
private _apiKeys?;
|
|
246
|
+
private _analytics?;
|
|
247
|
+
private _donations?;
|
|
248
|
+
private _triggerSources?;
|
|
246
249
|
/**
|
|
247
250
|
* Creates a new PERS SDK instance
|
|
248
251
|
*
|
|
@@ -287,18 +290,31 @@ export declare class PersSDK {
|
|
|
287
290
|
*/
|
|
288
291
|
constructor(httpClient: HttpClient, config: PersConfig);
|
|
289
292
|
/**
|
|
290
|
-
* Restore user session
|
|
293
|
+
* Restore user session from stored tokens
|
|
291
294
|
*
|
|
292
|
-
*
|
|
293
|
-
*
|
|
294
|
-
*
|
|
295
|
+
* Call this method after SDK initialization to restore the user's session
|
|
296
|
+
* if valid tokens exist. This is useful for maintaining login state across
|
|
297
|
+
* app restarts.
|
|
298
|
+
*
|
|
299
|
+
* **Important:** Only works for USER and BUSINESS accounts. Admin/tenant
|
|
300
|
+
* accounts don't support user data fetching, so this will return null for them
|
|
301
|
+
* (though their tokens remain valid for API calls).
|
|
295
302
|
*
|
|
296
303
|
* Emits auth domain success event when session is restored.
|
|
297
304
|
*
|
|
298
|
-
* @
|
|
299
|
-
* @
|
|
305
|
+
* @returns Promise resolving to User data if session restored, null if no session or admin account
|
|
306
|
+
* @throws {PersError} If token validation or user fetch fails
|
|
307
|
+
*
|
|
308
|
+
* @example
|
|
309
|
+
* ```typescript
|
|
310
|
+
* // Call after initial render for better perceived performance
|
|
311
|
+
* const user = await sdk.restoreSession();
|
|
312
|
+
* if (user) {
|
|
313
|
+
* console.log('Welcome back,', user.name);
|
|
314
|
+
* }
|
|
315
|
+
* ```
|
|
300
316
|
*/
|
|
301
|
-
|
|
317
|
+
restoreSession(): Promise<UserDTO | null>;
|
|
302
318
|
/**
|
|
303
319
|
* Event emitter - Subscribe to SDK-wide events
|
|
304
320
|
*
|
|
@@ -533,6 +549,35 @@ export declare class PersSDK {
|
|
|
533
549
|
* ```
|
|
534
550
|
*/
|
|
535
551
|
get donations(): DonationManager;
|
|
552
|
+
/**
|
|
553
|
+
* TriggerSource manager - High-level trigger source operations (Admin Only)
|
|
554
|
+
*
|
|
555
|
+
* Provides CRUD operations for managing trigger sources (QR codes, NFC tags,
|
|
556
|
+
* GPS geofences, API webhooks). TriggerSources are standalone entities that
|
|
557
|
+
* can be assigned to campaigns via the campaigns manager.
|
|
558
|
+
*
|
|
559
|
+
* @returns TriggerSourceManager instance
|
|
560
|
+
*
|
|
561
|
+
* @example TriggerSource Operations
|
|
562
|
+
* ```typescript
|
|
563
|
+
* // Create a QR code trigger source
|
|
564
|
+
* const qrSource = await sdk.triggerSources.create({
|
|
565
|
+
* name: 'Store Entrance QR',
|
|
566
|
+
* type: 'QR_CODE',
|
|
567
|
+
* description: 'QR code at main entrance'
|
|
568
|
+
* });
|
|
569
|
+
*
|
|
570
|
+
* // Get all trigger sources
|
|
571
|
+
* const sources = await sdk.triggerSources.getAll();
|
|
572
|
+
*
|
|
573
|
+
* // Update trigger source
|
|
574
|
+
* await sdk.triggerSources.update(sourceId, { name: 'Updated Name' });
|
|
575
|
+
*
|
|
576
|
+
* // Assign to campaign (via campaigns manager)
|
|
577
|
+
* await sdk.campaigns.assignTriggerSource(campaignId, qrSource.id);
|
|
578
|
+
* ```
|
|
579
|
+
*/
|
|
580
|
+
get triggerSources(): TriggerSourceManager;
|
|
536
581
|
/**
|
|
537
582
|
* Gets the API client for direct PERS API requests
|
|
538
583
|
*
|
package/dist/pers-sdk.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"pers-sdk.d.ts","sourceRoot":"","sources":["../src/pers-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH
|
|
1
|
+
{"version":3,"file":"pers-sdk.d.ts","sourceRoot":"","sources":["../src/pers-sdk.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { TokenUnitCreateRequestDTO, RedemptionTypeCreateRequestDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
|
|
2
2
|
import { PersApiClient } from '../../core/pers-api-client';
|
|
3
3
|
import { RedemptionDTO, RedemptionCreateRequestDTO, RedemptionTypeDTO, RedemptionRedeemDTO, RedemptionRedeemRequestResponseDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
|
|
4
|
-
import { PaginatedResponseDTO } from '@explorins/pers-shared';
|
|
4
|
+
import { PaginatedResponseDTO, RedemptionRedeemIncludeRelation } from '@explorins/pers-shared';
|
|
5
5
|
import { PaginationOptions } from '../../shared';
|
|
6
6
|
/**
|
|
7
7
|
* Platform-Agnostic Redemption API Client (UPDATED - RESTful Design)
|
|
@@ -83,6 +83,7 @@ export declare class RedemptionApi {
|
|
|
83
83
|
* @param filters.limit - Items per page (default: 50)
|
|
84
84
|
* @param filters.sortBy - Sort field
|
|
85
85
|
* @param filters.sortOrder - Sort order (asc/desc)
|
|
86
|
+
* @param include - Optional relations to include (redemption, user, business)
|
|
86
87
|
* @returns Paginated response with redemption redeems
|
|
87
88
|
*/
|
|
88
89
|
getRedemptionRedeems(filters?: {
|
|
@@ -90,20 +91,23 @@ export declare class RedemptionApi {
|
|
|
90
91
|
userId?: string;
|
|
91
92
|
businessId?: string;
|
|
92
93
|
myRedeems?: boolean;
|
|
93
|
-
} & PaginationOptions): Promise<PaginatedResponseDTO<RedemptionRedeemDTO>>;
|
|
94
|
+
} & PaginationOptions, include?: RedemptionRedeemIncludeRelation[]): Promise<PaginatedResponseDTO<RedemptionRedeemDTO>>;
|
|
94
95
|
/**
|
|
95
96
|
* UNIFIED: Get specific redemption redeem by ID
|
|
97
|
+
* @param id - Redemption redeem ID
|
|
98
|
+
* @param include - Optional relations to include (redemption, user, business)
|
|
96
99
|
*/
|
|
97
|
-
getRedemptionRedeemById(id: string): Promise<RedemptionRedeemDTO>;
|
|
100
|
+
getRedemptionRedeemById(id: string, include?: RedemptionRedeemIncludeRelation[]): Promise<RedemptionRedeemDTO>;
|
|
98
101
|
/**
|
|
99
102
|
* UNIFIED: Get user redemption history
|
|
100
103
|
*
|
|
101
104
|
* Uses convenience endpoint /redemption-redeems/me with optional filtering
|
|
102
105
|
* @param redemptionId - Optional filter by specific redemption
|
|
103
106
|
* @param options - Pagination options (page, limit, sortBy, sortOrder)
|
|
107
|
+
* @param include - Optional relations to include (redemption, user, business)
|
|
104
108
|
* @returns Paginated response with user's redemption redeems
|
|
105
109
|
*/
|
|
106
|
-
getUserRedeems(redemptionId?: string, options?: PaginationOptions): Promise<PaginatedResponseDTO<RedemptionRedeemDTO>>;
|
|
110
|
+
getUserRedeems(redemptionId?: string, options?: PaginationOptions, include?: RedemptionRedeemIncludeRelation[]): Promise<PaginatedResponseDTO<RedemptionRedeemDTO>>;
|
|
107
111
|
/**
|
|
108
112
|
* ADMIN: Create redemption
|
|
109
113
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"redemption-api.d.ts","sourceRoot":"","sources":["../../../src/redemption/api/redemption-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,MAAM,oDAAoD,CAAC;AAC/H,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EACL,aAAa,EACb,0BAA0B,EAE1B,iBAAiB,EACjB,mBAAmB,EACnB,kCAAkC,EACnC,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;
|
|
1
|
+
{"version":3,"file":"redemption-api.d.ts","sourceRoot":"","sources":["../../../src/redemption/api/redemption-api.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { PaginatedResponseDTO } from '@explorins/pers-shared';
|
|
1
|
+
import { PaginatedResponseDTO, RedemptionRedeemIncludeRelation } from '@explorins/pers-shared';
|
|
2
2
|
import { RedemptionApi } from '../api/redemption-api';
|
|
3
3
|
import { TokenUnitCreateRequestDTO, RedemptionDTO, RedemptionCreateRequestDTO, RedemptionTypeDTO, RedemptionRedeemDTO, RedemptionRedeemRequestResponseDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
|
|
4
4
|
import { PaginationOptions } from '../../shared/utils/pagination-utils';
|
|
@@ -36,17 +36,21 @@ export declare class RedemptionService {
|
|
|
36
36
|
redeemRedemption(redemptionId: string): Promise<RedemptionRedeemRequestResponseDTO>;
|
|
37
37
|
/**
|
|
38
38
|
* UNIFIED: Get redemption redeems with filtering and pagination
|
|
39
|
+
* @param filters - Filter options
|
|
40
|
+
* @param include - Optional relations to include (redemption, user, business)
|
|
39
41
|
*/
|
|
40
42
|
getRedemptionRedeems(filters?: {
|
|
41
43
|
redemptionId?: string;
|
|
42
44
|
userId?: string;
|
|
43
45
|
businessId?: string;
|
|
44
46
|
myRedeems?: boolean;
|
|
45
|
-
}): Promise<PaginatedResponseDTO<RedemptionRedeemDTO>>;
|
|
47
|
+
}, include?: RedemptionRedeemIncludeRelation[]): Promise<PaginatedResponseDTO<RedemptionRedeemDTO>>;
|
|
46
48
|
/**
|
|
47
49
|
* Convenience: Get user redemptions with pagination
|
|
50
|
+
* @param options - Pagination options
|
|
51
|
+
* @param include - Optional relations to include (redemption, user, business)
|
|
48
52
|
*/
|
|
49
|
-
getUserRedeems(options?: PaginationOptions): Promise<PaginatedResponseDTO<RedemptionRedeemDTO>>;
|
|
53
|
+
getUserRedeems(options?: PaginationOptions, include?: RedemptionRedeemIncludeRelation[]): Promise<PaginatedResponseDTO<RedemptionRedeemDTO>>;
|
|
50
54
|
/**
|
|
51
55
|
* Convenience: Get redemptions as admin
|
|
52
56
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"redemption-service.d.ts","sourceRoot":"","sources":["../../../src/redemption/services/redemption-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;
|
|
1
|
+
{"version":3,"file":"redemption-service.d.ts","sourceRoot":"","sources":["../../../src/redemption/services/redemption-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,0BAA0B,EAC1B,iBAAiB,EACjB,mBAAmB,EACnB,kCAAkC,EACnC,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAMhD;;;;OAIG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAIzH;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAItD;;OAEG;IACG,kBAAkB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;IAQvG;;OAEG;IACG,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,kCAAkC,CAAC;IAIzF;;;;OAIG;IACG,oBAAoB,CACxB,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,EACD,OAAO,CAAC,EAAE,+BAA+B,EAAE,GAC1C,OAAO,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;IAIrD;;;;OAIG;IACG,cAAc,CAClB,OAAO,CAAC,EAAE,iBAAiB,EAC3B,OAAO,CAAC,EAAE,+BAA+B,EAAE,GAC1C,OAAO,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;IAQrD;;OAEG;IACG,qBAAqB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAIxH;;OAEG;IACG,gBAAgB,CAAC,UAAU,EAAE,0BAA0B,GAAG,OAAO,CAAC,aAAa,CAAC;IAItF;;OAEG;IACG,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,uBAAuB,EAAE,0BAA0B,GAAG,OAAO,CAAC,aAAa,CAAC;IAI/G;;OAEG;IACG,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI1E;;OAEG;IACG,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,mBAAmB,EAAE,yBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;IAI7H;;OAEG;IACG,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAG7G"}
|
package/dist/redemption.cjs
CHANGED
package/dist/redemption.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export { R as RedemptionApi, a as RedemptionService } from './chunks/redemption-service-
|
|
1
|
+
export { R as RedemptionApi, a as RedemptionService } from './chunks/redemption-service-CQtTLdic.js';
|
|
2
2
|
import '@explorins/pers-shared';
|
|
3
3
|
import './chunks/pagination-utils-9vQ-Npkr.js';
|
|
4
4
|
//# sourceMappingURL=redemption.js.map
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import { PaginatedResponseDTO, TransactionAnalyticsRequestDTO, TransactionAnalyticsResponseDTO, TransactionPaginationRequestDTO,
|
|
1
|
+
import { PaginatedResponseDTO, TransactionAnalyticsRequestDTO, TransactionAnalyticsResponseDTO, TransactionPaginationRequestDTO, TransactionIncludeRelation } from '@explorins/pers-shared';
|
|
2
2
|
import { PersApiClient } from '../../core/pers-api-client';
|
|
3
3
|
import { TransactionDTO, TransactionRequestDTO, AccountSelectorDTO, TransactionRequestResponseDTO, TransactionSubmissionRequestDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
|
|
4
|
-
import {
|
|
4
|
+
import { TransactionQueryOptions } from '../models';
|
|
5
5
|
/**
|
|
6
6
|
* Platform-Agnostic Transaction API Client (UPDATED FOR NEW RESTful ENDPOINTS)
|
|
7
7
|
*
|
|
@@ -23,21 +23,31 @@ export declare class TransactionApi {
|
|
|
23
23
|
* Get transaction by ID (public endpoint)
|
|
24
24
|
*
|
|
25
25
|
* UPDATED: /transaction/{id} → /transactions/{id}
|
|
26
|
+
* UPDATED: Added support for include parameter to enrich with sender/recipient/business entities
|
|
27
|
+
*
|
|
28
|
+
* @param transactionId - Transaction ID
|
|
29
|
+
* @param include - Optional relations to include (sender, recipient, business)
|
|
26
30
|
*/
|
|
27
|
-
getTransactionById(transactionId: string): Promise<TransactionDTO>;
|
|
31
|
+
getTransactionById(transactionId: string, include?: TransactionIncludeRelation[]): Promise<TransactionDTO>;
|
|
28
32
|
/**
|
|
29
33
|
* Unique method to create a transaction
|
|
30
34
|
* @param request
|
|
31
35
|
* @returns
|
|
32
36
|
*/
|
|
33
37
|
createTransaction(request: TransactionRequestDTO): Promise<TransactionRequestResponseDTO>;
|
|
38
|
+
/**
|
|
39
|
+
* Helper to build query params from TransactionQueryOptions
|
|
40
|
+
* Handles all filter options and include parameter
|
|
41
|
+
*/
|
|
42
|
+
private buildTransactionQueryParams;
|
|
34
43
|
/**
|
|
35
44
|
* AUTH: Get user transaction history with role-based filtering and pagination
|
|
36
45
|
*
|
|
37
|
-
* UPDATED: Uses consolidated /transactions/me endpoint with
|
|
38
|
-
*
|
|
46
|
+
* UPDATED: Uses consolidated /transactions/me endpoint with all filter options
|
|
47
|
+
* UPDATED: Added support for include parameter to enrich with sender/recipient/business entities
|
|
48
|
+
* UPDATED: Now supports all TransactionFiltersDTO filters (triggerProcessId, status, type, etc.)
|
|
39
49
|
*
|
|
40
|
-
* @param options - Pagination and
|
|
50
|
+
* @param options - Pagination, filter, and include options
|
|
41
51
|
* @returns Paginated list of user's transactions
|
|
42
52
|
*
|
|
43
53
|
* @example
|
|
@@ -45,20 +55,29 @@ export declare class TransactionApi {
|
|
|
45
55
|
* // Get first page of all transactions
|
|
46
56
|
* const page1 = await transactionApi.getUserTransactionHistory();
|
|
47
57
|
*
|
|
48
|
-
* // Filter by role
|
|
49
|
-
* const
|
|
58
|
+
* // Filter by role and status
|
|
59
|
+
* const completed = await transactionApi.getUserTransactionHistory({
|
|
50
60
|
* role: TransactionRole.SENDER,
|
|
61
|
+
* status: TransactionStatus.COMPLETED,
|
|
51
62
|
* page: 1,
|
|
52
63
|
* limit: 50
|
|
53
64
|
* });
|
|
54
65
|
*
|
|
55
|
-
* //
|
|
56
|
-
*
|
|
66
|
+
* // Filter by trigger process (e.g., from campaign claim or redemption)
|
|
67
|
+
* const claimTransactions = await transactionApi.getUserTransactionHistory({
|
|
68
|
+
* triggerProcessId: 'claim-abc123',
|
|
69
|
+
* include: ['sender', 'recipient', 'business']
|
|
70
|
+
* });
|
|
71
|
+
*
|
|
72
|
+
* // Access included entities
|
|
73
|
+
* claimTransactions.data.forEach(tx => {
|
|
74
|
+
* if (tx.included?.engagedBusiness) {
|
|
75
|
+
* console.log('Business:', tx.included.engagedBusiness.displayName);
|
|
76
|
+
* }
|
|
77
|
+
* });
|
|
57
78
|
* ```
|
|
58
79
|
*/
|
|
59
|
-
getUserTransactionHistory(options?:
|
|
60
|
-
role?: TransactionRole;
|
|
61
|
-
} & PaginationOptions): Promise<PaginatedResponseDTO<TransactionDTO>>;
|
|
80
|
+
getUserTransactionHistory(options?: TransactionQueryOptions): Promise<PaginatedResponseDTO<TransactionDTO>>;
|
|
62
81
|
/**
|
|
63
82
|
* AUTH: Prepare existing transaction for client-side signing
|
|
64
83
|
*
|
|
@@ -87,39 +106,15 @@ export declare class TransactionApi {
|
|
|
87
106
|
* UPDATED: /transaction/auth/prepare-signing → /transactions (POST)
|
|
88
107
|
*/
|
|
89
108
|
prepareClientSignedTransaction(request: TransactionRequestDTO): Promise<TransactionRequestResponseDTO>;
|
|
90
|
-
/**
|
|
91
|
-
* ADMIN: Get all tenant transactions with pagination and filtering
|
|
92
|
-
*
|
|
93
|
-
* UPDATED: /transaction/admin → /transactions
|
|
94
|
-
* FIXED: Now correctly returns paginated response (was incorrectly unwrapping to array)
|
|
95
|
-
*
|
|
96
|
-
* @param options - Pagination and filter options
|
|
97
|
-
* @returns Paginated list of tenant transactions
|
|
98
|
-
*
|
|
99
|
-
* @example
|
|
100
|
-
* ```typescript
|
|
101
|
-
* // Get first page
|
|
102
|
-
* const page1 = await transactionApi.getTenantTransactions();
|
|
103
|
-
*
|
|
104
|
-
* // Get specific page with custom limit
|
|
105
|
-
* const page2 = await transactionApi.getTenantTransactions({
|
|
106
|
-
* page: 2,
|
|
107
|
-
* limit: 100
|
|
108
|
-
* });
|
|
109
|
-
*
|
|
110
|
-
* // Access data
|
|
111
|
-
* page1.data.forEach(tx => console.log(tx.id));
|
|
112
|
-
* ```
|
|
113
|
-
*
|
|
114
|
-
* @deprecated Consider using getPaginatedTransactions() for more advanced filtering
|
|
115
|
-
*/
|
|
116
|
-
getTenantTransactions(options?: PaginationOptions): Promise<PaginatedResponseDTO<TransactionDTO>>;
|
|
117
109
|
/**
|
|
118
110
|
* ADMIN: Get paginated transactions with filtering and sorting
|
|
119
111
|
*
|
|
120
112
|
* UPDATED: /transaction/admin → /transactions (same endpoint, better structure)
|
|
113
|
+
*
|
|
114
|
+
* @param params - Pagination request with filters
|
|
115
|
+
* @param include - Optional relations to include (sender, recipient, business)
|
|
121
116
|
*/
|
|
122
|
-
getPaginatedTransactions(params: TransactionPaginationRequestDTO): Promise<PaginatedResponseDTO<TransactionDTO>>;
|
|
117
|
+
getPaginatedTransactions(params: TransactionPaginationRequestDTO, include?: TransactionIncludeRelation[]): Promise<PaginatedResponseDTO<TransactionDTO>>;
|
|
123
118
|
/**
|
|
124
119
|
* ADMIN: Export transactions to CSV
|
|
125
120
|
*
|
|
@@ -147,7 +142,7 @@ export declare class TransactionApi {
|
|
|
147
142
|
getTransactionAnalytics(analyticsRequest: TransactionAnalyticsRequestDTO): Promise<TransactionAnalyticsResponseDTO>;
|
|
148
143
|
/**
|
|
149
144
|
* Helper to convert DTO object to URLSearchParams
|
|
150
|
-
* Handles nested 'filters' object and
|
|
145
|
+
* Handles nested 'filters' object, arrays, and include parameter correctly.
|
|
151
146
|
*/
|
|
152
147
|
private buildQueryParams;
|
|
153
148
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"transaction-api.d.ts","sourceRoot":"","sources":["../../../src/transaction/api/transaction-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,+BAA+B,EAAE,+BAA+B,
|
|
1
|
+
{"version":3,"file":"transaction-api.d.ts","sourceRoot":"","sources":["../../../src/transaction/api/transaction-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,+BAA+B,EAAE,+BAA+B,EAAmB,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAC7M,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,6BAA6B,EAC7B,+BAA+B,EAChC,MAAM,oDAAoD,CAAC;AAE5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAE5C;;;;;;;;OAQG;IACG,kBAAkB,CACtB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,0BAA0B,EAAE,GACrC,OAAO,CAAC,cAAc,CAAC;IAa1B;;;;OAIG;IACG,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAS/F;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IA0DnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACG,yBAAyB,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAOjH;;;;OAIG;IACG,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAI/F;;;;OAIG;IACG,uBAAuB,CAAC,YAAY,EAAE,+BAA+B,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAQpH;;;;OAIG;IASH;;;;OAIG;IAMH;;;;OAIG;IACG,8BAA8B,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAI5G;;;;;;;OAOG;IACG,wBAAwB,CAC5B,MAAM,EAAE,+BAA+B,EACvC,OAAO,CAAC,EAAE,0BAA0B,EAAE,GACrC,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAQhD;;;;OAIG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5C;;;;OAIG;IACH;;KAEC;IACK,yBAAyB,CAAC,eAAe,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAgBnH;;OAEG;IACG,4BAA4B,CAAC,eAAe,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAgBtH;;;;OAIG;IACG,uBAAuB,CAAC,gBAAgB,EAAE,8BAA8B,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAIzH;;;OAGG;IACH,OAAO,CAAC,gBAAgB;CAqCzB"}
|
|
@@ -4,7 +4,28 @@
|
|
|
4
4
|
* Re-exports from @explorins/pers-shared for consistency with backend
|
|
5
5
|
* and to provide a single import source for transaction-related types.
|
|
6
6
|
*/
|
|
7
|
+
import { TransactionRole, TransactionStatus, Web3TransactionType, NativeTokenType, TransactionIncludeRelation } from '@explorins/pers-shared';
|
|
8
|
+
import { PaginationOptions } from '../../shared/utils/pagination-utils';
|
|
7
9
|
export type { TransactionDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
|
|
10
|
+
/**
|
|
11
|
+
* Transaction query options with pagination, filtering, and include support
|
|
12
|
+
* SDK-specific interface for HTTP query string parameters
|
|
13
|
+
* Exposes all available filters from TransactionFiltersDTO
|
|
14
|
+
*/
|
|
15
|
+
export interface TransactionQueryOptions extends PaginationOptions {
|
|
16
|
+
search?: string;
|
|
17
|
+
participantId?: string;
|
|
18
|
+
participantAddress?: string;
|
|
19
|
+
engagedBusinessId?: string;
|
|
20
|
+
businessScopeId?: string;
|
|
21
|
+
triggerProcessId?: string;
|
|
22
|
+
tokenAddress?: string;
|
|
23
|
+
tokenType?: NativeTokenType | NativeTokenType[];
|
|
24
|
+
role?: TransactionRole | TransactionRole[];
|
|
25
|
+
status?: TransactionStatus | TransactionStatus[];
|
|
26
|
+
type?: Web3TransactionType | Web3TransactionType[];
|
|
27
|
+
include?: TransactionIncludeRelation[];
|
|
28
|
+
}
|
|
8
29
|
export { buildMintRequest, buildBurnRequest, buildTransferRequest, buildPOSTransferRequest, buildPOSBurnRequest, buildSubmissionRequest } from './transaction-request.builder';
|
|
9
30
|
export type { POSAuthorizationOptions } from './transaction-request.builder';
|
|
10
31
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transaction/models/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transaction/models/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAC9I,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAGxE,YAAY,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AAEzF;;;;GAIG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAEhE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAG5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAG1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,eAAe,GAAG,eAAe,EAAE,CAAC;IAGhD,IAAI,CAAC,EAAE,eAAe,GAAG,eAAe,EAAE,CAAC;IAC3C,MAAM,CAAC,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,CAAC;IACjD,IAAI,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,CAAC;IAGnD,OAAO,CAAC,EAAE,0BAA0B,EAAE,CAAC;CACxC;AAGD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,+BAA+B,CAAC;AAGvC,YAAY,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC"}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import { PaginatedResponseDTO, TransactionAnalyticsRequestDTO, TransactionAnalyticsResponseDTO, TransactionPaginationRequestDTO, TransactionRequestResponseDTO,
|
|
1
|
+
import { PaginatedResponseDTO, TransactionAnalyticsRequestDTO, TransactionAnalyticsResponseDTO, TransactionPaginationRequestDTO, TransactionRequestResponseDTO, TransactionIncludeRelation } from '@explorins/pers-shared';
|
|
2
2
|
import { AccountSelectorDTO, TransactionDTO, TransactionRequestDTO, TransactionSubmissionRequestDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
|
|
3
3
|
import { TransactionApi } from '../api/transaction-api';
|
|
4
|
-
import {
|
|
4
|
+
import { TransactionQueryOptions } from '../models';
|
|
5
5
|
/**
|
|
6
6
|
* Platform-Agnostic Transaction Service
|
|
7
7
|
*
|
|
@@ -15,21 +15,23 @@ export declare class TransactionService {
|
|
|
15
15
|
constructor(transactionApi: TransactionApi);
|
|
16
16
|
/**
|
|
17
17
|
* Get transaction by ID
|
|
18
|
+
*
|
|
19
|
+
* @param transactionId - Transaction ID
|
|
20
|
+
* @param include - Optional relations to include (sender, recipient, business)
|
|
18
21
|
*/
|
|
19
|
-
getTransactionById(transactionId: string): Promise<TransactionDTO>;
|
|
22
|
+
getTransactionById(transactionId: string, include?: TransactionIncludeRelation[]): Promise<TransactionDTO>;
|
|
20
23
|
/**
|
|
21
24
|
* AUTH: Create authenticated transaction
|
|
22
25
|
*/
|
|
23
26
|
createTransaction(request: TransactionRequestDTO): Promise<TransactionRequestResponseDTO>;
|
|
24
27
|
submitSignedTransaction(signedTxData: TransactionSubmissionRequestDTO): Promise<TransactionRequestResponseDTO>;
|
|
25
28
|
/**
|
|
26
|
-
* AUTH: Get user transaction history
|
|
29
|
+
* AUTH: Get user transaction history with comprehensive filtering
|
|
27
30
|
*
|
|
28
|
-
* @param
|
|
29
|
-
* @param options - Pagination options
|
|
31
|
+
* @param options - Query options including filters, pagination, and include relations
|
|
30
32
|
* @returns Paginated transaction history
|
|
31
33
|
*/
|
|
32
|
-
getUserTransactionHistory(
|
|
34
|
+
getUserTransactionHistory(options?: TransactionQueryOptions): Promise<PaginatedResponseDTO<TransactionDTO>>;
|
|
33
35
|
/**
|
|
34
36
|
* AUTH: Prepare existing transaction for client-side signing
|
|
35
37
|
*/
|
|
@@ -44,17 +46,10 @@ export declare class TransactionService {
|
|
|
44
46
|
/**
|
|
45
47
|
* ADMIN: Create admin transaction
|
|
46
48
|
*/
|
|
47
|
-
/**
|
|
48
|
-
* ADMIN: Get all tenant transactions with pagination
|
|
49
|
-
*
|
|
50
|
-
* @param options - Pagination options
|
|
51
|
-
* @returns Paginated tenant transactions
|
|
52
|
-
*/
|
|
53
|
-
getTenantTransactions(options?: PaginationOptions): Promise<PaginatedResponseDTO<TransactionDTO>>;
|
|
54
49
|
/**
|
|
55
50
|
* ADMIN: Get paginated transactions with filtering and sorting
|
|
56
51
|
*/
|
|
57
|
-
getPaginatedTransactions(params: TransactionPaginationRequestDTO): Promise<PaginatedResponseDTO<TransactionDTO>>;
|
|
52
|
+
getPaginatedTransactions(params: TransactionPaginationRequestDTO, include?: TransactionIncludeRelation[]): Promise<PaginatedResponseDTO<TransactionDTO>>;
|
|
58
53
|
/**
|
|
59
54
|
* ADMIN: Export transactions to CSV
|
|
60
55
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"transaction-service.d.ts","sourceRoot":"","sources":["../../../src/transaction/services/transaction-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,+BAA+B,EAAE,+BAA+B,EAAE,6BAA6B,
|
|
1
|
+
{"version":3,"file":"transaction-service.d.ts","sourceRoot":"","sources":["../../../src/transaction/services/transaction-service.ts"],"names":[],"mappings":"AAAA,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,oDAAoD,CAAC;AAChK,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAEpD;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IACjB,OAAO,CAAC,cAAc;gBAAd,cAAc,EAAE,cAAc;IAElD;;;;;OAKG;IACG,kBAAkB,CACtB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,0BAA0B,EAAE,GACrC,OAAO,CAAC,cAAc,CAAC;IAQ1B;;OAEG;IAKG,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAIzF,uBAAuB,CAAC,YAAY,EAAE,+BAA+B,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAIpH;;;;;OAKG;IACG,yBAAyB,CAC7B,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAIhD;;OAEG;IACG,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAI/F;;OAEG;IACG,8BAA8B,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAQ5G;;OAEG;IASH;;OAEG;IAKH;;OAEG;IACG,wBAAwB,CAC5B,MAAM,EAAE,+BAA+B,EACvC,OAAO,CAAC,EAAE,0BAA0B,EAAE,GACrC,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAIhD;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5C;;OAEG;IACG,yBAAyB,CAAC,eAAe,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAInH;;OAEG;IACG,4BAA4B,CAAC,eAAe,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAItH;;OAEG;IACG,uBAAuB,CAAC,gBAAgB,EAAE,8BAA8B,GAAG,OAAO,CAAC,+BAA+B,CAAC;CAG1H"}
|
package/dist/transaction.cjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
|
|
3
|
-
var transactionRequest_builder = require('./chunks/transaction-request.builder-
|
|
3
|
+
var transactionRequest_builder = require('./chunks/transaction-request.builder-CkYd5bl6.cjs');
|
|
4
4
|
require('@explorins/pers-shared');
|
|
5
5
|
require('./chunks/pagination-utils-B2jRHMSO.cjs');
|
|
6
6
|
|
package/dist/transaction.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export { C as ClientTransactionType, T as TransactionApi, a as TransactionService, d as buildBurnRequest, c as buildMintRequest, h as buildPOSBurnRequest, g as buildPOSTransferRequest, b as buildPendingTransactionData, i as buildSubmissionRequest, f as buildTransferRequest, e as extractDeadlineFromSigningData } from './chunks/transaction-request.builder-
|
|
1
|
+
export { C as ClientTransactionType, T as TransactionApi, a as TransactionService, d as buildBurnRequest, c as buildMintRequest, h as buildPOSBurnRequest, g as buildPOSTransferRequest, b as buildPendingTransactionData, i as buildSubmissionRequest, f as buildTransferRequest, e as extractDeadlineFromSigningData } from './chunks/transaction-request.builder-C8ahJYwi.js';
|
|
2
2
|
import '@explorins/pers-shared';
|
|
3
3
|
import './chunks/pagination-utils-9vQ-Npkr.js';
|
|
4
4
|
//# sourceMappingURL=transaction.js.map
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
import { PaginatedResponseDTO, SortOrder, TriggerSourceDTO, TriggerSourceCreateRequestDTO, TriggerSourceType } from '@explorins/pers-shared';
|
|
2
|
+
import { PersApiClient } from '../../core/pers-api-client';
|
|
3
|
+
/**
|
|
4
|
+
* Platform-Agnostic TriggerSource API Client
|
|
5
|
+
*
|
|
6
|
+
* Handles all trigger source operations:
|
|
7
|
+
* - CRUD operations for trigger sources (QR codes, NFC tags, GPS geofences, webhooks, etc.)
|
|
8
|
+
* - Trigger sources are independent entities that can be assigned to campaigns
|
|
9
|
+
*
|
|
10
|
+
* Uses @explorins/pers-shared DTOs for consistency with backend.
|
|
11
|
+
*/
|
|
12
|
+
export declare class TriggerSourceApi {
|
|
13
|
+
private apiClient;
|
|
14
|
+
constructor(apiClient: PersApiClient);
|
|
15
|
+
/**
|
|
16
|
+
* PUBLIC: Get trigger sources with optional filters and pagination
|
|
17
|
+
*
|
|
18
|
+
* @param options - Filter and pagination options
|
|
19
|
+
* @returns Paginated list of trigger sources
|
|
20
|
+
*
|
|
21
|
+
* @example
|
|
22
|
+
* ```typescript
|
|
23
|
+
* // Get all QR code trigger sources
|
|
24
|
+
* const qrSources = await triggerSourceApi.getTriggerSources({ type: 'QR_CODE' });
|
|
25
|
+
*
|
|
26
|
+
* // Get trigger sources for a specific campaign
|
|
27
|
+
* const campaignSources = await triggerSourceApi.getTriggerSources({
|
|
28
|
+
* campaignId: 'campaign-123',
|
|
29
|
+
* page: 1,
|
|
30
|
+
* limit: 20
|
|
31
|
+
* });
|
|
32
|
+
* ```
|
|
33
|
+
*/
|
|
34
|
+
getTriggerSources(options?: {
|
|
35
|
+
type?: TriggerSourceType;
|
|
36
|
+
businessId?: string;
|
|
37
|
+
campaignId?: string;
|
|
38
|
+
active?: boolean;
|
|
39
|
+
page?: number;
|
|
40
|
+
limit?: number;
|
|
41
|
+
sortBy?: 'name' | 'createdAt' | 'type';
|
|
42
|
+
sortOrder?: SortOrder;
|
|
43
|
+
}): Promise<PaginatedResponseDTO<TriggerSourceDTO>>;
|
|
44
|
+
/**
|
|
45
|
+
* PUBLIC: Get trigger source by ID
|
|
46
|
+
*
|
|
47
|
+
* @param triggerSourceId - UUID of the trigger source
|
|
48
|
+
* @returns Trigger source details
|
|
49
|
+
*/
|
|
50
|
+
getTriggerSourceById(triggerSourceId: string): Promise<TriggerSourceDTO>;
|
|
51
|
+
/**
|
|
52
|
+
* ADMIN: Create a new trigger source
|
|
53
|
+
*
|
|
54
|
+
* @param triggerSource - Trigger source creation data
|
|
55
|
+
* @returns Created trigger source
|
|
56
|
+
*
|
|
57
|
+
* @example
|
|
58
|
+
* ```typescript
|
|
59
|
+
* const qrSource = await triggerSourceApi.createTriggerSource({
|
|
60
|
+
* type: 'QR_CODE',
|
|
61
|
+
* name: 'Store Entrance QR',
|
|
62
|
+
* description: 'QR code at main entrance',
|
|
63
|
+
* businessId: 'business-123',
|
|
64
|
+
* coordsLatitude: 47.6062,
|
|
65
|
+
* coordsLongitude: -122.3321
|
|
66
|
+
* });
|
|
67
|
+
* ```
|
|
68
|
+
*/
|
|
69
|
+
createTriggerSource(triggerSource: TriggerSourceCreateRequestDTO): Promise<TriggerSourceDTO>;
|
|
70
|
+
/**
|
|
71
|
+
* ADMIN: Update a trigger source
|
|
72
|
+
*
|
|
73
|
+
* @param triggerSourceId - UUID of the trigger source to update
|
|
74
|
+
* @param triggerSource - Updated trigger source data (partial)
|
|
75
|
+
* @returns Updated trigger source
|
|
76
|
+
*/
|
|
77
|
+
updateTriggerSource(triggerSourceId: string, triggerSource: Partial<TriggerSourceCreateRequestDTO>): Promise<TriggerSourceDTO>;
|
|
78
|
+
/**
|
|
79
|
+
* ADMIN: Delete (soft delete) a trigger source
|
|
80
|
+
*
|
|
81
|
+
* @param triggerSourceId - UUID of the trigger source to delete
|
|
82
|
+
* @returns Success status
|
|
83
|
+
*/
|
|
84
|
+
deleteTriggerSource(triggerSourceId: string): Promise<boolean>;
|
|
85
|
+
}
|
|
86
|
+
//# sourceMappingURL=trigger-source-api.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"trigger-source-api.d.ts","sourceRoot":"","sources":["../../../src/trigger-source/api/trigger-source-api.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,4BAA4B,CAAC;AAG3D;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE5C;;;;;;;;;;;;;;;;;;OAkBG;IACG,iBAAiB,CAAC,OAAO,CAAC,EAAE;QAChC,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;IAcnD;;;;;OAKG;IACG,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI9E;;;;;;;;;;;;;;;;;OAiBG;IACG,mBAAmB,CAAC,aAAa,EAAE,6BAA6B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIlG;;;;;;OAMG;IACG,mBAAmB,CACvB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,OAAO,CAAC,6BAA6B,CAAC,GACpD,OAAO,CAAC,gBAAgB,CAAC;IAI5B;;;;;OAKG;IACG,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGrE"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @explorins/pers-sdk - TriggerSource Domain
|
|
3
|
+
*
|
|
4
|
+
* Platform-agnostic TriggerSource SDK for PERS ecosystem
|
|
5
|
+
* Handles trigger source operations (QR codes, NFC tags, GPS geofences, webhooks, etc.)
|
|
6
|
+
*/
|
|
7
|
+
export { TriggerSourceApi } from './api/trigger-source-api';
|
|
8
|
+
export { TriggerSourceService } from './services/trigger-source-service';
|
|
9
|
+
//# sourceMappingURL=index.d.ts.map
|