@authaz/next 0.0.1 → 1.0.1

package/docs/REFACTORING.md

@@ -1,163 +0,0 @@
-# Authaz SDK Refactoring
-
-## 📁 New Structure
-
-The refactoring organized the SDK by **functional flows**, separating responsibilities and improving maintainability:
-
-```
-src/
-├── flows/                    # Specific functionality flows
-│   ├── auth/                # Authentication and MFA
-│   │   ├── api.ts          # Methods: login, loginVerifyMfa
-│   │   └── types.ts        # LoginResponse, MfaVerifyResponse
-│   ├── password-reset/      # Password recovery
-│   │   ├── api.ts          # Methods: requestPasswordReset, verifyPasswordResetCode, etc.
-│   │   └── types.ts        # PasswordResetRequestResponse, etc.
-│   ├── signup/             # User registration
-│   │   ├── api.ts          # Methods: requestSignup, confirmSignup, etc.
-│   │   └── types.ts        # SignupRequestResponse, etc.
-│   └── user/               # User data
-│       ├── api.ts          # Methods: getMe
-│       └── types.ts        # UserResponse, UserProfile
-├── shared/                  # Shared logic and types
-│   ├── base-api.ts         # Base class with common authentication
-│   └── types.ts            # Base types (tokens, session, etc.)
-├── utils/                   # Utilities
-│   ├── auth.ts             # Validation functions and helpers
-│   └── session.ts          # Session management
-├── api.ts                   # Main aggregator class
-├── types.ts                 # Re-exports of all types
-├── http-types.ts           # Raw HTTP types (maintained)
-└── index.ts                # Main exports
-```
-
-## 🔄 Compatibility
-
-The refactoring **maintains full compatibility** with existing code:
-
-```typescript
-// Will continue to work exactly the same
-import { ApiService } from 'authaz-sdk-js'
-
-const client = new ApiService(clientId, clientSecret, authPoolId, organizationId)
-
-// All methods work the same
-const loginResult = await client.login(email, password)
-const userResult = await client.getMe(token)
-```
-
-## 🎯 Refactoring Benefits
-
-### 1. **Separation of Concerns**
-- Each flow has its own class and types
-- More organized and easier to maintain code
-- Less chance of conflicts between functionalities
-
-### 2. **Code Reusability**
-- `BaseApiService` class eliminates duplication
-- Centralized authentication logic
-- Shared configuration across all services
-
-### 3. **Better Developer Experience**
-- More specific types per flow
-- More precise IntelliSense
-- Easier debugging and maintenance
-
-### 4. **Flexibility**
-- Ability to use individual services
-- Easier unit testing
-- Allows future extensions
-
-## 🚀 Advanced Usage (Optional)
-
-For specific cases, you can use individual services:
-
-```typescript
-import {
-  AuthApiService,
-  PasswordResetApiService,
-  SignupApiService,
-  UserApiService
-} from 'authaz-sdk-js'
-
-// Use only the authentication service
-const authService = new AuthApiService(baseUrl, clientId, clientSecret, authPoolId, organizationId)
-const loginResult = await authService.login(email, password)
-
-// Or only password recovery
-const passwordService = new PasswordResetApiService(baseUrl, clientId, clientSecret, authPoolId, organizationId)
-const resetResult = await passwordService.requestPasswordReset(email)
-```
-
-## 📝 Usage Examples
-
-### Complete Authentication
-```typescript
-import { ApiService } from 'authaz-sdk-js'
-
-const client = new ApiService(/* configs */)
-
-// Normal login
-const loginResult = await client.login('user@example.com', 'password')
-
-if (loginResult.status === 'mfa_required') {
-  // Verify MFA
-  const mfaResult = await client.loginVerifyMfa(
-    'user@example.com',
-    '123456',
-    loginResult.challengeToken.value
-  )
-
-  if (mfaResult.status === 'success') {
-    // User authenticated
-    console.log('Access token:', mfaResult.accessToken.value)
-  }
-}
-```
-
-### Password Recovery
-```typescript
-// Request reset
-const requestResult = await client.requestPasswordReset('user@example.com')
-
-// Verify email code
-const verifyResult = await client.verifyPasswordResetCode('user@example.com', '123456')
-
-if (verifyResult.status === 'challenge') {
-  // Needs MFA
-  const mfaResult = await client.forgotPasswordVerifyMfa(
-    'user@example.com',
-    '654321',
-    verifyResult.challengeToken.value
-  )
-}
-
-// Confirm new password
-const confirmResult = await client.confirmPasswordReset(
-  token,
-  'user@example.com',
-  'newPassword123'
-)
-```
-
-## 🔧 Migration (If Needed)
-
-If you were importing specific internal files, update:
-
-```typescript
-// ❌ Before (if you were doing this)
-import { validateToken } from 'authaz-sdk-js/src/auth'
-import { getSession } from 'authaz-sdk-js/src/session'
-
-// ✅ Now
-import { validateToken } from 'authaz-sdk-js'
-import { getSession } from 'authaz-sdk-js'
-```
-
-## 📊 Impact
-
-- **Code removed**: ~400 duplicated lines
-- **Organized files**: 6 → 14 well-structured files
-- **Maintainability**: ↗️ Much better
-- **Performance**: Same (no impact)
-- **Compatibility**: ✅ 100% maintained

