@ts-cloud/core 0.16.51 → 0.16.53

package/dist/drivers/types.d.ts

@@ -67,6 +67,19 @@ export interface ProvisionComputeOptions {
     config: CloudConfig;
     environment: EnvironmentType;
 }
+export interface ComputeChangePlan {
+    serverId: string;
+    changes: Array<{
+        resource: string;
+        action: string;
+        detail: string;
+    }>;
+    waitingForCapacity?: string;
+}
+export interface ApplyComputeChangesOptions extends ProvisionComputeOptions {
+    /** Plan without provider writes, remote commands, or local state writes. */
+    dryRun?: boolean;
+}
 export interface FindComputeTargetsOptions {
     slug: string;
     environment: EnvironmentType;
@@ -116,6 +129,8 @@ export interface CloudDriver {
     readonly usesCloudFormation: boolean;
     /** Provision compute infrastructure (Hetzner). AWS uses InfrastructureGenerator + CFN. */
     provisionComputeInfrastructure?(options: ProvisionComputeOptions): Promise<ComputeStackOutputs>;
+    /** Apply configured resize, persistent volumes and deployment placement without deploying sites. */
+    applyComputeChanges?(options: ApplyComputeChangesOptions): Promise<ComputeChangePlan>;
     /**
      * Tear down the lightweight single-server compute (instance + security
      * group/firewall + local state) provisioned by

package/dist/types.d.ts

@@ -1717,6 +1717,11 @@ export interface DaemonConfig {
 }
 /** A lifecycle event that can trigger a notification. */
 export type NotifyEvent = 'deploy' | 'deploy-failed' | 'ssl' | 'health' | 'backup';
+/** A literal URL, or a value read on the server without evaluating its env file. */
+export type NotificationEndpoint = string | {
+    envFile: string;
+    variable: string;
+};
 /**
  * Notification channels (Forge-style). Configure any subset; each configured
  * channel receives the events listed in {@link events} (all events by default).
@@ -1724,11 +1729,11 @@ export type NotifyEvent = 'deploy' | 'deploy-failed' | 'ssl' | 'health' | 'backu
 export interface NotificationsConfig {
     /** Slack incoming-webhook URL. */
     slack?: {
-        webhookUrl: string;
+        webhookUrl: NotificationEndpoint;
     };
     /** Discord webhook URL. */
     discord?: {
-        webhookUrl: string;
+        webhookUrl: NotificationEndpoint;
     };
     /** Telegram bot token + chat id. */
     telegram?: {
@@ -3021,6 +3026,23 @@ export interface ContainerItemConfig {
     };
 }
 export interface ComputeConfig {
+    /** Explicitly reconcile an existing Hetzner server's size. Never resize by default. */
+    resize?: {
+        /** Keep serving on the current type when the requested type has no capacity. */
+        whenUnavailable?: 'keep-current' | 'fail';
+        /** Enlarge the primary disk with the server. Cannot be undone. @default true */
+        upgradeDisk?: boolean;
+    };
+    /** Named Hetzner block volumes. Reconciled only by the server owner; host requires Bun. */
+    volumes?: Record<string, ComputeVolumeConfig>;
+    /** Place releases and optional deployment backups on a named volume. */
+    deploymentStorage?: {
+        volume: string;
+        /** Copy existing release trees online, then verify under deployment locks. */
+        migrateExisting?: boolean;
+        /** Include project-level pre-migration backup directories. @default true */
+        includeBackups?: boolean;
+    };
     /**
      * Compute mode: 'server' for EC2, 'serverless' for Fargate/Lambda
      */
@@ -3451,6 +3473,17 @@ export interface ComputeConfig {
      */
     hostCleanup?: boolean | ComputeHostCleanupConfig;
 }
+/** Persistent Linux block storage managed by the compute owner. */
+export interface ComputeVolumeConfig {
+    /** Provider resource name; defaults to <project>-<environment>-<key>. */
+    name?: string;
+    /** Capacity in GB. Existing volumes may grow but never shrink. */
+    size: number;
+    /** Absolute Linux mount path, persisted by filesystem UUID. */
+    mountPath: string;
+    /** Refuse provider-side deletion. @default true */
+    deleteProtection?: boolean;
+}
 /**
  * Retention windows for {@link ComputeConfig.hostCleanup}. Each field is an age
  * past which the matching files are deleted; omit one to keep its default.
@@ -3551,6 +3584,11 @@ export interface SshKeyConfig {
 export interface ComputeMonitoringConfig {
     /** Enable the metrics collector. @default true */
     enabled?: boolean;
+    /** Filesystems to report and alert on. A required mount must be a mount point. */
+    filesystems?: Array<string | {
+        path: string;
+        requiredMount?: boolean;
+    }>;
     /** Alert thresholds; omit a field to keep its default. */
     alerts?: {
         /** Alert when 1-min load average per CPU exceeds this. @default 2 */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ts-cloud/core",
   "type": "module",
-  "version": "0.16.51",
+  "version": "0.16.53",
   "description": "Core CloudFormation generation library for ts-cloud",
   "author": "Chris Breuer <chris@stacksjs.com>",
   "license": "MIT",
@@ -31,7 +31,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@ts-cloud/aws-types": "0.16.51"
+    "@ts-cloud/aws-types": "0.16.53"
   },
   "devDependencies": {
     "typescript": "^7.0.2"