digitalcredentials / open-badges-context

NPM package for the OBv3 (Open Badges version 3) JSON-LD context.
MIT License
4 stars 2 forks source link

OpenBadges v3 Context (@digitalcredentials/open-badges-context)

Node.js CI NPM Version

NPM package for the OBv3 (Open Badges version 3) JSON-LD context.

Table of Contents

Background

For use with JSON-LD document loaders (such as the DCC security-document-loader or DigitalBazaar's jsonld-document-loader).

Install

Requires Node.js 14+

To install via NPM:

npm install @digitalcredentials/open-badges-context

Usage

import obCtx from '@digitalcredentials/open-badges-context';
// or
const obCtx = require('@digitalcredentials/open-badges-context');

obCtx.CONTEXT_URL_V3
// 'https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json' <-- Latest URL

// get context data for a specific context
obCtx.contexts.get(obCtx.CONTEXT_URL_V3)
// full context object

This package can be used with bundlers, such as webpack, in browser applications.

API

The library exports the following properties:

See index.js for full list of exports.

Developing

When adding a new @context, do all of the following:

  1. Add the new context file to js/contexts
  2. Update js/index.js
  3. Update rollup.config.js with the new exports
  4. Update context.spec.js with the new exports
  5. Update README / Usage section.

License