create-backbone-template 0.1.0

package/template/server/dylint/backbone_server_lints/ui/long_file.rs

@@ -0,0 +1,303 @@
+// filler line 001
+// filler line 002
+// filler line 003
+// filler line 004
+// filler line 005
+// filler line 006
+// filler line 007
+// filler line 008
+// filler line 009
+// filler line 010
+// filler line 011
+// filler line 012
+// filler line 013
+// filler line 014
+// filler line 015
+// filler line 016
+// filler line 017
+// filler line 018
+// filler line 019
+// filler line 020
+// filler line 021
+// filler line 022
+// filler line 023
+// filler line 024
+// filler line 025
+// filler line 026
+// filler line 027
+// filler line 028
+// filler line 029
+// filler line 030
+// filler line 031
+// filler line 032
+// filler line 033
+// filler line 034
+// filler line 035
+// filler line 036
+// filler line 037
+// filler line 038
+// filler line 039
+// filler line 040
+// filler line 041
+// filler line 042
+// filler line 043
+// filler line 044
+// filler line 045
+// filler line 046
+// filler line 047
+// filler line 048
+// filler line 049
+// filler line 050
+// filler line 051
+// filler line 052
+// filler line 053
+// filler line 054
+// filler line 055
+// filler line 056
+// filler line 057
+// filler line 058
+// filler line 059
+// filler line 060
+// filler line 061
+// filler line 062
+// filler line 063
+// filler line 064
+// filler line 065
+// filler line 066
+// filler line 067
+// filler line 068
+// filler line 069
+// filler line 070
+// filler line 071
+// filler line 072
+// filler line 073
+// filler line 074
+// filler line 075
+// filler line 076
+// filler line 077
+// filler line 078
+// filler line 079
+// filler line 080
+// filler line 081
+// filler line 082
+// filler line 083
+// filler line 084
+// filler line 085
+// filler line 086
+// filler line 087
+// filler line 088
+// filler line 089
+// filler line 090
+// filler line 091
+// filler line 092
+// filler line 093
+// filler line 094
+// filler line 095
+// filler line 096
+// filler line 097
+// filler line 098
+// filler line 099
+// filler line 100
+// filler line 101
+// filler line 102
+// filler line 103
+// filler line 104
+// filler line 105
+// filler line 106
+// filler line 107
+// filler line 108
+// filler line 109
+// filler line 110
+// filler line 111
+// filler line 112
+// filler line 113
+// filler line 114
+// filler line 115
+// filler line 116
+// filler line 117
+// filler line 118
+// filler line 119
+// filler line 120
+// filler line 121
+// filler line 122
+// filler line 123
+// filler line 124
+// filler line 125
+// filler line 126
+// filler line 127
+// filler line 128
+// filler line 129
+// filler line 130
+// filler line 131
+// filler line 132
+// filler line 133
+// filler line 134
+// filler line 135
+// filler line 136
+// filler line 137
+// filler line 138
+// filler line 139
+// filler line 140
+// filler line 141
+// filler line 142
+// filler line 143
+// filler line 144
+// filler line 145
+// filler line 146
+// filler line 147
+// filler line 148
+// filler line 149
+// filler line 150
+// filler line 151
+// filler line 152
+// filler line 153
+// filler line 154
+// filler line 155
+// filler line 156
+// filler line 157
+// filler line 158
+// filler line 159
+// filler line 160
+// filler line 161
+// filler line 162
+// filler line 163
+// filler line 164
+// filler line 165
+// filler line 166
+// filler line 167
+// filler line 168
+// filler line 169
+// filler line 170
+// filler line 171
+// filler line 172
+// filler line 173
+// filler line 174
+// filler line 175
+// filler line 176
+// filler line 177
+// filler line 178
+// filler line 179
+// filler line 180
+// filler line 181
+// filler line 182
+// filler line 183
+// filler line 184
+// filler line 185
+// filler line 186
+// filler line 187
+// filler line 188
+// filler line 189
+// filler line 190
+// filler line 191
+// filler line 192
+// filler line 193
+// filler line 194
+// filler line 195
+// filler line 196
+// filler line 197
+// filler line 198
+// filler line 199
+// filler line 200
+// filler line 201
+// filler line 202
+// filler line 203
+// filler line 204
+// filler line 205
+// filler line 206
+// filler line 207
+// filler line 208
+// filler line 209
+// filler line 210
+// filler line 211
+// filler line 212
+// filler line 213
+// filler line 214
+// filler line 215
+// filler line 216
+// filler line 217
+// filler line 218
+// filler line 219
+// filler line 220
+// filler line 221
+// filler line 222
+// filler line 223
+// filler line 224
+// filler line 225
+// filler line 226
+// filler line 227
+// filler line 228
+// filler line 229
+// filler line 230
+// filler line 231
+// filler line 232
+// filler line 233
+// filler line 234
+// filler line 235
+// filler line 236
+// filler line 237
+// filler line 238
+// filler line 239
+// filler line 240
+// filler line 241
+// filler line 242
+// filler line 243
+// filler line 244
+// filler line 245
+// filler line 246
+// filler line 247
+// filler line 248
+// filler line 249
+// filler line 250
+// filler line 251
+// filler line 252
+// filler line 253
+// filler line 254
+// filler line 255
+// filler line 256
+// filler line 257
+// filler line 258
+// filler line 259
+// filler line 260
+// filler line 261
+// filler line 262
+// filler line 263
+// filler line 264
+// filler line 265
+// filler line 266
+// filler line 267
+// filler line 268
+// filler line 269
+// filler line 270
+// filler line 271
+// filler line 272
+// filler line 273
+// filler line 274
+// filler line 275
+// filler line 276
+// filler line 277
+// filler line 278
+// filler line 279
+// filler line 280
+// filler line 281
+// filler line 282
+// filler line 283
+// filler line 284
+// filler line 285
+// filler line 286
+// filler line 287
+// filler line 288
+// filler line 289
+// filler line 290
+// filler line 291
+// filler line 292
+// filler line 293
+// filler line 294
+// filler line 295
+// filler line 296
+// filler line 297
+// filler line 298
+// filler line 299
+// filler line 300
+// filler line 301
+
+fn main() {}

