@aryanbansal-launch/edge-utils 0.1.10 → 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

@@ -0,0 +1,192 @@
+#!/usr/bin/env node
+
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+  dim: '\x1b[2m'
+};
+
+console.log(`
+${colors.bright}${colors.cyan}╔════════════════════════════════════════════════════════════════════╗
+║     🚀 Launch Edge Utils - Complete Reference Guide              ║
+╚════════════════════════════════════════════════════════════════════╝${colors.reset}
+
+${colors.bright}${colors.yellow}📦 AVAILABLE METHODS${colors.reset}
+${colors.dim}────────────────────────────────────────────────────────────────────${colors.reset}
+
+${colors.bright}${colors.green}1. Security & Access Control${colors.reset}
+
+  ${colors.cyan}blockAICrawlers(request, bots?)${colors.reset}
+    Block AI crawlers and bots from accessing your site
+    ${colors.dim}Parameters:${colors.reset}
+      - request: Request object
+      - bots: string[] (optional) - Custom bot list
+    ${colors.dim}Default Blocked Bots:${colors.reset}
+      claudebot, gptbot, googlebot, bingbot, ahrefsbot,
+      yandexbot, semrushbot, mj12bot, facebookexternalhit, twitterbot
+    ${colors.dim}Returns:${colors.reset} Response | null
+    ${colors.dim}Example:${colors.reset}
+      const response = blockAICrawlers(request);
+      if (response) return response;
+
+  ${colors.cyan}blockDefaultDomains(request, options?)${colors.reset}
+    Block access via default Launch domains (*.contentstackapps.com)
+    ${colors.dim}Parameters:${colors.reset}
+      - request: Request object
+      - options: { domainToBlock?: string }
+    ${colors.dim}Returns:${colors.reset} Response | null
+    ${colors.dim}Example:${colors.reset}
+      const response = blockDefaultDomains(request);
+      if (response) return response;
+
+  ${colors.cyan}ipAccessControl(request, options)${colors.reset}
+    Whitelist or blacklist IPs at the edge
+    ${colors.dim}Parameters:${colors.reset}
+      - request: Request object
+      - options: { allow?: string[], deny?: string[] }
+    ${colors.dim}Returns:${colors.reset} Response | null
+    ${colors.dim}Example:${colors.reset}
+      const response = ipAccessControl(request, {
+        allow: ["203.0.113.10", "198.51.100.5"]
+      });
+      if (response) return response;
+
+  ${colors.cyan}protectWithBasicAuth(request, options)${colors.reset}
+    Add Basic Authentication to protect staging/dev environments
+    ${colors.dim}Parameters:${colors.reset}
+      - request: Request object
+      - options: {
+          hostnameIncludes: string,
+          username: string,
+          password: string,
+          realm?: string
+        }
+    ${colors.dim}Returns:${colors.reset} Promise<Response> | null
+    ${colors.dim}Example:${colors.reset}
+      const auth = await protectWithBasicAuth(request, {
+        hostnameIncludes: "staging.myapp.com",
+        username: "admin",
+        password: "securepass123"
+      });
+      if (auth && auth.status === 401) return auth;
+
+${colors.bright}${colors.green}2. Routing & Redirects${colors.reset}
+
+  ${colors.cyan}redirectIfMatch(request, options)${colors.reset}
+    Conditional redirects based on path and method
+    ${colors.dim}Parameters:${colors.reset}
+      - request: Request object
+      - options: {
+          path: string,
+          method?: string,
+          to: string,
+          status?: number
+        }
+    ${colors.dim}Returns:${colors.reset} Response | null
+    ${colors.dim}Example:${colors.reset}
+      const redirect = redirectIfMatch(request, {
+        path: "/old-page",
+        to: "/new-page",
+        status: 301
+      });
+      if (redirect) return redirect;
+
+${colors.bright}${colors.green}3. Next.js Optimization${colors.reset}
+
+  ${colors.cyan}handleNextJS_RSC(request, options)${colors.reset}
+    Fix Next.js React Server Components header issues
+    ${colors.dim}Parameters:${colors.reset}
+      - request: Request object
+      - options: { affectedPaths: string[] }
+    ${colors.dim}Returns:${colors.reset} Promise<Response> | null
+    ${colors.dim}Example:${colors.reset}
+      const rsc = await handleNextJS_RSC(request, {
+        affectedPaths: ["/shop", "/about", "/products"]
+      });
+      if (rsc) return rsc;
+
+${colors.bright}${colors.green}4. Geo-Location${colors.reset}
+
+  ${colors.cyan}getGeoHeaders(request)${colors.reset}
+    Extract geo-location data from Launch headers
+    ${colors.dim}Parameters:${colors.reset}
+      - request: Request object
+    ${colors.dim}Returns:${colors.reset} {
+      country: string | null,
+      region: string | null,
+      city: string | null,
+      latitude: string | null,
+      longitude: string | null
+    }
+    ${colors.dim}Example:${colors.reset}
+      const geo = getGeoHeaders(request);
+      if (geo.country === "US") {
+        // Custom logic for US visitors
+      }
+
+${colors.bright}${colors.green}5. Response Utilities${colors.reset}
+
+  ${colors.cyan}jsonResponse(body, init?)${colors.reset}
+    Create JSON responses easily
+    ${colors.dim}Parameters:${colors.reset}
+      - body: Record<string, unknown>
+      - init: ResponseInit (optional)
+    ${colors.dim}Returns:${colors.reset} Response
+    ${colors.dim}Example:${colors.reset}
+      return jsonResponse({ status: "ok", data: [...] });
+
+  ${colors.cyan}passThrough(request)${colors.reset}
+    Forward request to origin server
+    ${colors.dim}Parameters:${colors.reset}
+      - request: Request object
+    ${colors.dim}Returns:${colors.reset} Promise<Response>
+    ${colors.dim}Example:${colors.reset}
+      return passThrough(request);
+
+${colors.bright}${colors.green}6. Configuration${colors.reset}
+
+  ${colors.cyan}generateLaunchConfig(options)${colors.reset}
+    Generate launch.json configuration programmatically
+    ${colors.dim}Parameters:${colors.reset}
+      - options: {
+          redirects?: LaunchRedirect[],
+          rewrites?: LaunchRewrite[],
+          cache?: { cachePriming?: { urls: string[] } }
+        }
+    ${colors.dim}Returns:${colors.reset} LaunchConfig
+    ${colors.dim}Example:${colors.reset}
+      const config = generateLaunchConfig({
+        redirects: [{ source: "/old", destination: "/new", statusCode: 301 }],
+        cache: { cachePriming: { urls: ["/", "/about"] } }
+      });
+
+${colors.bright}${colors.yellow}🛠️  CLI COMMANDS${colors.reset}
+${colors.dim}────────────────────────────────────────────────────────────────────${colors.reset}
+
+  ${colors.cyan}npx create-launch-edge${colors.reset}
+    Initialize edge functions with boilerplate code
+    Creates: functions/[proxy].edge.js
+
+  ${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
+
+${colors.bright}${colors.yellow}📚 QUICK LINKS${colors.reset}
+${colors.dim}────────────────────────────────────────────────────────────────────${colors.reset}
+
+  ${colors.blue}Documentation:${colors.reset} https://github.com/AryanBansal-launch/launch-edge-utils
+  ${colors.blue}NPM Package:${colors.reset}   https://www.npmjs.com/package/@aryanbansal-launch/edge-utils
+  ${colors.blue}Launch Docs:${colors.reset}   https://www.contentstack.com/docs/developers/launch
+
+${colors.dim}────────────────────────────────────────────────────────────────────${colors.reset}
+`);
+

