@stacksjs/ts-cloud 0.5.30 → 0.5.32

package/dist/drivers/shared/app-frameworks.d.ts

@@ -0,0 +1,50 @@
+/**
+ * App-framework drivers.
+ *
+ * ts-cloud runs a site's background work — the scheduler, queue workers, and
+ * daemons — as systemd units / cron on the box. HOW those are invoked differs
+ * per app framework: Stacks (Bun, `buddy …`) vs Laravel (PHP, `artisan …`), and
+ * the runtime environment a systemd/cron process needs differs too (bun on PATH
+ * vs pantry's php env). This module isolates those differences behind one small
+ * driver so the reconciler (`app-services.ts`) stays framework-agnostic.
+ *
+ * Stacks-first: `getAppFrameworkDriver()` defaults to the Stacks driver.
+ */
+import type { QueueWorkerConfig, SiteConfig } from '@ts-cloud/core';
+export type FrameworkId = 'stacks' | 'laravel';
+/**
+ * Resolve which framework driver a site uses. An explicit `framework` wins; a
+ * PHP-oriented `type` (laravel/php/statamic/wordpress) implies Laravel for
+ * backward compatibility; everything else uses the Stacks-first default.
+ */
+export declare function resolveSiteFramework(site: Pick<SiteConfig, 'framework' | 'type'>): FrameworkId;
+export interface FrameworkExecContext {
+    /** The active-release directory (`/var/www/<site>/current`). */
+    current: string;
+}
+export interface AppFrameworkDriver {
+    readonly id: FrameworkId;
+    /**
+     * Wrap a bare command so a systemd unit / cron entry runs it with the
+     * framework's runtime on PATH (systemd units inherit no shell env).
+     */
+    wrapExec: (command: string) => string;
+    /**
+     * The command cron runs every minute to fire due scheduled tasks. Includes
+     * its own env setup + output redirection; the reconciler may append a
+     * heartbeat ping with `&&`.
+     */
+    schedulerCommand: (ctx: FrameworkExecContext) => string;
+    /** `ExecStart` for a single queue-worker process. */
+    queueWorkerCommand: (worker: QueueWorkerConfig, ctx: FrameworkExecContext) => string;
+}
+/**
+ * Stacks (Bun) — the default. The scheduler is cron-driven (`buddy schedule:run`
+ * is one-shot); queue workers are long-running (`buddy queue:work`). bun lives
+ * at an absolute path installed by the box bootstrap.
+ */
+export declare const stacksDriver: AppFrameworkDriver;
+/** Laravel (PHP / Artisan) — the original Forge-style behavior, now a driver. */
+export declare const laravelDriver: AppFrameworkDriver;
+/** Resolve the app-framework driver for a site. Stacks-first default. */
+export declare function getAppFrameworkDriver(framework?: FrameworkId): AppFrameworkDriver;

package/dist/drivers/shared/{laravel-services.d.ts → app-services.d.ts}

@@ -1,8 +1,12 @@
 /**
- * Generate the per-site runtime services for a Forge-style PHP box: queue
- * workers / Horizon (systemd), the Laravel scheduler (cron), and arbitrary
- * daemons (systemd). Reconciled on every deploy so units track the config —
- * units no longer in the config are stopped and removed.
+ * Generate the per-site runtime services for a server-app box: queue workers
+ * (systemd), the app scheduler (cron), and arbitrary daemons (systemd).
+ * Reconciled on every deploy so units track the config — units no longer in the
+ * config are stopped and removed.
+ *
+ * HOW the scheduler + queue workers are invoked (Stacks/Bun vs Laravel/PHP) is
+ * delegated to an {@link AppFrameworkDriver} selected by `site.framework`
+ * (Stacks-first default). This file only owns unit/cron plumbing + pruning.
  *
  * Unit naming (so a site's units can be globbed for pruning):
  *   <slug>-<site>-queue-<i>.service
@@ -13,18 +17,21 @@
  * so workers/daemons always run the live code; `queue:restart` (run by the
  * deploy's $RESTART_QUEUES macro) cycles them onto the new release.
  */
-import type { DaemonConfig, SiteConfig } from '@ts-cloud/core';
+import type { SiteConfig } from '@ts-cloud/core';
 export interface SiteServicesOptions {
     slug: string;
     siteName: string;
     site: SiteConfig;
-    /** PHP version selecting the `phpX.Y` binary. @default '8.3' */
+    /** PHP version selecting the `phpX.Y` binary (Laravel only). @default '8.3' */
     phpVersion?: string;
     /** Site base dir. @default `/var/www/<siteName>` */
     appBase?: string;
 }
 export declare function queueUnitName(slug: string, siteName: string, index: number): string;