package/template/server/dylint/backbone_server_lints/ui/long_file.stderr

@@ -0,0 +1,6 @@
+warning: Rust source file has 303 lines; split files above 300 lines
+   |
+   = note: `#[warn(max_file_length)]` on by default
+
+warning: 1 warning emitted
+

package/template/server/dylint/backbone_server_lints/ui/main.rs

@@ -0,0 +1,59 @@
+mod sqlx {
+    pub fn query<T>(_sql: T) {}
+}
+
+mod reqwest {
+    pub struct Client;
+}
+
+mod connectrpc {
+    pub struct ConnectError;
+    pub struct ErrorCode;
+}
+
+mod axum {
+    pub mod http {
+        pub struct StatusCode;
+    }
+
+    pub mod response {
+        pub trait IntoResponse {}
+    }
+}
+
+use axum::{http::StatusCode, response::IntoResponse};
+use connectrpc::{ConnectError, ErrorCode};
+use reqwest::Client;
+
+trait TasksService {
+    fn list_tasks(&self);
+}
+
+struct TasksRpcService;
+
+impl TasksService for TasksRpcService {
+    fn list_tasks(&self) {}
+}
+
+pub fn external_webhook_handler() {}
+
+fn read_database_url() {
+    let _ = std::env::var("DATABASE_URL");
+}
+
+fn list_rows() {
+    sqlx::query("SELECT 1");
+}
+
+fn dynamic_rows(table: &str) {
+    sqlx::query(format!("SELECT * FROM {table}"));
+}
+
+fn main() {
+    read_database_url();
+    list_rows();
+    dynamic_rows("tasks");
+    let _ = (Client, ConnectError, ErrorCode, StatusCode);
+    let service = TasksRpcService;
+    service.list_tasks();
+}

package/template/server/dylint/backbone_server_lints/ui/main.stderr

