@ts-cloud/core 0.7.33 → 0.7.35

package/dist/drivers/types.d.ts

@@ -1,5 +1,12 @@
 import type { CloudConfig, EnvironmentType, SiteConfig } from '../types';
 export type CloudProviderName = 'aws' | 'hetzner';
+/**
+ * Exhaustive provider map. Provider-specific contract tests key off this type,
+ * so adding a provider without adding its resilience coverage is a type error.
+ */
+export type CloudProviderContract<T> = {
+    [Provider in CloudProviderName]: T;
+};
 export interface ComputeTarget {
     id: string;
     name?: string;

package/dist/types.d.ts

@@ -2289,6 +2289,17 @@ export interface ComputeConfig {
         /** Enable encryption @default true */
         encrypted?: boolean;
     };
+    /**
+     * Swapfile size in GB, provisioned at first boot (cloud-init / UserData).
+     * Small shared boxes run several tenants + services with no swap at all, so
+     * a memory spike (deploy, `bun install`, on-box builds) leaves the kernel
+     * OOM killer picking victims box-wide. A modest swapfile — with a low
+     * `vm.swappiness` of 10 persisted via `/etc/sysctl.d` — gives the kernel
+     * headroom without trading responsiveness. The setup is idempotent and
+     * skipped when the box already has `/swapfile` active. Set `0` to disable
+     * (no swap provisioned). @default 2
+     */
+    swapGb?: number;
     /**
      * SSH key name for instance access
      */
@@ -2571,6 +2582,24 @@ export interface ComputeProxyConfig {
      * upstream; omit to use rpx's built-in default (256).
      */
     maxUpstreamConns?: number;
+    /**
+     * systemd `MemoryHigh` for the `rpx-gateway.service` unit — the soft limit at
+     * which the kernel starts reclaiming the gateway's memory (throttling it
+     * before the hard limit trips). On a shared, swap-light box this matters: the
+     * gateway's own cgroup is squeezed first instead of memory pressure building
+     * until the box-wide OOM killer picks an arbitrary victim (a tenant app,
+     * postgres). Accepts systemd size values (`512M`, `1G`, …). @default '512M'
+     */
+    memoryHigh?: string;
+    /**
+     * systemd `MemoryMax` for the `rpx-gateway.service` unit — the hard limit.
+     * Crossing it invokes the OOM killer INSIDE the gateway's cgroup, so the
+     * gateway itself is the deliberate victim and the unit's `Restart=always`
+     * brings it right back — a controlled blip instead of the kernel killing a
+     * random co-tenant. Pair with {@link memoryHigh} (should be higher).
+     * @default '768M'
+     */
+    memoryMax?: string;
     /**
      * Enable rpx on-demand TLS: lazily issue a real (Let's Encrypt) cert for an
      * approved host the first time it's needed. The site domains are used as the

package/package.json

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