@walkeros/core 4.7.1 → 4.7.2-next-1791213015481

package/dist/index.d.ts

@@ -542,6 +542,26 @@ interface InitConfig extends Partial<Config$6> {
      */
     observers?: ObserverFn[];
 }
+/**
+ * Typed authoring form of `InitConfig`, taken by `startFlow`.
+ *
+ * Each entry of `sources`, `destinations`, `transformers` and `stores` is
+ * checked against the Types inferred from its own `code`, so its `config`
+ * (settings, mapping rule settings, ...) autocompletes and type-checks. An
+ * entry without inferable Types stays as loose as `InitConfig`, alone, and
+ * an `InitConfig` value is accepted as is. `startFlow` infers the four maps
+ * and owns their defaults.
+ */
+interface InitConfigOf<S, D, T, St> extends Omit<InitConfig, 'sources' | 'destinations' | 'transformers' | 'stores'> {
+    /** Source configurations */
+    sources?: InitSourcesOf<S>;
+    /** Destination configurations */
+    destinations?: InitDestinationsOf<D>;
+    /** Transformer configurations */
+    transformers?: InitTransformersOf<T>;
+    /** Store configurations */
+    stores?: InitStoresOf<St>;
+}
 interface SessionData extends Properties {
     isStart: boolean;
     storage: boolean;
@@ -833,6 +853,7 @@ type collector_CommandType = CommandType;
 type collector_DestinationStatus = DestinationStatus;
 type collector_DroppedCounters = DroppedCounters;
 type collector_InitConfig = InitConfig;
+type collector_InitConfigOf<S, D, T, St> = InitConfigOf<S, D, T, St>;
 type collector_PushOptions = PushOptions;
 type collector_SessionData = SessionData;
 type collector_SourceStatus = SourceStatus;
@@ -841,7 +862,7 @@ type collector_Status = Status;
 type collector_StepKind = StepKind;
 declare const collector_stepId: typeof stepId;
 declare namespace collector {
-  export { type collector_BreakerState as BreakerState, type collector_Cascade as Cascade, type collector_CommandFn as CommandFn, type collector_CommandType as CommandType, type Config$6 as Config, type collector_DestinationStatus as DestinationStatus, type Destinations$1 as Destinations, type collector_DroppedCounters as DroppedCounters, type collector_InitConfig as InitConfig, type Instance$6 as Instance, type PushFn$1 as PushFn, type collector_PushOptions as PushOptions, type collector_SessionData as SessionData, type collector_SourceStatus as SourceStatus, type collector_Sources as Sources, type collector_Status as Status, type collector_StepKind as StepKind, type Stores$1 as Stores, type Transformers$1 as Transformers, collector_stepId as stepId };
+  export { type collector_BreakerState as BreakerState, type collector_Cascade as Cascade, type collector_CommandFn as CommandFn, type collector_CommandType as CommandType, type Config$6 as Config, type collector_DestinationStatus as DestinationStatus, type Destinations$1 as Destinations, type collector_DroppedCounters as DroppedCounters, type collector_InitConfig as InitConfig, type collector_InitConfigOf as InitConfigOf, type Instance$6 as Instance, type PushFn$1 as PushFn, type collector_PushOptions as PushOptions, type collector_SessionData as SessionData, type collector_SourceStatus as SourceStatus, type collector_Sources as Sources, type collector_Status as Status, type collector_StepKind as StepKind, type Stores$1 as Stores, type Transformers$1 as Transformers, collector_stepId as stepId };
 }
 
 /**
@@ -969,6 +990,86 @@ declare namespace lifecycle {
   export type { lifecycle_DestroyContext as DestroyContext, lifecycle_DestroyFn as DestroyFn, lifecycle_LifecycleContext as LifecycleContext, lifecycle_SetupFn as SetupFn };
 }
 
+/**
+ * Package-internal type helpers. Not re-exported from `types/index.ts`.
+ */
+/**
+ * `true` when A and B are the same type, `false` otherwise.
+ *
+ * The double-function indirection compares the two types strictly; a plain
+ * mutual `extends` check is fooled by `any` and by distributive types.
+ */
+type IsExactly<A, B> = (<V>() => V extends A ? 1 : 2) extends <V>() => V extends B ? 1 : 2 ? true : false;
+type AnyFunction$2 = (...args: never[]) => unknown;
+/**
+ * `true` when an object type has a function-valued property. Such objects
+ * (class instances, DOM nodes, SDK clients) are values, not plain data, so
+ * widening leaves them as they are instead of recursing into them.
+ */
+type HasMethod<T> = true extends {
+    [K in keyof T]-?: NonNullable<T[K]> extends AnyFunction$2 ? true : false;
+}[keyof T] ? true : false;
+/**
+ * A literal leaf also accepts its primitive. `(string & {})` keeps the
+ * literal members visible (completions, error messages) instead of collapsing
+ * the union to `string`; a leaf typed as plain `string` stays `string`.
+ */
+type WidenValue<T> = T extends string ? string extends T ? T : T | (string & {}) : T extends number ? number extends T ? T : T | (number & {}) : T extends boolean ? boolean : T extends AnyFunction$2 ? T : T extends readonly (infer U)[] ? readonly WidenValue<U>[] : T extends object ? HasMethod<T> extends true ? T : WidenLiterals<T> : T;
+/**
+ * An object type whose string, number and boolean literals also accept their
+ * primitive (`transport: 'beacon'` widens to `transport: string`), through
+ * plain objects and arrays: what a config value declared in a separate
+ * variable looks like. Keys, required fields and value kinds stay checked,
+ * and literal completions still come from `T`. Functions and objects with
+ * methods stay as they are.
+ */
+type WidenLiterals<T> = {
+    [K in keyof T]: WidenValue<T[K]>;
+};
+/**
+ * `WidenLiterals` for a config slot of any shape. The top level is always
+ * mapped, so a settings object with a callback still has its literal
+ * properties widened; a slot that is not an object (`unknown`, `any`, a
+ * primitive) keeps its own looseness.
+ */
+type WidenConfig<T> = T extends AnyFunction$2 ? T : T extends readonly unknown[] ? WidenValue<T> : T extends object ? WidenLiterals<T> : WidenValue<T>;
+/**
+ * Types of one step entry, inferred from its `code`. `Generic` is the kind's
+ * `TypesGeneric`, `Default` its bare `Types`. Falls back to `Generic` (the
+ * looseness of the erased `Init*` maps) for this entry alone when nothing is
+ * inferable (no typed `code`, a code-less hop, an untyped mock) or when
+ * `code` uses the bare default Types. Its siblings stay checked.
+ */
+type EntryTypes<X, Generic, Default> = X extends Generic ? IsExactly<X, Default> extends true ? Generic : X : Generic;
+/** The Types slots a step config reads: settings, mapping, setup, credentials. */
+type ConfigSlot = 'initSettings' | 'mapping' | 'setup' | 'credentials';
+/**
+ * A kind's Types as its `config` accepts them: every config slot the kind
+ * has also takes its widened form (`WidenConfig`), so a config declared in a
+ * separate variable compiles as it did before typing. Slots a kind lacks are
+ * simply absent, so one definition serves all kinds.
+ */
+type ConfigTypes<T> = {
+    [P in keyof T]: P extends ConfigSlot ? WidenConfig<T[P]> : T[P];
+};
+/**
+ * One typed step entry, from the kind's Init type for the entry's Types
+ * (`Typed`), for its `ConfigTypes` (`Configured`) and for its `TypesGeneric`
+ * (`Generic`): `code` and the routing keys come from `Typed`, `config` from
+ * `Configured`, and `env` offers `Typed`'s keys while still accepting every
+ * deep-partial mock that `Generic` accepts.
+ */
+type TypedStepEntry<Typed extends {
+    env?: unknown;
+}, Configured extends {
+    config?: unknown;
+}, Generic extends {
+    env?: unknown;
+}> = Omit<Typed, 'config' | 'env'> & {
+    config?: Configured['config'];
+    env?: Typed['env'] | Generic['env'];
+};
+
 /**
  * Base environment requirements interface for walkerOS destinations
  *
@@ -1204,6 +1305,12 @@ type Init$3<T extends TypesGeneric$3 = Types$4> = {
 interface InitDestinations {
     [key: string]: Init$3<any>;
 }
+/** One typed destination entry for `startFlow`; the rules are in `types/util.ts`. */
+type InitDestinationEntry<T extends TypesGeneric$3> = TypedStepEntry<Init$3<T>, Init$3<ConfigTypes<T>>, Init$3<TypesGeneric$3>>;
+/** Typed counterpart of `InitDestinations` for `startFlow`; the rules are in `types/util.ts`. */
+type InitDestinationsOf<D> = {
+    [K in keyof D]: InitDestinationEntry<EntryTypes<D[K], TypesGeneric$3, Types$4>>;
+};
 interface Destinations {
     [key: string]: Instance$5;
 }
@@ -1350,7 +1457,9 @@ type destination_DLQ = DLQ;
 type destination_Data = Data;
 type destination_Destinations = Destinations;
 type destination_EnvObserve = EnvObserve;
+type destination_InitDestinationEntry<T extends TypesGeneric$3> = InitDestinationEntry<T>;
 type destination_InitDestinations = InitDestinations;
+type destination_InitDestinationsOf<D> = InitDestinationsOf<D>;
 type destination_Policy = Policy;
 type destination_PushBatchContext<T extends TypesGeneric$3 = Types$4> = PushBatchContext<T>;
 type destination_PushBatchFn<T extends TypesGeneric$3 = Types$4> = PushBatchFn<T>;
@@ -1361,7 +1470,7 @@ type destination_PushFn<T extends TypesGeneric$3 = Types$4> = PushFn<T>;
 type destination_Ref = Ref;
 declare const destination_getDestination: typeof getDestination;
 declare namespace destination {
-  export { type BaseEnv$3 as BaseEnv, type destination_Batch as Batch, type destination_BatchEntry as BatchEntry, type destination_BatchFailure as BatchFailure, type destination_BatchOptions as BatchOptions, type destination_BatchOutcome as BatchOutcome, type destination_BatchRegistry as BatchRegistry, type destination_BreakerOptions as BreakerOptions, type Code$1 as Code, type Config$5 as Config, type Context$5 as Context, type Credentials$2 as Credentials, type destination_DLQ as DLQ, type destination_Data as Data, type destination_Destinations as Destinations, type Env$3 as Env, type destination_EnvObserve as EnvObserve, type Init$3 as Init, type destination_InitDestinations as InitDestinations, type InitFn$2 as InitFn, type InitSettings$3 as InitSettings, type Instance$5 as Instance, type Mapping$1 as Mapping, type PartialConfig$2 as PartialConfig, type destination_Policy as Policy, type Push$1 as Push, type destination_PushBatchContext as PushBatchContext, type destination_PushBatchFn as PushBatchFn, type destination_PushContext as PushContext, type destination_PushEvent as PushEvent, type destination_PushEvents as PushEvents, type destination_PushFn as PushFn, type destination_Ref as Ref, type Settings$3 as Settings, type SetupOptions$2 as SetupOptions, type Types$4 as Types, type TypesGeneric$3 as TypesGeneric, type TypesOf$3 as TypesOf, destination_getDestination as getDestination };
+  export { type BaseEnv$3 as BaseEnv, type destination_Batch as Batch, type destination_BatchEntry as BatchEntry, type destination_BatchFailure as BatchFailure, type destination_BatchOptions as BatchOptions, type destination_BatchOutcome as BatchOutcome, type destination_BatchRegistry as BatchRegistry, type destination_BreakerOptions as BreakerOptions, type Code$1 as Code, type Config$5 as Config, type Context$5 as Context, type Credentials$2 as Credentials, type destination_DLQ as DLQ, type destination_Data as Data, type destination_Destinations as Destinations, type Env$3 as Env, type destination_EnvObserve as EnvObserve, type Init$3 as Init, type destination_InitDestinationEntry as InitDestinationEntry, type destination_InitDestinations as InitDestinations, type destination_InitDestinationsOf as InitDestinationsOf, type InitFn$2 as InitFn, type InitSettings$3 as InitSettings, type Instance$5 as Instance, type Mapping$1 as Mapping, type PartialConfig$2 as PartialConfig, type destination_Policy as Policy, type Push$1 as Push, type destination_PushBatchContext as PushBatchContext, type destination_PushBatchFn as PushBatchFn, type destination_PushContext as PushContext, type destination_PushEvent as PushEvent, type destination_PushEvents as PushEvents, type destination_PushFn as PushFn, type destination_Ref as Ref, type Settings$3 as Settings, type SetupOptions$2 as SetupOptions, type Types$4 as Types, type TypesGeneric$3 as TypesGeneric, type TypesOf$3 as TypesOf, destination_getDestination as getDestination };
 }
 
 interface EventFn<R = Promise<PushResult>> {
@@ -1555,10 +1664,11 @@ interface Config$4<T extends TypesGeneric$2 = Types$3> {
      * when a rule has `ignore: true`).
      *
      * At the transformer position, only event-mutating fields apply:
-     * `policy`, `mapping[].policy`, `mapping[].name`, `mapping[].ignore`,
-     * `mapping[].consent`, `include`. Vendor-payload fields (`data`,
-     * `mapping[].data`, `silent`) are ignored at this position with a
-     * one-time warning.
+     * `policy`, and per rule `condition`, `policy`, `name` and `ignore`.
+     * Everything else does nothing here and is named in a one-time init
+     * warning: `consent`, `include` and `data`, and per rule `consent`,
+     * `include`, `remove`, `batch`, `settings`, `extend`, `data` and
+     * `silent`. A `config.mapping` wins over the step-level `mapping`.
      */
     mapping?: Config$7;
 }
@@ -1661,8 +1771,9 @@ type Init$2<T extends TypesGeneric$2 = Types$3> = (context: Context$4<Types$3<Pa
 type InitTransformer<T extends TypesGeneric$2 = Types$3> = {
     /**
      * Initialization function. When omitted, the entry is a pass-through step:
-     * - If `mapping` is present, the collector synthesizes a mapping-only
-     *   push using `processEventMapping`.
+     * - If `mapping` or `config.mapping` is present, the collector
+     *   synthesizes a mapping-only push using `processEventMapping`. With
+     *   `code`, a mapping never runs (warned at init).
      * - Otherwise it's a named hop that only hosts a `before` / `next` /
      *   `cache` chain.
      *
@@ -1686,6 +1797,12 @@ type InitTransformer<T extends TypesGeneric$2 = Types$3> = {
 interface InitTransformers {
     [transformerId: string]: InitTransformer<any>;
 }
+/** One typed transformer entry for `startFlow`; the rules are in `types/util.ts`. */
+type InitTransformerEntry<T extends TypesGeneric$2> = TypedStepEntry<InitTransformer<T>, InitTransformer<ConfigTypes<T>>, InitTransformer<TypesGeneric$2>>;
+/** Typed counterpart of `InitTransformers` for `startFlow`; the rules are in `types/util.ts`. */
+type InitTransformersOf<T> = {
+    [K in keyof T]: InitTransformerEntry<EntryTypes<T[K], TypesGeneric$2, Types$3>>;
+};
 /**
  * Active transformer instances registry.
  */
@@ -1715,7 +1832,9 @@ declare function getTransformer<T extends TypesGeneric$2 = Types$3>(collector: {
 type transformer_ChainCopy<E = DeepPartialEvent> = ChainCopy<E>;
 type transformer_ChainResult = ChainResult;
 type transformer_InitTransformer<T extends TypesGeneric$2 = Types$3> = InitTransformer<T>;
+type transformer_InitTransformerEntry<T extends TypesGeneric$2> = InitTransformerEntry<T>;
 type transformer_InitTransformers = InitTransformers;
+type transformer_InitTransformersOf<T> = InitTransformersOf<T>;
 type transformer_Route = Route;
 type transformer_RouteConfig = RouteConfig;
 type transformer_RouteGateConfig = RouteGateConfig;
@@ -1726,7 +1845,7 @@ type transformer_RouteStopConfig = RouteStopConfig;
 type transformer_Transformers = Transformers;
 declare const transformer_getTransformer: typeof getTransformer;
 declare namespace transformer {
-  export { type BaseEnv$2 as BaseEnv, type transformer_ChainCopy as ChainCopy, type transformer_ChainResult as ChainResult, type Config$4 as Config, type Context$4 as Context, type Env$2 as Env, type Fn$2 as Fn, type Init$2 as Init, type InitFn$1 as InitFn, type InitSettings$2 as InitSettings, type transformer_InitTransformer as InitTransformer, type transformer_InitTransformers as InitTransformers, type Instance$4 as Instance, type Result$1 as Result, type transformer_Route as Route, type transformer_RouteConfig as RouteConfig, type transformer_RouteGateConfig as RouteGateConfig, type transformer_RouteManyConfig as RouteManyConfig, type transformer_RouteNextConfig as RouteNextConfig, type transformer_RouteOneConfig as RouteOneConfig, type transformer_RouteStopConfig as RouteStopConfig, type Settings$2 as Settings, type transformer_Transformers as Transformers, type Types$3 as Types, type TypesGeneric$2 as TypesGeneric, type TypesOf$2 as TypesOf, transformer_getTransformer as getTransformer };
+  export { type BaseEnv$2 as BaseEnv, type transformer_ChainCopy as ChainCopy, type transformer_ChainResult as ChainResult, type Config$4 as Config, type Context$4 as Context, type Env$2 as Env, type Fn$2 as Fn, type Init$2 as Init, type InitFn$1 as InitFn, type InitSettings$2 as InitSettings, type transformer_InitTransformer as InitTransformer, type transformer_InitTransformerEntry as InitTransformerEntry, type transformer_InitTransformers as InitTransformers, type transformer_InitTransformersOf as InitTransformersOf, type Instance$4 as Instance, type Result$1 as Result, type transformer_Route as Route, type transformer_RouteConfig as RouteConfig, type transformer_RouteGateConfig as RouteGateConfig, type transformer_RouteManyConfig as RouteManyConfig, type transformer_RouteNextConfig as RouteNextConfig, type transformer_RouteOneConfig as RouteOneConfig, type transformer_RouteStopConfig as RouteStopConfig, type Settings$2 as Settings, type transformer_Transformers as Transformers, type Types$3 as Types, type TypesGeneric$2 as TypesGeneric, type TypesOf$2 as TypesOf, transformer_getTransformer as getTransformer };
 }
 
 /**
@@ -3004,6 +3123,12 @@ type InitSource<T extends TypesGeneric$1 = Types$1> = {
 interface InitSources {
     [sourceId: string]: InitSource<any>;
 }
+/** One typed source entry for `startFlow`; the rules are in `types/util.ts`. */
+type InitSourceEntry<T extends TypesGeneric$1> = TypedStepEntry<InitSource<T>, InitSource<ConfigTypes<T>>, InitSource<TypesGeneric$1>>;
+/** Typed counterpart of `InitSources` for `startFlow`; the rules are in `types/util.ts`. */
+type InitSourcesOf<S> = {
+    [K in keyof S]: InitSourceEntry<EntryTypes<S[K], TypesGeneric$1, Types$1>>;
+};
 /**
  * Renderer hint for source simulation UI.
  * - 'browser': Source needs a real DOM (iframe with live preview)
@@ -3032,7 +3157,9 @@ declare function getSource<T extends TypesGeneric$1 = Types$1>(collector: {
 }, id: string): Instance$2<T>;
 
 type source_InitSource<T extends TypesGeneric$1 = Types$1> = InitSource<T>;
+type source_InitSourceEntry<T extends TypesGeneric$1> = InitSourceEntry<T>;
 type source_InitSources = InitSources;
+type source_InitSourcesOf<S> = InitSourcesOf<S>;
 type source_Mapping<T extends TypesGeneric$1 = Types$1> = Mapping<T>;
 type source_Push<T extends TypesGeneric$1 = Types$1> = Push<T>;
 type source_Renderer = Renderer;
@@ -3040,7 +3167,7 @@ type source_Scope = Scope;
 type source_ScopeEnv<T extends TypesGeneric$1 = Types$1> = ScopeEnv<T>;
 declare const source_getSource: typeof getSource;
 declare namespace source {
-  export { type BaseEnv$1 as BaseEnv, type Config$1 as Config, type Context$1 as Context, type Credentials$1 as Credentials, type Env$1 as Env, type Init$1 as Init, type InitSettings$1 as InitSettings, type source_InitSource as InitSource, type source_InitSources as InitSources, type Instance$2 as Instance, type source_Mapping as Mapping, type PartialConfig$1 as PartialConfig, type source_Push as Push, type source_Renderer as Renderer, type source_Scope as Scope, type source_ScopeEnv as ScopeEnv, type Settings$1 as Settings, type SetupOptions$1 as SetupOptions, type Types$1 as Types, type TypesGeneric$1 as TypesGeneric, type TypesOf$1 as TypesOf, source_getSource as getSource };
+  export { type BaseEnv$1 as BaseEnv, type Config$1 as Config, type Context$1 as Context, type Credentials$1 as Credentials, type Env$1 as Env, type Init$1 as Init, type InitSettings$1 as InitSettings, type source_InitSource as InitSource, type source_InitSourceEntry as InitSourceEntry, type source_InitSources as InitSources, type source_InitSourcesOf as InitSourcesOf, type Instance$2 as Instance, type source_Mapping as Mapping, type PartialConfig$1 as PartialConfig, type source_Push as Push, type source_Renderer as Renderer, type source_Scope as Scope, type source_ScopeEnv as ScopeEnv, type Settings$1 as Settings, type SetupOptions$1 as SetupOptions, type Types$1 as Types, type TypesGeneric$1 as TypesGeneric, type TypesOf$1 as TypesOf, source_getSource as getSource };
 }
 
 interface BaseEnv {
@@ -3134,6 +3261,12 @@ type InitStore<T extends TypesGeneric = Types> = {
 interface InitStores {
     [storeId: string]: InitStore<any>;
 }
+/** One typed store entry for `startFlow`; the rules are in `types/util.ts`. */
+type InitStoreEntry<T extends TypesGeneric> = TypedStepEntry<InitStore<T>, InitStore<ConfigTypes<T>>, InitStore<TypesGeneric>>;
+/** Typed counterpart of `InitStores` for `startFlow`; the rules are in `types/util.ts`. */
+type InitStoresOf<St> = {
+    [K in keyof St]: InitStoreEntry<EntryTypes<St[K], TypesGeneric, Types>>;
+};
 interface Stores {
     [storeId: string]: Instance$1;
 }
@@ -3178,7 +3311,9 @@ type store_Init<T extends TypesGeneric = Types> = Init<T>;
 type store_InitFn<T extends TypesGeneric = Types> = InitFn<T>;
 type store_InitSettings<T extends TypesGeneric = Types> = InitSettings<T>;
 type store_InitStore<T extends TypesGeneric = Types> = InitStore<T>;
+type store_InitStoreEntry<T extends TypesGeneric> = InitStoreEntry<T>;
 type store_InitStores = InitStores;
+type store_InitStoresOf<St> = InitStoresOf<St>;
 type store_PartialConfig<T extends TypesGeneric = Types> = PartialConfig<T>;
 type store_SetFn<T extends StoreValue = StoreValue> = SetFn<T>;
 type store_Settings<T extends TypesGeneric = Types> = Settings<T>;
@@ -3191,7 +3326,7 @@ type store_TypesOf<I> = TypesOf<I>;
 declare const store_getStore: typeof getStore;
 declare const store_getStoreValue: typeof getStoreValue;
 declare namespace store {
-  export { type store_BaseEnv as BaseEnv, type store_Config as Config, type store_Context as Context, type store_Credentials as Credentials, type store_DeleteFn as DeleteFn, type store_Env as Env, type store_GetFn as GetFn, type store_Init as Init, type store_InitFn as InitFn, type store_InitSettings as InitSettings, type store_InitStore as InitStore, type store_InitStores as InitStores, type Instance$1 as Instance, type store_PartialConfig as PartialConfig, type store_SetFn as SetFn, type store_Settings as Settings, type store_SetupOptions as SetupOptions, type store_StoreValue as StoreValue, type store_Stores as Stores, type store_Types as Types, type store_TypesGeneric as TypesGeneric, type store_TypesOf as TypesOf, store_getStore as getStore, store_getStoreValue as getStoreValue };
+  export { type store_BaseEnv as BaseEnv, type store_Config as Config, type store_Context as Context, type store_Credentials as Credentials, type store_DeleteFn as DeleteFn, type store_Env as Env, type store_GetFn as GetFn, type store_Init as Init, type store_InitFn as InitFn, type store_InitSettings as InitSettings, type store_InitStore as InitStore, type store_InitStoreEntry as InitStoreEntry, type store_InitStores as InitStores, type store_InitStoresOf as InitStoresOf, type Instance$1 as Instance, type store_PartialConfig as PartialConfig, type store_SetFn as SetFn, type store_Settings as Settings, type store_SetupOptions as SetupOptions, type store_StoreValue as StoreValue, type store_Stores as Stores, type store_Types as Types, type store_TypesGeneric as TypesGeneric, type store_TypesOf as TypesOf, store_getStore as getStore, store_getStoreValue as getStoreValue };
 }
 
 /**
@@ -4299,6 +4434,13 @@ declare function isElementOrDocument(elem: unknown): elem is Element;
  * @returns True if the value is a function, false otherwise.
  */
 declare function isFunction(value: unknown): value is Function;
+/**
+ * Checks if a value is a thenable (a promise, from any realm).
+ *
+ * @param value The value to check.
+ * @returns True if the value is an object with a callable `then`.
+ */
+declare function isThenable(value: unknown): value is PromiseLike<unknown>;
 /**
  * Checks if a value is a number.
  *
@@ -4364,7 +4506,7 @@ declare function createLogger(config?: Config$3): Instance$3;
  *
  * @param event The event to get the mapping for (can be partial or full).
  * @param mapping The mapping rules.
- * @param collector Required to evaluate rule-level conditions against the unified Context. Legacy callers may omit; rule-level conditions then run with `undefined as never` (defensive).
+ * @param collector Required to evaluate rule-level conditions against the unified Context. Legacy callers may omit; rule-level conditions then run without a context and a throw propagates (defensive).
  * @returns The mapping result.
  */
 declare function getMappingEvent(event: DeepPartialEvent | PartialEvent | Event, mapping?: Rules, collector?: Instance$6): Promise<Result$2>;
@@ -5385,6 +5527,11 @@ interface ObservedEnv<T extends object = Record<string, unknown>> {
  */
 declare function observeEnv<T extends object = Record<string, unknown>>(env: T, paths: string[], record?: EnvObserve['record']): ObservedEnv<T>;
 
+/**
+ * A successful MCP tool result. `structuredContent` is always an object and
+ * the text block is the same object serialized, so a client reading either
+ * one sees the same answer. Hints are attached as `_hints`.
+ */
 declare function mcpResult(result: unknown, hints?: {
     next?: string[];
     warnings?: string[];
@@ -6030,6 +6177,35 @@ interface StepEntryValidation {
 declare function validateStepEntry(entry: Record<string, unknown>, kind: Flow.StepKind): StepEntryValidation;
 declare function isPathStepEntry(entry: Record<string, unknown>, kind: Flow.StepKind): boolean;
 
+/**
+ * A transformer entry as far as its declarative mapping is concerned: a
+ * runtime init entry (`Transformer.InitTransformer`) or a flow step
+ * (`Flow.Transformer`, whose `config` the caller narrows to an object).
+ */
+interface TransformerMappingEntry<M = unknown> {
+    code?: unknown;
+    package?: unknown;
+    mapping?: M;
+    config?: {
+        mapping?: M;
+    };
+}
+/**
+ * The mapping a transformer step declares. A `config.mapping` wins over the
+ * step-level `mapping`, as `config.state` wins over `state`.
+ */
+declare function getTransformerMapping<M>(entry: TransformerMappingEntry<M>): M | undefined;
+/**
+ * Warnings for a transformer's declarative mapping, one definition for the
+ * collector's init warning and `validateFlowStructure`. They never reject
+ * the entry: a rejected transformer would be skipped whole.
+ *
+ * - A transformer with `code` or `package` never runs its mapping.
+ * - On a code-less transformer, a step-level `mapping` that `config.mapping`
+ *   overrides, and fields that do nothing at this position.
+ */
+declare function getTransformerMappingWarnings(entry: TransformerMappingEntry): string[];
+
 type StepOut = Flow.StepOut;
 /**
  * Format a step example's `out` as readable code for docs/app rendering.
@@ -6075,4 +6251,4 @@ declare const REF_CODE_PREFIX = "$code:";
  */
 declare function scanFlowRefs(value: unknown, into?: Set<string>): Set<string>;
 
-export { type ActivationGrant, type AssembleJourneysOptions, type BatchResponse, type BatchedPosterOptions, type BreakerState, type BuildFlag, CLOCK_SKEW_MS, cache as Cache, type CacheEnvelope, type CacheResult, type ChainContinuation, type ChainFrame, type ChainStep, type ClickIdEntry, collector as Collector, type CompiledCache, Const, context as Context, type Credential, type Debounced, destination as Destination, type DestroyContext, type DestroyFn, type DroppedCounters, ENV_MARKER_PREFIX, elb as Elb, type EmitFn, type EventOutcome, type ExampleSummary, FatalError, Flow, type FlowConfigResolver, FlowCycleError, FlowReferenceError, type FlowState, type FlowStateBatch, type FlowStatePhase, type FlowStepType, type GetStore, hint as Hint, hooks as Hooks, type Ingest, type IngestEnvelope, type IngestMeta, InvalidEventError, type Journey, type JourneyAssembly, type JourneyBranch, type JourneyCorrelation, type JourneyEntry, type JourneyGap, type JourneyHop, type JourneyHopStatus, type JourneyPlatform, type JourneyStatus, type JourneyTopology, type JourneyTopologyNode, type JourneyUnattributed, type JsonSchema, Level, lifecycle as Lifecycle, type LifecycleContext, logger as Logger, MAX_SESSION_MS, mapping as Mapping, type MarketingParameters, matcher as Matcher, type MockLogger, type NextSteps, type NodeLikeRequest, OBSERVE_ENV_KEY, OBSERVE_STORAGE_KEY, type Observe, type ObserveCredential, type ObserveServer, type ObserveWeb, type ObservedEnv, type ObserverFn, on as On, type ParsedGrant, type ParsedTraceparent, type PosterFetch, type PosterResponse, type PreviewCrypto, type PreviewFailure, type PreviewKey, type PreviewSubtle, REF_CODE_PREFIX, REF_CONTRACT, REF_ENV, REF_FLOW, REF_SECRET, REF_STORE, REF_VAR_FULL, REF_VAR_INLINE, RESERVED_WINDOW_GLOBALS, request as Request, type ResolveContractsOptions, type ResolveOptions, type RespondFn, type RespondOptions, type RouteContinuation, type RouteDecision, type RouteGraphNode, type RouteLabel, SECRET_MARKER_PREFIX, SESSION_STORAGE_KEY, STEP_FIELD_ROLES, STEP_OPERATIVE_FIELDS, type ScheduleOptions, type SendDataValue, type SendHeaders, type SendResponse, type ServiceAccount, type SetupFn, simulation as Simulation, source as Source, type State, type StepEntryErrorCode, type StepEntryValidation, type StepField, type StepFieldRole, type StepKind, type StorageType, store as Store, StoreCodecError, type SwapActivatorConfig, type TelemetryLevel, type TelemetryOptions, type TelemetryOptionsSupplier, type Timer, transformer as Transformer, trigger as Trigger, URL_WINDOW_MS, type ValidateEvents, type VerifyParams, type VerifyResult, walkeros as WalkerOS, type WalkerOSPackage, type WalkerOSPackageInfo, type WalkerOSPackageMeta, type WindowCollectorCheck, advanceChain, anonymizeIP, applyState, applyUpdate, assembleJourneys, assign, batchResponse, branch, browserSwapActivator, buildScopeFromNodeRequest, castToProperty, castValue, checkCache, checkWindowCollector, clone, compileCache, compileMatcher, compileState, createBatchedPoster, createDestination, createEvent, createIngest, createLogger, createMappingRoot, createMockContext, createMockLogger, createRespond, createTelemetryObserver, createTimer, debounce, deepMerge, defaultClickIds, deleteByPath, deriveSpanId, deserializeStoreValue, emitStep, fetchPackage, fetchPackageSchema, filterValues, flattenIncludeSections, formatOut, getBrowser, getBrowserVersion, getByPath, getDeviceType, getErrorMessage, getEvent, getFlowSettings, getGrantedConsent, getHeaders, getId, getMappingEvent, getMappingValue, getMarketingParameters, getNextSteps, getOS, getOSVersion, getPlatform, getRouteGraph, getSpanId, getStepFieldRole, getStepRuntimeProps, getTraceId, getTraceUntil, isArguments, isArray, isBatchBody, isBoolean, isChainContinuation, isCommand, isDefined, isElementOrDocument, isEnvObserve, isFunction, isNumber, isObject, isPathStepEntry, isPropertyType, isRouteArray, isRouteConfigEntry, isRouteContinuation, isSameType, isSampled, isScope, isStoreValue, isString, mcpError, mcpResult, mergeContractSchemas, mergeMappingRule, mockEnv, normalizeBody, normalizeHeaders, normalizeQuery, observeEnv, observeFromEnv, packageNameToVariable, parseCallPath, parseGrant, parseObserveCredential, parseTraceparent, parseUserAgent, processEventMapping, pushResultToOutcome, readCacheEnvelope, requestToData, requestToParameter, resolveContracts, resolveSetup, resolveTelemetryOptions, scanFlowRefs, serializeStoreValue, setByPath, setTraceUntil, startChain, stepId, storeCache, throttle, throwError, toEventList, transformData, traverseEnv, trim, tryCatch, tryCatchAsync, useHooks, validateStepEntry, verifyActivation, walkPath, wrapCacheEnvelope, wrapCondition, wrapFn, wrapValidate };
+export { type ActivationGrant, type AssembleJourneysOptions, type BatchResponse, type BatchedPosterOptions, type BreakerState, type BuildFlag, CLOCK_SKEW_MS, cache as Cache, type CacheEnvelope, type CacheResult, type ChainContinuation, type ChainFrame, type ChainStep, type ClickIdEntry, collector as Collector, type CompiledCache, Const, context as Context, type Credential, type Debounced, destination as Destination, type DestroyContext, type DestroyFn, type DroppedCounters, ENV_MARKER_PREFIX, elb as Elb, type EmitFn, type EventOutcome, type ExampleSummary, FatalError, Flow, type FlowConfigResolver, FlowCycleError, FlowReferenceError, type FlowState, type FlowStateBatch, type FlowStatePhase, type FlowStepType, type GetStore, hint as Hint, hooks as Hooks, type Ingest, type IngestEnvelope, type IngestMeta, InvalidEventError, type Journey, type JourneyAssembly, type JourneyBranch, type JourneyCorrelation, type JourneyEntry, type JourneyGap, type JourneyHop, type JourneyHopStatus, type JourneyPlatform, type JourneyStatus, type JourneyTopology, type JourneyTopologyNode, type JourneyUnattributed, type JsonSchema, Level, lifecycle as Lifecycle, type LifecycleContext, logger as Logger, MAX_SESSION_MS, mapping as Mapping, type MarketingParameters, matcher as Matcher, type MockLogger, type NextSteps, type NodeLikeRequest, OBSERVE_ENV_KEY, OBSERVE_STORAGE_KEY, type Observe, type ObserveCredential, type ObserveServer, type ObserveWeb, type ObservedEnv, type ObserverFn, on as On, type ParsedGrant, type ParsedTraceparent, type PosterFetch, type PosterResponse, type PreviewCrypto, type PreviewFailure, type PreviewKey, type PreviewSubtle, REF_CODE_PREFIX, REF_CONTRACT, REF_ENV, REF_FLOW, REF_SECRET, REF_STORE, REF_VAR_FULL, REF_VAR_INLINE, RESERVED_WINDOW_GLOBALS, request as Request, type ResolveContractsOptions, type ResolveOptions, type RespondFn, type RespondOptions, type RouteContinuation, type RouteDecision, type RouteGraphNode, type RouteLabel, SECRET_MARKER_PREFIX, SESSION_STORAGE_KEY, STEP_FIELD_ROLES, STEP_OPERATIVE_FIELDS, type ScheduleOptions, type SendDataValue, type SendHeaders, type SendResponse, type ServiceAccount, type SetupFn, simulation as Simulation, source as Source, type State, type StepEntryErrorCode, type StepEntryValidation, type StepField, type StepFieldRole, type StepKind, type StorageType, store as Store, StoreCodecError, type SwapActivatorConfig, type TelemetryLevel, type TelemetryOptions, type TelemetryOptionsSupplier, type Timer, transformer as Transformer, type TransformerMappingEntry, trigger as Trigger, URL_WINDOW_MS, type ValidateEvents, type VerifyParams, type VerifyResult, walkeros as WalkerOS, type WalkerOSPackage, type WalkerOSPackageInfo, type WalkerOSPackageMeta, type WindowCollectorCheck, advanceChain, anonymizeIP, applyState, applyUpdate, assembleJourneys, assign, batchResponse, branch, browserSwapActivator, buildScopeFromNodeRequest, castToProperty, castValue, checkCache, checkWindowCollector, clone, compileCache, compileMatcher, compileState, createBatchedPoster, createDestination, createEvent, createIngest, createLogger, createMappingRoot, createMockContext, createMockLogger, createRespond, createTelemetryObserver, createTimer, debounce, deepMerge, defaultClickIds, deleteByPath, deriveSpanId, deserializeStoreValue, emitStep, fetchPackage, fetchPackageSchema, filterValues, flattenIncludeSections, formatOut, getBrowser, getBrowserVersion, getByPath, getDeviceType, getErrorMessage, getEvent, getFlowSettings, getGrantedConsent, getHeaders, getId, getMappingEvent, getMappingValue, getMarketingParameters, getNextSteps, getOS, getOSVersion, getPlatform, getRouteGraph, getSpanId, getStepFieldRole, getStepRuntimeProps, getTraceId, getTraceUntil, getTransformerMapping, getTransformerMappingWarnings, isArguments, isArray, isBatchBody, isBoolean, isChainContinuation, isCommand, isDefined, isElementOrDocument, isEnvObserve, isFunction, isNumber, isObject, isPathStepEntry, isPropertyType, isRouteArray, isRouteConfigEntry, isRouteContinuation, isSameType, isSampled, isScope, isStoreValue, isString, isThenable, mcpError, mcpResult, mergeContractSchemas, mergeMappingRule, mockEnv, normalizeBody, normalizeHeaders, normalizeQuery, observeEnv, observeFromEnv, packageNameToVariable, parseCallPath, parseGrant, parseObserveCredential, parseTraceparent, parseUserAgent, processEventMapping, pushResultToOutcome, readCacheEnvelope, requestToData, requestToParameter, resolveContracts, resolveSetup, resolveTelemetryOptions, scanFlowRefs, serializeStoreValue, setByPath, setTraceUntil, startChain, stepId, storeCache, throttle, throwError, toEventList, transformData, traverseEnv, trim, tryCatch, tryCatchAsync, useHooks, validateStepEntry, verifyActivation, walkPath, wrapCacheEnvelope, wrapCondition, wrapFn, wrapValidate };