Internal data system options that extend the public type with fields that are set by platform SDKs but not exposed to end users.

Hierarchy

Properties

automaticModeSwitching?: boolean | AutomaticModeSwitchingConfig | ManualModeSwitching

Controls how the SDK switches between connection modes.

  • true — enable all automatic switching (lifecycle + network)
  • false — disable all automatic switching; uses the platform default foreground mode
  • AutomaticModeSwitchingConfig — granular control over which platform events trigger automatic mode switches
  • ManualModeSwitching — disable automatic switching and specify the initial connection mode explicitly

Default is true for mobile SDKs, false for browser.

backgroundConnectionMode?: FDv2ConnectionMode

The connection mode to use when the application transitions to the background. Set by platform SDKs (e.g., mobile) via platform defaults.

connectionModes?: Partial<Record<FDv2ConnectionMode, ModeDefinition>>

Override the data source pipeline for specific connection modes.

Each key is a connection mode name ('streaming', 'polling', 'offline', 'one-shot', 'background'). The value defines the initializers and synchronizers for that mode, replacing the built-in defaults.

Only the modes you specify are overridden — unspecified modes retain their built-in definitions.

Example

connectionModes: {
streaming: {
initializers: [{ type: 'polling' }],
synchronizers: [{ type: 'streaming' }],
},
}
foregroundConnectionMode?: FDv2ConnectionMode

The default foreground connection mode for this platform. Populated from platform defaults during validation.

Generated using TypeDoc