@walkeros/core 4.3.2 → 4.4.0-next-1785239495233

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @walkeros/core
 
+## 4.4.0-next-1785239495233
+
+### Minor Changes
+
+- 393b942: Journeys now assemble per event: one journey per event, identified by
+  that event's id, with the run trace carried as a handle so every event of one
+  page load or container run still groups together. A `$flow` crossing that
+  decodes into several events yields one journey per event, linked by
+  `parentEventId`, instead of folding them into a single row. A new optional
+  `unattributed` summary reports records the assembly could not attribute to any
+  event instead of dropping them silently.
+
+### Patch Changes
+
+- 6c89afb: Fixed journey assembly dropping records when several runtime
+  instances (page reloads, container restarts) reported overlapping sequence
+  numbers. Every instance's records now survive into journeys and gap detection
+  stays truthful. Each journey hop also carries the `release` of the runtime
+  that produced it.
+
 ## 4.3.2
 
 ## 4.3.1

package/dist/index.d.mts

@@ -3285,10 +3285,13 @@ interface SendResponse {
 }
 
 /**
- * Journey types describe the assembled, cross-runtime life of one traced event
- * as reconstructed from raw `FlowState` records by `assembleJourneys`. The
- * assembler is pure and presentation-free: no session scoping, no display copy,
- * no formatting. Presenters map a `Journey` into their own view shapes.
+ * Journey types describe the assembled, cross-runtime life of ONE EVENT as
+ * reconstructed from raw `FlowState` records by `assembleJourneys`. The unit is
+ * the event (`FlowState.eventId`, a W3C span id), not the run: a `traceId` is
+ * run-scoped and covers every event of a page load or container run, so it is
+ * carried as the run handle for optional grouping rather than as the identity.
+ * The assembler is pure and presentation-free: no session scoping, no display
+ * copy, no formatting. Presenters map a `Journey` into their own view shapes.
  *
  * Optional fields are populated only when the underlying records carry the
  * corresponding data (e.g. trace-level payloads, consent snapshots, vendor
@@ -3297,11 +3300,16 @@ interface SendResponse {
 /** Runtime that produced a hop: the non-empty subset of `FlowState.platform`. */
 type JourneyPlatform = 'web' | 'server';
 /**
- * How a journey's records were correlated into one journey. `trace` groups by
- * the shared `traceId`; `legacy` is the fallback for records that predate trace
- * propagation and are grouped by their `eventId` alone.
+ * How a journey's records were correlated into one journey. `event` is the only
+ * value the assembler produces: records group by their `eventId`, with $flow
+ * crossing continuations joined through `parentEventId`.
+ *
+ * @remarks `trace` (grouped by the run-scoped `traceId`) and `legacy` (grouped
+ * by `eventId` when no trace was propagated) are retained so envelopes
+ * serialized by older assemblers still type. Neither is produced any more; both
+ * are removal candidates in the next major.
  */
-type JourneyCorrelation = 'trace' | 'legacy';
+type JourneyCorrelation = 'event' | 'trace' | 'legacy';
 /**
  * Collapsed outcome of a single hop, derived from its terminal phase. `pending`
  * covers a hop still in `in`/`init`/`flush` (no terminal phase observed yet);
@@ -3359,7 +3367,13 @@ interface AssembleJourneysOptions {
     /** Wall-clock reference (epoch ms) for settle evaluation. Defaults to now. */
     now?: number;
 }
