@jumpgroup/laravel-tools 3.3.0

package/src/stub/docker-compose/php8.1/docker-compose.yml

@@ -0,0 +1,78 @@
+services:
+  traefik:
+    image: "traefik:v3.6.11"
+    container_name: ${APP_NAME}-traefik
+    networks:
+      - api-network
+    ports:
+      - "80:80"
+      - "443:443"
+      - "8081:8080"
+    volumes:
+      - "/var/run/docker.sock:/var/run/docker.sock:ro"
+      - ./docker/traefik/traefik.yml:/etc/traefik/traefik.yml
+      - ./docker/traefik/dynamic_conf.yml:/etc/traefik/dynamic_conf.yml
+      - ./docker/certs:/etc/traefik/certs
+
+  api:
+    image: jumpgroupit/laravel-image:0.2.3
+    container_name: ${APP_NAME}-api
+    command: "php artisan serve --host=0.0.0.0 --port 80"
+    restart: unless-stopped
+    environment:
+      SERVICE_NAME: app
+      SERVICE_TAGS: dev
+    working_dir: /var/www
+    volumes:
+      - ./:/var/www
+      - ./docker/php/local.ini:/usr/local/etc/php/conf.d/local.ini
+      - ./docker/certs:/etc/certs
+    networks:
+      api-network:
+        aliases:
+          - ${APP_NAME}.test
+    depends_on:
+      - db
+      - mailpit
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.app.entrypoints=http,https"
+      - "traefik.http.routers.app.rule=Host(`${APP_NAME}.test`)"
+      - "traefik.http.routers.app.tls=true"
+    ports:
+      - 8000:80
+
+  db:
+    image: mysql:8.4
+    container_name: ${APP_NAME}-mysql
+    restart: unless-stopped
+    ports:
+      - "3306:3306"
+    environment:
+      - MYSQL_DATABASE=${DB_DATABASE}
+      - MYSQL_ROOT_PASSWORD=${DB_PASSWORD}
+    volumes:
+      - ./docker/mysql/my.cnf:/etc/mysql/my.cnf
+      - ./docker/mysql/data:/var/lib/mysql:delegated
+    networks:
+      - api-network
+
+  mailpit:
+    image: axllent/mailpit:latest
+    container_name: ${APP_NAME}-mailpit
+    restart: unless-stopped
+    ports:
+      - "1025:1025"
+      - "8025:8025"
+    networks:
+      - api-network
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.mailpit.entrypoints=http,https"
+      - "traefik.http.routers.mailpit.rule=Host(`mail.${APP_NAME}.test`)"
+      - "traefik.http.routers.mailpit.tls=true"
+      - "traefik.http.services.mailpit.loadbalancer.server.port=8025"
+
+networks:
+  api-network:
+    driver: bridge

package/src/stub/docker-compose/php8.2/docker-compose.yml

