@leadcms/sdk 1.2.85-pre

package/dist/templates/docker/preview/Dockerfile

@@ -0,0 +1,75 @@
+# LeadCMS Live Preview Dockerfile
+# Multi-service container for development/preview with live updates
+# Includes nginx reverse proxy, development server, and LeadCMS SSE watcher
+# Works with any static site generator that supports live preview
+#
+# Requirements for your project:
+# - npm run livepreview: Start development server on port 3000
+# - LeadCMS SDK scripts available
+#
+# Usage from project root:
+# docker build -f preview/Dockerfile -t my-leadcms-site-preview .
+# docker run -p 80:80 -e LEADCMS_URL=... -e LEADCMS_API_KEY=... my-leadcms-site-preview
+
+FROM node:20-alpine
+
+# Install nginx and supervisor for multi-service management
+RUN apk add --no-cache nginx supervisor wget
+
+# Create required directories
+RUN mkdir -p /var/log/supervisor /run/nginx
+
+# Set working directory
+WORKDIR /app
+
+# Copy package files first for better Docker layer caching
+COPY package*.json ./
+
+# Build arguments for LeadCMS configuration
+ARG LEADCMS_URL
+ARG LEADCMS_API_KEY
+ARG LEADCMS_DEFAULT_LANGUAGE=en
+
+# Export build args as environment variables
+ENV LEADCMS_URL=$LEADCMS_URL
+ENV LEADCMS_API_KEY=$LEADCMS_API_KEY
+ENV LEADCMS_DEFAULT_LANGUAGE=$LEADCMS_DEFAULT_LANGUAGE
+
+# Support Next.js environment variables for backward compatibility
+ENV NEXT_PUBLIC_LEADCMS_URL=$LEADCMS_URL
+ENV NEXT_PUBLIC_LEADCMS_DEFAULT_LANGUAGE=$LEADCMS_DEFAULT_LANGUAGE
+
+# Install dependencies
+RUN npm ci --verbose
+
+# Copy application code
+COPY . .
+
+# Copy nginx configuration for development proxy
+COPY preview/nginx.conf /etc/nginx/nginx.conf
+
+# Copy supervisor configuration for multi-service management
+COPY preview/supervisord.conf /etc/supervisor/conf.d/supervisord.conf
+
+# Create startup script
+RUN echo '#!/bin/sh' > /start.sh && \
+    echo '# Fetch initial LeadCMS content if configuration is available' >> /start.sh && \
+    echo 'if [ ! -z "$LEADCMS_URL" ] && [ ! -z "$LEADCMS_API_KEY" ]; then' >> /start.sh && \
+    echo '  echo "Fetching initial LeadCMS content..."' >> /start.sh && \
+    echo '  npx leadcms fetch || echo "Warning: Could not fetch initial content"' >> /start.sh && \
+    echo 'fi' >> /start.sh && \
+    echo '' >> /start.sh && \
+    echo '# Start supervisor to manage all services' >> /start.sh && \
+    echo 'exec /usr/bin/supervisord -c /etc/supervisor/conf.d/supervisord.conf' >> /start.sh
+
+RUN chmod +x /start.sh
+
+# Expose port 80 (nginx will proxy to development server on port 3000)
+EXPOSE 80
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=30s --retries=3 \
+    CMD wget --spider -q http://localhost:80 || exit 1
+
+# Start all services via supervisor
+CMD ["/start.sh"]

package/dist/templates/docker/preview/nginx.conf

