@webship.co/workspace-hosting 0.0.0-stage → 1.0.0-beta1

package/README.md

@@ -1,3 +1,19 @@
-# Temporary Holding Version
+# @webship.co/workspace-hosting
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The hosting family's shared base for [Webship Workspace](https://github.com/webship/workspace)
+plugins. A hosting plugin (`@webship.co/workspace-upsun`, `-cpanel`, `-digitalocean`, `-aws`, `-azure`,
+`-acquia`, `-godaddy`) is one call plus its provider:
+
+```ts
+import { registerHosting } from '@webship.co/workspace-hosting';
+export function register(api: PluginApi) { registerHosting(api, provider); }
+```
+
+`registerHosting` gives the provider its row menu (linked / unlinked, with the link step), the
+live-site chip, the environments modal and the list inside the menu, the get-database-and-files
+flow (environment, database / files, switching the code, the safety export, confirmation; run as a
+screen session), the branch-and-data command block, every tool verb as a screen session on the
+project, the `/<id>-site/<ws>/<project>` jump, and the New-folder section. The `HostingProvider`
+says what differs between hosts: how a project is detected as linked, the CLI and its token, how
+environments and their URLs are listed, which tool verbs the per-workspace command carries, the
+pull flags, the console URL.

package/css/hosting.css

@@ -0,0 +1,24 @@
+/* The hosting family: the per-provider menu, the live-site chip and the New-folder option.
+   Appended to the dashboard stylesheet after the components, so it may only ADD rules.
+   Every hosting plugin gets these through registerHosting(); a provider's own file adds to them. */
+
+/* The project id and the environment list are lowercase and case-sensitive: shown uppercase they
+   cannot be read off the screen and used, so they opt out of the header styling. */
+.hosting-mismatch { text-transform: none; font-family: var(--font-code); font-size: 0.72rem; }
+.hosting-menu-id { text-transform: none; font-family: var(--font-code); }
+.hosting-menu-note { text-transform: none; font-weight: 400; opacity: .75; white-space: normal; }
+/* The link command carries a project name, so it is long: it wraps rather than widening the menu. */
+.hosting-menu-note code { white-space: normal; overflow-wrap: anywhere; }
+
+/* An unlinked project still shows the menu (the command is there), quieter than a linked one, so a
+   row of thirty unlinked projects does not read as thirty cloud deployments. */
+.hosting-unlinked { opacity: .75; }
+.hosting-unlinked:hover { opacity: 1; }
+
+/* The live-site chip on the card. */
+.pcard-meta .proj-hosting-link { max-width: 11rem; }
+.proj-hosting-link { white-space: nowrap; }
+
+/* New folder: the project id field shows only when "Link to an existing project" is chosen. */
+.folder-new-form .folder-hosting-id { display: none; }
+.folder-new-form .folder-hosting:has(input[value="link"]:checked) .folder-hosting-id { display: block; }

package/dist/src/cli.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Where a provider's CLI is, inside the dashboard container.
+ *
+ * The container has no package manager run at request time: a CLI gets there by being mounted
+ * from the host (the plugin's compose file maps `~/.local/bin` to `/host-local-bin`, and the CLI's
+ * own config directory beside it) or by being in the image. The first executable wins.
+ */
+export declare function findCli(name: string, extra?: string[]): string | null;
+/** A settings value that is set: not empty, not the CHANGE_ME placeholder. */
+export declare function configured(v: unknown): string | null;

