@explorins/pers-sdk 2.1.3 → 2.1.6

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.
Files changed (127) hide show
  1. package/dist/analytics/api/analytics-api.d.ts +175 -1
  2. package/dist/analytics/api/analytics-api.d.ts.map +1 -1
  3. package/dist/analytics/models/index.d.ts +2 -5
  4. package/dist/analytics/models/index.d.ts.map +1 -1
  5. package/dist/analytics/services/analytics-service.d.ts +32 -1
  6. package/dist/analytics/services/analytics-service.d.ts.map +1 -1
  7. package/dist/analytics.cjs +9 -44
  8. package/dist/analytics.cjs.map +1 -1
  9. package/dist/analytics.js +2 -45
  10. package/dist/analytics.js.map +1 -1
  11. package/dist/campaign/api/campaign-api.d.ts +59 -4
  12. package/dist/campaign/api/campaign-api.d.ts.map +1 -1
  13. package/dist/campaign/index.d.ts +1 -0
  14. package/dist/campaign/index.d.ts.map +1 -1
  15. package/dist/campaign/models/index.d.ts +31 -0
  16. package/dist/campaign/models/index.d.ts.map +1 -0
  17. package/dist/campaign/services/campaign-service.d.ts +49 -7
  18. package/dist/campaign/services/campaign-service.d.ts.map +1 -1
  19. package/dist/campaign.cjs +150 -14
  20. package/dist/campaign.cjs.map +1 -1
  21. package/dist/campaign.js +150 -14
  22. package/dist/campaign.js.map +1 -1
  23. package/dist/chunks/analytics-service-B9IfG6ox.js +271 -0
  24. package/dist/chunks/analytics-service-B9IfG6ox.js.map +1 -0
  25. package/dist/chunks/analytics-service-DwkeBB08.cjs +274 -0
  26. package/dist/chunks/analytics-service-DwkeBB08.cjs.map +1 -0
  27. package/dist/chunks/{pers-sdk-fWg-J3_h.js → pers-sdk-BtvhucPY.js} +845 -208
  28. package/dist/chunks/pers-sdk-BtvhucPY.js.map +1 -0
  29. package/dist/chunks/{pers-sdk-BQw3QUWR.cjs → pers-sdk-D4XVDZk3.cjs} +847 -209
  30. package/dist/chunks/pers-sdk-D4XVDZk3.cjs.map +1 -0
  31. package/dist/chunks/{redemption-service-rMB6T2W5.cjs → redemption-service-C61Qr2vI.cjs} +34 -24
  32. package/dist/chunks/redemption-service-C61Qr2vI.cjs.map +1 -0
  33. package/dist/chunks/{redemption-service-D-hBqh42.js → redemption-service-C_UTTDag.js} +34 -24
  34. package/dist/chunks/redemption-service-C_UTTDag.js.map +1 -0
  35. package/dist/chunks/{transaction-request.builder-BpgtuMMq.cjs → transaction-request.builder-B7n7tc1e.cjs} +120 -70
  36. package/dist/chunks/transaction-request.builder-B7n7tc1e.cjs.map +1 -0
  37. package/dist/chunks/{transaction-request.builder-C1vVVFto.js → transaction-request.builder-VbJpI34c.js} +121 -71
  38. package/dist/chunks/transaction-request.builder-VbJpI34c.js.map +1 -0
  39. package/dist/core/auth/api/auth-api.d.ts +1 -4
  40. package/dist/core/auth/api/auth-api.d.ts.map +1 -1
  41. package/dist/core/auth/index.d.ts +1 -1
  42. package/dist/core/auth/index.d.ts.map +1 -1
  43. package/dist/core/auth/services/auth-service.d.ts +1 -4
  44. package/dist/core/auth/services/auth-service.d.ts.map +1 -1
  45. package/dist/core/pers-api-client.d.ts.map +1 -1
  46. package/dist/core.cjs +6 -4
  47. package/dist/core.cjs.map +1 -1
  48. package/dist/core.js +5 -4
  49. package/dist/core.js.map +1 -1
  50. package/dist/index.cjs +14 -6
  51. package/dist/index.cjs.map +1 -1
  52. package/dist/index.d.ts +6 -1
  53. package/dist/index.d.ts.map +1 -1
  54. package/dist/index.js +6 -5
  55. package/dist/index.js.map +1 -1
  56. package/dist/managers/analytics-manager.d.ts +165 -2
  57. package/dist/managers/analytics-manager.d.ts.map +1 -1
  58. package/dist/managers/auth-manager.d.ts +1 -2
  59. package/dist/managers/auth-manager.d.ts.map +1 -1
  60. package/dist/managers/campaign-manager.d.ts +186 -50
  61. package/dist/managers/campaign-manager.d.ts.map +1 -1
  62. package/dist/managers/index.d.ts +1 -0
  63. package/dist/managers/index.d.ts.map +1 -1
  64. package/dist/managers/redemption-manager.d.ts +50 -3
  65. package/dist/managers/redemption-manager.d.ts.map +1 -1
  66. package/dist/managers/transaction-manager.d.ts +70 -132
  67. package/dist/managers/transaction-manager.d.ts.map +1 -1
  68. package/dist/managers/trigger-source-manager.d.ts +185 -0
  69. package/dist/managers/trigger-source-manager.d.ts.map +1 -0
  70. package/dist/managers/user-manager.d.ts +30 -7
  71. package/dist/managers/user-manager.d.ts.map +1 -1
  72. package/dist/node.cjs +5 -4
  73. package/dist/node.cjs.map +1 -1
  74. package/dist/node.js +5 -4
  75. package/dist/node.js.map +1 -1
  76. package/dist/package.json +7 -2
  77. package/dist/pers-sdk.d.ts +33 -2
  78. package/dist/pers-sdk.d.ts.map +1 -1
  79. package/dist/redemption/api/redemption-api.d.ts +10 -18
  80. package/dist/redemption/api/redemption-api.d.ts.map +1 -1
  81. package/dist/redemption/index.d.ts +1 -0
  82. package/dist/redemption/index.d.ts.map +1 -1
  83. package/dist/redemption/models/index.d.ts +19 -0
  84. package/dist/redemption/models/index.d.ts.map +1 -1
  85. package/dist/redemption/services/redemption-service.d.ts +7 -3
  86. package/dist/redemption/services/redemption-service.d.ts.map +1 -1
  87. package/dist/redemption.cjs +1 -1
  88. package/dist/redemption.js +1 -1
  89. package/dist/shared/index.d.ts +1 -0
  90. package/dist/shared/index.d.ts.map +1 -1
  91. package/dist/transaction/api/transaction-api.d.ts +38 -42
  92. package/dist/transaction/api/transaction-api.d.ts.map +1 -1
  93. package/dist/transaction/index.d.ts +2 -1
  94. package/dist/transaction/index.d.ts.map +1 -1
  95. package/dist/transaction/models/index.d.ts +21 -0
  96. package/dist/transaction/models/index.d.ts.map +1 -1
  97. package/dist/transaction/services/transaction-service.d.ts +12 -15
  98. package/dist/transaction/services/transaction-service.d.ts.map +1 -1
  99. package/dist/transaction.cjs +1 -1
  100. package/dist/transaction.js +1 -1
  101. package/dist/trigger-source/api/trigger-source-api.d.ts +86 -0
  102. package/dist/trigger-source/api/trigger-source-api.d.ts.map +1 -0
  103. package/dist/trigger-source/index.d.ts +10 -0
  104. package/dist/trigger-source/index.d.ts.map +1 -0
  105. package/dist/trigger-source/models/index.d.ts +26 -0
  106. package/dist/trigger-source/models/index.d.ts.map +1 -0
  107. package/dist/trigger-source/services/trigger-source-service.d.ts +42 -0
  108. package/dist/trigger-source/services/trigger-source-service.d.ts.map +1 -0
  109. package/dist/trigger-source.cjs +145 -0
  110. package/dist/trigger-source.cjs.map +1 -0
  111. package/dist/trigger-source.js +142 -0
  112. package/dist/trigger-source.js.map +1 -0
  113. package/dist/user/api/user-api.d.ts +18 -1
  114. package/dist/user/api/user-api.d.ts.map +1 -1
  115. package/dist/user/services/user-service.d.ts +3 -1
  116. package/dist/user/services/user-service.d.ts.map +1 -1
  117. package/dist/user.cjs +26 -4
  118. package/dist/user.cjs.map +1 -1
  119. package/dist/user.js +26 -4
  120. package/dist/user.js.map +1 -1
  121. package/package.json +7 -2
  122. package/dist/chunks/pers-sdk-BQw3QUWR.cjs.map +0 -1
  123. package/dist/chunks/pers-sdk-fWg-J3_h.js.map +0 -1
  124. package/dist/chunks/redemption-service-D-hBqh42.js.map +0 -1
  125. package/dist/chunks/redemption-service-rMB6T2W5.cjs.map +0 -1
  126. package/dist/chunks/transaction-request.builder-BpgtuMMq.cjs.map +0 -1
  127. package/dist/chunks/transaction-request.builder-C1vVVFto.js.map +0 -1
