@explorins/pers-shared 2.1.80 → 2.1.82

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

@@ -0,0 +1,242 @@
+"use strict";
+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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserRankingAnalyticsResponseDTO = exports.UserRankingResultItemDTO = exports.UserRankingAnalyticsRequestDTO = exports.UserRankingFiltersDTO = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const enum_1 = require("../../enum");
+const native_token_type_1 = require("../../types/native-token.type");
+/**
+ * USER RANKING FILTERS DTO
+ *
+ * Filters to scope user ranking calculations.
+ * Determines which transactions/users to include.
+ */
+class UserRankingFiltersDTO {
+    businessId;
+    tokenType;
+}
+exports.UserRankingFiltersDTO = UserRankingFiltersDTO;
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Filter to specific business (filters transactions by engagedBusinessId)',
+        type: String,
+        format: 'uuid',
+        example: 'biz-uuid-123'
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UserRankingFiltersDTO.prototype, "businessId", void 0);
+__decorate([
+    (0, swagger_1.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: native_token_type_1.NativeTokenTypes,
+        example: native_token_type_1.NativeTokenTypes.ERC721
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(native_token_type_1.NativeTokenTypes),
+    __metadata("design:type", String)
+], 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
+ */
+class UserRankingAnalyticsRequestDTO {
+    filters;
+    sortBy;
+    sortOrder;
+    limit;
+    startDate;
+    endDate;
+}
+exports.UserRankingAnalyticsRequestDTO = UserRankingAnalyticsRequestDTO;
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Filters to scope which transactions/users to include',
+        type: UserRankingFiltersDTO,
+        example: {
+            businessId: 'biz-uuid-123',
+            tokenType: native_token_type_1.NativeTokenTypes.ERC721
+        }
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => UserRankingFiltersDTO),
+    __metadata("design:type", UserRankingFiltersDTO)
+], UserRankingAnalyticsRequestDTO.prototype, "filters", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Field to sort results by',
+        enum: ['totalTransactions', 'tokenSpent', 'userId', 'email'],
+        default: 'totalTransactions',
+        example: 'totalTransactions'
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UserRankingAnalyticsRequestDTO.prototype, "sortBy", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Sort direction',
+        enum: enum_1.SortOrder,
+        default: enum_1.SortOrder.DESC,
+        example: enum_1.SortOrder.DESC
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(enum_1.SortOrder),
+    __metadata("design:type", String)
+], UserRankingAnalyticsRequestDTO.prototype, "sortOrder", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Maximum number of results to return (top N users)',
+        minimum: 1,
+        maximum: 1000,
+        default: 50,
+        example: 50
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(1000),
+    __metadata("design:type", Number)
+], UserRankingAnalyticsRequestDTO.prototype, "limit", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Start date for filtering transactions (ISO 8601 format). Only transactions within date range are counted.',
+        example: '2024-01-01T00:00:00Z'
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsDateString)(),
+    __metadata("design:type", Date)
+], UserRankingAnalyticsRequestDTO.prototype, "startDate", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'End date for filtering transactions (ISO 8601 format). Only transactions within date range are counted.',
+        example: '2024-12-31T23:59:59Z'
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsDateString)(),
+    __metadata("design:type", Date)
+], 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).
+ */
+class UserRankingResultItemDTO {
+    // ========== USER IDENTITY ==========
+    userId;
+    email;
+    externalUserId;
+    // ========== TRANSACTION METRICS ==========
+    totalTransactions;
+    tokenSpent;
+    // ========== METADATA ==========
+    hasLegacyTransactions;
+}
+exports.UserRankingResultItemDTO = UserRankingResultItemDTO;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'User UUID. NULL for system/business senders (filtered out in most cases).',
+        type: String,
+        format: 'uuid',
+        nullable: true,
+        example: 'user-uuid-123'
+    }),
+    __metadata("design:type", Object)
+], UserRankingResultItemDTO.prototype, "userId", void 0);
+__decorate([
+    (0, swagger_1.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'
+    }),
+    __metadata("design:type", Object)
+], UserRankingResultItemDTO.prototype, "email", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'External user identifier from external system (CRM, auth provider, etc.). NULL if not set.',
+        type: String,
+        nullable: true,
+        example: 'ext-user-123'
+    }),
+    __metadata("design:type", Object)
+], UserRankingResultItemDTO.prototype, "externalUserId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Total number of successful transactions (status=succeeded) for this user across ALL token types. Counts both sent and received transactions.',
+        example: 42
+    }),
+    __metadata("design:type", Number)
+], UserRankingResultItemDTO.prototype, "totalTransactions", void 0);
+__decorate([
+    (0, swagger_1.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
+    }),
+    __metadata("design:type", Number)
+], UserRankingResultItemDTO.prototype, "tokenSpent", void 0);
+__decorate([
+    (0, swagger_1.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
+    }),
+    __metadata("design:type", Boolean)
+], 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.
+ */
+class UserRankingAnalyticsResponseDTO {
+    results;
+    totalUsers;
+    metadata;
+}
+exports.UserRankingAnalyticsResponseDTO = UserRankingAnalyticsResponseDTO;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Ranked list of users with transaction metrics and full user details. Pre-sorted by backend.',
+        type: [UserRankingResultItemDTO],
+        isArray: true
+    }),
+    __metadata("design:type", Array)
+], UserRankingAnalyticsResponseDTO.prototype, "results", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Total number of users returned (≤ request.limit)',
+        example: 50
+    }),
+    __metadata("design:type", Number)
+], UserRankingAnalyticsResponseDTO.prototype, "totalUsers", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Metadata about the query execution',
+        type: 'object'
+    }),
+    __metadata("design:type", Object)
+], UserRankingAnalyticsResponseDTO.prototype, "metadata", void 0);
+//# sourceMappingURL=user-ranking-analytics.dto.js.map

