alinea 2.0.0-preview.6 → 2.0.0-preview.8

package/dist/.init/content/pages/welcome.json

@@ -1,5 +1,5 @@
 {
-  "_id": "3JUoCAhRGalhjQEYxS2BD7bVGVb",
+  "_id": "3JmA8NHtbBt6eB3HhLdaN4zhM7O",
   "_type": "Page",
   "_index": "a0",
   "_seeded": "welcome.json",

package/dist/LICENSES.md

@@ -2,34 +2,7 @@ This file contains the licenses of the bundled modules in this distribution.
 
 ===
 
-# jotai@3.0.0 (MIT)
-
-MIT License
-
-Copyright (c) 2020 Poimandres
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
-
-===
-
-# react-aria-components@1.17.0 (Apache-2.0)
+# @internationalized/date@3.12.1 (Apache-2.0)
 
                                  Apache License
                            Version 2.0, January 2004
@@ -236,37 +209,11 @@ SOFTWARE.
 
 ===
 
-# rado@1.3.0-preview.6 (MIT)
-
-MIT License
-
-Copyright (c) 2024 Ben Merckx
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
-===
-
-# microcbor@1.2.1 (MIT)
+# jotai@3.0.0 (MIT)
 
 MIT License
 
-Copyright (c) 2021 Joel Gustafson
+Copyright (c) 2020 Poimandres
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -289,7 +236,7 @@ SOFTWARE.
 
 ===
 
-# @internationalized/date@3.12.1 (Apache-2.0)
+# react-aria-components@1.17.0 (Apache-2.0)
 
                                  Apache License
                            Version 2.0, January 2004
@@ -496,11 +443,37 @@ SOFTWARE.
 
 ===
 
-# @tiptap/core@3.30.5 (MIT)
+# rado@1.3.0-preview.11 (MIT)
 
 MIT License
 
-Copyright (c) 2025, Tiptap GmbH
+Copyright (c) 2024 Ben Merckx
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+===
+
+# microcbor@1.2.1 (MIT)
+
+MIT License
+
+Copyright (c) 2021 Joel Gustafson
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -730,11 +703,11 @@ SOFTWARE.
 
 ===
 
-# jotai-family@1.1.0 (MIT)
+# @tiptap/core@3.30.5 (MIT)
 
 MIT License
 
-Copyright (c) 2025 Poimandres
+Copyright (c) 2025, Tiptap GmbH
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -755,33 +728,6 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 
-===
-
-# jotai-location@0.6.2 (MIT)
-
-The MIT License (MIT)
-
-Copyright (c) 2022 Daishi Kato
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
-
-
 ===
 
 # react-aria@3.48.0 (Apache-2.0)
@@ -991,11 +937,38 @@ THE SOFTWARE.
 
 ===
 
-# @badgateway/oauth2-client@3.3.1 (MIT)
+# jotai-location@0.6.2 (MIT)
+
+The MIT License (MIT)
+
+Copyright (c) 2022 Daishi Kato
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+
+===
+
+# jotai-family@1.1.0 (MIT)
 
 MIT License
 
-Copyright (c) 2019-2025 Evert Pot
+Copyright (c) 2025 Poimandres
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -1018,11 +991,11 @@ SOFTWARE.
 
 ===
 
-# use-sync-external-store@1.6.0 (MIT)
+# @badgateway/oauth2-client@3.3.1 (MIT)
 
 MIT License
 
-Copyright (c) Meta Platforms, Inc. and affiliates.
+Copyright (c) 2019-2025 Evert Pot
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -1045,34 +1018,38 @@ SOFTWARE.
 
 ===
 
-# htmlparser2@9.1.0 (MIT)
+# @tiptap/extension-list@3.30.5 (MIT)
+
+MIT License
+
+Copyright (c) 2025, Tiptap GmbH
 
-Copyright 2010, 2011, Chris Winberry <chris@winberry.net>. All rights reserved.
 Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to
-deal in the Software without restriction, including without limitation the
-rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
-sell copies of the Software, and to permit persons to whom the Software is
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
 furnished to do so, subject to the following conditions:
- 
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
- 
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
-IN THE SOFTWARE.
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
 
 ===
 
-# @tiptap/extension-list@3.30.5 (MIT)
+# use-sync-external-store@1.6.0 (MIT)
 
 MIT License
 
-Copyright (c) 2025, Tiptap GmbH
+Copyright (c) Meta Platforms, Inc. and affiliates.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -1122,7 +1099,30 @@ SOFTWARE.
 
 ===
 
-# domutils@3.2.2 (BSD-2-Clause)
+# htmlparser2@9.1.0 (MIT)
+
+Copyright 2010, 2011, Chris Winberry <chris@winberry.net>. All rights reserved.
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to
+deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+ 
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+ 
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+IN THE SOFTWARE.
+
+===
+
+# domhandler@5.0.3 (BSD-2-Clause)
 
 Copyright (c) Felix Böhm
 All rights reserved.
@@ -1139,7 +1139,7 @@ EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 ===
 
-# domhandler@5.0.3 (BSD-2-Clause)
+# domutils@3.2.2 (BSD-2-Clause)
 
 Copyright (c) Felix Böhm
 All rights reserved.

package/dist/adapter/next/cms.d.ts

@@ -1,27 +1,41 @@
 import { CMS } from 'alinea/core/CMS';
 import { Config } from 'alinea/core/Config';
 import type { UploadResponse } from 'alinea/core/Connection';
-import { LocalDB } from 'alinea/core/db/LocalDB';
+import type { LocalStore } from 'alinea/core/db/LocalStore';
 import type { Mutation } from 'alinea/core/db/Mutation';
 import type { GraphQuery } from 'alinea/core/Graph';
 import type { User } from 'alinea/core/User';
 import PLazy from 'p-lazy';
+import type { DatabaseOptions } from 'rado';
 export interface PreviewProps {
     widget?: boolean;
+    /** Show the queries and syncs of each draft render in the widget */
+    stats?: boolean;
     workspace?: string;
     root?: string;
 }
+export type OpenBundledDatabase = (config: Config, options?: DatabaseOptions) => Promise<LocalStore>;
+export interface SyncStatus {
+    /** Whether queries are answered from the bundled database or the handler. */
+    source: 'database' | 'handler';
+    /** The content revision the answering side is at. */
+    sha: string | undefined;
+    /** When this isolate last synced its bundled database with the handler. */
+    syncedAt: Date | undefined;
+}
 export declare class NextCMS<Definition extends Config = Config> extends CMS<Definition> {
     #private;
-    constructor(config: Definition);
+    bundledDb: PLazy<LocalStore>;
+    constructor(config: Definition, openBundledDatabase?: OpenBundledDatabase);
     throttle: (sync: () => Promise<unknown>, interval?: number) => Promise<void>;
-    bundledDb: PLazy<LocalDB>;
+    /** Where queries are answered from and how fresh that side is. */
+    status(): Promise<SyncStatus>;
     resolve<Query extends GraphQuery>(query: Query): Promise<any>;
     user(): Promise<User | undefined>;
     mutate(mutations: Array<Mutation>): Promise<{
         sha: string;
     }>;
     prepareUpload(file: string): Promise<UploadResponse>;
-    previews: ({ widget, workspace, root }: PreviewProps) => Promise<import("react").JSX.Element | null>;
+    previews: ({ widget, stats: showStats, workspace, root }: PreviewProps) => Promise<import("react").JSX.Element | null>;
 }
 export declare function createCMS<Definition extends Config>(config: Definition): NextCMS<Definition>;

package/dist/adapter/next/cms.js

@@ -12,42 +12,90 @@ import { createThrottledSync } from "alinea/backend/util/Syncable";
 import { Client } from "alinea/core/Client";
 import { CMS } from "alinea/core/CMS";
 import { Config } from "alinea/core/Config";
-import { LocalDB } from "alinea/core/db/LocalDB";
 import { outcome } from "alinea/core/Outcome";
+import { ReadonlyTree } from "alinea/core/source/Tree";
 import { trace } from "alinea/core/Trace";
 import { getPreviewPayloadFromCookies } from "alinea/preview/PreviewCookies";
 import { Headers } from "@alinea/iso";
 import { cache } from "react";
 import { requestContext } from "./context.js";
+import { RenderStats, summarizeQuery, timed } from "./renderStats.js";
 import { syncIfStale } from "./syncCheck.js";
 import { jsx } from "react/jsx-runtime";
+var preValidatedRemote = { validate: false };
 var NextCMS = class extends CMS {
-  constructor(config) {
+  bundledDb;
+  #syncedAt;
+  constructor(config, openBundledDatabase) {
     super(config);
+    this.bundledDb = PLazy.from(async () => {
+      if (process.env.NEXT_RUNTIME === "edge")
+        throw new Error(
+          "Local DB is not supported in Edge runtime environments."
+        );
+      if (!openBundledDatabase)
+        throw new Error(
+          "A bundled database loader is required. Import createCMS from 'alinea/next'."
+        );
+      const span = trace(this.config, "alinea.next.cms.db");
+      return span(
+        () => openBundledDatabase(this.config, {
+          // Statements run in the async context of the query that caused
+          // them, which carries the React request of the render.
+          logQuery: (_query, durationMs) => this.#render().stats?.statement(durationMs)
+        })
+      );
+    });
   }
   throttle = createThrottledSync();
-  bundledDb = PLazy.from(async () => {
-    if (process.env.NEXT_RUNTIME === "edge")
-      throw new Error("Local DB is not supported in Edge runtime environments.");
-    const span = trace(this.config, "alinea.next.cms.db");
-    return span(async () => {
-      const { generatedSource } = await import("alinea/backend/store/GeneratedSource");
-      const source = await generatedSource;
-      const db = new LocalDB(this.config, source);
-      await db.sync();
-      return db;
-    });
+  /**
+   * Per React request; outside a request (build, route handlers) every call
+   * returns a fresh holder, so nothing is recorded there.
+   */
+  #render = cache(() => ({}));
+  #isDraft = cache(async () => {
+    const { draftMode } = await import("next/headers.js");
+    const [isDraft] = await outcome(async () => (await draftMode()).isEnabled);
+    return Boolean(isDraft);
   });
-  #applyPreview = cache(async () => {
-    const context = await requestContext(this.config);
+  /** Draft renders collect their queries and syncs for the preview widget. */
+  async #renderStats() {
+    if (!await this.#isDraft()) return void 0;
+    const render = this.#render();
+    return render.stats ??= new RenderStats();
+  }
+  /** The bundled database answers outside Edge, except during development. */
+  async #environment(context) {
     const isEdge = process.env.NEXT_RUNTIME === "edge";
     const { PHASE_PRODUCTION_BUILD } = await import("next/constants.js");
     const isBuild = process.env.NEXT_PHASE === PHASE_PRODUCTION_BUILD;
-    const useLocalDb = !isEdge && (!context.isDev || isBuild);
-    const { cookies, draftMode } = await import("next/headers.js");
-    const [isDraft] = await outcome(async () => (await draftMode()).isEnabled);
+    return { isBuild, useLocalDb: !isEdge && (!context.isDev || isBuild) };
+  }
+  /** Renders keep serving the current content when the handler is unreachable. */
+  async #syncDb(db, client, stats) {
+    if (stats)
+      return stats.track(
+        { kind: "sync", summary: "sync" },
+        (row) => timed(row, () => this.#syncDb(db, client, void 0))
+      );
+    try {
+      const sha = await db.syncWith(client, preValidatedRemote);
+      this.#syncedAt = Date.now();
+      return sha;
+    } catch (error) {
+      console.warn(
+        `Alinea could not sync with the handler, serving current content: ${error instanceof Error ? error.message : String(error)}`
+      );
+      return db.sha;
+    }
+  }
+  #applyPreview = cache(async () => {
+    const context = await requestContext(this.config);
+    const { isBuild, useLocalDb } = await this.#environment(context);
+    const isDraft = await this.#isDraft();
     if (!isDraft)
       return { context, hasPreview: false, isDraft, isBuild, useLocalDb };
+    const { cookies } = await import("next/headers.js");
     const cookie = await cookies();
     const payload = getPreviewPayloadFromCookies(cookie.getAll());
     if (!payload)
@@ -67,37 +115,73 @@ var NextCMS = class extends CMS {
     }
     return { context, hasPreview: true, isDraft, isBuild, preview, useLocalDb };
   });
