convex
Version:
Client for the Convex Cloud
192 lines (191 loc) • 9.74 kB
JavaScript
;
var __defProp = Object.defineProperty;
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
var __getOwnPropNames = Object.getOwnPropertyNames;
var __hasOwnProp = Object.prototype.hasOwnProperty;
var __export = (target, all) => {
for (var name in all)
__defProp(target, name, { get: all[name], enumerable: true });
};
var __copyProps = (to, from, except, desc) => {
if (from && typeof from === "object" || typeof from === "function") {
for (let key of __getOwnPropNames(from))
if (!__hasOwnProp.call(to, key) && key !== except)
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
}
return to;
};
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
var dev_exports = {};
__export(dev_exports, {
dev: () => dev
});
module.exports = __toCommonJS(dev_exports);
var import_extra_typings = require("@commander-js/extra-typings");
var import_context = require("../bundler/context.js");
var import_log = require("../bundler/log.js");
var import_configure = require("./configure.js");
var import_usage = require("./lib/usage.js");
var import_command = require("./lib/command.js");
var import_dev = require("./lib/dev.js");
var import_api = require("./lib/api.js");
var import_utils = require("./lib/utils/utils.js");
var import_deploymentSelection = require("./lib/deploymentSelection.js");
var import_envvars = require("./lib/envvars.js");
var import_updates = require("./lib/updates.js");
const dev = new import_extra_typings.Command("dev").summary("Develop against a dev deployment, watching for changes").description(
"Develop against a dev deployment, watching for changes\n\n 1. Configures a new or existing project (if needed)\n 2. Updates generated types and pushes code to the configured dev deployment\n 3. Runs the provided command (if `--run` or `--run-sh` is used)\n 4. Watches for file changes, and repeats step 2\n"
).allowExcessArguments(false).option("-v, --verbose", "Show full listing of changes").addOption(
new import_extra_typings.Option(
"--typecheck <mode>",
`Check TypeScript files with \`tsc --noEmit\`.`
).choices(["enable", "try", "disable"]).default("try")
).option(
"--typecheck-components",
"Check TypeScript files within component implementations with `tsc --noEmit`.",
false
).addOption(
new import_extra_typings.Option("--codegen <mode>", "Regenerate code in `convex/_generated/`").choices(["enable", "disable"]).default("enable")
).option(
"--once",
"Execute only the first 3 steps, stop on any failure",
false
).option(
"--until-success",
"Execute only the first 3 steps, on failure watch for local and remote changes and retry steps 2 and 3",
false
).addOption(
new import_extra_typings.Option(
"--run <functionName>",
"The identifier of the function to run in step 3, like `api.init.createData` or `myDir/myFile:myFunction`"
).conflicts(["--run-sh"])
).option(
"--run-component <functionName>",
"If --run is used and the function is in a component, the path the component tree defined in convex.config.ts. Components are a beta feature. This flag is unstable and may change in subsequent releases."
).addOption(
new import_extra_typings.Option(
"--run-sh <command>",
"A shell command to run in step 3, like `node myScript.js`. If you just want to run a Convex function, use `--run` instead."
).conflicts(["--run"])
).addOption(
new import_extra_typings.Option(
"--tail-logs [mode]",
"Choose whether to tail Convex function logs in this terminal"
).choices(["always", "pause-on-deploy", "disable"]).default("pause-on-deploy")
).addOption(new import_extra_typings.Option("--trace-events").default(false).hideHelp()).addOption(new import_extra_typings.Option("--debug-bundle-path <path>").hideHelp()).addOption(new import_extra_typings.Option("--debug-node-apis").hideHelp()).addOption(new import_extra_typings.Option("--live-component-sources").hideHelp()).addOption(
new import_extra_typings.Option(
"--configure [choice]",
"Ignore existing configuration and configure new or existing project, interactively or set by --team <team_slug>, --project <project_slug>, and --dev-deployment local|cloud"
).choices(["new", "existing"]).conflicts(["--local", "--cloud"])
).addOption(
new import_extra_typings.Option(
"--team <team_slug>",
"The team you'd like to use for this project"
).hideHelp()
).addOption(
new import_extra_typings.Option(
"--project <project_slug>",
"The name of the project you'd like to configure"
).hideHelp()
).addOption(
new import_extra_typings.Option(
"--dev-deployment <mode>",
"Use a local or cloud deployment for dev for this project"
).choices(["cloud", "local"]).conflicts(["--prod"]).hideHelp()
).addOption(
new import_extra_typings.Option(
"--prod",
"Develop live against this project's production deployment."
).default(false).hideHelp()
).addOption(
new import_extra_typings.Option(
"--env-file <envFile>",
`Path to a custom file of environment variables, for choosing the deployment, e.g. ${import_utils.CONVEX_DEPLOYMENT_ENV_VAR_NAME} or ${import_utils.CONVEX_SELF_HOSTED_URL_VAR_NAME}. Same format as .env.local or .env files, and overrides them.`
)
).addOption(new import_extra_typings.Option("--skip-push").default(false).hideHelp()).addOption(new import_extra_typings.Option("--admin-key <adminKey>").hideHelp()).addOption(new import_extra_typings.Option("--url <url>").hideHelp()).addOption(new import_extra_typings.Option("--override-auth-url <url>").hideHelp()).addOption(new import_extra_typings.Option("--override-auth-client <id>").hideHelp()).addOption(new import_extra_typings.Option("--override-auth-username <username>").hideHelp()).addOption(new import_extra_typings.Option("--override-auth-password <password>").hideHelp()).addOption(new import_extra_typings.Option("--local-cloud-port <port>").hideHelp()).addOption(new import_extra_typings.Option("--local-site-port <port>").hideHelp()).addOption(new import_extra_typings.Option("--local-backend-version <version>").hideHelp()).addOption(new import_extra_typings.Option("--local-force-upgrade").default(false).hideHelp()).addOption(
new import_extra_typings.Option(
"--local",
"Use local deployment regardless of last used backend. DB data will not be downloaded from any cloud deployment."
).default(false).conflicts(["--prod", "--url", "--admin-key", "--cloud"]).hideHelp()
).addOption(
new import_extra_typings.Option(
"--cloud",
"Use cloud deployment regardles of last used backend. DB data will not be uploaded from local."
).default(false).conflicts(["--prod", "--url", "--admin-key", "--local"]).hideHelp()
).showHelpAfterError().action(async (cmdOptions) => {
const ctx = await (0, import_context.oneoffContext)(cmdOptions);
process.on("SIGINT", async () => {
(0, import_log.logVerbose)("Received SIGINT, cleaning up...");
await ctx.flushAndExit(-2);
});
await (0, import_envvars.detectSuspiciousEnvironmentVariables)(
ctx,
!!process.env.CONVEX_IGNORE_SUSPICIOUS_ENV_VARS
);
const devOptions = await (0, import_command.normalizeDevOptions)(ctx, cmdOptions);
const selectionWithinProject = (0, import_api.deploymentSelectionWithinProjectFromOptions)(cmdOptions);
if (cmdOptions.configure === void 0) {
if (cmdOptions.team || cmdOptions.project || cmdOptions.devDeployment)
return await ctx.crash({
exitCode: 1,
errorType: "fatal",
printedMessage: "`--team, --project, and --dev-deployment can can only be used with `--configure`."
});
}
const localOptions = { forceUpgrade: false };
if (!cmdOptions.local && cmdOptions.devDeployment !== "local") {
if (cmdOptions.localCloudPort !== void 0 || cmdOptions.localSitePort !== void 0 || cmdOptions.localBackendVersion !== void 0 || cmdOptions.localForceUpgrade === true) {
return await ctx.crash({
exitCode: 1,
errorType: "fatal",
printedMessage: "`--local-*` options can only be used with `--configure --dev-deployment local` or `--local`."
});
}
} else {
if (cmdOptions.localCloudPort !== void 0) {
if (cmdOptions.localSitePort === void 0) {
return await ctx.crash({
exitCode: 1,
errorType: "fatal",
printedMessage: "`--local-cloud-port` requires `--local-site-port` to be set."
});
}
localOptions["ports"] = {
cloud: parseInt(cmdOptions.localCloudPort),
site: parseInt(cmdOptions.localSitePort)
};
}
localOptions["backendVersion"] = cmdOptions.localBackendVersion;
localOptions["forceUpgrade"] = cmdOptions.localForceUpgrade;
}
const configure = cmdOptions.configure === true ? "ask" : cmdOptions.configure ?? null;
const deploymentSelection = await (0, import_deploymentSelection.getDeploymentSelection)(ctx, cmdOptions);
const credentials = await (0, import_configure.deploymentCredentialsOrConfigure)(
ctx,
deploymentSelection,
configure,
{
...cmdOptions,
localOptions,
selectionWithinProject
}
);
await Promise.all([
...!cmdOptions.skipPush ? [
(0, import_dev.devAgainstDeployment)(
ctx,
{
url: credentials.url,
adminKey: credentials.adminKey,
deploymentName: credentials.deploymentFields?.deploymentName ?? null
},
devOptions
)
] : [],
...credentials.deploymentFields !== null ? [
(0, import_usage.usageStateWarning)(ctx, credentials.deploymentFields.deploymentName),
(0, import_updates.checkVersion)()
] : []
]);
});
//# sourceMappingURL=dev.js.map