@shohaghinfo/aerojs 0.2.0 → 0.3.0

package/README.md

@@ -62,6 +62,9 @@
   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)
@@ -1329,6 +1332,113 @@ 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 | **AeroJS** |

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"}

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

@@ -0,0 +1,86 @@
+/**
+ * @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 { GoogleOAuthDriver } from './google-driver.js';
+import { GitHubOAuthDriver } from './github-driver.js';
+export class OAuthManager {
+    configs = new Map();
+    drivers = new Map();
+    customFactories = new Map();
+    fakedUser;
+    constructor(config = {}) {
+        this.configure(config);
+    }
+    configure(config) {
+        if (config.providers) {
+            for (const [name, cfg] of Object.entries(config.providers)) {
+                this.configs.set(name.toLowerCase(), cfg);
+            }
+        }
+        return this;
+    }
+    extend(providerName, factory) {
+        this.customFactories.set(providerName.toLowerCase(), factory);
+        return this;
+    }
+    driver(provider) {
+        const name = provider.toLowerCase();
+        if (this.fakedUser) {
+            const mockUser = this.fakedUser;
+            return {
+                getRedirectUrl: () => `https://mock-oauth.com/${name}/auth`,
+                getUserFromToken: async () => mockUser,
+                handleCallback: async () => ({
+                    accessToken: 'mock_access_token_123',
+                    user: mockUser,
+                }),
+            };
+        }
+        if (this.drivers.has(name)) {
+            return this.drivers.get(name);
+        }
+        const cfg = this.configs.get(name) || {
+            clientId: process.env[`${name.toUpperCase()}_CLIENT_ID`] || '',
+            clientSecret: process.env[`${name.toUpperCase()}_CLIENT_SECRET`] || '',
+            redirectUri: process.env[`${name.toUpperCase()}_REDIRECT_URI`] || '',
+        };
+        let driverInstance;
+        if (this.customFactories.has(name)) {
+            driverInstance = this.customFactories.get(name)(cfg);
+        }
+        else {
+            switch (name) {
+                case 'google':
+                    driverInstance = new GoogleOAuthDriver(cfg);
+                    break;
+                case 'github':
+                    driverInstance = new GitHubOAuthDriver(cfg);
+                    break;
+                default:
+                    throw new Error(`Unsupported OAuth provider: "${provider}". Register custom driver with OAuth.extend()`);
+            }
+        }
+        this.drivers.set(name, driverInstance);
+        return driverInstance;
+    }
+    /**
+     * Fakes OAuth authentication for test environments.
+     */
+    fake(user = {}) {
+        this.fakedUser = {
+            id: user.id || 'faked-oauth-user-id',
+            email: user.email || 'faked@example.com',
+            name: user.name || 'Faked OAuth User',
+            avatarUrl: user.avatarUrl || 'https://example.com/avatar.png',
+            raw: user.raw || {},
+        };
+        return this.fakedUser;
+    }
+    restore() {
+        this.fakedUser = undefined;
+    }
+}
+export const OAuth = new OAuthManager();
+//# sourceMappingURL=oauth-manager.js.map

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

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

package/dist/cli/commands/make.d.ts

@@ -13,4 +13,9 @@ export declare function makeModel(name: string, options?: {
 export declare function makeMigration(name: string, targetDir?: string): string;
 export declare function makeSeeder(name: string, targetDir?: string): string;
 export declare function makeMiddleware(name: string, targetDir?: string): string;
+export declare function makeJob(name: string, targetDir?: string): string;
+export declare function makeMail(name: string, targetDir?: string): string;
+export declare function makePolicy(name: string, targetDir?: string): string;
+export declare function makeEvent(name: string, targetDir?: string): string;
+export declare function makeListener(name: string, targetDir?: string): string;
 //# sourceMappingURL=make.d.ts.map

package/dist/cli/commands/make.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"make.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/make.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAoB,GAAG,MAAM,CA6DlF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CA4BhJ;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAwB,GAAG,MAAM,CA8BrF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAqB,GAAG,MAAM,CAuB/E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAmB,GAAG,MAAM,CAoBjF"}
+{"version":3,"file":"make.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/make.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAoB,GAAG,MAAM,CA6DlF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CA4BhJ;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAwB,GAAG,MAAM,CA8BrF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAqB,GAAG,MAAM,CAuB/E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAmB,GAAG,MAAM,CAoBjF;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAa,GAAG,MAAM,CAiCpE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAa,GAAG,MAAM,CAyBrE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAiB,GAAG,MAAM,CA+B3E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAe,GAAG,MAAM,CAqBxE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAkB,GAAG,MAAM,CAmB9E"}