package/dist/cjs/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/cjs/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/cjs/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/cjs/shared-lib/dto/campaign/campaign-claim-analytics-request.dto.js

@@ -13,7 +13,7 @@ exports.CampaignClaimAnalyticsResponseDTO = exports.CampaignClaimAnalyticsReques
 const class_validator_1 = require("class-validator");
 const class_transformer_1 = require("class-transformer");
 const swagger_1 = require("@nestjs/swagger");
-const campaign_claim_analytics_dto_1 = require("./campaign-claim-analytics.dto");
+const campaign_claim_analytics_dto_1 = require("../analytics/campaign-claim-analytics.dto");
 const enum_1 = require("../../enum");
 const analytics_type_1 = require("../../types/analytics.type");
 const group_by_expression_dto_1 = require("../analytics/group-by-expression.dto");
@@ -225,7 +225,10 @@ class CampaignClaimAnalyticsResponseDTO {
     results = [];
     totalGroups = 0;
     metadata = {
-        executionTime: '0ms'
+        dateRange: {
+            startDate: new Date(),
+            endDate: new Date()
+        }
     };
 }
 exports.CampaignClaimAnalyticsResponseDTO = CampaignClaimAnalyticsResponseDTO;
@@ -250,8 +253,13 @@ __decorate([
 ], CampaignClaimAnalyticsResponseDTO.prototype, "totalGroups", void 0);
 __decorate([
     (0, swagger_1.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'
+            }
+        }
     }),
     __metadata("design:type", Object)
 ], CampaignClaimAnalyticsResponseDTO.prototype, "metadata", void 0);

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

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

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

@@ -1,12 +1,14 @@
+export * from './analytics/base-analytics.dto';
 export * from './analytics/group-by-expression.dto';
 export * from './analytics/usage-analytics.dto';
+export * from './analytics/user-ranking-analytics.dto';
 export * from './auth';
 export * from './business';
 export * from './tenant';
 export * from './user.dto';
 export * from './user.request.dto';
 export * from './user-status-type.dto';
