auths-sdk 0.1.2

Application services layer for Auths identity operations
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
112
113

// crate-level allow during curve-agnostic refactor.
#![allow(clippy::disallowed_methods)]
#![warn(clippy::too_many_lines, clippy::cognitive_complexity)]
#![warn(missing_docs)]
//! # auths-sdk
//!
//! Application services layer for Auths identity operations.
//!
//! This crate provides high-level orchestration functions for identity management,
//! device linking, platform verification, and registry operations. It sits between
//! the CLI (I/O adapter) and the domain crates (`auths-core`, `auths-id`).
//!
//! ## Architecture
//!
//! ```text
//! auths-cli  →  auths-sdk  →  auths-core + auths-id
//! (I/O adapter)  (orchestration)  (domain)
//! ```
//!
//! SDK functions accept typed configs and return structured `Result` types.
//! They never prompt for input, print to stdout, or call `process::exit()`.

// ── Re-export modules: types from auths-core, auths-id, auths-storage ──
// These allow CLI and API consumers to import through auths-sdk instead of
// depending on lower-layer crates directly.

/// Re-exports of agent process types from `auths-core`.
pub mod agent_core;
/// Re-exports of attestation operations from `auths-id`.
pub mod attestation;
/// Re-exports of configuration types from `auths-core`.
pub mod core_config;
/// Re-exports of cryptographic utilities from `auths-core`.
pub mod crypto;
/// Re-exports of FFI types from `auths-core`.
pub mod ffi;
/// Re-exports of freeze types from `auths-id`.
pub mod freeze;
/// Re-exports of identity types and operations from `auths-id`.
pub mod identity;
/// Re-exports of KERI cache module from `auths-id`.
pub mod keri;
/// Re-exports of keychain and key storage types from `auths-core`.
pub mod keychain;
/// Re-exports of path utilities from `auths-core`.
pub mod paths;
/// Re-exports of Git storage backend types from `auths-storage`.
pub mod storage;
/// Re-exports of storage layout types from `auths-id`.
pub mod storage_layout;
/// Re-exports of trust and pinned identity types from `auths-core`.
pub mod trust;
/// Re-exports of verification helpers from `auths-verifier`.
pub mod verify;
/// Re-exports of witness server and config types.
pub mod witness;

// ── SDK modules ──

/// Audit event emission convenience for SDK operations.
pub mod audit;
/// Runtime dependency container (`AuthsContext`) for injecting infrastructure adapters.
pub mod context;
/// Device linking, revocation, and authorization extension operations.
pub mod device;
/// Domain services for specialized business logic.
pub mod domains;
/// Domain error types for all SDK operations.
pub mod error;
/// Key import and management operations.
pub mod keys;
/// Namespace verifier adapter registry mapping ecosystems to implementations.
pub mod namespace_registry;
/// OIDC JWT ID (jti) registry for token replay detection.
pub mod oidc_jti_registry;
/// Device pairing orchestration over ephemeral ECDH sessions.
pub mod pairing;
/// Platform identity claim creation and verification.
pub mod platform;
/// Port traits for external I/O adapters (artifact, git, diagnostics).
pub mod ports;
/// HTML and structured report rendering.
pub mod presentation;
/// Remote registry publication for public DID discovery.
pub mod registration;
/// Return types for SDK workflow functions.
pub mod result;
/// Identity provisioning for developer, CI, and agent environments.
pub mod setup;
/// Artifact signing pipeline and attestation creation.
pub mod signing;
/// Plain-old-data config structs for all SDK workflows.
pub mod types;
/// Higher-level identity workflows (rotation, provisioning, auditing).
pub mod workflows;

/// Test utilities for auths-sdk consumers (behind `test-utils` feature).
#[cfg(any(test, feature = "test-utils"))]
pub mod testing;

pub use context::AuthsContext;
pub use context::EventSink;

// Re-export types and errors from domains for ease of access
pub use domains::auth::error::*;
pub use domains::compliance::error::*;
pub use domains::device::error::*;
pub use domains::device::types::*;
pub use domains::diagnostics::types::*;
pub use domains::identity::error::*;
pub use domains::identity::types::*;
pub use domains::org::error::*;
pub use domains::signing::types::*;