@djangocfg/nextjs 1.0.1

package/src/errors/errorConfig.ts

@@ -0,0 +1,118 @@
+/**
+ * Universal Error Configuration
+ *
+ * Provides standard error content for common HTTP status codes
+ * Use this to maintain consistency across error pages
+ *
+ * NOTE: Only returns primitives (title, description) - NO React components
+ * This ensures safe serialization during prerendering
+ */
+
+export interface ErrorContent {
+  title: string;
+  description: string;
+}
+
+/**
+ * Get standardized error content based on status code
+ *
+ * @param statusCode - HTTP status code or custom error type
+ * @returns Error content configuration (title and description only)
+ *
+ * @example
+ * ```tsx
+ * const { title, description } = getErrorContent(404);
+ * <ErrorLayout title={title} description={description} code={404} />
+ * ```
+ */
+export function getErrorContent(statusCode?: number | string): ErrorContent {
+  const code = typeof statusCode === 'string' ? parseInt(statusCode, 10) : statusCode;
+
+  switch (code) {
+    // 400 Bad Request
+    case 400:
+      return {
+        title: 'Bad Request',
+        description: 'The request could not be understood. Please check your input and try again.',
+      };
+
+    // 401 Unauthorized
+    case 401:
+      return {
+        title: 'Authentication Required',
+        description: 'You need to sign in to access this page.',
+      };
+
+    // 403 Forbidden
+    case 403:
+      return {
+        title: 'Access Denied',
+        description: "You don't have permission to access this resource.",
+      };
+
+    // 404 Not Found
+    case 404:
+      return {
+        title: 'Page Not Found',
+        description: "The page you're looking for doesn't exist or has been moved.",
+      };
+
+    // 408 Request Timeout
+    case 408:
+      return {
+        title: 'Request Timeout',
+        description: 'The request took too long to process. Please try again.',
+      };
+
+    // 500 Internal Server Error
+    case 500:
+      return {
+        title: 'Server Error',
+        description: "Something went wrong on our end. We're working to fix it.",
+      };
+
+    // 502 Bad Gateway
+    case 502:
+      return {
+        title: 'Bad Gateway',
+        description: 'The server received an invalid response. Please try again later.',
+      };
+
+    // 503 Service Unavailable
+    case 503:
+      return {
+        title: 'Service Unavailable',
+        description: 'The service is temporarily unavailable. Please try again later.',
+      };
+
+    // 504 Gateway Timeout
+    case 504:
+      return {
+        title: 'Gateway Timeout',
+        description: 'The server took too long to respond. Please try again.',
+      };
+
+    // Default / Unknown Error
+    default:
+      return {
+        title: 'Something Went Wrong',
+        description: 'An unexpected error occurred. Please try again or contact support.',
+      };
+  }
+}
+
+/**
+ * Common error codes as constants
+ */
+export const ERROR_CODES = {
+  BAD_REQUEST: 400,
+  UNAUTHORIZED: 401,
+  FORBIDDEN: 403,
+  NOT_FOUND: 404,
+  TIMEOUT: 408,
+  SERVER_ERROR: 500,
+  BAD_GATEWAY: 502,
+  SERVICE_UNAVAILABLE: 503,
+  GATEWAY_TIMEOUT: 504,
+} as const;
+

package/src/errors/index.ts

@@ -0,0 +1,10 @@
+/**
+ * Error pages exports
+ */
+
+export { ErrorLayout } from './ErrorLayout';
+export type { ErrorLayoutProps } from './ErrorLayout';
+
+export { getErrorContent, ERROR_CODES } from './errorConfig';
+export type { ErrorContent } from './errorConfig';
+

package/src/health/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Health exports
+ */
+
+export { createHealthHandler } from './route';
+export type { HealthConfig, HealthCheck, HealthResponse } from './types';
+

package/src/health/route.ts