-export * from './user-analytics.dto';
+export * from './analytics/user-analytics.dto';
 export * from './userUploadData.dto';
 export * from './error-response.dto';
 export * from './account-token-balances.dto';
@@ -25,7 +27,7 @@ export * from './campaign/campaignCreate.request.dto';
 export * from './campaign/campaignUpdate.request.dto';
 export * from './campaign/campaignClaim.request.dto';
 export * from './campaign/campaignTrigger.dto';
-export * from './campaign/campaign-claim-analytics.dto';
+export * from './analytics/campaign-claim-analytics.dto';
 export * from './campaign/campaign-claim-analytics-request.dto';
 export * from './campaign/campaignTriggerCondition.dto';
 export * from './campaign/campaignUserClaim.dto';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/dto/index.ts"],"names":[],"mappings":"AAKA,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAGhD,cAAc,QAAQ,CAAC;AAGvB,cAAc,YAAY,CAAA;AAG1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAE7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAG7B,cAAc,SAAS,CAAC;AAGxB,cAAc,eAAe,CAAC;AAG9B,cAAc,YAAY,CAAC;AAI3B,cAAc,cAAc,CAAC;AAE7B,cAAc,WAAW,CAAA;AAGzB,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yCAAyC,CAAC;AACxD,cAAc,iDAAiD,CAAC;AAChE,cAAc,yCAAyC,CAAC;AACxD,cAAc,kCAAkC,CAAC;AACjD,cAAc,qDAAqD,CAAC;AACpE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,+BAA+B,CAAC;AAI9C,cAAc,mBAAmB,CAAA;AAGjC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,cAAc,CAAC;AAE7B,cAAc,mBAAmB,CAAC;AAIlC,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/dto/index.ts"],"names":[],"mappings":"AAKA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,wCAAwC,CAAC;AAGvD,cAAc,QAAQ,CAAC;AAGvB,cAAc,YAAY,CAAA;AAG1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AAGrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAE7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAG7B,cAAc,SAAS,CAAC;AAGxB,cAAc,eAAe,CAAC;AAG9B,cAAc,YAAY,CAAC;AAI3B,cAAc,cAAc,CAAC;AAE7B,cAAc,WAAW,CAAA;AAGzB,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0CAA0C,CAAC;AACzD,cAAc,iDAAiD,CAAC;AAChE,cAAc,yCAAyC,CAAC;AACxD,cAAc,kCAAkC,CAAC;AACjD,cAAc,qDAAqD,CAAC;AACpE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,+BAA+B,CAAC;AAI9C,cAAc,mBAAmB,CAAA;AAGjC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,cAAc,CAAC;AAE7B,cAAc,mBAAmB,CAAC;AAIlC,cAAc,SAAS,CAAC"}

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

@@ -17,8 +17,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 // Analytics DTOs
+__exportStar(require("./analytics/base-analytics.dto"), exports);
 __exportStar(require("./analytics/group-by-expression.dto"), exports);
 __exportStar(require("./analytics/usage-analytics.dto"), exports);
+__exportStar(require("./analytics/user-ranking-analytics.dto"), exports);
 // Auth DTOs
 __exportStar(require("./auth"), exports);
 // Business DTOs
@@ -28,7 +30,7 @@ __exportStar(require("./tenant"), exports);
 __exportStar(require("./user.dto"), exports);
 __exportStar(require("./user.request.dto"), exports);
 __exportStar(require("./user-status-type.dto"), exports);
-__exportStar(require("./user-analytics.dto"), exports);
+__exportStar(require("./analytics/user-analytics.dto"), exports);
 __exportStar(require("./userUploadData.dto"), exports);
 // Error Response DTOs
 __exportStar(require("./error-response.dto"), exports);
@@ -53,7 +55,7 @@ __exportStar(require("./campaign/campaignCreate.request.dto"), exports);
 __exportStar(require("./campaign/campaignUpdate.request.dto"), exports);
 __exportStar(require("./campaign/campaignClaim.request.dto"), exports);
 __exportStar(require("./campaign/campaignTrigger.dto"), exports);
