@aryanbansal-launch/edge-utils 0.1.2 → 0.1.4

package/bin/launch-init.js

@@ -0,0 +1,141 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import path from 'path';
+
+const functionsDir = path.join(process.cwd(), 'functions');
+const edgeFile = path.join(functionsDir, '[proxy].edge.js');
+
+// Simple ANSI colors for better terminal output
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+  blue: '\x1b[34m'
+};
+
+const template = `
+import {
+  jsonResponse,
+  passThrough,
+  redirectIfMatch,
+  protectWithBasicAuth,
+  ipAccessControl,
+  blockAICrawlers,
+  getGeoHeaders,
+  handleNextJS_RSC
+} from "@aryanbansal-launch/edge-utils";
+
+/**
+ * Default Edge Handler for Contentstack Launch
+ * This file was automatically generated by @aryanbansal-launch/edge-utils
+ */
+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"]
+  });
+  if (rscResponse) return rscResponse;
+
+  // 2. 🛡️ Block AI bots immediately
+  const botResponse = blockAICrawlers(request);
+  if (botResponse) return botResponse;
+
+  // 3. 🧱 IP Whitelisting
+  const ipResponse = ipAccessControl(request, { allow: ["203.0.113.10"] });
+  if (ipResponse) return ipResponse;
+
+  // 4. 🔐 Domain-specific Basic Auth
+  const authResponse = await protectWithBasicAuth(request, {
+    hostnameIncludes: "staging.myapp.com",
+    username: "admin",
+    password: "securepassword123"
+  });
+  if (authResponse && authResponse.status === 401) return authResponse;
+
+  // 5. 🔀 SEO-friendly Redirects
+  const redirectResponse = redirectIfMatch(request, {
+    path: "/legacy-url",
+    to: "/modern-url",
+    status: 301
+  });
+  if (redirectResponse) return redirectResponse;
+
+  // 6. 📍 Geo-Location Access
+  const geo = getGeoHeaders(request);
+  if (geo.country === "US") {
+    console.log(\`User from \${geo.city}, \${geo.region}\`);
+  }
+
+  // 7. 📤 Custom JSON Responses
+  if (new URL(request.url).pathname === "/api/health") {
+    return jsonResponse({ status: "healthy", region: geo.region });
+  }
+
+  // 8. 🚀 Pass through to origin
+  return passThrough(request);
+}
+`.trim();
+
+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}`);
+  }
+
+  try {
+    // 2. Folder existence check
+    if (!fs.existsSync(functionsDir)) {
+      fs.mkdirSync(functionsDir, { recursive: true });
+      console.log(`${colors.green}✨ New:${colors.reset} Created /functions directory`);
+      actionsTaken++;
+    } else {
+      console.log(`${colors.blue}ℹ️  Existing:${colors.reset} /functions directory already found`);
+    }
+
+    // 3. File existence check (don't overwrite user's work)
+    if (!fs.existsSync(edgeFile)) {
+      fs.writeFileSync(edgeFile, template + '\n');
+      console.log(`${colors.green}✨ New:${colors.reset} Created /functions/[proxy].edge.js`);
+      actionsTaken++;
+    } else {
+      console.log(`${colors.blue}ℹ️  Existing:${colors.reset} /functions/[proxy].edge.js already found`);
+    }
+
+    // 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) {
+      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 {
+      console.log(`\n${colors.bright}${colors.green}🎉 Setup Complete!${colors.reset}`);
+      console.log(`Successfully prepared your edge environment.`);
+    }
+
+    console.log(`\n${colors.bright}Next Steps:${colors.reset}`);
+    console.log(`1. Open ${colors.cyan}functions/[proxy].edge.js${colors.reset}`);
+    console.log(`2. Customize your redirects, auth, and RSC paths`);
+    console.log(`3. Deploy your project to Contentstack Launch\n`);
+    
+    console.log(`${colors.blue}Documentation:${colors.reset} https://github.com/AryanBansal-launch/launch-edge-utils#readme\n`);
+  } catch (error) {
+    console.error(`\n${colors.red}❌ Error during setup:${colors.reset}`, error.message);
+    process.exit(1);
+  }
+}
+
+init();

package/package.json

@@ -1,14 +1,26 @@
 {
   "name": "@aryanbansal-launch/edge-utils",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "license": "MIT",
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AryanBansal-launch/launch-edge-utils.git"
+  },
+  "homepage": "https://github.com/AryanBansal-launch/launch-edge-utils#readme",
+  "bugs": {
+    "url": "https://github.com/AryanBansal-launch/launch-edge-utils/issues"
+  },
   "main": "dist/index.js",
+  "bin": {
+    "launch-init": "./bin/launch-init.js"
+  },
   "exports": {
     ".": "./dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "bin"
   ],
   "scripts": {
     "build": "tsc"

package/readme.md

@@ -27,6 +27,20 @@ npm install @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:
+
+```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.
+
+---
+
 ## 🛠️ Usage Example
 
 Transform your edge handler into a powerful middleware chain: