@credo-ts/core 0.5.0-alpha.101

package/build/storage/migration/StorageUpdateService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageUpdateService.js","sourceRoot":"","sources":["../../../src/storage/migration/StorageUpdateService.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAIA,+CAAkD;AAElD,2CAAkD;AAClD,iDAAqH;AAErH,4EAAwE;AACxE,oFAAgF;AAChF,uCAAsF;AAG/E,IAAM,oBAAoB,4BAA1B,MAAM,oBAAoB;IAM/B,YACmC,MAAc,EAC/C,wBAAkD;QAElD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,wBAAwB,GAAG,wBAAwB,CAAA;IAC1D,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,YAA0B,EAAE,eAAiC;QACnF,MAAM,qBAAqB,GAAG,IAAA,4BAAkB,EAAC,MAAM,IAAI,CAAC,wBAAwB,CAAC,YAAY,CAAC,CAAC,CAAA;QAEnG,MAAM,gBAAgB,GAAG,IAAA,4BAAkB,EAAC,eAAe,aAAf,eAAe,cAAf,eAAe,GAAI,2CAAiC,CAAC,CAAA;QAEjG,MAAM,UAAU,GACd,IAAA,qCAA2B,EAAC,qBAAqB,EAAE,gBAAgB,CAAC;YACpE,IAAA,wCAA8B,EAAC,qBAAqB,EAAE,gBAAgB,CAAC,CAAA;QAEzE,OAAO,UAAU,CAAA;IACnB,CAAC;IAEM,KAAK,CAAC,wBAAwB,CAAC,YAA0B;QAC9D,MAAM,oBAAoB,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,YAAY,CAAC,CAAA;QAE7E,OAAO,oBAAoB,CAAC,cAAc,CAAA;IAC5C,CAAC;IAEM,KAAK,CAAC,wBAAwB,CAAC,YAA0B,EAAE,cAA6B;QAC7F,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4CAA4C,cAAc,EAAE,CAAC,CAAA;QAC/E,MAAM,oBAAoB,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CACvE,YAAY,EACZ,sBAAoB,CAAC,yBAAyB,CAC/C,CAAA;QAED,IAAI,CAAC,oBAAoB,EAAE;YACzB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAA;YACzE,MAAM,IAAI,CAAC,wBAAwB,CAAC,IAAI,CACtC,YAAY,EACZ,IAAI,2CAAoB,CAAC;gBACvB,EAAE,EAAE,sBAAoB,CAAC,yBAAyB;gBAClD,cAAc;aACf,CAAC,CACH,CAAA;SACF;aAAM;YACL,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAA;YACrE,oBAAoB,CAAC,cAAc,GAAG,cAAc,CAAA;YACpD,MAAM,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAA;SAC/E;IACH,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,uBAAuB,CAAC,YAA0B;QAC7D,IAAI,oBAAoB,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CACrE,YAAY,EACZ,sBAAoB,CAAC,yBAAyB,CAC/C,CAAA;QAED,IAAI,CAAC,oBAAoB,EAAE;YACzB,oBAAoB,GAAG,IAAI,2CAAoB,CAAC;gBAC9C,EAAE,EAAE,sBAAoB,CAAC,yBAAyB;gBAClD,cAAc,EAAE,iCAAuB;aACxC,CAAC,CAAA;YACF,MAAM,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAA;SAC7E;QAED,OAAO,oBAAoB,CAAA;IAC7B,CAAC;;AA3Ec,8CAAyB,GAAG,2BAA2B,CAAA;AAD3D,oBAAoB;IADhC,IAAA,oBAAU,GAAE;IAQR,WAAA,IAAA,gBAAM,EAAC,4BAAgB,CAAC,MAAM,CAAC,CAAA;6CACN,mDAAwB;GARzC,oBAAoB,CA6EhC;AA7EY,oDAAoB"}

package/build/storage/migration/UpdateAssistant.d.ts

