construct/modules/static/js/storage.js

/*
 * IRCd Charybdis 5/Matrix
 *
 * Copyright (C) 2017 Charybdis Development Team
 * Copyright (C) 2017 Jason Volk (jason@zemos.net)
 *
 * Permission to use, copy, modify, and/or distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice is present in all copies.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 *
 */

'use strict';

/**************************************
 *
 * Local & Session storage
 *
 * Lifetimes in order from most persistent to most transient:
 *
 * + mc.account - synchronized with server account_data (requires auth)
 * + mc.local - synchronized with window localStorage
 * + mc.session - synchronized with window sessionStorage
 * + mc.instance - not synchronized; lifetime is the same as mc object.
 *
 * Note that the storage objects are serialized to JSON when actually being stored.
 * Anything placed inside a live storage object should have a JSON representation.
 *
 * Note that storage is partitioned based on the mc.opts.base_url. This ensures
 * if the target server changes for whatever reason the webstorage objects will be
 * different for different base URL's.
 *
 */

mc.storage = {};

/* Reads from webstorage into the client's webstorage globals.
 */
mc.storage.init = function()
{
	let prefix = mc.opts.base_url.hash();
	let update = (facility, target) =>
	{
		let item = facility.getItem(prefix);
		if(item == null)
			return;

		let data = JSON.parse(item);
		Object.update(target, data);
	};

	update(localStorage, mc.local);
	update(sessionStorage, mc.session);
	//console.log("read local storage objects");

	if(typeof(mc.session.model) != "object")
		mc.session.model = {};

	mc.model = mc.session.model;

	if(typeof(mc.model.show) != "object")
		mc.model.show = {};

	mc.show = mc.model.show;
};

/** Writes back the client's webstorage objects.
 */
mc.storage.sync = function()
{
	let prefix = mc.opts.base_url.hash();
	let update = (facility, source) =>
	{
		let item = JSON.stringify(source);
		facility.setItem(prefix, item);
	};

	update(localStorage, mc.local);
	update(sessionStorage, mc.session);
	//console.log("wrote local storage objects");
};

/**
 * account_data based storage
 */
mc.storage.account = {};

/** Update account-based storage object
 */
mc.storage.account.update = function(data)
{
	Object.update(mc.account, data);
};

/** Write back account-based storage to server
 */
mc.storage.account.sync = function()
{
	if(!mc.instance.authentic)
		return false;

	return mc.storage.account.sync.data();
};

mc.storage.account.sync.data = async function()
{
	let data = mc.account;
	let user_id = mc.my.mxid;
	let type = mc.opts.account_data.key;
	if(empty(data))
		return;

	let request = mc.m.user.account_data.put(user_id, type, data); try
	{
		let response = await request.response;
	}
	catch(error)
	{
		console.error("Error synchronizing account_data: " + error);
	}
};