@explorins/pers-shared 2.1.149 → 2.1.151

package/dist/cjs/shared-lib/constants/analytics.constants.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Analytics Constants
+ *
+ * Shared definitions for consistent analytics across frontend and backend.
+ */
+/**
+ * Active User Definition
+ *
+ * A user qualifies as "active" in a given period if they performed
+ * any of the qualifying actions during that period.
+ *
+ * @example
+ * // Display in UI
+ * `${engagementRate}% engagement. ${ACTIVE_USER_DEFINITION.description}`
+ *
+ * // Result: "25.5% engagement. Active = sent transaction, claimed, or redeemed in period"
+ */
+export declare const ACTIVE_USER_DEFINITION: {
+    /** Actions that qualify a user as "active" */
+    readonly qualifyingActions: readonly ["TRANSACTION_SEND", "CLAIM_COMPLETED", "REDEMPTION_COMPLETED"];
+    /** Short description for UI display */
+    readonly description: "Active = sent transaction, claimed, or redeemed in period";
+    /** Detailed explanation for tooltips/documentation */
+    readonly details: {
+        readonly TRANSACTION_SEND: "User initiated a transaction (spending, transferring, or purchasing)";
+        readonly CLAIM_COMPLETED: "User successfully claimed a campaign reward";
+        readonly REDEMPTION_COMPLETED: "User successfully redeemed an offer";
+    };
+    /** What does NOT count as active */
+    readonly excluded: readonly ["Receiving tokens (passive)", "Failed or pending claims/redemptions", "System-generated transactions (REDEMPTION_RECEIVE)"];
+};
+/**
+ * Engagement rate formula
+ * engagementRate = (activeUsers / totalUsers) × 100
+ */
+export declare const ENGAGEMENT_RATE_FORMULA = "activeUsers / totalUsers \u00D7 100";
+/**
+ * Transaction statuses that count for analytics
+ */
+export declare const ANALYTICS_VALID_TRANSACTION_STATUSES: readonly ["SUCCEEDED", "BROADCASTED"];
+/**
+ * Process statuses that count for analytics (claims, redemptions)
+ */
+export declare const ANALYTICS_VALID_PROCESS_STATUS: "COMPLETED";
+//# sourceMappingURL=analytics.constants.d.ts.map

package/dist/cjs/shared-lib/constants/analytics.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.constants.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/constants/analytics.constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB;IACjC,8CAA8C;;IAG9C,uCAAuC;;IAGvC,sDAAsD;;;;;;IAOtD,oCAAoC;;CAM5B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,uBAAuB,wCAAmC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,oCAAoC,uCAAwC,CAAC;AAE1F;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAG,WAAoB,CAAC"}

package/dist/cjs/shared-lib/constants/analytics.constants.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Analytics Constants
+ *
+ * Shared definitions for consistent analytics across frontend and backend.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ANALYTICS_VALID_PROCESS_STATUS = exports.ANALYTICS_VALID_TRANSACTION_STATUSES = exports.ENGAGEMENT_RATE_FORMULA = exports.ACTIVE_USER_DEFINITION = void 0;
+/**
+ * Active User Definition
+ *
+ * A user qualifies as "active" in a given period if they performed
+ * any of the qualifying actions during that period.
+ *
+ * @example
+ * // Display in UI
+ * `${engagementRate}% engagement. ${ACTIVE_USER_DEFINITION.description}`
+ *
+ * // Result: "25.5% engagement. Active = sent transaction, claimed, or redeemed in period"
+ */
+exports.ACTIVE_USER_DEFINITION = {
+    /** Actions that qualify a user as "active" */
+    qualifyingActions: ['TRANSACTION_SEND', 'CLAIM_COMPLETED', 'REDEMPTION_COMPLETED'],
+    /** Short description for UI display */
+    description: 'Active = sent transaction, claimed, or redeemed in period',
+    /** Detailed explanation for tooltips/documentation */
+    details: {
+        TRANSACTION_SEND: 'User initiated a transaction (spending, transferring, or purchasing)',
+        CLAIM_COMPLETED: 'User successfully claimed a campaign reward',
+        REDEMPTION_COMPLETED: 'User successfully redeemed an offer',
+    },
+    /** What does NOT count as active */
+    excluded: [
+        'Receiving tokens (passive)',
+        'Failed or pending claims/redemptions',
+        'System-generated transactions (REDEMPTION_RECEIVE)',
+    ],
+};
+/**
+ * Engagement rate formula
+ * engagementRate = (activeUsers / totalUsers) × 100
+ */
+exports.ENGAGEMENT_RATE_FORMULA = 'activeUsers / totalUsers × 100';
+/**
+ * Transaction statuses that count for analytics
+ */
+exports.ANALYTICS_VALID_TRANSACTION_STATUSES = ['SUCCEEDED', 'BROADCASTED'];
+/**
+ * Process statuses that count for analytics (claims, redemptions)
+ */
+exports.ANALYTICS_VALID_PROCESS_STATUS = 'COMPLETED';
+//# sourceMappingURL=analytics.constants.js.map