-export declare function daemonUnitName(slug: string, siteName: string, daemon: DaemonConfig, index: number): string;
+export declare function daemonUnitName(slug: string, siteName: string, daemon: {
+    name?: string;
+    command: string;
+}, index: number): string;
 /** Path of the scheduler cron file for a site. */
 export declare function schedulerCronPath(slug: string, siteName: string): string;
 /**

package/dist/index.js

@@ -86906,13 +86906,23 @@ class HetznerDriver {
   }
   async findComputeTargets(options) {
     const servers = await this.client.listServers();
-    return servers.filter((server) => matchesTsCloudLabels(server.labels, options.slug, options.environment, options.role || "app")).map((server) => ({
+    const role = options.role || "app";
+    const toTarget = (server) => ({
       id: String(server.id),
       name: server.name,
       publicIp: server.public_net.ipv4?.ip,
       privateIp: server.private_net?.[0]?.ip,
       status: server.status
-    }));
+    });
+    const exact = servers.filter((server) => matchesTsCloudLabels(server.labels, options.slug, options.environment, role));
+    if (exact.length > 0)
+      return exact.map(toTarget);
+    if (role === "app") {
+      const candidates = servers.filter((server) => server.status !== "off" && server.labels?.[`${TS_CLOUD_LABEL_PREFIX}/managed-by`] === "ts-cloud" && server.labels?.[`${TS_CLOUD_LABEL_PREFIX}/environment`] === options.environment && server.labels?.[`${TS_CLOUD_LABEL_PREFIX}/role`] === "app");
+      if (candidates.length === 1)
+        return candidates.map(toTarget);
+    }
+    return [];
   }
   async runRemoteDeploy(options) {
     if (options.targets.length === 0) {
@@ -86979,7 +86989,17 @@ class HetznerDriver {
   }
   async findExistingServer(slug, environment, serverName) {
     const servers = await this.client.listServers();
-    return servers.find((server) => matchesTsCloudLabels(server.labels, slug, environment, "app") || server.name === serverName);
+    const exact = servers.find((server) => matchesTsCloudLabels(server.labels, slug, environment, "app") || server.name === serverName);
+    if (exact)
+      return exact;
+    const candidates = servers.filter((server) => server.status !== "off" && server.labels?.[`${TS_CLOUD_LABEL_PREFIX}/managed-by`] === "ts-cloud" && server.labels?.[`${TS_CLOUD_LABEL_PREFIX}/environment`] === environment && server.labels?.[`${TS_CLOUD_LABEL_PREFIX}/role`] === "app");
+    if (candidates.length === 1) {
+      const adopted = candidates[0];
+      const adoptedProject = adopted.labels?.[`${TS_CLOUD_LABEL_PREFIX}/project`] ?? "unknown";
+      console.warn(`[ts-cloud] No server named '${serverName}' found; adopting existing ts-cloud app server ` + `'${adopted.name}' (project label '${adoptedProject}') for project '${slug}' — ` + `updating it in place instead of provisioning a new server.`);
+      return adopted;
+    }
+    return;
   }
   async ensureFirewall(name, labels, rules) {
     const existing = await this.client.listFirewalls();
@@ -87709,11 +87729,67 @@ function buildLaravelDeployScript(options) {
   return out;
 }
 
-// src/drivers/shared/laravel-services.ts
+// src/drivers/shared/app-frameworks.ts
+var PHP_SITE_TYPES2 = new Set(["laravel", "php", "statamic", "wordpress"]);
+function resolveSiteFramework(site) {
+  if (site.framework)
+    return site.framework;
+  if (site.type && PHP_SITE_TYPES2.has(site.type))
+    return "laravel";
+  return "stacks";
+}
 var PANTRY_ENV_EVAL = `eval "$(cd ${PANTRY_PROJECT_DIR} && pantry env 2>/dev/null)"`;
-function pantryExec(cmd) {
-  return `/bin/sh -lc '${PANTRY_ENV_EVAL}; exec ${cmd}'`;
+var BUN_BIN = "/usr/local/bin/bun";
+var STACKS_CLI = "storage/framework/core/buddy/src/cli.ts";
+function bunEnvWrap(command) {
+  return `/bin/sh -lc 'export PATH="/usr/local/bin:$PATH"; export BUN_INSTALL="/root/.bun"; exec ${command}'`;
+}
+var stacksDriver = {
+  id: "stacks",
+  wrapExec: bunEnvWrap,
+  schedulerCommand: ({ current }) => `cd ${current} && ${BUN_BIN} ${STACKS_CLI} schedule:run >> /dev/null 2>&1`,
+  queueWorkerCommand: (worker, { current }) => {
+    const flags = [
+      `--queue=${worker.queue || "default"}`,
+      `--sleep=${worker.sleep ?? 3}`,
+      `--tries=${worker.tries ?? 3}`,
+      `--timeout=${worker.timeout ?? 60}`
+    ];
+    return `${BUN_BIN} ${current}/${STACKS_CLI} queue:work ${flags.join(" ")}`;
+  }
+};
+var laravelDriver = {
+  id: "laravel",
+  wrapExec: (command) => `/bin/sh -lc '${PANTRY_ENV_EVAL}; exec ${command}'`,
+  schedulerCommand: ({ current }) => `cd ${current} && ${PANTRY_ENV_EVAL} && php artisan schedule:run >> /dev/null 2>&1`,
+  queueWorkerCommand: (worker, { current }) => {
+    const artisan = `${current}/artisan`;
+    if (worker.horizon)
+      return `php ${artisan} horizon`;
+    const flags = [
+      worker.connection || "default",
+      `--queue=${worker.queue || "default"}`,
+      `--sleep=${worker.sleep ?? 3}`,
+      `--tries=${worker.tries ?? 3}`,
+      `--timeout=${worker.timeout ?? 60}`,
+      `--memory=${worker.memory ?? 128}`
+    ];
+    if (worker.maxJobs)
+      flags.push(`--max-jobs=${worker.maxJobs}`);
+    if (worker.maxTime)
+      flags.push(`--max-time=${worker.maxTime}`);
+    return `php ${artisan} queue:work ${flags.join(" ")}`;
+  }
+};
+var DRIVERS = {
+  stacks: stacksDriver,
+  laravel: laravelDriver
+};
+function getAppFrameworkDriver(framework) {
+  return DRIVERS[framework] ?? stacksDriver;
 }
+
+// src/drivers/shared/app-services.ts
 function reEscape(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -87729,23 +87805,6 @@ function queueUnitName(slug, siteName, index) {
 function daemonUnitName(slug, siteName, daemon, index) {
   return `${slug}-${siteName}-daemon-${daemon.name ? slugify(daemon.name) : slugify(daemon.command).slice(0, 32) || String(index)}`;
 }
-function queueExecStart(worker, phpBin, artisan) {
-  if (worker.horizon)
-    return `${phpBin} ${artisan} horizon`;
-  const flags = [
-    worker.connection || "default",
-    `--queue=${worker.queue || "default"}`,
-    `--sleep=${worker.sleep ?? 3}`,
-    `--tries=${worker.tries ?? 3}`,
-    `--timeout=${worker.timeout ?? 60}`,
-    `--memory=${worker.memory ?? 128}`
-  ];
-  if (worker.maxJobs)
-    flags.push(`--max-jobs=${worker.maxJobs}`);
-  if (worker.maxTime)
-    flags.push(`--max-time=${worker.maxTime}`);
-  return `${phpBin} ${artisan} queue:work ${flags.join(" ")}`;
-}
 function systemdUnit(opts) {
   const lines = [
     "[Unit]",
@@ -87780,10 +87839,10 @@ function schedulerCronPath(slug, siteName) {
 }
 function buildSiteServicesScript(options) {
   const { slug, siteName, site } = options;
-  const phpBin = "php";
   const base = options.appBase ?? `/var/www/${siteName}`;
   const current = `${base}/current`;
-  const artisan = `${current}/artisan`;
+  const driver = getAppFrameworkDriver(resolveSiteFramework(site));
+  const ctx = { current };
   const out = [];
   const desiredUnits = [];
   const queues = site.queues || [];
@@ -87795,7 +87854,7 @@ function buildSiteServicesScript(options) {
       out.push(...writeUnitScript(name, systemdUnit({
         description: `${siteName} queue worker ${qIndex}.${p} (managed by ts-cloud)`,
         workingDir: current,
-        execStart: pantryExec(queueExecStart(worker, phpBin, artisan)),
+        execStart: driver.wrapExec(driver.queueWorkerCommand(worker, ctx)),
         stopWaitSecs: worker.stopWaitSecs ?? 90
       })));
     }
@@ -87809,7 +87868,7 @@ function buildSiteServicesScript(options) {
       out.push(...writeUnitScript(name, systemdUnit({
         description: `${siteName} daemon ${daemon.name || daemon.command} (managed by ts-cloud)`,
         workingDir: daemon.directory || current,
-        execStart: pantryExec(daemon.command),
+        execStart: driver.wrapExec(daemon.command),
         restart: daemon.restart,
         user: daemon.user
       })));
@@ -87825,7 +87884,7 @@ function buildSiteServicesScript(options) {
   const schedulerEnabled = scheduler2 === true || typeof scheduler2 === "object" && scheduler2 !== null;
   if (schedulerEnabled) {
     const heartbeat = typeof scheduler2 === "object" && scheduler2 !== null ? scheduler2 : undefined;
-    let command = `cd ${current} && ${PANTRY_ENV_EVAL} && ${phpBin} artisan schedule:run >> /dev/null 2>&1`;
+    let command = driver.schedulerCommand(ctx);
     if (heartbeat?.heartbeatUrl) {
       const method = heartbeat.heartbeatMethod || "GET";
       const methodFlag = method === "GET" ? "" : `-X ${method} `;