package/dist/ai/gemini.js

@@ -0,0 +1,153 @@
+/**
+ * Generates a complete Gemini AI Chatbot widget script to be injected at the Edge.
+ */
+export function getGeminiChatbotScript(options) {
+    const { apiKey, botName = "Gemini Assistant", welcomeMessage = "Hi! How can I help you today?", primaryColor = "#1a73e8", } = options;
+    return `
+<script>
+(function() {
+  // Create styles
+  const style = document.createElement('style');
+  style.textContent = \`
+    #gemini-chat-widget {
+      position: fixed;
+      bottom: 20px;
+      right: 20px;
+      z-index: 9999;
+      font-family: sans-serif;
+    }
+    #gemini-chat-button {
+      width: 60px;
+      height: 60px;
+      border-radius: 50%;
+      background-color: ${primaryColor};
+      color: white;
+      border: none;
+      cursor: pointer;
+      box-shadow: 0 4px 12px rgba(0,0,0,0.15);
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      font-size: 24px;
+    }
+    #gemini-chat-window {
+      display: none;
+      width: 350px;
+      height: 500px;
+      background: white;
+      border-radius: 12px;
+      box-shadow: 0 8px 24px rgba(0,0,0,0.2);
+      flex-direction: column;
+      overflow: hidden;
+      margin-bottom: 15px;
+    }
+    #gemini-chat-header {
+      padding: 15px;
+      background: ${primaryColor};
+      color: white;
+      font-weight: bold;
+      display: flex;
+      justify-content: space-between;
+    }
+    #gemini-chat-messages {
+      flex: 1;
+      padding: 15px;
+      overflow-y: auto;
+      background: #f7f7f7;
+    }
+    .gemini-msg {
+      margin-bottom: 10px;
+      padding: 8px 12px;
+      border-radius: 8px;
+      max-width: 80%;
+      word-wrap: break-word;
+    }
+    .gemini-msg-bot { background: white; align-self: flex-start; border: 1px solid #eee; }
+    .gemini-msg-user { background: ${primaryColor}; color: white; align-self: flex-end; margin-left: auto; }
+    #gemini-chat-input-area {
+      padding: 10px;
+      border-top: 1px solid #eee;
+      display: flex;
+    }
+    #gemini-chat-input {
+      flex: 1;
+      border: 1px solid #ddd;
+      padding: 8px;
+      border-radius: 4px;
+      outline: none;
+    }
+  \`;
+  document.head.appendChild(style);
+
+  // Create HTML
+  const container = document.createElement('div');
+  container.id = 'gemini-chat-widget';
+  container.innerHTML = \`
+    <div id="gemini-chat-window">
+      <div id="gemini-chat-header">
+        <span>${botName}</span>
+        <button onclick="document.getElementById('gemini-chat-window').style.display='none'" style="background:none; border:none; color:white; cursor:pointer;">×</button>
+      </div>
+      <div id="gemini-chat-messages">
+        <div class="gemini-msg gemini-msg-bot">${welcomeMessage}</div>
+      </div>
+      <div id="gemini-chat-input-area">
+        <input type="text" id="gemini-chat-input" placeholder="Type a message...">
+      </div>
+    </div>
+    <button id="gemini-chat-button">💬</button>
+  \`;
+  document.body.appendChild(container);
+
+  const btn = document.getElementById('gemini-chat-button');
+  const win = document.getElementById('gemini-chat-window');
+  const input = document.getElementById('gemini-chat-input');
+  const msgContainer = document.getElementById('gemini-chat-messages');
+
+  btn.onclick = () => {
+    win.style.display = win.style.display === 'flex' ? 'none' : 'flex';
+    if (win.style.display === 'flex') input.focus();
+  };
+
+  async function sendMessage() {
+    const text = input.value.trim();
+    if (!text) return;
+
+    input.value = '';
+    appendMessage('user', text);
+
+    const loadingMsg = appendMessage('bot', '...');
+
+    try {
+      const response = await fetch('https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent?key=${apiKey}', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          contents: [{ parts: [{ text }] }]
+        })
+      });
+      const data = await response.json();
+      const botReply = data.candidates[0].content.parts[0].text;
+      loadingMsg.textContent = botReply;
+    } catch (e) {
+      loadingMsg.textContent = 'Sorry, I am having trouble connecting.';
+    }
+    msgContainer.scrollTop = msgContainer.scrollHeight;
+  }
+
+  function appendMessage(role, text) {
+    const div = document.createElement('div');
+    div.className = 'gemini-msg gemini-msg-' + role;
+    div.textContent = text;
+    msgContainer.appendChild(div);
+    msgContainer.scrollTop = msgContainer.scrollHeight;
+    return div;
+  }
+
+  input.onkeypress = (e) => { if (e.key === 'Enter') sendMessage(); };
+})();
+</script>
+  \`;
+}
+`;
+}

