@explorins/pers-shared 2.1.96 → 2.1.97

package/dist/cjs/shared-lib/enum/ai-trigger-process-type.enum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiTriggerProcessType = void 0;
+/**
+ * AI Trigger Process Types
+ *
+ * Identifies which business process triggered an AI generation.
+ * Used for cost allocation and analytics grouping.
+ *
+ * NOTE: This enum will grow as AI is integrated into more processes.
+ */
+var AiTriggerProcessType;
+(function (AiTriggerProcessType) {
+    /** AI triggered during transaction processing (e.g., dynamic token image/description) */
+    AiTriggerProcessType["TRANSACTION"] = "TRANSACTION";
+})(AiTriggerProcessType || (exports.AiTriggerProcessType = AiTriggerProcessType = {}));
+//# sourceMappingURL=ai-trigger-process-type.enum.js.map

package/dist/cjs/shared-lib/enum/ai-trigger-process-type.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-trigger-process-type.enum.js","sourceRoot":"","sources":["../../../../src/shared-lib/enum/ai-trigger-process-type.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,IAAY,oBAGX;AAHD,WAAY,oBAAoB;IAC9B,yFAAyF;IACzF,mDAA2B,CAAA;AAC7B,CAAC,EAHW,oBAAoB,oCAApB,oBAAoB,QAG/B"}

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

@@ -21,5 +21,8 @@ export * from './signed-url-type.enum';
 export * from './token-validity-type.enum';
 export * from './purchase';
 export * from './campaign';
+export * from './ai-operation-type.enum';
+export * from './ai-trigger-process-type.enum';
+export * from './ai-analytics-metric.enum';
 export { ErrorCategory } from '../errors/base/error-classification-enums';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/enum/index.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC;AACxD,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,YAAY,CAAC;AAE3B,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/enum/index.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC;AACxD,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,YAAY,CAAC;AAE3B,cAAc,YAAY,CAAC;AAE3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAG3C,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC"}

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

@@ -39,6 +39,9 @@ __exportStar(require("./signed-url-type.enum"), exports);
 __exportStar(require("./token-validity-type.enum"), exports);
 __exportStar(require("./purchase"), exports);
 __exportStar(require("./campaign"), exports);
+__exportStar(require("./ai-operation-type.enum"), exports);
+__exportStar(require("./ai-trigger-process-type.enum"), exports);
+__exportStar(require("./ai-analytics-metric.enum"), exports);
 // Error classification enum
 var error_classification_enums_1 = require("../errors/base/error-classification-enums");
 Object.defineProperty(exports, "ErrorCategory", { enumerable: true, get: function () { return error_classification_enums_1.ErrorCategory; } });

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/enum/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,wCAAwC;AACxC,0DAAwC;AACxC,0DAAwC;AACxC,4DAA0C;AAC1C,0EAAwD;AACxD,sDAAoC;AACpC,oDAAkC;AAClC,yDAAuC;AACvC,4DAA0C;AAC1C,oDAAkC;AAClC,qDAAmC;AACnC,yDAAuC;AACvC,iEAA+C;AAC/C,kEAAgD;AAChD,gEAA8C;AAC9C,gDAA8B;AAC9B,gDAA8B;AAC9B,oDAAkC;AAClC,+DAA6C;AAC7C,iEAA+C;AAC/C,yDAAuC;AACvC,6DAA2C;AAE3C,6CAA2B;AAE3B,6CAA2B;AAE3B,4BAA4B;AAC5B,wFAA0E;AAAjE,2HAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/enum/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,wCAAwC;AACxC,0DAAwC;AACxC,0DAAwC;AACxC,4DAA0C;AAC1C,0EAAwD;AACxD,sDAAoC;AACpC,oDAAkC;AAClC,yDAAuC;AACvC,4DAA0C;AAC1C,oDAAkC;AAClC,qDAAmC;AACnC,yDAAuC;AACvC,iEAA+C;AAC/C,kEAAgD;AAChD,gEAA8C;AAC9C,gDAA8B;AAC9B,gDAA8B;AAC9B,oDAAkC;AAClC,+DAA6C;AAC7C,iEAA+C;AAC/C,yDAAuC;AACvC,6DAA2C;AAE3C,6CAA2B;AAE3B,6CAA2B;AAE3B,2DAAyC;AACzC,iEAA+C;AAC/C,6DAA2C;AAE3C,4BAA4B;AAC5B,wFAA0E;AAAjE,2HAAA,aAAa,OAAA"}