@@ -0,0 +1,65 @@
+/**
+ * Health Route Handler for Next.js App Router
+ *
+ * Usage:
+ * ```tsx
+ * // app/api/health/route.ts
+ * import { createHealthHandler } from '@djangocfg/nextjs/health';
+ *
+ * export const GET = createHealthHandler({
+ *   version: process.env.NEXT_PUBLIC_APP_VERSION || '1.0.0',
+ *   checks: [
+ *     {
+ *       name: 'database',
+ *       check: async () => {
+ *         // Check database connection
+ *         return await checkDatabase();
+ *       },
+ *     },
+ *   ],
+ * });
+ * ```
+ */
+
+import { NextResponse } from 'next/server';
+import type { HealthConfig, HealthResponse } from './types';
+
+export function createHealthHandler(config: HealthConfig = {}) {
+  const { version, checks = [], customData = {} } = config;
+
+  return async function GET() {
+    const startTime = Date.now();
+    let status: 'ok' | 'error' = 'ok';
+    const checkResults: Record<string, boolean> = {};
+
+    // Run health checks
+    if (checks.length > 0) {
+      for (const check of checks) {
+        try {
+          const result = await check.check();
+          checkResults[check.name] = result;
+          if (!result) {
+            status = 'error';
+          }
+        } catch (error) {
+          checkResults[check.name] = false;
+          status = 'error';
+        }
+      }
+    }
+
+    const response: HealthResponse = {
+      status,
+      timestamp: new Date().toISOString(),
+      uptime: process.uptime(),
+      ...(version && { version }),
+      ...(Object.keys(checkResults).length > 0 && { checks: checkResults }),
+      ...customData,
+    };
+
+    const statusCode = status === 'ok' ? 200 : 503;
+
+    return NextResponse.json(response, { status: statusCode });
+  };
+}
+

package/src/health/types.ts

@@ -0,0 +1,19 @@
+/**
+ * Health check types
+ */
+
+import type { HealthResponse } from '../types';
+
+export interface HealthCheck {
+  name: string;
+  check: () => Promise<boolean> | boolean;
+}
+
+export interface HealthConfig {
+  version?: string;
+  checks?: HealthCheck[];
+  customData?: Record<string, unknown>;
+}
+
+export type { HealthResponse };
+

package/src/index.ts

@@ -0,0 +1,36 @@
+/**
+ * @djangocfg/nextjs
+ *
+ * Next.js utilities and components: sitemap, health, OG images, legal pages, error pages
+ */
+
+// Sitemap
+export * from './sitemap';
+
+// Health
+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';
+
+// Navigation
+export * from './navigation';
+
+// Config
+export * from './config';
+
+// Types
+export type * from './types';
+

package/src/legal/LegalPage.tsx

@@ -0,0 +1,85 @@
+/**
+ * LegalPage Component
+ *
+ * Reusable component for legal pages (Privacy, Terms, Cookies, Security)
+ * Accepts configuration for flexible content rendering
+ *
+ * Usage:
+ * ```tsx
+ * import { LegalPage } from '@djangocfg/nextjs/legal';
+ * import { privacyConfig } from './config';
+ *
+ * export default function PrivacyPage() {
+ *   return <LegalPage config={privacyConfig} />;
+ * }
+ * ```
+ */
+
+'use client';
+
+import React from 'react';
+import {
+  Card,
+  CardHeader,
+  CardTitle,
+  CardContent,
+} from '@djangocfg/ui/components';
+import type { LegalPageConfig } from './types';
+
+export interface LegalPageProps {
+  config: LegalPageConfig;
+  className?: string;
+}
+
+/**
+ * Format date for display
+ */
+function formatDate(date: string | Date | undefined): string {
+  if (!date) return '';
+  if (typeof date === 'string') return date;
+  return date.toISOString().split('T')[0];
+}
+
+/**
+ * LegalPage Component
+ */
+export function LegalPage({ config, className }: LegalPageProps) {
+  const { title, lastUpdated, sections } = config;
+
+  return (
+    <div className={`container mx-auto max-w-4xl py-16 px-4 ${className || ''}`}>
+      <div className="flex flex-col gap-8">
+        {/* Header */}
+        <div className="flex flex-col gap-4">
+          <h1 className="text-4xl font-bold">{title}</h1>
+          {lastUpdated && (
+            <p className="text-lg text-muted-foreground">
+              Last updated: {formatDate(lastUpdated)}
+            </p>
+          )}
+        </div>
+
+        {/* Sections */}
+        {sections.map((section, index) => (
+          <Card key={index}>
+            <CardHeader>
+              <CardTitle>{section.title}</CardTitle>
+            </CardHeader>
+            <CardContent className="text-muted-foreground">
+              {Array.isArray(section.content) ? (
+                <div className="flex flex-col gap-2">
+                  {section.content.map((paragraph, pIndex) => (
+                    <p key={pIndex}>{paragraph}</p>
+                  ))}
+                </div>
+              ) : (
+                <p>{section.content}</p>
+              )}
+            </CardContent>
+          </Card>
+        ))}
+      </div>
+    </div>
+  );
+}
+

package/src/legal/configs.ts

