@devalade/shipnode 2.0.0

package/dist/domain/deploy/backend-strategy.js

@@ -0,0 +1,110 @@
+import { execa } from 'execa';
+import { pathExists } from 'fs-extra';
+import { resolve } from 'path';
+import { getInstallCommand, getRunCommand, detectPkgManager } from '../framework/detector.js';
+import { RSYNC_DEFAULT_EXCLUDES } from '../../shared/constants.js';
+export class BackendStrategy {
+    config;
+    cwd;
+    name = 'backend';
+    constructor(config, cwd) {
+        this.config = config;
+        this.cwd = cwd;
+    }
+    async stage(ctx) {
+        const excludes = [...RSYNC_DEFAULT_EXCLUDES];
+        const ignoreFile = resolve(this.cwd, '.shipnodeignore');
+        const hasIgnoreFile = await pathExists(ignoreFile);
+        const args = [
+            '-avz',
+            '--progress',
+            '-e', `ssh -p ${this.config.ssh.port}`,
+            ...excludes.flatMap((e) => ['--exclude', e]),
+            ...(hasIgnoreFile ? ['--exclude-from', ignoreFile] : []),
+            `${this.cwd}/`,
+            `${this.config.ssh.user}@${this.config.ssh.host}:${ctx.workDir}/`,
+        ];
+        await execa('rsync', args);
+    }
+    async setupEnvironment(ctx) {
+        const pkgManager = await this.resolvePkgManager();
+        const installCmd = getInstallCommand(pkgManager);
+        const runCmd = getRunCommand(pkgManager);
+        const commands = [
+            `cd "${ctx.workDir}"`,
+            `export PATH="$HOME/.local/bin:$HOME/.local/share/mise/shims:$PATH"`,
+            `mise use -y "node@${this.config.nodeVersion}"`,
+            `mise install -y`,
+        ];
+        if (this.config.sharedDirs || this.config.sharedFiles) {
+            commands.push(this.getLinkSharedResourcesCommand(ctx.workDir));
+        }
+        if (this.config.envFile) {
+            commands.push(`ln -sf "${this.config.remotePath}/shared/.env" .env`);
+        }
+        commands.push(installCmd);
+        if (!ctx.skipBuild) {
+            commands.push(`if [ -f package.json ] && jq -e '.scripts.build' package.json >/dev/null 2>&1; then ${runCmd} build; fi`);
+        }
+        commands.push(`if [ -d build ] && [ -f .env ]; then ln -sf "${ctx.workDir}/.env" build/.env; fi`);
+        await ctx.executor.exec(commands.join(' && '));
+    }
+    async startApp(ctx) {
+        if (!this.config.pm2)
+            return;
+        const ecosystemContent = this.generateEcosystemFile();
+        const ecosystemPath = this.config.zeroDowntime
+            ? `${this.config.remotePath}/shared/ecosystem.config.cjs`
+            : `${ctx.workDir}/ecosystem.config.cjs`;
+        const escaped = ecosystemContent.replace(/'/g, "'\"'\"'");
+        await ctx.executor.exec(`echo '${escaped}' > "${ecosystemPath}"`);
+        const cdPath = this.config.zeroDowntime ? `${this.config.remotePath}/current` : ctx.workDir;
+        await ctx.executor.exec(`cd "${cdPath}" && ` +
+            `export PATH="$HOME/.local/bin:$HOME/.local/share/mise/shims:$PATH" && ` +
+            `mise exec -- pm2 startOrReload "${ecosystemPath}" --update-env && ` +
+            `mise exec -- pm2 save`);
+    }
+    generateEcosystemFile() {
+        if (!this.config.pm2)
+            return '';
+        const port = this.config.backend?.port ?? 3000;
+        const name = this.config.pm2.name;
+        const instances = this.config.pm2.instances ?? 1;
+        const maxMemory = this.config.pm2.maxMemory ?? '512M';
+        return `module.exports = {
+  apps: [{
+    name: '${name}',
+    script: 'index',
+    instances: ${instances},
+    exec_mode: 'cluster',
+    max_memory_restart: '${maxMemory}',
+    env: {
+      NODE_ENV: 'production',
+      PORT: ${port},
+    },
+  }],
+};`;
+    }
+    getLinkSharedResourcesCommand(workDir) {
+        const commands = [];
+        if (this.config.sharedDirs) {
+            for (const dir of this.config.sharedDirs) {
+                commands.push(`mkdir -p "${this.config.remotePath}/shared/${dir}"`);
+                commands.push(`ln -sfn "${this.config.remotePath}/shared/${dir}" "${workDir}/${dir}"`);
+            }
+        }
+        if (this.config.sharedFiles) {
+            for (const file of this.config.sharedFiles) {
+                commands.push(`ln -sf "${this.config.remotePath}/shared/${file}" "${workDir}/${file}"`);
+            }
+        }
+        return commands.join(' && ');
+    }
+    async resolvePkgManager() {
+        if (this.config.pkgManager)
+            return this.config.pkgManager;
+        const detected = await detectPkgManager(this.cwd);
+        return detected ?? 'npm';
+    }
+}
+//# sourceMappingURL=backend-strategy.js.map

