Merge branch 'sdk-configs-rename-split-to-definition' into configs-sdk-client

AI-Session-Id: e9b3e072-2ec0-428a-b108-9646c6de8629
AI-Tool: claude-code
AI-Model: unknown

Author: EmilianoSanchez

src/dtos/types.ts

@@ -215,51 +215,6 @@ export interface IRBSegment {
   } | null
 }
 
-// Superset of ISplit (i.e., ISplit extends IConfig)
-// - with optional fields related to targeting information and
-// - an optional link fields that binds configurations to other entities
-export interface IConfig {
-  name: string,
-  changeNumber: number,
-  status?: 'ACTIVE' | 'ARCHIVED',
-  conditions?: ISplitCondition[] | null,
-  prerequisites?: null | {
-    n: string,
-    ts: string[]
-  }[]
-  killed?: boolean,
-  defaultTreatment: string,
-  trafficTypeName?: string,
-  seed?: number,
-  trafficAllocation?: number,
-  trafficAllocationSeed?: number
-  configurations?: {
-    [treatmentName: string]: string
-  },
-  sets?: string[],
-  impressionsDisabled?: boolean,
-  // a map of entities (e.g., pipeline, feature-flag, etc) to configuration variants
-  links?: {
-    [entityType: string]: {
-      [entityName: string]: string
-    }
-  }
-}
-
-/** Interface of the parsed JSON response of `/configs` */
-export interface IConfigsResponse {
-  configs?: {
-    t: number,
-    s?: number,
-    d: IConfig[]
-  },
-  rbs?: {
-    t: number,
-    s?: number,
-    d: IRBSegment[]
-  }
-}
-
 // @TODO: rename to IDefinition (Configs and Feature Flags are definitions)
 export interface ISplit {
   name: string,
@@ -277,7 +232,7 @@ export interface ISplit {
   trafficAllocation?: number,
   trafficAllocationSeed?: number
   configurations?: {
-    [treatmentName: string]: string
+    [treatmentName: string]: string | SplitIO.JsonObject
   },
   sets?: string[],
   impressionsDisabled?: boolean

src/evaluator/fallbackConfigsCalculator/__tests__/fallback-calculator.spec.ts

@@ -0,0 +1,50 @@
+import { FallbackConfigsCalculator } from '../';
+import SplitIO from '../../../../types/splitio';
+import { CONTROL } from '../../../utils/constants';
+
+describe('FallbackConfigsCalculator', () => {
+  test('returns specific fallback if config name exists', () => {
+    const fallbacks: SplitIO.FallbackConfigs = {
+      byName: {
+        'configA': { variant: 'VARIANT_A', value: { key: 1 } },
+      },
+    };
+    const calculator = FallbackConfigsCalculator(fallbacks);
+    const result = calculator('configA', 'label by name');
+
+    expect(result).toEqual({
+      treatment: 'VARIANT_A',
+      config: { key: 1 },
+      label: 'fallback - label by name',
+    });
+  });
+
+  test('returns global fallback if config name is missing and global exists', () => {
+    const fallbacks: SplitIO.FallbackConfigs = {
+      byName: {},
+      global: { variant: 'GLOBAL_VARIANT', value: { global: true } },
+    };
+    const calculator = FallbackConfigsCalculator(fallbacks);
+    const result = calculator('missingConfig', 'label by global');
+
+    expect(result).toEqual({
+      treatment: 'GLOBAL_VARIANT',
+      config: { global: true },
+      label: 'fallback - label by global',
+    });
+  });
+
+  test('returns control fallback if config name and global are missing', () => {
+    const fallbacks: SplitIO.FallbackConfigs = {
+      byName: {},
+    };
+    const calculator = FallbackConfigsCalculator(fallbacks);
+    const result = calculator('missingConfig', 'label by noFallback');
+
+    expect(result).toEqual({
+      treatment: CONTROL,
+      config: null,
+      label: 'label by noFallback',
+    });
+  });
+});

src/evaluator/fallbackConfigsCalculator/__tests__/fallback-sanitizer.spec.ts

@@ -0,0 +1,147 @@
+import { isValidConfigName, isValidConfig, sanitizeFallbacks } from '../fallbackSanitizer';
+import SplitIO from '../../../../types/splitio';
+import { loggerMock } from '../../../logger/__tests__/sdkLogger.mock';
+
+describe('FallbackConfigsSanitizer', () => {
+  const validConfig: SplitIO.Config = { variant: 'on', value: { color: 'blue' } };
+  const invalidVariantConfig: SplitIO.Config = { variant: ' ', value: { color: 'blue' } };
+  const invalidValueConfig = { variant: 'on', value: 'not_an_object' } as unknown as SplitIO.Config;
+  const fallbackMock = {
+    global: undefined,
+    byName: {}
+  };
+
+  beforeEach(() => {
+    loggerMock.mockClear();
+  });
+
+  describe('isValidConfigName', () => {
+    test('returns true for a valid config name', () => {
+      expect(isValidConfigName('my_config')).toBe(true);
+    });
+
+    test('returns false for a name longer than 100 chars', () => {
+      const longName = 'a'.repeat(101);
+      expect(isValidConfigName(longName)).toBe(false);
+    });
+
+    test('returns false if the name contains spaces', () => {
+      expect(isValidConfigName('invalid config')).toBe(false);
+    });
+
+    test('returns false if the name is not a string', () => {
+      // @ts-ignore
+      expect(isValidConfigName(true)).toBe(false);
+    });
+  });
+
+  describe('isValidConfig', () => {
+    test('returns true for a valid config', () => {
+      expect(isValidConfig(validConfig)).toBe(true);
+    });
+
+    test('returns false for null or undefined', () => {
+      expect(isValidConfig()).toBe(false);
+      expect(isValidConfig(undefined)).toBe(false);
+    });
+
+    test('returns false for a variant longer than 100 chars', () => {
+      const long: SplitIO.Config = { variant: 'a'.repeat(101), value: {} };
+      expect(isValidConfig(long)).toBe(false);
+    });
+
+    test('returns false if variant does not match regex pattern', () => {
+      const invalid: SplitIO.Config = { variant: 'invalid variant!', value: {} };
+      expect(isValidConfig(invalid)).toBe(false);
+    });
+
+    test('returns false if value is not an object', () => {
+      expect(isValidConfig(invalidValueConfig)).toBe(false);
+    });
+  });
+
+  describe('sanitizeGlobal', () => {
+    test('returns the config if valid', () => {
+      expect(sanitizeFallbacks(loggerMock, { ...fallbackMock, global: validConfig })).toEqual({ ...fallbackMock, global: validConfig });
+      expect(loggerMock.error).not.toHaveBeenCalled();
+    });
+
+    test('returns undefined and logs error if variant is invalid', () => {
+      const result = sanitizeFallbacks(loggerMock, { ...fallbackMock, global: invalidVariantConfig });
+      expect(result).toEqual(fallbackMock);
+      expect(loggerMock.error).toHaveBeenCalledWith(
+        expect.stringContaining('Fallback configs - Discarded fallback')
+      );
+    });
+
+    test('returns undefined and logs error if value is invalid', () => {
+      const result = sanitizeFallbacks(loggerMock, { ...fallbackMock, global: invalidValueConfig });
+      expect(result).toEqual(fallbackMock);
+      expect(loggerMock.error).toHaveBeenCalledWith(
+        expect.stringContaining('Fallback configs - Discarded fallback')
+      );
+    });
+  });
+
+  describe('sanitizeByName', () => {
+    test('returns a sanitized map with valid entries only', () => {
+      const input = {
+        valid_config: validConfig,
+        'invalid config': validConfig,
+        bad_variant: invalidVariantConfig,
+      };
+
+      const result = sanitizeFallbacks(loggerMock, { ...fallbackMock, byName: input });
+
+      expect(result).toEqual({ ...fallbackMock, byName: { valid_config: validConfig } });
+      expect(loggerMock.error).toHaveBeenCalledTimes(2); // invalid config name + bad_variant
+    });
+
+    test('returns empty object if all invalid', () => {
+      const input = {
+        'invalid config': invalidVariantConfig,
+      };
+
+      const result = sanitizeFallbacks(loggerMock, { ...fallbackMock, byName: input });
+      expect(result).toEqual(fallbackMock);
+      expect(loggerMock.error).toHaveBeenCalled();
+    });
+
+    test('returns same object if all valid', () => {
+      const input = {
+        ...fallbackMock,
+        byName: {
+          config_one: validConfig,
+          config_two: { variant: 'valid_2', value: { key: 'val' } },
+        }
+      };
+
+      const result = sanitizeFallbacks(loggerMock, input);
+      expect(result).toEqual(input);
+      expect(loggerMock.error).not.toHaveBeenCalled();
+    });
+  });
+
+  describe('sanitizeFallbacks', () => {
+    test('returns undefined and logs error if fallbacks is not an object', () => { // @ts-expect-error
+      const result = sanitizeFallbacks(loggerMock, 'invalid_fallbacks');
+      expect(result).toBeUndefined();
+      expect(loggerMock.error).toHaveBeenCalledWith(
+        'Fallback configs - Discarded configuration: it must be an object with optional `global` and `byName` properties'
+      );
+    });
+
+    test('returns undefined and logs error if fallbacks is not an object', () => { // @ts-expect-error
+      const result = sanitizeFallbacks(loggerMock, true);
+      expect(result).toBeUndefined();
+      expect(loggerMock.error).toHaveBeenCalledWith(
+        'Fallback configs - Discarded configuration: it must be an object with optional `global` and `byName` properties'
+      );
+    });
+
+    test('sanitizes both global and byName fallbacks for empty object', () => { // @ts-expect-error
+      const result = sanitizeFallbacks(loggerMock, { global: {} });
+      expect(result).toEqual({ global: undefined, byName: {} });
+    });
+  });
+});

src/evaluator/fallbackConfigsCalculator/fallbackSanitizer/index.ts

@@ -0,0 +1,78 @@
+import SplitIO from '../../../../types/splitio';
+import { ILogger } from '../../../logger/types';
+import { isObject, isString } from '../../../utils/lang';
+
+enum FallbackDiscardReason {
+  ConfigName = 'Invalid config name (max 100 chars, no spaces)',
+  Variant = 'Invalid variant (max 100 chars and must match pattern)',
+  Value = 'Invalid value (must be an object)',
+}
+
+const VARIANT_PATTERN = /^[0-9]+[.a-zA-Z0-9_-]*$|^[a-zA-Z]+[a-zA-Z0-9_-]*$/;
+
+export function isValidConfigName(name: string): boolean {
+  return name.length <= 100 && !name.includes(' ');
+}
+
+export function isValidConfig(config?: SplitIO.Config): boolean {
+  if (!isObject(config)) return false;
+  if (!isString(config!.variant) || config!.variant.length > 100 || !VARIANT_PATTERN.test(config!.variant)) return false;
+  if (!isObject(config!.value)) return false;
+  return true;
+}
+
+function sanitizeGlobal(logger: ILogger, config?: SplitIO.Config): SplitIO.Config | undefined {
+  if (config === undefined) return undefined;
+  if (!isValidConfig(config)) {
+    if (!isObject(config) || !isString(config!.variant) || config!.variant.length > 100 || !VARIANT_PATTERN.test(config!.variant)) {
+      logger.error(`Fallback configs - Discarded fallback: ${FallbackDiscardReason.Variant}`);
+    } else {
+      logger.error(`Fallback configs - Discarded fallback: ${FallbackDiscardReason.Value}`);
+    }
+    return undefined;
+  }
+  return config;
+}
+
+function sanitizeByName(
+  logger: ILogger,
+  byNameFallbacks?: Record<string, SplitIO.Config>
+): Record<string, SplitIO.Config> {
+  const sanitizedByName: Record<string, SplitIO.Config> = {};
+
+  if (!isObject(byNameFallbacks)) return sanitizedByName;
+
+  Object.keys(byNameFallbacks!).forEach((configName) => {
+    const config = byNameFallbacks![configName];
+
+    if (!isValidConfigName(configName)) {
+      logger.error(`Fallback configs - Discarded config '${configName}': ${FallbackDiscardReason.ConfigName}`);
+      return;
+    }
+
+    if (!isValidConfig(config)) {
+      if (!isObject(config) || !isString(config.variant) || config.variant.length > 100 || !VARIANT_PATTERN.test(config.variant)) {
+        logger.error(`Fallback configs - Discarded config '${configName}': ${FallbackDiscardReason.Variant}`);
+      } else {
+        logger.error(`Fallback configs - Discarded config '${configName}': ${FallbackDiscardReason.Value}`);
+      }
+      return;
+    }
+
+    sanitizedByName[configName] = config;
+  });
+
+  return sanitizedByName;
+}
+
+export function sanitizeFallbacks(logger: ILogger, fallbacks: SplitIO.FallbackConfigs): SplitIO.FallbackConfigs | undefined {
+  if (!isObject(fallbacks)) {
+    logger.error('Fallback configs - Discarded configuration: it must be an object with optional `global` and `byName` properties');
+    return;
+  }
+
+  return {
+    global: sanitizeGlobal(logger, fallbacks.global),
+    byName: sanitizeByName(logger, fallbacks.byName)
+  };
+}

src/evaluator/fallbackConfigsCalculator/index.ts

@@ -0,0 +1,24 @@
+import { IFallbackCalculator } from '../fallbackTreatmentsCalculator/index';
+import { CONTROL } from '../../utils/constants';
+import SplitIO from '../../../types/splitio';
+
+export const FALLBACK_PREFIX = 'fallback - ';
+
+export function FallbackConfigsCalculator(fallbacks: SplitIO.FallbackConfigs = {}): IFallbackCalculator {
+
+  return (configName: string, label = '') => {
+    const fallback = fallbacks.byName?.[configName] || fallbacks.global;
+
+    return fallback ?
+      {
+        treatment: fallback.variant,
+        config: fallback.value,
+        label: `${FALLBACK_PREFIX}${label}`,
+      } :
+      {
+        treatment: CONTROL,
+        config: null,
+        label,
+      };
+  };
+}

src/evaluator/fallbackTreatmentsCalculator/index.ts

@@ -1,12 +1,16 @@
-import { FallbackTreatmentConfiguration, TreatmentWithConfig } from '../../../types/splitio';
 import { CONTROL } from '../../utils/constants';
 import { isString } from '../../utils/lang';
+import SplitIO from '../../../types/splitio';
 
-export type IFallbackTreatmentsCalculator = (flagName: string, label?: string) => TreatmentWithConfig & { label: string };
+export type IFallbackCalculator = (definitionName: string, label?: string) => {
+  treatment: string;
+  config: string | null | SplitIO.JsonObject;
+  label: string
+};
 
 export const FALLBACK_PREFIX = 'fallback - ';
 
-export function FallbackTreatmentsCalculator(fallbacks: FallbackTreatmentConfiguration = {}): IFallbackTreatmentsCalculator {
+export function FallbackTreatmentsCalculator(fallbacks: SplitIO.FallbackTreatmentConfiguration = {}): IFallbackCalculator {
 
   return (flagName: string, label = '') => {
     const fallback = fallbacks.byFlag?.[flagName] || fallbacks.global;

src/evaluator/types.ts

@@ -22,7 +22,7 @@ export interface IEvaluation {
   treatment?: string,
   label: string,
   changeNumber?: number,
-  config?: string | object | null
+  config?: string | null | SplitIO.JsonObject
 }
 
 export type IEvaluationResult = IEvaluation & { treatment: string; impressionsDisabled?: boolean }