ferst-core 0.7.6 → 0.7.8

package/lib/forms.ts

@@ -0,0 +1,57 @@
+/**
+ * A form placed by id (the `form` block) is read from the Ferst platform at build time, so
+ * a change made to it in the portal reaches the site on its next build — no pasted copy of
+ * its fields to keep in step. A missing form or an unreachable platform fails the build:
+ * better the last good deploy stays live than a form that can't be sent goes out.
+ */
+export interface FormField {
+  name: string;
+  label: string;
+  type?: 'text' | 'email' | 'tel' | 'textarea';
+  required?: boolean;
+  placeholder?: string;
+}
+
+export interface FormDefinition {
+  name: string;
+  submitLabel: string;
+  fields: FormField[];
+  /** Where the browser posts the form. */
+  action: string;
+}
+
+type FetchFn = (input: string, init?: RequestInit) => Promise<Response>;
+
+const cache = new Map<string, Promise<FormDefinition>>();
+
+export function loadFormDefinition(id: string, opts: { base: string; fetch?: FetchFn }): Promise<FormDefinition> {
+  const key = `${opts.base}|${id}`;
+  let hit = cache.get(key);
+  if (!hit) {
+    hit = fetchDefinition(id, opts.base, opts.fetch ?? fetch);
+    cache.set(key, hit);
+    hit.catch(() => cache.delete(key)); // a failure is retried by the next caller
+  }
+  return hit;
+}
+
+async function fetchDefinition(id: string, base: string, fetchFn: FetchFn): Promise<FormDefinition> {
+  const url = `${base}/forms/${encodeURIComponent(id)}`;
+  let res: Response;
+  try {
+    res = await fetchFn(url, { headers: { Accept: 'application/json' } });
+  } catch (e) {
+    throw new Error(`Form block: couldn’t reach the Ferst platform for form "${id}" (${url}): ${e instanceof Error ? e.message : String(e)}`);
+  }
+  if (res.status === 404) {
+    throw new Error(`Form block: form "${id}" was not found — it may have been archived. Check the id in the portal (Forms), or run \`npx ferst-modules\` to list this site's forms.`);
+  }
+  if (!res.ok) throw new Error(`Form block: the Ferst platform answered ${res.status} for form "${id}" (${url}).`);
+  const def = (await res.json()) as { name: string; submit_label?: string; fields?: FormField[] };
+  return {
+    name: def.name,
+    submitLabel: def.submit_label || 'Send',
+    fields: def.fields ?? [],
+    action: `${base}/forms/${encodeURIComponent(id)}/submit`,
+  };
+}

package/lib/slug.ts

@@ -9,7 +9,7 @@ export function slugify(text: string): string {
     .normalize('NFKD')
     .replace(/[̀-ͯ]/g, '') // accents
     .toLowerCase()
-    .replace(/['’]/g, '') // apostrophes join the word ("joachim's" → "joachims")
+    .replace(/['’]/g, '') // apostrophes join the word ("anne's" → "annes")
     .replace(/[^a-z0-9]+/g, '-')
     .replace(/^-+|-+$/g, '')
     .slice(0, 60)

package/package.json

@@ -1,69 +1,70 @@
-{
-  "name": "ferst-core",
-  "version": "0.7.6",
-  "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",
-  "author": "MyAI4 Ltd (https://ferst.co.uk)",
-  "homepage": "https://ferst.co.uk",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/MyAI4WebDev/myai4-ferst-core.git",
-    "directory": "packages/core"
-  },
-  "bugs": {
-    "url": "https://github.com/MyAI4WebDev/myai4-ferst-core/issues"
-  },
-  "keywords": [
-    "astro",
-    "astro-component",
-    "cms",
-    "sveltia",
-    "website",
-    "design-tokens",
-    "ferst"
-  ],
-  "scripts": {
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
-  "sideEffects": [
-    "**/*.css"
-  ],
-  "files": [
-    "bin",
-    "cms",
-    "components",
-    "integration.mjs",
-    "layouts",
-    "content",
-    "examples",
-    "lib",
-    "routes",
-    "utils",
-    "styles",
-    "fonts",
-    "README.md",
-    "NOTICE",
-    "LICENSE",
-    "LICENSE-Apache-2.0"
-  ],
-  "bin": {
-    "ferst-check-thin": "bin/check-thin.mjs",
-    "ferst-set-cms-branch": "bin/set-cms-branch.mjs",
-    "ferst-cms-config": "bin/cms-config.mjs",
-    "ferst-update": "bin/ferst-update.mjs"
-  },
-  "dependencies": {
-    "zod": "^3.25.0"
-  },
-  "devDependencies": {
-    "vitest": "^3.0.0"
-  },
-  "peerDependencies": {
-    "astro": "^5.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "ferst-core",
+  "version": "0.7.8",
+  "type": "module",
+  "description": "Ferst Core \u2014 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",
+  "author": "MyAI4 Ltd (https://ferst.co.uk)",
+  "homepage": "https://ferst.co.uk",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MyAI4WebDev/myai4-ferst-core.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/MyAI4WebDev/myai4-ferst-core/issues"
+  },
+  "keywords": [
+    "astro",
+    "astro-component",
+    "cms",
+    "sveltia",
+    "website",
+    "design-tokens",
+    "ferst"
+  ],
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "files": [
+    "bin",
+    "cms",
+    "components",
+    "integration.mjs",
+    "layouts",
+    "content",
+    "examples",
+    "lib",
+    "routes",
+    "utils",
+    "styles",
+    "fonts",
+    "README.md",
+    "NOTICE",
+    "LICENSE",
+    "LICENSE-Apache-2.0"
+  ],
+  "bin": {
+    "ferst-check-thin": "bin/check-thin.mjs",
+    "ferst-set-cms-branch": "bin/set-cms-branch.mjs",
+    "ferst-cms-config": "bin/cms-config.mjs",
+    "ferst-update": "bin/ferst-update.mjs",
+    "ferst-modules": "bin/ferst-modules.mjs"
+  },
+  "dependencies": {
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "vitest": "^3.0.0"
+  },
+  "peerDependencies": {
+    "astro": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}