core-3nweb-client-lib 0.34.2 → 0.35.1

package/build/core/{asmail/keyring → keyring}/index.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2018, 2022 3NSoft Inc.
+ Copyright (C) 2015 - 2018, 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
@@ -16,29 +16,26 @@
  this program. If not, see <http://www.gnu.org/licenses/>.
 */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KEY_USE = void 0;
-exports.makeAndKeyRing = makeAndKeyRing;
+exports.Keyrings = exports.KEY_USE = void 0;
 const correspondent_keys_1 = require("./correspondent-keys");
 const id_to_email_map_1 = require("./id-to-email-map");
 const common_1 = require("./common");
-const async_cryptor_wrap_1 = require("../../../lib-common/async-cryptor-wrap");
+const async_cryptor_wrap_1 = require("../../lib-common/async-cryptor-wrap");
 const xsp_files_1 = require("xsp-files");
-const random = require("../../../lib-common/random-node");
-const buffer_utils_1 = require("../../../lib-common/buffer-utils");
-const canonical_address_1 = require("../../../lib-common/canonical-address");
-const common_2 = require("../delivery/common");
+const random = require("../../lib-common/random-node");
+const buffer_utils_1 = require("../../lib-common/buffer-utils");
+const canonical_address_1 = require("../../lib-common/canonical-address");
+const common_2 = require("../asmail/delivery/common");
 const keyring_storage_1 = require("./keyring-storage");
-const assert_1 = require("../../../lib-common/assert");
-const cryptor_work_labels_1 = require("../../../lib-client/cryptor-work-labels");
+const cryptor_work_labels_1 = require("../../lib-client/cryptor/cryptor-work-labels");
+const published_intro_key_1 = require("./published-intro-key");
 var common_3 = require("./common");
 Object.defineProperty(exports, "KEY_USE", { enumerable: true, get: function () { return common_3.KEY_USE; } });