package/dist/cjs/shared-lib/constants/analytics.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.constants.js","sourceRoot":"","sources":["../../../../src/shared-lib/constants/analytics.constants.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH;;;;;;;;;;;GAWG;AACU,QAAA,sBAAsB,GAAG;IACpC,8CAA8C;IAC9C,iBAAiB,EAAE,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,sBAAsB,CAAC;IAElF,uCAAuC;IACvC,WAAW,EAAE,2DAA2D;IAExE,sDAAsD;IACtD,OAAO,EAAE;QACP,gBAAgB,EAAE,sEAAsE;QACxF,eAAe,EAAE,6CAA6C;QAC9D,oBAAoB,EAAE,qCAAqC;KAC5D;IAED,oCAAoC;IACpC,QAAQ,EAAE;QACR,4BAA4B;QAC5B,sCAAsC;QACtC,oDAAoD;KACrD;CACO,CAAC;AAEX;;;GAGG;AACU,QAAA,uBAAuB,GAAG,gCAAgC,CAAC;AAExE;;GAEG;AACU,QAAA,oCAAoC,GAAG,CAAC,WAAW,EAAE,aAAa,CAAU,CAAC;AAE1F;;GAEG;AACU,QAAA,8BAA8B,GAAG,WAAoB,CAAC"}

package/dist/cjs/shared-lib/constants/index.d.ts

@@ -1,2 +1,3 @@
+export * from './analytics.constants';
 export * from './image-cdn.constants';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/shared-lib/constants/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/constants/index.ts"],"names":[],"mappings":"AACA,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/constants/index.ts"],"names":[],"mappings":"AACA,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist/cjs/shared-lib/constants/index.js