@@ -0,0 +1,128 @@
+# LeadCMS Live Preview nginx Configuration
+# Reverse proxy configuration for development/preview mode
+# Proxies requests to development server with WebSocket support for live reload
+
+user nginx;
+worker_processes auto;
+error_log /var/log/nginx/error.log notice;
+pid /var/run/nginx.pid;
+
+events {
+    worker_connections 1024;
+}
+
+http {
+    include /etc/nginx/mime.types;
+    default_type application/octet-stream;
+
+    log_format main '$remote_addr - $remote_user [$time_local] "$request" '
+                    '$status $body_bytes_sent "$http_referer" '
+                    '"$http_user_agent" "$http_x_forwarded_for"';
+
+    access_log /var/log/nginx/access.log main;
+
+    sendfile on;
+    tcp_nopush on;
+    keepalive_timeout 65;
+    types_hash_max_size 2048;
+
+    # WebSocket upgrade support for live reload functionality
+    map $http_upgrade $connection_upgrade {
+        default upgrade;
+        '' close;
+    }
+
+    server {
+        listen 80;
+        server_name _;
+
+        # Main application proxy with WebSocket support
+        location / {
+            proxy_pass http://localhost:3000;
+            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-Host $server_name;
+            proxy_set_header X-Forwarded-Proto $scheme;
+
+            # WebSocket support for live reload (framework-agnostic)
+            proxy_http_version 1.1;
+            proxy_set_header Upgrade $http_upgrade;
+            proxy_set_header Connection $connection_upgrade;
+            proxy_cache_bypass $http_upgrade;
+
+            # Timeout and connection settings
+            proxy_connect_timeout 5s;
+            proxy_read_timeout 60s;
+            proxy_send_timeout 60s;
+
+            # DNS resolver for Docker networking
+            resolver 127.0.0.11 8.8.8.8 1.1.1.1 valid=10s;
+            resolver_timeout 5s;
+
+            # CORS headers for development
+            add_header 'Access-Control-Allow-Origin' '*' always;
+            add_header 'Access-Control-Allow-Methods' 'GET, OPTIONS, PATCH, DELETE, POST, PUT' always;
+            add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization' always;
+            add_header 'Access-Control-Allow-Credentials' 'true' always;
+
+            # Handle CORS preflight requests
+            if ($request_method = 'OPTIONS') {
+                add_header 'Access-Control-Allow-Origin' '*';
+                add_header 'Access-Control-Allow-Methods' 'GET, OPTIONS, PATCH, DELETE, POST, PUT';
+                add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization';
+                add_header 'Access-Control-Allow-Credentials' 'true';
+                return 204;
+            }
+        }
+
+        # Hot reload endpoints (framework-specific paths)
+        # Next.js hot reload
+        location /_next/webpack-hmr {
+            proxy_pass http://localhost:3000;
+            proxy_redirect off;
+            proxy_http_version 1.1;
+            proxy_set_header Upgrade $http_upgrade;
+            proxy_set_header Connection "upgrade";
+            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-Host $server_name;
+            proxy_set_header X-Forwarded-Proto $scheme;
+            proxy_cache_bypass $http_upgrade;
+
+            # Extended timeouts for WebSocket connections
+            proxy_connect_timeout 3s;
+            proxy_read_timeout 120s;
+            proxy_send_timeout 120s;
+            resolver 127.0.0.11 8.8.8.8 1.1.1.1 valid=10s;
+            resolver_timeout 5s;
+
+            # Disable buffering for real-time updates
+            proxy_buffering off;
+            proxy_cache off;
+        }
+
+        # Astro/Vite dev server WebSocket
+        location /vite-dev-ping {
+            proxy_pass http://localhost:3000;
+            proxy_http_version 1.1;
+            proxy_set_header Upgrade $http_upgrade;
+            proxy_set_header Connection $connection_upgrade;
+            proxy_set_header Host $host;
+            proxy_cache_bypass $http_upgrade;
+            proxy_buffering off;
+        }
+
+        # Generic WebSocket support for other frameworks
+        location ~* \.(ws|socket)$ {
+            proxy_pass http://localhost:3000;
+            proxy_http_version 1.1;
+            proxy_set_header Upgrade $http_upgrade;
+            proxy_set_header Connection $connection_upgrade;
+            proxy_set_header Host $host;
+            proxy_cache_bypass $http_upgrade;
+            proxy_buffering off;
+        }
+    }
+}

package/dist/templates/docker/preview/supervisord.conf

@@ -0,0 +1,63 @@
+# LeadCMS Live Preview Supervisor Configuration
+# Manages multiple services in a single container:
+# - nginx: Reverse proxy on port 80
+# - livepreview: Development server on port 3000 (framework-agnostic)
+# - sse-watcher: LeadCMS live content updates
+
+[supervisord]
+nodaemon=true
+loglevel=info
+logfile=/dev/stdout
+logfile_maxbytes=0
+pidfile=/var/run/supervisord.pid
+silent=false
+
+[program:nginx]
+command=nginx -g "daemon off;"
+stdout_logfile=/dev/stdout
+stdout_logfile_maxbytes=0
+stderr_logfile=/dev/stderr
+stderr_logfile_maxbytes=0
+stdout_events_enabled=true
+stderr_events_enabled=true
+autorestart=true
+redirect_stderr=false
+priority=100
+
+[program:livepreview]
+# Framework-agnostic development server command
+# Your project should implement: npm run livepreview
+# Examples:
+# - Next.js: "next dev"
+# - Astro: "astro dev"
+# - Gatsby: "gatsby develop"
+# - Nuxt: "nuxt dev"
+command=npm run livepreview
+directory=/app
+stdout_logfile=/dev/stdout
+stdout_logfile_maxbytes=0
+stderr_logfile=/dev/stderr
+stderr_logfile_maxbytes=0
+stdout_events_enabled=true
+stderr_events_enabled=true
+autorestart=true
+redirect_stderr=false
+environment=NODE_ENV=development
+priority=200
+
+[program:sse-watcher]
+# LeadCMS SSE watcher for live content updates
+command=npx leadcms watch
+directory=/app
+stdout_logfile=/dev/stdout
+stdout_logfile_maxbytes=0
+stderr_logfile=/dev/stderr
+stderr_logfile_maxbytes=0
+stdout_events_enabled=true
+stderr_events_enabled=true
+autorestart=true
+redirect_stderr=false
+environment=NODE_ENV=development
+priority=300
+# Only start if LeadCMS configuration is available
+startsecs=10