-function makeAndKeyRing(cryptor, fs, publishedKeys) {
-    return KRing.makeAndStart(cryptor, fs, publishedKeys);
-}
-class KRing {
-    constructor(cryptor, publishedKeys) {
+const FILE_FOR_INTRO_KEY_ON_SERVER = 'introductory-keys/published-on-server.json';
+// XXX Keyring is just a storage and crypto functionality around keys
+class Keyrings {
+    constructor(cryptor) {
         this.cryptor = cryptor;
-        this.publishedKeys = publishedKeys;
         /**
          * This is a map from correspondents' canonical addresses to key objects.
          */
@@ -46,39 +43,11 @@ class KRing {
         this.pairIdToEmailMap = new id_to_email_map_1.IdToEmailMap();
         this.workLabel = cryptor_work_labels_1.cryptoWorkLabels.makeRandom('asmail');
         this.storage = undefined;
+        this.publishedKeys = undefined;
         this.asKeyPairsStorage = {
             pairIdToEmailMap: this.pairIdToEmailMap,
             saveChanges: this.saveChanges.bind(this)
         };
-        this.needIntroKeyFor = address => {
-            address = (0, canonical_address_1.toCanonicalAddress)(address);
-            return !this.corrKeys.has(address);
-        };
-        this.generateKeysToSend = async (address, introPKeyFromServer) => {
-            address = (0, canonical_address_1.toCanonicalAddress)(address);
-            let ck = this.corrKeys.get(address);
-            if (!ck) {
-                if (!introPKeyFromServer) {
-                    throw new Error(`There are no known keys for given address ${address} and a key from a mail server is not given either.`);
-                }
-                ck = this.addCorrespondent(address);
-            }
-            const { msgMasterKey, currentPair, msgCount } = await ck.getSendingPair(introPKeyFromServer);
-            // prepare message encryptor
-            const nextNonce = await random.bytes(xsp_files_1.NONCE_LENGTH);
-            const encryptor = (0, async_cryptor_wrap_1.makeEncryptor)(this.cryptor, this.workLabel, msgMasterKey, nextNonce);
-            msgMasterKey.fill(0);
-            return { encryptor, currentPair, msgCount };
-        };
-        this.nextCrypto = async (address) => {
-            address = (0, canonical_address_1.toCanonicalAddress)(address);
-            let ck = this.corrKeys.get(address);
-            if (!ck) {
-                throw new Error(`No correspondent keys found for ${address}`);
-            }
-            const suggestPair = await ck.suggestPair();
-            return suggestPair;
-        };
         Object.seal(this);
     }
     addCorrespondent(address, serialForm) {
@@ -94,8 +63,8 @@ class KRing {
         }
         return ck;
     }
-    async init(fs) {
-        (0, assert_1.assert)(!this.storage);
+    async init(fs, getSigner, pkeyOnServer) {
+        this.publishedKeys = await published_intro_key_1.PublishedIntroKey.makeAndInit(await fs.writableFile(FILE_FOR_INTRO_KEY_ON_SERVER), getSigner, pkeyOnServer);
         this.storage = (0, keyring_storage_1.makeKeyringStorage)(fs);
         await this.storage.start();
         const serialForm = await this.storage.load();
@@ -112,15 +81,13 @@ class KRing {
             this.saveChanges();
         }
     }
-    static async makeAndStart(cryptor, fs, publishedKeys) {
-        const kr = new KRing(cryptor, publishedKeys);
-        await kr.init(fs);
+    forASMail() {
         return {
-            close: kr.close.bind(kr),
-            decrypt: kr.decrypt.bind(kr),
-            generateKeysToSend: kr.generateKeysToSend.bind(kr),
-            needIntroKeyFor: kr.needIntroKeyFor.bind(kr),
-            nextCrypto: kr.nextCrypto.bind(kr)
+            close: this.close.bind(this),
+            decrypt: this.decrypt.bind(this),
+            generateKeysToSend: this.generateKeysToSend.bind(this),
+            needIntroKeyFor: this.needIntroKeyFor.bind(this),
+            nextCrypto: this.nextCrypto.bind(this),
         };
     }
     saveChanges() {
@@ -134,6 +101,36 @@ class KRing {
         // trigger saving utility
         this.storage.save(JSON.stringify(dataToSave));
     }
+    needIntroKeyFor(address) {
+        address = (0, canonical_address_1.toCanonicalAddress)(address);
+        return !this.corrKeys.has(address);
+    }
+    ;
+    async generateKeysToSend(address, introPKeyFromServer) {
+        address = (0, canonical_address_1.toCanonicalAddress)(address);
+        let ck = this.corrKeys.get(address);
+        if (!ck) {
+            if (!introPKeyFromServer) {
+                throw new Error(`There are no known keys for given address ${address} and a key from a mail server is not given either.`);
+            }
+            ck = this.addCorrespondent(address);
+        }
+        const { msgMasterKey, currentPair, msgCount } = await ck.getSendingPair(introPKeyFromServer);
+        // prepare message encryptor
+        const nextNonce = await random.bytes(xsp_files_1.NONCE_LENGTH);
+        const encryptor = (0, async_cryptor_wrap_1.makeEncryptor)(this.cryptor, this.workLabel, msgMasterKey, nextNonce);
+        msgMasterKey.fill(0);
+        return { encryptor, currentPair, msgCount };
+    }
+    async nextCrypto(address) {
+        address = (0, canonical_address_1.toCanonicalAddress)(address);
+        let ck = this.corrKeys.get(address);
+        if (!ck) {
+            throw new Error(`No correspondent keys found for ${address}`);
+        }
+        const suggestPair = await ck.suggestPair();
+        return suggestPair;
+    }
     async decryptMsgKeyWithIntroPair(recipientKid, senderPKey, getMainObjHeader) {
         const recipKey = this.publishedKeys.find(recipientKid);
         if (!recipKey) {
@@ -315,12 +312,20 @@ class KRing {
         return { decrInfo, openedMsg };
     }
     ;
-    close() {
-        return this.storage.close();
+    async close() {
+        await this.publishedKeys.close();
+        await this.storage.close();
+    }
+    makeKeyringsCAP() {
+        const w = {
+            introKeyOnASMailServer: this.publishedKeys.makeIntroKeyCAP(),
+        };
+        return Object.freeze(w);
     }
 }
-Object.freeze(KRing.prototype);
-Object.freeze(KRing);
+exports.Keyrings = Keyrings;
+Object.freeze(Keyrings.prototype);
+Object.freeze(Keyrings);
 function msgKeyPackLenForPair(p) {
     return (0, common_1.msgKeyPackSizeFor)(p.recipientKey.skey.alg);
 }

package/build/core/{asmail/keyring → keyring}/keyring-storage.js

@@ -17,7 +17,7 @@
 */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeKeyringStorage = makeKeyringStorage;
-const synced_1 = require("../../../lib-common/processes/synced");
+const synced_1 = require("../../lib-common/processes/synced");
 const KEYRING_FNAME = 'keyring.json';
 function makeKeyringStorage(fs) {
     const proc = new synced_1.SingleProc();

package/build/core/keyring/keyrings-cap-ipc.d.ts

@@ -0,0 +1,5 @@
+import { Caller, ExposedObj } from "../../ipc-via-protobuf/connector";
+type Keyrings = web3n.keys.Keyrings;
+export declare function exposeKeyringsCAP(cap: Keyrings): ExposedObj<Keyrings>;
+export declare function makeKeyringsCaller(caller: Caller, objPath: string[]): Keyrings;
+export {};

package/build/core/keyring/keyrings-cap-ipc.js

@@ -0,0 +1,50 @@
+"use strict";
+/*
+ Copyright (C) 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.exposeKeyringsCAP = exposeKeyringsCAP;
+exports.makeKeyringsCaller = makeKeyringsCaller;
+const caller_side_wrap_1 = require("../../core-ipc/json-ipc-wrapping/caller-side-wrap");
+const service_side_wrap_1 = require("../../core-ipc/json-ipc-wrapping/service-side-wrap");
+function exposeKeyringsCAP(cap) {
+    return {
+        introKeyOnASMailServer: exposeIntroKey(cap.introKeyOnASMailServer),
+    };
+}
+function exposeIntroKey(cap) {
+    return {
+        getCurrent: (0, service_side_wrap_1.wrapReqReplySrvMethod)(cap, 'getCurrent'),
+        makeAndPublishNew: (0, service_side_wrap_1.wrapReqReplySrvMethod)(cap, 'makeAndPublishNew'),
+        remove: (0, service_side_wrap_1.wrapReqReplySrvMethod)(cap, 'remove'),
+    };
+}
+function callIntroKeyOnASMailServer(caller, objPath, method) {
+    return (0, caller_side_wrap_1.makeReqRepObjCaller)(caller, objPath, method);
+}
+function makeIntroKeyCaller(caller, objPath) {
+    return {
+        getCurrent: callIntroKeyOnASMailServer(caller, objPath, 'getCurrent'),
+        makeAndPublishNew: callIntroKeyOnASMailServer(caller, objPath, 'makeAndPublishNew'),
+        remove: callIntroKeyOnASMailServer(caller, objPath, 'remove'),
+    };
+}
+function makeKeyringsCaller(caller, objPath) {
+    return {
+        introKeyOnASMailServer: makeIntroKeyCaller(caller, objPath.concat('introKeyOnASMailServer')),
+    };
+}
+Object.freeze(exports);

package/build/core/keyring/published-intro-key.d.ts

@@ -0,0 +1,43 @@
+import { ParamOnServer } from '../../lib-client/asmail/service-config';
+import { GetSigner } from '../id-manager';
+import { JWKeyPair, MsgKeyRole } from './common';
+type WritableFile = web3n.files.WritableFile;
+type IntroKeyCAP = web3n.keys.Keyrings['introKeyOnASMailServer'];
+export declare class PublishedIntroKey {
+    private readonly getSigner;
+    private pkeyOnServer;
+    private published;
+    private readonly fileProc;
+    private periodicExpiryCheck;
+    private constructor();
+    static makeAndInit(file: WritableFile, getSigner: GetSigner, pkeyOnServer: ParamOnServer<'init-pub-key'>): Promise<PublishedIntroKey>;
+    private startExpiryCheckProcess;
+    close(): Promise<void>;
+    private onFileEvent;
+    private setFromJSON;
+    private toFileJSON;
+    private absorbRemoteChanges;
+    private makeNewIntroKey;
+    private update;
+    private retireCurrent;
+    /**
+     * This looks for a published key with a given key id. If it is found, an
+     * object is returned with following fields:
+     * - pair is JWK key pair;
+     * - role of a found key pair;
+     * - replacedAt field is present for a previously published key pair,
+     * telling, in milliseconds, when this key was superseded a newer one.
+     * Undefined is returned, when a key is not found.
+     * @param kid
+     * @return if key is found, object with following fields is returned:
+     */
+    find(kid: string): {
+        role: MsgKeyRole;
+        pair: JWKeyPair;
+        replacedAt?: number;
+    } | undefined;
+    makeIntroKeyCAP(): IntroKeyCAP;
+    private getCurrent;
+    private removeCurrent;
+}
+export {};

package/build/core/keyring/published-intro-key.js

@@ -0,0 +1,197 @@
+"use strict";
+/*
+ Copyright (C) 2015 - 2018, 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.PublishedIntroKey = void 0;
+const file_based_json_1 = require("../../lib-client/xsp-fs/util/file-based-json");
+const jwkeys_1 = require("../../lib-common/jwkeys");
+const common_1 = require("./common");
+const INTRO_KEY_VALIDITY = 31 * 24 * 60 * 60;
+const UPDATE_BEFORE_EXPIRY = 7 * 24 * 60 * 60;
+class PublishedIntroKey {
+    constructor(getSigner, pkeyOnServer) {
+        this.getSigner = getSigner;
+        this.pkeyOnServer = pkeyOnServer;
+        this.published = {
+            previous: []
+        };
+        this.periodicExpiryCheck = undefined;
+        this.fileProc = new file_based_json_1.JsonFileProc(this.onFileEvent.bind(this));
+        Object.seal(this);
+    }
+    static async makeAndInit(file, getSigner, pkeyOnServer) {
+        const pk = new PublishedIntroKey(getSigner, pkeyOnServer);
+        if (file.isNew) {
+            await pk.fileProc.start(file, () => pk.toFileJSON());
+            await pk.update();
+        }
+        else {
+            await pk.fileProc.start(file, undefined);
+            pk.setFromJSON((await pk.fileProc.get()).json);
+            await pk.absorbRemoteChanges();
+            pk.startExpiryCheckProcess(true);
+        }
+        return pk;
+    }
+    startExpiryCheckProcess(calledInInit = false) {
+        if (!calledInInit && !this.periodicExpiryCheck) {
+            return;
+        }
+        if (this.published.current) {
+            const { pkeyCert } = this.published.current.certs;
+            const expiryInSeconds = (0, jwkeys_1.getKeyCert)(pkeyCert).expiresAt;
+            const now = Math.floor(Date.now() / 1000);
+            if (expiryInSeconds < (now + UPDATE_BEFORE_EXPIRY)) {
+                this.update();
+            }
+        }
+        if (calledInInit) {
+            this.periodicExpiryCheck = setTimeout(() => this.startExpiryCheckProcess(), UPDATE_BEFORE_EXPIRY * 1000 / 20).unref();
+        }
+    }
+    async close() {
+        if (this.periodicExpiryCheck) {
+            clearTimeout(this.periodicExpiryCheck);
+            this.periodicExpiryCheck = undefined;
+        }
+        await this.fileProc.close();
+    }
+    async onFileEvent(ev) {
+        if (ev.src === 'local') {
+            return;
+        }
+        switch (ev.type) {
+            case 'file-change':
+                await this.fileProc.order.startOrChain(() => this.absorbRemoteChanges());
+                break;
+            case 'removed':
+                throw new Error(`Unexpected removal of file with parameter "anon-sender/invites"`);
+            default:
+                return;
+        }
+    }
+    setFromJSON(json) {
+        if (!Array.isArray(json.previous)) { // migration part
+            json.previous = (json.previous ? [json.previous] : []);
+        }
+        this.published = json;
+    }
+    toFileJSON() {
+        return this.published;
+    }
+    // private toServerParam(): PKeyCertChain|undefined {
+    // 	return this.published.current?.certs;
+    // }
+    async absorbRemoteChanges() {
+        // XXX
+        //  - check for changes: what is needed here from fileProc, and what is
+        //    generic in absorbing remote changes to refactor it into JsonFileProc
+        //  - absorb and sync, if needed: what can be in JsonFileProc
+        // Code from pre-v.sync:
+        // const { json } = await this.fileProc.get();
+        // this.setFromJSON(json);
+    }
+    async makeNewIntroKey() {
+        const signer = await this.getSigner();
+        const pair = await (0, common_1.generateKeyPair)();
+        const certs = {
+            pkeyCert: signer.certifyPublicKey(pair.pkey, INTRO_KEY_VALIDITY),
+            userCert: signer.userCert,
+            provCert: signer.providerCert
+        };
+        pair.createdAt = Date.now();
+        return { pair, certs };
+    }
+    update() {
+        return this.fileProc.order.startOrChain(async () => {
+            const { certs, pair: keyPair } = await this.makeNewIntroKey();
+            await this.pkeyOnServer.setOnServer(certs);
+            this.retireCurrent(keyPair.createdAt);
+            this.published.current = { keyPair, certs };
+            await this.fileProc.save(this.toFileJSON(), false);
+            return certs;
+        });
+    }
+    ;
+    retireCurrent(retiredAt) {
+        if (!this.published.current) {
+            return;
+        }
+        const current = this.published.current;
+        current.keyPair.retiredAt = retiredAt;
+        this.published.previous.push(current.keyPair);
+        this.published.current = undefined;
+    }
+    /**
+     * This looks for a published key with a given key id. If it is found, an
+     * object is returned with following fields:
+     * - pair is JWK key pair;
+     * - role of a found key pair;
+     * - replacedAt field is present for a previously published key pair,
+     * telling, in milliseconds, when this key was superseded a newer one.
+     * Undefined is returned, when a key is not found.
+     * @param kid
+     * @return if key is found, object with following fields is returned:
+     */
+    find(kid) {
+        // check current key
+        if (this.published.current
+            && (this.published.current.keyPair.skey.kid === kid)) {
+            return {
+                role: 'published_intro',
+                pair: this.published.current.keyPair
+            };
+        }
+        // check previous key
+        const pair = this.published.previous.find(({ skey }) => (skey.kid === kid));
+        if (pair) {
+            return {
+                role: 'prev_published_intro',
+                pair,
+                replacedAt: pair.retiredAt
+            };
+        }
+        // if nothing found, explicitly return undefined
+        return;
+    }
+    makeIntroKeyCAP() {
+        const w = {
+            getCurrent: this.getCurrent.bind(this),
+            makeAndPublishNew: this.update.bind(this),
+            remove: this.removeCurrent.bind(this)
+        };
+        return Object.freeze(w);
+    }
+    async getCurrent() {
+        var _a;
+        const certs = (_a = this.published.current) === null || _a === void 0 ? void 0 : _a.certs;
+        return (certs ? certs : null);
+    }
+    async removeCurrent() {
+        if (!this.published.current) {
+            return;
+        }
+        return this.fileProc.order.startOrChain(async () => {
+            await this.pkeyOnServer.setOnServer(null);
+            this.retireCurrent(Math.floor(Date.now() / 1000));
+        });
+    }
+}
+exports.PublishedIntroKey = PublishedIntroKey;
+Object.freeze(PublishedIntroKey.prototype);
+Object.freeze(PublishedIntroKey);
+Object.freeze(exports);

package/build/core/startup/sign-up.d.ts

@@ -1,9 +1,9 @@
 import { NetClient } from '../../lib-client/request-utils';
-import { JsonKey } from '../../lib-common/jwkeys';
 import * as keyDeriv from '../../lib-client/key-derivation';
 import type { GetUsersOnDisk } from '../app-files';
 import { Cryptor } from '../../lib-client/cryptor/cryptor';
 import { LogError } from '../../lib-client/logging/log-to-file';
+type JsonKey = web3n.keys.JsonKey;
 export interface ScryptGenParams {
     logN: number;
     r: number;

package/build/core/storage/common/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const CORE_APPS_PREFIX = "computer.3nweb.core";
+export declare const ASMAIL_APP_NAME = "computer.3nweb.core.asmail";
+export declare const KEYRINGS_APP_NAME = "computer.3nweb.core.keyrings";
+export declare const MAILERID_APP_NAME = "computer.3nweb.core.mailerid";

package/build/core/storage/common/constants.js

@@ -0,0 +1,24 @@
+"use strict";
+/*
+ Copyright (C) 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.MAILERID_APP_NAME = exports.KEYRINGS_APP_NAME = exports.ASMAIL_APP_NAME = exports.CORE_APPS_PREFIX = void 0;
+exports.CORE_APPS_PREFIX = 'computer.3nweb.core';
+exports.ASMAIL_APP_NAME = `${exports.CORE_APPS_PREFIX}.asmail`;
+exports.KEYRINGS_APP_NAME = `${exports.CORE_APPS_PREFIX}.keyrings`;
+exports.MAILERID_APP_NAME = `${exports.CORE_APPS_PREFIX}.mailerid`;
+Object.freeze(exports);

package/build/core/storage/common/obj-info-file.js

@@ -30,7 +30,7 @@ exports.addArchived = addArchived;
 exports.isEmptyVersions = isEmptyVersions;
 const fs = require("../../../lib-common/async-fs-node");
 const path_1 = require("path");
-const exceptions_1 = require("../../../lib-client/3nstorage/exceptions");
+const exceptions_1 = require("../../../lib-client/xsp-fs/exceptions");
 async function readJSONInfoFileIn(objFolder, fileName) {
     try {
         const infoJSONStr = await fs.readFile((0, path_1.join)(objFolder, fileName), { encoding: 'utf8' }).catch((exc) => {

package/build/core/storage/index.d.ts

@@ -1,6 +1,6 @@
 import { GetSigner } from '../id-manager';
 import { GenerateKey } from '../startup/sign-in';
-import { StorageGetter } from '../../lib-client/3nstorage/xsp-fs/common';
+import { StorageGetter } from '../../lib-client/xsp-fs/common';
 import { ServiceLocator } from '../../lib-client/service-locator';
 import { ScryptGenParams } from '../../lib-client/key-derivation';
 import { AsyncSBoxCryptor } from 'xsp-files';
@@ -40,6 +40,12 @@ export declare class Storages implements FactoryOfFSs {
     getSysFSs(type: StorageType): Promise<FSItem>;
     close(): Promise<void>;
     wrap(): FactoryOfFSs;
+    /**
+     * This is a migration used for developing/evolving core's apps.
+     * @param src is a path starting with core app folder name
+     * @param dst is a path starting with core app folder name
+     */
+    migrateCoreAppDataOnFirstRun(type: StorageType, src: string, dst: string): Promise<void>;
 }
 export interface FactoryOfFSs {
     makeSyncedFSForApp(appFolder: string): Promise<WritableFS>;

package/build/core/storage/index.js

@@ -18,7 +18,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PerAppStorage = exports.Storages = void 0;
 exports.reverseDomain = reverseDomain;
-const fs_1 = require("../../lib-client/3nstorage/xsp-fs/fs");
+const fs_1 = require("../../lib-client/xsp-fs/fs");
 const storage_1 = require("./synced/storage");
 const storage_2 = require("./local/storage");
 const file_1 = require("../../lib-common/exceptions/file");
@@ -29,6 +29,8 @@ const fs = require("../../lib-common/async-fs-node");
 const error_1 = require("../../lib-common/exceptions/error");
 const system_folders_1 = require("./system-folders");
 const apps_data_1 = require("./system-folders/apps-data");
+const constants_1 = require("./common/constants");
+const assert_1 = require("../../lib-common/assert");
 function makeBadAppNameExc(appName) {
     return {
         runtimeException: true,
@@ -65,7 +67,6 @@ function makeNotAllowedToOpenSysFSExc(storageType) {
         storageType
     };
 }
-const CORE_APPS_PREFIX = 'computer.3nweb.core';
 const KD_PARAMS_FILE_NAME = 'kd-params';
 const LOCAL_STORAGE_DIR = 'local';
 const SYNCED_STORAGE_DIR = 'synced';
@@ -179,6 +180,22 @@ class StorageAndFS {
         this.rootFS = undefined;
         this.storage = undefined;
     }
+    /**
+     * Moves src to dst if dst doesn't exist.
+     * @param src is a path starting with core app folder name
+     * @param dst is a path starting with core app folder name
+     */
+    async migrateCoreAppDataOnFirstRun(src, dst) {
+        (0, assert_1.assert)(src.startsWith(constants_1.CORE_APPS_PREFIX) && !src.includes('..') &&
+            dst.startsWith(constants_1.CORE_APPS_PREFIX) && !dst.includes('..'), `Invalid core app data migration paths`);
+        if (!(await this.rootFS.checkFolderPresence(src))
+            || !(await this.rootFS.checkFilePresence(src))
+            || (await this.rootFS.checkFolderPresence(dst))
+            || (await this.rootFS.checkFilePresence(dst))) {
+            return;
+        }
+        await this.rootFS.move(`${system_folders_1.sysFolders.appData}/${src}`, `${system_folders_1.sysFolders.appData}/${dst}`);
+    }
 }
 Object.freeze(StorageAndFS.prototype);
 Object.freeze(StorageAndFS);
@@ -356,6 +373,19 @@ class Storages {
             makeSyncedFSForApp: this.makeSyncedFSForApp.bind(this)
         };
     }
+    /**
+     * This is a migration used for developing/evolving core's apps.
+     * @param src is a path starting with core app folder name
+     * @param dst is a path starting with core app folder name
+     */
+    async migrateCoreAppDataOnFirstRun(type, src, dst) {
+        if (type === 'synced') {
+            await this.synced.migrateCoreAppDataOnFirstRun(src, dst);
+        }
+        else if (type === 'local') {
+            await this.local.migrateCoreAppDataOnFirstRun(src, dst);
+        }
+    }
 }
 exports.Storages = Storages;
 Object.freeze(Storages.prototype);
@@ -416,7 +446,7 @@ class PerAppStorage {
         if (typeof appFolder !== 'string') {
             throw makeBadAppNameExc(appFolder);
         }
-        if (appFolder.startsWith(CORE_APPS_PREFIX)) {
+        if (appFolder.startsWith(constants_1.CORE_APPS_PREFIX)) {
             throw makeNotAllowedToOpenAppFSExc(appFolder);
         }
         if (!this.policy.canOpenAppFS(appFolder, type)) {

package/build/core/storage/local/obj-files.d.ts

@@ -1,4 +1,4 @@
-import { LocalObjStatus, ObjId } from '../../../lib-client/3nstorage/xsp-fs/common';
+import { LocalObjStatus, ObjId } from '../../../lib-client/xsp-fs/common';
 import { ObjSource, Subscribe } from 'xsp-files';
 import { GC } from './obj-files-gc';
 import { ObjStatus } from './obj-status';

package/build/core/storage/local/obj-status.d.ts

@@ -1,4 +1,4 @@
-import { LocalObjStatus, ObjId } from '../../../lib-client/3nstorage/xsp-fs/common';
+import { LocalObjStatus, ObjId } from '../../../lib-client/xsp-fs/common';
 import { VersionsInfo } from '../common/obj-info-file';
 import { LogError } from '../../../lib-client/logging/log-to-file';
 export interface ObjStatusInfo {

package/build/core/storage/local/obj-status.js

@@ -18,7 +18,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ObjStatus = void 0;
 const path_1 = require("path");
-const exceptions_1 = require("../../../lib-client/3nstorage/exceptions");
+const exceptions_1 = require("../../../lib-client/xsp-fs/exceptions");
 const obj_info_file_1 = require("../common/obj-info-file");
 const json_saving_1 = require("../common/json-saving");
 const obj_info_file_2 = require("../common/obj-info-file");