@@ -0,0 +1,78 @@
+services:
+  traefik:
+    image: "traefik:v3.6.11"
+    container_name: ${APP_NAME}-traefik
+    networks:
+      - api-network
+    ports:
+      - "80:80"
+      - "443:443"
+      - "8081:8080"
+    volumes:
+      - "/var/run/docker.sock:/var/run/docker.sock:ro"
+      - ./docker/traefik/traefik.yml:/etc/traefik/traefik.yml
+      - ./docker/traefik/dynamic_conf.yml:/etc/traefik/dynamic_conf.yml
+      - ./docker/certs:/etc/traefik/certs
+
+  api:
+    image: jumpgroupit/laravel-image:0.1.0
+    container_name: ${APP_NAME}-api
+    command: "php artisan serve --host=0.0.0.0 --port 80"
+    restart: unless-stopped
+    environment:
+      SERVICE_NAME: app
+      SERVICE_TAGS: dev
+    working_dir: /var/www
+    volumes:
+      - ./:/var/www
+      - ./docker/php/local.ini:/usr/local/etc/php/conf.d/local.ini
+      - ./docker/certs:/etc/certs
+    networks:
+      api-network:
+        aliases:
+          - ${APP_NAME}.test
+    depends_on:
+      - db
+      - mailpit
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.app.entrypoints=http,https"
+      - "traefik.http.routers.app.rule=Host(`${APP_NAME}.test`)"
+      - "traefik.http.routers.app.tls=true"
+    ports:
+      - 8000:80
+
+  db:
+    image: mysql:8.4
+    container_name: ${APP_NAME}-mysql
+    restart: unless-stopped
+    ports:
+      - "3306:3306"
+    environment:
+      - MYSQL_DATABASE=${DB_DATABASE}
+      - MYSQL_ROOT_PASSWORD=${DB_PASSWORD}
+    volumes:
+      - ./docker/mysql/my.cnf:/etc/mysql/my.cnf
+      - ./docker/mysql/data:/var/lib/mysql:delegated
+    networks:
+      - api-network
+
+  mailpit:
+    image: axllent/mailpit:latest
+    container_name: ${APP_NAME}-mailpit
+    restart: unless-stopped
+    ports:
+      - "1025:1025"
+      - "8025:8025"
+    networks:
+      - api-network
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.mailpit.entrypoints=http,https"
+      - "traefik.http.routers.mailpit.rule=Host(`mail.${APP_NAME}.test`)"
+      - "traefik.http.routers.mailpit.tls=true"
+      - "traefik.http.services.mailpit.loadbalancer.server.port=8025"
+
+networks:
+  api-network:
+    driver: bridge

package/src/stub/docker-compose/php8.3/docker-compose.yml

@@ -0,0 +1,78 @@
+services:
+  traefik:
+    image: "traefik:v3.6.11"
+    container_name: ${APP_NAME}-traefik
+    networks:
+      - api-network
+    ports:
+      - "80:80"
+      - "443:443"
+      - "8081:8080"
+    volumes:
+      - "/var/run/docker.sock:/var/run/docker.sock:ro"
+      - ./docker/traefik/traefik.yml:/etc/traefik/traefik.yml
+      - ./docker/traefik/dynamic_conf.yml:/etc/traefik/dynamic_conf.yml
+      - ./docker/certs:/etc/traefik/certs
+
+  api:
+    image: jumpgroupit/laravel-image:0.2.4
+    container_name: ${APP_NAME}-api
+    command: "php artisan serve --host=0.0.0.0 --port 80"
+    restart: unless-stopped
+    environment:
+      SERVICE_NAME: app
+      SERVICE_TAGS: dev
+    working_dir: /var/www
+    volumes:
+      - ./:/var/www
+      - ./docker/php/local.ini:/usr/local/etc/php/conf.d/local.ini
+      - ./docker/certs:/etc/certs
+    networks:
+      api-network:
+        aliases:
+          - ${APP_NAME}.test
+    depends_on:
+      - db
+      - mailpit
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.app.entrypoints=http,https"
+      - "traefik.http.routers.app.rule=Host(`${APP_NAME}.test`)"
+      - "traefik.http.routers.app.tls=true"
+    ports:
+      - 8000:80
+
+  db:
+    image: mysql:8.4
+    container_name: ${APP_NAME}-mysql
+    restart: unless-stopped
+    ports:
+      - "3306:3306"
+    environment:
+      - MYSQL_DATABASE=${DB_DATABASE}
+      - MYSQL_ROOT_PASSWORD=${DB_PASSWORD}
+    volumes:
+      - ./docker/mysql/my.cnf:/etc/mysql/my.cnf
+      - ./docker/mysql/data:/var/lib/mysql:delegated
+    networks:
+      - api-network
+
+  mailpit:
+    image: axllent/mailpit:latest
+    container_name: ${APP_NAME}-mailpit
+    restart: unless-stopped
+    ports:
+      - "1025:1025"
+      - "8025:8025"
+    networks:
+      - api-network
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.mailpit.entrypoints=http,https"
+      - "traefik.http.routers.mailpit.rule=Host(`mail.${APP_NAME}.test`)"
+      - "traefik.http.routers.mailpit.tls=true"
+      - "traefik.http.services.mailpit.loadbalancer.server.port=8025"
+
+networks:
+  api-network:
+    driver: bridge

