@xylex-group/athena 2.4.1 → 2.6.0

package/README.md

@@ -1,6 +1,6 @@
 # athena-js
 
-current version: `2.4.1`
+current version: `2.6.0`
 `@xylex-group/athena` is a database driver and API gateway SDK that lets you interact with SQL backends over HTTP through a fluent builder API. It ships a typed query builder for Node.js / server environments plus Athena-native React hooks for client-side use.
 
 ## Install
@@ -188,6 +188,56 @@ pnpm add @react-email/components @react-email/render
 
 Auth responses follow the same envelope style: `{ ok, status, data, error, errorDetails, raw }`.
 
+#### Native auth bootstrap helpers
+
+If you want to remove `better-auth` from an app that is already aligned to
+Athena Auth session semantics, the SDK now ships a native bootstrap layer with
+an Athena-native `athenaAuth({...})` export that matches the Better Auth
+top-level contract:
+
+```ts
+import { athenaAuth } from "@xylex-group/athena";
+
+export function getAuth(env: {
+  DB: unknown;
+  ATHENA_AUTH_URL: string;
+  ATHENA_AUTH_SECRET: string;
+  GITHUB_CLIENT_ID: string;
+  GITHUB_CLIENT_SECRET: string;
+}) {
+  return athenaAuth({
+    baseURL: env.ATHENA_AUTH_URL,
+    secret: env.ATHENA_AUTH_SECRET,
+    database: env.DB,
+    socialProviders: {
+      github: {
+        clientId: env.GITHUB_CLIENT_ID,
+        clientSecret: env.GITHUB_CLIENT_SECRET,
+        scope: ["repo", "read:org", "user:email"],
+      },
+    },
+  });
+}
+```
+
+The returned auth object now carries the Better Auth-style top-level contract:
+
+- `handler(request)`
+- `api`
+- `options`
+- `$context`
+- `$ERROR_CODES`
+
+This native layer currently covers:
+
+- typed auth bootstrap config
+- session cookie set/clear helpers via the SDK cookie primitives
+
+It also supports dynamic `baseURL` host resolution plus static/dynamic
+`trustedOrigins` and `trustedProviders` on the native server bootstrap.
+
+For the full details and current scope, see [`docs/auth/server-bootstrap.mdx`](docs/auth/server-bootstrap.mdx).
+
 ### Typed schema registry (model-first)
 
 You can keep `createClient(...).from<T>(...)` as-is, or opt into a typed registry:
@@ -251,6 +301,7 @@ Generator supports:
 - Multiple schema syncs such as `public` plus `athena`, with schema-safe default output paths
 - Placeholder-driven output paths
 - Feature flags (`features.emitRegistry`, `features.emitRelations`)
+- Typed env-backed config fields via `generatorEnv(...)` for connection strings, schema lists, naming styles, flags, and placeholder maps
 
 For full generator configuration and troubleshooting, see [`docs/generator-config.md`](./docs/generator-config.md).
 For full CLI commands, help behavior, and troubleshooting, see [`docs/cli-command-reference.md`](./docs/cli-command-reference.md).