better-auth-typeorm

KO | EN

gitlite — search

#python #hacktoberfest #llm #golang #android #rust #deep-learning #docker #nodejs #macos #java #security #ios #open-source

better-auth-typeorm

(★ 54)

A typeorm adapter for better-auth

파일 탐색기

최종 버전 다운로드 (.zip)

- - ci.yml
  - release.yml
- settings.json
- - index.ts
  - typeorm-adapter.ts
- .npmignore
- package.json
- README.md
- tsconfig.json
- tsdown.config.ts
- .gitignore
- index.test.ts
- mysql.test.ts
- mysql.ts
- package.json
- postgres.test.ts
- postgres.ts
- README.md
- sqlite.test.ts
- sqlite.ts
- tsconfig.json
- typeorm-relations.test.ts
.coderabbit.yaml
.gitignore
biome.json
bump.config.ts
LICENSE
package.json
pnpm-lock.yaml
pnpm-workspace.yaml
README.md
tsconfig.json

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">
 
 📦 @hedystia/better-auth-typeorm

TypeORM adapter for Better Auth - Powerful database integration for your auth system! 🚀

## 🌟 Features

- 🗄️ **Database Agnostic**: Works with all TypeORM-supported databases (MySQL, PostgreSQL, SQLite, etc.)
- 🔄 **CRUD Operations**: Full support for create, read, update, and delete operations
- ⚡ **Efficient Queries**: Built-in pagination, sorting, and filtering support
- 🔒 **Secure Operations**: Proper transaction handling and error management
- 🗑️ **Soft Delete**: Built-in soft delete support

## 🚀 Quick Start

1. Install the package:

```bash
npm install @hedystia/better-auth-typeorm typeorm
```

2.  **Generate TypeORM Entities and Migrations**

Before you can use the adapter, you need to generate the necessary entities and migrations for your database. You can do this using the Better Auth CLI:

```bash
bunx auth generate
# or
npx auth generate
```

This command will create the `typeorm/entities` and `typeorm/migrations` directories in your project.

3.  Create your TypeORM DataSource configuration:

```typescript
import { DataSource } from "typeorm";
import path from "path";

export const dataSource = new DataSource({
  type: "mysql",
  host: "localhost",
  port: 3306,
  username: "your_username",
  password: "your_password",
  database: "your_database",
  entities: [path.join(__dirname, "typeorm/entities/**/*.ts")],
  migrations: [path.join(__dirname, "typeorm/migrations/**/*.ts")],
  migrationsRun: true,
});

await dataSource.initialize();
```

4. Set up your Better Auth configuration:

```typescript
import { betterAuth } from "better-auth";
import { typeormAdapter } from "@hedystia/better-auth-typeorm";
import { organization, twoFactor } from "better-auth/plugins";
import { dataSource } from "./data-source";

export const auth = betterAuth({
  database: typeormAdapter(dataSource),
  plugins: [organization(), twoFactor()],
});
```

## ⚙️ Configuration

### Custom Output Directories

You can customize where entities and migrations are generated by passing options to the adapter:

```typescript
import { typeormAdapter } from "@hedystia/better-auth-typeorm";

export const auth = betterAuth({
  database: typeormAdapter(dataSource, {
    outputDir: "./src/database",        // Base directory (default: "./typeorm")
    migrationsDir: "./db/migrations",   // Migrations directory (default: "{outputDir}/migrations")
    entitiesDir: "./db/entities"        // Entities directory (default: "{outputDir}/entities")
  }),
});
```

**Options:**

- `outputDir` (optional): Base directory for TypeORM files. Default: `"./typeorm"`
- `migrationsDir` (optional): Directory for migration files. Default: `"{outputDir}/migrations"`
- `entitiesDir` (optional): Directory for entity files. Default: `"{outputDir}/entities"`

**Note:** If you specify custom directories, make sure to update your DataSource configuration accordingly:

```typescript
export const dataSource = new DataSource({
  type: "mysql",
  // ... other config
  entities: [path.join(__dirname, "db/entities/**/*.ts")],
  migrations: [path.join(__dirname, "db/migrations/**/*.ts")],
  migrationsRun: true,
});
```

### Relation Column Types

Reference-backed fields generate both a scalar column and a TypeORM relation. By default, the adapter derives the foreign-key type from the referenced field. For custom entities, such as a UUID primary key in an `ImageEntity`, use `columnTypeOverrides` when the referenced entity is not part of the generated Better Auth schema:

```typescript
database: typeormAdapter(dataSource, {
  columnTypeOverrides: {
    user: { image: "uuid" },
    image: { id: "uuid" },
  },
});
```

The related entity must also be registered in the same TypeORM `DataSource` (through `entities`, `autoLoadEntities`, or the equivalent framework module configuration). The adapter cannot resolve relation metadata for an entity that TypeORM has not registered.

### Enable Soft Delete

You can enable soft delete for entities by passing list of entities that should use soft delete by passing softDeleteEnabledEntities option to the adapter:

```typescript
import { typeormAdapter } from "@hedystia/better-auth-typeorm";

export const auth = betterAuth({
  database: typeormAdapter(dataSource, {
    softDeleteEnabledEntities: ["user", "member"],
  }),
});
```

**Options:**

- `softDeleteEnabledEntities` (optional): Enable soft delete for entities. Default: undefined

**Note:**
- If you enable soft delete, you will need to add the `@DeleteDateColumn` decorator with column name `deletedAt` to your entities.
- Entities that are not in the `softDeleteEnabledEntities` list will not use soft delete.

### Runtime Schema Synchronization (opt-in)

By default, the adapter will **not** issue any DDL (`CREATE TABLE` / `ALTER TABLE`) at runtime. Schema changes should live in deliberate, version-controlled migrations — generate them with `bunx auth generate` (or `npx auth generate`) and apply them with TypeORM's migration runner (`migrationsRun: true`).

If you want the adapter to attempt to create missing tables / add missing columns automatically on every `create()` call — inferring types from the inserted values — you can opt in with `enableSchemaSync`:

```typescript
import { typeormAdapter } from "@hedystia/better-auth-typeorm";

export const auth = betterAuth({
  database: typeormAdapter(dataSource, {
    enableSchemaSync: true,
  }),
});
```

**Options:**

- `enableSchemaSync` (optional): When `true`, the adapter runs `CREATE TABLE IF NOT EXISTS` and `ALTER TABLE ADD COLUMN` at runtime to match the data being inserted. Requires the runtime DB user to have DDL privileges. Default: `false`.

**Note:** Keep this off in production. Manage your schema with migrations instead.

## 🌟 Why use this adapter?

- **Seamless Integration**: Direct mapping between Better Auth entities and TypeORM
- **Flexible Database Support**: Use with any TypeORM-supported database
- **Production Ready**: Built-in error handling and transaction support
- **Performance Optimized**: Efficient query building and data transformation

## 📝 License

This project is licensed under the [MIT License](LICENSE).

## 🙏 Acknowledgements

- [TypeORM](https://typeorm.io/)
- [Better Auth](https://github.com/better-auth/better-auth)

better-auth-typeorm

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

better-auth-typeorm

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README