@boostkit/auth 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 BoostKit
+
+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,38 @@
+# @boostkit/auth
+
+Shared authentication result and entity types.
+
+## Installation
+
+```bash
+pnpm add @boostkit/auth
+```
+
+## Usage
+
+```ts
+import type { AuthUser, AuthSession, AuthResult } from '@boostkit/auth'
+
+const user: AuthUser = {
+  id: '1',
+  name: 'A',
+  email: 'a@example.com',
+  emailVerified: false,
+  createdAt: new Date(),
+  updatedAt: new Date(),
+}
+```
+
+## API Reference
+
+- `AuthUser`
+- `AuthSession`
+- `AuthResult`
+
+## Configuration
+
+This package has no runtime config object.
+
+## Notes
+
+- This package exports types/interfaces only.

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+import { ServiceProvider, type Application } from '@boostkit/core';
+export interface AuthUser {
+    id: string;
+    name: string;
+    email: string;
+    emailVerified: boolean;
+    image?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface AuthSession {
+    id: string;
+    userId: string;
+    token: string;
+    expiresAt: Date;
+    ipAddress?: string;
+    userAgent?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface AuthResult {
+    user: AuthUser;
+    session: AuthSession;
+}
+export interface BetterAuthConfig {
+    /** 32+ character secret. Falls back to process.env.AUTH_SECRET */
+    secret?: string;
+    /** App base URL. Falls back to process.env.APP_URL */
+    baseUrl?: string;
+    /**
+     * Pass a PrismaClient instance — auto-wrapped with prismaAdapter internally.
+     * Or pass a pre-built better-auth database adapter for advanced use.
+     */
+    database: unknown;
+    /** Required when passing a PrismaClient. Default: 'sqlite' */
+    databaseProvider?: 'sqlite' | 'postgresql' | 'mysql';
+    emailAndPassword?: {
+        enabled?: boolean;
+        requireEmailVerification?: boolean;
+    };
+    socialProviders?: Record<string, {
+        clientId: string;
+        clientSecret: string;
+    }>;
+    trustedOrigins?: string[];
+    /** Called after a new user is successfully created — ideal for dispatching jobs or events */
+    onUserCreated?: (user: {
+        id: string;
+        name: string;
+        email: string;
+    }) => void | Promise<void>;
+}
+/**
+ * Returns a ServiceProvider constructor that configures better-auth and
+ * binds the auth instance to the DI container in boot().
+ *
+ * Usage in bootstrap/providers.ts:
+ *   import { betterAuth } from '@boostkit/auth'
+ *   import configs from '../config/index.ts'
+ *   export default [..., betterAuth(configs.auth), ...]
+ */
+export declare function betterAuth(config: BetterAuthConfig): new (app: Application) => ServiceProvider;
+export type BetterAuthInstance = Awaited<ReturnType<typeof import('better-auth').betterAuth>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAIlE,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,OAAO,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,WAAW,CAAA;CACrB;AAID,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAA;IACjB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAA;IACpD,gBAAgB,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,wBAAwB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC5E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,6FAA6F;IAC7F,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5F;AAID;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,KAAK,GAAG,EAAE,WAAW,KAAK,eAAe,CAiD9F;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,cAAc,aAAa,EAAE,UAAU,CAAC,CAAC,CAAA"}

package/dist/index.js

@@ -0,0 +1,56 @@
+import { ServiceProvider } from '@boostkit/core';
+// ─── betterAuth() Factory ──────────────────────────────────
+/**
+ * Returns a ServiceProvider constructor that configures better-auth and
+ * binds the auth instance to the DI container in boot().
+ *
+ * Usage in bootstrap/providers.ts:
+ *   import { betterAuth } from '@boostkit/auth'
+ *   import configs from '../config/index.ts'
+ *   export default [..., betterAuth(configs.auth), ...]
+ */
+export function betterAuth(config) {
+    class BetterAuthProvider extends ServiceProvider {
+        register() { }
+        async boot() {
+            const { betterAuth: createAuth } = await import('better-auth');
+            // Resolve database if it's a Promise (supports async factory pattern)
+            let database = config.database instanceof Promise ? await config.database : config.database;
+            if (database && typeof database['$connect'] === 'function') {
+                const { prismaAdapter } = await import('better-auth/adapters/prisma');
+                database = prismaAdapter(database, {
+                    provider: config.databaseProvider ?? 'sqlite',
+                });
+            }
+            const auth = createAuth({
+                secret: config.secret ?? process.env['AUTH_SECRET'] ?? '',
+                baseURL: config.baseUrl ?? process.env['APP_URL'] ?? 'http://localhost:3000',
+                database: database,
+                emailAndPassword: {
+                    enabled: config.emailAndPassword?.enabled ?? true,
+                    ...(config.emailAndPassword?.requireEmailVerification !== undefined
+                        ? { requireEmailVerification: config.emailAndPassword.requireEmailVerification }
+                        : {}),
+                },
+                ...(config.socialProviders && { socialProviders: config.socialProviders }),
+                ...(config.trustedOrigins && { trustedOrigins: config.trustedOrigins }),
+                ...(config.onUserCreated && {
+                    databaseHooks: {
+                        user: {
+                            create: {
+                                after: async (user) => {
+                                    await config.onUserCreated(user);
+                                },
+                            },
+                        },
+                    },
+                }),
+            });
+            // Bind into DI container
+            this.app.instance('auth', auth);
+            console.log('[BetterAuthServiceProvider] booted — auth instance bound to DI container');
+        }
+    }
+    return BetterAuthProvider;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAoB,MAAM,gBAAgB,CAAA;AAmDlE,8DAA8D;AAE9D;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,MAAwB;IACjD,MAAM,kBAAmB,SAAQ,eAAe;QAC9C,QAAQ,KAAU,CAAC;QAEnB,KAAK,CAAC,IAAI;YACR,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAA;YAE9D,sEAAsE;YACtE,IAAI,QAAQ,GAAG,MAAM,CAAC,QAAQ,YAAY,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAA;YAC3F,IAAI,QAAQ,IAAI,OAAQ,QAAoC,CAAC,UAAU,CAAC,KAAK,UAAU,EAAE,CAAC;gBACxF,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAA;gBACrE,QAAQ,GAAG,aAAa,CAAC,QAAQ,EAAE;oBACjC,QAAQ,EAAE,MAAM,CAAC,gBAAgB,IAAI,QAAQ;iBAC9C,CAAC,CAAA;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,UAAU,CAAC;gBACtB,MAAM,EAAG,MAAM,CAAC,MAAM,IAAK,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE;gBAC3D,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,uBAAuB;gBAC5E,QAAQ,EAAE,QAAwD;gBAClE,gBAAgB,EAAE;oBAChB,OAAO,EAAE,MAAM,CAAC,gBAAgB,EAAE,OAAO,IAAI,IAAI;oBACjD,GAAG,CAAC,MAAM,CAAC,gBAAgB,EAAE,wBAAwB,KAAK,SAAS;wBACjE,CAAC,CAAC,EAAE,wBAAwB,EAAE,MAAM,CAAC,gBAAgB,CAAC,wBAAwB,EAAE;wBAChF,CAAC,CAAC,EAAE,CAAC;iBACR;gBACD,GAAG,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC;gBAC1E,GAAG,CAAC,MAAM,CAAC,cAAc,IAAK,EAAE,cAAc,EAAG,MAAM,CAAC,cAAc,EAAG,CAAC;gBAC1E,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI;oBAC1B,aAAa,EAAE;wBACb,IAAI,EAAE;4BACJ,MAAM,EAAE;gCACN,KAAK,EAAE,KAAK,EAAE,IAAiD,EAAE,EAAE;oCACjE,MAAM,MAAM,CAAC,aAAc,CAAC,IAAI,CAAC,CAAA;gCACnC,CAAC;6BACF;yBACF;qBACF;iBACF,CAAC;aACH,CAAC,CAAA;YAEF,yBAAyB;YACzB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;YAE/B,OAAO,CAAC,GAAG,CAAC,0EAA0E,CAAC,CAAA;QACzF,CAAC;KACF;IAED,OAAO,kBAAkB,CAAA;AAC3B,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@boostkit/auth",
+  "version": "0.0.1",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/boostkitjs/boostkit",
+    "directory": "packages/auth"
+  },
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "better-auth": "^1.0.0",
+    "@boostkit/core": "0.0.1",
+    "@boostkit/router": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}