@@ -15,5 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 // Constants Barrel - Auto-exports all constants
+__exportStar(require("./analytics.constants"), exports);
 __exportStar(require("./image-cdn.constants"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/shared-lib/constants/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/constants/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAAgD;AAChD,wDAAsC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/constants/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAAgD;AAChD,wDAAsC;AACtC,wDAAsC"}

package/dist/cjs/shared-lib/dto/analytics/user-analytics.dto.d.ts

@@ -36,11 +36,16 @@ export declare class UserAnalyticsResponseDTO {
     averageTransactionsPerUser: number;
     averageTransactionAmount: number;
     totalTransactionVolume: number;
+    totalClaims: number;
     averageClaimsPerUser: number;
+    totalRedemptions: number;
     averageRedemptionsPerUser: number;
+    totalBurns: number;
+    averageBurnsPerUser: number;
     averageTransactionsPerActiveUser: number;
     averageClaimsPerActiveUser: number;
     averageRedemptionsPerActiveUser: number;
+    averageBurnsPerActiveUser: number;
     engagementRate: number;
     periodBreakdown?: {
         date: string;

package/dist/cjs/shared-lib/dto/analytics/user-analytics.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-analytics.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/user-analytics.dto.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAG7D;;;;;GAKG;AACH,qBAAa,uBAAuB;IAQlC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,qBAAa,uBAAuB;IAWlC,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAQlC,SAAS,CAAC,EAAE,IAAI,CAAC;IAQjB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,qBAAa,wBAAwB;IAKnC,UAAU,EAAE,MAAM,CAAK;IAMvB,WAAW,EAAE,MAAM,CAAK;IAMxB,QAAQ,EAAE,MAAM,CAAK;IAMrB,0BAA0B,EAAE,MAAM,CAAK;IAMvC,wBAAwB,EAAE,MAAM,CAAK;IAMrC,sBAAsB,EAAE,MAAM,CAAK;IAMnC,oBAAoB,EAAE,MAAM,CAAK;IAMjC,yBAAyB,EAAE,MAAM,CAAK;IAMtC,gCAAgC,EAAE,MAAM,CAAK;IAM7C,0BAA0B,EAAE,MAAM,CAAK;IAMvC,+BAA+B,EAAE,MAAM,CAAK;IAO5C,cAAc,EAAE,MAAM,CAAK;IAc3B,eAAe,CAAC,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;IAiBJ,QAAQ,EAAE,qBAAqB,CAE7B;CACH"}
+{"version":3,"file":"user-analytics.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/user-analytics.dto.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAG7D;;;;;GAKG;AACH,qBAAa,uBAAuB;IAQlC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,qBAAa,uBAAuB;IAWlC,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAQlC,SAAS,CAAC,EAAE,IAAI,CAAC;IAQjB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,qBAAa,wBAAwB;IAKnC,UAAU,EAAE,MAAM,CAAK;IAMvB,WAAW,EAAE,MAAM,CAAK;IAMxB,QAAQ,EAAE,MAAM,CAAK;IAMrB,0BAA0B,EAAE,MAAM,CAAK;IAMvC,wBAAwB,EAAE,MAAM,CAAK;IAMrC,sBAAsB,EAAE,MAAM,CAAK;IAMnC,WAAW,EAAE,MAAM,CAAK;IAMxB,oBAAoB,EAAE,MAAM,CAAK;IAMjC,gBAAgB,EAAE,MAAM,CAAK;IAM7B,yBAAyB,EAAE,MAAM,CAAK;IAMtC,UAAU,EAAE,MAAM,CAAK;IAMvB,mBAAmB,EAAE,MAAM,CAAK;IAMhC,gCAAgC,EAAE,MAAM,CAAK;IAM7C,0BAA0B,EAAE,MAAM,CAAK;IAMvC,+BAA+B,EAAE,MAAM,CAAK;IAM5C,yBAAyB,EAAE,MAAM,CAAK;IAOtC,cAAc,EAAE,MAAM,CAAK;IAc3B,eAAe,CAAC,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;IAiBJ,QAAQ,EAAE,qBAAqB,CAE7B;CACH"}

package/dist/cjs/shared-lib/dto/analytics/user-analytics.dto.js

@@ -94,11 +94,16 @@ class UserAnalyticsResponseDTO {
     averageTransactionsPerUser = 0;
     averageTransactionAmount = 0;
     totalTransactionVolume = 0;
+    totalClaims = 0;
     averageClaimsPerUser = 0;
+    totalRedemptions = 0;
     averageRedemptionsPerUser = 0;
+    totalBurns = 0;
+    averageBurnsPerUser = 0;
     averageTransactionsPerActiveUser = 0;
     averageClaimsPerActiveUser = 0;
     averageRedemptionsPerActiveUser = 0;
+    averageBurnsPerActiveUser = 0;
     engagementRate = 0;
     periodBreakdown;
     metadata = {
@@ -148,6 +153,13 @@ __decorate([
     }),
     __metadata("design:type", Number)
 ], UserAnalyticsResponseDTO.prototype, "totalTransactionVolume", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Total completed claims in the date range. Only counts claims with status=COMPLETED.',
+        example: 1523
+    }),
+    __metadata("design:type", Number)
+], UserAnalyticsResponseDTO.prototype, "totalClaims", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'Average claims per user across entire user base (total completed claims in date range ÷ total users). Only counts claims with status=COMPLETED.',
@@ -155,6 +167,13 @@ __decorate([
     }),
     __metadata("design:type", Number)
 ], UserAnalyticsResponseDTO.prototype, "averageClaimsPerUser", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Total completed redemptions in the date range. Only counts redemptions with status=COMPLETED.',
+        example: 892
+    }),
+    __metadata("design:type", Number)
+], UserAnalyticsResponseDTO.prototype, "totalRedemptions", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'Average redemptions per user across entire user base (total completed redemptions in date range ÷ total users). Only counts redemptions with status=COMPLETED.',
@@ -162,6 +181,20 @@ __decorate([
     }),
     __metadata("design:type", Number)
 ], UserAnalyticsResponseDTO.prototype, "averageRedemptionsPerUser", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Total burn transactions in the date range. Only counts successful burn transactions (status=SUCCEEDED or BROADCASTED, type=BURN).',
