@salesforce/core 5.3.8 → 6.0.1-crdt.0

package/lib/config/config.d.ts

@@ -1,7 +1,7 @@
-import { JsonPrimitive, Nullable } from '@salesforce/ts-types';
+import { JsonCollection, JsonPrimitive, Nullable } from '@salesforce/ts-types';
 import { OrgConfigProperties } from '../org/orgConfigProperties';
 import { ConfigFile } from './configFile';
-import { ConfigContents, ConfigValue } from './configStore';
+import { ConfigContents, ConfigValue } from './configStackTypes';
 /**
  * Interface for meta information about config properties
  */
@@ -241,7 +241,7 @@ export declare class Config extends ConfigFile<ConfigFile.Options, ConfigPropert
      *
      * @param newContents The new Config value to persist.
      */
-    write(newContents?: ConfigProperties): Promise<ConfigProperties>;
+    write(): Promise<ConfigProperties>;
     /**
      * DO NOT CALL - The config file needs to encrypt values which can only be done asynchronously.
      * Call {@link SfdxConfig.write} instead.
@@ -260,7 +260,7 @@ export declare class Config extends ConfigFile<ConfigFile.Options, ConfigPropert
      * @param key The property to set.
      * @param value The value of the property.
      */
-    set(key: string, value: JsonPrimitive): ConfigProperties;
+    set(key: string, value: JsonPrimitive | JsonCollection): ConfigProperties;
     /**
      * Unsets a value for a property.
      *

package/lib/config/config.js

@@ -281,14 +281,14 @@ class Config extends configFile_1.ConfigFile {
      */
     static async update(isGlobal, propertyName, value) {
         const config = await Config.create({ isGlobal });
-        const content = await config.read();
-        if (value == null) {
-            delete content[propertyName];
+        await config.read();
+        if (value == null || value === undefined) {
+            config.unset(propertyName);
         }
         else {
-            (0, kit_1.set)(content, propertyName, value);
+            config.set(propertyName, value);
         }
-        return config.write(content);
+        return config.write();
     }
     /**
      * Clear all the configured properties both local and global.
@@ -339,10 +339,7 @@ class Config extends configFile_1.ConfigFile {
      *
      * @param newContents The new Config value to persist.
      */
-    async write(newContents) {
-        if (newContents != null) {
-            this.setContents(newContents);
-        }
+    async write() {
         await this.cryptProperties(true);
         await super.write();
         if (global_1.Global.SFDX_INTEROPERABILITY)

package/lib/config/configFile.d.ts

@@ -1,7 +1,8 @@
 /// <reference types="node" />
 import { Stats as fsStats } from 'fs';
 import { Logger } from '../logger/logger';
-import { BaseConfigStore, ConfigContents } from './configStore';
+import { BaseConfigStore } from './configStore';
+import { ConfigContents } from './configStackTypes';
 /**
  * Represents a json config file used to manage settings and state. Global config
  * files are stored in the home directory hidden state folder (.sfdx) and local config
@@ -100,14 +101,14 @@ export declare class ConfigFile<T extends ConfigFile.Options = ConfigFile.Option
      *
      * @param newContents The new contents of the file.
      */
-    write(newContents?: P): Promise<P>;
+    write(): Promise<P>;
     /**
      * Write the config file with new contents. If no new contents are provided it will write the existing config
      * contents that were set from {@link ConfigFile.read}, or an empty file if {@link ConfigFile.read} was not called.
      *
      * @param newContents The new contents of the file.
      */
-    writeSync(newContents?: P): P;
+    writeSync(): P;
     /**
      * Check to see if the config file exists. Returns `true` if the config file exists and has access, false otherwise.
      */

package/lib/config/configFile.js

@@ -11,13 +11,15 @@ const fs = require("fs");
 const fs_1 = require("fs");
 const os_1 = require("os");
 const path_1 = require("path");
-const ts_types_1 = require("@salesforce/ts-types");
+const proper_lockfile_1 = require("proper-lockfile");
 const kit_1 = require("@salesforce/kit");
 const global_1 = require("../global");
 const logger_1 = require("../logger/logger");
 const sfError_1 = require("../sfError");
 const internal_1 = require("../util/internal");
+const lockRetryOptions_1 = require("../util/lockRetryOptions");
 const configStore_1 = require("./configStore");
+const lwwMap_1 = require("./lwwMap");
 /**
  * Represents a json config file used to manage settings and state. Global config
  * files are stored in the home directory hidden state folder (.sfdx) and local config
@@ -146,9 +148,9 @@ class ConfigFile extends configStore_1.BaseConfigStore {
             // Only need to read config files once.  They are kept up to date
             // internally and updated persistently via write().
             if (!this.hasRead || force) {
-                this.logger.info(`Reading config file: ${this.getPath()}`);
+                this.logger.info(`Reading config file: ${this.getPath()} because ${!this.hasRead ? 'hasRead is false' : 'force parameter is true'}`);
                 const obj = (0, kit_1.parseJsonMap)(await fs.promises.readFile(this.getPath(), 'utf8'), this.getPath());
-                this.setContentsFromObject(obj);
+                this.setContentsFromFileContents(obj, (await fs.promises.stat(this.getPath(), { bigint: true })).mtimeNs);
             }
             // Necessarily set this even when an error happens to avoid infinite re-reading.
             // To attempt another read, pass `force=true`.
@@ -159,7 +161,7 @@ class ConfigFile extends configStore_1.BaseConfigStore {
             this.hasRead = true;
             if (err.code === 'ENOENT') {
                 if (!throwOnNotFound) {
-                    this.setContents();
+                    this.setContentsFromFileContents({}, process.hrtime.bigint());
                     return this.getContents();
                 }
             }
@@ -184,14 +186,18 @@ class ConfigFile extends configStore_1.BaseConfigStore {
             if (!this.hasRead || force) {
                 this.logger.info(`Reading config file: ${this.getPath()}`);
                 const obj = (0, kit_1.parseJsonMap)(fs.readFileSync(this.getPath(), 'utf8'));
-                this.setContentsFromObject(obj);
+                this.setContentsFromFileContents(obj, fs.statSync(this.getPath(), { bigint: true }).mtimeNs);
             }
+            // Necessarily set this even when an error happens to avoid infinite re-reading.
+            // To attempt another read, pass `force=true`.
+            this.hasRead = true;
             return this.getContents();
         }
         catch (err) {
+            this.hasRead = true;
             if (err.code === 'ENOENT') {
                 if (!throwOnNotFound) {
-                    this.setContents();
+                    this.setContentsFromFileContents({}, process.hrtime.bigint());
                     return this.getContents();
                 }
             }
@@ -209,18 +215,40 @@ class ConfigFile extends configStore_1.BaseConfigStore {
      *
      * @param newContents The new contents of the file.
      */
-    async write(newContents) {
-        if (newContents) {
-            this.setContents(newContents);
-        }
+    async write() {
+        // make sure we can write to the directory
         try {
             await fs.promises.mkdir((0, path_1.dirname)(this.getPath()), { recursive: true });
         }
         catch (err) {
             throw sfError_1.SfError.wrap(err);
         }
+        let unlockFn;
+        // lock the file.  Returns an unlock function to call when done.
+        try {
+            unlockFn = await (0, proper_lockfile_1.lock)(this.getPath(), lockRetryOptions_1.lockRetryOptions);
+            // get the file modstamp.  Do this after the lock acquisition in case the file is being written to.
+            const fileTimestamp = (await fs.promises.stat(this.getPath(), { bigint: true })).mtimeNs;
+            // read the file contents into a LWWMap using the modstamp
+            const stateFromFile = (0, lwwMap_1.stateFromContents)((0, kit_1.parseJsonMap)(await fs.promises.readFile(this.getPath(), 'utf8'), this.getPath()), fileTimestamp, this.getPath());
+            // merge the new contents into the in-memory LWWMap
+            this.contents.merge(stateFromFile);
+        }
+        catch (err) {
+            if (err instanceof Error && err.message.includes('ENOENT')) {
+                this.logger.debug(`No file found at ${this.getPath()}.  Write will create it.`);
+            }
+            else {
+                throw err;
+            }
+        }
+        // write the merged LWWMap to file
         this.logger.info(`Writing to config file: ${this.getPath()}`);
         await fs.promises.writeFile(this.getPath(), JSON.stringify(this.toObject(), null, 2));
+        // unlock the file
+        if (typeof unlockFn !== 'undefined') {
+            await unlockFn();
+        }
         return this.getContents();
     }
     /**
@@ -229,18 +257,39 @@ class ConfigFile extends configStore_1.BaseConfigStore {
      *
      * @param newContents The new contents of the file.
      */
-    writeSync(newContents) {
-        if ((0, ts_types_1.isPlainObject)(newContents)) {
-            this.setContents(newContents);
-        }
+    writeSync() {
         try {
             fs.mkdirSync((0, path_1.dirname)(this.getPath()), { recursive: true });
         }
         catch (err) {
             throw sfError_1.SfError.wrap(err);
         }
+        let unlockFn;
+        try {
+            // lock the file.  Returns an unlock function to call when done.
+            unlockFn = (0, proper_lockfile_1.lockSync)(this.getPath(), lockRetryOptions_1.lockOptions);
+            // get the file modstamp.  Do this after the lock acquisition in case the file is being written to.
+            const fileTimestamp = fs.statSync(this.getPath(), { bigint: true }).mtimeNs;
+            // read the file contents into a LWWMap using the modstamp
+            const stateFromFile = (0, lwwMap_1.stateFromContents)((0, kit_1.parseJsonMap)(fs.readFileSync(this.getPath(), 'utf8'), this.getPath()), fileTimestamp, this.getPath());
+            // merge the new contents into the in-memory LWWMap
+            this.contents.merge(stateFromFile);
+        }
+        catch (err) {
+            if (err instanceof Error && err.message.includes('ENOENT')) {
+                this.logger.debug(`No file found at ${this.getPath()}.  Write will create it.`);
+            }
+            else {
+                throw err;
+            }
+        }
+        // write the merged LWWMap to file
         this.logger.info(`Writing to config file: ${this.getPath()}`);
         fs.writeFileSync(this.getPath(), JSON.stringify(this.toObject(), null, 2));
+        if (typeof unlockFn !== 'undefined') {
+            // unlock the file
+            unlockFn();
+        }
         return this.getContents();
     }
     /**

package/lib/config/configStackTypes.d.ts

@@ -0,0 +1,14 @@
+import { Dictionary, AnyJson } from '@salesforce/ts-types';
+export type Key<P extends ConfigContents> = Extract<keyof P, string>;
+/**
+ * The allowed types stored in a config store.
+ */
+export type ConfigValue = AnyJson;
+/**
+ * The type of entries in a config store defined by the key and value type of {@link ConfigContents}.
+ */
+export type ConfigEntry = [string, ConfigValue];
+/**
+ * The type of content a config stores.
+ */
+export type ConfigContents<T = ConfigValue> = Dictionary<T>;

package/lib/config/configStackTypes.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=configStackTypes.js.map

package/lib/config/configStore.d.ts

@@ -1,19 +1,8 @@
 import { AsyncOptionalCreatable } from '@salesforce/kit';
-import { AnyJson, Dictionary, JsonMap, Optional } from '@salesforce/ts-types';
+import { JsonMap, Optional } from '@salesforce/ts-types';
 import { Crypto } from '../crypto/crypto';
-/**
- * The allowed types stored in a config store.
- */
-export type ConfigValue = AnyJson;
-/**
- * The type of entries in a config store defined by the key and value type of {@link ConfigContents}.
- */
-export type ConfigEntry = [string, ConfigValue];
-/**
- * The type of content a config stores.
- */
-export type ConfigContents<T = ConfigValue> = Dictionary<T>;
-export type Key<P extends ConfigContents> = Extract<keyof P, string>;
+import { LWWMap } from './lwwMap';
+import { ConfigContents, ConfigEntry, ConfigValue, Key } from './configStackTypes';
 /**
  * An interface for a config object with a persistent store.
  */
@@ -47,7 +36,7 @@ export declare abstract class BaseConfigStore<T extends BaseConfigStore.Options
     protected static encryptedKeys: Array<string | RegExp>;
     protected options: T;
     protected crypto?: Crypto;
-    private contents;
+    protected contents: LWWMap<P>;
     private statics;
     /**
      * Constructor.
@@ -78,7 +67,6 @@ export declare abstract class BaseConfigStore<T extends BaseConfigStore.Options
     /**
      * Returns a boolean asserting whether a value has been associated to the key in the config object or not.
      *
-     * @param key The key. Supports query key like `a.b[0]`.
      */
     has(key: string): boolean;
     /**
@@ -89,7 +77,7 @@ export declare abstract class BaseConfigStore<T extends BaseConfigStore.Options
      * Sets the value for the key in the config object. This will override the existing value.
      * To do a partial update, use {@link BaseConfigStore.update}.
      *
-     * @param key The key. Supports query key like `a.b[0]`.
+     * @param key The key.
      * @param value The value.
      */
     set<K extends Key<P>>(key: K, value: P[K]): void;
@@ -107,7 +95,7 @@ export declare abstract class BaseConfigStore<T extends BaseConfigStore.Options
      * Returns `true` if an element in the config object existed and has been removed, or `false` if the element does not
      * exist. {@link BaseConfigStore.has} will return false afterwards.
      *
-     * @param key The key. Supports query key like `a.b[0]`.
+     * @param key The key
      */
     unset(key: string): boolean;
     /**
@@ -166,7 +154,8 @@ export declare abstract class BaseConfigStore<T extends BaseConfigStore.Options
      *
      * @param obj The object.
      */
-    setContentsFromObject<U extends JsonMap>(obj: U): void;
+    setContentsFromObject<U extends P>(obj: U): void;
+    protected setContentsFromFileContents(contents: P, timestamp: bigint): void;
     protected getEncryptedKeys(): Array<string | RegExp>;
     /**
      * This config file has encrypted keys and it should attempt to encrypt them.

package/lib/config/configStore.js

@@ -12,6 +12,7 @@ const ts_types_1 = require("@salesforce/ts-types");
 const ts_types_2 = require("@salesforce/ts-types");
 const crypto_1 = require("../crypto/crypto");
 const sfError_1 = require("../sfError");
+const lwwMap_1 = require("./lwwMap");
 /**
  * An abstract class that implements all the config management functions but
  * none of the storage functions.
@@ -27,6 +28,8 @@ class BaseConfigStore extends kit_1.AsyncOptionalCreatable {
      */
     constructor(options) {
         super(options);
+        // Initialized in setContents
+        this.contents = new lwwMap_1.LWWMap();
         this.statics = this.constructor;
         this.options = options ?? {};
         this.setContents(this.initialContents());
@@ -35,11 +38,11 @@ class BaseConfigStore extends kit_1.AsyncOptionalCreatable {
      * Returns an array of {@link ConfigEntry} for each element in the config.
      */
     entries() {
-        return (0, ts_types_2.definiteEntriesOf)(this.contents);
+        return (0, ts_types_2.definiteEntriesOf)(this.contents.value ?? {});
     }
     get(key, decrypt = false) {
         const k = key;
-        let value = this.getMethod(this.contents, k);
+        let value = this.getMethod(this.contents.value ?? {}, k);
         if (this.hasEncryption() && decrypt) {
             if ((0, ts_types_2.isJsonMap)(value)) {
                 value = this.recursiveDecrypt((0, kit_1.cloneJson)(value), k);
@@ -63,16 +66,15 @@ class BaseConfigStore extends kit_1.AsyncOptionalCreatable {
     /**
      * Returns a boolean asserting whether a value has been associated to the key in the config object or not.
      *
-     * @param key The key. Supports query key like `a.b[0]`.
      */
     has(key) {
-        return !!this.getMethod(this.contents, key);
+        return this.contents.has(key) ?? false;
     }
     /**
      * Returns an array that contains the keys for each element in the config object.
      */
     keys() {
-        return Object.keys(this.contents);
+        return Object.keys(this.contents.value ?? {});
     }
     set(key, value) {
         if (this.hasEncryption()) {
@@ -83,7 +85,14 @@ class BaseConfigStore extends kit_1.AsyncOptionalCreatable {
                 value = this.encrypt(value);
             }
         }
-        this.setMethod(this.contents, key, value);
+        // undefined value means unset
+        if (value === undefined) {
+            this.unset(key);
+        }
+        else {
+            // @ts-expect-error TODO: why isn't key guaranteed to be a string
+            this.contents.set(key, value);
+        }
     }
     update(key, value) {
         const existingValue = this.get(key, true);
@@ -96,17 +105,11 @@ class BaseConfigStore extends kit_1.AsyncOptionalCreatable {
      * Returns `true` if an element in the config object existed and has been removed, or `false` if the element does not
      * exist. {@link BaseConfigStore.has} will return false afterwards.
      *
-     * @param key The key. Supports query key like `a.b[0]`.
+     * @param key The key
      */
     unset(key) {
         if (this.has(key)) {
-            if (this.contents[key]) {
-                delete this.contents[key];
-            }
-            else {
-                // It is a query key, so just set it to undefined
-                this.setMethod(this.contents, key, undefined);
-            }
+            this.contents.delete(key);
             return true;
         }
         return false;
@@ -118,19 +121,19 @@ class BaseConfigStore extends kit_1.AsyncOptionalCreatable {
      * @param keys The keys. Supports query keys like `a.b[0]`.
      */
     unsetAll(keys) {
-        return keys.reduce((val, key) => val && this.unset(key), true);
+        return keys.map((key) => this.unset(key)).every(Boolean);
     }
     /**
      * Removes all key/value pairs from the config object.
      */
     clear() {
-        this.contents = {};
+        this.keys().map((key) => this.unset(key));
     }
     /**
      * Returns an array that contains the values for each element in the config object.
      */
     values() {
-        return (0, ts_types_2.definiteValuesOf)(this.contents);
+        return (0, ts_types_2.definiteValuesOf)(this.contents.value ?? {});
     }
     /**
      * Returns the entire config contents.
@@ -143,13 +146,10 @@ class BaseConfigStore extends kit_1.AsyncOptionalCreatable {
      *
      */
     getContents(decrypt = false) {
-        if (!this.contents) {
-            this.setContents();
-        }
         if (this.hasEncryption() && decrypt) {
-            return this.recursiveDecrypt((0, kit_1.cloneJson)(this.contents));
+            return this.recursiveDecrypt((0, kit_1.cloneJson)(this.contents?.value ?? {}));
         }
-        return this.contents;
+        return this.contents?.value ?? {};
     }
     /**
      * Sets the entire config contents.
@@ -160,7 +160,9 @@ class BaseConfigStore extends kit_1.AsyncOptionalCreatable {
         if (this.hasEncryption()) {
             contents = this.recursiveEncrypt(contents);
         }
-        this.contents = contents;
+        (0, ts_types_1.entriesOf)(contents).map(([key, value]) => {
+            this.contents.set(key, value);
+        });
     }
     /**
      * Invokes `actionFn` once for each key-value pair present in the config object.
@@ -168,10 +170,7 @@ class BaseConfigStore extends kit_1.AsyncOptionalCreatable {
      * @param {function} actionFn The function `(key: string, value: ConfigValue) => void` to be called for each element.
      */
     forEach(actionFn) {
-        const entries = this.entries();
-        for (const entry of entries) {
-            actionFn(entry[0], entry[1]);
-        }
+        this.entries().map((entry) => actionFn(entry[0], entry[1]));
     }
     /**
      * Asynchronously invokes `actionFn` once for each key-value pair present in the config object.
@@ -182,18 +181,14 @@ class BaseConfigStore extends kit_1.AsyncOptionalCreatable {
      */
     async awaitEach(actionFn) {
         const entries = this.entries();
-        for (const entry of entries) {
-            // prevent ConfigFile collision bug
-            // eslint-disable-next-line no-await-in-loop
-            await actionFn(entry[0], entry[1]);
-        }
+        await Promise.all(entries.map((entry) => actionFn(entry[0], entry[1])));
     }
     /**
      * Convert the config object to a JSON object. Returns the config contents.
      * Same as calling {@link ConfigStore.getContents}
      */
     toObject() {
-        return this.contents;
+        return this.contents.value ?? {};
     }
     /**
      * Convert an object to a {@link ConfigContents} and set it as the config contents.
@@ -201,13 +196,17 @@ class BaseConfigStore extends kit_1.AsyncOptionalCreatable {
      * @param obj The object.
      */
     setContentsFromObject(obj) {
-        this.contents = (this.hasEncryption() ? this.recursiveEncrypt(obj) : {});
-        Object.entries(obj).forEach(([key, value]) => {
-            this.setMethod(this.contents, key, value);
+        const objForWrite = this.hasEncryption() ? this.recursiveEncrypt(obj) : obj;
+        (0, ts_types_1.entriesOf)(objForWrite).map(([key, value]) => {
+            this.set(key, value);
         });
     }
+    setContentsFromFileContents(contents, timestamp) {
+        const state = (0, lwwMap_1.stateFromContents)(contents, timestamp, this.contents.id);
+        this.contents = new lwwMap_1.LWWMap(this.contents.id, state);
+    }
     getEncryptedKeys() {
-        return [...(this.options?.encryptedKeys ?? []), ...(this.statics?.encryptedKeys || [])];
+        return [...(this.options?.encryptedKeys ?? []), ...(this.statics?.encryptedKeys ?? [])];
     }
     /**
      * This config file has encrypted keys and it should attempt to encrypt them.

package/lib/config/lwwMap.d.ts

@@ -0,0 +1,25 @@
+import { LWWRegister } from './lwwRegister';
+import { ConfigContents, Key } from './configStackTypes';
+export declare const SYMBOL_FOR_DELETED: "UNIQUE_IDENTIFIER_FOR_DELETED";
+export type LWWState<P> = {
+    [Property in keyof P]: LWWRegister<P[Property] | typeof SYMBOL_FOR_DELETED>['state'];
+};
+/**
+ * @param contents object aligning with ConfigContents
+ * @param timestamp a bigInt that sets the timestamp.  Defaults to the current time
+ * construct a LWWState from an object
+ *
+ * */
+export declare const stateFromContents: <P extends ConfigContents<import("@salesforce/ts-types").AnyJson>>(contents: P, timestamp?: bigint, id?: string) => LWWState<P>;
+export declare class LWWMap<P extends ConfigContents> {
+    #private;
+    readonly id: string;
+    constructor(id?: string, state?: LWWState<P>);
+    get value(): P;
+    get state(): LWWState<P>;
+    merge(state: LWWState<P>): LWWState<P>;
+    set<K extends Key<P>>(key: K, value: P[K]): void;
+    get<K extends Key<P>>(key: K): P[K] | undefined;
+    delete(key: string): void;
+    has(key: string): boolean;
+}

package/lib/config/lwwMap.js

@@ -0,0 +1,93 @@
+"use strict";
+/*
+ * Copyright (c) 2023, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _LWWMap_data;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LWWMap = exports.stateFromContents = exports.SYMBOL_FOR_DELETED = void 0;
+const ts_types_1 = require("@salesforce/ts-types");
+const uniqid_1 = require("../util/uniqid");
+const lwwRegister_1 = require("./lwwRegister");
+exports.SYMBOL_FOR_DELETED = 'UNIQUE_IDENTIFIER_FOR_DELETED';
+/**
+ * @param contents object aligning with ConfigContents
+ * @param timestamp a bigInt that sets the timestamp.  Defaults to the current time
+ * construct a LWWState from an object
+ *
+ * */
+const stateFromContents = (contents, timestamp = process.hrtime.bigint(), id) => Object.fromEntries((0, ts_types_1.entriesOf)(contents).map(([key, value]) => [
+    key,
+    new lwwRegister_1.LWWRegister(id ?? (0, uniqid_1.uniqid)(), { peer: 'file', timestamp, value }),
+]));
+exports.stateFromContents = stateFromContents;
+class LWWMap {
+    constructor(id, state) {
+        /** map of key to LWWRegister.  Used for managing conflicts */
+        _LWWMap_data.set(this, new Map());
+        this.id = id ?? (0, uniqid_1.uniqid)();
+        // create a new register for each key in the initial state
+        for (const [key, register] of (0, ts_types_1.entriesOf)(state ?? {})) {
+            __classPrivateFieldGet(this, _LWWMap_data, "f").set(key, new lwwRegister_1.LWWRegister(this.id, register));
+        }
+    }
+    get value() {
+        return Object.fromEntries(Array.from(__classPrivateFieldGet(this, _LWWMap_data, "f").entries())
+            .filter(([, register]) => register.value !== exports.SYMBOL_FOR_DELETED)
+            .map(([key, register]) => [key, register.value]));
+    }
+    get state() {
+        return Object.fromEntries(Array.from(__classPrivateFieldGet(this, _LWWMap_data, "f").entries())
+            // .filter(([, register]) => Boolean(register))
+            .map(([key, register]) => [key, register.state]));
+    }
+    merge(state) {
+        // recursively merge each key's register with the incoming state for that key
+        for (const [key, remote] of (0, ts_types_1.entriesOf)(state)) {
+            const local = __classPrivateFieldGet(this, _LWWMap_data, "f").get(key);
+            // if the register already exists, merge it with the incoming state
+            if (local)
+                local.merge(remote);
+            // otherwise, instantiate a new `LWWRegister` with the incoming state
+            else
+                __classPrivateFieldGet(this, _LWWMap_data, "f").set(key, new lwwRegister_1.LWWRegister(this.id, remote));
+        }
+        return this.state;
+    }
+    set(key, value) {
+        // get the register at the given key
+        const register = __classPrivateFieldGet(this, _LWWMap_data, "f").get(key);
+        // if the register already exists, set the value
+        if (register)
+            register.set(value);
+        // otherwise, instantiate a new `LWWRegister` with the value
+        else
+            __classPrivateFieldGet(this, _LWWMap_data, "f").set(key, new lwwRegister_1.LWWRegister(this.id, { peer: this.id, timestamp: process.hrtime.bigint(), value }));
+    }
+    // TODO: how to handle the deep `get` that is currently allowed ex: get('foo.bar.baz')
+    get(key) {
+        // map loses the typing
+        const value = __classPrivateFieldGet(this, _LWWMap_data, "f").get(key)?.value;
+        if (value === exports.SYMBOL_FOR_DELETED)
+            return undefined;
+        return value;
+    }
+    delete(key) {
+        // set the register to null, if it exists
+        __classPrivateFieldGet(this, _LWWMap_data, "f").get(key)?.set(exports.SYMBOL_FOR_DELETED);
+    }
+    has(key) {
+        // if a register doesn't exist or its value is null, the map doesn't contain the key
+        return __classPrivateFieldGet(this, _LWWMap_data, "f").has(key) && __classPrivateFieldGet(this, _LWWMap_data, "f").get(key)?.value !== exports.SYMBOL_FOR_DELETED;
+    }
+}
+exports.LWWMap = LWWMap;
+_LWWMap_data = new WeakMap();
+//# sourceMappingURL=lwwMap.js.map

package/lib/config/lwwRegister.d.ts

@@ -0,0 +1,19 @@
+type LWWRegisterState<T> = {
+    peer: string;
+    timestamp: bigint;
+    value: T;
+};
+/** a CRDT implementation.  Uses timestamps to resolve conflicts when updating the value (last write wins)
+ * mostly based on https://jakelazaroff.com/words/an-interactive-intro-to-crdts/
+ *
+ * @param T the type of the value stored in the register
+ */
+export declare class LWWRegister<T> {
+    readonly id: string;
+    state: LWWRegisterState<T>;
+    constructor(id: string, state: LWWRegisterState<T>);
+    get value(): T;
+    set(value: T): void;
+    merge(incoming: LWWRegisterState<T>): LWWRegisterState<T>;
+}
+export {};