@factiii/stack 0.1.2

package/dist/plugins/interfaces/addon.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Addon Plugin Interface
+ *
+ * Base class for all addon plugins (auth, payments, storage, etc.)
+ * Addon plugins extend framework functionality.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddonPlugin = void 0;
+/**
+ * Abstract base class for addon plugins
+ */
+class AddonPlugin {
+    // ============================================================
+    // REQUIRED STATIC PROPERTIES
+    // ============================================================
+    static id = 'addon-interface';
+    static name = 'Addon Interface';
+    static category = 'addon';
+    static version = '1.0.0';
+    static fixes = [];
+    static requiredEnvVars = [];
+    static configSchema = {};
+    static autoConfigSchema = {};
+    // ============================================================
+    // INSTANCE PROPERTIES
+    // ============================================================
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    // ============================================================
+    // REQUIRED STATIC METHODS
+    // ============================================================
+    /**
+     * Determine if this plugin should be loaded for this project
+     * @param rootDir - Project root directory
+     * @param config - Loaded config
+     */
+    static async shouldLoad(_rootDir, _config) {
+        throw new Error('Addon plugin must implement shouldLoad()');
+    }
+    /**
+     * Auto-detect addon configuration
+     * @param rootDir - Project root directory
+     */
+    static async detectConfig(_rootDir) {
+        return {};
+    }
+}
+exports.AddonPlugin = AddonPlugin;
+exports.default = AddonPlugin;
+//# sourceMappingURL=addon.js.map

package/dist/plugins/interfaces/addon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addon.js","sourceRoot":"","sources":["../../../src/plugins/interfaces/addon.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAQH;;GAEG;AACH,MAAsB,WAAW;IAC/B,+DAA+D;IAC/D,6BAA6B;IAC7B,+DAA+D;IAE/D,MAAM,CAAU,EAAE,GAAW,iBAAiB,CAAC;IAC/C,MAAM,CAAU,IAAI,GAAW,iBAAiB,CAAC;IACjD,MAAM,CAAU,QAAQ,GAAY,OAAO,CAAC;IAC5C,MAAM,CAAU,OAAO,GAAW,OAAO,CAAC;IAE1C,MAAM,CAAU,KAAK,GAAU,EAAE,CAAC;IAClC,MAAM,CAAU,eAAe,GAAa,EAAE,CAAC;IAC/C,MAAM,CAAU,YAAY,GAA4B,EAAE,CAAC;IAC3D,MAAM,CAAU,gBAAgB,GAA2B,EAAE,CAAC;IAE9D,+DAA+D;IAC/D,sBAAsB;IACtB,+DAA+D;IAErD,MAAM,CAAgB;IAEhC,YAAY,MAAqB;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,+DAA+D;IAC/D,0BAA0B;IAC1B,+DAA+D;IAE/D;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,OAAsB;QAC9D,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,QAAgB;QACxC,OAAO,EAAE,CAAC;IACZ,CAAC;;AA5CH,kCA2DC;AAED,kBAAe,WAAW,CAAC"}

package/dist/plugins/interfaces/framework.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Framework Plugin Interface
+ *
+ * Base class for all framework plugins (prisma-trpc, nextjs, expo, etc.)
+ * Framework plugins handle deployment of specific application frameworks.
+ */
+import type { FactiiiConfig, Fix, DeployResult } from '../../types/index.js';
+/**
+ * Abstract base class for framework plugins
+ */
+export declare abstract class FrameworkPlugin {
+    static readonly id: string;
+    static readonly name: string;
+    static readonly category: 'framework';
+    static readonly version: string;
+    static readonly fixes: Fix[];
+    static readonly requiredEnvVars: string[];
+    static readonly configSchema: Record<string, unknown>;
+    static readonly autoConfigSchema: Record<string, string>;
+    protected config: FactiiiConfig;
+    constructor(config: FactiiiConfig);
+    /**
+     * Determine if this plugin should be loaded for this project
+     * @param rootDir - Project root directory
+     * @param config - Loaded config
+     */
+    static shouldLoad(_rootDir: string, _config: FactiiiConfig): Promise<boolean>;
+    /**
+     * Auto-detect framework configuration
+     * @param rootDir - Project root directory
+     */
+    static detectConfig(_rootDir: string): Promise<Record<string, unknown>>;
+    /**
+     * Deploy to an environment
+     */
+    abstract deploy(config: FactiiiConfig, environment: string): Promise<DeployResult>;
+    /**
+     * Undeploy from an environment
+     */
+    abstract undeploy(config: FactiiiConfig, environment: string): Promise<DeployResult>;
+}
+export default FrameworkPlugin;
+//# sourceMappingURL=framework.d.ts.map

