feat: add auth package with password adapter example

Author: Vicentesan

eslint.config.js

@@ -43,7 +43,8 @@ const config = tseslint.config({
     ...prettier,
     ...javascript,
     ...typescript,
-    ...imports
+    ...imports,
+    'ts/no-namespace': 'off'
   }
 });
 

examples/with-auth/package.json

@@ -31,6 +31,7 @@
     "@palmares/node-std": "workspace:*",
     "@palmares/sequelize-engine": "workspace:*",
     "@palmares/server": "workspace:*",
-    "@palmares/password-auth": "workspace:*"
+    "@palmares/password-auth": "workspace:*",
+    "@palmares/auth": "workspace:*"
   }
 }

examples/with-auth/src/core/index.ts

@@ -1,12 +1,11 @@
 import { domain } from '@palmares/core';
 import { Response, path, serverDomainModifier } from '@palmares/server';
+import { getAdapters } from 'packages/auth/dist/src/conf';
 
 export default domain('core', import.meta.dirname, {
   modifiers: [serverDomainModifier],
   getRoutes: () =>
     path('/test').get(async () => {
-      return Response.json({
-        message: 'Hello world'
-      });
+     return getAdapters();
     })
 });

examples/with-auth/src/settings.ts

@@ -6,7 +6,9 @@ import NodeStd from '@palmares/node-std';
 import ServerDomain, { Response } from '@palmares/server';
 import { dirname, resolve } from 'path';
 
+import PasswordAuthAdapter, { passwordAdapter } from '@palmares/password-auth';
 import CoreDomain from './core';
+import defineAuthDomain, { Auth, AuthAdapter } from '@palmares/auth';
 
 export default defineSettings({
   basePath: dirname(resolve(import.meta.dirname)),
@@ -30,7 +32,7 @@ export default defineSettings({
     [
       ServerDomain,
       {
-        servers: {
+      servers: {
           default: {
             server: ExpressServerAdapter,
             debug: true,
@@ -54,6 +56,26 @@ export default defineSettings({
         }
       }
     ],
+    defineAuthDomain({
+      adapters: [passwordAdapter.new({
+        prefix: 'my-prefix',
+        suffix: 'my-suffix'
+      })]
+    }),
     CoreDomain
   ]
 });
+
+declare global {
+  namespace Palmares {
+    interface PAuth {
+      adapters: [ReturnType<typeof PasswordAuthAdapter.new>]
+    }
+  }
+}
+
+const auth = Auth
+
+type test2 = Palmares.PAuth['adapters'][number]
+
+type test3 = ReturnType<typeof PasswordAuthAdapter.new>

examples/with-auth/tsconfig.json

@@ -1,15 +1,13 @@
 {
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "declaration": false,
-    "outDir": "./dist",
-    "types": ["node"],
-    "lib": ["DOM", "ES2020", "DOM.Iterable"],
-    "paths": {
-      "*": ["node_modules/*"],
-      "@palmares/server": ["../../packages/server/dist"],
-      "@palmares/core": ["../../packages/server/node_modules/@palmares/core"],
-    }
-  },
-  "include": ["src/**/*"]
-}
+    "extends": "../../tsconfig.json",
+    "compilerOptions": {
+      "module": "ESNext",
+      "moduleResolution": "bundler",
+      "declaration": false,
+      "outDir": "./dist",
+      "types": ["node"],
+      "lib": ["DOM", "ES2020", "DOM.Iterable"]
+    },
+    "include": ["src/**/*", "manage.ts"],
+    "exclude": []
+}

libs/password-auth/package.json

@@ -44,8 +44,13 @@
   },
   "homepage": "https://github.com/palmaresHQ/palmares#readme",
   "dependencies": {
+    "@palmares/auth": "workspace:*",
     "@palmares/core": "workspace:*",
     "@palmares/events": "workspace:*",
-    "@palmares/logging": "workspace:*"
+    "@palmares/logging": "workspace:*",
+    "bcrypt": "^5.1.1"
+  },
+  "devDependencies": {
+    "@types/bcrypt": "^5.0.2"
   }
 }

libs/password-auth/src/adapter.ts

@@ -0,0 +1,14 @@
+import { authAdapter } from '@palmares/auth';
+import { compare, hash } from 'bcrypt';
+
+export const passwordAdapter = authAdapter((_args: { suffix: string; prefix: string }) => ({
+  name: 'password',
+  methods: {
+    hash: (password: string) => {
+      return hash(password, 10);
+    },
+    validate: (password: string, toValidate: string) => {
+      return compare(password, toValidate);
+    }
+  }
+}));

libs/password-auth/src/index.ts

@@ -0,0 +1,4 @@
+import { passwordAdapter } from './adapter';
+
+export { passwordAdapter };
+export { passwordAdapter as default };

packages/auth/CHANGELOG.md

@@ -1,3 +1,33 @@
 # @palmares/auth
 
-## [UNRELEASED]
+All notable changes to this package will be documented in this file.
+The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
+
+## [Unreleased]
+
+### Added
+- Core authentication domain with zero dependencies
+- Flexible adapter system for implementing different auth strategies
+- Type-safe authentication flows with comprehensive TypeScript support
+- Base `AuthAdapter` class with factory pattern for creating custom adapters
+- Core authentication interface with:
+  - Generic type system for credentials, results, and identifiers
+  - Optional instance and configuration types
+  - Minimal required methods (`authenticate`, `getIdentifier`)
+- Optional event system with standard auth events:
+  - `auth:attempt`, `auth:success`, `auth:failure`
+  - `auth:logout`, `auth:refresh`, `auth:revoke`
+  - `auth:validate`, `auth:error`
+- Optional hook system with:
+  - Pre/post operation hooks
+  - Priority-based execution
+  - Typed context data
+  - Async support
+- Authentication domain with core methods:
+  - `authenticate` - Handle user authentication
+  - `verify` - Verify authentication credentials
+  - `invalidate` - Invalidate authentication credentials
+- Error handling system with:
+  - Base `AuthException` class
+  - `AuthAdapterException` for adapter-specific errors
+  - `NotImplementedAuthAdapterException` for unimplemented methods