@@ -0,0 +1,131 @@
+/**
+ * Default legal page configurations
+ *
+ * Pre-configured content for common legal pages
+ * Can be customized or extended as needed
+ */
+
+import type { LegalPageConfig } from './types';
+
+export const privacyConfig: LegalPageConfig = {
+  title: 'Privacy Policy',
+  sections: [
+    {
+      title: 'Information We Collect',
+      content: 'We collect information that you provide directly to us, including when you create an account, use our services, or communicate with us.',
+    },
+    {
+      title: 'How We Use Your Information',
+      content: [
+        'We use the information we collect to:',
+        'Provide, maintain, and improve our services',
+        'Process transactions and send related information',
+        'Send technical notices and support messages',
+        'Respond to your comments and questions',
+      ],
+    },
+    {
+      title: 'Information Sharing',
+      content: 'We do not share your personal information with third parties except as described in this privacy policy or with your consent.',
+    },
+    {
+      title: 'Data Security',
+      content: 'We take reasonable measures to help protect your personal information from loss, theft, misuse, unauthorized access, disclosure, alteration, and destruction.',
+    },
+    {
+      title: 'Your Rights',
+      content: 'You have the right to access, update, or delete your personal information at any time. Contact us if you wish to exercise these rights.',
+    },
+    {
+      title: 'Changes to This Policy',
+      content: 'We may update this privacy policy from time to time. We will notify you of any changes by posting the new policy on this page.',
+    },
+  ],
+};
+
+export const termsConfig: LegalPageConfig = {
+  title: 'Terms of Service',
+  sections: [
+    {
+      title: '1. Acceptance of Terms',
+      content: 'By accessing and using this service, you accept and agree to be bound by the terms and provision of this agreement.',
+    },
+    {
+      title: '2. Use License',
+      content: 'Permission is granted to temporarily download one copy of the materials on our service for personal, non-commercial transitory viewing only.',
+    },
+    {
+      title: '3. Disclaimer',
+      content: 'The materials on our service are provided on an \'as is\' basis. We make no warranties, expressed or implied, and hereby disclaim and negate all other warranties including, without limitation, implied warranties or conditions of merchantability, fitness for a particular purpose, or non-infringement of intellectual property or other violation of rights.',
+    },
+    {
+      title: '4. Limitations',
+      content: 'In no event shall we or our suppliers be liable for any damages (including, without limitation, damages for loss of data or profit, or due to business interruption) arising out of the use or inability to use the materials on our service.',
+    },
+    {
+      title: '5. Revisions',
+      content: 'We may revise these terms of service at any time without notice. By using this service you are agreeing to be bound by the then current version of these terms of service.',
+    },
+  ],
+};
+
+export const cookiesConfig: LegalPageConfig = {
+  title: 'Cookie Policy',
+  sections: [
+    {
+      title: 'What Are Cookies?',
+      content: 'Cookies are small text files that are placed on your device when you visit our website. They help us provide you with a better experience by remembering your preferences and understanding how you use our site.',
+    },
+    {
+      title: 'Types of Cookies We Use',
+      content: [
+        'Essential Cookies: These cookies are necessary for the website to function properly.',
+        'Performance Cookies: These cookies help us understand how visitors interact with our website.',
+        'Functionality Cookies: These cookies allow us to remember choices you make and provide enhanced features.',
+      ],
+    },
+    {
+      title: 'Managing Cookies',
+      content: 'Most web browsers allow you to control cookies through their settings. You can set your browser to refuse cookies or delete certain cookies. However, please note that if you disable cookies, some features of our website may not function properly.',
+    },
+    {
+      title: 'Third-Party Cookies',
+      content: 'We may use third-party services that also use cookies. These third parties have their own privacy policies, and we do not accept any responsibility or liability for their policies.',
+    },
+    {
+      title: 'Updates to This Policy',
+      content: 'We may update our Cookie Policy from time to time. Any changes will be posted on this page with an updated revision date.',
+    },
+  ],
+};
+
+export const securityConfig: LegalPageConfig = {
+  title: 'Security Policy',
+  sections: [
+    {
+      title: 'Our Commitment to Security',
+      content: 'We take the security of your data seriously. We implement industry-standard security measures to protect your personal information from unauthorized access, disclosure, alteration, and destruction.',
+    },
+    {
+      title: 'Data Encryption',
+      content: 'All data transmitted between your device and our servers is encrypted using industry-standard SSL/TLS protocols. Sensitive data stored in our databases is encrypted at rest using advanced encryption standards.',
+    },
+    {
+      title: 'Access Controls',
+      content: 'Access to user data is strictly limited to authorized personnel who require it to perform their job functions. We employ multi-factor authentication and regular access reviews to ensure that only authorized individuals can access sensitive information.',
+    },
+    {
+      title: 'Security Monitoring',
+      content: 'We continuously monitor our systems for potential security threats and vulnerabilities. Our security team actively tracks and responds to any suspicious activity or potential security incidents.',
+    },
+    {
+      title: 'Reporting Security Issues',
+      content: 'If you discover a security vulnerability or have concerns about our security practices, please report it to us immediately. We appreciate responsible disclosure and will work with you to address any legitimate security concerns.',
+    },
+    {
+      title: 'Regular Security Updates',
+      content: 'We regularly update our systems and software to ensure that known security vulnerabilities are patched promptly. Our infrastructure undergoes periodic security audits and penetration testing to identify and address potential weaknesses.',
+    },
+  ],
+};
+

