@vrtmrz/livesync-commonlib 0.1.23 → 0.1.25

package/dist/common/models/tweak.definition.js

@@ -1,33 +1,63 @@
 import { ChunkAlgorithms, E2EEAlgorithms } from "./setting.const.js";
 import { DEFAULT_SETTINGS } from "./setting.const.defaults.js";
-const TweakValuesShouldMatchedTemplate = {
-  minimumChunkSize: 20,
-  longLineThreshold: 250,
-  encrypt: false,
-  usePathObfuscation: false,
-  enableCompression: false,
-  useEden: false,
-  customChunkSize: 0,
-  useDynamicIterationCount: false,
-  hashAlg: "xxhash64",
-  enableChunkSplitterV2: false,
-  maxChunksInEden: 10,
-  maxTotalLengthInEden: 1024,
-  maxAgeInEden: 10,
-  usePluginSyncV2: false,
-  handleFilenameCaseSensitive: false,
-  useSegmenter: false,
-  E2EEAlgorithm: E2EEAlgorithms.V2,
-  chunkSplitterVersion: ChunkAlgorithms.RabinKarp
-};
+const TweakCompatibilityRules = Object.freeze([
+  { key: "minimumChunkSize", templateValue: 20, reconstruction: "none" },
+  { key: "longLineThreshold", templateValue: 250, reconstruction: "none" },
+  { key: "encrypt", templateValue: false, reconstruction: "required" },
+  { key: "usePathObfuscation", templateValue: false, reconstruction: "required" },
+  { key: "enableCompression", templateValue: false, reconstruction: "none" },
+  { key: "useEden", templateValue: false, reconstruction: "none" },
+  { key: "customChunkSize", templateValue: 0, reconstruction: "recommended", compatibleLossyOrder: 1 },
+  { key: "useDynamicIterationCount", templateValue: false, reconstruction: "required" },
+  { key: "hashAlg", templateValue: "xxhash64", reconstruction: "recommended", compatibleLossyOrder: 0 },
+  { key: "enableChunkSplitterV2", templateValue: false, reconstruction: "none" },
+  { key: "maxChunksInEden", templateValue: 10, reconstruction: "none" },
+  { key: "maxTotalLengthInEden", templateValue: 1024, reconstruction: "none" },
+  { key: "maxAgeInEden", templateValue: 10, reconstruction: "none" },
+  {
+    key: "usePluginSyncV2",
+    templateValue: false,
+    reconstruction: "none",
+    knownDefault: false
+  },
+  {
+    key: "handleFilenameCaseSensitive",
+    templateValue: false,
+    reconstruction: "required",
+    knownDefault: false
+  },
+  { key: "useSegmenter", templateValue: false, reconstruction: "none" },
+  {
+    key: "E2EEAlgorithm",
+    templateValue: E2EEAlgorithms.V2,
+    reconstruction: "none",
+    knownDefault: DEFAULT_SETTINGS.E2EEAlgorithm
+  },
+  {
+    key: "chunkSplitterVersion",
+    templateValue: ChunkAlgorithms.RabinKarp,
+    reconstruction: "recommended",
+    knownDefault: DEFAULT_SETTINGS.chunkSplitterVersion,
+    compatibleLossyOrder: 2
+  }
+]);
+const TweakValuesShouldMatchedTemplate = Object.fromEntries(
+  TweakCompatibilityRules.map(({ key, templateValue }) => [key, templateValue])
+);
 const IncompatibleChanges = [
-  "encrypt",
-  "usePathObfuscation",
-  "useDynamicIterationCount",
-  "handleFilenameCaseSensitive"
+  ...TweakCompatibilityRules.filter(({ reconstruction }) => reconstruction === "required").map(({ key }) => key)
 ];