package/src/stub/docker-compose/php8.4/docker-compose.yml

@@ -0,0 +1,78 @@
+services:
+  traefik:
+    image: "traefik:v3.6.11"
+    container_name: ${APP_NAME}-traefik
+    networks:
+      - api-network
+    ports:
+      - "80:80"
+      - "443:443"
+      - "8081:8080"
+    volumes:
+      - "/var/run/docker.sock:/var/run/docker.sock:ro"
+      - ./docker/traefik/traefik.yml:/etc/traefik/traefik.yml
+      - ./docker/traefik/dynamic_conf.yml:/etc/traefik/dynamic_conf.yml
+      - ./docker/certs:/etc/traefik/certs
+
+  api:
+    image: jumpgroupit/laravel-image:0.2.5
+    container_name: ${APP_NAME}-api
+    command: "php artisan serve --host=0.0.0.0 --port 80"
+    restart: unless-stopped
+    environment:
+      SERVICE_NAME: app
+      SERVICE_TAGS: dev
+    working_dir: /var/www
+    volumes:
+      - ./:/var/www
+      - ./docker/php/local.ini:/usr/local/etc/php/conf.d/local.ini
+      - ./docker/certs:/etc/certs
+    networks:
+      api-network:
+        aliases:
+          - ${APP_NAME}.test
+    depends_on:
+      - db
+      - mailpit
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.app.entrypoints=http,https"
+      - "traefik.http.routers.app.rule=Host(`${APP_NAME}.test`)"
+      - "traefik.http.routers.app.tls=true"
+    ports:
+      - 8000:80
+
+  db:
+    image: mysql:8.4
+    container_name: ${APP_NAME}-mysql
+    restart: unless-stopped
+    ports:
+      - "3306:3306"
+    environment:
+      - MYSQL_DATABASE=${DB_DATABASE}
+      - MYSQL_ROOT_PASSWORD=${DB_PASSWORD}
+    volumes:
+      - ./docker/mysql/my.cnf:/etc/mysql/my.cnf
+      - ./docker/mysql/data:/var/lib/mysql:delegated
+    networks:
+      - api-network
+
+  mailpit:
+    image: axllent/mailpit:latest
+    container_name: ${APP_NAME}-mailpit
+    restart: unless-stopped
+    ports:
+      - "1025:1025"
+      - "8025:8025"
+    networks:
+      - api-network
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.mailpit.entrypoints=http,https"
+      - "traefik.http.routers.mailpit.rule=Host(`mail.${APP_NAME}.test`)"
+      - "traefik.http.routers.mailpit.tls=true"
+      - "traefik.http.services.mailpit.loadbalancer.server.port=8025"
+
+networks:
+  api-network:
+    driver: bridge

package/src/stub/docker-compose.yml

@@ -0,0 +1,78 @@
+services:
+  traefik:
+    image: "traefik:v3.6.11"
+    container_name: ${APP_NAME}-traefik
+    networks:
+      - api-network
+    ports:
+      - "80:80"
+      - "443:443"
+      - "8081:8080"
+    volumes:
+      - "/var/run/docker.sock:/var/run/docker.sock:ro"
+      - ./docker/traefik/traefik.yml:/etc/traefik/traefik.yml
+      - ./docker/traefik/dynamic_conf.yml:/etc/traefik/dynamic_conf.yml
+      - ./docker/certs:/etc/traefik/certs
+
+  api:
+    image: jumpgroupit/laravel-image:0.2.5
+    container_name: ${APP_NAME}-api
+    command: "php artisan serve --host=0.0.0.0 --port 80"
+    restart: unless-stopped
+    environment:
+      SERVICE_NAME: app
+      SERVICE_TAGS: dev
+    working_dir: /var/www
+    volumes:
+      - ./:/var/www
+      - ./docker/php/local.ini:/usr/local/etc/php/conf.d/local.ini
+      - ./docker/certs:/etc/certs
+    networks:
+      api-network:
+        aliases:
+          - ${APP_NAME}.test
+    depends_on:
+      - db
+      - mailpit
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.app.entrypoints=http,https"
+      - "traefik.http.routers.app.rule=Host(`${APP_NAME}.test`)"
+      - "traefik.http.routers.app.tls=true"
+    ports:
+      - 8000:80
+
+  db:
+    image: mysql:8.4
+    container_name: ${APP_NAME}-mysql
+    restart: unless-stopped
+    ports:
+      - "3306:3306"
+    environment:
+      - MYSQL_DATABASE=${DB_DATABASE}
+      - MYSQL_ROOT_PASSWORD=${DB_PASSWORD}
+    volumes:
+      - ./docker/mysql/my.cnf:/etc/mysql/my.cnf
+      - ./docker/mysql/data:/var/lib/mysql:delegated
+    networks:
+      - api-network
+
+  mailpit:
+    image: axllent/mailpit:latest
+    container_name: ${APP_NAME}-mailpit
+    restart: unless-stopped
+    ports:
+      - "1025:1025"
+      - "8025:8025"
+    networks:
+      - api-network
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.mailpit.entrypoints=http,https"
+      - "traefik.http.routers.mailpit.rule=Host(`mail.${APP_NAME}.test`)"
+      - "traefik.http.routers.mailpit.tls=true"
+      - "traefik.http.services.mailpit.loadbalancer.server.port=8025"
+
+networks:
+  api-network:
+    driver: bridge

