create-nexwire 4.0.0

package/express/src/framework/maker-cli/stubs/deploy/server/compose/redis.stub

@@ -0,0 +1,131 @@
+services:
+  nginx-proxy:
+    image: jwilder/nginx-proxy
+    container_name: nginx-proxy
+    restart: unless-stopped
+    ports:
+      - "${PROXY_HTTP_PORT:-80}:80"
+      - "${PROXY_HTTPS_PORT:-443}:443"
+    volumes:
+      - /var/run/docker.sock:/tmp/docker.sock:ro
+      - ./certs:/etc/nginx/certs
+      - ./nginx-vhost:/etc/nginx/vhost.d
+      - ./html:/usr/share/nginx/html
+    labels:
+      com.github.nginx-proxy.nginx: "true"
+    networks:
+      - nginx-proxy
+
+  letsencrypt:
+    image: jrcs/letsencrypt-nginx-proxy-companion
+    container_name: nginx-letsencrypt
+    restart: unless-stopped
+    depends_on:
+      - nginx-proxy
+    environment:
+      NGINX_PROXY_CONTAINER: nginx-proxy
+      DEFAULT_EMAIL: ${LETSENCRYPT_EMAIL}
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock:ro
+      - ./certs:/etc/nginx/certs
+      - ./nginx-vhost:/etc/nginx/vhost.d
+      - ./html:/usr/share/nginx/html
+      - ./acme:/etc/acme.sh
+    networks:
+      - nginx-proxy
+
+  mysql:
+    image: mysql:8.4
+    container_name: mysql-global
+    restart: unless-stopped
+    environment:
+      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
+      MYSQL_DATABASE: ${MYSQL_DATABASE}
+    volumes:
+      - mysql_global_data:/var/lib/mysql
+    ports:
+      - "${MYSQL_PORT:-4000}:3306"
+    networks:
+      - infra
+
+  postgres:
+    image: postgres:16-alpine
+    container_name: postgres-global
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+      POSTGRES_DB: ${POSTGRES_DB}
+    volumes:
+      - postgres_global_data:/var/lib/postgresql/data
+    ports:
+      - "${POSTGRES_PORT:-4001}:5432"
+    networks:
+      - infra
+
+  redis:
+    image: redis:7-alpine
+    container_name: redis-global
+    restart: unless-stopped
+    volumes:
+      - redis_global_data:/data
+    command: ["redis-server", "--appendonly", "yes", "--maxmemory", "512mb", "--maxmemory-policy", "noeviction"]
+    networks:
+      - infra
+
+  phpmyadmin:
+    image: phpmyadmin:5-apache
+    container_name: phpmyadmin
+    restart: unless-stopped
+    environment:
+      PMA_HOST: mysql-global
+      PMA_PORT: 3306
+      PMA_ARBITRARY: 1
+      VIRTUAL_HOST: ${PHPMYADMIN_DOMAIN}
+      VIRTUAL_PORT: 80
+      LETSENCRYPT_HOST: ${PHPMYADMIN_DOMAIN}
+      LETSENCRYPT_EMAIL: ${LETSENCRYPT_EMAIL}
+    ports:
+      - "${PHPMYADMIN_LOCAL_PORT:-127.0.0.1:8082}:80"
+    networks:
+      - infra
+      - nginx-proxy
+
+  pgadmin:
+    image: dpage/pgadmin4:latest
+    container_name: pgadmin
+    restart: unless-stopped
+    depends_on:
+      - postgres
+    environment:
+      PGADMIN_DEFAULT_EMAIL: ${PGADMIN_DEFAULT_EMAIL}
+      PGADMIN_DEFAULT_PASSWORD: ${PGADMIN_DEFAULT_PASSWORD}
+      PGADMIN_CONFIG_SERVER_MODE: "True"
+      PGADMIN_SERVER_JSON_FILE: /pgadmin4/servers.json
+      VIRTUAL_HOST: ${PGADMIN_DOMAIN}
+      VIRTUAL_PORT: 80
+      LETSENCRYPT_HOST: ${PGADMIN_DOMAIN}
+      LETSENCRYPT_EMAIL: ${LETSENCRYPT_EMAIL}
+    volumes:
+      - pgadmin_data:/var/lib/pgadmin
+      - ./pgadmin/servers.json:/pgadmin4/servers.json:ro
+    ports:
+      - "${PGADMIN_LOCAL_PORT:-127.0.0.1:8083}:80"
+    networks:
+      - infra
+      - nginx-proxy
+
+volumes:
+  mysql_global_data:
+  postgres_global_data:
+  redis_global_data:
+  pgadmin_data:
+
+networks:
+  nginx-proxy:
+    external: true
+    name: nginx-proxy
+  infra:
+    external: true
+    name: infra
+

