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

package/dist/component/convex.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("convex/server").ComponentDefinition<any>;
+export default _default;
+//# sourceMappingURL=convex.config.d.ts.map

package/dist/component/convex.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convex.config.d.ts","sourceRoot":"","sources":["../../src/component/convex.config.ts"],"names":[],"mappings":";AAEA,wBAAgD"}

package/dist/component/convex.config.js

@@ -0,0 +1,3 @@
+import { defineComponent } from "convex/server";
+export default defineComponent("staticHosting");
+//# sourceMappingURL=convex.config.js.map

package/dist/component/convex.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convex.config.js","sourceRoot":"","sources":["../../src/component/convex.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,eAAe,eAAe,CAAC,eAAe,CAAC,CAAC"}

package/dist/component/lib.d.ts

@@ -0,0 +1,88 @@
+import { v } from "convex/values";
+/**
+ * Look up an asset by its URL path.
+ */
+export declare const getByPath: import("convex/server").RegisteredQuery<"public", {
+    path: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"staticAssets">;
+    _creationTime: number;
+    blobId?: string | undefined;
+    storageId?: import("convex/values").GenericId<"_storage"> | undefined;
+    path: string;
+    contentType: string;
+    deploymentId: string;
+} | null>>;
+/**
+ * Generate a signed URL for uploading a file to Convex storage.
+ * Note: This is kept for backwards compatibility but the recommended approach
+ * is to use the app's storage directly via exposeUploadApi().
+ */
+export declare const generateUploadUrl: import("convex/server").RegisteredMutation<"public", {}, Promise<string>>;
+/**
+ * Record an asset in the database after uploading to storage.
+ * If an asset already exists at this path, returns the old storageId for cleanup.
+ *
+ * Note: Storage files are stored in the app's storage, not the component's storage.
+ * The caller is responsible for deleting the returned storageId from app storage.
+ */
+export declare const recordAsset: import("convex/server").RegisteredMutation<"public", {
+    blobId?: string | undefined;
+    storageId?: import("convex/values").GenericId<"_storage"> | undefined;
+    path: string;
+    contentType: string;
+    deploymentId: string;
+}, Promise<{
+    oldStorageId: import("convex/values").GenericId<"_storage"> | null;
+    oldBlobId: string | null;
+}>>;
+/**
+ * Garbage collect assets from old deployments.
+ * Returns the storageIds that need to be deleted from app storage.
+ */
+export declare const gcOldAssets: import("convex/server").RegisteredMutation<"public", {
+    currentDeploymentId: string;
+}, Promise<{
+    storageIds: Array<ReturnType<typeof v.id<"_storage">>["type"]>;
+    blobIds: string[];
+}>>;
+/**
+ * List all assets (useful for debugging).
+ */
+export declare const listAssets: import("convex/server").RegisteredQuery<"public", {
+    limit?: number | undefined;
+}, Promise<{
+    _id: import("convex/values").GenericId<"staticAssets">;
+    _creationTime: number;
+    blobId?: string | undefined;
+    storageId?: import("convex/values").GenericId<"_storage"> | undefined;
+    path: string;
+    contentType: string;
+    deploymentId: string;
+}[]>>;
+/**
+ * Delete all assets records (useful for cleanup).
+ * Returns storageIds that need to be deleted from app storage.
+ */
+export declare const deleteAllAssets: import("convex/server").RegisteredMutation<"internal", {}, Promise<{
+    storageIds: Array<ReturnType<typeof v.id<"_storage">>["type"]>;
+    blobIds: string[];
+}>>;
+/**
+ * Get the current deployment info.
+ * Clients subscribe to this to detect when a new deployment happens.
+ */
+export declare const getCurrentDeployment: import("convex/server").RegisteredQuery<"public", {}, Promise<{
+    _id: import("convex/values").GenericId<"deploymentInfo">;
+    _creationTime: number;
+    currentDeploymentId: string;
+    deployedAt: number;
+} | null>>;
+/**
+ * Update the current deployment ID.
+ * Called after a successful deployment to notify all connected clients.
+ */
+export declare const setCurrentDeployment: import("convex/server").RegisteredMutation<"public", {
+    deploymentId: string;
+}, Promise<null>>;
+//# sourceMappingURL=lib.d.ts.map

package/dist/component/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../src/component/lib.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAclC;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;UASpB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,2EAM5B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,WAAW;;;;;;;;;GAwCtB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW;;;gBA2BmB,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;;GAI3F,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;KAWrB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe;gBAsBe,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;;GAI3F,CAAC;AAaH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;UAM/B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;iBAyB/B,CAAC"}