@@ -0,0 +1,34 @@
+import type { UpdateConfig, UpdateToVersion } from './updates';
+import type { BaseAgent } from '../../agent/BaseAgent';
+export declare class UpdateAssistant<Agent extends BaseAgent<any> = BaseAgent> {
+    private agent;
+    private storageUpdateService;
+    private updateConfig;
+    private fileSystem;
+    constructor(agent: Agent, updateConfig: UpdateConfig);
+    initialize(): Promise<void>;
+    isUpToDate(updateToVersion?: UpdateToVersion): Promise<boolean>;
+    getCurrentAgentStorageVersion(): Promise<import("../../utils/version").VersionString>;
+    static get frameworkStorageVersion(): "0.4";
+    getNeededUpdates(toVersion?: UpdateToVersion): Promise<({
+        readonly fromVersion: "0.1";
+        readonly toVersion: "0.2";
+        readonly doUpdate: typeof import("./updates/0.1-0.2").updateV0_1ToV0_2;
+    } | {
+        readonly fromVersion: "0.2";
+        readonly toVersion: "0.3";
+        readonly doUpdate: typeof import("./updates/0.2-0.3").updateV0_2ToV0_3;
+    } | {
+        readonly fromVersion: "0.3";
+        readonly toVersion: "0.3.1";
+        readonly doUpdate: typeof import("./updates/0.3-0.3.1").updateV0_3ToV0_3_1;
+    } | {
+        readonly fromVersion: "0.3.1";
+        readonly toVersion: "0.4";
+        readonly doUpdate: typeof import("./updates/0.3.1-0.4").updateV0_3_1ToV0_4;
+    })[]>;
+    update(updateToVersion?: UpdateToVersion): Promise<string | undefined>;
+    private getBackupPath;
+    private createBackup;
+    private restoreBackup;
+}

package/build/storage/migration/UpdateAssistant.js

