@walkeros/cli 0.4.1 → 0.5.0

package/dist/schemas/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * CLI Schemas
+ *
+ * Zod schemas for CLI parameter validation.
+ * Follows walkerOS patterns from @walkeros/core.
+ */
+export { RunModeSchema, PortSchema, FilePathSchema, type RunMode, } from './primitives';
+export { RunOptionsSchema, type RunOptions } from './run';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,aAAa,EACb,UAAU,EACV,cAAc,EACd,KAAK,OAAO,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,9 @@
+/**
+ * CLI Schemas
+ *
+ * Zod schemas for CLI parameter validation.
+ * Follows walkerOS patterns from @walkeros/core.
+ */
+export { RunModeSchema, PortSchema, FilePathSchema, } from './primitives';
+export { RunOptionsSchema } from './run';
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,aAAa,EACb,UAAU,EACV,cAAc,GAEf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,gBAAgB,EAAmB,MAAM,OAAO,CAAC"}

package/dist/schemas/primitives.d.ts

@@ -0,0 +1,37 @@
+/**
+ * CLI Primitive Schemas
+ *
+ * Basic Zod schemas for CLI parameter validation.
+ * Follows walkerOS patterns from @walkeros/core.
+ */
+import { z } from '@walkeros/core/dev';
+/**
+ * Run mode schema.
+ *
+ * @remarks
+ * Validates CLI run mode for the `run` command.
+ * - `collect`: Run as event collector
+ * - `serve`: Run as HTTP server
+ */
+export declare const RunModeSchema: z.ZodEnum<{
+    collect: "collect";
+    serve: "serve";
+}>;
+export type RunMode = z.infer<typeof RunModeSchema>;
+/**
+ * Port number schema.
+ *
+ * @remarks
+ * Validates HTTP server port number.
+ * Must be integer between 1-65535.
+ */
+export declare const PortSchema: z.ZodNumber;
+/**
+ * File path schema.
+ *
+ * @remarks
+ * Basic string validation for file paths.
+ * File existence is checked separately (Zod can't check filesystem).
+ */
+export declare const FilePathSchema: z.ZodString;
+//# sourceMappingURL=primitives.d.ts.map

package/dist/schemas/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/schemas/primitives.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAC;AAEvC;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;EAE+B,CAAC;AAE1D,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,aAKe,CAAC;AAEvC;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,aAGc,CAAC"}

package/dist/schemas/primitives.js

@@ -0,0 +1,43 @@
+/**
+ * CLI Primitive Schemas
+ *
+ * Basic Zod schemas for CLI parameter validation.
+ * Follows walkerOS patterns from @walkeros/core.
+ */
+import { z } from '@walkeros/core/dev';
+/**
+ * Run mode schema.
+ *
+ * @remarks
+ * Validates CLI run mode for the `run` command.
+ * - `collect`: Run as event collector
+ * - `serve`: Run as HTTP server
+ */
+export const RunModeSchema = z
+    .enum(['collect', 'serve'])
+    .describe('CLI run mode: collect events or serve HTTP');
+/**
+ * Port number schema.
+ *
+ * @remarks
+ * Validates HTTP server port number.
+ * Must be integer between 1-65535.
+ */
+export const PortSchema = z
+    .number()
+    .int('Port must be an integer')
+    .min(1, 'Port must be at least 1')
+    .max(65535, 'Port must be at most 65535')
+    .describe('HTTP server port number');
+/**
+ * File path schema.
+ *
+ * @remarks
+ * Basic string validation for file paths.
+ * File existence is checked separately (Zod can't check filesystem).
+ */
+export const FilePathSchema = z
+    .string()
+    .min(1, 'File path cannot be empty')
+    .describe('Path to configuration file');
+//# sourceMappingURL=primitives.js.map

