feat: add auth package with password adapter example

Author: Vicentesan

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

@@ -1,11 +1,12 @@
 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(() => {
-      return Response.json({ message: 'hello' });
+    path('/test').get(async () => {
+      return getAdapters();
     })
 });

examples/with-auth/src/settings.ts

@@ -1,4 +1,5 @@
 import defineAuthConfig, { getAuth } from '@palmares/auth';
+import defineAuthDomain, { Auth, AuthAdapter } from '@palmares/auth';
 import ConsoleLogging from '@palmares/console-logging';
 import PalmaresCoreDomain, { defineSettings } from '@palmares/core';
 import { ExpressServerAdapter } from '@palmares/express-adapter';
@@ -65,9 +66,28 @@ export default defineSettings({
         }
       }
     ],
-    defineAuthConfig({
-      adapters: [passwordAdapter.new({ prefix: 'my-prefix', suffix: 'my-suffix' })]
+    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>;

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

packages/auth/src/auth.ts

@@ -1,12 +1,9 @@
 import { getAdapters } from './conf';
 
-import type { AuthAdapters } from '.';
 import type { AdapterMethods, AuthAdapter } from './adapter';
 
-type AuthProxy<TAdapters extends readonly (AuthAdapter | unknown)[]> = {
-  [KAdapter in TAdapters[number] as KAdapter extends AuthAdapter
-    ? KAdapter['name']
-    : never]: KAdapter extends AuthAdapter ? KAdapter['methods'] : never;
+type AuthProxy<TAdapters> = {
+  // [KAdapter in TAdapters[number] as KAdapter['name']]: KAdapter['methods'];
 };
 
 const createAdapterProxy = <TMethods extends AdapterMethods>(methods: TMethods): TMethods =>
@@ -19,14 +16,13 @@ const createAdapterProxy = <TMethods extends AdapterMethods>(methods: TMethods):
     }
   });
 
-export function getAuth<TAdapters extends AuthAdapters & Palmares.PAuth = AuthAdapters & Palmares.PAuth>(): AuthProxy<
-  TAdapters['adapters']
-> {
-  return new Proxy(
+type GetAdapters = ReturnType<typeof getAdapters>;
+
+const createAuthProxy = <TAdapters = Palmares.PAuth extends { adapters: any } ? true : false>(adapters: GetAdapters) =>
+  new Proxy(
     {},
     {
       get(_, adapterName: string) {
-        const adapters = getAdapters();
         const adapter = adapters.find((a) => a.name === adapterName);
 
         if (adapter) {
@@ -36,5 +32,6 @@ export function getAuth<TAdapters extends AuthAdapters & Palmares.PAuth = AuthAd
         throw new Error(`Adapter "${adapterName}" not found`);
       }
     }
-  ) as any;
-}
+  ) as AuthProxy<TAdapters>;
+
+export const Auth = createAuthProxy(getAdapters());

packages/auth/src/index.ts

@@ -1,7 +1,5 @@
 import { defineAuthDomain } from './domain';
 
-import type { AuthAdapter } from './adapter';
-
 export { authAdapter, AuthAdapter, type AdapterMethods } from './adapter';
 export {
   AuthenticationFailedException,
@@ -16,11 +14,7 @@ export {
 } from './exceptions';
 export type { AuthConfigurationType, AuthAdapterType } from './types';
 
-export { getAuth } from './auth';
+export { Auth } from './auth';
 export { defineAuthDomain as default };
 
-export interface AuthAdapters<TAdapters extends readonly (AuthAdapter | unknown)[] = unknown[]> {
-  adapters: TAdapters;
-}
-
 export { getAdapters } from './conf';