@walkeros/explorer 0.3.1 → 1.0.0

package/dist/utils/path-analyzer.js

@@ -0,0 +1,215 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"version":3,"file":"path-analyzer.js","sourceRoot":"","sources":["../../src/utils/path-analyzer.ts"],"names":[],"mappings":"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"}

package/dist/utils/schema-validation.d.ts

@@ -0,0 +1,36 @@
+import type { RJSFSchema } from '@rjsf/utils';
+/**
+ * Validation result with error message
+ */
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * Validate a value against a JSON Schema
+ *
+ * Supports common validation rules:
+ * - String: pattern, minLength, maxLength, enum
+ * - Number: minimum, maximum, enum
+ * - Type checking
+ *
+ * @param value - Value to validate
+ * @param schema - JSON Schema to validate against
+ * @returns Validation result with error message if invalid
+ *
+ * @example
+ * const result = validateValue('123abc', {
+ *   type: 'string',
+ *   pattern: '^[0-9]+$'
+ * });
+ * // { valid: false, error: 'Must match pattern: ^[0-9]+$' }
+ */
+export declare function validateValue(value: unknown, schema?: RJSFSchema): ValidationResult;
+/**
+ * Format validation error message for display
+ *
+ * @param error - Error message from validation
+ * @returns Formatted error message
+ */
+export declare function formatValidationError(error: string): string;
+//# sourceMappingURL=schema-validation.d.ts.map

package/dist/utils/schema-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validation.d.ts","sourceRoot":"","sources":["../../src/utils/schema-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,UAAU,GAClB,gBAAgB,CA0HlB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/utils/schema-validation.js

@@ -0,0 +1,136 @@
+/**
+ * Validate a value against a JSON Schema
+ *
+ * Supports common validation rules:
+ * - String: pattern, minLength, maxLength, enum
+ * - Number: minimum, maximum, enum
+ * - Type checking
+ *
+ * @param value - Value to validate
+ * @param schema - JSON Schema to validate against
+ * @returns Validation result with error message if invalid
+ *
+ * @example
+ * const result = validateValue('123abc', {
+ *   type: 'string',
+ *   pattern: '^[0-9]+$'
+ * });
+ * // { valid: false, error: 'Must match pattern: ^[0-9]+$' }
+ */
+export function validateValue(value, schema) {
+    // No schema = no validation
+    if (!schema) {
+        return { valid: true };
+    }
+    // Empty/null values - check if required
+    if (value === undefined || value === null || value === '') {
+        // If schema has a default or is not required, it's valid
+        return { valid: true };
+    }
+    const schemaType = schema.type;
+    // String validation
+    if (schemaType === 'string') {
+        const strValue = String(value);
+        // Pattern validation (most important for things like pixelId)
+        if (schema.pattern) {
+            try {
+                const regex = new RegExp(schema.pattern);
+                if (!regex.test(strValue)) {
+                    return {
+                        valid: false,
+                        error: `Must match pattern: ${schema.pattern}`,
+                    };
+                }
+            }
+            catch {
+                // Invalid regex pattern in schema - skip validation
+            }
+        }
+        // Length validation
+        if (schema.minLength !== undefined && strValue.length < schema.minLength) {
+            return {
+                valid: false,
+                error: `Minimum length: ${schema.minLength} characters`,
+            };
+        }
+        if (schema.maxLength !== undefined && strValue.length > schema.maxLength) {
+            return {
+                valid: false,
+                error: `Maximum length: ${schema.maxLength} characters`,
+            };
+        }
+        // Enum validation
+        if (schema.enum && Array.isArray(schema.enum)) {
+            if (!schema.enum.includes(strValue)) {
+                return {
+                    valid: false,
+                    error: `Must be one of: ${schema.enum.join(', ')}`,
+                };
+            }
+        }
+        return { valid: true };
+    }
+    // Number validation
+    if (schemaType === 'number' || schemaType === 'integer') {
+        const numValue = typeof value === 'number' ? value : Number(value);
+        // Type check
+        if (isNaN(numValue)) {
+            return {
+                valid: false,
+                error: 'Must be a valid number',
+            };
+        }
+        // Integer check
+        if (schemaType === 'integer' && !Number.isInteger(numValue)) {
+            return {
+                valid: false,
+                error: 'Must be an integer',
+            };
+        }
+        // Range validation
+        if (schema.minimum !== undefined && numValue < schema.minimum) {
+            return {
+                valid: false,
+                error: `Minimum value: ${schema.minimum}`,
+            };
+        }
+        if (schema.maximum !== undefined && numValue > schema.maximum) {
+            return {
+                valid: false,
+                error: `Maximum value: ${schema.maximum}`,
+            };
+        }
+        // Enum validation
+        if (schema.enum && Array.isArray(schema.enum)) {
+            if (!schema.enum.includes(numValue)) {
+                return {
+                    valid: false,
+                    error: `Must be one of: ${schema.enum.join(', ')}`,
+                };
+            }
+        }
+        return { valid: true };
+    }
+    // Boolean validation
+    if (schemaType === 'boolean') {
+        if (typeof value !== 'boolean') {
+            return {
+                valid: false,
+                error: 'Must be true or false',
+            };
+        }
+        return { valid: true };
+    }
+    // No validation for other types (array, object, etc.)
+    return { valid: true };
+}
+/**
+ * Format validation error message for display
+ *
+ * @param error - Error message from validation
+ * @returns Formatted error message
+ */
+export function formatValidationError(error) {
+    return error;
+}
+//# sourceMappingURL=schema-validation.js.map

