@the-cascade-protocol/cli 0.2.0

package/dist/lib/turtle-parser.js

@@ -0,0 +1,236 @@
+/**
+ * Turtle parsing utilities.
+ *
+ * Wraps the n3 library to provide Cascade-specific Turtle parsing
+ * with support for Cascade Protocol namespaces.
+ */
+import { Parser, Store, DataFactory } from 'n3';
+import * as fs from 'fs/promises';
+const { namedNode } = DataFactory;
+/** Well-known RDF predicates */
+const RDF_TYPE_IRI = 'http://www.w3.org/1999/02/22-rdf-syntax-ns#type';
+/** Known Cascade Protocol namespace prefixes */
+export const CASCADE_NAMESPACES = {
+    core: 'https://ns.cascadeprotocol.org/core/v1#',
+    cascade: 'https://ns.cascadeprotocol.org/core/v1#',
+    health: 'https://ns.cascadeprotocol.org/health/v1#',
+    clinical: 'https://ns.cascadeprotocol.org/clinical/v1#',
+    pots: 'https://ns.cascadeprotocol.org/pots/v1#',
+    checkup: 'https://ns.cascadeprotocol.org/checkup/v1#',
+    coverage: 'https://ns.cascadeprotocol.org/coverage/v1#',
+};
+/** Well-known non-Cascade namespaces for IRI shortening */
+const WELL_KNOWN_NAMESPACES = {
+    foaf: 'http://xmlns.com/foaf/0.1/',
+    solid: 'http://www.w3.org/ns/solid/terms#',
+    ldp: 'http://www.w3.org/ns/ldp#',
+    dct: 'http://purl.org/dc/terms/',
+    dcterms: 'http://purl.org/dc/terms/',
+    prov: 'http://www.w3.org/ns/prov#',
+    rdf: 'http://www.w3.org/1999/02/22-rdf-syntax-ns#',
+    xsd: 'http://www.w3.org/2001/XMLSchema#',
+    fhir: 'http://hl7.org/fhir/',
+    rxnorm: 'http://www.nlm.nih.gov/research/umls/rxnorm/',
+    sct: 'http://snomed.info/sct/',
+    loinc: 'http://loinc.org/rdf#',
+    icd10: 'http://hl7.org/fhir/sid/icd-10-cm/',
+    cvx: 'http://hl7.org/fhir/sid/cvx/',
+};
+/**
+ * Parse a Turtle string into quads and a Store.
+ */
+export function parseTurtle(input, baseIRI) {
+    const parser = new Parser({ baseIRI: baseIRI ?? '' });
+    const store = new Store();
+    const prefixes = {};
+    const errors = [];
+    let quads;
+    try {
+        quads = parser.parse(input, null, (prefix, prefixNode) => {
+            prefixes[prefix] = prefixNode.value;
+        });
+        store.addQuads(quads);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return {
+            success: false,
+            quads: [],
+            store,
+            quadCount: 0,
+            prefixes,
+            errors: [msg],
+            subjects: [],
+        };
+    }
+    // Extract subjects with their types
+    const subjects = extractSubjectsWithTypes(store);
+    return {
+        success: true,
+        quads,
+        store,
+        quadCount: quads.length,
+        prefixes,
+        errors,
+        subjects,
+    };
+}
+/**
+ * Extract all subjects with their rdf:type values from a store.
+ */
+function extractSubjectsWithTypes(store) {
+    const subjectMap = new Map();
+    const typeQuads = store.getQuads(null, namedNode(RDF_TYPE_IRI), null, null);
+    for (const quad of typeQuads) {
+        const subjectUri = quad.subject.value;
+        const typeUri = quad.object.value;
+        if (!subjectMap.has(subjectUri)) {
+            subjectMap.set(subjectUri, []);
+        }
+        subjectMap.get(subjectUri).push(typeUri);
+    }
+    return Array.from(subjectMap.entries()).map(([uri, types]) => ({ uri, types }));
+}
+/**
+ * Detect which Cascade Protocol vocabularies are used in a parsed Turtle file
+ * based on prefixes and type URIs.
+ */
+export function detectVocabularies(result) {
+    const vocabs = new Set();
+    // Check prefix declarations
+    for (const [, iri] of Object.entries(result.prefixes)) {
+        for (const [name, ns] of Object.entries(CASCADE_NAMESPACES)) {
+            if (iri === ns || iri.startsWith(ns.replace(/#$/, ''))) {
+                vocabs.add(name);
+            }
+        }
+    }
+    // Check type URIs
+    for (const subject of result.subjects) {
+        for (const typeUri of subject.types) {
+            for (const [name, ns] of Object.entries(CASCADE_NAMESPACES)) {
+                if (typeUri.startsWith(ns)) {
+                    vocabs.add(name);
+                }
+            }
+        }
+    }
+    // Also scan all quads for namespace usage (predicates, objects)
+    for (const quad of result.quads) {
+        const values = [quad.predicate.value, quad.object.value];
+        for (const val of values) {
+            for (const [name, ns] of Object.entries(CASCADE_NAMESPACES)) {
+                if (val.startsWith(ns)) {
+                    vocabs.add(name);
+                }
+            }
+        }
+    }
+    return Array.from(vocabs);
+}
+/**
+ * Parse a Turtle file from disk.
+ */
+export async function parseTurtleFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        return parseTurtle(content, `file://${filePath}`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            success: false,
+            quads: [],
+            store: new Store(),
+            quadCount: 0,
+            prefixes: {},
+            errors: [`Failed to read file ${filePath}: ${message}`],
+            subjects: [],
+        };
+    }
+}
+/**
+ * Return all subject URIs that have rdf:type matching the given type IRI.
+ */
+export function getSubjectsByType(store, rdfType) {
+    const subjects = store.getSubjects(namedNode(RDF_TYPE_IRI), namedNode(rdfType), null);
+    return subjects.map((s) => s.value);
+}
+/**
+ * Return all predicate-value pairs for a given subject.
+ * Returns a map of predicate IRI -> array of object values.
+ */
+export function getProperties(store, subject) {
+    const result = {};
+    const quads = store.getQuads(subject, null, null, null);
+    for (const quad of quads) {
+        const predicate = quad.predicate.value;
+        if (!result[predicate]) {
+            result[predicate] = [];
+        }
+        result[predicate].push(quad.object.value);
+    }
+    return result;
+}
+/**
+ * Count subjects of a given rdf:type.
+ */
+export function countSubjectsByType(store, rdfType) {
+    return store.countQuads(null, namedNode(RDF_TYPE_IRI), namedNode(rdfType), null);
+}
+/**
+ * Get all unique rdf:type values in the store.
+ */
+export function getAllTypes(store) {
+    const objects = store.getObjects(null, namedNode(RDF_TYPE_IRI), null);
+    const types = new Set();
+    for (const obj of objects) {
+        types.add(obj.value);
+    }
+    return Array.from(types);
+}
+/**
+ * Shorten a full IRI using known Cascade namespace prefixes.
+ * Returns the prefixed form (e.g., "health:MedicationRecord") or the full IRI if no match.
+ */
+export function shortenIRI(iri, prefixes) {
+    const allPrefixes = {
+        ...CASCADE_NAMESPACES,
+        ...WELL_KNOWN_NAMESPACES,
+        ...(prefixes ?? {}),
+    };
+    for (const [prefix, namespace] of Object.entries(allPrefixes)) {
+        if (iri.startsWith(namespace)) {
+            return `${prefix}:${iri.slice(namespace.length)}`;
+        }
+    }
+    return iri;
+}
+/**
+ * Extract a human-readable label for a record from its properties.
+ * Tries common name predicates in order of preference.
+ */
+export function extractLabel(props) {
+    const namePredicates = [
+        CASCADE_NAMESPACES.health + 'medicationName',
+        CASCADE_NAMESPACES.health + 'conditionName',
+        CASCADE_NAMESPACES.health + 'allergen',
+        CASCADE_NAMESPACES.clinical + 'supplementName',
+        CASCADE_NAMESPACES.clinical + 'vaccineName',
+        CASCADE_NAMESPACES.health + 'vaccineName',
+        CASCADE_NAMESPACES.health + 'testName',
+        CASCADE_NAMESPACES.health + 'labTestName',
+        CASCADE_NAMESPACES.clinical + 'planName',
+        CASCADE_NAMESPACES.cascade + 'planName',
+        'http://xmlns.com/foaf/0.1/name',
+        'http://xmlns.com/foaf/0.1/givenName',
+        'http://purl.org/dc/terms/title',
+    ];
+    for (const pred of namePredicates) {
+        if (props[pred]?.[0]) {
+            return props[pred][0];
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=turtle-parser.js.map

package/dist/lib/turtle-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turtle-parser.js","sourceRoot":"","sources":["../../src/lib/turtle-parser.ts"],"names":[],"mappings":"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"}