@gradial/aci 0.1.53-rc.3 → 0.1.53-rc.5

package/CHANGELOG.md

@@ -2,8 +2,19 @@
 
 ## Unreleased
 
+### Fixed
+
+- Astro authored 404/500 helpers use the shared `getPageData` pipeline and
+  consume the selected render input during ACI
+  preview/publish, preserving authored content and styling in code artifacts
+  without compiled content snapshots. Unrelated or personalized inputs cannot
+  replace the bound base error page.
+
 ### Added
 
+- Public `aci schemas compile` and `aci error-pages prepare|emit` commands let
+  site build scripts compile code-owned artifacts without invoking SDK internals.
+
 - `AciRootProps` (the new name of `RootIdentityProps`, which stays as an
   alias) and `aciRootAttrs(props)`, exported from `@gradial/aci`.
 - The `rootIdentity` check covers every file that calls `createRegistry(`,

package/README.md

@@ -1,6 +1,6 @@
 # Agentic Content Infrastructure SDK
 
-`@gradial/aci` `0.1.53-rc.3` is a pre-1.0 public-surface reset for the ACI
+`@gradial/aci` `0.1.53-rc.5` is a pre-1.0 public-surface reset for the ACI
 client SDK. Breaking changes from the old `0.1.x` accidental surface are
 intentional: the root import is framework-neutral, framework runtime behavior is
 behind explicit subpaths, and the first required customer path is React/Next.
@@ -8,7 +8,7 @@ behind explicit subpaths, and the first required customer path is React/Next.
 ## Install
 
 ```bash
-npm install @gradial/aci@0.1.53-rc.3 zod@^4
+npm install @gradial/aci@0.1.53-rc.5 zod@^4
 ```
 
 ## Root Import
@@ -137,13 +137,13 @@ host bundles select and serve immutable release artifacts.
 The first RC scaffold path is Next:
 
 ```bash
-npx @gradial/aci@0.1.53-rc.3 init my-site --template next-starter
+npx @gradial/aci@0.1.53-rc.5 init my-site --template next-starter
 ```
 
 List available templates:
 
 ```bash
-npx @gradial/aci@0.1.53-rc.3 init --list
+npx @gradial/aci@0.1.53-rc.5 init --list
 ```
 
 ## Personalization: The One-Tag Install
