@oslo-flanders/core 0.0.1-alpha.0

package/lib/logging/WinstonLogger.js

@@ -0,0 +1,39 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WinstonLogger = void 0;
+const inversify_1 = require("inversify");
+const winston_1 = require("winston");
+const { combine, colorize, printf } = winston_1.format;
+const Logger_1 = require("./Logger");
+const messageFormat = printf(({ level, message, messageTimestamp }) => `${new Date(Date.now()).toISOString()} ${level}: ${message}`);
+let WinstonLogger = class WinstonLogger extends Logger_1.BaseLogger {
+    constructor(logLevel) {
+        super();
+        this.logger = (0, winston_1.createLogger)({
+            level: logLevel,
+            transports: [
+                new winston_1.transports.Console(),
+            ],
+            format: combine(colorize(), messageFormat),
+        });
+    }
+    log(level, message) {
+        this.logger.log(level, message);
+        return this;
+    }
+};
+WinstonLogger = __decorate([
+    (0, inversify_1.injectable)(),
+    __metadata("design:paramtypes", [String])
+], WinstonLogger);
+exports.WinstonLogger = WinstonLogger;
+//# sourceMappingURL=WinstonLogger.js.map

package/lib/logging/WinstonLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WinstonLogger.js","sourceRoot":"","sources":["WinstonLogger.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAuC;AAEvC,qCAA2D;AAC3D,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,gBAAM,CAAC;AAE7C,qCAAsC;AAGtC,MAAM,aAAa,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC,CAAC;AAG9H,IAAM,aAAa,GAAnB,MAAM,aAAc,SAAQ,mBAAU;IAG3C,YAAmB,QAAkB;QACnC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,IAAA,sBAAY,EAAC;YACzB,KAAK,EAAE,QAAQ;YACf,UAAU,EAAE;gBACV,IAAI,oBAAU,CAAC,OAAO,EAAE;aACzB;YACD,MAAM,EAAE,OAAO,CACb,QAAQ,EAAE,EACV,aAAa,CACd;SACF,CAAC,CAAC;IACL,CAAC;IAEM,GAAG,CAAC,KAAe,EAAE,OAAe;QACzC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAA;AArBY,aAAa;IADzB,IAAA,sBAAU,GAAE;;GACA,aAAa,CAqBzB;AArBY,sCAAa","sourcesContent":["import { injectable } from 'inversify';\r\nimport type { Logger as WinstonInnerLogger } from 'winston';\r\nimport { transports, createLogger, format } from 'winston';\r\nconst { combine, colorize, printf } = format;\r\n\r\nimport { BaseLogger } from './Logger';\r\nimport { LogLevel } from './LogLevel';\r\n\r\nconst messageFormat = printf(({ level, message, messageTimestamp }) => `${new Date(Date.now()).toISOString()} ${level}: ${message}`);\r\n\r\n@injectable()\r\nexport class WinstonLogger extends BaseLogger {\r\n  private readonly logger: WinstonInnerLogger;\r\n\r\n  public constructor(logLevel: LogLevel) {\r\n    super();\r\n    this.logger = createLogger({\r\n      level: logLevel,\r\n      transports: [\r\n        new transports.Console(),\r\n      ],\r\n      format: combine(\r\n        colorize(),\r\n        messageFormat,\r\n      ),\r\n    });\r\n  }\r\n\r\n  public log(level: LogLevel, message: string): this {\r\n    this.logger.log(level, message);\r\n    return this;\r\n  }\r\n}\r\n"]}

package/lib/logging/WinstonLogger.ts

@@ -0,0 +1,33 @@
+import { injectable } from 'inversify';
+import type { Logger as WinstonInnerLogger } from 'winston';
+import { transports, createLogger, format } from 'winston';
+const { combine, colorize, printf } = format;
+
+import { BaseLogger } from './Logger';
+import { LogLevel } from './LogLevel';
+
+const messageFormat = printf(({ level, message, messageTimestamp }) => `${new Date(Date.now()).toISOString()} ${level}: ${message}`);
+
+@injectable()
+export class WinstonLogger extends BaseLogger {
+  private readonly logger: WinstonInnerLogger;
+
+  public constructor(logLevel: LogLevel) {
+    super();
+    this.logger = createLogger({
+      level: logLevel,
+      transports: [
+        new transports.Console(),
+      ],
+      format: combine(
+        colorize(),
+        messageFormat,
+      ),
+    });
+  }
+
+  public log(level: LogLevel, message: string): this {
+    this.logger.log(level, message);
+    return this;
+  }
+}

package/lib/utils/N3StoreFunctions.d.ts