@@ -0,0 +1,191 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateAssistant = void 0;
+const constants_1 = require("../../constants");
+const error_1 = require("../../error");
+const version_1 = require("../../utils/version");
+const error_2 = require("../../wallet/error");
+const WalletError_1 = require("../../wallet/error/WalletError");
+const StorageUpdateService_1 = require("./StorageUpdateService");
+const StorageUpdateError_1 = require("./error/StorageUpdateError");
+const updates_1 = require("./updates");
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+class UpdateAssistant {
+    constructor(agent, updateConfig) {
+        this.agent = agent;
+        this.updateConfig = updateConfig;
+        this.storageUpdateService = this.agent.dependencyManager.resolve(StorageUpdateService_1.StorageUpdateService);
+        this.fileSystem = this.agent.dependencyManager.resolve(constants_1.InjectionSymbols.FileSystem);
+    }
+    async initialize() {
+        if (this.agent.isInitialized) {
+            throw new error_1.AriesFrameworkError("Can't initialize UpdateAssistant after agent is initialized");
+        }
+        // Initialize the wallet if not already done
+        if (!this.agent.wallet.isInitialized && this.agent.config.walletConfig) {
+            await this.agent.wallet.initialize(this.agent.config.walletConfig);
+        }
+        else if (!this.agent.wallet.isInitialized) {
+            throw new WalletError_1.WalletError('Wallet config has not been set on the agent config. ' +
+                'Make sure to initialize the wallet yourself before initializing the update assistant, ' +
+                'or provide the required wallet configuration in the agent constructor');
+        }
+    }
+    async isUpToDate(updateToVersion) {
+        return this.storageUpdateService.isUpToDate(this.agent.context, updateToVersion);
+    }
+    async getCurrentAgentStorageVersion() {
+        return this.storageUpdateService.getCurrentStorageVersion(this.agent.context);
+    }
+    static get frameworkStorageVersion() {
+        return updates_1.CURRENT_FRAMEWORK_STORAGE_VERSION;
+    }
+    async getNeededUpdates(toVersion) {
+        const currentStorageVersion = (0, version_1.parseVersionString)(await this.storageUpdateService.getCurrentStorageVersion(this.agent.context));
+        const parsedToVersion = toVersion ? (0, version_1.parseVersionString)(toVersion) : undefined;
+        // If the current storage version is higher or equal to the toVersion, we can't update, so return empty array
+        if (parsedToVersion &&
+            ((0, version_1.isFirstVersionHigherThanSecond)(currentStorageVersion, parsedToVersion) ||
+                (0, version_1.isFirstVersionEqualToSecond)(currentStorageVersion, parsedToVersion))) {
+            return [];
+        }
+        // Filter updates. We don't want older updates we already applied
+        // or aren't needed because the wallet was created after the update script was made
+        const neededUpdates = updates_1.supportedUpdates.filter((update) => {
+            const updateToVersion = (0, version_1.parseVersionString)(update.toVersion);
+            // If the update toVersion is higher than the wanted toVersion, we skip the update
+            if (parsedToVersion && (0, version_1.isFirstVersionHigherThanSecond)(updateToVersion, parsedToVersion)) {
+                return false;
+            }
+            // if an update toVersion is higher than currentStorageVersion we want to to include the update
+            return (0, version_1.isFirstVersionHigherThanSecond)(updateToVersion, currentStorageVersion);
+        });
+        // The current storage version is too old to update
+        if (neededUpdates.length > 0 &&
+            (0, version_1.isFirstVersionHigherThanSecond)((0, version_1.parseVersionString)(neededUpdates[0].fromVersion), currentStorageVersion)) {
+            throw new error_1.AriesFrameworkError(`First fromVersion is higher than current storage version. You need to use an older version of the framework to update to at least version ${neededUpdates[0].fromVersion}`);
+        }
+        const lastUpdateToVersion = neededUpdates.length > 0 ? neededUpdates[neededUpdates.length - 1].toVersion : undefined;
+        if (toVersion && lastUpdateToVersion && lastUpdateToVersion !== toVersion) {
+            throw new error_1.AriesFrameworkError(`No update found for toVersion ${toVersion}. Make sure the toVersion is a valid version you can update to`);
+        }
+        return neededUpdates;
+    }
+    async update(updateToVersion) {
+        var _a;
+        const updateIdentifier = Date.now().toString();
+        try {
+            this.agent.config.logger.info(`Starting update of agent storage with updateIdentifier ${updateIdentifier}`);
+            const neededUpdates = await this.getNeededUpdates(updateToVersion);
+            const currentStorageVersion = (0, version_1.parseVersionString)(await this.storageUpdateService.getCurrentStorageVersion(this.agent.context));
+            const parsedToVersion = updateToVersion ? (0, version_1.parseVersionString)(updateToVersion) : undefined;
+            // If the current storage version is higher or equal to the toVersion, we can't update.
+            if (parsedToVersion &&
+                ((0, version_1.isFirstVersionHigherThanSecond)(currentStorageVersion, parsedToVersion) ||
+                    (0, version_1.isFirstVersionEqualToSecond)(currentStorageVersion, parsedToVersion))) {
+                throw new StorageUpdateError_1.StorageUpdateError(`Can't update to version ${updateToVersion} because it is lower or equal to the current agent storage version ${currentStorageVersion[0]}.${currentStorageVersion[1]}}`);
+            }
+            if (neededUpdates.length === 0) {
+                this.agent.config.logger.info('No update needed. Agent storage is up to date.');
+                return;
+            }
+            const fromVersion = neededUpdates[0].fromVersion;
+            const toVersion = neededUpdates[neededUpdates.length - 1].toVersion;
+            this.agent.config.logger.info(`Starting update process. Total of ${neededUpdates.length} update(s) will be applied to update the agent storage from version ${fromVersion} to version ${toVersion}`);
+            // Create backup in case migration goes wrong
+            await this.createBackup(updateIdentifier);
+            try {
+                for (const update of neededUpdates) {
+                    const registeredModules = Object.values(this.agent.dependencyManager.registeredModules);
+                    const modulesWithUpdate = [];
+                    // Filter modules that have an update script for the current update
+                    for (const registeredModule of registeredModules) {
+                        const moduleUpdate = (_a = registeredModule.updates) === null || _a === void 0 ? void 0 : _a.find((module) => module.fromVersion === update.fromVersion && module.toVersion === update.toVersion);
+                        if (moduleUpdate) {
+                            modulesWithUpdate.push({
+                                module: registeredModule,
+                                update: moduleUpdate,
+                            });
+                        }
+                    }
+                    this.agent.config.logger.info(`Starting update of agent storage from version ${update.fromVersion} to version ${update.toVersion}. Found ${modulesWithUpdate.length} extension module(s) with update scripts`);
+                    await update.doUpdate(this.agent, this.updateConfig);
+                    this.agent.config.logger.info(`Finished update of core agent storage from version ${update.fromVersion} to version ${update.toVersion}. Starting update of extension modules`);
+                    for (const moduleWithUpdate of modulesWithUpdate) {
+                        this.agent.config.logger.info(`Starting update of extension module ${moduleWithUpdate.module.constructor.name} from version ${moduleWithUpdate.update.fromVersion} to version ${moduleWithUpdate.update.toVersion}`);
+                        await moduleWithUpdate.update.doUpdate(this.agent, this.updateConfig);
+                        this.agent.config.logger.info(`Finished update of extension module ${moduleWithUpdate.module.constructor.name} from version ${moduleWithUpdate.update.fromVersion} to version ${moduleWithUpdate.update.toVersion}`);
+                    }
+                    // Update the framework version in storage
+                    await this.storageUpdateService.setCurrentStorageVersion(this.agent.context, update.toVersion);
+                    this.agent.config.logger.info(`Successfully updated agent storage from version ${update.fromVersion} to version ${update.toVersion}`);
+                }
+                // Delete backup file, as it is not needed anymore
+                await this.fileSystem.delete(this.getBackupPath(updateIdentifier));
+            }
+            catch (error) {
+                this.agent.config.logger.fatal('An error occurred while updating the wallet. Restoring backup', {
+                    error,
+                });
+                // In the case of an error we want to restore the backup
+                await this.restoreBackup(updateIdentifier);
+                // Delete backup file, as wallet was already restored (backup-error file will persist though)
+                await this.fileSystem.delete(this.getBackupPath(updateIdentifier));
+                throw error;
+            }
+        }
+        catch (error) {
+            // Backup already exists at path
+            if (error instanceof error_2.WalletExportPathExistsError) {
+                const backupPath = this.getBackupPath(updateIdentifier);
+                const errorMessage = `Error updating storage with updateIdentifier ${updateIdentifier} because the backup at path ${backupPath} already exists`;
+                this.agent.config.logger.fatal(errorMessage, {
+                    error,
+                    updateIdentifier,
+                    backupPath,
+                });
+                throw new StorageUpdateError_1.StorageUpdateError(errorMessage, { cause: error });
+            }
+            this.agent.config.logger.error(`Error updating storage (updateIdentifier: ${updateIdentifier})`, {
+                cause: error,
+            });
+            throw new StorageUpdateError_1.StorageUpdateError(`Error updating storage (updateIdentifier: ${updateIdentifier}): ${error.message}`, {
+                cause: error,
+            });
+        }
+        return updateIdentifier;
+    }
+    getBackupPath(backupIdentifier) {
+        return `${this.fileSystem.dataPath}/migration/backup/${backupIdentifier}`;
+    }
+    async createBackup(backupIdentifier) {
+        var _a;
+        const backupPath = this.getBackupPath(backupIdentifier);
+        const walletKey = (_a = this.agent.wallet.walletConfig) === null || _a === void 0 ? void 0 : _a.key;
+        if (!walletKey) {
+            throw new error_1.AriesFrameworkError("Could not extract wallet key from wallet module. Can't create backup");
+        }
+        await this.agent.wallet.export({ key: walletKey, path: backupPath });
+        this.agent.config.logger.info('Created backup of the wallet', {
+            backupPath,
+        });
+    }
+    async restoreBackup(backupIdentifier) {
+        const backupPath = this.getBackupPath(backupIdentifier);
+        const walletConfig = this.agent.wallet.walletConfig;
+        if (!walletConfig) {
+            throw new error_1.AriesFrameworkError('Could not extract wallet config from wallet module. Cannot restore backup');
+        }
+        // Export and delete current wallet
+        await this.agent.wallet.export({ key: walletConfig.key, path: `${backupPath}-error` });
+        await this.agent.wallet.delete();
+        // Import backup
+        await this.agent.wallet.import(walletConfig, { key: walletConfig.key, path: backupPath });
+        await this.agent.wallet.initialize(walletConfig);
+        this.agent.config.logger.info(`Successfully restored wallet from backup ${backupIdentifier}`, {
+            backupPath,
+        });
+    }
+}
+exports.UpdateAssistant = UpdateAssistant;
+//# sourceMappingURL=UpdateAssistant.js.map

