@explorins/pers-shared 2.1.80 → 2.1.82

package/dist/esm/shared-lib/dto/{transaction → analytics}/transaction-analytics.request.dto.d.ts

@@ -1,7 +1,8 @@
-import { TransactionDTO } from './transaction.dto';
+import { TransactionDTO } from '../transaction/transaction.dto';
 import { SortOrder } from '../../enum';
 import { AnalyticsGroupByType, AnalyticsMetricType, AnalyticsResultItem } from '../../types/analytics.type';
-import { GroupByExpressionDTO } from '../analytics/group-by-expression.dto';
+import { GroupByExpressionDTO } from './group-by-expression.dto';
+import { BaseAnalyticsMetadata } from './base-analytics.dto';
 declare const TransactionAnalyticsFiltersDTO_base: import("@nestjs/common").Type<Partial<Omit<TransactionDTO, "createdAt" | "updatedAt">>>;
 /**
  * Type-safe filters for transaction analytics
@@ -35,9 +36,7 @@ export type TransactionAnalyticsGroupByType = AnalyticsGroupByType | keyof Omit<
 export declare class TransactionAnalyticsResponseDTO {
     results: TransactionAnalyticsResultItem[];
     totalGroups: number;
-    metadata: {
-        executionTime: string;
-    };
+    metadata: BaseAnalyticsMetadata;
 }
 export type TransactionAnalyticsResultItem = AnalyticsResultItem & {
     [K in keyof Omit<TransactionDTO, 'id' | 'createdAt' | 'updatedAt' | 'transactionHash'>]?: TransactionDTO[K];

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

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-analytics.request.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/transaction-analytics.request.dto.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,SAAS,EAAoB,MAAM,YAAY,CAAC;AACzD,OAAO,EAA0B,oBAAoB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACpI,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;;AAE7D;;;;GAIG;AACH,qBAAa,8BAA+B,SAAQ,mCAEnD;CAAG;AAEJ;;;GAGG;AACH,qBAAa,8BAA8B;IAkBzC,OAAO,CAAC,EAAE,8BAA8B,CAAC;IAUzC,OAAO,CAAC,EAAE,+BAA+B,EAAE,CAAC;IAkB5C,kBAAkB,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAW5C,OAAO,EAAE,mBAAmB,EAAE,CAAa;IAU3C,MAAM,CAAC,EAAE,mBAAmB,GAAG,+BAA+B,GAAG,MAAM,CAAW;IASlF,SAAS,CAAC,EAAE,SAAS,CAAkB;IAcvC,KAAK,CAAC,EAAE,MAAM,CAAM;IASpB,SAAS,CAAC,EAAE,IAAI,CAAC;IAQjB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,+BAA+B,GACzC,oBAAoB,GAClB,MAAM,IAAI,CAAC,cAAc,EACrB,WAAW,GAAG,WAAW,GACzB,IAAI,GACJ,iBAAiB,CACpB,CAAC;AAEN;;GAEG;AACH,qBAAa,+BAA+B;IAU1C,OAAO,EAAE,8BAA8B,EAAE,CAAM;IAM/C,WAAW,EAAE,MAAM,CAAK;IAWxB,QAAQ,EAAE,qBAAqB,CAK7B;CACH;AAED,MAAM,MAAM,8BAA8B,GAAG,mBAAmB,GAAG;KAEhE,CAAC,IAAI,MAAM,IAAI,CAAC,cAAc,EAC3B,IAAI,GACJ,WAAW,GAAG,WAAW,GACzB,iBAAiB,CACpB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;CACvB,CAAC"}

package/dist/esm/shared-lib/dto/{transaction → analytics}/transaction-analytics.request.dto.js

@@ -7,10 +7,11 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { IsOptional, IsIn, IsNumber, IsString, IsObject, IsDateString, Min, Max, IsArray, ValidateNested, IsEnum } from 'class-validator';
 import { Transform, Type } from 'class-transformer';
 import { ApiProperty, ApiPropertyOptional, OmitType, PartialType } from '@nestjs/swagger';
-import { TransactionDTO } from './transaction.dto.js';
+import { TransactionDTO } from '../transaction/transaction.dto.js';
 import { SortOrder, AccountOwnerType } from '../../enum/index.js';
 import { ANALYTICS_METRIC_TYPES } from '../../types/analytics.type.js';
-import { GroupByExpressionDTO } from '../analytics/group-by-expression.dto.js';
+import { GroupByExpressionDTO } from './group-by-expression.dto.js';
+import { NativeTokenTypes } from '../../types/native-token.type.js';
 /**
  * Type-safe filters for transaction analytics
  * All fields optional via PartialType
@@ -42,11 +43,11 @@ export class TransactionAnalyticsRequestDTO {
 }
 __decorate([
     ApiPropertyOptional({
-        description: 'Dynamic filters based on TransactionDTO fields - all transaction fields available',
+        description: 'Dynamic filters based on TransactionDTO fields - all transaction fields available. Note: tokenType uses native blockchain types (ERC721, ERC20, ERC1155), not friendly names.',
         type: TransactionAnalyticsFiltersDTO,
         example: {
             status: 'SUCCEEDED',
-            tokenType: 'STAMP',
+            tokenType: NativeTokenTypes.ERC721,
             triggerProcessType: 'MINT',
             tenantId: 'tenant-123',
             chainId: 1
@@ -59,7 +60,7 @@ __decorate([
 ], TransactionAnalyticsRequestDTO.prototype, "filters", void 0);
 __decorate([
     ApiPropertyOptional({
-        description: 'Fields to group by - any TransactionDTO field plus computed time fields',
+        description: 'Fields to group by - any TransactionDTO field plus computed time fields. Note: tokenType values are ERC721/ERC20/ERC1155.',
         type: [String],
         example: ['tokenType', 'month', 'status', 'chainId']
     }),
@@ -147,17 +148,20 @@ export class TransactionAnalyticsResponseDTO {
     results = [];
     totalGroups = 0;
     metadata = {
-        executionTime: '0ms'
+        dateRange: {
+            startDate: new Date(),
+            endDate: new Date()
+        }
     };
 }
 __decorate([
     ApiProperty({
-        description: 'Analytics results array with dynamic fields and expression aliases',
+        description: 'Analytics results array with dynamic fields and expression aliases. Note: tokenType values are ERC721/ERC20/ERC1155, not friendly names.',
         type: 'array',
         example: [
             { userId: 'user-123', count: 45 },
             { userAddress: '0xabc...def', count: 32 },
-            { tokenType: 'STAMP', count: 150, month: '2024-01-01T00:00:00.000Z' }
+            { tokenType: NativeTokenTypes.ERC721, count: 150, month: '2024-01-01T00:00:00.000Z' }
         ]
     })
 ], TransactionAnalyticsResponseDTO.prototype, "results", void 0);
@@ -169,8 +173,13 @@ __decorate([
 ], TransactionAnalyticsResponseDTO.prototype, "totalGroups", void 0);
 __decorate([
     ApiProperty({
-        description: 'Query execution metadata',
-        example: { executionTime: '45ms' }
+        description: 'Query metadata showing applied date range (always present)',
+        example: {
+            dateRange: {
+                startDate: '2024-01-01T00:00:00.000Z',
+                endDate: '2024-12-31T23:59:59.999Z'
+            }
+        }
     })
 ], TransactionAnalyticsResponseDTO.prototype, "metadata", void 0);
 //# sourceMappingURL=transaction-analytics.request.dto.js.map

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

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

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

@@ -1,13 +1,25 @@
+import { BaseAnalyticsMetadata } from './base-analytics.dto';
+/**
+ * USER ANALYTICS FILTERS DTO
+ *
+ * Filters to scope user analytics aggregations.
+ * Determines which users/activity to include in calculations.
+ */
+export declare class UserAnalyticsFiltersDTO {
+    businessId?: string;
+}
 /**
  * USER ANALYTICS REQUEST DTO
  *
- * Filters for user analytics queries.
- * Supports date range filtering and business-specific analytics.
+ * Request structure for user engagement analytics.
+ * Supports date range filtering and business-specific scoping.
+ *
+ * Pattern matches TransactionAnalyticsRequestDTO and CampaignClaimAnalyticsRequestDTO for consistency.
  */
 export declare class UserAnalyticsRequestDTO {
+    filters?: UserAnalyticsFiltersDTO;
     startDate?: Date;
     endDate?: Date;
-    businessId?: string;
 }
 /**
  * USER ANALYTICS RESPONSE DTO
@@ -35,12 +47,6 @@ export declare class UserAnalyticsResponseDTO {
         activeUsers: number;
         newUsers: number;
     }[];
-    metadata: {
-        executionTimeMs: number;
-        dateRange?: {
-            startDate: Date;
-            endDate: Date;
-        };
-    };
+    metadata: BaseAnalyticsMetadata;
 }
 //# sourceMappingURL=user-analytics.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"user-analytics.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/user-analytics.dto.ts"],"names":[],"mappings":"AAEyC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACtG;;;;;GAKG;AACH,qBAAa,uBAAuB;IASlC,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;IAgBJ,QAAQ,EAAE,qBAAqB,CAK7B;CACH"}

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

@@ -5,35 +5,68 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsOptional, IsString, IsDateString, ValidateNested } from 'class-validator';
+import { Type } from 'class-transformer';
+/**
+ * USER ANALYTICS FILTERS DTO
+ *
+ * Filters to scope user analytics aggregations.
+ * Determines which users/activity to include in calculations.
+ */
+export class UserAnalyticsFiltersDTO {
+    businessId;
+}
+__decorate([
+    ApiPropertyOptional({
+        description: 'Filter analytics to specific business (filters transactions, claims, redemptions by businessId)',
+        type: String,
+        format: 'uuid',
+        example: 'biz-uuid-123'
+    }),
+    IsOptional(),
+    IsString()
+], UserAnalyticsFiltersDTO.prototype, "businessId", void 0);
 /**
  * USER ANALYTICS REQUEST DTO
  *
- * Filters for user analytics queries.
- * Supports date range filtering and business-specific analytics.
+ * Request structure for user engagement analytics.
+ * Supports date range filtering and business-specific scoping.
+ *
+ * Pattern matches TransactionAnalyticsRequestDTO and CampaignClaimAnalyticsRequestDTO for consistency.
  */
 export class UserAnalyticsRequestDTO {
+    filters;
     startDate;
     endDate;
-    businessId;
 }
 __decorate([
     ApiPropertyOptional({
-        description: 'Start date for filtering (ISO 8601)',
+        description: 'Filters to scope which users/activity to include in analytics',
+        type: UserAnalyticsFiltersDTO,
+        example: {
+            businessId: 'biz-uuid-123'
+        }
+    }),
+    IsOptional(),
+    ValidateNested(),
+    Type(() => UserAnalyticsFiltersDTO)
+], UserAnalyticsRequestDTO.prototype, "filters", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'Start date for filtering activity and new users (ISO 8601 format). Filters transactions, claims, redemptions, and user creation dates.',
         example: '2024-01-01T00:00:00Z'
-    })
+    }),
+    IsOptional(),
+    IsDateString()
 ], UserAnalyticsRequestDTO.prototype, "startDate", void 0);
 __decorate([
     ApiPropertyOptional({
-        description: 'End date for filtering (ISO 8601)',
+        description: 'End date for filtering activity and new users (ISO 8601 format). Filters transactions, claims, redemptions, and user creation dates.',
         example: '2024-12-31T23:59:59Z'
-    })
+    }),
+    IsOptional(),
+    IsDateString()
 ], UserAnalyticsRequestDTO.prototype, "endDate", void 0);