@@ -0,0 +1,136 @@
+import type * as RDF from '@rdfjs/types';
+import * as N3 from 'n3';
+/**
+ * Given a local file, it is parsed and added to an in-memory quad store
+ * @param fileOrUrl Local path of the input file
+ * @returns A N3 quad store
+ */
+export declare function createN3Store(file: string): Promise<N3.Store>;
+/**
+ * Find the subject of the statement that matches the given subject, predicate and object
+ * @param statementSubject The subject to match the statement subject
+ * @param statementPredicate The predicate to match the statement predicate
+ * @param statementObject The object to match the statement object
+ * @param store An N3 quad store
+ * @returns an RDF.Term or undefined if none found
+ */
+export declare function getTargetStatementId(statementSubject: RDF.Term, statementPredicate: RDF.Term, statementObject: RDF.Term, store: N3.Store): RDF.Term | undefined;
+/**
+ * For a given subject, the quad store is queried to find the assigned URI
+ * @param subject The subject for which the assigned URI is to be retrieved
+ * @param store The quad store
+ * @returns An RDF.NamedNode or undefined if not found
+ */
+export declare function getAssignedUri(subject: RDF.Term, store: N3.Store): RDF.Term | undefined;
+/**
+ * Finds the assigned URI in rdf:Statements
+ * @param subject The statement subject
+ * @param predicate The statement predicate
+ * @param object The statement object for which the assigned URI must be found
+ * @param store A N3 quad store
+ * @returns An RDF.Term or undefined if not found
+ */
+export declare function getAssignedUriViaStatements(subject: RDF.Term, predicate: RDF.Term, object: RDF.Term, store: N3.Store): RDF.Term | undefined;
+/**
+ * Find all rdfs:labels for a given subject
+ * @param subject The RDF.Term to find the rdfs:labels for
+ * @param store A N3 quad store
+ * @returns An array of RDF.Literals
+ */
+export declare function getLabels(subject: RDF.Term, store: N3.Store): RDF.Literal[];
+/**
+ * Finds the rdfs:label whose language tag matches the given language
+ * @param subject The RDF.Term to find the rdfs:label for
+ * @param store A N3 quad store
+ * @param language A language tag
+ * @returns An RDF.Literal or undefined if not found
+ */
+export declare function getLabel(subject: RDF.Term, store: N3.Store, language?: string): RDF.Literal | undefined;
+/**
+ * Finds the rdfs:label for an RDF.Term in rdf:Statements
+ * @param subject The statement subject
+ * @param predicate The statement predicate
+ * @param object The statement object for which the label must be found
+ * @param store A N3 quad store
+ * @param language A language tag
+ * @returns An RDF.Literal or undefined if not found
+ */
+export declare function getLabelViaStatements(subject: RDF.Term, predicate: RDF.Term, object: RDF.Term, store: N3.Store, language: string): RDF.Literal | undefined;
+/**
+ * Find all rdfs:comments for a given subject
+ * @param subject The RDF.Term to find the rdfs:comments for
+ * @param store A N3 quad store
+ * @returns An array of RDF.Literals
+ */
+export declare function getDefinitions(subject: RDF.Term, store: N3.Store): RDF.Literal[];
+/**
+ * Finds the rdfs:comment whose language tag matches the given language
+ * @param subject The RDF.Term to find the rdfs:comment for
+ * @param store A N3 quad store
+ * @param language A language tag
+ * @returns An RDF.Literal or undefined if not found
+ */
+export declare function getDefinition(subject: RDF.Term, store: N3.Store, language?: string): RDF.Literal | undefined;
+/**
+ * Finds the rdfs:comment for an RDF.Term in rdf:Statements
+ * @param subject The statement subject
+ * @param predicate The statement predicate
+ * @param object The statement object for which the definition must be found
+ * @param store A N3 quad store
+ * @param language A language tag
+ * @returns An RDF.Literal or undefined if not found
+ */
+export declare function getDefinitionViaStatements(subject: RDF.Term, predicate: RDF.Term, object: RDF.Term, store: N3.Store, language: string): RDF.Literal | undefined;
+/**
+ * Finds all the rdfs:subClassOf of a given RDF.Term
+ * @param subject the RDF.Term to find the parents of
+ * @param store A N3 quad store
+ * @returns An array of RDF.Terms
+ */
+export declare function getParentsOfClass(subject: RDF.Term, store: N3.Store): RDF.Term[];
+/**
+ * Finds the rdfs:subPropertyOf of a given RDF.Term
+ * @param subject The RDF.Term to find the parent of
+ * @param store A N3 quad store
+ * @returns An RDF.Term or undefined if not found
+ */
+export declare function getParentOfProperty(subject: RDF.Term, store: N3.Store): RDF.Term | undefined;
+/**
+ * Finds the rdfs:range of a given RDF.Term
+ * @param subject The RDF.Term to find the range of
+ * @param store A N3 quad store
+ * @returns An RDF.Term or undefined if not found
+ */
+export declare function getRange(subject: RDF.Term, store: N3.Store): RDF.Term | undefined;
+/**
+ * Finds the rdfs:domain of a given RDF.Term
+ * @param subject The RDF.Term to find the domain of
+ * @param store A N3 quad store
+ * @returns An RDF.Term or undefined if not found
+ */
+export declare function getDomain(subject: RDF.Term, store: N3.Store): RDF.Term | undefined;
+/**
+ * Finds all the vann:usageNotes of a given RDF.Term
+ * @param subject The RDF.Term to find the usage notes for
+ * @param store A N3 quad store
+ * @returns An array of RDF.Literals
+ */
+export declare function getUsageNotes(subject: RDF.Term, store: N3.Store): RDF.Literal[];
+/**
+ * Finds the vann:usageNote of which the language tag matches the given language
+ * @param subject The RDF.Term to find the usage note for
+ * @param store A N3 quad store
+ * @param language A language tag
+ * @returns An RDF.Literal or undefined if not found
+ */
+export declare function getUsageNote(subject: RDF.Term, store: N3.Store, language?: string): RDF.Literal | undefined;
+/**
+ * Finds the vann:usageNote for an RDF.Term in rdf:Statements
+ * @param subject The statement subject
+ * @param predicate The statement predicate
+ * @param object The statement object for which the usage note must be found
+ * @param store A N3 quad store
+ * @param language A language tag
+ * @returns An RDF.Literal or undefined if not found
+ */
+export declare function getUsageNoteViaStatements(subject: RDF.Term, predicate: RDF.Term, object: RDF.Term, store: N3.Store, language: string): RDF.Literal | undefined;

