walkeros-understanding-sources

Browser and dataLayer sources capture events using a push method that emits data to the collector. The Init context pattern provides config, environment, and logger references to initialize the source consistently.

The canonical source interface requires an Init pattern for setup and a Push method to emit events. Context provides config, environment, logger, id, and collector references to initialize sources and wire them into pre-collector transformers.

Event flow starts when source.push receives external input, passes it through transformer wiring, and emits the transformed event into the collector. This separates event capture logic from collection and processing concerns.

Yes, the canonical source interface supports browser, dataLayer, and server implementations. Reference implementations demonstrate how an event is transformed into a walkerOS event and pushed into the collector across these environments.

Separating sources from the collector creates a clear boundary between capturing events from the external world and processing them. Sources handle input capture while the collector manages event ingestion and downstream routing.

Debug event capture by examining the Init context pattern configuration, verifying transformer wiring, and checking how source.push emits events. Review existing browser and dataLayer source implementations to trace event flow.