@_linked/core 2.12.0 → 2.13.0

package/lib/cjs/sparql/sparqlUtils.js

@@ -1,154 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertSafeIri = assertSafeIri;
-exports.sanitizeVarName = sanitizeVarName;
-exports.assertSafeCallName = assertSafeCallName;
-exports.formatUri = formatUri;
-exports.escapeSparqlString = escapeSparqlString;
-exports.formatLiteral = formatLiteral;
-exports.collectPrefixes = collectPrefixes;
-exports.generateEntityUri = generateEntityUri;
-const Prefix_js_1 = require("../utils/Prefix.js");
-const ulid_1 = require("ulid");
-// Characters that must never appear inside a SPARQL IRIREF (`<...>`) per the
-// SPARQL 1.1 grammar: angle brackets, quote, braces, pipe, caret, backtick,
-// backslash, and all control chars + space (U+0000–U+0020). Any of these would
-// let a crafted `id`/IRI break out of the `<...>` and inject raw SPARQL.
-const FORBIDDEN_IRI_CHARS = /[\x00-\x20<>"{}|^`\\]/;
-/**
- * Assert that a string is safe to emit as a SPARQL IRI. Throws on any character
- * that could terminate the IRIREF and inject query text. Applied to the raw IRI
- * before prefixing so the prefixed branch can't be used to smuggle a breakout.
- */
-function assertSafeIri(uri) {
-    if (typeof uri !== 'string' || FORBIDDEN_IRI_CHARS.test(uri)) {
-        throw new Error(`Invalid IRI for SPARQL output: ${JSON.stringify(uri)}. IRIs must not contain angle brackets, quotes, braces, whitespace, or control characters.`);
-    }
-}
-// SPARQL 1.1 built-in functions + aggregate names (§17.4, §18.5). Names are
-// case-insensitive in SPARQL; we compare upper-cased. Function/aggregate names
-// are emitted verbatim into query text, so a name from untrusted `fromJSON`
-// input (an S-expr head that isn't a known combinator becomes a "function
-// name") could otherwise inject raw SPARQL — this allowlist is the guard.
-const SPARQL_CALL_NAMES = new Set([
-    // string
-    'STR', 'STRLEN', 'SUBSTR', 'UCASE', 'LCASE', 'STRSTARTS', 'STRENDS',
-    'CONTAINS', 'STRBEFORE', 'STRAFTER', 'ENCODE_FOR_URI', 'CONCAT', 'LANGMATCHES',
-    'REGEX', 'REPLACE',
-    // term / type
-    'LANG', 'DATATYPE', 'BOUND', 'IRI', 'URI', 'BNODE', 'STRDT', 'STRLANG',
-    'UUID', 'STRUUID', 'SAMETERM', 'ISIRI', 'ISURI', 'ISBLANK', 'ISLITERAL',
-    'ISNUMERIC',
-    // numeric
-    'ABS', 'CEIL', 'FLOOR', 'ROUND', 'RAND',
-    // date/time
-    'YEAR', 'MONTH', 'DAY', 'HOURS', 'MINUTES', 'SECONDS', 'TIMEZONE', 'TZ', 'NOW',
-    // hash
-    'MD5', 'SHA1', 'SHA256', 'SHA384', 'SHA512',
-    // control / conditional
-    'IF', 'COALESCE',
-    // aggregates
-    'COUNT', 'SUM', 'MIN', 'MAX', 'AVG', 'SAMPLE', 'GROUP_CONCAT',
-]);
-/**
- * Sanitize a string for use as a SPARQL variable name (`?name`). Replaces any
- * character outside `[A-Za-z0-9_]` with `_`, so an alias/projection name derived
- * from untrusted input cannot break out of the `?...` variable position. Valid
- * names (already `[A-Za-z0-9_]`) are returned unchanged.
- */
-function sanitizeVarName(name) {
-    return String(name).replace(/[^A-Za-z0-9_]/g, '_');
-}
-/**
- * Assert that a function or aggregate name is a known SPARQL 1.1 builtin before
- * it is emitted verbatim into query text. Throws on anything else (e.g. an
- * attacker-supplied S-expr head), which is the SPARQL-injection guard for the
- * `function_expr` / `aggregate_expr` serialization paths.
- */
-function assertSafeCallName(name) {
-    if (typeof name !== 'string' || !SPARQL_CALL_NAMES.has(name.toUpperCase())) {
-        throw new Error(`Unsupported SPARQL function/aggregate: ${JSON.stringify(name)}. Only SPARQL 1.1 built-in functions are allowed.`);
-    }
-}
-/**
- * Format a URI for SPARQL output.
- * Returns prefixed form (e.g. `rdf:type`) if a prefix is registered and the
- * suffix doesn't contain `/`. Otherwise returns `<full-uri>`.
- * Throws if the IRI contains characters that could break out of the IRIREF.
- */
-function formatUri(uri) {
-    assertSafeIri(uri);
-    const prefixed = Prefix_js_1.Prefix.toPrefixed(uri);
-    if (prefixed)
-        return prefixed;
-    return `<${uri}>`;
-}
-/**
- * Escapes special characters in a string for use inside SPARQL double-quoted literals.
- * Per SPARQL 1.1 §19.7 (Escape sequences in strings).
- */
-function escapeSparqlString(value) {
-    return value
-        .replace(/\\/g, '\\\\')
-        .replace(/"/g, '\\"')
-        .replace(/\n/g, '\\n')
-        .replace(/\r/g, '\\r')
-        .replace(/\t/g, '\\t');
-}
-/**
- * Format a literal value for SPARQL output.
- * Returns a quoted string with optional `^^<datatype>` suffix.
- * Special characters in the value are escaped per SPARQL spec.
- */
-function formatLiteral(value, datatype) {
-    let lexical;
-    if (value instanceof Date) {
-        lexical = value.toISOString();
-    }
-    else {
-        lexical = String(value);
-    }
-    const escaped = escapeSparqlString(lexical);
-    if (datatype) {
-        return `"${escaped}"^^${formatUri(datatype)}`;
-    }
-    return `"${escaped}"`;
-}
-/**
- * Collect the minimal set of prefix→URI mappings needed for a set of URIs.
- * Only includes prefixes that are actually used (i.e. `Prefix.toPrefixed`
- * returns a value for at least one URI in the list).
- */
-function collectPrefixes(usedUris) {
-    const result = {};
-    for (const uri of usedUris) {
-        const match = Prefix_js_1.Prefix.findMatch(uri);
-        if (match.length > 0) {
-            const [ontologyUri, prefix, postFix] = match;
-            // Only include if the postfix is actually prefixable (no `/`)
-            if (!postFix.includes('/')) {
-                result[prefix] = ontologyUri;
-            }
-        }
-    }
-    return result;
-}
-/**
- * Generate a new entity URI for a create mutation.
- * Format: `{dataRoot}/{lowercaseShapeLabel}_{ulid}`
- */
-function generateEntityUri(shape, options) {
-    const dataRoot = (options === null || options === void 0 ? void 0 : options.dataRoot) || process.env.DATA_ROOT || 'http://example.org/data';
-    // Extract the shape label from the full URI (last segment after # or /)
-    let label;
-    const hashIdx = shape.lastIndexOf('#');
-    if (hashIdx >= 0) {
-        label = shape.substring(hashIdx + 1);
-    }
-    else {
-        const slashIdx = shape.lastIndexOf('/');
-        label = slashIdx >= 0 ? shape.substring(slashIdx + 1) : shape;
-    }
-    return `${dataRoot}/${label.toLowerCase()}_${(0, ulid_1.ulid)()}`;
-}
-//# sourceMappingURL=sparqlUtils.js.map

package/lib/cjs/sparql/sparqlUtils.js.map

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

package/lib/cjs/utils/LinkedErrorLogging.d.ts

@@ -1,13 +0,0 @@
-export interface IErrorLogger {
-    log?(error: any): Promise<void>;
-}
-/**
- * Utility class to log errors.
- * Install any error client package like lincd-sentry in your app to log errors.
- */
-export declare class LinkedErrorLogging {
-    private static logger;
-    static setDefaultLogger(logger: IErrorLogger): void;
-    static hasDefaultLogger(): boolean;
-    static log(error: Error): Promise<void>;
-}

package/lib/cjs/utils/LinkedErrorLogging.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LinkedErrorLogging = void 0;
-/**
- * Utility class to log errors.
- * Install any error client package like lincd-sentry in your app to log errors.
- */
-class LinkedErrorLogging {
-    static setDefaultLogger(logger) {
-        this.logger = logger;
-    }
-    static hasDefaultLogger() {
-        return this.logger && true;
-    }
-    static log(error) {
-        if (this.logger) {
-            return this.logger.log(error);
-        }
-    }
-}
-exports.LinkedErrorLogging = LinkedErrorLogging;
-//# sourceMappingURL=LinkedErrorLogging.js.map

package/lib/cjs/utils/LinkedErrorLogging.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"LinkedErrorLogging.js","sourceRoot":"","sources":["../../../src/utils/LinkedErrorLogging.ts"],"names":[],"mappings":";;;AAIA;;;GAGG;AACH,MAAa,kBAAkB;IAG7B,MAAM,CAAC,gBAAgB,CAAC,MAAoB;QAC1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,gBAAgB;QACrB,OAAO,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,KAAY;QACrB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;CACF;AAhBD,gDAgBC"}

package/lib/cjs/utils/LinkedFileStorage.d.ts

@@ -1,23 +0,0 @@
-import type { IFileStore } from '../interfaces/IFileStore.js';
-import type { Readable } from 'stream';
-export declare abstract class LinkedFileStorage {
-    private static defaultDataset;
-    private static url;
-    static get accessURL(): string;
-    static setDefaultAccessURL(accessURL: string): string;
-    static getDefaultDataset(): IFileStore;
-    static setDefaultDataset(dataset: IFileStore): void;
-    static deleteFile(filePath: string): Promise<void>;
-    static fileExists(filePath: string): Promise<boolean>;
-    static getFile(filePath: string): Promise<Buffer>;
-    static listFiles(prefix?: string): Promise<string[]>;
-    static saveFile(filePath: string, fileContent: string | Uint8Array | Buffer | Readable, mimeType?: string, preventDuplicates?: boolean): Promise<string>;
-}
-/**
- * Get the full path of an asset based on the way LinkedFileStorage is configured
- * Returns accessURL + directory (/public by default) + path
- * @param path asset path
- * @param directory asset directory (optional, default is /public)
- * @returns asset url. e.g. https://cdn.example.com/public/image.png
- */
-export declare function asset(path: string, directory?: string): string;

package/lib/cjs/utils/LinkedFileStorage.js

@@ -1,62 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LinkedFileStorage = void 0;
-exports.asset = asset;
-class LinkedFileStorage {
-    static get accessURL() {
-        // check if default store is not set, return default accessURL
-        if (!this.defaultDataset) {
-            return this.url;
-        }
-        return this.defaultDataset.accessURL;
-    }
-    static setDefaultAccessURL(accessURL) {
-        return (this.url = accessURL);
-    }
-    static getDefaultDataset() {
-        return this.defaultDataset;
-    }
-    static setDefaultDataset(dataset) {
-        this.defaultDataset = dataset;
-        if (this.defaultDataset.init) {
-            this.defaultDataset.init();
-        }
-    }
-    static deleteFile(filePath) {
-        return this.defaultDataset.deleteFile(filePath);
-    }
-    static fileExists(filePath) {
-        return this.defaultDataset.fileExists(filePath);
-    }
-    static getFile(filePath) {
-        return this.defaultDataset.getFile(filePath);
-    }
-    static listFiles(prefix) {
-        return this.defaultDataset.listFiles(prefix);
-    }
-    static saveFile(filePath, fileContent, mimeType, preventDuplicates = false) {
-        return this.defaultDataset.saveFile(filePath, fileContent, mimeType, preventDuplicates);
-    }
-}
-exports.LinkedFileStorage = LinkedFileStorage;
-/**
- * Get the full path of an asset based on the way LinkedFileStorage is configured
- * Returns accessURL + directory (/public by default) + path
- * @param path asset path
- * @param directory asset directory (optional, default is /public)
- * @returns asset url. e.g. https://cdn.example.com/public/image.png
- */
-function asset(path, directory = '/public') {
-    // Some callers pass a raw app-relative path like `/images/foo.webp`, while
-    // others may already have a fully qualified asset URL from an earlier
-    // `asset(...)` call or backend response normalization. Keep this helper
-    // idempotent so shared card/image components can safely call `asset(...)`
-    // without duplicating the access URL prefix.
-    if (/^(?:[a-z]+:)?\/\//i.test(path) || path.startsWith('data:') || path.startsWith('blob:')) {
-        return path;
-    }
-    const accessURL = LinkedFileStorage.accessURL;
-    const assetUrl = accessURL + directory + path;
-    return assetUrl;
-}
-//# sourceMappingURL=LinkedFileStorage.js.map

package/lib/cjs/utils/LinkedFileStorage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"LinkedFileStorage.js","sourceRoot":"","sources":["../../../src/utils/LinkedFileStorage.ts"],"names":[],"mappings":";;;AAsEA,sBAaC;AAhFD,MAAsB,iBAAiB;IAIrC,MAAM,KAAK,SAAS;QAClB,8DAA8D;QAC9D,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,GAAG,CAAC;QAClB,CAAC;QAED,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,mBAAmB,CAAC,SAAiB;QAC1C,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,CAAC,iBAAiB;QACtB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,iBAAiB,CAAC,OAAmB;QAC1C,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;QAE9B,IAAI,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;YAC7B,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,QAAgB;QAChC,OAAO,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,QAAgB;QAChC,OAAO,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,QAAgB;QAC7B,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,MAAe;QAC9B,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,QAAQ,CACb,QAAgB,EAChB,WAAoD,EACpD,QAAiB,EACjB,oBAA6B,KAAK;QAElC,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,CACjC,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,iBAAiB,CAClB,CAAC;IACJ,CAAC;CACF;AA1DD,8CA0DC;AAED;;;;;;GAMG;AACH,SAAgB,KAAK,CAAC,IAAY,EAAE,YAAoB,SAAS;IAC/D,2EAA2E;IAC3E,sEAAsE;IACtE,wEAAwE;IACxE,0EAA0E;IAC1E,6CAA6C;IAC7C,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5F,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC;IAC9C,MAAM,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;IAC9C,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/lib/cjs/utils/LinkedStorage.d.ts

@@ -1,40 +0,0 @@
-import { CoreSet } from '../collections/CoreSet.js';
-import type { IDataset } from '../interfaces/IDataset.js';
-import type { SelectQuery } from '../queries/SelectQuery.js';
-import type { CreateQuery } from '../queries/CreateQuery.js';
-import type { UpdateQuery } from '../queries/UpdateQuery.js';
-import type { DeleteQuery, DeleteResponse } from '../queries/DeleteQuery.js';
-/**
- * Primary routing layer (arch-04 §The IDataset abstraction).
- *
- * Resolves an incoming Linked Query to the IDataset that should handle it,
- * based on the query's target shape. Composite IDatasets (gateways, routers,
- * forwarders, resolvers) plug in here just like storage IDatasets do.
- *
- * The "Dataset" naming aligns with the IDataset contract. Earlier "Store"
- * names were renamed in phase-1 — see docs/plans/002-phase-1-create-user-project-flow.md.
- */
-export declare abstract class LinkedStorage {
-    private static defaultDataset?;
-    private static shapeToDataset;
-    /** plan-011 — how many physical copies of this module have evaluated. */
-    static getLoadedInstanceCount(): number;
-    static isInitialised(): boolean;
-    /** The catch-all IDataset for shapes with no explicit mapping. */
-    static getDefaultDataset(): IDataset;
-    /** Set the default IDataset (catch-all for shapes with no explicit mapping). */
-    static setDefaultDataset(dataset: IDataset): void;
-    /** Pin one or more shape classes to a specific IDataset implementer. */
-    static setDatasetForShapes(dataset: IDataset, ...shapeClasses: Function[]): void;
-    /** Every IDataset known to the primary router (default + all pinned). */
-    static getDatasets(): CoreSet<IDataset>;
-    /** Read-only view of the shape→IDataset map. */
-    static getShapeToDatasetMap(): Map<Function, IDataset>;
-    /** Resolve the IDataset for a given shape class. Walks the prototype chain. */
-    static getDatasetForShapeClass(shapeClass?: Function | null): IDataset | undefined;
-    private static resolveDatasetForQueryShape;
-    static selectQuery<ResultType>(query: SelectQuery): Promise<ResultType>;
-    static updateQuery<ResponseType>(query: UpdateQuery): Promise<ResponseType>;
-    static createQuery<ResponseType>(query: CreateQuery): Promise<ResponseType>;
-    static deleteQuery(query: DeleteQuery): Promise<DeleteResponse>;
-}

package/lib/cjs/utils/LinkedStorage.js

@@ -1,148 +0,0 @@
-"use strict";
-var _a;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LinkedStorage = void 0;
-const CoreSet_js_1 = require("../collections/CoreSet.js");
-const queryDispatch_js_1 = require("../queries/queryDispatch.js");
-const ShapeClass_js_1 = require("./ShapeClass.js");
-// plan-011 — count physical evaluations of THIS module on the one shared
-// global object. With the single-loader fix there should be exactly one copy;
-// the single-instance guard in backend.ts reports this count if storage config
-// ever lands on a different copy. Deliberately avoids Date/Math.random
-// (unavailable / non-deterministic per repo constraints).
-const linkedStorageGlobal = typeof globalThis !== 'undefined' ? globalThis : {};
-linkedStorageGlobal.__linkedStorageInstanceCount =
-    ((_a = linkedStorageGlobal.__linkedStorageInstanceCount) !== null && _a !== void 0 ? _a : 0) + 1;
-/**
- * Primary routing layer (arch-04 §The IDataset abstraction).
- *
- * Resolves an incoming Linked Query to the IDataset that should handle it,
- * based on the query's target shape. Composite IDatasets (gateways, routers,
- * forwarders, resolvers) plug in here just like storage IDatasets do.
- *
- * The "Dataset" naming aligns with the IDataset contract. Earlier "Store"
- * names were renamed in phase-1 — see docs/plans/002-phase-1-create-user-project-flow.md.
- */
-class LinkedStorage {
-    /** plan-011 — how many physical copies of this module have evaluated. */
-    static getLoadedInstanceCount() {
-        var _a;
-        return (_a = linkedStorageGlobal.__linkedStorageInstanceCount) !== null && _a !== void 0 ? _a : 0;
-    }
-    static isInitialised() {
-        return !!this.defaultDataset;
-    }
-    /** The catch-all IDataset for shapes with no explicit mapping. */
-    static getDefaultDataset() {
-        return this.defaultDataset;
-    }
-    /** Set the default IDataset (catch-all for shapes with no explicit mapping). */
-    static setDefaultDataset(dataset) {
-        var _a;
-        this.defaultDataset = dataset;
-        if ((_a = this.defaultDataset) === null || _a === void 0 ? void 0 : _a.init) {
-            this.defaultDataset.init();
-        }
-        (0, queryDispatch_js_1.setQueryDispatch)({
-            selectQuery: (q) => this.selectQuery(q),
-            createQuery: (q) => this.createQuery(q),
-            updateQuery: (q) => this.updateQuery(q),
-            deleteQuery: (q) => this.deleteQuery(q),
-        });
-    }
-    /** Pin one or more shape classes to a specific IDataset implementer. */
-    static setDatasetForShapes(dataset, ...shapeClasses) {
-        shapeClasses.forEach((shapeClass) => {
-            this.shapeToDataset.set(shapeClass, dataset);
-        });
-    }
-    /** Every IDataset known to the primary router (default + all pinned). */
-    static getDatasets() {
-        const datasets = new CoreSet_js_1.CoreSet();
-        if (this.defaultDataset) {
-            datasets.add(this.defaultDataset);
-        }
-        this.shapeToDataset.forEach((dataset) => datasets.add(dataset));
-        return datasets;
-    }
-    /** Read-only view of the shape→IDataset map. */
-    static getShapeToDatasetMap() {
-        return this.shapeToDataset;
-    }
-    /** Resolve the IDataset for a given shape class. Walks the prototype chain. */
-    static getDatasetForShapeClass(shapeClass) {
-        let current = shapeClass !== null && shapeClass !== void 0 ? shapeClass : null;
-        while (typeof current === 'function') {
-            const dataset = this.shapeToDataset.get(current);
-            if (dataset) {
-                return dataset;
-            }
-            const parent = Object.getPrototypeOf(current);
-            if (parent === Function.prototype || parent === null)
-                break;
-            current = parent;
-        }
-        return this.defaultDataset;
-    }
-    static resolveDatasetForQueryShape(shape) {
-        if (!shape) {
-            return this.defaultDataset;
-        }
-        if (typeof shape === 'function') {
-            return this.getDatasetForShapeClass(shape);
-        }
-        if (typeof shape === 'string') {
-            const shapeClass = (0, ShapeClass_js_1.getShapeClass)(shape);
-            return this.getDatasetForShapeClass(shapeClass);
-        }
-        // NodeShape (the closed query's `shape` accessor) — resolve via its IRI.
-        if (typeof shape === 'object' && 'id' in shape) {
-            const shapeClass = (0, ShapeClass_js_1.getShapeClass)(shape.id);
-            return this.getDatasetForShapeClass(shapeClass);
-        }
-        return this.defaultDataset;
-    }
-    static selectQuery(query) {
-        if (!(query === null || query === void 0 ? void 0 : query.shape)) {
-            return Promise.reject(new Error('Invalid select query passed to LinkedStorage.selectQuery(): missing shape.'));
-        }
-        const dataset = this.resolveDatasetForQueryShape(query.shape);
-        if (!(dataset === null || dataset === void 0 ? void 0 : dataset.selectQuery)) {
-            return Promise.reject(new Error('No query dataset configured. Call LinkedStorage.setDefaultDataset().'));
-        }
-        return dataset.selectQuery(query);
-    }
-    static updateQuery(query) {
-        if (!(query === null || query === void 0 ? void 0 : query.shape)) {
-            return Promise.reject(new Error('Invalid update query passed to LinkedStorage.updateQuery(): missing shape.'));
-        }
-        const dataset = this.resolveDatasetForQueryShape(query.shape);
-        if (!(dataset === null || dataset === void 0 ? void 0 : dataset.updateQuery)) {
-            return Promise.reject(new Error('No update handler configured on the query dataset.'));
-        }
-        return dataset.updateQuery(query);
-    }
-    static createQuery(query) {
-        if (!(query === null || query === void 0 ? void 0 : query.shape)) {
-            return Promise.reject(new Error('Invalid create query passed to LinkedStorage.createQuery(): missing shape.'));
-        }
-        const dataset = this.resolveDatasetForQueryShape(query.shape);
-        if (!(dataset === null || dataset === void 0 ? void 0 : dataset.createQuery)) {
-            return Promise.reject(new Error('No create handler configured on the query dataset.'));
-        }
-        return dataset.createQuery(query);
-    }
-    static deleteQuery(query) {
-        if (!(query === null || query === void 0 ? void 0 : query.shape)) {
-            return Promise.reject(new Error('Invalid delete query passed to LinkedStorage.deleteQuery(): missing shape.'));
-        }
-        const dataset = this.resolveDatasetForQueryShape(query.shape);
-        if (!(dataset === null || dataset === void 0 ? void 0 : dataset.deleteQuery)) {
-            return Promise.reject(new Error('No delete handler configured on the query dataset.'));
-        }
-        return dataset.deleteQuery(query);
-    }
-}
-exports.LinkedStorage = LinkedStorage;
-LinkedStorage.shapeToDataset = new Map();
-//# sourceMappingURL=LinkedStorage.js.map

package/lib/cjs/utils/LinkedStorage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"LinkedStorage.js","sourceRoot":"","sources":["../../../src/utils/LinkedStorage.ts"],"names":[],"mappings":";;;;AAAA,0DAAkD;AAMlD,kEAA6D;AAC7D,mDAA8C;AAG9C,yEAAyE;AACzE,8EAA8E;AAC9E,+EAA+E;AAC/E,uEAAuE;AACvE,0DAA0D;AAC1D,MAAM,mBAAmB,GACvB,OAAO,UAAU,KAAK,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAE,EAAU,CAAC;AAC/D,mBAAmB,CAAC,4BAA4B;IAC9C,CAAC,MAAA,mBAAmB,CAAC,4BAA4B,mCAAI,CAAC,CAAC,GAAG,CAAC,CAAC;AAE9D;;;;;;;;;GASG;AACH,MAAsB,aAAa;IAKjC,yEAAyE;IACzE,MAAM,CAAC,sBAAsB;;QAC3B,OAAO,MAAA,mBAAmB,CAAC,4BAA4B,mCAAI,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,CAAC,aAAa;QAClB,OAAO,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IAC/B,CAAC;IAED,kEAAkE;IAClE,MAAM,CAAC,iBAAiB;QACtB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,gFAAgF;IAChF,MAAM,CAAC,iBAAiB,CAAC,OAAiB;;QACxC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;QAC9B,IAAI,MAAA,IAAI,CAAC,cAAc,0CAAE,IAAI,EAAE,CAAC;YAC9B,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;QACD,IAAA,mCAAgB,EAAC;YACf,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;YACvC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;YACvC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;YACvC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;SACxC,CAAC,CAAC;IACL,CAAC;IAED,wEAAwE;IACxE,MAAM,CAAC,mBAAmB,CAAC,OAAiB,EAAE,GAAG,YAAwB;QACvE,YAAY,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;YAClC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,yEAAyE;IACzE,MAAM,CAAC,WAAW;QAChB,MAAM,QAAQ,GAAG,IAAI,oBAAO,EAAY,CAAC;QACzC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QAChE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,gDAAgD;IAChD,MAAM,CAAC,oBAAoB;QACzB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,+EAA+E;IAC/E,MAAM,CAAC,uBAAuB,CAAC,UAA4B;QACzD,IAAI,OAAO,GAAoB,UAAU,aAAV,UAAU,cAAV,UAAU,GAAI,IAAI,CAAC;QAClD,OAAO,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACjD,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YAC9C,IAAI,MAAM,KAAK,QAAQ,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI;gBAAE,MAAM;YAC5D,OAAO,GAAG,MAAM,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAEO,MAAM,CAAC,2BAA2B,CACxC,KAA4C;QAE5C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC,cAAc,CAAC;QAC7B,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,UAAU,GAAG,IAAA,6BAAa,EAAC,KAAK,CAAC,CAAC;YACxC,OAAO,IAAI,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC;QAClD,CAAC;QACD,yEAAyE;QACzE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC;YAC/C,MAAM,UAAU,GAAG,IAAA,6BAAa,EAAE,KAAsB,CAAC,EAAE,CAAC,CAAC;YAC7D,OAAO,IAAI,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,WAAW,CAAa,KAAkB;QAC/C,IAAI,CAAC,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,KAAK,CAAA,EAAE,CAAC;YAClB,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CACP,4EAA4E,CAC7E,CACF,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9D,IAAI,CAAC,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,CAAA,EAAE,CAAC;YAC1B,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAClF,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC,WAAW,CAAC,KAAK,CAAwB,CAAC;IAC3D,CAAC;IAED,MAAM,CAAC,WAAW,CAAe,KAAkB;QACjD,IAAI,CAAC,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,KAAK,CAAA,EAAE,CAAC;YAClB,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CACP,4EAA4E,CAC7E,CACF,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9D,IAAI,CAAC,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,CAAA,EAAE,CAAC;YAC1B,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAChE,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC,WAAW,CAAC,KAAK,CAA0B,CAAC;IAC7D,CAAC;IAED,MAAM,CAAC,WAAW,CAAe,KAAkB;QACjD,IAAI,CAAC,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,KAAK,CAAA,EAAE,CAAC;YAClB,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CACP,4EAA4E,CAC7E,CACF,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9D,IAAI,CAAC,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,CAAA,EAAE,CAAC;YAC1B,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAChE,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC,WAAW,CAAC,KAAK,CAA0B,CAAC;IAC7D,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,KAAkB;QACnC,IAAI,CAAC,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,KAAK,CAAA,EAAE,CAAC;YAClB,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CACP,4EAA4E,CAC7E,CACF,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9D,IAAI,CAAC,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,CAAA,EAAE,CAAC;YAC1B,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAChE,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AA7JH,sCA8JC;AA5JgB,4BAAc,GAC3B,IAAI,GAAG,EAAE,CAAC"}