package/express/src/framework/maker-cli/stubs/deploy/server/env/local.example.stub

@@ -0,0 +1,11 @@
+# Local-only overrides for Docker Desktop
+# This file is applied together with deploy/server/.env and should not be used on remote.
+PROXY_HTTP_PORT=8081
+PROXY_HTTPS_PORT=8443
+PHPMYADMIN_DOMAIN=pma.localhost
+PGADMIN_DOMAIN=pga.localhost
+
+# Optional local DB name override (takes precedence over deploy/server/.env)
+# MYSQL_DATABASE=nexwire
+# POSTGRES_DB=nexwire
+

package/express/src/framework/maker-cli/stubs/deploy/server/env/noredis.stub

@@ -0,0 +1,25 @@
+# Server infra env template (base values)
+# Remote: copy to deploy/server/.env and use as-is
+# Local: copy to deploy/server/.env then override in deploy/server/.env.local
+LETSENCRYPT_EMAIL=ops@example.com
+PROXY_HTTP_PORT=80
+PROXY_HTTPS_PORT=443
+
+MYSQL_ROOT_PASSWORD=change-me-root
+MYSQL_DATABASE=nexwire
+MYSQL_PORT=4000
+
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=change-me-postgres
+POSTGRES_DB=postgres
+POSTGRES_PORT=4001
+
+REDIS=false
+
+PHPMYADMIN_DOMAIN=pma.example.com
+PGADMIN_DOMAIN=pga.example.com
+PGADMIN_DEFAULT_EMAIL=admin@example.com
+PGADMIN_DEFAULT_PASSWORD=admin123
+PHPMYADMIN_LOCAL_PORT=127.0.0.1:8082
+PGADMIN_LOCAL_PORT=127.0.0.1:8083
+

package/express/src/framework/maker-cli/stubs/deploy/server/env/redis.stub

@@ -0,0 +1,25 @@
+# Server infra env template (base values)
+# Remote: copy to deploy/server/.env and use as-is
+# Local: copy to deploy/server/.env then override in deploy/server/.env.local
+LETSENCRYPT_EMAIL=ops@example.com
+PROXY_HTTP_PORT=80
+PROXY_HTTPS_PORT=443
+
+MYSQL_ROOT_PASSWORD=change-me-root
+MYSQL_DATABASE=nexwire
+MYSQL_PORT=4000
+
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=change-me-postgres
+POSTGRES_DB=postgres
+POSTGRES_PORT=4001
+
+REDIS=true
+
+PHPMYADMIN_DOMAIN=pma.example.com
+PGADMIN_DOMAIN=pga.example.com
+PGADMIN_DEFAULT_EMAIL=admin@example.com
+PGADMIN_DEFAULT_PASSWORD=admin123
+PHPMYADMIN_LOCAL_PORT=127.0.0.1:8082
+PGADMIN_LOCAL_PORT=127.0.0.1:8083
+

package/express/src/framework/maker-cli/stubs/deploy/server/nginx-vhost/README.stub

@@ -0,0 +1,16 @@
+# nginx-vhost overrides
+
+This folder holds per-domain nginx overrides for `jwilder/nginx-proxy`.
+
+## Usage
+
+1. Copy `app.example.com` to your real app domain file name.
+2. Edit rules as needed (timeouts, upload limits, auth for `/board`, etc).
+3. Recreate or reload proxy container if needed.
+
+Example:
+
+```bash
+cp deploy/server/nginx-vhost/app.example.com deploy/server/nginx-vhost/api.yourdomain.com
+```
+

package/express/src/framework/maker-cli/stubs/deploy/server/nginx-vhost/app.example.com.stub

