@walkeros/core 4.0.0-next-1777463920154 → 4.0.0

package/README.md

@@ -224,9 +224,11 @@ getId(10); // Returns 10-character string
 
 #### getMappingValue
 
-`getMappingValue(event: WalkerOS.Event, mapping: Mapping.Data, options?: Mapping.Options): Promise<WalkerOS.Property | undefined>`
+`getMappingValue(event: WalkerOS.Event, mapping: Mapping.Data, context?: Partial<Mapping.Context>): Promise<WalkerOS.Property | undefined>`
 extracts values from events using
 [mapping configurations](https://www.walkeros.io/docs/destinations/event-mapping).
+The `context` argument requires at least `{ collector }`; `event`, `logger`, and
+`consent` are derived or optional.
 
 ```ts
 // Simple path mapping

package/dist/dev.d.mts

@@ -5368,7 +5368,7 @@ interface CommandFn {
     (command: 'consent', consent: Consent): Promise<PushResult>;
     <T extends Types$4>(command: 'destination', destination: Init$3<T> | Instance$4<T>, config?: Config$6<T>): Promise<PushResult>;
     <K extends keyof Functions>(command: 'hook', name: K, hookFn: Functions[K]): Promise<PushResult>;
-    (command: 'on', type: Types$3, rules: SingleOrArray<Options$1>): Promise<PushResult>;
+    (command: 'on', type: Types$3, rules: SingleOrArray<Subscription>): Promise<PushResult>;
     (command: 'user', user: User): Promise<PushResult>;
     (command: 'run', runState?: {
         consent?: Consent;
@@ -5551,19 +5551,19 @@ interface InitDestinations {
  * Context provided to destination functions.
  * Extends base context with destination-specific properties.
  */
-interface Context$3<T extends TypesGeneric$3 = Types$4> extends Base<Config$6<T>, Env$3<T>> {
+interface Context$5<T extends TypesGeneric$3 = Types$4> extends Base<Config$6<T>, Env$3<T>> {
     id: string;
     data?: Data$1;
 }
-interface PushContext<T extends TypesGeneric$3 = Types$4> extends Context$3<T> {
+interface PushContext<T extends TypesGeneric$3 = Types$4> extends Context$5<T> {
     ingest: Ingest;
     rule?: Rule<Mapping$1<T>>;
 }
-interface PushBatchContext<T extends TypesGeneric$3 = Types$4> extends Context$3<T> {
+interface PushBatchContext<T extends TypesGeneric$3 = Types$4> extends Context$5<T> {
     ingest: Ingest;
     rule?: Rule<Mapping$1<T>>;
 }
-type InitFn$1<T extends TypesGeneric$3 = Types$4> = (context: Context$3<T>) => PromiseOrValue<void | false | Config$6<T>>;
+type InitFn$1<T extends TypesGeneric$3 = Types$4> = (context: Context$5<T>) => PromiseOrValue<void | false | Config$6<T>>;
 type PushFn<T extends TypesGeneric$3 = Types$4> = (event: Event, context: PushContext<T>) => PromiseOrValue<void | unknown>;
 type PushBatchFn<T extends TypesGeneric$3 = Types$4> = (batch: Batch<Mapping$1<T>>, context: PushBatchContext<T>) => void;
 interface Batch<Mapping> {
@@ -5591,14 +5591,14 @@ 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$6<T>): R;
     <K extends keyof Functions>(event: 'walker hook', name: K, hookFn: Functions[K]): R;
-    (event: 'walker on', type: Types$3, rules: SingleOrArray<Options$1>): R;
+    (event: 'walker on', type: Types$3, rules: SingleOrArray<Subscription>): R;
     (event: 'walker user', user: User): R;
     (event: 'walker run', runState: {
         consent?: Consent;
@@ -5720,44 +5720,62 @@ interface Config$5 {
     jsonHandler?: (data: unknown) => void;
 }
 
+/** Collector state mapping for the `on` actions. */
 type Config$4 = {
-    config?: Array<GenericConfig>;
-    consent?: Array<ConsentConfig>;
-    custom?: Array<GenericConfig>;
-    globals?: Array<GenericConfig>;
-    ready?: Array<ReadyConfig>;
-    run?: Array<RunConfig>;
-    session?: Array<SessionConfig>;
-    user?: Array<UserConfig>;
+    config?: Array<GenericFn>;
+    consent?: Array<ConsentRule>;
+    custom?: Array<GenericFn>;
+    globals?: Array<GenericFn>;
+    ready?: Array<ReadyFn>;
+    run?: Array<RunFn>;
+    session?: Array<SessionFn>;
+    user?: Array<UserFn>;
 };
+/** Allow arbitrary string events via `(string & {})`. */
 type Types$3 = keyof Config$4 | (string & {});
-type Options$1 = ConsentConfig | GenericConfig | ReadyConfig | RunConfig | SessionConfig | UserConfig;
-interface ConsentConfig {
+/**
+ * Context provided to every `on` callback.
+ * Same posture as Mapping.Context: collector + logger only;
+ * subscriptions are a collector-level concern, not a stage-level one.
+ */
+interface Context$4 {
+    collector: Instance$5;
+    logger: Instance$3;
+}
+/** Unified subscription callback shape. */
+type Fn$2<TData = unknown> = (data: TData, context: Context$4) => PromiseOrValue<void>;
+/** Typed-data variants for readability and IntelliSense. All reduce to Fn<TData>. */
+type ConsentFn = Fn$2<Consent>;
+type GenericFn = Fn$2<unknown>;
+type ReadyFn = Fn$2<void>;
+type RunFn = Fn$2<void>;
+type SessionFn = Fn$2<SessionData | undefined>;
+type UserFn = Fn$2<User>;
+/**
+ * Consent rule: a record of `{ [consentKey]: ConsentFn }`.
+ * Only the consent action uses this shape (per-key handler dispatch).
+ */
+interface ConsentRule {
     [key: string]: ConsentFn;
 }
-type ConsentFn = (collector: Instance$5, consent: Consent) => void;
-type GenericConfig = GenericFn;
-type GenericFn = (collector: Instance$5, data: unknown) => void;
-type ReadyConfig = ReadyFn;
-type ReadyFn = (collector: Instance$5) => void;
-type RunConfig = RunFn;
-type RunFn = (collector: Instance$5) => void;
-type SessionConfig = SessionFn;
-type SessionFn = (collector: Instance$5, session?: unknown) => void;
-type UserConfig = UserFn;
-type UserFn = (collector: Instance$5, user: User) => void;
+/** Anything registerable via `walker.on(action, X)`: a typed callback or a consent rule record. */
+type Subscription = ConsentRule | GenericFn | ReadyFn | RunFn | SessionFn | UserFn;
 interface OnConfig {
-    config?: GenericConfig[];
-    consent?: ConsentConfig[];
-    custom?: GenericConfig[];
-    globals?: GenericConfig[];
-    ready?: ReadyConfig[];
-    run?: RunConfig[];
-    session?: SessionConfig[];
-    user?: UserConfig[];
-    [key: string]: ConsentConfig[] | GenericConfig[] | ReadyConfig[] | RunConfig[] | SessionConfig[] | UserConfig[] | undefined;
+    config?: GenericFn[];
+    consent?: ConsentRule[];
+    custom?: GenericFn[];
+    globals?: GenericFn[];
+    ready?: ReadyFn[];
+    run?: RunFn[];
+    session?: SessionFn[];
+    user?: UserFn[];
+    [key: string]: ConsentRule[] | GenericFn[] | ReadyFn[] | RunFn[] | SessionFn[] | UserFn[] | undefined;
 }
-type OnFn<T extends TypesGeneric$3 = Types$4> = (type: Types$3, context: Context$3<T>) => PromiseOrValue<void>;
+/**
+ * Destination `on` handler: receives the action type and a destination context.
+ * Already context-style; kept for compatibility with the destination interface.
+ */
+type OnFn<T extends TypesGeneric$3 = Types$4> = (type: Types$3, context: Context$5<T>) => PromiseOrValue<void>;
 
 interface NextRule {
     match: MatchExpression | '*';
@@ -5823,7 +5841,7 @@ interface Config$3<T extends TypesGeneric$2 = Types$2> {
  * Context provided to transformer functions.
  * Extends base context with transformer-specific properties.
  */
-interface Context$2<T extends TypesGeneric$2 = Types$2> extends Base<Config$3<T>, Env$2<T>> {
+interface Context$3<T extends TypesGeneric$2 = Types$2> extends Base<Config$3<T>, Env$2<T>> {
     id: string;
     ingest: Ingest;
 }
@@ -5853,7 +5871,7 @@ interface Result<E = DeepPartialEvent> {
  * @returns void - continue with current event unchanged (passthrough)
  * @returns false - stop chain, cancel further processing
  */
-type Fn$1<T extends TypesGeneric$2 = Types$2, E = DeepPartialEvent> = (event: E, context: Context$2<T>) => PromiseOrValue<Result<E> | Result<E>[] | false | void>;
+type Fn$1<T extends TypesGeneric$2 = Types$2, E = DeepPartialEvent> = (event: E, context: Context$3<T>) => PromiseOrValue<Result<E> | Result<E>[] | false | void>;
 /**
  * Optional initialization function.
  * Called once before first push.
@@ -5863,7 +5881,7 @@ type Fn$1<T extends TypesGeneric$2 = Types$2, E = DeepPartialEvent> = (event: E,
  * @returns false - initialization failed, skip this transformer
  * @returns Config<T> - return updated config
  */
-type InitFn<T extends TypesGeneric$2 = Types$2> = (context: Context$2<T>) => PromiseOrValue<void | false | Config$3<T>>;
+type InitFn<T extends TypesGeneric$2 = Types$2> = (context: Context$3<T>) => PromiseOrValue<void | false | Config$3<T>>;
 /**
  * Transformer instance returned by Init function.
  */
@@ -5878,7 +5896,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$2<Types$2<Partial<Settings$1<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$1<T>>, Env$2<T>, InitSettings$2<T>>>) => Instance$2<T> | Promise<Instance$2<T>>;
 /**
  * Configuration for initializing a transformer.
  * Used in collector registration.
@@ -5910,7 +5928,7 @@ interface BaseEnv$1 {
     push: PushFn$1;
     command: CommandFn;
     sources?: Sources;
-    elb: Fn$2;
+    elb: Fn$3;
     logger: Instance$3;
 }
 /**
@@ -5923,7 +5941,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;
@@ -5984,7 +6002,7 @@ interface Instance$1<T extends TypesGeneric$1 = Types$1> {
  * Context provided to source init function.
  * Extends base context with source-specific properties.
  */
-interface Context$1<T extends TypesGeneric$1 = Types$1> extends Base<Partial<Config$2<T>>, Env$1<T>> {
+interface Context$2<T extends TypesGeneric$1 = Types$1> extends Base<Partial<Config$2<T>>, Env$1<T>> {
     id: string;
     /**
      * Sets ingest metadata for the current request.
@@ -5997,7 +6015,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$2<T>) => Instance$1<T> | Promise<Instance$1<T>>;
 type InitSource<T extends TypesGeneric$1 = Types$1> = {
     code: Init$1<T>;
     config?: Partial<Config$2<T>>;
@@ -6037,7 +6055,7 @@ interface Config$1<T extends TypesGeneric = Types> {
     id?: string;
     logger?: Config$5;
 }
-interface Context<T extends TypesGeneric = Types> extends Base<Config$1<T>, Env<T>> {
+interface Context$1<T extends TypesGeneric = Types> extends Base<Config$1<T>, Env<T>> {
     id: string;
 }
 type GetFn<T = unknown> = (key: string) => T | undefined | Promise<T | undefined>;
@@ -6051,7 +6069,7 @@ interface Instance<T extends TypesGeneric = Types> {
     delete: DeleteFn;
     destroy?: DestroyFn<Config$1<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$1<Types<Partial<Settings<T>>, Env<T>, InitSettings<T>>>) => Instance<T> | Promise<Instance<T>>;
 type InitStore<T extends TypesGeneric = Types> = {
     code: Init<T>;
     config?: Partial<Config$1<T>>;
@@ -6194,18 +6212,21 @@ interface ValueConfig {
     validate?: Validate;
     value?: PropertyType;
 }
-type Condition = (value: DeepPartialEvent | unknown, mapping?: Value, collector?: Instance$5) => PromiseOrValue<boolean>;
-type Fn = (value: DeepPartialEvent | unknown, mapping: Value, options: Options) => PromiseOrValue<Property | unknown>;
+interface Context {
+    event: DeepPartialEvent;
+    /** The surrounding mapping config: a Value (value-level) or a Rule (rule-level). */
+    mapping: Value | Rule;
+    collector: Instance$5;
+    logger: Instance$3;
+    consent?: Consent;
+}
+type Fn = (value: unknown, context: Context) => PromiseOrValue<Property | unknown>;
+type Condition = (value: unknown, context: Context) => PromiseOrValue<boolean>;
+type Validate = (value: unknown, context: Context) => PromiseOrValue<boolean>;
 type Loop = [Value, Value];
 type Map = {
     [key: string]: Value;
 };
-interface Options {
-    consent?: Consent;
-    collector?: Instance$5;
-    props?: unknown;
-}
-type Validate = (value?: unknown) => PromiseOrValue<boolean>;
 
 interface CacheRule {
     match: MatchExpression | '*';

package/dist/dev.d.ts

@@ -5368,7 +5368,7 @@ interface CommandFn {
     (command: 'consent', consent: Consent): Promise<PushResult>;
     <T extends Types$4>(command: 'destination', destination: Init$3<T> | Instance$4<T>, config?: Config$6<T>): Promise<PushResult>;
     <K extends keyof Functions>(command: 'hook', name: K, hookFn: Functions[K]): Promise<PushResult>;
-    (command: 'on', type: Types$3, rules: SingleOrArray<Options$1>): Promise<PushResult>;
+    (command: 'on', type: Types$3, rules: SingleOrArray<Subscription>): Promise<PushResult>;
     (command: 'user', user: User): Promise<PushResult>;
     (command: 'run', runState?: {
         consent?: Consent;
@@ -5551,19 +5551,19 @@ interface InitDestinations {
  * Context provided to destination functions.
  * Extends base context with destination-specific properties.
  */
-interface Context$3<T extends TypesGeneric$3 = Types$4> extends Base<Config$6<T>, Env$3<T>> {
+interface Context$5<T extends TypesGeneric$3 = Types$4> extends Base<Config$6<T>, Env$3<T>> {
     id: string;
     data?: Data$1;
 }
-interface PushContext<T extends TypesGeneric$3 = Types$4> extends Context$3<T> {
+interface PushContext<T extends TypesGeneric$3 = Types$4> extends Context$5<T> {
     ingest: Ingest;
     rule?: Rule<Mapping$1<T>>;
 }
-interface PushBatchContext<T extends TypesGeneric$3 = Types$4> extends Context$3<T> {
+interface PushBatchContext<T extends TypesGeneric$3 = Types$4> extends Context$5<T> {
     ingest: Ingest;
     rule?: Rule<Mapping$1<T>>;
 }
-type InitFn$1<T extends TypesGeneric$3 = Types$4> = (context: Context$3<T>) => PromiseOrValue<void | false | Config$6<T>>;
+type InitFn$1<T extends TypesGeneric$3 = Types$4> = (context: Context$5<T>) => PromiseOrValue<void | false | Config$6<T>>;
 type PushFn<T extends TypesGeneric$3 = Types$4> = (event: Event, context: PushContext<T>) => PromiseOrValue<void | unknown>;
 type PushBatchFn<T extends TypesGeneric$3 = Types$4> = (batch: Batch<Mapping$1<T>>, context: PushBatchContext<T>) => void;
 interface Batch<Mapping> {
@@ -5591,14 +5591,14 @@ 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$6<T>): R;
     <K extends keyof Functions>(event: 'walker hook', name: K, hookFn: Functions[K]): R;
-    (event: 'walker on', type: Types$3, rules: SingleOrArray<Options$1>): R;
+    (event: 'walker on', type: Types$3, rules: SingleOrArray<Subscription>): R;
     (event: 'walker user', user: User): R;
     (event: 'walker run', runState: {
         consent?: Consent;
@@ -5720,44 +5720,62 @@ interface Config$5 {
     jsonHandler?: (data: unknown) => void;
 }
 
+/** Collector state mapping for the `on` actions. */
 type Config$4 = {
-    config?: Array<GenericConfig>;
-    consent?: Array<ConsentConfig>;
-    custom?: Array<GenericConfig>;
-    globals?: Array<GenericConfig>;
-    ready?: Array<ReadyConfig>;
-    run?: Array<RunConfig>;
-    session?: Array<SessionConfig>;
-    user?: Array<UserConfig>;
+    config?: Array<GenericFn>;
+    consent?: Array<ConsentRule>;
+    custom?: Array<GenericFn>;
+    globals?: Array<GenericFn>;
+    ready?: Array<ReadyFn>;
+    run?: Array<RunFn>;
+    session?: Array<SessionFn>;
+    user?: Array<UserFn>;
 };
+/** Allow arbitrary string events via `(string & {})`. */
 type Types$3 = keyof Config$4 | (string & {});
-type Options$1 = ConsentConfig | GenericConfig | ReadyConfig | RunConfig | SessionConfig | UserConfig;
-interface ConsentConfig {
+/**
+ * Context provided to every `on` callback.
+ * Same posture as Mapping.Context: collector + logger only;
+ * subscriptions are a collector-level concern, not a stage-level one.
+ */
+interface Context$4 {
+    collector: Instance$5;
+    logger: Instance$3;
+}
+/** Unified subscription callback shape. */
+type Fn$2<TData = unknown> = (data: TData, context: Context$4) => PromiseOrValue<void>;
+/** Typed-data variants for readability and IntelliSense. All reduce to Fn<TData>. */
+type ConsentFn = Fn$2<Consent>;
+type GenericFn = Fn$2<unknown>;
+type ReadyFn = Fn$2<void>;
+type RunFn = Fn$2<void>;
+type SessionFn = Fn$2<SessionData | undefined>;
+type UserFn = Fn$2<User>;
+/**
+ * Consent rule: a record of `{ [consentKey]: ConsentFn }`.
+ * Only the consent action uses this shape (per-key handler dispatch).
+ */
+interface ConsentRule {
     [key: string]: ConsentFn;
 }
-type ConsentFn = (collector: Instance$5, consent: Consent) => void;
-type GenericConfig = GenericFn;
-type GenericFn = (collector: Instance$5, data: unknown) => void;
-type ReadyConfig = ReadyFn;
-type ReadyFn = (collector: Instance$5) => void;
-type RunConfig = RunFn;
-type RunFn = (collector: Instance$5) => void;
-type SessionConfig = SessionFn;
-type SessionFn = (collector: Instance$5, session?: unknown) => void;
-type UserConfig = UserFn;
-type UserFn = (collector: Instance$5, user: User) => void;
+/** Anything registerable via `walker.on(action, X)`: a typed callback or a consent rule record. */
+type Subscription = ConsentRule | GenericFn | ReadyFn | RunFn | SessionFn | UserFn;
 interface OnConfig {
-    config?: GenericConfig[];
-    consent?: ConsentConfig[];
-    custom?: GenericConfig[];
-    globals?: GenericConfig[];
-    ready?: ReadyConfig[];
-    run?: RunConfig[];
-    session?: SessionConfig[];
-    user?: UserConfig[];
-    [key: string]: ConsentConfig[] | GenericConfig[] | ReadyConfig[] | RunConfig[] | SessionConfig[] | UserConfig[] | undefined;
+    config?: GenericFn[];
+    consent?: ConsentRule[];
+    custom?: GenericFn[];
+    globals?: GenericFn[];
+    ready?: ReadyFn[];
+    run?: RunFn[];
+    session?: SessionFn[];
+    user?: UserFn[];
+    [key: string]: ConsentRule[] | GenericFn[] | ReadyFn[] | RunFn[] | SessionFn[] | UserFn[] | undefined;
 }
-type OnFn<T extends TypesGeneric$3 = Types$4> = (type: Types$3, context: Context$3<T>) => PromiseOrValue<void>;
+/**
+ * Destination `on` handler: receives the action type and a destination context.
+ * Already context-style; kept for compatibility with the destination interface.
+ */
+type OnFn<T extends TypesGeneric$3 = Types$4> = (type: Types$3, context: Context$5<T>) => PromiseOrValue<void>;
 
 interface NextRule {
     match: MatchExpression | '*';
@@ -5823,7 +5841,7 @@ interface Config$3<T extends TypesGeneric$2 = Types$2> {
  * Context provided to transformer functions.
  * Extends base context with transformer-specific properties.
  */
-interface Context$2<T extends TypesGeneric$2 = Types$2> extends Base<Config$3<T>, Env$2<T>> {
+interface Context$3<T extends TypesGeneric$2 = Types$2> extends Base<Config$3<T>, Env$2<T>> {
     id: string;
     ingest: Ingest;
 }
@@ -5853,7 +5871,7 @@ interface Result<E = DeepPartialEvent> {
  * @returns void - continue with current event unchanged (passthrough)
  * @returns false - stop chain, cancel further processing
  */
-type Fn$1<T extends TypesGeneric$2 = Types$2, E = DeepPartialEvent> = (event: E, context: Context$2<T>) => PromiseOrValue<Result<E> | Result<E>[] | false | void>;
+type Fn$1<T extends TypesGeneric$2 = Types$2, E = DeepPartialEvent> = (event: E, context: Context$3<T>) => PromiseOrValue<Result<E> | Result<E>[] | false | void>;
 /**
  * Optional initialization function.
  * Called once before first push.
@@ -5863,7 +5881,7 @@ type Fn$1<T extends TypesGeneric$2 = Types$2, E = DeepPartialEvent> = (event: E,
  * @returns false - initialization failed, skip this transformer
  * @returns Config<T> - return updated config
  */
-type InitFn<T extends TypesGeneric$2 = Types$2> = (context: Context$2<T>) => PromiseOrValue<void | false | Config$3<T>>;
+type InitFn<T extends TypesGeneric$2 = Types$2> = (context: Context$3<T>) => PromiseOrValue<void | false | Config$3<T>>;
 /**
  * Transformer instance returned by Init function.
  */
@@ -5878,7 +5896,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$2<Types$2<Partial<Settings$1<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$1<T>>, Env$2<T>, InitSettings$2<T>>>) => Instance$2<T> | Promise<Instance$2<T>>;
 /**
  * Configuration for initializing a transformer.
  * Used in collector registration.
@@ -5910,7 +5928,7 @@ interface BaseEnv$1 {
     push: PushFn$1;
     command: CommandFn;
     sources?: Sources;
-    elb: Fn$2;
+    elb: Fn$3;
     logger: Instance$3;
 }
 /**
@@ -5923,7 +5941,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;
@@ -5984,7 +6002,7 @@ interface Instance$1<T extends TypesGeneric$1 = Types$1> {
  * Context provided to source init function.
  * Extends base context with source-specific properties.
  */
-interface Context$1<T extends TypesGeneric$1 = Types$1> extends Base<Partial<Config$2<T>>, Env$1<T>> {
+interface Context$2<T extends TypesGeneric$1 = Types$1> extends Base<Partial<Config$2<T>>, Env$1<T>> {
     id: string;
     /**
      * Sets ingest metadata for the current request.
@@ -5997,7 +6015,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$2<T>) => Instance$1<T> | Promise<Instance$1<T>>;
 type InitSource<T extends TypesGeneric$1 = Types$1> = {
     code: Init$1<T>;
     config?: Partial<Config$2<T>>;
@@ -6037,7 +6055,7 @@ interface Config$1<T extends TypesGeneric = Types> {
     id?: string;
     logger?: Config$5;
 }
-interface Context<T extends TypesGeneric = Types> extends Base<Config$1<T>, Env<T>> {
+interface Context$1<T extends TypesGeneric = Types> extends Base<Config$1<T>, Env<T>> {
     id: string;
 }
 type GetFn<T = unknown> = (key: string) => T | undefined | Promise<T | undefined>;
@@ -6051,7 +6069,7 @@ interface Instance<T extends TypesGeneric = Types> {
     delete: DeleteFn;
     destroy?: DestroyFn<Config$1<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$1<Types<Partial<Settings<T>>, Env<T>, InitSettings<T>>>) => Instance<T> | Promise<Instance<T>>;
 type InitStore<T extends TypesGeneric = Types> = {
     code: Init<T>;
     config?: Partial<Config$1<T>>;
@@ -6194,18 +6212,21 @@ interface ValueConfig {
     validate?: Validate;
     value?: PropertyType;
 }
-type Condition = (value: DeepPartialEvent | unknown, mapping?: Value, collector?: Instance$5) => PromiseOrValue<boolean>;
-type Fn = (value: DeepPartialEvent | unknown, mapping: Value, options: Options) => PromiseOrValue<Property | unknown>;
+interface Context {
+    event: DeepPartialEvent;
+    /** The surrounding mapping config: a Value (value-level) or a Rule (rule-level). */
+    mapping: Value | Rule;
+    collector: Instance$5;
+    logger: Instance$3;
+    consent?: Consent;
+}
+type Fn = (value: unknown, context: Context) => PromiseOrValue<Property | unknown>;
+type Condition = (value: unknown, context: Context) => PromiseOrValue<boolean>;
+type Validate = (value: unknown, context: Context) => PromiseOrValue<boolean>;
 type Loop = [Value, Value];
 type Map = {
     [key: string]: Value;
 };
-interface Options {
-    consent?: Consent;
-    collector?: Instance$5;
-    props?: unknown;
-}
-type Validate = (value?: unknown) => PromiseOrValue<boolean>;
 
 interface CacheRule {
     match: MatchExpression | '*';