@aryanbansal-launch/edge-utils 0.1.4 → 0.1.5

package/bin/launch-init.js

@@ -83,15 +83,15 @@ async function init() {
   console.log(`\n${colors.bright}${colors.cyan}🚀 Edge Utilities: Contentstack Launch Setup${colors.reset}\n`);
 
   let actionsTaken = 0;
-  let isRoot = true;
 
   // 1. Root level check: Look for package.json
   const packageJsonPath = path.join(process.cwd(), 'package.json');
   if (!fs.existsSync(packageJsonPath)) {
-    isRoot = false;
-    console.log(`${colors.yellow}⚠️  Warning: Root directory not detected.${colors.reset}`);
-    console.log(`${colors.yellow}   We couldn't find a package.json. If this isn't your project root,${colors.reset}`);
-    console.log(`${colors.yellow}   the 'functions' folder might be created in the wrong place.\n${colors.reset}`);
+    console.log(`${colors.red}❌ Error: Root directory not detected.${colors.reset}`);
+    console.log(`${colors.yellow}Contentstack Launch requires the 'functions' folder to be at your project root${colors.reset}`);
+    console.log(`${colors.yellow}(the same directory as your package.json).${colors.reset}\n`);
+    console.log(`Please ${colors.bright}cd${colors.reset} into your project root and try again.`);
+    process.exit(1);
   }
 
   try {
@@ -114,11 +114,7 @@ async function init() {
     }
 
     // Final Summary Messages based on the state
-    if (!isRoot) {
-      console.log(`\n${colors.yellow}⚠️  Setup detected in a subdirectory!${colors.reset}`);
-      console.log(`The 'functions' folder exists here, but Contentstack Launch`);
-      console.log(`requires it to be at the ${colors.bright}project root${colors.reset} (next to package.json).`);
-    } else if (actionsTaken === 0) {
+    if (actionsTaken === 0) {
       console.log(`\n${colors.bright}${colors.blue}🏁 Everything is already set up!${colors.reset}`);
       console.log(`No changes were made to your existing files.`);
     } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aryanbansal-launch/edge-utils",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "license": "MIT",
   "type": "module",
   "repository": {

package/readme.md

@@ -1,10 +1,9 @@
-# 🚀 Edge Utils
+# 🚀 Edge Utils for Contentstack Launch
 
 [![npm version](https://img.shields.io/npm/v/@launch/edge-utils.svg)](https://www.npmjs.com/package/@launch/edge-utils)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Platform Support](https://img.shields.io/badge/Platform-Edge-blueviolet.svg)](#platform-support)
 
-A lightweight, developer-friendly toolkit for **Edge Computing**. Speed up your development on platforms like Cloudflare Workers, Vercel Edge, and Contentstack Launch with production-ready utilities for security, authentication, and routing.
+A lightweight, high-performance toolkit specifically designed for **Contentstack Launch Edge Functions**. Speed up your development with production-ready utilities for security, authentication, routing, and Next.js compatibility—all optimized to run at the edge.
 
 ---
 
@@ -13,39 +12,35 @@ A lightweight, developer-friendly toolkit for **Edge Computing**. Speed up your
 - 🛡️ **Security First**: Block AI crawlers and manage IP access with ease.
 - 🔐 **Edge Auth**: Implement Basic Auth directly at the edge for specific hostnames.
 - 📍 **Geo-Aware**: Easily extract location data from request headers.
-- ⚛️ **Next.js Ready**: Built-in fixes for RSC header issues on edge proxies.
+- ⚛️ **Next.js Ready**: Built-in fixes for RSC header issues on Launch proxies.
 - 🔀 **Smart Routing**: Declarative redirects based on path and method.
 - ⚡ **Zero Dependencies**: Lightweight and optimized for edge runtime limits.
 
 ---
 
-## 📦 Installation
+## ⚡ Quick Start (Recommended)
 
+Set up your entire edge environment in seconds with our automated CLI tool.
+
+### 1. Install
 ```bash
-npm install @launch/edge-utils
+npm install @aryanbansal-launch/edge-utils
 ```
 
----
-
-## ⚡ Quick Start (Automatic Setup)
-
-If you are using **Contentstack Launch**, you can automatically set up your edge function directory and boilerplate handler with a single command:
-
+### 2. Initialize
+Run this command from your **project root**:
 ```bash
 npx launch-init
 ```
-
-This command will:
-1. Create a `functions/` directory in your project root.
-2. Generate a `[proxy].edge.js` file with a production-ready boilerplate.
+This will automatically create the `functions/` directory and a boilerplate `[proxy].edge.js` handler for you.
 
 ---
 
 ## 🛠️ Usage Example
 
-Transform your edge handler into a powerful middleware chain:
+Once initialized, your `functions/[proxy].edge.js` will look like a powerful middleware chain:
 
-```typescript
+```javascript
 import {
   jsonResponse,
   passThrough,
@@ -55,12 +50,12 @@ import {
   blockAICrawlers,
   getGeoHeaders,
   handleNextJS_RSC
-} from "@launch/edge-utils";
+} from "@aryanbansal-launch/edge-utils";
 
-export default async function handler(request: Request) {
+export default async function handler(request, context) {
   // 1. ⚛️ Fix Next.js RSC issues for specific paths
   const rscResponse = await handleNextJS_RSC(request, {
-    affectedPaths: ["/my-rsc-page", "/another-page"]
+    affectedPaths: ["/shop", "/about"]
   });
   if (rscResponse) return rscResponse;
 
@@ -68,11 +63,11 @@ export default async function handler(request: Request) {
   const botResponse = blockAICrawlers(request);
   if (botResponse) return botResponse;
 
-  // 2. 🧱 IP Whitelisting
+  // 3. 🧱 IP Whitelisting
   const ipResponse = ipAccessControl(request, { allow: ["203.0.113.10"] });
   if (ipResponse) return ipResponse;
 
-  // 3. 🔐 Domain-specific Basic Auth
+  // 4. 🔐 Domain-specific Basic Auth (e.g., for staging)
   const authResponse = await protectWithBasicAuth(request, {
     hostnameIncludes: "staging.myapp.com",
     username: "admin",
@@ -80,7 +75,7 @@ export default async function handler(request: Request) {
   });
   if (authResponse && authResponse.status === 401) return authResponse;
 
-  // 4. 🔀 SEO-friendly Redirects
+  // 5. 🔀 SEO-friendly Redirects
   const redirectResponse = redirectIfMatch(request, {
     path: "/legacy-url",
     to: "/modern-url",
@@ -88,16 +83,9 @@ export default async function handler(request: Request) {
   });
   if (redirectResponse) return redirectResponse;
 
-  // 5. 📍 Geo-Location Access
+  // 6. 📍 Geo-Location Access
   const geo = getGeoHeaders(request);
-  if (geo.country === "US") {
-    console.log(`User from ${geo.city}, ${geo.region}`);
-  }
-
-  // 6. 📤 Custom JSON Responses
-  if (new URL(request.url).pathname === "/api/health") {
-    return jsonResponse({ status: "healthy", region: geo.region });
-  }
+  console.log(`Request from ${geo.city}, ${geo.country}`);
 
   // 7. 🚀 Pass through to origin
   return passThrough(request);
@@ -109,78 +97,23 @@ export default async function handler(request: Request) {
 ## 📖 API Reference
 
 ### 🛡️ Security
-
-#### `blockAICrawlers`
-Blocks common AI crawlers (GPTBot, ClaudeBot, etc.) to protect your content from scraping.
-- **Parameters**: `request: Request`, `bots?: string[]` (optional list to override defaults)
-- **Returns**: `Response` (403) or `null`.
-
-#### `ipAccessControl`
-Simple firewall for your edge function.
-- **Options**:
-  - `allow`: Array of IPs allowed to access.
-  - `deny`: Array of IPs to block.
-- **Returns**: `Response` (403) or `null`.
+- **`blockAICrawlers(request, bots?)`**: Blocks common AI crawlers.
+- **`ipAccessControl(request, { allow?, deny? })`**: Simple IP-based firewall.
 
 ### 🔐 Authentication
-
-#### `protectWithBasicAuth`
-Prompt for credentials based on the hostname.
-- **Options**:
-  - `hostnameIncludes`: Match substring in hostname (e.g., ".dev").
-  - `username`: Required username.
-  - `password`: Required password.
-  - `realm`: Optional realm name for the auth prompt.
-- **Returns**: `Promise<Response>` or `null`.
+- **`protectWithBasicAuth(request, options)`**: Prompt for credentials based on hostname.
 
 ### 🔀 Redirection
-
-#### `redirectIfMatch`
-Perform redirects directly at the edge to reduce latency.
-- **Options**:
-  - `path`: The path to match.
-  - `method`: HTTP method to match (optional, defaults to any).
-  - `to`: Target path or URL.
-  - `status`: HTTP status code (default: 301).
-- **Returns**: `Response` (Redirect) or `null`.
+- **`redirectIfMatch(request, options)`**: Perform SEO-friendly redirects at the edge.
 
 ### 📍 Geo Location
-
-#### `getGeoHeaders`
-Extracts geo-information provided by edge platform headers.
-- **Returns**: Object with `country`, `region`, `city`, `latitude`, `longitude`.
+- **`getGeoHeaders(request)`**: Returns an object with `country`, `region`, `city`, `latitude`, `longitude`.
 
 ### ⚛️ Next.js
-
-#### `handleNextJS_RSC`
-Handles Next.js React Server Component (RSC) header issues on Contentstack Launch. It detects requests to "affected paths" that have the `rsc` header but lack the `_rsc` query parameter, and strips the header to prevent proxy/caching issues.
-- **Options**:
-  - `affectedPaths`: Array of pathnames (e.g., `['/shop', '/about']`) where this fix should apply.
-- **Returns**: `Promise<Response>` (the re-fetched request without RSC header) or `null`.
+- **`handleNextJS_RSC(request, { affectedPaths })`**: Resolves RSC header issues on Contentstack Launch.
 
 ---
 
 ## 🌐 Platform Support
 
-Optimized for:
-- [Contentstack Launch](https://www.contentstack.com/docs/developers/launch)
-- [Vercel Edge Functions](https://vercel.com/docs/concepts/functions/edge-functions)
-- [Cloudflare Workers](https://workers.cloudflare.com/)
-
----
-
-## 🤝 Contributing
-
-Contributions are welcome! Please feel free to submit a Pull Request.
-
-1. Fork the Project
-2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
-3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
-4. Push to the Branch (`git push origin feature/AmazingFeature`)
-5. Open a Pull Request
-
----
-
-## 📄 License
-
-Distributed under the MIT License. See `LICENSE` for more information.
+This library is exclusively optimized for **[Contentstack Launch](https://www.contentstack.com/docs/developers/launch)**.