package/src/utilities/command.js

@@ -0,0 +1,137 @@
+import { spawn, spawnSync } from 'child_process';
+import { readFileSync } from 'fs';
+import { parse } from 'dotenv';
+import yaml from 'js-yaml';
+
+// Runs a shell command, streaming stdout/stderr to the terminal.
+// Returns a Promise that resolves on exit code 0, rejects otherwise.
+export const executeCommand = (command, args = [], options = {}) => {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, { stdio: 'inherit', ...options });
+
+    child.on('close', (code) => {
+      if (code === 0) resolve();
+      else reject(new Error(`Command '${command}' exited with code ${code}`));
+    });
+
+    child.on('error', (err) => {
+      reject(new Error(`Failed to start command '${command}': ${err.message}`));
+    });
+  });
+};
+
+export const executeCommandWithOutput = (command, args = [], options = {}) => {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, { ...options, stdio: ['inherit', 'pipe', 'pipe'] });
+
+    let stdout = '';
+    let stderr = '';
+
+    child.stdout.on('data', (data) => { stdout += data.toString(); });
+    child.stderr.on('data', (data) => { stderr += data.toString(); });
+
+    child.on('close', (code) => {
+      if (code === 0) resolve(stdout);
+      else reject(new Error(`Command '${command}' exited with code ${code}:\n${stderr || stdout}`));
+    });
+
+    child.on('error', (err) => {
+      reject(new Error(`Failed to start command '${command}': ${err.message}`));
+    });
+  });
+};
+
+const canRunCommand = (command, args = []) => {
+  const result = spawnSync(command, args, { stdio: 'ignore' });
+  return !result.error;
+};
+
+export const ensureCommandsAvailable = (checks) => {
+  const missing = checks.filter(({ command, args = [] }) => !canRunCommand(command, args));
+
+  if (missing.length === 0) {
+    return;
+  }
+
+  const formatted = missing
+    .map(({ label, command, installHint }) => {
+      const base = label || command;
+      return installHint ? `- ${base}: ${installHint}` : `- ${base}`;
+    })
+    .join('\n');
+
+  throw new Error(`Missing required local dependencies:\n${formatted}`);
+};
+
+const readLaravelToolsConfig = () => {
+  try {
+    return yaml.load(readFileSync('laravel-tools.yml', 'utf8')) || {};
+  } catch {
+    throw new Error(
+      'laravel-tools.yml not found. Create it in the project root with server configuration.\n' +
+        'Example:\n' +
+        '  staging:\n' +
+        '    host: 1.2.3.4\n' +
+        '    user: deployer\n' +
+        '  production:\n' +
+        '    host: 5.6.7.8\n' +
+        '    user: deployer\n'
+    );
+  }
+};
+
+// Reads the server IP for a given environment from laravel-tools.yml.
+// In trellis-tools this came from trellis/hosts/{env}.yml::ansible_host.
+// In laravel-tools it comes from laravel-tools.yml::{env}.host (set manually
+// for now; will be written automatically once the deploy tool is decided).
+export const getIp = (environment) => {
+  const config = readLaravelToolsConfig();
+  const host = config[environment]?.host;
+  if (!host) {
+    throw new Error(
+      `No host configured for '${environment}' in laravel-tools.yml`
+    );
+  }
+  return host;
+};
+
+// Reads the SSH user for a given environment from laravel-tools.yml.
+// trellis-tools hardcoded 'web' (a Trellis-provisioned user).
+// For Laravel this depends on how the server is provisioned (e.g. 'deployer').
+export const getSshUser = (environment) => {
+  const config = readLaravelToolsConfig();
+  const user = config[environment]?.user;
+  if (!user) {
+    throw new Error(
+      `No user configured for '${environment}' in laravel-tools.yml`
+    );
+  }
+  return user;
+};
+
+export const getServerPath = (environment) => {
+  const config = readLaravelToolsConfig();
+  const path = config[environment]?.path;
+  if (!path) {
+    throw new Error(
+      `No path configured for '${environment}' in laravel-tools.yml.\n` +
+        `Add it under the environment key, e.g.:\n` +
+        `  ${environment}:\n` +
+        `    path: /home/forge/your-site-domain.com`
+    );
+  }
+  return path;
+};
+
+// Reads APP_NAME from .env.example.
+// In trellis-tools this also fell back to wordpress_sites.yml — not needed for Laravel.
+export const getAppName = () => {
+  try {
+    const raw = readFileSync('.env.example');
+    const env = parse(raw);
+    if (!env.APP_NAME) throw new Error('APP_NAME not set');
+    return env.APP_NAME;
+  } catch {
+    throw new Error('Could not read APP_NAME from .env.example');
+  }
+};

