suno_core/
lib.rs

1//! Core engine for rs-suno: library selection, sync reconciliation, and tagging.
2//!
3//! Runtime-agnostic and free of direct IO. Network access happens through the
4//! [`Http`] port, which a CLI adapter implements, so the engine stays testable
5//! in isolation.
6
7mod auth;
8mod backoff;
9mod client;
10mod clock;
11pub mod config;
12mod consts;
13mod downloadable;
14mod error;
15mod executor;
16mod extras;
17mod ffmpeg;
18mod fs;
19mod graph;
20mod hash;
21mod http;
22mod lineage;
23mod manifest;
24mod model;
25mod naming;
26pub mod reconcile;
27pub mod select;
28mod tag;
29
30#[cfg(test)]
31mod testutil;
32
33#[cfg(test)]
34mod sync_chaos;
35
36pub use auth::{ClerkAuth, TOKEN_EXPIRY_WARN_DAYS, TokenExpiry, classify_token_expiry};
37pub use client::{Playlist, SunoClient};
38pub use clock::Clock;
39pub use config::{
40    AccountConfig, AudioFormat, Config, Defaults, EffectiveSettings, FlagOverrides, SourceConfig,
41};
42pub use downloadable::is_downloadable;
43pub use error::{Error, Result};
44pub use executor::{ExecOptions, ExecOutcome, Failure, Ports, RunStatus, execute};
45pub use extras::{
46    INDEX_SCHEMA_VERSION, M3u8Entry, render_clip_details, render_clip_lyrics, render_library_index,
47    render_m3u8,
48};
49pub use ffmpeg::{Ffmpeg, FfmpegError, FfmpegErrorKind, WebpEncodeSettings};
50pub use fs::{FileStat, Filesystem, FsError, FsErrorKind};
51pub use graph::{
52    AdoptDecision, AlbumArt, CacheEntry, LineageStore, Node, Owner, OwnerCheck, OwnerGate,
53    PlaylistState, StoredEdge, adopt_decision, owner_gate,
54};
55pub use hash::{art_hash, art_url_hash, content_hash, meta_hash};
56pub use http::{Http, HttpRequest, HttpResponse, Method, TransportError};
57pub use lineage::{
58    Edge, EdgeRole, EdgeType, LineageContext, Resolution, ResolveOpts, ResolveStatus, RootInfo,
59    edge_type, immediate_parent, lineage_edges, resolve_roots,
60};
61pub use manifest::{ArtifactState, Manifest, ManifestEntry};
62pub use model::{Clip, HistoryEntry};
63pub use naming::{
64    CharacterSet, DEFAULT_TEMPLATE, NamingConfig, NamingRequest, RenderedName, render_clip_name,
65    render_clip_names, sanitise_name,
66};
67pub use reconcile::{
68    Action, AlbumDesired, ArtifactKind, Desired, DesiredArtifact, LocalFile, Plan, PlaylistDesired,
69    SourceMode, SourceStatus, album_desired, deletion_allowed, plan_album_artifacts,
70    plan_playlist_artifacts, reconcile,
71};
72pub use tag::{TrackMetadata, tag_flac, tag_mp3};
suno_core/lib.rs

suno_core/
lib.rs