+  /**
+   * The preview cookie carries the content hash the dashboard rendered
+   * against, which is the freshness signal in draft mode: Next bypasses the
+   * `unstable_cache` that `syncIfStale` shares between renders there, so the
+   * cookie hash replaces the uncached lookup of the latest sha. A mismatch
+   * means this isolate is behind (or ahead of) the previewed content, and one
+   * sync brings it to the handler revision before the patch is applied.
+   */
   async #prepareLocalPreview(db, decoded, context) {
     if ("entry" in decoded) return decoded;
-    if (db.sha === decoded.contentHash) return applyPreviewUpdate(db, decoded);
-    const source = await db.source.getTree();
-    if (source.sha === decoded.contentHash) {
-      await db.sync();
-      return applyPreviewUpdate(db, decoded);
-    }
-    const applied = await applyPreviewUpdate(db, decoded);
-    if (applied) return applied;
-    await db.syncWith(createClient(this.config, context));
+    if (await db.sha !== decoded.contentHash)
+      await this.#syncDb(
+        db,
+        createClient(this.config, context),
+        this.#render().stats
+      );
     return applyPreviewUpdate(db, decoded);
   }
+  /** Where queries are answered from and how fresh that side is. */
+  async status() {
+    const context = await requestContext(this.config);
+    const { useLocalDb } = await this.#environment(context);
+    if (useLocalDb) {
+      const db = await this.bundledDb;
+      return {
+        source: "database",
+        sha: await db.sha,
+        syncedAt: this.#syncedAt ? new Date(this.#syncedAt) : void 0
+      };
+    }
+    const client = createClient(this.config, context);
+    const tree = await client.getTreeIfDifferent(ReadonlyTree.EMPTY.sha).catch(() => void 0);
+    return { source: "handler", sha: tree?.sha, syncedAt: void 0 };
+  }
   async resolve(query) {
+    const stats = await this.#renderStats();
+    if (!stats) return this.#resolve(query, void 0);
+    return stats.track(
+      { kind: "query", summary: summarizeQuery(query) },
+      (row) => this.#resolve(query, row)
+    );
+  }
+  async #resolve(query, row) {
     let status = query.status;
     const { context, hasPreview, isDraft, isBuild, preview, useLocalDb } = await this.#applyPreview();
     if (isDraft && !status) status = "preferDraft";
     const request = { ...query, preview, status };
     const client = createClient(this.config, context);