package/build/storage/migration/UpdateAssistant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateAssistant.js","sourceRoot":"","sources":["../../../src/storage/migration/UpdateAssistant.ts"],"names":[],"mappings":"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"}

package/build/storage/migration/error/StorageUpdateError.d.ts

@@ -0,0 +1,6 @@
+import { AriesFrameworkError } from '../../../error/AriesFrameworkError';
+export declare class StorageUpdateError extends AriesFrameworkError {
+    constructor(message: string, { cause }?: {
+        cause?: Error;
+    });
+}

package/build/storage/migration/error/StorageUpdateError.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageUpdateError = void 0;
+const AriesFrameworkError_1 = require("../../../error/AriesFrameworkError");
+class StorageUpdateError extends AriesFrameworkError_1.AriesFrameworkError {
+    constructor(message, { cause } = {}) {
+        super(message, { cause });
+    }
+}
+exports.StorageUpdateError = StorageUpdateError;
+//# sourceMappingURL=StorageUpdateError.js.map

package/build/storage/migration/error/StorageUpdateError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageUpdateError.js","sourceRoot":"","sources":["../../../../src/storage/migration/error/StorageUpdateError.ts"],"names":[],"mappings":";;;AAAA,4EAAwE;AAExE,MAAa,kBAAmB,SAAQ,yCAAmB;IACzD,YAAmB,OAAe,EAAE,EAAE,KAAK,KAAwB,EAAE;QACnE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;IAC3B,CAAC;CACF;AAJD,gDAIC"}

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

