11th March, 2026

Now, Self-hosted LiveSync has finally begun to be split into the Self-hosted LiveSync plugin for Obsidian, and a properly abstracted version of it.
This may not offer much benefit to Obsidian plugin users, or might even cause a slight inconvenience, but I believe it will certainly help improve testability and make the ecosystem better.
However, I do not see the point in putting something with little benefit into beta, so I am handling this on the alpha branch. I would actually preferred to create an R&D branch, but I was not keen on the ampersand, and I feel it will eventually become a proper beta anyway.

### Refactored

- Separated `ObsidianLiveSyncPlugin` into `ObsidianLiveSyncPlugin` and `LiveSyncBaseCore`.
- Now `LiveSyncCore` indicates the type specified version of `LiveSyncBaseCore`.
- Referencing `plugin.xxx` has been rewritten to referencing the corresponding service or `core.xxx`.

### Internal API changes

- Storage Access APIs are now yielding Promises. This is to allow more limited storage platforms to be supported.

### R&D

- Browser-version of Self-hosted LiveSync is now in development. This is not intended for public use now, but I will eventually make it available for testing.
- We can see the code in `src/apps/webapp` for the browser version.

src/modules/extras/ModuleReplicateTest.ts

@@ -1,3 +1,4 @@
+// I intend to discontinue maintenance of this class. It seems preferable to test it externally.
 import { delay } from "octagonal-wheels/promises";
 import { AbstractObsidianModule } from "../AbstractObsidianModule.ts";
 import { LOG_LEVEL_INFO, LOG_LEVEL_NOTICE, LOG_LEVEL_VERBOSE } from "octagonal-wheels/common/logger";
@@ -169,7 +170,7 @@ export class ModuleReplicateTest extends AbstractObsidianModule {
             this._log("No storage access", LOG_LEVEL_INFO);
             return;
         }
-        const files = this.core.storageAccess.getFiles();
+        const files = await this.core.storageAccess.getFiles();
         const out = [] as any[];
         const webcrypto = await getWebCrypto();
         for (const file of files) {
@@ -205,8 +206,8 @@ export class ModuleReplicateTest extends AbstractObsidianModule {
     }
 
     async __dumpFileListIncludeHidden(outFile?: string) {
-        const ignorePatterns = getFileRegExp(this.plugin.settings, "syncInternalFilesIgnorePatterns");
-        const targetPatterns = getFileRegExp(this.plugin.settings, "syncInternalFilesTargetPatterns");
+        const ignorePatterns = getFileRegExp(this.core.settings, "syncInternalFilesIgnorePatterns");
+        const targetPatterns = getFileRegExp(this.core.settings, "syncInternalFilesTargetPatterns");
         const out = [] as any[];
         const files = await this.core.storageAccess.getFilesIncludeHidden("", targetPatterns, ignorePatterns);
         // console.dir(files);

src/modules/extras/devUtil/TestPane.svelte

@@ -9,6 +9,7 @@
     import { writable } from "svelte/store";
     export let plugin: ObsidianLiveSyncPlugin;
     export let moduleDev: ModuleDev;
+    $: core = plugin.core;
     let performanceTestResult = "";
     let functionCheckResult = "";
     let testRunning = false;
@@ -42,7 +43,7 @@
         // performTest();
 
         eventHub.onceEvent(EVENT_LAYOUT_READY, async () => {
-            if (await plugin.storageAccess.isExistsIncludeHidden("_AUTO_TEST.md")) {
+            if (await core.storageAccess.isExistsIncludeHidden("_AUTO_TEST.md")) {
                 new Notice("Auto test file found, running tests...");
                 fireAndForget(async () => {
                     await allTest();
@@ -57,14 +58,14 @@
     function moduleMultiDeviceTest() {
         if (moduleTesting) return;
         moduleTesting = true;
-        plugin.services.test.testMultiDevice().finally(() => {
+        core.services.test.testMultiDevice().finally(() => {
             moduleTesting = false;
         });
     }
     function moduleSingleDeviceTest() {
         if (moduleTesting) return;
         moduleTesting = true;
-        plugin.services.test.test().finally(() => {
+        core.services.test.test().finally(() => {
             moduleTesting = false;
         });
     }
@@ -72,8 +73,8 @@
         if (moduleTesting) return;
         moduleTesting = true;
         try {
-            await plugin.services.test.test();
-            await plugin.services.test.testMultiDevice();
+            await core.services.test.test();
+            await core.services.test.testMultiDevice();
         } finally {
             moduleTesting = false;
         }

src/modules/extras/devUtil/testUtils.ts

@@ -38,8 +38,8 @@ export function addDebugFileLog(message: any, stackLog = false) {
             // const out = "--" + timestamp + "--\n" + messageContent + " " + (stack || "");
             // const out
             try {
-                await plugin.storageAccess.appendHiddenFile(
-                    plugin.app.vault.configDir + "/ls-debug/" + outFile,
+                await plugin.core.storageAccess.appendHiddenFile(
+                    plugin.core.services.API.getSystemConfigDir() + "/ls-debug/" + outFile,
                     JSON.stringify(out) + "\n"
                 );
             } catch {

src/modules/extras/devUtil/tests.ts

@@ -48,7 +48,7 @@ async function formatPerfResults(items: NamedMeasureResult[]) {
 }
 export async function perf_trench(plugin: ObsidianLiveSyncPlugin) {
     clearResult("trench");
-    const trench = new Trench(plugin.simpleStore);
+    const trench = new Trench(plugin.core.simpleStore);
     const result = [] as NamedMeasureResult[];
     result.push(
         await measure("trench-short-string", async () => {
@@ -57,7 +57,7 @@ export async function perf_trench(plugin: ObsidianLiveSyncPlugin) {
         })
     );
     {
-        const testBinary = await plugin.storageAccess.readHiddenFileBinary("testdata/10kb.png");
+        const testBinary = await plugin.core.storageAccess.readHiddenFileBinary("testdata/10kb.png");
         const uint8Array = new Uint8Array(testBinary);
         result.push(
             await measure("trench-binary-10kb", async () => {
@@ -67,7 +67,7 @@ export async function perf_trench(plugin: ObsidianLiveSyncPlugin) {
         );
     }
     {
-        const testBinary = await plugin.storageAccess.readHiddenFileBinary("testdata/100kb.jpeg");
+        const testBinary = await plugin.core.storageAccess.readHiddenFileBinary("testdata/100kb.jpeg");
         const uint8Array = new Uint8Array(testBinary);
         result.push(
             await measure("trench-binary-100kb", async () => {
@@ -77,7 +77,7 @@ export async function perf_trench(plugin: ObsidianLiveSyncPlugin) {
         );
     }
     {
-        const testBinary = await plugin.storageAccess.readHiddenFileBinary("testdata/1mb.png");
+        const testBinary = await plugin.core.storageAccess.readHiddenFileBinary("testdata/1mb.png");
         const uint8Array = new Uint8Array(testBinary);
         result.push(
             await measure("trench-binary-1mb", async () => {