+    if (row) row.source = useLocalDb ? "database" : "handler";
     if (!useLocalDb) {
       const span = trace(this.config, "alinea.cms.resolve.client");
-      return span(() => client.resolve(request));
+      return timed(row, () => span(() => client.resolve(request)));
     }
     const db = await this.bundledDb;
     const syncInterval = request.disableSync ? Number.POSITIVE_INFINITY : request.syncInterval ?? this.config.syncInterval;
-    if (hasPreview) return db.resolve(request);
+    if (hasPreview) return timed(row, () => db.resolve(request));
     if (!isBuild) {
-      const settled = await syncIfStale(db, client, syncInterval);
-      if (!settled) await this.throttle(() => db.syncWith(client), syncInterval);
+      const stats = this.#render().stats;
+      const tracked = {
+        sha: db.sha,
+        syncWith: () => this.#syncDb(db, client, stats)
+      };
+      const settled = !isDraft && await syncIfStale(tracked, client, syncInterval);
+      if (!settled)
+        await this.throttle(() => this.#syncDb(db, client, stats), syncInterval);
     }
-    return db.resolve(request);
+    return timed(row, () => db.resolve(request));
   }
   async #authenticatedClient() {
     const context = await requestContext(this.config);
@@ -139,11 +223,15 @@ var NextCMS = class extends CMS {
     const client = await this.#authenticatedClient();
     return client.prepareUpload(file);
   }
