glossarist 0.4.11 → 0.4.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glossarist",
-  "version": "0.4.11",
+  "version": "0.4.12",
   "description": "JavaScript SDK for Glossarist GCR packages — read, write, validate, and manage terminology concepts",
   "type": "module",
   "main": "src/index.js",

package/src/rdf/agents-emitter.js

@@ -33,8 +33,8 @@ const RDFS = {
   seeAlso: `${RDFS_NS}seeAlso`,
 };
 
-const DEFAULT_AGENT_BASE = 'https://glossarist.org/agent';
-const DEFAULT_ORG_BASE = 'https://glossarist.org/org';
+// No hardcoded default agent/org base URIs. Callers MUST pass agentBase
+// explicitly so agent IRIs reflect the consumer's domain.
 
 /**
  * @typedef {Object} Contributor
@@ -64,7 +64,8 @@ export function slugify(input) {
  * Builds AgentInput records from raw contributor declarations.
  * Useful for callers that want to inspect the IRIs before emission.
  */
-export function agentsFromContributors(contributors, agentBase = DEFAULT_AGENT_BASE) {
+export function agentsFromContributors(contributors, agentBase) {
+  if (!agentBase) throw new Error('agentsFromContributors requires agentBase — the deployment canonical URI root for agents (e.g. https://www.example.org/agent). glossarist-js does NOT default to glossarist.org.');
   return (contributors ?? []).map(c => {
     const slug = slugify(c.name);
     return {
@@ -92,7 +93,8 @@ export function agentsFromContributors(contributors, agentBase = DEFAULT_AGENT_B
  * @returns {Generator<Quad, void, unknown>}
  */
 export function* agentsToQuads(agents, options = {}) {
-  const orgBase = options.orgBase ?? DEFAULT_ORG_BASE;
+  const orgBase = options.orgBase;
+  if (!orgBase) throw new Error('agentsToQuads requires options.orgBase — the deployment canonical URI root for organizations.');
   const emittedOrgs = new Set();
 
   for (const a of agents ?? []) {

package/src/rdf/bibliography-emitter.js

@@ -28,7 +28,8 @@ const FOAF = {
   page: `${FOAF_NS}page`,
 };
 
-const DEFAULT_BASE_URI = 'https://glossarist.org';
+// No hardcoded default base URI. Callers MUST pass baseUri explicitly
+// so instance IRIs reflect the consumer's domain, not the library's.
 
 /**
  * @typedef {Object} BibliographyEntry
@@ -52,7 +53,8 @@ const DEFAULT_BASE_URI = 'https://glossarist.org';
  * @param {string} entryId
  * @param {string} [baseUri]
  */
-export function bibliographyEntryIri(registerId, entryId, baseUri = DEFAULT_BASE_URI) {
+export function bibliographyEntryIri(registerId, entryId, baseUri) {
+  if (!baseUri) throw new Error('bibliographyEntryIri requires baseUri — the deployment canonical URI root. glossarist-js does NOT default to glossarist.org because instance data identity must reflect the consumer domain.');
   return `${baseUri}/${registerId}/bib/${entryId}`;
 }
 
@@ -64,7 +66,8 @@ export function bibliographyEntryIri(registerId, entryId, baseUri = DEFAULT_BASE
  * @returns {Generator<Quad, void, unknown>}
  */
 export function* bibliographyToQuads(input) {
-  const baseUri = input.baseUri ?? DEFAULT_BASE_URI;
+  const baseUri = input.baseUri;
+  if (!baseUri) throw new Error('bibliographyToQuads requires input.baseUri — the deployment canonical URI root.');
   const parentIri = `${baseUri}/${input.registerId}/`;
 
   for (const entry of input.entries ?? []) {

package/src/rdf/build-activity-emitter.js

@@ -76,7 +76,8 @@ export function buildActivityIri(input) {
  * @returns {Generator<Quad, void, unknown>}
  */
 export function* buildActivityToQuads(input) {
-  const baseUri = input.baseUri ?? 'https://glossarist.org';
+  const baseUri = input.baseUri;
+  if (!baseUri) throw new Error('buildActivityToQuads requires input.baseUri — the deployment canonical URI root. glossarist-js does NOT default to glossarist.org because instance data identity must reflect the consumer domain.');
   const activityIri = `${baseUri}/${buildActivityIri(input)}`;
   const activity = namedNode(activityIri);
 

package/src/rdf/image-variant-emitter.js

@@ -28,7 +28,7 @@ const DCAT = {
 };
 const XSD_INTEGER = `${XSD_NS}integer`;
 
-const DEFAULT_BASE_URI = 'https://glossarist.org';
+// No hardcoded default base URI. Callers MUST pass baseUri explicitly.
 
 /**
  * @typedef {'svg' | 'png' | 'webp' | 'jpg' | 'gif'} ImageFormat
@@ -55,7 +55,8 @@ const MIME_BY_FORMAT = Object.freeze({
  * Returns the canonical IRI for an image variant. Includes the lang
  * segment when the variant is localized, otherwise omits it.
  */
-export function imageVariantIri(input, baseUri = DEFAULT_BASE_URI) {
+export function imageVariantIri(input, baseUri) {
+  if (!baseUri) throw new Error('imageVariantIri requires baseUri — the deployment canonical URI root.');
   const langSuffix = input.lang ? `${input.lang}.` : '';
   return `${baseUri}/${input.registerId}/image/${input.figureId}/${langSuffix}${input.format}`;
 }
@@ -63,7 +64,8 @@ export function imageVariantIri(input, baseUri = DEFAULT_BASE_URI) {
 /**
  * Emits foaf:Image quads for one image variant.
  */
-export function* imageVariantToQuads(input, baseUri = DEFAULT_BASE_URI) {
+export function* imageVariantToQuads(input, baseUri) {
+  if (!baseUri) throw new Error('imageVariantToQuads requires baseUri — the deployment canonical URI root.');
   const img = namedNode(imageVariantIri(input, baseUri));
   yield quad(img, namedNode(RDF_TYPE), namedNode(FOAF.Image));
   yield quad(img, namedNode(DCTERMS.format), literal(MIME_BY_FORMAT[input.format] ?? 'application/octet-stream'));

package/src/transforms/concept-to-gloss.transform.js

@@ -16,7 +16,8 @@ import {
   writeJsonld,
 } from '../rdf/document-writer.js';
 
-const DEFAULT_URI_BASE = 'https://glossarist.org';
+// No hardcoded default URI base. Callers MUST pass options.uriBase so
+// concept IRIs reflect the consumer's domain.
 
 // Writer registry. Each entry is `{ write: (quads, transform) => Promise<string> }`.
 // Adding a new output format is a single entry here, not six new methods.
@@ -29,7 +30,8 @@ const WRITERS = Object.freeze({
 export class ConceptToGlossTransform {
   constructor(options = {}) {
     this.registerId = options.registerId;
-    this.uriBase = (options.uriBase ?? DEFAULT_URI_BASE).replace(/\/+$/, '');
+    this.uriBase = options.uriBase?.replace(/\/+$/, '');
+    if (!this.uriBase) throw new Error('ConceptToGlossTransform requires options.uriBase — the deployment canonical URI root.');
     this.jsonldContext = options.jsonldContext;
   }