@explorins/pers-shared 2.1.175 → 2.1.178

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

@@ -40,11 +40,17 @@ export declare class UserAnalyticsResponseDTO {
     averageClaimsPerUser: number;
     totalRedemptions: number;
     averageRedemptionsPerUser: number;
+    totalMints: number;
+    averageMintsPerUser: number;
+    totalTransfers: number;
+    averageTransfersPerUser: number;
     totalBurns: number;
     averageBurnsPerUser: number;
     averageTransactionsPerActiveUser: number;
     averageClaimsPerActiveUser: number;
     averageRedemptionsPerActiveUser: number;
+    averageMintsPerActiveUser: number;
+    averageTransfersPerActiveUser: number;
     averageBurnsPerActiveUser: number;
     engagementRate: number;
     periodBreakdown?: {

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,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE;;;;;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"}
+{"version":3,"file":"user-analytics.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/user-analytics.dto.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE;;;;;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,cAAc,EAAE,MAAM,CAAK;IAM3B,uBAAuB,EAAE,MAAM,CAAK;IAMpC,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;IAMtC,6BAA6B,EAAE,MAAM,CAAK;IAM1C,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

@@ -98,11 +98,17 @@ class UserAnalyticsResponseDTO {
     averageClaimsPerUser = 0;
     totalRedemptions = 0;
     averageRedemptionsPerUser = 0;
+    totalMints = 0;
+    averageMintsPerUser = 0;
+    totalTransfers = 0;
+    averageTransfersPerUser = 0;
     totalBurns = 0;
     averageBurnsPerUser = 0;
     averageTransactionsPerActiveUser = 0;
     averageClaimsPerActiveUser = 0;
     averageRedemptionsPerActiveUser = 0;
+    averageMintsPerActiveUser = 0;
+    averageTransfersPerActiveUser = 0;
     averageBurnsPerActiveUser = 0;
     engagementRate = 0;
     periodBreakdown;
@@ -181,6 +187,34 @@ __decorate([
     }),
     __metadata("design:type", Number)
 ], UserAnalyticsResponseDTO.prototype, "averageRedemptionsPerUser", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Total mint transactions in the date range. Only counts successful mint transactions (status=SUCCEEDED or BROADCASTED, type=MINT).',
+        example: 1250
+    }),
+    __metadata("design:type", Number)
+], UserAnalyticsResponseDTO.prototype, "totalMints", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Average mints per user across entire user base (total mints in date range ÷ total users).',
+        example: 1.2
+    }),
+    __metadata("design:type", Number)
+], UserAnalyticsResponseDTO.prototype, "averageMintsPerUser", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Total transfer transactions in the date range. Only counts successful transfer transactions (status=SUCCEEDED or BROADCASTED, type=TRANSFER).',
+        example: 890
+    }),
+    __metadata("design:type", Number)
+], UserAnalyticsResponseDTO.prototype, "totalTransfers", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Average transfers per user across entire user base (total transfers in date range ÷ total users).',
+        example: 0.8
+    }),
+    __metadata("design:type", Number)
+], UserAnalyticsResponseDTO.prototype, "averageTransfersPerUser", 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).',
@@ -216,6 +250,20 @@ __decorate([
     }),
     __metadata("design:type", Number)
 ], UserAnalyticsResponseDTO.prototype, "averageRedemptionsPerActiveUser", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Average mints per active user (total mints in date range ÷ active users in date range).',
+        example: 1.5
+    }),
+    __metadata("design:type", Number)
+], UserAnalyticsResponseDTO.prototype, "averageMintsPerActiveUser", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Average transfers per active user (total transfers in date range ÷ active users in date range).',
+        example: 1.1
+    }),
+    __metadata("design:type", Number)
+], UserAnalyticsResponseDTO.prototype, "averageTransfersPerActiveUser", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'Average burns per active user (total burns in date range ÷ active users in 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/cjs/shared-lib/errors/domains/business-errors.d.ts

