@bygghammar/cms-platform 0.45.0 → 0.46.1

package/src/config/define-site.ts

@@ -0,0 +1,102 @@
+/**
+ * One config contract for a whole site (Phase C).
+ *
+ * A site calls `defineSite({ config, seo, content, trips })` once and the
+ * package validates the shape at module-evaluation time, so a fresh copy fails
+ * immediately and with a readable message rather than half-way through a
+ * backoffice screen. No third-party validator is used: the checks are explicit
+ * so the error text can name the exact site file that is wrong.
+ */
+
+import {
+  defineSiteConfig,
+  registerSiteConfig,
+  type SiteConfig,
+  type SiteConfigInput,
+} from "./site-config";
+
+/** SEO/route registry entry for one page key. */
+export type SiteRouteEntry = {
+  /** Slug per locale, without a leading slash. Empty string means the home page. */
+  slug: Record<string, string>;
+  /** Optional per-locale title/description defaults. */
+  title?: Record<string, string>;
+  description?: Record<string, string>;
+  /** Excluded from the sitemap when false. */
+  indexable?: boolean;
+};
+
+/** The full site definition a host passes in. */
+export type SiteDefinitionInput = {
+  config: SiteConfigInput;
+  /** Page key → route/SEO entry. */
+  seo: Record<string, SiteRouteEntry>;
+  /** Code defaults for the shared content sections. */
+  content: Record<string, unknown>;
+  /** Trips module configuration; required when `features.trips` is on. */
+  trips?: Record<string, unknown>;
+};
+
+/** The validated, registered site definition. */
+export type SiteDefinition = {
+  config: SiteConfig;
+  seo: Record<string, SiteRouteEntry>;
+  content: Record<string, unknown>;
+  trips: Record<string, unknown>;
+};
+
+let current: SiteDefinition | null = null;
+
+function fail(message: string): never {
+  throw new Error(`Invalid site definition — ${message} (check your src/site.config.ts).`);
+}
+
+/**
+ * Validates and registers the site definition. Returns it so the calling module
+ * has a real runtime export and cannot be tree-shaken away.
+ */
+export function defineSite(input: SiteDefinitionInput): SiteDefinition {
+  const config = defineSiteConfig(input.config);
+
+  if (!input.seo || typeof input.seo !== "object") fail("`seo` must be a page-key → entry map");
+  const locales = config.locales;
+
+  const home = Object.entries(input.seo).find(([, entry]) =>
+    Object.values(entry.slug ?? {}).some((s) => s === ""),
+  );
+  if (Object.keys(input.seo).length > 0 && !home)
+    fail("no page in `seo` has an empty slug, so the site has no home page");
+
+  for (const [key, entry] of Object.entries(input.seo)) {
+    if (!entry || typeof entry !== "object") fail(`seo["${key}"] is not an object`);
+    if (!entry.slug || typeof entry.slug !== "object") fail(`seo["${key}"].slug is missing`);
+    for (const locale of locales) {
+      if (typeof entry.slug[locale] !== "string")
+        fail(`seo["${key}"].slug is missing the "${locale}" locale`);
+    }
+  }
+
+  if (!input.content || typeof input.content !== "object")
+    fail("`content` must be an object of shared-section defaults");
+
+  if (config.features.trips && !input.trips)
+    fail("`features.trips` is enabled but no `trips` config was supplied");
+
+  const definition: SiteDefinition = {
+    config: registerSiteConfig(config),
+    seo: input.seo,
+    content: input.content,
+    trips: input.trips ?? {},
+  };
+  current = definition;
+  return definition;
+}
+
+/** Reads the registered site definition, failing loudly when absent. */
+export function siteDefinition(): SiteDefinition {
+  if (!current)
+    throw new Error(
+      "Site definition not registered — call defineSite() from src/site.config.ts before rendering.",
+    );
+  return current;
+}

package/src/server/schema-drift.ts

