@nauth-toolkit/client-angular 0.1.53

package/LICENSE

@@ -0,0 +1,90 @@
+NAUTH TOOLKIT EARLY ACCESS LICENSE
+Version 1.0 (December 2025)
+
+================================================================================
+FUTURE OPEN SOURCE NOTICE
+================================================================================
+NAuth Toolkit will transition to an open-source license (MIT or Apache 2.0) for
+core authentication features once the project reaches production readiness.
+
+This Early Access License is temporary and designed to:
+• Allow developers to build with nauth-toolkit during preview/beta
+• Provide clear expectations during the pre-release phase
+• Enable feedback and real-world testing before GA
+
+We're committed to keeping core auth free and open source. Premium features
+(enterprise SSO, advanced compliance, hosted options) will be offered separately
+under fair commercial terms.
+
+================================================================================
+EARLY ACCESS LICENSE TERMS
+================================================================================
+
+1. Grant of Use
+   You are granted a free, non-exclusive, non-transferable license to:
+   - Install and use nauth-toolkit packages in development, testing, staging,
+     and production environments
+   - Modify the code for your own internal use
+   - Deploy applications using nauth-toolkit to serve your users
+
+   You may NOT:
+   - Redistribute NAuth Toolkit as a standalone product or service
+   - Sell, sublicense, or offer NAuth Toolkit as part of a competing auth
+     platform or toolkit
+   - Remove or alter copyright notices
+
+2. No Fees During Early Access
+   There are no license fees, subscription costs, or usage charges during the
+   Early Access period. You may use nauth-toolkit freely for commercial and
+   non-commercial purposes within the terms of this license.
+
+3. Production Use
+   Production use is permitted but comes with standard early-access caveats:
+   - Features and APIs may change between preview releases
+   - Support is community-based (GitHub issues/discussions)
+   - No SLA or guaranteed uptime (you run it on your infrastructure)
+
+   We recommend thorough testing and having rollback plans for critical systems.
+
+4. Future Transition
+   When nauth-toolkit releases v1.0 GA:
+   - Core packages will adopt an open-source license (MIT or Apache 2.0)
+   - Your existing deployments will continue to work
+   - Premium features (if any) will be clearly documented with separate licensing
+   - No forced upgrades or surprise fees
+
+5. Ownership
+   NAuth Toolkit is developed and maintained by Noorix Digital Solutions.
+   You retain full ownership of your applications and data.
+
+6. Data and Privacy
+   NAuth Toolkit runs in YOUR infrastructure and database. You control all data.
+   You are responsible for compliance with applicable data protection laws.
+
+7. Disclaimer of Warranty
+   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 NON-INFRINGEMENT.
+
+8. Limitation of Liability
+   IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY INDIRECT, INCIDENTAL,
+   SPECIAL, CONSEQUENTIAL, OR EXEMPLARY DAMAGES, INCLUDING BUT NOT LIMITED TO LOSS
+   OF PROFITS, REVENUE, DATA, OR USE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
+   DAMAGES.
+
+9. Termination
+   This license remains in effect until:
+   - You stop using nauth-toolkit, or
+   - The project transitions to open source (at which point the new license applies)
+
+   If you breach these terms, your license terminates and you must stop using the
+   software.
+
+10. Contact and Support
+    - Documentation: https://nauth.dev
+    - Issues/Discussions: GitHub (when public repository launches)
+    - Commercial inquiries: Contact admin@noorix.com
+
+================================================================================
+Thank you for being an early adopter. Your feedback shapes the future of NAuth.
+================================================================================

package/README.md