-__exportStar(require("./campaign/campaign-claim-analytics.dto"), exports);
+__exportStar(require("./analytics/campaign-claim-analytics.dto"), exports);
 __exportStar(require("./campaign/campaign-claim-analytics-request.dto"), exports);
 __exportStar(require("./campaign/campaignTriggerCondition.dto"), exports);
 __exportStar(require("./campaign/campaignUserClaim.dto"), exports);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/dto/index.ts"],"names":[],"mappings":";AAAA,sCAAsC;AACtC,qFAAqF;;;;;;;;;;;;;;;;AAGrF,iBAAiB;AACjB,sEAAoD;AACpD,kEAAgD;AAEhD,YAAY;AACZ,yCAAuB;AAEvB,gBAAgB;AAChB,6CAA0B;AAE1B,YAAY;AACZ,2CAAyB;AACzB,6CAA2B;AAC3B,qDAAmC;AACnC,yDAAuC;AACvC,uDAAqC;AACrC,uDAAqC;AAErC,sBAAsB;AACtB,uDAAqC;AACrC,+DAA6C;AAE7C,sDAAoC;AACpC,oDAAkC;AAClC,4CAA0B;AAC1B,+CAA6B;AAE7B,aAAa;AACb,0CAAwB;AAExB,mBAAmB;AACnB,gDAA8B;AAE9B,gBAAgB;AAChB,6CAA2B;AAG3B,kBAAkB;AAClB,+CAA6B;AAE7B,4CAAyB;AAEzB,gBAAgB;AAChB,0DAAwC;AACxC,gEAA8C;AAC9C,wEAAsD;AACtD,wEAAsD;AACtD,uEAAqD;AACrD,iEAA+C;AAC/C,0EAAwD;AACxD,kFAAgE;AAChE,0EAAwD;AACxD,mEAAiD;AACjD,sFAAoE;AACpE,8EAA4D;AAC5D,gEAA8C;AAG9C,uBAAuB;AACvB,oDAAiC;AAEjC,mBAAmB;AACnB,yDAAuC;AAEvC,aAAa;AACb,+CAA6B;AAE7B,oDAAkC;AAGlC,aAAa;AACb,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/dto/index.ts"],"names":[],"mappings":";AAAA,sCAAsC;AACtC,qFAAqF;;;;;;;;;;;;;;;;AAGrF,iBAAiB;AACjB,iEAA+C;AAC/C,sEAAoD;AACpD,kEAAgD;AAChD,yEAAuD;AAEvD,YAAY;AACZ,yCAAuB;AAEvB,gBAAgB;AAChB,6CAA0B;AAE1B,YAAY;AACZ,2CAAyB;AACzB,6CAA2B;AAC3B,qDAAmC;AACnC,yDAAuC;AACvC,iEAA+C;AAC/C,uDAAqC;AAErC,sBAAsB;AACtB,uDAAqC;AACrC,+DAA6C;AAE7C,sDAAoC;AACpC,oDAAkC;AAClC,4CAA0B;AAC1B,+CAA6B;AAE7B,aAAa;AACb,0CAAwB;AAExB,mBAAmB;AACnB,gDAA8B;AAE9B,gBAAgB;AAChB,6CAA2B;AAG3B,kBAAkB;AAClB,+CAA6B;AAE7B,4CAAyB;AAEzB,gBAAgB;AAChB,0DAAwC;AACxC,gEAA8C;AAC9C,wEAAsD;AACtD,wEAAsD;AACtD,uEAAqD;AACrD,iEAA+C;AAC/C,2EAAyD;AACzD,kFAAgE;AAChE,0EAAwD;AACxD,mEAAiD;AACjD,sFAAoE;AACpE,8EAA4D;AAC5D,gEAA8C;AAG9C,uBAAuB;AACvB,oDAAiC;AAEjC,mBAAmB;AACnB,yDAAuC;AAEvC,aAAa;AACb,+CAA6B;AAE7B,oDAAkC;AAGlC,aAAa;AACb,0CAAwB"}

