react-native-onyx 1.0.131 → 2.0.2

package/API.md

@@ -5,6 +5,15 @@
 ## Functions
 
 <dl>
+<dt><a href="#sendActionToDevTools">sendActionToDevTools(method, key, value, mergedValue)</a></dt>
+<dd><p>Sends an action to DevTools extension</p>
+</dd>
+<dt><a href="#maybeFlushBatchUpdates">maybeFlushBatchUpdates()</a> ⇒ <code>Promise</code></dt>
+<dd><p>We are batching together onyx updates. This helps with use cases where we schedule onyx updates after each other.
+This happens for example in the Onyx.update function, where we process API responses that might contain a lot of
+update operations. Instead of calling the subscribers for each update operation, we batch them together which will
+cause react to schedule the updates at once instead of after each other. This is mainly a performance optimization.</p>
+</dd>
 <dt><a href="#getSubsetOfData">getSubsetOfData(sourceData, selector, [withOnyxInstanceState])</a> ⇒ <code>Mixed</code></dt>
 <dd><p>Uses a selector function to return a simplified version of sourceData</p>
 </dd>
@@ -25,12 +34,6 @@ If the requested key is a collection, it will return an object with all the coll
 <dt><a href="#disconnect">disconnect(connectionID, [keyToRemoveFromEvictionBlocklist])</a></dt>
 <dd><p>Remove the listener for a react component</p>
 </dd>
