@walkeros/cli 1.1.3 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @walkeros/cli
 
+## 1.3.0
+
+### Minor Changes
+
+- 087eb2d: Restructure CLI with auth, projects, flows command groups; MCP wraps
+  CLI functions instead of reimplementing API logic
+- 087eb2d: Add Unix-standard stdio support: results to stdout, logs to stderr,
+  stdin auto-detection, -o for file output
+
+### Patch Changes
+
+- Updated dependencies [a4cc1ea]
+  - @walkeros/core@1.3.0
+  - @walkeros/server-core@1.0.5
+
+## 1.2.0
+
+### Minor Changes
+
+- cc68f50: Add validate command for events, flows, and mappings
+  - `walkeros validate event` - validates event structure using
+    PartialEventSchema
+  - `walkeros validate flow` - validates flow configurations using SetupSchema
+  - `walkeros validate mapping` - validates mapping event patterns
+
+  Includes programmatic API via `import { validate } from '@walkeros/cli'`
+
 ## 1.1.3
 
 ### Patch Changes

package/README.md

@@ -575,7 +575,8 @@ walkeros bundle flow.json --dockerfile Dockerfile.custom
 
 - `MODE` - `collect` or `serve` (default: `collect`)
 - `PORT` - Server port (default: `8080`)
-- `BUNDLE` - Bundle path (default: `/app/flow/bundle.mjs`)
+- `BUNDLE` - Bundle file path or URL (default: `/app/flow/bundle.mjs`). Also
+  accepts stdin pipe: `cat flow.mjs | docker run -i walkeros/flow`
 
 ### Using Node.js
 

package/dist/dev.d.ts