package/docs/STATUS-CODES.md

@@ -1,141 +0,0 @@
-# Status Codes - Authaz SDK
-
-This document describes all specific statuses for each operation flow in the Authaz SDK.
-
-## 🔐 Authentication (Auth)
-
-### LoginResponse
-- `success` - Login successful
-- `error` - Generic login error
-- `mfa_required` - MFA is required to complete login
-- `too_many_attempts` - Too many login attempts
-
-### MfaVerifyResponse
-- `success` - MFA verified successfully
-- `error` - Generic MFA verification error
-- `invalid_code` - Invalid MFA code
-- `expired` - MFA token expired
-
-## 📝 Signup
-
-### SignupRequestResponse
-- `success` - Signup request sent successfully
-- `error` - Generic request error
-- `user_already_exists` - User already exists in the system
-- `invalid_email` - Invalid email
-- `password_not_strong_enough` - Password doesn't meet criteria
-
-### SignupConfirmResponse
-- `success` - Signup confirmed successfully
-- `requires_mfa` - MFA is required to complete signup
-- `error` - Generic confirmation error
-- `invalid_code` - Invalid confirmation code
-- `expired` - Confirmation code expired
-- `user_exists` - User already exists
-
-### SignupConfigureMfaResponse
-- `success` - MFA configured successfully
-- `error` - Generic configuration error
-- `unauthorized` - Invalid access token
-- `mfa_already_configured` - MFA already configured
-
-### SignupVerifyMfaResponse
-- `success` - MFA verified successfully during signup
-- `error` - Generic verification error
-- `invalid_code` - Invalid MFA code
-- `expired` - MFA token expired
-- `unauthorized` - Invalid access token
-- `user_exists` - User already exists
-
-## 🔑 Password Reset
-
-### PasswordResetRequestResponse
-- `success` - Reset request sent successfully
-- `error` - Generic request error
-- `user_not_found` - User not found
-- `too_many_requests` - Too many reset requests
-- `email_not_verified` - Email not verified
-
-### PasswordResetVerifyEmailTokenResponse
-- `success` - Code verified successfully
-- `error` - Generic verification error
-- `invalid_code` - Invalid code
-- `challenge` - MFA challenge required
-- `expired` - Code expired
-- `code_already_used` - Code already used
-
-### PasswordResetVerifyMfaResponse
-- `success` - MFA verified successfully during reset
-- `error` - Generic MFA verification error
-- `invalid_code` - Invalid MFA code
-- `expired` - MFA token expired
-- `challenge_token_expired` - Challenge token expired
-- `too_many_attempts` - Too many verification attempts
-
-### PasswordResetConfirmResponse
-- `success` - Password reset successfully
-- `password_not_strong_enough` - New password doesn't meet criteria
-- `error` - Generic confirmation error
-- `token_expired` - Reset token expired
-- `token_invalid` - Reset token invalid
-- `password_recently_used` - Password was recently used
-
-## 👤 User
-
-### UserResponse
-- `success` - User data retrieved successfully
-- `error` - Generic data retrieval error
-- `unauthorized` - Invalid access token
-- `token_expired` - Access token expired
-- `user_not_found` - User not found
-
-## 🔒 Password Policy
-
-### PasswordPolicyResponse
-- `success` - Policy retrieved successfully
-- `error` - Generic policy retrieval error
-- `policy_not_found` - Policy not found
-- `unauthorized` - Unauthorized access
-
-## 🔄 Refresh Token
-
-### RefreshTokenResponse
-- `success` - Token refreshed successfully
-- `error` - Generic refresh error
-- `invalid_refresh_token` - Invalid refresh token
-- `refresh_token_expired` - Refresh token expired
-- `unauthorized` - Unauthorized access
-
-## 💡 Using Status Codes
-
-Each status allows specific handling in the frontend:
-
-```typescript
-const loginResult = await authazClient.login(email, password)
-
-switch (loginResult.status) {
-  case 'success':
-    // Redirect to dashboard
-    break
-  case 'mfa_required':
-    // Show MFA screen
-    showMfaScreen(loginResult.challengeToken)
-    break
-  case 'too_many_attempts':
-    // Show temporary block message
-    showBlockedMessage()
-    break
-  case 'error':
-    // Show generic error
-    showError(loginResult.message)
-    break
-}
-```
-
-## 🔍 Advantages of Specific Status Codes
-
-1. **Precise Handling**: Each scenario can be handled specifically
-2. **Improved UX**: More precise messages and actions for users
-3. **Easier Debugging**: Quick identification of specific issues
-4. **Flexibility**: Adding new statuses without breaking compatibility
-5. **Strong Typing**: TypeScript ensures all cases are handled

