@walkeros/explorer 0.5.0 → 1.0.0

package/dist/utils/generic-tree-builder.js

@@ -0,0 +1,225 @@
+import { MAPPING_RULE_STRUCTURE } from '../schemas/config-structures/mapping-rule';
+import { detectNodeType } from './type-detector';
+/**
+ * Capitalize first letter of a string
+ */
+function capitalize(str) {
+    if (!str)
+        return str;
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+/**
+ * Build tree structure from config using structure definition
+ *
+ * CONFIG-DRIVEN: Tree reflects actual config values, not schema possibilities.
+ * STRUCTURE-AWARE: Uses PropertyDef for metadata (titles, nodeTypes, children strategy).
+ *
+ * @param config - Actual configuration object
+ * @param structure - Structure definition describing config shape
+ * @param schemas - Optional JSON Schemas for type hints and labels
+ * @param sections - Optional visibility filter (e.g., { verbose: false })
+ * @returns Array of root-level tree nodes
+ *
+ * @example
+ * const tree = buildTree(
+ *   destinationConfig,
+ *   DESTINATION_CONFIG_STRUCTURE,
+ *   metaPixelSchemas,
+ *   { verbose: false }
+ * );
+ */
+export function buildTree(config, structure, schemas, sections) {
+    const nodes = [];
+    if (!structure.properties) {
+        return nodes;
+    }
+    // Iterate actual config keys (config-driven, not schema-driven)
+    const configKeys = Object.keys(config).filter((key) => config[key] !== undefined);
+    for (const key of configKeys) {
+        // Check section visibility
+        if (sections?.[key] === false) {
+            continue;
+        }
+        const propertyDef = structure.properties[key];
+        const value = config[key];
+        const nodeType = detectNodeType(value, [key], structure, schemas);
+        // Build node
+        const node = {
+            key,
+            label: propertyDef?.title || capitalize(key),
+            path: [key],
+            type: nodeType,
+            hasValue: true,
+        };
+        // Build children based on children strategy
+        if (propertyDef?.children === 'entity-action') {
+            // Special: mapping.{entity}.{action} pattern
+            node.children = buildEntityActionChildren(value, [key], schemas);
+            node.isExpandable = node.children.length > 0;
+        }
+        else if (propertyDef?.children === 'schema-driven') {
+            // Build from JSON Schema properties
+            const propSchema = schemas?.[propertyDef.schemaPath || key];
+            node.children = buildSchemaChildren(value, [key], propSchema, schemas, structure);
+            node.isExpandable = node.children.length > 0;
+        }
+        else if (propertyDef?.children === 'value-driven') {
+            // Detect children from value structure
+            node.children = buildValueChildren(value, [key], schemas, structure);
+            node.isExpandable = node.children.length > 0;
+        }
+        else {
+            // No children (leaf node)
+            node.isExpandable = false;
+        }
+        nodes.push(node);
+    }
+    return nodes;
+}
+/**
+ * Build children nodes for entity-action pattern
+ *
+ * Handles the special mapping.{entity}.{action} hierarchy:
+ * - First level: entities (page, product, order)
+ * - Second level: actions (view, add, complete)
+ * - Third level: rule properties (name, batch, settings, data, etc.)
+ *
+ * Uses MAPPING_RULE_STRUCTURE to properly handle rule properties with schema awareness.
+ *
+ * @param mapping - Mapping object (entity → action → rule)
+ * @param basePath - Base path (e.g., ['mapping'])
+ * @param schemas - Schemas dict for rule-level settings
+ * @returns Array of entity nodes with action children
+ */
+function buildEntityActionChildren(mapping, basePath, schemas) {
+    const children = [];
+    Object.keys(mapping).forEach((entity) => {
+        const actions = mapping[entity];
+        const actionNodes = [];
+        if (actions && typeof actions === 'object') {
+            Object.keys(actions).forEach((action) => {
+                const ruleValue = actions[action];
+                const rulePath = [...basePath, entity, action];
+                // Build rule children using MAPPING_RULE_STRUCTURE for proper schema handling
+                const ruleChildren = buildValueChildren(ruleValue, rulePath, schemas, MAPPING_RULE_STRUCTURE);
+                actionNodes.push({
+                    key: action,
+                    label: capitalize(action),
+                    path: rulePath,
+                    type: 'rule',
+                    hasValue: true,
+                    children: ruleChildren,
+                    isExpandable: ruleChildren.length > 0,
+                });
+            });
+        }
+        children.push({
+            key: entity,
+            label: capitalize(entity),
+            path: [...basePath, entity],
+            type: 'entity',
+            hasValue: true,
+            children: actionNodes,
+            isExpandable: actionNodes.length > 0,
+        });
+    });
+    return children;
+}
+/**
+ * Build children from JSON Schema properties
+ *
+ * Used for settings and other schema-defined objects.
+ * Only shows properties that actually exist in config.
+ *
+ * @param obj - Object with properties
+ * @param basePath - Base path
+ * @param schema - JSON Schema for this object
+ * @param schemas - Full schemas dict for nested navigation
+ * @param structure - Optional structure for additional metadata
+ * @returns Array of child nodes
+ */
+function buildSchemaChildren(obj, basePath, schema, schemas, structure) {
+    const children = [];
+    // Only build from actual config values (config-driven)
+    Object.keys(obj)
+        .filter((key) => obj[key] !== undefined)
+        .forEach((key) => {
+        const value = obj[key];
+        const childPath = [...basePath, key];
+        const propSchema = schema?.properties?.[key];
+        // Get property definition from structure if available
+        const propertyDef = structure?.properties?.[key];
+        // Determine children - check if nested object has schema
+        let valueChildren;
+        if (typeof value === 'object' &&
+            value !== null &&
+            !Array.isArray(value) &&
+            propSchema?.properties) {
+            // This is a schema-defined nested object, recurse with schema
+            valueChildren = buildSchemaChildren(value, childPath, propSchema, schemas, structure);
+        }
+        else {
+            // Use value-driven for non-schema objects (pass structure!)
+            valueChildren = buildValueChildren(value, childPath, schemas, structure);
+        }
+        children.push({
+            key,
+            label: propertyDef?.title || propSchema?.title || capitalize(key),
+            path: childPath,
+            type: structure ? detectNodeType(value, childPath, structure, schemas) : 'valueConfig',
+            hasValue: true,
+            children: valueChildren,
+            isExpandable: valueChildren.length > 0,
+        });
+    });
+    return children;
+}
+/**
+ * Build children from value structure
+ *
+ * Used for data, policy, and other value-driven properties.
+ * Detects structure from actual value, but uses schema when available.
+ *
+ * @param value - Value to inspect
+ * @param basePath - Base path
+ * @param schemas - Optional schemas dict for schema-aware navigation
+ * @param structure - Optional structure definition for property metadata
+ * @returns Array of child nodes
+ */
+function buildValueChildren(value, basePath, schemas, structure) {
+    // For objects: show properties and recurse
+    if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+        const obj = value;
+        return Object.keys(obj).map((key) => {
+            const childValue = obj[key];
+            const childPath = [...basePath, key];
+            // Check if this property is defined in structure (for rule properties)
+            const propertyDef = structure?.properties?.[key];
+            // Determine if this should use schema-driven children
+            let childChildren;
+            if (propertyDef?.children === 'schema-driven') {
+                // Use schema-driven building for nested settings
+                const schemaPath = propertyDef.schemaPath || key;
+                const propSchema = schemas?.[schemaPath];
+                childChildren = buildSchemaChildren(childValue, childPath, propSchema, schemas, structure);
+            }
+            else {
+                // Continue with value-driven recursion
+                childChildren = buildValueChildren(childValue, childPath, schemas, structure);
+            }
+            const label = propertyDef?.title || capitalize(key);
+            return {
+                key,
+                label,
+                path: childPath,
+                type: structure ? detectNodeType(childValue, childPath, structure, schemas) : 'valueConfig',
+                hasValue: true,
+                children: childChildren,
+                isExpandable: childChildren.length > 0,
+            };
+        });
+    }
+    // Arrays, primitives: no children
+    return [];
+}
+//# sourceMappingURL=generic-tree-builder.js.map