@@ -0,0 +1,328 @@
+import { z } from '@walkeros/core/dev';
+
+/**
+ * CLI Primitive Schemas
+ *
+ * Basic Zod schemas for CLI parameter validation.
+ * Follows walkerOS patterns from @walkeros/core.
+ */
+
+/**
+ * Run mode schema.
+ *
+ * @remarks
+ * Validates CLI run mode for the `run` command.
+ * - `collect`: Run as event collector
+ * - `serve`: Run as HTTP server
+ */
+declare const RunModeSchema: z.ZodEnum<{
+    collect: "collect";
+    serve: "serve";
+}>;
+type RunMode = z.infer<typeof RunModeSchema>;
+/**
+ * Port number schema.
+ *
+ * @remarks
+ * Validates HTTP server port number.
+ * Must be integer between 1-65535.
+ */
+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).
+ */
+declare const FilePathSchema: z.ZodString;
+
+/**
+ * Run Command Schemas
+ *
+ * Zod schemas for run command options validation.
+ */
+
+/**
+ * Run command options schema.
+ *
+ * @remarks
+ * Validates all options for the `walkeros run` command.
+ */
+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>;
+type RunOptions = z.infer<typeof RunOptionsSchema>;
+
+/**
+ * Validate Command Schemas
+ *
+ * Zod schemas for validate command parameter validation.
+ */
+
+/**
+ * Validation type schema.
+ *
+ * @remarks
+ * Validates the type of validation to perform.
+ * - `event`: Validate a walkerOS event object
+ * - `flow`: Validate a flow configuration file
+ * - `mapping`: Validate mapping rules
+ */
+declare const ValidationTypeSchema: z.ZodEnum<{
+    flow: "flow";
+    event: "event";
+    mapping: "mapping";
+}>;
+type ValidationType = z.infer<typeof ValidationTypeSchema>;
+/**
+ * Validate options schema.
+ *
+ * @remarks
+ * Options for the programmatic validate() API.
+ */
+declare const ValidateOptionsSchema: z.ZodObject<{
+    flow: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ValidateOptions = z.infer<typeof ValidateOptionsSchema>;
+/**
+ * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).
+ *
+ * @remarks
+ * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)
+ * rather than ZodObject instances. Define shape first, then wrap.
+ */
+declare const ValidateInputShape: {
+    type: z.ZodEnum<{
+        flow: "flow";
+        event: "event";
+        mapping: "mapping";
+    }>;
+    input: z.ZodString;
+    flow: z.ZodOptional<z.ZodString>;
+};
+/**
+ * Validate input schema for MCP tools.
+ *
+ * @remarks
+ * Full input schema including type and input source.
+ */
+declare const ValidateInputSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        flow: "flow";
+        event: "event";
+        mapping: "mapping";
+    }>;
+    input: z.ZodString;
+    flow: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ValidateInput = z.infer<typeof ValidateInputSchema>;
+
+/**
+ * Bundle Command Schemas
+ *
+ * Zod schemas for bundle command parameter validation.
+ */
+
+/**
+ * Bundle options schema.
+ *
+ * @remarks
+ * Options for the programmatic bundle() API.
+ */
+declare const BundleOptionsSchema: z.ZodObject<{
+    silent: z.ZodOptional<z.ZodBoolean>;
+    verbose: z.ZodOptional<z.ZodBoolean>;
+    stats: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    cache: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    flowName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type BundleOptions = z.infer<typeof BundleOptionsSchema>;
+/**
+ * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).
+ *
+ * @remarks
+ * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)
+ * rather than ZodObject instances. Define shape first, then wrap.
+ */
+declare const BundleInputShape: {
+    configPath: z.ZodString;
+    flow: z.ZodOptional<z.ZodString>;
+    stats: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    output: z.ZodOptional<z.ZodString>;
+};
+/**
+ * Bundle input schema for MCP tools.
+ *
+ * @remarks
+ * Full input schema including config path and options.
+ */
+declare const BundleInputSchema: z.ZodObject<{
+    configPath: z.ZodString;
+    flow: z.ZodOptional<z.ZodString>;
+    stats: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    output: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type BundleInput = z.infer<typeof BundleInputSchema>;
+
+/**
+ * Simulate Command Schemas
+ *
+ * Zod schemas for simulate command parameter validation.
+ */
+
+/**
+ * Platform schema.
+ *
+ * @remarks
+ * Validates platform type for event simulation.
+ */
+declare const PlatformSchema: z.ZodEnum<{
+    web: "web";
+    server: "server";
+}>;
+type Platform = z.infer<typeof PlatformSchema>;
+/**
+ * Simulate options schema.
+ *
+ * @remarks
+ * Options for the programmatic simulate() API.
+ */
+declare const SimulateOptionsSchema: z.ZodObject<{
+    silent: z.ZodOptional<z.ZodBoolean>;
+    verbose: z.ZodOptional<z.ZodBoolean>;
+    json: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type SimulateOptions = z.infer<typeof SimulateOptionsSchema>;
+/**
+ * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).
+ *
+ * @remarks
+ * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)
+ * rather than ZodObject instances. Define shape first, then wrap.
+ */
+declare const SimulateInputShape: {
+    configPath: z.ZodString;
+    event: z.ZodString;
+    flow: z.ZodOptional<z.ZodString>;
+    platform: z.ZodOptional<z.ZodEnum<{
+        web: "web";
+        server: "server";
+    }>>;
+};
+/**
+ * Simulate input schema for MCP tools.
+ *
+ * @remarks
+ * Full input schema including config path, event, and options.
+ */
+declare const SimulateInputSchema: z.ZodObject<{
+    configPath: z.ZodString;
+    event: z.ZodString;
+    flow: z.ZodOptional<z.ZodString>;
+    platform: z.ZodOptional<z.ZodEnum<{
+        web: "web";
+        server: "server";
+    }>>;
+}, z.core.$strip>;
+type SimulateInput = z.infer<typeof SimulateInputSchema>;
+
+/**
+ * Push Command Schemas
+ *
+ * Zod schemas for push command parameter validation.
+ */
+
+/**
+ * Push options schema.
+ *
+ * @remarks
+ * Options for the programmatic push() API.
+ */
+declare const PushOptionsSchema: z.ZodObject<{
+    silent: z.ZodOptional<z.ZodBoolean>;
+    verbose: z.ZodOptional<z.ZodBoolean>;
+    json: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type PushOptions = z.infer<typeof PushOptionsSchema>;
+/**
+ * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).
+ *
+ * @remarks
+ * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)
+ * rather than ZodObject instances. Define shape first, then wrap.
+ */
+declare const PushInputShape: {
+    configPath: z.ZodString;
+    event: z.ZodString;
+    flow: z.ZodOptional<z.ZodString>;
+    platform: z.ZodOptional<z.ZodEnum<{
+        web: "web";
+        server: "server";
+    }>>;
+};
+/**
+ * Push input schema for MCP tools.
+ *
+ * @remarks
+ * Full input schema including config path, event, and options.
+ */
+declare const PushInputSchema: z.ZodObject<{
+    configPath: z.ZodString;
+    event: z.ZodString;
+    flow: z.ZodOptional<z.ZodString>;
+    platform: z.ZodOptional<z.ZodEnum<{
+        web: "web";
+        server: "server";
+    }>>;
+}, z.core.$strip>;
+type PushInput = z.infer<typeof PushInputSchema>;
+
+/**
+ * CLI Schemas
+ *
+ * Zod schemas for CLI parameter validation.
+ * Follows walkerOS patterns from @walkeros/core.
+ */
+
+type index_BundleInput = BundleInput;
+declare const index_BundleInputSchema: typeof BundleInputSchema;
+declare const index_BundleInputShape: typeof BundleInputShape;
+type index_BundleOptions = BundleOptions;
+declare const index_BundleOptionsSchema: typeof BundleOptionsSchema;
+declare const index_FilePathSchema: typeof FilePathSchema;
+type index_Platform = Platform;
+declare const index_PlatformSchema: typeof PlatformSchema;
+declare const index_PortSchema: typeof PortSchema;
+type index_PushInput = PushInput;
+declare const index_PushInputSchema: typeof PushInputSchema;
+declare const index_PushInputShape: typeof PushInputShape;
+type index_PushOptions = PushOptions;
+declare const index_PushOptionsSchema: typeof PushOptionsSchema;
+type index_RunMode = RunMode;
+declare const index_RunModeSchema: typeof RunModeSchema;
+type index_RunOptions = RunOptions;
+declare const index_RunOptionsSchema: typeof RunOptionsSchema;
+type index_SimulateInput = SimulateInput;
+declare const index_SimulateInputSchema: typeof SimulateInputSchema;
+declare const index_SimulateInputShape: typeof SimulateInputShape;
+type index_SimulateOptions = SimulateOptions;
+declare const index_SimulateOptionsSchema: typeof SimulateOptionsSchema;
+type index_ValidateInput = ValidateInput;
+declare const index_ValidateInputSchema: typeof ValidateInputSchema;
+declare const index_ValidateInputShape: typeof ValidateInputShape;
+type index_ValidateOptions = ValidateOptions;
+declare const index_ValidateOptionsSchema: typeof ValidateOptionsSchema;
+type index_ValidationType = ValidationType;
+declare const index_ValidationTypeSchema: typeof ValidationTypeSchema;
+declare namespace index {
+  export { type index_BundleInput as BundleInput, index_BundleInputSchema as BundleInputSchema, index_BundleInputShape as BundleInputShape, type index_BundleOptions as BundleOptions, index_BundleOptionsSchema as BundleOptionsSchema, index_FilePathSchema as FilePathSchema, type index_Platform as Platform, index_PlatformSchema as PlatformSchema, index_PortSchema as PortSchema, type index_PushInput as PushInput, index_PushInputSchema as PushInputSchema, index_PushInputShape as PushInputShape, type index_PushOptions as PushOptions, index_PushOptionsSchema as PushOptionsSchema, type index_RunMode as RunMode, index_RunModeSchema as RunModeSchema, type index_RunOptions as RunOptions, index_RunOptionsSchema as RunOptionsSchema, type index_SimulateInput as SimulateInput, index_SimulateInputSchema as SimulateInputSchema, index_SimulateInputShape as SimulateInputShape, type index_SimulateOptions as SimulateOptions, index_SimulateOptionsSchema as SimulateOptionsSchema, type index_ValidateInput as ValidateInput, index_ValidateInputSchema as ValidateInputSchema, index_ValidateInputShape as ValidateInputShape, type index_ValidateOptions as ValidateOptions, index_ValidateOptionsSchema as ValidateOptionsSchema, type index_ValidationType as ValidationType, index_ValidationTypeSchema as ValidationTypeSchema };
+}
+
+export { index as schemas };

package/dist/dev.js

@@ -0,0 +1,110 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/schemas/index.ts
+var schemas_exports = {};
+__export(schemas_exports, {
+  BundleInputSchema: () => BundleInputSchema,
+  BundleInputShape: () => BundleInputShape,
+  BundleOptionsSchema: () => BundleOptionsSchema,
+  FilePathSchema: () => FilePathSchema,
+  PlatformSchema: () => PlatformSchema,
+  PortSchema: () => PortSchema,
+  PushInputSchema: () => PushInputSchema,
+  PushInputShape: () => PushInputShape,
+  PushOptionsSchema: () => PushOptionsSchema,
+  RunModeSchema: () => RunModeSchema,
+  RunOptionsSchema: () => RunOptionsSchema,
+  SimulateInputSchema: () => SimulateInputSchema,
+  SimulateInputShape: () => SimulateInputShape,
+  SimulateOptionsSchema: () => SimulateOptionsSchema,
+  ValidateInputSchema: () => ValidateInputSchema,
+  ValidateInputShape: () => ValidateInputShape,
+  ValidateOptionsSchema: () => ValidateOptionsSchema,
+  ValidationTypeSchema: () => ValidationTypeSchema
+});
+
+// src/schemas/primitives.ts
+import { z } from "@walkeros/core/dev";
+var RunModeSchema = z.enum(["collect", "serve"]).describe("CLI run mode: collect events or serve HTTP");
+var 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");
+var FilePathSchema = z.string().min(1, "File path cannot be empty").describe("Path to configuration file");
+
+// src/schemas/run.ts
+import { z as z2 } from "@walkeros/core/dev";
+var RunOptionsSchema = z2.object({
+  mode: RunModeSchema,
+  flow: FilePathSchema,
+  port: PortSchema.default(8080),
+  flowName: z2.string().optional().describe("Specific flow name to run")
+});
+
+// src/schemas/validate.ts
+import { z as z3 } from "@walkeros/core/dev";
+var ValidationTypeSchema = z3.enum(["event", "flow", "mapping"]).describe("Type of validation to perform");
+var ValidateOptionsSchema = z3.object({
+  flow: z3.string().optional().describe("Flow name for multi-flow configs")
+});
+var ValidateInputShape = {
+  type: ValidationTypeSchema,
+  input: z3.string().min(1).describe("JSON string, file path, or URL to validate"),
+  flow: z3.string().optional().describe("Flow name for multi-flow configs")
+};
+var ValidateInputSchema = z3.object(ValidateInputShape);
+
+// src/schemas/bundle.ts
+import { z as z4 } from "@walkeros/core/dev";
+var BundleOptionsSchema = z4.object({
+  silent: z4.boolean().optional().describe("Suppress all output"),
+  verbose: z4.boolean().optional().describe("Enable verbose logging"),
+  stats: z4.boolean().optional().default(true).describe("Return bundle statistics"),
+  cache: z4.boolean().optional().default(true).describe("Enable package caching"),
+  flowName: z4.string().optional().describe("Flow name for multi-flow configs")
+});
+var BundleInputShape = {
+  configPath: FilePathSchema.describe(
+    "Path to flow configuration file (JSON or JavaScript)"
+  ),
+  flow: z4.string().optional().describe("Flow name for multi-flow configs"),
+  stats: z4.boolean().optional().default(true).describe("Return bundle statistics"),
+  output: z4.string().optional().describe("Output file path (defaults to config-defined)")
+};
+var BundleInputSchema = z4.object(BundleInputShape);
+
+// src/schemas/simulate.ts
+import { z as z5 } from "@walkeros/core/dev";
+var PlatformSchema = z5.enum(["web", "server"]).describe("Platform type for event processing");
+var SimulateOptionsSchema = z5.object({
+  silent: z5.boolean().optional().describe("Suppress all output"),
+  verbose: z5.boolean().optional().describe("Enable verbose logging"),
+  json: z5.boolean().optional().describe("Format output as JSON")
+});
+var SimulateInputShape = {
+  configPath: FilePathSchema.describe("Path to flow configuration file"),
+  event: z5.string().min(1).describe("Event as JSON string, file path, or URL"),
+  flow: z5.string().optional().describe("Flow name for multi-flow configs"),
+  platform: PlatformSchema.optional().describe("Override platform detection")
+};
+var SimulateInputSchema = z5.object(SimulateInputShape);
+
+// src/schemas/push.ts
+import { z as z6 } from "@walkeros/core/dev";
+var PushOptionsSchema = z6.object({
+  silent: z6.boolean().optional().describe("Suppress all output"),
+  verbose: z6.boolean().optional().describe("Enable verbose logging"),
+  json: z6.boolean().optional().describe("Format output as JSON")
+});
+var PushInputShape = {
+  configPath: FilePathSchema.describe("Path to flow configuration file"),
+  event: z6.string().min(1).describe("Event as JSON string, file path, or URL"),
+  flow: z6.string().optional().describe("Flow name for multi-flow configs"),
+  platform: PlatformSchema.optional().describe("Override platform detection")
+};
+var PushInputSchema = z6.object(PushInputShape);
+export {
+  schemas_exports as schemas
+};
+//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas/index.ts","../src/schemas/primitives.ts","../src/schemas/run.ts","../src/schemas/validate.ts","../src/schemas/bundle.ts","../src/schemas/simulate.ts","../src/schemas/push.ts"],"sourcesContent":["/**\n * CLI Schemas\n *\n * Zod schemas for CLI parameter validation.\n * Follows walkerOS patterns from @walkeros/core.\n */\n\nexport {\n  RunModeSchema,\n  PortSchema,\n  FilePathSchema,\n  type RunMode,\n} from './primitives';\n\nexport { RunOptionsSchema, type RunOptions } from './run';\n\nexport {\n  ValidationTypeSchema,\n  ValidateOptionsSchema,\n  ValidateInputShape,\n  ValidateInputSchema,\n  type ValidationType,\n  type ValidateOptions,\n  type ValidateInput,\n} from './validate';\n\nexport {\n  BundleOptionsSchema,\n  BundleInputShape,\n  BundleInputSchema,\n  type BundleOptions,\n  type BundleInput,\n} from './bundle';\n\nexport {\n  PlatformSchema,\n  SimulateOptionsSchema,\n  SimulateInputShape,\n  SimulateInputSchema,\n  type Platform,\n  type SimulateOptions,\n  type SimulateInput,\n} from './simulate';\n\nexport {\n  PushOptionsSchema,\n  PushInputShape,\n  PushInputSchema,\n  type PushOptions,\n  type PushInput,\n} from './push';\n","/**\n * CLI Primitive Schemas\n *\n * Basic Zod schemas for CLI parameter validation.\n * Follows walkerOS patterns from @walkeros/core.\n */\n\nimport { z } from '@walkeros/core/dev';\n\n/**\n * Run mode schema.\n *\n * @remarks\n * Validates CLI run mode for the `run` command.\n * - `collect`: Run as event collector\n * - `serve`: Run as HTTP server\n */\nexport const RunModeSchema = z\n  .enum(['collect', 'serve'])\n  .describe('CLI run mode: collect events or serve HTTP');\n\nexport type RunMode = z.infer<typeof RunModeSchema>;\n\n/**\n * Port number schema.\n *\n * @remarks\n * Validates HTTP server port number.\n * Must be integer between 1-65535.\n */\nexport const PortSchema = z\n  .number()\n  .int('Port must be an integer')\n  .min(1, 'Port must be at least 1')\n  .max(65535, 'Port must be at most 65535')\n  .describe('HTTP server port number');\n\n/**\n * File path schema.\n *\n * @remarks\n * Basic string validation for file paths.\n * File existence is checked separately (Zod can't check filesystem).\n */\nexport const FilePathSchema = z\n  .string()\n  .min(1, 'File path cannot be empty')\n  .describe('Path to configuration file');\n","/**\n * Run Command Schemas\n *\n * Zod schemas for run command options validation.\n */\n\nimport { z } from '@walkeros/core/dev';\nimport { RunModeSchema, PortSchema, FilePathSchema } from './primitives';\n\n/**\n * Run command options schema.\n *\n * @remarks\n * Validates all options for the `walkeros run` command.\n */\nexport const RunOptionsSchema = z.object({\n  mode: RunModeSchema,\n  flow: FilePathSchema,\n  port: PortSchema.default(8080),\n  flowName: z.string().optional().describe('Specific flow name to run'),\n});\n\nexport type RunOptions = z.infer<typeof RunOptionsSchema>;\n","/**\n * Validate Command Schemas\n *\n * Zod schemas for validate command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\n\n/**\n * Validation type schema.\n *\n * @remarks\n * Validates the type of validation to perform.\n * - `event`: Validate a walkerOS event object\n * - `flow`: Validate a flow configuration file\n * - `mapping`: Validate mapping rules\n */\nexport const ValidationTypeSchema = z\n  .enum(['event', 'flow', 'mapping'])\n  .describe('Type of validation to perform');\n\nexport type ValidationType = z.infer<typeof ValidationTypeSchema>;\n\n/**\n * Validate options schema.\n *\n * @remarks\n * Options for the programmatic validate() API.\n */\nexport const ValidateOptionsSchema = z.object({\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n});\n\nexport type ValidateOptions = z.infer<typeof ValidateOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const ValidateInputShape = {\n  type: ValidationTypeSchema,\n  input: z\n    .string()\n    .min(1)\n    .describe('JSON string, file path, or URL to validate'),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n};\n\n/**\n * Validate input schema for MCP tools.\n *\n * @remarks\n * Full input schema including type and input source.\n */\nexport const ValidateInputSchema = z.object(ValidateInputShape);\n\nexport type ValidateInput = z.infer<typeof ValidateInputSchema>;\n","/**\n * Bundle Command Schemas\n *\n * Zod schemas for bundle command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\nimport { FilePathSchema } from './primitives';\n\n/**\n * Bundle options schema.\n *\n * @remarks\n * Options for the programmatic bundle() API.\n */\nexport const BundleOptionsSchema = z.object({\n  silent: z.boolean().optional().describe('Suppress all output'),\n  verbose: z.boolean().optional().describe('Enable verbose logging'),\n  stats: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('Return bundle statistics'),\n  cache: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('Enable package caching'),\n  flowName: z.string().optional().describe('Flow name for multi-flow configs'),\n});\n\nexport type BundleOptions = z.infer<typeof BundleOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const BundleInputShape = {\n  configPath: FilePathSchema.describe(\n    'Path to flow configuration file (JSON or JavaScript)',\n  ),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  stats: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('Return bundle statistics'),\n  output: z\n    .string()\n    .optional()\n    .describe('Output file path (defaults to config-defined)'),\n};\n\n/**\n * Bundle input schema for MCP tools.\n *\n * @remarks\n * Full input schema including config path and options.\n */\nexport const BundleInputSchema = z.object(BundleInputShape);\n\nexport type BundleInput = z.infer<typeof BundleInputSchema>;\n","/**\n * Simulate Command Schemas\n *\n * Zod schemas for simulate command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\nimport { FilePathSchema } from './primitives';\n\n/**\n * Platform schema.\n *\n * @remarks\n * Validates platform type for event simulation.\n */\nexport const PlatformSchema = z\n  .enum(['web', 'server'])\n  .describe('Platform type for event processing');\n\nexport type Platform = z.infer<typeof PlatformSchema>;\n\n/**\n * Simulate options schema.\n *\n * @remarks\n * Options for the programmatic simulate() API.\n */\nexport const SimulateOptionsSchema = z.object({\n  silent: z.boolean().optional().describe('Suppress all output'),\n  verbose: z.boolean().optional().describe('Enable verbose logging'),\n  json: z.boolean().optional().describe('Format output as JSON'),\n});\n\nexport type SimulateOptions = z.infer<typeof SimulateOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const SimulateInputShape = {\n  configPath: FilePathSchema.describe('Path to flow configuration file'),\n  event: z.string().min(1).describe('Event as JSON string, file path, or URL'),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  platform: PlatformSchema.optional().describe('Override platform detection'),\n};\n\n/**\n * Simulate input schema for MCP tools.\n *\n * @remarks\n * Full input schema including config path, event, and options.\n */\nexport const SimulateInputSchema = z.object(SimulateInputShape);\n\nexport type SimulateInput = z.infer<typeof SimulateInputSchema>;\n","/**\n * Push Command Schemas\n *\n * Zod schemas for push command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\nimport { FilePathSchema } from './primitives';\nimport { PlatformSchema } from './simulate';\n\n/**\n * Push options schema.\n *\n * @remarks\n * Options for the programmatic push() API.\n */\nexport const PushOptionsSchema = z.object({\n  silent: z.boolean().optional().describe('Suppress all output'),\n  verbose: z.boolean().optional().describe('Enable verbose logging'),\n  json: z.boolean().optional().describe('Format output as JSON'),\n});\n\nexport type PushOptions = z.infer<typeof PushOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const PushInputShape = {\n  configPath: FilePathSchema.describe('Path to flow configuration file'),\n  event: z.string().min(1).describe('Event as JSON string, file path, or URL'),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  platform: PlatformSchema.optional().describe('Override platform detection'),\n};\n\n/**\n * Push input schema for MCP tools.\n *\n * @remarks\n * Full input schema including config path, event, and options.\n */\nexport const PushInputSchema = z.object(PushInputShape);\n\nexport type PushInput = z.infer<typeof PushInputSchema>;\n"],"mappings":"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","names":["z","z","z","z","z","z","z","z","z"]}

package/dist/examples/flow-complete.json

@@ -250,7 +250,10 @@
                           "this",
                           {
                             "map": {
-                              "item_id": "data.id",
+                              "item_id": [
+                                { "key": "data.sku" },
+                                { "key": "data.id" }
+                              ],
                               "item_name": "data.name",
                               "item_category": "data.category",
                               "price": "data.price"
@@ -322,6 +325,12 @@
               "url": "$var.apiUrl",
               "batch": 5
             },
+            "data": {
+              "map": {
+                "sent_at": { "fn": "$code:() => Date.now()" },
+                "flow_version": "$var.flowVersion"
+              }
+            },
             "mapping": {
               "order": {
                 "complete": {

package/dist/examples/flow-complete.md

@@ -71,7 +71,7 @@ npx walkeros serve packages/cli/examples/flow-complete.json --flow web
 
 ## Feature Inventory
 
-### Features Used (51)
+### Features Used (53)
 
 #### Mapping - Value Extraction
 
@@ -81,6 +81,7 @@ npx walkeros serve packages/cli/examples/flow-complete.json --flow web
 | Static value      | Meta ViewContent  | `"content_type": { "value": "product" }`                     |
 | Key with fallback | GA4 add_to_cart   | `{ "key": "data.currency", "value": "$variables.currency" }` |
 | Nested key (deep) | dataLayer mapping | `"items.0.item_id"`                                          |
+| Fallback array    | GA4 view_item     | `[{ "key": "data.sku" }, { "key": "data.id" }]`              |
 
 #### Mapping - Structure
 
@@ -92,6 +93,7 @@ npx walkeros serve packages/cli/examples/flow-complete.json --flow web
 | Set (single value)    | Meta ViewContent   | `"content_ids": { "set": ["data.id"] }`                     |
 | Set (multiple values) | Meta settings      | `"external_id": { "set": ["user.device", "user.session"] }` |
 | Direct passthrough    | Meta PageView      | `"data": "data"`                                            |
+| Config-level data     | API destination    | `"data": { "map": { "sent_at": {...} } }`                   |
 
 #### Mapping - Control
 
@@ -175,36 +177,33 @@ npx walkeros serve packages/cli/examples/flow-complete.json --flow web
 
 ---
 
-### Features NOT Used (15)
+### Features NOT Used (6)
 
-#### Requires JavaScript (7)
+#### Now Available via $code: Prefix ✅
 
-These features cannot be used in pure JSON configurations:
+These features are now fully supported in JSON via `$code:` prefix (and ARE used
+in this example):
 
-| Feature                     | Reason                        |
-| --------------------------- | ----------------------------- |
-| `fn:` function              | Requires JavaScript callback  |
-| `condition:`                | Requires JavaScript predicate |
-| Conditional mapping (array) | Requires condition functions  |
-| Custom transformer code     | Requires JavaScript           |
-| Custom source code          | Requires JavaScript           |
-| Custom destination code     | Requires JavaScript           |
-| Event handler callbacks     | Requires JavaScript           |
+| Feature                     | Status                              |
+| --------------------------- | ----------------------------------- |
+| `fn:` function              | ✅ Used via `$code:` in GA4 value   |
+| `condition:`                | ✅ Used via `$code:` in definitions |
+| Conditional mapping (array) | ✅ Used in serverValidator          |
+| Custom transformer code     | ✅ Used in enricher, filter         |
+| Custom destination code     | ✅ Used in debug logger             |
 
-#### Omitted for Clarity (8)
+#### Omitted for Clarity (6)
 
 These features could be added but were omitted to keep the example focused:
 
-| Feature                   | Why Omitted                   |
-| ------------------------- | ----------------------------- |
-| Multiple named flows (3+) | Two flows sufficient for demo |
-| Queue config              | Advanced batching scenario    |
-| Retry config              | Advanced error handling       |
-| Custom fetch options      | API destination advanced      |
-| Dynamic routing           | Requires condition logic      |
-| Transform before send     | Covered by policy             |
-| Custom headers in API     | Would add complexity          |
-| Multiple validators       | One per flow sufficient       |
+| Feature                   | Why Omitted                    |
+| ------------------------- | ------------------------------ |
+| Multiple named flows (3+) | Two flows sufficient for demo  |
+| Queue config              | Advanced batching scenario     |
+| Retry config              | Advanced error handling        |
+| Custom fetch options      | API destination advanced       |
+| Custom headers in API     | Would add complexity           |
+| `validate:` function      | Could add via $code: if needed |
 
 ---