feat: add plugin system (#1034)

* feat: add plugin system * fix db docker build * fix hammerhead readme, add strava subscription news to docs * fixes and sdk improvements * fix: reduce Meilisearch load, debounce federation sync (#1012) * optimize meili trail index * several fixes --------- Co-authored-by: Flomp <Flomp@users.noreply.github.com> * Bump svelte from 5.55.5 to 5.56.0 in /docs (#1032) Bumps [svelte](https://github.com/sveltejs/svelte/tree/HEAD/packages/svelte) from 5.55.5 to 5.56.0. - [Release notes](https://github.com/sveltejs/svelte/releases) - [Changelog](https://github.com/sveltejs/svelte/blob/main/packages/svelte/CHANGELOG.md) - [Commits](https://github.com/sveltejs/svelte/commits/svelte@5.56.0/packages/svelte) --- updated-dependencies: - dependency-name: svelte dependency-version: 5.56.0 dependency-type: direct:production ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Flomp <Flomp@users.noreply.github.com> * Release v0.19.2 (#1035) * chore: release v0.19.2 * add changelog --------- Co-authored-by: Flomp <26000991+Flomp@users.noreply.github.com> Co-authored-by: Christian Beutel <> * speed up plugin sync and several small fixes * concepts for security improvements and process stability * improve concept * security concept implemented * remove insecure TLS * worker concept implemented * fixes and cleanup * fixes * docu * mermaid, namings * WASM plugin host improvements, plugin logging * fix db migration * Improve plugin config and category mapping UI * fixes * further fixes * remove manual test sync * fix db migration and strava mapping * type added, UI improvements * fix plugin card toggle clickable area * optimize synch status card layout * plugin type 'trails' instead of 'integration' * session auth validation in UI * fix komoot date and waypoints * improve category mapping * fix send to hammerhead: trail name * plugin setup error handling improved * fix review findings * re-mapping added * rename remote_category --------- Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: Flomp <Flomp@users.noreply.github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Flomp <26000991+Flomp@users.noreply.github.com>
2026-06-22 15:00:44 +02:00
parent 2e3d8537b8
commit 485ec53f6d
196 changed files with 20947 additions and 5454 deletions
--- a/db/pluginsystem/installed.go
+++ b/db/pluginsystem/installed.go
@@ -0,0 +1,98 @@
+package pluginsystem
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+
+	"github.com/pocketbase/dbx"
+	"github.com/pocketbase/pocketbase/core"
+)
+
+// LoadInstalledPlugin resolves one plugin from the installed_plugins cache. If
+// the cache record is missing or stale, it falls back to the local plugin
+// directory so newly copied bundles can still be discovered.
+func LoadInstalledPlugin(app core.App, dir string, pluginID string) (LocalPlugin, error) {
+	if pluginID == "" {
+		return LocalPlugin{}, fmt.Errorf("plugin id is required")
+	}
+	record, _ := app.FindFirstRecordByFilter(
+		"installed_plugins",
+		"plugin_id={:plugin_id}",
+		dbx.Params{"plugin_id": pluginID},
+	)
+	if record != nil {
+		plugin, err := localPluginFromRecord(record)
+		if err == nil {
+			return plugin, nil
+		}
+	}
+
+	if dir == "" {
+		dir = PluginDir()
+	}
+	plugins, err := LoadLocalPlugins(dir)
+	if err != nil {
+		return LocalPlugin{}, err
+	}
+	for _, plugin := range plugins {
+		if plugin.Manifest.ID == pluginID {
+			return plugin, nil
+		}
+	}
+	return LocalPlugin{}, fmt.Errorf("unknown plugin")
+}
+
+// LoadInstalledPlugins returns the cached installed plugin manifests used by
+// request hot paths, with disk discovery as a bootstrap fallback.
+func LoadInstalledPlugins(app core.App, dir string) ([]LocalPlugin, error) {
+	records, err := app.FindRecordsByFilter("installed_plugins", "", "", -1, 0)
+	if err != nil {
+		return nil, err
+	}
+
+	plugins := make([]LocalPlugin, 0, len(records))
+	for _, record := range records {
+		plugin, err := localPluginFromRecord(record)
+		if err != nil {
+			continue
+		}
+		plugins = append(plugins, plugin)
+	}
+	if len(plugins) > 0 {
+		return plugins, nil
+	}
+	if dir == "" {
+		dir = PluginDir()
+	}
+	return LoadLocalPlugins(dir)
+}
+
+func localPluginFromRecord(record *core.Record) (LocalPlugin, error) {
+	var manifest Manifest
+	if err := record.UnmarshalJSONField("manifest", &manifest); err != nil {
+		return LocalPlugin{}, err
+	}
+	if err := ValidateManifest(manifest); err != nil {
+		return LocalPlugin{}, err
+	}
+
+	dir := strings.TrimSpace(record.GetString("path"))
+	if dir == "" {
+		return LocalPlugin{}, fmt.Errorf("installed plugin path is empty")
+	}
+	entrypoint := filepath.Clean(manifest.Runtime.Entrypoint)
+	if filepath.IsAbs(entrypoint) || entrypoint == ".." || strings.HasPrefix(entrypoint, ".."+string(filepath.Separator)) {
+		return LocalPlugin{}, fmt.Errorf("runtime entrypoint must be relative to plugin directory")
+	}
+	wasmPath := filepath.Join(dir, entrypoint)
+	if _, err := os.Stat(wasmPath); err != nil {
+		return LocalPlugin{}, fmt.Errorf("runtime entrypoint: %w", err)
+	}
+	return LocalPlugin{
+		Manifest: manifest,
+		Dir:      dir,
+		WASMPath: wasmPath,
+	}, nil
+}