package/dist/component/lib.js

@@ -0,0 +1,210 @@
+import { v } from "convex/values";
+import { mutation, query, internalMutation } from "./_generated/server.js";
+// Validator for static asset documents (including system fields)
+const staticAssetValidator = v.object({
+    _id: v.id("staticAssets"),
+    _creationTime: v.number(),
+    path: v.string(),
+    storageId: v.optional(v.id("_storage")),
+    blobId: v.optional(v.string()),
+    contentType: v.string(),
+    deploymentId: v.string(),
+});
+/**
+ * Look up an asset by its URL path.
+ */
+export const getByPath = query({
+    args: { path: v.string() },
+    returns: v.union(staticAssetValidator, v.null()),
+    handler: async (ctx, args) => {
+        return await ctx.db
+            .query("staticAssets")
+            .withIndex("by_path", (q) => q.eq("path", args.path))
+            .unique();
+    },
+});
+/**
+ * Generate a signed URL for uploading a file to Convex storage.
+ * Note: This is kept for backwards compatibility but the recommended approach
+ * is to use the app's storage directly via exposeUploadApi().
+ */
+export const generateUploadUrl = mutation({
+    args: {},
+    returns: v.string(),
+    handler: async (ctx) => {
+        return await ctx.storage.generateUploadUrl();
+    },
+});
+/**
+ * Record an asset in the database after uploading to storage.
+ * If an asset already exists at this path, returns the old storageId for cleanup.
+ *
+ * Note: Storage files are stored in the app's storage, not the component's storage.
+ * The caller is responsible for deleting the returned storageId from app storage.
+ */
+export const recordAsset = mutation({
+    args: {
+        path: v.string(),
+        storageId: v.optional(v.id("_storage")),
+        blobId: v.optional(v.string()),
+        contentType: v.string(),
+        deploymentId: v.string(),
+    },
+    returns: v.object({
+        oldStorageId: v.union(v.id("_storage"), v.null()),
+        oldBlobId: v.union(v.string(), v.null()),
+    }),
+    handler: async (ctx, args) => {
+        // Check if asset already exists at this path
+        const existing = await ctx.db
+            .query("staticAssets")
+            .withIndex("by_path", (q) => q.eq("path", args.path))
+            .unique();
+        let oldStorageId = null;
+        let oldBlobId = null;
+        if (existing) {
+            oldStorageId = existing.storageId ?? null;
+            oldBlobId = existing.blobId ?? null;
+            // Delete old record
+            await ctx.db.delete(existing._id);
+        }
+        // Insert new asset
+        await ctx.db.insert("staticAssets", {
+            path: args.path,
+            ...(args.storageId ? { storageId: args.storageId } : {}),
+            ...(args.blobId ? { blobId: args.blobId } : {}),
+            contentType: args.contentType,
+            deploymentId: args.deploymentId,
+        });
+        // Return old IDs so caller can clean up
+        return { oldStorageId, oldBlobId };
+    },
+});
+/**
+ * Garbage collect assets from old deployments.
+ * Returns the storageIds that need to be deleted from app storage.
+ */
+export const gcOldAssets = mutation({
+    args: {
+        currentDeploymentId: v.string(),
+    },
+    returns: v.object({
+        storageIds: v.array(v.id("_storage")),
+        blobIds: v.array(v.string()),
+    }),
+    handler: async (ctx, args) => {
+        const oldAssets = await ctx.db.query("staticAssets").collect();
+        const storageIds = [];
+        const blobIds = [];
+        for (const asset of oldAssets) {
+            if (asset.deploymentId !== args.currentDeploymentId) {
+                if (asset.storageId) {
+                    storageIds.push(asset.storageId);
+                }
+                if (asset.blobId) {
+                    blobIds.push(asset.blobId);
+                }
+                // Delete database record
+                await ctx.db.delete(asset._id);
+            }
+        }
+        return {
+            storageIds: storageIds,
+            blobIds,
+        };
+    },
+});
+/**
+ * List all assets (useful for debugging).
+ */
+export const listAssets = query({
+    args: {
+        limit: v.optional(v.number()),
+    },
+    returns: v.array(staticAssetValidator),
+    handler: async (ctx, args) => {
+        return await ctx.db
+            .query("staticAssets")
+            .order("asc")
+            .take(args.limit ?? 100);
+    },
+});
+/**
+ * Delete all assets records (useful for cleanup).
+ * Returns storageIds that need to be deleted from app storage.
+ */
+export const deleteAllAssets = internalMutation({
+    args: {},
+    returns: v.object({
+        storageIds: v.array(v.id("_storage")),
+        blobIds: v.array(v.string()),
+    }),
+    handler: async (ctx) => {
+        const assets = await ctx.db.query("staticAssets").collect();
+        const storageIds = [];
+        const blobIds = [];
+        for (const asset of assets) {
+            if (asset.storageId) {
+                storageIds.push(asset.storageId);
+            }
+            if (asset.blobId) {
+                blobIds.push(asset.blobId);
+            }
+            await ctx.db.delete(asset._id);
+        }
+        return {
+            storageIds: storageIds,
+            blobIds,
+        };
+    },
+});
+// ============================================================================
+// Deployment Tracking - for live reload on deploy
+// ============================================================================
+const deploymentInfoValidator = v.object({
+    _id: v.id("deploymentInfo"),
+    _creationTime: v.number(),
+    currentDeploymentId: v.string(),
+    deployedAt: v.number(),
+});
+/**
+ * Get the current deployment info.
+ * Clients subscribe to this to detect when a new deployment happens.
+ */
+export const getCurrentDeployment = query({
+    args: {},
+    returns: v.union(deploymentInfoValidator, v.null()),
+    handler: async (ctx) => {
+        return await ctx.db.query("deploymentInfo").first();
+    },
+});
+/**
+ * Update the current deployment ID.
+ * Called after a successful deployment to notify all connected clients.
+ */
+export const setCurrentDeployment = mutation({
+    args: {
+        deploymentId: v.string(),
+    },
+    returns: v.null(),
+    handler: async (ctx, args) => {
+        // Get existing deployment info
+        const existing = await ctx.db.query("deploymentInfo").first();
+        if (existing) {
+            // Update existing record
+            await ctx.db.patch(existing._id, {
+                currentDeploymentId: args.deploymentId,
+                deployedAt: Date.now(),
+            });
+        }
+        else {
+            // Create new record
+            await ctx.db.insert("deploymentInfo", {
+                currentDeploymentId: args.deploymentId,
+                deployedAt: Date.now(),
+            });
+        }
+        return null;
+    },
+});
+//# sourceMappingURL=lib.js.map

