walkeros-understanding-sources

What problem does it solve?

This Skill helps developers understand how walkerOS sources capture events from the external world (browser, dataLayer, HTTP/server) and feed them to the collector, clarifying the separation of concerns between sources and the collector.

Core Features & Use Cases

• Source Interface: Describes the canonical interface for sources, including the Init pattern and the Push method, enabling consistent integration.
• Init Context Pattern: Explains how context provides config, environment, logger, id, and collector references to initialize a source.
• Push & Event Flow: Details how source.push receives external input and emits events to the collector, and how transformer wiring can occur before reaching the collector.
• Use Cases: Useful for creating new sources, debugging event capture, and understanding how browser, dataLayer, and server sources differ.

Quick Start

Review the core source interface definitions, examine existing browser and dataLayer sources, and study an example cloud function source to see how an event is transformed into a walkerOS event and pushed into the collector.