Add tests and examples for plugin-better-auth

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

packages/plugins/better-auth/examples/usage.ts

@@ -0,0 +1,89 @@
+/**
+ * Example: Using the Better-Auth Plugin in ObjectOS
+ * 
+ * This example demonstrates how to integrate the Better-Auth plugin
+ * into an ObjectOS application.
+ */
+
+import { ObjectOS } from '@objectos/kernel';
+import { BetterAuthPlugin, createBetterAuthPlugin } from '@objectos/plugin-better-auth';
+
+/**
+ * Example 1: Using the default plugin
+ */
+async function example1() {
+    const os = new ObjectOS({
+        plugins: [BetterAuthPlugin],
+    });
+
+    await os.init();
+    console.log('ObjectOS initialized with Better-Auth plugin (default config)');
+}
+
+/**
+ * Example 2: Using custom configuration
+ */
+async function example2() {
+    const customAuthPlugin = createBetterAuthPlugin({
+        // Use a specific database
+        databaseUrl: process.env.DATABASE_URL || 'sqlite:auth.db',
+        
+        // Set the base URL for auth endpoints
+        baseURL: 'https://myapp.com/api/auth',
+        
+        // Configure trusted origins for CORS
+        trustedOrigins: [
+            'https://myapp.com',
+            'https://app.myapp.com',
+            'http://localhost:3000'
+        ]
+    });
+
+    const os = new ObjectOS({
+        plugins: [customAuthPlugin],
+    });
+
+    await os.init();
+    console.log('ObjectOS initialized with Better-Auth plugin (custom config)');
+}
+
+/**
+ * Example 3: Using with other plugins
+ */
+async function example3() {
+    // Import other plugins as needed
+    // import { WorkflowPlugin } from '@objectos/plugin-workflow';
+    // import { DataPlugin } from '@objectos/plugin-data';
+
+    const os = new ObjectOS({
+        plugins: [
+            BetterAuthPlugin,
+            // WorkflowPlugin,
+            // DataPlugin,
+        ],
+    });
+
+    await os.init();
+    console.log('ObjectOS initialized with multiple plugins');
+}
+
+/**
+ * Example 4: Accessing the auth instance from another plugin or service
+ */
+async function example4() {
+    const { getBetterAuth } = await import('@objectos/plugin-better-auth');
+    
+    // Get the auth instance (initialized by the plugin)
+    const auth = await getBetterAuth();
+    
+    // You can now use the auth instance directly
+    console.log('Auth instance available for direct usage');
+}
+
+// Run examples (uncomment to test)
+// example1();
+// example2();
+// example3();
+// example4();
+
+export { example1, example2, example3, example4 };

packages/plugins/better-auth/jest.config.js

@@ -0,0 +1,11 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/test'],
+  testMatch: ['**/*.test.ts'],
+  moduleFileExtensions: ['ts', 'js', 'json'],
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts'
+  ]
+};

packages/plugins/better-auth/package.json

@@ -20,6 +20,9 @@
     "@types/node": "^20.10.0",
     "@types/pg": "^8.11.0",
     "@types/better-sqlite3": "^7.6.0",
+    "@types/jest": "^30.0.0",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
     "typescript": "^5.9.3"
   },
   "peerDependencies": {

packages/plugins/better-auth/test/plugin.test.ts

@@ -0,0 +1,58 @@
+/**
+ * Basic test for Better-Auth Plugin
+ */
+
+import { BetterAuthPlugin, BetterAuthManifest, createBetterAuthPlugin } from '../src';
+
+describe('Better-Auth Plugin', () => {
+    it('should export BetterAuthPlugin', () => {
+        expect(BetterAuthPlugin).toBeDefined();
+        expect(typeof BetterAuthPlugin).toBe('object');
+    });
+
+    it('should export BetterAuthManifest', () => {
+        expect(BetterAuthManifest).toBeDefined();
+        expect(BetterAuthManifest.id).toBe('com.objectos.auth.better-auth');
+        expect(BetterAuthManifest.version).toBe('0.1.0');
+        expect(BetterAuthManifest.type).toBe('plugin');
+    });
+
+    it('should export createBetterAuthPlugin factory', () => {
+        expect(createBetterAuthPlugin).toBeDefined();
+        expect(typeof createBetterAuthPlugin).toBe('function');
+    });
+
+    it('should create plugin with custom options', () => {
+        const customPlugin = createBetterAuthPlugin({
+            baseURL: 'https://example.com/auth',
+            trustedOrigins: ['https://example.com']
+        });
+        expect(customPlugin).toBeDefined();
+        expect(customPlugin.onInstall).toBeDefined();
+        expect(customPlugin.onEnable).toBeDefined();
+        expect(customPlugin.onDisable).toBeDefined();
+        expect(customPlugin.onUninstall).toBeDefined();
+    });
+
+    it('should have all lifecycle hooks', () => {
+        expect(typeof BetterAuthPlugin.onInstall).toBe('function');
+        expect(typeof BetterAuthPlugin.onEnable).toBe('function');
+        expect(typeof BetterAuthPlugin.onDisable).toBe('function');
+        expect(typeof BetterAuthPlugin.onUninstall).toBe('function');
+    });
+
+    it('manifest should have correct contributes', () => {
+        expect(BetterAuthManifest.contributes).toBeDefined();
+        expect(BetterAuthManifest.contributes?.events).toBeDefined();
+        expect(BetterAuthManifest.contributes?.events?.length).toBeGreaterThan(0);
+    });
+
+    it('manifest should define authentication events', () => {
+        const events = BetterAuthManifest.contributes?.events || [];
+        expect(events).toContain('auth.user.created');
+        expect(events).toContain('auth.user.login');
+        expect(events).toContain('auth.user.logout');
+        expect(events).toContain('auth.session.created');
+        expect(events).toContain('auth.session.expired');
+    });
+});