sparkql 0.1.0-alpha.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Burak Mehmet Ekmekçi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,198 @@
+# sparkql
+
+A TypeScript query builder for SPARQL with type-safe operations and intuitive API.
+
+**This library is currently in alpha and should not be used in production.** The API is subject to change and may
+contain bugs or incomplete features.
+
+## Installation
+
+```bash
+npm install sparkql@alpha
+```
+
+## Features
+
+- **Type-safe** - Full TypeScript support with type inference
+- **Fluent API** - Chainable query builder interface
+- **Query Types** - Support for SELECT, ASK, CONSTRUCT, DESCRIBE, and UPDATE queries
+- **Prefix Management** - Easy prefix definition and IRI handling
+- **Aggregates** - Built-in aggregate functions (COUNT, SUM, AVG, etc.)
+- **Transformations** - Type-safe data transformations
+- **SPARQL Client** - Built-in HTTP client for executing queries
+- **Path Expressions** - Property path support
+- **Functions** - Comprehensive SPARQL function support
+
+## Quick Start
+
+```typescript
+import { SparqlDatabase, triple } from 'sparkql';
+
+const prefixes = {
+  foaf: {
+    uri: 'http://xmlns.com/foaf/0.1/',
+      fields: []
+  },
+  rdf: {
+    uri: 'http://www.w3.org/1999/02/22-rdf-syntax-ns#',
+    fields: []
+  }
+}
+
+// Create a database instance with prefixes
+const db = SparqlDatabase.create({
+  prefixes: prefixes,
+  endpointUrl: 'https://your-sparql-endpoint.com/sparql'
+});
+
+// Create variable and IRI managers
+const [v, n] = db.create([], prefixes);
+
+// Build and execute a SELECT query
+const results = await db
+  .select({
+    name: v.name,
+    age: v.age
+  })
+  .where(
+    triple(v.person, n.foaf.name, v.name),
+    triple(v.person, n.foaf.age, v.age)
+  )
+  .limit(10);
+
+console.log(results); // Type-safe results
+```
+
+## Building Queries
+
+### SELECT Queries
+
+```typescript
+import { triple, asc } from 'sparkql';
+
+const query = db
+  .select({
+    name: v.name,
+    email: v.email
+  })
+  .where(
+    triple(v.person, n.foaf.name, v.name),
+    triple(v.person, n.foaf.mbox, v.email)
+  )
+  .orderBy(asc(v.name))
+  .limit(100);
+
+// Get SPARQL string
+const sparql = query.toSPARQL();
+
+// Execute query
+const results = await query;
+```
+
+### ASK Queries
+
+```typescript
+import { triple } from 'sparkql';
+
+const exists = await db
+  .ask()
+  .where(
+    triple(v.s, n.rdf.type, n.foaf.Person)
+  );
+
+console.log(exists); // boolean
+```
+
+### CONSTRUCT Queries
+
+```typescript
+import { triple } from 'sparkql';
+
+const triples = await db
+  .construct(
+    triple(v.person, n.rdf.type, n.foaf.Person)
+  )
+  .where(
+    triple(v.person, n.foaf.name, v.name)
+  );
+```
+
+### UPDATE Queries
+
+```typescript
+import { triple } from 'sparkql';
+
+await db
+  .update()
+  .insert(
+    triple(db.iri('ex:person1'), n.foaf.name, db.literal('John Doe'))
+  );
+```
+
+## Advanced Features
+
+### Aggregates
+
+```typescript
+import { triple, as, count, avg } from 'sparkql';
+
+const stats = await db
+  .select({
+    count: v.count,
+    avgAge: v.avgAge
+  })
+  .where(
+    ...triples(v.person, predicates(
+        [n.rdf.type, n.foaf.Person],
+        [n.foaf.age, v.age]
+    ))
+  )
+  .groupBy()
+  .having(
+    as(count(v.person), v.count),
+    as(avg(v.age), v.avgAge)
+  );
+```
+
+### Optional Patterns
+
+```typescript
+import { triple, optional } from 'sparkql';
+
+const results = await db
+  .select({
+    name: v.name,
+    email: v.email
+  })
+  .where(
+    triple(v.person, n.foaf.name, v.name),
+    optional(
+      triple(v.person, n.foaf.mbox, v.email)
+    )
+  );
+```
+
+### Filters
+
+```typescript
+import { triple, filter, gt } from 'sparkql';
+
+const filtered = await db
+  .select({
+    name: v.name,
+    age: v.age
+  })
+  .where(
+    triple(v.person, n.foaf.name, v.name),
+    triple(v.person, n.foaf.age, v.age),
+    filter(gt(v.age, 18))
+  );
+```
+
+## Roadmap
+
+_Will be updated as the library matures..._
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a pull request.