-/** The originating event of a journey, taken from its entry collector hop. */
+/**
+ * The originating event of a journey, taken from its entry collector hop.
+ * `eventId` always equals the journey's `id`, by construction: the entry is
+ * chosen from the originating arm's records alone, so a crossing's far arm can
+ * never supply it, and `name` therefore always describes the event the journey
+ * is named after rather than the far arm's rendering of it.
+ */
 interface JourneyEntry {
     /** Originating event's id (W3C span-id). */
     eventId: string;
@@ -3457,6 +3471,8 @@ interface JourneyHop {
      * non-terminal and is not a confirmation.
      */
     flushConfirmed?: boolean;
+    /** Release provenance of the runtime that produced this hop's records, when stamped. */
+    release?: string;
     /** Free-form metadata carried by the hop's records. */
     meta?: Record<string, unknown>;
 }
@@ -3480,13 +3496,42 @@ interface JourneyGap {
     /** First `seq` observed after the gap. */
     beforeSeq: number;
 }
+/**
+ * Records that carried a `traceId` (so they belonged to a real event run) but
+ * could not be attributed to any event, grouped per platform. Emitted by
+ * runtimes that predate the early span-id mint, whose `collector.push` records
+ * carry no event id. Records that carry no `traceId` (destination `init`, store
+ * lifecycle) belong to no event by design and are never counted here, so a
+ * nonzero value always means information was lost.
+ */
+interface JourneyUnattributed {
+    /** Poster runtime the records came from, when stamped. */
+    platform?: JourneyPlatform;
+    /** How many records were dropped from grouping. */
+    count: number;
+    /** Wall-clock lower bound of the dropped records (epoch ms). */
+    fromMs: number;
+    /** Wall-clock upper bound of the dropped records (epoch ms). */
+    toMs: number;
+    /** Distinct stepIds the dropped records came from, sorted. */
+    stepIds: string[];
+}
 /** One reconstructed event lifetime across the pipeline. */
 interface Journey {
-    /** `traceId` when trace-correlated, else `event:<eventId>`. */
+    /**
+     * The originating event's id (bare W3C span-id). For a $flow crossing, the
+     * id of the arm the crossing started from.
+     */
     id: string;
-    /** How the journey's records were correlated. */
+    /** How the journey's records were correlated. Always `event`. */
     correlation: JourneyCorrelation;
-    /** Shared trace id, when trace-correlated. */
+    /**
+     * Run handle of the originating arm: the run-scoped trace every event of one
+     * page load or container run shares. Presenters group rows by it; it is not
+     * the journey's identity. When the originating arm's records carry no trace
+     * (an emitter predating trace propagation), the first trace among the
+     * journey's remaining records stands in rather than dropping the handle.
+     */
     traceId?: string;
     /** Originating event of the journey. */
     entry: JourneyEntry;
@@ -3516,6 +3561,12 @@ interface JourneyAssembly {
     journeys: Journey[];
     /** Session-level per-platform loss windows. */
     gaps: JourneyGap[];
+    /**
+     * Records that belonged to an event run but could not be attributed to any
+     * event, per platform. Absent when there are none. Computed over every input
+     * record, so callers that cap `journeys` still report the full figure.
+     */
+    unattributed?: JourneyUnattributed[];
 }
 
 /**
@@ -4607,8 +4658,13 @@ declare const OBSERVE_STORAGE_KEY = "elbObserve";
 declare function browserSwapActivator(cfg: SwapActivatorConfig): Promise<boolean>;
 
 /**
- * Pure assembly of raw `FlowState` records into cross-runtime journeys. The
- * function is idempotent (duplicate records are deduped first) and
+ * Pure assembly of raw `FlowState` records into cross-runtime journeys, one per
+ * EVENT. Records group by their `eventId`; a `traceId` is run-scoped and covers
+ * every event of a page load or container run, so it is carried as the run
+ * handle rather than used to group. Records naming no event are excluded from
+ * grouping and reported in `unattributed` when they carried a run trace.
+ *
+ * The function is idempotent (duplicate records are deduped first) and
  * deterministic (output does not depend on input order; `options.now` supplies
  * the settle reference so tests never depend on the wall clock). It resolves
  * completeness (`pending`/`complete`/`partial`) against the settle window and,
@@ -5171,4 +5227,4 @@ declare const REF_CODE_PREFIX = "$code:";
  */
 declare function scanFlowRefs(value: unknown, into?: Set<string>): Set<string>;
 
-export { type ActivationGrant, type AssembleJourneysOptions, type BatchedPosterOptions, type BreakerState, CLOCK_SKEW_MS, cache as Cache, type CacheEnvelope, type CacheResult, 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 ExampleSummary, FatalError, Flow, type FlowConfigResolver, type FlowState, type FlowStateBatch, type FlowStatePhase, type FlowStepType, type GetStore, hint as Hint, hooks as Hooks, type Ingest, type IngestEnvelope, type IngestMeta, 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 JsonSchema, Level, lifecycle as Lifecycle, type LifecycleContext, logger as Logger, MAX_SESSION_MS, mapping as Mapping, type MarketingParameters, matcher as Matcher, type MockLogger, OBSERVE_ENV_KEY, OBSERVE_STORAGE_KEY, type Observe, type ObserveCredential, type ObserveServer, type ObserveWeb, 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, SECRET_MARKER_PREFIX, SESSION_STORAGE_KEY, 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 StepKind, type StorageType, store as Store, StoreCodecError, type SwapActivatorConfig, type TelemetryLevel, type TelemetryOptions, type TelemetryOptionsSupplier, transformer as Transformer, trigger as Trigger, URL_WINDOW_MS, type ValidateEvents, type VerifyParams, type VerifyResult, walkeros as WalkerOS, type WalkerOSPackage, type WalkerOSPackageInfo, type WalkerOSPackageMeta, anonymizeIP, applyState, applyUpdate, assembleJourneys, assign, branch, browserSwapActivator, buildCacheContext, castToProperty, castValue, checkCache, clone, compileCache, compileMatcher, compileState, createBatchedPoster, createDestination, createEvent, createIngest, createLogger, createMockContext, createMockLogger, createRespond, createTelemetryObserver, debounce, deepMerge, defaultClickIds, deleteByPath, deserializeStoreValue, emitStep, fetchPackage, fetchPackageSchema, filterValues, flattenIncludeSections, formatOut, getBrowser, getBrowserVersion, getByPath, getDeviceType, getEvent, getFlowSettings, getGrantedConsent, getHeaders, getId, getMappingEvent, getMappingValue, getMarketingParameters, getNextSteps, getOS, getOSVersion, getPlatform, getSpanId, getTraceId, getTraceUntil, isArguments, isArray, isBoolean, isCommand, isDefined, isElementOrDocument, isEnvObserve, isFunction, isNumber, isObject, isPathStepEntry, isPropertyType, isRouteArray, isRouteConfigEntry, isSameType, isSampled, isStoreValue, isString, mcpError, mcpResult, mergeContractSchemas, mergeMappingRule, mockEnv, observeFromEnv, packageNameToVariable, parseCallPath, parseGrant, parseObserveCredential, parseTraceparent, parseUserAgent, processEventMapping, readCacheEnvelope, requestToData, requestToParameter, resolveContracts, resolveSetup, resolveTelemetryOptions, scanFlowRefs, serializeStoreValue, setByPath, setTraceUntil, stepId, storeCache, throttle, throwError, transformData, traverseEnv, trim, tryCatch, tryCatchAsync, useHooks, validateStepEntry, verifyActivation, walkPath, wrapCacheEnvelope, wrapCondition, wrapFn, wrapValidate };
+export { type ActivationGrant, type AssembleJourneysOptions, type BatchedPosterOptions, type BreakerState, CLOCK_SKEW_MS, cache as Cache, type CacheEnvelope, type CacheResult, 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 ExampleSummary, FatalError, Flow, type FlowConfigResolver, type FlowState, type FlowStateBatch, type FlowStatePhase, type FlowStepType, type GetStore, hint as Hint, hooks as Hooks, type Ingest, type IngestEnvelope, type IngestMeta, 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, OBSERVE_ENV_KEY, OBSERVE_STORAGE_KEY, type Observe, type ObserveCredential, type ObserveServer, type ObserveWeb, 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, SECRET_MARKER_PREFIX, SESSION_STORAGE_KEY, 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 StepKind, type StorageType, store as Store, StoreCodecError, type SwapActivatorConfig, type TelemetryLevel, type TelemetryOptions, type TelemetryOptionsSupplier, transformer as Transformer, trigger as Trigger, URL_WINDOW_MS, type ValidateEvents, type VerifyParams, type VerifyResult, walkeros as WalkerOS, type WalkerOSPackage, type WalkerOSPackageInfo, type WalkerOSPackageMeta, anonymizeIP, applyState, applyUpdate, assembleJourneys, assign, branch, browserSwapActivator, buildCacheContext, castToProperty, castValue, checkCache, clone, compileCache, compileMatcher, compileState, createBatchedPoster, createDestination, createEvent, createIngest, createLogger, createMockContext, createMockLogger, createRespond, createTelemetryObserver, debounce, deepMerge, defaultClickIds, deleteByPath, deserializeStoreValue, emitStep, fetchPackage, fetchPackageSchema, filterValues, flattenIncludeSections, formatOut, getBrowser, getBrowserVersion, getByPath, getDeviceType, getEvent, getFlowSettings, getGrantedConsent, getHeaders, getId, getMappingEvent, getMappingValue, getMarketingParameters, getNextSteps, getOS, getOSVersion, getPlatform, getSpanId, getTraceId, getTraceUntil, isArguments, isArray, isBoolean, isCommand, isDefined, isElementOrDocument, isEnvObserve, isFunction, isNumber, isObject, isPathStepEntry, isPropertyType, isRouteArray, isRouteConfigEntry, isSameType, isSampled, isStoreValue, isString, mcpError, mcpResult, mergeContractSchemas, mergeMappingRule, mockEnv, observeFromEnv, packageNameToVariable, parseCallPath, parseGrant, parseObserveCredential, parseTraceparent, parseUserAgent, processEventMapping, readCacheEnvelope, requestToData, requestToParameter, resolveContracts, resolveSetup, resolveTelemetryOptions, scanFlowRefs, serializeStoreValue, setByPath, setTraceUntil, stepId, storeCache, throttle, throwError, transformData, traverseEnv, trim, tryCatch, tryCatchAsync, useHooks, validateStepEntry, verifyActivation, walkPath, wrapCacheEnvelope, wrapCondition, wrapFn, wrapValidate };

package/dist/index.d.ts

@@ -3285,10 +3285,13 @@ interface SendResponse {
 }
 
 /**
- * Journey types describe the assembled, cross-runtime life of one traced event
- * as reconstructed from raw `FlowState` records by `assembleJourneys`. The
- * assembler is pure and presentation-free: no session scoping, no display copy,
- * no formatting. Presenters map a `Journey` into their own view shapes.
+ * Journey types describe the assembled, cross-runtime life of ONE EVENT as
+ * reconstructed from raw `FlowState` records by `assembleJourneys`. The unit is
+ * the event (`FlowState.eventId`, a W3C span id), not the run: a `traceId` is
+ * run-scoped and covers every event of a page load or container run, so it is
+ * carried as the run handle for optional grouping rather than as the identity.
+ * The assembler is pure and presentation-free: no session scoping, no display
+ * copy, no formatting. Presenters map a `Journey` into their own view shapes.
  *
  * Optional fields are populated only when the underlying records carry the
  * corresponding data (e.g. trace-level payloads, consent snapshots, vendor
@@ -3297,11 +3300,16 @@ interface SendResponse {
 /** Runtime that produced a hop: the non-empty subset of `FlowState.platform`. */
 type JourneyPlatform = 'web' | 'server';
 /**
- * How a journey's records were correlated into one journey. `trace` groups by
- * the shared `traceId`; `legacy` is the fallback for records that predate trace
- * propagation and are grouped by their `eventId` alone.
+ * How a journey's records were correlated into one journey. `event` is the only
+ * value the assembler produces: records group by their `eventId`, with $flow
+ * crossing continuations joined through `parentEventId`.
+ *
+ * @remarks `trace` (grouped by the run-scoped `traceId`) and `legacy` (grouped
+ * by `eventId` when no trace was propagated) are retained so envelopes
+ * serialized by older assemblers still type. Neither is produced any more; both
+ * are removal candidates in the next major.
  */
-type JourneyCorrelation = 'trace' | 'legacy';
+type JourneyCorrelation = 'event' | 'trace' | 'legacy';
 /**
  * Collapsed outcome of a single hop, derived from its terminal phase. `pending`
  * covers a hop still in `in`/`init`/`flush` (no terminal phase observed yet);
@@ -3359,7 +3367,13 @@ interface AssembleJourneysOptions {
     /** Wall-clock reference (epoch ms) for settle evaluation. Defaults to now. */
     now?: number;
 }
-/** The originating event of a journey, taken from its entry collector hop. */
+/**
+ * The originating event of a journey, taken from its entry collector hop.
+ * `eventId` always equals the journey's `id`, by construction: the entry is
+ * chosen from the originating arm's records alone, so a crossing's far arm can
+ * never supply it, and `name` therefore always describes the event the journey
+ * is named after rather than the far arm's rendering of it.
+ */
 interface JourneyEntry {
     /** Originating event's id (W3C span-id). */
     eventId: string;
@@ -3457,6 +3471,8 @@ interface JourneyHop {
      * non-terminal and is not a confirmation.
      */
     flushConfirmed?: boolean;
+    /** Release provenance of the runtime that produced this hop's records, when stamped. */
+    release?: string;
     /** Free-form metadata carried by the hop's records. */
     meta?: Record<string, unknown>;
 }
@@ -3480,13 +3496,42 @@ interface JourneyGap {
     /** First `seq` observed after the gap. */
     beforeSeq: number;
 }
+/**
+ * Records that carried a `traceId` (so they belonged to a real event run) but
+ * could not be attributed to any event, grouped per platform. Emitted by
+ * runtimes that predate the early span-id mint, whose `collector.push` records
+ * carry no event id. Records that carry no `traceId` (destination `init`, store
+ * lifecycle) belong to no event by design and are never counted here, so a
+ * nonzero value always means information was lost.
+ */
+interface JourneyUnattributed {
+    /** Poster runtime the records came from, when stamped. */
+    platform?: JourneyPlatform;
+    /** How many records were dropped from grouping. */
+    count: number;
+    /** Wall-clock lower bound of the dropped records (epoch ms). */
+    fromMs: number;
+    /** Wall-clock upper bound of the dropped records (epoch ms). */
+    toMs: number;
+    /** Distinct stepIds the dropped records came from, sorted. */
+    stepIds: string[];
+}
 /** One reconstructed event lifetime across the pipeline. */
 interface Journey {
-    /** `traceId` when trace-correlated, else `event:<eventId>`. */
+    /**
+     * The originating event's id (bare W3C span-id). For a $flow crossing, the
+     * id of the arm the crossing started from.
+     */
     id: string;
-    /** How the journey's records were correlated. */
+    /** How the journey's records were correlated. Always `event`. */
     correlation: JourneyCorrelation;
-    /** Shared trace id, when trace-correlated. */
+    /**
+     * Run handle of the originating arm: the run-scoped trace every event of one
+     * page load or container run shares. Presenters group rows by it; it is not
+     * the journey's identity. When the originating arm's records carry no trace
+     * (an emitter predating trace propagation), the first trace among the
+     * journey's remaining records stands in rather than dropping the handle.
+     */
     traceId?: string;
     /** Originating event of the journey. */
     entry: JourneyEntry;
@@ -3516,6 +3561,12 @@ interface JourneyAssembly {
     journeys: Journey[];
     /** Session-level per-platform loss windows. */
     gaps: JourneyGap[];
+    /**
+     * Records that belonged to an event run but could not be attributed to any
+     * event, per platform. Absent when there are none. Computed over every input
+     * record, so callers that cap `journeys` still report the full figure.
+     */
+    unattributed?: JourneyUnattributed[];
 }
 
 /**
@@ -4607,8 +4658,13 @@ declare const OBSERVE_STORAGE_KEY = "elbObserve";
 declare function browserSwapActivator(cfg: SwapActivatorConfig): Promise<boolean>;
 
 /**
- * Pure assembly of raw `FlowState` records into cross-runtime journeys. The
- * function is idempotent (duplicate records are deduped first) and
+ * Pure assembly of raw `FlowState` records into cross-runtime journeys, one per
+ * EVENT. Records group by their `eventId`; a `traceId` is run-scoped and covers
+ * every event of a page load or container run, so it is carried as the run
+ * handle rather than used to group. Records naming no event are excluded from
+ * grouping and reported in `unattributed` when they carried a run trace.
+ *
+ * The function is idempotent (duplicate records are deduped first) and
  * deterministic (output does not depend on input order; `options.now` supplies
  * the settle reference so tests never depend on the wall clock). It resolves
  * completeness (`pending`/`complete`/`partial`) against the settle window and,
@@ -5171,4 +5227,4 @@ declare const REF_CODE_PREFIX = "$code:";
  */
 declare function scanFlowRefs(value: unknown, into?: Set<string>): Set<string>;
 
-export { type ActivationGrant, type AssembleJourneysOptions, type BatchedPosterOptions, type BreakerState, CLOCK_SKEW_MS, cache as Cache, type CacheEnvelope, type CacheResult, 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 ExampleSummary, FatalError, Flow, type FlowConfigResolver, type FlowState, type FlowStateBatch, type FlowStatePhase, type FlowStepType, type GetStore, hint as Hint, hooks as Hooks, type Ingest, type IngestEnvelope, type IngestMeta, 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 JsonSchema, Level, lifecycle as Lifecycle, type LifecycleContext, logger as Logger, MAX_SESSION_MS, mapping as Mapping, type MarketingParameters, matcher as Matcher, type MockLogger, OBSERVE_ENV_KEY, OBSERVE_STORAGE_KEY, type Observe, type ObserveCredential, type ObserveServer, type ObserveWeb, 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, SECRET_MARKER_PREFIX, SESSION_STORAGE_KEY, 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 StepKind, type StorageType, store as Store, StoreCodecError, type SwapActivatorConfig, type TelemetryLevel, type TelemetryOptions, type TelemetryOptionsSupplier, transformer as Transformer, trigger as Trigger, URL_WINDOW_MS, type ValidateEvents, type VerifyParams, type VerifyResult, walkeros as WalkerOS, type WalkerOSPackage, type WalkerOSPackageInfo, type WalkerOSPackageMeta, anonymizeIP, applyState, applyUpdate, assembleJourneys, assign, branch, browserSwapActivator, buildCacheContext, castToProperty, castValue, checkCache, clone, compileCache, compileMatcher, compileState, createBatchedPoster, createDestination, createEvent, createIngest, createLogger, createMockContext, createMockLogger, createRespond, createTelemetryObserver, debounce, deepMerge, defaultClickIds, deleteByPath, deserializeStoreValue, emitStep, fetchPackage, fetchPackageSchema, filterValues, flattenIncludeSections, formatOut, getBrowser, getBrowserVersion, getByPath, getDeviceType, getEvent, getFlowSettings, getGrantedConsent, getHeaders, getId, getMappingEvent, getMappingValue, getMarketingParameters, getNextSteps, getOS, getOSVersion, getPlatform, getSpanId, getTraceId, getTraceUntil, isArguments, isArray, isBoolean, isCommand, isDefined, isElementOrDocument, isEnvObserve, isFunction, isNumber, isObject, isPathStepEntry, isPropertyType, isRouteArray, isRouteConfigEntry, isSameType, isSampled, isStoreValue, isString, mcpError, mcpResult, mergeContractSchemas, mergeMappingRule, mockEnv, observeFromEnv, packageNameToVariable, parseCallPath, parseGrant, parseObserveCredential, parseTraceparent, parseUserAgent, processEventMapping, readCacheEnvelope, requestToData, requestToParameter, resolveContracts, resolveSetup, resolveTelemetryOptions, scanFlowRefs, serializeStoreValue, setByPath, setTraceUntil, stepId, storeCache, throttle, throwError, transformData, traverseEnv, trim, tryCatch, tryCatchAsync, useHooks, validateStepEntry, verifyActivation, walkPath, wrapCacheEnvelope, wrapCondition, wrapFn, wrapValidate };
+export { type ActivationGrant, type AssembleJourneysOptions, type BatchedPosterOptions, type BreakerState, CLOCK_SKEW_MS, cache as Cache, type CacheEnvelope, type CacheResult, 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 ExampleSummary, FatalError, Flow, type FlowConfigResolver, type FlowState, type FlowStateBatch, type FlowStatePhase, type FlowStepType, type GetStore, hint as Hint, hooks as Hooks, type Ingest, type IngestEnvelope, type IngestMeta, 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, OBSERVE_ENV_KEY, OBSERVE_STORAGE_KEY, type Observe, type ObserveCredential, type ObserveServer, type ObserveWeb, 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, SECRET_MARKER_PREFIX, SESSION_STORAGE_KEY, 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 StepKind, type StorageType, store as Store, StoreCodecError, type SwapActivatorConfig, type TelemetryLevel, type TelemetryOptions, type TelemetryOptionsSupplier, transformer as Transformer, trigger as Trigger, URL_WINDOW_MS, type ValidateEvents, type VerifyParams, type VerifyResult, walkeros as WalkerOS, type WalkerOSPackage, type WalkerOSPackageInfo, type WalkerOSPackageMeta, anonymizeIP, applyState, applyUpdate, assembleJourneys, assign, branch, browserSwapActivator, buildCacheContext, castToProperty, castValue, checkCache, clone, compileCache, compileMatcher, compileState, createBatchedPoster, createDestination, createEvent, createIngest, createLogger, createMockContext, createMockLogger, createRespond, createTelemetryObserver, debounce, deepMerge, defaultClickIds, deleteByPath, deserializeStoreValue, emitStep, fetchPackage, fetchPackageSchema, filterValues, flattenIncludeSections, formatOut, getBrowser, getBrowserVersion, getByPath, getDeviceType, getEvent, getFlowSettings, getGrantedConsent, getHeaders, getId, getMappingEvent, getMappingValue, getMarketingParameters, getNextSteps, getOS, getOSVersion, getPlatform, getSpanId, getTraceId, getTraceUntil, isArguments, isArray, isBoolean, isCommand, isDefined, isElementOrDocument, isEnvObserve, isFunction, isNumber, isObject, isPathStepEntry, isPropertyType, isRouteArray, isRouteConfigEntry, isSameType, isSampled, isStoreValue, isString, mcpError, mcpResult, mergeContractSchemas, mergeMappingRule, mockEnv, observeFromEnv, packageNameToVariable, parseCallPath, parseGrant, parseObserveCredential, parseTraceparent, parseUserAgent, processEventMapping, readCacheEnvelope, requestToData, requestToParameter, resolveContracts, resolveSetup, resolveTelemetryOptions, scanFlowRefs, serializeStoreValue, setByPath, setTraceUntil, stepId, storeCache, throttle, throwError, transformData, traverseEnv, trim, tryCatch, tryCatchAsync, useHooks, validateStepEntry, verifyActivation, walkPath, wrapCacheEnvelope, wrapCondition, wrapFn, wrapValidate };