@walkeros/core 4.0.1-next-1778284185788 → 4.0.2

package/dist/index.d.ts

@@ -75,7 +75,7 @@ interface Context$6 {
     /** The surrounding mapping config: a Value (value-level) or a Rule (rule-level). */
     mapping: Value | Rule;
     collector: Instance$6;
-    logger: Instance$4;
+    logger: Instance$3;
     consent?: Consent;
 }
 type Fn$4 = (value: unknown, context: Context$6) => PromiseOrValue<Property | unknown>;
@@ -184,7 +184,7 @@ interface Config$6 {
     /** Static session data even on a new run */
     sessionStatic: Partial<SessionData>;
     /** Logger configuration */
-    logger?: Config$4;
+    logger?: Config$3;
 }
 /**
  * Initialization configuration that extends Config with initial state
@@ -247,7 +247,7 @@ interface Destinations$1 {
     [id: string]: Instance$5;
 }
 interface Transformers$1 {
-    [id: string]: Instance$3;
+    [id: string]: Instance$4;
 }
 interface Stores$1 {
     [id: string]: Instance$1;
@@ -280,7 +280,7 @@ interface CommandFn {
     (command: 'consent', consent: Consent): Promise<PushResult>;
     <T extends Types$4>(command: 'destination', destination: Init$3<T> | Instance$5<T>, config?: Config$5<T>): Promise<PushResult>;
     <K extends keyof Functions>(command: 'hook', name: K, hookFn: Functions[K]): Promise<PushResult>;
-    (command: 'on', type: Types$3, rules: SingleOrArray<Subscription>): Promise<PushResult>;
+    (command: 'on', type: Types$2, rules: SingleOrArray<Subscription>): Promise<PushResult>;
     (command: 'user', user: User): Promise<PushResult>;
     (command: 'run', runState?: {
         consent?: Consent;
@@ -303,7 +303,7 @@ interface Instance$6 {
     stores: Stores$1;
     globals: Properties;
     hooks: Functions;
-    logger: Instance$4;
+    logger: Instance$3;
     on: OnConfig;
     queue: Events;
     round: number;
@@ -335,7 +335,7 @@ declare namespace collector {
  */
 interface Base<C = unknown, E = unknown> {
     collector: Instance$6;
-    logger: Instance$4;
+    logger: Instance$3;
     config: C;
     env: E;
 }
@@ -353,7 +353,7 @@ interface LifecycleContext<C = unknown, E = unknown> {
     id: string;
     config: C;
     env: E;
-    logger: Instance$4;
+    logger: Instance$3;
 }
 /**
  * Setup function signature. Called once via `walkeros setup <kind>.<name>`.
@@ -429,7 +429,7 @@ interface Instance$5<T extends TypesGeneric$3 = Types$4> {
     config: Config$5<T>;
     queuePush?: Events;
     queueOn?: Array<{
-        type: Types$3;
+        type: Types$2;
         data?: unknown;
     }>;
     dlq?: DLQ;
@@ -461,7 +461,7 @@ interface Config$5<T extends TypesGeneric$3 = Types$4> {
     /** Whether to load external scripts (e.g., gtag.js); destination-specific behavior. */
     loadScript?: boolean;
     /** Logger configuration (level, handler) to override the collector's defaults. */
-    logger?: Config$4;
+    logger?: Config$3;
     /** Entity-action rules to filter, rename, transform, and batch events for this destination. */
     mapping?: Rules<Rule<Mapping$1<T>>>;
     /** Pre-processing rules applied to all events before mapping; modifies events in-place. */
