@djangocfg/nextjs 1.0.3 → 1.0.5

package/README.md

@@ -1,6 +1,6 @@
 # @djangocfg/nextjs
 
-> Comprehensive Next.js utilities and components: sitemap generation, health checks, OG images, legal pages, error pages, and more
+> Server-side Next.js utilities: sitemap generation, health checks, OG images, contact forms, navigation, and config
 
 [![npm version](https://img.shields.io/npm/v/@djangocfg/nextjs.svg)](https://www.npmjs.com/package/@djangocfg/nextjs)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
@@ -11,7 +11,9 @@
 
 ## Overview
 
-`@djangocfg/nextjs` provides a comprehensive set of utilities and components for Next.js applications. From SEO optimization with sitemaps to health monitoring, from dynamic OG images to ready-to-use legal pages, this package covers common Next.js needs out of the box.
+`@djangocfg/nextjs` provides server-side utilities for Next.js applications. This package focuses on server-only functionality: SEO optimization with sitemaps, health monitoring, dynamic OG images, contact form handling, navigation utilities, and configuration management.
+
+> **Note:** Client components (legal pages, error pages, redirect components) have been moved to `@djangocfg/layouts` to keep this package server-only.
 
 ## Features
 
@@ -19,12 +21,10 @@
 - **Sitemap Generation** - Dynamic XML sitemap generation for SEO
 - **Health Checks** - Production-ready health monitoring endpoints
 - **OG Images** - Dynamic Open Graph image generation with templates
+- **Contact Forms** - Server-side contact form submission handlers
 - **Navigation Utilities** - Route definitions, menu generation, and navigation helpers
-- **Legal Pages** - Pre-built privacy, terms, cookies, and security pages
-- **Error Pages** - Reusable 404 and 500 error layouts
-- **HomePage Component** - Smart authentication redirect component
 - **TypeScript** - Full type safety throughout
-- **Self-Contained** - No external dependencies beyond Next.js
+- **Server-Only** - No client-side code, pure server utilities
 
 ## Installation
 
@@ -147,77 +147,55 @@ Automatically add OG images to page metadata:
 
 ```tsx
 // app/page.tsx
-import { generateMetadata } from '@core/metadata';
+import { generateOgImageMetadata } from '@djangocfg/nextjs/og-image/utils';
 
-export const metadata = generateMetadata({
+export const metadata = generateOgImageMetadata({
   title: 'My Page',
   description: 'Page description',
 });
 ```
 
-### Legal Pages
+### Contact Form
 
-Use pre-built legal pages:
+Create a contact form API route:
 
 ```tsx
-// app/legal/privacy/page.tsx
-import { PrivacyPage } from '@djangocfg/nextjs/legal';
+// app/api/contact/route.ts
+import { createContactRoute } from '@djangocfg/nextjs/contact';
 
-export default PrivacyPage;
+export const POST = createContactRoute();
 ```
 
-Available pages:
-- `PrivacyPage` - Privacy policy
-- `TermsPage` - Terms of service
-- `CookiesPage` - Cookie policy
-- `SecurityPage` - Security policy
-
-### Error Pages
-
-Use reusable error layouts:
+The route handler accepts form data and submits it to your API endpoint. The `apiUrl` can be passed in the request body or configured via environment variables.
 
-```tsx
-// app/not-found.tsx
-import { ErrorLayout } from '@djangocfg/nextjs/errors';
+### Navigation Utilities
 
-export default function NotFound() {
-  return <ErrorLayout code={404} supportEmail="support@example.com" />;
-}
-```
+Define routes and generate navigation menus:
 
 ```tsx
-// app/error.tsx
-'use client';
+import { defineRoute, routesToMenuItems } from '@djangocfg/nextjs/navigation';
 
-import { useEffect } from 'react';
-import { ErrorLayout } from '@djangocfg/nextjs/errors';
+const routes = [
+  defineRoute('/dashboard', { title: 'Dashboard' }),
+  defineRoute('/settings', { title: 'Settings' }),
+];
 
-export default function Error({ error, reset }: { error: Error; reset: () => void }) {
-  useEffect(() => {
-    console.error('Error:', error);
-  }, [error]);
-
-  return <ErrorLayout code={500} supportEmail="support@example.com" />;
-}
+const menuItems = routesToMenuItems(routes);
 ```
 
-### HomePage Component
+### Client Components
 
-Smart authentication redirect component:
+Client-side components (legal pages, error pages, redirect components) are available in `@djangocfg/layouts`:
 
 ```tsx
-// app/page.tsx
-import { HomePage } from '@djangocfg/nextjs/components';
-
-export default function Page() {
-  return (
-    <HomePage
-      authenticatedPath="/dashboard"
-      unauthenticatedPath="/auth"
-      loadingText="Loading..."
-    />
-  );
-}
+// Legal pages
+import { PrivacyPage, TermsPage } from '@djangocfg/layouts/pages/legal';
+
+// Error pages
+import { ErrorLayout } from '@djangocfg/layouts/components/errors';
+
+// Redirect component
+import { RedirectPage } from '@djangocfg/layouts/components/RedirectPage';
 ```
 
 ## Exports
@@ -230,10 +208,10 @@ export default function Page() {
 | `@djangocfg/nextjs/health` | Health check handlers |
 | `@djangocfg/nextjs/og-image` | OG image generation |
 | `@djangocfg/nextjs/og-image/utils` | OG image URL and metadata utilities |
+| `@djangocfg/nextjs/og-image/components` | OG image template components |
+| `@djangocfg/nextjs/contact` | Contact form route handlers |
 | `@djangocfg/nextjs/navigation` | Route definitions, menu generation, navigation helpers |
-| `@djangocfg/nextjs/legal` | Legal page components |
-| `@djangocfg/nextjs/errors` | Error page layouts |
-| `@djangocfg/nextjs/components` | Reusable components |
+| `@djangocfg/nextjs/scripts` | Utility scripts (e.g., link checking) |
 
 ## API Reference
 
@@ -326,17 +304,35 @@ generateOgImageMetadata(
 
 #### `generateOgImageUrl(baseUrl, params, useBase64?)`
 
-Generates OG image URL with base64-encoded parameters.
+> **Note:** This utility has been moved to `@djangocfg/layouts/utils/og-image` for client-side usage.
+
+For server-side usage, you can still use it from `@djangocfg/nextjs/og-image/utils`, but for client components, import from layouts:
 
 ```tsx
-generateOgImageUrl('/api/og', {
+// Client component
+import { generateOgImageUrl } from '@djangocfg/layouts/utils/og-image';
+
+const url = generateOgImageUrl('/api/og', {
   title: 'My Page',
   description: 'Page description',
   siteName: 'My Site',
-  logo: '/logo.svg',
-}, true) // useBase64 = true (default)
+});
+```
+
+### Contact Form
+
+#### `createContactRoute(options?)`
+
+Creates a Next.js API route handler for contact form submissions.
+
+```tsx
+createContactRoute({
+  // Options are handled via request body or environment variables
+})
 ```
 
+The route accepts POST requests with form data and submits to the API endpoint specified in the request body (`_apiUrl` field) or environment variables.
+
 ### Navigation
 
 #### `defineRoute(path, metadata, config?)`
@@ -371,57 +367,6 @@ Converts route definitions to menu items.
 const menuItems = routesToMenuItems(allRoutes);
 ```
 
-### Legal Pages
-
-#### `PrivacyPage`, `TermsPage`, `CookiesPage`, `SecurityPage`
-
-Pre-built legal page components with default content. Can be customized:
-
-```tsx
-import { PrivacyPage, privacyConfig } from '@djangocfg/nextjs/legal';
-
-// Use default
-export default PrivacyPage;
-
-// Or customize
-export default function CustomPrivacy() {
-  return <PrivacyPage config={{
-    ...privacyConfig,
-    lastUpdated: '2024-01-01',
-  }} />;
-}
-```
-
-### Error Pages
-
-#### `ErrorLayout`
-
-Reusable error page layout component.
-
-```tsx
-<ErrorLayout
-  code={404 | 500 | string | number}
-  title?: string
-  description?: string
-  supportEmail?: string
-  actions?: React.ReactNode
-  showDefaultActions?: boolean
-/>
-```
-
-### Components
-
-#### `HomePage`
-
-Authentication redirect component.
-
-```tsx
-<HomePage
-  authenticatedPath?: string      // Default: '/private'
-  unauthenticatedPath?: string    // Default: '/auth'
-  loadingText?: string             // Default: 'Loading...'
-/>
-```
 
 ## Requirements
 
@@ -431,9 +376,8 @@ Authentication redirect component.
 
 ## Peer Dependencies
 
-- `@djangocfg/layouts` - For auth context in HomePage
-- `@djangocfg/ui` - For UI components in legal/error pages
-- `lucide-react` - For icons
+- `@djangocfg/api` - For API client functionality
+- `next` - Next.js framework (^15.4.4)
 
 ## Documentation
 

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@djangocfg/nextjs",
-  "version": "1.0.3",
-  "description": "Next.js utilities and components: sitemap, health, OG images, legal pages, error pages",
+  "version": "1.0.5",
+  "description": "Next.js server utilities: sitemap, health, OG images, contact forms, navigation, config",
   "keywords": [
     "nextjs",
     "sitemap",
     "health",
     "og-image",
-    "legal-pages",
-    "error-pages",
+    "contact",
+    "navigation",
+    "config",
     "react",
     "typescript"
   ],
@@ -59,21 +60,6 @@
       "import": "./src/og-image/components/index.ts",
       "default": "./src/og-image/components/index.ts"
     },
-    "./legal": {
-      "types": "./src/legal/index.ts",
-      "import": "./src/legal/index.ts",
-      "default": "./src/legal/index.ts"
-    },
-    "./errors": {
-      "types": "./src/errors/index.ts",
-      "import": "./src/errors/index.ts",
-      "default": "./src/errors/index.ts"
-    },
-    "./components": {
-      "types": "./src/components/index.ts",
-      "import": "./src/components/index.ts",
-      "default": "./src/components/index.ts"
-    },
     "./contact": {
       "types": "./src/contact/index.ts",
       "import": "./src/contact/index.ts",
@@ -88,6 +74,11 @@
       "types": "./src/config/index.ts",
       "import": "./src/config/index.ts",
       "default": "./src/config/index.ts"
+    },
+    "./scripts": {
+      "types": "./src/scripts/index.ts",
+      "import": "./src/scripts/index.ts",
+      "default": "./src/scripts/index.ts"
     }
   },
   "files": [
@@ -100,34 +91,32 @@
     "dev": "tsup --watch",
     "clean": "rm -rf dist",
     "lint": "eslint .",
-    "check": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@vercel/og": "^0.8.5"
+    "check": "tsc --noEmit",
+    "check-links": "tsx src/scripts/check-links.ts"
   },
   "peerDependencies": {
-    "next": "^15.4.4",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
-    "@djangocfg/ui": "^1.4.33",
-    "@djangocfg/layouts": "^2.0.3",
-    "@djangocfg/api": "^1.4.33",
-    "lucide-react": "^0.469.0"
+    "@djangocfg/api": "^1.4.35",
+    "next": "^15.4.4"
   },
   "devDependencies": {
-    "@djangocfg/typescript-config": "^1.4.33",
-    "@djangocfg/layouts": "^2.0.3",
+    "@djangocfg/imgai": "^1.0.21",
+    "@djangocfg/layouts": "^2.0.5",
+    "@djangocfg/typescript-config": "^1.4.35",
     "@types/node": "^24.7.2",
     "@types/react": "19.2.2",
     "@types/react-dom": "19.2.1",
     "@types/webpack": "^5.28.5",
     "eslint": "^9.37.0",
+    "linkinator": "^7.5.0",
     "lucide-react": "^0.469.0",
+    "picocolors": "^1.1.1",
+    "prompts": "^2.4.2",
     "tsup": "^8.0.1",
-    "typescript": "^5.9.3"
+    "tsx": "^4.19.2",
+    "typescript": "^5.9.3",
+    "@vercel/og": "^0.8.5"
   },
   "publishConfig": {
     "access": "public"
   }
-}
-
+}

package/src/config/base-next-config.ts

@@ -226,6 +226,7 @@ export function createBaseNextConfig(
   // Cleanup: Remove our custom options that are not part of NextConfig
   // These are internal to BaseNextConfigOptions and should not be in the final config
   delete (finalConfig as any).optimizePackageImports;
+  delete (finalConfig as any).isDefaultCfgAdmin;
   // Note: We don't delete transpilePackages, experimental, env, webpack
   // as they are valid NextConfig keys and may have been overridden by user
 

package/src/contact/submit.ts

@@ -17,7 +17,7 @@
  * ```
  */
 
-import { API, MemoryStorageAdapter, Fetchers } from '@djangocfg/api';
+import { API, Fetchers } from '@djangocfg/api';
 import type { Schemas } from '@djangocfg/api';
 
 export interface SubmitContactFormOptions {
@@ -35,6 +35,26 @@ export interface SubmitContactFormResult {
   lead_id?: number;
 }
 
+/**
+ * Simple server-side memory storage adapter.
+ * Implements StorageAdapter interface without importing from client package.
+ */
+class ServerMemoryStorageAdapter {
+  private storage: Map<string, string> = new Map();
+
+  getItem(key: string): string | null {
+    return this.storage.get(key) || null;
+  }
+
+  setItem(key: string, value: string): void {
+    this.storage.set(key, value);
+  }
+
+  removeItem(key: string): void {
+    this.storage.delete(key);
+  }
+}
+
 /**
  * Submit contact form data to backend API
  * 
@@ -55,10 +75,10 @@ export async function submitContactForm({
     throw new Error('API URL is required');
   }
 
-  // Create server-side API instance with MemoryStorageAdapter
-  // This works on the server because MemoryStorageAdapter is not client-only
+  // Create server-side API instance with server-only memory storage adapter
+  // This avoids importing MemoryStorageAdapter from client package
   const serverApi = new API(apiUrl, {
-    storage: new MemoryStorageAdapter(),
+    storage: new ServerMemoryStorageAdapter(),
   });
 
   // Prepare submission data with site_url

package/src/index.ts

@@ -13,15 +13,6 @@ export * from './health';
 // OG Image
 export * from './og-image';
 
-// Legal pages
-export * from './legal';
-
-// Error pages
-export * from './errors';
-
-// Components
-export * from './components';
-
 // Contact form
 export * from './contact';