@walkeros/core 2.1.0 → 2.2.0-next-1772811722420

package/dist/index.d.mts

@@ -28,7 +28,7 @@ declare function createRespond(sender: (options: RespondOptions) => void): Respo
 /**
  * Core collector configuration interface
  */
-interface Config$7 {
+interface Config$8 {
     /** Whether to run collector automatically */
     run?: boolean;
     /** Version for event tagging */
@@ -38,12 +38,12 @@ interface Config$7 {
     /** Static session data even on a new run */
     sessionStatic: Partial<SessionData>;
     /** Logger configuration */
-    logger?: Config$4;
+    logger?: Config$5;
 }
 /**
  * Initialization configuration that extends Config with initial state
  */
-interface InitConfig extends Partial<Config$7> {
+interface InitConfig extends Partial<Config$8> {
     /** Initial consent state */
     consent?: Consent;
     /** Initial user data */
@@ -56,6 +56,8 @@ interface InitConfig extends Partial<Config$7> {
     destinations?: InitDestinations;
     /** Transformer configurations */
     transformers?: InitTransformers;
+    /** Store configurations */
+    stores?: InitStores;
     /** Initial custom properties */
     custom?: Properties;
 }
@@ -91,13 +93,16 @@ interface DestinationStatus {
     duration: number;
 }
 interface Sources {
-    [id: string]: Instance;
+    [id: string]: Instance$1;
 }
 interface Destinations$1 {
-    [id: string]: Instance$3;
+    [id: string]: Instance$4;
 }
 interface Transformers$1 {
-    [id: string]: Instance$1;
+    [id: string]: Instance$2;
+}
+interface Stores$1 {
+    [id: string]: Instance;
 }
 type CommandType = 'action' | 'config' | 'consent' | 'context' | 'destination' | 'elb' | 'globals' | 'hook' | 'init' | 'link' | 'run' | 'user' | 'walker' | string;
 /**
@@ -108,7 +113,7 @@ interface PushOptions {
     id?: string;
     ingest?: unknown;
     respond?: RespondFn;
-    mapping?: Config$3;
+    mapping?: Config$4;
     preChain?: string[];
 }
 /**
@@ -121,11 +126,11 @@ interface PushFn$1 {
  * Command function signature - handles walker commands only
  */
 interface CommandFn {
-    (command: 'config', config: Partial<Config$7>): Promise<PushResult>;
+    (command: 'config', config: Partial<Config$8>): Promise<PushResult>;
     (command: 'consent', consent: Consent): Promise<PushResult>;
-    <T extends Types$3>(command: 'destination', destination: Init$2<T> | Instance$3<T>, config?: Config$6<T>): Promise<PushResult>;
+    <T extends Types$4>(command: 'destination', destination: Init$3<T> | Instance$4<T>, config?: Config$7<T>): Promise<PushResult>;
     <K extends keyof Functions>(command: 'hook', name: K, hookFn: Functions[K]): Promise<PushResult>;
-    (command: 'on', type: Types$2, rules: SingleOrArray<Options>): Promise<PushResult>;
+    (command: 'on', type: Types$3, rules: SingleOrArray<Options>): Promise<PushResult>;
     (command: 'user', user: User): Promise<PushResult>;
     (command: 'run', runState?: {
         consent?: Consent;
@@ -135,21 +140,22 @@ interface CommandFn {
     }): Promise<PushResult>;
     (command: string, data?: unknown, options?: unknown): Promise<PushResult>;
 }
-interface Instance$4 {
+interface Instance$5 {
     push: PushFn$1;
     command: CommandFn;
     allowed: boolean;
-    config: Config$7;
+    config: Config$8;
     consent: Consent;
     count: number;
     custom: Properties;
     sources: Sources;
     destinations: Destinations$1;
     transformers: Transformers$1;
+    stores: Stores$1;
     globals: Properties;
     group: string;
     hooks: Functions;
-    logger: Instance$2;
+    logger: Instance$3;
     on: OnConfig;
     queue: Events;
     round: number;
@@ -174,7 +180,7 @@ type collector_SourceStatus = SourceStatus;
 type collector_Sources = Sources;
 type collector_Status = Status;
 declare namespace collector {
-  export type { collector_CommandFn as CommandFn, collector_CommandType as CommandType, Config$7 as Config, collector_DestinationStatus as DestinationStatus, Destinations$1 as Destinations, collector_InitConfig as InitConfig, Instance$4 as Instance, PushFn$1 as PushFn, collector_PushOptions as PushOptions, collector_SessionData as SessionData, collector_SourceStatus as SourceStatus, collector_Sources as Sources, collector_Status as Status, Transformers$1 as Transformers };
+  export type { collector_CommandFn as CommandFn, collector_CommandType as CommandType, Config$8 as Config, collector_DestinationStatus as DestinationStatus, Destinations$1 as Destinations, collector_InitConfig as InitConfig, Instance$5 as Instance, PushFn$1 as PushFn, collector_PushOptions as PushOptions, collector_SessionData as SessionData, collector_SourceStatus as SourceStatus, collector_Sources as Sources, collector_Status as Status, Stores$1 as Stores, Transformers$1 as Transformers };
 }
 
 /**
@@ -182,8 +188,8 @@ declare namespace collector {
  * Sources, Transformers, and Destinations extend this.
  */
 interface Base<C = unknown, E = unknown> {
-    collector: Instance$4;
-    logger: Instance$2;
+    collector: Instance$5;
+    logger: Instance$3;
     config: C;
     env: E;
 }
@@ -203,7 +209,7 @@ interface Globals {
     [name: string]: Global;
 }
 interface Contexts {
-    [name: string]: Context$5;
+    [name: string]: Context$6;
 }
 interface Entities$1 {
     [name: string]: Entity$1;
@@ -213,7 +219,7 @@ interface Properties$1 {
 }
 interface Global extends Property$1 {
 }
-interface Context$5 extends Property$1 {
+interface Context$6 extends Property$1 {
 }
 interface Entity$1 {
     data: Properties$1;
@@ -242,7 +248,7 @@ type data_Globals = Globals;
 type data_PropertyValues = PropertyValues;
 type data_Trigger = Trigger;
 declare namespace data {
-  export type { data_Action as Action, data_Actions as Actions, Context$5 as Context, data_Contexts as Contexts, Contract$1 as Contract, Entities$1 as Entities, Entity$1 as Entity, data_Global as Global, data_Globals as Globals, Properties$1 as Properties, Property$1 as Property, PropertyType$1 as PropertyType, data_PropertyValues as PropertyValues, data_Trigger as Trigger };
+  export type { data_Action as Action, data_Actions as Actions, Context$6 as Context, data_Contexts as Contexts, Contract$1 as Contract, Entities$1 as Entities, Entity$1 as Entity, data_Global as Global, data_Globals as Globals, Properties$1 as Properties, Property$1 as Property, PropertyType$1 as PropertyType, data_PropertyValues as PropertyValues, data_Trigger as Trigger };
 }
 
 /**
@@ -260,7 +266,7 @@ interface DestroyContext<C = unknown, E = unknown> {
     /** Runtime environment/dependencies (DB clients, auth clients, etc.). */
     env: E;
     /** Scoped logger for this step instance. */
-    logger: Instance$2;
+    logger: Instance$3;
 }
 /**
  * Destroy function signature for step lifecycle cleanup.
@@ -283,7 +289,7 @@ declare namespace lifecycle {
  * their runtime environment requirements. Platform-specific extensions
  * should extend this interface.
  */
-interface BaseEnv$2 {
+interface BaseEnv$3 {
     /**
      * Generic global properties that destinations may require
      * Platform-specific implementations can extend this interface
@@ -294,7 +300,7 @@ interface BaseEnv$2 {
  * Type bundle for destination generics.
  * Groups Settings, InitSettings, Mapping, and Env into a single type parameter.
  */
-interface Types$3<S = unknown, M = unknown, E = BaseEnv$2, I = S> {
+interface Types$4<S = unknown, M = unknown, E = BaseEnv$3, I = S> {
     settings: S;
     initSettings: I;
     mapping: M;
@@ -303,7 +309,7 @@ interface Types$3<S = unknown, M = unknown, E = BaseEnv$2, I = S> {
 /**
  * Generic constraint for Types - ensures T has required properties for indexed access
  */
-type TypesGeneric$2 = {
+type TypesGeneric$3 = {
     settings: any;
     initSettings: any;
     mapping: any;
@@ -312,40 +318,40 @@ type TypesGeneric$2 = {
 /**
  * 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 Mapping$1<T extends TypesGeneric$2 = Types$3> = T['mapping'];
-type Env$2<T extends TypesGeneric$2 = Types$3> = T['env'];
+type Settings$3<T extends TypesGeneric$3 = Types$4> = T['settings'];
+type InitSettings$3<T extends TypesGeneric$3 = Types$4> = T['initSettings'];
+type Mapping$1<T extends TypesGeneric$3 = Types$4> = T['mapping'];
+type Env$3<T extends TypesGeneric$3 = Types$4> = T['env'];
 /**
  * Inference helper: Extract Types from Instance
  */
-type TypesOf$2<I> = I extends Instance$3<infer T> ? T : never;
-interface Instance$3<T extends TypesGeneric$2 = Types$3> {
-    config: Config$6<T>;
+type TypesOf$3<I> = I extends Instance$4<infer T> ? T : never;
+interface Instance$4<T extends TypesGeneric$3 = Types$4> {
+    config: Config$7<T>;
     queuePush?: Events;
     queueOn?: Array<{
-        type: Types$2;
+        type: Types$3;
         data?: unknown;
     }>;
     dlq?: DLQ;
     batches?: BatchRegistry<Mapping$1<T>>;
     type?: string;
-    env?: Env$2<T>;
-    init?: InitFn$1<T>;
+    env?: Env$3<T>;
+    init?: InitFn$2<T>;
     push: PushFn<T>;
     pushBatch?: PushBatchFn<T>;
     on?: OnFn;
-    destroy?: DestroyFn<Config$6<T>, Env$2<T>>;
+    destroy?: DestroyFn<Config$7<T>, Env$3<T>>;
 }
-interface Config$6<T extends TypesGeneric$2 = Types$3> {
+interface Config$7<T extends TypesGeneric$3 = Types$4> {
     /** Required consent states to push events; queues events when not granted. */
     consent?: Consent;
     /** Implementation-specific configuration passed to the init function. */
-    settings?: InitSettings$2<T>;
+    settings?: InitSettings$3<T>;
     /** Global data transformation applied to all events; result passed as context.data to push. */
     data?: Value | Values;
     /** Runtime dependencies merged from code and config env; extensible per destination. */
-    env?: Env$2<T>;
+    env?: Env$3<T>;
     /** Destination identifier; auto-generated if not provided. */
     id?: string;
     /** Whether the destination has been initialized; prevents re-initialization. */
@@ -353,7 +359,7 @@ interface Config$6<T extends TypesGeneric$2 = Types$3> {
     /** 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$5;
     /** 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. */
@@ -365,42 +371,42 @@ interface Config$6<T extends TypesGeneric$2 = Types$3> {
     /** Transformer chain to run after collector processing but before this destination. */
     before?: string | string[];
 }
-type PartialConfig$1<T extends TypesGeneric$2 = Types$3> = Config$6<Types$3<Partial<Settings$2<T>> | Settings$2<T>, Partial<Mapping$1<T>> | Mapping$1<T>, Env$2<T>>>;
+type PartialConfig$1<T extends TypesGeneric$3 = Types$4> = Config$7<Types$4<Partial<Settings$3<T>> | Settings$3<T>, Partial<Mapping$1<T>> | Mapping$1<T>, Env$3<T>>>;
 interface Policy$1 {
     [key: string]: Value;
 }
-type Code<T extends TypesGeneric$2 = Types$3> = Instance$3<T>;
-type Init$2<T extends TypesGeneric$2 = Types$3> = {
+type Code<T extends TypesGeneric$3 = Types$4> = Instance$4<T>;
+type Init$3<T extends TypesGeneric$3 = Types$4> = {
     code: Code<T>;
-    config?: Partial<Config$6<T>>;
-    env?: Partial<Env$2<T>>;
+    config?: Partial<Config$7<T>>;
+    env?: Partial<Env$3<T>>;
     before?: string | string[];
 };
 interface InitDestinations {
-    [key: string]: Init$2<any>;
+    [key: string]: Init$3<any>;
 }
 interface Destinations {
-    [key: string]: Instance$3;
+    [key: string]: Instance$4;
 }
 /**
  * Context provided to destination functions.
  * Extends base context with destination-specific properties.
  */
-interface Context$4<T extends TypesGeneric$2 = Types$3> extends Base<Config$6<T>, Env$2<T>> {
+interface Context$5<T extends TypesGeneric$3 = Types$4> extends Base<Config$7<T>, Env$3<T>> {
     id: string;
     data?: Data$1;
 }
-interface PushContext<T extends TypesGeneric$2 = Types$3> extends Context$4<T> {
+interface PushContext<T extends TypesGeneric$3 = Types$4> extends Context$5<T> {
     ingest?: unknown;
     rule?: Rule<Mapping$1<T>>;
 }
-interface PushBatchContext<T extends TypesGeneric$2 = Types$3> extends Context$4<T> {
+interface PushBatchContext<T extends TypesGeneric$3 = Types$4> extends Context$5<T> {
     ingest?: unknown;
     rule?: Rule<Mapping$1<T>>;
 }
-type InitFn$1<T extends TypesGeneric$2 = Types$3> = (context: Context$4<T>) => PromiseOrValue<void | false | Config$6<T>>;
-type PushFn<T extends TypesGeneric$2 = Types$3> = (event: Event, context: PushContext<T>) => PromiseOrValue<void | unknown>;
-type PushBatchFn<T extends TypesGeneric$2 = Types$3> = (batch: Batch<Mapping$1<T>>, context: PushBatchContext<T>) => void;
+type InitFn$2<T extends TypesGeneric$3 = Types$4> = (context: Context$5<T>) => PromiseOrValue<void | false | Config$7<T>>;
+type PushFn<T extends TypesGeneric$3 = Types$4> = (event: Event, context: PushContext<T>) => PromiseOrValue<void | unknown>;
+type PushBatchFn<T extends TypesGeneric$3 = Types$4> = (batch: Batch<Mapping$1<T>>, context: PushBatchContext<T>) => void;
 type PushEvent<Mapping = unknown> = {
     event: Event;
     mapping?: Rule<Mapping>;
@@ -432,19 +438,19 @@ type DLQ = Array<[Event, unknown]>;
 
 type destination_Batch<Mapping> = Batch<Mapping>;
 type destination_BatchRegistry<Mapping> = BatchRegistry<Mapping>;
-type destination_Code<T extends TypesGeneric$2 = Types$3> = Code<T>;
+type destination_Code<T extends TypesGeneric$3 = Types$4> = Code<T>;
 type destination_DLQ = DLQ;
 type destination_Destinations = Destinations;
 type destination_InitDestinations = InitDestinations;
-type destination_PushBatchContext<T extends TypesGeneric$2 = Types$3> = PushBatchContext<T>;
-type destination_PushBatchFn<T extends TypesGeneric$2 = Types$3> = PushBatchFn<T>;
-type destination_PushContext<T extends TypesGeneric$2 = Types$3> = PushContext<T>;
+type destination_PushBatchContext<T extends TypesGeneric$3 = Types$4> = PushBatchContext<T>;
+type destination_PushBatchFn<T extends TypesGeneric$3 = Types$4> = PushBatchFn<T>;
+type destination_PushContext<T extends TypesGeneric$3 = Types$4> = PushContext<T>;
 type destination_PushEvent<Mapping = unknown> = PushEvent<Mapping>;
 type destination_PushEvents<Mapping = unknown> = PushEvents<Mapping>;
-type destination_PushFn<T extends TypesGeneric$2 = Types$3> = PushFn<T>;
+type destination_PushFn<T extends TypesGeneric$3 = Types$4> = PushFn<T>;
 type destination_Ref = Ref;
 declare namespace destination {
-  export type { BaseEnv$2 as BaseEnv, destination_Batch as Batch, destination_BatchRegistry as BatchRegistry, destination_Code as Code, Config$6 as Config, Context$4 as Context, destination_DLQ as DLQ, Data$1 as Data, destination_Destinations as Destinations, Env$2 as Env, Init$2 as Init, destination_InitDestinations as InitDestinations, InitFn$1 as InitFn, InitSettings$2 as InitSettings, Instance$3 as Instance, Mapping$1 as Mapping, PartialConfig$1 as PartialConfig, Policy$1 as Policy, Push$1 as Push, destination_PushBatchContext as PushBatchContext, destination_PushBatchFn as PushBatchFn, destination_PushContext as PushContext, destination_PushEvent as PushEvent, destination_PushEvents as PushEvents, destination_PushFn as PushFn, destination_Ref as Ref, Settings$2 as Settings, Types$3 as Types, TypesGeneric$2 as TypesGeneric, TypesOf$2 as TypesOf };
+  export type { BaseEnv$3 as BaseEnv, destination_Batch as Batch, destination_BatchRegistry as BatchRegistry, destination_Code as Code, Config$7 as Config, Context$5 as Context, destination_DLQ as DLQ, Data$1 as Data, destination_Destinations as Destinations, Env$3 as Env, Init$3 as Init, destination_InitDestinations as InitDestinations, InitFn$2 as InitFn, InitSettings$3 as InitSettings, Instance$4 as Instance, Mapping$1 as Mapping, PartialConfig$1 as PartialConfig, Policy$1 as Policy, Push$1 as Push, destination_PushBatchContext as PushBatchContext, destination_PushBatchFn as PushBatchFn, destination_PushContext as PushContext, destination_PushEvent as PushEvent, destination_PushEvents as PushEvents, destination_PushFn as PushFn, destination_Ref as Ref, Settings$3 as Settings, Types$4 as Types, TypesGeneric$3 as TypesGeneric, TypesOf$3 as TypesOf };
 }
 
 interface EventFn<R = Promise<PushResult>> {
@@ -457,9 +463,9 @@ interface Fn$2<R = Promise<PushResult>, Config = unknown> extends EventFn<R>, Wa
 interface WalkerCommands<R = Promise<PushResult>, Config = unknown> {
     (event: 'walker config', config: Partial<Config>): R;
     (event: 'walker consent', consent: Consent): R;
-    <T extends Types$3>(event: 'walker destination', destination: Init$2<T> | Instance$3<T>, config?: Config$6<T>): R;
+    <T extends Types$4>(event: 'walker destination', destination: Init$3<T> | Instance$4<T>, config?: Config$7<T>): R;
     <K extends keyof Functions>(event: 'walker hook', name: K, hookFn: Functions[K]): R;
-    (event: 'walker on', type: Types$2, rules: SingleOrArray<Options>): R;
+    (event: 'walker on', type: Types$3, rules: SingleOrArray<Options>): R;
     (event: 'walker user', user: User): R;
     (event: 'walker run', runState: {
         consent?: Consent;
@@ -675,7 +681,7 @@ interface Setup {
      * Named flow configurations.
      * If only one flow exists, it's auto-selected.
      */
-    flows: Record<string, Config$5>;
+    flows: Record<string, Config$6>;
 }
 /**
  * Single flow configuration.
@@ -687,7 +693,7 @@ interface Setup {
  *
  * Variables/definitions cascade: source/destination > config > setup
  */
-interface Config$5 {
+interface Config$6 {
     /**
      * Web platform configuration.
      * Presence indicates web platform (browser-based tracking).
@@ -705,6 +711,18 @@ interface Config$5 {
      * Merges on top of Setup-level contract (additive).
      */
     contract?: Contract;
+    /**
+     * Store configurations (key-value storage).
+     *
+     * @remarks
+     * Stores provide key-value storage consumed by sources, transformers,
+     * and destinations via env injection. Referenced using $store:storeId
+     * prefix in env values.
+     *
+     * Key = unique store identifier (arbitrary)
+     * Value = store reference with package and config
+     */
+    stores?: Record<string, StoreReference>;
     /**
      * Source configurations (data capture).
      *
@@ -1051,6 +1069,47 @@ interface TransformerReference {
      */
     examples?: StepExamples;
 }
+/**
+ * Store reference with inline package syntax.
+ *
+ * @remarks
+ * References a store package and provides configuration.
+ * Stores provide key-value storage consumed by other components via env.
+ * Unlike sources/transformers/destinations, stores have no chain properties
+ * (no `next` or `before`) — they are passive infrastructure.
+ */
+interface StoreReference {
+    /**
+     * Package specifier with optional version.
+     * Optional when `code` is provided for inline code.
+     */
+    package?: string;
+    /**
+     * Resolved import variable name or inline code definition.
+     */
+    code?: string | InlineCode;
+    /**
+     * Store-specific configuration.
+     */
+    config?: unknown;
+    /**
+     * Store environment configuration.
+     */
+    env?: unknown;
+    /**
+     * Store-level variables (highest priority in cascade).
+     */
+    variables?: Variables;
+    /**
+     * Store-level definitions (highest priority in cascade).
+     */
+    definitions?: Definitions;
+    /**
+     * Named examples for testing and documentation.
+     * Stripped during flow resolution.
+     */
+    examples?: StepExamples;
+}
 /**
  * Destination reference with inline package syntax.
  *
@@ -1169,11 +1228,12 @@ type flow_Setup = Setup;
 type flow_SourceReference = SourceReference;
 type flow_StepExample = StepExample;
 type flow_StepExamples = StepExamples;
+type flow_StoreReference = StoreReference;
 type flow_TransformerReference = TransformerReference;
 type flow_Variables = Variables;
 type flow_Web = Web;
 declare namespace flow {
-  export type { Config$5 as Config, flow_Contract as Contract, flow_ContractActions as ContractActions, flow_ContractSchema as ContractSchema, flow_Definitions as Definitions, flow_DestinationReference as DestinationReference, flow_InlineCode as InlineCode, flow_Packages as Packages, flow_Primitive as Primitive, flow_Server as Server, flow_Setup as Setup, flow_SourceReference as SourceReference, flow_StepExample as StepExample, flow_StepExamples as StepExamples, flow_TransformerReference as TransformerReference, flow_Variables as Variables, flow_Web as Web };
+  export type { Config$6 as Config, flow_Contract as Contract, flow_ContractActions as ContractActions, flow_ContractSchema as ContractSchema, flow_Definitions as Definitions, flow_DestinationReference as DestinationReference, flow_InlineCode as InlineCode, flow_Packages as Packages, flow_Primitive as Primitive, flow_Server as Server, flow_Setup as Setup, flow_SourceReference as SourceReference, flow_StepExample as StepExample, flow_StepExamples as StepExamples, flow_StoreReference as StoreReference, flow_TransformerReference as TransformerReference, flow_Variables as Variables, flow_Web as Web };
 }
 
 type AnyFunction$1<P extends unknown[] = never[], R = unknown> = (...args: P) => R;
@@ -1241,7 +1301,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$2 {
+interface Instance$3 {
     /**
      * Log an error message (always visible unless silenced)
      */
@@ -1272,12 +1332,12 @@ interface Instance$2 {
      * @param name - Scope name (e.g., destination type, destination key)
      * @returns A new logger instance with the scope applied
      */
-    scope: (name: string) => Instance$2;
+    scope: (name: string) => Instance$3;
 }
 /**
  * Logger configuration options
  */
-interface Config$4 {
+interface Config$5 {
     /**
      * Minimum log level to display
      * @default Level.ERROR
@@ -1303,7 +1363,7 @@ interface InternalConfig {
 /**
  * Logger factory function type
  */
-type Factory = (config?: Config$4) => Instance$2;
+type Factory = (config?: Config$5) => Instance$3;
 
 type logger_DefaultHandler = DefaultHandler;
 type logger_ErrorContext = ErrorContext;
@@ -1316,14 +1376,14 @@ 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$2 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$5 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 };
 }
 
 /**
  * Shared mapping configuration interface.
  * Used by both Source.Config and Destination.Config.
  */
-interface Config$3<T = unknown> {
+interface Config$4<T = unknown> {
     consent?: Consent;
     data?: Value | Values;
     mapping?: Rules<Rule<T>>;
@@ -1337,7 +1397,7 @@ interface Rules<T = Rule> {
 }
 interface Rule<Settings = unknown> {
     batch?: number;
-    batchFn?: (destination: Instance$3, collector: Instance$4) => void;
+    batchFn?: (destination: Instance$4, collector: Instance$5) => void;
     batched?: Batch<Settings>;
     condition?: Condition;
     consent?: Consent;
@@ -1347,7 +1407,7 @@ interface Rule<Settings = unknown> {
     name?: string;
     policy?: Policy;
 }
-interface Result$1 {
+interface Result$2 {
     eventMapping?: Rule;
     mappingKey?: string;
 }
@@ -1366,7 +1426,7 @@ interface ValueConfig {
     validate?: Validate;
     value?: PropertyType;
 }
-type Condition = (value: DeepPartialEvent | unknown, mapping?: Value, collector?: Instance$4) => PromiseOrValue<boolean>;
+type Condition = (value: DeepPartialEvent | unknown, mapping?: Value, collector?: Instance$5) => PromiseOrValue<boolean>;
 type Fn$1 = (value: DeepPartialEvent | unknown, mapping: Value, options: Options$1) => PromiseOrValue<Property | unknown>;
 type Loop = [Value, Value];
 type Map = {
@@ -1374,7 +1434,7 @@ type Map = {
 };
 interface Options$1 {
     consent?: Consent;
-    collector?: Instance$4;
+    collector?: Instance$5;
     props?: unknown;
 }
 type Validate = (value?: unknown) => PromiseOrValue<boolean>;
@@ -1392,10 +1452,10 @@ type mapping_ValueConfig = ValueConfig;
 type mapping_ValueType = ValueType;
 type mapping_Values = Values;
 declare namespace mapping {
-  export type { mapping_Condition as Condition, Config$3 as Config, mapping_Data as Data, Fn$1 as Fn, mapping_Loop as Loop, mapping_Map as Map, Options$1 as Options, mapping_Policy as Policy, Result$1 as Result, mapping_Rule as Rule, mapping_Rules as Rules, mapping_Validate as Validate, mapping_Value as Value, mapping_ValueConfig as ValueConfig, mapping_ValueType as ValueType, mapping_Values as Values };
+  export type { mapping_Condition as Condition, Config$4 as Config, mapping_Data as Data, Fn$1 as Fn, mapping_Loop as Loop, mapping_Map as Map, Options$1 as Options, mapping_Policy as Policy, Result$2 as Result, mapping_Rule as Rule, mapping_Rules as Rules, mapping_Validate as Validate, mapping_Value as Value, mapping_ValueConfig as ValueConfig, mapping_ValueType as ValueType, mapping_Values as Values };
 }
 
-type Config$2 = {
+type Config$3 = {
     config?: Array<GenericConfig>;
     consent?: Array<ConsentConfig>;
     custom?: Array<GenericConfig>;
@@ -1405,9 +1465,9 @@ type Config$2 = {
     session?: Array<SessionConfig>;
     user?: Array<UserConfig>;
 };
-type Types$2 = keyof Config$2 | (string & {});
+type Types$3 = keyof Config$3 | (string & {});
 interface EventContextMap {
-    config: Partial<Config$7>;
+    config: Partial<Config$8>;
     consent: Consent;
     custom: Properties;
     globals: Properties;
@@ -1418,7 +1478,7 @@ interface EventContextMap {
 }
 type EventContext<T extends keyof EventContextMap> = EventContextMap[T];
 type AnyEventContext = EventContextMap[keyof EventContextMap];
-interface Context$3 {
+interface Context$4 {
     consent?: Consent;
     session?: unknown;
 }
@@ -1426,17 +1486,17 @@ type Options = ConsentConfig | GenericConfig | ReadyConfig | RunConfig | Session
 interface ConsentConfig {
     [key: string]: ConsentFn;
 }
-type ConsentFn = (collector: Instance$4, consent: Consent) => void;
+type ConsentFn = (collector: Instance$5, consent: Consent) => void;
 type GenericConfig = GenericFn;
-type GenericFn = (collector: Instance$4, data: unknown) => void;
+type GenericFn = (collector: Instance$5, data: unknown) => void;
 type ReadyConfig = ReadyFn;
-type ReadyFn = (collector: Instance$4) => void;
+type ReadyFn = (collector: Instance$5) => void;
 type RunConfig = RunFn;
-type RunFn = (collector: Instance$4) => void;
+type RunFn = (collector: Instance$5) => void;
 type SessionConfig = SessionFn;
-type SessionFn = (collector: Instance$4, session?: unknown) => void;
+type SessionFn = (collector: Instance$5, session?: unknown) => void;
 type UserConfig = UserFn;
-type UserFn = (collector: Instance$4, user: User) => void;
+type UserFn = (collector: Instance$5, user: User) => void;
 interface OnConfig {
     config?: GenericConfig[];
     consent?: ConsentConfig[];
@@ -1448,8 +1508,8 @@ interface OnConfig {
     user?: UserConfig[];
     [key: string]: ConsentConfig[] | GenericConfig[] | ReadyConfig[] | RunConfig[] | SessionConfig[] | UserConfig[] | undefined;
 }
-type OnFn<T extends TypesGeneric$2 = Types$3> = (type: Types$2, context: Context$4<T>) => PromiseOrValue<void>;
-type OnFnRuntime = (type: Types$2, context: Context$4) => PromiseOrValue<void>;
+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 on_AnyEventContext = AnyEventContext;
 type on_ConsentConfig = ConsentConfig;
@@ -1459,7 +1519,7 @@ type on_EventContextMap = EventContextMap;
 type on_GenericConfig = GenericConfig;
 type on_GenericFn = GenericFn;
 type on_OnConfig = OnConfig;
-type on_OnFn<T extends TypesGeneric$2 = Types$3> = OnFn<T>;
+type on_OnFn<T extends TypesGeneric$3 = Types$4> = OnFn<T>;
 type on_OnFnRuntime = OnFnRuntime;
 type on_Options = Options;
 type on_ReadyConfig = ReadyConfig;
@@ -1471,7 +1531,7 @@ type on_SessionFn = SessionFn;
 type on_UserConfig = UserConfig;
 type on_UserFn = UserFn;
 declare namespace on {
-  export type { on_AnyEventContext as AnyEventContext, Config$2 as Config, on_ConsentConfig as ConsentConfig, on_ConsentFn as ConsentFn, Context$3 as Context, on_EventContext as EventContext, on_EventContextMap as EventContextMap, on_GenericConfig as GenericConfig, on_GenericFn as GenericFn, on_OnConfig as OnConfig, on_OnFn as OnFn, on_OnFnRuntime as OnFnRuntime, on_Options as Options, on_ReadyConfig as ReadyConfig, on_ReadyFn as ReadyFn, on_RunConfig as RunConfig, on_RunFn as RunFn, on_SessionConfig as SessionConfig, on_SessionFn as SessionFn, Types$2 as Types, on_UserConfig as UserConfig, on_UserFn as UserFn };
+  export type { on_AnyEventContext as AnyEventContext, Config$3 as Config, on_ConsentConfig as ConsentConfig, on_ConsentFn as ConsentFn, Context$4 as Context, on_EventContext as EventContext, on_EventContextMap as EventContextMap, on_GenericConfig as GenericConfig, on_GenericFn as GenericFn, on_OnConfig as OnConfig, on_OnFn as OnFn, on_OnFnRuntime as OnFnRuntime, on_Options as Options, on_ReadyConfig as ReadyConfig, on_ReadyFn as ReadyFn, on_RunConfig as RunConfig, on_RunFn as RunFn, on_SessionConfig as SessionConfig, on_SessionFn as SessionFn, Types$3 as Types, on_UserConfig as UserConfig, on_UserFn as UserFn };
 }
 
 type Next = string | string[];
@@ -1481,7 +1541,7 @@ type Next = string | string[];
  * Minimal like Destination - just an extensible object.
  * Transformers receive dependencies through context, not env.
  */
-interface BaseEnv$1 {
+interface BaseEnv$2 {
     [key: string]: unknown;
 }
 /**
@@ -1493,7 +1553,7 @@ interface BaseEnv$1 {
  * @template E - Environment type
  * @template I - InitSettings configuration type (user input)
  */
-interface Types$1<S = unknown, E = BaseEnv$1, I = S> {
+interface Types$2<S = unknown, E = BaseEnv$2, I = S> {
     settings: S;
     initSettings: I;
     env: E;
@@ -1501,7 +1561,7 @@ interface Types$1<S = unknown, E = BaseEnv$1, I = S> {
 /**
  * Generic constraint for Types - ensures T has required properties for indexed access.
  */
-type TypesGeneric$1 = {
+type TypesGeneric$2 = {
     settings: any;
     initSettings: any;
     env: any;
@@ -1509,21 +1569,21 @@ type TypesGeneric$1 = {
 /**
  * Type extractors for consistent usage with Types bundle.
  */
-type Settings$1<T extends TypesGeneric$1 = Types$1> = T['settings'];
-type InitSettings$1<T extends TypesGeneric$1 = Types$1> = T['initSettings'];
-type Env$1<T extends TypesGeneric$1 = Types$1> = T['env'];
+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$1<I> = I extends Instance$1<infer T> ? T : never;
+type TypesOf$2<I> = I extends Instance$2<infer T> ? T : never;
 /**
  * Transformer configuration.
  */
-interface Config$1<T extends TypesGeneric$1 = Types$1> {
-    settings?: InitSettings$1<T>;
-    env?: Env$1<T>;
+interface Config$2<T extends TypesGeneric$2 = Types$2> {
+    settings?: InitSettings$2<T>;
+    env?: Env$2<T>;
     id?: string;
-    logger?: Config$4;
+    logger?: Config$5;
     next?: Next;
     init?: boolean;
 }
@@ -1531,23 +1591,22 @@ interface Config$1<T extends TypesGeneric$1 = Types$1> {
  * Context provided to transformer functions.
  * Extends base context with transformer-specific properties.
  */
-interface Context$2<T extends TypesGeneric$1 = Types$1> extends Base<Config$1<T>, Env$1<T>> {
+interface Context$3<T extends TypesGeneric$2 = Types$2> extends Base<Config$2<T>, Env$2<T>> {
     id: string;
     ingest?: unknown;
 }
 /**
- * Branch result for dynamic chain routing.
- * Returned by transformers (e.g., router) to redirect the chain.
- * The chain runner resolves `next` via walkChain() — same semantics
- * as source.next or transformer.config.next.
+ * Unified result type for transformer functions.
+ * Replaces the old union return type with a structured object.
  *
- * IMPORTANT: Always use the `branch()` factory function to create BranchResult.
- * The `__branch` discriminant is required for reliable type detection.
+ * @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 BranchResult {
-    readonly __branch: true;
-    event: DeepPartialEvent;
-    next: Next;
+interface Result$1 {
+    event?: DeepPartialEvent;
+    respond?: RespondFn;
+    next?: Next;
 }
 /**
  * The main transformer function.
@@ -1555,11 +1614,11 @@ interface BranchResult {
  *
  * @param event - The event to process
  * @param context - Transformer context with collector, config, env, logger
- * @returns event - continue with modified event
+ * @returns Result - structured result with event, respond, next
  * @returns void - continue with current event unchanged (passthrough)
  * @returns false - stop chain, cancel further processing
  */
-type Fn<T extends TypesGeneric$1 = Types$1> = (event: DeepPartialEvent, context: Context$2<T>) => PromiseOrValue<DeepPartialEvent | false | void | BranchResult>;
+type Fn<T extends TypesGeneric$2 = Types$2> = (event: DeepPartialEvent, context: Context$3<T>) => PromiseOrValue<Result$1 | false | void>;
 /**
  * Optional initialization function.
  * Called once before first push.
@@ -1569,30 +1628,30 @@ type Fn<T extends TypesGeneric$1 = Types$1> = (event: DeepPartialEvent, context:
  * @returns false - initialization failed, skip this transformer
  * @returns Config<T> - return updated config
  */
-type InitFn<T extends TypesGeneric$1 = Types$1> = (context: Context$2<T>) => PromiseOrValue<void | false | Config$1<T>>;
+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$1<T extends TypesGeneric$1 = Types$1> {
+interface Instance$2<T extends TypesGeneric$2 = Types$2> {
     type: string;
-    config: Config$1<T>;
+    config: Config$2<T>;
     push: Fn<T>;
-    init?: InitFn<T>;
-    destroy?: DestroyFn<Config$1<T>, Env$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$1<T extends TypesGeneric$1 = Types$1> = (context: Context$2<Types$1<Partial<Settings$1<T>>, Env$1<T>, InitSettings$1<T>>>) => Instance$1<T> | Promise<Instance$1<T>>;
+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$2<T> | Promise<Instance$2<T>>;
 /**
  * Configuration for initializing a transformer.
  * Used in collector registration.
  */
-type InitTransformer<T extends TypesGeneric$1 = Types$1> = {
-    code: Init$1<T>;
-    config?: Partial<Config$1<T>>;
-    env?: Partial<Env$1<T>>;
+type InitTransformer<T extends TypesGeneric$2 = Types$2> = {
+    code: Init$2<T>;
+    config?: Partial<Config$2<T>>;
+    env?: Partial<Env$2<T>>;
     next?: Next;
 };
 /**
@@ -1606,21 +1665,19 @@ interface InitTransformers {
  * Active transformer instances registry.
  */
 interface Transformers {
-    [transformerId: string]: Instance$1;
+    [transformerId: string]: Instance$2;
 }
 
-type transformer_BranchResult = BranchResult;
-type transformer_Fn<T extends TypesGeneric$1 = Types$1> = Fn<T>;
-type transformer_InitFn<T extends TypesGeneric$1 = Types$1> = InitFn<T>;
-type transformer_InitTransformer<T extends TypesGeneric$1 = Types$1> = InitTransformer<T>;
+type transformer_Fn<T extends TypesGeneric$2 = Types$2> = Fn<T>;
+type transformer_InitTransformer<T extends TypesGeneric$2 = Types$2> = InitTransformer<T>;
 type transformer_InitTransformers = InitTransformers;
 type transformer_Next = Next;
 type transformer_Transformers = Transformers;
 declare namespace transformer {
-  export type { BaseEnv$1 as BaseEnv, transformer_BranchResult as BranchResult, Config$1 as Config, Context$2 as Context, Env$1 as Env, transformer_Fn as Fn, Init$1 as Init, transformer_InitFn as InitFn, InitSettings$1 as InitSettings, transformer_InitTransformer as InitTransformer, transformer_InitTransformers as InitTransformers, Instance$1 as Instance, transformer_Next as Next, Settings$1 as Settings, transformer_Transformers as Transformers, Types$1 as Types, TypesGeneric$1 as TypesGeneric, TypesOf$1 as TypesOf };
+  export type { BaseEnv$2 as BaseEnv, Config$2 as Config, Context$3 as Context, Env$2 as Env, transformer_Fn as Fn, Init$2 as Init, InitFn$1 as InitFn, InitSettings$2 as InitSettings, transformer_InitTransformer as InitTransformer, transformer_InitTransformers as InitTransformers, Instance$2 as Instance, transformer_Next as Next, Result$1 as Result, Settings$2 as Settings, transformer_Transformers as Transformers, Types$2 as Types, TypesGeneric$2 as TypesGeneric, TypesOf$2 as TypesOf };
 }
 
-interface Context$1 {
+interface Context$2 {
     city?: string;
     country?: string;
     encoding?: string;
@@ -1634,7 +1691,7 @@ interface Context$1 {
 }
 
 declare namespace request {
-  export type { Context$1 as Context };
+  export type { Context$2 as Context };
 }
 
 /**
@@ -1643,13 +1700,13 @@ declare namespace request {
  * Sources receive all their dependencies through this environment object,
  * making them platform-agnostic and easily testable.
  */
-interface BaseEnv {
+interface BaseEnv$1 {
     [key: string]: unknown;
     push: PushFn$1;
     command: CommandFn;
     sources?: Sources;
     elb: Fn$2;
-    logger: Instance$2;
+    logger: Instance$3;
 }
 /**
  * Type bundle for source generics.
@@ -1661,7 +1718,7 @@ interface BaseEnv {
  * @template E - Environment dependencies type
  * @template I - InitSettings configuration type (user input)
  */
-interface Types<S = unknown, M = unknown, P = Fn$2, E = BaseEnv, I = S> {
+interface Types$1<S = unknown, M = unknown, P = Fn$2, E = BaseEnv$1, I = S> {
     settings: S;
     initSettings: I;
     mapping: M;
@@ -1671,7 +1728,7 @@ interface Types<S = unknown, M = unknown, P = Fn$2, E = BaseEnv, I = S> {
 /**
  * Generic constraint for Types - ensures T has required properties for indexed access
  */
-type TypesGeneric = {
+type TypesGeneric$1 = {
     settings: any;
     initSettings: any;
     mapping: any;
@@ -1681,24 +1738,24 @@ type TypesGeneric = {
 /**
  * Type extractors for consistent usage with Types bundle
  */
-type Settings<T extends TypesGeneric = Types> = T['settings'];
-type InitSettings<T extends TypesGeneric = Types> = T['initSettings'];
-type Mapping<T extends TypesGeneric = Types> = T['mapping'];
-type Push<T extends TypesGeneric = Types> = T['push'];
-type Env<T extends TypesGeneric = Types> = T['env'];
+type Settings$1<T extends TypesGeneric$1 = Types$1> = T['settings'];
+type InitSettings$1<T extends TypesGeneric$1 = Types$1> = T['initSettings'];
+type Mapping<T extends TypesGeneric$1 = Types$1> = T['mapping'];
+type Push<T extends TypesGeneric$1 = Types$1> = T['push'];
+type Env$1<T extends TypesGeneric$1 = Types$1> = T['env'];
 /**
  * Inference helper: Extract Types from Instance
  */
-type TypesOf<I> = I extends Instance<infer T> ? T : never;
-interface Config<T extends TypesGeneric = Types> extends Config$3<Mapping<T>> {
+type TypesOf$1<I> = I extends Instance$1<infer T> ? T : never;
+interface Config$1<T extends TypesGeneric$1 = Types$1> extends Config$4<Mapping<T>> {
     /** Implementation-specific configuration passed to the init function. */
-    settings?: InitSettings<T>;
+    settings?: InitSettings$1<T>;
     /** Runtime dependencies injected by the collector (push, command, logger, etc.). */
-    env?: Env<T>;
+    env?: Env$1<T>;
     /** 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$5;
     /** 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']`). */
@@ -1717,19 +1774,19 @@ interface Config<T extends TypesGeneric = Types> extends Config$3<Mapping<T>> {
      */
     ingest?: Data;
 }
-type PartialConfig<T extends TypesGeneric = Types> = Config<Types<Partial<Settings<T>> | Settings<T>, Partial<Mapping<T>> | Mapping<T>, Push<T>, Env<T>>>;
-interface Instance<T extends TypesGeneric = Types> {
+type PartialConfig<T extends TypesGeneric$1 = Types$1> = Config$1<Types$1<Partial<Settings$1<T>> | Settings$1<T>, Partial<Mapping<T>> | Mapping<T>, Push<T>, Env$1<T>>>;
+interface Instance$1<T extends TypesGeneric$1 = Types$1> {
     type: string;
-    config: Config<T>;
+    config: Config$1<T>;
     push: Push<T>;
-    destroy?: DestroyFn<Config<T>, Env<T>>;
-    on?(event: Types$2, context?: unknown): void | boolean | Promise<void | boolean>;
+    destroy?: DestroyFn<Config$1<T>, Env$1<T>>;
+    on?(event: Types$3, context?: unknown): void | boolean | Promise<void | boolean>;
 }
 /**
  * Context provided to source init function.
  * Extends base context with source-specific properties.
  */
-interface Context<T extends TypesGeneric = Types> extends Base<Partial<Config<T>>, Env<T>> {
+interface Context$1<T extends TypesGeneric$1 = Types$1> extends Base<Partial<Config$1<T>>, Env$1<T>> {
     id: string;
     /**
      * Sets ingest metadata for the current request.
@@ -1742,11 +1799,11 @@ interface Context<T extends TypesGeneric = Types> extends Base<Partial<Config<T>
     /** Sets respond function for the current request. Called by source per-request. */
     setRespond: (fn: RespondFn | undefined) => void;
 }
-type Init<T extends TypesGeneric = Types> = (context: Context<T>) => Instance<T> | Promise<Instance<T>>;
-type InitSource<T extends TypesGeneric = Types> = {
-    code: Init<T>;
-    config?: Partial<Config<T>>;
-    env?: Partial<Env<T>>;
+type Init$1<T extends TypesGeneric$1 = Types$1> = (context: Context$1<T>) => Instance$1<T> | Promise<Instance$1<T>>;
+type InitSource<T extends TypesGeneric$1 = Types$1> = {
+    code: Init$1<T>;
+    config?: Partial<Config$1<T>>;
+    env?: Partial<Env$1<T>>;
     primary?: boolean;
     next?: Next;
 };
@@ -1784,27 +1841,89 @@ interface SimulationEnv {
  */
 type SetupFn = (input: unknown, env: SimulationEnv) => void | (() => void);
 
-type source_BaseEnv = BaseEnv;
-type source_Config<T extends TypesGeneric = Types> = Config<T>;
-type source_Context<T extends TypesGeneric = Types> = Context<T>;
-type source_Env<T extends TypesGeneric = Types> = Env<T>;
-type source_Init<T extends TypesGeneric = Types> = Init<T>;
-type source_InitSettings<T extends TypesGeneric = Types> = InitSettings<T>;
-type source_InitSource<T extends TypesGeneric = Types> = InitSource<T>;
+type source_InitSource<T extends TypesGeneric$1 = Types$1> = InitSource<T>;
 type source_InitSources = InitSources;
-type source_Instance<T extends TypesGeneric = Types> = Instance<T>;
-type source_Mapping<T extends TypesGeneric = Types> = Mapping<T>;
-type source_PartialConfig<T extends TypesGeneric = Types> = PartialConfig<T>;
-type source_Push<T extends TypesGeneric = Types> = Push<T>;
+type source_Mapping<T extends TypesGeneric$1 = Types$1> = Mapping<T>;
+type source_PartialConfig<T extends TypesGeneric$1 = Types$1> = PartialConfig<T>;
+type source_Push<T extends TypesGeneric$1 = Types$1> = Push<T>;
 type source_Renderer = Renderer;
-type source_Settings<T extends TypesGeneric = Types> = Settings<T>;
 type source_SetupFn = SetupFn;
 type source_SimulationEnv = SimulationEnv;
-type source_Types<S = unknown, M = unknown, P = Fn$2, E = BaseEnv, I = S> = Types<S, M, P, E, I>;
-type source_TypesGeneric = TypesGeneric;
-type source_TypesOf<I> = TypesOf<I>;
 declare namespace source {
-  export type { source_BaseEnv as BaseEnv, source_Config as Config, source_Context as Context, source_Env as Env, source_Init as Init, source_InitSettings as InitSettings, source_InitSource as InitSource, source_InitSources as InitSources, source_Instance as Instance, source_Mapping as Mapping, source_PartialConfig as PartialConfig, source_Push as Push, source_Renderer as Renderer, source_Settings as Settings, source_SetupFn as SetupFn, source_SimulationEnv as SimulationEnv, source_Types as Types, source_TypesGeneric as TypesGeneric, source_TypesOf as TypesOf };
+  export type { BaseEnv$1 as BaseEnv, Config$1 as Config, Context$1 as Context, Env$1 as Env, Init$1 as Init, InitSettings$1 as InitSettings, source_InitSource as InitSource, source_InitSources as InitSources, Instance$1 as Instance, source_Mapping as Mapping, source_PartialConfig as PartialConfig, source_Push as Push, source_Renderer as Renderer, Settings$1 as Settings, source_SetupFn as SetupFn, source_SimulationEnv as SimulationEnv, Types$1 as Types, TypesGeneric$1 as TypesGeneric, TypesOf$1 as TypesOf };
+}
+
+interface BaseEnv {
+    [key: string]: unknown;
+}
+interface Types<S = unknown, E = BaseEnv, I = S> {
+    settings: S;
+    initSettings: I;
+    env: E;
+}
+type TypesGeneric = {
+    settings: any;
+    initSettings: any;
+    env: any;
+};
+type Settings<T extends TypesGeneric = Types> = T['settings'];
+type InitSettings<T extends TypesGeneric = Types> = T['initSettings'];
+type Env<T extends TypesGeneric = Types> = T['env'];
+type TypesOf<I> = I extends Instance<infer T> ? T : never;
+interface Config<T extends TypesGeneric = Types> {
+    settings?: InitSettings<T>;
+    env?: Env<T>;
+    id?: string;
+    logger?: Config$5;
+}
+interface Context<T extends TypesGeneric = Types> extends Base<Config<T>, Env<T>> {
+    id: string;
+}
+type GetFn<T = unknown> = (key: string) => T | undefined | Promise<T | undefined>;
+type SetFn<T = unknown> = (key: string, value: T, ttl?: number) => void | Promise<void>;
+type DeleteFn = (key: string) => void | Promise<void>;
+interface Instance<T extends TypesGeneric = Types> {
+    type: string;
+    config: Config<T>;
+    get: GetFn;
+    set: SetFn;
+    delete: DeleteFn;
+    destroy?: DestroyFn<Config<T>, Env<T>>;
+}
+type Init<T extends TypesGeneric = Types> = (context: Context<Types<Partial<Settings<T>>, Env<T>, InitSettings<T>>>) => Instance<T> | Promise<Instance<T>>;
+type InitFn<T extends TypesGeneric = Types> = (context: Context<T>) => PromiseOrValue<void | false | Config<T>>;
+type InitStore<T extends TypesGeneric = Types> = {
+    code: Init<T>;
+    config?: Partial<Config<T>>;
+    env?: Partial<Env<T>>;
+};
+interface InitStores {
+    [storeId: string]: InitStore<any>;
+}
+interface Stores {
+    [storeId: string]: Instance;
+}
+
+type store_BaseEnv = BaseEnv;
+type store_Config<T extends TypesGeneric = Types> = Config<T>;
+type store_Context<T extends TypesGeneric = Types> = Context<T>;
+type store_DeleteFn = DeleteFn;
+type store_Env<T extends TypesGeneric = Types> = Env<T>;
+type store_GetFn<T = unknown> = GetFn<T>;
+type store_Init<T extends TypesGeneric = Types> = Init<T>;
+type store_InitFn<T extends TypesGeneric = Types> = InitFn<T>;
+type store_InitSettings<T extends TypesGeneric = Types> = InitSettings<T>;
+type store_InitStore<T extends TypesGeneric = Types> = InitStore<T>;
+type store_InitStores = InitStores;
+type store_Instance<T extends TypesGeneric = Types> = Instance<T>;
+type store_SetFn<T = unknown> = SetFn<T>;
+type store_Settings<T extends TypesGeneric = Types> = Settings<T>;
+type store_Stores = Stores;
+type store_Types<S = unknown, E = BaseEnv, I = S> = Types<S, E, I>;
+type store_TypesGeneric = TypesGeneric;
+type store_TypesOf<I> = TypesOf<I>;
+declare namespace store {
+  export type { store_BaseEnv as BaseEnv, store_Config as Config, store_Context as Context, store_DeleteFn as DeleteFn, store_Env as Env, store_GetFn as GetFn, store_Init as Init, store_InitFn as InitFn, store_InitSettings as InitSettings, store_InitStore as InitStore, store_InitStores as InitStores, store_Instance as Instance, store_SetFn as SetFn, store_Settings as Settings, store_Stores as Stores, store_Types as Types, store_TypesGeneric as TypesGeneric, store_TypesOf as TypesOf };
 }
 
 type AnyObject<T = unknown> = Record<string, T>;
@@ -1964,6 +2083,28 @@ declare namespace simulation {
   export type { simulation_Call as Call, simulation_Result as Result };
 }
 
+type MatchExpression = MatchCondition | {
+    and: MatchExpression[];
+} | {
+    or: MatchExpression[];
+};
+interface MatchCondition {
+    key: string;
+    operator: MatchOperator;
+    value: string;
+    not?: boolean;
+}
+type MatchOperator = 'eq' | 'contains' | 'prefix' | 'suffix' | 'regex' | 'gt' | 'lt' | 'exists';
+type CompiledMatcher = (ingest: Record<string, unknown>) => boolean;
+
+type matcher_CompiledMatcher = CompiledMatcher;
+type matcher_MatchCondition = MatchCondition;
+type matcher_MatchExpression = MatchExpression;
+type matcher_MatchOperator = MatchOperator;
+declare namespace matcher {
+  export type { matcher_CompiledMatcher as CompiledMatcher, matcher_MatchCondition as MatchCondition, matcher_MatchExpression as MatchExpression, matcher_MatchOperator as MatchOperator };
+}
+
 type StorageType = 'local' | 'session' | 'cookie';
 declare const Const: {
     readonly Utils: {
@@ -1986,10 +2127,10 @@ interface SendResponse {
 }
 
 /**
- * Creates a BranchResult for dynamic chain routing.
+ * Creates a TransformerResult for dynamic chain routing.
  * Use this in transformer push functions to redirect the chain.
  */
-declare function branch(event: DeepPartialEvent, next: Next): BranchResult;
+declare function branch(event: DeepPartialEvent, next: Next): Result$1;
 
 /**
  * Anonymizes an IPv4 address by setting the last octet to 0.
@@ -2041,7 +2182,7 @@ declare function packageNameToVariable(packageName: string): string;
  * const prodConfig = getFlowConfig(setup, 'production');
  * ```
  */
-declare function getFlowConfig(setup: Setup, flowName?: string, options?: ResolveOptions): Config$5;
+declare function getFlowConfig(setup: Setup, flowName?: string, options?: ResolveOptions): Config$6;
 /**
  * Get platform from config (web or server).
  *
@@ -2057,7 +2198,7 @@ declare function getFlowConfig(setup: Setup, flowName?: string, options?: Resolv
  * // Returns "web" or "server"
  * ```
  */
-declare function getPlatform(config: Config$5): 'web' | 'server';
+declare function getPlatform(config: Config$6): 'web' | 'server';
 
 /**
  * @interface Assign
@@ -2153,7 +2294,7 @@ declare function getGrantedConsent(required: Consent | undefined, state?: Consen
  * }));
  * ```
  */
-declare function createDestination<I extends Instance$3>(baseDestination: I, config: Partial<Config$6<TypesOf$2<I>>>): I;
+declare function createDestination<I extends Instance$4>(baseDestination: I, config: Partial<Config$7<TypesOf$3<I>>>): I;
 
 /**
  * Creates a complete event with default values.
@@ -2315,7 +2456,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$2;
+declare function createLogger(config?: Config$5): Instance$3;
 
 /**
  * Gets the mapping for an event.
@@ -2324,7 +2465,7 @@ declare function createLogger(config?: Config$4): Instance$2;
  * @param mapping The mapping rules.
  * @returns The mapping result.
  */
-declare function getMappingEvent(event: DeepPartialEvent | PartialEvent | Event, mapping?: Rules): Promise<Result$1>;
+declare function getMappingEvent(event: DeepPartialEvent | PartialEvent | Event, mapping?: Rules): Promise<Result$2>;
 /**
  * Gets a value from a mapping.
  *
@@ -2353,7 +2494,7 @@ declare function getMappingValue(value: DeepPartialEvent | unknown | undefined,
  * @param collector - Collector instance for context
  * @returns Object with transformed event, data, mapping rule, and ignore flag
  */
-declare function processEventMapping<T extends DeepPartialEvent | Event>(event: T, config: Config$3, collector: Instance$4): Promise<{
+declare function processEventMapping<T extends DeepPartialEvent | Event>(event: T, config: Config$4, collector: Instance$5): Promise<{
     event: T;
     data?: Property;
     mapping?: Rule;
@@ -2432,7 +2573,7 @@ declare function traverseEnv<T extends object>(env: T, replacer: (value: unknown
  * Includes all logger methods as jest.fn() plus tracking of scoped loggers
  * Extends Instance to ensure type compatibility
  */
-interface MockLogger extends Instance$2 {
+interface MockLogger extends Instance$3 {
     error: jest.Mock;
     warn: jest.Mock;
     info: jest.Mock;
@@ -2736,7 +2877,7 @@ declare function mergeContractSchemas(parent: Record<string, unknown>, child: Re
  */
 declare function resolveContract(setup: Contract, entity: string, action: string, config?: Contract): Record<string, unknown>;
 
-declare function mcpResult(result: unknown): {
+declare function mcpResult(result: unknown, summary?: string): {
     content: {
         type: "text";
         text: string;
@@ -2751,4 +2892,11 @@ declare function mcpError(error: unknown): {
     isError: true;
 };
 
-export { collector as Collector, Const, context as Context, data as Data, destination as Destination, ENV_MARKER_PREFIX, elb as Elb, flow as Flow, hooks as Hooks, Level, lifecycle as Lifecycle, logger as Logger, mapping as Mapping, type MarketingParameters, type MockLogger, on as On, request as Request, type ResolveOptions, type RespondFn, type RespondOptions, type SendDataValue, type SendHeaders, type SendResponse, simulation as Simulation, source as Source, type StorageType, transformer as Transformer, walkeros as WalkerOS, type WalkerOSPackageInfo, type WalkerOSPackageMeta, anonymizeIP, assign, branch, castToProperty, castValue, clone, createDestination, createEvent, createLogger, createMockLogger, createRespond, debounce, fetchPackageMeta, fetchPackageSchema, filterValues, getBrowser, getBrowserVersion, getByPath, getDeviceType, getEvent, getFlowConfig, getGrantedConsent, getHeaders, getId, getMappingEvent, getMappingValue, getMarketingParameters, getOS, getOSVersion, getPlatform, isArguments, isArray, isBoolean, isCommand, isDefined, isElementOrDocument, isFunction, isNumber, isObject, isPropertyType, isSameType, isString, mcpError, mcpResult, mergeContractSchemas, mockEnv, packageNameToVariable, parseUserAgent, processEventMapping, requestToData, requestToParameter, resolveContract, setByPath, throttle, throwError, transformData, traverseEnv, trim, tryCatch, tryCatchAsync, useHooks, wrapCondition, wrapFn, wrapValidate };
+/**
+ * Compiles a match expression into a closure for fast runtime evaluation.
+ * Regex patterns are compiled once. Numeric comparisons are parsed once.
+ * Runtime evaluation is pure function calls with short-circuit logic.
+ */
+declare function compileMatcher(expr: MatchExpression | '*'): CompiledMatcher;
+
+export { collector as Collector, Const, context as Context, data as Data, destination as Destination, ENV_MARKER_PREFIX, elb as Elb, flow as Flow, hooks as Hooks, Level, lifecycle as Lifecycle, logger as Logger, mapping as Mapping, type MarketingParameters, matcher as Matcher, type MockLogger, on as On, request as Request, type ResolveOptions, type RespondFn, type RespondOptions, type SendDataValue, type SendHeaders, type SendResponse, simulation as Simulation, source as Source, type StorageType, store as Store, transformer as Transformer, walkeros as WalkerOS, type WalkerOSPackageInfo, type WalkerOSPackageMeta, anonymizeIP, assign, branch, castToProperty, castValue, clone, compileMatcher, createDestination, createEvent, createLogger, createMockLogger, createRespond, debounce, fetchPackageMeta, fetchPackageSchema, filterValues, getBrowser, getBrowserVersion, getByPath, getDeviceType, getEvent, getFlowConfig, getGrantedConsent, getHeaders, getId, getMappingEvent, getMappingValue, getMarketingParameters, getOS, getOSVersion, getPlatform, isArguments, isArray, isBoolean, isCommand, isDefined, isElementOrDocument, isFunction, isNumber, isObject, isPropertyType, isSameType, isString, mcpError, mcpResult, mergeContractSchemas, mockEnv, packageNameToVariable, parseUserAgent, processEventMapping, requestToData, requestToParameter, resolveContract, setByPath, throttle, throwError, transformData, traverseEnv, trim, tryCatch, tryCatchAsync, useHooks, wrapCondition, wrapFn, wrapValidate };