package/dist/utils/schema-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validation.js","sourceRoot":"","sources":["../../src/utils/schema-validation.ts"],"names":[],"mappings":"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"}

package/dist/utils/type-detector.d.ts

@@ -0,0 +1,35 @@
+import type { NodeType } from '../hooks/useMappingNavigation';
+import type { RJSFSchema } from '@rjsf/utils';
+import type { ConfigStructureDef } from '../schemas/config-structures/types';
+/**
+ * Detect NodeType for a value at a given path
+ *
+ * Single source of truth for type detection. Uses structure + schemas.
+ *
+ * Detection priority:
+ * 1. Structure definition (explicit nodeType for properties)
+ * 2. Schema detection (enum, boolean, primitives from JSON Schema)
+ * 3. Value introspection (for complex types and fallback)
+ *
+ * @param value - The value to inspect
+ * @param path - Path array to the value
+ * @param structure - Structure definition (REQUIRED for schema-driven detection)
+ * @param schemas - Schemas bundle for this config
+ * @returns NodeType for editing
+ */
+export declare function detectNodeType(value: unknown, path: string[], structure: ConfigStructureDef, schemas?: Record<string, RJSFSchema>): NodeType;
+/**
+ * Get schema for a path (exported for components that need schema access)
+ */
+export declare function getSchemaForPath(value: unknown, path: string[], structure: ConfigStructureDef, schemas?: Record<string, RJSFSchema>): RJSFSchema | undefined;
+/**
+ * Detect NodeType from JSON Schema alone (without value or structure)
+ *
+ * Used for property suggestions where we only have the schema definition.
+ * This is a lightweight detection based purely on JSON Schema properties.
+ *
+ * @param schema - JSON Schema for the property
+ * @returns NodeType for editing
+ */
+export declare function detectNodeTypeFromSchema(schema: RJSFSchema): NodeType;
+//# sourceMappingURL=type-detector.d.ts.map

package/dist/utils/type-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-detector.d.ts","sourceRoot":"","sources":["../../src/utils/type-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EACV,kBAAkB,EAEnB,MAAM,oCAAoC,CAAC;AAI5C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,kBAAkB,EAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GACnC,QAAQ,CA0IV;AA8BD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,kBAAkB,EAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GACnC,UAAU,GAAG,SAAS,CAiCxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAgCrE"}