@ts-cloud/core 0.4.2 → 0.5.0

package/dist/index.d.ts

@@ -29,6 +29,7 @@ export * from './presets/traditional-web-app';
 export * from './presets/laravel';
 export * from './presets/serverless-laravel';
 export * from './presets/dashboard';
+export * from './presets/management-dashboard';
 export * from './presets/extend';
 export * from './aws/signature';
 export * from './aws/credentials';

package/dist/index.js

@@ -22307,6 +22307,57 @@ function createDashboardSite(options) {
     }
   };
 }
+// src/presets/management-dashboard.ts
+function apexOf(domain) {
+  const parts = domain.split(".").filter(Boolean);
+  return parts.length <= 2 ? domain : parts.slice(-2).join(".");
+}
+function resolveDashboardDomain(config, environment, explicit) {
+  if (explicit)
+    return explicit;
+  const candidates = [];
+  for (const site of Object.values(config.sites ?? {})) {
+    const d = site?.domain;
+    if (typeof d === "string")
+      candidates.push(d);
+    else if (Array.isArray(d))
+      candidates.push(...d.filter((x) => typeof x === "string"));
+  }
+  if (environment && config.environments?.[environment]?.domain)
+    candidates.push(config.environments[environment].domain);
+  const dnsDomain = config.infrastructure?.dns?.domain;
+  if (dnsDomain)
+    candidates.push(dnsDomain);
+  const base = candidates.find((d) => d && !d.startsWith("dashboard."));
+  if (!base)
+    return null;
+  return `dashboard.${apexOf(base)}`;
+}
+function hasManagementDashboardSite(config) {
+  return Object.entries(config.sites ?? {}).some(([name, site]) => {
+    if (!site)
+      return false;
+    const root = site.root ?? "";
+    return name === "dashboard" || root === "ui/dist" || root.endsWith("/ui/dist") || root.endsWith("/dist/ui");
+  });
+}
+function resolveManagementDashboardSite(config, environment, opts) {
+  if (hasManagementDashboardSite(config))
+    return null;
+  const domain = resolveDashboardDomain(config, environment, opts.domain);
+  if (!domain)
+    return null;
+  const site = {
+    root: opts.uiRoot,
+    deploy: "server",
+    type: "static",
+    domain,
+    ssl: { provider: "letsencrypt" },
+    ...opts.build === false || opts.build === undefined ? {} : { build: opts.build },
+    ...opts.password ? { auth: { username: opts.username || "admin", password: opts.password, realm: opts.realm } } : {}
+  };
+  return { name: "dashboard", site };
+}
 // src/presets/extend.ts
 function deepMerge(target, source) {
   const result = { ...target };
@@ -46910,7 +46961,9 @@ export {
   resolveRegion,
   resolveQueueNames,
   resolveProjectStackName,
+  resolveManagementDashboardSite,
   resolveDeployBucketName,
+  resolveDashboardDomain,
   resolveCredentials,
   resolveCloudProvider,
   resolveApp,
@@ -46964,6 +47017,7 @@ export {
   hashFile,
   hashDirectory,
   hashBuffer,
+  hasManagementDashboardSite,
   guardDutyManager,
   globalResourceManager,
   getTimestamp,

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

@@ -0,0 +1,44 @@
+import type { CloudConfig, EnvironmentType, SiteConfig } from '../types';
+/**
+ * Auto-deployed management dashboard (the `@ts-cloud/ui` stx app — the Server +
+ * Serverless views). When a server is provisioned, ts-cloud injects this as a
+ * server-static site so the dashboard ships automatically with every box.
+ *
+ * It is served behind HTTP Basic auth (htpasswd) whose password comes from an
+ * environment value (`TS_CLOUD_UI_PASSWORD`). If that value is NOT set, the
+ * dashboard is served WITHOUT auth — no password is invented.
+ */
+export interface ManagementDashboardOptions {
+    /** Directory shipped as the static site root (built UI, or source dir + build). */
+    uiRoot: string;
+    /** Build command producing {@link uiRoot}, or false when it is already built. */
+    build?: string | false;
+    /** Explicit domain (e.g. from `TS_CLOUD_UI_DOMAIN`); else derived. */
+    domain?: string;
+    /** Basic-auth username. @default 'admin' */
+    username?: string;
+    /**
+     * Basic-auth password. When empty/undefined the dashboard is served WITHOUT
+     * htpasswd (no default password is invented).
+     */
+    password?: string;
+    /** Browser auth realm. */
+    realm?: string;
+}
+/**
+ * Derive a dashboard hostname (`dashboard.<apex>`) from the project's configured
+ * domains. Prefers `explicit`, then any site domain, then the environment domain,
+ * then `infrastructure.dns.domain`. Returns null when nothing is available.
+ */
+export declare function resolveDashboardDomain(config: Pick<CloudConfig, 'sites' | 'environments' | 'infrastructure'>, environment?: EnvironmentType, explicit?: string): string | null;
+/** Does the config already define the management dashboard as a site? */
+export declare function hasManagementDashboardSite(config: Pick<CloudConfig, 'sites'>): boolean;
+/**
+ * Build the management-dashboard site to auto-inject on server deploys, or null
+ * when no domain can be resolved (the static-site model is domain-routed) or it
+ * is already configured.
+ */
+export declare function resolveManagementDashboardSite(config: Pick<CloudConfig, 'sites' | 'environments' | 'infrastructure'>, environment: EnvironmentType, opts: ManagementDashboardOptions): {
+    name: string;
+    site: SiteConfig;
+} | null;

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

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ts-cloud/core",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "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.4.2"
+    "@ts-cloud/aws-types": "0.5.0"
   },
   "devDependencies": {
     "typescript": "^5.9.3"