package/dist/plugins/interfaces/framework.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework.d.ts","sourceRoot":"","sources":["../../../src/plugins/interfaces/framework.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,GAAG,EACH,YAAY,EACb,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,8BAAsB,eAAe;IAKnC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAyB;IACnD,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAyB;IACrD,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAe;IACpD,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAW;IAE1C,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,CAAM;IAClC,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAAM;IAC/C,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IAC3D,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAM9D,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC;gBAEpB,MAAM,EAAE,aAAa;IAQjC;;;;OAIG;WACU,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAInF;;;OAGG;WACU,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAQ7E;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAElF;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CACrF;AAED,eAAe,eAAe,CAAC"}

package/dist/plugins/interfaces/framework.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Framework Plugin Interface
+ *
+ * Base class for all framework plugins (prisma-trpc, nextjs, expo, etc.)
+ * Framework plugins handle deployment of specific application frameworks.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrameworkPlugin = void 0;
+/**
+ * Abstract base class for framework plugins
+ */
+class FrameworkPlugin {
+    // ============================================================
+    // REQUIRED STATIC PROPERTIES
+    // ============================================================
+    static id = 'framework-interface';
+    static name = 'Framework Interface';
+    static category = 'framework';
+    static version = '1.0.0';
+    static fixes = [];
+    static requiredEnvVars = [];
+    static configSchema = {};
+    static autoConfigSchema = {};
+    // ============================================================
+    // INSTANCE PROPERTIES
+    // ============================================================
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    // ============================================================
+    // REQUIRED STATIC METHODS
+    // ============================================================
+    /**
+     * Determine if this plugin should be loaded for this project
+     * @param rootDir - Project root directory
+     * @param config - Loaded config
+     */
+    static async shouldLoad(_rootDir, _config) {
+        throw new Error('Framework plugin must implement shouldLoad()');
+    }
+    /**
+     * Auto-detect framework configuration
+     * @param rootDir - Project root directory
+     */
+    static async detectConfig(_rootDir) {
+        return {};
+    }
+}
+exports.FrameworkPlugin = FrameworkPlugin;
+exports.default = FrameworkPlugin;
+//# sourceMappingURL=framework.js.map

package/dist/plugins/interfaces/framework.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework.js","sourceRoot":"","sources":["../../../src/plugins/interfaces/framework.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAQH;;GAEG;AACH,MAAsB,eAAe;IACnC,+DAA+D;IAC/D,6BAA6B;IAC7B,+DAA+D;IAE/D,MAAM,CAAU,EAAE,GAAW,qBAAqB,CAAC;IACnD,MAAM,CAAU,IAAI,GAAW,qBAAqB,CAAC;IACrD,MAAM,CAAU,QAAQ,GAAgB,WAAW,CAAC;IACpD,MAAM,CAAU,OAAO,GAAW,OAAO,CAAC;IAE1C,MAAM,CAAU,KAAK,GAAU,EAAE,CAAC;IAClC,MAAM,CAAU,eAAe,GAAa,EAAE,CAAC;IAC/C,MAAM,CAAU,YAAY,GAA4B,EAAE,CAAC;IAC3D,MAAM,CAAU,gBAAgB,GAA2B,EAAE,CAAC;IAE9D,+DAA+D;IAC/D,sBAAsB;IACtB,+DAA+D;IAErD,MAAM,CAAgB;IAEhC,YAAY,MAAqB;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,+DAA+D;IAC/D,0BAA0B;IAC1B,+DAA+D;IAE/D;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,OAAsB;QAC9D,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,QAAgB;QACxC,OAAO,EAAE,CAAC;IACZ,CAAC;;AA5CH,0CA2DC;AAED,kBAAe,eAAe,CAAC"}

package/dist/plugins/interfaces/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Plugin Interfaces Index
+ *
+ * Re-exports all plugin base classes.
+ */
+export { PipelinePlugin } from './pipeline.js';
+export { ServerPlugin } from './server.js';
+export { FrameworkPlugin } from './framework.js';
+export { AddonPlugin } from './addon.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/plugins/interfaces/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Plugin Interfaces Index
+ *
+ * Re-exports all plugin base classes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddonPlugin = exports.FrameworkPlugin = exports.ServerPlugin = exports.PipelinePlugin = void 0;
+var pipeline_js_1 = require("./pipeline.js");
+Object.defineProperty(exports, "PipelinePlugin", { enumerable: true, get: function () { return pipeline_js_1.PipelinePlugin; } });
+var server_js_1 = require("./server.js");
+Object.defineProperty(exports, "ServerPlugin", { enumerable: true, get: function () { return server_js_1.ServerPlugin; } });
+var framework_js_1 = require("./framework.js");
+Object.defineProperty(exports, "FrameworkPlugin", { enumerable: true, get: function () { return framework_js_1.FrameworkPlugin; } });
+var addon_js_1 = require("./addon.js");
+Object.defineProperty(exports, "AddonPlugin", { enumerable: true, get: function () { return addon_js_1.AddonPlugin; } });
+//# sourceMappingURL=index.js.map

package/dist/plugins/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/interfaces/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,6CAA+C;AAAtC,6GAAA,cAAc,OAAA;AACvB,yCAA2C;AAAlC,yGAAA,YAAY,OAAA;AACrB,+CAAiD;AAAxC,+GAAA,eAAe,OAAA;AACxB,uCAAyC;AAAhC,uGAAA,WAAW,OAAA"}

package/dist/plugins/interfaces/pipeline.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Pipeline Plugin Interface
+ *
+ * Base class for all pipeline plugins (GitHub Actions, GitLab CI, etc.)
+ * Pipelines handle CI/CD workflows and must implement canReach() to
+ * declare how they access each stage.
+ */
+import type { FactiiiConfig, Stage, Reachability, Fix, DeployResult, DeployOptions } from '../../types/index.js';
+/**
+ * Abstract base class for pipeline plugins
+ */
+export declare abstract class PipelinePlugin {
+    static readonly id: string;
+    static readonly name: string;
+    static readonly category: 'pipeline';
+    static readonly version: string;
+    static readonly fixes: Fix[];
+    static readonly requiredEnvVars: string[];
+    static readonly configSchema: Record<string, unknown>;
+    static readonly autoConfigSchema: Record<string, string>;
+    protected config: FactiiiConfig;
+    constructor(config: FactiiiConfig);
+    /**
+     * Check if this pipeline can reach a specific stage from current environment
+     *
+     * @param stage - 'dev' | 'secrets' | 'staging' | 'prod'
+     * @param config - factiii.yml config
+     * @returns Reachability result
+     */
+    static canReach(_stage: Stage, _config: FactiiiConfig): Reachability;
+    /**
+     * Determine if this plugin should be loaded for this project
+     * @param rootDir - Project root directory
+     * @param config - Loaded config
+     */
+    static shouldLoad(_rootDir: string, _config: FactiiiConfig): Promise<boolean>;
+    /**
+     * Auto-detect pipeline configuration
+     * @param rootDir - Project root directory
+     */
+    static detectConfig(_rootDir: string): Promise<Record<string, unknown>>;
+    /**
+     * Generate workflow files in the target repository
+     * @param rootDir - Project root directory
+     */
+    static generateWorkflows(_rootDir: string): Promise<void>;
+    /**
+     * Trigger a workflow
+     * @param workflowName - Name of workflow to trigger
+     * @param inputs - Workflow inputs
+     */
+    static triggerWorkflow(_workflowName: string, _inputs?: Record<string, string>): Promise<void>;
+    /**
+     * Deploy to a stage - handles routing based on canReach()
+     *
+     * This is the main entry point for deployments. The pipeline plugin
+     * checks canReach() to determine how to reach the stage:
+     * - 'local': Execute deployment directly
+     * - 'workflow': Trigger a workflow (e.g., GitHub Actions)
+     * - Not reachable: Return error with reason
+     *
+     * @param stage - The stage to deploy to ('dev' | 'staging' | 'prod')
+     * @param options - Deployment options
+     * @returns Deployment result
+     */
+    abstract deployStage(stage: Stage, options: DeployOptions): Promise<DeployResult>;
+    /**
+     * Deploy to an environment (called when running locally or on-server)
+     * @deprecated Use deployStage() which handles routing
+     */
+    abstract deploy(config: FactiiiConfig, environment: string): Promise<DeployResult>;
+    /**
+     * Undeploy from an environment
+     */
+    abstract undeploy(config: FactiiiConfig, environment: string): Promise<DeployResult>;
+}
+export default PipelinePlugin;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/plugins/interfaces/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../src/plugins/interfaces/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,KAAK,EACL,YAAY,EACZ,GAAG,EACH,YAAY,EACZ,aAAa,EACd,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,8BAAsB,cAAc;IAKlC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAwB;IAClD,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAwB;IACpD,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAc;IAClD,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAW;IAE1C,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,CAAM;IAClC,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAAM;IAC/C,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IAC3D,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAM9D,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC;gBAEpB,MAAM,EAAE,aAAa;IAQjC;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,GAAG,YAAY;IAIpE;;;;OAIG;WACU,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAInF;;;OAGG;WACU,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAQ7E;;;OAGG;WACU,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D;;;;OAIG;WACU,eAAe,CAC1B,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,OAAO,CAAC,IAAI,CAAC;IAQhB;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAEjF;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAElF;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CACrF;AAED,eAAe,cAAc,CAAC"}

package/dist/plugins/interfaces/pipeline.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Pipeline Plugin Interface
+ *
+ * Base class for all pipeline plugins (GitHub Actions, GitLab CI, etc.)
+ * Pipelines handle CI/CD workflows and must implement canReach() to
+ * declare how they access each stage.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PipelinePlugin = void 0;
+/**
+ * Abstract base class for pipeline plugins
+ */
+class PipelinePlugin {
+    // ============================================================
+    // REQUIRED STATIC PROPERTIES
+    // ============================================================
+    static id = 'pipeline-interface';
+    static name = 'Pipeline Interface';
+    static category = 'pipeline';
+    static version = '1.0.0';
+    static fixes = [];
+    static requiredEnvVars = [];
+    static configSchema = {};
+    static autoConfigSchema = {};
+    // ============================================================
+    // INSTANCE PROPERTIES
+    // ============================================================
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    // ============================================================
+    // REQUIRED STATIC METHODS
+    // ============================================================
+    /**
+     * Check if this pipeline can reach a specific stage from current environment
+     *
+     * @param stage - 'dev' | 'secrets' | 'staging' | 'prod'
+     * @param config - factiii.yml config
+     * @returns Reachability result
+     */
+    static canReach(_stage, _config) {
+        throw new Error('Pipeline must implement canReach()');
+    }
+    /**
+     * Determine if this plugin should be loaded for this project
+     * @param rootDir - Project root directory
+     * @param config - Loaded config
+     */
+    static async shouldLoad(_rootDir, _config) {
+        throw new Error('Pipeline must implement shouldLoad()');
+    }
+    /**
+     * Auto-detect pipeline configuration
+     * @param rootDir - Project root directory
+     */
+    static async detectConfig(_rootDir) {
+        throw new Error('Pipeline must implement detectConfig()');
+    }
+    // ============================================================
+    // OPTIONAL STATIC METHODS
+    // ============================================================
+    /**
+     * Generate workflow files in the target repository
+     * @param rootDir - Project root directory
+     */
+    static async generateWorkflows(_rootDir) {
+        // Optional - not all pipelines have workflow files
+    }
+    /**
+     * Trigger a workflow
+     * @param workflowName - Name of workflow to trigger
+     * @param inputs - Workflow inputs
+     */
+    static async triggerWorkflow(_workflowName, _inputs = {}) {
+        throw new Error('Pipeline must implement triggerWorkflow()');
+    }
+}
+exports.PipelinePlugin = PipelinePlugin;
+exports.default = PipelinePlugin;
+//# sourceMappingURL=pipeline.js.map

package/dist/plugins/interfaces/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../../src/plugins/interfaces/pipeline.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAWH;;GAEG;AACH,MAAsB,cAAc;IAClC,+DAA+D;IAC/D,6BAA6B;IAC7B,+DAA+D;IAE/D,MAAM,CAAU,EAAE,GAAW,oBAAoB,CAAC;IAClD,MAAM,CAAU,IAAI,GAAW,oBAAoB,CAAC;IACpD,MAAM,CAAU,QAAQ,GAAe,UAAU,CAAC;IAClD,MAAM,CAAU,OAAO,GAAW,OAAO,CAAC;IAE1C,MAAM,CAAU,KAAK,GAAU,EAAE,CAAC;IAClC,MAAM,CAAU,eAAe,GAAa,EAAE,CAAC;IAC/C,MAAM,CAAU,YAAY,GAA4B,EAAE,CAAC;IAC3D,MAAM,CAAU,gBAAgB,GAA2B,EAAE,CAAC;IAE9D,+DAA+D;IAC/D,sBAAsB;IACtB,+DAA+D;IAErD,MAAM,CAAgB;IAEhC,YAAY,MAAqB;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,+DAA+D;IAC/D,0BAA0B;IAC1B,+DAA+D;IAE/D;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAa,EAAE,OAAsB;QACnD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,OAAsB;QAC9D,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,QAAgB;QACxC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,+DAA+D;IAC/D,0BAA0B;IAC1B,+DAA+D;IAE/D;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QAC7C,mDAAmD;IACrD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,eAAe,CAC1B,aAAqB,EACrB,UAAkC,EAAE;QAEpC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;;AA/EH,wCA8GC;AAED,kBAAe,cAAc,CAAC"}

package/dist/plugins/interfaces/server.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Server Plugin Interface
+ *
+ * Base class for all server plugins (mac, ubuntu, windows, etc.)
+ * Server plugins represent OS types and handle OS-specific commands,
+ * package management, and service management.
+ *
+ * Server plugins are NOT deployment targets - they define how to interact
+ * with a specific operating system. Pipelines (like AWS, factiii) handle
+ * the deployment orchestration and specify which OS types they support.
+ */
+import type { FactiiiConfig, EnvironmentConfig, Fix, DeployResult, EnsureServerReadyOptions, ServerOS, PackageManager, ServiceManager } from '../../types/index.js';
+/**
+ * Abstract base class for server plugins
+ */
+export declare abstract class ServerPlugin {
+    static readonly id: string;
+    static readonly name: string;
+    static readonly category: 'server';
+    static readonly version: string;
+    /** The OS this server plugin handles */
+    static readonly os: ServerOS;
+    /** Package manager for this OS (brew, apt, choco, dnf, apk) */
+    static readonly packageManager: PackageManager;
+    /** Service manager for this OS (launchctl, systemd, windows-service) */
+    static readonly serviceManager: ServiceManager;
+    static readonly fixes: Fix[];
+    static readonly requiredEnvVars: string[];
+    static readonly configSchema: Record<string, unknown>;
+    static readonly autoConfigSchema: Record<string, string>;
+    protected config: FactiiiConfig;
+    constructor(config: FactiiiConfig);
+    /**
+     * Determine if this plugin should be loaded for this project
+     * @param rootDir - Project root directory
+     * @param config - Loaded config
+     */
+    static shouldLoad(_rootDir: string, _config: FactiiiConfig): Promise<boolean>;
+    /**
+     * Auto-detect server configuration
+     * @param rootDir - Project root directory
+     */
+    static detectConfig(_rootDir: string): Promise<Record<string, unknown>>;
+    /**
+     * Execute a command on a remote server via SSH
+     * @param envConfig - Environment config with host and ssh_user
+     * @param command - Command to execute
+     */
+    static sshExec(_envConfig: EnvironmentConfig, _command: string): Promise<string>;
+    /**
+     * Ensure server is ready for deployment
+     * Installs Node.js, git, clones repo, checks out commit
+     */
+    abstract ensureServerReady(config: FactiiiConfig, environment: string, options?: EnsureServerReadyOptions): Promise<DeployResult>;
+    /**
+     * Deploy to an environment
+     */
+    abstract deploy(config: FactiiiConfig, environment: string): Promise<DeployResult>;
+    /**
+     * Undeploy from an environment
+     */
+    abstract undeploy(config: FactiiiConfig, environment: string): Promise<DeployResult>;
+}
+export default ServerPlugin;
+//# sourceMappingURL=server.d.ts.map

package/dist/plugins/interfaces/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/plugins/interfaces/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,GAAG,EACH,YAAY,EACZ,wBAAwB,EACxB,QAAQ,EACR,cAAc,EACd,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,8BAAsB,YAAY;IAKhC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAsB;IAChD,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAsB;IAClD,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAY;IAC9C,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAW;IAE1C,wCAAwC;IACxC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IAC7B,+DAA+D;IAC/D,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAC/C,wEAAwE;IACxE,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAE/C,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,CAAM;IAClC,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAAM;IAC/C,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IAC3D,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAM9D,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC;gBAEpB,MAAM,EAAE,aAAa;IAQjC;;;;OAIG;WACU,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAInF;;;OAGG;WACU,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI7E;;;;OAIG;WACU,OAAO,CAClB,UAAU,EAAE,iBAAiB,EAC7B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;IAQlB;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CACxB,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,YAAY,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAElF;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CACrF;AAED,eAAe,YAAY,CAAC"}

package/dist/plugins/interfaces/server.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Server Plugin Interface
+ *
+ * Base class for all server plugins (mac, ubuntu, windows, etc.)
+ * Server plugins represent OS types and handle OS-specific commands,
+ * package management, and service management.
+ *
+ * Server plugins are NOT deployment targets - they define how to interact
+ * with a specific operating system. Pipelines (like AWS, factiii) handle
+ * the deployment orchestration and specify which OS types they support.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerPlugin = void 0;
+/**
+ * Abstract base class for server plugins
+ */
+class ServerPlugin {
+    // ============================================================
+    // REQUIRED STATIC PROPERTIES
+    // ============================================================
+    static id = 'server-interface';
+    static name = 'Server Interface';
+    static category = 'server';
+    static version = '1.0.0';
+    /** The OS this server plugin handles */
+    static os;
+    /** Package manager for this OS (brew, apt, choco, dnf, apk) */
+    static packageManager;
+    /** Service manager for this OS (launchctl, systemd, windows-service) */
+    static serviceManager;
+    static fixes = [];
+    static requiredEnvVars = [];
+    static configSchema = {};
+    static autoConfigSchema = {};
+    // ============================================================
+    // INSTANCE PROPERTIES
+    // ============================================================
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    // ============================================================
+    // REQUIRED STATIC METHODS
+    // ============================================================
+    /**
+     * Determine if this plugin should be loaded for this project
+     * @param rootDir - Project root directory
+     * @param config - Loaded config
+     */
+    static async shouldLoad(_rootDir, _config) {
+        throw new Error('Server plugin must implement shouldLoad()');
+    }
+    /**
+     * Auto-detect server configuration
+     * @param rootDir - Project root directory
+     */
+    static async detectConfig(_rootDir) {
+        return {};
+    }
+    /**
+     * Execute a command on a remote server via SSH
+     * @param envConfig - Environment config with host and ssh_user
+     * @param command - Command to execute
+     */
+    static async sshExec(_envConfig, _command) {
+        throw new Error('Server plugin must implement sshExec()');
+    }
+}
+exports.ServerPlugin = ServerPlugin;
+exports.default = ServerPlugin;
+//# sourceMappingURL=server.js.map

package/dist/plugins/interfaces/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/plugins/interfaces/server.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAaH;;GAEG;AACH,MAAsB,YAAY;IAChC,+DAA+D;IAC/D,6BAA6B;IAC7B,+DAA+D;IAE/D,MAAM,CAAU,EAAE,GAAW,kBAAkB,CAAC;IAChD,MAAM,CAAU,IAAI,GAAW,kBAAkB,CAAC;IAClD,MAAM,CAAU,QAAQ,GAAa,QAAQ,CAAC;IAC9C,MAAM,CAAU,OAAO,GAAW,OAAO,CAAC;IAE1C,wCAAwC;IACxC,MAAM,CAAU,EAAE,CAAW;IAC7B,+DAA+D;IAC/D,MAAM,CAAU,cAAc,CAAiB;IAC/C,wEAAwE;IACxE,MAAM,CAAU,cAAc,CAAiB;IAE/C,MAAM,CAAU,KAAK,GAAU,EAAE,CAAC;IAClC,MAAM,CAAU,eAAe,GAAa,EAAE,CAAC;IAC/C,MAAM,CAAU,YAAY,GAA4B,EAAE,CAAC;IAC3D,MAAM,CAAU,gBAAgB,GAA2B,EAAE,CAAC;IAE9D,+DAA+D;IAC/D,sBAAsB;IACtB,+DAA+D;IAErD,MAAM,CAAgB;IAEhC,YAAY,MAAqB;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,+DAA+D;IAC/D,0BAA0B;IAC1B,+DAA+D;IAE/D;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,OAAsB;QAC9D,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,QAAgB;QACxC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAClB,UAA6B,EAC7B,QAAgB;QAEhB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;;AA/DH,oCAwFC;AAED,kBAAe,YAAY,CAAC"}

package/dist/plugins/pipelines/aws/configs/ec2.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Basic EC2 Configuration
+ *
+ * Simple EC2 instance deployment without additional AWS services.
+ */
+import type { AWSConfigDef } from './types.js';
+declare const ec2Config: AWSConfigDef;
+export default ec2Config;
+//# sourceMappingURL=ec2.d.ts.map

package/dist/plugins/pipelines/aws/configs/ec2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ec2.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/pipelines/aws/configs/ec2.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,QAAA,MAAM,SAAS,EAAE,YA4BhB,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/plugins/pipelines/aws/configs/ec2.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Basic EC2 Configuration
+ *
+ * Simple EC2 instance deployment without additional AWS services.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const ec2Config = {
+    name: 'ec2',
+    description: 'Basic EC2 instance',
+    services: ['ec2'],
+    defaults: {
+        instance_type: 't3.micro',
+        storage: 20, // GB
+        ami_filter: 'ubuntu/images/hvm-ssd/ubuntu-*-22.04-amd64-server-*',
+    },
+    // Additional fixes specific to this config
+    fixes: [],
+    /**
+     * Deploy using this config
+     */
+    async deploy(_config, _environment) {
+        // Basic EC2 deployment - container already pulled from ECR
+        return { success: true };
+    },
+    /**
+     * Scan for issues specific to this config
+     */
+    async scan(_config, _environment) {
+        return [];
+    },
+};
+exports.default = ec2Config;
+//# sourceMappingURL=ec2.js.map

package/dist/plugins/pipelines/aws/configs/ec2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ec2.js","sourceRoot":"","sources":["../../../../../src/plugins/pipelines/aws/configs/ec2.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAKH,MAAM,SAAS,GAAiB;IAC9B,IAAI,EAAE,KAAK;IACX,WAAW,EAAE,oBAAoB;IACjC,QAAQ,EAAE,CAAC,KAAK,CAAC;IAEjB,QAAQ,EAAE;QACR,aAAa,EAAE,UAAU;QACzB,OAAO,EAAE,EAAE,EAAE,KAAK;QAClB,UAAU,EAAE,qDAAqD;KAClE;IAED,2CAA2C;IAC3C,KAAK,EAAE,EAAE;IAET;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,OAAsB,EAAE,YAAoB;QACvD,2DAA2D;QAC3D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,OAAsB,EAAE,YAAoB;QACrD,OAAO,EAAE,CAAC;IACZ,CAAC;CACF,CAAC;AAEF,kBAAe,SAAS,CAAC"}

package/dist/plugins/pipelines/aws/configs/free-tier.d.ts

@@ -0,0 +1,13 @@
+/**
+ * AWS Free Tier Configuration
+ *
+ * Complete free tier bundle with:
+ * - EC2 t2.micro instance
+ * - RDS db.t2.micro database
+ * - S3 bucket for storage
+ * - ECR repository for container images
+ */
+import type { AWSConfigDef } from './types.js';
+declare const freeTierConfig: AWSConfigDef;
+export default freeTierConfig;
+//# sourceMappingURL=free-tier.d.ts.map

package/dist/plugins/pipelines/aws/configs/free-tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"free-tier.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/pipelines/aws/configs/free-tier.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,QAAA,MAAM,cAAc,EAAE,YAoFrB,CAAC;AAEF,eAAe,cAAc,CAAC"}