@@ -0,0 +1,13 @@
+# Custom nginx vhost overrides for app.example.com
+# File name should match your APP_DOMAIN exactly.
+
+client_max_body_size 50m;
+proxy_read_timeout 300;
+proxy_send_timeout 300;
+
+# Protect Queue Dashboard in production
+location /board {
+    auth_basic "Restricted";
+    auth_basic_user_file /etc/nginx/vhost.d/.htpasswd;
+}
+

package/express/src/framework/maker-cli/stubs/deploy/server/pgadmin/servers.stub

@@ -0,0 +1,14 @@
+{
+  "Servers": {
+    "1": {
+      "Name": "postgres-global",
+      "Group": "Servers",
+      "Host": "postgres-global",
+      "Port": 5432,
+      "MaintenanceDB": "postgres",
+      "Username": "postgres",
+      "SSLMode": "prefer"
+    }
+  }
+}
+

package/express/src/framework/maker-cli/stubs/deploy/server/redis/redis.conf.stub

@@ -0,0 +1,7 @@
+appendonly yes
+maxmemory 512mb
+maxmemory-policy noeviction
+save 900 1
+save 300 10
+save 60 10000
+

package/express/src/framework/maker-cli/stubs/deploy/supervisor/noredis.stub

@@ -0,0 +1,54 @@
+[supervisord]
+nodaemon=true
+user=root
+logfile=/dev/null
+logfile_maxbytes=0
+pidfile=/var/run/supervisord.pid
+loglevel=info
+
+[program:migrate]
+command=/bin/sh -lc "/bin/sh /app/deploy/scripts/auto-migrate.sh {{RUNTIME_EXEC}}"
+directory=/app
+autostart=true
+autorestart=false
+priority=5
+startsecs=0
+startretries=1
+exitcodes=0
+stdout_logfile=/dev/stdout
+stderr_logfile=/dev/stderr
+stdout_logfile_maxbytes=0
+stderr_logfile_maxbytes=0
+
+[program:api]
+command=/bin/sh -lc "{{RUNTIME_EXEC}} src/framework/maker-cli/index.mjs serve --prod --runtime={{RUNTIME_NAME}}"
+directory=/app
+autostart=true
+autorestart=true
+priority=20
+startsecs=3
+startretries=5
+stopsignal=TERM
+stopwaitsecs=20
+redirect_stderr=true
+stdout_logfile=/dev/stdout
+stdout_logfile_maxbytes=0
+stopasgroup=true
+killasgroup=true
+
+[program:scheduler]
+command=/bin/sh -lc "{{RUNTIME_EXEC}} src/framework/maker-cli/index.mjs schedule:work --prod --runtime={{RUNTIME_NAME}}"
+directory=/app
+autostart=true
+autorestart=true
+priority=40
+startsecs=3
+startretries=5
+stopsignal=TERM
+stopwaitsecs=20
+redirect_stderr=true
+stdout_logfile=/dev/stdout
+stdout_logfile_maxbytes=0
+stopasgroup=true
+killasgroup=true
+

package/express/src/framework/maker-cli/stubs/deploy/supervisor/redis.stub