@@ -0,0 +1,85 @@
+error: Axum response error types should only be mapped in rest modules
+  --> $DIR/main.rs:24:12
+   |
+LL | use axum::{http::StatusCode, response::IntoResponse};
+   |            ^^^^^^^^^^^^^^^^
+   |
+   = note: `#[deny(rest_errors_mapped_at_boundary)]` on by default
+
+error: Axum response error types should only be mapped in rest modules
+  --> $DIR/main.rs:24:30
+   |
+LL | use axum::{http::StatusCode, response::IntoResponse};
+   |                              ^^^^^^^^^^^^^^^^^^^^^^
+
+error: Connect RPC errors should only be mapped in rpc modules
+  --> $DIR/main.rs:25:18
+   |
+LL | use connectrpc::{ConnectError, ErrorCode};
+   |                  ^^^^^^^^^^^^
+   |
+   = note: `#[deny(rpc_errors_mapped_at_boundary)]` on by default
+
+error: Connect RPC errors should only be mapped in rpc modules
+  --> $DIR/main.rs:25:32
+   |
+LL | use connectrpc::{ConnectError, ErrorCode};
+   |                                ^^^^^^^^^
+
+error: reqwest usage should live behind integrations modules
+  --> $DIR/main.rs:26:1
+   |
+LL | use reqwest::Client;
+   | ^^^^^^^^^^^^^^^^^^^^
+   |
+   = note: `#[deny(no_http_client_outside_integrations)]` on by default
+
+error: RPC method implementations should be bridged from rpc/<service>/mod.rs with logic in a sibling method file
+  --> $DIR/main.rs:35:5
+   |
+LL |     fn list_tasks(&self) {}
+   |     ^^^^^^^^^^^^^^^^^^^^^^^
+   |
+   = note: `#[deny(rpc_method_in_separate_file)]` on by default
+
+error: Axum endpoint handlers should live in rest modules
+  --> $DIR/main.rs:38:1
+   |
+LL | pub fn external_webhook_handler() {}
+   | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+   |
+   = note: `#[deny(rest_endpoint_in_rest_folder)]` on by default
+
+error: environment variable access should be centralized in config modules
+  --> $DIR/main.rs:41:13
+   |
+LL |     let _ = std::env::var("DATABASE_URL");
+   |             ^^^^^^^^^^^^^
+   |
+   = note: `#[deny(no_direct_env_var_outside_config)]` on by default
+
+error: sqlx calls are only allowed in db modules
+  --> $DIR/main.rs:45:5
+   |
+LL |     sqlx::query("SELECT 1");
+   |     ^^^^^^^^^^^
+   |
+   = note: `#[deny(sqlx_only_in_db_folder)]` on by default
+
+warning: sqlx query strings should be string literals or sqlx macros
+  --> $DIR/main.rs:48:1
+   |
+LL | / fn dynamic_rows(table: &str) {
+LL | |     sqlx::query(format!("SELECT * FROM {table}"));
+LL | | }
+   | |_^
+   |
+   = note: `#[warn(no_sql_string_construction)]` on by default
+
+error: sqlx calls are only allowed in db modules
+  --> $DIR/main.rs:49:5
+   |
+LL |     sqlx::query(format!("SELECT * FROM {table}"));
+   |     ^^^^^^^^^^^
+
+error: aborting due to 10 previous errors; 1 warning emitted

package/template/server/migrations/20260520120000_create_projects.sql

@@ -0,0 +1,12 @@
+CREATE TABLE projects (
+    id TEXT PRIMARY KEY NOT NULL DEFAULT (
+        lower(hex(randomblob(4))) || '-' ||
+        lower(hex(randomblob(2))) || '-4' ||
+        substr(lower(hex(randomblob(2))), 2) || '-' ||
+        substr('89ab', abs(random()) % 4 + 1, 1) ||
+        substr(lower(hex(randomblob(2))), 2) || '-' ||
+        lower(hex(randomblob(6)))
+    ),
+    project_user TEXT NOT NULL,
+    project_name TEXT NOT NULL
+);

package/template/server/migrations/20260524160000_create_hello_world_inputs.sql

@@ -0,0 +1,12 @@
+CREATE TABLE hello_world_inputs (
+    id TEXT PRIMARY KEY NOT NULL DEFAULT (
+        lower(hex(randomblob(4))) || '-' ||
+        lower(hex(randomblob(2))) || '-4' ||
+        substr(lower(hex(randomblob(2))), 2) || '-' ||
+        substr('89ab', abs(random()) % 4 + 1, 1) ||
+        substr(lower(hex(randomblob(2))), 2) || '-' ||
+        lower(hex(randomblob(6)))
+    ),
+    input TEXT NOT NULL,
+    created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP
+);

package/template/server/src/config.rs

@@ -0,0 +1,27 @@
+use anyhow::Context as _;
+
+#[derive(Clone)]
+pub struct ServerConfig {
+    pub host: String,
+    pub port: String,
+    pub database_url: String,
+}
+
+impl ServerConfig {
+    pub fn from_env() -> anyhow::Result<Self> {
+        Ok(Self {
+            host: read_env("SERVER_HOST")?,
+            port: read_env("SERVER_PORT")?,
+            database_url: read_env("DATABASE_URL")?,
+        })
+    }
+
+    #[must_use]
+    pub fn bind_addr(&self) -> String {
+        format!("{}:{}", self.host, self.port)
+    }
+}
+
+fn read_env(name: &str) -> anyhow::Result<String> {
+    std::env::var(name).with_context(|| format!("read {name}"))
+}

package/template/server/src/db/hello_world.rs

@@ -0,0 +1,34 @@
+use super::Db;
+
+impl Db {
+    pub async fn record_hello_world_input(&self, input: &str) -> anyhow::Result<()> {
+        sqlx::query(
+            r"
+            INSERT INTO hello_world_inputs (input)
+            VALUES (?)
+            ",
+        )
+        .bind(input)
+        .execute(&self.pool)
+        .await?;
+
+        Ok(())
+    }
+
+    #[cfg(test)]
+    pub async fn list_hello_world_inputs(&self) -> anyhow::Result<Vec<String>> {
+        let rows = sqlx::query(
+            r"
+            SELECT input
+            FROM hello_world_inputs
+            ORDER BY created_at, id
+            ",
+        )
+        .fetch_all(&self.pool)
+        .await?;
+
+        rows.into_iter()
+            .map(|row| Ok(sqlx::Row::try_get(&row, "input")?))
+            .collect()
+    }
+}

