@walkeros/core 4.7.0-next-1790722899482 → 4.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -892,6 +892,13 @@ interface State {
892
892
  * validation requires it for get/set.
893
893
  */
894
894
  value?: Value;
895
+ /**
896
+ * Shapes the value read (get) or the resolved payload (set) with a full
897
+ * mapping value. Paths are relative to that value, not to { event, ingest }.
898
+ * The result merges into the target: get into the `value` path, set into
899
+ * the stored entry. Runs on a miss too, so declared fallbacks apply.
900
+ */
901
+ mapping?: Value;
895
902
  }
896
903
 
897
904
  /**
@@ -1078,6 +1085,9 @@ interface Config$5<T extends TypesGeneric$3 = Types$4> {
1078
1085
  /**
1079
1086
  * Per-destination delivery timeout in ms (default 10000); a delivery that
1080
1087
  * does not settle within this window is routed to the DLQ like a thrown push.
1088
+ * Also bounds an `on()` handler: a state handler that does not settle within
1089
+ * the window is logged, and the destination is held (its events stay queued)
1090
+ * until a later state delivery to it settles.
1081
1091
  */
1082
1092
  timeout?: number;
1083
1093
  /** Return this value instead of calling push(). Uses !== undefined check to support falsy values. */
@@ -1887,7 +1897,8 @@ declare namespace Flow {
1887
1897
  /**
1888
1898
  * Arbitrary key-value settings consumed by the platform runtime.
1889
1899
  *
1890
- * For web: typical keys include `windowCollector`.
1900
+ * For web: `windowCollector` names the global the collector instance is
1901
+ * assigned to (default `walkerOS`); it must be a JavaScript identifier.
1891
1902
  * For server: reserved for future server-specific options.
1892
1903
  *
1893
1904
  * The `windowElb` key is deprecated: the browser source is the single writer
@@ -2643,6 +2654,9 @@ interface OnConfig {
2643
2654
  /**
2644
2655
  * Destination `on` handler: receives the action type and a destination context.
2645
2656
  * Already context-style; kept for compatibility with the destination interface.
2657
+ * The collector awaits the returned promise and bounds the wait by
2658
+ * `Destination.Config.timeout`; the handler's effects therefore land before
2659
+ * the destination's next push.
2646
2660
  */
2647
2661
  type OnFn<T extends TypesGeneric$3 = Types$4> = (type: Types$2, context: Context$5<T>) => PromiseOrValue<void>;
2648
2662
  type OnFnRuntime = (type: Types$2, context: Context$5) => PromiseOrValue<void>;
@@ -3816,6 +3830,18 @@ declare class FlowReferenceError extends Error {
3816
3830
  readonly reference: string;
3817
3831
  constructor(code: 'MISSING_ENV' | 'WEB_SECRET_REF', reference: string, message: string);
3818
3832
  }
3833
+ /**
3834
+ * A reference cycle the resolver cannot break. Carries a code and the chain
3835
+ * of names, so tooling can report it structurally instead of matching text.
3836
+ * - `FLOW_CYCLE`: `$flow` references that reach a flow already being
3837
+ * resolved (the entry flow included, so a flow reading itself cycles).
3838
+ * - `VAR_CYCLE`: `$var` values that reference each other.
3839
+ */
3840
+ declare class FlowCycleError extends Error {
3841
+ readonly code: 'FLOW_CYCLE' | 'VAR_CYCLE';
3842
+ readonly chain: string[];
3843
+ constructor(code: 'FLOW_CYCLE' | 'VAR_CYCLE', chain: string[]);
3844
+ }
3819
3845
  /** Sentinel prefix for deferred $env resolution. Shared with CLI bundler. */
3820
3846
  declare const ENV_MARKER_PREFIX = "__WALKEROS_ENV:";
3821
3847
  /** Sentinel prefix for deferred $secret resolution. Shared with CLI bundler. */
@@ -5090,6 +5116,25 @@ declare function getOSVersion(userAgent: string): string | undefined;
5090
5116
  */
5091
5117
  declare function getDeviceType(userAgent: string): string | undefined;
5092
5118
 
5119
+ /**
5120
+ * Globals the collector must never replace: the page's own and walkerOS's.
5121
+ */
5122
+ declare const RESERVED_WINDOW_GLOBALS: readonly string[];
5123
+ type WindowCollectorCheck = {
5124
+ ok: true;
5125
+ name: string;
5126
+ } | {
5127
+ ok: false;
5128
+ reason: string;
5129
+ };
5130
+ /**
5131
+ * Check a resolved `config.settings.windowCollector` value: the global a web
5132
+ * bundle assigns the collector to. It must be a JavaScript identifier (it is
5133
+ * interpolated into generated code) and must not replace a reserved global.
5134
+ * The `reason` completes a sentence about the value ("is not ...").
5135
+ */
5136
+ declare function checkWindowCollector(value: unknown): WindowCollectorCheck;
5137
+
5093
5138
  /**
5094
5139
  * Inline Code Wrapping Utilities
5095
5140
  *
@@ -5195,6 +5240,14 @@ interface WalkerOSPackage extends WalkerOSPackageInfo {
5195
5240
  * that ship several exports; `examples` then holds the default export's.
5196
5241
  */
5197
5242
  exportExamples?: Record<string, unknown>;
5243
+ /**
5244
+ * Schemas per export, keyed by export name, each entry shaped like
5245
+ * `schemas` of a single-export package (`settings`, `mapping`, `setup`).
5246
+ * Present only for packages that ship several exports.
5247
+ */
5248
+ exportSchemas?: Record<string, Record<string, unknown>>;
5249
+ /** Declared exports (name to description) from `$meta.exports`. */
5250
+ exports?: Record<string, string>;
5198
5251
  }
