nca-ai-cms-astro-plugin 1.0.3 → 1.0.5

package/README.md

@@ -16,13 +16,14 @@ An Astro plugin that adds an AI-powered content editor to your site. Generate ar
 ### 1. Install
 
 ```bash
-npm install nca-ai-cms-astro-plugin
+npm install nca-ai-cms-astro-plugin @astrojs/node @astrojs/react @astrojs/db react react-dom @google/genai @google/generative-ai gray-matter marked sanitize-html sharp turndown zod
 ```
 
 ### 2. Add to your Astro config
 
-```ts
+```js
 // astro.config.mjs
+import { defineConfig } from 'astro/config';
 import ncaAiCms from 'nca-ai-cms-astro-plugin';
 
 export default defineConfig({
@@ -30,24 +31,36 @@ export default defineConfig({
 });
 ```
 
-### 3. Environment variables
+The plugin auto-registers `react()`, `db()`, `output: 'server'`, and the `@astrojs/node` adapter. You can still set them manually if you need custom options.
+
+### 3. Create `.env.local`
 
 ```env
+EDITOR_ADMIN=admin
+EDITOR_PASSWORD=your-secure-password
 GOOGLE_GEMINI_API_KEY=your-gemini-api-key
-EDITOR_ADMIN=your-username
-EDITOR_PASSWORD=your-password
 ```
 
-| Variable | Required | Description |
+| Variable | Required | Purpose |
 |---|---|---|
+| `EDITOR_ADMIN` | Yes | Login username for the editor |
+| `EDITOR_PASSWORD` | Yes | Login password for the editor |
 | `GOOGLE_GEMINI_API_KEY` | Yes | Google Gemini API key for content and image generation |
-| `EDITOR_ADMIN` | Yes | Username for editor login |
-| `EDITOR_PASSWORD` | Yes | Password for editor login |
 
-### 4. Requirements
+Add `.env.local` to your `.gitignore` — never commit secrets.
+
+### 4. Start the dev server
+
+```bash
+npx astro dev
+```
+
+- Login: http://localhost:4321/login
+- Editor: http://localhost:4321/editor (redirects to login if not authenticated)
+
+### Requirements
 
 - Astro 5+
-- `@astrojs/db` and `@astrojs/react` integrations
 - Node.js 18+
 
 ## Options

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nca-ai-cms-astro-plugin",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "type": "module",
   "exports": {
     ".": "./src/index.ts",

package/src/components/editor/SettingsTab.tsx

@@ -30,8 +30,8 @@ export function SettingsTab() {
     try {
       const res = await fetch('/api/prompts');
       if (!res.ok) throw new Error('Fehler beim Laden der Einstellungen');
-      const data = (await res.json()) as Prompt[];
-      setPrompts(data);
+      const data = await res.json();
+      setPrompts(Array.isArray(data.prompts) ? data.prompts : []);
     } catch (err) {
       setError(
         err instanceof Error ? err.message : 'Ein Fehler ist aufgetreten',

package/src/env.d.ts

@@ -0,0 +1,12 @@
+interface ImportMetaEnv {
+  readonly PROD: boolean;
+  readonly DEV: boolean;
+  readonly EDITOR_ADMIN: string;
+  readonly EDITOR_PASSWORD: string;
+  readonly GOOGLE_GEMINI_API_KEY: string;
+  readonly [key: string]: string | boolean | undefined;
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}

package/src/index.ts

@@ -1,4 +1,7 @@
 import type { AstroIntegration } from 'astro';
+import react from '@astrojs/react';
+import db from '@astrojs/db';
+import node from '@astrojs/node';
 
 export interface NcaAiCmsPluginOptions {
   contentPath?: string;
@@ -9,7 +12,7 @@ export default function ncaAiCms(
   options: NcaAiCmsPluginOptions = {}
 ): AstroIntegration {
   const contentPath = options.contentPath ?? 'nca-ai-cms-content';
-  const autoPublish = options.autoPublish ?? process.env.NODE_ENV === 'production';
+  const autoPublish = options.autoPublish ?? import.meta.env.PROD;
 
   return {
     name: 'nca-ai-cms-astro-plugin',
@@ -20,12 +23,29 @@ export default function ncaAiCms(
         });
       },
 
-      'astro:config:setup'({ injectRoute, updateConfig, addMiddleware }) {
+      'astro:config:setup'({ injectRoute, updateConfig, addMiddleware, config }) {
         addMiddleware({
           entrypoint: 'nca-ai-cms-astro-plugin/middleware.ts',
           order: 'pre',
         });
 
+        // Auto-register react and db integrations if not already present
+        const hasReact = config.integrations.some((i) => i.name === '@astrojs/react');
+        if (!hasReact) {
+          config.integrations.push(react());
+        }
+
+        const hasDb = config.integrations.some((i) => i.name === '@astrojs/db');
+        if (!hasDb) {
+          config.integrations.push(...(db() as unknown as AstroIntegration[]));
+        }
+
+        // Auto-configure server output and node adapter
+        updateConfig({
+          output: 'server' as const,
+          adapter: node({ mode: 'standalone' }),
+        });
+
         // Virtual module for config sharing
         updateConfig({
           vite: {
@@ -51,80 +71,98 @@ export default function ncaAiCms(
         injectRoute({
           pattern: '/api/generate-content',
           entrypoint: 'nca-ai-cms-astro-plugin/api/generate-content.ts',
+          prerender: false,
         });
         injectRoute({
           pattern: '/api/generate-image',
           entrypoint: 'nca-ai-cms-astro-plugin/api/generate-image.ts',
+          prerender: false,
         });
         injectRoute({
           pattern: '/api/save',
           entrypoint: 'nca-ai-cms-astro-plugin/api/save.ts',
+          prerender: false,
         });
         injectRoute({
           pattern: '/api/save-image',
           entrypoint: 'nca-ai-cms-astro-plugin/api/save-image.ts',
+          prerender: false,
         });
         injectRoute({
           pattern: '/api/prompts',
           entrypoint: 'nca-ai-cms-astro-plugin/api/prompts.ts',
+          prerender: false,
         });
         injectRoute({
           pattern: '/api/scheduler',
           entrypoint: 'nca-ai-cms-astro-plugin/api/scheduler.ts',
+          prerender: false,
         });
         injectRoute({
           pattern: '/api/scheduler/generate',
           entrypoint: 'nca-ai-cms-astro-plugin/api/scheduler/generate.ts',
+          prerender: false,
         });
         injectRoute({
           pattern: '/api/scheduler/publish',
           entrypoint: 'nca-ai-cms-astro-plugin/api/scheduler/publish.ts',
+          prerender: false,
         });
         injectRoute({
           pattern: '/api/scheduler/[id]',
           entrypoint: 'nca-ai-cms-astro-plugin/api/scheduler/[id].ts',
+          prerender: false,
         });
         injectRoute({
           pattern: '/api/articles/[id]',
           entrypoint: 'nca-ai-cms-astro-plugin/api/articles/[id].ts',
+          prerender: false,
         });
         injectRoute({
           pattern: '/api/articles/[id]/apply',
           entrypoint: 'nca-ai-cms-astro-plugin/api/articles/[id]/apply.ts',
+          prerender: false,
         });
         injectRoute({
           pattern: '/api/articles/[id]/regenerate-text',
           entrypoint:
             'nca-ai-cms-astro-plugin/api/articles/[id]/regenerate-text.ts',
+          prerender: false,
         });
         injectRoute({
           pattern: '/api/articles/[id]/regenerate-image',
           entrypoint:
             'nca-ai-cms-astro-plugin/api/articles/[id]/regenerate-image.ts',
+          prerender: false,
         });
 
         // Inject auth routes
         injectRoute({
           pattern: '/api/auth/login',
           entrypoint: 'nca-ai-cms-astro-plugin/api/auth/login.ts',
+          prerender: false,
         });
         injectRoute({
           pattern: '/api/auth/logout',
           entrypoint: 'nca-ai-cms-astro-plugin/api/auth/logout.ts',
+          prerender: false,
         });
         injectRoute({
           pattern: '/api/auth/check',
           entrypoint: 'nca-ai-cms-astro-plugin/api/auth/check.ts',
+          prerender: false,
         });
 
         // Inject pages
         injectRoute({
           pattern: '/login',
           entrypoint: 'nca-ai-cms-astro-plugin/pages/login.astro',
+          prerender: false,
         });
         injectRoute({
           pattern: '/editor',
           entrypoint: 'nca-ai-cms-astro-plugin/pages/editor.astro',
+          prerender: false,
         });
       },
 

package/src/utils/envUtils.ts

@@ -1,5 +1,6 @@
 /**
- * Reads an environment variable from `process.env`.
+ * Reads an environment variable from `import.meta.env` (Astro/Vite)
+ * with a fallback to `process.env` for non-Vite environments.
  *
  * @param variable     - The name of the environment variable.
  * @param defaultValue - Optional fallback when the variable is not set.
@@ -10,7 +11,8 @@ export function getEnvVariable(
   variable: string,
   defaultValue?: string,
 ): string {
-  const value = process.env[variable];
+  const value = (import.meta.env as Record<string, string | undefined>)[variable]
+    ?? process.env[variable];
 
   if (value !== undefined && value !== "") {
     return value;

package/task.md

@@ -0,0 +1,77 @@
+# Fix nca-ai-cms-astro-plugin v1.0.5
+
+## 1. Fix SettingsTab.tsx response parsing
+
+**File:** `src/components/editor/SettingsTab.tsx`
+
+Line 33-34: API `/api/prompts` returns `{ prompts, settings }` but the component casts the entire response as `Prompt[]`, causing a crash.
+
+```diff
+- const data = (await res.json()) as Prompt[];
+- setPrompts(data);
++ const data = await res.json();
++ setPrompts(Array.isArray(data.prompts) ? data.prompts : []);
+```
+
+## 2. Auto-register dependencies in index.ts
+
+**File:** `src/index.ts`
+
+The consumer currently must manually add `react()`, `db()`, `output: 'server'`, and the node adapter. The plugin should handle this automatically in `astro:config:setup`.
+
+- Import `@astrojs/react`, `@astrojs/db`, `@astrojs/node` at the top
+- Add `addIntegration` and `config` to the hook destructuring
+- Check `config.integrations` for existing react/db before adding
+- Call `updateConfig()` with `output: 'server'` and `adapter: node({ mode: 'standalone' })`
+
+```ts
+'astro:config:setup'({ injectRoute, updateConfig, addMiddleware, addIntegration, config }) {
+  const hasReact = config.integrations.some((i) => i.name === '@astrojs/react');
+  if (!hasReact) {
+    addIntegration(react());
+  }
+
+  const hasDb = config.integrations.some((i) => i.name === '@astrojs/db');
+  if (!hasDb) {
+    addIntegration(db());
+  }
+
+  updateConfig({
+    output: 'server' as const,
+    adapter: node({ mode: 'standalone' }),
+  });
+
+  // ... rest of hook unchanged
+}
+```
+
+## 3. Bump version to 1.0.5
+
+**File:** `package.json`
+
+Change `"version": "1.0.4"` to `"version": "1.0.5"`.
+
+## 4. Update README with simplified setup
+
+**File:** `README.md`
+
+Update setup instructions to reflect that the consumer only needs:
+
+```ts
+import ncaAiCms from 'nca-ai-cms-astro-plugin';
+
+export default defineConfig({
+  integrations: [ncaAiCms()],
+});
+```
+
+Add `.env.local` step with `GOOGLE_GEMINI_API_KEY`, `EDITOR_ADMIN`, `EDITOR_PASSWORD`.
+
+Note that `prerender: false` is already present on all 18 `injectRoute()` calls — no changes needed there.
+
+## Verification
+
+1. In a test project, use only `integrations: [ncaAiCms()]` in astro config
+2. Run `npx astro dev`
+3. Open `/login` — should render without errors
+4. Log in, open `/editor` — settings tab should load without crash

package/update.md

@@ -0,0 +1,34 @@
+# v1.0.5
+
+## Fix: SettingsTab crash on prompts response
+- `/api/prompts` returns `{ prompts, settings }` but SettingsTab cast the entire response as `Prompt[]`
+- Fixed to extract `data.prompts` from the response object
+
+## Auto-register dependencies
+- Plugin now auto-configures `output: 'server'`, `@astrojs/node` adapter, `react()`, and `db()` via `updateConfig()`
+- Consumer config is now just `integrations: [ncaAiCms()]`
+- Existing manual config is respected — auto-registration only kicks in when not already set
+
+## Setup guide in README
+- Full install command with all peer dependencies
+- `.env.local` setup with variable reference table
+- Minimal `astro.config.mjs` example
+
+---
+
+# v1.0.4
+
+## Fix: Environment variables and route prerendering
+
+### Environment variables now work with Astro's .env files
+- `getEnvVariable()` now reads from `import.meta.env` first, with a `process.env` fallback
+- Previously only checked `process.env`, which meant `.env` / `.env.local` files were ignored in Astro dev and SSR
+- Works in all environments: local dev, Docker, GitLab CI/CD
+
+### All injected routes are now server-rendered
+- Added `prerender: false` to all 18 injected routes (API, auth, pages)
+- Consumers no longer need to set `output: 'server'` globally in their Astro config
+- The plugin works with Astro's default `output: 'static'` — only plugin routes are server-rendered
+
+### Minor: use `import.meta.env.PROD` for auto-publish check
+- Replaced `process.env.NODE_ENV === 'production'` with Astro's built-in `import.meta.env.PROD`