@walkeros/core 3.0.2 → 3.1.0

package/dist/index.d.mts

@@ -93,16 +93,16 @@ interface DestinationStatus {
     duration: number;
 }
 interface Sources {
-    [id: string]: Instance$1;
+    [id: string]: Instance$2;
 }
 interface Destinations$1 {
-    [id: string]: Instance$4;
+    [id: string]: Instance$5;
 }
 interface Transformers$1 {
-    [id: string]: Instance$2;
+    [id: string]: Instance$3;
 }
 interface Stores$1 {
-    [id: string]: Instance;
+    [id: string]: Instance$1;
 }
 type CommandType = 'action' | 'config' | 'consent' | 'context' | 'destination' | 'elb' | 'globals' | 'hook' | 'init' | 'link' | 'run' | 'user' | 'walker' | string;
 /**
@@ -128,7 +128,7 @@ interface PushFn$1 {
 interface CommandFn {
     (command: 'config', config: Partial<Config$8>): Promise<PushResult>;
     (command: 'consent', consent: Consent): Promise<PushResult>;
-    <T extends Types$4>(command: 'destination', destination: Init$3<T> | Instance$4<T>, config?: Config$7<T>): Promise<PushResult>;
+    <T extends Types$4>(command: 'destination', destination: Init$3<T> | Instance$5<T>, config?: Config$7<T>): Promise<PushResult>;
     <K extends keyof Functions>(command: 'hook', name: K, hookFn: Functions[K]): Promise<PushResult>;
     (command: 'on', type: Types$3, rules: SingleOrArray<Options>): Promise<PushResult>;
     (command: 'user', user: User): Promise<PushResult>;
@@ -140,7 +140,7 @@ interface CommandFn {
     }): Promise<PushResult>;
     (command: string, data?: unknown, options?: unknown): Promise<PushResult>;
 }
-interface Instance$5 {
+interface Instance$6 {
     push: PushFn$1;
     command: CommandFn;
     allowed: boolean;
@@ -155,7 +155,7 @@ interface Instance$5 {
     globals: Properties;
     group: string;
     hooks: Functions;
-    logger: Instance$3;
+    logger: Instance$4;
     on: OnConfig;
     queue: Events;
     round: number;
@@ -180,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$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 };
+  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$6 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 };
 }
 
 /**
@@ -188,8 +188,8 @@ declare namespace collector {
  * Sources, Transformers, and Destinations extend this.
  */
 interface Base<C = unknown, E = unknown> {
-    collector: Instance$5;
-    logger: Instance$3;
+    collector: Instance$6;
+    logger: Instance$4;
     config: C;
     env: E;
 }
@@ -214,7 +214,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$3;
+    logger: Instance$4;
 }
 /**
  * Destroy function signature for step lifecycle cleanup.
@@ -273,8 +273,8 @@ type Env$3<T extends TypesGeneric$3 = Types$4> = T['env'];
 /**
  * Inference helper: Extract Types from Instance
  */