package/dist/domain/deploy/backend-strategy.js.map

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

package/dist/domain/deploy/frontend-strategy.d.ts

@@ -0,0 +1,13 @@
+import type { ShipnodeConfig } from '../../shared/types.js';
+import type { DeploymentStrategy, StrategyContext } from './strategy.js';
+export declare class FrontendStrategy implements DeploymentStrategy {
+    private config;
+    private cwd;
+    readonly name = "frontend";
+    constructor(config: ShipnodeConfig, cwd: string);
+    stage(ctx: StrategyContext): Promise<void>;
+    private buildFrontend;
+    private detectFrontendBuildDir;
+    private resolvePkgManager;
+}
+//# sourceMappingURL=frontend-strategy.d.ts.map

package/dist/domain/deploy/frontend-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend-strategy.d.ts","sourceRoot":"","sources":["../../../src/domain/deploy/frontend-strategy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEzE,qBAAa,gBAAiB,YAAW,kBAAkB;IAIvD,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,GAAG;IAJb,QAAQ,CAAC,IAAI,cAAc;gBAGjB,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,MAAM;IAGf,KAAK,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;YAwBlC,aAAa;YAUb,sBAAsB;YAWtB,iBAAiB;CAKhC"}

package/dist/domain/deploy/frontend-strategy.js

@@ -0,0 +1,64 @@
+import { execa } from 'execa';
+import { pathExists } from 'fs-extra';
+import { resolve } from 'path';
+import { getRunCommand, detectPkgManager } from '../framework/detector.js';
+export class FrontendStrategy {
+    config;
+    cwd;
+    name = 'frontend';
+    constructor(config, cwd) {
+        this.config = config;
+        this.cwd = cwd;
+    }
+    async stage(ctx) {
+        if (!ctx.skipBuild) {
+            await this.buildFrontend();
+        }
+        const buildDir = await this.detectFrontendBuildDir();
+        const ignoreFile = resolve(this.cwd, '.shipnodeignore');
+        const hasIgnoreFile = await pathExists(ignoreFile);
+        await execa('rsync', [
+            '-avz',
+            '--progress',
+            '--delete',
+            '-e', `ssh -p ${this.config.ssh.port}`,
+            '--exclude', 'shared/',
+            '--exclude', '.shipnode/',
+            '--exclude', 'releases/',
+            '--exclude', 'current',
+            ...(hasIgnoreFile ? ['--exclude-from', ignoreFile] : []),
+            `${this.cwd}/${buildDir}/`,
+            `${this.config.ssh.user}@${this.config.ssh.host}:${ctx.workDir}/`,
+        ]);
+    }
+    async buildFrontend() {
+        const pkgManager = await this.resolvePkgManager();
+        const runCmd = getRunCommand(pkgManager);
+        await execa(runCmd.split(' ')[0], [...runCmd.split(' ').slice(1), 'build'], {
+            cwd: this.cwd,
+            stdio: 'inherit',
+        });
+    }
+    async detectFrontendBuildDir() {
+        if (this.config.buildDir)
+            return this.config.buildDir;
+        if (await pathExists(`${this.cwd}/build`))
+            return 'build';
+        if (await pathExists(`${this.cwd}/public`))
+            return 'public';
+        if (await pathExists(`${this.cwd}/dist`))
+            return 'dist';
+        if (await pathExists(`${this.cwd}/out`))
+            return 'out';
+        if (await pathExists(`${this.cwd}/.output`))
+            return '.output';
+        return 'dist';
+    }
+    async resolvePkgManager() {
+        if (this.config.pkgManager)
+            return this.config.pkgManager;
+        const detected = await detectPkgManager(this.cwd);
+        return detected ?? 'npm';
+    }
+}
+//# sourceMappingURL=frontend-strategy.js.map