package/template/server/src/db/hello_world_tests.rs

@@ -0,0 +1,11 @@
+use super::Db;
+
+#[tokio::test]
+async fn record_hello_world_input_persists_submitted_names() -> anyhow::Result<()> {
+    let db = Db::in_memory().await?;
+
+    db.record_hello_world_input("Playwright").await?;
+
+    assert_eq!(db.list_hello_world_inputs().await?, vec!["Playwright"]);
+    Ok(())
+}

package/template/server/src/db/mod.rs

@@ -0,0 +1,39 @@
+mod hello_world;
+#[cfg(test)]
+mod hello_world_tests;
+
+use anyhow::Context as _;
+use sqlx::{SqlitePool, sqlite::SqlitePoolOptions};
+
+#[derive(Clone)]
+pub struct Db {
+    pool: SqlitePool,
+}
+
+impl Db {
+    pub async fn connect(database_url: &str) -> anyhow::Result<Self> {
+        let pool = SqlitePoolOptions::new()
+            .max_connections(5)
+            .connect(database_url)
+            .await
+            .context("connect database")?;
+
+        sqlx::migrate!("./migrations")
+            .run(&pool)
+            .await
+            .context("run database migrations")?;
+
+        Ok(Self { pool })
+    }
+
+    #[cfg(test)]
+    async fn in_memory() -> anyhow::Result<Self> {
+        let pool = SqlitePoolOptions::new()
+            .max_connections(1)
+            .connect("sqlite::memory:")
+            .await?;
+
+        sqlx::migrate!("./migrations").run(&pool).await?;
+        Ok(Self { pool })
+    }
+}

package/template/server/src/lib.rs

@@ -0,0 +1,10 @@
+pub mod config;
+pub mod db;
+
+#[allow(clippy::pedantic)]
+pub mod proto {
+    connectrpc::include_generated!();
+}
+
+pub mod rpc;
+pub mod state;

package/template/server/src/main.rs

@@ -0,0 +1,43 @@
+use std::{net::SocketAddr, sync::Arc};
+
+use anyhow::Context as _;
+use axum::{Router, routing::get};
+use connectrpc::Router as ConnectRouter;
+use server::{
+    config::ServerConfig, db::Db, proto::helloworld::v1::GreeterServiceExt,
+    rpc::greeter::GreeterRpcService, state::AppState,
+};
+use tower_http::{cors::CorsLayer, trace::TraceLayer};
+use tracing::info;
+use tracing_subscriber::{EnvFilter, fmt};
+
+#[tokio::main]
+async fn main() -> anyhow::Result<()> {
+    fmt()
+        .with_env_filter(EnvFilter::from_default_env().add_directive("server=info".parse()?))
+        .init();
+
+    let config = ServerConfig::from_env()?;
+    let bind_addr = config.bind_addr();
+    let db = Db::connect(&config.database_url).await?;
+    let app_state = AppState::new(db);
+
+    let connect =
+        Arc::new(GreeterRpcService::new(app_state.clone())).register(ConnectRouter::new());
+    let app = Router::new()
+        .route("/health", get(|| async { "OK" }))
+        .fallback_service(connect.into_axum_service())
+        .with_state(app_state)
+        .layer(CorsLayer::permissive())
+        .layer(TraceLayer::new_for_http());
+
+    let listener = tokio::net::TcpListener::bind(&bind_addr)
+        .await
+        .with_context(|| format!("bind {bind_addr}"))?;
+    let addr: SocketAddr = listener.local_addr().context("read bound address")?;
+
+    info!("server listening on http://{addr}");
+    axum::serve(listener, app).await.context("serve")?;
+
+    Ok(())
+}

package/template/server/src/rpc/greeter/mod.rs

@@ -0,0 +1,31 @@
+mod say_hello;
+
+use connectrpc::{ConnectError, RequestContext, Response};
+
+use crate::{
+    proto::helloworld::v1::{GreeterService, OwnedSayHelloRequestView, SayHelloResponse},
+    state::AppState,
+};
+
+#[derive(Clone)]
+pub struct GreeterRpcService {
+    pub(super) state: AppState,
+}
+
+impl GreeterRpcService {
+    #[must_use]
+    pub fn new(state: AppState) -> Self {
+        Self { state }
+    }
+}
+
+#[allow(refining_impl_trait)]
+impl GreeterService for GreeterRpcService {
+    async fn say_hello(
+        &self,
+        ctx: RequestContext,
+        request: OwnedSayHelloRequestView,
+    ) -> Result<Response<SayHelloResponse>, ConnectError> {
+        say_hello::handle(self, ctx, &request).await
+    }
+}