@factiii/stack 0.1.2

package/dist/plugins/servers/amazon-linux/index.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Amazon Linux Server Plugin
+ *
+ * Handles Amazon Linux-specific package management and commands.
+ * Used for deploying to AWS EC2 instances running Amazon Linux 2023.
+ *
+ * ============================================================
+ * PLUGIN STRUCTURE STANDARD
+ * ============================================================
+ *
+ * This plugin follows a standardized structure for clarity and maintainability:
+ *
+ * **scanfix/** - Scan/fix operations organized by concern
+ *   - Each file exports an array of Fix[] objects
+ *   - All fixes are combined in the main plugin class
+ *
+ * **index.ts** - Main plugin class
+ *   - Static metadata (id, name, category, version, os, packageManager, serviceManager)
+ *   - shouldLoad() - Determines if plugin should load
+ *   - OS-specific installation commands
+ * ============================================================
+ */
+import type { FactiiiConfig, EnvironmentConfig, DeployResult, EnsureServerReadyOptions, ServerOS, PackageManager, ServiceManager } from '../../../types/index.js';
+declare class AmazonLinuxPlugin {
+    static readonly id = "amazon-linux";
+    static readonly name = "Amazon Linux Server";
+    static readonly category: 'server';
+    static readonly version = "1.0.0";
+    /** The OS this server plugin handles */
+    static readonly os: ServerOS;
+    /** Package manager for Amazon Linux (dnf for AL2023, yum for AL2) */
+    static readonly packageManager: PackageManager;
+    /** Service manager for Amazon Linux */
+    static readonly serviceManager: ServiceManager;
+    static readonly requiredEnvVars: string[];
+    static readonly configSchema: Record<string, unknown>;
+    static readonly autoConfigSchema: Record<string, string>;
+    /**
+     * Determine if this plugin should be loaded for this project
+     * Loads if config has environment with server: 'amazon-linux'
+     */
+    static shouldLoad(_rootDir: string, config: FactiiiConfig): Promise<boolean>;
+    static helpText: Record<string, string>;
+    static readonly fixes: {
+        os: ServerOS;
+        id: string;
+        stage: import("../../../types/plugin.js").Stage;
+        severity: import("../../../types/plugin.js").Severity;
+        description: string;
+        plugin?: string;
+        scan: (config: FactiiiConfig, rootDir: string) => Promise<boolean>;
+        fix?: ((config: FactiiiConfig, rootDir: string) => Promise<boolean>) | null;
+        manualFix: string;
+    }[];
+    /**
+     * Auto-detect Amazon Linux configuration
+     */
+    static detectConfig(_rootDir: string): Promise<{
+        ssh_user: string;
+    }>;
+    /**
+     * Execute a command on a remote server via SSH
+     */
+    static sshExec(envConfig: EnvironmentConfig, command: string): Promise<string>;
+    /**
+     * Get the command to install Docker on Amazon Linux 2023
+     */
+    static getDockerInstallCommand(): string;
+    /**
+     * Get the command to install Node.js on Amazon Linux
+     */
+    static getNodeInstallCommand(): string;
+    /**
+     * Get the command to install git on Amazon Linux
+     */
+    static getGitInstallCommand(): string;
+    private _config;
+    constructor(config: FactiiiConfig);
+    /**
+     * Ensure server is ready for deployment
+     */
+    ensureServerReady(config: FactiiiConfig, environment: string, options?: EnsureServerReadyOptions): Promise<DeployResult>;
+    /**
+     * Deploy to an environment
+     */
+    deploy(config: FactiiiConfig, environment: string): Promise<DeployResult>;
+    /**
+     * Undeploy from an environment
+     */
+    undeploy(config: FactiiiConfig, environment: string): Promise<DeployResult>;
+}
+export default AmazonLinuxPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/servers/amazon-linux/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/servers/amazon-linux/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,wBAAwB,EACxB,QAAQ,EACR,cAAc,EACd,cAAc,EACf,MAAM,yBAAyB,CAAC;AAcjC,cAAM,iBAAiB;IAKrB,MAAM,CAAC,QAAQ,CAAC,EAAE,kBAAkB;IACpC,MAAM,CAAC,QAAQ,CAAC,IAAI,yBAAyB;IAC7C,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAY;IAC9C,MAAM,CAAC,QAAQ,CAAC,OAAO,WAAW;IAElC,wCAAwC;IACxC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAkB;IAC9C,qEAAqE;IACrE,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAS;IACvD,uCAAuC;IACvC,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAa;IAG3D,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAAM;IAG/C,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IAG3D,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEtD;IAEF;;;OAGG;WACU,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBlF,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASrC;IAQF,MAAM,CAAC,QAAQ,CAAC,KAAK;YAEkD,QAAQ;;;;;;;;;QAc7E;IAMF;;OAEG;WACU,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAM1E;;OAEG;WACU,OAAO,CAAC,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQpF;;OAEG;IACH,MAAM,CAAC,uBAAuB,IAAI,MAAM;IAUxC;;OAEG;IACH,MAAM,CAAC,qBAAqB,IAAI,MAAM;IAOtC;;OAEG;IACH,MAAM,CAAC,oBAAoB,IAAI,MAAM;IAQrC,OAAO,CAAC,OAAO,CAAgB;gBAEnB,MAAM,EAAE,aAAa;IAIjC;;OAEG;IACG,iBAAiB,CACrB,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,YAAY,CAAC;IAKxB;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAM/E;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAWlF;AAED,eAAe,iBAAiB,CAAC"}