@@ -0,0 +1,108 @@
+/**
+ * Canonical schema baseline shipped with this package version.
+ *
+ * `SCHEMA_MIGRATIONS` is the ordered list of migration files under
+ * `@bygghammar/cms-platform/migrations`. A site compares it to the migrations
+ * its database has actually applied so drift is visible in the backoffice
+ * version screen instead of surfacing as a runtime error months later.
+ */
+
+/** Every canonical migration filename, oldest first. */
+export const SCHEMA_MIGRATIONS: readonly string[] = [
+  "20260728113741_f9744b19-078b-46e5-b00f-31c84aaf71ab.sql",
+  "20260728113757_4156a886-21fb-4a1f-9c12-acb7bb145102.sql",
+  "20260728113823_6e0237e1-99e3-4e1a-8a68-804b7bcdbbb8.sql",
+  "20260728115305_506d92b4-129f-4d2b-961f-cf76e592677e.sql",
+  "20260728115320_717d4447-f433-4a1d-89d2-fc8f028d4ac6.sql",
+  "20260728115347_c77f5a56-19db-4117-bb60-9ad692b817ab.sql",
+  "20260728132052_b692dcfe-a944-4a19-afd0-187f7600feb8.sql",
+  "20260728183318_05b05a47-ba05-4a66-ab8f-69f2688fea84.sql",
+  "20260728193035_84b68d27-c3f3-4516-a3a9-15fc6f476163.sql",
+  "20260728193707_8438ee2d-d589-4048-86e2-464fd209af80.sql",
+  "20260729055312_08862d7e-0279-4d4f-8709-a59b9f068c55.sql",
+  "20260729055348_418b7e36-4877-4304-831f-290ca73e56f3.sql",
+  "20260729055358_20b467e2-4efd-42c1-bd34-773ed6b77fc5.sql",
+  "20260729061039_306859eb-a38c-44ef-af1a-6c02a8fd84db.sql",
+  "20260730065600_54c25861-3355-4600-a72f-3d67b457ecb1.sql",
+  "20260730071745_d4904314-15ff-4c58-ac66-85e7371e04b5.sql",
+  "20260730071914_48163aa3-830e-4dcc-bdd4-c35be282ab87.sql",
+  "20260730085949_bcfc3270-ea80-4617-86a3-2555ed34a280.sql",
+  "20260730095256_c977c30e-b285-4041-8804-c0bd72b6d9b3.sql",
+  "20260730100057_e341b887-eb0e-4a74-850e-0ee5ffb70d7a.sql",
+  "20260730103703_d5c4e1b7-1e2c-4dd0-be4e-185c159ade69.sql",
+  "20260730105635_3557b7da-919e-48db-8c92-8221d68d3cf9.sql",
+  "20260730120308_12ff8cfb-43f9-4070-abde-61531ad3b75f.sql",
+  "20260730125024_1baf8926-12a2-48f4-8edc-7309941309e9.sql",
+  "20260730173510_feb974d1-510e-4f52-9e20-5fd0582d8952.sql",
+  "20260730175409_9f60743f-f5e1-418c-a700-c91fb3704db8.sql",
+  "20260730181224_1c52ff16-c7a2-4ef1-a0a8-e493c2c9106f.sql",
+  "20260730183129_933adb75-f985-4d82-ad5d-213b69fd42e5.sql",
+  "20260730183918_7bc7a827-2100-49f1-bc6e-24509249350b.sql",
+  "20260730202628_7ceade5e-644c-4bc2-91b8-594133329f31.sql",
+  "20260730211056_57f42049-00b4-473b-a2cd-65a13570b8d2.sql",
+  "20260730214340_98af2e55-9031-4c11-9659-c47a37a8d6b7.sql",
+  "20260731091630_8a6f28ce-5833-4901-ab17-27648cef32ec.sql",
+  "20260731094716_4c68a1df-83ed-4ba8-8019-fa2fe2b9681e.sql",
+  "20260731191655_fef97c3c-1397-47b4-8b56-afb020298e97.sql",
+  "20260731192212_95772a2f-19a1-4013-b463-2eb161e96737.sql",
+  "20260731192815_c490653e-1232-4ad9-a150-3c83d2b90f5e.sql",
+  "20260731193135_7966e740-5e86-4b14-8e1d-5119069666ba.sql",
+  "20260731193245_599790d0-ca5e-4b5d-a3e7-d69b2a79e1a3.sql",
+  "20260731212959_a748cb0d-4dc7-45dc-be90-f6bacbfab26c.sql",
+  "20260801003057_1195f4c1-fb54-42dc-9718-638a25e6a82e.sql",
+  "20260801003300_fc591960-cb41-41cf-837d-2eef23b29ca9.sql",
+  "20260802151445_a56b0023-eaf7-41e2-a7fb-d4beddfc587c.sql",
+  "20260802202621_d661af8a-8513-4b54-b375-f963ae824c8f.sql",
+  "20260802202702_c30cd837-744c-4641-85f1-edd3a7ebbcb6.sql",
+  "20260802202720_4418d18d-c851-42dc-9345-78fc330128ae.sql",
+  "20260803132514_78ba1f53-c85b-4457-96b1-7d49c5c8b494.sql",
+  "20260803181201_28c8aa09-baa8-431c-8338-90b1af9c8172.sql",
+  "20260803201518_6e8a6028-b70f-4a7d-8bc9-95c86304e7ae.sql",
+  "20260803201535_32a9a213-cb92-4035-b8cd-8211ca34af68.sql",
+  "20260811103505_29df753d-14fa-4a05-8fea-f4207785fba3.sql",
+  "20260811130318_7cb95e95-9baa-40af-8f3f-de1d4e09cec4.sql",
+  "20260818040722_1bdf1b8f-7fb0-4ae8-8ecf-73f1fadff3c2.sql",
+  "20260818040808_69a5e832-57e8-4aa7-aff8-7fd7777faa7c.sql",
+  "20260818040839_e6523163-bbf5-4a39-9233-91759059569a.sql",
+];
+
+/** Schema baseline version = the newest canonical migration. */
+export const SCHEMA_BASELINE = SCHEMA_MIGRATIONS[SCHEMA_MIGRATIONS.length - 1] ?? "";
+
+/** The result of comparing a database against the packaged baseline. */
+export type SchemaDrift = {
+  /** True when the database matches the packaged baseline exactly. */
+  inSync: boolean;
+  /** Canonical migrations the database has not applied. */
+  missing: string[];
+  /** Migrations applied in the database that this package does not know about. */
+  extra: string[];
+  expectedCount: number;
+  appliedCount: number;
+  baseline: string;
+};
+
+/**
+ * Compares applied migration names (as recorded by the migration tooling)
+ * against the packaged baseline. Version suffixes are ignored so a site that
+ * records `20260728113741` matches `20260728113741_<uuid>.sql`.
+ */
+export function compareSchema(applied: readonly string[]): SchemaDrift {
+  const norm = (n: string) => n.replace(/\.sql$/, "").split("_")[0] ?? n;
+  const appliedIds = new Set(applied.map(norm));
+  const expectedIds = new Map(SCHEMA_MIGRATIONS.map((n) => [norm(n), n]));
+
+  const missing = [...expectedIds]
+    .filter(([id]) => !appliedIds.has(id))
+    .map(([, name]) => name);
+  const extra = applied.filter((n) => !expectedIds.has(norm(n)));
+
+  return {
+    inSync: missing.length === 0 && extra.length === 0,
+    missing,
+    extra,
+    expectedCount: SCHEMA_MIGRATIONS.length,
+    appliedCount: applied.length,
+    baseline: SCHEMA_BASELINE,
+  };
+}