@@ -54,4 +54,16 @@ export declare class UserStatusRestrictedError extends DomainRuleError {
 export declare class RedemptionAlreadyProcessingError extends DomainRuleError {
     constructor(redeemId: string, status: string);
 }
+/**
+ * Error when user is missing required fields for a redemption
+ */
+export declare class RequiredFieldsMissingError extends DomainRuleError {
+    constructor(missingFields: string[]);
+}
+/**
+ * Error when user does not have a valid booking for a redemption
+ */
+export declare class BookingRequirementNotMetError extends DomainRuleError {
+    constructor(requirementType: string);
+}
 //# sourceMappingURL=business-errors.d.ts.map

package/dist/cjs/shared-lib/errors/domains/business-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"business-errors.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/errors/domains/business-errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzF;;GAEG;AAEH,qBAAa,qBAAsB,SAAQ,eAAe;gBAC5C,UAAU,EAAE,MAAM;CAQ/B;AAED;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,aAAa;gBAEvD,YAAY,EAAE,UAAU,GAAG,YAAY,GAAG,gBAAgB,EAC1D,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EACtC,uBAAuB,EAAE,MAAM,EAC/B,gBAAgB,EAAE,MAAM;CAoB3B;AAID,qBAAa,sBAAuB,SAAQ,eAAe;gBAC7C,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAQhD;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,eAAe;gBAC9C,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAE,MAAiB;CAQ5E;AAED,qBAAa,4BAA6B,SAAQ,eAAe;gBACnD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAE,MAAiB;CAQ5E;AAED,qBAAa,wBAAyB,SAAQ,eAAe;gBAC/C,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAE,MAAiB;CAS5D;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,eAAe;gBAC5C,UAAU,EAAE,MAAM;CAQ/B;AAED,qBAAa,0BAA2B,SAAQ,eAAe;gBACjD,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAmB;CAQ/D;AAED,qBAAa,iCAAkC,SAAQ,eAAe;gBACxD,QAAQ,GAAE,MAAmB;CAQ1C;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,eAAe;gBAClD,SAAS,EAAE,gBAAgB,GAAG,YAAY;CAWvD;AAED,qBAAa,yBAA0B,SAAQ,eAAe;;CAS7D;AAED;;GAEG;AACH,qBAAa,gCAAiC,SAAQ,eAAe;gBACvD,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ7C"}
+{"version":3,"file":"business-errors.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/errors/domains/business-errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzF;;GAEG;AAEH,qBAAa,qBAAsB,SAAQ,eAAe;gBAC5C,UAAU,EAAE,MAAM;CAQ/B;AAED;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,aAAa;gBAEvD,YAAY,EAAE,UAAU,GAAG,YAAY,GAAG,gBAAgB,EAC1D,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EACtC,uBAAuB,EAAE,MAAM,EAC/B,gBAAgB,EAAE,MAAM;CAoB3B;AAID,qBAAa,sBAAuB,SAAQ,eAAe;gBAC7C,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAQhD;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,eAAe;gBAC9C,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAE,MAAiB;CAQ5E;AAED,qBAAa,4BAA6B,SAAQ,eAAe;gBACnD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAE,MAAiB;CAQ5E;AAED,qBAAa,wBAAyB,SAAQ,eAAe;gBAC/C,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAE,MAAiB;CAS5D;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,eAAe;gBAC5C,UAAU,EAAE,MAAM;CAQ/B;AAED,qBAAa,0BAA2B,SAAQ,eAAe;gBACjD,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAmB;CAQ/D;AAED,qBAAa,iCAAkC,SAAQ,eAAe;gBACxD,QAAQ,GAAE,MAAmB;CAQ1C;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,eAAe;gBAClD,SAAS,EAAE,gBAAgB,GAAG,YAAY;CAWvD;AAED,qBAAa,yBAA0B,SAAQ,eAAe;;CAS7D;AAED;;GAEG;AACH,qBAAa,gCAAiC,SAAQ,eAAe;gBACvD,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ7C;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,eAAe;gBACjD,aAAa,EAAE,MAAM,EAAE;CAUpC;AAED;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,eAAe;gBACpD,eAAe,EAAE,MAAM;CAUpC"}

package/dist/cjs/shared-lib/errors/domains/business-errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RedemptionAlreadyProcessingError = exports.UserStatusRestrictedError = exports.RedemptionLimitReachedError = exports.LocationVerificationRequiredError = exports.GeographicRestrictionError = exports.CampaignNotFoundError = exports.MembershipLastOwnerError = exports.MembershipAlreadyExistsError = exports.MembershipNotFoundError = exports.BusinessNotMinterError = exports.CrossBusinessAccessError = exports.BusinessNotFoundError = void 0;
+exports.BookingRequirementNotMetError = exports.RequiredFieldsMissingError = exports.RedemptionAlreadyProcessingError = exports.UserStatusRestrictedError = exports.RedemptionLimitReachedError = exports.LocationVerificationRequiredError = exports.GeographicRestrictionError = exports.CampaignNotFoundError = exports.MembershipLastOwnerError = exports.MembershipAlreadyExistsError = exports.MembershipNotFoundError = exports.BusinessNotMinterError = exports.CrossBusinessAccessError = exports.BusinessNotFoundError = void 0;
 const common_1 = require("@nestjs/common");
 const base_business_error_1 = require("../base-business-error");
 const error_codes_1 = require("../error-codes");