package/lib/cjs/utils/NameSpace.d.ts

@@ -1,2 +0,0 @@
-import type { NodeReferenceValue } from './NodeReference.js';
-export declare const createNameSpace: (nameSpace: string) => (term: string) => NodeReferenceValue;

package/lib/cjs/utils/NameSpace.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createNameSpace = void 0;
-const createNameSpace = (nameSpace) => {
-    return (term) => ({ id: nameSpace + term });
-};
-exports.createNameSpace = createNameSpace;
-//# sourceMappingURL=NameSpace.js.map

package/lib/cjs/utils/NameSpace.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"NameSpace.js","sourceRoot":"","sources":["../../../src/utils/NameSpace.ts"],"names":[],"mappings":";;;AAEO,MAAM,eAAe,GAAG,CAAC,SAAiB,EAAE,EAAE;IACnD,OAAO,CAAC,IAAY,EAAsB,EAAE,CAAC,CAAC,EAAC,EAAE,EAAE,SAAS,GAAG,IAAI,EAAC,CAAC,CAAC;AACxE,CAAC,CAAC;AAFW,QAAA,eAAe,mBAE1B"}

package/lib/cjs/utils/NodeReference.d.ts

@@ -1,30 +0,0 @@
-export type NodeReferenceValue = {
-    id: string;
-};
-export type NodeReferenceInput = NodeReferenceValue | string;
-/**
- * Resolve a string that looks like a prefixed name (e.g. 'foaf:knows') to its full IRI.
- * - Strings containing '://' are full IRIs — returned as-is.
- * - Strings without ':' are plain IDs — returned as-is.
- * - Strings matching 'prefix:local' are resolved via Prefix.toFullIfPossible()
- *   (returns original string if prefix is not registered).
- *
- * @example
- * resolvePrefixedUri('foaf:Person')         // 'http://xmlns.com/foaf/0.1/Person'
- * resolvePrefixedUri('http://example.org/x') // 'http://example.org/x' (unchanged)
- * resolvePrefixedUri('my-id')                // 'my-id' (unchanged, no colon)
- */
-export declare function resolvePrefixedUri(str: string): string;
-/**
- * Resolve a URI string strictly: must be either a full IRI (contains '://')
- * or a registered prefixed name ('foaf:Person'). Throws if the prefix is unknown.
- *
- * Use this at API boundaries where strings are always URIs (never plain IDs).
- */
-export declare function resolveUriOrThrow(str: string): string;
-/**
- * Convert a NodeReferenceInput to a NodeReferenceValue.
- * Simple wrap — no prefix resolution. Use resolvePrefixedUri() for that.
- */
-export declare function toNodeReference(value: NodeReferenceInput): NodeReferenceValue;
-export declare function isNodeReferenceValue(value: unknown): value is NodeReferenceValue;

