@walkeros/cli 0.3.1

package/dist/commands/simulate/tracker.js

@@ -0,0 +1,96 @@
+/**
+ * Call Tracker for Simulation
+ *
+ * Wraps mock environment functions to track API calls.
+ * Used with destination-provided examples/env.ts mocks.
+ */
+export class CallTracker {
+    calls = new Map();
+    /**
+     * Wrap a function to track its calls
+     */
+    wrapFunction(name, fn) {
+        const self = this;
+        const targetFn = fn || (() => { });
+        return new Proxy(targetFn, {
+            apply(_target, thisArg, args) {
+                self.logCall(name, args);
+                return targetFn.apply(thisArg, args);
+            },
+        });
+    }
+    /**
+     * Wrap an environment object, tracking specified paths
+     *
+     * @param env - Environment object (from destination's examples/env.ts)
+     * @param paths - Paths to track (e.g., ['gtag:window.gtag', 'gtag:window.dataLayer.push'])
+     */
+    wrapEnv(env, paths) {
+        const wrapped = {};
+        // Deep clone the env object first
+        for (const [key, value] of Object.entries(env)) {
+            if (typeof value === 'object' && value !== null) {
+                wrapped[key] = Array.isArray(value)
+                    ? [...value]
+                    : { ...value };
+            }
+            else {
+                wrapped[key] = value;
+            }
+        }
+        // Wrap specified paths
+        for (const fullPath of paths) {
+            // Parse path: "gtag:window.gtag" → destKey="gtag", path="window.gtag"
+            const [destKey, ...pathParts] = fullPath.split(':');
+            const path = pathParts.join(':');
+            if (!path)
+                continue;
+            // Remove "call:" prefix if present (from simulation array)
+            const cleanPath = path.replace(/^call:/, '');
+            const parts = cleanPath.split('.');
+            let current = wrapped;
+            let source = env;
+            // Navigate to parent object
+            for (let i = 0; i < parts.length - 1; i++) {
+                const part = parts[i];
+                if (!current[part]) {
+                    current[part] = {};
+                }
+                current = current[part];
+                source =
+                    source && typeof source[part] === 'object' && source[part] !== null
+                        ? source[part]
+                        : undefined;
+            }
+            // Wrap the final property
+            const finalKey = parts[parts.length - 1];
+            const originalFn = source?.[finalKey];
+            // Wrap with full path for tracking
+            current[finalKey] = this.wrapFunction(`${destKey}:${cleanPath}`, typeof originalFn === 'function'
+                ? originalFn
+                : undefined);
+        }
+        return wrapped;
+    }
+    logCall(fullPath, args) {
+        // Parse "destKey:api.path" → destKey and apiPath
+        const [destKey, ...pathParts] = fullPath.split(':');
+        const apiPath = pathParts.join(':');
+        if (!this.calls.has(destKey)) {
+            this.calls.set(destKey, []);
+        }
+        this.calls.get(destKey).push({
+            type: 'call',
+            path: apiPath,
+            args,
+            timestamp: Date.now(),
+        });
+    }
+    getCalls() {
+        return Object.fromEntries(this.calls);
+    }
+    reset() {
+        this.calls.clear();
+    }
+}
+//# sourceMappingURL=tracker.js.map

package/dist/commands/simulate/tracker.js.map

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

package/dist/commands/simulate/types.d.ts

