@vrtmrz/livesync-commonlib 0.1.0-rc.1 → 0.1.0-rc.3

package/dist/common/messages/combinedMessages.prod.d.ts

@@ -2597,6 +2597,12 @@ export declare const allMessages: {
         readonly ru: "Можно установить предупреждение о максимальной ёмкости базы данных.";
         readonly zh: "我们可以设置一个最大数据库容量警告,**以便在远程存储空间耗尽前采取行动**。\n您想启用这个功能吗?\n\n> [!MORE]-\n> - 0: 不警告存储大小。\n>   如果您在远程存储(尤其是自托管)上有足够的空间,则推荐此选项。您可以手动检查存储大小并重建。\n> - 800: 如果远程存储大小超过 800MB 则发出警告。\n>   如果您使用的是 fly.io(1GB 限制) 或 IBM Cloudant,则推荐此选项。\n> - 2000: 如果远程存储大小超过 2GB 则发出警告。\n\n如果达到限制,系统会要求我们逐步增大限制\n";
     };
+    readonly "moduleCheckRemoteSize.noticeExceeded": {
+        readonly def: "Remote storage size is ${measuredSize}, above the configured ${notifySize} notification threshold. {HERE}";
+    };
+    readonly "moduleCheckRemoteSize.noticeNotConfigured": {
+        readonly def: "Remote storage size notifications are not configured. {HERE}";
+    };
     readonly "moduleCheckRemoteSize.option2GB": {
         readonly def: "2GB (Standard)";
         readonly es: "2GB (Estándar)";
@@ -2667,6 +2673,9 @@ export declare const allMessages: {
         readonly ru: "Перестроить всё сейчас";
         readonly zh: "立即重建所有内容";
     };
+    readonly "moduleCheckRemoteSize.optionReview": {
+        readonly def: "Review options";
+    };
     readonly "moduleCheckRemoteSize.titleDatabaseSizeLimitExceeded": {
         readonly def: "Remote storage size exceeded the limit";
         readonly es: "El tamaño del almacenamiento remoto superó el límite";
@@ -8631,6 +8640,9 @@ export declare const allMessages: {
         readonly def: "Welcome to Self-hosted LiveSync";
         readonly zh: "欢迎使用 Self-hosted LiveSync";
     };
+    readonly "Ui.SetupWizard.Invitation.Start": {
+        readonly def: "Start setup";
+    };
     readonly "Ui.SetupWizard.OutroAskUserMode.CompatibleOption": {
         readonly def: "The remote is already set up, and the configuration is compatible (or became compatible through this operation).";
         readonly zh: "远程端已配置完成，且当前配置兼容（或已通过本次操作变为兼容）。";

package/dist/common/messages/combinedMessages.prod.js

@@ -2597,6 +2597,12 @@ const allMessages = {
     ru: "\u041C\u043E\u0436\u043D\u043E \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u0438\u0442\u044C \u043F\u0440\u0435\u0434\u0443\u043F\u0440\u0435\u0436\u0434\u0435\u043D\u0438\u0435 \u043E \u043C\u0430\u043A\u0441\u0438\u043C\u0430\u043B\u044C\u043D\u043E\u0439 \u0451\u043C\u043A\u043E\u0441\u0442\u0438 \u0431\u0430\u0437\u044B \u0434\u0430\u043D\u043D\u044B\u0445.",
     zh: "\u6211\u4EEC\u53EF\u4EE5\u8BBE\u7F6E\u4E00\u4E2A\u6700\u5927\u6570\u636E\u5E93\u5BB9\u91CF\u8B66\u544A,**\u4EE5\u4FBF\u5728\u8FDC\u7A0B\u5B58\u50A8\u7A7A\u95F4\u8017\u5C3D\u524D\u91C7\u53D6\u884C\u52A8**\u3002\n\u60A8\u60F3\u542F\u7528\u8FD9\u4E2A\u529F\u80FD\u5417?\n\n> [!MORE]-\n> - 0: \u4E0D\u8B66\u544A\u5B58\u50A8\u5927\u5C0F\u3002\n>   \u5982\u679C\u60A8\u5728\u8FDC\u7A0B\u5B58\u50A8(\u5C24\u5176\u662F\u81EA\u6258\u7BA1)\u4E0A\u6709\u8DB3\u591F\u7684\u7A7A\u95F4,\u5219\u63A8\u8350\u6B64\u9009\u9879\u3002\u60A8\u53EF\u4EE5\u624B\u52A8\u68C0\u67E5\u5B58\u50A8\u5927\u5C0F\u5E76\u91CD\u5EFA\u3002\n> - 800: \u5982\u679C\u8FDC\u7A0B\u5B58\u50A8\u5927\u5C0F\u8D85\u8FC7 800MB \u5219\u53D1\u51FA\u8B66\u544A\u3002\n>   \u5982\u679C\u60A8\u4F7F\u7528\u7684\u662F fly.io(1GB \u9650\u5236) \u6216 IBM Cloudant,\u5219\u63A8\u8350\u6B64\u9009\u9879\u3002\n> - 2000: \u5982\u679C\u8FDC\u7A0B\u5B58\u50A8\u5927\u5C0F\u8D85\u8FC7 2GB \u5219\u53D1\u51FA\u8B66\u544A\u3002\n\n\u5982\u679C\u8FBE\u5230\u9650\u5236,\u7CFB\u7EDF\u4F1A\u8981\u6C42\u6211\u4EEC\u9010\u6B65\u589E\u5927\u9650\u5236\n"
   },
+  "moduleCheckRemoteSize.noticeExceeded": {
+    def: "Remote storage size is ${measuredSize}, above the configured ${notifySize} notification threshold. {HERE}"
+  },
+  "moduleCheckRemoteSize.noticeNotConfigured": {
+    def: "Remote storage size notifications are not configured. {HERE}"
+  },
   "moduleCheckRemoteSize.option2GB": {
     def: "2GB (Standard)",
     es: "2GB (Est\xE1ndar)",
@@ -2667,6 +2673,9 @@ const allMessages = {
     ru: "\u041F\u0435\u0440\u0435\u0441\u0442\u0440\u043E\u0438\u0442\u044C \u0432\u0441\u0451 \u0441\u0435\u0439\u0447\u0430\u0441",
     zh: "\u7ACB\u5373\u91CD\u5EFA\u6240\u6709\u5185\u5BB9"
   },
+  "moduleCheckRemoteSize.optionReview": {
+    def: "Review options"
+  },
   "moduleCheckRemoteSize.titleDatabaseSizeLimitExceeded": {
     def: "Remote storage size exceeded the limit",
     es: "El tama\xF1o del almacenamiento remoto super\xF3 el l\xEDmite",
@@ -8635,6 +8644,9 @@ Note : le QR code n'est pas chiffr\xE9, soyez prudent en l'affichant.
     def: "Welcome to Self-hosted LiveSync",
     zh: "\u6B22\u8FCE\u4F7F\u7528 Self-hosted LiveSync"
   },
+  "Ui.SetupWizard.Invitation.Start": {
+    def: "Start setup"
+  },
   "Ui.SetupWizard.OutroAskUserMode.CompatibleOption": {
     def: "The remote is already set up, and the configuration is compatible (or became compatible through this operation).",
     zh: "\u8FDC\u7A0B\u7AEF\u5DF2\u914D\u7F6E\u5B8C\u6210\uFF0C\u4E14\u5F53\u524D\u914D\u7F6E\u517C\u5BB9\uFF08\u6216\u5DF2\u901A\u8FC7\u672C\u6B21\u64CD\u4F5C\u53D8\u4E3A\u517C\u5BB9\uFF09\u3002"

package/dist/common/messages/def.d.ts

@@ -278,6 +278,8 @@ export declare const PartialMessages: {
         "moduleCheckRemoteSize.msgConfirmRebuild": string;
         "moduleCheckRemoteSize.msgDatabaseGrowing": string;
         "moduleCheckRemoteSize.msgSetDBCapacity": string;
+        "moduleCheckRemoteSize.noticeExceeded": string;
+        "moduleCheckRemoteSize.noticeNotConfigured": string;
         "moduleCheckRemoteSize.option2GB": string;
         "moduleCheckRemoteSize.option800MB": string;
         "moduleCheckRemoteSize.optionAskMeLater": string;
@@ -285,6 +287,7 @@ export declare const PartialMessages: {
         "moduleCheckRemoteSize.optionIncreaseLimit": string;
         "moduleCheckRemoteSize.optionNoWarn": string;
         "moduleCheckRemoteSize.optionRebuildAll": string;
+        "moduleCheckRemoteSize.optionReview": string;
         "moduleCheckRemoteSize.titleDatabaseSizeLimitExceeded": string;
         "moduleCheckRemoteSize.titleDatabaseSizeNotify": string;
         "moduleInputUIObsidian.defaultTitleConfirmation": string;
@@ -1040,6 +1043,7 @@ export declare const PartialMessages: {
         "Ui.SetupWizard.Intro.ProceedNew": string;
         "Ui.SetupWizard.Intro.Question": string;
         "Ui.SetupWizard.Intro.Title": string;
+        "Ui.SetupWizard.Invitation.Start": string;
         "Ui.SetupWizard.OutroAskUserMode.CompatibleOption": string;
         "Ui.SetupWizard.OutroAskUserMode.CompatibleOptionDesc": string;
         "Ui.SetupWizard.OutroAskUserMode.ExistingOption": string;

package/dist/common/messagesJson/en.json

@@ -277,6 +277,8 @@
     "moduleCheckRemoteSize.msgConfirmRebuild": "This may take a bit of a long time. Do you really want to rebuild everything now?",
     "moduleCheckRemoteSize.msgDatabaseGrowing": "**Your database is getting larger!** But do not worry, we can address it now. The time before running out of space on the remote storage.\n\n| Measured size | Configured size |\n| --- | --- |\n| ${estimatedSize} | ${maxSize} |\n\n> [!MORE]-\n> If you have been using it for many years, there may be unreferenced chunks - that is, garbage - accumulating in the database. Therefore, we recommend rebuilding everything. It will probably become much smaller.\n>\n> If the volume of your vault is simply increasing, it is better to rebuild everything after organizing the files. Self-hosted LiveSync does not delete the actual data even if you delete it to speed up the process. It is roughly [documented](https://github.com/vrtmrz/obsidian-livesync/blob/main/docs/tech_info.md).\n>\n> If you don't mind the increase, you can increase the notification limit by 100MB. This is the case if you are running it on your own server. However, it is better to rebuild everything from time to time.\n>\n\n> [!WARNING]\n> If you perform rebuild everything, make sure all devices are synchronised. The plug-in will merge as much as possible, though.\n",
     "moduleCheckRemoteSize.msgSetDBCapacity": "We can set a maximum database capacity warning, **to take action before running out of space on the remote storage**.\nDo you want to enable this?\n\n> [!MORE]-\n> - 0: Do not warn about storage size.\n>   This is recommended if you have enough space on the remote storage especially you have self-hosted. And you can check the storage size and rebuild manually.\n> - 800: Warn if the remote storage size exceeds 800MB.\n>   This is recommended if you are using fly.io with 1GB limit or IBM Cloudant.\n> - 2000: Warn if the remote storage size exceeds 2GB.\n\nIf we have reached the limit, we will be asked to enlarge the limit step by step.\n",
+    "moduleCheckRemoteSize.noticeExceeded": "Remote storage size is ${measuredSize}, above the configured ${notifySize} notification threshold. {HERE}",
+    "moduleCheckRemoteSize.noticeNotConfigured": "Remote storage size notifications are not configured. {HERE}",
     "moduleCheckRemoteSize.option2GB": "2GB (Standard)",
     "moduleCheckRemoteSize.option800MB": "800MB (Cloudant, fly.io)",
     "moduleCheckRemoteSize.optionAskMeLater": "Ask me later",
@@ -284,6 +286,7 @@
     "moduleCheckRemoteSize.optionIncreaseLimit": "increase to ${newMax}MB",
     "moduleCheckRemoteSize.optionNoWarn": "No, never warn please",
     "moduleCheckRemoteSize.optionRebuildAll": "Rebuild Everything Now",
+    "moduleCheckRemoteSize.optionReview": "Review options",
     "moduleCheckRemoteSize.titleDatabaseSizeLimitExceeded": "Remote storage size exceeded the limit",
     "moduleCheckRemoteSize.titleDatabaseSizeNotify": "Setting up database size notification",
     "moduleInputUIObsidian.defaultTitleConfirmation": "Confirmation",
@@ -1039,6 +1042,7 @@
     "Ui.SetupWizard.Intro.ProceedNew": "Yes, I want to set up a new synchronisation",
     "Ui.SetupWizard.Intro.Question": "First, please select the option that best describes your current situation.",
     "Ui.SetupWizard.Intro.Title": "Welcome to Self-hosted LiveSync",
+    "Ui.SetupWizard.Invitation.Start": "Start setup",
     "Ui.SetupWizard.OutroAskUserMode.CompatibleOption": "The remote is already set up, and the configuration is compatible (or became compatible through this operation).",
     "Ui.SetupWizard.OutroAskUserMode.CompatibleOptionDesc": "Unless you are certain, selecting this option is risky. It assumes the server configuration is compatible with this device. If that is not the case, data loss may occur. Please make sure you understand the consequences.",
     "Ui.SetupWizard.OutroAskUserMode.ExistingOption": "My remote server is already set up. I want to join this device.",

package/dist/common/models/setting.const.defaults.d.ts

@@ -1,3 +1,22 @@
 import { type ObsidianLiveSyncSettings, type P2PSyncSetting } from "./setting.type.js";
 export declare const P2P_DEFAULT_SETTINGS: P2PSyncSetting;
+/**
+ * Conservative fallback values used to complete stored settings.
+ *
+ * Keep these values compatible with existing installations. Defaults intended
+ * only for a newly created Vault belong in {@link NEW_VAULT_SETTINGS}.
+ */
+export declare const SETTINGS_SCHEMA_DEFAULTS: ObsidianLiveSyncSettings;
+/**
+ * Initial values for a Vault which has never stored Self-hosted LiveSync settings.
+ *
+ * This object is deliberately separate from schema fallbacks so that future
+ * releases can improve new-user defaults without changing existing choices.
+ */
+export declare const NEW_VAULT_SETTINGS: ObsidianLiveSyncSettings;
+/** Create an independently mutable copy of the current new-Vault settings. */
+export declare function createNewVaultSettings(): ObsidianLiveSyncSettings;
+/**
+ * Compatibility name for the conservative setting-schema fallbacks.
+ */
 export declare const DEFAULT_SETTINGS: ObsidianLiveSyncSettings;

package/dist/common/models/setting.const.defaults.js

@@ -1,4 +1,5 @@
 import { ChunkAlgorithms, CURRENT_SETTING_VERSION, E2EEAlgorithms, REMOTE_COUCHDB } from "./setting.const.js";
+import { PREFERRED_BASE } from "./setting.const.preferred.js";
 import { AutoAccepting } from "./setting.type.js";
 const P2P_DEFAULT_SETTINGS = {
   P2P_Enabled: false,
@@ -22,7 +23,7 @@ const P2P_DEFAULT_SETTINGS = {
   P2P_turnCredential: "",
   P2P_useDiagRTC: false
 };
-const DEFAULT_SETTINGS = {
+const SETTINGS_SCHEMA_DEFAULTS = {
   remoteType: REMOTE_COUCHDB,
   useCustomRequestHandler: false,
   couchDB_URI: "",
@@ -145,6 +146,7 @@ const DEFAULT_SETTINGS = {
   handleFilenameCaseSensitive: void 0,
   doNotUseFixedRevisionForChunks: true,
   showLongerLogInsideEditor: false,
+  /** @deprecated Retained for settings and Setup URI compatibility. */
   sendChunksBulk: false,
   sendChunksBulkMaxSize: 1,
   /**
@@ -179,7 +181,24 @@ const DEFAULT_SETTINGS = {
   maxMTimeForReflectEvents: 0,
   tweakModified: void 0
 };
+const NEW_VAULT_SETTINGS = {
+  ...SETTINGS_SCHEMA_DEFAULTS,
+  ...PREFERRED_BASE,
+  remoteConfigurations: {},
+  pluginSyncExtendedSetting: {}
+};
+function createNewVaultSettings() {
+  return {
+    ...NEW_VAULT_SETTINGS,
+    remoteConfigurations: {},
+    pluginSyncExtendedSetting: {}
+  };
+}
+const DEFAULT_SETTINGS = SETTINGS_SCHEMA_DEFAULTS;
 export {
   DEFAULT_SETTINGS,
-  P2P_DEFAULT_SETTINGS
+  NEW_VAULT_SETTINGS,
+  P2P_DEFAULT_SETTINGS,
+  SETTINGS_SCHEMA_DEFAULTS,
+  createNewVaultSettings
 };

package/dist/common/models/setting.lifecycle.d.ts

@@ -0,0 +1,31 @@
+import type { ObsidianLiveSyncSettings } from "./setting.type.js";
+export declare const SettingsMigrationReviewCodes: {
+    readonly LegacyUpdatePending: "legacy-update-review-pending";
+    readonly FutureSchema: "settings-schema-newer-than-runtime";
+};
+export type SettingsMigrationReviewCode = (typeof SettingsMigrationReviewCodes)[keyof typeof SettingsMigrationReviewCodes];
+export interface SettingsMigrationReviewReason {
+    code: SettingsMigrationReviewCode;
+    fromVersion: number;
+    toVersion: number;
+}
+export interface SettingsMigrationState {
+    sourceVersion: number;
+    targetVersion: number;
+    isNewVault: boolean;
+    isFromFutureSchema: boolean;
+    changed: boolean;
+    requiresSyncReview: boolean;
+    reviewReasons: readonly SettingsMigrationReviewReason[];
+}
+export interface PreparedSettings extends SettingsMigrationState {
+    settings: ObsidianLiveSyncSettings;
+}
+/**
+ * Completes and migrates raw settings before services consume them.
+ *
+ * Stored settings use conservative schema fallbacks. A blank store uses the
+ * independently maintained new-Vault defaults. Explicit stored values always
+ * take precedence over both sets of defaults.
+ */
+export declare function prepareSettingsForLoad(storedSettings: Partial<ObsidianLiveSyncSettings> | undefined): PreparedSettings;

package/dist/common/models/setting.lifecycle.js

@@ -0,0 +1,109 @@
+import { createNewVaultSettings, SETTINGS_SCHEMA_DEFAULTS } from "./setting.const.defaults.js";
+import {
+  CURRENT_SETTING_VERSION,
+  SETTING_VERSION_INITIAL,
+  SETTING_VERSION_SUPPORT_CASE_INSENSITIVE
+} from "./setting.const.js";
+const SettingsMigrationReviewCodes = {
+  LegacyUpdatePending: "legacy-update-review-pending",
+  FutureSchema: "settings-schema-newer-than-runtime"
+};
+const SETTINGS_MIGRATIONS = [
+  {
+    toVersion: SETTING_VERSION_SUPPORT_CASE_INSENSITIVE,
+    apply: (settings) => settings,
+    reviewReason: (settings, fromVersion) => settings.versionUpFlash ? {
+      code: SettingsMigrationReviewCodes.LegacyUpdatePending,
+      fromVersion,
+      toVersion: SETTING_VERSION_SUPPORT_CASE_INSENSITIVE
+    } : void 0
+  }
+];
+function cloneSettings(source, fallbacks) {
+  return {
+    ...fallbacks,
+    ...source,
+    remoteConfigurations: Object.fromEntries(
+      Object.entries(source.remoteConfigurations ?? fallbacks.remoteConfigurations).map(([id, config]) => [
+        id,
+        { ...config }
+      ])
+    ),
+    pluginSyncExtendedSetting: {
+      ...fallbacks.pluginSyncExtendedSetting,
+      ...source.pluginSyncExtendedSetting
+    }
+  };
+}
+function storedSettingVersion(settings) {
+  const version = settings.settingVersion;
+  return typeof version === "number" && Number.isSafeInteger(version) && version >= SETTING_VERSION_INITIAL ? version : SETTING_VERSION_INITIAL;
+}
+function isBlankSettings(settings) {
+  return settings === void 0 || Object.keys(settings).length === 0;
+}
+function prepareSettingsForLoad(storedSettings) {
+  if (isBlankSettings(storedSettings)) {
+    return {
+      settings: createNewVaultSettings(),
+      sourceVersion: CURRENT_SETTING_VERSION,
+      targetVersion: CURRENT_SETTING_VERSION,
+      isNewVault: true,
+      isFromFutureSchema: false,
+      changed: false,
+      requiresSyncReview: false,
+      reviewReasons: []
+    };
+  }
+  const source = { ...storedSettings };
+  const sourceVersion = storedSettingVersion(source);
+  if (sourceVersion > CURRENT_SETTING_VERSION) {
+    const reviewReasons2 = [
+      {
+        code: SettingsMigrationReviewCodes.FutureSchema,
+        fromVersion: sourceVersion,
+        toVersion: CURRENT_SETTING_VERSION
+      }
+    ];
+    return {
+      settings: cloneSettings(source, SETTINGS_SCHEMA_DEFAULTS),
+      sourceVersion,
+      targetVersion: sourceVersion,
+      isNewVault: false,
+      isFromFutureSchema: true,
+      changed: false,
+      requiresSyncReview: true,
+      reviewReasons: reviewReasons2
+    };
+  }
+  let migrated = source;
+  let targetVersion = sourceVersion;
+  const reviewReasons = [];
+  for (const migration of SETTINGS_MIGRATIONS) {
+    if (targetVersion >= migration.toVersion) continue;
+    const reason = migration.reviewReason?.(migrated, targetVersion);
+    if (reason) reviewReasons.push(reason);
+    migrated = migration.apply(migrated);
+    targetVersion = migration.toVersion;
+    migrated.settingVersion = targetVersion;
+  }
+  if (targetVersion !== CURRENT_SETTING_VERSION) {
+    throw new Error(
+      `No setting migration reaches schema ${CURRENT_SETTING_VERSION} from schema ${sourceVersion}.`
+    );
+  }
+  return {
+    settings: cloneSettings(migrated, SETTINGS_SCHEMA_DEFAULTS),
+    sourceVersion,
+    targetVersion,
+    isNewVault: false,
+    isFromFutureSchema: false,
+    changed: sourceVersion !== targetVersion,
+    requiresSyncReview: reviewReasons.length > 0,
+    reviewReasons
+  };
+}
+export {
+  SettingsMigrationReviewCodes,
+  prepareSettingsForLoad
+};

package/dist/common/models/setting.type.d.ts

@@ -668,11 +668,13 @@ interface ObsoleteRemoteDBSettings {
      */
     disableRequestURI: boolean;
     /**
-     * Indicates whether to send data in bulk chunks.
+     * Retained for settings and Setup URI compatibility.
+     * Automatic bulk chunk pre-send is no longer supported.
+     * @deprecated
      */
     sendChunksBulk: boolean;
     /**
-     * The maximum size of the bulk chunks to be sent.
+     * The maximum request size used by the explicit manual chunk resend tool, in MB.
      */
     sendChunksBulkMaxSize: number;
     /**

package/dist/common/settingConstants.js

@@ -328,8 +328,8 @@ const SettingInformation = {
     desc: "If this enabled, all chunks will be stored with the revision made from its content."
   },
   sendChunksBulkMaxSize: {
-    name: "Maximum size of chunks to send in one request",
-    desc: "MB"
+    name: "Maximum request size for manually resending chunks",
+    desc: "MB per request"
   },
   useAdvancedMode: {
     name: "Enable advanced features"

package/dist/common/types.d.ts

@@ -10,7 +10,8 @@ import { IDPrefixes, LEAF_WAIT_ONLY_REMOTE, LEAF_WAIT_TIMEOUT, LEAF_WAIT_TIMEOUT
 import { AutoAccepting, type BucketSyncSetting, type ChunkSplitterVersion, type ConfigPassphraseStore, type CouchDBConnection, type E2EEAlgorithm, type EncryptionSettings, type HashAlgorithm, type HasSettings, type LocalDBSettings, type ObsidianLiveSyncSettings, type P2PConnectionInfo, type P2PSyncSetting, type PluginSyncSettingEntry, type RemoteDBSettings, type RemoteType, type RemoteTypeSettings, type SYNC_MODE } from "./models/setting.type.js";
 import { ChunkAlgorithmNames, ChunkAlgorithms, CURRENT_SETTING_VERSION, E2EEAlgorithmNames, E2EEAlgorithms, HashAlgorithms, REMOTE_COUCHDB, REMOTE_MINIO, REMOTE_P2P, RemoteTypes, SETTING_VERSION_INITIAL, SETTING_VERSION_SUPPORT_CASE_INSENSITIVE, MODE_AUTOMATIC, MODE_PAUSED, MODE_SELECTIVE, MODE_SHINY } from "./models/setting.const.js";
 import { PREFERRED_BASE, PREFERRED_JOURNAL_SYNC, PREFERRED_SETTING_CLOUDANT, PREFERRED_SETTING_SELF_HOSTED } from "./models/setting.const.preferred.js";
-import { P2P_DEFAULT_SETTINGS, DEFAULT_SETTINGS } from "./models/setting.const.defaults.js";
+import { P2P_DEFAULT_SETTINGS, DEFAULT_SETTINGS, NEW_VAULT_SETTINGS, SETTINGS_SCHEMA_DEFAULTS, createNewVaultSettings } from "./models/setting.const.defaults.js";
+import { prepareSettingsForLoad, SettingsMigrationReviewCodes, type PreparedSettings, type SettingsMigrationReviewCode, type SettingsMigrationReviewReason, type SettingsMigrationState } from "./models/setting.lifecycle.js";
 import { KeyIndexOfSettings } from "./models/setting.const.qr.js";
 import type { DeviceInfo, EntryBody, EntryDoc, EntryDocResponse, EntryMilestoneInfo, EntryNodeInfo, NodeData, NodeKey } from "./models/db.definition.js";
 import { isMetaEntry } from "./models/db.definition.js";
@@ -42,7 +43,8 @@ export type { EncryptionSettings };
 export { HashAlgorithms, type HashAlgorithm, ChunkAlgorithmNames, ChunkAlgorithms, type ChunkSplitterVersion };
 export type { RemoteDBSettings };
 export type { ObsidianLiveSyncSettings };
-export { DEFAULT_SETTINGS };
+export { DEFAULT_SETTINGS, NEW_VAULT_SETTINGS, SETTINGS_SCHEMA_DEFAULTS, createNewVaultSettings };
+export { prepareSettingsForLoad, SettingsMigrationReviewCodes, type PreparedSettings, type SettingsMigrationReviewCode, type SettingsMigrationReviewReason, type SettingsMigrationState, };
 export { KeyIndexOfSettings };
 export { type HasSettings };
 export { PREFERRED_BASE, PREFERRED_SETTING_CLOUDANT, PREFERRED_SETTING_SELF_HOSTED, PREFERRED_JOURNAL_SYNC };

package/dist/common/types.js

@@ -67,7 +67,17 @@ import {
   PREFERRED_SETTING_CLOUDANT,
   PREFERRED_SETTING_SELF_HOSTED
 } from "./models/setting.const.preferred.js";
-import { P2P_DEFAULT_SETTINGS, DEFAULT_SETTINGS } from "./models/setting.const.defaults.js";
+import {
+  P2P_DEFAULT_SETTINGS,
+  DEFAULT_SETTINGS,
+  NEW_VAULT_SETTINGS,
+  SETTINGS_SCHEMA_DEFAULTS,
+  createNewVaultSettings
+} from "./models/setting.const.defaults.js";
+import {
+  prepareSettingsForLoad,
+  SettingsMigrationReviewCodes
+} from "./models/setting.lifecycle.js";
 import { KeyIndexOfSettings } from "./models/setting.const.qr.js";
 import { isMetaEntry } from "./models/db.definition.js";
 import {
@@ -165,6 +175,7 @@ export {
   MODE_PAUSED,
   MODE_SELECTIVE,
   MODE_SHINY,
+  NEW_VAULT_SETTINGS,
   NODEINFO_DOCID,
   NOT_CONFLICTED,
   NoteTypes,
@@ -190,10 +201,12 @@ export {
   SALT_OF_ID,
   SALT_OF_PASSPHRASE,
   SEED_MURMURHASH,
+  SETTINGS_SCHEMA_DEFAULTS,
   SETTING_KEY_P2P_DEVICE_NAME,
   SETTING_VERSION_INITIAL,
   SETTING_VERSION_SUPPORT_CASE_INSENSITIVE,
   SYNCINFO_ID,
+  SettingsMigrationReviewCodes,
   SuffixDatabaseName,
   TIME_ARGUMENT_INFINITY,
   TweakValuesDefault,
@@ -207,6 +220,8 @@ export {
   configURIBase,
   configURIBaseQR,
   configurationNames,
+  createNewVaultSettings,
   isMetaEntry,
+  prepareSettingsForLoad,
   statusDisplay
 };

package/dist/interfaces/Confirm.d.ts

@@ -1,3 +1,4 @@
+export type ConfirmActionLayout = "auto" | "vertical";
 export interface Confirm {
     askYesNo(message: string): Promise<"yes" | "no">;
     askString(title: string, key: string, placeholder: string, isPassword?: boolean): Promise<string | false>;
@@ -12,6 +13,13 @@ export interface Confirm {
         defaultAction: T[number];
         timeout?: number;
     }): Promise<T[number] | false>;
-    askInPopup(key: string, dialogText: string, anchorCallback: (anchor: HTMLAnchorElement) => void): void;
-    confirmWithMessage(title: string, contentMd: string, buttons: string[], defaultAction: (typeof buttons)[number], timeout?: number): Promise<(typeof buttons)[number] | false>;
+    /**
+     * Shows a non-blocking message containing one host-rendered action link.
+     *
+     * Hosts which can display transient UI should keep the message visible for
+     * `durationMs`. Headless hosts may report the message without presenting an
+     * interactive action.
+     */
+    askInPopup(key: string, dialogText: string, anchorCallback: (anchor: HTMLAnchorElement) => void, durationMs?: number): void;
+    confirmWithMessage(title: string, contentMd: string, buttons: string[], defaultAction: (typeof buttons)[number], timeout?: number, actionLayout?: ConfirmActionLayout): Promise<(typeof buttons)[number] | false>;
 }

package/dist/interfaces/DatabaseRebuilder.d.ts

@@ -4,8 +4,18 @@ export interface Rebuilder {
     $rebuildEverything(): Promise<void>;
     $fetchLocal(makeLocalChunkBeforeSync?: boolean, preventMakeLocalFilesBeforeSync?: boolean): Promise<void>;
     $fetchLocalDBFast(autoResume: boolean): Promise<void>;
-    scheduleRebuild(): Promise<void>;
-    scheduleFetch(): Promise<void>;
+    /**
+     * Writes the Rebuild flag, suspends the current runtime, optionally prepares
+     * persisted state, and requests a restart, in that order.
+     *
+     * The preparation callback runs only after the flag exists. If it fails,
+     * the flag is removed, the current runtime is resumed, and the error is
+     * rethrown. A false result means that the flag could not be written and no
+     * restart was requested.
+     */
+    scheduleRebuild(prepareBeforeRestart?: () => Promise<void>): Promise<boolean>;
+    /** See {@link scheduleRebuild}; this variant writes the Fetch flag. */
+    scheduleFetch(prepareBeforeRestart?: () => Promise<void>): Promise<boolean>;
     /**
      * Declares the finish of the rebuild process and unlock remote, resume reflecting the changes.
      */

package/dist/remoteConfigurations.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Focused public primitives for storing and selecting multiple remote connection profiles.
+ *
+ * The compatibility fields remain available to existing hosts, but new profile-management code
+ * should use this entry point instead of importing the wider service feature module.
+ */
+export { activateP2PRemoteConfiguration, activateRemoteConfiguration, createRemoteConfigurationId, suggestRemoteConfigurationName, upsertRemoteConfigurationInPlace, } from "./serviceFeatures/remoteConfig.js";
+export type { SerializableRemoteConfigurationType, UpsertRemoteConfigurationOptions, } from "./serviceFeatures/remoteConfig.js";
+export type { RemoteConfiguration } from "./common/models/setting.type.js";

package/dist/remoteConfigurations.js

@@ -0,0 +1,14 @@
+import {
+  activateP2PRemoteConfiguration,
+  activateRemoteConfiguration,
+  createRemoteConfigurationId,
+  suggestRemoteConfigurationName,
+  upsertRemoteConfigurationInPlace
+} from "./serviceFeatures/remoteConfig.js";
+export {
+  activateP2PRemoteConfiguration,
+  activateRemoteConfiguration,
+  createRemoteConfigurationId,
+  suggestRemoteConfigurationName,
+  upsertRemoteConfigurationInPlace
+};

package/dist/replication/LiveSyncAbstractReplicator.d.ts

@@ -34,7 +34,6 @@ export declare abstract class LiveSyncAbstractReplicator {
     remoteLockedAndDeviceNotAccepted: boolean;
     tweakSettingsMismatched: boolean;
     preferredTweakValue?: TweakValues;
-    abstract get isChunkSendingSupported(): boolean;
     get database(): import("../pouchdb/LiveSyncLocalDB.js").LiveSyncLocalDB;
     get rawDatabase(): PouchDB.Database<EntryDoc>;
     get currentSettings(): import("../common/types.js").ObsidianLiveSyncSettings;
@@ -49,7 +48,7 @@ export declare abstract class LiveSyncAbstractReplicator {
     abstract openReplication(setting: RemoteDBSettings, keepAlive: boolean, showResult: boolean, ignoreCleanLock: boolean): Promise<void | boolean>;
     updateInfo: () => void;
     abstract tryConnectRemote(setting: RemoteDBSettings, showResult?: boolean): Promise<boolean>;
-    abstract replicateAllToServer(setting: RemoteDBSettings, showingNotice?: boolean, sendChunksInBulkDisabled?: boolean): Promise<boolean>;
+    abstract replicateAllToServer(setting: RemoteDBSettings, showingNotice?: boolean): Promise<boolean>;
     abstract replicateAllFromServer(setting: RemoteDBSettings, showingNotice?: boolean): Promise<boolean>;
     abstract closeReplication(): void;
     abstract tryResetRemoteDatabase(setting: RemoteDBSettings): Promise<void>;

package/dist/replication/couchdb/LiveSyncReplicator.d.ts

@@ -5,7 +5,6 @@ export interface LiveSyncCouchDBReplicatorEnv extends LiveSyncReplicatorEnv {
     services: ServiceHub;
 }
 export declare class LiveSyncCouchDBReplicator extends LiveSyncAbstractReplicator {
-    get isChunkSendingSupported(): boolean;
     isMobile(): boolean;
     constructor(env: LiveSyncCouchDBReplicatorEnv);
     getInitialSyncParameters(setting: RemoteDBSettings): Promise<SyncParameters>;

package/dist/replication/couchdb/LiveSyncReplicator.js

@@ -85,9 +85,6 @@ async function* genReplication(s, signal) {
   }
 }
 class LiveSyncCouchDBReplicator extends LiveSyncAbstractReplicator {
-  get isChunkSendingSupported() {
-    return true;
-  }
   isMobile() {
     return this.env.services.API.isMobile();
   }

package/dist/replication/journal/LiveSyncJournalReplicator.d.ts

@@ -7,7 +7,6 @@ import { type SimpleStore } from "../../common/utils.js";
 import type { LiveSyncJournalReplicatorEnv } from "./LiveSyncJournalReplicatorEnv.js";
 export declare class LiveSyncJournalReplicator extends LiveSyncAbstractReplicator {
     env: LiveSyncJournalReplicatorEnv;
-    get isChunkSendingSupported(): boolean;
     get client(): JournalSyncCore;
     get simpleStore(): SimpleStore<CheckPointInfo>;
     _client: JournalSyncCore;

package/dist/replication/journal/LiveSyncJournalReplicator.js

@@ -19,9 +19,6 @@ const currentVersionRange = {
   current: 2
 };
 class LiveSyncJournalReplicator extends LiveSyncAbstractReplicator {
-  get isChunkSendingSupported() {
-    return false;
-  }
   get client() {
     return this.setupJournalSyncClient();
   }

package/dist/replication/trystero/LiveSyncTrysteroReplicator.d.ts

@@ -18,13 +18,15 @@ export interface LiveSyncTrysteroReplicatorEnv extends LiveSyncReplicatorEnv {
 export declare class LiveSyncTrysteroReplicator extends LiveSyncAbstractReplicator {
     private _p2pHost?;
     private _replicator?;
+    private _lifecycleOperation;
+    private _shouldBeOpen;
     get openReplicationUI(): (showResult: boolean) => Promise<boolean | void>;
     get rawReplicator(): TrysteroReplicator;
     get rawHost(): P2PHost;
-    get isChunkSendingSupported(): boolean;
     getReplicationPBKDF2Salt(_setting: RemoteDBSettings, _refresh?: boolean): Promise<Uint8Array<ArrayBuffer>>;
     terminateSync(): void;
     private _buildEnv;
+    private _enqueueLifecycleOperation;
     open(): Promise<void>;
     close(): Promise<void>;
     closeReplication(): void;
@@ -36,7 +38,7 @@ export declare class LiveSyncTrysteroReplicator extends LiveSyncAbstractReplicat
     onNewPeer(peer: Advertisement): Promise<void>;
     onPeerLeaved(peerId: string): void;
     replicateFromCommand(showResult?: boolean): Promise<void>;
-    replicateFrom(peerId: string, showNotice?: boolean): Promise<{
+    replicateFrom(peerId: string, showNotice?: boolean, skipOrdinaryReplicationPolicy?: boolean): Promise<{
         error: any;
         ok?: undefined;
     } | {
@@ -67,7 +69,7 @@ export declare class LiveSyncTrysteroReplicator extends LiveSyncAbstractReplicat
     makeSureOpened(): Promise<void>;
     openReplication(_setting: RemoteDBSettings, _keepAlive: boolean, showResult: boolean, _ignoreCleanLock: boolean): Promise<void | boolean>;
     tryConnectRemote(_setting: RemoteDBSettings, _showResult?: boolean): Promise<boolean>;
-    replicateAllToServer(_setting: RemoteDBSettings, _showingNotice?: boolean, _sendChunksInBulkDisabled?: boolean): Promise<boolean>;
+    replicateAllToServer(_setting: RemoteDBSettings, _showingNotice?: boolean): Promise<boolean>;
     selectPeer(settingPeerName: string, r: TrysteroReplicator, logLevel: LOG_LEVEL): Promise<string | false>;
     tryUntilSuccess<T>(func: () => Promise<T | false>, repeat: number, logLevel: LOG_LEVEL): Promise<T | false>;
     replicateAllFromServer(setting: RemoteDBSettings, showingNotice?: boolean): Promise<boolean>;