package/jest.config.js

@@ -1,25 +0,0 @@
-module.exports = {
-  preset: 'ts-jest',
-  testEnvironment: 'node',
-  roots: ['<rootDir>/src'],
-  testMatch: ['**/__tests__/**/*.ts', '**/?(*.)+(spec|test).ts'],
-  transform: {
-    '^.+\\.ts$': 'ts-jest',
-  },
-  moduleFileExtensions: ['ts', 'js', 'json', 'node'],
-  collectCoverageFrom: [
-    'src/**/*.ts',
-    '!src/**/*.d.ts',
-    '!src/**/__tests__/**',
-  ],
-  coverageDirectory: 'coverage',
-  coverageReporters: ['text', 'lcov'],
-  coverageThreshold: {
-    global: {
-      branches: 80,
-      functions: 80,
-      lines: 80,
-      statements: 80,
-    },
-  },
-} 

package/src/index.tsx

@@ -1,34 +0,0 @@
-import { authaz, UserProfile, validateToken } from "@authaz/sdk";
-import { cookies } from "next/headers";
-
-type SdkConfig = { debug?: boolean; cookies?: { accessToken?: string } };
-
-type AuthazArgs = Parameters<typeof authaz>[0];
-
-export const authazNext = (config: AuthazArgs, args?: SdkConfig) => {
-    const sdk = authaz(config);
-    const isDebug = args?.debug || false;
-
-    const getUserSession = (args?: SdkConfig) => {
-        const accessTokenCookie = args?.cookies?.accessToken || "accessToken";
-        return async (): Promise<UserProfile | null> => {
-            try {
-                const cookieStore = await cookies();
-                const accessToken = cookieStore.get(accessTokenCookie)?.value;
-                if (!accessToken || !validateToken(accessToken)) {
-                    return null;
-                }
-                const response = await sdk.getMe(accessToken);
-                if (response.status !== "success") {
-                    return null;
-                }
-                return response.user;
-            } catch (error) {
-                if (isDebug) console.error("[authaz-sdk] Error on get user session", error);
-                return null;
-            }
-        };
-    };
-
-    return { getUserSession: getUserSession(args), sdk };
-};

package/tsconfig.json

@@ -1,12 +0,0 @@
-{
-    "extends": "../../tsconfig.root.json",
-    "include": ["src/**/*"],
-    "exclude": ["node_modules", "dist", "**/*.test.ts"],
-    "compilerOptions": {
-        "outDir": "./dist",
-        "baseUrl": ".",
-        "paths": {
-            "*": ["src/*"]
-        }
-    }
-}

package/tsdown.config.ts

@@ -1,21 +0,0 @@
-import { defineConfig } from "tsdown";
-
-export default defineConfig({
-    entry: ["./src/index.tsx"],
-    clean: true,
-    format: ["esm"],
-    dts: true,
-    outDir: "dist",
-    treeshake: true,
-    tsconfig: "tsconfig.json",
-    external: [
-        "next",
-        "react",
-        "nookies",
-        "react-dom",
-        "@remix-run/react",
-        "react-router-dom",
-        "react-router",
-        "@tanstack/react-router",
-    ],
-});