@@ -0,0 +1,5 @@
+export * from './repository/StorageVersionRecord';
+export * from './repository/StorageVersionRepository';
+export * from './StorageUpdateService';
+export * from './UpdateAssistant';
+export { Update } from './updates';

package/build/storage/migration/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./repository/StorageVersionRecord"), exports);
+__exportStar(require("./repository/StorageVersionRepository"), exports);
+__exportStar(require("./StorageUpdateService"), exports);
+__exportStar(require("./UpdateAssistant"), exports);
+//# sourceMappingURL=index.js.map

package/build/storage/migration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/storage/migration/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oEAAiD;AACjD,wEAAqD;AACrD,yDAAsC;AACtC,oDAAiC"}

package/build/storage/migration/repository/StorageVersionRecord.d.ts

@@ -0,0 +1,14 @@
+import type { VersionString } from '../../../utils/version';
+import { BaseRecord } from '../../BaseRecord';
+export interface StorageVersionRecordProps {
+    id?: string;
+    createdAt?: Date;
+    storageVersion: VersionString;
+}
+export declare class StorageVersionRecord extends BaseRecord {
+    storageVersion: VersionString;
+    static readonly type = "StorageVersionRecord";
+    readonly type = "StorageVersionRecord";
+    constructor(props: StorageVersionRecordProps);
+    getTags(): import("../../BaseRecord").TagsBase;
+}

