workos 0.18.0 → 0.20.1

package/dist/lib/mcp-notice.js

@@ -1,275 +0,0 @@
-/**
- * MCP-install onboarding surfaces + their shared gate state.
- *
- * One module owns all automatic-ask state so the install-flow prompt and the
- * one-time banner can't drift apart. The decline contract is absolute: any
- * explicit "no" records `promptDeclined` and no automatic surface ever asks
- * again — `workos mcp install` stays available manually.
- *
- * Mirrors telemetry-notice.ts: persisted shown/declined state in the plain
- * prefs store, mode-gated display, and a never-throws contract so a notice can
- * never block or fail a command. The mode gate is the CLI's interaction-mode
- * system (isPromptAllowed / isHumanMode), which already folds in CI markers,
- * agent markers, and TTY state — non-TTY safety comes from using it.
- */
-import chalk from 'chalk';
-import clack from '../utils/clack.js';
-import { isHumanMode, isPromptAllowed } from '../utils/interaction-mode.js';
-import { isJsonMode } from '../utils/output.js';
-import { renderStderrBox } from '../utils/box.js';
-import { formatWorkOSCommand } from '../utils/command-invocation.js';
-import { analytics } from '../utils/analytics.js';
-import { loadPreferences, savePreferences } from './preferences.js';
-import { detectMcpClients } from './mcp-clients.js';
-import { hasStartupNoticeShown, markStartupNoticeShown } from './startup-notice-gate.js';
-/**
- * Ceiling on the whole install-flow offer so a wedged prompt can never hold up
- * `workos install`. The deadline actively aborts the pending clack prompt (via
- * AbortSignal) — clack's cancel path releases stdin and restores raw mode, so
- * the process can actually exit; a race alone would leave the prompt's stdin
- * handle keeping the event loop alive. Mirrors login.ts's
- * SKILL_INSTALL_TIMEOUT_MS.
- */
-export const MCP_OFFER_TIMEOUT_MS = 30 * 1000;
-let bannerShownThisSession = false;
-/** Human phrasing for each install outcome shown in the accept matrix. */
-const OUTCOME_LABEL = {
-    installed: 'installed',
-    'already-installed': 'already installed',
-    removed: 'removed',
-    'not-installed': 'not installed',
-    skipped: 'skipped',
-    failed: 'failed',
-};
-/**
- * Read the persisted automatic-ask state. Never throws — a missing/corrupt
- * prefs file degrades to "nothing recorded" so gating still works in-memory.
- */
-export async function getMcpAskState() {
-    try {
-        const prefs = await loadPreferences();
-        return {
-            declined: prefs.mcp?.promptDeclined === true,
-            bannerShown: Boolean(prefs.mcp?.bannerShownAt),
-        };
-    }
-    catch {
-        return { declined: false, bannerShown: false };
-    }
-}
-/**
- * Record an explicit decline. Absolute and permanent for automatic surfaces.
- * Write failures are swallowed: gating degrades to per-run memory, never
- * crashes a command.
- */
-export async function recordMcpDeclined() {
-    try {
-        savePreferences({ mcp: { promptDeclined: true } });
-    }
-    catch {
-        // Swallow — a read-only prefs file must never break a command.
-    }
-}
-/** Record that the one-time banner was shown, stamping the current time. */
-export async function recordMcpBannerShown() {
-    try {
-        savePreferences({ mcp: { bannerShownAt: new Date().toISOString() } });
-    }
-    catch {
-        // Swallow — see recordMcpDeclined.
-    }
-}
-/**
- * The detected agents that would actually receive an install: available on this
- * machine AND missing the WorkOS server. Empty when there is nothing to offer.
- * Never throws — detection failure yields an empty set.
- */
-async function detectInstallTargets() {
-    try {
-        const clients = await detectMcpClients();
-        if (clients.length === 0)
-            return [];
-        const installed = await Promise.all(clients.map((c) => c.isInstalled()));
-        return clients.filter((_, i) => !installed[i]);
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * Would an automatic ask be appropriate right now? True only when the user has
- * not declined AND at least one detected agent lacks the server. Does NOT gate
- * on interaction mode — callers add that (isPromptAllowed for the prompt,
- * isHumanMode for the banner). Checks `declined` first so declined machines
- * never pay for the client shell-outs.
- */
-export async function isAutoAskEligible() {
-    const { declined } = await getMcpAskState();
-    if (declined)
-        return false;
-    const targets = await detectInstallTargets();
-    return targets.length > 0;
-}
-/**
- * One-time stderr banner nudging the user toward `workos mcp install`. Shown at
- * most once per machine, only on a normal human-mode run, and never when an
- * earlier startup notice already fired this run (telemetry notice and unclaimed
- * warning take precedence). Records `bannerShownAt` before printing —
- * shown-once beats seen-once (a lost banner is fine; a nag loop is not). Never
- * throws.
- */
-export async function maybeShowMcpNotice() {
-    try {
-        if (bannerShownThisSession)
-            return;
-        if (!isHumanMode())
-            return; // suppress in agent / CI / non-TTY
-        if (isJsonMode())
-            return; // never on the machine-readable path
-        if (hasStartupNoticeShown())
-            return; // one-notice-per-run cap; telemetry/unclaimed win
-        const { bannerShown } = await getMcpAskState();
-        if (bannerShown)
-            return; // already shown once, ever
-        if (!(await isAutoAskEligible()))
-            return; // declined, or nothing to offer
-        // Claim the slot + persist BEFORE printing: a lost banner beats a nag loop.
-        bannerShownThisSession = true;
-        markStartupNoticeShown();
-        await recordMcpBannerShown();
-        // Impression event. Queued (not capture()d) so it rides the CLI's final
-        // flush; capture() only folds session tags and no session exists here.
-        analytics.emitCommandEvent('mcp offer', 0, true, {
-            extraAttributes: { 'mcp.entry_point': 'banner', 'mcp.shown': true },
-        });
-        const cmd = chalk.cyan(formatWorkOSCommand('mcp install'));
-        const inner = ` ${chalk.cyan('ℹ')} New: connect your coding agent to WorkOS. Run ${cmd} to add the WorkOS MCP server (Claude Code, Codex, Cursor). `;
-        renderStderrBox(inner, chalk.cyan);
-    }
-    catch {
-        // Never block command startup.
-    }
-}
-/** Emit the per-agent install matrix (human mode) without ever exiting. */
-function printInstallMatrix(results) {
-    for (const r of results) {
-        const line = `${r.displayName}: ${OUTCOME_LABEL[r.outcome]}`;
-        if (r.outcome === 'failed') {
-            clack.log.error(r.error ? `${line} — ${r.error}` : line);
-        }
-        else {
-            clack.log.success(line);
-        }
-    }
-}
-/**
- * The real install-flow offer. Self-gating: renders nothing unless prompting is
- * allowed, the user hasn't declined, and there is at least one agent to install
- * to. On yes: install + print the matrix + emit the adoption event. On explicit
- * no: record the decline + emit (a decline is an adoption signal). On cancel
- * (ctrl-C): skip silently without recording — a cancel is not a decline.
- */
-async function offerMcpInstall(signal) {
-    if (!isPromptAllowed())
-        return; // the entire mode gate (CI / agent / non-TTY)
-    if (isJsonMode())
-        return; // never prompt on the machine-readable path (e.g. `install --json` on a TTY)
-    const { declined } = await getMcpAskState();
-    if (declined)
-        return; // decline is absolute
-    const targets = await detectInstallTargets();
-    if (targets.length === 0)
-        return; // nothing to offer
-    const names = targets.map((t) => t.displayName).join(', ');
-    const offerStartedAt = Date.now();
-    // The deadline signal aborts a hung/unanswered prompt: clack resolves it as
-    // a cancel and releases stdin so the process can exit.
-    const answer = await clack.confirm({
-        message: `Add the WorkOS MCP server to ${names}? Your coding agent gets tools to manage WorkOS resources (you'll authorize via OAuth on first use).`,
-        signal,
-    });
-    // Cancel (ctrl-C or deadline abort) is not a decline — skip silently, ask
-    // again next time.
-    if (clack.isCancel(answer))
-        return;
-    // Adoption events are queued command events, NOT capture(): the installer
-    // session has already shut down by the time this offer runs (run-with-core
-    // fires session.end in its finally), so folded tags would never ship. A
-    // queued event rides the CLI's unconditional final flush (bin.ts) and the
-    // store-forward exit handler covers anything the flush misses.
-    if (!answer) {
-        // Record the decline BEFORE anything else so a later crash can't re-ask.
-        await recordMcpDeclined();
-        // A decline is a completed interaction, not an error: success stays true.
-        analytics.emitCommandEvent('mcp offer', Date.now() - offerStartedAt, true, {
-            extraAttributes: {
-                'mcp.entry_point': 'install-flow',
-                'mcp.accepted': false,
-                'mcp.agents_installed': '',
-                'mcp.agents_failed': '',
-            },
-        });
-        return;
-    }
-    // The user submitted right as the deadline fired: the outer flow has already
-    // moved on, so don't start install work it will never report on.
-    if (signal.aborted)
-        return;
-    const results = [];
-    for (const target of targets) {
-        results.push(await target.add());
-    }
-    printInstallMatrix(results);
-    const installed = results
-        .filter((r) => r.outcome === 'installed' || r.outcome === 'already-installed')
-        .map((r) => r.agent);
-    const failed = results.filter((r) => r.outcome === 'failed').map((r) => r.agent);
-    // success=false when any agent failed, so the offer surfaces as an error
-    // span while mcp.agents_failed carries which ones.
-    analytics.emitCommandEvent('mcp offer', Date.now() - offerStartedAt, failed.length === 0, {
-        extraAttributes: {
-            'mcp.entry_point': 'install-flow',
-            'mcp.accepted': true,
-            'mcp.agents_installed': installed.join(','),
-            'mcp.agents_failed': failed.join(','),
-        },
-    });
-}
-/**
- * Offer to install the WorkOS MCP server at the end of `workos install`.
- *
- * Wraps offerMcpInstall best-effort: a try/catch AND a 30s deadline so the
- * offer can never throw into, wedge, or fail the install flow. The deadline
- * aborts the pending prompt (AbortSignal → clack cancel, which releases stdin);
- * the race is a backstop in case the flow is wedged somewhere that can't be
- * aborted (client shell-outs are separately bounded by their exec timeouts).
- * `workos install` has already succeeded by the time this runs.
- */
-export async function maybeOfferMcpInstall(_opts) {
-    let timeoutHandle;
-    const deadline = new AbortController();
-    try {
-        const timeout = new Promise((resolve) => {
-            timeoutHandle = setTimeout(() => {
-                deadline.abort();
-                resolve();
-            }, MCP_OFFER_TIMEOUT_MS);
-            // Don't keep the event loop alive on this timer — the process should exit
-            // as soon as everything else settles.
-            timeoutHandle.unref?.();
-        });
-        await Promise.race([offerMcpInstall(deadline.signal), timeout]);
-    }
-    catch {
-        // The MCP offer must never fail or block `workos install`.
-    }
-    finally {
-        if (timeoutHandle)
-            clearTimeout(timeoutHandle);
-    }
-}
-/** Reset per-session banner state (for testing). */
-export function resetMcpNoticeState() {
-    bannerShownThisSession = false;
-}
-//# sourceMappingURL=mcp-notice.js.map

package/dist/lib/mcp-notice.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-notice.js","sourceRoot":"","sources":["../../src/lib/mcp-notice.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MCP-install onboarding surfaces + their shared gate state.\n *\n * One module owns all automatic-ask state so the install-flow prompt and the\n * one-time banner can't drift apart. The decline contract is absolute: any\n * explicit \"no\" records `promptDeclined` and no automatic surface ever asks\n * again — `workos mcp install` stays available manually.\n *\n * Mirrors telemetry-notice.ts: persisted shown/declined state in the plain\n * prefs store, mode-gated display, and a never-throws contract so a notice can\n * never block or fail a command. The mode gate is the CLI's interaction-mode\n * system (isPromptAllowed / isHumanMode), which already folds in CI markers,\n * agent markers, and TTY state — non-TTY safety comes from using it.\n */\n\nimport chalk from 'chalk';\nimport clack from '../utils/clack.js';\nimport { isHumanMode, isPromptAllowed } from '../utils/interaction-mode.js';\nimport { isJsonMode } from '../utils/output.js';\nimport { renderStderrBox } from '../utils/box.js';\nimport { formatWorkOSCommand } from '../utils/command-invocation.js';\nimport { analytics } from '../utils/analytics.js';\nimport { loadPreferences, savePreferences } from './preferences.js';\nimport { detectMcpClients, type McpClientResult, type McpClientTarget } from './mcp-clients.js';\nimport { hasStartupNoticeShown, markStartupNoticeShown } from './startup-notice-gate.js';\n\nexport type McpAskState = { declined: boolean; bannerShown: boolean };\n\n/**\n * Ceiling on the whole install-flow offer so a wedged prompt can never hold up\n * `workos install`. The deadline actively aborts the pending clack prompt (via\n * AbortSignal) — clack's cancel path releases stdin and restores raw mode, so\n * the process can actually exit; a race alone would leave the prompt's stdin\n * handle keeping the event loop alive. Mirrors login.ts's\n * SKILL_INSTALL_TIMEOUT_MS.\n */\nexport const MCP_OFFER_TIMEOUT_MS = 30 * 1000;\n\nlet bannerShownThisSession = false;\n\n/** Human phrasing for each install outcome shown in the accept matrix. */\nconst OUTCOME_LABEL: Record<McpClientResult['outcome'], string> = {\n  installed: 'installed',\n  'already-installed': 'already installed',\n  removed: 'removed',\n  'not-installed': 'not installed',\n  skipped: 'skipped',\n  failed: 'failed',\n};\n\n/**\n * Read the persisted automatic-ask state. Never throws — a missing/corrupt\n * prefs file degrades to \"nothing recorded\" so gating still works in-memory.\n */\nexport async function getMcpAskState(): Promise<McpAskState> {\n  try {\n    const prefs = await loadPreferences();\n    return {\n      declined: prefs.mcp?.promptDeclined === true,\n      bannerShown: Boolean(prefs.mcp?.bannerShownAt),\n    };\n  } catch {\n    return { declined: false, bannerShown: false };\n  }\n}\n\n/**\n * Record an explicit decline. Absolute and permanent for automatic surfaces.\n * Write failures are swallowed: gating degrades to per-run memory, never\n * crashes a command.\n */\nexport async function recordMcpDeclined(): Promise<void> {\n  try {\n    savePreferences({ mcp: { promptDeclined: true } });\n  } catch {\n    // Swallow — a read-only prefs file must never break a command.\n  }\n}\n\n/** Record that the one-time banner was shown, stamping the current time. */\nexport async function recordMcpBannerShown(): Promise<void> {\n  try {\n    savePreferences({ mcp: { bannerShownAt: new Date().toISOString() } });\n  } catch {\n    // Swallow — see recordMcpDeclined.\n  }\n}\n\n/**\n * The detected agents that would actually receive an install: available on this\n * machine AND missing the WorkOS server. Empty when there is nothing to offer.\n * Never throws — detection failure yields an empty set.\n */\nasync function detectInstallTargets(): Promise<McpClientTarget[]> {\n  try {\n    const clients = await detectMcpClients();\n    if (clients.length === 0) return [];\n    const installed = await Promise.all(clients.map((c) => c.isInstalled()));\n    return clients.filter((_, i) => !installed[i]);\n  } catch {\n    return [];\n  }\n}\n\n/**\n * Would an automatic ask be appropriate right now? True only when the user has\n * not declined AND at least one detected agent lacks the server. Does NOT gate\n * on interaction mode — callers add that (isPromptAllowed for the prompt,\n * isHumanMode for the banner). Checks `declined` first so declined machines\n * never pay for the client shell-outs.\n */\nexport async function isAutoAskEligible(): Promise<boolean> {\n  const { declined } = await getMcpAskState();\n  if (declined) return false;\n  const targets = await detectInstallTargets();\n  return targets.length > 0;\n}\n\n/**\n * One-time stderr banner nudging the user toward `workos mcp install`. Shown at\n * most once per machine, only on a normal human-mode run, and never when an\n * earlier startup notice already fired this run (telemetry notice and unclaimed\n * warning take precedence). Records `bannerShownAt` before printing —\n * shown-once beats seen-once (a lost banner is fine; a nag loop is not). Never\n * throws.\n */\nexport async function maybeShowMcpNotice(): Promise<void> {\n  try {\n    if (bannerShownThisSession) return;\n    if (!isHumanMode()) return; // suppress in agent / CI / non-TTY\n    if (isJsonMode()) return; // never on the machine-readable path\n    if (hasStartupNoticeShown()) return; // one-notice-per-run cap; telemetry/unclaimed win\n    const { bannerShown } = await getMcpAskState();\n    if (bannerShown) return; // already shown once, ever\n    if (!(await isAutoAskEligible())) return; // declined, or nothing to offer\n\n    // Claim the slot + persist BEFORE printing: a lost banner beats a nag loop.\n    bannerShownThisSession = true;\n    markStartupNoticeShown();\n    await recordMcpBannerShown();\n\n    // Impression event. Queued (not capture()d) so it rides the CLI's final\n    // flush; capture() only folds session tags and no session exists here.\n    analytics.emitCommandEvent('mcp offer', 0, true, {\n      extraAttributes: { 'mcp.entry_point': 'banner', 'mcp.shown': true },\n    });\n\n    const cmd = chalk.cyan(formatWorkOSCommand('mcp install'));\n    const inner = ` ${chalk.cyan('ℹ')} New: connect your coding agent to WorkOS. Run ${cmd} to add the WorkOS MCP server (Claude Code, Codex, Cursor). `;\n    renderStderrBox(inner, chalk.cyan);\n  } catch {\n    // Never block command startup.\n  }\n}\n\n/** Emit the per-agent install matrix (human mode) without ever exiting. */\nfunction printInstallMatrix(results: McpClientResult[]): void {\n  for (const r of results) {\n    const line = `${r.displayName}: ${OUTCOME_LABEL[r.outcome]}`;\n    if (r.outcome === 'failed') {\n      clack.log.error(r.error ? `${line} — ${r.error}` : line);\n    } else {\n      clack.log.success(line);\n    }\n  }\n}\n\n/**\n * The real install-flow offer. Self-gating: renders nothing unless prompting is\n * allowed, the user hasn't declined, and there is at least one agent to install\n * to. On yes: install + print the matrix + emit the adoption event. On explicit\n * no: record the decline + emit (a decline is an adoption signal). On cancel\n * (ctrl-C): skip silently without recording — a cancel is not a decline.\n */\nasync function offerMcpInstall(signal: AbortSignal): Promise<void> {\n  if (!isPromptAllowed()) return; // the entire mode gate (CI / agent / non-TTY)\n  if (isJsonMode()) return; // never prompt on the machine-readable path (e.g. `install --json` on a TTY)\n  const { declined } = await getMcpAskState();\n  if (declined) return; // decline is absolute\n  const targets = await detectInstallTargets();\n  if (targets.length === 0) return; // nothing to offer\n\n  const names = targets.map((t) => t.displayName).join(', ');\n  const offerStartedAt = Date.now();\n  // The deadline signal aborts a hung/unanswered prompt: clack resolves it as\n  // a cancel and releases stdin so the process can exit.\n  const answer = await clack.confirm({\n    message: `Add the WorkOS MCP server to ${names}? Your coding agent gets tools to manage WorkOS resources (you'll authorize via OAuth on first use).`,\n    signal,\n  });\n\n  // Cancel (ctrl-C or deadline abort) is not a decline — skip silently, ask\n  // again next time.\n  if (clack.isCancel(answer)) return;\n\n  // Adoption events are queued command events, NOT capture(): the installer\n  // session has already shut down by the time this offer runs (run-with-core\n  // fires session.end in its finally), so folded tags would never ship. A\n  // queued event rides the CLI's unconditional final flush (bin.ts) and the\n  // store-forward exit handler covers anything the flush misses.\n  if (!answer) {\n    // Record the decline BEFORE anything else so a later crash can't re-ask.\n    await recordMcpDeclined();\n    // A decline is a completed interaction, not an error: success stays true.\n    analytics.emitCommandEvent('mcp offer', Date.now() - offerStartedAt, true, {\n      extraAttributes: {\n        'mcp.entry_point': 'install-flow',\n        'mcp.accepted': false,\n        'mcp.agents_installed': '',\n        'mcp.agents_failed': '',\n      },\n    });\n    return;\n  }\n\n  // The user submitted right as the deadline fired: the outer flow has already\n  // moved on, so don't start install work it will never report on.\n  if (signal.aborted) return;\n\n  const results: McpClientResult[] = [];\n  for (const target of targets) {\n    results.push(await target.add());\n  }\n  printInstallMatrix(results);\n\n  const installed = results\n    .filter((r) => r.outcome === 'installed' || r.outcome === 'already-installed')\n    .map((r) => r.agent);\n  const failed = results.filter((r) => r.outcome === 'failed').map((r) => r.agent);\n  // success=false when any agent failed, so the offer surfaces as an error\n  // span while mcp.agents_failed carries which ones.\n  analytics.emitCommandEvent('mcp offer', Date.now() - offerStartedAt, failed.length === 0, {\n    extraAttributes: {\n      'mcp.entry_point': 'install-flow',\n      'mcp.accepted': true,\n      'mcp.agents_installed': installed.join(','),\n      'mcp.agents_failed': failed.join(','),\n    },\n  });\n}\n\n/**\n * Offer to install the WorkOS MCP server at the end of `workos install`.\n *\n * Wraps offerMcpInstall best-effort: a try/catch AND a 30s deadline so the\n * offer can never throw into, wedge, or fail the install flow. The deadline\n * aborts the pending prompt (AbortSignal → clack cancel, which releases stdin);\n * the race is a backstop in case the flow is wedged somewhere that can't be\n * aborted (client shell-outs are separately bounded by their exec timeouts).\n * `workos install` has already succeeded by the time this runs.\n */\nexport async function maybeOfferMcpInstall(_opts: { entryPoint: 'install-flow' }): Promise<void> {\n  let timeoutHandle: ReturnType<typeof setTimeout> | undefined;\n  const deadline = new AbortController();\n  try {\n    const timeout = new Promise<void>((resolve) => {\n      timeoutHandle = setTimeout(() => {\n        deadline.abort();\n        resolve();\n      }, MCP_OFFER_TIMEOUT_MS);\n      // Don't keep the event loop alive on this timer — the process should exit\n      // as soon as everything else settles.\n      timeoutHandle.unref?.();\n    });\n    await Promise.race([offerMcpInstall(deadline.signal), timeout]);\n  } catch {\n    // The MCP offer must never fail or block `workos install`.\n  } finally {\n    if (timeoutHandle) clearTimeout(timeoutHandle);\n  }\n}\n\n/** Reset per-session banner state (for testing). */\nexport function resetMcpNoticeState(): void {\n  bannerShownThisSession = false;\n}\n"]}

package/dist/lib/port-detection.d.ts

@@ -1,7 +0,0 @@
-import type { Integration } from './constants.js';
-export declare function getCallbackPath(integration: Integration): string;
-/**
- * Detect the dev server port for a framework.
- * Checks config files first, falls back to framework default.
- */
-export declare function detectPort(integration: Integration, installDir: string): number;

package/dist/lib/port-detection.js

@@ -1,238 +0,0 @@
-import * as fs from 'node:fs';
-import { join } from 'node:path';
-import { getConfig } from './settings.js';
-const settings = getConfig();
-const INTEGRATION_TO_SETTINGS_KEY = {
-    nextjs: 'nextjs',
-    react: 'react',
-    'tanstack-start': 'tanstackStart',
-    'react-router': 'reactRouter',
-    'vanilla-js': 'vanillaJs',
-    python: 'python',
-    ruby: 'ruby',
-    php: 'php',
-    'php-laravel': 'phpLaravel',
-    go: 'go',
-    dotnet: 'dotnet',
-    elixir: 'elixir',
-    kotlin: 'kotlin',
-};
-const DEFAULT_PORT = 3000;
-const DEFAULT_CALLBACK_PATH = '/auth/callback';
-function getDefaultPort(integration) {
-    const settingsKey = INTEGRATION_TO_SETTINGS_KEY[integration];
-    return settings.frameworks[settingsKey]?.port ?? DEFAULT_PORT;
-}
-export function getCallbackPath(integration) {
-    const settingsKey = INTEGRATION_TO_SETTINGS_KEY[integration];
-    return settings.frameworks[settingsKey]?.callbackPath ?? DEFAULT_CALLBACK_PATH;
-}
-/**
- * Parse port from Vite config file.
- * Looks for server.port in vite.config.{ts,js,mjs}
- */
-function parseViteConfigPort(configPath) {
-    try {
-        const content = fs.readFileSync(configPath, 'utf-8');
-        // Match: port: 3000 or port: "3000" or port: '3000'
-        const portMatch = content.match(/port\s*:\s*['"]?(\d+)['"]?/);
-        if (portMatch) {
-            return parseInt(portMatch[1], 10);
-        }
-    }
-    catch {
-        // File doesn't exist or can't be read
-    }
-    return null;
-}
-/**
- * Parse port from Next.js package.json scripts.
- * Next.js uses: "dev": "next dev -p 4000" or --port 4000
- */
-function parseNextConfigPort(installDir) {
-    try {
-        const packageJsonPath = join(installDir, 'package.json');
-        const content = fs.readFileSync(packageJsonPath, 'utf-8');
-        const packageJson = JSON.parse(content);
-        const devScript = packageJson.scripts?.dev || '';
-        // Match: -p 4000, --port 4000, --port=4000
-        const portMatch = devScript.match(/-p\s+(\d+)|--port[=\s]+(\d+)/);
-        if (portMatch) {
-            return parseInt(portMatch[1] || portMatch[2], 10);
-        }
-    }
-    catch {
-        // Can't read package.json
-    }
-    return null;
-}
-/**
- * Parse port from TanStack Start app.config.ts.
- * Uses Vinxi: server: { port: N }
- */
-function parseTanStackPort(installDir) {
-    const configPaths = [join(installDir, 'app.config.ts'), join(installDir, 'app.config.js')];
-    for (const configPath of configPaths) {
-        try {
-            const content = fs.readFileSync(configPath, 'utf-8');
-            // Match server config with port
-            const portMatch = content.match(/server\s*:\s*\{[^}]*port\s*:\s*(\d+)/);
-            if (portMatch) {
-                return parseInt(portMatch[1], 10);
-            }
-        }
-        catch {
-            // Config file doesn't exist
-        }
-    }
-    return null;
-}
-/**
- * Parse port from .NET Properties/launchSettings.json.
- * VS/Rider scaffold: profiles[*].applicationUrl = "http://localhost:5000;https://localhost:5001"
- */
-function parseDotnetPort(installDir) {
-    try {
-        const configPath = join(installDir, 'Properties', 'launchSettings.json');
-        const content = fs.readFileSync(configPath, 'utf-8');
-        const parsed = JSON.parse(content);
-        for (const profile of Object.values(parsed.profiles ?? {})) {
-            const match = profile.applicationUrl?.match(/http:\/\/[^:/]+:(\d+)/);
-            if (match)
-                return parseInt(match[1], 10);
-        }
-    }
-    catch {
-        // File doesn't exist or can't parse
-    }
-    return null;
-}
-/**
- * Parse port from Phoenix config/dev.exs or config/runtime.exs.
- * Looks for `port: NNNN` — typically inside `http: [...]` but a bare regex is fine.
- */
-function parseElixirPort(installDir) {
-    for (const relPath of ['config/dev.exs', 'config/runtime.exs']) {
-        try {
-            const content = fs.readFileSync(join(installDir, relPath), 'utf-8');
-            const match = content.match(/port:\s*(\d+)/);
-            if (match)
-                return parseInt(match[1], 10);
-        }
-        catch {
-            // skip
-        }
-    }
-    return null;
-}
-/**
- * Parse port from Spring Boot application.properties or application.yml.
- * Both the default `src/main/resources/` location and a top-level file are checked.
- */
-function parseKotlinPort(installDir) {
-    const propsPaths = [
-        join(installDir, 'src', 'main', 'resources', 'application.properties'),
-        join(installDir, 'application.properties'),
-    ];
-    for (const propsPath of propsPaths) {
-        try {
-            const content = fs.readFileSync(propsPath, 'utf-8');
-            const match = content.match(/^server\.port\s*=\s*(\d+)/m);
-            if (match)
-                return parseInt(match[1], 10);
-        }
-        catch {
-            // skip
-        }
-    }
-    const ymlPaths = [
-        join(installDir, 'src', 'main', 'resources', 'application.yml'),
-        join(installDir, 'src', 'main', 'resources', 'application.yaml'),
-        join(installDir, 'application.yml'),
-        join(installDir, 'application.yaml'),
-    ];
-    for (const ymlPath of ymlPaths) {
-        try {
-            const content = fs.readFileSync(ymlPath, 'utf-8');
-            // `server:\n  port: 8080` — shallow YAML parse via regex
-            const match = content.match(/server\s*:\s*\n[^\S\n]+port\s*:\s*(\d+)/);
-            if (match)
-                return parseInt(match[1], 10);
-        }
-        catch {
-            // skip
-        }
-    }
-    return null;
-}
-/**
- * Parse port from Rails config/puma.rb.
- * Common forms:
- *   port ENV.fetch("PORT") { 3000 }
- *   port ENV.fetch("PORT", 3000)
- *   port 3000
- */
-function parseRubyPort(installDir) {
-    try {
-        const configPath = join(installDir, 'config', 'puma.rb');
-        const content = fs.readFileSync(configPath, 'utf-8');
-        const blockFetch = content.match(/port\s+ENV\.fetch\([^)]*\)\s*\{\s*(\d+)\s*\}/);
-        if (blockFetch)
-            return parseInt(blockFetch[1], 10);
-        const argFetch = content.match(/port\s+ENV\.fetch\([^,]+,\s*(\d+)\)/);
-        if (argFetch)
-            return parseInt(argFetch[1], 10);
-        const literal = content.match(/^\s*port\s+(\d+)/m);
-        if (literal)
-            return parseInt(literal[1], 10);
-    }
-    catch {
-        // skip
-    }
-    return null;
-}
-/**
- * Detect the dev server port for a framework.
- * Checks config files first, falls back to framework default.
- */
-export function detectPort(integration, installDir) {
-    let detectedPort = null;
-    switch (integration) {
-        case 'nextjs':
-            detectedPort = parseNextConfigPort(installDir);
-            break;
-        case 'tanstack-start':
-            detectedPort = parseTanStackPort(installDir);
-            break;
-        case 'react':
-        case 'react-router':
-        case 'vanilla-js': {
-            // Vite-based frameworks
-            const viteConfigs = [
-                join(installDir, 'vite.config.ts'),
-                join(installDir, 'vite.config.js'),
-                join(installDir, 'vite.config.mjs'),
-            ];
-            for (const configPath of viteConfigs) {
-                detectedPort = parseViteConfigPort(configPath);
-                if (detectedPort)
-                    break;
-            }
-            break;
-        }
-        case 'dotnet':
-            detectedPort = parseDotnetPort(installDir);
-            break;
-        case 'elixir':
-            detectedPort = parseElixirPort(installDir);
-            break;
-        case 'kotlin':
-            detectedPort = parseKotlinPort(installDir);
-            break;
-        case 'ruby':
-            detectedPort = parseRubyPort(installDir);
-            break;
-    }
-    return detectedPort ?? getDefaultPort(integration);
-}
-//# sourceMappingURL=port-detection.js.map

package/dist/lib/port-detection.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"port-detection.js","sourceRoot":"","sources":["../../src/lib/port-detection.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from 'node:fs';\nimport { join } from 'node:path';\nimport type { Integration } from './constants.js';\nimport { getConfig } from './settings.js';\n\nconst settings = getConfig();\n\nconst INTEGRATION_TO_SETTINGS_KEY: Record<string, string> = {\n  nextjs: 'nextjs',\n  react: 'react',\n  'tanstack-start': 'tanstackStart',\n  'react-router': 'reactRouter',\n  'vanilla-js': 'vanillaJs',\n  python: 'python',\n  ruby: 'ruby',\n  php: 'php',\n  'php-laravel': 'phpLaravel',\n  go: 'go',\n  dotnet: 'dotnet',\n  elixir: 'elixir',\n  kotlin: 'kotlin',\n};\n\nconst DEFAULT_PORT = 3000;\nconst DEFAULT_CALLBACK_PATH = '/auth/callback';\n\nfunction getDefaultPort(integration: Integration): number {\n  const settingsKey = INTEGRATION_TO_SETTINGS_KEY[integration];\n  return settings.frameworks[settingsKey]?.port ?? DEFAULT_PORT;\n}\n\nexport function getCallbackPath(integration: Integration): string {\n  const settingsKey = INTEGRATION_TO_SETTINGS_KEY[integration];\n  return settings.frameworks[settingsKey]?.callbackPath ?? DEFAULT_CALLBACK_PATH;\n}\n\n/**\n * Parse port from Vite config file.\n * Looks for server.port in vite.config.{ts,js,mjs}\n */\nfunction parseViteConfigPort(configPath: string): number | null {\n  try {\n    const content = fs.readFileSync(configPath, 'utf-8');\n    // Match: port: 3000 or port: \"3000\" or port: '3000'\n    const portMatch = content.match(/port\\s*:\\s*['\"]?(\\d+)['\"]?/);\n    if (portMatch) {\n      return parseInt(portMatch[1], 10);\n    }\n  } catch {\n    // File doesn't exist or can't be read\n  }\n  return null;\n}\n\n/**\n * Parse port from Next.js package.json scripts.\n * Next.js uses: \"dev\": \"next dev -p 4000\" or --port 4000\n */\nfunction parseNextConfigPort(installDir: string): number | null {\n  try {\n    const packageJsonPath = join(installDir, 'package.json');\n    const content = fs.readFileSync(packageJsonPath, 'utf-8');\n    const packageJson = JSON.parse(content);\n\n    const devScript = packageJson.scripts?.dev || '';\n    // Match: -p 4000, --port 4000, --port=4000\n    const portMatch = devScript.match(/-p\\s+(\\d+)|--port[=\\s]+(\\d+)/);\n    if (portMatch) {\n      return parseInt(portMatch[1] || portMatch[2], 10);\n    }\n  } catch {\n    // Can't read package.json\n  }\n  return null;\n}\n\n/**\n * Parse port from TanStack Start app.config.ts.\n * Uses Vinxi: server: { port: N }\n */\nfunction parseTanStackPort(installDir: string): number | null {\n  const configPaths = [join(installDir, 'app.config.ts'), join(installDir, 'app.config.js')];\n\n  for (const configPath of configPaths) {\n    try {\n      const content = fs.readFileSync(configPath, 'utf-8');\n      // Match server config with port\n      const portMatch = content.match(/server\\s*:\\s*\\{[^}]*port\\s*:\\s*(\\d+)/);\n      if (portMatch) {\n        return parseInt(portMatch[1], 10);\n      }\n    } catch {\n      // Config file doesn't exist\n    }\n  }\n  return null;\n}\n\n/**\n * Parse port from .NET Properties/launchSettings.json.\n * VS/Rider scaffold: profiles[*].applicationUrl = \"http://localhost:5000;https://localhost:5001\"\n */\nfunction parseDotnetPort(installDir: string): number | null {\n  try {\n    const configPath = join(installDir, 'Properties', 'launchSettings.json');\n    const content = fs.readFileSync(configPath, 'utf-8');\n    const parsed = JSON.parse(content) as { profiles?: Record<string, { applicationUrl?: string }> };\n    for (const profile of Object.values(parsed.profiles ?? {})) {\n      const match = profile.applicationUrl?.match(/http:\\/\\/[^:/]+:(\\d+)/);\n      if (match) return parseInt(match[1], 10);\n    }\n  } catch {\n    // File doesn't exist or can't parse\n  }\n  return null;\n}\n\n/**\n * Parse port from Phoenix config/dev.exs or config/runtime.exs.\n * Looks for `port: NNNN` — typically inside `http: [...]` but a bare regex is fine.\n */\nfunction parseElixirPort(installDir: string): number | null {\n  for (const relPath of ['config/dev.exs', 'config/runtime.exs']) {\n    try {\n      const content = fs.readFileSync(join(installDir, relPath), 'utf-8');\n      const match = content.match(/port:\\s*(\\d+)/);\n      if (match) return parseInt(match[1], 10);\n    } catch {\n      // skip\n    }\n  }\n  return null;\n}\n\n/**\n * Parse port from Spring Boot application.properties or application.yml.\n * Both the default `src/main/resources/` location and a top-level file are checked.\n */\nfunction parseKotlinPort(installDir: string): number | null {\n  const propsPaths = [\n    join(installDir, 'src', 'main', 'resources', 'application.properties'),\n    join(installDir, 'application.properties'),\n  ];\n  for (const propsPath of propsPaths) {\n    try {\n      const content = fs.readFileSync(propsPath, 'utf-8');\n      const match = content.match(/^server\\.port\\s*=\\s*(\\d+)/m);\n      if (match) return parseInt(match[1], 10);\n    } catch {\n      // skip\n    }\n  }\n\n  const ymlPaths = [\n    join(installDir, 'src', 'main', 'resources', 'application.yml'),\n    join(installDir, 'src', 'main', 'resources', 'application.yaml'),\n    join(installDir, 'application.yml'),\n    join(installDir, 'application.yaml'),\n  ];\n  for (const ymlPath of ymlPaths) {\n    try {\n      const content = fs.readFileSync(ymlPath, 'utf-8');\n      // `server:\\n  port: 8080` — shallow YAML parse via regex\n      const match = content.match(/server\\s*:\\s*\\n[^\\S\\n]+port\\s*:\\s*(\\d+)/);\n      if (match) return parseInt(match[1], 10);\n    } catch {\n      // skip\n    }\n  }\n  return null;\n}\n\n/**\n * Parse port from Rails config/puma.rb.\n * Common forms:\n *   port ENV.fetch(\"PORT\") { 3000 }\n *   port ENV.fetch(\"PORT\", 3000)\n *   port 3000\n */\nfunction parseRubyPort(installDir: string): number | null {\n  try {\n    const configPath = join(installDir, 'config', 'puma.rb');\n    const content = fs.readFileSync(configPath, 'utf-8');\n    const blockFetch = content.match(/port\\s+ENV\\.fetch\\([^)]*\\)\\s*\\{\\s*(\\d+)\\s*\\}/);\n    if (blockFetch) return parseInt(blockFetch[1], 10);\n    const argFetch = content.match(/port\\s+ENV\\.fetch\\([^,]+,\\s*(\\d+)\\)/);\n    if (argFetch) return parseInt(argFetch[1], 10);\n    const literal = content.match(/^\\s*port\\s+(\\d+)/m);\n    if (literal) return parseInt(literal[1], 10);\n  } catch {\n    // skip\n  }\n  return null;\n}\n\n/**\n * Detect the dev server port for a framework.\n * Checks config files first, falls back to framework default.\n */\nexport function detectPort(integration: Integration, installDir: string): number {\n  let detectedPort: number | null = null;\n\n  switch (integration) {\n    case 'nextjs':\n      detectedPort = parseNextConfigPort(installDir);\n      break;\n\n    case 'tanstack-start':\n      detectedPort = parseTanStackPort(installDir);\n      break;\n\n    case 'react':\n    case 'react-router':\n    case 'vanilla-js': {\n      // Vite-based frameworks\n      const viteConfigs = [\n        join(installDir, 'vite.config.ts'),\n        join(installDir, 'vite.config.js'),\n        join(installDir, 'vite.config.mjs'),\n      ];\n      for (const configPath of viteConfigs) {\n        detectedPort = parseViteConfigPort(configPath);\n        if (detectedPort) break;\n      }\n      break;\n    }\n\n    case 'dotnet':\n      detectedPort = parseDotnetPort(installDir);\n      break;\n\n    case 'elixir':\n      detectedPort = parseElixirPort(installDir);\n      break;\n\n    case 'kotlin':\n      detectedPort = parseKotlinPort(installDir);\n      break;\n\n    case 'ruby':\n      detectedPort = parseRubyPort(installDir);\n      break;\n  }\n\n  return detectedPort ?? getDefaultPort(integration);\n}\n"]}

package/dist/lib/post-install.d.ts

@@ -1,8 +0,0 @@
-export declare function detectChanges(): {
-    hasChanges: boolean;
-    files: string[];
-};
-export declare function stageAndCommit(message: string, cwd: string): void;
-export declare function pushBranch(cwd: string): void;
-export declare function createPullRequest(title: string, body: string, cwd: string): string;
-export declare function getManualPrInstructions(branch: string): string;

package/dist/lib/post-install.js

@@ -1,51 +0,0 @@
-import { execFileSync } from 'node:child_process';
-import { writeFileSync, unlinkSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { getDefaultBranch, getUncommittedFiles } from '../utils/git-utils.js';
-export function detectChanges() {
-    const files = getUncommittedFiles();
-    return { hasChanges: files.length > 0, files };
-}
-export function stageAndCommit(message, cwd) {
-    execFileSync('git', ['add', '-A'], { cwd, stdio: 'ignore' });
-    execFileSync('git', ['commit', '-m', message], { cwd, stdio: 'ignore' });
-}
-export function pushBranch(cwd) {
-    execFileSync('git', ['push', '-u', 'origin', 'HEAD'], { cwd, stdio: 'pipe' });
-}
-export function createPullRequest(title, body, cwd) {
-    const baseBranch = getDefaultBranch();
-    const tmpFile = join(tmpdir(), `pr-body-${Date.now()}.md`);
-    writeFileSync(tmpFile, body, 'utf-8');
-    try {
-        return execFileSync('gh', ['pr', 'create', '--title', title, '--body-file', tmpFile, '--base', baseBranch], {
-            cwd,
-            stdio: ['ignore', 'pipe', 'pipe'],
-        })
-            .toString()
-            .trim();
-    }
-    finally {
-        try {
-            unlinkSync(tmpFile);
-        }
-        catch { }
-    }
-}
-export function getManualPrInstructions(branch) {
-    const baseBranch = getDefaultBranch();
-    return `
-To create a PR manually:
-
-1. Push your branch:
-   git push -u origin ${branch}
-
-2. Create PR via GitHub:
-   https://github.com/<owner>/<repo>/compare/${baseBranch}...${branch}
-
-Or install the GitHub CLI:
-   https://cli.github.com/
-`.trim();
-}
-//# sourceMappingURL=post-install.js.map