@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/CHANGELOG.md +38 -17
- package/dist/dev.d.mts +130 -9
- package/dist/dev.d.ts +130 -9
- package/dist/dev.js +1 -1
- package/dist/dev.js.map +1 -1
- package/dist/dev.mjs +1 -1
- package/dist/dev.mjs.map +1 -1
- package/dist/index.d.mts +67 -4
- package/dist/index.d.ts +67 -4
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +1 -1
- package/dist/index.mjs.map +1 -1
- package/dist/node.d.mts +11 -18
- package/dist/node.d.ts +11 -18
- package/dist/node.js +1 -1
- package/dist/node.js.map +1 -1
- package/dist/node.mjs +1 -1
- package/dist/node.mjs.map +1 -1
- package/package.json +1 -1
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:
|
|
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.
|
|
5849
|
-
*
|
|
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:
|
|
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.
|
|
5849
|
-
*
|
|
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 };
|