+        example: 523
+    }),
+    __metadata("design:type", Number)
+], UserAnalyticsResponseDTO.prototype, "totalBurns", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Average burns per user across entire user base (total burns in date range ÷ total users).',
+        example: 0.5
+    }),
+    __metadata("design:type", Number)
+], UserAnalyticsResponseDTO.prototype, "averageBurnsPerUser", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'Average transactions per active user (total successful transactions in date range ÷ active users in date range). Provides more accurate engagement metric than averageTransactionsPerUser by excluding inactive users.',
@@ -183,6 +216,13 @@ __decorate([
     }),
     __metadata("design:type", Number)
 ], UserAnalyticsResponseDTO.prototype, "averageRedemptionsPerActiveUser", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Average burns per active user (total burns in date range ÷ active users in date range).',
+        example: 0.8
+    }),
+    __metadata("design:type", Number)
+], UserAnalyticsResponseDTO.prototype, "averageBurnsPerActiveUser", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'User engagement rate as percentage (activeUsers ÷ totalUsers × 100). Indicates what percentage of all registered users had activity in the date range.',

package/dist/cjs/shared-lib/dto/analytics/user-analytics.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-analytics.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/user-analytics.dto.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"user-analytics.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/user-analytics.dto.ts"],"names":[],"mappings":"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"}

package/dist/esm/shared-lib/constants/analytics.constants.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Analytics Constants
+ *
+ * Shared definitions for consistent analytics across frontend and backend.
+ */
+/**
+ * Active User Definition
+ *
+ * A user qualifies as "active" in a given period if they performed
+ * any of the qualifying actions during that period.
+ *
+ * @example
+ * // Display in UI
+ * `${engagementRate}% engagement. ${ACTIVE_USER_DEFINITION.description}`
+ *
+ * // Result: "25.5% engagement. Active = sent transaction, claimed, or redeemed in period"
+ */
+export declare const ACTIVE_USER_DEFINITION: {
+    /** Actions that qualify a user as "active" */
+    readonly qualifyingActions: readonly ["TRANSACTION_SEND", "CLAIM_COMPLETED", "REDEMPTION_COMPLETED"];
+    /** Short description for UI display */
+    readonly description: "Active = sent transaction, claimed, or redeemed in period";
+    /** Detailed explanation for tooltips/documentation */
+    readonly details: {
+        readonly TRANSACTION_SEND: "User initiated a transaction (spending, transferring, or purchasing)";
+        readonly CLAIM_COMPLETED: "User successfully claimed a campaign reward";
+        readonly REDEMPTION_COMPLETED: "User successfully redeemed an offer";
+    };
+    /** What does NOT count as active */
+    readonly excluded: readonly ["Receiving tokens (passive)", "Failed or pending claims/redemptions", "System-generated transactions (REDEMPTION_RECEIVE)"];
+};
+/**
+ * Engagement rate formula
+ * engagementRate = (activeUsers / totalUsers) × 100
+ */
+export declare const ENGAGEMENT_RATE_FORMULA = "activeUsers / totalUsers \u00D7 100";
+/**
+ * Transaction statuses that count for analytics
+ */
+export declare const ANALYTICS_VALID_TRANSACTION_STATUSES: readonly ["SUCCEEDED", "BROADCASTED"];
+/**
+ * Process statuses that count for analytics (claims, redemptions)
+ */
+export declare const ANALYTICS_VALID_PROCESS_STATUS: "COMPLETED";
+//# sourceMappingURL=analytics.constants.d.ts.map

package/dist/esm/shared-lib/constants/analytics.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.constants.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/constants/analytics.constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB;IACjC,8CAA8C;;IAG9C,uCAAuC;;IAGvC,sDAAsD;;;;;;IAOtD,oCAAoC;;CAM5B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,uBAAuB,wCAAmC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,oCAAoC,uCAAwC,CAAC;AAE1F;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAG,WAAoB,CAAC"}

