Svelte Persistent store

A Svelte store that keep its value through pages and reloads

!Github CI
!GitHub Repo stars
!NPM bundle size
!Download per week
!License
!NPM version
!Snyk Vulnerabilities for npm package

Installation

``
npm install @macfja/svelte-persistent-store
`

Usage

`javascript
import { persist, createLocalStorage } from "@macfja/svelte-persistent-store"
import { writable } from "svelte/store"

let name = persist(writable("John"), createLocalStorage(), "name")

$name = "Jeanne Doe"

// if you reload the page the value of $name is 'Jeanne Doe'
`

`javascript
import { persistBrowserSession } from "@macfja/svelte-persistent-store"
import { writable } from "svelte/store"

let title = persistBrowserSession(writable("Unsaved"), "document-name")

$title = "My Document"

// if you reload the page the value of $title is 'My Document'
`

`javascript
import { writable } from "@macfja/svelte-persistent-store"

// Create a wriatble store, persisted in browser LocalStorage, with the key name
let name = writable("name", "John")

$name = "Jeanne Doe"

// if you reload the page the value of $name is 'Jeanne Doe'
`

Features

- Multiple storages (Allow to have the best suited usage depending on your use case)
- Work with any Svelte store
- Work with classes, objects, primitive

Storages

There are 6 storages built-in:

- createLocalStorage(), that use window.localStorage to save values
- createSessionStorage(), that use window.sessionStorage to save values
- createCookieStorage(), that use document.cookie to save values
- createIndexedDBStorage(), that use window.indexedDB to save value
- createChromeStorage(), that use chrome.storage to save values
- createEncryptedStorage(), that wrap a storage to encrypt data (and key)

You can add more storages, you just need to implement the interface StorageInterface

Documentation

Documentation and examples can be generated with npm run doc, next open docs/index.html with your favorite web browser.

(Hint: If you don't want to generate the docs, a part of the example and documentation are available here)

$3

The persist function will return a new Store with type PersistentStore.

The full signature of persist is:

`typescript
declare function persist(store: Writable, storage: StorageInterface, key: string): PersistentStore
`

The persist function add a delete function on the store.

More information about types can be found in the generated types/index.d.ts (npm run prebuild) or in the generated documentation (npm run doc).

Backwards Compatibility Break

$3

Data persisted in version 1.3.0 may not be deserializable with version 2.*.

If you have persisted store that contains Javascript class with version 1.3.0 of @macfja/svelte-persistent-store` you will not be able to get the data by default.
This is due to a change of data serialization. More information here

Contributing

Contributions are welcome. Please open up an issue or create PR if you would like to help out.

Read more in the Contributing file

License

The MIT License (MIT). Please see License File for more information.