package/dist/component/lib.js.map

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

package/dist/component/schema.d.ts

@@ -0,0 +1,27 @@
+declare const _default: import("convex/server").SchemaDefinition<{
+    staticAssets: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        blobId?: string | undefined;
+        storageId?: import("convex/values").GenericId<"_storage"> | undefined;
+        path: string;
+        contentType: string;
+        deploymentId: string;
+    }, {
+        path: import("convex/values").VString<string, "required">;
+        storageId: import("convex/values").VId<import("convex/values").GenericId<"_storage"> | undefined, "optional">;
+        blobId: import("convex/values").VString<string | undefined, "optional">;
+        contentType: import("convex/values").VString<string, "required">;
+        deploymentId: import("convex/values").VString<string, "required">;
+    }, "required", "path" | "blobId" | "contentType" | "deploymentId" | "storageId">, {
+        by_path: ["path", "_creationTime"];
+        by_deploymentId: ["deploymentId", "_creationTime"];
+    }, {}, {}>;
+    deploymentInfo: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        currentDeploymentId: string;
+        deployedAt: number;
+    }, {
+        currentDeploymentId: import("convex/values").VString<string, "required">;
+        deployedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "currentDeploymentId" | "deployedAt">, {}, {}, {}>;
+}, true>;
+export default _default;
+//# sourceMappingURL=schema.d.ts.map

package/dist/component/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAGA,wBAiBG"}

package/dist/component/schema.js

@@ -0,0 +1,20 @@
+import { defineSchema, defineTable } from "convex/server";
+import { v } from "convex/values";
+export default defineSchema({
+    staticAssets: defineTable({
+        path: v.string(), // URL path, e.g., "/index.html", "/assets/main-abc123.js"
+        storageId: v.optional(v.id("_storage")), // Reference to Convex file storage (used for HTML + non-CDN assets)
+        blobId: v.optional(v.string()), // convex-fs blob ID (used for CDN-served assets)
+        contentType: v.string(), // MIME type, e.g., "text/html; charset=utf-8"
+        deploymentId: v.string(), // UUID for garbage collection
+    })
+        .index("by_path", ["path"])
+        .index("by_deploymentId", ["deploymentId"]),
+    // Singleton table to track the current deployment
+    // Clients subscribe to this to know when to reload
+    deploymentInfo: defineTable({
+        currentDeploymentId: v.string(),
+        deployedAt: v.number(), // timestamp
+    }),
+});
+//# sourceMappingURL=schema.js.map

