Struct Package 

pub struct Package { /* private fields */ }

A validated, integrity-checked .aion package loaded fully into memory.

The engine performs actual VM registration. This crate only supplies the validated manifest, canonical beam bytes, optional source, and deployed module names the engine can register.

Implementations

impl Package

pub fn load_from_path( path: impl AsRef<Path>, limits: ExtractionLimits, ) -> Result<Self, PackageError>

Loads a .aion package from a filesystem path.

The caller chooses an explicit ExtractionLimits inflate budget; untrusted input must be bounded.

Errors

Returns a typed PackageError for unreadable archives, malformed manifests or entries, unsupported format versions, integrity mismatches, missing entry modules, or contents inflating past limits.

pub fn load_from_bytes( bytes: impl AsRef<[u8]>, limits: ExtractionLimits, ) -> Result<Self, PackageError>

Loads a .aion package from an in-memory byte buffer.

The caller chooses an explicit ExtractionLimits inflate budget; untrusted input must be bounded.

Errors

Returns a typed PackageError for unreadable archives, malformed manifests or entries, unsupported format versions, integrity mismatches, missing entry modules, or contents inflating past limits.

pub const fn manifest(&self) -> &Manifest

Returns the validated manifest loaded from manifest.json.

pub const fn beams(&self) -> &BeamSet

Returns the canonical compiled beam set extracted from beam/ entries.

pub const fn source(&self) -> &BTreeMap<String, Vec<u8>>

Returns optional Gleam source files extracted verbatim from src/ entries.

pub const fn content_hash(&self) -> &ContentHash

Returns the recomputed content hash that proved package integrity.

pub fn version_record(&self) -> WorkflowVersion

Produces the canonical cross-system version record for this loaded package.

pub fn deployed_modules(&self) -> Vec<(String, &[u8])>

Returns engine-ready deployed module names paired with their beam bytes.

The engine performs the actual VM registration; this crate only supplies the validated namespaced names and exact module bytes.

pub fn deployed_entry_module(&self) -> String

Returns the deployed namespaced module name for the manifest entry module.

pub fn to_archive_bytes(&self) -> Result<Vec<u8>, PackageError>

Re-serialises this validated package into canonical .aion archive bytes.

The deterministic crate::PackageBuilder write path is used, so the output round-trips through Self::load_from_bytes to a package with the same content hash (the hash covers the beam set only), the same canonical manifest digest, and the same source set. This is the persistence form for runtime-deployed packages: the engine stores these bytes so a deploy survives restart.

Errors

Returns PackageError variants for manifest serialisation or ZIP writer failures; the entry module is already proven present by load validation.

Trait Implementations

impl Clone for Package

fn clone(&self) -> Package

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Package

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

Formats the value using the given formatter.

impl PartialEq for Package

fn eq(&self, other: &Package) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Package