package/dist/src/cli.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Where a provider's CLI is, inside the dashboard container.
+ *
+ * The container has no package manager run at request time: a CLI gets there by being mounted
+ * from the host (the plugin's compose file maps `~/.local/bin` to `/host-local-bin`, and the CLI's
+ * own config directory beside it) or by being in the image. The first executable wins.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findCli = findCli;
+exports.configured = configured;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+function findCli(name, extra = []) {
+    const home = process.env.HOME || '';
+    const candidates = [
+        ...extra,
+        `/host-local-bin/${name}`,
+        path_1.default.join(home, '.local', 'bin', name),
+        ...String(process.env.PATH || '').split(':').filter(Boolean).map((d) => path_1.default.join(d, name)),
+    ];
+    for (const c of candidates) {
+        try {
+            fs_1.default.accessSync(c, fs_1.default.constants.X_OK);
+            if (fs_1.default.statSync(c).isFile())
+                return c;
+        }
+        catch (_) { /* next */ }
+    }
+    return null;
+}
+/** A settings value that is set: not empty, not the CHANGE_ME placeholder. */
+function configured(v) {
+    const s = String(v == null ? '' : v).trim();
+    return s && s !== 'CHANGE_ME' ? s : null;
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;AAKH,0BAYC;AAGD,gCAGC;AArBD,4CAAoB;AACpB,gDAAwB;AAExB,SAAgB,OAAO,CAAC,IAAY,EAAE,QAAkB,EAAE;IACxD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;IACpC,MAAM,UAAU,GAAG;QACjB,GAAG,KAAK;QACR,mBAAmB,IAAI,EAAE;QACzB,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC;QACtC,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAI,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;KAC5F,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC;YAAC,YAAE,CAAC,UAAU,CAAC,CAAC,EAAE,YAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAAC,IAAI,YAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;gBAAE,OAAO,CAAC,CAAC;QAAC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IAC9G,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,SAAgB,UAAU,CAAC,CAAU;IACnC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3C,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * registerHosting(api, provider): the whole surface of a hosting plugin, from a provider's facts.
+ *
+ * The row menu (linked / unlinked), the live-site chip, the environments modal, the get-database-
+ * and-files flow, the branch-and-data command block, the tool verbs as screen sessions, the
+ * `/<id>-site/<ws>/<project>` jump, and the New-folder section. Each hosting plugin is this call
+ * plus its provider; what differs between hosts is in the provider, what is the same is here.
+ */
+import type { PluginApi } from '@webship.co/workspace-plugin-api';
+import type { HostingProvider } from './provider';
+export * from './provider';
+export * from './cli';
+export declare function registerHosting(api: PluginApi, p: HostingProvider): void;

package/dist/src/index.js

@@ -0,0 +1,400 @@
+"use strict";
+/**
+ * registerHosting(api, provider): the whole surface of a hosting plugin, from a provider's facts.
+ *
+ * The row menu (linked / unlinked), the live-site chip, the environments modal, the get-database-
+ * and-files flow, the branch-and-data command block, the tool verbs as screen sessions, the
+ * `/<id>-site/<ws>/<project>` jump, and the New-folder section. Each hosting plugin is this call
+ * plus its provider; what differs between hosts is in the provider, what is the same is here.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerHosting = registerHosting;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+__exportStar(require("./provider"), exports);
+__exportStar(require("./cli"), exports);
+const registeredCss = new WeakSet();
+function registerHosting(api, p) {
+    const { esc, workspaceDir, listProjects, isValidWorkspace, screenAction, iconHtml, NAME_RE, ROOT, run, startInScreen, screenStartedHtml, cliError, commandBlock } = api.lib;
+    const post = (name) => `/actions/p/${api.name}/${name}`;
+    const fragment = (rest) => `/fragments/p/${api.name}/${rest}`;
+    const typeAction = p.typeAction || p.id;
+    const can = (allowed, dir) => allowed.has(typeAction) && fs_1.default.existsSync(path_1.default.join(dir, p.script));
+    const shq = (v) => `'${String(v).replace(/'/g, `'\\''`)}'`;
+    // The family's stylesheet, once however many providers register.
+    if (typeof api.addCss === 'function' && !registeredCss.has(api.addCss)) {
+        registeredCss.add(api.addCss);
+        api.addCss(path_1.default.join(__dirname, '..', '..', 'css', 'hosting.css'));
+    }
+    // A page of thirty rows must not stat the same files thirty times: the link is memoised briefly.
+    let cache = new Map();
+    let cacheAt = 0;
+    const linkOf = (dir, project) => {
+        const now = Date.now();
+        if (now - cacheAt > 5000) {
+            cache = new Map();
+            cacheAt = now;
+        }
+        const k = `${dir}/${project}`;
+        if (!cache.has(k)) {
+            try {
+                cache.set(k, p.detect(path_1.default.join(dir, project)));
+            }
+            catch (_) {
+                cache.set(k, null);
+            }
+        }
+        return cache.get(k) || null;
+    };
+    const errorText = (out) => {
+        const msg = cliError(String(out.stderr || out.stdout || ''));
+        return p.errorHint ? p.errorHint(msg) : msg;
+    };
+    // The environments and their live URLs, cached: a row cannot pay for CLI calls per render.
+    const envCache = new Map();
+    async function environments(dir, project) {
+        const u = linkOf(dir, project);
+        if (!u || !u.id)
+            return null;
+        const hit = envCache.get(u.id);
+        if (hit)
+            return hit;
+        if (!p.environments)
+            return { id: u.id, rows: [], branch: u.branch, env: u.env, why: 'no list' };
+        const env = p.jobEnv();
+        if (!env)
+            return { id: u.id, rows: [], branch: u.branch, env: u.env, why: 'no token' };
+        let info;
+        try {
+            info = await p.environments(u, api.lib, env);
+        }
+        catch (_) {
+            info = { id: u.id, rows: [], why: 'list failed' };
+        }
+        const answer = { ...info, branch: u.branch, env: u.env };
+        envCache.set(u.id, answer);
+        // Five minutes: long enough to render a page many times, short enough that a new environment shows.
+        setTimeout(() => envCache.delete(u.id), 5 * 60 * 1000).unref?.();
+        return answer;
+    }
+    // ---- The menu on a project row ---------------------------------------------------------------
+    api.addRowMenu(p.id, { label: p.label, row: 0 }, ({ key, project, dir, allowed, vals }) => {
+        if (!can(allowed, dir))
+            return null;
+        const u = linkOf(dir, project);
+        const caption = !u ? 'not linked' : 'linked';
+        const status = p.tools.status;
+        if (!u) {
+            return `<span class="act-with-status"><div class="uk-inline act-menu act-menu-${esc(p.id)} act-menu-hosting">
+          <button class="uk-button uk-button-default uk-button-small hosting-unlinked" type="button" title="Not linked to ${esc(p.title)}"><span uk-icon="icon: cloud-upload; ratio: .7"></span> ${esc(p.label)} <span uk-icon="icon: chevron-down; ratio: .6"></span></button>
+          <div uk-dropdown="mode: click; pos: bottom-right"><ul class="uk-nav uk-dropdown-nav">
+            <li class="uk-nav-header">Not linked to ${esc(p.title)}</li>
+            ${status ? `<li><a href hx-post="${post('tool-status')}" ${vals()}><span uk-icon="icon: info; ratio: .7"></span> ${esc(status.label)}</a></li>` : ''}
+            <li class="uk-nav-divider"></li>
+            <li class="uk-nav-header hosting-menu-note" data-group="how to link">Link it from ${esc(key)}:<br><code>${esc(p.linkHint(project))}</code></li>
+          </ul></div>
+        </div><span class="act-status uk-text-meta">${esc(caption)}</span></span>`;
+        }
+        const idLine = `${esc(u.id || '(no id)')}${u.branch ? ` · <span title="the branch the local code is on">${esc(u.branch)}</span>` : ''}`
+            + `${u.mismatch ? ` <span class="uk-label uk-label-danger hosting-mismatch" title="${esc(u.mismatchNote || 'the link and the git remote disagree')}">mismatch</span>` : ''}`;
+        const toolItems = Object.entries(p.tools).filter(([k]) => k !== 'status').map(([k, t]) => `<li><a href hx-post="${post(`tool-${k}`)}" ${vals()}><span uk-icon="icon: ${esc(t.icon)}; ratio: .7"></span> ${esc(t.label)}</a></li>`).join('');
+        const console = p.consoleUrl ? p.consoleUrl(u) : null;
+        return `<span class="act-with-status"><div class="uk-inline act-menu act-menu-${esc(p.id)} act-menu-hosting">
+        <button class="uk-button uk-button-default uk-button-small" type="button" title="${esc(p.label)}"><span uk-icon="icon: cloud-upload; ratio: .7"></span> ${esc(p.label)} <span uk-icon="icon: chevron-down; ratio: .6"></span></button>
+        <div uk-dropdown="mode: click; pos: bottom-right"><ul class="uk-nav uk-dropdown-nav">
+          <li class="uk-nav-header hosting-menu-id" data-group="link">${idLine}</li>
+          ${p.environments ? `<li><a href hx-post="${post('envs')}" hx-vals='{"workspace":"${esc(key)}","projectName":"${esc(project)}"}' hx-target="#editor-modal-body" hx-swap="innerHTML"><span uk-icon="icon: world; ratio: .7"></span> Environments and live sites</a></li>
+          <li class="uk-nav-header" data-group="live sites">Live sites</li>
+          <li data-entry="live sites list"><ul class="uk-nav-sub" hx-get="${fragment(`envs/${encodeURIComponent(key)}/${encodeURIComponent(project)}`)}" hx-trigger="revealed" hx-swap="innerHTML"><li class="uk-nav-header">Loading…</li></ul></li>` : ''}
+          ${status ? `<li><a href hx-post="${post('tool-status')}" ${vals()}><span uk-icon="icon: info; ratio: .7"></span> ${esc(status.label)}</a></li>` : ''}
+          ${toolItems}
+          ${p.pull && (p.pull.db || p.pull.files) ? `<li class="uk-nav-divider"></li>
+          <li><a href hx-post="${post('pull-form')}" hx-vals='{"workspace":"${esc(key)}","projectName":"${esc(project)}"}' hx-target="#editor-modal-body" hx-swap="innerHTML"><span uk-icon="icon: cloud-download; ratio: .7"></span> Get ${p.pull.db && p.pull.files ? 'database &amp; files' : p.pull.db ? 'database' : 'files'}…</a></li>
+          <li><a href hx-post="${post('environments')}" ${vals()}><span uk-icon="icon: git-branch; ratio: .7"></span> Branch and data…${u.env ? ` <span class="uk-text-meta">(${esc(u.env)})</span>` : ''}</a></li>` : ''}
+          ${console ? `<li class="uk-nav-divider"></li><li><a href="${esc(console)}" target="_blank"><span uk-icon="icon: link-external; ratio: .7"></span> Open in the ${esc(p.title)} console</a></li>` : ''}
+          ${p.menuNote ? `<li class="uk-nav-header hosting-menu-note">${esc(p.menuNote)}</li>` : ''}
+        </ul></div>
+      </div><span class="act-status uk-text-meta">${esc(caption)}</span></span>`;
+    });
+    // ---- The live-site chip on the card ----------------------------------------------------------
+    api.addProjectChip(({ key, project, dir }) => {
+        const u = linkOf(dir, project);
+        if (!u || !p.environments)
+            return null;
+        return `<a class="proj-alias proj-plugin-link proj-hosting-link proj-${esc(p.id)}-link" href="/${encodeURIComponent(p.id)}-site/${encodeURIComponent(key)}/${encodeURIComponent(project)}" target="_blank" rel="noopener"
+      title="The live ${esc(p.title)} site for the environment this code is on">${iconHtml('tabler:cloud-upload', 0.7)}<span class="pcard-chip-text">${esc(u.branch || u.env || u.id || p.title)}</span></a>`;
+    });
+    // ---- Tool verbs: the per-workspace command, run as a screen session ---------------------------
+    const guard = ({ form, send, workspace }) => {
+        const dir = workspaceDir(workspace);
+        if (!fs_1.default.existsSync(path_1.default.join(dir, p.script))) {
+            send(`<div class="msg error">This workspace has no ${esc(p.title)} tool.</div>`, 400);
+            return null;
+        }
+        const project = String(form.projectName || '');
+        if (!NAME_RE.test(project) || !listProjects(dir).includes(project)) {
+            send('<div class="msg error">Unknown project.</div>', 400);
+            return null;
+        }
+        return { dir, project };
+    };
+    for (const [name, t] of Object.entries(p.tools)) {
+        api.addAction(`tool-${name}`, (ctx) => {
+            const g = guard(ctx);
+            if (!g)
+                return;
+            return screenAction(ctx.send, { workspace: ctx.workspace, project: g.project, projectDir: g.dir,
+                ownerDir: path_1.default.join(g.dir, g.project), verb: t.verb,
+                cmdLine: `bash ${p.script} ${g.project}${t.args.length ? ` ${t.args.join(' ')}` : ''}`,
+                label: `${p.id} ${t.label.toLowerCase()}` });
+        });
+    }
+    // ---- Environments: the modal, the list inside the menu, the site jump -------------------------
+    api.addAction('envs', async (ctx) => {
+        const g = guard(ctx);
+        if (!g)
+            return;
+        const u = linkOf(g.dir, g.project);
+        if (!u || !u.id)
+            return ctx.send(`<div class="msg error">This project is not linked to a ${esc(p.title)} project.</div>`, 409);
+        if (!p.environments)
+            return ctx.send(`<div class="msg error">${esc(p.title)} lists no environments from here.</div>`, 409);
+        if (!p.jobEnv())
+            return ctx.send(`<div class="msg error">No ${esc(p.title)} API token configured (${esc(p.tokenHint)}).</div>`, 409);
+        envCache.delete(u.id);
+        const info = await environments(g.dir, g.project);
+        const rows = (info && info.rows) || [];
+        const list = rows.map((r) => `
+      <div class="uk-margin-small-bottom">
+        ${/^active$/i.test(r.status) ? '<span class="uk-label uk-label-success">active</span>' : `<span class="uk-label">${esc(r.status.toLowerCase())}</span>`}
+        <strong>${esc(r.title)}</strong>${r.title !== r.envId ? ` <span class="uk-text-meta">(${esc(r.envId)})</span>` : ''}
+        ${r.envId === u.branch ? '<span class="uk-text-meta">· the local code is on this branch</span>' : ''}
+        ${r.url ? `· <a href="${esc(r.url)}" target="_blank">${esc(r.url)}</a>` : ''}
+      </div>`).join('');
+        return ctx.send(`
+      <div class="editor-card">
+        <h3 class="uk-margin-small-bottom">Environments — ${esc(g.project)}</h3>
+        <p class="uk-text-meta">${esc(p.title)} project <code>${esc(u.id)}</code>. Each active environment with its live site.</p>
+        ${list || `<div class="msg error">No environments${info && info.why ? ` (${esc(info.why)})` : ''}.</div>`}
+      </div>`);
+    });
+    api.addFragment(async ({ send, rest }) => {
+        const m = rest.match(/^envs\/([a-z0-9_-]+)\/([a-zA-Z0-9_-]+)$/);
+        if (!m || !isValidWorkspace(m[1]))
+            return send('', 404);
+        const info = await environments(workspaceDir(m[1]), m[2]);
+        const rows = (info && info.rows) || [];
+        const items = rows.map((r) => {
+            const here = r.envId === (info.branch || info.env);
+            return r.url
+                ? `<li><a href="${esc(r.url)}" target="_blank" title="${esc(r.url)}"><span uk-icon="icon: link-external; ratio: .7"></span> ${esc(r.title)}${here ? ' <span class="uk-text-meta">(this code)</span>' : ''}</a></li>`
+                : `<li><span class="uk-text-meta"><span uk-icon="icon: ban; ratio: .7"></span> ${esc(r.title)} — ${esc((r.status || '').toLowerCase())}</span></li>`;
+        }).join('');
+        send(items || `<li class="uk-nav-header">${info && info.why === 'no token' ? `No ${esc(p.title)} API token (${esc(p.tokenHint)})` : 'No environments'}</li>`);
+    });
+    api.addPage(new RegExp(`^\\/${p.id}-site\\/([a-z0-9_-]+)\\/([a-zA-Z0-9_-]+)$`), async ({ res, match }) => {
+        if (!isValidWorkspace(match[1])) {
+            res.writeHead(404);
+            return res.end();
+        }
+        const info = await environments(workspaceDir(match[1]), match[2]);
+        const want = info && (info.branch || info.env || 'main');
+        const row = info && (info.rows.find((r) => r.envId === want && r.url) || info.rows.find((r) => r.url));
+        if (row) {
+            res.writeHead(302, { Location: row.url });
+            return res.end();
+        }
+        res.writeHead(404, { 'Content-Type': 'text/html; charset=utf-8' });
+        res.end(`<p>No live ${esc(p.title)} URL for ${esc(match[2])}${info && info.why ? ` (${esc(info.why)})` : ''}.</p>`);
+    });
+    // ---- Branch and data: the commands, shown rather than run --------------------------------------
+    api.addAction('environments', (ctx) => {
+        const g = guard(ctx);
+        if (!g)
+            return;
+        const u = linkOf(g.dir, g.project);
+        if (!u || !u.id)
+            return ctx.send(`<div class="msg error">This project is not linked to a ${esc(p.title)} project.</div>`, 409);
+        const cd = `cd ${ROOT}/${ctx.workspace}`;
+        const lines = [`${cd} && bash ${p.script} ${g.project} --environments`, `${cd} && bash ${p.script} ${g.project} --select <environment>`];
+        if (p.pull && p.pull.db)
+            lines.push(`${cd} && bash ${p.script} ${g.project} --pull-db`);
+        if (p.pull && p.pull.files)
+            lines.push(`${cd} && bash ${p.script} ${g.project} --pull-files`);
+        return ctx.send(commandBlock(`Branch and data for ${g.project} on ${p.title} ${u.id}`, lines, `${u.env ? `Currently working against <strong>${esc(u.env)}</strong>. ` : 'No environment selected yet — a pull refuses to guess which branch it takes data from. '}`
+            + 'Run these <strong>on the host</strong>: these are cloud credentials for client projects. A database pull REPLACES the local database '
+            + '(the current one is exported to <code>backups/</code> first) and a files pull adds and overwrites the public files mount. '
+            + 'Both bring client data onto this machine — sanitize before sharing.'));
+    });
+    // ---- Get database and files -------------------------------------------------------------------
+    if (p.pull && (p.pull.db || p.pull.files)) {
+        const pull = p.pull;
+        api.addAction('pull-form', async (ctx) => {
+            const g = guard(ctx);
+            if (!g)
+                return;
+            const u = linkOf(g.dir, g.project);
+            if (!u || !u.id)
+                return ctx.send(`<div class="msg error">This project is not linked to a ${esc(p.title)} project.</div>`, 409);
+            const env = p.jobEnv();
+            if (!env)
+                return ctx.send(`<div class="msg error">No ${esc(p.title)} API token configured — ${esc(p.tokenHint)}.</div>`, 409);
+            envCache.delete(u.id);
+            const info = await environments(g.dir, g.project);
+            const all = (info && info.rows) || [];
+            const envs = all.filter((r) => /^active$/i.test(r.status)).map((r) => r.envId);
+            const inactive = all.length - envs.length;
+            if (!envs.length)
+                return ctx.send(`<div class="msg error">No ACTIVE environments on this project${all.length ? ` (${all.length} inactive)` : ''}${info && info.why ? ` — ${esc(info.why)}` : ''}.</div>`, 409);
+            const isGit = fs_1.default.existsSync(path_1.default.join(g.dir, g.project, '.git'));
+            return ctx.send(`
+    <div class="editor-card">
+      <h3 class="uk-margin-small-bottom">Get ${pull.db && pull.files ? 'database &amp; files' : pull.db ? 'database' : 'files'} — ${esc(g.project)}</h3>
+      <p class="uk-text-meta">From ${esc(p.title)} project <code>${esc(u.id)}</code> into the local DDEV site.
+        ${pull.db ? 'The local database is REPLACED (the current one is exported to <code>backups/</code> first); ' : ''}${pull.files ? 'files are added and overwritten, never deleted. ' : ''}Client data lands on this machine.</p>
+      <form hx-post="${post('pull')}" hx-target="#editor-modal-body" hx-swap="innerHTML">
+        <input type="hidden" name="workspace" value="${esc(ctx.workspace)}">
+        <input type="hidden" name="projectName" value="${esc(g.project)}">
+        <label class="uk-form-label">Active environment to sync from
+          <select class="uk-select uk-margin-small-bottom" name="environment">
+            ${envs.map((e) => `<option value="${esc(e)}"${e === (u.env || u.branch || 'main') ? ' selected' : ''}>${esc(e)}</option>`).join('')}
+          </select>
+          ${inactive ? `<span class="uk-text-meta">${inactive} inactive environment${inactive > 1 ? 's' : ''} not offered.</span>` : ''}
+        </label>
+        ${pull.db ? '<label><input class="uk-checkbox" type="checkbox" name="db" checked> Database</label>' : ''}
+        ${pull.files ? '<label class="uk-margin-left"><input class="uk-checkbox" type="checkbox" name="files" checked> Files</label>' : ''}
+        ${isGit && pull.gitRemote
+                ? `<label class="uk-margin-left"><input class="uk-checkbox" type="checkbox" name="switch" checked> Switch the local code to this branch</label>
+             <div class="uk-text-meta">Uncommitted local changes are stashed first (recover with <code>git stash pop</code>), then the code switches. After the pull, caches are rebuilt and the local site is checked.</div>`
+                : '<div class="uk-text-meta">The code stays as it is; caches are rebuilt and the local site checked after the pull.</div>'}
+        ${pull.db && pull.noSafetyBackupArg ? `<label class="uk-margin-small uk-display-block">
+          <input class="uk-checkbox" type="checkbox" name="backup" value="yes" checked>
+          Back up the local database into <code>backups/${esc(ctx.workspace)}/${esc(g.project)}/</code> first
+        </label>` : ''}
+        <label class="uk-margin-small uk-display-block">
+          <input class="uk-checkbox" type="checkbox" name="confirm" value="yes" required>
+          I confirm: data from <strong>${esc(p.title)}</strong> replaces this local DDEV site's data
+        </label>
+        <div class="uk-margin-small-top">
+          <button type="submit" class="uk-button uk-button-primary"><span uk-icon="icon: cloud-download; ratio: .8"></span> Get it</button>
+        </div>
+      </form>
+    </div>`);
+        });
+        api.addAction('pull', async (ctx) => {
+            const g = guard(ctx);
+            if (!g)
+                return;
+            const { form, send, workspace } = ctx;
+            const environment = String(form.environment || '').trim();
+            const wantDb = pull.db && form.db !== undefined;
+            const wantFiles = pull.files && form.files !== undefined;
+            if (!/^[a-zA-Z0-9._\/-]+$/.test(environment))
+                return send('<div class="msg error">Not an environment name.</div>', 400);
+            const u = linkOf(g.dir, g.project);
+            if (!u || !u.id)
+                return send(`<div class="msg error">This project is not linked to a ${esc(p.title)} project.</div>`, 409);
+            const env = p.jobEnv();
+            if (!env)
+                return send(`<div class="msg error">No ${esc(p.title)} API token configured (${esc(p.tokenHint)}).</div>`, 409);
+            if (p.environmentActive && !(await p.environmentActive(u, environment, api.lib, env))) {
+                return send(`<div class="msg error">${esc(environment)} is not active — nothing running to sync from.</div>`, 409);
+            }
+            if (!wantDb && !wantFiles)
+                return send('<div class="msg error">Pick the database, the files, or both.</div>', 400);
+            const confirmed = [].concat(form.confirm || '').includes('yes');
+            if (!confirmed)
+                return send('<div class="msg error">Syncing replaces local data — it requires confirmation.</div>', 400);
+            const wantSwitch = !!pull.gitRemote && form.switch !== undefined && fs_1.default.existsSync(path_1.default.join(g.dir, g.project, '.git'));
+            const parts = [
+                `echo "Starting DDEV for ${g.project}…" && (cd ${g.project} && ddev start -y > /dev/null && ddev describe > /dev/null) && echo "DDEV is up and healthy."`,
+            ];
+            if (wantSwitch) {
+                parts.push([
+                    `cd ${g.project}`,
+                    `if [ -n "$(git status --porcelain)" ]; then STASH_NAME="${p.id}-pull $(date +%Y-%m-%d-%H%M%S)" && git stash push --include-untracked -m "$STASH_NAME" && echo "Local changes stashed as: $STASH_NAME (git stash pop brings them back)"; fi`,
+                    `echo "Switching the code to ${environment}…"`,
+                    `git fetch ${pull.gitRemote} ${environment}`,
+                    `(git checkout ${environment} 2>/dev/null || git checkout -b ${environment} ${pull.gitRemote}/${environment})`,
+                    `git pull --ff-only ${pull.gitRemote} ${environment}`,
+                    `echo "Code is on ${environment}."`,
+                    'cd ..',
+                ].join(' && '));
+            }
+            const noSafety = pull.noSafetyBackupArg && form.backup === undefined ? ` ${pull.noSafetyBackupArg}` : '';
+            if (wantDb)
+                parts.push(`bash ${p.script} ${g.project} ${pull.dbArgs(environment).join(' ')}${noSafety}`);
+            if (wantFiles)
+                parts.push(`bash ${p.script} ${g.project} ${pull.filesArgs(environment).join(' ')}`);
+            parts.push([
+                `cd ${g.project}`,
+                'echo "Rebuilding caches (drush cr)…"',
+                'ddev drush cr > /dev/null 2>&1 || echo "drush cr failed — not a Drupal site, or the codebase does not match the database"',
+                `for i in 1 2 3 4 5 6 7 8 9 10; do code=$(curl -sk -o /dev/null -w "%{http_code}" "https://${g.project}.ddev.site/"); case "$code" in 200|301|302|303) break ;; esac; sleep 3; done`,
+                `echo "Local site check: https://${g.project}.ddev.site/ answered $code"`,
+                'case "$code" in 200|301|302|303) echo "✅ The local site is working." ;; *) echo "⚠️ The local site did not answer cleanly (${code:-no response after 30s}) — check ddev logs." ;; esac',
+            ].join(' && '));
+            const started = await startInScreen({ workspace, project: g.project, projectDir: g.dir, ownerDir: path_1.default.join(g.dir, g.project),
+                verb: `${p.id}-pull-${environment}`, cmdLine: parts.join(' && '),
+                label: `get ${wantDb ? 'database' : ''}${wantDb && wantFiles ? ' + ' : ''}${wantFiles ? 'files' : ''} from ${environment}` });
+            return send(screenStartedHtml(started, `${p.id} pull from ${environment}`, g.project), started.ok ? 200 : (started.already ? 409 : 500));
+        });
+        void run;
+        void errorText;
+    }
+    // ---- New folder: link it to a project, or create one with AI ----------------------------------
+    if (p.folder) {
+        const f = p.folder;
+        api.addFolderSetup({
+            html: (ws, { allowed }) => {
+                if (!can(allowed, workspaceDir(ws)))
+                    return '';
+                return `<div class="uk-margin-small-top folder-hosting folder-${esc(p.id)}">
+            <span class="uk-text-meta">${esc(p.title)}:</span>
+            <label class="uk-margin-small-right"><input class="uk-radio" type="radio" name="${esc(p.id)}" value="none" checked> Not now</label>
+            <label class="uk-margin-small-right"><input class="uk-radio" type="radio" name="${esc(p.id)}" value="link"> Link to an existing project</label>
+            ${f.createPrompt ? `<label><input class="uk-radio" type="radio" name="${esc(p.id)}" value="create"> Create a new project and deploy it, with AI (it asks before creating anything billed)</label>` : ''}
+            <div class="folder-hosting-id uk-margin-small-top">
+              <label class="uk-form-label" for="folder-${esc(p.id)}-id">${esc(p.title)} project id</label>
+              <input class="uk-input uk-form-small uk-form-width-medium" id="folder-${esc(p.id)}-id" name="${esc(p.id)}_id"
+                     pattern="${esc(f.idPattern.source)}" placeholder="${esc(f.idPlaceholder)}">
+            </div>
+          </div>`;
+            },
+            steps: (ws, name, form, { allowed }) => {
+                if (form[p.id] !== 'link' || !can(allowed, workspaceDir(ws)))
+                    return [];
+                return [`( cd ${shq(name)} && { git rev-parse --git-dir >/dev/null 2>&1 || git init -q; } )`,
+                    `bash ${p.script} ${shq(name)} --link ${shq(form[`${p.id}_id`])}`];
+            },
+            prompt: (_ws, _name, form) => (form[p.id] === 'create' && f.createPrompt ? [f.createPrompt] : []),
+            problem: (ws, form, { allowed }) => {
+                if (form[p.id] !== 'link' && form[p.id] !== 'create')
+                    return '';
+                if (!can(allowed, workspaceDir(ws)))
+                    return `This workspace does not link projects to ${p.title}.`;
+                if (form[p.id] === 'link' && !f.idPattern.test(String(form[`${p.id}_id`] || '')))
+                    return f.idHelp;
+                return '';
+            },
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/provider.d.ts

@@ -0,0 +1,106 @@
+/**
+ * What a hosting provider is, to the dashboard.
+ *
+ * A project lives on one host. A provider knows how to tell that a project is linked to it (a file
+ * the CLI wrote, a git remote), what its environments are and where they answer, how to fetch a
+ * database and the files, how to deploy, and how to read its logs. The row menu, the modal, the
+ * actions and the New-folder section are the family's (registerHosting); the provider supplies the
+ * facts and the commands. Upsun is the reference implementation.
+ */
+import type { PluginLib } from '@webship.co/workspace-plugin-api';
+/** A project's link to the host: what the provider's CLI or config says it is. */
+export interface HostingLink {
+    /** The project's id on the host (an Upsun project id, an Acquia application uuid, a DO app id…). */
+    id: string | null;
+    /** The environment the local tooling works against, when one was selected. */
+    env?: string | null;
+    /** The branch the local code is on, when the project is a git clone. */
+    branch?: string | null;
+    host?: string | null;
+    remote?: string | null;
+    /** The link and the git remote disagree (a deploy would go somewhere other than the id says). */
+    mismatch?: boolean;
+    mismatchNote?: string;
+}
+export interface EnvRow {
+    title: string;
+    envId: string;
+    /** 'active' means running; anything else is listed without a link. */
+    status: string;
+    url?: string;
+}
+export interface EnvInfo {
+    id: string | null;
+    rows: EnvRow[];
+    branch?: string | null;
+    env?: string | null;
+    /** Why there are no rows: 'no token', 'list failed', 'not linked'. */
+    why?: string;
+}
+/** A verb the per-workspace command carries, run in a screen session on the project. */
+export interface ToolVerb {
+    /** The screen verb suffix (`upsun-logs`). */
+    verb: string;
+    /** What the menu calls it. */
+    label: string;
+    /** An icon name for the menu (`file-text`). */
+    icon: string;
+    /** The flags appended to `bash <script> <project>`. */
+    args: string[];
+}
+export interface PullSpec {
+    /** The provider can bring the database down. */
+    db: boolean;
+    /** The provider can bring the public files down. */
+    files: boolean;
+    /** The flags of the per-workspace command for each pull, given the environment. */
+    dbArgs: (env: string) => string[];
+    filesArgs: (env: string) => string[];
+    /** The git remote the local code may be switched to the environment's branch from, if any. */
+    gitRemote?: string;
+    /** The flag that skips the safety export of the local database before --pull-db, if the command has one. */
+    noSafetyBackupArg?: string;
+}
+export interface HostingProvider {
+    /** The slot, the settings key and the route namespace: 'upsun'. */
+    id: string;
+    /** The button's text: 'UPSUN'. */
+    label: string;
+    /** The product's name in sentences: 'Upsun'. */
+    title: string;
+    /** The CLI the actions run inside the dashboard container, when there is one. */
+    cli?: string;
+    /** The per-workspace command the plugin installs: 'cmd-tools-upsun.sh'. */
+    script: string;
+    /** The type action a workspace must allow: usually the id. */
+    typeAction?: string;
+    /** Whether a project is linked, and to what. Memoised by the caller per render. */
+    detect: (projectDir: string) => HostingLink | null;
+    /** How to link an unlinked project, from the workspace folder. */
+    linkHint: (project: string) => string;
+    /** The provider's console page for a linked project, or null. */
+    consoleUrl?: (link: HostingLink) => string | null;
+    /** The environment the actions inject (an API token from the plugin's settings), or null when there is none. */
+    jobEnv: () => NodeJS.ProcessEnv | null;
+    /** Where the token goes, for the message when there is none. */
+    tokenHint: string;
+    /** The environments and their live URLs. Omitted: the provider lists none. */
+    environments?: (link: HostingLink, lib: PluginLib, env: NodeJS.ProcessEnv) => Promise<EnvInfo>;
+    /** Whether an environment is active, before a pull; omitted: assumed. */
+    environmentActive?: (link: HostingLink, envId: string, lib: PluginLib, env: NodeJS.ProcessEnv) => Promise<boolean>;
+    /** The verbs the menu offers through the per-workspace command (status, activities, logs, deploy…). */
+    tools: Record<string, ToolVerb>;
+    /** Getting a database and files down, when the provider can. */
+    pull?: PullSpec;
+    /** The provider's own reading of a CLI failure, for the one message that matters. */
+    errorHint?: (message: string) => string;
+    /** The New-folder section: link an existing project (id pattern), or create one with AI. */
+    folder?: {
+        idPattern: RegExp;
+        idPlaceholder: string;
+        idHelp: string;
+        createPrompt?: string;
+    };
+    /** A line the menu ends with, for what stays on the command line. */
+    menuNote?: string;
+}

package/dist/src/provider.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * What a hosting provider is, to the dashboard.
+ *
+ * A project lives on one host. A provider knows how to tell that a project is linked to it (a file
+ * the CLI wrote, a git remote), what its environments are and where they answer, how to fetch a
+ * database and the files, how to deploy, and how to read its logs. The row menu, the modal, the
+ * actions and the New-folder section are the family's (registerHosting); the provider supplies the
+ * facts and the commands. Upsun is the reference implementation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=provider.js.map

package/dist/src/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/provider.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}

package/package.json

@@ -1,6 +1,31 @@
 {
   "name": "@webship.co/workspace-hosting",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0-beta1",
+  "description": "The hosting family's shared base for Webship Workspace plugins: the HostingProvider contract, and the row menu, environments modal, get-database-and-files flow, live-site chip, actions and New-folder section every hosting plugin registers through registerHosting(api, provider).",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/webship/workspace-hosting.git"
+  },
+  "files": [
+    "dist/src",
+    "css",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepare": "npm run build",
+    "test": "npm run build && node --test dist/tests/*.test.js",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "@webship.co/workspace-plugin-api": "^1.0.0-beta1",
+    "typescript": "^5.9.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}