Refactor: Rename to auth.zod.ts with shorter AuthConfig names and add driver field

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

content/docs/references/misc/AuthenticationConfig.mdx

@@ -0,0 +1,32 @@
+---
+title: AuthenticationConfig
+description: AuthenticationConfig Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **name** | `string` | ✅ | Configuration name (snake_case) |
+| **label** | `string` | ✅ | Display label |
+| **strategies** | `Enum<'email_password' \| 'magic_link' \| 'oauth' \| 'passkey' \| 'otp' \| 'anonymous'>[]` | ✅ | Enabled authentication strategies |
+| **baseUrl** | `string` | ✅ | Application base URL |
+| **secret** | `string` | ✅ | Secret key for signing (min 32 chars) |
+| **emailPassword** | `object` | optional |  |
+| **magicLink** | `object` | optional |  |
+| **passkey** | `object` | optional |  |
+| **oauth** | `object` | optional |  |
+| **session** | `object` | optional |  |
+| **rateLimit** | `object` | optional |  |
+| **csrf** | `object` | optional |  |
+| **accountLinking** | `object` | optional |  |
+| **twoFactor** | `object` | optional |  |
+| **userFieldMapping** | `object` | optional |  |
+| **database** | `object` | optional |  |
+| **plugins** | `object[]` | optional |  |
+| **hooks** | `object` | optional | Authentication lifecycle hooks |
+| **security** | `object` | optional | Advanced security settings |
+| **email** | `object` | optional | Email configuration |
+| **ui** | `object` | optional | UI customization |
+| **active** | `boolean` | optional | Whether this provider is active |
+| **allowRegistration** | `boolean` | optional | Allow new user registration |

content/docs/references/misc/AuthenticationProvider.mdx

@@ -0,0 +1,11 @@
+---
+title: AuthenticationProvider
+description: AuthenticationProvider Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **type** | `string` | ✅ | Provider type identifier |
+| **config** | `object` | ✅ | Authentication configuration |

content/docs/references/system/AuthConfig.mdx

@@ -0,0 +1,33 @@
+---
+title: AuthConfig
+description: AuthConfig Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **name** | `string` | ✅ | Configuration name (snake_case) |
+| **label** | `string` | ✅ | Display label |
+| **driver** | `string` | optional | The underlying authentication implementation driver |
+| **strategies** | `Enum<'email_password' \| 'magic_link' \| 'oauth' \| 'passkey' \| 'otp' \| 'anonymous'>[]` | ✅ | Enabled authentication strategies |
+| **baseUrl** | `string` | ✅ | Application base URL |
+| **secret** | `string` | ✅ | Secret key for signing (min 32 chars) |
+| **emailPassword** | `object` | optional |  |
+| **magicLink** | `object` | optional |  |
+| **passkey** | `object` | optional |  |
+| **oauth** | `object` | optional |  |
+| **session** | `object` | optional |  |
+| **rateLimit** | `object` | optional |  |
+| **csrf** | `object` | optional |  |
+| **accountLinking** | `object` | optional |  |
+| **twoFactor** | `object` | optional |  |
+| **userFieldMapping** | `object` | optional |  |
+| **database** | `object` | optional |  |
+| **plugins** | `object[]` | optional |  |
+| **hooks** | `object` | optional | Authentication lifecycle hooks |
+| **security** | `object` | optional | Advanced security settings |
+| **email** | `object` | optional | Email configuration |
+| **ui** | `object` | optional | UI customization |
+| **active** | `boolean` | optional | Whether this provider is active |
+| **allowRegistration** | `boolean` | optional | Allow new user registration |

content/docs/references/system/StandardAuthProvider.mdx

@@ -0,0 +1,11 @@
+---
+title: StandardAuthProvider
+description: StandardAuthProvider Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **type** | `string` | ✅ | Provider type identifier |
+| **config** | `object` | ✅ | Standard authentication configuration |

docs/AUTHENTICATION.md docs/AUTHENTICATION_STANDARD.mddocs/AUTHENTICATION.md renamed to docs/AUTHENTICATION_STANDARD.md

@@ -1,12 +1,20 @@
-# Authentication Protocol
+# ObjectStack Authentication Standard
 
-A comprehensive authentication specification for the ObjectStack ecosystem.
+The standard authentication protocol specification for the ObjectStack ecosystem.
 
 ## Overview
 
-This specification defines the standard authentication protocol for ObjectStack applications. It supports multiple authentication strategies, session management, and comprehensive security features.
+This document defines the **ObjectStack Authentication Standard**, a comprehensive, framework-agnostic authentication protocol for ObjectStack applications. This standard supports multiple authentication strategies, session management, and comprehensive security features.
 
-The specification is framework-agnostic and can be implemented with any authentication library (better-auth, Auth.js, Passport, etc.)
+The specification is designed as an **interface** that can be implemented by any authentication library. **better-auth** serves as the **Reference Implementation** (default driver) for this standard.
+
+### Implementation Drivers
+
+The authentication standard can be implemented using various drivers:
+- **better-auth** (default/reference implementation)
+- Auth.js
+- Passport
+- Custom implementations
 
 ## Features
 
@@ -54,11 +62,12 @@ pnpm add @objectstack/plugin-better-auth
 ### Basic Example
 
 ```typescript
-import type { AuthenticationConfig } from '@objectstack/spec';
+import type { AuthConfig } from '@objectstack/spec';
 
-const authConfig: AuthenticationConfig = {
+const authConfig: AuthConfig = {
   name: 'main_auth',
   label: 'Main Authentication',
+  driver: 'better-auth', // Optional, defaults to 'better-auth'
   strategies: ['email_password'],
   baseUrl: 'https://app.example.com',
   secret: process.env.AUTH_SECRET!,