@_linked/core 2.12.0 → 2.13.0

package/lib/cjs/sparql/SparqlAlgebra.d.ts

@@ -1,190 +0,0 @@
-export type SparqlTerm = {
-    kind: 'variable';
-    name: string;
-} | {
-    kind: 'iri';
-    value: string;
-} | {
-    kind: 'literal';
-    value: string;
-    datatype?: string;
-    language?: string;
-} | {
-    kind: 'path';
-    value: string;
-    uris: string[];
-};
-export type SparqlTriple = {
-    subject: SparqlTerm;
-    predicate: SparqlTerm;
-    object: SparqlTerm;
-};
-export type SparqlAlgebraNode = SparqlBGP | SparqlJoin | SparqlLeftJoin | SparqlFilter | SparqlUnion | SparqlMinus | SparqlExtend | SparqlGraph | SparqlValues | SparqlSubSelect;
-export type SparqlBGP = {
-    type: 'bgp';
-    triples: SparqlTriple[];
-};
-export type SparqlJoin = {
-    type: 'join';
-    left: SparqlAlgebraNode;
-    right: SparqlAlgebraNode;
-};
-export type SparqlLeftJoin = {
-    type: 'left_join';
-    left: SparqlAlgebraNode;
-    right: SparqlAlgebraNode;
-    condition?: SparqlExpression;
-};
-export type SparqlFilter = {
-    type: 'filter';
-    expression: SparqlExpression;
-    inner: SparqlAlgebraNode;
-};
-export type SparqlUnion = {
-    type: 'union';
-    left: SparqlAlgebraNode;
-    right: SparqlAlgebraNode;
-};
-export type SparqlMinus = {
-    type: 'minus';
-    left: SparqlAlgebraNode;
-    right: SparqlAlgebraNode;
-};
-export type SparqlExtend = {
-    type: 'extend';
-    inner: SparqlAlgebraNode;
-    variable: string;
-    expression: SparqlExpression;
-};
-export type SparqlGraph = {
-    type: 'graph';
-    iri: string;
-    inner: SparqlAlgebraNode;
-};
-export type SparqlValues = {
-    type: 'values';
-    variable: string;
-    iris: string[];
-};
-/**
- * A nested sub-SELECT used as a group graph pattern inside a WHERE block.
- *
- * Emitted for nested-select inner LIMIT/OFFSET: the root→child traverse is
- * wrapped in `{ SELECT <projection> WHERE { <inner> } ORDER BY … LIMIT … OFFSET … }`
- * so the related collection is bounded per parent. Only valid when the outer
- * query targets a single root subject (see irToAlgebra).
- */
-export type SparqlSubSelect = {
-    type: 'subselect';
-    projection: string[];
-    inner: SparqlAlgebraNode;
-    orderBy?: SparqlOrderCondition[];
-    limit?: number;
-    offset?: number;
-};
-export type SparqlExpression = SparqlVariableExpr | SparqlIriExpr | SparqlLiteralExpr | SparqlBinaryExpr | SparqlLogicalExpr | SparqlNotExpr | SparqlFunctionExpr | SparqlAggregateExpr | SparqlExistsExpr | SparqlBoundExpr | SparqlInExpr;
-/** Membership test — `value IN (list)` / `value NOT IN (list)`. */
-export type SparqlInExpr = {
-    kind: 'in_expr';
-    negated: boolean;
-    value: SparqlExpression;
-    list: SparqlExpression[];
-};
-export type SparqlVariableExpr = {
-    kind: 'variable_expr';
-    name: string;
-};
-export type SparqlIriExpr = {
-    kind: 'iri_expr';
-    value: string;
-};
-export type SparqlLiteralExpr = {
-    kind: 'literal_expr';
-    value: string;
-    datatype?: string;
-};
-export type SparqlBinaryExpr = {
-    kind: 'binary_expr';
-    op: string;
-    left: SparqlExpression;
-    right: SparqlExpression;
-};
-export type SparqlLogicalExpr = {
-    kind: 'logical_expr';
-    op: 'and' | 'or';
-    exprs: SparqlExpression[];
-};
-export type SparqlNotExpr = {
-    kind: 'not_expr';
-    inner: SparqlExpression;
-};
-export type SparqlFunctionExpr = {
-    kind: 'function_expr';
-    name: string;
-    args: SparqlExpression[];
-};
-export type SparqlAggregateExpr = {
-    kind: 'aggregate_expr';
-    name: string;
-    args: SparqlExpression[];
-    distinct?: boolean;
-};
-export type SparqlExistsExpr = {
-    kind: 'exists_expr';
-    pattern: SparqlAlgebraNode;
-    negated: boolean;
-};
-export type SparqlBoundExpr = {
-    kind: 'bound_expr';
-    variable: string;
-};
-export type SparqlProjectionItem = {
-    kind: 'variable';
-    name: string;
-} | {
-    kind: 'aggregate';
-    expression: SparqlAggregateExpr;
-    alias: string;
-} | {
-    kind: 'expression';
-    expression: SparqlExpression;
-    alias: string;
-};
-export type SparqlOrderCondition = {
-    expression: SparqlExpression;
-    direction: 'ASC' | 'DESC';
-};
-export type SparqlAggregateBinding = {
-    variable: string;
-    aggregate: SparqlAggregateExpr;
-};
-export type SparqlSelectPlan = {
-    type: 'select';
-    algebra: SparqlAlgebraNode;
-    projection: SparqlProjectionItem[];
-    distinct?: boolean;
-    orderBy?: SparqlOrderCondition[];
-    limit?: number;
-    offset?: number;
-    groupBy?: string[];
-    having?: SparqlExpression;
-    aggregates?: SparqlAggregateBinding[];
-};
-export type SparqlInsertDataPlan = {
-    type: 'insert_data';
-    triples: SparqlTriple[];
-    graph?: string;
-};
-export type SparqlDeleteInsertPlan = {
-    type: 'delete_insert';
-    deletePatterns: SparqlTriple[];
-    insertPatterns: SparqlTriple[];
-    whereAlgebra: SparqlAlgebraNode;
-    graph?: string;
-};
-export type SparqlDeleteWherePlan = {
-    type: 'delete_where';
-    patterns: SparqlAlgebraNode;
-    graph?: string;
-};
-export type SparqlPlan = SparqlSelectPlan | SparqlInsertDataPlan | SparqlDeleteInsertPlan | SparqlDeleteWherePlan;