package/dist/cjs/shared-lib/interfaces/ai-prompt-config.interface.d.ts

@@ -0,0 +1,19 @@
+import { AiOperationType } from '../enum/ai-operation-type.enum';
+/**
+ * Supported operation types for batch AI prompt processing.
+ */
+export type AiPromptConfigType = AiOperationType.TEXT_GENERATION | AiOperationType.IMAGE_GENERATION;
+/**
+ * Configuration for a single AI prompt operation.
+ * Plain interface for use in domain models.
+ */
+export interface AiPromptConfig {
+    type: AiPromptConfigType;
+    key: string;
+    prompt: string;
+}
+/**
+ * Result type from batch AI prompt processing.
+ */
+export type AiPromptResults = Record<string, string>;
+//# sourceMappingURL=ai-prompt-config.interface.d.ts.map

package/dist/cjs/shared-lib/interfaces/ai-prompt-config.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-prompt-config.interface.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/ai-prompt-config.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,eAAe,CAAC,eAAe,GAC/B,eAAe,CAAC,gBAAgB,CAAC;AAErC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/dist/cjs/shared-lib/interfaces/ai-prompt-config.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ai-prompt-config.interface.js.map

package/dist/cjs/shared-lib/interfaces/ai-prompt-config.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-prompt-config.interface.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/ai-prompt-config.interface.ts"],"names":[],"mappings":""}

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

@@ -17,4 +17,5 @@ export * from './location-coordinates.interface';
 export * from './transaction.interface';
 export * from './counterfactual-wallet-response.interface';
 export * from './campaign';
+export * from './ai-prompt-config.interface';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,kCAAkC,CAAC;AAEjD,cAAc,yBAAyB,CAAC;AAExC,cAAc,4CAA4C,CAAC;AAE3D,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,kCAAkC,CAAC;AAEjD,cAAc,yBAAyB,CAAC;AAExC,cAAc,4CAA4C,CAAC;AAE3D,cAAc,YAAY,CAAC;AAE3B,cAAc,8BAA8B,CAAC"}

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

@@ -34,4 +34,5 @@ __exportStar(require("./location-coordinates.interface"), exports);
 __exportStar(require("./transaction.interface"), exports);
 __exportStar(require("./counterfactual-wallet-response.interface"), exports);
 __exportStar(require("./campaign"), exports);
