Skip to content

armgit / crm

Public Imported from GitHub
0

Comp AI CRM is an open source, CRM designed for AI agents. Agentic-first CRM.

TypeScript
3.8 KB
Raw Blame

@crm/auth

Better Auth configuration for the monorepo, backed by @crm/db.

Enabled: Google sign-in, account linking, cookie-cached sessions, and database-backed rate limiting. This is an internal, single-tenant app — there are no organizations, and email + password is switched off so the only way in is a Google account.

Topology

The NestJS API (apps/api, port 3001) mounts /api/auth/* via @thallesp/nestjs-better-auth and is the only process that writes session cookies. The Next.js app (apps/app, port 3000) imports this package on the server to read sessions straight from Postgres, and points its browser client at the API for sign-in and sign-out.

Both processes therefore need the same BETTER_AUTH_SECRET and DATABASE_URL, or the cookie one writes will not verify in the other.

Usage

Server

import { auth } from "@crm/auth/auth";

// Session for an incoming request
const session = await auth.api.getSession({ headers: request.headers });

auth.handler is a standard (Request) => Promise<Response> function, so it mounts anywhere. In a Next.js App Router route (app/api/auth/[...all]/route.ts):

import { auth } from "@crm/auth/auth";

export const GET = auth.handler;
export const POST = auth.handler;

Client

import { signIn, signOut, useSession } from "@crm/auth/client";

await signIn.social({ provider: "google", callbackURL: "/" });

NEXT_PUBLIC_API_URL decides which origin the client talks to. It must point at whichever process mounts the handler — the NestJS API. The Next.js app inlines it at build time from API_URL, in next.config.ts, so there is one variable rather than two spellings of one origin. Unset, the client uses the current origin.

The client plugin list mirrors the server plugin list. Keep them in sync or the inferred client API will drift from the routes the server exposes.

Setup

cp .env.example .env      # at the repo root — there is no per-package env file
openssl rand -base64 32   # -> BETTER_AUTH_SECRET

This package is a library and never loads an env file of its own; it reads whatever process.env its host process has, and src/env.ts imports @crm/env/load so the repo-root .env is picked up even when the Better Auth CLI loads auth.ts directly. See docs/environment.md.

Create an OAuth client in the Google Cloud console and add <API_URL>/api/auth/callback/google — http://localhost:3001/api/auth/callback/google in development — as an authorised redirect URI.

ALLOWED_SIGN_IN decides who may sign in, and an empty value admits nobody. It is the whole authorisation model: there are no roles and no organizations, so src/workspace.ts is worth reading before you change anything here.

Changing the schema

Adding a plugin or an additional user field changes the database schema. After editing src/auth.ts:

bun run auth:generate   # rewrites packages/db/prisma/schema.prisma
bun run db:migrate      # create the migration

Notes

  • JIT package. exports point at TypeScript sources, which keeps Better Auth's inferred types intact — declaration emit tends to break them. Turbopack transpiles workspace packages automatically, so a Next.js app needs no transpilePackages entry.
  • Next.js server actions need the nextCookies() plugin (from better-auth/next-js) as the last entry in the plugin array. It is omitted here so the package stays framework-agnostic; add it — along with next as a dependency — once an app relies on setting cookies from server actions.
  • Cross-origin cookies. On localhost the API and the app differ only by port, which cookies ignore. Deployed on separate subdomains they need AUTH_COOKIE_DOMAIN set to the shared parent (.example.com).