package/dist/utils/generic-tree-builder.js.map

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

package/dist/utils/mapping-path.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Pure utility functions for mapping path navigation
+ *
+ * These functions handle:
+ * - Path-based value extraction from nested objects
+ * - Immutable path-based value updates
+ * - Breadcrumb segment generation
+ * - Rule path parsing (entity action format)
+ * - Path validation and normalization
+ *
+ * All functions are pure (no side effects, no state, no UI)
+ * Designed for maximum reusability across different UI implementations
+ */
+/**
+ * Extract value from nested object using path array
+ *
+ * @example
+ * getValueAtPath({ data: { map: { items: 'value' } } }, ['data', 'map', 'items'])
+ * // Returns: 'value'
+ *
+ * @example
+ * getValueAtPath({ data: {} }, ['data', 'missing'])
+ * // Returns: undefined
+ */
+export declare function getValueAtPath(obj: unknown, path: string[]): unknown;
+/**
+ * Set value in nested object at path (immutable)
+ *
+ * Creates a new object with the value updated at the specified path.
+ * Does not mutate the original object.
+ *
+ * @example
+ * setValueAtPath({ data: { map: {} } }, ['data', 'map', 'items'], 'new')
+ * // Returns: { data: { map: { items: 'new' } } }
+ */
+export declare function setValueAtPath(obj: unknown, path: string[], value: unknown): unknown;
+/**
+ * Delete value at path (immutable)
+ *
+ * Creates a new object with the key removed at the specified path.
+ * Does not mutate the original object.
+ *
+ * @example
+ * deleteAtPath({ data: { map: { items: 'value' } } }, ['data', 'map', 'items'])
+ * // Returns: { data: { map: {} } }
+ */
+export declare function deleteAtPath(obj: unknown, path: string[]): unknown;
+/**
+ * Parse rule path into entity and action
+ *
+ * WalkerOS uses "ENTITY ACTION" format with space separator
+ *
+ * @example
+ * parseRulePath('product view')
+ * // Returns: { entity: 'product', action: 'view' }
+ *
+ * @example
+ * parseRulePath('invalid')
+ * // Returns: { entity: 'invalid', action: undefined }
+ */
+export declare function parseRulePath(rulePath: string): {
+    entity: string;
+    action: string | undefined;
+};
+/**
+ * Build rule path from entity and action
+ *
+ * @example
+ * buildRulePath('product', 'view')
+ * // Returns: 'product view'
+ */
+export declare function buildRulePath(entity: string, action: string): string;
+/**
+ * Breadcrumb segment for UI display
+ */
+export interface BreadcrumbSegment {
+    label: string;
+    path: string[];
+    nodeType?: string;
+}
+/**
+ * Build breadcrumb segments from path
+ *
+ * Converts a flat path array into human-readable breadcrumb segments
+ *
+ * @example
+ * buildBreadcrumbSegments(['product', 'view', 'data', 'map', 'items'])
+ * // Returns: [
+ * //   { label: 'Overview', path: [] },
+ * //   { label: 'product', path: ['product'] },
+ * //   { label: 'view', path: ['product', 'view'] },
+ * //   { label: 'data', path: ['product', 'view', 'data'] },
+ * //   { label: 'map', path: ['product', 'view', 'data', 'map'] },
+ * //   { label: 'items', path: ['product', 'view', 'data', 'map', 'items'] }
+ * // ]
+ */
+export declare function buildBreadcrumbSegments(path: string[]): BreadcrumbSegment[];
+/**
+ * Validate if a path is valid for a mapping rule
+ *
+ * @example
+ * isValidRulePath(['product', 'view'])
+ * // Returns: true
+ *
+ * @example
+ * isValidRulePath(['product'])
+ * // Returns: false (missing action)
+ */
+export declare function isValidRulePath(path: string[]): boolean;
+/**
+ * Get parent path
+ *
+ * @example
+ * getParentPath(['data', 'map', 'items'])
+ * // Returns: ['data', 'map']
+ *
+ * @example
+ * getParentPath(['data'])
+ * // Returns: []
+ *
+ * @example
+ * getParentPath([])
+ * // Returns: []
+ */
+export declare function getParentPath(path: string[]): string[];
+/**
+ * Check if path is ancestor of another path
+ *
+ * @example
+ * isAncestorPath(['data', 'map'], ['data', 'map', 'items'])
+ * // Returns: true
+ *
+ * @example
+ * isAncestorPath(['data', 'map'], ['data', 'set'])
+ * // Returns: false
+ */
+export declare function isAncestorPath(ancestorPath: string[], descendantPath: string[]): boolean;
+/**
+ * Normalize path by removing empty strings and trimming
+ *
+ * @example
+ * normalizePath(['  data  ', '', 'map', '  items'])
+ * // Returns: ['data', 'map', 'items']
+ */
+export declare function normalizePath(path: string[]): string[];
+//# sourceMappingURL=mapping-path.d.ts.map

