zen-fs-config 0.5.45 → 0.5.46

package/dist/index.d.mts

@@ -345,8 +345,16 @@ interface AppDataBackendDescriptor {
 interface AppDataGroupDescriptor {
     id: string;
     groupType: 'data-sync';
+    /** User-editable display name. `id` is the stable identifier. */
+    name?: string;
     backends: AppDataBackendDescriptor[];
 }
+/** Descriptor for the config-sync group itself (display metadata only). */
+interface ConfigSyncGroupDescriptor {
+    groupType: 'config-sync';
+    /** User-editable display name. The group has no separate id. */
+    name?: string;
+}
 /** Per-backend sync state of a data group. */
 interface BackendSyncState {
     backendId: string;
@@ -555,6 +563,20 @@ interface IConfigRepo {
     getAppDataGroup(id: string): Promise<AppDataGroup>;
     /** List all data-sync group descriptors for this app. */
     listAppDataGroups(): Promise<AppDataGroupDescriptor[]>;
+    /**
+     * Update a data-sync group's display name (descriptor-only; id, backends,
+     * local and remote data are untouched). Empty/oversized names are rejected.
+     */
+    updateAppDataGroupName(id: string, name: string): Promise<void>;
+    /** Read the config-sync group's display descriptor (may be absent). */
+    getConfigSyncGroupDescriptor(): Promise<ConfigSyncGroupDescriptor | null>;
+    /**
+     * Update the config-sync group's display name (descriptor-only; backends,
+     * local store and remote data are untouched).
+     */
+    updateConfigSyncGroupDescriptor(patch: {
+        name: string;
+    }): Promise<ConfigSyncGroupDescriptor>;
     /** Remove a data-sync group (stops sync, removes descriptor). */
     removeAppDataGroup(id: string): Promise<void>;
     /**
@@ -1005,6 +1027,20 @@ declare class ConfigRepo implements IConfigRepo {
      * authoritative source of the data group's backend topology (FR2.3).
      */
     updateAppDataGroupDescriptor(id: string, backends: AppDataBackendDescriptor[]): Promise<void>;
+    /**
+     * Change a data-sync group's display name only. `id`, backends, local stores
+     * and remote data are untouched, so existing sync pairs keep working.
+     */
+    updateAppDataGroupName(id: string, name: string): Promise<void>;
+    getConfigSyncGroupDescriptor(): Promise<ConfigSyncGroupDescriptor | null>;
+    /**
+     * Change the config-sync group's display name only. Backends, the local
+     * store and remote data are untouched.
+     */
+    updateConfigSyncGroupDescriptor(patch: {
+        name: string;
+    }): Promise<ConfigSyncGroupDescriptor>;
+    private readAppDataGroupDescriptor;
     getAppDataGroup(id: string): Promise<AppDataGroup>;
     listAppDataGroups(): Promise<AppDataGroupDescriptor[]>;
     removeAppDataGroup(id: string): Promise<void>;
@@ -1160,4 +1196,4 @@ declare function incrementVersion(fs: SyncableFS, configFilePath: string, newCon
  */
 declare function verifyOrRepairVersion(fs: SyncableFS, configFilePath: string, author: string): Promise<VersionMeta | null>;
 
-export { type AppDataBackendDescriptor, type AppDataGroup, type AppDataGroupDescriptor, type BackendDescriptor, type BackendFactory, type BackendInstance, type BackendMetadata, type BackendParamDef, type BackendSyncState, type BackendsMeta, type CacheOptions, ConfigRepo, type ConfigRepoOptions, type ConfigSerializer, type ConflictArchive, type ConflictInfo, type ConnectOptions, type ConnectResult, FolderStore, type IConfigRepo, type KeepPurgeResult, LOCAL_IDB_BACKEND_ID, type MigrateLocalFS, type MigrateReplicaFS, type MtimePurgeResult, type PurgeKeepOptions, type PurgeMtimeOptions, type PurgeableFS$1 as PurgeableFS, type SyncGroupType, type TombstoneMeta, type VersionMeta, type VersionMigrationOptions, type VersionMigrationResult, configKeyToFilePath, connect, createBackend, createConfigRepo, createSerializerChain, getAccountFields, getBackendMetadata, getExtension, hasBackend, incrementVersion, isBrowserEnv, isKeepFile, isMtimeSidecar, legacyVersionPathFor, listBackendMetadata, listBackends, localPrimaryType, mergeAccountFields, migrateVersionSidecars, purgeKeepFiles, purgeMtimeSidecars, readVersion, registerBackend, registerFolderBackend, resolveLocalPrimary, sha256, unregisterBackend, verifyOrRepairVersion, versionPathFor, wrapZenFSFileSystem, writeVersion };
+export { type AppDataBackendDescriptor, type AppDataGroup, type AppDataGroupDescriptor, type BackendDescriptor, type BackendFactory, type BackendInstance, type BackendMetadata, type BackendParamDef, type BackendSyncState, type BackendsMeta, type CacheOptions, ConfigRepo, type ConfigRepoOptions, type ConfigSerializer, type ConfigSyncGroupDescriptor, type ConflictArchive, type ConflictInfo, type ConnectOptions, type ConnectResult, FolderStore, type IConfigRepo, type KeepPurgeResult, LOCAL_IDB_BACKEND_ID, type MigrateLocalFS, type MigrateReplicaFS, type MtimePurgeResult, type PurgeKeepOptions, type PurgeMtimeOptions, type PurgeableFS$1 as PurgeableFS, type SyncGroupType, type TombstoneMeta, type VersionMeta, type VersionMigrationOptions, type VersionMigrationResult, configKeyToFilePath, connect, createBackend, createConfigRepo, createSerializerChain, getAccountFields, getBackendMetadata, getExtension, hasBackend, incrementVersion, isBrowserEnv, isKeepFile, isMtimeSidecar, legacyVersionPathFor, listBackendMetadata, listBackends, localPrimaryType, mergeAccountFields, migrateVersionSidecars, purgeKeepFiles, purgeMtimeSidecars, readVersion, registerBackend, registerFolderBackend, resolveLocalPrimary, sha256, unregisterBackend, verifyOrRepairVersion, versionPathFor, wrapZenFSFileSystem, writeVersion };

package/dist/index.d.ts

@@ -345,8 +345,16 @@ interface AppDataBackendDescriptor {
 interface AppDataGroupDescriptor {
     id: string;
     groupType: 'data-sync';
+    /** User-editable display name. `id` is the stable identifier. */
+    name?: string;
     backends: AppDataBackendDescriptor[];
 }
+/** Descriptor for the config-sync group itself (display metadata only). */
+interface ConfigSyncGroupDescriptor {
+    groupType: 'config-sync';
+    /** User-editable display name. The group has no separate id. */
+    name?: string;
+}
 /** Per-backend sync state of a data group. */
 interface BackendSyncState {
     backendId: string;
@@ -555,6 +563,20 @@ interface IConfigRepo {
     getAppDataGroup(id: string): Promise<AppDataGroup>;
     /** List all data-sync group descriptors for this app. */
     listAppDataGroups(): Promise<AppDataGroupDescriptor[]>;
+    /**
+     * Update a data-sync group's display name (descriptor-only; id, backends,
+     * local and remote data are untouched). Empty/oversized names are rejected.
+     */
+    updateAppDataGroupName(id: string, name: string): Promise<void>;
+    /** Read the config-sync group's display descriptor (may be absent). */
+    getConfigSyncGroupDescriptor(): Promise<ConfigSyncGroupDescriptor | null>;
+    /**
+     * Update the config-sync group's display name (descriptor-only; backends,
+     * local store and remote data are untouched).
+     */
+    updateConfigSyncGroupDescriptor(patch: {
+        name: string;
+    }): Promise<ConfigSyncGroupDescriptor>;
     /** Remove a data-sync group (stops sync, removes descriptor). */
     removeAppDataGroup(id: string): Promise<void>;
     /**
@@ -1005,6 +1027,20 @@ declare class ConfigRepo implements IConfigRepo {
      * authoritative source of the data group's backend topology (FR2.3).
      */
     updateAppDataGroupDescriptor(id: string, backends: AppDataBackendDescriptor[]): Promise<void>;
+    /**
+     * Change a data-sync group's display name only. `id`, backends, local stores
+     * and remote data are untouched, so existing sync pairs keep working.
+     */
+    updateAppDataGroupName(id: string, name: string): Promise<void>;
+    getConfigSyncGroupDescriptor(): Promise<ConfigSyncGroupDescriptor | null>;
+    /**
+     * Change the config-sync group's display name only. Backends, the local
+     * store and remote data are untouched.
+     */
+    updateConfigSyncGroupDescriptor(patch: {
+        name: string;
+    }): Promise<ConfigSyncGroupDescriptor>;
+    private readAppDataGroupDescriptor;
     getAppDataGroup(id: string): Promise<AppDataGroup>;
     listAppDataGroups(): Promise<AppDataGroupDescriptor[]>;
     removeAppDataGroup(id: string): Promise<void>;
@@ -1160,4 +1196,4 @@ declare function incrementVersion(fs: SyncableFS, configFilePath: string, newCon
  */
 declare function verifyOrRepairVersion(fs: SyncableFS, configFilePath: string, author: string): Promise<VersionMeta | null>;
 
-export { type AppDataBackendDescriptor, type AppDataGroup, type AppDataGroupDescriptor, type BackendDescriptor, type BackendFactory, type BackendInstance, type BackendMetadata, type BackendParamDef, type BackendSyncState, type BackendsMeta, type CacheOptions, ConfigRepo, type ConfigRepoOptions, type ConfigSerializer, type ConflictArchive, type ConflictInfo, type ConnectOptions, type ConnectResult, FolderStore, type IConfigRepo, type KeepPurgeResult, LOCAL_IDB_BACKEND_ID, type MigrateLocalFS, type MigrateReplicaFS, type MtimePurgeResult, type PurgeKeepOptions, type PurgeMtimeOptions, type PurgeableFS$1 as PurgeableFS, type SyncGroupType, type TombstoneMeta, type VersionMeta, type VersionMigrationOptions, type VersionMigrationResult, configKeyToFilePath, connect, createBackend, createConfigRepo, createSerializerChain, getAccountFields, getBackendMetadata, getExtension, hasBackend, incrementVersion, isBrowserEnv, isKeepFile, isMtimeSidecar, legacyVersionPathFor, listBackendMetadata, listBackends, localPrimaryType, mergeAccountFields, migrateVersionSidecars, purgeKeepFiles, purgeMtimeSidecars, readVersion, registerBackend, registerFolderBackend, resolveLocalPrimary, sha256, unregisterBackend, verifyOrRepairVersion, versionPathFor, wrapZenFSFileSystem, writeVersion };
+export { type AppDataBackendDescriptor, type AppDataGroup, type AppDataGroupDescriptor, type BackendDescriptor, type BackendFactory, type BackendInstance, type BackendMetadata, type BackendParamDef, type BackendSyncState, type BackendsMeta, type CacheOptions, ConfigRepo, type ConfigRepoOptions, type ConfigSerializer, type ConfigSyncGroupDescriptor, type ConflictArchive, type ConflictInfo, type ConnectOptions, type ConnectResult, FolderStore, type IConfigRepo, type KeepPurgeResult, LOCAL_IDB_BACKEND_ID, type MigrateLocalFS, type MigrateReplicaFS, type MtimePurgeResult, type PurgeKeepOptions, type PurgeMtimeOptions, type PurgeableFS$1 as PurgeableFS, type SyncGroupType, type TombstoneMeta, type VersionMeta, type VersionMigrationOptions, type VersionMigrationResult, configKeyToFilePath, connect, createBackend, createConfigRepo, createSerializerChain, getAccountFields, getBackendMetadata, getExtension, hasBackend, incrementVersion, isBrowserEnv, isKeepFile, isMtimeSidecar, legacyVersionPathFor, listBackendMetadata, listBackends, localPrimaryType, mergeAccountFields, migrateVersionSidecars, purgeKeepFiles, purgeMtimeSidecars, readVersion, registerBackend, registerFolderBackend, resolveLocalPrimary, sha256, unregisterBackend, verifyOrRepairVersion, versionPathFor, wrapZenFSFileSystem, writeVersion };

package/dist/index.js

@@ -1424,10 +1424,25 @@ var GROUP_TYPE_FILE = `${META_DIR}/group-type`;
 var BACKENDS_FILE = `${META_DIR}/backends.json`;
 var BACKENDS_DIR = `${META_DIR}/backends`;
 var APP_DATA_GROUPS_DIR = `${META_DIR}/app-data-groups`;
+var CONFIG_SYNC_GROUP_FILE = `${META_DIR}/config-sync-group.json`;
+var GROUP_NAME_MAX_LENGTH = 40;
 var CONFLICTS_DIR = `${META_DIR}/.conflicts`;
 var DELETIONS_DIR = `${META_DIR}/.deleted`;
 var NODES_DIR = "/nodes";
 var SHARED_DIR = "/shared";
+function normalizeGroupName(value) {
+  if (typeof value !== "string") {
+    throw new Error("Group name must be a string");
+  }
+  const name = value.trim();
+  if (!name) {
+    throw new Error("Group name must not be empty");
+  }
+  if (name.length > GROUP_NAME_MAX_LENGTH) {
+    throw new Error(`Group name must be at most ${GROUP_NAME_MAX_LENGTH} characters`);
+  }
+  return name;
+}
 var CONFIG_ONLY_PREFIXES = [META_DIR, NODES_DIR, SHARED_DIR];
 var LOCAL_IDB_BACKEND_ID = "local-idb";
 function tombstoneFileName(filePath) {
@@ -2783,9 +2798,11 @@ var ConfigRepo = class {
    */
   async updateAppDataGroupDescriptor(id, backends) {
     this.assertNotDisposed();
+    const existing = await this.readAppDataGroupDescriptor(id);
     const descriptor = {
       id,
       groupType: "data-sync",
+      ...existing?.name ? { name: existing.name } : {},
       backends
     };
     const descPath = this.appDataGroupFilePath(id);
@@ -2796,6 +2813,73 @@ var ConfigRepo = class {
     const version = await incrementVersion(this.fullFS, descPath, bytes, author);
     await this.writeVersionSidecar(descPath, version);
   }
+  /**
+   * Change a data-sync group's display name only. `id`, backends, local stores
+   * and remote data are untouched, so existing sync pairs keep working.
+   */
+  async updateAppDataGroupName(id, name) {
+    this.assertNotDisposed();
+    const normalized = normalizeGroupName(name);
+    const existing = await this.readAppDataGroupDescriptor(id);
+    if (!existing) {
+      throw new Error(`App data group "${id}" not found`);
+    }
+    const descriptor = {
+      ...existing,
+      id,
+      groupType: "data-sync",
+      name: normalized
+    };
+    const descPath = this.appDataGroupFilePath(id);
+    await this.ensureDir(descPath);
+    const bytes = new TextEncoder().encode(JSON.stringify(descriptor, null, 2));
+    await this.cachedFS.writeFile(descPath, bytes);
+    const author = `${this.appId}/${this.nodeId}`;
+    const version = await incrementVersion(this.fullFS, descPath, bytes, author);
+    await this.writeVersionSidecar(descPath, version);
+  }
+  async getConfigSyncGroupDescriptor() {
+    this.assertNotDisposed();
+    try {
+      const raw = await this.cachedFS.readFile(CONFIG_SYNC_GROUP_FILE);
+      const parsed = JSON.parse(new TextDecoder().decode(toUint8Array2(raw)));
+      if (parsed && parsed.groupType === "config-sync") {
+        return parsed;
+      }
+    } catch {
+    }
+    return null;
+  }
+  /**
+   * Change the config-sync group's display name only. Backends, the local
+   * store and remote data are untouched.
+   */
+  async updateConfigSyncGroupDescriptor(patch) {
+    this.assertNotDisposed();
+    const normalized = normalizeGroupName(patch?.name);
+    const descriptor = {
+      groupType: "config-sync",
+      name: normalized
+    };
+    await this.ensureDir(CONFIG_SYNC_GROUP_FILE);
+    const bytes = new TextEncoder().encode(JSON.stringify(descriptor, null, 2));
+    await this.cachedFS.writeFile(CONFIG_SYNC_GROUP_FILE, bytes);
+    const author = `${this.appId}/${this.nodeId}`;
+    const version = await incrementVersion(this.fullFS, CONFIG_SYNC_GROUP_FILE, bytes, author);
+    await this.writeVersionSidecar(CONFIG_SYNC_GROUP_FILE, version);
+    return descriptor;
+  }
+  async readAppDataGroupDescriptor(id) {
+    try {
+      const raw = await this.cachedFS.readFile(this.appDataGroupFilePath(id));
+      const parsed = JSON.parse(new TextDecoder().decode(toUint8Array2(raw)));
+      if (parsed && parsed.id === id && parsed.groupType === "data-sync") {
+        return parsed;
+      }
+    } catch {
+    }
+    return null;
+  }
   async getAppDataGroup(id) {
     this.assertNotDisposed();
     const cached = this.appDataGroups.get(id);

package/dist/index.mjs

@@ -884,10 +884,25 @@ var GROUP_TYPE_FILE = `${META_DIR}/group-type`;
 var BACKENDS_FILE = `${META_DIR}/backends.json`;
 var BACKENDS_DIR = `${META_DIR}/backends`;
 var APP_DATA_GROUPS_DIR = `${META_DIR}/app-data-groups`;
+var CONFIG_SYNC_GROUP_FILE = `${META_DIR}/config-sync-group.json`;
+var GROUP_NAME_MAX_LENGTH = 40;
 var CONFLICTS_DIR = `${META_DIR}/.conflicts`;
 var DELETIONS_DIR = `${META_DIR}/.deleted`;
 var NODES_DIR = "/nodes";
 var SHARED_DIR = "/shared";
+function normalizeGroupName(value) {
+  if (typeof value !== "string") {
+    throw new Error("Group name must be a string");
+  }
+  const name = value.trim();
+  if (!name) {
+    throw new Error("Group name must not be empty");
+  }
+  if (name.length > GROUP_NAME_MAX_LENGTH) {
+    throw new Error(`Group name must be at most ${GROUP_NAME_MAX_LENGTH} characters`);
+  }
+  return name;
+}
 var CONFIG_ONLY_PREFIXES = [META_DIR, NODES_DIR, SHARED_DIR];
 var LOCAL_IDB_BACKEND_ID = "local-idb";
 function tombstoneFileName(filePath) {
@@ -2243,9 +2258,11 @@ var ConfigRepo = class {
    */
   async updateAppDataGroupDescriptor(id, backends) {
     this.assertNotDisposed();
+    const existing = await this.readAppDataGroupDescriptor(id);
     const descriptor = {
       id,
       groupType: "data-sync",
+      ...existing?.name ? { name: existing.name } : {},
       backends
     };
     const descPath = this.appDataGroupFilePath(id);
@@ -2256,6 +2273,73 @@ var ConfigRepo = class {
     const version = await incrementVersion(this.fullFS, descPath, bytes, author);
     await this.writeVersionSidecar(descPath, version);
   }
+  /**
+   * Change a data-sync group's display name only. `id`, backends, local stores
+   * and remote data are untouched, so existing sync pairs keep working.
+   */
+  async updateAppDataGroupName(id, name) {
+    this.assertNotDisposed();
+    const normalized = normalizeGroupName(name);
+    const existing = await this.readAppDataGroupDescriptor(id);
+    if (!existing) {
+      throw new Error(`App data group "${id}" not found`);
+    }
+    const descriptor = {
+      ...existing,
+      id,
+      groupType: "data-sync",
+      name: normalized
+    };
+    const descPath = this.appDataGroupFilePath(id);
+    await this.ensureDir(descPath);
+    const bytes = new TextEncoder().encode(JSON.stringify(descriptor, null, 2));
+    await this.cachedFS.writeFile(descPath, bytes);
+    const author = `${this.appId}/${this.nodeId}`;
+    const version = await incrementVersion(this.fullFS, descPath, bytes, author);
+    await this.writeVersionSidecar(descPath, version);
+  }
+  async getConfigSyncGroupDescriptor() {
+    this.assertNotDisposed();
+    try {
+      const raw = await this.cachedFS.readFile(CONFIG_SYNC_GROUP_FILE);
+      const parsed = JSON.parse(new TextDecoder().decode(toUint8Array2(raw)));
+      if (parsed && parsed.groupType === "config-sync") {
+        return parsed;
+      }
+    } catch {
+    }
+    return null;
+  }
+  /**
+   * Change the config-sync group's display name only. Backends, the local
+   * store and remote data are untouched.
+   */
+  async updateConfigSyncGroupDescriptor(patch) {
+    this.assertNotDisposed();
+    const normalized = normalizeGroupName(patch?.name);
+    const descriptor = {
+      groupType: "config-sync",
+      name: normalized
+    };
+    await this.ensureDir(CONFIG_SYNC_GROUP_FILE);
+    const bytes = new TextEncoder().encode(JSON.stringify(descriptor, null, 2));
+    await this.cachedFS.writeFile(CONFIG_SYNC_GROUP_FILE, bytes);
+    const author = `${this.appId}/${this.nodeId}`;
+    const version = await incrementVersion(this.fullFS, CONFIG_SYNC_GROUP_FILE, bytes, author);
+    await this.writeVersionSidecar(CONFIG_SYNC_GROUP_FILE, version);
+    return descriptor;
+  }
+  async readAppDataGroupDescriptor(id) {
+    try {
+      const raw = await this.cachedFS.readFile(this.appDataGroupFilePath(id));
+      const parsed = JSON.parse(new TextDecoder().decode(toUint8Array2(raw)));
+      if (parsed && parsed.id === id && parsed.groupType === "data-sync") {
+        return parsed;
+      }
+    } catch {
+    }
+    return null;
+  }
   async getAppDataGroup(id) {
     this.assertNotDisposed();
     const cached = this.appDataGroups.get(id);

package/dist/zen-fs-config.js

@@ -27449,10 +27449,25 @@ var ZenFSConfig = (() => {
   var BACKENDS_FILE = `${META_DIR}/backends.json`;
   var BACKENDS_DIR = `${META_DIR}/backends`;
   var APP_DATA_GROUPS_DIR = `${META_DIR}/app-data-groups`;
+  var CONFIG_SYNC_GROUP_FILE = `${META_DIR}/config-sync-group.json`;
+  var GROUP_NAME_MAX_LENGTH = 40;
   var CONFLICTS_DIR = `${META_DIR}/.conflicts`;
   var DELETIONS_DIR = `${META_DIR}/.deleted`;
   var NODES_DIR = "/nodes";
   var SHARED_DIR = "/shared";
+  function normalizeGroupName(value) {
+    if (typeof value !== "string") {
+      throw new Error("Group name must be a string");
+    }
+    const name = value.trim();
+    if (!name) {
+      throw new Error("Group name must not be empty");
+    }
+    if (name.length > GROUP_NAME_MAX_LENGTH) {
+      throw new Error(`Group name must be at most ${GROUP_NAME_MAX_LENGTH} characters`);
+    }
+    return name;
+  }
   var CONFIG_ONLY_PREFIXES = [META_DIR, NODES_DIR, SHARED_DIR];
   var LOCAL_IDB_BACKEND_ID = "local-idb";
   function tombstoneFileName(filePath) {
@@ -28808,9 +28823,11 @@ var ZenFSConfig = (() => {
      */
     async updateAppDataGroupDescriptor(id, backends) {
       this.assertNotDisposed();
+      const existing = await this.readAppDataGroupDescriptor(id);
       const descriptor = {
         id,
         groupType: "data-sync",
+        ...existing?.name ? { name: existing.name } : {},
         backends
       };
       const descPath = this.appDataGroupFilePath(id);
@@ -28821,6 +28838,73 @@ var ZenFSConfig = (() => {
       const version2 = await incrementVersion(this.fullFS, descPath, bytes, author);
       await this.writeVersionSidecar(descPath, version2);
     }
+    /**
+     * Change a data-sync group's display name only. `id`, backends, local stores
+     * and remote data are untouched, so existing sync pairs keep working.
+     */
+    async updateAppDataGroupName(id, name) {
+      this.assertNotDisposed();
+      const normalized = normalizeGroupName(name);
+      const existing = await this.readAppDataGroupDescriptor(id);
+      if (!existing) {
+        throw new Error(`App data group "${id}" not found`);
+      }
+      const descriptor = {
+        ...existing,
+        id,
+        groupType: "data-sync",
+        name: normalized
+      };
+      const descPath = this.appDataGroupFilePath(id);
+      await this.ensureDir(descPath);
+      const bytes = new TextEncoder().encode(JSON.stringify(descriptor, null, 2));
+      await this.cachedFS.writeFile(descPath, bytes);
+      const author = `${this.appId}/${this.nodeId}`;
+      const version2 = await incrementVersion(this.fullFS, descPath, bytes, author);
+      await this.writeVersionSidecar(descPath, version2);
+    }
+    async getConfigSyncGroupDescriptor() {
+      this.assertNotDisposed();
+      try {
+        const raw = await this.cachedFS.readFile(CONFIG_SYNC_GROUP_FILE);
+        const parsed = JSON.parse(new TextDecoder().decode(toUint8Array2(raw)));
+        if (parsed && parsed.groupType === "config-sync") {
+          return parsed;
+        }
+      } catch {
+      }
+      return null;
+    }
+    /**
+     * Change the config-sync group's display name only. Backends, the local
+     * store and remote data are untouched.
+     */
+    async updateConfigSyncGroupDescriptor(patch) {
+      this.assertNotDisposed();
+      const normalized = normalizeGroupName(patch?.name);
+      const descriptor = {
+        groupType: "config-sync",
+        name: normalized
+      };
+      await this.ensureDir(CONFIG_SYNC_GROUP_FILE);
+      const bytes = new TextEncoder().encode(JSON.stringify(descriptor, null, 2));
+      await this.cachedFS.writeFile(CONFIG_SYNC_GROUP_FILE, bytes);
+      const author = `${this.appId}/${this.nodeId}`;
+      const version2 = await incrementVersion(this.fullFS, CONFIG_SYNC_GROUP_FILE, bytes, author);
+      await this.writeVersionSidecar(CONFIG_SYNC_GROUP_FILE, version2);
+      return descriptor;
+    }
+    async readAppDataGroupDescriptor(id) {
+      try {
+        const raw = await this.cachedFS.readFile(this.appDataGroupFilePath(id));
+        const parsed = JSON.parse(new TextDecoder().decode(toUint8Array2(raw)));
+        if (parsed && parsed.id === id && parsed.groupType === "data-sync") {
+          return parsed;
+        }
+      } catch {
+      }
+      return null;
+    }
     async getAppDataGroup(id) {
       this.assertNotDisposed();
       const cached = this.appDataGroups.get(id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zen-fs-config",
-  "version": "0.5.45",
+  "version": "0.5.46",
   "description": "Distributed config management library built on ZenFS, zen-fs-cache, and zen-fs-sync",
   "main": "dist/index.js",
   "module": "dist/index.mjs",