package/dist/cjs/shared-lib/dto/transaction/index.d.ts

@@ -2,7 +2,7 @@ export * from './transaction-bulk-data.request.dto';
 export * from './transaction-trigger-process.dto';
 export * from './transaction.dto';
 export * from './transaction.request.dto';
-export * from './transaction-analytics.request.dto';
+export * from '../analytics/transaction-analytics.request.dto';
 export * from './transaction-pagination.request.dto';
 export * from './transaction-request-actionable.dto';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/transaction/index.ts"],"names":[],"mappings":"AACA,cAAc,qCAAqC,CAAC;AAEpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AAErD,cAAc,sCAAsC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/transaction/index.ts"],"names":[],"mappings":"AACA,cAAc,qCAAqC,CAAC;AAEpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gDAAgD,CAAC;AAC/D,cAAc,sCAAsC,CAAC;AAErD,cAAc,sCAAsC,CAAC"}

package/dist/cjs/shared-lib/dto/transaction/index.js

@@ -19,7 +19,7 @@ __exportStar(require("./transaction-bulk-data.request.dto"), exports);
 __exportStar(require("./transaction-trigger-process.dto"), exports);
 __exportStar(require("./transaction.dto"), exports);
 __exportStar(require("./transaction.request.dto"), exports);
-__exportStar(require("./transaction-analytics.request.dto"), exports);
+__exportStar(require("../analytics/transaction-analytics.request.dto"), exports);
 __exportStar(require("./transaction-pagination.request.dto"), exports);
 __exportStar(require("./transaction-request-actionable.dto"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/shared-lib/dto/transaction/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/transaction/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,sEAAoD;AACpD,6CAA6C;AAC7C,oEAAkD;AAClD,oDAAkC;AAClC,4DAA0C;AAC1C,sEAAoD;AACpD,uEAAqD;AAErD,uEAAqD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/transaction/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,sEAAoD;AACpD,6CAA6C;AAC7C,oEAAkD;AAClD,oDAAkC;AAClC,4DAA0C;AAC1C,iFAA+D;AAC/D,uEAAqD;AAErD,uEAAqD"}

package/dist/cjs/shared-lib/interfaces/transaction-analytics-request.interface.d.ts

@@ -1,7 +1,7 @@
 import { GroupByExpression } from './group-by-expression.interface';
 import { SortOrder } from '../enum/sort-order.enum';
 import { TransactionCompleteFields } from './transaction.interface';
-import { TransactionAnalyticsGroupByType } from '../dto/transaction/transaction-analytics.request.dto';
+import { TransactionAnalyticsGroupByType } from '../dto/analytics/transaction-analytics.request.dto';
 import { AnalyticsMetricType } from '../types/analytics.type';
 export interface TransactionAnalyticsRequest {
     filters?: TransactionAnalyticsFilters;

package/dist/cjs/shared-lib/interfaces/transaction-analytics-request.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction-analytics-request.interface.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/transaction-analytics-request.interface.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,+BAA+B,EAAE,MAAM,sDAAsD,CAAC;AACvG,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,2BAA2B,CAAC;IACtC,OAAO,CAAC,EAAE,+BAA+B,EAAE,CAAC;IAC5C,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACzC,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC,MAAM,CAAC,EAAE,mBAAmB,GAAG,+BAA+B,GAAG,MAAM,CAAC;IACxE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAC5E,WAAW,GACX,WAAW,CACd,CAAC,CAAC"}
+{"version":3,"file":"transaction-analytics-request.interface.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/transaction-analytics-request.interface.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,+BAA+B,EAAE,MAAM,oDAAoD,CAAC;AACrG,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,2BAA2B,CAAC;IACtC,OAAO,CAAC,EAAE,+BAA+B,EAAE,CAAC;IAC5C,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACzC,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC,MAAM,CAAC,EAAE,mBAAmB,GAAG,+BAA+B,GAAG,MAAM,CAAC;IACxE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAC5E,WAAW,GACX,WAAW,CACd,CAAC,CAAC"}

package/dist/esm/index.d.ts

@@ -1,7 +1,7 @@
 export * from './shared-lib/enum';
 export * from './shared-lib/interfaces';
 export * from './shared-lib/types';
-export type * from './shared-lib/dto';
+export * from './shared-lib/dto';
 export * from '@explorins/web3-types';
 export type * from './shared-lib/errors';
 export { type StructuredError, ErrorCategory } from './shared-lib/errors/base/error-classification-enums';

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,mBAAmB,kBAAkB,CAAC;AAGtC,cAAc,uBAAuB,CAAC;AAGtC,mBAAmB,qBAAqB,CAAC;AACzC,OAAO,EAAE,KAAK,eAAe,EAAE,aAAa,EAAE,MAAM,qDAAqD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,uBAAuB,CAAC;AAGtC,mBAAmB,qBAAqB,CAAC;AACzC,OAAO,EAAE,KAAK,eAAe,EAAE,aAAa,EAAE,MAAM,qDAAqD,CAAC"}

package/dist/esm/index.js

@@ -4,6 +4,7 @@
 export * from './shared-lib/enum/index.js';
 export * from './shared-lib/interfaces/index.js';
 export * from './shared-lib/types/index.js';
+export * from './shared-lib/dto/index.js'; // Export runtime classes, not just types
 // Re-export web3 types for convenience
 export * from '@explorins/web3-types';
 export { ErrorCategory } from './shared-lib/errors/base/error-classification-enums.js';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8FAA8F;AAE9F,wBAAwB;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AAGnC,uCAAuC;AACvC,cAAc,uBAAuB,CAAC;AAItC,OAAO,EAAwB,aAAa,EAAE,MAAM,qDAAqD,CAAC;AAE1G,4CAA4C;AAC5C,2CAA2C;AAC3C,iFAAiF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8FAA8F;AAE9F,wBAAwB;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC,CAAC,yCAAyC;AAE3E,uCAAuC;AACvC,cAAc,uBAAuB,CAAC;AAItC,OAAO,EAAwB,aAAa,EAAE,MAAM,qDAAqD,CAAC;AAE1G,4CAA4C;AAC5C,2CAA2C;AAC3C,iFAAiF"}

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

@@ -0,0 +1,38 @@
+/**
+ * BASE ANALYTICS REQUEST
+ *
+ * Common date range filtering for all analytics endpoints.
+ * Extend this for consistent API patterns across analytics.
+ */
+export declare abstract class BaseAnalyticsRequestDTO {
+    startDate?: Date;
+    endDate?: Date;
+}
+/**
+ * BASE ANALYTICS RESPONSE METADATA
+ *
+ * Common metadata structure for all analytics responses.
+ * Shows applied filters for transparency.
+ *
+ * Note: Execution time removed - client can measure total request time using performance.now()
+ * which includes network latency and is more relevant for UX monitoring.
+ */
+export interface BaseAnalyticsMetadata {
+    /**
+     * Applied date range filter (always present - uses current date as fallback if not provided in request)
+     */
+    dateRange: {
+        startDate: Date;
+        endDate: Date;
+    };
+}
+/**
+ * BASE ANALYTICS RESPONSE
+ *
+ * Common response structure for analytics endpoints.
+ * All analytics responses should include metadata with timing and filter info.
+ */
+export declare abstract class BaseAnalyticsResponseDTO {
+    abstract metadata: BaseAnalyticsMetadata;
+}
+//# sourceMappingURL=base-analytics.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-analytics.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/base-analytics.dto.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,8BAAsB,uBAAuB;IAO3C,SAAS,CAAC,EAAE,IAAI,CAAC;IAQjB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,SAAS,EAAE;QACT,SAAS,EAAE,IAAI,CAAC;QAChB,OAAO,EAAE,IAAI,CAAC;KACf,CAAC;CACH;AAED;;;;;GAKG;AACH,8BAAsB,wBAAwB;IAC5C,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;CAC1C"}

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

@@ -0,0 +1,43 @@
+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 { ApiPropertyOptional } from '@nestjs/swagger';
+import { IsOptional, IsDateString } from 'class-validator';
+/**
+ * BASE ANALYTICS REQUEST
+ *
+ * Common date range filtering for all analytics endpoints.
+ * Extend this for consistent API patterns across analytics.
+ */
+export class BaseAnalyticsRequestDTO {
+    startDate;
+    endDate;
+}
+__decorate([
+    ApiPropertyOptional({
+        description: 'Start date for filtering (ISO 8601 format). Filters records with createdAt >= startDate.',
+        example: '2024-01-01T00:00:00.000Z'
+    }),
+    IsOptional(),
+    IsDateString()
+], BaseAnalyticsRequestDTO.prototype, "startDate", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'End date for filtering (ISO 8601 format). Filters records with createdAt <= endDate.',
+        example: '2024-12-31T23:59:59.999Z'
+    }),
+    IsOptional(),
+    IsDateString()
+], BaseAnalyticsRequestDTO.prototype, "endDate", void 0);
+/**
+ * BASE ANALYTICS RESPONSE
+ *
+ * Common response structure for analytics endpoints.
+ * All analytics responses should include metadata with timing and filter info.
+ */
+export class BaseAnalyticsResponseDTO {
+}
+//# sourceMappingURL=base-analytics.dto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-analytics.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/base-analytics.dto.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,OAAgB,uBAAuB;IAO3C,SAAS,CAAQ;IAQjB,OAAO,CAAQ;CAChB;AATC;IANC,mBAAmB,CAAC;QACnB,WAAW,EAAE,0FAA0F;QACvG,OAAO,EAAE,0BAA0B;KACpC,CAAC;IACD,UAAU,EAAE;IACZ,YAAY,EAAE;0DACE;AAQjB;IANC,mBAAmB,CAAC;QACnB,WAAW,EAAE,sFAAsF;QACnG,OAAO,EAAE,0BAA0B;KACpC,CAAC;IACD,UAAU,EAAE;IACZ,YAAY,EAAE;wDACA;AAsBjB;;;;;GAKG;AACH,MAAM,OAAgB,wBAAwB;CAE7C"}

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

