@walkeros/core 4.0.1 → 4.0.2

package/dist/dev.d.mts

@@ -4800,17 +4800,17 @@ declare namespace cache {
 }
 
 declare const MatchExpressionSchema: z.ZodType;
-declare const RoutableNextSchema: z.ZodType;
-declare const NextRuleSchema: z.ZodObject<{
+declare const RouteSpecSchema: z.ZodType;
+declare const RouteSchema: z.ZodObject<{
     match: z.ZodUnion<readonly [z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodLiteral<"*">]>;
     next: z.ZodLazy<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
 }, z.core.$strip>;
 
 declare const matcher_MatchExpressionSchema: typeof MatchExpressionSchema;
-declare const matcher_NextRuleSchema: typeof NextRuleSchema;
-declare const matcher_RoutableNextSchema: typeof RoutableNextSchema;
+declare const matcher_RouteSchema: typeof RouteSchema;
+declare const matcher_RouteSpecSchema: typeof RouteSpecSchema;
 declare namespace matcher {
-  export { matcher_MatchExpressionSchema as MatchExpressionSchema, matcher_NextRuleSchema as NextRuleSchema, matcher_RoutableNextSchema as RoutableNextSchema };
+  export { matcher_MatchExpressionSchema as MatchExpressionSchema, matcher_RouteSchema as RouteSchema, matcher_RouteSpecSchema as RouteSpecSchema };
 }
 
 declare const CodeSchema: z.ZodObject<{
@@ -5152,7 +5152,6 @@ declare const index_LoggerHandlerSchema: typeof LoggerHandlerSchema;
 declare const index_LoopSchema: typeof LoopSchema;
 declare const index_MapSchema: typeof MapSchema;
 declare const index_MatchExpressionSchema: typeof MatchExpressionSchema;
-declare const index_NextRuleSchema: typeof NextRuleSchema;
 declare const index_OptionalPrimitiveValue: typeof OptionalPrimitiveValue;
 declare const index_OrderedPropertiesSchema: typeof OrderedPropertiesSchema;
 type index_PackageInfo = PackageInfo;
@@ -5169,7 +5168,8 @@ declare const index_QueueConfig: typeof QueueConfig;
 declare const index_RequiredBoolean: typeof RequiredBoolean;
 declare const index_RequiredNumber: typeof RequiredNumber;
 declare const index_RequiredString: typeof RequiredString;
-declare const index_RoutableNextSchema: typeof RoutableNextSchema;
+declare const index_RouteSchema: typeof RouteSchema;
+declare const index_RouteSpecSchema: typeof RouteSpecSchema;
 declare const index_RuleSchema: typeof RuleSchema;
 declare const index_RulesSchema: typeof RulesSchema;
 declare const index_RuntimeInstanceConfig: typeof RuntimeInstanceConfig;
@@ -5225,7 +5225,7 @@ declare const index_valueJsonSchema: typeof valueJsonSchema;
 declare const index_z: typeof z;
 declare const index_zodToSchema: typeof zodToSchema;
 declare namespace index {
-  export { index_BaseContextConfig as BaseContextConfig, index_BatchConfig as BatchConfig, index_CacheRuleSchema as CacheRuleSchema, index_CacheSchema as CacheSchema, cache as CacheSchemas, index_ClickIdEntrySchema as ClickIdEntrySchema, index_CodeSchema as CodeSchema, collector as CollectorSchemas, index_ConsentSchema as ConsentSchema, index_ContractActionsSchema as ContractActionsSchema, index_ContractRuleSchema as ContractRuleSchema, index_ContractSchema as ContractSchema, index_ContractSchemaEntry as ContractSchemaEntry, index_Counter as Counter, index_DeepPartialEventSchema as DeepPartialEventSchema, destination as DestinationSchemas, index_DestinationsMapConfig as DestinationsMapConfig, index_EntitiesSchema as EntitiesSchema, index_EntitySchema as EntitySchema, index_EventSchema as EventSchema, BundlePackageSchema as FlowBundlePackageSchema, BundleSchema as FlowBundleSchema, CodeSchema$1 as FlowCodeSchema, ConfigSchema as FlowConfigSchema, DestinationSchema as FlowDestinationSchema, JsonSchema as FlowJsonSchema, index_FlowSchema as FlowSchema, flow as FlowSchemas, SourceSchema as FlowSourceSchema, StoreSchema as FlowStoreSchema, TransformerSchema as FlowTransformerSchema, index_GenericEnvConfig as GenericEnvConfig, index_GenericSettingsConfig as GenericSettingsConfig, index_HandlersConfig as HandlersConfig, index_HintSchema as HintSchema, index_HintsSchema as HintsSchema, index_IdConfig as IdConfig, index_Identifier as Identifier, InitConfig$1 as InitConfig, type index_IntelliSenseContext as IntelliSenseContext, type index_JSONSchema as JSONSchema, index_LoggerConfigSchema as LoggerConfigSchema, index_LoggerHandlerSchema as LoggerHandlerSchema, index_LoopSchema as LoopSchema, index_MapSchema as MapSchema, ResultSchema$1 as MappingResultSchema, mapping as MappingSchemas, index_MatchExpressionSchema as MatchExpressionSchema, matcher as MatcherSchemas, index_NextRuleSchema as NextRuleSchema, index_OptionalPrimitiveValue as OptionalPrimitiveValue, index_OrderedPropertiesSchema as OrderedPropertiesSchema, type index_PackageInfo as PackageInfo, index_PartialEventSchema as PartialEventSchema, index_PolicySchema as PolicySchema, index_PrimaryConfig as PrimaryConfig, index_PrimitiveValue as PrimitiveValue, index_ProcessingControlConfig as ProcessingControlConfig, index_PropertiesSchema as PropertiesSchema, type index_PropertyDef as PropertyDef, index_PropertySchema as PropertySchema, index_PropertyTypeSchema as PropertyTypeSchema, index_QueueConfig as QueueConfig, index_RequiredBoolean as RequiredBoolean, index_RequiredNumber as RequiredNumber, index_RequiredString as RequiredString, index_RoutableNextSchema as RoutableNextSchema, index_RuleSchema as RuleSchema, index_RulesSchema as RulesSchema, index_RuntimeInstanceConfig as RuntimeInstanceConfig, index_SetSchema as SetSchema, SourceSchema$1 as SourceSchema, source as SourceSchemas, index_SourceTypeSchema as SourceTypeSchema, index_SourcesMapConfig as SourcesMapConfig, store as StoreSchemas, index_Timestamp as Timestamp, transformer as TransformerSchemas, index_UserSchema as UserSchema, utilities as UtilitySchemas, type index_ValidationIssue as ValidationIssue, type index_ValidationResult as ValidationResult, index_ValueConfigSchema as ValueConfigSchema, index_ValueSchema as ValueSchema, index_ValuesSchema as ValuesSchema, index_VerboseConfig as VerboseConfig, walkeros as WalkerOSSchemas, index_configJsonSchema as configJsonSchema, index_consentJsonSchema as consentJsonSchema, index_contractJsonSchema as contractJsonSchema, index_contractRuleJsonSchema as contractRuleJsonSchema, index_createArraySchema as createArraySchema, index_createConsentConfig as createConsentConfig, index_createDataTransformationConfig as createDataTransformationConfig, index_createEnumSchema as createEnumSchema, index_createMappingRulesConfig as createMappingRulesConfig, index_createObjectSchema as createObjectSchema, index_createPolicyConfig as createPolicyConfig, index_createTupleSchema as createTupleSchema, index_destinationJsonSchema as destinationJsonSchema, index_entityJsonSchema as entityJsonSchema, index_eventJsonSchema as eventJsonSchema, index_flowConfigJsonSchema as flowConfigJsonSchema, index_flowJsonSchema as flowJsonSchema, index_loopJsonSchema as loopJsonSchema, index_mapJsonSchema as mapJsonSchema, index_orderedPropertiesJsonSchema as orderedPropertiesJsonSchema, index_parseConfig as parseConfig, index_parseFlow as parseFlow, index_partialEventJsonSchema as partialEventJsonSchema, index_policyJsonSchema as policyJsonSchema, index_propertiesJsonSchema as propertiesJsonSchema, index_ruleJsonSchema as ruleJsonSchema, index_rulesJsonSchema as rulesJsonSchema, index_safeParseConfig as safeParseConfig, index_safeParseFlow as safeParseFlow, index_setJsonSchema as setJsonSchema, index_sourceJsonSchema as sourceJsonSchema, index_sourceTypeJsonSchema as sourceTypeJsonSchema, index_storeJsonSchema as storeJsonSchema, index_transformerJsonSchema as transformerJsonSchema, index_userJsonSchema as userJsonSchema, index_validateFlowConfig as validateFlowConfig, index_valueConfigJsonSchema as valueConfigJsonSchema, index_valueJsonSchema as valueJsonSchema, index_z as z, index_zodToSchema as zodToSchema };
+  export { index_BaseContextConfig as BaseContextConfig, index_BatchConfig as BatchConfig, index_CacheRuleSchema as CacheRuleSchema, index_CacheSchema as CacheSchema, cache as CacheSchemas, index_ClickIdEntrySchema as ClickIdEntrySchema, index_CodeSchema as CodeSchema, collector as CollectorSchemas, index_ConsentSchema as ConsentSchema, index_ContractActionsSchema as ContractActionsSchema, index_ContractRuleSchema as ContractRuleSchema, index_ContractSchema as ContractSchema, index_ContractSchemaEntry as ContractSchemaEntry, index_Counter as Counter, index_DeepPartialEventSchema as DeepPartialEventSchema, destination as DestinationSchemas, index_DestinationsMapConfig as DestinationsMapConfig, index_EntitiesSchema as EntitiesSchema, index_EntitySchema as EntitySchema, index_EventSchema as EventSchema, BundlePackageSchema as FlowBundlePackageSchema, BundleSchema as FlowBundleSchema, CodeSchema$1 as FlowCodeSchema, ConfigSchema as FlowConfigSchema, DestinationSchema as FlowDestinationSchema, JsonSchema as FlowJsonSchema, index_FlowSchema as FlowSchema, flow as FlowSchemas, SourceSchema as FlowSourceSchema, StoreSchema as FlowStoreSchema, TransformerSchema as FlowTransformerSchema, index_GenericEnvConfig as GenericEnvConfig, index_GenericSettingsConfig as GenericSettingsConfig, index_HandlersConfig as HandlersConfig, index_HintSchema as HintSchema, index_HintsSchema as HintsSchema, index_IdConfig as IdConfig, index_Identifier as Identifier, InitConfig$1 as InitConfig, type index_IntelliSenseContext as IntelliSenseContext, type index_JSONSchema as JSONSchema, index_LoggerConfigSchema as LoggerConfigSchema, index_LoggerHandlerSchema as LoggerHandlerSchema, index_LoopSchema as LoopSchema, index_MapSchema as MapSchema, ResultSchema$1 as MappingResultSchema, mapping as MappingSchemas, index_MatchExpressionSchema as MatchExpressionSchema, matcher as MatcherSchemas, index_OptionalPrimitiveValue as OptionalPrimitiveValue, index_OrderedPropertiesSchema as OrderedPropertiesSchema, type index_PackageInfo as PackageInfo, index_PartialEventSchema as PartialEventSchema, index_PolicySchema as PolicySchema, index_PrimaryConfig as PrimaryConfig, index_PrimitiveValue as PrimitiveValue, index_ProcessingControlConfig as ProcessingControlConfig, index_PropertiesSchema as PropertiesSchema, type index_PropertyDef as PropertyDef, index_PropertySchema as PropertySchema, index_PropertyTypeSchema as PropertyTypeSchema, index_QueueConfig as QueueConfig, index_RequiredBoolean as RequiredBoolean, index_RequiredNumber as RequiredNumber, index_RequiredString as RequiredString, index_RouteSchema as RouteSchema, index_RouteSpecSchema as RouteSpecSchema, index_RuleSchema as RuleSchema, index_RulesSchema as RulesSchema, index_RuntimeInstanceConfig as RuntimeInstanceConfig, index_SetSchema as SetSchema, SourceSchema$1 as SourceSchema, source as SourceSchemas, index_SourceTypeSchema as SourceTypeSchema, index_SourcesMapConfig as SourcesMapConfig, store as StoreSchemas, index_Timestamp as Timestamp, transformer as TransformerSchemas, index_UserSchema as UserSchema, utilities as UtilitySchemas, type index_ValidationIssue as ValidationIssue, type index_ValidationResult as ValidationResult, index_ValueConfigSchema as ValueConfigSchema, index_ValueSchema as ValueSchema, index_ValuesSchema as ValuesSchema, index_VerboseConfig as VerboseConfig, walkeros as WalkerOSSchemas, index_configJsonSchema as configJsonSchema, index_consentJsonSchema as consentJsonSchema, index_contractJsonSchema as contractJsonSchema, index_contractRuleJsonSchema as contractRuleJsonSchema, index_createArraySchema as createArraySchema, index_createConsentConfig as createConsentConfig, index_createDataTransformationConfig as createDataTransformationConfig, index_createEnumSchema as createEnumSchema, index_createMappingRulesConfig as createMappingRulesConfig, index_createObjectSchema as createObjectSchema, index_createPolicyConfig as createPolicyConfig, index_createTupleSchema as createTupleSchema, index_destinationJsonSchema as destinationJsonSchema, index_entityJsonSchema as entityJsonSchema, index_eventJsonSchema as eventJsonSchema, index_flowConfigJsonSchema as flowConfigJsonSchema, index_flowJsonSchema as flowJsonSchema, index_loopJsonSchema as loopJsonSchema, index_mapJsonSchema as mapJsonSchema, index_orderedPropertiesJsonSchema as orderedPropertiesJsonSchema, index_parseConfig as parseConfig, index_parseFlow as parseFlow, index_partialEventJsonSchema as partialEventJsonSchema, index_policyJsonSchema as policyJsonSchema, index_propertiesJsonSchema as propertiesJsonSchema, index_ruleJsonSchema as ruleJsonSchema, index_rulesJsonSchema as rulesJsonSchema, index_safeParseConfig as safeParseConfig, index_safeParseFlow as safeParseFlow, index_setJsonSchema as setJsonSchema, index_sourceJsonSchema as sourceJsonSchema, index_sourceTypeJsonSchema as sourceTypeJsonSchema, index_storeJsonSchema as storeJsonSchema, index_transformerJsonSchema as transformerJsonSchema, index_userJsonSchema as userJsonSchema, index_validateFlowConfig as validateFlowConfig, index_valueConfigJsonSchema as valueConfigJsonSchema, index_valueJsonSchema as valueJsonSchema, index_z as z, index_zodToSchema as zodToSchema };
 }
 
 type PackageType = 'source' | 'destination' | 'transformer' | 'store';
@@ -5552,14 +5552,14 @@ interface Config$6<T extends TypesGeneric$3 = Types$4> {
     /** Defer destination initialization until these collector events fire (e.g., `['consent']`). */
     require?: string[];
     /**
-     * Provisioning options for `walker setup`. `boolean | object`.
+     * Provisioning options for `walkeros setup`. `boolean | object`.
      * Triggered only by explicit CLI invocation; never automatic.
      */
     setup?: boolean | SetupOptions$2<T>;
     /** Transformer chain to run after collector processing but before this destination. */
-    before?: Next;
+    before?: RouteSpec;
     /** Transformer chain to run after destination push completes. Push response available at ingest._response. */
-    next?: Next;
+    next?: RouteSpec;
     /** Cache configuration for deduplication (step-level: skip push on HIT). */
     cache?: Cache;
     /** Completely skip this destination — no init, no push, no queuing. */
@@ -5575,8 +5575,8 @@ type Init$3<T extends TypesGeneric$3 = Types$4> = {
     code: Code<T>;
     config?: Partial<Config$6<T>>;
     env?: Partial<Env$3<T>>;
-    before?: Next;
-    next?: Next;
+    before?: RouteSpec;
+    next?: RouteSpec;
     cache?: Cache;
 };
 interface InitDestinations {
@@ -5812,11 +5812,30 @@ interface OnConfig {
  */
 type OnFn<T extends TypesGeneric$3 = Types$4> = (type: Types$3, context: Context$5<T>) => PromiseOrValue<void>;
 
-interface NextRule {
+/**
+ * A single conditional routing rule. Pairs a `match` expression (or `'*'`
+ * wildcard) against ingest metadata with a `next` step to follow when the
+ * match fires. Used inside `Route[]` arrays on `Flow.Source.next`,
+ * `Flow.Source.before`, `Flow.Transformer.next/before`, and
+ * `Flow.Destination.next/before`. Routes are evaluated in order, first match
+ * wins, no match falls through unchanged. The `next` field of a Route
+ * mirrors the outer-position `next` semantics: it points to whatever comes
+ * downstream when this rule fires.
+ */
+interface Route {
     match: MatchExpression | '*';
-    next: Next;
+    next: RouteSpec;
 }
-type Next = string | string[] | NextRule[];
+/**
+ * The union accepted at every chain-routing boundary. A plain `string`
+ * targets one step by ID; `string[]` declares an explicit sequence ignoring
+ * per-step `next`; `Route[]` enables conditional routing on ingest metadata.
+ * At runtime, `compileNext()` collapses any RouteSpec into a `CompiledNext`
+ * (static, chain, or routes form) for hot-path evaluation. Surfaces via
+ * `Flow.Source.before/next`, `Flow.Transformer.before/next`,
+ * `Flow.Destination.before/next`.
+ */
+type RouteSpec = string | string[] | Route[];
 /**
  * Base environment interface for walkerOS transformers.
  *
@@ -5862,8 +5881,8 @@ interface Config$3<T extends TypesGeneric$2 = Types$2> {
     env?: Env$2<T>;
     id?: string;
     logger?: Config$5;
-    before?: Next;
-    next?: Next;
+    before?: RouteSpec;
+    next?: RouteSpec;
     cache?: Cache;
     init?: boolean;
     disabled?: boolean;
@@ -5891,7 +5910,7 @@ interface Context$3<T extends TypesGeneric$2 = Types$2> extends Base<Config$3<T>
 interface Result<E = DeepPartialEvent> {
     event?: E;
     respond?: RespondFn;
-    next?: Next;
+    next?: RouteSpec;
 }
 /**
  * The main transformer function.
@@ -5940,8 +5959,8 @@ type InitTransformer<T extends TypesGeneric$2 = Types$2> = {
     code: Init$2<T>;
     config?: Partial<Config$3<T>>;
     env?: Partial<Env$2<T>>;
-    before?: Next;
-    next?: Next;
+    before?: RouteSpec;
+    next?: RouteSpec;
     cache?: Cache;
 };
 /**
@@ -5975,7 +5994,7 @@ interface BaseEnv$1 {
  * @template P - Push function signature (flexible to support HTTP handlers, etc.)
  * @template E - Environment dependencies type
  * @template I - InitSettings configuration type (user input)
- * @template U - Setup options type (provisioning options for `walker setup`)
+ * @template U - Setup options type (provisioning options for `walkeros setup`)
  */
 interface Types$1<S = unknown, M = unknown, P = Fn$3, E = BaseEnv$1, I = S, U = unknown> {
     settings: S;
@@ -6015,7 +6034,7 @@ interface Config$2<T extends TypesGeneric$1 = Types$1> extends Config<Mapping<T>
     /** Defer source initialization until these collector events fire (e.g., `['consent']`). */
     require?: string[];
     /**
-     * Provisioning options for `walker setup`. `boolean | object`.
+     * Provisioning options for `walkeros setup`. `boolean | object`.
      * Triggered only by explicit CLI invocation; never automatic.
      */
     setup?: boolean | SetupOptions$1<T>;
@@ -6090,8 +6109,8 @@ type InitSource<T extends TypesGeneric$1 = Types$1> = {
     config?: Partial<Config$2<T>>;
     env?: Partial<Env$1<T>>;
     primary?: boolean;
-    next?: Next;
-    before?: Next;
+    next?: RouteSpec;
+    before?: RouteSpec;
     cache?: Cache;
 };
 /**
@@ -6127,7 +6146,7 @@ interface Config$1<T extends TypesGeneric = Types> {
     id?: string;
     logger?: Config$5;
     /**
-     * Provisioning options for `walker setup`. `boolean | object`.
+     * Provisioning options for `walkeros setup`. `boolean | object`.
      * Triggered only by explicit CLI invocation; never automatic.
      */
     setup?: boolean | SetupOptions<T>;
@@ -6606,7 +6625,7 @@ declare namespace Flow {
          * (decode, validate, authenticate, normalize raw input).
          * Raw request data is available in context.ingest.
          */
-        before?: string | string[];
+        before?: RouteSpec;
         /**
          * First transformer in pre-collector chain.
          *
@@ -6615,7 +6634,7 @@ declare namespace Flow {
          * If omitted, events route directly to the collector.
          * Can be an array for explicit chain control (bypasses transformer.next resolution).
          */
-        next?: string | string[];
+        next?: RouteSpec;
         /** Cache configuration for this source. */
         cache?: Cache;
         /**
@@ -6657,7 +6676,7 @@ declare namespace Flow {
          * If omitted, events are sent directly from the collector.
          * Can be an array for explicit chain control.
          */
-        before?: string | string[];
+        before?: RouteSpec;
         /**
          * First transformer in post-push chain.
          *
@@ -6665,7 +6684,7 @@ declare namespace Flow {
          * at context.ingest._response. Consent is inherited from the destination
          * gate - no separate consent check needed.
          */
-        next?: string | string[];
+        next?: RouteSpec;
         /** Cache configuration for this destination. */
         cache?: Cache;
         /** Destination-level variables (highest priority in cascade). */
@@ -6698,7 +6717,7 @@ declare namespace Flow {
          * Enables pre-processing or context loading before the main transform.
          * Uses the same chain resolution as source.next and destination.before.
          */
-        before?: string | string[];
+        before?: RouteSpec;
         /**
          * Next transformer in chain.
          *
@@ -6709,7 +6728,7 @@ declare namespace Flow {
          * Array values define an explicit chain (no walking). Circular references
          * are safely detected at runtime by `walkChain()`.
          */
-        next?: string | string[];
+        next?: RouteSpec;
         /** Cache configuration for this transformer. */
         cache?: Cache;
         /** Transformer-level variables (highest priority in cascade). */

package/dist/dev.d.ts

@@ -4800,17 +4800,17 @@ declare namespace cache {
 }
 
 declare const MatchExpressionSchema: z.ZodType;
-declare const RoutableNextSchema: z.ZodType;
-declare const NextRuleSchema: z.ZodObject<{
+declare const RouteSpecSchema: z.ZodType;
+declare const RouteSchema: z.ZodObject<{
     match: z.ZodUnion<readonly [z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodLiteral<"*">]>;
     next: z.ZodLazy<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
 }, z.core.$strip>;
 
 declare const matcher_MatchExpressionSchema: typeof MatchExpressionSchema;
-declare const matcher_NextRuleSchema: typeof NextRuleSchema;
-declare const matcher_RoutableNextSchema: typeof RoutableNextSchema;
+declare const matcher_RouteSchema: typeof RouteSchema;
+declare const matcher_RouteSpecSchema: typeof RouteSpecSchema;
 declare namespace matcher {
-  export { matcher_MatchExpressionSchema as MatchExpressionSchema, matcher_NextRuleSchema as NextRuleSchema, matcher_RoutableNextSchema as RoutableNextSchema };
+  export { matcher_MatchExpressionSchema as MatchExpressionSchema, matcher_RouteSchema as RouteSchema, matcher_RouteSpecSchema as RouteSpecSchema };
 }
 
 declare const CodeSchema: z.ZodObject<{
@@ -5152,7 +5152,6 @@ declare const index_LoggerHandlerSchema: typeof LoggerHandlerSchema;
 declare const index_LoopSchema: typeof LoopSchema;
 declare const index_MapSchema: typeof MapSchema;
 declare const index_MatchExpressionSchema: typeof MatchExpressionSchema;
-declare const index_NextRuleSchema: typeof NextRuleSchema;
 declare const index_OptionalPrimitiveValue: typeof OptionalPrimitiveValue;
 declare const index_OrderedPropertiesSchema: typeof OrderedPropertiesSchema;
 type index_PackageInfo = PackageInfo;
@@ -5169,7 +5168,8 @@ declare const index_QueueConfig: typeof QueueConfig;
 declare const index_RequiredBoolean: typeof RequiredBoolean;
 declare const index_RequiredNumber: typeof RequiredNumber;
 declare const index_RequiredString: typeof RequiredString;
-declare const index_RoutableNextSchema: typeof RoutableNextSchema;
+declare const index_RouteSchema: typeof RouteSchema;
+declare const index_RouteSpecSchema: typeof RouteSpecSchema;
 declare const index_RuleSchema: typeof RuleSchema;
 declare const index_RulesSchema: typeof RulesSchema;
 declare const index_RuntimeInstanceConfig: typeof RuntimeInstanceConfig;
@@ -5225,7 +5225,7 @@ declare const index_valueJsonSchema: typeof valueJsonSchema;
 declare const index_z: typeof z;
 declare const index_zodToSchema: typeof zodToSchema;
 declare namespace index {
-  export { index_BaseContextConfig as BaseContextConfig, index_BatchConfig as BatchConfig, index_CacheRuleSchema as CacheRuleSchema, index_CacheSchema as CacheSchema, cache as CacheSchemas, index_ClickIdEntrySchema as ClickIdEntrySchema, index_CodeSchema as CodeSchema, collector as CollectorSchemas, index_ConsentSchema as ConsentSchema, index_ContractActionsSchema as ContractActionsSchema, index_ContractRuleSchema as ContractRuleSchema, index_ContractSchema as ContractSchema, index_ContractSchemaEntry as ContractSchemaEntry, index_Counter as Counter, index_DeepPartialEventSchema as DeepPartialEventSchema, destination as DestinationSchemas, index_DestinationsMapConfig as DestinationsMapConfig, index_EntitiesSchema as EntitiesSchema, index_EntitySchema as EntitySchema, index_EventSchema as EventSchema, BundlePackageSchema as FlowBundlePackageSchema, BundleSchema as FlowBundleSchema, CodeSchema$1 as FlowCodeSchema, ConfigSchema as FlowConfigSchema, DestinationSchema as FlowDestinationSchema, JsonSchema as FlowJsonSchema, index_FlowSchema as FlowSchema, flow as FlowSchemas, SourceSchema as FlowSourceSchema, StoreSchema as FlowStoreSchema, TransformerSchema as FlowTransformerSchema, index_GenericEnvConfig as GenericEnvConfig, index_GenericSettingsConfig as GenericSettingsConfig, index_HandlersConfig as HandlersConfig, index_HintSchema as HintSchema, index_HintsSchema as HintsSchema, index_IdConfig as IdConfig, index_Identifier as Identifier, InitConfig$1 as InitConfig, type index_IntelliSenseContext as IntelliSenseContext, type index_JSONSchema as JSONSchema, index_LoggerConfigSchema as LoggerConfigSchema, index_LoggerHandlerSchema as LoggerHandlerSchema, index_LoopSchema as LoopSchema, index_MapSchema as MapSchema, ResultSchema$1 as MappingResultSchema, mapping as MappingSchemas, index_MatchExpressionSchema as MatchExpressionSchema, matcher as MatcherSchemas, index_NextRuleSchema as NextRuleSchema, index_OptionalPrimitiveValue as OptionalPrimitiveValue, index_OrderedPropertiesSchema as OrderedPropertiesSchema, type index_PackageInfo as PackageInfo, index_PartialEventSchema as PartialEventSchema, index_PolicySchema as PolicySchema, index_PrimaryConfig as PrimaryConfig, index_PrimitiveValue as PrimitiveValue, index_ProcessingControlConfig as ProcessingControlConfig, index_PropertiesSchema as PropertiesSchema, type index_PropertyDef as PropertyDef, index_PropertySchema as PropertySchema, index_PropertyTypeSchema as PropertyTypeSchema, index_QueueConfig as QueueConfig, index_RequiredBoolean as RequiredBoolean, index_RequiredNumber as RequiredNumber, index_RequiredString as RequiredString, index_RoutableNextSchema as RoutableNextSchema, index_RuleSchema as RuleSchema, index_RulesSchema as RulesSchema, index_RuntimeInstanceConfig as RuntimeInstanceConfig, index_SetSchema as SetSchema, SourceSchema$1 as SourceSchema, source as SourceSchemas, index_SourceTypeSchema as SourceTypeSchema, index_SourcesMapConfig as SourcesMapConfig, store as StoreSchemas, index_Timestamp as Timestamp, transformer as TransformerSchemas, index_UserSchema as UserSchema, utilities as UtilitySchemas, type index_ValidationIssue as ValidationIssue, type index_ValidationResult as ValidationResult, index_ValueConfigSchema as ValueConfigSchema, index_ValueSchema as ValueSchema, index_ValuesSchema as ValuesSchema, index_VerboseConfig as VerboseConfig, walkeros as WalkerOSSchemas, index_configJsonSchema as configJsonSchema, index_consentJsonSchema as consentJsonSchema, index_contractJsonSchema as contractJsonSchema, index_contractRuleJsonSchema as contractRuleJsonSchema, index_createArraySchema as createArraySchema, index_createConsentConfig as createConsentConfig, index_createDataTransformationConfig as createDataTransformationConfig, index_createEnumSchema as createEnumSchema, index_createMappingRulesConfig as createMappingRulesConfig, index_createObjectSchema as createObjectSchema, index_createPolicyConfig as createPolicyConfig, index_createTupleSchema as createTupleSchema, index_destinationJsonSchema as destinationJsonSchema, index_entityJsonSchema as entityJsonSchema, index_eventJsonSchema as eventJsonSchema, index_flowConfigJsonSchema as flowConfigJsonSchema, index_flowJsonSchema as flowJsonSchema, index_loopJsonSchema as loopJsonSchema, index_mapJsonSchema as mapJsonSchema, index_orderedPropertiesJsonSchema as orderedPropertiesJsonSchema, index_parseConfig as parseConfig, index_parseFlow as parseFlow, index_partialEventJsonSchema as partialEventJsonSchema, index_policyJsonSchema as policyJsonSchema, index_propertiesJsonSchema as propertiesJsonSchema, index_ruleJsonSchema as ruleJsonSchema, index_rulesJsonSchema as rulesJsonSchema, index_safeParseConfig as safeParseConfig, index_safeParseFlow as safeParseFlow, index_setJsonSchema as setJsonSchema, index_sourceJsonSchema as sourceJsonSchema, index_sourceTypeJsonSchema as sourceTypeJsonSchema, index_storeJsonSchema as storeJsonSchema, index_transformerJsonSchema as transformerJsonSchema, index_userJsonSchema as userJsonSchema, index_validateFlowConfig as validateFlowConfig, index_valueConfigJsonSchema as valueConfigJsonSchema, index_valueJsonSchema as valueJsonSchema, index_z as z, index_zodToSchema as zodToSchema };
+  export { index_BaseContextConfig as BaseContextConfig, index_BatchConfig as BatchConfig, index_CacheRuleSchema as CacheRuleSchema, index_CacheSchema as CacheSchema, cache as CacheSchemas, index_ClickIdEntrySchema as ClickIdEntrySchema, index_CodeSchema as CodeSchema, collector as CollectorSchemas, index_ConsentSchema as ConsentSchema, index_ContractActionsSchema as ContractActionsSchema, index_ContractRuleSchema as ContractRuleSchema, index_ContractSchema as ContractSchema, index_ContractSchemaEntry as ContractSchemaEntry, index_Counter as Counter, index_DeepPartialEventSchema as DeepPartialEventSchema, destination as DestinationSchemas, index_DestinationsMapConfig as DestinationsMapConfig, index_EntitiesSchema as EntitiesSchema, index_EntitySchema as EntitySchema, index_EventSchema as EventSchema, BundlePackageSchema as FlowBundlePackageSchema, BundleSchema as FlowBundleSchema, CodeSchema$1 as FlowCodeSchema, ConfigSchema as FlowConfigSchema, DestinationSchema as FlowDestinationSchema, JsonSchema as FlowJsonSchema, index_FlowSchema as FlowSchema, flow as FlowSchemas, SourceSchema as FlowSourceSchema, StoreSchema as FlowStoreSchema, TransformerSchema as FlowTransformerSchema, index_GenericEnvConfig as GenericEnvConfig, index_GenericSettingsConfig as GenericSettingsConfig, index_HandlersConfig as HandlersConfig, index_HintSchema as HintSchema, index_HintsSchema as HintsSchema, index_IdConfig as IdConfig, index_Identifier as Identifier, InitConfig$1 as InitConfig, type index_IntelliSenseContext as IntelliSenseContext, type index_JSONSchema as JSONSchema, index_LoggerConfigSchema as LoggerConfigSchema, index_LoggerHandlerSchema as LoggerHandlerSchema, index_LoopSchema as LoopSchema, index_MapSchema as MapSchema, ResultSchema$1 as MappingResultSchema, mapping as MappingSchemas, index_MatchExpressionSchema as MatchExpressionSchema, matcher as MatcherSchemas, index_OptionalPrimitiveValue as OptionalPrimitiveValue, index_OrderedPropertiesSchema as OrderedPropertiesSchema, type index_PackageInfo as PackageInfo, index_PartialEventSchema as PartialEventSchema, index_PolicySchema as PolicySchema, index_PrimaryConfig as PrimaryConfig, index_PrimitiveValue as PrimitiveValue, index_ProcessingControlConfig as ProcessingControlConfig, index_PropertiesSchema as PropertiesSchema, type index_PropertyDef as PropertyDef, index_PropertySchema as PropertySchema, index_PropertyTypeSchema as PropertyTypeSchema, index_QueueConfig as QueueConfig, index_RequiredBoolean as RequiredBoolean, index_RequiredNumber as RequiredNumber, index_RequiredString as RequiredString, index_RouteSchema as RouteSchema, index_RouteSpecSchema as RouteSpecSchema, index_RuleSchema as RuleSchema, index_RulesSchema as RulesSchema, index_RuntimeInstanceConfig as RuntimeInstanceConfig, index_SetSchema as SetSchema, SourceSchema$1 as SourceSchema, source as SourceSchemas, index_SourceTypeSchema as SourceTypeSchema, index_SourcesMapConfig as SourcesMapConfig, store as StoreSchemas, index_Timestamp as Timestamp, transformer as TransformerSchemas, index_UserSchema as UserSchema, utilities as UtilitySchemas, type index_ValidationIssue as ValidationIssue, type index_ValidationResult as ValidationResult, index_ValueConfigSchema as ValueConfigSchema, index_ValueSchema as ValueSchema, index_ValuesSchema as ValuesSchema, index_VerboseConfig as VerboseConfig, walkeros as WalkerOSSchemas, index_configJsonSchema as configJsonSchema, index_consentJsonSchema as consentJsonSchema, index_contractJsonSchema as contractJsonSchema, index_contractRuleJsonSchema as contractRuleJsonSchema, index_createArraySchema as createArraySchema, index_createConsentConfig as createConsentConfig, index_createDataTransformationConfig as createDataTransformationConfig, index_createEnumSchema as createEnumSchema, index_createMappingRulesConfig as createMappingRulesConfig, index_createObjectSchema as createObjectSchema, index_createPolicyConfig as createPolicyConfig, index_createTupleSchema as createTupleSchema, index_destinationJsonSchema as destinationJsonSchema, index_entityJsonSchema as entityJsonSchema, index_eventJsonSchema as eventJsonSchema, index_flowConfigJsonSchema as flowConfigJsonSchema, index_flowJsonSchema as flowJsonSchema, index_loopJsonSchema as loopJsonSchema, index_mapJsonSchema as mapJsonSchema, index_orderedPropertiesJsonSchema as orderedPropertiesJsonSchema, index_parseConfig as parseConfig, index_parseFlow as parseFlow, index_partialEventJsonSchema as partialEventJsonSchema, index_policyJsonSchema as policyJsonSchema, index_propertiesJsonSchema as propertiesJsonSchema, index_ruleJsonSchema as ruleJsonSchema, index_rulesJsonSchema as rulesJsonSchema, index_safeParseConfig as safeParseConfig, index_safeParseFlow as safeParseFlow, index_setJsonSchema as setJsonSchema, index_sourceJsonSchema as sourceJsonSchema, index_sourceTypeJsonSchema as sourceTypeJsonSchema, index_storeJsonSchema as storeJsonSchema, index_transformerJsonSchema as transformerJsonSchema, index_userJsonSchema as userJsonSchema, index_validateFlowConfig as validateFlowConfig, index_valueConfigJsonSchema as valueConfigJsonSchema, index_valueJsonSchema as valueJsonSchema, index_z as z, index_zodToSchema as zodToSchema };
 }
 
 type PackageType = 'source' | 'destination' | 'transformer' | 'store';
@@ -5552,14 +5552,14 @@ interface Config$6<T extends TypesGeneric$3 = Types$4> {
     /** Defer destination initialization until these collector events fire (e.g., `['consent']`). */
     require?: string[];
     /**
-     * Provisioning options for `walker setup`. `boolean | object`.
+     * Provisioning options for `walkeros setup`. `boolean | object`.
      * Triggered only by explicit CLI invocation; never automatic.
      */
     setup?: boolean | SetupOptions$2<T>;
     /** Transformer chain to run after collector processing but before this destination. */
-    before?: Next;
+    before?: RouteSpec;
     /** Transformer chain to run after destination push completes. Push response available at ingest._response. */
-    next?: Next;
+    next?: RouteSpec;
     /** Cache configuration for deduplication (step-level: skip push on HIT). */
     cache?: Cache;
     /** Completely skip this destination — no init, no push, no queuing. */
@@ -5575,8 +5575,8 @@ type Init$3<T extends TypesGeneric$3 = Types$4> = {
     code: Code<T>;
     config?: Partial<Config$6<T>>;
     env?: Partial<Env$3<T>>;
-    before?: Next;
-    next?: Next;
+    before?: RouteSpec;
+    next?: RouteSpec;
     cache?: Cache;
 };
 interface InitDestinations {
@@ -5812,11 +5812,30 @@ interface OnConfig {
  */
 type OnFn<T extends TypesGeneric$3 = Types$4> = (type: Types$3, context: Context$5<T>) => PromiseOrValue<void>;
 
-interface NextRule {
+/**
+ * A single conditional routing rule. Pairs a `match` expression (or `'*'`
+ * wildcard) against ingest metadata with a `next` step to follow when the
+ * match fires. Used inside `Route[]` arrays on `Flow.Source.next`,
+ * `Flow.Source.before`, `Flow.Transformer.next/before`, and
+ * `Flow.Destination.next/before`. Routes are evaluated in order, first match
+ * wins, no match falls through unchanged. The `next` field of a Route
+ * mirrors the outer-position `next` semantics: it points to whatever comes
+ * downstream when this rule fires.
+ */
+interface Route {
     match: MatchExpression | '*';
-    next: Next;
+    next: RouteSpec;
 }
-type Next = string | string[] | NextRule[];
+/**
+ * The union accepted at every chain-routing boundary. A plain `string`
+ * targets one step by ID; `string[]` declares an explicit sequence ignoring
+ * per-step `next`; `Route[]` enables conditional routing on ingest metadata.
+ * At runtime, `compileNext()` collapses any RouteSpec into a `CompiledNext`
+ * (static, chain, or routes form) for hot-path evaluation. Surfaces via
+ * `Flow.Source.before/next`, `Flow.Transformer.before/next`,
+ * `Flow.Destination.before/next`.
+ */
+type RouteSpec = string | string[] | Route[];
 /**
  * Base environment interface for walkerOS transformers.
  *
@@ -5862,8 +5881,8 @@ interface Config$3<T extends TypesGeneric$2 = Types$2> {
     env?: Env$2<T>;
     id?: string;
     logger?: Config$5;
-    before?: Next;
-    next?: Next;
+    before?: RouteSpec;
+    next?: RouteSpec;
     cache?: Cache;
     init?: boolean;
     disabled?: boolean;
@@ -5891,7 +5910,7 @@ interface Context$3<T extends TypesGeneric$2 = Types$2> extends Base<Config$3<T>
 interface Result<E = DeepPartialEvent> {
     event?: E;
     respond?: RespondFn;
-    next?: Next;
+    next?: RouteSpec;
 }
 /**
  * The main transformer function.
@@ -5940,8 +5959,8 @@ type InitTransformer<T extends TypesGeneric$2 = Types$2> = {
     code: Init$2<T>;
     config?: Partial<Config$3<T>>;
     env?: Partial<Env$2<T>>;
-    before?: Next;
-    next?: Next;
+    before?: RouteSpec;
+    next?: RouteSpec;
     cache?: Cache;
 };
 /**
@@ -5975,7 +5994,7 @@ interface BaseEnv$1 {
  * @template P - Push function signature (flexible to support HTTP handlers, etc.)
  * @template E - Environment dependencies type
  * @template I - InitSettings configuration type (user input)
- * @template U - Setup options type (provisioning options for `walker setup`)
+ * @template U - Setup options type (provisioning options for `walkeros setup`)
  */
 interface Types$1<S = unknown, M = unknown, P = Fn$3, E = BaseEnv$1, I = S, U = unknown> {
     settings: S;
@@ -6015,7 +6034,7 @@ interface Config$2<T extends TypesGeneric$1 = Types$1> extends Config<Mapping<T>
     /** Defer source initialization until these collector events fire (e.g., `['consent']`). */
     require?: string[];
     /**
-     * Provisioning options for `walker setup`. `boolean | object`.
+     * Provisioning options for `walkeros setup`. `boolean | object`.
      * Triggered only by explicit CLI invocation; never automatic.
      */
     setup?: boolean | SetupOptions$1<T>;
@@ -6090,8 +6109,8 @@ type InitSource<T extends TypesGeneric$1 = Types$1> = {
     config?: Partial<Config$2<T>>;
     env?: Partial<Env$1<T>>;
     primary?: boolean;
-    next?: Next;
-    before?: Next;
+    next?: RouteSpec;
+    before?: RouteSpec;
     cache?: Cache;
 };
 /**
@@ -6127,7 +6146,7 @@ interface Config$1<T extends TypesGeneric = Types> {
     id?: string;
     logger?: Config$5;
     /**
-     * Provisioning options for `walker setup`. `boolean | object`.
+     * Provisioning options for `walkeros setup`. `boolean | object`.
      * Triggered only by explicit CLI invocation; never automatic.
      */
     setup?: boolean | SetupOptions<T>;
@@ -6606,7 +6625,7 @@ declare namespace Flow {
          * (decode, validate, authenticate, normalize raw input).
          * Raw request data is available in context.ingest.
          */
-        before?: string | string[];
+        before?: RouteSpec;
         /**
          * First transformer in pre-collector chain.
          *
@@ -6615,7 +6634,7 @@ declare namespace Flow {
          * If omitted, events route directly to the collector.
          * Can be an array for explicit chain control (bypasses transformer.next resolution).
          */
-        next?: string | string[];
+        next?: RouteSpec;
         /** Cache configuration for this source. */
         cache?: Cache;
         /**
@@ -6657,7 +6676,7 @@ declare namespace Flow {
          * If omitted, events are sent directly from the collector.
          * Can be an array for explicit chain control.
          */
-        before?: string | string[];
+        before?: RouteSpec;
         /**
          * First transformer in post-push chain.
          *
@@ -6665,7 +6684,7 @@ declare namespace Flow {
          * at context.ingest._response. Consent is inherited from the destination
          * gate - no separate consent check needed.
          */
-        next?: string | string[];
+        next?: RouteSpec;
         /** Cache configuration for this destination. */
         cache?: Cache;
         /** Destination-level variables (highest priority in cascade). */
@@ -6698,7 +6717,7 @@ declare namespace Flow {
          * Enables pre-processing or context loading before the main transform.
          * Uses the same chain resolution as source.next and destination.before.
          */
-        before?: string | string[];
+        before?: RouteSpec;
         /**
          * Next transformer in chain.
          *
@@ -6709,7 +6728,7 @@ declare namespace Flow {
          * Array values define an explicit chain (no walking). Circular references
          * are safely detected at runtime by `walkChain()`.
          */
-        next?: string | string[];
+        next?: RouteSpec;
         /** Cache configuration for this transformer. */
         cache?: Cache;
         /** Transformer-level variables (highest priority in cascade). */