package/lib/cjs/sparql/SparqlAlgebra.js

@@ -1,4 +0,0 @@
-"use strict";
-// --- Term types ---
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=SparqlAlgebra.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"SparqlAlgebra.js","sourceRoot":"","sources":["../../../src/sparql/SparqlAlgebra.ts"],"names":[],"mappings":";AAAA,qBAAqB"}

package/lib/cjs/sparql/SparqlDataset.d.ts

@@ -1,60 +0,0 @@
-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';
-import type { SelectResult, CreateResult, UpdateResult } from '../queries/IntermediateRepresentation.js';
-import type { SparqlJsonResults } from './resultMapping.js';
-import { type SparqlOptions } from './sparqlUtils.js';
-import { Shape } from '../shapes/Shape.js';
-/**
- * Abstract base class for SPARQL-backed datasets.
- *
- * Extends Shape so dataset configurations can themselves be persisted as linked data.
- * Handles the full pipeline: IR query → SPARQL string → execute → map results.
- * Subclasses only need to implement the two transport methods:
- * - `executeSparqlSelect` — send a SPARQL SELECT and return JSON results
- * - `executeSparqlUpdate` — send a SPARQL UPDATE (INSERT DATA / DELETE..INSERT / etc.)
- *
- * Example subclass (Fuseki):
- * ```ts
- * class FusekiDataset extends SparqlDataset {
- *   constructor(baseUrl: string, dataset: string) {
- *     super({ dataRoot: 'http://data.example.org' });
- *     this.queryEndpoint = `${baseUrl}/${dataset}/sparql`;
- *     this.updateEndpoint = `${baseUrl}/${dataset}/update`;
- *   }
- *   protected async executeSparqlSelect(sparql: string) {
- *     const res = await fetch(this.queryEndpoint, { ... });
- *     return res.json();
- *   }
- *   protected async executeSparqlUpdate(sparql: string) {
- *     await fetch(this.updateEndpoint, { ... });
- *   }
- * }
- * ```
- */
-export declare abstract class SparqlDataset extends Shape implements IDataset {
-    protected options?: SparqlOptions;
-    constructor(options?: SparqlOptions);
-    /**
-     * Send a SPARQL SELECT/ASK/CONSTRUCT query and return the parsed
-     * SPARQL JSON Results (application/sparql-results+json).
-     */
-    protected abstract executeSparqlSelect(sparql: string): Promise<SparqlJsonResults>;
-    /**
-     * Send a SPARQL UPDATE request (INSERT DATA, DELETE/INSERT, etc.).
-     * No return value — the update is fire-and-forget at the SPARQL level.
-     */
-    protected abstract executeSparqlUpdate(sparql: string): Promise<void>;
-    selectQuery(query: SelectQuery): Promise<SelectResult>;
-    createQuery(query: CreateQuery): Promise<CreateResult>;
-    updateQuery(query: UpdateQuery): Promise<UpdateResult>;
-    deleteQuery(query: DeleteQuery): Promise<DeleteResponse>;
-    /**
-     * Execute a raw SPARQL query string directly against the dataset.
-     * Defaults to SELECT; pass `'update'` for INSERT/DELETE operations.
-     */
-    rawQuery(sparql: string, mode?: 'query' | 'update'): Promise<SparqlJsonResults | void>;
-}
-export { SparqlDataset as SparqlStore };

