an5-adapters 0.1.0

Standalone database adapter runtime for AN5 ORM (Rust) — connection handling, dialect-aware CRUD, aggregates and vector search.
Documentation
# an5-adapters

Database adapter runtime for [AN5 ORM](https://github.com/an5ORM/an5) in Rust.

`An5Adapter` owns the connection and the dialect; `TableClient` provides the ORM
CRUD surface on top of [`sqlx`](https://github.com/launchbadge/sqlx). Dialects are
detected from the connection string, so SQL Server, PostgreSQL and SQLite are
handled without configuration. This crate mirrors the TypeScript, Python, .NET
and Go adapter packages.

## Install

```toml
[dependencies]
an5-adapters = "0.1"
```

The crate is driver-agnostic: it depends on `sqlx` with `any`, so the application
picks the driver it needs and enables the matching `sqlx` feature.

```toml
[dependencies]
sqlx = { version = "0.8", default-features = false, features = ["any", "runtime-tokio", "postgres"] }
```

## Usage

```rust
use an5_adapters::{An5Adapter, FindManyArgs};
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
    // Register the drivers this binary needs, then hand the URL to the adapter.
    sqlx::any::install_drivers(&[sqlx::postgres::any::DRIVER])?;
    let db = An5Adapter::connect("postgres://localhost:5432/mydb").await?;

    // Dynamic access, the Rust equivalent of `db.user` in TypeScript.
    let users = db
        .table("User")
        .find_many(&FindManyArgs {
            r#where: Some(json!({ "email": { "contains": "@example.com" } })),
            take: 10,
            ..Default::default()
        })
        .await?;

    println!("{} users", users.len());
    Ok(())
}
```

Generated Rust clients (`an5-client`) wrap this crate and expose one typed handle
per model — `db.user().find_many(&UserFindManyArgs { .. })` — instead of the
dynamic `db.table("User")` access shown above.

### Features

- `An5Adapter::connect` / `create_an5_adapter`, with the connection string read
  from `DATABASE_URL` when omitted
- Dialect detection and identifier quoting for MSSQL, PostgreSQL and SQLite
- `TableClient`: `find_many`, `find_first`, `find_unique`, `count`, `create`,
  `create_many`, `update`, `update_many`, `delete_many`, `upsert`, `aggregate`,
  `group_by` and `vector_search`
- Transactions, raw SQL execution and view clients
- `base` module with the where/order-by builders, adapter metadata and vector
  distance math

## License

MIT