@fiado/type-kit 3.571.0 → 3.573.0

package/_test_/unit/retailCustomer/promotionBonusContract.test.ts

@@ -6,8 +6,8 @@ import { BonusTypeEnum, UpsertPromotionBonusRequest } from '../../../src/retailC
 import type { PromotionBonusEntryResponse } from '../../../src/retailCustomer/index';
 
 describe('BonusTypeEnum', () => {
-    it('distingue la bienvenida de las dos promociones', () => {
-        expect(Object.values(BonusTypeEnum)).toEqual(['WELCOME', 'CREDIT_PROMOTION', 'SALE_PROMOTION']);
+    it('distingue la bienvenida, las dos promociones y el premio de referido', () => {
+        expect(Object.values(BonusTypeEnum)).toEqual(['WELCOME', 'CREDIT_PROMOTION', 'SALE_PROMOTION', 'REFERRAL']);
     });
 
     it('sale por el index raíz', () => {
@@ -51,6 +51,10 @@ describe('UpsertPromotionBonusRequest', () => {
         expect(errorsOf({ ...PENDING_SALE, bonusType: 'WELCOME' })).toContain('bonusType');
     });
 
+    it('acepta el premio de referido con su rol y referido', () => {
+        expect(errorsOf({ ...PENDING_SALE, bonusType: 'REFERRAL', role: 'REFERRER', referralId: 'ref-1' })).toEqual([]);
+    });
+
     it.each(['promotionId', 'sourceId', 'storeId', 'currency', 'idempotencyKey'])('rechaza %s vacío', (field) => {
         expect(errorsOf({ ...PENDING_SALE, [field]: '  ' })).toContain(field);
     });

package/_test_/unit/rules/populationDtos.test.ts

@@ -56,3 +56,25 @@ describe('population DTOs', () => {
         expect(Object.keys(Rules.PopulationExecutionStatusEnum)).toEqual(['RUNNING', 'SUCCEEDED', 'FAILED', 'CANCELLED']);
     });
 });
+
+describe('rutas de columna (SEGMENT_COLUMN_PATH_PATTERN)', () => {
+    const colCond = (column: string) => ({ kind: 'COLUMN', table: 'riskprofile', column, op: 'GT', value: 1 });
+    it.each(['score', 'riskfactors.income.value', 'a.b.c.d.e.f.g.h'])('column "%s" válida -> 0 errores', async (column) => {
+        expect(await errorsOf(Rules.SegmentColumnCondition, colCond(column))).toBe(0);
+    });
+    it.each(['a.b.c.d.e.f.g.h.i', 'Riskfactors.income', 'a..b', 'a.', '.a', 'a.1b', 'a-b.c'])('column "%s" inválida -> error', async (column) => {
+        expect(await errorsOf(Rules.SegmentColumnCondition, colCond(column))).toBeGreaterThan(0);
+    });
+    it('table con punto sigue inválida', async () => {
+        expect(await errorsOf(Rules.SegmentColumnCondition, { ...colCond('score'), table: 'a.b' })).toBeGreaterThan(0);
+    });
+    it('dateColumn anidada válida y SEGMENT_MAX_PATH_DEPTH = 8', async () => {
+        expect(await errorsOf(Rules.SegmentWindow, { dateColumn: 'riskfactors.income.evaluationat', days: 30 })).toBe(0);
+        expect(Rules.SEGMENT_MAX_PATH_DEPTH).toBe(8);
+    });
+    it('aggregate column anidada válida', async () => {
+        const agg = { kind: 'AGGREGATE', table: 'tx', fn: 'SUM', column: 'a.b.c', op: 'GT', value: 1 };
+        const errs = await validate(plainToInstance(Rules.SegmentAggregateCondition, agg, { excludeExtraneousValues: true }));
+        expect(errs.filter((e) => e.property === 'column')).toHaveLength(0);
+    });
+});

package/bin/retailCustomer/dtos/requests/UpsertPromotionBonusRequest.js

@@ -18,7 +18,7 @@ const ReferralRoleEnum_1 = require("../../enums/ReferralRoleEnum");
 const WelcomeBonusStatusEnum_1 = require("../../enums/WelcomeBonusStatusEnum");
 /** Tope del motivo libre que el caller escribe en el asiento. */
 const FREE_TEXT_MAX_LENGTH = 256;
-const PROMOTION_BONUS_TYPES = [BonusTypeEnum_1.BonusTypeEnum.CREDIT_PROMOTION, BonusTypeEnum_1.BonusTypeEnum.SALE_PROMOTION];
+const PROMOTION_BONUS_TYPES = [BonusTypeEnum_1.BonusTypeEnum.CREDIT_PROMOTION, BonusTypeEnum_1.BonusTypeEnum.SALE_PROMOTION, BonusTypeEnum_1.BonusTypeEnum.REFERRAL];
 const STATUSES_REQUIRING_REASON = [
     WelcomeBonusStatusEnum_1.WelcomeBonusStatusEnum.FAILED,
     WelcomeBonusStatusEnum_1.WelcomeBonusStatusEnum.UNVERIFIED,

package/bin/retailCustomer/enums/BonusTypeEnum.d.ts

@@ -2,5 +2,6 @@
 export declare enum BonusTypeEnum {
     WELCOME = "WELCOME",
     CREDIT_PROMOTION = "CREDIT_PROMOTION",
-    SALE_PROMOTION = "SALE_PROMOTION"
+    SALE_PROMOTION = "SALE_PROMOTION",
+    REFERRAL = "REFERRAL"
 }

package/bin/retailCustomer/enums/BonusTypeEnum.js

@@ -7,4 +7,5 @@ var BonusTypeEnum;
     BonusTypeEnum["WELCOME"] = "WELCOME";
     BonusTypeEnum["CREDIT_PROMOTION"] = "CREDIT_PROMOTION";
     BonusTypeEnum["SALE_PROMOTION"] = "SALE_PROMOTION";
+    BonusTypeEnum["REFERRAL"] = "REFERRAL";
 })(BonusTypeEnum || (exports.BonusTypeEnum = BonusTypeEnum = {}));

package/bin/rules/constants/SegmentLimits.d.ts

@@ -1,5 +1,8 @@
 /** Identificador SQL permitido para tabla/columna (A§4.3 paso 1): minusculas, digitos y guion bajo; nunca texto libre. */
 export declare const SEGMENT_IDENTIFIER_PATTERN: RegExp;
+/** Ruta a una hoja de columna struct de Glue (`riskfactors.income.value`): segmentos separados por punto, maximo SEGMENT_MAX_PATH_DEPTH. Una columna plana es una ruta de 1 segmento. */
+export declare const SEGMENT_COLUMN_PATH_PATTERN: RegExp;
+export declare const SEGMENT_MAX_PATH_DEPTH = 8;
 export declare const SEGMENT_MAX_DAYS = 365;
 export declare const SEGMENT_MAX_PARAMS = 40;
 export declare const SEGMENT_MAX_AGGREGATES = 8;

package/bin/rules/constants/SegmentLimits.js

@@ -1,8 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SEGMENT_MAX_AGGREGATES = exports.SEGMENT_MAX_PARAMS = exports.SEGMENT_MAX_DAYS = exports.SEGMENT_IDENTIFIER_PATTERN = void 0;
+exports.SEGMENT_MAX_AGGREGATES = exports.SEGMENT_MAX_PARAMS = exports.SEGMENT_MAX_DAYS = exports.SEGMENT_MAX_PATH_DEPTH = exports.SEGMENT_COLUMN_PATH_PATTERN = exports.SEGMENT_IDENTIFIER_PATTERN = void 0;
 /** Identificador SQL permitido para tabla/columna (A§4.3 paso 1): minusculas, digitos y guion bajo; nunca texto libre. */
 exports.SEGMENT_IDENTIFIER_PATTERN = /^[a-z_][a-z0-9_]*$/;
+/** Ruta a una hoja de columna struct de Glue (`riskfactors.income.value`): segmentos separados por punto, maximo SEGMENT_MAX_PATH_DEPTH. Una columna plana es una ruta de 1 segmento. */
+exports.SEGMENT_COLUMN_PATH_PATTERN = /^[a-z_][a-z0-9_]*(\.[a-z_][a-z0-9_]*){0,7}$/;
+exports.SEGMENT_MAX_PATH_DEPTH = 8;
 exports.SEGMENT_MAX_DAYS = 365;
 exports.SEGMENT_MAX_PARAMS = 40;
 exports.SEGMENT_MAX_AGGREGATES = 8;

package/bin/rules/dtos/population/SegmentAggregateCondition.js

@@ -40,7 +40,7 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.Matches)(SegmentLimits_1.SEGMENT_IDENTIFIER_PATTERN),
+    (0, class_validator_1.Matches)(SegmentLimits_1.SEGMENT_COLUMN_PATH_PATTERN),
     __metadata("design:type", String)
 ], SegmentAggregateCondition.prototype, "column", void 0);
 __decorate([

package/bin/rules/dtos/population/SegmentColumnCondition.js

@@ -31,7 +31,7 @@ __decorate([
 ], SegmentColumnCondition.prototype, "table", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.Matches)(SegmentLimits_1.SEGMENT_IDENTIFIER_PATTERN),
+    (0, class_validator_1.Matches)(SegmentLimits_1.SEGMENT_COLUMN_PATH_PATTERN),
     __metadata("design:type", String)
 ], SegmentColumnCondition.prototype, "column", void 0);
 __decorate([

package/bin/rules/dtos/population/SegmentTableSchemaResponse.d.ts

@@ -1,6 +1,8 @@
 import { SegmentOperatorEnum } from '../../enums/SegmentOperatorEnum';
 export declare class SegmentColumnSchemaResponse {
     name: string;
+    /** Columna raiz de Glue cuando `name` es una ruta a una hoja de struct (agrupa en la UI). */
+    root?: string;
     type: string;
     isDate: boolean;
     operators: SegmentOperatorEnum[];

package/bin/rules/dtos/population/SegmentWindow.js

@@ -19,7 +19,7 @@ class SegmentWindow {
 exports.SegmentWindow = SegmentWindow;
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.Matches)(SegmentLimits_1.SEGMENT_IDENTIFIER_PATTERN),
+    (0, class_validator_1.Matches)(SegmentLimits_1.SEGMENT_COLUMN_PATH_PATTERN),
     __metadata("design:type", String)
 ], SegmentWindow.prototype, "dateColumn", void 0);
 __decorate([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.571.0",
+  "version": "3.573.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/retailCustomer/dtos/requests/UpsertPromotionBonusRequest.ts

@@ -8,7 +8,7 @@ import { WelcomeBonusStatusEnum } from '../../enums/WelcomeBonusStatusEnum';
 /** Tope del motivo libre que el caller escribe en el asiento. */
 const FREE_TEXT_MAX_LENGTH = 256;
 
-const PROMOTION_BONUS_TYPES = [BonusTypeEnum.CREDIT_PROMOTION, BonusTypeEnum.SALE_PROMOTION];
+const PROMOTION_BONUS_TYPES = [BonusTypeEnum.CREDIT_PROMOTION, BonusTypeEnum.SALE_PROMOTION, BonusTypeEnum.REFERRAL];
 
 const STATUSES_REQUIRING_REASON: WelcomeBonusStatusEnum[] = [
     WelcomeBonusStatusEnum.FAILED,

package/src/retailCustomer/enums/BonusTypeEnum.ts

@@ -3,4 +3,5 @@ export enum BonusTypeEnum {
     WELCOME = 'WELCOME',
     CREDIT_PROMOTION = 'CREDIT_PROMOTION',
     SALE_PROMOTION = 'SALE_PROMOTION',
+    REFERRAL = 'REFERRAL',
 }

package/src/rules/constants/SegmentLimits.ts

@@ -1,5 +1,8 @@
 /** Identificador SQL permitido para tabla/columna (A§4.3 paso 1): minusculas, digitos y guion bajo; nunca texto libre. */
 export const SEGMENT_IDENTIFIER_PATTERN = /^[a-z_][a-z0-9_]*$/;
+/** Ruta a una hoja de columna struct de Glue (`riskfactors.income.value`): segmentos separados por punto, maximo SEGMENT_MAX_PATH_DEPTH. Una columna plana es una ruta de 1 segmento. */
+export const SEGMENT_COLUMN_PATH_PATTERN = /^[a-z_][a-z0-9_]*(\.[a-z_][a-z0-9_]*){0,7}$/;
+export const SEGMENT_MAX_PATH_DEPTH = 8;
 export const SEGMENT_MAX_DAYS = 365;
 export const SEGMENT_MAX_PARAMS = 40;
 export const SEGMENT_MAX_AGGREGATES = 8;

package/src/rules/dtos/population/SegmentAggregateCondition.ts

@@ -1,6 +1,6 @@
 import { Expose, Type } from 'class-transformer';
 import { ArrayMaxSize, Equals, IsArray, IsEnum, IsNumber, IsOptional, Matches, ValidateNested } from 'class-validator';
-import { SEGMENT_IDENTIFIER_PATTERN } from '../../constants/SegmentLimits';
+import { SEGMENT_COLUMN_PATH_PATTERN, SEGMENT_IDENTIFIER_PATTERN } from '../../constants/SegmentLimits';
 import { SegmentAggregateFnEnum } from '../../enums/SegmentAggregateFnEnum';
 import { SegmentConditionKindEnum } from '../../enums/SegmentConditionKindEnum';
 import { SegmentOperatorEnum } from '../../enums/SegmentOperatorEnum';
@@ -13,7 +13,7 @@ export class SegmentAggregateCondition {
     @Expose() @Matches(SEGMENT_IDENTIFIER_PATTERN) table: string;
     @Expose() @IsEnum(SegmentAggregateFnEnum) fn: SegmentAggregateFnEnum;
     /** Solo SUM. */
-    @Expose() @IsOptional() @Matches(SEGMENT_IDENTIFIER_PATTERN) column?: string;
+    @Expose() @IsOptional() @Matches(SEGMENT_COLUMN_PATH_PATTERN) column?: string;
     /** COUNT y SUM; EXISTS no lleva. */
     @Expose() @IsOptional() @IsEnum(SegmentOperatorEnum) op?: SegmentOperatorEnum;
     @Expose() @IsOptional() @IsNumber() value?: number;

package/src/rules/dtos/population/SegmentColumnCondition.ts

@@ -1,7 +1,7 @@
 import { Expose } from 'class-transformer';
 import { Equals, IsEnum, IsOptional, Matches } from 'class-validator';
 import { JsonValue } from '../../../common';
-import { SEGMENT_IDENTIFIER_PATTERN } from '../../constants/SegmentLimits';
+import { SEGMENT_COLUMN_PATH_PATTERN, SEGMENT_IDENTIFIER_PATTERN } from '../../constants/SegmentLimits';
 import { SegmentConditionKindEnum } from '../../enums/SegmentConditionKindEnum';
 import { SegmentOperatorEnum } from '../../enums/SegmentOperatorEnum';
 
@@ -9,7 +9,7 @@ import { SegmentOperatorEnum } from '../../enums/SegmentOperatorEnum';
 export class SegmentColumnCondition {
     @Expose() @Equals(SegmentConditionKindEnum.COLUMN) kind: SegmentConditionKindEnum.COLUMN;
     @Expose() @Matches(SEGMENT_IDENTIFIER_PATTERN) table: string;
-    @Expose() @Matches(SEGMENT_IDENTIFIER_PATTERN) column: string;
+    @Expose() @Matches(SEGMENT_COLUMN_PATH_PATTERN) column: string;
     @Expose() @IsEnum(SegmentOperatorEnum) op: SegmentOperatorEnum;
     @Expose() @IsOptional() value?: JsonValue;
 }

package/src/rules/dtos/population/SegmentTableSchemaResponse.ts

@@ -2,6 +2,8 @@ import { SegmentOperatorEnum } from '../../enums/SegmentOperatorEnum';
 
 export class SegmentColumnSchemaResponse {
     name: string;
+    /** Columna raiz de Glue cuando `name` es una ruta a una hoja de struct (agrupa en la UI). */
+    root?: string;
     type: string;
     isDate: boolean;
     operators: SegmentOperatorEnum[];

package/src/rules/dtos/population/SegmentWindow.ts

@@ -1,9 +1,9 @@
 import { Expose } from 'class-transformer';
 import { IsInt, Matches, Max, Min } from 'class-validator';
-import { SEGMENT_IDENTIFIER_PATTERN, SEGMENT_MAX_DAYS } from '../../constants/SegmentLimits';
+import { SEGMENT_COLUMN_PATH_PATTERN, SEGMENT_MAX_DAYS } from '../../constants/SegmentLimits';
 
 /** Ventana relativa [referenceAt - days, referenceAt) sobre una columna de fecha (A§4.1). */
 export class SegmentWindow {
-    @Expose() @Matches(SEGMENT_IDENTIFIER_PATTERN) dateColumn: string;
+    @Expose() @Matches(SEGMENT_COLUMN_PATH_PATTERN) dateColumn: string;
     @Expose() @IsInt() @Min(1) @Max(SEGMENT_MAX_DAYS) days: number;
 }