Bookmarks - Solid Data Module for rdflib

A data module to manage bookmarks in Solid Pods in an interoperable way.

Usage

Installation via npm

npm install rdflib @solid-data-modules/bookmarks-rdflib

Usage in the brower via CDN

You can use the module directly in the browser (without any install or build step) by using the esm.sh CDN and an import map:

<script type="importmap">
  {
    "imports": {
      "@solid-data-modules/bookmarks-rdflib": "https://esm.sh/@solid-data-modules/bookmarks-rdflib",
      "rdflib": "https://esm.sh/rdflib"
    }
  }
</script>
<script type="module">
  import BookmarksModuleRdfLib from "@solid-data-modules/bookmarks-rdflib";
  import { Fetcher, graph, UpdateManager } from "rdflib";
  // ... use the module as described in the quick start
</script>

Quick start

import {Fetcher, graph, UpdateManager} from "rdflib";
import BookmarksModuleRdfLib, { BookmarksModule } from "@solid-data-modules/bookmarks-rdflib";

// 1️⃣ create rdflib store, fetcher and updater as usual
const store = graph();
const fetcher = new Fetcher(
        store,
        // 💡 pass an authenticated fetch
        // to be able to access private resources*
        /* fetch: authenticatedFetch */
);
const updater = new UpdateManager(store);

// 2️⃣ create the bookmarks module
const module: BookmarksModule = new BookmarksModuleRdfLib({store, fetcher, updater});

// 3️⃣ use the module to interact with bookmarks
const uri = await bookmarks.createBookmark({
  storageUrl: "http://localhost:3000/alice/public/bookmarks",
  title: "My favorite website",
  url: "https://favorite.example"
})

Example scripts

Executable example scripts how to use the module can be found in ./examples folder.

The development server needs to be running and initialized for this.

After that you can run an example script like this:

npm run build
node ./examples/create-bookmark-within-container.mjs

Available features

For a description of all features available please take a look at the module API documentation.

Development

Run tests

Unit and integration tests

npm test

End-to-end tests

The tests will start and stop their own solid server on port 3456. This port needs to be available.

npm run test:e2e

The server is seeded with data from src/e2e-tests/test-data initially. After a test run you can investigate the pod file system at src/e2e-tests/.test-data/<test-id> where <test-id> is a random id generated for each run.

Build

npm run build

Development server

Start server

You can start a development solid server via:

npm run pod

This will seed an account and an empty pod for test user alice. Find the credentials of that account in ../dev-server/seed.json

Initialize example data

To add some example data to this pod run

npm run pod:init

To start from scratch run

npm run pod:clean

and repeat from start of the section.

Funding

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