dsh-connect 0.9.0 → 0.9.2

package/lib/settings/legacy-import.js

@@ -0,0 +1,373 @@
+/**
+ * One-shot migration of the pre-0.2 pane settings into the `connect` profile entry.
+ *
+ * Before 0.2 this plugin's pane settings lived in `$DSH_HOME/settings.yaml`
+ * under a `dsh-connect:` section, keyed by plugin *name*. The 0.2 host does not
+ * know that section and will not import it: `SettingsForms.importLegacyDocument()`
+ * renames the document to `settings.yaml.imported` and then calls
+ * `update(section, values)` for every top-level section, where the only renamed
+ * keys are the base-bundle ones (`ui-onboarding` → `ui-settings-general`, …).
+ * `dsh-connect` reaches `update("dsh-connect", …)` — an entry that does not
+ * exist — and is dropped with a warning. The user's channels keep working (their
+ * config is in the profile patch) but every pane-only choice silently reverts to
+ * its default the first time the pane is opened. This module recovers it.
+ *
+ * Three properties make the migration safe to run unattended:
+ *
+ * - **It merges, it does not replace.** `SettingsForms.replace()` resets every
+ *   live field to its *inherited* layer and then applies the supplied ones, so a
+ *   section carrying only the legacy keys would clear every pane field the
+ *   legacy document happens not to mention — `channels` included, which is how a
+ *   migration ends up disabling every adapter. The section handed to
+ *   `replace()` is therefore always complete: what is in force now, with the
+ *   legacy values layered on top.
+ * - **It is one-shot.** A marker beside the profile entry records that the
+ *   import ran, including the benign "there was nothing to import" case, so the
+ *   legacy document is never re-applied over later user edits. Nothing is marked
+ *   unless the outcome is final: a document that is missing is marked, a document
+ *   that is *there but unreadable* is not (see `LegacySkipReason`).
+ * - **It never blocks or breaks the load.** A missing parser, an unparseable
+ *   document or a refused write degrades to one warning line and leaves both
+ *   files untouched for a retry after the cause is fixed.
+ *
+ * Secrets cannot travel through it: the legacy section is projected by
+ * `sectionOf()`, which keeps declared non-secret keys only, and a parse failure
+ * is reported without quoting the document (a YAML error message contains the
+ * offending source lines, and the section it would quote holds an `appSecret`).
+ * Anything else in that file stays where it is.
+ * @module dsh-connect/settings/legacy-import
+ */
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { LEGACY_CONNECT_SECTION, mergeSections, sectionOf } from "./namespace.js";
+/**
+ * Name of the one-shot marker written beside the profile entry.
+ *
+ * Namespaced and dotted rather than a plain `${patchPath}.legacy-imported`
+ * because the profile directory is shared: every plugin's entry lives in that
+ * one `cordis.patch.yml`, so a bare suffix would be a file every plugin with a
+ * migration of its own would fight over — and the first one to write it would
+ * silently cancel the others.
+ */
+export const LEGACY_IMPORT_MARKER = ".dsh-connect-legacy-imported";
+/**
+ * Resolve the Harness home with the same precedence as the host's own
+ * `resolveDshHome()`: an explicit path (the host hands us `profileContext.home`,
+ * which also covers a configured non-env home), then `$DSH_HOME` — whitespace
+ * only counts as unset, so a blank override never resolves the home to the
+ * filesystem root — then `~/.dsh`. A `~` in either of the first two is expanded.
+ */
+export function resolveHarnessHome(explicit) {
+    const usable = (value) => typeof value === "string" && value.trim().length > 0;
+    if (usable(explicit))
+        return expandHome(explicit);
+    if (usable(process.env.DSH_HOME))
+        return expandHome(process.env.DSH_HOME);
+    return join(homedir(), ".dsh");
+}
+/**
+ * Trim, and expand a leading `~` the way a shell would.
+ *
+ * `DSH_HOME=~/.dsh` is a natural thing to write in a shell profile and a
+ * perfectly literal string to Node: left alone, the migration reads a directory
+ * named `~` under the process cwd, finds nothing there, and marks itself done —
+ * silently, permanently, against a home that does not exist. Only the two `~`
+ * forms are rewritten, so an absolute path is returned exactly as it was given
+ * (which is also what keeps `profileContext.home` whole).
+ */
+function expandHome(value) {
+    const trimmed = value.trim();
+    if (trimmed === "~")
+        return homedir();
+    if (trimmed.startsWith("~/") || trimmed.startsWith("~\\"))
+        return join(homedir(), trimmed.slice(2));
+    return trimmed;
+}
+/**
+ * The documents to try, in order.
+ *
+ * `settings.yaml` first: if the host has not run its own legacy import yet, the
+ * section is still there. Then `settings.yaml.imported`, which is where the host
+ * puts the document after renaming it — the read has to tolerate both because
+ * the host's import waits for the loader to settle and may run before or after
+ * ours. Finally the JSON state file this plugin used as its own fallback store:
+ * its values are unreachable once the live peer exists (`settings-service`
+ * prefers `live.read()` whenever it is present), so a user who only ever saved
+ * through the fallback path would otherwise lose them silently. That file is
+ * written flat — `persist()` stringifies the config itself, with no
+ * `dsh-connect` wrapper — so it is read as a section, not as a document.
+ */
+export function legacyCandidates(options) {
+    const home = resolveHarnessHome(options.home);
+    const candidates = [
+        { path: join(home, "settings.yaml"), shape: "document" },
+        { path: join(home, "settings.yaml.imported"), shape: "document" },
+    ];
+    if (typeof options.statePath === "string" && options.statePath.trim().length > 0) {
+        candidates.push({ path: options.statePath, shape: "section" });
+    }
+    return candidates;
+}
+/**
+ * Where the one-shot marker goes: beside the profile entry this import writes to.
+ *
+ * The anchor matters more than it looks. The marker means "this *profile entry*
+ * has already consumed the home's legacy document", so it has to move exactly
+ * when that entry moves and not otherwise:
+ *
+ * - **Not the state file.** `${statePath}.legacy-imported` — what this did until
+ *   0.9.2 — hangs off a path the user controls (`stateDir`, the
+ *   `DSH_CONNECT_STATE_DIR` override, `settingsStatePath`) and can delete. Move
+ *   the state directory, or delete one JSON file, and the next boot believes no
+ *   import ever ran, re-reads `settings.yaml.imported` (the host's rename keeps
+ *   the `dsh-connect:` section intact) and layers the legacy values back over
+ *   everything changed in the pane since. That is the one outcome the marker
+ *   exists to prevent, reachable by tidying up a directory.
+ * - **Not the harness home.** `$DSH_HOME` is shared by every profile, so a
+ *   marker there would let a second profile skip an import it never ran. The
+ *   profile directory is per-profile; it only moves if the profile itself does,
+ *   which is the one case where re-importing is right.
+ *
+ * The state-file suffix survives as a fallback for a caller with no entry path
+ * (a host too old to hand one over), where it is still better than no marker.
+ */
+export function legacyMarkerPath(options) {
+    if (typeof options.markerPath === "string" && options.markerPath.trim().length > 0)
+        return options.markerPath;
+    if (typeof options.entryPath === "string" && options.entryPath.trim().length > 0) {
+        return join(dirname(options.entryPath), LEGACY_IMPORT_MARKER);
+    }
+    if (typeof options.statePath === "string" && options.statePath.trim().length > 0) {
+        return `${options.statePath}.legacy-imported`;
+    }
+    return undefined;
+}
+/**
+ * Read a file, telling "not there" apart from "could not be read".
+ *
+ * Only `ENOENT` and `ENOTDIR` count as absence — `ENOTDIR` because pointing the
+ * home at a regular file makes every child path under it yield that code, which
+ * is an absence just as much as a missing directory is. Everything else
+ * (permissions, a path that is a directory, an I/O error) is a failure the
+ * caller must not mistake for an absence: see `LegacySkipReason`.
+ */
+function readFileOutcome(path) {
+    try {
+        return { kind: "text", text: readFileSync(path, "utf8") };
+    }
+    catch (error) {
+        const code = error?.code;
+        if (code === "ENOENT" || code === "ENOTDIR")
+            return { kind: "absent" };
+        return { kind: "unreadable", detail: message(error) };
+    }
+}
+/**
+ * A parse failure described without quoting the document.
+ *
+ * The `yaml` package's error message carries the offending source *lines*, and
+ * the document being parsed is the one holding `appSecret` — so reporting it
+ * verbatim would copy a credential into a boot warning. Its `code` and position
+ * are everything a user needs to find the fault in a file they already have
+ * open, so those are what is reported. Anything else keeps its first line only,
+ * for the same reason.
+ */
+function parseFailureDetail(error) {
+    if (typeof error === "object" && error !== null) {
+        const { code, linePos } = error;
+        if (typeof code === "string") {
+            const at = linePos?.[0];
+            return at === undefined ? code : `${code} at line ${at.line}, column ${at.col}`;
+        }
+    }
+    return message(error).split("\n", 1)[0] ?? "";
+}
+/** Parse YAML/JSON text, or throw a message fit for the warning line. */
+async function parseDocument(source) {
+    let parser;
+    try {
+        parser = (await import("yaml"));
+    }
+    catch (error) {
+        throw new TaggedError("parser-missing", `the "yaml" package is unavailable (${message(error)})`);
+    }
+    try {
+        return parser.parse(source);
+    }
+    catch (error) {
+        throw new TaggedError("unparseable", parseFailureDetail(error));
+    }
+}
+/** An error carrying the outcome it should produce. */
+class TaggedError extends Error {
+    tag;
+    constructor(tag, detail) {
+        super(detail);
+        this.tag = tag;
+    }
+}
+function message(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Project an object that *is* a pane section onto the declared keys, or
+ * `undefined` when nothing usable is left.
+ *
+ * `defaultChannels: false` because every caller here is reading a *source*, not
+ * writing: an absent `channels` key must stay absent so the in-force value keeps
+ * applying. The caller decides what to do about the omissions — which, given
+ * `mergeSections`, means the current list survives.
+ */
+function projectSection(raw) {
+    if (!isPlainObject(raw))
+        return undefined;
+    const section = sectionOf(raw, { defaultChannels: false });
+    return Object.keys(section).length > 0 ? section : undefined;
+}
+/**
+ * Extract the pane section from a parsed `settings.yaml`-style document: the
+ * `dsh-connect` mapping, projected onto declared keys, or `undefined` when the
+ * document has no such section (or carries nothing usable under it).
+ */
+export function sectionFromDocument(document) {
+    if (!isPlainObject(document))
+        return undefined;
+    return projectSection(document[LEGACY_CONNECT_SECTION]);
+}
+/**
+ * Extract the pane section from this plugin's own JSON state file, whose top
+ * level is already the section. A `dsh-connect` wrapper is tolerated as well,
+ * since pasting values across from the host document is a natural thing to have
+ * done — but the flat form is the one the file is actually written in.
+ */
+export function sectionOfStateDocument(document) {
+    if (!isPlainObject(document))
+        return undefined;
+    const nested = document[LEGACY_CONNECT_SECTION];
+    return projectSection(isPlainObject(nested) ? nested : document);
+}
+/**
+ * Record that the import ran.
+ *
+ * Best effort — a read-only home must not fail the boot — but not silent: the
+ * failure is not the harmless one it looks like. Without the marker the next
+ * start re-runs the whole migration, and a re-run layers the legacy values back
+ * over everything the user has changed in the pane since. The import it belongs
+ * to did its job; saying so is the difference between a user who can look at
+ * that warning and one whose settings revert on the next restart for no visible
+ * reason.
+ */
+function markAndReport(marker, body, warn) {
+    try {
+        mkdirSync(dirname(marker), { recursive: true });
+        writeFileSync(marker, body, "utf8");
+    }
+    catch (error) {
+        warn(`could not write the one-shot import marker at ${marker} (${message(error)}); ` +
+            `the migration will run again on the next start and may re-apply the legacy settings over newer pane changes`);
+    }
+}
+/**
+ * Import the pre-0.2 pane settings into the profile entry, once.
+ *
+ * Never rejects: every failure path is reported through the returned result and
+ * (for the ones a user can act on) a single warning line.
+ */
+export async function importLegacySection(options) {
+    const { write, current, logger } = options;
+    const warn = (text) => logger?.warn?.(`connect: ${text}`);
+    const marker = legacyMarkerPath(options);
+    if (marker !== undefined) {
+        const seen = readFileOutcome(marker);
+        if (seen.kind === "unreadable") {
+            // Treated as present rather than absent on purpose: re-running would layer
+            // the legacy values back over whatever the user has changed since, which is
+            // the one outcome the marker exists to prevent.
+            warn(`the import marker at ${marker} could not be read (${seen.detail}); treating the one-shot migration as already done rather than re-applying the legacy settings over newer changes`);
+            return { imported: false, skipped: "already-imported" };
+        }
+        if (seen.kind === "text")
+            return { imported: false, skipped: "already-imported" };
+    }
+    if (write === undefined) {
+        // No store to write to. Nothing is marked, so a host that gains a settings
+        // service later still gets the migration.
+        return { imported: false, skipped: "not-live" };
+    }
+    const reads = legacyCandidates(options).map((candidate) => ({ candidate, read: readFileOutcome(candidate.path) }));
+    const unreadable = reads.flatMap((entry) => entry.read.kind === "unreadable" ? [{ path: entry.candidate.path, detail: entry.read.detail }] : []);
+    if (unreadable.length > 0) {
+        // Deliberately not folded into `no-document`: this is the one branch where
+        // the user's settings may be sitting in a file we failed to open, so nothing
+        // is imported *and nothing is marked* — the next start tries again. Saying
+        // which file and why is the whole point of splitting the outcome; the usual
+        // causes are a permission, a path that is not what it looks like (a directory
+        // named `settings.yaml`), or a `~` nobody expanded.
+        for (const entry of unreadable) {
+            warn(`could not read the legacy settings candidate at ${entry.path} (${entry.detail}); nothing was imported and nothing was marked, so the migration retries on the next start`);
+        }
+        return { imported: false, skipped: "unreadable" };
+    }
+    if (reads.every((entry) => entry.read.kind === "absent")) {
+        if (marker !== undefined)
+            markAndReport(marker, `dsh-connect: no legacy settings document found\n`, warn);
+        return { imported: false, skipped: "no-document" };
+    }
+    let source;
+    let legacy;
+    for (const { candidate, read } of reads) {
+        if (read.kind !== "text")
+            continue;
+        let document;
+        try {
+            document = await parseDocument(read.text);
+        }
+        catch (error) {
+            // A malformed document stops the whole migration rather than falling
+            // through to the next candidate. The next *document* is the same file the
+            // host renamed, so it is a stale copy of the one that just failed, and the
+            // state file holds the same user's older settings — importing either in
+            // place of the section the user is looking at would be a silent
+            // substitution, and the one they would least expect. Nothing is marked, so
+            // fixing the file and restarting retries the whole thing.
+            const tag = error instanceof TaggedError ? error.tag : "unparseable";
+            warn(tag === "parser-missing"
+                ? `the legacy settings at ${candidate.path} were not imported: ${message(error)}; reinstall dsh-connect to restore the migration`
+                : `the legacy settings at ${candidate.path} could not be parsed (${message(error)}); the ${LEGACY_CONNECT_SECTION} section was left in place — fix it and restart to import it`);
+            return { imported: false, skipped: tag };
+        }
+        const found = candidate.shape === "section" ? sectionOfStateDocument(document) : sectionFromDocument(document);
+        if (found !== undefined) {
+            source = candidate.path;
+            legacy = found;
+            break;
+        }
+    }
+    if (legacy === undefined || source === undefined) {
+        if (marker !== undefined) {
+            markAndReport(marker, `dsh-connect: no ${LEGACY_CONNECT_SECTION} section to import\n`, warn);
+        }
+        return { imported: false, skipped: "no-section" };
+    }
+    // Complete section: what is in force now, with the legacy values on top. See
+    // the module doc — a partial section would reset every field it omits.
+    const section = mergeSections(current, legacy);
+    try {
+        await write(section);
+    }
+    catch (error) {
+        warn(`could not import the legacy ${LEGACY_CONNECT_SECTION} settings from ${source} into this plugin's profile entry (${message(error)}); ` +
+            `the section was left in place — fix the cause and restart to import it`);
+        return { imported: false, source, skipped: "write-failed" };
+    }
+    if (marker !== undefined) {
+        markAndReport(marker, `dsh-connect: imported the ${LEGACY_CONNECT_SECTION} section from ${source}\n`, warn);
+    }
+    logger?.info?.(`connect: imported the legacy ${LEGACY_CONNECT_SECTION} settings from ${source}`);
+    return { imported: true, source, section };
+}
+//# sourceMappingURL=legacy-import.js.map

package/lib/settings/legacy-import.js.map

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