@cloudauth/cloud-auth 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,128 @@
+# CloudAuth
+
+**Lightweight OAuth-only authentication for TypeScript apps.**
+
+No passwords. No dashboard. No bloat. Just providers, users, sessions, and extensibility.
+
+```ts
+import { cloudAuth } from "@cloudauth/cloud-auth"
+import { google, github } from "@cloudauth/cloud-auth/providers"
+import { drizzleAdapter } from "@cloudauth/cloud-auth/adapters/drizzle"
+
+export const auth = cloudAuth({
+  appName: "My App",
+  baseURL: "https://app.example.com",
+  providers: [google({ clientId, clientSecret })],
+  database: drizzleAdapter(db),
+  security: { secret: process.env.AUTH_SECRET },
+})
+```
+
+## Features
+
+- **OAuth/OIDC only** — Google, GitHub, generic OAuth, generic OIDC
+- **Authorization Code Flow with PKCE** — industry standard security
+- **Secure sessions** — HTTP-only cookies, HMAC-signed, rolling expiration
+- **TypeScript-first** — strict types with full inference
+- **Framework-agnostic** — Hono integration built-in (Express, Next.js coming)
+- **Drizzle ORM** — SQLite, Postgres, D1 support via adapter
+- **Pluggable** — hooks system, additional fields, custom adapters
+- **No admin dashboard** — you own your UI
+- **No password management** — no hashing, no reset flows, no breach checks
+
+## Quick Start
+
+### 1. Install
+
+```bash
+pnpm add @cloudauth/cloud-auth drizzle-orm @libsql/client
+pnpm add -D drizzle-kit
+```
+
+### 2. Set up auth
+
+```ts
+// src/auth.ts
+import { cloudAuth } from "@cloudauth/cloud-auth"
+import { google } from "@cloudauth/cloud-auth/providers"
+import { drizzleAdapter } from "@cloudauth/cloud-auth/adapters/drizzle"
+import { drizzle } from "drizzle-orm/libsql"
+import { createClient } from "@libsql/client"
+
+const client = createClient({ url: "file:./data.db" })
+const db = drizzle(client)
+
+export const auth = cloudAuth({
+  appName: "My App",
+  baseURL: "http://localhost:3000",
+  providers: [
+    google({
+      clientId: process.env.GOOGLE_CLIENT_ID!,
+      clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
+    }),
+  ],
+  database: drizzleAdapter(db),
+  session: { expiresIn: 60 * 60 * 24 * 30 },
+  security: { secret: process.env.AUTH_SECRET! },
+})
+```
+
+### 3. Add auth routes (Hono)
+
+```ts
+import { Hono } from "hono"
+import { authHandler, requireAuth } from "@cloudauth/cloud-auth/hono"
+import { auth } from "./auth"
+
+const app = new Hono()
+app.route("/auth", authHandler(auth))
+
+app.get("/dashboard", requireAuth(auth), (c) => {
+  const session = c.get("session")
+  return c.json({ user: session.user })
+})
+```
+
+### 4. Set environment variables
+
+```env
+AUTH_SECRET=your-secret-at-least-32-characters-long
+BASE_URL=http://localhost:3000
+GOOGLE_CLIENT_ID=...
+GOOGLE_CLIENT_SECRET=...
+```
+
+## Why CloudAuth?
+
+Better Auth is excellent but broad. CloudAuth is intentionally narrow:
+
+| Feature | Better Auth | CloudAuth |
+|---|---|---|
+| OAuth/OIDC | ✅ | ✅ |
+| Email/Password | ✅ | ❌ |
+| Magic Links | ✅ | ❌ |
+| MFA/2FA | ✅ | ❌ |
+| Built-in RBAC | ✅ | ❌ |
+| Admin Dashboard | ✅ | ❌ |
+| SAML SSO | ✅ | ❌ |
+| Schema size | ~15 tables | **4 tables** |
+| TypeScript inference | ✅ | ✅ |
+
+## Package Architecture
+
+```
+@cloudauth/cloud-auth                    — Core: config, auth engine, utilities
+@cloudauth/cloud-auth/providers          — Provider implementations
+@cloudauth/cloud-auth/adapters/drizzle   — Drizzle ORM adapter
+@cloudauth/cloud-auth/hono               — Hono framework integration
+@cloudauth/cloud-auth/client             — Browser client SDK
+@cloudauth/cloud-auth/client/react       — React bindings
+```
+
+## Status
+
+Alpha — under active development. All phases are being built in sequence.
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudauth/cloud-auth",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Lightweight OAuth-only authentication for TypeScript apps",
   "type": "module",
   "main": "./dist/index.js",
@@ -52,9 +52,9 @@
     "@cloudauth/providers": "0.1.0",
     "@cloudauth/core": "0.1.0",
     "@cloudauth/adapter-drizzle": "0.1.0",
-    "@cloudauth/client": "0.1.0",
+    "@cloudauth/integration-hono": "0.1.0",
     "@cloudauth/cli": "0.1.0",
-    "@cloudauth/integration-hono": "0.1.0"
+    "@cloudauth/client": "0.1.0"
   },
   "peerDependencies": {
     "@libsql/client": "^0.17.0"
@@ -68,6 +68,15 @@
     "node": ">=20.0.0"
   },
   "license": "MIT",
+  "author": "Javed Quadri",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/javedquadri/cloudauth.git"
+  },
+  "homepage": "https://github.com/javedquadri/cloudauth#readme",
+  "bugs": {
+    "url": "https://github.com/javedquadri/cloudauth/issues"
+  },
   "keywords": [
     "authentication",
     "oauth",