@baziapi/sdk 1.0.0

package/README.md

@@ -0,0 +1,895 @@
+# @baziapi/sdk
+
+[![npm version](https://badge.fury.io/js/%40baziapi%2Fsdk.svg)](https://www.npmjs.com/package/@baziapi/sdk)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue)](https://www.typescriptlang.org/)
+
+**Official TypeScript SDK for the BaZi API.**
+
+Calculate [BaZi (Four Pillars of Destiny)](https://en.wikipedia.org/wiki/Four_Pillars_of_Destiny) with a type-safe, framework-agnostic client that works in Node.js, Bun, Deno, the browser, and Edge runtimes.
+
+---
+
+## Installation
+
+```bash
+# npm
+npm install @baziapi/sdk
+
+# pnpm
+pnpm add @baziapi/sdk
+
+# yarn
+yarn add @baziapi/sdk
+
+# bun
+bun add @baziapi/sdk
+```
+
+> **Node.js**: Requires Node ≥ 18.0.0 (native fetch). For Node < 18, add a `fetch` polyfill (e.g. `node-fetch`).
+
+---
+
+## Quick Start
+
+```typescript
+import { BaziClient } from '@baziapi/sdk';
+
+const client = new BaziClient({ apiKey: 'bazi_xxxx' });
+
+const result = await client.bazi.calculate({
+  birthDate: '1998-08-12', // Format: YYYY-MM-DD (Year-Month-Day)
+  birthTime: '10:30', // Format: HH:mm (24-hour clock)
+  gender: 'male',
+  timezone: 'Asia/Dhaka',
+  language: 'en',
+});
+
+console.log(result.pillars);
+// { yearPillar: '戊寅', monthPillar: '庚申', dayPillar: '庚申', hourPillar: '戊午' }
+
+console.log(result.analysis?.dayMasterStrength); // 'Strong' | 'Weak'
+console.log(result.luckPillars?.pillars); // 10-year luck cycles
+```
+
+---
+
+## Client Configuration
+
+```typescript
+const client = new BaziClient({
+  apiKey: 'bazi_xxxx', // Your BaZi API key
+  baseUrl: 'https://api.bazi.dev', // API base URL (default: production)
+  timeout: 10_000, // Request timeout in ms (default: 10s)
+  retries: 3, // Retry attempts for transient errors (default: 3)
+  retryDelay: 500, // Base retry delay in ms, exponential (default: 500ms)
+  onError: (err) => console.error(err), // Optional error callback for monitoring
+});
+```
+
+---
+
+## API Reference
+
+### `client.bazi`
+
+| Method             | Description                                    |
+| ------------------ | ---------------------------------------------- |
+| `calculate(input)` | Calculate BaZi for a given birth date and time |
+
+## Error Handling
+
+All SDK errors extend `BaziError`. Use `instanceof` checks for precise handling.
+
+```typescript
+import { BaziClient, ApiError, ValidationError, TimeoutError, NetworkError } from '@baziapi/sdk';
+
+try {
+  const result = await client.bazi.calculate({ ... });
+} catch (error) {
+  if (error instanceof ValidationError) {
+    // Input failed client-side validation — no network request was made
+    console.error(`Field '${error.field}': ${error.message}`);
+  } else if (error instanceof ApiError) {
+    // Server returned a non-2xx response
+    console.error(`HTTP ${error.statusCode}: ${error.message}`);
+    console.error('Request ID:', error.requestId);
+    console.error('Server errors:', error.errors);
+  } else if (error instanceof TimeoutError) {
+    console.error(`Timed out after ${error.timeoutMs}ms`);
+  } else if (error instanceof NetworkError) {
+    console.error('No network connection:', error.cause);
+  }
+}
+```
+
+---
+
+## Retry Behaviour
+
+The SDK automatically retries on transient failures using exponential backoff.
+
+| Condition                     | Retried?                               |
+| ----------------------------- | -------------------------------------- |
+| Network failure (no internet) | ✅ Yes                                 |
+| `429 Too Many Requests`       | ✅ Yes (respects `Retry-After` header) |
+| `500 / 502 / 503 / 504`       | ✅ Yes                                 |
+| `400 Bad Request`             | ❌ No                                  |
+| `401 Unauthorized`            | ❌ No                                  |
+| `403 Forbidden`               | ❌ No                                  |
+| `404 Not Found`               | ❌ No                                  |
+| `409 Conflict`                | ❌ No                                  |
+| `422 Unprocessable Entity`    | ❌ No                                  |
+
+Backoff formula: `retryDelay * 2^attemptIndex`
+
+Default: up to **3 retries** with **500ms base delay** (max ~3.5s total wait).
+
+---
+
+## TypeScript Support
+
+The SDK ships with full TypeScript declarations. All types are derived directly from the backend source of truth.
+
+```typescript
+import type {
+  BaziCalculateRequest,
+  BaziCalculateResponse,
+  FourPillars,
+  Analysis,
+  LuckPillars,
+} from '@baziapi/sdk';
+```
+
+---
+
+## Runtime Compatibility
+
+| Runtime      | Version    | Notes                           |
+| ------------ | ---------- | ------------------------------- |
+| Node.js      | ≥ 18.0.0   | Native fetch available          |
+| Bun          | ≥ 1.0.0    | Fully supported                 |
+| Deno         | ≥ 1.28.0   | `npm:@baziapi/sdk`              |
+| Browser      | Chrome 90+ | Via CDN or bundler              |
+| Edge Runtime | Latest     | Cloudflare Workers, Vercel Edge |
+
+---
+
+## Browser / CDN Usage
+
+```html
+<script type="module">
+  import { BaziClient } from 'https://cdn.jsdelivr.net/npm/@baziapi/sdk/dist/index.mjs';
+
+  const client = new BaziClient({ apiKey: 'bazi_xxxx' });
+  const result = await client.bazi.calculate({
+    birthDate: '1998-08-12',
+    gender: 'male',
+  });
+</script>
+```
+
+> **⚠️ Security:** Never expose API keys in client-side browser code in production.
+> Use a backend proxy to make BaZi API calls on behalf of users.
+
+For CSP-compliant usage, add the API domain to your `connect-src` directive:
+
+```
+Content-Security-Policy: connect-src 'self' https://api.bazi.dev;
+```
+
+---
+
+## Examples
+
+- [`examples/node-esm/`](./examples/node-esm/) — Node.js ESM
+- [`examples/node-cjs/`](./examples/node-cjs/) — Node.js CommonJS
+- [`examples/bun/`](./examples/bun/) — Bun
+- [`examples/next-js/`](./examples/next-js/) — Next.js App Router (Server Component)
+- [`examples/browser/`](./examples/browser/) — Browser / CDN
+
+---
+
+## Integration Guide
+
+The SDK works across every major JavaScript runtime and framework. Pick your platform below.
+
+---
+
+### 🟢 Node.js
+
+**Install:**
+
+```bash
+npm install @baziapi/sdk
+```
+
+**ESM (recommended):**
+
+```typescript
+// index.mjs
+import { BaziClient } from '@baziapi/sdk';
+
+const client = new BaziClient({ apiKey: process.env.BAZI_API_KEY! });
+
+const result = await client.bazi.calculate({
+  birthDate: '1998-08-12',
+  birthTime: '10:30',
+  gender: 'male',
+  timezone: 'Asia/Dhaka',
+  language: 'en',
+});
+
+console.log(result.pillars);
+```
+
+**CommonJS:**
+
+```javascript
+// index.cjs
+const { BaziClient } = require('@baziapi/sdk');
+
+const client = new BaziClient({ apiKey: process.env.BAZI_API_KEY });
+
+client.bazi
+  .calculate({
+    birthDate: '1998-08-12',
+    birthTime: '10:30',
+    gender: 'male',
+    timezone: 'Asia/Dhaka',
+  })
+  .then((result) => console.log(result.pillars));
+```
+
+> Requires **Node.js ≥ 18.0.0** (native `fetch`). For older Node, install a fetch polyfill like `node-fetch`.
+
+---
+
+### 🟣 Bun
+
+**Install:**
+
+```bash
+bun add @baziapi/sdk
+```
+
+```typescript
+// index.ts
+import { BaziClient } from '@baziapi/sdk';
+
+const client = new BaziClient({
+  apiKey: Bun.env.BAZI_API_KEY ?? '',
+});
+
+const result = await client.bazi.calculate({
+  birthDate: '1998-08-12',
+  birthTime: '10:30',
+  gender: 'male',
+  timezone: 'Asia/Dhaka',
+  language: 'en',
+});
+
+console.log(result.pillars);
+```
+
+```bash
+bun run index.ts
+```
+
+---
+
+### 🦕 Deno
+
+No install needed — import directly via npm specifier:
+
+```typescript
+// main.ts
+import { BaziClient } from 'npm:@baziapi/sdk';
+
+const client = new BaziClient({
+  apiKey: Deno.env.get('BAZI_API_KEY') ?? '',
+});
+
+const result = await client.bazi.calculate({
+  birthDate: '1998-08-12',
+  birthTime: '10:30',
+  gender: 'male',
+  timezone: 'Asia/Dhaka',
+  language: 'en',
+});
+
+console.log(result.pillars);
+```
+
+```bash
+deno run --allow-net --allow-env main.ts
+```
+
+---
+
+### ▲ Next.js (App Router)
+
+**Install:**
+
+```bash
+npm install @baziapi/sdk
+```
+
+**Server Component** (recommended — API key is safe):
+
+```typescript
+// app/bazi/page.tsx
+import { BaziClient } from '@baziapi/sdk';
+
+const client = new BaziClient({ apiKey: process.env.BAZI_API_KEY! });
+
+export default async function BaziPage() {
+  const result = await client.bazi.calculate({
+    birthDate: '1998-08-12',
+    birthTime: '10:30',
+    gender: 'male',
+    timezone: 'Asia/Dhaka',
+    language: 'en',
+  });
+
+  return (
+    <main>
+      <h1>BaZi Chart</h1>
+      <pre>{JSON.stringify(result.pillars, null, 2)}</pre>
+    </main>
+  );
+}
+```
+
+**API Route** (for client-side fetch):
+
+```typescript
+// app/api/bazi/route.ts
+import { BaziClient } from '@baziapi/sdk';
+import { NextRequest, NextResponse } from 'next/server';
+
+const client = new BaziClient({ apiKey: process.env.BAZI_API_KEY! });
+
+export async function POST(req: NextRequest) {
+  const body = await req.json();
+
+  const result = await client.bazi.calculate({
+    birthDate: body.birthDate,
+    birthTime: body.birthTime,
+    gender: body.gender,
+    timezone: body.timezone ?? 'Asia/Shanghai',
+    language: body.language ?? 'en',
+  });
+
+  return NextResponse.json(result);
+}
+```
+
+**`.env.local`:**
+
+```
+BAZI_API_KEY=bazi_xxxx
+```
+
+---
+
+### 💿 Remix
+
+```typescript
+// app/routes/bazi.tsx
+import { json, type LoaderFunctionArgs } from '@remix-run/node';
+import { useLoaderData } from '@remix-run/react';
+import { BaziClient } from '@baziapi/sdk';
+
+const client = new BaziClient({ apiKey: process.env.BAZI_API_KEY! });
+
+export async function loader({ request }: LoaderFunctionArgs) {
+  const result = await client.bazi.calculate({
+    birthDate: '1998-08-12',
+    birthTime: '10:30',
+    gender: 'male',
+    timezone: 'Asia/Dhaka',
+    language: 'en',
+  });
+
+  return json(result);
+}
+
+export default function BaziRoute() {
+  const data = useLoaderData<typeof loader>();
+  return <pre>{JSON.stringify(data.pillars, null, 2)}</pre>;
+}
+```
+
+---
+
+### 🚀 Astro
+
+```typescript
+// src/pages/api/bazi.ts
+import type { APIRoute } from 'astro';
+import { BaziClient } from '@baziapi/sdk';
+
+const client = new BaziClient({ apiKey: import.meta.env.BAZI_API_KEY });
+
+export const POST: APIRoute = async ({ request }) => {
+  const body = await request.json();
+
+  const result = await client.bazi.calculate({
+    birthDate: body.birthDate,
+    birthTime: body.birthTime,
+    gender: body.gender,
+    timezone: body.timezone ?? 'Asia/Shanghai',
+    language: body.language ?? 'en',
+  });
+
+  return new Response(JSON.stringify(result), {
+    headers: { 'Content-Type': 'application/json' },
+  });
+};
+```
+
+**`astro.config.mjs`** — enable SSR:
+
+```js
+export default defineConfig({ output: 'server' });
+```
+
+---
+
+### 🔥 SvelteKit
+
+```typescript
+// src/routes/api/bazi/+server.ts
+import { json } from '@sveltejs/kit';
+import { BaziClient } from '@baziapi/sdk';
+import { BAZI_API_KEY } from '$env/static/private';
+
+const client = new BaziClient({ apiKey: BAZI_API_KEY });
+
+export async function POST({ request }) {
+  const body = await request.json();
+
+  const result = await client.bazi.calculate({
+    birthDate: body.birthDate,
+    birthTime: body.birthTime,
+    gender: body.gender,
+    timezone: body.timezone ?? 'Asia/Shanghai',
+    language: body.language ?? 'en',
+  });
+
+  return json(result);
+}
+```
+
+---
+
+### 🐈 NestJS
+
+**Install:**
+
+```bash
+npm install @baziapi/sdk
+```
+
+**Service:**
+
+```typescript
+// bazi/bazi.service.ts
+import { Injectable } from '@nestjs/common';
+import { BaziClient } from '@baziapi/sdk';
+import { ConfigService } from '@nestjs/config';
+
+@Injectable()
+export class BaziService {
+  private readonly client: BaziClient;
+
+  constructor(private readonly config: ConfigService) {
+    this.client = new BaziClient({
+      apiKey: this.config.get<string>('BAZI_API_KEY')!,
+    });
+  }
+
+  async calculate(birthDate: string, birthTime: string, gender: 'male' | 'female') {
+    return this.client.bazi.calculate({ birthDate, birthTime, gender });
+  }
+}
+```
+
+**Controller:**
+
+```typescript
+// bazi/bazi.controller.ts
+import { Controller, Post, Body } from '@nestjs/common';
+import { BaziService } from './bazi.service';
+
+@Controller('bazi')
+export class BaziController {
+  constructor(private readonly baziService: BaziService) {}
+
+  @Post('calculate')
+  calculate(@Body() body: { birthDate: string; birthTime: string; gender: 'male' | 'female' }) {
+    return this.baziService.calculate(body.birthDate, body.birthTime, body.gender);
+  }
+}
+```
+
+---
+
+### ⚡ Express / Fastify
+
+**Express:**
+
+```typescript
+import express from 'express';
+import { BaziClient } from '@baziapi/sdk';
+
+const app = express();
+app.use(express.json());
+
+const client = new BaziClient({ apiKey: process.env.BAZI_API_KEY! });
+
+app.post('/bazi/calculate', async (req, res) => {
+  const result = await client.bazi.calculate(req.body);
+  res.json(result);
+});
+
+app.listen(3000);
+```
+
+**Fastify:**
+
+```typescript
+import Fastify from 'fastify';
+import { BaziClient } from '@baziapi/sdk';
+
+const app = Fastify();
+const client = new BaziClient({ apiKey: process.env.BAZI_API_KEY! });
+
+app.post('/bazi/calculate', async (request) => {
+  return client.bazi.calculate(request.body as any);
+});
+
+app.listen({ port: 3000 });
+```
+
+---
+
+### ▲ Vercel Functions
+
+```typescript
+// api/bazi.ts
+import type { VercelRequest, VercelResponse } from '@vercel/node';
+import { BaziClient } from '@baziapi/sdk';
+
+const client = new BaziClient({ apiKey: process.env.BAZI_API_KEY! });
+
+export default async function handler(req: VercelRequest, res: VercelResponse) {
+  if (req.method !== 'POST') return res.status(405).json({ error: 'Method Not Allowed' });
+
+  const result = await client.bazi.calculate(req.body);
+  res.json(result);
+}
+```
+
+**`vercel.json`:**
+
+```json
+{
+  "functions": {
+    "api/bazi.ts": { "memory": 256, "maxDuration": 10 }
+  }
+}
+```
+
+---
+
+### 🌐 Netlify Functions
+
+```typescript
+// netlify/functions/bazi.ts
+import type { Handler } from '@netlify/functions';
+import { BaziClient } from '@baziapi/sdk';
+
+const client = new BaziClient({ apiKey: process.env.BAZI_API_KEY! });
+
+export const handler: Handler = async (event) => {
+  if (event.httpMethod !== 'POST') {
+    return { statusCode: 405, body: 'Method Not Allowed' };
+  }
+
+  const body = JSON.parse(event.body ?? '{}');
+  const result = await client.bazi.calculate(body);
+
+  return {
+    statusCode: 200,
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(result),
+  };
+};
+```
+
+---
+
+### ☁️ Cloudflare Workers
+
+```typescript
+// src/index.ts
+import { BaziClient } from '@baziapi/sdk';
+
+export interface Env {
+  BAZI_API_KEY: string;
+}
+
+export default {
+  async fetch(request: Request, env: Env): Promise<Response> {
+    if (request.method !== 'POST') {
+      return new Response('Method Not Allowed', { status: 405 });
+    }
+
+    const client = new BaziClient({ apiKey: env.BAZI_API_KEY });
+    const body = await request.json<any>();
+    const result = await client.bazi.calculate(body);
+
+    return new Response(JSON.stringify(result), {
+      headers: { 'Content-Type': 'application/json' },
+    });
+  },
+};
+```
+
+**`wrangler.toml`:**
+
+```toml
+name = "bazi-worker"
+main = "src/index.ts"
+compatibility_date = "2024-01-01"
+
+[vars]
+BAZI_API_KEY = "bazi_xxxx"
+```
+
+---
+
+### 🟡 AWS Lambda (Node.js)
+
+```typescript
+// handler.ts
+import { APIGatewayProxyHandler } from 'aws-lambda';
+import { BaziClient } from '@baziapi/sdk';
+
+const client = new BaziClient({ apiKey: process.env.BAZI_API_KEY! });
+
+export const calculate: APIGatewayProxyHandler = async (event) => {
+  const body = JSON.parse(event.body ?? '{}');
+  const result = await client.bazi.calculate(body);
+
+  return {
+    statusCode: 200,
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(result),
+  };
+};
+```
+
+**`serverless.yml`:**
+
+```yaml
+functions:
+  calculate:
+    handler: handler.calculate
+    events:
+      - httpApi:
+          path: /bazi/calculate
+          method: post
+    environment:
+      BAZI_API_KEY: ${env:BAZI_API_KEY}
+```
+
+---
+
+### 🔀 No-Code & Automation Platforms
+
+> These platforms consume the BaZi API via **HTTP requests** — no npm install required.
+> For platforms that support JavaScript code nodes, you can also install and use the SDK directly.
+
+#### n8n
+
+**Option A — HTTP Request Node** (simplest):
+
+| Field              | Value                                           |
+| ------------------ | ----------------------------------------------- |
+| **Method**         | `POST`                                          |
+| **URL**            | `https://api.bazi.dev/api/v1/bazi/calculate`    |
+| **Authentication** | Header Auth → `Authorization: Bearer bazi_xxxx` |
+| **Content-Type**   | `application/json`                              |
+
+**Body:**
+
+```json
+{
+  "birthDate": "{{ $json.birthDate }}",
+  "birthTime": "{{ $json.birthTime }}",
+  "gender": "{{ $json.gender }}",
+  "timezone": "Asia/Dhaka",
+  "language": "en"
+}
+```
+
+**Option B — Code Node** (full SDK, dynamic logic):
+
+```javascript
+// n8n Code Node (Node.js mode)
+const { BaziClient } = require('@baziapi/sdk');
+
+const client = new BaziClient({ apiKey: $env.BAZI_API_KEY });
+
+const result = await client.bazi.calculate({
+  birthDate: $input.first().json.birthDate,
+  birthTime: $input.first().json.birthTime,
+  gender: $input.first().json.gender,
+  timezone: 'Asia/Dhaka',
+  language: 'en',
+});
+
+return [{ json: result }];
+```
+
+---
+
+#### Zapier
+
+**Option A — Webhooks by Zapier → POST**:
+
+| Field            | Value                                        |
+| ---------------- | -------------------------------------------- |
+| **URL**          | `https://api.bazi.dev/api/v1/bazi/calculate` |
+| **Payload Type** | `JSON`                                       |
+| **Headers**      | `Authorization: Bearer bazi_xxxx`            |
+
+**Data:**
+
+```json
+{
+  "birthDate": "1998-08-12",
+  "birthTime": "10:30",
+  "gender": "male",
+  "timezone": "Asia/Dhaka",
+  "language": "en"
+}
+```
+
+**Option B — Code by Zapier** (Node.js, full SDK):
+
+```javascript
+const { BaziClient } = require('@baziapi/sdk');
+
+const client = new BaziClient({ apiKey: process.env.BAZI_API_KEY });
+
+const result = await client.bazi.calculate({
+  birthDate: inputData.birthDate,
+  birthTime: inputData.birthTime,
+  gender: inputData.gender,
+  timezone: 'Asia/Dhaka',
+  language: 'en',
+});
+
+output = { result };
+```
+
+---
+
+#### Pipedream
+
+Pipedream runs Node.js natively — install and use the SDK directly:
+
+```javascript
+// Pipedream Step (Node.js)
+import { BaziClient } from '@baziapi/sdk';
+
+export default defineComponent({
+  props: {
+    bazi_api_key: { type: 'string', secret: true },
+  },
+  async run({ steps, $ }) {
+    const client = new BaziClient({ apiKey: this.bazi_api_key });
+
+    const result = await client.bazi.calculate({
+      birthDate: steps.trigger.event.birthDate,
+      birthTime: steps.trigger.event.birthTime,
+      gender: steps.trigger.event.gender,
+      timezone: 'Asia/Dhaka',
+      language: 'en',
+    });
+
+    return result;
+  },
+});
+```
+
+---
+
+#### Make (Integromat)
+
+Use **HTTP → Make a request** module:
+
+| Field         | Value                                        |
+| ------------- | -------------------------------------------- |
+| **URL**       | `https://api.bazi.dev/api/v1/bazi/calculate` |
+| **Method**    | `POST`                                       |
+| **Headers**   | `Authorization: Bearer bazi_xxxx`            |
+| **Body type** | `Raw` → `application/json`                   |
+
+**Body:**
+
+```json
+{
+  "birthDate": "{{birthDate}}",
+  "birthTime": "{{birthTime}}",
+  "gender": "{{gender}}",
+  "timezone": "Asia/Dhaka",
+  "language": "en"
+}
+```
+
+---
+
+#### cURL (Testing / CI)
+
+```bash
+curl -X POST https://api.bazi.dev/api/v1/bazi/calculate \
+  -H "Authorization: Bearer bazi_xxxx" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "birthDate": "1998-08-12",
+    "birthTime": "10:30",
+    "gender": "male",
+    "timezone": "Asia/Dhaka",
+    "language": "en"
+  }'
+```
+
+---
+
+## Pricing & API Keys
+
+To use this SDK in production, you need an active API Key from our platform. We offer flexible plans tailored to your business needs.
+
+> All plans include access to the full BaZi calculation API. Yearly plans save up to **21%**.
+
+### Monthly Plans
+
+| Feature          |     🆓 Free      |   🚀 Basic    |    ⚡ Pro     |   💎 Premium    |
+| ---------------- | :--------------: | :-----------: | :-----------: | :-------------: |
+| **Target**       | Developer / Test |   Indie Dev   |    Startup    |   Enterprise    |
+| **Price**        |     $0 / mo      |   $19 / mo    |   $49 / mo    |    $149 / mo    |
+| **Rate Limit**   |   30 req / min   | 300 req / min | 500 req / min | 1,000 req / min |
+| **API Keys**     |        1         |       3       |      10       |    Unlimited    |
+| **14-Day Trial** |        ✅        |      ❌       |      ❌       |       ❌        |
+
+### Yearly Plans _(Save up to 21%)_
+
+| Feature                |   🆓 Free    |   🚀 Basic    |    ⚡ Pro     |   💎 Premium    |
+| ---------------------- | :----------: | :-----------: | :-----------: | :-------------: |
+| **Price**              |      $0      |   $15 / mo    |   $39 / mo    |    $119 / mo    |
+| **Billed Annually**    |      —       |   $180 / yr   |   $468 / yr   |   $1,428 / yr   |
+| **Savings vs Monthly** |      —       |   ~21% off    |   ~20% off    |    ~20% off     |
+| **Rate Limit**         | 30 req / min | 300 req / min | 500 req / min | 1,000 req / min |
+| **API Keys**           |      1       |       3       |      10       |    Unlimited    |
+
+> 💡 **Need more?** Contact us for custom enterprise plans with higher rate limits and dedicated support.
+
+👉 **[Get your API Key & View Details here](https://your-saas-website.com/pricing)** _(update this link)_
+
+---
+
+## Support
+
+- **Email:** support@your-saas-website.com _(update this email)_
+- **Documentation:** [https://docs.your-saas-website.com](https://docs.your-saas-website.com) _(update this link)_
+
+---
+
+## License
+
+MIT © [Md. Nasir Uddin Shoyas](https://github.com/shoyas)