package/src/utilities/dateUtils.js

@@ -0,0 +1,7 @@
+export const getCurrentDateString = () => {
+  const now = new Date();
+  const year = now.getFullYear();
+  const month = String(now.getMonth() + 1).padStart(2, '0');
+  const day = String(now.getDate()).padStart(2, '0');
+  return `${year}${month}${day}`;
+};

package/src/utilities/fileUtils.js

@@ -0,0 +1,36 @@
+import { readdirSync, statSync } from 'fs';
+import { join } from 'path';
+
+export const find10LatestFiles = (directory, envFilter = null, usernameFilter = null) => {
+  try {
+    const files = readdirSync(directory)
+      .filter((f) => f.endsWith('.sql'))
+      .filter((f) => !envFilter || f.includes(`_${envFilter}_`) || f.includes(`_${envFilter}.`))
+      .filter((f) => !usernameFilter || f.includes(`_${usernameFilter}.`))
+      .map((f) => {
+        const fullPath = join(directory, f);
+        const stats = statSync(fullPath);
+        const sizeMb = (stats.size / 1024 / 1024).toFixed(2);
+        const date = stats.mtime.toLocaleDateString('it-IT');
+        return {
+          name: f,
+          path: fullPath,
+          mtime: stats.mtime,
+          size: sizeMb,
+          display: `${f} (${sizeMb} MB — ${date})`,
+        };
+      })
+      .sort((a, b) => b.mtime - a.mtime)
+      .slice(0, 10);
+
+    return files;
+  } catch {
+    return [];
+  }
+};
+
+export const filterDatabaseFiles = (files, env, username = null) => {
+  return files
+    .filter((f) => f.name.includes(`_${env}_`) || f.name.includes(`_${env}.`))
+    .filter((f) => !username || f.name.includes(`_${username}.`));
+};

package/src/utilities/google-drive.js

