Struct SinkRecord 

pub struct SinkRecord {
    pub data: Value,
    pub schema_id: String,
    pub source_url: String,
    pub metadata: HashMap<String, String>,
}

A single structured record to be published through a DataSinkPort.

Example

use stygian_graph::ports::data_sink::SinkRecord;
use serde_json::json;

let record = SinkRecord::new(
    "product-v1",
    "https://shop.example.com/items/42",
    json!({ "sku": "ABC-42", "price": 9.99 }),
);
assert_eq!(record.schema_id, "product-v1");

Fields

data: Value

The payload to publish. Any JSON value is accepted.

schema_id: String

Identifies the schema or data-contract version this record conforms to. Sinks may use this for routing, validation, or schema-registry lookups.

source_url: String

The canonical URL the record was scraped from. Used for provenance and deduplication. Stored as a String to avoid a url crate dependency in the port layer.

metadata: HashMap<String, String>

Arbitrary string key-value metadata (content-type, run-id, tenant, …).

Implementations

impl SinkRecord

pub fn new( schema_id: impl Into<String>, source_url: impl Into<String>, data: Value, ) -> Self

Construct a new SinkRecord with empty metadata.

Example

use stygian_graph::ports::data_sink::SinkRecord;

let r = SinkRecord::new("schema-v1", "https://example.com/page", serde_json::Value::Null);
assert!(r.metadata.is_empty());

pub fn with_meta(self, key: impl Into<String>, value: impl Into<String>) -> Self

Attach a metadata entry and return self for builder-style use.

Example

use stygian_graph::ports::data_sink::SinkRecord;

let r = SinkRecord::new("s", "https://x.com", serde_json::Value::Null)
    .with_meta("run_id", "abc123");
assert_eq!(r.metadata["run_id"], "abc123");

Trait Implementations

impl Clone for SinkRecord

fn clone(&self) -> SinkRecord

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SinkRecord

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SinkRecord

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SinkRecord

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.