1.0.0

Author: j7nw4r

.github/workflows/rust.yml

@@ -0,0 +1,83 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  check:
+    name: Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry/
+            ~/.cargo/git/
+            target/
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+      - run: cargo check --all-features
+
+  fmt:
+    name: Format
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt
+      - run: cargo fmt --all -- --check
+
+  clippy:
+    name: Clippy
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy
+      - uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry/
+            ~/.cargo/git/
+            target/
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+      - run: cargo clippy --all-features -- -D warnings
+
+  test-unit:
+    name: Unit Tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry/
+            ~/.cargo/git/
+            target/
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+      - run: cargo test --lib --all-features
+
+  test-integration:
+    name: Integration Tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry/
+            ~/.cargo/git/
+            target/
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+      - run: cargo test --test '*' --all-features

.gitignore

@@ -0,0 +1,17 @@
+# Generated by Cargo
+# will have compiled files and executables
+debug/
+target/
+
+# These are backup files generated by rustfmt
+**/*.rs.bk
+
+# MSVC Windows builds of rustc generate these, which store debugging information
+*.pdb
+
+# RustRover
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/

AGENTS.md

@@ -0,0 +1,35 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+- Crate source lives in `src/` with one module per Supabase service (`auth.rs`, `postgrest.rs`, `storage.rs`, `functions.rs`, `graphql.rs`, `realtime.rs`, `analytics.rs`); `lib.rs` re-exports them.
+- Shared constants and errors sit in `consts.rs` and `error.rs`; add cross-cutting values there before duplicating literals.
+- Integration coverage is in `tests/auth_integration.rs` and spins up real containers via Testcontainers, so Docker must be running.
+- Reference docs live in `docs/`; `README.md` shows usage patterns. Build artifacts land in `target/` and stay untracked.
+
+## Build, Test, and Development Commands
+- `cargo build --all-features` — compile with every service flag to catch cfg gaps; narrow scope with `--features "<list>"` when iterating.
+- `cargo fmt --all` — format with rustfmt; run before pushing.
+- `cargo clippy --all-targets --all-features -D warnings` — lint everything; prefer fixes over `allow` unless unavoidable.
+- `cargo test --features auth,const --test auth_integration -- --nocapture` — integration tests against real containers; first run pulls images and may take minutes.
+
+## Coding Style & Naming Conventions
+- Rustfmt defaults (4-space indent); keep imports explicit and prefer early returns over deep nesting.
+- Modules/functions use `snake_case`; public structs/enums use `PascalCase`; constants use `SCREAMING_SNAKE_CASE`.
+- Keep feature gates tight and named after services (`auth`, `postgrest`, `storage`, etc.); document new flags in `Cargo.toml` and `README.md`.
+- Use `anyhow::Result` for setup paths and `thiserror` for user-facing error types; add short doc comments for public items.
+
+## Testing Guidelines
+- Docker is mandatory; tests start PostgreSQL and service containers.
+- Name new integration files `tests/<service>_integration.rs` and test functions `test_<behavior>` for clarity.
+- Include a health or behavior check per service (e.g., `/health` plus one request).
+- For parallel runs, generate unique networks/container names (see `unique_test_id()` in the Auth suite) to avoid port collisions.
+
+## Commit & Pull Request Guidelines
+- Follow Conventional Commits used here (`feat`, `docs`, `chore`, `fix`, optional scopes); keep messages imperative.
+- PRs should note behavior changes, enabled features (if not `--all-features`), and commands run (fmt, clippy, tests).
+- Link related issues and attach logs or screenshots for user-visible changes; keep diffs focused and split unrelated tweaks.
+
+## Security & Configuration Tips
+- Never commit real credentials; mirror the test pattern of generated passwords and isolated networks.
+- Pin explicit image tags instead of `latest`; match versions documented in `README.md`.
+- Prefer Testcontainers-managed dynamic ports; expose only what the test actually needs.

CLAUDE.md

@@ -0,0 +1,61 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build and Test Commands
+
+```bash
+# Build the project
+cargo build
+
+# Build with all features
+cargo build --all-features
+
+# Build with specific feature
+cargo build --features auth
+
+# Run all tests
+cargo test --all-features
+
+# Run tests for a specific feature
+cargo test --features auth
+
+# Run a single test
+cargo test --features auth test_auth_default
+
+# Check code without building
+cargo check --all-features
+
+# Format code
+cargo fmt
+
+# Lint with clippy
+cargo clippy --all-features
+```
+
+## Architecture
+
+This crate provides testcontainers implementations for Supabase services. Each service module follows the same pattern:
+
+1. **Module structure** (`src/<service>.rs`): Each service implements the `testcontainers::Image` trait with:
+   - A struct holding `env_vars: HashMap<String, String>` for container configuration
+   - `Default` impl with pre-configured environment variables
+   - Builder methods for customization (e.g., `with_postgres_connection`)
+   - `Image` trait impl defining `name()`, `tag()`, and `ready_conditions()`
+
+2. **Feature-gated modules**: All service modules are conditionally compiled via Cargo features. The `lib.rs` re-exports public types based on enabled features.
+
+3. **Shared constants** (`src/consts.rs`): Common values like `DOCKER_INTERNAL_HOST` and `LOCAL_HOST` for container networking.
+
+## Key Patterns
+
+- Services requiring PostgreSQL use `tokio_postgres` for database initialization (see `Auth::init_db_schema`)
+- Container environment variables are stored in a `HashMap<String, String>` and exposed via the `Image::env_vars()` trait method
+- Tests use `testcontainers::runners::AsyncRunner` with tokio for async container management
+
+## Available Features
+
+- `auth`, `postgrest`, `storage`, `analytics`, `functions`, `graphql`, `realtime` - Individual service containers
+- `const` - Shared constants (auto-enabled by service features)
+- `error` - Error types
+- `postgres_testcontainer` - PostgreSQL container support