package/dist/domain/deploy/frontend-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend-strategy.js","sourceRoot":"","sources":["../../../src/domain/deploy/frontend-strategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG3E,MAAM,OAAO,gBAAgB;IAIjB;IACA;IAJD,IAAI,GAAG,UAAU,CAAC;IAE3B,YACU,MAAsB,EACtB,GAAW;QADX,WAAM,GAAN,MAAM,CAAgB;QACtB,QAAG,GAAH,GAAG,CAAQ;IAClB,CAAC;IAEJ,KAAK,CAAC,KAAK,CAAC,GAAoB;QAC9B,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC7B,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,sBAAsB,EAAE,CAAC;QACrD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;QACxD,MAAM,aAAa,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;QAEnD,MAAM,KAAK,CAAC,OAAO,EAAE;YACnB,MAAM;YACN,YAAY;YACZ,UAAU;YACV,IAAI,EAAE,UAAU,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE;YACtC,WAAW,EAAE,SAAS;YACtB,WAAW,EAAE,YAAY;YACzB,WAAW,EAAE,WAAW;YACxB,WAAW,EAAE,SAAS;YACtB,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG,IAAI,CAAC,GAAG,IAAI,QAAQ,GAAG;YAC1B,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,GAAG;SAClE,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAClD,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;QAEzC,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE;YAC1E,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,sBAAsB;QAClC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;QACtD,IAAI,MAAM,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,QAAQ,CAAC;YAAE,OAAO,OAAO,CAAC;QAC1D,IAAI,MAAM,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;YAAE,OAAO,QAAQ,CAAC;QAC5D,IAAI,MAAM,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC;YAAE,OAAO,MAAM,CAAC;QACxD,IAAI,MAAM,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QACtD,IAAI,MAAM,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,UAAU,CAAC;YAAE,OAAO,SAAS,CAAC;QAE9D,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,iBAAiB;QAC7B,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;QAC1D,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,OAAO,QAAQ,IAAI,KAAK,CAAC;IAC3B,CAAC;CACF"}

package/dist/domain/deploy/orchestrator.d.ts

