VStore - The most lenient way of saving data.

If you want to support, you can ⭐ the repo!

Written in TypeScript with the power of TSLib

FAQ

Where is data stored?

Data is stored in a folder named store located in the current CWD.

What's the point?

To make data syncing easy.

Does it work with TypeScript

It's written in TypeScript, so yes.

Code examples

Examples are written in JavaScript

Setting up stuff

// Lets require the module!
const { VStore } = require("vstorejs");
//or
import { VStore } from "vstorejs";
// Create a store, we have to use
const Name = new VStore({
  name: `Name`, // Required
  memoryCache: true, // Defaults to false, if you want it enabled, set it as true
  json: true, // Defaults to false, if you want it enabled, set it as true
});
// Note, to actually save data you need to have atleast one of the db methods active.
// you can also use new VStore.VStore, if you realy need too.

Setting data

const Instance = Name.instance({
  // list your properties here....
  name: `john`, // Grabs type of the property
  sirname: `doe`, // Grabs the type of the property
  fullname: `{name} {sirname}`, // Allows you to replace strings automatically with this.properties, powered by cjays
}); // properties are optional
const Model = Instance.create({
  name: `peter`,
  sirname: `jeff`,
});
// If you don't specify something when creating the model, it will default to the value. Example is when you add name and sirname but not fullname, fullname would be: 'peter jeff'

const Model2 = Instance.create(); // The properties on this would be:
/**
 * name: 'john',
 * sirname: 'doe',
 * fullname: 'john doe'
 *
 */

const Model3 = Instance.create({
  MyCustomProperty: `this isn't listed in the instance`,
});
// Properties on this would be:
/**
 * name: 'john',
 * sirname: 'doe',
 * fullname: 'john doe',
 * MyCustomProperty: 'this isn't listed in the instance'
 */
});

Deleting data

Model.delete();
// or
Name.delete({/* search for things here */ }, index?); // this will call the search method, if you don't specify the index it'll default to 0, it takes in a number!

Updating data

Model.update({ myNewProperty: "hello" });

Features

• Temporary JSON storage in the store directory
• Memory cache

Search data

Name.search({ fullname: "john doe" }); // returns an array of items containing documents with fulllname as johndoe

Dependencies cjays tslib lodash.defaults nanoid

Examples

You can find examples in the github repositors, in the examples directory.

Planned features

Name is an instance of VStore.

Name.duplicate({ searchData }, index?); // returns an instance of a model with duplicated data
Name.update({ serchData }, { newParams }, index?) // updates a model

Support for:

Template: DB_NAME (PLANNED_VERSION_TO_RELEASE)

Example:

MyCoolDB (V4) ^ This means that we plan to add support for MyCoolDB in Version 4 of VStore

• Postgres (V3)
• MongoDB (V1.1)
• Redis (V2)
• SQLite (V3)