+__exportStar(require("./ai-prompt-config.interface"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAkD;AAClD,mEAAiD;AACjD,uEAAqD;AACrD,iEAA+C;AAC/C,iEAA+C;AAC/C,0DAAwC;AACxC,+DAA6C;AAC7C,2EAAyD;AACzD,iEAA+C;AAC/C,qDAAmC;AACnC,gEAA8C;AAC9C,kEAAgD;AAChD,sEAAoD;AACpD,8DAA4C;AAC5C,kEAAgD;AAChD,4EAA0D;AAC1D,mEAAiD;AAEjD,0DAAwC;AAExC,6EAA2D;AAE3D,6CAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAkD;AAClD,mEAAiD;AACjD,uEAAqD;AACrD,iEAA+C;AAC/C,iEAA+C;AAC/C,0DAAwC;AACxC,+DAA6C;AAC7C,2EAAyD;AACzD,iEAA+C;AAC/C,qDAAmC;AACnC,gEAA8C;AAC9C,kEAAgD;AAChD,sEAAoD;AACpD,8DAA4C;AAC5C,kEAAgD;AAChD,4EAA0D;AAC1D,mEAAiD;AAEjD,0DAAwC;AAExC,6EAA2D;AAE3D,6CAA2B;AAE3B,+DAA6C"}

package/dist/esm/shared-lib/dto/ai/ai-generation-log.dto.d.ts

@@ -0,0 +1,35 @@
+import { AiOperationType } from '../../enum/ai-operation-type.enum';
+import { AiTriggerProcessType } from '../../enum/ai-trigger-process-type.enum';
+/**
+ * AI Generation Log DTO
+ *
+ * Represents an AI generation operation record.
+ * Used for:
+ * - API responses from AI module
+ * - Cross-domain analytics queries
+ * - Billing and usage tracking
+ *
+ * DDD: Shared Kernel - used by AI module and Analytics module
+ */
+export declare class AiGenerationLogDTO {
+    id: string;
+    tenantId: string;
+    userId?: string;
+    operationType: AiOperationType;
+    triggerProcessType?: AiTriggerProcessType | null;
+    triggerProcessId?: string | null;
+    model: string;
+    promptHash?: string | null;
+    promptPreview?: string | null;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    estimatedCostUsd: number;
+    responseTimeMs: number;
+    success: boolean;
+    message?: string | null;
+    metadata?: Record<string, unknown> | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=ai-generation-log.dto.d.ts.map

package/dist/esm/shared-lib/dto/ai/ai-generation-log.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-generation-log.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/ai/ai-generation-log.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAE/E;;;;;;;;;;GAUG;AACH,qBAAa,kBAAkB;IAK7B,EAAE,EAAG,MAAM,CAAC;IAMZ,QAAQ,EAAG,MAAM,CAAC;IAMlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAOhB,aAAa,EAAG,eAAe,CAAC;IAOhC,kBAAkB,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAMjD,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAMjC,KAAK,EAAG,MAAM,CAAC;IAMf,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAM3B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAM9B,WAAW,EAAG,MAAM,CAAC;IAMrB,YAAY,EAAG,MAAM,CAAC;IAMtB,WAAW,EAAG,MAAM,CAAC;IAMrB,gBAAgB,EAAG,MAAM,CAAC;IAM1B,cAAc,EAAG,MAAM,CAAC;IAMxB,OAAO,EAAG,OAAO,CAAC;IAMlB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAMxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAM1C,SAAS,EAAG,IAAI,CAAC;IAMjB,SAAS,EAAG,IAAI,CAAC;CAClB"}

package/dist/esm/shared-lib/dto/ai/ai-generation-log.dto.js

@@ -0,0 +1,158 @@
+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 { AiOperationType } from '../../enum/ai-operation-type.enum.js';
+import { AiTriggerProcessType } from '../../enum/ai-trigger-process-type.enum.js';
+/**
+ * AI Generation Log DTO
+ *
+ * Represents an AI generation operation record.
+ * Used for:
+ * - API responses from AI module
+ * - Cross-domain analytics queries
+ * - Billing and usage tracking
+ *
+ * DDD: Shared Kernel - used by AI module and Analytics module
+ */
+export class AiGenerationLogDTO {
+    id;
+    tenantId;
+    userId;
+    operationType;
+    triggerProcessType;
+    triggerProcessId;
+    model;
+    promptHash;
+    promptPreview;
+    inputTokens;
+    outputTokens;
+    totalTokens;
+    estimatedCostUsd;
+    responseTimeMs;
+    success;
+    message;
+    metadata;
+    createdAt;
+    updatedAt;
+}
+__decorate([
+    ApiProperty({
+        description: 'Unique identifier',
+        example: '123e4567-e89b-12d3-a456-426614174000'
+    })
+], AiGenerationLogDTO.prototype, "id", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Tenant identifier (auto-populated via RLS)',
+        example: 'tenant-123'
+    })
+], AiGenerationLogDTO.prototype, "tenantId", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'User who triggered the generation (null for system operations)',
+        example: '123e4567-e89b-12d3-a456-426614174000'
+    })
+], AiGenerationLogDTO.prototype, "userId", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Type of AI operation performed',
+        enum: AiOperationType,
+        example: AiOperationType.TEXT_GENERATION
+    })
+], AiGenerationLogDTO.prototype, "operationType", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'Business process that triggered this AI generation (for cost allocation)',
+        enum: AiTriggerProcessType,
+        example: AiTriggerProcessType.TRANSACTION
+    })
+], AiGenerationLogDTO.prototype, "triggerProcessType", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'ID of the entity that triggered this generation (e.g., Transaction ID)',
+        example: '123e4567-e89b-12d3-a456-426614174000'
+    })
+], AiGenerationLogDTO.prototype, "triggerProcessId", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Model used for generation',
+        example: 'gemini-2.5-flash'
+    })
+], AiGenerationLogDTO.prototype, "model", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'SHA256 hash of prompt for deduplication (privacy-aware)',
+        example: 'a1b2c3d4e5f6...'
+    })
+], AiGenerationLogDTO.prototype, "promptHash", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'First N characters of prompt for debugging',
+        example: 'Generate a description for...'
+    })
+], AiGenerationLogDTO.prototype, "promptPreview", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Number of input tokens',
+        example: 150
+    })
+], AiGenerationLogDTO.prototype, "inputTokens", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Number of output tokens',
+        example: 500
+    })
+], AiGenerationLogDTO.prototype, "outputTokens", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Total tokens (input + output)',
+        example: 650
+    })
+], AiGenerationLogDTO.prototype, "totalTokens", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Estimated cost in USD',
+        example: 0.0013
+    })
+], AiGenerationLogDTO.prototype, "estimatedCostUsd", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Response time in milliseconds',
+        example: 1250
+    })
+], AiGenerationLogDTO.prototype, "responseTimeMs", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Whether the operation succeeded',
+        example: true
+    })
+], AiGenerationLogDTO.prototype, "success", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'Message (error details if failed, or context info)',
+        example: null
+    })
+], AiGenerationLogDTO.prototype, "message", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'Additional metadata (generation options, temperature, etc.)',
+        example: { temperature: 0.7, thinkingLevel: 'medium' }
+    })
+], AiGenerationLogDTO.prototype, "metadata", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Creation timestamp',
+        example: '2026-03-12T10:30:00Z'
+    })
+], AiGenerationLogDTO.prototype, "createdAt", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Last update timestamp',
+        example: '2026-03-12T10:30:00Z'
+    })
+], AiGenerationLogDTO.prototype, "updatedAt", void 0);
+//# sourceMappingURL=ai-generation-log.dto.js.map