package/dist/templates/scripts/inject-runtime-env.sh

@@ -0,0 +1,33 @@
+#!/bin/sh
+# This script updates public/__env.js with current NEXT_PUBLIC_ env vars at container startup
+set -e
+
+ENV_JS_PATH="/usr/share/nginx/html/__env.js"
+
+if [ ! -f "$ENV_JS_PATH" ]; then
+  echo "__env.js not found at $ENV_JS_PATH, skipping runtime env injection."
+  exit 0
+fi
+
+echo "Updating $ENV_JS_PATH with current NEXT_PUBLIC_ env vars..."
+
+# Find all env vars starting with NEXT_PUBLIC_ and output only defined ones
+JS="window.__env = {"
+FIRST=1
+while IFS='=' read -r KEY VAL; do
+  if [[ $KEY == NEXT_PUBLIC_* ]]; then
+    # Strip leading/trailing quotes if present
+    STRIPPED_VAL=$(printf '%s' "$VAL" | sed 's/^"//;s/"$//')
+    # Escape backslashes and double quotes for JS string
+    ESCAPED_VAL=$(printf '%s' "$STRIPPED_VAL" | sed 's/\\/\\\\/g; s/"/\\"/g')
+    if [ $FIRST -eq 0 ]; then
+      JS="$JS,"
+    fi
+    JS="$JS \"$KEY\": \"$ESCAPED_VAL\""
+    FIRST=0
+  fi
+done < <(env)
+JS="$JS};"
+
+echo "$JS" > "$ENV_JS_PATH"
+echo "Injected runtime envs into $ENV_JS_PATH."

package/leadcms.config.json.sample

@@ -0,0 +1,8 @@
+{
+  "url": "https://your-leadcms-instance.com",
+  "apiKey": "your-api-key-here",
+  "defaultLanguage": "en",
+  "contentDir": ".leadcms/content",
+  "mediaDir": "public/media",
+  "enableDrafts": false
+}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@leadcms/sdk",
+  "version": "1.2.85-pre",
+  "description": "Official SDK and CLI tools for LeadCMS - framework-agnostic content management",
+  "main": "dist/lib/cms.js",
+  "types": "dist/lib/cms.d.ts",
+  "bin": {
+    "leadcms": "dist/cli/index.js"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=8.0.0"
+  },
+  "scripts": {
+    "build": "npm run clean && tsc && npm run copy-assets && npm run fix-permissions",
+    "clean": "rm -rf dist",
+    "copy-assets": "cp -r src/scripts dist/ && cp -r src/templates dist/",
+    "fix-permissions": "chmod +x dist/cli/index.js && chmod +x dist/scripts/*.sh 2>/dev/null || true",
+    "dev": "npm run build && concurrently \"tsc --watch\" \"npm run watch-assets\"",
+    "watch-assets": "nodemon --watch src/scripts --watch src/templates --ext '*' --exec 'npm run copy-assets'",
+    "test": "npm run build && node dist/cli/index.js --help > /dev/null && echo '✅ CLI tests passed'",
+    "prepublishOnly": "npm run build",
+    "leadcms:fetch": "node src/scripts/fetch-leadcms-content.mjs",
+    "leadcms:watch": "node src/scripts/sse-watcher.mjs",
+    "leadcms:generate-env": "node src/scripts/generate-env-js.mjs"
+  },
+  "dependencies": {
+    "axios": "^1.0.0",
+    "dotenv": "^16.0.0",
+    "eventsource": "^2.0.0",
+    "gray-matter": "^4.0.3",
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/eventsource": "^1.1.15",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.0.0",
+    "concurrently": "^9.2.1",
+    "nodemon": "^3.1.10",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "leadcms.config.json.sample"
+  ],
+  "keywords": [
+    "leadcms",
+    "cms",
+    "headless-cms",
+    "sdk",
+    "typescript",
+    "content-management",
+    "mdx",
+    "markdown",
+    "json",
+    "i18n",
+    "localization",
+    "static-content",
+    "framework-agnostic"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LeadCMS/leadcms.sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/LeadCMS/leadcms.sdk/issues"
+  },
+  "homepage": "https://github.com/LeadCMS/leadcms.sdk#readme",
+  "author": "LeadCMS Team",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}