@@ -471,14 +471,14 @@ interface Config$5<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. */
@@ -495,8 +495,8 @@ type Init$3<T extends TypesGeneric$3 = Types$4> = {
     code: Code$1<T>;
     config?: Partial<Config$5<T>>;
     env?: Partial<Env$3<T>>;
-    before?: Next;
-    next?: Next;
+    before?: RouteSpec;
+    next?: RouteSpec;
     cache?: Cache;
 };
 interface InitDestinations {
@@ -583,7 +583,7 @@ interface WalkerCommands<R = Promise<PushResult>, Config = unknown> {
     (event: 'walker consent', consent: Consent): R;
     <T extends Types$4>(event: 'walker destination', destination: Init$3<T> | Instance$5<T>, config?: Config$5<T>): R;
     <K extends keyof Functions>(event: 'walker hook', name: K, hookFn: Functions[K]): R;
-    (event: 'walker on', type: Types$3, rules: SingleOrArray<Subscription>): R;
+    (event: 'walker on', type: Types$2, rules: SingleOrArray<Subscription>): R;
     (event: 'walker user', user: User): R;
     (event: 'walker run', runState: {
         consent?: Consent;
@@ -612,6 +612,194 @@ declare namespace elb {
   export type { Event$1 as Event, elb_EventFn as EventFn, Fn$3 as Fn, elb_Layer as Layer, elb_PushData as PushData, elb_PushResult as PushResult, elb_WalkerCommands as WalkerCommands };
 }
 
+/**
+ * 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: RouteSpec;
+}
+/**
+ * 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.
+ *
+ * Minimal like Destination - just an extensible object.
+ * Transformers receive dependencies through context, not env.
+ */
+interface BaseEnv$2 {
+    [key: string]: unknown;
+}
+/**
+ * Type bundle for transformer generics.
+ * Groups Settings, InitSettings, and Env into a single type parameter.
+ * Follows the Source/Destination pattern.
+ *
+ * @template S - Settings configuration type
+ * @template E - Environment type
+ * @template I - InitSettings configuration type (user input)
+ */
+interface Types$3<S = unknown, E = BaseEnv$2, I = S> {
+    settings: S;
+    initSettings: I;
+    env: E;
+}
+/**
+ * Generic constraint for Types - ensures T has required properties for indexed access.
+ */
+type TypesGeneric$2 = {
+    settings: any;
+    initSettings: any;
+    env: any;
+};
+/**
+ * Type extractors for consistent usage with Types bundle.
+ */
+type Settings$2<T extends TypesGeneric$2 = Types$3> = T['settings'];
+type InitSettings$2<T extends TypesGeneric$2 = Types$3> = T['initSettings'];
+type Env$2<T extends TypesGeneric$2 = Types$3> = T['env'];
+/**
+ * Inference helper: Extract Types from Instance.
+ */
+type TypesOf$2<I> = I extends Instance$4<infer T> ? T : never;
+/**
+ * Transformer configuration.
+ */
+interface Config$4<T extends TypesGeneric$2 = Types$3> {
+    settings?: InitSettings$2<T>;
+    env?: Env$2<T>;
+    id?: string;
+    logger?: Config$3;
+    before?: RouteSpec;
+    next?: RouteSpec;
+    cache?: Cache;
+    init?: boolean;
+    disabled?: boolean;
+    /** Return this value instead of calling push(). Global mock for all chains. */
+    mock?: unknown;
+    /** Path-specific mock values keyed by chain path (e.g., "destination.ga4.before"). Takes precedence over global mock. */
+    chainMocks?: Record<string, unknown>;
+}
+/**
+ * Context provided to transformer functions.
+ * Extends base context with transformer-specific properties.
+ */
+interface Context$4<T extends TypesGeneric$2 = Types$3> extends Base<Config$4<T>, Env$2<T>> {
+    id: string;
+    ingest: Ingest;
+}
+/**
+ * Unified result type for transformer functions.
+ * Replaces the old union return type with a structured object.
+ *
+ * @field event - Modified event to continue with
+ * @field respond - Wrapped respond function for downstream transformers
+ * @field next - Branch to a different chain (replaces BranchResult)
+ */
+interface Result$1<E = DeepPartialEvent> {
+    event?: E;
+    respond?: RespondFn;
+    next?: RouteSpec;
+}
+/**
+ * Result of running a transformer chain.
+ * Returns the processed event (singular, fan-out array, or null if dropped)
+ * alongside the potentially wrapped respond function.
+ */
+interface ChainResult {
+    event: DeepPartialEvent | DeepPartialEvent[] | null;
+    respond?: RespondFn;
+}
+/**
+ * The main transformer function.
+ *
+ * Pre-collector transformers use default E = DeepPartialEvent.
+ * Post-collector transformers can use E = Event for type-safe access.
+ * A transformer written for DeepPartialEvent works in both positions
+ * because Event is a subtype of DeepPartialEvent.
+ *
+ * @returns Result - structured result with event, respond, next
+ * @returns Result[] - fan-out: each Result continues independently through remaining chain
+ * @returns void - continue with current event unchanged (passthrough)
+ * @returns false - stop chain, cancel further processing
+ */
+type Fn$2<T extends TypesGeneric$2 = Types$3, E = DeepPartialEvent> = (event: E, context: Context$4<T>) => PromiseOrValue<Result$1<E> | Result$1<E>[] | false | void>;
+/**
+ * Optional initialization function.
+ * Called once before first push.
+ *
+ * @param context - Transformer context
+ * @returns void - initialization successful
+ * @returns false - initialization failed, skip this transformer
+ * @returns Config<T> - return updated config
+ */
+type InitFn$1<T extends TypesGeneric$2 = Types$3> = (context: Context$4<T>) => PromiseOrValue<void | false | Config$4<T>>;
+/**
+ * Transformer instance returned by Init function.
+ */
+interface Instance$4<T extends TypesGeneric$2 = Types$3> {
+    type: string;
+    config: Config$4<T>;
+    push: Fn$2<T>;
+    init?: InitFn$1<T>;
+    destroy?: DestroyFn<Config$4<T>, Env$2<T>>;
+}
+/**
+ * Transformer initialization function.
+ * Creates a transformer instance from context.
+ */
+type Init$2<T extends TypesGeneric$2 = Types$3> = (context: Context$4<Types$3<Partial<Settings$2<T>>, Env$2<T>, InitSettings$2<T>>>) => Instance$4<T> | Promise<Instance$4<T>>;
+/**
+ * Configuration for initializing a transformer.
+ * Used in collector registration.
+ */
+type InitTransformer<T extends TypesGeneric$2 = Types$3> = {
+    code: Init$2<T>;
+    config?: Partial<Config$4<T>>;
+    env?: Partial<Env$2<T>>;
+    before?: RouteSpec;
+    next?: RouteSpec;
+    cache?: Cache;
+};
+/**
+ * Transformers configuration for collector.
+ * Maps transformer IDs to their initialization configurations.
+ */
+interface InitTransformers {
+    [transformerId: string]: InitTransformer<any>;
+}
+/**
+ * Active transformer instances registry.
+ */
+interface Transformers {
+    [transformerId: string]: Instance$4;
+}
+
+type transformer_ChainResult = ChainResult;
+type transformer_InitTransformer<T extends TypesGeneric$2 = Types$3> = InitTransformer<T>;
+type transformer_InitTransformers = InitTransformers;
+type transformer_Route = Route;
+type transformer_RouteSpec = RouteSpec;
+type transformer_Transformers = Transformers;
+declare namespace transformer {
+  export type { BaseEnv$2 as BaseEnv, transformer_ChainResult as ChainResult, Config$4 as Config, Context$4 as Context, Env$2 as Env, Fn$2 as Fn, Init$2 as Init, InitFn$1 as InitFn, InitSettings$2 as InitSettings, transformer_InitTransformer as InitTransformer, transformer_InitTransformers as InitTransformers, Instance$4 as Instance, Result$1 as Result, transformer_Route as Route, transformer_RouteSpec as RouteSpec, Settings$2 as Settings, transformer_Transformers as Transformers, Types$3 as Types, TypesGeneric$2 as TypesGeneric, TypesOf$2 as TypesOf };
+}
+
 /**
  * Single flow configuration.
  *
@@ -900,7 +1088,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.
          *
@@ -909,7 +1097,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;
         /**
@@ -951,7 +1139,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.
          *
@@ -959,7 +1147,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). */
@@ -992,7 +1180,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.
          *
@@ -1003,7 +1191,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). */
@@ -1223,7 +1411,7 @@ type Handler = (level: Level, message: string, context: LogContext, scope: strin
  * Logger instance with scoping support
  * All logs automatically include trace path from scoping
  */
-interface Instance$4 {
+interface Instance$3 {
     /**
      * Log an error message (always visible unless silenced)
      */
@@ -1254,12 +1442,12 @@ interface Instance$4 {
      * @param name - Scope name (e.g., destination type, destination key)
      * @returns A new logger instance with the scope applied
      */
-    scope: (name: string) => Instance$4;
+    scope: (name: string) => Instance$3;
 }
 /**
  * Logger configuration options
  */
-interface Config$4 {
+interface Config$3 {
     /**
      * Minimum log level to display
      * @default Level.ERROR
@@ -1285,7 +1473,7 @@ interface InternalConfig {
 /**
  * Logger factory function type
  */
-type Factory = (config?: Config$4) => Instance$4;
+type Factory = (config?: Config$3) => Instance$3;
 
 type logger_DefaultHandler = DefaultHandler;
 type logger_ErrorContext = ErrorContext;
@@ -1298,11 +1486,11 @@ type logger_LogContext = LogContext;
 type logger_LogFn = LogFn;
 type logger_ThrowFn = ThrowFn;
 declare namespace logger {
-  export { type Config$4 as Config, type logger_DefaultHandler as DefaultHandler, type logger_ErrorContext as ErrorContext, type logger_Factory as Factory, type logger_Handler as Handler, type Instance$4 as Instance, type logger_InternalConfig as InternalConfig, logger_Level as Level, type logger_LogContext as LogContext, type logger_LogFn as LogFn, type logger_ThrowFn as ThrowFn };
+  export { type Config$3 as Config, type logger_DefaultHandler as DefaultHandler, type logger_ErrorContext as ErrorContext, type logger_Factory as Factory, type logger_Handler as Handler, type Instance$3 as Instance, type logger_InternalConfig as InternalConfig, logger_Level as Level, type logger_LogContext as LogContext, type logger_LogFn as LogFn, type logger_ThrowFn as ThrowFn };
 }
 
 /** Collector state mapping for the `on` actions. */
-type Config$3 = {
+type Config$2 = {
     config?: Array<GenericFn>;
     consent?: Array<ConsentRule>;
     custom?: Array<GenericFn>;
@@ -1313,7 +1501,7 @@ type Config$3 = {
     user?: Array<UserFn>;
 };
 /** Allow arbitrary string events via `(string & {})`. */
-type Types$3 = keyof Config$3 | (string & {});
+type Types$2 = keyof Config$2 | (string & {});
 /** Map each event type to its expected data payload type. */
 interface EventDataMap {
     config: Partial<Config$6>;
@@ -1334,19 +1522,19 @@ type AnyEventData = EventDataMap[keyof EventDataMap];
  * Same posture as Mapping.Context: collector + logger only;
  * subscriptions are a collector-level concern, not a stage-level one.
  */
-interface Context$4 {
+interface Context$3 {
     collector: Instance$6;
-    logger: Instance$4;
+    logger: Instance$3;
 }
 /** Unified subscription callback shape. */
-type Fn$2<TData = unknown> = (data: TData, context: Context$4) => PromiseOrValue<void>;
+type Fn$1<TData = unknown> = (data: TData, context: Context$3) => PromiseOrValue<void>;
 /** Typed-data variants for readability and IntelliSense. All reduce to Fn<TData>. */
-type ConsentFn = Fn$2<Consent>;
-type GenericFn = Fn$2<unknown>;
-type ReadyFn = Fn$2<void>;
-type RunFn = Fn$2<void>;
-type SessionFn = Fn$2<SessionData | undefined>;
-type UserFn = Fn$2<User>;
+type ConsentFn = Fn$1<Consent>;
+type GenericFn = Fn$1<unknown>;
+type ReadyFn = Fn$1<void>;
+type RunFn = Fn$1<void>;
+type SessionFn = Fn$1<SessionData | undefined>;
+type UserFn = Fn$1<User>;
 /**
  * Consent rule: a record of `{ [consentKey]: ConsentFn }`.
  * Only the consent action uses this shape (per-key handler dispatch).
@@ -1371,8 +1559,8 @@ interface OnConfig {
  * Destination `on` handler: receives the action type and a destination context.
  * Already context-style; kept for compatibility with the destination interface.
  */
-type OnFn<T extends TypesGeneric$3 = Types$4> = (type: Types$3, context: Context$5<T>) => PromiseOrValue<void>;
-type OnFnRuntime = (type: Types$3, context: Context$5) => PromiseOrValue<void>;
+type OnFn<T extends TypesGeneric$3 = Types$4> = (type: Types$2, context: Context$5<T>) => PromiseOrValue<void>;
+type OnFnRuntime = (type: Types$2, context: Context$5) => PromiseOrValue<void>;
 
 type on_AnyEventData = AnyEventData;
 type on_ConsentFn = ConsentFn;
@@ -1389,176 +1577,7 @@ type on_SessionFn = SessionFn;
 type on_Subscription = Subscription;
 type on_UserFn = UserFn;
 declare namespace on {
-  export type { on_AnyEventData as AnyEventData, Config$3 as Config, on_ConsentFn as ConsentFn, on_ConsentRule as ConsentRule, Context$4 as Context, on_EventData as EventData, on_EventDataMap as EventDataMap, Fn$2 as Fn, on_GenericFn as GenericFn, on_OnConfig as OnConfig, on_OnFn as OnFn, on_OnFnRuntime as OnFnRuntime, on_ReadyFn as ReadyFn, on_RunFn as RunFn, on_SessionFn as SessionFn, on_Subscription as Subscription, Types$3 as Types, on_UserFn as UserFn };
-}
-
-interface NextRule {
-    match: MatchExpression | '*';
-    next: Next;
-}
-type Next = string | string[] | NextRule[];
-/**
- * Base environment interface for walkerOS transformers.
- *
- * Minimal like Destination - just an extensible object.
- * Transformers receive dependencies through context, not env.
- */
-interface BaseEnv$2 {
-    [key: string]: unknown;
-}
-/**
- * Type bundle for transformer generics.
- * Groups Settings, InitSettings, and Env into a single type parameter.
- * Follows the Source/Destination pattern.
- *
- * @template S - Settings configuration type
- * @template E - Environment type
- * @template I - InitSettings configuration type (user input)
- */
-interface Types$2<S = unknown, E = BaseEnv$2, I = S> {
-    settings: S;
-    initSettings: I;
-    env: E;
-}
-/**
- * Generic constraint for Types - ensures T has required properties for indexed access.
- */
-type TypesGeneric$2 = {
-    settings: any;
-    initSettings: any;
-    env: any;
-};
-/**
- * Type extractors for consistent usage with Types bundle.
- */
-type Settings$2<T extends TypesGeneric$2 = Types$2> = T['settings'];
-type InitSettings$2<T extends TypesGeneric$2 = Types$2> = T['initSettings'];
-type Env$2<T extends TypesGeneric$2 = Types$2> = T['env'];
-/**
- * Inference helper: Extract Types from Instance.
- */
-type TypesOf$2<I> = I extends Instance$3<infer T> ? T : never;
-/**
- * Transformer configuration.
- */
-interface Config$2<T extends TypesGeneric$2 = Types$2> {
-    settings?: InitSettings$2<T>;
-    env?: Env$2<T>;
-    id?: string;
-    logger?: Config$4;
-    before?: Next;
-    next?: Next;
-    cache?: Cache;
-    init?: boolean;
-    disabled?: boolean;
-    /** Return this value instead of calling push(). Global mock for all chains. */
-    mock?: unknown;
-    /** Path-specific mock values keyed by chain path (e.g., "destination.ga4.before"). Takes precedence over global mock. */
-    chainMocks?: Record<string, unknown>;
-}
-/**
- * Context provided to transformer functions.
- * Extends base context with transformer-specific properties.
- */
-interface Context$3<T extends TypesGeneric$2 = Types$2> extends Base<Config$2<T>, Env$2<T>> {
-    id: string;
-    ingest: Ingest;
-}
-/**
- * Unified result type for transformer functions.
- * Replaces the old union return type with a structured object.
- *
- * @field event - Modified event to continue with
- * @field respond - Wrapped respond function for downstream transformers
- * @field next - Branch to a different chain (replaces BranchResult)
- */
-interface Result$1<E = DeepPartialEvent> {
-    event?: E;
-    respond?: RespondFn;
-    next?: Next;
-}
-/**
- * Result of running a transformer chain.
- * Returns the processed event (singular, fan-out array, or null if dropped)
- * alongside the potentially wrapped respond function.
- */
-interface ChainResult {
-    event: DeepPartialEvent | DeepPartialEvent[] | null;
-    respond?: RespondFn;
-}
-/**
- * The main transformer function.
- *
- * Pre-collector transformers use default E = DeepPartialEvent.
- * Post-collector transformers can use E = Event for type-safe access.
- * A transformer written for DeepPartialEvent works in both positions
- * because Event is a subtype of DeepPartialEvent.
- *
- * @returns Result - structured result with event, respond, next
- * @returns Result[] - fan-out: each Result continues independently through remaining chain
- * @returns void - continue with current event unchanged (passthrough)
- * @returns false - stop chain, cancel further processing
- */
-type Fn$1<T extends TypesGeneric$2 = Types$2, E = DeepPartialEvent> = (event: E, context: Context$3<T>) => PromiseOrValue<Result$1<E> | Result$1<E>[] | false | void>;
-/**
- * Optional initialization function.
- * Called once before first push.
- *
- * @param context - Transformer context
- * @returns void - initialization successful
- * @returns false - initialization failed, skip this transformer
- * @returns Config<T> - return updated config
- */
-type InitFn$1<T extends TypesGeneric$2 = Types$2> = (context: Context$3<T>) => PromiseOrValue<void | false | Config$2<T>>;
-/**
- * Transformer instance returned by Init function.
- */
-interface Instance$3<T extends TypesGeneric$2 = Types$2> {
-    type: string;
-    config: Config$2<T>;
-    push: Fn$1<T>;
-    init?: InitFn$1<T>;
-    destroy?: DestroyFn<Config$2<T>, Env$2<T>>;
-}
-/**
- * Transformer initialization function.
- * Creates a transformer instance from context.
- */
-type Init$2<T extends TypesGeneric$2 = Types$2> = (context: Context$3<Types$2<Partial<Settings$2<T>>, Env$2<T>, InitSettings$2<T>>>) => Instance$3<T> | Promise<Instance$3<T>>;
-/**
- * Configuration for initializing a transformer.
- * Used in collector registration.
- */
-type InitTransformer<T extends TypesGeneric$2 = Types$2> = {
-    code: Init$2<T>;
-    config?: Partial<Config$2<T>>;
-    env?: Partial<Env$2<T>>;
-    before?: Next;
-    next?: Next;
-    cache?: Cache;
-};
-/**
- * Transformers configuration for collector.
- * Maps transformer IDs to their initialization configurations.
- */
-interface InitTransformers {
-    [transformerId: string]: InitTransformer<any>;
-}
-/**
- * Active transformer instances registry.
- */
-interface Transformers {
-    [transformerId: string]: Instance$3;
-}
-
-type transformer_ChainResult = ChainResult;
-type transformer_InitTransformer<T extends TypesGeneric$2 = Types$2> = InitTransformer<T>;
-type transformer_InitTransformers = InitTransformers;
-type transformer_Next = Next;
-type transformer_NextRule = NextRule;
-type transformer_Transformers = Transformers;
-declare namespace transformer {
-  export type { BaseEnv$2 as BaseEnv, transformer_ChainResult as ChainResult, Config$2 as Config, Context$3 as Context, Env$2 as Env, Fn$1 as Fn, Init$2 as Init, InitFn$1 as InitFn, InitSettings$2 as InitSettings, transformer_InitTransformer as InitTransformer, transformer_InitTransformers as InitTransformers, Instance$3 as Instance, transformer_Next as Next, transformer_NextRule as NextRule, Result$1 as Result, Settings$2 as Settings, transformer_Transformers as Transformers, Types$2 as Types, TypesGeneric$2 as TypesGeneric, TypesOf$2 as TypesOf };
+  export type { on_AnyEventData as AnyEventData, Config$2 as Config, on_ConsentFn as ConsentFn, on_ConsentRule as ConsentRule, Context$3 as Context, on_EventData as EventData, on_EventDataMap as EventDataMap, Fn$1 as Fn, on_GenericFn as GenericFn, on_OnConfig as OnConfig, on_OnFn as OnFn, on_OnFnRuntime as OnFnRuntime, on_ReadyFn as ReadyFn, on_RunFn as RunFn, on_SessionFn as SessionFn, on_Subscription as Subscription, Types$2 as Types, on_UserFn as UserFn };
 }
 
 interface Context$2 {
@@ -1590,7 +1609,7 @@ interface BaseEnv$1 {
     command: CommandFn;
     sources?: Sources;
     elb: Fn$3;
-    logger: Instance$4;
+    logger: Instance$3;
 }
 /**
  * Type bundle for source generics.
@@ -1601,7 +1620,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;
@@ -1643,13 +1662,13 @@ interface Config$1<T extends TypesGeneric$1 = Types$1> extends Config$7<Mapping<
     /** Source identifier; defaults to the InitSources object key. */
     id?: string;
     /** Logger configuration (level, handler) to override the collector's defaults. */
-    logger?: Config$4;
+    logger?: Config$3;
     /** Mark as primary source; its push function becomes the exported `elb` from startFlow. */
     primary?: boolean;
     /** 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>;
@@ -1683,7 +1702,7 @@ interface Instance$2<T extends TypesGeneric$1 = Types$1> {
     setup?: SetupFn<Config$1<T>, Env$1<T>>;
     push: Push<T>;
     destroy?: DestroyFn<Config$1<T>, Env$1<T>>;
-    on?(event: Types$3, context?: unknown): void | boolean | Promise<void | boolean>;
+    on?(event: Types$2, context?: unknown): void | boolean | Promise<void | boolean>;
     /**
      * Optional setup hook. Called by the collector eagerly after all source
      * factories have run, regardless of `config.require`. Use for prep work
@@ -1698,7 +1717,7 @@ interface Instance$2<T extends TypesGeneric$1 = Types$1> {
      * Flushed by the collector when the source becomes started.
      */
     queueOn?: Array<{
-        type: Types$3;
+        type: Types$2;
         data: unknown;
     }>;
 }
@@ -1725,8 +1744,8 @@ type InitSource<T extends TypesGeneric$1 = Types$1> = {
     config?: Partial<Config$1<T>>;
     env?: Partial<Env$1<T>>;
     primary?: boolean;
-    next?: Next;
-    before?: Next;
+    next?: RouteSpec;
+    before?: RouteSpec;
     cache?: Cache;
 };
 /**
@@ -1776,9 +1795,9 @@ interface Config<T extends TypesGeneric = Types> {
     settings?: InitSettings<T>;
     env?: Env<T>;
     id?: string;
-    logger?: Config$4;
+    logger?: Config$3;
     /**
-     * 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>;
@@ -2136,7 +2155,7 @@ interface SendResponse {
  * Creates a TransformerResult for dynamic chain routing.
  * Use this in transformer push functions to redirect the chain.
  */
-declare function branch(event: DeepPartialEvent, next: Next): Result$1;
+declare function branch(event: DeepPartialEvent, next: RouteSpec): Result$1;
 
 /**
  * Anonymizes an IPv4 address by setting the last octet to 0.
@@ -2546,7 +2565,7 @@ declare function isString(value: unknown): value is string;
  * // TODO: Consider compile-time stripping of debug logs in production builds
  * // e.g., if (__DEV__) { logger.debug(...) }
  */
-declare function createLogger(config?: Config$4): Instance$4;
+declare function createLogger(config?: Config$3): Instance$3;
 
 /**
  * Gets the mapping for an event.
@@ -2681,21 +2700,21 @@ declare function traverseEnv<T extends object>(env: T, replacer: (value: unknown
  * const ctx = createMockContext({ ingest: { ...createIngest('test'), path: '/api' } });
  * ```
  */
-declare function createMockContext<T extends TypesGeneric$2 = Types$2>(overrides?: Partial<Omit<Context$3<T>, 'config' | 'ingest'> & {
-    config?: Config$2<T> | Config$5<TypesGeneric$3>;
+declare function createMockContext<T extends TypesGeneric$2 = Types$3>(overrides?: Partial<Omit<Context$4<T>, 'config' | 'ingest'> & {
+    config?: Config$4<T> | Config$5<TypesGeneric$3>;
     ingest?: Ingest | (Record<string, unknown> & {
         _meta: Ingest['_meta'];
     });
     data?: unknown;
     rule?: unknown;
-}>): Context$3<T> & PushContext<TypesGeneric$3>;
+}>): Context$4<T> & PushContext<TypesGeneric$3>;
 
 /**
  * Mock logger instance for testing
  * Includes all logger methods as jest.fn() plus tracking of scoped loggers
  * Extends Instance to ensure type compatibility
  */
-interface MockLogger extends Instance$4 {
+interface MockLogger extends Instance$3 {
     error: jest.Mock;
     warn: jest.Mock;
     info: jest.Mock;
@@ -2844,7 +2863,7 @@ declare function tryCatchAsync<P extends unknown[], R>(fn: (...args: P) => R, on
  *   `console.warn` when not provided.
  * @returns The wrapped function.
  */
-declare function useHooks<P extends unknown[], R>(fn: (...args: P) => R, name: string, hooks: Functions, logger?: Instance$4): (...args: P) => R;
+declare function useHooks<P extends unknown[], R>(fn: (...args: P) => R, name: string, hooks: Functions, logger?: Instance$3): (...args: P) => R;
 
 /**
  * Parses a user agent string to extract browser, OS, and device information.
@@ -3042,8 +3061,8 @@ type CompiledNext = {
     type: 'routes';
     routes: CompiledRoute[];
 };
-declare function isRouteArray(next: Next): next is NextRule[];
-declare function compileNext(next: Next | undefined): CompiledNext | undefined;
+declare function isRouteArray(next: RouteSpec): next is Route[];
+declare function compileNext(next: RouteSpec | undefined): CompiledNext | undefined;
 declare function resolveNext(compiled: CompiledNext | undefined, context?: Record<string, unknown>): string | string[] | undefined;
 
 interface CompiledCacheRule {