jcoffey-dev
77e80cb9f2
119 SPDX-FileCopyrightText headers and the README's licence line. The distinction that matters here: LINUXexpert-org appears in this repository in two completely different roles. As a copyright holder in the SPDX headers, which is what changes, and as the GitHub organisation in the module path and 64 import statements, which does not -- the repository still lives at github.com/LINUXexpert-org/stalwart-migrator, and rewriting that would not be a licence change, it would break the build. Both replacements are anchored to their copyright forms, so an import path cannot match either. Import count is 64 before and after, and go.mod is untouched. LICENSE untouched: the FSF's copyright on the GPL text and the "<name of author>" placeholders are not ours to edit. go vet, go build and go test all clean.
71 lines
2.6 KiB
Go
71 lines
2.6 KiB
Go
// SPDX-FileCopyrightText: 2026 Coffey Labs
|
|
// SPDX-License-Identifier: GPL-3.0-or-later
|
|
|
|
package backup
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"os/exec"
|
|
"path/filepath"
|
|
)
|
|
|
|
// VandelayOptions configures a per-account content export via Stalwart's
|
|
// own Vandelay import/export tool - the documented, backend-independent
|
|
// backup mechanism (ARCHITECTURE.md §4.2's belt-and-suspenders layer): each
|
|
// account's mail, calendars, contacts, Sieve scripts, and identities land in
|
|
// one self-contained SQLite archive.
|
|
type VandelayOptions struct {
|
|
BinaryPath string // defaults to "vandelay"
|
|
URL string // the source JMAP server
|
|
AuthBasic string // "user:app-password", per vandelay's own --auth-basic flag
|
|
OutDir string // one <account>.sqlite file per account goes here
|
|
}
|
|
|
|
// BuildVandelayImportArgs returns vandelay's argv for exporting one
|
|
// account's content into a self-contained SQLite archive, without the
|
|
// leading "vandelay" itself. "import" is vandelay's own verb for this - it
|
|
// names the direction relative to the archive file, not the live server;
|
|
// see ARCHITECTURE.md §4.2.
|
|
func BuildVandelayImportArgs(o VandelayOptions, accountName, outFile string) []string {
|
|
return []string{
|
|
"import", "jmap",
|
|
"--url", o.URL,
|
|
"--auth-basic", o.AuthBasic,
|
|
"--account-name", accountName,
|
|
outFile,
|
|
}
|
|
}
|
|
|
|
// ExportAccount runs one account's Vandelay export and returns the archive
|
|
// path it wrote.
|
|
func ExportAccount(ctx context.Context, o VandelayOptions, accountName string) (outFile string, err error) {
|
|
binary := o.BinaryPath
|
|
if binary == "" {
|
|
binary = "vandelay"
|
|
}
|
|
outFile = filepath.Join(o.OutDir, accountName+".sqlite")
|
|
cmd := exec.CommandContext(ctx, binary, BuildVandelayImportArgs(o, accountName, outFile)...)
|
|
out, err := cmd.CombinedOutput()
|
|
if err != nil {
|
|
return "", fmt.Errorf("backup: vandelay export of %s failed: %w (output: %s)", accountName, err, out)
|
|
}
|
|
return outFile, nil
|
|
}
|
|
|
|
// ExportAccounts exports every account in accounts, stopping at the first
|
|
// failure. A partial per-account backup set is reported precisely (how many
|
|
// succeeded, which one failed and why) rather than silently continuing past
|
|
// a failure that might indicate a systemic problem - bad credentials, an
|
|
// unreachable server - rather than a one-off.
|
|
func ExportAccounts(ctx context.Context, o VandelayOptions, accounts []string) (outFiles []string, err error) {
|
|
for _, acct := range accounts {
|
|
f, err := ExportAccount(ctx, o, acct)
|
|
if err != nil {
|
|
return outFiles, fmt.Errorf("backup: exported %d/%d accounts before failing: %w", len(outFiles), len(accounts), err)
|
|
}
|
|
outFiles = append(outFiles, f)
|
|
}
|
|
return outFiles, nil
|
|
}
|