package/dist/database/ask.d.ts

@@ -0,0 +1,6 @@
+import { QueryBuilderBase } from './query.js';
+import { AskQuery, FactoryFunctions, SparqlClient } from '../generic.js';
+export declare class AskQueryBuilderBase extends QueryBuilderBase<AskQuery, boolean> implements PromiseLike<boolean> {
+    constructor(prefixes: AskQuery['prefixes'], base: string | undefined, factoryFunctions: FactoryFunctions, endpointUrl?: string);
+    protected makeQuery(client: SparqlClient): Promise<boolean>;
+}

package/dist/database/ask.js

@@ -0,0 +1,15 @@
+import { QueryBuilderBase } from './query.js';
+export class AskQueryBuilderBase extends QueryBuilderBase {
+    constructor(prefixes, base, factoryFunctions, endpointUrl) {
+        super({
+            type: 'query',
+            queryType: 'ASK',
+            base: base,
+            prefixes: prefixes,
+        }, factoryFunctions, endpointUrl);
+    }
+    async makeQuery(client) {
+        return client.query.ask(this.toSPARQL());
+    }
+}
+//# sourceMappingURL=ask.js.map

package/dist/database/ask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.js","sourceRoot":"","sources":["../../src/database/ask.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,MAAM,OAAO,mBACX,SAAQ,gBAAmC;IAG3C,YACE,QAA8B,EAC9B,IAAwB,EACxB,gBAAkC,EAClC,WAAoB;QAEpB,KAAK,CACH;YACE,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,KAAK;YAChB,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,QAAQ;SACnB,EACD,gBAAgB,EAChB,WAAW,CACZ,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,SAAS,CAAC,MAAoB;QAC5C,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/database/base.d.ts

