alinea 2.0.0-preview.7 → 2.0.0-preview.8

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

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

package/dist/LICENSES.md

@@ -2,7 +2,7 @@ This file contains the licenses of the bundled modules in this distribution.
 
 ===
 
-# 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,60 +236,7 @@ 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)
-
-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
-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.
-
-
-===
-
-# @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,38 +703,11 @@ 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.
-
-
-===
-
-# 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
@@ -991,11 +937,11 @@ SOFTWARE.
 
 ===
 
-# @badgateway/oauth2-client@3.3.1 (MIT)
+# jotai-location@0.6.2 (MIT)
 
-MIT License
+The MIT License (MIT)
 
-Copyright (c) 2019-2025 Evert Pot
+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
@@ -1004,25 +950,25 @@ 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.
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
 
 
 ===
 
-# @tiptap/extension-list@3.30.5 (MIT)
+# jotai-family@1.1.0 (MIT)
 
 MIT License
 
-Copyright (c) 2025, Tiptap GmbH
+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
@@ -1045,34 +991,38 @@ SOFTWARE.
 
 ===
 
-# htmlparser2@9.1.0 (MIT)
+# @badgateway/oauth2-client@3.3.1 (MIT)
+
+MIT License
+
+Copyright (c) 2019-2025 Evert Pot
 
-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.
+
 
 ===
 
-# use-sync-external-store@1.6.0 (MIT)
+# @tiptap/extension-list@3.30.5 (MIT)
 
 MIT License
 
-Copyright (c) Meta Platforms, Inc. and affiliates.
+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
@@ -1095,19 +1045,29 @@ SOFTWARE.
 
 ===
 
-# domutils@3.2.2 (BSD-2-Clause)
+# use-sync-external-store@1.6.0 (MIT)
 
-Copyright (c) Felix Böhm
-All rights reserved.
+MIT License
 
-Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+Copyright (c) Meta Platforms, Inc. and affiliates.
 
-Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+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:
 
-Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-THIS IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS,
-EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+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.
 
 
 ===
@@ -1137,6 +1097,29 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 
+===
+
+# 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)
@@ -1154,6 +1137,23 @@ THIS IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRE
 EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 
+===
+
+# domutils@3.2.2 (BSD-2-Clause)
+
+Copyright (c) Felix Böhm
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+THIS IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS,
+EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
 ===
 
 # entities@4.5.0 (BSD-2-Clause)
@@ -1190,7 +1190,7 @@ THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 ===
 
-# @internationalized/string@3.2.8 (Apache-2.0)
+# @internationalized/number@3.6.6 (Apache-2.0)
 
                                  Apache License
                            Version 2.0, January 2004
@@ -1397,7 +1397,7 @@ THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 ===
 
-# @internationalized/number@3.6.6 (Apache-2.0)
+# @internationalized/string@3.2.8 (Apache-2.0)
 
                                  Apache License
                            Version 2.0, January 2004

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 {};