Is GroundDB the best for offline storage?

banjerluke · December 1, 2021, 2:49pm

I found that the internal API in LocalCollection that ground:db uses switched from an object to a Map sometime around Meteor 2.4. I didn’t think to look at any of the forks. Rather, I did a from-the-ground-up (pun unintended) rewrite, which I’m calling GroundedCollection. I switched to Typescript, added the ability to specify compression/decompression functions for writes/reads to IndexedDB, and switched from localforage to Dexie, but otherwise tried to keep the API similar.

As a bonus, Dexie allowed me to use bulk reads/writes, which decreased load times by an enormous amount – I can’t remember the multiplier but it was in the tens if not hundreds of times.

It’s not packaged or anything, but it’s been running in production for a couple months now with no issues, so I will share it here in case anyone would like to use it:

gist.github.com

https://gist.github.com/banjerluke/554cb2274c4f55c2254288aa243994ed

GroundedCollection.ts

import Dexie from 'dexie';
import { EJSON } from 'meteor/ejson';
import type { Mongo } from 'meteor/mongo';
import type { Meteor } from 'meteor/meteor';
import { Tracker } from 'meteor/tracker';
import { throttle } from 'underscore';
import { PendingCounter } from './PendingCounter';

interface LocalCollectionInternal {
  queries: Record<any, any>;

This file has been truncated. show original

PendingCounter.ts

import { Tracker } from 'meteor/tracker';

export class PendingCounter {
  private _zeroDep = new Tracker.Dependency();
  private _valueDep = new Tracker.Dependency();
  _value = 0;
  _total = 0;

  inc(by = 1): void {
    this._value += by;

This file has been truncated. show original