Haketilo

/**

 * This file is part of Haketilo.

 *

 * Function: Facilitate use of IndexedDB within Haketilo.

 *

 * This program is free software: you can redistribute it and/or modify

 * it under the terms of the GNU General Public License as published by

 * the Free Software Foundation, either version 3 of the License, or

 * (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * As additional permission under GNU GPL version 3 section 7, you

 * may distribute forms of that code without the copy of the GNU

 * GPL normally required by section 4, provided you include this

 * license notice and, in case of non-source distribution, a URL

 * through which recipients can access the Corresponding Source.

 * If you modify file(s) with this exception, you may extend this

 * exception to your version of the file(s), but you are not

 * obligated to do so. If you do not wish to do so, delete this

 * exception statement from your version.

 *

 * As a special exception to the GPL, any HTML file which merely

 * makes function calls to this code, and for that purpose

 * includes it by reference shall be deemed a separate work for

 * copyright law purposes. If you modify this code, you may extend

 * this exception to your version of the code, but you are not

 * obligated to do so. If you do not wish to do so, delete this

 * exception statement from your version.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program.  If not, see <https://www.gnu.org/licenses/>.

 *

 * I, Wojtek Kosior, thereby promise not to sue for violation of this file's

 */

#IMPORT common/broadcast.js

let initial_data = (

    {}

#ELSE

/* Update when changes are made to database schema. Must have 3 elements */

const nr_reductor = ([i, s], num) => [i - 1, s + num * 1024 ** i];

    ["mapping",   {keyPath: "identifier"}],

let db = null;

/* Generate a Promise that resolves when an IndexedDB request succeeds. */

async function wait_request(idb_request)

{

    let resolve, reject;

    const waiter = new Promise((...cbs) => [resolve, reject] = cbs);

    [idb_request.onsuccess, idb_request.onerror] = [resolve, reject];

    return waiter;

}

/* asynchronous wrapper for IDBObjectStore's get() method. */

async function idb_get(transaction, store_name, key)

{

    const req = transaction.objectStore(store_name).get(key);

    return (await wait_request(req)).target.result;

}

/* asynchronous wrapper for IDBObjectStore's put() method. */

async function idb_put(transaction, store_name, object)

{

    return wait_request(transaction.objectStore(store_name).put(object));

}

/* asynchronous wrapper for IDBObjectStore's delete() method. */

async function idb_del(transaction, store_name, key)

{

    return wait_request(transaction.objectStore(store_name).delete(key));

}

    const transaction = event.target.transaction;

    if (event.oldVersion == 0) {

	for (const [store_name, key_mode] of stores)

	    opened_db.createObjectStore(store_name, key_mode);

    }

    if (event.oldVersion > 0 && event.oldVersion < db_version_nr) {

	const v1_url = "https://hydrilla.koszko.org/api_v1/";

	const v1_entry = await idb_get(transaction, "repo", v1_url);

	if (v1_entry) {

	    const v2_url = "https://hydrilla.koszko.org/api_v2/";

	    await idb_del(transaction, "repo", v1_url);

	    await idb_put(transaction, "repo", {url: v2_url});

	}

    }

    if (event.oldVersion == 0) {

	const ctx = make_context(transaction, initial_data.file);

	await _save_items(initial_data.resource, initial_data.mapping,

			  initial_data.repo || [], ctx);

    } else {

	await new Promise(

	    (...cbs) => [transaction.onsuccess, transaction.onerror] = cbs

	);

    }

    return opened_db;

}

	return db;

    let resolve, reject;

    const waiter = new Promise((...cbs) => [resolve, reject] = cbs);

	opened_db.close();

    else

	db = opened_db;

    return db;

}

function reject_discard(context)

{

    broadcast.discard(context.sender);

    broadcast.close(context.sender);

    context.reject();

}

/* Helper function used by make_context(). */

function resolve_flush(context)

{

    broadcast.close(context.sender);

    context.resolve();

}

function make_context(transaction, files)

{

    const context =

	  {sender, transaction, resolve, reject, result, files, file_uses: {}};

    transaction.onerror = () => reject_discard(context);

    return context;

}

/*

 * values will be yet another object with values being contents of files that

 * are to be possibly saved in this transaction and keys being hexadecimal

 * representations of files' SHA256 sums.

 * Returned is a context object wrapping the transaction and handling the

 * counting of file references in IndexedDB.

 */

async function start_items_transaction(item_store_names, files)

{

}

async function incr_file_uses(context, file_ref, by=1)

{

    let uses = context.file_uses[sha256];

	    [uses.new, uses.initial] = [false, uses.uses];

	else

    uses.uses = uses.uses + by;

}

