@convex-dev/static-hosting 0.1.2-beta.0

package/dist/client/index.d.ts

@@ -0,0 +1,142 @@
+import type { HttpRouter } from "convex/server";
+import type { ComponentApi } from "../component/_generated/component.js";
+/**
+ * Get MIME type for a file path based on its extension.
+ */
+export declare function getMimeType(path: string): string;
+export declare function registerStaticRoutes(http: HttpRouter, component: ComponentApi, { pathPrefix, spaFallback, cdnBaseUrl, }?: {
+    pathPrefix?: string;
+    spaFallback?: boolean;
+    /** Base URL for CDN blob redirects (e.g., `(req) => \`${new URL(req.url).origin}/fs/blobs\``).
+     * When set, assets with a blobId (non-HTML) will return a 302 redirect to `{cdnBaseUrl}/{blobId}`. */
+    cdnBaseUrl?: string | ((request: Request) => string);
+}): void;
+/**
+ * Expose the upload API as INTERNAL functions for secure deployments.
+ * These functions can only be called via `npx convex run` or from other Convex functions.
+ *
+ * @param component - The component API reference
+ *
+ * @example
+ * ```typescript
+ * // In your convex/staticHosting.ts
+ * import { exposeUploadApi } from "@convex-dev/static-hosting";
+ * import { components } from "./_generated/api";
+ *
+ * export const { generateUploadUrl, recordAsset, gcOldAssets, listAssets } =
+ *   exposeUploadApi(components.staticHosting);
+ * ```
+ *
+ * Then deploy using:
+ * ```bash
+ * npm run deploy:static
+ * ```
+ */
+export declare function exposeUploadApi(component: ComponentApi): {
+    /**
+     * Generate a signed URL for uploading a file.
+     * Files are stored in the app's storage (not the component's).
+     */
+    generateUploadUrl: import("convex/server").RegisteredMutation<"internal", {}, Promise<string>>;
+    /**
+     * Record an uploaded asset in the database.
+     * Automatically cleans up old storage files when replacing.
+     * Pass storageId for Convex storage assets, or blobId for CDN assets.
+     */
+    recordAsset: import("convex/server").RegisteredMutation<"internal", {
+        blobId?: string | undefined;
+        storageId?: string | undefined;
+        path: string;
+        contentType: string;
+        deploymentId: string;
+    }, Promise<string | null>>;
+    /**
+     * Garbage collect old assets and notify clients of the new deployment.
+     * Returns the count of deleted assets.
+     * Also triggers connected clients to reload via the deployment subscription.
+     */
+    gcOldAssets: import("convex/server").RegisteredMutation<"internal", {
+        currentDeploymentId: string;
+    }, Promise<{
+        deleted: number;
+        blobIds: string[];
+    }>>;
+    /**
+     * Generate multiple signed upload URLs in one call.
+     * Much faster than calling generateUploadUrl N times.
+     */
+    generateUploadUrls: import("convex/server").RegisteredMutation<"internal", {
+        count: number;
+    }, Promise<string[]>>;
+    /**
+     * Record multiple uploaded assets in one call.
+     */
+    recordAssets: import("convex/server").RegisteredMutation<"internal", {
+        assets: {
+            path: string;
+            contentType: string;
+            deploymentId: string;
+            storageId: string;
+        }[];
+    }, Promise<void>>;
+    /**
+     * List all static assets (for debugging).
+     */
+    listAssets: import("convex/server").RegisteredQuery<"internal", {
+        limit?: number | undefined;
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        blobId?: string;
+        contentType: string;
+        deploymentId: string;
+        path: string;
+        storageId?: string;
+    }[]>>;
+};
+/**
+ * Expose a query that clients can subscribe to for live reload on deploy.
+ * When a new deployment happens, subscribed clients will be notified.
+ *
+ * @param component - The component API reference
+ *
+ * @example
+ * ```typescript
+ * // In your convex/staticHosting.ts
+ * import { exposeUploadApi, exposeDeploymentQuery } from "@convex-dev/static-hosting";
+ * import { components } from "./_generated/api";
+ *
+ * export const { generateUploadUrl, recordAsset, gcOldAssets, listAssets } =
+ *   exposeUploadApi(components.staticHosting);
+ *
+ * export const { getCurrentDeployment } = exposeDeploymentQuery(components.staticHosting);
+ * ```
+ */
+export declare function exposeDeploymentQuery(component: ComponentApi): {
+    /**
+     * Get the current deployment info.
+     * Subscribe to this query to detect when a new deployment happens.
+     */
+    getCurrentDeployment: import("convex/server").RegisteredQuery<"public", {}, Promise<{
+        _creationTime: number;
+        _id: string;
+        currentDeploymentId: string;
+        deployedAt: number;
+    } | null>>;
+};
+/**
+ * Derive the Convex cloud URL from a .convex.site hostname.
+ * Useful for client-side code that needs to connect to the Convex backend
+ * when hosted on Convex static hosting.
+ *
+ * @example
+ * ```typescript
+ * // In your React app's main.tsx
+ * import { getConvexUrl } from "@convex-dev/static-hosting";
+ *
+ * const convexUrl = import.meta.env.VITE_CONVEX_URL ?? getConvexUrl();
+ * const convex = new ConvexReactClient(convexUrl);
+ * ```
+ */
+export declare function getConvexUrl(): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAwGzE;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD;AAwDD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,YAAY,EACvB,EACE,UAAgB,EAChB,WAAkB,EAClB,UAAU,GACX,GAAE;IACD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;0GACsG;IACtG,UAAU,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,CAAC;CACjD,QA6IP;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,YAAY;IAEnD;;;OAGG;;IAQH;;;;OAIG;;;;;;;;IAgCH;;;;OAIG;;;;;;;IA8BH;;;OAGG;;;;IAYH;;OAEG;;;;;;;;;IAwBH;;OAEG;;;;;;;;;;;;EAYN;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,YAAY;IAEzD;;;OAGG;;;;;;;EAQN;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAarC"}