package/dist/esm/shared-lib/dto/ai/ai-generation-log.dto.js.map

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

package/dist/esm/shared-lib/dto/ai/ai-prompt-config.dto.d.ts

@@ -0,0 +1,21 @@
+import type { AiPromptConfig, AiPromptConfigType } from '../../interfaces/ai-prompt-config.interface';
+export type { AiPromptConfigType, AiPromptResults } from '../../interfaces/ai-prompt-config.interface';
+/**
+ * DTO for a single AI prompt operation configuration.
+ * Implements AiPromptConfig interface with validation decorators.
+ *
+ * @example
+ * ```typescript
+ * const configs: AiPromptConfigDTO[] = [
+ *   { type: AiOperationType.TEXT_GENERATION, key: 'name', prompt: 'Generate a reward name' },
+ *   { type: AiOperationType.TEXT_GENERATION, key: 'description', prompt: 'Generate a description' },
+ *   { type: AiOperationType.IMAGE_GENERATION, key: 'imageUrl', prompt: 'Generate a badge image' },
+ * ];
+ * ```
+ */
+export declare class AiPromptConfigDTO implements AiPromptConfig {
+    type: AiPromptConfigType;
+    key: string;
+    prompt: string;
+}
+//# sourceMappingURL=ai-prompt-config.dto.d.ts.map

package/dist/esm/shared-lib/dto/ai/ai-prompt-config.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-prompt-config.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/ai/ai-prompt-config.dto.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAGtG,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAEvG;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAkB,YAAW,cAAc;IAOtD,IAAI,EAAG,kBAAkB,CAAC;IAQ1B,GAAG,EAAG,MAAM,CAAC;IAQb,MAAM,EAAG,MAAM,CAAC;CACjB"}

package/dist/esm/shared-lib/dto/ai/ai-prompt-config.dto.js