@@ -0,0 +1,69 @@
+import { existsSync, readdirSync } from 'fs';
+import { homedir } from 'os';
+import { input } from '@inquirer/prompts';
+import keytar from 'keytar';
+
+const SERVICE_NAME = 'laravel-tools';
+const ACCOUNT_NAME = 'google-drive-directory';
+
+// Attempts to locate the Google Drive shared drives directory automatically.
+// Google Drive for Desktop (macOS) mounts under ~/Library/CloudStorage/GoogleDrive-{email}/.
+// Checks for both Italian ('Drive condivisi') and English ('Shared drives') folder names.
+const findGoogleDriveDirectory = () => {
+  const home = homedir();
+
+  // Google Drive for Desktop (current)
+  const cloudStorage = `${home}/Library/CloudStorage`;
+  if (existsSync(cloudStorage)) {
+    try {
+      const entries = readdirSync(cloudStorage);
+      const gdEntry = entries.find((e) => e.startsWith('GoogleDrive-'));
+      if (gdEntry) {
+        const base = `${cloudStorage}/${gdEntry}`;
+        for (const name of ['Drive condivisi', 'Drive Condivisi', 'Shared drives']) {
+          const candidate = `${base}/${name}`;
+          if (existsSync(candidate)) return candidate;
+        }
+      }
+    } catch {
+      // If we can't read the directory, fall through to legacy paths
+    }
+  }
+
+  // Legacy Google Drive paths
+  for (const candidate of [
+    `${home}/Google Drive/Drive condivisi`,
+    `${home}/Google Drive/Shared drives`,
+    `${home}/Drive Condivisi`,
+  ]) {
+    if (existsSync(candidate)) return candidate;
+  }
+
+  return null;
+};
+
+// Returns the Google Drive shared drives base path.
+// Checks OS keyring first, then tries to find automatically, then asks the user.
+// Path is saved to the OS keyring so subsequent calls don't prompt again.
+export const getGoogleDriveDirectory = async () => {
+  const stored = await keytar.getPassword(SERVICE_NAME, ACCOUNT_NAME);
+  if (stored && existsSync(stored)) return stored;
+
+  const found = findGoogleDriveDirectory();
+  if (found) {
+    await keytar.setPassword(SERVICE_NAME, ACCOUNT_NAME, found);
+    return found;
+  }
+
+  console.log('⚠️  Impossibile trovare la cartella di Google Drive automaticamente.');
+  const path = await input({
+    message: 'Inserisci il percorso della cartella Drive Condivisi: ',
+  });
+
+  if (!existsSync(path)) {
+    throw new Error(`❌ Directory non trovata: ${path}`);
+  }
+
+  await keytar.setPassword(SERVICE_NAME, ACCOUNT_NAME, path);
+  return path;
+};

package/src/utilities/pathUtils.js

@@ -0,0 +1,15 @@
+import { mkdirSync, existsSync } from 'fs';
+import { getGoogleDriveDirectory } from './google-drive.js';
+
+
+export const ensureDirectoryExists = (dirPath) => {
+  if (!existsSync(dirPath)) {
+    mkdirSync(dirPath, { recursive: true });
+  }
+};
+
+export const resolveDatabasePath = async (appname, customPath = null) => {
+  if (customPath) return customPath;
+  const baseDir = await getGoogleDriveDirectory();
+  return `${baseDir}/Tech/DumpsDB/${appname}`;
+};

package/src/utilities/userInput.js

@@ -0,0 +1,28 @@
+import { confirm } from '@inquirer/prompts';
+
+export const askYesNo = async (message) => {
+  return await confirm({ message });
+};
+
+// Standard database filename conventions — mirrors trellis-tools exactly.
+// AMS mode:  {app}_ams{YEAR}_{env}.sql
+// Standard:  {app}_{env}_{YYYYMMDD}[_{username}].sql
+// Custom:    {customName}.sql
+export const generateDatabaseFilename = (
+  appname,
+  env,
+  date,
+  customName = null,
+  amsMode = false,
+  username = null
+) => {
+  if (amsMode) {
+    const year = new Date().getFullYear();
+    return `${appname}_ams${year}_${env}.sql`;
+  }
+  if (customName) {
+    return customName.endsWith('.sql') ? customName : `${customName}.sql`;
+  }
+  const base = `${appname}_${env}_${date}`;
+  return username ? `${base}_${username}.sql` : `${base}.sql`;
+};