@walkeros/explorer 1.0.1 → 2.0.1

package/LICENSE

@@ -1,6 +1,6 @@
 # walkerOS Explorer License Agreement
 
-Copyright (c) 2025 elbwalker GmbH.  
+Copyright (c) 2026 elbwalker GmbH.  
 All rights reserved.
 
 The walkerOS Explorer software package and associated files (the “Software”) are
@@ -39,4 +39,4 @@ FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
 ## Contact
 
 To obtain a commercial license, please contact:
-[hello@walkeros.com](mailto:hello@walkeros.com)
+[hello@elbwalker.com](mailto:hello@elbwalker.com)

package/dist/{chunk-VWWAIDNX.mjs → chunk-YKT4D7MG.mjs}

@@ -440,6 +440,25 @@ interface SessionData extends Properties {
     count?: number;
     runs?: number;
 }
+interface Status {
+    startedAt: number;
+    in: number;
+    out: number;
+    failed: number;
+    sources: Record<string, SourceStatus>;
+    destinations: Record<string, DestinationStatus>;
+}
+interface SourceStatus {
+    count: number;
+    lastAt?: number;
+    duration: number;
+}
+interface DestinationStatus {
+    count: number;
+    failed: number;
+    lastAt?: number;
+    duration: number;
+}
 interface Sources {
     [id: string]: Instance;
 }
