systemprompt_extension/
error.rs

1//! Typed error enums raised by extension registration and configuration.
2//!
3//! Copyright (c) systemprompt.io — Business Source License 1.1.
4//! See <https://systemprompt.io> for licensing details.
5
6use thiserror::Error;
7
8#[derive(Debug, Error)]
9pub enum LoaderError {
10    #[error("Extension '{extension}' requires dependency '{dependency}' which is not registered")]
11    MissingDependency {
12        extension: String,
13        dependency: String,
14    },
15
16    #[error("Extension with ID '{0}' is already registered")]
17    DuplicateExtension(String),
18
19    #[error("Extension '{0}' is required and cannot be disabled")]
20    RequiredExtensionDisabled(String),
21
22    #[error(
23        "Extension '{dependency}' is disabled but extension '{extension}' depends on it; disable \
24         '{extension}' as well or re-enable '{dependency}'"
25    )]
26    DisabledDependency {
27        extension: String,
28        dependency: String,
29    },
30
31    #[error("Failed to initialize extension '{extension}': {message}")]
32    InitializationFailed { extension: String, message: String },
33
34    #[error("Failed to install schema for extension '{extension}': {message}")]
35    SchemaInstallationFailed { extension: String, message: String },
36
37    #[error("Migration failed for extension '{extension}': {message}")]
38    MigrationFailed { extension: String, message: String },
39
40    #[error(
41        "Migration {version} for extension '{extension}' is not reversible (no down SQL provided)"
42    )]
43    MigrationNotReversible { extension: String, version: u32 },
44
45    #[error(
46        "Extension '{extension}' migration slot {version} was applied as '{stored_name}' but the \
47         tree now names it '{current_name}'. A migration file was deleted and its number reused; \
48         established databases have already spent that slot, so the new SQL would be skipped, \
49         never executed. Renumber it above every used slot and leave a \
50         `{version:03}_{stored_name}.tombstone` behind so the number cannot be claimed again."
51    )]
52    MigrationSlotReused {
53        extension: String,
54        version: u32,
55        stored_name: String,
56        current_name: String,
57    },
58
59    #[error("Configuration validation failed for extension '{extension}': {message}")]
60    ConfigValidationFailed { extension: String, message: String },
61
62    #[error("Extension '{extension}' uses reserved API path '{path}'")]
63    ReservedPathCollision { extension: String, path: String },
64
65    #[error(
66        "Extension '{extension}' has invalid base path '{path}': must be / or start with /api/"
67    )]
68    InvalidBasePath { extension: String, path: String },
69
70    #[error("Dependency cycle detected while ordering extensions: {chain}")]
71    DependencyCycle { chain: String },
72
73    #[error(
74        "Extension '{extension}' migration ALTERs table '{table}' but does not create it in its \
75         schemas() nor declare it in cross_extension_tables(); cross-extension table mutations \
76         must be declared explicitly"
77    )]
78    CrossExtensionAlterUndeclared { extension: String, table: String },
79
80    #[error(
81        "Table '{table}' is created by both extension '{extension_a}' and '{extension_b}'; every \
82         table must be declared by exactly one extension"
83    )]
84    DuplicateTableOwner {
85        table: String,
86        extension_a: String,
87        extension_b: String,
88    },
89
90    #[error(
91        "Extension '{extension}' declares cross_extension_tables() entry '{table}', which is not \
92         a table created by any other loaded extension"
93    )]
94    CrossExtensionTableNotOwned { extension: String, table: String },
95
96    #[error(
97        "Extension '{extension}' seed '{seed}' contains forbidden statement '{statement}'; seeds \
98         may only contain INSERT … ON CONFLICT, UPDATE, MERGE, or WITH … INSERT"
99    )]
100    InvalidSeedStatement {
101        extension: String,
102        seed: String,
103        statement: String,
104    },
105
106    #[error(
107        "Extension '{extension}' seed '{seed}' contains a bare INSERT with no ON CONFLICT clause; \
108         seeds run on every boot and must be idempotent — add ON CONFLICT … DO NOTHING/UPDATE"
109    )]
110    SeedInsertNotIdempotent { extension: String, seed: String },
111
112    #[error("Extension '{extension}' seed '{seed}' failed to parse or apply: {message}")]
113    SeedFailed {
114        extension: String,
115        seed: String,
116        message: String,
117    },
118}
119
120#[derive(Debug, Error)]
121pub enum ExtensionConfigError {
122    #[error("Configuration key '{0}' not found")]
123    NotFound(String),
124
125    #[error("Invalid configuration value for '{key}': {message}")]
126    InvalidValue { key: String, message: String },
127
128    #[error("Failed to parse configuration: {message}")]
129    ParseError { message: String },
130
131    #[error("Schema validation failed: {0}")]
132    SchemaValidation(String),
133}
systemprompt_extension/error.rs

systemprompt_extension/
error.rs