@@ -40,10 +40,7 @@ export declare class AuthService {
40
40
  * the user's role within that business.
41
41
  *
42
42
  * @param jwt - Authentication token (passkey or Firebase JWT)
43
- * @param options - Business authentication options
44
- * @param options.businessId - The business ID to authenticate as
45
- * - If user has single business membership, auto-selected
46
- * - If user has multiple memberships without businessId, throws MULTIPLE_CONTEXT_SELECTION_REQUIRED
43
+ * @param options - Business authentication options (businessId for multi-business users)
47
44
  * @returns Session response with business context and role baked into JWT
48
45
  * @throws MultipleContextSelectionRequiredError when businessId is required but not provided
49
46
  *
@@ -1 +1 @@
1
- {"version":3,"file":"auth-service.d.ts","sourceRoot":"","sources":["../../../../src/core/auth/services/auth-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAI/D,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC9B,MAAM,uDAAuD,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,WAAW;IAKpB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,YAAY,CAAC;IALvB,OAAO,CAAC,oBAAoB,CAAgD;IAC5E,OAAO,CAAC,iBAAiB,CAA8B;gBAG7C,OAAO,EAAE,OAAO,EAChB,YAAY,CAAC,kCAAsB;IAI7C;;OAEG;YACW,cAAc;IAkB5B;;OAEG;IACG,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAU3E;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAUpE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAUvG;;OAEG;IACG,oBAAoB,CAAC,YAAY,EAAE,WAAW,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAU7F;;OAEG;IACG,kBAAkB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAmBhF;;OAEG;YACW,cAAc;IAgB5B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAQlC;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAexC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAUtC;;OAEG;YACW,WAAW;CAmC1B"}
1
+ {"version":3,"file":"auth-service.d.ts","sourceRoot":"","sources":["../../../../src/core/auth/services/auth-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAI/D,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC9B,MAAM,uDAAuD,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,WAAW;IAKpB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,YAAY,CAAC;IALvB,OAAO,CAAC,oBAAoB,CAAgD;IAC5E,OAAO,CAAC,iBAAiB,CAA8B;gBAG7C,OAAO,EAAE,OAAO,EAChB,YAAY,CAAC,kCAAsB;IAI7C;;OAEG;YACW,cAAc;IAkB5B;;OAEG;IACG,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAU3E;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAUpE;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAUvG;;OAEG;IACG,oBAAoB,CAAC,YAAY,EAAE,WAAW,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAU7F;;OAEG;IACG,kBAAkB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAmBhF;;OAEG;YACW,cAAc;IAgB5B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAQlC;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAexC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAUtC;;OAEG;YACW,WAAW;CAmC1B"}
@@ -1 +1 @@
1
- {"version":3,"file":"pers-api-client.d.ts","sourceRoot":"","sources":["../../src/core/pers-api-client.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAkB,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,UAAU,EAAgB,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE5E,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAa3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAI5C,qBAAa,aAAa;IAiBtB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,MAAM;IAjBhB,OAAO,CAAC,qBAAqB,CAA8B;IAC3D,OAAO,CAAC,OAAO,CAAC,CAAmB;IAEnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuC;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IAErD;;;;;OAKG;gBAEO,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,UAAU;YAgCd,UAAU;IAcxB;;;;;;;;;;;;;;;;;OAiBG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;YAQzB,iBAAiB;IAW/B;;OAEG;YACW,OAAO;IA8FrB;;;OAGG;IACH,OAAO,CAAC,cAAc;IA8BtB;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAIzC;;;;;;;;;;;;;OAaG;IACG,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAInG;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAI3H;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1D;;OAEG;IACG,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAI7C;;;;;;OAMG;YACW,UAAU;IAuDxB;;OAEG;IACH,cAAc,IAAI,WAAW;IAI7B;;OAEG;IACH,SAAS,IAAI,UAAU,CAAC,OAAO,iBAAiB,CAAC;IAIjD;;OAEG;IACH,iBAAiB,IAAI,UAAU;CAGhC"}
1
+ {"version":3,"file":"pers-api-client.d.ts","sourceRoot":"","sources":["../../src/core/pers-api-client.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAkB,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,UAAU,EAAgB,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE5E,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAa3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAI5C,qBAAa,aAAa;IAiBtB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,MAAM;IAjBhB,OAAO,CAAC,qBAAqB,CAA8B;IAC3D,OAAO,CAAC,OAAO,CAAC,CAAmB;IAEnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuC;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IAErD;;;;;OAKG;gBAEO,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,UAAU;YAgCd,UAAU;IAcxB;;;;;;;;;;;;;;;;;OAiBG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;YAQzB,iBAAiB;IAW/B;;OAEG;YACW,OAAO;IA8FrB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAgCtB;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAIzC;;;;;;;;;;;;;OAaG;IACG,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAInG;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAI3H;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1D;;OAEG;IACG,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAI7C;;;;;;OAMG;YACW,UAAU;IAuDxB;;OAEG;IACH,cAAc,IAAI,WAAW;IAI7B;;OAEG;IACH,SAAS,IAAI,UAAU,CAAC,OAAO,iBAAiB,CAAC;IAIjD;;OAEG;IACH,iBAAiB,IAAI,UAAU;CAGhC"}
package/dist/core.cjs CHANGED
@@ -1,6 +1,6 @@
1
1
  'use strict';
2
2
 
3
- var persSdk = require('./chunks/pers-sdk-BQw3QUWR.cjs');
3
+ var persSdk = require('./chunks/pers-sdk-D4XVDZk3.cjs');
4
4
  var persShared = require('@explorins/pers-shared');
5
5
  var environment = require('./chunks/environment-C73snhIJ.cjs');
6
6
  var index = require('./chunks/index-B6-bbNnd.cjs');
@@ -11,12 +11,13 @@ require('./user-status.cjs');
11
11
  require('./chunks/token-service-BlbXrxnS.cjs');
12
12
  require('./chunks/business-membership-service-8KC_qRj7.cjs');
13
13
  require('./campaign.cjs');
14
- require('./chunks/redemption-service-rMB6T2W5.cjs');
15
- require('./chunks/transaction-request.builder-BpgtuMMq.cjs');
14
+ require('./chunks/redemption-service-C61Qr2vI.cjs');
15
+ require('./chunks/transaction-request.builder-B7n7tc1e.cjs');
16
16
  require('./chunks/payment-service-Bkw7ZXev.cjs');
17
17
  require('./chunks/tenant-service-fj-pkXTw.cjs');
18
- require('./analytics.cjs');
18
+ require('./chunks/analytics-service-DwkeBB08.cjs');
19
19
  require('./donation.cjs');
20
+ require('./trigger-source.cjs');
20
21
 
21
22
 
22
23
 
@@ -49,6 +50,7 @@ exports.StaticJwtAuthProvider = persSdk.StaticJwtAuthProvider;
49
50
  exports.TenantManager = persSdk.TenantManager;
50
51
  exports.TokenManager = persSdk.TokenManager;
51
52
  exports.TransactionManager = persSdk.TransactionManager;
53
+ exports.TriggerSourceManager = persSdk.TriggerSourceManager;
52
54
  exports.UserManager = persSdk.UserManager;
53
55
  exports.UserStatusManager = persSdk.UserStatusManager;
54
56
  exports.WebDPoPCryptoProvider = persSdk.WebDPoPCryptoProvider;
package/dist/core.cjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"core.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
1
+ {"version":3,"file":"core.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
package/dist/core.js CHANGED
@@ -1,4 +1,4 @@
1
- export { b as AUTH_STORAGE_KEYS, v as AnalyticsManager, u as ApiKeyManager, k as AuthApi, p as AuthManager, l as AuthService, a as AuthTokenManager, B as BusinessManager, C as CampaignManager, h as DEFAULT_PERS_CONFIG, d as DPOP_STORAGE_KEYS, n as DPoPManager, D as DefaultAuthProvider, w as DonationManager, F as FileManager, L as LocalStorageTokenStorage, M as MemoryTokenStorage, g as PersApiClient, o as PersEventEmitter, P as PersSDK, s as PurchaseManager, R as RedemptionManager, S as SDK_NAME, f as SDK_USER_AGENT, e as SDK_VERSION, j as StaticJwtAuthProvider, t as TenantManager, T as TokenManager, r as TransactionManager, U as UserManager, q as UserStatusManager, W as WebDPoPCryptoProvider, i as buildApiRoot, c as createPersSDK, m as mergeWithDefaults } from './chunks/pers-sdk-fWg-J3_h.js';
1
+ export { b as AUTH_STORAGE_KEYS, v as AnalyticsManager, u as ApiKeyManager, k as AuthApi, p as AuthManager, l as AuthService, a as AuthTokenManager, B as BusinessManager, C as CampaignManager, h as DEFAULT_PERS_CONFIG, d as DPOP_STORAGE_KEYS, n as DPoPManager, D as DefaultAuthProvider, w as DonationManager, F as FileManager, L as LocalStorageTokenStorage, M as MemoryTokenStorage, g as PersApiClient, o as PersEventEmitter, P as PersSDK, s as PurchaseManager, R as RedemptionManager, S as SDK_NAME, f as SDK_USER_AGENT, e as SDK_VERSION, j as StaticJwtAuthProvider, t as TenantManager, T as TokenManager, r as TransactionManager, x as TriggerSourceManager, U as UserManager, q as UserStatusManager, W as WebDPoPCryptoProvider, i as buildApiRoot, c as createPersSDK, m as mergeWithDefaults } from './chunks/pers-sdk-BtvhucPY.js';
2
2
  export { AccountOwnerType } from '@explorins/pers-shared';
3
3
  export { I as IndexedDBTokenStorage, d as detectEnvironment, e as environment, w as warnIfProblematicEnvironment } from './chunks/environment-CKVwRAEL.js';
4
4
  export { a as CacheService, C as CacheTTL, g as globalCacheService } from './chunks/index-DBLskLuH.js';
@@ -9,10 +9,11 @@ import './user-status.js';
9
9
  import './chunks/token-service-Bfj6C0yz.js';
10
10
  import './chunks/business-membership-service-D6vaVQTR.js';
11
11
  import './campaign.js';
12
- import './chunks/redemption-service-D-hBqh42.js';
13
- import './chunks/transaction-request.builder-C1vVVFto.js';
12
+ import './chunks/redemption-service-C_UTTDag.js';
13
+ import './chunks/transaction-request.builder-VbJpI34c.js';
14
14
  import './chunks/payment-service-IvM6rryM.js';
15
15
  import './chunks/tenant-service-CsRA3O2V.js';
16
- import './analytics.js';
16
+ import './chunks/analytics-service-B9IfG6ox.js';
17
17
  import './donation.js';
18
+ import './trigger-source.js';
18
19
  //# sourceMappingURL=core.js.map
package/dist/core.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"core.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;"}
1
+ {"version":3,"file":"core.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;"}
package/dist/index.cjs CHANGED
@@ -1,23 +1,24 @@
1
1
  'use strict';
2
2
 
3
- var persSdk = require('./chunks/pers-sdk-BQw3QUWR.cjs');
3
+ var persSdk = require('./chunks/pers-sdk-D4XVDZk3.cjs');
4
4
  var persShared = require('@explorins/pers-shared');
5
5
  var environment = require('./chunks/environment-C73snhIJ.cjs');
6
6
  var index = require('./chunks/index-B6-bbNnd.cjs');
7
7
  var index$1 = require('./chunks/index-B-g2JPVK.cjs');
8
8
  var paginationUtils = require('./chunks/pagination-utils-B2jRHMSO.cjs');
9
9
  var businessMembershipService = require('./chunks/business-membership-service-8KC_qRj7.cjs');
10
- var transactionRequest_builder = require('./chunks/transaction-request.builder-BpgtuMMq.cjs');
11
- var analytics = require('./analytics.cjs');
10
+ var transactionRequest_builder = require('./chunks/transaction-request.builder-B7n7tc1e.cjs');
11
+ var analyticsService = require('./chunks/analytics-service-DwkeBB08.cjs');
12
12
  var campaign = require('./campaign.cjs');
13
13
  var donation = require('./donation.cjs');
14
14
  var paymentService = require('./chunks/payment-service-Bkw7ZXev.cjs');
15
- var redemptionService = require('./chunks/redemption-service-rMB6T2W5.cjs');
15
+ var redemptionService = require('./chunks/redemption-service-C61Qr2vI.cjs');
16
16
  var tenantService = require('./chunks/tenant-service-fj-pkXTw.cjs');
17
17
  var baseTokenService = require('./chunks/base-token-service-Pvja-ykj.cjs');
18
18
  var tokenService = require('./chunks/token-service-BlbXrxnS.cjs');
19
19
  var user = require('./user.cjs');
20
20
  var userStatus = require('./user-status.cjs');
21
+ var triggerSource = require('./trigger-source.cjs');
21
22
  var platformAdapters = require('./platform-adapters.cjs');
22
23
  var nodeHttpClient = require('./chunks/node-http-client-D_avaa5F.cjs');
23
24
 
@@ -59,6 +60,7 @@ exports.StaticJwtAuthProvider = persSdk.StaticJwtAuthProvider;
59
60
  exports.TenantManager = persSdk.TenantManager;
60
61
  exports.TokenManager = persSdk.TokenManager;
61
62
  exports.TransactionManager = persSdk.TransactionManager;
63
+ exports.TriggerSourceManager = persSdk.TriggerSourceManager;
62
64
  exports.UserManager = persSdk.UserManager;
63
65
  exports.UserStatusManager = persSdk.UserStatusManager;
64
66
  exports.WebDPoPCryptoProvider = persSdk.WebDPoPCryptoProvider;
@@ -69,6 +71,10 @@ Object.defineProperty(exports, "AccountOwnerType", {
69
71
  enumerable: true,
70
72
  get: function () { return persShared.AccountOwnerType; }
71
73
  });
74
+ Object.defineProperty(exports, "SortOrder", {
75
+ enumerable: true,
76
+ get: function () { return persShared.SortOrder; }
77
+ });
72
78
  exports.IndexedDBTokenStorage = environment.IndexedDBTokenStorage;
73
79
  exports.detectEnvironment = environment.detectEnvironment;
74
80
  exports.environment = environment.environment;
@@ -105,8 +111,8 @@ exports.buildPendingTransactionData = transactionRequest_builder.buildPendingTra
105
111
  exports.buildSubmissionRequest = transactionRequest_builder.buildSubmissionRequest;
106
112
  exports.buildTransferRequest = transactionRequest_builder.buildTransferRequest;
107
113
  exports.extractDeadlineFromSigningData = transactionRequest_builder.extractDeadlineFromSigningData;
108
- exports.AnalyticsApi = analytics.AnalyticsApi;
109
- exports.AnalyticsService = analytics.AnalyticsService;
114
+ exports.AnalyticsApi = analyticsService.AnalyticsApi;
115
+ exports.AnalyticsService = analyticsService.AnalyticsService;
110
116
  exports.CampaignApi = campaign.CampaignApi;
111
117
  exports.CampaignService = campaign.CampaignService;
112
118
  exports.DonationApi = donation.DonationApi;
@@ -127,6 +133,8 @@ exports.UserService = user.UserService;
127
133
  exports.UserStatusApi = userStatus.UserStatusApi;
128
134
  exports.UserStatusService = userStatus.UserStatusService;
129
135
  exports.createUserStatusSDK = userStatus.createUserStatusSDK;
136
+ exports.TriggerSourceApi = triggerSource.TriggerSourceApi;
137
+ exports.TriggerSourceService = triggerSource.TriggerSourceService;
130
138
  exports.AngularHttpClientAdapter = platformAdapters.AngularHttpClientAdapter;
131
139
  exports.BrowserFetchClientAdapter = platformAdapters.BrowserFetchClientAdapter;
132
140
  exports.NodeHttpClientAdapter = nodeHttpClient.NodeHttpClientAdapter;
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
1
+ {"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
package/dist/index.d.ts CHANGED
@@ -9,7 +9,6 @@ export * from './shared';
9
9
  export * from './business';
10
10
  export * from './transaction';
11
11
  export * from './analytics';
12
- export { AuthStatus } from './core/auth/auth-status';
13
12
  export * from './campaign';
14
13
  export * from './donation';
15
14
  export * from './payment';
@@ -20,6 +19,12 @@ export * from './token';
20
19
  export * from './user';
21
20
  export * from './user-status';
22
21
  export * from './api-key';
22
+ export * from './trigger-source';
23
+ export type { CampaignClaimFilters, CampaignClaimQueryOptions } from './campaign';
24
+ export type { TransactionQueryOptions } from './transaction';
25
+ export type { RedemptionRedeemFilters, RedemptionRedeemQueryOptions } from './redemption';
26
+ export type { TriggerSourceQueryOptions } from './trigger-source';
27
+ export { AuthStatus } from './core/auth/auth-status';
23
28
  export { PersSDK, createPersSDK } from './pers-sdk';
24
29
  export * from './platform-adapters';
25
30
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,QAAQ,CAAA;AAGtB,cAAc,YAAY,CAAC;AAG3B,cAAc,UAAU,CAAC;AAGzB,cAAc,YAAY,CAAC;AAG3B,cAAc,eAAe,CAAC;AAG9B,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD,cAAc,YAAY,CAAC;AAG3B,cAAc,YAAY,CAAC;AAG3B,cAAc,WAAW,CAAC;AAG1B,cAAc,QAAQ,CAAC;AAGvB,cAAc,cAAc,CAAC;AAG7B,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC;AAGxB,cAAc,QAAQ,CAAC;AAGvB,cAAc,eAAe,CAAC;AAG9B,cAAc,WAAW,CAAC;AAS1B,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGpD,cAAc,qBAAqB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,QAAQ,CAAA;AAGtB,cAAc,YAAY,CAAC;AAG3B,cAAc,UAAU,CAAC;AAGzB,cAAc,YAAY,CAAC;AAG3B,cAAc,eAAe,CAAC;AAG9B,cAAc,aAAa,CAAC;AAG5B,cAAc,YAAY,CAAC;AAG3B,cAAc,YAAY,CAAC;AAG3B,cAAc,WAAW,CAAC;AAG1B,cAAc,QAAQ,CAAC;AAGvB,cAAc,cAAc,CAAC;AAG7B,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC;AAGxB,cAAc,QAAQ,CAAC;AAGvB,cAAc,eAAe,CAAC;AAG9B,cAAc,WAAW,CAAC;AAG1B,cAAc,kBAAkB,CAAC;AAIjC,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAClF,YAAY,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAC1F,YAAY,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAGlE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AASrD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGpD,cAAc,qBAAqB,CAAC"}
package/dist/index.js CHANGED
@@ -1,22 +1,23 @@
1
- export { b as AUTH_STORAGE_KEYS, v as AnalyticsManager, z as ApiKeyApi, u as ApiKeyManager, k as AuthApi, p as AuthManager, l as AuthService, A as AuthStatus, a as AuthTokenManager, B as BusinessManager, C as CampaignManager, h as DEFAULT_PERS_CONFIG, d as DPOP_STORAGE_KEYS, n as DPoPManager, D as DefaultAuthProvider, w as DonationManager, x as FileApi, F as FileManager, y as FileService, L as LocalStorageTokenStorage, M as MemoryTokenStorage, g as PersApiClient, o as PersEventEmitter, P as PersSDK, s as PurchaseManager, R as RedemptionManager, S as SDK_NAME, f as SDK_USER_AGENT, e as SDK_VERSION, j as StaticJwtAuthProvider, t as TenantManager, T as TokenManager, r as TransactionManager, U as UserManager, q as UserStatusManager, W as WebDPoPCryptoProvider, i as buildApiRoot, c as createPersSDK, m as mergeWithDefaults } from './chunks/pers-sdk-fWg-J3_h.js';
1
+ export { b as AUTH_STORAGE_KEYS, v as AnalyticsManager, E as ApiKeyApi, u as ApiKeyManager, k as AuthApi, p as AuthManager, l as AuthService, A as AuthStatus, a as AuthTokenManager, B as BusinessManager, C as CampaignManager, h as DEFAULT_PERS_CONFIG, d as DPOP_STORAGE_KEYS, n as DPoPManager, D as DefaultAuthProvider, w as DonationManager, y as FileApi, F as FileManager, z as FileService, L as LocalStorageTokenStorage, M as MemoryTokenStorage, g as PersApiClient, o as PersEventEmitter, P as PersSDK, s as PurchaseManager, R as RedemptionManager, S as SDK_NAME, f as SDK_USER_AGENT, e as SDK_VERSION, j as StaticJwtAuthProvider, t as TenantManager, T as TokenManager, r as TransactionManager, x as TriggerSourceManager, U as UserManager, q as UserStatusManager, W as WebDPoPCryptoProvider, i as buildApiRoot, c as createPersSDK, m as mergeWithDefaults } from './chunks/pers-sdk-BtvhucPY.js';
2
2
  export * from '@explorins/pers-shared';
3
- export { AccountOwnerType } from '@explorins/pers-shared';
3
+ export { AccountOwnerType, SortOrder } from '@explorins/pers-shared';
4
4
  export { I as IndexedDBTokenStorage, d as detectEnvironment, e as environment, w as warnIfProblematicEnvironment } from './chunks/environment-CKVwRAEL.js';
5
5
  export { a as CacheService, C as CacheTTL, g as globalCacheService } from './chunks/index-DBLskLuH.js';
6
6
  export { b as ApiErrorDetector, A as AuthenticationError, E as ErrorUtils, L as LogoutRequired, N as NetworkError, a as PersApiError, P as ProviderTokenRefreshNeeded, T as TokenRefreshNeeded } from './chunks/index-CKm_V5XE.js';
7
7
  export { b as buildPaginationParams, e as extractData, a as extractPagination, f as fetchAllPages, i as isPaginatedResponse, n as normalizeToPaginated } from './chunks/pagination-utils-9vQ-Npkr.js';
8
8
  export { B as BusinessApi, a as BusinessMembershipApi, c as BusinessMembershipService, b as BusinessService } from './chunks/business-membership-service-D6vaVQTR.js';
9
- 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-C1vVVFto.js';
10
- export { AnalyticsApi, AnalyticsService } from './analytics.js';
9
+ export { C as ClientTransactionType, T as TransactionApi, a as TransactionService, c as buildBurnRequest, b as buildMintRequest, f as buildPOSBurnRequest, e as buildPOSTransferRequest, i as buildPendingTransactionData, g as buildSubmissionRequest, d as buildTransferRequest, h as extractDeadlineFromSigningData } from './chunks/transaction-request.builder-VbJpI34c.js';
10
+ export { A as AnalyticsApi, a as AnalyticsService } from './chunks/analytics-service-B9IfG6ox.js';
11
11
  export { CampaignApi, CampaignService } from './campaign.js';
12
12
  export { DonationApi, DonationService } from './donation.js';
13
13
  export { P as PaymentApi, a as PaymentService } from './chunks/payment-service-IvM6rryM.js';
14
- export { R as RedemptionApi, a as RedemptionService } from './chunks/redemption-service-D-hBqh42.js';
14
+ export { R as RedemptionApi, a as RedemptionService } from './chunks/redemption-service-C_UTTDag.js';
15
15
  export { T as TenantApi, a as TenantService } from './chunks/tenant-service-CsRA3O2V.js';
16
16
  export { B as BaseTokenService, T as TokenSDK, g as getMetadataFromTokenUnitResponse } from './chunks/base-token-service-U3YzHxfd.js';
17
17
  export { T as TokenApi, a as TokenService } from './chunks/token-service-Bfj6C0yz.js';
18
18
  export { UserApi, UserService } from './user.js';
19
19
  export { UserStatusApi, UserStatusService, createUserStatusSDK } from './user-status.js';
20
+ export { TriggerSourceApi, TriggerSourceService } from './trigger-source.js';
20
21
  export { AngularHttpClientAdapter, BrowserFetchClientAdapter } from './platform-adapters.js';
21
22
  export { N as NodeHttpClientAdapter } from './chunks/node-http-client-DloDLfm9.js';
22
23
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;"}
1
+ {"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;"}
@@ -1,6 +1,6 @@
1
1
  import { PersApiClient } from '../core/pers-api-client';
2
2
  import { AnalyticsService } from '../analytics';
3
- import type { TransactionAnalyticsRequestDTO } from '../analytics/models';
3
+ import type { TransactionAnalyticsRequestDTO, CampaignClaimAnalyticsRequestDTO, UserAnalyticsRequestDTO, UserRankingAnalyticsRequestDTO, BusinessRankingAnalyticsRequestDTO, RetentionAnalyticsRequestDTO } from '../analytics/models';
4
4
  /**
5
5
  * Analytics Manager - Clean, high-level interface for analytics operations
6
6
  *
@@ -243,7 +243,170 @@ export declare class AnalyticsManager {
243
243
  * updateDashboard();
244
244
  * ```
245
245
  */
246
- getTransactionAnalytics(request: TransactionAnalyticsRequestDTO): Promise<import("node_modules/@explorins/pers-shared/dist/cjs/shared-lib/dto/transaction/transaction-analytics.request.dto").TransactionAnalyticsResponseDTO>;
246
+ getTransactionAnalytics(request: TransactionAnalyticsRequestDTO): Promise<import("node_modules/@explorins/pers-shared/dist/cjs/shared-lib/dto/analytics/transaction-analytics.request.dto").TransactionAnalyticsResponseDTO>;
247
+ /**
248
+ * Get campaign claim analytics with aggregation
249
+ *
250
+ * Retrieves aggregated analytics for campaign claims with flexible grouping,
251
+ * filtering, and metric selection. Provides insights into campaign performance,
252
+ * claim patterns, and user engagement across the loyalty ecosystem.
253
+ *
254
+ * @param request - Analytics request with filters, groupBy, and metrics
255
+ * @returns Promise resolving to campaign claim analytics data
256
+ *
257
+ * @example Claims per campaign
258
+ * ```typescript
259
+ * const analytics = await sdk.analytics.getCampaignClaimAnalytics({
260
+ * filters: { status: 'COMPLETED' },
261
+ * groupBy: ['campaignId'],
262
+ * metrics: ['count'],
263
+ * sortBy: 'count',
264
+ * sortOrder: 'DESC',
265
+ * limit: 10
266
+ * });
267
+ *
268
+ * console.log('Top campaigns:', analytics.results);
269
+ * ```
270
+ */
271
+ getCampaignClaimAnalytics(request: CampaignClaimAnalyticsRequestDTO): Promise<import("node_modules/@explorins/pers-shared/dist/cjs/shared-lib/dto/analytics/campaign-claim-analytics-request.dto").CampaignClaimAnalyticsResponseDTO>;
272
+ /**
273
+ * Get user analytics with engagement metrics
274
+ *
275
+ * Retrieves aggregated user statistics including engagement rate, active users,
276
+ * transaction metrics, and per-active-user averages. Provides comprehensive
277
+ * insights into user behavior, engagement patterns, and platform adoption metrics.
278
+ *
279
+ * NEW: Added per-active-user metrics (averageTransactionsPerActiveUser, etc.) which
280
+ * show concentrated engagement among active users - more useful than diluted all-user averages.
281
+ *
282
+ * Request structure matches TransactionAnalytics and CampaignClaimAnalytics:
283
+ * - Use filters object for business-specific scoping
284
+ * - startDate/endDate at root level for date range filtering
285
+ *
286
+ * @param request - Analytics request with optional filters and date range
287
+ * @returns Promise resolving to user analytics data with per-user and per-active-user metrics
288
+ *
289
+ * @example Basic user analytics (compare per-user vs per-active-user)
290
+ * ```typescript
291
+ * const analytics = await sdk.analytics.getUserAnalytics({});
292
+ * console.log(`Total users: ${analytics.totalUsers}`);
293
+ * console.log(`Active users: ${analytics.activeUsers} (${analytics.engagementRate.toFixed(1)}%)`);
294
+ *
295
+ * // Per-user averages (includes inactive users - lower numbers)
296
+ * console.log(`\\nPer-User Averages (all users):`);
297
+ * console.log(` Transactions: ${analytics.averageTransactionsPerUser.toFixed(2)}`);
298
+ * console.log(` Claims: ${analytics.averageClaimsPerUser.toFixed(2)}`);
299
+ * console.log(` Redemptions: ${analytics.averageRedemptionsPerUser.toFixed(2)}`);
300
+ *
301
+ * // Per-active-user averages (only engaged users - higher, more meaningful numbers)
302
+ * console.log(`\\nPer-Active-User Averages (engaged users only):`);
303
+ * console.log(` Transactions: ${analytics.averageTransactionsPerActiveUser.toFixed(2)}`);
304
+ * console.log(` Claims: ${analytics.averageClaimsPerActiveUser.toFixed(2)}`);
305
+ * console.log(` Redemptions: ${analytics.averageRedemptionsPerActiveUser.toFixed(2)}`);
306
+ * ```
307
+ *
308
+ * @example Monthly user analytics with date range
309
+ * ```typescript
310
+ * const analytics = await sdk.analytics.getUserAnalytics({
311
+ * startDate: new Date('2026-02-01'),
312
+ * endDate: new Date('2026-02-28')
313
+ * });
314
+ *
315
+ * console.log('February 2026 User Metrics:');
316
+ * console.log(`Total users: ${analytics.totalUsers}`);
317
+ * console.log(`Active users: ${analytics.activeUsers}`);
318
+ * console.log(`New users: ${analytics.newUsers}`);
319
+ * console.log(`Engagement rate: ${analytics.engagementRate.toFixed(2)}%`);
320
+ * console.log(`Total transaction volume: $${analytics.totalTransactionVolume.toLocaleString()}`);
321
+ * console.log(`Avg transaction amount: $${analytics.averageTransactionAmount.toFixed(2)}`);
322
+ * console.log(`\\nFilters applied: ${analytics.metadata.dateRange?.startDate} to ${analytics.metadata.dateRange?.endDate}`);
323
+ * ```
324
+ *
325
+ * @example Business-specific user analytics with filters
326
+ * ```typescript
327
+ * const analytics = await sdk.analytics.getUserAnalytics({
328
+ * filters: { businessId: 'business-123' },
329
+ * startDate: new Date('2026-01-01'),
330
+ * endDate: new Date('2026-12-31')
331
+ * });
332
+ *
333
+ * console.log(`Business customer metrics for 2026:`);
334
+ * console.log(`Active customers: ${analytics.activeUsers} / ${analytics.totalUsers}`);
335
+ * console.log(`Customer engagement: ${analytics.engagementRate.toFixed(1)}%`);
336
+ * console.log(`Avg spend per customer: $${analytics.averageTransactionAmount.toFixed(2)}`);
337
+ * console.log(`Avg spend per active customer: $${(analytics.totalTransactionVolume / analytics.activeUsers).toFixed(2)}`);
338
+ * console.log(`Avg claims per active customer: ${analytics.averageClaimsPerActiveUser.toFixed(2)}`);
339
+ * ```
340
+ */
341
+ getUserAnalytics(request?: UserAnalyticsRequestDTO): Promise<import("node_modules/@explorins/pers-shared/dist/cjs/shared-lib/dto/analytics/user-analytics.dto").UserAnalyticsResponseDTO>;
342
+ /**
343
+ * Get user transaction ranking with enriched user data
344
+ *
345
+ * Retrieves ranked list of users with full user details (email, externalUserId)
346
+ * and transaction metrics. Data enrichment happens via efficient SQL JOINs + UNION
347
+ * (handles legacy transactions). Ideal for leaderboards, engagement analysis, and
348
+ * identifying power users for targeted campaigns.
349
+ *
350
+ * Use Cases:
351
+ * - Admin leaderboards showing top users by activity
352
+ * - User engagement analysis with full user context
353
+ * - Identifying power users for campaigns
354
+ * - Customer segmentation by transaction behavior
355
+ *
356
+ * @param request - Ranking request with filters, sorting, and limit
357
+ * @returns Promise resolving to ranked user list with transaction metrics
358
+ *
359
+ * @example Top 50 users by transaction count
360
+ * ```typescript
361
+ * const ranking = await sdk.analytics.getUserRanking({
362
+ * sortBy: 'totalTransactions',
363
+ * sortOrder: 'DESC',
364
+ * limit: 50
365
+ * });
366
+ *
367
+ * console.log(`Top ${ranking.totalUsers} users:`);
368
+ * ranking.results.forEach((user, index) => {
369
+ * console.log(`#${index + 1}: ${user.email || user.externalUserId}`);
370
+ * console.log(` Transactions: ${user.totalTransactions}`);
371
+ * console.log(` Token spent: ${user.tokenSpent}`);
372
+ * });
373
+ * ```
374
+ *
375
+ * @example Top users by STAMP spending
376
+ * ```typescript
377
+ * const ranking = await sdk.analytics.getUserRanking({
378
+ * filters: { tokenType: 'STAMP' },
379
+ * sortBy: 'tokenSpent',
380
+ * sortOrder: 'DESC',
381
+ * limit: 20
382
+ * });
383
+ *
384
+ * console.log('Top 20 STAMP spenders:');
385
+ * ranking.results.forEach((user, index) => {
386
+ * const identifier = user.email || user.externalUserId || user.userId;
387
+ * console.log(`${index + 1}. ${identifier} - ${user.tokenSpent} STAMP`);
388
+ * });
389
+ * ```
390
+ */
391
+ getUserRanking(request?: UserRankingAnalyticsRequestDTO): Promise<import("node_modules/@explorins/pers-shared/dist/cjs/shared-lib/dto/analytics/user-ranking-analytics.dto").UserRankingAnalyticsResponseDTO>;
392
+ /**
393
+ * Get business transaction ranking with enriched business data
394
+ *
395
+ * Returns ranked list of businesses with full business details and transaction metrics.
396
+ *
397
+ * @param request - Ranking request with filters, sorting, and limit
398
+ * @returns Promise resolving to ranked business list
399
+ */
400
+ getBusinessRanking(request?: BusinessRankingAnalyticsRequestDTO): Promise<import("node_modules/@explorins/pers-shared/dist/cjs/shared-lib/dto/analytics/business-ranking-analytics.dto").BusinessRankingAnalyticsResponseDTO>;
401
+ /**
402
+ * Get monthly user retention analytics
403
+ *
404
+ * Returns monthly retention data with user metrics and retention rates.
405
+ *
406
+ * @param request - Retention request with monthsBack and filters
407
+ * @returns Promise resolving to monthly retention data
408
+ */
409
+ getRetentionAnalytics(request?: RetentionAnalyticsRequestDTO): Promise<import("node_modules/@explorins/pers-shared/dist/cjs/shared-lib/dto/analytics/retention-analytics.dto").RetentionAnalyticsResponseDTO>;
247
410
  /**
248
411
  * Get the full analytics service for advanced operations
249
412
  *
@@ -1 +1 @@
1
- {"version":3,"file":"analytics-manager.d.ts","sourceRoot":"","sources":["../../src/managers/analytics-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAgB,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,qBAAqB,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,qBAAa,gBAAgB;IAGf,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,gBAAgB,CAAmB;gBAEvB,SAAS,EAAE,aAAa;IAK5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmLG;IACG,uBAAuB,CAAC,OAAO,EAAE,8BAA8B;IAIrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0DG;IACH,mBAAmB,IAAI,gBAAgB;CAGxC"}
1
+ {"version":3,"file":"analytics-manager.d.ts","sourceRoot":"","sources":["../../src/managers/analytics-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAgB,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,KAAK,EACV,8BAA8B,EAC9B,gCAAgC,EAChC,uBAAuB,EACvB,8BAA8B,EAC9B,kCAAkC,EAClC,4BAA4B,EAC7B,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,qBAAa,gBAAgB;IAGf,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,gBAAgB,CAAmB;gBAEvB,SAAS,EAAE,aAAa;IAK5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmLG;IACG,uBAAuB,CAAC,OAAO,EAAE,8BAA8B;IAIrE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,yBAAyB,CAAC,OAAO,EAAE,gCAAgC;IAIzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoEG;IACG,gBAAgB,CAAC,OAAO,GAAE,uBAA4B;IAI5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgDG;IACG,cAAc,CAAC,OAAO,GAAE,8BAAmC;IAIjE;;;;;;;OAOG;IACG,kBAAkB,CAAC,OAAO,GAAE,kCAAuC;IAIzE;;;;;;;OAOG;IACG,qBAAqB,CAAC,OAAO,GAAE,4BAAiC;IAItE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0DG;IACH,mBAAmB,IAAI,gBAAgB;CAGxC"}
@@ -77,8 +77,7 @@ export declare class AuthManager {
77
77
  * throws `MULTIPLE_CONTEXT_SELECTION_REQUIRED` error with available options
78
78
  *
79
79
  * @param jwtToken - JWT token from auth provider (passkey, Firebase, etc.)
80
- * @param options - Business authentication options
81
- * @param options.businessId - The business ID to authenticate as (required for multi-business users)
80
+ * @param options - Business authentication options (businessId for multi-business users)
82
81
  * @returns Promise resolving to authentication response with business context and role in JWT
83
82
  * @throws Error with code `MULTIPLE_CONTEXT_SELECTION_REQUIRED` when businessId is needed
84
83
  *
@@ -1 +1 @@
1
- {"version":3,"file":"auth-manager.d.ts","sourceRoot":"","sources":["../../src/managers/auth-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iDAAiD,CAAC;AACnF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAGnJ,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,WAAW;IAEpB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM,CAAC;gBADP,SAAS,EAAE,aAAa,EACxB,MAAM,CAAC,8BAAkB;IAGnC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,gBAAwC,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAgBlI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAK9G;;;;;;;;;;;;;;OAcG;IACG,kBAAkB,IAAI,OAAO,CAAC,WAAW,CAAC;IAIhD;;;;;;;;;;;;;;;;;OAiBG;IACG,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAKxF;;;;;;;;;;;;;;;;;;OAkBG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAMxC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IASzC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAK3E;;;;;;;;;;;;;;;;;OAiBG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAKhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;CAKvC"}
1
+ {"version":3,"file":"auth-manager.d.ts","sourceRoot":"","sources":["../../src/managers/auth-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iDAAiD,CAAC;AACnF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAGnJ,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,WAAW;IAEpB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM,CAAC;gBADP,SAAS,EAAE,aAAa,EACxB,MAAM,CAAC,8BAAkB;IAGnC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,gBAAwC,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAgBlI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAK9G;;;;;;;;;;;;;;OAcG;IACG,kBAAkB,IAAI,OAAO,CAAC,WAAW,CAAC;IAIhD;;;;;;;;;;;;;;;;;OAiBG;IACG,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAKxF;;;;;;;;;;;;;;;;;;OAkBG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAMxC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IASzC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAK3E;;;;;;;;;;;;;;;;;OAiBG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAKhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;CAKvC"}