-const CompatibleButLossyChanges = ["hashAlg", "customChunkSize", "chunkSplitterVersion"];
-const IncompatibleChangesInSpecificPattern = [];
+const CompatibleButLossyChanges = TweakCompatibilityRules.filter(
+  (rule) => "compatibleLossyOrder" in rule
+).slice().sort((left, right) => left.compatibleLossyOrder - right.compatibleLossyOrder).map(({ key }) => key);
+const IncompatibleChangesInSpecificPattern = TweakCompatibilityRules.flatMap(
+  (rule) => (rule.specificPatterns ?? []).map((pattern) => ({
+    key: rule.key,
+    ...Object.prototype.hasOwnProperty.call(pattern, "from") ? { from: pattern.from } : {},
+    ...Object.prototype.hasOwnProperty.call(pattern, "to") ? { to: pattern.to } : {},
+    ...pattern.reconstruction === "recommended" ? { isRecommendation: true } : {}
+  }))
+);
 const TweakValuesRecommendedTemplate = {
   useIgnoreFiles: false,
   useCustomRequestHandler: false,
@@ -49,9 +79,11 @@ const TweakValuesRecommendedTemplate = {
   chunkSplitterVersion: ChunkAlgorithms.RabinKarp
 };
 const TweakValuesDefault = {
-  usePluginSyncV2: false,
-  E2EEAlgorithm: DEFAULT_SETTINGS.E2EEAlgorithm,
-  chunkSplitterVersion: DEFAULT_SETTINGS.chunkSplitterVersion,
+  ...Object.fromEntries(
+    TweakCompatibilityRules.filter((rule) => "knownDefault" in rule && rule.key !== "handleFilenameCaseSensitive").map(
+      ({ key, knownDefault }) => [key, knownDefault]
+    )
+  ),
   tweakModified: DEFAULT_SETTINGS.tweakModified
 };
 const TweakValuesTemplate = {
@@ -77,6 +109,7 @@ export {
   IncompatibleChangesInSpecificPattern,
   RemotePreferredTweakNotConfiguredReasons,
   RemotePreferredTweakStatuses,
+  TweakCompatibilityRules,
   TweakValuesDefault,
   TweakValuesRecommendedTemplate,
   TweakValuesShouldMatchedTemplate,

package/dist/common/settingConstants.d.ts

@@ -185,6 +185,8 @@ export declare const AllSettingDefault: {
     P2P_AutoAcceptingPeers: string;
     P2P_AutoDenyingPeers: string;
     P2P_IsHeadless?: boolean;
+    P2P_iceServers?: readonly RTCIceServer[];
+    P2P_iceServersExpiresAt?: number;
     P2P_Enabled: boolean;
     P2P_relays: string;
     P2P_roomID: string;
@@ -196,6 +198,9 @@ export declare const AllSettingDefault: {
     P2P_turnServers: string;
     P2P_turnUsername: string;
     P2P_turnCredential: string;
+    P2P_managedType?: string;
+    P2P_managedId?: string;
+    P2P_managedToken?: string;
     P2P_maxWirePayloadBytes?: number;
     P2P_connectionPath?: import("./types.js").P2PConnectionPath;
     P2P_useDiagRTC?: boolean;

package/dist/common/types.d.ts

@@ -9,7 +9,7 @@ import { AUTO_MERGED, CANCELLED, LEAVE_TO_SUBSEQUENT, MISSING_OR_ERROR, NOT_CONF
 import { IDPrefixes, LEAF_WAIT_ONLY_REMOTE, LEAF_WAIT_TIMEOUT, LEAF_WAIT_TIMEOUT_SEQUENTIAL_REPLICATOR, MAX_DOC_SIZE, MAX_DOC_SIZE_BIN, PREFIX_CHUNK, PREFIX_ENCRYPTED_CHUNK, PREFIX_OBFUSCATED, RECENT_MODIFIED_DOCS_QTY, REPLICATION_BUSY_TIMEOUT, SALT_OF_ID, SALT_OF_PASSPHRASE, SEED_MURMURHASH, VER } from "./models/shared.const.behabiour.js";
 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, P2PConnectionPaths, P2PMessageSizePresets, type P2PConnectionPath } from "./models/setting.const.js";
-import { hasValidP2PTurnServerUrl, isValidP2PTurnServerUrl, normaliseP2PConnectionPath, normaliseP2PMaxWirePayloadBytes, splitP2PTurnServerUrls } from "./models/setting.p2p.js";
+import { hasManagedP2PTurnConfiguration, hasP2PTurnConfiguration, hasValidP2PTurnServerUrl, omitP2PRuntimeSettings, isValidP2PTurnServerUrl, normaliseP2PConnectionPath, normaliseP2PMaxWirePayloadBytes, splitP2PTurnServerUrls } from "./models/setting.p2p.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, 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";
@@ -23,6 +23,8 @@ import { configurationNames, LEVEL_ADVANCED, LEVEL_POWER_USER, LEVEL_EDGE_CASE,
 import type { CustomRegExpSource, CustomRegExpSourceList, ParsedCustomRegExp, Prettify } from "./models/shared.type.util.js";
 import { ProtocolVersions, type ProtocolVersion, DOCID_SYNC_PARAMETERS, DOCID_JOURNAL_SYNC_PARAMETERS, type SyncParameters, DEFAULT_SYNC_PARAMETERS } from "./models/sync.definition.js";
 import { TweakValuesShouldMatchedTemplate, IncompatibleChanges, CompatibleButLossyChanges, IncompatibleChangesInSpecificPattern, TweakValuesRecommendedTemplate, TweakValuesDefault, TweakValuesTemplate, type TweakValues, DEVICE_ID_PREFERRED, RemotePreferredTweakStatuses, type RemotePreferredTweakStatus, RemotePreferredTweakNotConfiguredReasons, type RemotePreferredTweakNotConfiguredReason, type RemotePreferredTweakResult } from "./models/tweak.definition.js";
+import type { TweakAssessment, TweakAssessmentEntry, TweakAssessmentRelation, TweakAssessmentValue, TweakTransition, TweakTransitionReason } from "./models/tweak.compatibility.js";
+import type { TweakReconstruction } from "./models/tweak.definition.js";
 import type { diff_result_leaf, dmp_result, diff_result, DIFF_CHECK_RESULT_AUTO, diff_check_result } from "./models/diff.definition.js";
 import { PREFIXMD_LOGFILE, PREFIXMD_LOGFILE_UC, FlagFilesOriginal, FlagFilesHumanReadable, FLAGMD_REDFLAG, FLAGMD_REDFLAG2, FLAGMD_REDFLAG2_HR, FLAGMD_REDFLAG3, FLAGMD_REDFLAG3_HR } from "./models/redflag.const.js";
 import { DatabaseConnectingStatuses, type DatabaseConnectingStatus } from "./models/shared.definition.js";
@@ -37,7 +39,7 @@ export { SETTING_VERSION_INITIAL, SETTING_VERSION_SUPPORT_CASE_INSENSITIVE, CURR
 export type { BucketSyncSetting, LocalDBSettings };
 export { RemoteTypes, REMOTE_COUCHDB, REMOTE_MINIO, REMOTE_P2P, P2PConnectionPaths, P2PMessageSizePresets, type RemoteType, AutoAccepting, };
 export type { P2PConnectionInfo, P2PConnectionPath, P2PSyncSetting };
-export { hasValidP2PTurnServerUrl, isValidP2PTurnServerUrl, normaliseP2PConnectionPath, normaliseP2PMaxWirePayloadBytes, splitP2PTurnServerUrls, };
+export { hasManagedP2PTurnConfiguration, hasP2PTurnConfiguration, hasValidP2PTurnServerUrl, omitP2PRuntimeSettings, isValidP2PTurnServerUrl, normaliseP2PConnectionPath, normaliseP2PMaxWirePayloadBytes, splitP2PTurnServerUrls, };
 export { P2P_DEFAULT_SETTINGS };
 export type { RemoteTypeSettings };
 export { E2EEAlgorithmNames, E2EEAlgorithms, type E2EEAlgorithm };
@@ -69,6 +71,7 @@ export { confName };
 export { confDesc };
 export { TweakValuesTemplate };
 export type { TweakValues };
+export type { TweakAssessment, TweakAssessmentEntry, TweakAssessmentRelation, TweakAssessmentValue, TweakReconstruction, TweakTransition, TweakTransitionReason, };
 export { DEVICE_ID_PREFERRED };
 export { RemotePreferredTweakStatuses };
 export type { RemotePreferredTweakStatus };
@@ -113,4 +116,4 @@ export { DOCID_SYNC_PARAMETERS };
 export { DOCID_JOURNAL_SYNC_PARAMETERS };
 export type { SyncParameters };
 export { DEFAULT_SYNC_PARAMETERS };
-export { SETTING_KEY_P2P_DEVICE_NAME, configURIBase, configURIBaseQR, SuffixDatabaseName, ExtraSuffixIndexedDB };
+export { SETTING_KEY_P2P_DEVICE_NAME, configURIBase, configURIBaseQR, SuffixDatabaseName, ExtraSuffixIndexedDB, };

package/dist/common/types.js

@@ -64,7 +64,10 @@ import {
   P2PMessageSizePresets
 } from "./models/setting.const.js";
 import {
+  hasManagedP2PTurnConfiguration,
+  hasP2PTurnConfiguration,
   hasValidP2PTurnServerUrl,
+  omitP2PRuntimeSettings,
   isValidP2PTurnServerUrl,
   normaliseP2PConnectionPath,
   normaliseP2PMaxWirePayloadBytes,
@@ -236,11 +239,14 @@ export {
   configURIBaseQR,
   configurationNames,
   createNewVaultSettings,
+  hasManagedP2PTurnConfiguration,
+  hasP2PTurnConfiguration,
   hasValidP2PTurnServerUrl,
   isMetaEntry,
   isValidP2PTurnServerUrl,
   normaliseP2PConnectionPath,
   normaliseP2PMaxWirePayloadBytes,
+  omitP2PRuntimeSettings,
   prepareSettingsForLoad,
   splitP2PTurnServerUrls,
   statusDisplay

package/dist/common/utils.js

@@ -462,7 +462,10 @@ function pickP2PSyncSettings(setting) {
     P2P_turnUsername: setting.P2P_turnUsername,
     P2P_turnCredential: setting.P2P_turnCredential,
     P2P_maxWirePayloadBytes: normaliseP2PMaxWirePayloadBytes(setting.P2P_maxWirePayloadBytes),
-    P2P_connectionPath: normaliseP2PConnectionPath(setting.P2P_connectionPath)
+    P2P_connectionPath: normaliseP2PConnectionPath(setting.P2P_connectionPath),
+    P2P_managedType: setting.P2P_managedType,
+    P2P_managedId: setting.P2P_managedId,
+    P2P_managedToken: setting.P2P_managedToken
   };
 }
 function wrapByDefault(func, onError) {

package/dist/p2p/P2PService.d.ts

@@ -5,6 +5,7 @@ import { LiveSyncTrysteroReplicator, type LiveSyncTrysteroReplicatorEnv } from "
 import type { P2PReplicationResult } from "../replication/trystero/TrysteroReplicator.js";
 import type { AcceptanceDecision, RevokeAcceptanceDecision } from "../replication/trystero/TrysteroReplicatorP2PServer.js";
 import type { Advertisement } from "../replication/trystero/types.js";
+import { type PrepareP2PSettings } from "../replication/trystero/P2PRoomSessionOwner.js";
 import { type ReplicationOutcome } from "../replication/ReplicatorProvider.js";
 import type { P2PConnectionProbeAdmission } from "../replication/trystero/P2PConnectionProbeAdmission.js";
 export { ACTIVE_P2P_RELAY_BINDING_CONFLICT } from "../replication/trystero/P2PConnectionProbeAdmission.js";
@@ -114,10 +115,15 @@ export interface P2PServiceComposition {
     /** Create a non-owning adapter for the active Replicator selection. */
     createActiveReplicator(): ReplicatorInstance;
 }
+/** Optional host dependencies used by the private P2P service composition. */
+export interface P2PServiceOptions {
+    readonly prepareP2PSettings?: PrepareP2PSettings;
+}
+export type { PrepareP2PSettings };
 /**
  * Compose stable capability views over one private P2P service context.
  *
  * `P2PRoomSessionOwner` remains the resource owner. The returned composition
  * object is host wiring, not a capability façade for ordinary consumers.
  */
-export declare function createP2PService(env: LiveSyncTrysteroReplicatorEnv): P2PServiceComposition;
+export declare function createP2PService(env: LiveSyncTrysteroReplicatorEnv, options?: P2PServiceOptions): P2PServiceComposition;

package/dist/p2p/P2PService.js

@@ -2,7 +2,9 @@ import { getPeerConnectionStats } from "../rpc/transports/DiagRTCPeerConnections
 import {
   LiveSyncTrysteroReplicator
 } from "../replication/trystero/LiveSyncTrysteroReplicator.js";
-import { P2PRoomSessionOwner } from "../replication/trystero/P2PRoomSessionOwner.js";
+import {
+  P2PRoomSessionOwner
+} from "../replication/trystero/P2PRoomSessionOwner.js";
 import { compatGlobal } from "../common/coreEnvFunctions.js";
 import {
   REPLICATION_CANCELLED,
@@ -75,12 +77,16 @@ function closeForLifecycle(owner, state) {
   cancelDelayedAutomation(owner, state);
   return owner.close();
 }
-function reconcileAutoStart(context, settings) {
+async function reconcileAutoStart(context, settings) {
   if (!settings.P2P_Enabled || !settings.P2P_AutoStart) {
-    return context.roomSessionOwner.setPersistentDemand("automatic", false);
+    await context.roomSessionOwner.setPersistentDemand("automatic", false);
+    return;
+  }
+  if (context.state.explicitDisconnectVeto || context.state.lifecycleClosed) return;
+  try {
+    await context.roomSessionOwner.setPersistentDemand("automatic", true);
+  } catch {
   }
-  if (context.state.explicitDisconnectVeto || context.state.lifecycleClosed) return Promise.resolve();
-  return context.roomSessionOwner.setPersistentDemand("automatic", true);
 }
 function scheduleAutoStart(context, delayMs = 100) {
   clearDelayedAutoStart(context.state);
@@ -224,8 +230,8 @@ function createServiceLifecycle(context) {
     scheduleAutoStart: (delayMs) => scheduleAutoStart(context, delayMs)
   };
 }
-function createP2PService(env) {
-  const roomSessionOwner = new P2PRoomSessionOwner(env);
+function createP2PService(env, options = {}) {
+  const roomSessionOwner = new P2PRoomSessionOwner(env, void 0, options);
   const state = {
     explicitDisconnectVeto: false,
     lifecycleClosed: false,

package/dist/p2p/index.d.ts

@@ -1,4 +1,4 @@
-export type { P2PCandidateSummary, P2PChangeRelay, P2PConfigurationExchange, P2PDiagnostics, P2PPeerConnectionMetrics, P2PPeerAdmission, P2PPeerDirectory, P2PServiceViews, P2PTargetedTransfer, P2PTransportLifecycle, P2PConnectionProbeAdmission, P2PConnectionProbeAdmissionResult, P2PConnectionProbeSettings, } from "./P2PService.js";
+export type { P2PCandidateSummary, P2PChangeRelay, P2PConfigurationExchange, P2PDiagnostics, P2PPeerConnectionMetrics, P2PPeerAdmission, P2PPeerDirectory, P2PServiceViews, P2PTargetedTransfer, P2PTransportLifecycle, P2PConnectionProbeAdmission, P2PConnectionProbeAdmissionResult, P2PConnectionProbeSettings, P2PServiceOptions, PrepareP2PSettings, } from "./P2PService.js";
 export { ACTIVE_P2P_RELAY_BINDING_CONFLICT } from "./P2PService.js";
 export { useP2PReplicatorCommands } from "../replication/trystero/useP2PReplicatorCommands.js";
 export { useP2PReplicatorFeature } from "../replication/trystero/useP2PReplicatorFeature.js";
@@ -6,3 +6,5 @@ export type { OpenRebuildUIFactory, OpenReplicationUIFactory, } from "../replica
 export type { UseP2PReplicatorResult } from "../replication/trystero/UseP2PReplicatorResult.js";
 export type { P2PReplicationResult } from "../replication/trystero/TrysteroReplicator.js";
 export type { Advertisement } from "../replication/trystero/types.js";
+export { P2P_ICE_SERVER_EXPIRY_MARGIN_MS, P2P_SETTINGS_PREPARATION_TIMEOUT_MS, } from "../replication/trystero/P2PRoomSessionOwner.js";
+export type { P2PReplicatorFeatureOptions } from "../replication/trystero/useP2PReplicatorFeature.js";

package/dist/p2p/index.js

@@ -1,8 +1,14 @@
 import { ACTIVE_P2P_RELAY_BINDING_CONFLICT } from "./P2PService.js";
 import { useP2PReplicatorCommands } from "../replication/trystero/useP2PReplicatorCommands.js";
 import { useP2PReplicatorFeature } from "../replication/trystero/useP2PReplicatorFeature.js";
+import {
+  P2P_ICE_SERVER_EXPIRY_MARGIN_MS,
+  P2P_SETTINGS_PREPARATION_TIMEOUT_MS
+} from "../replication/trystero/P2PRoomSessionOwner.js";
 export {
   ACTIVE_P2P_RELAY_BINDING_CONFLICT,
+  P2P_ICE_SERVER_EXPIRY_MARGIN_MS,
+  P2P_SETTINGS_PREPARATION_TIMEOUT_MS,
   useP2PReplicatorCommands,
   useP2PReplicatorFeature
 };

package/dist/pouchdb/LiveSyncDBFunctions.d.ts

@@ -1,4 +1,4 @@
-import { type EntryDoc, type EntryMilestoneInfo, type RemoteDBSettings, type ChunkVersionRange, type TweakValues, type DeviceInfo } from "../common/types.js";
+import { type EntryDoc, type EntryMilestoneInfo, type RemoteDBSettings, type ChunkVersionRange, type TweakValues, type DeviceInfo, type TweakAssessment } from "../common/types.js";
 export type ENSURE_DB_RESULT = "OK" | "INCOMPATIBLE" | "LOCKED" | "NODE_LOCKED" | "NODE_CLEANED" | ["MISMATCHED", TweakValues];
 /**
  * Ensures that the remote database is compatible with the current device.
@@ -10,5 +10,5 @@ export type ENSURE_DB_RESULT = "OK" | "INCOMPATIBLE" | "LOCKED" | "NODE_LOCKED"
  * @param updateCallback - The callback function to update the remote milestone.
  * @returns A promise that resolves to the result of ensuring compatibility.
  */
-export declare function ensureRemoteIsCompatible(infoSrc: EntryMilestoneInfo | false, setting: RemoteDBSettings, deviceNodeID: string, currentVersionRange: ChunkVersionRange, nodeDeviceInfo: DeviceInfo, updateCallback: (info: EntryMilestoneInfo) => Promise<void>): Promise<ENSURE_DB_RESULT>;
-export declare function ensureDatabaseIsCompatible(db: PouchDB.Database<EntryDoc>, setting: RemoteDBSettings, deviceNodeID: string, currentVersionRange: ChunkVersionRange, nodeDeviceInfo: DeviceInfo): Promise<ENSURE_DB_RESULT>;
+export declare function ensureRemoteIsCompatible(infoSrc: EntryMilestoneInfo | false, setting: RemoteDBSettings, deviceNodeID: string, currentVersionRange: ChunkVersionRange, nodeDeviceInfo: DeviceInfo, updateCallback: (info: EntryMilestoneInfo) => Promise<void>, recordTweakAssessment?: (assessment: TweakAssessment) => void): Promise<ENSURE_DB_RESULT>;
+export declare function ensureDatabaseIsCompatible(db: PouchDB.Database<EntryDoc>, setting: RemoteDBSettings, deviceNodeID: string, currentVersionRange: ChunkVersionRange, nodeDeviceInfo: DeviceInfo, recordTweakAssessment?: (assessment: TweakAssessment) => void): Promise<ENSURE_DB_RESULT>;

package/dist/pouchdb/LiveSyncDBFunctions.js

@@ -1,12 +1,11 @@
 import {
   MILESTONE_DOCID as MILESTONE_DOC_ID,
-  TweakValuesShouldMatchedTemplate,
   TweakValuesTemplate,
-  DEVICE_ID_PREFERRED,
-  TweakValuesDefault
+  DEVICE_ID_PREFERRED
 } from "../common/types.js";
 import { extractObject, isObjectDifferent, resolveWithIgnoreKnownError } from "../common/utils.js";
-async function ensureRemoteIsCompatible(infoSrc, setting, deviceNodeID, currentVersionRange, nodeDeviceInfo, updateCallback) {
+import { assessTweakCompatibility } from "../common/models/tweak.compatibility.js";
+async function ensureRemoteIsCompatible(infoSrc, setting, deviceNodeID, currentVersionRange, nodeDeviceInfo, updateCallback, recordTweakAssessment) {
   const now = Date.now();
   const baseMilestone = {
     _id: MILESTONE_DOC_ID,
@@ -83,15 +82,9 @@ async function ensureRemoteIsCompatible(infoSrc, setting, deviceNodeID, currentV
   if (!setting.disableCheckingConfigMismatch) {
     const preferred_tweak = remoteMilestone.tweak_values?.[DEVICE_ID_PREFERRED] ?? currentTweakValues;
     const current_tweak = currentTweakValues;
-    const preferred_should_matched = extractObject(TweakValuesShouldMatchedTemplate, {
-      ...TweakValuesDefault,
-      ...preferred_tweak
-    });
-    const current_should_matched = extractObject(TweakValuesShouldMatchedTemplate, {
-      ...TweakValuesDefault,
-      ...current_tweak
-    });
-    if (isObjectDifferent(preferred_should_matched, current_should_matched, true)) {
+    const tweakAssessment = assessTweakCompatibility(current_tweak, preferred_tweak);
+    recordTweakAssessment?.(tweakAssessment);
+    if (tweakAssessment.alignment === "mismatched") {
       return ["MISMATCHED", preferred_tweak];
     }
   }
@@ -106,7 +99,7 @@ async function ensureRemoteIsCompatible(infoSrc, setting, deviceNodeID, currentV
   }
   return "OK";
 }
-async function ensureDatabaseIsCompatible(db, setting, deviceNodeID, currentVersionRange, nodeDeviceInfo) {
+async function ensureDatabaseIsCompatible(db, setting, deviceNodeID, currentVersionRange, nodeDeviceInfo, recordTweakAssessment) {
   const remoteMilestone = await resolveWithIgnoreKnownError(
     db.get(MILESTONE_DOC_ID),
     false
@@ -119,7 +112,8 @@ async function ensureDatabaseIsCompatible(db, setting, deviceNodeID, currentVers
     nodeDeviceInfo,
     async (info) => {
       await db.put(info);
-    }
+    },
+    recordTweakAssessment
   );
   return ret;
 }

package/dist/replication/CentralCompatibility.d.ts

@@ -1,4 +1,4 @@
-import type { TweakValues } from "../common/types.js";
+import type { TweakAssessment, TweakValues } from "../common/types.js";
 /** Stable machine states for one central-remote compatibility assessment. */
 export declare const CENTRAL_COMPATIBILITY_STATUSES: Readonly<{
     readonly NOT_ASSESSED: "not-assessed";
@@ -23,6 +23,7 @@ export interface CentralCompatibilityRejected {
     readonly status: typeof CENTRAL_COMPATIBILITY_STATUSES.REJECTED;
     readonly reason: CentralCompatibilityRejectionReason;
     readonly preferredTweakValue?: Readonly<TweakValues>;
+    readonly tweakAssessment?: TweakAssessment;
 }
 /** Immutable result produced by one provider-local compatibility assessment. */
 export type CentralCompatibilityDecision = typeof CENTRAL_COMPATIBILITY_NOT_ASSESSED | typeof CENTRAL_COMPATIBILITY_ACCEPTED | CentralCompatibilityRejected;
@@ -32,7 +33,8 @@ export type CentralCompatibilityDecisionRecorder = (decision: CentralCompatibili
 export interface CentralCompatibilityRecoveryHint {
     readonly reason: CentralCompatibilityRejectionReason;
     readonly preferredTweakValue?: Readonly<TweakValues>;
+    readonly tweakAssessment?: TweakAssessment;
 }
-export declare function centralCompatibilityRejected(reason: CentralCompatibilityRejectionReason, preferredTweakValue?: TweakValues): CentralCompatibilityRejected;
+export declare function centralCompatibilityRejected(reason: CentralCompatibilityRejectionReason, preferredTweakValue?: Readonly<TweakValues>, tweakAssessment?: TweakAssessment): CentralCompatibilityRejected;
 /** Project only a rejected decision into the generic replication failure path. */
 export declare function centralCompatibilityRecoveryHint(decision: CentralCompatibilityDecision): CentralCompatibilityRecoveryHint | undefined;

package/dist/replication/CentralCompatibility.js

@@ -15,18 +15,20 @@ const CENTRAL_COMPATIBILITY_NOT_ASSESSED = Object.freeze({
 const CENTRAL_COMPATIBILITY_ACCEPTED = Object.freeze({
   status: CENTRAL_COMPATIBILITY_STATUSES.ACCEPTED
 });
-function centralCompatibilityRejected(reason, preferredTweakValue) {
+function centralCompatibilityRejected(reason, preferredTweakValue, tweakAssessment) {
   return Object.freeze({
     status: CENTRAL_COMPATIBILITY_STATUSES.REJECTED,
     reason,
-    ...preferredTweakValue === void 0 ? {} : { preferredTweakValue: Object.freeze({ ...preferredTweakValue }) }
+    ...preferredTweakValue === void 0 ? {} : { preferredTweakValue: Object.freeze({ ...preferredTweakValue }) },
+    ...tweakAssessment === void 0 ? {} : { tweakAssessment }
   });
 }
 function centralCompatibilityRecoveryHint(decision) {
   if (decision.status !== CENTRAL_COMPATIBILITY_STATUSES.REJECTED) return void 0;
   return Object.freeze({
     reason: decision.reason,
-    ...decision.preferredTweakValue === void 0 ? {} : { preferredTweakValue: decision.preferredTweakValue }
+    ...decision.preferredTweakValue === void 0 ? {} : { preferredTweakValue: decision.preferredTweakValue },
+    ...decision.tweakAssessment === void 0 ? {} : { tweakAssessment: decision.tweakAssessment }
   });
 }
 export {

package/dist/replication/couchdb/LiveSyncReplicator.js

@@ -903,12 +903,16 @@ ${sendingDocs}/(${sentDocsCount} done)`,
           device_name: this.env.services.vault.getVaultName(),
           progress
         };
+        let tweakAssessment;
         const ensure = await ensureDatabaseIsCompatible(
           dbRet.db,
           setting,
           this.nodeid,
           currentVersionRange,
-          info
+          info,
+          (assessment) => {
+            tweakAssessment = assessment;
+          }
         );
         if (ensure == "INCOMPATIBLE") {
           recordCompatibilityDecision?.(
@@ -951,7 +955,11 @@ ${sendingDocs}/(${sentDocsCount} done)`,
         } else if (ensure == "OK") {
         } else if (ensure[0] == "MISMATCHED") {
           recordCompatibilityDecision?.(
-            centralCompatibilityRejected(CENTRAL_COMPATIBILITY_REJECTION_REASONS.TWEAK_MISMATCH, ensure[1])
+            centralCompatibilityRejected(
+              CENTRAL_COMPATIBILITY_REJECTION_REASONS.TWEAK_MISMATCH,
+              ensure[1],
+              tweakAssessment
+            )
           );
           Logger(this.translate("liveSyncReplicator.mismatchedTweakDetected"), LOG_LEVEL_NOTICE);
           this.tweakSettingsMismatched = true;

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

@@ -1,4 +1,4 @@
-import { type RemoteDBSettings, type ChunkVersionRange, type NodeData, type RemotePreferredTweakResult } from "../../common/types.js";
+import { type RemoteDBSettings, type ChunkVersionRange, type NodeData, type RemotePreferredTweakResult, type TweakAssessment } from "../../common/types.js";
 import { JournalSyncCore } from "./JournalSyncCore.js";
 import { LiveSyncAbstractReplicator, type RemoteDBStatus } from "../LiveSyncAbstractReplicator.js";
 import { type ENSURE_DB_RESULT } from "../../pouchdb/LiveSyncDBFunctions.js";
@@ -22,7 +22,7 @@ export declare class LiveSyncJournalReplicator extends LiveSyncAbstractReplicato
     private journalTransferStopGeneration;
     getReplicationPBKDF2Salt(setting: RemoteDBSettings, refresh?: boolean): Promise<Uint8Array<ArrayBuffer>>;
     setupJournalSyncClient(settings?: RemoteDBSettings): JournalSyncCore;
-    ensureBucketIsCompatible(deviceNodeID: string, currentVersionRange: ChunkVersionRange, setting?: RemoteDBSettings, client?: Pick<JournalSyncCore, "downloadJsonWithResult" | "getCheckpointInfo" | "uploadJson">): Promise<ENSURE_DB_RESULT>;
+    ensureBucketIsCompatible(deviceNodeID: string, currentVersionRange: ChunkVersionRange, setting?: RemoteDBSettings, client?: Pick<JournalSyncCore, "downloadJsonWithResult" | "getCheckpointInfo" | "uploadJson">, recordTweakAssessment?: (assessment: TweakAssessment) => void): Promise<ENSURE_DB_RESULT>;
     constructor(env: LiveSyncJournalReplicatorEnv);
     migrate(from: number, to: number): Promise<boolean>;
     /**

package/dist/replication/journal/LiveSyncJournalReplicator.js

@@ -69,7 +69,7 @@ class LiveSyncJournalReplicator extends LiveSyncAbstractReplicator {
     }
     return this._client;
   }
-  async ensureBucketIsCompatible(deviceNodeID, currentVersionRange2, setting = this.currentSettings, client = this.setupJournalSyncClient(setting)) {
+  async ensureBucketIsCompatible(deviceNodeID, currentVersionRange2, setting = this.currentSettings, client = this.setupJournalSyncClient(setting), recordTweakAssessment) {
     const milestoneResult = await client.downloadJsonWithResult(MILSTONE_DOCID);
     if (milestoneResult.status === JournalStorageReadStatuses.UNAVAILABLE) {
       throw milestoneResult.error;
@@ -93,7 +93,8 @@ class LiveSyncJournalReplicator extends LiveSyncAbstractReplicator {
         if (!await client.uploadJson(MILSTONE_DOCID, info)) {
           throw new Error("Could not upload remote milestone");
         }
-      }
+      },
+      recordTweakAssessment
     );
   }
   constructor(env) {
@@ -259,7 +260,16 @@ class LiveSyncJournalReplicator extends LiveSyncAbstractReplicator {
       this.remoteLockedAndDeviceNotAccepted = false;
       this.tweakSettingsMismatched = false;
       this.preferredTweakValue = void 0;
-      const ensure = await this.ensureBucketIsCompatible(this.nodeid, currentVersionRange, setting, client);
+      let tweakAssessment;
+      const ensure = await this.ensureBucketIsCompatible(
+        this.nodeid,
+        currentVersionRange,
+        setting,
+        client,
+        (assessment) => {
+          tweakAssessment = assessment;
+        }
+      );
       if (ensure == "INCOMPATIBLE") {
         recordCompatibilityDecision?.(
           centralCompatibilityRejected(CENTRAL_COMPATIBILITY_REJECTION_REASONS.INCOMPATIBLE_VERSION)
@@ -301,7 +311,11 @@ class LiveSyncJournalReplicator extends LiveSyncAbstractReplicator {
       } else if (ensure == "OK") {
       } else if (ensure[0] == "MISMATCHED") {
         recordCompatibilityDecision?.(
-          centralCompatibilityRejected(CENTRAL_COMPATIBILITY_REJECTION_REASONS.TWEAK_MISMATCH, ensure[1])
+          centralCompatibilityRejected(
+            CENTRAL_COMPATIBILITY_REJECTION_REASONS.TWEAK_MISMATCH,
+            ensure[1],
+            tweakAssessment
+          )
         );
         Logger(this.translate("liveSyncReplicator.mismatchedTweakDetected"), LOG_LEVEL_NOTICE);
         this.tweakSettingsMismatched = true;

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

@@ -1,8 +1,16 @@
+import { type P2PSyncSetting } from "../../common/types.js";
 import type { LiveSyncReplicatorEnv } from "../LiveSyncAbstractReplicator.js";
 import { P2PRoomSession } from "./P2PRoomSession.js";
 import type { ReplicatorHostEnv } from "./types.js";
 import { type P2PConnectionProbeAdmissionResult, type P2PConnectionProbeSettings } from "./P2PConnectionProbeAdmission.js";
 type P2PRoomSessionFactory = (env: ReplicatorHostEnv) => P2PRoomSession;
+/** Prepare connection-only P2P settings for one room generation. */
+export type PrepareP2PSettings = (settings: Readonly<P2PSyncSetting>, signal: AbortSignal) => Promise<P2PSyncSetting>;
+export interface P2PRoomSessionOwnerOptions {
+    readonly prepareP2PSettings?: PrepareP2PSettings;
+}
+export declare const P2P_SETTINGS_PREPARATION_TIMEOUT_MS = 30000;
+export declare const P2P_ICE_SERVER_EXPIRY_MARGIN_MS = 30000;
 /** Session operations shared by the stable service and its compatibility facade. */
 export interface P2PRoomSessionAccess {
     readonly currentSession: P2PRoomSession | undefined;
@@ -22,13 +30,16 @@ export type P2PPersistentRoomDemand = "explicit" | "automatic" | "rebuild-contin
 export declare class P2PRoomSessionOwner implements P2PRoomSessionAccess {
     private readonly env;
     private readonly createSession;
+    private readonly options;
     private current?;
     private lifecycleOperation;
     private readonly persistentDemands;
     private readonly finiteDemands;
     private readonly automationCoordinator;
     private activeBinding?;
-    constructor(env: LiveSyncReplicatorEnv, createSession?: P2PRoomSessionFactory);
+    private pendingPreparation?;
+    private runtimeGeneration;
+    constructor(env: LiveSyncReplicatorEnv, createSession?: P2PRoomSessionFactory, options?: P2PRoomSessionOwnerOptions);
     get currentSession(): P2PRoomSession | undefined;
     get isConnected(): boolean;
     cancelActiveTransfers(): void;
@@ -52,6 +63,16 @@ export declare class P2PRoomSessionOwner implements P2PRoomSessionAccess {
     private enqueueLifecycleOperation;
     private closeTransport;
     private bindingsMatch;
+    private connectionSettingsRemainUsable;
+    private fencePreparationForCurrentSettings;
+    private invalidatePreparation;
+    private prepareConnectionSettings;
+    private prepareWithDeadline;
+    private copyPreparedIceServers;
+    private hasUsableIceServer;
+    private hasUsableTurnServer;
+    private withRoomOpenDeadline;
+    private assertReconciliationCurrent;
     /** Capture immutable session inputs while keeping policy live. */
     private getEffectiveBinding;
     /** Apply policy which can change without retiring the room session. */