@@ -0,0 +1,52 @@
+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 } from '@nestjs/swagger';
+import { IsEnum, IsString, MaxLength } from 'class-validator';
+import { AiOperationType } from '../../enum/ai-operation-type.enum.js';
+/**
+ * DTO for a single AI prompt operation configuration.
+ * Implements AiPromptConfig interface with validation decorators.
+ *
+ * @example
+ * ```typescript
+ * const configs: AiPromptConfigDTO[] = [
+ *   { type: AiOperationType.TEXT_GENERATION, key: 'name', prompt: 'Generate a reward name' },
+ *   { type: AiOperationType.TEXT_GENERATION, key: 'description', prompt: 'Generate a description' },
+ *   { type: AiOperationType.IMAGE_GENERATION, key: 'imageUrl', prompt: 'Generate a badge image' },
+ * ];
+ * ```
+ */
+export class AiPromptConfigDTO {
+    type;
+    key;
+    prompt;
+}
+__decorate([
+    ApiProperty({
+        enum: [AiOperationType.TEXT_GENERATION, AiOperationType.IMAGE_GENERATION],
+        description: 'Type of AI operation to perform',
+        example: AiOperationType.TEXT_GENERATION,
+    }),
+    IsEnum(AiOperationType)
+], AiPromptConfigDTO.prototype, "type", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Key to store the generated result under',
+        example: 'name',
+    }),
+    IsString(),
+    MaxLength(50)
+], AiPromptConfigDTO.prototype, "key", void 0);
+__decorate([
+    ApiProperty({
+        description: 'The prompt to send to the AI model. Supports placeholders like {{user.name}}, {{campaign.name}}, {{tenant.name}}',
+        example: 'Generate a unique reward name for {{user.name}}',
+    }),
+    IsString(),
+    MaxLength(2000)
+], AiPromptConfigDTO.prototype, "prompt", void 0);
+//# sourceMappingURL=ai-prompt-config.dto.js.map

package/dist/esm/shared-lib/dto/ai/ai-prompt-config.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-prompt-config.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/ai/ai-prompt-config.dto.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAMpE;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,iBAAiB;IAO5B,IAAI,CAAsB;IAQ1B,GAAG,CAAU;IAQb,MAAM,CAAU;CACjB;AAjBC;IANC,WAAW,CAAC;QACX,IAAI,EAAE,CAAC,eAAe,CAAC,eAAe,EAAE,eAAe,CAAC,gBAAgB,CAAC;QACzE,WAAW,EAAE,iCAAiC;QAC9C,OAAO,EAAE,eAAe,CAAC,eAAe;KACzC,CAAC;IACD,MAAM,CAAC,eAAe,CAAC;+CACE;AAQ1B;IANC,WAAW,CAAC;QACX,WAAW,EAAE,yCAAyC;QACtD,OAAO,EAAE,MAAM;KAChB,CAAC;IACD,QAAQ,EAAE;IACV,SAAS,CAAC,EAAE,CAAC;8CACD;AAQb;IANC,WAAW,CAAC;QACX,WAAW,EAAE,kHAAkH;QAC/H,OAAO,EAAE,iDAAiD;KAC3D,CAAC;IACD,QAAQ,EAAE;IACV,SAAS,CAAC,IAAI,CAAC;iDACA"}

package/dist/esm/shared-lib/dto/ai/index.d.ts

@@ -0,0 +1,3 @@
+export * from './ai-generation-log.dto';
+export * from './ai-prompt-config.dto';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/ai/index.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC"}

package/dist/esm/shared-lib/dto/ai/index.js

@@ -0,0 +1,4 @@
+// AI DTOs Barrel
+export * from './ai-generation-log.dto.js';
+export * from './ai-prompt-config.dto.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/shared-lib/dto/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/ai/index.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC"}

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

