convex
Version:
Client for the Convex Cloud
247 lines (246 loc) • 7.18 kB
JavaScript
;
import { chalkStderr } from "chalk";
import * as dotenv from "dotenv";
import { logWarning } from "../../bundler/log.js";
import { loadPackageJson } from "./utils/utils.js";
const _FRAMEWORKS = [
"create-react-app",
"Next.js",
"Vite",
"Remix",
"SvelteKit",
"Expo",
"TanStackStart"
];
export async function writeConvexUrlToEnvFile(ctx, value) {
const writeConfig = await envVarWriteConfig(ctx, value);
if (writeConfig === null) {
return null;
}
const { envFile, envVar, existingFileContent } = writeConfig;
const modified = changedEnvVarFile({
existingFileContent,
envVarName: envVar,
envVarValue: value,
commentAfterValue: null,
commentOnPreviousLine: null
});
ctx.fs.writeUtf8File(envFile, modified);
return writeConfig;
}
export function changedEnvVarFile({
existingFileContent,
envVarName,
envVarValue,
commentAfterValue,
commentOnPreviousLine
}) {
const varAssignment = `${envVarName}=${envVarValue}${commentAfterValue === null ? "" : ` # ${commentAfterValue}`}`;
const commentOnPreviousLineWithLineBreak = commentOnPreviousLine === null ? "" : `${commentOnPreviousLine}
`;
if (existingFileContent === null) {
return `${commentOnPreviousLineWithLineBreak}${varAssignment}
`;
}
const config = dotenv.parse(existingFileContent);
const existing = config[envVarName];
if (existing === envVarValue) {
return null;
}
if (existing !== void 0) {
return existingFileContent.replace(
getEnvVarRegex(envVarName),
`${varAssignment}`
);
} else {
const doubleLineBreak = existingFileContent.endsWith("\n") ? "\n" : "\n\n";
return existingFileContent + doubleLineBreak + commentOnPreviousLineWithLineBreak + varAssignment + "\n";
}
}
export function getEnvVarRegex(envVarName) {
return new RegExp(`^${envVarName}.*$`, "m");
}
export async function suggestedEnvVarName(ctx) {
if (!ctx.fs.exists("package.json")) {
return {
envVar: "CONVEX_URL"
};
}
const packages = await loadPackageJson(ctx);
const isCreateReactApp = "react-scripts" in packages;
if (isCreateReactApp) {
return {
detectedFramework: "create-react-app",
envVar: "REACT_APP_CONVEX_URL",
frontendDevUrl: "http://localhost:3000",
publicPrefix: "REACT_APP_"
};
}
const isNextJs = "next" in packages;
if (isNextJs) {
return {
detectedFramework: "Next.js",
envVar: "NEXT_PUBLIC_CONVEX_URL",
frontendDevUrl: "http://localhost:3000",
publicPrefix: "NEXT_PUBLIC_"
};
}
const isExpo = "expo" in packages;
if (isExpo) {
return {
detectedFramework: "Expo",
envVar: "EXPO_PUBLIC_CONVEX_URL",
publicPrefix: "EXPO_PUBLIC_"
};
}
const isRemix = "@remix-run/dev" in packages;
if (isRemix) {
return {
detectedFramework: "Remix",
envVar: "CONVEX_URL",
frontendDevUrl: "http://localhost:3000"
};
}
const isSvelteKit = "@sveltejs/kit" in packages;
if (isSvelteKit) {
return {
detectedFramework: "SvelteKit",
envVar: "PUBLIC_CONVEX_URL",
frontendDevUrl: "http://localhost:5173",
publicPrefix: "PUBLIC_"
};
}
const isTanStackStart = "@tanstack/start" in packages || "@tanstack/react-start" in packages;
if (isTanStackStart) {
return {
detectedFramework: "TanStackStart",
envVar: "VITE_CONVEX_URL",
frontendDevUrl: "http://localhost:3000",
publicPrefix: "VITE_"
};
}
const isVite = "vite" in packages;
if (isVite) {
return {
detectedFramework: "Vite",
envVar: "VITE_CONVEX_URL",
frontendDevUrl: "http://localhost:5173",
publicPrefix: "VITE_"
};
}
return {
envVar: "CONVEX_URL"
};
}
async function envVarWriteConfig(ctx, value) {
const { detectedFramework, envVar } = await suggestedEnvVarName(ctx);
const { envFile, existing } = suggestedDevEnvFile(ctx, detectedFramework);
if (!existing) {
return { envFile, envVar, existingFileContent: null };
}
const existingFileContent = ctx.fs.readUtf8File(envFile);
const config = dotenv.parse(existingFileContent);
const matching = Object.keys(config).filter((key) => EXPECTED_NAMES.has(key));
if (matching.length > 1) {
logWarning(
chalkStderr.yellow(
`Found multiple CONVEX_URL environment variables in ${envFile} so cannot update automatically.`
)
);
return null;
}
if (matching.length === 1) {
const [existingEnvVar, oldValue] = [matching[0], config[matching[0]]];
if (oldValue === value) {
return null;
}
if (oldValue !== "" && Object.values(config).filter((v) => v === oldValue).length !== 1) {
logWarning(
chalkStderr.yellow(
`Can't safely modify ${envFile}, please edit manually.`
)
);
return null;
}
return { envFile, envVar: existingEnvVar, existingFileContent };
}
return { envFile, envVar, existingFileContent };
}
function suggestedDevEnvFile(ctx, framework) {
if (ctx.fs.exists(".env.local")) {
return {
existing: true,
envFile: ".env.local"
};
}
if (framework === "Remix") {
return {
existing: ctx.fs.exists(".env"),
envFile: ".env"
};
}
return {
existing: ctx.fs.exists(".env.local"),
envFile: ".env.local"
};
}
const EXPECTED_NAMES = /* @__PURE__ */ new Set([
"CONVEX_URL",
"PUBLIC_CONVEX_URL",
"NEXT_PUBLIC_CONVEX_URL",
"VITE_CONVEX_URL",
"REACT_APP_CONVEX_URL",
"EXPO_PUBLIC_CONVEX_URL"
]);
export async function detectSuspiciousEnvironmentVariables(ctx, ignoreSuspiciousEnvVars = false) {
for (const [key, value] of Object.entries(process.env)) {
if (value === "" && key.startsWith("ey")) {
try {
const decoded = JSON.parse(
Buffer.from(key + "=", "base64").toString("utf8")
);
if (!("v2" in decoded)) {
continue;
}
} catch {
continue;
}
if (ignoreSuspiciousEnvVars) {
logWarning(
`ignoring suspicious environment variable ${key}, did you mean to use quotes like CONVEX_DEPLOY_KEY='...'?`
);
} else {
return await ctx.crash({
exitCode: 1,
errorType: "fatal",
printedMessage: `Quotes are required around environment variable values by your shell: CONVEX_DEPLOY_KEY='project:name:project|${key.slice(0, 4)}...${key.slice(key.length - 4)}=' npx convex dev`
});
}
}
}
}
export function getBuildEnvironment() {
return process.env.VERCEL ? "Vercel" : process.env.NETLIFY ? "Netlify" : false;
}
export function gitBranchFromEnvironment() {
if (process.env.VERCEL) {
return process.env.VERCEL_GIT_COMMIT_REF ?? null;
}
if (process.env.NETLIFY) {
return process.env.HEAD ?? null;
}
if (process.env.CI) {
return process.env.GITHUB_HEAD_REF ?? process.env.CI_COMMIT_REF_NAME ?? null;
}
return null;
}
export function isNonProdBuildEnvironment() {
if (process.env.VERCEL) {
return process.env.VERCEL_ENV !== "production";
}
if (process.env.NETLIFY) {
return process.env.CONTEXT !== "production";
}
return false;
}
//# sourceMappingURL=envvars.js.map