@sphereon/ssi-sdk.data-store

Data Store (Typescript)

---

Warning: This package still is in very early development. Breaking changes without notice will happen at this point!

---

SSI-SDK data storage based on TypeORM. This package provides several plugins that relate to data storage.

Available stores

• Contact Store
• Issuance Branding Store
• Event Logger Store

Contact Store

A store that exposes simple store/get methods for contacts and identities.

Issuance Branding Store

A store that exposes simple store/get methods for issuer and credential branding.

Event Logger Store

A store that exposes simple store/get methods for event payloads.

Installation

yarn add @sphereon/ssi-sdk.data-store

Build

yarn build

Module developers

We use TypeORM migrations to support database changes over time. As soon as you need to update, add or delete information from entities, ensure that migration files are being created to reflect the updates.

Currently, we support migrations for sqlite databases, typically used during development and on mobile platforms. Next to that we also support Postgres. Obviously you need to have a Postgresql database at hand when working with Postgres.

Create a migration file

• Ensure you have an existing sqlite/postgres database at hand with the old situation
• Make a copy of that database, so you can always easily go back
• Run the respective commands for postgres and/or sqlite:
  • yarn run typeorm-postgres:migration:generate NameOfYourMigration
  • yarn run typeorm-sqlite:migration:generate NameOfYourMigration
• Check in the src/migrations folders to find a file in the respective sqlite/postgres folder which contains _ NameOfYourMigration_
• Update the credential-mapper.ts file in the respective directory to include the migration. Users will import that file as their migrations entrypoint from their TypeORM config.
• If you wish to check whether applying the migration works you can execute the respective

Applying migrations

There is an example sqlite file in the root called migration.sqlite. We use the sqlite file to keep track of changes we made and to ensure there are no incidental changes by a developer changing an entity,

This file is kept up to date by applying the command: yarn typeorm-sqlite:migration:run The same can be done for a local Postgres database using the command typeorm-postgres:migration:run

You can look at package.json or https://typeorm.io/migrations to apply migrations to your own database(s)