@ts-cloud/core 0.7.28 → 0.7.29

package/dist/index.js

@@ -22339,6 +22339,19 @@ function apexOf(domain) {
   const parts = domain.split(".").filter(Boolean);
   return parts.length <= 2 ? domain : parts.slice(-2).join(".");
 }
+function fnv1a(str) {
+  let h = 2166136261;
+  for (let i = 0;i < str.length; i++) {
+    h ^= str.charCodeAt(i);
+    h = Math.imul(h, 16777619);
+  }
+  return h >>> 0;
+}
+var DASHBOARD_PORT_BASE = 20000;
+var DASHBOARD_PORT_SPAN = 12000;
+function deriveManagementDashboardPort(dashboardHost) {
+  return DASHBOARD_PORT_BASE + fnv1a(dashboardHost) % DASHBOARD_PORT_SPAN;
+}
 function dashboardHostFor(domain, ownedDomains) {
   const apex = apexOf(domain);
   if (apex === domain)
@@ -22413,7 +22426,7 @@ function resolveManagementDashboardSites(config, environment, opts) {
     const domain = resolveDashboardDomain(config, environment, opts.domain);
     if (!domain)
       return [];
-    const port = opts.port ?? 7676;
+    const port = opts.port ?? deriveManagementDashboardPort(domain);
     const site = {
       root: opts.uiRoot,
       deploy: "server",
@@ -47400,6 +47413,7 @@ export {
   detectServiceRegion,
   detectMisconfigurations,
   detectDeploymentTargets,
+  deriveManagementDashboardPort,
   deploymentCoexistenceError,
   defaultLocalConfig,
   databaseUserManager,
@@ -47568,6 +47582,8 @@ export {
   DLQMonitoringManager,
   DEFAULT_SERVICE_LIMITS,
   DASHBOARD_STATE_DIR,
+  DASHBOARD_PORT_SPAN,
+  DASHBOARD_PORT_BASE,
   DASHBOARD_ENTRY,
   CrossRegionReferenceManager,
   CredentialError,

package/dist/presets/management-dashboard.d.ts

@@ -45,7 +45,11 @@ export interface ManagementDashboardOptions {
      * @default true
      */
     live?: boolean;
-    /** Loopback port for the live (box-mode) dashboard service. @default 7676 */
+    /**
+     * Loopback port for the live (box-mode) dashboard service. Defaults to a value
+     * derived per dashboard host via {@link deriveManagementDashboardPort} so two
+     * apps on one box never collide; set this (or `TS_CLOUD_UI_PORT`) to pin it.
+     */
     port?: number;
     /**
      * ts-cloud version the box installs to run the dashboard. Defaults to the
@@ -65,6 +69,29 @@ export declare const DASHBOARD_STATE_DIR = ".ts-cloud";
  * be resolved by bun as a FILE to execute, and the service would never start.
  */
 export declare const DASHBOARD_ENTRY = "./node_modules/@stacksjs/ts-cloud/dist/bin/cli.js";
+/**
+ * Loopback port band for box-mode dashboards. Chosen to sit ABOVE the app port
+ * range projects use (3000s) and BELOW the Linux ephemeral range (32768+), so a
+ * derived dashboard port can neither clash with a project's own service nor with
+ * an outbound socket the box opens.
+ */
+export declare const DASHBOARD_PORT_BASE = 20000;
+export declare const DASHBOARD_PORT_SPAN = 12000;
+/**
+ * The loopback port for a tenant's box-mode dashboard, derived deterministically
+ * from its dashboard host.
+ *
+ * Every dashboard used to default to a single hard-coded port (7676), so two
+ * Stacks apps sharing a box both tried to bind it: the first won, the second
+ * crash-looped on EADDRINUSE, and — because its rpx route still pointed at that
+ * port — the second tenant's `dashboard.<domain>` silently served the FIRST
+ * tenant's dashboard. Deriving from the (globally unique) dashboard host gives
+ * each tenant its own port with no cross-tenant coordination, stays stable
+ * across deploys (same host → same port), and stays inside {@link
+ * DASHBOARD_PORT_BASE}..+{@link DASHBOARD_PORT_SPAN}. An explicit port (config
+ * `port` / `TS_CLOUD_UI_PORT`) still wins for anyone who wants to pin it.
+ */
+export declare function deriveManagementDashboardPort(dashboardHost: string): number;
 /**
  * Derive the PRIMARY dashboard hostname (`dashboard.<apex>`) for the project.
  * Prefers `explicit`, else the project's canonical domain (`infrastructure.dns.domain`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ts-cloud/core",
-  "version": "0.7.28",
+  "version": "0.7.29",
   "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.28"
+    "@ts-cloud/aws-types": "0.7.29"
   },
   "devDependencies": {
     "typescript": "^7.0.2"