package/dist/client/index.js

@@ -0,0 +1,475 @@
+import { httpActionGeneric, internalMutationGeneric, internalQueryGeneric, queryGeneric, } from "convex/server";
+import { v } from "convex/values";
+// MIME type mapping for common file types
+const MIME_TYPES = {
+    ".html": "text/html; charset=utf-8",
+    ".js": "application/javascript; charset=utf-8",
+    ".mjs": "application/javascript; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".svg": "image/svg+xml",
+    ".ico": "image/x-icon",
+    ".webp": "image/webp",
+    ".woff": "font/woff",
+    ".woff2": "font/woff2",
+    ".ttf": "font/ttf",
+    ".txt": "text/plain; charset=utf-8",
+    ".map": "application/json",
+    ".webmanifest": "application/manifest+json",
+    ".xml": "application/xml",
+};
+/**
+ * Generate HTML page shown when no assets have been deployed yet.
+ */
+function getSetupHtml() {
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Convex Static Hosting</title>
+  <style>
+    * { box-sizing: border-box; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      max-width: 640px;
+      margin: 0 auto;
+      padding: 40px 20px;
+      background: #fafafa;
+      color: #333;
+      line-height: 1.6;
+    }
+    h1 { color: #111; margin-bottom: 8px; }
+    .subtitle { color: #666; margin-bottom: 32px; }
+    code {
+      background: #e8e8e8;
+      padding: 2px 6px;
+      border-radius: 4px;
+      font-size: 14px;
+    }
+    pre {
+      background: #1a1a1a;
+      color: #f0f0f0;
+      padding: 16px;
+      border-radius: 8px;
+      overflow-x: auto;
+      font-size: 14px;
+    }
+    .step { margin-bottom: 24px; }
+    .step-num {
+      display: inline-block;
+      background: #333;
+      color: white;
+      width: 24px;
+      height: 24px;
+      border-radius: 50%;
+      text-align: center;
+      font-size: 14px;
+      line-height: 24px;
+      margin-right: 8px;
+    }
+    a { color: #0070f3; }
+  </style>
+</head>
+<body>
+  <h1>Almost there!</h1>
+  <p class="subtitle">Your Convex backend is running, but no static files have been deployed yet.</p>
+
+  <div class="step">
+    <span class="step-num">1</span>
+    <strong>Build your frontend</strong>
+    <pre>npm run build</pre>
+  </div>
+
+  <div class="step">
+    <span class="step-num">2</span>
+    <strong>Deploy your static files</strong>
+    <pre>npx @convex-dev/static-hosting deploy</pre>
+  </div>
+
+  <p>Or deploy everything in one command:</p>
+  <pre>npm run deploy</pre>
+
+  <p style="margin-top: 32px; color: #666; font-size: 14px;">
+    Learn more at <a href="https://github.com/get-convex/static-hosting">github.com/get-convex/static-hosting</a>
+  </p>
+</body>
+</html>`;
+}
+/**
+ * Get MIME type for a file path based on its extension.
+ */
+export function getMimeType(path) {
+    const ext = path.substring(path.lastIndexOf(".")).toLowerCase();
+    return MIME_TYPES[ext] || "application/octet-stream";
+}
+/**
+ * Check if a path has a file extension.
+ */
+function hasFileExtension(path) {
+    const lastSegment = path.split("/").pop() || "";
+    return lastSegment.includes(".") && !lastSegment.startsWith(".");
+}
+/**
+ * Check if asset is a hashed asset (for cache control).
+ * Vite produces: index-lj_vq_aF.js, style-B71cUw87.css
+ */
+function isHashedAsset(path) {
+    return /[-.][\dA-Za-z_]{6,12}\.[a-z]+$/.test(path);
+}
+/**
+ * Register HTTP routes for serving static files.
+ * This creates a catch-all route that serves files from Convex storage
+ * with SPA fallback support.
+ *
+ * @param http - The HTTP router to register routes on
+ * @param component - The component API reference
+ * @param options - Configuration options
+ * @param options.pathPrefix - URL prefix for static files (default: "/")
+ * @param options.spaFallback - Enable SPA fallback to index.html (default: true)
+ *
+ * @example
+ * ```typescript
+ * // In your convex/http.ts
+ * import { httpRouter } from "convex/server";
+ * import { registerStaticRoutes } from "@convex-dev/static-hosting";
+ * import { components } from "./_generated/api";
+ *
+ * const http = httpRouter();
+ *
+ * // Serve static files at root
+ * registerStaticRoutes(http, components.staticHosting);
+ *
+ * // Or serve at a specific path prefix
+ * registerStaticRoutes(http, components.staticHosting, {
+ *   pathPrefix: "/app",
+ * });
+ *
+ * export default http;
+ * ```
+ */
+/**
+ * Check if a content type is HTML.
+ */
+function isHtmlContentType(contentType) {
+    return contentType.startsWith("text/html");
+}
+export function registerStaticRoutes(http, component, { pathPrefix = "/", spaFallback = true, cdnBaseUrl, } = {}) {
+    // Normalize pathPrefix - ensure it starts with / and doesn't end with /
+    const normalizedPrefix = pathPrefix === "/" ? "" : pathPrefix.replace(/\/$/, "");
+    const serveStaticFile = httpActionGeneric(async (ctx, request) => {
+        const url = new URL(request.url);
+        let path = url.pathname;
+        // Remove prefix if present
+        if (normalizedPrefix && path.startsWith(normalizedPrefix)) {
+            path = path.slice(normalizedPrefix.length) || "/";
+        }
+        // Normalize: serve index.html for root
+        if (path === "" || path === "/") {
+            path = "/index.html";
+        }
+        let asset = await ctx.runQuery(component.lib.getByPath, { path });
+        // SPA fallback: if not found and no file extension, serve index.html
+        if (!asset && spaFallback && !hasFileExtension(path)) {
+            asset = await ctx.runQuery(component.lib.getByPath, {
+                path: "/index.html",
+            });
+        }
+        // 404 if still not found
+        if (!asset) {
+            // If looking for index.html and it's not there, show setup instructions
+            if (path === "/index.html") {
+                return new Response(getSetupHtml(), {
+                    status: 200,
+                    headers: { "Content-Type": "text/html; charset=utf-8" },
+                });
+            }
+            return new Response("Not Found", {
+                status: 404,
+                headers: { "Content-Type": "text/plain" },
+            });
+        }
+        // CDN redirect: if asset has blobId, is not HTML, and cdnBaseUrl is configured
+        if (asset.blobId && cdnBaseUrl && !isHtmlContentType(asset.contentType)) {
+            const baseUrl = typeof cdnBaseUrl === "function" ? cdnBaseUrl(request) : cdnBaseUrl;
+            const redirectUrl = `${baseUrl.replace(/\/$/, "")}/${asset.blobId}`;
+            // Cache control for redirect: hashed assets can cache the redirect itself
+            const cacheControl = isHashedAsset(path)
+                ? "public, max-age=31536000, immutable"
+                : "public, max-age=0, must-revalidate";
+            return new Response(null, {
+                status: 302,
+                headers: {
+                    Location: redirectUrl,
+                    "Cache-Control": cacheControl,
+                },
+            });
+        }
+        // Serve from Convex storage
+        if (!asset.storageId) {
+            return new Response("Asset not available", {
+                status: 500,
+                headers: { "Content-Type": "text/plain" },
+            });
+        }
+        // Use storageId as ETag (unique per file content)
+        const etag = `"${asset.storageId}"`;
+        // Check for conditional request (If-None-Match)
+        const ifNoneMatch = request.headers.get("If-None-Match");
+        if (ifNoneMatch === etag) {
+            // Client has current version - return 304 Not Modified
+            return new Response(null, {
+                status: 304,
+                headers: {
+                    ETag: etag,
+                    "Cache-Control": isHashedAsset(path)
+                        ? "public, max-age=31536000, immutable"
+                        : "public, max-age=0, must-revalidate",
+                },
+            });
+        }
+        // Get file from storage
+        const blob = await ctx.storage.get(asset.storageId);
+        if (!blob) {
+            return new Response("Storage error", {
+                status: 500,
+                headers: { "Content-Type": "text/plain" },
+            });
+        }
+        // Cache control: hashed assets can be cached forever
+        const cacheControl = isHashedAsset(path)
+            ? "public, max-age=31536000, immutable"
+            : "public, max-age=0, must-revalidate";
+        return new Response(blob, {
+            status: 200,
+            headers: {
+                "Content-Type": asset.contentType,
+                "Cache-Control": cacheControl,
+                ETag: etag,
+                "X-Content-Type-Options": "nosniff",
+            },
+        });
+    });
+    // Use pathPrefix routing
+    http.route({
+        pathPrefix: pathPrefix === "/" ? "/" : `${normalizedPrefix}/`,
+        method: "GET",
+        handler: serveStaticFile,
+    });
+    // Also handle exact prefix without trailing slash
+    if (normalizedPrefix) {
+        http.route({
+            path: normalizedPrefix,
+            method: "GET",
+            handler: serveStaticFile,
+        });
+    }
+}
+/**
+ * Expose the upload API as INTERNAL functions for secure deployments.
+ * These functions can only be called via `npx convex run` or from other Convex functions.
+ *
+ * @param component - The component API reference
+ *
+ * @example
+ * ```typescript
+ * // In your convex/staticHosting.ts
+ * import { exposeUploadApi } from "@convex-dev/static-hosting";
+ * import { components } from "./_generated/api";
+ *
+ * export const { generateUploadUrl, recordAsset, gcOldAssets, listAssets } =
+ *   exposeUploadApi(components.staticHosting);
+ * ```
+ *
+ * Then deploy using:
+ * ```bash
+ * npm run deploy:static
+ * ```
+ */
+export function exposeUploadApi(component) {
+    return {
+        /**
+         * Generate a signed URL for uploading a file.
+         * Files are stored in the app's storage (not the component's).
+         */
+        generateUploadUrl: internalMutationGeneric({
+            args: {},
+            handler: async (ctx) => {
+                return await ctx.storage.generateUploadUrl();
+            },
+        }),
+        /**
+         * Record an uploaded asset in the database.
+         * Automatically cleans up old storage files when replacing.
+         * Pass storageId for Convex storage assets, or blobId for CDN assets.
+         */
+        recordAsset: internalMutationGeneric({
+            args: {
+                path: v.string(),
+                storageId: v.optional(v.string()),
+                blobId: v.optional(v.string()),
+                contentType: v.string(),
+                deploymentId: v.string(),
+            },
+            handler: async (ctx, args) => {
+                const { oldStorageId, oldBlobId } = await ctx.runMutation(component.lib.recordAsset, {
+                    path: args.path,
+                    ...(args.storageId ? { storageId: args.storageId } : {}),
+                    ...(args.blobId ? { blobId: args.blobId } : {}),
+                    contentType: args.contentType,
+                    deploymentId: args.deploymentId,
+                });
+                if (oldStorageId) {
+                    try {
+                        await ctx.storage.delete(oldStorageId);
+                    }
+                    catch {
+                        // Ignore - old file may have been in different storage
+                    }
+                }
+                // Return oldBlobId so caller can clean up CDN blobs if needed
+                return oldBlobId ?? null;
+            },
+        }),
+        /**
+         * Garbage collect old assets and notify clients of the new deployment.
+         * Returns the count of deleted assets.
+         * Also triggers connected clients to reload via the deployment subscription.
+         */
+        gcOldAssets: internalMutationGeneric({
+            args: {
+                currentDeploymentId: v.string(),
+            },
+            handler: async (ctx, args) => {
+                const { storageIds, blobIds } = await ctx.runMutation(component.lib.gcOldAssets, {
+                    currentDeploymentId: args.currentDeploymentId,
+                });
+                for (const storageId of storageIds) {
+                    try {
+                        await ctx.storage.delete(storageId);
+                    }
+                    catch {
+                        // Ignore - old file may have been in different storage
+                    }
+                }
+                // Update deployment info to trigger client reloads
+                await ctx.runMutation(component.lib.setCurrentDeployment, {
+                    deploymentId: args.currentDeploymentId,
+                });
+                // Return both counts and blobIds for CDN cleanup
+                return { deleted: storageIds.length, blobIds };
+            },
+        }),
+        /**
+         * Generate multiple signed upload URLs in one call.
+         * Much faster than calling generateUploadUrl N times.
+         */
+        generateUploadUrls: internalMutationGeneric({
+            args: { count: v.number() },
+            handler: async (ctx, { count }) => {
+                const urls = [];
+                for (let i = 0; i < count; i++) {
+                    urls.push(await ctx.storage.generateUploadUrl());
+                }
+                return urls;
+            },
+        }),
+        /**
+         * Record multiple uploaded assets in one call.
+         */
+        recordAssets: internalMutationGeneric({
+            args: {
+                assets: v.array(v.object({
+                    path: v.string(),
+                    storageId: v.string(),
+                    contentType: v.string(),
+                    deploymentId: v.string(),
+                })),
+            },
+            handler: async (ctx, { assets }) => {
+                for (const asset of assets) {
+                    await ctx.runMutation(component.lib.recordAsset, {
+                        path: asset.path,
+                        storageId: asset.storageId,
+                        contentType: asset.contentType,
+                        deploymentId: asset.deploymentId,
+                    });
+                }
+            },
+        }),
+        /**
+         * List all static assets (for debugging).
+         */
+        listAssets: internalQueryGeneric({
+            args: {
+                limit: v.optional(v.number()),
+            },
+            handler: async (ctx, args) => {
+                return await ctx.runQuery(component.lib.listAssets, {
+                    limit: args.limit,
+                });
+            },
+        }),
+    };
+}
+/**
+ * Expose a query that clients can subscribe to for live reload on deploy.
+ * When a new deployment happens, subscribed clients will be notified.
+ *
+ * @param component - The component API reference
+ *
+ * @example
+ * ```typescript
+ * // In your convex/staticHosting.ts
+ * import { exposeUploadApi, exposeDeploymentQuery } from "@convex-dev/static-hosting";
+ * import { components } from "./_generated/api";
+ *
+ * export const { generateUploadUrl, recordAsset, gcOldAssets, listAssets } =
+ *   exposeUploadApi(components.staticHosting);
+ *
+ * export const { getCurrentDeployment } = exposeDeploymentQuery(components.staticHosting);
+ * ```
+ */
+export function exposeDeploymentQuery(component) {
+    return {
+        /**
+         * Get the current deployment info.
+         * Subscribe to this query to detect when a new deployment happens.
+         */
+        getCurrentDeployment: queryGeneric({
+            args: {},
+            handler: async (ctx) => {
+                return await ctx.runQuery(component.lib.getCurrentDeployment, {});
+            },
+        }),
+    };
+}
+/**
+ * Derive the Convex cloud URL from a .convex.site hostname.
+ * Useful for client-side code that needs to connect to the Convex backend
+ * when hosted on Convex static hosting.
+ *
+ * @example
+ * ```typescript
+ * // In your React app's main.tsx
+ * import { getConvexUrl } from "@convex-dev/static-hosting";
+ *
+ * const convexUrl = import.meta.env.VITE_CONVEX_URL ?? getConvexUrl();
+ * const convex = new ConvexReactClient(convexUrl);
+ * ```
+ */
+export function getConvexUrl() {
+    if (typeof window === "undefined") {
+        throw new Error("getConvexUrl() can only be called in a browser context");
+    }
+    // If hosted on Convex (.convex.site), derive API URL (.convex.cloud)
+    if (window.location.hostname.endsWith(".convex.site")) {
+        return `https://${window.location.hostname.replace(".convex.site", ".convex.cloud")}`;
+    }
+    throw new Error("Unable to derive Convex URL. Please set VITE_CONVEX_URL environment variable.");
+}
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

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

package/dist/client/next.d.ts

@@ -0,0 +1,38 @@
+import type { FunctionReference, HttpRouter } from "convex/server";
+import type { ComponentApi } from "../component/_generated/component.js";
+/**
+ * Register HTTP routes for serving a Next.js app via Convex HTTP actions.
+ *
+ * Static assets (`/_next/static/*`) are served directly from Convex storage
+ * (V8 runtime, instant). All other requests are forwarded to a Node.js action
+ * that runs NextServer.
+ *
+ * @param http - The HTTP router to register routes on
+ * @param component - The component API reference (for storage lookups)
+ * @param actionRef - Reference to the generated `handle` action
+ * @param options - Configuration options
+ * @param options.pathPrefix - URL prefix (default: "/")
+ *
+ * @example
+ * ```typescript
+ * // convex/http.ts
+ * import { httpRouter } from "convex/server";
+ * import { registerNextRoutes } from "@convex-dev/static-hosting/next";
+ * import { components, internal } from "./_generated/api";
+ *
+ * const http = httpRouter();
+ * registerNextRoutes(http, components.staticHosting, internal._generatedNextServer.handle);
+ * export default http;
+ * ```
+ */
+export declare function registerNextRoutes(http: HttpRouter, component: ComponentApi, actionRef: FunctionReference<"action", "internal", Record<string, unknown>, unknown>, { pathPrefix, warmup, }?: {
+    pathPrefix?: string;
+    /** Inject a warmup script into static HTML pages to pre-boot the Node.js
+     *  NextServer in the background. Defaults to true. */
+    warmup?: boolean;
+}): void;
+/**
+ * Get the MIME type for a file path.
+ */
+export declare function getNextMimeType(filePath: string): string;
+//# sourceMappingURL=next.d.ts.map

package/dist/client/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../src/client/next.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAqBzE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,YAAY,EACvB,SAAS,EAAE,iBAAiB,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EACpF,EACE,UAAgB,EAChB,MAAa,GACd,GAAE;IACD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;0DACsD;IACtD,MAAM,CAAC,EAAE,OAAO,CAAC;CACb,QA0JP;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGxD"}