@adtrackify/at-tracking-event-types 4.52.0 → 4.52.1

package/dist/esm/__tests__/measure-alias-map.spec.js

@@ -1,331 +1,323 @@
-import { MEASURE_ALIAS_MAP, resolveAlias, isAlias, getAliasesFor } from '../types/api/measures/measure-alias-map';
-import { MEASURES_MAP } from '../types/api/measures/definitions/measure-definitions';
-import { MEASURE } from '../types/api/measures/measures';
-const CROSS_NAMESPACE_MIGRATION_ALIASES = new Set([
-    MEASURE.SHOPIFY_ORDERS,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_ORDERS,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_ORDERS,
-    MEASURE.SHOPIFY_CUSTOMERS,
-    MEASURE.SHOPIFY_TOTAL_REVENUE,
-    MEASURE.SHOPIFY_TOTAL_AMOUNT,
-    MEASURE.SHOPIFY_REVENUE,
-    MEASURE.SHOPIFY_TOTAL_SALES,
-    MEASURE.SHOPIFY_GROSS_SALES,
-    MEASURE.SHOPIFY_NET_SALES,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_TOTAL_REVENUE,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_TOTAL_AMOUNT,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_TOTAL_SALES,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_REVENUE,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_GROSS_SALES,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_NET_SALES,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_TOTAL_REVENUE,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_TOTAL_AMOUNT,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_TOTAL_SALES,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_REVENUE,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_GROSS_SALES,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_NET_SALES,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_RATE,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_RATE,
-    MEASURE.SHOPIFY_REPEAT_CUSTOMER_RATE,
-    MEASURE.SHOPIFY_TOTAL_AOV,
-    MEASURE.SHOPIFY_GROSS_AOV,
-    MEASURE.SHOPIFY_AOV,
-    MEASURE.SHOPIFY_NET_AOV,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_GROSS_AOV,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_AOV,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_NET_AOV,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_TOTAL_AOV,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_GROSS_AOV,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_AOV,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_NET_AOV,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_TOTAL_AOV,
-    MEASURE.SHOPIFY_ORDER_TOTAL_PRODUCT_COST,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_ORDER_TOTAL_PRODUCT_COST,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_ORDER_TOTAL_PRODUCT_COST,
-    MEASURE.SHOPIFY_ORDER_TOTAL_PRODUCT_COST_GROSS_PERCENT,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_ORDER_TOTAL_PRODUCT_COST_GROSS_PERCENT,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_ORDER_TOTAL_PRODUCT_COST_GROSS_PERCENT,
-    MEASURE.SHOPIFY_ORDER_TOTAL_PRODUCT_COST_NET_PERCENT,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_ORDER_TOTAL_PRODUCT_COST_NET_PERCENT,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_ORDER_TOTAL_PRODUCT_COST_NET_PERCENT,
-    MEASURE.SHOPIFY_GROSS_MARGIN,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_GROSS_MARGIN,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_GROSS_MARGIN,
-    MEASURE.SHOPIFY_GROSS_MARGIN_GROSS_PERCENT,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_GROSS_MARGIN_GROSS_PERCENT,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_GROSS_MARGIN_GROSS_PERCENT,
-    MEASURE.SHOPIFY_GROSS_MARGIN_NET_PERCENT,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_GROSS_MARGIN_NET_PERCENT,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_GROSS_MARGIN_NET_PERCENT,
-    MEASURE.SHOPIFY_NET_MARGIN,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_NET_MARGIN,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_NET_MARGIN,
-    MEASURE.SHOPIFY_NET_MARGIN_GROSS_PERCENT,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_NET_MARGIN_GROSS_PERCENT,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_NET_MARGIN_GROSS_PERCENT,
-    MEASURE.SHOPIFY_NET_MARGIN_NET_PERCENT,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_NET_MARGIN_NET_PERCENT,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_NET_MARGIN_NET_PERCENT,
-    MEASURE.SHOPIFY_GROSS_PRODUCT_MARGIN,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_GROSS_PRODUCT_MARGIN,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_GROSS_PRODUCT_MARGIN,
-    MEASURE.SHOPIFY_GROSS_PRODUCT_MARGIN_GROSS_PERCENT,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_GROSS_PRODUCT_MARGIN_GROSS_PERCENT,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_GROSS_PRODUCT_MARGIN_GROSS_PERCENT,
-    MEASURE.SHOPIFY_GROSS_PRODUCT_MARGIN_NET_PERCENT,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_GROSS_PRODUCT_MARGIN_NET_PERCENT,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_GROSS_PRODUCT_MARGIN_NET_PERCENT,
-    MEASURE.SHOPIFY_NET_PRODUCT_MARGIN,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_NET_PRODUCT_MARGIN,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_NET_PRODUCT_MARGIN,
-    MEASURE.SHOPIFY_NET_PRODUCT_MARGIN_GROSS_PERCENT,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_NET_PRODUCT_MARGIN_GROSS_PERCENT,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_NET_PRODUCT_MARGIN_GROSS_PERCENT,
-    MEASURE.SHOPIFY_NET_PRODUCT_MARGIN_NET_PERCENT,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_NET_PRODUCT_MARGIN_NET_PERCENT,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_NET_PRODUCT_MARGIN_NET_PERCENT,
-    MEASURE.SHOPIFY_REFUNDS,
-    MEASURE.SHOPIFY_REFUND_AMOUNT_REFUND_DATE,
-    MEASURE.SHOPIFY_REFUND_AMOUNT_ORDER_DATE,
-    MEASURE.SHOPIFY_REFUND_GROSS_PERCENT,
-    MEASURE.SHOPIFY_REFUND_NET_PERCENT,
-    MEASURE.SHOPIFY_REFUND_RATE,
-    MEASURE.SHOPIFY_DISCOUNT_AMOUNT,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_DISCOUNT_AMOUNT,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_DISCOUNT_AMOUNT,
-    MEASURE.SHOPIFY_DISCOUNTS,
-    MEASURE.SHOPIFY_DISCOUNT_GROSS_PERCENT,
-    MEASURE.SHOPIFY_DISCOUNT_RATE,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_DISCOUNT_GROSS_PERCENT,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_DISCOUNT_GROSS_PERCENT,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_DISCOUNT_RATE,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_DISCOUNT_RATE,
-    MEASURE.SHOPIFY_REFUND_PLUS_DISCOUNT_AMOUNT,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_REFUND_PLUS_DISCOUNT_AMOUNT,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_REFUND_PLUS_DISCOUNT_AMOUNT,
-    MEASURE.SHOPIFY_AVG_ORDERS_PER_CUSTOMER,
-    MEASURE.SHOPIFY_NEW_CUSTOMERS,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMERS,
-    MEASURE.SHOPIFY_NEW_CUSTOMER_GROSS_PERCENT,
-    MEASURE.SHOPIFY_RETURNING_CUSTOMER_GROSS_PERCENT,
-    MEASURE.SHOPIFY_SUBTOTAL_AMOUNT,
-    MEASURE.SHOPIFY_NET_PLUS_SHIPPING_AMOUNT,
-    MEASURE.SHOPIFY_CANCELLED_ORDERS,
-    MEASURE.SHOPIFY_CANCELLED_AMOUNT,
-    MEASURE.SHOPIFY_TAX_AMOUNT,
-    MEASURE.SHOPIFY_SHIPPING_AMOUNT,
-    MEASURE.SHOPIFY_PRODUCT_UNITS_SOLD,
-    MEASURE.SHOPIFY_TOP_PRODUCTS,
-    MEASURE.SHOPIFY_LTV,
-    MEASURE.SHOPIFY_LTV_90,
-    MEASURE.SHOPIFY_LTV_180,
-    MEASURE.SHOPIFY_LTV_365,
-    MEASURE.SHOPIFY_LTV_COHORT_GROSS_SALE_PRICE,
-    MEASURE.SHOPIFY_LTV_COHORT_NET_SALE_PRICE,
-    MEASURE.SHOPIFY_CUSTOMERS_COHORT,
-    MEASURE.SHOPIFY_CUSTOMERS_RETENTION_RATE_COHORT,
-    MEASURE.SHOPIFY_AVG_ORDER_VALUE_COHORT,
-    MEASURE.CORE_CPA,
-    MEASURE.CORE_NEW_CUSTOMER_CPA,
-    MEASURE.CORE_RETURNING_CUSTOMER_CPA,
-    MEASURE.CORE_ROAS_GROSS,
-    MEASURE.CORE_ROAS_NET,
-    MEASURE.CORE_ROAS_TOTAL,
-    MEASURE.CORE_NEW_CUSTOMER_ROAS_GROSS,
-    MEASURE.CORE_NEW_CUSTOMER_ROAS_NET,
-    MEASURE.CORE_NEW_CUSTOMER_ROAS_TOTAL,
-    MEASURE.CORE_MER_GROSS,
-    MEASURE.CORE_MER_NET,
-    MEASURE.CORE_MER,
-    MEASURE.CORE_NEW_CUSTOMER_MER_GROSS,
-    MEASURE.CORE_NEW_CUSTOMER_MER_NET,
-    MEASURE.CORE_RAAD,
-    MEASURE.CORE_RAAD_GROSS,
-    MEASURE.CORE_RAAD_NET,
-    MEASURE.CORE_RAAD_GROSS_PERCENT,
-    MEASURE.CORE_RAAD_NET_PERCENT,
-    MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS,
-    MEASURE.CORE_NEW_CUSTOMER_RAAD_NET,
-    MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS_PERCENT,
-    MEASURE.CORE_NEW_CUSTOMER_RAAD_NET_PERCENT,
-    MEASURE.CHANNEL_ADD_TO_WITHLISTS,
-    MEASURE.CHANNEL_ADD_TO_WITHLISTS_VALUE,
-    MEASURE.CHANNEL_ADD_TO_WITHLISTS_COST,
-    MEASURE.CHANNEL_OMNI_ADD_TO_WITHLISTS,
-    MEASURE.CHANNEL_OMNI_ADD_TO_WITHLISTS_VALUE,
-    MEASURE.CHANNEL_OMNI_ADD_TO_WITHLISTS_COST,
-    MEASURE.CHANNEL_OMNI_ADD_TO_WISHLISTS,
-    MEASURE.CHANNEL_OMNI_ADD_TO_WISHLISTS_VALUE,
-    MEASURE.CHANNEL_OMNI_ADD_TO_WISHLISTS_COST,
-    MEASURE.ORDERS_NEW_CUSTOMER_GROSS_MARGIN_GROSS_RATE,
-    MEASURE.ORDERS_RETURNING_CUSTOMER_GROSS_MARGIN_GROSS_RATE,
-    MEASURE.ORDERS_NEW_CUSTOMER_GROSS_MARGIN_NET_RATE,
-    MEASURE.ORDERS_RETURNING_CUSTOMER_GROSS_MARGIN_NET_RATE,
-    MEASURE.ORDERS_NEW_CUSTOMER_NET_MARGIN_GROSS_RATE,
-    MEASURE.ORDERS_RETURNING_CUSTOMER_NET_MARGIN_GROSS_RATE,
-    MEASURE.ORDERS_NEW_CUSTOMER_NET_MARGIN_NET_RATE,
-    MEASURE.ORDERS_RETURNING_CUSTOMER_NET_MARGIN_NET_RATE,
-]);
-describe('MEASURE_ALIAS_MAP', () => {
-    const buildAliasMapFromDefinitions = () => {
-        const aliasMap = new Map();
-        for (const [measureKey, definition] of Object.entries(MEASURES_MAP)) {
-            if (definition.aliases && definition.aliases.length > 0) {
-                const canonicalMeasure = measureKey;
-                for (const alias of definition.aliases) {
-                    aliasMap.set(alias, canonicalMeasure);
-                }
-            }
-        }
-        return aliasMap;
-    };
-    describe('consistency with MeasureDefinition aliases', () => {
-        it('should contain all aliases defined in MeasureDefinition.aliases fields', () => {
-            const expectedFromDefinitions = buildAliasMapFromDefinitions();
-            const missingInAliasMap = [];
-            expectedFromDefinitions.forEach((canonical, alias) => {
-                if (!(alias in MEASURE_ALIAS_MAP)) {
-                    missingInAliasMap.push(`[MEASURE.${alias}]: MEASURE.${canonical}`);
-                }
-            });
-            if (missingInAliasMap.length > 0) {
-                console.log('\n=== Missing in MEASURE_ALIAS_MAP ===');
-                missingInAliasMap.forEach((entry) => console.log(`  ${entry},`));
-            }
-            expect(missingInAliasMap).toEqual([]);
-        });
-        it('should only contain aliases from MeasureDefinition.aliases OR known migration aliases', () => {
-            const expectedFromDefinitions = buildAliasMapFromDefinitions();
-            const unexpectedInAliasMap = [];
-            for (const [alias, canonical] of Object.entries(MEASURE_ALIAS_MAP)) {
-                const isFromDefinitions = expectedFromDefinitions.has(alias);
-                const isMigrationAlias = CROSS_NAMESPACE_MIGRATION_ALIASES.has(alias);
-                if (!isFromDefinitions && !isMigrationAlias) {
-                    unexpectedInAliasMap.push(`${alias} → ${canonical}`);
-                }
-            }
-            if (unexpectedInAliasMap.length > 0) {
-                console.log('\n=== Unexpected aliases in MEASURE_ALIAS_MAP ===');
-                unexpectedInAliasMap.forEach((entry) => console.log(`  ${entry}`));
-            }
-            expect(unexpectedInAliasMap).toEqual([]);
-        });
-        it('should map aliases to the same canonical measure as MeasureDefinition.aliases (where applicable)', () => {
-            const expectedFromDefinitions = buildAliasMapFromDefinitions();
-            const mismatches = [];
-            for (const [alias, canonical] of Object.entries(MEASURE_ALIAS_MAP)) {
-                if (CROSS_NAMESPACE_MIGRATION_ALIASES.has(alias)) {
-                    continue;
-                }
-                const expectedCanonical = expectedFromDefinitions.get(alias);
-                if (expectedCanonical && expectedCanonical !== canonical) {
-                    mismatches.push(`${alias}: expected ${expectedCanonical}, got ${canonical}`);
-                }
-            }
-            if (mismatches.length > 0) {
-                console.log('\n=== Canonical measure mismatches ===');
-                mismatches.forEach((entry) => console.log(`  ${entry}`));
-            }
-            expect(mismatches).toEqual([]);
-        });
-        it('should have correct number of entries (definitions + migration aliases - overlap)', () => {
-            const expectedFromDefinitions = buildAliasMapFromDefinitions();
-            const aliasMapSize = Object.keys(MEASURE_ALIAS_MAP).length;
-            const definitionsSize = expectedFromDefinitions.size;
-            const migrationAliasesSize = CROSS_NAMESPACE_MIGRATION_ALIASES.size;
-            let overlap = 0;
-            expectedFromDefinitions.forEach((_, alias) => {
-                if (CROSS_NAMESPACE_MIGRATION_ALIASES.has(alias)) {
-                    overlap++;
-                }
-            });
-            const expectedTotal = definitionsSize + migrationAliasesSize - overlap;
-            if (aliasMapSize !== expectedTotal) {
-                console.log('\n=== Size mismatch ===');
-                console.log(`  MEASURE_ALIAS_MAP has ${aliasMapSize} entries`);
-                console.log(`  MeasureDefinition.aliases has ${definitionsSize} total aliases`);
-                console.log(`  Cross-namespace migration aliases: ${migrationAliasesSize}`);
-                console.log(`  Overlap (in both sets): ${overlap}`);
-                console.log(`  Expected total: ${expectedTotal}`);
-            }
-            expect(aliasMapSize).toBe(expectedTotal);
-        });
-    });
-    describe('resolveAlias()', () => {
-        it('should resolve alias to canonical measure', () => {
-            expect(resolveAlias(MEASURE.CORE_ROAS)).toBe(MEASURE.CORE_ROAS_TOTAL);
-            expect(resolveAlias(MEASURE.SHOPIFY_AOV)).toBe(MEASURE.ORDERS_GROSS_AOV);
-            expect(resolveAlias(MEASURE.SHOPIFY_TOTAL_AMOUNT)).toBe(MEASURE.ORDERS_TOTAL_REVENUE);
-        });
-        it('should return canonical measure unchanged', () => {
-            expect(resolveAlias(MEASURE.ORDERS_TOTAL_ROAS)).toBe(MEASURE.ORDERS_TOTAL_ROAS);
-            expect(resolveAlias(MEASURE.ORDERS_TOTAL_AOV)).toBe(MEASURE.ORDERS_TOTAL_AOV);
-            expect(resolveAlias(MEASURE.CHANNEL_SPEND)).toBe(MEASURE.CHANNEL_SPEND);
-        });
-        it('should return any unknown measure unchanged', () => {
-            expect(resolveAlias(MEASURE.TRACKED_PAGE_VIEWS)).toBe(MEASURE.TRACKED_PAGE_VIEWS);
-        });
-        it('should resolve SHOPIFY measures to ORDERS measures', () => {
-            expect(resolveAlias(MEASURE.SHOPIFY_TOTAL_AOV)).toBe(MEASURE.ORDERS_TOTAL_AOV);
-            expect(resolveAlias(MEASURE.SHOPIFY_GROSS_AOV)).toBe(MEASURE.ORDERS_GROSS_AOV);
-            expect(resolveAlias(MEASURE.SHOPIFY_TOTAL_REVENUE)).toBe(MEASURE.ORDERS_TOTAL_REVENUE);
-            expect(resolveAlias(MEASURE.SHOPIFY_ORDERS)).toBe(MEASURE.ORDERS_COUNT);
-        });
-    });
-    describe('isAlias()', () => {
-        it('should return true for aliases', () => {
-            expect(isAlias(MEASURE.CORE_ROAS)).toBe(true);
-            expect(isAlias(MEASURE.SHOPIFY_AOV)).toBe(true);
-            expect(isAlias(MEASURE.CHANNEL_PURCHASES_COST)).toBe(true);
-        });
-        it('should return true for SHOPIFY→ORDERS migration aliases', () => {
-            expect(isAlias(MEASURE.SHOPIFY_GROSS_AOV)).toBe(true);
-            expect(isAlias(MEASURE.SHOPIFY_TOTAL_REVENUE)).toBe(true);
-            expect(isAlias(MEASURE.SHOPIFY_ORDERS)).toBe(true);
-        });
-        it('should return false for canonical measures', () => {
-            expect(isAlias(MEASURE.ORDERS_TOTAL_ROAS)).toBe(false);
-            expect(isAlias(MEASURE.ORDERS_GROSS_AOV)).toBe(false);
-            expect(isAlias(MEASURE.CHANNEL_CPA)).toBe(false);
-        });
-    });
-    describe('getAliasesFor()', () => {
-        it('should return all SHOPIFY aliases that map to ORDERS_TOTAL_REVENUE', () => {
-            const aliases = getAliasesFor(MEASURE.ORDERS_TOTAL_REVENUE);
-            expect(aliases).toContain(MEASURE.SHOPIFY_TOTAL_REVENUE);
-            expect(aliases).toContain(MEASURE.SHOPIFY_TOTAL_AMOUNT);
-            expect(aliases).toContain(MEASURE.SHOPIFY_REVENUE);
-            expect(aliases).toContain(MEASURE.SHOPIFY_TOTAL_SALES);
-            expect(aliases.length).toBeGreaterThanOrEqual(4);
-        });
-        it('should return all aliases for CORE_ROAS_TOTAL', () => {
-            const aliases = getAliasesFor(MEASURE.CORE_ROAS_TOTAL);
-            expect(aliases).toContain(MEASURE.CORE_ROAS);
-            expect(aliases).toHaveLength(1);
-        });
-        it('should return all aliases for ORDERS_COUNT', () => {
-            const aliases = getAliasesFor(MEASURE.ORDERS_COUNT);
-            expect(aliases).toContain(MEASURE.SHOPIFY_ORDERS);
-            expect(aliases).toHaveLength(1);
-        });
-        it('should return empty array for measure with no aliases', () => {
-            const aliases = getAliasesFor(MEASURE.CHANNEL_SPEND);
-            expect(aliases).toEqual([]);
-        });
-    });
-    describe('diagnostic: generate expected map from definitions', () => {
-        it('should log all expected aliases from definitions for reference', () => {
-            const aliasEntries = [];
-            for (const [measureKey, definition] of Object.entries(MEASURES_MAP)) {
-                if (definition.aliases && definition.aliases.length > 0) {
-                    for (const alias of definition.aliases) {
-                        aliasEntries.push({ alias, canonical: measureKey });
-                    }
-                }
-            }
-            console.log(`\n=== All aliases from MeasureDefinition (${aliasEntries.length} total) ===`);
-            expect(aliasEntries.length).toBeGreaterThan(0);
-        });
-    });
-});
+import { MEASURE_ALIAS_MAP, resolveAlias, isAlias, getAliasesFor } from '../types/api/measures/measure-alias-map';
+import { MEASURES_MAP } from '../types/api/measures/definitions/measure-definitions';
+import { MEASURE } from '../types/api/measures/measures';
+const CROSS_NAMESPACE_MIGRATION_ALIASES = new Set([
+    MEASURE.SHOPIFY_ORDERS,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_ORDERS,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_ORDERS,
+    MEASURE.SHOPIFY_CUSTOMERS,
+    MEASURE.SHOPIFY_TOTAL_REVENUE,
+    MEASURE.SHOPIFY_TOTAL_AMOUNT,
+    MEASURE.SHOPIFY_REVENUE,
+    MEASURE.SHOPIFY_TOTAL_SALES,
+    MEASURE.SHOPIFY_GROSS_SALES,
+    MEASURE.SHOPIFY_NET_SALES,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_TOTAL_REVENUE,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_TOTAL_AMOUNT,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_TOTAL_SALES,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_REVENUE,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_GROSS_SALES,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_NET_SALES,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_TOTAL_REVENUE,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_TOTAL_AMOUNT,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_TOTAL_SALES,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_REVENUE,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_GROSS_SALES,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_NET_SALES,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_RATE,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_RATE,
+    MEASURE.SHOPIFY_REPEAT_CUSTOMER_RATE,
+    MEASURE.SHOPIFY_TOTAL_AOV,
+    MEASURE.SHOPIFY_GROSS_AOV,
+    MEASURE.SHOPIFY_AOV,
+    MEASURE.SHOPIFY_NET_AOV,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_GROSS_AOV,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_AOV,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_NET_AOV,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_TOTAL_AOV,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_GROSS_AOV,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_AOV,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_NET_AOV,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_TOTAL_AOV,
+    MEASURE.SHOPIFY_ORDER_TOTAL_PRODUCT_COST,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_ORDER_TOTAL_PRODUCT_COST,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_ORDER_TOTAL_PRODUCT_COST,
+    MEASURE.SHOPIFY_ORDER_TOTAL_PRODUCT_COST_GROSS_PERCENT,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_ORDER_TOTAL_PRODUCT_COST_GROSS_PERCENT,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_ORDER_TOTAL_PRODUCT_COST_GROSS_PERCENT,
+    MEASURE.SHOPIFY_ORDER_TOTAL_PRODUCT_COST_NET_PERCENT,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_ORDER_TOTAL_PRODUCT_COST_NET_PERCENT,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_ORDER_TOTAL_PRODUCT_COST_NET_PERCENT,
+    MEASURE.SHOPIFY_GROSS_MARGIN,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_GROSS_MARGIN,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_GROSS_MARGIN,
+    MEASURE.SHOPIFY_GROSS_MARGIN_GROSS_PERCENT,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_GROSS_MARGIN_GROSS_PERCENT,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_GROSS_MARGIN_GROSS_PERCENT,
+    MEASURE.SHOPIFY_GROSS_MARGIN_NET_PERCENT,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_GROSS_MARGIN_NET_PERCENT,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_GROSS_MARGIN_NET_PERCENT,
+    MEASURE.SHOPIFY_NET_MARGIN,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_NET_MARGIN,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_NET_MARGIN,
+    MEASURE.SHOPIFY_NET_MARGIN_GROSS_PERCENT,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_NET_MARGIN_GROSS_PERCENT,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_NET_MARGIN_GROSS_PERCENT,
+    MEASURE.SHOPIFY_NET_MARGIN_NET_PERCENT,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_NET_MARGIN_NET_PERCENT,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_NET_MARGIN_NET_PERCENT,
+    MEASURE.SHOPIFY_GROSS_PRODUCT_MARGIN,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_GROSS_PRODUCT_MARGIN,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_GROSS_PRODUCT_MARGIN,
+    MEASURE.SHOPIFY_GROSS_PRODUCT_MARGIN_GROSS_PERCENT,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_GROSS_PRODUCT_MARGIN_GROSS_PERCENT,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_GROSS_PRODUCT_MARGIN_GROSS_PERCENT,
+    MEASURE.SHOPIFY_GROSS_PRODUCT_MARGIN_NET_PERCENT,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_GROSS_PRODUCT_MARGIN_NET_PERCENT,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_GROSS_PRODUCT_MARGIN_NET_PERCENT,
+    MEASURE.SHOPIFY_NET_PRODUCT_MARGIN,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_NET_PRODUCT_MARGIN,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_NET_PRODUCT_MARGIN,
+    MEASURE.SHOPIFY_NET_PRODUCT_MARGIN_GROSS_PERCENT,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_NET_PRODUCT_MARGIN_GROSS_PERCENT,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_NET_PRODUCT_MARGIN_GROSS_PERCENT,
+    MEASURE.SHOPIFY_NET_PRODUCT_MARGIN_NET_PERCENT,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_NET_PRODUCT_MARGIN_NET_PERCENT,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_NET_PRODUCT_MARGIN_NET_PERCENT,
+    MEASURE.SHOPIFY_REFUNDS,
+    MEASURE.SHOPIFY_REFUND_AMOUNT_REFUND_DATE,
+    MEASURE.SHOPIFY_REFUND_AMOUNT_ORDER_DATE,
+    MEASURE.SHOPIFY_REFUND_GROSS_PERCENT,
+    MEASURE.SHOPIFY_REFUND_NET_PERCENT,
+    MEASURE.SHOPIFY_REFUND_RATE,
+    MEASURE.SHOPIFY_DISCOUNT_AMOUNT,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_DISCOUNT_AMOUNT,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_DISCOUNT_AMOUNT,
+    MEASURE.SHOPIFY_DISCOUNTS,
+    MEASURE.SHOPIFY_DISCOUNT_GROSS_PERCENT,
+    MEASURE.SHOPIFY_DISCOUNT_RATE,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_DISCOUNT_GROSS_PERCENT,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_DISCOUNT_GROSS_PERCENT,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_DISCOUNT_RATE,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_DISCOUNT_RATE,
+    MEASURE.SHOPIFY_REFUND_PLUS_DISCOUNT_AMOUNT,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_REFUND_PLUS_DISCOUNT_AMOUNT,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_REFUND_PLUS_DISCOUNT_AMOUNT,
+    MEASURE.SHOPIFY_AVG_ORDERS_PER_CUSTOMER,
+    MEASURE.SHOPIFY_NEW_CUSTOMERS,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMERS,
+    MEASURE.SHOPIFY_NEW_CUSTOMER_GROSS_PERCENT,
+    MEASURE.SHOPIFY_RETURNING_CUSTOMER_GROSS_PERCENT,
+    MEASURE.SHOPIFY_SUBTOTAL_AMOUNT,
+    MEASURE.SHOPIFY_NET_PLUS_SHIPPING_AMOUNT,
+    MEASURE.SHOPIFY_CANCELLED_ORDERS,
+    MEASURE.SHOPIFY_CANCELLED_AMOUNT,
+    MEASURE.SHOPIFY_TAX_AMOUNT,
+    MEASURE.SHOPIFY_SHIPPING_AMOUNT,
+    MEASURE.SHOPIFY_PRODUCT_UNITS_SOLD,
+    MEASURE.SHOPIFY_TOP_PRODUCTS,
+    MEASURE.SHOPIFY_LTV,
+    MEASURE.SHOPIFY_LTV_90,
+    MEASURE.SHOPIFY_LTV_180,
+    MEASURE.SHOPIFY_LTV_365,
+    MEASURE.SHOPIFY_LTV_COHORT_GROSS_SALE_PRICE,
+    MEASURE.SHOPIFY_LTV_COHORT_NET_SALE_PRICE,
+    MEASURE.SHOPIFY_CUSTOMERS_COHORT,
+    MEASURE.SHOPIFY_CUSTOMERS_RETENTION_RATE_COHORT,
+    MEASURE.SHOPIFY_AVG_ORDER_VALUE_COHORT,
+    MEASURE.CORE_CPA,
+    MEASURE.CORE_NEW_CUSTOMER_CPA,
+    MEASURE.CORE_RETURNING_CUSTOMER_CPA,
+    MEASURE.CORE_ROAS_GROSS,
+    MEASURE.CORE_ROAS_NET,
+    MEASURE.CORE_ROAS_TOTAL,
+    MEASURE.CORE_NEW_CUSTOMER_ROAS_GROSS,
+    MEASURE.CORE_NEW_CUSTOMER_ROAS_NET,
+    MEASURE.CORE_NEW_CUSTOMER_ROAS_TOTAL,
+    MEASURE.CORE_MER_GROSS,
+    MEASURE.CORE_MER_NET,
+    MEASURE.CORE_MER,
+    MEASURE.CORE_NEW_CUSTOMER_MER_GROSS,
+    MEASURE.CORE_NEW_CUSTOMER_MER_NET,
+    MEASURE.CORE_RAAD,
+    MEASURE.CORE_RAAD_GROSS,
+    MEASURE.CORE_RAAD_NET,
+    MEASURE.CORE_RAAD_GROSS_PERCENT,
+    MEASURE.CORE_RAAD_NET_PERCENT,
+    MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS,
+    MEASURE.CORE_NEW_CUSTOMER_RAAD_NET,
+    MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS_PERCENT,
+    MEASURE.CORE_NEW_CUSTOMER_RAAD_NET_PERCENT,
+    MEASURE.CHANNEL_ADD_TO_WITHLISTS,
+    MEASURE.CHANNEL_ADD_TO_WITHLISTS_VALUE,
+    MEASURE.CHANNEL_ADD_TO_WITHLISTS_COST,
+    MEASURE.CHANNEL_OMNI_ADD_TO_WITHLISTS,
+    MEASURE.CHANNEL_OMNI_ADD_TO_WITHLISTS_VALUE,
+    MEASURE.CHANNEL_OMNI_ADD_TO_WITHLISTS_COST,
+    MEASURE.CHANNEL_OMNI_ADD_TO_WISHLISTS,
+    MEASURE.CHANNEL_OMNI_ADD_TO_WISHLISTS_VALUE,
+    MEASURE.CHANNEL_OMNI_ADD_TO_WISHLISTS_COST,
+]);
+describe('MEASURE_ALIAS_MAP', () => {
+    const buildAliasMapFromDefinitions = () => {
+        const aliasMap = new Map();
+        for (const [measureKey, definition] of Object.entries(MEASURES_MAP)) {
+            if (definition.aliases && definition.aliases.length > 0) {
+                const canonicalMeasure = measureKey;
+                for (const alias of definition.aliases) {
+                    aliasMap.set(alias, canonicalMeasure);
+                }
+            }
+        }
+        return aliasMap;
+    };
+    describe('consistency with MeasureDefinition aliases', () => {
+        it('should contain all aliases defined in MeasureDefinition.aliases fields', () => {
+            const expectedFromDefinitions = buildAliasMapFromDefinitions();
+            const missingInAliasMap = [];
+            expectedFromDefinitions.forEach((canonical, alias) => {
+                if (!(alias in MEASURE_ALIAS_MAP)) {
+                    missingInAliasMap.push(`[MEASURE.${alias}]: MEASURE.${canonical}`);
+                }
+            });
+            if (missingInAliasMap.length > 0) {
+                console.log('\n=== Missing in MEASURE_ALIAS_MAP ===');
+                missingInAliasMap.forEach((entry) => console.log(`  ${entry},`));
+            }
+            expect(missingInAliasMap).toEqual([]);
+        });
+        it('should only contain aliases from MeasureDefinition.aliases OR known migration aliases', () => {
+            const expectedFromDefinitions = buildAliasMapFromDefinitions();
+            const unexpectedInAliasMap = [];
+            for (const [alias, canonical] of Object.entries(MEASURE_ALIAS_MAP)) {
+                const isFromDefinitions = expectedFromDefinitions.has(alias);
+                const isMigrationAlias = CROSS_NAMESPACE_MIGRATION_ALIASES.has(alias);
+                if (!isFromDefinitions && !isMigrationAlias) {
+                    unexpectedInAliasMap.push(`${alias} → ${canonical}`);
+                }
+            }
+            if (unexpectedInAliasMap.length > 0) {
+                console.log('\n=== Unexpected aliases in MEASURE_ALIAS_MAP ===');
+                unexpectedInAliasMap.forEach((entry) => console.log(`  ${entry}`));
+            }
+            expect(unexpectedInAliasMap).toEqual([]);
+        });
+        it('should map aliases to the same canonical measure as MeasureDefinition.aliases (where applicable)', () => {
+            const expectedFromDefinitions = buildAliasMapFromDefinitions();
+            const mismatches = [];
+            for (const [alias, canonical] of Object.entries(MEASURE_ALIAS_MAP)) {
+                if (CROSS_NAMESPACE_MIGRATION_ALIASES.has(alias)) {
+                    continue;
+                }
+                const expectedCanonical = expectedFromDefinitions.get(alias);
+                if (expectedCanonical && expectedCanonical !== canonical) {
+                    mismatches.push(`${alias}: expected ${expectedCanonical}, got ${canonical}`);
+                }
+            }
+            if (mismatches.length > 0) {
+                console.log('\n=== Canonical measure mismatches ===');
+                mismatches.forEach((entry) => console.log(`  ${entry}`));
+            }
+            expect(mismatches).toEqual([]);
+        });
+        it('should have correct number of entries (definitions + migration aliases - overlap)', () => {
+            const expectedFromDefinitions = buildAliasMapFromDefinitions();
+            const aliasMapSize = Object.keys(MEASURE_ALIAS_MAP).length;
+            const definitionsSize = expectedFromDefinitions.size;
+            const migrationAliasesSize = CROSS_NAMESPACE_MIGRATION_ALIASES.size;
+            let overlap = 0;
+            expectedFromDefinitions.forEach((_, alias) => {
+                if (CROSS_NAMESPACE_MIGRATION_ALIASES.has(alias)) {
+                    overlap++;
+                }
+            });
+            const expectedTotal = definitionsSize + migrationAliasesSize - overlap;
+            if (aliasMapSize !== expectedTotal) {
+                console.log('\n=== Size mismatch ===');
+                console.log(`  MEASURE_ALIAS_MAP has ${aliasMapSize} entries`);
+                console.log(`  MeasureDefinition.aliases has ${definitionsSize} total aliases`);
+                console.log(`  Cross-namespace migration aliases: ${migrationAliasesSize}`);
+                console.log(`  Overlap (in both sets): ${overlap}`);
+                console.log(`  Expected total: ${expectedTotal}`);
+            }
+            expect(aliasMapSize).toBe(expectedTotal);
+        });
+    });
+    describe('resolveAlias()', () => {
+        it('should resolve alias to canonical measure', () => {
+            expect(resolveAlias(MEASURE.CORE_ROAS)).toBe(MEASURE.CORE_ROAS_TOTAL);
+            expect(resolveAlias(MEASURE.SHOPIFY_AOV)).toBe(MEASURE.ORDERS_GROSS_AOV);
+            expect(resolveAlias(MEASURE.SHOPIFY_TOTAL_AMOUNT)).toBe(MEASURE.ORDERS_TOTAL_REVENUE);
+        });
+        it('should return canonical measure unchanged', () => {
+            expect(resolveAlias(MEASURE.ORDERS_TOTAL_ROAS)).toBe(MEASURE.ORDERS_TOTAL_ROAS);
+            expect(resolveAlias(MEASURE.ORDERS_TOTAL_AOV)).toBe(MEASURE.ORDERS_TOTAL_AOV);
+            expect(resolveAlias(MEASURE.CHANNEL_SPEND)).toBe(MEASURE.CHANNEL_SPEND);
+        });
+        it('should return any unknown measure unchanged', () => {
+            expect(resolveAlias(MEASURE.TRACKED_PAGE_VIEWS)).toBe(MEASURE.TRACKED_PAGE_VIEWS);
+        });
+        it('should resolve SHOPIFY measures to ORDERS measures', () => {
+            expect(resolveAlias(MEASURE.SHOPIFY_TOTAL_AOV)).toBe(MEASURE.ORDERS_TOTAL_AOV);
+            expect(resolveAlias(MEASURE.SHOPIFY_GROSS_AOV)).toBe(MEASURE.ORDERS_GROSS_AOV);
+            expect(resolveAlias(MEASURE.SHOPIFY_TOTAL_REVENUE)).toBe(MEASURE.ORDERS_TOTAL_REVENUE);
+            expect(resolveAlias(MEASURE.SHOPIFY_ORDERS)).toBe(MEASURE.ORDERS_COUNT);
+        });
+    });
+    describe('isAlias()', () => {
+        it('should return true for aliases', () => {
+            expect(isAlias(MEASURE.CORE_ROAS)).toBe(true);
+            expect(isAlias(MEASURE.SHOPIFY_AOV)).toBe(true);
+            expect(isAlias(MEASURE.CHANNEL_PURCHASES_COST)).toBe(true);
+        });
+        it('should return true for SHOPIFY→ORDERS migration aliases', () => {
+            expect(isAlias(MEASURE.SHOPIFY_GROSS_AOV)).toBe(true);
+            expect(isAlias(MEASURE.SHOPIFY_TOTAL_REVENUE)).toBe(true);
+            expect(isAlias(MEASURE.SHOPIFY_ORDERS)).toBe(true);
+        });
+        it('should return false for canonical measures', () => {
+            expect(isAlias(MEASURE.ORDERS_TOTAL_ROAS)).toBe(false);
+            expect(isAlias(MEASURE.ORDERS_GROSS_AOV)).toBe(false);
+            expect(isAlias(MEASURE.CHANNEL_CPA)).toBe(false);
+        });
+    });
+    describe('getAliasesFor()', () => {
+        it('should return all SHOPIFY aliases that map to ORDERS_TOTAL_REVENUE', () => {
+            const aliases = getAliasesFor(MEASURE.ORDERS_TOTAL_REVENUE);
+            expect(aliases).toContain(MEASURE.SHOPIFY_TOTAL_REVENUE);
+            expect(aliases).toContain(MEASURE.SHOPIFY_TOTAL_AMOUNT);
+            expect(aliases).toContain(MEASURE.SHOPIFY_REVENUE);
+            expect(aliases).toContain(MEASURE.SHOPIFY_TOTAL_SALES);
+            expect(aliases.length).toBeGreaterThanOrEqual(4);
+        });
+        it('should return all aliases for CORE_ROAS_TOTAL', () => {
+            const aliases = getAliasesFor(MEASURE.CORE_ROAS_TOTAL);
+            expect(aliases).toContain(MEASURE.CORE_ROAS);
+            expect(aliases).toHaveLength(1);
+        });
+        it('should return all aliases for ORDERS_COUNT', () => {
+            const aliases = getAliasesFor(MEASURE.ORDERS_COUNT);
+            expect(aliases).toContain(MEASURE.SHOPIFY_ORDERS);
+            expect(aliases).toHaveLength(1);
+        });
+        it('should return empty array for measure with no aliases', () => {
+            const aliases = getAliasesFor(MEASURE.CHANNEL_SPEND);
+            expect(aliases).toEqual([]);
+        });
+    });
+    describe('diagnostic: generate expected map from definitions', () => {
+        it('should log all expected aliases from definitions for reference', () => {
+            const aliasEntries = [];
+            for (const [measureKey, definition] of Object.entries(MEASURES_MAP)) {
+                if (definition.aliases && definition.aliases.length > 0) {
+                    for (const alias of definition.aliases) {
+                        aliasEntries.push({ alias, canonical: measureKey });
+                    }
+                }
+            }
+            console.log(`\n=== All aliases from MeasureDefinition (${aliasEntries.length} total) ===`);
+            expect(aliasEntries.length).toBeGreaterThan(0);
+        });
+    });
+});
 //# sourceMappingURL=measure-alias-map.spec.js.map