5199
5252
  declare function fetchPackage(packageName: string, options?: {
5200
5253
  version?: string;
@@ -5844,9 +5897,19 @@ declare function compileState(state: State | State[]): State[];
5844
5897
  * by every event in the scope, so at a fan-out it loses per-event
5845
5898
  * attribution. `set` writes the resolved value to the store.
5846
5899
  *
5900
+ * `mapping` shapes the value read (get) or the payload (set) with paths
5901
+ * relative to that value. It runs on a miss too, so declared fallbacks apply;
5902
+ * an empty result writes nothing. An object result merges into an object
5903
+ * target (get: the `value` path, set: the stored entry), anything else
5904
+ * replaces it. The set merge reads then writes, it is not atomic. Consent
5905
+ * gates on the event's consent, not on a stored `consent` key. Exception:
5906
+ * a `loop` item is mapped like any loop item, so a `consent` key on the item
5907
+ * itself gates that item's mapping.
5908
+ *
5847
5909
  * Each entry is fail-open: a store or resolution error is logged and the
5848
- * event is left unmutated, the chain continues. A key that does not resolve
5849
- * warns; a store miss is silent. Only `FatalError` rethrows (via
5910
+ * event is left unmutated, the chain continues. An unknown store logs an
5911
+ * error and a `file: true` store is skipped with a warning. A key that does
5912
+ * not resolve warns; a store miss is silent. Only `FatalError` rethrows (via
5850
5913
  * `getMappingValue`).
5851
5914
  */
5852
5915
  declare function applyState<E extends DeepPartialEvent>(states: State[], getStore: GetStore, event: E, collector: Instance$6, ingest: Record<string, unknown> | undefined): Promise<E>;
@@ -5978,4 +6041,4 @@ declare const REF_CODE_PREFIX = "$code:";
5978
6041
  */
5979
6042
  declare function scanFlowRefs(value: unknown, into?: Set<string>): Set<string>;
5980
6043
 
5981
- export { type ActivationGrant, type AssembleJourneysOptions, type BatchResponse, type BatchedPosterOptions, type BreakerState, 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, 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, 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, advanceChain, anonymizeIP, applyState, applyUpdate, assembleJourneys, assign, batchResponse, branch, browserSwapActivator, buildScopeFromNodeRequest, castToProperty, castValue, checkCache, 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 };
6044
+ export { type ActivationGrant, type AssembleJourneysOptions, type BatchResponse, type BatchedPosterOptions, type BreakerState, 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 };
package/dist/index.d.ts CHANGED
@@ -892,6 +892,13 @@ interface State {
892
892
  * validation requires it for get/set.
893
893
  */
894
894
  value?: Value;
895
+ /**
896
+ * Shapes the value read (get) or the resolved payload (set) with a full
897
+ * mapping value. Paths are relative to that value, not to { event, ingest }.
898
+ * The result merges into the target: get into the `value` path, set into
899
+ * the stored entry. Runs on a miss too, so declared fallbacks apply.
900
+ */
901
+ mapping?: Value;
895
902
  }
896
903
 
897
904
  /**
@@ -1078,6 +1085,9 @@ interface Config$5<T extends TypesGeneric$3 = Types$4> {
1078
1085
  /**
1079
1086
  * Per-destination delivery timeout in ms (default 10000); a delivery that
1080
1087
  * does not settle within this window is routed to the DLQ like a thrown push.
1088
+ * Also bounds an `on()` handler: a state handler that does not settle within
1089
+ * the window is logged, and the destination is held (its events stay queued)
1090
+ * until a later state delivery to it settles.
1081
1091
  */
1082
1092
  timeout?: number;
1083
1093
  /** Return this value instead of calling push(). Uses !== undefined check to support falsy values. */
@@ -1887,7 +1897,8 @@ declare namespace Flow {
1887
1897
  /**
1888
1898
  * Arbitrary key-value settings consumed by the platform runtime.
1889
1899
  *
1890
- * For web: typical keys include `windowCollector`.
1900
+ * For web: `windowCollector` names the global the collector instance is
1901
+ * assigned to (default `walkerOS`); it must be a JavaScript identifier.
1891
1902
  * For server: reserved for future server-specific options.
1892
1903
  *
1893
1904
  * The `windowElb` key is deprecated: the browser source is the single writer
@@ -2643,6 +2654,9 @@ interface OnConfig {
2643
2654
  /**
2644
2655
  * Destination `on` handler: receives the action type and a destination context.
2645
2656
  * Already context-style; kept for compatibility with the destination interface.
2657
+ * The collector awaits the returned promise and bounds the wait by
2658
+ * `Destination.Config.timeout`; the handler's effects therefore land before
2659
+ * the destination's next push.
2646
2660
  */
2647
2661
  type OnFn<T extends TypesGeneric$3 = Types$4> = (type: Types$2, context: Context$5<T>) => PromiseOrValue<void>;
2648
2662
  type OnFnRuntime = (type: Types$2, context: Context$5) => PromiseOrValue<void>;
@@ -3816,6 +3830,18 @@ declare class FlowReferenceError extends Error {
3816
3830
  readonly reference: string;
3817
3831
  constructor(code: 'MISSING_ENV' | 'WEB_SECRET_REF', reference: string, message: string);
3818
3832
  }
3833
+ /**
3834
+ * A reference cycle the resolver cannot break. Carries a code and the chain
3835
+ * of names, so tooling can report it structurally instead of matching text.
3836
+ * - `FLOW_CYCLE`: `$flow` references that reach a flow already being
3837
+ * resolved (the entry flow included, so a flow reading itself cycles).
3838
+ * - `VAR_CYCLE`: `$var` values that reference each other.
3839
+ */
3840
+ declare class FlowCycleError extends Error {
3841
+ readonly code: 'FLOW_CYCLE' | 'VAR_CYCLE';
3842
+ readonly chain: string[];
3843
+ constructor(code: 'FLOW_CYCLE' | 'VAR_CYCLE', chain: string[]);
3844
+ }
3819
3845
  /** Sentinel prefix for deferred $env resolution. Shared with CLI bundler. */
3820
3846
  declare const ENV_MARKER_PREFIX = "__WALKEROS_ENV:";
3821
3847
  /** Sentinel prefix for deferred $secret resolution. Shared with CLI bundler. */
@@ -5090,6 +5116,25 @@ declare function getOSVersion(userAgent: string): string | undefined;
5090
5116
  */
5091
5117
  declare function getDeviceType(userAgent: string): string | undefined;
5092
5118
 
5119
+ /**
5120
+ * Globals the collector must never replace: the page's own and walkerOS's.
5121
+ */
5122
+ declare const RESERVED_WINDOW_GLOBALS: readonly string[];
5123
+ type WindowCollectorCheck = {
5124
+ ok: true;
5125
+ name: string;
5126
+ } | {
5127
+ ok: false;
5128
+ reason: string;
5129
+ };
5130
+ /**
5131
+ * Check a resolved `config.settings.windowCollector` value: the global a web
5132
+ * bundle assigns the collector to. It must be a JavaScript identifier (it is
5133
+ * interpolated into generated code) and must not replace a reserved global.
5134
+ * The `reason` completes a sentence about the value ("is not ...").
5135
+ */
5136
+ declare function checkWindowCollector(value: unknown): WindowCollectorCheck;
5137
+
5093
5138
  /**
5094
5139
  * Inline Code Wrapping Utilities
5095
5140
  *
@@ -5195,6 +5240,14 @@ interface WalkerOSPackage extends WalkerOSPackageInfo {
5195
5240
  * that ship several exports; `examples` then holds the default export's.
5196
5241
  */
5197
5242
  exportExamples?: Record<string, unknown>;
5243
+ /**
5244
+ * Schemas per export, keyed by export name, each entry shaped like
5245
+ * `schemas` of a single-export package (`settings`, `mapping`, `setup`).
5246
+ * Present only for packages that ship several exports.
5247
+ */
5248
+ exportSchemas?: Record<string, Record<string, unknown>>;
5249
+ /** Declared exports (name to description) from `$meta.exports`. */
5250
+ exports?: Record<string, string>;
5198
5251
  }
5199
5252
  declare function fetchPackage(packageName: string, options?: {
5200
5253
  version?: string;
@@ -5844,9 +5897,19 @@ declare function compileState(state: State | State[]): State[];
5844
5897
  * by every event in the scope, so at a fan-out it loses per-event
5845
5898
  * attribution. `set` writes the resolved value to the store.
5846
5899
  *
5900
+ * `mapping` shapes the value read (get) or the payload (set) with paths
5901
+ * relative to that value. It runs on a miss too, so declared fallbacks apply;
5902
+ * an empty result writes nothing. An object result merges into an object
5903
+ * target (get: the `value` path, set: the stored entry), anything else
5904
+ * replaces it. The set merge reads then writes, it is not atomic. Consent
5905
+ * gates on the event's consent, not on a stored `consent` key. Exception:
5906
+ * a `loop` item is mapped like any loop item, so a `consent` key on the item
5907
+ * itself gates that item's mapping.
5908
+ *
5847
5909
  * Each entry is fail-open: a store or resolution error is logged and the
5848
- * event is left unmutated, the chain continues. A key that does not resolve
5849
- * warns; a store miss is silent. Only `FatalError` rethrows (via
5910
+ * event is left unmutated, the chain continues. An unknown store logs an
5911
+ * error and a `file: true` store is skipped with a warning. A key that does
5912
+ * not resolve warns; a store miss is silent. Only `FatalError` rethrows (via
5850
5913
  * `getMappingValue`).
5851
5914
  */
5852
5915
  declare function applyState<E extends DeepPartialEvent>(states: State[], getStore: GetStore, event: E, collector: Instance$6, ingest: Record<string, unknown> | undefined): Promise<E>;
@@ -5978,4 +6041,4 @@ declare const REF_CODE_PREFIX = "$code:";
5978
6041
  */
5979
6042
  declare function scanFlowRefs(value: unknown, into?: Set<string>): Set<string>;
5980
6043
 
5981
- export { type ActivationGrant, type AssembleJourneysOptions, type BatchResponse, type BatchedPosterOptions, type BreakerState, 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, 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, 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, advanceChain, anonymizeIP, applyState, applyUpdate, assembleJourneys, assign, batchResponse, branch, browserSwapActivator, buildScopeFromNodeRequest, castToProperty, castValue, checkCache, 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 };
6044
+ export { type ActivationGrant, type AssembleJourneysOptions, type BatchResponse, type BatchedPosterOptions, type BreakerState, 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 };