@seedprotocol/rdf 0.0.0-stage → 0.8.1

package/dist/quads.d.ts

@@ -0,0 +1,12 @@
+import type * as RDF from '@rdfjs/types';
+import type { StateGraph } from './graph.js';
+/**
+ * The graph as RDF/JS quads (`@rdfjs/types`), all in the default graph, for N3.js, Comunica,
+ * Oxigraph or rdf-ext. List cells are blank nodes labelled `l0`, `l1`, … in the order written.
+ */
+export declare function toQuads(graph: StateGraph): RDF.Quad[];
+/** A string's characters escaped for a double-quoted N-Triples or Turtle literal. */
+export declare const escapeLiteral: (value: string) => string;
+/** N-Quads (RDF 1.1), one statement per line, in the order of `toQuads`. */
+export declare function toNQuads(graph: StateGraph): string;
+//# sourceMappingURL=quads.d.ts.map

package/dist/quads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quads.d.ts","sourceRoot":"","sources":["../src/quads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAA;AACxC,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,YAAY,CAAA;AAyEvD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAyBrD;AAED,qFAAqF;AACrF,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,MAC8D,CAAA;AAY5G,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAIlD"}

package/dist/shacl.d.ts

@@ -0,0 +1,17 @@
+import { type RdfLens } from './lens.js';
+export type ShaclOptions = {
+    /** Base of the protocol IRIs, as given to the export. Default PROVISIONAL_BASE_IRI. */
+    base?: string;
+};
+/**
+ * SHACL 2017 shapes in Turtle for state graphs exported with `lens`: one `sh:NodeShape` per model,
+ * targeting the class the export gives its seeds (the mapped term, else `{base}c/{model}`), with a
+ * property shape per property on the predicate the export uses. Text, Number, Boolean and Date
+ * values get `sh:datatype` (a Number any of `xsd:integer`, `xsd:decimal` or `xsd:double`), and every
+ * property `sh:maxCount 1`. Relations, Image, File, Html and Json values must be IRIs; their class
+ * isn't checked, because the related seed is often not in the export. A List is checked as a
+ * well-formed `rdf:List`, and a List of relations' members must be IRIs. `required: true` adds
+ * `sh:minCount 1`. Pass a sidecar with no `terms` for shapes over the protocol IRIs.
+ */
+export declare function toShacl(lens: RdfLens, options?: ShaclOptions): string;
+//# sourceMappingURL=shacl.d.ts.map

package/dist/shacl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shacl.d.ts","sourceRoot":"","sources":["../src/shacl.ts"],"names":[],"mappings":"AAGA,OAAO,EAA0C,KAAK,OAAO,EAAE,MAAM,WAAW,CAAA;AAoBhF,MAAM,MAAM,YAAY,GAAG;IACzB,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,MAAM,CA6DzE"}

package/dist/sidecar-BjHSnqHK.js