package/dist/utils/inject.js

@@ -0,0 +1,45 @@
+/**
+ * Utility to inject HTML/scripts into a Response body using TransformStream.
+ * This is high-performance as it streams the modification without loading the full body into memory.
+ */
+class HTMLRewriterStream extends TransformStream {
+    constructor(contentToInject, position = 'before-body-end') {
+        const encoder = new TextEncoder();
+        const decoder = new TextDecoder();
+        super({
+            transform(chunk, controller) {
+                let html = decoder.decode(chunk);
+                if (position === 'before-body-end' && html.includes('</body>')) {
+                    html = html.replace('</body>', `${contentToInject}</body>`);
+                }
+                else if (position === 'after-head-start' && html.includes('<head>')) {
+                    html = html.replace('<head>', `<head>${contentToInject}`);
+                }
+                controller.enqueue(encoder.encode(html));
+            },
+        });
+    }
+}
+/**
+ * Injects a script or HTML snippet into a Response.
+ * @param response The original Response object
+ * @param options Injection options
+ */
+export async function injectScript(response, options) {
+    const contentType = response.headers.get('content-type');
+    // Only inject into HTML responses
+    if (!contentType || !contentType.includes('text/html')) {
+        return response;
+    }
+    const contentToInject = options.scriptUrl
+        ? `<script src="${options.scriptUrl}" async defer></script>`
+        : (options.script || '');
+    if (!contentToInject)
+        return response;
+    const rewriter = new HTMLRewriterStream(contentToInject, options.position);
+    return new Response(response.body?.pipeThrough(rewriter), {
+        status: response.status,
+        statusText: response.statusText,
+        headers: response.headers,
+    });
+}

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.10",
+  "version": "0.1.12",
   "license": "MIT",
   "type": "module",
   "repository": {
@@ -13,17 +13,33 @@
   },
   "main": "dist/index.js",
   "bin": {
-    "create-launch-edge": "./bin/launch-init.js",
-    "launch-config": "./bin/launch-config.js"
+    "create-launch-edge": "bin/launch-init.js",
+    "launch-config": "bin/launch-config.js",
+    "launch-help": "bin/launch-help.js"
   },
   "exports": {
     ".": "./dist/index.js"
   },
   "files": [
     "dist",
-    "bin"
+    "bin",
+    "examples"
   ],
   "scripts": {
-    "build": "tsc"
-  }
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "contentstack",
+    "launch",
+    "edge-functions",
+    "edge",
+    "middleware",
+    "security",
+    "nextjs",
+    "redirect",
+    "geo-location",
+    "basic-auth",
+    "ip-access"
+  ]
 }