-<dt><a href="#maybeFlushBatchUpdates">maybeFlushBatchUpdates()</a> ⇒ <code>Promise</code></dt>
-<dd><p>We are batching together onyx updates. This helps with use cases where we schedule onyx updates after each other.
-This happens for example in the Onyx.update function, where we process API responses that might contain a lot of
-update operations. Instead of calling the subscribers for each update operation, we batch them together which will
-cause react to schedule the updates at once instead of after each other. This is mainly a performance optimization.</p>
-</dd>
 <dt><a href="#scheduleSubscriberUpdate">scheduleSubscriberUpdate(key, value, [canUpdateSubscriber])</a> ⇒ <code>Promise</code></dt>
 <dd><p>Schedules an update that will be appended to the macro task queue (so it doesn&#39;t update the subscribers immediately).</p>
 </dd>
@@ -39,11 +42,15 @@ cause react to schedule the updates at once instead of after each other. This is
 so that keysChanged() is triggered for the collection and not keyChanged(). If this was not done, then the
 subscriber callbacks receive the data in a different format than they normally expect and it breaks code.</p>
 </dd>
-<dt><a href="#broadcastUpdate">broadcastUpdate(key, value, hasChanged, method)</a> ⇒ <code>Promise</code></dt>
+<dt><a href="#broadcastUpdate">broadcastUpdate(key, value, method, hasChanged, wasRemoved)</a> ⇒ <code>Promise</code></dt>
 <dd><p>Notifys subscribers and writes current value to cache</p>
 </dd>
 <dt><a href="#hasPendingMergeForKey">hasPendingMergeForKey(key)</a> ⇒ <code>Boolean</code></dt>
 <dd></dd>
+<dt><a href="#removeNullValues">removeNullValues(key, value)</a> ⇒ <code>Mixed</code></dt>
+<dd><p>Removes a key from storage if the value is null.
+Otherwise removes all nested null values in objects and returns the object</p>
+</dd>
 <dt><a href="#set">set(key, value)</a> ⇒ <code>Promise</code></dt>
 <dd><p>Write a value to our store with the given key</p>
 </dd>
@@ -83,11 +90,41 @@ value will be saved to storage after the default value.</p>
 <dt><a href="#setMemoryOnlyKeys">setMemoryOnlyKeys(keyList)</a></dt>
 <dd><p>When set these keys will not be persisted to storage</p>
 </dd>
+<dt><a href="#onClear">onClear(callback)</a></dt>
+<dd><p>Sets the callback to be called when the clear finishes executing.</p>
+</dd>
+<dt><a href="#subscribeToEvents">subscribeToEvents()</a></dt>
+<dd><p>Subscribes to the Broadcast channel and executes actions based on the
+types of events.</p>
+</dd>
 <dt><a href="#init">init([options])</a></dt>
 <dd><p>Initialize the store with actions and listening for storage events</p>
 </dd>
 </dl>
 
+<a name="sendActionToDevTools"></a>
+
+## sendActionToDevTools(method, key, value, mergedValue)
+Sends an action to DevTools extension
+
+**Kind**: global function  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| method | <code>string</code> | Onyx method from METHOD |
+| key | <code>string</code> | Onyx key that was changed |
+| value | <code>any</code> | contains the change that was made by the method |
+| mergedValue | <code>any</code> | (optional) value that was written in the storage after a merge method was executed. |
+
+<a name="maybeFlushBatchUpdates"></a>
+
+## maybeFlushBatchUpdates() ⇒ <code>Promise</code>
+We are batching together onyx updates. This helps with use cases where we schedule onyx updates after each other.
+This happens for example in the Onyx.update function, where we process API responses that might contain a lot of
+update operations. Instead of calling the subscribers for each update operation, we batch them together which will
+cause react to schedule the updates at once instead of after each other. This is mainly a performance optimization.
+
+**Kind**: global function  
 <a name="getSubsetOfData"></a>
 
 ## getSubsetOfData(sourceData, selector, [withOnyxInstanceState]) ⇒ <code>Mixed</code>
@@ -182,15 +219,6 @@ Remove the listener for a react component
 ```js
 Onyx.disconnect(connectionID);
 ```
-<a name="maybeFlushBatchUpdates"></a>
-
-## maybeFlushBatchUpdates() ⇒ <code>Promise</code>
-We are batching together onyx updates. This helps with use cases where we schedule onyx updates after each other.
-This happens for example in the Onyx.update function, where we process API responses that might contain a lot of
-update operations. Instead of calling the subscribers for each update operation, we batch them together which will
-cause react to schedule the updates at once instead of after each other. This is mainly a performance optimization.
-
-**Kind**: global function  
 <a name="scheduleSubscriberUpdate"></a>
 
 ## scheduleSubscriberUpdate(key, value, [canUpdateSubscriber]) ⇒ <code>Promise</code>
@@ -224,26 +252,41 @@ subscriber callbacks receive the data in a different format than they normally e
 
 <a name="broadcastUpdate"></a>
 
-## broadcastUpdate(key, value, hasChanged, method) ⇒ <code>Promise</code>
+## broadcastUpdate(key, value, method, hasChanged, wasRemoved) ⇒ <code>Promise</code>
 Notifys subscribers and writes current value to cache
 
 **Kind**: global function  
 
+| Param | Type | Default |
+| --- | --- | --- |
+| key | <code>String</code> |  | 
+| value | <code>\*</code> |  | 
+| method | <code>String</code> |  | 
+| hasChanged | <code>Boolean</code> |  | 
+| wasRemoved | <code>Boolean</code> | <code>false</code> | 
+
+<a name="hasPendingMergeForKey"></a>
+
+## hasPendingMergeForKey(key) ⇒ <code>Boolean</code>
+**Kind**: global function  
+
 | Param | Type |
 | --- | --- |
 | key | <code>String</code> | 
-| value | <code>\*</code> | 
-| hasChanged | <code>Boolean</code> | 
-| method | <code>String</code> | 
 
-<a name="hasPendingMergeForKey"></a>
+<a name="removeNullValues"></a>
+
+## removeNullValues(key, value) ⇒ <code>Mixed</code>
+Removes a key from storage if the value is null.
+Otherwise removes all nested null values in objects and returns the object
 
-## hasPendingMergeForKey(key) ⇒ <code>Boolean</code>
 **Kind**: global function  
+**Returns**: <code>Mixed</code> - The value without null values and a boolean "wasRemoved", which indicates if the key got removed completely  
 
 | Param | Type |
 | --- | --- |
 | key | <code>String</code> | 
+| value | <code>Mixed</code> | 
 
 <a name="set"></a>
 
@@ -367,6 +410,24 @@ When set these keys will not be persisted to storage
 | --- | --- |
 | keyList | <code>Array.&lt;string&gt;</code> | 
 
+<a name="onClear"></a>
+
+## onClear(callback)
+Sets the callback to be called when the clear finishes executing.
+
+**Kind**: global function  
+
+| Param | Type |
+| --- | --- |
+| callback | <code>function</code> | 
+
+<a name="subscribeToEvents"></a>
+
+## subscribeToEvents()
+Subscribes to the Broadcast channel and executes actions based on the
+types of events.
+
+**Kind**: global function  
 <a name="init"></a>
 
 ## init([options])

package/README.md

@@ -292,13 +292,13 @@ function signOut() {
 `Onyx.get`, `Onyx.set`, and the rest of the API accesses the underlying storage
 differently depending on the platform
 
-Under the hood storage access calls are delegated to a [`StorageProvider`](lib/storage/index.web.js)
+Under the hood storage access calls are delegated to a [`StorageProvider`](lib/storage/index.js)
 Some platforms (like web and desktop) might use the same storage provider
 
 If a platform needs to use a separate library (like using MMVK for react-native) it should be added in the following way:
 1. Create a `StorageProvider.js` at [lib/storage/providers](lib/storage/providers)
    Reference an existing [StorageProvider](lib/storage/providers/AsyncStorage.js) for the interface that has to be implemented
-2. Update the factory at [lib/storage/index.web.js](lib/storage/index.web.js) and [lib/storage/index.native.js](lib/storage/index.native.js) to return the newly created Provider for the desired Platform(s)
+2. Update the factory at [lib/storage/index.js](lib/storage/index.js) and [lib/storage/index.native.js](lib/storage/index.native.js) to return the newly created Provider for the desired Platform(s)
 
 # API Reference
 
@@ -433,9 +433,7 @@ The action logs use this naming convention:
 `react-native` bundles source using the `metro` bundler. `metro` does not follow symlinks, so we can't use `npm link` to
 link a local version of Onyx during development
 
-To quickly test small changes you can directly go to `node_modules/react-native-onyx` in the parent project and:
-- tweak original source if you're testing over a react-native project
-- tweak `dist/web.development.js` for non react-native-projects
+To quickly test small changes you can directly go to `node_modules/react-native-onyx` in the parent project and tweak original source code.
 
 To continuously work on Onyx we have to set up a task that copies content to parent project's `node_modules/react-native-onyx`:
 1. Work on Onyx feature or a fix

package/dist/DevTools.d.ts

@@ -0,0 +1,23 @@
+declare const _default: DevTools;
+export default _default;
+declare class DevTools {
+    remoteDev: any;
+    state: {};
+    defaultState: {};
+    connectViaExtension(options: any): any;
+    /**
+     * Registers an action that updated the current state of the storage
+     *
+     * @param {string} type - name of the action
+     * @param {any} payload - data written to the storage
+     * @param {object} stateChanges - partial state that got updated after the changes
+     */
+    registerAction(type: string, payload?: any, stateChanges?: object): void;
+    initState(initialState?: {}): void;
+    /**
+     * This clears the internal state of the DevTools, preserving the keys included in `keysToPreserve`
+     *
+     * @param {string[]} keysToPreserve
+     */
+    clearState(keysToPreserve?: string[]): void;
+}

package/{lib → dist}/DevTools.js

@@ -1,7 +1,10 @@
-import _ from 'underscore';
-
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const underscore_1 = __importDefault(require("underscore"));
 const ERROR_LABEL = 'Onyx DevTools - Error: ';
-
 /* eslint-disable no-underscore-dangle */
 class DevTools {
     constructor() {
@@ -9,18 +12,17 @@ class DevTools {
         this.state = {};
         this.defaultState = {};
     }
-
     connectViaExtension(options) {
         try {
             if ((options && options.remote) || typeof window === 'undefined' || !window.__REDUX_DEVTOOLS_EXTENSION__) {
                 return;
             }
             return window.__REDUX_DEVTOOLS_EXTENSION__.connect(options);
-        } catch (e) {
+        }
+        catch (e) {
             console.error(ERROR_LABEL, e);
         }
     }
-
     /**
      * Registers an action that updated the current state of the storage
      *
@@ -33,17 +35,14 @@ class DevTools {
             if (!this.remoteDev) {
                 return;
             }
-            const newState = {
-                ...this.state,
-                ...stateChanges,
-            };
-            this.remoteDev.send({type, payload}, newState);
+            const newState = Object.assign(Object.assign({}, this.state), stateChanges);
+            this.remoteDev.send({ type, payload }, newState);
             this.state = newState;
-        } catch (e) {
+        }
+        catch (e) {
             console.error(ERROR_LABEL, e);
         }
     }
-
     initState(initialState = {}) {
         try {
             if (!this.remoteDev) {
@@ -52,20 +51,19 @@ class DevTools {
             this.remoteDev.init(initialState);
             this.state = initialState;
             this.defaultState = initialState;
-        } catch (e) {
+        }
+        catch (e) {
             console.error(ERROR_LABEL, e);
         }
     }
-
     /**
      * This clears the internal state of the DevTools, preserving the keys included in `keysToPreserve`
      *
      * @param {string[]} keysToPreserve
      */
     clearState(keysToPreserve = []) {
-        const newState = _.mapObject(this.state, (value, key) => (keysToPreserve.includes(key) ? value : this.defaultState[key]));
+        const newState = underscore_1.default.mapObject(this.state, (value, key) => (keysToPreserve.includes(key) ? value : this.defaultState[key]));
         this.registerAction('CLEAR', undefined, newState);
     }
 }
-
-export default new DevTools();
+exports.default = new DevTools();

package/dist/Logger.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logAlert = exports.logInfo = exports.registerLogger = void 0;
+// Logging callback
+let logger = () => { };
+/**
+ * Register the logging callback
+ *
+ * @param {Function} callback
+ */
+function registerLogger(callback) {
+    logger = callback;
+}
+exports.registerLogger = registerLogger;
+/**
+ * Send an alert message to the logger
+ *
+ * @param {String} message
+ */
+function logAlert(message) {
+    logger({ message: `[Onyx] ${message}`, level: 'alert' });
+}
+exports.logAlert = logAlert;
+/**
+ * Send an info message to the logger
+ *
+ * @param {String} message
+ */
+function logInfo(message) {
+    logger({ message: `[Onyx] ${message}`, level: 'info' });
+}
+exports.logInfo = logInfo;

package/dist/MDTable.d.ts

@@ -0,0 +1,36 @@
+export default MDTable;
+declare class MDTable {
+    /**
+     * Create a CSV string from the table data
+     * @returns {string}
+     */
+    toCSV(): string;
+    /**
+     * Create a JSON string from the table data
+     * @returns {string}
+     */
+    toJSON(): string;
+    /**
+     * Create a MD string from the table data
+     * @returns {string}
+     */
+    toString(): string;
+}
+declare namespace MDTable {
+    /**
+     * Table Factory helper
+     * @param {Object} options
+     * @param {string} [options.title] - optional title center above the table
+     * @param {string[]} options.heading - table column names
+     * @param {number[]} [options.leftAlignedCols=[]] - indexes of columns that should be left aligned
+     * Pass the columns that are non numeric here - the rest will be aligned to the right
+     * @param {Array} [options.rows] The table can be initialized with row. Rows can also be added by `addRow`
+     * @returns {MDTable}
+     */
+    function factory({ title, heading, leftAlignedCols, rows }: {
+        title?: string | undefined;
+        heading: string[];
+        leftAlignedCols?: number[] | undefined;
+        rows?: any[] | undefined;
+    }): MDTable;
+}

package/{lib → dist}/MDTable.js

@@ -1,6 +1,10 @@
-import AsciTable from 'ascii-table';
-
-class MDTable extends AsciTable {
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const ascii_table_1 = __importDefault(require("ascii-table"));
+class MDTable extends ascii_table_1.default {
     /**
      * Create a CSV string from the table data
      * @returns {string}
@@ -8,7 +12,6 @@ class MDTable extends AsciTable {
     toCSV() {
         return [this.getTitle(), this.getHeading(), ...this.getRows()].join('\n');
     }
-
     /**
      * Create a JSON string from the table data
      * @returns {string}
@@ -16,7 +19,6 @@ class MDTable extends AsciTable {
     toJSON() {
         return JSON.stringify(super.toJSON());
     }
-
     /**
      * Create a MD string from the table data
      * @returns {string}
@@ -27,20 +29,16 @@ class MDTable extends AsciTable {
         const ascii = super.toString().replace(/-\|/g, () => {
             /* we replace "----|" with "---:|" to align the data to the right in MD */
             idx++;
-
             if (idx < 0 || this.leftAlignedCols.includes(idx)) {
                 return '-|';
             }
-
             return ':|';
         });
-
         // strip the top and the bottom row (----) to make an MD table
         const md = ascii.split('\n').slice(1, -1).join('\n');
         return md;
     }
 }
-
 /**
  * Table Factory helper
  * @param {Object} options
@@ -51,16 +49,13 @@ class MDTable extends AsciTable {
  * @param {Array} [options.rows] The table can be initialized with row. Rows can also be added by `addRow`
  * @returns {MDTable}
  */
-MDTable.factory = ({title, heading, leftAlignedCols = [], rows = []}) => {
-    const table = new MDTable({title, heading, rows});
+MDTable.factory = ({ title, heading, leftAlignedCols = [], rows = [] }) => {
+    const table = new MDTable({ title, heading, rows });
     table.leftAlignedCols = leftAlignedCols;
-
     /* By default we want everything aligned to the right as most values are numbers
      * we just override the columns that are not right aligned */
-    heading.forEach((name, idx) => table.setAlign(idx, AsciTable.RIGHT));
-    leftAlignedCols.forEach((idx) => table.setAlign(idx, AsciTable.LEFT));
-
+    heading.forEach((name, idx) => table.setAlign(idx, ascii_table_1.default.RIGHT));
+    leftAlignedCols.forEach((idx) => table.setAlign(idx, ascii_table_1.default.LEFT));
     return table;
 };
-
-export default MDTable;
+exports.default = MDTable;