@@ -0,0 +1,34 @@
+import type { ShipnodeConfig } from '../../shared/types.js';
+import type { RemoteExecutor } from '../remote/executor.js';
+import { ReleaseManager, DeployLock } from '../release/manager.js';
+import { HealthCheckService } from '../../services/health.service.js';
+import { CaddyService } from '../../services/caddy.service.js';
+import type { DeploymentStrategy } from './strategy.js';
+/**
+ * The release orchestrator owns the invariant deployment sequence.
+ *
+ * It knows nothing about app-specific details (those live in the
+ * DeploymentStrategy). It knows everything about lock management,
+ * release directories, symlinks, health checks, hooks, and cleanup.
+ *
+ * This is a deep module: a small interface (`deploy`) hides a lot of
+ * behaviour (the full zero-downtime or legacy lifecycle).
+ */
+export declare class DeployOrchestrator {
+    private config;
+    private executor;
+    private releases;
+    private lock;
+    private healthCheck;
+    private caddy;
+    constructor(config: ShipnodeConfig, executor: RemoteExecutor, releases: ReleaseManager, lock: DeployLock, healthCheck: HealthCheckService, caddy: CaddyService);
+    deploy(strategy: DeploymentStrategy, options: {
+        cwd: string;
+        skipBuild: boolean;
+        gitCommit?: string;
+    }): Promise<void>;
+    private deployZeroDowntime;
+    private deployLegacy;
+    private runHook;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/domain/deploy/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/domain/deploy/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAE/D,OAAO,KAAK,EAAE,kBAAkB,EAAmB,MAAM,eAAe,CAAC;AAEzE;;;;;;;;;GASG;AACH,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,KAAK;gBALL,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,UAAU,EAChB,WAAW,EAAE,kBAAkB,EAC/B,KAAK,EAAE,YAAY;IAGvB,MAAM,CACV,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/D,OAAO,CAAC,IAAI,CAAC;YAQF,kBAAkB;YA4ElB,YAAY;YA8CZ,OAAO;CAmBtB"}

package/dist/domain/deploy/orchestrator.js

@@ -0,0 +1,149 @@
+import { DeployError } from '../../shared/errors.js';
+/**
+ * The release orchestrator owns the invariant deployment sequence.
+ *
+ * It knows nothing about app-specific details (those live in the
+ * DeploymentStrategy). It knows everything about lock management,
+ * release directories, symlinks, health checks, hooks, and cleanup.
+ *
+ * This is a deep module: a small interface (`deploy`) hides a lot of
+ * behaviour (the full zero-downtime or legacy lifecycle).
+ */
+export class DeployOrchestrator {
+    config;
+    executor;
+    releases;
+    lock;
+    healthCheck;
+    caddy;
+    constructor(config, executor, releases, lock, healthCheck, caddy) {
+        this.config = config;
+        this.executor = executor;
+        this.releases = releases;
+        this.lock = lock;
+        this.healthCheck = healthCheck;
+        this.caddy = caddy;
+    }
+    async deploy(strategy, options) {
+        if (this.config.zeroDowntime) {
+            await this.deployZeroDowntime(strategy, options);
+        }
+        else {
+            await this.deployLegacy(strategy, options);
+        }
+    }
+    async deployZeroDowntime(strategy, options) {
+        const deployStart = Date.now();
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        await this.lock.acquire();
+        try {
+            const releasePath = await this.releases.createReleasePath(timestamp);
+            await this.releases.setupReleaseStructure();
+            const ctx = {
+                config: this.config,
+                executor: this.executor,
+                workDir: releasePath,
+                cwd: options.cwd,
+                skipBuild: options.skipBuild,
+            };
+            await strategy.stage(ctx);
+            if (strategy.setupEnvironment) {
+                await strategy.setupEnvironment(ctx);
+            }
+            await this.runHook('preDeploy');
+            await this.releases.switchSymlink(releasePath);
+            if (strategy.startApp) {
+                const startCtx = {
+                    ...ctx,
+                    workDir: `${this.config.remotePath}/current`,
+                };
+                await strategy.startApp(startCtx);
+            }
+            let healthAttempts;
+            let healthResponseMs;
+            if (this.config.app === 'backend' && this.config.healthCheck.enabled) {
+                const healthResult = await this.healthCheck.perform();
+                healthAttempts = healthResult.attempts;
+                healthResponseMs = healthResult.responseMs;
+            }
+            const duration = Math.round((Date.now() - deployStart) / 1000);
+            await this.releases.recordRelease({
+                timestamp,
+                status: 'success',
+                duration,
+                gitCommit: options.gitCommit,
+                healthAttempts,
+                healthResponseMs,
+            });
+            await this.runHook('postDeploy');
+            await this.releases.cleanupOldReleases();
+            if (this.config.domain) {
+                if (this.config.app === 'backend') {
+                    await this.caddy.configureBackend();
+                }
+                else {
+                    await this.caddy.configureFrontend();
+                }
+            }
+        }
+        catch (error) {
+            await this.lock.release();
+            throw error;
+        }
+        await this.lock.release();
+    }
+    async deployLegacy(strategy, options) {
+        const deployStart = Date.now();
+        const ctx = {
+            config: this.config,
+            executor: this.executor,
+            workDir: this.config.remotePath,
+            cwd: options.cwd,
+            skipBuild: options.skipBuild,
+        };
+        await strategy.stage(ctx);
+        if (strategy.setupEnvironment) {
+            await strategy.setupEnvironment(ctx);
+        }
+        await this.runHook('preDeploy');
+        if (strategy.startApp) {
+            await strategy.startApp(ctx);
+        }
+        const duration = Math.round((Date.now() - deployStart) / 1000);
+        await this.releases.recordRelease({
+            timestamp: new Date().toISOString().replace(/[:.]/g, '-'),
+            status: 'success',
+            duration,
+            gitCommit: options.gitCommit,
+        });
+        await this.runHook('postDeploy');
+        if (this.config.domain) {
+            if (this.config.app === 'backend') {
+                await this.caddy.configureBackend();
+            }
+            else {
+                await this.caddy.configureFrontend();
+            }
+        }
+    }
+    async runHook(hookName) {
+        const hook = this.config.hooks?.[hookName];
+        if (!hook)
+            return;
+        const ctx = {
+            config: this.config,
+            env: 'production',
+            exec: async (cmd) => {
+                return this.executor.exec(cmd);
+            },
+        };
+        try {
+            await hook(ctx);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new DeployError(`${hookName} hook failed: ${message}`, hookName);
+        }
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/domain/deploy/orchestrator.js.map

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

package/dist/domain/deploy/strategy.d.ts

@@ -0,0 +1,44 @@
+import type { RemoteExecutor } from '../remote/executor.js';
+/**
+ * Context passed to every deployment strategy method.
+ */
+export interface StrategyContext {
+    config: import('../../shared/types.js').ShipnodeConfig;
+    executor: RemoteExecutor;
+    workDir: string;
+    cwd: string;
+    skipBuild: boolean;
+}
+/**
+ * A deployment strategy knows how to stage, prepare, and start
+ * a specific kind of application (backend, frontend, etc.).
+ *
+ * Strategies are adapters at the deployment seam. The orchestrator
+ * owns the invariant lifecycle; the strategy owns the app-specific
+ * details.
+ */
+export interface DeploymentStrategy {
+    readonly name: string;
+    /**
+     * Stage artifacts onto the remote host.
+     *
+     * For a backend this usually means rsyncing source files.
+     * For a frontend this means building locally and rsyncing build output.
+     */
+    stage(ctx: StrategyContext): Promise<void>;
+    /**
+     * Prepare the runtime environment on the remote host.
+     *
+     * Optional. For backends this is typically dependency installation
+     * and remote builds. For static frontends this is usually a no-op.
+     */
+    setupEnvironment?(ctx: StrategyContext): Promise<void>;
+    /**
+     * Start or reload the application.
+     *
+     * Optional. For backend apps this means reloading PM2.
+     * For static frontends this is usually a no-op (Caddy serves files).
+     */
+    startApp?(ctx: StrategyContext): Promise<void>;
+}
+//# sourceMappingURL=strategy.d.ts.map

package/dist/domain/deploy/strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../../src/domain/deploy/strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,uBAAuB,EAAE,cAAc,CAAC;IACvD,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,KAAK,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C;;;;;OAKG;IACH,gBAAgB,CAAC,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD"}

package/dist/domain/deploy/strategy.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=strategy.js.map

package/dist/domain/deploy/strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.js","sourceRoot":"","sources":["../../../src/domain/deploy/strategy.ts"],"names":[],"mappings":""}

package/dist/domain/framework/detector.d.ts

@@ -0,0 +1,7 @@
+import type { FrameworkDetectionResult, PkgManager } from '../../shared/types.js';
+export declare function parsePackageJson(cwd: string): Promise<Record<string, string> | null>;
+export declare function detectPkgManager(cwd: string): Promise<PkgManager | null>;
+export declare function detectFramework(cwd: string): Promise<FrameworkDetectionResult>;
+export declare function getInstallCommand(pkgManager: PkgManager): string;
+export declare function getRunCommand(pkgManager: PkgManager): string;
+//# sourceMappingURL=detector.d.ts.map

package/dist/domain/framework/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/domain/framework/detector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGlF,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,CAe1F;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAc9E;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAkBpF;AA0DD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAEhE;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAE5D"}

package/dist/domain/framework/detector.js

@@ -0,0 +1,109 @@
+import { readFile } from 'fs/promises';
+import { resolve } from 'path';
+import { pathExists } from 'fs-extra';
+import { FRAMEWORK_PATTERNS, PKG_MANAGER_COMMANDS } from '../../shared/constants.js';
+export async function parsePackageJson(cwd) {
+    const pkgPath = resolve(cwd, 'package.json');
+    const exists = await pathExists(pkgPath);
+    if (!exists)
+        return null;
+    try {
+        const content = await readFile(pkgPath, 'utf-8');
+        const pkg = JSON.parse(content);
+        return {
+            ...(pkg.dependencies ?? {}),
+            ...(pkg.devDependencies ?? {}),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export async function detectPkgManager(cwd) {
+    const lockFiles = [
+        ['bun.lockb', 'bun'],
+        ['bun.lock', 'bun'],
+        ['pnpm-lock.yaml', 'pnpm'],
+        ['yarn.lock', 'yarn'],
+        ['package-lock.json', 'npm'],
+    ];
+    for (const [file, pm] of lockFiles) {
+        if (await pathExists(resolve(cwd, file)))
+            return pm;
+    }
+    return null;
+}
+export async function detectFramework(cwd) {
+    const deps = await parsePackageJson(cwd);
+    if (!deps) {
+        return { name: 'unknown', appType: 'unknown' };
+    }
+    const depKeys = Object.keys(deps);
+    for (const [name, pattern] of Object.entries(FRAMEWORK_PATTERNS)) {
+        const matched = pattern.deps.some((d) => depKeys.some((k) => k === d || k.startsWith(d)));
+        if (matched) {
+            const port = await detectPortFromScripts(cwd);
+            const orm = await detectOrm(cwd);
+            return { name, appType: pattern.appType, port, orm };
+        }
+    }
+    return { name: 'unknown', appType: 'unknown' };
+}
+async function detectPortFromScripts(cwd) {
+    const pkgPath = resolve(cwd, 'package.json');
+    const exists = await pathExists(pkgPath);
+    if (!exists)
+        return undefined;
+    try {
+        const content = await readFile(pkgPath, 'utf-8');
+        const pkg = JSON.parse(content);
+        const scripts = [pkg.scripts?.start, pkg.scripts?.dev].filter(Boolean).join(' ');
+        const patterns = [
+            /PORT=(\d+)/,
+            /--port[= ](\d+)/,
+            /(?:localhost|127\.0\.0\.1):(\d+)/,
+            /listen\(['"]?:(\d+)/,
+        ];
+        for (const pattern of patterns) {
+            const match = scripts.match(pattern);
+            if (match) {
+                const port = parseInt(match[1], 10);
+                if (port >= 1 && port <= 65535)
+                    return port;
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    return undefined;
+}
+async function detectOrm(cwd) {
+    const deps = await parsePackageJson(cwd);
+    if (!deps)
+        return undefined;
+    const depKeys = Object.keys(deps);
+    const ormMap = {
+        'prisma': 'Prisma',
+        '@prisma/client': 'Prisma',
+        'drizzle-orm': 'Drizzle',
+        'typeorm': 'TypeORM',
+        'sequelize': 'Sequelize',
+        'knex': 'Knex',
+        'mongoose': 'Mongoose',
+        '@adonisjs/lucid': 'AdonisJS Lucid',
+    };
+    for (const [dep, orm] of Object.entries(ormMap)) {
+        if (depKeys.some((k) => k === dep || k.startsWith(dep))) {
+            return orm;
+        }
+    }
+    return undefined;
+}
+export function getInstallCommand(pkgManager) {
+    return PKG_MANAGER_COMMANDS[pkgManager]?.install ?? 'npm ci --production';
+}
+export function getRunCommand(pkgManager) {
+    return PKG_MANAGER_COMMANDS[pkgManager]?.run ?? 'npm run';
+}
+//# sourceMappingURL=detector.js.map

package/dist/domain/framework/detector.js.map

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

package/dist/domain/release/manager.d.ts

@@ -0,0 +1,22 @@
+import type { ReleaseRecord } from '../../shared/types.js';
+import type { RemoteExecutor } from '../../domain/remote/executor.js';
+export declare class ReleaseManager {
+    private executor;
+    private remotePath;
+    private keepReleases;
+    constructor(executor: RemoteExecutor, remotePath: string, keepReleases: number);
+    createReleasePath(timestamp: string): Promise<string>;
+    setupReleaseStructure(): Promise<void>;
+    switchSymlink(releasePath: string): Promise<void>;
+    recordRelease(record: ReleaseRecord): Promise<void>;
+    cleanupOldReleases(): Promise<void>;
+    listReleases(): Promise<ReleaseRecord[]>;
+}
+export declare class DeployLock {
+    private executor;
+    private remotePath;
+    constructor(executor: RemoteExecutor, remotePath: string);
+    acquire(): Promise<void>;
+    release(): Promise<void>;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/domain/release/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/domain/release/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGtE,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,YAAY;gBAFZ,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM;IAGxB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMrD,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtC,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjD,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBnD,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBnC,YAAY,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;CAS/C;AAED,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,UAAU;gBADV,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,MAAM;IAGtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAM/B"}