README
Application
Early access
Specifications this library implements are still a work in progress. While we track changes to the public API of this library with semver, the underlying data will be slightly changing for the rest of 2021. We are commited to keep this implementation up to date. If you plan to use your application in production please ask the specification editors on the public chatroom about the stability of the data model.
Example
import { DatasetCore } from '@rdfjs/types';
import { Application } from '@janeirodigital/interop-application';
import { DataInstance } from '@janeirodigital/interop-data-model';
import { Session } from '@inrupt/solid-client-authn-node';
import { randomUUID } from 'crypto';
import { Store } from 'n3';
class Custom {
localDataset: DatasetCore;
constructor(private dataInstance: DataInstance) {
this.localDataset = new Store([...dataInstance.dataset]);
}
delete(): Promise<void> {
return this.dataInstance.delete();
}
update(): Promise<void> {
return this.dataInstance.update(this.localDataset);
}
get dataset(): DatasetCore {
return this.dataInstance.dataset;
}
set name(name: string): void {
// manipulate this.localDataset to change project name
}
}
class Project extends Custom {
static shapeTree = 'https://solidshapes.example/trees/Project';
}
class Task extends Custom {
static shapeTree = 'https://solidshapes.example/trees/Task';
}
(async function () {
// authentication is handled by separate library
// for example https://docs.inrupt.com/developer-tools/javascript/client-libraries/authentication/
const session = new Session();
await session.login({
/* options */
});
// For simplicity we ommit handing redirect to user's Solid-OIDC Provider
// Following lines assume session.info.isLoggedIn === true
// create new application
// fetch need to take care of authentication
const application = await Application.build(session.info.webId, { fetch: session.fetch, randomUUID });
// application provides list of all data owners
// we can find one matching currently logged in user
const user = application.dataOwners.find((agent) => agent.iri === session.info.webId);
const projects = [];
// agent has one or more data registrations
for (const registration of user.selectRegistrations(Project.shapeTree)) {
// registration provides async iterator of Data Instances from that data registration
for await (const dataInstance of registration.dataInstances) {
// data instance will provide RDFJS DatasetCore with all the data
// one can create app specific instances
projects.push(new Project(dataInstance));
}
}
// DataInstance#delete
const projectToDelete = projects.find(/* logic */);
try {
await projectToDelete.delete();
} catch (e) {
// handle error
}
// DataInstance#update
const projectToUpdate = projects.find(/* logic */);
projectToUpdate.name = 'Very very important thing';
try {
await projectToUpdate.update();
} catch (e) {
// handle error
}
// DataRegistrationProxy#newDataInstance
const registration = user.selectRegistrations(Project.shapeTree).find(/* logic */);
const newProject = new Project(registration.newDataInstance());
newProject.name = 'Another thing';
try {
await newProject.update();
} catch (e) {
// handle error
}
// for inherited grants DataRegistrationProxy#newDataInstance parent data instance is required
// for that reason also data instance acting as parent provides convienience method
const projectToCreateTaskIn = projects.find(/* logic */);
const newTask = new Task(projectToCreateTaskIn.newChildDataInstance(Task.shapeTree));
newTask.name = 'some task';
try {
await newTask.update();
} catch (e) {
// handle error
}
})();