ferst-core 0.9.1 → 0.9.2

package/bin/cms-config.mjs

@@ -108,18 +108,47 @@ export function deploymentBranch() {
   return 'main';
 }
 
+/** Ferst's managed GitHub org: its sites are on the Basic plan. */
+const MANAGED_OWNER = 'myai4webdev';
+
+/** The Pages collection's description on each plan. */
+const PAGES_DESCRIPTION = {
+  basic: "See each page and request a change — our team makes it and sends it back for you to check. You don't edit the page layout here.",
+  free: "You're on the free plan: you look after this site yourself and change its pages in your own repository. Asking the Ferst team to make changes for you comes with the Basic plan.",
+};
+
+/**
+ * The site's plan, for what its CMS offers. Requests (the Ferst team making a change for the
+ * site's people) come with the Basic plan: a managed site. A self-managed site, the client's
+ * own repo, is on the free plan and makes its own changes. The plan the platform records in
+ * `ferst-site.json` wins; otherwise the repo's owner decides. Unknown keeps the requests field:
+ * the platform refuses a free-plan site's request anyway.
+ * @param {string} repo owner/name
+ * @param {{ plan?: string }} [site] the parsed ferst-site.json
+ * @returns {'basic' | 'free'}
+ */
+export function planFor(repo, site = {}) {
+  if (site && (site.plan === 'basic' || site.plan === 'free')) return site.plan;
+  const owner = String(repo ?? '').split('/')[0].trim().toLowerCase();
+  if (!owner) return 'basic';
+  return owner === MANAGED_OWNER ? 'basic' : 'free';
+}
+
 /**
- * Fill the config template's placeholders. Pure — unit-testable.
+ * Fill the config template's placeholders. Pure — unit-testable. On the free plan the
+ * `# ferst:requests` … `# /ferst:requests` block (the pages' "Requested changes") is left out.
  * @param {string} tpl the template contents
- * @param {{ repo: string, base: string, branch: string }} vars
+ * @param {{ repo: string, base: string, branch: string, plan?: 'basic' | 'free' }} vars
  * @returns {string}
  */
-export function fillConfig(tpl, { repo, base, branch }) {
-  const out = tpl
+export function fillConfig(tpl, { repo, base, branch, plan = 'basic' }) {
+  const forPlan = plan === 'free' ? tpl.replace(/^[ \t]*# ferst:requests\b[\s\S]*?^[ \t]*# \/ferst:requests[^\n]*\n/m, '') : tpl;
+  const out = forPlan
     .split('__REPO__').join(repo)
     .split('__API_ROOT__').join(`${base}/git`)
     .split('__BASE_URL__').join(base)
-    .split('__BRANCH__').join(branch);
+    .split('__BRANCH__').join(branch)
+    .split('__PAGES_DESCRIPTION__').join(PAGES_DESCRIPTION[plan] ?? PAGES_DESCRIPTION.basic);
   const leftover = out.match(/__[A-Z][A-Z_]*__/);
   if (leftover) {
     throw new Error(`ferst-cms-config: unfilled placeholder ${leftover[0]} — add it to the filler.`);
@@ -147,9 +176,17 @@ function main() {
     process.exit(1);
   }
 
+  let site = {};
+  try {
+    site = JSON.parse(readFileSync(resolve(process.cwd(), 'ferst-site.json'), 'utf8')) ?? {};
+  } catch {
+    /* no ferst-site.json: the repo's owner decides the plan */
+  }
+  const plan = planFor(repo, site);
+
   let out;
   try {
-    out = fillConfig(tpl, { repo, base, branch });
+    out = fillConfig(tpl, { repo, base, branch, plan });
   } catch (e) {
     console.error(String(e.message ?? e));
     process.exit(1);
@@ -157,7 +194,7 @@ function main() {
 
   mkdirSync(dirname(outPath), { recursive: true });
   writeFileSync(outPath, out);
-  console.log(`ferst-cms-config: wrote ${outPath} (repo=${repo}, branch="${branch}", base=${base})`);
+  console.log(`ferst-cms-config: wrote ${outPath} (repo=${repo}, branch="${branch}", base=${base}, plan=${plan})`);
 }
 
 // Run when invoked directly as a bin — including via npm's node_modules/.bin symlink.

package/cms/config.template.yml

@@ -234,7 +234,7 @@ collections:
   - name: pages
     label: Pages
     label_singular: Page
-    description: "See each page and request a change — our team makes it and sends it back for you to check. You don't edit the page layout here."
+    description: "__PAGES_DESCRIPTION__"
     folder: src/content/pages
     extension: json
     format: json
@@ -244,6 +244,7 @@ collections:
     identifier_field: title
     fields:
       - { name: title, label: Page title, widget: string }
+      # ferst:requests (the Basic plan only: bin/cms-config.mjs leaves it out on the free plan)
       - name: requests
         label: Requested changes
         label_singular: Request
@@ -258,6 +259,7 @@ collections:
           - { name: issue, widget: hidden, required: false }
           - { name: by, widget: hidden, required: false }
           - { name: at, widget: hidden, required: false }
+      # /ferst:requests
       - { name: description, label: SEO description, widget: hidden, required: false }
       - { name: heroImage, widget: hidden, required: false }
       - { name: align, widget: hidden, required: false }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ferst-core",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "type": "module",
   "description": "Ferst Core — the shared, brand-agnostic client-site system: Astro components, layouts, content schemas, the layered config resolver, and a neutral styling architecture that every client overrides.",
   "license": "BUSL-1.1",