oauth-init 0.15.0 → 0.16.0

package/dist/index.js

@@ -9176,6 +9176,15 @@ var open_default = open;
 
 // src/lib/save-credentials.ts
 import { writeFile, readFile, access } from "fs/promises";
+
+// src/lib/config.ts
+var globalConfig = {
+  quiet: false,
+  noOpen: false,
+  skipPrompts: false
+};
+
+// src/lib/save-credentials.ts
 async function saveCredentials(clientId, clientSecret, provider, saveOption) {
   const envKeyId = `${provider.toUpperCase()}_CLIENT_ID`;
   const envKeySecret = `${provider.toUpperCase()}_CLIENT_SECRET`;
@@ -9189,14 +9198,38 @@ ${envKeySecret}=${clientSecret}`;
   if (saveOption === "json") {
     const jsonContent = JSON.stringify({ clientId, clientSecret }, null, 2);
     const jsonPath = `${provider}-credentials.json`;
+    if (!globalConfig.skipPrompts) {
+      R2.message("Preview:");
+      R2.message(jsonContent);
+      const confirmSave = await Re({
+        message: `Save to ${jsonPath}?`,
+        initialValue: true
+      });
+      if (Ct(confirmSave) || !confirmSave) {
+        R2.warn("Credentials not saved.");
+        return;
+      }
+    }
     await writeFile(jsonPath, jsonContent);
     R2.success(`Credentials saved to ${jsonPath}`);
     return;
   }
   const envPath = saveOption === "dot-env" ? ".env" : ".env.local";
+  if (!globalConfig.skipPrompts) {
+    R2.message("Preview:");
+    R2.message(newEnvContent);
+    const confirmSave = await Re({
+      message: `Save to ${envPath}?`,
+      initialValue: true
+    });
+    if (Ct(confirmSave) || !confirmSave) {
+      R2.warn("Credentials not saved.");
+      return;
+    }
+  }
   try {
     await access(envPath);
-    const shouldAppend = await Re({
+    const shouldAppend = globalConfig.skipPrompts ? true : await Re({
       message: `${envPath} already exists. Append credentials?`,
       initialValue: true
     });
@@ -9215,6 +9248,9 @@ ${envKeySecret}=${clientSecret}`;
 
 // src/lib/ask-save-option.ts
 async function askSaveOption() {
+  if (globalConfig.skipPrompts) {
+    return "dot-env";
+  }
   return Je({
     message: "Where do you want to save the credentials?",
     options: [
@@ -9226,13 +9262,7 @@ async function askSaveOption() {
   });
 }
 
-// src/lib/config.ts
-var globalConfig = {
-  quiet: false,
-  noOpen: false
-};
-
-// src/lib/google-provider.ts
+// src/lib/providers/google-provider.ts
 function logStep(message) {
   if (!globalConfig.quiet)
     R2.step(message);
@@ -9326,34 +9356,62 @@ class GoogleAuthProvider {
       const brandUrl = `https://console.cloud.google.com/apis/credentials/consent?project=${projectId}`;
       logMessage(`Google requires manual setup for personal projects.
 Opening: ${brandUrl}`);
+      Ve(`Required Redirect URI:
+${_appName}`, "Save this URL");
       if (!globalConfig.noOpen) {
-        await open_default(brandUrl);
+        const shouldOpen = globalConfig.skipPrompts ? true : await Re({
+          message: "Open Google Cloud Console?",
+          initialValue: true
+        });
+        if (Ct(shouldOpen))
+          return Ne("Setup aborted.");
+        if (shouldOpen)
+          await open_default(brandUrl);
       }
-      Ve(`1. Choose 'External'
+      if (!globalConfig.skipPrompts) {
+        Ve(`1. Choose 'External'
 2. Fill App Name & Email
 3. Click 'Save and Continue' through to the end.`, "Action Required");
-      const brandDone = await Ze({
-        message: "Press Enter once you've saved the Consent Screen (or type 'skip' if done previously)"
-      });
-      if (Ct(brandDone))
-        return Ne("Setup aborted.");
+        const brandDone = await Ze({
+          message: "Press Enter once you've saved the Consent Screen (or type 'skip' if done previously)"
+        });
+        if (Ct(brandDone))
+          return Ne("Setup aborted.");
+      }
       logStep("Step 2: Create OAuth Client ID");
       const clientUrl = `https://console.cloud.google.com/apis/credentials/oauthclient?project=${projectId}`;
       logMessage(`Opening: ${clientUrl}`);
+      Ve(`Required Redirect URI:
+${_appName}`, "Save this URL");
       if (!globalConfig.noOpen) {
-        await open_default(clientUrl);
+        const shouldOpen = globalConfig.skipPrompts ? true : await Re({
+          message: "Open OAuth Client creation page?",
+          initialValue: true
+        });
+        if (Ct(shouldOpen))
+          return Ne("Setup aborted.");
+        if (shouldOpen)
+          await open_default(clientUrl);
       }
-      Ve(`1. Select 'Web Application'
+      if (!globalConfig.skipPrompts) {
+        Ve(`1. Select 'Web Application'
 2. Add your Redirect URIs
 3. Click 'Create'`, "Action Required");
-      const clientId = await Ze({
+      }
+      let clientId;
+      let clientSecret;
+      if (globalConfig.skipPrompts) {
+        R2.error("Client ID and Secret required in non-interactive mode. Run without --skip-prompts");
+        process.exit(1);
+      }
+      clientId = await Ze({
         message: "Paste your Client ID:",
         placeholder: "12345-abcde.apps.googleusercontent.com",
         validate: (value) => value?.includes(".apps.googleusercontent.com") ? undefined : "Invalid format"
       });
       if (Ct(clientId))
         return Ne("Setup aborted.");
-      const clientSecret = await He({
+      clientSecret = await He({
         message: "Paste your Client Secret:"
       });
       if (Ct(clientSecret))
@@ -9370,7 +9428,7 @@ Opening: ${brandUrl}`);
   }
 }
 
-// src/lib/github-provider.ts
+// src/lib/providers/github-provider.ts
 import http from "http";
 function logStep2(message) {
   if (!globalConfig.quiet)
@@ -9478,18 +9536,33 @@ class GitHubAuthProvider {
     logStep2("Step 1: Create OAuth App on GitHub");
     const oauthAppUrl = "https://github.com/settings/applications/new";
     logMessage2(`Opening: ${oauthAppUrl}`);
+    Ve(`Required Authorization callback URL:
+${callbackUrl}`, "Save this URL");
     if (!globalConfig.noOpen) {
-      await open_default(oauthAppUrl);
+      const shouldOpen = globalConfig.skipPrompts ? true : await Re({
+        message: "Open GitHub OAuth App page?",
+        initialValue: true
+      });
+      if (Ct(shouldOpen))
+        return Ne("Setup aborted.");
+      if (shouldOpen)
+        await open_default(oauthAppUrl);
     }
-    Ve(`1. Fill Application Name and Homepage URL
-2. Enter Authorization callback URL: ` + callbackUrl + `
+    if (!globalConfig.skipPrompts) {
+      Ve(`1. Fill Application Name and Homepage URL
+2. Enter Authorization callback URL
 3. Click 'Register application'`, "Action Required");
-    const brandDone = await Ze({
-      message: "Press Enter once you've created the OAuth App (or type 'skip' if done previously)"
-    });
-    if (Ct(brandDone))
-      return Ne("Setup aborted.");
+      const brandDone = await Ze({
+        message: "Press Enter once you've created the OAuth App (or type 'skip' if done previously)"
+      });
+      if (Ct(brandDone))
+        return Ne("Setup aborted.");
+    }
     logStep2("Step 2: Save credentials");
+    if (globalConfig.skipPrompts) {
+      R2.error("Client ID and Secret required in non-interactive mode. Run without --skip-prompts");
+      process.exit(1);
+    }
     const clientId = await Ze({
       message: "Paste your Client ID:",
       placeholder: "Iv1.xxx"
@@ -9508,7 +9581,7 @@ class GitHubAuthProvider {
   }
 }
 
-// src/lib/discord-provider.ts
+// src/lib/providers/discord-provider.ts
 function logStep3(message) {
   if (!globalConfig.quiet)
     R2.step(message);
@@ -9524,14 +9597,29 @@ class DiscordAuthProvider {
       logStep3("Step 1: Create Discord Application");
       const portalUrl = "https://discord.com/developers/applications?new_app=true";
       logMessage3(`Opening Discord Developer Portal: ${portalUrl}`);
+      Ve(`Required Redirect URI:
+${callbackUrl}`, "Save this URL");
       if (!globalConfig.noOpen) {
-        await open_default(portalUrl);
+        const shouldOpen = globalConfig.skipPrompts ? true : await Re({
+          message: "Open Discord Developer Portal?",
+          initialValue: true
+        });
+        if (Ct(shouldOpen))
+          return Ne("Setup aborted.");
+        if (shouldOpen)
+          await open_default(portalUrl);
       }
-      Ve(`1. Click 'New Application' and give it a name.
-` + `2. Go to 'OAuth2' -> 'General' in the sidebar.
-` + "3. Click 'Add Redirect' and paste: " + callbackUrl + `
+      if (!globalConfig.skipPrompts) {
+        Ve(`1. Click 'New Application' and give it a name.
+` + `2. Go to 'Overview' -> 'OAuth2' in the sidebar.
+` + `3. Click 'Add Redirect' and paste your callback URL
 4. Click 'Reset Secret' if you don't have a Client Secret`, "Action Required");
+      }
       logStep3("Step 2: Collect Credentials");
+      if (globalConfig.skipPrompts) {
+        R2.error("Client ID and Secret required in non-interactive mode. Run without --skip-prompts");
+        process.exit(1);
+      }
       const clientId = await Ze({
         message: "Enter your Discord Client ID:",
         placeholder: "123456789012345678",
@@ -9594,7 +9682,35 @@ function getCallbackUrlPattern(authLibrary) {
   return "/oauth/callback/[provider]";
 }
 var DEFAULT_CALLBACK_URL = "http://localhost:3000";
-async function setupOAuthServices(oauthServices) {
+var PROVIDER_HELP = {
+  google: `
+Google OAuth Setup:
+  1. Requires a Google Cloud project with OAuth 2.0 configured
+  2. Redirect URI: http://localhost:3000/api/auth/callback/google
+  3. Need: Client ID and Client Secret from Google Cloud Console
+  4. Run: gcloud auth login before starting`,
+  github: `
+GitHub OAuth Setup:
+  1. Creates OAuth App or GitHub App in your org
+  2. Redirect URI: http://localhost:3000/api/auth/callback/github
+  3. Need: Client ID and Client Secret from GitHub Developer Settings`,
+  discord: `
+Discord OAuth Setup:
+  1. Requires Discord Developer Portal setup
+  2. Redirect URI: http://localhost:3000/api/auth/callback/discord
+  3. Need: Client ID and Client Secret from Discord Developer Portal`
+};
+function showProviderHelp(provider) {
+  const help = PROVIDER_HELP[provider.toLowerCase()];
+  if (help) {
+    console.log(help);
+    process.exit(0);
+  }
+  console.log(`Unknown provider: ${provider}`);
+  console.log(`Available: ${Object.keys(PROVIDER_HELP).join(", ")}`);
+  process.exit(1);
+}
+async function setupOAuthServices(oauthServices, customCallbackUrl) {
   const authLibrary = detectAuthLibrary();
   const callbackPattern = getCallbackUrlPattern(authLibrary);
   if (authLibrary) {
@@ -9602,12 +9718,13 @@ async function setupOAuthServices(oauthServices) {
   } else {
     R2.info("No known auth library detected, using generic callback pattern");
   }
+  const baseCallbackUrl = customCallbackUrl || DEFAULT_CALLBACK_URL;
   for (const service of oauthServices) {
     const providerCallback = callbackPattern.replace("[provider]", service);
-    const defaultCallback = `${DEFAULT_CALLBACK_URL}${providerCallback}`;
+    const defaultCallback = `${baseCallbackUrl}${providerCallback}`;
     if (service === "google") {
       R2.step("Google OAuth Setup");
-      const googleOauthCallback = await Ze({
+      const googleOauthCallback = globalConfig.skipPrompts ? defaultCallback : await Ze({
         message: "Enter the Google OAuth callback URL:",
         placeholder: defaultCallback,
         defaultValue: defaultCallback
@@ -9620,7 +9737,7 @@ async function setupOAuthServices(oauthServices) {
       await googleProvider.run(googleOauthCallback);
     } else if (service === "github") {
       R2.step("GitHub OAuth Setup");
-      const githubOauthCallback = await Ze({
+      const githubOauthCallback = globalConfig.skipPrompts ? defaultCallback : await Ze({
         message: "Enter the GitHub OAuth callback URL:",
         placeholder: defaultCallback,
         defaultValue: defaultCallback
@@ -9633,7 +9750,7 @@ async function setupOAuthServices(oauthServices) {
       await githubProvider.run(githubOauthCallback);
     } else if (service === "discord") {
       R2.step("Discord OAuth Setup");
-      const discordOauthCallback = await Ze({
+      const discordOauthCallback = globalConfig.skipPrompts ? defaultCallback : await Ze({
         message: "Enter the Discord OAuth callback URL:",
         placeholder: defaultCallback,
         defaultValue: defaultCallback
@@ -9653,54 +9770,91 @@ async function main() {
   const flags = {
     help: args.includes("--help") || args.includes("-h"),
     quiet: args.includes("--quiet") || args.includes("-q"),
-    noOpen: args.includes("--no-open") || args.includes("-n")
+    noOpen: args.includes("--no-open") || args.includes("-n"),
+    skipPrompts: args.includes("--skip-prompts") || args.includes("-y"),
+    provider: args.find((arg) => arg.startsWith("--provider="))?.split("=")[1] || args.find((arg) => arg.startsWith("-p="))?.split("=")[1],
+    callbackUrl: args.find((arg) => arg.startsWith("--callback-url="))?.split("=")[1] || args.find((arg) => arg.startsWith("-c="))?.split("=")[1]
   };
+  const providerArg = args.find((arg) => !arg.startsWith("-"));
+  if (providerArg && (providerArg === "google" || providerArg === "github" || providerArg === "discord")) {
+    showProviderHelp(providerArg);
+  }
   if (flags.help) {
     console.log(`
-Usage: oauth-init [options]
+Usage: oauth-init [options] [provider]
 
 Options:
-  -h, --help     Show this help message
-  -q, --quiet    Reduce output verbosity
-  -n, --no-open  Don't open browser URLs automatically
+  -h, --help             Show this help message
+  -q, --quiet            Reduce output verbosity
+  -n, --no-open          Don't open browser URLs automatically
+  -y, --skip-prompts     Use default options (for CI/CD)
+  -p, --provider=        Specify providers (comma-separated): google,github,discord
+  -c, --callback-url=   Base callback URL (default: http://localhost:3000)
 
 Examples:
-  oauth-init              # Run interactive setup
-  oauth-init --quiet       # Run with minimal output
-  oauth-init --no-open     # Get URLs but don't open them
+  oauth-init                        # Run interactive setup
+  oauth-init --provider=google      # Setup only Google
+  oauth-init --provider=google,github  # Setup Google and GitHub
+  oauth-init --no-open              # Get URLs but don't open them
+  oauth-init --quiet -y             # Minimal output, use defaults
+  oauth-init -y -p google -c https://myapp.com  # CI/CD mode
+  oauth-init google                 # Show Google-specific help
 `);
     process.exit(0);
   }
+  if (flags.provider) {
+    const validProviders = ["google", "github", "discord"];
+    const providers = flags.provider.split(",").map((p) => p.trim().toLowerCase());
+    const invalid = providers.filter((p) => !validProviders.includes(p));
+    if (invalid.length > 0) {
+      console.error(`Invalid providers: ${invalid.join(", ")}. Valid: ${validProviders.join(", ")}`);
+      process.exit(1);
+    }
+  }
   globalConfig.quiet = flags.quiet;
   globalConfig.noOpen = flags.noOpen;
+  globalConfig.skipPrompts = flags.skipPrompts;
   const projectDirectoryName = path7.basename(process.cwd());
-  We(`
+  if (!flags.quiet) {
+    We(`
   ▗▄▖  ▗▄▖ ▗▖ ▗▖▗▄▄▄▖▗▖ ▗▖    ▗▄▄▄▖▗▖  ▗▖▗▄▄▄▖▗▄▄▄▖
  ▐▌ ▐▌▐▌ ▐▌▐▌ ▐▌  █  ▐▌ ▐▌      █  ▐▛▚▖▐▌  █    █
  ▐▌ ▐▌▐▛▀▜▌▐▌ ▐▌  █  ▐▛▀▜▌      █  ▐▌ ▝▜▌  █    █
  ▝▚▄▞▘▐▌ ▐▌▝▚▄▞▘  █  ▐▌ ▐▌    ▗▄█▄▖▐▌  ▐▌▗▄█▄▖  █ `);
-  const projectName = await Ze({
-    message: "Enter the name of your project:",
-    placeholder: projectDirectoryName,
-    defaultValue: projectDirectoryName
-  });
-  if (Ct(projectName)) {
-    Ne("Operation cancelled.");
-    process.exit(0);
   }
-  const oauthToSetup = await je({
-    message: "Select OAuth services to setup:",
-    options: [
-      { value: "google", label: "Google" },
-      { value: "github", label: "Github" },
-      { value: "discord", label: "Discord" }
-    ]
-  });
-  if (Ct(oauthToSetup)) {
-    Ne("Operation cancelled.");
-    process.exit(0);
+  let projectName;
+  if (flags.skipPrompts) {
+    projectName = projectDirectoryName;
+  } else {
+    projectName = await Ze({
+      message: "Enter the name of your project:",
+      placeholder: projectDirectoryName,
+      defaultValue: projectDirectoryName
+    });
+    if (Ct(projectName)) {
+      Ne("Operation cancelled.");
+      process.exit(0);
+    }
+  }
+  let oauthToSetup;
+  if (flags.provider) {
+    oauthToSetup = flags.provider.split(",").map((p) => p.trim().toLowerCase());
+  } else {
+    oauthToSetup = await je({
+      message: "Select OAuth services to setup:",
+      options: [
+        { value: "google", label: "Google" },
+        { value: "github", label: "Github" },
+        { value: "discord", label: "Discord" }
+      ]
+    });
+    if (Ct(oauthToSetup)) {
+      Ne("Operation cancelled.");
+      process.exit(0);
+    }
+    oauthToSetup = oauthToSetup;
   }
-  await setupOAuthServices(oauthToSetup);
+  await setupOAuthServices(oauthToSetup, flags.callbackUrl);
   process.exit(0);
 }
 main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oauth-init",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "CLI for setting up OAuth providers for your project",
   "license": "MIT",
   "type": "module",