@walkeros/explorer 3.1.0 → 3.1.1

package/dist/utils/path-analyzer.js

@@ -1,215 +0,0 @@
-/**
- * Type guard: Check if value is a Rule object
- */
-export function isRule(value) {
-    if (!value || typeof value !== 'object')
-        return false;
-    const obj = value;
-    // Rule has specific properties that ValueConfig doesn't have
-    const ruleOnlyProps = [
-        'name',
-        'batch',
-        'ignore',
-        'settings',
-        'batchFn',
-        'batched',
-    ];
-    const valueConfigOnlyProps = ['key', 'fn', 'loop', 'set', 'validate'];
-    const hasRuleProps = ruleOnlyProps.some((p) => p in obj);
-    const hasValueConfigProps = valueConfigOnlyProps.some((p) => p in obj);
-    // If it has rule-specific properties and no ValueConfig-only properties, it's a Rule
-    return hasRuleProps && !hasValueConfigProps;
-}
-/**
- * Type guard: Check if value is a ValueConfig object
- */
-export function isValueConfig(value) {
-    if (!value || typeof value !== 'object')
-        return false;
-    const obj = value;
-    // ValueConfig markers - if ANY of these exist, it's a ValueConfig
-    const markers = [
-        'key',
-        'value',
-        'fn',
-        'map',
-        'loop',
-        'set',
-        'consent',
-        'condition',
-        'validate',
-    ];
-    return markers.some((m) => m in obj);
-}
-/**
- * Type guard: Check if value is a Map object (plain object inside ValueConfig.map)
- */
-export function isMapObject(value) {
-    if (!value || typeof value !== 'object' || Array.isArray(value))
-        return false;
-    // A map is a plain object. We differentiate it from ValueConfig by checking
-    // if it has ValueConfig markers. If no markers, it's a map.
-    return !isValueConfig(value) && !isRule(value);
-}
-/**
- * Analyze a path through the mapping configuration
- *
- * Walks through the config structure, inspecting values at each step to
- * determine the semantic type and context.
- *
- * @param path - Array of path segments (e.g., ['page', 'view', 'data', 'map', 'page_location', 'consent'])
- * @param config - The mapping configuration object
- * @returns Complete analysis of the path
- *
- * @example
- * const analysis = analyzePath(['page', 'view', 'consent'], config);
- * // analysis.isRuleLevel === true (consent at rule level)
- *
- * @example
- * const analysis = analyzePath(['page', 'view', 'data', 'map', 'items', 'consent'], config);
- * // analysis.isValueConfigLevel === true (consent at ValueConfig level)
- */
-export function analyzePath(path, config) {
-    const segments = [];
-    // Handle empty path (overview)
-    if (path.length === 0) {
-        return {
-            segments: [],
-            finalValue: config,
-            finalContext: 'overview',
-            isRuleLevel: false,
-            isValueConfigLevel: false,
-        };
-    }
-    let current = config;
-    let parent = null;
-    // Walk through each segment
-    for (let i = 0; i < path.length; i++) {
-        const segment = path[i];
-        parent = current;
-        // Validate we can navigate
-        if (!current || typeof current !== 'object') {
-            throw new Error(`Cannot navigate path at index ${i}: value is not an object`);
-        }
-        const obj = current;
-        current = obj[segment];
-        // Determine structural type based on context
-        let structuralType;
-        if (i === 0) {
-            // First segment is always entity
-            structuralType = 'entity';
-        }
-        else if (i === 1) {
-            // Second segment is always action (points to Rule)
-            structuralType = 'action';
-        }
-        else {
-            // For deeper levels, inspect parent to determine type
-            if (isRule(parent)) {
-                structuralType = 'ruleProperty';
-            }
-            else if (isValueConfig(parent)) {
-                structuralType = 'valueConfigProperty';
-            }
-            else if (Array.isArray(parent)) {
-                structuralType = 'arrayIndex';
-            }
-            else {
-                // Must be a map object
-                structuralType = 'mapKey';
-            }
-        }
-        segments.push({
-            segment,
-            index: i,
-            structuralType,
-            value: current,
-            parentValue: parent,
-        });
-    }
-    // Determine final context and metadata
-    const lastSegment = segments[segments.length - 1];
-    const finalValue = lastSegment.value;
-    const parentValue = lastSegment.parentValue;
-    let finalContext;
-    let isRuleLevel = false;
-    let isValueConfigLevel = false;
-    let propertyName;
-    if (path.length === 1) {
-        finalContext = 'entity';
-    }
-    else if (path.length === 2) {
-        finalContext = 'rule';
-    }
-    else {
-        // Deep path - determine based on structural type
-        switch (lastSegment.structuralType) {
-            case 'ruleProperty':
-                finalContext = 'ruleProperty';
-                isRuleLevel = true;
-                propertyName = lastSegment.segment;
-                break;
-            case 'valueConfigProperty':
-                finalContext = 'valueConfigProperty';
-                isValueConfigLevel = true;
-                propertyName = lastSegment.segment;
-                break;
-            case 'mapKey':
-                // A map key holds a Value (string or ValueConfig)
-                if (typeof finalValue === 'string') {
-                    finalContext = 'primitive';
-                }
-                else if (isValueConfig(finalValue)) {
-                    finalContext = 'valueConfig';
-                }
-                else {
-                    finalContext = 'mapValue';
-                }
-                break;
-            default:
-                finalContext = 'valueConfig';
-        }
-    }
-    return {
-        segments,
-        finalValue,
-        finalContext,
-        isRuleLevel,
-        isValueConfigLevel,
-        propertyName,
-    };
-}
-/**
- * Get semantic description for a path
- *
- * Returns human-readable description of what's being edited at this path.
- *
- * @example
- * getPathDescription(['page', 'view', 'consent'], config)
- * // Returns: "Rule-level consent for page view event"
- *
- * @example
- * getPathDescription(['page', 'view', 'data', 'map', 'title', 'consent'], config)
- * // Returns: "Property-level consent for title field"
- */
-export function getPathDescription(path, config) {
-    const analysis = analyzePath(path, config);
-    if (analysis.propertyName === 'consent') {
-        return {
-            title: 'Required Consent States',
-            description: 'Events or properties will only be processed if these consent states are granted',
-        };
-    }
-    if (analysis.propertyName === 'settings') {
-        return {
-            title: 'Settings',
-            description: 'Configure destination-specific settings for this rule',
-        };
-    }
-    // Default descriptions
-    return {
-        title: `Editing ${analysis.propertyName || 'Value'}`,
-        description: `Configure ${analysis.finalContext} at path: ${path.join(' → ')}`,
-    };
-}
-//# sourceMappingURL=path-analyzer.js.map

package/dist/utils/path-analyzer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"path-analyzer.js","sourceRoot":"","sources":["../../src/utils/path-analyzer.ts"],"names":[],"mappings":"AA2DA;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAE7C,6DAA6D;IAC7D,MAAM,aAAa,GAAG;QACpB,MAAM;QACN,OAAO;QACP,QAAQ;QACR,UAAU;QACV,SAAS;QACT,SAAS;KACV,CAAC;IACF,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAEtE,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IACzD,MAAM,mBAAmB,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IAEvE,qFAAqF;IACrF,OAAO,YAAY,IAAI,CAAC,mBAAmB,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAE7C,kEAAkE;IAClE,MAAM,OAAO,GAAG;QACd,KAAK;QACL,OAAO;QACP,IAAI;QACJ,KAAK;QACL,MAAM;QACN,KAAK;QACL,SAAS;QACT,WAAW;QACX,UAAU;KACX,CAAC;IACF,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAE9E,4EAA4E;IAC5E,4DAA4D;IAC5D,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,WAAW,CACzB,IAAc,EACd,MAAsB;IAEtB,MAAM,QAAQ,GAAsB,EAAE,CAAC;IAEvC,+BAA+B;IAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,MAAM;YAClB,YAAY,EAAE,UAAU;YACxB,WAAW,EAAE,KAAK;YAClB,kBAAkB,EAAE,KAAK;SAC1B,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,GAAY,MAAM,CAAC;IAC9B,IAAI,MAAM,GAAY,IAAI,CAAC;IAE3B,4BAA4B;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,GAAG,OAAO,CAAC;QAEjB,2BAA2B;QAC3B,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CACb,iCAAiC,CAAC,0BAA0B,CAC7D,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,OAAkC,CAAC;QAC/C,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;QAEvB,6CAA6C;QAC7C,IAAI,cAAqC,CAAC;QAE1C,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACZ,iCAAiC;YACjC,cAAc,GAAG,QAAQ,CAAC;QAC5B,CAAC;aAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACnB,mDAAmD;YACnD,cAAc,GAAG,QAAQ,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,sDAAsD;YACtD,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBACnB,cAAc,GAAG,cAAc,CAAC;YAClC,CAAC;iBAAM,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjC,cAAc,GAAG,qBAAqB,CAAC;YACzC,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjC,cAAc,GAAG,YAAY,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,uBAAuB;gBACvB,cAAc,GAAG,QAAQ,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC;YACZ,OAAO;YACP,KAAK,EAAE,CAAC;YACR,cAAc;YACd,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;IAED,uCAAuC;IACvC,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC;IACrC,MAAM,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC;IAE5C,IAAI,YAA6B,CAAC;IAClC,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAC/B,IAAI,YAAgC,CAAC;IAErC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,YAAY,GAAG,QAAQ,CAAC;IAC1B,CAAC;SAAM,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,YAAY,GAAG,MAAM,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,iDAAiD;QACjD,QAAQ,WAAW,CAAC,cAAc,EAAE,CAAC;YACnC,KAAK,cAAc;gBACjB,YAAY,GAAG,cAAc,CAAC;gBAC9B,WAAW,GAAG,IAAI,CAAC;gBACnB,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC;gBACnC,MAAM;YAER,KAAK,qBAAqB;gBACxB,YAAY,GAAG,qBAAqB,CAAC;gBACrC,kBAAkB,GAAG,IAAI,CAAC;gBAC1B,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC;gBACnC,MAAM;YAER,KAAK,QAAQ;gBACX,kDAAkD;gBAClD,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;oBACnC,YAAY,GAAG,WAAW,CAAC;gBAC7B,CAAC;qBAAM,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;oBACrC,YAAY,GAAG,aAAa,CAAC;gBAC/B,CAAC;qBAAM,CAAC;oBACN,YAAY,GAAG,UAAU,CAAC;gBAC5B,CAAC;gBACD,MAAM;YAER;gBACE,YAAY,GAAG,aAAa,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ;QACR,UAAU;QACV,YAAY;QACZ,WAAW;QACX,kBAAkB;QAClB,YAAY;KACb,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAc,EACd,MAAsB;IAEtB,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE3C,IAAI,QAAQ,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO;YACL,KAAK,EAAE,yBAAyB;YAChC,WAAW,EACT,iFAAiF;SACpF,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QACzC,OAAO;YACL,KAAK,EAAE,UAAU;YACjB,WAAW,EAAE,uDAAuD;SACrE,CAAC;IACJ,CAAC;IAED,uBAAuB;IACvB,OAAO;QACL,KAAK,EAAE,WAAW,QAAQ,CAAC,YAAY,IAAI,OAAO,EAAE;QACpD,WAAW,EAAE,aAAa,QAAQ,CAAC,YAAY,aAAa,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;KAC/E,CAAC;AACJ,CAAC"}