@aryanbansal-launch/edge-utils 0.1.11 → 0.1.12

package/bin/launch-config.js

@@ -66,19 +66,64 @@ async function run() {
   }
 
   // 1. Redirects
-  while (true) {
-    const addRedirect = await question(`Do you want to add a Redirect?${config.redirects.length > 0 ? ' another?' : ''} (y/n): `);
-    if (addRedirect.toLowerCase() !== 'y') break;
-    
-    const source = await question('   Source path (e.g., /source): ');
-    const destination = await question('   Destination path (e.g., /destination): ');
-    const code = await question('   Status code (default 308): ');
-    config.redirects.push({
-      source,
-      destination,
-      statusCode: parseInt(code) || 308
-    });
-    console.log(`${colors.green}   ✔ Redirect added.${colors.reset}`);
+  const redirectMode = await question(`How would you like to add redirects?\n   1) One by one (interactive)\n   2) Bulk import from CSV file\n   3) Bulk import from JSON file\n   4) Skip\nChoose (1-4): `);
+  
+  if (redirectMode === '1') {
+    // Interactive mode
+    while (true) {
+      const addRedirect = await question(`Do you want to add a Redirect?${config.redirects.length > 0 ? ' another?' : ''} (y/n): `);
+      if (addRedirect.toLowerCase() !== 'y') break;
+      
+      const source = await question('   Source path (e.g., /source): ');
+      const destination = await question('   Destination path (e.g., /destination): ');
+      const code = await question('   Status code (default 308): ');
+      config.redirects.push({
+        source,
+        destination,
+        statusCode: parseInt(code) || 308
+      });
+      console.log(`${colors.green}   ✔ Redirect added.${colors.reset}`);
+    }
+  } else if (redirectMode === '2') {
+    // CSV import
+    const csvPath = await question('   Enter CSV file path (e.g., ./redirects.csv): ');
+    try {
+      const csvContent = fs.readFileSync(path.resolve(csvPath), 'utf-8');
+      const lines = csvContent.split('\n').filter(line => line.trim());
+      
+      // Skip header if present
+      const startIndex = lines[0].toLowerCase().includes('source') ? 1 : 0;
+      
+      for (let i = startIndex; i < lines.length; i++) {
+        const [source, destination, statusCode] = lines[i].split(',').map(s => s.trim());
+        if (source && destination) {
+          config.redirects.push({
+            source,
+            destination,
+            statusCode: parseInt(statusCode) || 308
+          });
+        }
+      }
+      console.log(`${colors.green}   ✔ Imported ${lines.length - startIndex} redirects from CSV.${colors.reset}`);
+    } catch (error) {
+      console.log(`${colors.red}   ✖ Error reading CSV file: ${error.message}${colors.reset}`);
+    }
+  } else if (redirectMode === '3') {
+    // JSON import
+    const jsonPath = await question('   Enter JSON file path (e.g., ./redirects.json): ');
+    try {
+      const jsonContent = fs.readFileSync(path.resolve(jsonPath), 'utf-8');
+      const redirects = JSON.parse(jsonContent);
+      
+      if (Array.isArray(redirects)) {
+        config.redirects.push(...redirects);
+        console.log(`${colors.green}   ✔ Imported ${redirects.length} redirects from JSON.${colors.reset}`);
+      } else {
+        console.log(`${colors.red}   ✖ JSON file must contain an array of redirect objects.${colors.reset}`);
+      }
+    } catch (error) {
+      console.log(`${colors.red}   ✖ Error reading JSON file: ${error.message}${colors.reset}`);
+    }
   }
 
   // 2. Rewrites

package/bin/launch-help.js

@@ -175,6 +175,7 @@ ${colors.dim}──────────────────────
   ${colors.cyan}npx launch-config${colors.reset}
     Interactive CLI to manage launch.json
     Configure: redirects, rewrites, cache priming
+    Supports bulk import from CSV/JSON files
 
   ${colors.cyan}npx launch-help${colors.reset}
     Display this help guide

package/examples/redirects.csv

@@ -0,0 +1,12 @@
+source,destination,statusCode
+/old-blog/post-1,/blog/post-1,301
+/old-blog/post-2,/blog/post-2,301
+/old-blog/post-3,/blog/post-3,301
+/products/old-sku-123,/products/new-sku-456,308
+/products/old-sku-789,/products/new-sku-101,308
+/legacy/about,/about,301
+/legacy/contact,/contact,301
+/legacy/pricing,/pricing,301
+/old-shop/*,/shop/*,301
+/archive/*,/blog/archive/*,301
+

package/examples/redirects.json

@@ -0,0 +1,53 @@
+[
+  {
+    "source": "/old-blog/post-1",
+    "destination": "/blog/post-1",
+    "statusCode": 301
+  },
+  {
+    "source": "/old-blog/post-2",
+    "destination": "/blog/post-2",
+    "statusCode": 301
+  },
+  {
+    "source": "/old-blog/post-3",
+    "destination": "/blog/post-3",
+    "statusCode": 301
+  },
+  {
+    "source": "/products/old-sku-123",
+    "destination": "/products/new-sku-456",
+    "statusCode": 308
+  },
+  {
+    "source": "/products/old-sku-789",
+    "destination": "/products/new-sku-101",
+    "statusCode": 308
+  },
+  {
+    "source": "/legacy/about",
+    "destination": "/about",
+    "statusCode": 301
+  },
+  {
+    "source": "/legacy/contact",
+    "destination": "/contact",
+    "statusCode": 301
+  },
+  {
+    "source": "/legacy/pricing",
+    "destination": "/pricing",
+    "statusCode": 301
+  },
+  {
+    "source": "/old-shop/*",
+    "destination": "/shop/*",
+    "statusCode": 301
+  },
+  {
+    "source": "/archive/*",
+    "destination": "/blog/archive/*",
+    "statusCode": 301
+  }
+]
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aryanbansal-launch/edge-utils",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "license": "MIT",
   "type": "module",
   "repository": {
@@ -22,7 +22,8 @@
   },
   "files": [
     "dist",
-    "bin"
+    "bin",
+    "examples"
   ],
   "scripts": {
     "build": "tsc",

package/readme.md

@@ -387,14 +387,164 @@ if (redirect) return redirect;
 - A/B testing redirects
 - Maintenance mode redirects
 
-**When to Use:**
-- **Edge Functions (this utility)**: Dynamic redirects requiring logic (cookies, headers, geo)
-- **launch.json**: Static path-to-path redirects (better performance)
-
 **Learn More:** [Edge URL Redirects](https://www.contentstack.com/docs/developers/launch/edge-url-redirects)
 
 ---
 
+### 📊 Redirects: Config vs Edge Functions
+
+Contentstack Launch offers **two ways** to handle redirects. Choose the right approach based on your needs:
+
+#### Option 1: Config-Based Redirects (`launch.json`)
+
+**Best for:** Static, predictable redirects that don't require logic
+
+**Pros:**
+- ⚡ **Faster**: No edge function execution overhead
+- 🎯 **Simpler**: Pure configuration, no code needed
+- 📦 **Bulk-friendly**: Easy to manage hundreds/thousands of redirects
+- 🔧 **Easy updates**: Use `npx launch-config` CLI with CSV/JSON import
+
+**Cons:**
+- ❌ No dynamic logic (can't check cookies, headers, geo, etc.)
+- ❌ No conditional redirects based on request data
+- ❌ Limited to exact path or wildcard matching
+
+**Setup:**
+```bash
+# Interactive CLI
+npx launch-config
+
+# Or bulk import from CSV/JSON
+npx launch-config
+# Choose option 2 or 3 for bulk import
+```
+
+**Example `launch.json`:**
+```json
+{
+  "redirects": [
+    {
+      "source": "/old-blog/:slug",
+      "destination": "/blog/:slug",
+      "statusCode": 301
+    },
+    {
+      "source": "/products/old-*",
+      "destination": "/products/new-*",
+      "statusCode": 308
+    }
+  ]
+}
+```
+
+**When to use:**
+- ✅ SEO migrations with hundreds of URL changes
+- ✅ Simple path rewrites (e.g., `/old-path` → `/new-path`)
+- ✅ Bulk product SKU redirects
+- ✅ Static site restructuring
+- ✅ Predictable, rule-based redirects
+
+---
+
+#### Option 2: Edge Function Redirects (This Package)
+
+**Best for:** Dynamic redirects requiring logic or request inspection
+
+**Pros:**
+- 🧠 **Smart**: Access cookies, headers, geo-location, user-agent
+- 🎨 **Flexible**: Complex conditional logic
+- 🔄 **Dynamic**: Redirect based on A/B tests, feature flags, user data
+- 🌍 **Contextual**: Different redirects per country/region
+
+**Cons:**
+- 🐌 Slightly slower (edge function execution)
+- 🔧 Requires code changes
+- 📝 More complex for simple redirects
+
+**Setup:**
+```javascript
+import { redirectIfMatch } from '@aryanbansal-launch/edge-utils';
+
+export default async function handler(request) {
+  // Dynamic redirect based on cookie
+  const cookie = request.headers.get('cookie');
+  if (cookie?.includes('beta=true')) {
+    return Response.redirect(new URL('/beta-features', request.url), 302);
+  }
+
+  // Geo-based redirect
+  const country = request.headers.get('x-cs-country');
+  if (country === 'FR') {
+    return Response.redirect('https://fr.mysite.com', 302);
+  }
+
+  // Conditional redirect
+  const redirect = redirectIfMatch(request, {
+    path: "/old-page",
+    to: "/new-page",
+    method: "GET",
+    status: 301
+  });
+  if (redirect) return redirect;
+
+  return passThrough(request);
+}
+```
+
+**When to use:**
+- ✅ Geo-location based redirects
+- ✅ A/B testing redirects
+- ✅ Cookie/session-based routing
+- ✅ User-agent specific redirects (mobile vs desktop)
+- ✅ Feature flag redirects
+- ✅ Maintenance mode with exceptions
+- ✅ Complex conditional logic
+
+---
+
+#### Quick Decision Guide
+
+| Scenario | Use Config | Use Edge Function |
+|----------|-----------|-------------------|
+| 500+ simple URL redirects | ✅ | ❌ |
+| SEO migration from old site | ✅ | ❌ |
+| Redirect based on country | ❌ | ✅ |
+| A/B test routing | ❌ | ✅ |
+| Cookie-based redirects | ❌ | ✅ |
+| Mobile vs desktop routing | ❌ | ✅ |
+| Simple path changes | ✅ | ❌ |
+| Maintenance mode (all users) | ✅ | ❌ |
+| Maintenance mode (except admins) | ❌ | ✅ |
+| Bulk product SKU changes | ✅ | ❌ |
+
+**💡 Pro Tip:** You can use **both** approaches together! Use `launch.json` for bulk static redirects and edge functions for dynamic logic.
+
+**Example Combined Approach:**
+```javascript
+// launch.json - handles 1000+ static SEO redirects
+{
+  "redirects": [
+    { "source": "/old-blog/:slug", "destination": "/blog/:slug", "statusCode": 301 }
+    // ... 1000 more redirects
+  ]
+}
+
+// functions/[proxy].edge.js - handles dynamic logic
+export default async function handler(request) {
+  // Geo-based redirect (dynamic)
+  const country = request.headers.get('x-cs-country');
+  if (country === 'FR') {
+    return Response.redirect('https://fr.mysite.com', 302);
+  }
+
+  // Static redirects handled by launch.json automatically
+  return passThrough(request);
+}
+```
+
+---
+
 ### ⚛️ Next.js Optimization
 
 #### `handleNextJS_RSC(request, options)`
@@ -808,10 +958,10 @@ Next Steps:
 
 ### `npx launch-config`
 
-Interactive CLI to manage `launch.json` configuration.
+Interactive CLI to manage `launch.json` configuration with support for bulk imports.
 
 **What it does:**
-- Add/manage redirects
+- Add/manage redirects (one-by-one or bulk import)
 - Configure rewrites
 - Set up cache priming URLs
 - Preserves existing configuration
@@ -825,13 +975,14 @@ npx launch-config
 ```
 🚀 Launch Configuration Generator
 
-Do you want to add a Redirect? (y/n): y
-   Source path (e.g., /source): /old-page
-   Destination path (e.g., /destination): /new-page
-   Status code (default 308): 301
-   ✔ Redirect added.
-
-Do you want to add a Redirect? another? (y/n): n
+How would you like to add redirects?
+   1) One by one (interactive)
+   2) Bulk import from CSV file
+   3) Bulk import from JSON file
+   4) Skip
+Choose (1-4): 2
+   Enter CSV file path (e.g., ./redirects.csv): ./redirects.csv
+   ✔ Imported 150 redirects from CSV.
 
 Do you want to add a Rewrite? (y/n): y
    Source path (e.g., /api/*): /api/*
@@ -845,6 +996,47 @@ Enter URLs separated by commas (e.g., /home,/about,/shop): /,/about,/products
 ✅ Successfully updated launch.json!
 ```
 
+#### Bulk Import Formats
+
+**CSV Format** (`redirects.csv`):
+```csv
+source,destination,statusCode
+/old-blog/post-1,/blog/post-1,301
+/old-blog/post-2,/blog/post-2,301
+/products/old-sku-123,/products/new-sku-456,308
+/legacy/*,/new/*,301
+```
+
+**JSON Format** (`redirects.json`):
+```json
+[
+  {
+    "source": "/old-blog/post-1",
+    "destination": "/blog/post-1",
+    "statusCode": 301
+  },
+  {
+    "source": "/old-blog/post-2",
+    "destination": "/blog/post-2",
+    "statusCode": 301
+  },
+  {
+    "source": "/products/old-sku-123",
+    "destination": "/products/new-sku-456",
+    "statusCode": 308
+  }
+]
+```
+
+**Use Cases for Bulk Import:**
+- Migrating from another platform with hundreds of URLs
+- SEO redirects from spreadsheet/database exports
+- Bulk product SKU changes
+- Content restructuring with many path changes
+
+**Example Files:**
+See `examples/redirects.csv` and `examples/redirects.json` in this package for ready-to-use templates.
+
 **Learn More:**
 - [Static Redirects](https://www.contentstack.com/docs/developers/launch/edge-url-redirects)
 - [Cache Priming](https://www.contentstack.com/docs/developers/launch/cache-priming)