@@ -0,0 +1,42 @@
+import { IriManagerConfig, VariableManagerConfig } from '../structures/index.js';
+import * as SparqlJs from 'sparqljs';
+import * as RdfJs from 'rdf-data-factory';
+import { AskQueryBuilderBase } from './ask.js';
+import { UpdateQueryBuilderBase } from './update.js';
+import { SelectedVariables, InferredSelectResult, SelectQueryBuilderBase, TypedSelectedVariables } from './select.js';
+import { DescribeQueryBuilderBase, DescribeVariables } from './describe.js';
+import { ConstructQueryBuilderBase, ConstructTemplates } from './construct.js';
+import { ExcludePrefix, FactoryFunctions, IriTerm, Strictness, Variable } from '../generic.js';
+export interface SparqlDatabaseOptions<T extends IriManagerConfig, K extends string = 'g_'> {
+    prefixes?: T;
+    blankNodePrefix?: K;
+    endpointUrl?: string;
+}
+export declare class SparqlDatabase<T extends IriManagerConfig, K extends string = 'g_'> {
+    private readonly nodes;
+    private readonly queryBase?;
+    private readonly endpointUrl?;
+    private readonly queryPrefixes;
+    private readonly blankNodePrefix;
+    protected readonly factory: RdfJs.DataFactory;
+    protected readonly factoryFunctions: FactoryFunctions<K>;
+    private constructor();
+    static create<T extends IriManagerConfig, K extends string = 'g_'>(options?: SparqlDatabaseOptions<T, K>): SparqlDatabase<T, K>;
+    base(value: string): SparqlDatabase<T, K>;
+    select<U extends SelectedVariables>(variables?: U): SelectQueryBuilderBase<InferredSelectResult<U>>;
+    select<U extends Record<string, any>>(variables?: TypedSelectedVariables<U>): SelectQueryBuilderBase<U>;
+    selectDistinct<U extends Record<string, Variable<any, any>>>(variables?: U): SelectQueryBuilderBase<InferredSelectResult<U>>;
+    selectDistinct<U extends Record<string, any>>(variables?: TypedSelectedVariables<U>): SelectQueryBuilderBase<U>;
+    selectReduced<U extends Record<string, Variable<any, any>>>(variables?: U): SelectQueryBuilderBase<InferredSelectResult<U>>;
+    selectReduced<U extends Record<string, any>>(variables?: TypedSelectedVariables<U>): SelectQueryBuilderBase<U>;
+    ask(): AskQueryBuilderBase;
+    describe(...variables: DescribeVariables): DescribeQueryBuilderBase;
+    construct(...templates: ConstructTemplates): ConstructQueryBuilderBase;
+    update(): UpdateQueryBuilderBase;
+    variable: (value: string) => SparqlJs.VariableTerm;
+    iri: <T_1 extends string>(value: T_1) => SparqlJs.IriTerm;
+    blank: <T_1 extends string>(value?: ExcludePrefix<T_1, K>) => SparqlJs.BlankTerm;
+    literal: (value: string, lang?: string | IriTerm) => SparqlJs.LiteralTerm;
+    resetBlankCounter(): void;
+    create<T extends string, K extends IriManagerConfig, P extends Strictness = Strictness.loose>(variableKeys: readonly VariableManagerConfig<T>[], nodeConfig: K, mode?: P): readonly [import("../structures/variable.js").VariableManager<T, Strictness.loose | P>, import("../structures/iri.js").IriManager<K, Strictness.loose | P>, import("../structures/blank.js").BlankManager<K_1>];
+}

package/dist/database/base.js