package/lib/cjs/sparql/SparqlDataset.js

@@ -1,117 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SparqlStore = exports.SparqlDataset = void 0;
-const irToAlgebra_js_1 = require("./irToAlgebra.js");
-const resultMapping_js_1 = require("./resultMapping.js");
-const sparqlUtils_js_1 = require("./sparqlUtils.js");
-const Shape_js_1 = require("../shapes/Shape.js");
-const lower_js_1 = require("../queries/lower.js");
-/**
- * Abstract base class for SPARQL-backed datasets.
- *
- * Extends Shape so dataset configurations can themselves be persisted as linked data.
- * Handles the full pipeline: IR query → SPARQL string → execute → map results.
- * Subclasses only need to implement the two transport methods:
- * - `executeSparqlSelect` — send a SPARQL SELECT and return JSON results
- * - `executeSparqlUpdate` — send a SPARQL UPDATE (INSERT DATA / DELETE..INSERT / etc.)
- *
- * Example subclass (Fuseki):
- * ```ts
- * class FusekiDataset extends SparqlDataset {
- *   constructor(baseUrl: string, dataset: string) {
- *     super({ dataRoot: 'http://data.example.org' });
- *     this.queryEndpoint = `${baseUrl}/${dataset}/sparql`;
- *     this.updateEndpoint = `${baseUrl}/${dataset}/update`;
- *   }
- *   protected async executeSparqlSelect(sparql: string) {
- *     const res = await fetch(this.queryEndpoint, { ... });
- *     return res.json();
- *   }
- *   protected async executeSparqlUpdate(sparql: string) {
- *     await fetch(this.updateEndpoint, { ... });
- *   }
- * }
- * ```
- */
-class SparqlDataset extends Shape_js_1.Shape {
-    constructor(options) {
-        super();
-        this.options = options;
-    }
-    selectQuery(query) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const ir = (0, lower_js_1.lower)(query);
-            const sparql = (0, irToAlgebra_js_1.selectToSparql)(ir, this.options);
-            const json = yield this.executeSparqlSelect(sparql);
-            return (0, resultMapping_js_1.mapSparqlSelectResult)(json, ir);
-        });
-    }
-    createQuery(query) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const ir = (0, lower_js_1.lower)(query);
-            const uri = ir.data.id || (0, sparqlUtils_js_1.generateEntityUri)(ir.data.shape, this.options);
-            ir.data.id = uri;
-            const sparql = (0, irToAlgebra_js_1.createToSparql)(ir, this.options);
-            yield this.executeSparqlUpdate(sparql);
-            return (0, resultMapping_js_1.mapSparqlCreateResult)(uri, ir);
-        });
-    }
-    updateQuery(query) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const ir = (0, lower_js_1.lower)(query);
-            if (ir.kind === 'update_where') {
-                const sparql = (0, irToAlgebra_js_1.updateWhereToSparql)(ir, this.options);
-                yield this.executeSparqlUpdate(sparql);
-                return { id: '' };
-            }
-            const sparql = (0, irToAlgebra_js_1.updateToSparql)(ir, this.options);
-            yield this.executeSparqlUpdate(sparql);
-            return (0, resultMapping_js_1.mapSparqlUpdateResult)(ir);
-        });
-    }
-    deleteQuery(query) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const ir = (0, lower_js_1.lower)(query);
-            if (ir.kind === 'delete_all') {
-                const sparql = (0, irToAlgebra_js_1.deleteAllToSparql)(ir, this.options);
-                yield this.executeSparqlUpdate(sparql);
-                return { deleted: [], count: 0 };
-            }
-            if (ir.kind === 'delete_where') {
-                const sparql = (0, irToAlgebra_js_1.deleteWhereToSparql)(ir, this.options);
-                yield this.executeSparqlUpdate(sparql);
-                return { deleted: [], count: 0 };
-            }
-            const sparql = (0, irToAlgebra_js_1.deleteToSparql)(ir, this.options);
-            yield this.executeSparqlUpdate(sparql);
-            return {
-                deleted: ir.ids,
-                count: ir.ids.length,
-            };
-        });
-    }
-    /**
-     * Execute a raw SPARQL query string directly against the dataset.
-     * Defaults to SELECT; pass `'update'` for INSERT/DELETE operations.
-     */
-    rawQuery(sparql, mode) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (mode === 'update') {
-                return this.executeSparqlUpdate(sparql);
-            }
-            return this.executeSparqlSelect(sparql);
-        });
-    }
-}
-exports.SparqlDataset = SparqlDataset;
-exports.SparqlStore = SparqlDataset;
-//# sourceMappingURL=SparqlDataset.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"SparqlDataset.js","sourceRoot":"","sources":["../../../src/sparql/SparqlDataset.ts"],"names":[],"mappings":";;;;;;;;;;;;AAWA,qDAQ0B;AAC1B,yDAI4B;AAC5B,qDAAuE;AACvE,iDAAyC;AACzC,kDAA0C;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAsB,aAAc,SAAQ,gBAAK;IAG/C,YAAY,OAAuB;QACjC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAgBK,WAAW,CAAC,KAAkB;;YAClC,MAAM,EAAE,GAAG,IAAA,gBAAK,EAAC,KAAK,CAAC,CAAC;YACxB,MAAM,MAAM,GAAG,IAAA,+BAAc,EAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAChD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;YACpD,OAAO,IAAA,wCAAqB,EAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACzC,CAAC;KAAA;IAEK,WAAW,CAAC,KAAkB;;YAClC,MAAM,EAAE,GAAG,IAAA,gBAAK,EAAC,KAAK,CAAC,CAAC;YACxB,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,IAAA,kCAAiB,EAAC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACzE,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC;YACjB,MAAM,MAAM,GAAG,IAAA,+BAAc,EAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAChD,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;YACvC,OAAO,IAAA,wCAAqB,EAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACxC,CAAC;KAAA;IAEK,WAAW,CAAC,KAAkB;;YAClC,MAAM,EAAE,GAAG,IAAA,gBAAK,EAAC,KAAK,CAAC,CAAC;YACxB,IAAI,EAAE,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBAC/B,MAAM,MAAM,GAAG,IAAA,oCAAmB,EAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;gBACrD,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;gBACvC,OAAO,EAAC,EAAE,EAAE,EAAE,EAAiB,CAAC;YAClC,CAAC;YACD,MAAM,MAAM,GAAG,IAAA,+BAAc,EAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAChD,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;YACvC,OAAO,IAAA,wCAAqB,EAAC,EAAE,CAAC,CAAC;QACnC,CAAC;KAAA;IAEK,WAAW,CAAC,KAAkB;;YAClC,MAAM,EAAE,GAAG,IAAA,gBAAK,EAAC,KAAK,CAAC,CAAC;YACxB,IAAI,EAAE,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAG,IAAA,kCAAiB,EAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;gBACnD,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;gBACvC,OAAO,EAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAC,CAAC;YACjC,CAAC;YACD,IAAI,EAAE,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBAC/B,MAAM,MAAM,GAAG,IAAA,oCAAmB,EAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;gBACrD,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;gBACvC,OAAO,EAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAC,CAAC;YACjC,CAAC;YACD,MAAM,MAAM,GAAG,IAAA,+BAAc,EAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAChD,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;YACvC,OAAO;gBACL,OAAO,EAAE,EAAE,CAAC,GAAG;gBACf,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM;aACrB,CAAC;QACJ,CAAC;KAAA;IAED;;;OAGG;IACG,QAAQ,CACZ,MAAc,EACd,IAAyB;;YAEzB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;YAC1C,CAAC;YACD,OAAO,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;KAAA;CACF;AAnFD,sCAmFC;AAGwB,oCAAW"}

package/lib/cjs/sparql/algebraToString.d.ts

@@ -1,13 +0,0 @@
-import type { SparqlAlgebraNode, SparqlExpression, SparqlTerm, SparqlSelectPlan, SparqlInsertDataPlan, SparqlDeleteInsertPlan, SparqlDeleteWherePlan } from './SparqlAlgebra.js';
-import { type SparqlOptions } from './sparqlUtils.js';
-type UriCollector = {
-    uris: Set<string>;
-};
-export declare function serializeTerm(term: SparqlTerm, collector?: UriCollector): string;
-export declare function serializeExpression(expr: SparqlExpression, collector?: UriCollector): string;
-export declare function serializeAlgebraNode(node: SparqlAlgebraNode, collector?: UriCollector): string;
-export declare function selectPlanToSparql(plan: SparqlSelectPlan, _options?: SparqlOptions): string;
-export declare function insertDataPlanToSparql(plan: SparqlInsertDataPlan, _options?: SparqlOptions): string;
-export declare function deleteInsertPlanToSparql(plan: SparqlDeleteInsertPlan, _options?: SparqlOptions): string;
-export declare function deleteWherePlanToSparql(plan: SparqlDeleteWherePlan, _options?: SparqlOptions): string;
-export {};