A cross-browser/platform indexeddb-like client library
Перейти к файлу
Thomas Tay 5dd9f0f63a DONT APPROVE: for testing and builds 2021-08-03 10:18:02 -07:00
.github/workflows Cleanups to publish to npm (#22) 2021-07-12 15:48:07 -07:00
.vscode Updating to prettier, 2021-06-17 19:40:52 -07:00
dist DONT APPROVE: for testing and builds 2021-08-03 10:18:02 -07:00
src feat: Replace rbtree with btree 2021-08-02 21:10:23 -07:00
.eslintrc.js Updating to prettier, 2021-06-17 19:40:52 -07:00
.gitignore DONT APPROVE: for testing and builds 2021-08-03 10:18:02 -07:00
.npmignore Cleanups to publish to npm (#22) 2021-07-12 15:48:07 -07:00
.npmrc Cleanups to publish to npm (#22) 2021-07-12 15:48:07 -07:00
.prettierignore Updating to prettier, 2021-06-17 19:40:52 -07:00
.prettierrc.json Updating to prettier, 2021-06-17 19:40:52 -07:00
.yarnclean Updating to webpack 5 2021-06-18 18:29:53 -07:00
CODE_OF_CONDUCT.md Cleanups to publish to npm (#22) 2021-07-12 15:48:07 -07:00
CONTRIBUTING.md Cleanups to publish to npm (#22) 2021-07-12 15:48:07 -07:00
LICENSE Updating LICENSE with LCA-approved language 2016-01-05 16:38:12 -08:00
README.md Cleanups to publish to npm (#22) 2021-07-12 15:48:07 -07:00
SECURITY.md Cleanups to publish to npm (#22) 2021-07-12 15:48:07 -07:00
index.ts Updating to prettier, 2021-06-17 19:40:52 -07:00
karma.browser.conf.js Fixes to ignore spec files in published packages, 2021-06-19 00:17:25 -07:00
karma.sharedworker.conf.js Fixes to ignore spec files in published packages, 2021-06-19 00:17:25 -07:00
karma.webworker.conf.js Fixes to ignore spec files in published packages, 2021-06-19 00:17:25 -07:00
package.json feat: Replace rbtree with btree 2021-08-02 21:10:23 -07:00
tsconfig.json Downgraded tsconfig output to ES5, and did package upgrades (#20) 2021-06-23 14:26:46 -07:00
webpack.config.js PRettier fixes + Trying workflow auth for 3rd time 2021-06-18 18:56:23 -07:00
yarn.lock feat: Replace rbtree with btree 2021-08-02 21:10:23 -07:00

README.md

ObjectStoreProvider Build Status

We developed ObjectStoreProvider after needing a simplified interface toobject storage/retrieval that worked not only across all browsers. We also have built a fully in-memory database provider that has no persistence but supports fully transactional semantics, for a fallback in situations where you don't want persistence (ephemeral logins, etc.)

Differences to NoSqlProvider

This project has some notable differences to NoSqlProvider, and these differences are why it is a separate repo

  1. Support for removeRange apis.
  2. Support for getMultiple on any index.
  3. Unlike in the case of ObjectStoreProvider, the inMemoryProvider is actually mutable. This was mainly done as we enforce immutability using typescript DeepReadonly types. Consumers should be aware of this while consuming the library. In the near future we will change to interfaces throughout the project to return readonly types. It is highly recommended that consumers add lint rules that prevent casting to , or operations like Object.assign() which will break the immutability.
  4. Targets ES6, and higher ES versions for better performance
  5. It uses red-black tree based indices for better performance of the inMemory provider

The rest of these changes in the library have been pushed upstream to ObjectStoreProvider as well. However, points 3, 4 & 5 are irreconcilable as it needs to be enforced across all consumers of ObjectStoreProvider. Hence this repo has been made separately.

Examples

None available, we will add some soon!.

Providers/Platforms/Support

Browsers: Firefox, Safari, Edge, Chrome. Execution Contexts: WebWorkers, SharedWorkers, ServiceWorkers, Browser context.

Desktop Frameworks: WebView2, Electron

Other support: NodeJS

Usage

Coming soon.

Compiling

Source

yarn install
yarn build

Tests

yarn install
yarn ci-test

Testing

If a test fails and you need to run the individual tests, see which test command failed from the above run .i.e karma.sharedworker.conf.js, karma.webworker.conf.js, karma.browser.conf.js Once identified, simply run the following

yarn install
yarn build
yarn test:debug:<target>

Where <target> is either webworker, sharedworker or browser. Look through package.json for more details. The default runner will launch both firefox + chrome in debug mode.

To iterate over tests, instead of the yarn build command mentioned above, run yarn watch instead.

Contributing

Please read the Contributing guide.

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsofts Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-partys policies.