-  previews = async ({ widget, workspace, root }) => {
-    const { draftMode } = await import("next/headers.js");
+  previews = async ({
+    widget,
+    stats: showStats,
+    workspace,
+    root
+  }) => {
+    const stats = await this.#renderStats();
+    if (!stats) return null;
     const { default: dynamic } = await import("next/dynamic.js");
-    const [isDraft] = await outcome(async () => (await draftMode()).isEnabled);
-    if (!isDraft) return null;
     const { isDev, handlerUrl } = await requestContext(this.config);
     let file = `${Config.adminPath(this.config)}.html`;
     if (!file.startsWith("/")) file = `/${file}`;
@@ -156,6 +244,7 @@ var NextCMS = class extends CMS {
       {
         dashboardUrl: dashboardUrl.href,
         widget,
+        stats: widget && showStats ? stats.settled() : void 0,
         workspace,
         root
       }

package/dist/adapter/next/handler.d.ts

@@ -1,12 +1,16 @@
 import { type BackendFactory, type BackendOptions } from 'alinea/backend/api/CreateBackend';
 import { type HandlerHooks } from 'alinea/backend/Handler';
 import { Config } from 'alinea/core/Config';
+import type { LocalStore } from 'alinea/core/db/LocalStore';
 import { NextCMS } from './cms.js';
 type Handler = (request: Request) => Promise<Response>;
 export interface NextHandlerOptions extends HandlerHooks {
     cms: NextCMS;
     backend?: BackendFactory | BackendOptions;
 }
-export declare function createHandler(input: NextCMS | NextHandlerOptions): Handler;
+export type OpenGeneratedDatabase = (config: Config) => Promise<LocalStore>;
+export declare function createHandlerWithDatabase(input: NextCMS | NextHandlerOptions, openGeneratedDatabase?: OpenGeneratedDatabase): Handler;
 export declare function handlerPathname(config: Config, requestUrl: URL): string;
+/** A handler without a generated database, as used in the Edge runtime. */
+export declare function createHandler(input: NextCMS | NextHandlerOptions): Handler;
 export {};

package/dist/adapter/next/handler.js

@@ -10,17 +10,15 @@ import {
 import {
   createHandler as createCoreHandler
 } from "alinea/backend/Handler";
-import { generatedSource } from "alinea/backend/store/GeneratedSource";
 import { JWTPreviews } from "alinea/backend/util/JWTPreviews";
 import { CloudRemote } from "alinea/cloud/CloudRemote";
 import { Config } from "alinea/core/Config";
-import { LocalDB } from "alinea/core/db/LocalDB";
 import { trace } from "alinea/core/Trace";
 import { NextCMS } from "./cms.js";
 import { requestContext } from "./context.js";
 import { createDevRemote } from "./DevRemote.js";
 import { revalidateContentSha } from "./syncCheck.js";
-function createHandler(input) {
+function createHandlerWithDatabase(input, openGeneratedDatabase) {
   const options = input instanceof NextCMS ? { cms: input } : input;
   const config = options.cms.config;
   const backend = typeof options.backend === "function" ? options.backend : options.backend ? backendFromOptions(options.backend) : (context) => new CloudRemote(context, config);
@@ -28,10 +26,15 @@ function createHandler(input) {
   const span = trace(config, "alinea.next.handler.db");
   const db = PLazy.from(
     () => span(async () => {
-      const source = await generatedSource;
-      const db2 = new LocalDB(config, source);
-      await db2.sync();
-      return db2;
+      if (process.env.NEXT_RUNTIME === "edge")
+        throw new Error(
+          "The Alinea handler is not supported in Edge runtime environments."
+        );
+      if (!openGeneratedDatabase)
+        throw new Error(
+          "A generated database loader is required. Import createHandler from 'alinea/next'."
+        );
+      return openGeneratedDatabase(config);
     })
   );
   const handleBackend = createCoreHandler({
@@ -108,7 +111,11 @@ function rewrittenFilePath(config, request) {
     return;
   }
 }
+function createHandler(input) {
+  return createHandlerWithDatabase(input);
+}
 export {
   createHandler,
+  createHandlerWithDatabase,
   handlerPathname
 };

package/dist/adapter/next/node.d.ts

@@ -0,0 +1,5 @@
+import type { Config } from 'alinea/core/Config';
+import { NextCMS } from './cms.js';
+import { type NextHandlerOptions } from './handler.js';
+export declare function createCMS<Definition extends Config>(config: Definition): NextCMS<Definition>;
+export declare function createHandler(input: NextCMS | NextHandlerOptions): (request: Request) => Promise<Response>;