@@ -0,0 +1,84 @@
+import { SortOrder } from '../../enum/sort-order.enum';
+import { AiTriggerProcessType } from '../../enum/ai-trigger-process-type.enum';
+import { AiOperationType } from '../../enum/ai-operation-type.enum';
+import { AiAnalyticsMetric, AiAnalyticsGroupBy } from '../../enum/ai-analytics-metric.enum';
+/**
+ * AI Usage Summary Request DTO
+ *
+ * Request for aggregated AI usage metrics for billing/reporting.
+ */
+export declare class AiUsageSummaryRequestDTO {
+    startDate: Date;
+    endDate: Date;
+}
+/**
+ * AI Usage Summary Response DTO
+ *
+ * Aggregated AI usage metrics with breakdown by model and operation type.
+ */
+export declare class AiUsageSummaryResponseDTO {
+    totalGenerations: number;
+    totalTokens: number;
+    inputTokens: number;
+    outputTokens: number;
+    totalCostUsd: number;
+    avgResponseTimeMs: number;
+    byModel: Record<string, {
+        count: number;
+        tokens: number;
+        costUsd: number;
+    }>;
+    byOperationType: Record<string, {
+        count: number;
+        tokens: number;
+        costUsd: number;
+    }>;
+    metadata: {
+        dateRange: {
+            startDate: Date;
+            endDate: Date;
+        };
+    };
+}
+/**
+ * AI Analytics Filters DTO
+ */
+export declare class AiAnalyticsFiltersDTO {
+    userId?: string;
+    operationType?: AiOperationType;
+    triggerProcessType?: AiTriggerProcessType;
+    triggerProcessId?: string;
+    model?: string;
+    success?: boolean;
+}
+/**
+ * AI Analytics Request DTO
+ *
+ * Flexible analytics request with grouping, metrics, and filters.
+ */
+export declare class AiAnalyticsRequestDTO {
+    filters?: AiAnalyticsFiltersDTO;
+    groupBy?: AiAnalyticsGroupBy[];
+    metrics?: AiAnalyticsMetric[];
+    sortBy?: AiAnalyticsMetric;
+    sortOrder?: SortOrder;
+    limit?: number;
+    startDate?: Date;
+    endDate?: Date;
+}
+/**
+ * AI Analytics Response DTO
+ *
+ * Results from flexible analytics query.
+ */
+export declare class AiAnalyticsResponseDTO {
+    results: Record<string, any>[];
+    totalGroups: number;
+    metadata: {
+        dateRange: {
+            startDate: Date;
+            endDate: Date;
+        };
+    };
+}
+//# sourceMappingURL=ai-analytics.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-analytics.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/ai-analytics.dto.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE5F;;;;GAIG;AACH,qBAAa,wBAAwB;IAOnC,SAAS,EAAG,IAAI,CAAC;IAQjB,OAAO,EAAG,IAAI,CAAC;CAChB;AAED;;;;GAIG;AACH,qBAAa,yBAAyB;IAEpC,gBAAgB,EAAG,MAAM,CAAC;IAG1B,WAAW,EAAG,MAAM,CAAC;IAGrB,WAAW,EAAG,MAAM,CAAC;IAGrB,YAAY,EAAG,MAAM,CAAC;IAGtB,YAAY,EAAG,MAAM,CAAC;IAGtB,iBAAiB,EAAG,MAAM,CAAC;IAS3B,OAAO,EAAG,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAS7E,eAAe,EAAG,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAGrF,QAAQ,EAAG;QACT,SAAS,EAAE;YACT,SAAS,EAAE,IAAI,CAAC;YAChB,OAAO,EAAE,IAAI,CAAC;SACf,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAIhC,MAAM,CAAC,EAAE,MAAM,CAAC;IAShB,aAAa,CAAC,EAAE,eAAe,CAAC;IAShC,kBAAkB,CAAC,EAAE,oBAAoB,CAAC;IAK1C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAK1B,KAAK,CAAC,EAAE,MAAM,CAAC;IAKf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,qBAAqB;IAMhC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAWhC,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAW/B,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAS9B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAS3B,SAAS,CAAC,EAAE,SAAS,CAAC;IAQtB,KAAK,CAAC,EAAE,MAAM,CAAC;IASf,SAAS,CAAC,EAAE,IAAI,CAAC;IASjB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;GAIG;AACH,qBAAa,sBAAsB;IAQjC,OAAO,EAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;IAGhC,WAAW,EAAG,MAAM,CAAC;IAGrB,QAAQ,EAAG;QACT,SAAS,EAAE;YACT,SAAS,EAAE,IAAI,CAAC;YAChB,OAAO,EAAE,IAAI,CAAC;SACf,CAAC;KACH,CAAC;CACH"}