package/dist/component/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAElC,eAAe,YAAY,CAAC;IAC1B,YAAY,EAAE,WAAW,CAAC;QACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,0DAA0D;QAC5E,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,oEAAoE;QAC7G,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,iDAAiD;QACjF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,8CAA8C;QACvE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,8BAA8B;KACzD,CAAC;SACC,KAAK,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC;SAC1B,KAAK,CAAC,iBAAiB,EAAE,CAAC,cAAc,CAAC,CAAC;IAE7C,kDAAkD;IAClD,mDAAmD;IACnD,cAAc,EAAE,WAAW,CAAC;QAC1B,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE;QAC/B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,YAAY;KACrC,CAAC;CACH,CAAC,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,80 @@
+import { type CSSProperties, type JSX } from "react";
+import type { FunctionReference } from "convex/server";
+type DeploymentInfo = {
+    _id: string;
+    _creationTime: number;
+    currentDeploymentId: string;
+    deployedAt: number;
+} | null;
+/**
+ * Hook to detect when a new deployment is available.
+ * Shows a prompt to the user instead of auto-reloading.
+ *
+ * @param getCurrentDeployment - The query function reference from exposeDeploymentQuery
+ * @returns Object with update status and reload function
+ *
+ * @example
+ * ```tsx
+ * import { useDeploymentUpdates } from "@convex-dev/static-hosting/react";
+ * import { api } from "../convex/_generated/api";
+ *
+ * function App() {
+ *   const { updateAvailable, reload } = useDeploymentUpdates(
+ *     api.staticHosting.getCurrentDeployment
+ *   );
+ *
+ *   return (
+ *     <div>
+ *       {updateAvailable && (
+ *         <div className="update-banner">
+ *           A new version is available!
+ *           <button onClick={reload}>Reload</button>
+ *         </div>
+ *       )}
+ *       {/* rest of your app *\/}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useDeploymentUpdates(getCurrentDeployment: FunctionReference<"query", "public", Record<string, never>, DeploymentInfo>): {
+    /** True when a new deployment is available */
+    updateAvailable: boolean;
+    /** Reload the page to get the new version */
+    reload: () => void;
+    /** Dismiss the update notification (until next deploy) */
+    dismiss: () => void;
+    /** The current deployment info (or null if not yet loaded) */
+    deployment: DeploymentInfo | undefined;
+};
+/**
+ * A ready-to-use update banner component.
+ * Displays a notification when a new deployment is available.
+ *
+ * @example
+ * ```tsx
+ * import { UpdateBanner } from "@convex-dev/static-hosting/react";
+ * import { api } from "../convex/_generated/api";
+ *
+ * function App() {
+ *   return (
+ *     <div>
+ *       <UpdateBanner
+ *         getCurrentDeployment={api.staticHosting.getCurrentDeployment}
+ *       />
+ *       {/* rest of your app *\/}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function UpdateBanner({ getCurrentDeployment, message, buttonText, dismissable, className, style, }: {
+    getCurrentDeployment: FunctionReference<"query", "public", Record<string, never>, DeploymentInfo>;
+    message?: string;
+    buttonText?: string;
+    dismissable?: boolean;
+    className?: string;
+    style?: CSSProperties;
+}): JSX.Element | null;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAqB,KAAK,aAAa,EAAE,KAAK,GAAG,EAAE,MAAM,OAAO,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,KAAK,cAAc,GAAG;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CAAC;AAET;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,oBAAoB,CAClC,oBAAoB,EAAE,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,cAAc,CAAC;IAoC/F,8CAA8C;;IAE9C,6CAA6C;;IAE7C,0DAA0D;;IAE1D,8DAA8D;;EAGjE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,EAC3B,oBAAoB,EACpB,OAAuC,EACvC,UAAqB,EACrB,WAAkB,EAClB,SAAS,EACT,KAAK,GACN,EAAE;IACD,oBAAoB,EAAE,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,cAAc,CAAC,CAAC;IAClG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,GAAG,GAAG,CAAC,OAAO,GAAG,IAAI,CAwDrB"}

package/dist/react/index.js

@@ -0,0 +1,138 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useQuery } from "convex/react";
+import { useState, useMemo } from "react";
+/**
+ * Hook to detect when a new deployment is available.
+ * Shows a prompt to the user instead of auto-reloading.
+ *
+ * @param getCurrentDeployment - The query function reference from exposeDeploymentQuery
+ * @returns Object with update status and reload function
+ *
+ * @example
+ * ```tsx
+ * import { useDeploymentUpdates } from "@convex-dev/static-hosting/react";
+ * import { api } from "../convex/_generated/api";
+ *
+ * function App() {
+ *   const { updateAvailable, reload } = useDeploymentUpdates(
+ *     api.staticHosting.getCurrentDeployment
+ *   );
+ *
+ *   return (
+ *     <div>
+ *       {updateAvailable && (
+ *         <div className="update-banner">
+ *           A new version is available!
+ *           <button onClick={reload}>Reload</button>
+ *         </div>
+ *       )}
+ *       {/* rest of your app *\/}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useDeploymentUpdates(getCurrentDeployment) {
+    const deployment = useQuery(getCurrentDeployment, {});
+    const [initialDeploymentId, setInitialDeploymentId] = useState(null);
+    const [dismissedDeploymentId, setDismissedDeploymentId] = useState(null);
+    // Capture the initial deployment ID on first load
+    // Using useState with functional update to avoid stale closure issues
+    if (deployment && initialDeploymentId === null) {
+        // This is safe - we're setting initial state based on first data load
+        // It only runs once when deployment first becomes available
+        setInitialDeploymentId(deployment.currentDeploymentId);
+    }
+    // Derive updateAvailable from current state
+    const updateAvailable = useMemo(() => {
+        if (!deployment || initialDeploymentId === null) {
+            return false;
+        }
+        // Show update if deployment changed from initial AND user hasn't dismissed this one
+        const hasNewDeployment = deployment.currentDeploymentId !== initialDeploymentId;
+        const isDismissed = deployment.currentDeploymentId === dismissedDeploymentId;
+        return hasNewDeployment && !isDismissed;
+    }, [deployment, initialDeploymentId, dismissedDeploymentId]);
+    const reload = () => {
+        window.location.reload();
+    };
+    const dismiss = () => {
+        if (deployment) {
+            setDismissedDeploymentId(deployment.currentDeploymentId);
+        }
+    };
+    return {
+        /** True when a new deployment is available */
+        updateAvailable,
+        /** Reload the page to get the new version */
+        reload,
+        /** Dismiss the update notification (until next deploy) */
+        dismiss,
+        /** The current deployment info (or null if not yet loaded) */
+        deployment,
+    };
+}
+/**
+ * A ready-to-use update banner component.
+ * Displays a notification when a new deployment is available.
+ *
+ * @example
+ * ```tsx
+ * import { UpdateBanner } from "@convex-dev/static-hosting/react";
+ * import { api } from "../convex/_generated/api";
+ *
+ * function App() {
+ *   return (
+ *     <div>
+ *       <UpdateBanner
+ *         getCurrentDeployment={api.staticHosting.getCurrentDeployment}
+ *       />
+ *       {/* rest of your app *\/}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function UpdateBanner({ getCurrentDeployment, message = "A new version is available!", buttonText = "Reload", dismissable = true, className, style, }) {
+    const { updateAvailable, reload, dismiss } = useDeploymentUpdates(getCurrentDeployment);
+    if (!updateAvailable)
+        return null;
+    const defaultStyle = {
+        position: "fixed",
+        bottom: "1rem",
+        right: "1rem",
+        backgroundColor: "#1a1a2e",
+        color: "#fff",
+        padding: "1rem 1.5rem",
+        borderRadius: "8px",
+        boxShadow: "0 4px 12px rgba(0, 0, 0, 0.3)",
+        display: "flex",
+        alignItems: "center",
+        gap: "1rem",
+        zIndex: 9999,
+        fontFamily: "system-ui, -apple-system, sans-serif",
+        fontSize: "14px",
+        ...style,
+    };
+    const buttonStyle = {
+        backgroundColor: "#4f46e5",
+        color: "#fff",
+        border: "none",
+        padding: "0.5rem 1rem",
+        borderRadius: "4px",
+        cursor: "pointer",
+        fontWeight: 500,
+    };
+    const dismissStyle = {
+        background: "none",
+        border: "none",
+        color: "#888",
+        cursor: "pointer",
+        padding: "0.25rem",
+        fontSize: "18px",
+        lineHeight: 1,
+    };
+    return (_jsxs("div", { className: className, style: defaultStyle, children: [_jsx("span", { children: message }), _jsx("button", { onClick: reload, style: buttonStyle, children: buttonText }), dismissable && (_jsx("button", { onClick: dismiss, style: dismissStyle, "aria-label": "Dismiss", children: "\u00D7" }))] }));
+}
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

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