@@ -449,15 +468,6 @@ interface Destinations$1 {
 interface Transformers$1 {
     [id: string]: Instance$1;
 }
-/**
- * Resolved transformer chains for a flow.
- */
-interface TransformerChain {
-    /** Ordered transformer IDs to run before collector (from source.next) */
-    pre: string[];
-    /** Per-destination transformer chains (from destination.before) */
-    post: Record<string, string[]>;
-}
 type CommandType = 'action' | 'config' | 'consent' | 'context' | 'destination' | 'elb' | 'globals' | 'hook' | 'init' | 'link' | 'run' | 'user' | 'walker' | string;
 /**
  * Options passed to collector.push() from sources.
@@ -504,7 +514,6 @@ interface Instance$4 {
     sources: Sources;
     destinations: Destinations$1;
     transformers: Transformers$1;
-    transformerChain: TransformerChain;
     globals: Properties;
     group: string;
     hooks: Functions;
@@ -513,20 +522,27 @@ interface Instance$4 {
     queue: Events;
     round: number;
     session: undefined | SessionData;
+    status: Status;
     timing: number;
     user: User;
     version: string;
+    pending: {
+        sources: InitSources;
+        destinations: InitDestinations;
+    };
 }
 
 type collector_CommandFn = CommandFn;
 type collector_CommandType = CommandType;
+type collector_DestinationStatus = DestinationStatus;
 type collector_InitConfig = InitConfig;
 type collector_PushOptions = PushOptions;
 type collector_SessionData = SessionData;
+type collector_SourceStatus = SourceStatus;
 type collector_Sources = Sources;
-type collector_TransformerChain = TransformerChain;
+type collector_Status = Status;
 declare namespace collector {
-  export type { collector_CommandFn as CommandFn, collector_CommandType as CommandType, Config$7 as Config, 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_Sources as Sources, collector_TransformerChain as TransformerChain, Transformers$1 as Transformers };
+  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 };
 }
 
 /**
@@ -643,7 +659,11 @@ type Env$2<T extends TypesGeneric$2 = Types$3> = T['env'];
 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>;
-    queue?: Events;
+    queuePush?: Events;
+    queueOn?: Array<{
+        type: Types$2;
+        data?: unknown;
+    }>;
     dlq?: DLQ;
     batches?: BatchRegistry<Mapping$1<T>>;
     type?: string;
@@ -654,27 +674,43 @@ interface Instance$3<T extends TypesGeneric$2 = Types$3> {
     on?: OnFn;
 }
 interface Config$6<T extends TypesGeneric$2 = Types$3> {
+    /** 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>;
+    /** 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>;
+    /** Destination identifier; auto-generated if not provided. */
     id?: string;
+    /** Whether the destination has been initialized; prevents re-initialization. */
     init?: boolean;
+    /** 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;
+    /** 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. */
     policy?: Policy$1;
+    /** Whether to queue events when consent is not granted; defaults to true. */
     queue?: boolean;
+    /** Defer destination initialization until these collector events fire (e.g., \`['consent']\`). */
+    require?: string[];
+    /** 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>>>;
 interface Policy$1 {
     [key: string]: Value;
 }
-type Code<T extends TypesGeneric$2 = Types$3> = Instance$3<T> | true;
+type Code<T extends TypesGeneric$2 = Types$3> = Instance$3<T>;
 type Init$2<T extends TypesGeneric$2 = Types$3> = {
     code: Code<T>;
     config?: Partial<Config$6<T>>;
     env?: Partial<Env$2<T>>;
+    before?: string | string[];
 };
 interface InitDestinations {
     [key: string]: Init$2<any>;
@@ -725,7 +761,7 @@ interface Ref {
     error?: unknown;
 }
 type Push$1 = {
-    queue?: Events;
+    queuePush?: Events;
     error?: unknown;
 };
 type DLQ = Array<[Event, unknown]>;
@@ -816,6 +852,15 @@ type Variables = Record<string, Primitive>;
  * Used at Setup, Config, Source, and Destination levels.
  */
 type Definitions = Record<string, unknown>;
+/**
+ * Inline code definition for sources/destinations/transformers.
+ * Used instead of package when defining inline functions.
+ */
+interface InlineCode {
+    push: string;
+    type?: string;
+    init?: string;
+}
 /**
  * Packages configuration for build.
  */
@@ -903,13 +948,13 @@ interface Setup {
     include?: string[];
     /**
      * Shared variables for interpolation.
-     * Resolution: process.env > Config.variables > Setup.variables > inline default
-     * Syntax: \${VAR_NAME} or \${VAR_NAME:default}
+     * Resolution: destination/source > Config > Setup level
+     * Syntax: $var.name
      */
     variables?: Variables;
     /**
      * Reusable configuration definitions.
-     * Referenced via JSON Schema $ref syntax: { "$ref": "#/definitions/name" }
+     * Syntax: $def.name
      */
     definitions?: Definitions;
     /**
@@ -1083,6 +1128,7 @@ interface Config$5 {
  * @remarks
  * References a source package and provides configuration.
  * The package is automatically downloaded and imported during build.
+ * Alternatively, use \`code: true\` for inline code execution.
  */
 interface SourceReference {
     /**
@@ -1100,18 +1146,30 @@ interface SourceReference {
      * 3. Auto-detect default or named export
      * 4. Generate import statement
      *
+     * Optional when \`code: true\` is used for inline code execution.
+     *
      * @example
      * "package": "@walkeros/web-source-browser@latest"
      */
-    package: string;
+    package?: string;
     /**
-     * Resolved import variable name.
+     * Resolved import variable name or built-in code source.
      *
      * @remarks
-     * Auto-resolved from packages[package].imports[0] during getFlowConfig().
-     * Can also be provided explicitly for advanced use cases.
+     * - String: Auto-resolved from packages[package].imports[0] during getFlowConfig(),
+     *   or provided explicitly for advanced use cases.
+     * - InlineCode: Object with type, push, and optional init for inline code definition.
+     *
+     * @example
+     * // Using inline code object
+     * {
+     *   "code": {
+     *     "type": "logger",
+     *     "push": "$code:(event) => console.log(event)"
+     *   }
+     * }
      */
-    code?: string;
+    code?: string | InlineCode;
     /**
      * Source-specific configuration.
      *
@@ -1168,8 +1226,9 @@ interface SourceReference {
      * @remarks
      * Name of the transformer to execute after this source captures an event.
      * If omitted, events route directly to the collector.
+     * Can be an array for explicit chain control (bypasses transformer.next resolution).
      */
-    next?: string;
+    next?: string | string[];
 }
 /**
  * Transformer reference with inline package syntax.
@@ -1177,6 +1236,7 @@ interface SourceReference {
  * @remarks
  * References a transformer package and provides configuration.
  * Transformers transform events in the pipeline between sources and destinations.
+ * Alternatively, use \`code: true\` for inline code execution.
  */
 interface TransformerReference {
     /**
@@ -1184,19 +1244,30 @@ interface TransformerReference {
      *
      * @remarks
      * Same format as SourceReference.package
+     * Optional when \`code: true\` is used for inline code execution.
      *
      * @example
      * "package": "@walkeros/transformer-enricher@1.0.0"
      */
-    package: string;
+    package?: string;
     /**
-     * Resolved import variable name.
+     * Resolved import variable name or built-in code transformer.
      *
      * @remarks
-     * Auto-resolved from packages[package].imports[0] during getFlowConfig().
-     * Can also be provided explicitly for advanced use cases.
+     * - String: Auto-resolved from packages[package].imports[0] during getFlowConfig(),
+     *   or provided explicitly for advanced use cases.
+     * - InlineCode: Object with type, push, and optional init for inline code definition.
+     *
+     * @example
+     * // Using inline code object
+     * {
+     *   "code": {
+     *     "type": "enricher",
+     *     "push": "$code:(event) => ({ ...event, data: { enriched: true } })"
+     *   }
+     * }
      */
-    code?: string;
+    code?: string | InlineCode;
     /**
      * Transformer-specific configuration.
      *
@@ -1221,8 +1292,9 @@ interface TransformerReference {
      * If omitted:
      * - Pre-collector: routes to collector
      * - Post-collector: routes to destination
+     * Can be an array for explicit chain control (terminates chain walking).
      */
-    next?: string;
+    next?: string | string[];
     /**
      * Transformer-level variables (highest priority in cascade).
      * Overrides flow and setup variables.
@@ -1247,19 +1319,30 @@ interface DestinationReference {
      *
      * @remarks
      * Same format as SourceReference.package
+     * Optional when \`code: true\` is used for inline code execution.
      *
      * @example
      * "package": "@walkeros/web-destination-gtag@2.0.0"
      */
-    package: string;
+    package?: string;
     /**
-     * Resolved import variable name.
+     * Resolved import variable name or built-in code destination.
      *
      * @remarks
-     * Auto-resolved from packages[package].imports[0] during getFlowConfig().
-     * Can also be provided explicitly for advanced use cases.
+     * - String: Auto-resolved from packages[package].imports[0] during getFlowConfig(),
+     *   or provided explicitly for advanced use cases.
+     * - InlineCode: Object with type, push, and optional init for inline code definition.
+     *
+     * @example
+     * // Using inline code object
+     * {
+     *   "code": {
+     *     "type": "logger",
+     *     "push": "$code:(event) => console.log('Event:', event.name)"
+     *   }
+     * }
      */
-    code?: string;
+    code?: string | InlineCode;
     /**
      * Destination-specific configuration.
      *
@@ -1317,12 +1400,14 @@ interface DestinationReference {
      * @remarks
      * Name of the transformer to execute before sending events to this destination.
      * If omitted, events are sent directly from the collector.
+     * Can be an array for explicit chain control (bypasses transformer.next resolution).
      */
-    before?: string;
+    before?: string | string[];
 }
 
 type flow_Definitions = Definitions;
 type flow_DestinationReference = DestinationReference;
+type flow_InlineCode = InlineCode;
 type flow_Packages = Packages;
 type flow_Primitive = Primitive;
 type flow_Server = Server;
@@ -1332,7 +1417,7 @@ type flow_TransformerReference = TransformerReference;
 type flow_Variables = Variables;
 type flow_Web = Web;
 declare namespace flow {
-  export type { Config$5 as Config, flow_Definitions as Definitions, flow_DestinationReference as DestinationReference, flow_Packages as Packages, flow_Primitive as Primitive, flow_Server as Server, flow_Setup as Setup, flow_SourceReference as SourceReference, flow_TransformerReference as TransformerReference, flow_Variables as Variables, flow_Web as Web };
+  export type { Config$5 as Config, 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_TransformerReference as TransformerReference, flow_Variables as Variables, flow_Web as Web };
 }
 
 type AnyFunction$1<P extends unknown[] = never[], R = unknown> = (...args: P) => R;
@@ -1544,41 +1629,57 @@ declare namespace mapping {
 }
 
 type Config$2 = {
+    config?: Array<GenericConfig>;
     consent?: Array<ConsentConfig>;
+    custom?: Array<GenericConfig>;
+    globals?: Array<GenericConfig>;
     ready?: Array<ReadyConfig>;
     run?: Array<RunConfig>;
     session?: Array<SessionConfig>;
+    user?: Array<UserConfig>;
 };
-type Types$2 = keyof Config$2;
+type Types$2 = keyof Config$2 | (string & {});
 interface EventContextMap {
+    config: Partial<Config$7>;
     consent: Consent;
-    session: SessionData;
+    custom: Properties;
+    globals: Properties;
     ready: undefined;
     run: undefined;
+    session: SessionData;
+    user: User;
 }
-type EventContext<T extends Types$2> = EventContextMap[T];
+type EventContext<T extends keyof EventContextMap> = EventContextMap[T];
 type AnyEventContext = EventContextMap[keyof EventContextMap];
 interface Context$3 {
     consent?: Consent;
     session?: unknown;
 }
-type Options = ConsentConfig | ReadyConfig | RunConfig | SessionConfig;
+type Options = ConsentConfig | GenericConfig | ReadyConfig | RunConfig | SessionConfig | UserConfig;
 interface ConsentConfig {
     [key: string]: ConsentFn;
 }
 type ConsentFn = (collector: Instance$4, consent: Consent) => void;
+type GenericConfig = GenericFn;
+type GenericFn = (collector: Instance$4, data: unknown) => void;
 type ReadyConfig = ReadyFn;
 type ReadyFn = (collector: Instance$4) => void;
 type RunConfig = RunFn;
 type RunFn = (collector: Instance$4) => void;
 type SessionConfig = SessionFn;
 type SessionFn = (collector: Instance$4, session?: unknown) => void;
+type UserConfig = UserFn;
+type UserFn = (collector: Instance$4, user: User) => void;
 interface OnConfig {
+    config?: GenericConfig[];
     consent?: ConsentConfig[];
+    custom?: GenericConfig[];
+    globals?: GenericConfig[];
     ready?: ReadyConfig[];
     run?: RunConfig[];
     session?: SessionConfig[];
-    [key: string]: ConsentConfig[] | ReadyConfig[] | RunConfig[] | SessionConfig[] | undefined;
+    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>;
@@ -1586,8 +1687,10 @@ type OnFnRuntime = (type: Types$2, context: Context$4) => PromiseOrValue<void>;
 type on_AnyEventContext = AnyEventContext;
 type on_ConsentConfig = ConsentConfig;
 type on_ConsentFn = ConsentFn;
-type on_EventContext<T extends Types$2> = EventContext<T>;
+type on_EventContext<T extends keyof EventContextMap> = EventContext<T>;
 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_OnFnRuntime = OnFnRuntime;
@@ -1598,10 +1701,13 @@ type on_RunConfig = RunConfig;
 type on_RunFn = RunFn;
 type on_SessionConfig = SessionConfig;
 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_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 };
+  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 };
 }
 
