@walkeros/cli 1.3.0 → 1.4.0-next-1771252576264

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @walkeros/cli
 
+## 1.4.0-next-1771252576264
+
+### Minor Changes
+
+- 7b2d750: Add walkerOS.json package convention for CDN-based schema discovery
+
+### Patch Changes
+
+- 1ae6972: Fix missing trailing newline in JSON output
+- Updated dependencies [7b2d750]
+  - @walkeros/core@1.4.0-next-1771252576264
+  - @walkeros/server-core@1.0.6-next-1771252576264
+
 ## 1.3.0
 
 ### Minor Changes

package/dist/dev.d.ts

@@ -75,11 +75,11 @@ type RunOptions = z.infer<typeof RunOptionsSchema>;
  * - `flow`: Validate a flow configuration file
  * - `mapping`: Validate mapping rules
  */
-declare const ValidationTypeSchema: z.ZodEnum<{
+declare const ValidationTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
     flow: "flow";
     event: "event";
     mapping: "mapping";
-}>;
+}>, z.ZodString]>;
 type ValidationType = z.infer<typeof ValidationTypeSchema>;
 /**
  * Validate options schema.
@@ -99,11 +99,11 @@ type ValidateOptions = z.infer<typeof ValidateOptionsSchema>;
  * rather than ZodObject instances. Define shape first, then wrap.
  */
 declare const ValidateInputShape: {
-    type: z.ZodEnum<{
+    type: z.ZodUnion<readonly [z.ZodEnum<{
         flow: "flow";
         event: "event";
         mapping: "mapping";
-    }>;
+    }>, z.ZodString]>;
     input: z.ZodString;
     flow: z.ZodOptional<z.ZodString>;
 };
@@ -114,11 +114,11 @@ declare const ValidateInputShape: {
  * Full input schema including type and input source.
  */
 declare const ValidateInputSchema: z.ZodObject<{
-    type: z.ZodEnum<{
+    type: z.ZodUnion<readonly [z.ZodEnum<{
         flow: "flow";
         event: "event";
         mapping: "mapping";
-    }>;
+    }>, z.ZodString]>;
     input: z.ZodString;
     flow: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;

package/dist/dev.js

@@ -44,7 +44,12 @@ var RunOptionsSchema = z2.object({
 
 // 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 ValidationTypeSchema = z3.union([
+  z3.enum(["event", "flow", "mapping"]),
+  z3.string().regex(/^(destinations|sources|transformers)\.\w+$|^\w+$/)
+]).describe(
+  'Validation type: "event", "flow", "mapping", or dot-notation path (e.g., "destinations.snowplow") to validate a specific entry against its package schema'
+);
 var ValidateOptionsSchema = z3.object({
   flow: z3.string().optional().describe("Flow name for multi-flow configs")
 });

package/dist/dev.js.map

@@ -1 +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"]}
+{"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  .union([\n    z.enum(['event', 'flow', 'mapping']),\n    z.string().regex(/^(destinations|sources|transformers)\\.\\w+$|^\\w+$/),\n  ])\n  .describe(\n    'Validation type: \"event\", \"flow\", \"mapping\", or dot-notation path ' +\n      '(e.g., \"destinations.snowplow\") to validate a specific entry against its package schema',\n  );\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

@@ -70,6 +70,7 @@
           "package": "@walkeros/web-source-datalayer",
           "next": "enricher",
           "config": {
+            "require": ["session"],
             "settings": {
               "name": "dataLayer",
               "prefix": "gtag"
@@ -219,6 +220,7 @@
         "ga4": {
           "package": "@walkeros/web-destination-gtag",
           "config": {
+            "require": ["consent", "user"],
             "consent": { "marketing": true },
             "settings": {
               "ga4": { "measurementId": "$var.ga4MeasurementId" }

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 (53)
+### Features Used (55)
 
 #### Mapping - Value Extraction
 
@@ -118,13 +118,14 @@ npx walkeros serve packages/cli/examples/flow-complete.json --flow web
 
 #### Sources
 
-| Feature              | Location  | Example                               |
-| -------------------- | --------- | ------------------------------------- |
-| Primary source       | browser   | `"primary": true`                     |
-| Multiple sources     | web flow  | browser + dataLayer + demo            |
-| Source-level mapping | dataLayer | `"mapping": { "add_to_cart": {...} }` |
-| Pre-collector chain  | dataLayer | `"next": "dataLayerValidator"`        |
-| Demo source events   | demo      | Pre-configured test events            |
+| Feature                 | Location  | Example                               |
+| ----------------------- | --------- | ------------------------------------- |
+| Primary source          | browser   | `"primary": true`                     |
+| Multiple sources        | web flow  | browser + dataLayer + demo            |
+| Source-level mapping    | dataLayer | `"mapping": { "add_to_cart": {...} }` |
+| Pre-collector chain     | dataLayer | `"next": "dataLayerValidator"`        |
+| Require (deferred init) | dataLayer | `"require": ["session"]`              |
+| Demo source events      | demo      | Pre-configured test events            |
 
 #### Transformers
 
@@ -139,12 +140,13 @@ npx walkeros serve packages/cli/examples/flow-complete.json --flow web
 
 #### Destinations
 
-| Feature               | Location         | Example                            |
-| --------------------- | ---------------- | ---------------------------------- |
-| Destination consent   | GA4              | `"consent": { "marketing": true }` |
-| Destination mapping   | All destinations | Entity/action to vendor events     |
-| Multiple destinations | Both flows       | GA4 + API, Meta + Demo             |
-| Batch option          | API              | `"batch": 5`                       |
+| Feature                 | Location         | Example                            |
+| ----------------------- | ---------------- | ---------------------------------- |
+| Require (deferred init) | GA4              | `"require": ["consent", "user"]`   |
+| Destination consent     | GA4              | `"consent": { "marketing": true }` |
+| Destination mapping     | All destinations | Entity/action to vendor events     |
+| Multiple destinations   | Both flows       | GA4 + API, Meta + Demo             |
+| Batch option            | API              | `"batch": 5`                       |
 
 #### Collector