Add better-auth package with core object schemas

Introduces the @objectql/better-auth package, including TypeScript configuration and object schema definitions for user, account, session, and verification entities to support authentication features.

Author: hotlong

packages/better-auth/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@objectql/better-auth",
+  "version": "0.1.0",
+  "description": "Better-Auth integration for ObjectQL",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest"
+  },
+  "dependencies": {
+    "@objectql/core": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}

packages/better-auth/src/account.object.yml

@@ -0,0 +1,37 @@
+name: account
+description: External authentication account (OAuth etc)
+fields:
+  userId:
+    type: string
+    description: ID of the user
+    required: true
+  accountId:
+    type: string
+    description: Account ID from provider
+    required: true
+  providerId:
+    type: string
+    description: Provider ID (google, github, etc)
+    required: true
+  accessToken:
+    type: string
+    description: Access Token
+  refreshToken:
+    type: string
+    description: Refresh Token
+  accessTokenExpiresAt:
+    type: datetime
+  refreshTokenExpiresAt:
+    type: datetime
+  scope:
+    type: string
+  password:
+    type: string
+    description: Password if applicable (usually in user, but for completeness)
+    hidden: true
+  createdAt:
+    type: datetime
+    default: now()
+  updatedAt:
+    type: datetime
+    default: now()

packages/better-auth/src/session.object.yml

@@ -0,0 +1,28 @@
+name: session
+description: User authentication session
+fields:
+  userId:
+    type: string
+    description: ID of the user
+    required: true
+  token:
+    type: string
+    description: Session token
+    unique: true
+    required: true
+  expiresAt:
+    type: datetime
+    description: When the session expires
+    required: true
+  ipAddress:
+    type: string
+    description: IP Address of the client
+  userAgent:
+    type: string
+    description: User Agent of the client
+  createdAt:
+    type: datetime
+    default: now()
+  updatedAt:
+    type: datetime
+    default: now()

packages/better-auth/src/user.object.yml

@@ -0,0 +1,42 @@
+name: user
+description: System user for authentication
+fields:
+  name:
+    type: string
+    description: User's display name
+  email:
+    type: string
+    description: User's email address
+    unique: true
+  emailVerified:
+    type: boolean
+    description: Whether the email is verified
+    default: false
+  image:
+    type: string
+    description: URL to user's avatar
+  createdAt:
+    type: datetime
+    default: now()
+  updatedAt:
+    type: datetime
+    default: now()
+  # Better Auth Specifics
+  password:
+    type: string
+    description: Hashed password
+    hidden: true
+  role:
+    type: string
+    description: User role (admin, user, etc)
+    default: user
+  banned:
+    type: boolean
+    description: Whether the user is banned
+    default: false
+  banReason:
+    type: string
+    description: Reason for ban
+  banExpires:
+    type: datetime
+    description: When the ban expires

packages/better-auth/src/verification.object.yml

@@ -0,0 +1,21 @@
+name: verification
+description: Verification tokens for email etc
+fields:
+  identifier:
+    type: string
+    description: Email or phone number
+    required: true
+  value:
+    type: string
+    description: Verification token
+    required: true
+  expiresAt:
+    type: datetime
+    description: Expiration time
+    required: true
+  createdAt:
+    type: datetime
+    default: now()
+  updatedAt:
+    type: datetime
+    default: now()

packages/better-auth/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"]
+}