@shohaghinfo/aerojs 0.1.2 → 0.2.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,10 @@
   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)
 - [Performance, Size & Advantages](#-performance-size--advantages)
 - [Comparison Matrix](#-comparison-matrix)
 - [License](#-license)
@@ -146,13 +151,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 +1187,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 +1197,141 @@ 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');
+```
+
+---
+
 ## 📊 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/cli/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/cli/runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,qBAAa,OAAO;IAClB,OAAc,OAAO,SAAW;WAEZ,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC;WAmLlE,SAAS,IAAI,IAAI;CA+BhC"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/cli/runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAyBH,qBAAa,OAAO;IAClB,OAAc,OAAO,SAAwB;WAEzB,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC;WAmLlE,SAAS,IAAI,IAAI;CA+BhC"}

package/dist/cli/runner.js

@@ -5,13 +5,27 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { pathToFileURL } from 'node:url';
+import { fileURLToPath } from 'node:url';
 import { makeController, makeModel, makeMigration, makeMiddleware, makeSeeder } from './commands/make.js';
 import { initProject } from './commands/init.js';
 import { createNewProject } from './commands/new.js';
 import { encryptEnv, decryptEnv } from './commands/vault.js';
 import { Migrator } from '../database/migrator.js';
+function readPackageVersion() {
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = path.dirname(__filename);
+        // dist/cli/runner.js → ../../package.json
+        const pkgPath = path.resolve(__dirname, '../../package.json');
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        return pkg.version ?? '0.1.2';
+    }
+    catch {
+        return '0.1.2';
+    }
+}
 export class AeroCLI {
-    static version = '0.1.0';
+    static version = readPackageVersion();
     static async run(argv = process.argv.slice(2)) {
         const command = argv[0];
         if (!command || command === '--help' || command === '-h' || command === 'help') {
@@ -186,7 +200,7 @@ Options:
 
 Available Commands:
   init [dir]                 Scaffold a complete production AeroJS application
-  new <name>                 Create a new AeroJS application in a new directory
+  new <name> [--template]    Create a new AeroJS app (api-starter, react-inertia, vue-inertia, hospital-erp)
 
   make:controller <name>     Create a new RESTful controller class
   make:model <name> [-m]     Create a new Active Record Model (optionally with migration)

package/dist/cli/runner.js.map

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

package/dist/http/http.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @file http.ts
+ * @description Central Http client facade and fluent API for AeroJS.
+ */
+import { HttpRequestBuilder, type HttpFakeHandler, type RequestSentRecord } from './request-builder.js';
+import { HttpResponse } from './response.js';
+export declare class Http {
+    /**
+     * Creates a new fluent HTTP request builder.
+     */
+    static create(): HttpRequestBuilder;
+    static baseUrl(url: string): HttpRequestBuilder;
+    static withToken(token: string, type?: string): HttpRequestBuilder;
+    static withBasicAuth(username: string, password?: string): HttpRequestBuilder;
+    static withHeaders(headers: Record<string, string>): HttpRequestBuilder;
+    static withQuery(query: Record<string, any>): HttpRequestBuilder;
+    static timeout(ms: number): HttpRequestBuilder;
+    static retry(times?: number, delayMs?: number): HttpRequestBuilder;
+    static acceptJson(): HttpRequestBuilder;
+    static asJson(): HttpRequestBuilder;
+    static asForm(): HttpRequestBuilder;
+    static get(url: string, query?: Record<string, any>): Promise<HttpResponse>;
+    static post(url: string, data?: any): Promise<HttpResponse>;
+    static put(url: string, data?: any): Promise<HttpResponse>;
+    static patch(url: string, data?: any): Promise<HttpResponse>;
+    static delete(url: string, data?: any): Promise<HttpResponse>;
+    static head(url: string): Promise<HttpResponse>;
+    /**
+     * Helper to construct a synthetic mock HttpResponse.
+     */
+    static response(body?: any, status?: number, headers?: Record<string, string>): HttpResponse;
+    /**
+     * Intercepts outgoing requests for testing assertions.
+     */
+    static fake(patternOrHandler?: string | RegExp | HttpFakeHandler | Record<string, any>, handler?: HttpFakeHandler): void;
+    /**
+     * Resets all fakes and recorded requests.
+     */
+    static reset(): void;
+    static getSent(): RequestSentRecord[];
+    static assertSent(callback: (request: RequestSentRecord) => boolean): void;
+    static assertNotSent(callback: (request: RequestSentRecord) => boolean): void;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/http/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/http/http.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACxG,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,qBAAa,IAAI;IACf;;OAEG;WACW,MAAM,IAAI,kBAAkB;WAI5B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB;WAIxC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAW,GAAG,kBAAkB;WAI7D,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,kBAAkB;WAIlE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,kBAAkB;WAIhE,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,kBAAkB;WAIzD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB;WAIvC,KAAK,CAAC,KAAK,SAAI,EAAE,OAAO,SAAM,GAAG,kBAAkB;WAInD,UAAU,IAAI,kBAAkB;WAIhC,MAAM,IAAI,kBAAkB;WAI5B,MAAM,IAAI,kBAAkB;WAM5B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;WAIpE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;WAIpD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;WAInD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;WAIrD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;WAItD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAMtD;;OAEG;WACW,QAAQ,CAAC,IAAI,GAAE,GAAQ,EAAE,MAAM,SAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,YAAY;IASxG;;OAEG;WACW,IAAI,CAChB,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1E,OAAO,CAAC,EAAE,eAAe,GACxB,IAAI;IA8BP;;OAEG;WACW,KAAK,IAAI,IAAI;WAIb,OAAO,IAAI,iBAAiB,EAAE;WAI9B,UAAU,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,GAAG,IAAI;WAQnE,aAAa,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,GAAG,IAAI;CAOrF"}

package/dist/http/http.js

@@ -0,0 +1,132 @@
+/**
+ * @file http.ts
+ * @description Central Http client facade and fluent API for AeroJS.
+ */
+import { HttpRequestBuilder } from './request-builder.js';
+import { HttpResponse } from './response.js';
+export class Http {
+    /**
+     * Creates a new fluent HTTP request builder.
+     */
+    static create() {
+        return new HttpRequestBuilder();
+    }
+    static baseUrl(url) {
+        return new HttpRequestBuilder().baseUrl(url);
+    }
+    static withToken(token, type = 'Bearer') {
+        return new HttpRequestBuilder().withToken(token, type);
+    }
+    static withBasicAuth(username, password = '') {
+        return new HttpRequestBuilder().withBasicAuth(username, password);
+    }
+    static withHeaders(headers) {
+        return new HttpRequestBuilder().withHeaders(headers);
+    }
+    static withQuery(query) {
+        return new HttpRequestBuilder().withQuery(query);
+    }
+    static timeout(ms) {
+        return new HttpRequestBuilder().timeout(ms);
+    }
+    static retry(times = 3, delayMs = 100) {
+        return new HttpRequestBuilder().retry(times, delayMs);
+    }
+    static acceptJson() {
+        return new HttpRequestBuilder().acceptJson();
+    }
+    static asJson() {
+        return new HttpRequestBuilder().asJson();
+    }
+    static asForm() {
+        return new HttpRequestBuilder().asForm();
+    }
+    // --- Convenience HTTP Verbs ---
+    static get(url, query) {
+        return new HttpRequestBuilder().get(url, query);
+    }
+    static post(url, data) {
+        return new HttpRequestBuilder().post(url, data);
+    }
+    static put(url, data) {
+        return new HttpRequestBuilder().put(url, data);
+    }
+    static patch(url, data) {
+        return new HttpRequestBuilder().patch(url, data);
+    }
+    static delete(url, data) {
+        return new HttpRequestBuilder().delete(url, data);
+    }
+    static head(url) {
+        return new HttpRequestBuilder().head(url);
+    }
+    // --- Testing Utilities ---
+    /**
+     * Helper to construct a synthetic mock HttpResponse.
+     */
+    static response(body = {}, status = 200, headers = {}) {
+        const rawBody = typeof body === 'string' ? body : JSON.stringify(body);
+        const headerObj = new Headers(headers);
+        if (!headerObj.has('content-type') && typeof body === 'object') {
+            headerObj.set('content-type', 'application/json');
+        }
+        return new HttpResponse(status, status === 200 ? 'OK' : 'Mock Response', headerObj, rawBody);
+    }
+    /**
+     * Intercepts outgoing requests for testing assertions.
+     */
+    static fake(patternOrHandler, handler) {
+        if (typeof patternOrHandler === 'object' && !(patternOrHandler instanceof RegExp)) {
+            // Map of URL -> response or mock data
+            const routes = patternOrHandler;
+            HttpRequestBuilder.setFake((url) => {
+                for (const [routePattern, mockResponse] of Object.entries(routes)) {
+                    if (url.includes(routePattern) || routePattern === '*') {
+                        if (mockResponse instanceof HttpResponse) {
+                            return mockResponse;
+                        }
+                        return Http.response(mockResponse);
+                    }
+                }
+                return Http.response({}, 404);
+            });
+            return;
+        }
+        if (typeof patternOrHandler === 'function') {
+            HttpRequestBuilder.setFake(patternOrHandler);
+        }
+        else if (typeof patternOrHandler === 'string' || patternOrHandler instanceof RegExp) {
+            if (handler) {
+                HttpRequestBuilder.setFake(patternOrHandler, handler);
+            }
+        }
+        else {
+            // Default stub response if called with Http.fake()
+            HttpRequestBuilder.setFake(() => Http.response({ mocked: true }, 200));
+        }
+    }
+    /**
+     * Resets all fakes and recorded requests.
+     */
+    static reset() {
+        HttpRequestBuilder.clearFakes();
+    }
+    static getSent() {
+        return HttpRequestBuilder.getSent();
+    }
+    static assertSent(callback) {
+        const sent = HttpRequestBuilder.getSent();
+        const match = sent.some(callback);
+        if (!match) {
+            throw new Error(`Expected HTTP request matching condition was not sent. Total requests sent: ${sent.length}`);
+        }
+    }
+    static assertNotSent(callback) {
+        const sent = HttpRequestBuilder.getSent();
+        const match = sent.some(callback);
+        if (match) {
+            throw new Error('Unexpected HTTP request matching condition was sent.');
+        }
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/http/http.js.map

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

package/dist/http/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @file index.ts
+ * @description AeroJS Fluent HTTP Client Module.
+ */
+export * from './response.js';
+export * from './request-builder.js';
+export * from './http.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC"}

package/dist/http/index.js

@@ -0,0 +1,8 @@
+/**
+ * @file index.ts
+ * @description AeroJS Fluent HTTP Client Module.
+ */
+export * from './response.js';
+export * from './request-builder.js';
+export * from './http.js';
+//# sourceMappingURL=index.js.map

package/dist/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC"}

package/dist/http/request-builder.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @file request-builder.ts
+ * @description Fluent Request Builder for AeroJS HTTP client.
+ */
+import { HttpResponse } from './response.js';
+export type HttpFakeHandler = (url: string, init?: RequestInit) => HttpResponse | Promise<HttpResponse>;
+export interface RequestSentRecord {
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    body?: any;
+}
+export declare class HttpRequestBuilder {
+    private _baseUrl;
+    private _headers;
+    private _query;
+    private _timeoutMs;
+    private _retryCount;
+    private _retryDelayMs;
+    private _contentType;
+    private static fakeHandlers;
+    private static defaultFakeHandler?;
+    private static sentRequests;
+    static setFake(pattern: string | RegExp | HttpFakeHandler, handler?: HttpFakeHandler): void;
+    static clearFakes(): void;
+    static recordSent(record: RequestSentRecord): void;
+    static getSent(): RequestSentRecord[];
+    baseUrl(url: string): this;
+    withHeaders(headers: Record<string, string>): this;
+    withToken(token: string, type?: string): this;
+    withBasicAuth(username: string, password?: string): this;
+    accept(mimeType: string): this;
+    acceptJson(): this;
+    asJson(): this;
+    asForm(): this;
+    withQuery(query: Record<string, any>): this;
+    timeout(ms: number): this;
+    retry(times?: number, delayMs?: number): this;
+    get(url: string, query?: Record<string, any>): Promise<HttpResponse>;
+    post(url: string, data?: any): Promise<HttpResponse>;
+    put(url: string, data?: any): Promise<HttpResponse>;
+    patch(url: string, data?: any): Promise<HttpResponse>;
+    delete(url: string, data?: any): Promise<HttpResponse>;
+    head(url: string): Promise<HttpResponse>;
+    send(method: string, path: string, data?: any): Promise<HttpResponse>;
+    private findFake;
+}
+//# sourceMappingURL=request-builder.d.ts.map

package/dist/http/request-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-builder.d.ts","sourceRoot":"","sources":["../../src/http/request-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAExG,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,QAAQ,CAEd;IACF,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,aAAa,CAAO;IAC5B,OAAO,CAAC,YAAY,CAAsB;IAG1C,OAAO,CAAC,MAAM,CAAC,YAAY,CAAoD;IAC/E,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAkB;IACpD,OAAO,CAAC,MAAM,CAAC,YAAY,CAA2B;WAExC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,eAAe,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI;WAQpF,UAAU,IAAI,IAAI;WAMlB,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;WAI3C,OAAO,IAAI,iBAAiB,EAAE;IAIrC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK1B,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAKlD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAW,GAAG,IAAI;IAK/C,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,IAAI;IAMpD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAK9B,UAAU,IAAI,IAAI;IAIlB,MAAM,IAAI,IAAI;IAKd,MAAM,IAAI,IAAI;IAKd,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAK3C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKzB,KAAK,CAAC,KAAK,SAAI,EAAE,OAAO,SAAM,GAAG,IAAI;IAQrC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAKpE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IAIpD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IAInD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IAIrD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IAItD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAMlC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IA4ElF,OAAO,CAAC,QAAQ;CAWjB"}