nextpress-core 2.1.1 → 3.0.0

package/cli/index.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+const program = new Command();
+
+program
+    .name('np')
+    .command('install', 'Install Nextpress')
+    .command('run', 'Run Nextpress')
+    .command('down', 'Terminate Nextpress')
+    .command('log', 'Log Nextpress in production')
+    .parse(process.argv);

package/cli/meta.js

@@ -0,0 +1,5 @@
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+export const __filename = fileURLToPath(import.meta.url);
+export const __dirname = path.dirname(__filename);

package/cli/np-down.js

@@ -0,0 +1,10 @@
+import path from 'path';
+import { runCommand } from './run-command.js';
+import { containerLibPath } from './start-composer.js';
+
+await runCommand('docker', [
+    'compose',
+    '--project-directory', process.cwd(),
+    '-f', path.join(containerLibPath, 'docker-compose.yml'),
+    'down'
+]);

package/cli/np-install.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import path from 'path';
+import { __dirname } from './meta.js';
+
+function write(sourceDir, destDir) {
+    try {
+        if (!fs.existsSync(sourceDir)) {
+            console.error(`Error: Source folder does not exist at ${sourceDir}`);
+            process.exit(1);
+        }
+
+        if (fs.existsSync(destDir)) {
+            fs.rmSync(destDir, { recursive: true, force: true });
+        }
+
+        fs.cpSync(sourceDir, destDir, { recursive: true });
+    } catch (err) {
+        console.error('Error:', err.message);
+        process.exit(1);
+    }
+}
+
+// Copy nextjs library
+write(
+    path.join(__dirname, '..', 'lib', 'nextjs-lib'),
+    path.join(process.cwd(), 'next-js', '.nextpress')
+)
+
+// Copy wordpress library
+write(
+    path.join(__dirname, '..', 'lib', 'wp-lib', 'src'),
+    path.join(process.cwd(), 'wp', 'wp-content', 'themes', 'nextpress_theme', '.nextpress')
+)

package/cli/np-log.js

@@ -0,0 +1,12 @@
+import path from 'path';
+import { runCommand } from './run-command.js';
+import { containerLibPath } from './start-composer.js';
+
+await runCommand('docker', [
+    'compose',
+    '--project-directory', process.cwd(),
+    '-f', path.join(containerLibPath, 'docker-compose.yml'),
+    'logs',
+    '-f',
+    '--tail=100'
+]);

package/cli/np-run-dev.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+
+import path from 'path';
+import { runCommand } from './run-command.js';
+import { startComposer, containerLibPath } from './start-composer.js';
+
+const composeBaseArgs = [
+    'compose',
+    '--project-directory', process.cwd(),
+    '--env-file', path.join(process.cwd(), '.env'),
+    '-f', path.join(containerLibPath, 'docker-compose.yml'),
+    '-f', path.join(process.cwd(), 'docker-compose.extend.yml'),
+    '-f', path.join(containerLibPath, 'docker-compose.dev.yml'),
+    '-f', path.join(process.cwd(), 'docker-compose.dev.extend.yml'),
+]
+
+async function startDev() {
+    await startComposer(composeBaseArgs,
+        async () => {
+            console.log('Running Nextpress in development mode');
+            const dockerArgs = [
+                ...composeBaseArgs,
+                'up',
+                '--watch',
+                '--build',
+                '--menu=0',
+                'next-js', 'wordpress', 'ready-check',
+            ];
+            await runCommand('docker', dockerArgs);
+        }
+    );
+}
+
+await startDev();

