@samebase/convex-hosting 0.3.1 → 0.4.0

package/dist/cli/main.js

@@ -0,0 +1,346 @@
+import { randomUUID } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { parseArgs } from "node:util";
+import { z } from "zod";
+import { internal } from "../component/_generated/api.js";
+import { AssetConfigSchema } from "../workers-shared/utils/types.js";
+import { deploymentSelector, probeComponent, runComponent, } from "./convex.js";
+import { readDist } from "./files.js";
+const USAGE = `Usage:
+  convex-hosting deploy --build "<command>" --dist <dir> [options]
+
+Options:
+  --dev                         the development deployment of this checkout, instead of production
+  --preview-name <name>         the preview deployment with this name, instead of production
+  --html-handling <value>       auto-trailing-slash (default), force-trailing-slash,
+                                drop-trailing-slash, or none
+  --not-found-handling <value>  none (default), single-page-application, or 404-page
+  --component <name>            the component instance (default: hosting)
+  -h, --help                    this text`;
+/**
+ * The CLI's state folder at the project root, like Wrangler's `.wrangler/`. It holds its own
+ * `.gitignore`, so git ignores it without a line in the app's ignore file.
+ */
+const STATE_DIR = ".convex-hosting";
+/** The file that the upload writes and the app's `convex/http.ts` imports. */
+export const VERSION_FILE = join(STATE_DIR, "version.js");
+/**
+ * The inner `upload` of a first install writes this file when the component is not installed yet.
+ * `deploy` then uploads after the push.
+ */
+const FIRST_INSTALL_MARKER = join(STATE_DIR, "first-install");
+/** Files that the upload sends to storage at once. */
+const UPLOAD_CONCURRENCY = 4;
+/**
+ * Files per page of uploads. A page's upload URLs are made together, and its entries are recorded
+ * before the next page starts, so a retry after a crash reuses them.
+ */
+const UPLOAD_PAGE = 100;
+/**
+ * `npx convex run` passes the arguments on the command line, which Windows limits to 32,767
+ * characters; `knownFiles` and `recordFiles` calls stay well below that. The component counts
+ * what a call of this length reads and writes.
+ */
+const MAX_ARGUMENT_LENGTH = 8_000;
+const htmlHandlingSchema = AssetConfigSchema.shape.html_handling.unwrap();
+const notFoundHandlingSchema = AssetConfigSchema.shape.not_found_handling.unwrap();
+function parseCommand(args) {
+    const { values, positionals } = parseArgs({
+        args,
+        allowPositionals: true,
+        strict: true,
+        options: {
+            build: { type: "string" },
+            dist: { type: "string" },
+            dev: { type: "boolean", default: false },
+            "preview-name": { type: "string" },
+            "html-handling": { type: "string", default: "auto-trailing-slash" },
+            "not-found-handling": { type: "string", default: "none" },
+            component: { type: "string", default: "hosting" },
+            "version-id": { type: "string" },
+            help: { type: "boolean", short: "h", default: false },
+        },
+    });
+    if (args.length === 0 || values.help)
+        return { name: "help" };
+    const [name, ...rest] = positionals;
+    if ((name !== "deploy" && name !== "upload") || rest.length > 0)
+        throw new Error(USAGE);
+    if (values.dist === undefined)
+        throw new Error(`--dist is required.\n\n${USAGE}`);
+    if (values.dev && values["preview-name"] !== undefined) {
+        throw new Error("--dev and --preview-name exclude each other.");
+    }
+    const htmlHandling = htmlHandlingSchema.safeParse(values["html-handling"]);
+    if (!htmlHandling.success) {
+        throw new Error(`--html-handling must be one of: ${htmlHandlingSchema.options.join(", ")}.`);
+    }
+    const notFoundHandling = notFoundHandlingSchema.safeParse(values["not-found-handling"]);
+    if (!notFoundHandling.success) {
+        throw new Error(`--not-found-handling must be one of: ${notFoundHandlingSchema.options.join(", ")}.`);
+    }
+    const options = {
+        dist: values.dist,
+        html_handling: htmlHandling.data,
+        not_found_handling: notFoundHandling.data,
+        component: values.component,
+        destination: values.dev
+            ? { kind: "dev" }
+            : values["preview-name"] === undefined
+                ? { kind: "production" }
+                : { kind: "preview", name: values["preview-name"] },
+    };
+    // `upload` is the step that `deploy` runs inside `npx convex deploy --cmd`, after the build.
+    if (name === "upload") {
+        if (values["version-id"] === undefined || values.build !== undefined || values.dev) {
+            throw new Error(USAGE);
+        }
+        return { name, versionId: values["version-id"], options };
+    }
+    if (values.build === undefined)
+        throw new Error(`--build is required.\n\n${USAGE}`);
+    if (values["version-id"] !== undefined)
+        throw new Error(USAGE);
+    return { name, build: values.build, options };
+}
+/** Runs one `convex-hosting` command and returns the exit code. */
+export async function main(args, cli) {
+    try {
+        const command = parseCommand(args);
+        if (command.name === "help") {
+            cli.log(USAGE);
+        }
+        else if (command.name === "deploy") {
+            await deploy(cli, command.options, command.build);
+        }
+        else {
+            await uploadInsideDeploy(cli, command.options, command.versionId);
+        }
+        return 0;
+    }
+    catch (error) {
+        cli.log(error instanceof Error ? error.message : String(error));
+        return 1;
+    }
+}
+/** Quotes one argument of the `--cmd` that `npx convex deploy` runs in a shell. */
+function quote(arg) {
+    return process.platform === "win32" ? `"${arg}"` : `'${arg.replaceAll("'", `'\\''`)}'`;
+}
+/**
+ * Builds, uploads, writes the version file, and pushes. The push is the switch, and the command
+ * ends: the first request that the new code serves marks its version live.
+ */
+async function deploy(cli, options, build) {
+    const target = {
+        component: options.component,
+        flags: deploymentSelector(cli, options.destination),
+    };
+    const versionId = randomUUID();
+    if (options.destination.kind === "dev") {
+        await deployDev(cli, options, target, versionId, build);
+    }
+    else {
+        await deployWithConvexDeploy(cli, options, target, versionId, build);
+    }
+    cli.log(`Deployed version ${versionId}.`);
+}
+/**
+ * The development deployment, in one process. The build runs as a child of this process in the
+ * project directory: the framework reads the deployment's URL from `.env.local` itself (Vite reads
+ * `VITE_CONVEX_URL`). Then the upload runs here, and `npx convex run --push` pushes, with an inline
+ * query at the app's root, which exists before the push installs the component. It works whether
+ * or not `npx convex dev` runs; `npx convex dev --once` refuses while it runs a local deployment's
+ * backend.
+ */
+async function deployDev(cli, options, target, versionId, build) {
+    const buildExitCode = await cli.shell(build);
+    if (buildExitCode !== 0)
+        throw new Error(`The build failed with exit code ${buildExitCode}.`);
+    const missing = await upload(cli, options, target, versionId);
+    if (missing !== undefined)
+        cli.log(notInstalledYet(options.component));
+    const exitCode = await cli.convexInherited(["run", "--push", "--inline-query", "null"]);
+    if (exitCode !== 0)
+        throw new Error(`npx convex run --push failed with exit code ${exitCode}.`);
+    if (missing !== undefined)
+        await uploadAfterPush(cli, options, target, versionId);
+}
+/** Production or a preview: the build and the upload run inside `npx convex deploy --cmd`. */
+async function deployWithConvexDeploy(cli, options, target, versionId, build) {
+    const marker = join(cli.cwd, FIRST_INSTALL_MARKER);
+    rmSync(marker, { force: true });
+    // `npx convex deploy` goes to production by default and has no `--prod` flag.
+    const deployFlags = target.flags.filter((flag) => flag !== "--prod");
+    const previewFlags = options.destination.kind === "preview" ? ["--preview-name", options.destination.name] : [];
+    const innerUpload = [
+        process.execPath,
+        fileURLToPath(new URL("./index.js", import.meta.url)),
+        "upload",
+        "--dist",
+        options.dist,
+        "--version-id",
+        versionId,
+        "--html-handling",
+        options.html_handling,
+        "--not-found-handling",
+        options.not_found_handling,
+        "--component",
+        options.component,
+        ...previewFlags,
+    ]
+        .map(quote)
+        .join(" ");
+    // The build and the upload run in the project directory; a build must not change directory.
+    const exitCode = await cli.convexInherited([
+        "deploy",
+        "--cmd",
+        `${build} && ${innerUpload}`,
+        ...deployFlags,
+    ]);
+    const firstInstall = existsSync(marker);
+    rmSync(marker, { force: true });
+    if (exitCode !== 0)
+        throw new Error(`npx convex deploy failed with exit code ${exitCode}.`);
+    if (firstInstall)
+        await uploadAfterPush(cli, options, target, versionId);
+}
+/** The upload inside `npx convex deploy --cmd`. On a first install, `deploy` uploads after the push. */
+async function uploadInsideDeploy(cli, options, versionId) {
+    const target = {
+        component: options.component,
+        flags: deploymentSelector(cli, options.destination),
+    };
+    if ((await upload(cli, options, target, versionId)) !== undefined) {
+        writeStateFile(cli, FIRST_INSTALL_MARKER, "");
+        cli.log(notInstalledYet(options.component));
+    }
+}
+function notInstalledYet(component) {
+    return `The component "${component}" is not installed yet. The push installs it, and the upload runs after the push.`;
+}
+/** The upload of a first install, after the push. The probe's output shows a mistyped `--component`. */
+async function uploadAfterPush(cli, options, target, versionId) {
+    const missing = await upload(cli, options, target, versionId);
+    if (missing !== undefined) {
+        throw new Error(`The component "${options.component}" is not installed after the push. The Convex CLI ` +
+            `said:\n${missing}`);
+    }
+}
+/**
+ * Uploads `--dist` as version `versionId` and writes the version file. When the component is not
+ * installed yet, it writes only the version file, so that the push that follows installs the
+ * component, and returns the probe's output.
+ */
+async function upload(cli, options, target, versionId) {
+    const dist = resolve(cli.cwd, options.dist);
+    const { config, entries } = await readDist(dist, options, cli.log);
+    const generateUploadUrls = (count) => runComponent(cli, target, internal.lib.generateUploadUrls, { count }, z.array(z.string()).length(count));
+    const missing = await probeComponent(cli, target);
+    if (missing !== undefined) {
+        writeVersionFile(cli, versionId);
+        return missing;
+    }
+    cli.log(`Uploading version ${versionId}: ${entries.length} files.`);
+    const [configUrl] = await generateUploadUrls(1);
+    const configId = await store(cli, configUrl, JSON.stringify(config), "application/json");
+    await runComponent(cli, target, internal.lib.createVersion, { versionId, configId }, z.null());
+    // Entries with the same bytes share one stored file.
+    const groups = new Map();
+    for (const entry of entries) {
+        groups.set(entry.sha256, [...(groups.get(entry.sha256) ?? []), entry]);
+    }
+    /** Sends the complete entries of stored files, in batches that fit a command line. */
+    const record = async (stored) => {
+        const complete = stored.flatMap(({ sha256, storageId }) => (groups.get(sha256) ?? []).map(({ path, contentType }) => ({
+            path,
+            sha256,
+            contentType,
+            storageId,
+        })));
+        for (const chunk of chunkByLength(complete)) {
+            await runComponent(cli, target, internal.lib.recordFiles, { versionId, entries: chunk }, z.null());
+        }
+    };
+    // Files that an entry of any version has keep their stored file.
+    const known = new Set();
+    for (const sha256s of chunkByLength([...groups.keys()])) {
+        const files = await runComponent(cli, target, internal.lib.knownFiles, { sha256s }, z.array(z.object({ sha256: z.string(), storageId: storageIdSchema })));
+        for (const { sha256 } of files)
+            known.add(sha256);
+        await record(files);
+    }
+    const unknown = [...groups.values()].filter((group) => !known.has(group[0].sha256));
+    for (let start = 0; start < unknown.length; start += UPLOAD_PAGE) {
+        const page = unknown.slice(start, start + UPLOAD_PAGE);
+        const urls = await generateUploadUrls(page.length);
+        const uploaded = [];
+        let next = 0;
+        const worker = async () => {
+            while (next < page.length) {
+                const index = next++;
+                const [{ sha256, contentType, file }] = page[index];
+                const storageId = await store(cli, urls[index], readFileSync(file), contentType);
+                uploaded.push({ sha256, storageId });
+            }
+        };
+        await Promise.all(Array.from({ length: UPLOAD_CONCURRENCY }, worker));
+        await record(uploaded);
+    }
+    await runComponent(cli, target, internal.lib.finishVersion, { versionId }, z.null());
+    writeVersionFile(cli, versionId);
+    cli.log(`Uploaded version ${versionId} and wrote ${VERSION_FILE}.`);
+    return undefined;
+}
+function writeVersionFile(cli, versionId) {
+    writeStateFile(cli, VERSION_FILE, `export const versionId = ${JSON.stringify(versionId)};\n`);
+}
+/** Writes a file of the state folder, and the folder's `.gitignore` when it is absent. */
+function writeStateFile(cli, path, body) {
+    const gitignore = join(cli.cwd, STATE_DIR, ".gitignore");
+    if (!existsSync(gitignore)) {
+        mkdirSync(join(cli.cwd, STATE_DIR), { recursive: true });
+        writeFileSync(gitignore, "*\n");
+    }
+    writeFileSync(join(cli.cwd, path), body);
+}
+/** Stores one file through an upload URL and returns its storage id. */
+async function store(cli, url, body, contentType) {
+    const response = await cli.fetch(url, {
+        method: "POST",
+        headers: contentType === undefined ? {} : { "Content-Type": contentType },
+        body,
+    });
+    if (!response.ok) {
+        throw new Error(`Storing a file failed with ${response.status}: ${await response.text()}`);
+    }
+    return z.object({ storageId: storageIdSchema }).parse(await response.json()).storageId;
+}
+/**
+ * A storage id that an upload URL answers with, the documented source of an `Id<"_storage">`, or
+ * that `knownFiles` returns. At runtime an id is a string, and its table exists only in its type,
+ * so the narrowest honest check here is that it is a string; the `v.id("_storage")` validators of
+ * `createVersion` and `recordFiles` check the table on the server.
+ */
+const storageIdSchema = z.custom((value) => typeof value === "string");
+function chunkByLength(items) {
+    const chunks = [];
+    let chunk = [];
+    let length = 0;
+    for (const item of items) {
+        const itemLength = JSON.stringify(item).length + 1;
+        if (chunk.length > 0 && length + itemLength > MAX_ARGUMENT_LENGTH) {
+            chunks.push(chunk);
+            chunk = [];
+            length = 0;
+        }
+        chunk.push(item);
+        length += itemLength;
+    }
+    if (chunk.length > 0)
+        chunks.push(chunk);
+    return chunks;
+}
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

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

package/dist/client/index.d.ts

@@ -1,119 +1,12 @@
-import { type GenericActionCtx, type GenericDataModel, type HttpRouter } from "convex/server";
+import type { GenericActionCtx, GenericDataModel } from "convex/server";
 import type { ComponentApi } from "../component/_generated/component.js";
-import { decodeRequestPath } from "../component/serving.js";
-type CdnBaseUrl = string | ((request: Request) => string);
-/** The parts of an action context needed to serve a static file. */
-type AssetServingCtx = Pick<GenericActionCtx<GenericDataModel>, "runQuery" | "storage">;
 /**
- * Register app-owned HTTP routes for the hosted site.
+ * Answers `request` with the asset of version `versionId` that Cloudflare's asset handler picks.
  *
- * Prefer mounting the component's own HTTP routes when it can own the URL
- * prefix. Use this compatibility mode when existing app HTTP routes must stay
- * at the same root. Exact app routes take precedence over this catch-all.
- * Assets and deployment state still live in the component.
- *
- * @example
- * ```typescript
- * // convex/convex.config.ts
- * const app = defineApp();
- * app.use(hosting); // no httpPrefix: the app owns HTTP routing
- *
- * // convex/http.ts
- * const http = httpRouter();
- * auth.addHttpRoutes(http);
- * registerStaticRoutes(http, components.hosting);
- * export default http;
- * ```
- */
-export declare function registerStaticRoutes(http: HttpRouter, component: ComponentApi, { pathPrefix, spaFallback, cdnBaseUrl, }?: {
-    /** URL prefix where the app should serve static files. */
-    pathPrefix?: string;
-    /** Override the deployment's SPA fallback setting. */
-    spaFallback?: boolean;
-    /** Optional custom base URL for convex-fs blob redirects. */
-    cdnBaseUrl?: CdnBaseUrl;
-}): void;
-/**
- * Serve an uploaded static file from your own HTTP action, or return null when
- * no file matches so the action can continue with its own routing: server
- * rendering, prerendered pages, redirects.
- *
- * Found files get the same response as `registerStaticRoutes`: content type,
- * cache headers, ETag revalidation, and legacy CDN redirects. A found file
- * whose storage can't be read gets a 500 response. A request path with
- * malformed percent-encoding matches no file, so it returns null.
- *
- * The lookup is exact by default. `/` is not mapped to `/index.html`, and there
- * is no SPA fallback, so the SPA shell never answers for a route your action
- * handles. To serve the shell, pass `{ path: "/index.html" }`. When your route
- * has a prefix, pass `path` with the prefix removed.
- *
- * @example
- * ```typescript
- * // convex/http.ts
- * const http = httpRouter();
- * http.route({
- *   pathPrefix: "/",
- *   method: "GET",
- *   handler: httpAction(async (ctx, request) => {
- *     const file = await serveStaticAsset(ctx, components.hosting, request);
- *     if (file) return file;
- *     return await renderPage(request);
- *   }),
- * });
- * export default http;
- * ```
- */
-export declare function serveStaticAsset(ctx: AssetServingCtx, component: ComponentApi, request: Request, { path, spaFallback, cdnBaseUrl, }?: {
-    /**
-     * Decoded file path to look up, starting with `/`, such as
-     * `/about/index.html`. Defaults to the decoded request path.
-     */
-    path?: string;
-    /** Serve `/index.html` for a missing path without a file extension. */
-    spaFallback?: boolean;
-    /** Optional custom base URL for convex-fs blob redirects. */
-    cdnBaseUrl?: CdnBaseUrl;
-}): Promise<Response | null>;
-export { decodeRequestPath };
-/**
- * Expose a query that clients can subscribe to for live reload on deploy.
- * This is only needed if you use `UpdateBanner` / `useDeploymentUpdates` from
- * `@samebase/convex-hosting/react`. If you don't surface deployment updates
- * in your app, you don't need to call this.
- *
- * @example
- * ```typescript
- * // convex/hosting.ts
- * import { exposeDeploymentQuery } from "@samebase/convex-hosting";
- * import { components } from "./_generated/api";
- *
- * export const { getCurrentDeployment } = exposeDeploymentQuery(
- *   components.hosting,
- * );
- * ```
- */
-export declare function exposeDeploymentQuery(component: ComponentApi): {
-    getCurrentDeployment: import("convex/server").RegisteredQuery<"public", {}, Promise<{
-        _creationTime: number;
-        _id: string;
-        currentDeploymentId: string;
-        deployedAt: number;
-        spaFallback?: boolean;
-    } | null>>;
-};
-/**
- * Derive the Convex cloud URL from a `.convex.site` hostname.
- * Useful when your frontend is served by this component and needs
- * to connect to its own Convex backend without an explicit env var.
- *
- * @example
- * ```typescript
- * import { getConvexUrl } from "@samebase/convex-hosting";
- *
- * const convexUrl = import.meta.env.VITE_CONVEX_URL ?? getConvexUrl();
- * const convex = new ConvexReactClient(convexUrl);
- * ```
+ * Returns `null` when no asset matches, so the app continues (a static site answers 404, a
+ * server-rendered site renders the page). A version that does not exist, is still uploading, or
+ * is being deleted answers 404, so a half-installed site does not render pages without their
+ * files. The first request for a `ready` version marks it live, which deletes the versions that
+ * were live before it.
  */
-export declare function getConvexUrl(): string;
-//# sourceMappingURL=index.d.ts.map
+export declare function serveAsset(ctx: Pick<GenericActionCtx<GenericDataModel>, "runQuery" | "runMutation">, component: ComponentApi, request: Request, versionId: string): Promise<Response | null>;