package/dist/esm/shared-lib/constants/analytics.constants.js

@@ -0,0 +1,49 @@
+/**
+ * Analytics Constants
+ *
+ * Shared definitions for consistent analytics across frontend and backend.
+ */
+/**
+ * Active User Definition
+ *
+ * A user qualifies as "active" in a given period if they performed
+ * any of the qualifying actions during that period.
+ *
+ * @example
+ * // Display in UI
+ * `${engagementRate}% engagement. ${ACTIVE_USER_DEFINITION.description}`
+ *
+ * // Result: "25.5% engagement. Active = sent transaction, claimed, or redeemed in period"
+ */
+export const ACTIVE_USER_DEFINITION = {
+    /** Actions that qualify a user as "active" */
+    qualifyingActions: ['TRANSACTION_SEND', 'CLAIM_COMPLETED', 'REDEMPTION_COMPLETED'],
+    /** Short description for UI display */
+    description: 'Active = sent transaction, claimed, or redeemed in period',
+    /** Detailed explanation for tooltips/documentation */
+    details: {
+        TRANSACTION_SEND: 'User initiated a transaction (spending, transferring, or purchasing)',
+        CLAIM_COMPLETED: 'User successfully claimed a campaign reward',
+        REDEMPTION_COMPLETED: 'User successfully redeemed an offer',
+    },
+    /** What does NOT count as active */
+    excluded: [
+        'Receiving tokens (passive)',
+        'Failed or pending claims/redemptions',
+        'System-generated transactions (REDEMPTION_RECEIVE)',
+    ],
+};
+/**
+ * Engagement rate formula
+ * engagementRate = (activeUsers / totalUsers) × 100
+ */
+export const ENGAGEMENT_RATE_FORMULA = 'activeUsers / totalUsers × 100';
+/**
+ * Transaction statuses that count for analytics
+ */
+export const ANALYTICS_VALID_TRANSACTION_STATUSES = ['SUCCEEDED', 'BROADCASTED'];
+/**
+ * Process statuses that count for analytics (claims, redemptions)
+ */
+export const ANALYTICS_VALID_PROCESS_STATUS = 'COMPLETED';
+//# sourceMappingURL=analytics.constants.js.map

package/dist/esm/shared-lib/constants/analytics.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.constants.js","sourceRoot":"","sources":["../../../../src/shared-lib/constants/analytics.constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,8CAA8C;IAC9C,iBAAiB,EAAE,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,sBAAsB,CAAC;IAElF,uCAAuC;IACvC,WAAW,EAAE,2DAA2D;IAExE,sDAAsD;IACtD,OAAO,EAAE;QACP,gBAAgB,EAAE,sEAAsE;QACxF,eAAe,EAAE,6CAA6C;QAC9D,oBAAoB,EAAE,qCAAqC;KAC5D;IAED,oCAAoC;IACpC,QAAQ,EAAE;QACR,4BAA4B;QAC5B,sCAAsC;QACtC,oDAAoD;KACrD;CACO,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,gCAAgC,CAAC;AAExE;;GAEG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,WAAW,EAAE,aAAa,CAAU,CAAC;AAE1F;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,WAAoB,CAAC"}

package/dist/esm/shared-lib/constants/index.d.ts

@@ -1,2 +1,3 @@
+export * from './analytics.constants';
 export * from './image-cdn.constants';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/shared-lib/constants/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/constants/index.ts"],"names":[],"mappings":"AACA,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/constants/index.ts"],"names":[],"mappings":"AACA,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist/esm/shared-lib/constants/index.js

@@ -1,3 +1,4 @@
 // Constants Barrel - Auto-exports all constants
+export * from './analytics.constants.js';
 export * from './image-cdn.constants.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/shared-lib/constants/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/constants/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/constants/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist/esm/shared-lib/dto/analytics/user-analytics.dto.d.ts

