systemprompt_extension/
error.rs

1//! Typed error enums raised by extension registration and configuration.
2
3use thiserror::Error;
4
5#[derive(Debug, Error)]
6pub enum LoaderError {
7    #[error("Extension '{extension}' requires dependency '{dependency}' which is not registered")]
8    MissingDependency {
9        extension: String,
10        dependency: String,
11    },
12
13    #[error("Extension with ID '{0}' is already registered")]
14    DuplicateExtension(String),
15
16    #[error("Failed to initialize extension '{extension}': {message}")]
17    InitializationFailed { extension: String, message: String },
18
19    #[error("Failed to install schema for extension '{extension}': {message}")]
20    SchemaInstallationFailed { extension: String, message: String },
21
22    #[error("Migration failed for extension '{extension}': {message}")]
23    MigrationFailed { extension: String, message: String },
24
25    #[error(
26        "Migration {version} for extension '{extension}' is not reversible (no down SQL provided)"
27    )]
28    MigrationNotReversible { extension: String, version: u32 },
29
30    #[error("Configuration validation failed for extension '{extension}': {message}")]
31    ConfigValidationFailed { extension: String, message: String },
32
33    #[error("Extension '{extension}' uses reserved API path '{path}'")]
34    ReservedPathCollision { extension: String, path: String },
35
36    #[error("Extension '{extension}' has invalid base path '{path}': must start with /api/")]
37    InvalidBasePath { extension: String, path: String },
38
39    #[error("Dependency cycle detected while ordering extensions: {chain}")]
40    DependencyCycle { chain: String },
41
42    #[error(
43        "Extension '{extension}' migration ALTERs table '{table}' but does not create it in its \
44         schemas() nor declare it in cross_extension_tables(); cross-extension table mutations \
45         must be declared explicitly"
46    )]
47    CrossExtensionAlterUndeclared { extension: String, table: String },
48
49    #[error(
50        "Table '{table}' is created by both extension '{extension_a}' and '{extension_b}'; every \
51         table must be declared by exactly one extension"
52    )]
53    DuplicateTableOwner {
54        table: String,
55        extension_a: String,
56        extension_b: String,
57    },
58
59    #[error(
60        "Extension '{extension}' declares cross_extension_tables() entry '{table}', which is not \
61         a table created by any other loaded extension"
62    )]
63    CrossExtensionTableNotOwned { extension: String, table: String },
64
65    #[error(
66        "Extension '{extension}' seed '{seed}' contains forbidden statement '{statement}'; seeds \
67         may only contain INSERT … ON CONFLICT, UPDATE, MERGE, or WITH … INSERT"
68    )]
69    InvalidSeedStatement {
70        extension: String,
71        seed: String,
72        statement: String,
73    },
74
75    #[error(
76        "Extension '{extension}' seed '{seed}' contains a bare INSERT with no ON CONFLICT clause; \
77         seeds run on every boot and must be idempotent — add ON CONFLICT … DO NOTHING/UPDATE"
78    )]
79    SeedInsertNotIdempotent { extension: String, seed: String },
80
81    #[error("Extension '{extension}' seed '{seed}' failed to parse or apply: {message}")]
82    SeedFailed {
83        extension: String,
84        seed: String,
85        message: String,
86    },
87}
88
89#[derive(Debug, Error)]
90pub enum ConfigError {
91    #[error("Configuration key '{0}' not found")]
92    NotFound(String),
93
94    #[error("Invalid configuration value for '{key}': {message}")]
95    InvalidValue { key: String, message: String },
96
97    #[error("Failed to parse configuration: {message}")]
98    ParseError { message: String },
99
100    #[error("Schema validation failed: {0}")]
101    SchemaValidation(String),
102}
systemprompt_extension/error.rs

systemprompt_extension/
error.rs