package/lib/cjs/utils/NodeReference.js

@@ -1,54 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolvePrefixedUri = resolvePrefixedUri;
-exports.resolveUriOrThrow = resolveUriOrThrow;
-exports.toNodeReference = toNodeReference;
-exports.isNodeReferenceValue = isNodeReferenceValue;
-const Prefix_js_1 = require("./Prefix.js");
-/**
- * Resolve a string that looks like a prefixed name (e.g. 'foaf:knows') to its full IRI.
- * - Strings containing '://' are full IRIs — returned as-is.
- * - Strings without ':' are plain IDs — returned as-is.
- * - Strings matching 'prefix:local' are resolved via Prefix.toFullIfPossible()
- *   (returns original string if prefix is not registered).
- *
- * @example
- * resolvePrefixedUri('foaf:Person')         // 'http://xmlns.com/foaf/0.1/Person'
- * resolvePrefixedUri('http://example.org/x') // 'http://example.org/x' (unchanged)
- * resolvePrefixedUri('my-id')                // 'my-id' (unchanged, no colon)
- */
-function resolvePrefixedUri(str) {
-    if (str.includes('://'))
-        return str;
-    if (!str.includes(':'))
-        return str;
-    return Prefix_js_1.Prefix.toFullIfPossible(str);
-}
-/**
- * Resolve a URI string strictly: must be either a full IRI (contains '://')
- * or a registered prefixed name ('foaf:Person'). Throws if the prefix is unknown.
- *
- * Use this at API boundaries where strings are always URIs (never plain IDs).
- */
-function resolveUriOrThrow(str) {
-    if (str.includes('://'))
-        return str;
-    return Prefix_js_1.Prefix.toFull(str);
-}
-/**
- * Convert a NodeReferenceInput to a NodeReferenceValue.
- * Simple wrap — no prefix resolution. Use resolvePrefixedUri() for that.
- */
-function toNodeReference(value) {
-    if (typeof value === 'string') {
-        return { id: value };
-    }
-    return { id: value.id };
-}
-function isNodeReferenceValue(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        'id' in value &&
-        typeof value.id === 'string');
-}
-//# sourceMappingURL=NodeReference.js.map

package/lib/cjs/utils/NodeReference.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"NodeReference.js","sourceRoot":"","sources":["../../../src/utils/NodeReference.ts"],"names":[],"mappings":";;AAkBA,gDAIC;AAQD,8CAGC;AAMD,0CAKC;AAED,oDAOC;AArDD,2CAAmC;AAMnC;;;;;;;;;;;GAWG;AACH,SAAgB,kBAAkB,CAAC,GAAW;IAC5C,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACpC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACnC,OAAO,kBAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,GAAW;IAC3C,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACpC,OAAO,kBAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,KAAyB;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAC,EAAE,EAAE,KAAK,EAAC,CAAC;IACrB,CAAC;IACD,OAAO,EAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAC,CAAC;AACxB,CAAC;AAED,SAAgB,oBAAoB,CAAC,KAAc;IACjD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,IAAI,IAAI,KAAK;QACb,OAAQ,KAA4B,CAAC,EAAE,KAAK,QAAQ,CACrD,CAAC;AACJ,CAAC"}