@@ -36,11 +36,16 @@ export declare class UserAnalyticsResponseDTO {
     averageTransactionsPerUser: number;
     averageTransactionAmount: number;
     totalTransactionVolume: number;
+    totalClaims: number;
     averageClaimsPerUser: number;
+    totalRedemptions: number;
     averageRedemptionsPerUser: number;
+    totalBurns: number;
+    averageBurnsPerUser: number;
     averageTransactionsPerActiveUser: number;
     averageClaimsPerActiveUser: number;
     averageRedemptionsPerActiveUser: number;
+    averageBurnsPerActiveUser: number;
     engagementRate: number;
     periodBreakdown?: {
         date: string;

package/dist/esm/shared-lib/dto/analytics/user-analytics.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-analytics.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/user-analytics.dto.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAG7D;;;;;GAKG;AACH,qBAAa,uBAAuB;IAQlC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,qBAAa,uBAAuB;IAWlC,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAQlC,SAAS,CAAC,EAAE,IAAI,CAAC;IAQjB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,qBAAa,wBAAwB;IAKnC,UAAU,EAAE,MAAM,CAAK;IAMvB,WAAW,EAAE,MAAM,CAAK;IAMxB,QAAQ,EAAE,MAAM,CAAK;IAMrB,0BAA0B,EAAE,MAAM,CAAK;IAMvC,wBAAwB,EAAE,MAAM,CAAK;IAMrC,sBAAsB,EAAE,MAAM,CAAK;IAMnC,oBAAoB,EAAE,MAAM,CAAK;IAMjC,yBAAyB,EAAE,MAAM,CAAK;IAMtC,gCAAgC,EAAE,MAAM,CAAK;IAM7C,0BAA0B,EAAE,MAAM,CAAK;IAMvC,+BAA+B,EAAE,MAAM,CAAK;IAO5C,cAAc,EAAE,MAAM,CAAK;IAc3B,eAAe,CAAC,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;IAiBJ,QAAQ,EAAE,qBAAqB,CAE7B;CACH"}
+{"version":3,"file":"user-analytics.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/user-analytics.dto.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAG7D;;;;;GAKG;AACH,qBAAa,uBAAuB;IAQlC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,qBAAa,uBAAuB;IAWlC,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAQlC,SAAS,CAAC,EAAE,IAAI,CAAC;IAQjB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,qBAAa,wBAAwB;IAKnC,UAAU,EAAE,MAAM,CAAK;IAMvB,WAAW,EAAE,MAAM,CAAK;IAMxB,QAAQ,EAAE,MAAM,CAAK;IAMrB,0BAA0B,EAAE,MAAM,CAAK;IAMvC,wBAAwB,EAAE,MAAM,CAAK;IAMrC,sBAAsB,EAAE,MAAM,CAAK;IAMnC,WAAW,EAAE,MAAM,CAAK;IAMxB,oBAAoB,EAAE,MAAM,CAAK;IAMjC,gBAAgB,EAAE,MAAM,CAAK;IAM7B,yBAAyB,EAAE,MAAM,CAAK;IAMtC,UAAU,EAAE,MAAM,CAAK;IAMvB,mBAAmB,EAAE,MAAM,CAAK;IAMhC,gCAAgC,EAAE,MAAM,CAAK;IAM7C,0BAA0B,EAAE,MAAM,CAAK;IAMvC,+BAA+B,EAAE,MAAM,CAAK;IAM5C,yBAAyB,EAAE,MAAM,CAAK;IAOtC,cAAc,EAAE,MAAM,CAAK;IAc3B,eAAe,CAAC,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;IAiBJ,QAAQ,EAAE,qBAAqB,CAE7B;CACH"}

package/dist/esm/shared-lib/dto/analytics/user-analytics.dto.js

@@ -82,11 +82,16 @@ export class UserAnalyticsResponseDTO {
     averageTransactionsPerUser = 0;
     averageTransactionAmount = 0;
     totalTransactionVolume = 0;
+    totalClaims = 0;
     averageClaimsPerUser = 0;
+    totalRedemptions = 0;
     averageRedemptionsPerUser = 0;
+    totalBurns = 0;
+    averageBurnsPerUser = 0;
     averageTransactionsPerActiveUser = 0;
     averageClaimsPerActiveUser = 0;
     averageRedemptionsPerActiveUser = 0;
+    averageBurnsPerActiveUser = 0;
     engagementRate = 0;
     periodBreakdown;
     metadata = {
@@ -129,18 +134,42 @@ __decorate([
         example: 56789.12
     })
 ], UserAnalyticsResponseDTO.prototype, "totalTransactionVolume", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Total completed claims in the date range. Only counts claims with status=COMPLETED.',
+        example: 1523
+    })
+], UserAnalyticsResponseDTO.prototype, "totalClaims", void 0);
 __decorate([
     ApiProperty({
         description: 'Average claims per user across entire user base (total completed claims in date range ÷ total users). Only counts claims with status=COMPLETED.',
         example: 3.2
     })
 ], UserAnalyticsResponseDTO.prototype, "averageClaimsPerUser", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Total completed redemptions in the date range. Only counts redemptions with status=COMPLETED.',
+        example: 892
+    })
+], UserAnalyticsResponseDTO.prototype, "totalRedemptions", void 0);
 __decorate([
     ApiProperty({
         description: 'Average redemptions per user across entire user base (total completed redemptions in date range ÷ total users). Only counts redemptions with status=COMPLETED.',
         example: 1.8
     })
 ], UserAnalyticsResponseDTO.prototype, "averageRedemptionsPerUser", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Total burn transactions in the date range. Only counts successful burn transactions (status=SUCCEEDED or BROADCASTED, type=BURN).',
+        example: 523
+    })
+], UserAnalyticsResponseDTO.prototype, "totalBurns", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Average burns per user across entire user base (total burns in date range ÷ total users).',
+        example: 0.5
+    })
+], UserAnalyticsResponseDTO.prototype, "averageBurnsPerUser", void 0);
 __decorate([
     ApiProperty({
         description: 'Average transactions per active user (total successful transactions in date range ÷ active users in date range). Provides more accurate engagement metric than averageTransactionsPerUser by excluding inactive users.',
@@ -159,6 +188,12 @@ __decorate([
         example: 2.1
     })
 ], UserAnalyticsResponseDTO.prototype, "averageRedemptionsPerActiveUser", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Average burns per active user (total burns in date range ÷ active users in date range).',
+        example: 0.8
+    })
+], UserAnalyticsResponseDTO.prototype, "averageBurnsPerActiveUser", void 0);
 __decorate([
     ApiProperty({
         description: 'User engagement rate as percentage (activeUsers ÷ totalUsers × 100). Indicates what percentage of all registered users had activity in the date range.',

package/dist/esm/shared-lib/dto/analytics/user-analytics.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-analytics.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/user-analytics.dto.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"user-analytics.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/user-analytics.dto.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,OAAO,uBAAuB;IAQlC,UAAU,CAAU;CACrB;AADC;IAPC,mBAAmB,CAAC;QACnB,WAAW,EAAE,iGAAiG;QAC9G,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,cAAc;KACxB,CAAC;IACD,aAAa,EAAE;2DACI;AAGtB;;;;;;;GAOG;AACH,MAAM,OAAO,uBAAuB;IAWlC,OAAO,CAA2B;IAQlC,SAAS,CAAQ;IAQjB,OAAO,CAAQ;CAChB;AAjBC;IAVC,mBAAmB,CAAC;QACnB,WAAW,EAAE,+DAA+D;QAC5E,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE;YACP,UAAU,EAAE,cAAc;SAC3B;KACF,CAAC;IACD,aAAa,EAAE;IACf,cAAc,EAAE;IAChB,IAAI,CAAC,GAAG,EAAE,CAAC,uBAAuB,CAAC;wDACF;AAQlC;IANC,mBAAmB,CAAC;QACnB,WAAW,EAAE,wIAAwI;QACrJ,OAAO,EAAE,sBAAsB;KAChC,CAAC;IACD,aAAa,EAAE;IACf,YAAY,EAAE;0DACE;AAQjB;IANC,mBAAmB,CAAC;QACnB,WAAW,EAAE,sIAAsI;QACnJ,OAAO,EAAE,sBAAsB;KAChC,CAAC;IACD,aAAa,EAAE;IACf,YAAY,EAAE;wDACA;AAGjB;;;;;;;GAOG;AACH,MAAM,OAAO,wBAAwB;IAKnC,UAAU,GAAW,CAAC,CAAC;IAMvB,WAAW,GAAW,CAAC,CAAC;IAMxB,QAAQ,GAAW,CAAC,CAAC;IAMrB,0BAA0B,GAAW,CAAC,CAAC;IAMvC,wBAAwB,GAAW,CAAC,CAAC;IAMrC,sBAAsB,GAAW,CAAC,CAAC;IAMnC,WAAW,GAAW,CAAC,CAAC;IAMxB,oBAAoB,GAAW,CAAC,CAAC;IAMjC,gBAAgB,GAAW,CAAC,CAAC;IAM7B,yBAAyB,GAAW,CAAC,CAAC;IAMtC,UAAU,GAAW,CAAC,CAAC;IAMvB,mBAAmB,GAAW,CAAC,CAAC;IAMhC,gCAAgC,GAAW,CAAC,CAAC;IAM7C,0BAA0B,GAAW,CAAC,CAAC;IAMvC,+BAA+B,GAAW,CAAC,CAAC;IAM5C,yBAAyB,GAAW,CAAC,CAAC;IAOtC,cAAc,GAAW,CAAC,CAAC;IAc3B,eAAe,CAIX;IAiBJ,QAAQ,GAA0B;QAChC,SAAS,EAAE,IAAI;KAChB,CAAC;CACH;AAvIC;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,6HAA6H;QAC1I,OAAO,EAAE,KAAK;KACf,CAAC;4DACqB;AAMvB;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,mQAAmQ;QAChR,OAAO,EAAE,IAAI;KACd,CAAC;6DACsB;AAMxB;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,yIAAyI;QACtJ,OAAO,EAAE,GAAG;KACb,CAAC;0DACmB;AAMrB;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,uPAAuP;QACpQ,OAAO,EAAE,IAAI;KACd,CAAC;4EACqC;AAMvC;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,wJAAwJ;QACrK,OAAO,EAAE,KAAK;KACf,CAAC;0EACmC;AAMrC;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,gKAAgK;QAC7K,OAAO,EAAE,QAAQ;KAClB,CAAC;wEACiC;AAMnC;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,qFAAqF;QAClG,OAAO,EAAE,IAAI;KACd,CAAC;6DACsB;AAMxB;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,iJAAiJ;QAC9J,OAAO,EAAE,GAAG;KACb,CAAC;sEAC+B;AAMjC;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,+FAA+F;QAC5G,OAAO,EAAE,GAAG;KACb,CAAC;kEAC2B;AAM7B;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,gKAAgK;QAC7K,OAAO,EAAE,GAAG;KACb,CAAC;2EACoC;AAMtC;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,mIAAmI;QAChJ,OAAO,EAAE,GAAG;KACb,CAAC;4DACqB;AAMvB;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,2FAA2F;QACxG,OAAO,EAAE,GAAG;KACb,CAAC;qEAC8B;AAMhC;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,wNAAwN;QACrO,OAAO,EAAE,IAAI;KACd,CAAC;kFAC2C;AAM7C;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,4JAA4J;QACzK,OAAO,EAAE,GAAG;KACb,CAAC;4EACqC;AAMvC;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,2KAA2K;QACxL,OAAO,EAAE,GAAG;KACb,CAAC;iFAC0C;AAM5C;IAJC,WAAW,CAAC;QACX,WAAW,EAAE,yFAAyF;QACtG,OAAO,EAAE,GAAG;KACb,CAAC;2EACoC;AAOtC;IALC,WAAW,CAAC;QACX,WAAW,EAAE,wJAAwJ;QACrK,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,QAAQ;KACf,CAAC;gEACyB;AAc3B;IAZC,mBAAmB,CAAC;QACnB,WAAW,EAAE,yCAAyC;QACtD,IAAI,EAAE,OAAO;QACb,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE;gBAC/C,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE;gBAC7C,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE;aAC1C;SACF;KACF,CAAC;iEAKE;AAiBJ;IAfC,WAAW,CAAC;QACX,WAAW,EAAE,4DAA4D;QACzE,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,UAAU,EAAE;oBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE;oBAClD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE;iBACjD;gBACD,WAAW,EAAE,uDAAuD;aACrE;SACF;KACF,CAAC;0DAGA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-shared",
-  "version": "2.1.149",
+  "version": "2.1.151",
   "scripts": {
     "clean": "find dist -type f -delete 2>/dev/null || true",
     "build:esm": "tsc -p tsconfig.esm.json && node scripts/add-js-extensions.js",