@gradial/aci 0.1.52-rc.24 → 0.1.52-rc.25

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.1.52-rc.25 - 2026-09-30
+
+### Added
+
+- Allow Astro builds to opt into framework-neutral `assets/` output with
+  `ACI_ASSET_PATH_LAYOUT=flat-assets`. Next.js rejects that layout until it
+  can produce the same public and stored paths safely.
+
+## 0.1.52-rc.24 - 2026-09-18
+
+### Added
+
+- `withAci()` (Astro and Next.js) reads `ACI_ASSET_BASE_TPL` and, when it is
+  an absolute CDN URL, sets Vite's `base` / Next.js's `assetPrefix` to it so
+  the SSG build writes asset URLs pointing at the CDN directly — no HTML
+  post-processing needed. `__RELEASE_ID__` is stripped because build assets
+  are content-addressed and release-independent. Managed tenants (the
+  `/__r/__RELEASE_ID__/` default) are left untouched; the edge handler
+  rewrites relative paths to the global S3 key.
+
 ## 0.1.52-rc.7 - 2026-08-19
 
 ### Fixed

package/README.md

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

package/dist/astro/index.d.ts

@@ -4,8 +4,12 @@ import type { BlockRef } from '../types/block-ref.js';
 interface AstroConfigSetupParams {
     injectScript(stage: 'head-inline' | 'page' | 'page-ssr', content: string): void;
     updateConfig(config: {
+        build?: {
+            assets?: string;
+        };
         vite?: {
             plugins?: unknown[];
+            base?: string;
         };
     }): void;
 }

package/dist/astro/index.js

@@ -83,6 +83,37 @@ export function withAci(options = {}) {
         name: 'aci-astro',
         hooks: {
             'astro:config:setup'({ injectScript, updateConfig }) {
+                const assetPathLayout = (process.env.ACI_ASSET_PATH_LAYOUT || 'preserve').trim();
+                if (assetPathLayout !== 'preserve' && assetPathLayout !== 'flat-assets') {
+                    throw new Error('ACI_ASSET_PATH_LAYOUT must be preserve or flat-assets');
+                }
+                if (assetPathLayout === 'flat-assets') {
+                    updateConfig({ build: { assets: 'assets' } });
+                }
+                // Asset URL prefix for production builds. When
+                // ACI_ASSET_BASE_TPL is an absolute CDN URL, use it as Vite's `base`
+                // so the SSG build writes asset URLs (CSS, JS, images) pointing at
+                // the CDN directly — no post-processing needed.
+                //
+                // Build assets are content-addressed (hashed filenames) and stored
+                // globally, so the URL is release-independent: strip __RELEASE_ID__.
+                //   - Managed tenants (edge handler): ACI_ASSET_BASE_TPL is
+                //     "/__r/__RELEASE_ID__/" or unset — do NOT set Vite base; the
+                //     SSG writes relative paths (/_astro/foo.js) and the edge
+                //     handler's viewer-request rewrites to the global S3 key.
+                //   - External CDN tenants: "https://cdn.gradial.com/" → Vite base,
+                //     Astro writes absolute CDN URLs.
+                const rawTpl = process.env.ACI_ASSET_BASE_TPL || '';
+                const assetBase = rawTpl
+                    .replace('__RELEASE_ID__/', '')
+                    .replace('__RELEASE_ID__', '')
+                    .replace(/\/+$/, '/');
+                const isAbsoluteUrl = assetBase.startsWith('http://') || assetBase.startsWith('https://');
+                if (isAbsoluteUrl
+                    && assetBase !== '/'
+                    && process.env.NODE_ENV === 'production') {
+                    updateConfig({ vite: { base: assetBase } });
+                }
                 if (process.env.NODE_ENV === 'production') {
                     return;
                 }

package/dist/next/config.js

@@ -33,9 +33,33 @@ export function withAci(nextConfig = {}, options = {}) {
     const userRewrites = nextConfig.rewrites;
     const userHeaders = nextConfig.headers;
     const userWebpack = nextConfig.webpack;
+    // Build assets (_next/static/*) are content-addressed and stored globally.
+    // When ACI_ASSET_BASE_TPL is an absolute CDN URL, strip __RELEASE_ID__
+    // (release-independent) and use it as Next.js's native assetPrefix so the
+    // build writes absolute CDN URLs for _next/static chunks — no post-
+    // processing needed.
+    //   - Managed tenants (edge handler): "/__r/__RELEASE_ID__/" or unset →
+    //     do not set assetPrefix; the SSG writes relative paths and the edge
+    //     handler rewrites to the global S3 key.
+    //   - External CDN tenants: "https://cdn.gradial.com/" → absolute CDN URLs.
+    const rawAssetBaseTpl = process.env.ACI_ASSET_BASE_TPL || '';
+    const assetPathLayout = (process.env.ACI_ASSET_PATH_LAYOUT || 'preserve').trim();
+    if (assetPathLayout !== 'preserve' && assetPathLayout !== 'flat-assets') {
+        throw new Error('ACI_ASSET_PATH_LAYOUT must be preserve or flat-assets');
+    }
+    if (assetPathLayout === 'flat-assets') {
+        throw new Error('ACI_ASSET_PATH_LAYOUT=flat-assets currently supports Astro builds only');
+    }
+    const cdnAssetPrefix = rawAssetBaseTpl
+        .replace('__RELEASE_ID__/', '')
+        .replace('__RELEASE_ID__', '')
+        .replace(/\/+$/, '/');
+    const isCdnUrl = cdnAssetPrefix.startsWith('http://') || cdnAssetPrefix.startsWith('https://');
+    const nextAssetPrefix = (isCdnUrl && cdnAssetPrefix !== '/') ? cdnAssetPrefix : undefined;
     return {
         ...nextConfig,
         output: 'standalone',
+        assetPrefix: nextAssetPrefix ?? nextConfig.assetPrefix,
         outputFileTracingRoot: nextConfig.outputFileTracingRoot ?? process.cwd(),
         headers: async () => {
             const gradialHeaders = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gradial/aci",
-  "version": "0.1.52-rc.24",
+  "version": "0.1.52-rc.25",
   "repository": {
     "type": "git",
     "url": "https://github.com/gradial/bare-metal-go.git",
@@ -159,11 +159,11 @@
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
-    "@gradial/aci-cli-darwin-arm64": "0.1.52-rc.24",
-    "@gradial/aci-cli-darwin-x64": "0.1.52-rc.24",
-    "@gradial/aci-cli-linux-arm64": "0.1.52-rc.24",
-    "@gradial/aci-cli-linux-x64": "0.1.52-rc.24",
-    "@gradial/aci-cli-win32-arm64": "0.1.52-rc.24",
-    "@gradial/aci-cli-win32-x64": "0.1.52-rc.24"
+    "@gradial/aci-cli-darwin-arm64": "0.1.52-rc.25",
+    "@gradial/aci-cli-darwin-x64": "0.1.52-rc.25",
+    "@gradial/aci-cli-linux-arm64": "0.1.52-rc.25",
+    "@gradial/aci-cli-linux-x64": "0.1.52-rc.25",
+    "@gradial/aci-cli-win32-arm64": "0.1.52-rc.25",
+    "@gradial/aci-cli-win32-x64": "0.1.52-rc.25"
   }
 }