package/dist/plugins/servers/amazon-linux/index.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * Amazon Linux Server Plugin
+ *
+ * Handles Amazon Linux-specific package management and commands.
+ * Used for deploying to AWS EC2 instances running Amazon Linux 2023.
+ *
+ * ============================================================
+ * PLUGIN STRUCTURE STANDARD
+ * ============================================================
+ *
+ * This plugin follows a standardized structure for clarity and maintainability:
+ *
+ * **scanfix/** - Scan/fix operations organized by concern
+ *   - Each file exports an array of Fix[] objects
+ *   - All fixes are combined in the main plugin class
+ *
+ * **index.ts** - Main plugin class
+ *   - Static metadata (id, name, category, version, os, packageManager, serviceManager)
+ *   - shouldLoad() - Determines if plugin should load
+ *   - OS-specific installation commands
+ * ============================================================
+ */
+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 });
+const child_process_1 = require("child_process");
+// Import shared scanfix factories
+const index_js_1 = require("../../../scanfix/index.js");
+// Import SSH helper
+const ssh_helper_js_1 = require("../../../utils/ssh-helper.js");
+class AmazonLinuxPlugin {
+    // ============================================================
+    // STATIC METADATA
+    // ============================================================
+    static id = 'amazon-linux';
+    static name = 'Amazon Linux Server';
+    static category = 'server';
+    static version = '1.0.0';
+    /** The OS this server plugin handles */
+    static os = 'amazon-linux';
+    /** Package manager for Amazon Linux (dnf for AL2023, yum for AL2) */
+    static packageManager = 'dnf';
+    /** Service manager for Amazon Linux */
+    static serviceManager = 'systemd';
+    // Env vars this plugin requires
+    static requiredEnvVars = [];
+    // Schema for factiii.yml (user-editable)
+    static configSchema = {};
+    // Schema for factiiiAuto.yml (auto-detected)
+    static autoConfigSchema = {
+        ssh_user: 'string',
+    };
+    /**
+     * Determine if this plugin should be loaded for this project
+     * Loads if config has environment with server: 'amazon-linux'
+     */
+    static async shouldLoad(_rootDir, config) {
+        // Dynamic import to avoid circular dependencies
+        const { extractEnvironments } = await Promise.resolve().then(() => __importStar(require('../../../utils/config-helpers.js')));
+        const environments = extractEnvironments(config);
+        for (const env of Object.values(environments)) {
+            // Load if environment explicitly uses 'amazon-linux' server
+            if (env.server === 'amazon-linux') {
+                return true;
+            }
+        }
+        return false;
+    }
+    static helpText = {
+        SSH: `
+   SSH private key for accessing the Amazon Linux server.
+
+   For AWS EC2:
+   - Use the key pair you created when launching the instance
+   - Download the .pem file from AWS Console
+
+   Default user for Amazon Linux: ec2-user`,
+    };
+    // ============================================================
+    // FIXES - All issues this plugin can detect and resolve
+    // ============================================================
+    // All fixes are OS-specific to Amazon Linux
+    // ============================================================
+    static fixes = [
+        // Dev stage - shared fixes (with OS filter)
+        ...(0, index_js_1.getDockerFixes)('dev').map(fix => ({ ...fix, os: 'amazon-linux' })),
+        // Staging stage - shared fixes (with OS filter)
+        ...(0, index_js_1.getDockerFixes)('staging').map(fix => ({ ...fix, os: 'amazon-linux' })),
+        ...(0, index_js_1.getNodeFixes)('staging').map(fix => ({ ...fix, os: 'amazon-linux' })),
+        ...(0, index_js_1.getGitFixes)('staging').map(fix => ({ ...fix, os: 'amazon-linux' })),
+        ...(0, index_js_1.getPnpmFixes)('staging').map(fix => ({ ...fix, os: 'amazon-linux' })),
+        { ...(0, index_js_1.createCertbotFix)('staging', 'staging'), os: 'amazon-linux' },
+        // Prod stage - shared fixes (with OS filter)
+        ...(0, index_js_1.getDockerFixes)('prod').map(fix => ({ ...fix, os: 'amazon-linux' })),
+        ...(0, index_js_1.getNodeFixes)('prod').map(fix => ({ ...fix, os: 'amazon-linux' })),
+        ...(0, index_js_1.getGitFixes)('prod').map(fix => ({ ...fix, os: 'amazon-linux' })),
+        { ...(0, index_js_1.createCertbotFix)('prod', 'prod'), os: 'amazon-linux' },
+    ];
+    // ============================================================
+    // STATIC HELPER METHODS
+    // ============================================================
+    /**
+     * Auto-detect Amazon Linux configuration
+     */
+    static async detectConfig(_rootDir) {
+        return {
+            ssh_user: 'ec2-user', // Default SSH user for Amazon Linux
+        };
+    }
+    /**
+     * Execute a command on a remote server via SSH
+     */
+    static async sshExec(envConfig, command) {
+        return await (0, ssh_helper_js_1.sshExec)(envConfig, command);
+    }
+    // ============================================================
+    // AMAZON LINUX-SPECIFIC INSTALLATION COMMANDS
+    // ============================================================
+    /**
+     * Get the command to install Docker on Amazon Linux 2023
+     */
+    static getDockerInstallCommand() {
+        return `
+      sudo dnf update -y && \
+      sudo dnf install -y docker && \
+      sudo systemctl start docker && \
+      sudo systemctl enable docker && \
+      sudo usermod -aG docker $USER
+    `;
+    }
+    /**
+     * Get the command to install Node.js on Amazon Linux
+     */
+    static getNodeInstallCommand() {
+        return `
+      curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash - && \
+      sudo dnf install -y nodejs
+    `;
+    }
+    /**
+     * Get the command to install git on Amazon Linux
+     */
+    static getGitInstallCommand() {
+        return 'sudo dnf install -y git';
+    }
+    // ============================================================
+    // INSTANCE METHODS
+    // ============================================================
+    _config;
+    constructor(config) {
+        this._config = config;
+    }
+    /**
+     * Ensure server is ready for deployment
+     */
+    async ensureServerReady(config, environment, options = {}) {
+        // Amazon Linux handles all environments that use it
+        return { success: true, message: 'Amazon Linux server ready' };
+    }
+    /**
+     * Deploy to an environment
+     */
+    async deploy(config, environment) {
+        // Deployment is handled by the pipeline plugin
+        // Server plugin just provides OS-specific commands
+        return { success: true, message: `Deployment for ${environment} handled by pipeline` };
+    }
+    /**
+     * Undeploy from an environment
+     */
+    async undeploy(config, environment) {
+        try {
+            (0, child_process_1.execSync)('docker compose down', { stdio: 'inherit' });
+            return { success: true, message: 'Containers stopped' };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+}
+exports.default = AmazonLinuxPlugin;
+//# sourceMappingURL=index.js.map

package/dist/plugins/servers/amazon-linux/index.js.map

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

package/dist/plugins/servers/mac/dev.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Dev environment operations for macOS plugin
+ * Handles local development deployment
+ */
+import type { DeployResult } from '../../../types/index.js';
+/**
+ * Deploy to local dev environment
+ */
+export declare function deployDev(): Promise<DeployResult>;
+//# sourceMappingURL=dev.d.ts.map

package/dist/plugins/servers/mac/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../../src/plugins/servers/mac/dev.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC,CAwBvD"}

package/dist/plugins/servers/mac/dev.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Dev environment operations for macOS plugin
+ * Handles local development deployment
+ */
+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.deployDev = deployDev;
+const fs = __importStar(require("fs"));
+const child_process_1 = require("child_process");
+/**
+ * Deploy to local dev environment
+ */
+async function deployDev() {
+    console.log('   Starting local dev containers...');
+    try {
+        // Check for docker-compose file
+        const composeFile = fs.existsSync('docker-compose.yml')
+            ? 'docker-compose.yml'
+            : fs.existsSync('compose.yml')
+                ? 'compose.yml'
+                : null;
+        if (composeFile) {
+            (0, child_process_1.execSync)(`docker compose -f ${composeFile} up -d`, { stdio: 'inherit' });
+            return { success: true, message: 'Local containers started' };
+        }
+        else {
+            console.log('   No docker-compose.yml found, skipping container start');
+            return { success: true, message: 'No compose file, skipped' };
+        }
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+//# sourceMappingURL=dev.js.map

package/dist/plugins/servers/mac/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../../../src/plugins/servers/mac/dev.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASH,8BAwBC;AA/BD,uCAAyB;AACzB,iDAAyC;AAGzC;;GAEG;AACI,KAAK,UAAU,SAAS;IAC7B,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;IAEnD,IAAI,CAAC;QACH,gCAAgC;QAChC,MAAM,WAAW,GAAG,EAAE,CAAC,UAAU,CAAC,oBAAoB,CAAC;YACrD,CAAC,CAAC,oBAAoB;YACtB,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC;gBAC5B,CAAC,CAAC,aAAa;gBACf,CAAC,CAAC,IAAI,CAAC;QAEX,IAAI,WAAW,EAAE,CAAC;YAChB,IAAA,wBAAQ,EAAC,qBAAqB,WAAW,QAAQ,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YACzE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;YACxE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC;QAChE,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/plugins/servers/mac/index.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Mac Server Plugin
+ *
+ * Handles macOS-specific package management and commands.
+ * Used for deploying to Mac servers or local Mac development.
+ *
+ * ============================================================
+ * PLUGIN STRUCTURE STANDARD
+ * ============================================================
+ *
+ * This plugin follows a standardized structure for clarity and maintainability:
+ *
+ * **scanfix/** - Scan/fix operations organized by concern
+ *   - Each file exports an array of Fix[] objects
+ *   - Files group related fixes together (docker, node, git, containers, config)
+ *   - All fixes are combined in the main plugin class
+ *
+ * **Environment-specific files** - Operations for each environment
+ *   - dev.ts - Dev environment operations (deployDev)
+ *   - staging.ts - Staging operations (deployStaging, ensureServerReady)
+ *   - Only create files if they have content (no blank files)
+ *
+ * **index.ts** - Main plugin class
+ *   - Static metadata (id, name, category, version, os, packageManager, serviceManager)
+ *   - shouldLoad() - Determines if plugin should load
+ *   - Imports and combines all scanfix arrays
+ *   - Imports and uses environment-specific methods
+ *   - Maintains public API compatibility
+ *
+ * **When each environment file is used:**
+ *   - dev.ts: When deploying to local dev environment
+ *   - staging.ts: When deploying to staging server or preparing staging server
+ *
+ * **How scanfix files are organized:**
+ *   - docker.ts: Docker installation, running status, autostart (dev + staging)
+ *   - node.ts: Node.js and pnpm installation (staging)
+ *   - git.ts: Git installation (staging)
+ *   - containers.ts: Container management and cleanup (staging)
+ *   - config.ts: Configuration checks and file validation (dev + staging)
+ * ============================================================
+ */
+import type { FactiiiConfig, EnvironmentConfig, DeployResult, EnsureServerReadyOptions, ServerOS, PackageManager, ServiceManager } from '../../../types/index.js';
+declare class MacPlugin {
+    static readonly id = "mac";
+    static readonly name = "Mac Server";
+    static readonly category: 'server';
+    static readonly version = "1.0.0";
+    /** The OS this server plugin handles */
+    static readonly os: ServerOS;
+    /** Package manager for macOS */
+    static readonly packageManager: PackageManager;
+    /** Service manager for macOS */
+    static readonly serviceManager: ServiceManager;
+    static readonly requiredEnvVars: string[];
+    static readonly configSchema: Record<string, unknown>;
+    static readonly autoConfigSchema: Record<string, string>;
+    /**
+     * Determine if this plugin should be loaded for this project
+     * Loads if config has environment with server: 'mac'
+     */
+    static shouldLoad(_rootDir: string, config: FactiiiConfig): Promise<boolean>;
+    static helpText: Record<string, string>;
+    static readonly fixes: {
+        os: ServerOS;
+        id: string;
+        stage: import("../../../types/plugin.js").Stage;
+        severity: import("../../../types/plugin.js").Severity;
+        description: string;
+        plugin?: string;
+        scan: (config: FactiiiConfig, rootDir: string) => Promise<boolean>;
+        fix?: ((config: FactiiiConfig, rootDir: string) => Promise<boolean>) | null;
+        manualFix: string;
+    }[];
+    /**
+     * Auto-detect macOS configuration
+     */
+    static detectConfig(_rootDir: string): Promise<{
+        ssh_user: string;
+    }>;
+    /**
+     * Execute a command on a remote server via SSH
+     */
+    static sshExec(envConfig: EnvironmentConfig, command: string): Promise<string>;
+    private _config;
+    constructor(config: FactiiiConfig);
+    /**
+     * Ensure server is ready for deployment
+     * Installs Node.js, git, pnpm, clones repo, checks out commit
+     */
+    ensureServerReady(config: FactiiiConfig, environment: string, options?: EnsureServerReadyOptions): Promise<DeployResult>;
+    /**
+     * Deploy to an environment
+     */
+    deploy(config: FactiiiConfig, environment: string): Promise<DeployResult>;
+    /**
+     * Undeploy from an environment
+     */
+    undeploy(config: FactiiiConfig, environment: string): Promise<DeployResult>;
+}
+export default MacPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/servers/mac/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/servers/mac/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,wBAAwB,EACxB,QAAQ,EACR,cAAc,EACd,cAAc,EACf,MAAM,yBAAyB,CAAC;AAuBjC,cAAM,SAAS;IAKb,MAAM,CAAC,QAAQ,CAAC,EAAE,SAAS;IAC3B,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB;IACpC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAY;IAC9C,MAAM,CAAC,QAAQ,CAAC,OAAO,WAAW;IAElC,wCAAwC;IACxC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAS;IACrC,gCAAgC;IAChC,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAU;IACxD,gCAAgC;IAChC,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAe;IAG7D,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAAM;IAG/C,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGnD;IAGF,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEtD;IAEF;;;OAGG;WACU,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BlF,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYrC;IASF,MAAM,CAAC,QAAQ,CAAC,KAAK;YAEyC,QAAQ;;;;;;;;;QAapE;IAMF;;OAEG;WACU,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAM1E;;OAEG;WACU,OAAO,CAAC,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQpF,OAAO,CAAC,OAAO,CAAgB;gBAEnB,MAAM,EAAE,aAAa;IAIjC;;;OAGG;IACG,iBAAiB,CACrB,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,YAAY,CAAC;IAIxB;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAU/E;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAuClF;AAED,eAAe,SAAS,CAAC"}