@gradial/aci 0.1.51-ssr.2 → 0.1.51-ssr.4

package/README.md

@@ -1,6 +1,6 @@
 # Agentic Content Infrastructure SDK
 
-`@gradial/aci` `0.1.51-ssr.2` is a pre-1.0 public-surface reset for the ACI
+`@gradial/aci` `0.1.51-ssr.4` 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.51-ssr.2 zod@^4
+npm install @gradial/aci@0.1.51-ssr.4 zod@^4
 ```
 
 ## Root Import
@@ -78,13 +78,13 @@ host bundles select and serve immutable release artifacts.
 The first RC scaffold path is Next:
 
 ```bash
-npx @gradial/aci@0.1.51-ssr.2 init my-site --template next-starter
+npx @gradial/aci@0.1.51-ssr.4 init my-site --template next-starter
 ```
 
 List available templates:
 
 ```bash
-npx @gradial/aci@0.1.51-ssr.2 init --list
+npx @gradial/aci@0.1.51-ssr.4 init --list
 ```
 
 ## Personalization: The One-Tag Install

package/dist/next/error-pages.js

@@ -15,11 +15,16 @@ import { ErrorPageMarker } from './error-page-marker.js';
 export async function resolveErrorPage(kind) {
     let siteConfig = null;
     const warnings = [];
-    try {
-        siteConfig = await getSiteConfig();
-    }
-    catch (error) {
-        warnings.push(`site config unavailable at the error seat: ${String(error)}`);
+    // A deployed SSR release has no local `.aci/compiled` tree. The error
+    // seat must remain independent of the renderer that just failed, so serve
+    // the shipped default rather than opening FileContentProvider here.
+    if (process.env.HOSTING_DELIVERY_MODE !== 'ssr') {
+        try {
+            siteConfig = await getSiteConfig();
+        }
+        catch (error) {
+            warnings.push(`site config unavailable at the error seat: ${String(error)}`);
+        }
     }
     const resolved = await resolveErrorPageForSite(kind, siteConfig);
     return { ...resolved, warnings: [...warnings, ...resolved.warnings], siteConfig };

package/dist/next/page.js

@@ -43,18 +43,24 @@ export function createPage(registry, options) {
     const dynamic = 'force-dynamic';
     async function generateMetadata({ params }) {
         const resolved = await resolveRoute(params);
-        const input = await getRenderInput(resolved.route, resolved.context);
-        const meta = routeMetadataForContent(input.siteConfig, input.page);
-        return {
-            title: meta.title,
-            description: meta.description,
-            alternates: meta.canonical ? { canonical: meta.canonical } : undefined,
-            openGraph: {
+        try {
+            const input = await getRenderInput(resolved.route, resolved.context);
+            const meta = routeMetadataForContent(input.siteConfig, input.page);
+            return {
                 title: meta.title,
                 description: meta.description,
-                siteName: meta.siteName,
-            },
-        };
+                alternates: meta.canonical ? { canonical: meta.canonical } : undefined,
+                openGraph: {
+                    title: meta.title,
+                    description: meta.description,
+                    siteName: meta.siteName,
+                },
+            };
+        }
+        catch (error) {
+            logRenderFailure('metadata', resolved, error);
+            throw error;
+        }
     }
     async function CatchAllPage({ params }) {
         const resolved = await resolveRoute(params);
@@ -81,6 +87,7 @@ export function createPage(registry, options) {
         catch (error) {
             if (error instanceof PageNotFoundError)
                 notFound();
+            logRenderFailure('page', resolved, error);
             throw error;
         }
     }
@@ -95,7 +102,9 @@ export function createPage(registry, options) {
  */
 async function resolveRoute(params) {
     const resolved = await params;
-    const slug = resolved.slug ?? [];
+    const slug = decodePathSegments(resolved.slug ?? []);
+    if (!slug)
+        return { route: '/' };
     if (slug.length >= 2 && slug[0] === '__r') {
         const releaseId = slug[1];
         const selected = slug.slice(2);
@@ -129,3 +138,22 @@ function portableReleaseId(value) {
 function portablePathPart(value) {
     return value.length > 0 && value !== '.' && value !== '..' && !value.includes('/');
 }
+function decodePathSegments(segments) {
+    try {
+        return segments.map((segment) => decodeURIComponent(segment));
+    }
+    catch {
+        return null;
+    }
+}
+function logRenderFailure(phase, resolved, error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    console.error(JSON.stringify({
+        message: 'aci.ssr.render_failed',
+        phase,
+        releaseId: resolved.context?.releaseId,
+        pageRef: resolved.context?.pageRef,
+        route: resolved.route,
+        error: detail.slice(0, 512),
+    }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gradial/aci",
-  "version": "0.1.51-ssr.2",
+  "version": "0.1.51-ssr.4",
   "repository": {
     "type": "git",
     "url": "https://github.com/gradial/bare-metal-go.git",
@@ -146,11 +146,11 @@
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
-    "@gradial/aci-cli-darwin-arm64": "0.1.51-ssr.2",
-    "@gradial/aci-cli-darwin-x64": "0.1.51-ssr.2",
-    "@gradial/aci-cli-linux-arm64": "0.1.51-ssr.2",
-    "@gradial/aci-cli-linux-x64": "0.1.51-ssr.2",
-    "@gradial/aci-cli-win32-arm64": "0.1.51-ssr.2",
-    "@gradial/aci-cli-win32-x64": "0.1.51-ssr.2"
+    "@gradial/aci-cli-darwin-arm64": "0.1.51-ssr.4",
+    "@gradial/aci-cli-darwin-x64": "0.1.51-ssr.4",
+    "@gradial/aci-cli-linux-arm64": "0.1.51-ssr.4",
+    "@gradial/aci-cli-linux-x64": "0.1.51-ssr.4",
+    "@gradial/aci-cli-win32-arm64": "0.1.51-ssr.4",
+    "@gradial/aci-cli-win32-x64": "0.1.51-ssr.4"
   }
 }