-type TypesOf$3<I> = I extends Instance$4<infer T> ? T : never;
-interface Instance$4<T extends TypesGeneric$3 = Types$4> {
+type TypesOf$3<I> = I extends Instance$5<infer T> ? T : never;
+interface Instance$5<T extends TypesGeneric$3 = Types$4> {
     config: Config$7<T>;
     queuePush?: Events;
     queueOn?: Array<{
@@ -323,7 +323,7 @@ type PartialConfig$1<T extends TypesGeneric$3 = Types$4> = Config$7<Types$4<Part
 interface Policy$1 {
     [key: string]: Value;
 }
-type Code$1<T extends TypesGeneric$3 = Types$4> = Instance$4<T>;
+type Code$1<T extends TypesGeneric$3 = Types$4> = Instance$5<T>;
 type Init$3<T extends TypesGeneric$3 = Types$4> = {
     code: Code$1<T>;
     config?: Partial<Config$7<T>>;
@@ -334,7 +334,7 @@ interface InitDestinations {
     [key: string]: Init$3<any>;
 }
 interface Destinations {
-    [key: string]: Instance$4;
+    [key: string]: Instance$5;
 }
 /**
  * Context provided to destination functions.
@@ -397,7 +397,7 @@ type destination_PushEvents<Mapping = unknown> = PushEvents<Mapping>;
 type destination_PushFn<T extends TypesGeneric$3 = Types$4> = PushFn<T>;
 type destination_Ref = Ref;
 declare namespace destination {
-  export type { BaseEnv$3 as BaseEnv, destination_Batch as Batch, destination_BatchRegistry as BatchRegistry, Code$1 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$4 as Settings, Types$4 as Types, TypesGeneric$3 as TypesGeneric, TypesOf$3 as TypesOf };
+  export type { BaseEnv$3 as BaseEnv, destination_Batch as Batch, destination_BatchRegistry as BatchRegistry, Code$1 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$5 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$4 as Settings, Types$4 as Types, TypesGeneric$3 as TypesGeneric, TypesOf$3 as TypesOf };
 }
 
 interface EventFn<R = Promise<PushResult>> {
@@ -405,12 +405,12 @@ interface EventFn<R = Promise<PushResult>> {
     (event: string): R;
     (event: string, data: Properties): R;
 }
-interface Fn$2<R = Promise<PushResult>, Config = unknown> extends EventFn<R>, WalkerCommands<R, Config> {
+interface Fn$3<R = Promise<PushResult>, Config = unknown> extends EventFn<R>, WalkerCommands<R, Config> {
 }
 interface WalkerCommands<R = Promise<PushResult>, Config = unknown> {
     (event: 'walker config', config: Partial<Config>): R;
     (event: 'walker consent', consent: Consent): R;
-    <T extends Types$4>(event: 'walker destination', destination: Init$3<T> | Instance$4<T>, config?: Config$7<T>): R;
+    <T extends Types$4>(event: 'walker destination', destination: Init$3<T> | Instance$5<T>, config?: Config$7<T>): R;
     <K extends keyof Functions>(event: 'walker hook', name: K, hookFn: Functions[K]): R;
     (event: 'walker on', type: Types$3, rules: SingleOrArray<Options>): R;
     (event: 'walker user', user: User): R;
@@ -438,7 +438,7 @@ type elb_PushData<Config = unknown> = PushData<Config>;
 type elb_PushResult = PushResult;
 type elb_WalkerCommands<R = Promise<PushResult>, Config = unknown> = WalkerCommands<R, Config>;
 declare namespace elb {
-  export type { Event$1 as Event, elb_EventFn as EventFn, Fn$2 as Fn, elb_Layer as Layer, elb_PushData as PushData, elb_PushResult as PushResult, elb_WalkerCommands as WalkerCommands };
+  export type { Event$1 as Event, elb_EventFn as EventFn, Fn$3 as Fn, elb_Layer as Layer, elb_PushData as PushData, elb_PushResult as PushResult, elb_WalkerCommands as WalkerCommands };
 }
 
 /**
@@ -846,6 +846,13 @@ interface Settings$3 {
 interface StepExample {
     description?: string;
     in?: unknown;
+    /** Trigger metadata for sources — type and options for the trigger call. */
+    trigger?: {
+        /** Which mechanism to activate (e.g., 'click', 'POST', 'load'). */
+        type?: string;
+        /** Mechanism-specific options (e.g., CSS selector, threshold). */
+        options?: unknown;
+    };
     mapping?: unknown;
     out?: unknown;
 }
@@ -1282,7 +1289,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$3 {
+interface Instance$4 {
     /**
      * Log an error message (always visible unless silenced)
      */
@@ -1313,7 +1320,7 @@ interface Instance$3 {
      * @param name - Scope name (e.g., destination type, destination key)
      * @returns A new logger instance with the scope applied
      */
-    scope: (name: string) => Instance$3;
+    scope: (name: string) => Instance$4;
 }
 /**
  * Logger configuration options
@@ -1344,7 +1351,7 @@ interface InternalConfig {
 /**
  * Logger factory function type
  */
-type Factory = (config?: Config$5) => Instance$3;
+type Factory = (config?: Config$5) => Instance$4;
 
 type logger_DefaultHandler = DefaultHandler;
 type logger_ErrorContext = ErrorContext;
@@ -1357,7 +1364,7 @@ type logger_LogContext = LogContext;
 type logger_LogFn = LogFn;
 type logger_ThrowFn = ThrowFn;
 declare namespace logger {
-  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 };
+  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$4 as Instance, type logger_InternalConfig as InternalConfig, logger_Level as Level, type logger_LogContext as LogContext, type logger_LogFn as LogFn, type logger_ThrowFn as ThrowFn };
 }
 
 /**
@@ -1378,7 +1385,7 @@ interface Rules<T = Rule> {
 }
 interface Rule<Settings = unknown> {
     batch?: number;
-    batchFn?: (destination: Instance$4, collector: Instance$5) => void;
+    batchFn?: (destination: Instance$5, collector: Instance$6) => void;
     batched?: Batch<Settings>;
     condition?: Condition;
     consent?: Consent;
@@ -1399,7 +1406,7 @@ type ValueType = string | ValueConfig;
 interface ValueConfig {
     condition?: Condition;
     consent?: Consent;
-    fn?: Fn$1;
+    fn?: Fn$2;
     key?: string;
     loop?: Loop;
     map?: Map;
@@ -1407,15 +1414,15 @@ interface ValueConfig {
     validate?: Validate;
     value?: PropertyType;
 }
-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 Condition = (value: DeepPartialEvent | unknown, mapping?: Value, collector?: Instance$6) => PromiseOrValue<boolean>;
+type Fn$2 = (value: DeepPartialEvent | unknown, mapping: Value, options: Options$1) => PromiseOrValue<Property | unknown>;
 type Loop = [Value, Value];
 type Map = {
     [key: string]: Value;
 };
 interface Options$1 {
     consent?: Consent;
-    collector?: Instance$5;
+    collector?: Instance$6;
     props?: unknown;
 }
 type Validate = (value?: unknown) => PromiseOrValue<boolean>;
@@ -1433,7 +1440,7 @@ type mapping_ValueConfig = ValueConfig;
 type mapping_ValueType = ValueType;
 type mapping_Values = Values;
 declare namespace mapping {
-  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 };
+  export type { mapping_Condition as Condition, Config$4 as Config, mapping_Data as Data, Fn$2 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$3 = {
@@ -1467,17 +1474,17 @@ type Options = ConsentConfig | GenericConfig | ReadyConfig | RunConfig | Session
 interface ConsentConfig {
     [key: string]: ConsentFn;
 }
-type ConsentFn = (collector: Instance$5, consent: Consent) => void;
+type ConsentFn = (collector: Instance$6, consent: Consent) => void;
 type GenericConfig = GenericFn;
-type GenericFn = (collector: Instance$5, data: unknown) => void;
+type GenericFn = (collector: Instance$6, data: unknown) => void;
 type ReadyConfig = ReadyFn;
-type ReadyFn = (collector: Instance$5) => void;
+type ReadyFn = (collector: Instance$6) => void;
 type RunConfig = RunFn;
-type RunFn = (collector: Instance$5) => void;
+type RunFn = (collector: Instance$6) => void;
 type SessionConfig = SessionFn;
-type SessionFn = (collector: Instance$5, session?: unknown) => void;
+type SessionFn = (collector: Instance$6, session?: unknown) => void;
 type UserConfig = UserFn;
-type UserFn = (collector: Instance$5, user: User) => void;
+type UserFn = (collector: Instance$6, user: User) => void;
 interface OnConfig {
     config?: GenericConfig[];
     consent?: ConsentConfig[];
@@ -1556,7 +1563,7 @@ type Env$2<T extends TypesGeneric$2 = Types$2> = T['env'];
 /**
  * Inference helper: Extract Types from Instance.
  */
-type TypesOf$2<I> = I extends Instance$2<infer T> ? T : never;
+type TypesOf$2<I> = I extends Instance$3<infer T> ? T : never;
 /**
  * Transformer configuration.
  */
@@ -1599,7 +1606,7 @@ interface Result$1 {
  * @returns void - continue with current event unchanged (passthrough)
  * @returns false - stop chain, cancel further processing
  */
-type Fn<T extends TypesGeneric$2 = Types$2> = (event: DeepPartialEvent, context: Context$3<T>) => PromiseOrValue<Result$1 | false | void>;
+type Fn$1<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.
@@ -1613,10 +1620,10 @@ type InitFn$1<T extends TypesGeneric$2 = Types$2> = (context: Context$3<T>) => P
 /**
  * Transformer instance returned by Init function.
  */
-interface Instance$2<T extends TypesGeneric$2 = Types$2> {
+interface Instance$3<T extends TypesGeneric$2 = Types$2> {
     type: string;
     config: Config$2<T>;
-    push: Fn<T>;
+    push: Fn$1<T>;
     init?: InitFn$1<T>;
     destroy?: DestroyFn<Config$2<T>, Env$2<T>>;
 }
@@ -1624,7 +1631,7 @@ interface Instance$2<T extends TypesGeneric$2 = Types$2> {
  * Transformer initialization function.
  * Creates a transformer instance from context.
  */
-type Init$2<T extends TypesGeneric$2 = Types$2> = (context: Context$3<Types$2<Partial<Settings$2<T>>, Env$2<T>, InitSettings$2<T>>>) => Instance$2<T> | Promise<Instance$2<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$3<T> | Promise<Instance$3<T>>;
 /**
  * Configuration for initializing a transformer.
  * Used in collector registration.
@@ -1646,16 +1653,15 @@ interface InitTransformers {
  * Active transformer instances registry.
  */
 interface Transformers {
-    [transformerId: string]: Instance$2;
+    [transformerId: string]: Instance$3;
 }
 
-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$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 };
+  export type { BaseEnv$2 as BaseEnv, Config$2 as Config, Context$3 as Context, Env$2 as Env, Fn$1 as Fn, Init$2 as Init, InitFn$1 as InitFn, InitSettings$2 as InitSettings, transformer_InitTransformer as InitTransformer, transformer_InitTransformers as InitTransformers, Instance$3 as Instance, transformer_Next as Next, 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$2 {
@@ -1686,8 +1692,8 @@ interface BaseEnv$1 {
     push: PushFn$1;
     command: CommandFn;
     sources?: Sources;
-    elb: Fn$2;
-    logger: Instance$3;
+    elb: Fn$3;
+    logger: Instance$4;
 }
 /**
  * Type bundle for source generics.
@@ -1699,7 +1705,7 @@ interface BaseEnv$1 {
  * @template E - Environment dependencies type
  * @template I - InitSettings configuration type (user input)
  */
-interface Types$1<S = unknown, M = unknown, P = Fn$2, E = BaseEnv$1, I = S> {
+interface Types$1<S = unknown, M = unknown, P = Fn$3, E = BaseEnv$1, I = S> {
     settings: S;
     initSettings: I;
     mapping: M;
@@ -1727,7 +1733,7 @@ type Env$1<T extends TypesGeneric$1 = Types$1> = T['env'];
 /**
  * Inference helper: Extract Types from Instance
  */
-type TypesOf$1<I> = I extends Instance$1<infer T> ? T : never;
+type TypesOf$1<I> = I extends Instance$2<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$1<T>;
@@ -1756,7 +1762,7 @@ interface Config$1<T extends TypesGeneric$1 = Types$1> extends Config$4<Mapping<
     ingest?: Data;
 }
 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> {
+interface Instance$2<T extends TypesGeneric$1 = Types$1> {
     type: string;
     config: Config$1<T>;
     push: Push<T>;
@@ -1780,7 +1786,7 @@ interface Context$1<T extends TypesGeneric$1 = Types$1> extends Base<Partial<Con
     /** Sets respond function for the current request. Called by source per-request. */
     setRespond: (fn: RespondFn | undefined) => void;
 }
-type Init$1<T extends TypesGeneric$1 = Types$1> = (context: Context$1<T>) => Instance$1<T> | Promise<Instance$1<T>>;
+type Init$1<T extends TypesGeneric$1 = Types$1> = (context: Context$1<T>) => Instance$2<T> | Promise<Instance$2<T>>;
 type InitSource<T extends TypesGeneric$1 = Types$1> = {
     code: Init$1<T>;
     config?: Partial<Config$1<T>>;
@@ -1801,26 +1807,6 @@ interface InitSources {
  * - 'codebox': Source uses a JSON/code editor (default)
  */
 type Renderer = 'browser' | 'codebox';
-/**
- * Minimal environment contract for source simulation.
- * Both JSDOM and iframe satisfy this interface.
- */
-interface SimulationEnv {
-    window: Window & typeof globalThis;
-    document: Document;
-    localStorage: Storage;
-    [key: string]: unknown;
-}
-/**
- * Setup function for source simulation.
- * Runs BEFORE startFlow() to prepare the environment
- * (dataLayer arrays, localStorage, window globals).
- *
- * Return void for sources that need no post-init action.
- * Return a () => void trigger for sources that dispatch
- * events AFTER startFlow() (e.g., usercentrics CustomEvent).
- */
-type SetupFn = (input: unknown, env: SimulationEnv) => void | (() => void);
 
 type source_InitSource<T extends TypesGeneric$1 = Types$1> = InitSource<T>;
 type source_InitSources = InitSources;
@@ -1828,10 +1814,8 @@ 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_SetupFn = SetupFn;
-type source_SimulationEnv = SimulationEnv;
 declare namespace source {
-  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 };
+  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$2 as Instance, source_Mapping as Mapping, source_PartialConfig as PartialConfig, source_Push as Push, source_Renderer as Renderer, Settings$1 as Settings, Types$1 as Types, TypesGeneric$1 as TypesGeneric, TypesOf$1 as TypesOf };
 }
 
 interface BaseEnv {
@@ -1850,7 +1834,7 @@ type TypesGeneric = {
 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;
+type TypesOf<I> = I extends Instance$1<infer T> ? T : never;
 interface Config<T extends TypesGeneric = Types> {
     settings?: InitSettings<T>;
     env?: Env<T>;
@@ -1863,7 +1847,7 @@ interface Context<T extends TypesGeneric = Types> extends Base<Config<T>, Env<T>
 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> {
+interface Instance$1<T extends TypesGeneric = Types> {
     type: string;
     config: Config<T>;
     get: GetFn;
@@ -1871,7 +1855,7 @@ interface Instance<T extends TypesGeneric = Types> {
     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 Init<T extends TypesGeneric = Types> = (context: Context<Types<Partial<Settings<T>>, Env<T>, InitSettings<T>>>) => Instance$1<T> | Promise<Instance$1<T>>;
 type InitFn<T extends TypesGeneric = Types> = (context: Context<T>) => PromiseOrValue<void | false | Config<T>>;
 type InitStore<T extends TypesGeneric = Types> = {
     code: Init<T>;
@@ -1882,7 +1866,7 @@ interface InitStores {
     [storeId: string]: InitStore<any>;
 }
 interface Stores {
-    [storeId: string]: Instance;
+    [storeId: string]: Instance$1;
 }
 
 type store_BaseEnv = BaseEnv;
@@ -1896,7 +1880,6 @@ 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;
@@ -1904,11 +1887,95 @@ 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 };
+  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, Instance$1 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 };
+}
+
+/**
+ * Trigger — unified interface for invoking any walkerOS step in simulation
+ * and testing. Every package exports a `createTrigger` factory from its
+ * examples that conforms to `Trigger.CreateFn`.
+ *
+ * Usage:
+ *   const { flow, trigger } = await createTrigger(initConfig);
+ *   const result = await trigger(type?, options?)(content);
+ *
+ * @packageDocumentation
+ */
+
+/** Flow access handle returned by createTrigger. */
+interface FlowHandle {
+    /** The collector instance created by startFlow. */
+    collector: Instance$6;
+    /** The elb push function for direct event injection. */
+    elb: Fn$3;
+}
+/** What createTrigger returns — a flow handle (lazy) and a trigger function. */
+interface Instance<TContent = unknown, TResult = unknown> {
+    /** Flow handle — undefined until first trigger() call, then stable. */
+    readonly flow: FlowHandle | undefined;
+    trigger: Fn<TContent, TResult>;
+}
+/**
+ * Curried trigger function — always async.
+ *
+ * First call selects mechanism (type) and configures it (options).
+ * Second call fires with content and returns result.
+ *
+ * @example
+ * // Browser source — click trigger
+ * trigger('click', 'button.cta')('<button data-elb="cta">Sign Up</button>')
+ *
+ * // Express source — POST request
+ * trigger('POST')({ path: '/collect', body: { name: 'page view' } })
+ *
+ * // DataLayer — default mechanism
+ * trigger()(['event', 'purchase', { value: 25.42 }])
+ */
+type Fn<TContent = unknown, TResult = unknown> = (type?: string, options?: unknown) => (content: TContent) => Promise<TResult>;
+/**
+ * Factory function exported by each package's examples.
+ *
+ * Receives full Collector.InitConfig. Does NOT call startFlow eagerly —
+ * startFlow is deferred to the first trigger() invocation (lazy init).
+ * The flow property uses a getter to read the closure variable live.
+ * createTrigger itself stays async for consistency (other packages may
+ * need await during setup). Config is passed through UNMODIFIED —
+ * validation is startFlow's job.
+ *
+ * @example
+ * // Package exports:
+ * export const createTrigger: Trigger.CreateFn<HTMLContent, void> = async (config) => {
+ *   let flow: Trigger.FlowHandle | undefined;
+ *
+ *   const trigger: Trigger.Fn<HTMLContent, void> = (type?, options?) => async (content) => {
+ *     // Pre-startFlow work (e.g., inject HTML for browser source)
+ *     // ...
+ *
+ *     // Lazy init — only on first call
+ *     if (!flow) flow = await startFlow(config);
+ *
+ *     // Post-startFlow work (e.g., dispatch click event)
+ *     // ...
+ *   };
+ *
+ *   return {
+ *     get flow() { return flow; },
+ *     trigger,
+ *   };
+ * };
+ */
+type CreateFn<TContent = unknown, TResult = unknown> = (config: InitConfig, options?: unknown) => Promise<Instance<TContent, TResult>>;
+
+type trigger_CreateFn<TContent = unknown, TResult = unknown> = CreateFn<TContent, TResult>;
+type trigger_FlowHandle = FlowHandle;
+type trigger_Fn<TContent = unknown, TResult = unknown> = Fn<TContent, TResult>;
+type trigger_Instance<TContent = unknown, TResult = unknown> = Instance<TContent, TResult>;
+declare namespace trigger {
+  export type { trigger_CreateFn as CreateFn, trigger_FlowHandle as FlowHandle, trigger_Fn as Fn, trigger_Instance as Instance };
 }
 
 type AnyObject<T = unknown> = Record<string, T>;
-type Elb = Fn$2;
+type Elb = Fn$3;
 type AnyFunction = (...args: unknown[]) => unknown;
 type SingleOrArray<T> = T | Array<T>;
 type Events = Array<Event>;
@@ -2297,7 +2364,7 @@ declare function getGrantedConsent(required: Consent | undefined, state?: Consen
  * }));
  * ```
  */
-declare function createDestination<I extends Instance$4>(baseDestination: I, config: Partial<Config$7<TypesOf$3<I>>>): I;
+declare function createDestination<I extends Instance$5>(baseDestination: I, config: Partial<Config$7<TypesOf$3<I>>>): I;
 
 /**
  * Creates a complete event with default values.
@@ -2459,7 +2526,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$5): Instance$3;
+declare function createLogger(config?: Config$5): Instance$4;
 
 /**
  * Gets the mapping for an event.
@@ -2497,7 +2564,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$4, collector: Instance$5): Promise<{
+declare function processEventMapping<T extends DeepPartialEvent | Event>(event: T, config: Config$4, collector: Instance$6): Promise<{
     event: T;
     data?: Property;
     mapping?: Rule;
@@ -2576,7 +2643,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$3 {
+interface MockLogger extends Instance$4 {
     error: jest.Mock;
     warn: jest.Mock;
     info: jest.Mock;
@@ -2813,7 +2880,7 @@ declare function wrapCondition(code: string): Condition;
  * const fn = wrapFn('const parts = value.user.email.split("@"); return parts[1].toUpperCase()');
  * ```
  */
-declare function wrapFn(code: string): Fn$1;
+declare function wrapFn(code: string): Fn$2;
 /**
  * Wrap inline code string as Validate function.
  *
@@ -2847,13 +2914,13 @@ interface WalkerOSPackageMeta {
     version: string;
     description?: string;
     type?: string;
-    platform?: string;
+    platform?: string | string[];
 }
 interface WalkerOSPackageInfo {
     packageName: string;
     version: string;
     type?: string;
-    platform?: string;
+    platform?: string | string[];
     schemas: Record<string, unknown>;
     examples: Record<string, unknown>;
     hints?: Record<string, unknown>;
@@ -2920,4 +2987,11 @@ declare function mcpError(error: unknown, hint?: string): {
  */
 declare function compileMatcher(expr: MatchExpression | '*'): CompiledMatcher;
 
-export { collector as Collector, Const, context as Context, destination as Destination, ENV_MARKER_PREFIX, elb as Elb, type ExampleSummary, flow as Flow, hint as Hint, 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 WalkerOSPackage, type WalkerOSPackageInfo, type WalkerOSPackageMeta, anonymizeIP, assign, branch, castToProperty, castValue, clone, compileMatcher, createDestination, createEvent, createLogger, createMockLogger, createRespond, debounce, fetchPackage, fetchPackageSchema, filterValues, getBrowser, getBrowserVersion, getByPath, getDeviceType, getEvent, getFlowSettings, 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, resolveContracts, setByPath, throttle, throwError, transformData, traverseEnv, trim, tryCatch, tryCatchAsync, useHooks, walkPath, wrapCondition, wrapFn, wrapValidate };
+type PackageType = 'source' | 'destination' | 'transformer' | 'store';
+interface PackageSchemas {
+    settings?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+declare function mergeConfigSchema(type: PackageType, packageSchemas: PackageSchemas): Record<string, unknown>;
+
+export { collector as Collector, Const, context as Context, destination as Destination, ENV_MARKER_PREFIX, elb as Elb, type ExampleSummary, flow as Flow, hint as Hint, 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, trigger as Trigger, walkeros as WalkerOS, type WalkerOSPackage, type WalkerOSPackageInfo, type WalkerOSPackageMeta, anonymizeIP, assign, branch, castToProperty, castValue, clone, compileMatcher, createDestination, createEvent, createLogger, createMockLogger, createRespond, debounce, fetchPackage, fetchPackageSchema, filterValues, getBrowser, getBrowserVersion, getByPath, getDeviceType, getEvent, getFlowSettings, getGrantedConsent, getHeaders, getId, getMappingEvent, getMappingValue, getMarketingParameters, getOS, getOSVersion, getPlatform, isArguments, isArray, isBoolean, isCommand, isDefined, isElementOrDocument, isFunction, isNumber, isObject, isPropertyType, isSameType, isString, mcpError, mcpResult, mergeConfigSchema, mergeContractSchemas, mockEnv, packageNameToVariable, parseUserAgent, processEventMapping, requestToData, requestToParameter, resolveContracts, setByPath, throttle, throwError, transformData, traverseEnv, trim, tryCatch, tryCatchAsync, useHooks, walkPath, wrapCondition, wrapFn, wrapValidate };