package/dist/utils/mapping-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping-path.d.ts","sourceRoot":"","sources":["../../src/utils/mapping-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAcpE;AAoCD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,OAAO,GACb,OAAO,CA6BT;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAsBlE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,CAYA;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,EAAE,CAa3E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAQvD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAGtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EAAE,EACtB,cAAc,EAAE,MAAM,EAAE,GACvB,OAAO,CAUT;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAItD"}

package/dist/utils/mapping-path.js

@@ -0,0 +1,271 @@
+/**
+ * Pure utility functions for mapping path navigation
+ *
+ * These functions handle:
+ * - Path-based value extraction from nested objects
+ * - Immutable path-based value updates
+ * - Breadcrumb segment generation
+ * - Rule path parsing (entity action format)
+ * - Path validation and normalization
+ *
+ * All functions are pure (no side effects, no state, no UI)
+ * Designed for maximum reusability across different UI implementations
+ */
+/**
+ * Extract value from nested object using path array
+ *
+ * @example
+ * getValueAtPath({ data: { map: { items: 'value' } } }, ['data', 'map', 'items'])
+ * // Returns: 'value'
+ *
+ * @example
+ * getValueAtPath({ data: {} }, ['data', 'missing'])
+ * // Returns: undefined
+ */
+export function getValueAtPath(obj, path) {
+    if (!obj || typeof obj !== 'object')
+        return undefined;
+    if (path.length === 0)
+        return obj;
+    let current = obj;
+    for (const key of path) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (typeof current !== 'object')
+            return undefined;
+        current = current[key];
+    }
+    return current;
+}
+/**
+ * Deep clone that preserves all value types including function strings
+ *
+ * In the explorer, functions are stored as strings (e.g., fn: "(event) => event.data")
+ * so they need to be preserved during cloning operations.
+ *
+ * This implementation:
+ * - Handles primitives, arrays, objects
+ * - Preserves function strings
+ * - Handles nested structures recursively
+ * - Creates new object references (true immutability)
+ */
+function deepClone(obj) {
+    // Handle primitives and null
+    if (obj === null || typeof obj !== 'object') {
+        return obj;
+    }
+    // Handle arrays
+    if (Array.isArray(obj)) {
+        return obj.map((item) => deepClone(item));
+    }
+    // Handle objects
+    const cloned = {};
+    for (const key in obj) {
+        if (Object.prototype.hasOwnProperty.call(obj, key)) {
+            cloned[key] = deepClone(obj[key]);
+        }
+    }
+    return cloned;
+}
+/**
+ * Set value in nested object at path (immutable)
+ *
+ * Creates a new object with the value updated at the specified path.
+ * Does not mutate the original object.
+ *
+ * @example
+ * setValueAtPath({ data: { map: {} } }, ['data', 'map', 'items'], 'new')
+ * // Returns: { data: { map: { items: 'new' } } }
+ */
+export function setValueAtPath(obj, path, value) {
+    if (!obj || typeof obj !== 'object') {
+        throw new Error('Cannot set value on non-object');
+    }
+    if (path.length === 0)
+        return value;
+    // Deep clone for immutability
+    const cloned = deepClone(obj);
+    let current = cloned;
+    // Navigate to parent of target
+    for (let i = 0; i < path.length - 1; i++) {
+        const key = path[i];
+        // Create missing intermediate objects
+        if (!current[key] || typeof current[key] !== 'object') {
+            current[key] = {};
+        }
+        current = current[key];
+    }
+    // Set the final value
+    const lastKey = path[path.length - 1];
+    current[lastKey] = value;
+    return cloned;
+}
+/**
+ * Delete value at path (immutable)
+ *
+ * Creates a new object with the key removed at the specified path.
+ * Does not mutate the original object.
+ *
+ * @example
+ * deleteAtPath({ data: { map: { items: 'value' } } }, ['data', 'map', 'items'])
+ * // Returns: { data: { map: {} } }
+ */
+export function deleteAtPath(obj, path) {
+    if (!obj || typeof obj !== 'object') {
+        throw new Error('Cannot delete from non-object');
+    }
+    if (path.length === 0)
+        return undefined;
+    const cloned = deepClone(obj);
+    let current = cloned;
+    // Navigate to parent
+    for (let i = 0; i < path.length - 1; i++) {
+        const key = path[i];
+        if (!current[key])
+            return cloned; // Path doesn't exist, return unchanged
+        current = current[key];
+    }
+    // Delete the final key
+    const lastKey = path[path.length - 1];
+    delete current[lastKey];
+    return cloned;
+}
+/**
+ * Parse rule path into entity and action
+ *
+ * WalkerOS uses "ENTITY ACTION" format with space separator
+ *
+ * @example
+ * parseRulePath('product view')
+ * // Returns: { entity: 'product', action: 'view' }
+ *
+ * @example
+ * parseRulePath('invalid')
+ * // Returns: { entity: 'invalid', action: undefined }
+ */
+export function parseRulePath(rulePath) {
+    const parts = rulePath
+        .trim()
+        .split(' ')
+        .filter((p) => p.trim());
+    if (parts.length < 2) {
+        return { entity: parts[0] || '', action: undefined };
+    }
+    const [entity, ...actionParts] = parts;
+    return { entity, action: actionParts.join(' ') };
+}
+/**
+ * Build rule path from entity and action
+ *
+ * @example
+ * buildRulePath('product', 'view')
+ * // Returns: 'product view'
+ */
+export function buildRulePath(entity, action) {
+    return `${entity} ${action}`;
+}
+/**
+ * Build breadcrumb segments from path
+ *
+ * Converts a flat path array into human-readable breadcrumb segments
+ *
+ * @example
+ * buildBreadcrumbSegments(['product', 'view', 'data', 'map', 'items'])
+ * // Returns: [
+ * //   { label: 'Overview', path: [] },
+ * //   { label: 'product', path: ['product'] },
+ * //   { label: 'view', path: ['product', 'view'] },
+ * //   { label: 'data', path: ['product', 'view', 'data'] },
+ * //   { label: 'map', path: ['product', 'view', 'data', 'map'] },
+ * //   { label: 'items', path: ['product', 'view', 'data', 'map', 'items'] }
+ * // ]
+ */
+export function buildBreadcrumbSegments(path) {
+    const segments = [{ label: 'Overview', path: [] }];
+    if (path.length === 0)
+        return segments;
+    for (let i = 0; i < path.length; i++) {
+        segments.push({
+            label: path[i],
+            path: path.slice(0, i + 1),
+        });
+    }
+    return segments;
+}
+/**
+ * Validate if a path is valid for a mapping rule
+ *
+ * @example
+ * isValidRulePath(['product', 'view'])
+ * // Returns: true
+ *
+ * @example
+ * isValidRulePath(['product'])
+ * // Returns: false (missing action)
+ */
+export function isValidRulePath(path) {
+    if (path.length < 2)
+        return false;
+    const [entity, action] = path;
+    if (!entity || !action)
+        return false;
+    if (typeof entity !== 'string' || typeof action !== 'string')
+        return false;
+    return true;
+}
+/**
+ * Get parent path
+ *
+ * @example
+ * getParentPath(['data', 'map', 'items'])
+ * // Returns: ['data', 'map']
+ *
+ * @example
+ * getParentPath(['data'])
+ * // Returns: []
+ *
+ * @example
+ * getParentPath([])
+ * // Returns: []
+ */
+export function getParentPath(path) {
+    if (path.length === 0)
+        return [];
+    return path.slice(0, -1);
+}
+/**
+ * Check if path is ancestor of another path
+ *
+ * @example
+ * isAncestorPath(['data', 'map'], ['data', 'map', 'items'])
+ * // Returns: true
+ *
+ * @example
+ * isAncestorPath(['data', 'map'], ['data', 'set'])
+ * // Returns: false
+ */
+export function isAncestorPath(ancestorPath, descendantPath) {
+    // Empty path cannot be ancestor (even though technically it is)
+    if (ancestorPath.length === 0)
+        return false;
+    if (ancestorPath.length >= descendantPath.length)
+        return false;
+    for (let i = 0; i < ancestorPath.length; i++) {
+        if (ancestorPath[i] !== descendantPath[i])
+            return false;
+    }
+    return true;
+}
+/**
+ * Normalize path by removing empty strings and trimming
+ *
+ * @example
+ * normalizePath(['  data  ', '', 'map', '  items'])
+ * // Returns: ['data', 'map', 'items']
+ */
+export function normalizePath(path) {
+    return path
+        .filter((segment) => segment && segment.trim())
+        .map((s) => s.trim());
+}
+//# sourceMappingURL=mapping-path.js.map

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

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