package/build/storage/migration/repository/StorageVersionRecord.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageVersionRecord = void 0;
+const uuid_1 = require("../../../utils/uuid");
+const BaseRecord_1 = require("../../BaseRecord");
+class StorageVersionRecord extends BaseRecord_1.BaseRecord {
+    constructor(props) {
+        var _a, _b;
+        super();
+        this.type = StorageVersionRecord.type;
+        if (props) {
+            this.id = (_a = props.id) !== null && _a !== void 0 ? _a : (0, uuid_1.uuid)();
+            this.createdAt = (_b = props.createdAt) !== null && _b !== void 0 ? _b : new Date();
+            this.storageVersion = props.storageVersion;
+        }
+    }
+    getTags() {
+        return this._tags;
+    }
+}
+exports.StorageVersionRecord = StorageVersionRecord;
+StorageVersionRecord.type = 'StorageVersionRecord';
+//# sourceMappingURL=StorageVersionRecord.js.map

package/build/storage/migration/repository/StorageVersionRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageVersionRecord.js","sourceRoot":"","sources":["../../../../src/storage/migration/repository/StorageVersionRecord.ts"],"names":[],"mappings":";;;AAEA,8CAA0C;AAC1C,iDAA6C;AAQ7C,MAAa,oBAAqB,SAAQ,uBAAU;IAMlD,YAAmB,KAAgC;;QACjD,KAAK,EAAE,CAAA;QAHO,SAAI,GAAG,oBAAoB,CAAC,IAAI,CAAA;QAK9C,IAAI,KAAK,EAAE;YACT,IAAI,CAAC,EAAE,GAAG,MAAA,KAAK,CAAC,EAAE,mCAAI,IAAA,WAAI,GAAE,CAAA;YAC5B,IAAI,CAAC,SAAS,GAAG,MAAA,KAAK,CAAC,SAAS,mCAAI,IAAI,IAAI,EAAE,CAAA;YAC9C,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAA;SAC3C;IACH,CAAC;IAEM,OAAO;QACZ,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;;AAlBH,oDAmBC;AAhBwB,yBAAI,GAAG,sBAAsB,CAAA"}

package/build/storage/migration/repository/StorageVersionRepository.d.ts

@@ -0,0 +1,7 @@
+import { EventEmitter } from '../../../agent/EventEmitter';
+import { Repository } from '../../Repository';
+import { StorageService } from '../../StorageService';
+import { StorageVersionRecord } from './StorageVersionRecord';
+export declare class StorageVersionRepository extends Repository<StorageVersionRecord> {
+    constructor(storageService: StorageService<StorageVersionRecord>, eventEmitter: EventEmitter);
+}

package/build/storage/migration/repository/StorageVersionRepository.js

@@ -0,0 +1,32 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageVersionRepository = void 0;
+const EventEmitter_1 = require("../../../agent/EventEmitter");
+const constants_1 = require("../../../constants");
+const plugins_1 = require("../../../plugins");
+const Repository_1 = require("../../Repository");
+const StorageVersionRecord_1 = require("./StorageVersionRecord");
+let StorageVersionRepository = class StorageVersionRepository extends Repository_1.Repository {
+    constructor(storageService, eventEmitter) {
+        super(StorageVersionRecord_1.StorageVersionRecord, storageService, eventEmitter);
+    }
+};
+StorageVersionRepository = __decorate([
+    (0, plugins_1.injectable)(),
+    __param(0, (0, plugins_1.inject)(constants_1.InjectionSymbols.StorageService)),
+    __metadata("design:paramtypes", [Object, EventEmitter_1.EventEmitter])
+], StorageVersionRepository);
+exports.StorageVersionRepository = StorageVersionRepository;
+//# sourceMappingURL=StorageVersionRepository.js.map