@@ -223,3 +223,25 @@ From `packages/sdk`:
 pnpm run build
 pnpm run generate-starters
 ```
+
+## Public code-build commands
+
+Use the installed `aci` binary from npm scripts, not files beneath the package's
+`src`, `dist`, or `bin` directories:
+
+```json
+{
+  "scripts": {
+    "schemas:compile": "aci schemas compile",
+    "prebuild": "npm run schemas:compile",
+    "build": "aci error-pages prepare && next build && aci error-pages emit",
+    "content:compile": "npm run schemas:compile && aci content compile --content ./.content --out ./.aci/compiled"
+  }
+}
+```
+
+`schemas compile` reads the component/data registry paths from `.aci.yaml` and
+recompiles contracts without reading authored content. The error commands prepare
+code-owned analytics policy and emit the default hosting fallback (preserving a
+site-owned `public/500.html`). All three honor `--site-dir`; helper failures exit
+nonzero. Local development/content validation must explicitly compile content.

package/dist/astro/error-page.d.ts

@@ -48,8 +48,9 @@ export interface AstroErrorPageData {
  * error seats (`404.astro` / `500.astro`). `astro` is the seat's Astro
  * global; the bound route's content is loaded as if it were the requested
  * route, so static builds emit it into `dist/404.html`/`dist/500.html` and
- * server output renders it at error time from local compiled content — no
- * CMS fetch on the failing path (ANTI-2).
+ * ACI renders use the already resolved input for the bound base page;
+ * local static builds use compiled authoring content. Neither path fetches
+ * CMS content on a failure (ANTI-2).
  */
 export declare function getErrorPageData(astro: AstroGlobal, kind: ErrorPageKind, options?: {
     pushErrorPageView?: ErrorPagePush;

package/dist/astro/error-page.js

@@ -17,7 +17,7 @@
  * returned page data always carries empty collect/assignment tags.
  */
 import { getPageData } from './page.js';
-import { defaultPushErrorPageView, errorPageType, resolveErrorPage, serializeErrorPageInstrumentation, } from '../content/error-pages.js';
+import { defaultPushErrorPageView, errorPageType, serializeErrorPageInstrumentation, } from '../content/error-pages.js';
 import { defaultErrorPageFragmentHtml } from '../content/default-error-page.js';
 const FALLBACK_META = {
     notFound: {
@@ -34,37 +34,23 @@ const FALLBACK_META = {
  * error seats (`404.astro` / `500.astro`). `astro` is the seat's Astro
  * global; the bound route's content is loaded as if it were the requested
  * route, so static builds emit it into `dist/404.html`/`dist/500.html` and
- * server output renders it at error time from local compiled content — no
- * CMS fetch on the failing path (ANTI-2).
+ * ACI renders use the already resolved input for the bound base page;
+ * local static builds use compiled authoring content. Neither path fetches
+ * CMS content on a failure (ANTI-2).
  */
 export async function getErrorPageData(astro, kind, options = {}) {
     const pageType = errorPageType(kind);
     const instrumentationTag = serializeErrorPageInstrumentation(options.pushErrorPageView ?? defaultPushErrorPageView, kind);
     try {
-        const { FileContentProvider } = await import('../providers/file.js');
-        const siteConfig = await new FileContentProvider().getSiteConfig();
-        const resolved = await resolveErrorPage(kind, siteConfig);
-        for (const warning of resolved.warnings) {
-            console.warn(`[aci error-pages] ${warning}`);
-        }
-        if (resolved.route) {
-            const slug = resolved.route.replace(/^\/+|\/+$/g, '');
-            const data = await getPageData({
-                isPrerendered: astro.isPrerendered,
-                params: { slug },
-                request: astro.request,
-                url: astro.url,
-            });
-            return {
-                kind,
-                pageType,
-                instrumentationTag,
-                // Base audience, no personalization on error surfaces (REQ-11).
-                data: { ...data, collectTag: '', assignmentsTag: '' },
-                fallbackHtml: null,
-                meta: data.meta,
-            };
-        }
+        const data = await getPageData(astro, { errorPageKind: kind });
+        return {
+            kind,
+            pageType,
+            instrumentationTag,
+            data,
+            fallbackHtml: null,
+            meta: data.meta,
+        };
     }
     catch (error) {
         console.warn(`[aci error-pages] bound ${kind} page failed to load; serving the shipped default: ${String(error)}`);

package/dist/astro/page.d.ts

@@ -32,6 +32,7 @@
  */
 import type { KernelPage, KernelSiteConfig, KernelRouteMetadata, KernelPageBlock } from '../content/types.js';
 import { type LayoutEntry } from '../content/provider.js';
+import { type ErrorPageKind } from '../content/error-pages.js';
 /**
  * Minimal Astro global shape — only the properties getPageData reads.
  * This avoids depending on Astro's own types at the SDK level.
@@ -77,6 +78,8 @@ export interface PageData {
     assignmentsTag: string;
 }
 export interface GetPageDataOptions {
+    /** Resolve this authored error binding as an unpersonalized base page. */
+    errorPageKind?: ErrorPageKind;
     /** Path to compiled content root. Defaults to ACI_CONTENT_ROOT env or '.aci/compiled'. */
     compiledRoot?: string;
 }

package/dist/astro/page.js

@@ -32,6 +32,7 @@
  */
 import { FragmentNotFoundError } from '../content/provider.js';
 import { normalizeRoute } from '../content/routes.js';
+import { resolveErrorPage } from '../content/error-pages.js';
 import { routeMetadataForContent } from '../content/provider.js';
 import { resolveSlots } from '../content/resolve-slots.js';
 import { assignmentsScriptTagHTML, collectScriptTagHTML } from '../content/personalization.js';
@@ -54,7 +55,7 @@ import { GRADIAL_RENDER_INPUT_HEADER, getPendingRenderInputFromHeaders } from '.
  * artifacts in S3, no runtime content fetching).
  */
 export async function getPageData(astro, options) {
-    const route = normalizeRoute(astro.params.slug ? `/${astro.params.slug}` : '/');
+    let route = normalizeRoute(astro.params.slug ? `/${astro.params.slug}` : '/');
     // Static Astro generation is explicit; unexpected header access errors and
     // expired render-input IDs must not turn a selected variant into local base.
     let runtimeInput = null;
@@ -65,28 +66,29 @@ export async function getPageData(astro, options) {
             throw new Error(`ACI Astro render input is unavailable for route ${route}; refusing to render local base content`);
         }
     }
-    let siteConfig;
-    let page;
-    let providerModule = null;
-    let provider = null;
-    let variantKey;
-    if (runtimeInput) {
-        variantKey = requireVariantKey(runtimeInput.variantKey, route);
-        siteConfig = runtimeInput.siteConfig;
-        page = runtimeInput.page;
-    }
-    else {
-        // Lazy-import FileContentProvider to avoid pulling it in when
-        // preview render input is available
-        providerModule = await import('../providers/file.js');
-        provider = new providerModule.FileContentProvider(options?.compiledRoot);
-        [siteConfig, page] = await Promise.all([
-            provider.getSiteConfig(),
-            provider.getPage(route),
-        ]);
-        const entry = (await provider.listRoutes()).find((entry) => normalizeRoute(entry.path) === route);
-        variantKey = requireVariantKey(entry?.variantKey, route);
+    // Source selection is shared by ordinary pages and authored error seats.
+    // A supplied renderer input never consults local authoring files.
+    const provider = runtimeInput
+        ? null
+        : new (await import('../providers/file.js')).FileContentProvider(options?.compiledRoot);
+    const siteConfig = runtimeInput
+        ? runtimeInput.siteConfig
+        : await provider.getSiteConfig();
+    if (options?.errorPageKind) {
+        const resolved = await resolveErrorPage(options.errorPageKind, siteConfig);
+        for (const warning of resolved.warnings)
+            console.warn(`[aci error-pages] ${warning}`);
+        if (!resolved.route)
+            throw new Error(`No authored ${options.errorPageKind} page is bound`);
+        route = normalizeRoute(resolved.route);
+        if (runtimeInput && (normalizeRoute(runtimeInput.route) !== route || runtimeInput.variantKey !== 'base')) {
+            throw new Error(`ACI Astro ${options.errorPageKind} input must supply the bound base page ${resolved.route}`);
+        }
     }
+    const page = runtimeInput ? runtimeInput.page : await provider.getPage(route);
+    const variantKey = runtimeInput
+        ? requireVariantKey(runtimeInput.variantKey, route)
+        : requireVariantKey((await provider.listRoutes()).find((entry) => normalizeRoute(entry.path) === route)?.variantKey, route);
     const meta = routeMetadataForContent(siteConfig, page);
     // Resolve layout: prefer render input, fall back to provider
     const layout = await resolveLayout(runtimeInput, provider, page.layout, route);
@@ -102,8 +104,9 @@ export async function getPageData(astro, options) {
     });
     // Collect tag: suppress in preview mode (authoring surface, not visitor traffic)
     const isPreview = astro.url.searchParams.has('preview_token');
-    const collectTag = isPreview ? '' : collectScriptTagHTML(siteConfig);
-    const assignmentsTag = isPreview ? '' : assignmentsScriptTagHTML(page);
+    const suppressCollection = isPreview || Boolean(options?.errorPageKind);
+    const collectTag = suppressCollection ? '' : collectScriptTagHTML(siteConfig);
+    const assignmentsTag = suppressCollection ? '' : assignmentsScriptTagHTML(page);
     return { route, variantKey, siteConfig, page, meta, layout, slots, collectTag, assignmentsTag };
 }
 function requireVariantKey(value, route) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gradial/aci",
-  "version": "0.1.53-rc.3",
+  "version": "0.1.53-rc.5",
   "repository": {
     "type": "git",
     "url": "https://github.com/gradial/bare-metal-go.git",
@@ -164,11 +164,11 @@
     "astro": "^6.4.8"
   },
   "optionalDependencies": {
-    "@gradial/aci-cli-darwin-arm64": "0.1.53-rc.3",
-    "@gradial/aci-cli-darwin-x64": "0.1.53-rc.3",
-    "@gradial/aci-cli-linux-arm64": "0.1.53-rc.3",
-    "@gradial/aci-cli-linux-x64": "0.1.53-rc.3",
-    "@gradial/aci-cli-win32-arm64": "0.1.53-rc.3",
-    "@gradial/aci-cli-win32-x64": "0.1.53-rc.3"
+    "@gradial/aci-cli-darwin-arm64": "0.1.53-rc.5",
+    "@gradial/aci-cli-darwin-x64": "0.1.53-rc.5",
+    "@gradial/aci-cli-linux-arm64": "0.1.53-rc.5",
+    "@gradial/aci-cli-linux-x64": "0.1.53-rc.5",
+    "@gradial/aci-cli-win32-arm64": "0.1.53-rc.5",
+    "@gradial/aci-cli-win32-x64": "0.1.53-rc.5"
   }
 }

package/templates/astro/template/package.json.tmpl

@@ -5,7 +5,7 @@
   "type": "module",
   "scripts": {
     "dev": "astro dev --host 0.0.0.0",
-    "build": "node ./node_modules/@gradial/aci/src/cli/emit-error-pages.mjs prepare && astro build",
+    "build": "aci error-pages prepare && astro build",
     "preview": "ACI_CONTENT_ROOT=./.aci/compiled astro preview --host 0.0.0.0",
     "typecheck": "ACI_CONTENT_ROOT=./.aci/compiled astro check --tsconfig ./tsconfig.json",
     "test": "node --import tsx --test tests/**/*.test.ts",

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": "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",
+    "build": "aci error-pages prepare && next build && aci error-pages emit",
     "preview": "next start -H 0.0.0.0",
     "typecheck": "tsc --noEmit",
     "test": "node --import tsx --test tests/**/*.test.ts",