normal-store 1.0.0

package/LICENSE.md

@@ -0,0 +1,7 @@
+ISC License
+
+Copyright 2021 Voiceflow Inc.
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,59 @@
+Normal Store
+=========================
+
+[![npm version](https://img.shields.io/npm/v/normal-store.svg?style=flat-square)](https://www.npmjs.com/package/normal-store)
+[![npm downloads](https://img.shields.io/npm/dm/normal-store.svg?style=flat-square)](https://www.npmjs.com/package/normal-store)
+
+Utilities to transform data with unique identifiers to and from a normalized data store.
+All data is treated as immutable, new data structures are returned when updating.
+
+## Why?
+
+Often when dealing with data in a single-page-application (SPA) it is useful to represent collections of resources in a way that is both easy to query and to update.
+
+With `normal-store` you can convert the resources served by your backend into a format similar to an indexed database.
+
+```ts
+const resources = [{ id: 'a' }, { id: 'b' }];
+
+const normalized = normalize(resources); // { allKeys: ['a', 'b'], byKey: { a: { id: 'a' }, b: { id: 'b' } }}
+
+const denormalized = denormalize(normalized); // [{ id: 'a' }, { id: 'b' }]
+```
+
+## Example
+
+```ts
+import axios from 'axios';
+import { normalize, getOne, patchOne, removeOne } from 'normal-store';
+
+const products = await axios.get('/products').then(res => res.data);
+
+let productStore = normalize(products);
+
+const decrementStock = (productID) => {
+  productStore = patchOne(productStore, productID, ({ stock }) => ({ stock: stock - 1 }));
+};
+
+const removeProduct = (productID) => {
+  productStore = removeOne(productStore, productID);
+};
+```
+
+## Installation
+
+To use `normal-store`, install it as a dependency:
+
+```bash
+# If you use npm:
+npm install normal-store
+
+# Or if you use Yarn:
+yarn add normal-store
+```
+
+This assumes that you’re using a package manager such as [npm](http://npmjs.com/).
+
+## License
+
+[ISC](LICENSE.md)

package/build/index.d.ts

@@ -0,0 +1,2 @@
+export * from './store';
+export * from './types';

package/build/index.js

@@ -0,0 +1,15 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./store"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,0CAAwB;AACxB,0CAAwB"}

package/build/store/add.d.ts

@@ -0,0 +1,7 @@
+import { Normalized, NormalizedValue } from "../types";
+export interface AddOne {
+    <T>(store: Normalized<T>, key: string, value: T): T | null;
+    <T extends Normalized<any>>(store: T, key: string, value: NormalizedValue<T>): T;
+}
+export declare const prependOne: AddOne;
+export declare const appendOne: AddOne;

package/build/store/add.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appendOne = exports.prependOne = void 0;
+const utils_1 = require("../utils");
+const update_1 = require("./update");
+const prependOne = (normalized, key, value) => (Object.assign(Object.assign({}, (0, update_1.updateOne)(normalized, key, value)), { allKeys: (0, utils_1.prependUnique)(normalized.allKeys, key) }));
+exports.prependOne = prependOne;
+const appendOne = (normalized, key, value) => (Object.assign(Object.assign({}, (0, update_1.updateOne)(normalized, key, value)), { allKeys: (0, utils_1.appendUnique)(normalized.allKeys, key) }));
+exports.appendOne = appendOne;
+//# sourceMappingURL=add.js.map

package/build/store/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../src/store/add.ts"],"names":[],"mappings":";;;AACA,oCAAsD;AAEtD,qCAAqC;AAO9B,MAAM,UAAU,GAAW,CAA0B,UAAa,EAAE,GAAW,EAAE,KAAyB,EAAK,EAAE,CAAC,iCACpH,IAAA,kBAAS,EAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,KACpC,OAAO,EAAE,IAAA,qBAAa,EAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,IAC/C,CAAC;AAHU,QAAA,UAAU,cAGpB;AAEI,MAAM,SAAS,GAAW,CAA0B,UAAa,EAAE,GAAW,EAAE,KAAyB,EAAK,EAAE,CAAC,iCACnH,IAAA,kBAAS,EAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,KACpC,OAAO,EAAE,IAAA,oBAAY,EAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,IAC9C,CAAC;AAHU,QAAA,SAAS,aAGnB"}

package/build/store/addMany.d.ts

@@ -0,0 +1,9 @@
+import { GetKey, Identifiable, Normalized } from "../types";
+export interface AddMany {
+    <T extends Identifiable>(store: Normalized<T>, values: T[]): T[];
+    <T>(store: Normalized<T>, values: T[], getKey: GetKey<T>): T[];
+    <T extends Normalized<Identifiable>>(store: T, values: T[]): T;
+    <T extends Normalized<any>>(store: T, values: T[], getKey: GetKey<T>): T;
+}
+export declare const prependMany: AddMany;
+export declare const appendMany: AddMany;

package/build/store/addMany.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appendMany = exports.prependMany = void 0;
+const utils_1 = require("../utils");
+const addMany = (store, values, mergeKeys, getKey) => {
+    const keyGetter = getKey !== null && getKey !== void 0 ? getKey : utils_1.defaultGetKey;
+    const newKeys = (0, utils_1.withoutValues)(values.map(keyGetter), store.allKeys);
+    return Object.assign(Object.assign({}, store), { byKey: Object.assign(Object.assign({}, store.byKey), Object.fromEntries(values.map((value, index, allValues) => [keyGetter(value, index, allValues), value]))), allKeys: mergeKeys(store.allKeys, newKeys) });
+};
+const prependMany = (store, values, getKey) => addMany(store, values, (allKeys, newKeys) => [...newKeys, ...allKeys], getKey);
+exports.prependMany = prependMany;
+const appendMany = (store, values, getKey) => addMany(store, values, (allKeys, newKeys) => [...allKeys, ...newKeys], getKey);
+exports.appendMany = appendMany;
+//# sourceMappingURL=addMany.js.map

package/build/store/addMany.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addMany.js","sourceRoot":"","sources":["../../src/store/addMany.ts"],"names":[],"mappings":";;;AACA,oCAAuD;AASvD,MAAM,OAAO,GAAG,CACd,KAAQ,EACR,MAAW,EACX,SAA6D,EAC7D,MAAU,EACP,EAAE;IACL,MAAM,SAAS,GAAG,MAAM,aAAN,MAAM,cAAN,MAAM,GAAK,qBAA8B,CAAC;IAC5D,MAAM,OAAO,GAAG,IAAA,qBAAa,EAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAEpE,uCACK,KAAK,KACR,KAAK,kCACA,KAAK,CAAC,KAAK,GACX,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAE7G,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,IAC1C;AACJ,CAAC,CAAC;AAEK,MAAM,WAAW,GAAY,CAA4B,KAAQ,EAAE,MAA4B,EAAE,MAAmC,EAAE,EAAE,CAC7I,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;AADpE,QAAA,WAAW,eACyD;AAE1E,MAAM,UAAU,GAAY,CAA4B,KAAQ,EAAE,MAA4B,EAAE,MAAmC,EAAE,EAAE,CAC5I,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;AADpE,QAAA,UAAU,cAC0D"}

package/build/store/get.d.ts

@@ -0,0 +1,13 @@
+import { Normalized } from "../types";
+export interface GetOne {
+    <T>(store: Normalized<T>, key: string): T | null;
+    <T extends Normalized<any>>(store: T, key: string): T extends Normalized<infer R> ? R | null : never;
+}
+export interface GetMany {
+    <T>(store: Normalized<T>, keys: string[]): T[];
+    <T extends Normalized<any>>(store: T, keys: string[]): T extends Normalized<infer R> ? R[] : never;
+}
+export declare type Get = GetOne & GetMany;
+export declare const getMany: GetMany;
+export declare const getOne: GetOne;
+export declare const get: Get;

package/build/store/get.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get = exports.getOne = exports.getMany = void 0;
+const has_1 = require("./has");
+const getMany = ({ allKeys, byKey }, keys) => keys.filter((key) => allKeys.includes(key)).map((key) => byKey[key]);
+exports.getMany = getMany;
+const getOne = (store, key) => ((0, has_1.hasOne)(store, key) ? store.byKey[key] : null);
+exports.getOne = getOne;
+const get = (store, keys) => (Array.isArray(keys) ? (0, exports.getMany)(store, keys) : (0, exports.getOne)(store, keys));
+exports.get = get;
+//# sourceMappingURL=get.js.map

package/build/store/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../src/store/get.ts"],"names":[],"mappings":";;;AAEA,+BAA+B;AAcxB,MAAM,OAAO,GAAY,CAAC,EAAE,OAAO,EAAE,KAAK,EAAmB,EAAE,IAAc,EAAE,EAAE,CACtF,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AAD1D,QAAA,OAAO,WACmD;AAEhE,MAAM,MAAM,GAAW,CAAC,KAAsB,EAAE,GAAW,EAAE,EAAE,CAAC,CAAC,IAAA,YAAM,EAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAAzG,QAAA,MAAM,UAAmG;AAE/G,MAAM,GAAG,GAAQ,CAAC,KAAsB,EAAE,IAAuB,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAA,eAAO,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAA,cAAM,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AAAnI,QAAA,GAAG,OAAgI"}

package/build/store/has.d.ts

@@ -0,0 +1,13 @@
+import { Normalized } from "../types";
+export interface HasOne {
+    <T>(store: Normalized<T>, key: string): boolean;
+    <T extends Normalized<any>>(store: T, key: string): boolean;
+}
+export interface HasMany {
+    <T>(store: Normalized<T>, keys: string[]): boolean;
+    <T extends Normalized<any>>(store: T, keys: string[]): boolean;
+}
+export declare type Has = HasOne & HasMany;
+export declare const hasMany: HasMany;
+export declare const hasOne: HasOne;
+export declare const has: Has;

package/build/store/has.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.has = exports.hasOne = exports.hasMany = void 0;
+const utils_1 = require("../utils");
+const hasMany = ({ allKeys }, keys) => keys.every((key) => allKeys.includes(key));
+exports.hasMany = hasMany;
+const hasOne = ({ byKey }, key) => (0, utils_1.hasProperty)(byKey, key);
+exports.hasOne = hasOne;
+const has = (store, keys) => (Array.isArray(keys) ? (0, exports.hasMany)(store, keys) : (0, exports.hasOne)(store, keys));
+exports.has = has;
+//# sourceMappingURL=has.js.map

package/build/store/has.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has.js","sourceRoot":"","sources":["../../src/store/has.ts"],"names":[],"mappings":";;;AACA,oCAAsC;AAc/B,MAAM,OAAO,GAAY,CAAC,EAAE,OAAO,EAAmB,EAAE,IAAc,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AAAhH,QAAA,OAAO,WAAyG;AAEtH,MAAM,MAAM,GAAW,CAAC,EAAE,KAAK,EAAmB,EAAE,GAAW,EAAE,EAAE,CAAC,IAAA,mBAAW,EAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAAtF,QAAA,MAAM,UAAgF;AAE5F,MAAM,GAAG,GAAQ,CAAC,KAAsB,EAAE,IAAuB,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAA,eAAO,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAA,cAAM,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AAAnI,QAAA,GAAG,OAAgI"}

package/build/store/index.d.ts

@@ -0,0 +1,15 @@
+import { GetKey, Identifiable, Normalized } from "../types";
+export * from './add';
+export * from './addMany';
+export * from './get';
+export * from './has';
+export * from './patch';
+export * from './remove';
+export * from './update';
+export interface Normalize {
+    <T extends Identifiable>(items: T[]): Normalized<T>;
+    <T>(items: T[], getKey: GetKey<T>): Normalized<T>;
+}
+export declare const normalize: Normalize;
+export declare const denormalize: <T>({ allKeys, byKey }: Normalized<T>) => T[];
+export declare const createEmpty: <T>() => Normalized<T>;

package/build/store/index.js

@@ -0,0 +1,34 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEmpty = exports.denormalize = exports.normalize = void 0;
+const utils_1 = require("../utils");
+__exportStar(require("./add"), exports);
+__exportStar(require("./addMany"), exports);
+__exportStar(require("./get"), exports);
+__exportStar(require("./has"), exports);
+__exportStar(require("./patch"), exports);
+__exportStar(require("./remove"), exports);
+__exportStar(require("./update"), exports);
+const normalize = (items, getKey) => {
+    const allKeys = items.map(getKey !== null && getKey !== void 0 ? getKey : utils_1.defaultGetKey);
+    return {
+        byKey: (0, utils_1.buildLookup)(allKeys, (0, utils_1.getByIndex)(items)),
+        allKeys,
+    };
+};
+exports.normalize = normalize;
+const denormalize = ({ allKeys, byKey }) => allKeys.map((key) => byKey[key]);
+exports.denormalize = denormalize;
+const createEmpty = () => ({ byKey: {}, allKeys: [] });
+exports.createEmpty = createEmpty;
+//# sourceMappingURL=index.js.map

package/build/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;AACA,oCAAiE;AAEjE,wCAAsB;AACtB,4CAA0B;AAC1B,wCAAsB;AACtB,wCAAsB;AACtB,0CAAwB;AACxB,2CAAyB;AACzB,2CAAyB;AAOlB,MAAM,SAAS,GAAc,CAAmC,KAAU,EAAE,MAAkB,EAAE,EAAE;IACvG,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAK,qBAA2B,CAAC,CAAC;IAElE,OAAO;QACL,KAAK,EAAE,IAAA,mBAAW,EAAI,OAAO,EAAE,IAAA,kBAAU,EAAI,KAAK,CAAC,CAAC;QACpD,OAAO;KACR,CAAC;AACJ,CAAC,CAAC;AAPW,QAAA,SAAS,aAOpB;AAEK,MAAM,WAAW,GAAG,CAAI,EAAE,OAAO,EAAE,KAAK,EAAiB,EAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AAA9F,QAAA,WAAW,eAAmF;AAEpG,MAAM,WAAW,GAAG,GAAqB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;AAAnE,QAAA,WAAW,eAAwD"}

package/build/store/patch.d.ts

@@ -0,0 +1,6 @@
+import { Normalized, NormalizedValue } from "../types";
+export interface PatchOne {
+    <T>(store: Normalized<T>, key: string, patch: Partial<T> | ((value: T) => Partial<T>)): T;
+    <T extends Normalized<any>>(store: T, key: string, patch: Partial<NormalizedValue<T>> | ((value: T) => Partial<NormalizedValue<T>>)): T;
+}
+export declare const patchOne: PatchOne;

package/build/store/patch.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.patchOne = void 0;
+const get_1 = require("./get");
+const has_1 = require("./has");
+const update_1 = require("./update");
+const patchOne = (store, key, patch) => {
+    if (!(0, has_1.hasOne)(store, key))
+        return store;
+    const value = (0, get_1.getOne)(store, key);
+    return (0, update_1.updateOne)(store, key, Object.assign(Object.assign({}, value), (typeof patch === 'function' ? patch(value) : patch)));
+};
+exports.patchOne = patchOne;
+//# sourceMappingURL=patch.js.map

package/build/store/patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.js","sourceRoot":"","sources":["../../src/store/patch.ts"],"names":[],"mappings":";;;AAEA,+BAA+B;AAC/B,+BAA+B;AAC/B,qCAAqC;AAO9B,MAAM,QAAQ,GAAa,CAChC,KAAQ,EACR,GAAW,EACX,KAAgF,EAC7E,EAAE;IACL,IAAI,CAAC,IAAA,YAAM,EAAC,KAAK,EAAE,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAEtC,MAAM,KAAK,GAAG,IAAA,YAAM,EAAC,KAAK,EAAE,GAAG,CAAE,CAAC;IAElC,OAAO,IAAA,kBAAS,EAAC,KAAK,EAAE,GAAG,kCAAO,KAAK,GAAK,CAAC,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAG,CAAC;AACtG,CAAC,CAAC;AAVW,QAAA,QAAQ,YAUnB"}

package/build/store/remove.d.ts

@@ -0,0 +1,13 @@
+import { Normalized } from "../types";
+export interface RemoveOne {
+    <T>(store: Normalized<T>, key: string): Normalized<T>;
+    <T extends Normalized<any>>(store: T, key: string): T;
+}
+export interface RemoveMany {
+    <T>(store: Normalized<T>, keys: string[]): Normalized<T>;
+    <T extends Normalized<any>>(store: T, keys: string[]): T;
+}
+export declare type Remove = RemoveOne | RemoveMany;
+export declare const removeOne: RemoveOne;
+export declare const removeMany: RemoveMany;
+export declare const remove: <T extends Normalized<any>>(store: T, keys: string | string[]) => Normalized<any>;

package/build/store/remove.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.remove = exports.removeMany = exports.removeOne = void 0;
+const utils_1 = require("../utils");
+const removeOne = (store, key) => {
+    const filteredKeys = (0, utils_1.withoutValue)(store.allKeys, key);
+    return Object.assign(Object.assign({}, store), { allKeys: filteredKeys, byKey: (0, utils_1.buildLookup)(filteredKeys, (0, utils_1.getByKey)(store.byKey)) });
+};
+exports.removeOne = removeOne;
+const removeMany = (store, keys) => {
+    const filteredKeys = (0, utils_1.withoutValues)(store.allKeys, keys);
+    return Object.assign(Object.assign({}, store), { allKeys: filteredKeys, byKey: (0, utils_1.buildLookup)(filteredKeys, (0, utils_1.getByKey)(store.byKey)) });
+};
+exports.removeMany = removeMany;
+// eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
+const remove = (store, keys) => Array.isArray(keys) ? (0, exports.removeMany)(store, keys) : (0, exports.removeOne)(store, keys);
+exports.remove = remove;
+//# sourceMappingURL=remove.js.map

package/build/store/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../src/store/remove.ts"],"names":[],"mappings":";;;AACA,oCAA6E;AActE,MAAM,SAAS,GAAc,CAAC,KAAsB,EAAE,GAAW,EAAE,EAAE;IAC1E,MAAM,YAAY,GAAG,IAAA,oBAAY,EAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAEtD,uCACK,KAAK,KACR,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,IAAA,mBAAW,EAAC,YAAY,EAAE,IAAA,gBAAQ,EAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IACvD;AACJ,CAAC,CAAC;AARW,QAAA,SAAS,aAQpB;AAEK,MAAM,UAAU,GAAe,CAAC,KAAsB,EAAE,IAAc,EAAE,EAAE;IAC/E,MAAM,YAAY,GAAG,IAAA,qBAAa,EAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAExD,uCACK,KAAK,KACR,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,IAAA,mBAAW,EAAC,YAAY,EAAE,IAAA,gBAAQ,EAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IACvD;AACJ,CAAC,CAAC;AARW,QAAA,UAAU,cAQrB;AAEF,6EAA6E;AACtE,MAAM,MAAM,GAAG,CAA4B,KAAQ,EAAE,IAAuB,EAAE,EAAE,CACrF,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAA,kBAAU,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAA,iBAAS,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAD5D,QAAA,MAAM,UACsD"}

package/build/store/update.d.ts

@@ -0,0 +1,6 @@
+import { Normalized, NormalizedValue } from "../types";
+export interface UpdateOne {
+    <T>(store: Normalized<T>, key: string, update: T): T;
+    <T extends Normalized<any>>(store: T, key: string, update: NormalizedValue<T>): T;
+}
+export declare const updateOne: UpdateOne;

package/build/store/update.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateOne = void 0;
+const updateOne = (store, key, value) => (Object.assign(Object.assign({}, store), { byKey: Object.assign(Object.assign({}, store.byKey), { [key]: value }) }));
+exports.updateOne = updateOne;
+//# sourceMappingURL=update.js.map

package/build/store/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/store/update.ts"],"names":[],"mappings":";;;AAOO,MAAM,SAAS,GAAc,CAA4B,KAAQ,EAAE,GAAW,EAAE,KAAyB,EAAK,EAAE,CAAC,iCACnH,KAAK,KACR,KAAK,kCAAO,KAAK,CAAC,KAAK,KAAE,CAAC,GAAG,CAAC,EAAE,KAAK,OACrC,CAAC;AAHU,QAAA,SAAS,aAGnB"}

package/build/types.d.ts

@@ -0,0 +1,9 @@
+export interface Identifiable {
+    id: number | string;
+}
+export declare type NormalizedValue<T> = T extends Normalized<infer R> ? R : never;
+export interface Normalized<T> {
+    byKey: Record<string, T>;
+    allKeys: string[];
+}
+export declare type GetKey<T> = (obj: T, index: number, array: T[]) => string;

package/build/types.js

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

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/build/utils.d.ts

@@ -0,0 +1,11 @@
+import { Identifiable } from './types';
+export declare const stringify: (value: any) => string;
+export declare const withoutValue: <T>(items: T[], value: T) => T[];
+export declare const withoutValues: <T>(items: T[], values: T[]) => T[];
+export declare const appendUnique: <T>(items: T[], value: T) => T[];
+export declare const prependUnique: <T>(items: T[], value: T) => T[];
+export declare const buildLookup: <T>(allKeys: string[], getValue: (key: string, index: number) => T) => Record<string, T>;
+export declare const hasProperty: <T, K extends keyof T>(obj: T, key: string | K) => obj is T & Record<K, unknown>;
+export declare const getByIndex: <T>(items: T[]) => (_: string, index: number) => T;
+export declare const getByKey: <T>(lookup: Record<string, T>) => (key: string) => T;
+export declare const defaultGetKey: <T extends Identifiable>(obj: T) => string;

package/build/utils.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultGetKey = exports.getByKey = exports.getByIndex = exports.hasProperty = exports.buildLookup = exports.prependUnique = exports.appendUnique = exports.withoutValues = exports.withoutValue = exports.stringify = void 0;
+const stringify = (value) => (typeof value === 'string' ? value : String(value));
+exports.stringify = stringify;
+const withoutValue = (items, value) => {
+    const index = items.indexOf(value);
+    return index < 0 ? items : [...items.slice(0, index), ...items.slice(index + 1)];
+};
+exports.withoutValue = withoutValue;
+const withoutValues = (items, values) => items.filter((item) => !values.includes(item));
+exports.withoutValues = withoutValues;
+const appendUnique = (items, value) => (items.includes(value) ? items : [...items, value]);
+exports.appendUnique = appendUnique;
+const prependUnique = (items, value) => (items.includes(value) ? items : [value, ...items]);
+exports.prependUnique = prependUnique;
+const buildLookup = (allKeys, getValue) => allKeys.reduce((acc, key, index) => {
+    acc[key] = getValue(key, index);
+    return acc;
+}, {});
+exports.buildLookup = buildLookup;
+const hasProperty = (obj, key) => Object.prototype.hasOwnProperty.call(obj, key);
+exports.hasProperty = hasProperty;
+const getByIndex = (items) => (_, index) => items[index];
+exports.getByIndex = getByIndex;
+const getByKey = (lookup) => (key) => lookup[key];
+exports.getByKey = getByKey;
+const defaultGetKey = (obj) => (0, exports.stringify)(obj.id);
+exports.defaultGetKey = defaultGetKey;
+//# sourceMappingURL=utils.js.map

package/build/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;;AAEO,MAAM,SAAS,GAAG,CAAC,KAAU,EAAU,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAAxF,QAAA,SAAS,aAA+E;AAE9F,MAAM,YAAY,GAAG,CAAI,KAAU,EAAE,KAAQ,EAAO,EAAE;IAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAEnC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;AACnF,CAAC,CAAC;AAJW,QAAA,YAAY,gBAIvB;AAEK,MAAM,aAAa,GAAG,CAAI,KAAU,EAAE,MAAW,EAAO,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAApG,QAAA,aAAa,iBAAuF;AAE1G,MAAM,YAAY,GAAG,CAAI,KAAU,EAAE,KAAQ,EAAO,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAArG,QAAA,YAAY,gBAAyF;AAE3G,MAAM,aAAa,GAAG,CAAI,KAAU,EAAE,KAAQ,EAAO,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;AAAtG,QAAA,aAAa,iBAAyF;AAE5G,MAAM,WAAW,GAAG,CAAI,OAAiB,EAAE,QAA2C,EAAqB,EAAE,CAClH,OAAO,CAAC,MAAM,CAAoB,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;IACpD,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAEhC,OAAO,GAAG,CAAC;AACb,CAAC,EAAE,EAAE,CAAC,CAAC;AALI,QAAA,WAAW,eAKf;AAEF,MAAM,WAAW,GAAG,CAAuB,GAAM,EAAE,GAAe,EAAiC,EAAE,CAC1G,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AADpC,QAAA,WAAW,eACyB;AAE1C,MAAM,UAAU,GACrB,CAAI,KAAU,EAAE,EAAE,CAClB,CAAC,CAAS,EAAE,KAAa,EAAK,EAAE,CAC9B,KAAK,CAAC,KAAK,CAAC,CAAC;AAHJ,QAAA,UAAU,cAGN;AAEV,MAAM,QAAQ,GACnB,CAAI,MAAyB,EAAE,EAAE,CACjC,CAAC,GAAW,EAAK,EAAE,CACjB,MAAM,CAAC,GAAG,CAAC,CAAC;AAHH,QAAA,QAAQ,YAGL;AAET,MAAM,aAAa,GAAG,CAAyB,GAAM,EAAU,EAAE,CAAC,IAAA,iBAAS,EAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAA9E,QAAA,aAAa,iBAAiE"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "normal-store",
+  "description": "tools for interacting with normalized data structures",
+  "version": "1.0.0",
+  "author": "Tyler Han, Ben Teichman",
+  "bugs": {
+    "url": "https://github.com/voiceflow/normal-store/issues"
+  },
+  "config": {
+    "commitizen": {
+      "path": "./node_modules/cz-conventional-changelog"
+    }
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^11.0.0",
+    "@istanbuljs/nyc-config-typescript": "^1.0.1",
+    "@types/chai": "^4.2.15",
+    "@types/mocha": "^9.0.0",
+    "@voiceflow/commitlint-config": "1.1.0",
+    "@voiceflow/eslint-config": "3.4.0",
+    "@voiceflow/git-branch-check": "1.2.0",
+    "@voiceflow/prettier-config": "1.0.5",
+    "@voiceflow/tsconfig": "1.1.0",
+    "@zerollup/ts-transform-paths": "^1.7.18",
+    "chai": "^4.3.0",
+    "commitizen": "^4.2.3",
+    "cz-conventional-changelog": "^3.3.0",
+    "depcheck": "^1.4.2",
+    "eslint": "^7.20.0",
+    "eslint-output": "^3.0.1",
+    "fixpack": "^4.0.0",
+    "husky": "^4.3.8",
+    "istanbul": "^0.4.5",
+    "lint-staged": "^10.5.4",
+    "mocha": "^8.3.0",
+    "nyc": "^15.1.0",
+    "prettier": "^2.2.1",
+    "source-map-support": "^0.5.19",
+    "ts-mocha": "^8.0.0",
+    "ts-node": "^9.1.1",
+    "ttypescript": "^1.5.12",
+    "typescript": "^4.4.2"
+  },
+  "files": [
+    "build/"
+  ],
+  "homepage": "https://github.com/voiceflow/normal-store#readme",
+  "keywords": [
+    "data",
+    "voiceflow"
+  ],
+  "license": "ISC",
+  "main": "build/index.js",
+  "prettier": "@voiceflow/prettier-config",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/voiceflow/normal-store.git"
+  },
+  "scripts": {
+    "build": "yarn clean && ttsc --project ./tsconfig.build.json --declaration",
+    "clean": "rimraf build",
+    "commit": "cz",
+    "eslint-output": "eslint-output",
+    "lint": "eslint '**/*.{js,ts}'",
+    "lint:output": "yarn run eslint-output --quiet \"**/*.{js,ts}\"",
+    "lint:quiet": "yarn lint --quiet",
+    "lint:report": "yarn lint:output",
+    "prepublishOnly": "yarn build",
+    "test": "yarn test:run",
+    "test:dependencies": "depcheck",
+    "test:integration": "NODE_ENV=test nyc --report-dir nyc_coverage_integration ts-mocha --paths --config ./config/test/.mocharc.yml 'test/**/*.it.ts'",
+    "test:run": "NODE_ENV=test nyc ts-mocha --paths --config ./config/test/.mocharc.yml 'test/**/*.{unit,it}.ts'",
+    "test:single": "NODE_ENV=test ts-mocha --paths --config ./config/test/.mocharc.yml",
+    "test:unit": "NODE_ENV=test nyc --report-dir=nyc_coverage_unit ts-mocha --paths --config ./config/test/.mocharc.yml 'test/**/*.unit.ts'"
+  },
+  "types": "build/index.d.ts"
+}