package/lib/utils/N3StoreFunctions.js

@@ -0,0 +1,257 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUsageNoteViaStatements = exports.getUsageNote = exports.getUsageNotes = exports.getDomain = exports.getRange = exports.getParentOfProperty = exports.getParentsOfClass = exports.getDefinitionViaStatements = exports.getDefinition = exports.getDefinitions = exports.getLabelViaStatements = exports.getLabel = exports.getLabels = exports.getAssignedUriViaStatements = exports.getAssignedUri = exports.getTargetStatementId = exports.createN3Store = void 0;
+const N3 = __importStar(require("n3"));
+const rdf_parse_1 = __importDefault(require("rdf-parse"));
+const fetchFileOrUrl_1 = require("./fetchFileOrUrl");
+const namespaces_1 = require("./namespaces");
+/**
+ * Given a local file, it is parsed and added to an in-memory quad store
+ * @param fileOrUrl Local path of the input file
+ * @returns A N3 quad store
+ */
+async function createN3Store(file) {
+    const store = new N3.Store();
+    const buffer = await (0, fetchFileOrUrl_1.fetchFileOrUrl)(file);
+    const textStream = require('streamify-string')(buffer.toString());
+    return new Promise((resolve, reject) => {
+        rdf_parse_1.default.parse(textStream, { path: file })
+            .on('data', (quad) => store.addQuad(quad))
+            .on('error', (error) => reject(error))
+            .on('end', () => resolve(store));
+    });
+}
+exports.createN3Store = createN3Store;
+/**
+ * Find the subject of the statement that matches the given subject, predicate and object
+ * @param statementSubject The subject to match the statement subject
+ * @param statementPredicate The predicate to match the statement predicate
+ * @param statementObject The object to match the statement object
+ * @param store An N3 quad store
+ * @returns an RDF.Term or undefined if none found
+ */
+function getTargetStatementId(statementSubject, statementPredicate, statementObject, store) {
+    const statementIds = store.getSubjects(namespaces_1.ns.rdf('type'), namespaces_1.ns.rdf('Statement'), null);
+    const statementSubjectPredicateSubjects = store.getSubjects(namespaces_1.ns.rdf('subject'), statementSubject, null);
+    const statementPredicatePredicateSubjects = store.getSubjects(namespaces_1.ns.rdf('predicate'), statementPredicate, null);
+    const statementObjectPredicateSubjects = store.getSubjects(namespaces_1.ns.rdf('object'), statementObject, null);
+    const targetIds = statementIds
+        .filter(x => statementSubjectPredicateSubjects.some(y => y.value === x.value))
+        .filter(x => statementPredicatePredicateSubjects.some(y => y.value === x.value))
+        .filter(x => statementObjectPredicateSubjects.some(y => y.value === x.value));
+    if (targetIds.length > 1) {
+        throw new Error(`Found multiple statements with subject "${statementSubject.value}", predicate "${statementPredicate.value}" and object "${statementObject.value}".`);
+    }
+    return targetIds.shift();
+}
+exports.getTargetStatementId = getTargetStatementId;
+/**
+ * For a given subject, the quad store is queried to find the assigned URI
+ * @param subject The subject for which the assigned URI is to be retrieved
+ * @param store The quad store
+ * @returns An RDF.NamedNode or undefined if not found
+ */
+function getAssignedUri(subject, store) {
+    return store.getObjects(subject, namespaces_1.ns.example('assignedUri'), null).shift();
+}
+exports.getAssignedUri = getAssignedUri;
+/**
+ * Finds the assigned URI in rdf:Statements
+ * @param subject The statement subject
+ * @param predicate The statement predicate
+ * @param object The statement object for which the assigned URI must be found
+ * @param store A N3 quad store
+ * @returns An RDF.Term or undefined if not found
+ */
+function getAssignedUriViaStatements(subject, predicate, object, store) {
+    const statementId = getTargetStatementId(subject, predicate, object, store);
+    if (!statementId) {
+        return undefined;
+    }
+    return getAssignedUri(statementId, store);
+}
+exports.getAssignedUriViaStatements = getAssignedUriViaStatements;
+/**
+ * Find all rdfs:labels for a given subject
+ * @param subject The RDF.Term to find the rdfs:labels for
+ * @param store A N3 quad store
+ * @returns An array of RDF.Literals
+ */
+function getLabels(subject, store) {
+    return store.getObjects(subject, namespaces_1.ns.rdfs('label'), null);
+}
+exports.getLabels = getLabels;
+/**
+ * Finds the rdfs:label whose language tag matches the given language
+ * @param subject The RDF.Term to find the rdfs:label for
+ * @param store A N3 quad store
+ * @param language A language tag
+ * @returns An RDF.Literal or undefined if not found
+ */
+function getLabel(subject, store, language) {
+    return getLabels(subject, store).find(x => x.language === (language || ''));
+}
+exports.getLabel = getLabel;
+/**
+ * Finds the rdfs:label for an RDF.Term in rdf:Statements
+ * @param subject The statement subject
+ * @param predicate The statement predicate
+ * @param object The statement object for which the label must be found
+ * @param store A N3 quad store
+ * @param language A language tag
+ * @returns An RDF.Literal or undefined if not found
+ */
+function getLabelViaStatements(subject, predicate, object, store, language) {
+    const statementId = getTargetStatementId(subject, predicate, object, store);
+    if (!statementId) {
+        return undefined;
+    }
+    const label = getLabel(statementId, store, language);
+    return label || getLabel(statementId, store);
+}
+exports.getLabelViaStatements = getLabelViaStatements;
+/**
+ * Find all rdfs:comments for a given subject
+ * @param subject The RDF.Term to find the rdfs:comments for
+ * @param store A N3 quad store
+ * @returns An array of RDF.Literals
+ */
+function getDefinitions(subject, store) {
+    return store.getObjects(subject, namespaces_1.ns.rdfs('comment'), null);
+}
+exports.getDefinitions = getDefinitions;
+/**
+ * Finds the rdfs:comment whose language tag matches the given language
+ * @param subject The RDF.Term to find the rdfs:comment for
+ * @param store A N3 quad store
+ * @param language A language tag
+ * @returns An RDF.Literal or undefined if not found
+ */
+function getDefinition(subject, store, language) {
+    return getDefinitions(subject, store).find(x => x.language === (language || ''));
+}
+exports.getDefinition = getDefinition;
+/**
+ * Finds the rdfs:comment for an RDF.Term in rdf:Statements
+ * @param subject The statement subject
+ * @param predicate The statement predicate
+ * @param object The statement object for which the definition must be found
+ * @param store A N3 quad store
+ * @param language A language tag
+ * @returns An RDF.Literal or undefined if not found
+ */
+function getDefinitionViaStatements(subject, predicate, object, store, language) {
+    const statementId = getTargetStatementId(subject, predicate, object, store);
+    if (!statementId) {
+        return undefined;
+    }
+    const definition = getDefinition(statementId, store, language);
+    return definition || getDefinition(statementId, store);
+}
+exports.getDefinitionViaStatements = getDefinitionViaStatements;
+/**
+ * Finds all the rdfs:subClassOf of a given RDF.Term
+ * @param subject the RDF.Term to find the parents of
+ * @param store A N3 quad store
+ * @returns An array of RDF.Terms
+ */
+function getParentsOfClass(subject, store) {
+    return store.getObjects(subject, namespaces_1.ns.rdfs('subClassOf'), null);
+}
+exports.getParentsOfClass = getParentsOfClass;
+/**
+ * Finds the rdfs:subPropertyOf of a given RDF.Term
+ * @param subject The RDF.Term to find the parent of
+ * @param store A N3 quad store
+ * @returns An RDF.Term or undefined if not found
+ */
+function getParentOfProperty(subject, store) {
+    return store.getObjects(subject, namespaces_1.ns.rdfs('subPropertyOf'), null).shift();
+}
+exports.getParentOfProperty = getParentOfProperty;
+/**
+ * Finds the rdfs:range of a given RDF.Term
+ * @param subject The RDF.Term to find the range of
+ * @param store A N3 quad store
+ * @returns An RDF.Term or undefined if not found
+ */
+function getRange(subject, store) {
+    return store.getObjects(subject, namespaces_1.ns.rdfs('range'), null).shift();
+}
+exports.getRange = getRange;
+/**
+ * Finds the rdfs:domain of a given RDF.Term
+ * @param subject The RDF.Term to find the domain of
+ * @param store A N3 quad store
+ * @returns An RDF.Term or undefined if not found
+ */
+function getDomain(subject, store) {
+    return store.getObjects(subject, namespaces_1.ns.rdfs('domain'), null).shift();
+}
+exports.getDomain = getDomain;
+/**
+ * Finds all the vann:usageNotes of a given RDF.Term
+ * @param subject The RDF.Term to find the usage notes for
+ * @param store A N3 quad store
+ * @returns An array of RDF.Literals
+ */
+function getUsageNotes(subject, store) {
+    return store.getObjects(subject, namespaces_1.ns.vann('usageNote'), null);
+}
+exports.getUsageNotes = getUsageNotes;
+/**
+ * Finds the vann:usageNote of which the language tag matches the given language
+ * @param subject The RDF.Term to find the usage note for
+ * @param store A N3 quad store
+ * @param language A language tag
+ * @returns An RDF.Literal or undefined if not found
+ */
+function getUsageNote(subject, store, language) {
+    return getUsageNotes(subject, store).find(x => x.language === (language || ''));
+}
+exports.getUsageNote = getUsageNote;
+/**
+ * Finds the vann:usageNote for an RDF.Term in rdf:Statements
+ * @param subject The statement subject
+ * @param predicate The statement predicate
+ * @param object The statement object for which the usage note must be found
+ * @param store A N3 quad store
+ * @param language A language tag
+ * @returns An RDF.Literal or undefined if not found
+ */
+function getUsageNoteViaStatements(subject, predicate, object, store, language) {
+    const statementId = getTargetStatementId(subject, predicate, object, store);
+    if (!statementId) {
+        return undefined;
+    }
+    const usageNote = getUsageNote(statementId, store, language);
+    return usageNote || getUsageNote(statementId, store);
+}
+exports.getUsageNoteViaStatements = getUsageNoteViaStatements;
+//# sourceMappingURL=N3StoreFunctions.js.map

