@samebase/convex-hosting 0.3.1 → 0.4.0

package/dist/cli/convex.d.ts

@@ -0,0 +1,63 @@
+import { type FunctionArgs, type FunctionReference, type FunctionReturnType, type FunctionType } from "convex/server";
+import type { z } from "zod";
+/** The processes and network calls of the CLI. Tests pass fakes. */
+export interface Cli {
+    /** The app's directory, with `convex/` and `.env.local`. */
+    cwd: string;
+    /** The process environment. */
+    env: Record<string, string | undefined>;
+    /** Runs the app's `convex` CLI and captures its output. */
+    convex: (args: string[]) => Promise<{
+        exitCode: number;
+        stdout: string;
+        stderr: string;
+    }>;
+    /** Runs the app's `convex` CLI with this process's standard streams; resolves with its exit code. */
+    convexInherited: (args: string[]) => Promise<number>;
+    /**
+     * Runs a shell command in `cwd` with this process's environment and standard streams; resolves
+     * with its exit code.
+     */
+    shell: (command: string) => Promise<number>;
+    fetch: typeof fetch;
+    /** Writes a line to standard error. */
+    log: (message: string) => void;
+}
+export declare const nodeCli: Cli;
+/** The deployment of a deploy: production by default, `--preview-name <name>`, or `--dev`. */
+export type Destination = {
+    kind: "production";
+} | {
+    kind: "preview";
+    name: string;
+} | {
+    kind: "dev";
+};
+/**
+ * The deployment selector of a deploy's `npx convex run` calls. Production gets `--prod`, because
+ * `npx convex deploy` goes to production by default while `npx convex run` goes to development; a
+ * preview gets `--preview-name <name>`; the development deployment, which `npx convex run` picks
+ * from `.env.local`, gets none. A deploy key in the environment wins over the selector. A
+ * self-hosted deployment takes no selector.
+ */
+export declare function deploymentSelector(cli: Cli, destination: Destination): string[];
+/** The component instance and the deployment that every call of one command reaches. */
+export type Target = {
+    component: string;
+    flags: string[];
+};
+/**
+ * Probes whether the deployment has the component instance: `undefined` when it has it, and the
+ * Convex CLI's output when it does not, which lists the components the deployment has. This probe
+ * exists because a function run against a missing component answers a generic
+ * `InternalServerError` ("Your request couldn't be completed"), while the Convex CLI's own
+ * component lookup for `--inline-query` prints `Component path "<name>" was not found.` The probe
+ * is an inline query that reads nothing. Any other failure is an error.
+ */
+export declare function probeComponent(cli: Cli, target: Target): Promise<string | undefined>;
+/**
+ * Runs a function of the component with `npx convex run` and validates its result. The Convex CLI
+ * prints the result as JSON from another process, so `result` checks it at runtime; its type makes
+ * the schema agree with the function's declared return. The CLI prints nothing for `null`.
+ */
+export declare function runComponent<Ref extends FunctionReference<FunctionType, "internal">>(cli: Cli, target: Target, ref: Ref, args: FunctionArgs<Ref>, result: z.ZodType<FunctionReturnType<Ref>>): Promise<FunctionReturnType<Ref>>;

package/dist/cli/convex.js