package/src/legal/index.ts

@@ -0,0 +1,24 @@
+/**
+ * Legal pages exports
+ */
+
+export { LegalPage } from './LegalPage';
+export type { LegalPageProps } from './LegalPage';
+
+export {
+  PrivacyPage,
+  TermsPage,
+  CookiesPage,
+  SecurityPage,
+} from './pages';
+export type { LegalPageComponentProps } from './pages';
+
+export {
+  privacyConfig,
+  termsConfig,
+  cookiesConfig,
+  securityConfig,
+} from './configs';
+
+export type { LegalPageConfig, LegalPageSection } from './types';
+

package/src/legal/pages.tsx

@@ -0,0 +1,58 @@
+/**
+ * Pre-built legal page components
+ *
+ * Ready-to-use page components with default configurations
+ * Can be customized by passing custom config
+ *
+ * Usage:
+ * ```tsx
+ * // app/legal/privacy/page.tsx
+ * import { PrivacyPage } from '@djangocfg/nextjs/legal';
+ *
+ * export default PrivacyPage;
+ * ```
+ */
+
+'use client';
+
+import { LegalPage } from './LegalPage';
+import {
+  privacyConfig,
+  termsConfig,
+  cookiesConfig,
+  securityConfig,
+} from './configs';
+import type { LegalPageConfig } from './types';
+
+export interface LegalPageComponentProps {
+  config?: LegalPageConfig;
+}
+
+/**
+ * Privacy Policy Page
+ */
+export function PrivacyPage({ config }: LegalPageComponentProps = {}) {
+  return <LegalPage config={config || privacyConfig} />;
+}
+
+/**
+ * Terms of Service Page
+ */
+export function TermsPage({ config }: LegalPageComponentProps = {}) {
+  return <LegalPage config={config || termsConfig} />;
+}
+
+/**
+ * Cookie Policy Page
+ */
+export function CookiesPage({ config }: LegalPageComponentProps = {}) {
+  return <LegalPage config={config || cookiesConfig} />;
+}
+
+/**
+ * Security Policy Page
+ */
+export function SecurityPage({ config }: LegalPageComponentProps = {}) {
+  return <LegalPage config={config || securityConfig} />;
+}
+

package/src/legal/types.ts

@@ -0,0 +1,15 @@
+/**
+ * Legal page types
+ */
+
+export interface LegalPageSection {
+  title: string;
+  content: string | string[];
+}
+
+export interface LegalPageConfig {
+  title: string;
+  lastUpdated?: string | Date;
+  sections: LegalPageSection[];
+}
+

package/src/navigation/index.ts

@@ -0,0 +1,9 @@
+/**
+ * Navigation Module
+ *
+ * Common utilities and types for route definitions and navigation
+ */
+
+export * from './types';
+export * from './utils';
+

package/src/navigation/types.ts

@@ -0,0 +1,68 @@
+/**
+ * Navigation Types
+ *
+ * Common types used for route definitions and navigation
+ */
+
+import type { LucideIcon } from 'lucide-react';
+
+// ─────────────────────────────────────────────────────────────────────────
+// Route Types
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface RouteMetadata {
+  label: string;
+  description?: string;
+  icon?: LucideIcon | string;
+  protected: boolean;
+  group?: string;
+  order?: number;
+  show?: boolean;
+}
+
+export interface RouteDefinition {
+  path: string;
+  metadata: RouteMetadata;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Menu Types
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface MenuItem {
+  path: string;
+  label: string;
+  icon: LucideIcon | string;
+  badge?: string | number;
+}
+
+export interface MenuGroup {
+  label: string;
+  order: number;
+  items: MenuItem[];
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Navigation Types
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface NavigationItem {
+  label: string;
+  path: string;
+}
+
+export interface NavigationSection {
+  title: string;
+  items: NavigationItem[];
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Breadcrumb Types
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface BreadcrumbItem {
+  label: string;
+  path: string;
+  isActive: boolean;
+}
+