create-prenta-astro 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,181 @@
+# create-actuate-astro
+
+## 0.3.0
+
+### Minor Changes
+
+- 5eea995: Product rename: ActuateCMS is now **Prenta**. Every package moves from the
+  `@actuate-media/*` scope to `@prenta/*` with simplified names (`@prenta/core`,
+  `@prenta/admin`, `create-prenta`), and version numbers continue from where the
+  old scope left off.
+
+  This is a clean break — no backwards-compat aliases:
+  - **npm packages**: `@actuate-media/cms-core` → `@prenta/core`,
+    `@actuate-media/cms-admin` → `@prenta/admin`, all other packages keep their
+    suffix under `@prenta/*`. `create-actuate-cms` → `create-prenta`
+    (`npm create prenta`), `create-actuate-astro` → `create-prenta-astro`.
+    CLI bins: `actuate`/`actuate-cms` → `prenta`/`prenta-cms`; `actuate-mcp` →
+    `prenta-mcp`.
+  - **Database**: migration `0012_rename_to_prenta` renames all 36 `actuate_*`
+    tables to `prenta_*` in place (plus prefixed constraints, indexes, and
+    sequences). Run `prisma migrate deploy` when upgrading.
+  - **Runtime identifiers**: `getActuateConfig` → `getPrentaConfig`,
+    `handleActuateAPI` → `handlePrentaAPI`, `ActuateClient` → `PrentaClient`,
+    `ActuateDB` → `PrentaDB`, config file `actuate.config.ts` →
+    `prenta.config.ts`, CSS scopes `.actuate-admin`/`.actuate-canvas` →
+    `.prenta-admin`/`.prenta-canvas`, preview protocol `actuate-preview:*` →
+    `prenta-preview:*`, webhook headers `X-Actuate-*` → `X-Prenta-*`, session
+    cookie `actuate_session` → `prenta_session`, env vars `ACTUATE_*` →
+    `PRENTA_*`, purge route `/api/actuate/purge` → `/api/prenta/purge`.
+  - **Sessions and webhooks**: all sessions reset on upgrade (cookie + JWT issuer
+    changed); webhook consumers must re-verify signatures against the new
+    `X-Prenta-*` headers.
+
+  The old `@actuate-media/*` packages are deprecated on npm and will receive no
+  further releases.
+
+### Patch Changes
+
+- Updated dependencies [5eea995]
+  - create-prenta@1.3.0
+
+## 0.2.6
+
+### Patch Changes
+
+- 6ff80a6: Add `@actuate-media/sections-react/testing` (`assertSectionRenderParity`, canvas render options) and wire an Astro-split starter `test:parity` gate so canvas and public orchestrators can't drift into a WYSIWYG lie.
+- Updated dependencies [6ff80a6]
+  - create-actuate-cms@1.2.4
+
+## 0.2.5
+
+### Patch Changes
+
+- 73854fc: Add `siteIdentityJsonLd*` / `jsonLdHasOrganization` so any page can emit resolvable WebSite + Organization JSON-LD (fixes dangling `#organization` @ids). Add `assertServingOriginConfigured` ops guard (Launch Gate E) and wire it into the Astro starter middleware + CMS API route boot; BaseLayout falls back to site-identity JSON-LD when page meta lacks Organization.
+- Updated dependencies [73854fc]
+  - create-actuate-cms@1.2.3
+
+## 0.2.4
+
+### Patch Changes
+
+- 576f076: Fix `blogPostCollection` archivePath footgun: deriving with a new slug/urlPrefix rebases `seo.archivePath` onto the urlPrefix unless set explicitly; `defineConfig` warns on duplicate archive paths. Astro starter/example: hybrid prerender defaults (`404.astro` prerendered; CMS catch-all / home / blog index explicit `prerender = false`).
+- Updated dependencies [576f076]
+  - create-actuate-cms@1.2.2
+
+## 0.2.3
+
+### Patch Changes
+
+- dfffe08: Add `publicPageCacheControl()` on `@actuate-media/cms-core/astro/cache` (ADR 0011 cache-static defaults: 1h s-maxage / 24h SWR; preview → `private, no-store`) and wire the Astro starter + example site to use it instead of hardcoded Cache-Control strings. Purge remains path/URL-based per ADR 0011.
+- Updated dependencies [dfffe08]
+  - create-actuate-cms@1.2.1
+
+## 0.2.2
+
+### Patch Changes
+
+- Updated dependencies [cf97a40]
+  - create-actuate-cms@1.2.0
+
+## 0.2.1
+
+### Patch Changes
+
+- Updated dependencies [7230d21]
+  - create-actuate-cms@1.1.0
+
+## 0.2.0
+
+### Minor Changes
+
+- 90f9801: Astro-first scaffolding: `astro-split` is now the default framework and emits a pnpm workspace instead of a nested `site/` folder.
+
+  **create-actuate-cms (breaking)**
+  - Default framework flipped from `next` to `astro-split`. `npm create actuate-cms` now scaffolds a pnpm workspace — Next CMS host in `apps/cms`, Astro public site in `apps/site` — instead of a Next monolith. Pass `--framework next` for the classic monolith (unchanged output).
+  - The `astro-split` layout changed from a root Next app with a nested `site/` Astro app to a proper workspace (`pnpm-workspace.yaml`, delegating root scripts, `packageManager: pnpm`). Re-running the scaffolder over an old layout is not supported.
+  - `astro-split` + `marketing-custom` (the default template) now compose: the section kit lands in `packages/sections` and all three layers are wired from it — `apps/cms/actuate.config.ts` imports the schema, the admin page imports `sectionRenderers` (via `transpilePackages`), and the Astro site registers the same renderer map. `verify:sections` runs from the root, both apps, and CI.
+  - Same-apex routing is now the default: `apps/site/vercel.json` ships rewrites for `/api/cms/*` and the admin/login paths to the CMS host (`CMS_HOST_ORIGIN` placeholder) instead of an opt-in `vercel.preview-proxy.example.json`.
+  - The Astro site template ships cache-static delivery: `Cache-Control: public, s-maxage=3600, stale-while-revalidate=86400` on published pages, a `/api/actuate/purge` webhook endpoint built on `createPublishPurgeReceiver` (Cloudflare / Vercel adapters selected by env), and an optional Upstash layer-2 cache that the purge endpoint drains.
+  - `ASTRO.md` documents the workspace flow, production routing, and the purge webhook setup (Settings → Webhooks).
+
+  **create-actuate-astro**
+  - `--split` now scaffolds the pnpm workspace (`apps/cms` + `apps/site` + `packages/sections` with the designed-sections standard template). Site-only mode (the default) is unchanged.
+
+### Patch Changes
+
+- Updated dependencies [90f9801]
+  - create-actuate-cms@1.0.0
+
+## 0.1.8
+
+### Patch Changes
+
+- Updated dependencies [56c1309]
+  - create-actuate-cms@0.33.2
+
+## 0.1.7
+
+### Patch Changes
+
+- Updated dependencies [f4766d4]
+  - create-actuate-cms@0.33.1
+
+## 0.1.6
+
+### Patch Changes
+
+- Updated dependencies [c72bd83]
+  - create-actuate-cms@0.33.0
+
+## 0.1.5
+
+### Patch Changes
+
+- Updated dependencies [f676bcc]
+  - create-actuate-cms@0.32.2
+
+## 0.1.4
+
+### Patch Changes
+
+- Updated dependencies [3d1a79f]
+  - create-actuate-cms@0.32.1
+
+## 0.1.3
+
+### Patch Changes
+
+- Updated dependencies [58f3ca1]
+  - create-actuate-cms@0.32.0
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies [cc6ad93]
+  - create-actuate-cms@0.31.0
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [b6945e3]
+  - create-actuate-cms@0.30.1
+
+## 0.1.0
+
+### Minor Changes
+
+- c6b006c: Astro discoverability and best practices: `create-actuate-astro` + `--framework astro-site`, Live Content Collections loader (`@actuate-media/cms-core/astro/content`), islands/preview docs, and fleet first-cutover runbook.
+
+### Patch Changes
+
+- Updated dependencies [c6b006c]
+  - create-actuate-cms@0.30.0
+
+## 0.1.0
+
+### Minor Changes
+
+- Initial release: `npm create actuate-astro` scaffolds an Actuate Astro public site against an existing CMS host (`astro-site`). Pass `--split` for a full CMS host + `site/` scaffold.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Actuate Media
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+/**
+ * Thin discoverability wrapper: `npm create prenta-astro` scaffolds an Astro
+ * public site for an existing Prenta CMS host (`--framework astro-site`).
+ *
+ * Pass `--split` (or `--framework astro-split`) for the full pnpm workspace
+ * (apps/cms + apps/site + packages/sections) via create-prenta.
+ */
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import { Command } from 'commander';
+import chalk from 'chalk';
+import prompts from 'prompts';
+import { scaffoldProject } from 'create-prenta/scaffold';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+async function readPackageVersion() {
+    try {
+        const pkgPath = path.resolve(__dirname, '..', 'package.json');
+        const raw = await readFile(pkgPath, 'utf-8');
+        return JSON.parse(raw).version;
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+function baseOptions(projectName, framework) {
+    return {
+        projectName,
+        adminPath: '/admin',
+        loginPath: '/securelogin',
+        plugins: ['seo', 'forms', 'redirects', 'media', 'email'],
+        platform: 'vercel',
+        database: 'prisma-postgres',
+        authProviders: ['credentials'],
+        // The split workspace gets the designed-sections standard (shared section
+        // kit in packages/sections); a site-only scaffold has no CMS host to
+        // author custom sections on, so template is irrelevant there.
+        template: framework === 'astro-split' ? 'marketing-custom' : 'default',
+        framework,
+    };
+}
+async function run() {
+    const version = await readPackageVersion();
+    const program = new Command();
+    program
+        .name('create-prenta-astro')
+        .description('Scaffold an Prenta Astro public site (existing CMS by default; --split for the full apps/cms + apps/site workspace)')
+        .version(version)
+        .argument('[project-name]', 'Directory name for the new Astro site')
+        .option('-y, --yes', 'Skip prompts; use defaults')
+        .option('--split', 'Scaffold the full pnpm workspace: apps/cms + apps/site (same as create-prenta --framework astro-split)')
+        .option('--framework <name>', 'astro-site (default) or astro-split', 'astro-site')
+        .action(async (nameArg, opts) => {
+        console.log();
+        console.log(chalk.bold('  Prenta Astro'));
+        console.log(chalk.dim('  Public site for an Prenta CMS host'));
+        console.log();
+        const split = opts.split === true;
+        const frameworkFlag = String(opts.framework ?? 'astro-site');
+        const framework = split || frameworkFlag === 'astro-split' ? 'astro-split' : 'astro-site';
+        const nonInteractive = opts.yes === true || !process.stdin.isTTY;
+        let projectName = nameArg?.trim();
+        if (!projectName) {
+            if (nonInteractive) {
+                projectName = framework === 'astro-split' ? 'my-prenta-app' : 'my-astro-site';
+            }
+            else {
+                const answers = await prompts({
+                    type: 'text',
+                    name: 'projectName',
+                    message: 'Project name',
+                    initial: framework === 'astro-split' ? 'my-prenta-app' : 'my-astro-site',
+                    validate: (v) => /^[a-z0-9_-]+$/i.test(v) ||
+                        'Only alphanumeric characters, hyphens, and underscores',
+                }, {
+                    onCancel: () => {
+                        console.log(chalk.red('\nSetup cancelled.'));
+                        process.exit(1);
+                    },
+                });
+                projectName = answers.projectName;
+            }
+        }
+        if (!projectName || !/^[a-z0-9_-]+$/i.test(projectName)) {
+            console.error(chalk.red(`Invalid project name "${projectName ?? ''}".`));
+            process.exit(1);
+        }
+        if (framework === 'astro-site') {
+            console.log(chalk.dim('  Mode: Astro site only (point PRENTA_CMS_URL at your CMS host)'));
+        }
+        else {
+            console.log(chalk.dim('  Mode: pnpm workspace — apps/cms (Next CMS) + apps/site (Astro)'));
+        }
+        console.log();
+        await scaffoldProject(baseOptions(projectName, framework));
+    });
+    program.parse();
+}
+run().catch((err) => {
+    console.error(chalk.red('Fatal error:'), err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "create-prenta-astro",
+  "version": "0.3.0",
+  "description": "Scaffold an Prenta Astro public site against an existing CMS host",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/actuate-media/prenta.git",
+    "directory": "create-prenta-astro"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "create-prenta-astro": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "dependencies": {
+    "chalk": "^5.4.0",
+    "commander": "^13.0.0",
+    "prompts": "^2.4.2",
+    "create-prenta": "1.3.0"
+  },
+  "devDependencies": {
+    "@types/prompts": "^2.4.9",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.0"
+  },
+  "keywords": [
+    "prenta",
+    "astro",
+    "cms",
+    "scaffolding",
+    "create"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}