aion-package 0.29.0

Archive validation, content hashing, and namespacing for Aion workflow packages.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

//! Archive validation, content hashing, and namespacing for Aion packages.
//!
//! This crate loads `.aion` archives, validates manifests and BEAM entries,
//! computes stable content hashes, and derives deployed module names for engine
//! registration.
//!
//! # Example
//!
//! ```no_run
//! use aion_package::{ExtractionLimits, Package};
//!
//! // Operator-local file: extraction may run unbounded. Network input must
//! // use `ExtractionLimits::bounded` instead.
//! let package = Package::load_from_path("workflow.aion", ExtractionLimits::unbounded())?;
//! println!("entry module: {}", package.manifest().entry_module);
//! # Ok::<(), Box<dyn std::error::Error>>(())
//! ```

/// Declared-contract admission of caller-supplied values at a boundary.
pub mod admission;
/// AWL document provenance carried by an archive.
pub mod awl;
/// Compiled BEAM module records extracted from packages.
pub mod beam;
/// Which `serde_json::Map` representation this build resolved, announced.
mod build_coverage;
/// Archive builder utilities for tests and packaging tools.
pub mod builder;
/// Canonical JSON text encoding for emitted artifacts.
pub mod canonical;
/// Gleam type and JSON codec generation from project schemas.
pub mod codegen;
/// Worker advertisement compatibility and field-level differences.
pub mod compatibility;
/// Durable worker-contract records and canonical identity encoding.
pub mod contract;
/// The emitted form of an AWL `command` declaration and its one render.
pub mod declared_command;
/// Package validation and archive-loading errors.
pub mod error;
/// Explicit inflate budgets for archive extraction.
pub mod extraction;
/// Stable content-hash calculation for package contents.
pub mod hash;
/// Manifest structures and format-version constants.
pub mod manifest;
/// Deployment namespace helpers for compiled module names.
pub mod namespace;
/// Validated in-memory package loading and accessors.
pub mod package;
/// Project-level packaging driven by `workflow.toml` descriptors.
pub mod project;
/// Workflow primitive-structure projection: the graph model and bounded
/// Gleam regeneration (a projection of the typed source, never authoritative).
pub mod structure;
/// Workflow version identifiers derived from package content.
pub mod version;

pub use admission::{
    AdmissionError, UnenforceableSchema, admit_value, declares_nothing, schema_is_usable,
};
pub use awl::AwlSource;
pub use beam::{BeamModule, BeamSet, RESERVED_MODULE_NAMES};
pub use builder::PackageBuilder;
pub use canonical::{CanonicalJson, serialize_value, sorted_entries};
pub use codegen::{
    ActivityArtifact, ActivityDeclaration, ActivityReport, AionDependency, AwlScaffoldError,
    AwlWorkerScaffold, BoundaryType, CodecReport, CodegenError, CodegenMode, Connection,
    ConnectionPlan, DocumentRoot, FileOwnership, ScaffoldedFile, SchemaEmitReport, ServableAction,
    TestScaffoldReport, Tier, WorkerScaffold, boundary_types_from_interface, build_input_skeleton,
    emit_schemas, emit_shell_manifest, generate_activities, generate_codecs,
    generate_test_scaffold, parse_declarations, scaffold_awl_worker,
};
pub use compatibility::{ContractDiff, contract_diffs};
pub use contract::{
    ActionBodyContract, ActionContract, ActivityDescriptor, AdditionalWorkflowContract,
    CarryContract, ChildContract, CommandBodyCapture, ContractIdentityError, DetachedContract,
    InvariantContract, PackageContract, ReportContract, RetryContract, SignalContract,
    ToleranceContract, WorkerContract, WorkloopContract,
};
pub use declared_command::{
    ArgumentValue, ArgvSlot, CommandLineContract, CommandParameterContract,
    DeclaredCommandContract, END_OF_OPTIONS_MARKER, EnvBindingContract, FillPiece, FillTemplate,
    RenderError, RenderedCommand,
};
pub use error::PackageError;
pub use extraction::ExtractionLimits;
pub use hash::{
    ContentHash, content_hash, content_hash_with_contract, content_hash_with_timeout,
    content_hash_with_timeouts,
};
pub use manifest::{
    CURRENT_FORMAT_VERSION, DeclaredActivity, Manifest, ManifestDigest, ManifestVersion,
    WorkflowEntry,
};
pub use namespace::{
    DEPLOYED_NAME_SEPARATOR, NamespaceError, ParsedDeployedName, deployed_name, deployed_names,
    parse_deployed_name,
};
pub use package::Package;
pub use project::{
    ExcludedModule, ExcludedReason, PackageOptions, PackagedWorkflow, PackagingError,
    ProjectReport, package_project,
};
pub use structure::{
    ArmLabel, CorrelationKey, DeterminismError, EdgeKind, FactsError, GraphEdge, GraphNode, NodeId,
    NodePrimitive, StructuralDelta, StructureError, Violation, ViolationKind, WorkflowFacts,
    WorkflowGraph, analyze_determinism, extract_structure, extract_workflow_facts,
    regenerate_gleam,
};
pub use version::WorkflowVersion;