auths_sdk/lib.rs
1#![deny(
2 clippy::print_stdout,
3 clippy::print_stderr,
4 clippy::exit,
5 clippy::dbg_macro
6)]
7#![deny(clippy::disallowed_methods)]
8#![deny(clippy::unwrap_used)]
9#![deny(clippy::expect_used)]
10#![deny(rustdoc::broken_intra_doc_links)]
11#![warn(clippy::too_many_lines, clippy::cognitive_complexity)]
12#![warn(missing_docs)]
13//! # auths-sdk
14//!
15//! Application services layer for Auths identity operations.
16//!
17//! This crate provides high-level orchestration functions for identity management,
18//! device linking, platform verification, and registry operations. It sits between
19//! the CLI (I/O adapter) and the domain crates (`auths-core`, `auths-id`).
20//!
21//! ## Architecture
22//!
23//! ```text
24//! auths-cli → auths-sdk → auths-core + auths-id
25//! (I/O adapter) (orchestration) (domain)
26//! ```
27//!
28//! SDK functions accept typed configs and return structured `Result` types.
29//! They never prompt for input, print to stdout, or call `process::exit()`.
30
31/// Runtime dependency container (`AuthsContext`) for injecting infrastructure adapters.
32pub mod context;
33/// Device linking, revocation, and authorization extension operations.
34pub mod device;
35/// Domain error types for all SDK operations.
36pub mod error;
37/// Key import and management operations.
38pub mod keys;
39/// Device pairing orchestration over ephemeral ECDH sessions.
40pub mod pairing;
41/// Platform identity claim creation and verification.
42pub mod platform;
43/// Port traits for external I/O adapters (artifact, git, diagnostics).
44pub mod ports;
45/// HTML and structured report rendering.
46pub mod presentation;
47/// Remote registry publication for public DID discovery.
48pub mod registration;
49/// Return types for SDK workflow functions.
50pub mod result;
51/// Identity provisioning for developer, CI, and agent environments.
52pub mod setup;
53/// Artifact signing pipeline and attestation creation.
54pub mod signing;
55/// Plain-old-data config structs for all SDK workflows.
56pub mod types;
57/// Higher-level identity workflows (rotation, provisioning, auditing).
58pub mod workflows;
59
60/// Test utilities for auths-sdk consumers (behind `test-utils` feature).
61#[cfg(any(test, feature = "test-utils"))]
62pub mod testing;
63
64pub use context::AuthsContext;
65pub use context::EventSink;