create-smoodly-app 0.0.37 → 0.0.39

package/templates/blank-intl/package.json

@@ -4,7 +4,7 @@
   "type": "module",
   "scripts": {
     "dev": "next dev",
-    "build": "next build",
+    "build": "smoodly migrate --check && next build",
     "start": "next start",
     "seed": "tsx scripts/seed.ts",
     "typecheck": "tsc --noEmit"
@@ -14,7 +14,7 @@
     "next": "^16.3.4",
     "react": "^19",
     "react-dom": "^19",
-    "smoodly": "0.0.37",
+    "smoodly": "0.0.39",
     "next-intl": "^4.14.2"
   },
   "devDependencies": {

package/templates/blank-intl/scripts/seed.ts

@@ -1,25 +1,30 @@
-// The starter's content, written through the stores (never raw inserts:
-// the refs index and publish integrity are part of the point). Ships in
-// the scaffold; create-smoodly-app runs `npm run seed` after the first
-// editor. Idempotent: exits once the home page exists in the default
-// locale. Writes the same copy into every configured locale, whatever
+// The starter's content, written through the content API (`content()`
+// from smoodly/server.ts): the admin's own operations, so validation and
+// the publish checks apply and a failure throws. It is also the example
+// of writing content from code. Ships in the scaffold; create-smoodly-app
+// runs `npm run seed` after the first editor. Idempotent: exits once the
+// home page has content in the default locale. Writes the same copy into every configured locale, whatever
 // their codes, so every locale's "/" resolves.
 // Run: npm run seed  (needs .env.local and a Supabase stack).
 import next from "@next/env";
-import type { PageTree } from "smoodly";
+import type { PageTree, TreeNode } from "smoodly";
 const { loadEnvConfig } = next;
 
 loadEnvConfig(process.cwd());
 
 const { config } = await import("../smoodly/config");
-const { stores } = await import("../smoodly/server");
-const { pages, entries } = stores();
+const { content, node } = await import("../smoodly/server");
+const { Text } = await import("../components/sections/Text");
+const c = content();
 
 const DEFAULT = config.locales.default;
 const OTHERS = config.locales.supported.filter((l) => l !== DEFAULT);
 
-if (await pages.resolvePath(DEFAULT, "/")) {
-  console.log(`Already seeded — "home" exists in "${DEFAULT}".`);
+// The home page is code-owned: `find` returns its record, creating it when
+// the database is new. It is seeded once somebody has given it sections.
+const home = (await c.pages.find(DEFAULT, "/"))!;
+if (Object.values((await c.pages.getTree(home.id, DEFAULT))?.zones ?? {}).some((nodes) => nodes.length > 0)) {
+  console.log(`Already seeded — the home page has content in "${DEFAULT}".`);
   process.exit(0);
 }
 
@@ -31,54 +36,47 @@ const doc = (...content: Node[]) => ({ type: "doc", content });
 
 // --- the site item: name and tagline, published in every locale ------
 
-const site = await entries.create("site", { name: "My site", tagline: "Built with Smoodly" }, { locale: DEFAULT });
-await entries.setStatus("site", site.id, DEFAULT, "published");
-for (const locale of OTHERS) {
-  await entries.addLocale("site", site.id, locale, { from: DEFAULT });
-  await entries.setStatus("site", site.id, locale, "published");
+for (const locale of [DEFAULT, ...OTHERS]) {
+  await c.globals.set("site", locale, { name: "My site", tagline: "Built with Smoodly" });
+  await c.globals.publish("site", locale);
 }
 
 // --- the home page: one Text section and one custom section ----------
 
-const tree = {
+// The custom section is not a registered section, so it is a plain node object.
+const custom: TreeNode = {
+  id: "node-custom",
+  type: "custom",
+  fields: { rows: [
+    { spans: [6, 6], gap: "md", align: "top", reverse: false, columns: [
+      doc(p("A custom section holds rows of columns. Drag the width bar in the inspector to resize them.")),
+      doc(p("Each column is richtext. Columns stack on small screens; the developer's stylesheet needs nothing.")),
+    ] },
+  ] },
+};
+
+const tree: PageTree = {
   meta: { description: "A new site, built with Smoodly." },
   zones: {
     body: [
-      {
-        id: "node-hello",
-        type: "text",
-        settings: { background: "paper" },
-        fields: {
-          title: "Hello",
-          body: doc(
-            p("This is your home page. Open the admin to edit this text, add sections, create pages and write posts."),
-            p("Everything you see is defined in components/ and registered in smoodly/. The README says where things are."),
-            button("Open the admin", "/admin"),
-          ),
-        },
-      },
+      node(Text, {
+        title: "Hello",
+        body: doc(
+          p("This is your home page. Open the admin to edit this text, add sections, create pages and write posts."),
+          p("Everything you see is defined in components/ and registered in smoodly/. The README says where things are."),
+          button("Open the admin", "/admin"),
+        ),
+      }, { id: "node-hello", settings: { background: "paper" } }),
       // The custom section: the editor's own rows of columns, rendered by Smoodly.
-      {
-        id: "node-custom",
-        type: "custom",
-        fields: { rows: [
-          { spans: [6, 6], gap: "md", align: "top", reverse: false, columns: [
-            doc(p("A custom section holds rows of columns. Drag the width bar in the inspector to resize them.")),
-            doc(p("Each column is richtext. Columns stack on small screens; the developer's stylesheet needs nothing.")),
-          ] },
-        ] },
-      },
+      custom,
     ],
   },
-} as unknown as PageTree;
+};
 
-const home = await pages.createPage({ locale: DEFAULT, slug: "home", title: "Home", template: "home", fixed: "page:home" });
-await pages.saveDraft(home.id, DEFAULT, tree);
-await pages.publish(home.id, DEFAULT);
-for (const locale of OTHERS) {
-  await pages.addLocale(home.id, locale, { from: DEFAULT, title: "Home" });
-  await pages.saveDraft(home.id, locale, tree);
-  await pages.publish(home.id, locale);
+// The home page exists in every locale already (its registration says so): write the tree and publish.
+for (const locale of [DEFAULT, ...OTHERS]) {
+  await c.pages.setTree(home.id, locale, tree);
+  await c.pages.publish(home.id, locale);
 }
 
 console.log(`Seeded the blank starter in "${[DEFAULT, ...OTHERS].join('", "')}": the home page and the site item, published.`);

package/templates/blank-intl/smoodly/collections.ts

@@ -6,7 +6,7 @@ import { text } from "./toolsets";
 // .localized() are stored per locale; the rest are shared across
 // locales. To add a collection: copy this block, add it to
 // `collections`, run `npx smoodly migrate` and apply the file it writes
-// (supabase db push, or supabase db reset locally).
+// (supabase db push, or supabase migration up locally).
 export const posts = smoodly.collection({
   name: "posts",
   title: "Posts",

package/templates/blank-intl/smoodly/ops.ts

@@ -4,8 +4,8 @@
 // async functions — hence the shape.)
 import { createAdminOpHandler, type AdminOpCall } from "smoodly/admin/next";
 import { config } from "./config";
-import { adminAuth, href, stores } from "./server";
+import { adminDeps } from "./server";
 
 export async function smoodlyOp(call: AdminOpCall) {
-  return createAdminOpHandler({ config, ...stores(), auth: adminAuth(), href })(call);
+  return createAdminOpHandler({ config, ...adminDeps() })(call);
 }

package/templates/blank-intl/smoodly/server.ts

@@ -1,6 +1,8 @@
 // Server-only glue: the client, the stores, the site layer and the
 // renderer, constructed lazily so `next build` doesn't need env vars at
-// import time. The env shape is the package's (SMOODLY_*); whether the
+// import time. The env shape is the package's (SMOODLY_*): the live site
+// needs SMOODLY_URL and SMOODLY_SECRET_KEY, the admin also
+// SMOODLY_PUBLISHABLE_KEY (the `smoodlyEnv("admin")` calls below); whether the
 // secret is a service-role key or a cloud write key is invisible here.
 //
 // Lazy on purpose, the site and renderer included: config.ts imports the
@@ -14,7 +16,7 @@ import {
 // The admin gate from `smoodly/admin`, which holds no client code: the site
 // routes import this file, and `smoodly/admin/next` would put the admin
 // shell in every live page's JavaScript.
-import { supabaseAdminAuth, type AdminAuth, type AuthConfig } from "smoodly/admin";
+import { createSmoodlyContent, supabaseAdminAuth, type AdminAuth, type AuthConfig, type SmoodlyContent } from "smoodly/admin";
 import { createPageRenderer, createSmoodlyQueries, type PageRegistration } from "smoodly/next";
 import type { SupabaseClient } from "@supabase/supabase-js";
 import { getPathname } from "@/i18n/navigation";
@@ -51,8 +53,7 @@ function bound(): Bound {
   // The admission table, read by the Members page (spec 2026-09-25 §4).
   const members = new SupabaseMemberStore(db);
   const auth = supabaseAdminAuth({ authUrl: env.authUrl, authKey: env.authKey, db });
-  // Shadows the exported `stores` below on purpose: `createSmoodlySite`
-  // takes this local closure, not the export, so it never re-enters `bound()`.
+  // The site layer's own view of the stores; nothing outside this file reads them.
   const stores = () => ({ pages, entries, assets });
   // The site layer: (locale, path) → page or entry, and the content API
   // `q` wraps below. Not exported — the app reads through `q`, which adds
@@ -71,27 +72,37 @@ function bound(): Bound {
   return cached;
 }
 
-export function stores() {
+/** The admin's wiring, for `smoodly/ops.ts` only. Scripts write through `content()`. */
+export function adminDeps() {
+  smoodlyEnv("admin"); // the admin signs in with the publishable key: a missing one is named here, not on a live page
+  const { pages, entries, assets, members, auth } = bound();
+  return { pages, entries, assets, members, auth, href };
+}
+
+/** Write content from code — seeds, migrations, route handlers (spec 2026-09-30 tester findings §1).
+ *  The admin's own operations with no signed-in editor: validation and publish checks apply, a failure
+ *  throws `SmoodlyContentError`. `content().pages.create(…)`, `.entries.create(…)`, `.globals.set(…)`,
+ *  `.media.upload(…)`; build tree nodes with `node(Section, fields)`. */
+export function content(): SmoodlyContent {
   const { pages, entries, assets, members } = bound();
-  return { pages, entries, assets, members };
+  return createSmoodlyContent({ config, pages, entries, assets, members, href });
 }
 
+export { node } from "smoodly";
+
 /** The server-side client (seed script, one-off admin tasks). */
 export const client = () => bound().db;
 
-/** The admin gate: session verified against the auth project, editors row read with the write key. */
-export const adminAuth = () => bound().auth;
-
 /** What the browser needs to sign in — public values only. */
 export function publicAuth(): AuthConfig {
-  const env = smoodlyEnv();
+  const env = smoodlyEnv("admin");
   return { url: env.authUrl, key: env.authKey };
 }
 
 /** What the browser needs to join the editing-presence channel — public values only (spec 2026-09-26 concurrency §5).
  * The space is asked of the database once per process. */
 export function presence(): Promise<PresenceConfig> {
-  return presenceConfig(smoodlyEnv());
+  return presenceConfig(smoodlyEnv("admin"));
 }
 
 /** Locale-relative CMS path → site URL: the one seam for the renderer

package/templates/lorem/AGENTS.md

@@ -13,14 +13,16 @@ where things are.
   is the one registry. A component that is not registered does not exist
   for the admin.
 - **After a new collection or a `smoodly` upgrade, run `npx smoodly migrate`**
-  and apply what it writes (`supabase db push` hosted, `supabase db reset`
+  and apply what it writes (`supabase db push` hosted, `supabase migration up`
   local). It copies the core schema files the package ships and writes a
   read view and order index per collection. Never edit a file it wrote.
   The admin reads the base tables, so it lists a collection either way;
   the view is for SQL and PostgREST readers, the index for `order`.
-- **Seed through the stores.** `scripts/seed.ts` is starter content,
-  written through the page and entry stores, never raw SQL. It is
-  idempotent; run it with `npm run seed`.
+- **Content from code goes through `content()`.** `scripts/seed.ts` is
+  starter content written with `content()` from `smoodly/server.ts`:
+  the admin's own operations, so validation and publish checks apply and
+  a failure throws. Never write rows or call the stores directly. The
+  seed is idempotent; run it with `npm run seed`.
 - **Never import the admin into the site.** Nothing under `app/(site)`,
   `app/[locale]` or `components/`, and nothing they import
   (`smoodly/server.ts` included), may import `@/smoodly/admin` or
@@ -50,6 +52,6 @@ where things are.
 ## Commands
 
     npm run dev          # http://localhost:3000, /admin is the editor
-    npm run build        # next build
+    npm run build        # checks the schema files (smoodly migrate --check), then next build
     npm run seed         # starter content, idempotent
     npm run typecheck    # tsc --noEmit

package/templates/lorem/README.md

@@ -16,9 +16,9 @@ for an agent (or a person) building the site.
 - `components/sections/` — the building blocks editors compose with, and the header, footer and quote behind the global items. Add one, list it in `smoodly/sections.ts`.
 - `components/strings.ts`, `messages/` — the site's own UI strings and the request locale, one seam.
 - `public/images/` — the starter's photos; image fields hold URLs like `/images/hero_image.jpg`.
-- `scripts/seed.ts` — the starter content, written through the stores. `npm run seed` is idempotent.
+- `scripts/seed.ts` — the starter content, written through the content API (`content()`). `npm run seed` is idempotent.
 - `smoodly/collections.ts` — structured content (people, articles, news). Add a collection, run `npx smoodly migrate`, apply the file it writes.
-- `smoodly/` — the wiring: `config.ts` (the registry and settings), `collections.ts`, `sections.ts`, `server.ts` (stores, site layer, renderer), `ops.ts` (the admin's one server action), `admin.tsx` (the admin mount).
+- `smoodly/` — the wiring: `config.ts` (the registry and settings), `collections.ts`, `sections.ts`, `server.ts` (site layer, renderer, the content API `content()`), `ops.ts` (the admin's one server action), `admin.tsx` (the admin mount).
 - `.env.local` — `SMOODLY_URL`, `SMOODLY_SECRET_KEY`, `SMOODLY_PUBLISHABLE_KEY`.
 
 ## What is in the starter

package/templates/lorem/_gitignore

@@ -3,3 +3,4 @@ node_modules/
 .env.local
 next-env.d.ts
 *.tsbuildinfo
+smoodly-export-*

package/templates/lorem/package.json

@@ -4,7 +4,7 @@
   "type": "module",
   "scripts": {
     "dev": "next dev",
-    "build": "next build",
+    "build": "smoodly migrate --check && next build",
     "start": "next start",
     "seed": "tsx scripts/seed.ts",
     "typecheck": "tsc --noEmit"
@@ -14,7 +14,7 @@
     "next": "^16.3.4",
     "react": "^19",
     "react-dom": "^19",
-    "smoodly": "0.0.37"
+    "smoodly": "0.0.39"
   },
   "devDependencies": {
     "@next/env": "^16.3.4",