-__decorate([
-    ApiPropertyOptional({
-        description: 'Filter by specific business ID',
-        example: 'biz-uuid-123'
-    })
-], UserAnalyticsRequestDTO.prototype, "businessId", void 0);
 /**
  * USER ANALYTICS RESPONSE DTO
  *
@@ -56,7 +89,12 @@ export class UserAnalyticsResponseDTO {
     averageRedemptionsPerActiveUser = 0;
     engagementRate = 0;
     periodBreakdown;
-    metadata = { executionTimeMs: 0 };
+    metadata = {
+        dateRange: {
+            startDate: new Date(),
+            endDate: new Date()
+        }
+    };
 }
 __decorate([
     ApiProperty({
@@ -147,21 +185,16 @@ __decorate([
 ], UserAnalyticsResponseDTO.prototype, "periodBreakdown", void 0);
 __decorate([
     ApiProperty({
-        description: 'Query execution metadata including timing and applied filters',
+        description: 'Query metadata showing applied date range (always present)',
         type: 'object',
         properties: {
-            executionTimeMs: {
-                type: 'number',
-                example: 142,
-                description: 'SQL query execution time in milliseconds (for performance monitoring)'
-            },
             dateRange: {
                 type: 'object',
                 properties: {
                     startDate: { type: 'string', format: 'date-time' },
                     endDate: { type: 'string', format: 'date-time' }
                 },
-                description: 'Applied date range filter (only present if filters were used)'
+                description: 'Applied date range filter'
             }
         }
     })

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

@@ -0,0 +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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"}

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

@@ -0,0 +1,71 @@
+import { SortOrder } from '../../enum';
+import type { NativeTokenType } from '../../types/native-token.type';
+import { BaseAnalyticsMetadata } from './base-analytics.dto';
+/**
+ * USER RANKING FILTERS DTO
+ *
+ * Filters to scope user ranking calculations.
+ * Determines which transactions/users to include.
+ */
+export declare class UserRankingFiltersDTO {
+    businessId?: string;
+    tokenType?: NativeTokenType;
+}
+/**
+ * USER RANKING REQUEST DTO
+ *
+ * Request structure for user transaction ranking analytics.
+ * Returns ranked list of users with transaction metrics and full user details.
+ *
+ * Use Cases:
+ * - Admin leaderboards showing top users by activity
+ * - User engagement analysis with full user context
+ * - Identifying power users for campaigns
+ */
+export declare class UserRankingAnalyticsRequestDTO {
+    filters?: UserRankingFiltersDTO;
+    sortBy?: 'totalTransactions' | 'tokenSpent' | 'userId' | 'email';
+    sortOrder?: SortOrder;
+    limit?: number;
+    startDate?: Date;
+    endDate?: Date;
+}
+/**
+ * USER RANKING RESULT ITEM DTO
+ *
+ * Single user's ranking data with full user details and transaction metrics.
+ * Enriched with user data via SQL JOIN (not post-query enrichment).
+ */
+export declare class UserRankingResultItemDTO {
+    userId: string | null;
+    email: string | null;
+    externalUserId: string | null;
+    totalTransactions: number;
+    tokenSpent: number;
+    hasLegacyTransactions?: boolean;
+}
+/**
+ * USER RANKING RESPONSE DTO
+ *
+ * Ranked list of users with transaction metrics and full user details.
+ * Results are pre-sorted by backend according to request.sortBy/sortOrder.
+ */
+export declare class UserRankingAnalyticsResponseDTO {
+    results: UserRankingResultItemDTO[];
+    totalUsers: number;
+    metadata: BaseAnalyticsMetadata & {
+        /**
+         * Token type used for filtering sum (if provided in request)
+         * Native token type (ERC721, ERC20, ERC1155)
+         */
+        tokenType?: NativeTokenType;
+        /**
+         * Sort configuration applied
+         */
+        sorting?: {
+            sortBy: string;
+            sortOrder: SortOrder;
+        };
+    };
+}
+//# sourceMappingURL=user-ranking-analytics.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"user-ranking-analytics.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/user-ranking-analytics.dto.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;GAKG;AACH,qBAAa,qBAAqB;IAShC,UAAU,CAAC,EAAE,MAAM,CAAC;IASpB,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,8BAA8B;IAYzC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAUhC,MAAM,CAAC,EAAE,mBAAmB,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;IAUjE,SAAS,CAAC,EAAE,SAAS,CAAC;IAatB,KAAK,CAAC,EAAE,MAAM,CAAC;IAQf,SAAS,CAAC,EAAE,IAAI,CAAC;IAQjB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;GAKG;AACH,qBAAa,wBAAwB;IAUnC,MAAM,EAAG,MAAM,GAAG,IAAI,CAAC;IASvB,KAAK,EAAG,MAAM,GAAG,IAAI,CAAC;IAQtB,cAAc,EAAG,MAAM,GAAG,IAAI,CAAC;IAQ/B,iBAAiB,EAAG,MAAM,CAAC;IAM3B,UAAU,EAAG,MAAM,CAAC;IAUpB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;;;GAKG;AACH,qBAAa,+BAA+B;IAM1C,OAAO,EAAG,wBAAwB,EAAE,CAAC;IAMrC,UAAU,EAAG,MAAM,CAAC;IAMpB,QAAQ,EAAG,qBAAqB,GAAG;QACjC;;;WAGG;QACH,SAAS,CAAC,EAAE,eAAe,CAAC;QAE5B;;WAEG;QACH,OAAO,CAAC,EAAE;YACR,MAAM,EAAE,MAAM,CAAC;YACf,SAAS,EAAE,SAAS,CAAC;SACtB,CAAC;KACH,CAAC;CACH"}

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