@@ -107,4 +107,26 @@ class RedemptionAlreadyProcessingError extends base_business_error_1.DomainRuleE
     }
 }
 exports.RedemptionAlreadyProcessingError = RedemptionAlreadyProcessingError;
+/**
+ * Error when user is missing required fields for a redemption
+ */
+class RequiredFieldsMissingError extends base_business_error_1.DomainRuleError {
+    constructor(missingFields) {
+        super(error_codes_1.CommonErrorCodes.REQUIRED_FIELDS_MISSING, error_codes_1.ErrorDomains.REDEMPTION, `Required fields missing: ${missingFields.join(', ')}`, common_1.HttpStatus.UNPROCESSABLE_ENTITY);
+        const response = this.getResponse();
+        response.details = { missingFields };
+    }
+}
+exports.RequiredFieldsMissingError = RequiredFieldsMissingError;
+/**
+ * Error when user does not have a valid booking for a redemption
+ */
+class BookingRequirementNotMetError extends base_business_error_1.DomainRuleError {
+    constructor(requirementType) {
+        super(error_codes_1.CommonErrorCodes.BOOKING_REQUIREMENT_NOT_MET, error_codes_1.ErrorDomains.REDEMPTION, `Booking requirement not met. Required booking status: ${requirementType}`, common_1.HttpStatus.FORBIDDEN);
+        const response = this.getResponse();
+        response.details = { requirementType };
+    }
+}
+exports.BookingRequirementNotMetError = BookingRequirementNotMetError;
 //# sourceMappingURL=business-errors.js.map

package/dist/cjs/shared-lib/errors/domains/business-errors.js.map

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

package/dist/cjs/shared-lib/errors/error-codes.d.ts

