Interface: LaneTrackerConfigBuilder<TIn, TExternal, TExternalState>

Defined in: builders/lane-tracker-config-builder.ts:13

Fluent sub-builder for external issue tracker polling and state synchronization (lane.tracker(adapter, $ => ...)).

Configures polling cadence, external issue-to-work-item projection, and bidirectional lifecycle state mappings (onQueued, onRunning, onWaiting, onErrored, onCancelled, onExit).

Type Parameters

Type Parameter	Default type	Description
TIn	unknown	Validated lane work item input type.
TExternal	unknown	Raw external issue payload type from the tracker adapter.
TExternalState extends string	string	External tracker state string type.

Methods

everySeconds()

everySeconds(seconds): LaneTrackerConfigBuilder<TIn, TExternal, TExternalState>;

Defined in: builders/lane-tracker-config-builder.ts:27

Sets the polling interval in seconds for querying the external issue tracker.

Defaults to 60 seconds when .everySeconds(...) is not explicitly called.

Parameters

Parameter	Type	Description
seconds	number	Positive polling interval in seconds.

Returns

LaneTrackerConfigBuilder<TIn, TExternal, TExternalState>

New immutable tracker builder.

---

from()

from(mapper): LaneTrackerConfigBuilder<TIn, TExternal, TExternalState>;

Defined in: builders/lane-tracker-config-builder.ts:38

Binds the synchronous mapper projecting an external issue into TIn (or undefined to skip).

Required before .toAST() can compile a valid LaneTrackerConfig.

Parameters

Parameter	Type	Description
mapper	(external) => TIn | undefined	External issue projector callback.

Returns

LaneTrackerConfigBuilder<TIn, TExternal, TExternalState>

New immutable tracker builder.

---

onCancelled()

onCancelled(externalState): LaneTrackerConfigBuilder<TIn, TExternal, TExternalState>;

Defined in: builders/lane-tracker-config-builder.ts:95

Maps the internal 'cancelled' lane state to externalState.

Synchronizes the external tracker issue state when a run is explicitly cancelled.

Parameters

Parameter	Type	Description
externalState	TExternalState	Target external tracker state.

Returns

LaneTrackerConfigBuilder<TIn, TExternal, TExternalState>

New immutable tracker builder.

---

onErrored()

onErrored(externalState): LaneTrackerConfigBuilder<TIn, TExternal, TExternalState>;

Defined in: builders/lane-tracker-config-builder.ts:84

Maps the internal 'errored' lane state to externalState.

Synchronizes the external tracker issue state when a run fails after exhausting retries.

Parameters

Parameter	Type	Description
externalState	TExternalState	Target external tracker state.

Returns

LaneTrackerConfigBuilder<TIn, TExternal, TExternalState>

New immutable tracker builder.

---

onExit()

onExit(exitState, externalState): LaneTrackerConfigBuilder<TIn, TExternal, TExternalState>;

Defined in: builders/lane-tracker-config-builder.ts:107

Maps a terminal flow exit state ('exit:${exitState}') to externalState.

Synchronizes the external tracker issue state when the bound flow exits with exitState.

Parameters

Parameter	Type	Description
exitState	string	Internal terminal exit state label (e.g. 'done').
externalState	TExternalState	Target external tracker state.

Returns

LaneTrackerConfigBuilder<TIn, TExternal, TExternalState>

New immutable tracker builder.

---

onQueued()

onQueued(externalState): LaneTrackerConfigBuilder<TIn, TExternal, TExternalState>;

Defined in: builders/lane-tracker-config-builder.ts:51

Maps the internal 'queued' lane state to externalState.

Synchronizes the external tracker issue state whenever a work item is queued.

Parameters

Parameter	Type	Description
externalState	TExternalState	Target external tracker state.

Returns

LaneTrackerConfigBuilder<TIn, TExternal, TExternalState>

New immutable tracker builder.

---

onRunning()

onRunning(externalState): LaneTrackerConfigBuilder<TIn, TExternal, TExternalState>;

Defined in: builders/lane-tracker-config-builder.ts:62

Maps the internal 'running' lane state to externalState.

Synchronizes the external tracker issue state whenever a work item acquires a concurrency slot.

Parameters

Parameter	Type	Description
externalState	TExternalState	Target external tracker state.

Returns

LaneTrackerConfigBuilder<TIn, TExternal, TExternalState>

New immutable tracker builder.

---

onWaiting()

onWaiting(externalState): LaneTrackerConfigBuilder<TIn, TExternal, TExternalState>;

Defined in: builders/lane-tracker-config-builder.ts:73

Maps the internal 'waiting' lane state to externalState.

Synchronizes the external tracker issue state when a run suspends on a human decision or prerequisite.

Parameters

Parameter	Type	Description
externalState	TExternalState	Target external tracker state.

Returns

LaneTrackerConfigBuilder<TIn, TExternal, TExternalState>

New immutable tracker builder.

---

toAST()

toAST(): LaneTrackerConfig<TIn, TExternal>;

Defined in: builders/lane-tracker-config-builder.ts:119

Compiles the tracker configuration into a frozen LaneTrackerConfig<TIn, TExternal>.

Throws at builder compilation time if .from(mapper) has not been configured.

Returns

LaneTrackerConfig<TIn, TExternal>

Deeply frozen lane tracker configuration.