@@ -0,0 +1,87 @@
+import { createBlankManager, createIriManager, createVariableManager, transformIntoPrefixObject, } from '../structures/index.js';
+import * as RdfJs from 'rdf-data-factory';
+import { AskQueryBuilderBase } from './ask.js';
+import { UpdateQueryBuilderBase } from './update.js';
+import { SelectQueryBuilderBase, } from './select.js';
+import { DescribeQueryBuilderBase } from './describe.js';
+import { ConstructQueryBuilderBase } from './construct.js';
+import { Strictness } from '../generic.js';
+export class SparqlDatabase {
+    constructor(options) {
+        this.variable = (value) => {
+            return Object.freeze(this.factory.variable(value));
+        };
+        this.iri = (value) => {
+            return Object.freeze(this.factory.namedNode(value));
+        };
+        this.blank = (value) => {
+            if (value && value.startsWith(this.blankNodePrefix)) {
+                throw Error(`For blank terms, the prefix "${this.blankNodePrefix}" is reserved for internal use.`);
+            }
+            return Object.freeze(this.factory.blankNode(value));
+        };
+        this.literal = (value, lang) => {
+            return Object.freeze(this.factory.literal(value, lang));
+        };
+        this.nodes = options?.prefixes;
+        this.queryBase = options?.base;
+        this.endpointUrl = options?.endpointUrl;
+        this.blankNodePrefix = options?.blankNodePrefix ?? 'g_';
+        this.queryPrefixes = transformIntoPrefixObject(options?.prefixes ?? {});
+        this.factory =
+            options?.factory ?? new RdfJs.DataFactory({ blankNodePrefix: this.blankNodePrefix });
+        this.factoryFunctions = {
+            variable: this.variable,
+            iri: this.iri,
+            blank: this.blank,
+            literal: this.literal,
+        };
+    }
+    static create(options) {
+        const blankNodePrefix = options?.blankNodePrefix ?? 'g_';
+        const factory = new RdfJs.DataFactory({ blankNodePrefix });
+        return new SparqlDatabase({
+            ...options,
+            factory: factory,
+        });
+    }
+    base(value) {
+        return new SparqlDatabase({
+            blankNodePrefix: this.blankNodePrefix,
+            prefixes: this.nodes,
+            factory: this.factory,
+            base: value,
+        });
+    }
+    select(variables) {
+        return new SelectQueryBuilderBase(variables, this.queryPrefixes, this.queryBase, this.factoryFunctions, undefined, undefined, this.endpointUrl);
+    }
+    selectDistinct(variables) {
+        return new SelectQueryBuilderBase(variables, this.queryPrefixes, this.queryBase, this.factoryFunctions, true, undefined, this.endpointUrl);
+    }
+    selectReduced(variables) {
+        return new SelectQueryBuilderBase(variables, this.queryPrefixes, this.queryBase, this.factoryFunctions, undefined, true, this.endpointUrl);
+    }
+    ask() {
+        return new AskQueryBuilderBase(this.queryPrefixes, this.queryBase, this.factoryFunctions, this.endpointUrl);
+    }
+    describe(...variables) {
+        return new DescribeQueryBuilderBase(variables, this.queryPrefixes, this.queryBase, this.factoryFunctions, this.endpointUrl);
+    }
+    construct(...templates) {
+        return new ConstructQueryBuilderBase(templates, this.queryPrefixes, this.queryBase, this.factoryFunctions, this.endpointUrl);
+    }
+    update() {
+        return new UpdateQueryBuilderBase([], this.queryPrefixes, this.queryBase, this.factoryFunctions, this.endpointUrl);
+    }
+    resetBlankCounter() {
+        this.factory.resetBlankNodeCounter();
+    }
+    create(variableKeys, nodeConfig, mode) {
+        const blanks = createBlankManager(this.factoryFunctions);
+        const nodes = createIriManager(nodeConfig, mode ?? Strictness.loose, this.factoryFunctions);
+        const variables = createVariableManager(variableKeys, mode ?? Strictness.loose, this.factoryFunctions);
+        return [variables, nodes, blanks];
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/database/base.js.map

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

package/dist/database/construct.d.ts

@@ -0,0 +1,7 @@
+import { QueryBuilderBase } from './query.js';
+import { Triple, QuadTerm, SparqlClient, ConstructQuery, FactoryFunctions } from '../generic.js';
+export type ConstructTemplates = Triple[];
+export declare class ConstructQueryBuilderBase extends QueryBuilderBase<ConstructQuery, QuadTerm[]> implements PromiseLike<QuadTerm[]> {
+    constructor(variables: ConstructTemplates, prefixes: ConstructQuery['prefixes'], base: string | undefined, factoryFunctions: FactoryFunctions, endpointUrl?: string);
+    protected makeQuery(client: SparqlClient): Promise<QuadTerm[]>;
+}

package/dist/database/construct.js

@@ -0,0 +1,21 @@
+import { QueryBuilderBase } from './query.js';
+export class ConstructQueryBuilderBase extends QueryBuilderBase {
+    constructor(variables, prefixes, base, factoryFunctions, endpointUrl) {
+        super({
+            type: 'query',
+            queryType: 'CONSTRUCT',
+            template: variables.length !== 0 ? variables : undefined,
+            base: base,
+            prefixes: prefixes,
+        }, factoryFunctions, endpointUrl);
+    }
+    async makeQuery(client) {
+        const stream = client.query.construct(this.toSPARQL());
+        const items = [];
+        for await (const binding of stream) {
+            items.push(binding);
+        }
+        return items;
+    }
+}
+//# sourceMappingURL=construct.js.map

package/dist/database/construct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"construct.js","sourceRoot":"","sources":["../../src/database/construct.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAK9C,MAAM,OAAO,yBACX,SAAQ,gBAA4C;IAGpD,YACE,SAA6B,EAC7B,QAAoC,EACpC,IAAwB,EACxB,gBAAkC,EAClC,WAAoB;QAEpB,KAAK,CACH;YACE,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,WAAW;YACtB,QAAQ,EAAE,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YACxD,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,QAAQ;SACnB,EACD,gBAAgB,EAChB,WAAW,CACZ,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,SAAS,CAAC,MAAoB;QAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEvD,MAAM,KAAK,GAAe,EAAE,CAAC;QAC7B,IAAI,KAAK,EAAE,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/database/describe.d.ts

@@ -0,0 +1,7 @@
+import { IriTerm, QuadTerm, VariableTerm, DescribeQuery, SparqlClient, FactoryFunctions } from '../generic.js';
+import { QueryBuilderBase } from './query.js';
+export type DescribeVariables = (VariableTerm | IriTerm)[];
+export declare class DescribeQueryBuilderBase extends QueryBuilderBase<DescribeQuery, QuadTerm[]> implements PromiseLike<QuadTerm[]> {
+    constructor(variables: DescribeVariables, prefixes: DescribeQuery['prefixes'], base: string | undefined, factoryFunctions: FactoryFunctions, endpointUrl?: string);
+    protected makeQuery(client: SparqlClient): Promise<QuadTerm[]>;
+}

package/dist/database/describe.js

@@ -0,0 +1,22 @@
+import * as SparqlJs from 'sparqljs';
+import { QueryBuilderBase } from './query.js';
+export class DescribeQueryBuilderBase extends QueryBuilderBase {
+    constructor(variables, prefixes, base, factoryFunctions, endpointUrl) {
+        super({
+            type: 'query',
+            queryType: 'DESCRIBE',
+            variables: variables.length !== 0 ? variables : [new SparqlJs.Wildcard()],
+            base: base,
+            prefixes: prefixes,
+        }, factoryFunctions, endpointUrl);
+    }
+    async makeQuery(client) {
+        const stream = client.query.construct(this.toSPARQL());
+        const items = [];
+        for await (const binding of stream) {
+            items.push(binding);
+        }
+        return items;
+    }
+}
+//# sourceMappingURL=describe.js.map

package/dist/database/describe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../src/database/describe.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAI9C,MAAM,OAAO,wBACX,SAAQ,gBAA2C;IAGnD,YACE,SAA4B,EAC5B,QAAmC,EACnC,IAAwB,EACxB,gBAAkC,EAClC,WAAoB;QAEpB,KAAK,CACH;YACE,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,UAAU;YACrB,SAAS,EAAE,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACzE,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,QAAQ;SACnB,EACD,gBAAgB,EAChB,WAAW,CACZ,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,SAAS,CAAC,MAAoB;QAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEvD,MAAM,KAAK,GAAe,EAAE,CAAC;QAC7B,IAAI,KAAK,EAAE,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/database/index.d.ts

@@ -0,0 +1 @@
+export * from './base.js';

package/dist/database/index.js

@@ -0,0 +1,2 @@
+export * from './base.js';
+//# sourceMappingURL=index.js.map

package/dist/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/dist/database/query.d.ts

@@ -0,0 +1,8 @@
+import { SparqlQueryBuilderBase } from './sparql-query.js';
+import { Query, Pattern, IriTerm, ValuePatternColumns } from '../generic.js';
+export declare abstract class QueryBuilderBase<TConfig extends Query, KReturn> extends SparqlQueryBuilderBase<TConfig, KReturn> {
+    from(...iris: IriTerm[]): this;
+    fromNamed(...iris: IriTerm[]): this;
+    values(columns: ValuePatternColumns): this;
+    where(...patterns: Pattern[]): this;
+}

package/dist/database/query.js

@@ -0,0 +1,58 @@
+import { SparqlQueryBuilderBase } from './sparql-query.js';
+export class QueryBuilderBase extends SparqlQueryBuilderBase {
+    from(...iris) {
+        if (iris.length === 0) {
+            return this;
+        }
+        if (this.config.from) {
+            this.config.from.default = [...this.config.from.default, ...iris];
+        }
+        else {
+            this.config.from = {
+                default: iris,
+                named: [],
+            };
+        }
+        return this;
+    }
+    fromNamed(...iris) {
+        if (iris.length === 0) {
+            return this;
+        }
+        if (this.config.from) {
+            this.config.from.named = [...this.config.from.named, ...iris];
+        }
+        else {
+            this.config.from = {
+                default: [],
+                named: iris,
+            };
+        }
+        return this;
+    }
+    values(columns) {
+        if (Object.keys(columns).length === 0) {
+            return this;
+        }
+        if (this.config.values) {
+            this.config.values = { ...this.config.values, ...columns };
+        }
+        else {
+            this.config.values = columns;
+        }
+        return this;
+    }
+    where(...patterns) {
+        if (patterns.length === 0) {
+            return this;
+        }
+        if (this.config.where) {
+            this.config.where = [...this.config.where, ...patterns];
+        }
+        else {
+            this.config.where = patterns;
+        }
+        return this;
+    }
+}
+//# sourceMappingURL=query.js.map

package/dist/database/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/database/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,MAAM,OAAgB,gBAGpB,SAAQ,sBAAwC;IAChD,IAAI,CAAC,GAAG,IAAe;QACrB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG;gBACjB,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,EAAE;aACV,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,GAAG,IAAe;QAC1B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG;gBACjB,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,IAAI;aACZ,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,OAA4B;QACjC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACvB,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,EAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,OAAO,EAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,GAAG,QAAmB;QAC1B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,QAAQ,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/database/select.d.ts

@@ -0,0 +1,32 @@
+import { Variable, Grouping, Ordering, Presence, Expression, SelectQuery, SparqlClient, FactoryFunctions } from '../generic.js';
+import { QueryBuilderBase } from './query.js';
+export type SelectedVariables = Record<string, Variable<any, Presence>>;
+type RequiredKeys<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? never : K;
+}[keyof T];
+type OptionalKeys<T> = keyof {
+    [Key in keyof T as Omit<T, Key> extends T ? Key : never]: T[Key];
+};
+export type TypedSelectedVariables<T extends Record<string, any>> = {
+    [K in RequiredKeys<T>]-?: undefined extends T[K] ? Variable<Exclude<T[K], undefined>, Presence.optional> | Variable<T[K], Presence> : Variable<T[K]>;
+} & {
+    [K in OptionalKeys<T>]?: Variable<Exclude<T[K], undefined>, Presence> | Variable<T[K], Presence>;
+};
+export type ExtractDataType<V> = V extends Variable<infer T, any> ? T : never;
+export type ExtractPresenceType<V> = V extends Variable<any, infer P> ? P : never;
+export type InferredSelectResult<T extends SelectedVariables> = {
+    [K in keyof T]: ExtractPresenceType<T[K]> extends Presence.optional ? ExtractDataType<T[K]> | undefined : ExtractDataType<T[K]>;
+};
+export declare class SelectQueryBuilderBase<T extends Record<string, any>> extends QueryBuilderBase<SelectQuery, T[]> implements PromiseLike<T[]> {
+    private lookup;
+    private lookupTransform;
+    constructor(variables: TypedSelectedVariables<T> | undefined, prefixes: SelectQuery['prefixes'], base: string | undefined, factoryFunctions: FactoryFunctions, distict?: SelectQuery['distinct'], reduced?: SelectQuery['reduced'], endpointUrl?: string);
+    having(...expressions: Expression[]): this;
+    groupBy(...groupings: Grouping[]): this;
+    orderBy(...orderings: Ordering[]): this;
+    limit(limit: number): this;
+    offset(offset: number): this;
+    $asSubQuery(): import("../generic.js").GroupPattern;
+    protected makeQuery(client: SparqlClient): Promise<T[]>;
+}
+export {};