@@ -0,0 +1,70 @@
+[supervisord]
+nodaemon=true
+user=root
+logfile=/dev/null
+logfile_maxbytes=0
+pidfile=/var/run/supervisord.pid
+loglevel=info
+
+[program:migrate]
+command=/bin/sh -lc "/bin/sh /app/deploy/scripts/auto-migrate.sh {{RUNTIME_EXEC}}"
+directory=/app
+autostart=true
+autorestart=false
+priority=5
+startsecs=0
+startretries=1
+exitcodes=0
+stdout_logfile=/dev/stdout
+stderr_logfile=/dev/stderr
+stdout_logfile_maxbytes=0
+stderr_logfile_maxbytes=0
+
+[program:api]
+command=/bin/sh -lc "{{RUNTIME_EXEC}} src/framework/maker-cli/index.mjs serve --prod --runtime={{RUNTIME_NAME}}"
+directory=/app
+autostart=true
+autorestart=true
+priority=20
+startsecs=3
+startretries=5
+stopsignal=TERM
+stopwaitsecs=20
+redirect_stderr=true
+stdout_logfile=/dev/stdout
+stdout_logfile_maxbytes=0
+stopasgroup=true
+killasgroup=true
+
+[program:queue]
+command=/bin/sh -lc "{{RUNTIME_EXEC}} src/framework/maker-cli/index.mjs queue:work --queue=default,mail,maintenance --prod --runtime={{RUNTIME_NAME}}"
+directory=/app
+autostart=true
+autorestart=true
+priority=30
+startsecs=3
+startretries=5
+stopsignal=TERM
+stopwaitsecs=20
+redirect_stderr=true
+stdout_logfile=/dev/stdout
+stdout_logfile_maxbytes=0
+stopasgroup=true
+killasgroup=true
+
+[program:scheduler]
+command=/bin/sh -lc "{{RUNTIME_EXEC}} src/framework/maker-cli/index.mjs schedule:work --prod --runtime={{RUNTIME_NAME}}"
+directory=/app
+autostart=true
+autorestart=true
+priority=40
+startsecs=3
+startretries=5
+stopsignal=TERM
+stopwaitsecs=20
+redirect_stderr=true
+stdout_logfile=/dev/stdout
+stdout_logfile_maxbytes=0
+stopasgroup=true
+killasgroup=true
+

package/express/src/framework/maker-cli/stubs/deploy/workflow/local.json.stub

@@ -0,0 +1,25 @@
+{
+  "steps": [
+    {
+      "name": "Generate deploy files",
+      "run": "deploy:init --force",
+      "enabled": false
+    },
+    {
+      "name": "Start shared infra",
+      "run": "deploy:workflow --server-only",
+      "enabled": true
+    },
+    {
+      "name": "Import database dump (optional)",
+      "run": "deploy:db:import --file=deploy/nexwire.sql --database=nexwire",
+      "enabled": false
+    },
+    {
+      "name": "Start app stack",
+      "run": "deploy:workflow --app-only",
+      "enabled": true
+    }
+  ]
+}
+

package/express/src/framework/maker-cli/stubs/deploy/workflow/remote.json.stub

@@ -0,0 +1,24 @@
+{
+  "remote": {
+    "host": "127.0.0.1",
+    "user": "deploy",
+    "port": 22,
+    "keyPath": "~/.ssh/id_rsa",
+    "targetPath": "/home/deploy/nexwire"
+  },
+  "upload": {
+    "source": ".",
+    "targetSubPath": "."
+  },
+  "databaseImport": {
+    "enabled": false,
+    "file": "deploy/nexwire.sql",
+    "database": "nexwire",
+    "container": "mysql-global",
+    "user": "root"
+  },
+  "preDeployCommands": [
+    "docker rm -f old-app 2>/dev/null || true"
+  ]
+}
+

package/express/src/framework/maker-cli/stubs/example/console.ts.stub

@@ -0,0 +1,34 @@
+import { defineSchedule, dispatchEvent } from "@/framework/facade.js";
+
+/**
+ * name: Unique schedule id used as the distributed lock key.
+ * expression: Cron expression that controls when the task runs.
+ * timezone: IANA timezone for cron evaluation (example: "UTC").
+ * runOnInit: Runs once immediately when scheduler starts.
+ * enabled: Enables or disables this schedule without deleting code.
+ * ttlMs: Lock TTL in milliseconds to avoid duplicate execution.
+ */
+defineSchedule({
+  name: "{{module}}:scheduler-tick",
+  expression: "*/30 * * * * *",
+  // timezone: "UTC",
+  runOnInit: true,
+  // enabled: true,
+  // ttlMs: 120000,
+  handler: async () => {
+    /**
+     * dispatchEvent name: Event id to publish to listeners.
+     * payload: Data sent to queue/broadcast consumers.
+     * queue: Optional queue target for async event consumers.
+     * broadcast: Optional realtime fanout (all/users/roles/rooms).
+     */
+    await dispatchEvent("{{module}}.scheduler.tick", {
+      origin: "scheduler",
+      createdAt: new Date().toISOString()
+    }, {
+      queue: "default",
+      broadcast: { all: true }
+    });
+  }
+});
+