package/dist/schemas/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../src/schemas/primitives.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;KAC1B,QAAQ,CAAC,4CAA4C,CAAC,CAAC;AAI1D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC;KACxB,MAAM,EAAE;KACR,GAAG,CAAC,yBAAyB,CAAC;KAC9B,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;KACjC,GAAG,CAAC,KAAK,EAAE,4BAA4B,CAAC;KACxC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;KACnC,QAAQ,CAAC,4BAA4B,CAAC,CAAC"}

package/dist/schemas/run.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Run Command Schemas
+ *
+ * Zod schemas for run command options validation.
+ */
+import { z } from '@walkeros/core/dev';
+/**
+ * Run command options schema.
+ *
+ * @remarks
+ * Validates all options for the `walkeros run` command.
+ */
+export declare const RunOptionsSchema: z.ZodObject<{
+    mode: z.ZodEnum<{
+        collect: "collect";
+        serve: "serve";
+    }>;
+    flow: z.ZodString;
+    port: z.ZodDefault<z.ZodNumber>;
+    flowName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RunOptions = z.infer<typeof RunOptionsSchema>;
+//# sourceMappingURL=run.d.ts.map

package/dist/schemas/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/schemas/run.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAC;AAGvC;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;iBAK3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/schemas/run.js

@@ -0,0 +1,20 @@
+/**
+ * Run Command Schemas
+ *
+ * Zod schemas for run command options validation.
+ */
+import { z } from '@walkeros/core/dev';
+import { RunModeSchema, PortSchema, FilePathSchema } from './primitives';
+/**
+ * Run command options schema.
+ *
+ * @remarks
+ * Validates all options for the `walkeros run` command.
+ */
+export const RunOptionsSchema = z.object({
+    mode: RunModeSchema,
+    flow: FilePathSchema,
+    port: PortSchema.default(8080),
+    flowName: z.string().optional().describe('Specific flow name to run'),
+});
+//# sourceMappingURL=run.js.map

package/dist/schemas/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/schemas/run.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEzE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;CACtE,CAAC,CAAC"}

package/dist/types/bundle.d.ts

@@ -1,154 +1,109 @@
 /**
  * CLI Build Configuration
  *
- * Build-time options for the walkerOS CLI bundle generation.
- * Completely separate from Flow.Config (runtime configuration).
+ * CLI-specific build options for walkerOS bundle generation.
+ * Uses Flow.Setup and Flow.Config from @walkeros/core for config structure.
  *
  * @packageDocumentation
  */
 import type { Flow } from '@walkeros/core';
 import type { BuildOptions as ESBuildOptions } from 'esbuild';
+export type { Flow };
 /**
- * Build options for bundle generation.
+ * CLI-specific build options (public API).
  *
  * @remarks
- * Contains all CLI-specific build settings including:
- * - Package management (NPM packages to bundle)
- * - Code injection (custom user code)
- * - Output configuration (file paths, formats)
- * - Esbuild settings (minification, source maps, etc.)
+ * These are CLI-only options not part of the config file.
+ * The config file uses Flow.Setup from @walkeros/core.
  *
- * Completely separate from Flow.Config which handles runtime event processing.
+ * Platform-derived defaults:
+ * - web: format=iife, target=es2020, platform=browser
+ * - server: format=esm, target=node18, platform=node
  */
-export interface BuildOptions extends Pick<ESBuildOptions, 'format' | 'target' | 'minify' | 'sourcemap' | 'platform' | 'external'> {
+export interface CLIBuildOptions extends Pick<ESBuildOptions, 'external'> {
     /**
-     * NPM packages to bundle.
-     *
-     * @remarks
-     * Maps package name to version and imports configuration.
-     * Packages are downloaded from npm and bundled into the output.
-     *
-     * @example
-     * ```json
-     * {
-     *   "@walkeros/core": {
-     *     "version": "^0.2.0",
-     *     "imports": ["getId", "tryCatch"]
-     *   }
-     * }
-     * ```
+     * Output file path (CLI argument, not in config).
+     * @default "./dist/walker.js" (web) or "./dist/bundle.mjs" (server)
      */
-    packages: Record<string, {
-        version?: string;
-        imports?: string[];
-    }>;
+    output?: string;
+    /**
+     * Temporary directory for build artifacts.
+     * @default ".tmp"
+     */
+    tempDir?: string;
+    /**
+     * Enable package caching.
+     * @default true
+     */
+    cache?: boolean;
     /**
      * User code to include in bundle.
-     *
-     * @remarks
-     * Optional custom JavaScript/TypeScript code that will be included in the bundle.
-     * Can reference imported packages and will be executed when bundle loads.
-     * If omitted, the template's default behavior will be used.
-     *
-     * @default ""
-     *
-     * @example
-     * ```typescript
-     * "export default () => startFlow({ sources: {...}, destinations: {...} })"
-     * ```
      */
     code?: string;
+}
+/**
+ * Internal build options used by the bundler.
+ *
+ * @remarks
+ * Combines CLI options with resolved esbuild settings.
+ * This is populated after processing config and CLI arguments.
+ */
+export interface BuildOptions extends CLIBuildOptions {
     /**
-     * Output file path.
-     *
-     * @remarks
-     * Absolute or relative path for the generated bundle.
-     * Directory will be created if it doesn't exist.
-     *
-     * @default "./dist/walker.js" (web) or "./dist/bundle.js" (server)
-     *
-     * @example
-     * "./dist/walker.min.js"
+     * Output file path (required for bundler).
      */
     output: string;
     /**
-     * Temporary directory for build artifacts.
-     *
-     * @remarks
-     * Used for:
-     * - Downloaded packages
-     * - Generated entry points
-     * - Intermediate build files
-     *
-     * Cleaned up after successful build unless shared with simulator.
-     *
-     * @default ".tmp"
+     * Packages to include in the bundle.
      */
-    tempDir?: string;
+    packages: Flow.Packages;
     /**
-     * Custom template file path.
-     *
-     * @remarks
-     * Override the default template (base.hbs or server.hbs).
-     * Template receives variables: {{sources}}, {{destinations}}, {{collector}}, {{{CODE}}}
-     *
-     * @default undefined (uses platform-specific default)
-     *
-     * @example
-     * "./templates/custom.hbs"
+     * Output format.
      */
-    template?: string;
+    format: 'esm' | 'iife' | 'cjs';
     /**
-     * Enable package caching.
-     *
-     * @remarks
-     * When enabled, downloaded packages are cached for faster subsequent builds.
-     *
+     * Target platform.
+     */
+    platform: 'browser' | 'node';
+    /**
+     * Enable minification.
      * @default true
      */
-    cache?: boolean;
+    minify?: boolean;
+    /**
+     * Enable source maps.
+     * @default false
+     */
+    sourcemap?: boolean;
+    /**
+     * ECMAScript target version.
+     */
+    target?: string;
     /**
      * Minification options.
-     *
-     * @remarks
-     * Fine-tune minification behavior.
-     * Only applies when minify=true.
      */
     minifyOptions?: MinifyOptions;
     /**
-     * Window property name for collector instance (web platform only).
-     *
-     * @remarks
-     * Only used when platform=browser and format=iife.
-     * The collector instance will be assigned to window[windowCollector].
-     * Ignored for server platform.
-     *
+     * Window property name for collector (web platform only).
      * @default "collector"
-     *
-     * @example
-     * ```json
-     * {
-     *   "build": {
-     *     "windowCollector": "tracker",
-     *     "windowElb": "track"
-     *   }
-     * }
-     * ```
-     *
-     * Results in: `window.tracker = collector; window.track = elb;`
      */
     windowCollector?: string;
     /**
      * Window property name for elb function (web platform only).
-     *
-     * @remarks
-     * Only used when platform=browser and format=iife.
-     * The elb function will be assigned to window[windowElb].
-     * Ignored for server platform.
-     *
      * @default "elb"
      */
     windowElb?: string;
+    /**
+     * Folders to include in the output directory.
+     * These folders are copied alongside the bundle for runtime access.
+     * @default ["./shared"] if folder exists
+     */
+    include?: string[];
+    /**
+     * Base directory for resolving include paths.
+     * Typically the directory containing the config file.
+     */
+    configDir?: string;
 }
 /**
  * Minification options.
@@ -159,110 +114,28 @@ export interface BuildOptions extends Pick<ESBuildOptions, 'format' | 'target' |
 export interface MinifyOptions {
     /**
      * Minify identifiers (variable names).
-     *
      * @default true
      */
     identifiers?: boolean;
     /**
      * Minify syntax (shorten code).
-     *
      * @default true
      */
     syntax?: boolean;
     /**
      * Minify whitespace.
-     *
      * @default true
      */
     whitespace?: boolean;
     /**
      * Keep original function/class names.
-     *
-     * @remarks
-     * Useful for debugging production bundles.
-     *
      * @default false
      */
     keepNames?: boolean;
     /**
      * How to handle legal comments.
-     *
      * @default "none"
      */
     legalComments?: 'none' | 'inline' | 'eof' | 'linked' | 'external';
 }
-/**
- * Single environment configuration.
- *
- * @remarks
- * Combines Flow.Config (runtime) with BuildOptions (build-time).
- * This is the structure stored in config files for each environment.
- */
-export interface EnvironmentConfig {
-    /**
-     * Runtime event processing configuration.
-     *
-     * @remarks
-     * Defines sources, destinations, collector settings.
-     * From @walkeros/core - platform-agnostic.
-     */
-    flow: Flow.Config;
-    /**
-     * Build-time configuration.
-     *
-     * @remarks
-     * Defines how to bundle the flow configuration.
-     * CLI-specific settings.
-     */
-    build: BuildOptions;
-}
-/**
- * Multi-environment setup configuration.
- *
- * @remarks
- * Top-level config file format supporting multiple deployment environments.
- * Each environment has separate flow and build configurations.
- *
- * @example
- * ```json
- * {
- *   "version": 1,
- *   "variables": {
- *     "GA_ID": "G-XXXXXXXXXX"
- *   },
- *   "environments": {
- *     "production": {
- *       "flow": { "platform": "web", ... },
- *       "build": { "packages": {...}, "output": "./dist/prod.js" }
- *     },
- *     "staging": {
- *       "flow": { "platform": "web", ... },
- *       "build": { "packages": {...}, "output": "./dist/staging.js" }
- *     }
- *   }
- * }
- * ```
- */
-export interface Setup {
-    /**
-     * Configuration schema version.
-     */
-    version: 1;
-    /**
-     * JSON Schema reference for IDE validation.
-     */
-    $schema?: string;
-    /**
-     * Shared variables for interpolation across all environments.
-     */
-    variables?: Record<string, string | number | boolean>;
-    /**
-     * Reusable configuration definitions.
-     */
-    definitions?: Record<string, unknown>;
-    /**
-     * Environments with flow and build configurations.
-     */
-    environments: Record<string, EnvironmentConfig>;
-}
 //# sourceMappingURL=bundle.d.ts.map

package/dist/types/bundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../src/types/bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,IAAI,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YACf,SAAQ,IAAI,CACV,cAAc,EACZ,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,UAAU,GACV,UAAU,CACb;IACD;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAEnE;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;;;;;;OAWG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,CAAC;CACnE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,OAAO,EAAE,CAAC,CAAC;IAEX;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAEtD;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEtC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACjD"}
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../src/types/bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,IAAI,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9D,YAAY,EAAE,IAAI,EAAE,CAAC;AAErB;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eACf,SAAQ,IAAI,CACV,cAAc,EACd,UAAU,CACX;IACD;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC;IAExB;;OAEG;IACH,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IAE/B;;OAEG;IACH,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC;IAE7B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,CAAC;CACnE"}

package/dist/types/bundle.js

@@ -1,8 +1,8 @@
 /**
  * CLI Build Configuration
  *
- * Build-time options for the walkerOS CLI bundle generation.
- * Completely separate from Flow.Config (runtime configuration).
+ * CLI-specific build options for walkerOS bundle generation.
+ * Uses Flow.Setup and Flow.Config from @walkeros/core for config structure.
  *
  * @packageDocumentation
  */

package/dist/walker.js

@@ -0,0 +1 @@
+"use strict";(()=>{var o=Object.defineProperty;var s={};((t,e)=>{for(var n in e)o(t,n,{get:e[n],enumerable:!0})})(s,{Level:()=>r});var r=(t=>(t[t.ERROR=0]="ERROR",t[t.INFO=1]="INFO",t[t.DEBUG=2]="DEBUG",t))(r||{});})();

package/examples/README.md

@@ -1,5 +1,17 @@
 # walkerOS Flow Examples
 
+## Installation
+
+These are example configurations - see the main [CLI README](../README.md) for
+installation.
+
+## Usage
+
+Use `walkeros bundle <example>.json` to build any example, then `walkeros run`
+to execute.
+
+---
+
 This directory contains example flow configurations demonstrating various
 walkerOS use cases.
 
@@ -229,44 +241,57 @@ Browser → destinationAPI (POST /collect) → sourceExpress → destinationData
 
 ### Flow Configuration Structure
 
+Flow configs use the `Flow.Setup` format:
+
 ```json
 {
-  "flow": {
-    "platform": "web" | "server",
-    "sources": {
-      "<source_name>": {
-        "code": "<imported_function_name>",
-        "config": { "settings": { /* source config */ } }
-      }
-    },
-    "destinations": {
-      "<destination_name>": {
-        "code": "<imported_function_name>",
-        "config": {
-          "settings": { /* destination config */ },
-          "mapping": { /* event mappings */ }
+  "version": 1,
+  "flows": {
+    "default": {
+      "web": {},
+      "packages": {
+        "<package_name>": { "imports": ["<function_name>"] }
+      },
+      "sources": {
+        "<source_name>": {
+          "code": "<imported_function_name>",
+          "config": {
+            "settings": {
+              /* source config */
+            }
+          }
+        }
+      },
+      "destinations": {
+        "<destination_name>": {
+          "code": "<imported_function_name>",
+          "config": {
+            "settings": {
+              /* destination config */
+            },
+            "mapping": {
+              /* event mappings */
+            }
+          }
+        }
+      },
+      "collector": {
+        "run": true,
+        "globals": {
+          /* global properties */
         }
       }
-    },
-    "collector": {
-      "run": true,
-      "globals": { /* global properties */ }
     }
-  },
-  "build": {
-    "packages": {
-      "<package_name>": {
-        "version": "latest",
-        "imports": ["<function_name>"]
-      }
-    },
-    "code": "// Optional custom code\n",
-    "template": "templates/base.hbs",
-    "output": "./dist/bundle.js"
   }
 }
 ```
 
+**Key points:**
+
+- Platform via `web: {}` or `server: {}` key (not `platform: "web"`)
+- Output path is convention-based: `./dist/walker.js` (web) or
+  `./dist/bundle.mjs` (server)
+
 ### Available Sources
 
 **Web**:
@@ -327,4 +352,4 @@ The event name is parsed as: `const [entity, action] = event.split(' ')`
 1. Try each example with `walkeros bundle` and `walkeros simulate`
 2. Modify examples to match your tracking requirements
 3. Create custom flow files for your use case
-4. Deploy to production (see [PUBLISHING.md](../docs/PUBLISHING.md))
+4. Deploy to production