Solid Application Interoperability (TypeScript)

Modules implementing Solid Application Interoperability Specification

Intended dependents

	package
Solid Applications	@janeirodigital/interop-application
Solid Authorization Agent	@janeirodigital/interop-authorization-agent

Development

Docker Shared Services

Default setup assumes docker command available, and runs it as non-root user. Also mkcert is required.

The setup is using modified Makefile and docker-compose.yaml from docker-shared-services

Node, corepack and npm

Requires node.js 22 or higher

Github packages

• generate a classic github token (tick only read:packages scope)
• Modify ~/.npmrc (per-user config file) and add line //npm.pkg.github.com/:_authToken= and the generated token.

Local DNS

macOS

mkdir /etc/resolver/
sudo sh -c 'echo "nameserver 127.0.0.1" > /etc/resolver/docker'
sudo dscacheutil -flushcache

If port 53 is occupied, go to docker and uncheck settings -> resources -> network -> Use kernel networking for UDP

To enable communication to docker network

# Install via Homebrew
$ brew install chipmk/tap/docker-mac-net-connect

# Run the service and register it to launch at boot
$ sudo brew services start chipmk/tap/docker-mac-net-connect

Bootstrapping

npm install
npm run build
npm test

To create local certificates

make cert-install

To start local development

make up

It will run the following:

Community Solid Server

Run from packages/css-solid-fixture. Used for solid storage instances and solid-oidc provider.

Available on https://pod.docker, default demo account is alice@acme.example with password.

Authorization Agent

Service

Run from packages/service. Available on https://sai.docker (API only)

UI

Run from ui/authorization. Available on https://ui.sai.docker , requires signing up with UI first and later signing up in with the service (Connect server). Dev config uses local CSS as default provider when input left empty.

Demo app (Vujectron)

Run from examples/vuejectron. Available on https://vuejectron.docker , requires signup and authorization. Dev config uses local CSS as default provider when input left empty.

Localization

The translation project for all relevant components is hosted thanks to the courtesy of Weblate Libre hosting.

Funding

This project is funded through the NGI Zero Entrust Fund, a fund established by NLnet with financial support from the European Commission's Next Generation Internet program. Learn more at the NLnet project page.