core-3nweb-client-lib 0.44.11 → 0.45.0

package/build/tests/caps-api/storage.js

@@ -0,0 +1,225 @@
+"use strict";
+/*
+ Copyright (C) 2016, 2018, 2020, 2022, 2026 3NSoft Inc.
+ 
+ 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.
+ 
+ You should have received a copy of the GNU General Public License along with
+ this program. If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+const jasmine_utils_1 = require("../libs-for-tests/jasmine-utils");
+const setups_1 = require("../libs-for-tests/setups");
+const spec_module_1 = require("../libs-for-tests/spec-module");
+const path_1 = require("path");
+const os_1 = require("os");
+const storage_1 = require("../../core/storage");
+const core_runner_1 = require("../libs-for-tests/core-runner");
+const test_utils_1 = require("./fs-checks/test-utils");
+const assert_1 = require("../../lib-common/assert");
+const allowedAppFS = core_runner_1.testApp.capsRequested.storage.appFS
+    .map(s => (0, storage_1.reverseDomain)(s.domain));
+describe('3NStorage', () => {
+    const s = (0, setups_1.setupWithUsers)(true);
+    let w3n;
+    (0, jasmine_utils_1.beforeAllWithTimeoutLog)(async () => {
+        if (!s.isUp) {
+            return;
+        }
+        w3n = s.testAppCapsByUserIndex(0);
+    });
+    (0, jasmine_utils_1.itCond)('storage capability is present in test app', async () => {
+        expect(typeof w3n.storage).toBe('object');
+    }, undefined, s);
+    describe('.getAppSyncedFS', () => {
+        (0, jasmine_utils_1.itCond)('will not produce FS for domain (reversed), not associated with app', async () => {
+            await w3n.storage.getAppSyncedFS('com.app.unknown')
+                .then(() => {
+                fail('should not produce FS for an arbitrary app');
+            }, (e) => {
+                expect(e.runtimeException).toBe(true);
+                expect(e.type).toBe('storage');
+                expect(e.notAllowedToOpenFS).toBeTruthy();
+            });
+        }, undefined, s);
+        (0, jasmine_utils_1.itCond)('produces FS for domains (reversed), associated with app', async () => {
+            for (const appDomain of allowedAppFS) {
+                const fs = await w3n.storage.getAppSyncedFS(appDomain);
+                expect(fs).toBeTruthy();
+            }
+        }, undefined, s);
+        (0, jasmine_utils_1.itCond)('concurrently produces FS for an app', async () => {
+            const appDomain = allowedAppFS[0];
+            const promises = [];
+            for (let i = 0; i < 10; i += 1) {
+                const promise = w3n.storage.getAppSyncedFS(appDomain);
+                promises.push(promise);
+            }
+            await Promise.all(promises)
+                .then((fss) => {
+                for (const fs of fss) {
+                    expect(fs).toBeTruthy();
+                }
+            }, () => {
+                fail(`Fail to concurrently get app fs`);
+            });
+        }, undefined, s);
+    });
+    describe('.getAppLocalFS', () => {
+        (0, jasmine_utils_1.itCond)('will not produce FS for domain, not associated with app', async () => {
+            await w3n.storage.getAppLocalFS('com.app.unknown')
+                .then(() => {
+                fail('should not produce FS for an arbitrary app');
+            }, (e) => {
+                expect(e.runtimeException).toBe(true);
+                expect(e.type).toBe('storage');
+                expect(e.notAllowedToOpenFS).toBeTruthy();
+            });
+        }, undefined, s);
+        (0, jasmine_utils_1.itCond)('produces FS for domains (reversed), associated with app', async () => {
+            for (const appDomain of allowedAppFS) {
+                const fs = await w3n.storage.getAppLocalFS(appDomain);
+                expect(fs).toBeTruthy();
+            }
+        }, undefined, s);
+        (0, jasmine_utils_1.itCond)('concurrently produces FS for an app', async () => {
+            const appDomain = allowedAppFS[0];
+            const promises = [];
+            for (let i = 0; i < 10; i += 1) {
+                const promise = w3n.storage.getAppLocalFS(appDomain);
+                promises.push(promise);
+            }
+            await Promise.all(promises)
+                .then((fss) => {
+                for (const fs of fss) {
+                    expect(fs).toBeTruthy();
+                }
+            }, () => {
+                fail(`Fail to concurrently get app fs`);
+            });
+        }, undefined, s);
+    });
+    describe('.getSysFS', () => {
+        (0, jasmine_utils_1.itCond)('produces collection of items in synced storage', async () => {
+            const sysItems = await w3n.storage.getSysFS('synced');
+            expect(sysItems.isCollection).toBe(true);
+        });
+        (0, jasmine_utils_1.itCond)('produces device item, indicated by path', async () => {
+            const semiRandomDevFolder = __dirname;
+            const devItems = await w3n.storage.getSysFS('device', semiRandomDevFolder);
+            expect(devItems.isFolder).toBe(true);
+        });
+    });
+    describe('local FS is a web3n.files.WritableFS', () => {
+        const fsSetup = {};
+        (0, jasmine_utils_1.beforeAllWithTimeoutLog)(async () => {
+            if (!s.isUp) {
+                return;
+            }
+            fsSetup.isUp = true;
+            fsSetup.testFS = await w3n.storage.getAppLocalFS(allowedAppFS[0]);
+        });
+        (0, jasmine_utils_1.afterEachCond)(async () => {
+            if (!s.isUp) {
+                return;
+            }
+            await (0, test_utils_1.clearFS)(fsSetup.testFS);
+        });
+        (0, spec_module_1.loadSpecs)(fsSetup, (0, path_1.join)(__dirname, 'fs-checks', 'not-versioned'), (((0, os_1.platform)() === 'win32') ? ['win-local-fs'] : undefined));
+        (0, spec_module_1.loadSpecs)(fsSetup, (0, path_1.join)(__dirname, 'file-sink-checks'));
+    });
+    describe('local FS is a web3n.files.WritableFS with versioned API', () => {
+        const fsSetup = {};
+        (0, jasmine_utils_1.beforeAllWithTimeoutLog)(async () => {
+            if (!s.isUp) {
+                return;
+            }
+            fsSetup.isUp = true;
+            fsSetup.testFS = await w3n.storage.getAppLocalFS(allowedAppFS[0]);
+        });
+        (0, jasmine_utils_1.afterEachCond)(async () => {
+            if (!s.isUp) {
+                return;
+            }
+            await (0, test_utils_1.clearFS)(fsSetup.testFS);
+        });
+        (0, spec_module_1.loadSpecs)(fsSetup, (0, path_1.join)(__dirname, 'fs-checks', 'versioned'));
+    });
+    function syncedFsSetup() {
+        const fsSetup = {};
+        (0, jasmine_utils_1.beforeAllWithTimeoutLog)(async () => {
+            if (!s.isUp) {
+                return;
+            }
+            fsSetup.testFS = await w3n.storage.getAppSyncedFS(allowedAppFS[0]);
+            (0, assert_1.assert)(!!fsSetup.testFS.v.sync);
+            fsSetup.isUp = true;
+        });
+        (0, jasmine_utils_1.afterEachCond)(async () => {
+            if (!s.isUp) {
+                return;
+            }
+            await (0, test_utils_1.clearFS)(fsSetup.testFS);
+        });
+        return fsSetup;
+    }
+    describe('synced FS is a web3n.files.WritableFS', () => {
+        const fsSetup = syncedFsSetup();
+        (0, spec_module_1.loadSpecs)(fsSetup, (0, path_1.join)(__dirname, 'fs-checks', 'not-versioned'));
+        (0, spec_module_1.loadSpecs)(fsSetup, (0, path_1.join)(__dirname, 'file-sink-checks'));
+    });
+    describe('synced FS is a web3n.files.WritableFS with versioned API', () => {
+        const fsSetup = syncedFsSetup();
+        (0, spec_module_1.loadSpecs)(fsSetup, (0, path_1.join)(__dirname, 'fs-checks', 'versioned'));
+    });
+    describe('synced FS is a web3n.files.WritableFS with sync API', () => {
+        const fsSetup = syncedFsSetup();
+        (0, spec_module_1.loadSpecs)(fsSetup, (0, path_1.join)(__dirname, 'fs-checks', 'sync-on-one-dev'));
+    });
+    describe('local to synced FS linking', () => {
+        const fsSetup = {};
+        (0, jasmine_utils_1.beforeAllWithTimeoutLog)(async () => {
+            if (!s.isUp) {
+                return;
+            }
+            fsSetup.isUp = true;
+            const domain = allowedAppFS[0];
+            fsSetup.localTestFS = await w3n.storage.getAppLocalFS(domain);
+            fsSetup.syncedTestFS = await w3n.storage.getAppSyncedFS(domain);
+        });
+        (0, jasmine_utils_1.afterEachCond)(async () => {
+            if (!s.isUp) {
+                return;
+            }
+            await (0, test_utils_1.clearFS)(fsSetup.localTestFS);
+            await (0, test_utils_1.clearFS)(fsSetup.syncedTestFS);
+        });
+        (0, spec_module_1.loadSpecs)(fsSetup, (0, path_1.join)(__dirname, 'fs-checks', 'local-to-synced-linking'));
+    });
+});
+describe(`3NStorage`, () => {
+    describe('with two devices', () => {
+        const baseSetup = (0, setups_1.setupWithUsers)();
+        const testFolder = `multi-dev-testing`;
+        const { fsSetup, setupDevsAndFSs } = (0, test_utils_1.makeSetupWithTwoDevsFSs)(testFolder);
+        (0, jasmine_utils_1.beforeAllWithTimeoutLog)(async () => {
+            await setupDevsAndFSs(baseSetup);
+        }, 20000);
+        (0, jasmine_utils_1.afterEachCond)(async () => {
+            if (!baseSetup.isUp) {
+                return;
+            }
+            await fsSetup.resetFS();
+        });
+        (0, spec_module_1.loadSpecs)(fsSetup, (0, path_1.join)(__dirname, 'fs-checks', 'sync-with-two-devs'));
+        (0, spec_module_1.loadSpecs)(fsSetup, (0, path_1.join)(__dirname, 'fs-checks', 'with-core-restarts'));
+    });
+});

package/build/tests/computer.3nweb.core/id-manager.d.ts

@@ -0,0 +1 @@
+export {};

package/build/tests/computer.3nweb.core/id-manager.js

@@ -0,0 +1,78 @@
+"use strict";
+/*
+ Copyright 2022, 2025 3NSoft Inc.
+ 
+ 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.
+ 
+ You should have received a copy of the GNU General Public License along with
+ this program. If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+const key_storage_1 = require("../../core/id-manager/key-storage");
+const random_node_1 = require("../../lib-common/random-node");
+const jasmine_utils_1 = require("../libs-for-tests/jasmine-utils");
+const json_equal_1 = require("../libs-for-tests/json-equal");
+const setups_1 = require("../libs-for-tests/setups");
+const test_utils_1 = require("./test-utils");
+async function failOnErrLog(err) {
+    fail(err);
+}
+async function failOnWarning(msg) {
+    fail(msg);
+}
+describe('Key storage of IdManager', () => {
+    const baseSetup = (0, setups_1.setupWithUsers)();
+    const testFolder = `id-manager-test`;
+    const { fsSetup: setup, setupDevsAndFSs } = (0, test_utils_1.makeSetupWithTwoDevsFSs)(testFolder);
+    (0, jasmine_utils_1.beforeAllWithTimeoutLog)(async () => {
+        await setupDevsAndFSs(baseSetup);
+    }, 20000);
+    (0, jasmine_utils_1.afterEachCond)(async () => {
+        if (!setup.isUp) {
+            return;
+        }
+        await setup.resetFS();
+    });
+    (0, jasmine_utils_1.itCond)(`initializes with and without storage`, async () => {
+        const { dev2, dev1FS, dev2FS } = setup;
+        await dev2.stop();
+        const loginKeys = {
+            address: await (0, random_node_1.stringOfB64Chars)(50),
+            keys: [{
+                    alg: await (0, random_node_1.stringOfB64Chars)(5),
+                    k: await (0, random_node_1.stringOfB64Chars)(48),
+                    kid: await (0, random_node_1.stringOfB64Chars)(15),
+                    use: await (0, random_node_1.stringOfB64Chars)(6)
+                }]
+        };
+        const { store: storeOnDev1, setupManagerStorage } = key_storage_1.IdKeysStorage.makeWithoutStorage(failOnErrLog, failOnWarning);
+        await storeOnDev1.getSavedKey().then(() => fail(`Non-initialized storage should fail`), () => { });
+        const fsOnDev1 = dev1FS();
+        expect((await fsOnDev1.listFolder('')).length)
+            .withContext(`there are no files before setup`).toBe(0);
+        await setupManagerStorage(fsOnDev1, loginKeys);
+        expect((await fsOnDev1.listFolder('')).length)
+            .withContext(`setup write some file`).toBeGreaterThan(0);
+        expect((0, json_equal_1.deepEqual)(await storeOnDev1.getSavedKey(), loginKeys.keys[0]))
+            .withContext(`keys should be available after setup`).toBeTrue();
+        await dev2.start();
+        const fsOnDev2 = dev2FS();
+        expect((await fsOnDev2.listFolder('')).length)
+            .withContext(`dev2 should've missed all changes on dev1`).toBe(0);
+        expect((await fsOnDev2.v.sync.status('')).state)
+            .withContext(`dev2 should've missed all changes on dev1`).toBe('behind');
+        const storeOnDev2 = key_storage_1.IdKeysStorage.makeWithStorage(fsOnDev2, failOnErrLog, failOnWarning);
+        expect((0, json_equal_1.deepEqual)(await storeOnDev2.getSavedKey(), loginKeys.keys[0]))
+            .withContext(`on dev2 have key that was saved on dev1`).toBeTrue();
+        expect((await fsOnDev2.listFolder('')).length)
+            .withContext(`getting saved key updated state of fs`).toBeGreaterThan(0);
+    }, undefined, setup);
+});

package/build/tests/computer.3nweb.core/inbox/msg-indexing.d.ts

@@ -0,0 +1 @@
+export {};

package/build/tests/computer.3nweb.core/inbox/msg-indexing.js

@@ -0,0 +1,145 @@
+"use strict";
+/*
+ Copyright 2022 3NSoft Inc.
+ 
+ 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.
+ 
+ You should have received a copy of the GNU General Public License along with
+ this program. If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+const msg_indexing_1 = require("../../../core/asmail/inbox/msg-indexing");
+// import { MsgKeyInfo } from "../core/asmail/keyring";
+const jasmine_utils_1 = require("../../libs-for-tests/jasmine-utils");
+const setups_1 = require("../../libs-for-tests/setups");
+const test_utils_1 = require("../test-utils");
+const buffer_utils_1 = require("../../../lib-common/buffer-utils");
+const bytes_equal_1 = require("../../libs-for-tests/bytes-equal");
+const sleep_1 = require("../../../lib-common/processes/sleep");
+const msgs = [
+    {
+        m: {
+            msgType: 'mail',
+            msgId: 'F-vo1A4zInEBGq994-e3KvrE9a8QXLcr',
+            deliveryTS: 1664923830399
+        },
+        k: {
+            correspondent: 'johnmorrison@bank.com',
+            keyStatus: 'published_intro',
+            key: buffer_utils_1.base64.open('0Uz7wGW4P7hdik7fuStC+avi7iXk7AZ5B1KxJCxIOQk='),
+            msgKeyPackLen: 72
+        }
+    },
+    {
+        m: {
+            msgType: 'mail',
+            msgId: 'JYXfEEcg3-iX7UDjG3BU0Jha9DYX_Jt-',
+            deliveryTS: 1664923830658
+        },
+        k: {
+            correspondent: 'johnmorrison@bank.com',
+            keyStatus: 'published_intro',
+            key: buffer_utils_1.base64.open('gjArW3Mr3ACnoFds/wKFZJm+pp9De1TlNhWIkpyd4Ow='),
+            msgKeyPackLen: 72
+        }
+    },
+    {
+        m: {
+            msgType: 'mail',
+            msgId: 'BQ2HO6hs4-Kov1M4wxL8oeTw_UFlvI3G',
+            deliveryTS: 1664923831175
+        },
+        k: {
+            correspondent: 'johnmorrison@bank.com',
+            keyStatus: 'published_intro',
+            key: buffer_utils_1.base64.open('lGr0hEGHMDrWa+QMEfmcsu/VPZbalN3gF+8LRi8Ai54='),
+            msgKeyPackLen: 72
+        }
+    },
+    {
+        m: {
+            msgType: 'mail',
+            msgId: 'g5TWqqY11W32xv_ivoqGRsQmnEG1f3j0',
+            deliveryTS: 1664923832168
+        },
+        k: {
+            correspondent: 'johnmorrison@bank.com',
+            keyStatus: 'published_intro',
+            key: buffer_utils_1.base64.open('8O/Ts2kZ37Y0yaSqGiRscYxPRQJu6cvfNXTgHKSNtyw='),
+            msgKeyPackLen: 72
+        }
+    },
+    {
+        m: {
+            msgId: 'some message id',
+            deliveryTS: 1664923760381,
+            msgType: 'mail'
+        },
+        k: {
+            correspondent: 'bob@some.domain',
+            keyStatus: 'introductory',
+            msgKeyPackLen: 50,
+            key: buffer_utils_1.base64.open('sdafkjkljasfdsafjksadfkljasdf')
+        }
+    }
+];
+xdescribe(`Inbox MsgIndex`, () => {
+    const baseSetup = (0, setups_1.setupWithUsers)();
+    const testFolder = `inbox-indexing-test`;
+    let dev1Index;
+    const { fsSetup: setup, setupDevsAndFSs } = (0, test_utils_1.makeSetupWithTwoDevsFSs)(testFolder);
+    (0, jasmine_utils_1.beforeAllWithTimeoutLog)(async () => {
+        await setupDevsAndFSs(baseSetup);
+    }, 20000);
+    beforeEach(async () => {
+        dev1Index = await msg_indexing_1.MsgIndex.make(setup.dev1FS());
+    });
+    (0, jasmine_utils_1.afterEachCond)(async () => {
+        if (!setup.isUp) {
+            return;
+        }
+        dev1Index.stopSyncing();
+        await setup.resetFS();
+    });
+    (0, jasmine_utils_1.itCond)(`is a container for message info`, async () => {
+        const m0 = msgs[0];
+        const m1 = msgs[1];
+        let lst = await dev1Index.listMsgs(undefined);
+        expect(Array.isArray(lst)).toBeTrue();
+        expect(lst.length).toBe(0);
+        await dev1Index.add(m0.m, m0.k);
+        await dev1Index.add(m1.m, m1.k);
+        const tsOfLast = m1.m.deliveryTS;
+        lst = await dev1Index.listMsgs(undefined);
+        expect(lst.length).toBe(2);
+        lst = await dev1Index.listMsgs(tsOfLast);
+        expect(lst.length).toBe(0);
+        await dev1Index.remove(m0.m.msgId);
+        lst = await dev1Index.listMsgs(undefined);
+        expect(lst.length).toBe(1);
+        const keyInfo = await dev1Index.getKeyFor(m1.m.msgId, m1.m.deliveryTS);
+        expect((0, bytes_equal_1.bytesEqual)(keyInfo.msgKey, m1.k.key))
+            .toBeTrue();
+    }, undefined, setup);
+    (0, jasmine_utils_1.itCond)(`work with race conditions on different devices`, async () => {
+        for (const m of msgs.slice(0, 2)) {
+            await dev1Index.add(m.m, m.k);
+        }
+        // sleep to allow time for propagation to dev2
+        await (0, sleep_1.sleep)(100);
+        const dev2Index = await msg_indexing_1.MsgIndex.make(setup.dev2FS());
+        let lst = await dev2Index.listMsgs(undefined);
+        expect(lst.length)
+            .withContext(``)
+            .toBe(2);
+        dev2Index.stopSyncing();
+    });
+});

package/build/tests/computer.3nweb.core/keyrings.d.ts

@@ -0,0 +1 @@
+export {};

package/build/tests/computer.3nweb.core/keyrings.js

@@ -0,0 +1,64 @@
+"use strict";
+/*
+ Copyright 2025 3NSoft Inc.
+ 
+ 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.
+ 
+ You should have received a copy of the GNU General Public License along with
+ this program. If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+const jasmine_utils_1 = require("../libs-for-tests/jasmine-utils");
+const setups_1 = require("../libs-for-tests/setups");
+const test_utils_1 = require("./test-utils");
+const address = `address Bob Perkins @company.inc`;
+const introPKeyFromServer = {
+    use: 'asmail-pub-key',
+    alg: 'NaCl-box-CXSP',
+    kid: 'EKnB33DQsmpq2RiL',
+    k: 'hDeWvNYajaAFUijY23SlXFKhIFOuMJLWtIBJYtiToEQ='
+};
+describe('ASMail keyring', () => {
+    const baseSetup = (0, setups_1.setupWithUsers)();
+    const testFolder = `keyring-test`;
+    let keyring;
+    const { fsSetup: setup, setupDevsAndFSs } = (0, test_utils_1.makeSetupWithTwoDevsFSs)(testFolder);
+    (0, jasmine_utils_1.beforeAllWithTimeoutLog)(async () => {
+        await setupDevsAndFSs(baseSetup);
+    }, 20000);
+    beforeEach(async () => {
+        const fs = setup.dev1FS();
+        // keyring = await makeAndKeyRing(cryptor, fs, {
+        // 	find: kid => { throw Error(`publishedKeys.find() mock`); },
+        // 	update: async () => { throw Error(`publishedKeys.update() mock`); }
+        // });
+    });
+    (0, jasmine_utils_1.afterEachCond)(async () => {
+        if (!setup.isUp) {
+            return;
+        }
+        await setup.resetFS();
+    });
+    (0, jasmine_utils_1.itCond)(`.generateKeysToSend()`, async () => {
+        // 		const {
+        // 			currentPair, encryptor, msgCount
+        // 		} = await keyring.generateKeysToSend(address, introPKeyFromServer);
+        // // DEBUG
+        // // console.log(`currentPair`, currentPair, `
+        // // msgCount`, msgCount);
+        // 	const {
+        // 		currentPair: cp, msgCount: count
+        // 	} = await keyring.generateKeysToSend(address);
+        // // DEBUG
+        // // console.log(`currentPair`, cp, `
+        // // msgCount`, count);
+    }, undefined, setup);
+});

package/build/tests/computer.3nweb.core/test-utils.d.ts

@@ -0,0 +1,21 @@
+import { MultiUserSetup } from "../libs-for-tests/setups";
+import { SpecIt as GenericSpecIt } from "../libs-for-tests/spec-module";
+type WritableFS = web3n.files.WritableFS;
+export interface SetupWithTwoDevsFSs {
+    isUp: boolean;
+    dev1FS: () => WritableFS;
+    dev1LocalFS: () => WritableFS;
+    dev2: {
+        stop(): Promise<void>;
+        start(): Promise<void>;
+    };
+    dev2FS: () => WritableFS;
+    dev2LocalFS: () => WritableFS;
+    resetFS: () => Promise<void>;
+}
+export type SpecItWithTwoDevsFSs = GenericSpecIt<SetupWithTwoDevsFSs>;
+export declare function makeSetupWithTwoDevsFSs(testFolder: string): {
+    fsSetup: SetupWithTwoDevsFSs;
+    setupDevsAndFSs: (baseSetup: MultiUserSetup) => Promise<void>;
+};
+export {};

package/build/tests/computer.3nweb.core/test-utils.js

@@ -0,0 +1,92 @@
+"use strict";
+/*
+ Copyright 2022, 2025 3NSoft Inc.
+ 
+ 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.
+ 
+ You should have received a copy of the GNU General Public License along with
+ this program. If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeSetupWithTwoDevsFSs = makeSetupWithTwoDevsFSs;
+function makeSetupWithTwoDevsFSs(testFolder) {
+    const fsSetup = {};
+    const setupDevsAndFSs = async (baseSetup) => {
+        if (!baseSetup.isUp) {
+            return;
+        }
+        const w3n1 = baseSetup.testAppCapsByUserIndex(0);
+        const dev2 = await baseSetup.sndDevByUserIndex(0);
+        const dev1AppFS = await w3n1.storage.getAppSyncedFS();
+        const dev2AppFS = () => dev2.w3n.storage.getAppSyncedFS();
+        const dev1LocalAppFS = await w3n1.storage.getAppLocalFS();
+        const dev2LocalAppFS = () => dev2.w3n.storage.getAppLocalFS();
+        let dev1FS;
+        let dev2FS;
+        fsSetup.dev1FS = () => dev1FS;
+        fsSetup.dev2FS = () => dev2FS;
+        let dev1LocalFS;
+        let dev2LocalFS;
+        fsSetup.dev1LocalFS = () => dev1LocalFS;
+        fsSetup.dev2LocalFS = () => dev2LocalFS;
+        fsSetup.dev2 = {
+            start: async () => {
+                await dev2.start();
+                dev2FS = await (await dev2AppFS()).writableSubRoot(testFolder);
+            },
+            stop: async () => {
+                dev2FS = undefined;
+                await dev2.stop();
+            }
+        };
+        fsSetup.resetFS = async () => {
+            await clearFS(dev1AppFS);
+            dev1FS = await dev1AppFS.writableSubRoot(testFolder, { create: true, exclusive: true });
+            await dev1AppFS.v.sync.upload(testFolder);
+            await dev1AppFS.v.sync.upload('');
+            const d2AppFS = await dev2AppFS();
+            const status = await d2AppFS.v.sync.status('');
+            if (status.state === 'behind') {
+                await d2AppFS.v.sync.adoptRemote('');
+            }
+            else if (status.state === 'conflicting') {
+                throw new Error(`Test file system on a second device has inconvenient conflicting sync state`);
+            }
+            dev2FS = await d2AppFS.writableSubRoot(testFolder, { create: false });
+            await clearFS(dev1LocalAppFS);
+            dev1LocalFS = await dev1LocalAppFS.writableSubRoot(testFolder, { create: true, exclusive: true });
+            const d2LocalAppFS = await dev2LocalAppFS();
+            dev2LocalFS = await d2LocalAppFS.writableSubRoot(testFolder, { create: true, exclusive: true });
+        };
+        await fsSetup.resetFS();
+        fsSetup.isUp = true;
+    };
+    return { fsSetup, setupDevsAndFSs };
+}
+async function clearFS(fs) {
+    let items = await fs.listFolder('');
+    let delTasks = [];
+    for (let f of items) {
+        if (f.isFile) {
+            delTasks.push(fs.deleteFile(f.name));
+        }
+        else if (f.isFolder) {
+            delTasks.push(fs.deleteFolder(f.name, true));
+        }
+        else if (f.isLink) {
+            delTasks.push(fs.deleteLink(f.name));
+        }
+        else {
+            throw new Error(`File system item is neither file, nor folder, nor link`);
+        }
+    }
+    await Promise.all(delTasks);
+}

package/build/tests/jasmine.d.ts

@@ -0,0 +1 @@
+export {};