package/cli/np-run-start.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+import path from 'path';
+import { runCommand } from './run-command.js';
+import { startComposer, containerLibPath } from './start-composer.js';
+
+const composeBaseArgs = [
+    'compose',
+    '--project-directory', process.cwd(),
+    '--env-file', path.join(process.cwd(), '.env'),
+    '-f', path.join(containerLibPath, 'docker-compose.yml'),
+    '-f', path.join(process.cwd(), 'docker-compose.extend.yml'),
+    '-f', path.join(containerLibPath, 'docker-compose.prod.yml'),
+    '-f', path.join(process.cwd(), 'docker-compose.prod.extend.yml'),
+]
+
+async function start() {
+    await startComposer(composeBaseArgs,
+        async () => {
+            console.log('Running Nextpress in production mode');
+            const dockerArgs = [
+                ...composeBaseArgs,
+                'up',
+                '--build',
+                '--detach',
+            ];
+            await runCommand('docker', dockerArgs);
+            console.log('\nNextpress services detached and running in background. Run npx np log to stream logs or npx np down to terminate the process');
+        }
+    );
+}
+
+await start();

package/cli/np-run.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+const program = new Command();
+
+program
+    .name('np run')
+    .command('dev', 'Run Nextpress in development mode')
+    .command('start', 'Run Nextpress in production mode')
+    .parse(process.argv);
+

package/cli/run-command.js

@@ -0,0 +1,23 @@
+import { spawn } from 'child_process';
+
+export const runCommand = (command, args) => {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            stdio: 'inherit'
+        });
+
+        child.on('exit', (code, signal) => {
+            if (code === 0) {
+                resolve();
+            }
+            else if (command === 'docker' && args.includes('down')) {
+                resolve();
+            }
+            else {
+                reject(new Error(`Command "${command} ${args.join(' ')}" failed with code ${code} / signal ${signal}`));
+            }
+        });
+
+        child.on('error', (err) => reject(err));
+    });
+};

package/cli/start-composer.js

@@ -0,0 +1,39 @@
+import path from 'path';
+import { __dirname } from './meta.js';
+import { runCommand } from './run-command.js';
+
+export const containerLibPath = path.join(__dirname, '..', 'lib', 'container-lib');
+
+export async function startComposer(composerArgs, callback) {
+    let isCleaningUp = false;
+
+    const cleanup = async () => {
+        if (isCleaningUp) return;
+        isCleaningUp = true;
+
+        console.log('\nStopping Nextpress services...\n');
+        try {
+            await runCommand('docker', [...composerArgs, 'down']);
+            console.log('\nNextpress services stopped successfully.');
+        } catch (err) {
+            console.error(`Error during cleanup: ${err.message}`);
+        }
+        process.exit(0);
+    };
+
+    process.on('SIGINT', cleanup);
+    process.on('SIGTERM', cleanup);
+
+    try {
+        console.log('Installing Next.js dependencies...');
+        await runCommand('npm', ['install', '--prefix', path.join(process.cwd(), 'next-js'), '--silent']);
+
+        console.log('Installing/Validating Nextpress...');
+        await runCommand('npx', ['np', 'install']);
+
+        await callback();
+    } catch (error) {
+        console.error(`Setup stopped: ${error.message}`);
+        await cleanup();
+    }
+}

package/lib/container-lib/NextJS.Dockerfile

@@ -0,0 +1,47 @@
+FROM node:24-alpine AS base
+    RUN apk add --no-cache libc6-compat
+    WORKDIR /app
+
+    ENV NEXT_TELEMETRY_DISABLED 1
+
+FROM base AS deps
+    COPY package*.json ./
+    RUN npm ci
+
+FROM base AS builder
+    ARG WP_SERVICE_URL
+    ENV WP_SERVICE_URL=$WP_SERVICE_URL
+
+    COPY --from=deps /app/node_modules ./node_modules
+    COPY . .
+    RUN npm run compile
+
+# --- Final Production Stage ---
+FROM base AS production
+    ENV NODE_ENV production
+
+    RUN addgroup --system --gid 1001 nodejs && \
+        adduser --system --uid 1001 nextjs
+
+    RUN chown nextjs:nodejs /app
+
+    COPY --from=deps --chown=nextjs:nodejs /app/node_modules ./node_modules
+    COPY --from=builder --chown=nextjs:nodejs /app ./
+
+    USER nextjs
+
+    ENV HOSTNAME "0.0.0.0"
+
+    EXPOSE 3000
+    ENV PORT 3000
+
+    CMD npm run generate && npm run start
+
+# --- Final Development Stage ---
+FROM base AS development
+    ENV NODE_ENV=development
+
+    COPY --from=deps /app/node_modules ./node_modules
+    COPY . .
+    EXPOSE 3000
+    CMD ["npm", "run", "dev"]