@@ -0,0 +1,255 @@
+import { listRelationEasName as e } from "@seedprotocol/query";
+import { easName as t, fuzzyNameKey as n, isNameMatchLevel as r, matchEasName as i } from "@seedprotocol/eas";
+//#region src/iri.ts
+var a = "https://w3id.org/seedprotocol/", o = "http://www.w3.org/1999/02/22-rdf-syntax-ns#", s = "http://www.w3.org/2001/XMLSchema#", c = "http://www.w3.org/ns/prov#", l = `${o}type`, u = `${o}first`, d = `${o}rest`, f = `${o}nil`, p = /[\u0000- <>"{}|^`\\]/;
+function m(e, t) {
+	if (!/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(e) || p.test(e)) throw TypeError(`${t} is not an absolute IRI: ${JSON.stringify(e)}`);
+	return e;
+}
+function h(e, t = a) {
+	if (!Number.isSafeInteger(e) || e <= 0) throw TypeError(`chainId must be a positive integer, got ${e}`);
+	if (m(t, "base"), !t.endsWith("/")) throw TypeError(`base must end with "/": ${t}`);
+	let n = (e) => encodeURIComponent(e);
+	return {
+		base: t,
+		chainId: e,
+		seed: `${t}ns#`,
+		attestation: (r) => `${t}eas/${e}/${n(r.toLowerCase())}`,
+		modelClass: (e) => `${t}c/${n(e)}`,
+		property: (e, r) => `${t}p/${n(e)}/${n(r)}`,
+		account: (t) => `did:pkh:eip155:${e}:${n(t.toLowerCase())}`
+	};
+}
+//#endregion
+//#region src/lens.ts
+var g = (e) => JSON.stringify(e, (e, t) => t && typeof t == "object" && !Array.isArray(t) ? Object.fromEntries(Object.entries(t).sort(([e], [t]) => e < t ? -1 : +(e > t))) : t), _ = /* @__PURE__ */ new Set([
+	"relation",
+	"image",
+	"file",
+	"html",
+	"json",
+	"blob"
+]), v = (...e) => e.find((e) => r(e));
+function y(e) {
+	let t = /* @__PURE__ */ new Map();
+	for (let [n, r] of Object.entries(e["@context"] ?? {})) !n.startsWith("@") && typeof r == "string" && t.set(n, r);
+	return t;
+}
+function b(e, t) {
+	let n = e.indexOf(":"), r = n > 0 ? t.get(e.slice(0, n)) : void 0, i = r === void 0 ? e : r + e.slice(n + 1);
+	if (r !== void 0 || /^(?:[a-zA-Z][a-zA-Z0-9+.-]*:\/\/|urn:)/.test(e)) try {
+		return m(i, "term");
+	} catch {
+		return;
+	}
+}
+function x({ schema: n, sidecar: r }) {
+	if (!n.id || n.id !== r.schemaId) throw TypeError(`The sidecar is for schema ${r.schemaId}, not ${n.id ?? "a schema with no id"}`);
+	let a = y(r), o = [], s = new Set(Object.keys(r.terms)), c = (e) => {
+		if (!e || r.terms[e] === void 0) return;
+		s.delete(e);
+		let t = b(r.terms[e], a);
+		return t || o.push(`Term "${r.terms[e]}" for ${e} isn't an IRI or a name with a known prefix`), t;
+	}, l = Object.entries(n.models).map(([r, i]) => {
+		let a = Object.entries(i.properties).map(([r, a]) => {
+			let o = (a.type ?? a.dataType ?? "").toLowerCase(), s = a.ref ?? a.refModelName;
+			return {
+				value: {
+					term: c(a.id),
+					dataType: o
+				},
+				name: o === "list" && s ? e(r, s) : t(r),
+				relation: _.has(o) || o === "list" && !!s,
+				level: v(a.nameMatch, i.nameMatch, n.nameMatch)
+			};
+		});
+		return {
+			value: {
+				term: c(i.id),
+				candidates: a
+			},
+			name: t(r),
+			level: v(i.nameMatch, n.nameMatch)
+		};
+	});
+	for (let e of s) o.push(`Term "${r.terms[e]}" names ${e}, which is no model or property in the schema`);
+	let u = (e) => {
+		o.includes(e) || o.push(e);
+	}, d = (e) => {
+		let t = i(e, l);
+		return t.kind === "ambiguous" && u(`Model "${e}" matches several models in the schema`), t.kind === "match" ? t.value : void 0;
+	};
+	return {
+		prefixes: a,
+		warnings: o,
+		classOf: (e) => d(e)?.term,
+		propertyOf(e, t) {
+			let n = d(e);
+			if (!n) return;
+			let r = i(t, n.candidates);
+			return r.kind === "ambiguous" && u(`Property "${t}" of ${e} matches several properties in the schema`), r.kind === "match" ? r.value : void 0;
+		}
+	};
+}
+//#endregion
+//#region src/sidecar.ts
+function S({ schema: e, sidecar: n }, r = {}) {
+	let i = y(n), a = (e) => {
+		let t = e ? n.terms[e] : void 0;
+		return t !== void 0 && b(t, i) ? t : void 0;
+	}, o = { "@version": 1.1 };
+	for (let [e, t] of Object.entries(n["@context"] ?? {})) (e.startsWith("@") || typeof t == "string") && (o[e] = t);
+	for (let [n, i] of Object.entries(e.models)) {
+		let e = {};
+		for (let [t, n] of Object.entries(i.properties)) {
+			let r = a(n.id);
+			if (!r) continue;
+			let i = (n.type ?? n.dataType ?? "").toLowerCase(), o = n.ref ?? n.refModelName, c = { "@id": r };
+			(_.has(i) || i === "list" && o) && (c["@type"] = "@id"), i === "date" && (c["@type"] = `${s}dateTime`), i === "list" && (c["@container"] = "@list"), e[t] = Object.keys(c).length === 1 ? r : c;
+		}
+		let c = a(i.id);
+		(c || Object.keys(e).length !== 0) && (n in o || (o[n] = {
+			"@id": c ?? h(1, r.base).modelClass(t(n)),
+			...Object.keys(e).length > 0 && { "@context": e }
+		}));
+	}
+	return o;
+}
+function C(e) {
+	return Object.entries(e.models).flatMap(([e, { id: t, properties: n }]) => [{
+		model: e,
+		id: t
+	}, ...Object.entries(n).map(([t, { id: n }]) => ({
+		model: e,
+		property: t,
+		id: n
+	}))]);
+}
+function w({ schema: e, sidecar: t }) {
+	if (!e.id || e.id !== t.schemaId) throw TypeError(`The sidecar is for schema ${t.schemaId}, not ${e.id ?? "a schema with no id"}`);
+}
+function T(e, t = {}) {
+	w(e);
+	let { schema: n, sidecar: r } = e, i = C(n), a = new Set(i.flatMap((e) => e.id ? [e.id] : [])), o = y(r), s = Object.entries(r.terms).map(([e, t]) => ({
+		id: e,
+		term: t
+	}));
+	return {
+		stale: s.filter(({ id: e }) => !a.has(e)),
+		invalid: s.filter(({ id: e, term: t }) => a.has(e) && !b(t, o)),
+		unmapped: i.filter((e) => !e.id || r.terms[e.id] === void 0),
+		contextOutdated: g(r["@context"] ?? {}) !== g(S(e, t)),
+		versionOutdated: n.version !== void 0 && r.schemaVersion !== n.version
+	};
+}
+function E(e, t = {}) {
+	w(e);
+	let { schema: n, sidecar: r } = e, { schemaId: i, schemaVersion: a, terms: o, "@context": s, ...c } = r;
+	return {
+		schemaId: i,
+		...n.version === void 0 ? a !== void 0 && { schemaVersion: a } : { schemaVersion: n.version },
+		...c,
+		terms: o,
+		"@context": S(e, t)
+	};
+}
+var D = {
+	schema: "https://schema.org/",
+	dcterms: "http://purl.org/dc/terms/"
+}, O = (e, t = !1) => Object.fromEntries(Object.entries(e).map(([e, r]) => [n(e, { relation: t }), r])), k = O({
+	post: "schema:BlogPosting",
+	blogpost: "schema:BlogPosting",
+	article: "schema:Article",
+	newsarticle: "schema:NewsArticle",
+	page: "schema:WebPage",
+	person: "schema:Person",
+	organization: "schema:Organization",
+	event: "schema:Event",
+	place: "schema:Place",
+	image: "schema:ImageObject",
+	video: "schema:VideoObject",
+	podcast: "schema:PodcastSeries",
+	episode: "schema:Episode",
+	book: "schema:Book",
+	comment: "schema:Comment"
+}), A = O({
+	title: "dcterms:title",
+	headline: "schema:headline",
+	name: "schema:name",
+	summary: "dcterms:abstract",
+	abstract: "dcterms:abstract",
+	excerpt: "dcterms:abstract",
+	description: "dcterms:description",
+	subtitle: "schema:alternativeHeadline",
+	language: "dcterms:language",
+	lang: "dcterms:language",
+	license: "dcterms:license",
+	url: "schema:url",
+	link: "schema:url",
+	canonicalurl: "schema:url",
+	email: "schema:email",
+	keyword: "schema:keywords",
+	body: "schema:text",
+	content: "schema:text",
+	text: "schema:text"
+}), j = O({
+	publishedat: "dcterms:issued",
+	datepublished: "dcterms:issued",
+	publishdate: "dcterms:issued",
+	issued: "dcterms:issued",
+	createdat: "dcterms:created",
+	created: "dcterms:created",
+	updatedat: "dcterms:modified",
+	modifiedat: "dcterms:modified",
+	modified: "dcterms:modified",
+	startdate: "schema:startDate",
+	enddate: "schema:endDate"
+}), M = O({
+	author: "dcterms:creator",
+	creator: "dcterms:creator",
+	byline: "dcterms:creator",
+	contributor: "dcterms:contributor",
+	publisher: "dcterms:publisher",
+	editor: "schema:editor",
+	image: "schema:image",
+	coverimage: "schema:image",
+	featuredimage: "schema:image",
+	cover: "schema:image",
+	thumbnail: "schema:thumbnail",
+	html: "schema:text",
+	body: "schema:text",
+	content: "schema:text",
+	tag: "dcterms:subject",
+	category: "dcterms:subject",
+	categories: "dcterms:subject",
+	topic: "dcterms:subject",
+	source: "dcterms:source",
+	file: "schema:associatedMedia"
+}, !0);
+function N(e) {
+	w(e);
+	let { schema: t, sidecar: r } = e, i = [];
+	for (let [e, { id: a, properties: o }] of Object.entries(t.models)) {
+		let t = k[n(e)];
+		a && r.terms[a] === void 0 && t && i.push({
+			model: e,
+			id: a,
+			term: t
+		});
+		for (let [t, a] of Object.entries(o)) {
+			if (!a.id || r.terms[a.id] !== void 0) continue;
+			let o = (a.type ?? a.dataType ?? "").toLowerCase(), s = _.has(o) || o === "list" && !!(a.ref ?? a.refModelName), c = n(t, { relation: s }), l = s ? M[c] : o === "date" ? j[c] : o === "text" ? A[c] : void 0;
+			l && i.push({
+				model: e,
+				property: t,
+				id: a.id,
+				term: l
+			});
+		}
+	}
+	return i;
+}
+//#endregion
+export { l as _, E as a, h as b, x as c, c as d, a as f, d as g, f as h, N as i, b as l, u as m, T as n, _ as o, o as p, S as r, g as s, D as t, y as u, s as v, m as y };
+
+//# sourceMappingURL=sidecar-BjHSnqHK.js.map

package/dist/sidecar-BjHSnqHK.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar-BjHSnqHK.js","names":["PROVISIONAL_BASE_IRI","RDF","XSD","PROV","RDF_TYPE","RDF_FIRST","RDF_REST","RDF_NIL","INVALID_IRI","assertIri","iri","what","iriScheme","chainId","base","segment","s","uid","modelType","easType","easName","address","canonicalJson","value","v","a","b","RELATION_TYPES","level","values","isNameMatchLevel","prefixesOf","prefixes","prefix","sidecar","expandTerm","colon","term","expanded","compileLens","schema","warnings","unused","termOf","id","models","modelName","model","candidates","key","property","dataType","ref","listRelationEasName","warnOnce","message","modelOf","match","matchEasName","easPropertyName","sidecarContext","usable","context","scoped","entry","options","targets","properties","assertSameSchema","checkSidecar","lens","all","ids","t","terms","syncSidecar","_context","rest","schemaVersion","SUGGESTED_PREFIXES","keyed","name","fuzzyNameKey","MODEL_TERMS","TEXT_TERMS","DATE_TERMS","RELATION_TERMS","suggestTerms","suggestions","modelTerm","definition","relation"],"sources":["../src/iri.ts","../src/lens.ts","../src/sidecar.ts"],"sourcesContent":["/**\n * Base of every IRI the export mints. Provisional: the permanent namespace (w3id.org, see the RDF\n * plan) isn't registered yet, so don't publish exports that use it anywhere they can't be\n * replaced, such as an archive on Arweave.\n */\nexport const PROVISIONAL_BASE_IRI = 'https://w3id.org/seedprotocol/'\n\nexport const RDF = 'http://www.w3.org/1999/02/22-rdf-syntax-ns#'\nexport const XSD = 'http://www.w3.org/2001/XMLSchema#'\nexport const PROV = 'http://www.w3.org/ns/prov#'\n\nexport const RDF_TYPE = `${RDF}type`\nexport const RDF_FIRST = `${RDF}first`\nexport const RDF_REST = `${RDF}rest`\nexport const RDF_NIL = `${RDF}nil`\n\n// Characters N-Triples and Turtle don't allow in an IRIREF, plus controls and space.\nconst INVALID_IRI = /[\\u0000- <>\"{}|^`\\\\]/\n\n/** Throws when `iri` can't be written as an IRI in N-Quads, Turtle or JSON-LD. */\nexport function assertIri(iri: string, what: string): string {\n  if (!/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(iri) || INVALID_IRI.test(iri)) {\n    throw new TypeError(`${what} is not an absolute IRI: ${JSON.stringify(iri)}`)\n  }\n  return iri\n}\n\n/** The IRIs one export uses, from its base and chain. */\nexport type IriScheme = {\n  readonly base: string\n  readonly chainId: number\n  /** The Seed vocabulary namespace, `{base}ns#`. */\n  readonly seed: string\n  /** A Seed, Version or other attestation on this chain. */\n  attestation(uid: string): string\n  /** The class for an on-chain model type (the Seed schema `bytes32 <model>`). */\n  modelClass(modelType: string): string\n  /** The predicate for an on-chain property schema `<easType> <easName>`. */\n  property(easType: string, easName: string): string\n  /** An attester address as a CAIP-10 `did:pkh`. */\n  account(address: string): string\n}\n\nexport function iriScheme(chainId: number, base: string = PROVISIONAL_BASE_IRI): IriScheme {\n  if (!Number.isSafeInteger(chainId) || chainId <= 0) {\n    throw new TypeError(`chainId must be a positive integer, got ${chainId}`)\n  }\n  assertIri(base, 'base')\n  if (!base.endsWith('/')) throw new TypeError(`base must end with \"/\": ${base}`)\n  const segment = (s: string) => encodeURIComponent(s)\n  return {\n    base,\n    chainId,\n    seed: `${base}ns#`,\n    attestation: (uid) => `${base}eas/${chainId}/${segment(uid.toLowerCase())}`,\n    modelClass: (modelType) => `${base}c/${segment(modelType)}`,\n    property: (easType, easName) => `${base}p/${segment(easType)}/${segment(easName)}`,\n    account: (address) => `did:pkh:eip155:${chainId}:${segment(address.toLowerCase())}`,\n  }\n}\n","import { easName, isNameMatchLevel, matchEasName, type NameMatchLevel } from '@seedprotocol/eas'\nimport { listRelationEasName } from '@seedprotocol/query'\nimport { assertIri } from './iri.js'\n\ntype LensProperty = {\n  readonly id?: string\n  readonly type?: string\n  readonly dataType?: string\n  readonly ref?: string\n  readonly refModelName?: string\n  readonly nameMatch?: string\n  readonly [key: string]: unknown\n}\n\ntype LensModel = {\n  readonly id?: string\n  readonly nameMatch?: string\n  readonly properties: { readonly [propertyName: string]: LensProperty }\n}\n\n/** As much of a schema file as the lens reads. A `SchemaFileFormat` can be passed as it is. */\nexport type LensSchema = {\n  readonly id?: string\n  readonly nameMatch?: string\n  readonly models: { readonly [modelName: string]: LensModel }\n}\n\n/**\n * What an app says its models and properties mean. `terms` is keyed by model or property id, which\n * survive renames, so no older schema file is needed. Each term is a prefixed name or an absolute\n * IRI; prefixes come from the top level of `@context`.\n */\nexport type RdfSidecar = {\n  /** The schema these terms were written for. Must equal the schema's `id`. */\n  readonly schemaId: string\n  /** The schema `version` the sidecar was last synced with. Informational: terms are read by id. */\n  readonly schemaVersion?: number\n  readonly '@context'?: { readonly [prefix: string]: unknown }\n  readonly terms: { readonly [id: string]: string }\n}\n\n/** JSON with object keys sorted, so key order doesn't change it. */\nexport const canonicalJson = (value: unknown): string =>\n  JSON.stringify(value, (_key, v) =>\n    v && typeof v === 'object' && !Array.isArray(v) ? Object.fromEntries(Object.entries(v).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))) : v,\n  )\n\nexport type RdfLens = {\n  readonly schema: LensSchema\n  readonly sidecar: RdfSidecar\n}\n\ntype PropertyEntry = { readonly term?: string; readonly dataType: string }\ntype ModelEntry = {\n  readonly term?: string\n  readonly candidates: readonly { value: PropertyEntry; name: string; relation: boolean; level?: NameMatchLevel }[]\n}\n\n/** How a lens reads one export's seeds and properties. */\nexport type CompiledLens = {\n  readonly prefixes: ReadonlyMap<string, string>\n  readonly warnings: string[]\n  /** The class term of a seed's on-chain model, if the lens maps it. */\n  classOf(modelType: string): string | undefined\n  /** The local data type and term of an on-chain property of a model. */\n  propertyOf(modelType: string, easPropertyName: string): PropertyEntry | undefined\n}\n\nexport const RELATION_TYPES = new Set(['relation', 'image', 'file', 'html', 'json', 'blob'])\n\nconst level = (...values: (string | undefined)[]): NameMatchLevel | undefined =>\n  values.find((value): value is NameMatchLevel => isNameMatchLevel(value))\n\nexport function prefixesOf(sidecar: RdfSidecar): Map<string, string> {\n  const prefixes = new Map<string, string>()\n  for (const [prefix, value] of Object.entries(sidecar['@context'] ?? {})) {\n    if (!prefix.startsWith('@') && typeof value === 'string') prefixes.set(prefix, value)\n  }\n  return prefixes\n}\n\n/** The absolute IRI of a term, or undefined when it can't be read. */\nexport function expandTerm(term: string, prefixes: ReadonlyMap<string, string>): string | undefined {\n  const colon = term.indexOf(':')\n  const prefix = colon > 0 ? prefixes.get(term.slice(0, colon)) : undefined\n  const expanded = prefix !== undefined ? prefix + term.slice(colon + 1) : term\n  if (prefix === undefined && !/^(?:[a-zA-Z][a-zA-Z0-9+.-]*:\\/\\/|urn:)/.test(term)) return undefined\n  try {\n    return assertIri(expanded, 'term')\n  } catch {\n    return undefined\n  }\n}\n\n/**\n * Reads a lens for one export. A sidecar written for another schema throws; a term that matches no\n * model or property, or can't be expanded, is a warning, and the export uses the protocol IRI.\n */\nexport function compileLens({ schema, sidecar }: RdfLens): CompiledLens {\n  if (!schema.id || schema.id !== sidecar.schemaId) {\n    throw new TypeError(`The sidecar is for schema ${sidecar.schemaId}, not ${schema.id ?? 'a schema with no id'}`)\n  }\n  const prefixes = prefixesOf(sidecar)\n  const warnings: string[] = []\n  const unused = new Set(Object.keys(sidecar.terms))\n  const termOf = (id: string | undefined): string | undefined => {\n    if (!id || sidecar.terms[id] === undefined) return undefined\n    unused.delete(id)\n    const expanded = expandTerm(sidecar.terms[id]!, prefixes)\n    if (!expanded) warnings.push(`Term \"${sidecar.terms[id]}\" for ${id} isn't an IRI or a name with a known prefix`)\n    return expanded\n  }\n\n  const models = Object.entries(schema.models).map(([modelName, model]) => {\n    const candidates = Object.entries(model.properties).map(([key, property]) => {\n      const dataType = (property.type ?? property.dataType ?? '').toLowerCase()\n      const ref = property.ref ?? property.refModelName\n      return {\n        value: { term: termOf(property.id), dataType },\n        name: dataType === 'list' && ref ? listRelationEasName(key, ref) : easName(key),\n        relation: RELATION_TYPES.has(dataType) || (dataType === 'list' && !!ref),\n        level: level(property.nameMatch, model.nameMatch, schema.nameMatch),\n      }\n    })\n    const entry: ModelEntry = { term: termOf(model.id), candidates }\n    return { value: entry, name: easName(modelName), level: level(model.nameMatch, schema.nameMatch) }\n  })\n  for (const id of unused) warnings.push(`Term \"${sidecar.terms[id]}\" names ${id}, which is no model or property in the schema`)\n\n  const warnOnce = (message: string) => {\n    if (!warnings.includes(message)) warnings.push(message)\n  }\n  const modelOf = (modelType: string): ModelEntry | undefined => {\n    const match = matchEasName(modelType, models)\n    if (match.kind === 'ambiguous') warnOnce(`Model \"${modelType}\" matches several models in the schema`)\n    return match.kind === 'match' ? match.value : undefined\n  }\n\n  return {\n    prefixes,\n    warnings,\n    classOf: (modelType) => modelOf(modelType)?.term,\n    propertyOf(modelType, easPropertyName) {\n      const model = modelOf(modelType)\n      if (!model) return undefined\n      const match = matchEasName(easPropertyName, model.candidates)\n      if (match.kind === 'ambiguous') warnOnce(`Property \"${easPropertyName}\" of ${modelType} matches several properties in the schema`)\n      return match.kind === 'match' ? match.value : undefined\n    },\n  }\n}\n","import { easName, fuzzyNameKey } from '@seedprotocol/eas'\nimport { XSD, iriScheme } from './iri.js'\nimport { RELATION_TYPES, canonicalJson, expandTerm, prefixesOf, type RdfLens, type RdfSidecar } from './lens.js'\n\nexport type SidecarContextOptions = {\n  /** Base of the protocol class for a model whose properties are mapped but which isn't. Default PROVISIONAL_BASE_IRI. */\n  base?: string\n}\n\ntype ContextEntry = string | { readonly [key: string]: string | ContextEntry }\nexport type SidecarContext = { readonly [key: string]: unknown }\n\n/**\n * The sidecar's `@context` regenerated from its `terms` and the schema's current names: its\n * keywords and prefixes as they are, then one type-scoped entry per model that has a term or a\n * mapped property. A relation gets `\"@type\": \"@id\"`, a List `\"@container\": \"@list\"`, a Date\n * `xsd:dateTime`. A model without a term keeps its protocol class. Terms that can't be expanded are\n * left out.\n */\nexport function sidecarContext({ schema, sidecar }: RdfLens, options: SidecarContextOptions = {}): SidecarContext {\n  const prefixes = prefixesOf(sidecar)\n  const usable = (id: string | undefined): string | undefined => {\n    const term = id ? sidecar.terms[id] : undefined\n    return term !== undefined && expandTerm(term, prefixes) ? term : undefined\n  }\n  const context: Record<string, unknown> = { '@version': 1.1 }\n  for (const [key, value] of Object.entries(sidecar['@context'] ?? {})) {\n    if (key.startsWith('@') || typeof value === 'string') context[key] = value\n  }\n\n  for (const [modelName, model] of Object.entries(schema.models)) {\n    const scoped: Record<string, ContextEntry> = {}\n    for (const [key, property] of Object.entries(model.properties)) {\n      const term = usable(property.id)\n      if (!term) continue\n      const dataType = (property.type ?? property.dataType ?? '').toLowerCase()\n      const ref = property.ref ?? property.refModelName\n      const entry: Record<string, string> = { '@id': term }\n      if (RELATION_TYPES.has(dataType) || (dataType === 'list' && ref)) entry['@type'] = '@id'\n      if (dataType === 'date') entry['@type'] = `${XSD}dateTime`\n      if (dataType === 'list') entry['@container'] = '@list'\n      scoped[key] = Object.keys(entry).length === 1 ? term : entry\n    }\n    const term = usable(model.id)\n    if (!term && Object.keys(scoped).length === 0) continue\n    if (modelName in context) continue\n    context[modelName] = {\n      '@id': term ?? iriScheme(1, options.base).modelClass(easName(modelName)),\n      ...(Object.keys(scoped).length > 0 && { '@context': scoped }),\n    }\n  }\n  return context\n}\n\n/** A model, or a property of one, that `terms` can name. */\nexport type SchemaTarget = { readonly model: string; readonly property?: string; readonly id?: string }\n\nexport type SidecarReport = {\n  /** Terms whose id is no model or property in the schema, as after a deletion. */\n  readonly stale: readonly { readonly id: string; readonly term: string }[]\n  /** Terms that aren't an IRI or a name with a prefix in `@context`. */\n  readonly invalid: readonly { readonly id: string; readonly term: string }[]\n  /** Models and properties with no term. One without an `id` can't be mapped until the schema assigns it one. */\n  readonly unmapped: readonly SchemaTarget[]\n  /** `@context` differs from {@link sidecarContext}, as after a rename: `syncSidecar` rewrites it. */\n  readonly contextOutdated: boolean\n  /** `schemaVersion` differs from the schema's `version`. */\n  readonly versionOutdated: boolean\n}\n\n/** A schema as the sidecar tools read it: the lens's, plus its version. */\nexport type SidecarSchema = RdfLens['schema'] & { readonly version?: number }\n\nfunction targets(schema: SidecarSchema): SchemaTarget[] {\n  return Object.entries(schema.models).flatMap(([model, { id, properties }]) => [\n    { model, id },\n    ...Object.entries(properties).map(([property, { id }]) => ({ model, property, id })),\n  ])\n}\n\nfunction assertSameSchema({ schema, sidecar }: RdfLens): void {\n  if (!schema.id || schema.id !== sidecar.schemaId) {\n    throw new TypeError(`The sidecar is for schema ${sidecar.schemaId}, not ${schema.id ?? 'a schema with no id'}`)\n  }\n}\n\n/** What's out of date in a sidecar against its schema. Throws when it was written for another schema. */\nexport function checkSidecar(\n  lens: { readonly schema: SidecarSchema; readonly sidecar: RdfSidecar },\n  options: SidecarContextOptions = {},\n): SidecarReport {\n  assertSameSchema(lens)\n  const { schema, sidecar } = lens\n  const all = targets(schema)\n  const ids = new Set(all.flatMap((t) => (t.id ? [t.id] : [])))\n  const prefixes = prefixesOf(sidecar)\n  const terms = Object.entries(sidecar.terms).map(([id, term]) => ({ id, term }))\n  return {\n    stale: terms.filter(({ id }) => !ids.has(id)),\n    invalid: terms.filter(({ id, term }) => ids.has(id) && !expandTerm(term, prefixes)),\n    unmapped: all.filter((t) => !t.id || sidecar.terms[t.id] === undefined),\n    contextOutdated: canonicalJson(sidecar['@context'] ?? {}) !== canonicalJson(sidecarContext(lens, options)),\n    versionOutdated: schema.version !== undefined && sidecar.schemaVersion !== schema.version,\n  }\n}\n\n/**\n * The sidecar with `@context` regenerated by {@link sidecarContext} and `schemaVersion` set to the\n * schema's `version`. `terms` is kept as it is, stale ones too: removing a mapping is the\n * developer's call.\n */\nexport function syncSidecar(\n  lens: { readonly schema: SidecarSchema; readonly sidecar: RdfSidecar },\n  options: SidecarContextOptions = {},\n): RdfSidecar {\n  assertSameSchema(lens)\n  const { schema, sidecar } = lens\n  const { schemaId, schemaVersion, terms, '@context': _context, ...rest } = sidecar\n  return {\n    schemaId,\n    ...(schema.version !== undefined ? { schemaVersion: schema.version } : schemaVersion !== undefined && { schemaVersion }),\n    ...rest,\n    terms,\n    '@context': sidecarContext(lens, options),\n  }\n}\n\nexport const SUGGESTED_PREFIXES = { schema: 'https://schema.org/', dcterms: 'http://purl.org/dc/terms/' } as const\n\n// Kept to names whose meaning rarely varies; anything else is left to the developer.\ntype Terms = { readonly [name: string]: string }\n// The tables by the fuzzy key a name is looked up by.\nconst keyed = (terms: Terms, relation = false): Terms =>\n  Object.fromEntries(Object.entries(terms).map(([name, term]) => [fuzzyNameKey(name, { relation }), term]))\n\nconst MODEL_TERMS = keyed({\n  post: 'schema:BlogPosting',\n  blogpost: 'schema:BlogPosting',\n  article: 'schema:Article',\n  newsarticle: 'schema:NewsArticle',\n  page: 'schema:WebPage',\n  person: 'schema:Person',\n  organization: 'schema:Organization',\n  event: 'schema:Event',\n  place: 'schema:Place',\n  image: 'schema:ImageObject',\n  video: 'schema:VideoObject',\n  podcast: 'schema:PodcastSeries',\n  episode: 'schema:Episode',\n  book: 'schema:Book',\n  comment: 'schema:Comment',\n})\nconst TEXT_TERMS = keyed({\n  title: 'dcterms:title',\n  headline: 'schema:headline',\n  name: 'schema:name',\n  summary: 'dcterms:abstract',\n  abstract: 'dcterms:abstract',\n  excerpt: 'dcterms:abstract',\n  description: 'dcterms:description',\n  subtitle: 'schema:alternativeHeadline',\n  language: 'dcterms:language',\n  lang: 'dcterms:language',\n  license: 'dcterms:license',\n  url: 'schema:url',\n  link: 'schema:url',\n  canonicalurl: 'schema:url',\n  email: 'schema:email',\n  keyword: 'schema:keywords',\n  body: 'schema:text',\n  content: 'schema:text',\n  text: 'schema:text',\n})\nconst DATE_TERMS = keyed({\n  publishedat: 'dcterms:issued',\n  datepublished: 'dcterms:issued',\n  publishdate: 'dcterms:issued',\n  issued: 'dcterms:issued',\n  createdat: 'dcterms:created',\n  created: 'dcterms:created',\n  updatedat: 'dcterms:modified',\n  modifiedat: 'dcterms:modified',\n  modified: 'dcterms:modified',\n  startdate: 'schema:startDate',\n  enddate: 'schema:endDate',\n})\nconst RELATION_TERMS = keyed(\n  {\n  author: 'dcterms:creator',\n  creator: 'dcterms:creator',\n  byline: 'dcterms:creator',\n  contributor: 'dcterms:contributor',\n  publisher: 'dcterms:publisher',\n  editor: 'schema:editor',\n  image: 'schema:image',\n  coverimage: 'schema:image',\n  featuredimage: 'schema:image',\n  cover: 'schema:image',\n  thumbnail: 'schema:thumbnail',\n  html: 'schema:text',\n  body: 'schema:text',\n  content: 'schema:text',\n  tag: 'dcterms:subject',\n  category: 'dcterms:subject',\n  categories: 'dcterms:subject',\n  topic: 'dcterms:subject',\n  source: 'dcterms:source',\n  file: 'schema:associatedMedia',\n  },\n  true,\n)\n\nexport type TermSuggestion = SchemaTarget & { readonly id: string; readonly term: string }\n\n/**\n * Draft schema.org and dcterms terms for the unmapped models and properties whose names have a\n * common meaning (`title`, `summary`, `author`, `publishedAt`, `coverImage`), for the developer to\n * review. Names it doesn't know, and models or properties without an id, get no suggestion. The\n * terms use the prefixes in {@link SUGGESTED_PREFIXES}.\n */\nexport function suggestTerms(lens: { readonly schema: SidecarSchema; readonly sidecar: RdfSidecar }): TermSuggestion[] {\n  assertSameSchema(lens)\n  const { schema, sidecar } = lens\n  const suggestions: TermSuggestion[] = []\n  for (const [model, { id, properties }] of Object.entries(schema.models)) {\n    const modelTerm = MODEL_TERMS[fuzzyNameKey(model)]\n    if (id && sidecar.terms[id] === undefined && modelTerm) suggestions.push({ model, id, term: modelTerm })\n    for (const [property, definition] of Object.entries(properties)) {\n      if (!definition.id || sidecar.terms[definition.id] !== undefined) continue\n      const dataType = (definition.type ?? definition.dataType ?? '').toLowerCase()\n      const relation = RELATION_TYPES.has(dataType) || (dataType === 'list' && !!(definition.ref ?? definition.refModelName))\n      const key = fuzzyNameKey(property, { relation })\n      const term = relation ? RELATION_TERMS[key] : dataType === 'date' ? DATE_TERMS[key] : dataType === 'text' ? TEXT_TERMS[key] : undefined\n      if (term) suggestions.push({ model, property, id: definition.id, term })\n    }\n  }\n  return suggestions\n}\n"],"mappings":"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"}

package/dist/sidecar.d.ts

@@ -0,0 +1,77 @@
+import { type RdfLens, type RdfSidecar } from './lens.js';
+export type SidecarContextOptions = {
+    /** Base of the protocol class for a model whose properties are mapped but which isn't. Default PROVISIONAL_BASE_IRI. */
+    base?: string;
+};
+export type SidecarContext = {
+    readonly [key: string]: unknown;
+};
+/**
+ * The sidecar's `@context` regenerated from its `terms` and the schema's current names: its
+ * keywords and prefixes as they are, then one type-scoped entry per model that has a term or a
+ * mapped property. A relation gets `"@type": "@id"`, a List `"@container": "@list"`, a Date
+ * `xsd:dateTime`. A model without a term keeps its protocol class. Terms that can't be expanded are
+ * left out.
+ */
+export declare function sidecarContext({ schema, sidecar }: RdfLens, options?: SidecarContextOptions): SidecarContext;
+/** A model, or a property of one, that `terms` can name. */
+export type SchemaTarget = {
+    readonly model: string;
+    readonly property?: string;
+    readonly id?: string;
+};
+export type SidecarReport = {
+    /** Terms whose id is no model or property in the schema, as after a deletion. */
+    readonly stale: readonly {
+        readonly id: string;
+        readonly term: string;
+    }[];
+    /** Terms that aren't an IRI or a name with a prefix in `@context`. */
+    readonly invalid: readonly {
+        readonly id: string;
+        readonly term: string;
+    }[];
+    /** Models and properties with no term. One without an `id` can't be mapped until the schema assigns it one. */
+    readonly unmapped: readonly SchemaTarget[];
+    /** `@context` differs from {@link sidecarContext}, as after a rename: `syncSidecar` rewrites it. */
+    readonly contextOutdated: boolean;
+    /** `schemaVersion` differs from the schema's `version`. */
+    readonly versionOutdated: boolean;
+};
+/** A schema as the sidecar tools read it: the lens's, plus its version. */
+export type SidecarSchema = RdfLens['schema'] & {
+    readonly version?: number;
+};
+/** What's out of date in a sidecar against its schema. Throws when it was written for another schema. */
+export declare function checkSidecar(lens: {
+    readonly schema: SidecarSchema;
+    readonly sidecar: RdfSidecar;
+}, options?: SidecarContextOptions): SidecarReport;
+/**
+ * The sidecar with `@context` regenerated by {@link sidecarContext} and `schemaVersion` set to the
+ * schema's `version`. `terms` is kept as it is, stale ones too: removing a mapping is the
+ * developer's call.
+ */
+export declare function syncSidecar(lens: {
+    readonly schema: SidecarSchema;
+    readonly sidecar: RdfSidecar;
+}, options?: SidecarContextOptions): RdfSidecar;
+export declare const SUGGESTED_PREFIXES: {
+    readonly schema: "https://schema.org/";
+    readonly dcterms: "http://purl.org/dc/terms/";
+};
+export type TermSuggestion = SchemaTarget & {
+    readonly id: string;
+    readonly term: string;
+};
+/**
+ * Draft schema.org and dcterms terms for the unmapped models and properties whose names have a
+ * common meaning (`title`, `summary`, `author`, `publishedAt`, `coverImage`), for the developer to
+ * review. Names it doesn't know, and models or properties without an id, get no suggestion. The
+ * terms use the prefixes in {@link SUGGESTED_PREFIXES}.
+ */
+export declare function suggestTerms(lens: {
+    readonly schema: SidecarSchema;
+    readonly sidecar: RdfSidecar;
+}): TermSuggestion[];
+//# sourceMappingURL=sidecar.d.ts.map

package/dist/sidecar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../src/sidecar.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyD,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAEhH,MAAM,MAAM,qBAAqB,GAAG;IAClC,wHAAwH;IACxH,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAGD,MAAM,MAAM,cAAc,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAA;AAEhE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,GAAE,qBAA0B,GAAG,cAAc,CAiChH;AAED,4DAA4D;AAC5D,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvG,MAAM,MAAM,aAAa,GAAG;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACzE,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC3E,+GAA+G;IAC/G,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;IAC1C,oGAAoG;IACpG,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;IACjC,2DAA2D;IAC3D,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAClC,CAAA;AAED,2EAA2E;AAC3E,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAe7E,yGAAyG;AACzG,wBAAgB,YAAY,CAC1B,IAAI,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;CAAE,EACtE,OAAO,GAAE,qBAA0B,GAClC,aAAa,CAcf;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;CAAE,EACtE,OAAO,GAAE,qBAA0B,GAClC,UAAU,CAWZ;AAED,eAAO,MAAM,kBAAkB;;;CAAmF,CAAA;AAqFlH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1F;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;CAAE,GAAG,cAAc,EAAE,CAiBrH"}

package/dist/turtle.d.ts

@@ -0,0 +1,7 @@
+import type { StateGraph } from './graph.js';
+/**
+ * Turtle (RDF 1.1): prefixes, then one block per subject. Names are prefixed where the local
+ * part needs no escaping and written as full IRIs otherwise; lists use collection syntax.
+ */
+export declare function toTurtle(graph: StateGraph): string;
+//# sourceMappingURL=turtle.d.ts.map

package/dist/turtle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turtle.d.ts","sourceRoot":"","sources":["../src/turtle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,YAAY,CAAA;AAKvD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CA4BlD"}

package/dist/vocabulary.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The Seed vocabulary (`{base}ns#`) in Turtle: the classes and properties the state graph uses
+ * that PROV-O and schema.org don't already have.
+ */
+export declare function seedVocabulary(base?: string): string;
+//# sourceMappingURL=vocabulary.d.ts.map

package/dist/vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../src/vocabulary.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,MAA6B,GAAG,MAAM,CA8B1E"}

package/package.json

@@ -1,6 +1,77 @@
 {
   "name": "@seedprotocol/rdf",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.8.1",
+  "description": "RDF export for Seed Protocol items: a state graph of each seed's current values as RDF/JS quads, N-Quads, Turtle or JSON-LD, with IRIs minted from the on-chain schemas",
+  "keywords": [
+    "seed-protocol",
+    "rdf",
+    "linked-data",
+    "json-ld",
+    "turtle",
+    "n-quads",
+    "eas"
+  ],
+  "type": "module",
+  "engines": {
+    "node": ">=20.12.0"
+  },
+  "bin": {
+    "seed-rdf": "./dist/bin.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "rimraf dist && tsc -p tsconfig.build.json && vite build && node ../../scripts/fix-dts-specifiers.js",
+    "test": "vitest run --reporter=default",
+    "prepublishOnly": "bun run build && node ../../scripts/sync-versions.js"
+  },
+  "dependencies": {
+    "@noble/hashes": "^1.8.0",
+    "@rdfjs/types": "^2.0.1",
+    "@seedprotocol/eas": "workspace:*",
+    "@seedprotocol/query": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/jsonld": "1.5.15",
+    "@types/node": "^24.10.1",
+    "jsonld": "9.0.0",
+    "n3": "2.13.12",
+    "rdf-canonize": "5.0.0",
+    "rdf-validate-shacl": "0.6.5",
+    "rimraf": "^6.0.1",
+    "typescript": "~5.9.3",
+    "vite": "^8.0.0",
+    "vitest": "^4.1.11"
+  },
+  "author": "Keith Axline <keith@journodao.xyz>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JournoLabs/seed-protocol-sdk.git",
+    "directory": "packages/rdf"
+  },
+  "homepage": "https://github.com/JournoLabs/seed-protocol-sdk/tree/main/packages/rdf#readme",
+  "bugs": {
+    "url": "https://github.com/JournoLabs/seed-protocol-sdk/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}