@@ -0,0 +1,215 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsOptional, IsString, IsDateString, IsEnum, IsNumber, ValidateNested, Min, Max } from 'class-validator';
+import { Type } from 'class-transformer';
+import { SortOrder } from '../../enum/index.js';
+import { NativeTokenTypes } from '../../types/native-token.type.js';
+/**
+ * USER RANKING FILTERS DTO
+ *
+ * Filters to scope user ranking calculations.
+ * Determines which transactions/users to include.
+ */
+export class UserRankingFiltersDTO {
+    businessId;
+    tokenType;
+}
+__decorate([
+    ApiPropertyOptional({
+        description: 'Filter to specific business (filters transactions by engagedBusinessId)',
+        type: String,
+        format: 'uuid',
+        example: 'biz-uuid-123'
+    }),
+    IsOptional(),
+    IsString()
+], UserRankingFiltersDTO.prototype, "businessId", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'Filter token sum by specific native token type (ERC721 for stamps, ERC20 for credits, ERC1155 for multi-token). Transaction count includes ALL token types, but sum only includes this type. Frontend SDK should convert friendly names (STAMP → ERC721, CREDIT → ERC20).',
+        enum: NativeTokenTypes,
+        example: NativeTokenTypes.ERC721
+    }),
+    IsOptional(),
+    IsEnum(NativeTokenTypes)
+], UserRankingFiltersDTO.prototype, "tokenType", void 0);
+/**
+ * USER RANKING REQUEST DTO
+ *
+ * Request structure for user transaction ranking analytics.
+ * Returns ranked list of users with transaction metrics and full user details.
+ *
+ * Use Cases:
+ * - Admin leaderboards showing top users by activity
+ * - User engagement analysis with full user context
+ * - Identifying power users for campaigns
+ */
+export class UserRankingAnalyticsRequestDTO {
+    filters;
+    sortBy;
+    sortOrder;
+    limit;
+    startDate;
+    endDate;
+}
+__decorate([
+    ApiPropertyOptional({
+        description: 'Filters to scope which transactions/users to include',
+        type: UserRankingFiltersDTO,
+        example: {
+            businessId: 'biz-uuid-123',
+            tokenType: NativeTokenTypes.ERC721
+        }
+    }),
+    IsOptional(),
+    ValidateNested(),
+    Type(() => UserRankingFiltersDTO)
+], UserRankingAnalyticsRequestDTO.prototype, "filters", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'Field to sort results by',
+        enum: ['totalTransactions', 'tokenSpent', 'userId', 'email'],
+        default: 'totalTransactions',
+        example: 'totalTransactions'
+    }),
+    IsOptional(),
+    IsString()
+], UserRankingAnalyticsRequestDTO.prototype, "sortBy", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'Sort direction',
+        enum: SortOrder,
+        default: SortOrder.DESC,
+        example: SortOrder.DESC
+    }),
+    IsOptional(),
+    IsEnum(SortOrder)
+], UserRankingAnalyticsRequestDTO.prototype, "sortOrder", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'Maximum number of results to return (top N users)',
+        minimum: 1,
+        maximum: 1000,
+        default: 50,
+        example: 50
+    }),
+    IsOptional(),
+    IsNumber(),
+    Min(1),
+    Max(1000)
+], UserRankingAnalyticsRequestDTO.prototype, "limit", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'Start date for filtering transactions (ISO 8601 format). Only transactions within date range are counted.',
+        example: '2024-01-01T00:00:00Z'
+    }),
+    IsOptional(),
+    IsDateString()
+], UserRankingAnalyticsRequestDTO.prototype, "startDate", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'End date for filtering transactions (ISO 8601 format). Only transactions within date range are counted.',
+        example: '2024-12-31T23:59:59Z'
+    }),
+    IsOptional(),
+    IsDateString()
+], UserRankingAnalyticsRequestDTO.prototype, "endDate", void 0);
+/**
+ * USER RANKING RESULT ITEM DTO
+ *
+ * Single user's ranking data with full user details and transaction metrics.
+ * Enriched with user data via SQL JOIN (not post-query enrichment).
+ */
+export class UserRankingResultItemDTO {
+    // ========== USER IDENTITY ==========
+    userId;
+    email;
+    externalUserId;
+    // ========== TRANSACTION METRICS ==========
+    totalTransactions;
+    tokenSpent;
+    // ========== METADATA ==========
+    hasLegacyTransactions;
+}
+__decorate([
+    ApiProperty({
+        description: 'User UUID. NULL for system/business senders (filtered out in most cases).',
+        type: String,
+        format: 'uuid',
+        nullable: true,
+        example: 'user-uuid-123'
+    })
+], UserRankingResultItemDTO.prototype, "userId", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'User email address. NULL if user privacy settings hide email or user is system/business.',
+        type: String,
+        format: 'email',
+        nullable: true,
+        example: 'user@example.com'
+    })
+], UserRankingResultItemDTO.prototype, "email", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'External user identifier from external system (CRM, auth provider, etc.). NULL if not set.',
+        type: String,
+        nullable: true,
+        example: 'ext-user-123'
+    })
+], UserRankingResultItemDTO.prototype, "externalUserId", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Total number of successful transactions (status=succeeded) for this user across ALL token types. Counts both sent and received transactions.',
+        example: 42
+    })
+], UserRankingResultItemDTO.prototype, "totalTransactions", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Total amount spent/transferred in the filtered token type (filters.tokenType). If no tokenType filter specified, sums ALL token types. Only counts successful transactions (status=succeeded).',
+        example: 1250.50
+    })
+], UserRankingResultItemDTO.prototype, "tokenSpent", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'Indicates if this user has transactions without senderId (legacy transactions). User may still have full details if resolved via wallet or accountAddress. Post-migration, this will always be false.',
+        type: Boolean,
+        default: false,
+        example: false
+    })
+], UserRankingResultItemDTO.prototype, "hasLegacyTransactions", void 0);
+/**
+ * USER RANKING RESPONSE DTO
+ *
+ * Ranked list of users with transaction metrics and full user details.
+ * Results are pre-sorted by backend according to request.sortBy/sortOrder.
+ */
+export class UserRankingAnalyticsResponseDTO {
+    results;
+    totalUsers;
+    metadata;
+}
+__decorate([
+    ApiProperty({
+        description: 'Ranked list of users with transaction metrics and full user details. Pre-sorted by backend.',
+        type: [UserRankingResultItemDTO],
+        isArray: true
+    })
+], UserRankingAnalyticsResponseDTO.prototype, "results", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Total number of users returned (≤ request.limit)',
+        example: 50
+    })
+], UserRankingAnalyticsResponseDTO.prototype, "totalUsers", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Metadata about the query execution',
+        type: 'object'
+    })
+], UserRankingAnalyticsResponseDTO.prototype, "metadata", void 0);
+//# sourceMappingURL=user-ranking-analytics.dto.js.map

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

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