@@ -0,0 +1,182 @@
+# @nauth-toolkit/client-angular
+
+Angular adapter for nauth-toolkit client SDK. Provides Angular-specific components, services, guards, and interceptors for seamless authentication integration.
+
+## Features
+
+- **AuthService** - Injectable wrapper around NAuthClient with RxJS Observables
+- **authInterceptor** - HTTP interceptor for auth headers, CSRF, and token refresh
+- **authGuard** - Route guard for protected routes
+- **socialRedirectCallbackGuard** - OAuth callback handler
+- **NAuthModule** - NgModule for non-standalone apps (Angular < 17)
+- **AngularHttpAdapter** - Uses Angular's HttpClient for all requests
+
+## Installation
+
+```bash
+npm install @nauth-toolkit/client-angular @nauth-toolkit/client
+```
+
+Or with Yarn:
+
+```bash
+yarn add @nauth-toolkit/client-angular @nauth-toolkit/client
+```
+
+## Quick Start
+
+### Standalone Components (Angular 17+)
+
+```typescript
+// app.config.ts
+import { ApplicationConfig, inject } from '@angular/core';
+import { Router, provideRouter } from '@angular/router';
+import { provideHttpClient, withInterceptors } from '@angular/common/http';
+import { NAUTH_CLIENT_CONFIG, authInterceptor } from '@nauth-toolkit/client-angular';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideRouter(routes),
+    {
+      provide: NAUTH_CLIENT_CONFIG,
+      useFactory: () => {
+        const router = inject(Router);
+        return {
+          baseUrl: 'https://api.example.com/auth',
+          tokenDelivery: 'cookies',
+          onSessionExpired: () => router.navigate(['/login']),
+        };
+      },
+    },
+    provideHttpClient(withInterceptors([authInterceptor])),
+  ],
+};
+```
+
+### NgModule (Angular < 17)
+
+```typescript
+// app.module.ts
+import { NgModule } from '@angular/core';
+import { BrowserModule } from '@angular/platform-browser';
+import { Router } from '@angular/router';
+import { HttpClientModule, HTTP_INTERCEPTORS } from '@angular/common/http';
+import { NAuthModule, AuthInterceptor, NAUTH_CLIENT_CONFIG } from '@nauth-toolkit/client-angular';
+
+@NgModule({
+  imports: [BrowserModule, HttpClientModule, NAuthModule],
+  providers: [
+    {
+      provide: NAUTH_CLIENT_CONFIG,
+      useFactory: (router: Router) => ({
+        baseUrl: 'https://api.example.com/auth',
+        tokenDelivery: 'cookies',
+        onSessionExpired: () => router.navigate(['/login']),
+      }),
+      deps: [Router],
+    },
+    { provide: HTTP_INTERCEPTORS, useClass: AuthInterceptor, multi: true },
+  ],
+  bootstrap: [AppComponent],
+})
+export class AppModule {}
+```
+
+## Usage
+
+### Authentication
+
+```typescript
+import { Component } from '@angular/core';
+import { Router } from '@angular/router';
+import { AuthService } from '@nauth-toolkit/client-angular';
+
+@Component({
+  selector: 'app-login',
+  template: `
+    <form (ngSubmit)="login()">
+      <input [(ngModel)]="email" placeholder="Email" />
+      <input [(ngModel)]="password" type="password" />
+      <button type="submit">Login</button>
+    </form>
+  `,
+})
+export class LoginComponent {
+  email = '';
+  password = '';
+
+  constructor(
+    private auth: AuthService,
+    private router: Router,
+  ) {}
+
+  async login() {
+    const response = await this.auth.login(this.email, this.password);
+    if (response.challengeName) {
+      this.router.navigate(['/verify', response.challengeName.toLowerCase()]);
+    } else {
+      this.router.navigate(['/dashboard']);
+    }
+  }
+}
+```
+
+### Route Protection
+
+```typescript
+// app.routes.ts
+import { Routes } from '@angular/router';
+import { authGuard } from '@nauth-toolkit/client-angular';
+
+export const routes: Routes = [
+  { path: 'login', component: LoginComponent },
+  {
+    path: 'dashboard',
+    component: DashboardComponent,
+    canActivate: [authGuard()],
+  },
+];
+```
+
+### Reactive State
+
+```typescript
+import { Component } from '@angular/core';
+import { AuthService } from '@nauth-toolkit/client-angular';
+import { AsyncPipe } from '@angular/common';
+
+@Component({
+  selector: 'app-profile',
+  template: `
+    @if (currentUser$ | async; as user) {
+      <h1>Welcome, {{ user.email }}</h1>
+    }
+  `,
+  imports: [AsyncPipe],
+})
+export class ProfileComponent {
+  currentUser$ = this.auth.currentUser$;
+
+  constructor(private auth: AuthService) {}
+}
+```
+
+## Compatibility
+
+- **Angular**: 14.0.0+
+- **RxJS**: 7.x or 8.x
+- **Node.js**: 22.0.0+
+
+## Documentation
+
+Full documentation available at [https://nauth-toolkit.com/docs](https://nauth-toolkit.com/docs)
+
+- [Angular Integration Guide](https://nauth-toolkit.com/docs/frontend-sdk/angular/overview)
+- [API Reference](https://nauth-toolkit.com/docs/frontend-sdk/api/overview)
+- [Challenge Handling](https://nauth-toolkit.com/docs/frontend-sdk/guides/challenge-handling)
+- [MFA Setup](https://nauth-toolkit.com/docs/frontend-sdk/guides/mfa-setup)
+
+## License
+
+UNLICENSED
+