Complete central provider, resource, scheduling, and recovery contracts

src/common/replicatorResources/connection.ts

@@ -8,6 +8,7 @@ import {
     LiveSyncCouchDBReplicator,
     type LiveSyncCouchDBReplicatorEnv,
 } from "@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator";
+import { LOG_LEVEL_NOTICE, Logger } from "@vrtmrz/livesync-commonlib/compat/common/logger";
 import { LiveSyncJournalReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/journal/LiveSyncJournalReplicator";
 import { createReplicatorDisposer, snapshotRemoteSettings } from "./shared";
 
@@ -16,7 +17,8 @@ export type ConnectionResourceHost = LiveSyncCouchDBReplicatorEnv;
 
 function createCouchDBConnectionProbe(
     replicator: LiveSyncCouchDBReplicator,
-    snapshot: RemoteDBSettings
+    snapshot: RemoteDBSettings,
+    host: ConnectionResourceHost
 ): RemoteConnectionProbe {
     const dispose = createReplicatorDisposer(replicator);
     return {
@@ -28,9 +30,22 @@ function createCouchDBConnectionProbe(
                 false
             );
             if (typeof connection === "string") {
+                if (options.showResult) {
+                    Logger(
+                        host.services.context.translate("liveSyncReplicator.couldNotConnectTo", {
+                            uri: snapshot.couchDB_URI,
+                            name: snapshot.couchDB_DBNAME,
+                            db: connection,
+                        }),
+                        LOG_LEVEL_NOTICE
+                    );
+                }
                 return { ok: false, reason: connection };
             }
             try {
+                if (options.showResult) {
+                    Logger(`Connected to ${connection.info.db_name} successfully`, LOG_LEVEL_NOTICE);
+                }
                 return { ok: true };
             } finally {
                 await connection.close();
@@ -64,12 +79,14 @@ function createObjectStorageConnectionProbe(
  * Build an unpublished CouchDB connection probe for one host.
  *
  * The probe owns both its concrete Replicator and each connection it opens. It
- * never publishes that Replicator as the active provider instance.
+ * never publishes that Replicator as the active provider instance. A caller
+ * may request the established result Notice explicitly; ordinary probes remain
+ * silent.
  */
 export function createCouchDBConnectionProbeFactory(host: ConnectionResourceHost): ConnectionProbeFactory {
     return (setting) => {
         const snapshot = snapshotRemoteSettings(setting);
-        return Promise.resolve(createCouchDBConnectionProbe(new LiveSyncCouchDBReplicator(host), snapshot));
+        return Promise.resolve(createCouchDBConnectionProbe(new LiveSyncCouchDBReplicator(host), snapshot, host));
     };
 }
 

src/common/replicatorResources/synchronisationInformation.ts

@@ -10,7 +10,9 @@ import { createReplicatorDisposer, snapshotRemoteSettings } from "./shared";
  * Build an unpublished CouchDB synchronisation-information verifier.
  *
  * The resource owns its concrete Replicator and connection, and cannot replace
- * the active provider instance.
+ * the active provider instance. Its check resolves to `false` only for observed
+ * incompatibility; connection, setup, and verification failures reject so the
+ * caller can report an operational failure separately.
  */
 export function createCouchDBSynchronisationInformationResourceFactory(
     host: LiveSyncCouchDBReplicatorEnv
@@ -26,7 +28,7 @@ export function createCouchDBSynchronisationInformationResourceFactory(
                     true
                 );
                 if (typeof connection === "string") {
-                    return false;
+                    throw new Error(connection);
                 }
                 try {
                     return await checkSyncInfo(connection.db);