@@ -0,0 +1,18 @@
+import type { Elb } from '@walkeros/core';
+import type { GlobalOptions } from '../../types';
+import type { ApiCall } from './tracker';
+export interface SimulateCommandOptions extends GlobalOptions {
+    config: string;
+    event?: string;
+    json?: boolean;
+}
+export interface SimulationResult {
+    success: boolean;
+    error?: string;
+    collector?: unknown;
+    elbResult?: Elb.PushResult;
+    logs?: unknown[];
+    usage?: Record<string, ApiCall[]>;
+    duration?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/commands/simulate/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/commands/simulate/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC;IAC3B,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/commands/simulate/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/commands/simulate/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/commands/simulate/types.ts"],"names":[],"mappings":""}

package/dist/config/defaults.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Configuration Defaults
+ *
+ * Platform-specific default build options.
+ */
+import type { BuildOptions } from '../types/bundle';
+/**
+ * Get default build configuration for platform.
+ *
+ * @param platform - Target platform ('web' or 'server')
+ * @param code - User code to include (required for BuildOptions)
+ * @param output - Output file path (optional, uses platform default)
+ * @returns Platform-specific default build options
+ *
+ * @remarks
+ * Provides sensible defaults for each platform:
+ * - web: IIFE format for browser, ES2020 target
+ * - server: ESM format for Node.js, Node18 target
+ */
+export declare function getDefaultBuildOptions(platform: 'web' | 'server', code: string, output?: string): Partial<BuildOptions>;
+/**
+ * Ensure build options have all required fields.
+ *
+ * @param buildOptions - Build options (possibly incomplete)
+ * @param flowPlatform - Platform from Flow.Config
+ * @returns Complete build options with defaults filled in
+ *
+ * @remarks
+ * Validates and fills in missing required fields using platform-specific defaults.
+ * Throws error if critical fields (code, output) are missing.
+ */
+export declare function ensureBuildOptions(buildOptions: Partial<BuildOptions>, flowPlatform: 'web' | 'server'): BuildOptions;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,KAAK,GAAG,QAAQ,EAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,CAAC,CA2BvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,EACnC,YAAY,EAAE,KAAK,GAAG,QAAQ,GAC7B,YAAY,CAsBd"}

package/dist/config/defaults.js

@@ -0,0 +1,73 @@
+/**
+ * Configuration Defaults
+ *
+ * Platform-specific default build options.
+ */
+/**
+ * Get default build configuration for platform.
+ *
+ * @param platform - Target platform ('web' or 'server')
+ * @param code - User code to include (required for BuildOptions)
+ * @param output - Output file path (optional, uses platform default)
+ * @returns Platform-specific default build options
+ *
+ * @remarks
+ * Provides sensible defaults for each platform:
+ * - web: IIFE format for browser, ES2020 target
+ * - server: ESM format for Node.js, Node18 target
+ */
+export function getDefaultBuildOptions(platform, code, output) {
+    const common = {
+        code,
+        packages: {},
+        minify: false,
+        sourcemap: false,
+        cache: true,
+    };
+    if (platform === 'web') {
+        return {
+            ...common,
+            platform: 'browser',
+            format: 'iife',
+            target: 'es2020',
+            output: output || './dist/walker.js',
+            globalName: 'walkerOS',
+        };
+    }
+    return {
+        ...common,
+        platform: 'node',
+        format: 'esm',
+        target: 'node18',
+        output: output || './dist/bundle.js',
+    };
+}
+/**
+ * Ensure build options have all required fields.
+ *
+ * @param buildOptions - Build options (possibly incomplete)
+ * @param flowPlatform - Platform from Flow.Config
+ * @returns Complete build options with defaults filled in
+ *
+ * @remarks
+ * Validates and fills in missing required fields using platform-specific defaults.
+ * Throws error if critical fields (code, output) are missing.
+ */
+export function ensureBuildOptions(buildOptions, flowPlatform) {
+    const defaults = getDefaultBuildOptions(flowPlatform, buildOptions.code || '', buildOptions.output);
+    // Validate required fields
+    if (!buildOptions.code && !defaults.code) {
+        throw new Error('BuildOptions.code is required');
+    }
+    if (!buildOptions.output && !defaults.output) {
+        throw new Error('BuildOptions.output is required');
+    }
+    return {
+        ...defaults,
+        ...buildOptions,
+        code: buildOptions.code || defaults.code,
+        output: buildOptions.output || defaults.output,
+        packages: buildOptions.packages || defaults.packages,
+    };
+}
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAA0B,EAC1B,IAAY,EACZ,MAAe;IAEf,MAAM,MAAM,GAAG;QACb,IAAI;QACJ,QAAQ,EAAE,EAA8D;QACxE,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,KAAK;QAChB,KAAK,EAAE,IAAI;KACZ,CAAC;IAEF,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACvB,OAAO;YACL,GAAG,MAAM;YACT,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,MAAM,IAAI,kBAAkB;YACpC,UAAU,EAAE,UAAU;SACvB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,GAAG,MAAM;QACT,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,MAAM,IAAI,kBAAkB;KACrC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAChC,YAAmC,EACnC,YAA8B;IAE9B,MAAM,QAAQ,GAAG,sBAAsB,CACrC,YAAY,EACZ,YAAY,CAAC,IAAI,IAAI,EAAE,EACvB,YAAY,CAAC,MAAM,CACpB,CAAC;IAEF,2BAA2B;IAC3B,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IAED,OAAO;QACL,GAAG,QAAQ;QACX,GAAG,YAAY;QACf,IAAI,EAAE,YAAY,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAK;QACzC,MAAM,EAAE,YAAY,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAO;QAC/C,QAAQ,EAAE,YAAY,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAS;KACtC,CAAC;AACpB,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Configuration Module
+ *
+ * Unified configuration loading, parsing, and validation.
+ */
+export { isObject, validatePlatform, isMultiEnvConfig, isSingleEnvConfig, } from './validators';
+export { substituteEnvVariables, loadJsonConfig, getTempDir } from './utils';
+export { getDefaultBuildOptions, ensureBuildOptions } from './defaults';
+export { parseBundleConfig, safeParseBundleConfig, normalizeConfigs, } from './parser';
+export type { ParsedConfig } from './parser';
+export { loadBundleConfig, loadAllEnvironments, getAvailableEnvironments, } from './loader';
+export type { LoadConfigResult, LoadConfigOptions } from './loader';
+export type { BuildOptions, MinifyOptions, EnvironmentConfig, Setup, } from '../types/bundle';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG7E,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGpE,YAAY,EACV,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,KAAK,GACN,MAAM,iBAAiB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,16 @@
+/**
+ * Configuration Module
+ *
+ * Unified configuration loading, parsing, and validation.
+ */
+// Type guards and validators
+export { isObject, validatePlatform, isMultiEnvConfig, isSingleEnvConfig, } from './validators';
+// Utility functions
+export { substituteEnvVariables, loadJsonConfig, getTempDir } from './utils';
+// Platform defaults
+export { getDefaultBuildOptions, ensureBuildOptions } from './defaults';
+// Parser
+export { parseBundleConfig, safeParseBundleConfig, normalizeConfigs, } from './parser';
+// Loader
+export { loadBundleConfig, loadAllEnvironments, getAvailableEnvironments, } from './loader';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6BAA6B;AAC7B,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,oBAAoB;AACpB,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE7E,oBAAoB;AACpB,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAExE,SAAS;AACT,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAGlB,SAAS;AACT,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,UAAU,CAAC"}

package/dist/config/loader.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Configuration Loader
+ *
+ * Loads and parses configurations with support for:
+ * - Single-environment configs
+ * - Multi-environment setups
+ * - Environment selection
+ */
+import type { Flow } from '@walkeros/core';
+import type { BuildOptions } from '../types/bundle';
+/**
+ * Result of configuration loading.
+ */
+export interface LoadConfigResult {
+    /** Runtime event processing configuration */
+    flowConfig: Flow.Config;
+    /** Build-time configuration */
+    buildOptions: BuildOptions;
+    /** Name of the selected environment (or 'default' for single configs) */
+    environment: string;
+    /** Whether this is a multi-environment setup */
+    isMultiEnvironment: boolean;
+    /** All available environment names (for multi-environment setups) */
+    availableEnvironments?: string[];
+}
+/**
+ * Options for loading configuration.
+ */
+export interface LoadConfigOptions {
+    /** Path to config file */
+    configPath: string;
+    /** Environment name to load (for multi-environment configs) */
+    environment?: string;
+    /** Logger for warnings */
+    logger?: {
+        warn: (message: string) => void;
+        info: (message: string) => void;
+    };
+}
+/**
+ * Load and parse bundle configuration.
+ *
+ * @remarks
+ * Automatically detects whether the config is:
+ * - New format: { flow: {...}, build: {...} }
+ * - Multi-environment format: { version: 1, environments: {...} }
+ * - Legacy format: { platform, sources, destinations, packages, ... } (with deprecation warning)
+ *
+ * For multi-environment configs, requires `environment` option.
+ *
+ * @param rawConfig - Raw configuration object from JSON file
+ * @param options - Loading options
+ * @returns Parsed configuration with flow and build separated
+ */
+export declare function loadBundleConfig(rawConfig: unknown, options: LoadConfigOptions): LoadConfigResult;
+/**
+ * Load all environments from a multi-environment configuration.
+ *
+ * @remarks
+ * Used by the --all flag to build all environments.
+ *
+ * @param rawConfig - Raw configuration object
+ * @param options - Loading options
+ * @returns Array of loaded configurations for all environments
+ */
+export declare function loadAllEnvironments(rawConfig: unknown, options: Omit<LoadConfigOptions, 'environment'>): LoadConfigResult[];
+/**
+ * Get list of available environments from configuration.
+ *
+ * @param rawConfig - Raw configuration object
+ * @returns Array of environment names, or empty array for single-environment configs
+ */
+export declare function getAvailableEnvironments(rawConfig: unknown): string[];
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAA4B,MAAM,iBAAiB,CAAC;AAS9E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;IACxB,+BAA+B;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qEAAqE;IACrE,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KACjC,CAAC;CACH;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,iBAAiB,GACzB,gBAAgB,CAyBlB;AAoFD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,GAC9C,gBAAgB,EAAE,CAyBpB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,EAAE,CAMrE"}

package/dist/config/loader.js

@@ -0,0 +1,136 @@
+/**
+ * Configuration Loader
+ *
+ * Loads and parses configurations with support for:
+ * - Single-environment configs
+ * - Multi-environment setups
+ * - Environment selection
+ */
+import { isMultiEnvConfig, isSingleEnvConfig, isObject, } from './validators';
+import { normalizeConfigs } from './parser';
+/**
+ * Load and parse bundle configuration.
+ *
+ * @remarks
+ * Automatically detects whether the config is:
+ * - New format: { flow: {...}, build: {...} }
+ * - Multi-environment format: { version: 1, environments: {...} }
+ * - Legacy format: { platform, sources, destinations, packages, ... } (with deprecation warning)
+ *
+ * For multi-environment configs, requires `environment` option.
+ *
+ * @param rawConfig - Raw configuration object from JSON file
+ * @param options - Loading options
+ * @returns Parsed configuration with flow and build separated
+ */
+export function loadBundleConfig(rawConfig, options) {
+    // Check if multi-environment format
+    if (isMultiEnvConfig(rawConfig)) {
+        return loadMultiEnvironmentConfig(rawConfig, options);
+    }
+    // Check if new single-environment format
+    if (isSingleEnvConfig(rawConfig)) {
+        return loadSingleEnvironmentConfig(rawConfig, options);
+    }
+    // Invalid format - provide helpful error
+    const configType = isObject(rawConfig)
+        ? 'platform' in rawConfig
+            ? `invalid platform value: "${rawConfig.platform}"`
+            : 'missing "flow" and "build" fields'
+        : `not an object (got ${typeof rawConfig})`;
+    throw new Error(`Invalid configuration format at ${options.configPath}.\n` +
+        `Configuration ${configType}.\n\n` +
+        `Expected either:\n` +
+        `  1. Multi-environment: { version: 1, environments: { prod: { flow: {...}, build: {...} } } }\n` +
+        `  2. Single-environment: { flow: { platform: "web" | "server", ... }, build: { packages: {...}, ... } }`);
+}
+/**
+ * Load multi-environment configuration.
+ */
+function loadMultiEnvironmentConfig(setup, options) {
+    const availableEnvironments = Object.keys(setup.environments);
+    // Validate environment selection
+    if (!options.environment) {
+        throw new Error(`Multi-environment configuration detected. Please specify an environment using --env flag.\n` +
+            `Available environments: ${availableEnvironments.join(', ')}`);
+    }
+    const selectedEnv = options.environment;
+    if (!setup.environments[selectedEnv]) {
+        throw new Error(`Environment "${selectedEnv}" not found in configuration.\n` +
+            `Available environments: ${availableEnvironments.join(', ')}`);
+    }
+    // Get the environment config
+    const envConfig = setup.environments[selectedEnv];
+    // Normalize flow and build configs separately
+    const { flowConfig, buildOptions } = normalizeConfigs(envConfig, options.configPath);
+    if (options.logger) {
+        options.logger.info(`📦 Using environment: ${selectedEnv} (${availableEnvironments.length} total)`);
+    }
+    return {
+        flowConfig,
+        buildOptions,
+        environment: selectedEnv,
+        isMultiEnvironment: true,
+        availableEnvironments,
+    };
+}
+/**
+ * Load single-environment configuration.
+ */
+function loadSingleEnvironmentConfig(config, options) {
+    // Normalize the configs
+    const { flowConfig, buildOptions } = normalizeConfigs(config, options.configPath);
+    if (options.logger && options.environment) {
+        options.logger.warn(`--env flag specified but configuration is single-environment. Ignoring flag.`);
+    }
+    return {
+        flowConfig,
+        buildOptions,
+        environment: 'default',
+        isMultiEnvironment: false,
+    };
+}
+// Legacy format support removed in v0.3.0
+// Migration: Convert old format { platform, sources, destinations, packages, code, output }
+// To new format: { flow: { platform, sources, destinations }, build: { packages, code, output } }
+// See docs/MIGRATION.md for details
+/**
+ * Load all environments from a multi-environment configuration.
+ *
+ * @remarks
+ * Used by the --all flag to build all environments.
+ *
+ * @param rawConfig - Raw configuration object
+ * @param options - Loading options
+ * @returns Array of loaded configurations for all environments
+ */
+export function loadAllEnvironments(rawConfig, options) {
+    // Must be a multi-environment config
+    if (!isMultiEnvConfig(rawConfig)) {
+        throw new Error(`--all flag requires a multi-environment configuration (Setup format).\n` +
+            `Your configuration appears to be single-environment.`);
+    }
+    const setup = rawConfig;
+    const environments = Object.keys(setup.environments);
+    if (options.logger) {
+        options.logger.info(`📦 Loading all ${environments.length} environments: ${environments.join(', ')}`);
+    }
+    // Load each environment
+    return environments.map((envName) => loadMultiEnvironmentConfig(setup, {
+        ...options,
+        environment: envName,
+    }));
+}
+/**
+ * Get list of available environments from configuration.
+ *
+ * @param rawConfig - Raw configuration object
+ * @returns Array of environment names, or empty array for single-environment configs
+ */
+export function getAvailableEnvironments(rawConfig) {
+    if (isMultiEnvConfig(rawConfig)) {
+        return Object.keys(rawConfig.environments);
+    }
+    return [];
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

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

package/dist/config/parser.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Configuration Parser
+ *
+ * Parsing and normalization logic for configurations.
+ */
+import type { Flow } from '@walkeros/core';
+import type { BuildOptions, EnvironmentConfig } from '../types/bundle';
+/**
+ * Result of parsing bundle configuration.
+ */
+export interface ParsedConfig {
+    flowConfig: Flow.Config;
+    buildOptions: BuildOptions;
+}
+/**
+ * Parse and normalize bundle configuration.
+ *
+ * @param data - Raw configuration data (EnvironmentConfig format: { flow, build })
+ * @returns Normalized flowConfig and buildOptions with platform-specific defaults
+ * @throws Error if validation fails
+ *
+ * @example
+ * ```typescript
+ * const { flowConfig, buildOptions } = parseBundleConfig({
+ *   flow: {
+ *     platform: 'web',
+ *     sources: { browser: {...} },
+ *     destinations: { gtag: {...} }
+ *   },
+ *   build: {
+ *     packages: { '@walkeros/core': {...} },
+ *     code: '...',
+ *     output: './dist/bundle.js'
+ *   }
+ * });
+ * ```
+ */
+export declare function parseBundleConfig(data: unknown): ParsedConfig;
+/**
+ * Safely parse bundle configuration without throwing.
+ *
+ * @param data - Raw configuration data
+ * @returns Success result with normalized configs or error result
+ */
+export declare function safeParseBundleConfig(data: unknown): {
+    success: boolean;
+    data?: ParsedConfig;
+    error?: Error;
+};
+/**
+ * Normalize flow and build configurations with platform-specific defaults.
+ *
+ * @param config - Environment configuration or flow+build object
+ * @param configPath - Path to config file (for relative template resolution)
+ * @returns Normalized flow and build configurations
+ */
+export declare function normalizeConfigs(config: EnvironmentConfig | {
+    flow: Flow.Config;
+    build: Partial<BuildOptions>;
+}, configPath?: string): {
+    flowConfig: Flow.Config;
+    buildOptions: BuildOptions;
+};
+//# sourceMappingURL=parser.d.ts.map

package/dist/config/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/config/parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAKvE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;IACxB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,CAyC7D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAaA;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EACF,iBAAiB,GACjB;IAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;CAAE,EACvD,UAAU,CAAC,EAAE,MAAM,GAClB;IAAE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;IAAC,YAAY,EAAE,YAAY,CAAA;CAAE,CA6DzD"}