Skip to main content

plexus_core/plexus/
mod.rs

1// Guidance system removed during caller-wraps streaming architecture refactor
2// pub mod guidance;
3
4pub mod auth;
5/// AUTH-5: the `auth` activation and what a service supplies it.
6pub mod auth_activation;
7pub mod auth_params;
8/// AUTH-5: a reference in-memory backend and stores for the `auth` activation.
9pub mod auth_memory;
10pub mod test_validator;
11pub mod bidirectional;
12/// MACRO-20: a hub sees through its activations' static children.
13pub mod children;
14pub mod context;
15// RETURNS-10: canonical schema JSON and the SHA-256/16 hash every schema hash is.
16pub mod content_hash;
17pub mod credential_envelope;
18pub mod dispatch;
19/// BIDIR-8 (BIDIR-5's rule): the gate over a duplex call — open, admit,
20/// re-verify on the gate's grants generation, answer, audit.
21pub mod duplex_gate;
22pub mod errors;
23pub mod forward_registry;
24/// AUTH-2: the grant gate in dispatch, and the task-local reach.
25pub mod grant_gate;
26pub mod hub_context;
27/// RETURNS-40: the IR a service writes of itself — IR 3.0, as synapse builds it.
28pub mod ir;
29// MACRO-2.B3: the in-process transport for the macro-generated typed client.
30pub mod in_process;
31/// BIDIR-6: `Input<T>`, the input half of a call.
32pub mod input;
33/// LOCAL-6: a whole hub, called in memory.
34pub mod hub_transport;
35pub mod method_enum;
36pub mod middleware;
37pub mod path;
38pub mod plexus;
39// POLYGLOT-5: the child seam's second implementation — a process or a socket.
40// PLEXUS-45: native only. A browser has no processes, and a ws child waits
41// for a browser-WebSocket transport (a later ticket); on wasm32 the module
42// would compile to a child with no way to reach it.
43#[cfg(not(target_arch = "wasm32"))]
44pub mod remote_child;
45pub mod schema;
46mod schema_sites;
47pub(crate) mod scope_gate;
48pub mod streaming;
49pub mod types;
50/// AUTH-4: the caller's view of a gated hub.
51pub mod view;
52/// PERF-7: the item path — each item encoded once, straight into the frame
53/// its socket writes.
54pub mod wire;
55
56// AuthContext + SessionValidator + the sealed Principal / VerifiedUser /
57// ServiceIdentity types are re-exported from plexus-auth-core via
58// plexus::auth. New code should import directly from plexus_auth_core.
59pub use auth::{AuthContext, Principal, ServiceIdentity, SessionValidator, VerifiedUser, Anonymous, CallSite, ForwardDerivation, ForwardPolicy, ForwardPolicyName, IdentityOnly, MethodPath, MethodPathError, PassThrough, ANONYMOUS_NAME, IDENTITY_ONLY_NAME, PASS_THROUGH_NAME};
60pub use test_validator::TestSessionValidator;
61pub use bidirectional::{BidirChannel, BidirError, SelectOption, StandardBidirChannel, StandardRequest, StandardResponse};
62pub use context::PlexusContext;
63pub use in_process::InProcessTransport;
64pub use input::{Delivered, Input, InputTable};
65pub use hub_transport::HubTransport;
66#[cfg(not(target_arch = "wasm32"))]
67pub use remote_child::{Backoff, ChildError, ChildMethods, ChildOptions, ChildSpec, ChildStats, MountTimings, RemoteChild};
68#[cfg(all(feature = "clap", not(target_arch = "wasm32")))]
69pub use remote_child::ChildArgs;
70#[deprecated(note = "Use GuidanceErrorType and GuidanceSuggestion from stream events instead")]
71pub use errors::{GuidedError, GuidedErrorData, TryRequest};
72pub use forward_registry::{ForwardPolicyRegistry, SameService, SAME_SERVICE_NAME};
73pub use grant_gate::{current_reach, with_reach, ForbiddenItem};
74pub use view::View;
75pub use auth_activation::{
76    AuthActivation, AuthBackend, AuthClient, AuthEvent, AuthFailure, AuthSetup, LoginAnswer, LoginFlow, MembershipEntry, MembershipStore,
77    Provider, ProviderKind, Requirement, RoleStore, Session, SignupAnswer, StoreError, Waiting, SIGNED_IN_GRANTS,
78};
79pub use auth_memory::{MemoryAuthBackend, MemoryMemberships, MemoryRoles};
80// AUTH-2: the grant model, re-exported so an activation needs only plexus-core.
81pub use plexus_auth_core::grants::{
82    Ceiling, Gate, Grant, GrantSet, Membership, Memberships, Reach, Refusal, Resolve, RoleOrGrant,
83    RoleTable, Roles, ScopeRef, ADMIN, CEILING_KEY,
84};
85#[deprecated(note = "Middleware removed - guidance provided via PlexusStreamEvent::Guidance")]
86pub use middleware::{ActivationRegistry, GuidedErrorMiddleware};
87pub use path::Provenance;
88#[allow(deprecated)]
89pub use plexus::{error_item, Activation, ActivationInfo, AuthzDenyReason, ChildCapabilities, ChildRouter, DynamicHub, PlexusError, TransportErrorKind, plexus_error_to_jsonrpc, route_to_child, PLEXUS_NOTIF_METHOD};
90// RETURNS-6: the wire's typed call failure, re-exported so server code (and
91// the code `#[activation]` emits) names it through plexus-core.
92pub use plexus_client::{DenyReason, ParamProblem, RemoteError};
93// RETURNS-8: a method's progress vocabulary, named by the code
94// `#[plexus_macros::method]` emits (the default `P` of `Progress<T>` is `Note`).
95pub use plexus_client::{Note, Progress};
96pub use crate::types::Handle;
97pub use schema::{
98    AuthPosture, Cardinality, ChildHashes, ChildSummary, DeprecationInfo, MethodExample, MethodRole,
99    MethodSchema, ParamSchema, PluginHashes, PluginSchema, RequiredCredential, Schema,
100    SchemaParams, SchemaProperty, SchemaResult, SchemaType, ViewKind, JSON_TYPES,
101    X_PLEXUS_VALUES,
102};
103pub use types::{PlexusStreamItem, StreamMetadata};
104pub use wire::Shared;
105pub use method_enum::MethodEnumSchema;
106pub use streaming::{PlexusStream, wrap_stream, wrap_stream_with_bidir, create_bidir_stream, error_stream, done_stream, progress_stream};
107// RETURNS-8: one wrapper per signature form (`wrap_stream` is the plain-T stream's).
108pub use streaming::{wrap_one, wrap_one_result, wrap_result_stream, wrap_progress_stream, wrap_result_progress_stream};
109// Note: Method enum is auto-generated by hub_macro and exported from plexus module
110pub use dispatch::{HubDispatch, StreamItem, from_dispatch_stream};
111pub use crate::request::PlexusRequestField;
112pub use hub_context::{HubContext, ParentAware, NoParent};