@jazim/test 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,143 @@
+# TypeORM Adapter for Better-Auth
+
+A TypeORM database adapter for [Better-Auth](https://github.com/better-auth/better-auth), providing seamless authentication with TypeORM.
+
+## Features
+
+- ✅ Full TypeORM integration
+- ✅ TypeScript support with full type safety
+- ✅ Schema generation via Better-Auth CLI
+- ✅ Configurable table names (singular/plural)
+- ✅ Transaction support
+- ✅ Supports all major databases (PostgreSQL, MySQL, SQLite, SQL Server, Oracle, MongoDB)
+
+## Installation
+
+```bash
+npm install typeorm-adapter-betterauth typeorm better-auth
+# or
+pnpm add typeorm-adapter-betterauth typeorm better-auth
+# or
+yarn add typeorm-adapter-betterauth typeorm better-auth
+```
+
+## Quick Start
+
+### 1. Generate TypeORM Entities and Migrations
+
+Run the Better-Auth CLI to generate TypeORM entity and migration files:
+
+```bash
+npx @better-auth/cli@latest generate
+```
+
+This will create:
+- **Entity file** (e.g., `auth-schema.ts`) with TypeORM decorators for all Better-Auth tables
+- **Migration file** (e.g., `migrations/1234567890-InitialSchema.ts`) for creating tables in production
+
+### 2. Set Up TypeORM DataSource
+
+Import the generated entities and create your DataSource:
+
+```typescript
+import { DataSource } from \"typeorm\";
+import { User, Session, Account, Verification } from \"./auth-schema\"; // generated file
+
+const dataSource = new DataSource({
+  type: \"postgres\", // or \"mysql\", \"sqlite\", etc.
+  host: \"localhost\",
+  port: 5432,
+  username: \"user\",
+  password: \"password\",
+  database: \"myapp\",
+  entities: [User, Session, Account, Verification],
+  migrations: [\"./migrations/*.ts\"], // Include generated migrations
+  synchronize: false, // Use migrations in production
+});
+
+await dataSource.initialize();
+```
+
+### 3. Run Migrations
+
+For production, run migrations instead of using `synchronize: true`:
+
+```bash
+# Run migrations
+npx typeorm migration:run -d ./data-source.ts
+
+# Revert last migration
+npx typeorm migration:revert -d ./data-source.ts
+```
+
+### 4. Initialize Better-Auth with TypeORM Adapter
+
+```typescript
+import { betterAuth } from \"better-auth\";
+import { typeormAdapter } from \"typeorm-adapter-betterauth\";
+
+const auth = betterAuth({
+  database: typeormAdapter(dataSource, {
+    provider: \"postgres\", // must match your DataSource type
+  }),
+  // ... other better-auth config
+});
+```
+
+## Configuration
+
+### Adapter Options
+
+```typescript
+typeormAdapter(dataSource, {
+  provider: \"postgres\", // Required: \"postgres\" | \"mysql\" | \"sqlite\" | \"mssql\" | \"oracle\" | \"mongodb\"
+  usePlural: false, // Use plural table names (users, sessions, etc.)
+  debugLogs: false, // Enable debug logs
+  transaction: false, // Enable transaction support
+});
+```
+
+## Complete Example
+
+```typescript
+import { betterAuth } from \"better-auth\";
+import { typeormAdapter } from \"typeorm-adapter-betterauth\";
+import { DataSource } from \"typeorm\";
+import { User, Session, Account, Verification } from \"./auth-schema\";
+
+// 1. Create DataSource
+const dataSource = new DataSource({
+  type: \"postgres\",
+  host: process.env.DB_HOST,
+  port: parseInt(process.env.DB_PORT || \"5432\"),
+  username: process.env.DB_USER,
+  password: process.env.DB_PASSWORD,
+  database: process.env.DB_NAME,
+  entities: [User, Session, Account, Verification],
+  migrations: [\"./migrations/*.ts\"],
+  synchronize: false, // Use migrations in production
+  logging: process.env.NODE_ENV !== \"production\",
+});
+
+await dataSource.initialize();
+
+// Run migrations in production
+if (process.env.NODE_ENV === \"production\") {
+  await dataSource.runMigrations();
+}
+
+// 2. Create Better-Auth instance
+export const auth = betterAuth({
+  database: typeormAdapter(dataSource, {
+    provider: \"postgres\",
+    transaction: true,
+  }),
+  emailAndPassword: {
+    enabled: true,
+  },
+});
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,53 @@
+import * as better_auth from 'better-auth';
+import { BetterAuthOptions } from 'better-auth';
+import { DataSource } from 'typeorm';
+import { AdapterFactoryConfig } from 'better-auth/adapters';
+
+type Provider = "mysql" | "postgres" | "sqlite";
+interface TypeOrmAdapterConfig extends Pick<AdapterFactoryConfig, "debugLogs" | "usePlural" | "transaction"> {
+    /**
+     * Database provider.
+     *
+     * @default "postgres"
+     */
+    provider?: Provider;
+    /**
+     * Custom entity names for the adapter models.
+     *
+     * @default
+     * {
+     *   user: "User",
+     *   account: "Account",
+     *   session: "Session",
+     *   verification: "Verification"
+     * }
+     */
+    entities?: {
+        user?: string;
+        account?: string;
+        session?: string;
+        verification?: string;
+    };
+    /**
+     * Generate entities and migrations files.
+     * @default true
+     */
+    generateEntities?: boolean;
+    /**
+     * Generate migration files.
+     * @default true
+     */
+    generateMigrations?: boolean;
+    /**
+     * Path to save generated entities
+     */
+    entitiesPath?: string;
+    /**
+     * Path to save generated migrations
+     */
+    migrationsPath?: string;
+}
+
+declare const typeormAdapter: (dataSource: DataSource, config?: TypeOrmAdapterConfig) => (options: BetterAuthOptions) => better_auth.DBAdapter<BetterAuthOptions>;
+
+export { typeormAdapter };

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+import * as better_auth from 'better-auth';
+import { BetterAuthOptions } from 'better-auth';
+import { DataSource } from 'typeorm';
+import { AdapterFactoryConfig } from 'better-auth/adapters';
+
+type Provider = "mysql" | "postgres" | "sqlite";
+interface TypeOrmAdapterConfig extends Pick<AdapterFactoryConfig, "debugLogs" | "usePlural" | "transaction"> {
+    /**
+     * Database provider.
+     *
+     * @default "postgres"
+     */
+    provider?: Provider;
+    /**
+     * Custom entity names for the adapter models.
+     *
+     * @default
+     * {
+     *   user: "User",
+     *   account: "Account",
+     *   session: "Session",
+     *   verification: "Verification"
+     * }
+     */
+    entities?: {
+        user?: string;
+        account?: string;
+        session?: string;
+        verification?: string;
+    };
+    /**
+     * Generate entities and migrations files.
+     * @default true
+     */
+    generateEntities?: boolean;
+    /**
+     * Generate migration files.
+     * @default true
+     */
+    generateMigrations?: boolean;
+    /**
+     * Path to save generated entities
+     */
+    entitiesPath?: string;
+    /**
+     * Path to save generated migrations
+     */
+    migrationsPath?: string;
+}
+
+declare const typeormAdapter: (dataSource: DataSource, config?: TypeOrmAdapterConfig) => (options: BetterAuthOptions) => better_auth.DBAdapter<BetterAuthOptions>;
+
+export { typeormAdapter };