@backmatter/core 0.0.12 → 0.0.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backmatter/core",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "Experimental Backmatter SDK. APIs will break. Not ready for production.",
   "type": "module",
   "publishConfig": {

package/src/node/create-backmatter.ts

@@ -22,6 +22,11 @@ export type CreateBackmatterOptions<Models extends readonly ModelDef[] = readonl
      * `@backmatter/next` turns this on.
      */
     taggedApiFetch?: boolean;
+    /**
+     * When false, skip the boot-time schema PUT. Query clients (catch-all,
+     * revalidate) set this; `.backmatter/sync` leaves the default.
+     */
+    sync?: boolean;
   };
 
 export type BackmatterClient<Models extends readonly ModelDef[] = readonly ModelDef[]> = {
@@ -59,7 +64,7 @@ function toSnapshots(models: readonly ModelDef[]): ModelSnapshot[] {
 export function createBackmatter<const Models extends readonly ModelDef[]>(
   options: CreateBackmatterOptions<Models>,
 ): BackmatterClient<Models> {
-  const { models: modelDefs, blocks: blockDefs, taggedApiFetch, ...rest } = options;
+  const { models: modelDefs, blocks: blockDefs, taggedApiFetch, sync = true, ...rest } = options;
   const config = resolveConfig(rest);
   const models = toSnapshots(modelDefs);
   const siteRoot = config.siteRoot ?? process.cwd();
@@ -73,7 +78,7 @@ export function createBackmatter<const Models extends readonly ModelDef[]>(
   }
 
   // backmatter CLI imports the config to read models; never sync from there.
-  if (apiUrl && hostToken && workspaceId) {
+  if (sync && apiUrl && hostToken && workspaceId) {
     if (process.env.BACKMATTER_CLI === "1") {
       console.warn("backmatter: schema sync skipped (BACKMATTER_CLI=1)");
     } else {

package/src/node/generate.ts

@@ -95,7 +95,7 @@ export function detectSdk(root: string): string {
 
 function renderCachedCmsClient(): string[] {
   return [
-    "const raw = createBackmatter({ ...config, models });",
+    "const raw = createBackmatter({ ...config, models, sync: false });",
     "",
     "async function getDoc(locale: string, type: string, slug: string) {",
     '  "use cache";',
@@ -180,7 +180,7 @@ export function renderSyncBarrel(input: {
   lines.push(`export const blocks = [${input.blocks.map((b) => b.name).join(", ")}] as const;`);
   lines.push("");
   lines.push("/** Typed content client: cms.query.{type}, cms.getDoc, cms.listDocs. */");
-  lines.push("export const cms = createBackmatter({ ...config, models, blocks });");
+  lines.push("export const cms = createBackmatter({ ...config, models, blocks, sync: true });");
   return `${lines.join("\n")}\n`;
 }