@wranggle/storage-core
v0.2.4
Published
Core package for WranggleStorage class
Downloads
11
Maintainers
Readme
WranggleStorage Misc
This @wranggle/storage-core
package is responsible for the main WranggleStorage
class, used to create an RPC endpoint.
Its main documentation is in the topmost README of this monorepo. This rpc-storage README holds odds and ends that don't belong there.
Subset Store
The createSubsetStore
method lets you splinter off a new WranggleStorage instance from an existing one, inheriting all of the parent feature layers. You can then add new feature layers to the child that are not applied to the parent.
For example, you might set up a parent sessionStore to hold transient data, then apply different namespaces to child stores:
const sessionStore = myStore.createSubsetStore({ expire: oneDayInMs });
const thisProjectStore = sessionStore.createSubsetStore({ bucket: 'Project:01' });
const thatProjectStore = sessionStore.createSubsetStore({ bucket: 'Project:02' });
Both thisProjectStore
and thatProjectStore
share the expiring-keys behavior of its parent. The "bucket" option adds a KeyNameLayer, creating separate namespaces for the child stores.
Manipulate Feature Layers
Normally you'll specify the feature layers needed when you construct your WranggleStorage instance. You can, however, add or remove features after construction.
The store instance contains an array of FeatureLayer instances that you can manipulate. myStore.layers
is publicly accessible and can be manipulated directly. Your WranggleStorage instance includes a couple helper methods:
useFeatureLayer constructs the feature layer instance if not already created, pushing the result to the end of the
layers
array.myStore.useFeatureLayer({ bucket: 'Projects' }); // inserts at ndx 1, the second feature layer in the array
insertFeatureLayerAt constructs the feature layer if necessary and inserts it at the specified position. Eg:
myStore.insertFeatureLayerAt(new MyCustomLayer(), 1); // inserts at ndx 1, the second feature layer in the array
As with any middleware, order can make a difference. Be careful sorting or repositioning your feature layers.
When a data method is called, each layer has an opportunity to modify the request, from leftmost layer to the rightmost (oldest layer to newest) and then can modify the response / result in the opposite order, from right to left (newest to oldest layer.)
Custom Feature Layers
TODO:
- how it works
- example and links to src of existing ones
- can extend NoopFeatureLayer
- tip: attention to ctx.result (vs return value. easy to forget)
- registering construction shortcut
Custom Persistence Adapter
TODO:
- how it works
- example and links
- registering construction shortcut
Static Methods
WranggleStorage.knownPersistenceAdapterTypes(): string[]
static method returns array of known persistence adapter types. These can be used as shortcuts during construction. Eg, if "memory" is listed, you can usenew WranggleStorage({ memory: true })
WranggleStorage.knownFeatureLayerTypes(): string[]
static method returns array of known feature layer types. These can be used as shortcuts during construction. Eg, if "bucket" is listed, you can usenew WranggleStorage({ bucket: 'myBucket' })
WranggleStorage.registerPersistenceAdapter(adapterType: string, factory: (opts: any) => PersistenceAdapter)
. Register a factory function for building your custom persistence adapter. Once registered, the adapterType can be used as a shortcut when instantiating WranggleStorage.WranggleStorage.registerFeatureLayer(layerType: string, factory: (opts: any) => FeatureLayer)
. Register a factory function for building your custom feature layer. Once registered, the layerType can be used as a shortcut when instantiating WranggleStorage or callinguseFeatureLayer
.