const decr_file_uses = (ctx, file_ref) => incr_file_uses(ctx, file_ref, -1);

    for (const uses of Object.values(context.file_uses)) {

	if (uses.uses < 0)

	const is_new       = uses.new;

	const initial_uses = uses.initial;

	delete uses.new;

	delete uses.initial;

	if (uses.uses < 1) {

	    if (!is_new) {

	    continue;

	}

	if (uses.uses === initial_uses)

	    continue;

	idb_put(context.transaction, "file_uses", uses);

	if (initial_uses > 0)

	    continue;

	    context.transaction.abort();

    return context.result;

}

 * How a sample data argument to the function below might look like:

 *

 * data = {

 *             "1": {

 *                 // some stuff

 *             },

 *             "1.1": {

 *                 // some stuff

 *             }

 *         },

 *         "resource2": {

 *             "0.4.3": {

 *                 // some stuff

 *             }

 *         },

 *     },

 *             "2": {

 *                 // some stuff

 *             }

 *         },

 *         "mapping2": {

 *             "0.1": {

 *                 // some stuff

 *             }

 *         },

 *     },

 *         sha256: {

 *             "f9444510dc7403e41049deb133f6892aa6a63c05591b2b59e4ee5b234d7bbd99": "console.log(\"hello\");\n",

 *             "b857cd521cc82fff30f0d316deba38b980d66db29a5388eb6004579cf743c6fd": "console.log(\"bye\");"

 *         }

 * }

 */

	item_store_names.push("repo");

    mappings  = Object.values(mappings  || {}).map(entities.get_newest);

	await save_item(item, context);

	broadcast.prepare(context.sender, "idb_changes_repo", repo_url);

/*

 * Save given definition of a resource/mapping to IndexedDB. If the definition

 * (passed as `item`) references files that are not already present in

 * used to create the transaction context.

 * context should be one returned from start_items_transaction() and should be

 * IndexedDB and files that are no longer depended on after this operation are

 * removed from IndexedDB.

    for (const file_ref of entities.get_files(item))

    await idb_put(context.transaction, item.type, item);

async function _remove_item(store_name, identifier, context)

{

    const item = await idb_get(context.transaction, store_name, identifier);

    if (item !== undefined) {

	for (const file_ref of entities.get_files(item))

	    await decr_file_uses(context, file_ref);

 * Remove definition of a resource/mapping from IndexedDB.

 *

 * context should be one returned from start_items_transaction() and should be

 * IndexedDB and files that are no longer depended on after this operation are

 * removed from IndexedDB.

async function remove_item(store_name, identifier, context)

{

    await idb_del(context.transaction, store_name, identifier);

async function get_all(store_name)

{

    const transaction = (await get_db()).transaction([store_name]);

    const all_req = transaction.objectStore(store_name).getAll();

    return (await wait_request(all_req)).target.result;

}

#EXPORT get_all

/*

 * A simplified kind of transaction for modifying stores without special

async function start_simple_transaction(store_name)

    const db = await get_db();

{

    broadcast.prepare(context.sender, "idb_changes_setting", name);

    await idb_put(context.transaction, "setting", {name, value});

}

#EXPORT set_setting

async function get_setting(name)

{

    return ((await idb_get(transaction, "setting", name)) || {}).value;

#EXPORT get_setting

async function set_allowed(pattern, allow=true)

{

    const context = await start_simple_transaction("blocking");

    broadcast.prepare(context.sender, "idb_changes_blocking", pattern);

    if (allow === null)

	await idb_del(context.transaction, "blocking", pattern);

    else

	await idb_put(context.transaction, "blocking", {pattern, allow});

    return finalize_transaction(context);

}

#EXPORT set_allowed

const set_disallowed = pattern => set_allowed(pattern, false);

#EXPORT set_disallowed

const set_default_allowing = pattern => set_allowed(pattern, null);

#EXPORT set_default_allowing

async function get_allowing(pattern)

{

    const transaction = (await get_db()).transaction("blocking");

    return ((await idb_get(transaction, "blocking", pattern)) || {}).allow;

}

#EXPORT get_allowing

{

    broadcast.prepare(context.sender, "idb_changes_repo", url);

}

#EXPORT set_repo

const del_repo = url => set_repo(url, true);

#EXPORT del_repo

/*

 * Monitor changes to `store_name` IndexedDB object store.

 *

 * or "repo".

 * `onchange` should be a callback that will be called when an item is added,

 * modified or removed from the store. The callback will be passed an object

 * representing the change as its first argument. This object will have the

 * form:

 * {

 * }

 *

 * Returns a [tracking, all_current_items] array where `tracking` is an object

 * store.

 *

 * It is possible that `onchange` gets spuriously fired even when an item is not

 * actually modified or that it only gets called once after multiple quick

 * changes to an item.

 */

    const tracking = {store_name, onchange};

    tracking.listener =

	broadcast.listener_connection(msg => track_change(tracking, msg[1]));

    broadcast.subscribe(tracking.listener, `idb_changes_${store_name}`);

#EXPORT track

const untrack = tracking => broadcast.close(tracking.listener);

#EXPORT untrack