@walkeros/core 1.2.2 → 1.4.0-next-1771252576264

package/dist/index.d.mts

@@ -44,6 +44,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;
 }
@@ -107,19 +126,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_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, 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 };
 }
 
 /**
@@ -251,17 +278,31 @@ 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>>>;
@@ -1192,41 +1233,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>;
@@ -1234,8 +1291,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;
@@ -1246,10 +1305,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.
  *
@@ -1299,7 +1361,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;
 }
 /**
@@ -1310,6 +1372,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() — 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.
@@ -1320,7 +1396,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.
@@ -1354,6 +1430,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.
@@ -1369,13 +1446,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 {
@@ -1477,12 +1556,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.)
@@ -1503,7 +1588,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.
@@ -1526,7 +1611,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.
@@ -1692,6 +1777,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.
  *
@@ -2407,4 +2498,17 @@ 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 };

package/dist/index.d.ts

@@ -44,6 +44,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;
 }
@@ -107,19 +126,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_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, 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 };
 }
 
 /**
@@ -251,17 +278,31 @@ 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>>>;
@@ -1192,41 +1233,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>;
@@ -1234,8 +1291,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;
@@ -1246,10 +1305,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.
  *
@@ -1299,7 +1361,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;
 }
 /**
@@ -1310,6 +1372,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() — 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.
@@ -1320,7 +1396,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.
@@ -1354,6 +1430,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.
@@ -1369,13 +1446,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 {
@@ -1477,12 +1556,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.)
@@ -1503,7 +1588,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.
@@ -1526,7 +1611,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.
@@ -1692,6 +1777,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.
  *
@@ -2407,4 +2498,17 @@ 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 };