package/lib/container-lib/docker-compose.dev.yml

@@ -0,0 +1,69 @@
+services:
+  wordpress:
+    command: >
+      sh -c "
+        # Check if Xdebug is already compiled. If not, install it quietly.
+        if [ ! -f /usr/local/lib/php/extensions/*/xdebug.so ]; then
+          pecl install xdebug > /dev/null && docker-php-ext-enable xdebug;
+        fi;
+
+        echo 'ServerName localhost' >> /etc/apache2/apache2.conf;
+        docker-entrypoint.sh apache2-foreground;
+      "
+    volumes:
+    - ./node_modules/nextpress-core/lib/container-lib/mail.dev.ini:/usr/local/etc/php/conf.d/mail.ini:ro
+    environment:
+      XDEBUG_MODE: debug
+      XDEBUG_SESSION: 1
+      XDEBUG_TRIGGER: 1
+      XDEBUG_CONFIG: "client_host=host.docker.internal client_port=9003 start_with_request=yes log_level=0"
+      WORDPRESS_DEBUG: true
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+  next-js:
+    build:
+      target: development
+    develop:
+      watch:
+        - action: rebuild
+          path: ./next-js/package.json
+        - action: sync
+          path: ./next-js
+          target: /app
+          ignore:
+            - node_modules/
+            - .next/
+            - src/lib/nextpress/types/wpdb/
+            - package.json
+  mailpit:
+    image: axllent/mailpit:latest
+    depends_on:
+      wordpress:
+        condition: service_healthy
+    environment:
+      - MP_WEBROOT=/mailpit-admin/
+      - MP_API_CORS=http://localhost:8080
+    restart: always
+    ports:
+      - "8025:8025"
+      - "1025:1025"
+  gateway:
+    depends_on:
+      mailpit:
+        condition: service_started
+  ready-check:
+    command: >
+      sh -c '
+        printf "\n"
+        printf "\033[92m===============================================\n"
+        printf "\033[92mDEPLOYMENT SUCCESSFUL\033[0m\n"
+        printf "\033[92mOpen site: ${WP_SITE_URL}\033[0m\n"
+        printf "\033[92mWP Admin: ${WP_SITE_URL}/wp-admin\033[0m\n"
+        printf "\033[92mDB Admin: ${WP_SITE_URL}/db-admin\033[0m\n"
+        printf "\033[92mMailpit Admin: ${WP_SITE_URL}/mailpit-admin\033[0m\n"
+        printf "\033[92m===============================================\033[0m\n"
+        printf "\033[92mDEVELOPMENT ENVIRONMENT ACTIVE\033[0m\n"
+        printf "\033[92mWatching for changes in next-js\033[0m\n"
+        printf "\033[92m===============================================\033[0m\n"
+        printf "\n"
+      '

package/lib/container-lib/docker-compose.prod.yml

@@ -0,0 +1,23 @@
+services:
+  wordpress:
+    command: sh -c "echo 'ServerName localhost' >> /etc/apache2/apache2.conf && docker-entrypoint.sh apache2-foreground"
+    volumes:
+    - ./node_modules/nextpress-core/lib/container-lib/mail.prod.ini:/usr/local/etc/php/conf.d/mail.ini:ro
+    environment:
+      WORDPRESS_DEBUG: true
+  next-js:
+    build:
+      target: production
+  ready-check:
+    command: >
+      sh -c '
+        printf "\n"
+        printf "\033[92m===============================================\n"
+        printf "\033[92mDEPLOYMENT SUCCESSFUL\033[0m\n"
+        printf "\033[92mOpen site: ${WP_SITE_URL}\033[0m\n"
+        printf "\033[92mWP Admin: ${WP_SITE_URL}/wp-admin\033[0m\n"
+        printf "\033[92mDB Admin: ${WP_SITE_URL}/db-admin\033[0m\n"
+        printf "\033[92m===============================================\033[0m\n"
+        printf "\n"
+      '
+

package/lib/container-lib/docker-compose.yml

@@ -0,0 +1,161 @@
+services:
+  db:
+    image: mysql:8.0
+    restart: always
+    command: --max-connections=200
+    volumes:
+      - db:/var/lib/mysql
+    environment:
+      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
+      MYSQL_DATABASE: ${MYSQL_DATABASE}
+    healthcheck:
+      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p$${MYSQL_ROOT_PASSWORD}"]
+      interval: 30s
+      timeout: 5s
+      retries: 5
+      start_period: 15s
+
+  adminer:
+    image: adminer:latest
+    depends_on:
+      db:
+        condition: service_healthy
+    ports:
+      - "8000:80"
+  wordpress:
+    image: wordpress:6.9.4-php8.4
+    depends_on:
+      db:
+        condition: service_healthy
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+    volumes:
+      - ./wp:/var/www/html
+      - ./node_modules/nextpress-core/lib/container-lib/uploads.ini:/usr/local/etc/php/conf.d/uploads.ini
+    environment:
+      WORDPRESS_DB_HOST: db
+      WORDPRESS_DB_USER: root
+      WORDPRESS_DB_PASSWORD: ${MYSQL_ROOT_PASSWORD}
+      WORDPRESS_DB_NAME: ${MYSQL_DATABASE}
+      NEXTJS_SERVICE_URL: http://next-js:3000
+      CROSS_CONTAINER_API_KEY: ${CROSS_CONTAINER_API_KEY}
+      WORDPRESS_ADMIN_USERNAME: ${WP_ADMIN_USER}
+      WORDPRESS_ADMIN_PASSWORD: ${WP_ADMIN_PASSWORD}
+      WORDPRESS_ADMIN_EMAIL: ${WP_ADMIN_EMAIL}
+    healthcheck:
+      test: ["CMD-SHELL", "php -r 'echo (file_get_contents(\"wp-login.php\") !== false ? 0 : 1);'"]
+      interval: 30s
+      timeout: 5s
+      retries: 5
+      start_period: 15s
+
+  wp-cli:
+    image: wordpress:cli-php8.4
+    tty: true
+    user: "33:33"
+    depends_on:
+      db:
+        condition: service_healthy
+      wordpress:
+        condition: service_healthy
+    volumes:
+      - ./wp:/var/www/html
+    environment:
+      WORDPRESS_DB_HOST: db
+      WORDPRESS_DB_USER: root
+      WORDPRESS_DB_PASSWORD: ${MYSQL_ROOT_PASSWORD}
+      WORDPRESS_DB_NAME: ${MYSQL_DATABASE}
+      WORDPRESS_ADMIN_USERNAME: ${WP_ADMIN_USER}
+      WORDPRESS_ADMIN_PASSWORD: ${WP_ADMIN_PASSWORD}
+      WORDPRESS_ADMIN_EMAIL: ${WP_ADMIN_EMAIL}
+    command: >
+      /bin/sh -c '
+        while [ ! -f /var/www/html/wp-config.php ]; do sleep 2; done;
+
+        if ! wp core is-installed --path="/var/www/html"; then
+          wp core install --path="/var/www/html" --url="${WP_SITE_URL}" --title="${WP_SITE_TITLE}" --admin_user="${WP_ADMIN_USER}" --admin_password="${WP_ADMIN_PASSWORD}" --admin_email="${WP_ADMIN_EMAIL}" --skip-email;
+        fi;
+
+        wp option update siteurl "${WP_SITE_URL}" --path="/var/www/html";
+        wp option update home "${WP_SITE_URL}" --path="/var/www/html";
+
+        wp plugin delete akismet hello --path="/var/www/html" 2>/dev/null;
+        wp theme delete twentytwentythree twentytwentyfour twentytwentyfive --path="/var/www/html" 2>/dev/null;
+
+        wp rewrite structure "/%postname%/" --path="/var/www/html" --hard;
+        wp rewrite flush --path="/var/www/html" --hard;
+
+        if ! wp plugin is-active secure-custom-fields --path="/var/www/html" 2>/dev/null; then
+          wp plugin install secure-custom-fields --version=6.8.5 --activate --path="/var/www/html";
+        fi;
+
+        if ! wp plugin is-active svg-support --path="/var/www/html" 2>/dev/null; then
+          wp plugin install svg-support --version=2.5.16 --activate --path="/var/www/html";
+        fi;
+
+        wp theme activate nextpress_theme --path="/var/www/html";
+      '
+
+  next-js:
+    depends_on:
+      db:
+        condition: service_healthy
+      wordpress:
+        condition: service_healthy
+      wp-cli:
+        condition: service_completed_successfully
+    build:
+      context: ./next-js
+      dockerfile: ../node_modules/nextpress-core/lib/container-lib/NextJS.Dockerfile
+      args:
+        - WP_SERVICE_URL=http://wordpress:80
+    working_dir: /app
+    environment:
+      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
+      MYSQL_DATABASE: ${MYSQL_DATABASE}
+      DATABASE_URL: mysql://root:${MYSQL_ROOT_PASSWORD}@db:3306/${MYSQL_DATABASE}
+      WP_SERVICE_URL: http://wordpress:80
+      WP_SITE_URL: ${WP_SITE_URL}
+      CROSS_CONTAINER_API_KEY: ${CROSS_CONTAINER_API_KEY}
+    healthcheck:
+      test: ["CMD-SHELL", "wget --spider -q http://0.0.0.0:3000 || exit 1"]
+      interval: 30s
+      timeout: 5s
+      retries: 10
+      start_period: 15s
+
+  gateway:
+    image: nginx:alpine
+    depends_on:
+      db:
+        condition: service_healthy
+      adminer:
+        condition: service_started
+      wordpress:
+        condition: service_healthy
+      wp-cli:
+        condition: service_completed_successfully
+      next-js:
+        condition: service_healthy
+    ports:
+      - "8080:80"
+    volumes:
+      - ./node_modules/nextpress-core/lib/container-lib/nginx.conf:/etc/nginx/conf.d/default.conf:ro
+      - ./nginx.extend.conf:/etc/nginx/snippets/extend.conf:ro
+    healthcheck:
+      test: ["CMD-SHELL", "pgrep nginx || exit 1"]
+      interval: 30s
+      timeout: 5s
+      retries: 5
+      start_period: 15s
+
+  ready-check:
+    image: alpine
+    depends_on:
+      gateway:
+        condition: service_healthy
+    environment:
+      - NODE_ENV=${NODE_ENV:-development}
+
+volumes:
+  db:

package/lib/container-lib/mail.dev.ini

@@ -0,0 +1,3 @@
+; Redirect native PHP mail to the host machine's SMTP port
+SMTP = host.docker.internal
+smtp_port = 1025

package/lib/container-lib/mail.prod.ini

@@ -0,0 +1,3 @@
+; Redirect native PHP mail to the host machine's SMTP port
+SMTP = host.docker.internal
+smtp_port = 25

package/lib/container-lib/nginx.conf

@@ -0,0 +1,71 @@
+server {
+    listen 80;
+    access_log off;
+    client_max_body_size 256M;
+
+    include /etc/nginx/snippets/extend.conf*;
+
+    # Route WordPress Backend and Core Assets
+    location ~* ^/(wp-admin|wp-login\.php|wp-content|wp-includes|wp-json) {
+        proxy_pass http://wordpress:80;
+        proxy_set_header Host $http_host;
+        proxy_set_header X-Forwarded-Host $http_host;
+
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+
+    # Route everything else to the Next.JS app
+    location / {
+        proxy_pass http://next-js:3000;
+        proxy_set_header Host $http_host;
+        proxy_set_header X-Forwarded-Host $http_host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+
+    # Route Next.JS websockets
+    location /_next/webpack-hmr {
+        proxy_pass http://next-js:3000/_next/webpack-hmr;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+    }
+
+    # Route Adminer Database Manager
+    location /db-admin {
+        proxy_pass http://adminer:8080;
+        proxy_set_header Host $http_host;
+        proxy_set_header X-Forwarded-Host $http_host;
+
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+
+    location = /mailpit-admin {
+        return 301 $scheme://$http_host/mailpit-admin/;
+    }
+
+    location /mailpit-admin/ {
+        resolver 127.0.0.11 valid=30s;
+        set $mailpit_host "mailpit";
+
+        proxy_pass http://$mailpit_host:8025;
+
+        proxy_hide_header Content-Security-Policy;
+        add_header Content-Security-Policy "default-src 'self' 'unsafe-inline' 'unsafe-eval'";
+
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+
+        # WebSockets (Crucial for Mailpit dashboard updates)
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+
+        proxy_buffering off;
+    }
+}

package/lib/container-lib/uploads.ini

@@ -0,0 +1,3 @@
+upload_max_filesize = 256M
+post_max_size = 128M
+memory_limit = 256M

package/lib/wp-lib/src/acf/acf.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace Nextpress\ACF;
+
+require_once __DIR__ . '/load_acf_fields.php';
+require_once __DIR__ . '/acf_add_options.php';
+
+add_filter('acf/settings/show_admin', '__return_false');
+add_action('acf/init', fn() => load_acf_fields_from_api());
+add_action('acf/init', fn() => acf_add_options());

package/lib/wp-lib/src/acf/acf_add_options.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Nextpress\ACF;
+
+/**
+ * Registers a custom global ACF options page for App Options.
+ *
+ * @return void
+ */
+function acf_add_options(): void {
+    \acf_add_options_page([
+        'page_title' => "App Options",
+        'menu_title' => "App Options",
+        'menu_slug' => "app_options",
+        'capability' => "manage_options",
+        'redirect' => false,
+    ]);
+}

package/lib/wp-lib/src/acf/load_acf_fields.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Nextpress\ACF;
+
+/**
+ * Loads ACF field groups remotely from the fronend API service.
+ *
+ * @return void
+ */
+
+function load_acf_fields_from_api(): void {
+    $nextjs_service_url = getenv_docker('NEXTJS_SERVICE_URL', '');
+    $api_key = getenv_docker('CROSS_CONTAINER_API_KEY', '');
+    if (!$nextjs_service_url || !\is_scalar($nextjs_service_url) || !\is_scalar($api_key)) return;
+
+    $response = wp_remote_get($nextjs_service_url . '/api/field-groups', [
+        'headers' => [
+            'Authorization' => 'api-key ' . $api_key,
+            'Content-Type' => 'application/json'
+        ]
+    ]);
+
+    if (!is_wp_error($response)) {
+        $body = wp_remote_retrieve_body($response);
+        $field_groups_data = json_decode($body, true);
+        if (!\is_array($field_groups_data)) return;
+
+        foreach ($field_groups_data as $field_group) {
+            if (!\is_array($field_group)) continue;
+
+            acf_add_local_field_group($field_group);
+        }
+    }
+}