+type Next = string | string[];
 /**
  * Base environment interface for walkerOS transformers.
  *
@@ -1651,7 +1757,7 @@ interface Config$1<T extends TypesGeneric$1 = Types$1> {
     env?: Env$1<T>;
     id?: string;
     logger?: Config$4;
-    next?: string;
+    next?: Next;
     init?: boolean;
 }
 /**
@@ -1662,6 +1768,20 @@ interface Context$2<T extends TypesGeneric$1 = Types$1> extends Base<Config$1<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() \u2014 same semantics
+ * as source.next or transformer.config.next.
+ *
+ * IMPORTANT: Always use the \`branch()\` factory function to create BranchResult.
+ * The \`__branch\` discriminant is required for reliable type detection.
+ */
+interface BranchResult {
+    readonly __branch: true;
+    event: DeepPartialEvent;
+    next: Next;
+}
 /**
  * The main transformer function.
  * Uses DeepPartialEvent for consistency across pre/post collector.
@@ -1672,7 +1792,7 @@ interface Context$2<T extends TypesGeneric$1 = Types$1> extends Base<Config$1<T>
  * @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>;
+type Fn<T extends TypesGeneric$1 = Types$1> = (event: DeepPartialEvent, context: Context$2<T>) => PromiseOrValue<DeepPartialEvent | false | void | BranchResult>;
 /**
  * Optional initialization function.
  * Called once before first push.
@@ -1706,6 +1826,7 @@ type InitTransformer<T extends TypesGeneric$1 = Types$1> = {
     code: Init$1<T>;
     config?: Partial<Config$1<T>>;
     env?: Partial<Env$1<T>>;
+    next?: Next;
 };
 /**
  * Transformers configuration for collector.
@@ -1721,13 +1842,15 @@ interface Transformers {
     [transformerId: string]: Instance$1;
 }
 
+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_InitTransformers = InitTransformers;
+type transformer_Next = Next;
 type transformer_Transformers = Transformers;
 declare namespace transformer {
-  export type { BaseEnv$1 as BaseEnv, 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, Settings$1 as Settings, transformer_Transformers as Transformers, Types$1 as Types, TypesGeneric$1 as TypesGeneric, TypesOf$1 as TypesOf };
+  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 };
 }
 
 interface Context$1 {
@@ -1829,12 +1952,18 @@ type Env<T extends TypesGeneric = Types> = T['env'];
  */
 type TypesOf<I> = I extends Instance<infer T> ? T : never;
 interface Config<T extends TypesGeneric = Types> extends Config$3<Mapping<T>> {
+    /** Implementation-specific configuration passed to the init function. */
     settings?: InitSettings<T>;
+    /** Runtime dependencies injected by the collector (push, command, logger, etc.). */
     env?: Env<T>;
+    /** Source identifier; defaults to the InitSources object key. */
     id?: string;
+    /** Logger configuration (level, handler) to override the collector's defaults. */
     logger?: Config$4;
-    disabled?: boolean;
+    /** 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[];
     /**
      * Ingest metadata extraction mapping.
      * Extracts values from raw request objects (Express req, Lambda event, etc.)
@@ -1855,7 +1984,7 @@ interface Instance<T extends TypesGeneric = Types> {
     config: Config<T>;
     push: Push<T>;
     destroy?(): void | Promise<void>;
-    on?(event: Types$2, context?: unknown): void | Promise<void>;
+    on?(event: Types$2, context?: unknown): void | boolean | Promise<void | boolean>;
 }
 /**
  * Context provided to source init function.
@@ -1878,7 +2007,7 @@ type InitSource<T extends TypesGeneric = Types> = {
     config?: Partial<Config<T>>;
     env?: Partial<Env<T>>;
     primary?: boolean;
-    next?: string;
+    next?: Next;
 };
 /**
  * Sources configuration for collector.
@@ -2044,6 +2173,12 @@ interface SendResponse {
     error?: string;
 }
 
+/**
+ * Creates a BranchResult for dynamic chain routing.
+ * Use this in transformer push functions to redirect the chain.
+ */
+declare function branch(event: DeepPartialEvent, next: Next): BranchResult;
+
 /**
  * Anonymizes an IPv4 address by setting the last octet to 0.
  *
@@ -2073,7 +2208,7 @@ declare function packageNameToVariable(packageName: string): string;
  *
  * @param setup - The complete setup configuration
  * @param flowName - Flow name (auto-selected if only one exists)
- * @returns Resolved Config with variables/definitions interpolated and $refs resolved
+ * @returns Resolved Config with $var, $env, and $def patterns resolved
  * @throws Error if flow selection is required but not specified, or flow not found
  *
  * @example
@@ -2759,7 +2894,20 @@ declare function wrapFn(code: string): Fn$1;
  */
 declare function wrapValidate(code: string): Validate;
 
-export { collector as Collector, Const, context as Context, data as Data, destination as Destination, elb as Elb, flow as Flow, hooks as Hooks, Level, logger as Logger, mapping as Mapping, type MarketingParameters, type MockLogger, on as On, request as Request, schema as Schema, type SendDataValue, type SendHeaders, type SendResponse, source as Source, type StorageType, transformer as Transformer, walkeros as WalkerOS, anonymizeIP, assign, castToProperty, castValue, clone, createDestination, createEvent, createLogger, createMockLogger, debounce, 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, mockEnv, packageNameToVariable, parseUserAgent, processEventMapping, requestToData, requestToParameter, setByPath, throttle, throwError, transformData, traverseEnv, trim, tryCatch, tryCatchAsync, useHooks, validateEvent, validateProperty, wrapCondition, wrapFn, wrapValidate };
+interface WalkerOSPackageInfo {
+    packageName: string;
+    version: string;
+    type?: string;
+    platform?: string;
+    schemas: Record<string, unknown>;
+    examples: Record<string, unknown>;
+}
+declare function fetchPackageSchema(packageName: string, options?: {
+    version?: string;
+    timeout?: number;
+}): Promise<WalkerOSPackageInfo>;
+
+export { collector as Collector, Const, context as Context, data as Data, destination as Destination, elb as Elb, flow as Flow, hooks as Hooks, Level, logger as Logger, mapping as Mapping, type MarketingParameters, type MockLogger, on as On, request as Request, schema as Schema, type SendDataValue, type SendHeaders, type SendResponse, source as Source, type StorageType, transformer as Transformer, walkeros as WalkerOS, type WalkerOSPackageInfo, anonymizeIP, assign, branch, castToProperty, castValue, clone, createDestination, createEvent, createLogger, createMockLogger, debounce, 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, mockEnv, packageNameToVariable, parseUserAgent, processEventMapping, requestToData, requestToParameter, setByPath, throttle, throwError, transformData, traverseEnv, trim, tryCatch, tryCatchAsync, useHooks, validateEvent, validateProperty, wrapCondition, wrapFn, wrapValidate };
 `;
 
 // src/utils/monaco-types.ts
@@ -2936,4 +3084,4 @@ export {
   getLoadedTypeLibraries,
   clearAllTypeLibraries
 };
-//# sourceMappingURL=chunk-VWWAIDNX.mjs.map
+//# sourceMappingURL=chunk-YKT4D7MG.mjs.map