@@ -71,6 +71,8 @@ export declare const CommonErrorCodes: {
     readonly REDEMPTION_ALREADY_PROCESSING: "REDEMPTION_ALREADY_PROCESSING";
     readonly MAX_REDEMPTION: "MAX_REDEMPTION";
     readonly USER_LIMIT: "USER_LIMIT";
+    readonly REQUIRED_FIELDS_MISSING: "REQUIRED_FIELDS_MISSING";
+    readonly BOOKING_REQUIREMENT_NOT_MET: "BOOKING_REQUIREMENT_NOT_MET";
     readonly INVALID_TOKEN: "INVALID_TOKEN";
     readonly TOKEN_EXPIRED: "TOKEN_EXPIRED";
     readonly TOKEN_REVOKED: "TOKEN_REVOKED";

package/dist/cjs/shared-lib/errors/error-codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/errors/error-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkInB,CAAC;AAEX;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,gBAAgB,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAGrF,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/errors/error-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoInB,CAAC;AAEX;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,gBAAgB,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAGrF,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/cjs/shared-lib/errors/error-codes.js

@@ -89,6 +89,8 @@ exports.CommonErrorCodes = {
     REDEMPTION_ALREADY_PROCESSING: 'REDEMPTION_ALREADY_PROCESSING',
     MAX_REDEMPTION: 'MAX_REDEMPTION',
     USER_LIMIT: 'USER_LIMIT',
+    REQUIRED_FIELDS_MISSING: 'REQUIRED_FIELDS_MISSING',
+    BOOKING_REQUIREMENT_NOT_MET: 'BOOKING_REQUIREMENT_NOT_MET',
     // Authentication errors
     INVALID_TOKEN: 'INVALID_TOKEN',
     TOKEN_EXPIRED: 'TOKEN_EXPIRED',

package/dist/cjs/shared-lib/errors/error-codes.js.map

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

package/dist/cjs/shared-lib/types/data-source.type.d.ts

@@ -44,7 +44,7 @@
 /**
  * Primary ingestion channels for data source tracking.
  */
-export declare const DATA_SOURCE_CHANNELS: readonly ["web", "mobile", "api", "admin", "system", "import", "webhook", "sync", "migration"];
+export declare const DATA_SOURCE_CHANNELS: readonly ["web", "mobile", "api", "admin", "system", "import", "webhook", "sync", "migration", "unknown"];
 export type DataSourceChannel = typeof DATA_SOURCE_CHANNELS[number];
 /**
  * Unified data source tracking interface.
@@ -78,13 +78,225 @@ export interface DataSource {
      * Full URL of the referring page.
      */
     referrer?: string;
+    /**
+     * Platform/device information.
+     * SDK provides this - backend stores as-is.
+     */
+    platform?: Platform;
+}
+/**
+ * Platform/device information for analytics.
+ * SDK is responsible for populating this accurately.
+ * Sent via x-platform header as JSON string.
+ */
+export interface Platform {
+    /** Operating system: 'iOS', 'Android', 'Windows', 'macOS', 'Linux' */
+    os?: string;
+    /** OS version: '17.4', '14.0', '11' */
+    osVersion?: string;
+    /** Browser name (web only): 'Safari', 'Chrome', 'Firefox' */
+    browser?: string;
+    /** Browser version (web only): '125.0' */
+    browserVersion?: string;
+    /** App name (native only): 'MyApp' */
+    app?: string;
+    /** App version (native only): '2.3.1' */
+    appVersion?: string;
+    /** Device type: 'phone', 'tablet', 'desktop', 'kiosk' */
+    deviceType?: 'phone' | 'tablet' | 'desktop' | 'kiosk' | 'other';
 }
 /**
  * Type guard to check if a value is a valid DataSourceChannel.
  */
 export declare function isDataSourceChannel(value: unknown): value is DataSourceChannel;
 /**
- * Default data source for manual/admin operations.
+ * Default data source when source cannot be determined.
+ * Used as fallback when CLS context is unavailable.
+ *
+ * NOTE: 'unknown' indicates a gap in tracking - should be rare.
+ * If you see many 'unknown' sources, check that DataSourceInterceptor is active.
  */
 export declare const DEFAULT_DATA_SOURCE: DataSource;
+/**
+ * Known domain mappings for auto-detecting source from referrer.
+ * Maps hostnames to normalized source names.
+ */
+export declare const KNOWN_SOURCE_DOMAINS: Record<string, string>;
+/**
+ * Auto-detect source from referrer URL domain.
+ * Maps common domains to friendly source names.
+ *
+ * @param referrer - Full referrer URL
+ * @returns Normalized source name or undefined
+ *
+ * @example
+ * detectSourceFromReferrer('https://www.google.com/search?q=test') // 'google'
+ * detectSourceFromReferrer('https://l.facebook.com/...') // 'facebook'
+ * detectSourceFromReferrer('https://partner.example.com') // 'example'
+ */
+export declare function detectSourceFromReferrer(referrer?: string): string | undefined;
+/**
+ * Auto-detect channel from User-Agent string.
+ *
+ * @param userAgent - User-Agent header value
+ * @param path - Optional request path for webhook detection
+ * @returns Detected channel
+ *
+ * @example
+ * detectChannelFromUserAgent('Mozilla/5.0 (iPhone; ...)') // 'mobile'
+ * detectChannelFromUserAgent('Mozilla/5.0 (Windows NT...)') // 'web'
+ * detectChannelFromUserAgent('', '/webhook/stripe') // 'webhook'
+ */
+export declare function detectChannelFromUserAgent(userAgent?: string, path?: string): DataSourceChannel;
+/**
+ * UTM parameters extracted from URLs.
+ * Standard marketing attribution fields from Google Analytics UTM format.
+ */
+export interface UtmParams {
+    /** Traffic source (utm_source) - e.g., 'google', 'newsletter', 'partner_app' */
+    source?: string;
+    /** Marketing medium (utm_medium) - e.g., 'email', 'cpc', 'referral' */
+    medium?: string;
+    /** Campaign name (utm_campaign) - e.g., 'summer_promo_2026' */
+    campaign?: string;
+    /** Campaign term (utm_term) - e.g., 'running+shoes' (for paid search) */
+    term?: string;
+    /** Campaign content (utm_content) - e.g., 'logolink', 'textlink' */
+    content?: string;
+}
+/**
+ * Parse UTM parameters from a URL (deep link, referrer, etc.).
+ * Supports standard Google Analytics UTM parameters.
+ *
+ * @param url - Full URL containing UTM query parameters
+ * @returns Parsed UTM parameters object
+ *
+ * @example
+ * // Deep link from email campaign
+ * parseUtmParams('myapp://screen?utm_source=mailchimp&utm_medium=email&utm_campaign=summer_2026')
+ * // Returns: { source: 'mailchimp', medium: 'email', campaign: 'summer_2026' }
+ *
+ * @example
+ * // Web URL with full UTM tracking
+ * parseUtmParams('https://app.example.com?utm_source=google&utm_medium=cpc&utm_campaign=brand&utm_term=loyalty+app')
+ * // Returns: { source: 'google', medium: 'cpc', campaign: 'brand', term: 'loyalty+app' }
+ */
+export declare function parseUtmParams(url: string): UtmParams;
+/**
+ * SDK Data Source configuration for WEB applications.
+ *
+ * Web SDK should NOT send `channel` - backend auto-detects from User-Agent.
+ * Web SDK should NOT send `referrer` - browser sends HTTP Referer header automatically.
+ * Web SDK should NOT send `source` unless overriding auto-detection from referrer.
+ *
+ * @example
+ * // Minimal - backend handles everything
+ * sdk.configure({ dataSource: {} });
+ *
+ * // With campaign tracking (from URL params)
+ * const utm = parseUtmParams(window.location.href);
+ * sdk.configure({
+ *   dataSource: {
+ *     medium: utm.medium,
+ *     campaign: utm.campaign,
+ *     source: utm.source, // Optional: overrides referrer-based detection
+ *   }
+ * });
+ */
+export interface WebDataSourceConfig {
+    /**
+     * Marketing medium for attribution.
+     * Examples: 'email', 'cpc', 'referral', 'organic', 'paid', 'social', 'affiliate'
+     *
+     * Tip: Parse from utm_medium in URL.
+     */
+    medium?: string;
+    /**
+     * Campaign identifier for tracking.
+     * Examples: 'summer_promo_2026', 'welcome_series', 'partner_launch'
+     *
+     * Tip: Parse from utm_campaign in URL.
+     */
+    campaign?: string;
+    /**
+     * Traffic source override.
+     * Only set if you need to override auto-detection from referrer.
+     * Examples: 'mailchimp', 'partner_xyz', 'qr_code'
+     *
+     * Backend auto-detects from: HTTP Referer header → domain extraction
+     */
+    source?: string;
+    /**
+     * Referrer URL override.
+     * Only set in edge cases where browser doesn't send Referer header:
+     * - In-app webviews
+     * - Privacy browsers stripping referrer
+     * - Cross-origin iframe scenarios
+     */
+    referrer?: string;
+}
+/**
+ * SDK Data Source configuration for NATIVE mobile applications.
+ *
+ * Native apps MUST send `channel` since there's no User-Agent auto-detection.
+ * Native apps SHOULD send `source` when available (no referrer header exists).
+ *
+ * @example
+ * // Basic native app setup
+ * sdk.configure({
+ *   dataSource: {
+ *     channel: 'mobile',
+ *   }
+ * });
+ *
+ * // Deep link with UTM tracking
+ * const deepLinkUrl = 'myapp://screen?utm_source=email&utm_medium=push&utm_campaign=retention';
+ * const utm = parseUtmParams(deepLinkUrl);
+ * sdk.configure({
+ *   dataSource: {
+ *     channel: 'mobile',
+ *     source: utm.source,   // 'email'
+ *     medium: utm.medium,   // 'push'
+ *     campaign: utm.campaign, // 'retention'
+ *   }
+ * });
+ *
+ * // QR code scan
+ * sdk.configure({
+ *   dataSource: {
+ *     channel: 'mobile',
+ *     source: 'qr_code',
+ *     medium: 'referral',
+ *     campaign: 'lobby_checkin',
+ *   }
+ * });
+ */
+export interface NativeDataSourceConfig {
+    /**
+     * Primary ingestion channel - REQUIRED for native apps.
+     * Backend cannot auto-detect without browser User-Agent.
+     */
+    channel: 'mobile' | 'kiosk' | 'pos';
+    /**
+     * Marketing medium for attribution.
+     * Examples: 'push', 'deeplink', 'email', 'referral', 'organic'
+     */
+    medium?: string;
+    /**
+     * Campaign identifier for tracking.
+     * Examples: 'summer_promo_2026', 'onboarding_v3', 'retention_30d'
+     */
+    campaign?: string;
+    /**
+     * Traffic source - STRONGLY RECOMMENDED for native apps.
+     * No referrer header exists, so backend cannot auto-detect.
+     * Examples: 'push_notification', 'deep_link', 'qr_code', 'partner_app'
+     */
+    source?: string;
+}
+/**
+ * Combined SDK Data Source configuration.
+ * Use WebDataSourceConfig for web apps, NativeDataSourceConfig for native.
+ */
+export type SdkDataSourceConfig = WebDataSourceConfig | NativeDataSourceConfig;
 //# sourceMappingURL=data-source.type.d.ts.map

package/dist/cjs/shared-lib/types/data-source.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-source.type.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/types/data-source.type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB,gGAUvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,OAAO,EAAE,iBAAiB,CAAC;IAE3B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,UAEjC,CAAC"}
+{"version":3,"file":"data-source.type.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/types/data-source.type.ts"],"names":[],"mappings":"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"}