@factiii/stack 0.1.2

package/dist/utils/template-generator.js

@@ -0,0 +1,223 @@
+"use strict";
+/**
+ * Template Generator
+ *
+ * Generates template files for environment configuration.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateEnvExampleTemplate = generateEnvExampleTemplate;
+exports.generateEnvTemplate = generateEnvTemplate;
+exports.createEnvTemplates = createEnvTemplates;
+exports.generateSecretsChecklist = generateSecretsChecklist;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const env_validator_js_1 = require("./env-validator.js");
+/**
+ * Generate .env.example template file content
+ * @param config - Parsed factiii.yml configuration
+ */
+function generateEnvExampleTemplate(config) {
+    const repoName = config.name ?? 'myapp';
+    const template = `# .env.example - Environment variable template
+# This file defines all required environment variables across environments.
+# Values are descriptive examples - replace with real values in .env.staging and .env.prod
+# This file is committed to git as a template.
+
+# === Application Settings ===
+NODE_ENV=development
+PORT=3000
+
+# === Database ===
+# PostgreSQL connection string format
+DATABASE_URL=postgresql://EXAMPLE-user:EXAMPLE-password@localhost:5432/EXAMPLE-${repoName}-dev
+
+# === Authentication ===
+# 256-bit secret key for JWT signing
+JWT_SECRET=EXAMPLE-your-256-bit-secret-key-here
+JWT_EXPIRES_IN=7d
+
+# === External APIs (if needed) ===
+# OPENAI_API_KEY=EXAMPLE-sk-proj-abc123xyz789
+# STRIPE_SECRET_KEY=EXAMPLE-sk_test_51ABC123xyz
+# STRIPE_PUBLISHABLE_KEY=EXAMPLE-pk_test_51ABC123xyz
+
+# === AWS Configuration (if using S3, SES, etc) ===
+# AWS_ACCESS_KEY_ID=EXAMPLE-AKIAIOSFODNN7EXAMPLE
+# AWS_SECRET_ACCESS_KEY=EXAMPLE-wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
+# AWS_REGION=EXAMPLE-us-east-1
+# AWS_BUCKET_NAME=EXAMPLE-${repoName}-assets
+
+# === Email Configuration (if using SMTP) ===
+# SMTP_HOST=EXAMPLE-smtp.gmail.com
+# SMTP_PORT=587
+# SMTP_USER=EXAMPLE-noreply@yourdomain.com
+# SMTP_PASSWORD=EXAMPLE-your-app-password
+
+# === Application URLs ===
+# FRONTEND_URL=EXAMPLE-http://localhost:3000
+# API_URL=EXAMPLE-http://localhost:3001
+
+# === Application-specific settings ===
+# Add your custom environment variables below
+`;
+    return template;
+}
+/**
+ * Generate .env template file content for staging/prod
+ * Copies structure from .env.example with placeholder values
+ * @param environment - 'staging' or 'prod'
+ * @param devEnv - Parsed .env.example key-value pairs
+ */
+function generateEnvTemplate(environment, devEnv) {
+    const envUpper = environment.toUpperCase();
+    let template = `# .env.${environment} - ${envUpper} environment variables
+# Fill in all values below. Keys must match .env.example
+# This file should ${environment === 'prod' ? 'ALWAYS' : 'optionally'} be in .gitignore
+
+`;
+    // Copy keys from .env.example with placeholder values
+    for (const key of Object.keys(devEnv)) {
+        const devValue = devEnv[key];
+        // If dev value is not an example, use it as a guide
+        if (devValue && !devValue.includes('EXAMPLE')) {
+            template += `${key}=${devValue}\n`;
+        }
+        else {
+            // Use placeholder
+            template += `${key}=<FILL_IN>\n`;
+        }
+    }
+    template += `
+# Instructions:
+# 1. Replace all <FILL_IN> values with real ${environment} values
+# 2. Ensure all keys match .env.example
+# 3. Run: npx factiii (to validate)
+`;
+    return template;
+}
+/**
+ * Create .env template files if they don't exist
+ * @param rootDir - Repository root directory
+ * @param config - Parsed factiii.yml configuration
+ */
+function createEnvTemplates(rootDir, config) {
+    const result = {
+        created: [],
+        skipped: [],
+        errors: [],
+    };
+    // Create .env.example first (template)
+    const devPath = path.join(rootDir, '.env.example');
+    try {
+        if (fs.existsSync(devPath)) {
+            result.skipped.push('.env.example');
+        }
+        else {
+            const devTemplate = generateEnvExampleTemplate(config);
+            fs.writeFileSync(devPath, devTemplate, 'utf8');
+            result.created.push('.env.example');
+        }
+    }
+    catch (error) {
+        result.errors.push({
+            file: '.env.example',
+            error: error instanceof Error ? error.message : String(error),
+        });
+        // Can't create staging/prod without example template
+        return result;
+    }
+    // Parse .env.example to use as template for staging/prod
+    const devEnv = (0, env_validator_js_1.parseEnvFile)(devPath);
+    if (!devEnv) {
+        result.errors.push({
+            file: 'staging/prod',
+            error: 'Could not parse .env.example to generate templates',
+        });
+        return result;
+    }
+    // Create staging and prod templates based on example
+    const environments = ['staging', 'prod'];
+    for (const env of environments) {
+        const filename = `.env.${env}`;
+        const filepath = path.join(rootDir, filename);
+        try {
+            // Check if file already exists
+            if (fs.existsSync(filepath)) {
+                result.skipped.push(filename);
+                continue;
+            }
+            // Generate and write template based on .env.example
+            const template = generateEnvTemplate(env, devEnv);
+            fs.writeFileSync(filepath, template, 'utf8');
+            result.created.push(filename);
+        }
+        catch (error) {
+            result.errors.push({
+                file: filename,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return result;
+}
+/**
+ * Generate secrets checklist for display
+ */
+function generateSecretsChecklist() {
+    return `
+   REQUIRED GitHub Secrets (minimal):
+   ───────────────────────────────────────────────────────
+   □ STAGING_SSH           - SSH private key for staging
+   □ PROD_SSH              - SSH private key for production
+   □ AWS_SECRET_ACCESS_KEY - AWS secret key (only secret AWS value)
+
+   OPTIONAL GitHub Secrets:
+   ───────────────────────────────────────────────────────
+   □ STAGING_ENVS   - Environment vars from .env.staging
+   □ PROD_ENVS      - Environment vars from .env.prod
+
+   NOT SECRETS (in factiii.yml):
+   ───────────────────────────────────────────────────────
+   ✓ environments.{env}.host - Server IP/hostname
+   ✓ aws.access_key_id       - AWS access key ID
+   ✓ aws.region              - AWS region (e.g., us-east-1)
+
+   NOT SECRETS (in factiiiAuto.yml):
+   ───────────────────────────────────────────────────────
+   ✓ ssh_user               - Defaults to ubuntu
+`.trim();
+}
+//# sourceMappingURL=template-generator.js.map

package/dist/utils/template-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-generator.js","sourceRoot":"","sources":["../../src/utils/template-generator.ts"],"names":[],"mappings":"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"}

package/dist/utils/version-check.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Version Check Utilities
+ *
+ * Utilities for checking and comparing package versions.
+ */
+interface ParsedVersion {
+    major: number;
+    minor: number;
+    patch: number;
+}
+interface FactiiiAutoVersion {
+    factiii_version: string | null;
+    factiii_min_version: string | null;
+}
+interface VersionCompatibility {
+    compatible: boolean;
+    currentVersion: string;
+    configVersion: string | null;
+    minVersion: string | null;
+    needsUpgrade: boolean;
+    isBreaking: boolean;
+    message: string;
+}
+/**
+ * Get current Factiii package version
+ */
+export declare function getFactiiiVersion(): string;
+/**
+ * Parse semantic version string
+ * @param version - Version string (e.g., "1.2.3")
+ */
+export declare function parseVersion(version: string): ParsedVersion | null;
+/**
+ * Compare two versions
+ * @param a - First version
+ * @param b - Second version
+ * @returns Negative if a < b, 0 if equal, positive if a > b
+ */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * Check if version a is compatible with minimum version b
+ * @param current - Current version
+ * @param minimum - Minimum required version
+ */
+export declare function isCompatible(current: string, minimum: string): boolean;
+/**
+ * Check if upgrade from a to b is a breaking change (major version bump)
+ * @param from - Original version
+ * @param to - Target version
+ */
+export declare function isBreakingUpgrade(from: string, to: string): boolean;
+/**
+ * Read version info from factiiiAuto.yml
+ * @param rootDir - Project root directory
+ */
+export declare function readFactiiiAutoVersion(rootDir: string): FactiiiAutoVersion;
+/**
+ * Check version compatibility and return status
+ * @param rootDir - Project root directory
+ */
+export declare function checkVersionCompatibility(rootDir: string): VersionCompatibility;
+/**
+ * Display version warning if needed
+ * @param rootDir - Project root directory
+ * @returns True if warning was displayed
+ */
+export declare function displayVersionWarning(rootDir: string): boolean;
+export {};
+//# sourceMappingURL=version-check.d.ts.map

package/dist/utils/version-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../../src/utils/version-check.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,kBAAkB;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,UAAU,oBAAoB;IAC5B,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAU1C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAWlE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAS5D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAMnE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAoB1E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CA2C/E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAuB9D"}

package/dist/utils/version-check.js

@@ -0,0 +1,211 @@
+"use strict";
+/**
+ * Version Check Utilities
+ *
+ * Utilities for checking and comparing package versions.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFactiiiVersion = getFactiiiVersion;
+exports.parseVersion = parseVersion;
+exports.compareVersions = compareVersions;
+exports.isCompatible = isCompatible;
+exports.isBreakingUpgrade = isBreakingUpgrade;
+exports.readFactiiiAutoVersion = readFactiiiAutoVersion;
+exports.checkVersionCompatibility = checkVersionCompatibility;
+exports.displayVersionWarning = displayVersionWarning;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+/**
+ * Get current Factiii package version
+ */
+function getFactiiiVersion() {
+    try {
+        const packageJsonPath = path.join(__dirname, '../../package.json');
+        const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+        return pkg.version ?? '1.0.0';
+    }
+    catch {
+        return '1.0.0';
+    }
+}
+/**
+ * Parse semantic version string
+ * @param version - Version string (e.g., "1.2.3")
+ */
+function parseVersion(version) {
+    if (!version)
+        return null;
+    const match = version.match(/^(\d+)\.(\d+)\.(\d+)/);
+    if (!match)
+        return null;
+    return {
+        major: parseInt(match[1] ?? '0', 10),
+        minor: parseInt(match[2] ?? '0', 10),
+        patch: parseInt(match[3] ?? '0', 10),
+    };
+}
+/**
+ * Compare two versions
+ * @param a - First version
+ * @param b - Second version
+ * @returns Negative if a < b, 0 if equal, positive if a > b
+ */
+function compareVersions(a, b) {
+    const vA = parseVersion(a);
+    const vB = parseVersion(b);
+    if (!vA || !vB)
+        return 0;
+    if (vA.major !== vB.major)
+        return vA.major - vB.major;
+    if (vA.minor !== vB.minor)
+        return vA.minor - vB.minor;
+    return vA.patch - vB.patch;
+}
+/**
+ * Check if version a is compatible with minimum version b
+ * @param current - Current version
+ * @param minimum - Minimum required version
+ */
+function isCompatible(current, minimum) {
+    return compareVersions(current, minimum) >= 0;
+}
+/**
+ * Check if upgrade from a to b is a breaking change (major version bump)
+ * @param from - Original version
+ * @param to - Target version
+ */
+function isBreakingUpgrade(from, to) {
+    const vFrom = parseVersion(from);
+    const vTo = parseVersion(to);
+    if (!vFrom || !vTo)
+        return false;
+    return vTo.major > vFrom.major;
+}
+/**
+ * Read version info from factiiiAuto.yml
+ * @param rootDir - Project root directory
+ */
+function readFactiiiAutoVersion(rootDir) {
+    const factiiiAutoPath = path.join(rootDir, 'factiiiAuto.yml');
+    if (!fs.existsSync(factiiiAutoPath)) {
+        return { factiii_version: null, factiii_min_version: null };
+    }
+    try {
+        const content = fs.readFileSync(factiiiAutoPath, 'utf8');
+        const config = js_yaml_1.default.load(content);
+        return {
+            factiii_version: config?.factiii_version ?? null,
+            factiii_min_version: config?.factiii_min_version ?? null,
+        };
+    }
+    catch {
+        return { factiii_version: null, factiii_min_version: null };
+    }
+}
+/**
+ * Check version compatibility and return status
+ * @param rootDir - Project root directory
+ */
+function checkVersionCompatibility(rootDir) {
+    const currentVersion = getFactiiiVersion();
+    const { factiii_version, factiii_min_version } = readFactiiiAutoVersion(rootDir);
+    const result = {
+        compatible: true,
+        currentVersion,
+        configVersion: factiii_version,
+        minVersion: factiii_min_version,
+        needsUpgrade: false,
+        isBreaking: false,
+        message: '',
+    };
+    // No version info in factiiiAuto.yml (legacy or first run)
+    if (!factiii_version) {
+        result.needsUpgrade = true;
+        result.message = 'No version info in factiiiAuto.yml. Run: npx factiii upgrade';
+        return result;
+    }
+    // Check if current version meets minimum requirement
+    if (factiii_min_version && !isCompatible(currentVersion, factiii_min_version)) {
+        result.compatible = false;
+        result.message = `Factiii version ${currentVersion} is below minimum required ${factiii_min_version}`;
+        return result;
+    }
+    // Check if versions match
+    if (compareVersions(currentVersion, factiii_version) !== 0) {
+        result.needsUpgrade = true;
+        result.isBreaking = isBreakingUpgrade(factiii_version, currentVersion);
+        if (result.isBreaking) {
+            result.message = `Major version change: ${factiii_version} → ${currentVersion}. Run: npx factiii upgrade`;
+        }
+        else {
+            result.message = `Version mismatch: config=${factiii_version}, installed=${currentVersion}. Run: npx factiii upgrade`;
+        }
+        return result;
+    }
+    result.message = 'Version compatible';
+    return result;
+}
+/**
+ * Display version warning if needed
+ * @param rootDir - Project root directory
+ * @returns True if warning was displayed
+ */
+function displayVersionWarning(rootDir) {
+    const status = checkVersionCompatibility(rootDir);
+    if (!status.compatible) {
+        console.log('');
+        console.log('[!] VERSION INCOMPATIBILITY');
+        console.log(`   ${status.message}`);
+        console.log('');
+        return true;
+    }
+    if (status.needsUpgrade) {
+        console.log('');
+        console.log('Version Update Available');
+        console.log(`   ${status.message}`);
+        if (status.isBreaking) {
+            console.log('  [!] This is a major version change - check CHANGELOG.md');
+        }
+        console.log('');
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=version-check.js.map

package/dist/utils/version-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.js","sourceRoot":"","sources":["../../src/utils/version-check.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@factiii/stack",
+  "version": "0.1.2",
+  "description": "Infrastructure management package for deploying services to servers",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "factiii": "./bin/factiii"
+  },
+  "files": [
+    "bin/",
+    "dist/"
+  ],
+  "scripts": {
+    "build": "tsc && npm run copy-assets",
+    "build:watch": "tsc --watch",
+    "clean": "node -e \"const fs=require('fs');if(fs.existsSync('dist'))fs.rmSync('dist',{recursive:true,force:true})\"",
+    "copy-assets": "node -e \"const fs=require('fs'),p=require('path');fs.cpSync('src/plugins/approved.json','dist/plugins/approved.json');const d='dist/plugins/pipelines/factiii/workflows';fs.mkdirSync(d,{recursive:true});for(const f of fs.readdirSync('src/plugins/pipelines/factiii/workflows').filter(f=>f.endsWith('.yml')))fs.cpSync(p.join('src/plugins/pipelines/factiii/workflows',f),p.join(d,f))\"",
+    "prebuild": "npm run clean",
+    "prepublish-check": "node -e \"const v=require('./package.json').version; if(v.includes('-d')){console.error('❌ Cannot publish dev version:',v); process.exit(1)}\"",
+    "prepublishOnly": "npm run prepublish-check && npm run build",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "infrastructure",
+    "deployment",
+    "docker",
+    "nginx"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/factiii/core.git"
+  },
+  "publishConfig": {
+    "registry": "https://npm.pkg.github.com"
+  },
+  "dependencies": {
+    "@octokit/rest": "^20.0.2",
+    "commander": "^11.1.0",
+    "js-yaml": "^4.1.1",
+    "libsodium-wrappers": "^0.7.11"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.0.3",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.4.6",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "jest": {
+    "preset": "ts-jest",
+    "testEnvironment": "node",
+    "testMatch": [
+      "**/test/**/*.test.ts"
+    ],
+    "moduleNameMapper": {
+      "^(\\.{1,2}/.*)\\.js$": "$1"
+    },
+    "collectCoverageFrom": [
+      "src/**/*.ts",
+      "!**/node_modules/**"
+    ],
+    "coverageThreshold": {
+      "global": {
+        "branches": 70,
+        "functions": 70,
+        "lines": 70,
+        "statements": 70
+      }
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}