package/lib/utils/N3StoreFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"N3StoreFunctions.js","sourceRoot":"","sources":["N3StoreFunctions.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,uCAAyB;AACzB,0DAAkC;AAClC,qDAAkD;AAClD,6CAAkC;AAElC;;;;GAIG;AACI,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,IAAA,+BAAc,EAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAElE,OAAO,IAAI,OAAO,CAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC/C,mBAAS,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;aACxC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAc,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;aACnD,EAAE,CAAC,OAAO,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aAC9C,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC;AAXD,sCAWC;AAED;;;;;;;GAOG;AACH,SAAgB,oBAAoB,CAClC,gBAA0B,EAC1B,kBAA4B,EAC5B,eAAyB,EACzB,KAAe;IAEf,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,CAAC,eAAE,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,eAAE,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC;IAClF,MAAM,iCAAiC,GAAG,KAAK,CAAC,WAAW,CAAC,eAAE,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;IACvG,MAAM,mCAAmC,GAAG,KAAK,CAAC,WAAW,CAAC,eAAE,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,CAAC;IAC7G,MAAM,gCAAgC,GAAG,KAAK,CAAC,WAAW,CAAC,eAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC;IAEpG,MAAM,SAAS,GAAG,YAAY;SAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,iCAAiC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;SAC7E,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,mCAAmC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;SAC/E,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,gCAAgC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAEhF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE;QACxB,MAAM,IAAI,KAAK,CAAC,2CAA2C,gBAAgB,CAAC,KAAK,iBAAiB,kBAAkB,CAAC,KAAK,iBAAiB,eAAe,CAAC,KAAK,IAAI,CAAC,CAAC;KACvK;IAED,OAAO,SAAS,CAAC,KAAK,EAAE,CAAC;AAC3B,CAAC;AArBD,oDAqBC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,OAAiB,EAAE,KAAe;IAC/D,OAAO,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,eAAE,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;AAC5E,CAAC;AAFD,wCAEC;AAED;;;;;;;GAOG;AACH,SAAgB,2BAA2B,CACzC,OAAiB,EACjB,SAAmB,EACnB,MAAgB,EAChB,KAAe;IAEf,MAAM,WAAW,GAAG,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAE5E,IAAI,CAAC,WAAW,EAAE;QAChB,OAAO,SAAS,CAAC;KAClB;IAED,OAAO,cAAc,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AAC5C,CAAC;AAbD,kEAaC;AAED;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,OAAiB,EAAE,KAAe;IAC1D,OAAsB,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,eAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;AAC1E,CAAC;AAFD,8BAEC;AAED;;;;;;GAMG;AACH,SAAgB,QAAQ,CAAC,OAAiB,EAAE,KAAe,EAAE,QAAiB;IAC5E,OAAO,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;AAC9E,CAAC;AAFD,4BAEC;AAED;;;;;;;;GAQG;AACH,SAAgB,qBAAqB,CACnC,OAAiB,EACjB,SAAmB,EACnB,MAAgB,EAChB,KAAe,EACf,QAAgB;IAEhB,MAAM,WAAW,GAAG,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAE5E,IAAI,CAAC,WAAW,EAAE;QAChB,OAAO,SAAS,CAAC;KAClB;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrD,OAAO,KAAK,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC;AAfD,sDAeC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,OAAiB,EAAE,KAAe;IAC/D,OAAsB,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,eAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;AAC5E,CAAC;AAFD,wCAEC;AAED;;;;;;GAMG;AACH,SAAgB,aAAa,CAAC,OAAiB,EAAE,KAAe,EAAE,QAAiB;IACjF,OAAO,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;AACnF,CAAC;AAFD,sCAEC;AAED;;;;;;;;GAQG;AACH,SAAgB,0BAA0B,CACxC,OAAiB,EACjB,SAAmB,EACnB,MAAgB,EAChB,KAAe,EACf,QAAgB;IAEhB,MAAM,WAAW,GAAG,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAE5E,IAAI,CAAC,WAAW,EAAE;QAChB,OAAO,SAAS,CAAC;KAClB;IAED,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC/D,OAAO,UAAU,IAAI,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AACzD,CAAC;AAfD,gEAeC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,OAAiB,EAAE,KAAe;IAClE,OAAO,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,eAAE,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,CAAC;AAChE,CAAC;AAFD,8CAEC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,OAAiB,EAAE,KAAe;IACpE,OAAO,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,eAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;AAC3E,CAAC;AAFD,kDAEC;AAED;;;;;GAKG;AACH,SAAgB,QAAQ,CAAC,OAAiB,EAAE,KAAe;IACzD,OAAO,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,eAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;AACnE,CAAC;AAFD,4BAEC;AAED;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,OAAiB,EAAE,KAAe;IAC1D,OAAO,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,eAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;AACpE,CAAC;AAFD,8BAEC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,OAAiB,EAAE,KAAe;IAC9D,OAAsB,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,eAAE,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC;AAC9E,CAAC;AAFD,sCAEC;AAED;;;;;;GAMG;AACH,SAAgB,YAAY,CAAC,OAAiB,EAAE,KAAe,EAAE,QAAiB;IAChF,OAAO,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;AAClF,CAAC;AAFD,oCAEC;AAED;;;;;;;;GAQG;AACH,SAAgB,yBAAyB,CACvC,OAAiB,EACjB,SAAmB,EACnB,MAAgB,EAChB,KAAe,EACf,QAAgB;IAEhB,MAAM,WAAW,GAAG,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAE5E,IAAI,CAAC,WAAW,EAAE;QAChB,OAAO,SAAS,CAAC;KAClB;IAED,MAAM,SAAS,GAAG,YAAY,CAAC,WAAW,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC7D,OAAO,SAAS,IAAI,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC;AAfD,8DAeC","sourcesContent":["import type * as RDF from '@rdfjs/types';\r\nimport * as N3 from 'n3';\r\nimport rdfParser from 'rdf-parse';\r\nimport { fetchFileOrUrl } from './fetchFileOrUrl';\r\nimport { ns } from './namespaces';\r\n\r\n/**\r\n * Given a local file, it is parsed and added to an in-memory quad store\r\n * @param fileOrUrl Local path of the input file\r\n * @returns A N3 quad store\r\n */\r\nexport async function createN3Store(file: string): Promise<N3.Store> {\r\n  const store = new N3.Store();\r\n  const buffer = await fetchFileOrUrl(file);\r\n  const textStream = require('streamify-string')(buffer.toString());\r\n\r\n  return new Promise<N3.Store>((resolve, reject) => {\r\n    rdfParser.parse(textStream, { path: file })\r\n      .on('data', (quad: RDF.Quad) => store.addQuad(quad))\r\n      .on('error', (error: unknown) => reject(error))\r\n      .on('end', () => resolve(store));\r\n  });\r\n}\r\n\r\n/**\r\n * Find the subject of the statement that matches the given subject, predicate and object\r\n * @param statementSubject The subject to match the statement subject\r\n * @param statementPredicate The predicate to match the statement predicate\r\n * @param statementObject The object to match the statement object\r\n * @param store An N3 quad store\r\n * @returns an RDF.Term or undefined if none found\r\n */\r\nexport function getTargetStatementId(\r\n  statementSubject: RDF.Term,\r\n  statementPredicate: RDF.Term,\r\n  statementObject: RDF.Term,\r\n  store: N3.Store,\r\n): RDF.Term | undefined {\r\n  const statementIds = store.getSubjects(ns.rdf('type'), ns.rdf('Statement'), null);\r\n  const statementSubjectPredicateSubjects = store.getSubjects(ns.rdf('subject'), statementSubject, null);\r\n  const statementPredicatePredicateSubjects = store.getSubjects(ns.rdf('predicate'), statementPredicate, null);\r\n  const statementObjectPredicateSubjects = store.getSubjects(ns.rdf('object'), statementObject, null);\r\n\r\n  const targetIds = statementIds\r\n    .filter(x => statementSubjectPredicateSubjects.some(y => y.value === x.value))\r\n    .filter(x => statementPredicatePredicateSubjects.some(y => y.value === x.value))\r\n    .filter(x => statementObjectPredicateSubjects.some(y => y.value === x.value));\r\n\r\n  if (targetIds.length > 1) {\r\n    throw new Error(`Found multiple statements with subject \"${statementSubject.value}\", predicate \"${statementPredicate.value}\" and object \"${statementObject.value}\".`);\r\n  }\r\n\r\n  return targetIds.shift();\r\n}\r\n\r\n/**\r\n * For a given subject, the quad store is queried to find the assigned URI\r\n * @param subject The subject for which the assigned URI is to be retrieved\r\n * @param store The quad store\r\n * @returns An RDF.NamedNode or undefined if not found\r\n */\r\nexport function getAssignedUri(subject: RDF.Term, store: N3.Store): RDF.Term | undefined {\r\n  return store.getObjects(subject, ns.example('assignedUri'), null).shift();\r\n}\r\n\r\n/**\r\n * Finds the assigned URI in rdf:Statements\r\n * @param subject The statement subject\r\n * @param predicate The statement predicate\r\n * @param object The statement object for which the assigned URI must be found\r\n * @param store A N3 quad store\r\n * @returns An RDF.Term or undefined if not found\r\n */\r\nexport function getAssignedUriViaStatements(\r\n  subject: RDF.Term,\r\n  predicate: RDF.Term,\r\n  object: RDF.Term,\r\n  store: N3.Store,\r\n): RDF.Term | undefined {\r\n  const statementId = getTargetStatementId(subject, predicate, object, store);\r\n\r\n  if (!statementId) {\r\n    return undefined;\r\n  }\r\n\r\n  return getAssignedUri(statementId, store);\r\n}\r\n\r\n/**\r\n * Find all rdfs:labels for a given subject\r\n * @param subject The RDF.Term to find the rdfs:labels for\r\n * @param store A N3 quad store\r\n * @returns An array of RDF.Literals\r\n */\r\nexport function getLabels(subject: RDF.Term, store: N3.Store): RDF.Literal[] {\r\n  return <RDF.Literal[]>store.getObjects(subject, ns.rdfs('label'), null);\r\n}\r\n\r\n/**\r\n * Finds the rdfs:label whose language tag matches the given language\r\n * @param subject The RDF.Term to find the rdfs:label for\r\n * @param store A N3 quad store\r\n * @param language A language tag\r\n * @returns An RDF.Literal or undefined if not found\r\n */\r\nexport function getLabel(subject: RDF.Term, store: N3.Store, language?: string): RDF.Literal | undefined {\r\n  return getLabels(subject, store).find(x => x.language === (language || ''));\r\n}\r\n\r\n/**\r\n * Finds the rdfs:label for an RDF.Term in rdf:Statements\r\n * @param subject The statement subject\r\n * @param predicate The statement predicate\r\n * @param object The statement object for which the label must be found\r\n * @param store A N3 quad store\r\n * @param language A language tag\r\n * @returns An RDF.Literal or undefined if not found\r\n */\r\nexport function getLabelViaStatements(\r\n  subject: RDF.Term,\r\n  predicate: RDF.Term,\r\n  object: RDF.Term,\r\n  store: N3.Store,\r\n  language: string,\r\n): RDF.Literal | undefined {\r\n  const statementId = getTargetStatementId(subject, predicate, object, store);\r\n\r\n  if (!statementId) {\r\n    return undefined;\r\n  }\r\n\r\n  const label = getLabel(statementId, store, language);\r\n  return label || getLabel(statementId, store);\r\n}\r\n\r\n/**\r\n * Find all rdfs:comments for a given subject\r\n * @param subject The RDF.Term to find the rdfs:comments for\r\n * @param store A N3 quad store\r\n * @returns An array of RDF.Literals\r\n */\r\nexport function getDefinitions(subject: RDF.Term, store: N3.Store): RDF.Literal[] {\r\n  return <RDF.Literal[]>store.getObjects(subject, ns.rdfs('comment'), null);\r\n}\r\n\r\n/**\r\n * Finds the rdfs:comment whose language tag matches the given language\r\n * @param subject The RDF.Term to find the rdfs:comment for\r\n * @param store A N3 quad store\r\n * @param language A language tag\r\n * @returns An RDF.Literal or undefined if not found\r\n */\r\nexport function getDefinition(subject: RDF.Term, store: N3.Store, language?: string): RDF.Literal | undefined {\r\n  return getDefinitions(subject, store).find(x => x.language === (language || ''));\r\n}\r\n\r\n/**\r\n * Finds the rdfs:comment for an RDF.Term in rdf:Statements\r\n * @param subject The statement subject\r\n * @param predicate The statement predicate\r\n * @param object The statement object for which the definition must be found\r\n * @param store A N3 quad store\r\n * @param language A language tag\r\n * @returns An RDF.Literal or undefined if not found\r\n */\r\nexport function getDefinitionViaStatements(\r\n  subject: RDF.Term,\r\n  predicate: RDF.Term,\r\n  object: RDF.Term,\r\n  store: N3.Store,\r\n  language: string,\r\n): RDF.Literal | undefined {\r\n  const statementId = getTargetStatementId(subject, predicate, object, store);\r\n\r\n  if (!statementId) {\r\n    return undefined;\r\n  }\r\n\r\n  const definition = getDefinition(statementId, store, language);\r\n  return definition || getDefinition(statementId, store);\r\n}\r\n\r\n/**\r\n * Finds all the rdfs:subClassOf of a given RDF.Term\r\n * @param subject the RDF.Term to find the parents of\r\n * @param store A N3 quad store\r\n * @returns An array of RDF.Terms\r\n */\r\nexport function getParentsOfClass(subject: RDF.Term, store: N3.Store): RDF.Term[] {\r\n  return store.getObjects(subject, ns.rdfs('subClassOf'), null);\r\n}\r\n\r\n/**\r\n * Finds the rdfs:subPropertyOf of a given RDF.Term\r\n * @param subject The RDF.Term to find the parent of\r\n * @param store A N3 quad store\r\n * @returns An RDF.Term or undefined if not found\r\n */\r\nexport function getParentOfProperty(subject: RDF.Term, store: N3.Store): RDF.Term | undefined {\r\n  return store.getObjects(subject, ns.rdfs('subPropertyOf'), null).shift();\r\n}\r\n\r\n/**\r\n * Finds the rdfs:range of a given RDF.Term\r\n * @param subject The RDF.Term to find the range of\r\n * @param store A N3 quad store\r\n * @returns An RDF.Term or undefined if not found\r\n */\r\nexport function getRange(subject: RDF.Term, store: N3.Store): RDF.Term | undefined {\r\n  return store.getObjects(subject, ns.rdfs('range'), null).shift();\r\n}\r\n\r\n/**\r\n * Finds the rdfs:domain of a given RDF.Term\r\n * @param subject The RDF.Term to find the domain of\r\n * @param store A N3 quad store\r\n * @returns An RDF.Term or undefined if not found\r\n */\r\nexport function getDomain(subject: RDF.Term, store: N3.Store): RDF.Term | undefined {\r\n  return store.getObjects(subject, ns.rdfs('domain'), null).shift();\r\n}\r\n\r\n/**\r\n * Finds all the vann:usageNotes of a given RDF.Term\r\n * @param subject The RDF.Term to find the usage notes for\r\n * @param store A N3 quad store\r\n * @returns An array of RDF.Literals\r\n */\r\nexport function getUsageNotes(subject: RDF.Term, store: N3.Store): RDF.Literal[] {\r\n  return <RDF.Literal[]>store.getObjects(subject, ns.vann('usageNote'), null);\r\n}\r\n\r\n/**\r\n * Finds the vann:usageNote of which the language tag matches the given language\r\n * @param subject The RDF.Term to find the usage note for\r\n * @param store A N3 quad store\r\n * @param language A language tag\r\n * @returns An RDF.Literal or undefined if not found\r\n */\r\nexport function getUsageNote(subject: RDF.Term, store: N3.Store, language?: string): RDF.Literal | undefined {\r\n  return getUsageNotes(subject, store).find(x => x.language === (language || ''));\r\n}\r\n\r\n/**\r\n * Finds the vann:usageNote for an RDF.Term in rdf:Statements\r\n * @param subject The statement subject\r\n * @param predicate The statement predicate\r\n * @param object The statement object for which the usage note must be found\r\n * @param store A N3 quad store\r\n * @param language A language tag\r\n * @returns An RDF.Literal or undefined if not found\r\n */\r\nexport function getUsageNoteViaStatements(\r\n  subject: RDF.Term,\r\n  predicate: RDF.Term,\r\n  object: RDF.Term,\r\n  store: N3.Store,\r\n  language: string,\r\n): RDF.Literal | undefined {\r\n  const statementId = getTargetStatementId(subject, predicate, object, store);\r\n\r\n  if (!statementId) {\r\n    return undefined;\r\n  }\r\n\r\n  const usageNote = getUsageNote(statementId, store, language);\r\n  return usageNote || getUsageNote(statementId, store);\r\n}\r\n"]}