@@ -0,0 +1,108 @@
+import { execFile, spawn } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { parseEnv } from "node:util";
+import { getFunctionName, } from "convex/server";
+/** The app's own Convex CLI, so the CLI version and the deployment settings match the app. */
+function convexBin(cwd) {
+    const requireFromApp = createRequire(join(cwd, "package.json"));
+    return join(dirname(requireFromApp.resolve("convex/package.json")), "bin", "main.js");
+}
+export const nodeCli = {
+    cwd: process.cwd(),
+    env: process.env,
+    convex: (args) => new Promise((resolve) => {
+        execFile(process.execPath, [convexBin(process.cwd()), ...args], { encoding: "utf8" }, (error, stdout, stderr) => {
+            const exitCode = error === null ? 0 : typeof error.code === "number" ? error.code : 1;
+            resolve({ exitCode, stdout, stderr });
+        });
+    }),
+    convexInherited: (args) => exitCode(spawn(process.execPath, [convexBin(process.cwd()), ...args], { stdio: "inherit" })),
+    shell: (command) => exitCode(spawn(command, { shell: true, stdio: "inherit" })),
+    fetch: (input, init) => fetch(input, init),
+    log: (message) => console.error(message),
+};
+/** The exit code of `child`, or its spawn error. */
+function exitCode(child) {
+    return new Promise((resolve, reject) => {
+        child.on("error", reject).on("close", (code) => resolve(code ?? 1));
+    });
+}
+/**
+ * The variables that the Convex CLI reads to select a deployment, in its order: the process
+ * environment first, then `.env.local`, then `.env`.
+ */
+function readConvexEnv(cli) {
+    const fromFile = (name) => {
+        const path = join(cli.cwd, name);
+        return existsSync(path) ? parseEnv(readFileSync(path, "utf8")) : {};
+    };
+    return { ...fromFile(".env"), ...fromFile(".env.local"), ...cli.env };
+}
+/**
+ * The deployment selector of a deploy's `npx convex run` calls. Production gets `--prod`, because
+ * `npx convex deploy` goes to production by default while `npx convex run` goes to development; a
+ * preview gets `--preview-name <name>`; the development deployment, which `npx convex run` picks
+ * from `.env.local`, gets none. A deploy key in the environment wins over the selector. A
+ * self-hosted deployment takes no selector.
+ */
+export function deploymentSelector(cli, destination) {
+    if (readConvexEnv(cli).CONVEX_SELF_HOSTED_URL)
+        return [];
+    switch (destination.kind) {
+        case "production":
+            return ["--prod"];
+        case "preview":
+            return ["--preview-name", destination.name];
+        case "dev":
+            return [];
+        default:
+            return destination;
+    }
+}
+/**
+ * Probes whether the deployment has the component instance: `undefined` when it has it, and the
+ * Convex CLI's output when it does not, which lists the components the deployment has. This probe
+ * exists because a function run against a missing component answers a generic
+ * `InternalServerError` ("Your request couldn't be completed"), while the Convex CLI's own
+ * component lookup for `--inline-query` prints `Component path "<name>" was not found.` The probe
+ * is an inline query that reads nothing. Any other failure is an error.
+ */
+export async function probeComponent(cli, target) {
+    const { exitCode, stdout, stderr } = await cli.convex([
+        "run",
+        "--component",
+        target.component,
+        "--inline-query",
+        "null",
+        ...target.flags,
+    ]);
+    if (exitCode === 0)
+        return undefined;
+    const output = `${stderr}\n${stdout}`.trim();
+    if (output.includes(`Component path "${target.component}" was not found.`))
+        return output;
+    throw new Error(stderr.trim() || stdout.trim() || `npx convex run exited with ${exitCode}.`);
+}
+/**
+ * Runs a function of the component with `npx convex run` and validates its result. The Convex CLI
+ * prints the result as JSON from another process, so `result` checks it at runtime; its type makes
+ * the schema agree with the function's declared return. The CLI prints nothing for `null`.
+ */
+export async function runComponent(cli, target, ref, args, result) {
+    const functionName = getFunctionName(ref);
+    const { exitCode, stdout, stderr } = await cli.convex([
+        "run",
+        "--component",
+        target.component,
+        functionName,
+        JSON.stringify(args),
+        ...target.flags,
+    ]);
+    if (exitCode !== 0) {
+        throw new Error(stderr.trim() || stdout.trim() || `npx convex run ${functionName} exited with ${exitCode}.`);
+    }
+    return result.parse(stdout.trim() === "" ? null : JSON.parse(stdout));
+}
+//# sourceMappingURL=convex.js.map

package/dist/cli/convex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convex.js","sourceRoot":"","sources":["../../src/cli/convex.ts"],"names":[],"mappings":"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"}

package/dist/cli/files.d.ts

@@ -0,0 +1,18 @@
+import type { Config } from "../component/lib.js";
+export type HandlingOptions = Required<Pick<Config, "html_handling" | "not_found_handling">>;
+/** One file of the build: its URL path, its sha256 in hex, its content type, and its file on disk. */
+export type DistEntry = {
+    path: string;
+    sha256: string;
+    contentType: string | undefined;
+    file: string;
+};
+/**
+ * Reads the build in `dist` the way Wrangler reads an assets directory: every file that
+ * `.assetsignore` does not ignore, and the config from `_headers` and `_redirects`, parsed by
+ * Cloudflare's own parsers.
+ */
+export declare function readDist(dist: string, handling: HandlingOptions, log: (message: string) => void): Promise<{
+    config: Config;
+    entries: DistEntry[];
+}>;

