@shohaghinfo/aerojs 0.1.2 → 0.3.0

package/README.md

@@ -5,7 +5,8 @@
   ### The Blazing-Fast, Zero-Dependency Full-Stack Web Framework for Node.js
 
   [![CI](https://github.com/atifsoftware/AeroJS/actions/workflows/ci.yml/badge.svg)](https://github.com/atifsoftware/AeroJS/actions/workflows/ci.yml)
-  [![NPM Version](https://img.shields.io/badge/npm-v0.1.0-blue.svg)](https://npmjs.com/package/aerojs)
+  [![NPM Version](https://img.shields.io/npm/v/@shohaghinfo/aerojs.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/@shohaghinfo/aerojs)
+  [![NPM Downloads](https://img.shields.io/npm/dm/@shohaghinfo/aerojs.svg?style=flat-square&color=green)](https://www.npmjs.com/package/@shohaghinfo/aerojs)
   [![Coverage: 88%+](https://img.shields.io/badge/coverage-88%25-brightgreen.svg)](package.json)
   [![Zero Dependencies](https://img.shields.io/badge/dependencies-0-success.svg)](package.json)
   [![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-darkgreen.svg)](package.json)
@@ -57,6 +58,13 @@
   28. [Background Queue & Mail System (`Queue`, `Mail`)](#28-background-queue--mail-system-queue-mail)
   29. [OpenAPI 3.0 & Interactive Swagger UI (`useSwagger`)](#29-openapi-30--interactive-swagger-ui-useswagger)
   30. [Aero Command-Line Interface (`aero` CLI)](#30-aero-command-line-interface-aero-cli)
+  31. [SMTP Mail Driver (`SmtpMailDriver`, `Mail`)](#31-smtp-mail-driver-smtpmaildriver-mail)
+  32. [Distributed Redis Rate Limiter (`RedisRateLimitStore`)](#32-distributed-redis-rate-limiter-redisratelimitstore)
+  33. [Redis Queue Driver with DLQ (`RedisQueueDriver`)](#33-redis-queue-driver-with-dlq-redisqueuedriver)
+  34. [Fluent HTTP Client (`Http`, `HttpResponse`)](#34-fluent-http-client-http-httpresponse)
+  35. [OAuth 2.0 & Social Login (`OAuth`, Google, GitHub)](#35-oauth-20--social-login-oauth-google-github)
+  36. [Multi-Channel Notifications (`Notification`, `Notifications`)](#36-multi-channel-notifications-notification-notifications)
+  37. [Tamper-Proof Signed URLs (`UrlSigner`, `validateSignedUrl`)](#37-tamper-proof-signed-urls-urlsigner-validatesignedurl)
 - [Performance, Size & Advantages](#-performance-size--advantages)
 - [Comparison Matrix](#-comparison-matrix)
 - [License](#-license)
@@ -146,13 +154,50 @@ Aero is engineered from first principles to combine the best architectural conce
 
 ## 📦 Installation
 
+### Option 1: Create a New Project (Recommended)
+
+Scaffold a complete production-ready application in seconds using `npx`:
+
 ```bash
-npm install aerojs
+# Interactive project creation
+npx @shohaghinfo/aerojs new my-app
+
+# Or scaffold in current directory
+npx @shohaghinfo/aerojs init
 ```
 
-Requirements:
-- Node.js >= 20.0.0
-- ESM project (`"type": "module"` in `package.json`)
+### Option 2: Install into an Existing Project
+
+Add AeroJS to your project with your favorite package manager:
+
+```bash
+# npm
+npm install @shohaghinfo/aerojs
+
+# pnpm
+pnpm add @shohaghinfo/aerojs
+
+# yarn
+yarn add @shohaghinfo/aerojs
+
+# bun
+bun add @shohaghinfo/aerojs
+```
+
+### Option 3: Global CLI Installation
+
+```bash
+npm install -g @shohaghinfo/aerojs
+
+# Now you can use the 'aero' command anywhere:
+aero new my-app
+# or
+aerojs new my-app
+```
+
+#### Requirements:
+- **Node.js**: `>= 20.0.0`
+- **Module System**: ESM (`"type": "module"` in `package.json`)
 
 ---
 
@@ -1145,7 +1190,7 @@ Unlike legacy Node.js frameworks that ship with bloated dependency trees, AeroJS
 - Ideal for **Serverless environments** (AWS Lambda, Cloudflare Containers, Vercel Serverless, Google Cloud Run) and autoscaling Docker microservices.
 
 #### 🏎️ Lightning-Fast CI/CD Deployments
-- `npm install aero` downloads only a few kilobytes and completes in **1–2 seconds**, drastically cutting down pipeline build times and bandwidth costs.
+- `npm install @shohaghinfo/aerojs` downloads only a few kilobytes and completes in **1–2 seconds**, drastically cutting down pipeline build times and bandwidth costs.
 
 #### 🌐 Unified Full-Stack Architecture
 - Eliminates context switching and multi-repository overhead: build **REST APIs**, **React/Vue 3 SPAs (Inertia.js)**, and traditional **SSR Views (Edge.js/EJS)** in a single cohesive codebase.
@@ -1155,9 +1200,248 @@ Unlike legacy Node.js frameworks that ship with bloated dependency trees, AeroJS
 
 ---
 
+### 31. SMTP Mail Driver (`SmtpMailDriver`, `Mail`)
+
+AeroJS includes a **zero-dependency native SMTP transport** directly built on Node.js `net` and `tls` sockets. Supports SSL (port 465), STARTTLS (port 587/25), AUTH LOGIN, multipart HTML & plain text, and base64 attachments.
+
+```typescript
+import { Mail, MailMessage, SmtpMailDriver } from '@shohaghinfo/aerojs';
+
+// 1. Configure in MailManager
+Mail.configure({
+  default: 'smtp',
+  mailers: {
+    smtp: {
+      driver: 'smtp',
+      host: 'smtp.mailtrap.io',
+      port: 587,
+      auth: {
+        user: process.env.SMTP_USER!,
+        pass: process.env.SMTP_PASS!,
+      },
+    },
+  },
+});
+
+// 2. Dispatch with attachments & HTML
+await Mail.send((msg) => {
+  msg.to('patient@example.com')
+     .from('billing@hospital.org', 'Hospital Billing')
+     .subject('Monthly Statement & Invoice')
+     .html('<h1>Hello!</h1><p>Please find your medical invoice attached.</p>')
+     .attach('invoice.pdf', pdfBuffer, 'application/pdf');
+});
+```
+
+---
+
+### 32. Distributed Redis Rate Limiter (`RedisRateLimitStore`)
+
+For distributed production deployments running behind reverse proxies or multiple server nodes, `RedisRateLimitStore` synchronizes rate limit counters across all instances via atomic Redis commands.
+
+```typescript
+import { Aero, rateLimit, RedisRateLimitStore, RedisClient } from '@shohaghinfo/aerojs';
+
+const app = new Aero();
+const redis = new RedisClient({ host: '127.0.0.1', port: 6379 });
+
+app.use(
+  rateLimit({
+    windowMs: 60_000, // 1 minute
+    max: 100,         // 100 requests per minute
+    store: new RedisRateLimitStore({
+      client: redis,
+      prefix: 'rl:api:',
+      fallbackToMemory: true, // Gracefully handles Redis disconnection
+    }),
+  })
+);
+```
+
+---
+
+### 33. Redis Queue Driver with DLQ (`RedisQueueDriver`)
+
+AeroJS provides a production-grade background job queue backed by Redis with FIFO execution (`LPUSH`/`RPOP`), delayed scheduling (`ZADD`), worker reservation tracking, retry backoff, and a Dead Letter Queue (DLQ).
+
+```typescript
+import { Queue, Job, RedisQueueDriver, RedisClient } from '@shohaghinfo/aerojs';
+
+// 1. Configure Redis Queue Connection
+Queue.configure({
+  default: 'redis',
+  connections: {
+    redis: {
+      driver: 'redis',
+      redis: new RedisClient({ host: '127.0.0.1', port: 6379 }),
+    },
+  },
+});
+
+// 2. Define Background Job
+class ProcessPayrollJob extends Job {
+  public async handle(): Promise<void> {
+    console.log(`Processing payroll batch #${this.data.batchId}...`);
+  }
+}
+Queue.registerJob('ProcessPayrollJob', ProcessPayrollJob);
+
+// 3. Dispatch Job (Immediate or Delayed)
+await Queue.dispatch(new ProcessPayrollJob({ batchId: 402 }), {
+  delay: 10, // Wait 10 seconds before execution
+});
+
+// 4. Start Worker
+const worker = Queue.createWorker({ concurrency: 5 });
+await worker.start();
+```
+
+---
+
+### 34. Fluent HTTP Client (`Http`, `HttpResponse`)
+
+AeroJS ships with a powerful, zero-dependency fluent HTTP client built on native `fetch`. It supports automatic JSON serialization, query string formatting, Bearer/Basic authentication, timeouts, retries, and comprehensive testing fakes.
+
+```typescript
+import { Http } from '@shohaghinfo/aerojs';
+
+// 1. Fluent API calls
+const response = await Http.baseUrl('https://api.hospital-network.com/v1')
+  .withToken(process.env.API_KEY!)
+  .withQuery({ status: 'active', limit: 50 })
+  .timeout(5000)
+  .retry(3, 200)
+  .get('/patients');
+
+if (response.successful) {
+  const patients = response.json();
+  console.log('Patients fetched:', patients);
+}
+
+// 2. Testing Fakes (Mocking external services)
+Http.fake({
+  '/patients': [{ id: 1, name: 'Alice Smith' }],
+  '/billing': Http.response({ invoiceId: 'INV-101' }, 201),
+});
+
+const res = await Http.post('https://api.hospital-network.com/v1/billing', { amount: 500 });
+expect(res.status).toBe(201);
+
+Http.assertSent((req) => req.url.includes('/billing') && req.method === 'POST');
+```
+
+---
+
+### 35. OAuth 2.0 & Social Login (`OAuth`, Google, GitHub)
+
+Authenticate users with Google, GitHub, or custom OAuth 2.0 identity providers without external libraries.
+
+```typescript
+import { OAuth, router } from '@shohaghinfo/aerojs';
+
+// 1. Configure Providers
+OAuth.configure({
+  providers: {
+    google: {
+      clientId: process.env.GOOGLE_CLIENT_ID!,
+      clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
+      redirectUri: 'https://myapp.com/auth/google/callback',
+    },
+    github: {
+      clientId: process.env.GITHUB_CLIENT_ID!,
+      clientSecret: process.env.GITHUB_CLIENT_SECRET!,
+      redirectUri: 'https://myapp.com/auth/github/callback',
+    },
+  },
+});
+
+// 2. Redirect to Provider
+router.get('/auth/google', (ctx) => {
+  ctx.redirect(OAuth.driver('google').getRedirectUrl());
+});
+
+// 3. Handle Callback
+router.get('/auth/google/callback', async (ctx) => {
+  const code = ctx.query.code as string;
+  const { user, accessToken } = await OAuth.driver('google').handleCallback(code);
+
+  console.log('Logged in user:', user.name, user.email, user.avatarUrl);
+  ctx.json({ success: true, user });
+});
+```
+
+---
+
+### 36. Multi-Channel Notifications (`Notification`, `Notifications`)
+
+Deliver notifications simultaneously across multiple delivery channels (Email, Database, Realtime Broadcast, SMS) with unified syntax.
+
+```typescript
+import { Notification, Notifications, MailMessage } from '@shohaghinfo/aerojs';
+
+class OrderShippedNotification extends Notification {
+  constructor(public order: any) {
+    super();
+  }
+
+  // Choose delivery channels
+  public via(user: any): string[] {
+    return ['mail', 'database', 'broadcast'];
+  }
+
+  public toMail(user: any): MailMessage {
+    const msg = new MailMessage();
+    return msg.subject(`Order #${this.order.id} Shipped`)
+              .html(`<h1>Your package is on its way!</h1>`);
+  }
+
+  public toDatabase(user: any) {
+    return { orderId: this.order.id, trackingNumber: 'TRK-98124' };
+  }
+
+  public toBroadcast(user: any) {
+    return {
+      channel: `user.${user.id}`,
+      event: 'OrderShipped',
+      data: { orderId: this.order.id },
+    };
+  }
+}
+
+// Dispatch to single user or array of users
+await Notifications.send(customer, new OrderShippedNotification(order));
+```
+
+---
+
+### 37. Tamper-Proof Signed URLs (`UrlSigner`, `validateSignedUrl`)
+
+Generate time-limited, cryptographically verified URLs for private downloads, password resets, or webhooks.
+
+```typescript
+import { UrlSigner, validateSignedUrl, Storage, router } from '@shohaghinfo/aerojs';
+
+// 1. Generate 15-minute temporary download link
+const downloadUrl = await Storage.temporaryUrl('invoices/inv-2026.pdf', 900);
+// Returns: /storage/invoices/inv-2026.pdf?expires=1790924000&signature=8f9a2...
+
+// 2. Protect route with middleware
+router.get('/secure/download', validateSignedUrl(), async (ctx) => {
+  ctx.json({ data: 'Confidential file contents' });
+});
+
+// 3. Or verify inline inside controller:
+if (!ctx.hasValidSignature()) {
+  ctx.status(403).json({ error: 'Signature invalid or expired' });
+  return;
+}
+```
+
+---
+
 ## 📊 Comparison Matrix
 
-| Feature | Express | Koa | Fastify | AdonisJS | **Aero** |
+| Feature | Express | Koa | Fastify | AdonisJS | **AeroJS** |
 |---|:---:|:---:|:---:|:---:|:---:|
 | **Zero Runtime Dependencies** | ❌ (30+) | ❌ (20+) | ❌ (15+) | ❌ (50+) | **✅ ZERO** |
 | **Radix Tree Routing** | ❌ | ❌ | ✅ | ❌ | **✅ O(k)** |

package/dist/auth/index.d.ts

@@ -1,2 +1,3 @@
 export * from './policy.js';
+export * from './oauth/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/auth/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}

package/dist/auth/index.js

@@ -1,2 +1,3 @@
 export * from './policy.js';
+export * from './oauth/index.js';
 //# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}

package/dist/auth/oauth/github-driver.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @file github-driver.ts
+ * @description GitHub OAuth 2.0 social login provider for AeroJS.
+ */
+import type { OAuthDriver, OAuthDriverConfig, OAuthUser, OAuthCallbackResult } from './oauth-driver.js';
+export declare class GitHubOAuthDriver implements OAuthDriver {
+    private config;
+    constructor(config: OAuthDriverConfig);
+    getRedirectUrl(options?: {
+        state?: string;
+        scopes?: string[];
+    }): string;
+    getUserFromToken(accessToken: string): Promise<OAuthUser>;
+    handleCallback(code: string): Promise<OAuthCallbackResult>;
+}
+//# sourceMappingURL=github-driver.d.ts.map

package/dist/auth/oauth/github-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-driver.d.ts","sourceRoot":"","sources":["../../../src/auth/oauth/github-driver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxG,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,EAAE,iBAAiB;IAO9B,cAAc,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO,GAAG,MAAM;IAerE,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAkCzD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAsBxE"}

package/dist/auth/oauth/github-driver.js

@@ -0,0 +1,79 @@
+/**
+ * @file github-driver.ts
+ * @description GitHub OAuth 2.0 social login provider for AeroJS.
+ */
+import { Http } from '../../http/http.js';
+export class GitHubOAuthDriver {
+    config;
+    constructor(config) {
+        this.config = {
+            scopes: ['read:user', 'user:email'],
+            ...config,
+        };
+    }
+    getRedirectUrl(options = {}) {
+        const scopes = options.scopes || this.config.scopes || ['read:user', 'user:email'];
+        const params = new URLSearchParams({
+            client_id: this.config.clientId,
+            redirect_uri: this.config.redirectUri,
+            scope: scopes.join(' '),
+        });
+        if (options.state) {
+            params.set('state', options.state);
+        }
+        return `https://github.com/login/oauth/authorize?${params.toString()}`;
+    }
+    async getUserFromToken(accessToken) {
+        const res = await Http.withToken(accessToken)
+            .withHeaders({ 'User-Agent': 'AeroJS-OAuth' })
+            .get('https://api.github.com/user');
+        res.throw();
+        const data = res.json();
+        // If primary email is private in GitHub, fetch from /user/emails
+        let email = data.email || null;
+        if (!email) {
+            try {
+                const emailsRes = await Http.withToken(accessToken)
+                    .withHeaders({ 'User-Agent': 'AeroJS-OAuth' })
+                    .get('https://api.github.com/user/emails');
+                if (emailsRes.successful) {
+                    const emails = emailsRes.json();
+                    const primary = emails.find((e) => e.primary && e.verified) || emails[0];
+                    if (primary)
+                        email = primary.email;
+                }
+            }
+            catch {
+                // Ignored
+            }
+        }
+        return {
+            id: String(data.id),
+            email,
+            name: data.name || data.login || null,
+            avatarUrl: data.avatar_url || null,
+            raw: data,
+        };
+    }
+    async handleCallback(code) {
+        const res = await Http.acceptJson()
+            .withHeaders({ 'User-Agent': 'AeroJS-OAuth' })
+            .post('https://github.com/login/oauth/access_token', {
+            client_id: this.config.clientId,
+            client_secret: this.config.clientSecret,
+            code,
+            redirect_uri: this.config.redirectUri,
+        });
+        res.throw();
+        const tokenData = res.json();
+        const accessToken = tokenData.access_token;
+        const user = await this.getUserFromToken(accessToken);
+        return {
+            accessToken,
+            tokenType: tokenData.token_type,
+            scope: tokenData.scope,
+            user,
+        };
+    }
+}
+//# sourceMappingURL=github-driver.js.map

package/dist/auth/oauth/github-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-driver.js","sourceRoot":"","sources":["../../../src/auth/oauth/github-driver.ts"],"names":[],"mappings":"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"}

package/dist/auth/oauth/google-driver.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @file google-driver.ts
+ * @description Google OAuth 2.0 social login provider for AeroJS.
+ */
+import type { OAuthDriver, OAuthDriverConfig, OAuthUser, OAuthCallbackResult } from './oauth-driver.js';
+export declare class GoogleOAuthDriver implements OAuthDriver {
+    private config;
+    constructor(config: OAuthDriverConfig);
+    getRedirectUrl(options?: {
+        state?: string;
+        scopes?: string[];
+    }): string;
+    getUserFromToken(accessToken: string): Promise<OAuthUser>;
+    handleCallback(code: string): Promise<OAuthCallbackResult>;
+}
+//# sourceMappingURL=google-driver.d.ts.map

package/dist/auth/oauth/google-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-driver.d.ts","sourceRoot":"","sources":["../../../src/auth/oauth/google-driver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxG,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,EAAE,iBAAiB;IAO9B,cAAc,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO,GAAG,MAAM;IAkBrE,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAczD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAuBxE"}

package/dist/auth/oauth/google-driver.js

@@ -0,0 +1,63 @@
+/**
+ * @file google-driver.ts
+ * @description Google OAuth 2.0 social login provider for AeroJS.
+ */
+import { Http } from '../../http/http.js';
+export class GoogleOAuthDriver {
+    config;
+    constructor(config) {
+        this.config = {
+            scopes: ['openid', 'email', 'profile'],
+            ...config,
+        };
+    }
+    getRedirectUrl(options = {}) {
+        const scopes = options.scopes || this.config.scopes || ['openid', 'email', 'profile'];
+        const params = new URLSearchParams({
+            client_id: this.config.clientId,
+            redirect_uri: this.config.redirectUri,
+            response_type: 'code',
+            scope: scopes.join(' '),
+            access_type: 'offline',
+            prompt: 'consent',
+        });
+        if (options.state) {
+            params.set('state', options.state);
+        }
+        return `https://accounts.google.com/o/oauth2/v2/auth?${params.toString()}`;
+    }
+    async getUserFromToken(accessToken) {
+        const res = await Http.withToken(accessToken).get('https://www.googleapis.com/oauth2/v3/userinfo');
+        res.throw();
+        const data = res.json();
+        return {
+            id: String(data.sub || data.id),
+            email: data.email || null,
+            name: data.name || null,
+            avatarUrl: data.picture || null,
+            raw: data,
+        };
+    }
+    async handleCallback(code) {
+        const res = await Http.asForm().post('https://oauth2.googleapis.com/token', {
+            client_id: this.config.clientId,
+            client_secret: this.config.clientSecret,
+            code,
+            grant_type: 'authorization_code',
+            redirect_uri: this.config.redirectUri,
+        });
+        res.throw();
+        const tokenData = res.json();
+        const accessToken = tokenData.access_token;
+        const user = await this.getUserFromToken(accessToken);
+        return {
+            accessToken,
+            tokenType: tokenData.token_type,
+            expiresIn: tokenData.expires_in,
+            refreshToken: tokenData.refresh_token,
+            scope: tokenData.scope,
+            user,
+        };
+    }
+}
+//# sourceMappingURL=google-driver.js.map

package/dist/auth/oauth/google-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-driver.js","sourceRoot":"","sources":["../../../src/auth/oauth/google-driver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAoB;IAElC,YAAY,MAAyB;QACnC,IAAI,CAAC,MAAM,GAAG;YACZ,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC;YACtC,GAAG,MAAM;SACV,CAAC;IACJ,CAAC;IAEM,cAAc,CAAC,UAAiD,EAAE;QACvE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACtF,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;YACjC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;YAC/B,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;YACrC,aAAa,EAAE,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;YACvB,WAAW,EAAE,SAAS;YACtB,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,gDAAgD,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC7E,CAAC;IAEM,KAAK,CAAC,gBAAgB,CAAC,WAAmB;QAC/C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;QACnG,GAAG,CAAC,KAAK,EAAE,CAAC;QAEZ,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACxB,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;YAC/B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI;YACvB,SAAS,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;YAC/B,GAAG,EAAE,IAAI;SACV,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,cAAc,CAAC,IAAY;QACtC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,qCAAqC,EAAE;YAC1E,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;YAC/B,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;YACvC,IAAI;YACJ,UAAU,EAAE,oBAAoB;YAChC,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;SACtC,CAAC,CAAC;QACH,GAAG,CAAC,KAAK,EAAE,CAAC;QAEZ,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,SAAS,CAAC,YAAY,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAEtD,OAAO;YACL,WAAW;YACX,SAAS,EAAE,SAAS,CAAC,UAAU;YAC/B,SAAS,EAAE,SAAS,CAAC,UAAU;YAC/B,YAAY,EAAE,SAAS,CAAC,aAAa;YACrC,KAAK,EAAE,SAAS,CAAC,KAAK;YACtB,IAAI;SACL,CAAC;IACJ,CAAC;CACF"}

package/dist/auth/oauth/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @file index.ts
+ * @description AeroJS Social Authentication & OAuth 2.0 Module.
+ */
+export * from './oauth-driver.js';
+export * from './google-driver.js';
+export * from './github-driver.js';
+export * from './oauth-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/auth/oauth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/auth/oauth/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

package/dist/auth/oauth/index.js

@@ -0,0 +1,9 @@
+/**
+ * @file index.ts
+ * @description AeroJS Social Authentication & OAuth 2.0 Module.
+ */
+export * from './oauth-driver.js';
+export * from './google-driver.js';
+export * from './github-driver.js';
+export * from './oauth-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/auth/oauth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/auth/oauth/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

package/dist/auth/oauth/oauth-driver.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @file oauth-driver.ts
+ * @description Standard contracts and models for OAuth 2.0 social login in AeroJS.
+ */
+export interface OAuthUser {
+    id: string;
+    email: string | null;
+    name: string | null;
+    avatarUrl: string | null;
+    raw: any;
+}
+export interface OAuthCallbackResult {
+    accessToken: string;
+    tokenType?: string;
+    expiresIn?: number;
+    refreshToken?: string;
+    scope?: string;
+    user: OAuthUser;
+}
+export interface OAuthDriverConfig {
+    clientId: string;
+    clientSecret: string;
+    redirectUri: string;
+    scopes?: string[];
+    [key: string]: any;
+}
+export interface OAuthDriver {
+    getRedirectUrl(options?: {
+        state?: string;
+        scopes?: string[];
+    }): string;
+    getUserFromToken(accessToken: string): Promise<OAuthUser>;
+    handleCallback(code: string, state?: string): Promise<OAuthCallbackResult>;
+}
+//# sourceMappingURL=oauth-driver.d.ts.map

package/dist/auth/oauth/oauth-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-driver.d.ts","sourceRoot":"","sources":["../../../src/auth/oauth/oauth-driver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,GAAG,EAAE,GAAG,CAAC;CACV;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,cAAc,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,MAAM,CAAC;IACxE,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1D,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC5E"}

package/dist/auth/oauth/oauth-driver.js

@@ -0,0 +1,6 @@
+/**
+ * @file oauth-driver.ts
+ * @description Standard contracts and models for OAuth 2.0 social login in AeroJS.
+ */
+export {};
+//# sourceMappingURL=oauth-driver.js.map

package/dist/auth/oauth/oauth-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-driver.js","sourceRoot":"","sources":["../../../src/auth/oauth/oauth-driver.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/auth/oauth/oauth-manager.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @file oauth-manager.ts
+ * @description Central OAuth 2.0 social login manager for AeroJS.
+ * Manages OAuth providers (Google, GitHub, custom) with easy redirection and callback handling.
+ */
+import type { OAuthDriver, OAuthDriverConfig, OAuthUser } from './oauth-driver.js';
+export interface OAuthConfig {
+    providers?: Record<string, OAuthDriverConfig>;
+}
+export declare class OAuthManager {
+    private configs;
+    private drivers;
+    private customFactories;
+    private fakedUser?;
+    constructor(config?: OAuthConfig);
+    configure(config: OAuthConfig): this;
+    extend(providerName: string, factory: (config: OAuthDriverConfig) => OAuthDriver): this;
+    driver(provider: 'google' | 'github' | string): OAuthDriver;
+    /**
+     * Fakes OAuth authentication for test environments.
+     */
+    fake(user?: Partial<OAuthUser>): OAuthUser;
+    restore(): void;
+}
+export declare const OAuth: OAuthManager;
+//# sourceMappingURL=oauth-manager.d.ts.map

package/dist/auth/oauth/oauth-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-manager.d.ts","sourceRoot":"","sources":["../../../src/auth/oauth/oauth-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,SAAS,EAAuB,MAAM,mBAAmB,CAAC;AAIxG,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC/C;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,eAAe,CAAiE;IACxF,OAAO,CAAC,SAAS,CAAC,CAAY;gBAElB,MAAM,GAAE,WAAgB;IAI7B,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IASpC,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,WAAW,GAAG,IAAI;IAKvF,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW;IA8ClE;;OAEG;IACI,IAAI,CAAC,IAAI,GAAE,OAAO,CAAC,SAAS,CAAM,GAAG,SAAS;IAW9C,OAAO,IAAI,IAAI;CAGvB;AAED,eAAO,MAAM,KAAK,cAAqB,CAAC"}