Phase 6

internal/datasource/synthetic/definition.go

@@ -0,0 +1,34 @@
+// Package synthetic implements a DataSource that computes signals from
+// existing upstream signals by running them through configurable DSP pipelines.
+package synthetic
+
+// SignalDef describes one synthetic signal.
+type SignalDef struct {
+	Name     string        `json:"name"`
+	DS       string        `json:"ds"`      // upstream data source name
+	Signal   string        `json:"signal"`  // upstream signal name (or "" for constant)
+	Inputs   []InputRef    `json:"inputs"`  // alternative multi-input format
+	Pipeline []NodeDef     `json:"pipeline"` // ordered list of DSP nodes
+	Meta     MetaOverride  `json:"meta"`    // optional metadata overrides
+}
+
+// InputRef names one upstream signal used as input to the pipeline.
+type InputRef struct {
+	DS     string `json:"ds"`
+	Signal string `json:"signal"`
+}
+
+// NodeDef is a single node in the pipeline.
+type NodeDef struct {
+	Type   string         `json:"type"`
+	Params map[string]any `json:"params,omitempty"`
+}
+
+// MetaOverride allows the synthetic signal to override display metadata.
+type MetaOverride struct {
+	Unit        string  `json:"unit,omitempty"`
+	Description string  `json:"description,omitempty"`
+	DisplayLow  float64 `json:"displayLow,omitempty"`
+	DisplayHigh float64 `json:"displayHigh,omitempty"`
+	Writable    bool    `json:"writable,omitempty"`
+}