package/dist/cli/files.js

@@ -0,0 +1,106 @@
+import { createHash } from "node:crypto";
+import { existsSync, readdirSync, readFileSync, realpathSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+import { constructHeaders, constructRedirects, } from "../workers-shared/utils/configuration/constructConfiguration.js";
+import { parseHeaders } from "../workers-shared/utils/configuration/parseHeaders.js";
+import { parseRedirects } from "../workers-shared/utils/configuration/parseRedirects.js";
+import { HEADERS_FILENAME, MAX_ASSET_SIZE, REDIRECTS_FILENAME, } from "../workers-shared/utils/constants.js";
+import { createAssetsIgnoreFunction, getContentType, maybeGetFile, normalizeFilePath, } from "../workers-shared/utils/helpers.js";
+/**
+ * Convex limits a document to 1 MiB. The version document holds the config next to two short
+ * fields, and the encoding needs room too.
+ */
+const MAX_CONFIG_BYTES = 900 * 1024;
+/**
+ * Reads the build in `dist` the way Wrangler reads an assets directory: every file that
+ * `.assetsignore` does not ignore, and the config from `_headers` and `_redirects`, parsed by
+ * Cloudflare's own parsers.
+ */
+export async function readDist(dist, handling, log) {
+    if (!existsSync(dist))
+        throw new Error(`The --dist folder ${dist} does not exist.`);
+    const { assetsIgnoreFunction } = await createAssetsIgnoreFunction(dist);
+    const entries = [];
+    // The real paths of the folders already walked. A link to a folder that is already included, for
+    // example a link to `dist` itself, would otherwise be walked without end.
+    const walked = new Set([realpathSync(dist)]);
+    const walk = (directory) => {
+        for (const name of readdirSync(directory)) {
+            const file = join(directory, name);
+            // A symbolic link counts as what it points to, as in Wrangler, which reads each path with
+            // `stat`. A name that `readdir` lists and `stat` cannot find is a link to nothing.
+            const stats = statSync(file, { throwIfNoEntry: false });
+            if (stats === undefined) {
+                log(`Skipped ${file}: a symbolic link to nothing.`);
+                continue;
+            }
+            // `ignore` takes paths relative to `dist` with `/`, and a directory with a trailing `/`.
+            const ignorePath = relative(dist, file).replaceAll("\\", "/");
+            if (stats.isDirectory()) {
+                // An ignored directory is not walked: gitignore rules cannot re-include a file in it. It
+                // does not count as walked either, so an ignored link does not hide the folder it points to.
+                if (assetsIgnoreFunction(`${ignorePath}/`))
+                    continue;
+                const real = realpathSync(file);
+                if (walked.has(real)) {
+                    log(`Skipped ${file}: a link to a folder that is already included.`);
+                    continue;
+                }
+                walked.add(real);
+                walk(file);
+            }
+            else if (stats.isFile() && !assetsIgnoreFunction(ignorePath)) {
+                const bytes = readFileSync(file);
+                // Cloudflare's limit per asset, 25 MiB. The HTTP action that serves a file cannot answer
+                // more than Convex's 100 MiB response limit anyway.
+                if (bytes.byteLength > MAX_ASSET_SIZE) {
+                    throw new Error(`${file} is ${(bytes.byteLength / 1024 / 1024).toFixed(1)} MiB. A file must stay at ` +
+                        "or below 25 MiB, Cloudflare's limit per asset.");
+                }
+                entries.push({
+                    path: normalizeFilePath(relative(dist, file)),
+                    sha256: createHash("sha256").update(bytes).digest("hex"),
+                    contentType: getContentType(file) ?? undefined,
+                    file,
+                });
+            }
+        }
+    };
+    walk(dist);
+    const logger = {
+        debug: () => { },
+        log,
+        info: log,
+        warn: log,
+        error: (error) => log(error.message),
+    };
+    const redirectsFile = join(dist, REDIRECTS_FILENAME);
+    const redirects = maybeGetFile(redirectsFile);
+    const headersFile = join(dist, HEADERS_FILENAME);
+    const headers = maybeGetFile(headersFile);
+    const config = {
+        html_handling: handling.html_handling,
+        not_found_handling: handling.not_found_handling,
+        ...(redirects === undefined
+            ? {}
+            : constructRedirects({
+                redirects: parseRedirects(redirects, { htmlHandling: handling.html_handling }),
+                redirectsFile,
+                logger,
+            })),
+        ...(headers === undefined
+            ? {}
+            : constructHeaders({ headers: parseHeaders(headers), headersFile, logger })),
+    };
+    const configBytes = Buffer.byteLength(JSON.stringify(config));
+    if (configBytes > MAX_CONFIG_BYTES) {
+        const largest = Buffer.byteLength(JSON.stringify(config.redirects ?? {})) >=
+            Buffer.byteLength(JSON.stringify(config.headers ?? {}))
+            ? redirectsFile
+            : headersFile;
+        throw new Error(`The rules in ${largest} make the version's config ${Math.ceil(configBytes / 1024)} KiB. ` +
+            "It must stay at or below 900 KiB, because Convex limits a document to 1 MiB.");
+    }
+    return { config, entries };
+}
+//# sourceMappingURL=files.js.map

package/dist/cli/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/cli/files.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.d.ts

@@ -1,12 +1,2 @@
 #!/usr/bin/env node
-/**
- * CLI for Convex Hosting
- *
- * Commands:
- *   deploy              One-shot deployment (Convex backend + static files)
- *   upload              Upload static files to Convex storage
- */
-declare const command: string;
-declare function main(): Promise<void>;
-declare function printHelp(): void;
-//# sourceMappingURL=index.d.ts.map
+export {};

package/dist/cli/index.js

@@ -1,60 +1,5 @@
 #!/usr/bin/env node
-"use strict";
-/**
- * CLI for Convex Hosting
- *
- * Commands:
- *   deploy              One-shot deployment (Convex backend + static files)
- *   upload              Upload static files to Convex storage
- */
-const command = process.argv[2];
-async function main() {
-    switch (command) {
-        case "deploy":
-            // Pass remaining args to deploy command
-            process.argv.splice(2, 1);
-            await import("./deploy.js");
-            break;
-        case "upload":
-            // Pass remaining args to upload command
-            process.argv.splice(2, 1);
-            await import("./upload.js");
-            break;
-        case "--help":
-        case "-h":
-        case undefined:
-            printHelp();
-            break;
-        default:
-            console.error(`Unknown command: ${command}`);
-            console.log("");
-            printHelp();
-            process.exit(1);
-    }
-}
-function printHelp() {
-    console.log(`
-Convex Hosting CLI
-
-Usage:
-  npx @samebase/convex-hosting <command> [options]
-
-Commands:
-  deploy              One-shot deployment (Convex backend + static files)
-  upload              Upload static files to Convex storage
-
-Examples:
-  # One-shot deployment
-  npx @samebase/convex-hosting deploy
-
-  # Upload only (no Convex backend deploy)
-  npx @samebase/convex-hosting upload --build --prod
-
-Run '<command> --help' for more information on a specific command.
-`);
-}
-main().catch((err) => {
-    console.error("Error:", err);
-    process.exit(1);
-});
+import { nodeCli } from "./convex.js";
+import { main } from "./main.js";
+process.exitCode = await main(process.argv.slice(2), nodeCli);
 //# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;AACA;;;;;;GAMG;AAEH,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEhC,KAAK,UAAU,IAAI;IACjB,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ;YACX,wCAAwC;YACxC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1B,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YAC5B,MAAM;QAER,KAAK,QAAQ;YACX,wCAAwC;YACxC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1B,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YAC5B,MAAM;QAER,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI,CAAC;QACV,KAAK,SAAS;YACZ,SAAS,EAAE,CAAC;YACZ,MAAM;QAER;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;CAkBb,CAAC,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC"}

package/dist/cli/main.d.ts

@@ -0,0 +1,5 @@
+import { type Cli } from "./convex.js";
+/** The file that the upload writes and the app's `convex/http.ts` imports. */
+export declare const VERSION_FILE: string;
+/** Runs one `convex-hosting` command and returns the exit code. */
+export declare function main(args: string[], cli: Cli): Promise<number>;