@@ -1,8 +1,8 @@
 import { ProcessRecordStatus } from "../../enum";
 import { UserDTO } from "../user.dto";
-import { CampaignDTO } from "./campaign.dto";
+import { CampaignDTO } from "../campaign/campaign.dto";
 import { BusinessDTO } from "../business/business.dto";
-import { TriggerSourceDTO } from "./trigger-source.dto";
+import { TriggerSourceDTO } from "../campaign/trigger-source.dto";
 /**
  * Campaign Claim Analytics DTO
  *

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

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-claim-analytics.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/campaign-claim-analytics.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAAyB;IAKpC,EAAE,EAAE,MAAM,CAAM;IAMhB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAQ;IAQ9B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAQ7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IAQjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IAQjC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;IAOtC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAQ;IAO5B,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAQ;IAOpC,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAO9B,aAAa,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAOxC,MAAM,EAAE,mBAAmB,CAA+B;IAQ1D,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;IAQtC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAQ/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAOhC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB"}

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

@@ -7,9 +7,9 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
 import { ProcessRecordStatus } from "../../enum/index.js";
 import { UserDTO } from "../user.dto.js";
-import { CampaignDTO } from "./campaign.dto.js";
+import { CampaignDTO } from "../campaign/campaign.dto.js";
 import { BusinessDTO } from "../business/business.dto.js";
-import { TriggerSourceDTO } from "./trigger-source.dto.js";
+import { TriggerSourceDTO } from "../campaign/trigger-source.dto.js";
 /**
  * Campaign Claim Analytics DTO
  *

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

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