@gradial/aci 0.1.45 → 0.1.47

package/templates/common/starter-content/.content/pages/home/_index.json

@@ -4,14 +4,13 @@
   "status": "published",
   "layout": "default",
   "metadata": {
-    "title": "Meridian — Global Satellite Internet",
+    "title": "Meridian \u2014 Global Satellite Internet",
     "description": "Connect from anywhere on Earth. Low-latency satellite internet for homes, businesses, and beyond.",
     "canonical": "https://www.meridian.local/"
   },
   "regions": {
     "main": [
       {
-        "$type": "component",
         "id": "hero",
         "component": "home_hero",
         "props": {
@@ -28,7 +27,6 @@
         }
       },
       {
-        "$type": "component",
         "id": "why-meridian",
         "component": "feature_grid",
         "props": {
@@ -36,7 +34,6 @@
           "subtitle": "Engineered for the edges of the world.",
           "features": [
             {
-              "$type": "component",
               "id": "global-coverage",
               "component": "feature_card",
               "props": {
@@ -46,7 +43,6 @@
               }
             },
             {
-              "$type": "component",
               "id": "low-latency",
               "component": "feature_card",
               "props": {
@@ -56,7 +52,6 @@
               }
             },
             {
-              "$type": "component",
               "id": "easy-setup",
               "component": "feature_card",
               "props": {
@@ -69,20 +64,34 @@
         }
       },
       {
-        "$type": "component",
         "id": "stats",
         "component": "stats_bar",
         "props": {
           "stats": [
-            { "label": "Network uptime", "value": "99.9", "suffix": "%" },
-            { "label": "Average latency", "value": "<50", "suffix": "ms" },
-            { "label": "Countries covered", "value": "40", "suffix": "+" },
-            { "label": "Orbital satellites", "value": "2,400", "suffix": "" }
+            {
+              "label": "Network uptime",
+              "value": "99.9",
+              "suffix": "%"
+            },
+            {
+              "label": "Average latency",
+              "value": "<50",
+              "suffix": "ms"
+            },
+            {
+              "label": "Countries covered",
+              "value": "40",
+              "suffix": "+"
+            },
+            {
+              "label": "Orbital satellites",
+              "value": "2,400",
+              "suffix": ""
+            }
           ]
         }
       },
       {
-        "$type": "component",
         "id": "cta",
         "component": "container",
         "props": {
@@ -90,7 +99,6 @@
           "className": "items-center justify-center text-center",
           "content": [
             {
-              "$type": "component",
               "id": "cta-primary",
               "component": "button",
               "props": {
@@ -102,7 +110,6 @@
               }
             },
             {
-              "$type": "component",
               "id": "cta-secondary",
               "component": "button",
               "props": {

package/templates/common/starter-content/.content/schemas/site.schema.json

@@ -7,6 +7,15 @@
   "additionalProperties": true,
   "properties": {
     "$type": { "const": "site" },
+    "errorPages": {
+      "type": "object",
+      "required": ["notFound", "catchAll"],
+      "additionalProperties": false,
+      "properties": {
+        "notFound": { "type": "string", "pattern": "^/(?:[A-Za-z0-9._~-]+/)+$" },
+        "catchAll": { "type": "string", "pattern": "^/(?:[A-Za-z0-9._~-]+/)+$" }
+      }
+    },
     "id": { "type": "string", "minLength": 1 },
     "status": { "type": "string", "minLength": 1 },
     "title": { "type": "string", "minLength": 1 },

package/templates/nextjs/template/package.json.tmpl

@@ -5,7 +5,7 @@
   "type": "module",
   "scripts": {
     "dev": "ACI_CONTENT_PROVIDER=file next dev -H 0.0.0.0",
-    "build": "next build",
+    "build": "node ./node_modules/@gradial/aci/src/cli/emit-error-pages.mjs prepare && next build && node ./node_modules/@gradial/aci/src/cli/emit-error-pages.mjs emit",
     "preview": "next start -H 0.0.0.0",
     "typecheck": "tsc --noEmit",
     "test": "node --import tsx --test tests/**/*.test.ts",

package/templates/nextjs/template/src/aci/error-page-instrumentation.d.mts

@@ -0,0 +1,4 @@
+// Type surface for the customer-owned policy module beside this file
+// (authorable-error-pages D-15). Edit the .mjs; this declaration only needs
+// touching if you change the function's signature.
+export declare function pushErrorPageView(pageType: 'not_found' | 'error'): void;

package/templates/nextjs/template/src/aci/error-page-instrumentation.mjs

@@ -0,0 +1,38 @@
+// Error-page analytics policy — THIS FILE IS YOURS (customer-owned;
+// code-organization R-14 / authorable-error-pages D-15). The ACI SDK owns
+// the delivery mechanism (when this runs, serialization, the
+// data-aci-error-page marker); this file owns WHAT is pushed.
+//
+// Contract:
+// - pushErrorPageView MUST stay self-contained: browser globals only — no
+//   imports, no closed-over identifiers. The Astro seats and the 500.html
+//   emitter execute it STRINGIFIED via toString(), so anything outside the
+//   function body is lost.
+// - Emptying the body to a no-op disables error-page analytics on every
+//   surface (Next seats, Astro seats, 500.html) — the sanctioned
+//   alternative to GTM-container-side suppression.
+// - Plain .mjs on purpose: it is consumed verbatim, never transpiled.
+//
+// 'use client' (Next only, inert elsewhere): the not-found seat is a server
+// component and can only hand a function to the client-side instrumentation
+// component as a client reference.
+'use client';
+
+/**
+ * Pushes one `page_view` event per error-surface view (D-14 default
+ * payload). `page_path` is the visitor's requested path, so 404 reports
+ * double as a broken-link inventory.
+ *
+ * @param {'not_found' | 'error'} pageType
+ */
+export function pushErrorPageView(pageType) {
+  window.dataLayer = window.dataLayer || [];
+  window.dataLayer.push({
+    event: 'page_view',
+    page_type: pageType,
+    page_path: window.location.pathname,
+    page_location: window.location.href,
+    page_referrer: document.referrer || '(direct)',
+    page_title: document.title,
+  });
+}

package/templates/nextjs/template/src/app/error.tsx

@@ -0,0 +1,18 @@
+'use client';
+
+import { ErrorSeat } from '@gradial/aci/next/error-seat';
+import { registry } from '@/cms/registry';
+import { pushErrorPageView } from '../aci/error-page-instrumentation.mjs';
+
+// Next's app-error seat (client-only by contract). ErrorSeat renders the
+// page bound by site.json#errorPages.catchAll from content serialized into
+// the bundle at build time — nothing is fetched while the app is failing.
+// The analytics push comes from the site-owned policy module (D-15):
+// edit src/aci/error-page-instrumentation.mjs to customize or disable it.
+//
+// Coverage: render errors below the root layout. NOT covered here: root
+// layout errors (global-error), middleware failures, and platform 5xx —
+// those are served the static public/500.html emitted by the build.
+export default function AppError({ error }: { error: Error & { digest?: string } }) {
+  return <ErrorSeat registry={registry} error={error} pushErrorPageView={pushErrorPageView} />;
+}

package/templates/nextjs/template/src/app/not-found.tsx

@@ -0,0 +1,13 @@
+import { createNotFound } from '@gradial/aci/next';
+import { registry } from '@/cms/registry';
+import { pushErrorPageView } from '../aci/error-page-instrumentation.mjs';
+
+// Next's native not-found seat: the SDK catch-all invokes notFound() on
+// missing content, and this renders the page bound by
+// site.json#errorPages.notFound with a real HTTP 404. If that page is itself
+// missing at request time, the SDK falls back to its shipped default inline —
+// this seat never recurses and never throws.
+//
+// The analytics push comes from the site-owned policy module (D-15):
+// edit src/aci/error-page-instrumentation.mjs to customize or disable it.
+export default createNotFound(registry, { pushErrorPageView });

package/src/types/block-ref.test.ts

@@ -1,45 +0,0 @@
-import assert from 'node:assert/strict';
-import test from 'node:test';
-import { z } from 'zod';
-
-import { compileSchema } from '../compiler/zod-to-jsonschema.js';
-import { defineComponentContract } from '../define-component.js';
-import { blockRefArray } from './block-ref.js';
-
-const childContract = defineComponentContract({
-  id: 'child',
-  props: z.object({
-    label: z.string(),
-  }),
-});
-
-test('block references require and accept the component discriminator', () => {
-  const schema = blockRefArray([childContract]);
-  const typed = {
-    $type: 'component',
-    id: 'child-1',
-    component: 'child',
-    props: { label: 'Hello' },
-  };
-
-  assert.equal(schema.safeParse([typed]).success, true);
-  assert.equal(schema.safeParse([{
-    id: typed.id,
-    component: typed.component,
-    props: typed.props,
-  }]).success, false);
-});
-
-test('compiled block-reference schema exposes the component discriminator', () => {
-  const compiled = compileSchema(blockRefArray([childContract])) as {
-    items?: {
-      properties?: Record<string, { const?: string }>;
-      required?: string[];
-      additionalProperties?: boolean;
-    };
-  };
-
-  assert.equal(compiled.items?.properties?.$type?.const, 'component');
-  assert.equal(compiled.items?.required?.includes('$type'), true);
-  assert.equal(compiled.items?.additionalProperties, false);
-});

package/templates/nextjs/template/src/app/collect/route.ts

@@ -1,18 +0,0 @@
-import {
-  createPersonalizationCollectRoute,
-  createVercelCollectionFromEnv,
-} from '@gradial/aci/next/vercel-personalization';
-
-export const runtime = 'nodejs';
-
-const personalization = createVercelCollectionFromEnv();
-const unavailable = async () => new Response('personalization host is not configured', {
-  status: 503,
-  headers: { 'Cache-Control': 'private, no-store' },
-});
-const collect = personalization
-  ? createPersonalizationCollectRoute(personalization)
-  : unavailable;
-
-export const POST = collect;
-export const OPTIONS = collect;