package/build/storage/migration/repository/StorageVersionRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageVersionRepository.js","sourceRoot":"","sources":["../../../../src/storage/migration/repository/StorageVersionRepository.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,8DAA0D;AAC1D,kDAAqD;AACrD,8CAAqD;AACrD,iDAA6C;AAG7C,iEAA6D;AAGtD,IAAM,wBAAwB,GAA9B,MAAM,wBAAyB,SAAQ,uBAAgC;IAC5E,YAC2C,cAAoD,EAC7F,YAA0B;QAE1B,KAAK,CAAC,2CAAoB,EAAE,cAAc,EAAE,YAAY,CAAC,CAAA;IAC3D,CAAC;CACF,CAAA;AAPY,wBAAwB;IADpC,IAAA,oBAAU,GAAE;IAGR,WAAA,IAAA,gBAAM,EAAC,4BAAgB,CAAC,cAAc,CAAC,CAAA;6CAC1B,2BAAY;GAHjB,wBAAwB,CAOpC;AAPY,4DAAwB"}

package/build/storage/migration/updates/0.1-0.2/connection.d.ts

@@ -0,0 +1,119 @@
+import type { BaseAgent } from '../../../../agent/BaseAgent';
+import type { ConnectionRecord } from '../../../../modules/connections';
+import { DidExchangeState, ConnectionState, ConnectionRole, DidExchangeRole } from '../../../../modules/connections';
+import { OutOfBandState } from '../../../../modules/oob/domain/OutOfBandState';
+/**
+ * Migrates the {@link ConnectionRecord} to 0.2 compatible format. It fetches all records from storage
+ * and applies the needed updates to the records. After a record has been transformed, it is updated
+ * in storage and the next record will be transformed.
+ *
+ * The following transformations are applied:
+ *  - {@link updateConnectionRoleAndState}
+ *  - {@link extractDidDocument}
+ *  - {@link migrateToOobRecord}
+ */
+export declare function migrateConnectionRecordToV0_2<Agent extends BaseAgent>(agent: Agent): Promise<void>;
+/**
+ * With the addition of the did exchange protocol there are now two states and roles related to the connection record; for the did exchange protocol and for the connection protocol.
+ * To keep it easy to work with the connection record, all state and role values are updated to those of the {@link DidExchangeRole} and {@link DidExchangeState}.
+ *
+ * This migration method transforms all connection record state and role values to their respective values of the {@link DidExchangeRole} and {@link DidExchangeState}. For convenience a getter
+ * property `rfc0160ConnectionState` is added to the connection record which returns the {@link ConnectionState} value.
+ *
+ * The following 0.1.0 connection record structure (unrelated keys omitted):
+ *
+ * ```json
+ * {
+ *   "state": "invited",
+ *   "role": "inviter"
+ * }
+ * ```
+ *
+ * Will be transformed into the following 0.2.0 structure (unrelated keys omitted):
+ *
+ * ```json
+ * {
+ *   "state": "invitation-sent",
+ *   "role": "responder",
+ * }
+ * ```
+ */
+export declare function updateConnectionRoleAndState<Agent extends BaseAgent>(agent: Agent, connectionRecord: ConnectionRecord): Promise<void>;
+/**
+ * The connection record previously stored both did documents from a connection in the connection record itself. Version 0.2.0 added a generic did storage that can be used for numerous usages, one of which
+ * is the storage of did documents for connection records.
+ *
+ * This migration method extracts the did documents from the `didDoc` and `theirDidDoc` properties from the connection record, updates them to did documents compliant with the DID Core spec, and stores them
+ * in the did repository. By doing so it also updates the unqualified dids in the `did` and `theirDid` fields generated by the indy-sdk to fully qualified `did:peer` dids compliant with
+ * the [Peer DID Method Specification](https://identity.foundation/peer-did-method-spec/).
+ *
+ * To account for the fact that the mechanism to migrate legacy did document to peer did documents is not defined yet, the legacy did and did document are stored in the did record metadata.
+ * This will be deleted later if we can be certain the did doc conversion to a did:peer did document is correct.
+ *
+ * The following 0.1.0 connection record structure (unrelated keys omitted):
+ *
+ * ```json
+ * {
+ *   "did": "BBPoJqRKatdcfLEAFL7exC",
+ *   "theirDid": "N8NQHLtCKfPmWMgCSdfa7h",
+ *   "didDoc": <legacyDidDoc>,
+ *   "theirDidDoc": <legacyTheirDidDoc>,
+ *   "verkey": "GjZWsBLgZCR18aL468JAT7w9CZRiBnpxUPPgyQxh4voa"
+ * }
+ * ```
+ *
+ * Will be transformed into the following 0.2.0 structure (unrelated keys omitted):
+ *
+ * ```json
+ * {
+ *   "did": "did:peer:1zQmXUaPPhPCbUVZ3hGYmQmGxWTwyDfhqESXCpMFhKaF9Y2A",
+ *   "theirDid": "did:peer:1zQmZMygzYqNwU6Uhmewx5Xepf2VLp5S4HLSwwgf2aiKZuwa"
+ * }
+ * ```
+ */
+export declare function extractDidDocument<Agent extends BaseAgent>(agent: Agent, connectionRecord: ConnectionRecord): Promise<void>;
+/**
+ * With the addition of the out of band protocol, invitations are now stored in the {@link OutOfBandRecord}. In addition a new field `invitationDid` is added to the connection record that
+ * is generated based on the invitation service or did. This allows to reuse existing connections.
+ *
+ * This migration method extracts the invitation and other relevant data into a separate {@link OutOfBandRecord}. By doing so it converts the old connection protocol invitation into the new
+ * Out of band invitation message. Based on the service or did of the invitation, the `invitationDid` is populated.
+ *
+ * Previously when creating a multi use invitation, a connection record would be created with the `multiUseInvitation` set to true. The connection record would always be in state `invited`.
+ * If a request for the multi use invitation came in, a new connection record would be created. With the addition of the out of band module, no connection records are created until a request
+ * is received. So for multi use invitation this means that the connection record with multiUseInvitation=true will be deleted, and instead all connections created using that out of band invitation
+ * will contain the `outOfBandId` of the multi use invitation.
+ *
+ * The following 0.1.0 connection record structure (unrelated keys omitted):
+ *
+ * ```json
+ * {
+ *   "invitation": {
+ *     "@type": "https://didcomm.org/connections/1.0/invitation",
+ *     "@id": "04a2c382-999e-4de9-a1d2-9dec0b2fa5e4",
+ *     "recipientKeys": ["E6D1m3eERqCueX4ZgMCY14B4NceAr6XP2HyVqt55gDhu"],
+ *     "serviceEndpoint": "https://example.com",
+ *     "label": "test",
+ *   },
+ *   "multiUseInvitation": false
+ * }
+ * ```
+ *
+ * Will be transformed into the following 0.2.0 structure (unrelated keys omitted):
+ *
+ * ```json
+ * {
+ *   "invitationDid": "did:peer:2.Ez6MksYU4MHtfmNhNm1uGMvANr9j4CBv2FymjiJtRgA36bSVH.SeyJzIjoiaHR0cHM6Ly9leGFtcGxlLmNvbSJ9",
+ *   "outOfBandId": "04a2c382-999e-4de9-a1d2-9dec0b2fa5e4"
+ * }
+ * ```
+ */
+export declare function migrateToOobRecord<Agent extends BaseAgent>(agent: Agent, connectionRecord: ConnectionRecord): Promise<ConnectionRecord | undefined>;
+/**
+ * Determine the out of band state based on the did exchange role and state.
+ */
+export declare function oobStateFromDidExchangeRoleAndState(role: DidExchangeRole, state: DidExchangeState): OutOfBandState;
+/**
+ * Determine the did exchange state based on the connection/did-exchange role and state.
+ */
+export declare function didExchangeStateAndRoleFromRoleAndState(role: ConnectionRole | DidExchangeRole, state: ConnectionState | DidExchangeState): [DidExchangeRole, DidExchangeState];