Method Resource

src/microReticulum/Resource.cpp:161–216

Minimal constructor — stores the payload and link, sets baseline state, but performs NO network work. Use the fluent setters to configure optional parameters, then call start() to kick off the transfer (initiator side). The receiver side is built via Resource::accept(), which uses this constructor and then populates per-advertisement fields directly.

// The receiver side is built via Resource::accept(), which uses this
// constructor and then populates per-advertisement fields directly.
Resource::Resource(const Bytes& data, const Link& link) :
	_object(new ResourceData(link))
{
	assert(_object);
	MEM("Resource object created");

	// Stash the pending payload until start() is called (initiator side).
	// For the receiver branch (accept() with empty data) this stays empty.
	_object->_data = data;

	// Metadata handling — auto-compress and metadata serialisation are
	// not yet supported on the C++ port (see plan: "no bz2 on MCU";
	// metadata support deferred). Always emit uncompressed, no metadata.
	_object->_metadata        = {Bytes::NONE};
	_object->_has_metadata    = false;
	_object->_metadata_size   = 0;

	_object->_status               = Type::Resource::NONE;
	_object->_link                 = link;

	// SDU: mirror Python Resource.__init__ (Resource.py:337-340)
	// Use the non-const Link stored in _object->_link since Link::get_mtu/
	// get_mdu are not const-qualified (they assert _object via pimpl).
	if (_object->_link.get_mtu()) {
		_object->_sdu = static_cast<uint16_t>(_object->_link.get_mtu() - Type::Reticulum::HEADER_MAXSIZE - Type::Reticulum::IFAC_MIN_SIZE);
	}
	else if (_object->_link.get_mdu()) {
		_object->_sdu = _object->_link.get_mdu();
	}
	else {
		_object->_sdu = Type::Resource::SDU;
	}

	_object->_max_retries          = Type::Resource::MAX_RETRIES;
	_object->_max_adv_retries      = Type::Resource::MAX_ADV_RETRIES;
	_object->_retries_left         = _object->_max_retries;
	_object->_timeout_factor       = link.traffic_timeout_factor();
	_object->_part_timeout_factor  = Type::Resource::PART_TIMEOUT_FACTOR;
	_object->_sender_grace_time    = Type::Resource::SENDER_GRACE_TIME;
	_object->_auto_compress_option = true;   // default; override via auto_compress()
	_object->_auto_compress        = false;  // bz2 not available on MCU; see plan
	_object->_auto_compress_limit  = Type::Resource::AUTO_COMPRESS_MAX_SIZE;
	_object->_max_decompressed_size = Type::Resource::AUTO_COMPRESS_MAX_SIZE;
	_object->_receiver_min_consecutive_height = 0;

	// Default timeout derived from the link; timeout() setter overrides.
	_object->_timeout = link.rtt() * link.traffic_timeout_factor();

	// Always single-segment, no compression, no metadata on the C++ port.
	_object->_total_segments = 1;
	_object->_segment_index  = 1;
	_object->_split          = false;

	// _initiator is finalised by start() (true) or by accept() (false).
	_object->_initiator = false;
}

// Compact deprecated form — delegates to minimal constructor + fluent setters