package/dist/esm/shared-lib/dto/campaign/campaign-claim-analytics-request.dto.d.ts

@@ -1,7 +1,8 @@
-import { CampaignClaimAnalyticsDTO } from './campaign-claim-analytics.dto';
+import { CampaignClaimAnalyticsDTO } from '../analytics/campaign-claim-analytics.dto';
 import { SortOrder } from '../../enum';
 import { AnalyticsGroupByType, AnalyticsMetricType, AnalyticsResultItem } from '../../types/analytics.type';
 import { GroupByExpressionDTO } from '../analytics/group-by-expression.dto';
+import { BaseAnalyticsMetadata } from '../analytics/base-analytics.dto';
 declare const CampaignClaimAnalyticsFiltersDTO_base: import("@nestjs/common").Type<Partial<Omit<CampaignClaimAnalyticsDTO, "user" | "business" | "campaign" | "triggerSource" | "createdAt">>>;
 /**
  * SCALABLE ANALYTICS REQUEST PATTERN
@@ -56,9 +57,7 @@ export type CampaignClaimAnalyticsGroupByType = AnalyticsGroupByType | keyof Omi
 export declare class CampaignClaimAnalyticsResponseDTO {
     results: CampaignClaimAnalyticsResultItem[];
     totalGroups: number;
-    metadata: {
-        executionTime: string;
-    };
+    metadata: BaseAnalyticsMetadata;
 }
 export type CampaignClaimAnalyticsResultItem = AnalyticsResultItem & {
     [K in keyof Omit<CampaignClaimAnalyticsDTO, 'id' | 'createdAt' | 'user' | 'campaign' | 'business' | 'triggerSource' | 'message'>]?: CampaignClaimAnalyticsDTO[K];

package/dist/esm/shared-lib/dto/campaign/campaign-claim-analytics-request.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"campaign-claim-analytics-request.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/campaign/campaign-claim-analytics-request.dto.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAA0B,oBAAoB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACpI,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;;AAE5E;;;;;;;;;;;GAWG;AAEH;;;GAGG;AACH,qBAAa,gCAAiC,SAAQ,qCAQrD;IASC,MAAM,CAAC,EAAE,MAAM,CAAC;IAShB,UAAU,CAAC,EAAE,MAAM,CAAC;IASpB,UAAU,CAAC,EAAE,MAAM,CAAC;IASpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,qBAAa,gCAAgC;IAe3C,OAAO,CAAC,EAAE,gCAAgC,CAAC;IAU3C,OAAO,CAAC,EAAE,iCAAiC,EAAE,CAAC;IAe9C,kBAAkB,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAW5C,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAa;IAS5C,MAAM,CAAC,EAAE,mBAAmB,GAAG,iCAAiC,GAAG,MAAM,CAAW;IASpF,SAAS,CAAC,EAAE,SAAS,CAAkB;IAcvC,KAAK,CAAC,EAAE,MAAM,CAAM;IASpB,SAAS,CAAC,EAAE,IAAI,CAAC;IAQjB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,iCAAiC,GAC3C,oBAAoB,GAClB,MAAM,IAAI,CAAC,yBAAyB,EAChC,WAAW,GACX,IAAI,GACJ,MAAM,GACN,UAAU,GACV,UAAU,GACV,eAAe,CAClB,CAAC;AAEN;;;;GAIG;AACH,qBAAa,iCAAiC;IAU5C,OAAO,EAAE,gCAAgC,EAAE,CAAM;IAMjD,WAAW,EAAE,MAAM,CAAK;IAMxB,QAAQ,EAAE;QACR,aAAa,EAAE,MAAM,CAAC;KACvB,CAEC;CACH;AAED,MAAM,MAAM,gCAAgC,GAAG,mBAAmB,GAAG;KAElE,CAAC,IAAI,MAAM,IAAI,CAAC,yBAAyB,EACtC,IAAI,GACJ,WAAW,GACX,MAAM,GACN,UAAU,GACV,UAAU,GACV,eAAe,GACf,SAAS,CACZ,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC,CAAC;CAClC,CAAC"}
+{"version":3,"file":"campaign-claim-analytics-request.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/campaign/campaign-claim-analytics-request.dto.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAA0B,oBAAoB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACpI,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;;AAExE;;;;;;;;;;;GAWG;AAEH;;;GAGG;AACH,qBAAa,gCAAiC,SAAQ,qCAQrD;IASC,MAAM,CAAC,EAAE,MAAM,CAAC;IAShB,UAAU,CAAC,EAAE,MAAM,CAAC;IASpB,UAAU,CAAC,EAAE,MAAM,CAAC;IASpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,qBAAa,gCAAgC;IAe3C,OAAO,CAAC,EAAE,gCAAgC,CAAC;IAU3C,OAAO,CAAC,EAAE,iCAAiC,EAAE,CAAC;IAe9C,kBAAkB,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAW5C,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAa;IAS5C,MAAM,CAAC,EAAE,mBAAmB,GAAG,iCAAiC,GAAG,MAAM,CAAW;IASpF,SAAS,CAAC,EAAE,SAAS,CAAkB;IAcvC,KAAK,CAAC,EAAE,MAAM,CAAM;IASpB,SAAS,CAAC,EAAE,IAAI,CAAC;IAQjB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,iCAAiC,GAC3C,oBAAoB,GAClB,MAAM,IAAI,CAAC,yBAAyB,EAChC,WAAW,GACX,IAAI,GACJ,MAAM,GACN,UAAU,GACV,UAAU,GACV,eAAe,CAClB,CAAC;AAEN;;;;GAIG;AACH,qBAAa,iCAAiC;IAU5C,OAAO,EAAE,gCAAgC,EAAE,CAAM;IAMjD,WAAW,EAAE,MAAM,CAAK;IAWxB,QAAQ,EAAE,qBAAqB,CAK7B;CACH;AAED,MAAM,MAAM,gCAAgC,GAAG,mBAAmB,GAAG;KAElE,CAAC,IAAI,MAAM,IAAI,CAAC,yBAAyB,EACtC,IAAI,GACJ,WAAW,GACX,MAAM,GACN,UAAU,GACV,UAAU,GACV,eAAe,GACf,SAAS,CACZ,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC,CAAC;CAClC,CAAC"}

package/dist/esm/shared-lib/dto/campaign/campaign-claim-analytics-request.dto.js

@@ -7,7 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { IsOptional, IsNumber, Min, Max, IsArray, IsString, ValidateNested, IsEnum, IsIn, IsDateString } from 'class-validator';
 import { Transform, Type } from 'class-transformer';
 import { ApiProperty, ApiPropertyOptional, OmitType, PartialType } from '@nestjs/swagger';
-import { CampaignClaimAnalyticsDTO } from './campaign-claim-analytics.dto.js';
+import { CampaignClaimAnalyticsDTO } from '../analytics/campaign-claim-analytics.dto.js';
 import { SortOrder } from '../../enum/index.js';
 import { ANALYTICS_METRIC_TYPES } from '../../types/analytics.type.js';
 import { GroupByExpressionDTO } from '../analytics/group-by-expression.dto.js';
@@ -204,7 +204,10 @@ export class CampaignClaimAnalyticsResponseDTO {
     results = [];
     totalGroups = 0;
     metadata = {
-        executionTime: '0ms'
+        dateRange: {
+            startDate: new Date(),
+            endDate: new Date()
+        }
     };
 }
 __decorate([
@@ -226,8 +229,13 @@ __decorate([
 ], CampaignClaimAnalyticsResponseDTO.prototype, "totalGroups", void 0);
 __decorate([
     ApiProperty({
-        description: 'Query execution metadata',
-        example: { executionTime: '15ms' }
+        description: 'Query metadata showing applied date range (always present)',
+        example: {
+            dateRange: {
+                startDate: '2024-01-01T00:00:00.000Z',
+                endDate: '2024-12-31T23:59:59.999Z'
+            }
+        }
     })
 ], CampaignClaimAnalyticsResponseDTO.prototype, "metadata", void 0);
 //# sourceMappingURL=campaign-claim-analytics-request.dto.js.map